@stigmer/cli 3.0.8

package/local/daemon/process.js.map

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

package/local/daemon/supervisor.d.ts

@@ -0,0 +1,56 @@
+import { type Logger } from "../../logger.js";
+import type { HealthState } from "../state/health-state.js";
+import type { Clock, ComponentSpec, ProcessHost } from "./types.js";
+export declare const MAX_RESTARTS = 5;
+export declare const RAPID_CRASH_WINDOW_MS = 5000;
+export declare const MAX_UNHEALTHY_CHECKS = 3;
+export declare const GRACEFUL_STOP_TIMEOUT_MS = 5000;
+export declare const SETTLE_DELAY_MS = 2000;
+export declare const HEALTH_CHECK_INTERVAL_MS = 10000;
+export interface SupervisorDeps {
+    host: ProcessHost;
+    clock: Clock;
+    /** Shared snapshot; the supervisor owns the components map. */
+    healthState: HealthState;
+    /** Persist the snapshot (atomic health-state write). */
+    persist: () => void;
+    log?: Logger;
+    /** TCP probe for the server health check; injectable for tests. */
+    probe?: (port: number) => Promise<boolean>;
+    serverPort?: number;
+}
+/** Result of the initial start sequence. */
+export interface StartResult {
+    ok: boolean;
+    /** Name of the critical component that failed, if any. */
+    failedCritical?: string;
+}
+export declare class ProcessSupervisor {
+    private readonly managed;
+    private readonly host;
+    private readonly clock;
+    private readonly healthState;
+    private readonly persist;
+    private readonly log;
+    private readonly probe;
+    private readonly serverPort;
+    constructor(specs: ComponentSpec[], deps: SupervisorDeps);
+    /**
+     * Start all components in order. A critical component that fails to start or
+     * gate aborts startup (returns failedCritical); a non-critical failure is
+     * recorded and skipped.
+     */
+    startAll(): Promise<StartResult>;
+    /** After a brief settle, mark any component that already crashed as failed. */
+    settleCheck(): void;
+    /** One health-monitor iteration: restart crashed children, probe the server. */
+    tick(): Promise<void>;
+    /** Gracefully stop all components in reverse start order. */
+    shutdown(): Promise<void>;
+    private probeServer;
+    private tryRestart;
+    private spawn;
+    private killAndWait;
+    private raceTimeout;
+}
+//# sourceMappingURL=supervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../../src/local/daemon/supervisor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,MAAM,EAAqB,MAAM,iBAAiB,CAAC;AAEjE,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5E,OAAO,KAAK,EAAe,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjF,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAC3C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,eAAe,OAAQ,CAAC;AACrC,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,+DAA+D;IAC/D,WAAW,EAAE,WAAW,CAAC;IACzB,wDAAwD;IACxD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,KAAK,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,cAAc;IAgBxD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAgCtC,+EAA+E;IAC/E,WAAW,IAAI,IAAI;IAWnB,gFAAgF;IAC1E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,6DAA6D;IACvD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAYjB,WAAW;YAsBX,UAAU;IA2BxB,OAAO,CAAC,KAAK;YAwBC,WAAW;YAYX,WAAW;CAM1B"}

package/local/daemon/supervisor.js

@@ -0,0 +1,211 @@
+// The child-process supervision policy: start order, readiness gating, crash
+// restart with rapid-crash and max-restart guards, server health probing, and
+// reverse-order shutdown.
+//
+// Every side effect (spawning, time, the health probe) is injected, so this
+// whole policy is unit-testable without real processes or real waiting — the
+// property the Go daemon never had. process.ts wires this to the real host,
+// clock, Temporal, signals, and the 10s tick.
+import { SERVER_PORT } from "../constants.js";
+import { log as defaultLog } from "../../logger.js";
+import { tcpConnects } from "../net/tcp.js";
+import { removePidFile, writePidFile } from "../state/pidfile.js";
+export const MAX_RESTARTS = 5;
+export const RAPID_CRASH_WINDOW_MS = 5_000;
+export const MAX_UNHEALTHY_CHECKS = 3;
+export const GRACEFUL_STOP_TIMEOUT_MS = 5_000;
+export const SETTLE_DELAY_MS = 2_000;
+export const HEALTH_CHECK_INTERVAL_MS = 10_000;
+export class ProcessSupervisor {
+    managed;
+    host;
+    clock;
+    healthState;
+    persist;
+    log;
+    probe;
+    serverPort;
+    constructor(specs, deps) {
+        this.host = deps.host;
+        this.clock = deps.clock;
+        this.healthState = deps.healthState;
+        this.persist = deps.persist;
+        this.log = deps.log ?? defaultLog;
+        this.probe = deps.probe ?? ((port) => tcpConnects(port, "127.0.0.1", 500));
+        this.serverPort = deps.serverPort ?? SERVER_PORT;
+        this.managed = specs.map((spec) => {
+            const state = { pid: 0, state: "stopped", started_at: "", restart_count: 0 };
+            this.healthState.components[spec.name] = state;
+            return { spec, state, handle: null, unhealthyCount: 0, exitWaiter: null };
+        });
+    }
+    /**
+     * Start all components in order. A critical component that fails to start or
+     * gate aborts startup (returns failedCritical); a non-critical failure is
+     * recorded and skipped.
+     */
+    async startAll() {
+        for (const m of this.managed) {
+            this.log.info("starting component", { component: m.spec.name });
+            try {
+                this.spawn(m);
+            }
+            catch (err) {
+                m.state.state = "failed";
+                m.state.last_error = String(err);
+                this.log.error("failed to start component", { component: m.spec.name, error: String(err) });
+                if (m.spec.critical) {
+                    this.persist();
+                    return { ok: false, failedCritical: m.spec.name };
+                }
+                continue;
+            }
+            if (m.spec.gate !== undefined && m.handle !== null) {
+                try {
+                    await m.spec.gate.wait(m.handle);
+                    this.log.info("component ready", { component: m.spec.name, gate: m.spec.gate.description });
+                }
+                catch (err) {
+                    m.state.state = "failed";
+                    m.state.last_error = `not ready: ${String(err)}`;
+                    this.persist();
+                    if (m.spec.critical)
+                        return { ok: false, failedCritical: m.spec.name };
+                }
+            }
+        }
+        this.persist();
+        return { ok: true };
+    }
+    /** After a brief settle, mark any component that already crashed as failed. */
+    settleCheck() {
+        for (const m of this.managed) {
+            if (m.handle !== null && m.handle.hasExited()) {
+                m.state.state = "failed";
+                m.state.last_error = "crashed during startup";
+                this.log.error("component crashed during startup", { component: m.spec.name, pid: m.state.pid });
+            }
+        }
+        this.persist();
+    }
+    /** One health-monitor iteration: restart crashed children, probe the server. */
+    async tick() {
+        for (const m of this.managed) {
+            if (m.handle === null || m.state.state === "failed")
+                continue;
+            if (m.handle.hasExited()) {
+                this.log.warn("component exited, attempting restart", { component: m.spec.name, pid: m.state.pid });
+                await this.tryRestart(m);
+                continue;
+            }
+            if (m.spec.name === "stigmer-server") {
+                await this.probeServer(m);
+            }
+        }
+        this.persist();
+    }
+    /** Gracefully stop all components in reverse start order. */
+    async shutdown() {
+        for (let i = this.managed.length - 1; i >= 0; i -= 1) {
+            const m = this.managed[i];
+            if (m.handle === null || m.handle.hasExited())
+                continue;
+            this.log.info("stopping component", { component: m.spec.name, pid: m.state.pid });
+            await this.killAndWait(m);
+            removePidFile(m.spec.pidFile);
+            m.state.state = "stopped";
+        }
+        this.persist();
+    }
+    async probeServer(m) {
+        if (await this.probe(this.serverPort)) {
+            if (m.unhealthyCount > 0 || m.state.state === "unhealthy") {
+                m.unhealthyCount = 0;
+                m.state.state = "running";
+                m.state.last_error = undefined;
+                this.log.info("component recovered — gRPC port responding again", { component: m.spec.name });
+            }
+            return;
+        }
+        m.unhealthyCount += 1;
+        this.log.warn("gRPC port not responding", { component: m.spec.name, consecutive_failures: m.unhealthyCount });
+        if (m.unhealthyCount >= MAX_UNHEALTHY_CHECKS) {
+            this.log.error("unhealthy threshold exceeded, restarting", { component: m.spec.name });
+            await this.killAndWait(m);
+            await this.tryRestart(m);
+        }
+        else {
+            m.state.state = "unhealthy";
+            m.state.last_error = "gRPC port not responding";
+        }
+    }
+    async tryRestart(m) {
+        const startedAtMs = m.state.started_at !== "" ? Date.parse(m.state.started_at) : 0;
+        if (startedAtMs > 0 && this.clock.now() - startedAtMs < RAPID_CRASH_WINDOW_MS) {
+            m.state.state = "failed";
+            m.state.last_error = "crashed immediately after start (likely a configuration or dependency error)";
+            this.log.error("component crashed too quickly, marking failed", { component: m.spec.name });
+            return;
+        }
+        if (m.state.restart_count >= MAX_RESTARTS) {
+            m.state.state = "failed";
+            m.state.last_error = `exceeded max restarts (${MAX_RESTARTS})`;
+            this.log.error("component exceeded max restarts, marking failed", { component: m.spec.name });
+            return;
+        }
+        removePidFile(m.spec.pidFile);
+        m.state.restart_count += 1;
+        try {
+            this.spawn(m);
+            this.log.info("component restarted", { component: m.spec.name, restart_count: m.state.restart_count });
+        }
+        catch (err) {
+            m.state.state = "failed";
+            m.state.last_error = String(err);
+            this.log.error("failed to restart component", { component: m.spec.name, error: String(err) });
+        }
+    }
+    // Spawn (or respawn) one component, wiring exit/readiness and writing its PID.
+    spawn(m) {
+        const request = m.spec.resolve();
+        const handle = this.host.spawn(request);
+        m.handle = handle;
+        m.unhealthyCount = 0;
+        m.exitWaiter = new Promise((resolve) => {
+            handle.onExit(() => resolve());
+        });
+        handle.onReady(() => {
+            m.state.ready = true;
+            this.log.info("component announced readiness", { component: m.spec.name });
+        });
+        m.state.pid = handle.pid;
+        m.state.state = "running";
+        m.state.started_at = new Date(this.clock.now()).toISOString();
+        m.state.last_error = undefined;
+        if (request.readinessMarker !== undefined)
+            m.state.ready = false;
+        writePidFile(m.spec.pidFile, handle.pid);
+    }
+    // SIGTERM, wait for graceful exit, then SIGKILL as a last resort.
+    async killAndWait(m) {
+        if (m.handle === null || m.handle.hasExited())
+            return;
+        m.handle.kill("SIGTERM");
+        const timedOut = await this.raceTimeout(m.exitWaiter, GRACEFUL_STOP_TIMEOUT_MS);
+        if (timedOut && !m.handle.hasExited()) {
+            this.log.warn("graceful stop timed out, sending SIGKILL", { component: m.spec.name });
+            m.handle.kill("SIGKILL");
+            if (m.exitWaiter !== null)
+                await m.exitWaiter;
+        }
+    }
+    // Resolve false if the waiter wins, true if the timeout wins.
+    async raceTimeout(waiter, ms) {
+        if (waiter === null)
+            return false;
+        const timeout = Symbol("timeout");
+        const result = await Promise.race([waiter.then(() => undefined), this.clock.sleep(ms).then(() => timeout)]);
+        return result === timeout;
+    }
+}
+//# sourceMappingURL=supervisor.js.map

package/local/daemon/supervisor.js.map

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

package/local/daemon/types.d.ts

@@ -0,0 +1,63 @@
+/** How a child terminated. */
+export interface ExitInfo {
+    code: number | null;
+    signal: NodeJS.Signals | null;
+}
+/** A request to launch one child process. */
+export interface SpawnRequest {
+    command: string;
+    args: string[];
+    cwd?: string;
+    env: NodeJS.ProcessEnv;
+    /** Log file the child's stdout+stderr are appended to. */
+    logFile: string;
+    /** If set, the host watches stdout for this line and fires onReady once. */
+    readinessMarker?: string;
+}
+/** A live handle to a spawned child. */
+export interface ChildHandle {
+    readonly pid: number;
+    /** True once the child has terminated (and been observed). */
+    hasExited(): boolean;
+    /** Register the exit callback (invoked once). */
+    onExit(cb: (info: ExitInfo) => void): void;
+    /** Register the readiness callback (invoked once if a marker was set). */
+    onReady(cb: () => void): void;
+    /** Signal the child's process group. */
+    kill(signal: NodeJS.Signals): void;
+}
+/** Spawns child processes. The real implementation pipes + tees logs; tests
+ * substitute a fake that drives exit/readiness synthetically. */
+export interface ProcessHost {
+    spawn(request: SpawnRequest): ChildHandle;
+}
+/** Time source, injectable so policy tests run without real delays. */
+export interface Clock {
+    /** Current epoch milliseconds. */
+    now(): number;
+    /** Resolve after `ms` milliseconds. */
+    sleep(ms: number): Promise<void>;
+}
+/**
+ * Declarative description of one managed component. `resolve` is called lazily
+ * at (re)start time so binary resolution and env construction happen fresh on
+ * every attempt — matching the Go daemon's per-start `startFn`.
+ */
+export interface ComponentSpec {
+    name: string;
+    pidFile: string;
+    /** Critical components abort daemon startup if they fail to start/gate. */
+    critical: boolean;
+    /** Produce the spawn request for a (re)start. */
+    resolve(): SpawnRequest;
+    /** Optional post-spawn readiness gate (e.g. the server's gRPC port). */
+    gate?: ReadinessGate;
+}
+/** A post-spawn readiness check with its own deadline. */
+export interface ReadinessGate {
+    /** Resolves when ready; rejects if the deadline passes or the child exits. */
+    wait(handle: ChildHandle): Promise<void>;
+    /** Human description for logs/errors. */
+    description: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/local/daemon/types.ts"],"names":[],"mappings":"AAQA,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,SAAS,IAAI,OAAO,CAAC;IACrB,iDAAiD;IACjD,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3C,0EAA0E;IAC1E,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC9B,wCAAwC;IACxC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CACpC;AAED;iEACiE;AACjE,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAAC;CAC3C;AAED,uEAAuE;AACvE,MAAM,WAAW,KAAK;IACpB,kCAAkC;IAClC,GAAG,IAAI,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,OAAO,IAAI,YAAY,CAAC;IACxB,wEAAwE;IACxE,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/local/daemon/types.js

@@ -0,0 +1,9 @@
+// Shared types for the daemon supervisor and its injectable seams.
+//
+// The supervisor's restart/health policy is the part that must be exhaustively
+// testable, so every side effect it performs — spawning a process, reading the
+// clock — goes through an interface that tests can fake. The Go daemon's policy
+// is only reachable through a full integration run; this design makes it a pure
+// unit.
+export {};
+//# sourceMappingURL=types.js.map

package/local/daemon/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/local/daemon/types.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,QAAQ"}

package/local/llm-config.d.ts

@@ -0,0 +1,30 @@
+import type { Config } from "../config/config.js";
+/** LLM settings as persisted under `backend.local.llm` (snake_case = YAML keys). */
+export interface LlmSettings {
+    provider?: string;
+    model?: string;
+    api_key?: string;
+    base_url?: string;
+}
+/** The persisted LLM settings, if any. */
+export declare function readLlm(config: Config): LlmSettings | undefined;
+/**
+ * Detect a provider from API keys present in the environment (Anthropic first,
+ * then OpenAI), matching the Go CLI's `DetectProviderFromAPIKeys`.
+ */
+export declare function detectProviderFromEnv(env?: NodeJS.ProcessEnv): string;
+/** Effective provider: env override > config > API-key autodetect. */
+export declare function resolveProvider(config: Config, env?: NodeJS.ProcessEnv): string;
+/** Effective model: env override > config > provider default. */
+export declare function resolveModel(config: Config, env?: NodeJS.ProcessEnv): string;
+/** Effective API key: provider-specific env var > config. */
+export declare function resolveApiKey(config: Config, env?: NodeJS.ProcessEnv): string;
+/** Fill in provider-appropriate defaults for a partial selection. */
+export declare function withProviderDefaults(settings: LlmSettings): LlmSettings;
+/**
+ * Return a copy of `config` with the LLM section replaced, preserving every
+ * other key under `backend.local`. Passing `undefined` clears the LLM section
+ * (the wizard's "skip" path).
+ */
+export declare function setLlm(config: Config, settings: LlmSettings | undefined): Config;
+//# sourceMappingURL=llm-config.d.ts.map

package/local/llm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-config.d.ts","sourceRoot":"","sources":["../../src/local/llm-config.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwBD,0CAA0C;AAC1C,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE/D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAIlF;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAK5F;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAKzF;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAK1F;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAQvE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAQhF"}

package/local/llm-config.js

@@ -0,0 +1,93 @@
+// Typed view over the otherwise-opaque `backend.local` config section, scoped to
+// the LLM settings `setup` writes and `status` reads.
+//
+// The config module (config/config.ts) carries `backend.local` through verbatim
+// so the TS CLI never drops fields it does not model. This module adds a *typed
+// lens* for the one sub-tree T05 owns — `local.llm` — and ports the Go CLI's
+// `ResolveLLM*` precedence (env override > config file > provider default) so the
+// two CLIs agree on which provider/model is effectively in force. Writes merge
+// into a shallow copy of `local`, preserving every sibling key (temporal,
+// execution, …).
+/** Default model per provider, matching the Go setup wizard's choices. */
+const DEFAULT_MODEL = {
+    ollama: "qwen2.5-coder:7b",
+    anthropic: "claude-sonnet-4.5",
+    openai: "gpt-4",
+};
+/** Default base URL per provider (only Ollama needs one). */
+const DEFAULT_BASE_URL = {
+    ollama: "http://localhost:11434",
+};
+function localSection(config) {
+    const local = config.backend.local;
+    return local !== null && typeof local === "object" ? local : {};
+}
+/** The persisted LLM settings, if any. */
+export function readLlm(config) {
+    return localSection(config).llm;
+}
+/**
+ * Detect a provider from API keys present in the environment (Anthropic first,
+ * then OpenAI), matching the Go CLI's `DetectProviderFromAPIKeys`.
+ */
+export function detectProviderFromEnv(env = process.env) {
+    if (env.ANTHROPIC_API_KEY)
+        return "anthropic";
+    if (env.OPENAI_API_KEY)
+        return "openai";
+    return "";
+}
+/** Effective provider: env override > config > API-key autodetect. */
+export function resolveProvider(config, env = process.env) {
+    if (env.STIGMER_LLM_PROVIDER)
+        return env.STIGMER_LLM_PROVIDER;
+    const llm = readLlm(config);
+    if (llm?.provider)
+        return llm.provider;
+    return detectProviderFromEnv(env);
+}
+/** Effective model: env override > config > provider default. */
+export function resolveModel(config, env = process.env) {
+    if (env.STIGMER_LLM_MODEL)
+        return env.STIGMER_LLM_MODEL;
+    const llm = readLlm(config);
+    if (llm?.model)
+        return llm.model;
+    return DEFAULT_MODEL[resolveProvider(config, env)] ?? "";
+}
+/** Effective API key: provider-specific env var > config. */
+export function resolveApiKey(config, env = process.env) {
+    const provider = resolveProvider(config, env);
+    const envKey = provider === "anthropic" ? env.ANTHROPIC_API_KEY : provider === "openai" ? env.OPENAI_API_KEY : "";
+    if (envKey)
+        return envKey;
+    return readLlm(config)?.api_key ?? "";
+}
+/** Fill in provider-appropriate defaults for a partial selection. */
+export function withProviderDefaults(settings) {
+    const provider = settings.provider ?? "";
+    const out = { provider };
+    out.model = settings.model ?? DEFAULT_MODEL[provider];
+    if (settings.api_key)
+        out.api_key = settings.api_key;
+    const baseUrl = settings.base_url ?? DEFAULT_BASE_URL[provider];
+    if (baseUrl)
+        out.base_url = baseUrl;
+    return out;
+}
+/**
+ * Return a copy of `config` with the LLM section replaced, preserving every
+ * other key under `backend.local`. Passing `undefined` clears the LLM section
+ * (the wizard's "skip" path).
+ */
+export function setLlm(config, settings) {
+    const local = { ...localSection(config) };
+    if (settings === undefined) {
+        delete local.llm;
+    }
+    else {
+        local.llm = settings;
+    }
+    return { ...config, backend: { ...config.backend, local } };
+}
+//# sourceMappingURL=llm-config.js.map

package/local/llm-config.js.map

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

package/local/logs/tail.d.ts

@@ -0,0 +1,19 @@
+/** Return the last `n` non-empty-trailing lines of a file (all lines if n<=0). */
+export declare function tailLines(file: string, n: number): string[];
+export interface FollowHandle {
+    /** Stop polling and release resources. */
+    stop(): void;
+}
+export interface FollowOptions {
+    /** Poll interval; defaults to 200ms. */
+    pollMs?: number;
+    /** Start from byte 0 instead of the current end (emit existing content too). */
+    fromStart?: boolean;
+}
+/**
+ * Stream lines appended to `file`, invoking `onLine` per complete line. Survives
+ * rotation (inode change -> reopen from 0) and truncation (size shrink -> reset
+ * to 0). Returns a handle whose `stop()` ends the stream.
+ */
+export declare function followFile(file: string, onLine: (line: string) => void, options?: FollowOptions): FollowHandle;
+//# sourceMappingURL=tail.d.ts.map

package/local/logs/tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../../src/local/logs/tail.ts"],"names":[],"mappings":"AAYA,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAU3D;AAED,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,CAyDlH"}

package/local/logs/tail.js

@@ -0,0 +1,86 @@
+// Log tailing + following primitives, robust to the daemon's log rotation.
+//
+// Logs are bounded (rotated at daemon start), so `tailLines` reads the whole
+// file and slices — far simpler and less bug-prone than fd seeking, with no
+// meaningful cost at these sizes. `followFile` is a poll-based `tail -F`:
+// polling `stat` rather than `fs.watch` is deliberate, because `fs.watch`'s
+// rename/rotation semantics differ across platforms and silently miss events.
+// Rotation and truncation are detected by inode change and size shrink
+// respectively, and the reader reopens from the start so no lines are lost.
+import { closeSync, openSync, readFileSync, readSync, statSync } from "node:fs";
+/** Return the last `n` non-empty-trailing lines of a file (all lines if n<=0). */
+export function tailLines(file, n) {
+    let content;
+    try {
+        content = readFileSync(file, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const lines = content.split("\n");
+    if (lines.length > 0 && lines[lines.length - 1] === "")
+        lines.pop();
+    return n <= 0 ? lines : lines.slice(-n);
+}
+/**
+ * Stream lines appended to `file`, invoking `onLine` per complete line. Survives
+ * rotation (inode change -> reopen from 0) and truncation (size shrink -> reset
+ * to 0). Returns a handle whose `stop()` ends the stream.
+ */
+export function followFile(file, onLine, options = {}) {
+    const pollMs = options.pollMs ?? 200;
+    let inode = -1;
+    let offset = 0;
+    let buffer = "";
+    let started = false;
+    const drain = () => {
+        let newline;
+        while ((newline = buffer.indexOf("\n")) >= 0) {
+            onLine(buffer.slice(0, newline));
+            buffer = buffer.slice(newline + 1);
+        }
+    };
+    const tick = () => {
+        let stat;
+        try {
+            stat = statSync(file);
+        }
+        catch {
+            return; // file not created yet, or briefly gone mid-rotation
+        }
+        if (stat.ino !== inode) {
+            // First sight of the file, or it was rotated out from under us.
+            inode = stat.ino;
+            offset = started || options.fromStart === true ? 0 : stat.size;
+            buffer = "";
+        }
+        else if (stat.size < offset) {
+            offset = 0; // truncated in place
+            buffer = "";
+        }
+        started = true;
+        if (stat.size <= offset)
+            return;
+        const length = stat.size - offset;
+        const chunk = Buffer.alloc(length);
+        const fd = openSync(file, "r");
+        try {
+            readSync(fd, chunk, 0, length, offset);
+        }
+        finally {
+            closeSync(fd);
+        }
+        offset = stat.size;
+        buffer += chunk.toString("utf8");
+        drain();
+    };
+    tick();
+    const timer = setInterval(tick, pollMs);
+    timer.unref?.();
+    return {
+        stop() {
+            clearInterval(timer);
+        },
+    };
+}
+//# sourceMappingURL=tail.js.map

package/local/logs/tail.js.map

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