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.

workplans/archived/260617-REUSE-WP-0013-registry-establish-and-llm-assist.md

@@ -4,11 +4,11 @@ type: workplan
 title: "Registry establish, update, and stats with optional llm-connect assist"
 domain: helix_forge
 repo: reuse-surface
-status: ready
+status: finished
 owner: codex
 topic_slug: helix-forge
 created: "2026-06-16"
-updated: "2026-06-16"
+updated: "2026-06-17"
 state_hub_workstream_id: "239a0077-8593-4dc7-918d-4c23895275f6"
 ---
 
@@ -91,7 +91,7 @@ reuse-surface update --from-git-since HEAD~5 --apply
 
 ```task
 id: REUSE-WP-0013-T01
-status: todo
+status: done
 priority: high
 state_hub_task_id: "98e65330-bfc7-4282-b372-d35542b899ce"
 ```
@@ -112,7 +112,7 @@ Output: Markdown default, `--format json`. Pytest coverage. Document in
 
 ```task
 id: REUSE-WP-0013-T02
-status: todo
+status: done
 priority: high
 state_hub_task_id: "b8fedd87-d0d3-41b4-9af8-e36d52bfe1c5"
 ```
@@ -131,7 +131,7 @@ No llm-connect dependency. Pytest with temp directory.
 
 ```task
 id: REUSE-WP-0013-T03
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "2924d685-709f-4e28-886f-b363cd9c40b4"
 ```
@@ -147,7 +147,7 @@ Federation publish helper for sibling repo operators:
 
 ```task
 id: REUSE-WP-0013-T04
-status: todo
+status: done
 priority: high
 state_hub_task_id: "650ebee5-b34b-4ed8-891d-d93aacebadd7"
 ```
@@ -166,7 +166,7 @@ Thin client boundary:
 
 ```task
 id: REUSE-WP-0013-T05
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "b9154889-f538-4266-9918-b277f9a297be"
 ```
@@ -185,7 +185,7 @@ LLM-assisted bootstrap after `--scaffold` or on empty registry:
 
 ```task
 id: REUSE-WP-0013-T06
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "b79558da-54b2-4712-91d2-b298c7cf2c40"
 ```
@@ -210,7 +210,7 @@ Targets: single `--capability`, `--all`, `--from-git-since <ref>`.
 
 ```task
 id: REUSE-WP-0013-T07
-status: todo
+status: done
 priority: low
 state_hub_task_id: "a55a2f26-004e-4c20-90cb-49bed64a1291"
 ```
@@ -227,13 +227,20 @@ state_hub_task_id: "a55a2f26-004e-4c20-90cb-49bed64a1291"
 
 ## Acceptance
 
-- [ ] `reuse-surface stats` reports maturity and federation-readiness aggregates
-- [ ] `establish --scaffold` creates valid empty registry layout without overwrite accidents
-- [ ] `establish --publish-check` detects 303 vs 200 raw URL outcomes
-- [ ] llm-connect bridge works with mocked HTTP; fails clearly when URL unset
-- [ ] `establish --discover --dry-run` produces schema-valid draft JSON from fixture context
-- [ ] `update --dry-run` reports deterministic drift on sample repo
-- [ ] All new commands documented; gap priority 24 recorded
+- [x] `reuse-surface stats` reports maturity and federation-readiness aggregates
+- [x] `establish --scaffold` creates valid empty registry layout without overwrite accidents
+- [x] `establish --publish-check` detects 303 vs 200 raw URL outcomes
+- [x] llm-connect bridge works with mocked HTTP; fails clearly when URL unset
+- [x] `establish --discover --dry-run` produces schema-valid draft JSON from fixture context
+- [x] `update --dry-run` reports deterministic drift on sample repo
+- [x] All new commands documented; gap priority 24 recorded
+
+## Completion notes (2026-06-17)
+
+- Modules: `stats.py`, `establish.py`, `registry_update.py`, `llm_bridge.py`
+- Schema: `schemas/registry-draft.schema.json`
+- `validate --root` for sibling repo validation after establish --apply
+- 43 pytest tests; optional `pip install -e ".[llm]"` extra
 
 ## Out of scope