odd/handoffs: 2026-04-20 P1.2 encode batch-mode + canary refactor (for fresh session)

[klappy]

Handoff doc for the fresh session that picks up P1.2 after this one closes out.

What this captures

• P1.1 status: shipped. DOLCHEO umbrella + per-type governance live via PR canon/definitions: DOLCHEO vocabulary (tier 2) — adds Open as the seventh letter #112. Three-PR stack (odd/ledger: 2026-04-19 agent-team pilot session ledger #109 ledger, canon/principles: agent-self-report-under-stress (tier 2) #110 self-report principle, odd/handoffs: 2026-04-20 fresh-session continuation (post agent-team pilot) #111 prior handoff) merged. PR canon: DOLCHEO cleanup — supersede DOLCHE doc, note O/O-open intentional collision #113 DOLCHEO cleanup merged.
• P1.2 scope in full: feature half (batch-mode [D]/[O]/[L]/[C]/[H]/[E] prefixes + per-artifact array + backward-compat single input) and refactor half (prompt-over-code canary reading DOLCHEO from canon at runtime via KnowledgeBaseFetcher, three-tier fallback, governance_source in envelope, Zod knowledge_base_url override). One PR on klappy/oddkit, parallel shape to the telemetry_policy canary (salvage: orphaned handoff + PR #100 rage-quit ledger #108/odd/ledger: 2026-04-19 agent-team pilot session ledger #109 there).
• Path-3 workflow step-by-step: clone → edit → githooks → push → CF auto-deploys preview → smoke → PR → Sonnet 4.6 validator → iterate/accept → merge → main-preview smoke → main→prod PR → prod smoke.
• Priority-ordered reading list (8 items).
• Standing rules and foot-guns carried forward unchanged, plus one new entry confirming Cursor Bugbot is informational on klappy.dev — mergeable_state: clean is the authoritative gate.
• Four [O-open] forward-pointing items: P1 start P1.2, P2 next canary in the anti-pattern audit, P3 version bump 0.17.0 with populated CHANGELOG, P4 add superseded_by to the frontmatter schema if this session's pattern sticks.

Why it's its own PR

Handoff docs govern the next session's work. They go in odd/handoffs/ as named artifacts so the fresh session can oddkit_get klappy://odd/handoffs/2026-04-20-p1-2-encode-canary and resume productive work without reading a transcript.

Ready to merge once CI is green.

---

Note

Low Risk
Documentation-only change adding a session handoff; no production code paths or runtime behavior are modified.

Overview
Adds a new handoff document, odd/handoffs/2026-04-20-p1-2-encode-canary.md, that captures the planned P1.2 work for oddkit_encode: batch-mode prefix input with per-artifact array output, and a prompt-over-code canary refactor to load the DOLCHEO vocabulary from canon with three-tier fallback and governance_source reporting.

Also records the intended path-3 execution/validation workflow (orchestrator-applies, Sonnet validates), required smoke-test extensions, tool-description updates, and the carry-forward rules/foot-guns for the next session.

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