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

REUSE-WP-0014: T11 docs, roster stats, workplan finished
Some checks failed
ci / validate-registry (push) Has been cancelled
Details

Browse Source 
Link local-repo-roster in RegistryFederation; rollout milestone history;
update IntentScopeGapAnalysis (60 hub members). Add stats --roster
--federation-ready for workstation federation readiness.
This commit is contained in:
Bernd Worsch
2026-06-16 02:09:57 +02:00
parent 993ffb42ea
commit 7c048a9f09
8 changed files with 253 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
docs/IntentScopeGapAnalysis.md
View File

@@ -3,7 +3,7 @@
**Repository:** `reuse-surface`
**Artifact:** `docs/IntentScopeGapAnalysis.md`
**Status:** Living analysis
**Updated:** 2026-06-17
**Updated:** 2026-06-16
**Purpose:** Record alignment, drift, and open gaps between declared intent and
current delivered scope so future workplans can close them deliberately.
@@ -22,16 +22,17 @@ REUSE-WP-0001 through REUSE-WP-0011 closed the original MVP and federation
roadmap. The documents are **directionally aligned** on registry-first reuse,
four maturity dimensions, and human/agent consumers.
**Remaining gaps** after REUSE-WP-0012 are **operational scale** items:
**Remaining gaps** after REUSE-WP-0014 rollout are **operational polish** items:
1. **Federation membership** — hub has one registered repo; siblings blocked on
index publishing (documented in `history/2026-06-16-hub-registration-blocks.md`).
2. **Planning analytics breadth** — cohort exports shipped; gap reports and
1. **Gitea publish visibility** — 60/60 workstation repos established and hub
registered; **13/60** still fail Gitea raw URL probe (operator action). Roster:
`registry/federation/local-repo-roster.yaml`.
2. **Index deduplication** — 16 duplicate IDs across reuse-surface and owner repos;
removal plan in `history/2026-06-16-federation-deduplication-plan.md`.
3. **Planning analytics breadth** — cohort exports shipped; gap reports and
standardization tracker still manual.
3. **Hub automation** — `hub sync` shipped; polling/webhooks still absent.
4. **Managed platform posture** — A5 container documented; A6/Postgres deferred.
5. **Registry bootstrap in sibling repos** — `establish`/`update`/`stats` shipped;
sibling adoption still operator-driven.
4. **Hub automation** — `hub sync` shipped; polling/webhooks still absent.
5. **Managed platform posture** — A5 container documented; A6/Postgres deferred.
**Current reuse-surface product vector (self-assessment):** `D5 / A4 / C5 / R3`
@@ -48,7 +49,7 @@ four maturity dimensions, and human/agent consumers.
| Planning vs implementation reuse | Distinct dimensions | Query, vectors, consumption_modes | Aligned |
| Technical foundation | “Eventually technical” | CLI A3, hub API A4, container A5 artifact | Aligned (MVP met) |
| Implementation consumption modes | Discoverable modes per capability | Supported in schema and index | Aligned |
| Cross-repo / org reuse | D7 generalized primitives | helix_forge domain; hub ready, thin membership | Partial |
| Cross-repo / org reuse | D7 generalized primitives | helix_forge; hub 60 repos; 37 federated caps | Partial |
| Success criteria | Eight outcomes | Most met; cohort reports added | Partial |
| Repository layout in INTENT | `standards/`, JSON schema, single yaml | Aligned in WP-0012 | Aligned |
| State Hub / workplans | Not in INTENT | In scope; ADR-001 sync | SCOPE-only (OK) |
@@ -60,16 +61,17 @@ four maturity dimensions, and human/agent consumers.
What INTENT still expects beyond current SCOPE delivery.
### 3.1 Cross-repo federation breadth (Medium — blocked on siblings)
### 3.1 Cross-repo federation breadth (Medium — polish remaining)
| INTENT claim | Current SCOPE reality | Gap |
|---|---|---|
| Capabilities reusable across repos, products, orgs | 20 entries, all `helix_forge` | No multi-domain federation yet |
| Find capabilities before rebuilding (network scale) | Hub `/v1/federated` from 1 repo | Sibling indexes not published (303) |
| Capabilities reusable across repos, products, orgs | 20 reuse-surface entries + 17 owner rows; 37 federated | No multi-domain federation yet |
| Find capabilities before rebuilding (network scale) | Hub **60** registrations; compose **37** capabilities | 13 repos Gitea raw 404; 16 duplicate IDs |
**Status (WP-0012):** Publish contract in `docs/RegistryFederation.md`; blocks
documented in `history/2026-06-16-hub-registration-blocks.md`. Registration
unblocks when sibling repos ship raw indexes.
**Status (WP-0014):** All workstation repos (`~/<slug>/`) established with
registry scaffolds. `hub sync --merge` materializes 60 URL sources. Operator
must fix Gitea visibility for 13 slugs (see roster). Deduplicate owner-migrated
entries per `history/2026-06-16-federation-deduplication-plan.md`.
### 3.2 Planning support breadth (Low–Medium)
@@ -137,7 +139,7 @@ INTENT success criteria after WP-0011:
| Plan prototype/MVP/enhancement/platform work | **Partial** | `report cohorts` + query/catalog; no gap reports |
| Identify gaps, duplicates, overlaps, standardization | **Partial** | Overlaps command; no standardization workflow |
| Track progress to generalized capabilities | **Partial** | Per-entry `promotion_history`; no D7 pipeline |
| Make reuse normal in product/architecture work | **Partial** | AGENTS.md, hub live; federation membership thin |
| Make reuse normal in product/architecture work | **Partial** | AGENTS.md, hub 60 repos; publish/dedup polish |
---
@@ -154,15 +156,15 @@ Using INTENT's completeness framing for the **reuse-surface product**:
| Discovery surface | Machine-readable | Index, query, export, hub API | C5 |
| Validation | Tooling | `validate` + CI | C5 |
| Search / filter | Supported | query, catalog HTML | C4 |
| Federation | Cross-repo | Compose + hub sync + production hub; 1 member | C4 |
| Federation | Cross-repo | Compose + hub sync; 60 hub members; 37 federated caps | C5 |
| Agent instructions | Expected | AGENTS.md + tools README | C4 |
| Technical consumption | A3+ for tools | CLI A3, hub A4 | C4 |
| Planning analytics | Success criteria | `report cohorts` | C3 |
| Documentation canon | Concept + assessment | Concept doc; assessment via README | C4 |
**Overall completeness vs INTENT:** **C5 (Expectation Complete)** for known
registry product expectations — hub sync, cohort reports, and federation
publish contract shipped; sibling membership remains bounded.
registry product expectations — workstation rollout (60 repos), hub sync,
cohort reports, and federation compose shipped; Gitea publish and dedup remain.
---
@@ -174,7 +176,7 @@ publish contract shipped; sibling membership remains bounded.
| Schema validation in CI | validate, federation, catalog, graph, pytest |
| Production hub | `reuse.coulomb.social` — TLS, health, dogfood registration |
| Consumer feedback on registry workflows | None formal |
| Known friction | Sibling index publishing; INTENT layout drift; hub single-replica SQLite |
| Known friction | 13 Gitea raw 404 repos; 16 federated duplicate IDs; hub SQLite single-replica |
**Overall reliability vs INTENT consumer-evidence framing:** **R3 (Usable)** —
CI and production smoke support normal agent/operator workflows with known
@@ -193,7 +195,7 @@ archived workplans under `workplans/archived/`.
| Priority | Gap | Suggested outcome | Status |
|---|---|---|---|
| 18 | Sibling hub registrations | `state-hub` + one other repo on hub | **Deferred** — blocks documented; awaiting sibling indexes |
| 18 | Sibling hub registrations | Workstation repos on hub | **Closed** (WP-0014) — 60/60 registered; 13 publish blocked |
| 19 | `hub sync` | Write `sources.yaml` from hub state | **Closed** (WP-0012) |
| 20 | Planning cohort reports | Export/filter views for D5+/A4+ candidates | **Closed** (WP-0012) |
| 21 | INTENT layout sync | Update INTENT.md tree and example entry shape | **Closed** (WP-0012) |
@@ -201,10 +203,11 @@ archived workplans under `workplans/archived/`.
| 23 | External evidence program | Raise catalog R levels with consumer_feedback | **Closed** (checklist + 3 entries; telemetry deferred) |
| 24 | Registry bootstrap tooling | `establish`, `update`, `stats` for sibling repos | **Closed** (WP-0013) |
**Workplan:** `REUSE-WP-0013` (finished). Prior: `REUSE-WP-0012` (finished).
**Workplan:** `REUSE-WP-0014` (finished). Prior: `REUSE-WP-0013`, `REUSE-WP-0012`.
**Assessment snapshots:**
`history/2026-06-15-intent-scope-assessment.md`,
`history/2026-06-16-hub-registration-blocks.md`.
`history/2026-06-16-hub-registration-blocks.md`,
`history/2026-06-16-local-repo-registry-rollout-complete.md`.
---
@@ -232,4 +235,5 @@ archived workplans under `workplans/archived/`.
| 2026-06-15 | Post-WP-0011 refresh: 20 capabilities, vector D5/A4/C4/R3, priorities 18–23 proposed |
| 2026-06-15 | REUSE-WP-0012 proposed; assessment archived in `history/2026-06-15-intent-scope-assessment.md` |
| 2026-06-16 | REUSE-WP-0012 closed priorities 19–23; priority 18 deferred on sibling index blocks; vector C5 |
| 2026-06-17 | REUSE-WP-0013 closed priority 24; establish/update/stats + optional llm-connect assist |
| 2026-06-17 | REUSE-WP-0013 closed priority 24; establish/update/stats + optional llm-connect assist |
| 2026-06-16 | REUSE-WP-0014 closed priority 18; 60 workstation repos; roster + federation compose |