@inf-monkeys-tech/monkeys-cli 0.11.6 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inf-monkeys-tech/monkeys-cli",
-  "version": "0.11.6",
+  "version": "0.12.0",
   "packageManager": "bun@1.3.14",
   "description": "Monkeys command-line client for AI agents, automation, and interactive use",
   "type": "module",
@@ -24,24 +24,22 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json && oclif manifest . && node ./scripts/sort-manifest.mjs",
     "benchmark": "node ./scripts/benchmark.mjs",
-    "checksums": "node ./scripts/checksums.mjs",
-    "ci:prepare-version": "bun ./scripts/ci/prepare-npm-version.ts",
     "ci:create-release": "bun ./scripts/ci/create-gitlab-release.ts",
+    "ci:prepare-version": "bun ./scripts/ci/prepare-npm-version.ts",
     "clean": "node ./scripts/clean.mjs",
     "dev": "tsx ./bin/dev.ts",
     "format": "prettier --write package.json tsconfig.json tsconfig.build.json .prettierrc.json bin scripts src test",
     "format:check": "prettier --check package.json tsconfig.json tsconfig.build.json .prettierrc.json bin scripts src test",
     "language:check": "node ./scripts/check-english.mjs",
     "lint": "tsc -p tsconfig.json --noEmit",
-    "pack:standalone": "bun run build && node ./scripts/oclif-pack.mjs -t win32-x64,linux-x64,darwin-x64",
     "prepack": "bun run clean && bun run build",
     "smoke:installer": "node ./scripts/install-wizard-smoke.mjs",
+    "smoke:contracts": "node ./scripts/cli-contract-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 language:check && bun run lint && bun run test && bun run build && bun run language:check && bun run version:smoke && bun run smoke:update && bun run smoke:installer && bun run smoke:npm && bun run benchmark",
+    "verify": "bun run format:check && bun run language:check && bun run lint && bun run test && bun run build && bun run language:check && bun run version:smoke && bun run smoke:contracts && bun run smoke:update && bun run smoke:installer && bun run smoke:npm && bun run benchmark",
     "version:smoke": "node ./scripts/version-smoke.mjs"
   },
   "oclif": {
@@ -101,11 +99,6 @@
       "workflow": {
         "description": "Create, inspect, run, and transfer workflows"
       }
-    },
-    "update": {
-      "node": {
-        "version": "24.18.0"
-      }
     }
   },
   "dependencies": {
@@ -123,7 +116,6 @@
   },
   "devDependencies": {
     "@types/node": "26.1.2",
-    "7zip-bin": "5.2.0",
     "oclif": "4.23.29",
     "prettier": "3.9.6",
     "tsx": "4.23.1",
@@ -142,5 +134,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "monkeysReleaseCommit": "0049dae670874129adf02664220db487ba49000a"
+  "monkeysReleaseCommit": "f436062418d70f02f95d527a761aa613c91c5953"
 }

package/skills/monkeys-shared/SKILL.md

@@ -12,7 +12,7 @@ description: 通过 monkeys CLI 选择多租户或私有化部署的 Subscriptio
 1. 运行 `monkeys version show`；若 `_notice.update` 存在，只报告升级提示，得到用户授权后才运行 `monkeys update`。
 2. 运行 `monkeys context show --subscription <Subscription>` 核对 endpoint、tenant、credential kind、Surface 与 Team。Subscription 不明确时先用 `monkeys subscription list`，Team 或 Identity 不明确时用 `monkeys team list`、`monkeys identity list`，禁止猜测。
 3. 第一次使用命令或参数不确定时运行 `monkeys schema <command path>`；领域导航不明确时运行 `monkeys --help`。
-4. 默认消费 JSON envelope：成功读取 `.data`，失败读取 `.error`，系统提示读取 `._notice`。需要窄字段时使用 `--jq`；面向人展示时才用 `--format table|text`。
+4. 默认消费 JSON envelope：成功从 stdout 读取 `.data`，失败从 stderr 读取 `.error`，系统提示读取 `._notice`。需要窄字段时使用 `--jq`；面向人展示时才用 `--output table|text`。错误永远不经过 `--jq`。
 5. 写操作先运行 `--dry-run`，回显精确 Subscription、Team、目标 ID 与风险。只有 schema 标记需要确认时才传 `--yes`，不得自动重放结果未知的写请求。
 6. 返回结果、关键资源 ID 与 Context Fingerprint；失败时返回 error code、recovery、retryable 和副作用是否未知。
 

package/skills/monkeys-shared/references/compatibility.md

@@ -1,9 +1,9 @@
 # 兼容性
 
-- 本 Skill 面向命令 Schema Major `3`，最低 CLI 版本 `0.11.0`。
+- 本 Skill 面向命令 Schema Major `4`，最低 CLI 版本 `0.12.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 包后，从新包的全局安装目录同步全部 7 个同版本 Skills，并写入版本与校验和状态；用 `monkeys skills status` 检查漂移，用 `monkeys skills sync` 只重同步 Skills。若 `skillsAction=failed`，报告警告，不回滚 CLI 或猜测 Skill 路径。
+- `monkeys update` 只更新由 npm 或 pnpm 实际拥有的安装，精确安装目标版本，并验证 shell PATH、版本 envelope、全部 7 个同版本 Skills 的实际发现路径与校验和。任一最终验证失败都回滚到精确旧版本并返回结构化错误；用 `monkeys skills status` 检查实际漂移，用 `monkeys skills sync` 只重同步 Skills。
 - CLI Major、命令 Schema Major 或 Skill 声明不兼容时停止写操作，升级匹配版本后再继续。
 - OpenAPI Snapshot 可动态刷新，但语义命令合同不会因刷新而被静默改写。
 - Data 合同由 Deployment 的 `data_contract=auto|ontology-v1|bucket-v1` 决定；`auto` 依次采用精确 OpenAPI、同一上下文缓存和有界只读探测。只有 Ontology 路由明确返回 404 时才探测旧 Bucket 路由。

package/bin/install-wizard.js

@@ -1,77 +0,0 @@
-import { spawnSync } from 'node:child_process';
-import { readFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
-
-const DEFAULT_TIMEOUT_MS = 120_000;
-
-export function createInstallPlan({ packageName, packageRoot }) {
-  if (!packageName) throw new Error('npm package name cannot be empty.');
-  if (!packageRoot) throw new Error('The npm package directory cannot be empty.');
-
-  return [
-    {
-      args: ['install', '--global', packageName],
-      command: 'npm',
-      label: `Install ${packageName} globally`,
-    },
-    {
-      args: ['-y', 'skills', 'add', resolve(packageRoot, 'skills'), '-y', '-g', '--copy'],
-      command: 'npx',
-      label: 'Install Monkeys AI Skills',
-    },
-  ];
-}
-
-export function runCommand(command, args, options = {}) {
-  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',
-    stdio: 'inherit',
-    timeout: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
-  });
-
-  if (result.error) throw result.error;
-  if (result.status !== 0) throw new Error(`${command} failed to execute with exit code ${result.status ?? 'unknown'}.`);
-}
-
-export async function runInstallWizard(options = {}) {
-  const packageRoot = options.packageRoot ?? resolve(import.meta.dirname, '..');
-  const packageJson = JSON.parse(await readFile(resolve(packageRoot, 'package.json'), 'utf8'));
-  const plan = createInstallPlan({ packageName: packageJson.name, packageRoot });
-  const execute = options.execute ?? runCommand;
-  const recordState =
-    options.recordState ??
-    (async () => {
-      const [{ listBundledSkills }, { writeSkillsState }] = await Promise.all([
-        import('../dist/skills/content.js'),
-        import('../dist/skills/state.js'),
-      ]);
-      await writeSkillsState(packageJson.version, await listBundledSkills(resolve(packageRoot, 'skills')), 'install');
-    });
-  const output = options.output ?? ((message) => process.stdout.write(`${message}\n`));
-
-  output('Setting up Monkeys CLI...');
-  for (const step of plan) {
-    output(`${step.label}...`);
-    execute(step.command, step.args);
-  }
-  await recordState({ packageRoot, version: packageJson.version });
-  output('Monkeys CLI and AI Skills are installed.');
-
-  return plan;
-}
-
-export async function runInstallWizardCli() {
-  try {
-    await runInstallWizard();
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    process.stderr.write(`Monkeys CLI installation failed: ${message}\n`);
-    process.stderr.write('You can try again separately: \n');
-    process.stderr.write('  npm install --global @inf-monkeys-tech/monkeys-cli\n');
-    process.stderr.write('  npx -y skills add <skills-directory-from-installed-npm-package> -y -g --copy\n');
-    process.exitCode = 1;
-  }
-}

package/dist/config/fast-subscription-list.d.ts

@@ -1,6 +0,0 @@
-import { type OutputFormat } from '../output/render.js';
-export declare function renderFastSubscriptionList(output: OutputFormat): Promise<{
-    exitCode: number;
-    text: string;
-}>;
-//# sourceMappingURL=fast-subscription-list.d.ts.map

package/dist/config/fast-subscription-list.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fast-subscription-list.d.ts","sourceRoot":"","sources":["../../src/config/fast-subscription-list.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKtE,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAclH"}

package/dist/config/fast-subscription-list.js

@@ -1,19 +0,0 @@
-import { errorResult, successResult } from '../contracts/result.js';
-import { asCliError } from '../errors/cli-error.js';
-import { renderResult } from '../output/render.js';
-import { paginateArray, paginationFingerprint } from '../pagination/index.js';
-import { redactValue } from '../security/redact.js';
-import { ConfigRegistry } from './registry.js';
-export async function renderFastSubscriptionList(output) {
-    try {
-        const data = await paginateArray(await new ConfigRegistry().listSubscriptions(), { pageAll: false, pageDelay: 0, pageLimit: 20, pageSize: 20 }, paginationFingerprint({ command: 'subscription.list' }));
-        const result = successResult(data, { command: 'subscription list' });
-        return { exitCode: 0, text: renderResult(redactValue(result), output) };
-    }
-    catch (error) {
-        const cliError = asCliError(error);
-        const result = errorResult(cliError.toErrorDetail(), { command: 'subscription list' });
-        return { exitCode: cliError.exitCode, text: renderResult(redactValue(result), output) };
-    }
-}
-//# sourceMappingURL=fast-subscription-list.js.map

package/dist/config/fast-subscription-list.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fast-subscription-list.js","sourceRoot":"","sources":["../../src/config/fast-subscription-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAsB,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAqB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,MAAoB;IACnE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,aAAa,CAC9B,MAAM,IAAI,cAAc,EAAE,CAAC,iBAAiB,EAAE,EAC9C,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAC7D,qBAAqB,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CACxD,CAAC;QACF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,WAAW,CAAC,MAAM,CAA2B,EAAE,MAAM,CAAC,EAAE,CAAC;IACpG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACvF,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,WAAW,CAAC,MAAM,CAAyB,EAAE,MAAM,CAAC,EAAE,CAAC;IAClH,CAAC;AACH,CAAC"}