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
chore: merge main into signed person move recovery [H16]
Corey Olsonffda29446147
diff --cc docs/formats.mdindex 1260dcbe,f5925de0..bfba9728--- a/docs/formats.md+++ b/docs/formats.md@@@ -115,13 -115,13 +115,15 @@@ 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` | `130` | `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` | `132` | `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.+ Engine 130 (`MECHANICAL_MERGE_ENGINE`) gives new automatic conflict returns version-two `computedConflict` receipts. Health, fresh conflict returns and landing share conservative mechanical decisions: structural JSON retains independent additions and unchanged-value removals, jointly raised numeric counters keep the larger value, and add-only text unions must pass a syntax-only check for JavaScript. Health classifies declared generated `docs/lifecycle.md` without executing item code; only landing runs its generator in the merged tree before its gate. A failed generator blocks with `LAND_MERGE`, naming the item, file and generator, rather than reopening accepted work as a conflict. Version-one receipts continue to verify their original plain-Git conflict paths on replay; version-two receipts verify mechanical conflict paths. The receipt version is part of the immutable-object cache identity. Fresh authors cannot reuse version-one semantics, and a version-two receipt requires engine 130 before changing a board or replay cursor.+Relay transport capability `apiVersion: 2` is independent of these versions andof the unchanged `version: 1` HTTP envelope and seal envelope. API2 uses`pullboard-paged-snapshot/1` inside encrypted directory pages, with a current-statediff --cc src/commands/add.jsindex c81d574a,33622da1..2b793626--- a/src/commands/add.js+++ b/src/commands/add.js@@@ -1,9 -1,8 +1,13 @@@+import {+ confirmBarEffect,+ executingBarEffect,+ personBarMode,+} from '../person-bar-cli.js';import { dependencyValues } from '../item-dependencies.js';+ import {+ referenceAuthors,+ referenceAuthority,+ } from '../reference-authors.js';/** The pullboard add command, in its own module so an item adding another command never edits these lines. */import * as store from '../board.js';import {@@@ -74,19 -74,11 +78,23 @@@ export async function run(io, args)route: values.route ?? 'strong',check: values.check,};- buildInFilelessLane(ctx.config, first, after);+ const sealed = executingBarEffect(ctx, board, 'add');+ if (sealed) item = { ...sealed };+ if (sealed) {+ const sealedProblems = idProblems(loadSpec(ctx.info.root, ctx.config), item.specIds, ctx.doctrine);+ if (sealedProblems.length) throw new Refused('UNKNOWN_SPEC', sealedProblems.join('; '));+ briefInLane(ctx, item.lane, item.brief);+ }+ const asPerson = personBarMode(ctx, board, me, values);+ const confirmed = await confirmBarEffect(ctx, board, me, { verb: 'add', args: {+ lane: item.lane, title: item.title, ...(values.wait ? { wait: true } : {}), as: 'person',+ } }, item, asPerson);+ if (confirmed !== null) return confirmed;+ buildInFilelessLane(ctx.config, item.lane, item.after);+ const authority = referenceAuthority(ctx, me.id, item.brief);+ if (authority) item.referenceAuthority = authority;+ const authors = referenceAuthors(ctx.info.root, item.brief);+ if (authors.length) item.referenceAuthors = authors;const { command } = store.validateItemAddition(board, item);if (command) refuseCheckSyntax(command);if (command) item.checkBaseline = values.wait ? checkBaseline(ctx.info.root, command) : prepareCheckBaseline(ctx.info.root, command);diff --cc src/commands/edit.jsindex fb466cbc,3cf24d6e..ef84d429--- a/src/commands/edit.js+++ b/src/commands/edit.js@@@ -1,9 -1,8 +1,13 @@@+import {+ confirmBarEffect,+ executingBarEffect,+ personBarMode,+} from '../person-bar-cli.js';import { barReadySetting } from '../bar-readiness.js';+ import {+ referenceAuthors,+ referenceAuthority,+ } from '../reference-authors.js';/** The pullboard edit command, in its own module so an item adding another command never edits these lines. */import * as store from '../board.js';import {@@@ -55,11 -54,12 +59,17 @@@ export async function run(io, args)after: editAfter(values.after),...(values.reason !== undefined ? { reason: values.reason } : {}),};+ if (sealed) change = { ...sealed };+ const asPerson = personBarMode(ctx, board, me, values);+ const confirmed = await confirmBarEffect(ctx, board, me, { verb: 'edit', item: id,+ args: { as: 'person', ...(values.wait ? { wait: true } : {}) } }, change, asPerson);+ if (confirmed !== null) return confirmed;+ if (change.brief !== undefined) {+ const authority = referenceAuthority(ctx, me.id, change.brief, store.getItem(board, id).item_brief);+ if (authority) change.referenceAuthority = authority;+ const authors = referenceAuthors(ctx.info.root, change.brief);+ if (authors.length) change.referenceAuthors = authors;+ }const { item, command } = store.validateItemEdit(board, id, change);if (command && command !== item.item_check) refuseCheckSyntax(command);if (command && (command !== item.item_check || barReadySetting(board).enabled)) change.checkBaseline = values.wait ? checkBaseline(ctx.info.root, command) : prepareCheckBaseline(ctx.info.root, command);diff --cc src/relay-sender.jsindex c9027164,cd66e6dc..90b8e1c9--- a/src/relay-sender.js+++ b/src/relay-sender.js@@@ -35,8 -38,8 +41,8 @@@ function personReferenceMove(move)* person fact or request, or any move whose actor is the person. On a board that names approvers, only an approver's* session makes one [E4].*/-function personAuthority(move) {- return personReferenceMove(move) || personBarMove(move) || personFact(move) || ['recordRowDecisions', 'decideSpecRevisions', 'decideSentinel'].includes(move?.operation) || move?.operation === 'answerDecision' && Boolean(move.args?.[1]?.asPerson) ||+export function personAuthority(move) {- return personBarMove(move) || personFact(move) || ['holdLane', 'releaseLane'].includes(move?.operation) && Boolean(move.args?.[1]?.asPerson) || ['recordRowDecisions', 'decideSpecRevisions', 'decideSentinel'].includes(move?.operation) || move?.operation === 'answerDecision' && Boolean(move.args?.[1]?.asPerson) ||++ return personReferenceMove(move) || personBarMove(move) || personFact(move) || ['holdLane', 'releaseLane'].includes(move?.operation) && Boolean(move.args?.[1]?.asPerson) || ['recordRowDecisions', 'decideSpecRevisions', 'decideSentinel'].includes(move?.operation) || move?.operation === 'answerDecision' && Boolean(move.args?.[1]?.asPerson) ||move?.operation === 'shout' && Boolean(move.args?.[0]?.request) || relayMoveActor(move) === 'person';}