docs(02-01): complete SQLite database setup plan

Tasks completed: 3/3
- Install Drizzle ORM and SQLite dependencies
- Create database connection factory
- Define task hierarchy schema

SUMMARY: .planning/phases/02-data-layer/02-01-SUMMARY.md

.planning/ROADMAP.md

@@ -64,10 +64,11 @@ Plans:
 **Depends on**: Phase 1
 **Requirements**: TASK-02, TASK-03
 **Research**: Unlikely (Drizzle/SQLite well-documented)
-**Plans**: TBD
+**Plans**: 2 plans
 
 Plans:
-- [ ] 02-01: TBD
+- [x] 02-01: SQLite Database Setup
+- [ ] 02-02: Repository Layer
 
 ### Phase 3: Git Integration
 **Goal**: Git worktree management — create isolated worktrees per agent, preview diffs, integrate changes, cleanup
@@ -135,7 +136,7 @@ Phases execute in numeric order: 1 → 1.1 → 2 → 3 → 4 → 5 → 6 → 7
 |-------|----------------|--------|-----------|
 | 1. Core Infrastructure | 5/5 | Complete | 2026-01-30 |
 | 1.1. Hexagonal Architecture | 6/6 | Complete | 2026-01-30 |
-| 2. Data Layer | 0/? | Not started | - |
+| 2. Data Layer | 1/2 | In progress | - |
 | 3. Git Integration | 0/? | Not started | - |
 | 4. Agent Lifecycle | 0/? | Not started | - |
 | 5. Task Dispatch | 0/? | Not started | - |

.planning/STATE.md

@@ -5,33 +5,34 @@
 See: .planning/PROJECT.md (updated 2026-01-30)
 
 **Core value:** Coordinate multiple Claude Code agents without losing track or stepping on each other.
-**Current focus:** Phase 1.1 — Hexagonal Architecture (INSERTED)
+**Current focus:** Phase 2 — Data Layer
 
 ## Current Position
 
-Phase: 1.1 of 8 (Hexagonal Architecture - INSERTED)
-Plan: 6 of 6 in current phase
-Status: Phase complete
-Last activity: 2026-01-30 — Completed 01.1-06-PLAN.md
+Phase: 2 of 8 (Data Layer)
+Plan: 1 of ? in current phase
+Status: In progress
+Last activity: 2026-01-30 — Completed 02-01-PLAN.md
 
-Progress: ██████████████ 100%
+Progress: ██████████████░░ 90%
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 9
+- Total plans completed: 12
 - Average duration: 3 min
-- Total execution time: 30 min
+- Total execution time: 33 min
 
 **By Phase:**
 
 | Phase | Plans | Total | Avg/Plan |
 |-------|-------|-------|----------|
 | 1 | 5/5 | 15 min | 3 min |
-| 1.1 | 4/6 | 15 min | 4 min |
+| 1.1 | 6/6 | 15 min | 3 min |
+| 2 | 1/? | 3 min | 3 min |
 
 **Recent Trend:**
-- Last 5 plans: 01-05 (7 min), 01.1-01 (3 min), 01.1-02 (6 min), 01.1-05 (2 min), 01.1-06 (4 min)
+- Last 5 plans: 01.1-02 (6 min), 01.1-05 (2 min), 01.1-06 (4 min), 02-01 (3 min)
 - Trend: Steady
 
 ## Accumulated Context
@@ -51,6 +52,9 @@ Recent decisions affecting current work:
 - 01.1-04: EventBus is optional parameter for backwards compatibility in logging
 - 01.1-05: Optional eventBus injection for server lifecycle events
 - 01.1-06: Use @trpc/server/adapters/fetch for HTTP handling, keep HTTP endpoints for curl
+- 02-01: Factory function for database (not singleton) allows isolated test instances
+- 02-01: WAL mode enabled for better concurrent read performance
+- 02-01: Separate task_dependencies table for many-to-many task relationships
 
 ### Pending Todos
 
@@ -69,5 +73,5 @@ None yet.
 ## Session Continuity
 
 Last session: 2026-01-30
-Stopped at: Completed 01.1-06-PLAN.md (CLI-tRPC Integration) - Phase 1.1 complete
+Stopped at: Completed 02-01-PLAN.md (SQLite Database Setup)
 Resume file: None

.planning/phases/02-data-layer/02-01-SUMMARY.md

@@ -0,0 +1,114 @@
+---
+phase: 02-data-layer
+plan: 01
+subsystem: database
+tags: [drizzle, sqlite, better-sqlite3, orm, schema]
+
+# Dependency graph
+requires:
+  - phase: 01
+    provides: Core infrastructure (CLI, server, process management)
+provides:
+  - SQLite database connection factory
+  - Task hierarchy schema (initiative -> phase -> plan -> task)
+  - Drizzle ORM types for all entities
+  - Task dependency relationship table
+affects: [03-git-integration, 04-agent-lifecycle, 05-task-dispatch]
+
+# Tech tracking
+tech-stack:
+  added: [drizzle-orm, better-sqlite3, drizzle-kit]
+  patterns: [factory-function-not-singleton, wal-mode, foreign-key-cascades]
+
+key-files:
+  created:
+    - src/db/config.ts
+    - src/db/index.ts
+    - src/db/schema.ts
+    - drizzle.config.ts
+  modified:
+    - package.json
+
+key-decisions:
+  - "Factory function (not singleton) for database - allows isolated test instances"
+  - "WAL mode enabled for better concurrent read performance"
+  - "Foreign keys enabled with cascade deletes for data integrity"
+  - "Unix timestamps (integers) for SQLite compatibility"
+  - "Separate task_dependencies table for many-to-many task relationships"
+
+patterns-established:
+  - "Database factory: createDatabase(path?) returns isolated instance"
+  - "Schema organization: tables + relations + types in schema.ts"
+  - "Environment override: CW_DB_PATH for testing with :memory:"
+
+# Metrics
+duration: 3min
+completed: 2026-01-30
+---
+
+# Phase 2 Plan 1: SQLite Database Setup Summary
+
+**SQLite database with Drizzle ORM and four-level task hierarchy schema (initiative -> phase -> plan -> task)**
+
+## Performance
+
+- **Duration:** 3 min
+- **Started:** 2026-01-30T13:22:12Z
+- **Completed:** 2026-01-30T13:24:59Z
+- **Tasks:** 3
+- **Files modified:** 5
+
+## Accomplishments
+
+- Installed Drizzle ORM with better-sqlite3 driver for synchronous SQLite operations
+- Created database connection factory with WAL mode and foreign key enforcement
+- Defined complete task hierarchy schema with proper cascade delete relationships
+- Exported TypeScript types for all entities (Initiative, Phase, Plan, Task, TaskDependency)
+- Configured drizzle-kit for future migration support
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Install Drizzle ORM and SQLite dependencies** - `caf8bb0` (chore)
+2. **Task 2: Create database connection factory** - `d7e4649` (feat)
+3. **Task 3: Define task hierarchy schema** - `b492f64` (feat)
+
+## Files Created/Modified
+
+- `src/db/config.ts` - Database path resolution with CW_DB_PATH override
+- `src/db/index.ts` - createDatabase() factory function with WAL mode
+- `src/db/schema.ts` - Complete schema with 5 tables and relations
+- `drizzle.config.ts` - Drizzle Kit configuration for migrations
+- `package.json` - Added drizzle-orm, better-sqlite3, drizzle-kit dependencies
+
+## Decisions Made
+
+- **Factory over singleton:** createDatabase() returns new instance each call, enabling isolated test databases
+- **WAL mode:** Enabled for better concurrent read performance in local-first app
+- **Foreign keys on:** SQLite has FK disabled by default, enabled for data integrity
+- **Unix timestamps:** Used integer timestamps for SQLite compatibility vs Date objects
+- **Separate dependencies table:** task_dependencies junction table instead of JSON array for proper relational queries
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- Database foundation complete for repository layer implementation
+- Schema ready for CRUD operations in Phase 2 Plan 2
+- Types exported for use throughout codebase
+- No blockers for continuing
+
+---
+*Phase: 02-data-layer*
+*Completed: 2026-01-30*