@aui.io/apollo 0.1.60 → 0.1.66

package/node_modules/@aui.io/apollo-core/dist/src/services/runs.js

@@ -0,0 +1,186 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { readBuildFiles } from "../bundle/build-area.js";
+import { CliError, ConfigError } from "../errors/index.js";
+import { agentRoot, readCheckoutTree, requireAgent } from "./bundles.js";
+/**
+ * The two proving lanes' console half
+ * (builder/flow/regressions-and-evaluations-plan.md phase 5): ship the
+ * checkout's current tree — the program under `src/**`, the records under
+ * `build/**` — and the server runs it against the shipped snapshot. A
+ * REGRESSION drives `build/scenarios.yaml` through the simulator, nobody
+ * improvising; an EVALUATION plans improvising callers from guidelines and
+ * ends on a macro verdict. No session exists; polling IS the progress
+ * surface. The last run's id per lane is a LOCAL fact in the checkout's
+ * `.apollo/<kind>.json`, so `--status`, `--cancel`, `--pull` and
+ * `--annotate` name nothing and still find their run.
+ */
+/** Run statuses that are still moving — everything else is the verdict. */
+const RUN_LIVE = new Set(["queued", "running", "cancelling"]);
+/** A run is real conversations plus judge calls — hours-scale like a
+ *  build, so the poll loop's own deadline is generous; each poll request
+ *  stays cheap. */
+export const RUN_DEADLINE_MS = 2 * 3600_000;
+const RUN_POLL_MS = 5_000;
+function runStateFile(root, kind) {
+    return path.join(root, ".apollo", `${kind}.json`);
+}
+/** The saved run handle, or nothing — a missing or corrupt file simply
+ *  means there is no run to name. The pre-phase-5 evaluation file carried
+ *  `evaluation_id`; it still reads. */
+export async function readRunState(root, kind) {
+    try {
+        const parsed = JSON.parse(await readFile(runStateFile(root, kind), "utf8"));
+        const id = typeof parsed.run_id === "string" ? parsed.run_id : parsed.evaluation_id;
+        return typeof id === "string" ? { run_id: id, kind } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function writeRunState(root, state) {
+    const file = runStateFile(root, state.kind);
+    await mkdir(path.dirname(file), { recursive: true });
+    await writeFile(file, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+}
+/** The id a receipt carries — an evaluation's `evaluation_id`, a
+ *  regression's `regression_id`. */
+export function receiptId(receipt) {
+    const id = receipt.regression_id ?? receipt.evaluation_id;
+    if (!id)
+        throw new CliError("The server's receipt named no run.");
+    return id;
+}
+/** Every file under `<root>/bundle/build/**` as `build/**` wire paths.
+ *  Absent directory reads as an empty map: the server names the missing
+ *  file (422), which teaches more than a local guess. */
+async function readBuildTree(buildDir) {
+    const { files } = await readBuildFiles(buildDir);
+    return Object.fromEntries(Object.entries(files).map(([relativePath, content]) => [
+        `build/${relativePath}`,
+        content.toString("utf8"),
+    ]));
+}
+async function checkoutTree(root) {
+    return {
+        ...(await readCheckoutTree(path.join(root, "bundle", "src"))),
+        ...(await readBuildTree(path.join(root, "bundle", "build"))),
+    };
+}
+/**
+ * Start one detached evaluation over this checkout and save its id. The
+ * tree is frozen at accept — keep editing, the run's bytes do not move.
+ */
+export async function startEvaluation(context, builder, options) {
+    const root = options.root ?? agentRoot(context);
+    const guidelines = options.guidelines.trim();
+    if (!guidelines) {
+        throw new ConfigError("An evaluation needs guidelines — what to evaluate, in plain words.", 'Example: apollo evaluate "the refund refusal path after this change".');
+    }
+    const versionTag = options.versionTag ?? context.versionTag;
+    const receipt = await builder.startEvaluation({
+        agent_id: requireAgent(context),
+        files: await checkoutTree(root),
+        guidelines,
+        ...(options.config && Object.keys(options.config).length ? { config: options.config } : {}),
+        ...(options.message ? { message: options.message } : {}),
+        ...(versionTag ? { version_tag: versionTag } : {}),
+    });
+    await writeRunState(root, { run_id: receiptId(receipt), kind: "evaluation" });
+    return receipt;
+}
+/** Start one detached regression over this checkout and save its id. */
+export async function startRegression(context, builder, options = {}) {
+    const root = options.root ?? agentRoot(context);
+    const versionTag = options.versionTag ?? context.versionTag;
+    const receipt = await builder.startRegression({
+        agent_id: requireAgent(context),
+        files: await checkoutTree(root),
+        ...(options.scenarios?.length ? { scenarios: options.scenarios } : {}),
+        ...(options.judge ? { judge: true } : {}),
+        ...(options.message ? { message: options.message } : {}),
+        ...(versionTag ? { version_tag: versionTag } : {}),
+    });
+    await writeRunState(root, { run_id: receiptId(receipt), kind: "regression" });
+    return receipt;
+}
+/** Poll one run to its terminal view (completed, failed or cancelled). */
+export async function awaitRun(builder, kind, runId, options = {}) {
+    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const interval = options.pollIntervalMs ?? RUN_POLL_MS;
+    const deadline = Date.now() + (options.deadlineMs ?? RUN_DEADLINE_MS);
+    for (;;) {
+        const view = await builder.runView(kind, runId);
+        if (!RUN_LIVE.has(view.status))
+            return view;
+        if (Date.now() >= deadline) {
+            // The run keeps executing server-side; the saved id still names it.
+            throw new CliError(`The ${kind} is still running (${runId}).`, {
+                suggestion: `\`apollo ${verb(kind)} --status\` picks the report up later.`,
+            });
+        }
+        await sleep(interval);
+    }
+}
+/** The CLI verb per lane. */
+export function verb(kind) {
+    return kind === "regression" ? "regress" : "evaluate";
+}
+/** The run the caller means: the explicit id, else the checkout's saved
+ *  last run of that lane — no run at all is a config story, not a 404. */
+export async function resolveRunId(context, kind, explicit, root) {
+    if (explicit)
+        return explicit;
+    const saved = await readRunState(root ?? agentRoot(context), kind);
+    if (!saved) {
+        throw new ConfigError(`No ${kind} to name — this checkout has not started one.`, `Run \`apollo ${verb(kind)}\` first, or pass --id.`);
+    }
+    return saved.run_id;
+}
+/**
+ * Fetch a settled run's evidence and write it under the checkout —
+ * `tmp/regressions/<id>/` or `tmp/evaluations/<id>/`, the layout the
+ * builder writes in a session, so a CLI author and a builder session read
+ * the same files. `tmp/**` never ships; a re-pull overwrites.
+ */
+export async function pullRun(context, builder, kind, runId, options = {}) {
+    const root = path.resolve(options.root ?? agentRoot(context));
+    const artifacts = await builder.runArtifacts(kind, runId, options.all ?? true);
+    const written = [];
+    for (const [relativePath, content] of Object.entries(artifacts.files)) {
+        const target = insideTmp(root, relativePath);
+        await mkdir(path.dirname(target), { recursive: true });
+        await writeFile(target, content, "utf8");
+        written.push(relativePath);
+    }
+    return {
+        directory: insideTmp(root, artifacts.root),
+        files: written.sort(),
+        note: artifacts.note,
+    };
+}
+/** A server-named artifact path must live under `tmp/` inside the
+ *  checkout — anything else is refused before a byte is written. */
+function insideTmp(root, relativePath) {
+    const normalized = relativePath.split("\\").join("/");
+    if (!normalized.startsWith("tmp/") || normalized.split("/").includes("..")) {
+        throw new CliError(`Refusing to write outside tmp/: ${relativePath}`);
+    }
+    const target = path.resolve(root, normalized);
+    if (!target.startsWith(`${path.join(root, "tmp")}${path.sep}`)) {
+        throw new CliError(`Refusing to write outside tmp/: ${relativePath}`);
+    }
+    return target;
+}
+/** Append one reading to a settled run; the server answers the run as it
+ *  now reads. */
+export function annotateRun(builder, kind, runId, annotation) {
+    const text = annotation.text.trim();
+    if (!text)
+        throw new ConfigError("An annotation needs some text.");
+    return builder.annotateRun(kind, runId, {
+        text,
+        ...(annotation.verdict ? { verdict: annotation.verdict } : {}),
+    });
+}
+//# sourceMappingURL=runs.js.map

package/node_modules/@aui.io/apollo-core/dist/src/services/runs.js.map

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

package/node_modules/@aui.io/apollo-core/dist/src/services/status.service.d.ts

@@ -1,4 +1,5 @@
 import type { Context } from "../config/index.js";
+import { type RuntimePinCheck } from "../runtime-version/availability.js";
 export interface ServiceCheck {
     service: "identity" | "management" | "runtime";
     reachable: boolean;
@@ -20,8 +21,15 @@ export interface StatusResult {
     bindingPath: string | null;
     agentRoot: string | null;
     checks?: ServiceCheck[];
+    /**
+     * With `--check` on a pinned checkout: whether the pinned runtime is still
+     * served (the family may be retired, or the gateway may route the pin to
+     * a different engine). Absent when unpinned or without `--check`.
+     */
+    runtimePinned?: RuntimePinCheck;
 }
 export declare function getStatus(context: Context, options?: {
     check?: boolean;
     fetch?: typeof globalThis.fetch;
+    homeDir?: string;
 }): Promise<StatusResult>;

package/node_modules/@aui.io/apollo-core/dist/src/services/status.service.js

@@ -1,6 +1,8 @@
 import { Transport } from "../api/transport.js";
 import { ApiError, AuthError } from "../errors/index.js";
+import { checkRuntimeAvailability, } from "../runtime-version/availability.js";
 import { RUNTIME_VERSION_HEADER } from "../runtime-version/index.js";
+import { createClients } from "./clients.js";
 export async function getStatus(context, options = {}) {
     const result = {
         environment: context.environment,
@@ -22,6 +24,19 @@ export async function getStatus(context, options = {}) {
             checkManagement(context, options.fetch),
             checkRuntime(context, options.fetch),
         ]);
+        if (context.runtimeVersion) {
+            const clients = createClients(context, {
+                ...(options.homeDir ? { homeDir: options.homeDir } : {}),
+                ...(options.fetch ? { fetch: options.fetch } : {}),
+            });
+            const pinned = await checkRuntimeAvailability(context, clients, {
+                ...(options.fetch ? { fetch: options.fetch } : {}),
+                ...(options.homeDir ? { homeDir: options.homeDir } : {}),
+                withoutCatalog: "probe",
+            });
+            if (pinned)
+                result.runtimePinned = pinned;
+        }
     }
     return result;
 }

package/node_modules/@aui.io/apollo-core/dist/src/services/status.service.js.map

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

package/node_modules/@aui.io/apollo-core/dist/src/services/update-check.d.ts

@@ -0,0 +1,105 @@
+import { type NpmRunner } from "./upgrade.js";
+/**
+ * Which package the running console upgrades from, and the bin whose
+ * `upgrade` verb does it. The public build is the default; a distribution
+ * (apollo-internal) retargets both at startup, the same way it registers
+ * its environments — before any command or the TUI resolves a context.
+ */
+export interface UpdateTarget {
+    /** The npm package the notifier tracks (`npm view <package>@latest`). */
+    packageName: string;
+    /** The bin name the user runs — `<bin> upgrade` is the advertised fix. */
+    bin: string;
+}
+export declare const PUBLIC_UPDATE_TARGET: Readonly<UpdateTarget>;
+export declare function setUpdateTarget(next: UpdateTarget): void;
+export declare function updateTarget(): Readonly<UpdateTarget>;
+/** The exact command a notice tells the reader to run. */
+export declare function upgradeCommand(which?: Readonly<UpdateTarget>): string;
+/** One npm lookup satisfies the cache for an hour before the next command
+ *  triggers another. Releases land several times a day here, so a shorter
+ *  window than the usual daily check is worth it; the lookup runs detached,
+ *  so the cadence costs no command any latency. */
+export declare const UPDATE_CHECK_TTL_MS: number;
+export declare const UPDATE_CHECK_FILE = "update-check.json";
+export interface UpdateCheckEntry {
+    /** The last lookup ATTEMPT (success or failure), ISO-8601. Drives the TTL,
+     *  so an offline machine retries once per window, not on every command. */
+    checkedAt: string;
+    /** The `latest` dist-tag from the last successful lookup. */
+    latest?: string;
+    /** When `latest` was resolved, ISO-8601. */
+    resolvedAt?: string;
+}
+/** `~/.apollo/update-check.json`: one entry per tracked package. */
+export type UpdateCheckFile = Record<string, UpdateCheckEntry>;
+/** `APOLLO_UPDATE_CHECK=0` opts out entirely (same shape as `APOLLO_TUI=0`). */
+export declare function updateCheckDisabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function updateCheckPath(homeDir?: string): string;
+/** The whole file; anything that is not a map of well-formed entries reads
+ *  as empty (that covers a corrupt file and any older flat layout). */
+export declare function readUpdateCache(homeDir?: string): Promise<UpdateCheckFile>;
+export declare function readUpdateEntry(packageName: string, homeDir?: string): Promise<UpdateCheckEntry | undefined>;
+/** Merge one package's entry into the file, keeping the other packages'. */
+export declare function writeUpdateEntry(packageName: string, entry: UpdateCheckEntry, homeDir?: string): Promise<void>;
+export declare function isUpdateEntryStale(entry: UpdateCheckEntry | undefined, now?: number): boolean;
+/**
+ * Compare two `x.y.z[-prerelease]` versions; > 0 when `a` is newer than
+ * `b`. Enough for what this project publishes — a real semver range parser
+ * would be a dependency for a single comparison.
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * What every surface hands the reader. The fields are for programs
+ * (`run` is the command to execute verbatim); `message` is the same fact
+ * as one sentence, so a coding agent that has never seen this schema still
+ * knows what to do.
+ */
+export interface UpdateNotice {
+    package: string;
+    current: string;
+    latest: string;
+    /** The command that installs `latest` — run it as written. */
+    run: string;
+    message: string;
+}
+/**
+ * The one line plain runs print to stderr. Starts with "Update available"
+ * so it can never be mistaken for the command failing, and quotes the
+ * command so an agent can copy it without guessing.
+ */
+export declare function formatUpdateNotice(notice: Pick<UpdateNotice, "current" | "latest" | "run">, bin?: string): string;
+/** The notice for a cache entry, or undefined unless it names a strictly
+ *  newer version than the one running. */
+export declare function updateNoticeFrom(entry: UpdateCheckEntry | undefined, currentVersion: string, which?: Readonly<UpdateTarget>): UpdateNotice | undefined;
+export interface RefreshUpdateCacheOptions {
+    packageName: string;
+    homeDir?: string;
+    npm?: NpmRunner;
+    now?: () => Date;
+}
+/**
+ * Ask npm for `latest` and persist the answer. Never throws: offline or a
+ * registry outage keeps the previous `latest` (a stale truth beats none)
+ * and only moves `checkedAt`, so the next window's command retries once
+ * rather than every command hammering the registry.
+ */
+export declare function refreshUpdateCache(options: RefreshUpdateCacheOptions): Promise<UpdateCheckEntry>;
+/**
+ * Record a `latest` we just learned first-hand (`apollo upgrade`, its
+ * `--check`, the TUI's /upgrade) so the notice clears — or appears —
+ * immediately instead of after the next window.
+ */
+export declare function recordLatestVersion(packageName: string, latest: string, homeDir?: string): Promise<void>;
+/**
+ * The whole check for a long-lived surface (the TUI): cached verdict when
+ * fresh, an inline refresh when stale, and the notice — if any — for the
+ * version that is running. Never throws.
+ */
+export declare function checkForUpdate(currentVersion: string, options?: {
+    homeDir?: string;
+    npm?: NpmRunner;
+    now?: () => Date;
+    env?: NodeJS.ProcessEnv;
+    which?: Readonly<UpdateTarget>;
+}): Promise<UpdateNotice | undefined>;

package/node_modules/@aui.io/apollo-core/dist/src/services/update-check.js

@@ -0,0 +1,265 @@
+/**
+ * The update notifier — "a newer apollo is on npm, run `apollo upgrade`".
+ *
+ * The contract every surface follows:
+ *
+ *   1. A command never waits on npm. It reads `~/.apollo/update-check.json`
+ *      (microseconds) and, when the entry is older than the TTL, hands the
+ *      lookup to a detached child that refreshes the file for the NEXT run.
+ *      The long-lived TUI refreshes inline instead and re-checks on a timer.
+ *   2. The notice reaches humans and coding agents alike: one stderr line
+ *      on plain runs (stdout stays the pipeable result), an additive top-level
+ *      `update` field in every `--json` envelope (success or failure), and a
+ *      toast + footer marker in the TUI. The text names the exact command.
+ *   3. The cache is disposable. A missing, corrupt, foreign-shaped or
+ *      unwritable file degrades to "no notice" — never to a failed command.
+ *   4. `APOLLO_UPDATE_CHECK=0` disables everything; `CI` mutes the banner
+ *      and the background refresh (the envelope still reports what the
+ *      cache already knows).
+ *
+ * The file is keyed by package name because two distributions coexist on a
+ * staff machine (`@aui.io/apollo` and `@aui.io/apollo-internal`, separate
+ * bins); a flat file would have each build overwrite the other's verdict
+ * and re-spawn the lookup on every alternate run.
+ */
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { apolloDir, writeJsonAtomic } from "../config/store.js";
+import { resolvePublishedVersion } from "./upgrade.js";
+export const PUBLIC_UPDATE_TARGET = Object.freeze({
+    packageName: "@aui.io/apollo",
+    bin: "apollo",
+});
+let target = PUBLIC_UPDATE_TARGET;
+export function setUpdateTarget(next) {
+    target = Object.freeze({ ...next });
+}
+export function updateTarget() {
+    return target;
+}
+/** The exact command a notice tells the reader to run. */
+export function upgradeCommand(which = target) {
+    return `${which.bin} upgrade`;
+}
+// ------------------------------------------------------------------ cache
+/** One npm lookup satisfies the cache for an hour before the next command
+ *  triggers another. Releases land several times a day here, so a shorter
+ *  window than the usual daily check is worth it; the lookup runs detached,
+ *  so the cadence costs no command any latency. */
+export const UPDATE_CHECK_TTL_MS = 60 * 60 * 1000;
+export const UPDATE_CHECK_FILE = "update-check.json";
+/** `APOLLO_UPDATE_CHECK=0` opts out entirely (same shape as `APOLLO_TUI=0`). */
+export function updateCheckDisabled(env = process.env) {
+    return env.APOLLO_UPDATE_CHECK === "0";
+}
+export function updateCheckPath(homeDir = homedir()) {
+    return join(apolloDir(homeDir), UPDATE_CHECK_FILE);
+}
+function isEntry(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.checkedAt === "string" &&
+        (value.latest === undefined ||
+            typeof value.latest === "string"));
+}
+/** The whole file; anything that is not a map of well-formed entries reads
+ *  as empty (that covers a corrupt file and any older flat layout). */
+export async function readUpdateCache(homeDir = homedir()) {
+    try {
+        const parsed = JSON.parse(await readFile(updateCheckPath(homeDir), "utf8"));
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            return {};
+        }
+        const file = {};
+        for (const [name, entry] of Object.entries(parsed)) {
+            if (isEntry(entry))
+                file[name] = entry;
+        }
+        return file;
+    }
+    catch {
+        // Missing or unreadable — never checked, as far as the notifier knows.
+        return {};
+    }
+}
+export async function readUpdateEntry(packageName, homeDir = homedir()) {
+    return (await readUpdateCache(homeDir))[packageName];
+}
+/** Merge one package's entry into the file, keeping the other packages'. */
+export async function writeUpdateEntry(packageName, entry, homeDir = homedir()) {
+    const file = await readUpdateCache(homeDir);
+    file[packageName] = entry;
+    await writeJsonAtomic(updateCheckPath(homeDir), file, 0o644);
+}
+export function isUpdateEntryStale(entry, now = Date.now()) {
+    if (entry === undefined)
+        return true;
+    const checked = Date.parse(entry.checkedAt);
+    if (Number.isNaN(checked))
+        return true;
+    return now - checked >= UPDATE_CHECK_TTL_MS;
+}
+// ---------------------------------------------------------------- versions
+/**
+ * Compare two `x.y.z[-prerelease]` versions; > 0 when `a` is newer than
+ * `b`. Enough for what this project publishes — a real semver range parser
+ * would be a dependency for a single comparison.
+ */
+export function compareVersions(a, b) {
+    const [coreA, preA] = splitPrerelease(a);
+    const [coreB, preB] = splitPrerelease(b);
+    const partsA = coreA.split(".").map(numericPart);
+    const partsB = coreB.split(".").map(numericPart);
+    for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+        const valueA = partsA[i] ?? 0;
+        const valueB = partsB[i] ?? 0;
+        if (valueA !== valueB)
+            return valueA - valueB;
+    }
+    // Equal cores: a release outranks any prerelease of it.
+    if (preA === undefined && preB === undefined)
+        return 0;
+    if (preA === undefined)
+        return 1;
+    if (preB === undefined)
+        return -1;
+    return comparePrerelease(preA, preB);
+}
+function numericPart(part) {
+    const value = Number.parseInt(part, 10);
+    return Number.isNaN(value) ? 0 : value;
+}
+function splitPrerelease(version) {
+    const cleaned = version.trim().replace(/^v/, "");
+    const dash = cleaned.indexOf("-");
+    if (dash === -1)
+        return [cleaned, undefined];
+    return [cleaned.slice(0, dash), cleaned.slice(dash + 1)];
+}
+/** Dot-separated identifiers, numeric ones numerically (`beta.2 < beta.10`). */
+function comparePrerelease(a, b) {
+    const partsA = a.split(".");
+    const partsB = b.split(".");
+    for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+        const valueA = partsA[i];
+        const valueB = partsB[i];
+        if (valueA === undefined)
+            return -1;
+        if (valueB === undefined)
+            return 1;
+        const numA = /^\d+$/.test(valueA) ? Number.parseInt(valueA, 10) : undefined;
+        const numB = /^\d+$/.test(valueB) ? Number.parseInt(valueB, 10) : undefined;
+        if (numA !== undefined && numB !== undefined) {
+            if (numA !== numB)
+                return numA - numB;
+        }
+        else if (numA !== undefined) {
+            return -1;
+        }
+        else if (numB !== undefined) {
+            return 1;
+        }
+        else if (valueA !== valueB) {
+            return valueA < valueB ? -1 : 1;
+        }
+    }
+    return 0;
+}
+/**
+ * The one line plain runs print to stderr. Starts with "Update available"
+ * so it can never be mistaken for the command failing, and quotes the
+ * command so an agent can copy it without guessing.
+ */
+export function formatUpdateNotice(notice, bin = target.bin) {
+    return `Update available: ${bin} ${notice.current} → ${notice.latest} — run "${notice.run}" to install it.`;
+}
+/** The notice for a cache entry, or undefined unless it names a strictly
+ *  newer version than the one running. */
+export function updateNoticeFrom(entry, currentVersion, which = target) {
+    if (entry?.latest === undefined)
+        return undefined;
+    if (compareVersions(entry.latest, currentVersion) <= 0)
+        return undefined;
+    const run = upgradeCommand(which);
+    const partial = { current: currentVersion, latest: entry.latest, run };
+    return {
+        package: which.packageName,
+        ...partial,
+        message: formatUpdateNotice(partial, which.bin),
+    };
+}
+/**
+ * Ask npm for `latest` and persist the answer. Never throws: offline or a
+ * registry outage keeps the previous `latest` (a stale truth beats none)
+ * and only moves `checkedAt`, so the next window's command retries once
+ * rather than every command hammering the registry.
+ */
+export async function refreshUpdateCache(options) {
+    const homeDir = options.homeDir ?? homedir();
+    const checkedAt = (options.now?.() ?? new Date()).toISOString();
+    const previous = await readUpdateEntry(options.packageName, homeDir);
+    let entry;
+    try {
+        const latest = await resolvePublishedVersion(options.packageName, "latest", options.npm);
+        entry = { checkedAt, latest, resolvedAt: checkedAt };
+    }
+    catch {
+        entry = {
+            checkedAt,
+            ...(previous?.latest === undefined ? {} : { latest: previous.latest }),
+            ...(previous?.resolvedAt === undefined
+                ? {}
+                : { resolvedAt: previous.resolvedAt }),
+        };
+    }
+    try {
+        await writeUpdateEntry(options.packageName, entry, homeDir);
+    }
+    catch {
+        // Read-only home: the notifier stands down silently.
+    }
+    return entry;
+}
+/**
+ * Record a `latest` we just learned first-hand (`apollo upgrade`, its
+ * `--check`, the TUI's /upgrade) so the notice clears — or appears —
+ * immediately instead of after the next window.
+ */
+export async function recordLatestVersion(packageName, latest, homeDir = homedir()) {
+    const now = new Date().toISOString();
+    try {
+        await writeUpdateEntry(packageName, { checkedAt: now, latest, resolvedAt: now }, homeDir);
+    }
+    catch {
+        // Best effort only.
+    }
+}
+/**
+ * The whole check for a long-lived surface (the TUI): cached verdict when
+ * fresh, an inline refresh when stale, and the notice — if any — for the
+ * version that is running. Never throws.
+ */
+export async function checkForUpdate(currentVersion, options = {}) {
+    if (updateCheckDisabled(options.env))
+        return undefined;
+    const which = options.which ?? target;
+    try {
+        const homeDir = options.homeDir ?? homedir();
+        let entry = await readUpdateEntry(which.packageName, homeDir);
+        const now = options.now?.() ?? new Date();
+        if (isUpdateEntryStale(entry, now.getTime())) {
+            entry = await refreshUpdateCache({
+                packageName: which.packageName,
+                homeDir,
+                ...(options.npm === undefined ? {} : { npm: options.npm }),
+                now: () => now,
+            });
+        }
+        return updateNoticeFrom(entry, currentVersion, which);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=update-check.js.map