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 '6cef7fbcb68bfb84f95d1e77e0961e047c93b38a' into core/245

Corey Olson41c567e3ce65
diff --cc docs/formats.md
index 7d195b84,aa186f46..5c8ace5a
--- a/docs/formats.md
+++ b/docs/formats.md
@@@ -653,6 -654,21 +654,25 @@@ With `reviewsFirst` on, ordinary `next
With numeric `wipPerReviewer` on, a new claim that would exceed that limit is refused as `LINE_WIP_LIMIT`, naming the oldest eligible pending review when there is one. Live claimed items and outstanding submissions count; expired claims do not. The shared pure `lineWipLimit` function computes the total cap without rounding, using at least one observed reviewer. Renewals remain possible. The native claim carries the configured verifier and family policies so its suggested review never relaxes those guards. With `takeoverMinutes` on, a sent-back item's idle interval can end its original builder's first-refusal window early; a live claim is never stolen, and normal claim appends preserve the old history. Disabled controls retain the previous behavior. New claims under these controls carry a true `lineCapacity` argument and the line-capacity engine floor; marker-absent older recorded claims keep their historical meaning during replay.
+### Item decision options
+
+A `shout` ordered move may carry `options`, an array of at least two distinct nonempty strings, only with `decision: true` and an item. The move requires the decision-queue engine leaf; older shouts retain their original meaning. Only the validated top-level `options` argument creates structured choices; legacy opaque `detail` is never reinterpreted. The item event carries `decisionOptions` and `item`; `board_meta` keys `item_decision:<shout-id>` index those options for the open queue. Passing a question to the person copies its original options and item into the new decision index. Answers append ordinary answer events on the item; neither asking nor answering changes the claim or lease.
++
+
+ The explicit top-level `news: true` shout argument emits a native `shout_news` event instead of `shout`, without adding a SQLite column. Its canonical message row remains in `shout`; consumers resolve its recipient and text in the same way as other messages.
+ Only coordinator or person messages to `all` may be news; combining news with an item,
+ decision, request or answer refuses as `BAD_NEWS`. Its unassigned activity-news engine leaf is
+ numbered at landing; news takes the maximum applicable feature engine floor. Old `shout` events
+ remain ordinary messages regardless of arbitrary metadata matching any news tags. `watch --kinds`
+ continues to select literal kinds: include `shout,shout_news` to follow both. Older ordinary
+ shout arguments retain their historical replay conditions. Untyped broadcasts retain their
+ existing direct delivery, including governing holds and questions.
+
+ The inbox's optional JSON v1 `activity` object contains event references, selected entries,
+ one-line lane/news digests and a continuation cursor. Its private checkout delivery file is
+ `pullboard-activity.json` in the checkout's Git directory: version 1, board id, agent, current native session
+ digest, last delivered event id and last session-start news event id. It is local delivery state,
+ not a native move, parent identity, configuration or authority record. Missing/damaged state
+ replays activity. Reads freeze an event high-water mark before observing Git; subsequent events
+ and messages remain pending. News has a separate cursor so an ordinary poll cannot consume a
+ future session-start digest.
diff --cc src/api-moves.js
index 8fdea451,e5c89221..bf80aacc
--- a/src/api-moves.js
+++ b/src/api-moves.js
@@@ -23,7 -23,7 +23,7 @@@ const MOVES =
reopen: { item: true, flags: ['note', 'cause'], lists: ['conflict'], booleans: ['withdraw-verdict'] },
escalate: { item: true, flags: ['note'] },
hold: { positions: ['lane'], flags: ['reason'], booleans: ['off'] },
- shout: { positions: ['to', 'text'], optional: ['to'], booleans: ['decision'], flags: ['evidence', 'outcome', 'item', 'commit', 'options'] },
- shout: { positions: ['to', 'text'], optional: ['to'], booleans: ['decision', 'news'], flags: ['evidence', 'outcome', 'item', 'commit'] },
++ shout: { positions: ['to', 'text'], optional: ['to'], booleans: ['decision', 'news'], flags: ['evidence', 'outcome', 'item', 'commit', 'options'] },
answer: { item: true, positions: ['text'], flags: ['as', 'implies', 'supersedes'] },
pass: { item: true, positions: ['note'] },
next: { flags: ['as'], booleans: ['verify', 'build'] },
diff --cc src/board-query.js
index 4aa11dec,ec8b2806..3b000fee
--- a/src/board-query.js
+++ b/src/board-query.js
@@@ -1,6 -1,11 +1,12 @@@
+import { projectItemDecisions } from './item-decision-queue.js';
import { itemById } from './board-item-read.js';
- import { itemActivity } from './activity-feed.js';
+ import {
+ activityEventDetail,
+ activityInterests,
+ isActivityNews,
+ itemActivity,
+ projectAgentActivity,
+ } from './activity-feed.js';
export { itemById };
import { outsideSource } from './outside-source.js';
import {
diff --cc src/board.js
index 48ba834c,38e71024..6253ee3f
--- a/src/board.js
+++ b/src/board.js
@@@ -1,4 -1,9 +1,10 @@@
+import * as itemDecisions from './item-decision-queue.js';
+ import { activityNewsFlag } from './activity-news.js';
+ import { migrateEventLogVersion } from './board-event-log-migrate.js';
+ import {
+ configureBoardJournal,
+ closeBoardWrites,
+ } from './board-write-lock.js';
import {
focusOrder,
focusReasons,
@@@ -1658,13 -1622,11 +1623,13 @@@ export { getItem } from './board-query.
* Insert a shout within the caller's transaction.
*
* @param {any} board
- * @param {{ from: string, to: string, text: string, lanes: string[], item?: number, decision?: boolean, answers?: number | null, evidence?: any, request?: boolean, channel?: 'terminal' | 'view', detail?: object }} message - detail: extra event fields
+ * @param {{ from: string, to: string, text: string, lanes: string[], item?: number, decision?: boolean, answers?: number | null, evidence?: any, request?: boolean, news?: boolean, channel?: 'terminal' | 'view', detail?: object }} message - detail: extra event fields
* @returns {number}
*/
- function insertShout(board, { from, to, text, lanes, item, decision = false, answers = null, evidence = null, request = false, channel = 'terminal', detail = {}, options }) {
-function insertShout(board, { from, to, text, lanes, item, decision = false, answers = null, evidence = null, request = false, news = false, channel = 'terminal', detail = {} }) {
++function insertShout(board, { from, to, text, lanes, item, decision = false, answers = null, evidence = null, request = false, news = false, channel = 'terminal', detail = {}, options }) {
const engine = board.executionEngineVersion ?? ENGINE_VERSION;
+ const validatedDecision = itemDecisions.itemDecisionDetail(board, { options, decision, item, from }, engine);
+ detail = { ...detail, ...validatedDecision };
if (item !== undefined) {
if (engine < ITEM_SHOUT_ENGINE) throw new Refused('ENGINE_VERSION', 'item messages require engine 93; upgrade every linked device before sending one');
to = itemShoutTarget(board.db, item);
@@@ -1706,12 -1668,12 +1671,12 @@@
if (personAnswer && !['terminal', 'view'].includes(channel)) {
throw new Refused('B26_PERSON_CHANNEL', 'record the person answer through the terminal or the view; run pullboard view');
}
- return persistShout(board, { from, to, text, decision, answers, evidence, request, channel, detail, outcome, personAnswer, decisionRecord: validatedDecision.decisionOptions ? { item, options: validatedDecision.decisionOptions } : null });
- return persistShout(board, { from, to, text, decision, answers, evidence, request, news, channel, detail, outcome, personAnswer });
++ return persistShout(board, { from, to, text, decision, answers, evidence, request, news, channel, detail, outcome, personAnswer, decisionRecord: validatedDecision.decisionOptions ? { item, options: validatedDecision.decisionOptions } : null });
}
/** Persist a validated message or a fixed internal notice inside the caller's transaction. */
function persistShout(board, { from, to, text, decision = false, answers = null, evidence = null, request = false,
- channel = 'terminal', detail = {}, outcome = '', personAnswer = false, decisionRecord = null }) {
- channel = 'terminal', detail = {}, outcome = '', personAnswer = false, news = false }) {
++ channel = 'terminal', detail = {}, outcome = '', personAnswer = false, decisionRecord = null, news = false }) {
const result = board.db
.prepare(
`INSERT INTO shout (shout_from, shout_to, shout_text, shout_at, shout_decision, shout_answers,
@@@ -1721,8 -1683,7 +1686,8 @@@
)
.run(from, to, text.trim(), now(board), decision ? 1 : 0, answers, evidence?.kind ?? null, evidence ? evidence.outcome.trim() : null, evidence?.item ?? null, evidence?.commit ?? null, request ? 1 : 0, outcome);
const id = Number(result.lastInsertRowid);
- logEvent(board, from, answers === null ? 'shout' : decision ? 'pass' : 'answer', detail.item ?? null, { shout: id, to, decision: Boolean(decision), request: Boolean(request), answers, ...(outcome ? { outcome } : {}), ...(personAnswer ? { channel } : {}), ...detail });
+ logEvent(board, from, answers === null ? (news ? 'shout_news' : 'shout') : decision ? 'pass' : 'answer', detail.item ?? null, { shout: id, to, decision: Boolean(decision), request: Boolean(request), answers, ...(outcome ? { outcome } : {}), ...(personAnswer ? { channel } : {}), ...detail });
+ itemDecisions.recordItemDecision(board, id, { decision, answers, record: decisionRecord });
return id;
}
diff --cc src/cli-main.js
index 8903d865,bc2553dc..76dca31b
--- a/src/cli-main.js
+++ b/src/cli-main.js
@@@ -126,7 -126,7 +126,8 @@@ const OPTIONS =
since: { type: 'string' },
window: { type: 'string' },
decision: { type: 'boolean' },
+ options: { type: 'string' },
+ news: { type: 'boolean' },
evidence: { type: 'string' },
outcome: { type: 'string' },
item: { type: 'string' },
diff --cc src/commands/shout.js
index 5d24479d,4df95125..eedd22b6
--- a/src/commands/shout.js
+++ b/src/commands/shout.js
@@@ -31,7 -25,7 +31,7 @@@ export async function run(io, { first,
const hasRecipient = first && recipients.includes(first) && (values.item === undefined || second !== undefined);
const to = values.item !== undefined ? `item:${values.item}` : hasRecipient ? first : values.decision ? (me.id === COORDINATOR ? 'person' : COORDINATOR) : first ?? '';
const text = [hasRecipient ? second : first, ...(hasRecipient ? rest : [second, ...rest])].filter(Boolean).join(' ');
- const id = await ordered(ctx, board, 'shout', [{ from: personShout(io, me) ? store.PERSON : me.id, to, text, ...(values.item !== undefined ? { item: Number(values.item) } : {}), lanes: laneNames(ctx.config), decision: Boolean(values.decision), ...(options !== undefined ? { options } : {}), evidence }]);
- const id = await ordered(ctx, board, 'shout', [{ from: personShout(io, me) ? store.PERSON : me.id, to, text, ...(values.item !== undefined ? { item: Number(values.item) } : {}), lanes: laneNames(ctx.config), decision: Boolean(values.decision), ...(values.news ? { news: true } : {}), evidence }]);
++ const id = await ordered(ctx, board, 'shout', [{ from: personShout(io, me) ? store.PERSON : me.id, to, text, ...(values.item !== undefined ? { item: Number(values.item) } : {}), lanes: laneNames(ctx.config), decision: Boolean(values.decision), ...(options !== undefined ? { options } : {}), ...(values.news ? { news: true } : {}), evidence }]);
io.result?.({ id, decision: Boolean(values.decision) });
const agents = store.listAgents(board);
const recipient = agents.some((agent) => agent.agent_id === to) ? agentDisplayName(agents, ctx.config, to) : to;
diff --cc src/help.js
index b62cbfcf,d627754c..fbb6a2be
--- a/src/help.js
+++ b/src/help.js
@@@ -151,8 -151,9 +151,10 @@@ Wor
pullboard shout <lane|agent|person|all> <text> pullboard inbox
pullboard shout --item <id> <text> message the item builder, reviewer and coordinator
A seat shout to all reaches only coordinator and person; their broadcasts reach everyone.
+ 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] [--implies <ids>] [--supersedes <answer-id>]
answer your decision; person mode is main-checkout only
diff --cc src/moves/shout.js
index 10ef1d40,777df28a..0987e68f
--- a/src/moves/shout.js
+++ b/src/moves/shout.js
@@@ -1,4 -1,4 +1,5 @@@
+import { DECISION_QUEUE_ENGINE } from '../decision-queue-engine.js';
+ import { ACTIVITY_NEWS_ENGINE } from '../activity-news-engine.js';
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';
@@@ -15,6 -14,16 +15,18 @@@ function historicalMinimumEngine(args,
return 1;
}
+ /** News combines every applicable floor; old arguments retain their historical replay condition order. */
+ function minimumEngine(args, board, at) {
- if (args[0]?.news !== true) return historicalMinimumEngine(args, board, at);
- return Math.max(ACTIVITY_NEWS_ENGINE,
++ if (args[0]?.news !== true) return args[0]?.options !== undefined
++ ? Math.max(DECISION_QUEUE_ENGINE, historicalMinimumEngine(args, board, at))
++ : historicalMinimumEngine(args, board, at);
++ return Math.max(ACTIVITY_NEWS_ENGINE, args[0]?.options !== undefined ? DECISION_QUEUE_ENGINE : 1,
+ typeof args[1]?.cause === 'string' && args[1].cause.startsWith('conflict:') ? RIGOR_AUTO_ENGINE : 1,
+ args[0]?.item !== undefined ? ITEM_SHOUT_ENGINE : 1,
+ args[0]?.landingFence !== undefined ? LANDING_LEASE_ENGINE : 1,
+ typeof args[1]?.cause === 'string' && args[1].cause.startsWith('sentinel:') ? BOARD_SENTINEL_ENGINE : 1);
+ }
+
/** Read precisely the actor argument used by this operation [H2,H16]. */
function actor(move) { return move.args[0]?.from ?? null; }
@@@ -23,9 -32,8 +35,10 @@@ export default Object.freeze({ operatio
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_DECISION_OPTIONS": "ask an item decision with --decision --item <id> --options '[\"first\",\"second\"]'",
+ "NOT_YOUR_ITEM_DECISION": "ask on an item you build or review, or ask the coordinator for a cross-item decision",
"BAD_EVIDENCE": "pass the evidence fields the message names, then retry",
+ "BAD_NEWS": "send news from the coordinator or person to all, without item, decision, request or answer",
"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>\"",