Add state-hub v0.1 — local-first state service for the Custodian
Implements the first live layer of the Custodian cognitive infrastructure:
PostgreSQL schema, FastAPI REST API, FastMCP stdio server, and Observable
Framework telemetry dashboard.
- state-hub/: full stack (docker-compose, FastAPI, Alembic, MCP server, dashboard)
- 5 DB tables: topics, workstreams, tasks, decisions, progress_events
- 11 MCP tools + 5 resources registered in .mcp.json
- Observable dashboard: Overview, Workstreams, Decisions, Progress pages
- CLAUDE.md: session protocol (get_state_summary / add_progress_event ritual)
- ~/.claude/CLAUDE.md: global cross-project reference to the hub
- scripts/pull_image.py: WSL2 TLS-resilient Docker image downloader
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-24 17:47:49 +01:00
|
|
|
# Copy to .env and fill in values before running
|
|
|
|
|
POSTGRES_DB=custodian
|
|
|
|
|
POSTGRES_USER=custodian
|
|
|
|
|
POSTGRES_PASSWORD=changeme
|
|
|
|
|
|
|
|
|
|
DATABASE_URL=postgresql+asyncpg://custodian:changeme@127.0.0.1:5432/custodian
|
|
|
|
|
|
|
|
|
|
# pgAdmin (optional, only used with --profile tools)
|
|
|
|
|
PGADMIN_EMAIL=admin@local.dev
|
|
|
|
|
PGADMIN_PASSWORD=admin
|
|
|
|
|
|
|
|
|
|
# API
|
|
|
|
|
API_BASE=http://127.0.0.1:8000
|
2026-03-16 01:41:16 +01:00
|
|
|
|
2026-08-09 16:19:53 +02:00
|
|
|
# Read-only activity-core ops_run projection (STATE-WP-0078).
|
|
|
|
|
ACTIVITY_CORE_URL=http://127.0.0.1:8010
|
|
|
|
|
# Inject from OpenBao/ESO in production; never commit the value.
|
|
|
|
|
ACTIVITY_CORE_WORKER_TOKEN=
|
|
|
|
|
OPS_RUN_PROJECTION_TTL_SECONDS=15
|
|
|
|
|
OPS_RUN_SLA_HOURS=1
|
|
|
|
|
|
2026-03-16 01:41:16 +01:00
|
|
|
# Gitea (for gitea_inventory.py)
|
|
|
|
|
GITEA_URL=http://92.205.130.254:32166
|
|
|
|
|
GITEA_TOKEN=
|