@made-by-moonlight/athene-cli 0.9.2

package/dist/lib/update-check.js

@@ -0,0 +1,504 @@
+/**
+ * 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 { execFile, execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import { getInstalledAoVersion, getUpdateCheckCachePath, isVersionOutdatedForChannel as coreIsVersionOutdatedForChannel, isVersionOutdated as coreIsVersionOutdated, loadGlobalConfig, } from "@made-by-moonlight/athene-core";
+import { getCliVersion } from "../options/version.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Full package document — includes `dist-tags` for channel resolution. */
+const REGISTRY_PACKAGE_URL = "https://registry.npmjs.org/@made-by-moonlight%2Fathene";
+const FETCH_TIMEOUT_MS = 3000;
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const DEFAULT_GIT_REMOTE = "origin";
+const DEFAULT_GIT_BRANCH = "main";
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Channel resolution
+// ---------------------------------------------------------------------------
+/**
+ * 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 function resolveUpdateChannel() {
+    try {
+        const config = loadGlobalConfig();
+        return config?.updateChannel ?? "manual";
+    }
+    catch {
+        return "manual";
+    }
+}
+/** Read the install-method override from global config (if any). */
+export function resolveInstallMethodOverride() {
+    try {
+        const config = loadGlobalConfig();
+        return config?.installMethod;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ---------------------------------------------------------------------------
+// Install detection
+// ---------------------------------------------------------------------------
+export function hasNodeModulesAncestor(resolvedPath) {
+    return resolvedPath.includes("/node_modules/") || resolvedPath.includes("\\node_modules\\");
+}
+function readPackageName(packageJsonPath) {
+    try {
+        const raw = readFileSync(packageJsonPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return typeof parsed.name === "string" ? parsed.name : null;
+    }
+    catch {
+        return null;
+    }
+}
+function getSourceRepoRoot(resolvedPath) {
+    return resolve(dirname(resolvedPath), "../../../../");
+}
+export function getCurrentRepoRoot() {
+    return getSourceRepoRoot(fileURLToPath(import.meta.url));
+}
+export function isAgentOrchestratorRepoRoot(root) {
+    if (!existsSync(resolve(root, ".git"))) {
+        return false;
+    }
+    return readPackageName(resolve(root, "packages", "ao", "package.json")) === "@made-by-moonlight/athene";
+}
+export function isAoCliPackageRoot(root) {
+    if (!existsSync(resolve(root, "dist", "index.js"))) {
+        return false;
+    }
+    return readPackageName(resolve(root, "package.json")) === "@made-by-moonlight/athene-cli";
+}
+/**
+ * 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 function classifyInstallPath(resolvedPath) {
+    // Homebrew installs of the `ao` formula land under /Cellar/ao/<version>/.
+    // Detect this BEFORE the generic node_modules walk, because brew installs
+    // also live under .../lib/node_modules/. We don't auto-install for brew —
+    // that would clobber the symlinks brew owns.
+    if (resolvedPath.includes("/Cellar/ao/") || resolvedPath.includes("\\Cellar\\ao\\")) {
+        return "homebrew";
+    }
+    // Bun's global install layout: ~/.bun/install/global/node_modules/...
+    if (resolvedPath.includes("/.bun/install/global/") ||
+        resolvedPath.includes("\\.bun\\install\\global\\")) {
+        return "bun-global";
+    }
+    if (hasNodeModulesAncestor(resolvedPath)) {
+        const isPnpmGlobal = resolvedPath.includes("/pnpm/global/") || resolvedPath.includes("\\pnpm\\global\\");
+        if (isPnpmGlobal)
+            return "pnpm-global";
+        const isNpmGlobal = resolvedPath.includes("/lib/node_modules/") || resolvedPath.includes("\\lib\\node_modules\\");
+        if (isNpmGlobal)
+            return "npm-global";
+        return "unknown";
+    }
+    // Running from a source checkout → git install
+    // Walk up from packages/cli/dist/lib/ (or src/lib/) to repo root
+    const repoRoot = getSourceRepoRoot(resolvedPath);
+    if (isAgentOrchestratorRepoRoot(repoRoot)) {
+        return "git";
+    }
+    return "unknown";
+}
+/** Detect how the running `ao` binary was installed. Honors `installMethod` override. */
+export function detectInstallMethod() {
+    const override = resolveInstallMethodOverride();
+    if (override)
+        return override;
+    return classifyInstallPath(fileURLToPath(import.meta.url));
+}
+// ---------------------------------------------------------------------------
+// Version
+// ---------------------------------------------------------------------------
+/**
+ * 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 function getCurrentVersion() {
+    const fromCore = getInstalledAoVersion();
+    if (fromCore !== "0.0.0")
+        return fromCore;
+    return getCliVersion();
+}
+export function getGitUpdateTarget() {
+    const remote = process.env["AO_UPDATE_GIT_REMOTE"] || DEFAULT_GIT_REMOTE;
+    const branch = process.env["AO_UPDATE_GIT_BRANCH"] || DEFAULT_GIT_BRANCH;
+    return { remote, branch, ref: `${remote}/${branch}` };
+}
+export function getGitUpdateRef() {
+    return getGitUpdateTarget().ref;
+}
+// ---------------------------------------------------------------------------
+// Update command mapping
+// ---------------------------------------------------------------------------
+/**
+ * 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 function getUpdateCommand(method, channel = "stable") {
+    // "manual" channel maps to "stable" for the install command — the channel
+    // affects when we check, not which tag manual installers should pick.
+    const tag = channel === "nightly" ? "nightly" : "latest";
+    switch (method) {
+        case "git":
+            return "athene update";
+        case "npm-global":
+            return `npm install -g @made-by-moonlight/athene@${tag}`;
+        case "pnpm-global":
+            return `pnpm add -g @made-by-moonlight/athene@${tag}`;
+        case "bun-global":
+            return `bun add -g @made-by-moonlight/athene@${tag}`;
+        case "homebrew":
+            return "brew upgrade ao";
+        case "unknown":
+            return `npm install -g @made-by-moonlight/athene@${tag}`;
+    }
+}
+/** True when the install method requires a manual user action (no auto-install). */
+export function isManualOnlyInstall(method) {
+    return method === "homebrew";
+}
+export function isOutdatedForChannel(currentVersion, latestVersion, channel) {
+    return coreIsVersionOutdatedForChannel(currentVersion, latestVersion, channel);
+}
+// ---------------------------------------------------------------------------
+// Cache
+// ---------------------------------------------------------------------------
+/** Directory holding the update cache. Re-exported for athene doctor / CLI smoke tests. */
+export function getCacheDir() {
+    // dirname(getUpdateCheckCachePath()) keeps this in lock-step with core's
+    // canonical path resolver.
+    return dirname(getUpdateCheckCachePath());
+}
+function getCachePath() {
+    return getUpdateCheckCachePath();
+}
+/**
+ * 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 function readCachedUpdateInfo(installMethod = detectInstallMethod(), channel) {
+    try {
+        const raw = readFileSync(getCachePath(), "utf-8");
+        const data = JSON.parse(raw);
+        if (!data.latestVersion || !data.checkedAt)
+            return null;
+        // Legacy cache entries predate install-method scoping — treat as unsafe.
+        if (!data.installMethod)
+            return null;
+        if (data.installMethod !== installMethod)
+            return null;
+        // Channel scoping. When the caller passes an explicit channel, the cache
+        // entry MUST advertise its own channel and that channel MUST match. A
+        // legacy entry without a `channel` field (written before channel scoping
+        // landed) is treated as a miss — otherwise a stable→nightly switch would
+        // keep returning the pre-switch latestVersion until the TTL expired.
+        if (channel) {
+            if (!data.channel)
+                return null;
+            if (data.channel !== channel)
+                return null;
+        }
+        // Cache is stale if user upgraded since the check
+        const currentVersion = getCurrentVersion();
+        if (data.currentVersionAtCheck && data.currentVersionAtCheck !== currentVersion) {
+            return null;
+        }
+        if (installMethod === "git" && data.currentRevisionAtCheck) {
+            try {
+                if (runGit(["rev-parse", "HEAD"], getCurrentRepoRoot()) !== data.currentRevisionAtCheck) {
+                    return null;
+                }
+            }
+            catch {
+                return null;
+            }
+        }
+        // Cache expired
+        const age = Date.now() - new Date(data.checkedAt).getTime();
+        if (age > CACHE_TTL_MS)
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeCache(data) {
+    try {
+        const dir = getCacheDir();
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(getCachePath(), JSON.stringify(data, null, 2));
+    }
+    catch {
+        // Best-effort — don't crash if cache dir is unwritable
+    }
+}
+export function invalidateCache() {
+    try {
+        unlinkSync(getCachePath());
+    }
+    catch {
+        // File might not exist — that's fine
+    }
+}
+function runGit(args, cwd) {
+    return execFileSync("git", args, {
+        cwd,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"],
+    }).trim();
+}
+export async function fetchGitLatestState(repoRoot = getCurrentRepoRoot()) {
+    try {
+        const { remote, branch, ref } = getGitUpdateTarget();
+        await execFileAsync("git", ["fetch", remote, branch], { cwd: repoRoot });
+        const headRevision = runGit(["rev-parse", "HEAD"], repoRoot);
+        const latestRevision = runGit(["rev-parse", ref], repoRoot);
+        let isBehind = false;
+        try {
+            runGit(["merge-base", "--is-ancestor", "HEAD", ref], repoRoot);
+            isBehind = headRevision !== latestRevision;
+        }
+        catch {
+            isBehind = false;
+        }
+        return { ref, headRevision, latestRevision, isBehind };
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Registry fetch
+// ---------------------------------------------------------------------------
+/**
+ * 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 async function fetchLatestVersion(channel = "stable") {
+    try {
+        const response = await fetch(REGISTRY_PACKAGE_URL, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            headers: { Accept: "application/json" },
+        });
+        if (!response.ok)
+            return null;
+        const data = (await response.json());
+        const tags = data["dist-tags"];
+        if (!tags || typeof tags !== "object")
+            return null;
+        const tag = channel === "nightly" ? "nightly" : "latest";
+        const value = tags[tag];
+        if (typeof value === "string")
+            return value;
+        // Nightly tag missing? Fall back to latest so the dashboard isn't broken
+        // before the first nightly publishes.
+        if (tag === "nightly" && typeof tags["latest"] === "string") {
+            return tags["latest"];
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Orchestrator
+// ---------------------------------------------------------------------------
+/**
+ * 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 async function checkForUpdate(opts) {
+    const channel = opts?.channel ?? resolveUpdateChannel();
+    const currentVersion = getCurrentVersion();
+    const installMethod = opts?.installMethod ?? detectInstallMethod();
+    const recommendedCommand = getUpdateCommand(installMethod, channel);
+    if (!opts?.force) {
+        const cached = readCachedUpdateInfo(installMethod, channel);
+        if (cached) {
+            return {
+                currentVersion,
+                latestVersion: cached.latestVersion,
+                isOutdated: cached.installMethod === "git"
+                    ? cached.isOutdated === true
+                    : isOutdatedForChannel(currentVersion, cached.latestVersion, channel),
+                installMethod,
+                recommendedCommand,
+                checkedAt: cached.checkedAt,
+                channel,
+            };
+        }
+    }
+    const now = new Date().toISOString();
+    if (installMethod === "git") {
+        const gitState = await fetchGitLatestState(opts?.repoRoot);
+        if (gitState) {
+            writeCache({
+                latestVersion: gitState.ref,
+                checkedAt: now,
+                currentVersionAtCheck: currentVersion,
+                installMethod,
+                channel,
+                isOutdated: gitState.isBehind,
+                currentRevisionAtCheck: gitState.headRevision,
+                latestRevisionAtCheck: gitState.latestRevision,
+            });
+        }
+        return {
+            currentVersion,
+            latestVersion: gitState?.ref ?? null,
+            isOutdated: gitState?.isBehind ?? false,
+            installMethod,
+            recommendedCommand,
+            checkedAt: gitState ? now : null,
+            channel,
+        };
+    }
+    // npm/pnpm/bun/unknown installs use the npm registry as their update channel.
+    const latestVersion = await fetchLatestVersion(channel);
+    if (latestVersion) {
+        writeCache({
+            latestVersion,
+            checkedAt: now,
+            currentVersionAtCheck: currentVersion,
+            installMethod,
+            channel,
+            isOutdated: isOutdatedForChannel(currentVersion, latestVersion, channel),
+        });
+    }
+    return {
+        currentVersion,
+        latestVersion,
+        isOutdated: latestVersion
+            ? isOutdatedForChannel(currentVersion, latestVersion, channel)
+            : false,
+        installMethod,
+        recommendedCommand,
+        checkedAt: latestVersion ? now : null,
+        channel,
+    };
+}
+// ---------------------------------------------------------------------------
+// Startup notifier (synchronous, cache-only)
+// ---------------------------------------------------------------------------
+/**
+ * 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 function maybeShowUpdateNotice() {
+    if (!process.stderr.isTTY)
+        return;
+    if (process.env["AO_NO_UPDATE_NOTIFIER"] === "1")
+        return;
+    if (process.env["CI"] || process.env["AGENT_ORCHESTRATOR_CI"])
+        return;
+    const skipArgs = ["update", "doctor", "--version", "-V", "--help", "-h"];
+    if (process.argv.some((arg) => skipArgs.includes(arg)))
+        return;
+    const channel = resolveUpdateChannel();
+    if (channel === "manual")
+        return;
+    const installMethod = detectInstallMethod();
+    const cached = readCachedUpdateInfo(installMethod, channel);
+    if (!cached)
+        return;
+    const currentVersion = getCurrentVersion();
+    const isOutdated = installMethod === "git"
+        ? cached.isOutdated === true
+        : isOutdatedForChannel(currentVersion, cached.latestVersion, channel);
+    if (!isOutdated)
+        return;
+    const channelSuffix = channel === "nightly" ? " (nightly)" : "";
+    const command = getUpdateCommand(installMethod, channel);
+    let message;
+    if (installMethod === "git") {
+        message = `\nUpdate available${channelSuffix} from ${cached.latestVersion} — Run: ${command}\n\n`;
+    }
+    else if (currentVersion === "0.0.0") {
+        message = `\nUpdate available${channelSuffix}: update to latest version — Run: ${command}\n\n`;
+    }
+    else {
+        message = `\nUpdate available${channelSuffix}: ${currentVersion} → ${cached.latestVersion} — Run: ${command}\n\n`;
+    }
+    process.stderr.write(message);
+}
+/**
+ * Kick off a background cache refresh. Skips entirely on `manual` channel
+ * so users who opted out don't generate any registry traffic.
+ */
+export function scheduleBackgroundRefresh() {
+    if (resolveUpdateChannel() === "manual")
+        return;
+    const timer = setTimeout(() => {
+        checkForUpdate().catch(() => { });
+    }, 0);
+    timer.unref();
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * 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 const isVersionOutdated = coreIsVersionOutdated;
+//# sourceMappingURL=update-check.js.map

package/dist/lib/update-check.js.map

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

package/dist/lib/web-dir.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Web directory locator — finds the @made-by-moonlight/athene-web package.
+ * Shared utility to avoid duplication between dashboard.ts and start.ts.
+ */
+/**
+ * Check if a TCP port is available by attempting to connect to it.
+ * A successful connect means something is already listening (port in use).
+ * ECONNREFUSED means nothing is listening (port free).
+ *
+ * Connect-based detection is more reliable than bind-based because it works
+ * regardless of whether the occupying process is bound to 127.0.0.1, ::1,
+ * 0.0.0.0, or :: (IPv6 wildcard).
+ */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/** How many consecutive ports to scan before giving up. */
+export declare const MAX_PORT_SCAN = 100;
+/**
+ * Find the first available port starting from `start`, scanning upward.
+ * Returns `null` if no free port is found within `maxScan` attempts.
+ */
+export declare function findFreePort(start: number, maxScan?: number): Promise<number | null>;
+/**
+ * Open a URL in the user's browser without throwing back into the caller.
+ */
+export declare function openUrl(url: string): void;
+/**
+ * Poll until a port is accepting connections, then open a URL in the browser.
+ * Respects an AbortSignal so the caller can cancel if the dashboard process
+ * exits early. Gives up silently after timeoutMs (default 30s).
+ */
+export declare function waitForPortAndOpen(port: number, url: string, signal: AbortSignal, timeoutMs?: number): Promise<void>;
+/**
+ * Build environment variables for spawning the dashboard process.
+ * Shared between `athene start` and `athene dashboard` to avoid duplication.
+ *
+ * Terminal server ports default to 14800/14801 but can be overridden via config.
+ * When no explicit port is set, auto-detects available ports to allow multiple
+ * dashboard instances to run simultaneously without EADDRINUSE conflicts.
+ */
+export declare function buildDashboardEnv(port: number, configPath: string | null, terminalPort?: number, directTerminalPort?: number): Promise<Record<string, string>>;
+/**
+ * Locate the @made-by-moonlight/athene-web package directory.
+ * Uses createRequire for ESM-compatible require.resolve, with fallback
+ * to sibling package paths that work from both src/ and dist/.
+ */
+export declare function findWebDir(): string;
+//# sourceMappingURL=web-dir.d.ts.map

package/dist/lib/web-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-dir.d.ts","sourceRoot":"","sources":["../../src/lib/web-dir.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS9D;AAED,2DAA2D;AAC3D,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;;GAGG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKjG;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAqBzC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,SAAS,SAAS,GACjB,OAAO,CAAC,IAAI,CAAC,CAUf;AAqBD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,YAAY,CAAC,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyCjC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAwBnC"}