Skip to content

canon/meta: add status / superseded_by / governs / session_span fields to frontmatter schema#116

Merged
klappy merged 1 commit into
mainfrom
canon/frontmatter-schema-additive-fields-2026-04-19
Apr 19, 2026
Merged

canon/meta: add status / superseded_by / governs / session_span fields to frontmatter schema#116
klappy merged 1 commit into
mainfrom
canon/frontmatter-schema-additive-fields-2026-04-19

Conversation

@klappy
Copy link
Copy Markdown
Owner

@klappy klappy commented Apr 19, 2026

What

Adds missing optional fields to the frontmatter schema that recent PRs already use:

  • canon audience: status values now include "superseded"; new superseded_by row (paired with existing supersedes)
  • docs audience: new status row, new superseded_by row
  • odd audience: new complements, governs, status, session_span rows

Why

Closes the single open item from the validator report on PRs #113/#114/#115 (Sonnet 4.6 validation, VERIFIED verdict, advisory findings FM-1 and FM-2). PR #113 used status: superseded + superseded_by on a docs doc, PR #114 used status, governs, session_span on an odd handoff. Both were semantically correct, but the schema's own rule says update-first-use-second. That sequencing was inverted. This closes the gap.

Tracked in odd/handoffs/2026-04-20-p1-2-encode-canary.md as O-open P1.

Diff scope

Additive only. No existing row was removed, renamed, or restricted. One row extended: canon.status now lists "superseded" alongside "active" / "proposed" / "final". Bumped epoch to E0008.3 and date to 2026-04-19 to mark this as the E0008.3-era revision.

Verification

  • Diff is 10+/3-, single file (canon/meta/frontmatter-schema.md)
  • Frontmatter types remain native (integers unquoted, dates unquoted, simple identifiers unquoted)
  • Pattern matches existing rows in style and Notes voice

Merge when green.


Note

Low Risk
Low risk: documentation-only changes that expand the allowed frontmatter fields/values; no runtime code paths are modified.

Overview
Updates the authoritative frontmatter schema to cover recently-used metadata: expands canon.status to include superseded and adds superseded_by, adds lifecycle (status, superseded_by) rows for docs, and adds complements, governs, status, and session_span for odd documents.

Bumps the schema document’s own epoch/date to reflect the new revision.

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

…rontmatter schema

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.
@klappy klappy merged commit c855ddf into main Apr 19, 2026
1 check passed
@klappy klappy deleted the canon/frontmatter-schema-additive-fields-2026-04-19 branch April 19, 2026 17:24
klappy added a commit that referenced this pull request Apr 19, 2026
…lease

Three files:
- odd/ledger/2026-04-19-validator-closeout-and-0.17.0.md — retrospective
  session record with full DOLCHEO, timeline, and per-check dispositions
- odd/handoffs/2026-04-20-post-closeout.md — thin forward-pointing handoff
  for the next session; includes the ready-to-paste thin prompt
- odd/handoffs/2026-04-20-fresh-session-continuation.md — marked superseded
  (status: superseded, superseded_by: post-closeout) using the fields just
  added to the schema in PR #116

Ships 0.17.0 provenance into the codebase. Next session can boot on
P1.2 with the thin prompt in the post-closeout handoff.
klappy added a commit that referenced this pull request Apr 19, 2026
…lease (#117)

Three files:
- odd/ledger/2026-04-19-validator-closeout-and-0.17.0.md — retrospective
  session record with full DOLCHEO, timeline, and per-check dispositions
- odd/handoffs/2026-04-20-post-closeout.md — thin forward-pointing handoff
  for the next session; includes the ready-to-paste thin prompt
- odd/handoffs/2026-04-20-fresh-session-continuation.md — marked superseded
  (status: superseded, superseded_by: post-closeout) using the fields just
  added to the schema in PR #116

Ships 0.17.0 provenance into the codebase. Next session can boot on
P1.2 with the thin prompt in the post-closeout handoff.
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