---
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 9–11). 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
9–11.