How mrxsin/xax works
XAX is a research-prototype compiler for programs represented as verified semantic graphs rather than text. Its principal workflow is an AI-authored semantic edit, verification and compilation, then generation of a target artifact. The repository also supports carrier decoding, workspace transactions, graph rendering and numerous platform backends. The map follows the README and the supplied source index; connections to unsampled backends are omitted unless documented, so it does not claim to trace every build path.
Main entry points: xax_compiler.py Compiler and store · xax_build.py Build service · xax_workspace.py Workspace queries · xax_selfhost_verify.py Store verifier
Components 22
Authoring and transactions
- Carrier reader
compiler/integration/construct/reader.py - Carrier resolver
compiler/integration/construct/resolve.py - Workspace queries
compiler/reference/xax_workspace.py - Semantic edits
compiler/src/xax_selfhost_edit.py
Semantic compiler
- Graph construction
compiler/reference/xax_structured.py - Compiler and store
compiler/reference/xax_compiler.py - Operation typing
compiler/src/xax_selfhost_typing.py - Memory facts
compiler/src/xax_selfhost_facts.py - Control flow
compiler/src/xax_selfhost_cfg.py - Store verifier
compiler/src/xax_selfhost_verify.py - Diagnostics
compiler/src/xax_selfhost_diagnostics.py - Graph rendering
compiler/src/xax_selfhost_render.py
Native execution
- Native image runner
compiler/src/xax_native.py
Build and artifacts
- Build service
compiler/reference/xax_build.py - Artifact provenance
compiler/reference/xax_artifact.py
Target backends
- Linux backend
compiler/reference/xax_linux.py - x86-64 backend
compiler/reference/xax_x86_64.py - AArch64 backend
compiler/reference/xax_aarch64.py - RISC-V backend
compiler/reference/xax_riscv64.py - JVM backend
compiler/reference/xax_jvm.py - DEX backend
compiler/reference/xax_dex.py
Other components
- AI agent
Connections 24
- AI agent → Semantic edits: submits edit
README.md - Semantic edits → Compiler and store: verifies store
compiler/src/xax_selfhost_edit.py - AI agent → Workspace queries: queries graph
README.md - Carrier reader → Carrier resolver: decodes carriers
compiler/integration/construct/resolve.py - Carrier resolver → Compiler and store: builds objects
compiler/integration/construct/resolve.py - Graph construction → Compiler and store: uses compiler
compiler/reference/xax_structured.py - Compiler and store → Operation typing: invokes typing
compiler/reference/xax_compiler.py - Compiler and store → Memory facts: uses facts
compiler/reference/xax_compiler.py - Compiler and store → Control flow: uses control flow
compiler/reference/xax_compiler.py - Compiler and store → Store verifier: verifies store
compiler/reference/xax_compiler.py - Compiler and store → Diagnostics: reports errors
compiler/src/xax_selfhost_diagnostics.py - Graph rendering → Memory facts: uses facts
compiler/src/xax_selfhost_render.py - Graph rendering → Store verifier: verifies input
compiler/src/xax_selfhost_render.py - Native image runner → Store verifier: runs image
compiler/src/xax_native.py - Build service → Compiler and store: compiles graph
compiler/reference/xax_build.py - Build service → Artifact provenance: records provenance
compiler/reference/xax_artifact.py - Workspace queries → Compiler and store: uses compiler
compiler/reference/xax_workspace.py - Workspace queries → Artifact provenance: uses provenance
compiler/reference/xax_workspace.py - Build service → Linux backend: builds target
compiler/reference/xax_build.py - Build service → x86-64 backend: builds target
compiler/reference/xax_build.py - Build service → AArch64 backend: builds target
compiler/reference/xax_build.py - Build service → RISC-V backend: builds target
compiler/reference/xax_build.py - Build service → JVM backend: builds target
- Build service → DEX backend: builds target
compiler/reference/xax_build.py