Session Handoff — 2026-03-28

Read this FIRST in any new session. Canonical context for continuing work.

TL;DR — What to Build Next

Phase 1: Mission Control Panel — VPS endpoint /api/mission-control + React component MissionControlPanel.tsx on dashboard Mission tab. Jason sees factory state from browser.
Phase 2: Ralph Pipeline — Add agent_type column to ralph_queue/events. Modify ralph.sh to emit agent_type metadata.
Phase 3: Concurrent Agents — Multiple systemd workers, each filtered by agent_type. True swarm.

What Was Built This Session

Artifact	Status	Location
Document Registry	LIVE	jasondmacdonald.com/forge-registry + config/document-registry.json
Federation Protocol	DONE	Vault/shared/DOCUMENT-FEDERATION.md
Canonical Changelog Pattern	DONE	memory/canonical-changelog.md + MEMORY.md principle
Mission Control Alignment	APPROVED (57/60)	Vault/projects/forge-mission-control/ALIGNMENT.md
3-Tier Backup	LIVE	scripts/backup.sh + backup-canary.sh (crons active)
Dashboard Fix	DEPLOYED	apps/dashboard/ — Suspense boundary fix
Jason Profile	PUBLISHED	jasondmacdonald.com/jason-profile

Phase 1 Build Spec — Mission Control Panel

VPS Endpoint: /api/mission-control

Aggregates: ralph-status + services/health + jason-deps + cascade (top 5) + recent ralph_events (last 10) + active Claude sessions. Single JSON response.

{
  "agents": { "ralph": {...}, "heartbeat": {...}, "pipeline": {...} },
  "open_loops": [{ "score": 105, "item": "..." }],
  "recent": [{ "event_type": "success", "project": "...", "task": "..." }],
  "jason_deps": { "count": 6, "critical": 2, "items": [...] },
  "next_moves": [{ "item": "...", "unlocks": "..." }],
  "registry_health": { "total": 40, "stale": 3, "needs_review": 2 }
}

Dashboard Component: MissionControlPanel.tsx

5 sections in one card on Mission tab:

Active Agents — What's running now (10s poll)
Open Loops — Top 5 scored cascade items
Recent — Last 5 completed/failed from ralph_events
JASON-DEPs — Human-blocked items (count + urgency)
Next Moves — Top 3 suggested actions

Definition of Done

[ ] /api/mission-control returns aggregated JSON on port 3002
[ ] Dashboard shows MissionControlPanel on Mission tab
[ ] Active agents section shows Ralph state (10s poll)
[ ] JASON-DEPs count visible without navigation
[ ] Registry health shows stale document count
[ ] Deploy to Vercel succeeds

Key Architecture Decisions

Decision	Choice	Why
Task routing	Skill-based (queue tags)	No SPOF. Queue IS the orchestrator. Workers filter by type.
Agent Teams	NOT used	Designed for interactive use. Doesn't survive session crashes.
Registry sync	Federate via NowPage	Each env owns its registry. NowPage is the read bridge. Don't merge.
Document types	instruction / living / snapshot	Instructions must be current. Living evolves. Snapshots never touch.
Propagation	Rings 0→3	Core first, then dependent, then peripheral, then external.

Key Files

config/document-registry.json — Card catalog (40 docs)
memory/canonical-changelog.md — Pattern spec
Vault/shared/DOCUMENT-FEDERATION.md — Federation protocol
Vault/projects/forge-mission-control/ALIGNMENT.md — Mission Control alignment
context/SESSION-HANDOFF-032826.md — This handoff (local file)

Session: 2026-03-28 | Expires: 2026-04-05 | Source: context/SESSION-HANDOFF-032826.md