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(core): compose relay repair with accepted trunk [E12,H16]
Corey Olson26a580afe280
diff --cc docs/formats.mdindex c1cf0cd9,60617ceb..7329f527--- a/docs/formats.md+++ b/docs/formats.md@@@ -678,6 -692,8 +693,11 @@@ replays activity. Reads freeze an evenand messages remain pending. News has a separate cursor so an ordinary poll cannot consume afuture session-start digest.+### Signed board membership++`setBoardMembers` records an exact next revision in `board_meta.board_members` and a `board_members` event. Its signed document is `{body:{v:1,board,repository,revision,members},by,signature}`; the SSH namespace is `pullboard-board-members` and the bytes are the JSON array `["pullboard-board-members",body,by]`. Repeating the identical document is idempotent. A new empty list removes all additional members. Native ordered transport and checkpoints seal this document with the board key. A key handover independently checks the approving login against committed `pullboard.json` approvers and its SSH signature against GitHub; stored or relay-provided identity flags alone never authorize a handover. Every requester also proves ownership of its own device key. The current native revision is authoritative; an old signature cannot roll back that state.+ ## Seat addresses++ A seat address is `pullboard:<board-id>:<percent-encoded-seat-id>`, where `board-id` is the board’s existing 32-character hexadecimal `board_id` and the seat component is the canonical JavaScript `encodeURIComponent` encoding of its registered agent id. It is independent of machine and checkout path. `whoami` and `agents` expose it; `shout` resolves it only within the current board and records the existing shout event with the exact recipient agent id. It is a destination, never a grant. Existing relay board credentials and authenticated sender attribution remain required on linked boards. No new stored event or file format is introduced.++ The activity-delivery engine, numbered at landing, adds recipient-owned `recordActivityDelivery` and `actOnActivity` moves. Interrupt ids bind a native event (`event:<id>`) or an exact claim lease (`claim:<item>:<lease-until>`). A delivery event lists only interrupts actually included in that recipient's response; an acted event records a separate explicit acknowledgement. An inbox cursor or reading a response never means acted-on. Both moves use the joined recipient as their authenticated actor, preserve earlier event history, and refuse on an older replay engine before changing its prefix. Delivery state in indexed `board_meta` keys is part of the native board and its exports, not a checkout-only cursor. `through` is the safely covered interrupt prefix, `observedThrough` is the read snapshot's high-water mark, and optional `digestThrough` is the separately delivered digest prefix; an elided interrupt must remain available after a later small interrupt is delivered.diff --cc src/board.jsindex 9769f679,3b68d872..694689a0--- a/src/board.js+++ b/src/board.js@@@ -1,4 -1,4 +1,5 @@@+export { readBoardMembers, setBoardMembers } from './board-members.js';+ import * as activityDeliveryStore from './activity-delivery-store.js';import { requireFactKind } from './item-notes.js';import { activityNewsFlag } from './activity-news.js';import { migrateEventLogVersion } from './board-event-log-migrate.js';diff --cc src/recorded-move.jsindex a14686e8,27da8b43..fcb9eafc--- a/src/recorded-move.js+++ b/src/recorded-move.js@@@ -28,7 -28,7 +28,8 @@@ export function requestedCommandMove(corefreeze: ['refreeze'], reopen: ['reopen'], escalate: ['escalate', 'shout'],next: ['claim', 'reserveReview', 'reserveNextReview'], run: ['claim', 'release', 'submit', 'reserveReview', 'reserveNextReview', 'verify', 'escalate', 'shout'],init: ['register'], join: ['register'], worktree: ['register'], takeover: ['takeCoordinator'],+ relay: ['setBoardMembers'],+ inbox: ['recordActivityDelivery', 'actOnActivity'],shout: ['shout'], answer: ['answerDecision'], pass: ['passDecision'], fact: ['appendFact'],hold: ['holdLane', 'releaseLane', 'holdItem', 'releaseItemHold'],bar: ['setBarReady', 'signBar'], settings: ['setLineSetting', 'setPersonSigning'], check: ['acceptCheck'],diff --cc test/boundary.test.jsindex 3b42a1bd,61f196c5..49c6b6dc--- a/test/boundary.test.js+++ b/test/boundary.test.js@@@ -36,11 -36,9 +36,11 @@@ test('the core names no model, engine oassert.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), {') ||+ // relay on's key hand-over reads a person's public SSH keys from GitHub itself, so the relay cannot add one [E17].+ (file === 'src/relay-handover.js' && line.trim() === "const response = await fetch(new URL('users/' + encodeURIComponent(login) + '/keys', base.href.endsWith('/') ? base : base.href + '/'),") ||(['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.jsonindex 35bf04f9,dc7d7fa4..4f1ba7d5--- a/test/move-registry-baseline.json+++ b/test/move-registry-baseline.json@@@ -63,7 -63,8 +63,9 @@@"takeCoordinator","landingLeaseMove","recordPublishFinding",+ "actOnActivity",- "recordActivityDelivery"++ "recordActivityDelivery",+ "setBoardMembers"],"itemIdFirstArgument": ["signBar",@@@ -633,13 -634,21 +635,29 @@@null,null],+ "actOnActivity": [+ null,+ "first",+ null,+ null,+ null,+ null+ ],+ "recordActivityDelivery": [+ null,+ "first",+ null,+ null,+ null,+ null++ ],+ "setBoardMembers": [+ null,+ "first",+ null,+ null,+ null,+ null]},"floorCases": [@@@ -6962,9 -6974,9 +6983,12 @@@"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",+ "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"++ "STALE_ACTIVITY_RECEIPT": "read inbox again; the claim changed before delivery was recorded",+ "BOARD_MEMBERS_INVALID": "ask a committed approver to publish a complete signed board member list",+ "BOARD_MEMBERS_REVISION": "read the current member revision, then sign a new list",+ "RELAY_NOT_MEMBER": "ask a committed approver to publish the board member list with pullboard relay members set <login>, then retry relay on"},"replay": {"initial": {diff --cc test/relay-credential.test.jsindex 5f5ef171,e4b5957d..3ef49006--- a/test/relay-credential.test.js+++ b/test/relay-credential.test.js@@@ -29,9 -29,10 +29,11 @@@ test('every current operation selects iif (['claim', 'refreeze'].includes(operation)) args = [box.before.tables.item[0].item_id, options];if (operation === 'reserveNextReview') args = [options];if (operation === 'setLineSetting') args = [{ agentId: actor, key: 'reviewsFirst', value: true, reason: 'credential fixture', window: { windowMinutes: 60, activeReviewers: 1 } }];+ if (operation === 'setBoardMembers') args = [{ agentId: actor, document: null }]; // Native format refusal still exercises the authenticated credential.if (operation === 'setBarReady') args = [{ agentId: actor, enabled: false }];if (operation === 'recordHealthFindings') args = [{ agentId: actor, observedRevision: 0, findings: [] }];+ if (operation === 'recordActivityDelivery') args = [{ agentId: actor, through: 0, interrupts: [] }];+ if (operation === 'actOnActivity') args = [{ agentId: actor, ids: ['event:1'] }];if (operation === 'recordSpecApprovalBaseline') args = [{ agentId: actor, baseline: { version: 1, file: 'SPEC.md', anchor: null, rows: [] } }];if (operation === 'recordFlakeObservation') args = [{ agentId: actor, lane: box.lane, observation: syntheticFlakeObservation('credential-fixture') }];if (operation === 'recordGateRun') args = [{ agentId: actor, lane: box.lane, receipt: { version: 1, id: '00000000-0000-4000-8000-00000000c0de', kind: 'gate', tree: 'b'.repeat(40), head: 'a'.repeat(40),@@@ -75,7 -76,8 +77,9 @@@{ operation: 'takeHandoff', args: [{ item: 999999 }], kind: 'agent', sent: false, expected: 'RELAY_ACTOR' },{ operation: 'recordPublishFinding', args: [{ item: 999999 }], kind: 'agent', sent: false, expected: 'RELAY_ACTOR' },{ operation: 'recordHealthFindings', args: [{ observedRevision: 0, findings: [] }], kind: 'agent', sent: false, expected: 'RELAY_ACTOR' },+ { operation: 'setBoardMembers', args: [{ document: null }], kind: 'agent', sent: false, expected: 'RELAY_ACTOR' },+ { operation: 'recordActivityDelivery', args: [{ through: 0, interrupts: [] }], kind: 'agent', sent: false, expected: 'RELAY_ACTOR' },+ { operation: 'actOnActivity', args: [{ ids: ['event:1'] }], kind: 'agent', sent: false, expected: 'RELAY_ACTOR' },{ operation: 'recordSpecApprovalBaseline', args: [{ baseline: { version: 1, file: 'SPEC.md', anchor: null, rows: [] } }], kind: 'agent', sent: false, expected: 'RELAY_ACTOR' },{ operation: 'recordFlakeObservation', args: [{ lane: box.lane, observation: syntheticFlakeObservation('missing-actor') }], kind: 'agent', sent: false, expected: 'RELAY_ACTOR' },{ operation: 'recordGateRun', args: [{ lane: box.lane, receipt: {} }], kind: 'agent', sent: false, expected: 'GATE_RUN_EVIDENCE' },