canon: canon-integration-audit — three checks the existing gauntlets don't catch (follow-up to #134)

[klappy]

What and why

Follow-up to #134. Codifies the three integration-layer gaps surfaced during the dream-house essay drafting session (rev 0-23):

Audit	What it checks	Fires at	Closes gap from PR #134
Concept audit	Every named concept intended for reader adoption has a canon home or explicit essay-only decision	on	Dream-house-principle / discernment-layer were essay-only until rev 23
Adjacent-canon audit	Every load-bearing claim cites all matching existing canon via		capability-is-not-permission + mode-discipline-bottleneck-respect weren't cited until rev 23
Validator-completeness audit	Same-session validators implement full schema type-discipline, not just presence		Rev-21 list-vs-string violation false-green caught only by MA re-validation

Why one doc, not three

All three gaps share a root cause: existing gauntlets optimize for is this document well-written? not does this document integrate with the rest of the knowledge base? One tier-2 constraint with three named sub-audits:

• Shared root cause → shared fix
• Lower drift surface (one source of truth)
• Easier extension when a fourth integration check emerges
• One URI citable from preflight/gate/validate

Honest scope note — canon is content, tool-wiring is trigger

This doc defines what the audits check. The proactive-enforcement side depends on oddkit tools exposing the audits at the named transition points. That's in the klappy/oddkit repo, not this one — extends P11 (which currently tracks mechanical enforcement of alone).

Until tool wiring ships, this canon is passively discoverable via and citable from existing workflow, but the audits do not fire without invocation. Both pieces (canon + tool) are required for the proactive property.

Files changed

• — NEW (tier 2, 3,156 words, 10 sections)
• — See Also updated (reciprocal ref)
• — See Also updated (reciprocal ref)

Pre-merge validation

• Local frontmatter type-discipline check passes (tier: int, derives_from: str, all universal 8 present)
• Managed Agent independent validator (dispatching after PR creation)
• Cursor Bugbot

---

Note

Low Risk
Low risk: documentation-only changes that add a new governance constraint and update a few cross-references; no runtime code or schema behavior changes.

Overview
Introduces canon/constraints/canon-integration-audit.md, a new tier-2 constraint that formalizes three pre-merge integration checks: concept canonization, adjacent-canon citation completeness, and frontmatter validator completeness (type-discipline), with intended trigger points at oddkit_preflight, oddkit_gate, and oddkit_validate.

Updates See Also cross-references in frontmatter-validation-before-merge.md and revision-lens-sequence.md, and adds reciprocal links from dream-house-principle.md and discernment-layer.md back to the new audit constraint.

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