coulomb/reuse-surface
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Complete REUSE-WP-0005: registry federation and relation graphs
Some checks failed
ci / validate-registry (push) Has been cancelled
Details

Browse Source 
Add federation manifest and schema, federation compose and graph CLI commands,
relation cycle/reference checks, federated index and Mermaid graph artifacts,
RegistryFederation guide, and CI validation updates.
This commit is contained in:
Bernd Worsch
2026-06-15 01:43:02 +02:00
parent f218a5305c
commit 40ab8dded0
15 changed files with 700 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
SCOPE.md
View File

@@ -52,6 +52,8 @@ and agents can:
- **Export a machine-readable bundle** with `reuse-surface export`
- **Detect overlap candidates** with `reuse-surface overlaps`
- **Generate a human-readable catalog** with `reuse-surface catalog`
- **Compose federated indexes** with `reuse-surface federation compose`
- **Generate relation graphs** with `reuse-surface graph`
- **Avoid duplicates** by querying the index and checking overlaps before adding entries
Registry tooling availability is **A3** (CLI). The registry product itself is
@@ -61,8 +63,8 @@ the index, and CLI automation.
## What Is Not Possible Yet
- Interactive catalog site with live search beyond static HTML export
- Capability graph visualization
- Federation across repositories or organizations
- Interactive relation graph UI (Mermaid file only)
- Network-based federation or cross-org index sync
- Packaged releases beyond local `pip install -e .` and Gitea CI validation
See `tools/README.md` for command reference.
@@ -75,9 +77,10 @@ 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.
- 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`.
- CI validates the registry and composes federation on push/PR.
- Federated index: `registry/indexes/federated.yaml`.
- Relation graph: `docs/graph/capability-graph.mmd`.
- Finished workplans: `REUSE-WP-0001` through `REUSE-WP-0005`.
- **Self-assessed vector:** `D5 / A3 / C4 / R2` (see gap analysis).
## Repository Layout
@@ -109,6 +112,8 @@ reuse-surface/
- Registry index: registry/indexes/capabilities.yaml
- Registry guidance: registry/README.md
- Generated catalog: docs/CapabilityCatalog.md
- Federation guide: docs/RegistryFederation.md
- Relation graph: docs/graph/capability-graph.mmd
- CLI reference: tools/README.md
- Agent instructions: AGENTS.md
- Workplans: workplans/