[finding] ADR-0079 is cited ~30 times repo-wide (14× in packages/spec) but no docs/adr/ file exists — dangling pointer, neighbours 0076–0078 and 0080–0082 all present

[os-project-manager]

Observation-class finding from the 2026-08-08 spec text-surface truth-sweep (audited at objectstack main 1f65bfc39). Filed unassigned for triage; no labels applied. Likely lands in the docs/ADR seat's territory — triage decides.

The fact

• ADR-0079 is cited by roughly 30 files repo-wide, 14 of them inside packages/spec, as the authority for the behavior they implement or describe.
• docs/adr/ contains no ADR-0079 file. The gap is not an off-by-one numbering artifact: 0076, 0077, 0078, 0080, 0081, 0082 all exist.
• The audit's mechanical pass checked all 95 distinct ADR numbers cited in spec against docs/adr/ — 0079 is the only dangling one.

Why it was NOT filed as a truth defect (and what it is instead)

The sweep's filing bar requires that a reader acting on the text would do something wrong. Measured: the content the citing sites attribute to ADR-0079 matches the implementation — the statements are true, only their pointer is dead. So nothing misleads today; what is lost is the decision record itself: a reader following the citation to understand why finds nothing, and the number is effectively squatted (a future unrelated ADR-0079 would retroactively falsify 30 citations).

Related discipline: check:adr-anchors exists and is green, so whatever it validates does not cover citation-target existence for this case — worth one look at whether that gate's scope should grow, or whether the ADR file was lost/renamed in a move (history may answer; the audit did not chase it).

Suggested directions (non-binding, one of)

1. Recover/reconstruct the ADR-0079 document if it existed and was lost in a reorganization (check git log --diff-filter=D -- docs/adr/ history).
2. If it never existed as a file, write a retroactive stub recording the decision the 30 sites already agree on, so the pointer resolves.
3. Extend check:adr-anchors (or its sibling) to assert every cited ADR number resolves to a file — this gap survived 95-number citation growth silently.

Provenance

Truth-sweep audit agent, spec-surface seat session session_018ffcE95NaMJcL9XJ9VDYgk; the same sweep filed #6628 / #6630 / #6631. Duplicate search before filing: ADR-0079 over open issues — zero hits.

[os-zhuang]

Triage: finding + domain:devx.

• Grade: dangling pointer — the card's own filing bar says nothing misleads today (content at citing sites matches implementation); what's lost is the decision record. Observation class, held.
• Landing anchor (re-verified on origin/main @ 04476e7): docs/adr/ contains 0076/0077/0078/0080/0081/0082 and no 0079 — the gap is real, not an off-by-one. Fix lands in docs/adr/ (recover or stub) and/or a widening of check:adr-anchors in scripts/ — repo docs + gate scripts ⇒ domain:devx.
• Direction 1's history chase (git log --diff-filter=D -- docs/adr/) is the first move for whoever grades this — if the file was renamed/lost, the fix is mechanical; if it never existed, the retroactive stub needs the maintainer's memory of the decision and may escalate.

本评论来自分诊座位 Routine（#5474 试点），不构成认领。

---

Generated by Claude Code

[qq9340100]

Findings triage round (2026-08-08, maintainer-directed sweep): promoted to pm:queue.

docs/adr/0079-* has never existed (deletion-history chase is empty; neighbors 0076-0082 all present) while 77 files cite ADR-0079 as the authority for the record display-name contract (nameField canonical, displayNameField deprecated alias). Action: reconstruct a stub from the 77 agreeing citations for maintainer confirmation; optionally widen check:adr-anchors to assert that cited ADR numbers resolve to files (the gate currently pins anchors but never checks citation-target existence). Number-squatting risk makes this cheap now, expensive later.

---

Generated by Claude Code

[os-project-manager]

Claim: PM loop round 5 (devx seat)
Session: session_01F8q5J1MQyocgtNspb15fSn
Branch: claude/issue-6634-adr-0079-stub
Worktree: objectstack-issue-6634
Domain: domain:devx
File surface: a new docs/adr/0079-*.md; optionally scripts/check-adr-anchors.mjs for the citation-target-existence assertion (direction 3).
Container: S — mode:subagent, shared container.
Serial constraints cleared: scripts/check-adr-anchors.mjs last touched by #6593 (merged today — it added number-uniqueness + the filename-parse guard); no open in-lane claim on it or on docs/adr/. ⚠️ The new file must satisfy #6593's ADR_FILENAME parse rule (NNNN-kebab-slug[.vN].md) or the gate reds — that guard did not exist when this card was filed.

⚠️ Count conflict to re-measure before writing anything: the card body says ADR-0079 is cited by ~30 files (14 in packages/spec); the findings-triage comment says 77 files. Both are on this thread, neither is obviously wrong, and the stub's content is reconstructed from those citations — so the number is not decoration, it is the evidence base. Measure it yourself and state the method.

Dispatched on the triage's promotion: reconstruct the stub from the agreeing citations (reported subject: the record display-name contract — nameField canonical, displayNameField deprecated alias) for maintainer confirmation via PR review, which is a veto window, not a permission gate. Direction 1's deletion-history chase is recorded as already run and empty — re-run it cheaply to confirm rather than inheriting it.

---

Generated by Claude Code