canon: Epoch 9 — Substrate Becomes the Wire (E0009) [PR A of trio]

[klappy]

Plants the E0009 flag with all four governance-change-discipline markers; retags the agentic-substrate canon catalog that earned the epoch.

This is PR A of the Epoch 9 trio. Execution spec: klappy://odd/handoffs/2026-05-12-epoch-9-trio. Planning session ledger: klappy://odd/ledger/2026-05-12-epoch-9-planning. PR B (writings/we-were-the-wire.md) opens after this merges.

What this PR does — the four governance markers

Per klappy://canon/constraints/governance-change-discipline, every behavior-affecting governance change ships with four markers. All four are present:

1. Canon version bump — canon/CHANGELOG.md advances from 0.37.0 to 0.38.0.
2. Changelog entry — under ## 0.38.0 — 2026-05-12, summarizing the epoch, the new artifacts, the retag, and the related production work (AMS Add resonance: Agent Skills — recovered and updated #77).
3. Release notes — docs/oddkit/release-notes/2026-05-12-epoch-9-substrate-becomes-the-wire.md. Frames the release by behavior change, not file inventory. Names what changes for operators, what changes for agents, what does not change, how to recognize operator-as-wire (and replace it), and the six-layer receipt table.
4. Epoch appendix — docs/appendices/epoch-9.md. Declares the epoch with frontmatter axes (forcing_fault, new_invariant, core_shift); body sections cover Summary, Forcing Fault, New Invariant, Core Shift, Layered Receipts table, Documents Introduced, What Comes Next, See Also.

Frontmatter retag — per-doc verified

Each candidate doc's governs field was read before mutation; only docs that are substrate / agentic-runtime / persona-shaped work earned a retag.

E0008.5 → E0009 (19 docs):

• Architecture: substrate-stack
• Methods: persona-shaped-agent-runtime, spawned-agent-session-runtime-contract, spawned-agent-session-substrate-options, dispatch-paths, trigger-source-taxonomy
• Principles: agents-need-their-own-wire, symmetric-participation, sessions-mirror-modes, creators-get-paid, magical-first-run, methodology-personification, voice-as-cognitive-load-shedding
• Constraints: mode-transitions-require-encoded-handoff, critic-cannot-be-resolver, audit-gates-are-spawned-agent-sessions
• Observations: clone-klappy-to-oddie-recognition
• Definitions: epistemic-modes
• Appendices: mode-separated-conversations

E0008.3 → E0009 (frontmatter-only; content update deferred):

• canon/bootstrap/model-operating-contract — bumps the epoch tag; the content update for E0009-specific disciplines (dispatch-path discipline, autonomous-trigger error-routing, runtime-contract awareness) is deferred to a follow-up session to keep this PR's review surface mechanical.

Addition beyond the planning session's candidate list:

• canon/constraints/audit-gates-are-spawned-agent-sessions was not on the handoff's candidate list (planning oversight). Per the constraint's own governs field, it directly governs the L4 substrate work that earns the epoch: "Any merge-blocking validator that audits canon, documentation, code-vs-canon sync, cross-reference integrity, or any other governance surface where the check requires LLM-grade judgment." Adding it to the retag list aligns the tag with the work the constraint actually governs.

Verified out of scope (intentionally left at E0008.5):

• canon/voice/oddie-the-river-guide — voice spec; predates substrate push
• canon/methods/borrow-bend-break-beget-build — generic 6B methodology
• canon/constraints/borrow-evaluation-before-implementation — generic governance, not substrate
• writings/reverse-engineer-the-future — bible-translation theme
• Session ledgers (odd/ledger/2026-05-* files) — date-tag only, not subject-matter substrate work

Borrow-evaluation skip — justified

Per klappy://canon/constraints/borrow-evaluation-before-implementation: this trio is not subject to the 6B Evaluation requirement. Reason: there is no upstream substrate to evaluate. Deliverables are (a) a new canon appendix authored from scratch using the established docs/appendices/epoch-N.md shape, (b) a frontmatter retag (mechanical), (c) new release notes from scratch. No implementation task against an SDK, reference implementation, or widely-adopted library exists in this PR. Surfaced for audit traceability per the constraint's own escape clause.

Forward-references

The release notes and the appendix both reference klappy://writings/we-were-the-wire — that essay lands in PR B, which opens immediately after this PR merges. Until then, that one URI is intentionally a forward-reference. All other 16 klappy:// URIs in the new docs resolve against current main.

Reversibility

• New files (docs/appendices/epoch-9.md, docs/oddkit/release-notes/2026-05-12-epoch-9-substrate-becomes-the-wire.md): deletable.
• Frontmatter mutations (20 files): reversible via git revert <merge-sha>.
• CHANGELOG bump: revertible via a follow-up 0.38.1 "revert" entry if needed.
• No code shipped, no tools changed, no production behavior altered.

Validation

• Frontmatter validator green on all 23 modified/new files (python3 scripts/validate-frontmatter.py … → 0 findings).
• 16/17 klappy:// URIs in new docs resolve against current main (the 17th, klappy://writings/we-were-the-wire, is the intentional PR B forward-reference).
• No manual managed-agent validator dispatch — klappy://canon/constraints/release-validation-gate targets klappy/oddkit (production code); for canon-only PRs in klappy.dev, the analog (frontmatter validator green, audit clean, references resolve) is satisfied.

Related

• Planning session ledger: klappy://odd/ledger/2026-05-12-epoch-9-planning
• Execution spec: klappy://odd/handoffs/2026-05-12-epoch-9-trio
• Live work earning the epoch: klappy/agent-messaging-service Add resonance: Agent Skills — recovered and updated #77 (audit-gate runtime migration — plan landed 2026-05-12; multi-PR migration in flight)

---

Note

Low Risk
Low risk: documentation-only changes (new appendix/release notes/changelog) plus frontmatter epoch retags; main impact is on navigation/metadata consumers rather than runtime behavior.

Overview
Declares Canon 0.38.0 / Epoch 9 (E0009) — “Substrate Becomes the Wire” by adding a new epoch appendix (docs/appendices/epoch-9.md), new release notes (docs/oddkit/release-notes/2026-05-12-epoch-9-substrate-becomes-the-wire.md), and a changelog entry framing the behavior shift away from operator-as-wire toward spawned-agent-session audits/validation and autonomous-trigger pipelines.

Retags the substrate/agent-runtime canon catalog by bumping the frontmatter epoch: on ~20 existing canon/docs files from E0008.x to E0009 (including canon/bootstrap/model-operating-contract.md as a frontmatter-only bump), without substantive content edits beyond metadata.

^{Reviewed by Cursor Bugbot for commit 71f6fab. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

Canon Quality — Frontmatter Schema ✅

All 40 file(s) in writings/ conform to klappy://canon/meta/frontmatter-schema.

_{Validator: scripts/validate-frontmatter.py · Canon: klappy://canon/constraints/frontmatter-validation-before-merge · Run: #137}

[github-actions]

Canon Quality — oddkit_audit ✅

No dead klappy:// references or legacy link patterns found in writings/. 41 files scanned.

_{Spec: klappy://docs/oddkit/specs/oddkit-audit · Workflow: .github/workflows/canon-quality.yml · Run: #137}