@inf-monkeys-tech/monkeys-cli 0.10.2 → 0.10.4

package/README.md

@@ -165,6 +165,29 @@ monkeys profile use --name <profile-name> --output json
 monkeys profile test --name <profile-name> --output json
 ```
 
+## Updates
+
+Every normal CLI invocation reads a local update cache. When npm `latest` is newer, JSON output includes `_notice.update`, while text output prints the exact recovery command:
+
+```text
+Update available: 0.10.2 → 0.10.3. Run `monkeys update` to install.
+```
+
+The cache is refreshed from npm in a detached background process at most once every 24 hours, so update discovery does not delay the requested command. CI environments, non-release builds, and processes with `MONKEYS_CLI_NO_UPDATE_NOTIFIER=1` skip the notifier.
+
+```bash
+# Check only; makes no installation changes
+monkeys update --check --output json
+
+# Upgrade the global npm package and sync the matching bundled Skill
+monkeys update
+
+# Reinstall the current latest CLI and retry Skill synchronization
+monkeys update --force
+```
+
+Running bare `monkeys` in an interactive terminal also offers an optional `[y/N]` upgrade prompt. The update command always resolves the target version live from npm instead of trusting the cached notice.
+
 ## Command System
 
 monkeys-cli provides three levels of access, from stable domain operations to the low-level API actually published by a deployment.

package/README.zh.md

@@ -165,6 +165,29 @@ monkeys profile use --name <profile-name> --output json
 monkeys profile test --name <profile-name> --output json
 ```
 
+## 版本更新
+
+每次正常调用 CLI 都会读取本地更新缓存。npm `latest` 高于当前版本时，JSON 输出会包含 `_notice.update`，Text 输出会直接提示准确的恢复命令：
+
+```text
+Update available: 0.10.2 → 0.10.3. Run `monkeys update` to install.
+```
+
+CLI 最多每 24 小时在独立后台进程中刷新一次 npm 缓存，不会因版本查询拖慢当前命令。CI、非发布版本以及设置了 `MONKEYS_CLI_NO_UPDATE_NOTIFIER=1` 的进程不会检查更新。
+
+```bash
+# 只检查，不执行安装
+monkeys update --check --output json
+
+# 升级全局 npm 包，并同步新包中匹配版本的 Skill
+monkeys update
+
+# 强制重装当前最新版，并重试 Skill 同步
+monkeys update --force
+```
+
+在交互式终端裸运行 `monkeys` 时，还会显示可选的 `[y/N]` 升级询问。执行升级时始终从 npm 实时解析目标版本，不会直接信任缓存中的提示版本。
+
 ## 命令体系
 
 monkeys-cli 提供三种调用粒度，从稳定领域操作到部署实际发布的底层 API。

package/bin/run.js

@@ -1,7 +1,11 @@
 #!/usr/bin/env node
 
+import { readFile } from 'node:fs/promises';
+import { createInterface } from 'node:readline/promises';
+
 const args = process.argv.slice(2);
 const install = args.length === 1 && args[0] === 'install';
+const update = args[0] === 'update';
 const fastVersion =
   args[0] === 'version' &&
   args[1] === 'show' &&
@@ -10,15 +14,34 @@ const fastProfileList =
   args[0] === 'profile' &&
   args[1] === 'list' &&
   (args.length === 2 || (args.length === 4 && args[2] === '--output' && ['json', 'text'].includes(args[3])));
+
+let packageJson;
+let updateNotice;
+if (!install && !update) {
+  packageJson = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+  const { initializeUpdateNotifier } = await import('../dist/update/notifier.js');
+  updateNotice = await initializeUpdateNotifier(packageJson.version);
+}
+
+if (args.length === 0 && updateNotice && process.stdin.isTTY && process.stdout.isTTY && process.stderr.isTTY) {
+  try {
+    const prompt = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+      const answer = await prompt.question(`A newer monkeys CLI is available (current ${updateNotice.current}). Upgrade now? [y/N]: `);
+      if (['y', 'yes'].includes(answer.trim().toLowerCase())) process.argv.splice(2, 0, 'update');
+    } finally {
+      prompt.close();
+    }
+  } catch {
+    // The optional prompt must never block the requested CLI help output.
+  }
+}
+
 if (install) {
   const { runInstallWizardCli } = await import('./install-wizard.js');
   await runInstallWizardCli();
 } else if (fastVersion) {
-  const [{ readFile }, { BUNDLED_SKILL_MINIMUM_CLI_VERSION, BUNDLED_SKILL_NAME, COMMAND_SCHEMA_MAJOR }] = await Promise.all([
-    import('node:fs/promises'),
-    import('../dist/contracts/version.js'),
-  ]);
-  const packageJson = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+  const { BUNDLED_SKILL_MINIMUM_CLI_VERSION, BUNDLED_SKILL_NAME, COMMAND_SCHEMA_MAJOR } = await import('../dist/contracts/version.js');
   const data = {
     cliVersion: packageJson.version,
     commandSchemaMajor: COMMAND_SCHEMA_MAJOR,
@@ -30,10 +53,20 @@ if (install) {
   const output = outputIndex >= 0 ? args[outputIndex + 1] : 'text';
   if (output === 'json') {
     process.stdout.write(
-      `${JSON.stringify({ data, meta: { command: 'version show', schemaVersion: '1', timestamp: new Date().toISOString() }, ok: true })}\n`,
+      `${JSON.stringify({
+        ...(updateNotice ? { _notice: { update: updateNotice } } : {}),
+        data,
+        meta: { command: 'version show', schemaVersion: '1', timestamp: new Date().toISOString() },
+        ok: true,
+      })}\n`,
     );
   } else {
     process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+    if (updateNotice) {
+      process.stdout.write(
+        `\nUpdate available: ${updateNotice.current} → ${updateNotice.latest}. Run \`${updateNotice.command}\` to install.\n`,
+      );
+    }
   }
 } else if (fastProfileList) {
   const { renderFastProfileList } = await import('../dist/config/fast-profile-list.js');

package/bin/update-cache.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+const currentVersion = process.argv[2];
+if (currentVersion) {
+  const { refreshUpdateCache } = await import('../dist/update/notifier.js');
+  await refreshUpdateCache(currentVersion);
+}

package/dist/commands/update.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class Update extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        check: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private printResult;
+    private toCliError;
+}
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAmB7C,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,OAAgB,WAAW,SAA0C;IACrE,OAAgB,QAAQ,WAAkF;IAC1G,OAAgB,KAAK;QACnB,KAAK;QACL,KAAK;QACL,MAAM;MACN;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAmEzB;IAED,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,UAAU;CAYnB"}

package/dist/commands/update.js

@@ -0,0 +1,110 @@
+import { Command, Flags } from '@oclif/core';
+import { errorResult, successResult } from '../contracts/result.js';
+import { asCliError, CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { renderResult } from '../output/render.js';
+import { redactValue } from '../security/redact.js';
+import { clearPendingUpdateNotice, fetchLatestVersion, isNewerVersion } from '../update/notifier.js';
+import { installCliAndSkill, UpdateProcessError } from '../update/updater.js';
+export default class Update extends Command {
+    static description = '检查或安装最新版本的 monkeys CLI，并同步同版本 Skill。';
+    static examples = ['<%= config.bin %> update --check --output json', '<%= config.bin %> update'];
+    static flags = {
+        check: Flags.boolean({ default: false, summary: '只检查更新，不执行安装' }),
+        force: Flags.boolean({ default: false, summary: '即使已是最新版本也重新安装 CLI 与 Skill' }),
+        output: Flags.string({ default: 'text', options: ['json', 'text'], summary: '输出格式' }),
+    };
+    async run() {
+        clearPendingUpdateNotice();
+        const { flags } = await this.parse(Update);
+        const output = flags.output;
+        const currentVersion = this.config.version;
+        try {
+            let latestVersion;
+            try {
+                latestVersion = await fetchLatestVersion();
+            }
+            catch (error) {
+                throw new CliError('无法查询 npm 最新版本。', {
+                    cause: error,
+                    code: 'UPDATE_CHECK_FAILED',
+                    exitCode: EXIT_CODES.network,
+                    recovery: ['检查网络或 npm registry 访问后重试 monkeys update --check。'],
+                    retryable: true,
+                });
+            }
+            const updateAvailable = isNewerVersion(latestVersion, currentVersion);
+            if (flags.check) {
+                const result = {
+                    action: updateAvailable ? 'update_available' : 'already_up_to_date',
+                    autoUpdate: true,
+                    command: 'monkeys update',
+                    currentVersion,
+                    latestVersion,
+                    previousVersion: currentVersion,
+                };
+                this.printResult(result, output);
+                return;
+            }
+            if (!updateAvailable && !flags.force) {
+                this.printResult({
+                    action: 'already_up_to_date',
+                    autoUpdate: true,
+                    command: 'monkeys update',
+                    currentVersion,
+                    latestVersion,
+                    previousVersion: currentVersion,
+                }, output);
+                return;
+            }
+            if (output === 'text')
+                process.stderr.write(`Updating monkeys ${currentVersion} → ${latestVersion} via npm ...\n`);
+            const installed = await installCliAndSkill(latestVersion);
+            this.printResult({
+                action: 'updated',
+                autoUpdate: true,
+                command: 'monkeys update',
+                currentVersion: installed.currentVersion,
+                latestVersion,
+                previousVersion: currentVersion,
+                skillsAction: installed.skillsAction,
+                ...(installed.skillsWarning ? { skillsWarning: installed.skillsWarning } : {}),
+            }, output);
+        }
+        catch (error) {
+            const cliError = this.toCliError(error);
+            this.log(renderResult(redactValue(errorResult(cliError.toErrorDetail(), { command: 'update' })), output));
+            this.exit(cliError.exitCode);
+        }
+    }
+    printResult(result, output) {
+        if (output === 'json') {
+            this.log(renderResult(successResult(result, { command: 'update' }), output));
+            return;
+        }
+        switch (result.action) {
+            case 'already_up_to_date':
+                this.log(`✓ monkeys ${result.currentVersion} is already up to date.`);
+                break;
+            case 'update_available':
+                this.log(`Update available: ${result.currentVersion} → ${result.latestVersion}\n\nRun \`${result.command}\` to install.`);
+                break;
+            case 'updated':
+                this.log(`✓ Successfully updated monkeys from ${result.previousVersion} to ${result.currentVersion}.`);
+                this.log(result.skillsAction === 'synced' ? '✓ Monkeys Skill updated.' : `⚠ ${result.skillsWarning ?? 'Monkeys Skill update failed.'}`);
+                break;
+        }
+    }
+    toCliError(error) {
+        if (error instanceof UpdateProcessError) {
+            return new CliError(error.message, {
+                cause: error,
+                code: 'UPDATE_FAILED',
+                exitCode: EXIT_CODES.internal,
+                recovery: ['检查 npm/npx、网络和全局安装目录权限后重试。', '仅重试 Skill 可运行 monkeys update --force。'],
+                safeDetails: { command: error.command, detail: error.detail },
+            });
+        }
+        return asCliError(error);
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/contracts/result.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { type UpdateNotice } from '../update/notifier.js';
 export declare const RESULT_SCHEMA_VERSION: '1';
 export declare const contextSummarySchema: z.ZodObject<{
     authSurface: z.ZodOptional<z.ZodString>;
@@ -18,10 +19,14 @@ export interface ResultMeta {
     warnings?: string[];
 }
 export interface SuccessResult<T> {
+    _notice?: SystemNotice;
     data: T;
     meta: ResultMeta;
     ok: true;
 }
+export interface SystemNotice {
+    update?: UpdateNotice;
+}
 export interface ErrorDetail {
     code: string;
     fallbackEligible: boolean;
@@ -31,6 +36,7 @@ export interface ErrorDetail {
     safeDetails?: unknown;
 }
 export interface ErrorResult {
+    _notice?: SystemNotice;
     error: ErrorDetail;
     meta: ResultMeta;
     ok: false;

package/dist/contracts/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/contracts/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB,EAAG,GAAY,CAAC;AAElD,eAAO,MAAM,oBAAoB;;;;;;;iBAO/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,qBAAqB,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,IAAI,CAAC;CACV;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,KAAK,CAAC;CACX;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAM9D,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,GAAG,WAAW,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEjH;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,GAAG,WAAW,CAAC,GAAG,WAAW,CAElH"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/contracts/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAElF,eAAO,MAAM,qBAAqB,EAAG,GAAY,CAAC;AAElD,eAAO,MAAM,oBAAoB;;;;;;;iBAO/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,qBAAqB,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,IAAI,CAAC;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,KAAK,CAAC;CACX;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAW9D,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,GAAG,WAAW,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEjH;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,GAAG,WAAW,CAAC,GAAG,WAAW,CAElH"}

package/dist/contracts/result.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { getPendingUpdateNotice } from '../update/notifier.js';
 export const RESULT_SCHEMA_VERSION = '1';
 export const contextSummarySchema = z.object({
     authSurface: z.string().optional(),
@@ -11,10 +12,14 @@ export const contextSummarySchema = z.object({
 function createMeta(input) {
     return { ...input, schemaVersion: RESULT_SCHEMA_VERSION, timestamp: new Date().toISOString() };
 }
+function currentNotice() {
+    const update = getPendingUpdateNotice();
+    return update ? { _notice: { update } } : {};
+}
 export function successResult(data, meta) {
-    return { data, meta: createMeta(meta), ok: true };
+    return { ...currentNotice(), data, meta: createMeta(meta), ok: true };
 }
 export function errorResult(error, meta) {
-    return { error, meta: createMeta(meta), ok: false };
+    return { ...currentNotice(), error, meta: createMeta(meta), ok: false };
 }
 //# sourceMappingURL=result.js.map

package/dist/contracts/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/contracts/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAY,CAAC;AAElD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAoCH,SAAS,UAAU,CAAC,KAAsD;IACxE,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,aAAa,CAAI,IAAO,EAAE,IAAqD;IAC7F,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAkB,EAAE,IAAqD;IACnG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AACtD,CAAC"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/contracts/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAqB,MAAM,uBAAuB,CAAC;AAElF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAY,CAAC;AAElD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AA0CH,SAAS,UAAU,CAAC,KAAsD;IACxE,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AACjG,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,aAAa,CAAI,IAAO,EAAE,IAAqD;IAC7F,OAAO,EAAE,GAAG,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAkB,EAAE,IAAqD;IACnG,OAAO,EAAE,GAAG,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC1E,CAAC"}

package/dist/output/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAMtD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAOtF"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAMtD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAWtF"}

package/dist/output/render.js

@@ -6,8 +6,13 @@ export function renderResult(result, format) {
         return JSON.stringify(result);
     if (format === 'ndjson') {
         const items = result.ok && Array.isArray(result.data) ? result.data : [result];
-        return items.map((item) => JSON.stringify(item)).join('\n');
+        const lines = items.map((item) => JSON.stringify(item));
+        if (result.ok && Array.isArray(result.data) && result._notice)
+            lines.push(JSON.stringify({ _notice: result._notice }));
+        return lines.join('\n');
     }
-    return result.ok ? renderTextValue(result.data) : `${result.error.code}: ${result.error.message}`;
+    const body = result.ok ? renderTextValue(result.data) : `${result.error.code}: ${result.error.message}`;
+    const update = result._notice?.update;
+    return update ? `${body}\n\nUpdate available: ${update.current} → ${update.latest}. Run \`${update.command}\` to install.` : body;
 }
 //# sourceMappingURL=render.js.map

package/dist/output/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"AAIA,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,MAAwB,EAAE,MAAoB;IAC5E,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;AACpG,CAAC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"AAIA,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,MAAwB,EAAE,MAAoB;IAC5E,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACvH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACxG,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;IACtC,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,yBAAyB,MAAM,CAAC,OAAO,MAAM,MAAM,CAAC,MAAM,WAAW,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;AACpI,CAAC"}

package/dist/update/notifier.d.ts

@@ -0,0 +1,43 @@
+export declare const UPDATE_CHECK_TTL_MS: number;
+export declare const UPDATE_FETCH_TIMEOUT_MS = 15000;
+export declare const UPDATE_NOTIFIER_DISABLE_ENV = "MONKEYS_CLI_NO_UPDATE_NOTIFIER";
+export declare const UPDATE_REGISTRY_URL = "https://registry.npmjs.org/@inf-monkeys-tech%2Fmonkeys-cli/latest";
+export interface UpdateNotice {
+    command: 'monkeys update';
+    current: string;
+    latest: string;
+    message: string;
+}
+export interface UpdateState {
+    checkedAt: number;
+    latestVersion: string;
+}
+export interface FetchLatestOptions {
+    fetchImpl?: typeof fetch;
+    registryUrl?: string;
+    timeoutMs?: number;
+}
+export interface UpdateCacheOptions extends FetchLatestOptions {
+    env?: NodeJS.ProcessEnv;
+    nowMs?: number;
+    statePath?: string;
+}
+export interface InitializeUpdateNotifierOptions extends UpdateCacheOptions {
+    scheduleRefresh?: (currentVersion: string) => void;
+}
+export declare function compareVersions(left: string, right: string): number | undefined;
+export declare function isNewerVersion(candidate: string, current: string): boolean;
+export declare function isReleaseVersion(version: string): boolean;
+export declare function isCiEnvironment(env?: NodeJS.ProcessEnv): boolean;
+export declare function shouldSkipUpdateNotifier(currentVersion: string, env?: NodeJS.ProcessEnv): boolean;
+export declare function updateStatePath(env?: NodeJS.ProcessEnv): string;
+export declare function createUpdateNotice(current: string, latest: string): UpdateNotice;
+export declare function getPendingUpdateNotice(): UpdateNotice | undefined;
+export declare function clearPendingUpdateNotice(): void;
+export declare function setPendingUpdateNotice(notice: UpdateNotice | undefined): void;
+export declare function readUpdateState(path?: string): Promise<UpdateState | undefined>;
+export declare function fetchLatestVersion(options?: FetchLatestOptions): Promise<string>;
+export declare function refreshUpdateCache(currentVersion: string, options?: UpdateCacheOptions): Promise<boolean>;
+export declare function scheduleUpdateCacheRefresh(currentVersion: string): void;
+export declare function initializeUpdateNotifier(currentVersion: string, options?: InitializeUpdateNotifierOptions): Promise<UpdateNotice | undefined>;
+//# sourceMappingURL=notifier.d.ts.map

package/dist/update/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/update/notifier.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB,QAAuB,CAAC;AACxD,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,eAAO,MAAM,2BAA2B,mCAAmC,CAAC;AAC5E,eAAO,MAAM,mBAAmB,sEAAsE,CAAC;AAWvG,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,+BAAgC,SAAQ,kBAAkB;IACzE,eAAe,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAmCD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS/E;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE7E;AAED,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE9G;AAED,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE5E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAOhF;AAED,wBAAgB,sBAAsB,IAAI,YAAY,GAAG,SAAS,CAEjE;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAE7E;AAUD,wBAAsB,eAAe,CAAC,IAAI,SAAoB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAMhG;AAqCD,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAY1F;AAqBD,wBAAsB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBnH;AAED,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAavE;AAED,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAenC"}

package/dist/update/notifier.js

@@ -0,0 +1,242 @@
+import { spawn } from 'node:child_process';
+import { open, mkdir, readFile, rename, rm, stat } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { configDirectory, resolveConfigPath } from '../config/paths.js';
+export const UPDATE_CHECK_TTL_MS = 24 * 60 * 60 * 1_000;
+export const UPDATE_FETCH_TIMEOUT_MS = 15_000;
+export const UPDATE_NOTIFIER_DISABLE_ENV = 'MONKEYS_CLI_NO_UPDATE_NOTIFIER';
+export const UPDATE_REGISTRY_URL = 'https://registry.npmjs.org/@inf-monkeys-tech%2Fmonkeys-cli/latest';
+const MAX_RESPONSE_BYTES = 256 * 1_024;
+const REFRESH_LOCK_STALE_MS = UPDATE_FETCH_TIMEOUT_MS * 2;
+const UPDATE_STATE_FILE = 'update-state.json';
+let pendingUpdateNotice;
+function isNodeError(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+function parseVersion(value) {
+    const match = /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z.-]+)?$/.exec(value.trim());
+    if (!match)
+        return undefined;
+    const core = [Number(match[1]), Number(match[2]), Number(match[3])];
+    if (!core.every(Number.isSafeInteger))
+        return undefined;
+    return { core, prerelease: match[4]?.split('.') ?? [] };
+}
+function comparePrerelease(left, right) {
+    if (left.length === 0 || right.length === 0)
+        return left.length === right.length ? 0 : left.length === 0 ? 1 : -1;
+    const length = Math.max(left.length, right.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftValue = left[index];
+        const rightValue = right[index];
+        if (leftValue === undefined || rightValue === undefined)
+            return leftValue === rightValue ? 0 : leftValue === undefined ? -1 : 1;
+        if (leftValue === rightValue)
+            continue;
+        const leftNumeric = /^\d+$/.test(leftValue);
+        const rightNumeric = /^\d+$/.test(rightValue);
+        if (leftNumeric && rightNumeric)
+            return Number(leftValue) - Number(rightValue);
+        if (leftNumeric !== rightNumeric)
+            return leftNumeric ? -1 : 1;
+        return leftValue.localeCompare(rightValue);
+    }
+    return 0;
+}
+export function compareVersions(left, right) {
+    const parsedLeft = parseVersion(left);
+    const parsedRight = parseVersion(right);
+    if (!parsedLeft || !parsedRight)
+        return undefined;
+    for (let index = 0; index < parsedLeft.core.length; index += 1) {
+        const difference = parsedLeft.core[index] - parsedRight.core[index];
+        if (difference !== 0)
+            return difference;
+    }
+    return comparePrerelease(parsedLeft.prerelease, parsedRight.prerelease);
+}
+export function isNewerVersion(candidate, current) {
+    return (compareVersions(candidate, current) ?? 0) > 0;
+}
+export function isReleaseVersion(version) {
+    return parseVersion(version) !== undefined;
+}
+export function isCiEnvironment(env = process.env) {
+    return ['CI', 'BUILD_NUMBER', 'RUN_ID'].some((key) => Boolean(env[key]));
+}
+export function shouldSkipUpdateNotifier(currentVersion, env = process.env) {
+    return Boolean(env[UPDATE_NOTIFIER_DISABLE_ENV]) || isCiEnvironment(env) || !isReleaseVersion(currentVersion);
+}
+export function updateStatePath(env = process.env) {
+    return join(configDirectory(resolveConfigPath(env)), UPDATE_STATE_FILE);
+}
+export function createUpdateNotice(current, latest) {
+    return {
+        command: 'monkeys update',
+        current,
+        latest,
+        message: `monkeys ${latest} available, current ${current}, run: monkeys update`,
+    };
+}
+export function getPendingUpdateNotice() {
+    return pendingUpdateNotice;
+}
+export function clearPendingUpdateNotice() {
+    pendingUpdateNotice = undefined;
+}
+export function setPendingUpdateNotice(notice) {
+    pendingUpdateNotice = notice;
+}
+function parseUpdateState(value) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const candidate = value;
+    if (!Number.isSafeInteger(candidate.checkedAt) || typeof candidate.latestVersion !== 'string')
+        return undefined;
+    if (!isReleaseVersion(candidate.latestVersion))
+        return undefined;
+    return { checkedAt: candidate.checkedAt, latestVersion: candidate.latestVersion };
+}
+export async function readUpdateState(path = updateStatePath()) {
+    try {
+        return parseUpdateState(JSON.parse(await readFile(path, 'utf8')));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function atomicWrite(path, content) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const temporary = `${path}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    let handle;
+    try {
+        handle = await open(temporary, 'wx', 0o600);
+        await handle.writeFile(content, 'utf8');
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        await rename(temporary, path);
+    }
+    finally {
+        if (handle !== undefined)
+            await handle.close();
+        await rm(temporary, { force: true });
+    }
+}
+async function readLimitedBody(response) {
+    if (!response.body)
+        return '';
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        total += value.byteLength;
+        if (total > MAX_RESPONSE_BYTES) {
+            await reader.cancel();
+            throw new Error('npm registry response exceeds the maximum allowed size');
+        }
+        chunks.push(value);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+export async function fetchLatestVersion(options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const response = await fetchImpl(options.registryUrl ?? UPDATE_REGISTRY_URL, {
+        headers: { accept: 'application/json' },
+        signal: AbortSignal.timeout(options.timeoutMs ?? UPDATE_FETCH_TIMEOUT_MS),
+    });
+    if (!response.ok)
+        throw new Error(`npm registry returned HTTP ${response.status}`);
+    const body = JSON.parse(await readLimitedBody(response));
+    if (typeof body.version !== 'string' || !isReleaseVersion(body.version)) {
+        throw new Error('npm registry returned an invalid package version');
+    }
+    return body.version;
+}
+async function acquireRefreshLock(path, nowMs) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    try {
+        const handle = await open(path, 'wx', 0o600);
+        await handle.writeFile(JSON.stringify({ createdAt: nowMs, pid: process.pid }));
+        return handle;
+    }
+    catch (error) {
+        if (!isNodeError(error, 'EEXIST'))
+            return undefined;
+        const existing = await stat(path).catch(() => undefined);
+        if (!existing || nowMs - existing.mtimeMs <= REFRESH_LOCK_STALE_MS)
+            return undefined;
+        await rm(path, { force: true });
+        try {
+            return await open(path, 'wx', 0o600);
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+export async function refreshUpdateCache(currentVersion, options = {}) {
+    const env = options.env ?? process.env;
+    if (shouldSkipUpdateNotifier(currentVersion, env))
+        return false;
+    const path = options.statePath ?? updateStatePath(env);
+    const nowMs = options.nowMs ?? Date.now();
+    const cached = await readUpdateState(path);
+    if (cached && nowMs - cached.checkedAt < UPDATE_CHECK_TTL_MS)
+        return false;
+    const lockPath = `${path}.lock`;
+    const lock = await acquireRefreshLock(lockPath, nowMs);
+    if (!lock)
+        return false;
+    try {
+        const latestState = await readUpdateState(path);
+        if (latestState && nowMs - latestState.checkedAt < UPDATE_CHECK_TTL_MS)
+            return false;
+        const latestVersion = await fetchLatestVersion(options);
+        await atomicWrite(path, `${JSON.stringify({ checkedAt: nowMs, latestVersion })}\n`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        await lock.close().catch(() => undefined);
+        await rm(lockPath, { force: true }).catch(() => undefined);
+    }
+}
+export function scheduleUpdateCacheRefresh(currentVersion) {
+    try {
+        const worker = fileURLToPath(new URL('../../bin/update-cache.js', import.meta.url));
+        const child = spawn(process.execPath, [worker, currentVersion], {
+            detached: true,
+            env: process.env,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        child.unref();
+    }
+    catch {
+        // Update discovery must never affect the requested command.
+    }
+}
+export async function initializeUpdateNotifier(currentVersion, options = {}) {
+    clearPendingUpdateNotice();
+    const env = options.env ?? process.env;
+    if (shouldSkipUpdateNotifier(currentVersion, env))
+        return undefined;
+    const path = options.statePath ?? updateStatePath(env);
+    const nowMs = options.nowMs ?? Date.now();
+    const state = await readUpdateState(path);
+    if (state && isNewerVersion(state.latestVersion, currentVersion)) {
+        setPendingUpdateNotice(createUpdateNotice(currentVersion, state.latestVersion));
+    }
+    if (!state || nowMs - state.checkedAt >= UPDATE_CHECK_TTL_MS) {
+        (options.scheduleRefresh ?? scheduleUpdateCacheRefresh)(currentVersion);
+    }
+    return getPendingUpdateNotice();
+}
+//# sourceMappingURL=notifier.js.map

package/dist/update/notifier.js.map

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

package/dist/update/updater.d.ts

@@ -0,0 +1,26 @@
+export declare const MONKEYS_NPM_PACKAGE = "@inf-monkeys-tech/monkeys-cli";
+export interface ProcessResult {
+    error?: Error;
+    status: number | null;
+    stderr: string;
+    stdout: string;
+}
+export type ProcessRunner = (command: string, args: string[]) => ProcessResult;
+export interface InstallUpdateOptions {
+    packageName?: string;
+    runner?: ProcessRunner;
+}
+export interface InstallUpdateResult {
+    currentVersion: string;
+    packageRoot: string;
+    skillsAction: 'failed' | 'synced';
+    skillsWarning?: string;
+}
+export declare class UpdateProcessError extends Error {
+    readonly command: string;
+    readonly detail: string;
+    constructor(message: string, command: string, detail: string);
+}
+export declare function runUpdateProcess(command: string, args: string[]): ProcessResult;
+export declare function installCliAndSkill(latestVersion: string, options?: InstallUpdateOptions): Promise<InstallUpdateResult>;
+//# sourceMappingURL=updater.d.ts.map

package/dist/update/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../../src/update/updater.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,kCAAkC,CAAC;AAInE,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,aAAa,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAK3D;CACF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAe/E;AAuBD,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoDhI"}

package/dist/update/updater.js

@@ -0,0 +1,91 @@
+import { spawnSync } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+export const MONKEYS_NPM_PACKAGE = '@inf-monkeys-tech/monkeys-cli';
+const UPDATE_PROCESS_TIMEOUT_MS = 120_000;
+const MAX_PROCESS_DETAIL = 2_000;
+export class UpdateProcessError extends Error {
+    command;
+    detail;
+    constructor(message, command, detail) {
+        super(message);
+        this.name = 'UpdateProcessError';
+        this.command = command;
+        this.detail = detail;
+    }
+}
+export function runUpdateProcess(command, args) {
+    const windows = process.platform === 'win32';
+    const executable = windows ? (process.env.ComSpec ?? 'cmd.exe') : command;
+    const commandArgs = windows ? ['/d', '/s', '/c', command, ...args] : args;
+    const result = spawnSync(executable, commandArgs, {
+        encoding: 'utf8',
+        timeout: UPDATE_PROCESS_TIMEOUT_MS,
+        windowsHide: true,
+    });
+    return {
+        ...(result.error ? { error: result.error } : {}),
+        status: result.status,
+        stderr: result.stderr ?? '',
+        stdout: result.stdout ?? '',
+    };
+}
+function processDetail(result) {
+    return `${result.stdout}\n${result.stderr}`.trim().slice(0, MAX_PROCESS_DETAIL);
+}
+function requireSuccess(result, command, message) {
+    if (!result.error && result.status === 0)
+        return;
+    throw new UpdateProcessError(message, command, processDetail(result) || result.error?.message || 'unknown failure');
+}
+function parseGlobalRoot(result) {
+    requireSuccess(result, 'npm root --global', '无法确定 npm 全局安装目录。');
+    const lines = result.stdout
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (lines.length !== 1 || !isAbsolute(lines[0])) {
+        throw new UpdateProcessError('npm 返回了无效的全局安装目录。', 'npm root --global', processDetail(result));
+    }
+    return lines[0];
+}
+export async function installCliAndSkill(latestVersion, options = {}) {
+    const packageName = options.packageName ?? MONKEYS_NPM_PACKAGE;
+    const runner = options.runner ?? runUpdateProcess;
+    const installResult = runner('npm', ['install', '--global', `${packageName}@${latestVersion}`]);
+    requireSuccess(installResult, `npm install --global ${packageName}@${latestVersion}`, 'npm 全局升级失败。');
+    const globalRoot = parseGlobalRoot(runner('npm', ['root', '--global']));
+    const packageRoot = join(globalRoot, ...packageName.split('/'));
+    let manifest;
+    try {
+        manifest = JSON.parse(await readFile(join(packageRoot, 'package.json'), 'utf8'));
+    }
+    catch (error) {
+        throw new UpdateProcessError('无法验证升级后的 npm 包。', `read ${join(packageRoot, 'package.json')}`, error instanceof Error ? error.message : String(error));
+    }
+    if (manifest.name !== packageName || manifest.version !== latestVersion) {
+        throw new UpdateProcessError('升级后的 npm 包版本与目标版本不一致。', `read ${join(packageRoot, 'package.json')}`, JSON.stringify({
+            actualName: manifest.name,
+            actualVersion: manifest.version,
+            expectedName: packageName,
+            expectedVersion: latestVersion,
+        }));
+    }
+    try {
+        await readFile(join(packageRoot, 'skills', 'monkeys', 'SKILL.md'), 'utf8');
+    }
+    catch (error) {
+        throw new UpdateProcessError('升级后的 npm 包缺少 monkeys Skill。', `read ${join(packageRoot, 'skills', 'monkeys', 'SKILL.md')}`, error instanceof Error ? error.message : String(error));
+    }
+    const skillsResult = runner('npx', ['-y', 'skills', 'add', join(packageRoot, 'skills'), '-y', '-g', '--copy']);
+    if (skillsResult.error || skillsResult.status !== 0) {
+        return {
+            currentVersion: latestVersion,
+            packageRoot,
+            skillsAction: 'failed',
+            skillsWarning: `CLI 已升级，但 Skill 同步失败：${processDetail(skillsResult) || skillsResult.error?.message || 'unknown failure'}`,
+        };
+    }
+    return { currentVersion: latestVersion, packageRoot, skillsAction: 'synced' };
+}
+//# sourceMappingURL=updater.js.map

package/dist/update/updater.js.map

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

package/oclif.manifest.json

@@ -9206,6 +9206,55 @@
       ],
       "strict": true
     },
+    "update": {
+      "aliases": [],
+      "args": {},
+      "description": "检查或安装最新版本的 monkeys CLI，并同步同版本 Skill。",
+      "enableJsonFlag": false,
+      "examples": [
+        "<%= config.bin %> update --check --output json",
+        "<%= config.bin %> update"
+      ],
+      "flags": {
+        "check": {
+          "allowNo": false,
+          "name": "check",
+          "summary": "只检查更新，不执行安装",
+          "type": "boolean"
+        },
+        "force": {
+          "allowNo": false,
+          "name": "force",
+          "summary": "即使已是最新版本也重新安装 CLI 与 Skill",
+          "type": "boolean"
+        },
+        "output": {
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "name": "output",
+          "options": [
+            "json",
+            "text"
+          ],
+          "summary": "输出格式",
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "update",
+      "isESM": true,
+      "pluginAlias": "@inf-monkeys-tech/monkeys-cli",
+      "pluginName": "@inf-monkeys-tech/monkeys-cli",
+      "pluginType": "core",
+      "relativePath": [
+        "dist",
+        "commands",
+        "update.js"
+      ],
+      "strict": true
+    },
     "version:check": {
       "aliases": [],
       "args": {},
@@ -9876,5 +9925,5 @@
       "strict": true
     }
   },
-  "version": "0.10.2"
+  "version": "0.10.4"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inf-monkeys-tech/monkeys-cli",
-  "version": "0.10.2",
+  "version": "0.10.4",
   "packageManager": "bun@1.3.14",
   "description": "面向 AI Agent、自动化和人工操作的 Monkeys 命令行客户端",
   "type": "module",
@@ -37,10 +37,11 @@
     "smoke:installer": "node ./scripts/install-wizard-smoke.mjs",
     "smoke:npm": "node ./scripts/npm-install-smoke.mjs",
     "smoke:standalone": "node ./scripts/standalone-smoke.mjs",
+    "smoke:update": "node ./scripts/update-notifier-smoke.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
-    "verify": "bun run format:check && bun run lint && bun run test && bun run build && bun run version:smoke && bun run smoke:installer && bun run smoke:npm && bun run benchmark",
-    "version:smoke": "node ./bin/run.js version show --output json && node ./bin/run.js version check --output json"
+    "verify": "bun run format:check && bun run lint && bun run test && bun run build && bun run version:smoke && bun run smoke:update && bun run smoke:installer && bun run smoke:npm && bun run benchmark",
+    "version:smoke": "node ./scripts/version-smoke.mjs"
   },
   "oclif": {
     "bin": "monkeys",
@@ -86,5 +87,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "monkeysReleaseCommit": "f9e1db581e85e68b7d1ec0b7c78b9f0057279e5a"
+  "monkeysReleaseCommit": "648e57673fad23c8cc34421cde54cac0e1045c81"
 }

package/skills/monkeys/SKILL.md

@@ -9,7 +9,7 @@ description: 理解并通过 monkeys CLI 安全操作 Monkeys 平台的多租户
 
 ## 执行流程
 
-1. 运行 `monkeys version show --output json`，确认 CLI 可用和命令 Schema 兼容。
+1. 运行 `monkeys version show --output json`，确认 CLI 可用和命令 Schema 兼容。若输出包含 `_notice.update`，向用户报告新版本和 `monkeys update`；只有用户明确同意升级后才执行该全局安装命令。
 2. 选择明确的 `--profile`。Data 任务按[Data 视角路由](references/data-perspective.md)选择显式 `--perspective`：Kernel 全局读取默认不传 `--team`，只有用户明确筛选时才传；Field、View、Feature Value、Advanced Search 和 Asset Export 等需要数据资源定位时传已确认的 `--resource-team`。Studio 使用明确的 Team 上下文。不要在任务中途隐式切换上下文。
 3. 在第一次使用命令或参数不确定时运行 `monkeys <命令> --help`。以 CLI 帮助为参数真相，不凭记忆补参数。
 4. 优先调用 Workflow、Execution、Agent Work、File、Data、System Config 等语义命令，并使用 `--output json`。解析结构化结果和退出码，不解析面向人的 Text 文案。

package/skills/monkeys/references/compatibility.md

@@ -2,6 +2,8 @@
 
 - 本 Skill 面向命令 Schema Major `1`，最低 CLI 版本 `0.10.0`。
 - 开始任务时运行 `monkeys version show --output json`。
+- 任意结构化输出中的 `_notice.update` 表示 npm `latest` 高于当前 CLI；报告 `current`、`latest` 与 `command`。可用 `monkeys update --check --output json` 实时复核，只有用户明确授权后才运行 `monkeys update` 或 `monkeys update --force`。
+- `monkeys update` 升级全局 npm 包后，从新包的全局安装目录同步同版本 `monkeys` Skill；若 CLI 已升级但 `skillsAction=failed`，报告警告并在用户同意后用 `monkeys update --force` 重试，不回滚或猜测 Skill 路径。
 - CLI Major、命令 Schema Major 或 Skill 声明不兼容时停止写操作，升级匹配版本后再继续。
 - OpenAPI Snapshot 可动态刷新，但语义命令合同不会因刷新而被静默改写。
 - Data 合同由 Deployment 的 `data_contract=auto|ontology-v1|bucket-v1` 决定；`auto` 依次采用精确 OpenAPI、同一上下文缓存和有界只读探测。只有 Ontology 路由明确返回 404 时才探测旧 Bucket 路由。