Skip to content

Autonomous development for real products. Governed agents build from specs you approve, follow the rules you set, and nothing merges until another agent proves it. Your decisions, judgement and taste are the bar that work must clear. Declare your vision and let agents build it.

50.2 KB
Raw Blame

The item lifecycle

Generated from src/machine.js by pullboard lifecycle. Do not edit it by hand: change the declaration, then run pullboard lifecycle > docs/lifecycle.md.

An item starts open. Its final states, withdrawn, cannot be left. Every move into a guarded state passes the same transition guards, whatever command gets there. The board file itself refuses any move not declared here.

Frozen check policy

The coordinator may set check.install and check.timeout in committed pullboard.json; the defaults are no install command and 5m. Accept runs the configured install and the frozen item check in a private clone, under one timeout budget. It reuses the verifier’s npm cache when available. Install commands that need network downloads conflict with P2 (offline); configure an offline install or make its needed packages available in the cache.

Private commands drain their output through pipes, retaining a bounded 8 MiB capture of its beginning and end. Failed or unverifiable checks stream the complete log through secret scanning into an owner-readable artifact; lines over 64 KiB of UTF-8 data are replaced with a safe-scan marker. Output beyond the capture cap does not fail a successful command, and dependency files and build artifacts have no capture-size limit. A timeout kills the command's process group. An unverified check names how to restore the environment and retry; a failing check names rejection or builder rework as the next step.

stateDiagram-v2
  [*] --> open
  open --> verified: rehomeImport
  open --> submitted: intake
  open --> claimed: claim
  claimed --> claimed: claim
  open --> open: release
  claimed --> open: release
  claimed --> open: lapse (clock)
  claimed --> submitted: submit
  claimed --> verified: submit-merge
  submitted --> submitted: reserve
  submitted --> verified: accept
  verified --> verified: accept
  submitted --> open: reject
  verified --> open: reject
  submitted --> open: reopen
  verified --> open: reopen
  open --> open: escalate
  claimed --> open: escalate
  open --> open: refreeze
  claimed --> open: refreeze
  submitted --> open: refreeze
  claimed --> claimed: refreeze
  open --> withdrawn: withdraw
  claimed --> withdrawn: withdraw
  submitted --> withdrawn: withdraw
  withdrawn --> [*]

States

State Means Fields it needs
open waiting for a builder; claimable once what it waits on is verified none
claimed an agent holds it under a lease, its criterion frozen item_owner, item_lease_until, item_frozen_digest
submitted a native build gated green, or an intaken outside commit awaiting sandbox verification, at a pinned commit item_built_by, item_commit, item_frozen_digest
verified another agent accepted it at the submitted commit, its canonically recorded trunk-only merge, or the item carries an attributed source-board acceptance item_verified_by, item_commit
withdrawn (final) nobody should build it; the reason stays on it item_withdrawn_reason

Moves

Each move checks its guards in this order and refuses with the first one that does not hold; result-path refusals are listed separately.

Move From To Who Guards, in order; result refusals
rehomeImport open verified agent joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), inState (REHOME_VERDICT), sourceAcceptance (REHOME_VERDICT), atSubmittedCommit (NOT_AT_COMMIT or OUTSIDE_LANE or NO_POLICY or BAD_CONFIG or GIT_GRAFTS), notBuilder (SELF_VERIFY or VERIFIER_STANDING or SELF_SESSION_VERIFY), criterionUnchanged (CRITERIA_CHANGED), proofNoted (PROOF_REQUIRED)
intake open submitted agent, coordinator joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), inState (NOT_CLAIMABLE), outsideSubmission (OUTSIDE_SOURCE)
claim open, claimed claimed agent, coordinator joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), inState (NOT_CLAIMABLE), checkProvesSomething (CRITERION_PROVES_NOTHING), barReady (BAR_NOT_READY), itemNotHeld (ITEM_HELD), inLane (WRONG_LANE or OUTSIDE_NATIVE_BUILD), routeAllows (ROUTE), dependenciesVerified (BLOCKED), notHeldByAnother (HELD), builderFirstRefusal (REOPEN_HELD_FOR_BUILDER), correctionRefrozen (PENDING_REFREEZE), laneOpen (LANE_HELD), lineCapacity (LINE_WIP_LIMIT or LINE_SETTING_RANGE), oneLiveClaim (ONE_CLAIM), rowsInForce (UNKNOWN_SPEC or A5_GRAMMAR_VERSION or NO_POLICY or BAD_CONFIG or SPEC_BEHIND_MAIN or AGENT_APPROVAL_REQUIRED or BAR_NOT_READY), result (BAD_DEPENDENCIES), result (ITEM_LEASE_LOST)
release open, claimed open agent, coordinator joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), inState (NOT_YOURS), releaseOwnsWork (NOT_YOURS), reviewReleaseExplained (NOTE_REQUIRED)
lapse claimed open clock, when its lease runs out none
submit claimed submitted agent, coordinator joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), inState (NOT_YOURS), isHolder (NOT_YOURS or OUTSIDE_NATIVE_BUILD), correctionRefrozen (PENDING_REFREEZE), checkProvesSomething (CRITERION_PROVES_NOTHING), barReady (BAR_NOT_READY), criterionUnchanged (CRITERIA_CHANGED), treeClean (DIRTY), nothingUntracked (UNTRACKED), hasCommit (NO_COMMIT or HOST_NAME), withinLane (OUTSIDE_LANE or NO_POLICY or BAD_CONFIG or GIT_GRAFTS), trunkMergeClean (MERGE_CONFLICT or MERGE_CHECK_FAILED or NO_POLICY or NO_TRUNK), trunkInCandidate (MAIN_NOT_COMPOSED), noUnverifiedStack (STACKED_ON_UNVERIFIED), infraExplained (INFRA_NOTE_REQUIRED), doctrineHolds (RATCHET_ROSE or RATCHET_UNCOUNTED), gateConfigured (NO_GATE), queuedItemLease (ITEM_LEASE_LOST or A5_GRAMMAR_VERSION or SPEC_BEHIND_MAIN or NOT_A_REPO or NO_CONFIG), gateGreen (GATE_RED or RUNNER_WAIT_DEADLINE or RUNNER_GUI_SESSION_REQUIRED or LAND_TIMEOUT_CUSTODY or LAND_GATE_OUTPUT or SLOT_DB_LOCKED or TIMING_SLOT_REQUIRED or RUNNER_BROWSER_SLOT_REQUIRED or PIPEFAIL_UNAVAILABLE), proofRecorded (PROOF_RUN_UNAVAILABLE or PROOF_RUN_UNBOUND or PROOF_RUN_ACTOR or PROOF_RUN_STALE or PROOF_RUN_CHANGED), treeStillDuringGate (MOVED_DURING_GATE), submissionProofValid (SUBMISSION_PROOF), childrenDone (CHILDREN_OPEN), headIsNew (HEAD_NOT_NEW), result (SCHEMA_DRIFT), result (BAD_DEPENDENCIES), result (AGENT_GRANT_EXPIRED), result (AGENT_GRANT_ITEM), result (AGENT_GRANT_LANE), result (LINE_SETTING_RANGE), result (MERGE_ONLY_PROOF), result (SELF_VERIFY), result (SELF_SESSION_VERIFY), result (PROOF_REQUIRED)
submit-merge claimed verified agent, coordinator, when only an unchanged accepted bar and a proved trunk-only merge; no new reviewer verdict is created joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), inState (NOT_YOURS), isHolder (NOT_YOURS or OUTSIDE_NATIVE_BUILD), correctionRefrozen (PENDING_REFREEZE), checkProvesSomething (CRITERION_PROVES_NOTHING), barReady (BAR_NOT_READY), criterionUnchanged (CRITERIA_CHANGED), treeClean (DIRTY), nothingUntracked (UNTRACKED), hasCommit (NO_COMMIT or HOST_NAME), withinLane (OUTSIDE_LANE or NO_POLICY or BAD_CONFIG or GIT_GRAFTS), trunkMergeClean (MERGE_CONFLICT or MERGE_CHECK_FAILED or NO_POLICY or NO_TRUNK), trunkInCandidate (MAIN_NOT_COMPOSED), noUnverifiedStack (STACKED_ON_UNVERIFIED), infraExplained (INFRA_NOTE_REQUIRED), doctrineHolds (RATCHET_ROSE or RATCHET_UNCOUNTED), gateConfigured (NO_GATE), queuedItemLease (ITEM_LEASE_LOST or A5_GRAMMAR_VERSION or SPEC_BEHIND_MAIN or NOT_A_REPO or NO_CONFIG), gateGreen (GATE_RED or RUNNER_WAIT_DEADLINE or RUNNER_GUI_SESSION_REQUIRED or LAND_TIMEOUT_CUSTODY or LAND_GATE_OUTPUT or SLOT_DB_LOCKED or TIMING_SLOT_REQUIRED or RUNNER_BROWSER_SLOT_REQUIRED or PIPEFAIL_UNAVAILABLE), proofRecorded (PROOF_RUN_UNAVAILABLE or PROOF_RUN_UNBOUND or PROOF_RUN_ACTOR or PROOF_RUN_STALE or PROOF_RUN_CHANGED), treeStillDuringGate (MOVED_DURING_GATE), submissionProofValid (SUBMISSION_PROOF), childrenDone (CHILDREN_OPEN), headIsNew (HEAD_NOT_NEW), mergeOnlyRecorded (MERGE_ONLY_PROOF), atSubmittedCommit (NOT_AT_COMMIT or OUTSIDE_LANE or NO_POLICY or BAD_CONFIG or GIT_GRAFTS), notBuilder (SELF_VERIFY or VERIFIER_STANDING or SELF_SESSION_VERIFY), proofNoted (PROOF_REQUIRED), result (SCHEMA_DRIFT), result (BAD_DEPENDENCIES), result (AGENT_GRANT_EXPIRED), result (AGENT_GRANT_ITEM), result (AGENT_GRANT_LANE)
reserve submitted submitted agent, coordinator coordinatorSaysAs (MAIN_IS_COORDINATOR), joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), roadmapReadable (MILESTONES_CORRUPT or LINE_SETTING_RANGE), itemExists (NO_ITEM or ITEM_MOVED), inState (NOT_SUBMITTED), reviewCooldownElapsed (REVIEW_COOLDOWN), notBuilder (SELF_VERIFY or VERIFIER_STANDING or SELF_SESSION_VERIFY), routeAllows (ROUTE), policyAllows (COORDINATOR_VERIFIES), familyAllows (O2_FAMILY_MATCH), reviewFree (REVIEW_HELD), result (BAD_DEPENDENCIES)
accept submitted, verified verified agent, coordinator coordinatorSaysAs (MAIN_IS_COORDINATOR), joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), inState (NOT_SUBMITTED), atSubmittedCommit (NOT_AT_COMMIT or OUTSIDE_LANE or NO_POLICY or BAD_CONFIG or GIT_GRAFTS), notMerged (ALREADY_MERGED), verdictReviewRecorded (BAD_VERDICT_REVIEW), reviewTreeCurrent (STALE_VERDICT or DIRTY or UNTRACKED or VERDICT_TRUNK_MOVED), notBuilder (SELF_VERIFY or VERIFIER_STANDING or SELF_SESSION_VERIFY), routeAllows (ROUTE), policyAllows (COORDINATOR_VERIFIES), familyAllows (O2_FAMILY_MATCH), reviewFree (REVIEW_HELD), criterionUnchanged (CRITERIA_CHANGED), reasonIsMet (BAD_REASON), trunkMergeClean (MERGE_CONFLICT or MERGE_CHECK_FAILED or NO_POLICY or NO_TRUNK), noUnverifiedStack (STACKED_ON_UNVERIFIED), queuedItemLease (ITEM_LEASE_LOST or A5_GRAMMAR_VERSION or SPEC_BEHIND_MAIN or NOT_A_REPO or NO_CONFIG), itemCheckGreen (CHECK_RED or RUNNER_WAIT_DEADLINE or RUNNER_BROWSER_SLOT_REQUIRED or RUNNER_GUI_SESSION_REQUIRED or SANDBOX_PROVIDER_REQUIRED or SANDBOX_IMAGE_REQUIRED or SANDBOX_RUNTIME or SANDBOX_EXPORT or SANDBOX_EXECUTION or SANDBOX_CLEANUP_REQUIRED or SANDBOX_CHECK_REQUIRED or CHECK_NO_PROOF or OUTSIDE_SANDBOX_REQUIRED or SLOT_DB_LOCKED or TIMING_SLOT_REQUIRED or CHECK_UNVERIFIED or GUARD_CANNOT_FAIL or GUARD_NOT_FOUND), proofRecorded (PROOF_RUN_UNAVAILABLE or PROOF_RUN_UNBOUND or PROOF_RUN_ACTOR or PROOF_RUN_STALE or PROOF_RUN_CHANGED), proofNoted (PROOF_REQUIRED), result (SCHEMA_DRIFT), result (BAD_DEPENDENCIES), result (AGENT_GRANT_EXPIRED), result (AGENT_GRANT_ITEM), result (AGENT_GRANT_LANE), result (VERDICT_ENVIRONMENT), result (LAND_HEADER), result (ENGINE_VERSION)
reject submitted, verified open agent, coordinator coordinatorSaysAs (MAIN_IS_COORDINATOR), joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), inState (NOT_SUBMITTED), atSubmittedCommit (NOT_AT_COMMIT or OUTSIDE_LANE or NO_POLICY or BAD_CONFIG or GIT_GRAFTS), notMerged (ALREADY_MERGED), verdictReviewRecorded (BAD_VERDICT_REVIEW), reviewTreeCurrent (STALE_VERDICT or DIRTY or UNTRACKED or VERDICT_TRUNK_MOVED), notBuilder (SELF_VERIFY or VERIFIER_STANDING or SELF_SESSION_VERIFY), routeAllows (ROUTE), policyAllows (COORDINATOR_VERIFIES), familyAllows (O2_FAMILY_MATCH), reviewFree (REVIEW_HELD), criterionUnchanged (CRITERIA_CHANGED), reasonCoded (BAD_REASON), noteGiven (NOTE_REQUIRED), causeWellFormed (BAD_CAUSE), result (SCHEMA_DRIFT), result (BAD_DEPENDENCIES), result (AGENT_GRANT_EXPIRED), result (AGENT_GRANT_ITEM), result (AGENT_GRANT_LANE), result (VERDICT_ENVIRONMENT), result (LAND_HEADER), result (ENGINE_VERSION), result (NOT_YOURS), result (CLOSED)
reopen submitted, verified open agent, coordinator joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), inState (NOT_SUBMITTED), reopenAuthority (COORDINATOR_ONLY or NO_POLICY or GIT_GRAFTS or GIT_REPLACE_REFS or VERDICT_WITHDRAW_FORBIDDEN or VERDICT_WITHDRAW_STATE), noteGiven (NOTE_REQUIRED), causeWellFormed (BAD_CAUSE), notMerged (ALREADY_MERGED), landingFailureRecorded (LANDING_FAILURE_REQUIRED), trunkConflicts (NOT_CONFLICTING or CONFLICT_FILES or NO_TRUNK or MERGE_CHECK_FAILED), conflictAccepted (NOT_ACCEPTED or BAD_CONFLICT or ENGINE_VERSION), result (BAD_VERDICT_WITHDRAW), result (ENGINE_VERSION), result (BAD_CONFIG)
escalate open, claimed open agent, coordinator joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), noteGiven (NOTE_REQUIRED), itemExists (NO_ITEM or ITEM_MOVED), holderOrCoordinator (NOT_YOURS), inState (CLOSED)
refreeze open, claimed, submitted open coordinator, when there is no live claim awaiting a coordinator correction joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), coordinatorOnly (COORDINATOR_ONLY), itemExists (NO_ITEM or ITEM_MOVED), inState (CLOSED), barReady (BAR_NOT_READY), rowsInForce (UNKNOWN_SPEC or A5_GRAMMAR_VERSION or NO_POLICY or BAD_CONFIG or SPEC_BEHIND_MAIN or AGENT_APPROVAL_REQUIRED or BAR_NOT_READY)
refreeze claimed claimed agent, coordinator, when a live claim has a pending coordinator correction joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), itemExists (NO_ITEM or ITEM_MOVED), holderOrCoordinator (NOT_YOURS), inState (CLOSED), barReady (BAR_NOT_READY), rowsInForce (UNKNOWN_SPEC or A5_GRAMMAR_VERSION or NO_POLICY or BAD_CONFIG or SPEC_BEHIND_MAIN or AGENT_APPROVAL_REQUIRED or BAR_NOT_READY)
withdraw open, claimed, submitted withdrawn coordinator joined (NOT_JOINED or AGENT_REPLACED or SESSION_LEDGER), coordinatorOnly (COORDINATOR_ONLY), noteGiven (NOTE_REQUIRED), itemExists (NO_ITEM or ITEM_MOVED), inState (CLOSED)

Required transition guards

State entered Every move into it passes
verified atSubmittedCommit, notBuilder, criterionUnchanged, proofNoted
withdrawn coordinatorOnly, noteGiven

Refusals

Code Raised when this does not hold Next step
REHOME_VERDICT rehomeImport: the item is in open pullboard show
NOT_CLAIMABLE intake: the item is in open pullboard show
NOT_CLAIMABLE claim: the item is in open, claimed pullboard show
NOT_YOURS release: the item is in open, claimed pullboard show
NOT_YOURS submit: the item is in claimed pullboard show
NOT_YOURS submit-merge: the item is in claimed pullboard show
NOT_SUBMITTED reserve: the item is in submitted pullboard show
NOT_SUBMITTED accept: the item is in submitted, verified pullboard show
NOT_SUBMITTED reject: the item is in submitted, verified pullboard show
NOT_SUBMITTED reopen: the item is in submitted, verified pullboard show
CLOSED escalate: the item is in open, claimed pullboard show
CLOSED refreeze: the item is in open, claimed, submitted pullboard show
CLOSED refreeze: the item is in claimed pullboard show
CLOSED withdraw: the item is in open, claimed, submitted pullboard show
REHOME_VERDICT the authenticated destination mover attests to an exact source board ACCEPT reference keyed by the ordered source MOVEID and result digest preserve the imported source acceptance attribution, frozen digest, commit and verifier reference
MERGE_ONLY_PROOF the sealed submit records the origin’s Git-derived carry, unchanged bar and original verifier; landing re-proves its heads, trees and resolution hash before merging submit normally for outside review if the origin cannot prove the merge
OUTSIDE_SOURCE an outside author and exact fetched commit/tree are recorded with a trusted frozen criterion, without pretending a native builder gated it fetch and intake the exact GitHub pull request again
NOT_JOINED the caller is the main checkout, or an unreplaced worktree seat that joined a lane; an agent session's claims, submits and verdicts can be checked against its local ledger pullboard join --model "" (see: pullboard lanes)
AGENT_REPLACED the caller is the main checkout, or an unreplaced worktree seat that joined a lane; an agent session's claims, submits and verdicts can be checked against its local ledger read the takeover and only shout on its exact hand-off item; continue work from the incoming agent worktree
SESSION_LEDGER the caller is the main checkout, or an unreplaced worktree seat that joined a lane; an agent session's claims, submits and verdicts can be checked against its local ledger make the agent-session ledger named in the message readable and writable by this user, then run the command again
NO_ITEM the item exists and has not been moved pullboard list --all
ITEM_MOVED the item exists and has not been moved use the recorded destination reference shown in the refusal; do not move the old ID again
COORDINATOR_ONLY the coordinator reopens, the native board computes an automatic submitted-head conflict, or the exact accepting reviewer withdraws its verdict; older recorded submitted-conflict moves keep their joined-seat authority ask the coordinator or the reviewer who recorded the accept
NO_POLICY the coordinator reopens, the native board computes an automatic submitted-head conflict, or the exact accepting reviewer withdraws its verdict; older recorded submitted-conflict moves keep their joined-seat authority restore the local Git configuration so the current trunk can be read, then compute a fresh automatic return
GIT_GRAFTS the coordinator reopens, the native board computes an automatic submitted-head conflict, or the exact accepting reviewer withdraws its verdict; older recorded submitted-conflict moves keep their joined-seat authority ask the coordinator to remove the replica graft file, then resume the same move
GIT_REPLACE_REFS the coordinator reopens, the native board computes an automatic submitted-head conflict, or the exact accepting reviewer withdraws its verdict; older recorded submitted-conflict moves keep their joined-seat authority ask the coordinator to remove the replica replacement refs, then resume the same move
VERDICT_WITHDRAW_FORBIDDEN the coordinator reopens, the native board computes an automatic submitted-head conflict, or the exact accepting reviewer withdraws its verdict; older recorded submitted-conflict moves keep their joined-seat authority ask the accepting reviewer or coordinator to withdraw the verdict
VERDICT_WITHDRAW_STATE the coordinator reopens, the native board computes an automatic submitted-head conflict, or the exact accepting reviewer withdraws its verdict; older recorded submitted-conflict moves keep their joined-seat authority refresh the item; only a current acceptance before landing can be withdrawn
COORDINATOR_ONLY the caller is the coordinator run it from the main checkout
MILESTONES_CORRUPT the recorded queue policy and roadmap are readable when selecting the next review, only next --verify selection; a review reserved by id does not consult the roadmap restore board metadata from a known-good board export
LINE_SETTING_RANGE the recorded queue policy and roadmap are readable when selecting the next review, only next --verify selection; a review reserved by id does not consult the roadmap restore the recorded board line setting from its ordered event history, then retry next --verify
MAIN_IS_COORDINATOR in the main checkout, the caller says it is the coordinator verify from your own worktree; the coordinator adds --as coordinator
NOT_YOURS the caller holds the item, or is the coordinator shout its holder, or the coordinator
NOT_YOURS the caller holds the claim or is the builder yielding its active first-refusal window release your own claim or reservation, or ask the current builder
NOT_YOURS the caller holds the claim pullboard claim
OUTSIDE_NATIVE_BUILD the caller holds the claim the outside author revises the PR; ask the coordinator to return it, then intake the new exact head
WRONG_LANE the item is in the caller's lane; the main checkout builds coordinator-lane items only cd <the lane's worktree> && pullboard claim
OUTSIDE_NATIVE_BUILD the item is in the caller's lane; the main checkout builds coordinator-lane items only the outside author revises the PR; ask the coordinator to return it, then intake the new exact head
ROUTE the caller's route covers the item's: light, then mid, then strong pullboard next, which offers only items your route covers
BLOCKED every item it waits on is verified claim another item, or shout the lane it waits on
REOPEN_HELD_FOR_BUILDER a returned item waits for its original builder until its recorded deadline or builder release wait until the named deadline, or ask its builder to run pullboard release
HELD no other agent holds it under a live lease pullboard next
LANE_HELD nobody holds its lane, unless the caller is renewing its own live claim pullboard next --wait 9 (minutes)
ITEM_HELD the coordinator has not put this item on hold, unless the caller is renewing its own live claim the coordinator lifts it with pullboard hold --off
PENDING_REFREEZE no coordinator correction to a claimed criterion or check is waiting to be frozen pullboard refreeze
LINE_WIP_LIMIT a new claim stays within recorded WIP per active reviewer, only for new claims while wipPerReviewer is on review the oldest eligible waiting submission: pullboard next --verify
LINE_SETTING_RANGE a new claim stays within recorded WIP per active reviewer, only for new claims while wipPerReviewer is on restore the malformed recorded line setting before claiming
ONE_CLAIM the caller holds no other live top-level claim, reworks of its own rejected items aside submit or release the other item first; child items are free
UNKNOWN_SPEC every row the item cites exists and is in force, only where the criterion freezes: claiming an item with no frozen criterion, and refreeze fix the spec, or the coordinator withdraws the item
A5_GRAMMAR_VERSION every row the item cites exists and is in force, only where the criterion freezes: claiming an item with no frozen criterion, and refreeze upgrade Pullboard or use a file written for grammar 1
NO_POLICY every row the item cites exists and is in force, only where the criterion freezes: claiming an item with no frozen criterion, and refreeze restore the committed coordinator policy
BAD_CONFIG every row the item cites exists and is in force, only where the criterion freezes: claiming an item with no frozen criterion, and refreeze repair and commit the coordinator configuration
SPEC_BEHIND_MAIN every row the item cites exists and is in force, only where the criterion freezes: claiming an item with no frozen criterion, and refreeze merge main from this worktree, then retry the claim
AGENT_APPROVAL_REQUIRED every row the item cites exists and is in force, only where the criterion freezes: claiming an item with no frozen criterion, and refreeze ask the coordinator to arrange the person’s confirmation or decline, or change the explicit refuse setting
BAR_NOT_READY every row the item cites exists and is in force, only where the criterion freezes: claiming an item with no frozen criterion, and refreeze another parent session signs coverage for the current accepted test inventory and runner
CRITERIA_CHANGED the criterion and the rows it cites read as they did at claim the coordinator runs pullboard refreeze
DIRTY the worktree has no uncommitted changes commit your changes, then submit
UNTRACKED the worktree has no untracked files commit or ignore them, then submit
NO_COMMIT there is a commit to submit, and no commit it adds names this machine commit your work, then submit
HOST_NAME there is a commit to submit, and no commit it adds names this machine reword the named commit's message without this machine's name (git rebase -i, then reword), then run pullboard submit again
NO_GATE the repo names a gate command in the main checkout, run pullboard gate set "", then commit pullboard.json
OUTSIDE_LANE the full claimed diff respects committed coordinator ownership restore foreign paths or shout their owner
NO_POLICY the full claimed diff respects committed coordinator ownership restore the claim base or ask the coordinator to refreeze
BAD_CONFIG the full claimed diff respects committed coordinator ownership restore the committed coordinator configuration
GIT_GRAFTS the full claimed diff respects committed coordinator ownership ask the coordinator to remove the Git graft file before retrying
MERGE_CONFLICT the candidate merges cleanly into the current primary branch without changing an index or worktree merge the trunk into your branch, resolve conflicts, commit and resubmit
MERGE_CHECK_FAILED the candidate merges cleanly into the current primary branch without changing an index or worktree use Git 2.38 or newer, restore its objects and retry
NO_POLICY the candidate merges cleanly into the current primary branch without changing an index or worktree restore the primary repository metadata
NO_TRUNK the candidate merges cleanly into the current primary branch without changing an index or worktree check out the trunk branch in the main checkout once and run pullboard inbox
MAIN_NOT_COMPOSED the candidate contains the current main used for its submission proof, and that main stays fixed through execution, bar ready is enabled for this board merge main, commit the composition, then submit again
STACKED_ON_UNVERIFIED the candidate range contains no other item's unverified submitted commit wait for that item to be accepted, or rebuild without its commits
INFRA_NOTE_REQUIRED edits to tests or gate files that existed at claim carry an explanation pullboard submit --infra ""
RATCHET_ROSE every touched doctrine check counts (exit 0 or 1), none rises above its committed count and no changed file gains a problem; watch-mode rules only count, only when accepted main has an approved doctrine rule with gate: check fix the new problems, commit, submit again; only the person's signature raises count:
RATCHET_UNCOUNTED every touched doctrine check counts (exit 0 or 1), none rises above its committed count and no changed file gains a problem; watch-mode rules only count, only when accepted main has an approved doctrine rule with gate: check fix the check so it exits 0 or 1 within its timeout, then submit again
CHECK_RED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance reject the failing behavior; the builder fixes and resubmits
RUNNER_WAIT_DEADLINE the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance check the runners the message names, or restore local gate capacity with pullboard settings, then retry
RUNNER_BROWSER_SLOT_REQUIRED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance nothing to do: the run reruns on a local gate slot; if it repeats, set gate.browserByLaunch the same on this machine and that runner
RUNNER_GUI_SESSION_REQUIRED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance nothing to do: the run reruns locally; log in to a GUI session on the runner before sending GUI-marked files there
SANDBOX_PROVIDER_REQUIRED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance configure the committed main Docker provider and pinned minimum/current images
SANDBOX_IMAGE_REQUIRED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance preload the exact pinned official image into the configured daemon
SANDBOX_RUNTIME the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance correct the pinned image so its actual Node version matches its role
SANDBOX_EXPORT the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance restore access to the exact private Git export and recorded tree
SANDBOX_EXECUTION the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance restore the Docker runtime and inspect the owned container before another verification
SANDBOX_CLEANUP_REQUIRED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance remove the exact named owned container after restoring Docker
SANDBOX_CHECK_REQUIRED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance set a trusted full gate and frozen criterion before intake
CHECK_NO_PROOF the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance strengthen the criterion so it fails before the outside change
OUTSIDE_SANDBOX_REQUIRED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance verify the outside item with --sandbox using the configured container provider
SLOT_DB_LOCKED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance the run never started, so it is not a red; rerun the same command once the named process releases the slot database
TIMING_SLOT_REQUIRED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance start the timing check outside its inherited ordinary lease and acquire the machine gate with timing true
CHECK_UNVERIFIED the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance restore the frozen install or check environment and retry
GUARD_CANNOT_FAIL the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance reject: the check stays green with the named guard reverted
GUARD_NOT_FOUND the frozen item check passes at the submitted commit, or its clean reviewed composition for a stale acceptance the named guard is not in the submitted commit; ask the coordinator to fix it
BAR_NOT_READY an opted-in new bar has a named red baseline, measurement notes, reviewer edges and a revision-bound signature from another parent session, bar ready is on and this bar was frozen or edited after activation the author completes the brief, then another parent runs pullboard bar sign
CRITERION_PROVES_NOTHING the item's check does not already pass on main, or the person accepted that exact check, only when accepted main sets checks.provesNothing to "hold" set a check that fails before the work, or the person runs pullboard check accept
GATE_RED the item check is green; submission proof is green or every failure matches exact main or a live person waiver fix what the digest names, commit, submit again
RUNNER_WAIT_DEADLINE the item check is green; submission proof is green or every failure matches exact main or a live person waiver check the runners the message names, or restore local gate capacity with pullboard settings, then retry
RUNNER_GUI_SESSION_REQUIRED the item check is green; submission proof is green or every failure matches exact main or a live person waiver nothing to do: the run reruns locally; log in to a GUI session on the runner before sending GUI-marked files there
LAND_TIMEOUT_CUSTODY the item check is green; submission proof is green or every failure matches exact main or a live person waiver inspect the saved timed gate cleanup state and stop only its proven owned processes before starting another landing
LAND_GATE_OUTPUT the item check is green; submission proof is green or every failure matches exact main or a live person waiver inspect the retained timed gate output directory and free disk space, then start another landing
SLOT_DB_LOCKED the item check is green; submission proof is green or every failure matches exact main or a live person waiver the run never started, so it is not a red; rerun the same command once the named process releases the slot database
TIMING_SLOT_REQUIRED the item check is green; submission proof is green or every failure matches exact main or a live person waiver start the timing check outside its inherited ordinary lease and acquire the machine gate with timing true
RUNNER_BROWSER_SLOT_REQUIRED the item check is green; submission proof is green or every failure matches exact main or a live person waiver nothing to do: the run reruns on a local gate slot; if it repeats, set gate.browserByLaunch the same on this machine and that runner
PIPEFAIL_UNAVAILABLE the item check is green; submission proof is green or every failure matches exact main or a live person waiver rewrite the gate without a pipe
ITEM_LEASE_LOST the caller still owns the same live item claim or review and can renew it against the frozen criterion, while submit or an accept waits for a machine slot, and once immediately before admission claim or reserve the item again before retrying the command
A5_GRAMMAR_VERSION the caller still owns the same live item claim or review and can renew it against the frozen criterion, while submit or an accept waits for a machine slot, and once immediately before admission upgrade Pullboard or restore a spec written for grammar 1, then retry
SPEC_BEHIND_MAIN the caller still owns the same live item claim or review and can renew it against the frozen criterion, while submit or an accept waits for a machine slot, and once immediately before admission merge main into this worktree, then renew the claim and retry
NOT_A_REPO the caller still owns the same live item claim or review and can renew it against the frozen criterion, while submit or an accept waits for a machine slot, and once immediately before admission restore the worktree Git metadata, then retry the command
NO_CONFIG the caller still owns the same live item claim or review and can renew it against the frozen criterion, while submit or an accept waits for a machine slot, and once immediately before admission restore pullboard.json in this worktree, then retry the command
PROOF_RUN_UNAVAILABLE every executed proof is recorded from its native gate receipt before the item outcome restore receipt storage and read pullboard show
PROOF_RUN_UNBOUND every executed proof is recorded from its native gate receipt before the item outcome restore the native gate receipt; do not supply provenance by hand
PROOF_RUN_ACTOR every executed proof is recorded from its native gate receipt before the item outcome use the receipt from your own seat
PROOF_RUN_STALE every executed proof is recorded from its native gate receipt before the item outcome read the changed criterion before running a new proof
PROOF_RUN_CHANGED every executed proof is recorded from its native gate receipt before the item outcome keep the original receipt and run a new proof
MOVED_DURING_GATE when the gate ends, HEAD and every tracked file are as they were when it started leave the worktree alone until the gate finishes, then submit again
CHILDREN_OPEN every child item is verified or withdrawn finish the child items, or the coordinator withdraws them
HEAD_NOT_NEW a verifier has not rejected this commit at this bar; after a no-verdict reopen, the bar was refrozen commit the rework, or refreeze the bar after a no-verdict reopen before resubmitting the same commit
NOT_AT_COMMIT the caller's checkout contains the submitted commit git switch --detach
OUTSIDE_LANE the caller's checkout contains the submitted commit restore foreign paths before accepting
NO_POLICY the caller's checkout contains the submitted commit restore the frozen policy objects
BAD_CONFIG the caller's checkout contains the submitted commit repair the committed coordinator configuration
GIT_GRAFTS the caller's checkout contains the submitted commit ask the coordinator to remove the Git graft file before retrying
BAD_VERDICT_REVIEW a new review binds the submitted commit, its exact checked commit, a valid trunk commit and canonical candidate paths restore the submitted Git objects and retry the review with current Pullboard
STALE_VERDICT a stale acceptance is re-reviewed at a clean HEAD containing the current trunk, which stays fixed through its check merge current main into the submitted commit and re-review it
DIRTY a stale acceptance is re-reviewed at a clean HEAD containing the current trunk, which stays fixed through its check commit the reviewed composition before re-reviewing
UNTRACKED a stale acceptance is re-reviewed at a clean HEAD containing the current trunk, which stays fixed through its check commit or ignore untracked files before re-reviewing
VERDICT_TRUNK_MOVED a stale acceptance is re-reviewed at a clean HEAD containing the current trunk, which stays fixed through its check merge the latest main and re-review the clean composition
SELF_VERIFY the decision’s verifier did not build it, and its agent session did not build or submit it under any seat; a carried verdict retains its original native authority while rechecking all author identities; for a fresh review on a linked board, at engine 48 or newer, the caller was enrolled through the relay by a line of creating seats from the coordinator that includes neither the builder nor a machine join another agent verifies it: pullboard next --verify
VERIFIER_STANDING the decision’s verifier did not build it, and its agent session did not build or submit it under any seat; a carried verdict retains its original native authority while rechecking all author identities; for a fresh review on a linked board, at engine 48 or newer, the caller was enrolled through the relay by a line of creating seats from the coordinator that includes neither the builder nor a machine join the coordinator makes an independent verifier from the main checkout: pullboard worktree --model ""
SELF_SESSION_VERIFY the decision’s verifier did not build it, and its agent session did not build or submit it under any seat; a carried verdict retains its original native authority while rechecking all author identities; for a fresh review on a linked board, at engine 48 or newer, the caller was enrolled through the relay by a line of creating seats from the coordinator that includes neither the builder nor a machine join ask another agent session to verify it: pullboard next --verify from that session's own worktree
COORDINATOR_VERIFIES the repo's verify policy lets the caller verify this lane's work the coordinator verifies it
O2_FAMILY_MATCH the builder and verifier have different declared families; an undeclared family counts as a match, only when verify.family is require ask the coordinator for a verifier from another declared family
REVIEW_HELD no other agent holds its review under a live lease pullboard next --verify, which passes over reviews another agent holds
BAD_REASON an accept gives CRITERION_MET as its reason a failed criterion is a reject: pullboard verify reject --reason CODE
PROOF_REQUIRED an accept notes how it was proved --note "what you broke or which edge you tried, and what happened"
BAD_REASON a reject names one of the reject reasons --reason TEST_FAILURE, BEHAVIOR_MISMATCH, INSUFFICIENT_EVIDENCE, STALE_HEAD or OTHER
NOTE_REQUIRED a review release gives a nonempty one-line reason, engine 5 or newer, only when freeing a submitted review reservation release with --note "why", or --note-file
REVIEW_COOLDOWN the reviewer has not released this submission within the past hour, engine 5 or newer, only for the same reviewer and current submission let another reviewer take it, or wait an hour or for a new submission
NOTE_REQUIRED the move carries a note: what failed, what was tried, or why --note "..." or --note-file
BAD_CAUSE a cause, when given, is test:::, refusal:<CODE>, row:<id>, doctrine:<id> or sentinel:<name></td> <td>fix --cause, or leave it out</td> </tr> <tr> <td>ALREADY_MERGED</td> <td>the item has no recorded merge receipt</td> <td>a merged item cannot be reopened</td> </tr> <tr> <td>SUBMISSION_PROOF</td> <td>recorded test selection names literal project files and its full-fallback policy, engine 38 or later; absent legacy selection remains unknown</td> <td>rerun submit with the current CLI</td> </tr> <tr> <td>LANDING_FAILURE_REQUIRED</td> <td>a verified item note names the failing test and landing merge commit, unless the reopen names a trunk conflict</td> <td>cite the recorded batch, or name the test and merge commit in a manual note; work that only conflicts with the trunk reopens with --conflict <file> for each conflicting file</td> </tr> <tr> <td>NOT_CONFLICTING</td> <td>the accepted commit no longer merges onto the trunk, and every named file is one that conflicts, only for reopen --conflict by the coordinator on accepted, unmerged work</td> <td>merge it, or reopen after a red landing with --note "<test file>: <test name>; merge commit <sha>"</td> </tr> <tr> <td>CONFLICT_FILES</td> <td>the accepted commit no longer merges onto the trunk, and every named file is one that conflicts, only for reopen --conflict by the coordinator on accepted, unmerged work</td> <td>name only files Git reports as conflicting with the trunk</td> </tr> <tr> <td>NO_TRUNK</td> <td>the accepted commit no longer merges onto the trunk, and every named file is one that conflicts, only for reopen --conflict by the coordinator on accepted, unmerged work</td> <td>check out the trunk branch in the main checkout once and run pullboard inbox</td> </tr> <tr> <td>MERGE_CHECK_FAILED</td> <td>the accepted commit no longer merges onto the trunk, and every named file is one that conflicts, only for reopen --conflict by the coordinator on accepted, unmerged work</td> <td>use Git 2.38 or newer, restore its objects and retry</td> </tr> <tr> <td>NOT_ACCEPTED</td> <td>a trunk conflict reopens an accepted item, names its files and the full trunk commit, and replays only under engine 52 or later, only for reopen --conflict</td> <td>reopen a submission with --note "why"</td> </tr> <tr> <td>BAD_CONFLICT</td> <td>a trunk conflict reopens an accepted item, names its files and the full trunk commit, and replays only under engine 52 or later, only for reopen --conflict</td> <td>run pullboard reopen <id> --conflict <file> from the main checkout</td> </tr> <tr> <td>ENGINE_VERSION</td> <td>a trunk conflict reopens an accepted item, names its files and the full trunk commit, and replays only under engine 52 or later, only for reopen --conflict</td> <td>upgrade Pullboard on every linked device before using --conflict</td> </tr> <tr> <td>BAD_DEPENDENCIES</td> <td>persisted prerequisites contain only positive local item ids or exact repo#id references (claim result)</td> <td>restore the item dependencies from their ordered history, then retry</td> </tr> <tr> <td>ITEM_LEASE_LOST</td> <td>a submit admission renews the same still-live build claim (claim result)</td> <td>claim the item before starting a new submit</td> </tr> <tr> <td>SCHEMA_DRIFT</td> <td>the installed board guards and complete schema match their stored stamp (submit result)</td> <td>run pullboard inbox from the main checkout; if drift remains, preserve the board and ask the coordinator to inspect its schema</td> </tr> <tr> <td>BAD_DEPENDENCIES</td> <td>persisted prerequisites contain only positive local item ids or exact repo#id references (submit result)</td> <td>restore the item dependencies from their ordered history, then retry</td> </tr> <tr> <td>AGENT_GRANT_EXPIRED</td> <td>an item mutation has a live claim or review grant (submit result)</td> <td>claim the intended item, or shout the coordinator if its claim is unavailable</td> </tr> <tr> <td>AGENT_GRANT_ITEM</td> <td>an item mutation belongs to the current claim or review grant (submit result)</td> <td>finish or release the claim, then claim the intended item; use shout for coordination</td> </tr> <tr> <td>AGENT_GRANT_LANE</td> <td>an item mutation stays inside the unclaimed seat lane (submit result)</td> <td>join a seat in the intended lane or ask its owner to make the item change</td> </tr> <tr> <td>LINE_SETTING_RANGE</td> <td>the recorded board line setting has a valid registry value (submit result)</td> <td>restore the recorded board line setting from its ordered event history, then retry submit</td> </tr> <tr> <td>MERGE_ONLY_PROOF</td> <td>a requested carry matches the recorded conflict return, acceptance and exact gated source (submit result)</td> <td>submit normally for outside review</td> </tr> <tr> <td>SELF_VERIFY</td> <td>the retained original verifier did not author the merge resubmission (submit result)</td> <td>submit the changed source for outside review</td> </tr> <tr> <td>SELF_SESSION_VERIFY</td> <td>the retained verifier shares no author parent with the resubmitting builder (submit result)</td> <td>submit for another parent session to review</td> </tr> <tr> <td>PROOF_REQUIRED</td> <td>a carried acceptance records the actual resolution diff (submit result)</td> <td>submit with the current CLI or get an outside review</td> </tr> <tr> <td>SCHEMA_DRIFT</td> <td>the installed board guards and complete schema match their stored stamp (submit-merge result)</td> <td>run pullboard inbox from the main checkout; if drift remains, preserve the board and ask the coordinator to inspect its schema</td> </tr> <tr> <td>BAD_DEPENDENCIES</td> <td>persisted prerequisites contain only positive local item ids or exact repo#id references (submit-merge result)</td> <td>restore the item dependencies from their ordered history, then retry</td> </tr> <tr> <td>AGENT_GRANT_EXPIRED</td> <td>an item mutation has a live claim or review grant (submit-merge result)</td> <td>claim the intended item, or shout the coordinator if its claim is unavailable</td> </tr> <tr> <td>AGENT_GRANT_ITEM</td> <td>an item mutation belongs to the current claim or review grant (submit-merge result)</td> <td>finish or release the claim, then claim the intended item; use shout for coordination</td> </tr> <tr> <td>AGENT_GRANT_LANE</td> <td>an item mutation stays inside the unclaimed seat lane (submit-merge result)</td> <td>join a seat in the intended lane or ask its owner to make the item change</td> </tr> <tr> <td>BAD_DEPENDENCIES</td> <td>persisted prerequisites contain only positive local item ids or exact repo#id references (reserve result)</td> <td>restore the item dependencies from their ordered history, then retry</td> </tr> <tr> <td>SCHEMA_DRIFT</td> <td>the installed board guards and complete schema match their stored stamp (accept result)</td> <td>run pullboard inbox from the main checkout; if drift remains, preserve the board and ask the coordinator to inspect its schema</td> </tr> <tr> <td>BAD_DEPENDENCIES</td> <td>persisted prerequisites contain only positive local item ids or exact repo#id references (accept result)</td> <td>restore the item dependencies from their ordered history, then retry</td> </tr> <tr> <td>AGENT_GRANT_EXPIRED</td> <td>an item mutation has a live claim or review grant (accept result)</td> <td>claim the intended item, or shout the coordinator if its claim is unavailable</td> </tr> <tr> <td>AGENT_GRANT_ITEM</td> <td>an item mutation belongs to the current claim or review grant (accept result)</td> <td>finish or release the claim, then claim the intended item; use shout for coordination</td> </tr> <tr> <td>AGENT_GRANT_LANE</td> <td>an item mutation stays inside the unclaimed seat lane (accept result)</td> <td>join a seat in the intended lane or ask its owner to make the item change</td> </tr> <tr> <td>VERDICT_ENVIRONMENT</td> <td>optional recorded verdict environment contains exact platform, architecture and Node version (accept result)</td> <td>run the frozen check with current Pullboard, then have an independent reviewer record a fresh verdict with its actual executor environment</td> </tr> <tr> <td>LAND_HEADER</td> <td>a displayed merge command carries a landing message that passes its own check (accept result)</td> <td>shout the coordinator the item id; landing writes the message, so the item itself needs no change</td> </tr> <tr> <td>ENGINE_VERSION</td> <td>a verdict that implies items replays only under engine 20 or later (accept result)</td> <td>upgrade Pullboard on every linked device before using --implies</td> </tr> <tr> <td>SCHEMA_DRIFT</td> <td>the installed board guards and complete schema match their stored stamp (reject result)</td> <td>run pullboard inbox from the main checkout; if drift remains, preserve the board and ask the coordinator to inspect its schema</td> </tr> <tr> <td>BAD_DEPENDENCIES</td> <td>persisted prerequisites contain only positive local item ids or exact repo#id references (reject result)</td> <td>restore the item dependencies from their ordered history, then retry</td> </tr> <tr> <td>AGENT_GRANT_EXPIRED</td> <td>an item mutation has a live claim or review grant (reject result)</td> <td>claim the intended item, or shout the coordinator if its claim is unavailable</td> </tr> <tr> <td>AGENT_GRANT_ITEM</td> <td>an item mutation belongs to the current claim or review grant (reject result)</td> <td>finish or release the claim, then claim the intended item; use shout for coordination</td> </tr> <tr> <td>AGENT_GRANT_LANE</td> <td>an item mutation stays inside the unclaimed seat lane (reject result)</td> <td>join a seat in the intended lane or ask its owner to make the item change</td> </tr> <tr> <td>VERDICT_ENVIRONMENT</td> <td>optional recorded verdict environment contains exact platform, architecture and Node version (reject result)</td> <td>run the frozen check with current Pullboard, then have an independent reviewer record a fresh verdict with its actual executor environment</td> </tr> <tr> <td>LAND_HEADER</td> <td>a displayed merge command carries a landing message that passes its own check (reject result)</td> <td>shout the coordinator the item id; landing writes the message, so the item itself needs no change</td> </tr> <tr> <td>ENGINE_VERSION</td> <td>a verdict that implies items replays only under engine 20 or later (reject result)</td> <td>upgrade Pullboard on every linked device before using --implies</td> </tr> <tr> <td>NOT_YOURS</td> <td>the automatic escalation is authorized as the coordinator or item holder (reject result)</td> <td>ask the coordinator to inspect the item and its route</td> </tr> <tr> <td>CLOSED</td> <td>the rejected item remains open or claimed when automatic escalation starts (reject result)</td> <td>pullboard show <id>, then ask the coordinator to inspect its current state</td> </tr> <tr> <td>BAD_VERDICT_WITHDRAW</td> <td>the explicit withdrawal flag is boolean and is not combined with a conflict (reopen result)</td> <td>use --withdraw-verdict with --note only, or report a conflict separately</td> </tr> <tr> <td>ENGINE_VERSION</td> <td>the withdrawal move is replayed by an engine defining its meaning (reopen result)</td> <td>update Pullboard before withdrawing a verdict</td> </tr> <tr> <td>BAD_CONFIG</td> <td>the configured first-refusal duration fits a valid UTC deadline (reopen result)</td> <td>set claim.reopenFirstRefusalMinutes to a non-negative whole number within the supported date range, or 0 to disable</td> </tr> <tr> <td>BAD_DECISION</td> <td>a verdict is accept or reject</td> <td>pullboard verify <id> accept, or reject --reason CODE --note "..."</td> </tr> </tbody></table> <p>For check diagnostics, a refusal from a failed or unverifiable check includes an output digest, sanitized tail, and a private full-output path in the CLI message (also <code>error.message</code> in JSON). The artifact is owner-readable only. If it cannot be saved, the tail remains available and the message names the storage error instead of claiming a path.</p>