Architecture compliance (generated)

Generated by scripts/arch-report.mjs. The constitution promises every principle names the practice it comes from and the gate that enforces it (Architecture §2/§4, P9: an ungated rule is aspirational). This is that map, live — each modularity principle → its CI gate(s) → the current evidence. P9 itself is the table: every row is a green gate, not a README rule, so “fully modular” is a claim backed by mechanical evidence. Regenerate with node scripts/arch-report.mjs; gate:arch-report keeps it honest in CI.

Principle	Rule	Gate(s)	Evidence	Status
P2	Couple only through contracts — no import reaches around a contract into a sibling module’s internals (prod AND tests).	`gate:isolation` · `gate:isolation-py` · `gate:test-isolation`	17 brick(s) checked; every Python sibling import is own-module, declared, or an allowed edge; no Python test imports a sibling module’s internals (test lane gated, P2)	✅
P3	Dependencies point inward to the kernel; the graph is acyclic (runtime depends on nothing above).	`gate:graph` · `gate:graph-py`	acyclic + allowed-edges; Python cross-package edges acyclic + allow-listed	✅
P4	Cross a process/network boundary → a sealed, versioned, golden-pinned schema.	`gate:schema` · `gate:contract-version`	24 contract(s) conform (goldens ≡ schema); 24 sealed contract(s) frozen	✅
P6	One public front door per module; internals are private.	`gate:exports`	13 library package(s) lock their front door	✅
P12	Every folder self-documents (README: concern · surface · deps).	`gate:readme`	299 dirs each carry a README	✅
P23	One writer per data carrier; a reader never re-derives a producer’s data (data-flow ownership, architecture.calm.json).	`gate:dataflow`	81 nodes · 52 edges · 11 carriers · complete + sealed (P23)	✅

Modularity verdict: all gates green — the v0.12 backend is fully modular by the constitution’s own definition. Per-service module structure (each a front-doored brick, independently testable): meeting-api = {lifecycle · bot_spawn · collector · recordings · webhooks · scheduling · sessions · obs}; runtime = the kernel (imports nothing above); gateway/identity/agent-api per their domains. The test lane is gated too (gate:test-isolation) — a test cannot reach across a module boundary where prod imports can’t.

Start here

How-to: Meetings

How-to: Agents

How-to: Meetings + agents

Core

Concepts

Architecture

API reference

Deployment & operations

Roadmap

Governance

Architecture compliance (generated)