Fleet coverage retrofit: bring openbuilt to 100% spec coverage

[rubenvdlinde]

Fleet coverage retrofit — openbuilt

Goal: bring this app to 100% spec coverage per opsx-coverage-scan v1 — every lib/ method either carries @spec openspec/changes/.../tasks.md#task-N or is classified as plumbing; Buckets 2/3 drain to zero; Bucket 4 ADR findings clear.

Baseline (generated 2026-05-24): see openspec/coverage-report.md on this repo for the full report.

annotated	plumbing-or-other	Bucket 1 (matched)	Bucket 2a (cap, no REQ)	Bucket 2b (no cap)	Bucket 3a (broken)	Bucket 3b (unimpl)	Bucket 4 (ADR)
0 files	—	185	17 / 2 clusters	1 / 1 clusters	0	22	12 findings / 4 rules

Fleet roll-up: apps-extra/COVERAGE-FLEET.md in hydra (and your local checkout).

---

Phase 0 — Foundation cleanup

• Fix archive-residue: all 17 specs' ## Purpose blocks contain placeholder "TBD - created by archiving change..."
• Resolve duplicate REQ-IDs in openbuilt-runtime spec (REQ-OBR-006/007/008/009 each appear 2-3× from concatenated archive deltas)
• GitHubPushService is Phase-1 stub — decide priority for real implementation

Phase 1 — REQ-ID format normalization

• Audit openspec/specs/**/spec.md — adopt canonical ### Requirement: <title> format if not already
• Migrate any non-canonical REQ headings (shorthand, plain bullets, ID-in-title) to canonical form

Phase 2 — Bucket 1 annotation sweep (185 methods)

• Run /opsx-annotate openbuilt → ghost change retrofit-YYYY-MM-DD-annotate-openbuilt → PR
• Reviewer + applier pass on the resulting PR

Phase 3 — Reverse-spec for Bucket 2 (18 methods, 3 clusters)

• Run /opsx-reverse-spec openbuilt --extend <cap> per Bucket 2a cluster (bias toward --extend per skill guidance)
• Run /opsx-reverse-spec openbuilt --cluster <name> per Bucket 2b cluster, after pre-splitting any namespace-word labels

Phase 4 — Bucket 3 triage (0 + 22 entries)

• 3a: open fix PR for each (REQ has evidence in removed git lines — implementation is possibly broken/removed)
• 3b: for each, decide implement / defer (mark status: deferred in spec) / archive

Phase 5 — Bucket 4 ADR conformance (12 findings across 4 rules)

• Sweep via hydra-gate-spdx autofix for license/copyright/SPDX gaps
• i18n-wrap any hardcoded user-facing strings
• Case-by-case review of direct-SQL findings (some may be justified cross-schema ops)
• Verify file-docblock @spec tags follow Phase 2 annotation

Phase 6 — Verify

• Re-run /opsx-coverage-scan openbuilt — verify Bucket 1 + plumbing + annotated == total methods; Buckets 2/3 == 0
• Close this issue when the re-scan summary is clean

---

References

• Fleet roll-up: apps-extra/COVERAGE-FLEET.md
• Skill: hydra/.claude/skills/opsx-coverage-scan/SKILL.md
• This app's full coverage report: openspec/coverage-report.md

Tracking issue created by Claude on behalf of @rubenvdlinde as part of the 2026-05-24 fleet coverage audit.