P0010 ledger: Lovable confirmation round + two-gate validation insight

[klappy]

Appends the post-merge Lovable confirmation round to the P0010 session ledger.

Key capture: the contract's filtering premise needs two validation gates, not one. The frontmatter audit proves structural fields are present and valid; Lovable's shadow-compare (server filter vs isPublicFacing(), ~1 week of diff logging) proves they are correct. The shadow-compare diff log is the empirical instrument for the proposal's own disconfirmer.

Also records: confirmed implementation order (held until oddkit PRs land), isPublicFacing() removal gated on audit not merge, and the full critical-path dependency chain. Ledger-only change.

---

Note

Low Risk
Documentation-only session ledger updates; no runtime, auth, or contract code changes in this PR.

Overview
Appends a post-merge Lovable confirmation section to the P0010 session ledger, recording that the final contract still matches the verified call inventory after PRs #216–#217.

Refines rollout policy: dropping isPublicFacing() is not tied to contract merge—it waits on a frontmatter audit, then a ~1 week shadow-compare (server audience/exposure vs the client filter with diff logging), then removal. Implementation stays blocked until oddkit lands the five-action contract; the ledger fixes a 1→5 step klappy.dev migration order (including retrieval.ts, oddkit_get first, search, doc-listing last with legacy envelope, proxy plumbing).

Key governance capture: filtering safety needs two gates—audit proves fields are present/valid; shadow-compare proves they are correct for a real consumer, with the diff log as the empirical disconfirmer. Also logs minor follow-ups (fetchDocument → oddkit_get, possible start-here-manifest retirement) and a critical-path dependency chain diagram ending at dropping the client filter.

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

[github-actions]

Canon Quality — oddkit_audit ✅

No dead klappy:// references or legacy link patterns found in writings/. 42 files scanned.

_{Spec: klappy://docs/oddkit/specs/oddkit-audit · Workflow: .github/workflows/canon-quality.yml · Run: #171}

[github-actions]

Canon Quality — Frontmatter Schema ✅

All 41 file(s) in writings/ conform to klappy://canon/meta/frontmatter-schema.

_{Validator: scripts/validate-frontmatter.py · Canon: klappy://canon/constraints/frontmatter-validation-before-merge · Run: #171}