@stigmer/cli 3.0.8

package/local/temporal/inspect.js

@@ -0,0 +1,33 @@
+// Process-identity check guarding against PID reuse.
+//
+// A PID file can outlive the process it named; the OS may then assign that PID
+// to something unrelated. Before trusting a PID as "our Temporal", we confirm
+// the live process's command line actually looks like the Temporal dev server.
+// POSIX-only (uses `ps`); returns false on any uncertainty.
+import { execFileSync } from "node:child_process";
+/** Full command line of a process via `ps`, or null if it cannot be read. */
+export function processCommandLine(pid) {
+    try {
+        return execFileSync("ps", ["-p", String(pid), "-o", "command="], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return 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 function isLikelyTemporal(pid, binPath) {
+    const cmd = processCommandLine(pid);
+    if (cmd === null)
+        return false;
+    const lower = cmd.toLowerCase();
+    if (!lower.includes("temporal"))
+        return false;
+    return cmd.includes(binPath) || lower.includes("server");
+}
+//# sourceMappingURL=inspect.js.map

package/local/temporal/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../../src/local/temporal/inspect.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,4DAA4D;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE;YAC/D,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAAe;IAC3D,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC3D,CAAC"}

package/local/temporal/manager.d.ts

@@ -0,0 +1,50 @@
+export interface TemporalManagerOptions {
+    /** Path to the temporal binary (~/.stigmer/bin/temporal). */
+    binPath: string;
+    /** Temporal dev-server data directory (~/.stigmer/temporal-data). */
+    dataDir: string;
+    /** Log file the dev server's output is appended to. */
+    logFile: string;
+    /** PID file (kept for debugging; the lock is the source of truth). */
+    pidFile: string;
+    /** Single-instance lock file. */
+    lockFile: string;
+    version?: string;
+    port?: number;
+    uiPort?: number;
+}
+export declare class TemporalManager {
+    private readonly binPath;
+    private readonly dataDir;
+    private readonly logFile;
+    private readonly pidFile;
+    private readonly lockFile;
+    private readonly version;
+    private readonly port;
+    private readonly uiPort;
+    private lock;
+    constructor(options: TemporalManagerOptions);
+    /** Build a manager from the standard ~/.stigmer layout. */
+    static forHome(home?: string): TemporalManager;
+    /** host:port of the Temporal frontend. */
+    get address(): string;
+    /** PID of the running dev server, or null. */
+    getPid(): number | null;
+    /** Install the Temporal binary on demand if it is not already present. */
+    ensureInstalled(): Promise<void>;
+    /**
+     * Start the dev server. Idempotent: reuses a healthy instance, reclaims a lock
+     * left by a dead daemon, and refuses to start only when another live process
+     * holds the lock without a responding server.
+     */
+    start(): Promise<void>;
+    /** Stop the dev server gracefully (SIGTERM, then SIGKILL), releasing the lock. */
+    stop(): Promise<void>;
+    /** Layered liveness: PID present -> alive -> actually Temporal -> port open. */
+    isRunning(): Promise<boolean>;
+    private isPortInUse;
+    private finishStop;
+    private spawnServer;
+    private cleanupStaleProcesses;
+}
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/local/temporal/manager.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,IAAI,CAAyB;gBAEzB,OAAO,EAAE,sBAAsB;IAW3C,2DAA2D;IAC3D,MAAM,CAAC,OAAO,CAAC,IAAI,GAAE,MAAkB,GAAG,eAAe;IAUzD,0CAA0C;IAC1C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,8CAA8C;IAC9C,MAAM,IAAI,MAAM,GAAG,IAAI;IAIvB,0EAA0E;IACpE,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD5B,kFAAkF;IAC5E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B,gFAAgF;IAC1E,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAQnC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,qBAAqB;CAc9B"}

package/local/temporal/manager.js

@@ -0,0 +1,208 @@
+// Lifecycle manager for the local Temporal dev server.
+//
+// Faithful TS port of the Go CLI's `temporal.Manager`, reorganized around the
+// shared primitives (file lock, PID file, TCP readiness). It installs the
+// `temporal` binary on demand, starts the dev server in its own process group,
+// and answers "is it really running?" with the same layered check the Go CLI
+// uses (PID present -> alive -> actually Temporal -> port listening). Start is
+// idempotent: a healthy instance — ours or another process's — is reused.
+import { mkdirSync, openSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { spawn } from "node:child_process";
+import { log } from "../../logger.js";
+import { CliExitError } from "../../errors/cli-exit-error.js";
+import { ExitCode } from "../../errors/exit-codes.js";
+import { tcpConnects, waitForTcp } from "../net/tcp.js";
+import { binDir, logDir, temporalDataDir, temporalLockFile, temporalPidFile } from "../paths.js";
+import { TEMPORAL_PORT, TEMPORAL_UI_PORT } from "../constants.js";
+import { acquireLock } from "../state/lock.js";
+import { readPidFile, removePidFile, writePidFile } from "../state/pidfile.js";
+import { findProcessByPort, isProcessAlive, killProcessGroup } from "../state/proc.js";
+import { DEFAULT_TEMPORAL_VERSION, downloadTemporalCli, isTemporalInstalled } from "./download.js";
+import { isLikelyTemporal } from "./inspect.js";
+const READY_TIMEOUT_MS = 10_000;
+const STOP_POLL_MS = 500;
+const STOP_TIMEOUT_MS = 10_000;
+export class TemporalManager {
+    binPath;
+    dataDir;
+    logFile;
+    pidFile;
+    lockFile;
+    version;
+    port;
+    uiPort;
+    lock = null;
+    constructor(options) {
+        this.binPath = options.binPath;
+        this.dataDir = options.dataDir;
+        this.logFile = options.logFile;
+        this.pidFile = options.pidFile;
+        this.lockFile = options.lockFile;
+        this.version = options.version ?? DEFAULT_TEMPORAL_VERSION;
+        this.port = options.port ?? TEMPORAL_PORT;
+        this.uiPort = options.uiPort ?? TEMPORAL_UI_PORT;
+    }
+    /** Build a manager from the standard ~/.stigmer layout. */
+    static forHome(home = homedir()) {
+        return new TemporalManager({
+            binPath: join(binDir(home), "temporal"),
+            dataDir: temporalDataDir(home),
+            logFile: join(logDir(home), "temporal.log"),
+            pidFile: temporalPidFile(home),
+            lockFile: temporalLockFile(home),
+        });
+    }
+    /** host:port of the Temporal frontend. */
+    get address() {
+        return `127.0.0.1:${this.port}`;
+    }
+    /** PID of the running dev server, or null. */
+    getPid() {
+        return readPidFile(this.pidFile);
+    }
+    /** Install the Temporal binary on demand if it is not already present. */
+    async ensureInstalled() {
+        if (isTemporalInstalled(this.binPath)) {
+            log.debug("temporal CLI already installed", { path: this.binPath });
+            return;
+        }
+        log.info("downloading Temporal CLI", { version: this.version });
+        await downloadTemporalCli({ version: this.version, binPath: this.binPath });
+        log.info("Temporal CLI installed", { path: this.binPath });
+    }
+    /**
+     * Start the dev server. Idempotent: reuses a healthy instance, reclaims a lock
+     * left by a dead daemon, and refuses to start only when another live process
+     * holds the lock without a responding server.
+     */
+    async start() {
+        if (await this.isRunning()) {
+            log.info("Temporal already running and healthy — reusing", { address: this.address });
+            return;
+        }
+        // A lock we still hold means Temporal died under us; drop it so we can
+        // re-acquire cleanly.
+        if (this.lock !== null) {
+            log.info("releasing stale Temporal lock (server died while we held it)");
+            this.lock.release();
+            this.lock = null;
+            removePidFile(this.pidFile);
+        }
+        this.cleanupStaleProcesses();
+        const lock = acquireLock(this.lockFile);
+        if (lock === null) {
+            // Another live process owns the lock. If its server answers, reuse it;
+            // otherwise we cannot safely start a competing instance.
+            if (await this.isPortInUse()) {
+                log.info("Temporal lock held by another process and port is active — reusing");
+                return;
+            }
+            throw new CliExitError("Temporal lock held by another process but the service is not responding", ExitCode.General);
+        }
+        this.lock = lock;
+        try {
+            await this.ensureInstalled();
+            mkdirSync(this.dataDir, { recursive: true });
+            mkdirSync(dirname(this.logFile), { recursive: true });
+            const pid = this.spawnServer();
+            writePidFile(this.pidFile, pid);
+            log.info("Temporal dev server started", { pid, port: this.port });
+            await waitForTcp({ port: this.port, timeoutMs: READY_TIMEOUT_MS, label: "temporal dev server" });
+            log.info("Temporal is ready", { address: this.address });
+        }
+        catch (err) {
+            const pid = this.getPid();
+            if (pid !== null)
+                killProcessGroup(pid, "SIGKILL");
+            removePidFile(this.pidFile);
+            this.lock?.release();
+            this.lock = null;
+            throw err;
+        }
+    }
+    /** Stop the dev server gracefully (SIGTERM, then SIGKILL), releasing the lock. */
+    async stop() {
+        const pid = this.getPid();
+        if (pid === null) {
+            this.lock?.release();
+            this.lock = null;
+            return;
+        }
+        killProcessGroup(pid, "SIGTERM");
+        log.info("sent SIGTERM to Temporal process group", { pid });
+        const deadline = Date.now() + STOP_TIMEOUT_MS;
+        while (Date.now() < deadline) {
+            if (!(await this.isRunning())) {
+                this.finishStop();
+                log.info("Temporal stopped");
+                return;
+            }
+            await sleep(STOP_POLL_MS);
+        }
+        log.warn("Temporal did not stop gracefully — force killing process group", { pid });
+        killProcessGroup(pid, "SIGKILL");
+        this.finishStop();
+    }
+    /** Layered liveness: PID present -> alive -> actually Temporal -> port open. */
+    async isRunning() {
+        const pid = this.getPid();
+        if (pid === null)
+            return false;
+        if (!isProcessAlive(pid))
+            return false;
+        if (!isLikelyTemporal(pid, this.binPath))
+            return false;
+        return this.isPortInUse();
+    }
+    isPortInUse() {
+        return tcpConnects(this.port, "127.0.0.1", 100);
+    }
+    finishStop() {
+        removePidFile(this.pidFile);
+        this.lock?.release();
+        this.lock = null;
+    }
+    // Start the dev server detached in its own process group so the whole tree can
+    // later be signaled, with output appended to the Temporal log file.
+    spawnServer() {
+        const out = openSync(this.logFile, "a");
+        const child = spawn(this.binPath, [
+            "server",
+            "start-dev",
+            "--port",
+            String(this.port),
+            "--db-filename",
+            join(this.dataDir, "temporal.db"),
+            "--ui-port",
+            String(this.uiPort),
+            "--log-format",
+            "json",
+        ], { detached: true, stdio: ["ignore", out, out] });
+        child.unref();
+        if (child.pid === undefined) {
+            throw new CliExitError("failed to start Temporal process", ExitCode.General);
+        }
+        return child.pid;
+    }
+    // Remove a stale PID file, or kill an orphaned Temporal occupying our port.
+    cleanupStaleProcesses() {
+        const pid = this.getPid();
+        if (pid !== null) {
+            if (!isProcessAlive(pid) || !isLikelyTemporal(pid, this.binPath)) {
+                removePidFile(this.pidFile);
+            }
+            return;
+        }
+        const orphan = findProcessByPort(this.port);
+        if (orphan !== null && isLikelyTemporal(orphan, this.binPath)) {
+            log.warn("killing orphaned Temporal found via port", { pid: orphan, port: this.port });
+            killProcessGroup(orphan, "SIGKILL");
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=manager.js.map

package/local/temporal/manager.js.map

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

package/local/temporal/supervisor.d.ts

@@ -0,0 +1,34 @@
+import { type Logger } from "../../logger.js";
+/** The minimal surface the supervisor drives. TemporalManager satisfies it. */
+export interface SupervisedTarget {
+    isRunning(): Promise<boolean>;
+    start(): Promise<void>;
+}
+export interface SupervisorOptions {
+    intervalMs?: number;
+    backoffMs?: number;
+    /** Injectable sleep, for deterministic tests. */
+    sleep?: (ms: number) => Promise<void>;
+    log?: Logger;
+}
+export declare class TemporalSupervisor {
+    private readonly target;
+    private readonly intervalMs;
+    private readonly backoffMs;
+    private readonly sleep;
+    private readonly log;
+    private timer;
+    private stopped;
+    private ticking;
+    constructor(target: SupervisedTarget, options?: SupervisorOptions);
+    /** Begin monitoring. Returns immediately; the loop runs on a timer. */
+    start(): void;
+    /** Stop monitoring. Safe to call multiple times. */
+    stop(): void;
+    /**
+     * One health check + conditional restart. Public for unit testing: it is the
+     * whole supervision policy, exercised without real timers.
+     */
+    checkHealthAndRestart(): Promise<void>;
+}
+//# sourceMappingURL=supervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../../src/local/temporal/supervisor.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,MAAM,EAAqB,MAAM,iBAAiB,CAAC;AAKjE,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE,iBAAsB;IAQrE,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAYb,oDAAoD;IACpD,IAAI,IAAI,IAAI;IASZ;;;OAGG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB7C"}

package/local/temporal/supervisor.js

@@ -0,0 +1,83 @@
+// Self-healing supervisor for the Temporal dev server.
+//
+// On a fixed interval it asks "is Temporal healthy?" and, if not, restarts it
+// via the idempotent start path (which reuses healthy instances and cleans up
+// stale ones). This is intentionally separate from the daemon's child
+// supervisor: Temporal owns its own lifecycle and lock, so it carries its own
+// watchdog — exactly the split the Go CLI uses.
+//
+// The check and backoff are dependency-injected (clock) so the policy is unit-
+// testable without real time, and the loop never overlaps with itself.
+import { log as defaultLog } from "../../logger.js";
+const DEFAULT_INTERVAL_MS = 5_000;
+const DEFAULT_BACKOFF_MS = 1_000;
+export class TemporalSupervisor {
+    target;
+    intervalMs;
+    backoffMs;
+    sleep;
+    log;
+    timer = null;
+    stopped = false;
+    ticking = false;
+    constructor(target, options = {}) {
+        this.target = target;
+        this.intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+        this.backoffMs = options.backoffMs ?? DEFAULT_BACKOFF_MS;
+        this.sleep = options.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+        this.log = options.log ?? defaultLog;
+    }
+    /** Begin monitoring. Returns immediately; the loop runs on a timer. */
+    start() {
+        if (this.timer !== null)
+            return;
+        this.stopped = false;
+        this.log.info("starting Temporal supervisor", { interval_ms: this.intervalMs });
+        const tick = () => {
+            void this.checkHealthAndRestart().finally(() => {
+                if (!this.stopped)
+                    this.timer = setTimeout(tick, this.intervalMs);
+            });
+        };
+        this.timer = setTimeout(tick, this.intervalMs);
+    }
+    /** Stop monitoring. Safe to call multiple times. */
+    stop() {
+        this.stopped = true;
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.log.info("stopping Temporal supervisor");
+    }
+    /**
+     * One health check + conditional restart. Public for unit testing: it is the
+     * whole supervision policy, exercised without real timers.
+     */
+    async checkHealthAndRestart() {
+        if (this.ticking)
+            return; // never overlap a previous tick
+        this.ticking = true;
+        try {
+            if (await this.target.isRunning()) {
+                this.log.debug("Temporal health check passed");
+                return;
+            }
+            this.log.warn("Temporal health check failed — attempting restart");
+            await this.sleep(this.backoffMs);
+            if (this.stopped)
+                return; // bailed out during backoff
+            try {
+                await this.target.start();
+                this.log.info("Temporal restarted");
+            }
+            catch (err) {
+                this.log.error("failed to restart Temporal — will retry next check", { error: String(err) });
+            }
+        }
+        finally {
+            this.ticking = false;
+        }
+    }
+}
+//# sourceMappingURL=supervisor.js.map

package/local/temporal/supervisor.js.map

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

package/local/webconsole/index.d.ts

@@ -0,0 +1,4 @@
+/** Whether an embedded web console is available to serve. Always false until
+ * T06 wires asset bundling + an HTTP handler. */
+export declare function isWebConsoleAvailable(): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local/webconsole/index.ts"],"names":[],"mappings":"AAQA;iDACiD;AACjD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/local/webconsole/index.js

@@ -0,0 +1,13 @@
+// Embedded web-console availability.
+//
+// The Go CLI embeds the console's static assets via go:embed and serves them on
+// :8234. There is no TS equivalent bundled in T05, so the daemon detects the
+// console as unavailable and skips it cleanly (recording a "stopped" state),
+// exactly as the Go daemon does when built without assets. Real serving — and
+// the asset-bundling decision behind it — is deferred to T06.
+/** Whether an embedded web console is available to serve. Always false until
+ * T06 wires asset bundling + an HTTP handler. */
+export function isWebConsoleAvailable() {
+    return false;
+}
+//# sourceMappingURL=index.js.map

package/local/webconsole/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/local/webconsole/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,8DAA8D;AAE9D;iDACiD;AACjD,MAAM,UAAU,qBAAqB;IACnC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/logger.d.ts

@@ -0,0 +1,13 @@
+export declare const log: {
+    /** Emit a diagnostic line; a no-op unless `--debug` is active. */
+    debug(msg: string, fields?: Record<string, unknown>): void;
+    /** Emit an informational line (always). */
+    info(msg: string, fields?: Record<string, unknown>): void;
+    /** Emit a warning line (always). */
+    warn(msg: string, fields?: Record<string, unknown>): void;
+    /** Emit an error line (always). */
+    error(msg: string, fields?: Record<string, unknown>): void;
+};
+/** The logger interface, for dependency injection in tests. */
+export type Logger = typeof log;
+//# sourceMappingURL=logger.d.ts.map

package/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,GAAG;IACd,kEAAkE;eACvD,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG1D,2CAA2C;cACjC,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAGzD,oCAAoC;cAC1B,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAGzD,mCAAmC;eACxB,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG3D,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC"}

package/logger.js

@@ -0,0 +1,35 @@
+// Diagnostic logger for the CLI. Writes only to stderr so structured command
+// output on stdout stays clean for piping. `debug` is silent unless `--debug`
+// is set, so scripts never see diagnostics on the happy path; `info`/`warn`/
+// `error` always emit, which is what the supervised daemon relies on to record
+// its lifecycle into daemon.log (its stderr is redirected there).
+import { isDebug } from "./runtime.js";
+function emit(level, msg, fields) {
+    const suffix = fields
+        ? " " +
+            Object.entries(fields)
+                .map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`)
+                .join(" ")
+        : "";
+    process.stderr.write(`${level} ${msg}${suffix}\n`);
+}
+export const log = {
+    /** Emit a diagnostic line; a no-op unless `--debug` is active. */
+    debug(msg, fields) {
+        if (isDebug())
+            emit("debug", msg, fields);
+    },
+    /** Emit an informational line (always). */
+    info(msg, fields) {
+        emit("info", msg, fields);
+    },
+    /** Emit a warning line (always). */
+    warn(msg, fields) {
+        emit("warn", msg, fields);
+    },
+    /** Emit an error line (always). */
+    error(msg, fields) {
+        emit("error", msg, fields);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,kEAAkE;AAElE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,SAAS,IAAI,CAAC,KAAa,EAAE,GAAW,EAAE,MAAgC;IACxE,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAC,GAAG;YACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;iBACnB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxE,IAAI,CAAC,GAAG,CAAC;QACd,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,kEAAkE;IAClE,KAAK,CAAC,GAAW,EAAE,MAAgC;QACjD,IAAI,OAAO,EAAE;YAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,2CAA2C;IAC3C,IAAI,CAAC,GAAW,EAAE,MAAgC;QAChD,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IACD,oCAAoC;IACpC,IAAI,CAAC,GAAW,EAAE,MAAgC;QAChD,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IACD,mCAAmC;IACnC,KAAK,CAAC,GAAW,EAAE,MAAgC;QACjD,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}

package/output/command-result.d.ts

@@ -0,0 +1,47 @@
+import type { OutputFormat } from "./format.js";
+export type ResultStatus = "success" | "warning" | "error";
+export interface KeyValue {
+    readonly key: string;
+    readonly value: string;
+}
+/** A group of related fields/items under an optional title. */
+export declare class Section {
+    readonly title: string;
+    readonly fields: KeyValue[];
+    readonly items: string[];
+    constructor(title: string);
+    field(key: string, value: string): this;
+    item(text: string): this;
+}
+/** The structured outcome of a command. Build via the static factories. */
+export declare class CommandResult {
+    readonly status: ResultStatus;
+    readonly message: string;
+    readonly sections: Section[];
+    readonly hints: string[];
+    private constructor();
+    static success(message: string): CommandResult;
+    static warning(message: string): CommandResult;
+    static error(message: string): CommandResult;
+    addSection(title?: string): Section;
+    hint(text: string): this;
+}
+/** JSON form of a CommandResult (omits empty sections/hints), newline-terminated. */
+export declare function resultToJson(result: CommandResult): string;
+/** Colored, structured human form, newline-terminated. */
+export declare function resultToHuman(result: CommandResult, colorize: boolean): string;
+/** Status line only — for scripting where pass/fail is all that matters. */
+export declare function resultToQuiet(result: CommandResult, colorize: boolean): string;
+/** A pair of writable streams; defaults to the process std streams. */
+export interface ResultStreams {
+    readonly stdout: {
+        write(chunk: string): unknown;
+    };
+    readonly stderr: {
+        write(chunk: string): unknown;
+        isTTY?: boolean;
+    };
+}
+/** Render a CommandResult to the appropriate stream for the resolved format. */
+export declare function renderResult(result: CommandResult, format: OutputFormat, streams?: ResultStreams): void;
+//# sourceMappingURL=command-result.d.ts.map

package/output/command-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-result.d.ts","sourceRoot":"","sources":["../../src/output/command-result.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,qBAAa,OAAO;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAM;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;gBAElB,KAAK,EAAE,MAAM;IAIzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAIzB;AAED,2EAA2E;AAC3E,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAM;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAE9B,OAAO;IAKP,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAI9C,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAI9C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAI5C,UAAU,CAAC,KAAK,SAAK,GAAG,OAAO;IAM/B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAIzB;AAqBD,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAkB1D;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAyB9E;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAE9E;AAeD,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACrE;AAID,gFAAgF;AAChF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,aAA+B,GACvC,IAAI,CAUN"}