@skillfm/local 2.0.0 → 2.0.3

package/dist/agent-hints.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Agent Hint — sidecar → agent 的指令文案 (双语并列)
+ *
+ * 场景: 用户跑 `npx -y @skillfm/local@latest start` 或 POST /activate/poll
+ * 成功后, sidecar 返回的 JSON 里带 `hint_for_agent`, agent 读后决定下一步动作 +
+ * 对用户说什么.
+ *
+ * 设计 (2026-04-19 方案 v2):
+ *   首次安装的 hint 文本量不大, 直接**中英并列**. agent 会根据用户发来的消息
+ *   语言自动选对应语言回复 — 不需要服务端 detectLang, 更鲁棒
+ *   (不依赖 env / Intl / locale 判断, 不会踩 macOS LANG=en_US 但系统中文 的坑).
+ *
+ * 每条 hint 尾部明示: [Reply in the user's language | 请用用户所用的语言回复].
+ */
+export type AgentHintKey = 'activation_success' | 'running_activated' | 'running_not_activated';
+interface AgentHintVars {
+    /** sidecar 运行地址 (running_* 用) */
+    url?: string;
+}
+/**
+ * 返回指定 key 的双语并列 hint. Agent 按用户消息语言自动匹配回复.
+ */
+export declare function agentHint(key: AgentHintKey, vars?: AgentHintVars): string;
+export {};
+//# sourceMappingURL=agent-hints.d.ts.map

package/dist/agent-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-hints.d.ts","sourceRoot":"","sources":["../src/agent-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,mBAAmB,GACnB,uBAAuB,CAAC;AAE5B,UAAU,aAAa;IACrB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAwED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAY7E"}

package/dist/agent-hints.js

@@ -0,0 +1,87 @@
+/**
+ * Agent Hint — sidecar → agent 的指令文案 (双语并列)
+ *
+ * 场景: 用户跑 `npx -y @skillfm/local@latest start` 或 POST /activate/poll
+ * 成功后, sidecar 返回的 JSON 里带 `hint_for_agent`, agent 读后决定下一步动作 +
+ * 对用户说什么.
+ *
+ * 设计 (2026-04-19 方案 v2):
+ *   首次安装的 hint 文本量不大, 直接**中英并列**. agent 会根据用户发来的消息
+ *   语言自动选对应语言回复 — 不需要服务端 detectLang, 更鲁棒
+ *   (不依赖 env / Intl / locale 判断, 不会踩 macOS LANG=en_US 但系统中文 的坑).
+ *
+ * 每条 hint 尾部明示: [Reply in the user's language | 请用用户所用的语言回复].
+ */
+const LANG_INSTRUCTION = '[Reply in the user\'s language | 请用用户所用的语言回复用户]';
+// ── activation_success ────────────────────────────────────────────────
+const ACTIVATION_SUCCESS_ZH = [
+    '[中文] 激活成功！brain_key 已保存到 ~/.skillfm/config.json。停止轮询。',
+    '用温暖的语气告诉用户:「SkillFM 激活成功！🎉 配置已保存至 ~/.skillfm/config.json」',
+    '然后立即调用 GET /skills 发现可用技能。',
+    '以对话的方式介绍技能列表 — 为每个技能用大白话解释它能做什么, ',
+    '并基于上下文推荐一个用户可能想先试的。',
+].join(' ');
+const ACTIVATION_SUCCESS_EN = [
+    '[English] Activation successful! brain_key saved to ~/.skillfm/config.json.',
+    'Stop polling. Tell the user warmly:',
+    '"SkillFM activated! 🎉 Config saved to ~/.skillfm/config.json"',
+    'then immediately call GET /skills to discover available skills.',
+    'Present the skill list in a friendly, conversational way — for each skill',
+    'explain what it can do in plain language, and suggest one the user might',
+    'want to try first based on context.',
+].join(' ');
+// ── running_activated ─────────────────────────────────────────────────
+function runningActivatedZh(url) {
+    return [
+        `[中文] skillfm-local 正在 ${url} 运行。brain key 已加载 — SkillFM 已激活。`,
+        '告诉用户「SkillFM 已就绪!」, 然后调用',
+        `GET ${url}/skills 发现可用技能。`,
+        '以对话的方式介绍 — 用大白话解释每个技能能做什么, 推荐一个可以试试的。',
+    ].join(' ');
+}
+function runningActivatedEn(url) {
+    return [
+        `[English] skillfm-local is running at ${url}. Brain key loaded — SkillFM is already activated.`,
+        `Tell the user "SkillFM is ready!" then call GET ${url}/skills to discover`,
+        'available skills. Present them conversationally — explain what each skill does',
+        'in plain language and suggest one to try.',
+    ].join(' ');
+}
+// ── running_not_activated ─────────────────────────────────────────────
+function runningNotActivatedZh(url) {
+    return [
+        `[中文] skillfm-local 正在 ${url} 运行。尚未激活。`,
+        `下一步: POST ${url}/activate/start (无请求体) 启动 OAuth 设备流。`,
+        '它会返回一个验证链接 — 用友好的语气告诉用户:',
+        '「我需要你打开一个链接来完成 SkillFM 激活, 只需要几秒钟:」然后展示链接。',
+        `之后每 5 秒轮询 POST ${url}/activate/poll 直到激活。`,
+        '不要问用户是否想激活 — 直接做, 这是必需步骤。',
+    ].join(' ');
+}
+function runningNotActivatedEn(url) {
+    return [
+        `[English] skillfm-local is running at ${url}. Not yet activated.`,
+        `Next step: POST ${url}/activate/start (no body) to start the OAuth device flow.`,
+        'It returns a verification URL — tell the user in a friendly way:',
+        '"I need you to open a link to complete SkillFM activation, just a few seconds:"',
+        `then show the URL. After that, poll POST ${url}/activate/poll every 5 seconds`,
+        'until activated. Do NOT ask the user if they want to activate — just do it,',
+        'it is required.',
+    ].join(' ');
+}
+// ── public API ────────────────────────────────────────────────────────
+/**
+ * 返回指定 key 的双语并列 hint. Agent 按用户消息语言自动匹配回复.
+ */
+export function agentHint(key, vars = {}) {
+    const url = vars.url ?? '';
+    switch (key) {
+        case 'activation_success':
+            return [ACTIVATION_SUCCESS_ZH, ACTIVATION_SUCCESS_EN, LANG_INSTRUCTION].join('\n\n');
+        case 'running_activated':
+            return [runningActivatedZh(url), runningActivatedEn(url), LANG_INSTRUCTION].join('\n\n');
+        case 'running_not_activated':
+            return [runningNotActivatedZh(url), runningNotActivatedEn(url), LANG_INSTRUCTION].join('\n\n');
+    }
+}
+//# sourceMappingURL=agent-hints.js.map

package/dist/agent-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-hints.js","sourceRoot":"","sources":["../src/agent-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,MAAM,gBAAgB,GACpB,iDAAiD,CAAC;AAEpD,yEAAyE;AAEzE,MAAM,qBAAqB,GAAG;IAC5B,uDAAuD;IACvD,4DAA4D;IAC5D,4BAA4B;IAC5B,mCAAmC;IACnC,qBAAqB;CACtB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,qBAAqB,GAAG;IAC5B,6EAA6E;IAC7E,qCAAqC;IACrC,gEAAgE;IAChE,iEAAiE;IACjE,2EAA2E;IAC3E,0EAA0E;IAC1E,qCAAqC;CACtC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,yEAAyE;AAEzE,SAAS,kBAAkB,CAAC,GAAW;IACrC,OAAO;QACL,yBAAyB,GAAG,kCAAkC;QAC9D,0BAA0B;QAC1B,OAAO,GAAG,iBAAiB;QAC3B,uCAAuC;KACxC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,OAAO;QACL,yCAAyC,GAAG,oDAAoD;QAChG,mDAAmD,GAAG,qBAAqB;QAC3E,gFAAgF;QAChF,2CAA2C;KAC5C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,yEAAyE;AAEzE,SAAS,qBAAqB,CAAC,GAAW;IACxC,OAAO;QACL,yBAAyB,GAAG,WAAW;QACvC,aAAa,GAAG,sCAAsC;QACtD,0BAA0B;QAC1B,4CAA4C;QAC5C,kBAAkB,GAAG,sBAAsB;QAC3C,2BAA2B;KAC5B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAW;IACxC,OAAO;QACL,yCAAyC,GAAG,sBAAsB;QAClE,mBAAmB,GAAG,2DAA2D;QACjF,kEAAkE;QAClE,iFAAiF;QACjF,4CAA4C,GAAG,gCAAgC;QAC/E,6EAA6E;QAC7E,iBAAiB;KAClB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,yEAAyE;AAEzE;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAiB,EAAE,OAAsB,EAAE;IACnE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;IAC3B,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,oBAAoB;YACvB,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvF,KAAK,mBAAmB;YACtB,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3F,KAAK,uBAAuB;YAC1B,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC,IAAI,CACpF,MAAM,CACP,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/doctor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * BSO M9-5 — `skillfm doctor` 诊断命令
+ *
+ * Refs: docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.6
+ *
+ * 三层自检：
+ *   L1 LLM 层：priming block 是否已注入到目标文件
+ *   L2 harness 层：hooks / MCP 配置是否已注册
+ *   L3 sidecar 层：sidecar 是否在跑、guard 端点是否可达
+ *
+ * 输出：人类可读（中文），每项 ✅ / ⚠️ / ❌。
+ */
+import { type Harness } from './harness/detector.js';
+interface CheckItem {
+    layer: 'L1' | 'L2' | 'L3';
+    status: 'ok' | 'warn' | 'fail';
+    title: string;
+    detail: string;
+    fix?: string;
+}
+export interface DoctorReport {
+    harness: Harness;
+    detect_source: string;
+    detect_reason: string;
+    items: CheckItem[];
+}
+export declare function runDoctor(cwd?: string): Promise<DoctorReport>;
+export declare function renderDoctorReport(r: DoctorReport): string;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAKpE,UAAU,SAAS;IACjB,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAqOD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,wBAAsB,SAAS,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAalF;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAqB1D"}

package/dist/doctor.js

@@ -0,0 +1,272 @@
+/**
+ * BSO M9-5 — `skillfm doctor` 诊断命令
+ *
+ * Refs: docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.6
+ *
+ * 三层自检：
+ *   L1 LLM 层：priming block 是否已注入到目标文件
+ *   L2 harness 层：hooks / MCP 配置是否已注册
+ *   L3 sidecar 层：sidecar 是否在跑、guard 端点是否可达
+ *
+ * 输出：人类可读（中文），每项 ✅ / ⚠️ / ❌。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { detectHarness } from './harness/detector.js';
+import { pathsFor, capabilitiesFor, SKILLFM_GUARD_COMMAND } from './harness/templates.js';
+import { PRIMING_BEGIN } from './harness/priming.js';
+import { readSidecarEndpoint } from './guard/sidecar-client.js';
+function symbol(s) {
+    return s === 'ok' ? '✅' : s === 'warn' ? '⚠️ ' : '❌';
+}
+// ============================================================================
+// L1: LLM priming 层
+// ============================================================================
+function checkL1Priming(harness, cwd) {
+    const paths = pathsFor(harness, cwd);
+    const items = [];
+    try {
+        if (!existsSync(paths.primingFile)) {
+            items.push({
+                layer: 'L1',
+                status: 'fail',
+                title: 'LLM priming 文件不存在',
+                detail: paths.primingFile,
+                fix: `运行 \`skillfm init --harness=${harness}\``,
+            });
+            return items;
+        }
+        const content = readFileSync(paths.primingFile, 'utf-8');
+        if (!content.includes(PRIMING_BEGIN)) {
+            items.push({
+                layer: 'L1',
+                status: 'warn',
+                title: 'LLM priming 文件存在但未注入 SkillFM block',
+                detail: paths.primingFile,
+                fix: `运行 \`skillfm init --harness=${harness}\``,
+            });
+        }
+        else {
+            items.push({
+                layer: 'L1',
+                status: 'ok',
+                title: 'LLM priming 已注入',
+                detail: paths.primingFile,
+            });
+        }
+    }
+    catch (err) {
+        items.push({
+            layer: 'L1',
+            status: 'fail',
+            title: 'LLM priming 文件检查失败',
+            detail: err.message,
+        });
+    }
+    return items;
+}
+// ============================================================================
+// L2: harness 层
+// ============================================================================
+function checkL2Harness(harness, cwd) {
+    const paths = pathsFor(harness, cwd);
+    const caps = capabilitiesFor(harness);
+    const items = [];
+    if (harness === 'unknown') {
+        items.push({
+            layer: 'L2',
+            status: 'warn',
+            title: 'harness 未识别',
+            detail: '无法自动写入 harness 层配置；L1 + L3 仍然可用',
+            fix: '运行 `skillfm init --harness=<claude-code|openclaw|cursor|aider|windsurf>`',
+        });
+        return items;
+    }
+    if (!caps.preToolUseHook) {
+        items.push({
+            layer: 'L2',
+            status: 'warn',
+            title: `${harness}: PreToolUse hook 未支持`,
+            detail: caps.fallback || '退化到 MCP description + sidecar 9 红线兜底',
+            fix: caps.hookResearched ? undefined : `等待 M9-6 调研结论后升级模板`,
+        });
+        return items;
+    }
+    if (!paths.harnessConfigFile) {
+        items.push({
+            layer: 'L2',
+            status: 'fail',
+            title: `${harness}: 无 harness 配置文件目标路径`,
+            detail: '内部错误，请报 bug',
+        });
+        return items;
+    }
+    if (!existsSync(paths.harnessConfigFile)) {
+        items.push({
+            layer: 'L2',
+            status: 'fail',
+            title: `${harness}: 配置文件不存在`,
+            detail: paths.harnessConfigFile,
+            fix: `运行 \`skillfm init --harness=${harness}\``,
+        });
+        return items;
+    }
+    try {
+        const content = readFileSync(paths.harnessConfigFile, 'utf-8');
+        if (!content.includes(SKILLFM_GUARD_COMMAND)) {
+            items.push({
+                layer: 'L2',
+                status: 'warn',
+                title: `${harness}: hook 未注册 skillfm-guard`,
+                detail: paths.harnessConfigFile,
+                fix: `运行 \`skillfm init --harness=${harness}\``,
+            });
+        }
+        else {
+            items.push({
+                layer: 'L2',
+                status: 'ok',
+                title: `${harness}: hook 已注册`,
+                detail: paths.harnessConfigFile,
+            });
+        }
+    }
+    catch (err) {
+        items.push({
+            layer: 'L2',
+            status: 'fail',
+            title: `${harness}: 配置文件读取失败`,
+            detail: err.message,
+        });
+    }
+    // skillfm-guard 可执行性（简单 existsSync 在 PATH 中不好查；退而求其次检测包内路径）
+    // 让 skillfm doctor 读 ~/.skillfm/local.json 的 url 来验证 sidecar 可达即可；
+    // guard 可执行由 install 流程保证，此处信息级。
+    return items;
+}
+// ============================================================================
+// L3: sidecar + guard endpoint
+// ============================================================================
+async function checkL3Sidecar() {
+    const items = [];
+    const endpoint = readSidecarEndpoint();
+    if (!endpoint) {
+        items.push({
+            layer: 'L3',
+            status: 'fail',
+            title: 'sidecar 未运行',
+            detail: '找不到 ~/.skillfm/local.json；sidecar 未启动',
+            fix: '运行 `skillfm start`',
+        });
+        return items;
+    }
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 1000);
+        const res = await fetch(`${endpoint.url}/health`, { signal: controller.signal });
+        clearTimeout(timer);
+        if (res.ok) {
+            items.push({
+                layer: 'L3',
+                status: 'ok',
+                title: 'sidecar /health 正常',
+                detail: endpoint.url,
+            });
+        }
+        else {
+            items.push({
+                layer: 'L3',
+                status: 'warn',
+                title: `sidecar /health 返回 ${res.status}`,
+                detail: endpoint.url,
+            });
+        }
+    }
+    catch (err) {
+        items.push({
+            layer: 'L3',
+            status: 'fail',
+            title: 'sidecar 不可达',
+            detail: `${endpoint.url}: ${err.message}`,
+            fix: '`skillfm restart`',
+        });
+        return items;
+    }
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 1000);
+        const res = await fetch(`${endpoint.url}/internal/guard/snapshot`, {
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (res.ok) {
+            const body = await res.json().catch(() => ({}));
+            const sessCount = body?.snapshot?.sessions?.length ?? 0;
+            const lastBrainRunAt = body?.snapshot?.last_brain_run_at ?? null;
+            items.push({
+                layer: 'L3',
+                status: 'ok',
+                title: 'guard 端点响应正常',
+                detail: `sessions=${sessCount}, last_brain_run_at=${lastBrainRunAt ? new Date(lastBrainRunAt).toISOString() : 'null'}`,
+            });
+        }
+        else {
+            items.push({
+                layer: 'L3',
+                status: 'warn',
+                title: `guard 端点返回 ${res.status}`,
+                detail: `${endpoint.url}/internal/guard/snapshot`,
+            });
+        }
+    }
+    catch (err) {
+        items.push({
+            layer: 'L3',
+            status: 'warn',
+            title: 'guard 端点超时',
+            detail: err.message,
+        });
+    }
+    return items;
+}
+export async function runDoctor(cwd = process.cwd()) {
+    const detected = detectHarness({ cwd });
+    const items = [
+        ...checkL1Priming(detected.harness, cwd),
+        ...checkL2Harness(detected.harness, cwd),
+        ...(await checkL3Sidecar()),
+    ];
+    return {
+        harness: detected.harness,
+        detect_source: detected.source,
+        detect_reason: detected.reason,
+        items,
+    };
+}
+export function renderDoctorReport(r) {
+    const lines = [];
+    lines.push(`SkillFM doctor — harness=${r.harness} (detected via ${r.detect_source}: ${r.detect_reason})`);
+    lines.push('');
+    for (const layer of ['L1', 'L2', 'L3']) {
+        const layerItems = r.items.filter((i) => i.layer === layer);
+        if (layerItems.length === 0)
+            continue;
+        lines.push(`${layer === 'L1' ? 'L1 LLM 层' : layer === 'L2' ? 'L2 harness 层' : 'L3 sidecar 层'}`);
+        for (const it of layerItems) {
+            lines.push(`  ${symbol(it.status)} ${it.title}`);
+            lines.push(`     ${it.detail}`);
+            if (it.fix)
+                lines.push(`     修复: ${it.fix}`);
+        }
+        lines.push('');
+    }
+    const hasFail = r.items.some((i) => i.status === 'fail');
+    const hasWarn = r.items.some((i) => i.status === 'warn');
+    if (hasFail)
+        lines.push('❌ 发现 fail 项，上面列出了修复建议');
+    else if (hasWarn)
+        lines.push('⚠️  有 warn 项，查看详情决定是否修复');
+    else
+        lines.push('✅ 所有检查通过');
+    return lines.join('\n');
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"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"}

package/dist/guard/bin.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * BSO M9-4 — skillfm-guard binary entrypoint
+ *
+ * Installed as `skillfm-guard` via package.json `bin`. Invoked by harness hooks
+ * (Claude Code SessionStart/PreToolUse/PostToolUse etc.).
+ *
+ * Always returns an exit code; never throws. Fail-open behavior lives in cli.ts.
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/guard/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/guard/bin.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}

package/dist/guard/bin.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * BSO M9-4 — skillfm-guard binary entrypoint
+ *
+ * Installed as `skillfm-guard` via package.json `bin`. Invoked by harness hooks
+ * (Claude Code SessionStart/PreToolUse/PostToolUse etc.).
+ *
+ * Always returns an exit code; never throws. Fail-open behavior lives in cli.ts.
+ */
+import { runGuardCli } from './cli.js';
+runGuardCli(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+    process.stderr.write(`[skillfm-guard] fatal: ${err?.message || err}\n`);
+    // fail-open: even fatal errors should not lock the user's harness
+    process.exit(0);
+});
+//# sourceMappingURL=bin.js.map

package/dist/guard/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/guard/bin.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CACrC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,GAAG,EAAE,EAAE;IACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,GAAG,EAAE,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC;IACxE,kEAAkE;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/guard/cli.d.ts

@@ -0,0 +1,23 @@
+/**
+ * BSO M9-4 — skillfm-guard CLI 入口
+ *
+ * Refs: docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.4 + §3.5
+ *
+ * 子命令（由 harness 的 hook 机制触发）：
+ *   - session-start      → SessionStart（warn-only；启 sidecar 记录 session）
+ *   - pre-tool-use       → PreToolUse（阻断性；未 brain_run → exit 2）
+ *   - post-tool-use      → PostToolUse（warn-only；audit 用途）
+ *   - check-script-loaded → doctor / 旁路用，查询当前 sidecar 状态
+ *
+ * Claude Code hook payload 约定（Anthropic spec）：
+ *   - SessionStart: stdin JSON { session_id, source?, cwd? }
+ *   - PreToolUse:   stdin JSON { session_id, tool_name, tool_input? }
+ *   - PostToolUse:  stdin JSON { session_id, tool_name, tool_response? }
+ *
+ * Fail-open 原则：sidecar 不可达 / 超时 / 解析失败一律 exit 0 + stderr warn，
+ * 只有 sidecar 明确返回 412 才 exit 2。这样保证 hook 故障不会锁死用户 UX。
+ */
+type ExitCode = 0 | 2;
+export declare function runGuardCli(argv: string[]): Promise<ExitCode>;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/guard/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/guard/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAUH,KAAK,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;AA+MtB,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyCnE"}