@stigmer/cli 3.0.8

package/local/state/log-rotation.js

@@ -0,0 +1,101 @@
+// Log rotation, run once at the start of every `up`.
+//
+// Each non-empty component log is renamed with a timestamp suffix so a fresh
+// run starts clean while the previous run's output is preserved for diagnosis.
+// Archived logs older than the retention window are then pruned. This mirrors
+// the Go CLI's `rotateLogsIfNeeded` + `cleanupOldLogs`.
+import { mkdirSync, readdirSync, renameSync, rmSync, statSync } from "node:fs";
+import { join } from "node:path";
+/** Component log files eligible for rotation. */
+const ROTATABLE_LOGS = [
+    "daemon.log",
+    "stigmer-server.log",
+    "stigmer-server.err",
+    "runner.log",
+    "runner.err",
+    "temporal.log",
+    "llm.log",
+];
+/** Default retention for archived logs, in days. */
+export const DEFAULT_LOG_RETENTION_DAYS = 7;
+/**
+ * Rotate non-empty component logs in `logDir`, returning the number rotated.
+ * Creates the directory if needed and prunes archives past the retention
+ * window. A clock can be injected for deterministic tests.
+ */
+export function rotateLogs(logDir, options = {}) {
+    const now = options.now ?? new Date();
+    mkdirSync(logDir, { recursive: true });
+    const suffix = timestampSuffix(now);
+    let rotated = 0;
+    for (const name of ROTATABLE_LOGS) {
+        const oldPath = join(logDir, name);
+        let size;
+        try {
+            size = statSync(oldPath).size;
+        }
+        catch {
+            continue; // missing log — nothing to rotate
+        }
+        if (size === 0)
+            continue; // empty log — leave it in place
+        try {
+            renameSync(oldPath, `${oldPath}.${suffix}`);
+            rotated += 1;
+        }
+        catch {
+            // A rotation failure must not block startup; leave the log and move on.
+        }
+    }
+    cleanupOldLogs(logDir, options.retentionDays ?? DEFAULT_LOG_RETENTION_DAYS, now);
+    return rotated;
+}
+/**
+ * Delete archived logs (`*.log.*` / `*.err.*`) older than `keepDays`, returning
+ * the count removed.
+ */
+export function cleanupOldLogs(logDir, keepDays = DEFAULT_LOG_RETENTION_DAYS, now = new Date()) {
+    const cutoff = now.getTime() - keepDays * 24 * 60 * 60 * 1000;
+    let entries;
+    try {
+        entries = readdirSync(logDir);
+    }
+    catch {
+        return 0;
+    }
+    let deleted = 0;
+    for (const entry of entries) {
+        if (!isArchivedLog(entry))
+            continue;
+        const path = join(logDir, entry);
+        let mtimeMs;
+        try {
+            mtimeMs = statSync(path).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        if (mtimeMs >= cutoff)
+            continue;
+        try {
+            rmSync(path, { force: true });
+            deleted += 1;
+        }
+        catch {
+            // Best-effort cleanup; a stuck file does not fail startup.
+        }
+    }
+    return deleted;
+}
+// Archived logs are the rotated copies: a base ending in `.log` or `.err`
+// followed by a timestamp suffix (e.g. `runner.log.2026-06-13-141502`).
+function isArchivedLog(name) {
+    return /\.(log|err)\..+$/.test(name);
+}
+// Matches the Go layout "2006-01-02-150405" (local time): YYYY-MM-DD-HHmmss.
+function timestampSuffix(date) {
+    const p = (n, width = 2) => String(n).padStart(width, "0");
+    return (`${date.getFullYear()}-${p(date.getMonth() + 1)}-${p(date.getDate())}-` +
+        `${p(date.getHours())}${p(date.getMinutes())}${p(date.getSeconds())}`);
+}
+//# sourceMappingURL=log-rotation.js.map

package/local/state/log-rotation.js.map

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

package/local/state/pidfile.d.ts

@@ -0,0 +1,11 @@
+/** Write a PID file (creating its directory if needed). */
+export declare function writePidFile(path: string, pid: number): void;
+/**
+ * Read a PID from a PID file. Returns null if the file is missing or its first
+ * line is not a positive integer, so callers branch on presence rather than
+ * catching exceptions.
+ */
+export declare function readPidFile(path: string): number | null;
+/** Remove a PID file. Best-effort: a missing file is not an error. */
+export declare function removePidFile(path: string): void;
+//# sourceMappingURL=pidfile.d.ts.map

package/local/state/pidfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pidfile.d.ts","sourceRoot":"","sources":["../../../src/local/state/pidfile.ts"],"names":[],"mappings":"AAUA,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUvD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhD"}

package/local/state/pidfile.js

@@ -0,0 +1,35 @@
+// PID-file read/write/remove helpers.
+//
+// PID files are how the daemon, its children, and a fresh CLI invocation find
+// each other across process boundaries. Some PID files written by other tools
+// (notably Temporal's) carry extra lines after the PID; readPidFile reads only
+// the first line so it tolerates both single-line and multi-line formats.
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+/** Write a PID file (creating its directory if needed). */
+export function writePidFile(path, pid) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${pid}\n`, "utf8");
+}
+/**
+ * Read a PID from a PID file. Returns null if the file is missing or its first
+ * line is not a positive integer, so callers branch on presence rather than
+ * catching exceptions.
+ */
+export function readPidFile(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const firstLine = raw.split("\n", 1)[0]?.trim() ?? "";
+    const pid = Number.parseInt(firstLine, 10);
+    return Number.isInteger(pid) && pid > 0 ? pid : null;
+}
+/** Remove a PID file. Best-effort: a missing file is not an error. */
+export function removePidFile(path) {
+    rmSync(path, { force: true });
+}
+//# sourceMappingURL=pidfile.js.map

package/local/state/pidfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pidfile.js","sourceRoot":"","sources":["../../../src/local/state/pidfile.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,0EAA0E;AAE1E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,GAAW;IACpD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACtD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/local/state/proc.d.ts

@@ -0,0 +1,16 @@
+/** Report whether a process with the given PID currently exists. */
+export declare function isProcessAlive(pid: number): boolean;
+/** Send a signal to a single process. Returns false if the process is gone. */
+export declare function killProcess(pid: number, signal?: NodeJS.Signals): boolean;
+/**
+ * Signal an entire process group (POSIX: kill(-pid)). The target must have been
+ * spawned as a group leader (`detached: true`) for this to reach its children.
+ * Returns false if the group is already gone.
+ */
+export declare function killProcessGroup(pid: number, signal?: NodeJS.Signals): boolean;
+/**
+ * Find the PID of the process listening on a TCP port via `lsof`. Returns null
+ * if nothing is listening or `lsof` is unavailable. POSIX-only fallback.
+ */
+export declare function findProcessByPort(port: number): number | null;
+//# sourceMappingURL=proc.d.ts.map

package/local/state/proc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proc.d.ts","sourceRoot":"","sources":["../../../src/local/state/proc.ts"],"names":[],"mappings":"AASA,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO,CAOpF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO,CASzF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc7D"}

package/local/state/proc.js

@@ -0,0 +1,69 @@
+// OS-level process queries used by supervision and status.
+//
+// Liveness is a signal-0 probe (no signal delivered, only permission/existence
+// checked) — the same mechanism the Go CLI uses. The port-based lookup is a
+// fallback for locating the daemon when its PID file is missing; it shells to
+// `lsof`, so it is POSIX-only and best-effort (returns null on any failure).
+import { execFileSync } from "node:child_process";
+/** Report whether a process with the given PID currently exists. */
+export function isProcessAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM means the process exists but is owned by another user — still alive.
+        return err.code === "EPERM";
+    }
+}
+/** Send a signal to a single process. Returns false if the process is gone. */
+export function killProcess(pid, signal = "SIGTERM") {
+    try {
+        process.kill(pid, signal);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Signal an entire process group (POSIX: kill(-pid)). The target must have been
+ * spawned as a group leader (`detached: true`) for this to reach its children.
+ * Returns false if the group is already gone.
+ */
+export function killProcessGroup(pid, signal = "SIGTERM") {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(-pid, signal);
+        return true;
+    }
+    catch {
+        // Fall back to signaling just the leader (e.g. non-POSIX or already reaped).
+        return killProcess(pid, signal);
+    }
+}
+/**
+ * Find the PID of the process listening on a TCP port via `lsof`. Returns null
+ * if nothing is listening or `lsof` is unavailable. POSIX-only fallback.
+ */
+export function findProcessByPort(port) {
+    let output;
+    try {
+        output = execFileSync("lsof", ["-t", "-i", `:${port}`, "-sTCP:LISTEN"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+    }
+    catch {
+        return null;
+    }
+    const firstLine = output.split("\n").find((line) => line.trim() !== "");
+    if (firstLine === undefined)
+        return null;
+    const pid = Number.parseInt(firstLine.trim(), 10);
+    return Number.isInteger(pid) && pid > 0 ? pid : null;
+}
+//# sourceMappingURL=proc.js.map

package/local/state/proc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proc.js","sourceRoot":"","sources":["../../../src/local/state/proc.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,6EAA6E;QAC7E,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;IACzD,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,SAAyB,SAAS;IACzE,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,SAAyB,SAAS;IAC9E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;QAC7E,OAAO,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,cAAc,CAAC,EAAE;YACtE,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC"}

package/local/state/startup-config.d.ts

@@ -0,0 +1,23 @@
+/** The persisted launch configuration. Mirrors the Go `StartupConfig` struct. */
+export interface StartupConfig {
+    data_dir: string;
+    log_dir: string;
+    temporal_addr: string;
+    llm_provider: string;
+    llm_model: string;
+    llm_base_url: string;
+    execution_mode: string;
+    sandbox_image: string;
+    sandbox_auto_pull: boolean;
+    sandbox_cleanup: boolean;
+    sandbox_ttl: number;
+    stigmer_server_pid: number;
+    server_only: boolean;
+}
+/** Write the startup config into the data dir. */
+export declare function saveStartupConfig(dataDir: string, config: StartupConfig): void;
+/** Load the startup config from the data dir, or null if absent/unreadable. */
+export declare function loadStartupConfig(dataDir: string): StartupConfig | null;
+/** Remove the startup config (best-effort). */
+export declare function removeStartupConfig(dataDir: string): void;
+//# sourceMappingURL=startup-config.d.ts.map

package/local/state/startup-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-config.d.ts","sourceRoot":"","sources":["../../../src/local/state/startup-config.ts"],"names":[],"mappings":"AAQA,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAG9E;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAavE;AAED,+CAA+C;AAC/C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzD"}

package/local/state/startup-config.js

@@ -0,0 +1,33 @@
+// Configuration captured at `up` time so the daemon can restart components with
+// the same settings the user launched with. Persisted as `startup-config.json`
+// in the data dir; JSON keys are snake_case to match the Go CLI's file.
+import { readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { STARTUP_CONFIG_FILE } from "../constants.js";
+/** Write the startup config into the data dir. */
+export function saveStartupConfig(dataDir, config) {
+    const path = join(dataDir, STARTUP_CONFIG_FILE);
+    writeFileSync(path, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+/** Load the startup config from the data dir, or null if absent/unreadable. */
+export function loadStartupConfig(dataDir) {
+    const path = join(dataDir, STARTUP_CONFIG_FILE);
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Remove the startup config (best-effort). */
+export function removeStartupConfig(dataDir) {
+    rmSync(join(dataDir, STARTUP_CONFIG_FILE), { force: true });
+}
+//# sourceMappingURL=startup-config.js.map

package/local/state/startup-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-config.js","sourceRoot":"","sources":["../../../src/local/state/startup-config.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+EAA+E;AAC/E,wEAAwE;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAmBtD,kDAAkD;AAClD,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAqB;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAChD,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAChD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/local/status.d.ts

@@ -0,0 +1,9 @@
+import { CommandResult } from "../output/command-result.js";
+/** Probe a port for liveness; the real one connects over TCP. Injectable so
+ * status rendering is testable without depending on a real listener. */
+export type PortProbe = (port: number) => Promise<boolean>;
+/** Build the status result for the local stack rooted at `home`. */
+export declare function buildStatusResult(home?: string, probe?: PortProbe): Promise<CommandResult>;
+/** Human-readable, coarse duration ("2h 5m", "3m 12s", "8s"). */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=status.d.ts.map

package/local/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/local/status.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAkB5D;wEACwE;AACxE,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAI3D,oEAAoE;AACpE,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,MAAkB,EAAE,KAAK,GAAE,SAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmCzH;AAoGD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAWjD"}

package/local/status.js

@@ -0,0 +1,168 @@
+// `stigmer status` — render the local stack's health as a structured result.
+//
+// Source of truth is `health-state.json`, written by the daemon's health
+// monitor. If it is missing but the server port answers (the daemon wrote a PID
+// but not yet a snapshot, or an older daemon), we synthesize a minimal snapshot
+// from a TCP probe so `status` never lies about a running server. Components are
+// always rendered in a fixed, dependency-ordered sequence so the output reads
+// the same on every machine.
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { load as loadConfig } from "../config/config.js";
+import { configPath } from "../config/paths.js";
+import { CommandResult } from "../output/command-result.js";
+import { SERVER_PORT, TEMPORAL_UI_PORT, WEB_CONSOLE_PORT } from "./constants.js";
+import { resolveApiKey, resolveModel, resolveProvider } from "./llm-config.js";
+import { tcpConnects } from "./net/tcp.js";
+import { dataDir } from "./paths.js";
+import { loadHealthState } from "./state/health-state.js";
+import { DAEMON_PID_FILE } from "./constants.js";
+import { readPidFile } from "./state/pidfile.js";
+import { isProcessAlive } from "./state/proc.js";
+const COMPONENT_ORDER = ["temporal", "stigmer-server", "runner", "web-console"];
+const COMPONENT_LABELS = {
+    temporal: "Temporal",
+    "stigmer-server": "Stigmer Server",
+    runner: "Runner",
+    "web-console": "Web Console",
+};
+const defaultProbe = (port) => tcpConnects(port, "127.0.0.1", 1000);
+/** Build the status result for the local stack rooted at `home`. */
+export async function buildStatusResult(home = homedir(), probe = defaultProbe) {
+    const data = dataDir(home);
+    const pid = readPidFile(join(data, DAEMON_PID_FILE));
+    const daemonAlive = pid !== null && isProcessAlive(pid);
+    const portOpen = await probe(SERVER_PORT);
+    if (!daemonAlive && !portOpen) {
+        return CommandResult.warning("Stigmer server is not running").hint("To start: stigmer up");
+    }
+    const health = loadHealthState(join(data, "health-state.json")) ?? synthesizeHealth(pid, portOpen);
+    const result = CommandResult.success("Stigmer server is running");
+    const daemon = result.addSection("Daemon");
+    daemon.field("PID", String(health.daemon_pid));
+    daemon.field("Port", String(SERVER_PORT));
+    daemon.field("Data", data);
+    const uptime = uptimeFrom(health.started_at);
+    if (uptime !== null)
+        daemon.field("Uptime", uptime);
+    for (const name of COMPONENT_ORDER) {
+        const component = health.components[name];
+        if (component === undefined) {
+            if (name === "web-console")
+                continue; // optional; omit when absent
+            result.addSection(COMPONENT_LABELS[name]).field("Status", "Not Running ○");
+            continue;
+        }
+        addComponentSection(result, name, COMPONENT_LABELS[name], component);
+    }
+    addLlmSection(result, home);
+    addWebUiSection(result, health);
+    return result;
+}
+function synthesizeHealth(pid, portOpen) {
+    // No snapshot on disk: report only what a TCP probe can prove. If the port
+    // answers the server is running; otherwise leave components empty so the
+    // renderer shows them as "Not Running" rather than inventing a state.
+    const components = portOpen
+        ? { "stigmer-server": { pid: 0, state: "running", restart_count: 0, started_at: "" } }
+        : {};
+    return { daemon_pid: pid ?? 0, started_at: "", components };
+}
+function addComponentSection(result, name, label, component) {
+    const section = result.addSection(label);
+    const state = component.state || "unknown";
+    let status = `${displayState(state)} ${symbolFor(state)}`;
+    // The runner reports observed readiness (it polls its Temporal queue) on top
+    // of mere liveness — the truthful-visibility improvement over the Go CLI.
+    if (name === "runner" && state === "running") {
+        status += component.ready === true ? " (polling)" : " (starting)";
+    }
+    section.field("Status", status);
+    if (component.pid > 0)
+        section.field("PID", String(component.pid));
+    const uptime = uptimeFrom(component.started_at);
+    if (uptime !== null)
+        section.field("Uptime", uptime);
+    section.field("Restarts", String(component.restart_count));
+    if (component.last_error && (state === "failed" || state === "stopped")) {
+        section.field("Last Error", component.last_error);
+    }
+    if (state === "failed" || state === "stopped") {
+        result.hint(`View ${name} logs: stigmer logs --component ${name}`);
+    }
+}
+function addLlmSection(result, home) {
+    const config = loadConfig(configPath(home));
+    const provider = resolveProvider(config);
+    const section = result.addSection("LLM Configuration");
+    if (provider === "") {
+        section.field("Provider", "Not configured");
+        section.field("Status", "Agents will not execute");
+        result.hint("Configure a provider: stigmer setup");
+        return;
+    }
+    const model = resolveModel(config);
+    switch (provider) {
+        case "ollama":
+            section.field("Provider", "Local (Ollama)");
+            section.field("Model", model);
+            break;
+        case "anthropic":
+        case "openai":
+            section.field("Provider", provider === "anthropic" ? "Anthropic (Cloud)" : "OpenAI (Cloud)");
+            section.field("Model", model);
+            section.field("API Key", resolveApiKey(config) !== "" ? "Configured ✓" : "Not configured ✗");
+            break;
+        default:
+            section.field("Provider", `Unknown (${provider})`);
+    }
+}
+function addWebUiSection(result, health) {
+    const temporalRunning = health.components.temporal?.state === "running";
+    const webRunning = health.components["web-console"]?.state === "running";
+    if (!temporalRunning && !webRunning)
+        return;
+    const section = result.addSection("Web UI");
+    if (webRunning)
+        section.field("Console", `http://localhost:${WEB_CONSOLE_PORT}`);
+    if (temporalRunning)
+        section.field("Temporal", `http://localhost:${TEMPORAL_UI_PORT}`);
+}
+const STATE_SYMBOLS = {
+    running: "✓",
+    unhealthy: "◐",
+    starting: "◌",
+    stopped: "○",
+    failed: "✗",
+    unknown: "○",
+};
+function symbolFor(state) {
+    return STATE_SYMBOLS[state] ?? "○";
+}
+function displayState(state) {
+    return state.charAt(0).toUpperCase() + state.slice(1);
+}
+function uptimeFrom(startedAt) {
+    if (startedAt === "")
+        return null;
+    const started = Date.parse(startedAt);
+    if (Number.isNaN(started))
+        return null;
+    return formatDuration(Date.now() - started);
+}
+/** Human-readable, coarse duration ("2h 5m", "3m 12s", "8s"). */
+export function formatDuration(ms) {
+    const totalSeconds = Math.max(0, Math.floor(ms / 1000));
+    const days = Math.floor(totalSeconds / 86_400);
+    const hours = Math.floor((totalSeconds % 86_400) / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    if (days > 0)
+        return `${days}d ${hours}h`;
+    if (hours > 0)
+        return `${hours}h ${minutes}m`;
+    if (minutes > 0)
+        return `${minutes}m ${seconds}s`;
+    return `${seconds}s`;
+}
+//# sourceMappingURL=status.js.map

package/local/status.js.map

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

package/local/temporal/download.d.ts

@@ -0,0 +1,20 @@
+export { extractTarEntry } from "../artifact.js";
+/** Default Temporal CLI version (matches the Go CLI's `DefaultTemporalVersion`). */
+export declare const DEFAULT_TEMPORAL_VERSION = "1.5.1";
+export interface TemporalDownloadTarget {
+    /** Temporal CLI version, e.g. "1.5.1". */
+    version: string;
+    /** Absolute path to write the extracted `temporal` binary to. */
+    binPath: string;
+    /** Node platform (defaults to process.platform). */
+    platform?: NodeJS.Platform;
+    /** Node arch (defaults to process.arch). */
+    arch?: string;
+    /** Override the fetch implementation (tests). */
+    fetchImpl?: typeof fetch;
+}
+/** Download and install the Temporal CLI binary to `binPath`. */
+export declare function downloadTemporalCli(target: TemporalDownloadTarget): Promise<void>;
+/** True if a Temporal binary is already present at `binPath`. */
+export declare function isTemporalInstalled(binPath: string): boolean;
+//# sourceMappingURL=download.d.ts.map

package/local/temporal/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/local/temporal/download.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,iEAAiE;AACjE,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAavF;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/local/temporal/download.js

@@ -0,0 +1,36 @@
+// On-demand download of the Temporal CLI binary from GitHub releases.
+//
+// `up` needs a `temporal` binary and the upstream release is a small, public,
+// stable artifact. The fetch/gunzip/untar/write mechanics are shared with the
+// stigmer-server downloader in `../artifact.ts`; this module only owns Temporal's
+// asset-naming and the default version.
+//
+// Parity note: like the Go CLI, this does not verify a checksum (the stigmer
+// -server downloader does, per DD-003). A checksum-hardening follow-up is filed;
+// until then the integrity guarantee is HTTPS + GitHub's release immutability.
+import { existsSync } from "node:fs";
+import { fetchTarballBinary, mapReleaseArch, mapReleaseOs } from "../artifact.js";
+// Re-exported so existing consumers (temporal/index.ts, download.test.ts) keep
+// importing the tar reader from here.
+export { extractTarEntry } from "../artifact.js";
+/** Default Temporal CLI version (matches the Go CLI's `DefaultTemporalVersion`). */
+export const DEFAULT_TEMPORAL_VERSION = "1.5.1";
+/** Download and install the Temporal CLI binary to `binPath`. */
+export async function downloadTemporalCli(target) {
+    const goos = mapReleaseOs(target.platform ?? process.platform);
+    const goarch = mapReleaseArch(target.arch ?? process.arch);
+    const archive = `temporal_cli_${target.version}_${goos}_${goarch}.tar.gz`;
+    const url = `https://github.com/temporalio/cli/releases/download/v${target.version}/${archive}`;
+    await fetchTarballBinary({
+        url,
+        entryName: "temporal",
+        binPath: target.binPath,
+        label: "Temporal CLI",
+        fetchImpl: target.fetchImpl,
+    });
+}
+/** True if a Temporal binary is already present at `binPath`. */
+export function isTemporalInstalled(binPath) {
+    return existsSync(binPath);
+}
+//# sourceMappingURL=download.js.map

package/local/temporal/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/local/temporal/download.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,kFAAkF;AAClF,wCAAwC;AACxC,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAElF,+EAA+E;AAC/E,sCAAsC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,oFAAoF;AACpF,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAehD,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA8B;IACtE,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,gBAAgB,MAAM,CAAC,OAAO,IAAI,IAAI,IAAI,MAAM,SAAS,CAAC;IAC1E,MAAM,GAAG,GAAG,wDAAwD,MAAM,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IAEhG,MAAM,kBAAkB,CAAC;QACvB,GAAG;QACH,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,cAAc;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/local/temporal/index.d.ts

@@ -0,0 +1,5 @@
+export { DEFAULT_TEMPORAL_VERSION, downloadTemporalCli, extractTarEntry, isTemporalInstalled } from "./download.js";
+export { isLikelyTemporal, processCommandLine } from "./inspect.js";
+export { TemporalManager, type TemporalManagerOptions } from "./manager.js";
+export { type SupervisedTarget, type SupervisorOptions, TemporalSupervisor } from "./supervisor.js";
+//# sourceMappingURL=index.d.ts.map

package/local/temporal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local/temporal/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/local/temporal/index.js

@@ -0,0 +1,6 @@
+// Public surface of the Temporal subsystem.
+export { DEFAULT_TEMPORAL_VERSION, downloadTemporalCli, extractTarEntry, isTemporalInstalled } from "./download.js";
+export { isLikelyTemporal, processCommandLine } from "./inspect.js";
+export { TemporalManager } from "./manager.js";
+export { TemporalSupervisor } from "./supervisor.js";
+//# sourceMappingURL=index.js.map

package/local/temporal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/local/temporal/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,eAAe,EAA+B,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAiD,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/local/temporal/inspect.d.ts

@@ -0,0 +1,8 @@
+/** Full command line of a process via `ps`, or null if it cannot be read. */
+export declare function processCommandLine(pid: number): string | null;
+/**
+ * Heuristically confirm that `pid` is the Temporal server we manage: its command
+ * line mentions "temporal" and either our binary path or a "server" subcommand.
+ */
+export declare function isLikelyTemporal(pid: number, binPath: string): boolean;
+//# sourceMappingURL=inspect.d.ts.map

package/local/temporal/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../src/local/temporal/inspect.ts"],"names":[],"mappings":"AASA,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMtE"}