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.

Merge commit 'acb4b367c70c8faeb691adfefc38857394107f2e' into core/232

Corey Olsoncbb07f274cab
diff --cc src/claims.js
index 737452c1,82187881..9b906b36
--- a/src/claims.js
+++ b/src/claims.js
@@@ -44,8 -57,80 +44,60 @@@ export function firstRefusalArgs(operat
return [args[0], { ...args[1], reopenFirstRefusalMinutes: minutes }, ...args.slice(2)];
}
-/** Whether a manual landing note quotes a semicolon-delimited test name, including malformed attempts. */
-export function manualLandingFailureQuoted(note) {
- if (typeof note !== 'string') return false;
- const generatedPrefix = /^Landing batch [a-z0-9_-]{1,80} failed /iu.exec(note);
- if (generatedPrefix) return false;
- const opening = /(?:^|;[ \t]*)(?:[\w.-]+\/)*[\w.-]+\.[a-z0-9]+:[ \t]*"/giu;
- for (const match of note.matchAll(opening)) {
- let escaped = false;
- let containsSeparator = false;
- for (let index = match.index + match[0].length; index < note.length; index += 1) {
- const character = note[index];
- if (character === ';') containsSeparator = true;
- if (character === '\r' || character === '\n') break;
- if (escaped) { escaped = false; continue; }
- if (character === '\\') { escaped = true; continue; }
- if (character === '"') break;
- }
- if (containsSeparator) return true;
- }
- return false;
-}
++export { manualLandingFailureQuoted } from './manual-landing-failure-quoted.js';
+
+ /** Read a quoted test name and its end offset, refusing malformed escapes or multiline text. */
+ function quotedLandingTestName(text, start) {
+ let escaped = false;
+ for (let index = start + 1; index < text.length; index += 1) {
+ const character = text[index];
+ if (character === '\r' || character === '\n') return null;
+ if (escaped) { escaped = false; continue; }
+ if (character === '\\') { escaped = true; continue; }
+ if (character !== '"') continue;
+ let name;
+ try { name = JSON.parse(text.slice(start, index + 1)); }
+ catch { return null; }
+ if (typeof name !== 'string' || !name.trim() || /[\r\n]/u.test(name)) return null;
+ return { name, end: index + 1 };
+ }
+ return null;
+ }
+
+ /** Parse the manual failure list when its sealed move declares quoted names. */
+ function quotedManualLandingFailure(failureText, mergeCommit) {
+ const tests = [];
+ let offset = 0;
+ while (offset < failureText.length) {
+ const entry = /^(?<file>(?:[\w.-]+\/)*[\w.-]+\.[a-z0-9]+):[ \t]*/iu.exec(failureText.slice(offset));
+ if (!entry) return null;
+ offset += entry[0].length;
+ let name;
+ if (failureText[offset] === '"') {
+ const quoted = quotedLandingTestName(failureText, offset);
+ if (!quoted) return null;
+ name = quoted.name;
+ offset = quoted.end;
+ while (failureText[offset] === ' ' || failureText[offset] === '\t') offset += 1;
+ } else {
+ const separator = failureText.indexOf(';', offset);
+ const end = separator < 0 ? failureText.length : separator;
+ name = failureText.slice(offset, end).trim();
+ offset = end;
+ }
+ if (!name.trim() || /[\r\n]/u.test(name)) return null;
+ tests.push({ file: entry.groups.file, name });
+ if (offset === failureText.length) break;
+ if (failureText[offset] !== ';') return null;
+ offset += 1;
+ while (failureText[offset] === ' ' || failureText[offset] === '\t') offset += 1;
+ if (offset === failureText.length) return null;
+ }
+ return tests.length ? { tests, mergeCommit } : null;
+ }
+
/** Read test and merge-commit evidence from a hand-written landing note without checking Git. */
- export function manualLandingFailure(note) {
+ export function manualLandingFailure(note, { quoted = false } = {}) {
const generatedPrefix = /^Landing batch [a-z0-9_-]{1,80} failed /iu.exec(note);
const body = generatedPrefix ? note.slice(generatedPrefix[0].length) : note;
const evidence = body.match(/;[ \t]*merge commit[ \t]+(?<mergeCommit>[a-f0-9]{40}|[a-f0-9]{64})$/iu);
diff --cc src/engine.js
index 775f573e,aa95197c..cbda6540
--- a/src/engine.js
+++ b/src/engine.js
@@@ -1,5 -1,15 +1,7 @@@
-import { HANDOFF_ENGINE } from './handoff-engine.js';
-import { handoffMoveProblem } from './handoff-state.js';
-import { requireHandoffActive } from './handoff-state.js';
-import { LINE_CAPACITY_ENGINE } from './line-capacity-engine.js';
++import { handoffMoveProblem, requireHandoffActive } from './handoff-state.js';
++import { manualLandingFailureQuoted } from './manual-landing-failure-quoted.js';
import { lineSettings } from './line-settings.js';
-import { outsideSource } from './outside-source.js';
import { requireOutsideReceipt } from './outside-proof.js';
-import { OUTSIDE_INTAKE_ENGINE } from './outside-intake-engine.js';
-import { BAR_READY_ENGINE } from './bar-ready-engine.js';
-import { barReadySetting } from './bar-readiness.js';
-import { ITEM_SHOUT_ENGINE } from './item-shout-engine.js';
-import { RIGOR_AUTO_ENGINE } from './rigor-auto-engine.js';
/** Versioned, deterministic replay through the CLI's existing board engine [H3,H16]. */
import {
createHash,
diff --cc src/manual-landing-failure-quoted.js
index 00000000,00000000..aba391d4
new file mode 100644
--- /dev/null
+++ b/src/manual-landing-failure-quoted.js
@@@ -1,0 -1,0 +1,23 @@@
++/** Pure manual-note engine classifier shared by replay preparation [H16,C7]. */
++/** Whether a manual landing note quotes a semicolon-delimited test name, including malformed attempts. */
++export function manualLandingFailureQuoted(note) {
++ if (typeof note !== 'string') return false;
++ const generatedPrefix = /^Landing batch [a-z0-9_-]{1,80} failed /iu.exec(note);
++ if (generatedPrefix) return false;
++ const opening = /(?:^|;[ \t]*)(?:[\w.-]+\/)*[\w.-]+\.[a-z0-9]+:[ \t]*"/giu;
++ for (const match of note.matchAll(opening)) {
++ let escaped = false;
++ let containsSeparator = false;
++ for (let index = match.index + match[0].length; index < note.length; index += 1) {
++ const character = note[index];
++ if (character === ';') containsSeparator = true;
++ if (character === '\r' || character === '\n') break;
++ if (escaped) { escaped = false; continue; }
++ if (character === '\\') { escaped = true; continue; }
++ if (character === '"') break;
++ }
++ if (containsSeparator) return true;
++ }
++ return false;
++}
++
diff --cc src/moves/acceptCheck.js
index e3074dc7,00000000..0a3a1104
mode 100644,000000..100644
--- a/src/moves/acceptCheck.js
+++ b/src/moves/acceptCheck.js
@@@ -1,25 -1,0 +1,25 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by acceptCheck, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { CHECK_ACCEPT_ENGINE } from '../move-engine-constants.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return CHECK_ACCEPT_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "acceptCheck", order: 45, engine: CHECK_ACCEPT_ENGINE,
++export default Object.freeze({ operation: "acceptCheck", order: 47, engine: CHECK_ACCEPT_ENGINE,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "B26_PERSON_CHANNEL": "record it as the person through pullboard view or the person's own terminal",
+ "CHECK_ACCEPT_PERSON_ONLY": "ask the coordinator to bring the check to the person: pullboard shout coordinator \"#<id> needs the person to accept its check\" --decision",
+ "CHECK_ACCEPT_STALE": "read the current check with pullboard show <id>, then the person accepts it again: pullboard check accept <id>",
+ "NO_CHECK": "run the project gate: pullboard gate"
+}) });
diff --cc src/moves/addItem.js
index b4fd4aa9,00000000..8fb00160
mode 100644,000000..100644
--- a/src/moves/addItem.js
+++ b/src/moves/addItem.js
@@@ -1,26 -1,0 +1,26 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by addItem, discovered without a shared registry edit [C7,V4,H16]. */
+import { BAR_READY_ENGINE } from '../bar-ready-engine.js';
+import { barReadySetting } from '../bar-ready-setting.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (board && barReadySetting(board).enabled) return BAR_READY_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.by ?? null; }
+
- export default Object.freeze({ operation: "addItem", order: 6, engine: 1,
++export default Object.freeze({ operation: "addItem", order: 8, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "BAD_CHECK": "ask your coordinator to set the check: pullboard edit <id> --check \"<command>\"",
+ "BAD_CHECK_BASELINE": "the coordinator sets the check again: pullboard edit <id> --check \"<command>\"",
+ "COORDINATOR_CHECK": "ask your coordinator to set the check: pullboard shout coordinator \"please set a check on #<id>\""
+}) });
diff --cc src/moves/addMilestone.js
index 8685009b,00000000..74a6efe9
mode 100644,000000..100644
--- a/src/moves/addMilestone.js
+++ b/src/moves/addMilestone.js
@@@ -1,21 -1,0 +1,21 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by addMilestone, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "addMilestone", order: 28, engine: 1,
++export default Object.freeze({ operation: "addMilestone", order: 30, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "MILESTONE_EXISTS": "pick another name, or edit the existing one: pullboard milestone edit <name>"
+}) });
diff --cc src/moves/answerDecision.js
index 048a1114,00000000..2d9fc158
mode 100644,000000..100644
--- a/src/moves/answerDecision.js
+++ b/src/moves/answerDecision.js
@@@ -1,27 -1,0 +1,27 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by answerDecision, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { IMPLIES_ENGINE } from '../move-engine-constants.js';
+import { carriesImplies } from '../move-implies.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ if (carriesImplies('answerDecision', args)) return IMPLIES_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "answerDecision", order: 23, engine: 1,
++export default Object.freeze({ operation: "answerDecision", order: 25, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ALREADY_ANSWERED": "read the answer with pullboard inbox; ask again with a new pullboard shout <to> \"<text>\" --decision",
+ "B26_PERSON_ANSWER": "ask your coordinator to answer or pass the decision: pullboard shout coordinator \"<question>\" --decision",
+ "NOT_A_DECISION": "reply with a shout: pullboard shout <to> \"<text>\"",
+ "NOT_YOUR_DECISION": "answer only decisions addressed to you; see pullboard inbox"
+}) });
diff --cc src/moves/appendFact.js
index a0a177be,00000000..3a0bce6e
mode 100644,000000..100644
--- a/src/moves/appendFact.js
+++ b/src/moves/appendFact.js
@@@ -1,31 -1,0 +1,31 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by appendFact, discovered without a shared registry edit [C7,V4,H16]. */
+import { CAUSE_ENGINE } from '../engine-metadata.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { IMPLIES_ENGINE } from '../move-engine-constants.js';
+import { carriesImplies } from '../move-implies.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ if (['cause', 'neverAgain', 'asPerson'].some(name => Boolean(args[1] && typeof args[1] === 'object' && Object.hasOwn(args[1], name) && args[1][name] !== undefined && args[1][name] !== null && args[1][name] !== false))) return CAUSE_ENGINE;
+ if (carriesImplies('appendFact', args)) return IMPLIES_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "appendFact", order: 38, engine: 1,
++export default Object.freeze({ operation: "appendFact", order: 40, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "BAD_FACT_ID": "upgrade to the current Pullboard engine, then retry the original fact operation",
+ "BAD_FACT_KIND": "use a supported kind, such as note: pullboard fact <id> note \"<what you observed>\"",
+ "EMPTY_FACT": "give nonempty fact text: pullboard fact <id> note \"<what you saw>\"",
+ "FACT_JUDGEMENT": "use a nonjudgement fact kind such as note, or ask the coordinator to record a judgement: pullboard fact <id> note \"<what you observed>\"",
+ "NO_AGENT": "create and join a lane worktree: pullboard worktree <lane> --model \"<model name>\"",
+ "NO_FACT": "name a fact id from pullboard show <id> --json"
+}) });
diff --cc src/moves/applyRowDecisions.js
index b2c3a46b,00000000..59f2218d
mode 100644,000000..100644
--- a/src/moves/applyRowDecisions.js
+++ b/src/moves/applyRowDecisions.js
@@@ -1,23 -1,0 +1,23 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by applyRowDecisions, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "applyRowDecisions", order: 36, engine: 1,
++export default Object.freeze({ operation: "applyRowDecisions", order: 38, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "ROW_DECISION": "pullboard spec approve <ids>, or pullboard spec decline <ids>",
+ "STALE_ROW_DECISION": "ask the person to approve the current row again in pullboard view"
+}) });
diff --cc src/moves/approveOutside.js
index b0002450,00000000..e3b654bb
mode 100644,000000..100644
--- a/src/moves/approveOutside.js
+++ b/src/moves/approveOutside.js
@@@ -1,28 -1,0 +1,28 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by approveOutside, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { OUTSIDE_INTAKE_ENGINE } from '../outside-intake-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function existingEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+/** Keep outside-source isolation as the original maximum over the older engine rule. */
+function minimumEngine(args, board, at) {
+ const outside = true;
+ return Math.max(outside ? OUTSIDE_INTAKE_ENGINE : 1, existingEngine(args, board, at));
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "approveOutside", order: 1, engine: 1,
++export default Object.freeze({ operation: "approveOutside", order: 3, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "B26_PERSON_CHANNEL": "record it as the person through pullboard view or the person's own terminal",
+ "OUTSIDE_SOURCE": "fetch the exact GitHub source metadata and its immutable commit/tree before intake"
+}) });
diff --cc src/moves/beginSentinelRun.js
index a4eb4c8b,00000000..c4f3a1e1
mode 100644,000000..100644
--- a/src/moves/beginSentinelRun.js
+++ b/src/moves/beginSentinelRun.js
@@@ -1,20 -1,0 +1,20 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by beginSentinelRun, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ return BOARD_SENTINEL_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "beginSentinelRun", order: 49, engine: 1,
++export default Object.freeze({ operation: "beginSentinelRun", order: 51, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "BAD_SENTINEL": "read pullboard sentinel --help and propose an exact command, project directory, owner and schedule"
+}) });
diff --cc src/moves/claim.js
index 94c4ea79,00000000..0534ebf0
mode 100644,000000..100644
--- a/src/moves/claim.js
+++ b/src/moves/claim.js
@@@ -1,57 -1,0 +1,57 @@@
+import { LINE_CAPACITY_ENGINE } from '../line-capacity-engine.js';
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by claim, discovered without a shared registry edit [C7,V4,H16]. */
+import { BAR_READY_ENGINE } from '../bar-ready-engine.js';
+import { barReadySetting } from '../bar-ready-setting.js';
+import { firstRefusal } from '../first-refusal-window.js';
+import { REOPEN_FIRST_REFUSAL_ENGINE } from '../engine-metadata.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { OUTSIDE_INTAKE_ENGINE } from '../outside-intake-engine.js';
+import { outsideSource } from '../outside-source.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function existingEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (board && barReadySetting(board).enabled) return BAR_READY_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (board && firstRefusal(board, args[0], at)) return REOPEN_FIRST_REFUSAL_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+/** Keep outside-source isolation as the original maximum over the older engine rule. */
+function minimumEngine(args, board, at) {
+ const outside = board && Boolean(outsideSource(board, args[0]));
+ const capacity = args[1]?.lineCapacity === true;
+ return Math.max(outside ? OUTSIDE_INTAKE_ENGINE : 1, capacity ? LINE_CAPACITY_ENGINE : 1, existingEngine(args, board, at));
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "claim", order: 11, engine: 1,
++export default Object.freeze({ operation: "claim", order: 13, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "LINE_WIP_LIMIT": "review the oldest eligible waiting submission: pullboard next --verify; if none is eligible, ask the coordinator to arrange a reviewer",
+ "A5_GRAMMAR_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "AGENT_APPROVAL_REQUIRED": "ask the person to confirm or decline the named row through pullboard view or their own terminal",
+ "BAD_CONFIG": "fix pullboard.json as the message says, then commit it: git commit -m \"chore: fix pullboard config\" pullboard.json",
+ "BAR_NOT_READY": "read pullboard bar <id>; ask its author to complete the named red baseline and measurement/edge notes, then have an outside parent session sign the current bar",
+ "BLOCKED": "take another item with pullboard next, or shout the lane it waits on: pullboard shout <lane> \"<text>\"",
+ "CRITERION_PROVES_NOTHING": "set a check that fails before the work: pullboard edit <id> --check \"<command>\", or ask the person to accept this one: pullboard check accept <id>",
+ "HELD": "take another item: pullboard next",
+ "ITEM_HELD": "take another item with pullboard next while the coordinator holds this one",
+ "LANE_HELD": "wait for the lane: pullboard next --wait 9 (minutes)",
+ "NOT_CLAIMABLE": "take open work: pullboard next",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "NO_POLICY": "restore and commit pullboard.json, then run the command again",
+ "ONE_CLAIM": "submit or release the item you hold: pullboard release <id> --note \"why\"",
+ "PENDING_REFREEZE": "the coordinator runs pullboard refreeze <id>",
+ "REOPEN_HELD_FOR_BUILDER": "wait until the named deadline, or ask the builder to run pullboard release <id>",
+ "ROUTE": "take an item your route covers: pullboard next",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again",
+ "SPEC_BEHIND_MAIN": "git merge main",
+ "UNKNOWN_SPEC": "ask the coordinator to restore the named spec rows or withdraw the item: pullboard shout coordinator \"please fix the rows cited by #<id>\"",
+ "WRONG_LANE": "create a worktree in the required lane with pullboard worktree <lane> --model \"<model name>\", or take an item in your lane with pullboard next"
+}) });
diff --cc src/moves/completeCheckBaseline.js
index 4262eaa1,00000000..47de5089
mode 100644,000000..100644
--- a/src/moves/completeCheckBaseline.js
+++ b/src/moves/completeCheckBaseline.js
@@@ -1,21 -1,0 +1,21 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by completeCheckBaseline, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "completeCheckBaseline", order: 8, engine: 1,
++export default Object.freeze({ operation: "completeCheckBaseline", order: 10, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "BAD_CHECK_BASELINE": "the coordinator sets the check again: pullboard edit <id> --check \"<command>\""
+}) });
diff --cc src/moves/decideSentinel.js
index 4c64acd4,00000000..6473ab2f
mode 100644,000000..100644
--- a/src/moves/decideSentinel.js
+++ b/src/moves/decideSentinel.js
@@@ -1,21 -1,0 +1,21 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by decideSentinel, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ return BOARD_SENTINEL_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "decideSentinel", order: 48, engine: 1,
++export default Object.freeze({ operation: "decideSentinel", order: 50, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "B26_PERSON_CHANNEL": "record it as the person through pullboard view or the person's own terminal",
+ "BAD_SENTINEL": "read pullboard sentinel --help and propose an exact command, project directory, owner and schedule"
+}) });
diff --cc src/moves/declareJob.js
index 7bc02659,00000000..2c3b1f78
mode 100644,000000..100644
--- a/src/moves/declareJob.js
+++ b/src/moves/declareJob.js
@@@ -1,23 -1,0 +1,23 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by declareJob, discovered without a shared registry edit [C7,V4,H16]. */
+import { RECURRING_JOB_ENGINE } from '../job-engine.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return RECURRING_JOB_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "declareJob", order: 54, engine: 1,
++export default Object.freeze({ operation: "declareJob", order: 56, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "BAD_JOB": "name the job and a cadence like 10m, 2h or daily: pullboard loop declare <name> --every 10m --owner <seat or lane>",
+ "JOB_CADENCE_COORDINATOR_ONLY": "ask the coordinator to change the cadence: pullboard shout coordinator \"<job> needs cadence <every>\" --decision"
+}) });
diff --cc src/moves/draftSpecRow.js
index e82f8677,00000000..ae1320e1
mode 100644,000000..100644
--- a/src/moves/draftSpecRow.js
+++ b/src/moves/draftSpecRow.js
@@@ -1,22 -1,0 +1,22 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by draftSpecRow, discovered without a shared registry edit [C7,V4,H16]. */
+import { ROW_DRAFT_ENGINE } from '../engine-metadata.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return ROW_DRAFT_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "draftSpecRow", order: 37, engine: ROW_DRAFT_ENGINE,
++export default Object.freeze({ operation: "draftSpecRow", order: 39, engine: ROW_DRAFT_ENGINE,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ROW_DRAFT": "pullboard spec draft \"<text>\" from an agent seat; the person approves the returned id"
+}) });
diff --cc src/moves/editItem.js
index 3a57c76e,00000000..40cec83e
mode 100644,000000..100644
--- a/src/moves/editItem.js
+++ b/src/moves/editItem.js
@@@ -1,33 -1,0 +1,33 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by editItem, discovered without a shared registry edit [C7,V4,H16]. */
+import {
+ BAR_ENGINE,
+ carriesBarReason,
+} from '../bar-corrections.js';
+import { BAR_READY_ENGINE } from '../bar-ready-engine.js';
+import { barReadySetting } from '../bar-ready-setting.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (board && barReadySetting(board).enabled) return BAR_READY_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ if (carriesBarReason('editItem', args)) return BAR_ENGINE;
+ if (args[1] && Object.hasOwn(args[1], 'after') && args[1].after !== undefined) return 10;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "editItem", order: 7, engine: 1,
++export default Object.freeze({ operation: "editItem", order: 9, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "BAD_CHECK": "ask your coordinator to set the check: pullboard edit <id> --check \"<command>\"",
+ "BAR_REASON": "say what the old bar got wrong: pullboard edit <id> --reason \"...\"",
+ "COORDINATOR_CHECK": "ask your coordinator to set the check: pullboard shout coordinator \"please set a check on #<id>\"",
+ "USAGE": "run pullboard help"
+}) });
diff --cc src/moves/editMilestone.js
index a5dc8383,00000000..169703d5
mode 100644,000000..100644
--- a/src/moves/editMilestone.js
+++ b/src/moves/editMilestone.js
@@@ -1,26 -1,0 +1,26 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by editMilestone, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { MILESTONE_SHIP_ENGINE } from '../move-engine-constants.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ if (args[1] && Object.hasOwn(args[1], 'target') && args[1].target !== undefined) return MILESTONE_SHIP_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "editMilestone", order: 32, engine: 1,
++export default Object.freeze({ operation: "editMilestone", order: 34, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "MILESTONE_EDIT": "pass --name, --note or --target: pullboard milestone edit <name> --note \"<text>\"",
+ "MILESTONE_EXISTS": "pick another name, or edit the existing one: pullboard milestone edit <name>",
+ "NO_MILESTONE": "name a milestone from pullboard roadmap"
+}) });
diff --cc src/moves/editMilestoneItems.js
index 5bfd8aa0,00000000..0ad1ab2d
mode 100644,000000..100644
--- a/src/moves/editMilestoneItems.js
+++ b/src/moves/editMilestoneItems.js
@@@ -1,22 -1,0 +1,22 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by editMilestoneItems, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "editMilestoneItems", order: 29, engine: 1,
++export default Object.freeze({ operation: "editMilestoneItems", order: 31, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "MILESTONE_ITEMS": "list item ids once each: pullboard milestone add <name> --items 1,2",
+ "NO_MILESTONE": "name a milestone from pullboard roadmap"
+}) });
diff --cc src/moves/ensureCoordinator.js
index 85a598f9,00000000..e01be700
mode 100644,000000..100644
--- a/src/moves/ensureCoordinator.js
+++ b/src/moves/ensureCoordinator.js
@@@ -1,19 -1,0 +1,19 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by ensureCoordinator, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return null; }
+
- export default Object.freeze({ operation: "ensureCoordinator", order: 5, engine: 1,
++export default Object.freeze({ operation: "ensureCoordinator", order: 7, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({}) });
diff --cc src/moves/escalate.js
index 78fa8172,00000000..34d31afa
mode 100644,000000..100644
--- a/src/moves/escalate.js
+++ b/src/moves/escalate.js
@@@ -1,26 -1,0 +1,26 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by escalate, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "escalate", order: 9, engine: 1,
++export default Object.freeze({ operation: "escalate", order: 11, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "CLOSED": "read its state with pullboard show <id>, then take open work: pullboard next",
+ "NOTE_REQUIRED": "add --note \"<what happened>\"",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NOT_YOURS": "shout its holder or the coordinator: pullboard shout coordinator \"<what you need>\"",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again"
+}) });
diff --cc src/moves/finishLandingBatch.js
index dd0d2893,00000000..289cd846
mode 100644,000000..100644
--- a/src/moves/finishLandingBatch.js
+++ b/src/moves/finishLandingBatch.js
@@@ -1,42 -1,0 +1,42 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by finishLandingBatch, discovered without a shared registry edit [C7,V4,H16]. */
+import { VERDICT_REVIEW_ENGINE } from '../engine-metadata.js';
+import { carriesLandingEnvironment } from '../execution-environment.js';
+import { LOCAL_LANDING_ENGINE } from '../land-engine.js';
+import { landingBatches } from '../landing-batch-history.js';
+import { LANDING_ENVIRONMENT_ENGINE } from '../landing-environment-engine.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { landingTestDefects } from '../landing-test-defect-history.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+import { SUBMISSION_PROOF_ENGINE } from '../submit-invariants.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (board) {
+ if (landingTestDefects(board).length) return LANDING_ENVIRONMENT_ENGINE;
+ const id = args[0]?.id;
+ if (landingBatches(board).some(batch => batch.id === id && carriesLandingEnvironment(batch))) return LANDING_ENVIRONMENT_ENGINE;
+ }
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (board && landingBatches(board).find(batch => batch.id === args[0]?.id)?.state === 'trunk') return LOCAL_LANDING_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ if (board) {
+ const id = args[0]?.id;
+ const prior = id && landingBatches(board).find(batch => batch.id === id);
+ if (prior?.invariantEvidence) return SUBMISSION_PROOF_ENGINE;
+ if (prior && ['items', 'candidates'].some(key => Array.isArray(prior[key]) && prior[key].some(entry => entry && Object.hasOwn(entry, 'reviewedCommit')))) return VERDICT_REVIEW_ENGINE;
+ }
+ return 8;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "finishLandingBatch", order: 44, engine: 8,
++export default Object.freeze({ operation: "finishLandingBatch", order: 46, engine: 8,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "LAND_BATCH": "adopt the recorded batch: pullboard land --adopt",
+ "LAND_ITEM_MOVED": "rebuild the batch from current verified work: pullboard land",
+ "LAND_NOT_PUSHED": "push the batch, then pullboard land --adopt"
+}) });
diff --cc src/moves/finishSentinelRun.js
index ed109fa0,00000000..df5336ba
mode 100644,000000..100644
--- a/src/moves/finishSentinelRun.js
+++ b/src/moves/finishSentinelRun.js
@@@ -1,20 -1,0 +1,20 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by finishSentinelRun, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ return BOARD_SENTINEL_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "finishSentinelRun", order: 50, engine: 1,
++export default Object.freeze({ operation: "finishSentinelRun", order: 52, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "STALE_SENTINEL": "read pullboard sentinels and ask the person to approve the current exact proposal"
+}) });
diff --cc src/moves/holdItem.js
index 957bd902,00000000..238f7fae
mode 100644,000000..100644
--- a/src/moves/holdItem.js
+++ b/src/moves/holdItem.js
@@@ -1,22 -1,0 +1,22 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by holdItem, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "holdItem", order: 26, engine: 1,
++export default Object.freeze({ operation: "holdItem", order: 28, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ITEM_NOT_OPEN": "hold only open or claimed items; see pullboard list",
+ "USAGE": "run pullboard help"
+}) });
diff --cc src/moves/holdLane.js
index 303afb3c,00000000..d21f0667
mode 100644,000000..100644
--- a/src/moves/holdLane.js
+++ b/src/moves/holdLane.js
@@@ -1,22 -1,0 +1,22 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by holdLane, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.asPerson ? 'person' : move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "holdLane", order: 24, engine: 1,
++export default Object.freeze({ operation: "holdLane", order: 26, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "B26_PERSON_CHANNEL": "record it as the person through pullboard view or the person's own terminal",
+ "USAGE": "run pullboard help"
+}) });
diff --cc src/moves/intakeOutside.js
index dad09f55,00000000..e670f1e4
mode 100644,000000..100644
--- a/src/moves/intakeOutside.js
+++ b/src/moves/intakeOutside.js
@@@ -1,31 -1,0 +1,31 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by intakeOutside, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { OUTSIDE_INTAKE_ENGINE } from '../outside-intake-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function existingEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+/** Keep outside-source isolation as the original maximum over the older engine rule. */
+function minimumEngine(args, board, at) {
+ const outside = true;
+ return Math.max(outside ? OUTSIDE_INTAKE_ENGINE : 1, existingEngine(args, board, at));
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "intakeOutside", order: 0, engine: 1,
++export default Object.freeze({ operation: "intakeOutside", order: 2, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "NOT_CLAIMABLE": "take open work: pullboard next",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "OUTSIDE_SOURCE": "fetch the exact GitHub source metadata and its immutable commit/tree before intake",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again"
+}) });
diff --cc src/moves/landingLeaseMove.js
index feb61518,00000000..4bb531d6
mode 100644,000000..100644
--- a/src/moves/landingLeaseMove.js
+++ b/src/moves/landingLeaseMove.js
@@@ -1,21 -1,0 +1,21 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by landingLeaseMove, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { LANDING_LOCAL_LEASE_ENGINE } from '../landing-local-lease-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.localHeartbeat === true) return LANDING_LOCAL_LEASE_ENGINE;
+ return LANDING_LEASE_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "landingLeaseMove", order: 57, engine: 1,
++export default Object.freeze({ operation: "landingLeaseMove", order: 59, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "LAND_LEASE_REQUEST": "start a new pullboard land command from the coordinator main checkout"
+}) });
diff --cc src/moves/merged.js
index 1bae0eac,00000000..10362a00
mode 100644,000000..100644
--- a/src/moves/merged.js
+++ b/src/moves/merged.js
@@@ -1,28 -1,0 +1,28 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by merged, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { OUTSIDE_INTAKE_ENGINE } from '../outside-intake-engine.js';
+import { outsideSource } from '../outside-source.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function existingEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+/** Keep outside-source isolation as the original maximum over the older engine rule. */
+function minimumEngine(args, board, at) {
+ const outside = board && Boolean(outsideSource(board, args[0]));
+ return Math.max(outside ? OUTSIDE_INTAKE_ENGINE : 1, existingEngine(args, board, at));
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "merged", order: 17, engine: 1,
++export default Object.freeze({ operation: "merged", order: 19, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "NOT_VERIFIED": "merge only verified items; see pullboard list --all"
+}) });
diff --cc src/moves/moveMilestone.js
index 8eae8042,00000000..b6e05a91
mode 100644,000000..100644
--- a/src/moves/moveMilestone.js
+++ b/src/moves/moveMilestone.js
@@@ -1,22 -1,0 +1,22 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by moveMilestone, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "moveMilestone", order: 31, engine: 1,
++export default Object.freeze({ operation: "moveMilestone", order: 33, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "MILESTONE_ORDER": "move it before a different milestone; see pullboard roadmap",
+ "NO_MILESTONE": "name a milestone from pullboard roadmap"
+}) });
diff --cc src/moves/openHandoff.js
index 00000000,00000000..33f50a53
new file mode 100644
--- /dev/null
+++ b/src/moves/openHandoff.js
@@@ -1,0 -1,0 +1,14 @@@
++/** Routing metadata for accepted handoff moves [B3,N19,H16,C7]. */
++import { HANDOFF_ENGINE } from '../handoff-engine.js';
++/** Accepted handoff operations require their feature engine before all older conditions. */
++function minimumEngine() { return HANDOFF_ENGINE; }
++/** Both accepted handoff operations name their actor in their first options argument. */
++function actor(move) { return move.args[0]?.agentId ?? null; }
++export default Object.freeze({ operation: "openHandoff", order: 0, engine: HANDOFF_ENGINE,
++ itemIdFirstArgument: false, minimumEngine, actor, nextSteps: Object.freeze({
++ "AGENT_REPLACED": "read the takeover named in the refusal; only shout on that exact hand-off item, then continue work from the incoming agent worktree",
++ "HANDOFF_WORKTREE": "join an agent worktree and run pullboard handoff there; the main checkout uses pullboard takeover",
++ "HANDOFF_SELF": "join a different worktree as the incoming agent, then run pullboard handoff --take <id>",
++ "HANDOFF_TAKEN": "read the recorded takeover and ask the incoming agent on the hand-off item before replacing another role",
++ "NO_HANDOFF": "ask the outgoing agent to run pullboard handoff, then read and take the active item it prints"
++}) });
diff --cc src/moves/orderMilestoneItems.js
index dd6d97d8,00000000..a53df9d4
mode 100644,000000..100644
--- a/src/moves/orderMilestoneItems.js
+++ b/src/moves/orderMilestoneItems.js
@@@ -1,25 -1,0 +1,25 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by orderMilestoneItems, discovered without a shared registry edit [C7,V4,H16]. */
+import { MILESTONE_RANK_ENGINE } from '../engine-metadata.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return MILESTONE_RANK_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "orderMilestoneItems", order: 30, engine: MILESTONE_RANK_ENGINE,
++export default Object.freeze({ operation: "orderMilestoneItems", order: 32, engine: MILESTONE_RANK_ENGINE,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "MILESTONE_ITEMS": "list item ids once each: pullboard milestone add <name> --items 1,2",
+ "NO_AGENT": "create and join a lane worktree: pullboard worktree <lane> --model \"<model name>\"",
+ "NO_MILESTONE": "name a milestone from pullboard roadmap"
+}) });
diff --cc src/moves/passDecision.js
index 6a500110,00000000..2be37d1d
mode 100644,000000..100644
--- a/src/moves/passDecision.js
+++ b/src/moves/passDecision.js
@@@ -1,24 -1,0 +1,24 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by passDecision, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "passDecision", order: 22, engine: 1,
++export default Object.freeze({ operation: "passDecision", order: 24, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ALREADY_ANSWERED": "read the answer with pullboard inbox; ask again with a new pullboard shout <to> \"<text>\" --decision",
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "EMPTY_NOTE": "say why: pullboard pass <id> --note \"<reason>\"",
+ "NOT_COORDINATOR_DECISION": "list open decisions with pullboard decisions and answer one of those"
+}) });
diff --cc src/moves/proposeSentinel.js
index d71dc7a9,00000000..d27d18a9
mode 100644,000000..100644
--- a/src/moves/proposeSentinel.js
+++ b/src/moves/proposeSentinel.js
@@@ -1,20 -1,0 +1,20 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by proposeSentinel, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ return BOARD_SENTINEL_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "proposeSentinel", order: 47, engine: 1,
++export default Object.freeze({ operation: "proposeSentinel", order: 49, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "BAD_SENTINEL": "read pullboard sentinel --help and propose an exact command, project directory, owner and schedule"
+}) });
diff --cc src/moves/recordAttempt.js
index c4737af7,00000000..13af5cf3
mode 100644,000000..100644
--- a/src/moves/recordAttempt.js
+++ b/src/moves/recordAttempt.js
@@@ -1,19 -1,0 +1,19 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordAttempt, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordAttempt", order: 10, engine: 1,
++export default Object.freeze({ operation: "recordAttempt", order: 12, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({}) });
diff --cc src/moves/recordFlakeObservation.js
index 95b5afbb,00000000..6e6ea840
mode 100644,000000..100644
--- a/src/moves/recordFlakeObservation.js
+++ b/src/moves/recordFlakeObservation.js
@@@ -1,25 -1,0 +1,25 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordFlakeObservation, discovered without a shared registry edit [C7,V4,H16]. */
+import {
+ CI_FLAKE_ENGINE,
+ NATIVE_FLAKE_ENGINE,
+} from '../flake-engine.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ return args[0]?.observation?.kind === 'ci' ? CI_FLAKE_ENGINE : NATIVE_FLAKE_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordFlakeObservation", order: 52, engine: 1,
++export default Object.freeze({ operation: "recordFlakeObservation", order: 54, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "FLAKE_OBSERVATION_CHANGED": "keep the original observation unchanged; record a new gate failure with a new observation identity instead of replacing historical evidence",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)"
+}) });
diff --cc src/moves/recordGateRun.js
index 3904c817,00000000..969f699f
mode 100644,000000..100644
--- a/src/moves/recordGateRun.js
+++ b/src/moves/recordGateRun.js
@@@ -1,26 -1,0 +1,26 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordGateRun, discovered without a shared registry edit [C7,V4,H16]. */
+import { GATE_RUN_ENGINE } from '../gate-run-engine.js';
+import { LANDING_ENVIRONMENT_ENGINE } from '../landing-environment-engine.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (Object.hasOwn(args[0]?.receipt ?? {}, 'environment')) return LANDING_ENVIRONMENT_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return GATE_RUN_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordGateRun", order: 53, engine: 1,
++export default Object.freeze({ operation: "recordGateRun", order: 55, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "GATE_RUN_CHANGED": "keep the original gate run unchanged; record a new run with a new id instead of replacing historical evidence",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)"
+}) });
diff --cc src/moves/recordHealthFindings.js
index dc3cf49f,00000000..bfda6c51
mode 100644,000000..100644
--- a/src/moves/recordHealthFindings.js
+++ b/src/moves/recordHealthFindings.js
@@@ -1,24 -1,0 +1,24 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordHealthFindings, discovered without a shared registry edit [C7,V4,H16]. */
+import { HEALTH_SENTINEL_ENGINE } from '../health-receipts.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return HEALTH_SENTINEL_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordHealthFindings", order: 46, engine: 1,
++export default Object.freeze({ operation: "recordHealthFindings", order: 48, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "HEALTH_SCAN_STALE": "run pullboard sentinel run again to scan the current board before posting sentinel notices",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)"
+}) });
diff --cc src/moves/recordJobRun.js
index c22238dc,00000000..594deaec
mode 100644,000000..100644
--- a/src/moves/recordJobRun.js
+++ b/src/moves/recordJobRun.js
@@@ -1,23 -1,0 +1,23 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordJobRun, discovered without a shared registry edit [C7,V4,H16]. */
+import { RECURRING_JOB_ENGINE } from '../job-engine.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return RECURRING_JOB_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordJobRun", order: 55, engine: 1,
++export default Object.freeze({ operation: "recordJobRun", order: 57, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "UNKNOWN_JOB": "ask the coordinator to declare it: pullboard shout coordinator \"declare job <name>\"; read the declared jobs with pullboard loop"
+}) });
diff --cc src/moves/recordLandingBatch.js
index a5052bf0,00000000..a76fe2fe
mode 100644,000000..100644
--- a/src/moves/recordLandingBatch.js
+++ b/src/moves/recordLandingBatch.js
@@@ -1,49 -1,0 +1,49 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordLandingBatch, discovered without a shared registry edit [C7,V4,H16]. */
+import { VERDICT_REVIEW_ENGINE } from '../engine-metadata.js';
+import { carriesLandingEnvironment } from '../execution-environment.js';
+import {
+ NATIVE_FLAKE_ENGINE,
+ carriesFlakeDiagnostics,
+} from '../flake-engine.js';
+import { LOCAL_LANDING_ENGINE } from '../land-engine.js';
+import { landingBatches } from '../landing-batch-history.js';
+import { LANDING_ENVIRONMENT_ENGINE } from '../landing-environment-engine.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { landingTestDefects } from '../landing-test-defect-history.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+import { SUBMISSION_PROOF_ENGINE } from '../submit-invariants.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (carriesLandingEnvironment(args[0]?.batch)) return LANDING_ENVIRONMENT_ENGINE;
+ if (board) {
+ if (landingTestDefects(board).length) return LANDING_ENVIRONMENT_ENGINE;
+ const id = args[0]?.batch?.id;
+ if (landingBatches(board).some(batch => batch.id === id && carriesLandingEnvironment(batch))) return LANDING_ENVIRONMENT_ENGINE;
+ }
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (args[0]?.batch?.state === 'trunk') return LOCAL_LANDING_ENGINE;
+ if (carriesFlakeDiagnostics(args[0]?.batch)) return NATIVE_FLAKE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ if (args[0]?.batch?.invariantEvidence !== undefined) return SUBMISSION_PROOF_ENGINE;
+ if (board) {
+ const id = args[0]?.batch?.id;
+ const prior = id && landingBatches(board).find(batch => batch.id === id);
+ if (prior?.invariantEvidence) return SUBMISSION_PROOF_ENGINE;
+ if (prior && ['items', 'candidates'].some(key => Array.isArray(prior[key]) && prior[key].some(entry => entry && Object.hasOwn(entry, 'reviewedCommit')))) return VERDICT_REVIEW_ENGINE;
+ }
+ if (args[0]?.batch && ['items', 'candidates'].some(key => Array.isArray(args[0].batch[key]) && args[0].batch[key].some(entry => entry && typeof entry === 'object' && Object.hasOwn(entry, 'reviewedCommit')))) return VERDICT_REVIEW_ENGINE;
+ return 8;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordLandingBatch", order: 40, engine: 8,
++export default Object.freeze({ operation: "recordLandingBatch", order: 42, engine: 8,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "LAND_BATCH": "adopt the recorded batch: pullboard land --adopt"
+}) });
diff --cc src/moves/recordLandingFlake.js
index 8ca132fb,00000000..51baa135
mode 100644,000000..100644
--- a/src/moves/recordLandingFlake.js
+++ b/src/moves/recordLandingFlake.js
@@@ -1,21 -1,0 +1,21 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordLandingFlake, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 8;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordLandingFlake", order: 42, engine: 8,
++export default Object.freeze({ operation: "recordLandingFlake", order: 44, engine: 8,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "LAND_FLAKE": "fix the flaky test, or ask the person for a waiver: pullboard land --waive <test> --until <date> --reason \"why\""
+}) });
diff --cc src/moves/recordLandingTestDefect.js
index 781cd530,00000000..7169b895
mode 100644,000000..100644
--- a/src/moves/recordLandingTestDefect.js
+++ b/src/moves/recordLandingTestDefect.js
@@@ -1,20 -1,0 +1,20 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordLandingTestDefect, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_ENVIRONMENT_ENGINE } from '../landing-environment-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ return LANDING_ENVIRONMENT_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordLandingTestDefect", order: 43, engine: 1,
++export default Object.freeze({ operation: "recordLandingTestDefect", order: 45, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "LAND_TEST_DEFECT": "commit a correction to the test named by the held defect, or ask the person for an expiring test waiver; then run pullboard land again"
+}) });
diff --cc src/moves/recordLandingWaiver.js
index b13ee6a9,00000000..e81dd863
mode 100644,000000..100644
--- a/src/moves/recordLandingWaiver.js
+++ b/src/moves/recordLandingWaiver.js
@@@ -1,23 -1,0 +1,23 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordLandingWaiver, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 8;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordLandingWaiver", order: 41, engine: 8,
++export default Object.freeze({ operation: "recordLandingWaiver", order: 43, engine: 8,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "B26_PERSON_CHANNEL": "record it as the person through pullboard view or the person's own terminal",
+ "LAND_PERSON_ONLY": "ask the person to waive it from their terminal or pullboard view",
+ "LAND_WAIVER": "pullboard land --waive <test> --until <date> --reason \"why\""
+}) });
diff --cc src/moves/recordPublishFinding.js
index d3b63ab1,00000000..992ae711
mode 100644,000000..100644
--- a/src/moves/recordPublishFinding.js
+++ b/src/moves/recordPublishFinding.js
@@@ -1,19 -1,0 +1,19 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordPublishFinding, discovered without a shared registry edit [C7,V4,H16]. */
+import { PR_BRIDGE_ENGINE } from '../pr-bridge-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ return PR_BRIDGE_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordPublishFinding", order: 58, engine: 1,
++export default Object.freeze({ operation: "recordPublishFinding", order: 60, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "PUBLISH_FINDING": "record the exact merged item, publication head and failing GitHub job/run evidence"
+}) });
diff --cc src/moves/recordRowDecisions.js
index 0307e245,00000000..2dbb9832
mode 100644,000000..100644
--- a/src/moves/recordRowDecisions.js
+++ b/src/moves/recordRowDecisions.js
@@@ -1,23 -1,0 +1,23 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordRowDecisions, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordRowDecisions", order: 35, engine: 1,
++export default Object.freeze({ operation: "recordRowDecisions", order: 37, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "B26_PERSON_APPROVAL": "ask the person to decide in pullboard view",
+ "B26_PERSON_CHANNEL": "record it as the person through pullboard view or the person's own terminal",
+ "ROW_DECISION": "pullboard spec approve <ids>, or pullboard spec decline <ids>"
+}) });
diff --cc src/moves/recordSpecApprovalBaseline.js
index 15d3b732,00000000..3a5a7fd1
mode 100644,000000..100644
--- a/src/moves/recordSpecApprovalBaseline.js
+++ b/src/moves/recordSpecApprovalBaseline.js
@@@ -1,24 -1,0 +1,24 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by recordSpecApprovalBaseline, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+import { SPEC_APPROVAL_ENGINE } from '../spec-approval-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return SPEC_APPROVAL_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "recordSpecApprovalBaseline", order: 39, engine: SPEC_APPROVAL_ENGINE,
++export default Object.freeze({ operation: "recordSpecApprovalBaseline", order: 41, engine: SPEC_APPROVAL_ENGINE,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "SPEC_APPROVAL_BASELINE": "ask the coordinator to restore the original approval baseline from a known-good board export"
+}) });
diff --cc src/moves/refreeze.js
index 77165bd4,00000000..489ca012
mode 100644,000000..100644
--- a/src/moves/refreeze.js
+++ b/src/moves/refreeze.js
@@@ -1,36 -1,0 +1,36 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by refreeze, discovered without a shared registry edit [C7,V4,H16]. */
+import { BAR_READY_ENGINE } from '../bar-ready-engine.js';
+import { barReadySetting } from '../bar-ready-setting.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (board && barReadySetting(board).enabled) return BAR_READY_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "refreeze", order: 19, engine: 1,
++export default Object.freeze({ operation: "refreeze", order: 21, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "A5_GRAMMAR_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "AGENT_APPROVAL_REQUIRED": "ask the person to confirm or decline the named row through pullboard view or their own terminal",
+ "BAD_CONFIG": "fix pullboard.json as the message says, then commit it: git commit -m \"chore: fix pullboard config\" pullboard.json",
+ "BAR_NOT_READY": "read pullboard bar <id>; ask its author to complete the named red baseline and measurement/edge notes, then have an outside parent session sign the current bar",
+ "CLOSED": "read its state with pullboard show <id>, then take open work: pullboard next",
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NOT_YOURS": "shout its holder or the coordinator: pullboard shout coordinator \"<what you need>\"",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "NO_POLICY": "restore and commit pullboard.json, then run the command again",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again",
+ "SPEC_BEHIND_MAIN": "git merge main",
+ "UNKNOWN_SPEC": "ask the coordinator to restore the named spec rows or withdraw the item: pullboard shout coordinator \"please fix the rows cited by #<id>\""
+}) });
diff --cc src/moves/register.js
index e857a11a,00000000..7e116b84
mode 100644,000000..100644
--- a/src/moves/register.js
+++ b/src/moves/register.js
@@@ -1,25 -1,0 +1,25 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by register, discovered without a shared registry edit [C7,V4,H16]. */
+import { VERIFIER_STANDING_ENGINE } from '../engine-metadata.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.engine >= VERIFIER_STANDING_ENGINE ? (move.args[0]?.createdBy === 'machine' ? null : move.args[0]?.createdBy ?? null) : null; }
+
- export default Object.freeze({ operation: "register", order: 4, engine: 1,
++export default Object.freeze({ operation: "register", order: 6, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ALREADY_JOINED": "create a worktree for the other lane: pullboard worktree <lane> --model \"<model name>\", then work from the path it prints",
+ "BAD_ROUTE": "use --route light, mid or strong",
+ "NO_AGENT": "create and join a lane worktree: pullboard worktree <lane> --model \"<model name>\"",
+ "ONE_COORDINATOR": "make a lane worktree and join it as an agent: pullboard worktree <lane> --model \"<model name>\""
+}) });
diff --cc src/moves/release.js
index 53dc08e3,00000000..c1a23cc1
mode 100644,000000..100644
--- a/src/moves/release.js
+++ b/src/moves/release.js
@@@ -1,28 -1,0 +1,28 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by release, discovered without a shared registry edit [C7,V4,H16]. */
+import { firstRefusal } from '../first-refusal-window.js';
+import { REOPEN_FIRST_REFUSAL_ENGINE } from '../engine-metadata.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (board && firstRefusal(board, args[0], at)) return REOPEN_FIRST_REFUSAL_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1] ?? null; }
+
- export default Object.freeze({ operation: "release", order: 12, engine: 1,
++export default Object.freeze({ operation: "release", order: 14, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "NOTE_REQUIRED": "add --note \"<what happened>\"",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NOT_YOURS": "shout its holder or the coordinator: pullboard shout coordinator \"<what you need>\"",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again"
+}) });
diff --cc src/moves/releaseItemHold.js
index e6dbf01c,00000000..f394fd0b
mode 100644,000000..100644
--- a/src/moves/releaseItemHold.js
+++ b/src/moves/releaseItemHold.js
@@@ -1,21 -1,0 +1,21 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by releaseItemHold, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "releaseItemHold", order: 27, engine: 1,
++export default Object.freeze({ operation: "releaseItemHold", order: 29, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "NOT_HELD": "see what is held with pullboard status"
+}) });
diff --cc src/moves/releaseLane.js
index 19a3a795,00000000..3d53664b
mode 100644,000000..100644
--- a/src/moves/releaseLane.js
+++ b/src/moves/releaseLane.js
@@@ -1,22 -1,0 +1,22 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by releaseLane, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.asPerson ? 'person' : move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "releaseLane", order: 25, engine: 1,
++export default Object.freeze({ operation: "releaseLane", order: 27, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "B26_PERSON_CHANNEL": "record it as the person through pullboard view or the person's own terminal",
+ "NOT_HELD": "see what is held with pullboard status"
+}) });
diff --cc src/moves/removeMilestone.js
index 8a6661d9,00000000..4808415a
mode 100644,000000..100644
--- a/src/moves/removeMilestone.js
+++ b/src/moves/removeMilestone.js
@@@ -1,21 -1,0 +1,21 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by removeMilestone, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "removeMilestone", order: 33, engine: 1,
++export default Object.freeze({ operation: "removeMilestone", order: 35, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "NO_MILESTONE": "name a milestone from pullboard roadmap"
+}) });
diff --cc src/moves/reopen.js
index 56467dcc,00000000..6d172ce1
mode 100644,000000..100644
--- a/src/moves/reopen.js
+++ b/src/moves/reopen.js
@@@ -1,50 -1,0 +1,52 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by reopen, discovered without a shared registry edit [C7,V4,H16]. */
+import { itemById } from '../board-item-read.js';
+import {
+ CAUSE_ENGINE,
++ QUOTED_LANDING_FAILURE_ENGINE,
+ REOPEN_FIRST_REFUSAL_ENGINE,
+ SUBMITTED_CONFLICT_ENGINE,
+} from '../engine-metadata.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+import {
+ CONFLICT_ENGINE,
+ carriesConflict,
+} from '../trunk-conflict.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
- if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
++ const quotedLandingFailureEngine = args[1]?.quotedLandingFailure === true ? QUOTED_LANDING_FAILURE_ENGINE : 1;
++ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return Math.max(RIGOR_AUTO_ENGINE, quotedLandingFailureEngine);
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
- if (args[1]?.reopenFirstRefusalMinutes !== undefined) return REOPEN_FIRST_REFUSAL_ENGINE;
- if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
- if (carriesConflict('reopen', args)) return board && itemById(board, args[0])?.item_status === 'submitted' ? SUBMITTED_CONFLICT_ENGINE : CONFLICT_ENGINE;
- if (['cause', 'neverAgain', 'asPerson'].some(name => Boolean(args[1] && typeof args[1] === 'object' && Object.hasOwn(args[1], name) && args[1][name] !== undefined && args[1][name] !== null && args[1][name] !== false))) return CAUSE_ENGINE;
- return 8;
++ if (args[1]?.reopenFirstRefusalMinutes !== undefined) return Math.max(REOPEN_FIRST_REFUSAL_ENGINE, quotedLandingFailureEngine);
++ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return Math.max(BOARD_SENTINEL_ENGINE, quotedLandingFailureEngine);
++ if (carriesConflict('reopen', args)) return Math.max(board && itemById(board, args[0])?.item_status === 'submitted' ? SUBMITTED_CONFLICT_ENGINE : CONFLICT_ENGINE, quotedLandingFailureEngine);
++ if (['cause', 'neverAgain', 'asPerson'].some(name => Boolean(args[1] && typeof args[1] === 'object' && Object.hasOwn(args[1], name) && args[1][name] !== undefined && args[1][name] !== null && args[1][name] !== false))) return Math.max(CAUSE_ENGINE, quotedLandingFailureEngine);
++ return Math.max(8, quotedLandingFailureEngine);
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "reopen", order: 20, engine: 8,
++export default Object.freeze({ operation: "reopen", order: 22, engine: 8,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "ALREADY_MERGED": "file the follow-up as a new item: pullboard add <lane> \"<title>\"",
+ "BAD_CAUSE": "name the cause as test:<file>::<title>, refusal:<CODE>, row:<id> or doctrine:<id>, or leave --cause out",
+ "BAD_CONFIG": "fix pullboard.json as the message says, then commit it: git commit -m \"chore: fix pullboard config\" pullboard.json",
+ "BAD_CONFLICT": "run pullboard reopen <id> --conflict <file> [--conflict <file>] from the main checkout",
+ "CONFLICT_FILES": "name only the files Git reports as conflicting with the trunk: pullboard reopen <id> --conflict <file> [--conflict <file>]",
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
- "LANDING_FAILURE_REQUIRED": "reopen with --note \"<test file>: <test name>; merge commit <sha>\", or with --conflict <file> for each conflicting file when it only conflicts with the trunk",
++ "LANDING_FAILURE_REQUIRED": "reopen with --note \"<test file>: <test name>; merge commit <sha>\", or with --note '<test file>: \"<test name; with semicolon>\"; merge commit <sha>' when the test name contains a semicolon, or use --conflict <file> for each file that only conflicts with the trunk",
+ "MERGE_CHECK_FAILED": "use Git 2.38 or newer (git --version), then retry",
+ "NOTE_REQUIRED": "add --note \"<what happened>\"",
+ "NOT_ACCEPTED": "reopen a submission with --note \"why\"; --conflict is for accepted work",
+ "NOT_CONFLICTING": "merge it; reopen only after a red landing, with --note \"<test file>: <test name>; merge commit <sha>\"",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NOT_SUBMITTED": "see its state with pullboard show <id>; verify only submitted items: pullboard next --verify",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "NO_TRUNK": "in the main checkout, switch to the repository’s trunk branch and run pullboard inbox",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again"
+}) });
diff --cc src/moves/reserveNextReview.js
index 3fb3bccf,00000000..0d1da891
mode 100644,000000..100644
--- a/src/moves/reserveNextReview.js
+++ b/src/moves/reserveNextReview.js
@@@ -1,37 -1,0 +1,37 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by reserveNextReview, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { REVIEW_SKIP_ENGINE } from '../review-skip-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ if (Array.isArray(args[0]?.skipIds) && args[0].skipIds.length) return REVIEW_SKIP_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "reserveNextReview", order: 15, engine: 1,
++export default Object.freeze({ operation: "reserveNextReview", order: 17, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_VERIFIES": "leave the review to the coordinator; shout it when the item is ready: pullboard shout coordinator \"#<id> is ready to verify\"",
+ "LINE_SETTING_RANGE": "read the allowed range with pullboard settings line, then record an in-range value or off with its reason and window numbers",
+ "MAIN_IS_COORDINATOR": "use an independent agent checkout for agent work, or run person-only actions from the main checkout as the coordinator",
+ "MILESTONES_CORRUPT": "restore the board from a known-good export: pullboard import <file>",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NOT_SUBMITTED": "see its state with pullboard show <id>; verify only submitted items: pullboard next --verify",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "O2_FAMILY_MATCH": "ask the coordinator for a verifier from another family: pullboard shout coordinator \"#<id> needs a verifier from another family\"",
+ "REVIEW_COOLDOWN": "take another review: pullboard next --verify",
+ "REVIEW_HELD": "take another review: pullboard next --verify",
+ "ROUTE": "take an item your route covers: pullboard next",
+ "SELF_SESSION_VERIFY": "ask another agent session to verify it: pullboard next --verify from that session's own worktree",
+ "SELF_VERIFY": "ask a different agent to verify it; from main create its worktree with pullboard worktree <lane> --model \"<model name>\"",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again",
+ "VERIFIER_STANDING": "ask the coordinator to make an independent verifier from the main checkout: pullboard worktree <lane> --model \"<model name>\""
+}) });
diff --cc src/moves/reserveReview.js
index e760c68b,00000000..35213efa
mode 100644,000000..100644
--- a/src/moves/reserveReview.js
+++ b/src/moves/reserveReview.js
@@@ -1,35 -1,0 +1,35 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by reserveReview, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "reserveReview", order: 14, engine: 1,
++export default Object.freeze({ operation: "reserveReview", order: 16, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_VERIFIES": "leave the review to the coordinator; shout it when the item is ready: pullboard shout coordinator \"#<id> is ready to verify\"",
+ "LINE_SETTING_RANGE": "read the allowed range with pullboard settings line, then record an in-range value or off with its reason and window numbers",
+ "MAIN_IS_COORDINATOR": "use an independent agent checkout for agent work, or run person-only actions from the main checkout as the coordinator",
+ "MILESTONES_CORRUPT": "restore the board from a known-good export: pullboard import <file>",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NOT_SUBMITTED": "see its state with pullboard show <id>; verify only submitted items: pullboard next --verify",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "O2_FAMILY_MATCH": "ask the coordinator for a verifier from another family: pullboard shout coordinator \"#<id> needs a verifier from another family\"",
+ "REVIEW_COOLDOWN": "take another review: pullboard next --verify",
+ "REVIEW_HELD": "take another review: pullboard next --verify",
+ "ROUTE": "take an item your route covers: pullboard next",
+ "SELF_SESSION_VERIFY": "ask another agent session to verify it: pullboard next --verify from that session's own worktree",
+ "SELF_VERIFY": "ask a different agent to verify it; from main create its worktree with pullboard worktree <lane> --model \"<model name>\"",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again",
+ "VERIFIER_STANDING": "ask the coordinator to make an independent verifier from the main checkout: pullboard worktree <lane> --model \"<model name>\""
+}) });
diff --cc src/moves/setBarReady.js
index 7f3bbf79,00000000..704f2491
mode 100644,000000..100644
--- a/src/moves/setBarReady.js
+++ b/src/moves/setBarReady.js
@@@ -1,19 -1,0 +1,19 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by setBarReady, discovered without a shared registry edit [C7,V4,H16]. */
+import { BAR_READY_ENGINE } from '../bar-ready-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ return BAR_READY_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "setBarReady", order: 2, engine: 1,
++export default Object.freeze({ operation: "setBarReady", order: 4, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "USAGE": "run pullboard help"
+}) });
diff --cc src/moves/setLineSetting.js
index 3b91fbd7,00000000..7fd79e72
mode 100644,000000..100644
--- a/src/moves/setLineSetting.js
+++ b/src/moves/setLineSetting.js
@@@ -1,28 -1,0 +1,28 @@@
+import { LAND_COLLISION_ENGINE } from '../landing-collision-engine.js';
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by setLineSetting, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { LINE_ORDER_ENGINE } from '../line-order-engine.js';
+import { LINE_SETTINGS_ENGINE } from '../line-settings-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.key === 'collisionFreeBatch') return LAND_COLLISION_ENGINE;
+ if (args[0]?.key === 'order') return LINE_ORDER_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return LINE_SETTINGS_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "setLineSetting", order: 51, engine: LINE_SETTINGS_ENGINE,
++export default Object.freeze({ operation: "setLineSetting", order: 53, engine: LINE_SETTINGS_ENGINE,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "LINE_SETTING_REASON": "repeat the board setting change with --reason describing the measured window"
+}) });
diff --cc src/moves/shipMilestone.js
index 105e0b0d,00000000..65702a27
mode 100644,000000..100644
--- a/src/moves/shipMilestone.js
+++ b/src/moves/shipMilestone.js
@@@ -1,25 -1,0 +1,25 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by shipMilestone, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { MILESTONE_SHIP_ENGINE } from '../move-engine-constants.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return MILESTONE_SHIP_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "shipMilestone", order: 34, engine: MILESTONE_SHIP_ENGINE,
++export default Object.freeze({ operation: "shipMilestone", order: 36, engine: MILESTONE_SHIP_ENGINE,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "MILESTONE_COMMIT": "commit to main, then ship from the main checkout: pullboard milestone ship <name>",
+ "MILESTONE_ORDER": "move it before a different milestone; see pullboard roadmap",
+ "NO_MILESTONE": "name a milestone from pullboard roadmap",
+ "NO_NEXT_MILESTONE": "add the next milestone, or name one: pullboard milestone ship <name> --next <milestone>"
+}) });
diff --cc src/moves/shout.js
index 9941e8c2,00000000..52421427
mode 100644,000000..100644
--- a/src/moves/shout.js
+++ b/src/moves/shout.js
@@@ -1,35 -1,0 +1,35 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by shout, discovered without a shared registry edit [C7,V4,H16]. */
+import { ITEM_SHOUT_ENGINE } from '../item-shout-engine.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.item !== undefined) return ITEM_SHOUT_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.from ?? null; }
+
- export default Object.freeze({ operation: "shout", order: 21, engine: 1,
++export default Object.freeze({ operation: "shout", order: 23, engine: 1,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "B26_PERSON_CHANNEL": "record it as the person through pullboard view or the person's own terminal",
+ "B26_PERSON_DECISION": "ask your coordinator: pullboard shout coordinator \"<question>\" --decision",
+ "BAD_EVIDENCE": "pass the evidence fields the message names, then retry",
+ "BAD_REQUEST": "send the request body the message names as an application/json object",
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "EMPTY_SHOUT": "give the shout text: pullboard shout <to> \"<text>\"",
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "NOT_A_DECISION": "reply with a shout: pullboard shout <to> \"<text>\"",
+ "NO_READER": "name a lane, an agent or all: pullboard shout all \"<text>\"",
+ "NO_SHOUT": "name a shout id from pullboard inbox",
+ "REQUEST_CLOSED": "read pullboard inbox before answering another request",
+ "REQUEST_OUTCOME": "pullboard answer <id> done \"<reason>\", or pullboard answer <id> declined \"<reason>\"",
+ "SELF_SHOUT": "name another agent, a lane or all: pullboard shout all \"<text>\""
+}) });
diff --cc src/moves/signBar.js
index b61488a3,00000000..278005af
mode 100644,000000..100644
--- a/src/moves/signBar.js
+++ b/src/moves/signBar.js
@@@ -1,23 -1,0 +1,23 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by signBar, discovered without a shared registry edit [C7,V4,H16]. */
+import { BAR_READY_ENGINE } from '../bar-ready-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ return BAR_READY_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "signBar", order: 3, engine: 1,
++export default Object.freeze({ operation: "signBar", order: 5, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "BAR_NOT_READY": "read pullboard bar <id>; ask its author to complete the named red baseline and measurement/edge notes, then have an outside parent session sign the current bar",
+ "BAR_PARENT_UNKNOWN": "join a fresh worktree from the current native session with its real parent; an outside session must sign a bar whose author identities are known",
+ "BAR_SELF_SIGN": "ask a different parent session to review the current bar and run pullboard bar sign <id> --note \"...\"",
+ "BAR_SIGN_STALE": "read pullboard show <id> and pullboard bar <id> again, then sign the current revision with current coverage evidence",
+ "CLOSED": "read its state with pullboard show <id>, then take open work: pullboard next",
+ "NOTE_REQUIRED": "add --note \"<what happened>\""
+}) });
diff --cc src/moves/submit.js
index 255ee3b7,00000000..cef18ca0
mode 100644,000000..100644
--- a/src/moves/submit.js
+++ b/src/moves/submit.js
@@@ -1,77 -1,0 +1,77 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by submit, discovered without a shared registry edit [C7,V4,H16]. */
+import { BAR_READY_ENGINE } from '../bar-ready-engine.js';
+import { barReadySetting } from '../bar-ready-setting.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { OUTSIDE_INTAKE_ENGINE } from '../outside-intake-engine.js';
+import { outsideSource } from '../outside-source.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+import {
+ SUBMISSION_PROOF_ENGINE,
+ submissionProof,
+} from '../submit-invariants.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function existingEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (board && barReadySetting(board).enabled) return BAR_READY_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ if (args[1]?.submissionProof !== undefined) return SUBMISSION_PROOF_ENGINE;
+ return 1;
+}
+/** Keep outside-source isolation as the original maximum over the older engine rule. */
+function minimumEngine(args, board, at) {
+ const outside = board && Boolean(outsideSource(board, args[0]));
+ return Math.max(outside ? OUTSIDE_INTAKE_ENGINE : 1, existingEngine(args, board, at));
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "submit", order: 13, engine: 1,
++export default Object.freeze({ operation: "submit", order: 15, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "A5_GRAMMAR_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "BAD_CONFIG": "fix pullboard.json as the message says, then commit it: git commit -m \"chore: fix pullboard config\" pullboard.json",
+ "BAR_NOT_READY": "read pullboard bar <id>; ask its author to complete the named red baseline and measurement/edge notes, then have an outside parent session sign the current bar",
+ "CHILDREN_OPEN": "finish the child items (pullboard list --all), or ask the coordinator to withdraw them",
+ "CRITERIA_CHANGED": "ask the coordinator to refreeze it: pullboard shout coordinator \"please refreeze #<id>\"",
+ "CRITERION_PROVES_NOTHING": "set a check that fails before the work: pullboard edit <id> --check \"<command>\", or ask the person to accept this one: pullboard check accept <id>",
+ "DIRTY": "commit your changes, then run the command again",
+ "GATE_RED": "fix what the gate report names, commit, and submit again",
+ "GIT_GRAFTS": "ask the coordinator to remove the git graft file: pullboard shout coordinator \"please remove .git/info/grafts\"",
+ "HEAD_NOT_NEW": "commit the rework, then pullboard submit <id>",
+ "HOST_NAME": "reword the named commit's message without this machine's name (git rebase -i, then reword), then run pullboard submit <id> again",
+ "INFRA_NOTE_REQUIRED": "run pullboard submit <id> --infra \"<why>\" with the reason the edit to an existing test or gate file is needed",
+ "ITEM_LEASE_LOST": "read pullboard show <id>; if the item is free, claim it again for a build or reserve it with pullboard next --verify <id> for a review, then retry",
+ "LAND_GATE_OUTPUT": "inspect the retained timed gate output directory and free disk space, then start another landing",
+ "LAND_TIMEOUT_CUSTODY": "inspect the saved timed gate cleanup state and stop only its proven owned processes before starting another landing",
+ "MAIN_NOT_COMPOSED": "merge current main into the candidate, commit the composition and submit again; for an unrecorded recovered move, run pullboard inbox first or ask the coordinator to resolve the pending receipt",
+ "MERGE_CHECK_FAILED": "use Git 2.38 or newer (git --version), then retry",
+ "MERGE_CONFLICT": "merge main into your branch, resolve the conflicts, commit, and run the command again",
+ "MOVED_DURING_GATE": "leave the worktree alone until the gate finishes, then submit again",
+ "NOT_A_REPO": "cd into a git repo, or make one: git init",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NOT_YOURS": "shout its holder or the coordinator: pullboard shout coordinator \"<what you need>\"",
+ "NO_COMMIT": "commit your work, or name a commit that exists: git log --oneline",
+ "NO_CONFIG": "run pullboard init in the main checkout and commit pullboard.json",
+ "NO_GATE": "in the main checkout, run pullboard gate set \"<project test command>\", then commit pullboard.json",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "NO_POLICY": "restore and commit pullboard.json, then run the command again",
+ "NO_TRUNK": "in the main checkout, switch to the repository’s trunk branch and run pullboard inbox",
+ "OUTSIDE_LANE": "move those changes out of this commit, and shout the lane that owns them: pullboard shout <lane> \"<text>\"",
+ "PENDING_REFREEZE": "the coordinator runs pullboard refreeze <id>",
+ "PIPEFAIL_UNAVAILABLE": "rewrite the gate in pullboard.json without a pipe",
+ "RATCHET_ROSE": "fix the new doctrine problems named in the report, commit, and submit again; only the person can sign an increased count",
+ "RATCHET_UNCOUNTED": "fix the named doctrine check to exit zero or one within its configured timeout, or ask the coordinator to repair it, then submit again",
+ "RUNNER_BROWSER_SLOT_REQUIRED": "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",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again",
+ "SLOT_DB_LOCKED": "the run never started, so it is not a red; rerun the same command once the named process releases the slot database",
+ "SPEC_BEHIND_MAIN": "git merge main",
+ "STACKED_ON_UNVERIFIED": "wait for the earlier item to be accepted, or rebuild on main without its commits",
+ "SUBMISSION_PROOF": "rerun pullboard submit <id> with the current CLI so its selected files and fallback are recorded",
+ "TIMING_SLOT_REQUIRED": "start the timing check outside its inherited ordinary lease and acquire the machine gate with timing true",
+ "UNTRACKED": "commit or ignore the untracked files, then run the command again",
+ "USAGE": "run pullboard help"
+}) });
diff --cc src/moves/takeCoordinator.js
index 01f74cae,00000000..fb5ad5b0
mode 100644,000000..100644
--- a/src/moves/takeCoordinator.js
+++ b/src/moves/takeCoordinator.js
@@@ -1,23 -1,0 +1,23 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by takeCoordinator, discovered without a shared registry edit [C7,V4,H16]. */
+import { COORDINATOR_HOLD_ENGINE } from '../coordinator-hold-engine.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return COORDINATOR_HOLD_ENGINE;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[0]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "takeCoordinator", order: 56, engine: COORDINATOR_HOLD_ENGINE,
++export default Object.freeze({ operation: "takeCoordinator", order: 58, engine: COORDINATOR_HOLD_ENGINE,
+ itemIdFirstArgument: false, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "COORDINATOR_TAKEOVER": "link the board with pullboard relay on in the main checkout, then run pullboard takeover there"
+}) });
diff --cc src/moves/takeHandoff.js
index 00000000,00000000..c3aaa1c5
new file mode 100644
--- /dev/null
+++ b/src/moves/takeHandoff.js
@@@ -1,0 -1,0 +1,8 @@@
++/** Routing metadata for accepted handoff moves [B3,N19,H16,C7]. */
++import { HANDOFF_ENGINE } from '../handoff-engine.js';
++/** Accepted handoff operations require their feature engine before all older conditions. */
++function minimumEngine() { return HANDOFF_ENGINE; }
++/** Both accepted handoff operations name their actor in their first options argument. */
++function actor(move) { return move.args[0]?.agentId ?? null; }
++export default Object.freeze({ operation: "takeHandoff", order: 1, engine: HANDOFF_ENGINE,
++ itemIdFirstArgument: false, minimumEngine, actor, nextSteps: Object.freeze({}) });
diff --cc src/moves/verify.js
index f82dbc4a,00000000..e40732d2
mode 100644,000000..100644
--- a/src/moves/verify.js
+++ b/src/moves/verify.js
@@@ -1,98 -1,0 +1,98 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by verify, discovered without a shared registry edit [C7,V4,H16]. */
+import {
+ CAUSE_ENGINE,
+ REOPEN_FIRST_REFUSAL_ENGINE,
+ VERDICT_REVIEW_ENGINE,
+} from '../engine-metadata.js';
+import { LANDING_ENVIRONMENT_ENGINE } from '../landing-environment-engine.js';
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { IMPLIES_ENGINE } from '../move-engine-constants.js';
+import { carriesImplies } from '../move-implies.js';
+import { OUTSIDE_INTAKE_ENGINE } from '../outside-intake-engine.js';
+import { outsideSource } from '../outside-source.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function existingEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[1]?.environment !== undefined) return LANDING_ENVIRONMENT_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (args[1]?.reopenFirstRefusalMinutes !== undefined) return REOPEN_FIRST_REFUSAL_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ if (args[1] && Object.hasOwn(args[1], 'review')) return VERDICT_REVIEW_ENGINE;
+ if (['cause', 'neverAgain', 'asPerson'].some(name => Boolean(args[1] && typeof args[1] === 'object' && Object.hasOwn(args[1], name) && args[1][name] !== undefined && args[1][name] !== null && args[1][name] !== false))) return CAUSE_ENGINE;
+ if (carriesImplies('verify', args)) return IMPLIES_ENGINE;
+ return 1;
+}
+/** Keep outside-source isolation as the original maximum over the older engine rule. */
+function minimumEngine(args, board, at) {
+ const outside = args[1]?.sandbox !== undefined || board && Boolean(outsideSource(board, args[0]));
+ return Math.max(outside ? OUTSIDE_INTAKE_ENGINE : 1, existingEngine(args, board, at));
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "verify", order: 16, engine: 1,
++export default Object.freeze({ operation: "verify", order: 18, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "A5_GRAMMAR_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "ALREADY_MERGED": "file the follow-up as a new item: pullboard add <lane> \"<title>\"",
+ "BAD_CAUSE": "name the cause as test:<file>::<title>, refusal:<CODE>, row:<id> or doctrine:<id>, or leave --cause out",
+ "BAD_CONFIG": "fix pullboard.json as the message says, then commit it: git commit -m \"chore: fix pullboard config\" pullboard.json",
+ "BAD_DECISION": "choose accept or reject with a supported reason: pullboard verify <id> reject --reason TEST_FAILURE --note \"<what failed>\"",
+ "BAD_REASON": "accept with --note \"how you proved it\", or reject with --reason TEST_FAILURE, BEHAVIOR_MISMATCH, INSUFFICIENT_EVIDENCE, STALE_HEAD or OTHER",
+ "BAD_VERDICT_REVIEW": "restore the submitted commit and reviewed Git objects, then re-review the clean composition with current Pullboard",
+ "CHECK_NO_PROOF": "strengthen the trusted criterion so it fails before the outside change, then ask the coordinator to refreeze it",
+ "CHECK_RED": "reject with what failed: pullboard verify <id> reject --reason TEST_FAILURE --note \"<what failed>\"",
+ "CHECK_UNVERIFIED": "restore the install or check environment, then run pullboard verify <id> again",
+ "CLOSED": "read its state with pullboard show <id>, then take open work: pullboard next",
+ "COORDINATOR_VERIFIES": "leave the review to the coordinator; shout it when the item is ready: pullboard shout coordinator \"#<id> is ready to verify\"",
+ "CRITERIA_CHANGED": "ask the coordinator to refreeze it: pullboard shout coordinator \"please refreeze #<id>\"",
+ "DIRTY": "commit your changes, then run the command again",
+ "ENGINE_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "GIT_GRAFTS": "ask the coordinator to remove the git graft file: pullboard shout coordinator \"please remove .git/info/grafts\"",
+ "GUARD_CANNOT_FAIL": "reject: the check does not test the guard; ask for one that fails with the guard reverted: pullboard verify <id> reject --reason TEST_FAILURE --note \"<what the check missed>\"",
+ "GUARD_NOT_FOUND": "reject: the named guard is not in the submitted commit; fix the guard line in the criterion with the coordinator: pullboard shout coordinator --decision \"<id> guard does not match the commit\"",
+ "ITEM_LEASE_LOST": "read pullboard show <id>; if the item is free, claim it again for a build or reserve it with pullboard next --verify <id> for a review, then retry",
+ "LAND_HEADER": "shorten the item's cited rows (pullboard edit <id>), then pullboard land",
+ "MAIN_IS_COORDINATOR": "use an independent agent checkout for agent work, or run person-only actions from the main checkout as the coordinator",
+ "MERGE_CHECK_FAILED": "use Git 2.38 or newer (git --version), then retry",
+ "MERGE_CONFLICT": "merge main into your branch, resolve the conflicts, commit, and run the command again",
+ "NOTE_REQUIRED": "add --note \"<what happened>\"",
+ "NOT_AT_COMMIT": "check out the submitted commit shown by pullboard show <id>: git switch --detach <commit>",
+ "NOT_A_REPO": "cd into a git repo, or make one: git init",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NOT_SUBMITTED": "see its state with pullboard show <id>; verify only submitted items: pullboard next --verify",
+ "NOT_YOURS": "shout its holder or the coordinator: pullboard shout coordinator \"<what you need>\"",
+ "NO_CONFIG": "run pullboard init in the main checkout and commit pullboard.json",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "NO_POLICY": "restore and commit pullboard.json, then run the command again",
+ "NO_TRUNK": "in the main checkout, switch to the repository’s trunk branch and run pullboard inbox",
+ "O2_FAMILY_MATCH": "ask the coordinator for a verifier from another family: pullboard shout coordinator \"#<id> needs a verifier from another family\"",
+ "OUTSIDE_LANE": "move those changes out of this commit, and shout the lane that owns them: pullboard shout <lane> \"<text>\"",
+ "OUTSIDE_SANDBOX_REQUIRED": "read the exact PR diff, then run pullboard verify <id> accept --sandbox with the configured container provider",
+ "PROOF_REQUIRED": "say how you proved it: --note \"what you broke or which edge you tried, and what happened\"",
+ "REVIEW_HELD": "take another review: pullboard next --verify",
+ "ROUTE": "take an item your route covers: pullboard next",
+ "SANDBOX_CHECK_REQUIRED": "set a trusted full gate and frozen causal criterion before intake",
+ "SANDBOX_CLEANUP_REQUIRED": "restore Docker and remove the exact named owned container before another verification",
+ "SANDBOX_EXECUTION": "restore the Docker daemon and inspect the named owned container before another verification",
+ "SANDBOX_EXPORT": "restore Git access to the exact recorded commit and independent private export before verifying",
+ "SANDBOX_IMAGE_REQUIRED": "preload the exact configured digest in the configured Docker daemon; verification does not pull automatically",
+ "SANDBOX_PROVIDER_REQUIRED": "commit sandbox.provider docker with an absolute executable, explicit Unix endpoint and pinned minimum/current images in trusted main pullboard.json",
+ "SANDBOX_RUNTIME": "correct the pinned official image so its actual Linux Node environment matches the configured minimum/current role",
+ "SELF_SESSION_VERIFY": "ask another agent session to verify it: pullboard next --verify from that session's own worktree",
+ "SELF_VERIFY": "ask a different agent to verify it; from main create its worktree with pullboard worktree <lane> --model \"<model name>\"",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again",
+ "SLOT_DB_LOCKED": "the run never started, so it is not a red; rerun the same command once the named process releases the slot database",
+ "SPEC_BEHIND_MAIN": "git merge main",
+ "STACKED_ON_UNVERIFIED": "wait for the earlier item to be accepted, or rebuild on main without its commits",
+ "STALE_VERDICT": "merge current main into the submitted commit, commit a clean composition, then ask another agent to re-review it before landing",
+ "TIMING_SLOT_REQUIRED": "start the timing check outside its inherited ordinary lease and acquire the machine gate with timing true",
+ "UNTRACKED": "commit or ignore the untracked files, then run the command again",
+ "VERDICT_ENVIRONMENT": "run the frozen check with current Pullboard, then have an independent reviewer record a fresh verdict with its actual executor environment",
+ "VERDICT_TRUNK_MOVED": "merge the latest main into the submitted commit and ask another agent to re-review the clean composition",
+ "VERIFIER_STANDING": "ask the coordinator to make an independent verifier from the main checkout: pullboard worktree <lane> --model \"<model name>\""
+}) });
diff --cc src/moves/withdraw.js
index 9142b65a,00000000..7bc2574c
mode 100644,000000..100644
--- a/src/moves/withdraw.js
+++ b/src/moves/withdraw.js
@@@ -1,26 -1,0 +1,26 @@@
+import { RIGOR_AUTO_ENGINE } from '../rigor-auto-engine.js';
+/** Routing metadata owned by withdraw, discovered without a shared registry edit [C7,V4,H16]. */
+import { LANDING_LEASE_ENGINE } from '../landing-lease-engine.js';
+import { BOARD_SENTINEL_ENGINE } from '../sentinel-engine.js';
+
+/** Preserve this operation's historical first-matching engine conditions [H16]. */
+function minimumEngine(args, board, at) {
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:')) return RIGOR_AUTO_ENGINE;
+ if (args[0]?.landingFence !== undefined) return LANDING_LEASE_ENGINE;
+ if (typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:')) return BOARD_SENTINEL_ENGINE;
+ return 1;
+}
+
+/** Read precisely the actor argument used by this operation [H2,H16]. */
+function actor(move) { return move.args[1]?.agentId ?? null; }
+
- export default Object.freeze({ operation: "withdraw", order: 18, engine: 1,
++export default Object.freeze({ operation: "withdraw", order: 20, engine: 1,
+ itemIdFirstArgument: true, minimumEngine, actor,
+ nextSteps: Object.freeze({
+ "CLOSED": "read its state with pullboard show <id>, then take open work: pullboard next",
+ "COORDINATOR_ONLY": "ask the coordinator to do it: pullboard shout coordinator \"<what you need>\"",
+ "NOTE_REQUIRED": "add --note \"<what happened>\"",
+ "NOT_JOINED": "join a lane from this worktree: pullboard join <lane> --model \"<model name>\" (see: pullboard lanes)",
+ "NO_ITEM": "find the item id: pullboard list --all",
+ "SESSION_LEDGER": "make the agent-session ledger named in the message writable by this user, then run the command again"
+}) });
diff --cc src/next-step-defaults.js
index 228c81d3,00000000..f83db823
mode 100644,000000..100644
--- a/src/next-step-defaults.js
+++ b/src/next-step-defaults.js
@@@ -1,380 -1,0 +1,385 @@@
+/** General CLI recovery text; operation-owned codes live in src/moves/ [P4,C7]. */
+export const DEFAULT_NEXT_STEPS = Object.freeze({
++ "NESTED_RUN_HANDLE_REQUIRED": "pass the original ChildProcess or fixture promise retaining .child to awaitNestedRun",
++ "NESTED_RUN_OFFER_REQUIRED": "start the child with the current spawn export after test-file token admission, then await its original handle",
++ "NESTED_RUN_WAIT_REUSED": "await the original returned wait; do not lend the same child a second time",
++ "NESTED_RUN_WAIT_ACTIVE": "finish the active yielding wait before lending this test file token to another child",
++
+ "RUNNER_GUI_SESSION_REQUIRED": "nothing to do: the run reruns locally; log in to a GUI session on the runner before sending GUI-marked files there",
+ "OUTSIDE_NATIVE_BUILD": "the outside author revises the PR; ask the coordinator to return it, then intake its new exact head",
+ "OUTSIDE_URL": "use a GitHub issue or pull request URL with owner/repository and its positive number",
+ "OUTSIDE_FETCH": "restore read-only gh API and Git fetch access, then intake the exact source again",
+ "OUTSIDE_HEAD_CHANGED": "ask the coordinator to reopen the old outside submission before intaking its new exact head",
+ "OUTSIDE_OWNER_APPROVAL": "the owner runs pullboard intake approve <id> from the person terminal or view",
+ "LINE_SETTING_UNKNOWN": "read pullboard settings line and choose a listed board control",
+ "LINE_SETTING_WINDOW": "repeat the board setting change with --window containing a nonempty JSON object of finite nonnegative measurements or null for unknown",
+ "PERSON_ENROLL_AUTH": "authenticate a fresh enrollment with the locally trusted person credential",
+ "PERSON_ENROLL_EXPIRED": "create a fresh person-authenticated challenge valid for at most ten minutes",
+ "PERSON_ENROLL_REVOKED": "authenticate a different non-revoked device with the person credential",
+ "PERSON_ENROLL_ACCOUNT": "sign in to the exact account named in the person challenge",
+ "PERSON_ENROLL_MISSING": "use this account’s own person-authenticated enrollment",
+ "PERSON_ENROLL_REPLAY": "create a fresh one-time person challenge; do not reuse the consumed nonce",
+ "PERSON_ENVELOPE_AUTH": "use the original independently retained person material and exact account envelope context",
+ "PUBLISH_GITHUB": "inspect gh auth status and the configured GitHub remote, then publish again",
+ "PUBLISH_STATE": "preserve publish-pr.json and ask the coordinator to recover its recorded PR identities",
+ "PUBLISH_UNPROVEN": "restore the item’s acceptance at its exact submitted commit before publishing",
+ "PUBLISH_COMPOSITION": "compose the accepted work with the actual remote base, resolve conflicts normally, then publish",
+ "ACCOUNT_STORAGE_LIMIT": "remove an unneeded relay copy through the approved phone flow, or ask the relay operator to increase the account quota; uploads resume when space is available",
+ "BAD_PAGE": "retry the saved upload with a current linked CLI; send only its original bounded encrypted objects",
+ "BAD_PAGE_PATH": "refresh the board on the phone, then follow the encrypted references from its new read pin",
+ "BAD_SENDER": "use the authenticated board credential belonging to the acting person, machine or agent, then retry",
+ "BAD_SEQUENCE": "refresh the relay head and retry the saved operation at its declared coverage sequence; keep the durable pending record",
+ "FLAKE_EVIDENCE": "retain the original gate log, timing profile and pinned source; ask the coordinator to repair the failure-evidence recorder before recording again",
+ "GATE_RUN_EVIDENCE": "run the gate again from a clean, committed checkout so the run can name its tree, its failing test ids and the host load",
+ "GATE_RUN_UNBOUND": "run the gate on this machine; it stores its own receipt and records its runs itself, and a run written by hand never counts",
+ "CI_RESULT": "save each CI attempt as a ci-result.json manifest beside its TAP file (provider, run, attempt, job, runner, node, commit, root, conclusion, at, tap), then run pullboard flakes import <folder> again",
+ "CI_COMMIT_UNKNOWN": "fetch the CI commit into this checkout with git fetch origin <commit>, then run pullboard flakes import <folder> again",
+ "HEALTH_FINDINGS": "run pullboard health to read the current findings, then run pullboard sentinel run to record a fresh observation",
+ "AGENT_SESSION": "run pullboard takeover from the agent session that should own this checkout",
+ "AMBIGUOUS": "name the code with an explicit line range: path:line-line@commit",
+ "API_ORIGIN": "call the API from the address pullboard serve printed",
+ "API_LISTEN": "choose a free port with --port 0, then retry pullboard serve",
+ "API_POLL": "pass a poll interval from 10 to 60000 milliseconds",
+ "APPROVED_ROW_CHANGE": "restore the committed file: git checkout HEAD -- <file>",
+ "AUTH_REQUIRED": "run pullboard relay on to sign in again, or use the address and secret pullboard serve printed",
+ "BAD_BOARD": "run the command from the board's own repo, where pullboard status names its board id",
+ "BAD_BROWSER_RESOURCE": "request the \"gate\" resource with browser: true",
+ "CHECK_MASKS_EXIT": "set the check to run its proof alone, or capture the output first and test it, then retry: pullboard edit <id> --check \"<command>\"",
+ "BAD_SETTINGS": "restore the named setting to its documented type in its source file, then retry GET /api/v1/settings",
+ "BAD_CURSOR": "pass a nonnegative integer from the last response you received",
+ "BAD_DEPENDENCIES": "use --after with item ids, such as --after 1,2, or --after none",
+ "BAD_FACT_REF": "cite code as path:line[-line]@<full 40-character commit>, from git rev-parse HEAD",
+ "BAD_FIRST_COMMIT": "commit the repository first, then run pullboard spec signers add",
+ "BAD_LANE": "choose a lane name made of lowercase letters, digits and dashes, then retry pullboard lane add",
+ "BAD_LANE_PATH": "give pullboard lane add a folder path inside the repository, relative to its root",
+ "BAD_GATE_SLOTS": "choose a positive gateSlots value no lower than browserSlots shown by pullboard settings: pullboard settings gateSlots <n>",
+ "BAD_SHORT_SLOTS": "choose gate.shortSlots as a whole number, 0 or more (0 turns short slots off): pullboard settings gate.shortSlots <n>",
+ "BAD_SHORT_SLOT_REQUEST": "ask for a short slot only from a machine gate run that names its test files; landings and diagnostics use ordinary gate slots",
+ "BAD_BROWSER_SLOTS": "choose browserSlots from 1 through gateSlots shown by pullboard settings: pullboard settings browserSlots <n>",
+ "BAD_MACHINE_SETTINGS": "fix or remove the machine settings file the message names, then run pullboard settings",
+ "MACHINE_HOME_NOT_WRITABLE": "give the agent write access to the named machine-home directory, or run the command outside the sandbox",
+ "BAD_REF": "name the code as path:line-line@commit using a full 40-character commit SHA, such as src/serve.js:12-30@<full-sha>",
+ "BAD_BLUEPRINT": "fix the blueprint JSON fields named in the message, then run pullboard blueprint add <file> again",
+ "BAD_REMOTE_RESOURCE": "request remote execution through the machine gate with name: \"gate\"",
+ "BAD_RUNNER": "run pullboard runner add <ssh-host> --slots <positive-count> --browser <count-from-zero-through-slots>; remote node and root overrides must be absolute paths",
+ "BAD_RUNNER_POOL": "fix runnerProvider to return an array of unique hosts with positive slots and browser capacity from zero through slots",
+ "BAD_RUNNER_SETTINGS": "pass updateRunnerSettings a nonempty configured host and a function that persists its settings",
+ "BAD_RESOURCE_CAPACITY": "pass a positive integer capacity",
+ "BAD_RESOURCE_METADATA": "pass the resource item and kind as text",
+ "BAD_RESOURCE_NAME": "pass a nonempty resource name",
+ "BAD_RESOURCE_PRIORITY": "request the slot as one kind: a landing, an item check or a diagnostic",
+ "BAD_RESOURCE_SCOPE": "use the machine or repo scope",
+ "BAD_PARENT": "join again with --parent <stable-session-id> from your own runtime session",
+ "BAD_SEAT_ID": "create the seat again from the same checkout without naming it, so Pullboard picks the next free name: pullboard worktree <lane> --model \"<model name>\"",
+ "BAD_SIGNATURE": "make sure the signer is listed, then record a fresh sign-off: pullboard spec signoff <ids>",
+ "BAD_SIGNER": "set git config user.email, or pass --by <principal>",
+ "BAD_SIGNERS_BASE": "restore .pullboard/signers.initial and its hash from git: git checkout HEAD -- .pullboard",
+ "BAD_SIGNOFF": "sign the current approved rows from this repository: pullboard spec signoff <ids>",
+ "BAD_SIGNOFFS": "restore the sign-off file from git: git checkout HEAD -- .pullboard/signoffs.jsonl",
+ "BAD_SINCE": "pass a date: --since 2026-10-08",
+ "BLUEPRINT_EXISTS": "choose a file that does not exist: pullboard blueprint save <new-file>",
+ "BLUEPRINT_ITEM_UNCHECKED": "give the starter item named in the message a criterion and a check command, then run pullboard blueprint add <file> again",
+ "BLUEPRINT_KIND_TAKEN": "keep at most one product and one architecture blueprint, then run the same command again",
+ "BLUEPRINT_NOT_ADDED": "add the blueprint to this board first: pullboard blueprint add <name or file>",
+ "BLUEPRINT_NO_SOURCE": "give the rule named in the message the reference it paraphrases as source { name, id, url }, then run pullboard blueprint add <file> again",
+ "BLUEPRINT_URL": "download and read the blueprint yourself, then run pullboard blueprint add <local-file>",
+ "BOARD_BUSY": "wait for the other pullboard process to finish, then retry",
+ "BOARD_NOT_WRITABLE": "give the agent write access to the repo's .git/pullboard folder, or run the command outside the sandbox",
+ "BOARD_SCHEMA_BEHIND": "run a command that changes the board, such as pullboard shout or pullboard add, which upgrades it; then run this again",
+ "BOARD_SCOPE_UNAVAILABLE": "link the board: pullboard relay on",
+ "BOARD_UNAVAILABLE": "restore the repo, or drop it: pullboard forget <path>",
+ "BRIEF_LANE": "split the item by lane, or add the other lane's part as its own item and wait on it with --after",
+ "BRIEF_TOO_LONG": "shorten the brief and point to a longer doc by path, or pass --brief-file <file>",
+ "BROWSER_SLOT_REQUIRED": "release the gate lease and take it again with browser: true",
+ "RUNNER_CAPACITY_BUSY": "nothing to do on that runner: rerun once its running jobs end, and it runs at its new registered size",
+ "CANNOT_SIGN": "sign only approved rows: pullboard spec signoff <approved ids>",
+ "CHECKOUT_SESSION": "run pullboard takeover from the agent session that owns this checkout",
+ "CHECKOUT_BUSY": "let the named command finish, or stop it if it is stuck, then commit again",
+ "CHECK_SYNTAX": "close the quote the shell names, then set the check again: inside single quotes write an apostrophe as '\\'' or match it with ., and test with sh -n -c \"<command>\"",
+ "CHECK_CANNOT_FAIL": "write a check that exits nonzero on the problem, then add the item again",
+ "CHECK_CONFIRM": "read the check command, then run pullboard check <id> --yes",
+ "CODE_NOT_AVAILABLE": "read code through pullboard view or a local pullboard serve",
+ "COMMAND_FAILED": "read the reported output above, fix what it names, and run the command again",
+ "CORE_BARE": "turn off core.bare: git config core.bare false",
+ "COORDINATOR_HELD": "coordinate from the main checkout the refusal names, or run pullboard takeover in this main checkout to take the coordinator here",
+ "DELTA_NOT_AVAILABLE": "read the full board state from this API instead of since=N",
+ "DEPENDENCY_CYCLE": "change --after so no item waits on itself",
+ "DEVICE_ACCOUNT": "run pullboard relay revoke <device> again and sign in to the GitHub account that paired the device",
+ "DEVICE_CRYPTO": "use Node 22 or newer, or a browser on a secure (https) page",
+ "DEVICE_ENDPOINT": "upgrade Pullboard on this machine and the phone, then retry",
+ "DEVICE_ENROLLMENT": "make a fresh pairing link: pullboard relay on --all",
+ "DEVICE_ENROLL_AUTH": "make a fresh pairing link: pullboard relay on --all",
+ "DEVICE_EXISTS": "make a fresh pairing link: pullboard relay on --all",
+ "DEVICE_FORMAT": "make a fresh pairing link: pullboard relay on --all",
+ "DEVICE_ID": "list paired devices with pullboard relay devices and name one of them",
+ "DEVICE_KEY": "pair the device again: pullboard relay on --all",
+ "DEVICE_NOT_ENROLLED": "list paired devices with pullboard relay devices, or pair one: pullboard relay on --all",
+ "DEVICE_PAIR_EXPIRED": "make a fresh pairing link: pullboard relay on --all",
+ "DEVICE_PAIR_SECRET": "open the pairing link exactly as printed, or make a fresh one: pullboard relay on --all",
+ "DEVICE_PAIR_USED": "make a fresh pairing link: pullboard relay on --all",
+ "DEVICE_REVOKED": "pair the device again: pullboard relay on --all",
+ "DEVICE_REVOKE_CANCELLED": "run pullboard relay revoke <device> again when ready and complete the fresh GitHub sign-in",
+ "DEVICE_WRAP_AUTH": "pair the device again: pullboard relay on --all",
+ "DEVICE_WRAP_BINDING": "upgrade Pullboard, then pair the device again: pullboard relay on --all",
+ "DEVICE_WRAP_KEY": "pair the device again: pullboard relay on --all",
+ "DIFF_TOO_LARGE": "split the change into smaller commits",
+ "DIGEST_SIZE": "shout the coordinator with the board size: pullboard shout coordinator \"digest outgrew 50 KB\"",
+ "DIGEST_WRITE": "choose a writable file outside .git: pullboard digest --out briefing.md",
+ "EMPTY_BLUEPRINT": "ask the person to approve exportable rows written as \"<rule> Why: <reason>\", then run pullboard blueprint save again",
+ "FIT_CHANGED": "read the batch again with pullboard spec fit, then approve it with the batch code it prints: pullboard spec fit approve <batch>",
+ "FIT_READING": "read the batch again with pullboard spec fit, then approve it with the batch code it prints: pullboard spec fit approve <batch>",
+ "FIT_FILE": "restore or remove .git/pullboard/blueprint-fit.json, then have the seat record its proposals again with pullboard blueprint fit",
+ "FIT_OWN_PROPOSAL": "ask the person to approve the batch: pullboard spec fit approve <batch>",
+ "FIT_PROPOSAL": "retry with keep, adapt --text \"<new text>\" --reason \"why\", drop --reason \"why\", or answer --text \"<choice>\"",
+ "FIT_STALE": "read what is left with pullboard spec fit, then approve it with the batch code it prints: pullboard spec fit approve <batch>",
+ "FIT_TARGET": "pick a target the message lists, or read the waiting batch with pullboard spec fit",
+ "NO_FIT_PROPOSALS": "have a seat record proposals with pullboard blueprint fit <name or file> <target> keep|adapt|drop|answer",
+ "BAD_SHOUT_ITEM": "name an existing positive item: pullboard shout --item <id> \"<text>\"",
+ "EMPTY_SIGNERS": "restore the signer list from Git: git restore --source=HEAD -- .pullboard/signers",
+ "EVENT_LOG_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "EXPORT_EXISTS": "name an empty folder for the export",
+ "FLAG_NOT_ALLOWED": "drop the flag; pullboard help spec lists what each spec command takes",
+ "GATE_ARGUMENT": "use pullboard resources for status, or pullboard gate with no extra words to run the gate",
+ "GATE_SLOT_LEASE_LOST": "let the parent process take the gate slot again, then restart the child",
+ "GATE_SLOT_LEASE_REQUIRED": "start the child test process with the live gate lease",
+ "GATE_SLOT_MARKER_INVALID": "restart the child with gateSlotEnvironment(lease)",
+ "GATE_SLOT_TOKEN_REQUIRED": "restart the child with gateSlotEnvironment(lease)",
+ "NO_SNAPSHOT": "run pullboard relay from the linked computer to publish its saved snapshot, then refresh the phone",
+ "RELAY_API_VERSION": "upgrade Pullboard on every joined computer and the configured relay before retrying; keep the local board and pending data",
+ "RELAY_CLOCK": "ask the relay operator to restore a valid service clock, then retry the saved upload or read",
+ "RELAY_CLOSED": "restart the relay service before retrying the saved operation",
+ "RELAY_CONFIG": "ask the relay operator to repair the named service setting and restart; retain the local board and pending upload",
+ "RELAY_PAGE_CACHE": "close other local Pullboard commands, then restore the private relay-pages cache permissions or remove only that device cache and retry; keep the board, relay link and key",
+ "SHORT_SLOT_FULL_SUITE": "run the whole suite outside the short check, where it queues for an ordinary gate slot; short slots are only for runs that name their test files",
+ "HUMAN_REQUIRED": "send it from the paired phone, or run pullboard relay on --all from the person's terminal",
+ "IMPORT_FORMAT": "make an export with pullboard export > board.json, then import that file",
+ "IMPORT_NOT_EMPTY": "import into a fresh repo whose board is empty: git init <dir> && cd <dir> && pullboard init",
+ "IMPORT_SCHEMA": "export and import with the same Pullboard version",
+ "IMPORT_VERSION": "export the board again with this Pullboard version: pullboard export > board.json",
+ "INLINE_GATE": "use the gate as its own flag: pullboard spec draft \"<text>\" --gate \"<check>\"",
+ "INTERNAL": "run the command again; if it repeats, report it with pullboard shout coordinator \"<command and output>\"",
+ "ITEM_NOT_AVAILABLE": "read the item from this API's board state",
+ "LANE_TAKEN": "choose a different lane name with pullboard lane add",
+ "LAND_ADOPT": "read pullboard resume, then run pullboard land --adopt, or pullboard land when nothing is unfinished",
+ "LAND_CANDIDATE": "read pullboard resume and the saved candidate logs, restore the recorded candidate worktree and board, then run pullboard land --adopt",
+ "LAND_PARALLEL_NESTED_GATE": "run pullboard land from the coordinator main checkout outside a gate command so each candidate can obtain its own slot",
+ "LAND_LEASE_CORRUPT": "restore a consistent board export before running pullboard land",
+ "LAND_LEASE_LOST": "stop this landing command, read pullboard resume, then adopt only after the current holder finishes",
+ "LAND_RELAY_REQUIRED": "restore the linked relay connection, then run pullboard land again",
+ "LAND_GATE_TIMEOUT": "read the recorded landing log, correct the gate or its configured landing timeout, then start another landing after its cadence",
+ "LAND_WORKER": "read pullboard resume and the saved landing logs, stop any owned gate still running, then run pullboard land --adopt",
+ "RELAY_CONFIRMATION_PENDING": "wait for the local moves to receive ordered relay receipts before running pullboard land",
+ "LAND_ENVIRONMENT": "run pullboard land on a machine whose platform, architecture and Node version match landing.environment in pullboard.json",
+ "LAND_EVIDENCE": "preserve earlier gate and diagnostic evidence, then pullboard land --adopt",
+ "LAND_SOURCE_CHANGED": "inspect the recorded landing logs and restore the batch source before pullboard land --adopt",
+ "LAND_DIAGNOSTIC": "read the landing log the message names, and make the test reporter print file names",
+ "LAND_DIRTY": "inspect the landing worktree, commit or remove its edits, then pullboard land --adopt",
+ "LAND_HOST_NOT_JOINED": "on the matching machine, run pullboard settings landing.pool on, then pullboard land",
+ "LAND_INTERACTION": "read the batch's failing tests, then land the items in separate batches",
+ "LAND_MERGE": "inspect the landing worktree and its hooks, then pullboard land --adopt",
+ "LAND_MOVED": "read pullboard resume, then adopt the current batch: pullboard land --adopt",
+ "LAND_PUSH": "inspect the remote and hooks, then pullboard land --adopt",
+ "LAND_REMOTE_MOVED": "inspect the remote branch, then pullboard land --adopt",
+ "LAND_TRUNK": "check the recorded trunk branch with pullboard resume, then switch the main checkout to that branch: git switch <trunk-branch>",
+ "LAND_TRUNK_MOVED": "rebuild the batch from the new main: pullboard land",
+ "LAND_WORKTREE": "restore the landing worktree the message names, then pullboard land --adopt",
+ "LOCAL_RUNNER_REQUEUE": "call requeueRunner only on a lease with a runner; release a local lease normally",
+ "MILESTONE_NAME": "pullboard milestone add <name>",
+ "MILESTONE_NOTE": "pass the note text: --note \"<text>\"",
+ "MILESTONE_SHIPPED": "add the item to the next milestone instead: pullboard milestone items <next> --add <id>",
+ "MILESTONE_TARGET": "pass a date and time: pullboard milestone edit <name> --target 2026-10-20T18:00Z",
+ "MISSING_SIGNATURE": "have the person repeat approval for the named row: pullboard spec approve <id>",
+ "MISSING_SIGNERS": "restore the signer list from git: git checkout HEAD -- .pullboard/signers",
+ "MODEL_REQUIRED": "pass --model \"<model name>\", or set PULLBOARD_MODEL in this shell",
+ "BAR_COVERAGE": "record whole-file duration evidence, the named-check duration and any install duration in a coverage JSON file, then run pullboard bar sign <id> --coverage-file <path> --note \"...\"",
+ "NOTHING_FREE": "wait for work: pullboard next --wait 9 (minutes)",
+ "NOT_COMMITTED": "commit the files the message names, then run the command again",
+ "NOT_HOLDING": "name an item: pullboard check <id>, or run the project gate: pullboard gate",
+ "NOT_MAIN": "run this coordinator-owned operation from the main checkout, or ask the coordinator to do it",
+ "NOT_APPROVER": "ask one of the approvers pullboard.json names to do it, signed in as themselves; to change the list, an approver commits it and runs pullboard relay on",
+ "BAD_APPROVERS": "list approvers in pullboard.json as distinct GitHub logins, at most fifty, then run pullboard relay on",
+ "NOT_MERGED": "merge the item's commit onto the trunk, then pullboard merged <id>",
+ "NOT_SSH_KEY": "add a valid OpenSSH public key: pullboard spec signers add --key ~/.ssh/id_ed25519.pub",
+ "NOT_SSH_KEY_PATH": "set user.signingkey to an SSH key file: git config user.signingkey ~/.ssh/id_ed25519.pub",
+ "NOT_YOUR_CHECKOUT": "make an independent checkout with git worktree add -b <lane>/<n> ../<repo>-<lane>-<n>, then run pullboard join <lane> --model \"<model name>\" there; the same agent in a new session should run pullboard takeover from its own shell",
+ "RIGOR_RANGE": "pass --base the commit or branch this change grew from: pullboard rigor quality --base main",
+ "RIGOR_RULE": "name a rule pullboard help rigor lists: pullboard rigor quality --rule silent-catch",
+ "RIGOR_UNNOTICED": "run pullboard rigor and draft a cause it lists, or wait until the cause repeats",
+ "RIGOR_UNPROVEN": "name a check that fails at --red and passes at --green: pullboard rigor draft <key> \"<rule>\" --check \"<command>\" --red <commit> --green <commit>",
+ "RIGOR_PERSON_ONLY": "ask the person to mark it from the main checkout: pullboard fact <id> root-cause \"<why>\" --cause <key> --never-again --as person",
+ "SANDBOX_BLOCKED": "ask the coordinator to bring it to the person: pullboard shout coordinator \"<what is needed>\" --decision; or run the gate outside the sandbox; keep the tests unchanged",
+ "NO_BOARD": "initialize the board in this repository: pullboard init",
+ "NO_BLUEPRINT": "choose a bundled blueprint named in the message, or pass an existing local JSON file to pullboard blueprint add",
+ "NO_BRIEF": "add the missing fields with pullboard edit <id> --brief \"...\" --criterion \"...\"",
+ "READ_ONLY": "read settings with GET /api/v1/settings; use pullboard settings for supported machine-setting changes",
+ "SETTINGS_NOT_AVAILABLE": "use the authenticated local API address printed by pullboard serve to read machine and repository settings",
+ "NO_ENDPOINT": "use a path under /api/v1/boards",
+ "NO_EVIDENCE": "cite the row id in a test name, or build it first",
+ "NO_FILE": "check the path and pass a file that exists",
+ "NO_FILES_LANE": "run pullboard lanes, then file the build in a lane that owns files, or pass --after <id> if it reviews that item",
+ "NO_FIRST_COMMIT": "commit the repo, then pullboard spec signers add",
+ "NO_LANE": "pick a lane from pullboard lanes",
+ "NO_LINES": "name a line range inside the file",
+ "NO_REPO": "run pullboard init in the repo, or pick a project in pullboard view",
+ "NO_ROLE": "choose one of the roles listed by pullboard skills",
+ "NO_ROW": "list the rows with pullboard spec --json, then name one of them",
+ "NO_SECTION": "add a section heading such as \"## G · Goals\" to the spec, then draft the row",
+ "NO_SIGNERS": "add an SSH signer: pullboard spec signers add",
+ "NO_SIGNING_COMMIT": "commit the repo, then sign again",
+ "NO_SPEC": "run pullboard init",
+ "NO_TITLE": "give a title: pullboard add <lane> \"<title>\"",
+ "OAUTH_CANCELLED": "start sign-in again: pullboard relay on",
+ "OAUTH_CLEANUP": "run pullboard relay on again once the relay answers",
+ "OAUTH_EXPIRED": "start sign-in again: pullboard relay on",
+ "PAIR_BUSY": "let sync finish, then pair again: pullboard relay pair",
+ "PAIR_CODE_INVALID": "ask the linked device for a new code: pullboard relay pair",
+ "PAIR_LINK_LONG": "open the printed link instead of scanning the code",
+ "PAIR_PACKAGE": "make a fresh code on the linked device: pullboard relay pair",
+ "PAIR_PACKAGE_SIZE": "ask the linked device for a smaller package, or join from a fresh clone",
+ "PAIR_PENDING": "finish sync first (pullboard status), then pair again",
+ "PAIR_RELAY": "run pullboard relay join with the relay address the code came from",
+ "PAIR_REPOSITORY": "ask the linked device for a fresh code, then join inside the matching clone",
+ "PAIR_STATE": "sync this device (pullboard status), then pair again",
+ "PATH_OWNED": "choose a folder no existing lane owns, or edit the lane ownership in pullboard.json from the main checkout",
+ "PARENT_CLOSED": "add the item without --parent, or under an open parent",
+ "PARENT_LANE": "add the child in its parent's lane",
+ "PARENT_SESSION_CHANGED": "create a fresh worktree and join it from the new parent session",
+ "PRIVATE_BLUEPRINT": "choose a blueprint name and title that identify no person or private project, then retry pullboard blueprint save",
+ "PERSON_REQUEST_CLOSED": "read the request's original result in pullboard view",
+ "PERSON_REQUEST_ID": "reload the paired view and send a new request",
+ "PERSON_REQUEST_RECEIPT": "upgrade Pullboard on the linked machine, then retry from the paired view",
+ "PERSON_REQUEST_TAKEN": "wait for the other machine's receipt in pullboard view",
+ "PERSON_REQUEST_VERSION": "upgrade Pullboard on the linked machine and reload the view",
+ "PHONE_APPROVAL_AUTH": "request a fresh approval on the phone and retry",
+ "PHONE_APPROVAL_CONTEXT": "request approval for this exact board, action and command",
+ "PHONE_APPROVAL_EXPIRED": "run the command again and approve it on the phone",
+ "PHONE_APPROVAL_UNAVAILABLE": "retry the phone approval when the relay answers; if it repeats, pair again with pullboard relay on --all",
+ "PHONE_APPROVAL_PENDING": "approve the named action on the paired phone before it expires",
+ "PHONE_NOT_PAIRED": "pair the phone: pullboard relay on --all",
+ "PIN_FAILED": "fix what git reported, then run pullboard run again",
+ "PORT_BUSY": "stop the other view on that port, then run pullboard view again",
+ "PROJECT_NOT_REGISTERED": "run pullboard view --project inside a registered repo, or plain pullboard view",
+ "PROJECT_SCOPE": "scope the API to one registered project repo",
+ "RELAY_ACTOR": "send the move with the token of the agent that makes it",
+ "RELAY_ANSWER": "use pullboard answer <id> \"<answer>\" or pullboard pass <id> --note \"<reason>\"",
+ "RELAY_BASELINE_EXISTS": "save the board with pullboard export > board.json, then pullboard relay off",
+ "RELAY_BASELINE_UNCERTAIN": "run the command again when the relay answers; it first checks whether the relay kept the board upload",
+ "RELAY_BOARD_DELETED": "keep working locally, or run pullboard relay on to link the board again",
+ "RELAY_BUSY": "run the command again after the other worktree finishes sending",
+ "RELAY_OUTBOX": "keep the relay-outbox.sealed file and the board as they are, then ask for help before relinking",
+ "RELAY_OUTBOX_UNBOUND": "run the command again once the relay answers; pullboard status shows when the outbox has gone up",
+ "RELAY_OUTBOX_PENDING": "run pullboard status once the relay answers; it sends the queued moves in order first",
+ "RELAY_CURSOR": "fetch a consistent snapshot: pullboard relay",
+ "RELAY_DIVERGED": "run pullboard relay off, then pullboard relay on to link again from this machine",
+ "RELAY_KEYCHAIN": "unlock the system keychain, then run the command again",
+ "RELAY_KEY_EXISTS": "keep this clone's key, and join from a fresh device home",
+ "RELAY_KEY_FILE_ENV_MISMATCH": "unset PULLBOARD_RELAY_KEY, or set it to this device's key",
+ "RELAY_KEY_MISSING": "pair this device again: pullboard relay on --all",
+ "RELAY_KEY_STORAGE": "restore owner-only permissions: chmod 700 on the relay-keys folder, 600 on its files",
+ "RELAY_LINKED": "run pullboard relay off before linking it elsewhere, or use a fresh clone",
+ "RELAY_LOCAL_CHANGED": "save the board with pullboard export > board.json, then retry the recovery",
+ "RELAY_MACHINE_STORAGE": "restore owner-only permissions on the relay-machine folder (700) and its files (600)",
+ "RELAY_MOVE": "upgrade Pullboard: npm install -g pullboard@latest",
+ "RELAY_NOT_LINKED": "link the board: pullboard relay on --all",
+ "RELAY_OFF": "link the board: pullboard relay on",
+ "RELAY_ORDER": "fetch and apply the missing moves: pullboard relay",
+ "RELAY_ORIGIN": "set a GitHub origin: git remote add origin https://github.com/<owner>/<repo>.git, then pullboard relay on",
+ "RELAY_PERSON_ONLY": "do it as the person from the paired phone or the person's own session",
+ "RELAY_PRESENTATION_PENDING": "run pullboard status again",
+ "RELAY_RECOVERY_HEALTHY": "replay it normally: pullboard relay",
+ "RELAY_RECOVERY_PENDING": "finish the saved recovery: pullboard relay recover --skip <sequence>",
+ "RELAY_REGISTRATION": "create the seat again from its creating seat's checkout, or from the main checkout: pullboard worktree <lane> --model \"<model name>\"",
+ "RELAY_REPLAY_REQUIRED": "upgrade Pullboard: npm install -g pullboard@latest",
+ "RELAY_RESPONSE": "retry once the relay answers; if it repeats, pair again: pullboard relay on --all",
+ "RELAY_REFUSED": "retry after fixing the displayed relay refusal; if it repeats, upgrade Pullboard and report the refusal to the service owner",
+ "RELAY_CHECKPOINT_REFUSED": "upgrade Pullboard or run pullboard relay off then pullboard relay on --all; if it repeats, report the displayed checkpoint refusal",
+ "RELAY_SNAPSHOT_LIMIT": "upgrade the configured relay and Pullboard for bounded snapshots, then retry the retained upload",
+ "RELAY_RECORD": "retry the relay action after the displayed blocker is resolved",
+ "RELAY_RETRY_PENDING": "repeat the interrupted command exactly to get its original outcome",
+ "RELAY_ROSTER_PATH": "upgrade Pullboard on this machine, then run pullboard relay devices again",
+ "RELAY_SEAL": "continue with the next record: pullboard relay",
+ "RELAY_SENDER": "restore the record's sender before replaying it",
+ "RELAY_SENDER_MISMATCH": "send the move as the agent that makes it, from that agent's worktree",
+ "RELAY_SEQUENCE": "inspect pullboard relay and skip only the blocked next sequence",
+ "RELAY_SESSION": "link this project and pair the phone: pullboard relay on --all",
+ "RELAY_SNAPSHOT": "fetch a consistent snapshot (pullboard relay), or join by pairing",
+ "RELAY_SNAPSHOT_BUSY": "run the command again",
+ "RELAY_STORAGE": "restore relay.json as an owner-only file (chmod 600), or pullboard relay off and on again",
+ "RELAY_UNAVAILABLE": "keep working offline, and run the command again when the relay answers",
+ "RELAY_UNLINK_PENDING": "finish unlinking: pullboard relay off",
+ "RELAY_URL": "use an HTTPS relay address, such as https://app.pullboard.dev",
+ "RELAY_VERSION": "upgrade Pullboard: npm install -g pullboard@latest",
+ "REMOTE_COORDINATOR_MODEL": "run the command in the coordinator's own checkout",
+ "REMOTE_GATE_SLOT_NOT_INHERITABLE": "start a local child with its local gate lease; execute remote children on the runner instead of inheriting its lease locally",
+ "RESERVED_RUNNER_RESOURCE": "request the gate resource with name: \"gate\"; configure runner capacity with pullboard runner add <ssh-host> --slots <n> --browser <n>",
+ "RESOURCE_BUSY": "check the holder and queue with pullboard resources, wait for the resource to become free, then retry",
+ "RESOURCE_CAPACITY_MISMATCH": "check the configured capacity with pullboard settings, then retry using that capacity",
+ "RESOURCE_LEASE_LOST": "take the resource again, then retry",
+ "REVIEW_NOT_READY": "wait for the submit with pullboard watch, or check back: pullboard next --verify",
+ "RUNNER_BUSY": "wait for the named runner's active tests to finish, then retry its settings change",
+ "RUNNER_CAPACITY_MISMATCH": "wait for active runner leases to fit the configured capacity, then retry the run",
+ "RUNNER_CLEANUP_TIMEOUT": "inspect the named job under that runner's namespace and confirm its cleanup before starting another run",
+ "RUNNER_NOT_REGISTERED": "choose a host already registered in this machine's runner settings, then run pullboard runner remove <ssh-host> again",
+ "RUNNER_OUTPUT_LIMIT": "reduce the command output, or keep the run local",
+ "RUNNER_REQUEST_LIMIT": "keep the run local, or reduce the runner request before retrying",
+ "RUNNER_SCAN_LIMIT": "keep the run local, or reduce the oversized source blob, history or tag set named by the scan",
+ "RUNNER_SETUP_REFUSED": "run pullboard resources and pullboard settings on the named runner, correct its resource pool, then retry the run",
+ "RUNNER_SECRET": "remove the flagged secret or private path from the selected source, history, metadata or command before remote execution",
+ "RUNNER_SOURCE": "restore readable committed Git source and history, then retry; keep unsupported source objects local",
+ "RUNNER_SOURCE_CHANGED": "restore the committed source selected for the queued run, then retry it",
+ "RUNNER_TOOLING_CHANGED": "restore or commit the selected Pullboard tooling revision before remote execution",
+ "RUNNER_TOOLING_IDENTITY": "reinstall Pullboard from a named Pullboard installation before remote execution",
+ "RUNNER_TOOLING_SECRET": "restore a trusted Pullboard installation before transferring runner tooling",
+ "ROW_ID_TAKEN": "run the same command again for the next free id",
+ "SEAL_AUTH_FAILED": "fetch the board again, or pair this device again: pullboard relay on --all",
+ "SEAL_BINDING": "upgrade Pullboard on this device, then retry",
+ "SEAL_CRYPTO": "use Node 22 or newer, or a browser on a secure (https) page",
+ "SEAL_FORMAT": "fetch the board again: pullboard relay",
+ "SEAL_KEY": "pair this device again: pullboard relay on --all",
+ "SEAL_VERSION": "upgrade Pullboard on this device: npm install -g pullboard@latest",
+ "SERVICE_ERROR": "retry the call; if it repeats, restart pullboard serve",
+ "SHALLOW_BEFORE_OPT_IN": "git fetch --unshallow, then pullboard spec signers add",
+ "SHOUT_NOT_AVAILABLE": "read shouts with pullboard inbox, or refresh the snapshot with a current CLI",
+ "SNAPSHOT_FORMAT": "refresh the snapshot from a linked machine: pullboard relay",
+ "SNAPSHOT_GRAPH": "retry publication from the linked CLI with every referenced encrypted page present; never install a partial graph",
+ "SNAPSHOT_PAGE_CONFLICT": "retry the original immutable bytes from the saved upload; repair a damaged device cache instead of overwriting an existing content id",
+ "SNAPSHOT_PAGE_FORMAT": "refresh the snapshot from a linked computer, or upgrade Pullboard before reading this sealed-page format",
+ "SNAPSHOT_PAGE_MISSING": "refresh the phone board, or run pullboard relay from its linked computer to restage the missing encrypted pages",
+ "SNAPSHOT_READ_EXPIRED": "refresh the phone board to obtain a new read pin, then retry the older-history read",
+ "SNAPSHOT_UPLOAD_EXPIRED": "retry the saved upload; the linked CLI starts a fresh upload session without discarding pending data",
+ "SPEC_ANSWER": "read the row with pullboard spec show <id>; the person answers a pending question with pullboard spec answer <id> \"<choice or text>\"",
+ "SPEC_ANSWER_CHOICES": "the person approves the exact answered text instead: pullboard spec approve <id> --text \"<ask>: <answer>. Choices: <choices>.\"",
+ "SPEC_INVALID": "fix the unparsed row the message names, then pullboard spec check",
+ "SPEC_SECTION": "name a section the spec has; see pullboard spec",
+ "SSH_KEY_FAILED": "check the SSH key and that ssh-keygen is installed: ssh-keygen -l -f <key>",
+ "SSH_KEY_NOT_FOUND": "pass the key path: --key ~/.ssh/id_ed25519.pub",
+ "TOKEN_EXPIRED": "ask the coordinator for a fresh seat: pullboard worktree <lane> --model \"<model name>\"; for the coordinator's own token, the person runs pullboard relay on in the main checkout",
+ "TOKEN_REVOKED": "stop using this seat and ask the coordinator for a fresh one: pullboard worktree <lane> --model \"<model name>\"",
+ "TOKENS_NOT_AVAILABLE": "manage agent tokens in pullboard view or the signed-in relay account",
+ "TOKEN_NOT_OWNED": "name a token id from pullboard relay tokens",
+ "SENTINEL_TRUNK": "commit the primary trunk branch, inspect any checkout failure, then retry pullboard sentinel run",
+ "SENTINEL_ABORTED": "retry pullboard sentinel run when its caller is ready",
+ "SENTINEL_DRAIN": "inspect the latest watch outcome with pullboard sentinels; report the shutdown failure to its owner before retrying",
+ "TOO_LARGE": "open the file in your editor instead",
+ "UNAUTHORIZED_SIGNERS_CHANGE": "restore the previous signer list (git checkout HEAD -- .pullboard/signers), or sign the change with a listed key",
+ "UNLISTED_SIGNER": "add the signer: pullboard spec signers add --by <principal> --key <path>",
+ "UNMERGED_SCHEMA": "merge this code into the main checkout first, or test it against its own board",
+ "UNKNOWN_TOOL": "call tools/list and use a tool name returned by that MCP server",
+ "VIEW_START": "run pullboard view in the foreground to see why it stopped",
+ "VIEW_PAIRING_CLEANUP": "run pullboard relay off, then pullboard relay on --all to finish pairing cleanup",
+ "VIEW_STATE": "check that the Pullboard home folder is writable, then run pullboard view again",
+ "VIEW_UNAVAILABLE": "start the view with pullboard view, then export again",
+ "VIEW_PAIRING_NOT_READY": "read this sign-in’s status again: pullboard view",
+ "VIEW_SIGN_IN_AUTH": "open the link pullboard view printed and send its session key only in the x-pullboard-key header",
+ "VIEW_SIGN_IN_BUSY": "finish or cancel the sign-in already in progress, then start it again",
+ "VIEW_SIGN_IN_FAILED": "start sign-in again from pullboard view and read the reported error if it still cannot finish",
+ "VIEW_SIGN_IN_JSON": "send application/json with one JSON object containing only the supported sign-in action and its intent id when required",
+ "VIEW_SIGN_IN_LINKING": "let the current board-linking batch finish before starting another sign-in",
+ "VIEW_SIGN_IN_METHOD": "read the invitation with GET or send sign-in actions as an application/json POST",
+ "VIEW_SIGN_IN_RESPONSE": "check the configured relay address, then start sign-in again",
+ "VIEW_SIGN_IN_SCOPE": "open the full machine view with pullboard view, then start sign-in there",
+ "VIEW_SIGN_IN_STOPPED": "start sign-in again with pullboard view",
+ "VIEW_SIGN_IN_UNKNOWN": "start sign-in again with pullboard view",
+ "WITHDRAWN": "wait on an item that is not withdrawn; see pullboard list --all",
+ "WRONG_BOARD": "open the repository registered to this board and confirm its identity with pullboard status"
+});