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
feat(settings): record ranged board line controls [R1,R2,H16,O5,O6]
Corey Olsona3d5245d3abf
diff --git a/docs/formats.md b/docs/formats.mdindex 42fd8aec..8b7855c1 100644--- a/docs/formats.md+++ b/docs/formats.md@@ -529,3 +529,18 @@ A row approved after the board’s compatibility baseline is reported as `agent-Engine 68 retains the existing validated verifier note in new acceptance-event detail. Earlier engines retain their original receipt shape; later person confirmations project current approval state beside that immutable history. No new row status or approval authority is inferred from a Git author or an unsigned receipt.The engine-68 `recordSpecApprovalBaseline` move carries `{agentId, baseline: {version: 1, file, anchor, rows: [{id, text, source}]}}`. `anchor` is the current commit or `null` before the first commit; exact source rows also cover uncommitted initial requirements. Only the authenticated coordinator may establish the snapshot; a person uses the main checkout’s coordinator path. Lane commands never seed or replace it. The first snapshot is indexed under `board_meta.spec_approval_baseline` with a `spec_approval_baseline` event. Replay writes metadata only, never checkout files. Sender attribution is authenticated normally, older engines refuse the new move, and later bootstrap attempts cannot replace or expand the original snapshot. No local sidecar establishes shared approval authority. The metadata snapshot must agree with its single original coordinator event; a partial restore with either half missing or changed is invalid. A malformed stored marker remains in place with an invalid-baseline diagnostic; it is not treated as an absent migration baseline or reseeded by later commands. Board imports remain trusted recovery operations; agreement of these records is a consistency check, not cryptographic authentication of an imported history.++## Recorded board line settings++`pullboard settings line --json` reads six board-owned controller inputs. All default to `false` (off), independently of machine `gate.queue` or `pullboard.json`. `pullboard settings line <name> <on|off|number> --reason "why" --window '{"windowMinutes":60,"activeReviewers":2}'` records a coordinator-owned `setLineSetting` move. The window is a nonempty object of named finite nonnegative numbers, with `null` retaining an unknown measurement. A nonempty reason is required.++| Setting | Enabled values | Off |+| --- | --- | --- |+| `reviewsFirst` | `true` (`on`) | `false` |+| `wipPerReviewer` | 1.5 through 3 | `false` |+| `barReady` | `true` (`on`) | `false` |+| `takeoverMinutes` | whole minutes 15 through 60 | `false` |+| `landingBatchSize` | whole numbers 1 through 8 | `false` |+| `landingCadenceMinutes` | whole minutes 5 through 30 | `false` |++These are recorded inputs only (#1096); this step does not enforce queue, takeover or landing behavior. The move carries `{agentId,key,value,reason,window}`; its native `line_setting` event carries `{key,value,reason,window}` with the board's actor and time outside that detail. Latest values live under `board_meta` keys `line_setting:<name>`, and ordered engine replay updates them and appends the same evidence. The unassigned `LINE_SETTINGS_ENGINE` leaf receives its permanent number at landing. Older engine records cannot request this new operation. Range, unknown-key, missing-reason and invalid-window refusals have named codes. The existing settings API reports each input as `scope: "board"`, key `line.<name>`, with off as its default and the board SQLite file as its source; it does not expose reason text or evidence payloads through that inventory.diff --git a/src/board.js b/src/board.jsindex 7365374e..11780ec4 100644--- a/src/board.js+++ b/src/board.js@@ -1,3 +1,4 @@+export { lineSettings, setLineSetting } from './line-settings.js';import { recordVerdict } from './verdict-assurance.js';import { logEvent } from './board-event-log.js';export { logEvent };diff --git a/src/commands/settings.js b/src/commands/settings.jsindex 9f58e0f5..938f1dbd 100644--- a/src/commands/settings.js+++ b/src/commands/settings.js@@ -1,3 +1,4 @@+import { lineSettingsCommand } from '../line-settings-cli.js';/** The pullboard settings command, in its own module so an item adding another command never edits these lines. */import {SETTING_FORMS,@@ -22,8 +23,9 @@ import {} from '../cli.js';import { boardId } from '../board.js';-/** Read or update machine-wide gate capacity. */-export function settingsCommand(io, { first, second, rest }) {+/** Read or update machine capacity, or delegate explicit board-owned line inputs. */+export function settingsCommand(io, { first, second, rest, values }) {+ if (first === 'line') return lineSettingsCommand(io, { second, rest, values });if (first === 'landing.pool') {if (!['on', 'off'].includes(second) || rest.length) throw new Refused('USAGE', 'pullboard settings landing.pool on|off in the board this machine should land');const ctx = context(io);diff --git a/src/engine.js b/src/engine.jsindex be957778..b630eb15 100644--- a/src/engine.js+++ b/src/engine.js@@ -69,6 +69,7 @@ import { requireCoordinatorHold } from './coordinator-hold.js';import { LANDING_ENVIRONMENT_ENGINE } from './landing-environment-engine.js';import { carriesLandingEnvironment } from './execution-environment.js';import { LANDING_LEASE_ENGINE } from './landing-lease-engine.js';+import { LINE_SETTINGS_ENGINE } from './line-settings-engine.js';const ITEM_ID_FIRST_ARGUMENT = new Set(['acceptCheck', 'editItem', 'escalate', 'recordAttempt', 'claim', 'release', 'submit', 'reserveReview', 'verify', 'merged', 'withdraw', 'refreeze', 'reopen', 'appendFact']);@@ -81,11 +82,11 @@ export const ENGINE_OPERATIONS = Object.freeze(['recordRowDecisions', 'applyRowDecisions', 'draftSpecRow', 'appendFact', 'recordSpecApprovalBaseline','recordLandingBatch', 'recordLandingWaiver', 'recordLandingFlake', 'recordLandingTestDefect', 'finishLandingBatch', 'acceptCheck','recordHealthFindings', 'proposeSentinel', 'decideSentinel', 'beginSentinelRun', 'finishSentinelRun',- 'recordFlakeObservation', 'recordGateRun', 'declareJob', 'recordJobRun', 'takeCoordinator', 'landingLeaseMove',+ 'setLineSetting', 'recordFlakeObservation', 'recordGateRun', 'declareJob', 'recordJobRun', 'takeCoordinator', 'landingLeaseMove',]);/** Engine version at which each ordered operation first has stable replay semantics. */-const OPERATION_ENGINE = Object.freeze({ draftSpecRow: ROW_DRAFT_ENGINE, orderMilestoneItems: MILESTONE_RANK_ENGINE, reopen: 8, recordLandingBatch: 8, recordLandingWaiver: 8, recordLandingFlake: 8, finishLandingBatch: 8, acceptCheck: CHECK_ACCEPT_ENGINE,+const OPERATION_ENGINE = Object.freeze({ setLineSetting: LINE_SETTINGS_ENGINE, draftSpecRow: ROW_DRAFT_ENGINE, orderMilestoneItems: MILESTONE_RANK_ENGINE, reopen: 8, recordLandingBatch: 8, recordLandingWaiver: 8, recordLandingFlake: 8, finishLandingBatch: 8, acceptCheck: CHECK_ACCEPT_ENGINE,shipMilestone: MILESTONE_SHIP_ENGINE, recordSpecApprovalBaseline: SPEC_APPROVAL_ENGINE, takeCoordinator: COORDINATOR_HOLD_ENGINE });/** Dependency edits, causes, sealed reviews, submission proofs, trunk conflicts, health observations and milestone targets retain distinct recorded engine meanings. */diff --git a/src/help.js b/src/help.jsindex 0b3d19e8..139ed415 100644--- a/src/help.js+++ b/src/help.js@@ -24,6 +24,8 @@ Set uppullboard takeover rebind this checkout when the same agent starts a new sessionin a linked main checkout it also takes the board's coordinator herepullboard resources local resource holders and their FIFO queues+ pullboard settings line [<name> <on|off|number> --reason "why" --window <json>] read or record board controller inputs; all off by default, no queue enforcement+ names: reviewsFirst, wipPerReviewer (1.5-3), barReady, takeoverMinutes (15-60), landingBatchSize (1-8), landingCadenceMinutes (5-30)pullboard settings [gateSlots <n> | browserSlots <n>] view or set machine capacity (gate default 2; browser default 1)browser-free check slots are opt-in: gate.browserFreeChecks in ~/.pullboard/settings.json (default false)a test file takes a browser slot only if it launches Chrome: gate.browserByLaunch (default false)@@ -272,6 +274,7 @@ const ADD_EXAMPLE = ['pullboard lane add web --owns src/web', 'pullboard spec dr'pullboard add web "Upload page" --specs G1'].join('\n');const HELP_EXAMPLES = {+ 'settings line': `pullboard settings line reviewsFirst on --reason "reviews are waiting" --window '{"windowMinutes":60}'`,'spec approve': 'pullboard spec approve G1','spec decline': 'pullboard spec decline G1 --reason "The requirement needs revision"','sentinel propose': 'pullboard sentinel propose "Run the checks" --check "npm test" --every hourly --owner web',diff --git a/src/line-settings-cli.js b/src/line-settings-cli.jsnew file mode 100644index 00000000..d8ffa171--- /dev/null+++ b/src/line-settings-cli.js@@ -0,0 +1,36 @@+/** Board-scoped line controls use ordered moves; the existing settings command still owns machine controls. */+import {+ actOn,+ context,+ ordered,+ withBoardRead,+} from './cli.js';+import { lineSettings } from './line-settings.js';+import { LINE_SETTING_DEFINITIONS } from './queue-settings.js';+import { Refused } from './refused.js';++/** Decode explicit triggering observations without confusing stats --window durations with this command's JSON. */+function parseWindow(value) {+ try { return JSON.parse(value); }+ catch { throw new Refused('LINE_SETTING_WINDOW', 'use --window with a JSON object of measured numbers, for example \'{"windowMinutes":60,"activeReviewers":2}\''); }+}++/** Read all board controls or record one coordinator change; no controller enforcement is enabled here. */+export function lineSettingsCommand(io, { second, rest, values = {} }) {+ if (!second && !rest.length) {+ const ctx = context(io);+ const settings = withBoardRead(ctx, lineSettings);+ io.result?.({ lineSettings: settings, ranges: LINE_SETTING_DEFINITIONS });+ for (const [key, value] of Object.entries(settings)) io.say(`${key}: ${value === false ? 'off' : value}`);+ return 0;+ }+ if (!second || rest.length !== 1) throw new Refused('USAGE', 'pullboard settings line <name> <on|off|number> --reason "why" --window \'{"windowMinutes":60}\'');+ const value = rest[0] === 'on' ? true : rest[0] === 'off' ? false : Number(rest[0]);+ return actOn(io, async (ctx, board, me) => {+ const change = await ordered(ctx, board, 'setLineSetting', [{ agentId: me.id, key: second, value,+ reason: values.reason, window: parseWindow(values.window) }]);+ io.result?.({ lineSettings: lineSettings(board), change });+ io.say(`${second}: ${value === false ? 'off' : value}; recorded on this board`);+ return 0;+ });+}diff --git a/src/line-settings-engine.js b/src/line-settings-engine.jsnew file mode 100644index 00000000..81b9eab3--- /dev/null+++ b/src/line-settings-engine.js@@ -0,0 +1,3 @@+/** Board line-policy records receive their permanent engine number at landing (#1096). */+import { unassignedEngine } from './engine-next.js';+export const LINE_SETTINGS_ENGINE = unassignedEngine();diff --git a/src/line-settings.js b/src/line-settings.jsnew file mode 100644index 00000000..43b171f5--- /dev/null+++ b/src/line-settings.js@@ -0,0 +1,51 @@+/** Recorded controller inputs, not machine capacity or active queue enforcement [R1,R2,H16]. */+import { atomic } from './board.js';+import { logEvent } from './board-event-log.js';+import {+ LINE_SETTING_DEFINITIONS,+ validateLineSetting,+} from './queue-settings.js';+import { LINE_SETTINGS_ENGINE } from './line-settings-engine.js';+import { Refused } from './refused.js';++const PREFIX = 'line_setting:';++/** Read the latest recorded values, with every absent control explicitly off. */+export function lineSettings(board) {+ const values = Object.fromEntries(Object.keys(LINE_SETTING_DEFINITIONS).map(key => [key, false]));+ for (const row of board.db.prepare("SELECT meta_key, meta_value FROM board_meta WHERE meta_key GLOB 'line_setting:*'").all()) {+ const key = row.meta_key.slice(PREFIX.length);+ if (!Object.hasOwn(values, key)) continue; // A future engine may have a control this reader does not know.+ let value;+ try { value = JSON.parse(row.meta_value); }+ catch { throw new Refused('LINE_SETTING_RANGE', 'a stored line setting is malformed; restore its recorded board value before changing policy'); }+ validateLineSetting(key, value);+ values[key] = value;+ }+ return values;+}++/** Keep the triggering window as finite numeric observations; null retains an explicitly unknown measurement. */+function windowNumbers(value) {+ if (!value || typeof value !== 'object' || Array.isArray(value) || !Object.keys(value).length+ || Object.entries(value).some(([key, number]) => !/^[A-Za-z][A-Za-z0-9_.-]{0,63}$/u.test(key)+ || number !== null && (typeof number !== 'number' || !Number.isFinite(number) || number < 0))) {+ throw new Refused('LINE_SETTING_WINDOW', 'include a nonempty JSON window of named nonnegative finite numbers (or null for unknown), for example --window \'{"windowMinutes":60,"activeReviewers":2}\'');+ }+ return Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b)));+}++/** Change one board input atomically with its reason and measured window, so ordered replay makes the same event. */+export function setLineSetting(board, { agentId, key, value, reason, window } = {}) {+ if (agentId !== 'coordinator') throw new Refused('COORDINATOR_ONLY', 'ask the coordinator to record a line setting with its reason and window numbers');+ if ((board.executionEngineVersion ?? LINE_SETTINGS_ENGINE) < LINE_SETTINGS_ENGINE) throw new Refused('ENGINE_VERSION', 'upgrade Pullboard before recording or replaying board line settings');+ validateLineSetting(key, value);+ if (typeof reason !== 'string' || !reason.trim()) throw new Refused('LINE_SETTING_REASON', 'give the reason for this change with --reason "what the measured window shows"');+ const change = { key, value, reason: reason.trim(), window: windowNumbers(window) };+ return atomic(board, () => {+ board.db.prepare('INSERT INTO board_meta (meta_key, meta_value) VALUES (?, ?) ON CONFLICT(meta_key) DO UPDATE SET meta_value=excluded.meta_value')+ .run(PREFIX + key, JSON.stringify(value));+ logEvent(board, agentId, 'line_setting', null, change);+ return change;+ });+}diff --git a/src/next-steps.js b/src/next-steps.jsindex aef61082..5bd0eec7 100644--- a/src/next-steps.js+++ b/src/next-steps.js@@ -613,6 +613,10 @@ export const NEXT_STEPS = Object.freeze({UNTRACKED: 'commit or ignore the untracked files, then run the command again',UNKNOWN_TOOL: 'call tools/list and use a tool name returned by that MCP server',USAGE: 'run pullboard help',+ LINE_SETTING_UNKNOWN: 'read pullboard settings line and choose a listed board control',+ LINE_SETTING_RANGE: 'read the allowed range with pullboard settings line, then record an in-range value or off with its reason and window numbers',+ LINE_SETTING_REASON: 'repeat the board setting change with --reason describing the measured window',+ LINE_SETTING_WINDOW: 'repeat the board setting change with --window containing a nonempty JSON object of finite nonnegative measurements or null for unknown',VERIFIER_STANDING: 'ask the coordinator to make an independent verifier from the main checkout: pullboard worktree <lane> --model "<model name>"',VERDICT_ENVIRONMENT: 'run the frozen check with current Pullboard, then have an independent reviewer record a fresh verdict with its actual executor environment',VERDICT_TRUNK_MOVED: 'merge the latest main into the submitted commit and ask another agent to re-review the clean composition',diff --git a/src/queue-settings.js b/src/queue-settings.jsindex 94a2227f..941df18a 100644--- a/src/queue-settings.js+++ b/src/queue-settings.js@@ -85,3 +85,23 @@ export function gateQueueSettings() {const queue = value.gate?.queue;return { reviewsFirst: queue?.reviewsFirst === true, currentReleaseFirst: queue?.currentReleaseFirst === true, agingMinutes: queue?.agingMinutes ?? DEFAULT_QUEUE_AGING_MINUTES };}++/** Board-owned controller inputs; false means off, independently of machine gate settings. */+export const LINE_SETTING_DEFINITIONS = Object.freeze({+ reviewsFirst: Object.freeze({ type: 'boolean' }),+ wipPerReviewer: Object.freeze({ type: 'number', min: 1.5, max: 3, integer: false }),+ barReady: Object.freeze({ type: 'boolean' }),+ takeoverMinutes: Object.freeze({ type: 'number', min: 15, max: 60, integer: true }),+ landingBatchSize: Object.freeze({ type: 'number', min: 1, max: 8, integer: true }),+ landingCadenceMinutes: Object.freeze({ type: 'number', min: 5, max: 30, integer: true }),+});++/** Refuse unknown controls and out-of-range values without changing any live queue behavior. */+export function validateLineSetting(key, value) {+ if (!Object.hasOwn(LINE_SETTING_DEFINITIONS, key)) throw new Refused('LINE_SETTING_UNKNOWN', 'choose a known board line setting from pullboard settings line');+ const definition = LINE_SETTING_DEFINITIONS[key];+ if (value === false || definition.type === 'boolean' && value === true) return;+ if (definition.type === 'number' && typeof value === 'number' && Number.isFinite(value)+ && value >= definition.min && value <= definition.max && (!definition.integer || Number.isSafeInteger(value))) return;+ throw new Refused('LINE_SETTING_RANGE', `${key} accepts off or ${definition.type === 'boolean' ? 'on' : `${definition.integer ? 'whole numbers ' : 'numbers '}${definition.min} to ${definition.max}`}; read pullboard settings line`);+}diff --git a/src/relay-sender.js b/src/relay-sender.jsindex 867b2784..afbe5e52 100644--- a/src/relay-sender.js+++ b/src/relay-sender.js@@ -10,7 +10,7 @@ export function relayMoveActor(move) {if (move.operation === 'addItem') return args[0]?.by ?? null;if (move.operation === 'shout') return args[0]?.from ?? null;if (['proposeSentinel', 'decideSentinel', 'beginSentinelRun', 'finishSentinelRun'].includes(move.operation)) return args[0]?.agentId ?? null;- if (['recordHealthFindings', 'recordFlakeObservation', 'recordGateRun', 'declareJob', 'recordJobRun', 'takeCoordinator', 'landingLeaseMove'].includes(move.operation)) return args[0]?.agentId ?? null;+ if (['setLineSetting', 'recordHealthFindings', 'recordFlakeObservation', 'recordGateRun', 'declareJob', 'recordJobRun', 'takeCoordinator', 'landingLeaseMove'].includes(move.operation)) return args[0]?.agentId ?? null;if (['holdLane', 'releaseLane'].includes(move.operation) && args[1]?.asPerson) return 'person';if (move.operation === 'release') return args[1] ?? null;if (['reserveNextReview', 'addMilestone', 'recordRowDecisions', 'applyRowDecisions', 'draftSpecRow', 'recordSpecApprovalBaseline', 'recordLandingBatch', 'recordLandingWaiver', 'recordLandingFlake', 'recordLandingTestDefect', 'finishLandingBatch'].includes(move.operation)) return args[0]?.agentId ?? null;diff --git a/src/settings-inventory.js b/src/settings-inventory.jsindex c0280e7d..8cc0ec9a 100644--- a/src/settings-inventory.js+++ b/src/settings-inventory.js@@ -15,6 +15,8 @@ import { machineHome } from './machine-home.js';import {machineSettingsFile,gateQueueSettings,+ LINE_SETTING_DEFINITIONS,+ validateLineSetting,} from './queue-settings.js';import { loadMachineSettings } from './settings.js';import { performanceCores } from './gate.js';@@ -169,6 +171,26 @@ function repositorySettings(rows, board) {source: existsSync(keyFile) ? keyFile : keyEnvironment !== undefined ? 'environment:PULLBOARD_RELAY_KEY' : relay.keyStorage === 'keychain' ? 'system keychain' : keyFile });}+/** Include board-owned line inputs in the existing read-only inventory, without exposing reasons or window evidence. */+function boardLineSettings(rows, board) {+ const file = join(repoInfo(board.root).commonDir, 'pullboard', 'board.sqlite');+ const db = new DatabaseSync(file, { readOnly: true });+ try {+ const read = db.prepare('SELECT meta_value FROM board_meta WHERE meta_key = ?');+ for (const key of Object.keys(LINE_SETTING_DEFINITIONS)) {+ const stored = read.get('line_setting:' + key);+ let value = false;+ if (stored) {+ try { value = JSON.parse(stored.meta_value); }+ catch { throw new Refused('BAD_SETTINGS', 'a stored board line setting is malformed; restore its recorded value'); }+ }+ validateLineSetting(key, value);+ rows.push({ key: 'line.' + key, scope: 'board', board: board.id, root: board.root,+ value, default: false, source: file, origin: stored ? 'configured' : 'default' });+ }+ } finally { db.close(); }+}+/** Read a registered board identity without creating, migrating, or repairing its database. */function registeredBoard(project) {const info = repoInfo(project.root);@@ -199,6 +221,6 @@ export function settingsInventory(projects, selected = null) {const authorized = selected === null ? boards : boards.filter(board => board.id === selected);if (selected !== null && !authorized.length) throw new Refused('NO_BOARD', 'no registered board with this identity; use GET /api/v1/boards');machineSettings(rows);- for (const board of authorized) repositorySettings(rows, board);+ for (const board of authorized) { repositorySettings(rows, board); boardLineSettings(rows, board); }return { settings: rows, ...(warnings.length ? { warnings } : {}) };}diff --git a/test/line-settings.test.js b/test/line-settings.test.jsnew file mode 100644index 00000000..d2039642--- /dev/null+++ b/test/line-settings.test.js@@ -0,0 +1,70 @@+/** Line controls retain board authority, typed evidence and read-only inventory boundaries [R1,R2,H16,O5,O6]. */+import assert from 'node:assert/strict';+import { mkdtempSync, rmSync } from 'node:fs';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import { test } from 'node:test';+import * as store from '../src/board.js';+import { applyRelayMove, prepareEngineMove } from '../src/engine.js';+import { settingsInventory } from '../src/settings-inventory.js';+import { createE2eHelpers } from './e2e-helpers.js';++/** A private SQLite board with coordinator and builder identities. */+function fixture(t) {+ const root = mkdtempSync(join(tmpdir(), 'pullboard-line-setting-'));+ const board = store.openBoard(join(root, 'board.sqlite'));+ store.register(board, { lane: 'coordinator', path: root });+ store.register(board, { lane: 'web', path: join(root, 'web') });+ t.after(() => { store.closeBoard(board); rmSync(root, { recursive: true, force: true }); });+ return board;+}++/** A valid typed change, with one deliberately unknown measurement. */+function change(overrides = {}) {+ return { agentId: 'coordinator', key: 'barReady', value: true, reason: 'PRIVATE_REASON_CANARY',+ window: { windowMinutes: 60, activeReviewers: 2, reviewMedianMinutes: null }, ...overrides };+}++test('line setting evidence and coordinator authority cannot be omitted or forged [R1,R2,H16]', t => {+ const board = fixture(t);+ const baseline = store.events(board).length;+ for (const [options, code] of [[change({ agentId: 'web-1' }), /COORDINATOR_ONLY/u],+ [change({ key: 'unknown' }), /LINE_SETTING_UNKNOWN/u], [change({ reason: '' }), /LINE_SETTING_REASON/u],+ [change({ reason: ' ' }), /LINE_SETTING_REASON/u], [change({ window: {} }), /LINE_SETTING_WINDOW/u],+ [change({ window: { count: -1 } }), /LINE_SETTING_WINDOW/u], [change({ window: { count: Infinity } }), /LINE_SETTING_WINDOW/u],+ [change({ window: { count: '2' } }), /LINE_SETTING_WINDOW/u]]) {+ assert.throws(() => store.setLineSetting(board, options), code);+ assert.equal(store.events(board).length, baseline);+ assert.equal(store.lineSettings(board).barReady, false);+ }+ const move = prepareEngineMove(board, 'setLineSetting', [change()], { id: 'line-auth-binding', actor: 'coordinator' });+ const refused = applyRelayMove(board, move, { sequence: 1, at: '2026-10-24T00:00:00Z', kind: 'move',+ sender: { kind: 'agent', agent: 'web-1', userId: 'fixture' } });+ assert.equal(refused.error.code, 'RELAY_SENDER_MISMATCH');+ assert.equal(store.lineSettings(board).barReady, false);+ assert.throws(() => applyRelayMove(board, { ...move, engine: 1 }, { sequence: 2, at: '2026-10-24T00:01:00Z', kind: 'move',+ sender: { kind: 'agent', agent: 'coordinator', userId: 'fixture' } }), /RELAY_MOVE/u, 'an old engine cannot reinterpret the new move');+ store.setLineSetting(board, change());+ store.setLineSetting(board, change({ value: false }));+ assert.equal(store.lineSettings(board).barReady, false, 'off is explicit and recorded, not a missing value');+ assert.equal(store.events(board).filter(event => event.event_kind === 'line_setting').length, 2);+});++test('the settings inventory exposes board line values and defaults without audit text [O5,O6,R1]', t => {+ const helpers = createE2eHelpers();+ const box = helpers.project('true');+ let board;+ t.after(() => { if (board) store.closeBoard(board); helpers.cleanup(); });+ board = store.openBoard(join(box.repo, '.git', 'pullboard', 'board.sqlite'));+ store.setLineSetting(board, change({ key: 'wipPerReviewer', value: 2 }));+ const before = store.events(board).length;+ const rows = settingsInventory([{ root: box.repo }]).settings.filter(row => row.scope === 'board' && row.key.startsWith('line.'));+ assert.equal(rows.length, 6);+ assert.deepEqual(rows.find(row => row.key === 'line.wipPerReviewer'), { key: 'line.wipPerReviewer', scope: 'board',+ board: store.boardId(board), root: box.repo, value: 2, default: false,+ source: join(box.repo, '.git', 'pullboard', 'board.sqlite'), origin: 'configured' });+ assert.equal(rows.find(row => row.key === 'line.reviewsFirst').value, false);+ assert.equal(rows.find(row => row.key === 'line.reviewsFirst').origin, 'default');+ assert.doesNotMatch(JSON.stringify(rows), /PRIVATE_REASON_CANARY|activeReviewers|reviewMedianMinutes/u);+ assert.equal(store.events(board).length, before, 'inventory is a read, not a line-setting change');+});