@skillfm/local 2.0.4 → 2.0.5

package/dist/harness/kernels/registry.js

@@ -0,0 +1,139 @@
+/**
+ * BSO M9 v0.3 — Layer 3 KernelAdapter 注册表 + 装配
+ *
+ * Refs:
+ *   - docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.4.3
+ *
+ * `installAll(host)`：根据 host 命中所有匹配的 adapter，并行 install。
+ * 多内核共存策略：M9 P0 取强制力最强的一类（hook-file > deny-pipeline > mcp-only）。
+ *
+ * 用法：
+ *   ```ts
+ *   const host = detectHostInfo();
+ *   const report = await installAll({ host, cwd: process.cwd(), apply: true });
+ *   ```
+ */
+import { detectHarness } from '../detector.js';
+import { hookFileAdapter } from './hook-file.js';
+import { denyPipelineAdapter } from './deny-pipeline.js';
+import { mcpOnlyAdapter, scanMcpOnlyHosts } from './mcp-only.js';
+import { protocolRejectAdapter } from './protocol-reject.js';
+// ============================================================================
+// 注册表（顺序 = 强制力降序）
+// ============================================================================
+export const REGISTRY = [
+    hookFileAdapter,
+    denyPipelineAdapter,
+    mcpOnlyAdapter,
+    // protocolRejectAdapter 不参与 installAll（matches=false），仅 diagnoseAll 引用
+];
+export const ALL_ADAPTERS = [
+    ...REGISTRY,
+    protocolRejectAdapter,
+];
+export function getAdapter(kind) {
+    return ALL_ADAPTERS.find((a) => a.kind === kind);
+}
+// ============================================================================
+// 检测 → host info
+// ============================================================================
+/**
+ * detectHarness 只识别 v0.2 的 5 个 IDE/CLI host；v0.3 新增的 mcp-only host
+ * （Claude Desktop / 5ire / Tome / Witsy）需要走配置文件扫描。
+ *
+ * 策略：
+ *   1. detector 命中 → 返回该 host
+ *   2. detector unknown → 扫 mcp-only 候选；若有命中且唯一 → 返回该 host
+ *   3. 多个候选或无候选 → 返回 unknown
+ */
+export function detectPrimaryHost() {
+    const det = detectHarness();
+    if (det.harness !== 'unknown') {
+        return {
+            host: det.harness,
+            source: 'detected',
+            reason: det.reason,
+        };
+    }
+    const scanned = scanMcpOnlyHosts();
+    if (scanned.length === 1) {
+        return scanned[0];
+    }
+    if (scanned.length > 1) {
+        return {
+            host: 'unknown',
+            source: 'scanned',
+            reason: `multiple mcp-only hosts found: ${scanned.map((s) => s.host).join(', ')}; use --host=<name> to disambiguate`,
+        };
+    }
+    return {
+        host: 'unknown',
+        source: 'detected',
+        reason: det.reason,
+    };
+}
+export async function installAll(opts) {
+    const ctx = {
+        host: opts.host,
+        cwd: opts.cwd,
+        apply: opts.apply,
+    };
+    const matched = opts.forceKernel
+        ? ALL_ADAPTERS.filter((a) => a.kind === opts.forceKernel)
+        : REGISTRY.filter((a) => a.matches(opts.host));
+    const results = [];
+    const warnings = [];
+    if (matched.length === 0) {
+        warnings.push(`host ${opts.host.host} 未命中任何 Layer 3 内核；仅 Layer 1 SKILL.md priming 生效`);
+    }
+    else {
+        // 顺序执行（避免 backup 时戳冲突）
+        for (const adapter of matched) {
+            try {
+                const r = await adapter.install(ctx);
+                results.push(r);
+                warnings.push(...r.warnings);
+            }
+            catch (err) {
+                warnings.push(`${adapter.kind} install 失败: ${err.message}`);
+            }
+        }
+    }
+    // mcp-only 额外 host
+    if (opts.alsoInstallMcpHosts && opts.alsoInstallMcpHosts.length > 0) {
+        for (const h of opts.alsoInstallMcpHosts) {
+            const subCtx = {
+                host: { host: h, source: 'forced' },
+                cwd: opts.cwd,
+                apply: opts.apply,
+            };
+            try {
+                const r = await mcpOnlyAdapter.install(subCtx);
+                results.push(r);
+                warnings.push(...r.warnings);
+            }
+            catch (err) {
+                warnings.push(`mcp-only ${h} install 失败: ${err.message}`);
+            }
+        }
+    }
+    return {
+        host: opts.host,
+        matched: matched.map((a) => a.kind),
+        results,
+        warnings,
+    };
+}
+export async function diagnoseAll(host, cwd) {
+    const ctx = { host, cwd, apply: false };
+    const layer3 = await Promise.all(REGISTRY.filter((a) => a.matches(host)).map((a) => a.diagnose(ctx)));
+    const layer2 = await protocolRejectAdapter.diagnose(ctx);
+    return { host, layer3, layer2 };
+}
+// ============================================================================
+// 兼容映射：把 detector.Harness 映射到 HostId
+// ============================================================================
+export function harnessToHostId(h) {
+    return h;
+}
+//# sourceMappingURL=registry.js.map

package/dist/harness/kernels/registry.js.map

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

package/dist/harness/kernels/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * BSO M9 v0.3 — KernelAdapter 抽象（Layer 3）
+ *
+ * Refs:
+ *   - docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.4
+ *
+ * 哲学转向：v0.2 是 "N harness × N adapter" 扁平设计；v0.3 改为
+ * "K 类机制内核 × N host 模板" 抽象 — 一类内核覆盖 N 个 host，
+ * 新 host 95% 归入已有内核类别零额外开发。
+ *
+ * P0 内核（M9）：
+ *   - hook-file       (Claude Code / Cursor 1.7+ / Windsurf)
+ *   - deny-pipeline   (OpenClaw)
+ *   - mcp-only        (Claude Desktop / 5ire / Tome / Witsy)
+ *   - protocol-reject (Layer 2 联动占位，无独立 install/uninstall)
+ *
+ * P1+ 内核（M9 之后）：hook-executable / lifecycle-decorator /
+ *   filter-pipeline / memory-block / ...（详见 PRD §8）。
+ */
+import type { Harness } from '../detector.js';
+export type KernelType = 'hook-file' | 'deny-pipeline' | 'mcp-only' | 'protocol-reject';
+/**
+ * 候选 host 标识。注：不复用 Harness 类型 — 因为 mcp-only 内核覆盖了
+ * detector.ts 之前没有的 host（Claude Desktop / 5ire / Tome / Witsy）。
+ */
+export type HostId = Harness | 'claude-desktop' | '5ire' | 'tome' | 'witsy';
+export interface HostInfo {
+    /** 命中的 host 名 */
+    host: HostId;
+    /** 命中来源（detector / 用户 --host=... / mcp-only 全候选扫描）*/
+    source: 'detected' | 'forced' | 'scanned';
+    /** 可读提示（doctor 用） */
+    reason?: string;
+    /** harness 版本，未知则 undefined */
+    version?: string;
+}
+export interface InstallContext {
+    host: HostInfo;
+    cwd: string;
+    /** 写入是否真正落盘；false 时只 dry-run（doctor 用） */
+    apply: boolean;
+}
+export interface InstalledFile {
+    /** 文件绝对路径 */
+    path: string;
+    /** 操作类型 */
+    action: 'created' | 'merged' | 'already-registered' | 'replaced' | 'noop';
+    /** 备份路径（若有） */
+    backup?: string;
+    /** 备注 */
+    details?: string;
+}
+export interface InstallResult {
+    kernel: KernelType;
+    host: HostId;
+    /** 写入的文件清单 */
+    files: InstalledFile[];
+    /** 警告（不阻断 init） */
+    warnings: string[];
+}
+export interface DiagnoseResult {
+    kernel: KernelType;
+    host: HostId;
+    /** 该内核当前的强制力等级 */
+    level: 'strong' | 'protocol-fallback' | 'soft' | 'absent';
+    /** 子检查项（每条独立） */
+    checks: Array<{
+        name: string;
+        ok: boolean;
+        detail?: string;
+    }>;
+}
+export interface KernelAdapter {
+    kind: KernelType;
+    /** 该 adapter 覆盖的所有 host */
+    supportedHosts: readonly HostId[];
+    /** 当前 host 是否归入该内核类别 */
+    matches(host: HostInfo): boolean;
+    /** 安装：写入配置文件 + 注册 hooks/MCP/deny */
+    install(ctx: InstallContext): Promise<InstallResult>;
+    /** 卸载：恢复 .bak / 移除注册项 */
+    uninstall(ctx: InstallContext): Promise<InstallResult>;
+    /** 诊断：检查该 host 当前 install 状态 */
+    diagnose(ctx: InstallContext): Promise<DiagnoseResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/harness/kernels/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/harness/kernels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,eAAe,GACf,UAAU,GACV,iBAAiB,CAAC;AAMtB;;;GAGG;AACH,MAAM,MAAM,MAAM,GACd,OAAO,GACP,gBAAgB,GAChB,MAAM,GACN,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,WAAW,QAAQ;IACvB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1C,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,MAAM,EACF,SAAS,GACT,QAAQ,GACR,oBAAoB,GACpB,UAAU,GACV,MAAM,CAAC;IACX,eAAe;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,EAAE,QAAQ,GAAG,mBAAmB,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1D,iBAAiB;IACjB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,OAAO,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAMD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IAEjB,2BAA2B;IAC3B,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC,wBAAwB;IACxB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAEjC,oCAAoC;IACpC,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAErD,yBAAyB;IACzB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvD,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACxD"}

package/dist/harness/kernels/types.js

@@ -0,0 +1,21 @@
+/**
+ * BSO M9 v0.3 — KernelAdapter 抽象（Layer 3）
+ *
+ * Refs:
+ *   - docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.4
+ *
+ * 哲学转向：v0.2 是 "N harness × N adapter" 扁平设计；v0.3 改为
+ * "K 类机制内核 × N host 模板" 抽象 — 一类内核覆盖 N 个 host，
+ * 新 host 95% 归入已有内核类别零额外开发。
+ *
+ * P0 内核（M9）：
+ *   - hook-file       (Claude Code / Cursor 1.7+ / Windsurf)
+ *   - deny-pipeline   (OpenClaw)
+ *   - mcp-only        (Claude Desktop / 5ire / Tome / Witsy)
+ *   - protocol-reject (Layer 2 联动占位，无独立 install/uninstall)
+ *
+ * P1+ 内核（M9 之后）：hook-executable / lifecycle-decorator /
+ *   filter-pipeline / memory-block / ...（详见 PRD §8）。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/harness/kernels/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/harness/kernels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/mcp-output/builder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * BSO M9.5 — MCP Protocol-Reject 输出 builder
+ *
+ * Refs: docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.3.2
+ *
+ * 双发策略（机制 C）：
+ *   - 机制 A：URLElicitationRequiredError(-32042) → 强 client（MCP 2025-11-25）
+ *   - 机制 B：result + isError:true → 全 client 兜底
+ *
+ * 调用方按需选取（HTTP 端点根据 query format= 输出哪个）。
+ */
+import type { McpRejectEnvelope, RejectInput } from './types.js';
+export declare function buildElicitationId(taskId: string): string;
+export declare function buildElicitationError(input: RejectInput, elicitationIdOverride?: string): NonNullable<McpRejectEnvelope['error']>;
+export declare function buildIsErrorResult(input: RejectInput): McpRejectEnvelope['result'];
+/**
+ * 双发：返回 envelope，HTTP 层按 query/header 选择。
+ * 默认 envelope 中两个字段都 populate。
+ *
+ * 可选传 elicitationIdOverride —— 让 sidecar 提前生成 id 注册到 reviewStore，
+ * 保证 envelope.error.data.elicitations[0].elicitationId 与 reviewStore index 对得上。
+ */
+export declare function buildRejectEnvelope(input: RejectInput, elicitationIdOverride?: string): McpRejectEnvelope;
+//# sourceMappingURL=builder.d.ts.map

package/dist/mcp-output/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/mcp-output/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAMpB,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIzD;AAiCD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,WAAW,EAClB,qBAAqB,CAAC,EAAE,MAAM,GAC7B,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAqBzC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAclF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,qBAAqB,CAAC,EAAE,MAAM,GAC7B,iBAAiB,CAKnB"}

package/dist/mcp-output/builder.js

@@ -0,0 +1,99 @@
+/**
+ * BSO M9.5 — MCP Protocol-Reject 输出 builder
+ *
+ * Refs: docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.3.2
+ *
+ * 双发策略（机制 C）：
+ *   - 机制 A：URLElicitationRequiredError(-32042) → 强 client（MCP 2025-11-25）
+ *   - 机制 B：result + isError:true → 全 client 兜底
+ *
+ * 调用方按需选取（HTTP 端点根据 query format= 输出哪个）。
+ */
+// ============================================================================
+// elicitation id 生成
+// ============================================================================
+export function buildElicitationId(taskId) {
+    // 不引入 crypto；用时间戳 + taskId hash 做唯一 id（生命周期内可识别即可）
+    const ts = Date.now().toString(36);
+    return `skillfm-deny-${taskId}-${ts}`;
+}
+function buildDenyReviewUrl(sidecarBaseUrl, taskId) {
+    return `${sidecarBaseUrl.replace(/\/$/, '')}/deny-review/${encodeURIComponent(taskId)}`;
+}
+// ============================================================================
+// 文案
+// ============================================================================
+function buildShortMessage(input) {
+    const parts = [`SkillFM 9 红线拦截`];
+    if (input.redline)
+        parts.push(`(${input.redline})`);
+    parts.push('— 需用户审阅');
+    return parts.join(' ');
+}
+function buildLongText(input) {
+    const lines = [];
+    lines.push(`SkillFM 拦截：本任务${input.tool ? `调用 \`${input.tool}\` 时` : ''}触发 9 红线${input.redline ? ` ${input.redline}` : ''}。`);
+    if (input.tier)
+        lines.push(`风险等级：Tier-${input.tier}。`);
+    lines.push(`原因：${input.reason}`);
+    if (input.hint)
+        lines.push(`建议：${input.hint}`);
+    lines.push('');
+    lines.push(`审阅入口：${buildDenyReviewUrl(input.sidecarBaseUrl, input.task_id)}`);
+    lines.push('用户在审阅页同意后，SkillFM 会发 notifications/elicitation/complete，client 自动 retry。');
+    return lines.join('\n');
+}
+// ============================================================================
+// builders
+// ============================================================================
+export function buildElicitationError(input, elicitationIdOverride) {
+    const elicitationId = elicitationIdOverride ?? buildElicitationId(input.task_id);
+    const url = buildDenyReviewUrl(input.sidecarBaseUrl, input.task_id);
+    return {
+        jsonrpc: '2.0',
+        id: input.requestId ?? null,
+        error: {
+            code: -32042,
+            message: buildShortMessage(input),
+            data: {
+                elicitations: [
+                    {
+                        mode: 'url',
+                        elicitationId,
+                        url,
+                        message: buildLongText(input),
+                    },
+                ],
+            },
+        },
+    };
+}
+export function buildIsErrorResult(input) {
+    return {
+        jsonrpc: '2.0',
+        id: input.requestId ?? null,
+        result: {
+            content: [
+                {
+                    type: 'text',
+                    text: buildLongText(input),
+                },
+            ],
+            isError: true,
+        },
+    };
+}
+/**
+ * 双发：返回 envelope，HTTP 层按 query/header 选择。
+ * 默认 envelope 中两个字段都 populate。
+ *
+ * 可选传 elicitationIdOverride —— 让 sidecar 提前生成 id 注册到 reviewStore，
+ * 保证 envelope.error.data.elicitations[0].elicitationId 与 reviewStore index 对得上。
+ */
+export function buildRejectEnvelope(input, elicitationIdOverride) {
+    return {
+        error: buildElicitationError(input, elicitationIdOverride),
+        result: buildIsErrorResult(input),
+    };
+}
+//# sourceMappingURL=builder.js.map

package/dist/mcp-output/builder.js.map

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

package/dist/mcp-output/deny-review.d.ts

@@ -0,0 +1,64 @@
+/**
+ * BSO M9.5 — /deny-review/:task_id HTML 审阅页 + elicitation/complete 事件流
+ *
+ * Refs: docs/prd/PRD-BSO-M9-HARNESS-HOOKS.md §3.3.4
+ *
+ * 用户在浏览器里看到这个页面后：
+ *   - "同意" → POST /deny-review/:task_id/approve → reviewStore.decide → 广播 complete 事件
+ *   - "修改" → POST /deny-review/:task_id/modify  → 同上 (decision='modified')
+ *   - "撤销" → POST /deny-review/:task_id/cancel  → 同上 (decision='cancelled')
+ *
+ * 事件订阅（M9.5 L2-4）：
+ *   - SSE: GET /internal/mcp/elicitation/stream?elicitationId=<id>
+ *   - Polling: GET /internal/mcp/elicitation/poll?elicitationId=<id>
+ *
+ * 注：MCP host 的"自动 retry"由 SkillFM MCP bridge（P1+ 独立进程）拿到 complete 事件
+ * 后通过 MCP transport 转发 notifications/elicitation/complete 给 client。本文件
+ * 只负责 sidecar 侧事件源 + 订阅接口。
+ */
+import { EventEmitter } from 'node:events';
+import type { RejectInput } from './types.js';
+export type ReviewDecision = 'pending' | 'approved' | 'cancelled' | 'modified';
+export interface ReviewRecord {
+    task_id: string;
+    decision: ReviewDecision;
+    created_at: number;
+    decided_at?: number;
+    reject: RejectInput;
+    /** 与 MCP -32042 envelope 内 elicitations[].elicitationId 配对 */
+    elicitation_id?: string;
+}
+/**
+ * MCP 标准 notifications/elicitation/complete payload。
+ * client 拿到后会自动 retry 原 tool call。
+ */
+export interface ElicitationCompletePayload {
+    jsonrpc: '2.0';
+    method: 'notifications/elicitation/complete';
+    params: {
+        elicitationId: string;
+        /** MCP spec 三态 */
+        action: 'accept' | 'decline' | 'cancel';
+        /** SkillFM 自定义补充字段 */
+        skillfm_decision: ReviewDecision;
+        decided_at: number;
+    };
+}
+export declare function buildElicitationCompletePayload(rec: ReviewRecord): ElicitationCompletePayload | null;
+declare class ReviewStore extends EventEmitter {
+    private store;
+    /** elicitation_id → task_id 反向索引（订阅按 elicitationId 走，broadcast 按 elicitationId）*/
+    private elicitationIndex;
+    open(input: RejectInput, elicitation_id?: string): ReviewRecord;
+    decide(task_id: string, decision: Exclude<ReviewDecision, 'pending'>): ReviewRecord | null;
+    get(task_id: string): ReviewRecord | null;
+    getByElicitationId(elicitation_id: string): ReviewRecord | null;
+    list(): ReviewRecord[];
+    /** 测试用：清空 */
+    reset(): void;
+}
+export declare const reviewStore: ReviewStore;
+export declare function renderReviewPage(rec: ReviewRecord): string;
+export declare function renderNotFoundPage(taskId: string): string;
+export {};
+//# sourceMappingURL=deny-review.d.ts.map

package/dist/mcp-output/deny-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deny-review.d.ts","sourceRoot":"","sources":["../../src/mcp-output/deny-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,oCAAoC,CAAC;IAC7C,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB;QAClB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;QACxC,sBAAsB;QACtB,gBAAgB,EAAE,cAAc,CAAC;QACjC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AASD,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,YAAY,GAChB,0BAA0B,GAAG,IAAI,CAYnC;AAED,cAAM,WAAY,SAAQ,YAAY;IACpC,OAAO,CAAC,KAAK,CAAmC;IAChD,kFAAkF;IAClF,OAAO,CAAC,gBAAgB,CAA6B;IAErD,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,YAAY;IAuB/D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,YAAY,GAAG,IAAI;IAgB1F,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIzC,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK/D,IAAI,IAAI,YAAY,EAAE;IAItB,aAAa;IACb,KAAK,IAAI,IAAI;CAKd;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC;AAe7C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAwE1D;AAeD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYzD"}