Skip to main content

Module force

Module force 

Source
Expand description

keel flows force <FLOW> — arm the durable one-shot KEEL-E033 force override (CCR-5 decision 2 / CCR-6) for one flow.

keel exec --force is an in-memory, per-invocation flag: it only helps an operator who is at the terminal re-running the command themselves. In- process cmd: interception (issue #27) and stuck flows whose host already exited have no such surface — the next re-dispatch happens somewhere the --force flag can’t reach. This verb is the out-of-process, config-free escape hatch: it persists a marker step (via exec::request_force_override) so the next re-dispatch that would otherwise be KEEL-E033-refused (its declared side-effect files changed since the last attempt) proceeds exactly once, then clears itself.

Only a running/failed flow is ever gated by KEEL-E033 (exec::side_effect_gate checks no other status), so forcing a completed or dead flow would arm a no-op; those are refused with a precise what/why/next instead, mirroring crate::resume’s eligibility UX.

Functions§

run
keel flows force <FLOW> for project: resolve <FLOW> to exactly one flow and arm its durable one-shot KEEL-E033 override.