Runtime Subsystem Manuals Overview
M31A contains 20 dedicated architectural subsystems. These manuals provide deep architectural explanations of their internal mechanics, authority ownership, data flows, and tested invariants.
Subsystem Catalog
| Subsystem | Primary Module | Core Functionality |
|---|---|---|
| Application Startup | src/main.rs, src/init/ | Panic hooks, storage migration, configuration bootstrapping |
| Configuration Engine | src/config/ | 8-tier precedence engine, canonical defaults, schema validation |
| CLI & Dispatch | src/cli/ | Clap hierarchy, exit code taxonomy, runtime command routing |
| Sessions & Runtime | src/runtime.rs, src/interaction/ | AppRuntime composition root, interactive session persistence |
| Agent Pool & Registry | src/agent/ | 18 built-in agent roles, supervisor, adaptive replanning |
| Model & Providers | src/model/ | NVIDIA NIM provider, SSE stream accumulator, token metrics |
| Context & Prompts | src/context/, src/prompt/ | Context compaction, prompt reference catalog, token budgeting |
| Planning & Scheduling | src/planning/, src/dag/ | Task decomposition, CPM critical path, cycle validation |
| Capabilities & Tools | src/capability/, src/tools/ | 28 core tools, extended tools, provider abstraction |
| Policy & Approvals | src/policy/ | 4 policy decisions, multi-layer rules, interactive approvals |
| Filesystem & Repo | src/repo/, src/change/ | AST symbol extraction, repo search, workspace mutation |
| Process Supervision | src/process/, src/sandbox/ | PID recycling protection, spool capture, signal escalation |
| Git & Attribution | src/git/ | Worktree isolation, commit trailers, attribution ledger |
| Verification & Nyquist | src/verification/ | 7-tier verification hierarchy, evidence snapshot matching |
| Events & Telemetry | src/events/, src/telemetry/ | Broadcast event bus, distributed tracing spans |
| Persistence & Migrations | src/persistence/ | SQLite WAL connection pool, migrations 001-032 |
| Checkpoints & Recovery | src/checkpoint/ | Two-phase commit protocol, crash recovery scanner |
| Ratatui TUI Cockpit | src/tui/ | 62-file terminal cockpit, read-only projection, streaming |
| Deployment Channels | src/deployment/ | Compile-time channel isolation (production vs development) |