@svenroth-ai/shipwright 0.24.1-next.0

package/server/dist/terminal/scrollback-store.js

@@ -0,0 +1,572 @@
+/*
+ * scrollback-store.ts — disk-backed terminal scrollback (iterate-2026-05-04, ADR-068-A1).
+ *
+ * Per-task append-only file at `<scrollbackDir>/<taskId>.log` (rotated to
+ * `.log.1` at `maxBytesPerTask`). Read-back combines both files via
+ * StringDecoder so multi-byte UTF-8 split across the rotation boundary
+ * round-trips cleanly.
+ *
+ * Iterate C (ADR-087, 2026-05-12): the chunked-replay path that used
+ * to consume `read()` (via the now-deleted `readForReplay()` accessor)
+ * is RETIRED. Cell-state snapshots (snapshot-store + @xterm/headless
+ * mirror, ADR-088/089) are the sole replay primitive. This module
+ * remains for two surviving consumers:
+ *   - `bytes()` — surfaced in the WS `ready` envelope `scrollbackBytes`
+ *     field so the privacy-disclosure footer can render.
+ *   - `clear()` / `clearBestEffort()` — user-clear button + DELETE
+ *     cascade still wipe the disk file even though it has no replay
+ *     consumer (privacy contract).
+ *
+ * The sanitizer + replay-time PowerShell-boilerplate collapse (formerly
+ * ADR-069 / ADR-077 compensations) are GONE. Disk content is now raw
+ * pty bytes; consumers reading via `read()` get those bytes verbatim.
+ * No production code path currently calls `read()` post-Iterate-C.
+ *
+ * Architecture invariants (frozen by external review v3→v7 + Round 4):
+ *   - append() uses fs.appendFileSync (one syscall sequence per call —
+ *     open(O_APPEND|O_CREAT|O_WRONLY) → write() → close()). This is the
+ *     simplest serialization model: data is visible to subsequent reads
+ *     immediately, no batching race. Performance fine for embedded-terminal
+ *     workloads (chunks 1B–64KiB at <100Hz; total wall-time per call ≪ 1ms).
+ *   - rotate() / read() / clear() ARE serialized through a per-task
+ *     PQueue (concurrency=1). p-queue avoids the homegrown promise-chain
+ *     bug from v6 review round 3.
+ *   - drop-oldest is FORBIDDEN — would bisect multi-byte UTF-8 / ANSI
+ *     sequences and permanently corrupt the terminal. Live-data
+ *     pressure is handled at the WS layer (pty.pause/resume during
+ *     replay; existing per-conn outbound backpressure on saturation).
+ *   - Rotation goes through a 3-state machine: NORMAL → ROTATING →
+ *     ROTATION_FLUSH → NORMAL. While state ≠ NORMAL, append() writes
+ *     to a rotationBuffer (cap rotationBufferMultiplier × maxBytesPerTask).
+ *     Overflow throws ScrollbackStoreError + structured-error-log
+ *     (should never fire in practice — rotation completes in low ms).
+ *   - Path-guard is realpath-at-op-time on every clear/rotate;
+ *     boot-time realPathGuard is first-line defense only.
+ *   - UUID format /^[0-9a-fA-F-]{36}$/ validated on every public
+ *     method — defeats path-traversal at the cheapest possible
+ *     layer.
+ *   - File mode 0o600 / dir mode 0o700 (POSIX-enforced). Windows
+ *     ignores POSIX modes — privacy disclosure UI surfaces this
+ *     limitation; user-account ACLs are the real boundary there.
+ *   - Disabled mode: maxBytesPerTask === 0 → all public methods
+ *     return early; no file is ever created.
+ */
+import * as fsAsync from "node:fs/promises";
+import * as fsSync from "node:fs";
+import * as path from "node:path";
+import { StringDecoder } from "node:string_decoder";
+import PQueue from "p-queue";
+export class ScrollbackStoreError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ScrollbackStoreError";
+    }
+}
+// ---------------------------------------------------------------------------
+// Internals
+// ---------------------------------------------------------------------------
+const UUID_PATTERN = /^[0-9a-fA-F-]{36}$/;
+// ---------------------------------------------------------------------------
+// ScrollbackStore
+// ---------------------------------------------------------------------------
+export class ScrollbackStore {
+    dir;
+    opts;
+    states = new Map();
+    rotationBufferMultiplier;
+    fileMode;
+    dirMode;
+    renameMaxAttempts;
+    renameFn;
+    now;
+    readdirFn;
+    resolvedDir = null;
+    constructor(dir, opts) {
+        this.dir = dir;
+        this.opts = opts;
+        this.fileMode = opts.fileMode ?? 0o600;
+        this.dirMode = opts.dirMode ?? 0o700;
+        this.rotationBufferMultiplier = opts.rotationBufferMultiplier ?? 4;
+        this.renameMaxAttempts = opts.renameMaxAttempts ?? 3;
+        this.renameFn = opts.renameFn ?? ((from, to) => fsAsync.rename(from, to));
+        this.now = opts.now ?? Date.now;
+        this.readdirFn = opts.readdirFn ?? ((d) => fsAsync.readdir(d));
+    }
+    /** Whether persistence is disabled via env var (`SHIPWRIGHT_TERMINAL_SCROLLBACK_MAX_BYTES=0`). */
+    get disabled() {
+        return this.opts.maxBytesPerTask === 0;
+    }
+    /** Public init — creates dir + caches resolved path. Idempotent. Call from server bootstrap. */
+    async init() {
+        if (this.disabled)
+            return;
+        await this.ensureDirResolved();
+    }
+    /**
+     * Append raw pty bytes via fs.appendFileSync. Synchronous (one syscall
+     * sequence per call). May throw ScrollbackStoreError on rotation buffer
+     * overflow or invalid taskId; the caller (pty-manager.onData broadcast)
+     * MUST wrap in try/catch to keep the broadcast loop resilient.
+     *
+     * Returns true if the bytes were either buffered or written, false if
+     * disabled.
+     */
+    append(taskId, data) {
+        if (this.disabled)
+            return false;
+        if (data.byteLength === 0)
+            return true;
+        this.validateTaskId(taskId);
+        const st = this.getOrInitState(taskId);
+        // Iterate C (ADR-087): the ADR-069 sanitizer has been retired. Disk
+        // content is now raw pty bytes — the cell-state snapshot store
+        // (ADR-088/089) is the sole replay primitive, and snapshots are
+        // produced by @xterm/headless from the live byte stream regardless
+        // of what the disk file holds. `read()` still returns these raw
+        // bytes verbatim for any diagnostic consumer.
+        // Rotation in flight → buffer (NEVER drop chunks; ANSI/UTF-8 corruption).
+        if (st.state !== "NORMAL") {
+            this.bufferDuringRotation(taskId, st, data);
+            return true;
+        }
+        try {
+            fsSync.appendFileSync(this.taskFilePath(taskId), data, {
+                mode: this.fileMode,
+            });
+        }
+        catch (err) {
+            // Surface as warning; never crash the broadcaster on disk errors.
+            // eslint-disable-next-line no-console
+            console.warn(`[scrollback] appendFileSync failed for ${taskId}: ${err.message}`);
+            return false;
+        }
+        st.size += data.byteLength;
+        if (st.size > this.opts.maxBytesPerTask) {
+            this.scheduleRotation(taskId, st);
+        }
+        return true;
+    }
+    /**
+     * Read the last `maxBytesPerTask` bytes (combines `.log.1` + `.log`
+     * if rotation has happened). Returns "" if no scrollback exists or
+     * disabled. UTF-8-safe via StringDecoder — multi-byte split across
+     * rotation boundary is handled correctly.
+     */
+    async read(taskId) {
+        if (this.disabled)
+            return "";
+        this.validateTaskId(taskId);
+        const st = this.getOrInitState(taskId);
+        return st.queue.add(() => this.readLocked(taskId));
+    }
+    /**
+     * Total persisted bytes for a task — sum of `.log` (live) + `.log.1`
+     * (rotated archive). The cached size in PerTaskState reflects ONLY
+     * the live `.log` and resets on rotation, so a callee using `bytes()`
+     * to gate replay-presence UI would otherwise get a false 0 right
+     * after rotation. Phase-3 review fix (HIGH).
+     */
+    async bytes(taskId) {
+        if (this.disabled)
+            return 0;
+        this.validateTaskId(taskId);
+        const dir = await this.ensureDirResolved();
+        let total = 0;
+        for (const name of [`${taskId}.log`, `${taskId}.log.1`]) {
+            try {
+                const stats = await fsAsync.stat(path.join(dir, name));
+                total += stats.size;
+            }
+            catch (err) {
+                if (err.code !== "ENOENT")
+                    throw err;
+            }
+        }
+        // Refresh per-task size cache against the live .log (only the
+        // live size is the size cache's contract).
+        const st = this.states.get(taskId);
+        if (st) {
+            try {
+                const live = await fsAsync.stat(path.join(dir, `${taskId}.log`));
+                st.size = live.size;
+            }
+            catch {
+                st.size = 0;
+            }
+        }
+        return total;
+    }
+    /**
+     * Delete `.log` + `.log.1`. THROWS on failure (used by user-clear).
+     * Resets per-task state (size cache + rotationBuffer).
+     */
+    async clear(taskId) {
+        if (this.disabled)
+            return;
+        this.validateTaskId(taskId);
+        const st = this.getOrInitState(taskId);
+        await st.queue.add(() => this.clearLocked(taskId, /* loud */ true));
+    }
+    /** Best-effort variant — used by task-delete cascade. Logs warn but does not throw. */
+    async clearBestEffort(taskId) {
+        if (this.disabled)
+            return;
+        if (!UUID_PATTERN.test(taskId))
+            return; // silent — not a real task
+        const st = this.getOrInitState(taskId);
+        await st.queue.add(() => this.clearLocked(taskId, /* loud */ false));
+    }
+    /**
+     * "Close stream" semantics — kept for API parity with the WriteStream-based
+     * implementation. Since we use appendFileSync there is no stream to close,
+     * but callers (pty-manager.kill) still call this; we drop the per-task
+     * size cache so subsequent reads pick up disk truth, and we remain
+     * idempotent.
+     */
+    async closeStream(taskId) {
+        if (this.disabled)
+            return;
+        if (!UUID_PATTERN.test(taskId))
+            return; // silent — not a real task
+        // Idempotent: drop the in-memory state so size-cache rehydrates from disk
+        // on next read/bytes call. Equivalent to the WriteStream close+invalidate.
+        // Rotation queue is preserved (not dropped) so any pending rotation
+        // completes against the on-disk file.
+        const st = this.states.get(taskId);
+        if (!st)
+            return;
+        // Wait for any pending queue work (rotation/read/clear) to settle.
+        await st.queue.onIdle();
+    }
+    /**
+     * Sweep expired files. Bounded — max `maxFilesPerPass` per call,
+     * oldest-first by mtime. Skips files for active tasks.
+     */
+    async sweepExpired(ttlDays, sweepOpts) {
+        if (this.disabled)
+            return { deleted: 0, remaining: 0, errors: 0 };
+        const dir = await this.ensureDirResolved();
+        const cutoffMs = this.now() - ttlDays * 24 * 60 * 60 * 1000;
+        const maxFiles = sweepOpts.maxFilesPerPass ?? 100;
+        const result = { deleted: 0, remaining: 0, errors: 0 };
+        let entries;
+        try {
+            entries = await this.readdirFn(dir);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return result;
+            throw err;
+        }
+        const groupsById = new Map();
+        for (const name of entries) {
+            const m = name.match(/^([0-9a-fA-F-]{36})\.log(?:\.1)?$/);
+            if (!m)
+                continue;
+            const taskId = m[1];
+            if (sweepOpts.activeTaskIds.has(taskId))
+                continue;
+            try {
+                const mtimeMs = (await fsAsync.stat(path.join(dir, name))).mtimeMs;
+                const fresh = mtimeMs >= cutoffMs;
+                const g = groupsById.get(taskId);
+                if (g) {
+                    g.files.push(name);
+                    g.newestMtime = Math.max(g.newestMtime, mtimeMs);
+                    g.hasFresh = g.hasFresh || fresh;
+                }
+                else {
+                    groupsById.set(taskId, {
+                        taskId,
+                        files: [name],
+                        newestMtime: mtimeMs,
+                        hasFresh: fresh,
+                    });
+                }
+            }
+            catch {
+                result.errors++;
+            }
+        }
+        // Any fresh file vetoes the whole task; survivors oldest-first (TTL).
+        const groups = [...groupsById.values()]
+            .filter((g) => !g.hasFresh)
+            .sort((a, b) => a.newestMtime - b.newestMtime);
+        for (const g of groups) {
+            if (result.deleted >= maxFiles) {
+                result.remaining++;
+                continue;
+            }
+            let groupFailed = false;
+            for (const file of g.files) {
+                try {
+                    await fsAsync.unlink(path.join(dir, file));
+                }
+                catch {
+                    result.errors++;
+                    groupFailed = true;
+                }
+            }
+            if (!groupFailed) {
+                result.deleted++;
+                this.states.delete(g.taskId);
+            }
+        }
+        return result;
+    }
+    /**
+     * Graceful shutdown — wait for all per-task PQueues to drain.
+     * appendFileSync writes are already synchronous so no flush is
+     * needed; only pending rotation/read/clear operations need to
+     * finish. timeoutMs is a safety cap.
+     */
+    async shutdown(timeoutMs = 5000) {
+        const drains = [];
+        for (const [, st] of this.states) {
+            drains.push(st.queue.onIdle());
+        }
+        const all = Promise.all(drains).then(() => undefined);
+        const timer = new Promise((resolve) => {
+            setTimeout(resolve, timeoutMs);
+        });
+        await Promise.race([all, timer]);
+    }
+    // --- Internal --------------------------------------------------------------
+    validateTaskId(taskId) {
+        if (!UUID_PATTERN.test(taskId)) {
+            throw new ScrollbackStoreError("invalid_task_id", `taskId does not match UUID pattern: ${taskId}`);
+        }
+    }
+    getOrInitState(taskId) {
+        let st = this.states.get(taskId);
+        if (!st) {
+            st = {
+                size: 0,
+                state: "NORMAL",
+                rotationBuffer: [],
+                rotationBufferBytes: 0,
+                queue: new PQueue({ concurrency: 1 }),
+            };
+            this.states.set(taskId, st);
+        }
+        return st;
+    }
+    bufferDuringRotation(taskId, st, data) {
+        const cap = this.opts.maxBytesPerTask * this.rotationBufferMultiplier;
+        if (st.rotationBufferBytes + data.byteLength > cap) {
+            // eslint-disable-next-line no-console
+            console.warn(`[scrollback] rotation buffer overflow for ${taskId}: ${st.rotationBufferBytes + data.byteLength}/${cap} bytes`);
+            throw new ScrollbackStoreError("rotation_buffer_overflow", `rotationBuffer overflow for ${taskId}`);
+        }
+        st.rotationBuffer.push(data);
+        st.rotationBufferBytes += data.byteLength;
+    }
+    taskFilePath(taskId) {
+        return path.join(this.resolvedDir ?? this.dir, `${taskId}.log`);
+    }
+    /**
+     * Resolve task file path with realpath-at-op-time. Used for clear / rotate
+     * — defends against mid-runtime symlink swap. Throws scrollback_path_outside_dir
+     * if the resolved target falls outside the scrollback dir.
+     */
+    async resolveTaskFile(taskId) {
+        const dir = await this.ensureDirResolved();
+        const candidate = path.join(dir, `${taskId}.log`);
+        let realCandidate;
+        try {
+            realCandidate = await fsAsync.realpath(candidate);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return candidate;
+            throw err;
+        }
+        const rel = path.relative(dir, realCandidate);
+        if (rel.startsWith("..") || path.isAbsolute(rel)) {
+            throw new ScrollbackStoreError("scrollback_path_outside_dir", `realpath escape for ${taskId}: ${realCandidate}`);
+        }
+        return realCandidate;
+    }
+    /** Idempotent — creates dir + caches resolved path. Throws on dir-creation failure. */
+    async ensureDirResolved() {
+        if (this.resolvedDir)
+            return this.resolvedDir;
+        await fsAsync.mkdir(this.dir, { recursive: true, mode: this.dirMode });
+        this.resolvedDir = await fsAsync.realpath(this.dir);
+        return this.resolvedDir;
+    }
+    scheduleRotation(taskId, st) {
+        if (st.state !== "NORMAL")
+            return; // already in flight
+        st.state = "ROTATING";
+        void st.queue.add(() => this.rotateLocked(taskId, st));
+    }
+    async rotateLocked(taskId, st) {
+        try {
+            const dir = await this.ensureDirResolved();
+            const live = path.join(dir, `${taskId}.log`);
+            const archive = path.join(dir, `${taskId}.log.1`);
+            // Realpath-at-op-time defeats symlink-swap mid-runtime.
+            try {
+                const real = await fsAsync.realpath(live);
+                const rel = path.relative(dir, real);
+                if (rel.startsWith("..") || path.isAbsolute(rel)) {
+                    throw new ScrollbackStoreError("scrollback_path_outside_dir", `realpath escape during rotate for ${taskId}: ${real}`);
+                }
+            }
+            catch (err) {
+                // ENOENT = nothing to rotate (cleared mid-flight). OK.
+                if (err.code !== "ENOENT")
+                    throw err;
+            }
+            // Phase-3 review fix (MEDIUM): unlink any existing `.log.1`
+            // BEFORE renaming. fs.rename overwrite semantics differ across
+            // Node versions / OSes — explicit unlink makes rotation
+            // deterministic + idempotent.
+            try {
+                await fsAsync.unlink(archive);
+            }
+            catch (err) {
+                if (err.code !== "ENOENT") {
+                    // eslint-disable-next-line no-console
+                    console.warn(`[scrollback] rotate pre-unlink archive failed for ${taskId}: ${err.message}`);
+                }
+            }
+            try {
+                await this.safeRename(live, archive);
+            }
+            catch (err) {
+                if (err.code !== "ENOENT") {
+                    // Rename failed after retries. Don't drop bytes — the
+                    // rotationBuffer carries data; flush goes to a fresh `.log`.
+                    // eslint-disable-next-line no-console
+                    console.warn(`[scrollback] rotate rename failed for ${taskId}: ${err.message}`);
+                }
+            }
+            // Reset size; next write will create a fresh `.log`.
+            st.size = 0;
+            // State → ROTATION_FLUSH; drain rotationBuffer to fresh `.log`.
+            st.state = "ROTATION_FLUSH";
+            while (st.rotationBuffer.length > 0) {
+                const chunk = st.rotationBuffer.shift();
+                try {
+                    fsSync.appendFileSync(this.taskFilePath(taskId), chunk, {
+                        mode: this.fileMode,
+                    });
+                    st.size += chunk.byteLength;
+                    st.rotationBufferBytes -= chunk.byteLength;
+                }
+                catch (err) {
+                    // eslint-disable-next-line no-console
+                    console.warn(`[scrollback] flush after rotate failed for ${taskId}: ${err.message}`);
+                    break;
+                }
+            }
+        }
+        finally {
+            st.state = "NORMAL";
+        }
+    }
+    async safeRename(from, to) {
+        let lastErr = null;
+        for (let attempt = 0; attempt < this.renameMaxAttempts; attempt++) {
+            try {
+                await this.renameFn(from, to);
+                return;
+            }
+            catch (err) {
+                lastErr = err;
+                const code = lastErr.code;
+                if (code !== "EBUSY" && code !== "EPERM")
+                    throw err;
+                await new Promise((r) => setTimeout(r, 50 + Math.floor(Math.random() * 50)));
+            }
+        }
+        if (lastErr)
+            throw lastErr;
+    }
+    async readLocked(taskId) {
+        const dir = await this.ensureDirResolved();
+        const live = path.join(dir, `${taskId}.log`);
+        const archive = path.join(dir, `${taskId}.log.1`);
+        let liveBuf = null;
+        let archiveBuf = null;
+        try {
+            liveBuf = await fsAsync.readFile(live);
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+        }
+        try {
+            archiveBuf = await fsAsync.readFile(archive);
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+        }
+        if (!liveBuf && !archiveBuf)
+            return "";
+        // Iterate C (ADR-087) — the ADR-069 sanitizer is RETIRED. We return
+        // the raw bytes verbatim. UTF-8 decode is still done via
+        // StringDecoder so multi-byte codepoints split across the rotation
+        // boundary round-trip cleanly.
+        const decoder = new StringDecoder("utf8");
+        let out = "";
+        if (archiveBuf)
+            out += decoder.write(archiveBuf);
+        if (liveBuf)
+            out += decoder.write(liveBuf);
+        out += decoder.end();
+        // Tail to maxBytesPerTask of UTF-8-encoded length.
+        const maxBytes = this.opts.maxBytesPerTask;
+        const utf8Buf = Buffer.from(out, "utf8");
+        if (utf8Buf.byteLength <= maxBytes)
+            return out;
+        const tail = utf8Buf.subarray(utf8Buf.byteLength - maxBytes);
+        return new StringDecoder("utf8").end(tail);
+    }
+    async clearLocked(taskId, loud) {
+        let resolvedFile;
+        try {
+            resolvedFile = await this.resolveTaskFile(taskId);
+        }
+        catch (err) {
+            if (loud)
+                throw err;
+            // eslint-disable-next-line no-console
+            console.warn(`[scrollback] clear best-effort path-resolve failed for ${taskId}: ${err.message}`);
+            return;
+        }
+        const dir = await this.ensureDirResolved();
+        const archive = path.join(dir, `${taskId}.log.1`);
+        const operations = [];
+        operations.push(fsAsync.unlink(resolvedFile).catch((err) => {
+            if (err.code === "ENOENT")
+                return;
+            if (loud)
+                throw err;
+            // eslint-disable-next-line no-console
+            console.warn(`[scrollback] clear .log failed for ${taskId}: ${err.message}`);
+        }));
+        operations.push(fsAsync.unlink(archive).catch((err) => {
+            if (err.code === "ENOENT")
+                return;
+            if (loud)
+                throw err;
+            // eslint-disable-next-line no-console
+            console.warn(`[scrollback] clear .log.1 failed for ${taskId}: ${err.message}`);
+        }));
+        await Promise.all(operations);
+        const st = this.states.get(taskId);
+        if (st) {
+            st.size = 0;
+            st.rotationBuffer = [];
+            st.rotationBufferBytes = 0;
+            st.state = "NORMAL";
+        }
+    }
+}
+//# sourceMappingURL=scrollback-store.js.map

package/server/dist/terminal/scrollback-store.js.map

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

package/server/dist/terminal/snapshot-preserve.d.ts

@@ -0,0 +1,63 @@
+/** ADR-096 threshold. A new payload below this fraction of an existing
+ *  on-disk payload is treated as a TUI alt-screen-exit clear and the write
+ *  is skipped to preserve the richer snapshot. Heuristic — do NOT tune
+ *  without re-verifying the DECRST-1049 scenario. */
+export declare const SNAPSHOT_PRESERVE_THRESHOLD = 0.6;
+/** Minimal read+write surface the gate needs — structurally satisfied by
+ *  SnapshotStore, and by a fake in unit tests. */
+export interface SnapshotReadWrite {
+    read(taskId: string): Promise<{
+        data: string;
+    } | null>;
+    write(taskId: string, payload: {
+        cols: number;
+        rows: number;
+        data: string;
+    }): Promise<void>;
+}
+export interface WriteSnapshotPreservingLargerOpts {
+    /** Structured logger for the skip / read-failure notices. Defaults to
+     *  console.warn so production observability picks up misclassifications
+     *  without a code change (matches the original inline gate). */
+    log?: (msg: string) => void;
+    /** Caller label embedded in the warn lines (e.g. "finalizeMirrorSnapshot"
+     *  / "flushMirrorSnapshot") so a skip is attributable in the logs. */
+    caller?: string;
+    /** SYNCHRONOUS liveness predicate re-checked immediately before the write
+     *  enqueue (no await between the check and store.write). Returns false to
+     *  ABORT the write — closes the resurrection race where the unqueued
+     *  `await store.read` yields the loop and a concurrent delete cascade
+     *  (kill sets tornDown + clear() unlinks the snapshot) lands in the gap;
+     *  without this, the post-read write would re-create the just-wiped file.
+     *  The flush path passes `() => !entry.tornDown`; the kill/finalize path
+     *  OMITS it (its write must land). See the RESURRECTION GUARD note above. */
+    shouldProceed?: () => boolean;
+}
+export interface WriteSnapshotResult {
+    /** True when the write did NOT happen — either a preserve-skip (richer
+     *  existing snapshot) or a liveness abort (see `aborted`). */
+    skipped: boolean;
+    /** True when the write was ABORTED by `shouldProceed()` returning false
+     *  (liveness lost between read and write — a concurrent delete/teardown).
+     *  Distinct from a preserve-skip: `aborted` means "do NOT resurrect", not
+     *  "keep the richer existing one". Absent/false on the preserve-skip and
+     *  write branches. */
+    aborted?: boolean;
+}
+/**
+ * Write `payload` for `taskId` via `store`, UNLESS an existing on-disk
+ * snapshot is substantially larger — in which case preserve the existing
+ * one and skip the write (ADR-096).
+ *
+ * Best-effort on read: a read failure logs and falls through to write, so a
+ * malformed/unreadable existing snapshot never blocks persistence.
+ *
+ * Never throws for the gate logic itself; a `write` rejection propagates to
+ * the caller (both call sites already wrap this in try/catch).
+ */
+export declare function writeSnapshotPreservingLarger(store: SnapshotReadWrite, taskId: string, payload: {
+    cols: number;
+    rows: number;
+    data: string;
+}, opts?: WriteSnapshotPreservingLargerOpts): Promise<WriteSnapshotResult>;
+//# sourceMappingURL=snapshot-preserve.d.ts.map

package/server/dist/terminal/snapshot-preserve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-preserve.d.ts","sourceRoot":"","sources":["../../src/terminal/snapshot-preserve.ts"],"names":[],"mappings":"AAiEA;;;qDAGqD;AACrD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;kDACkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACvD,KAAK,CACH,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IAChD;;oEAEgE;IAChE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B;0EACsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;iFAO6E;IAC7E,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC;kEAC8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB;;;;0BAIsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrD,IAAI,GAAE,iCAAsC,GAC3C,OAAO,CAAC,mBAAmB,CAAC,CA2C9B"}