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

@@ -50,7 +50,9 @@ and agents can:
`external_evidence.reliability`
- **Validate entries automatically** with `reuse-surface validate`
- **Export a machine-readable bundle** with `reuse-surface export`
- **Avoid duplicates** by querying the index before creating new entries
- **Detect overlap candidates** with `reuse-surface overlaps`
- **Generate a human-readable catalog** with `reuse-surface catalog`
- **Avoid duplicates** by querying the index and checking overlaps before adding entries
Registry tooling availability is **A3** (CLI). The registry product itself is
still documentation-first for authoring; consumption combines Markdown entries,
@@ -58,11 +60,10 @@ the index, and CLI automation.
## What Is Not Possible Yet
- Generated human-readable catalog site
- Interactive catalog site with live search beyond static HTML export
- Capability graph visualization
- Automated duplicate/overlap detection
- Federation across repositories or organizations
- CI integration or packaged releases beyond local `pip install -e .`
- Packaged releases beyond local `pip install -e .` and Gitea CI validation
See `tools/README.md` for command reference.
@@ -74,7 +75,9 @@ See `tools/README.md` for command reference.
`pyproject.toml` and `reuse_surface/`.
- `docs/CapabilityRegistryConcept.md` and `docs/IntentScopeGapAnalysis.md`
document onboarding and intent-scope tracking.
- Finished workplans: `REUSE-WP-0001`, `REUSE-WP-0002`, `REUSE-WP-0003`.
- CI validates the registry on push/PR via `.gitea/workflows/ci.yml`.
- Generated catalog: `docs/CapabilityCatalog.md` and `docs/catalog/index.html`.
- Finished workplans: `REUSE-WP-0001` through `REUSE-WP-0004`.
- **Self-assessed vector:** `D5 / A3 / C4 / R2` (see gap analysis).
## Repository Layout
@@ -105,6 +108,7 @@ reuse-surface/
- Maturity standard: specs/CapabilityMaturityStandard.md
- Registry index: registry/indexes/capabilities.yaml
- Registry guidance: registry/README.md
- Generated catalog: docs/CapabilityCatalog.md
- CLI reference: tools/README.md
- Agent instructions: AGENTS.md
- Workplans: workplans/