Implement REUSE-WP-0013 registry establish, update, and stats

Add stats, establish (scaffold, publish-check, discover), and update CLI
commands with optional llm-connect bridge, validate --root for sibling repos,
pytest coverage, and documentation for sibling registry onboarding.

docs/IntentScopeGapAnalysis.md

@@ -3,7 +3,7 @@
 **Repository:** `reuse-surface`  
 **Artifact:** `docs/IntentScopeGapAnalysis.md`  
 **Status:** Living analysis  
-**Updated:** 2026-06-16  
+**Updated:** 2026-06-17  
 **Purpose:** Record alignment, drift, and open gaps between declared intent and
 current delivered scope so future workplans can close them deliberately.
 
@@ -30,6 +30,8 @@ four maturity dimensions, and human/agent consumers.
    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.
 
 **Current reuse-surface product vector (self-assessment):** `D5 / A4 / C5 / R3`
 
@@ -197,8 +199,10 @@ archived workplans under `workplans/archived/`.
 | 21 | INTENT layout sync | Update INTENT.md tree and example entry shape | **Closed** (WP-0012) |
 | 22 | Hub hardening | Postgres option, backup, documented SLO (A5→A6 path) | **Closed** (doc; implementation deferred) |
 | 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-0012` (finished). **Assessment snapshots:**
+**Workplan:** `REUSE-WP-0013` (finished). Prior: `REUSE-WP-0012` (finished).
+**Assessment snapshots:**
 `history/2026-06-15-intent-scope-assessment.md`,
 `history/2026-06-16-hub-registration-blocks.md`.
 
@@ -227,4 +231,5 @@ archived workplans under `workplans/archived/`.
 | 2026-06-15 | REUSE-WP-0011 closed priority 17; hub live at reuse.coulomb.social |
 | 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-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 |

docs/RegistryFederation.md

@@ -97,6 +97,18 @@ curl -fsS "<raw-url>" | head
   source) to an environment variable holding a Bearer token or full header value.
   The hub stores `auth_env` / `auth_header` names only — never secret values.
 
+### Sibling onboarding (CLI)
+
+```bash
+cd ../state-hub
+reuse-surface establish --scaffold --domain helix_forge
+# optional: LLM_CONNECT_URL=... reuse-surface establish --discover --dry-run
+reuse-surface validate --root .
+git push origin main
+reuse-surface establish --publish-check \
+  --raw-url https://gitea.coulomb.social/coulomb/state-hub/raw/main/registry/indexes/capabilities.yaml
+```
+
 ### Registration checklist
 
 1. Merge capability index to the default branch.