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
fix(board): merge trunk; schema 3 gives old boards #1044 indexes [C7]
Corey Olson2f54a1db8599
diff --cc src/board.jsindex 90cec64a,e6582620..6513b1ab--- a/src/board.js+++ b/src/board.js@@@ -28,17 -28,9 +28,18 @@@ import { sharedSchemaDiagnostic } fromimport { reportSharedSchema } from './board-schema.js';import { DatabaseSync } from 'node:sqlite';import { boardNotWritable } from './board-access.js';+ import { ensureHotIndexes } from './board-hot.js';import { boardBusyError } from './board-access.js';export { boardBusyError } from './board-access.js';+import {+ boardIsCurrent,+ boardStanding,+ migrate,+ recordSchemaStamp,+ reportDrift,+ schemaDigest,+} from './board-migrate.js';+export { schemaMissing, writeRefused } from './board-migrate.js';import {briefFiles,briefSections,@@@ -332,16 -309,11 +333,17 @@@ export function openBoard(file, clockif (file !== ':memory:' && isMain !== false) db.exec('PRAGMA journal_mode = WAL');const board = { db, clock };if (isMain !== false || file === ':memory:') {- migrateEventLogVersion(db);- migrate(db);- ensureHotIndexes(db);- db.prepare('INSERT OR IGNORE INTO board_meta (meta_key, meta_value) VALUES (?, ?)').run('board_id', randomBytes(16).toString('hex'));- guardStore(board);+ // Migrate and audit only a board whose version is behind; a drifted shape is reported and left alone (#1047).+ const standing = boardStanding(db, SCHEMA_DIGEST, SCHEMA_VERSION, readEventLogVersion(db) < EVENT_LOG_VERSION);+ if (standing === 'behind') {+ migrateEventLogVersion(db);+ migrate(db);++ ensureHotIndexes(db);+ db.prepare('INSERT OR IGNORE INTO board_meta (meta_key, meta_value) VALUES (?, ?)').run('board_id', randomBytes(16).toString('hex'));+ guardStore(board);+ }+ if (standing === 'behind' || standing === 'unstamped') recordSchemaStamp(db, SCHEMA_DIGEST);+ if (standing === 'drifted') reportDrift(file, onDiagnostic);} else {// Read compatibility before any local effect; persistent schema belongs to trunk alone.readEventLogVersion(db);@@@ -376,7 -348,7 +378,7 @@@ function guardMoves(board)}/** The board's PRAGMA user_version once its triggers are in: losing one after that is news. */--export const SCHEMA_VERSION = 2;++export const SCHEMA_VERSION = 3;const GUARDED = 1;/**diff --cc test/api-identity.test.jsindex 082e49f2,082e49f2..cb5e436a--- a/test/api-identity.test.js+++ b/test/api-identity.test.js@@@ -82,7 -82,7 +82,7 @@@ test('[A2] an older board gains one idetry {id = store.boardId(upgraded);assert.match(id, /^[0-9a-f]{32}$/);-- assert.equal(upgraded.db.prepare('PRAGMA user_version').get().user_version, 2);++ assert.equal(upgraded.db.prepare('PRAGMA user_version').get().user_version, 3);assert.deepEqual(upgraded.db.prepare('SELECT * FROM agent ORDER BY agent_id').all(), before.agents);assert.deepEqual(upgraded.db.prepare('SELECT * FROM item ORDER BY item_id').all(), before.items);assert.deepEqual(upgraded.db.prepare('SELECT * FROM event ORDER BY event_id').all(), before.events);diff --cc test/api.test.jsindex 0ce3a2cb,c24268ff..6097eb3d--- a/test/api.test.js+++ b/test/api.test.js@@@ -368,7 -367,7 +368,7 @@@ test('[A5, A6] a future-schema worktreassert.equal(initialized.status, 0, initialized.stderr + initialized.stdout);const dbFile = join(repo, '.git', 'pullboard', 'board.sqlite');const prior = new DatabaseSync(dbFile, { readOnly: true });-- assert.equal(prior.prepare('PRAGMA user_version').get().user_version, 2);++ assert.equal(prior.prepare('PRAGMA user_version').get().user_version, 3);prior.close();const installed = join(box.dir, 'installed-pullboard');@@@ -384,7 -382,7 +384,7 @@@});assert.equal(installedRun.status, 0, installedRun.stderr + installedRun.stdout);const migratedInstalled = new DatabaseSync(dbFile, { readOnly: true });-- assert.equal(migratedInstalled.prepare('PRAGMA user_version').get().user_version, 2,++ assert.equal(migratedInstalled.prepare('PRAGMA user_version').get().user_version, 3,'a copied installed release without Git metadata can upgrade an older board');assert.ok(migratedInstalled.prepare('PRAGMA table_info(item)').all().some((column) => column.name === 'item_files'));migratedInstalled.close();@@@ -392,10 -390,10 +392,10 @@@const older = new DatabaseSync(dbFile);older.exec('ALTER TABLE item DROP COLUMN item_files; PRAGMA user_version = 1');older.close();- const upgraded = runFixture(repo, 'status', '--json');+ const upgraded = runFixture(repo, 'shout', 'app', 'board upgrade', '--json');assert.equal(upgraded.status, 0, upgraded.stderr + upgraded.stdout);const migrated = new DatabaseSync(dbFile, { readOnly: true });-- assert.equal(migrated.prepare('PRAGMA user_version').get().user_version, 2);++ assert.equal(migrated.prepare('PRAGMA user_version').get().user_version, 3);assert.ok(migrated.prepare('PRAGMA table_info(item)').all().some((column) => column.name === 'item_files'));migrated.close();@@@ -412,24 -410,22 +412,24 @@@});assert.equal(mainCodeFromWorktree.status, 0, mainCodeFromWorktree.stderr + mainCodeFromWorktree.stdout);const migratedFromWorktree = new DatabaseSync(dbFile, { readOnly: true });-- assert.equal(migratedFromWorktree.prepare('PRAGMA user_version').get().user_version, 2,++ assert.equal(migratedFromWorktree.prepare('PRAGMA user_version').get().user_version, 3,'the main checkout code may upgrade its shared board even when cwd is a linked worktree');assert.ok(migratedFromWorktree.prepare('PRAGMA table_info(item)').all().some((column) => column.name === 'item_files'));migratedFromWorktree.close();const boardSource = join(linked, 'src/board.js');+ const migrateSource = join(linked, 'src/board-migrate.js');const oldSource = readFileSync(boardSource, 'utf8');- const migration = " ['shout', 'shout_request_outcome', \"TEXT NOT NULL DEFAULT ''\"],\n ];";- assert.ok(oldSource.includes('export const SCHEMA_VERSION = 2;'));- assert.ok(oldSource.includes(migration));- const newSource = oldSource- .replace('export const SCHEMA_VERSION = 2;', 'export const SCHEMA_VERSION = 3;')- .replace(migration, migration.replace('\n ];', "\n ['item', 'item_unmerged_probe', 'INTEGER NOT NULL DEFAULT 0'],\n ];"));- assert.notEqual(newSource, oldSource, 'the unmerged worktree carries a real schema-3 migration');+ const oldMigrations = readFileSync(migrateSource, 'utf8');+ const migration = " ['shout', 'shout_request_outcome', \"TEXT NOT NULL DEFAULT ''\"],\n];";- assert.ok(oldSource.includes('export const SCHEMA_VERSION = 2;'));++ assert.ok(oldSource.includes('export const SCHEMA_VERSION = 3;'));+ assert.ok(oldMigrations.includes(migration));- const newSource = oldSource.replace('export const SCHEMA_VERSION = 2;', 'export const SCHEMA_VERSION = 3;');++ const newSource = oldSource.replace('export const SCHEMA_VERSION = 3;', 'export const SCHEMA_VERSION = 4;');+ const newMigrations = oldMigrations.replace(migration, migration.replace('\n];', "\n ['item', 'item_unmerged_probe', 'INTEGER NOT NULL DEFAULT 0'],\n];"));- assert.notEqual(newMigrations, oldMigrations, 'the unmerged worktree carries a real schema-3 migration');++ assert.notEqual(newMigrations, oldMigrations, 'the unmerged worktree carries a real schema-4 migration');writeFileSync(boardSource, newSource);- box.git(linked, 'add', 'src/board.js');+ writeFileSync(migrateSource, newMigrations);+ box.git(linked, 'add', 'src/board.js', 'src/board-migrate.js');box.git(linked, 'commit', '-q', '-m', 'feat: simulate an unmerged schema bump');let before = readFileSync(dbFile);@@@ -458,7 -454,7 +458,7 @@@});assert.equal(mainFromHook.status, 0, mainFromHook.stderr + mainFromHook.stdout);const upgradedFromHook = new DatabaseSync(dbFile, { readOnly: true });-- assert.equal(upgradedFromHook.prepare('PRAGMA user_version').get().user_version, 2,++ assert.equal(upgradedFromHook.prepare('PRAGMA user_version').get().user_version, 3,'main source upgrades even when a linked-worktree hook exports its Git directory');upgradedFromHook.close();before = readFileSync(dbFile);@@@ -503,7 -499,7 +503,7 @@@assert.equal(relayRecords.status, 0, relayRecords.stderr + relayRecords.stdout);const relayRefusal = JSON.parse(relayRecords.stdout);assert.equal(relayRefusal.code, 'UNMERGED_SCHEMA', 'relay localRecords uses its source worktree identity even from main cwd');-- assert.match(relayRefusal.message, /worktree expects board schema 3, newer than the shared board's version 2/);++ assert.match(relayRefusal.message, /worktree expects board schema 4, newer than the shared board's version 3/);assert.deepEqual(readFileSync(dbFile), before, 'relay localRecords refuses before it can migrate the shared board');const specCheck = runFixture(linked, 'spec', 'check', '--json');@@@ -542,11 -538,11 +542,11 @@@assert.equal(refused.stderr, '');const document = JSON.parse(refused.stdout);assert.equal(document.error.code, 'UNMERGED_SCHEMA');-- assert.match(document.error.message, /worktree expects board schema 3, newer than the shared board's version 2/);++ assert.match(document.error.message, /worktree expects board schema 4, newer than the shared board's version 3/);assert.match(document.error.next, /merge this code into the main checkout first, or test it against a throwaway board/);assert.deepEqual(readFileSync(dbFile), before, 'the newer branch must leave every shared-board byte alone');const unchanged = new DatabaseSync(dbFile, { readOnly: true });-- assert.equal(unchanged.prepare('PRAGMA user_version').get().user_version, 2);++ assert.equal(unchanged.prepare('PRAGMA user_version').get().user_version, 3);assert.equal(unchanged.prepare('PRAGMA table_info(item)').all().some((column) => column.name === 'item_unmerged_probe'), false,'the branch migration would have installed this column without the refusal');unchanged.close();@@@ -574,10 -570,10 +574,10 @@@});assert.equal(mutation.status, 0, mutation.stderr + mutation.stdout);const mutated = new DatabaseSync(dbFile, { readOnly: true });-- assert.equal(mutated.prepare('PRAGMA user_version').get().user_version, 3,++ assert.equal(mutated.prepare('PRAGMA user_version').get().user_version, 4,'removing the guard makes the linked worktree silently migrate the shared board');assert.ok(mutated.prepare('PRAGMA table_info(item)').all().some((column) => column.name === 'item_unmerged_probe'),-- 'the guard-removal mutation installs its real schema-3 probe column');++ 'the guard-removal mutation installs its real schema-4 probe column');mutated.close();});diff --cc test/board-read-lock.test.jsindex 41e308f9,00000000..9e36aec5mode 100644,000000..100644--- a/test/board-read-lock.test.js+++ b/test/board-read-lock.test.js@@@ -1,163 -1,0 +1,178 @@@+/** @pullboard-test-input source-tree */- /** @pullboard-test-loads src/cli.js src/board.js src/board-migrate.js src/board-read.js src/commands/status.js src/commands/show.js src/commands/list.js src/commands/version.js */++/** @pullboard-test-loads src/cli.js src/board.js src/board-hot.js src/board-migrate.js src/board-read.js src/commands/status.js src/commands/show.js src/commands/list.js src/commands/version.js */+/** A read command opens the board read-only, so a writer holding the lock never stalls it [C7]. */+import assert from 'node:assert/strict';+import { performance } from 'node:perf_hooks';+import { after, test } from 'node:test';+import { DatabaseSync } from 'node:sqlite';+import { cpSync } from 'node:fs';+import { join, resolve } from 'node:path';+import * as store from '../src/board.js';+import { pathToFileURL } from 'node:url';+import { createE2eHelpers } from './e2e-helpers.js';+import { runFixtureChild, startFixtureChild as spawn } from './fixture-child.js';++const e2e = createE2eHelpers();+after(e2e.cleanup);++/** Hold the board's write lock from another process for `ms`; resolves once it is held, with the holder's exit. */+async function holdWriteLock(file, ms) {+ const script = [+ "const { DatabaseSync } = require('node:sqlite');",+ 'const [file, ms] = process.argv.slice(1);',+ 'const db = new DatabaseSync(file);',+ "db.exec('BEGIN IMMEDIATE');",+ "db.exec(\"INSERT INTO shout (shout_from, shout_to, shout_text, shout_at) VALUES ('holder', 'all', 'held', '2026-10-22T00:00:00Z')\");",+ "process.stdout.write('held\\n');",+ 'Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, Number(ms));',+ "db.exec('COMMIT');",+ ].join('\n');+ const child = spawn(process.execPath, ['-e', script, file, String(ms)], { stdio: ['ignore', 'pipe', 'pipe'] });+ let stderr = '';+ child.stderr.setEncoding('utf8').on('data', (chunk) => { stderr += chunk; });+ const closed = new Promise((done) => child.once('close', (code) => done({ code, stderr })));+ await new Promise((held, fail) => {+ child.stdout.setEncoding('utf8').on('data', (chunk) => { if (chunk.includes('held')) held(); });+ child.once('close', (code) => fail(new Error(`the lock holder exited ${code} before holding: ${stderr}`)));+ });+ return { closed };+}++const HOMES = ['PULLBOARD_HOME', 'PULLBOARD_MACHINE_HOME'];++/**+ * Copy this source outside any checkout, as a release is installed. Why: only trunk code opens a+ * shared board for writing (#1031), so code run from a branch worktree would never meet the lock.+ */+function released(box) {+ const release = join(box.dir, 'release');+ for (const path of ['src', 'bin', 'package.json']) cpSync(resolve(import.meta.dirname, '..', path), join(release, path), { recursive: true });+ return release;+}++/**+ * Run one command of the released code in this process under the fixture's homes, with the time it+ * took. Why in process: a fresh node's startup varies by hundreds of ms on a loaded machine.+ */+async function timed(box, cwd, ...argv) {+ const { main } = await import(pathToFileURL(join(box.release, 'src', 'cli.js')).href);+ const saved = HOMES.map((name) => process.env[name]);+ for (const name of HOMES) process.env[name] = box.env[name];+ let out = '';+ let err = '';+ const startedAt = performance.now();+ try {+ const code = await main(argv, { cwd, stdout: { isTTY: false, write: (text) => { out += text; } }, stderr: { write: (text) => { err += text; } } });+ return { code, out, err, ms: performance.now() - startedAt };+ } finally {+ HOMES.forEach((name, index) => { if (saved[index] === undefined) delete process.env[name]; else process.env[name] = saved[index]; });+ }+}++/** The median of an odd list of numbers. */+const median = (values) => [...values].sort((x, y) => x - y)[Math.floor(values.length / 2)];++const ITEMS = 1_000;+const EVENTS = 45_000;+const SHOUTS = 23_000;++/**+ * Seed the board to our size (22 Oct: about 1,000 items, 45,000 events, 23,000 shouts) in one+ * transaction of plain inserts, so the timing below reads a board as big as the real one.+ */+function seed(file) {+ const db = new DatabaseSync(file);+ try {+ db.exec('BEGIN IMMEDIATE');+ const at = '2026-10-22T00:00:00.000Z';+ db.prepare(`WITH RECURSIVE n(i) AS (SELECT 1 UNION ALL SELECT i + 1 FROM n WHERE i < ?)+ INSERT INTO item (item_lane, item_title, item_criterion, item_created_by, item_created_at, item_updated_at)+ SELECT 'web', 'Seeded item ' || i, 'renders', 'coordinator', ?, ? FROM n`).run(ITEMS, at, at);+ db.prepare(`WITH RECURSIVE n(i) AS (SELECT 1 UNION ALL SELECT i + 1 FROM n WHERE i < ?)+ INSERT INTO event (event_at, event_by, event_kind, item_id, event_detail) SELECT ?, 'coordinator', 'note', 1 + i % ?, '{}' FROM n`).run(EVENTS, at, ITEMS);+ db.prepare(`WITH RECURSIVE n(i) AS (SELECT 1 UNION ALL SELECT i + 1 FROM n WHERE i < ?)+ INSERT INTO shout (shout_from, shout_to, shout_text, shout_at) SELECT 'coordinator', 'web', 'seeded shout ' || i, ? FROM n`).run(SHOUTS, at);+ db.exec('COMMIT');+ } finally { db.close(); }+}+++/** #1044's hot-path indexes (src/board-hot.js), which reach an existing board with schema version 3. */++const HOT_INDEXES = ['shout_answers', 'shout_open_decision', 'shout_open_request', 'shout_evidence_item', 'shout_from_at', 'event_by_at', 'event_kind_id'];+++const READS = [['version'], ['show', '1'], ['status'], ['list']];+const RUNS = 5;++/** Each read's median over RUNS in-process runs, failing on any refusal. */+async function medians(box, argv) {+ const times = [];+ for (let run = 0; run < RUNS; run += 1) {+ const result = await timed(box, box.repo, ...argv);+ assert.equal(result.code, 0, `${argv.join(' ')}: ${result.err}`);+ times.push(result.ms);+ }+ return median(times);+}++test('a read answers while a writer holds the lock [C7]', async (t) => {+ const box = e2e.project();+ box.release = released(box);+ assert.equal(box.run(box.repo, 'add', 'web', 'Page', '--specs', 'G1', '--criterion', 'renders').code, 0);+ const file = join(box.repo, '.git', 'pullboard', 'board.sqlite');+ seed(file);+ for (const argv of READS) {+ const free = await medians(box, argv);+ // Each read gets its own 3 s hold, so all five locked runs fall inside it.+ const holder = await holdWriteLock(file, 3000);+ const startedAt = performance.now();+ const held = await medians(box, argv);+ const heldFor = performance.now() - startedAt;+ assert.equal((await holder.closed).code, 0, 'the holder kept the lock and committed');+ assert.ok(heldFor < 3000, `every ${argv[0]} run finished inside the 3 s hold (${Math.round(heldFor)} ms)`); // budget: ceiling is the 3 s hold declared above; a read that waits out the lock ends after it+ t.diagnostic(`${argv[0]}: median ${Math.round(held)} ms with a writer holding the lock, ${Math.round(free)} ms without, over ${RUNS} runs`);+ assert.ok(held - free < 100, `${argv[0]}: a held writer added ${Math.round(held - free)} ms to the median`); // budget: approved row criterion bar, under 100 ms over the unlocked median (shout #23649)+ }+- // An older board is still migrated by the next command that writes, from the released copy.++ // A version-2 board, from before #1044's hot-path indexes, is still migrated by the next command++ // that writes, from the released copy: it gains them then, and never on a read.+ const db = new DatabaseSync(file);- db.exec('PRAGMA user_version = 1');++ db.exec(`${HOT_INDEXES.map((name) => `DROP INDEX ${name};`).join(' ')} PRAGMA user_version = 2`);+ db.close();+ const cli = (...argv) => runFixtureChild(process.execPath, [join(box.release, 'bin', 'pullboard.js'), ...argv], { cwd: box.repo, env: box.env, encoding: 'utf8' });++ /** The hot-path indexes the board has, read without touching it. */++ const hotIndexes = () => {++ const board = store.openBoardReadOnly(file);++ try {++ return board.prepare(`SELECT name FROM sqlite_master WHERE type = 'index' AND name IN (${HOT_INDEXES.map(() => '?').join(', ')}) ORDER BY name`)++ .all(...HOT_INDEXES).map((row) => row.name);++ } finally { board.close(); }++ };+ /** The board's PRAGMA user_version, read without touching it. */+ const version = () => {+ const board = store.openBoardReadOnly(file);+ try { return board.prepare('PRAGMA user_version').get().user_version; } finally { board.close(); }+ };+ // A read on the older board answers as it is and leaves it older, even from code that may migrate.+ const read = cli('status');+ assert.equal(read.status, 0, read.failure ?? read.stderr);+ assert.match(read.stdout, /board: 1001 open/u);- assert.equal(version(), 1, 'status never migrates the board');++ assert.equal(version(), 2, 'status never migrates the board');++ assert.deepEqual(hotIndexes(), [], 'status adds no index');+ const write = cli('add', 'web', 'Footer', '--specs', 'G1', '--criterion', 'renders');+ assert.equal(write.status, 0, write.failure ?? write.stderr);+ assert.equal(version(), store.SCHEMA_VERSION, 'the next write command migrates it');++ assert.equal(store.SCHEMA_VERSION, 3, 'the version that carries the hot-path indexes');++ assert.deepEqual(hotIndexes(), [...HOT_INDEXES].sort(), 'the write gave the version-2 board every hot-path index');++ // At the current version, a shape changed outside pullboard is reported once and left as it is.+ const drifted = new DatabaseSync(file);+ drifted.exec('DROP INDEX event_item_id_event_id; PRAGMA application_id = 7');+ drifted.close();+ const reported = cli('add', 'web', 'Header', '--specs', 'G1', '--criterion', 'renders');+ assert.equal(reported.status, 0, reported.failure ?? reported.stderr);+ assert.equal(reported.stderr.match(/different shape/gu)?.length, 1, reported.stderr);+ const left = store.openBoardReadOnly(file);+ try {+ assert.equal(left.prepare('PRAGMA application_id').get().application_id, 7, 'no migration restamped the drifted board');+ assert.equal(left.prepare("SELECT 1 FROM sqlite_master WHERE name = 'event_item_id_event_id'").get(), undefined, 'no migration rebuilt its index');+ } finally { left.close(); }+});diff --cc test/machine.test.jsindex 51023902,ba220110..79748c60--- a/test/machine.test.js+++ b/test/machine.test.js@@@ -1174,7 -1172,7 +1174,7 @@@ test('next --verify reserves the revieassert.equal(git(holder, 'rev-parse', '--path-format=absolute', '--git-common-dir'), commonDir,'the verifier worktree reads the builder repo common dir');const sharedBoard = new DatabaseSync(join(commonDir, 'pullboard', 'board.sqlite'), { readOnly: true });-- assert.equal(sharedBoard.prepare('PRAGMA user_version').get().user_version, 2,++ assert.equal(sharedBoard.prepare('PRAGMA user_version').get().user_version, 3,'the main repo creates the shared board before the verifier opens it');sharedBoard.close();diff --cc test/shared-version.test.jsindex d50fed70,d50fed70..b77efca9--- a/test/shared-version.test.js+++ b/test/shared-version.test.js@@@ -61,7 -61,7 +61,7 @@@ test('an event-log-only worktree refuse});test('a broken Git link cannot impersonate an installed release and upgrade a board [A5,A6]', t => {-- const box = fixture(t); const before = box.versions(); box.bump('SCHEMA_VERSION', 2, 3);++ const box = fixture(t); const before = box.versions(); box.bump('SCHEMA_VERSION', 3, 4);const broken = join(box.dir, 'broken'); mkdirSync(broken);for (const name of ['bin', 'src', 'package.json']) cpSync(join(box.lane, name), join(broken, name), { recursive: true });writeFileSync(join(broken, '.git'), 'gitdir: /nonexistent/pullboard-pruned-link\n');@@@ -71,7 -71,7 +71,7 @@@});test('a newer lane can make a real checked commit and doctor gives a working main-checkout step [A5,A6]', t => {-- const box = fixture(t); const before = box.versions(); box.bump('SCHEMA_VERSION', 2, 3);++ const box = fixture(t); const before = box.versions(); box.bump('SCHEMA_VERSION', 3, 4);writeFileSync(join(box.lane, '.githooks/pre-commit'), `#!/bin/sh\nexec "${process.execPath}" "$(git rev-parse --show-toplevel)/bin/pullboard.js" hook pre-commit\n`);box.git(box.lane, 'add', 'src/board.js'); box.git(box.lane, 'commit', '-q', '-m', 'feat: propose a future schema [G1]');assert.deepEqual(box.versions(), before, 'the actual checkout hook must not migrate the shared board');@@@ -121,7 -121,7 +121,7 @@@ test('a held item remains readable by nconst claimed = box.cli(box.root, box.lane, 'claim', '1');assert.equal(claimed.status, 0, claimed.stderr + claimed.stdout);const before = readFileSync(box.file);-- box.bump('SCHEMA_VERSION', 2, 3);++ box.bump('SCHEMA_VERSION', 3, 4);const checked = box.cli(box.lane, box.lane, 'spec', 'check', '--json');assert.equal(checked.status, 0, checked.stderr + checked.stdout);assert.deepEqual(readFileSync(box.file), before, 'spec citations read a live claim without migrating or writing its board');