WP-0016 finished: interactive registry maintain with llm-connect automation

Closes the registry maintenance loop from inside each domain repo:
interactive prompting for judgment calls, full automation for safe and
high-confidence changes, both backed by the llm-connect HTTP bridge.

- New modules: maintain.py, maintain_llm.py, patches.py, interactive.py
- Schema: schemas/registry-patch.schema.json
- CLI: reuse-surface maintain; establish --scaffold --hook
- Sibling templates: Makefile fragment, pre-commit hook
- Deterministic signal collectors extended; validate cwd auto-detect
- Docs, gap priority 28, SCOPE update
- Tests: test_maintain.py, test_interactive.py (59 pytest total)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/IntentScopeGapAnalysis.md

@@ -194,15 +194,17 @@ consumer telemetry.
 
 See §4 and archived workplans `workplans/archived/`.
 
-### Proposed next (priorities 25–27)
+### Proposed next (priorities 25–28)
 
 | Priority | Gap | Suggested outcome | Status |
 |---|---|---|---|
 | 25 | Gitea publish visibility | Raw URL HTTP 200 for all roster rows | **Closed** (WP-0015-T01) |
 | 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 |
+| 28 | Registry maintenance automation | Interactive `maintain` + `--auto` with llm-connect | **Closed** (WP-0016) |
 
-**Workplan:** `workplans/REUSE-WP-0015-federation-polish-and-planning-analytics.md`  
+**Workplan:** `workplans/REUSE-WP-0016-interactive-registry-maintain.md` (priority 28);
+`workplans/REUSE-WP-0015-federation-polish-and-planning-analytics.md` (25–27)  
 **Assessment:** `history/2026-06-16-intent-scope-assessment.md`
 
 **Follow-up docs:**
@@ -232,4 +234,5 @@ See §4 and archived workplans `workplans/archived/`.
 | 2026-06-17 | WP-0013 closed priority 24 |
 | 2026-06-16 | WP-0014 closed priority 18; 60 workstation repos |
 | 2026-06-16 | **SCOPE refresh + full INTENT success-criteria mapping**; priorities 25–27 proposed |
-| 2026-06-16 | Assessment persisted; **REUSE-WP-0015** created for priorities 25–27 |
+| 2026-06-16 | Assessment persisted; **REUSE-WP-0015** created for priorities 25–27 |
+| 2026-06-16 | **REUSE-WP-0016** closed priority 28 (interactive `maintain`, `--auto`, templates) |

docs/RegistryFederation.md

@@ -129,12 +129,27 @@ completes the establishment checklist below.
 cd ../state-hub
 reuse-surface establish --scaffold --domain helix_forge
 # optional: LLM_CONNECT_URL=... reuse-surface establish --discover --dry-run
-reuse-surface validate --root .
+reuse-surface validate
 git push origin main
 reuse-surface establish --publish-check \
   --raw-url https://gitea.coulomb.social/coulomb/state-hub/raw/main/registry/indexes/capabilities.yaml
 ```
 
+### Ongoing maintenance (from sibling repo)
+
+```bash
+export LLM_CONNECT_URL=http://127.0.0.1:8088   # optional
+reuse-surface maintain --all --from-git-since origin/main
+reuse-surface maintain --all --auto --no-llm    # CI / pre-commit
+reuse-surface maintain --publish \
+  --raw-url https://gitea.coulomb.social/coulomb/state-hub/raw/main/registry/indexes/capabilities.yaml \
+  --all --auto --no-llm
+```
+
+Copy `templates/Makefile.registry.fragment` for `make registry-maintain` /
+`make registry-check`. Optional pre-commit hook:
+`reuse-surface establish --scaffold --hook`.
+
 ### Registration checklist
 
 1. Merge capability index to the default branch.