T25 — System architecture

T25 — System architecture An architecture diagram generated by Archify. Users · browser · Architecture component Users browser Landing Page · static site/ · Architecture component Landing Page static site/ Cockpit · web/ · React · Architecture component Cockpit web/ · React Multi-role pipeline · src/pipeline/ · Node/TypeScript services (src/) Multi-role pipeline src/pipeline/ CLI adapters · Claude · Codex · Grok… · Node/TypeScript services (src/) CLI adapters Claude · Codex · Grok… API Hono · src/server/ · Hono · Node/TypeScript services (src/) · REST + OAuth API Hono src/server/ · Hono REST + OAuth MCP server · stdio · 54 tools · Node/TypeScript services (src/) MCP server stdio · 54 tools T25Service · src/t25/ · Node/TypeScript services (src/) T25Service src/t25/ Lease queue · Postgres · SKIP LOCKED · Node/TypeScript services (src/) Lease queue Postgres · SKIP LOCKED GitHub · branch · PR · issues · Architecture component GitHub branch · PR · issues Control Plane · Postgres · control_plane · Node/TypeScript services (src/) Control Plane Postgres · control_plane Remote worker · runner_local · worktree · Isolated execution · src/server/worker-routes · HMAC Remote worker runner_local · worktree HMAC HTTPS delegates scoped API key roles + gates uses CLIs queues state + plan digest lease + heartbeat opens PR merge lease remoto Node/TypeScript services (src/) Isolated execution · src/server/worker-routes Legend Frontend Backend Database Security External

Surfaces

  • • cockpit → API /api/v1
  • • MCP: 54 tools (read/operate/approve/admin); the API validates capability
  • • plan + digest + LOCAL_APPROVED

Orchestration

  • • tasks, policies, merge
  • • Postgres leases → remote worker

State and security

  • • Postgres control plane
  • • worker + Docker · HMAC