State-hub connect and initial workplans

docs/state-hub-integration.md

@@ -0,0 +1,49 @@
+# State Hub Integration
+
+## Registration
+
+`kontextual-engine` belongs to the State Hub `markitect` domain.
+
+Expected repo record:
+
+- repo slug: `kontextual-engine`
+- domain: `markitect`
+- topic id: `5571d954-0d30-4950-980d-7bcaaad8e3e2`
+- local path: `/home/worsch/kontextual-engine`
+- primary host path: `/home/worsch/kontextual-engine`
+
+Verify:
+
+```bash
+curl -s http://127.0.0.1:8000/repos/kontextual-engine | python3 -m json.tool
+```
+
+## Source Of Truth
+
+Workplans in this repository are authoritative. State Hub is the operational
+index/cache used for cross-repo coordination, dashboards, and task dispatch.
+
+When workplans change, sync from the State Hub repo:
+
+```bash
+cd /home/worsch/the-custodian/state-hub
+make fix-consistency REPO=kontextual-engine
+```
+
+## Integration Tier
+
+Core integration requires:
+
+- repo registered in State Hub
+- `SCOPE.md` present
+- `CLAUDE.md` present
+- workplans follow ADR-001 file format
+- `tpsc.yaml` declares external services, even if empty
+
+Full integration later needs:
+
+- active repo goals in State Hub
+- ingested capabilities from `SCOPE.md`
+- clean consistency check
+- SBOM once an implementation stack and lockfile exist
+