reuse-surface/workplans/REUSE-WP-0004-registry-hardening.md

66 lines
1.6 KiB
Markdown
Raw Normal View History

---
id: REUSE-WP-0004
type: workplan
title: "Registry hardening: CI, overlap detection, and catalog"
domain: helix_forge
repo: reuse-surface
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
---
# Registry hardening: CI, overlap detection, and catalog
Follow-up to `docs/IntentScopeGapAnalysis.md` section 8 next recommended work
(priorities 911). Raise registry quality through automated CI validation, overlap
reporting (UC-RS-015), and a generated human-readable catalog (UC-RS-018).
## Add CI Validation Workflow
```task
id: REUSE-WP-0004-T01
status: done
priority: high
```
Add `.gitea/workflows/ci.yml` that runs on push and pull requests to `main`.
Install the package and run `reuse-surface validate`. Document the workflow in
`AGENTS.md`.
## Add Overlap Detection Command
```task
id: REUSE-WP-0004-T02
status: done
priority: high
```
Add `reuse-surface overlaps` that flags potential duplicate or overlapping
capabilities using summary/tags/includes similarity and relation signals.
Document usage in `registry/README.md` and `tools/README.md`.
## Add Catalog Generation Command
```task
id: REUSE-WP-0004-T03
status: done
priority: medium
```
Add `reuse-surface catalog` that generates `docs/CapabilityCatalog.md` and
`docs/catalog/index.html` from the index and entry front matter. Group by domain
and show maturity vectors.
## Refresh Docs And Gap Analysis
```task
id: REUSE-WP-0004-T04
status: done
priority: medium
```
Update `SCOPE.md`, `tools/README.md`, and `docs/IntentScopeGapAnalysis.md` to
reflect CI, overlaps, and catalog capabilities. Close gap analysis priorities
911.