@coze/cli 0.2.0 → 0.3.1

package/bin/postinstall.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+// ABOUTME: npm postinstall 钩子：安装/升级后静默执行 `coze self skill install`，
+// ABOUTME: 把 CLI 自带 skills 同步给本机 AI agents；失败则降级为提示，绝不阻断安装。
+//
+// 注意：npm >= 7 默认后台执行生命周期脚本并丢弃输出（需 --foreground-scripts
+// 才展示），因此 npm 用户通常看不到本脚本的打印；pnpm、yarn classic 及旧版
+// npm 会正常转发。同步失败时的兜底是运行时的 update-check 中间件：skills
+// 缺失或与 CLI 版本不一致时，任何命令结束后都会提示 `coze self skill install`。
+// 不要在这里检测 process.stdout.isTTY —— 包管理器执行脚本时 stdout 总是
+// pipe，加了等于在所有包管理器下永久静默。
+
+const SYNC_TIMEOUT_MS = 120000;
+
+try {
+  const { existsSync, readFileSync } = require('fs');
+  const { join } = require('path');
+  const { homedir } = require('os');
+  const { spawnSync } = require('child_process');
+
+  // CI 环境不执行同步（不可控环境不写家目录）
+  // 开发仓库内的安装（rush update / pnpm install）也跳过：发布包不含 src/
+  if (process.env.CI || existsSync(join(__dirname, '..', 'src'))) {
+    process.exit(0);
+  }
+
+  const useColor = !process.env.NO_COLOR;
+  const cyan = text => (useColor ? `[36m${text}[0m` : text);
+
+  // 通过包内 CLI 入口走真实的 `coze self skill install` 代码路径（skipAuth，纯本地：
+  // 释放 bundled skills 到 ~/.coze/cli/skills 并软链到已安装的 AI agents）。
+  // 用户改过的 skill 不会被覆盖（sync 默认不带 --force 即阻止）。
+  const result = spawnSync(
+    process.execPath,
+    [join(__dirname, 'main'), 'self', 'skill', 'install'],
+    {
+      stdio: 'ignore',
+      timeout: SYNC_TIMEOUT_MS,
+      env: { ...process.env, DOTENV_CONFIG_QUIET: 'true' },
+    },
+  );
+
+  // sync 被用户改过的 skill 阻止时也会 exit 0（仅告警不写入），
+  // 因此用 lock 里的版本与包版本比对来确认是否真正同步成功
+  let synced = result.status === 0;
+  if (synced) {
+    try {
+      const lock = JSON.parse(
+        readFileSync(
+          join(homedir(), '.coze', 'cli', '.skill-lock.json'),
+          'utf8',
+        ),
+      );
+      synced = lock.cliVersion === require('../package.json').version;
+      // eslint-disable-next-line @coze-arch/no-empty-catch -- unreadable lock means sync did not complete
+    } catch {
+      synced = false;
+    }
+  }
+
+  if (synced) {
+    process.stdout.write(
+      `\nCoze CLI installed. Bundled skills synced to your AI agents (run ${cyan(
+        'coze self skill status',
+      )} to inspect).\n\n`,
+    );
+  } else {
+    process.stdout.write(
+      `\nCoze CLI installed. Run ${cyan(
+        'coze self skill install',
+      )} to sync the bundled skills to your AI agents (Claude Code, Trae, Comate, ...).\n\n`,
+    );
+  }
+  // eslint-disable-next-line @coze-arch/no-empty-catch -- postinstall sync is best-effort and must never block install
+} catch {
+  // postinstall 同步失败不应阻断安装；运行时 update-check 会兜底提示
+}
+process.exit(0);