ck_task
Manage governed tasks within a session: retrieve status, claim, complete, send heartbeat, log quality checks, or submit reports.
Instructions
Manage governed tasks within a session. Six modes: status (return task details for a given task_id); claim (claim an available task for execution); complete (mark a task as done, blocked if unresolved findings exist); heartbeat (signal the agent is alive and working on a task); checks (record task quality check results); report (submit a task report with output and metadata).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Operation mode that determines the tool behavior and return shape. | |
| note | No | Freeform note for heartbeat mode. | |
| checks | No | Array of check result objects for checks mode. | |
| output | No | Structured output payload for report mode. | |
| status | No | Target status for report mode (e.g., done, failed, blocked). | |
| task_id | No | Task identifier within the session for scoped operations. | |
| metadata | No | Arbitrary key-value metadata for report mode. | |
| progress | No | Progress indicator for heartbeat mode. | |
| session_id | Yes | Unique session identifier for correlating findings, proofs, budget, and audit trail. | |
| project_root | No | Absolute path to project root. | |
| execution_mode | No | Execution mode for claim (e.g., local, external). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| title | No | ||
| run_id | No | ||
| status | No | ||
| claimed | No | ||
| results | No | ||
| task_id | No | ||
| recorded | No | ||
| reported | No | ||
| completed | No | ||
| risk_tier | No | ||
| session_id | No |