Skip to main content

M31A System Architecture (L0-L9)

M31A is organized into 10 strict downward-dependent architectural layers.

Layer Summary​

LayerPrimary SubsystemsCore Responsibilities
L0 Kernel & Storagekernel, persistence, storage, events, idsStrongly typed UUID v7 domain IDs, SQLite database pool, storage layout, cancellation tokens
L1 Security & Policypolicy, sandbox, platform, configNon-bypassable policy evaluation, 8-tier configuration engine, Landlock/seccomp confinement
L2 Capabilities & Toolscapability, tools, process, git, repo28 core model tools, process tree supervision, Git worktrees, LSP code intelligence
L3 Intelligence & Contextmodel, prompt, context, memoryNVIDIA NIM provider, SSE streaming accumulator, context token compaction, prompt templates
L4 Agents & Rolesagent, skill18 built-in agent roles, supervisor, adaptive replanning, multi-agent task delegation
L5 Planning & Schedulingplanning, dag, schedulerTask graph decomposition, Critical Path Method (CPM), topological sorting, job worker pool
L6 Execution & Checkpointschange, checkpoint, pipelineTwo-phase checkpoint manager, artifact ledger, workspace change application
L7 Verification & Recoveryverification, eval, recovery7-tier verification hierarchy, Nyquist gate, crash recovery scanner, acceptance eval
L8 Autonomy & Workflowscontroller, state, workflow, telemetryAutonomy controller, stage progression, Genesis multi-stage workflows, metrics collection
L9 CLI, TUI & Deploymentcli, tui, init, interaction, deploymentClap 4 CLI, Ratatui cockpit, setup wizard, compile-time deployment channel isolation