Complete a task
taskhold_completeMark a task or step done, with a summary of what you did and, optionally, a structured outcome: files changed (with +/- line counts), checks run (pass/fail/skip), links (PR, commit, branch, deploy, doc), follow-up task ids, risks and how the person can verify it. The person sees it as a What changed card; a step's outcome rolls up to its task. When the person should look at the work, pass needs_review: true with outcome.verify (how you checked it): the task lands in their Ready for review queue. Completing a step tells you the next one; start_next: true also starts it, and finish_task: true on the last open step closes the task too (with the same summary) in one call. For a step it returns steps done, the task's bar and the next step's id (or, after the last step, a reminder to complete the task). Completing a task closes its open steps. Repeating it on a task that is already done changes nothing and keeps the first summary (add more with taskhold_add_note); an unknown task_id fails with "Task not found", an invalid outcome fails without changing anything.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task_id": "<task_id>"
},
"name": "taskhold_complete"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| outcome | No | What changed, shown to the person as a What changed card (20 KB max). Every field is optional. | |
| summary | No | What was done (and how you checked it). Markdown. | |
| task_id | Yes | The ID of the task to complete | |
| start_next | No | When completing a step, start the next step too (default false) | |
| finish_task | No | When completing the last open step, also complete its task with this summary (default false) | |
| needs_review | No | Ask the person to review the work: the task goes to their Ready for review queue (it still counts as done). Needs outcome.verify, a short "how I checked it" line. They approve it or request changes; both arrive in taskhold_updates (default false) |