Refine Hub
Refine 4.3.2
Design intent / Application / Workflow

Cancelled

Key Ideas

  • Intentionally Stopped: cancelled means work should not continue.
  • Monotonic Intent: cancellation is committed on the Goal before local cleanup.
  • Explicit Reopening: moving a cancelled Goal to todo supersedes the cancelled attempt and permits a replacement attempt.
  • Preserved Context: Goal, Round, process, and reachable Git evidence remain inspectable.

Purpose

Cancelled intentionally stops work without pretending it succeeded or failed accidentally. A Goal may be irrelevant, duplicate, unsafe, out of scope, or superseded.

Expected Role

Single and bulk cancellation use the same Goal capability. Each Goal is changed to cancelled and read back independently. Refine then attempts to stop matching local processes as best-effort cleanup and reports any failures without rolling the Goal back.

A stale worker cannot transition a cancelled Goal. Governance cancellation before integration prevents its first Git side effect; cancellation after integration begins remains terminal while integration may finish and preserve exact evidence. Cancellation itself never deletes history, branches, or worktrees. Separate retention-delayed maintenance may later hibernate a safe checkout or retire an exact local or upstream round-ref name only when its tip is proven reachable from the unchanged configured remote merge target. The Goal, Round, process records, and target-reachable commit remain inspectable.

Undo and shared bulk movement may explicitly reopen a cancelled Goal to todo. Reopening creates a new workflow step occurrence; the next worker records responsibility for that current occurrence of the existing latest Round or a newly submitted Round. Earlier claims remain historical and need no cleanup. Logs, process records, Round evidence, and any retained candidate refs or worktrees from the cancelled attempt remain evidence, but its late failure cannot fail the reopened Goal or write failure metadata onto the replacement Round.

Future Direction

Cancellation may gain replacement links, superseded-by relationships, and smarter cleanup while remaining deliberate synchronized Goal intent rather than process state.