generated from coulomb/repo-seed
WP-0015 follow-up: hub-core publish pass, refresh docs
Some checks failed
ci / validate-registry (push) Has been cancelled
Some checks failed
ci / validate-registry (push) Has been cancelled
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:
21
SCOPE.md
21
SCOPE.md
@@ -82,16 +82,14 @@ index, CLI automation, and the production hub.
|
||||
|
||||
- **Automatic hub refresh** — federated compose is on-demand; no polling or
|
||||
webhooks
|
||||
- **Fully fetchable federation** — hub registers **60** workstation repos; **13**
|
||||
- **Fully fetchable federation** — hub registers **60** workstation repos; **12**
|
||||
still fail Gitea raw URL probe (operator visibility). See
|
||||
`registry/federation/local-repo-roster.yaml` and
|
||||
`history/2026-06-16-wp0014-remaining-work-by-repo.md`
|
||||
- **Clean federated ID namespace** — **16** duplicate IDs across reuse-surface
|
||||
and owner-repo indexes until per-owner dedup (see
|
||||
`history/2026-06-16-federation-deduplication-plan.md`)
|
||||
- **Multi-domain federation** — all indexed capabilities remain `helix_forge`
|
||||
- **Planning analytics beyond cohorts** — no gap reports, roadmap views, or
|
||||
standardization tracker beyond `report cohorts`, query, and export
|
||||
- **Planning analytics breadth** — `report gaps` shipped (REUSE-WP-0015-T03);
|
||||
no roadmap views or standardization tracker beyond `overlaps` and compose
|
||||
collision warnings
|
||||
- **Managed platform posture** — hub runs as a container (A5 artifact) without
|
||||
implemented SLO, multi-replica, or Postgres backing (criteria documented)
|
||||
- **Formal consumer feedback loop** for registry workflows (reliability evidence
|
||||
@@ -108,10 +106,10 @@ See `tools/README.md` for command reference.
|
||||
publish passes).
|
||||
- **Workstation roster:** 60 local git repos at `~/<slug>/` tracked in
|
||||
`registry/federation/local-repo-roster.yaml` — all **established**, **60/60**
|
||||
hub-registered, **47/60** publish-check pass.
|
||||
hub-registered, **48/60** publish-check pass.
|
||||
- **Federation:** `registry/federation/sources.yaml` — **60** hub-synced URL
|
||||
sources; `registry/indexes/federated.yaml` — **37** composed capability rows
|
||||
(16 duplicate-ID warnings, 13 remote fetch warnings).
|
||||
sources; `registry/indexes/federated.yaml` — **20** composed capability rows
|
||||
(0 duplicate-ID warnings, 12 remote fetch warnings).
|
||||
- **CLI / service:** `reuse_surface/` — validate, query, export, overlaps,
|
||||
catalog, federation, graph, hub client, establish/update/stats, `serve`
|
||||
(FastAPI hub).
|
||||
@@ -121,11 +119,12 @@ See `tools/README.md` for command reference.
|
||||
- **Docs:** `docs/CapabilityRegistryConcept.md`, `docs/RegistryFederation.md`,
|
||||
`docs/IntentScopeGapAnalysis.md`, deploy guide `docs/deploy/reuse-kubernetes.md`.
|
||||
- **CI:** `.gitea/workflows/ci.yml` — validate, federation compose, catalog,
|
||||
graph, pytest, informational `report cohorts`.
|
||||
graph, pytest, informational `report cohorts`, `stats --roster`, `report gaps`.
|
||||
- **Relation graph:** `docs/graph/capability-graph.mmd`, `docs/graph/index.html`.
|
||||
- **Searchable catalog:** `docs/catalog/search.html`.
|
||||
- **Workplans:** REUSE-WP-0001 through REUSE-WP-0014 finished (archived);
|
||||
**REUSE-WP-0015** ready (federation polish, dedup, planning analytics).
|
||||
**REUSE-WP-0015** active (federation polish, dedup, planning analytics) —
|
||||
T02/T03/T05 done; T01/T04 blocked on 12 Gitea publish failures.
|
||||
- **Assessment history:** `history/` — intent/scope assessments, rollout
|
||||
milestone, dedup plan, per-repo follow-up.
|
||||
- **Self-assessed vector:** `D5 / A4 / C5 / R3` (see `docs/IntentScopeGapAnalysis.md`).
|
||||
|
||||
@@ -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`
|
||||
|
||||
@@ -1,32 +1,26 @@
|
||||
# REUSE-WP-0014 — remaining work by repo
|
||||
|
||||
**Date:** 2026-06-16
|
||||
**Context:** Workplan archived; 60/60 established, 47/60 publish pass, 60/60 hub
|
||||
**Context:** Workplan archived; 60/60 established, 48/60 publish pass, 60/60 hub
|
||||
registered. This note is the operator/agent checklist for follow-up outside the
|
||||
closed workplan.
|
||||
|
||||
**2026-06-16 (WP-0015 follow-up):** `hub-core` publish pass; **12** Gitea blockers
|
||||
remain. Dedup complete (reuse-surface index: 3 entries).
|
||||
|
||||
**Roster:** `registry/federation/local-repo-roster.yaml`
|
||||
**Dedup plan:** `history/2026-06-16-federation-deduplication-plan.md`
|
||||
|
||||
---
|
||||
|
||||
## 1. Gitea publish blockers (13 repos)
|
||||
## 1. Gitea publish blockers (12 repos)
|
||||
|
||||
Federation cannot fetch these indexes until Gitea raw URLs return **HTTP 200**.
|
||||
|
||||
### `hub-core` — special case
|
||||
### `hub-core` — resolved (2026-06-16)
|
||||
|
||||
| Issue | Local registry committed; **no Gitea repo**; `push-to-create` disabled for org |
|
||||
| Action | Operator creates `coulomb/hub-core` on Gitea, then:
|
||||
|
||||
```bash
|
||||
cd ~/hub-core
|
||||
git push -u origin main
|
||||
reuse-surface establish --publish-check \
|
||||
--raw-url https://gitea.coulomb.social/coulomb/hub-core/raw/main/registry/indexes/capabilities.yaml
|
||||
```
|
||||
|
||||
Patch roster `publish_check: pass` after verify.
|
||||
Gitea repo `coulomb/hub-core` created; push and publish-check pass. Roster
|
||||
`publish_check: pass`.
|
||||
|
||||
### `activity-core` — seeded capability
|
||||
|
||||
|
||||
@@ -68,7 +68,7 @@ status: progress
|
||||
priority: high
|
||||
state_hub_task_id: "7024ca46-cabd-44a8-8baf-cbc83d99c1fe"
|
||||
needs_human: true
|
||||
intervention_note: "13 repos Gitea raw HTTP 404 — operator must fix visibility or create hub-core repo"
|
||||
intervention_note: "12 repos Gitea raw HTTP 404 — operator must fix visibility (hub-core resolved 2026-06-16)"
|
||||
```
|
||||
|
||||
Close gap priority **25**.
|
||||
@@ -76,10 +76,13 @@ Close gap priority **25**.
|
||||
**2026-06-16:** Sweep re-run — all 13 still HTTP 404. No agent-side remediation
|
||||
possible without Gitea operator action. Bring all roster rows to `publish_check: pass`.
|
||||
|
||||
**Blocked slugs (13):** `activity-core`, `hub-core`, `ihp-railiance-probe`,
|
||||
`inter-hub`, `net-kingdom`, `railiance-apps`, `railiance-cluster`,
|
||||
`railiance-enablement`, `railiance-infra`, `railiance-platform`,
|
||||
`tegwick-control`, `whynot-control`, `whynot-design`
|
||||
**2026-06-16 (follow-up):** `hub-core` resolved — Gitea repo created, push OK,
|
||||
`publish_check: pass`. **12** slugs remain HTTP 404.
|
||||
|
||||
**Blocked slugs (12):** `activity-core`, `ihp-railiance-probe`, `inter-hub`,
|
||||
`net-kingdom`, `railiance-apps`, `railiance-cluster`, `railiance-enablement`,
|
||||
`railiance-infra`, `railiance-platform`, `tegwick-control`, `whynot-control`,
|
||||
`whynot-design`
|
||||
|
||||
Per slug:
|
||||
|
||||
@@ -89,8 +92,8 @@ Per slug:
|
||||
4. Update `local-repo-roster.yaml` (`publish_check`, `publish_note`)
|
||||
5. Re-run roster sweep: all `publish_fail` → 0
|
||||
|
||||
**Special:** `hub-core` — create `coulomb/hub-core` on Gitea first (push-to-create
|
||||
disabled).
|
||||
**Resolved:** `hub-core` — `coulomb/hub-core` created on Gitea; roster
|
||||
`publish_check: pass` (2026-06-16 follow-up).
|
||||
|
||||
**Done when:** `reuse-surface stats --roster ... --federation-ready` shows
|
||||
`all_publish_pass: true`.
|
||||
@@ -177,6 +180,9 @@ Verify federation health after T01 and T02.
|
||||
push + `--refresh` for remote reuse-surface source. **13** fetch warnings remain
|
||||
(blocked on T01).
|
||||
|
||||
**2026-06-16 (follow-up):** Compose re-run — **0** duplicate-ID warnings,
|
||||
**12** remote fetch warnings, **20** federated capabilities. `hub-core` fetch OK.
|
||||
|
||||
```bash
|
||||
reuse-surface hub sync --merge
|
||||
reuse-surface federation compose
|
||||
@@ -218,11 +224,15 @@ done (operator choice documented in workplan).
|
||||
|
||||
```task
|
||||
id: REUSE-WP-0015-T06
|
||||
status: todo
|
||||
status: progress
|
||||
priority: low
|
||||
state_hub_task_id: "fd25e504-21b7-4e9f-841c-cfa20318be33"
|
||||
```
|
||||
|
||||
**2026-06-16 (follow-up):** Partial refresh — `SCOPE.md` and
|
||||
`docs/IntentScopeGapAnalysis.md` updated for T02/T03 closure and 12/60 publish
|
||||
blockers. Final pass when T01/T04 complete.
|
||||
|
||||
On workplan completion:
|
||||
|
||||
- Update `SCOPE.md` §What Is Not Possible Yet and §Current State
|
||||
@@ -254,3 +264,4 @@ On workplan completion:
|
||||
|---|---|
|
||||
| 2026-06-16 | WP-0015 created from `history/2026-06-16-intent-scope-assessment.md` |
|
||||
| 2026-06-16 | T02 dedup (3 local entries); T03 report gaps; T05 CI; T01 operator-blocked |
|
||||
| 2026-06-16 | Follow-up: hub-core publish pass (12 blockers); T06 partial doc refresh |
|
||||
Reference in New Issue
Block a user