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

71 lines
1.9 KiB
Markdown
Raw Normal View History

---
id: REUSE-WP-0004
type: workplan
title: "Registry hardening: CI, overlap detection, and catalog"
domain: infotech
repo: reuse-surface
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
state_hub_workstream_id: "8e792e1e-8f28-4f7f-8c53-2b04ef078e61"
---
# 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
state_hub_task_id: "750e7fd6-f9b3-4945-a2f5-9a405ca3af6b"
```
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
state_hub_task_id: "8c5febb0-758d-4983-958c-093e5c481f2c"
```
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
state_hub_task_id: "2cae7d58-b943-4ef6-b404-2ad126450e0a"
```
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
state_hub_task_id: "a9660e01-81af-45fb-8d51-4f16fbaa94c2"
```
Update `SCOPE.md`, `tools/README.md`, and `docs/IntentScopeGapAnalysis.md` to
reflect CI, overlaps, and catalog capabilities. Close gap analysis priorities
911.