unblock_story
Unblocks a parked story by clearing retry or review fields, recording the manual intervention, and optionally updating status, files, or instructions under the plan lock.
Instructions
Unblock a parked story, recording the manual intervention.
Authorized like set_story_status (the plan's owner or a delegate; anyone
else is refused). Clears the named retry/review fields, optionally sets
status and appends add_files to the story's files, exactly as
python -m pipeline.unpark does, and records the caller as the human
action. All of it happens under the plan lock.
plan_name / story_key: the parked story. clear_fields: names to delete; only the retry counters and review records in pipeline.unpark.UNPARKABLE_FIELDS are accepted. status: one of the statuses the pipeline assigns (default: unchanged). add_files: repo-relative production paths (no leading '/', no backslash, no NUL, no '..') appended to the story's files. note: up to 8000 characters appended to the story's agent_instructions. It is written together with the unblock notice, or not at all.
Changing the brief or files resets the plan's approval exactly as
patch_story does; the result says so with approval_reset. A refused
value is never echoed. If the plan lock is busy the result carries
skipped: "locked" and retry_after_seconds: call again.
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": {
"plan_name": "<plan_name>",
"story_key": "<story_key>",
"clear_fields": "<clear_fields>"
},
"name": "unblock_story"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| status | No | ||
| add_files | No | ||
| plan_name | Yes | ||
| story_key | Yes | ||
| clear_fields | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||