@made-by-moonlight/athene-cli 0.9.2

package/dist/lib/credential-resolver.js

@@ -0,0 +1,105 @@
+/**
+ * Shared credential resolver — resolves API keys from multiple sources.
+ *
+ * Resolution order per key:
+ *   1. Environment variable (already set in process.env)
+ *   2. OpenClaw config (~/.openclaw/openclaw.json → keys section)
+ *
+ * Call `applyOpenClawCredentials()` early in CLI startup so spawned agent
+ * sessions inherit the resolved values via the parent process environment.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { recordActivityEvent } from "@made-by-moonlight/athene-core";
+/** Keys that AO agents commonly need and OpenClaw may already store. */
+const RESOLVABLE_KEYS = [
+    "ANTHROPIC_API_KEY",
+    "OPENAI_API_KEY",
+    "GITHUB_TOKEN",
+    "GOOGLE_API_KEY",
+    "OPENROUTER_API_KEY",
+];
+function readOpenClawKeys() {
+    const keys = {};
+    const configPath = join(homedir(), ".openclaw", "openclaw.json");
+    if (!existsSync(configPath))
+        return keys;
+    try {
+        const raw = readFileSync(configPath, "utf-8");
+        const config = JSON.parse(raw);
+        // OpenClaw stores keys in a top-level "keys" object:
+        //   { "keys": { "ANTHROPIC_API_KEY": "sk-ant-...", ... } }
+        const keysSection = config.keys;
+        if (keysSection && typeof keysSection === "object") {
+            for (const [k, v] of Object.entries(keysSection)) {
+                if (typeof v === "string" && v.length > 0) {
+                    keys[k] = v;
+                }
+            }
+        }
+        // Also check top-level env / environment block (some OpenClaw setups):
+        //   { "env": { "ANTHROPIC_API_KEY": "sk-ant-..." } }
+        const envSection = config.env ?? config.environment;
+        if (envSection && typeof envSection === "object") {
+            for (const [k, v] of Object.entries(envSection)) {
+                if (typeof v === "string" && v.length > 0 && !(k in keys)) {
+                    keys[k] = v;
+                }
+            }
+        }
+    }
+    catch (err) {
+        recordActivityEvent({
+            source: "cli",
+            kind: "cli.credential_load_failed",
+            level: "warn",
+            summary: `failed to read or parse ~/.openclaw/openclaw.json`,
+            data: {
+                configPath,
+                errorMessage: err instanceof Error ? err.message : String(err),
+            },
+        });
+        // Malformed config — silently skip (event surfaces it).
+    }
+    return keys;
+}
+/**
+ * Resolve a single credential from all available sources.
+ * Returns the value and where it came from, or null if not found anywhere.
+ */
+export function resolveCredential(key) {
+    const envValue = process.env[key];
+    if (envValue && envValue.length > 0) {
+        return { key, value: envValue, source: "env" };
+    }
+    const openclawKeys = readOpenClawKeys();
+    const openclawValue = openclawKeys[key];
+    if (openclawValue) {
+        return { key, value: openclawValue, source: "openclaw" };
+    }
+    return null;
+}
+/**
+ * Populate `process.env` with API keys found in OpenClaw config that are
+ * not already set in the environment. This makes them available to all
+ * spawned agent sessions (tmux inherits the parent env).
+ *
+ * Returns the list of keys that were injected from OpenClaw.
+ */
+export function applyOpenClawCredentials() {
+    const openclawKeys = readOpenClawKeys();
+    const applied = [];
+    for (const key of RESOLVABLE_KEYS) {
+        if (process.env[key] && process.env[key].length > 0)
+            continue;
+        const value = openclawKeys[key];
+        if (value) {
+            process.env[key] = value;
+            applied.push({ key, source: "openclaw" });
+        }
+    }
+    return applied;
+}
+export { RESOLVABLE_KEYS };
+//# sourceMappingURL=credential-resolver.js.map

package/dist/lib/credential-resolver.js.map

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

package/dist/lib/daemon.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Daemon attachment and lifecycle helpers.
+ *
+ * Pulls the "AO is already running" branches out of `start.ts` so the running
+ * vs. not-running fork in the entry command is a single decision point and
+ * the per-branch operations (attach, kill, dashboard cache invalidation) can
+ * be reused.
+ *
+ * Today this covers:
+ * - {@link attachToDaemon}: build a handle to an already-running daemon and
+ *   surface dashboard cache invalidation through {@link AttachedDaemon.notifyProjectChange}.
+ * - {@link killExistingDaemon}: SIGTERM -> wait -> SIGKILL the daemon and
+ *   unregister `running.json`. Used by the "Restart everything" menu option.
+ *
+ * Spawning a fresh daemon (dashboard + supervisor + register) still lives in
+ * `start.ts`'s `runStartup`. PR B's plan eventually folds that into a
+ * symmetrical `spawnDaemon` here, but doing so requires extracting last-stop
+ * restore + browser-open + shutdown-handler installation, which is out of
+ * scope for this PR.
+ */
+import { type RunningState } from "./running-state.js";
+/**
+ * Return value of `notifyProjectChange`. The daemon may be unreachable (user
+ * stopped the dashboard manually) — callers can choose to warn or throw based
+ * on whether they expect the daemon to be live.
+ */
+export type NotifyResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Handle for a daemon that was already running when this CLI invocation
+ * started. Distinguishes from a freshly-spawned daemon (which would be
+ * managed in-process by `runStartup` + `installShutdownHandlers`).
+ */
+export interface AttachedDaemon {
+    readonly outcome: "attached";
+    readonly port: number;
+    readonly pid: number;
+    /**
+     * Tell the dashboard a project was added or changed so it reloads its
+     * cached config. Returns `{ ok: false }` on any error; the dashboard might
+     * be down (user killed it manually), so callers typically warn rather than
+     * throw.
+     */
+    notifyProjectChange(): Promise<NotifyResult>;
+}
+/**
+ * Build an {@link AttachedDaemon} for an existing running daemon.
+ * Pure — does not perform any network/filesystem I/O until the returned
+ * handle's methods are called.
+ */
+export declare function attachToDaemon(running: RunningState): AttachedDaemon;
+/**
+ * Stop a running daemon synchronously: SIGTERM, wait up to 5s, SIGKILL if
+ * still alive, wait another 3s. Throws if the process refuses to die.
+ * Always unregisters `running.json` on success so the next `athene start` can
+ * spawn a fresh daemon without hitting the "already running" gate.
+ *
+ * Uses {@link killProcessTree} (not raw `process.kill`) so Windows actually
+ * terminates the daemon and its detached grandchildren (pty-host, dashboard
+ * subprocess) via `taskkill /T /F`. On POSIX this is process-group aware
+ * with a fallback to direct kill. Both paths swallow "already dead" errors
+ * internally.
+ */
+export declare function killExistingDaemon(running: RunningState): Promise<void>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/lib/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/lib/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,mBAAmB,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9C;AAiBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAOpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7E"}

package/dist/lib/daemon.js

@@ -0,0 +1,77 @@
+/**
+ * Daemon attachment and lifecycle helpers.
+ *
+ * Pulls the "AO is already running" branches out of `start.ts` so the running
+ * vs. not-running fork in the entry command is a single decision point and
+ * the per-branch operations (attach, kill, dashboard cache invalidation) can
+ * be reused.
+ *
+ * Today this covers:
+ * - {@link attachToDaemon}: build a handle to an already-running daemon and
+ *   surface dashboard cache invalidation through {@link AttachedDaemon.notifyProjectChange}.
+ * - {@link killExistingDaemon}: SIGTERM -> wait -> SIGKILL the daemon and
+ *   unregister `running.json`. Used by the "Restart everything" menu option.
+ *
+ * Spawning a fresh daemon (dashboard + supervisor + register) still lives in
+ * `start.ts`'s `runStartup`. PR B's plan eventually folds that into a
+ * symmetrical `spawnDaemon` here, but doing so requires extracting last-stop
+ * restore + browser-open + shutdown-handler installation, which is out of
+ * scope for this PR.
+ */
+import chalk from "chalk";
+import { killProcessTree, sweepDaemonChildren } from "@made-by-moonlight/athene-core";
+import { unregister, waitForExit } from "./running-state.js";
+async function postProjectsReload(port) {
+    try {
+        const res = await fetch(`http://localhost:${port}/api/projects/reload`, {
+            method: "POST",
+        });
+        if (res.ok)
+            return { ok: true };
+        return { ok: false, reason: `Dashboard reload returned ${res.status}` };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Build an {@link AttachedDaemon} for an existing running daemon.
+ * Pure — does not perform any network/filesystem I/O until the returned
+ * handle's methods are called.
+ */
+export function attachToDaemon(running) {
+    return {
+        outcome: "attached",
+        port: running.port,
+        pid: running.pid,
+        notifyProjectChange: () => postProjectsReload(running.port),
+    };
+}
+/**
+ * Stop a running daemon synchronously: SIGTERM, wait up to 5s, SIGKILL if
+ * still alive, wait another 3s. Throws if the process refuses to die.
+ * Always unregisters `running.json` on success so the next `athene start` can
+ * spawn a fresh daemon without hitting the "already running" gate.
+ *
+ * Uses {@link killProcessTree} (not raw `process.kill`) so Windows actually
+ * terminates the daemon and its detached grandchildren (pty-host, dashboard
+ * subprocess) via `taskkill /T /F`. On POSIX this is process-group aware
+ * with a fallback to direct kill. Both paths swallow "already dead" errors
+ * internally.
+ */
+export async function killExistingDaemon(running) {
+    await sweepDaemonChildren({ ownerPid: running.pid });
+    await killProcessTree(running.pid, "SIGTERM");
+    if (!(await waitForExit(running.pid, 5000))) {
+        console.log(chalk.yellow("  Process didn't exit cleanly, sending SIGKILL..."));
+        await killProcessTree(running.pid, "SIGKILL");
+        if (!(await waitForExit(running.pid, 3000))) {
+            throw new Error(`Failed to stop AO process (PID ${running.pid}). Check permissions or stop it manually.`);
+        }
+    }
+    await unregister();
+}
+//# sourceMappingURL=daemon.js.map

package/dist/lib/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/lib/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAqB,MAAM,oBAAoB,CAAC;AA2BhF,KAAK,UAAU,kBAAkB,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,sBAAsB,EAAE;YACtE,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,mBAAmB,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAqB;IAC5D,MAAM,mBAAmB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACrD,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,mDAAmD,CAAC,CAAC,CAAC;QAC/E,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,kCAAkC,OAAO,CAAC,GAAG,2CAA2C,CACzF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,UAAU,EAAE,CAAC;AACrB,CAAC"}

package/dist/lib/dashboard-rebuild.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Dashboard cache utilities — cleans stale .next artifacts, detects
+ * running dashboard processes, and rebuilds production artifacts.
+ */
+/**
+ * Check if the web directory is inside a node_modules tree (npm/yarn global install).
+ * Matches node_modules as a path segment, not just a substring.
+ */
+export declare function isInstalledUnderNodeModules(path: string): boolean;
+/**
+ * Guard: rebuilds are only possible from a source checkout.
+ * Global npm installs ship prebuilt artifacts and cannot rebuild in place.
+ */
+export declare function assertDashboardRebuildSupported(webDir: string): void;
+/**
+ * Find the PID of a process listening on the given port.
+ * Returns null if no process is found. Cross-platform via core's findPidByPort.
+ */
+export declare function findRunningDashboardPid(port: number): Promise<string | null>;
+/**
+ * Find live dashboard server PIDs serving from webDir for the given ports.
+ *
+ * On Unix we cross-check each port-listening PID's cwd against webDir so we
+ * only kill OUR dashboard. On Windows there's no cheap cwd lookup, so we
+ * fall back to "anything on these ports" — acceptable because rebuild is
+ * always invoked against a known dashboard port.
+ */
+export declare function findRunningDashboardPidsForWebDir(webDir: string, ports: readonly number[]): Promise<string[]>;
+/**
+ * Stop any live production dashboard serving from webDir before mutating .next.
+ */
+export declare function stopRunningDashboardsForWebDir(webDir: string, ports: readonly number[]): Promise<void>;
+/**
+ * Wait for a port to be free (no process listening).
+ * Throws if the port is still busy after the timeout.
+ */
+export declare function waitForPortFree(port: number, timeoutMs: number): Promise<void>;
+/**
+ * Remove the .next directory before a rebuild.
+ */
+export declare function cleanNextCache(webDir: string): Promise<void>;
+/**
+ * Compare the .next/AO_VERSION stamp against the current web package version.
+ * If they differ (or the stamp is missing), clear the .next/cache directory
+ * so Next.js doesn't serve stale pages after a version upgrade.
+ */
+export declare function clearStaleCacheIfNeeded(webDir: string): Promise<void>;
+/**
+ * Rebuild dashboard production artifacts (Next.js build + server compilation)
+ * from a source checkout. Throws if called from an npm global install.
+ */
+export declare function rebuildDashboardProductionArtifacts(webDir: string, ports?: readonly number[]): Promise<void>;
+//# sourceMappingURL=dashboard-rebuild.d.ts.map

package/dist/lib/dashboard-rebuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-rebuild.d.ts","sourceRoot":"","sources":["../../src/lib/dashboard-rebuild.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAElF;AAgBD;;;;;;;GAOG;AACH,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBnB;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUpF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlE;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC3E;AAED;;;GAGG;AACH,wBAAsB,mCAAmC,CACvD,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,SAAS,MAAM,EAAO,GAC5B,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/lib/dashboard-rebuild.js

@@ -0,0 +1,188 @@
+/**
+ * Dashboard cache utilities — cleans stale .next artifacts, detects
+ * running dashboard processes, and rebuilds production artifacts.
+ */
+import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { normalize, resolve } from "node:path";
+import ora from "ora";
+import { findPidByPort, isWindows, killProcessTree } from "@made-by-moonlight/athene-core";
+import { exec, execSilent } from "./shell.js";
+/**
+ * Check if the web directory is inside a node_modules tree (npm/yarn global install).
+ * Matches node_modules as a path segment, not just a substring.
+ */
+export function isInstalledUnderNodeModules(path) {
+    return path.includes("/node_modules/") || path.includes("\\node_modules\\");
+}
+/**
+ * Guard: rebuilds are only possible from a source checkout.
+ * Global npm installs ship prebuilt artifacts and cannot rebuild in place.
+ */
+export function assertDashboardRebuildSupported(webDir) {
+    if (isInstalledUnderNodeModules(webDir)) {
+        throw new Error("Dashboard rebuild is only available from a source checkout. " +
+            "Run `athene update`, or reinstall with `npm install -g @made-by-moonlight/athene@latest`.");
+    }
+}
+/**
+ * Find the PID of a process listening on the given port.
+ * Returns null if no process is found. Cross-platform via core's findPidByPort.
+ */
+export async function findRunningDashboardPid(port) {
+    return findPidByPort(port);
+}
+/**
+ * Find the working directory of a process. Unix only (uses lsof).
+ * Returns null on Windows or when lookup fails — callers must tolerate that.
+ */
+async function getProcessCwd(pid) {
+    if (isWindows())
+        return null;
+    const output = await execSilent("lsof", ["-a", "-p", pid, "-d", "cwd", "-Fn"]);
+    if (!output)
+        return null;
+    const cwdLine = output.split("\n").find((line) => line.startsWith("n"));
+    const cwd = cwdLine?.slice(1).trim();
+    return cwd ? normalize(cwd) : null;
+}
+/**
+ * Find live dashboard server PIDs serving from webDir for the given ports.
+ *
+ * On Unix we cross-check each port-listening PID's cwd against webDir so we
+ * only kill OUR dashboard. On Windows there's no cheap cwd lookup, so we
+ * fall back to "anything on these ports" — acceptable because rebuild is
+ * always invoked against a known dashboard port.
+ */
+export async function findRunningDashboardPidsForWebDir(webDir, ports) {
+    const expectedCwd = normalize(resolve(webDir));
+    const pids = new Set();
+    for (const port of ports) {
+        if (isWindows()) {
+            const pid = await findPidByPort(port);
+            if (pid)
+                pids.add(pid);
+            continue;
+        }
+        const output = await execSilent("lsof", ["-ti", `:${port}`, "-sTCP:LISTEN"]);
+        if (!output)
+            continue;
+        for (const rawPid of output.split("\n")) {
+            const pid = rawPid.trim();
+            if (!/^\d+$/.test(pid))
+                continue;
+            const cwd = await getProcessCwd(pid);
+            if (cwd === expectedCwd)
+                pids.add(pid);
+        }
+    }
+    return [...pids];
+}
+/**
+ * Stop any live production dashboard serving from webDir before mutating .next.
+ */
+export async function stopRunningDashboardsForWebDir(webDir, ports) {
+    const pids = await findRunningDashboardPidsForWebDir(webDir, ports);
+    if (pids.length === 0)
+        return;
+    console.log(`Stopping running dashboard${pids.length === 1 ? "" : "s"} before rebuilding .next (PID${pids.length === 1 ? "" : "s"} ${pids.join(", ")})...`);
+    for (const pid of pids) {
+        try {
+            await killProcessTree(Number(pid), "SIGTERM");
+        }
+        catch {
+            // Process already exited — that's fine.
+        }
+    }
+    for (const port of ports) {
+        await waitForPortFree(port, 5000);
+    }
+}
+/**
+ * Wait for a port to be free (no process listening).
+ * Throws if the port is still busy after the timeout.
+ */
+export async function waitForPortFree(port, timeoutMs) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        const pid = await findPidByPort(port);
+        if (!pid)
+            return;
+        await new Promise((r) => setTimeout(r, 200));
+    }
+    throw new Error(`Port ${port} still in use after ${timeoutMs}ms — old process did not exit in time`);
+}
+/**
+ * Remove the .next directory before a rebuild.
+ */
+export async function cleanNextCache(webDir) {
+    const nextDir = resolve(webDir, ".next");
+    if (existsSync(nextDir)) {
+        const spinner = ora();
+        spinner.start("Cleaning .next build cache");
+        rmSync(nextDir, { recursive: true, force: true });
+        spinner.succeed(`Cleaned .next build cache (${webDir})`);
+    }
+}
+/**
+ * Compare the .next/AO_VERSION stamp against the current web package version.
+ * If they differ (or the stamp is missing), clear the .next/cache directory
+ * so Next.js doesn't serve stale pages after a version upgrade.
+ */
+export async function clearStaleCacheIfNeeded(webDir) {
+    try {
+        const stampPath = resolve(webDir, ".next", "AO_VERSION");
+        const pkgPath = resolve(webDir, "package.json");
+        if (!existsSync(pkgPath))
+            return;
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        const currentVersion = pkg.version;
+        if (!currentVersion)
+            return;
+        let needsClear = false;
+        if (!existsSync(stampPath)) {
+            needsClear = true;
+        }
+        else {
+            const stamp = readFileSync(stampPath, "utf8").trim();
+            needsClear = stamp !== currentVersion;
+        }
+        if (needsClear) {
+            const cacheDir = resolve(webDir, ".next", "cache");
+            if (existsSync(cacheDir)) {
+                const spinner = ora();
+                spinner.start("Clearing stale Next.js cache (version upgrade detected)");
+                rmSync(cacheDir, { recursive: true, force: true });
+                spinner.succeed(`Cleared stale .next cache → v${currentVersion}`);
+            }
+            // Update stamp so subsequent starts skip the check
+            const nextDir = resolve(webDir, ".next");
+            if (existsSync(nextDir)) {
+                writeFileSync(stampPath, currentVersion, "utf8");
+            }
+        }
+    }
+    catch (err) {
+        // Best-effort cache cleanup — never prevent dashboard from starting
+        console.debug("Cache version check skipped:", err);
+    }
+}
+/**
+ * Rebuild dashboard production artifacts (Next.js build + server compilation)
+ * from a source checkout. Throws if called from an npm global install.
+ */
+export async function rebuildDashboardProductionArtifacts(webDir, ports = []) {
+    assertDashboardRebuildSupported(webDir);
+    await stopRunningDashboardsForWebDir(webDir, ports);
+    await cleanNextCache(webDir);
+    const workspaceRoot = resolve(webDir, "../..");
+    const spinner = ora("Rebuilding dashboard production artifacts").start();
+    try {
+        await exec("pnpm", ["build"], { cwd: workspaceRoot });
+        spinner.succeed("Rebuilt dashboard production artifacts");
+    }
+    catch (error) {
+        spinner.fail("Dashboard rebuild failed");
+        throw new Error("Failed to rebuild dashboard production artifacts. Run `pnpm build` and try again.", { cause: error });
+    }
+}
+//# sourceMappingURL=dashboard-rebuild.js.map

package/dist/lib/dashboard-rebuild.js.map

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

package/dist/lib/dashboard-setup.d.ts

@@ -0,0 +1,14 @@
+export interface DashboardSetupOptions {
+    limit?: string;
+    refresh?: boolean;
+    status?: boolean;
+    force?: boolean;
+    nonInteractive?: boolean;
+    routingPreset?: string;
+}
+export declare class DashboardSetupError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare function runDashboardSetupAction(opts: DashboardSetupOptions): Promise<void>;
+//# sourceMappingURL=dashboard-setup.d.ts.map

package/dist/lib/dashboard-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-setup.d.ts","sourceRoot":"","sources":["../../src/lib/dashboard-setup.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAiBD,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,QAAQ;gBADxB,OAAO,EAAE,MAAM,EACC,QAAQ,SAAI;CAK/B;AA0MD,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCxF"}