hunter-mate 0.1.2 → 0.1.4

package/dist/commands/job.js

@@ -1,56 +1,16 @@
-"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 });
-exports.jobCommand = void 0;
-exports.runJobCreate = runJobCreate;
-exports.runJobList = runJobList;
-const commander_1 = require("commander");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const axios_1 = __importDefault(require("axios"));
-const uuid_1 = require("uuid");
-const db_1 = require("../cache/db");
-const config_1 = require("../config");
-const keychain_1 = require("../keychain");
-const i18n_1 = require("../i18n");
-async function runJobCreate(folderPath) {
-    const config = (0, config_1.loadConfig)();
-    const token = await (0, keychain_1.getToken)();
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import axios from 'axios';
+import { v4 as uuidv4 } from 'uuid';
+import { ensureCacheDir, saveJobCase, listJobCases } from '../cache/db.js';
+import { loadConfig } from '../config.js';
+import { getToken } from '../keychain.js';
+import { i18n } from '../i18n/index.js';
+import { getCliLogger } from '../logger.js';
+export async function runJobCreate(folderPath) {
+    const config = loadConfig();
+    const token = await getToken();
     const headers = token ? { Authorization: `UTOKEN ${token}` } : {};
     const resolved = path.resolve(folderPath);
     if (!fs.existsSync(resolved)) {
@@ -63,14 +23,14 @@ async function runJobCreate(folderPath) {
     }
     const rawText = Object.values(rawFiles).join('\n---\n');
     const title = Object.keys(rawFiles)[0]?.replace(/\.[^.]+$/, '') || 'Untitled JobCase';
-    const res = await axios_1.default.post(`${config.serverUrl}/job-cases`, {
-        externalId: (0, uuid_1.v4)(),
+    const res = await axios.post(`${config.serverUrl}/job-cases`, {
+        externalId: uuidv4(),
         title,
         folderPath: resolved,
         rawFiles,
     }, { headers, proxy: false });
     const serverCase = res.data;
-    (0, db_1.ensureCacheDir)();
+    ensureCacheDir();
     const jobCase = {
         id: serverCase.id,
         externalId: serverCase.externalId,
@@ -84,28 +44,30 @@ async function runJobCreate(folderPath) {
         status: serverCase.status,
         createdAt: Date.now(),
     };
-    (0, db_1.saveJobCase)(jobCase);
+    saveJobCase(jobCase);
     return serverCase;
 }
-function runJobList() {
-    return (0, db_1.listJobCases)();
+export function runJobList() {
+    return listJobCases();
 }
-exports.jobCommand = new commander_1.Command('job')
-    .description(i18n_1.i18n.t('job.description'));
-exports.jobCommand
+export const jobCommand = new Command('job')
+    .description(i18n.t('job.description'));
+jobCommand
     .command('create <folder>')
-    .description(i18n_1.i18n.t('job.create'))
+    .description(i18n.t('job.create'))
     .action(async (folderPath) => {
     try {
         const serverCase = await runJobCreate(folderPath);
         console.log(`Created JobCase ${serverCase.id} (${serverCase.externalId})`);
     }
     catch (err) {
-        console.error('Failed to create JobCase:', err.response?.data?.message || err.message);
+        getCliLogger().error('job:create-failed', {
+            error: err.response?.data?.message || err.message,
+        });
         process.exit(1);
     }
 });
-exports.jobCommand
+jobCommand
     .command('list')
     .description('List local JobCases')
     .action(() => {

package/dist/commands/login.js

@@ -1,81 +1,94 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loginCommand = void 0;
-exports.runLogin = runLogin;
-const commander_1 = require("commander");
-const axios_1 = __importDefault(require("axios"));
-const open_1 = __importDefault(require("open"));
-const config_1 = require("../config");
-const keychain_1 = require("../keychain");
-const i18n_1 = require("../i18n");
+import { Command } from 'commander';
+import axios from 'axios';
+import open from 'open';
+import { loadConfig } from '../config.js';
+import { saveToken } from '../keychain.js';
+import { i18n } from '../i18n/index.js';
+import { getCliLogger } from '../logger.js';
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-async function runLogin() {
-    const config = (0, config_1.loadConfig)();
-    const { data: deviceCode } = await axios_1.default.post(`${config.serverUrl}/auth/device-code`);
-    console.log(i18n_1.i18n.t('login.userCode'), deviceCode.user_code);
-    console.log(i18n_1.i18n.t('login.verifyUrl'), deviceCode.verification_uri);
-    await (0, open_1.default)(deviceCode.verification_uri);
+export async function runLogin() {
+    const config = loadConfig();
+    const { data: deviceCode } = await axios.post(`${config.serverUrl}/auth/device-code`);
+    getCliLogger().info('login:device-code', {
+        userCode: deviceCode.user_code,
+        verifyUrl: deviceCode.verification_uri,
+        expiresIn: deviceCode.expires_in,
+    });
+    console.log(i18n.t('login.userCode'), deviceCode.user_code);
+    console.log(i18n.t('login.verifyUrl'), deviceCode.verification_uri);
+    await open(deviceCode.verification_uri);
     const maxAttempts = Math.ceil(deviceCode.expires_in / deviceCode.interval);
     for (let i = 0; i < maxAttempts; i++) {
         await sleep(deviceCode.interval * 1000);
-        const { data } = await axios_1.default.post(`${config.serverUrl}/auth/token`, {
+        const { data } = await axios.post(`${config.serverUrl}/auth/token`, {
             deviceCode: deviceCode.device_code,
         });
         if (data.access_token) {
-            await (0, keychain_1.saveToken)(data.access_token);
+            await saveToken(data.access_token);
+            getCliLogger().info('login:token-saved', { method: 'device-code' });
             return data.access_token;
         }
         if (data.status === 'expired') {
-            throw new Error(i18n_1.i18n.t('login.expired'));
+            getCliLogger().warn('login:device-code-expired', { attempts: i + 1 });
+            throw new Error(i18n.t('login.expired'));
         }
     }
-    throw new Error(i18n_1.i18n.t('login.expired'));
+    getCliLogger().warn('login:device-code-timeout', { maxAttempts });
+    throw new Error(i18n.t('login.expired'));
 }
-exports.loginCommand = new commander_1.Command('login')
-    .description(i18n_1.i18n.t('login.description'))
+export const loginCommand = new Command('login')
+    .description(i18n.t('login.description'))
     .option('--email <email>', 'Email address (email verification code login)')
     .option('--code <code>', 'Email verification code (6 digits, step 2)')
     .action(async (options) => {
     try {
-        const config = (0, config_1.loadConfig)();
-        // 邮箱验证码登录(两步式无状态)
+        const config = loadConfig();
+        // 邮箱验证码登录(两步式无状态;SaaS 服务端,不经本地 server)
         if (options.email) {
             if (!options.code) {
                 // 第一步:发送验证码
-                await axios_1.default.post(`${config.serverUrl}/auth/email/send-code`, {
+                await axios.post(`${config.saasUrl}/hunter-mate/auth/email/send-code`, {
                     email: options.email,
                 });
-                console.log(`${i18n_1.i18n.t('login.emailCodeSent')} ${options.email}`);
-                console.log(`  ${i18n_1.i18n.t('login.emailCodeNextStep')}`);
+                getCliLogger().info('login:email-code-sent', { email: options.email });
+                console.log(`${i18n.t('login.emailCodeSent')} ${options.email}`);
+                console.log(`  ${i18n.t('login.emailCodeNextStep')}`);
                 return;
             }
             // 第二步:校验验证码 → 保存 token
-            const { data } = await axios_1.default.post(`${config.serverUrl}/auth/email/verify`, { email: options.email, code: options.code });
+            const { data } = await axios.post(`${config.saasUrl}/hunter-mate/auth/email/verify`, { email: options.email, code: options.code });
             if (!data.access_token) {
+                getCliLogger().error('login:email-verify-no-token');
                 throw new Error('verify returned no access_token');
             }
-            await (0, keychain_1.saveToken)(data.access_token);
-            console.log(i18n_1.i18n.t('login.success'));
+            await saveToken(data.access_token);
+            getCliLogger().info('login:token-saved', { method: 'email', email: options.email });
+            console.log(i18n.t('login.success'));
             return;
         }
         if (options.code) {
-            console.error(i18n_1.i18n.t('login.emailCodeMissing'));
+            getCliLogger().error('login:email-code-missing', { hint: i18n.t('login.emailCodeMissing') });
             process.exit(1);
         }
         // 默认:OAuth 设备码登录
-        console.log(i18n_1.i18n.t('login.start'));
+        console.log(i18n.t('login.start'));
+        getCliLogger().info('login:start', { method: 'device-code' });
         await runLogin();
-        console.log(i18n_1.i18n.t('login.success'));
+        console.log(i18n.t('login.success'));
     }
     catch (err) {
         // 透出 server 侧业务错误信息(如"验证码错误"/"发送过于频繁")
         const serverMsg = err?.response?.data?.message;
-        console.error(i18n_1.i18n.t('login.failed'), serverMsg || err.message);
+        getCliLogger().error('login:failed', {
+            error: serverMsg || err.message,
+            hasResponse: !!err?.response,
+        });
+        getCliLogger().error('login:failed', {
+            hint: i18n.t('login.failed'),
+            error: serverMsg || err.message,
+        });
         process.exit(1);
     }
 });

package/dist/commands/logout.js

@@ -1,16 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.logoutCommand = void 0;
-exports.runLogout = runLogout;
-const commander_1 = require("commander");
-const keychain_1 = require("../keychain");
-const i18n_1 = require("../i18n");
-async function runLogout() {
-    await (0, keychain_1.deleteToken)();
+import { Command } from 'commander';
+import { deleteToken } from '../keychain.js';
+import { i18n } from '../i18n/index.js';
+export async function runLogout() {
+    await deleteToken();
 }
-exports.logoutCommand = new commander_1.Command('logout')
-    .description(i18n_1.i18n.t('logout.description'))
+export const logoutCommand = new Command('logout')
+    .description(i18n.t('logout.description'))
     .action(async () => {
     await runLogout();
-    console.log(i18n_1.i18n.t('logout.success'));
+    console.log(i18n.t('logout.success'));
 });

package/dist/commands/ops.js

@@ -1,19 +1,16 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.autofixCommand = exports.traceCommand = exports.memoryCommand = exports.adapterCommand = exports.recordingsCommand = void 0;
-const commander_1 = require("commander");
-const axios_1 = __importDefault(require("axios"));
-const config_1 = require("../config");
+import { Command } from 'commander';
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+import { loadConfig } from '../config.js';
+import { getCliLogger } from '../logger.js';
 // OpenCLI 风格的通用选项
 function withFormat(cmd) {
     return cmd.option('-f, --format <format>', '输出格式: table|json|yaml|md|csv', 'json');
 }
 const http = () => {
-    const c = (0, config_1.loadConfig)();
-    return axios_1.default.create({ baseURL: c.serverUrl, timeout: 60_000 });
+    const c = loadConfig();
+    return axios.create({ baseURL: c.serverUrl, timeout: 60_000 });
 };
 const printResult = (data, format) => {
     const fmt = (format ?? 'json').toLowerCase();
@@ -35,8 +32,8 @@ const printResult = (data, format) => {
 // ---------------------------------------------------------------------------
 // recordings 管理 (对应 chromepilot recordings)
 // ---------------------------------------------------------------------------
-exports.recordingsCommand = new commander_1.Command('recordings').description('管理录制会话（rrweb/network/console 事件流）');
-exports.recordingsCommand
+export const recordingsCommand = new Command('recordings').description('管理录制会话（rrweb/network/console 事件流）');
+recordingsCommand
     .command('start')
     .description('开始录制: 生成新 sessionId 并通知扩展开始上报事件')
     .requiredOption('--title <text>', '录制标题，例如 LinkedIn 寻访 2026-08-15')
@@ -45,7 +42,7 @@ exports.recordingsCommand
     // MVP: 直接调用 server 的 recordings POST 端点（若存在）或返回本地 sessionId 交给扩展
     const sessionId = 'sess_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
     try {
-        await http().post(`/recordings/${sessionId}/events`, []);
+        await http().post(`/api/recordings/${sessionId}/events`, []);
     }
     catch {
         /* 忽略: server REST 未就绪也允许本地启动 */
@@ -61,7 +58,7 @@ exports.recordingsCommand
         ].join(''),
     }, null, 2));
 });
-exports.recordingsCommand
+recordingsCommand
     .command('stop')
     .argument('<sessionId>', '会话 ID')
     .description('停止录制（软标记，不再接受新事件）')
@@ -69,74 +66,104 @@ exports.recordingsCommand
     console.log(JSON.stringify({
         sessionId,
         stoppedAt: new Date().toISOString(),
-        detail: 'stop 目前是客户端软标记。可通过 POST /recordings/:sessionId/parse 触发后端解析。',
+        detail: 'stop 目前是客户端软标记。可通过 POST /api/recordings/:sessionId/parse 触发后端解析。',
     }, null, 2));
 });
-withFormat(exports.recordingsCommand.command('list').description('列出录制会话（从 /recordings 端点）'))
+withFormat(recordingsCommand.command('list').description('列出录制会话（从 /api/recordings 端点）'))
     .action(async (opts) => {
     try {
-        const r = await http().get('/recordings');
+        const r = await http().get('/api/recordings');
         printResult(r.data, opts.format);
     }
     catch (e) {
         // server 暂未实现 recordings list 时给出空结果与提示，避免 crash
-        printResult({ note: '/recordings GET 未实现，HunterMate server 正在逐步补齐。先从 recordings/:sessionId GET 查看单个。', sessions: [] }, opts.format);
+        printResult({ note: '/api/recordings GET 未实现，HunterMate server 正在逐步补齐。先从 /api/recordings/:sessionId GET 查看单个。', sessions: [] }, opts.format);
     }
 });
-withFormat(exports.recordingsCommand.command('show <sessionId>').description('查看录制详情 (/recordings/:id) + 可选 parse'))
+withFormat(recordingsCommand.command('show <sessionId>').description('查看录制详情 (/api/recordings/:id) + 可选 parse'))
     .option('--parse', '同时触发 parseRecording 规则引擎提取结构化字段')
     .action(async (sessionId, opts) => {
     try {
         const [detail, parsed] = await Promise.all([
-            http().get(`/recordings/${sessionId}`).then((r) => r.data).catch(() => null),
-            opts.parse ? http().post(`/recordings/${sessionId}/parse`).then((r) => r.data).catch(() => null) : Promise.resolve(null),
+            http().get(`/api/recordings/${sessionId}`).then((r) => r.data).catch(() => null),
+            opts.parse ? http().post(`/api/recordings/${sessionId}/parse`).then((r) => r.data).catch(() => null) : Promise.resolve(null),
         ]);
         printResult({ detail, parsed }, opts.format);
     }
     catch (e) {
-        console.error(`recordings show failed: ${e.message}`);
+        getCliLogger().error('ops:recordings-show-failed', { error: e.message });
         process.exit(1);
     }
 });
 // ---------------------------------------------------------------------------
 // adapter (OpenCLI 风格)
 // ---------------------------------------------------------------------------
-withFormat(new commander_1.Command('adapter')
-    .description('站点适配器管理（OpenCLI 风格，对应 chromepilot adapter）')
-    .argument('[action]', '操作: list (默认)', 'list')
-    .argument('[site]', '站点名过滤，如 linkedin/resume/jobsite', '')).action(async (action, site, opts) => {
-    // 内置适配器列表（对应 ControlCommandName 里 hm.* 的集合）
-    const builtin = [
-        { site: 'linkedin', commands: ['search', 'extract', 'invite'], builtin: true },
-        { site: 'resume', commands: ['extract'], builtin: true },
-    ];
-    const filtered = site ? builtin.filter((b) => b.site === site) : builtin;
-    printResult(action === 'list' || !action ? filtered : { error: `unknown action: ${action}`, supported: ['list'] }, opts.format);
-});
-// 因为上面的 adapter 是局部变量返回，这里用一个包装函数把它赋值给导出
-// （为了保持 recordingsCommand 相同的导出风格，单独定义 exports.adapterCommand）
-exports.adapterCommand = withFormat(new commander_1.Command('adapter')
-    .description('站点适配器管理（OpenCLI 风格，对应 chromepilot adapter）: list')
-    .argument('[action]', '操作: list (默认)', 'list')
-    .argument('[site]', '站点名过滤', '')).action((action, site, opts) => {
-    const builtin = [
-        { site: 'linkedin', commands: ['search', 'extract', 'invite'], builtin: true },
-        { site: 'resume', commands: ['extract'], builtin: true },
-    ];
-    const filtered = site ? builtin.filter((b) => b.site === site) : builtin;
-    printResult(action === 'list' ? filtered : { error: `unknown action: ${action}` }, opts.format);
+export const adapterCommand = withFormat(new Command('adapter')
+    .description('站点适配器（对应 chromepilot adapter）: list | extract <url>')
+    .argument('[action]', '操作: list | extract', 'list')
+    .argument('[target]', 'list: 站点名过滤;extract: 页面 URL', '')
+    .option('--tab <pageId>', 'extract: 指定目标 tab(page id;默认复用同站点 tab 或新建后台 tab,不抢焦点)')
+    .option('--settle-ms <n>', 'extract: 导航后首查等待 ms(默认 1200)', '1200')).action(async (action, target, opts) => {
+    if (action === 'list' || !action) {
+        try {
+            const r = await http().get('/adapters');
+            const filtered = target
+                ? { adapters: (r.data.adapters || []).filter((a) => a.platform === target || a.host === target) }
+                : r.data;
+            printResult(filtered, opts.format);
+        }
+        catch (e) {
+            // server 暂未实现 /adapters 时退回内置清单
+            printResult({ note: `GET /adapters failed (${e.message}),fallback 内置清单`, adapters: [
+                    { platform: 'linkedin', host: 'linkedin.com', command: 'hm.linkedin.extract' },
+                ] }, opts.format);
+        }
+        return;
+    }
+    if (action === 'extract') {
+        if (!/^https?:\/\//.test(target || '')) {
+            getCliLogger().error('ops:adapter-extract-missing-url', { hint: 'adapter extract 需要完整 URL,例如: hunter-mate adapter extract https://www.linkedin.com/in/boonkwee/' });
+            process.exit(1);
+        }
+        const { ensureEnvReady } = await import('./extension.js');
+        await ensureEnvReady();
+        try {
+            const r = await http().post('/extract/adapter', { url: target, tab: opts.tab, settleMs: Number(opts.settleMs) || 1200 }, { timeout: 120_000 });
+            const d = r.data || {};
+            const summary = {
+                ok: d.ok, runId: d.runId, pageClass: d.pageClass, url: d.url, tab: d.tab,
+                savedCount: d.savedCount, saved: d.saved,
+                links: d.links ? Object.fromEntries(Object.entries(d.links).map(([k, v]) => [k, v.length])) : {},
+            };
+            if ((opts.format || '').toLowerCase() === 'table') {
+                console.log(`pageClass=${d.pageClass} saved=${d.savedCount} tab=${d.tab}(${d.createdTab ? '新建' : '复用'})`);
+                for (const [k, v] of Object.entries(d.links || {}))
+                    console.log(`links.${k}: ${v.length}`);
+                printResult(d.saved || [], 'table');
+            }
+            else {
+                printResult(summary, opts.format);
+            }
+        }
+        catch (e) {
+            const detail = e.response?.data?.message || e.message;
+            getCliLogger().error('ops:adapter-extract-failed', { error: detail });
+            process.exit(1);
+        }
+        return;
+    }
+    printResult({ error: `unknown action: ${action}`, supported: ['list', 'extract'] }, opts.format);
 });
 // ---------------------------------------------------------------------------
 // memory (站点记忆: 基于 selector/流程建议 的持久化 KV)
 // ---------------------------------------------------------------------------
-exports.memoryCommand = withFormat(new commander_1.Command('memory')
+export const memoryCommand = withFormat(new Command('memory')
     .description('站点记忆管理（OpenCLI 风格，对应 chromepilot memory）: list|show|suggest|delete')
     .argument('[action]', '操作 (默认 list)', 'list')
     .argument('[site]', '站点名', '')
     .argument('[ref]', 'suggest/delete 的元素引用', '')).action((action, site, ref, opts) => {
     const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
-    const STORE = require('path').join(HOME, '.hunter-mate', 'memory.json');
-    const fs = require('fs');
+    const STORE = path.join(HOME, '.hunter-mate', 'memory.json');
     let store = {};
     try {
         store = JSON.parse(fs.readFileSync(STORE, 'utf-8'));
@@ -153,14 +180,14 @@ exports.memoryCommand = withFormat(new commander_1.Command('memory')
             return;
         case 'show':
             if (!site) {
-                console.error('memory show 需要 site');
+                getCliLogger().error('ops:memory-show-missing-site', { hint: 'memory show 需要 site' });
                 process.exit(1);
             }
             printResult(store[site] ?? {}, opts.format);
             return;
         case 'suggest': {
             if (!site || !ref) {
-                console.error('memory suggest 需要 site + ref');
+                getCliLogger().error('ops:memory-suggest-missing-arg', { hint: 'memory suggest 需要 site + ref' });
                 process.exit(1);
             }
             store[site] = store[site] || {};
@@ -176,7 +203,7 @@ exports.memoryCommand = withFormat(new commander_1.Command('memory')
         }
         case 'delete':
             if (!site) {
-                console.error('memory delete 需要 site');
+                getCliLogger().error('ops:memory-delete-missing-site', { hint: 'memory delete 需要 site' });
                 process.exit(1);
             }
             if (ref)
@@ -187,14 +214,14 @@ exports.memoryCommand = withFormat(new commander_1.Command('memory')
             printResult({ ok: true, site, ref: ref ?? '(whole site)' }, opts.format);
             return;
         default:
-            console.error(`memory: unknown action ${action} (支持: list|show|suggest|delete)`);
+            getCliLogger().error('ops:memory-unknown-action', { hint: `memory: unknown action ${action} (支持: list|show|suggest|delete)` });
             process.exit(1);
     }
 });
 // ---------------------------------------------------------------------------
 // trace (事件流查询 + 追加)
 // ---------------------------------------------------------------------------
-exports.traceCommand = withFormat(new commander_1.Command('trace')
+export const traceCommand = withFormat(new Command('trace')
     .description('trace 事件流管理（命令+selector+network 关联）: list|show|summary|network|query|record|delete')
     .argument('[action]', '操作 (默认 list)', 'list')
     .argument('[sessionId]', '会话 ID'))
@@ -217,7 +244,7 @@ exports.traceCommand = withFormat(new commander_1.Command('trace')
         case 'summary':
         case 'network':
             if (!sessionId) {
-                console.error(`trace ${action} 需要 sessionId`);
+                getCliLogger().error('ops:trace-needs-sessionId', { hint: `trace ${action} 需要 sessionId` });
                 process.exit(1);
             }
             try {
@@ -230,7 +257,7 @@ exports.traceCommand = withFormat(new commander_1.Command('trace')
             return;
         case 'query':
             if (!sessionId) {
-                console.error('trace query 需要 sessionId');
+                getCliLogger().error('ops:trace-query-missing-sessionId', { hint: 'trace query 需要 sessionId' });
                 process.exit(1);
             }
             try {
@@ -245,7 +272,7 @@ exports.traceCommand = withFormat(new commander_1.Command('trace')
             return;
         case 'record': {
             if (!sessionId || !opts.type) {
-                console.error('trace record 需要 sessionId + --type');
+                getCliLogger().error('ops:trace-record-missing-arg', { hint: 'trace record 需要 sessionId + --type' });
                 process.exit(1);
             }
             let payload = opts.payload;
@@ -262,35 +289,35 @@ exports.traceCommand = withFormat(new commander_1.Command('trace')
             catch (e) {
                 // server 未就绪时: 本地追加 fallbacks 到 session JSONL 文件
                 const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
-                const f = require('path').join(HOME, '.hunter-mate', 'sessions', `${sessionId}.trace.jsonl`);
-                require('fs').appendFileSync(f, JSON.stringify({ type: opts.type, payload, ts: Date.now() }) + '\n');
+                const f = path.join(HOME, '.hunter-mate', 'sessions', `${sessionId}.trace.jsonl`);
+                fs.appendFileSync(f, JSON.stringify({ type: opts.type, payload, ts: Date.now() }) + '\n');
                 printResult({ ok: true, stored: 'local', file: f }, opts.format);
             }
             return;
         }
         case 'delete':
             if (!sessionId) {
-                console.error('trace delete 需要 sessionId');
+                getCliLogger().error('ops:trace-delete-missing-sessionId', { hint: 'trace delete 需要 sessionId' });
                 process.exit(1);
             }
-            printResult({ ok: true, sessionId, note: '本地 trace 文件删除（server 侧请通过 recordings/* 管理）' }, opts.format);
+            printResult({ ok: true, sessionId, note: '本地 trace 文件删除（server 侧请通过 api/recordings/* 管理）' }, opts.format);
             try {
                 const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
-                const f = require('path').join(HOME, '.hunter-mate', 'sessions', `${sessionId}.trace.jsonl`);
-                if (require('fs').existsSync(f))
-                    require('fs').unlinkSync(f);
+                const f = path.join(HOME, '.hunter-mate', 'sessions', `${sessionId}.trace.jsonl`);
+                if (fs.existsSync(f))
+                    fs.unlinkSync(f);
             }
             catch { }
             return;
         default:
-            console.error(`trace: unknown action ${action}`);
+            getCliLogger().error('ops:trace-unknown-action', { hint: `trace: unknown action ${action}` });
             process.exit(1);
     }
 });
 // ---------------------------------------------------------------------------
 // autofix (基于 memory + trace 的修复建议)
 // ---------------------------------------------------------------------------
-exports.autofixCommand = withFormat(new commander_1.Command('autofix')
+export const autofixCommand = withFormat(new Command('autofix')
     .description('自动修复建议（基于站点记忆 + trace）: 综合建议|retry|selector|auth|network')
     .argument('[action]', '操作 (默认 综合建议)', '综合建议')
     .argument('[site]', '站点名')