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 · 52 tools · Node/TypeScript services (src/) MCP server stdio · 52 tools FactoryService · src/factory/ · Node/TypeScript services (src/) FactoryService src/factory/ 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 or memory · Node/TypeScript services (src/) Control Plane Postgres or memory Remote worker · worktree + Docker · Isolated execution · src/server/worker-routes · HMAC Remote worker worktree + Docker HMAC HTTPS delegates scoped API key roles + gates uses CLIs queues state + events lease + heartbeat opens PR merge remote lease Node/TypeScript services (src/) Isolated execution · src/server/worker-routes Legend Frontend Backend Database Security External

Surfaces

  • • web/ cockpit consumes the Hono API through /api/v1
  • • MCP: 52 tools (read/operate/approve/admin); the API validates capability

Orchestration

  • • FactoryService coordinates tasks, policies and merge
  • • Leases in Postgres; the remote worker executes in the worktree

State and security

  • • Control Plane persists in Postgres (or memory)
  • • Remote worker: worktree + Docker, HMAC auth