canon: DOLCHEO cleanup — supersede DOLCHE doc, note O/O-open intentional collision#113
Merged
Merged
Conversation
…l O/O-open collision Two follow-ups after PR #112 landed the DOLCHEO umbrella: 1. docs/oddkit/proactive/dolche-vocabulary.md: - status: active -> superseded - superseded_by: canon/definitions/dolcheo-vocabulary.md - Adds a banner blockquote pointing readers at the DOLCHEO umbrella while preserving the doc for historical reference. 2. odd/encoding-types/how-to-write-encoding-types.md: - Custom-type conventions now acknowledge the one intentional exception to letter-collision: Observation and Open both register letter O and disambiguate by facet plus section placement, per the DOLCHEO contract. Future custom types should not introduce collisions unless they follow the same facet pattern.
klappy
added a commit
that referenced
this pull request
Apr 19, 2026
Handoff for the fresh session that picks up P1.2. Covers scope (feature half: batch-mode prefixes + per-artifact array; refactor half: read DOLCHEO vocab from canon at runtime via KnowledgeBaseFetcher with three-tier fallback, governance_source in envelope, Zod knowledge_base_url override), the path-3 orchestrator-applies workflow (Sonnet 4.6 validates; do not dispatch Opus 4.7 exec agents to klappy/oddkit per the prior session's safety-layer finding), smoke test extensions for canon-tool-envelope.smoke.mjs, and the priority-ordered reading list. Carries forward the standing rules from the 2026-04-20 fresh-session handoff unchanged. Adds the Bugbot-is-informational-on-klappy.dev note confirmed by #109/#110/#111/#113 merges.
klappy
added a commit
that referenced
this pull request
Apr 19, 2026
…r fresh session) (#114) Handoff for the fresh session that picks up P1.2. Covers scope (feature half: batch-mode prefixes + per-artifact array; refactor half: read DOLCHEO vocab from canon at runtime via KnowledgeBaseFetcher with three-tier fallback, governance_source in envelope, Zod knowledge_base_url override), the path-3 orchestrator-applies workflow (Sonnet 4.6 validates; do not dispatch Opus 4.7 exec agents to klappy/oddkit per the prior session's safety-layer finding), smoke test extensions for canon-tool-envelope.smoke.mjs, and the priority-ordered reading list. Carries forward the standing rules from the 2026-04-20 fresh-session handoff unchanged. Adds the Bugbot-is-informational-on-klappy.dev note confirmed by #109/#110/#111/#113 merges.
klappy
added a commit
that referenced
this pull request
Apr 19, 2026
…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.
This was referenced Apr 19, 2026
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two small follow-ups after PR #112 landed the DOLCHEO umbrella. Both items were captured as open threads (
[O-open P3]and[O-open P4]) in the PR #112 validation ledger.1. Supersede the DOLCHE doc
docs/oddkit/proactive/dolche-vocabulary.mdwas showingstatus: activedespite being explicitly superseded bycanon/definitions/dolcheo-vocabulary.md. The umbrella'ssupersedes:field established the relationship from the authoritative side but the older doc had no matching signal.Changes:
status: active→status: supersededsuperseded_by: canon/definitions/dolcheo-vocabulary.md(inverse pointer to the umbrella'ssupersedes:)Note:
status: supersededand thesuperseded_byfield are newly exercised in this repo. The current frontmatter schema (canon/meta/frontmatter-schema) listsstatus: active | proposed | finaland documentssupersedesbut notsuperseded_by. If this becomes the standard pattern, a follow-up should update the schema. For now, these are the logical inverse of existing fields and self-describing.2. Acknowledge the intentional O/O-open collision
odd/encoding-types/how-to-write-encoding-types.mdtells custom-type authors: "Letter should not collide with existing types (D, O, L, C, H, E)." That's been correct for the default set until DOLCHEO introduced the intentional collision between Observation (closed) and Open (forward-pointing), both registered under letterOwith facet-based disambiguation.Changes:
Verification
git diff --stat: 2 files, +7/-2 linesReady to merge once CI is green.
Note
Low Risk
Low risk: documentation-only updates that don’t affect runtime behavior; the only potential issue is tooling that assumes a limited
status/frontmatter schema.Overview
Marks
docs/oddkit/proactive/dolche-vocabulary.mdas superseded (addssuperseded_byand a top-of-doc banner) to direct readers to thecanon/definitions/dolcheo-vocabulary.mdumbrella.Updates
odd/encoding-types/how-to-write-encoding-types.mdto explicitly document the intentionalOletter collision between Observation and Open and how it is disambiguated (viafacet: openand ledger section conventions).Reviewed by Cursor Bugbot for commit f6c1e4f. Bugbot is set up for automated code reviews on this repo. Configure here.