Zero-Human Control Plane

Agent orchestration control plane for zero-human companies.

This repository is the working codebase for a lightweight platform that ingests GitHub work, normalizes it into internal WorkItem records, dispatches coding runs through runtime adapters, streams execution events to an operator console, and records immutable audit history.

Current Slice

Phase 0 and Phase 1 are implemented in a runnable local slice:

• apps/api: Bun + TypeScript API with typed persistence, GitHub ingestion, orchestration service, codex runtime adapter, SSE run streaming, health endpoints, and audit log endpoints
• apps/web: React + Vite + Tailwind v4 operator console using shadcn-style source components
• packages/shared: shared schemas, types, and payload contracts across frontend and backend

Current thin slice:

GitHub issue -> WorkItem -> codex-cli run -> SSE stream -> audit events

Stack

• Bun workspaces
• TypeScript
• React 19
• Vite
• Tailwind CSS v4
• shadcn-style component composition
• Hono HTTP API
• Zod schemas at runtime boundaries

Commands

bun install
bun run dev
bun run typecheck
bun run test
bun run build
bun run template:check

Docs Map

• Product intent: docs/product-specs/
• Active implementation work: docs/exec-plans/active/
• Architecture boundaries: docs/ARCHITECTURE.md
• Operating principles: docs/core-beliefs.md
• Observability contract: docs/observability.md
• Quality baseline: docs/quality-score.md

Roadmap

The north star remains a full orchestration platform with these domains:

• company
• goal
• work
• agent
• runtime
• session
• memory
• orchestration
• governance
• integration

The current implementation intentionally ships the first thin slice rather than the whole platform at once.