@stigmer/cli 3.0.8

package/local/daemon/env.js

@@ -0,0 +1,82 @@
+// The foreground launcher hands the supervised daemon everything it needs to
+// run through the environment — the same mechanism the Go CLI uses. Centralizing
+// the variable names and the (de)serialization here keeps that contract in one
+// place: the launcher writes it with buildDaemonEnv, the daemon reads it with
+// readDaemonConfig, and nothing in between guesses at string keys.
+/** Environment variable names that make up the launcher -> daemon contract. */
+export const DaemonEnvVar = {
+    DataDir: "STIGMER_DATA_DIR",
+    LogDir: "STIGMER_LOG_DIR",
+    TemporalManaged: "STIGMER_TEMPORAL_MANAGED",
+    TemporalAddress: "TEMPORAL_SERVICE_ADDRESS",
+    ServerOnly: "STIGMER_SERVER_ONLY",
+    NoWeb: "STIGMER_NO_WEB",
+    ServerBin: "STIGMER_SERVER_BIN",
+    RunnerNodeBin: "STIGMER_RUNNER_NODE_BIN",
+    RunnerEntry: "STIGMER_RUNNER_ENTRY",
+    RunnerAppDir: "STIGMER_RUNNER_APP_DIR",
+    CursorApiKey: "CURSOR_API_KEY",
+    ActivityRouting: "STIGMER_ACTIVITY_ROUTING",
+};
+/**
+ * Build the environment for the internal-daemon child: the caller's environment
+ * plus the resolved contract values. Runner coordinates are omitted in
+ * server-only mode.
+ */
+export function buildDaemonEnv(inputs, base = process.env) {
+    const env = { ...base };
+    env[DaemonEnvVar.DataDir] = inputs.dataDir;
+    env[DaemonEnvVar.LogDir] = inputs.logDir;
+    env[DaemonEnvVar.TemporalManaged] = String(inputs.temporalManaged);
+    env[DaemonEnvVar.TemporalAddress] = inputs.temporalAddress;
+    env[DaemonEnvVar.ServerBin] = inputs.serverBin;
+    if (inputs.serverOnly)
+        env[DaemonEnvVar.ServerOnly] = "true";
+    if (inputs.noWeb)
+        env[DaemonEnvVar.NoWeb] = "1";
+    if (inputs.runner !== undefined && !inputs.serverOnly) {
+        env[DaemonEnvVar.RunnerNodeBin] = inputs.runner.nodeBin;
+        env[DaemonEnvVar.RunnerEntry] = inputs.runner.entryPath;
+        env[DaemonEnvVar.RunnerAppDir] = inputs.runner.appDir;
+    }
+    return env;
+}
+/** Parse the daemon configuration from an environment. Throws if a required
+ * value is missing. */
+export function readDaemonConfig(env = process.env) {
+    const dataDir = required(env, DaemonEnvVar.DataDir);
+    const logDir = env[DaemonEnvVar.LogDir] ?? `${dataDir}/logs`;
+    const serverOnly = env[DaemonEnvVar.ServerOnly] === "true";
+    const runner = readRunner(env);
+    return {
+        dataDir,
+        logDir,
+        temporalManaged: env[DaemonEnvVar.TemporalManaged] === "true",
+        temporalAddress: env[DaemonEnvVar.TemporalAddress] ?? "127.0.0.1:7233",
+        serverOnly,
+        noWeb: env[DaemonEnvVar.NoWeb] === "1",
+        serverBin: required(env, DaemonEnvVar.ServerBin),
+        runner: serverOnly ? undefined : runner,
+        cursorApiKey: nonEmpty(env[DaemonEnvVar.CursorApiKey]),
+        activityRouting: nonEmpty(env[DaemonEnvVar.ActivityRouting]),
+    };
+}
+function readRunner(env) {
+    const nodeBin = env[DaemonEnvVar.RunnerNodeBin];
+    const entryPath = env[DaemonEnvVar.RunnerEntry];
+    const appDir = env[DaemonEnvVar.RunnerAppDir];
+    if (!nodeBin || !entryPath || !appDir)
+        return undefined;
+    return { nodeBin, entryPath, appDir };
+}
+function required(env, key) {
+    const value = env[key];
+    if (value === undefined || value === "") {
+        throw new Error(`${key} is required for the daemon process`);
+    }
+    return value;
+}
+function nonEmpty(value) {
+    return value !== undefined && value !== "" ? value : undefined;
+}
+//# sourceMappingURL=env.js.map

package/local/daemon/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/local/daemon/env.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,iFAAiF;AACjF,+EAA+E;AAC/E,8EAA8E;AAC9E,mEAAmE;AAEnE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,iBAAiB;IACzB,eAAe,EAAE,0BAA0B;IAC3C,eAAe,EAAE,0BAA0B;IAC3C,UAAU,EAAE,qBAAqB;IACjC,KAAK,EAAE,gBAAgB;IACvB,SAAS,EAAE,oBAAoB;IAC/B,aAAa,EAAE,yBAAyB;IACxC,WAAW,EAAE,sBAAsB;IACnC,YAAY,EAAE,wBAAwB;IACtC,YAAY,EAAE,gBAAgB;IAC9B,eAAe,EAAE,0BAA0B;CACnC,CAAC;AAmCX;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuB,EAAE,OAA0B,OAAO,CAAC,GAAG;IAC3F,MAAM,GAAG,GAAsB,EAAE,GAAG,IAAI,EAAE,CAAC;IAC3C,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACnE,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC;IAC3D,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;IAC/C,IAAI,MAAM,CAAC,UAAU;QAAE,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;IAC7D,IAAI,MAAM,CAAC,KAAK;QAAE,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACtD,GAAG,CAAC,YAAY,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QACxD,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACxD,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;uBACuB;AACvB,MAAM,UAAU,gBAAgB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,GAAG,OAAO,OAAO,CAAC;IAC7D,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC;IAE3D,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO;QACL,OAAO;QACP,MAAM;QACN,eAAe,EAAE,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,KAAK,MAAM;QAC7D,eAAe,EAAE,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,gBAAgB;QACtE,UAAU;QACV,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,GAAG;QACtC,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,SAAS,CAAC;QAChD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QACvC,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACtD,eAAe,EAAE,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,GAAsB;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACxD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,QAAQ,CAAC,GAAsB,EAAE,GAAW;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,qCAAqC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB;IACzC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC"}

package/local/daemon/host.d.ts

@@ -0,0 +1,7 @@
+import type { ChildHandle, Clock, ProcessHost, SpawnRequest } from "./types.js";
+export declare class NodeProcessHost implements ProcessHost {
+    spawn(request: SpawnRequest): ChildHandle;
+}
+/** Real wall-clock implementation of Clock. */
+export declare const systemClock: Clock;
+//# sourceMappingURL=host.d.ts.map

package/local/daemon/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../src/local/daemon/host.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAY,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1F,qBAAa,eAAgB,YAAW,WAAW;IACjD,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;CAwD1C;AAED,+CAA+C;AAC/C,eAAO,MAAM,WAAW,EAAE,KAGzB,CAAC"}

package/local/daemon/host.js

@@ -0,0 +1,74 @@
+// The production ProcessHost and Clock.
+//
+// Children are spawned detached (their own process group) so the whole tree can
+// be signaled, with stdout+stderr piped through the daemon. The daemon tees each
+// chunk to the component's log file and scans stdout for an optional readiness
+// marker — the same pipe-and-watch shape the conformance/e2e harnesses use,
+// which is what lets `status` report "runner actually polling" instead of mere
+// liveness. Logs survive normally because the daemon outlives its children; an
+// abnormal daemon death is handled by orphan cleanup on the next `up`.
+import { spawn } from "node:child_process";
+import { createWriteStream } from "node:fs";
+import { killProcessGroup } from "../state/proc.js";
+export class NodeProcessHost {
+    spawn(request) {
+        const out = createWriteStream(request.logFile, { flags: "a" });
+        const child = spawn(request.command, request.args, {
+            cwd: request.cwd,
+            env: request.env,
+            detached: true,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let exited = false;
+        let exitCb = null;
+        let readyCb = null;
+        let ready = false;
+        // Keep a small rolling tail so a marker split across chunks is still found.
+        let tail = "";
+        const marker = request.readinessMarker;
+        child.stdout?.on("data", (chunk) => {
+            out.write(chunk);
+            if (marker !== undefined && !ready) {
+                tail = (tail + chunk.toString("utf8")).slice(-Math.max(marker.length * 2, 256));
+                if (tail.includes(marker)) {
+                    ready = true;
+                    readyCb?.();
+                }
+            }
+        });
+        child.stderr?.on("data", (chunk) => out.write(chunk));
+        child.on("exit", (code, signal) => {
+            exited = true;
+            out.end();
+            exitCb?.({ code, signal });
+        });
+        child.on("error", (err) => {
+            out.write(`failed to spawn ${request.command}: ${String(err)}\n`);
+            exited = true;
+            exitCb?.({ code: null, signal: null });
+        });
+        const pid = child.pid ?? -1;
+        return {
+            pid,
+            hasExited: () => exited,
+            onExit: (cb) => {
+                exitCb = cb;
+            },
+            onReady: (cb) => {
+                readyCb = cb;
+                if (ready)
+                    cb();
+            },
+            kill: (signal) => {
+                if (pid > 0)
+                    killProcessGroup(pid, signal);
+            },
+        };
+    }
+}
+/** Real wall-clock implementation of Clock. */
+export const systemClock = {
+    now: () => Date.now(),
+    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+};
+//# sourceMappingURL=host.js.map

package/local/daemon/host.js.map

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

package/local/daemon/index.d.ts

@@ -0,0 +1,8 @@
+export { buildComponents, buildRunnerEnv, buildServerEnv } from "./components.js";
+export { type DaemonConfig, type DaemonEnvInputs, DaemonEnvVar, buildDaemonEnv, readDaemonConfig } from "./env.js";
+export { NodeProcessHost, systemClock } from "./host.js";
+export { down, isRunning, type UpOptions, up } from "./launch.js";
+export { type InternalDaemonDeps, type TemporalControl, runInternalDaemon } from "./process.js";
+export { HEALTH_CHECK_INTERVAL_MS, MAX_RESTARTS, MAX_UNHEALTHY_CHECKS, ProcessSupervisor, RAPID_CRASH_WINDOW_MS, SETTLE_DELAY_MS, type StartResult, type SupervisorDeps, } from "./supervisor.js";
+export type { ChildHandle, Clock, ComponentSpec, ExitInfo, ProcessHost, ReadinessGate, SpawnRequest } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local/daemon/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACnH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/local/daemon/index.js

@@ -0,0 +1,8 @@
+// Public surface of the daemon subsystem.
+export { buildComponents, buildRunnerEnv, buildServerEnv } from "./components.js";
+export { DaemonEnvVar, buildDaemonEnv, readDaemonConfig } from "./env.js";
+export { NodeProcessHost, systemClock } from "./host.js";
+export { down, isRunning, up } from "./launch.js";
+export { runInternalDaemon } from "./process.js";
+export { HEALTH_CHECK_INTERVAL_MS, MAX_RESTARTS, MAX_UNHEALTHY_CHECKS, ProcessSupervisor, RAPID_CRASH_WINDOW_MS, SETTLE_DELAY_MS, } from "./supervisor.js";
+//# sourceMappingURL=index.js.map

package/local/daemon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/local/daemon/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAA2C,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACnH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAkB,EAAE,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAiD,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,GAGhB,MAAM,iBAAiB,CAAC"}

package/local/daemon/launch.d.ts

@@ -0,0 +1,11 @@
+export interface UpOptions {
+    serverOnly?: boolean;
+    noWeb?: boolean;
+}
+/** Start the local stack in the background. Throws on any startup failure. */
+export declare function up(options?: UpOptions, home?: string): Promise<void>;
+/** Stop the local stack. Returns false if nothing was running. */
+export declare function down(home?: string): Promise<boolean>;
+/** Whether the daemon is running: live PID, else a server-port fallback. */
+export declare function isRunning(home?: string): Promise<boolean>;
+//# sourceMappingURL=launch.d.ts.map

package/local/daemon/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../src/local/daemon/launch.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,8EAA8E;AAC9E,wBAAsB,EAAE,CAAC,OAAO,GAAE,SAAc,EAAE,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzF;AAuCD,kEAAkE;AAClE,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiCrE;AAED,4EAA4E;AAC5E,wBAAsB,SAAS,CAAC,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1E"}

package/local/daemon/launch.js

@@ -0,0 +1,219 @@
+// Foreground control of the daemon: `up` (spawn + verify + wait-ready),
+// `down` (signal + wait + safety-net cleanup), and a liveness check.
+//
+// `up` resolves every heavy dependency in the foreground (Temporal binary,
+// server binary, runner entry) so failures surface with a clear message before
+// a detached daemon is spawned, then re-execs this same CLI as the hidden
+// `internal-daemon` and waits until the server's gRPC port answers.
+import { spawn } from "node:child_process";
+import { mkdirSync, openSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { load as loadConfig } from "../../config/config.js";
+import { log } from "../../logger.js";
+import { CliExitError } from "../../errors/cli-exit-error.js";
+import { ExitCode } from "../../errors/exit-codes.js";
+import { DAEMON_PID_FILE, SERVER_PORT } from "../constants.js";
+import { tcpConnects, waitForTcp } from "../net/tcp.js";
+import { dataDir, logDir } from "../paths.js";
+import { readPidFile, removePidFile } from "../state/pidfile.js";
+import { findProcessByPort, isProcessAlive, killProcess } from "../state/proc.js";
+import { removeStartupConfig, saveStartupConfig } from "../state/startup-config.js";
+import { rotateLogs } from "../state/log-rotation.js";
+import { ensureRunner } from "../runtime/runner.js";
+import { ensureServerBinary } from "../runtime/server.js";
+import { TemporalManager } from "../temporal/manager.js";
+import { buildDaemonEnv } from "./env.js";
+/** How long `up` waits for the server's gRPC port after spawning the daemon. */
+const READY_TIMEOUT_MS = 60_000;
+/** How long to wait for the daemon to come up before checking it is still alive. */
+const DAEMON_SETTLE_MS = 3_000;
+/** How long `down` waits for graceful daemon exit before force-killing. */
+const STOP_TIMEOUT_MS = 15_000;
+const STOP_POLL_MS = 500;
+/** Start the local stack in the background. Throws on any startup failure. */
+export async function up(options = {}, home = homedir()) {
+    const data = dataDir(home);
+    const logs = logDir(home);
+    cleanupOrphans(data);
+    if (await isRunning(home)) {
+        throw new CliExitError("daemon is already running", ExitCode.General);
+    }
+    mkdirSync(data, { recursive: true });
+    mkdirSync(logs, { recursive: true });
+    rotateLogs(logs);
+    const config = loadConfig();
+    const temporalManaged = isTemporalManaged(config);
+    const temporal = TemporalManager.forHome(home);
+    if (temporalManaged) {
+        log.info("ensuring Temporal is installed");
+        await temporal.ensureInstalled();
+    }
+    const serverBin = await ensureServerBinary({ home });
+    const runner = options.serverOnly === true ? undefined : ensureRunner({ home });
+    const env = buildDaemonEnv({
+        dataDir: data,
+        logDir: logs,
+        temporalManaged,
+        temporalAddress: temporal.address,
+        serverOnly: options.serverOnly === true,
+        noWeb: options.noWeb === true,
+        serverBin,
+        runner,
+    }, process.env);
+    const daemonPid = spawnDaemon(env, join(logs, "daemon.log"));
+    log.info("daemon process started", { pid: daemonPid });
+    await sleep(DAEMON_SETTLE_MS);
+    if (!isProcessAlive(daemonPid)) {
+        throw new CliExitError("daemon process crashed during startup", ExitCode.General, [
+            `Check ${join(logs, "daemon.log")} for details.`,
+        ]);
+    }
+    await waitForTcp({ port: SERVER_PORT, timeoutMs: READY_TIMEOUT_MS, label: "stigmer-server" });
+    await applySeedpackBestEffort(home);
+    saveStartupConfig(data, buildStartupConfig(data, logs, temporal.address, config, daemonPid, options));
+}
+/**
+ * Bootstrap the system seedpack into the freshly-started local backend (the TS
+ * equivalent of the Go daemon's EnsureSeedpackBootstrapped). Idempotent via a
+ * content-hash marker, so repeated `up`s are cheap. Best-effort: the stack is
+ * already serving by this point, so a seedpack failure is surfaced as a warning
+ * with a retry hint rather than tearing the stack down.
+ */
+async function applySeedpackBestEffort(home) {
+    try {
+        const [{ createBackendClient }, { getDefault }, { applySeedpack }] = await Promise.all([
+            import("../../client/index.js"),
+            import("../../config/config.js"),
+            import("../seedpack/apply.js"),
+        ]);
+        // Always seed the local server `up` just started — never the active backend
+        // context. A user whose CLI is pointed at cloud must still get their local
+        // stack seeded, and must never have system resources applied to their cloud
+        // org. Pin to a fresh local config (localhost:SERVER_PORT) with no auth.
+        const client = createBackendClient({ config: getDefault(), getAccessToken: () => null });
+        const result = await applySeedpack({
+            controller: client.controller,
+            stigmer: client.stigmer,
+            info: (line) => process.stderr.write(`${line}\n`),
+            warn: (line) => process.stderr.write(`${line}\n`),
+        }, { markerDir: dataDir(home), home });
+        log.debug("seedpack bootstrap complete", { applied: result.applied, hash: result.hash, org: result.org });
+    }
+    catch (err) {
+        log.warn("seedpack bootstrap failed", { error: String(err) });
+        process.stderr.write("Warning: failed to apply system resources (seedpack). Run 'stigmer seedpack apply' to retry.\n");
+    }
+}
+/** Stop the local stack. Returns false if nothing was running. */
+export async function down(home = homedir()) {
+    const data = dataDir(home);
+    let pid = readPidFile(join(data, DAEMON_PID_FILE));
+    if (pid === null)
+        pid = findProcessByPort(SERVER_PORT);
+    if (pid === null || !isProcessAlive(pid)) {
+        removePidFile(join(data, DAEMON_PID_FILE));
+        await stopManagedTemporal(home);
+        cleanupOrphans(data);
+        return false;
+    }
+    // The daemon traps SIGTERM and tears down children + Temporal in order.
+    killProcess(pid, "SIGTERM");
+    log.info("sent SIGTERM to daemon", { pid });
+    const deadline = Date.now() + STOP_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        if (!isProcessAlive(pid)) {
+            removePidFile(join(data, DAEMON_PID_FILE));
+            removeStartupConfig(data);
+            return true;
+        }
+        await sleep(STOP_POLL_MS);
+    }
+    log.warn("daemon did not stop gracefully, force killing", { pid });
+    killProcess(pid, "SIGKILL");
+    removePidFile(join(data, DAEMON_PID_FILE));
+    removeStartupConfig(data);
+    await stopManagedTemporal(home);
+    cleanupOrphans(data);
+    return true;
+}
+/** Whether the daemon is running: live PID, else a server-port fallback. */
+export async function isRunning(home = homedir()) {
+    const data = dataDir(home);
+    const pid = readPidFile(join(data, DAEMON_PID_FILE));
+    if (pid !== null) {
+        if (isProcessAlive(pid))
+            return true;
+        removePidFile(join(data, DAEMON_PID_FILE)); // stale
+    }
+    return tcpConnects(SERVER_PORT, "127.0.0.1", 1000);
+}
+// Re-exec this CLI as the detached internal-daemon, returning its PID. Replaying
+// execArgv carries the tsx loader in dev and is a no-op for a plain-node build.
+function spawnDaemon(env, daemonLog) {
+    const script = process.argv[1];
+    if (script === undefined) {
+        throw new CliExitError("cannot resolve the CLI entry point to launch the daemon", ExitCode.General);
+    }
+    const out = openSync(daemonLog, "a");
+    const child = spawn(process.execPath, [...process.execArgv, script, "internal-daemon"], {
+        detached: true,
+        env,
+        stdio: ["ignore", out, out],
+    });
+    child.unref();
+    if (child.pid === undefined) {
+        throw new CliExitError("failed to start the daemon process", ExitCode.General);
+    }
+    return child.pid;
+}
+// Kill any daemon/server/runner left alive by a previous, improperly-stopped run.
+function cleanupOrphans(data) {
+    for (const name of [DAEMON_PID_FILE, "stigmer-server.pid", "runner.pid"]) {
+        const pidPath = join(data, name);
+        const pid = readPidFile(pidPath);
+        if (pid === null)
+            continue;
+        if (isProcessAlive(pid)) {
+            log.warn("killing orphaned process from a previous run", { file: name, pid });
+            killProcess(pid, "SIGTERM");
+        }
+        removePidFile(pidPath);
+    }
+}
+async function stopManagedTemporal(home) {
+    try {
+        await TemporalManager.forHome(home).stop();
+    }
+    catch (err) {
+        log.debug("managed Temporal stop skipped", { error: String(err) });
+    }
+}
+// Default to managed Temporal unless the opaque local config explicitly opts out
+// (Go parity: managed is the default). Wave 4's `setup` models this section.
+function isTemporalManaged(config) {
+    const local = config.backend.local;
+    return local?.temporal?.managed !== false;
+}
+function buildStartupConfig(data, logs, temporalAddr, config, daemonPid, options) {
+    const local = config.backend.local;
+    return {
+        data_dir: data,
+        log_dir: logs,
+        temporal_addr: temporalAddr,
+        llm_provider: local?.llm?.provider ?? "",
+        llm_model: local?.llm?.model ?? "",
+        llm_base_url: local?.llm?.base_url ?? "",
+        execution_mode: "local",
+        sandbox_image: "",
+        sandbox_auto_pull: false,
+        sandbox_cleanup: false,
+        sandbox_ttl: 0,
+        stigmer_server_pid: daemonPid,
+        server_only: options.serverOnly === true,
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=launch.js.map

package/local/daemon/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../src/local/daemon/launch.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,qEAAqE;AACrE,EAAE;AACF,2EAA2E;AAC3E,+EAA+E;AAC/E,0EAA0E;AAC1E,oEAAoE;AAEpE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAe,IAAI,IAAI,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAsB,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACxG,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,gFAAgF;AAChF,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,oFAAoF;AACpF,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,2EAA2E;AAC3E,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,YAAY,GAAG,GAAG,CAAC;AAOzB,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,UAAqB,EAAE,EAAE,OAAe,OAAO,EAAE;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE1B,cAAc,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,YAAY,CAAC,2BAA2B,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,IAAI,eAAe,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC3C,MAAM,QAAQ,CAAC,eAAe,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhF,MAAM,GAAG,GAAG,cAAc,CACxB;QACE,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,eAAe;QACf,eAAe,EAAE,QAAQ,CAAC,OAAO;QACjC,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,IAAI;QACvC,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI;QAC7B,SAAS;QACT,MAAM;KACP,EACD,OAAO,CAAC,GAAG,CACZ,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;IAC7D,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAEvD,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9B,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,YAAY,CAAC,uCAAuC,EAAE,QAAQ,CAAC,OAAO,EAAE;YAChF,SAAS,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,eAAe;SACjD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAE9F,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAEpC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AACxG,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,uBAAuB,CAAC,IAAY;IACjD,IAAI,CAAC;QACH,MAAM,CAAC,EAAE,mBAAmB,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACrF,MAAM,CAAC,uBAAuB,CAAC;YAC/B,MAAM,CAAC,wBAAwB,CAAC;YAChC,MAAM,CAAC,sBAAsB,CAAC;SAC/B,CAAC,CAAC;QACH,4EAA4E;QAC5E,2EAA2E;QAC3E,4EAA4E;QAC5E,yEAAyE;QACzE,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC;YACE,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;YACjD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;SAClD,EACD,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CACnC,CAAC;QACF,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5G,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gGAAgG,CACjG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAe,OAAO,EAAE;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IACnD,IAAI,GAAG,KAAK,IAAI;QAAE,GAAG,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAEvD,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;QAC3C,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAChC,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wEAAwE;IACxE,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC5B,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;YAC3C,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,+CAA+C,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACnE,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC5B,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IAC3C,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAChC,cAAc,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe,OAAO,EAAE;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IACrD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,IAAI,cAAc,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ;IACtD,CAAC;IACD,OAAO,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,iFAAiF;AACjF,gFAAgF;AAChF,SAAS,WAAW,CAAC,GAAsB,EAAE,SAAiB;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,YAAY,CAAC,yDAAyD,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtG,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE;QACtF,QAAQ,EAAE,IAAI;QACd,GAAG;QACH,KAAK,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC;KAC5B,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CAAC,oCAAoC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC;AACnB,CAAC;AAED,kFAAkF;AAClF,SAAS,cAAc,CAAC,IAAY;IAClC,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,oBAAoB,EAAE,YAAY,CAAC,EAAE,CAAC;QACzE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,IAAI;YAAE,SAAS;QAC3B,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,8CAA8C,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;YAC9E,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC9B,CAAC;QACD,aAAa,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,6EAA6E;AAC7E,SAAS,iBAAiB,CAAC,MAAc;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAyD,CAAC;IACvF,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,KAAK,KAAK,CAAC;AAC5C,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAY,EACZ,IAAY,EACZ,YAAoB,EACpB,MAAc,EACd,SAAiB,EACjB,OAAkB;IAElB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAuF,CAAC;IACrH,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,YAAY;QAC3B,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,IAAI,EAAE;QACxC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;QAClC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,IAAI,EAAE;QACxC,cAAc,EAAE,OAAO;QACvB,aAAa,EAAE,EAAE;QACjB,iBAAiB,EAAE,KAAK;QACxB,eAAe,EAAE,KAAK;QACtB,WAAW,EAAE,CAAC;QACd,kBAAkB,EAAE,SAAS;QAC7B,WAAW,EAAE,OAAO,CAAC,UAAU,KAAK,IAAI;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/local/daemon/process.d.ts

@@ -0,0 +1,28 @@
+import { type Logger } from "../../logger.js";
+import { type DaemonConfig } from "./env.js";
+import type { Clock, ProcessHost } from "./types.js";
+/** The Temporal lifecycle surface the daemon drives. TemporalManager (+ its
+ * supervisor) satisfies it; tests provide a fake. */
+export interface TemporalControl {
+    readonly address: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): Promise<boolean>;
+    getPid(): number | null;
+    startSupervisor(): void;
+    stopSupervisor(): void;
+}
+export interface InternalDaemonDeps {
+    config?: DaemonConfig;
+    host?: ProcessHost;
+    clock?: Clock;
+    temporal?: TemporalControl;
+    log?: Logger;
+    /** Resolves when shutdown is requested (real entry: SIGTERM/SIGINT). */
+    waitForShutdown: () => Promise<void>;
+    /** Invoked once the stack is up and the monitor is running (tests). */
+    onStarted?: () => void;
+}
+/** Run the daemon to completion. Returns the process exit code. */
+export declare function runInternalDaemon(deps: InternalDaemonDeps): Promise<number>;
+//# sourceMappingURL=process.d.ts.map

package/local/daemon/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/local/daemon/process.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,MAAM,EAAqB,MAAM,iBAAiB,CAAC;AAQjE,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,UAAU,CAAC;AAG/D,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErD;qDACqD;AACrD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,IAAI,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,IAAI,IAAI,CAAC;IACxB,cAAc,IAAI,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,mEAAmE;AACnE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkGjF"}

package/local/daemon/process.js

@@ -0,0 +1,149 @@
+// The supervised daemon body — the `stigmer internal-daemon` entry point.
+//
+// It brings the local stack up in the canonical order (managed Temporal, then
+// the gated server, then the runner), records a health snapshot readers can
+// trust, runs the 10s health monitor, and on a shutdown signal tears everything
+// down in reverse. Temporal, the process host, the clock, and the shutdown
+// trigger are all injectable so the whole body can be driven in a test without
+// real signals or a real Temporal.
+import { mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { log as defaultLog } from "../../logger.js";
+import { DAEMON_PID_FILE, HEALTH_STATE_FILE } from "../constants.js";
+import { writeHealthState } from "../state/health-state.js";
+import { removePidFile, writePidFile } from "../state/pidfile.js";
+import { TemporalManager } from "../temporal/manager.js";
+import { TemporalSupervisor } from "../temporal/supervisor.js";
+import { isWebConsoleAvailable } from "../webconsole/index.js";
+import { buildComponents } from "./components.js";
+import { readDaemonConfig } from "./env.js";
+import { NodeProcessHost, systemClock } from "./host.js";
+import { HEALTH_CHECK_INTERVAL_MS, ProcessSupervisor, SETTLE_DELAY_MS } from "./supervisor.js";
+/** Run the daemon to completion. Returns the process exit code. */
+export async function runInternalDaemon(deps) {
+    const config = deps.config ?? readDaemonConfig();
+    const host = deps.host ?? new NodeProcessHost();
+    const clock = deps.clock ?? systemClock;
+    const log = deps.log ?? defaultLog;
+    mkdirSync(config.logDir, { recursive: true });
+    mkdirSync(join(config.dataDir, "workspace"), { recursive: true });
+    writePidFile(join(config.dataDir, DAEMON_PID_FILE), process.pid);
+    const healthState = {
+        daemon_pid: process.pid,
+        started_at: new Date(clock.now()).toISOString(),
+        components: {},
+    };
+    const healthPath = join(config.dataDir, HEALTH_STATE_FILE);
+    const persist = () => writeHealthState(healthPath, healthState);
+    const temporal = deps.temporal ?? (config.temporalManaged ? buildTemporal(config, log) : null);
+    // --- Start managed Temporal first (the server and runner depend on it). ---
+    if (temporal !== null) {
+        log.info("starting managed Temporal");
+        healthState.components.temporal = { pid: 0, state: "stopped", started_at: "", restart_count: 0 };
+        try {
+            await temporal.start();
+        }
+        catch (err) {
+            healthState.components.temporal.state = "failed";
+            healthState.components.temporal.last_error = String(err);
+            persist();
+            log.error("failed to start managed Temporal", { error: String(err) });
+            return 1;
+        }
+        healthState.components.temporal.pid = temporal.getPid() ?? 0;
+        healthState.components.temporal.state = "running";
+        healthState.components.temporal.started_at = new Date(clock.now()).toISOString();
+        temporal.startSupervisor();
+        persist();
+    }
+    // --- Start the server (gated) and runner via the supervisor. ---
+    const supervisor = new ProcessSupervisor(buildComponents(config), { host, clock, healthState, persist, log });
+    const result = await supervisor.startAll();
+    if (!result.ok) {
+        log.error("critical component failed to start", { component: result.failedCritical });
+        if (temporal !== null) {
+            temporal.stopSupervisor();
+            await temporal.stop().catch(() => { });
+        }
+        return 1;
+    }
+    // Let processes settle, then catch anything that crashed immediately.
+    await clock.sleep(SETTLE_DELAY_MS);
+    supervisor.settleCheck();
+    // Web console: detect-and-skip until T06 wires real serving.
+    healthState.components["web-console"] = {
+        pid: 0,
+        state: config.noWeb || !isWebConsoleAvailable() ? "stopped" : "running",
+        started_at: "",
+        restart_count: 0,
+    };
+    if (config.noWeb)
+        log.info("web console disabled via --no-web");
+    else if (!isWebConsoleAvailable())
+        log.debug("web console not bundled in this build, skipping");
+    persist();
+    // --- Health monitor: sync Temporal + drive one supervisor tick per interval. ---
+    const monitor = setInterval(() => {
+        void (async () => {
+            if (temporal !== null)
+                await syncTemporal(temporal, healthState);
+            await supervisor.tick();
+        })();
+    }, HEALTH_CHECK_INTERVAL_MS);
+    monitor.unref?.();
+    log.info("daemon started", { pid: process.pid });
+    deps.onStarted?.();
+    // --- Wait for shutdown, then tear down in reverse order. ---
+    await deps.waitForShutdown();
+    log.info("received shutdown signal");
+    clearInterval(monitor);
+    await supervisor.shutdown();
+    if (temporal !== null) {
+        temporal.stopSupervisor();
+        log.info("stopping managed Temporal");
+        await temporal.stop().catch((err) => log.warn("failed to stop managed Temporal cleanly", { error: String(err) }));
+        if (healthState.components.temporal !== undefined)
+            healthState.components.temporal.state = "stopped";
+    }
+    persist();
+    removePidFile(join(config.dataDir, DAEMON_PID_FILE));
+    removePidFile(healthPath);
+    log.info("daemon shutdown complete");
+    return 0;
+}
+// Sync the Temporal component's health from its self-supervising manager.
+async function syncTemporal(temporal, healthState) {
+    const state = healthState.components.temporal;
+    if (state === undefined)
+        return;
+    if (await temporal.isRunning()) {
+        state.state = "running";
+        state.pid = temporal.getPid() ?? state.pid;
+        state.last_error = undefined;
+    }
+    else {
+        state.state = "unhealthy";
+    }
+}
+// Build the real managed-Temporal control from the ~/.stigmer layout (home is
+// two levels up from the data dir: ~/.stigmer/data -> ~).
+function buildTemporal(config, log) {
+    const home = dirname(dirname(config.dataDir));
+    const manager = TemporalManager.forHome(home);
+    let supervisor = null;
+    return {
+        get address() {
+            return manager.address;
+        },
+        start: () => manager.start(),
+        stop: () => manager.stop(),
+        isRunning: () => manager.isRunning(),
+        getPid: () => manager.getPid(),
+        startSupervisor: () => {
+            supervisor = new TemporalSupervisor(manager, { log });
+            supervisor.start();
+        },
+        stopSupervisor: () => supervisor?.stop(),
+    };
+}
+//# sourceMappingURL=process.js.map