Skip to main content

Run states and the gate

The protocol owns the vocabulary and per-flow steps below. The gateway owns transitions and prerequisite checks; clients display its state and reasons. These tables list configured steps, not every possible transition or replay. See How Farmslot works for the operating loop.

Run states​

StateProtocol category
createdWaiting or requires action
gradingActive
writing-taskActive
slot-findingActive
preparingActive
dispatchingActive
monitoringActive
reviewingActive
fixingActive
review-failedWaiting or requires action
reconcilingActive
completingActive
human-gatingWaiting or requires action
needs-decisionWaiting or requires action
ci-watchingActive
pausedWaiting or requires action
doneTerminal
blockedWaiting or requires action
failedTerminal
cancelledTerminal

An active category does not prove that a process is progressing. Uncertain delivery requires reconciliation. A terminal state closes execution; done does not guarantee successful validation. Read the retained outcome and evidence. blocked is not terminal in this protocol: recovery may resume it. Gate, pause and reviewer-failure states require their recorded reason and next action.

Flows and publication​

FlowCanonical steps, in orderHuman gate in pipelinePublication path
qafind-slot → write-task → prepare → dispatch → monitor → human-gate → completeYesReport or posted review; no new PR
fix-bugfind-slot → grade → write-task → prepare → dispatch → monitor → review → complete → human-gate → finalize → ci-watchYesGateway finalize: publish or update PR
review-prfind-slot → write-task → prepare → dispatch → monitor → human-gate → completeYesReport or posted review; no new PR
devfind-slot → write-task → prepare → dispatch → monitor → review → complete → human-gate → finalize → ci-watchYesGateway finalize: publish or update PR
pr-completefind-slot → write-task → prepare → dispatch → monitor → complete → finalize → ci-watchNo separate human-gate stepGateway finalize: publish or update PR
update-branchwrite-task → dispatch → monitor → review → complete → finalize → ci-watchNo separate human-gate stepGateway finalize: publish or update PR

dev and fix-bug may create a PR. pr-complete and update-branch operate on an existing PR. QA acknowledges a report, and review can post or dismiss its retained review. Neither creates a new PR. Interactive development can open its own draft PR; its operator-driven completion is an exception to the autonomous flow table. Policy can add decisions inside steps, so absence of a human-gate step is not permission to bypass approval or prerequisites.

The approval boundary​

Readiness checks compose the owning deterministic, review and evidence contracts. Missing, failed, stale or invalid prerequisites prevent normal advancement. Authorized evidence attestation can waive only the scoped claim-policy/binding findings permitted by ADR-062; integrity failures and unrelated prerequisites remain enforced. The gateway rechecks at decision resolution and publication. Inspection and authorized recovery remain separate actions while readiness is incomplete.

Approval binds the selected inventory and validation identity. It does not turn report prose, a video file or a checked box into claim proof. Publication must refuse changed approved bytes or selection. See the fail-closed lifecycle specification and evidence specification.