goal_update

Update a goal’s status. Mark in_progress when started, blocked when waiting on the user or an approval, done when the user-facing result was delivered. Done and cancelled goals stop the auto-continue chain.

User guide / All capabilities

Contract

Effect: read. Evidence role: discovery_only.

Update a goal’s status (open/in_progress/blocked/done/cancelled).

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "seq": {
      "type": "number",
      "description": "Goal sequence number from goal_open."
    },
    "status": {
      "type": "string",
      "description": "New status: open, in_progress, blocked, done, or cancelled."
    },
    "body": {
      "type": "string",
      "description": "Optional replacement body when the task was reframed."
    }
  },
  "required": [
    "seq",
    "status"
  ]
}

Execution requirements

The ordinary admission and tool execution checks apply.

Expected postconditions

• goal row updated when it existed