Complete REUSE-WP-0004: CI, overlap detection, and catalog generation
Some checks failed
ci / validate-registry (push) Has been cancelled

Add Gitea CI workflow for registry validation, reuse-surface overlaps and
catalog commands, generated catalog artifacts, and documentation updates
closing gap analysis priorities 9-11.
This commit is contained in:
2026-06-15 01:20:31 +02:00
parent 5c5023c000
commit c366fc4a4e
12 changed files with 538 additions and 12 deletions

View File

@@ -0,0 +1,66 @@
---
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.