hunter-mate 0.1.0 → 0.1.2

package/dist/commands/config.d.ts

@@ -4,9 +4,5 @@ export interface ConfigOptions {
     watchFolder?: string;
     lang?: string;
 }
-export declare function runConfig(options: ConfigOptions): {
-    serverUrl: string;
-    lang: string;
-    watchFolder?: string;
-};
+export declare function runConfig(options: ConfigOptions): import("../config").HunterMateConfig;
 export declare const configCommand: Command;

package/dist/commands/login.js

@@ -38,14 +38,44 @@ async function runLogin() {
 }
 exports.loginCommand = new commander_1.Command('login')
     .description(i18n_1.i18n.t('login.description'))
-    .action(async () => {
+    .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)();
+        // 邮箱验证码登录(两步式无状态)
+        if (options.email) {
+            if (!options.code) {
+                // 第一步:发送验证码
+                await axios_1.default.post(`${config.serverUrl}/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')}`);
+                return;
+            }
+            // 第二步:校验验证码 → 保存 token
+            const { data } = await axios_1.default.post(`${config.serverUrl}/auth/email/verify`, { email: options.email, code: options.code });
+            if (!data.access_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'));
+            return;
+        }
+        if (options.code) {
+            console.error(i18n_1.i18n.t('login.emailCodeMissing'));
+            process.exit(1);
+        }
+        // 默认:OAuth 设备码登录
         console.log(i18n_1.i18n.t('login.start'));
         await runLogin();
         console.log(i18n_1.i18n.t('login.success'));
     }
     catch (err) {
-        console.error(i18n_1.i18n.t('login.failed'), err.message);
+        // 透出 server 侧业务错误信息(如"验证码错误"/"发送过于频繁")
+        const serverMsg = err?.response?.data?.message;
+        console.error(i18n_1.i18n.t('login.failed'), serverMsg || err.message);
         process.exit(1);
     }
 });

package/dist/config.d.ts

@@ -5,8 +5,4 @@ export interface HunterMateConfig {
 }
 export declare function ensureConfigDir(): void;
 export declare function loadConfig(): HunterMateConfig;
-export declare function saveConfig(config: Partial<HunterMateConfig>): {
-    serverUrl: string;
-    lang: string;
-    watchFolder?: string;
-};
+export declare function saveConfig(config: Partial<HunterMateConfig>): HunterMateConfig;

package/dist/config.js

@@ -38,28 +38,22 @@ exports.loadConfig = loadConfig;
 exports.saveConfig = saveConfig;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const HOME = process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
-const CONFIG_DIR = path.join(HOME, '.hunter-mate');
-const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const kit_1 = require("@chromepilot/kit");
+const HOME = () => process.env.HUNTER_MATE_HOME || process.env.HOME || process.env.USERPROFILE || '.';
+const CONFIG_DIR = () => path.join(HOME(), '.hunter-mate');
+const CONFIG_FILE = () => path.join(CONFIG_DIR(), 'config.json');
+const store = (0, kit_1.createJsonConfigStore)({
+    configPath: CONFIG_FILE,
+    defaults: { serverUrl: 'http://localhost:34567', lang: 'zh-CN' },
+});
 function ensureConfigDir() {
-    if (!fs.existsSync(CONFIG_DIR)) {
-        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    if (!fs.existsSync(CONFIG_DIR())) {
+        fs.mkdirSync(CONFIG_DIR(), { recursive: true });
     }
 }
 function loadConfig() {
-    ensureConfigDir();
-    if (fs.existsSync(CONFIG_FILE)) {
-        return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
-    }
-    return {
-        serverUrl: 'http://localhost:34567',
-        lang: 'zh-CN',
-    };
+    return store.load();
 }
 function saveConfig(config) {
-    ensureConfigDir();
-    const current = loadConfig();
-    const next = { ...current, ...config };
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify(next, null, 2));
-    return next;
+    return store.save(config);
 }

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

@@ -1,13 +1,16 @@
 {
     "cli.description": "HiredChina headhunter Agent data assistant",
     "cli.langOption": "Output language (zh-CN/en-US)",
-    "login.description": "Login with OAuth device code",
+    "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",

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

@@ -1,13 +1,16 @@
 {
     "cli.description": "HiredChina 猎头 Agent 数据助手",
     "cli.langOption": "输出语言(zh-CN/en-US)",
-    "login.description": "使用 OAuth 设备码登录",
+    "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": "查看服务、登录、扩展状态",

package/dist/index.js

@@ -61,12 +61,14 @@ const extras_1 = require("./commands/extras");
 const ops_1 = require("./commands/ops");
 const addons_1 = require("./commands/addons");
 const i18n_1 = require("./i18n");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { version: CLI_VERSION } = require('../package.json');
 (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')
+    .version(CLI_VERSION)
     .option('--lang <lang>', i18n_1.i18n.t('cli.langOption'), 'zh-CN')
     .hook('preAction', async (thisCommand) => {
     const lang = thisCommand.opts().lang;

package/dist/sentry.d.ts

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

package/dist/sentry.js

@@ -1,62 +1,10 @@
 "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;
+const kit_1 = require("@chromepilot/kit");
+Object.defineProperty(exports, "Sentry", { enumerable: true, get: function () { return kit_1.Sentry; } });
+/** Sentry 初始化:通用骨架来自 @chromepilot/kit(HM_ 前缀 env 读取) */
 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;
-        },
-    });
+    return (0, kit_1.initSentryFromEnv)('HM');
 }

package/dist/updater.d.ts

@@ -5,19 +5,18 @@
  */
 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): {
+export declare const npmLatestVersion: (pkg?: string) => string | null;
+export declare const 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 declare const updateCheckIntervalMs: () => number;
+export declare const shouldCheckUpdate: (stateFile?: string, now?: number, intervalMs?: number) => boolean;
+export declare const markUpdateChecked: (stateFile?: string) => void;
 export interface CliUpdateOutcome {
     logs: string[];
     devSkipped: boolean;
     updated: boolean;
 }
+/** preAction 集成入口:返回日志行数组,永不 throw */
 export declare function maybeCliSelfUpdate(): Promise<CliUpdateOutcome>;

package/dist/updater.js

@@ -33,36 +33,28 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.markUpdateChecked = exports.shouldCheckUpdate = exports.updateCheckIntervalMs = exports.npmSelfUpdate = exports.npmLatestVersion = void 0;
 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 对齐)。
+ * CLI 自动更新(使用态)— 通用实现来自 @chromepilot/kit createCliUpdater。
  *
- * 设计(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 模式(测试用)
+ * hunter-mate 差异点通过工厂参数注入:
+ * - npm 包名 hunter-mate、env 前缀 HUNTER_MATE、状态目录 ~/.hunter-mate
+ * - dev 判定(hc-hw local worktree 布局 + HUNTER_MATE_DEV=1)为本仓特有安装形态
+ * - 已安装版本读取走 version.ts 的 package.json SSOT 扫描
+ *
+ * 逃生开关(kit autoCliUpdate 内统一处理):
+ * - 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 kit_1 = require("@chromepilot/kit");
 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。
@@ -76,86 +68,22 @@ function computeDevLinked(pkgRoot) {
 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}),可手动执行` };
-}
+const updater = (0, kit_1.createCliUpdater)({
+    npmPackage: 'hunter-mate',
+    envPrefix: 'HUNTER_MATE',
+    stateDir: ROOT,
+    getInstalledVersion: () => (0, version_1.readInstalledVersions)().cli,
+    isDev: isDevLinked,
+});
 // ---------------------------------------------------------------------------
-// 节流
+// 兼容导出(调用方零改动)
 // ---------------------------------------------------------------------------
-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 {
-        /* 尽力 */
-    }
-}
+exports.npmLatestVersion = updater.npmLatestVersion;
+exports.npmSelfUpdate = updater.npmSelfUpdate;
+exports.updateCheckIntervalMs = updater.updateCheckIntervalMs;
+exports.shouldCheckUpdate = updater.shouldCheckUpdate;
+exports.markUpdateChecked = updater.markUpdateChecked;
+/** preAction 集成入口:返回日志行数组,永不 throw */
 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;
+    return updater.autoCliUpdate();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hunter-mate",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "HiredChina 猎头 Agent 数据助手 CLI:人才库/客户/职位数据访问,浏览器录制解析简历,server/扩展一致性自愈",
   "license": "UNLICENSED",
   "repository": {
@@ -18,6 +18,7 @@
     "dist"
   ],
   "dependencies": {
+    "@chromepilot/kit": "^0.1.1",
     "@sentry/node": "^10.70.0",
     "@types/ws": "^8.18.1",
     "axios": "^1.6.0",
@@ -29,7 +30,7 @@
     "open": "^8.4.0",
     "uuid": "^9.0.0",
     "ws": "^8.21.3",
-    "@hunter-mate/shared": "0.1.0"
+    "@hunter-mate/shared": "0.1.2"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",