Complete State Hub bootstrap workplan (HUB-WP-0001)

Set AGENTS.md purpose and developer commands, mark bootstrap tasks done,
and seed HUB-WP-0002 for remaining CUST-WP-0048 adapter seams.
This commit is contained in:
2026-06-22 19:32:56 +02:00
parent 0af0e58b6d
commit b61c15ba60
3 changed files with 147 additions and 7 deletions

View File

@@ -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`.