Archive REUSE-WP-0014; add per-repo remaining work guide
Some checks failed
ci / validate-registry (push) Has been cancelled

Move finished workplan to workplans/archived/260616-*.md and document
operator follow-up for Gitea blockers, owner dedup, and scaffold growth.
This commit is contained in:
2026-06-16 02:13:28 +02:00
parent 038888190a
commit eb381f939b
2 changed files with 149 additions and 2 deletions

View File

@@ -0,0 +1,142 @@
# REUSE-WP-0014 — remaining work by repo
**Date:** 2026-06-16
**Context:** Workplan archived; 60/60 established, 47/60 publish pass, 60/60 hub
registered. This note is the operator/agent checklist for follow-up outside the
closed workplan.
**Roster:** `registry/federation/local-repo-roster.yaml`
**Dedup plan:** `history/2026-06-16-federation-deduplication-plan.md`
---
## 1. Gitea publish blockers (13 repos)
Federation cannot fetch these indexes until Gitea raw URLs return **HTTP 200**.
### `hub-core` — special case
| 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.
### `activity-core` — seeded capability
| Issue | Gitea repo/page 404; has `capability.activity.event-coordinate` locally |
| Action | Fix Gitea visibility (below), confirm publish, then remove duplicate from
`reuse-surface` per dedup plan (reuse-surface still canonical until owner index fetches).
### SSH push OK, raw URL 404 (11 repos)
Pattern: `git push origin main` succeeds but
`https://gitea.coulomb.social/coulomb/<slug>/raw/main/registry/indexes/capabilities.yaml`
returns 404. Typical causes: **private repo** without anonymous raw access, repo
exists only on SSH mirror, or wrong org/path on web.
| Slug | Suggested repo work |
|---|---|
| `ihp-railiance-probe` | Confirm Gitea project visibility; enable public read or document auth for federation `auth_env` |
| `inter-hub` | Same; likely hub/interconnect doc repo — add INTENT note linking federation membership |
| `net-kingdom` | Same; when published, consider first capability entry for network topology discovery |
| `railiance-apps` | Railiance family — align with `railiance-platform` visibility policy (batch fix) |
| `railiance-cluster` | Document cluster capability stubs when ready; fix Gitea with other railiance repos |
| `railiance-enablement` | Enablement/runbooks repo — optional registry entries for ops capabilities |
| `railiance-infra` | Infra repo — high value for D4+ infra capabilities once indexed |
| `railiance-platform` | Platform umbrella — prioritize publish fix for federation discoverability |
| `tegwick-control` | Control-plane repo — publish + optional feature-control relation entries |
| `whynot-control` | Pair with `whynot-design`; fix both Gitea entries together |
| `whynot-design` | Design canon — add capability entries when design primitives stabilize |
**Operator batch procedure (per slug):**
1. Open `https://gitea.coulomb.social/coulomb/<slug>` — create repo if missing.
2. Set visibility so **raw** URLs work without login (or configure `auth_env` in `sources.yaml`).
3. Confirm default branch is `main` and `registry/indexes/capabilities.yaml` exists on remote.
4. Verify: `curl -sL -o /dev/null -w '%{http_code}\n' '<raw-url>'``200`
5. Update roster `publish_check: pass`; re-run `federation compose`.
---
## 2. Owner repos — deduplicate from reuse-surface (6 repos)
Publish **pass**; reuse-surface still holds duplicate index rows. Remove from
`reuse-surface` in **separate commits per owner** after confirming federation
compose shows the owner row.
| Owner repo | Capability IDs to drop from reuse-surface | Suggested owner-repo work |
|---|---|---|
| `audit-core` | `capability.audit.event-retain` | Promote maturity; add consumer evidence |
| `flex-auth` | `capability.authorization.policy-evaluate` | Link to policy modules; raise A level |
| `feature-control` | `evaluate`, `rollout`, `visibility` | Keep index as canonical SDK surface |
| `identity-canon` | `subject-resolution`, `vocabulary-canonicalize` | Expand canon docs; relations to `identity-canon` consumers |
| `state-hub` | `progress-log`, `workstream-coordinate` | Meta-registry for hub API capabilities |
| `shard-wiki` | 8× `capability.wiki.*` | Wiki federation entries are primary product surface |
**reuse-surface PR template (per owner):**
```bash
# After owner publish confirmed in compose
# Edit registry/indexes/capabilities.yaml — remove owner rows
# Delete registry/capabilities/capability.<domain>.<name>.md for those IDs
reuse-surface validate --relations
reuse-surface federation compose # duplicate warnings should drop
reuse-surface graph --check
```
---
## 3. Empty scaffolds — optional capability growth (47 repos)
Established with `capability_count: 0`. No WP-0014 follow-up required unless the
repo gains reusable behavior worth registering.
**Suggested priority** (repos with clear product boundaries):
| Repo | Suggestion |
|---|---|
| `llm-connect` | Register LLM bridge / provider capabilities (feeds `establish --discover`) |
| `ops-bridge` | Tunnel/ops capabilities; relations to `ops-hub`, `ops-warden` |
| `repo-seed` / `repo-scoping` | Registry bootstrap meta-capabilities |
| `open-reuse` | Open-reuse policy and contribution capabilities |
| `the-custodian` | Custodian orchestration capabilities |
| `helix-forge` | Domain umbrella entries for cross-repo patterns |
**Low-friction growth path:**
```bash
cd ~/<slug>
reuse-surface establish --discover --dry-run # optional LLM_CONNECT_URL
reuse-surface validate --root .
git add registry/ && git commit -m "Add capability entries" && git push origin main
reuse-surface establish --publish-check --raw-url <gitea-raw-url>
```
---
## 4. Cross-cutting (reuse-surface)
| Item | Action |
|---|---|
| Roster hygiene | After each fix, patch `local-repo-roster.yaml` summary counts |
| Hub manifest | `reuse-surface hub sync --merge` after URL or membership changes |
| Federation | `reuse-surface federation compose` — target 0 duplicate warnings post-dedup |
| Observability | `reuse-surface stats --roster registry/federation/local-repo-roster.yaml --federation-ready` |
| CI | Consider informational roster stats step when publish_fail > 0 |
---
## 5. Verification checklist (when all blockers cleared)
- [ ] Roster `publish_fail: 0`
- [ ] `federation compose` — 0 remote fetch warnings
- [ ] `federation compose` — 0 duplicate-ID warnings (after reuse-surface dedup)
- [ ] `reuse-surface hub list` — 60 enabled registrations
- [ ] Federated capability count reflects unique owner entries (~21+ as owners grow)

View File

@@ -4,16 +4,20 @@ type: workplan
title: "Local workstation repo registry rollout"
domain: helix_forge
repo: reuse-surface
status: finished
status: archived
owner: codex
topic_slug: helix-forge
created: "2026-06-17"
updated: "2026-06-16"
archived: "2026-06-16"
state_hub_workstream_id: "b60e63ae-c1f7-407a-a077-1cf661ba613f"
---
# Local workstation repo registry rollout
> **Archived 2026-06-16.** Follow-up per repo:
> `history/2026-06-16-wp0014-remaining-work-by-repo.md`
Establish a capability registry (`registry/indexes/capabilities.yaml` plus entries)
in **every git repository** present one level under the workstation home
directory. REUSE-WP-0013 delivered `establish` tooling; REUSE-WP-0012/0013
@@ -335,4 +339,5 @@ federation readiness aggregates.
| 2026-06-16 | T08 B06 done: **60/60** all local repos established |
| 2026-06-16 | T09 sweep: 60 hub registrations; 13 publish still Gitea 404 |
| 2026-06-16 | T10 federation: 60 sources, 37 caps, dedup plan documented |
| 2026-06-16 | T11 docs + stats --roster; **workplan finished** |
| 2026-06-16 | T11 docs + stats --roster; **workplan finished** |
| 2026-06-16 | Archived; remaining work in `history/2026-06-16-wp0014-remaining-work-by-repo.md` |