[P2] Inverse drift — renderers read undeclared props

[os-zhuang]

Part of the metadata liveness audit umbrella #1878 (P2 — spec hygiene, cluster #6).

Problem

Inverse drift: renderers depend on props the spec does not declare. These break a strict Schema.parse() — the renderer needs a key that a spec-validating author would never be allowed to write.

Checklist

• dashboard: component / data / rowField / columnField
• view: ObjectView form-adapter keys
• app: accentColor / badgeVariant / separator (also listed under naming drift)

For each: either add the prop to the spec (if it's legitimately authorable) or remove the renderer's dependency on it so strict validation holds.

Resolution

All three reconciled so strict validation holds:

• dashboard — component/data + the pre-ADR-0021 inline-analytics keys (rowField/columnField/…) are quarantined and rejected by the strict DashboardWidgetSchema error map (dashboard.zod.ts), pointing authors at dataset/dimensions/values (renderer-only extras → options). (already on main)
• app — accentColor/badgeVariant/separator declared on AppSchema (app.zod.ts). (already on main)
• view — the structured buttons/defaults (added to FormViewSchema under spec: structured form button/defaults config on FormViewSchema + enroll view in the liveness ledger #2998 Track A) are now consumed by the objectui ObjectForm renderer, so the two liveness-ledger entries flip experimental → live. The remaining flat form-adapter keys (customFields/className/fields) stay classified as renderer-only ObjectUI extensions, not spec surface (objectui#2545). Landed as a coordinated pair:
  • feat(form): consume spec-aligned FormView buttons/defaults in ObjectForm objectui#2790 — ObjectForm folds buttons/defaults onto its flat props (merged 6dee2cb)
  • chore(spec): flip FormView buttons/defaults to live; close view inverse-drift (#1894) #3417 — flips the ledger to live, drops the ADR-0078 markers, regenerates the view reference doc, updates the audit docs (merged c4df271)

Both merged with green CI. Closing.

Evidence

• docs/audits/README.md cluster Migrate from npm to pnpm #6
• docs/audits/2026-06-dashboardschema-property-liveness.md, 2026-06-viewschema-property-liveness.md, 2026-06-appschema-property-liveness.md

[os-zhuang]

All three inverse-drift items are now reconciled so a strict Schema.parse() holds:

• dashboard component/data/rowField/columnField — ✅ already resolved on main: component/data + the pre-ADR-0021 inline-analytics keys are quarantined and rejected by the strict DashboardWidgetSchema error map (dashboard.zod.ts), which points authors at dataset + dimensions/values (renderer-only extras → options).
• app accentColor/badgeVariant/separator — ✅ already resolved on main: all three declared on AppSchema (app.zod.ts).
• view ObjectView form-adapter keys — the last open piece, now done. The structured buttons/defaults (added to FormViewSchema under spec: structured form button/defaults config on FormViewSchema + enroll view in the liveness ledger #2998 Track A) were still experimental because no renderer read them. Fixed as a co-landed pair:
  • objectui feat(form): consume spec-aligned FormView buttons/defaults in ObjectForm objectui#2790 — ObjectForm folds buttons/defaults onto its flat renderer props (ObjectView + RecordFormPage forward them); flat keys kept as deprecated back-compat.
  • framework chore(spec): flip FormView buttons/defaults to live; close view inverse-drift (#1894) #3417 — flips view.form.buttons / view.form.defaults experimental → live in the liveness ledger, drops the ADR-0078 markers, updates the audit docs. The remaining flat adapter keys (customFields/className/fields) stay classified renderer-only ObjectUI extensions, not spec surface (objectui#2545).

Both PRs are up as drafts and verified green locally (spec liveness gate; objectui type-check + DOM suites). CI is currently red only due to a GitHub Actions runner-allocation outage (every job failing at provisioning with runner_id: 0), which I'm re-running once runners recover. Part of umbrella #1878.

---

Generated by Claude Code