TaskPlan

Complete AI-generated execution plan for a workstream task. Generated before task execution to provide transparency about what the AI will do. Stored in task.plan_summary for audit trail.

Field	Type	Description
`task_id`required	`string (uuid)`	Task UUID this plan belongs to
`cycle_id`required	`string (uuid)`	Parent cycle UUID
`step_id`required	`string`	Blueprint step ID this task corresponds to
`task_name`required	`string`	Human-readable task name
`summary`required	`string`	High-level summary of what this task will accomplish
`steps`required	`PlanStep[]`	Ordered list of execution steps item shape PlanStep
`total_estimated_duration_seconds`	`integer \| null`	Total estimated duration for all steps combined
`write_operation_count`	`integer`	Number of steps that perform write operations
`high_risk_step_count`	`integer`	Number of steps classified as high risk
`requires_approval`	`boolean`	Whether this task requires user approval before execution
`approval_reason`	`string \| null`	Explanation of why approval is required (if applicable)
`context_used`	`string[]`	List of context sources used to generate this plan
`generated_at`required	`string (date-time)`	Timestamp when this plan was generated
`model_version`	`string`	AI model version used to generate this plan