hunter-mate 0.1.12 → 0.1.14

package/dist/assets/server/db/sqlite.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.module.js","sourceRoot":"","sources":["../../src/db/sqlite.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,6CAAgD;AAChD,2CAA6D;AAC7D,yBAAyB;AACzB,6BAA6B;AAC7B,2DAAgE;AAChE,yFAA8E;AAC9E,8DAAoD;AACpD,iFAAsE;AACtE,8FAAmF;AACnF,yEAA8D;AAC9D,gFAAqE;AACrE,sFAA2E;AAC3E,+FAAoF;AACpF,yFAA6E;AAC7E,2DAAiD;AACjD,oFAAwE;AACxE,gFAAqE;AACrE,8EAAmE;AACnE,wFAA6E;AAC7E,kFAAuE;AACvE,0FAA+E;AAC/E,+FAAoF;AACpF,oFAAyE;AACzE,mEAAwD;AACxD,yEAAoE;AACpE,iEAAuD;AACvD,uEAA6D;AAC7D,2EAAgE;AAEhE,MAAM,IAAI,GAAG,GAAG,EAAE,CAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC;AAM9E,MAAM,OAAO,GAAG,GAAG,EAAE,CAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC;AADlD,QAAA,OAAO,WAC2C;AA8DxD,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IAnDxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,uBAAa,CAAC,YAAY,CAAC;gBACzB,OAAO,EAAE,CAAC,qBAAY,CAAC;gBACvB,MAAM,EAAE,CAAC,sBAAa,CAAC;gBACvB,UAAU,EAAE,CAAC,MAAqB,EAAE,EAAE;oBACpC,MAAM,MAAM,GACV,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;wBACzB,IAAI,CAAC,IAAI,CAAC,IAAA,eAAO,GAAE,EAAE,gBAAgB,CAAC,CAAC;oBACzC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBACxD,OAAO;wBACL,IAAI,EAAE,gBAAyB;wBAC/B,QAAQ,EAAE,MAAM;wBAChB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,OAAO;wBACjE,QAAQ,EAAE;4BACR,uCAAc;4BACd,wBAAO;4BACP,uCAAc;4BACd,iDAAmB;4BACnB,iCAAW;4BACX,mCAAY;4BACZ,uCAAc;4BACd,6CAAiB;4BACjB,wCAAc;4BACd,sBAAM;4BACN,4CAAgB;4BAChB,mCAAY;4BACZ,2BAAQ;4BACR,qCAAa;4BACb,+BAAU;4BACV,uCAAc;4BACd,6CAAiB;4BACjB,iCAAW;4BACX,qCAAa;4BACb,0BAAQ;4BACR,8BAAU;4BAEV,iCAAW;4BAIX,uBAAc;yBACf;qBACF,CAAC;gBACJ,CAAC;aACF,CAAC;YACF,uBAAa,CAAC,UAAU,CAAC,CAAC,qCAAa,CAAC,CAAC;SAC1C;QACD,SAAS,EAAE,CAAC,iDAAsB,CAAC;QACnC,OAAO,EAAE,CAAC,iDAAsB,CAAC;KAClC,CAAC;GACW,YAAY,CAAG"}
+{"version":3,"file":"sqlite.module.js","sourceRoot":"","sources":["../../src/db/sqlite.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,6CAAgD;AAChD,2CAA6D;AAC7D,yBAAyB;AACzB,6BAA6B;AAC7B,2DAAgE;AAChE,yFAA8E;AAC9E,8DAAoD;AACpD,iFAAsE;AACtE,8FAAmF;AACnF,yEAA8D;AAC9D,gFAAqE;AACrE,sFAA2E;AAC3E,+FAAoF;AACpF,yFAA6E;AAC7E,2DAAiD;AACjD,oFAAwE;AACxE,gFAAqE;AACrE,8EAAmE;AACnE,wFAA6E;AAC7E,kFAAuE;AACvE,0FAA+E;AAC/E,+FAAoF;AACpF,oFAAyE;AACzE,mEAAwD;AACxD,yEAAoE;AACpE,iEAAsD;AACtD,gFAAqE;AACrE,oFAAyE;AACzE,iEAAuD;AACvD,uEAA6D;AAC7D,2EAAgE;AAEhE,MAAM,IAAI,GAAG,GAAG,EAAE,CAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC;AAM9E,MAAM,OAAO,GAAG,GAAG,EAAE,CAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC;AADlD,QAAA,OAAO,WAC2C;AAkExD,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IAvDxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,uBAAa,CAAC,YAAY,CAAC;gBACzB,OAAO,EAAE,CAAC,qBAAY,CAAC;gBACvB,MAAM,EAAE,CAAC,sBAAa,CAAC;gBACvB,UAAU,EAAE,CAAC,MAAqB,EAAE,EAAE;oBACpC,MAAM,MAAM,GACV,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;wBACzB,IAAI,CAAC,IAAI,CAAC,IAAA,eAAO,GAAE,EAAE,gBAAgB,CAAC,CAAC;oBACzC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBACxD,OAAO;wBACL,IAAI,EAAE,gBAAyB;wBAC/B,QAAQ,EAAE,MAAM;wBAChB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,OAAO;wBACjE,QAAQ,EAAE;4BACR,uCAAc;4BACd,wBAAO;4BACP,uCAAc;4BACd,iDAAmB;4BACnB,iCAAW;4BACX,mCAAY;4BACZ,uCAAc;4BACd,6CAAiB;4BACjB,wCAAc;4BACd,sBAAM;4BACN,4CAAgB;4BAChB,mCAAY;4BACZ,2BAAQ;4BACR,qCAAa;4BACb,+BAAU;4BACV,uCAAc;4BACd,6CAAiB;4BACjB,iCAAW;4BACX,qCAAa;4BACb,0BAAQ;4BACR,8BAAU;4BAEV,iCAAW;4BAIX,uBAAc;4BAEd,6BAAS;4BACT,+BAAU;4BACV,mCAAY;yBACb;qBACF,CAAC;gBACJ,CAAC;aACF,CAAC;YACF,uBAAa,CAAC,UAAU,CAAC,CAAC,qCAAa,CAAC,CAAC;SAC1C;QACD,SAAS,EAAE,CAAC,iDAAsB,CAAC;QACnC,OAAO,EAAE,CAAC,iDAAsB,CAAC;KAClC,CAAC;GACW,YAAY,CAAG"}

package/dist/assets/server/package.json

@@ -14,6 +14,7 @@
     "@chromepilot/kit": "^0.1.3",
     "@chromepilot/logger-kit": "^0.1.4",
     "@hunter-mate/shared": "0.1.5",
+    "@hunter-mate/sync-entities": "workspace:*",
     "@nestjs/axios": "^3.1.3",
     "@nestjs/common": "^10.3.0",
     "@nestjs/config": "^3.1.0",

package/dist/commands/doctor.js

@@ -88,6 +88,52 @@ export async function runDoctor(opts) {
         }
     }
     catch { /* 检测失败不阻断 doctor */ }
+    // ── 0.6) 孤儿 CLI 安装清理(断点 2 现场:运行中的 CLI 是 npm -g 全局安装,
+    //        ~/.hunter-mate/cli 里却残留一份完整安装——自更新每小时往这个孤儿目录
+    //        重复装新版,用户永远跑旧版。检测:运行包根不在 cliPrefix 内 +
+    //        cliPrefix/node_modules/hunter-mate/package.json 存在) ──
+    try {
+        const { detectOrphanPrefixInstall } = await import('../updater.js');
+        const { resolveDataDir } = await import('../config.js');
+        const orphan = detectOrphanPrefixInstall();
+        if (orphan.orphan) {
+            const cliPrefix = path.join(resolveDataDir(), 'cli');
+            const orphanVer = (() => {
+                try {
+                    return JSON.parse(fs.readFileSync(path.join(cliPrefix, 'node_modules', 'hunter-mate', 'package.json'), 'utf-8')).version ?? '?';
+                }
+                catch {
+                    return '?';
+                }
+            })();
+            checks.push({
+                key: 'orphan_cli_install',
+                status: 'warn',
+                detail: `运行中的 CLI 装在 ${orphan.runPkgRoot},但 ${cliPrefix} 残留一份 ${orphanVer} 完整安装(孤儿)。自动更新会错误地装进该目录而非运行入口,建议清理`,
+            });
+            // 删除目录是有损操作:只随显式 --fix 执行,不随 autoHeal 默认开启
+            if (fix) {
+                const { moveEntry } = await import('./migrate.js');
+                const trashDir = path.join(resolveDataDir(), 'trash', `cli-${Date.now()}`);
+                try {
+                    moveEntry(cliPrefix, trashDir);
+                    checks.push({ key: 'orphan_cli_cleanup', status: 'ok', detail: `已移入 ${trashDir}(可手动回滚,确认无用后可删除)` });
+                    healed.push('cleanup_orphan_cli');
+                }
+                catch (e) {
+                    // Windows 上若孤儿目录内文件被占用(npm/node 进程),rename 会 EPERM
+                    checks.push({ key: 'orphan_cli_cleanup', status: 'warn', detail: `清理失败: ${e.message}(请关闭可能占用该目录的进程后重试 hunter-mate doctor --fix)` });
+                }
+            }
+            else {
+                hints.push('运行 hunter-mate doctor --fix 清理孤儿 CLI 安装(移入 trash 目录,可回滚)');
+            }
+        }
+        else {
+            checks.push({ key: 'orphan_cli_install', status: 'ok', detail: `无孤儿 CLI 安装(运行入口: ${orphan.runPkgRoot})` });
+        }
+    }
+    catch { /* 检测失败不阻断 doctor */ }
     // ── 1) 目录 & token ──
     let initResult = null;
     try {

package/dist/commands/ops.js

@@ -36,38 +36,75 @@ const printResult = (data, format) => {
 export const recordingsCommand = new Command('recordings').description('管理录制会话（rrweb/network/console 事件流）');
 recordingsCommand
     .command('start')
-    .description('开始录制: 生成新 sessionId 并通知扩展开始上报事件')
+    .description('开始录制: 生成新 sessionId,注册会话;带 --tab 时经 server 广播通知该 tab 的扩展开始上报事件')
     .requiredOption('--title <text>', '录制标题，例如 LinkedIn 寻访 2026-08-15')
     .option('--tags <csv>', '标签，逗号分隔')
+    .option('--tab <pageId>', '目标 tab id(chromepilot page id);通知该 tab 的扩展立即开录,事件即以本 sessionId 上报')
     .action(async (opts) => {
-    // MVP: 直接调用 server 的 recordings POST 端点（若存在）或返回本地 sessionId 交给扩展
     const sessionId = 'sess_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
+    // 注册会话(server REST 未就绪时忽略,扩展事件到达时会自动建)
     try {
         await http().post(`/api/recordings/${sessionId}/events`, []);
     }
     catch {
         /* 忽略: server REST 未就绪也允许本地启动 */
     }
+    // CLI → server 广播 → 扩展:让目标 tab 的 content script 以本 sessionId 开录
+    let relay = null;
+    if (opts.tab) {
+        try {
+            const r = await http().post('/system/broadcast-extension', {
+                payload: { type: 'start-recording', sessionId, tabId: Number(opts.tab) },
+            });
+            relay = { broadcast: r.data?.broadcast ?? 0, queued: !!r.data?.queued, errors: r.data?.errors };
+        }
+        catch (e) {
+            relay = { broadcast: 0, queued: false, errors: [{ extensionId: '-', error: e?.message ?? String(e) }] };
+        }
+    }
     console.log(JSON.stringify({
         sessionId,
         title: opts.title,
         tags: opts.tags ? opts.tags.split(',').map((s) => s.trim()) : [],
+        tab: opts.tab ? Number(opts.tab) : null,
+        relay,
         startedAt: new Date().toISOString(),
-        next: [
-            `扩展端在同一台机器会自动捕获并带上 sessionId=${sessionId} 上报；`,
-            `用户主动调用 \`hunter-mate extension control cp.state --args '{"sessionId":"${sessionId}"}'\` 确认当前标签页已纳入录制。`,
-        ].join(''),
+        next: opts.tab
+            ? [
+                `扩展已被通知开录(tab ${opts.tab});操作页面后 \`hunter-mate recordings stop ${sessionId} --tab ${opts.tab}\` 停止,`,
+                `再 \`hunter-mate recordings show ${sessionId} --parse\` 解析。`,
+            ].join('')
+            : [
+                '未指定 --tab:扩展未收到开录通知,本 sessionId 不会有事件上报。',
+                '两种补救:① 重跑带 --tab <pageId>;② 在 sidepanel 手动点开始录制(扩展自生成 sessionId,',
+                '用 recordings list 查到后再 show <那个sid> --parse)。',
+            ].join(''),
     }, null, 2));
 });
 recordingsCommand
     .command('stop')
     .argument('<sessionId>', '会话 ID')
+    .option('--tab <pageId>', '目标 tab id;通知该 tab 的扩展停止上报(软标记之外的实际停录)')
     .description('停止录制（软标记，不再接受新事件）')
-    .action(async (sessionId) => {
+    .action(async (sessionId, opts) => {
+    let relay = null;
+    if (opts.tab) {
+        try {
+            const r = await http().post('/system/broadcast-extension', {
+                payload: { type: 'stop-recording', sessionId, tabId: Number(opts.tab) },
+            });
+            relay = { broadcast: r.data?.broadcast ?? 0, queued: !!r.data?.queued, errors: r.data?.errors };
+        }
+        catch (e) {
+            relay = { broadcast: 0, queued: false, errors: [{ extensionId: '-', error: e?.message ?? String(e) }] };
+        }
+    }
     console.log(JSON.stringify({
         sessionId,
+        tab: opts.tab ? Number(opts.tab) : null,
+        relay,
         stoppedAt: new Date().toISOString(),
-        detail: 'stop 目前是客户端软标记。可通过 POST /api/recordings/:sessionId/parse 触发后端解析。',
+        detail: 'stop 是软标记 + 可选扩展停录通知。可通过 POST /api/recordings/:sessionId/parse 触发后端解析。',
     }, null, 2));
 });
 withFormat(recordingsCommand.command('list').description('列出录制会话（从 /api/recordings 端点）'))

package/dist/commands/update.js

@@ -8,7 +8,7 @@ import { i18n } from '../i18n/index.js';
 import { getCliLogger } from '../logger.js';
 import chalk from 'chalk';
 import { readInstalledVersions, ensureRuntimeConsistency } from '../version.js';
-import { isDevLinked, npmLatestVersion, npmSelfUpdate } from '../updater.js';
+import { isDevLinked, npmLatestVersionRobust, npmSelfUpdate } from '../updater.js';
 const RULES_DIR = () => path.join(resolveDataDir(), 'rules');
 const VERSION_FILE = () => path.join(RULES_DIR(), 'version.json');
 function loadLocalVersion() {
@@ -95,17 +95,17 @@ export const updateCommand = new Command('update')
             console.log(chalk.gray(`dev 软链模式，跳过 CLI 自更新(改代码请 pnpm build)；继续执行一致性修复`));
         }
         else if (channel === 'npm') {
-            const latest = npmLatestVersion(npmPackage);
+            const { version: latest, detail } = await npmLatestVersionRobust(npmPackage);
             if (!latest) {
-                console.log(chalk.yellow(`npm registry 查询 ${npmPackage} 失败（未发布或网络问题），跳过自更新`));
+                console.log(chalk.yellow(`npm registry 查询 ${npmPackage} 失败(${detail})，跳过自更新`));
             }
             else if (latest === installed.cli) {
                 console.log(chalk.gray(`CLI 已是最新: ${installed.cli}`));
             }
             else {
                 console.log(chalk.cyan(`CLI 自更新: ${installed.cli} → ${latest}`));
-                const r = await npmSelfUpdate(npmPackage);
-                console.log(r.ok ? chalk.green(r.msg) : chalk.yellow(r.msg));
+                const r = await npmSelfUpdate(npmPackage, latest);
+                console.log(r.ok && r.verified !== false ? chalk.green(r.msg) : chalk.yellow(r.msg));
             }
         }
         // ---- server / 插件 / 扩展 一致性修复（插件 reload / server 重启 / 扩展广播 reload） ----

package/dist/index.js

@@ -107,9 +107,11 @@ program
         else
             console.log(text);
     };
+    let cliUpdated = false;
     try {
         const { maybeCliSelfUpdate } = await import('./updater.js');
         const upd = await maybeCliSelfUpdate();
+        cliUpdated = upd.updated === true;
         for (const line of upd.logs)
             notify(line);
     }
@@ -118,7 +120,9 @@ program
     }
     try {
         const { ensureRuntimeConsistency } = await import('./version.js');
-        const report = await ensureRuntimeConsistency({});
+        // 刚完成 CLI 自更新:force+verbose 跑一次,让扩展 reload / server 重启 / 插件 reload
+        // 立即生效并逐行可见;未更新时维持 60s 节流轻量检查,不放大每条命令的副作用
+        const report = await ensureRuntimeConsistency(cliUpdated ? { force: true, verbose: true } : {});
         if (report.performed.length) {
             for (const line of report.performed)
                 notify(line);

package/dist/updater.d.ts

@@ -1,3 +1,20 @@
+/**
+ * 七牛 CDN 发布镜像(hcweb-temp-file bucket,hunter-mate-releases/ 前缀)。
+ * 工厂 pnpm-release 发布后上传 tgz + latest.json,并只保留最近 5 个版本;
+ * npm registry 不可达时(国内网络/Windows 现场)CLI 回退到这里查版本与下载。
+ * 覆盖方式:HUNTER_MATE_CDN_BASE(测试/内网镜像用)。
+ */
+export declare const CDN_RELEASES_BASE: string;
+export interface CdnReleaseManifest {
+    version: string;
+    tgz: string;
+    publishedAt?: string;
+}
+/**
+ * 从 CDN 读 latest.json 发布清单(10s 超时,proxy:false 绕开死代理)。
+ * 工厂上传脚本负责维护该文件;不存在/解析失败返回 null。
+ */
+export declare function fetchCdnLatestManifest(): Promise<CdnReleaseManifest | null>;
 /**
  * 判定是否开发软链模式(纯函数,便于单测):
  * 包根路径含 /worktrees/ 段(hc-hw local worktree 布局)或 HUNTER_MATE_DEV=1。
@@ -5,15 +22,91 @@
  */
 export declare function computeDevLinked(pkgRoot: string): boolean;
 export declare function isDevLinked(): boolean;
-export declare const npmLatestVersion: (pkg?: string) => string | null;
 export declare const updateCheckIntervalMs: () => number;
 export declare const shouldCheckUpdate: (stateFile?: string, now?: number, intervalMs?: number) => boolean;
 export declare const markUpdateChecked: (stateFile?: string) => void;
+/**
+ * 解析 npm 可执行命令(纯函数,便于单测)。
+ * - HUNTER_MATE_NPM_BIN 显式指定时优先(沙盒内局部 npm)
+ * - win32 下 spawn 不解析 PATHEXT,直接 spawn 'npm' 会 ENOENT;必须走 npm.cmd + shell
+ * - 其余平台原生 npm,无需 shell
+ */
+export declare function resolveNpmCommand(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): {
+    cmd: string;
+    shell: boolean;
+};
+/**
+ * 构造剔除死代理的子进程 env(复用 utils/proxy-detect)。
+ * 返回 env 与给用户的提示语;检测失败不阻断(沿用 npmSelfUpdate 原有语义)。
+ */
+export declare function buildSanitizedNpmEnv(): Promise<{
+    env: NodeJS.ProcessEnv;
+    proxyNote: string;
+}>;
+export interface NpmLatestVersionResult {
+    version: string | null;
+    /** 失败原因细分,便于现场定位(ENOENT/timeout/exit) */
+    detail: string;
+}
+/**
+ * 健壮版最新版本查询:npm registry 优先,失败回退七牛 CDN latest.json。
+ * (kit 版 15s 裸 spawn 在 Windows/代理环境必失败,见文件头 TODO)
+ */
+export declare function npmLatestVersionRobust(pkg?: string): Promise<NpmLatestVersionResult>;
+/** 当前运行 CLI 的包根(dist 的上一级),realpath 归一 */
+export declare function getCliPkgRoot(): string;
+export type CliInstallLayout = {
+    mode: 'prefix';
+    prefix: string;
+    reason: string;
+} | {
+    mode: 'global';
+    reason: string;
+} | {
+    mode: 'custom-prefix';
+    prefix: string;
+    reason: string;
+} | {
+    mode: 'skip';
+    reason: string;
+} | {
+    mode: 'fallback';
+    prefix: string;
+    reason: string;
+};
+/**
+ * 判定当前运行 CLI 的安装形态(纯函数;global 判定依赖调用方预解析的 globalPrefix,
+ * globalPrefix===undefined 表示尚未解析,有 node_modules 祖先时返回 fallback 提示调用方先解析)。
+ *
+ * 优先级:
+ * 1. pkgRoot 在 cliPrefix(~/.hunter-mate/cli)下 → prefix(设计形态,现有行为)
+ * 2. pkgRoot 在 ROOT 内但不在 cliPrefix(Release 二进制/daemon 布局)→ skip,npm 自更新不适用
+ * 3. 有 node_modules 祖先:
+ *    - globalPrefix 已知且 pkgRoot 在其下 → global(npm install -g,不带 --prefix)
+ *    - globalPrefix 已知但不在其下 → custom-prefix(prefix = node_modules 父目录,装回原处)
+ *    - globalPrefix 未知 → fallback(调用方通常应先 spawn `npm prefix -g` 解析)
+ * 4. 无 node_modules 祖先且不在 ROOT 下 → fallback(未识别形态,沿用原 --prefix 行为)
+ */
+export declare function detectCliInstallLayout(pkgRootIn: string, cliPrefixIn: string, globalPrefixIn?: string | null): CliInstallLayout;
+/** spawn `npm prefix -g` 解析全局前缀(10s 封顶,失败返回 null,不阻断) */
+export declare function resolveGlobalNpmPrefix(): Promise<string | null>;
+/** 孤儿 ~/.hunter-mate/cli 安装检测(doctor orphan_cli_install 检查项;纯函数) */
+export declare function detectOrphanPrefixInstall(pkgRootIn?: string, cliPrefixIn?: string): {
+    orphan: boolean;
+    orphanPkgDir?: string;
+    runPkgRoot: string;
+};
 export interface NpmSelfUpdateResult {
     ok: boolean;
     msg: string;
+    /** 装后验证:目标位置版本是否等于期望版本(null=未验证) */
+    verified?: boolean;
 }
-export declare function npmSelfUpdate(pkg?: string): Promise<NpmSelfUpdateResult>;
+export declare function npmSelfUpdate(pkg?: string, expectedVersion?: string, 
+/** 测试注入:覆盖"当前运行 CLI 包根"的判定 */
+opts?: {
+    pkgRoot?: string;
+}): Promise<NpmSelfUpdateResult>;
 export interface CliUpdateOutcome {
     logs: string[];
     devSkipped: boolean;