parasor 0.1.0

package/server/cli/open.js

@@ -0,0 +1,47 @@
+import { createConnection } from "node:net";
+export async function cliOpen(url) {
+    const socketPath = process.env.PARASOR_SOCKET;
+    if (!socketPath) {
+        console.error("PARASOR_SOCKET not set. Are you running inside a parasor session?");
+        process.exit(1);
+    }
+    const projectId = process.env.PARASOR_PROJECT_ID ?? "";
+    try {
+        const response = await sendRequest(socketPath, {
+            cmd: "open",
+            args: { url, projectId },
+        });
+        if (!response.ok) {
+            console.error(`Failed: ${response.error}`);
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(`Socket error: ${err}`);
+        process.exit(1);
+    }
+}
+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 (e) {
+                reject(e);
+            }
+        });
+        client.on("error", reject);
+        client.setTimeout(2000, () => {
+            client.destroy(new Error("timeout"));
+        });
+    });
+}
+//# sourceMappingURL=open.js.map

package/server/cli/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/cli/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CACX,mEAAmE,CACpE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE;YAC7C,GAAG,EAAE,MAAM;YACX,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;SACzB,CAAC,CAAC;QAEH,IAAI,CAAE,QAA4B,CAAC,EAAE,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,WAAY,QAA+B,CAAC,KAAK,EAAE,CAAC,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB,EAAE,OAAgB;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACpB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/server/cli/probe-daemon-version.d.ts

@@ -0,0 +1,46 @@
+import type { Socket } from "node:net";
+/**
+ * The intentionally-incompatible protocol version we send. Non-semver so
+ * `parseSemver()` returns null and `isCompatibleVersion()` always rejects,
+ * making the eviction-side branch unreachable on every plausible daemon.
+ */
+export declare const PROBE_VERSION = "probe";
+export type ProbeResult = 
+/** No daemon reachable on the socket -- restart is a no-op for sessions. */
+{
+    status: "no-daemon";
+}
+/** Daemon is alive and its version is compatible with the new server. */
+ | {
+    status: "compatible";
+    daemonVersion: string;
+    serverVersion: string;
+}
+/** Daemon is alive but its version is incompatible -- auto-restart will fire. */
+ | {
+    status: "mismatch";
+    daemonVersion: string;
+    serverVersion: string;
+}
+/** Connected but couldn't decide (timeout, malformed reply, IO error). */
+ | {
+    status: "unknown";
+    reason: string;
+};
+export interface ProbeOptions {
+    socketPath: string;
+    /** Override for tests. */
+    connectFn?: (socketPath: string) => Socket;
+    /** Override for tests. */
+    timeoutMs?: number;
+    /** Override for tests -- defaults to the build-time PROTOCOL_VERSION. */
+    serverVersion?: string;
+}
+/**
+ * Open the daemon socket, send a deliberately-incompatible HELLO, and
+ * read the resulting NACK to learn the daemon's PROTOCOL_VERSION. Closes
+ * the socket before returning. Never evicts a live server -- see module
+ * header for the reason.
+ */
+export declare function probeDaemonProtocolVersion(opts: ProbeOptions): Promise<ProbeResult>;
+//# sourceMappingURL=probe-daemon-version.d.ts.map

package/server/cli/probe-daemon-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-daemon-version.d.ts","sourceRoot":"","sources":["../../src/cli/probe-daemon-version.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAkBvC;;;;GAIG;AACH,eAAO,MAAM,aAAa,UAAU,CAAC;AAIrC,MAAM,MAAM,WAAW;AACrB,4EAA4E;AAC1E;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE;AACzB,yEAAyE;GACvE;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE;AACxE,iFAAiF;GAC/E;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE;AACtE,0EAA0E;GACxE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAsItB"}

package/server/cli/probe-daemon-version.js

@@ -0,0 +1,167 @@
+/*
+ * Restart confirmation -- pre-flight version probe for the running PTY host daemon.
+ *
+ * Background. `parasor service restart` (and `parasor restart` on a
+ * service-managed install) kicks the server unit. The new server boots,
+ * connects to the long-lived daemon, and `pty/host.ts` SIGKILLs the
+ * daemon -- terminating every active PTY -- when their PROTOCOL_VERSIONs
+ * disagree (host.ts:438-494, intentional per daemon protocol mismatch recovery). The user has no
+ * pre-event signal: their CLI returns immediately after `kickstart`.
+ *
+ * To prompt before the kill, we must learn the running daemon's version
+ * from the *CLI* side, before kickstart. The daemon does not persist its
+ * version on disk, so the only source of truth is the socket itself --
+ * but a normal HELLO would evict the live server (daemon.ts:280-282
+ * supersedes the previous current). We instead send an INTENTIONALLY
+ * incompatible HELLO ("probe", non-semver). The compat check at
+ * daemon.ts:269 rejects it before `currentServer` is touched, the daemon
+ * NACKs with `server probe not compatible with daemon X.Y.Z`, and we
+ * parse `X.Y.Z` from the message. Live server stays attached.
+ */
+import { connect } from "node:net";
+import { encodeFrame, FrameParser, FrameType, } from "../pty/host-protocol/frames.js";
+import { decodeJsonPayload, encodeJsonPayload, isCompatibleVersion, PROTOCOL_VERSION, parseVersionMismatch, } from "../pty/host-protocol/messages.js";
+/**
+ * The intentionally-incompatible protocol version we send. Non-semver so
+ * `parseSemver()` returns null and `isCompatibleVersion()` always rejects,
+ * making the eviction-side branch unreachable on every plausible daemon.
+ */
+export const PROBE_VERSION = "probe";
+const PROBE_TIMEOUT_MS = 2000;
+/**
+ * Open the daemon socket, send a deliberately-incompatible HELLO, and
+ * read the resulting NACK to learn the daemon's PROTOCOL_VERSION. Closes
+ * the socket before returning. Never evicts a live server -- see module
+ * header for the reason.
+ */
+export async function probeDaemonProtocolVersion(opts) {
+    const serverVersion = opts.serverVersion ?? PROTOCOL_VERSION;
+    const timeoutMs = opts.timeoutMs ?? PROBE_TIMEOUT_MS;
+    const connectFn = opts.connectFn ?? ((p) => connect(p));
+    return new Promise((resolve) => {
+        let settled = false;
+        const settle = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            try {
+                socket.destroy();
+            }
+            catch {
+                /* socket may already be in error state */
+            }
+            resolve(result);
+        };
+        let socket;
+        try {
+            socket = connectFn(opts.socketPath);
+        }
+        catch {
+            resolve({
+                status: "no-daemon",
+            });
+            return;
+        }
+        const timer = setTimeout(() => {
+            settle({
+                status: "unknown",
+                reason: `probe timed out after ${timeoutMs}ms`,
+            });
+        }, timeoutMs);
+        timer.unref();
+        const parser = new FrameParser();
+        socket.on("connect", () => {
+            const payload = {
+                protocolVersion: PROBE_VERSION,
+                serverPid: process.pid,
+            };
+            socket.write(encodeFrame({
+                type: FrameType.HELLO,
+                connectionId: 0,
+                generation: 0n,
+                requestId: 0,
+                payload: encodeJsonPayload(payload),
+            }));
+        });
+        socket.on("data", (chunk) => {
+            let frames;
+            try {
+                frames = parser.push(chunk);
+            }
+            catch (err) {
+                clearTimeout(timer);
+                settle({
+                    status: "unknown",
+                    reason: `frame decode error: ${err.message}`,
+                });
+                return;
+            }
+            for (const frame of frames) {
+                if (frame.type !== FrameType.NACK) {
+                    // HELLO_ACK should never arrive -- we sent an incompatible
+                    // version. If it does, the daemon's compat rule is broken;
+                    // err on the side of caution and treat as unknown.
+                    clearTimeout(timer);
+                    settle({
+                        status: "unknown",
+                        reason: `unexpected frame type 0x${frame.type.toString(16)}`,
+                    });
+                    return;
+                }
+                let nack;
+                try {
+                    nack = decodeJsonPayload(frame.payload);
+                }
+                catch (err) {
+                    clearTimeout(timer);
+                    settle({
+                        status: "unknown",
+                        reason: `nack decode error: ${err.message}`,
+                    });
+                    return;
+                }
+                if (nack.code !== "version-mismatch") {
+                    clearTimeout(timer);
+                    settle({
+                        status: "unknown",
+                        reason: `unexpected nack code: ${nack.code}`,
+                    });
+                    return;
+                }
+                const parsed = parseVersionMismatch(nack.message);
+                if (!parsed) {
+                    clearTimeout(timer);
+                    settle({
+                        status: "unknown",
+                        reason: `nack message did not match expected shape: ${nack.message}`,
+                    });
+                    return;
+                }
+                clearTimeout(timer);
+                const daemonVersion = parsed.daemon;
+                const isMismatch = !isCompatibleVersion(serverVersion, daemonVersion);
+                settle({
+                    status: isMismatch ? "mismatch" : "compatible",
+                    daemonVersion,
+                    serverVersion,
+                });
+                return;
+            }
+        });
+        socket.on("error", (err) => {
+            clearTimeout(timer);
+            if (err.code === "ECONNREFUSED" || err.code === "ENOENT") {
+                settle({ status: "no-daemon" });
+                return;
+            }
+            settle({ status: "unknown", reason: err.message });
+        });
+        socket.on("close", () => {
+            // Reaching here without a NACK frame means the daemon dropped the
+            // socket without an interpretable reply (e.g. crashed mid-handshake).
+            clearTimeout(timer);
+            settle({ status: "unknown", reason: "socket closed before NACK" });
+        });
+    });
+}
+//# sourceMappingURL=probe-daemon-version.js.map

package/server/cli/probe-daemon-version.js.map

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

package/server/cli/pty-host.d.ts

@@ -0,0 +1,36 @@
+import { type DaemonPaths } from "../pty/host-daemon/paths.js";
+interface SpawnDetachedResult {
+    pid?: number;
+}
+interface ProbeResult {
+    /**
+     * Connect attempt succeeded immediately. `start` polls this -- only
+     * a real handshake-able socket should end the spawn loop.
+     */
+    socketReady: boolean;
+    /**
+     * connect succeeded OR connect timed out
+     * (treated as "live but stalled", matching bootstrap.isSocketActive
+     * fail-closed semantics). `probeStatus` uses this so a stalled-but-
+     * bound daemon is classified `running`, preventing a double-spawn
+     * race against the bootstrap reconcile path.
+     */
+    socketAlive: boolean;
+}
+export interface PtyHostDeps {
+    paths: DaemonPaths;
+    appStateDir: string;
+    now: () => number;
+    killProcess: (pid: number, signal: NodeJS.Signals | 0) => boolean;
+    spawnDetached: (cmd: string, args: string[]) => SpawnDetachedResult;
+    probeSocket: (path: string) => Promise<ProbeResult>;
+    readPidFile: (path: string) => number | null;
+    readLog: (path: string, lines: number) => string;
+    sleep: (ms: number) => Promise<void>;
+    log: (msg: string) => void;
+    error: (msg: string) => void;
+    daemonEntryPath: string;
+}
+export declare function cliPtyHost(args: string[], partial?: Partial<PtyHostDeps>): Promise<number>;
+export {};
+//# sourceMappingURL=pty-host.d.ts.map

package/server/cli/pty-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-host.d.ts","sourceRoot":"","sources":["../../src/cli/pty-host.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,KAAK,WAAW,EAEjB,MAAM,6BAA6B,CAAC;AAGrC,UAAU,mBAAmB;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,WAAW;IACnB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,OAAO,CAAC;IAClE,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,mBAAmB,CAAC;IACpE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC7C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAkXD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,CA2BjB"}