docs(12-04): complete Plan & Task tRPC procedures plan

Tasks completed: 3/3
- Add PlanRepository to tRPC context
- Add Plan tRPC procedures (CRUD)
- Add createTasksFromDecomposition procedure

SUMMARY: .planning/phases/12-phase-task-decomposition/12-04-SUMMARY.md

.planning/STATE.md

@@ -10,11 +10,11 @@ See: .planning/PROJECT.md (updated 2026-01-31)
 ## Current Position
 
 Phase: 12 of 13 (Phase Task Decomposition)
-Plan: 3 of 8 in current phase
+Plan: 4 of 8 in current phase
 Status: In progress
-Last activity: 2026-02-01 — Completed 12-03-PLAN.md
+Last activity: 2026-02-01 — Completed 12-04-PLAN.md
 
-Progress: ██████░░░░ 59%
+Progress: ██████░░░░ 61%
 
 ## Performance Metrics
 
@@ -150,6 +150,8 @@ Recent decisions affecting current work:
 - 12-02: getNextNumber uses max() aggregate, returning 1 if no plans exist (same pattern as PhaseRepository)
 - 12-03: Task execution order adjusted - Task 3 first since Tasks 1-2 depend on AgentStoppedEvent reason type
 - 12-03: handleDecomposeOutput follows exact structure of handleBreakdownOutput for pattern consistency
+- 12-04: Extended TaskRepository with createDependency for hexagonal architecture compliance
+- 12-04: createTasksFromDecomposition maps task numbers to IDs for dependency creation
 
 ### Pending Todos
 
@@ -170,5 +172,5 @@ None.
 ## Session Continuity
 
 Last session: 2026-02-01
-Stopped at: Completed 12-03-PLAN.md (Agent Manager Decompose Mode)
+Stopped at: Completed 12-04-PLAN.md (Plan & Task tRPC Procedures)
 Resume file: None

.planning/phases/12-phase-task-decomposition/12-04-SUMMARY.md

@@ -0,0 +1,117 @@
+---
+phase: 12-phase-task-decomposition
+plan: 04
+subsystem: api
+tags: [trpc, plan, task, bulk-create, dependencies, repository]
+
+# Dependency graph
+requires:
+  - phase: 12-02
+    provides: PlanRepository.getNextNumber, PlanRepository.findByPhaseId
+  - phase: 11-04
+    provides: tRPC procedure patterns, Initiative/Phase CRUD
+provides:
+  - PlanRepository in tRPC context
+  - Plan CRUD tRPC procedures (createPlan, listPlans, getPlan, updatePlan)
+  - createTasksFromDecomposition bulk task creation procedure
+  - TaskRepository.createDependency method
+affects: [decompose-agent, cli-commands, task-workflow]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - Bulk entity creation with dependency mapping
+    - Number-to-ID mapping for reference resolution
+
+key-files:
+  created: []
+  modified:
+    - src/trpc/context.ts
+    - src/trpc/router.ts
+    - src/db/repositories/task-repository.ts
+    - src/db/repositories/drizzle/task.ts
+
+key-decisions:
+  - "Extended TaskRepository with createDependency method for hexagonal architecture compliance"
+  - "createTasksFromDecomposition maps task numbers to IDs for dependency creation"
+
+# Metrics
+duration: 4min
+completed: 2026-02-01
+---
+
+# Phase 12 Plan 04: Plan & Task tRPC Procedures Summary
+
+**Added tRPC procedures for Plan CRUD and bulk task creation from decomposition agent output with dependency mapping**
+
+## Performance
+
+- **Duration:** 4 min
+- **Started:** 2026-02-01T10:43:59Z
+- **Completed:** 2026-02-01T10:47:30Z
+- **Tasks:** 3
+- **Files modified:** 4
+
+## Accomplishments
+
+- Added PlanRepository to tRPC context with optional injection
+- Implemented Plan CRUD procedures: createPlan (with auto-number), listPlans, getPlan, updatePlan
+- Added createTasksFromDecomposition procedure for bulk task creation from decompose agent output
+- Extended TaskRepository interface with createDependency method for task dependencies
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Add PlanRepository to tRPC context** - `c98e9df` (feat)
+2. **Task 2: Add Plan tRPC procedures** - `6127445` (feat)
+3. **Task 3: Add createTasksFromDecomposition procedure** - `66ad2ec` (feat)
+
+## Files Created/Modified
+
+- `src/trpc/context.ts` - Added PlanRepository type to context
+- `src/trpc/router.ts` - Added Plan CRUD procedures and createTasksFromDecomposition
+- `src/db/repositories/task-repository.ts` - Added createDependency method to interface
+- `src/db/repositories/drizzle/task.ts` - Implemented createDependency in Drizzle adapter
+
+## Decisions Made
+
+1. **Extended TaskRepository with createDependency** - Required for createTasksFromDecomposition to create task dependencies while maintaining hexagonal architecture (repositories as ports, not direct DB access in tRPC layer)
+2. **Number-to-ID mapping for dependencies** - Decomposition output uses task numbers (1, 2, 3...) for dependencies, which get mapped to actual task IDs after creation
+
+## Deviations from Plan
+
+### Auto-fixed Issues
+
+**1. [Rule 3 - Blocking] Added createDependency to TaskRepository**
+- **Found during:** Task 3 (createTasksFromDecomposition implementation)
+- **Issue:** Plan required creating task_dependencies after tasks, but TaskRepository had no method for this
+- **Fix:** Added createDependency(taskId, dependsOnTaskId) to TaskRepository interface and DrizzleTaskRepository
+- **Files modified:** src/db/repositories/task-repository.ts, src/db/repositories/drizzle/task.ts
+- **Verification:** Build passes, all 402 tests pass
+- **Committed in:** 66ad2ec (Task 3 commit)
+
+---
+
+**Total deviations:** 1 (blocking - needed createDependency method)
+**Impact on plan:** Essential addition for dependency creation. Maintains hexagonal architecture. No scope creep.
+
+## Issues Encountered
+
+None - all procedures implemented successfully, all 402 tests pass.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- Full Plan and Task tRPC layer ready for CLI
+- createPlan, listPlans, getPlan, updatePlan available
+- createTasksFromDecomposition handles bulk task creation with dependencies
+- Ready for 12-05-PLAN.md (Decompose Agent Handler)
+
+---
+*Phase: 12-phase-task-decomposition*
+*Completed: 2026-02-01*