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.
JavaScript agentic-codingai-agentsai-governanceautonomous-agentsclaude-codeclicode-reviewcodexcoding-agentsdeveloper-toolsgit-hooksllmlocal-firstmulti-agentsoftware-factoryspec-driven-developmentverificationvibe-coding
Merge branch 'main' into core/408-signed-person-moves
Corey Olson3427ec59358e
diff --cc docs/formats.mdindex cfc34f55,d921ae12..dcac6952--- a/docs/formats.md+++ b/docs/formats.md@@@ -115,11 -115,9 +115,11 @@@ The version table is generated from th| `row grammar` | `1` | `SPEC_GRAMMAR_VERSION` in `src/spec.js`; optional `<!-- pullboard-grammar N -->` line in either file (absence means the current grammar) | Both files share the version. A declared version must match; an incompatible grammar change requires a coordinated version bump and compatible files. No automatic conversion occurs. || `board schema` | `3` | `SCHEMA_VERSION` in `src/board.js`, persisted as `PRAGMA user_version` | On a write open of a board whose version is behind: create missing tables and indexes (version 3 adds the hot-path indexes), add missing columns in place with declared defaults, restore missing or changed triggers, and remove stale machine triggers without replacing rows. Read opens never migrate; a board at the current version whose shape differs is reported once on stderr and left as it is. || `event log` | `1` | `EVENT_LOG_VERSION` in `src/board.js`, persisted in `board_meta` as `event_log_version` | Older event-log versions upgrade in place; newer versions are refused with `EVENT_LOG_VERSION`. Preserve event rows when the board schema changes. |- | `move engine` | `117` | `ENGINE_VERSION` in `src/machine.js`, carried as `engine` in every sealed executable move | Bump when a move's meaning changes, independently of the event log and sealed envelope. A newer engine is refused with `ENGINE_VERSION`, naming both versions and asking you to upgrade Pullboard. |+ | `move engine` | `120` | `ENGINE_VERSION` in `src/machine.js`, carried as `engine` in every sealed executable move | Bump when a move's meaning changes, independently of the event log and sealed envelope. A newer engine is refused with `ENGINE_VERSION`, naming both versions and asking you to upgrade Pullboard. |<!-- format-versions:end -->+A signed board uses event-log format 2; older tools refuse it.+A builder never picks an engine number (#1101). An item that adds a board move adds its own `src/<name>-engine.js` leaf as `export const NAME_ENGINE = unassignedEngine();` (importing `unassignedEngine` from `./engine-next.js`); on its branch the leaf reads as one above the highest landed engine. The landing merge writes the next number into the leaf, in landing order, inside that item's merge commit, and sets the `move engine` row above to the highest landed number. A landed number never changes, so recorded moves replay as they were written. Moves are recorded under landed numbers only: code with an unnumbered engine is for its branch's own tests, and a move it records on a real board before landing may later read under another item's number, so the item lands before its moves are used.Relay transport capability `apiVersion: 2` is independent of these versions anddiff --cc relay/service.jsindex 96fcfe86,c3dc7a2f..9ffb102d--- a/relay/service.js+++ b/relay/service.js@@@ -25,17 -13,11 +25,18 @@@ import { createPairingStore } from './pimport { createPairingHandler } from './pairing-http.js';import { createRelayBrowserHandler } from './browser-page.js';import { VERIFIER_STANDING_ENGINE } from '../src/machine.js';-import { SEALED_SNAPSHOT_BYTES, SNAPSHOT_BODY_BYTES } from '../src/relay-limits.js';-import { createRelayPagesHandler, snapshotPageRoot } from './pages-http.js';+import {+ SEALED_SNAPSHOT_BYTES,+ SNAPSHOT_BODY_BYTES,+} from '../src/relay-limits.js';+import {+ createRelayPagesHandler,+ snapshotPageRoot,+} from './pages-http.js';import { createStorageQuota } from './storage-quota.js';+import { createPasskeyHandler } from './passkey-http.js';import { createUploadStatusHandler } from './upload-status.js';+ import { createRelayBoardLinks } from './board-links.js';const SNAPSHOT_BODY = SNAPSHOT_BODY_BYTES;const STORED_BYTES = SEALED_SNAPSHOT_BYTES;diff --cc src/api-moves.jsindex 530ada63,cb317a08..8a993c42--- a/src/api-moves.js+++ b/src/api-moves.js@@@ -25,8 -22,8 +25,8 @@@ const MOVES =refreeze: { item: true },reopen: { item: true, flags: ['note', 'cause'], lists: ['conflict'], booleans: ['withdraw-verdict'] },escalate: { item: true, flags: ['note'] },- hold: { positions: ['lane'], flags: ['reason'], booleans: ['off'] },+ hold: { positions: ['lane'], flags: ['reason', 'as'], booleans: ['off'] },- 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', 'origin', 'rationale'] },pass: { item: true, positions: ['note'] },next: { flags: ['as'], booleans: ['verify', 'build'] },diff --cc src/commands/spec.jsindex 1bde99db,fab9ac0c..d8855b58--- a/src/commands/spec.js+++ b/src/commands/spec.js@@@ -1,5 -1,8 +1,9 @@@/** The pullboard spec command, in its own module so an item adding another command never edits these lines. */+import { verifiedPasskeyRowDecision } from '../person-signing.js';+ import {+ planRowVerificationApply,+ rowVerificationFindings,+ } from '../spec-verdicts.js';import { planAutomaticRigorApply } from '../rigor-auto-apply.js';import {planSpecRevision,diff --cc src/commands/status.jsindex b90c2bc1,6979588f..9b448f02--- a/src/commands/status.js+++ b/src/commands/status.js@@@ -41,10 -38,11 +41,13 @@@ export async function run(io, { valuesconst me = identifyCaller(ctx, board, { environmentAgent: environment?.environmentAgent ?? (() => null),relayLinked: relay?.relayLinked ?? (() => false) }, readers);const mine = store.itemsInStatus(board, 'claimed', me.id);- const approvalState = personNeedsSummary(ctx.info.root, { board, config: ctx.config });+ const agents = store.listAgents(board);+ const presenceCounts = { live: 0, idle: 0, gone: 0 };+ for (const seat of agents) presenceCounts[seat.presence] += 1;+ const approvalState = personNeedsSummary(ctx.info.root, { board, config: ctx.config, agents });- return { me, mine, agents, presenceCounts, ruleCounts: ruleProofCounts(ctx.info.root, board, approvalState.spec), needs: approvalState.needs, specApprovalBaseline: approvalState.specApprovalBaseline, specApprovalEvidenceErrors: approvalState.specApprovalEvidenceErrors, stats: store.stats(board), reviewQueue: { ...store.reviewQueue(board), ...store.reviewQueueBreakdown(board) }, unread: store.unreadCount(board, me.id), relay: relay ? relay.relayStatus(ctx.info.root) : unlinkedRelayStatus(),+ const person = board.db.prepare("SELECT 1 FROM event WHERE event_kind='person_signing' LIMIT 1").get()+ ? { signed: (await import('../person-signing.js')).personSigning(board).signed } : { signed: false };- return { me, mine, person, ruleCounts: ruleProofCounts(ctx.info.root, board, approvalState.spec), needs: approvalState.needs, specApprovalBaseline: approvalState.specApprovalBaseline, specApprovalEvidenceErrors: approvalState.specApprovalEvidenceErrors, stats: store.stats(board), reviewQueue: { ...store.reviewQueue(board), ...store.reviewQueueBreakdown(board) }, unread: store.unreadCount(board, me.id), relay: relay ? relay.relayStatus(ctx.info.root) : unlinkedRelayStatus(),++ return { me, mine, person, agents, presenceCounts, ruleCounts: ruleProofCounts(ctx.info.root, board, approvalState.spec), needs: approvalState.needs, specApprovalBaseline: approvalState.specApprovalBaseline, specApprovalEvidenceErrors: approvalState.specApprovalEvidenceErrors, stats: store.stats(board), reviewQueue: { ...store.reviewQueue(board), ...store.reviewQueueBreakdown(board) }, unread: store.unreadCount(board, me.id), relay: relay ? relay.relayStatus(ctx.info.root) : unlinkedRelayStatus(),submitInvariantProposals: submitInvariantProposals(store.submitInvariantEvents(board, ctx.config), ctx.config) };});summary.memoryHeld = memoryHeldRuns();@@@ -60,7 -58,8 +63,9 @@@if (summary.specApprovalBaseline?.pending) io.say('approval baseline pending: the next coordinator or person command in the main checkout records the existing approved rows; lane work may continue and none are flagged until then');if (summary.specApprovalBaseline?.invalid) io.say('approval baseline unreadable: existing rows need approval evidence; restore a known-good board export to recover the original baseline');io.say(reviewQueueLine(ctx, summary.reviewQueue, span));+ io.say(signingLine(summary.person));+ io.say(`seats: ${summary.presenceCounts.live} live, ${summary.presenceCounts.idle} idle, ${summary.presenceCounts.gone} gone`);+ for (const seat of summary.agents.filter(seat => values.all || seat.presence !== 'gone')) io.say(`${seat.agent_id}: ${seat.presence}${seat.heartbeatAt ? ` (heartbeat ${seat.heartbeatAt})` : ' (no local heartbeat)'}`);if (summary.memoryHeld === null) io.say('local memory hold status unavailable; pullboard resources shows the queue');else for (const run of summary.memoryHeld) io.say(`local memory holds ${run.agent}${run.item ? ` #${run.item}` : ''}${run.kind ? ` (${run.kind})` : ''}${run.repo ? ` in ${run.repo}` : ''}`);for (const proposal of summary.submitInvariantProposals) io.say(submitInvariantLine(proposal));diff --cc src/next-step-defaults.jsindex f4cd47f9,d661300d..c0532923--- a/src/next-step-defaults.js+++ b/src/next-step-defaults.js@@@ -1,17 -1,14 +1,26 @@@/** General CLI recovery text; operation-owned codes live in src/moves/ [P4,C7]. */export const DEFAULT_NEXT_STEPS = Object.freeze({+ PASSKEY_ASSERTION: 'confirm the move again on your passkey from the relay view',+ PASSKEY_PRESENCE: 'confirm the move again with Face ID, Touch ID or a key touch',+ PASSKEY_REGISTRATION: 'add the passkey again from the relay view on this phone or browser',+ PASSKEY_REQUIRED: 'add a passkey in the relay view on your phone or browser, then confirm the move',+ PERSON_AUTHORITY: 'upgrade the relay so it publishes its passkey stamp key, then retry',+ PERSON_AUTHORITY_CHANGED: 'check which relay this board belongs to; link it to the relay it pinned',+ PERSON_PROPOSAL: 'start the person move from a terminal seat, then confirm it with your passkey',+ PERSON_SIGNED: 'confirm it with your passkey in the relay view; pair a phone or browser first with pullboard relay on --all',+ PERSON_SIGNER_REQUIRED: 'decide the other rows with your passkey; a row that names SSH signers waits until signing is off',+ PERSON_SIGNING_CORRUPT: 'restore the board from a known-good export',+ PERSON_SIGNING_ERASED: 'restore a known-good board that keeps its signing history',+ PERSON_SIGNING_RELAY: 'link this board to the relay with pullboard relay on --all, then turn signing on',+ "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",diff --cc test/move-registry-baseline.jsonindex 70687b31,d3c29c35..3fe4897a--- a/test/move-registry-baseline.json+++ b/test/move-registry-baseline.json@@@ -66,8 -66,7 +66,9 @@@"actOnActivity","recordActivityDelivery","decideSpecRevisions",- "recordRowVerification"++ "recordRowVerification",+ "proposePersonMove",+ "setPersonSigning"],"itemIdFirstArgument": ["signBar",@@@ -661,21 -660,13 +662,29 @@@null,null],+ "recordRowVerification": [+ null,+ "first",+ null,+ null,+ null,+ null++ ],+ "proposePersonMove": [+ null,+ "first",+ null,+ null,+ null,+ null+ ],+ "setPersonSigning": [+ null,+ "first",+ null,+ null,+ null,+ null]},"floorCases": [@@@ -7027,18 -7027,10 +7045,22 @@@"MILESTONE_LIMIT": "remove or swap an unstarted item, or edit the milestone with --limit <n>|none","BAD_COMPUTER_NAME": "retry relay on or relay join with --name containing 1 to 80 characters and no control characters or path separators","BLUEPRINT_RULE_UNCHECKED": "add a checked starter item that cites the must rule named in the message, then run pullboard blueprint add <file> again",+ "ROW_VERIFY": "pullboard spec show <id>, then pullboard spec verify <id> accepted --reason \"why\"",+ "ROW_VERIFY_PROVENANCE": "draft the row through pullboard spec draft and join normally before verifying it",+ "ROW_VERIFY_PENDING": "ask the coordinator to run pullboard spec apply before recording a verifier verdict",- "ROW_VERIFY_SELF": "ask an outside-parent verifier to run pullboard spec verify"++ "ROW_VERIFY_SELF": "ask an outside-parent verifier to run pullboard spec verify",+ "PASSKEY_ASSERTION": "confirm the move again on your passkey from the relay view",+ "PASSKEY_PRESENCE": "confirm the move again with Face ID, Touch ID or a key touch",+ "PASSKEY_REGISTRATION": "add the passkey again from the relay view on this phone or browser",+ "PASSKEY_REQUIRED": "add a passkey in the relay view on your phone or browser, then confirm the move",+ "PERSON_AUTHORITY": "upgrade the relay so it publishes its passkey stamp key, then retry",+ "PERSON_AUTHORITY_CHANGED": "check which relay this board belongs to; link it to the relay it pinned",+ "PERSON_PROPOSAL": "start the person move from a terminal seat, then confirm it with your passkey",+ "PERSON_SIGNED": "confirm it with your passkey in the relay view; pair a phone or browser first with pullboard relay on --all",+ "PERSON_SIGNER_REQUIRED": "decide the other rows with your passkey; a row that names SSH signers waits until signing is off",+ "PERSON_SIGNING_CORRUPT": "restore the board from a known-good export",+ "PERSON_SIGNING_ERASED": "restore a known-good board that keeps its signing history",+ "PERSON_SIGNING_RELAY": "link this board to the relay with pullboard relay on --all, then turn signing on"},"replay": {"initial": {