/kbd-cancel
Cancel the active run as an explicit terminal operator action.
Progress Signals (MANDATORY)
Before cancellation, emit:
Starting kbd-cancel — <phase-name>
After durable cancellation, emit:
Completed kbd-cancel — <phase-name> cancelled
Procedure
- Require a non-empty cancellation reason.
- If this project's own runtime CLI is available, run its cancel command with the reason.
- Otherwise, create
.kbd-orchestrator/PAUSEfirst and atomically set the waypoint status tocancelled(vialib/platform/atomic-write.mjs'satomicWrite), recording the prior status, reason, actor, and timestamp. Before writing, callassertProjectionWritable(root, target)fromlib/kbd/runtime-authority.mjs— it throws when the waypoint is runtime-authoritative (generatedBy === 'kbd-runtime'), which is exactly the case where a direct write here would be wrong. - Preserve all checkpoints and dirty-work metadata.
- Invoke a host-native cancel operation when the harness exposes one.
Cancellation is terminal. Resuming it requires a new run, never an in-place status edit.