@noodleseed/one 0.10.0 → 0.12.0

package/dist/update-binary.js

@@ -0,0 +1,144 @@
+/**
+ * Binary ownership resolver for `noodle update` repair (#242, ADR 0118).
+ *
+ * npm's `EEXIST .../bin/noodle` failure happens before any of our code runs, so
+ * `noodle update` inspects the expected global bin path itself: does a `noodle`
+ * binary exist there, is it a symlink, where does it resolve, and is that target
+ * provably a Noodle CLI install? Classification is deliberately conservative:
+ *
+ * - SAFE to repair: a symlink into an `@noodleseed/one` (or legacy `noodleseed-cli`)
+ *   package outside the active prefix, a dangling symlink, or a launcher file that
+ *   provably references a Noodle CLI package.
+ * - UNSAFE: everything else — real files of unknown content, symlinks into other
+ *   packages or arbitrary files, unreadable paths. Ambiguous is always UNSAFE.
+ *
+ * All probes are dependency-injected (fs + execPath) so every classification case
+ * is unit-testable against temp prefixes, never the developer's real global prefix.
+ */
+import { lstatSync, readFileSync, readlinkSync, realpathSync } from 'node:fs';
+import { dirname, isAbsolute, join, resolve, sep } from 'node:path';
+/** Real-filesystem probes; `execPath` is overridable so tests point at a temp prefix. */
+export function realBinaryProbeDeps(overrides = {}) {
+    return {
+        execPath: overrides.execPath ?? process.execPath,
+        lstatKind: (path) => {
+            try {
+                const stat = lstatSync(path);
+                if (stat.isSymbolicLink())
+                    return 'symlink';
+                if (stat.isFile())
+                    return 'file';
+                if (stat.isDirectory())
+                    return 'dir';
+                return 'other';
+            }
+            catch (error) {
+                return error.code === 'ENOENT' ? 'missing' : 'error';
+            }
+        },
+        readlink: (path) => {
+            try {
+                return readlinkSync(path);
+            }
+            catch {
+                return undefined;
+            }
+        },
+        realpath: (path) => {
+            try {
+                return realpathSync(path);
+            }
+            catch {
+                return undefined;
+            }
+        },
+        readFileHead: (path) => {
+            try {
+                return readFileSync(path, 'utf8').slice(0, 4096);
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+/** The npm-installed package directory of the current CLI. */
+const CURRENT_PACKAGE_PATH = join('node_modules', '@noodleseed', 'one');
+/** Known previous Noodle CLI installs (also safe to replace, but never "active"). */
+const LEGACY_PACKAGE_PATHS = [join('node_modules', 'noodleseed-cli')];
+function containsPackagePath(path, packagePath) {
+    return path.includes(`${sep}${packagePath}${sep}`) || path.endsWith(`${sep}${packagePath}`);
+}
+function isCurrentPackagePath(path) {
+    return containsPackagePath(path, CURRENT_PACKAGE_PATH);
+}
+function isOwnedPackagePath(path) {
+    return (isCurrentPackagePath(path) ||
+        LEGACY_PACKAGE_PATHS.some((legacy) => containsPackagePath(path, legacy)));
+}
+/** Inspect the expected global `noodle` binary and classify it. Never mutates anything. */
+export function inspectNoodleBinary(deps = realBinaryProbeDeps()) {
+    const expectedBinDir = dirname(deps.execPath);
+    const binPath = join(expectedBinDir, 'noodle');
+    return { expectedBinDir, binPath, status: classify(deps, expectedBinDir, binPath) };
+}
+function classify(deps, expectedBinDir, binPath) {
+    switch (deps.lstatKind(binPath)) {
+        case 'missing':
+            return { kind: 'none' };
+        case 'error':
+            return { kind: 'unsafe', reason: 'the existing binary could not be inspected' };
+        case 'dir':
+        case 'other':
+            return { kind: 'unsafe', reason: 'the path is not a regular file or symlink' };
+        case 'symlink':
+            return classifySymlink(deps, expectedBinDir, binPath);
+        case 'file':
+            return classifyFile(deps, binPath);
+    }
+}
+function classifySymlink(deps, expectedBinDir, binPath) {
+    const link = deps.readlink(binPath);
+    if (link === undefined)
+        return { kind: 'unsafe', reason: 'the symlink could not be read' };
+    const linkTarget = isAbsolute(link) ? link : resolve(dirname(binPath), link);
+    const real = deps.realpath(binPath);
+    if (real === undefined) {
+        // Dangling symlink: removing it cannot destroy anything.
+        return { kind: 'safe-repair', reason: `broken symlink to ${linkTarget}` };
+    }
+    if (isOwnedPackagePath(real) || isOwnedPackagePath(linkTarget)) {
+        // Only the current package inside the active prefix is npm-updatable in place;
+        // a legacy package's bin (any prefix) still blocks `npm install -g @noodleseed/one`.
+        if (isCurrentPackagePath(real)) {
+            // Canonicalize the active prefix too (macOS tmp dirs resolve through /private).
+            const prefixDir = dirname(expectedBinDir);
+            const prefix = deps.realpath(prefixDir) ?? prefixDir;
+            if (real.startsWith(`${prefix}${sep}`)) {
+                return { kind: 'active-install', target: real };
+            }
+        }
+        return {
+            kind: 'safe-repair',
+            reason: `symlink into a Noodle CLI install that npm cannot update in place (${real})`,
+        };
+    }
+    return {
+        kind: 'unsafe',
+        reason: `the symlink resolves to ${real}, which is not a Noodle CLI install`,
+    };
+}
+function classifyFile(deps, binPath) {
+    const head = deps.readFileHead(binPath);
+    if (head === undefined)
+        return { kind: 'unsafe', reason: 'the existing file is unreadable' };
+    // npm launcher shims (Windows-style .cmd/.ps1 or sh) embed the package path they run.
+    if (head.includes('@noodleseed/one') || head.includes('noodleseed-cli')) {
+        return { kind: 'safe-repair', reason: 'launcher script for a previous Noodle CLI install' };
+    }
+    return {
+        kind: 'unsafe',
+        reason: 'the existing file is not known to be owned by @noodleseed/one',
+    };
+}
+//# sourceMappingURL=update-binary.js.map

package/dist/update-binary.js.map

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

package/dist/update-check.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Passive post-command update check (#242, ADR 0118, refining ADR 0079).
+ *
+ * Default behavior on a human TTY: at most once per day, offer "Update now?"
+ * (Enter = yes; "n" snoozes for 24h via `updateCheck.snoozedUntil`). When a prompt
+ * is not possible (no interactive stdin, NOODLE_NO_PROMPT, machine notices) it
+ * falls back to the once-per-day notice. `NOODLE_UPDATE_MODE` selects explicit
+ * behaviors for automation: `off` (no checks), `notify` (notice only), `check`
+ * (stable exit-code overlay 10 when an update is available — the only mode that
+ * runs without a TTY / in CI), and `auto` (run the update, interactive shells
+ * only; `NOODLE_AUTO_UPDATE` stays as the shipped alias).
+ *
+ * A failed, declined, or crashed check must NEVER break or re-code the user's
+ * actual command — every failure path resolves to `undefined`.
+ */
+export type UpdateMode = 'off' | 'notify' | 'check' | 'auto' | 'prompt';
+export interface UpdateCheckInput {
+    readonly command: string | undefined;
+    /** Remaining argv of the invocation; any `--json` invocation skips the check. */
+    readonly argv?: readonly string[];
+    readonly env: NodeJS.ProcessEnv;
+    readonly home: string;
+    readonly fetchImpl?: typeof fetch;
+    /** Injectable updater (defaults to `runUpdateCommand`); tests avoid spawning npm. */
+    readonly runUpdate?: (rest: readonly string[]) => Promise<number>;
+    readonly confirmImpl?: (message: string) => Promise<boolean>;
+    /** May we prompt? Defaults to stdin+stderr being TTYs. */
+    readonly promptCapable?: boolean;
+    /** May we print a notice? Defaults to stderr being a TTY. */
+    readonly noticeCapable?: boolean;
+}
+/** Resolve the update mode: NOODLE_UPDATE_MODE, else the NOODLE_AUTO_UPDATE alias, else the default prompt. */
+export declare function resolveUpdateMode(env: NodeJS.ProcessEnv): UpdateMode;
+/**
+ * Run the passive update check after a successful command. Returns an exit-code
+ * overlay only under `NOODLE_UPDATE_MODE=check` (10 = update available); every
+ * other outcome — including all failures — resolves `undefined`.
+ */
+export declare function maybeCheckForCliUpdate(input: UpdateCheckInput): Promise<number | undefined>;
+//# sourceMappingURL=update-check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsBH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,+GAA+G;AAC/G,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAKpE;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMjG"}

package/dist/update-check.js

@@ -0,0 +1,212 @@
+/**
+ * Passive post-command update check (#242, ADR 0118, refining ADR 0079).
+ *
+ * Default behavior on a human TTY: at most once per day, offer "Update now?"
+ * (Enter = yes; "n" snoozes for 24h via `updateCheck.snoozedUntil`). When a prompt
+ * is not possible (no interactive stdin, NOODLE_NO_PROMPT, machine notices) it
+ * falls back to the once-per-day notice. `NOODLE_UPDATE_MODE` selects explicit
+ * behaviors for automation: `off` (no checks), `notify` (notice only), `check`
+ * (stable exit-code overlay 10 when an update is available — the only mode that
+ * runs without a TTY / in CI), and `auto` (run the update, interactive shells
+ * only; `NOODLE_AUTO_UPDATE` stays as the shipped alias).
+ *
+ * A failed, declined, or crashed check must NEVER break or re-code the user's
+ * actual command — every failure path resolves to `undefined`.
+ */
+import { runUpdateCommand } from './commands/update-ops.js';
+import { readConfig, writeConfig } from './config.js';
+import { detectColorMode } from './gradient.js';
+import { confirm } from './prompts.js';
+import { bundledAgentKitVersion, fetchLatestAgentKitVersion, isSkillsUpdateAvailable, skillsUpdatePromptMessage, } from './skills-update.js';
+import { CLI_PACKAGE_NAME, compareVersions, currentCliVersion, fetchLatestVersion, truthyEnv, UPDATE_CHECK_INTERVAL_MS, } from './update.js';
+import { renderUpdateAvailable } from './update-render.js';
+/** Resolve the update mode: NOODLE_UPDATE_MODE, else the NOODLE_AUTO_UPDATE alias, else the default prompt. */
+export function resolveUpdateMode(env) {
+    const raw = env.NOODLE_UPDATE_MODE?.toLowerCase();
+    if (raw === 'off' || raw === 'notify' || raw === 'check' || raw === 'auto')
+        return raw;
+    if (truthyEnv(env.NOODLE_AUTO_UPDATE))
+        return 'auto';
+    return 'prompt';
+}
+/**
+ * Run the passive update check after a successful command. Returns an exit-code
+ * overlay only under `NOODLE_UPDATE_MODE=check` (10 = update available); every
+ * other outcome — including all failures — resolves `undefined`.
+ */
+export async function maybeCheckForCliUpdate(input) {
+    try {
+        return await checkForCliUpdate(input);
+    }
+    catch {
+        return undefined; // an optional check must never break the user's command
+    }
+}
+async function checkForCliUpdate(input) {
+    const { env } = input;
+    if (shouldSkipCommand(input.command))
+        return undefined;
+    if (truthyEnv(env.NOODLE_DISABLE_UPDATE_CHECK))
+        return undefined;
+    if (input.argv?.includes('--json'))
+        return undefined;
+    const mode = resolveUpdateMode(env);
+    if (mode === 'off')
+        return undefined;
+    const noticeCapable = input.noticeCapable ?? process.stderr.isTTY === true;
+    const promptCapable = input.promptCapable ?? (process.stdin.isTTY === true && noticeCapable);
+    const jsonNotices = truthyEnv(env.NOODLE_UPDATE_JSON);
+    // `check` is the automation contract and runs anywhere; everything else stays
+    // out of CI and non-interactive shells (never prompt or auto-update there).
+    if (mode !== 'check' && (truthyEnv(env.CI) || !noticeCapable))
+        return undefined;
+    const installed = currentCliVersion();
+    const fetchImpl = input.fetchImpl ?? fetch;
+    const config = readConfig(input.home);
+    const wantsPrompt = mode === 'prompt' && promptCapable && !truthyEnv(env.NOODLE_NO_PROMPT) && !jsonNotices;
+    if (wantsPrompt || mode === 'check') {
+        if (wantsPrompt && isSnoozed(config.updateCheck?.snoozedUntil))
+            return undefined;
+        // Deterministic freshness: use the cached latest when fresh, else fetch once.
+        let latest;
+        let skillsLatest;
+        if (isFresh(config.updateCheck?.checkedAt) && config.updateCheck?.latestVersion !== undefined) {
+            latest = config.updateCheck.latestVersion;
+        }
+        else {
+            latest = await fetchLatestVersion(fetchImpl).catch(() => undefined);
+            skillsLatest = await fetchLatestAgentKitVersion(fetchImpl).catch(() => undefined);
+            if (latest !== undefined || skillsLatest !== undefined) {
+                writeCheckCache(input.home, latest, skillsLatest);
+            }
+        }
+        const newer = latest !== undefined && compareVersions(latest, installed) > 0;
+        if (mode === 'check') {
+            if (!newer || latest === undefined)
+                return undefined;
+            emitNotice(jsonNotices, installed, latest);
+            return 10;
+        }
+        if (newer && latest !== undefined) {
+            // Snooze before asking so an aborted or killed prompt never repeats.
+            snooze(input.home);
+            console.error(renderUpdateAvailable(installed, latest, detectColorMode(process.stderr)));
+            const ask = input.confirmImpl ?? ((message) => confirm(message, { output: process.stderr }));
+            const accepted = await ask('Update now?').catch(() => false);
+            if (accepted) {
+                await runUpdate(input)(['--yes']).catch(() => 1);
+            }
+            else {
+                console.error('Snoozed for 24 hours. Run `noodle update` when ready.');
+            }
+        }
+        maybeSkillsNotice(jsonNotices, skillsLatest);
+        return undefined;
+    }
+    // notify / auto (and non-promptable defaults): the once-per-24h notice pass.
+    if (isFresh(config.updateCheck?.checkedAt))
+        return undefined;
+    const latest = await fetchLatestVersion(fetchImpl).catch(() => undefined);
+    const skillsLatest = await fetchLatestAgentKitVersion(fetchImpl).catch(() => undefined);
+    if (latest === undefined && skillsLatest === undefined)
+        return undefined;
+    writeCheckCache(input.home, latest, skillsLatest);
+    if (latest !== undefined && compareVersions(latest, installed) > 0) {
+        if (mode === 'auto') {
+            console.error(`A newer Noodle CLI is available: ${installed} -> ${latest}`);
+            console.error(`${autoTrigger(env)} — updating now...`);
+            await runUpdate(input)(['--yes']).catch(() => 1);
+        }
+        else {
+            emitNotice(jsonNotices, installed, latest);
+        }
+    }
+    maybeSkillsNotice(jsonNotices, skillsLatest);
+    return undefined;
+}
+function runUpdate(input) {
+    return input.runUpdate ?? ((rest) => runUpdateCommand(rest, { env: input.env }));
+}
+function shouldSkipCommand(command) {
+    return (command === undefined ||
+        command === '--version' ||
+        command === '-v' ||
+        command === 'version' ||
+        command === '--help' ||
+        command === '-h' ||
+        command === 'help' ||
+        command === 'update');
+}
+function emitNotice(jsonNotices, installed, latest) {
+    if (jsonNotices) {
+        console.error(JSON.stringify({
+            event: 'update_available',
+            package: CLI_PACKAGE_NAME,
+            installed,
+            latest,
+            recommendedCommand: 'noodle update --yes --json',
+        }));
+        return;
+    }
+    console.error(`A newer Noodle CLI is available: ${installed} -> ${latest}`);
+    console.error('Update: noodle update');
+}
+/** Self-checking skills: notify (never auto-update) when the registry has a newer agent-kit. */
+function maybeSkillsNotice(jsonNotices, skillsLatest) {
+    if (jsonNotices)
+        return; // machine notices carry only the CLI update event
+    if (skillsLatest !== undefined && isSkillsUpdateAvailable(skillsLatest)) {
+        console.error(skillsUpdatePromptMessage(skillsLatest, bundledAgentKitVersion()));
+    }
+}
+function autoTrigger(env) {
+    return env.NOODLE_UPDATE_MODE?.toLowerCase() === 'auto'
+        ? 'NOODLE_UPDATE_MODE=auto'
+        : 'NOODLE_AUTO_UPDATE is set';
+}
+function isFresh(checkedAt) {
+    if (checkedAt === undefined)
+        return false;
+    const checked = Date.parse(checkedAt);
+    if (!Number.isFinite(checked))
+        return false;
+    return Date.now() - checked < UPDATE_CHECK_INTERVAL_MS;
+}
+function isSnoozed(snoozedUntil) {
+    if (snoozedUntil === undefined)
+        return false;
+    const until = Date.parse(snoozedUntil);
+    return Number.isFinite(until) && Date.now() < until;
+}
+function writeCheckCache(home, latestVersion, skillsLatestVersion) {
+    const config = readConfig(home);
+    writeConfig({
+        ...config,
+        updateCheck: {
+            checkedAt: new Date().toISOString(),
+            ...(latestVersion !== undefined ? { latestVersion } : {}),
+            ...(skillsLatestVersion !== undefined ? { skillsLatestVersion } : {}),
+            ...(config.updateCheck?.snoozedUntil !== undefined &&
+                isSnoozed(config.updateCheck.snoozedUntil)
+                ? { snoozedUntil: config.updateCheck.snoozedUntil }
+                : {}),
+        },
+    }, home);
+}
+function snooze(home) {
+    const config = readConfig(home);
+    writeConfig({
+        ...config,
+        updateCheck: {
+            checkedAt: config.updateCheck?.checkedAt ?? new Date().toISOString(),
+            ...(config.updateCheck?.latestVersion !== undefined
+                ? { latestVersion: config.updateCheck.latestVersion }
+                : {}),
+            ...(config.updateCheck?.skillsLatestVersion !== undefined
+                ? { skillsLatestVersion: config.updateCheck.skillsLatestVersion }
+                : {}),
+            snoozedUntil: new Date(Date.now() + UPDATE_CHECK_INTERVAL_MS).toISOString(),
+        },
+    }, home);
+}
+//# sourceMappingURL=update-check.js.map

package/dist/update-check.js.map

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

package/dist/update-render.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Branded rendering for the update flow: the warm palette and step glyphs the
+ * rest of the CLI already speaks (gradient.ts + status.ts), composed - never
+ * reinvented - for version deltas, settled results, and repair notices.
+ *
+ * The 'none' color mode is a hard contract: byte-identical plain, escape-free
+ * copy. It is what agents, CI, pipes, NO_COLOR, and the update-command tests
+ * see, and it matches the #242 spec strings exactly.
+ */
+import { type ColorMode } from './gradient.js';
+/** "Noodle CLI update available: X -> Y" - old version dimmed, arrow amber, new version orange. */
+export declare function renderUpdateAvailable(installed: string, latest: string, mode: ColorMode): string;
+export declare function renderUpToDate(installed: string, mode: ColorMode): string;
+export declare function renderUpdated(installed: string, latest: string, mode: ColorMode): string;
+/** A calm ⚠ line for repair situations; plain mode passes the text through untouched. */
+export declare function renderRepairNotice(text: string, mode: ColorMode): string;
+//# sourceMappingURL=update-render.d.ts.map

package/dist/update-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-render.d.ts","sourceRoot":"","sources":["../src/update-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAS,KAAK,SAAS,EAAkC,MAAM,eAAe,CAAC;AAQtF,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAGhG;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAIzE;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAQxF;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAGxE"}

package/dist/update-render.js

@@ -0,0 +1,39 @@
+/**
+ * Branded rendering for the update flow: the warm palette and step glyphs the
+ * rest of the CLI already speaks (gradient.ts + status.ts), composed - never
+ * reinvented - for version deltas, settled results, and repair notices.
+ *
+ * The 'none' color mode is a hard contract: byte-identical plain, escape-free
+ * copy. It is what agents, CI, pipes, NO_COLOR, and the update-command tests
+ * see, and it matches the #242 spec strings exactly.
+ */
+import { AMBER, detectGlyphMode, ORANGE, paint } from './gradient.js';
+import { renderStep } from './status.js';
+// Control codes composed per the gradient.ts convention (no raw ESC bytes in source).
+const ESC = String.fromCharCode(27);
+const DIM = `${ESC}[2m`;
+const UNDIM = `${ESC}[22m`;
+/** "Noodle CLI update available: X -> Y" - old version dimmed, arrow amber, new version orange. */
+export function renderUpdateAvailable(installed, latest, mode) {
+    if (mode === 'none')
+        return `Noodle CLI update available: ${installed} -> ${latest}`;
+    return `Noodle CLI update available: ${DIM}${installed}${UNDIM} ${paint(AMBER, '→', mode)} ${paint(ORANGE, latest, mode)}`;
+}
+export function renderUpToDate(installed, mode) {
+    const text = `Noodle CLI is up to date. (v${installed})`;
+    if (mode === 'none')
+        return text;
+    return renderStep('done', text, mode, detectGlyphMode());
+}
+export function renderUpdated(installed, latest, mode) {
+    if (mode === 'none')
+        return `Updated Noodle CLI: ${installed} -> ${latest}`;
+    return renderStep('done', `Updated Noodle CLI: ${DIM}${installed}${UNDIM} ${paint(AMBER, '→', mode)} ${paint(ORANGE, latest, mode)}`, mode, detectGlyphMode());
+}
+/** A calm ⚠ line for repair situations; plain mode passes the text through untouched. */
+export function renderRepairNotice(text, mode) {
+    if (mode === 'none')
+        return text;
+    return renderStep('warn', text, mode, detectGlyphMode());
+}
+//# sourceMappingURL=update-render.js.map

package/dist/update-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-render.js","sourceRoot":"","sources":["../src/update-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAkB,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,sFAAsF;AACtF,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AACpC,MAAM,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;AACxB,MAAM,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC;AAE3B,mGAAmG;AACnG,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,MAAc,EAAE,IAAe;IACtF,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,gCAAgC,SAAS,OAAO,MAAM,EAAE,CAAC;IACrF,OAAO,gCAAgC,GAAG,GAAG,SAAS,GAAG,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;AAC7H,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,IAAe;IAC/D,MAAM,IAAI,GAAG,+BAA+B,SAAS,GAAG,CAAC;IACzD,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,MAAc,EAAE,IAAe;IAC9E,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,uBAAuB,SAAS,OAAO,MAAM,EAAE,CAAC;IAC5E,OAAO,UAAU,CACf,MAAM,EACN,uBAAuB,GAAG,GAAG,SAAS,GAAG,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAC1G,IAAI,EACJ,eAAe,EAAE,CAClB,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAe;IAC9D,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/dist/update.d.ts

@@ -1,14 +1,15 @@
 export declare const CLI_PACKAGE_NAME = "@noodleseed/one";
 export declare const GLOBAL_UPDATE_COMMAND = "npm install -g @noodleseed/one@latest";
+export declare const UPDATE_CHECK_INTERVAL_MS: number;
 export declare function currentCliVersion(): string;
-export declare function runUpdateCommand(rest: readonly string[]): Promise<number>;
-export declare function maybeCheckForCliUpdate(input: {
-    readonly command: string | undefined;
-    readonly env: NodeJS.ProcessEnv;
-    readonly home: string;
-    readonly fetchImpl?: typeof fetch;
-    /** Injectable updater (defaults to {@link runUpdateCommand}); used by tests to avoid spawning npm. */
-    readonly runUpdate?: (rest: readonly string[]) => Promise<number>;
-}): Promise<void>;
+/** True for set env toggles, honoring the `0`/`false` opt-outs. */
+export declare function truthyEnv(value: string | undefined): boolean;
+/**
+ * Fetch the registry `latest` dist-tag version of the CLI package. Throws on
+ * failure so callers choose their own inconclusive-network handling. The passive
+ * check uses the default ~1s budget; the explicit `noodle update` command passes
+ * a longer one.
+ */
+export declare function fetchLatestVersion(fetchImpl: typeof fetch, timeoutMs?: number): Promise<string | undefined>;
 export declare function compareVersions(a: string, b: string): number;
 //# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAClD,eAAO,MAAM,qBAAqB,0CAA8C,CAAC;AAOjF,wBAAgB,iBAAiB,IAAI,MAAM,CAO1C;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB/E;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,sGAAsG;IACtG,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACnE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyChB;AA2CD,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5D"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAClD,eAAO,MAAM,qBAAqB,0CAA8C,CAAC;AAEjF,eAAO,MAAM,wBAAwB,QAAsB,CAAC;AAK5D,wBAAgB,iBAAiB,IAAI,MAAM,CAO1C;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG5D;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,OAAO,KAAK,EACvB,SAAS,SAAO,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5D"}