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.

fix(core): give reference refusals explicit recovery steps [C7,P4]

Corey Olson1f006674728f
diff --git a/src/moves/addItem.js b/src/moves/addItem.js
index c522aefd..b79fbaa2 100644
--- a/src/moves/addItem.js
+++ b/src/moves/addItem.js
@@ -28,6 +28,7 @@ function actor(move) { return move.args[0]?.by ?? null; }
export default Object.freeze({ operation: "addItem", order: 8, engine: 1,
itemIdFirstArgument: false, minimumEngine, actor,
nextSteps: Object.freeze({
+ "REFERENCE_AUTHOR": "use the issue or pull request author's handle, or remove the handle from its Reference line, then add or edit the item again",
"REFERENCE_IS_BOARD": "use --specs for spec rows, --after for item dependencies, or --parent for a parent item",
"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>\"",
diff --git a/src/moves/editItem.js b/src/moves/editItem.js
index 3c3106e1..6c1149f4 100644
--- a/src/moves/editItem.js
+++ b/src/moves/editItem.js
@@ -34,6 +34,7 @@ function actor(move) { return move.args[1]?.agentId ?? null; }
export default Object.freeze({ operation: "editItem", order: 9, engine: 1,
itemIdFirstArgument: true, minimumEngine, actor,
nextSteps: Object.freeze({
+ "REFERENCE_AUTHOR": "use the issue or pull request author's handle, or remove the handle from its Reference line, then add or edit the item again",
"REFERENCE_IS_BOARD": "use --specs for spec rows, --after for item dependencies, or --parent for a parent item",
"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 \"...\"",
diff --git a/src/moves/shipMilestone.js b/src/moves/shipMilestone.js
index 45c6c07a..55372df6 100644
--- a/src/moves/shipMilestone.js
+++ b/src/moves/shipMilestone.js
@@ -18,6 +18,7 @@ function actor(move) { return move.args[1]?.agentId ?? null; }
export default Object.freeze({ operation: "shipMilestone", order: 36, engine: MILESTONE_SHIP_ENGINE,
itemIdFirstArgument: false, minimumEngine, actor,
nextSteps: Object.freeze({
+ "REFERENCES_MISSING": "add every named acknowledgement to the selected release section in CHANGELOG.md, commit it on main, then run pullboard milestone ship <name> before tagging",
"MILESTONE_LIMIT": "remove or swap an unstarted item, or edit the milestone with --limit <n>|none",
"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",
diff --git a/test/move-registry-baseline.json b/test/move-registry-baseline.json
index d3407dff..9b7b8b4f 100644
--- a/test/move-registry-baseline.json
+++ b/test/move-registry-baseline.json
@@ -6804,6 +6804,8 @@
"NO_CONFIG": "run pullboard init in the main checkout and commit pullboard.json",
"READ_ONLY": "read settings with GET /api/v1/settings; use pullboard settings for supported machine-setting changes",
"REFERENCE_IS_BOARD": "use --specs for spec rows, --after for item dependencies, or --parent for a parent item",
+ "REFERENCE_AUTHOR": "use the issue or pull request author's handle, or remove the handle from its Reference line, then add or edit the item again",
+ "REFERENCES_MISSING": "add every named acknowledgement to the selected release section in CHANGELOG.md, commit it on main, then run pullboard milestone ship <name> before tagging",
"SETTINGS_NOT_AVAILABLE": "use the authenticated local API address printed by pullboard serve to read machine and repository settings",
"DECISIONS_NOT_AVAILABLE": "read each board's state from the local API, which carries its own person decisions",
"PROJECT_REPO_AMBIGUOUS": "run pullboard decisions --as person and answer with the repo name it prints before the #",