hunter-mate 0.1.15 → 0.1.17

package/dist/i18n/locales/en-US.json

@@ -1,79 +0,0 @@
-{
-    "cli.description": "HiredChina headhunter Agent data assistant",
-    "cli.langOption": "Output language (zh-CN/en-US)",
-    "login.description": "Login: OAuth device code by default; use --email for email verification code (two steps: send code first, then verify with --code)",
-    "login.start": "Opening browser to complete login...",
-    "login.userCode": "User code:",
-    "login.verifyUrl": "Verification URL:",
-    "login.success": "Login successful",
-    "login.failed": "Login failed:",
-    "login.expired": "Device code expired, please try again",
-    "login.emailCodeSent": "Verification code sent to your email (valid for 10 minutes). Continue with step 2:",
-    "login.emailCodeNextStep": "hunter-mate login --email <email> --code <6-digit code>",
-    "login.emailCodeMissing": "Missing --code. Step 2 usage: hunter-mate login --email <email> --code <6-digit code>",
-    "logout.description": "Logout and delete local token",
-    "logout.success": "Logged out",
-    "status.description": "Check service, login, and extension status",
-    "status.cli": "CLI version",
-    "status.loggedIn": "Logged in",
-    "status.loggedOut": "Not logged in",
-    "status.server": "Server status",
-    "status.extension": "Extension status",
-    "config.description": "Configure server address, watch folder, language",
-    "config.saved": "Configuration saved",
-    "search.description": "Talent search",
-    "search.filter": "Structured filter conditions",
-    "search.source": "Data sources, comma separated",
-    "search.top": "Return count",
-    "job.description": "Job case management",
-    "job.create": "Create JobCase from folder",
-    "update.description": "Check and update CLI/Server/Extension/Rule",
-    "update.checking": "Checking for updates...",
-    "update.latest": "Already up to date",
-    "extension.description": "Browser extension management",
-    "extension.checkDescription": "Check WebSocket connection between extension and local server",
-    "extension.connected": "WebSocket connection is healthy",
-    "extension.timeout": "Connection timed out, please make sure the server is running",
-    "extension.error": "Connection failed: {{message}}",
-    "purge.description": "Completely wipe local hunter-mate: stop server and remove ~/.hunter-mate (aliases: reset/uninstall)",
-    "purge.forceOption": "Skip interactive confirmation (for scripts/CI)",
-    "purge.preview.title": "⚠️  About to delete the following:",
-    "purge.preview.root": "Data directory",
-    "purge.preview.exists": "Directory exists",
-    "purge.preview.yes": "Yes",
-    "purge.preview.no": "No",
-    "purge.preview.noExist": "does not exist",
-    "purge.preview.size": "Data size",
-    "purge.preview.files": "files",
-    "purge.preview.running": "Running server detected",
-    "purge.preview.willStop": "will be stopped first",
-    "purge.preview.includes": "Including but not limited to:",
-    "purge.preview.loginLost": "you will be logged out",
-    "purge.confirm.prompt": "Confirm deleting ALL data above? This cannot be undone! (y/N) ",
-    "purge.confirm.cancelled": "Cancelled. No data removed.",
-    "purge.error.rmFailed": "Failed to remove directory",
-    "purge.done.title": "✅ Local hunter-mate data fully purged",
-    "purge.done.root": "Removed directory",
-    "purge.done.removed": "Removed",
-    "purge.done.server": "Server",
-    "purge.done.next": "To re-initialize, run",
-    "purge.done.nothing": "Nothing to purge",
-    "login.serverOfflineSaasFallback": "Warning: local server is not running; logged in via SaaS directly. Start the server and run login again for local data operations.",
-    "login.serverOfflineReloginHint": "Note: the saved SaaS token will be rejected (401) by local server protected routes.",
-    "login.selfCheckOk": "Login self-check passed: protected endpoint reachable",
-    "login.selfCheckFail": "Login self-check failed: new token rejected by local server; please report with full output",
-    "login.selfCheckSkipped": "Login self-check skipped: local server unreachable; re-login once it is back",
-    "issueEnv.description": "Print the environment block needed for issue reports (CLI version / install type / git HEAD / server buildTime / OS); --format json for agents to paste directly",
-    "issueEnv.cliVersion": "CLI version",
-    "issueEnv.installType": "Install type",
-    "issueEnv.installDev": "dev (git worktree of source repo)",
-    "issueEnv.installPackage": "package (published npm build)",
-    "issueEnv.gitHead": "Code HEAD (version/buildTime do not identify code state; HEAD does)",
-    "issueEnv.gitBranch": "Branch",
-    "issueEnv.gitDirty": "uncommitted changes (dist may lag HEAD)",
-    "issueEnv.gitClean": "clean worktree",
-    "issueEnv.repoRoot": "Repo root",
-    "issueEnv.gitUnavailable": "unavailable (published package has no git info; use CLI version instead)",
-    "issueEnv.serverBuildTime": "server buildTime",
-    "issueEnv.serverNotRunning": "server not running (unavailable)"
-}

package/dist/i18n/locales/zh-CN.json

@@ -1,79 +0,0 @@
-{
-    "cli.description": "HiredChina 猎头 Agent 数据助手",
-    "cli.langOption": "输出语言(zh-CN/en-US)",
-    "login.description": "登录:默认 OAuth 设备码;--email 走邮箱验证码(两步:先发码,后带 --code 校验)",
-    "login.start": "正在打开浏览器完成登录...",
-    "login.userCode": "用户码:",
-    "login.verifyUrl": "授权地址:",
-    "login.success": "登录成功",
-    "login.failed": "登录失败:",
-    "login.expired": "设备码已过期，请重试",
-    "login.emailCodeSent": "验证码已发送到邮箱(10 分钟内有效)。请查收后执行第二步:",
-    "login.emailCodeNextStep": "hunter-mate login --email <邮箱> --code <6位验证码>",
-    "login.emailCodeMissing": "缺少 --code。第二步用法:hunter-mate login --email <邮箱> --code <6位验证码>",
-    "logout.description": "退出登录并删除本地 token",
-    "logout.success": "已退出登录",
-    "status.description": "查看服务、登录、扩展状态",
-    "status.cli": "CLI 版本",
-    "status.loggedIn": "已登录",
-    "status.loggedOut": "未登录",
-    "status.server": "Server 状态",
-    "status.extension": "扩展状态",
-    "config.description": "配置 server 地址、监听文件夹、语言",
-    "config.saved": "配置已保存",
-    "search.description": "人才搜索",
-    "search.filter": "结构化过滤条件",
-    "search.source": "数据源,逗号分隔",
-    "search.top": "返回数量",
-    "job.description": "职位/案件管理",
-    "job.create": "从文件夹创建 JobCase",
-    "update.description": "检测并更新 CLI/Server/Extension/Rule",
-    "update.checking": "正在检查更新...",
-    "update.latest": "当前已是最新版本",
-    "extension.description": "浏览器扩展管理",
-    "extension.checkDescription": "检测扩展与本地 Server 的 WebSocket 连接",
-    "extension.connected": "WebSocket 连接正常",
-    "extension.timeout": "连接超时，请确认 server 是否启动",
-    "extension.error": "连接失败: {{message}}",
-    "purge.description": "彻底清理本地 hunter-mate：停止 server 并删除 ~/.hunter-mate（别名 reset/uninstall）",
-    "purge.forceOption": "跳过二次确认，直接删除（脚本/CI 用）",
-    "purge.preview.title": "⚠️  即将删除以下内容：",
-    "purge.preview.root": "数据目录",
-    "purge.preview.exists": "目录存在",
-    "purge.preview.yes": "是",
-    "purge.preview.no": "否",
-    "purge.preview.noExist": "不存在",
-    "purge.preview.size": "数据规模",
-    "purge.preview.files": "个文件",
-    "purge.preview.running": "检测到运行中的 server",
-    "purge.preview.willStop": "将先停止再删除",
-    "purge.preview.includes": "包含但不限于：",
-    "purge.preview.loginLost": "将丢失登录态",
-    "purge.confirm.prompt": "确认删除以上全部数据？此操作不可恢复！(y/N) ",
-    "purge.confirm.cancelled": "已取消，未删除任何数据。",
-    "purge.error.rmFailed": "删除目录失败",
-    "purge.done.title": "✅ 本地 hunter-mate 数据已清理干净",
-    "purge.done.root": "已删除目录",
-    "purge.done.removed": "清理数据量",
-    "purge.done.server": "Server 状态",
-    "purge.done.next": "如需重新初始化，请运行",
-    "purge.done.nothing": "无需清理",
-    "login.serverOfflineSaasFallback": "警告: 本地 server 未运行,已直连 SaaS 登录;本地数据操作需启动 server 后重新 login。",
-    "login.serverOfflineReloginHint": "提示: 本次保存的是 SaaS 令牌,本地 server 的受保护路由将返回 401。",
-    "login.selfCheckOk": "✓ 登录自检通过:受保护接口可达,search/report/job 可直接使用",
-    "login.selfCheckFail": "✗ 登录自检失败:新令牌被本地 server 拒绝,请带完整输出反馈,勿反复重试",
-    "login.selfCheckSkipped": "⚠ 登录自检跳过:本地 server 暂不可达,恢复后请重新 login",
-    "issueEnv.description": "输出提 issue 所需环境块(CLI 版本/安装方式/代码 git HEAD/server buildTime/OS),--format json 可供 agent 直接粘贴",
-    "issueEnv.cliVersion": "CLI 版本",
-    "issueEnv.installType": "安装方式",
-    "issueEnv.installDev": "dev(源码仓 git 工作区)",
-    "issueEnv.installPackage": "package(发布包)",
-    "issueEnv.gitHead": "代码 HEAD(版本号/buildTime 不说明代码状态,以 HEAD 为准)",
-    "issueEnv.gitBranch": "分支",
-    "issueEnv.gitDirty": "有未提交改动(dist 可能滞后于 HEAD)",
-    "issueEnv.gitClean": "工作区干净",
-    "issueEnv.repoRoot": "代码仓",
-    "issueEnv.gitUnavailable": "未获取(发布包无 git 信息,用 CLI 版本代替)",
-    "issueEnv.serverBuildTime": "server buildTime",
-    "issueEnv.serverNotRunning": "server 未运行(未获取)"
-}

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import 'dotenv/config';

package/dist/keychain.d.ts

@@ -1,18 +0,0 @@
-/**
- * token 签发方(hmh#43):
- * - local: 本地 server 自签 UTOKEN(设备码/邮箱代理路径),AuthMiddleware 可直接验签;
- * - saas:  邮箱登录时本地 server 不可达,CLI 直连 SaaS 验证拿到的 token,
- *          由 SaaS 密钥签发,本地 server 的 USER_SESSION_SECRET 验不过 → 数据面 401;
- * - unknown: 旧版本存的裸 token(无 issuer 标记),无法区分签发方。
- */
-export type TokenIssuer = 'local' | 'saas' | 'unknown';
-export interface TokenInfo {
-    token: string;
-    issuer: TokenIssuer;
-}
-export declare function saveToken(token: string, issuer?: TokenIssuer): Promise<void>;
-/** 只取 token 字符串(兼容全部历史调用方) */
-export declare function getToken(): Promise<string | null>;
-/** 取 token + 签发方标记(hmh#43 诊断用) */
-export declare function getTokenInfo(): Promise<TokenInfo | null>;
-export declare function deleteToken(): Promise<void>;

package/dist/keychain.js

@@ -1,109 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { resolveDataDir } from './config.js';
-const SERVICE = 'hunter-mate';
-const ACCOUNT = 'user';
-/** token 落盘文件(FID-071:随 dataDir 配置迁移;keytar 可用时不使用) */
-function tokenFile() {
-    return path.join(resolveDataDir(), 'token.json');
-}
-/** 兼容旧格式:裸 token 字符串或无 issuer 字段的 JSON */
-function parseStored(raw) {
-    if (!raw)
-        return null;
-    try {
-        const data = JSON.parse(raw);
-        if (typeof data === 'string')
-            return { token: data, issuer: 'unknown' };
-        if (data && typeof data.token === 'string') {
-            const issuer = data.issuer === 'saas' || data.issuer === 'local' ? data.issuer : 'unknown';
-            return { token: data.token, issuer };
-        }
-        return null;
-    }
-    catch {
-        return { token: raw, issuer: 'unknown' };
-    }
-}
-function fallbackSave(info) {
-    fs.mkdirSync(path.dirname(tokenFile()), { recursive: true });
-    // POSIX 上 mode 0o600 强制 owner-only;Windows NTFS 上 mode bit 被忽略,
-    // 由用户目录 ACL 兜底(%USERPROFILE%\.hunter-mate 默认只有当前用户可访问)。
-    // 真正安全的 Windows 路径是走 keytar(Windows Credential Manager)→ setPassword。
-    fs.writeFileSync(tokenFile(), JSON.stringify(info), { mode: 0o600 });
-}
-function fallbackGet() {
-    if (!fs.existsSync(tokenFile()))
-        return null;
-    try {
-        return parseStored(fs.readFileSync(tokenFile(), 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-function fallbackDelete() {
-    if (fs.existsSync(tokenFile())) {
-        fs.unlinkSync(tokenFile());
-    }
-}
-async function getKeytar() {
-    // Linux(尤其 headless/CI)上 keytar dlopen libsecret 会直接 SIGSEGV,
-    // try/catch 拦不住进程级段错误——一律文件降级(macOS Keychain / Windows 凭据管理器不受影响)
-    if (process.platform === 'linux')
-        return null;
-    try {
-        const mod = await import('keytar');
-        // ESM/CJS 混用：部分导出在 default 上
-        return mod.setPassword ? mod : mod.default || null;
-    }
-    catch {
-        return null;
-    }
-}
-export async function saveToken(token, issuer = 'local') {
-    const payload = JSON.stringify({ token, issuer });
-    const keytar = await getKeytar();
-    if (keytar) {
-        try {
-            await keytar.setPassword(SERVICE, ACCOUNT, payload);
-            return;
-        }
-        catch {
-            // 降级到文件
-        }
-    }
-    fallbackSave({ token, issuer });
-}
-/** 只取 token 字符串(兼容全部历史调用方) */
-export async function getToken() {
-    const info = await getTokenInfo();
-    return info?.token ?? null;
-}
-/** 取 token + 签发方标记(hmh#43 诊断用) */
-export async function getTokenInfo() {
-    const keytar = await getKeytar();
-    if (keytar) {
-        try {
-            const raw = await keytar.getPassword(SERVICE, ACCOUNT);
-            if (raw)
-                return parseStored(raw);
-        }
-        catch {
-            // 降级
-        }
-    }
-    return fallbackGet();
-}
-export async function deleteToken() {
-    const keytar = await getKeytar();
-    if (keytar) {
-        try {
-            await keytar.deletePassword(SERVICE, ACCOUNT);
-        }
-        catch {
-            // 忽略 keychain 错误，继续清理本地文件
-        }
-    }
-    fallbackDelete();
-}

package/dist/logger.d.ts

@@ -1,7 +0,0 @@
-import { Logger } from "@chromepilot/logger-kit/client";
-export declare function getCliLogger(): Logger;
-export declare function initCliLogger(options?: {
-    patchConsole?: boolean;
-    patchStreams?: boolean;
-}): Promise<Logger>;
-export declare function flushCliLogger(): Promise<void>;

package/dist/logger.js

@@ -1,80 +0,0 @@
-import { Logger, createHttpTransport } from "@chromepilot/logger-kit/client";
-import { PersistentLogQueue } from "@chromepilot/logger-kit/queue-node";
-import { loadConfig, resolveDataDir } from "./config.js";
-import { getToken } from "./keychain.js";
-import path from "node:path";
-let logger = null;
-let queue = null;
-let drainTimer = null;
-const noopLogger = {
-    debug: () => { },
-    info: () => { },
-    warn: () => { },
-    error: () => { },
-    log: () => { },
-    patchConsole: () => { },
-    patchProcessStreams: () => { },
-    flush: async () => { },
-    drainPersistent: async () => null,
-};
-export function getCliLogger() {
-    if (!logger) {
-        // 未显式初始化时返回 noop(测试/单工具命令兼容);主入口 index.ts 会先 init
-        return noopLogger;
-    }
-    return logger;
-}
-function homeDir() {
-    return resolveDataDir();
-}
-export async function initCliLogger(options) {
-    const cfg = loadConfig();
-    const serverUrl = cfg.serverUrl.replace(/\/$/, "");
-    const token = await getToken();
-    // 持久化队列:server 不可达时落盘 ~/.hunter-mate/logs-pending.jsonl
-    queue = new PersistentLogQueue({
-        filePath: path.join(homeDir(), ".hunter-mate", "logs-pending.jsonl"),
-        maxBytes: 4 * 1024 * 1024,
-    });
-    await queue.load();
-    const transport = await createHttpTransport({
-        serverUrl,
-        headers: token ? { Authorization: `Bearer ${token}` } : {},
-    });
-    logger = new Logger({
-        context: "cli",
-        sessionId: () => process.env.HM_SESSION_ID || `cli-${process.pid}`,
-        send: transport,
-        flushIntervalMs: 1000,
-        maxBufferSize: 50,
-        persistentQueue: queue,
-    });
-    // 后台定时器:每 5s 尝试 drain(server 恢复后补发)
-    if (drainTimer)
-        clearInterval(drainTimer);
-    drainTimer = setInterval(() => {
-        if (queue && queue.size() > 0) {
-            queue.drain(transport).catch(() => { });
-        }
-    }, 5000);
-    drainTimer.unref?.();
-    if (options?.patchConsole !== false) {
-        logger.patchConsole();
-    }
-    if (options?.patchStreams !== false) {
-        logger.patchProcessStreams();
-    }
-    return logger;
-}
-export async function flushCliLogger() {
-    await logger?.flush();
-    if (queue && queue.size() > 0) {
-        const cfg = loadConfig();
-        const token = await getToken();
-        const transport = await createHttpTransport({
-            serverUrl: cfg.serverUrl.replace(/\/$/, ""),
-            headers: token ? { Authorization: `Bearer ${token}` } : {},
-        });
-        await queue.drain(transport).catch(() => { });
-    }
-}

package/dist/native-check.d.ts

@@ -1,6 +0,0 @@
-import { type NativeModuleStatus } from "@chromepilot/kit";
-export type { NativeModuleStatus };
-export declare const checkNativeModules: () => {
-    ok: boolean;
-    modules: NativeModuleStatus[];
-};

package/dist/native-check.js

@@ -1,30 +0,0 @@
-import path from "node:path";
-import fs from "node:fs";
-import { fileURLToPath } from "node:url";
-import { createNativeChecker } from "@chromepilot/kit";
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-function locateServerEntryDir() {
-    const candidates = [
-        path.resolve(__dirname, "../../server/dist"),
-        path.resolve(__dirname, "../../server/src"),
-    ];
-    for (const dir of candidates) {
-        if (fs.existsSync(path.join(dir, "main.js")) || fs.existsSync(path.join(dir, "main.ts"))) {
-            return dir;
-        }
-    }
-    return null;
-}
-const checker = createNativeChecker({
-    probeDir: () => locateServerEntryDir(),
-    skipDetail: "未找到 server 入口(packages/server/dist|src)，跳过原生模块检查",
-    rebuildHint: (moduleName, compiledLabel) => {
-        const isWin = process.platform === "win32";
-        const base = `二选一：① 切回 ${compiledLabel} 的 node 再运行；② 用当前 node 重编译：pnpm rebuild -r ${moduleName}（重编后重启 server）`;
-        if (isWin && moduleName === "better-sqlite3") {
-            return `${base}。Windows 无 C++ 编译器时,推荐直接安装 Node 22 LTS(预构建包最全),无需安装 Visual Studio Build Tools`;
-        }
-        return base;
-    },
-});
-export const checkNativeModules = checker.checkNativeModules;

package/dist/postinstall.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/sentry.d.ts

@@ -1,4 +0,0 @@
-import { Sentry } from '@chromepilot/kit';
-/** Sentry 初始化:通用骨架来自 @chromepilot/kit(HM_ 前缀 env 读取) */
-export declare function initSentry(): boolean;
-export { Sentry };

package/dist/sentry.js

@@ -1,6 +0,0 @@
-import { initSentryFromEnv, Sentry } from '@chromepilot/kit';
-/** Sentry 初始化:通用骨架来自 @chromepilot/kit(HM_ 前缀 env 读取) */
-export function initSentry() {
-    return initSentryFromEnv('HM');
-}
-export { Sentry };

package/dist/updater.d.ts

@@ -1,119 +0,0 @@
-/**
- * 七牛 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。
- * 注意:GitHub Release 二进制安装(~/.hunter-mate/bin)不属于 dev 模式。
- */
-export declare function computeDevLinked(pkgRoot: string): boolean;
-export declare function isDevLinked(): boolean;
-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, expectedVersion?: string, 
-/** 测试注入:覆盖"当前运行 CLI 包根"的判定 */
-opts?: {
-    pkgRoot?: string;
-}): Promise<NpmSelfUpdateResult>;
-export interface CliUpdateOutcome {
-    logs: string[];
-    devSkipped: boolean;
-    updated: boolean;
-}
-/**
- * preAction 集成入口:返回日志行数组,永不 throw。
- * 逻辑等价于 kit 的 autoCliUpdate,但安装命令走 --prefix。
- */
-export declare function maybeCliSelfUpdate(): Promise<CliUpdateOutcome>;