LIVING IMPLEMENTATION CHECKLIST — Unified Agent OS

LIVING IMPLEMENTATION CHECKLIST — Unified Agent OS

---

## Phase 0: Governance & Foundation
- [x] 0.1 Project Charter — `PROJECT_CHARTER.md` | Owner: Agent | Confidence: High
- [x] 0.2 System Glossary — `GLOSSARY.md` | Owner: Agent | Confidence: High
- [x] 0.3 Invariants & Assumptions — `INVARIANTS.md` | Owner: Agent | Confidence: High
- [x] 0.4 Implementation Guide — `IMPLEMENTATION_GUIDE.md` | Owner: Agent | Confidence: High
- [x] 0.5 Living Checklist — This file | Owner: Agent | Confidence: High
- [ ] 0.6 Architecture Document — `ARCHITECTURE.md` | Owner: Agent | Confidence: High
- Input: Charter + Glossary + existing Pulse v3/Heartbeat/Dream Weaver code
- Output: System architecture diagram, data flow, component contracts
- Validation: All glossary terms appear; all invariants addressed
- [ ] 0.7 Database Schema Design — `infra/supabase/` | Owner: Agent | Confidence: Medium
- Input: Architecture doc + Glossary
- Output: SQL migrations with RLS policies
- Validation: Multi-tenant queries isolated; all core types have tables
- [ ] 0.8 API Contract (OpenAPI) — `packages/api/openapi.yaml` | Owner: Agent | Confidence: Medium
- Input: Architecture doc + Glossary
- Output: OpenAPI 3.1 spec
- Validation: All user-facing features have endpoints; types match @agentos/core

---

## Phase 1: Core Package & Types
- [ ] 1.1 Initialize monorepo — Turborepo + workspace config
- Output: `turbo.json`, root `package.json`, `tsconfig.base.json`
- Validation: `turbo build` runs clean
- [ ] 1.2 @agentos/core types — Tenant, Session, Agent, Skill, Event types
- Output: `packages/core/src/types/`
- Validation: Compiles strict; all glossary terms have type definitions
- [ ] 1.3 Event system — Typed event definitions + bus interface
- Output: `packages/core/src/events/`
- Validation: Publish/subscribe works; events are serializable
- [ ] 1.4 Constants & enums — Status codes, limits, defaults
- Output: `packages/core/src/constants/`
- Validation: No magic strings in other packages

---

## Phase 2: Engine (Pulse Port)
- [ ] 2.1 Session manager — Create, run, checkpoint, resume, complete
- Input: Existing Pulse v3 session logic
- Output: `packages/engine/src/session/`
- Validation: Session state machine matches spec; multi-tenant safe
- [ ] 2.2 Model router — Multi-provider model routing with fallback
- Output: `packages/engine/src/model/`
- Validation: Supports Anthropic, OpenAI, Google; fails gracefully
- [ ] 2.3 Chain executor — DAG-based multi-session workflows
- Output: `packages/engine/src/chain/`
- Validation: Parallel branches execute; conditional logic works
- [ ] 2.4 Quality gates — Pluggable validation system
- Output: `packages/engine/src/gates/`
- Validation: Build, lint, test gates work; custom gates register
- [ ] 2.5 Rollback manager — Git-based checkpoint recovery
- Output: `packages/engine/src/rollback/`
- Validation: Rollback restores previous state; no data loss
- [ ] 2.6 Cost tracker — Per-session token/cost accounting
- Output: `packages/engine/src/cost/`
- Validation: INV-4 satisfied; cost matches provider usage

---

## Phase 3: Heartbeat Port
- [ ] 3.1 Scheduler — Configurable interval heartbeat system
- Input: Existing Heartbeat v2 logic
- Output: `packages/heartbeat/src/scheduler/`
- Validation: Heartbeats fire on schedule; respect quiet hours
- [ ] 3.2 Pluggable checks — Registry of check functions
- Output: `packages/heartbeat/src/checks/`
- Validation: Custom checks register and execute
- [ ] 3.3 Priority routing — Notification routing by severity
- Output: `packages/heartbeat/src/routing/`
- Validation: P1 bypasses quiet hours; P4 batches

---

## Phase 4: Dream Engine Port
- [ ] 4.1 Garden lifecycle — Spore→Seedling→Sapling→Bloom→Fruit
- Input: Existing Dream Weaver daemon
- Output: `packages/dreams/src/garden/`
- Validation: Growth transitions work; cross-pollination fires
- [ ] 4.2 Evolution engine — Mutation, selection, fitness scoring
- Output: `packages/dreams/src/evolution/`
- Validation: Ideas evolve over time; fitness increases
- [ ] 4.3 Dream→Task compiler — Compile bloomed dreams into Pulse sessions
- Output: `packages/dreams/src/interpreter/`
- Validation: Compiled tasks are valid Pulse session configs

---

## Phase 5: API Layer
- [ ] 5.1 Hono server setup — Routes, middleware, error handling
- Output: `packages/api/src/`
- Validation: Health check responds; CORS configured
- [ ] 5.2 Auth middleware — API key + Supabase JWT validation
- Output: `packages/api/src/middleware/auth.ts`
- Validation: Invalid keys rejected; tenant context injected
- [ ] 5.3 Session routes — CRUD + stream + control
- Output: `packages/api/src/routes/sessions.ts`
- Validation: Matches OpenAPI spec; tenant-scoped
- [ ] 5.4 Heartbeat routes — Config + status + history
- Output: `packages/api/src/routes/heartbeats.ts`
- [ ] 5.5 Dream routes — Garden + evolution + compile
- Output: `packages/api/src/routes/dreams.ts`
- [ ] 5.6 Skill routes — Registry + install + publish
- Output: `packages/api/src/routes/skills.ts`
- [ ] 5.7 WebSocket streaming — Real-time session events
- Output: `packages/api/src/ws/`
- Validation: Clients receive events; reconnection works
- [ ] 5.8 Webhook system — Inbound triggers + outbound notifications
- Output: `packages/api/src/webhooks/`

---

## Phase 6: SDK & CLI
- [ ] 6.1 TypeScript SDK — Client library wrapping API
- Output: `packages/sdk/`
- Validation: All API endpoints accessible; typed responses
- [ ] 6.2 CLI tool — `agentos` command-line interface
- Output: `packages/cli/`
- Validation: `agentos session create`, `agentos heartbeat status`, etc.

---

## Phase 7: Dashboard
- [ ] 7.1 Auth flow — Supabase SSO + org management
- Output: `packages/dashboard/src/app/(auth)/`
- [ ] 7.2 Session dashboard — Live sessions, logs, cost
- Output: `packages/dashboard/src/app/sessions/`
- [ ] 7.3 Dream garden UI — Visual garden with growth indicators
- Output: `packages/dashboard/src/app/dreams/`
- [ ] 7.4 Skill marketplace — Browse, install, publish
- Output: `packages/dashboard/src/app/skills/`
- [ ] 7.5 Billing & usage — Stripe integration, usage charts
- Output: `packages/dashboard/src/app/billing/`

---

## Phase 8: Infrastructure & Launch
- [ ] 8.1 Supabase project — Migrations, RLS, edge functions
- Output: `infra/supabase/`
- [ ] 8.2 Docker images — Per-service Dockerfiles
- Output: `infra/docker/`
- [ ] 8.3 Fly.io deployment — API + engine services
- Output: `infra/fly/`
- [ ] 8.4 CI/CD — GitHub Actions: build, test, deploy
- Output: `.github/workflows/`
- [ ] 8.5 Landing page — Product marketing + signup
- [ ] 8.6 Documentation site — API docs, guides, tutorials

---

## Backlog (Post-Launch)
- [ ] Python SDK
- [ ] Terraform provider
- [ ] SOC 2 compliance
- [ ] Enterprise SSO (SAML)
- [ ] On-premise deployment option
- [ ] Agent-to-agent marketplace
- [ ] Mobile app (agent monitoring)

---

Last Updated: 2026-02-03 | Phase: 0 (in progress)