fow_run
Records implementation runs with ordered dependent steps, tracking started, completed, blocked, and cancelled states to monitor execution and dependencies.
Instructions
Track who performs the implementation work: record a run, ordered dependent steps and their started/completed/blocked/cancelled states. The coding agent performs those actions outside Flower. Route with operation: create_run, get_run, add_step, link_step_dependency, start_step, complete_step, block_step, cancel_step, complete_run, cancel_run, task_view. Prerequisites: Use a governed change/packet and existing run/step IDs where requested. Effects: Records implementation-run steps, dependencies and execution outcomes; cancellation changes live authority. Flower does not execute the declared step actions. Exact help (replace operation_name with the selected route): fow_capabilities({"view":"operation","operation_tool":"fow_run","operation_name":"create_run"}).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | Yes | Identity of the human or agent recording this action; retain the original identity when replaying its request. | |
| title | No | Short human-readable title of the authored requirement, finding, packet, run step or campaign. Applies to: add_step. Required by: add_step. | |
| action | No | Bounded instruction describing what this implementation-run step will do. Applies to: add_step. Required by: add_step. | |
| reason | No | Explicit reason for the transition, cancellation or continuation action. Applies to: cancel_step, cancel_run. Required by: cancel_step, cancel_run. | |
| run_id | No | Existing implementation-run identity returned by create_run. Applies to: get_run, add_step, link_step_dependency, start_step, complete_step, block_step, cancel_step, complete_run, cancel_run, task_view. Required by: get_run, add_step, link_step_dependency, start_step, complete_step, block_step, cancel_step, complete_run, cancel_run, task_view. | |
| step_id | No | Existing implementation-run step identity. Applies to: link_step_dependency, start_step, complete_step, block_step, cancel_step. Required by: link_step_dependency, start_step, complete_step, block_step, cancel_step. | |
| change_id | No | Canonical owning change ID; when address resolution permits omission, the packet/campaign must resolve unambiguously. | |
| objective | No | Observable objective of the use case or implementation run. Applies to: create_run. Required by: create_run. | |
| operation | Yes | Operation selector for this multiplexer; use a canonical route listed below. Canonical values: create_run, get_run, add_step, link_step_dependency, start_step, complete_step, block_step, cancel_step, complete_run, cancel_run, task_view. | |
| packet_id | No | Canonical packet identity returned by authoring; it identifies the bounded implementation work. | |
| project_id | Yes | Canonical lifecycle project ID. Select the existing project explicitly; development Markdown authorities are separate from runtime projects. | |
| request_id | No | Caller-owned retry identity. For receipted mutations replay the same actor and contents; changed contents can conflict. Inspect exact operation help for its receipt policy. | |
| source_ref | No | Declared source-authority reference attached to the implementation run. Applies to: create_run. | |
| target_refs | No | Explicit implementation/source targets for this bounded run step. Applies to: add_step. | |
| external_ref | No | Declared external execution/reference identity attached to the implementation run. Applies to: create_run. | |
| evidence_refs | No | References to actual supporting evidence; host-declared provenance remains host-declared. Applies to: add_step, complete_step. Required by: complete_step. | |
| step_required | No | Whether completion of this implementation-run step is required for the run to complete. Applies to: add_step. | |
| blocking_reason | No | Concrete reason the implementation-run step cannot advance. Applies to: block_step. Required by: block_step. | |
| orchestrator_ref | No | Identity/reference of the orchestrator responsible for this implementation run. Applies to: create_run. | |
| depends_on_step_id | No | Existing predecessor run-step ID that must complete before the selected step can start. Applies to: link_step_dependency. Required by: link_step_dependency. | |
| completion_reference | No | Reference to the actual evidence/authority supporting completion of this lifecycle object. Applies to: complete_run. Required by: complete_run. | |
| next_expected_action | No | Concrete next action required to unblock or continue this implementation-run step. Applies to: block_step. Required by: block_step. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||