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 branch 'main' into core/408-signed-person-moves

Corey Olson26c27cc27018
diff --cc docs/formats.md
index 4608ebca,070f586b..6b920bda
--- 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` | `113` | `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` | `116` | `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 and
diff --cc src/commands/status.js
index cf38321a,7a4e0db8..b90c2bc1
--- a/src/commands/status.js
+++ b/src/commands/status.js
@@@ -41,11 -39,10 +42,12 @@@ export async function run(io, { values
relayLinked: relay?.relayLinked ?? (() => false) }, readers);
const mine = store.itemsInStatus(board, 'claimed', me.id);
const approvalState = personNeedsSummary(ctx.info.root, { board, config: ctx.config });
- return { me, mine, 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(),
submitInvariantProposals: submitInvariantProposals(store.submitInvariantEvents(board, ctx.config), ctx.config) };
});
+ summary.memoryHeld = memoryHeldRuns();
if (values.json) {
io.result(summary);
return 0;
@@@ -58,7 -55,8 +60,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));
+ 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));
for (const need of summary.needs.filter(need => need.kind === 'agent-approved')) io.say(`${need.text}; ${need.what}`);
if (!summary.relay.linked && !originRepository(ctx.info.root, { optional: true })) {
diff --cc test/boundary.test.js
index 85169166,61f196c5..d26057e2
--- a/test/boundary.test.js
+++ b/test/boundary.test.js
@@@ -36,11 -36,9 +36,11 @@@ test('the core names no model, engine o
assert.deepEqual(found, []);
});
- test('only explicit relay commands open outbound connections; the view and API stay on loopback [P5, H15, H17, N26, A2]', () => {
+ test('only explicit relay commands open outbound connections; the view defaults to loopback and API stays loopback [P5, H15, H17, H19, N26, A2]', () => {
const allowed = (file, line) => file === 'src/relay.js' ||
(file === 'src/relay-pairing-client.js' && line.trim() === 'response = await fetch(new URL(path, url), {') ||
+ // A board that signs person moves reads its linked relay's person authority, the relay link it already holds (#408).
+ (file === 'src/person-signing-cli.js' && line.trim() === "const response = await fetch(new URL(AUTHORITY_PATH, origin), { redirect: 'error', signal: AbortSignal.timeout(timeoutMs) });") ||
(['src/serve.js', 'src/api.js'].includes(file) && line.trim() === "import { createServer } from 'node:http';") ||
(file === 'src/local-fetch.js' && line.trim() === "import { request as httpRequest } from 'node:http';") ||
(file === 'src/serve.js' && line.trim() === "const reply = await fetch(address.origin + path, { headers: { 'x-pullboard-key': address.searchParams.get('k') } });") ||
diff --cc test/move-registry-baseline.json
index b42aec7c,dc7d7fa4..5d764714
--- a/test/move-registry-baseline.json
+++ b/test/move-registry-baseline.json
@@@ -63,9 -63,8 +63,11 @@@
"takeCoordinator",
"landingLeaseMove",
"recordPublishFinding",
+ "decideSpecRevisions",
+ "proposePersonMove",
- "setPersonSigning"
++ "setPersonSigning",
+ "actOnActivity",
+ "recordActivityDelivery"
],
"itemIdFirstArgument": [
"signBar",
@@@ -635,29 -634,21 +637,45 @@@
null,
null
],
+ "decideSpecRevisions": [
+ null,
+ "first",
+ null,
+ null,
+ null,
+ null
+ ],
+ "proposePersonMove": [
+ null,
+ "first",
+ null,
+ null,
+ null,
+ null
+ ],
+ "setPersonSigning": [
+ null,
+ "first",
+ null,
+ null,
+ null,
+ null
++ ],
+ "actOnActivity": [
+ null,
+ "first",
+ null,
+ null,
+ null,
+ null
+ ],
+ "recordActivityDelivery": [
+ null,
+ "first",
+ null,
+ null,
+ null,
+ null
]
},
"floorCases": [
@@@ -6980,26 -6974,9 +6998,32 @@@
"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",
"EXCLUDED_REPOSITORY": "restore the GitHub origin of each excluded project, then run pullboard relay on --all",
"EXCLUDED_INVENTORY": "restore at most 256 excluded boards and their active paired devices, then run pullboard relay on --all",
+ "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",
+ "GIT_SYNC_LOG": "restore the append-only refs/pullboard/board history on origin before running pullboard sync",
+ "GIT_SYNC_REMOTE": "restore read/write access to origin, then retry the original command or run pullboard sync; keep its pending sealed move",
+ "GIT_SYNC_LOCAL_CHANGED": "run pullboard export to preserve local moves, then ask the coordinator to reconcile the local and remote prefixes before syncing",
+ "GIT_SYNC_LINKED": "use pullboard sync for a Git-shared board, or keep the existing relay linked; do not enable a second move order",
+ "RUNNER_REQUIRED_FOR_ZERO_CAPACITY": "restore positive gateSlots and browserSlots with pullboard settings before removing the last registered runner",
+ "BAD_NEWS": "send news from the coordinator or person to all, without item, decision, request or answer",
+ "FACT_INDEX_NOT_READY": "have the owning main checkout open this board once, then retry the original fact operation",
- "SPEC_REVISION": "refresh Needs you and decide the exact pending proposal"
++ "SPEC_REVISION": "refresh Needs you and decide the exact pending proposal",
++ "MILESTONE_PLACE": "pin, sink or lift: pullboard milestone pin <name> <ids> --reason \"<why>\"",
++ "MILESTONE_REASON": "say why the item moves: pullboard milestone sink <name> <ids> --reason \"<why>\"",
++ "SEAT_ADDRESS_BOARD": "open a linked checkout of the addressed board with your own grant, then run pullboard shout <address> <text>",
+ "BAD_ACTIVITY_RECEIPT": "read your own inbox again and use its exact interrupt ids",
+ "ACTIVITY_NOT_DELIVERED": "read your own inbox before marking its interrupt acted on",
+ "STALE_ACTIVITY_RECEIPT": "read inbox again; the claim changed before delivery was recorded"
},
"replay": {
"initial": {