core-hub/.claude/rules/session-protocol.md

Session Protocol

Dev Hub (State Hub API): http://127.0.0.1:8000

Step 1 - Orient

cat .custodian-brief.md
cat INTENT.md
cat SCOPE.md
ls workplans/

Use REST when MCP tools are unavailable:

curl -s "http://127.0.0.1:8000/workstreams/?topic_id=cee7bedf-2b48-46ef-8601-006474f2ad7a&status=active" | python3 -m json.tool

Step 2 - Check inbox

curl -s "http://127.0.0.1:8000/messages/?to_agent=core-hub&unread_only=true" | python3 -m json.tool

Mark read when handled.

Step 3 - Scan workplans

ls workplans/

For each file with status: ready, active, or blocked, note pending wait/todo/progress tasks.

Step 4 - Work file-first

State Hub is a read/cache/index layer. Work structure belongs in repo files under ADR-001.

Session close

cd ~/state-hub
make fix-consistency REPO=core-hub
curl -s -X POST http://127.0.0.1:8000/progress/ \
  -H "Content-Type: application/json" \
  -d '{"topic_id":"cee7bedf-2b48-46ef-8601-006474f2ad7a","event_type":"note","summary":"what changed","author":"codex"}'