05 Building Block View | CX Documentation

Table of Contents

Rule
Dependency Direction

Key building blocks in the shipped architecture:

Block Responsibility Primary callers Must not own

Block	Responsibility	Primary callers	Must not own
`src/planning/`	Select tracked files, assign section ownership, detect overlaps, and build the deterministic bundle plan.	`inspect`, `bundle`, MCP bundle preview	Rendering, artifact verification, or note governance.
`src/render/`	Render section outputs, spans, structured plans, hashes, and token counts through the kernel-owned proof path.	`bundle`, `verify`, render parity checks	File selection policy or adapter-specific output shapes.
`src/manifest/`	Write and read canonical manifest truth, including artifact metadata, trust metadata, and derived review exports.	`bundle`, `validate`, `verify`, `extract`, list/report commands	Live workspace inspection or note mutation.
`src/bundle/`	Validate, verify, and extract bundles against manifest truth and checksum evidence.	`validate`, `verify`, `extract`	MCP policy decisions or oracle diagnostics.
`src/notes/`	Parse, validate, score, and maintain the durable cognition graph.	`notes`, governance checks, optional bundle gates	Proof-path rendering or artifact truth.
`src/mcp/` and `src/doctor/`	Expose scoped live workspace inspection, diagnostics, and policy-backed operator guidance.	`mcp`, `doctor`, agent integrations	Promotable proof claims.
`src/adapter/`	Expose oracle/reference diagnostics and parity comparison.	Expert diagnostics, parity tests	Ordinary `bundle`, `validate`, `verify`, or `extract` runtime behavior.

src/planning/

Select tracked files, assign section ownership, detect overlaps, and build the deterministic bundle plan.

inspect, bundle, MCP bundle preview

Rendering, artifact verification, or note governance.

src/render/

Render section outputs, spans, structured plans, hashes, and token counts through the kernel-owned proof path.

bundle, verify, render parity checks

File selection policy or adapter-specific output shapes.

src/manifest/

Write and read canonical manifest truth, including artifact metadata, trust metadata, and derived review exports.

bundle, validate, verify, extract, list/report commands

Live workspace inspection or note mutation.

src/bundle/

Validate, verify, and extract bundles against manifest truth and checksum evidence.

validate, verify, extract

MCP policy decisions or oracle diagnostics.

src/notes/

Parse, validate, score, and maintain the durable cognition graph.

notes, governance checks, optional bundle gates

Proof-path rendering or artifact truth.

src/mcp/ and src/doctor/

Expose scoped live workspace inspection, diagnostics, and policy-backed operator guidance.

mcp, doctor, agent integrations

Promotable proof claims.

src/adapter/

Expose oracle/reference diagnostics and parity comparison.

Expert diagnostics, parity tests

Ordinary bundle, validate, verify, or extract runtime behavior.

See Implementation Reference for the deeper contributor map and Internal API Contract for stable seams such as RenderEngine, StructuredRenderPlan, TokenizerProvider, and ScannerPipeline.

Rule

Ordinary bundle, validate, verify, and extract flows do not rely on the oracle seam. That separation is a runtime rule, not just a documentation preference.

Dependency Direction

The ordinary proof path flows from planning to rendering to manifest materialization to validation, verification, and extraction. Live workspace tooling may inspect or preview that path, but it does not become artifact truth. Notes may inform a bundle through configured inputs and gates, but note quality is still conditional knowledge rather than proof.