Skip to content

gate canon points up, not down: remove adopter references from odd/gate/* - #325

Merged
git-repo-auth[bot] merged 1 commit into
mainfrom
dish/2026-09-21-gate-canon-points-up
Sep 21, 2026
Merged

git-repo-auth[bot] merged 1 commit into
mainfrom
dish/2026-09-21-gate-canon-points-up

Conversation

@git-repo-auth

@git-repo-auth git-repo-auth Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Draft. Canon text: the captain reads the exact words before this merges. This seat does not merge it.

Captain, 2026-09-21: "How did kitchen language get into canon?! Point up not down."

klappy.dev #323 (merged cb37f62) put an adopter's vocabulary and pointers to an adopter's private files into the public default gate. This removes them. Check words, ids and nulls are untouched; the gate behaves the same.

Was Now
"independent presence-proofs — kitchen CHECKLIST 10 (observed world reference), CHECKLIST 11 (installation inspected), and a house-canon cite —" "independent presence-proofs — an observed world reference, an inspected installation, and a canon cite —"
"a Worker AND would be Flavored Vodka." "an AND inside the server would flavor it (klappy://canon/principles/vodka-architecture)."
gap message: "…repo/path inspected (CHECKLIST 11), or…" "…repo/path inspected, or…"
"(2026-09-21, kitchen ticket 2026-09-20-gate-explore-plan-prior-art)" ×2 (both files) "(2026-09-21)"
"a dummy klappy:// paste is the new cowboy — spawned audit, not this matcher." "a made-up klappy:// link still passes — that is work for a spawned audit (klappy://canon/constraints/audit-gates-are-spawned-agent-sessions), not this matcher."

Left alone, for the captain to rule: the word "house" in the two ids (house_install_cited, house_canon_cited), their messages and the nulls ("no house install", "no house canon"). Renaming ids changes what every caller sees and types; that is more than a wording fix.


Note

Low Risk
Canon text edits only; no server code or check-term changes, so gate runtime behavior should be unchanged.

Overview
Documentation-only cleanup in odd/gate/prerequisites.md and odd/gate/transitions.md so gate canon points up (house principles and constraints) instead of down into an adopter’s private checklists and ticket ids. Prerequisite ids, check vocabularies, official nulls, and matcher behavior are unchanged.

Wording updates: exploration-to-planning presence proofs are described generically (observed world reference, inspected installation, canon cite) instead of kitchen CHECKLIST 10/11; the vodka note now cites klappy://canon/principles/vodka-architecture rather than “Worker AND / Flavored Vodka”; the house_install_cited gap message drops (CHECKLIST 11); notes dated 2026-09-21 no longer reference the kitchen ticket 2026-09-20-gate-explore-plan-prior-art; fake klappy:// cites are framed as work for a spawned audit with klappy://canon/constraints/audit-gates-are-spawned-agent-sessions instead of informal “cowboy” language.

Explicitly not changed: house_* id names and “no house install/canon” nulls remain for a separate captain ruling.

Reviewed by Cursor Bugbot for commit b5f2818. Bugbot is set up for automated code reviews on this repo. Configure here.

…te/*

Removes 'kitchen CHECKLIST 10/11', 'kitchen ticket ...', '(CHECKLIST 11)' in a
public gap message, 'cowboy', 'Flavored Vodka'. Check words and ids unchanged.
One gap message changes wording (drops a pointer to a private file).
DRAFT: captain reads the exact words before merge.
@github-actions

Copy link
Copy Markdown

Canon Quality — P0010 Retrieval-Readiness ⚠️

Soft report for klappy://canon/constraints/retrieval-disclosure-contract. 716 files scanned. Never blocks — informational until the corpus is ready to enforce.

  • Blocking-class findings: 19 (structural fields the contract would filter on)
  • Warnings: 0 (kind resolves to unknown)
  • Informational: 13 (exempt templates/archive/drafts)

Kind distribution: {'essays': 53, 'canon': 252, 'apocrypha': 38, 'docs': 307, 'journals': 60, 'unknown': 6}
Kind source: {'path': 578, 'frontmatter': 132, 'none': 6} (frontmatter-primary, path-secondary)
Default-include visibility: 612 visible, 104 hidden (journals/apocrypha/unknown)

By rule: {'audience-invalid': 4, 'exposure-missing': 7, 'tier-missing': 5, 'tier-invalid': 7, 'fm-missing': 3, 'kind-unresolvable': 6}

These are not schema violations (see the Frontmatter Schema job for those on writings/). They are corpus-readiness signals for the retrieval contract: invalid/missing audience, exposure, tier, and docs whose kind cannot be resolved. Fix in a corpus-cleanup PR before the contract flips to enforcing. See the retrieval-readiness-findings artifact for the full list.

Validator: scripts/audit-retrieval-readiness.py · Constraint: klappy://canon/constraints/retrieval-disclosure-contract · Run: #463

@github-actions

Copy link
Copy Markdown

Canon Quality — Homepage Surfacing ✅

51 essay(s) scanned. Soft report — never blocks; the hard field gate is the Frontmatter Schema job.

All published essays resolve to the homepage feed.

Report: scripts/surfacing-report.py · Canon: klappy://canon/constraints/frontmatter-validation-before-merge

@github-actions

Copy link
Copy Markdown

Canon Quality — oddkit_audit

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

Spec: klappy://docs/oddkit/specs/oddkit-audit · Workflow: .github/workflows/canon-quality.yml · Run: #463

@github-actions

Copy link
Copy Markdown

Canon Quality — Frontmatter Schema ✅

All 51 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: #463

@git-repo-auth
git-repo-auth Bot marked this pull request as ready for review September 21, 2026 15:42
@git-repo-auth
git-repo-auth Bot merged commit baffbab into main Sep 21, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant