update_ctlsurf_task_item
Update a ctlsurf_task item. Use to add progress notes, mark complete, or reopen with feedback.
Examples:
Add progress note: update_ctlsurf_task_item(block_id, item_id, notes=["Implemented login endpoint"])
Mark complete with structured completion (REQUIRED when done=true): update_ctlsurf_task_item( block_id="...", item_id="...", done=true, completion={ "summary": "Implemented user authentication with JWT", "assumptions": ["Database schema already supports user sessions"], "attempted_but_failed": ["Tried OAuth but API rate limited"], "simplified_or_skipped": [] } )
Reopen a completed task with feedback: update_ctlsurf_task_item( block_id="...", item_id="...", done=false, reopen_feedback="Please implement the rate limiting properly, don't skip it" )
Attach skill: update_ctlsurf_task_item(block_id, item_id, skill_id="")
IMPORTANT: When marking done=true, the completion object is REQUIRED with structured documentation of what was done, assumptions made, and any simplifications.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| done | No | Set to true to mark complete (requires completion object), or false to reopen | |
| text | No | Update the task description | |
| notes | No | Notes about the task (for progress updates, not completion) | |
| item_id | Yes | The ID of the task item (from get_pending_agent_tasks) | |
| block_id | Yes | The UUID of the ctlsurf_task block | |
| skill_id | No | Skill/playbook ID to attach (use null to remove) | |
| completion | No | REQUIRED when done=true. Structured completion data documenting what was done. | |
| reopen_feedback | No | Feedback when reopening a completed task (e.g., 'Don't skip the rate limiting') |