p-spore 0.1.3 → 0.1.42

package/dist/service/legacy-daemon.js

@@ -0,0 +1,42 @@
+import { readFile } from "node:fs/promises";
+import { ProtocolClient } from "../protocol/client.js";
+import { psporePaths } from "../storage/home.js";
+/**
+ * One-time migration helper: an old GUI-owned daemon cannot be adopted by
+ * systemd, so ask it to exit cleanly before the new service starts.
+ */
+export async function stopLegacyDaemon(home) {
+    const paths = psporePaths(home);
+    let socket = paths.socket;
+    try {
+        const endpoint = JSON.parse(await readFile(paths.endpoint, "utf8"));
+        if (typeof endpoint.socket === "string" && endpoint.socket)
+            socket = endpoint.socket;
+    }
+    catch {
+        return;
+    }
+    const client = new ProtocolClient({ socketPath: socket, clientId: `service-migration-${process.pid}` });
+    try {
+        await client.connect();
+        await client.command("daemon.shutdown", {});
+    }
+    catch {
+        return;
+    }
+    finally {
+        await client.close().catch(() => undefined);
+    }
+    const deadline = Date.now() + 5_000;
+    while (Date.now() < deadline) {
+        try {
+            await readFile(paths.endpoint, "utf8");
+        }
+        catch {
+            return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    throw new Error("The legacy daemon did not stop within 5 seconds; stop it manually and retry service installation");
+}
+//# sourceMappingURL=legacy-daemon.js.map

package/dist/service/legacy-daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-daemon.js","sourceRoot":"","sources":["../../src/service/legacy-daemon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAyB,CAAC;QAC5F,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM;YAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxG,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAC;AACtH,CAAC"}

package/dist/service/service-launch.d.ts

@@ -0,0 +1,10 @@
+import type { SystemServiceLaunchSpec } from "./system-service.js";
+export interface ServiceRuntimeIdentity {
+    execPath: string;
+    argvEntry?: string;
+    moduleUrl: string;
+    electron?: boolean;
+}
+/** Build a stable service command for npm, source builds, SEA, or Electron packages. */
+export declare function serviceLaunchSpec(home: string, workspace: string, identity: ServiceRuntimeIdentity): Promise<SystemServiceLaunchSpec>;
+//# sourceMappingURL=service-launch.d.ts.map

package/dist/service/service-launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-launch.d.ts","sourceRoot":"","sources":["../../src/service/service-launch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wFAAwF;AACxF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,sBAAsB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CA2BlC"}

package/dist/service/service-launch.js

@@ -0,0 +1,56 @@
+import { access } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+/** Build a stable service command for npm, source builds, SEA, or Electron packages. */
+export async function serviceLaunchSpec(home, workspace, identity) {
+    const executable = resolve(identity.execPath);
+    if (identity.electron) {
+        const cliEntry = fileURLToPath(new URL("../cli/main.js", identity.moduleUrl));
+        await requireReadableEntry(cliEntry);
+        return {
+            executable,
+            args: [cliEntry, "--home", resolve(home), "daemon"],
+            workingDirectory: resolve(workspace),
+            environment: { ELECTRON_RUN_AS_NODE: "1" },
+        };
+    }
+    if (isSingleExecutableRuntime(identity.argvEntry, executable, identity.moduleUrl)) {
+        return {
+            executable,
+            args: ["--home", resolve(home), "daemon"],
+            workingDirectory: resolve(workspace),
+        };
+    }
+    const cliEntry = await compiledCliEntry(identity.moduleUrl);
+    return {
+        executable,
+        args: [cliEntry, "--home", resolve(home), "daemon"],
+        workingDirectory: resolve(workspace),
+    };
+}
+async function compiledCliEntry(moduleUrl) {
+    const current = fileURLToPath(moduleUrl);
+    if (current.endsWith(".js")) {
+        await requireReadableEntry(current);
+        return current;
+    }
+    const built = resolve(dirname(current), "../../dist/cli/main.js");
+    await requireReadableEntry(built);
+    return built;
+}
+async function requireReadableEntry(path) {
+    try {
+        await access(path);
+    }
+    catch {
+        throw new Error(`The system service entry is not built at ${path}; run \`npm run build\` first`);
+    }
+}
+function isSingleExecutableRuntime(argvEntry, executable, moduleUrl) {
+    if (fileURLToPath(moduleUrl) === executable)
+        return true;
+    if (!argvEntry)
+        return false;
+    return resolve(argvEntry) === executable;
+}
+//# sourceMappingURL=service-launch.js.map

package/dist/service/service-launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-launch.js","sourceRoot":"","sources":["../../src/service/service-launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAWzC,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,SAAiB,EACjB,QAAgC;IAEhC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9E,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO;YACL,UAAU;YACV,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;YACnD,gBAAgB,EAAE,OAAO,CAAC,SAAS,CAAC;YACpC,WAAW,EAAE,EAAE,oBAAoB,EAAE,GAAG,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,IAAI,yBAAyB,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAClF,OAAO;YACL,UAAU;YACV,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;YACzC,gBAAgB,EAAE,OAAO,CAAC,SAAS,CAAC;SACrC,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5D,OAAO;QACL,UAAU;QACV,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;QACnD,gBAAgB,EAAE,OAAO,CAAC,SAAS,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAClE,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAY;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,+BAA+B,CAAC,CAAC;IACnG,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,SAA6B,EAAE,UAAkB,EAAE,SAAiB;IACrG,IAAI,aAAa,CAAC,SAAS,CAAC,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,UAAU,CAAC;AAC3C,CAAC"}

package/dist/service/system-service.d.ts

@@ -0,0 +1,57 @@
+export interface SystemServiceLaunchSpec {
+    executable: string;
+    args: readonly string[];
+    workingDirectory: string;
+    environment?: Readonly<Record<string, string>>;
+}
+export interface SystemServiceCommandResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export type SystemServiceCommandRunner = (executable: string, args: readonly string[]) => Promise<SystemServiceCommandResult>;
+export interface SystemServiceStatus {
+    unitName: string;
+    unitPath: string;
+    installed: boolean;
+    enabled: boolean;
+    active: boolean;
+    linger: boolean | undefined;
+    detail?: string;
+}
+export interface SystemServiceEnsureResult extends SystemServiceStatus {
+    unitChanged: boolean;
+    lingerWarning?: string;
+    /** Set when a previously failed unit had to be reset before it could start. */
+    recoveredFromFailure?: boolean;
+}
+export interface SystemServiceManagerOptions {
+    home: string;
+    userConfigDirectory?: string;
+    username?: string;
+    runner?: SystemServiceCommandRunner;
+    beforeStart?: () => Promise<void>;
+}
+/**
+ * Installs and controls the per-user systemd service used by production clients.
+ * GUI/TUI callers never own the daemon process; their only lifecycle action is
+ * asking systemd to keep the authoritative service enabled and running.
+ */
+export declare class SystemServiceManager {
+    #private;
+    readonly unitName: string;
+    readonly unitPath: string;
+    constructor(options: SystemServiceManagerOptions);
+    ensureRunning(spec: SystemServiceLaunchSpec): Promise<SystemServiceEnsureResult>;
+    install(spec: SystemServiceLaunchSpec): Promise<boolean>;
+    restart(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    uninstall(): Promise<void>;
+    status(): Promise<SystemServiceStatus>;
+    logs(lines?: number): Promise<string>;
+}
+export declare function renderSystemdUserUnit(home: string, spec: SystemServiceLaunchSpec): string;
+export declare function serviceUnitName(home: string, defaultHome?: string): string;
+export declare function systemdQuote(value: string): string;
+//# sourceMappingURL=system-service.d.ts.map

package/dist/service/system-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-service.d.ts","sourceRoot":"","sources":["../../src/service/system-service.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,0BAA0B,GAAG,CACvC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,MAAM,EAAE,KACpB,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;;IAK/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,2BAA2B;IAW1C,aAAa,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAiChF,OAAO,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAcxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ1B,MAAM,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAoBtC,IAAI,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA+CzC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAiCzF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,SAA6B,GAAG,MAAM,CAK9F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD"}

package/dist/service/system-service.js

@@ -0,0 +1,263 @@
+import { createHash } from "node:crypto";
+import { execFile } from "node:child_process";
+import { access, mkdir, readFile, unlink } from "node:fs/promises";
+import { homedir, userInfo } from "node:os";
+import { dirname, join, normalize, resolve } from "node:path";
+import { promisify } from "node:util";
+import { atomicWriteFile } from "../storage/atomic.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Installs and controls the per-user systemd service used by production clients.
+ * GUI/TUI callers never own the daemon process; their only lifecycle action is
+ * asking systemd to keep the authoritative service enabled and running.
+ */
+export class SystemServiceManager {
+    #home;
+    #runner;
+    #username;
+    #beforeStart;
+    unitName;
+    unitPath;
+    constructor(options) {
+        this.#home = resolve(options.home);
+        this.#runner = options.runner ?? runSystemCommand;
+        this.#username = options.username ?? userInfo().username;
+        this.#beforeStart = options.beforeStart;
+        this.unitName = serviceUnitName(this.#home);
+        const configDirectory = options.userConfigDirectory
+            ?? resolve(process.env["XDG_CONFIG_HOME"] || join(homedir(), ".config"));
+        this.unitPath = join(configDirectory, "systemd", "user", this.unitName);
+    }
+    async ensureRunning(spec) {
+        const unitChanged = await this.install(spec);
+        if (unitChanged)
+            await this.#systemctl("daemon-reload");
+        const wasActive = await this.#isSystemctlState("is-active");
+        const recoveredFromFailure = wasActive ? false : await this.#resetFailedUnit();
+        if (!wasActive)
+            await this.#beforeStart?.();
+        if (unitChanged && wasActive) {
+            await this.#systemctl("restart", this.unitName);
+        }
+        else {
+            await this.#systemctl("enable", "--now", this.unitName);
+        }
+        let lingerWarning;
+        let linger = await this.#lingerEnabled();
+        if (linger === false) {
+            const result = await this.#runner("loginctl", ["--no-ask-password", "enable-linger", this.#username]);
+            if (result.code === 0)
+                linger = await this.#lingerEnabled();
+            else
+                lingerWarning = commandFailure("Could not enable boot-time user lingering", result);
+        }
+        const status = await this.status();
+        if (!status.active) {
+            throw new Error(status.detail ?? `System service ${this.unitName} did not become active`);
+        }
+        return {
+            ...status,
+            unitChanged,
+            ...(recoveredFromFailure ? { recoveredFromFailure } : {}),
+            ...(lingerWarning === undefined ? {} : { lingerWarning }),
+        };
+    }
+    async install(spec) {
+        const content = renderSystemdUserUnit(this.#home, spec);
+        let current;
+        try {
+            current = await readFile(this.unitPath, "utf8");
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== "ENOENT")
+                throw error;
+        }
+        if (current === content)
+            return false;
+        await mkdir(dirname(this.unitPath), { recursive: true, mode: 0o700 });
+        await atomicWriteFile(this.unitPath, content, 0o644);
+        return true;
+    }
+    async restart() {
+        await this.#resetFailedUnit();
+        await this.#systemctl("restart", this.unitName);
+    }
+    async start() {
+        await this.#resetFailedUnit();
+        await this.#systemctl("enable", "--now", this.unitName);
+    }
+    async stop() {
+        await this.#systemctl("stop", this.unitName);
+    }
+    async uninstall() {
+        await this.#runner("systemctl", ["--user", "disable", "--now", this.unitName]);
+        await unlink(this.unitPath).catch((error) => {
+            if (!isNodeError(error) || error.code !== "ENOENT")
+                throw error;
+        });
+        await this.#systemctl("daemon-reload");
+    }
+    async status() {
+        const installed = await access(this.unitPath).then(() => true, () => false);
+        const enabledResult = await this.#runner("systemctl", ["--user", "is-enabled", this.unitName]);
+        const activeResult = await this.#runner("systemctl", ["--user", "is-active", this.unitName]);
+        const enabled = enabledResult.code === 0 && enabledResult.stdout.trim() === "enabled";
+        const active = activeResult.code === 0 && activeResult.stdout.trim() === "active";
+        const detail = active
+            ? undefined
+            : [activeResult.stderr.trim(), activeResult.stdout.trim()].filter(Boolean).join(": ") || undefined;
+        return {
+            unitName: this.unitName,
+            unitPath: this.unitPath,
+            installed,
+            enabled,
+            active,
+            linger: await this.#lingerEnabled(),
+            ...(detail === undefined ? {} : { detail }),
+        };
+    }
+    async logs(lines = 100) {
+        if (!Number.isSafeInteger(lines) || lines < 1 || lines > 2_000) {
+            throw new Error("Service log line count must be between 1 and 2000");
+        }
+        const result = await this.#runner("journalctl", [
+            "--user-unit",
+            this.unitName,
+            "--lines",
+            String(lines),
+            "--no-pager",
+            "--output",
+            "short-iso",
+        ]);
+        if (result.code !== 0)
+            throw new Error(commandFailure("Could not read service logs", result));
+        return result.stdout;
+    }
+    async #systemctl(...args) {
+        const result = await this.#runner("systemctl", ["--user", ...args]);
+        if (result.code !== 0)
+            throw new Error(commandFailure(`systemctl --user ${args.join(" ")} failed`, result));
+    }
+    /**
+     * A daemon that crashes repeatedly trips `StartLimitBurst`, and systemd then
+     * refuses every further start with "start request repeated too quickly". The
+     * unit stays failed across client restarts, so clients report a permanently
+     * lost connection until the failure is cleared. Clearing it is safe: it only
+     * resets systemd's bookkeeping, never a running service.
+     */
+    async #resetFailedUnit() {
+        const result = await this.#runner("systemctl", ["--user", "is-failed", this.unitName]);
+        if (result.stdout.trim() !== "failed")
+            return false;
+        await this.#runner("systemctl", ["--user", "reset-failed", this.unitName]);
+        return true;
+    }
+    async #isSystemctlState(command) {
+        const result = await this.#runner("systemctl", ["--user", command, this.unitName]);
+        return result.code === 0 && result.stdout.trim() === (command === "is-active" ? "active" : "enabled");
+    }
+    async #lingerEnabled() {
+        const result = await this.#runner("loginctl", ["show-user", this.#username, "--property", "Linger", "--value"]);
+        if (result.code !== 0)
+            return undefined;
+        const value = result.stdout.trim().toLowerCase();
+        return value === "yes" ? true : value === "no" ? false : undefined;
+    }
+}
+export function renderSystemdUserUnit(home, spec) {
+    const executable = resolveExecutable(spec.executable);
+    const workingDirectory = resolve(spec.workingDirectory);
+    const command = [executable, ...spec.args].map(systemdQuote).join(" ");
+    const environment = Object.entries(spec.environment ?? {})
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, value]) => {
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
+            throw new Error(`Invalid service environment name: ${key}`);
+        return `Environment=${systemdQuote(`${key}=${value}`)}`;
+    });
+    return [
+        "[Unit]",
+        "Description=pSpore local agent service",
+        "Documentation=https://github.com/advnljs/pSpore",
+        "StartLimitIntervalSec=30",
+        "StartLimitBurst=5",
+        "",
+        "[Service]",
+        "Type=simple",
+        `ExecStart=${command}`,
+        `WorkingDirectory=${systemdPath(workingDirectory)}`,
+        `Environment=${systemdQuote(`PSPORE_HOME=${resolve(home)}`)}`,
+        ...environment,
+        "UMask=0077",
+        "Restart=always",
+        "RestartSec=2",
+        "TimeoutStopSec=20",
+        "KillMode=mixed",
+        "",
+        "[Install]",
+        "WantedBy=default.target",
+        "",
+    ].join("\n");
+}
+export function serviceUnitName(home, defaultHome = join(homedir(), ".pspore")) {
+    const normalizedHome = normalize(resolve(home));
+    if (normalizedHome === normalize(resolve(defaultHome)))
+        return "pspore.service";
+    const suffix = createHash("sha256").update(normalizedHome).digest("hex").slice(0, 12);
+    return `pspore-${suffix}.service`;
+}
+export function systemdQuote(value) {
+    if (/[\r\n\u0000]/u.test(value))
+        throw new Error("System service arguments cannot contain newlines or NUL");
+    if (/[\u0001-\u0008\u000b\u000c\u000e-\u001f\u007f]/u.test(value)) {
+        throw new Error("System service arguments cannot contain control characters");
+    }
+    return `"${value.replaceAll("%", "%%").replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+}
+/**
+ * Path-valued directives do not use ExecStart's command-line quoting rules.
+ * In particular, systemd 245 treats surrounding quotes as literal path bytes,
+ * so an otherwise absolute WorkingDirectory becomes invalid. Spaces are valid
+ * unquoted in this directive; percent signs still need escaping as specifiers.
+ */
+function systemdPath(value) {
+    if (/\s$/u.test(value))
+        throw new Error("System service paths cannot end with whitespace");
+    if (/[\r\n\u0000]/u.test(value))
+        throw new Error("System service paths cannot contain newlines or NUL");
+    if (/[\u0001-\u0008\u000b\u000c\u000e-\u001f\u007f]/u.test(value)) {
+        throw new Error("System service paths cannot contain control characters");
+    }
+    return value.replaceAll("%", "%%");
+}
+async function runSystemCommand(executable, args) {
+    try {
+        const result = await execFileAsync(executable, [...args], {
+            encoding: "utf8",
+            timeout: 20_000,
+            maxBuffer: 1_048_576,
+        });
+        return { code: 0, stdout: result.stdout, stderr: result.stderr };
+    }
+    catch (error) {
+        const candidate = error;
+        return {
+            code: typeof candidate.code === "number" ? candidate.code : 1,
+            stdout: typeof candidate.stdout === "string" ? candidate.stdout : "",
+            stderr: typeof candidate.stderr === "string" ? candidate.stderr : candidate.message,
+        };
+    }
+}
+function resolveExecutable(value) {
+    if (!value.trim())
+        throw new Error("System service executable is required");
+    return value.includes("/") ? resolve(value) : value;
+}
+function commandFailure(prefix, result) {
+    const detail = result.stderr.trim() || result.stdout.trim() || `exit ${result.code}`;
+    return `${prefix}: ${detail}`;
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=system-service.js.map

package/dist/service/system-service.js.map

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

package/dist/sessions/session-catalog.d.ts

@@ -0,0 +1,45 @@
+import type { RootSessionMetadata } from "../domain/runtime.js";
+export interface RootSessionRecord extends RootSessionMetadata {
+    id: string;
+    sessionFile: string;
+    cwd: string;
+    titleSource: "default" | "user" | "prompt";
+}
+export interface SessionCatalogOptions {
+    path: string;
+    sessionsRoot: string;
+    workspaceId: string;
+    cwd: string;
+    clock?: () => Date;
+}
+export declare class SessionCatalog {
+    #private;
+    private constructor();
+    static open(options: SessionCatalogOptions): Promise<SessionCatalog>;
+    list(): RootSessionRecord[];
+    get(id: string): RootSessionRecord | undefined;
+    idle(): Promise<void>;
+    add(input: {
+        id: string;
+        sessionFile: string;
+        cwd: string;
+        title?: string;
+    }): Promise<RootSessionRecord>;
+    /**
+     * Forgets a root session and deletes the transcript it owns.
+     *
+     * The stored path is re-resolved against the sessions root before anything is
+     * unlinked, so a catalog entry that points outside the root loses its record
+     * without the filesystem being touched. Deleting is the point of the command,
+     * so a transcript that is already gone is not an error.
+     */
+    remove(id: string): Promise<{
+        record: RootSessionRecord;
+        transcriptRemoved: boolean;
+    } | undefined>;
+    touch(id: string, options?: {
+        prompt?: string;
+        sessionFile?: string;
+    }): Promise<RootSessionRecord | undefined>;
+}
+//# sourceMappingURL=session-catalog.d.ts.map

package/dist/sessions/session-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-catalog.d.ts","sourceRoot":"","sources":["../../src/sessions/session-catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIhE,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC5C;AAOD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,qBAAa,cAAc;;IASzB,OAAO;WAQM,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAM1E,IAAI,IAAI,iBAAiB,EAAE;IAM3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAKxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,GAAG,CAAC,KAAK,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsB9B;;;;;;;OAOG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,iBAAiB,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAmBlG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;CAiGzH"}