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.

chore(core): merge main into #559

Corey Olsonb306f0d39602
diff --cc src/commands/decisions.js
index caad0d9c,b507c681..e9c397e1
--- a/src/commands/decisions.js
+++ b/src/commands/decisions.js
@@@ -15,33 -10,16 +15,33 @@@ import
withBoardRead,
} from '../cli.js';
-/** Run `pullboard decisions` and return its exit code. */
+/**
+ * Run `pullboard decisions` and return its exit code. As the person, a repo that belongs to a
+ * project lists every sibling repo's open decisions too, each named repo#id so `pullboard answer
+ * repo#id` closes it on its own board [N34].
+ */
export function run(io, { values }) {
const ctx = context(io);
- const { asks, agents } = withBoardRead(ctx, (board) => {
+ const siblings = projectSiblings(ctx.info.root, ctx.config);
+ const { asks, agents, project, asPerson } = withBoardRead(ctx, (board) => {
const me = whoAmI(ctx, board);
const asPerson = personMode(ctx, me, values);
- return { asks: store.openDecisions(board, asPerson ? 'person' : [me.id, me.lane]), agents: store.listAgents(board) };
+ if (asPerson && siblings.length) {
+ return { project: projectPersonDecisions(ctx.info.root, ctx.config.name ?? basename(ctx.info.root), board, siblings), asPerson };
+ }
+ return { asks: store.openDecisions(board, asPerson ? 'person' : [me.id, me.lane]), agents: store.listAgents(board), asPerson };
});
+ if (project) {
+ io.result?.({ project: ctx.config.project, decisions: project.decisions.map((entry) => entry.ask), ...(project.unreadable.length ? { unreadable: project.unreadable } : {}) });
+ if (!project.decisions.length) io.say('no open decisions');
+ for (const { ask, repo, agents: repoAgents, config } of project.decisions) {
+ io.say(`${repo}#${ask.shout_id} ${agentDisplayName(repoAgents, config ?? ctx.config, ask.shout_from)} -> ${agentDisplayName(repoAgents, config ?? ctx.config, ask.shout_to)}, ${span(ctx, ask.shout_at)} ago: ${firstLine(ask.shout_text)}`);
+ }
+ for (const name of project.unreadable) io.err(`could not read ${name}'s board; its decisions are not listed`);
+ return 0;
+ }
io.result?.({ decisions: asks });
if (!asks.length) io.say('no open decisions');
- for (const ask of asks) io.say(`#${ask.shout_id} ${agentDisplayName(agents, ctx.config, ask.shout_from)} -> ${agentDisplayName(agents, ctx.config, ask.shout_to)}, ${span(ctx, ask.shout_at)} ago: ${firstLine(ask.shout_text)}`);
+ for (const ask of asks) io.say(`#${ask.shout_id} ${agentDisplayName(agents, ctx.config, ask.shout_from)} -> ${agentDisplayName(agents, ctx.config, ask.shout_to)}, ${span(ctx, ask.shout_at)} ago: ${firstLine(ask.shout_text)}${ask.options ? '\n' + ask.options.map((option, index) => ` ${index + 1}. ${option}`).join('\n') : ''}`);
return 0;
}
diff --cc src/help.js
index 6640a9d5,b5a64276..74aaa812
--- a/src/help.js
+++ b/src/help.js
@@@ -166,10 -167,10 +167,11 @@@ Wor
pullboard shout all <text> --news coordinator/person release or focus news, digested at session start
Inbox combines direct coordination with item/dependency, file and cited-row activity; other lane activity is summarized.
pullboard shout [<to>] <text> --decision ask for a decision; defaults to your coordinator or the person
+ pullboard shout coordinator <question> --item <id> --decision --options '["first","second"]'
pullboard shout <to> <text> --evidence attempt|receipt --outcome <word> --item <id> --commit <rev>
- pullboard answer <shout-id> <text> [--as person]
+ pullboard answer <shout-id|repo#id> <text> [--as person]
answer your decision; person mode is main-checkout only
+ repo#id answers a sibling repo's decision on its own board
Other options: [--implies <ids>] [--supersedes <answer-id>]
[--origin person-relayed|agent|inherited] [--rationale <why>]
--supersedes tells the items an earlier answer implied; only the person
diff --cc src/next-step-defaults.js
index dbac9019,d661300d..4eddec45
--- a/src/next-step-defaults.js
+++ b/src/next-step-defaults.js
@@@ -1,8 -1,14 +1,17 @@@
/** General CLI recovery text; operation-owned codes live in src/moves/ [P4,C7]. */
export const DEFAULT_NEXT_STEPS = Object.freeze({
+ "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 #",
+ "PROJECT_REPO_UNKNOWN": "run pullboard decisions --as person to see the repos of this project, then answer repo#id",
+ "BOARD_REFERENCE": "use an immutable board ID or one exact qualified name from the authorized project inventory",
+ "BOARD_LINK_FORMAT": "use the exact bounded version 1 board-link, approval, announcement or sealed envelope contract",
+ "BOARD_LINK_AUTH": "configure each board’s established signer authority and the per-link sealing capability; never use an unsigned or full-board-key fallback",
+ "BOARD_LINK_CONFLICT": "refresh the current link and retain exact retry bytes; use a new generation or correlation ID for changed content",
+ "BOARD_LINK_CYCLE": "remove the directed parent-link cycle before obtaining fresh bilateral consent",
+ "BOARD_LINK_DISCLOSURE": "send only the consenting child’s states, counts or no entries under its signed disclosure mode",
+ "BOARD_LINK_INACTIVE": "use a current non-revoked bilateral link generation for the exact source and receiving boards",
+ "BOARD_LINK_TRANSPORT": "read the exact durable delivery receipt or use the last nonnegative incoming cursor through the authenticated relay",
+ "BOARD_LINK_REPLAY": "send a newer source position; retry an existing delivery with its original correlation ID and sealed bytes",
"SHOUT_SPACES": "rewrite the shout with spaces between words, then send it again",
"DECISION_HANDOFF_BINDING": "use the exact versioned handoff, namespaced source decision and original option set",
"DECISION_HANDOFF_AUTH": "obtain authority for this exact question, answer or source query",