hunter-mate 0.1.0

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

@@ -0,0 +1,35 @@
+{
+    "cli.description": "HiredChina 猎头 Agent 数据助手",
+    "cli.langOption": "输出语言(zh-CN/en-US)",
+    "login.description": "使用 OAuth 设备码登录",
+    "login.start": "正在打开浏览器完成登录...",
+    "login.userCode": "用户码:",
+    "login.verifyUrl": "授权地址:",
+    "login.success": "登录成功",
+    "login.failed": "登录失败:",
+    "login.expired": "设备码已过期，请重试",
+    "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}}"
+}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const sentry_1 = require("./sentry");
+const login_1 = require("./commands/login");
+const logout_1 = require("./commands/logout");
+const status_1 = require("./commands/status");
+const config_1 = require("./commands/config");
+const search_1 = require("./commands/search");
+const job_1 = require("./commands/job");
+const update_1 = require("./commands/update");
+const extension_1 = require("./commands/extension");
+const report_1 = require("./commands/report");
+const record_1 = require("./commands/record");
+const cache_1 = require("./commands/cache");
+// 对应 ChromePilot 的新命令（环境管理 / 运维 / 扩展管理）
+const init_1 = require("./commands/init");
+const install_1 = require("./commands/install");
+const server_1 = require("./commands/server");
+const doctor_1 = require("./commands/doctor");
+const extras_1 = require("./commands/extras");
+const ops_1 = require("./commands/ops");
+const addons_1 = require("./commands/addons");
+const i18n_1 = require("./i18n");
+(0, sentry_1.initSentry)();
+const program = new commander_1.Command();
+program
+    .name('hunter-mate')
+    .description(i18n_1.i18n.t('cli.description') + '（已对齐 ChromePilot: init/install/start/stop/status/recordings/control/adapter/run/memory/trace/autofix/external/plugin/skill/open-ext/doctor/reload）')
+    .version('0.1.0')
+    .option('--lang <lang>', i18n_1.i18n.t('cli.langOption'), 'zh-CN')
+    .hook('preAction', async (thisCommand) => {
+    const lang = thisCommand.opts().lang;
+    if (lang)
+        i18n_1.i18n.setLocale(lang);
+    // ADR-005 运行时一致性自动检测 + CLI 自更新(每次使用触发,版本判断):
+    // 1) CLI 自更新: 节流 1h 对比 npm registry,落后自动 npm install -g(下一条命令生效);
+    //    dev 软链模式(wrapper 指向 hc-hw worktree dist)自动跳过。
+    // 2) server 在跑时对比磁盘版本 vs 运行版本,插件不一致 → reload,server 不一致 → 重启。
+    // HUNTER_MATE_NO_AUTOUPDATE=1 可禁用;update/start/stop 自行处理避免递归;
+    // server 未运行时一致性零成本跳过(本地 pid 探测,60s 节流)。
+    if (process.env.HUNTER_MATE_NO_AUTOUPDATE === '1')
+        return;
+    const name = thisCommand.name();
+    if (name === 'update' || name === 'start' || name === 'stop')
+        return;
+    try {
+        const { maybeCliSelfUpdate } = await Promise.resolve().then(() => __importStar(require('./updater')));
+        const upd = await maybeCliSelfUpdate();
+        for (const line of upd.logs)
+            console.log(chalk_1.default.gray(`  [auto-update] ${line}`));
+    }
+    catch {
+        /* CLI 自更新检测永不阻塞主命令 */
+    }
+    try {
+        const { ensureRuntimeConsistency } = await Promise.resolve().then(() => __importStar(require('./version')));
+        const report = await ensureRuntimeConsistency({});
+        if (report.performed.length) {
+            for (const line of report.performed)
+                console.log(chalk_1.default.gray(`  [auto-update] ${line}`));
+        }
+    }
+    catch {
+        /* 一致性检测永不阻塞主命令 */
+    }
+});
+program.addCommand(init_1.initCommand);
+program.addCommand(install_1.installCommand);
+program.addCommand(server_1.startCommand);
+program.addCommand(server_1.stopCommand);
+program.addCommand(login_1.loginCommand);
+program.addCommand(logout_1.logoutCommand);
+program.addCommand(status_1.statusCommand);
+program.addCommand(config_1.configCommand);
+program.addCommand(search_1.searchCommand);
+program.addCommand(job_1.jobCommand);
+program.addCommand(update_1.updateCommand);
+program.addCommand(extension_1.extensionCommand);
+program.addCommand(ops_1.recordingsCommand);
+program.addCommand(ops_1.adapterCommand);
+program.addCommand(ops_1.memoryCommand);
+program.addCommand(ops_1.traceCommand);
+program.addCommand(ops_1.autofixCommand);
+program.addCommand(addons_1.externalCommand);
+program.addCommand(addons_1.pluginCommand);
+program.addCommand(addons_1.skillCommand);
+program.addCommand(extras_1.openExtCommand);
+program.addCommand(doctor_1.doctorCommand);
+program.addCommand(extras_1.reloadCommand);
+program.addCommand(report_1.reportCommand);
+program.addCommand(record_1.recordCommand);
+program.addCommand(cache_1.cacheCommand);
+program.parse();

package/dist/keychain.d.ts

@@ -0,0 +1,3 @@
+export declare function saveToken(token: string): Promise<void>;
+export declare function getToken(): Promise<string | null>;
+export declare function deleteToken(): Promise<void>;

package/dist/keychain.js

@@ -0,0 +1,117 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveToken = saveToken;
+exports.getToken = getToken;
+exports.deleteToken = deleteToken;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const SERVICE = 'hunter-mate';
+const ACCOUNT = 'user';
+const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
+const TOKEN_FILE = path.join(HOME, '.hunter-mate', 'token.json');
+function fallbackSave(token) {
+    fs.mkdirSync(path.dirname(TOKEN_FILE), { recursive: true });
+    fs.writeFileSync(TOKEN_FILE, JSON.stringify({ token }), { mode: 0o600 });
+}
+function fallbackGet() {
+    if (!fs.existsSync(TOKEN_FILE))
+        return null;
+    try {
+        const data = JSON.parse(fs.readFileSync(TOKEN_FILE, 'utf-8'));
+        return data.token || null;
+    }
+    catch {
+        return null;
+    }
+}
+function fallbackDelete() {
+    if (fs.existsSync(TOKEN_FILE)) {
+        fs.unlinkSync(TOKEN_FILE);
+    }
+}
+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 Promise.resolve().then(() => __importStar(require('keytar')));
+        // ESM/CJS 混用：部分导出在 default 上
+        return mod.setPassword ? mod : mod.default || null;
+    }
+    catch {
+        return null;
+    }
+}
+async function saveToken(token) {
+    const keytar = await getKeytar();
+    if (keytar) {
+        try {
+            await keytar.setPassword(SERVICE, ACCOUNT, token);
+            return;
+        }
+        catch {
+            // 降级到文件
+        }
+    }
+    fallbackSave(token);
+}
+async function getToken() {
+    const keytar = await getKeytar();
+    if (keytar) {
+        try {
+            const token = await keytar.getPassword(SERVICE, ACCOUNT);
+            if (token)
+                return token;
+        }
+        catch {
+            // 降级
+        }
+    }
+    return fallbackGet();
+}
+async function deleteToken() {
+    const keytar = await getKeytar();
+    if (keytar) {
+        try {
+            await keytar.deletePassword(SERVICE, ACCOUNT);
+        }
+        catch {
+            // 忽略 keychain 错误，继续清理本地文件
+        }
+    }
+    fallbackDelete();
+}

package/dist/sentry.d.ts

@@ -0,0 +1,3 @@
+import * as Sentry from '@sentry/node';
+export declare function initSentry(): void;
+export { Sentry };

package/dist/sentry.js

@@ -0,0 +1,62 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sentry = void 0;
+exports.initSentry = initSentry;
+const Sentry = __importStar(require("@sentry/node"));
+exports.Sentry = Sentry;
+function initSentry() {
+    const dsn = process.env.HM_ERROR_TRACKING_DSN;
+    const enabled = process.env.HM_ERROR_TRACKING_ENABLED === 'true';
+    if (!enabled || !dsn)
+        return;
+    Sentry.init({
+        dsn,
+        release: process.env.HM_RELEASE,
+        environment: process.env.HM_ENVIRONMENT || 'development',
+        tracesSampleRate: 0,
+        sendClientReports: false,
+        beforeSend(event) {
+            if (event.request?.headers) {
+                const headers = event.request.headers;
+                if (headers.authorization)
+                    headers.authorization = '***';
+                if (headers.cookie)
+                    headers.cookie = '***';
+            }
+            return event;
+        },
+    });
+}

package/dist/updater.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 判定是否开发软链模式(纯函数,便于单测):
+ * 包根路径含 /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;
+/** npm registry 查询最新版本(spawnSync,不占用 axios mock 队列);失败返回 null */
+export declare function npmLatestVersion(pkg?: string): string | null;
+/** 自更新: npm install -g <pkg>@latest(运行中的进程无法替换,新命令生效) */
+export declare function npmSelfUpdate(pkg?: string): {
+    ok: boolean;
+    msg: string;
+};
+export declare function updateCheckIntervalMs(): number;
+export declare function shouldCheckUpdate(stateFile?: string, now?: number, intervalMs?: number): boolean;
+export declare function markUpdateChecked(stateFile?: string): void;
+export interface CliUpdateOutcome {
+    logs: string[];
+    devSkipped: boolean;
+    updated: boolean;
+}
+export declare function maybeCliSelfUpdate(): Promise<CliUpdateOutcome>;

package/dist/updater.js

@@ -0,0 +1,161 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeDevLinked = computeDevLinked;
+exports.isDevLinked = isDevLinked;
+exports.npmLatestVersion = npmLatestVersion;
+exports.npmSelfUpdate = npmSelfUpdate;
+exports.updateCheckIntervalMs = updateCheckIntervalMs;
+exports.shouldCheckUpdate = shouldCheckUpdate;
+exports.markUpdateChecked = markUpdateChecked;
+exports.maybeCliSelfUpdate = maybeCliSelfUpdate;
+/**
+ * CLI 自动更新(使用态)与开发模式识别(与 chromepilot updater 对齐)。
+ *
+ * 设计(ADR-005 延伸):
+ * - 每次命令使用时(preAction)节流(默认 1h)对比 npm registry 最新版本,落后则自动
+ *   `npm install -g hunter-mate@latest`;运行中的进程无法替换自身,下一条命令起生效。
+ * - 开发软链模式(wrapper 指向 hc-hw local worktree dist)跳过 CLI 自更新,由开发者
+ *   `pnpm build` 控制;server/插件/扩展的一致性 reload/restart 不受影响(version.ts)。
+ * - 逃生开关:
+ *   - HUNTER_MATE_NO_AUTOUPDATE=1          关闭全部自动更新(CLI + 一致性,preAction 层)
+ *   - HUNTER_MATE_UPDATE_CHECK_INTERVAL_MS 覆盖节流间隔(默认 3600000)
+ *   - HUNTER_MATE_DEV=1                    强制视为 dev 模式(测试用)
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const version_1 = require("./version");
+const HOME = () => process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
+const ROOT = () => path.join(HOME(), '.hunter-mate');
+const LAST_CHECK_FILE = () => path.join(ROOT(), '.last-cli-update-check');
+const NPM_PACKAGE = 'hunter-mate';
+const DEFAULT_INTERVAL_MS = 60 * 60 * 1000;
+/**
+ * 判定是否开发软链模式(纯函数,便于单测):
+ * 包根路径含 /worktrees/ 段(hc-hw local worktree 布局)或 HUNTER_MATE_DEV=1。
+ * 注意:GitHub Release 二进制安装(~/.hunter-mate/bin)不属于 dev 模式。
+ */
+function computeDevLinked(pkgRoot) {
+    if (process.env.HUNTER_MATE_DEV === '1')
+        return true;
+    return path.normalize(pkgRoot).includes(`${path.sep}worktrees${path.sep}`);
+}
+function isDevLinked() {
+    return computeDevLinked(path.join(__dirname, '..'));
+}
+/** npm registry 查询最新版本(spawnSync,不占用 axios mock 队列);失败返回 null */
+function npmLatestVersion(pkg = NPM_PACKAGE) {
+    try {
+        const r = (0, child_process_1.spawnSync)('npm', ['view', pkg, 'version'], {
+            encoding: 'utf-8',
+            timeout: 15_000,
+        });
+        if (r.status === 0 && r.stdout)
+            return r.stdout.trim() || null;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 自更新: npm install -g <pkg>@latest(运行中的进程无法替换,新命令生效) */
+function npmSelfUpdate(pkg = NPM_PACKAGE) {
+    const r = (0, child_process_1.spawnSync)('npm', ['install', '-g', `${pkg}@latest`], {
+        stdio: 'inherit',
+        timeout: 120_000,
+    });
+    if (r.status === 0) {
+        return { ok: true, msg: `npm install -g ${pkg}@latest 完成,下一条命令起使用新版本` };
+    }
+    return { ok: false, msg: `npm install -g ${pkg}@latest 失败 (exit=${r.status}),可手动执行` };
+}
+// ---------------------------------------------------------------------------
+// 节流
+// ---------------------------------------------------------------------------
+function updateCheckIntervalMs() {
+    const v = Number(process.env.HUNTER_MATE_UPDATE_CHECK_INTERVAL_MS);
+    return Number.isFinite(v) && v > 0 ? v : DEFAULT_INTERVAL_MS;
+}
+function shouldCheckUpdate(stateFile = LAST_CHECK_FILE(), now = Date.now(), intervalMs = updateCheckIntervalMs()) {
+    try {
+        const stat = fs.statSync(stateFile);
+        return now - stat.mtimeMs > intervalMs;
+    }
+    catch {
+        return true;
+    }
+}
+function markUpdateChecked(stateFile = LAST_CHECK_FILE()) {
+    try {
+        fs.mkdirSync(path.dirname(stateFile), { recursive: true });
+        fs.writeFileSync(stateFile, String(Date.now()));
+    }
+    catch {
+        /* 尽力 */
+    }
+}
+async function maybeCliSelfUpdate() {
+    const logs = [];
+    const outcome = { logs, devSkipped: false, updated: false };
+    try {
+        if (isDevLinked()) {
+            outcome.devSkipped = true;
+            logs.push('dev 软链模式,跳过 CLI 自更新(改代码请 pnpm build;一致性 reload/restart 不受影响)');
+            return outcome;
+        }
+        if (!shouldCheckUpdate())
+            return outcome;
+        markUpdateChecked();
+        const installed = (0, version_1.readInstalledVersions)().cli;
+        if (!installed || installed === '0.0.0')
+            return outcome;
+        const latest = npmLatestVersion();
+        if (!latest) {
+            logs.push(`npm registry 查询 ${NPM_PACKAGE} 失败,本次跳过自更新`);
+            return outcome;
+        }
+        if (latest === installed)
+            return outcome;
+        logs.push(`CLI 自更新: ${installed} → ${latest}`);
+        const r = npmSelfUpdate();
+        logs.push(r.msg);
+        outcome.updated = r.ok;
+    }
+    catch (err) {
+        logs.push(`自动更新检测异常(不影响命令执行): ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return outcome;
+}

package/dist/version.d.ts

@@ -0,0 +1,16 @@
+import { ConsistencyActions, InstalledVersions, SystemVersions } from '@hunter-mate/shared';
+export declare function readInstalledVersions(): InstalledVersions;
+export declare function readRuntimeStateFile(): any;
+export declare function fetchLiveVersions(timeoutMs?: number): Promise<SystemVersions | null>;
+export declare function decideConsistencyActions(installed: InstalledVersions, live: SystemVersions | null): ConsistencyActions;
+export interface ConsistencyReport {
+    checked: boolean;
+    reason?: string;
+    actions: ConsistencyActions;
+    performed: string[];
+}
+export declare function ensureRuntimeConsistency(opts?: {
+    force?: boolean;
+    verbose?: boolean;
+}): Promise<ConsistencyReport>;
+export declare function shouldCheckNow(): boolean;