docs(05-02): complete task visibility plan

Tasks completed: 2/2
- Add task tRPC procedures (listTasks, getTask, updateTaskStatus)
- Add task CLI commands (list, get, status)

SUMMARY: .planning/phases/05-task-dispatch/05-02-SUMMARY.md

.planning/STATE.md

@@ -10,18 +10,18 @@ See: .planning/PROJECT.md (updated 2026-01-30)
 ## Current Position
 
 Phase: 5 of 8 (Task Dispatch)
-Plan: 3 of 5 in current phase
+Plan: 2 of 5 in current phase (05-02, 05-03 complete)
 Status: In progress
-Last activity: 2026-01-30 — Completed 05-03-PLAN.md
+Last activity: 2026-01-30 — Completed 05-02-PLAN.md
 
 Progress: ████████░░ 80%
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 20
+- Total plans completed: 21
 - Average duration: 3 min
-- Total execution time: 60 min
+- Total execution time: 63 min
 
 **By Phase:**
 
@@ -32,10 +32,10 @@ Progress: ████████░░ 80%
 | 2 | 2/2 | 8 min | 4 min |
 | 3 | 2/2 | 7 min | 4 min |
 | 4 | 4/4 | 12 min | 3 min |
-| 5 | 1/5 | 3 min | 3 min |
+| 5 | 2/5 | 6 min | 3 min |
 
 **Recent Trend:**
-- Last 5 plans: 04-02 (2 min), 04-03 (4 min), 04-04 (3 min), 05-03 (3 min)
+- Last 5 plans: 04-03 (4 min), 04-04 (3 min), 05-03 (3 min), 05-02 (3 min)
 - Trend: Steady
 
 ## Accumulated Context
@@ -82,6 +82,9 @@ Recent decisions affecting current work:
 - 05-03: DispatchManager as PORT interface following hexagonal pattern
 - 05-03: QueuedTask includes dependsOn array for dependency tracking
 - 05-03: Four dispatch events mirror agent lifecycle events
+- 05-02: TaskRepository optional in tRPC context (same pattern as AgentManager)
+- 05-02: listTasks requires planId (no global task listing)
+- 05-02: Task status limited to: pending, in_progress, completed, blocked
 
 ### Pending Todos
 
@@ -100,5 +103,5 @@ None yet.
 ## Session Continuity
 
 Last session: 2026-01-30
-Stopped at: Completed 05-03-PLAN.md — DispatchManager Port Interface
+Stopped at: Completed 05-02-PLAN.md — Task Visibility (tRPC + CLI)
 Resume file: None

.planning/phases/05-task-dispatch/05-02-SUMMARY.md

@@ -0,0 +1,106 @@
+---
+phase: 05-task-dispatch
+plan: 02
+subsystem: api
+tags: [trpc, cli, tasks, crud]
+
+# Dependency graph
+requires:
+  - phase: 02-persistence
+    provides: TaskRepository interface and Drizzle implementation
+  - phase: 04-agent-lifecycle
+    provides: tRPC router patterns and context structure
+provides:
+  - listTasks tRPC procedure (query tasks by plan)
+  - getTask tRPC procedure (get task by ID)
+  - updateTaskStatus tRPC procedure (update status)
+  - CLI task commands (list, get, status)
+affects: [05-task-dispatch, future-task-assignment]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - TaskRepository optional in tRPC context (same as AgentManager)
+    - requireTaskRepository helper for context validation
+
+key-files:
+  created: []
+  modified:
+    - src/trpc/context.ts
+    - src/trpc/router.ts
+    - src/cli/index.ts
+
+key-decisions:
+  - "Require planId for listTasks (no global task listing)"
+  - "Status update limited to 4 states: pending, in_progress, completed, blocked"
+
+patterns-established:
+  - "Task CLI commands follow agent command patterns"
+
+# Metrics
+duration: 3min
+completed: 2026-01-30
+---
+
+# Phase 5 Plan 2: Task Visibility Summary
+
+**tRPC task procedures (listTasks, getTask, updateTaskStatus) and CLI commands (list, get, status) for task visibility**
+
+## Performance
+
+- **Duration:** 3 min
+- **Started:** 2026-01-30T14:32:03Z
+- **Completed:** 2026-01-30T14:35:32Z
+- **Tasks:** 2
+- **Files modified:** 3
+
+## Accomplishments
+
+- TaskRepository added to tRPC context (optional, same pattern as AgentManager)
+- listTasks procedure queries tasks by planId, ordered by order field
+- getTask procedure retrieves single task by ID (throws NOT_FOUND if missing)
+- updateTaskStatus mutation updates task status with validation
+- CLI `cw task list --plan <planId>` shows tasks with status summary
+- CLI `cw task get <taskId>` displays full task details
+- CLI `cw task status <taskId> <status>` updates task status
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Add task tRPC procedures** - `9f24c1f` (feat)
+2. **Task 2: Add task CLI commands** - `586f7ca` (feat)
+
+## Files Created/Modified
+
+- `src/trpc/context.ts` - Added TaskRepository to TRPCContext and CreateContextOptions
+- `src/trpc/router.ts` - Added listTasks, getTask, updateTaskStatus procedures and requireTaskRepository helper
+- `src/cli/index.ts` - Replaced placeholder task command with list, get, status subcommands
+
+## Decisions Made
+
+- **Require planId for listTasks**: Users query tasks by plan rather than global listing. Simplifies queries and matches typical workflow.
+- **Status enum limited to 4 values**: pending, in_progress, completed, blocked - matching common task lifecycle states.
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- Task visibility complete via tRPC and CLI
+- Ready for 05-03 (message passing) or dependent plans
+- Note: pre-existing message.test.ts failures unrelated to this plan (message table not yet migrated)
+
+---
+*Phase: 05-task-dispatch*
+*Completed: 2026-01-30*