generated from coulomb/repo-seed
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:
39
AGENTS.md
39
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`.
|
||||
|
||||
Reference in New Issue
Block a user