@whobot/cli 2.0.2 → 2.0.3

package/bin/install.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import { spawnSync } from "node:child_process";
 import {
   accessSync,
@@ -678,9 +678,14 @@ export async function runExplicitInstall(argv, env) {
   const staging = await fs.mkdtemp(path.join(os.tmpdir(), "whobot-install-preflight-"));
   const stagedNative = path.join(staging, path.basename(packageNativeBinary(prefix)));
   const updateArgs = ["update", "--yes", "--target-version", pkg.version];
+  const installId = randomUUID();
+  const reportAttrs = { installId, version: pkg.version, channel: bakedChannel(), previousVersion: registered };
+  let staged = false;
   let prepared;
   try {
     await ensureNativeBinary(env, { force: true, dest: stagedNative, version: pkg.version });
+    staged = true;
+    reportViaNative(stagedNative, "install_started", "ok", { attrs: reportAttrs }, env);
     verifyNpmEntryVersion(stagedNative, pkg.version, env);
     if (resetLocal) runResetLocal(stagedNative, env);
     runInstallPhase(stagedNative, ["update", "check-install", "--previous-binary", packageNativeBinary(prefix)], env, "binding", registered);
@@ -695,17 +700,43 @@ export async function runExplicitInstall(argv, env) {
     const installed = await verifyInstalledCLI(tools, npmEnv, prefix, pkg.version, env, ignoreLauncher);
     runInstallPhase(installed.native, updateArgs, env, "verify", registered);
     await prepared.discard();
+    reportViaNative(installed.native, "install_succeeded", "ok", { attrs: reportAttrs }, env);
     if (resetLocal) logStderr("本机登录已清理，请重新登录。");
     logStderr(`CLI 软件安装已完成；请更新 Skill 至对应渠道最新版，重载宿主或新建任务后重新预检。v2 后续更新请运行 ${COMMAND} update，并执行确认卡中的命令。`);
     return entry;
   } catch (err) {
     if (prepared) await prepared.restore();
+    // Before the program is staged there is nothing to report with.
+    if (staged) {
+      reportViaNative(stagedNative, "install_failed", "failed", { errorCode: failureCode(err) || "INSTALL_FAILED", attrs: reportAttrs }, env);
+    }
     throw err;
   } finally {
     await fs.rm(staging, { recursive: true, force: true });
   }
 }
 
+// reportViaNative records an install/update fact for analytics (ADR-0020)
+// through the native program's hidden reporter, which carries its compiled API
+// address, client id and AI host. Its outcome is ignored and it is bounded, so
+// it never fails or stalls an install or update.
+const REPORT_TIMEOUT_MS = 5000;
+export function reportViaNative(native, name, result, { errorCode = "", attrs = {} } = {}, env = process.env) {
+  const args = ["telemetry", "report", "--name", name, "--result", result];
+  if (errorCode) args.push("--error-code", errorCode);
+  for (const [key, value] of Object.entries(attrs)) {
+    if (value !== undefined && value !== null && value !== "") args.push("--attr", `${key}=${value}`);
+  }
+  const reportEnv = { ...env };
+  delete reportEnv.WHOBOT_UPDATE_PHASE;
+  spawnSync(native, args, { env: reportEnv, stdio: "ignore", timeout: REPORT_TIMEOUT_MS, windowsHide: true });
+}
+
+function failureCode(err) {
+  const code = err && typeof err.code === "string" ? err.code : "";
+  return /^[A-Z][A-Z0-9_]{0,63}$/.test(code) ? code : "";
+}
+
 function runInstallPhase(native, args, env, phase, previous, wantVersion = pkg.version) {
   const result = spawnSync(native, args, {
     encoding: "utf8",
@@ -856,10 +887,12 @@ export async function runWhobot(argv, env) {
   }
   await recoverNativeBackup(nativeBinaryPath(pkgRoot));
   if (isUpdateApply(argv)) {
+    const updateAttrs = { updateId: randomUUID(), fromVersion: pkg.version };
+    let started = false;
     try {
       rejectExternalChannel(env);
       parseChannelAndForward(argv);
-      confirmedTargetVersion(argv);
+      updateAttrs.toVersion = confirmedTargetVersion(argv);
       let currentNative = nativeBinaryPath(pkgRoot);
       let preflightDir;
       let pre;
@@ -902,7 +935,10 @@ export async function runWhobot(argv, env) {
       if (!preflight.ok || preflight.data?.installedVersion !== pkg.version || preflight.next?.action !== "done") {
         throw new InstallerError("更新前检查没有确认可以替换程序", "UPDATE_VERIFY_FAILED");
       }
+      reportViaNative(nativeBinaryPath(pkgRoot), "update_started", "ok", { attrs: updateAttrs }, env);
+      started = true;
       const updated = await runExplicitUpdate(argv, env);
+      reportViaNative(updated.native, "update_succeeded", "replaced", { attrs: { ...updateAttrs, fromVersion: updated.previous, toVersion: updated.installedVersion } }, env);
       spawnNative(
         updated.native,
         updated.forwarded,
@@ -916,6 +952,9 @@ export async function runWhobot(argv, env) {
       );
     } catch (err) {
       const code = err?.code === "CHANNEL_INVALID" ? "CHANNEL_INVALID" : "UPDATE_VERIFY_FAILED";
+      if (started) {
+        reportViaNative(nativeBinaryPath(pkgRoot), "update_failed", "failed", { errorCode: failureCode(err) || code, attrs: updateAttrs }, env);
+      }
       const message = err && err.message ? err.message : String(err);
       writeJSONFailure(code, message);
       process.stderr.write(`${message}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whobot/cli",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "Whobot CLI: npm-managed JS launcher that runs the in-package Go binary.",
   "type": "module",
   "bin": {