chore(consistency): sync task status from DB [auto]

Updated by fix-consistency on 2026-06-22:
  - update .custodian-brief.md for hub-core

.custodian-brief.md

@@ -1,27 +1,24 @@
-<!-- custodian-brief: generated by statehub register; fix-consistency may replace this file -->
+<!-- custodian-brief: generated by fix-consistency — do not edit manually -->
-# Custodian Brief - hub-core
+# Custodian Brief — hub-core
 
-**Project:** hub-core
+**Domain:** infotech  
-**Domain:** inter_hub
+**Last synced:** 2026-06-22 17:33 UTC  
-**State Hub:** http://127.0.0.1:8000
+**State Hub:** http://127.0.0.1:8000 *(adjust if running on a remote machine)*
-**Topic ID:** `1f2e4d10-c967-4803-ae6c-7f4b4e806409`
 
-## Open Workplans
+## Active Workstreams
 
-### Bootstrap State Hub integration
+### Import-refactor adapter seams for State Hub closeout
+Progress: 0/3 done  |  workstream_id: `439b559b-fcb7-4d21-b831-cfc9c6bbc1a0`
 
-Workplan file: `workplans/HUB-WP-0001-statehub-bootstrap.md`
+**Open tasks:**
+- · Capability Request Write Router Factory  `f2e0a8a1`
+- · MCP Server Composition Hooks  `f50cd78f`
+- · Regression And Boundary Update  `450676fa`
 
-Open tasks:
+---
-- T01 - Review generated integration files
+## MCP Orientation (when available)
-- T02 - Verify local developer workflow
-- T03 - Seed first real workplan
 
-## Session Start
+If the state-hub MCP server is reachable, call:
-
+`get_domain_summary("infotech")`
-1. Read `INTENT.md`, `SCOPE.md`, and `AGENTS.md`.
+This provides richer cross-domain context.
-2. Check inbox: `GET /messages/?to_agent=hub-core&unread_only=true`.
+If the MCP call fails, use this file as your orientation source.
-3. Scan `workplans/`.
-4. Update task statuses in workplan files as work progresses.
-
-Last generated: 2026-06-16

AGENTS.md

@@ -2,7 +2,9 @@
 
 ## Repo Identity
 
-**Purpose:** **Updated:** 2026-06-16.
+**Purpose:** Reusable Python package of FastAPI router factories, SQLAlchemy
+models, Pydantic schemas, MCP tooling, and migration scaffolds for FOS hub
+services.
 
 **Domain:** inter_hub
 **Repo slug:** hub-core
@@ -101,8 +103,43 @@ curl -s -X PATCH "http://127.0.0.1:8000/tasks/<task_id>" \
 
 ---
 
+## Commands
+
+`hub-core` is a library — there is no `serve` entrypoint. Host repos mount
+routers and run their own `uvicorn` process.
+
+```bash
+cd ~/hub-core
+
+# Install (editable)
+python3 -m venv .venv && .venv/bin/pip install -e .
+
+# Test
+.venv/bin/pytest -q
+
+# Compile check (fast sanity)
+python3 -m compileall hub_core
+
+# Build wheel
+.venv/bin/pip install build && python3 -m build
+
+# Consumer regression (after router/schema changes)
+cd ~/state-hub && make test
+```
+
+No repo-native lint or format targets yet. Add `ruff` / `mypy` when the
+package surface stabilizes.
+
+Primary references: `INTENT.md`, `SCOPE.md`, `README.md`,
+`~/the-custodian/docs/hub-core-extraction-boundary.md`.
+
+---
+
 ## Credential and access routing
 
+> Fleet template mirrored in `.claude/rules/credential-routing.md` for Claude Code.
+> Re-sync both from `~/ops-warden/wiki/CredentialRouting.md` when the catalog changes.
+
 **Audience:** Codex, Claude Code, Grok, and custodian agents that call **llm-connect**
 for inference. Run this check **before** requesting secrets, API keys, SSH access,
 login tokens, or database passwords — in any repo, not only `ops-warden`.

workplans/HUB-WP-0001-statehub-bootstrap.md

@@ -4,46 +4,58 @@ type: workplan
 title: "Bootstrap State Hub integration"
 domain: inter_hub
 repo: hub-core
-status: ready
+status: finished
 owner: codex
 topic_slug: inter_hub
 created: "2026-06-16"
-updated: "2026-06-16"
+updated: "2026-06-22"
+state_hub_workstream_id: "4a31e8cd-1a06-40bf-abc9-76ca9ac173f2"
 ---
 
 # Bootstrap State Hub integration
 
-**Updated:** 2026-06-16.
+**Updated:** 2026-06-22.
 
 ## Review Generated Integration Files
 
 ```task
 id: HUB-WP-0001-T01
-status: todo
+status: done
 priority: high
+state_hub_task_id: "2c459592-c971-42b3-8835-75f89a988dc8"
 ```
 
 Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
 Replace generated placeholders with repo-specific facts where needed.
 
+Completed 2026-06-22: `INTENT.md` and `SCOPE.md` already describe the package
+boundary. `AGENTS.md` Purpose now states the library role; credential routing
+and fleet mirror note added.
+
 ## Verify Local Developer Workflow
 
 ```task
 id: HUB-WP-0001-T02
-status: todo
+status: done
 priority: high
+state_hub_task_id: "87054735-cd9a-4018-afde-741e0cef811c"
 ```
 
 Identify the repo's install, test, lint, build, and run commands. Add or refine
 those commands in the agent instructions so future coding sessions can verify
 changes confidently.
 
+Completed 2026-06-22: `AGENTS.md` now documents install, test, compile check,
+wheel build, and State Hub consumer regression commands. No lint/format targets
+yet — noted as future work.
+
 ## Seed First Real Workplan
 
 ```task
 id: HUB-WP-0001-T03
-status: todo
+status: done
 priority: medium
+state_hub_task_id: "aca066a0-db3d-4496-821a-0fa13c2ae542"
 ```
 
 Create the first implementation workplan for the repository's most important
@@ -52,3 +64,8 @@ next change. After workplan file updates, run from `~/state-hub`:
 ```bash
 make fix-consistency REPO=hub-core
 ```
+
+Completed 2026-06-22: seeded
+`workplans/HUB-WP-0002-import-refactor-adapter-seams.md` to close the
+remaining CUST-WP-0048 adapter seams (capability request writes, MCP
+composition, regression handoff).

workplans/HUB-WP-0002-import-refactor-adapter-seams.md

@@ -0,0 +1,86 @@
+---
+id: HUB-WP-0002
+type: workplan
+title: "Import-refactor adapter seams for State Hub closeout"
+domain: inter_hub
+repo: hub-core
+status: ready
+owner: codex
+topic_slug: inter_hub
+created: "2026-06-22"
+updated: "2026-06-22"
+state_hub_workstream_id: "439b559b-fcb7-4d21-b831-cfc9c6bbc1a0"
+---
+
+# Import-refactor adapter seams for State Hub closeout
+
+## Goal
+
+Finish the hub-core side of **CUST-WP-0048** so State Hub can close the
+capability-request write workflow and generic MCP split without forking shared
+primitives.
+
+Child workplan: `~/the-custodian/workplans/CUST-WP-0048-hub-core-state-hub-import-refactor.md`
+Boundary reference: `~/the-custodian/docs/hub-core-extraction-boundary.md`
+
+`hub-core` already owns read paths, generic JSON adapter fields
+(`subject_refs`, `request_context`, `fulfillment_context`), and
+`HubCoreMCPServer`. Remaining seams are write workflows and host MCP
+composition.
+
+## Capability Request Write Router Factory
+
+```task
+id: HUB-WP-0002-T01
+status: todo
+priority: high
+state_hub_task_id: "f2e0a8a1-1943-4d40-963b-3d736d2340bf"
+```
+
+Add a `create_capability_request_write_router` factory with host-injected models,
+schemas, and workflow callbacks for:
+
+- request creation
+- acceptance
+- status transitions
+- patch / dispute / reroute paths that today live in State Hub
+
+Callbacks must cover dev-hub side effects (flow transitions, notifications,
+task-unblock) without pulling workstream/task foreign keys into hub-core models.
+
+**Done when:** State Hub can mount write routes from the factory; hub-core tests
+cover callback invocation and route registration.
+
+## MCP Server Composition Hooks
+
+```task
+id: HUB-WP-0002-T02
+status: todo
+priority: medium
+```
+
+Extend `HubCoreMCPServer` so State Hub can compose or subclass it while keeping
+dev-hub-only tools local. Provide a clear registration seam for host tools and
+document which ~17 generic tools stay in hub-core.
+
+**Done when:** State Hub MCP module imports `HubCoreMCPServer` for generic tools
+without duplicating orientation, messaging, capability, repo, TPSC, DoI, or
+risk/alert registrations.
+
+## Regression And Boundary Update
+
+```task
+id: HUB-WP-0002-T03
+status: todo
+priority: high
+```
+
+After T01–T02 land (or are explicitly deferred with documented seams):
+
+- run full `hub-core` pytest and `~/state-hub` regression
+- update `hub-core-extraction-boundary.md` with resolved couplings and any
+  deferred adapter points
+- hand results back so **CUST-WP-0048** T05–T07 can close
+
+**Done when:** both test suites pass and the extraction boundary reflects the
+new write/MCP seams.