generated from coulomb/repo-seed
Archive REUSE-WP-0014; add per-repo remaining work guide
Some checks failed
ci / validate-registry (push) Has been cancelled
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:
142
history/2026-06-16-wp0014-remaining-work-by-repo.md
Normal file
142
history/2026-06-16-wp0014-remaining-work-by-repo.md
Normal 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)
|
||||
@@ -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` |
|
||||
Reference in New Issue
Block a user