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

WP-0015 follow-up: hub-core publish pass, refresh docs
Some checks failed
ci / validate-registry (push) Has been cancelled
Details

Browse Source 
Re-run federation sweep — hub-core now passes Gitea raw URL probe (12/60
blockers remain). Update workplan progress, SCOPE.md, IntentScopeGapAnalysis,
and operator checklist to reflect T02/T03 closure and current compose stats
(20 capabilities, 0 duplicate warnings).
This commit is contained in:
Bernd Worsch
2026-06-16 03:46:01 +02:00
parent d71f394911
commit 14979f0602
4 changed files with 66 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
docs/IntentScopeGapAnalysis.md
View File

@@ -35,12 +35,12 @@ dimensions, and human/agent consumers.
**Open gaps** (operator or follow-on workplans):
1. **Gitea publish visibility** — 13/60 repos fail raw URL probe (federation fetch).
2. **Index deduplication** — 16 duplicate IDs (reuse-surface vs owner repos).
3. **Planning analytics breadth** — no gap reports, roadmap views, or standardization tracker.
4. **Hub automation** — no polling/webhooks for federated refresh.
5. **Managed platform posture** — A6/Postgres/multi-replica not implemented.
6. **Consumer reliability evidence** — catalog mostly R0–R2; thin telemetry loop.
1. **Gitea publish visibility** — 12/60 repos fail raw URL probe (federation fetch).
2. **Planning analytics breadth** — gap report shipped; no roadmap views or
standardization tracker.
3. **Hub automation** — no polling/webhooks for federated refresh.
4. **Managed platform posture** — A6/Postgres/multi-replica not implemented.
5. **Consumer reliability evidence** — catalog mostly R0–R2; thin telemetry loop.
**Current reuse-surface product vector (self-assessment):** `D5 / A4 / C5 / R3`
@@ -56,7 +56,7 @@ dimensions, and human/agent consumers.
| Reuse over inventory | Explicit principle | Query, overlaps, federation, dedup plan | **Aligned** |
| Planning vs implementation reuse | Distinct dimensions | Query, vectors, `consumption_modes` | **Aligned** |
| Technical foundation | Eventually technical | CLI A3, hub A4, container A5 artifact | **Aligned** |
| Cross-repo capability visibility | Reuse across repos/products/orgs | 60 repos scaffolded; 37 federated caps | **Partial** |
| Cross-repo capability visibility | Reuse across repos/products/orgs | 60 repos scaffolded; 20 federated caps | **Partial** |
| Generalized primitives (D7) | Beyond single repo/domain | helix_forge only; no D7 pipeline view | **Partial** |
| Success criteria (8 outcomes) | See §5 | Most met; analytics + normalization partial | **Partial** |
| Repository layout | Tree in INTENT §Initial Repository Role | Matches SCOPE; roster artifact added | **Aligned** |
@@ -73,9 +73,9 @@ What `INTENT.md` still expects beyond current `SCOPE.md` delivery.
| INTENT claim | SCOPE reality | Gap |
|---|---|---|
| Capabilities reusable across repos, products, orgs | 60 repos on hub; 37 federated rows | Single domain (`helix_forge`) |
| Find capabilities before rebuilding at network scale | Hub + compose + roster | 13 indexes not HTTP-fetchable |
| Identify duplicates (success criterion) | `overlaps` + compose `warn` | 16 duplicate IDs unresolved in indexes |
| Capabilities reusable across repos, products, orgs | 60 repos on hub; 20 federated rows | Single domain (`helix_forge`) |
| Find capabilities before rebuilding at network scale | Hub + compose + roster | 12 indexes not HTTP-fetchable |
| Identify duplicates (success criterion) | `overlaps` + compose (0 duplicate warnings) | `activity-core` stub until publish passes |
**Follow-up:** `history/2026-06-16-wp0014-remaining-work-by-repo.md` (Gitea);
`history/2026-06-16-federation-deduplication-plan.md` (reuse-surface dedup).
@@ -84,8 +84,8 @@ What `INTENT.md` still expects beyond current `SCOPE.md` delivery.
| INTENT claim | SCOPE reality | Gap |
|---|---|---|
| Plan prototype/MVP/enhancement/platform work | `report cohorts`, query, catalog | No portfolio gap reports |
| Identify gaps, overlaps, standardization candidates | `overlaps` | No standardization workflow |
| Plan prototype/MVP/enhancement/platform work | `report cohorts`, `report gaps`, query | No roadmap views |
| Identify gaps, overlaps, standardization candidates | `overlaps`, `report gaps` | No standardization workflow |
| Track progress to generalized capabilities (D7) | Per-entry `promotion_history` | No cross-entry D7 pipeline |
### 3.3 Hub operations (Low–Medium)
@@ -106,8 +106,8 @@ What `INTENT.md` still expects beyond current `SCOPE.md` delivery.
| INTENT claim | SCOPE reality | Gap |
|---|---|---|
| Rich registry across organization | 60 scaffolds; 8 seeded | 47 repos at capability_count 0 |
| Discover mature capabilities network-wide | 37 federated rows | Growth is per-repo, optional |
| Rich registry across organization | 60 scaffolds; 8 seeded | 52 repos at capability_count 0 |
| Discover mature capabilities network-wide | 20 federated rows | Growth is per-repo, optional |
---
@@ -119,6 +119,8 @@ What `INTENT.md` still expects beyond current `SCOPE.md` delivery.
| WP-0012 | `hub sync`, cohort reports, INTENT layout, hub hardening doc | `hub_sync.py`, `docs/deploy/` |
| WP-0013 | Registry bootstrap in sibling repos | `establish`, `update`, `stats` |
| WP-0014 | Workstation registry rollout; hub 60 registrations | `local-repo-roster.yaml`; milestone history |
| WP-0015-T02 | Federated ID deduplication | 3 local entries; 0 compose duplicate warnings |
| WP-0015-T03 | Planning gap report | `reuse-surface report gaps` |
| Priority 18 | Sibling / workstation hub membership | 60/60 `hub list` |
| Priority 19–24 | See §8 | WP-0012/0013 deliveries |
@@ -130,14 +132,14 @@ From `INTENT.md` §Success Criteria:
| # | Criterion | Met? | SCOPE evidence | Remaining gap |
|---|---|---|---|---|
| 1 | Find reusable capabilities before rebuilding | **Yes** | Index, query, catalog, hub `/v1/federated`, federation compose | 13 sources not fetchable |
| 1 | Find reusable capabilities before rebuilding | **Yes** | Index, query, catalog, hub `/v1/federated`, federation compose | 12 sources not fetchable |
| 2 | Compare maturity consistently | **Yes** | Vectors, schema, graph relations | — |
| 3 | Distinguish conceptual readiness from delivery | **Yes** | D vs A in model and index | — |
| 4 | Distinguish internal assessment from external evidence | **Yes** | `maturity` vs `external_evidence` | — |
| 5 | Plan prototype/MVP/enhancement/platform work | **Partial** | `report cohorts`, query | No gap/roadmap reports |
| 6 | Identify gaps, duplicates, overlaps, standardization | **Partial** | `overlaps`, compose collision warnings | Dedup + standardization tracker |
| 5 | Plan prototype/MVP/enhancement/platform work | **Partial** | `report cohorts`, `report gaps`, query | No roadmap views |
| 6 | Identify gaps, duplicates, overlaps, standardization | **Partial** | `overlaps`, `report gaps`, deduped index | Standardization tracker |
| 7 | Track progress to generalized capabilities (D7) | **Partial** | `promotion_history` per entry | No org-wide D7 view |
| 8 | Make reuse normal in architecture work | **Partial** | AGENTS.md, 60-repo rollout | Publish + dedup polish |
| 8 | Make reuse normal in architecture work | **Partial** | AGENTS.md, 60-repo rollout | 12 publish blockers remain |
**Score:** 4 fully met, 4 partial — consistent with **C5** product completeness for
known registry expectations, not yet saturated (**C6**).
@@ -151,20 +153,20 @@ known registry expectations, not yet saturated (**C6**).
| Registry model and principles | Full | INTENT + specs | C5 |
| Maturity standard | Full | `CapabilityMaturityStandard.md` | C5 |
| Entry authoring | Full for MVP | Template + schema + README | C5 |
| Seed registry (reuse-surface) | Examples + meta | 20 entries | C4 |
| Seed registry (reuse-surface) | Examples + meta | 3 entries (meta + 1 stub) | C4 |
| Discovery surface | Machine-readable | Index, query, export, hub API, federated | C5 |
| Validation | Tooling | `validate` + CI | C5 |
| Search / filter | Supported | query, catalog HTML | C4 |
| Federation membership | Cross-repo | 60 hub members; compose + sync | C5 |
| Federation fetch reliability | Published indexes | 47/60 publish pass | C3 |
| Federation fetch reliability | Published indexes | 48/60 publish pass | C4 |
| Workstation bootstrap | Org-wide visibility | Roster + establish tooling | C4 |
| Agent instructions | Expected | AGENTS.md, tools README | C4 |
| Technical consumption | A3+ tools | CLI A3, hub A4 | C4 |
| Planning analytics | Success criteria | `report cohorts` | C3 |
| Planning analytics | Success criteria | `report cohorts`, `report gaps` | C4 |
| Documentation canon | Concept + living delta | Concept doc + this file | C4 |
**Overall completeness vs INTENT:** **C5** for reuse-surface product scope;
**C3** for end-to-end fetchable federation until Gitea blockers clear.
**C4** for end-to-end fetchable federation until remaining Gitea blockers clear.
---
@@ -177,7 +179,7 @@ known registry expectations, not yet saturated (**C6**).
| Production hub | `reuse.coulomb.social` — TLS, 60 registrations |
| Workstation rollout | Deterministic establish/validate; roster tracked |
| Consumer feedback | Informal; 3 entries with structured `consumer_feedback` |
| Known friction | 13 Gitea 404; 16 duplicate IDs; hub SQLite single-replica |
| Known friction | 12 Gitea 404; hub SQLite single-replica |
**Overall reliability vs INTENT consumer-evidence framing:** **R3 (Usable)** —
CI and production paths support normal agent/operator workflows with documented
@@ -196,9 +198,9 @@ See §4 and archived workplans `workplans/archived/`.
| Priority | Gap | Suggested outcome | Status |
|---|---|---|---|
| 25 | Gitea publish visibility (13 repos) | Raw URL HTTP 200 for all roster rows | **REUSE-WP-0015-T01** |
| 26 | Federated ID deduplication | Per-owner removal from reuse-surface index | **REUSE-WP-0015-T02** |
| 27 | Planning analytics + standardization | Gap report or standardization tracker | **REUSE-WP-0015-T03** |
| 25 | Gitea publish visibility (12 repos) | Raw URL HTTP 200 for all roster rows | **REUSE-WP-0015-T01** (in progress) |
| 26 | Federated ID deduplication | Per-owner removal from reuse-surface index | **Closed** (WP-0015-T02) |
| 27 | Planning analytics + standardization | Gap report or standardization tracker | **Partial** — gap report shipped (T03); tracker deferred |
**Workplan:** `workplans/REUSE-WP-0015-federation-polish-and-planning-analytics.md`
**Assessment:** `history/2026-06-16-intent-scope-assessment.md`