parasor 0.1.0

package/server/cli/pty-host.js

@@ -0,0 +1,390 @@
+/*
+ * -- `parasor pty-host` CLI subcommands.
+ *
+ *   start    Start the daemon (idempotent).
+ *   stop     Send SIGTERM to the running daemon, wait for graceful exit.
+ *   status   Print pid + socket path + mode (running/down/locked-by-other).
+ *   restart  stop + start in sequence (does *not* terminate sessions --
+ *            the daemon's  SIGTERM/SIGKILL escalation is governed by
+ *            the daemon itself; restart is a one-shot supervisor op).
+ *   doctor   Diagnostic dump for support: paths, lockfile state, recorded
+ *            pid liveness, mode-marker, last 50 lines of the daemon log,
+ *            and the SessionRecord table from AppState.
+ *
+ * All commands take Partial<PtyHostDeps> for test seams. Production
+ * defaults wrap node:fs / node:child_process / node:net.
+ */
+import { spawn as realSpawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { markerFileFor, readMarker } from "../pty/host-daemon/mode-marker.js";
+import { resolveDaemonPaths, } from "../pty/host-daemon/paths.js";
+import { AppStateStore } from "../state/app-state.js";
+const STOP_TIMEOUT_MS = 10_000;
+const START_TIMEOUT_MS = 5_000;
+const POLL_INTERVAL_MS = 100;
+function defaultConfigDir() {
+    const fromEnv = process.env.PARASOR_CONFIG_DIR;
+    if (fromEnv && fromEnv.length > 0)
+        return fromEnv;
+    return join(homedir(), ".config", "parasor");
+}
+function defaultKill(pid, signal) {
+    try {
+        process.kill(pid, signal);
+        return true;
+    }
+    catch (err) {
+        return err.code === "EPERM";
+    }
+}
+function defaultSpawnDetached(cmd, args) {
+    const child = realSpawn(cmd, args, {
+        detached: true,
+        stdio: "ignore",
+    });
+    // detached spawn can emit `error` asynchronously
+    // (ENOENT for the binary, EACCES on platforms without immediate
+    // exec verification). Without a listener, unhandled error events
+    // crash the parent. The CLI start path polls the socket afterward --
+    // a failed spawn shows up as "did not become ready" rather than as
+    // a parent crash.
+    child.once("error", () => {
+        /* swallow -- caller relies on probe loop to detect non-startup */
+    });
+    child.unref();
+    return { pid: child.pid };
+}
+function defaultProbeSocket(path) {
+    return import("node:net").then((net) => new Promise((resolve) => {
+        const s = net.connect(path);
+        const finish = (outcome) => {
+            s.removeAllListeners();
+            try {
+                s.destroy();
+            }
+            catch {
+                /* ignore */
+            }
+            resolve({
+                socketReady: outcome === "ready",
+                // Connect-success and timeout both mean a live process owns
+                // the socket; only ECONNREFUSED / ENOENT / etc. prove the
+                // daemon is gone. See bootstrap.ts isSocketActive doc.
+                socketAlive: outcome === "ready" || outcome === "timeout",
+            });
+        };
+        s.once("connect", () => finish("ready"));
+        s.once("error", () => finish("error"));
+        s.setTimeout(250, () => finish("timeout"));
+    }));
+}
+function defaultReadPidFile(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const pid = Number(readFileSync(path, "utf8").trim());
+        return Number.isFinite(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+function defaultReadLog(path, lines) {
+    if (!existsSync(path))
+        return "(no log file)";
+    try {
+        const content = readFileSync(path, "utf8");
+        const all = content.split(/\r?\n/);
+        return all.slice(-lines).join("\n");
+    }
+    catch (err) {
+        return `(log unreadable: ${err.message})`;
+    }
+}
+function defaultSleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function defaultEntryPath() {
+    // dist/server/cli/pty-host.js -> ../pty/host-daemon/entry.js
+    // src/cli/pty-host.ts also resolves to the same .js after build, so
+    // tests that exercise via `tsx` need to override this.
+    const here = fileURLToPath(import.meta.url);
+    return join(here, "..", "..", "pty", "host-daemon", "entry.js");
+}
+function resolveDeps(partial) {
+    const appStateDir = partial?.appStateDir ?? defaultConfigDir();
+    return {
+        paths: partial?.paths ?? resolveDaemonPaths(),
+        appStateDir,
+        now: partial?.now ?? Date.now,
+        killProcess: partial?.killProcess ?? defaultKill,
+        spawnDetached: partial?.spawnDetached ?? defaultSpawnDetached,
+        probeSocket: partial?.probeSocket ?? defaultProbeSocket,
+        readPidFile: partial?.readPidFile ?? defaultReadPidFile,
+        readLog: partial?.readLog ?? defaultReadLog,
+        sleep: partial?.sleep ?? defaultSleep,
+        log: partial?.log ?? ((m) => console.log(m)),
+        error: partial?.error ?? ((m) => console.error(m)),
+        daemonEntryPath: partial?.daemonEntryPath ?? defaultEntryPath(),
+    };
+}
+async function probeStatus(deps) {
+    const probe = await deps.probeSocket(deps.paths.socketPath);
+    const pid = deps.readPidFile(deps.paths.pidFile);
+    /*
+     * bootstrap.isSocketActive treats a connect
+     * timeout as "alive" (fail-closed) to avoid double-spawn races.
+     * The CLI's old behavior (timeout = down) disagreed: a busy daemon
+     * mid-handshake could be flagged stale-pidfile and (post HIGH#2
+     * with --force) killed. Use socketAlive here so a live but stalled
+     * daemon stays classified `running` -- the user can investigate
+     * before forcing termination.
+     */
+    if (probe.socketAlive) {
+        return { state: "running", pid, socketReady: probe.socketReady };
+    }
+    if (pid !== null && deps.killProcess(pid, 0)) {
+        return { state: "stale-pidfile", pid, socketReady: false };
+    }
+    return { state: "down", pid: null, socketReady: false };
+}
+async function startCmd(deps) {
+    const status = await probeStatus(deps);
+    if (status.state === "running") {
+        deps.log(`parasor-pty-host already running (pid ${status.pid ?? "?"}).`);
+        return 0;
+    }
+    /*
+     * symmetry with spawn-daemon.ts. The auto-spawn
+     * path falls back to `entry.ts` + `--import tsx` when the compiled
+     * `entry.js` is missing (dev/test runs without `pnpm build`). The
+     * operator-recovery `parasor pty-host start` CLI must do the same,
+     * otherwise users on the dev tree see "entry script not found" and
+     * have no way to start the daemon manually.
+     */
+    const tsFallback = deps.daemonEntryPath.endsWith(".js")
+        ? `${deps.daemonEntryPath.slice(0, -3)}.ts`
+        : null;
+    let nodeArgs;
+    if (existsSync(deps.daemonEntryPath)) {
+        nodeArgs = [deps.daemonEntryPath];
+    }
+    else if (tsFallback && existsSync(tsFallback)) {
+        nodeArgs = ["--import", "tsx", tsFallback];
+    }
+    else {
+        deps.error(`daemon entry script not found at ${deps.daemonEntryPath} ` +
+            `(also tried ${tsFallback ?? "(no .ts fallback)"}). ` +
+            "Rebuild @parasor/server before retrying.");
+        return 1;
+    }
+    let spawned;
+    try {
+        spawned = deps.spawnDetached(process.execPath, nodeArgs);
+    }
+    catch (err) {
+        deps.error(`spawn failed: ${err.message}`);
+        return 1;
+    }
+    // Poll until socket accepts connections or timeout.
+    const deadline = deps.now() + START_TIMEOUT_MS;
+    while (deps.now() < deadline) {
+        const probe = await deps.probeSocket(deps.paths.socketPath);
+        if (probe.socketReady) {
+            const pid = deps.readPidFile(deps.paths.pidFile);
+            deps.log(`parasor-pty-host started (pid ${pid ?? "?"}, socket ${deps.paths.socketPath}).`);
+            return 0;
+        }
+        await deps.sleep(POLL_INTERVAL_MS);
+    }
+    /*
+     * timeout means our spawned child either crashed
+     * during boot or is hung. The child still holds the lockfile and may
+     * still finish writing the marker; without an explicit reap the next
+     * `start` waits 60s for proper-lockfile's stale window. Send SIGTERM
+     * to the child we just spawned so the next attempt has a clean slate.
+     * Best-effort: child may already be dead, or pid may be unknown
+     * (test stubs don't always populate it).
+     */
+    if (typeof spawned.pid === "number") {
+        deps.killProcess(spawned.pid, "SIGTERM");
+    }
+    deps.error(`daemon did not become ready within ${START_TIMEOUT_MS}ms. ` +
+        `Check ${deps.paths.logFile} for errors.`);
+    return 1;
+}
+async function stopCmd(deps, force) {
+    const status = await probeStatus(deps);
+    if (status.state === "down") {
+        deps.log("parasor-pty-host is not running.");
+        return 0;
+    }
+    /*
+     * refuse to SIGTERM a pid we cannot prove is
+     * the daemon. The kernel recycles PIDs; user-written or stale
+     * pidfiles can name an unrelated process (a long-running editor,
+     * sleep, etc.). Without a live socket on the daemon path we have
+     * no proof of ownership, so default-stop bails out and points to
+     * doctor for diagnosis. `--force` overrides for the rare ops case
+     * where the daemon crashed mid-shutdown and pidfile must be cleared.
+     */
+    if (status.state === "stale-pidfile" && !force) {
+        deps.error(`parasor-pty-host: socket ${deps.paths.socketPath} is unreachable but ` +
+            `pidfile ${deps.paths.pidFile} names a live process (pid ${status.pid ?? "?"}). ` +
+            `Refusing to send SIGTERM without ownership proof -- the pid may have been ` +
+            `recycled by the kernel. Run \`parasor pty-host doctor\` to inspect, or ` +
+            `pass \`--force\` if you have already verified the pid is the daemon.`);
+        return 1;
+    }
+    const pid = status.pid;
+    if (pid === null) {
+        deps.error(`socket reachable but pidfile missing (${deps.paths.pidFile}). ` +
+            "Cannot send SIGTERM safely.");
+        return 1;
+    }
+    if (!deps.killProcess(pid, "SIGTERM")) {
+        deps.error(`SIGTERM to pid ${pid} failed.`);
+        return 1;
+    }
+    // Poll for exit.
+    const deadline = deps.now() + STOP_TIMEOUT_MS;
+    while (deps.now() < deadline) {
+        if (!deps.killProcess(pid, 0)) {
+            deps.log(`parasor-pty-host stopped (pid ${pid}).`);
+            return 0;
+        }
+        await deps.sleep(POLL_INTERVAL_MS);
+    }
+    deps.error(`pid ${pid} did not exit after ${STOP_TIMEOUT_MS}ms. ` +
+        "Escalate manually with kill -9.");
+    return 1;
+}
+async function statusCmd(deps) {
+    const status = await probeStatus(deps);
+    const lines = [];
+    lines.push(`socket: ${deps.paths.socketPath}`);
+    lines.push(`pidfile: ${deps.paths.pidFile}`);
+    lines.push(`logfile: ${deps.paths.logFile}`);
+    lines.push(`state: ${status.state}`);
+    if (status.pid !== null)
+        lines.push(`pid: ${status.pid}`);
+    lines.push(`socket-ready: ${status.socketReady}`);
+    deps.log(lines.join("\n"));
+    return status.state === "running" ? 0 : 1;
+}
+async function restartCmd(deps, force) {
+    // restart honours the same --force semantics as stop: the daemon may
+    // be in stale-pidfile state after a crash, and the user is signalling
+    // they have verified the pid.
+    const stopRc = await stopCmd(deps, force);
+    if (stopRc !== 0) {
+        deps.error("stop failed; aborting restart.");
+        return stopRc;
+    }
+    // Small drain to give the lockfile time to release. proper-lockfile
+    // releases synchronously on graceful exit, but kernel cleanup of the
+    // socket inode can lag a few ms.
+    await deps.sleep(POLL_INTERVAL_MS);
+    return startCmd(deps);
+}
+async function doctorCmd(deps) {
+    const status = await probeStatus(deps);
+    const lines = [];
+    lines.push("=== parasor pty-host doctor ===");
+    lines.push(`runtimeDir: ${deps.paths.runtimeDir}`);
+    lines.push(`socket: ${deps.paths.socketPath}`);
+    lines.push(`pidfile: ${deps.paths.pidFile}`);
+    lines.push(`lockfile: ${deps.paths.lockFile}`);
+    lines.push(`logfile: ${deps.paths.logFile}`);
+    lines.push(`appStateDir: ${deps.appStateDir}`);
+    lines.push("");
+    lines.push(`state: ${status.state}`);
+    lines.push(`pid: ${status.pid ?? "(none)"}`);
+    lines.push(`socket-ready: ${status.socketReady}`);
+    // Mode marker -- tells us whether the AppState belongs to in-process
+    // or daemon and surfaces stale markers from a prior crash.
+    const markerFile = markerFileFor(deps.appStateDir);
+    const marker = readMarker(markerFile);
+    if (marker) {
+        lines.push(`mode-marker: ${marker.mode} (pid=${marker.pid}, startedAt=${marker.startedAt})`);
+    }
+    else {
+        lines.push("mode-marker: (none)");
+    }
+    // SessionRecord table -- both daemon and in-process modes write to it
+    // when a daemonContext is present, so this is the single best
+    // user-facing snapshot of "what PTYs are tracked".
+    // ensure store.destroy() runs even when get() or
+    // the format loop throws -- without try/finally a failing read would
+    // leak the AppStateStore's internal flush timer until process exit.
+    let store = null;
+    try {
+        store = new AppStateStore({ dir: deps.appStateDir, debounceMs: 0 });
+        const recs = store.get().sessionRecords;
+        lines.push("");
+        lines.push(`sessionRecords (${recs.length}):`);
+        for (const r of recs) {
+            lines.push(`  ${r.id} state=${r.state} pid=${r.pid ?? "-"} pgid=${r.pgid ?? "-"} ` +
+                `daemonPid=${r.daemonPid} startedAt=${r.startedAt}`);
+        }
+    }
+    catch (err) {
+        lines.push(`sessionRecords: (load failed: ${err.message})`);
+    }
+    finally {
+        store?.destroy();
+    }
+    // Tail of the log file.
+    lines.push("");
+    lines.push("=== last 50 log lines ===");
+    lines.push(deps.readLog(deps.paths.logFile, 50));
+    deps.log(lines.join("\n"));
+    return 0;
+}
+const HELP = `Usage: parasor pty-host <subcommand> [--force]
+
+Subcommands:
+  start     Start the parasor-pty-host daemon (idempotent).
+  stop      Send SIGTERM to the running daemon and wait for exit.
+            Refuses to kill when the socket is unreachable (pid may be
+            recycled). Pass --force to override after running doctor.
+  status    Print daemon state, pid, and socket path.
+  restart   stop then start. --force is forwarded to stop.
+  doctor    Diagnostic dump (paths, lockfile, sessionRecords, log tail).
+
+Environment:
+  PARASOR_PTY_SOCK     Override socket path (also relocates pid/lock/log).
+  XDG_RUNTIME_DIR      Linux runtime dir; defaults to ~/.parasor/run otherwise.
+  PARASOR_CONFIG_DIR   AppState dir (default ~/.config/parasor).`;
+export async function cliPtyHost(args, partial) {
+    const deps = resolveDeps(partial);
+    const sub = args[0];
+    // Parse --force at the subcommand argument layer rather than the top
+    // level so `parasor pty-host stop --force` reads naturally and the
+    // flag never accidentally affects start/status/doctor.
+    const force = args.slice(1).includes("--force");
+    switch (sub) {
+        case "start":
+            return startCmd(deps);
+        case "stop":
+            return stopCmd(deps, force);
+        case "status":
+            return statusCmd(deps);
+        case "restart":
+            return restartCmd(deps, force);
+        case "doctor":
+            return doctorCmd(deps);
+        case "help":
+        case "--help":
+        case "-h":
+            deps.log(HELP);
+            return 0;
+        default:
+            deps.error(`unknown subcommand: ${sub ?? "(none)"}\n\n${HELP}`);
+            return 1;
+    }
+}
+//# sourceMappingURL=pty-host.js.map

package/server/cli/pty-host.js.map

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

package/server/cli/qr.d.ts

@@ -0,0 +1,2 @@
+export declare function cliQr(args: string[]): Promise<void>;
+//# sourceMappingURL=qr.d.ts.map

package/server/cli/qr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.d.ts","sourceRoot":"","sources":["../../src/cli/qr.ts"],"names":[],"mappings":"AAkBA,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CzD"}

package/server/cli/qr.js

@@ -0,0 +1,70 @@
+import { createConnection } from "node:net";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { buildPairingUrl, buildQrSection } from "../network/qr.js";
+export async function cliQr(args) {
+    let iface;
+    for (const arg of args) {
+        if (arg.startsWith("--iface="))
+            iface = arg.slice(8);
+        else if (arg === "-h" || arg === "--help") {
+            console.log("Usage: parasor qr [--iface=<iface>]\n" +
+                "  Displays a QR code for a running parasor server. Defaults to Tailscale, falls back to LAN.");
+            return;
+        }
+    }
+    const socketPath = process.env.PARASOR_SOCKET ??
+        join(process.env.PARASOR_CONFIG_DIR ?? join(homedir(), ".config", "parasor"), "parasor.sock");
+    const response = await sendRequest(socketPath, {
+        cmd: "qr",
+        args: { iface: iface ?? "" },
+    });
+    if (!response.ok) {
+        console.error(`parasor qr failed: ${response.error ?? "unknown error"}`);
+        process.exit(1);
+    }
+    const lines = buildQrSection({
+        endpoints: response.endpoints,
+        port: response.port,
+        authMode: response.authMode,
+        token: response.token,
+        makeAccessUrl: response.authMode === "token" && response.tokenKind === "pairing"
+            ? (endpoint) => buildPairingUrl(endpoint.address, response.port, response.token)
+            : undefined,
+        iface: iface ?? response.iface,
+        clickable: process.stdout.isTTY === true,
+    });
+    for (const line of lines)
+        console.log(line);
+}
+function sendRequest(socketPath, request) {
+    return new Promise((resolve, reject) => {
+        const client = createConnection(socketPath, () => {
+            client.write(`${JSON.stringify(request)}\n`);
+        });
+        let data = "";
+        client.on("data", (chunk) => {
+            data += chunk;
+        });
+        client.on("end", () => {
+            try {
+                resolve(JSON.parse(data.trim()));
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+        client.on("error", (err) => {
+            if (err.code === "ENOENT" || err.code === "ECONNREFUSED") {
+                reject(new Error(`No parasor server reachable at ${socketPath}. Start it with \`parasor\` first.`));
+            }
+            else {
+                reject(err);
+            }
+        });
+        client.setTimeout(2000, () => {
+            client.destroy(new Error("timeout"));
+        });
+    });
+}
+//# sourceMappingURL=qr.js.map

package/server/cli/qr.js.map

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

package/server/cli/restart-confirm.d.ts

@@ -0,0 +1,33 @@
+import { type ProbeOptions, type ProbeResult } from "./probe-daemon-version.js";
+export interface ConfirmRestartDeps {
+    isTty: boolean;
+    log: (message: string) => void;
+    /** Reads one line from stdin. Resolves to null on EOF. */
+    readLine: () => Promise<string | null>;
+    probe: (opts: ProbeOptions) => Promise<ProbeResult>;
+    resolvePaths: () => {
+        socketPath: string;
+    };
+}
+export interface ConfirmRestartOptions {
+    autoYes: boolean;
+    /** Override for tests. */
+    deps?: Partial<ConfirmRestartDeps>;
+}
+export interface ConfirmRestartResult {
+    proceed: boolean;
+    /** Human-readable explanation, surfaced to the caller's log on abort. */
+    reason: string;
+}
+export declare function confirmRestartIfMismatch(options: ConfirmRestartOptions): Promise<ConfirmRestartResult>;
+/**
+ * Pull `--yes` / `-y` from an args array and return both the flag and the
+ * filtered remainder. Modeled on the existing `--all` filtering style in
+ * `cliService` so the help text stays consistent.
+ */
+export declare function extractAutoYesFlag(args: string[]): {
+    autoYes: boolean;
+    rest: string[];
+};
+export declare function readLineFromInput(input: NodeJS.ReadableStream): Promise<string | null>;
+//# sourceMappingURL=restart-confirm.d.ts.map

package/server/cli/restart-confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-confirm.d.ts","sourceRoot":"","sources":["../../src/cli/restart-confirm.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAEjB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,YAAY,EAAE,MAAM;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;CAChB;AAaD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA+D/B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAIA;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,cAAc,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB"}

package/server/cli/restart-confirm.js

@@ -0,0 +1,107 @@
+/*
+ * Restart confirmation -- gate restart commands behind a confirmation when the
+ * running daemon's PROTOCOL_VERSION is incompatible with this binary's.
+ *
+ * The mismatch path inside `pty/host.ts` SIGKILLs the daemon and every
+ * PTY child to recover. This module probes the daemon BEFORE we kick
+ * the supervisor, and prompts the user to acknowledge session loss.
+ *
+ * Non-interactive callers (launchd auto-respawn, scripted upgrades,
+ * CI) cannot answer prompts. They must opt in via `--yes`/`-y`,
+ * otherwise the restart aborts with a hint instead of hanging.
+ */
+import { createInterface } from "node:readline";
+import { resolveDaemonPaths } from "../pty/host-daemon/paths.js";
+import { probeDaemonProtocolVersion, } from "./probe-daemon-version.js";
+const DEFAULT_DEPS = {
+    isTty: Boolean(process.stdin.isTTY),
+    log: (msg) => process.stderr.write(`${msg}\n`),
+    readLine: () => readLineFromInput(process.stdin),
+    probe: (opts) => probeDaemonProtocolVersion(opts),
+    resolvePaths: () => {
+        const paths = resolveDaemonPaths();
+        return { socketPath: paths.socketPath };
+    },
+};
+export async function confirmRestartIfMismatch(options) {
+    const deps = { ...DEFAULT_DEPS, ...(options.deps ?? {}) };
+    const { socketPath } = deps.resolvePaths();
+    const probeResult = await deps.probe({ socketPath });
+    if (probeResult.status === "no-daemon") {
+        return { proceed: true, reason: "no daemon detected" };
+    }
+    if (probeResult.status === "compatible") {
+        return {
+            proceed: true,
+            reason: `daemon ${probeResult.daemonVersion} compatible with server ${probeResult.serverVersion}`,
+        };
+    }
+    if (probeResult.status === "unknown") {
+        /*
+         * Probe couldn't decide. Don't block the restart -- we may be
+         * running against a future daemon version with a different reply
+         * shape, or a transient IO error. Surface the reason so an
+         * operator can investigate, but defer to the existing in-server
+         * recovery path.
+         */
+        deps.log(`parasor: daemon version probe inconclusive (${probeResult.reason}); proceeding without confirmation.`);
+        return { proceed: true, reason: `probe unknown: ${probeResult.reason}` };
+    }
+    // probeResult.status === "mismatch"
+    const banner = `parasor: this binary speaks PTY host protocol ${probeResult.serverVersion}, ` +
+        `but the running daemon speaks ${probeResult.daemonVersion}. ` +
+        `Continuing will terminate the daemon and every active PTY session.`;
+    if (options.autoYes) {
+        deps.log(`${banner} (--yes supplied, proceeding)`);
+        return {
+            proceed: true,
+            reason: `mismatch acknowledged via --yes (server=${probeResult.serverVersion} daemon=${probeResult.daemonVersion})`,
+        };
+    }
+    if (!deps.isTty) {
+        deps.log(banner);
+        deps.log("parasor: stdin is not a TTY; pass --yes to acknowledge session loss in non-interactive contexts.");
+        return {
+            proceed: false,
+            reason: "non-interactive without --yes",
+        };
+    }
+    deps.log(banner);
+    deps.log("parasor: continue and lose all active sessions? [y/N] ");
+    const answer = (await deps.readLine())?.trim().toLowerCase() ?? "";
+    if (answer === "y" || answer === "yes") {
+        return {
+            proceed: true,
+            reason: `user confirmed mismatch (server=${probeResult.serverVersion} daemon=${probeResult.daemonVersion})`,
+        };
+    }
+    return { proceed: false, reason: "user declined" };
+}
+/**
+ * Pull `--yes` / `-y` from an args array and return both the flag and the
+ * filtered remainder. Modeled on the existing `--all` filtering style in
+ * `cliService` so the help text stays consistent.
+ */
+export function extractAutoYesFlag(args) {
+    const autoYes = args.includes("--yes") || args.includes("-y");
+    const rest = args.filter((a) => a !== "--yes" && a !== "-y");
+    return { autoYes, rest };
+}
+export function readLineFromInput(input) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const settle = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(value);
+        };
+        const rl = createInterface({ input });
+        rl.once("line", (line) => {
+            settle(line);
+            rl.close();
+        });
+        rl.once("close", () => settle(null));
+    });
+}
+//# sourceMappingURL=restart-confirm.js.map

package/server/cli/restart-confirm.js.map

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