Skip to content

Queue & recovery

Multi-agent queue

start_controlled_change(scope={...}, on_conflict="queue")
  -> wait for foreign intent to clear
  -> manage_change_intent(action="promote", intent_id=...)
  -> edit within scope
  -> finish_controlled_change(...)

Workspace hygiene (guide summary)

Three contours: status (registry lifecycle), ownership (PID/TTL), hygiene (git ∩ scope), permission (edit_allowed).

  • dirty_scope_policy: continue_own_wip resumes known WIP in scope when no foreign overlap; finish still needs evidence.
  • gc_workspace: explicit GC vs lazy close on read — different predicates.
  • Blocking finish: missing_evidence, foreign_dirty_overlap, and (when strict finish mode is enabled) own_unscoped_dirty.

Normative tables: Finish hygiene, payload semantics.

Recovery: manage_change_intent(action=recover|reset_workspace) when MCP hints recovery_available.