[finding] ADR-0082 cites the moved golden-page path and an os validate output that never renders (error + warning in one run)

[claude]

Found while working #10284 (the 2026-06 react-tier dogfood audit's stale citations). That audit was the reported instance; docs/adr/0082-react-component-contract-governance.md line 99 carries the same two defects, and it was outside that card's file surface — docs/adr/** is governed, human-merge-only.

The line reads:

examples/app-showcase/src/pages/renewals-pipeline.page.ts is the golden page: authored straight from the contract (five server-connected blocks), it passes os validate; injecting a missing required objectName and an onSucces typo makes the gate fail with an error + a warning (captured in docs/audits/2026-06-react-tier-authoring-dogfood.md). The chain demonstrably closes.

Two things in it no longer hold. Both measured against origin/main at b05a543654, not recalled.

1. The path moved

$ ls examples/app-showcase/src/pages/renewals-pipeline.page.ts
ls: cannot access 'examples/app-showcase/src/pages/renewals-pipeline.page.ts': No such file or directory

$ find . -name '*renewals*' -not -path './node_modules/*' -not -path './.git/*'
./examples/app-showcase/src/ui/pages/renewals-pipeline.page.ts

After #10284 lands, ADR-0082 line 99 is the only remaining citation of the old path in the tree:

$ grep -rn "app-showcase/src/pages/" --exclude-dir=node_modules --exclude-dir=.git .
./docs/audits/2026-06-react-tier-authoring-dogfood.md:16:...   # corrected by #10284
./docs/adr/0082-react-component-contract-governance.md:99:...

2. "fail with an error + a warning" describes an output the CLI never renders

The two findings do not appear in one run. os validate exits at the error gate before advisories are rendered (packages/cli/src/commands/validate.ts — the ruleErrors.length > 0 branch calls this.exit(1) before the advisory list is printed), so with both mistakes injected only the error prints.

Both mistakes injected, real output from the CLI built at b05a543654 against examples/app-showcase:

  → Running author-time rules (41)...

  ✗ Author-time rules failed (1 issue)
  • page "showcase_renewals_pipeline" › <ObjectChart>: <ObjectChart> is missing the required prop "objectName".
      Pass objectName={…}. See the react-tier component contract.
      rule: react-prop-missing-required  at pages[27].source
                                                 # exit 1

No warning. Only the onSucces typo injected:

  ✓ Validation passed (1298ms)
  …
  ⚠ page "showcase_renewals_pipeline" › <ObjectForm>: <ObjectForm> has prop "onSucces" — did you mean "onSuccess"?
                                                 # exit 0

So the severity split the sentence relies on is real and intact — a missing required binding is fatal, a near-miss prop name is a non-fatal advisory — but "makes the gate fail with an error + a warning" describes one run producing both, which never happens. The ADR's conclusion ("the chain demonstrably closes") is unaffected; it is the illustration that is wrong.

Suggested fix

A minimal edit to line 99: correct the path to examples/app-showcase/src/ui/pages/renewals-pipeline.page.ts, and reword the parenthetical to something like "…makes the gate fail (the near-miss prop name is a separate, non-fatal advisory)". The audit's new dated header carries the measured output if a citation is wanted.

Governed file, so filing rather than fixing.

---

Generated by Claude Code

[huangyiirene]

Triage first-touch: promoted to queue, type Task. Governed surface (docs/adr/**): dispatch draft-only, human merge — but no pre-ruling is needed, because the edit is a factual citation repair (the moved path + the impossible one-run illustration) and the ADR's ruling and conclusion are untouched; the human merge is the review. Both defects were measured against origin/main, with real CLI output in the card. Size/model suggestion: S (one line + a parenthetical), sonnet; re-verify the path and the CLI behaviour on current main before editing (same-day churn: #10284 was landing adjacent fixes).

---

Generated by Claude Code

[os-steve]

Claim: PM dispatch (devx seat)

• Session: session_015ahemw8RcTgqtxrj15PEZx
• Branch: claude/issue-10808-adr-0082-citation-repair

Governed surface (docs/adr/**), so per triage and Prime Directive #14 the PR is draft-only: ⛔ never flipped ready, never enqueued, never auto-merged. ACCEPT ends with request-review to os-zhuang, and the maintainer's hand-merge is the review record.

Checked for a same-file holder before claiming: of the 26 open PRs, the two that touch docs/adr/** are #11780 (ADR-0057 D10 → ADR-0124 D1 retarget) and #11829 (ADR-0125 status line). Neither touches docs/adr/0082-react-component-contract-governance.md — read from their actual changed-file lists, not from their titles. No serial constraint.

Tier: opus. Derived live — node scripts/pm/dispatch-gates.mjs --tier docs/adr/0082-react-component-contract-governance.md reports no path-derived mandate, so the floor is sonnet and the tier is this seat's call. Triage suggested sonnet on edit size, and the edit is one line plus a parenthetical — but the load-bearing half is re-deriving the two-mistake os validate run on current main (build the CLI, inject both, observe that only the error prints). That is precisely the kind of measurement that gets recalled instead of taken, so opus.

---

Generated by Claude Code