parasor 0.1.0

package/server/cli/shim-open.js

@@ -0,0 +1,128 @@
+import { execFileSync } from "node:child_process";
+import { createConnection } from "node:net";
+// Flags that take a value argument (macOS `open` specific)
+const VALUE_FLAGS = new Set(["-a", "-b", "--args"]);
+function parseArgs(argv) {
+    let kind = "macos-open";
+    const flags = [];
+    const positionals = [];
+    let hasAppFlag = false;
+    let pastSeparator = false;
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg === "--") {
+            pastSeparator = true;
+            i++;
+            continue;
+        }
+        if (!pastSeparator) {
+            if (arg === "--kind" || arg.startsWith("--kind=")) {
+                kind = arg.includes("=") ? arg.split("=")[1] : argv[++i];
+                i++;
+                continue;
+            }
+        }
+        if (pastSeparator && arg.startsWith("-")) {
+            if (arg === "-a")
+                hasAppFlag = true;
+            flags.push(arg);
+            if (VALUE_FLAGS.has(arg) && i + 1 < argv.length) {
+                i++;
+                flags.push(argv[i]);
+            }
+        }
+        else if (pastSeparator) {
+            positionals.push(arg);
+        }
+        i++;
+    }
+    return { kind, flags, positionals, hasAppFlag };
+}
+function isHttpUrl(s) {
+    return /^https?:\/\//i.test(s);
+}
+function sendToSocket(url, projectId, socketPath) {
+    return new Promise((resolve) => {
+        const client = createConnection(socketPath, () => {
+            client.write(`${JSON.stringify({ cmd: "open", args: { url, projectId } })}\n`);
+        });
+        let data = "";
+        client.on("data", (chunk) => {
+            data += chunk;
+        });
+        client.on("end", () => {
+            try {
+                const resp = JSON.parse(data.trim());
+                resolve(resp.ok);
+            }
+            catch {
+                resolve(false);
+            }
+        });
+        client.on("error", () => resolve(false));
+        client.setTimeout(2000, () => {
+            client.destroy();
+            resolve(false);
+        });
+    });
+}
+function execReal(kind, originalArgv) {
+    const realPath = kind === "xdg-open"
+        ? process.env.PARASOR_REAL_XDG_OPEN
+        : process.env.PARASOR_REAL_OPEN;
+    if (!realPath) {
+        console.error(`parasor shim-open: real binary not found for ${kind}`);
+        process.exit(1);
+    }
+    try {
+        execFileSync(realPath, originalArgv, { stdio: "inherit" });
+        process.exit(0);
+    }
+    catch {
+        process.exit(1);
+    }
+}
+export async function shimOpen(argv) {
+    const parsed = parseArgs(argv);
+    // Extract original argv (everything after --)
+    const separatorIdx = argv.indexOf("--");
+    const originalArgv = separatorIdx >= 0 ? argv.slice(separatorIdx + 1) : [];
+    const urlCandidates = parsed.positionals.filter(isHttpUrl);
+    const nonUrlPositionals = parsed.positionals.filter((p) => !isHttpUrl(p));
+    // Rule 4: No URL candidates -> pass through
+    if (urlCandidates.length === 0) {
+        execReal(parsed.kind, originalArgv);
+    }
+    // Rule 5: Mixed URLs and non-URLs -> pass through
+    if (nonUrlPositionals.length > 0) {
+        execReal(parsed.kind, originalArgv);
+    }
+    // Rule 7: -a flag specified -> pass through (user wants specific app)
+    if (parsed.hasAppFlag) {
+        execReal(parsed.kind, originalArgv);
+    }
+    // Rule 6: All positionals are http(s) URLs, no -a -> intercept
+    const socketPath = process.env.PARASOR_SOCKET;
+    const projectId = process.env.PARASOR_PROJECT_ID ?? "";
+    if (!socketPath) {
+        // No socket available -- fall back
+        execReal(parsed.kind, originalArgv);
+    }
+    // Send each URL through the socket
+    let allOk = true;
+    for (const url of urlCandidates) {
+        const ok = await sendToSocket(url, projectId, socketPath);
+        if (!ok) {
+            allOk = false;
+            break;
+        }
+    }
+    if (!allOk) {
+        // Socket failed -- fall back to real binary
+        console.error("parasor: socket unavailable, falling back to system open");
+        execReal(parsed.kind, originalArgv);
+    }
+    process.exit(0);
+}
+//# sourceMappingURL=shim-open.js.map

package/server/cli/shim-open.js.map

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

package/server/cli/shutdown-deps.d.ts

@@ -0,0 +1,41 @@
+export declare const IPC_TIMEOUT_MS = 2000;
+export declare const PID_POLL_INTERVAL_MS = 250;
+export declare const PID_WAIT_MAX_MS = 5000;
+export declare const LOCK_RELEASE_POLL_INTERVAL_MS = 100;
+export declare const LOCK_RELEASE_MAX_MS = 5000;
+export interface SpawnResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+}
+export interface RuntimeJson {
+    pid?: number;
+}
+export interface ShutdownDeps {
+    platform: NodeJS.Platform | string;
+    configDir: string;
+    now: () => number;
+    sendIpc: (socketPath: string, req: unknown, timeoutMs: number) => Promise<unknown>;
+    readRuntimeJson: (path: string) => RuntimeJson | null;
+    killProcess: (pid: number, signal: NodeJS.Signals | 0) => boolean;
+    spawnSync: (cmd: string, args: string[]) => SpawnResult;
+    log: (msg: string) => void;
+    sleep: (ms: number) => Promise<void>;
+    fileExists: (path: string) => boolean;
+    isLaunchdManaged: () => boolean;
+    isSystemdManaged: () => boolean;
+}
+export declare function defaultConfigDir(): string;
+export declare function defaultSendIpc(socketPath: string, req: unknown, timeoutMs: number): Promise<unknown>;
+export declare function defaultReadRuntimeJson(path: string): RuntimeJson | null;
+export declare function defaultKillProcess(pid: number, signal: NodeJS.Signals | 0): boolean;
+export declare function defaultSpawnSync(cmd: string, args: string[]): SpawnResult;
+export declare function defaultSleep(ms: number): Promise<void>;
+export declare function defaultIsLaunchdManaged(spawnSync: ShutdownDeps["spawnSync"]): boolean;
+export declare function defaultIsSystemdManaged(spawnSync: ShutdownDeps["spawnSync"]): boolean;
+export declare function resolveShutdownDeps(partial?: Partial<ShutdownDeps>): ShutdownDeps;
+export declare function attemptGracefulShutdown(socketPath: string, deps: Pick<ShutdownDeps, "sendIpc">): Promise<boolean>;
+export declare function waitForPidExit(pid: number, deps: Pick<ShutdownDeps, "now" | "killProcess" | "sleep">): Promise<boolean>;
+export declare function waitForLockRelease(configDir: string, deps: Pick<ShutdownDeps, "now" | "fileExists" | "sleep">): Promise<boolean>;
+export declare function isServiceManagerActive(deps: Pick<ShutdownDeps, "platform" | "isLaunchdManaged" | "isSystemdManaged">): boolean;
+//# sourceMappingURL=shutdown-deps.d.ts.map

package/server/cli/shutdown-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-deps.d.ts","sourceRoot":"","sources":["../../src/cli/shutdown-deps.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,6BAA6B,MAAM,CAAC;AACjD,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,OAAO,EAAE,CACP,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IACtD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,OAAO,CAAC;IAClE,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,WAAW,CAAC;IACxD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,gBAAgB,EAAE,MAAM,OAAO,CAAC;CACjC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAOvE;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,GACzB,OAAO,CAST;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAOzE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtD;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,GACnC,OAAO,CAKT;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,GACnC,OAAO,CAGT;AAED,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAkBd;AAED,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,GAClC,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,aAAa,GAAG,OAAO,CAAC,GACxD,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,YAAY,GAAG,OAAO,CAAC,GACvD,OAAO,CAAC,OAAO,CAAC,CASlB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,CACR,YAAY,EACZ,UAAU,GAAG,kBAAkB,GAAG,kBAAkB,CACrD,GACA,OAAO,CAIT"}

package/server/cli/shutdown-deps.js

@@ -0,0 +1,158 @@
+import { spawnSync as realSpawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { createConnection } from "node:net";
+import { homedir, userInfo } from "node:os";
+import { join } from "node:path";
+/*
+ * Shared shutdown machinery for `parasor restart` and `parasor stop`.
+ * Both commands need the same primitives to gracefully terminate a running
+ * server: send the IPC `shutdown` request, fall back to SIGTERM via the
+ * runtime.json pid, and wait for the lockfile / pidfile to clear.
+ *
+ * Kept separate from restart.ts so stop.ts does not need to depend on
+ * respawn machinery (`spawnDetached`).
+ */
+export const IPC_TIMEOUT_MS = 2000;
+export const PID_POLL_INTERVAL_MS = 250;
+export const PID_WAIT_MAX_MS = 5000;
+export const LOCK_RELEASE_POLL_INTERVAL_MS = 100;
+export const LOCK_RELEASE_MAX_MS = 5000;
+export function defaultConfigDir() {
+    const fromEnv = process.env.PARASOR_CONFIG_DIR;
+    if (fromEnv && fromEnv.length > 0)
+        return fromEnv;
+    return join(homedir(), ".config", "parasor");
+}
+export function defaultSendIpc(socketPath, req, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const client = createConnection(socketPath, () => {
+            client.write(`${JSON.stringify(req)}\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) => reject(err));
+        client.setTimeout(timeoutMs, () => {
+            client.destroy(new Error("timeout"));
+        });
+    });
+}
+export function defaultReadRuntimeJson(path) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function defaultKillProcess(pid, signal) {
+    try {
+        process.kill(pid, signal);
+        return true;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "EPERM")
+            return true; // process exists; we just lack perms
+        return false;
+    }
+}
+export function defaultSpawnSync(cmd, args) {
+    const r = realSpawnSync(cmd, args, { encoding: "utf8" });
+    return {
+        status: r.status,
+        stdout: r.stdout ?? "",
+        stderr: r.stderr ?? "",
+    };
+}
+export function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function defaultIsLaunchdManaged(spawnSync) {
+    const uid = userInfo().uid;
+    const r = spawnSync("launchctl", ["print", `gui/${uid}/com.parasor`]);
+    if (r.status !== 0)
+        return false;
+    return /state = running/.test(r.stdout);
+}
+export function defaultIsSystemdManaged(spawnSync) {
+    const r = spawnSync("systemctl", ["--user", "is-active", "parasor.service"]);
+    return r.status === 0;
+}
+export function resolveShutdownDeps(partial) {
+    const spawnSyncFn = partial?.spawnSync ?? defaultSpawnSync;
+    return {
+        platform: partial?.platform ?? process.platform,
+        configDir: partial?.configDir ?? defaultConfigDir(),
+        now: partial?.now ?? Date.now,
+        sendIpc: partial?.sendIpc ?? defaultSendIpc,
+        readRuntimeJson: partial?.readRuntimeJson ?? defaultReadRuntimeJson,
+        killProcess: partial?.killProcess ?? defaultKillProcess,
+        spawnSync: spawnSyncFn,
+        log: partial?.log ?? ((m) => console.log(m)),
+        sleep: partial?.sleep ?? defaultSleep,
+        fileExists: partial?.fileExists ?? ((p) => existsSync(p)),
+        isLaunchdManaged: partial?.isLaunchdManaged ?? (() => defaultIsLaunchdManaged(spawnSyncFn)),
+        isSystemdManaged: partial?.isSystemdManaged ?? (() => defaultIsSystemdManaged(spawnSyncFn)),
+    };
+}
+export async function attemptGracefulShutdown(socketPath, deps) {
+    try {
+        const res = await deps.sendIpc(socketPath, { cmd: "shutdown", args: {} }, IPC_TIMEOUT_MS);
+        // Mixed-version guard: an older server without the `shutdown` handler
+        // replies `{ok:false, error:"unknown-command"}`. Require ok===true so the
+        // caller falls back to SIGTERM instead of returning early from a no-op ack.
+        if (!res ||
+            typeof res !== "object" ||
+            res.ok !== true) {
+            return false;
+        }
+        return true;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ECONNREFUSED" || code === "ENOENT")
+            return false;
+        if (err.message === "timeout")
+            return false;
+        return false;
+    }
+}
+export async function waitForPidExit(pid, deps) {
+    const start = deps.now();
+    while (deps.now() - start < PID_WAIT_MAX_MS) {
+        if (!deps.killProcess(pid, 0))
+            return true;
+        await deps.sleep(PID_POLL_INTERVAL_MS);
+    }
+    return !deps.killProcess(pid, 0);
+}
+export async function waitForLockRelease(configDir, deps) {
+    const socketPath = join(configDir, "parasor.sock");
+    const lockPath = join(configDir, "parasor.lock.lock");
+    const start = deps.now();
+    while (deps.now() - start < LOCK_RELEASE_MAX_MS) {
+        if (!deps.fileExists(socketPath) && !deps.fileExists(lockPath))
+            return true;
+        await deps.sleep(LOCK_RELEASE_POLL_INTERVAL_MS);
+    }
+    return !deps.fileExists(socketPath) && !deps.fileExists(lockPath);
+}
+export function isServiceManagerActive(deps) {
+    if (deps.platform === "darwin")
+        return deps.isLaunchdManaged();
+    if (deps.platform === "linux")
+        return deps.isSystemdManaged();
+    return false;
+}
+//# sourceMappingURL=shutdown-deps.js.map

package/server/cli/shutdown-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-deps.js","sourceRoot":"","sources":["../../src/cli/shutdown-deps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AACpC,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AA+BxC,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC/C,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAClD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,GAAY,EACZ,SAAiB;IAEjB,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,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QACH,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,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE;YAChC,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAgB,CAAC;QACrE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,MAA0B;IAE1B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC,CAAC,qCAAqC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,IAAc;IAC1D,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAAoC;IAEpC,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAAoC;IAEpC,MAAM,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7E,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAA+B;IAE/B,MAAM,WAAW,GAAG,OAAO,EAAE,SAAS,IAAI,gBAAgB,CAAC;IAC3D,OAAO;QACL,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,QAAQ;QAC/C,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE;QACnD,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG;QAC7B,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,cAAc;QAC3C,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,sBAAsB;QACnE,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,kBAAkB;QACvD,SAAS,EAAE,WAAW;QACtB,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5C,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,YAAY;QACrC,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACzD,gBAAgB,EACd,OAAO,EAAE,gBAAgB,IAAI,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC;QAC3E,gBAAgB,EACd,OAAO,EAAE,gBAAgB,IAAI,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC;KAC5E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAkB,EAClB,IAAmC;IAEnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAC5B,UAAU,EACV,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,EAC7B,cAAc,CACf,CAAC;QACF,sEAAsE;QACtE,0EAA0E;QAC1E,4EAA4E;QAC5E,IACE,CAAC,GAAG;YACJ,OAAO,GAAG,KAAK,QAAQ;YACtB,GAAwB,CAAC,EAAE,KAAK,IAAI,EACrC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC/D,IAAK,GAAa,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,IAAyD;IAEzD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,eAAe,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,IAAwD;IAExD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,mBAAmB,EAAE,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5E,MAAM,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAGC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC/D,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/server/cli/stop.d.ts

@@ -0,0 +1,11 @@
+import { type ShutdownDeps } from "./shutdown-deps.js";
+export interface StopDeps extends ShutdownDeps {
+    /**
+     * Stop the parasor-pty-host daemon. Default impl shells out to
+     * `cliPtyHost(["stop"])` so the SIGTERM + lockfile-release dance lives
+     * in one place. Tests stub this.
+     */
+    stopDaemon: () => Promise<number>;
+}
+export declare function cliStop(partial?: Partial<StopDeps>, args?: string[]): Promise<void>;
+//# sourceMappingURL=stop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/cli/stop.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,YAAY,EAGlB,MAAM,oBAAoB,CAAC;AAqB5B,MAAM,WAAW,QAAS,SAAQ,YAAY;IAC5C;;;;OAIG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACnC;AAiED,wBAAsB,OAAO,CAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC3B,IAAI,GAAE,MAAM,EAAO,GAClB,OAAO,CAAC,IAAI,CAAC,CAqEf"}

package/server/cli/stop.js

@@ -0,0 +1,123 @@
+import { userInfo } from "node:os";
+import { join } from "node:path";
+import { DAEMON_LABEL, SERVER_LABEL } from "./service-darwin.js";
+import { DAEMON_UNIT, SERVER_UNIT } from "./service-linux.js";
+import { attemptGracefulShutdown, isServiceManagerActive, LOCK_RELEASE_MAX_MS, resolveShutdownDeps, waitForLockRelease, waitForPidExit, } from "./shutdown-deps.js";
+async function defaultStopDaemon() {
+    const { cliPtyHost } = await import("./pty-host.js");
+    return cliPtyHost(["stop"]);
+}
+function resolveDeps(partial) {
+    const base = resolveShutdownDeps(partial);
+    return {
+        ...base,
+        stopDaemon: partial?.stopDaemon ?? defaultStopDaemon,
+    };
+}
+// Service-manager bootout/stop. Best-effort: targets BOTH server + daemon
+// units regardless of individual outcomes -- non-zero status is logged but
+// not treated as fatal because launchctl/systemctl return non-zero on
+// "not loaded" too. Caller always falls through to the manual path
+// afterwards as an idempotent backstop, so a partial success here does
+// NOT leave the other unit orphaned.
+function performServiceManagedStop(deps) {
+    if (deps.platform === "darwin") {
+        const uid = userInfo().uid;
+        for (const label of [SERVER_LABEL, DAEMON_LABEL]) {
+            const target = `gui/${uid}/${label}`;
+            const r = deps.spawnSync("launchctl", ["bootout", target]);
+            if (r.status === 0) {
+                deps.log(`launchd bootout ${target}.`);
+            }
+            else {
+                // bootout returns non-zero when the unit was not loaded -- that is
+                // a no-op success for our purposes. Log and continue.
+                deps.log(`launchctl bootout ${target} returned status ${r.status} (probably not loaded).`);
+            }
+        }
+        return;
+    }
+    if (deps.platform === "linux") {
+        for (const unit of [SERVER_UNIT, DAEMON_UNIT]) {
+            const r = deps.spawnSync("systemctl", ["--user", "stop", unit]);
+            if (r.status === 0) {
+                deps.log(`systemctl --user stop ${unit}.`);
+            }
+            else {
+                deps.log(`systemctl --user stop ${unit} returned status ${r.status} (probably not active).`);
+            }
+        }
+    }
+}
+const STOP_HELP = `Usage: parasor stop
+  Stop the running parasor server and its parasor-pty-host daemon.
+
+  Tries graceful IPC shutdown of the server first; falls back to SIGTERM
+  via the pid recorded in \`runtime.json\`. Then SIGTERMs the daemon via
+  \`parasor pty-host stop\`. Under launchd (macOS) or systemd (Linux),
+  delegates to the service manager's native bootout/stop so the
+  supervised units stop without auto-restart.
+
+  PTY sessions are terminated. Use \`parasor restart\` instead if you
+  need to keep sessions alive across a server restart.`;
+export async function cliStop(partial, args = []) {
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(STOP_HELP);
+        return;
+    }
+    const deps = resolveDeps(partial);
+    // Service-managed path. Service manager owns both the server unit and
+    // the daemon unit (see  / service install release path): `parasor service
+    // install` always provisions both. Best-effort bootout/stop both, then
+    // ALWAYS fall through to the manual path. The manual path is
+    // idempotent for already-stopped processes (logs "no live parasor
+    // server detected" / "parasor-pty-host is not running") and serves as
+    // a backstop against partial success in the service-managed branch.
+    if (isServiceManagerActive(deps)) {
+        performServiceManagedStop(deps);
+    }
+    const socketPath = join(deps.configDir, "parasor.sock");
+    const runtimeFile = join(deps.configDir, "runtime.json");
+    const graceful = await attemptGracefulShutdown(socketPath, deps);
+    if (graceful) {
+        deps.log("parasor shut down gracefully via IPC.");
+        const released = await waitForLockRelease(deps.configDir, deps);
+        if (!released) {
+            throw new Error(`parasor did not release its lockfile within ${LOCK_RELEASE_MAX_MS}ms after graceful shutdown. Remove \`${join(deps.configDir, "parasor.lock.lock")}\` manually and retry.`);
+        }
+    }
+    else {
+        const runtime = deps.readRuntimeJson(runtimeFile);
+        // Reject pid<=0 to avoid `kill(0, …)` (process group broadcast) and
+        // `kill(-1, …)` (all-user-processes broadcast) when runtime.json is
+        // attacker-influenced (e.g. via PARASOR_CONFIG_DIR override). Mirrors
+        // pty-host.ts:134 -- same project, same guard.
+        const rawPid = runtime?.pid;
+        const pid = typeof rawPid === "number" && Number.isFinite(rawPid) && rawPid > 0
+            ? rawPid
+            : null;
+        if (pid !== null && deps.killProcess(pid, 0)) {
+            deps.log(`parasor IPC unreachable; sending SIGTERM to pid ${pid}.`);
+            deps.killProcess(pid, "SIGTERM");
+            const exited = await waitForPidExit(pid, deps);
+            if (!exited) {
+                throw new Error(`pid ${pid} did not exit after SIGTERM within 5s. Escalate manually (kill -9) before retrying.`);
+            }
+            deps.log(`pid ${pid} exited.`);
+        }
+        else {
+            deps.log("no live parasor server detected; skipping server stop.");
+        }
+    }
+    // Daemon -- always attempt regardless of whether server stop succeeded.
+    // The daemon outlives the server by design, so it may still be running
+    // even when the server is down. cliPtyHost stop is idempotent.
+    const daemonRc = await deps.stopDaemon();
+    if (daemonRc !== 0) {
+        throw new Error("parasor-pty-host stop reported failure (likely a stale pidfile " +
+            "from a crashed daemon). Run `parasor pty-host doctor` for " +
+            "diagnostics, then `parasor pty-host stop --force` once the pid " +
+            "is confirmed to be the daemon.");
+    }
+}
+//# sourceMappingURL=stop.js.map

package/server/cli/stop.js.map

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

package/server/cli/unknown-command.d.ts

@@ -0,0 +1,8 @@
+export type UnknownCommandResult = {
+    kind: "pass";
+} | {
+    kind: "error";
+    message: string;
+};
+export declare function classifyTopLevelCommand(command: string | undefined): UnknownCommandResult;
+//# sourceMappingURL=unknown-command.d.ts.map

package/server/cli/unknown-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-command.d.ts","sourceRoot":"","sources":["../../src/cli/unknown-command.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,oBAAoB,CAWtB"}

package/server/cli/unknown-command.js

@@ -0,0 +1,14 @@
+const SERVICE_VERBS = new Set(["install", "uninstall", "status", "logs"]);
+export function classifyTopLevelCommand(command) {
+    if (!command || command.startsWith("-")) {
+        return { kind: "pass" };
+    }
+    const hint = SERVICE_VERBS.has(command)
+        ? ` Did you mean \`parasor service ${command}\`?`
+        : "";
+    return {
+        kind: "error",
+        message: `parasor: unknown command '${command}'.${hint} Run \`parasor --help\` for usage.`,
+    };
+}
+//# sourceMappingURL=unknown-command.js.map

package/server/cli/unknown-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-command.js","sourceRoot":"","sources":["../../src/cli/unknown-command.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAM1E,MAAM,UAAU,uBAAuB,CACrC,OAA2B;IAE3B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;QACrC,CAAC,CAAC,mCAAmC,OAAO,KAAK;QACjD,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,6BAA6B,OAAO,KAAK,IAAI,oCAAoC;KAC3F,CAAC;AACJ,CAAC"}

package/server/debug/agent-status-recorder.d.ts

@@ -0,0 +1,57 @@
+import type { AgentState } from "@parasor/shared";
+export interface AgentStatusDebugEvent {
+    seq: number;
+    timestamp: number;
+    type: "manual-tracker" | "hook-debug" | "hook-received" | "hook-mapped" | "detector-state" | "detector-skip" | "detector-feed";
+    sessionId?: string;
+    payload: Record<string, unknown>;
+}
+interface AgentStatusRecorderOptions {
+    maxEvents?: number;
+    now?: () => number;
+    /**
+     * Optional append-only JSONL sink. When set, every recorded event is
+     * also written to this path so a reproduction can be diagnosed after a
+     * server restart. Rotated when {@link maxFileBytes} is exceeded; only
+     * one prior rotation (`<path>.1`) is retained.
+     */
+    logPath?: string;
+    maxFileBytes?: number;
+    maxEventBytes?: number;
+}
+export declare class AgentStatusRecorder {
+    private readonly events;
+    private readonly maxEvents;
+    private readonly now;
+    private readonly logPath;
+    private readonly maxFileBytes;
+    private readonly maxEventBytes;
+    private seq;
+    private writeQueue;
+    private writing;
+    private writtenBytes;
+    constructor(options?: AgentStatusRecorderOptions);
+    record(type: AgentStatusDebugEvent["type"], payload: Record<string, unknown>, sessionId?: string): void;
+    recordState(state: AgentState): void;
+    list(): AgentStatusDebugEvent[];
+    /**
+     * Return events with `seq > since`. Cheap linear scan because the buffer
+     * is capped at {@link maxEvents}. Used by the debug HTTP endpoint so
+     * clients can poll without reshipping the whole history.
+     */
+    listSince(since: number): AgentStatusDebugEvent[];
+    clear(): void;
+    clearPersistedLog(): Promise<void>;
+    /**
+     * Flush queued JSONL writes. Returns a promise that resolves when the
+     * current drain completes. Best-effort: disk failures swallow silently.
+     */
+    flush(): Promise<void>;
+    private enqueueWrite;
+    private drain;
+    private rotate;
+    private boundEvent;
+    private stringifyEvent;
+}
+export {};
+//# sourceMappingURL=agent-status-recorder.d.ts.map

package/server/debug/agent-status-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-status-recorder.d.ts","sourceRoot":"","sources":["../../src/debug/agent-status-recorder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EACA,gBAAgB,GAChB,YAAY,GACZ,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,eAAe,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,UAAU,0BAA0B;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AASD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,GAAG,CAAK;IAEhB,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAK;gBAEb,OAAO,CAAC,EAAE,0BAA0B;IAgBhD,MAAM,CACJ,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAeP,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAapC,IAAI,IAAI,qBAAqB,EAAE;IAI/B;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAKjD,KAAK,IAAI,IAAI;IAIP,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,YAAY;YAQN,KAAK;YAsBL,MAAM;IAapB,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,cAAc;CAOvB"}