@made-by-moonlight/athene-cli 0.9.2

package/dist/lib/startup-preflight.js

@@ -0,0 +1,273 @@
+/**
+ * Runtime preflight checks for `athene start`.
+ *
+ * Distinct from `lib/preflight.ts` (which validates dashboard build
+ * artifacts). This module verifies system tools (git, tmux), warns about
+ * legacy storage and OpenClaw status, and applies side effects like idle
+ * sleep prevention and credential injection.
+ *
+ * Each check is exported individually for callers that need it at a
+ * specific point in the flow (e.g. `ensureGit` before clone). The
+ * top-level `runtimePreflight(config)` orchestrates the checks that
+ * `runStartup` runs once at process start.
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+import chalk from "chalk";
+import { getAoBaseDir, getDefaultRuntime, getGlobalConfigPath, inventoryHashDirs, isWindows, } from "@made-by-moonlight/athene-core";
+import { execSilent } from "./shell.js";
+import { detectOpenClawInstallation } from "./openclaw-probe.js";
+import { applyOpenClawCredentials } from "./credential-resolver.js";
+import { preventIdleSleep } from "./prevent-sleep.js";
+import { askYesNo, tryInstallWithAttempts } from "./install-helpers.js";
+function gitInstallAttempts() {
+    if (process.platform === "darwin") {
+        return [{ cmd: "brew", args: ["install", "git"], label: "brew install git" }];
+    }
+    if (process.platform === "linux") {
+        return [
+            {
+                cmd: "sudo",
+                args: ["apt-get", "install", "-y", "git"],
+                label: "sudo apt-get install -y git",
+            },
+            { cmd: "sudo", args: ["dnf", "install", "-y", "git"], label: "sudo dnf install -y git" },
+        ];
+    }
+    if (process.platform === "win32") {
+        return [
+            {
+                cmd: "winget",
+                args: ["install", "--id", "Git.Git", "-e", "--source", "winget"],
+                label: "winget install --id Git.Git -e --source winget",
+            },
+        ];
+    }
+    return [];
+}
+function gitInstallHints() {
+    if (process.platform === "darwin")
+        return ["brew install git"];
+    if (process.platform === "win32")
+        return ["winget install --id Git.Git -e --source winget"];
+    return ["sudo apt install git      # Debian/Ubuntu", "sudo dnf install git      # Fedora/RHEL"];
+}
+function tmuxInstallAttempts() {
+    if (process.platform === "darwin") {
+        return [{ cmd: "brew", args: ["install", "tmux"], label: "brew install tmux" }];
+    }
+    if (process.platform === "linux") {
+        return [
+            {
+                cmd: "sudo",
+                args: ["apt-get", "install", "-y", "tmux"],
+                label: "sudo apt-get install -y tmux",
+            },
+            { cmd: "sudo", args: ["dnf", "install", "-y", "tmux"], label: "sudo dnf install -y tmux" },
+        ];
+    }
+    return [];
+}
+function tmuxInstallHints() {
+    if (process.platform === "darwin")
+        return ["brew install tmux"];
+    if (process.platform === "win32")
+        return ["# Install WSL first, then inside WSL:", "sudo apt install tmux"];
+    return ["sudo apt install tmux      # Debian/Ubuntu", "sudo dnf install tmux      # Fedora/RHEL"];
+}
+export async function ensureGit(context) {
+    const hasGit = (await execSilent("git", ["--version"])) !== null;
+    if (hasGit)
+        return;
+    console.log(chalk.yellow(`⚠ Git is required for ${context}.`));
+    const shouldInstall = await askYesNo("Install Git now?", true, false);
+    if (shouldInstall) {
+        const installed = await tryInstallWithAttempts(gitInstallAttempts(), async () => (await execSilent("git", ["--version"])) !== null);
+        if (installed) {
+            console.log(chalk.green("  ✓ Git installed successfully"));
+            return;
+        }
+    }
+    console.error(chalk.red("\n✗ Git is required but is not installed.\n"));
+    console.log(chalk.bold("  Install Git manually, then re-run athene start:\n"));
+    for (const hint of gitInstallHints()) {
+        console.log(chalk.cyan(`    ${hint}`));
+    }
+    console.log();
+    process.exit(1);
+}
+/**
+ * On Windows, attempt to rewrite `runtime: tmux` -> `runtime: process` in the
+ * project's agent-orchestrator.yaml after asking the user. Uses a targeted
+ * line replace (not a yaml round-trip) so comments and quoting are preserved.
+ *
+ * Returns `true` on a successful rewrite. The caller is responsible for
+ * mutating the in-memory config (or reloading) so the rest of preflight
+ * sees the new runtime.
+ */
+async function offerWindowsRuntimeSwitch(configPath) {
+    console.log(chalk.yellow("\n⚠ tmux runtime is not supported on Windows."));
+    console.log(chalk.dim(`  Config: ${configPath}`));
+    console.log(chalk.dim("  AO can rewrite `runtime: tmux` -> `runtime: process` in this file.\n" +
+        "  If the file is git-tracked, you'll see this as a local change."));
+    const accept = await askYesNo("Switch this project to runtime: process?", true, false);
+    if (!accept)
+        return false;
+    let original;
+    try {
+        original = readFileSync(configPath, "utf-8");
+    }
+    catch (err) {
+        console.error(chalk.red(`  ✗ Could not read config: ${err instanceof Error ? err.message : String(err)}`));
+        return false;
+    }
+    // Match the runtime line whether quoted or unquoted, and preserve any
+    // trailing comment. Anchored multiline so we don't accidentally rewrite
+    // e.g. a string value on another line.
+    const runtimeLineRe = /^([ \t]*runtime:[ \t]*)(?:'tmux'|"tmux"|tmux)([ \t]*(?:#.*)?)$/m;
+    if (!runtimeLineRe.test(original)) {
+        console.error(chalk.red("  ✗ Could not locate `runtime: tmux` line in config; aborting rewrite."));
+        return false;
+    }
+    const rewritten = original.replace(runtimeLineRe, "$1process$2");
+    try {
+        writeFileSync(configPath, rewritten, "utf-8");
+    }
+    catch (err) {
+        console.error(chalk.red(`  ✗ Failed to write config: ${err instanceof Error ? err.message : String(err)}`));
+        return false;
+    }
+    console.log(chalk.green("  ✓ Updated runtime to process"));
+    return true;
+}
+/**
+ * Ensure tmux is available — interactive install with user consent if missing.
+ * Called from runtimePreflight() so all `athene start` paths are covered.
+ *
+ * On Windows, tmux cannot run; instead, offer to rewrite the project config
+ * to `runtime: process`. Returns `{ switchedToProcess: true }` if the rewrite
+ * succeeded so the caller can update the in-memory config.
+ */
+export async function ensureTmux(configPath) {
+    if (isWindows()) {
+        if (configPath) {
+            const switched = await offerWindowsRuntimeSwitch(configPath);
+            if (switched)
+                return { switchedToProcess: true };
+        }
+        console.error(chalk.red("\n✗ tmux runtime is not supported on Windows.\n"));
+        console.log(chalk.bold("  Set ") +
+            chalk.cyan("runtime: process") +
+            chalk.bold(" in agent-orchestrator.yaml, then re-run athene start.\n"));
+        process.exit(1);
+    }
+    const hasTmux = (await execSilent("tmux", ["-V"])) !== null;
+    if (hasTmux)
+        return { switchedToProcess: false };
+    console.log(chalk.yellow('⚠ tmux is required for runtime "tmux".'));
+    const shouldInstall = await askYesNo("Install tmux now?", true, false);
+    if (shouldInstall) {
+        const installed = await tryInstallWithAttempts(tmuxInstallAttempts(), async () => (await execSilent("tmux", ["-V"])) !== null);
+        if (installed) {
+            console.log(chalk.green("  ✓ tmux installed successfully"));
+            return { switchedToProcess: false };
+        }
+    }
+    console.error(chalk.red("\n✗ tmux is required but is not installed.\n"));
+    console.log(chalk.bold("  Install tmux manually, then re-run athene start:\n"));
+    for (const hint of tmuxInstallHints()) {
+        console.log(chalk.cyan(`    ${hint}`));
+    }
+    console.log();
+    process.exit(1);
+}
+export function warnAboutLegacyStorage() {
+    try {
+        const hashDirs = inventoryHashDirs(getAoBaseDir(), getGlobalConfigPath());
+        if (hashDirs.length === 0)
+            return;
+        const nonEmptyDirCount = hashDirs.reduce((sum, d) => {
+            if (d.empty)
+                return sum;
+            return sum + 1;
+        }, 0);
+        if (nonEmptyDirCount === 0)
+            return;
+        console.log(chalk.yellow(`\n  ⚠ Found ${nonEmptyDirCount} legacy storage director${nonEmptyDirCount === 1 ? "y" : "ies"} that need${nonEmptyDirCount === 1 ? "s" : ""} migration.\n` +
+            `    Sessions stored in the old format won't appear until migrated.\n` +
+            `    Run ${chalk.bold("athene migrate-storage")} to upgrade (use ${chalk.bold("--dry-run")} to preview).\n`));
+    }
+    catch {
+        // Non-critical — don't block startup
+    }
+}
+export async function warnAboutOpenClawStatus(config) {
+    const openclawConfig = config.notifiers?.["openclaw"];
+    const openclawConfigured = openclawConfig !== null &&
+        openclawConfig !== undefined &&
+        typeof openclawConfig === "object" &&
+        openclawConfig.plugin === "openclaw";
+    const configuredUrl = openclawConfigured && typeof openclawConfig.url === "string" ? openclawConfig.url : undefined;
+    try {
+        const installation = configuredUrl
+            ? await detectOpenClawInstallation(configuredUrl)
+            : await detectOpenClawInstallation();
+        if (openclawConfigured) {
+            if (installation.state !== "running") {
+                console.log(chalk.yellow(`⚠ OpenClaw is configured but the gateway is not reachable at ${installation.gatewayUrl}. Notifications may fail until it is running.`));
+            }
+            return;
+        }
+        if (installation.state === "running") {
+            console.log(chalk.yellow(`⚠ OpenClaw is running at ${installation.gatewayUrl} but AO is not configured to use it. Run \`athene setup openclaw\` if you want OpenClaw notifications.`));
+        }
+    }
+    catch {
+        // OpenClaw probing is advisory for `athene start`; never block startup on it.
+    }
+}
+/**
+ * Top-level orchestrator: tools + state warnings + idle-sleep + credentials.
+ * Replaces the inline preflight block in `runStartup`. Idempotent within a
+ * single process — the side effects (caffeinate spawn, env injection) latch
+ * for the lifetime of the process.
+ */
+export async function runtimePreflight(config) {
+    const runtime = config.defaults?.runtime ?? getDefaultRuntime();
+    if (runtime === "tmux") {
+        const result = await ensureTmux(config.configPath);
+        if (result.switchedToProcess) {
+            // Mutate in-memory config so the rest of startup uses the new runtime.
+            // Disk has already been updated; subsequent loadConfig() calls will
+            // see the same value.
+            const defaults = config.defaults ?? {};
+            defaults.runtime = "process";
+            config.defaults = defaults;
+        }
+    }
+    warnAboutLegacyStorage();
+    await warnAboutOpenClawStatus(config);
+    // Prevent macOS idle sleep while AO is running (if enabled in config).
+    // Uses caffeinate -i -w <pid> to hold an assertion tied to this process
+    // lifetime. No-op on non-macOS platforms.
+    if (config.power?.preventIdleSleep !== false) {
+        const sleepHandle = preventIdleSleep();
+        if (sleepHandle) {
+            console.log(chalk.dim("  Preventing macOS idle sleep while AO is running"));
+        }
+    }
+    // Only inject OpenClaw credentials when the project actually uses OpenClaw.
+    // Avoids exposing API keys to projects/plugins that don't need them.
+    const openclawNotifier = config.notifiers?.["openclaw"];
+    const hasOpenClaw = openclawNotifier !== null &&
+        openclawNotifier !== undefined &&
+        typeof openclawNotifier === "object" &&
+        openclawNotifier.plugin === "openclaw";
+    if (hasOpenClaw) {
+        const injectedKeys = applyOpenClawCredentials();
+        if (injectedKeys.length > 0) {
+            const names = injectedKeys.map((k) => k.key).join(", ");
+            console.log(chalk.dim(`  Resolved from OpenClaw config: ${names}`));
+        }
+    }
+}
+//# sourceMappingURL=startup-preflight.js.map

package/dist/lib/startup-preflight.js.map

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

package/dist/lib/update-channel-onboarding.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Update-channel onboarding helpers.
+ *
+ * On first `athene start`, prompt the user once for an `updateChannel` and persist
+ * it to ~/.agent-orchestrator/config.yaml. Never re-prompt — if they dismiss
+ * (Ctrl+C / Esc), default to `manual` so we don't surprise-install anything.
+ *
+ * Spec: release-process.html §08 (Onboarding integration).
+ */
+import { type UpdateChannel } from "@made-by-moonlight/athene-core";
+interface PromptDeps {
+    /** Test seam — defaults to the real prompt. */
+    prompt?: (message: string, options: {
+        value: UpdateChannel | "skip";
+        label: string;
+        hint?: string;
+    }[]) => Promise<UpdateChannel | "skip">;
+    /** Test seam — defaults to `isHumanCaller()`. */
+    isInteractive?: () => boolean;
+}
+/**
+ * Has the user already been asked about update channels?
+ *
+ * True when:
+ *   - The global config exists AND has `updateChannel` set.
+ *
+ * False when:
+ *   - The global config does not exist yet (first run — prompt fires immediately).
+ *   - The global config exists but `updateChannel` is unset (existing user, pre-onboarding).
+ */
+export declare function hasChosenUpdateChannel(): boolean;
+/**
+ * Persist the chosen channel to the global config.
+ *
+ * No-op when the global config doesn't exist — autoCreateConfig() handles
+ * bootstrap during first run. When the file exists but can't be parsed,
+ * falls back to a fresh default config.
+ */
+export declare function persistUpdateChannel(channel: UpdateChannel): void;
+/**
+ * Prompt the user once and persist the chosen channel.
+ *
+ * Skipped silently when:
+ *   - The choice was already made (idempotent — never re-prompts).
+ *   - The caller is not interactive (CI, scripted athene start).
+ *
+ * On dismissal, persists `manual` so we don't ask again — surprise auto-installs
+ * are worse than a quiet manual default.
+ */
+export declare function maybePromptForUpdateChannel(deps?: PromptDeps): Promise<void>;
+export {};
+//# sourceMappingURL=update-channel-onboarding.d.ts.map

package/dist/lib/update-channel-onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-channel-onboarding.d.ts","sourceRoot":"","sources":["../../src/lib/update-channel-onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AAIxC,UAAU,UAAU;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,KACvE,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,CAAC;IACrC,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAQhD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAUjE;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDtF"}

package/dist/lib/update-channel-onboarding.js

@@ -0,0 +1,107 @@
+/**
+ * Update-channel onboarding helpers.
+ *
+ * On first `athene start`, prompt the user once for an `updateChannel` and persist
+ * it to ~/.agent-orchestrator/config.yaml. Never re-prompt — if they dismiss
+ * (Ctrl+C / Esc), default to `manual` so we don't surprise-install anything.
+ *
+ * Spec: release-process.html §08 (Onboarding integration).
+ */
+import { existsSync } from "node:fs";
+import chalk from "chalk";
+import { createDefaultGlobalConfig, getGlobalConfigPath, loadGlobalConfig, saveGlobalConfig, UpdateChannelSchema, } from "@made-by-moonlight/athene-core";
+import { promptSelect } from "./prompts.js";
+import { isHumanCaller } from "./caller-context.js";
+/**
+ * Has the user already been asked about update channels?
+ *
+ * True when:
+ *   - The global config exists AND has `updateChannel` set.
+ *
+ * False when:
+ *   - The global config does not exist yet (first run — prompt fires immediately).
+ *   - The global config exists but `updateChannel` is unset (existing user, pre-onboarding).
+ */
+export function hasChosenUpdateChannel() {
+    if (!existsSync(getGlobalConfigPath()))
+        return false;
+    try {
+        const config = loadGlobalConfig();
+        return Boolean(config?.updateChannel);
+    }
+    catch {
+        return true; // Don't pester users when config can't be read.
+    }
+}
+/**
+ * Persist the chosen channel to the global config.
+ *
+ * No-op when the global config doesn't exist — autoCreateConfig() handles
+ * bootstrap during first run. When the file exists but can't be parsed,
+ * falls back to a fresh default config.
+ */
+export function persistUpdateChannel(channel) {
+    const path = getGlobalConfigPath();
+    // Don't create an empty global config here — autoCreateConfig() handles
+    // bootstrap (with project registration) during first run. Writing an empty
+    // husk poisons the dashboard, which loads the global config and finds
+    // zero projects.
+    if (!existsSync(path))
+        return;
+    const existing = loadGlobalConfig(path) ?? createDefaultGlobalConfig();
+    const next = { ...existing, updateChannel: channel };
+    saveGlobalConfig(next, path);
+}
+/**
+ * Prompt the user once and persist the chosen channel.
+ *
+ * Skipped silently when:
+ *   - The choice was already made (idempotent — never re-prompts).
+ *   - The caller is not interactive (CI, scripted athene start).
+ *
+ * On dismissal, persists `manual` so we don't ask again — surprise auto-installs
+ * are worse than a quiet manual default.
+ */
+export async function maybePromptForUpdateChannel(deps = {}) {
+    const isInteractive = deps.isInteractive ?? isHumanCaller;
+    if (!isInteractive())
+        return;
+    if (hasChosenUpdateChannel())
+        return;
+    // No global config yet — skip. autoCreateConfig() handles full bootstrap
+    // (creating the global config and registering the project) during first run.
+    // On the next `athene start` the global config will exist and the prompt fires.
+    // Skipping here avoids writing an empty husk that poisons the dashboard.
+    if (!existsSync(getGlobalConfigPath()))
+        return;
+    console.log(chalk.bold("\nHow do you want to receive updates?"));
+    console.log(chalk.dim("  Stable ships every Thursday. Nightly ships daily Fri–Tue. Manual stays put."));
+    console.log(chalk.dim("  You can switch later with `athene config set updateChannel <value>` —\n  the next `athene update` will prompt before installing the other channel's build.\n"));
+    const promptFn = deps.prompt ?? defaultPrompt;
+    let raw;
+    try {
+        raw = await promptFn("Update channel:", [
+            { value: "stable", label: "Stable — weekly releases. Recommended for most users.", hint: "@latest" },
+            { value: "nightly", label: "Nightly — daily builds. Bleeding edge.", hint: "@nightly" },
+            { value: "manual", label: "Manual — no checks. Run `athene update` yourself.", hint: "default if dismissed" },
+        ]);
+    }
+    catch {
+        raw = "manual";
+    }
+    // Never re-prompt: the absence of `updateChannel` is the signal we use to
+    // know we haven't asked yet, so even on dismissal we must persist *something*.
+    // Validate against the schema before writing — never persist `undefined` or
+    // an unrecognized string (which would corrupt the config and re-trigger
+    // every Zod parse path with `.catch(undefined)` fallbacks).
+    const candidate = raw === "skip" || raw === undefined ? "manual" : raw;
+    const parsed = UpdateChannelSchema.safeParse(candidate);
+    const channel = parsed.success ? parsed.data : "manual";
+    persistUpdateChannel(channel);
+    console.log(chalk.green(`  ✓ Update channel set to ${chalk.bold(channel)}`));
+    console.log(chalk.dim(`  Change it later with: athene config set updateChannel <stable|nightly|manual>\n`));
+}
+async function defaultPrompt(message, options) {
+    return promptSelect(message, options);
+}
+//# sourceMappingURL=update-channel-onboarding.js.map

package/dist/lib/update-channel-onboarding.js.map

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

package/dist/lib/update-check.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Shared update service — install detection, version checking, cache management.
+ *
+ * Single source of truth consumed by:
+ *   - `athene update` (install-aware routing)
+ *   - Startup notifier (synchronous cache read)
+ *   - `athene doctor` (version freshness check)
+ *   - Dashboard (`/api/version` route)
+ */
+import { isVersionOutdated as coreIsVersionOutdated, type UpdateChannel, type InstallMethodOverride } from "@made-by-moonlight/athene-core";
+export type InstallMethod = "git" | "npm-global" | "pnpm-global" | "bun-global" | "homebrew" | "unknown";
+export interface UpdateInfo {
+    currentVersion: string;
+    latestVersion: string | null;
+    isOutdated: boolean;
+    installMethod: InstallMethod;
+    recommendedCommand: string;
+    checkedAt: string | null;
+    channel: UpdateChannel;
+}
+export interface CacheData {
+    latestVersion: string;
+    checkedAt: string;
+    currentVersionAtCheck: string;
+    /**
+     * Cache scoping. The cache stores exactly one entry — entries for a
+     * different install method or channel are treated as misses, forcing a
+     * refresh against the relevant source (git fetch / npm registry).
+     */
+    installMethod?: InstallMethod;
+    channel?: UpdateChannel;
+    /** For non-git installs, derived from `isVersionOutdated(current, latest)`. */
+    isOutdated?: boolean;
+    /** For git installs, lets us cheaply detect a manual `git pull` since the last check. */
+    currentRevisionAtCheck?: string;
+    latestRevisionAtCheck?: string;
+}
+/**
+ * Resolve the user's chosen update channel from global config.
+ *
+ * Defaults to "manual" when:
+ *   - The global config does not exist yet (first run).
+ *   - The user has not set `updateChannel` (existing user, pre-onboarding).
+ *
+ * "manual" is intentionally conservative: surprise auto-installs are bad,
+ * and the onboarding flow promotes users to "stable" or "nightly" explicitly.
+ */
+export declare function resolveUpdateChannel(): UpdateChannel;
+/** Read the install-method override from global config (if any). */
+export declare function resolveInstallMethodOverride(): InstallMethodOverride | undefined;
+export declare function hasNodeModulesAncestor(resolvedPath: string): boolean;
+export declare function getCurrentRepoRoot(): string;
+export declare function isAgentOrchestratorRepoRoot(root: string): boolean;
+export declare function isAoCliPackageRoot(root: string): boolean;
+/**
+ * Classify a resolved file path as one of the known install methods.
+ *
+ * Order matters — Homebrew installs typically nest the npm tree under
+ * `/Cellar/ao/.../libexec/lib/node_modules/`, so we check for `/Cellar/ao/`
+ * BEFORE classifying as `npm-global`. Bun's global store sits under
+ * `~/.bun/install/global/` and is detected the same way.
+ */
+export declare function classifyInstallPath(resolvedPath: string): InstallMethod;
+/** Detect how the running `ao` binary was installed. Honors `installMethod` override. */
+export declare function detectInstallMethod(): InstallMethod;
+/**
+ * Resolve the currently-installed `@made-by-moonlight/athene` version.
+ *
+ * Delegates to core's `getInstalledAoVersion` (single source of truth shared
+ * with the dashboard) and falls back to the CLI's own embedded version when
+ * neither package is in `node_modules` (test/dev edge case).
+ */
+export declare function getCurrentVersion(): string;
+export interface GitUpdateTarget {
+    remote: string;
+    branch: string;
+    ref: string;
+}
+export declare function getGitUpdateTarget(): GitUpdateTarget;
+export declare function getGitUpdateRef(): string;
+/**
+ * Map an install method + channel to the command the user should run.
+ *
+ * Git installs always run `athene update` (which delegates to `athene-update.sh`)
+ * regardless of channel — the channel only affects npm-published builds.
+ *
+ * Homebrew is special: we never auto-install. We surface the brew command as
+ * a notice so the user runs it themselves — auto-running `npm install -g`
+ * inside a brew prefix overwrites brew's symlinks.
+ */
+export declare function getUpdateCommand(method: InstallMethod, channel?: UpdateChannel): string;
+/** True when the install method requires a manual user action (no auto-install). */
+export declare function isManualOnlyInstall(method: InstallMethod): boolean;
+export declare function isOutdatedForChannel(currentVersion: string, latestVersion: string, channel: UpdateChannel): boolean;
+/** Directory holding the update cache. Re-exported for athene doctor / CLI smoke tests. */
+export declare function getCacheDir(): string;
+/**
+ * Read cached update info. Returns null if missing, expired, corrupt,
+ * version-mismatched, install-method-mismatched, or channel-mismatched.
+ *
+ * The cache is keyed by both `installMethod` and `channel` because the
+ * `latestVersion` stored at each tuple is meaningfully different (stable
+ * 0.5.0 vs nightly 0.5.0-nightly-abc; git's `origin/main` ref vs npm tag).
+ */
+export declare function readCachedUpdateInfo(installMethod?: InstallMethod, channel?: UpdateChannel): CacheData | null;
+export declare function writeCache(data: CacheData): void;
+export declare function invalidateCache(): void;
+export interface GitLatestState {
+    ref: string;
+    headRevision: string;
+    latestRevision: string;
+    isBehind: boolean;
+}
+export declare function fetchGitLatestState(repoRoot?: string): Promise<GitLatestState | null>;
+/**
+ * Fetch the latest version of @made-by-moonlight/athene for the given dist-tag.
+ *
+ * Hits the full package document (not the per-tag URL) so we get all dist-tags
+ * in one round trip. Channels:
+ *   stable / manual → dist-tags.latest
+ *   nightly         → dist-tags.nightly  (falls back to latest if no nightly tag)
+ */
+export declare function fetchLatestVersion(channel?: UpdateChannel): Promise<string | null>;
+/**
+ * Check for updates, using cache when fresh and fetching when stale.
+ *
+ * Source of truth depends on install method:
+ *   - git installs        → `git fetch <remote> <branch>` + `merge-base`
+ *   - npm/pnpm/bun/...    → npm registry, dist-tags[channel]
+ *
+ * When the channel is "manual" the function still runs (so `--check` works
+ * and the dashboard can show current state) but the startup notice and the
+ * background refresh respect the channel and stay quiet.
+ */
+export declare function checkForUpdate(opts?: {
+    force?: boolean;
+    channel?: UpdateChannel;
+    installMethod?: InstallMethod;
+    repoRoot?: string;
+}): Promise<UpdateInfo>;
+/**
+ * Print an update notice to stderr if a newer version is cached.
+ *
+ * Skipped entirely when channel is "manual" — the user opted out of nudges.
+ * Stable users see "Run: athene update". Nightly users get the same nudge but
+ * the suggested install command picks `@nightly` instead of `@latest`.
+ */
+export declare function maybeShowUpdateNotice(): void;
+/**
+ * Kick off a background cache refresh. Skips entirely on `manual` channel
+ * so users who opted out don't generate any registry traffic.
+ */
+export declare function scheduleBackgroundRefresh(): void;
+/**
+ * Re-export the core implementation so CLI consumers (and the existing test
+ * suite) keep importing from this module while the dashboard imports the same
+ * function from `@made-by-moonlight/athene-core` — single source of truth for the prerelease
+ * comparison rules.
+ */
+export declare const isVersionOutdated: typeof coreIsVersionOutdated;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/lib/update-check.d.ts.map

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