ck_goal
Create, list, or update durable governed goals to keep long-running intent explicit, citable, and reviewable across sessions. Choose from three modes: record, list, or update_status.
Instructions
Record, list, or update durable governed goals so long-running intent stays explicit, citable, and reviewable across sessions. Three modes: record (write — creates a new goal); list (read-only — returns goals filtered by status and horizon); update_status (write — updates an existing goal's status or progress). Required: session_id and mode. For record: provide goal (the statement text) and optionally title, horizon (task/session/workspace), and tags. For update_status: provide goal_id and the new status. horizon controls scope: task for short-lived intent, session for the current session, workspace for persistent cross-session goals. Use ck_goal for structured multi-session intent that should be explicitly tracked and reviewed. Use ck_memory_record for general decisions or notes not requiring status tracking.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Full content body with detailed information. | |
| goal | No | The goal statement text. | |
| goal_id | No | Unique identifier of an existing goal to update. | |
| horizon | No | Temporal scope of the goal: task, session, or workspace. | |
| limit | No | Maximum number of results to return. | |
| metadata | No | ||
| mode | Yes | Operation mode that determines the tool behavior and return shape. | |
| progress_note | No | Note about progress toward the goal. | |
| session_id | Yes | Unique session identifier for correlating findings, proofs, budget, and audit trail. | |
| source_id | No | Unique identifier of the source system or record. | |
| source_type | No | Origin category of the record (e.g., developer, tool_output, human_review). | |
| status | No | Current status for filtering or updating. | |
| summary | No | Brief human-readable summary of the record. | |
| tags | No | ||
| task_id | No | Task identifier within the session for scoped operations. | |
| title | No | Human-readable title for display and search. |