Subsystem Architecture Atlas (L0–L5)

Machine-generated overview of the 6 architectural layers (L0–L5) and domain subsystem SSoTs in the Vox workspace.

Layer Dependency Hierarchy

Diagram source

graph {
    direction: down
    node L5: "L5 — Product Surfaces (CLI, Axis GUI, Daemon)"
    node L4: "L4 — Native Plugins & Terminal TUI"
    node L3: "L3 — Compiler, VoxDb, Orchestrator, Search & Runtimes"
    node L2: "L2 — Domain Libraries & Graph Reader"
    node L1: "L1 — Primitives, Crypto, Secrets & Transport"
    node L0: "L0 — Pure Types & Contracts"
    L5 -> L4
    L4 -> L3
    L3 -> L2
    L2 -> L1
    L1 -> L0
}

Architectural Layers (`L0`–`L5`)

Layer	Subsystem Hub	Crate Count	Summary
`L0`	Layer 0 — Pure Types & Contracts	13	Zero-I/O pure data structures, AST nodes, database row types, and KB facet schemas.
`L1`	Layer 1 — Primitives, Crypto, Secrets & Transport	23	Foundational primitives including vox-crypto, Clavis secrets, iroh QUIC mesh transport, and bounded FS.
`L2`	Layer 2 — Domain Libraries & Graph Reader	19	Pure domain engines: configuration, capability/MCP registries, code graph reader, evaluation, and journal.
`L3`	Layer 3 — Compiler, VoxDb, Orchestrator, Search & Runtimes	53	Core execution engines: unified Vox compiler/codegen, VoxDb/Turso, multi-agent orchestrator, hybrid search, and Populi/Mens.
`L4`	Layer 4 — Native Plugins & Terminal TUI	12	Dynamically loaded skill/inference plugins and the ratatui-based vox-term TUI.
`L5`	Layer 5 — Product Surfaces (CLI, Axis GUI, Daemon)	13	User-facing product binaries: vox CLI, Vox Axis desktop workbench (vox-gui), and orchestrator daemon.

Domain Subsystem Authority Map

Domain Subsystem	Primary Layer	Canonical SSoT
Compiler & Web IR	`L3`	`vox-compiler`
VoxDb / Arca / Codex	`L3`	`vox-db`
Multi-Agent Orchestrator & DEI	`L3`	`vox-orchestrator`
Hybrid Search & Tantivy	`L3`	`vox-search`
Populi / Mens / Speech (Oratio)	`L3` / `L4`	`vox-populi`
Axis Desktop Workbench & TUI	`L5` / `L4`	`vox-gui`
Cryptography & Clavis Secrets	`L1`	`cryptography-ssot-2026`