odd: P1.3.4 closeout ledger + handoff superseded — encode canon-parity sweep complete

[klappy]

P1.3.4 closeout ledger + handoff superseded

Writes the closeout ledger for P1.3.4 — the encode canon-parity refactor that shipped oddkit 0.23.0 and closes the canon-parity sweep. All three tools (oddkit_challenge, oddkit_gate, oddkit_encode) now use stemmed matching and have their in-process derivation caches removed per klappy://canon/principles/cache-fetches-and-parses.

Files:

• odd/ledger/2026-04-20-p1-3-4-encode-canon-parity-landed.md (new)
• odd/handoffs/2026-04-20-p1-3-4-encode-canon-parity.md (frontmatter only: status: active → status: superseded, superseded_by: pointer added)

Mirrors the P1.3.3 ledger structure: blockquote narrative → Summary → Decisions → Observations → Learnings → Constraints → Handoffs → Encodes → Timeline → References. Writing canon gate satisfied.

Key content captured:

• The second end-to-end application of klappy://canon/constraints/release-validation-gate (P1.3.3 wrote the canon; P1.3.4 inherited it). All three rules binding on every merge decision.
• Two Cursor Bugbot findings dispositioned as autofix fix-forwards: high-severity multi-word vocab flattening on 259170a → autofix 113ba11; low-severity intersectsStems dead code on 113ba11 → autofix e404fe0. Both caught real bugs. Neither shipped past Rule 1.
• Two fresh-context Sonnet 4.6 validators both PASS: feat-validator (session sesn_011CaF5vqjgzN7Mw8s84qvK9) against pre-rebase head eaa1234, promotion-validator (session sesn_011CaF9tx18Af3z1Fy9trwz8) against post-rebase promotion head 7542cbb. Smoke 223/0 × 3 against main preview. Prod baseline cross-check proved assertion (12) is the new-in-0.23.0 behavior.
• Rule 3 resolution of 0.22.0 parallel-release version collision: PRs handoff: P1.3.3 challenge canon-parity refactor (0.21.0) #124/canon: graduate cache-fetches-and-parses to tier-2 principle (P1.3.3 Phase 1) #125/handoff: P1.3.4 encode canon-parity refactor (D5 + D9) — closes the sweep #128/canon: envelope-time-fields principle (tier-2 draft) #129 claimed 0.22.0 on main while this branch was in feat-validator dispatch. Canon-aligned resolution: bump forward to 0.23.0. The handoff's "ship as 0.22.0" was session-scoped; main-reality is canon.
• Orchestrator session egress was structurally limited (sandbox proxy returned "DNS cache overflow" on every *.workers.dev HTTPS request for the entire session). The validators had observation the orchestrator literally could not have — the canonical case Rule 2's fresh-context requirement was designed for.

Carry-forwards:

• P11 (from P1.3.3): oddkit_gate mechanical enforcement of release-validation-gate at execution→completion. Now the obvious next-epoch capability add.
• P13 (new): parseUnstructuredInput fallback-to-types[0] behavior surfaced by both validators — pre-existing, not a bug, but a latent design decision. Options: return [], return null-typed, emit fallback only when single paragraph.
• L-08 candidate: "Prefer autofix design over orchestrator design in Bugbot disposition unless canon names a reason for divergence." Based on D-02 (autofix subset-match accepted over orchestrator's consecutive-subsequence alternative). Graduate on next recurrence.

New learnings encoded:

• L-01 (silent-matcher-semantics bug class): three Bugbot findings across P1.3.3 + P1.3.4 all hit the same shape — incorrect matcher semantics producing silent behavior shifts that tests-without-the-bug-in-mind can't anchor. Regression-anchor pattern (numbered assertion named after the bug) is now standard: (10)/(11) for P1.3.3, (16) for P1.3.4.
• L-02 (version-collision resolution): when a handoff recommends a version and parallel work claims it first, bump — don't renegotiate or waive. Adjacent to contract-governs-handoff-drift; may fold or graduate separately.

Refs:

• Feat PR: feat(encode): D5 stemmed set intersection + D9 cache removal (0.22.0) oddkit#126 (squash-merged 7542cbb)
• Promotion PR: promote 0.23.0 to prod — P1.3.4 encode canon-parity (D5 + D9) oddkit#130 (merged ea185a9)
• Predecessor ledger: klappy://odd/ledger/2026-04-20-p1-3-3-challenge-canon-parity-landed
• Binding canon: klappy://canon/constraints/release-validation-gate, klappy://canon/principles/contract-governs-handoff-drift

---

Note

Low Risk
Low risk: changes are documentation-only (new ledger entry and handoff frontmatter status update) with no runtime code impact.

Overview
Adds a new closeout ledger entry odd/ledger/2026-04-20-p1-3-4-encode-canon-parity-landed.md documenting the P1.3.4 encode canon-parity shipment (stemmed phrase-subset matcher + cachedEncodingTypes cache removal), the release-validation-gate validations, and the 0.22.0→0.23.0 version collision.

Marks the corresponding handoff odd/handoffs/2026-04-20-p1-3-4-encode-canon-parity.md as superseded and links it to the new ledger record.

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