From 5222d400f27711cce4eaf149836b33d7ba44adde Mon Sep 17 00:00:00 2001 From: Klappy Date: Sun, 19 Apr 2026 17:19:10 +0000 Subject: [PATCH] canon/meta: add status/superseded_by/governs/session_span fields to frontmatter schema MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes the O-open P1 item from the validator report on PRs #113/#114/#115. The validator flagged that PR #113 and PR #114 used fields the schema did not yet declare (status, superseded_by, governs, session_span on docs/odd audiences). Per the schema's own rule — update-first-use-second — the correct sequencing was inverted. This PR closes the gap. Additive only. No existing row changed except canon.status (now includes "superseded" as a valid value). - canon: status gains 'superseded', new superseded_by row - docs: new status row, new superseded_by row - odd: new complements/governs/status/session_span rows epoch/date bumped to E0008.3 / 2026-04-19 to mark this revision. --- canon/meta/frontmatter-schema.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/canon/meta/frontmatter-schema.md b/canon/meta/frontmatter-schema.md index 797dd0c8..dda38405 100644 --- a/canon/meta/frontmatter-schema.md +++ b/canon/meta/frontmatter-schema.md @@ -7,8 +7,8 @@ tier: 1 voice: neutral stability: semi_stable tags: ["canon", "meta", "frontmatter", "schema", "YAML", "metadata", "governance", "template", "validation"] -epoch: E0007.1 -date: 2026-04-04 +epoch: E0008.3 +date: 2026-04-19 derives_from: "canon/meta/writing-canon.md, canon/values/axioms.md" complements: "canon/meta/TEMPLATE.md, docs/TEMPLATE.md, canon/constraints/definition-of-done.md" governs: "All YAML frontmatter in all documents across all directories" @@ -106,8 +106,9 @@ Canon documents define program-level constraints. | `derives_from` | recommended | `"path/to/source.md, path/to/other.md"` | What this document is grounded in. Full file paths, not floating names. | | `complements` | optional | `"path/to/sibling.md"` | Related documents that work alongside this one | | `governs` | optional | `"description of what this constrains"` | What behavior or documents this constrains | -| `status` | optional | `"active"` `"proposed"` `"final"` | Lifecycle status | +| `status` | optional | `"active"` `"proposed"` `"final"` `"superseded"` | Lifecycle status | | `supersedes` | optional | `"path/to/old.md"` | What this replaces | +| `superseded_by` | optional | `"path/to/replacement.md"` | The replacement document (back-pointer; pair with `status: superseded`) | ### audience: "docs" @@ -120,7 +121,9 @@ Docs documents define implementation details, planning, and operational guides. | `derives_from` | optional | `"path/to/source.md"` | What this is grounded in | | `complements` | optional | `"path/to/sibling.md"` | Related documents | | `governs` | optional | `"description"` | What this constrains | +| `status` | optional | `"active"` `"proposed"` `"superseded"` `"archived"` | Lifecycle status | | `supersedes` | optional | `"path or description"` | What this replaces | +| `superseded_by` | optional | `"path/to/replacement.md"` | The replacement document (back-pointer; pair with `status: superseded`) | | `forcing_fault` | epoch docs only | `"description"` | What friction triggered this epoch | | `new_invariant` | epoch docs only | `"statement"` | What's now true that wasn't before | | `core_shift` | epoch docs only | `"old → new"` | What changed | @@ -200,6 +203,10 @@ ODD documents define universal philosophy and methodology. | `epoch` | optional | `"E0005"` | Which epoch | | `date` | optional | `"2026-04-04"` | Date | | `derives_from` | optional | `"path/to/source.md"` | Grounding | +| `complements` | optional | `"path/to/sibling.md"` | Related documents | +| `governs` | optional | `"description of what this handoff/ledger covers"` | What scope this document governs. Common on handoffs and ledgers. | +| `status` | optional | `"active"` `"draft"` `"superseded"` `"archived"` | Lifecycle status | +| `session_span` | optional | `"2026-04-19 closed"` or `"2026-04-19 to 2026-04-20"` | For session ledgers and handoffs: which session(s) the document records | | `version` | optional | `"1.0"` (quoted) | Document version | | `slug` | if site-rendered | `"kebab-case"` | URL slug for public-facing ODD docs |