tickmarkr 1.85.0 → 1.87.0

package/skills/tickmarkr-overseer/scripts/watch-artifacts.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+# Wake the overseer when spawned seats have actually DELIVERED.
+#
+#   watch-artifacts.sh <marker> <cap-seconds> <poll-seconds> <file>...
+#
+# Completion is the ARTIFACT plus its TERMINAL MARKER — never an agent's `done`, which is turn end and
+# fires the moment a seat finishes acknowledging you. Never file existence alone either: a seat killed
+# mid-write leaves a large, plausible, truncated file. Size proves it started; the marker proves it
+# finished. Measured 2026-08-06: one 10KB verdict was on disk while its seat still read `working`, and two
+# 30KB/12.8KB verdicts sat COMPLETE for minutes with nothing watching, found only because the operator
+# asked (OBS-369).
+#
+# ARM THIS IN THE SAME CALL THAT SPAWNS THE SEAT. A watcher armed later leaves an unwatched gap exactly as
+# wide as however long you stay busy — and you will be busy, because you just spawned work.
+#
+# Prints one wake reason and EXITS. Re-arm after every wake.
+#
+# TKR_CLOSE_PANES="w1:p1,w1:p2" closes those panes when every artifact completes — the answer to panes
+# accumulating because nobody was watching for "this seat is finished". It fires ONLY on completion,
+# never on timeout. Operator-observed 2026-08-06: five consult panes in one tab left each 14 columns
+# wide and unreadable, because closing was a step someone had to remember.
+set -u
+# macOS ships bash 3.2, where `set -u` makes "${arr[@]}" on an EMPTY array a fatal unbound-variable
+# error. Every expansion below therefore uses the ${arr[@]+"${arr[@]}"} guard. Caught by the timeout
+# control, not by the completion one: the happy path was green while the path that runs on almost every
+# arm crashed before printing its reason — a watcher that dies without a wake reason is the exact failure
+# this script exists to prevent.
+
+MARKER="${1:?usage: watch-artifacts.sh <marker> <cap-seconds> <poll-seconds> <file>...}"
+CAP="${2:?}"
+POLL="${3:?}"
+shift 3
+[ "$#" -gt 0 ] || { echo "watch-artifacts: no files given" >&2; exit 2; }
+
+# Cap BELOW the host's background-job kill so every arm ends by PRINTING something. A job killed at the
+# limit carries no wake reason and is indistinguishable from a real wake until you read the output —
+# OBS-325, re-earned by a third watcher that had not been capped because the fix was applied only to the
+# two that happened to be in view at the time. Class, not instance.
+END=$((SECONDS + CAP))
+
+# A file is DONE when the marker appears in its last few lines. Anchored to the tail on purpose: a report
+# that merely *mentions* its own marker mid-body has not finished, and grepping the whole file would call
+# that done. This brief tells seats to end the file with the marker, so the tail is where it must be.
+done_file() {
+  [ -s "$1" ] || return 1
+  tail -5 "$1" 2>/dev/null | grep -qF -- "$MARKER"
+}
+
+while :; do
+  pending=()
+  ready=()
+  for f in "$@"; do
+    if done_file "$f"; then ready+=("$f"); else pending+=("$f"); fi
+  done
+
+  if [ "${#pending[@]}" -eq 0 ]; then
+    echo "WAKE: all ${#ready[@]} artifact(s) complete with marker '$MARKER'"
+    for f in ${ready[@]+"${ready[@]}"}; do echo "  READY  $(wc -c <"$f" | tr -d ' ') bytes  $f"; done
+    # A seat whose artifact is COMPLETE has nothing left to give: the report is the archive, the pane is
+    # not. Closing here is safe precisely because the marker — not `done`, not a size — is the trigger,
+    # so this can never reap a seat mid-write. Only on the COMPLETE path: on a timeout the seats are
+    # still working and closing one would destroy the work being waited for.
+    if [ -n "${TKR_CLOSE_PANES:-}" ]; then
+      for pane in ${TKR_CLOSE_PANES//,/ }; do
+        # `herdr pane close` exits 0 even for a pane that is already gone, so report the body rather
+        # than the status — an exit code here would claim a close that may never have happened.
+        printf '  CLOSED %s -> %s\n' "$pane" "$(herdr pane close "$pane" 2>&1 | head -c 80)"
+      done
+    fi
+    exit 0
+  fi
+
+  if [ "$SECONDS" -ge "$END" ]; then
+    # Timing out is NOT failure and must not read as one: it is the heartbeat that proves the watcher was
+    # alive and still watching. Report both sides so the state is unambiguous on arrival.
+    echo "WAKE: cap ${CAP}s reached — ${#ready[@]} of $# complete, re-arm"
+    for f in ${ready[@]+"${ready[@]}"};   do echo "  READY    $(wc -c <"$f" | tr -d ' ') bytes  $f"; done
+    for f in ${pending[@]+"${pending[@]}"}; do
+      if [ -s "$f" ]; then echo "  PARTIAL  $(wc -c <"$f" | tr -d ' ') bytes, no '$MARKER' yet  $f"
+      else echo "  ABSENT   $f"; fi
+    done
+    exit 0
+  fi
+
+  sleep "$POLL"
+done

package/skills/tickmarkr-overseer/scripts/watch-panes.sh

@@ -28,7 +28,7 @@ WORKER="${1:?worker pane id required}"
 ORCH="${2:?orchestrator pane id required}"
 shift 2
 FAST_BLOCKED=false
-CAP=14400
+CAP=240   # a backgrounded Bash job is killed at 300s; a longer cap can never be reached (OBS-325)
 SETTLE=60
 while [ $# -gt 0 ]; do
   case "$1" in

package/dist/tui/ink/studio-app.d.ts

@@ -1,59 +0,0 @@
-import { type RunGraph } from "../../graph/schema.js";
-import { type JournalEvent } from "../../run/journal.js";
-import { FleetStaging } from "../staging.js";
-export type StudioInkView = {
-    id: string;
-    label: string;
-    render(props: {
-        cols: number;
-        rows: number;
-    }): string[];
-    key?(name: string): void;
-};
-export type StudioInkIO = {
-    input: NodeJS.ReadStream;
-    output: NodeJS.WriteStream;
-    views?: StudioInkView[];
-    repoRoot?: string;
-    globalDir?: string;
-    staging?: FleetStaging;
-    runsData?: RunsCockpitData;
-    clock?: () => number;
-    debug?: boolean;
-};
-export type RunsCockpitData = {
-    runId?: string;
-    events: JournalEvent[];
-    graph: RunGraph;
-    prompts?: Record<string, string[]>;
-};
-type DossierVerdict = {
-    action: "retry" | "reroute" | "decompose" | "human";
-    reason?: string;
-    prompt?: string;
-};
-type ConsultDossierData = {
-    taskId: string;
-    verdicts: DossierVerdict[];
-};
-type RunsCockpitTask = {
-    id: string;
-    status: string;
-    phase?: string;
-    elapsed?: string;
-    consultCount: number;
-};
-export declare function foldConsultDossier(data: RunsCockpitData, taskId: string): ConsultDossierData;
-export declare function buildRunsCockpitTasks(data: RunsCockpitData, nowMs: number): RunsCockpitTask[];
-export declare function StudioApp({ views: suppliedViews, repoRoot, globalDir, staging: suppliedStaging, runsData: suppliedRunsData, clock, columns, rows, }: {
-    views?: StudioInkView[];
-    repoRoot?: string;
-    globalDir?: string;
-    staging?: FleetStaging;
-    runsData?: RunsCockpitData;
-    clock?: () => number;
-    columns?: number;
-    rows?: number;
-}): import("react").JSX.Element;
-export declare function runStudioInk({ input, output, views, repoRoot, globalDir, staging, runsData, clock, debug, }: StudioInkIO): Promise<void>;
-export {};

package/dist/tui/ink/studio-app.js

@@ -1,320 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { render, useApp, useInput } from "ink";
-import { useEffect, useRef, useState } from "react";
-import { allAdapters, doctorAgeMs, readDoctor } from "../../adapters/registry.js";
-import { fleetEditableFromConfig, loadConfig } from "../../config/config.js";
-import { loadGraph } from "../../graph/graph.js";
-import { Journal, readAllTelemetry, RUNS_WINDOW, } from "../../run/journal.js";
-import { buildSaveProposal, confirmSave } from "../save.js";
-import { FleetStaging } from "../staging.js";
-import { DiffConfirmationScreen, StudioScreen, } from "./components.js";
-const STATUS = {
-    "task-dispatch": "running", "task-done": "done", "task-failed": "failed",
-    "task-human": "human", "task-approved": "pending",
-};
-const HELP = [
-    "Key bindings",
-    "1-5      switch view",
-    "tab      cycle views",
-    "?        show this help",
-    "esc / q  quit",
-    "u        revert staged changes",
-    "s        save staged changes",
-];
-function loadFleetData(repoRoot) {
-    try {
-        const cfg = loadConfig(repoRoot);
-        const health = readDoctor(repoRoot);
-        if (!health)
-            return undefined;
-        const editable = fleetEditableFromConfig(cfg);
-        const adapters = allAdapters().flatMap((adapter) => {
-            if (!health[adapter.id]?.installed)
-                return [];
-            const models = adapter.channels(cfg).map((channel) => ({
-                model: channel.model,
-                tier: channel.tier,
-                channel: channel.channel,
-            }));
-            return models.length ? [{ adapter: adapter.id, models }] : [];
-        });
-        return {
-            adapters,
-            health,
-            doctorAgeMs: doctorAgeMs(repoRoot),
-            denyAdapters: editable.denyAdapters,
-            denyModels: editable.denyModels,
-            telemetry: readAllTelemetry(repoRoot, RUNS_WINDOW),
-        };
-    }
-    catch {
-        // Best-effort read surface: line-mode commands remain the diagnostic path when config is unavailable.
-        return undefined;
-    }
-}
-function emptyStaging() {
-    return new FleetStaging({
-        denyAdapters: [],
-        denyModels: [],
-        tiers: {},
-        map: {},
-        floors: {},
-    });
-}
-function loadStaging(repoRoot) {
-    try {
-        return new FleetStaging(fleetEditableFromConfig(loadConfig(repoRoot)));
-    }
-    catch {
-        return emptyStaging();
-    }
-}
-const componentView = (id, label, line) => ({ id, label, render: () => [line] });
-const createView = (id, label) => (..._) => componentView(id, label, `${label} view`);
-const createFleetView = createView("fleet", "Fleet"), createRoutingView = createView("routing", "Routing"), createPreviewView = createView("preview", "Preview"), createProfileView = createView("profile", "Profile"), createRunsView = createView("runs", "Runs");
-function defaultViews(repoRoot, staging) {
-    return [
-        createFleetView(loadFleetData(repoRoot), staging),
-        createRoutingView({ repoRoot, staging }),
-        createPreviewView({ cwd: repoRoot }),
-        createProfileView({ repoRoot }),
-        createRunsView(undefined, { repoRoot }),
-    ];
-}
-const emptyGraph = () => ({ version: 1, spec: { source: "prd", paths: [], hash: "" }, tasks: [] });
-function loadRunsData(repoRoot) {
-    const runId = Journal.latestRunId(repoRoot, { withJournal: true }) ?? undefined;
-    let graph = emptyGraph();
-    try {
-        graph = loadGraph(repoRoot);
-    }
-    catch { /* no graph loaded */ }
-    return { runId, events: runId ? Journal.open(repoRoot, runId).read() : [], graph };
-}
-export function foldConsultDossier(data, taskId) {
-    let prompt = 0;
-    const verdicts = data.events.flatMap((event) => {
-        if (event.taskId !== taskId || event.event !== "consult-verdict")
-            return [];
-        const action = event.data.action;
-        if (!["retry", "reroute", "decompose", "human"].includes(action))
-            return [];
-        return [{
-                action,
-                reason: typeof event.data.reason === "string" ? event.data.reason : undefined,
-                prompt: data.prompts?.[taskId]?.[prompt++],
-            }];
-    });
-    return { taskId, verdicts };
-}
-export function buildRunsCockpitTasks(data, nowMs) {
-    return data.graph.tasks.map((task) => {
-        const events = data.events.filter((event) => event.taskId === task.id);
-        const state = [...events].reverse().find((event) => STATUS[event.event]);
-        const status = STATUS[state?.event ?? ""] ?? task.status;
-        const phaseStart = [...events].reverse().find((event) => event.event === "phase-start");
-        const start = phaseStart ?? (state?.event === "task-dispatch" ? state : undefined);
-        const phase = typeof phaseStart?.data.phase === "string" ? phaseStart.data.phase : undefined;
-        const running = status === "running" && start !== undefined;
-        const elapsedMs = running ? Math.max(0, nowMs - Date.parse(start.ts)) : 0;
-        return {
-            id: task.id, status,
-            ...(running ? { phase: phase ?? "worker",
-                elapsed: `${Math.floor(elapsedMs / 1000)}s` } : {}),
-            consultCount: foldConsultDossier(data, task.id).verdicts.length,
-        };
-    });
-}
-function dossierLines(data) {
-    if (!data)
-        return ["d opens consult dossier"];
-    if (!data.verdicts.length)
-        return [`no consult verdicts recorded for ${data.taskId}`];
-    return [`Consult dossier — ${data.taskId}`, "d back", ...data.verdicts.flatMap((verdict, index) => [
-            `❯ ${index + 1}. ${verdict.action}${verdict.reason ? ` — ${verdict.reason}` : ""}`,
-            `  prompt ${index + 1}`,
-            ...(verdict.prompt ?? "(prompt unavailable)").split("\n")
-                .map((line) => `  ${line.replace(/^#{1,6}\s+/, "")}`),
-        ])];
-}
-function runsLines(runId, tasks, cursor) {
-    if (!runId)
-        return ["Runs cockpit", "no run loaded"];
-    return [`Runs cockpit — ${runId}`, "d consult dossier", ...tasks.flatMap((task, index) => [
-            `${index === cursor ? "❯ " : "  "}${task.id} — ${task.status}`,
-            `  ${task.phase ? `${task.phase} · ${task.elapsed}` : "waiting"}${task.consultCount ? ` · ${task.consultCount} consult verdict` : ""}`,
-        ])];
-}
-export function StudioApp({ views: suppliedViews, repoRoot = process.cwd(), globalDir, staging: suppliedStaging, runsData: suppliedRunsData, clock = Date.now, columns = 80, rows = 24, }) {
-    const { exit } = useApp();
-    const stagingRef = useRef(undefined);
-    stagingRef.current ??= suppliedStaging ?? loadStaging(repoRoot);
-    const staging = stagingRef.current;
-    const viewsRef = useRef(undefined);
-    viewsRef.current ??= suppliedViews ?? defaultViews(repoRoot, staging);
-    const views = viewsRef.current;
-    const [active, setActive] = useState(0);
-    const [help, setHelp] = useState(false);
-    const [saveProposal, setSaveProposal] = useState(null);
-    const [notice, setNotice] = useState(null);
-    const [runsData, setRunsData] = useState(() => suppliedRunsData ?? loadRunsData(repoRoot));
-    const [nowMs, setNowMs] = useState(clock);
-    const [dossierOpen, setDossierOpen] = useState(false);
-    const [, repaint] = useState(0);
-    const nativeRuns = suppliedViews === undefined && views[active]?.id === "runs";
-    const runTasks = buildRunsCockpitTasks(runsData, nowMs);
-    const runsCursor = Math.max(0, runTasks.findIndex((task) => task.consultCount > 0));
-    const selectedRunTask = runTasks[runsCursor];
-    const dossier = selectedRunTask ? foldConsultDossier(runsData, selectedRunTask.id) : undefined;
-    useEffect(() => {
-        if (!nativeRuns)
-            return;
-        const timer = setInterval(() => {
-            setNowMs(clock());
-            if (!suppliedRunsData)
-                setRunsData(loadRunsData(repoRoot));
-        }, 250);
-        return () => clearInterval(timer);
-    }, [clock, nativeRuns, repoRoot, suppliedRunsData]);
-    useInput((input, key) => {
-        if (key.escape) {
-            if (help)
-                setHelp(false);
-            else if (saveProposal)
-                setSaveProposal(null);
-            else
-                exit();
-            return;
-        }
-        if (key.ctrl && input === "c") {
-            exit();
-            return;
-        }
-        if (saveProposal) {
-            if (input === "n") {
-                setSaveProposal(null);
-            }
-            else if (input === "t") {
-                const target = saveProposal.target === "repo" ? "global" : "repo";
-                setSaveProposal(buildSaveProposal({
-                    repoRoot,
-                    loaded: staging.loadedState,
-                    staged: staging.current,
-                    target,
-                    globalDir,
-                }));
-            }
-            else if (input === "y") {
-                const result = confirmSave({
-                    repoRoot,
-                    loaded: staging.loadedState,
-                    staged: staging.current,
-                    target: saveProposal.target,
-                    globalDir,
-                });
-                if (result.kind === "written") {
-                    const nextStaging = new FleetStaging(staging.current);
-                    stagingRef.current = nextStaging;
-                    if (!suppliedViews)
-                        viewsRef.current = defaultViews(repoRoot, nextStaging);
-                    setNotice(`wrote ${result.path}`);
-                }
-                else if (result.kind === "refused") {
-                    setNotice(`save refused: ${result.reason}`);
-                }
-                setSaveProposal(null);
-            }
-            return;
-        }
-        if (input === "q") {
-            if (!help)
-                exit();
-            return;
-        }
-        if (input === "?") {
-            setHelp(true);
-            return;
-        }
-        if (help)
-            return;
-        if (nativeRuns && input === "d" && (dossierOpen || selectedRunTask)) {
-            setDossierOpen((open) => !open);
-            return;
-        }
-        if (input === "s") {
-            if (!staging.isDirty) {
-                setNotice("no staged changes");
-            }
-            else {
-                setNotice(null);
-                setSaveProposal(buildSaveProposal({
-                    repoRoot,
-                    loaded: staging.loadedState,
-                    staged: staging.current,
-                    target: "repo",
-                    globalDir,
-                }));
-            }
-            return;
-        }
-        if (input === "u") {
-            staging.revert();
-            setNotice(staging.isDirty ? null : "no staged changes");
-            repaint((revision) => revision + 1);
-            return;
-        }
-        if (key.tab) {
-            setActive((index) => (index + 1) % views.length);
-            setNotice(null);
-            setDossierOpen(false);
-            return;
-        }
-        if (/^[1-9]$/.test(input)) {
-            const index = Number(input) - 1;
-            if (index < views.length) {
-                setActive(index);
-                setNotice(null);
-                setDossierOpen(false);
-            }
-            return;
-        }
-        const name = key.upArrow ? "up" : key.downArrow ? "down" : null;
-        if (name) {
-            views[active]?.key?.(name);
-            repaint((revision) => revision + 1);
-        }
-    });
-    const view = views[active];
-    const lines = help
-        ? HELP
-        : nativeRuns
-            ? dossierOpen
-                ? dossierLines(dossier)
-                : runsLines(runsData.runId, runTasks, runsCursor)
-            : [
-                ...view.render({ cols: columns, rows: Math.max(rows - 2, 1) }),
-                ...(notice ? [notice] : []),
-            ];
-    const count = staging.changeCount;
-    const status = staging.isDirty
-        ? `● ${count} staged change${count === 1 ? "" : "s"}`
-        : "no staged changes";
-    return (_jsx(StudioScreen, { tabs: views.map((candidate) => candidate.label), active: active, lines: lines, status: status, children: saveProposal
-            ? (_jsx(DiffConfirmationScreen, { target: saveProposal.target, targetPath: saveProposal.targetPath, diff: saveProposal.diff, liveRun: saveProposal.liveRun }))
-            : undefined }));
-}
-export async function runStudioInk({ input, output, views, repoRoot, globalDir, staging, runsData, clock, debug = false, }) {
-    const app = render(_jsx(StudioApp, { views: views, repoRoot: repoRoot, globalDir: globalDir, staging: staging, runsData: runsData, clock: clock, columns: output.columns, rows: output.rows }), {
-        stdin: input,
-        stdout: output,
-        exitOnCtrlC: false,
-        patchConsole: false,
-        debug,
-    });
-    try {
-        await app.waitUntilExit();
-    }
-    finally {
-        app.unmount();
-    }
-}

package/dist/tui/save.d.ts

@@ -1,38 +0,0 @@
-import { type FleetEditable } from "../config/config.js";
-export type SaveTarget = "repo" | "global";
-/** Notice surfaced in the save modal whenever a run lock is live. */
-export declare const RELOAD_GUARD_NOTICE = "reload guard: a live run is active; the running daemon will not see these changes until it reloads";
-export type SaveProposal = {
-    target: SaveTarget;
-    targetPath: string;
-    before: string;
-    after: string;
-    diff: string;
-    liveRun: boolean;
-    loadError: string | null;
-};
-export type SaveResult = {
-    kind: "written";
-    path: string;
-} | {
-    kind: "declined";
-} | {
-    kind: "refused";
-    reason: string;
-};
-/** Build the diff-confirm payload for the current staging delta and chosen target. */
-export declare function buildSaveProposal(opts: {
-    repoRoot: string;
-    loaded: FleetEditable;
-    staged: FleetEditable;
-    target: SaveTarget;
-    globalDir?: string;
-}): SaveProposal;
-/** Confirm and execute the write for the chosen target. */
-export declare function confirmSave(opts: {
-    repoRoot: string;
-    loaded: FleetEditable;
-    staged: FleetEditable;
-    target: SaveTarget;
-    globalDir?: string;
-}): SaveResult;

package/dist/tui/save.js

@@ -1,96 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { existsSync, mkdtempSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { dirname, join } from "node:path";
-import { fleetEditableFromConfig, fleetEditableEquals, fleetRepoOverlayFromDelta, globalConfigDir, loadConfigWithMode, readOverlayFile, repoOverlayPath, repoOverlayYaml, unifiedYamlDiff, } from "../config/config.js";
-import { isRunLockLive } from "../run/lock.js";
-/** Notice surfaced in the save modal whenever a run lock is live. */
-export const RELOAD_GUARD_NOTICE = "reload guard: a live run is active; the running daemon will not see these changes until it reloads";
-function overlayPath(repoRoot, target, globalDir) {
-    return target === "repo"
-        ? repoOverlayPath(repoRoot)
-        : join(globalDir ?? globalConfigDir(), "config.yaml");
-}
-function currentOverlayText(path) {
-    return existsSync(path) ? readFileSync(path, "utf8") : "";
-}
-function computeAfterBytes(target, loaded, staged, repoRoot, globalDir) {
-    const path = overlayPath(repoRoot, target, globalDir);
-    const existing = readOverlayFile(path);
-    // Reuse the existing fleet serializer and diff renderer rather than inventing a parallel formatter.
-    const merged = fleetRepoOverlayFromDelta(loaded, staged, existing);
-    return repoOverlayYaml(merged);
-}
-function roundTripError(target, repoRoot, after, staged, globalDir) {
-    try {
-        let effective;
-        if (target === "repo") {
-            effective = loadConfigWithMode(repoRoot, { globalDir, repoOverlayText: after });
-        }
-        else {
-            // Validate a candidate global overlay by loading with it in a scratch globalDir.
-            const scratch = mkdtempSync(join(tmpdir(), "tickmarkr-global-rt-"));
-            try {
-                writeFileSync(join(scratch, "config.yaml"), after);
-                effective = loadConfigWithMode(repoRoot, { globalDir: scratch });
-            }
-            finally {
-                try {
-                    rmSync(scratch, { recursive: true, force: true });
-                }
-                catch { /* best-effort cleanup */ }
-            }
-        }
-        const reparsed = fleetEditableFromConfig(effective.cfg);
-        if (!fleetEditableEquals(reparsed, staged)) {
-            return "round-trip mismatch: the written overlay does not re-parse to the staged state";
-        }
-        return null;
-    }
-    catch (e) {
-        return e.message;
-    }
-}
-/** Build the diff-confirm payload for the current staging delta and chosen target. */
-export function buildSaveProposal(opts) {
-    const path = overlayPath(opts.repoRoot, opts.target, opts.globalDir);
-    const before = currentOverlayText(path);
-    const after = computeAfterBytes(opts.target, opts.loaded, opts.staged, opts.repoRoot, opts.globalDir);
-    const diff = unifiedYamlDiff(before, after, path);
-    const loadError = roundTripError(opts.target, opts.repoRoot, after, opts.staged, opts.globalDir);
-    return {
-        target: opts.target,
-        targetPath: path,
-        before,
-        after,
-        diff,
-        liveRun: isRunLockLive(opts.repoRoot),
-        loadError,
-    };
-}
-function atomicWrite(path, bytes) {
-    const dir = dirname(path);
-    mkdirSync(dir, { recursive: true });
-    // The sibling temp keeps rename(2) on one filesystem: readers see old or new bytes, never a partial overlay.
-    const tmp = join(dir, `.tickmarkr-save-${randomUUID()}.tmp`);
-    try {
-        writeFileSync(tmp, bytes);
-        renameSync(tmp, path);
-    }
-    catch (e) {
-        rmSync(tmp, { force: true }); // a failed rename must not leave a partial candidate behind
-        throw e;
-    }
-}
-/** Confirm and execute the write for the chosen target. */
-export function confirmSave(opts) {
-    const proposal = buildSaveProposal(opts);
-    if (proposal.loadError) {
-        return { kind: "refused", reason: proposal.loadError };
-    }
-    if (proposal.before === proposal.after) {
-        return { kind: "declined" };
-    }
-    atomicWrite(proposal.targetPath, proposal.after);
-    return { kind: "written", path: proposal.targetPath };
-}

package/dist/tui/staging.d.ts

@@ -1,29 +0,0 @@
-import { type FleetEditable } from "../config/config.js";
-/** One in-memory edit to the buffered fleet state. */
-export type FleetEdit = (buffer: FleetEditable) => void;
-/**
- * Staged-changes buffer for the Fleet Studio write path.
- *
- * - The loaded state is captured at construction and never mutated.
- * - Edits apply to an in-memory buffer only.
- * - `revert()` discards the buffer and restores the loaded state.
- * - The delta is computed through the existing `fleetEditableEquals` comparison.
- * - No code path in this module writes to disk.
- */
-export declare class FleetStaging {
-    private readonly loaded;
-    private buffer;
-    constructor(loaded: FleetEditable);
-    /** Read-only snapshot of the originally loaded state. */
-    get loadedState(): FleetEditable;
-    /** Current buffered (possibly edited) state. */
-    get current(): FleetEditable;
-    /** Apply an edit to the buffer. Never touches disk. */
-    apply(edit: FleetEdit): void;
-    /** Discard all buffered edits and restore the loaded state. */
-    revert(): void;
-    /** True when the buffer differs from the loaded state. */
-    get isDirty(): boolean;
-    /** Number of distinct staged changes vs the loaded state. */
-    get changeCount(): number;
-}