@wjarka/cezarion 0.15.1 → 0.16.0

package/dist/runs/history-file.js

@@ -0,0 +1,463 @@
+/**
+ * Both on-disk forms of a run transcript: `runs/<id>.ndjson` and `runs/<id>.ndjson.br`.
+ *
+ * Readers always return the plain file when it exists. restoreHistory drops the `.br` only when
+ * its decoded bytes are a byte prefix of the plain file; otherwise it keeps the compressed bytes
+ * as `.ndjson.br.orphaned`. compressHistory reads and writes tmp asynchronously, then commits in
+ * one synchronous block: re-check stillEligible() and that the plain file's size and mtime are
+ * unchanged since the read. An existing `.br` is decoded at job start; the commit re-checks its
+ * size, mtime and inode and, if the decoded bytes are not a prefix of plain, moves it to
+ * `.ndjson.br.orphaned` (or `.orphaned.<n>` if that name is taken) before renaming. A size/mtime/inode
+ * mismatch returns `'changed'` so the compressor can retry; ineligible or missing plain returns `'skipped'`.
+ */
+import { randomBytes } from 'node:crypto';
+import { closeSync, existsSync, fsyncSync, openSync, readdirSync, readFileSync, readSync, renameSync, rmSync, statSync, unlinkSync, writeSync, } from 'node:fs';
+import { open, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { Readable } from 'node:stream';
+import { promisify } from 'node:util';
+import { brotliCompress, brotliDecompress, brotliDecompressSync, constants as zlibConstants, } from 'node:zlib';
+export const HISTORY_BROTLI_QUALITY = 5;
+const brotliCompressAsync = promisify(brotliCompress);
+const brotliDecompressAsync = promisify(brotliDecompress);
+const brotliParams = { params: { [zlibConstants.BROTLI_PARAM_QUALITY]: HISTORY_BROTLI_QUALITY } };
+const warnedUndecodable = new Set();
+const warnedOrphaned = new Set();
+export function historyPaths(dataDir, id) {
+    const plain = join(dataDir, 'runs', `${id}.ndjson`);
+    const compressed = `${plain}.br`;
+    // The transcript-facts sidecar (transcript-facts.ts) is a cache of the transcript and goes with it.
+    return { plain, compressed, orphaned: `${compressed}.orphaned`, facts: join(dataDir, 'runs', `${id}.facts.json`) };
+}
+export function hasPlainHistory(dataDir, id) {
+    return existsSync(historyPaths(dataDir, id).plain);
+}
+export function readHistoryText(dataDir, id) {
+    const { plain, compressed } = historyPaths(dataDir, id);
+    try {
+        return readFileSync(plain, 'utf8');
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+    }
+    let encoded;
+    try {
+        encoded = readFileSync(compressed);
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+    const decoded = tryDecompressSync(encoded);
+    if (decoded === undefined) {
+        warnUndecodable(compressed);
+        return undefined;
+    }
+    return decoded.toString('utf8');
+}
+/** `readHistoryText` off the event loop: async reads and async brotli. */
+export async function readHistoryTextAsync(dataDir, id) {
+    const { plain, compressed } = historyPaths(dataDir, id);
+    try {
+        return await readFile(plain, 'utf8');
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+    }
+    let encoded;
+    try {
+        encoded = await readFile(compressed);
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+    try {
+        return (await brotliDecompressAsync(encoded)).toString('utf8');
+    }
+    catch {
+        warnUndecodable(compressed);
+        return undefined;
+    }
+}
+/** Which form exists, without reading either: the plain byte length, or the archive's stat. */
+export function historyStat(dataDir, id) {
+    const { plain, compressed } = historyPaths(dataDir, id);
+    try {
+        return { plainSize: statSync(plain).size };
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+    }
+    try {
+        return { archive: statSync(compressed) };
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return {};
+        throw error;
+    }
+}
+/** Bytes `[from, to)` of the plain transcript; short only if it ends before `to`. */
+export function readPlainHistoryRange(dataDir, id, from, to) {
+    const fd = openSync(historyPaths(dataDir, id).plain, 'r');
+    try {
+        const buffer = Buffer.alloc(Math.max(0, to - from));
+        let offset = 0;
+        while (offset < buffer.length) {
+            const count = readSync(fd, buffer, offset, buffer.length - offset, from + offset);
+            if (count === 0)
+                break;
+            offset += count;
+        }
+        return buffer.subarray(0, offset);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export function emptyHistorySource() {
+    return {
+        size: 0,
+        async read() {
+            return Buffer.alloc(0);
+        },
+        stream() {
+            return Readable.from([]);
+        },
+        async close() { },
+    };
+}
+export async function openHistorySource(dataDir, id) {
+    const { plain, compressed } = historyPaths(dataDir, id);
+    try {
+        const handle = await open(plain, 'r');
+        try {
+            const size = (await handle.stat()).size;
+            return plainSource(size, handle);
+        }
+        catch (error) {
+            await handle.close().catch(() => undefined);
+            throw error;
+        }
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+    }
+    let encoded;
+    try {
+        encoded = await readFile(compressed);
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+    try {
+        return bufferSource(await brotliDecompressAsync(encoded));
+    }
+    catch {
+        warnUndecodable(compressed);
+        return undefined;
+    }
+}
+export async function compressHistory(dataDir, id, stillEligible, 
+/** Called once the archive replaced the plain file, with the bytes archived and its stat. */
+onCommitted) {
+    const { plain, compressed, orphaned } = historyPaths(dataDir, id);
+    let handle;
+    try {
+        handle = await open(plain, 'r');
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return 'skipped';
+        throw error;
+    }
+    let st;
+    let bytes;
+    try {
+        st = await handle.stat();
+        bytes = Buffer.allocUnsafe(st.size);
+        let offset = 0;
+        while (offset < st.size) {
+            const { bytesRead } = await handle.read(bytes, offset, st.size - offset, offset);
+            if (bytesRead === 0)
+                return 'changed';
+            offset += bytesRead;
+        }
+    }
+    finally {
+        await handle.close();
+    }
+    const existing = await snapshotCompressed(compressed);
+    const encoded = await brotliCompressAsync(bytes, brotliParams);
+    const tmp = `${compressed}.${process.pid}.${randomBytes(8).toString('hex')}.tmp`;
+    try {
+        await writeTmpAsync(tmp, encoded);
+        if (!stillEligible()) {
+            rmSync(tmp, { force: true });
+            return 'skipped';
+        }
+        let current;
+        try {
+            current = statSync(plain);
+        }
+        catch {
+            rmSync(tmp, { force: true });
+            return 'skipped';
+        }
+        if (current.size !== st.size || current.mtimeMs !== st.mtimeMs) {
+            rmSync(tmp, { force: true });
+            return 'changed';
+        }
+        if (!commitCompressedReplace(compressed, orphaned, existing, bytes)) {
+            rmSync(tmp, { force: true });
+            return 'changed';
+        }
+        renameSync(tmp, compressed);
+        unlinkSync(plain);
+        if (onCommitted) {
+            try {
+                onCommitted(bytes, statSync(compressed));
+            }
+            catch { /* a cache: its next reader rebuilds */ }
+        }
+        return 'compressed';
+    }
+    catch (error) {
+        rmSync(tmp, { force: true });
+        throw error;
+    }
+}
+export function restoreHistory(dataDir, id) {
+    const { plain, compressed, orphaned } = historyPaths(dataDir, id);
+    if (existsSync(plain)) {
+        disposeCompressedBesidePlain(plain, compressed, orphaned);
+        return;
+    }
+    let encoded;
+    try {
+        encoded = readFileSync(compressed);
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return;
+        throw error;
+    }
+    const decoded = tryDecompressSync(encoded);
+    if (decoded === undefined) {
+        const dest = uniqueOrphanPath(`${compressed}.corrupt`);
+        renameSync(compressed, dest);
+        warnUndecodable(compressed, `; renamed to ${dest}`);
+        return;
+    }
+    const tmp = `${plain}.${process.pid}.${randomBytes(8).toString('hex')}.tmp`;
+    try {
+        writeTmpSync(tmp, decoded);
+    }
+    catch (error) {
+        rmSync(tmp, { force: true });
+        throw error;
+    }
+    renameSync(tmp, plain);
+    unlinkSync(compressed);
+}
+export function removeHistory(dataDir, id) {
+    const dir = join(dataDir, 'runs');
+    const prefix = `${id}.ndjson`;
+    const facts = `${id}.facts.json`;
+    try {
+        for (const name of readdirSync(dir)) {
+            if (name === prefix || name.startsWith(`${prefix}.`) || name === facts || name.startsWith(`${facts}.`))
+                rmSync(join(dir, name), { force: true });
+        }
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+    }
+}
+function isNotFound(error) {
+    return error.code === 'ENOENT';
+}
+function tryDecompressSync(encoded) {
+    try {
+        return brotliDecompressSync(encoded);
+    }
+    catch {
+        return undefined;
+    }
+}
+function warnUndecodable(path, extra = '') {
+    if (warnedUndecodable.has(path))
+        return;
+    warnedUndecodable.add(path);
+    console.warn(`[cez] ignoring undecodable compressed transcript ${path}${extra}`);
+}
+function warnOrphaned(path) {
+    if (warnedOrphaned.has(path))
+        return;
+    warnedOrphaned.add(path);
+    console.warn(`[cez] keeping non-prefix compressed transcript as ${path}`);
+}
+function isDecodedPrefix(decoded, plain) {
+    return decoded.length <= plain.length && plain.subarray(0, decoded.length).equals(decoded);
+}
+async function snapshotCompressed(compressed) {
+    let st;
+    try {
+        st = statSync(compressed);
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+    let encoded;
+    try {
+        encoded = await readFile(compressed);
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+    let decoded;
+    try {
+        decoded = await brotliDecompressAsync(encoded);
+    }
+    catch {
+        decoded = undefined;
+    }
+    return { size: st.size, mtimeMs: st.mtimeMs, ino: st.ino, decoded };
+}
+/** False means the existing `.br` changed; caller must not rename over it. */
+function commitCompressedReplace(compressed, orphaned, existing, plainBytes) {
+    let current;
+    try {
+        current = statSync(compressed);
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+    }
+    if (!current)
+        return true;
+    if (!existing ||
+        current.size !== existing.size ||
+        current.mtimeMs !== existing.mtimeMs ||
+        current.ino !== existing.ino) {
+        return false;
+    }
+    if (existing.decoded === undefined || !isDecodedPrefix(existing.decoded, plainBytes)) {
+        moveCompressedToOrphan(compressed, orphaned);
+    }
+    return true;
+}
+function uniqueOrphanPath(orphaned) {
+    if (!existsSync(orphaned))
+        return orphaned;
+    for (let n = 1;; n++) {
+        const candidate = `${orphaned}.${n}`;
+        if (!existsSync(candidate))
+            return candidate;
+    }
+}
+function moveCompressedToOrphan(compressed, orphaned) {
+    const dest = uniqueOrphanPath(orphaned);
+    renameSync(compressed, dest);
+    warnOrphaned(dest);
+}
+function disposeCompressedBesidePlain(plain, compressed, orphaned) {
+    if (!existsSync(compressed))
+        return;
+    let encoded;
+    try {
+        encoded = readFileSync(compressed);
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return;
+        throw error;
+    }
+    const decoded = tryDecompressSync(encoded);
+    if (decoded !== undefined && isDecodedPrefix(decoded, readFileSync(plain))) {
+        rmSync(compressed, { force: true });
+        return;
+    }
+    moveCompressedToOrphan(compressed, orphaned);
+}
+async function writeTmpAsync(tmp, data) {
+    const handle = await open(tmp, 'w');
+    try {
+        let offset = 0;
+        while (offset < data.length) {
+            const { bytesWritten } = await handle.write(data, offset, data.length - offset);
+            offset += bytesWritten;
+        }
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+function writeTmpSync(tmp, data) {
+    const fd = openSync(tmp, 'w');
+    try {
+        let offset = 0;
+        while (offset < data.length) {
+            offset += writeSync(fd, data, offset);
+        }
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function plainSource(size, handle) {
+    return {
+        size,
+        async read(position, length) {
+            if (length <= 0 || position >= size)
+                return Buffer.alloc(0);
+            const toRead = Math.min(length, size - position);
+            const buffer = Buffer.allocUnsafe(toRead);
+            let offset = 0;
+            while (offset < toRead) {
+                const { bytesRead } = await handle.read(buffer, offset, toRead - offset, position + offset);
+                if (bytesRead === 0)
+                    break;
+                offset += bytesRead;
+            }
+            return offset === toRead ? buffer : buffer.subarray(0, offset);
+        },
+        stream(start = 0) {
+            return handle.createReadStream({ encoding: 'utf8', start, autoClose: false });
+        },
+        async close() {
+            await handle.close();
+        },
+    };
+}
+function bufferSource(buffer) {
+    return {
+        size: buffer.length,
+        async read(position, length) {
+            if (length <= 0 || position >= buffer.length)
+                return Buffer.alloc(0);
+            return buffer.subarray(position, Math.min(position + length, buffer.length));
+        },
+        stream(start = 0) {
+            return Readable.from([buffer.subarray(start)], { encoding: 'utf8' });
+        },
+        async close() { },
+    };
+}
+//# sourceMappingURL=history-file.js.map

package/dist/runs/history-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-file.js","sourceRoot":"","sources":["../../src/runs/history-file.ts"],"names":[],"mappings":"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"}

package/dist/runs/human-ask-summary.js

@@ -1,25 +1,30 @@
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
 import { pendingHumanAsk } from '../contract/index.js';
+import { readHistoryText } from './history-file.js';
 /** Rebuild display metadata from the same durable evidence as delivery admission.
  * Called only for question/receipt appends and root-wait recovery, never token ticks.
  * Shared by owned stores and the read-only cold index; no context or process is opened. */
 export function refreshHumanAskSummary(run, dataDir) {
     let next;
     try {
-        const events = [];
-        for (const line of readFileSync(join(dataDir, 'runs', `${run.id}.ndjson`), 'utf8').split('\n')) {
-            if (!line)
-                continue;
-            try {
-                const event = JSON.parse(line);
-                if (event !== null && typeof event === 'object' && 'type' in event &&
-                    (event.type === 'ask.requested' || event.type === 'human-input-delivered'))
-                    events.push(event);
+        const raw = readHistoryText(dataDir, run.id);
+        if (raw === undefined) {
+            next = run.hasPendingHumanAsk === true;
+        }
+        else {
+            const events = [];
+            for (const line of raw.split('\n')) {
+                if (!line)
+                    continue;
+                try {
+                    const event = JSON.parse(line);
+                    if (event !== null && typeof event === 'object' && 'type' in event &&
+                        (event.type === 'ask.requested' || event.type === 'human-input-delivered'))
+                        events.push(event);
+                }
+                catch { /* Match readEvents: a damaged line does not hide later valid receipts. */ }
             }
-            catch { /* Match readEvents: a damaged line does not hide later valid receipts. */ }
+            next = pendingHumanAsk(events) !== undefined;
         }
-        next = pendingHumanAsk(events) !== undefined;
     }
     catch (error) {
         // An unavailable history cannot retract known human attention. Legacy runs with

package/dist/runs/human-ask-summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"human-ask-summary.js","sourceRoot":"","sources":["../../src/runs/human-ask-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAiB,MAAM,8BAA8B,CAAC;AAI9E;;2FAE2F;AAC3F,MAAM,UAAU,sBAAsB,CAAC,GAAqB,EAAE,OAAe;IAC3E,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/F,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK;oBAChE,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,KAAiB,CAAC,CAAC;YAC/G,CAAC;YAAC,MAAM,CAAC,CAAC,0EAA0E,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gFAAgF;QAChF,oFAAoF;QACpF,IAAI,GAAG,GAAG,CAAC,kBAAkB,KAAK,IAAI,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC/F,CAAC;IACD,IAAI,IAAI,KAAK,GAAG,CAAC,kBAAkB;QAAE,OAAO,KAAK,CAAC;IAClD,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"human-ask-summary.js","sourceRoot":"","sources":["../../src/runs/human-ask-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAiB,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpD;;2FAE2F;AAC3F,MAAM,UAAU,sBAAsB,CAAC,GAAqB,EAAE,OAAe;IAC3E,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,GAAG,GAAG,CAAC,kBAAkB,KAAK,IAAI,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAe,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,IAAI,CAAC;oBACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACxC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK;wBAChE,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,CAAC;wBAAE,MAAM,CAAC,IAAI,CAAC,KAAiB,CAAC,CAAC;gBAC/G,CAAC;gBAAC,MAAM,CAAC,CAAC,0EAA0E,CAAC,CAAC;YACxF,CAAC;YACD,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gFAAgF;QAChF,oFAAoF;QACpF,IAAI,GAAG,GAAG,CAAC,kBAAkB,KAAK,IAAI,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC/F,CAAC;IACD,IAAI,IAAI,KAAK,GAAG,CAAC,kBAAkB;QAAE,OAAO,KAAK,CAAC;IAClD,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runs/legacy-index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The legacy run index at the moment `runs.db` imports it (#779, plan step 4): its exact bytes,
+ * a durable copy of them beside it, and the checks that no older cezar is still writing it.
+ *
+ * An older cezar writes only `runs.json` and knows nothing of `runs.db`, so importing while one
+ * still runs would freeze a file that keeps moving. Two signals say one does:
+ * - a live cockpit other than this process holds `cockpit.lock`. A new cockpit takes that lock
+ *   before it opens its store, so with no import done yet the holder is an older cockpit (v0.15.1
+ *   and later write the lock), or a new one about to import, which a retry lets finish first;
+ * - `runs.json` is not the file that was read. Older cezars save it by temp file and rename, so
+ *   every save replaces the inode, and a save during the import shows.
+ * An older process that holds no lock (a `cez run`, a cockpit before v0.15.1) and saves nothing
+ * while the import runs is not seen; whatever it writes later is never imported.
+ */
+/** The legacy index (#779): read once, imported into `runs.db`, never written again. */
+export declare const LEGACY_INDEX_FILE = "runs.json";
+/** The exact bytes `runs.json` held when it was imported, kept beside it. */
+export declare const LEGACY_INDEX_BACKUP_FILE = "runs.json.pre-sqlite.bak";
+/** Enough of a file's identity to tell that it was replaced or rewritten. */
+interface FileIdentity {
+    dev: number;
+    ino: number;
+    size: number;
+    mtimeMs: number;
+}
+/** `runs.json` as one read saw it. */
+export interface LegacyIndexSnapshot {
+    bytes: Buffer;
+    sha256: string;
+    identity: FileIdentity;
+}
+/** `path` read in one go through one descriptor, so its bytes and identity belong together.
+ *  Undefined when there is no such file. */
+export declare function readLegacyIndex(path: string): LegacyIndexSnapshot | undefined;
+/**
+ * Keep `snapshot`'s exact bytes beside `runs.json` and answer the backup's file name. An existing
+ * `runs.json.pre-sqlite.bak` is trusted only when it holds those very bytes (same size and
+ * sha256). One that does not — an earlier snapshot, a file a crash cut short — is never touched:
+ * the bytes go to `runs.json.pre-sqlite.<sha256 prefix>.bak` instead.
+ *
+ * The import calls this only inside its transaction, once nothing can refuse it any more: an
+ * attempt an older cezar's writes refuse leaves no backup, so retries cannot multiply them.
+ */
+export declare function backUpLegacyIndex(dataDir: string, snapshot: LegacyIndexSnapshot): string;
+/** An older cezar still writes `runs.json`, so it was not imported. */
+export declare class LegacyWriterError extends Error {
+    /** `cockpit`: a live cockpit other than this process holds `cockpit.lock`. `changed`: the file
+     *  changed between the read and the import. */
+    readonly reason: 'cockpit' | 'changed';
+    constructor(reason: 'cockpit' | 'changed', message: string);
+}
+/** Throw `LegacyWriterError` when a live cockpit other than this process owns `dataDir`. Cheap: one
+ *  small file read and a liveness probe, so the import asks it before it reads anything. */
+export declare function assertNoLegacyCockpit(dataDir: string): void;
+/**
+ * Throw `LegacyWriterError` when an older cezar may still be writing `runs.json`: another live
+ * cockpit owns `dataDir` (`assertNoLegacyCockpit`), or the file is no longer what `snapshot` read
+ * (undefined: there was none). Inside the import transaction, right before it commits, this is
+ * the authority; asked earlier it only saves the work of an import that could not commit.
+ */
+export declare function assertNoLegacyWriter(dataDir: string, snapshot: LegacyIndexSnapshot | undefined): void;
+export {};