Fleet coverage retrofit: bring larpingapp to 100% spec coverage

[rubenvdlinde]

Fleet coverage retrofit — larpingapp

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	—	122	0 / 8 clusters	18 / 1 clusters	2	3	18 findings / 5 rules

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

---

Phase 0 — Foundation cleanup

• Archive search-service spec (17 REQs of dead-code documentation — class was removed)
• Continue larpingapp-legacy-quality-cleanup change for pre-OpenRegister lib/Db/ orphans (18 entity+mapper classes)

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 (122 methods)

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

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

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

Phase 4 — Bucket 3 triage (2 + 3 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 (18 findings across 5 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 larpingapp — 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.