autosnippet 3.2.9 → 3.2.11

package/dist/lib/service/agent/domain/insight-analyst.d.ts

@@ -0,0 +1,96 @@
+/**
+ * insight-analyst.js — Insight Analyst 领域函数
+ *
+ * 从旧 AnalystAgent.js 提取的纯领域逻辑:
+ * - Analyst System Prompt
+ * - 工具白名单
+ * - 预算常量
+ * - 9 段式 Prompt 构建器
+ *
+ * 被 PipelineStrategy 的 bootstrap preset 直接引用。
+ * 不再包含任何 Agent 类 — Agent 由 AgentRuntime + PipelineStrategy 驱动。
+ *
+ * @module insight-analyst
+ */
+/** 维度配置 (Analyst) */
+interface AnalystDimConfig {
+    id: string;
+    label: string;
+    guide?: string;
+    focusKeywords?: string[];
+    outputType?: string;
+    allowedKnowledgeTypes?: string[];
+}
+/** 项目信息 (Analyst) */
+interface AnalystProjectInfo {
+    name: string;
+    lang: string;
+    fileCount: number;
+}
+/** DimensionContext 最小接口 */
+interface DimensionContextLike {
+    buildContextForDimension(dimId: string): {
+        previousDimensions: Record<string, DimensionDigestLike>;
+    };
+}
+/** 维度摘要 */
+interface DimensionDigestLike {
+    summary?: string;
+    keyFindings: string[];
+    crossRefs?: Record<string, string>;
+}
+/** EpisodicMemory (SessionStore) 最小接口 */
+interface EpisodicMemoryLike {
+    buildContextForDimension(dimId: string, focusKeywords: string[]): string | null;
+    getRelevantReflections(dimId: string): string | null;
+}
+/** PersistentMemory 最小接口 */
+interface SemanticMemoryLike {
+    toPromptSection(opts: {
+        source: string;
+        query: string;
+        limit: number;
+    }): string | null;
+}
+/** CodeEntityGraph 最小接口 */
+interface CodeEntityGraphLike {
+    generateContextForAgent(opts: {
+        maxEntities: number;
+        maxEdges: number;
+    }): string | null;
+}
+export declare const ANALYST_SYSTEM_PROMPT = "\u4F60\u662F\u4E00\u4F4D\u9AD8\u7EA7\u8F6F\u4EF6\u67B6\u6784\u5E08\uFF0C\u6B63\u5728\u6DF1\u5EA6\u5206\u6790\u4E00\u4E2A\u771F\u5B9E\u9879\u76EE\u7684\u67D0\u4E2A\u7EF4\u5EA6\u3002\n\n## \u6267\u884C\u8BA1\u5212\n\u4F60\u6709 **N \u8F6E**\u5DE5\u5177\u8C03\u7528\u673A\u4F1A\uFF08\u7CFB\u7EDF\u4F1A\u544A\u77E5\u5177\u4F53\u6570\u5B57\uFF09\u3002\u8BF7\u4E25\u683C\u6309\u4EE5\u4E0B\u8282\u594F\u5206\u914D\uFF1A\n\n| \u9636\u6BB5 | \u8F6E\u6B21\u5360\u6BD4 | \u76EE\u6807 |\n|------|---------|------|\n| 1. \u5168\u5C40\u626B\u63CF | \u7B2C 1-3 \u8F6E | get_project_overview + list_project_structure \u4E86\u89E3\u9879\u76EE\u7ED3\u6784 |\n| 2. \u7ED3\u6784\u5316\u63A2\u7D22 | \u7B2C 4-N\u00D760% \u8F6E | get_class_hierarchy / get_class_info \u7406\u89E3\u6838\u5FC3\u7C7B\uFF1Bsearch_project_code \u6279\u91CF\u641C\u7D22\u5173\u952E\u6A21\u5F0F |\n| 3. \u6DF1\u5EA6\u9A8C\u8BC1 | \u7B2C N\u00D760%-N\u00D780% \u8F6E | read_project_file \u9605\u8BFB\u5173\u952E\u5B9E\u73B0\uFF0C\u786E\u8BA4\u7EC6\u8282 |\n| 4. \u8F93\u51FA\u603B\u7ED3 | \u6700\u540E 20% | **\u505C\u6B62\u8C03\u7528\u5DE5\u5177**\uFF0C\u76F4\u63A5\u8F93\u51FA\u4F60\u7684\u5206\u6790\u6587\u672C |\n\n## \u5173\u952E\u89C4\u5219\n- **\u5230\u8FBE 80% \u8F6E\u6B21\u65F6\u5FC5\u987B\u5F00\u59CB\u5199\u603B\u7ED3**\uFF0C\u4E0D\u8981\u7B49\u7CFB\u7EDF\u63D0\u9192\n- \u6BCF\u4E00\u8F6E\u90FD\u5FC5\u987B\u8C03\u7528\u5DE5\u5177\u83B7\u53D6\u65B0\u4FE1\u606F\uFF0C\u4E0D\u8981\u82B1\u8F6E\u6B21\u5728\u7EAF\u6587\u672C\u601D\u8003\u4E0A\n- \u4E0D\u8981\u91CD\u590D\u641C\u7D22\u76F8\u540C\u5173\u952E\u8BCD\u6216\u8BFB\u53D6\u76F8\u540C\u6587\u4EF6\uFF08\u7CFB\u7EDF\u4F1A\u8FD4\u56DE\u7F13\u5B58\u5E76\u6263\u8F6E\u6B21\uFF09\n\n## \u5DE5\u5177\u6548\u7387\n- **\u6279\u91CF\u641C\u7D22**: search_project_code({ patterns: [\"keywordA\", \"keywordB\", \"keywordC\"] }) \u2014 \u4E00\u6B21\u641C 3-5 \u4E2A\n- **\u6279\u91CF\u8BFB\u6587\u4EF6**: read_project_file({ filePaths: [\"a.m\", \"b.m\", \"c.m\"] }) \u2014 \u4E00\u6B21\u8BFB 3-5 \u4E2A\n- **\u7ED3\u6784\u5316\u67E5\u8BE2\u4F18\u5148**: get_class_hierarchy / get_class_info \u6BD4\u6587\u672C\u641C\u7D22\u66F4\u7CBE\u786E\u9AD8\u6548\n\n## \u8F93\u51FA\u8981\u6C42\n\u8F93\u51FA\u4F60\u7684\u5206\u6790\u53D1\u73B0\uFF0C\u5305\u62EC\u5177\u4F53\u7684\u6587\u4EF6\u8DEF\u5F84\u548C\u4EE3\u7801\u4F4D\u7F6E\u3002\n\u7528\u81EA\u7136\u8BED\u8A00\u63CF\u8FF0\u4F60\u7684\u7406\u89E3\uFF0C\u4E0D\u9700\u8981\u7279\u5B9A\u683C\u5F0F\u3002";
+export declare const ANALYST_TOOLS: string[];
+export declare const ANALYST_BUDGET: {
+    maxIterations: number;
+    searchBudget: number;
+    searchBudgetGrace: number;
+    maxSubmits: number;
+    softSubmitLimit: number;
+    idleRoundsToExit: number;
+};
+/**
+ * 构建 Analyst Prompt
+ *
+ * 9 段结构:
+ *   §1 任务描述
+ *   §2 维度指引
+ *   §3 SOP (分析步骤 + 常见错误)
+ *   §4 输出要求
+ *   §5 工具提示
+ *   §6 前序维度上下文 (SessionStore / DimensionContext)
+ *   §7 Tier Reflection 洞察
+ *   §8 历史语义记忆 (Tier 3)
+ *   §9 代码实体图谱 (Phase E)
+ *
+ * @param {object} dimConfig 维度配置 { id, label, guide, focusKeywords, outputType }
+ * @param {object} projectInfo - { name, lang, fileCount }
+ * @param {object} [dimensionContext] - DimensionContext 实例 (跨维度上下文)
+ * @param {object} [episodicMemory] - SessionStore 实例 (v4.0 增强上下文)
+ * @param {object} [semanticMemory] - PersistentMemory 实例 (v4.1 历史记忆)
+ * @param {object} [codeEntityGraph] - CodeEntityGraph 实例 (Phase E 代码实体图谱)
+ * @returns {string}
+ */
+export declare function buildAnalystPrompt(dimConfig: AnalystDimConfig, projectInfo: AnalystProjectInfo, dimensionContext: DimensionContextLike | null | undefined, episodicMemory: EpisodicMemoryLike | null | undefined, semanticMemory: SemanticMemoryLike | null | undefined, codeEntityGraph: CodeEntityGraphLike | null | undefined): string;
+export {};
+//# sourceMappingURL=insight-analyst.d.ts.map

package/dist/lib/service/agent/domain/insight-analyst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-analyst.d.ts","sourceRoot":"","sources":["../../../../../lib/service/agent/domain/insight-analyst.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,qBAAqB;AACrB,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,qBAAqB;AACrB,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4BAA4B;AAC5B,UAAU,oBAAoB;IAC5B,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG;QACvC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;KACzD,CAAC;CACH;AAED,WAAW;AACX,UAAU,mBAAmB;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,yCAAyC;AACzC,UAAU,kBAAkB;IAC1B,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;IAChF,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACtD;AAED,4BAA4B;AAC5B,UAAU,kBAAkB;IAC1B,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,IAAI,CAAC;CACxF;AAED,2BAA2B;AAC3B,UAAU,mBAAmB;IAC3B,uBAAuB,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,IAAI,CAAC;CACzF;AAMD,eAAO,MAAM,qBAAqB,k6EAwBb,CAAC;AAMtB,eAAO,MAAM,aAAa,UAqBzB,CAAC;AAMF,eAAO,MAAM,cAAc;;;;;;;CAO1B,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EAAE,kBAAkB,EAC/B,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EACzD,cAAc,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EACrD,cAAc,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EACrD,eAAe,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,UAkIxD"}

package/dist/lib/service/agent/domain/insight-analyst.js

@@ -0,0 +1,224 @@
+/**
+ * insight-analyst.js — Insight Analyst 领域函数
+ *
+ * 从旧 AnalystAgent.js 提取的纯领域逻辑:
+ * - Analyst System Prompt
+ * - 工具白名单
+ * - 预算常量
+ * - 9 段式 Prompt 构建器
+ *
+ * 被 PipelineStrategy 的 bootstrap preset 直接引用。
+ * 不再包含任何 Agent 类 — Agent 由 AgentRuntime + PipelineStrategy 驱动。
+ *
+ * @module insight-analyst
+ */
+import { getDimensionSOP } from '#external/mcp/handlers/bootstrap/shared/dimension-sop.js';
+// ──────────────────────────────────────────────────────────────────
+// System Prompt — Analyst 专用 (~100 tokens)
+// ──────────────────────────────────────────────────────────────────
+export const ANALYST_SYSTEM_PROMPT = `你是一位高级软件架构师，正在深度分析一个真实项目的某个维度。
+
+## 执行计划
+你有 **N 轮**工具调用机会（系统会告知具体数字）。请严格按以下节奏分配：
+
+| 阶段 | 轮次占比 | 目标 |
+|------|---------|------|
+| 1. 全局扫描 | 第 1-3 轮 | get_project_overview + list_project_structure 了解项目结构 |
+| 2. 结构化探索 | 第 4-N×60% 轮 | get_class_hierarchy / get_class_info 理解核心类；search_project_code 批量搜索关键模式 |
+| 3. 深度验证 | 第 N×60%-N×80% 轮 | read_project_file 阅读关键实现，确认细节 |
+| 4. 输出总结 | 最后 20% | **停止调用工具**，直接输出你的分析文本 |
+
+## 关键规则
+- **到达 80% 轮次时必须开始写总结**，不要等系统提醒
+- 每一轮都必须调用工具获取新信息，不要花轮次在纯文本思考上
+- 不要重复搜索相同关键词或读取相同文件（系统会返回缓存并扣轮次）
+
+## 工具效率
+- **批量搜索**: search_project_code({ patterns: ["keywordA", "keywordB", "keywordC"] }) — 一次搜 3-5 个
+- **批量读文件**: read_project_file({ filePaths: ["a.m", "b.m", "c.m"] }) — 一次读 3-5 个
+- **结构化查询优先**: get_class_hierarchy / get_class_info 比文本搜索更精确高效
+
+## 输出要求
+输出你的分析发现，包括具体的文件路径和代码位置。
+用自然语言描述你的理解，不需要特定格式。`;
+// ──────────────────────────────────────────────────────────────────
+// Analyst 可用工具白名单 — 只做探索，不做提交
+// ──────────────────────────────────────────────────────────────────
+export const ANALYST_TOOLS = [
+    // AST 结构化分析
+    'get_project_overview',
+    'get_class_hierarchy',
+    'get_class_info',
+    'get_protocol_info',
+    'get_method_overrides',
+    'get_category_map',
+    // 文件访问
+    'search_project_code',
+    'read_project_file',
+    'list_project_structure',
+    'get_file_summary',
+    'semantic_search_code',
+    // 前序上下文 (可选)
+    'get_previous_analysis',
+    // Agent Memory (v4.0) — 工作记忆 + 情景记忆
+    'note_finding',
+    'get_previous_evidence',
+    // Phase E: 代码实体图谱查询
+    'query_code_graph',
+];
+// ──────────────────────────────────────────────────────────────────
+// Analyst 预算 — 使用 analyst 策略（自由探索，无阶段约束）
+// ──────────────────────────────────────────────────────────────────
+export const ANALYST_BUDGET = {
+    maxIterations: 24,
+    searchBudget: 18,
+    searchBudgetGrace: 10,
+    maxSubmits: 0,
+    softSubmitLimit: 0,
+    idleRoundsToExit: 2,
+};
+// ──────────────────────────────────────────────────────────────────
+// 维度 Prompt 模板 (9 段式)
+// ──────────────────────────────────────────────────────────────────
+/**
+ * 构建 Analyst Prompt
+ *
+ * 9 段结构:
+ *   §1 任务描述
+ *   §2 维度指引
+ *   §3 SOP (分析步骤 + 常见错误)
+ *   §4 输出要求
+ *   §5 工具提示
+ *   §6 前序维度上下文 (SessionStore / DimensionContext)
+ *   §7 Tier Reflection 洞察
+ *   §8 历史语义记忆 (Tier 3)
+ *   §9 代码实体图谱 (Phase E)
+ *
+ * @param {object} dimConfig 维度配置 { id, label, guide, focusKeywords, outputType }
+ * @param {object} projectInfo - { name, lang, fileCount }
+ * @param {object} [dimensionContext] - DimensionContext 实例 (跨维度上下文)
+ * @param {object} [episodicMemory] - SessionStore 实例 (v4.0 增强上下文)
+ * @param {object} [semanticMemory] - PersistentMemory 实例 (v4.1 历史记忆)
+ * @param {object} [codeEntityGraph] - CodeEntityGraph 实例 (Phase E 代码实体图谱)
+ * @returns {string}
+ */
+export function buildAnalystPrompt(dimConfig, projectInfo, dimensionContext, episodicMemory, semanticMemory, codeEntityGraph) {
+    const parts = [];
+    // §1 任务描述
+    parts.push(`分析项目 ${projectInfo.name} (${projectInfo.lang}, ${projectInfo.fileCount} 个文件) 的 ${dimConfig.label}。`);
+    // §2 维度指引
+    if (dimConfig.guide) {
+        parts.push(dimConfig.guide);
+    }
+    // §3 结构化 SOP (优先) — 替代 focusAreas
+    const sop = getDimensionSOP(dimConfig.id);
+    if (sop) {
+        parts.push('## 分析步骤 (SOP)');
+        for (const step of sop.steps) {
+            parts.push(`### ${step.phase}`);
+            parts.push(step.action);
+            if (step.expectedOutput) {
+                parts.push(`→ 预期产出: ${step.expectedOutput}`);
+            }
+        }
+        // §3.1 常见错误 (关键质量防护)
+        if (sop.commonMistakes && sop.commonMistakes.length > 0) {
+            parts.push('## ⚠️ 常见错误（务必避免）');
+            for (const m of sop.commonMistakes) {
+                parts.push(`- ${m}`);
+            }
+        }
+    }
+    else if (dimConfig.guide) {
+        const items = dimConfig.guide
+            .split(/[、，,/]/)
+            .map((s) => s.trim())
+            .filter(Boolean);
+        if (items.length > 1) {
+            parts.push(`重点关注:\n${items.map((f) => `- ${f}`).join('\n')}`);
+        }
+        else {
+            parts.push(`重点关注: ${dimConfig.guide}`);
+        }
+    }
+    // §4 输出要求
+    const outputType = dimConfig.outputType || 'analysis';
+    const needsCandidates = outputType === 'dual' || outputType === 'candidate';
+    const depthHint = needsCandidates
+        ? '你的分析将被转化为知识候选，请确保每个发现都有足够的代码证据和文件引用。目标: 发现 3-5 个独立的知识点。'
+        : '';
+    parts.push(`请将分析组织成结构化段落，包含:
+1. 在哪些文件/类中发现 (写出具体文件路径)
+2. 具体的实现方式和代码特征
+3. 为什么选择这种方式（设计意图）
+4. 统计数据 (如数量、占比)
+
+每个关键发现用编号列表呈现，引用 3 个以上具体文件。
+${depthHint}
+重要: 务必使用 read_project_file 阅读代码确认，不要假设文件存在。引用的每个文件路径都必须是你亲眼看到的。`);
+    // §5 前序上下文提示
+    parts.push('可以调用 get_previous_analysis 获取前序维度的分析结果，避免重复分析。');
+    parts.push('使用 note_finding 工具记录关键发现到工作记忆，确保重要信息不会在后期被遗忘。');
+    parts.push('使用 get_previous_evidence 工具查询前序维度对特定文件/类的分析证据，避免重复搜索。');
+    // §6 前序维度分析摘要 (Tier 2+ 才有)
+    if (episodicMemory) {
+        const emContext = episodicMemory.buildContextForDimension(dimConfig.id, dimConfig.focusKeywords || []);
+        if (emContext) {
+            parts.push(emContext);
+        }
+        // §7: Tier Reflection 洞察
+        const reflections = episodicMemory.getRelevantReflections(dimConfig.id);
+        if (reflections) {
+            parts.push('## 跨维度综合洞察');
+            parts.push(reflections);
+        }
+    }
+    else if (dimensionContext) {
+        const snapshot = dimensionContext.buildContextForDimension(dimConfig.id);
+        const prevDims = Object.entries(snapshot.previousDimensions);
+        if (prevDims.length > 0) {
+            parts.push(`## 前序维度分析摘要（避免重复探索）`);
+            for (const [dimId, digest] of prevDims) {
+                parts.push(`### ${dimId}\n${digest.summary || '(无摘要)'}`);
+                if (digest.keyFindings?.length > 0) {
+                    parts.push(`关键发现: ${digest.keyFindings.join('; ')}`);
+                }
+                if (digest.crossRefs?.[dimConfig.id]) {
+                    parts.push(`💡 对本维度的建议: ${digest.crossRefs[dimConfig.id]}`);
+                }
+            }
+        }
+    }
+    // §8: 历史语义记忆 (Tier 3)
+    if (semanticMemory) {
+        try {
+            const query = `${dimConfig.label} ${dimConfig.guide || ''} ${projectInfo.lang}`;
+            const section = semanticMemory.toPromptSection({
+                source: 'bootstrap',
+                query,
+                limit: 10,
+            });
+            if (section) {
+                parts.push(section);
+            }
+        }
+        catch {
+            /* SemanticMemory retrieval failed, non-critical */
+        }
+    }
+    // §9: 代码实体图谱 (Phase E)
+    if (codeEntityGraph) {
+        try {
+            const graphCtx = codeEntityGraph.generateContextForAgent({ maxEntities: 20, maxEdges: 40 });
+            if (graphCtx) {
+                parts.push(graphCtx);
+                parts.push('使用 query_code_graph 工具可以查询更详细的继承链、影响分析等。');
+            }
+        }
+        catch {
+            /* CodeEntityGraph context failed, non-critical */
+        }
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=insight-analyst.js.map

package/dist/lib/service/agent/domain/insight-analyst.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-analyst.js","sourceRoot":"","sources":["../../../../../lib/service/agent/domain/insight-analyst.ts"],"names":[],"mappings":"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"}

package/dist/lib/service/agent/domain/insight-gate.d.ts

@@ -0,0 +1,223 @@
+/**
+ * insight-gate.js — Insight 质量门控领域函数
+ *
+ * 从旧 HandoffProtocol.js 完整迁移的纯函数模块:
+ * - 分析文本清洗 (sanitizeAnalysisText)
+ * - AnalysisReport 构建 (v1)
+ * - AnalysisArtifact 构建 (v2, 含 evidenceMap/findings/negativeSignals)
+ * - 多维度质量评分 (buildQualityScores)
+ * - 质量门控 (v1 + v2)
+ * - 重试 Prompt 构建
+ * - PipelineStrategy gate.evaluator 适配器 (insightGateEvaluator)
+ *
+ * 被 PipelineStrategy 的 bootstrap preset 直接引用。
+ *
+ * @module insight-gate
+ */
+import { type ToolCall } from './EvidenceCollector.js';
+/** Analyst 执行结果 */
+interface AnalystResult {
+    reply?: string;
+    toolCalls?: ToolCall[];
+    tokenUsage?: unknown;
+    reasoningQuality?: unknown;
+}
+/** ProjectGraph 最小接口 */
+interface ProjectGraphLike {
+    getClassInfo(className: string): {
+        filePath?: string;
+    } | null | undefined;
+    getProtocolInfo(protocolName: string): {
+        filePath?: string;
+    } | null | undefined;
+}
+/** ActiveContext 最小接口 */
+interface ActiveContextLike {
+    distill(): {
+        keyFindings: RawFinding[];
+        toolCallSummary: unknown[];
+    };
+}
+/** 原始发现 (来自 ActiveContext.distill()) */
+interface RawFinding {
+    finding: string;
+    evidence: string | string[] | unknown;
+    importance: number;
+}
+/** 多维度质量评分 */
+interface QualityScores {
+    depthScore: number;
+    breadthScore: number;
+    evidenceScore: number;
+    coherenceScore: number;
+}
+/** 质量报告 */
+interface QualityReport {
+    scores: QualityScores;
+    totalScore: number;
+    suggestions: string[];
+}
+/** 门控选项 */
+interface GateOptions {
+    outputType?: string;
+}
+/** 门控结果 */
+interface GateResult {
+    pass: boolean;
+    reason?: string;
+    action?: 'retry' | 'degrade';
+}
+/** 可进行门控评估的分析报告 */
+interface GateableReport {
+    analysisText: string;
+    referencedFiles: string[];
+    qualityReport?: QualityReport;
+}
+/**
+ * 清理 Analyst 分析文本中可能泄漏的系统 nudge / graceful exit 指令。
+ * 这些内容如果传给 Producer，会干扰其正常工作流。
+ */
+export declare function sanitizeAnalysisText(text: string): string;
+/**
+ * 从 Analyst 的执行结果构建 AnalysisReport (v1)
+ *
+ * @param {object} analystResult - { reply, toolCalls }
+ * @param {string} dimensionId 维度 ID
+ * @param {object} [projectGraph] - ProjectGraph 实例
+ * @returns {AnalysisReport}
+ */
+export declare function buildAnalysisReport(analystResult: AnalystResult, dimensionId: string, projectGraph?: ProjectGraphLike | null): {
+    analysisText: string;
+    referencedFiles: string[];
+    searchQueries: string[];
+    classesExplored: string[];
+    dimensionId: string;
+    metadata: {
+        iterations: number;
+        toolCallCount: number;
+        tokenUsage: {} | null;
+        reasoningQuality: {} | null;
+    };
+};
+/**
+ * 从 Analyst 执行结果构建 AnalysisArtifact (v2 增强版)
+ *
+ * 在 v1 AnalysisReport 基础上增加:
+ * - evidenceMap: 文件 → 代码片段 + 摘要
+ * - explorationLog: 工具调用意图 + 结果摘要序列
+ * - negativeSignals: 搜索但未找到的模式
+ * - findings: 来自 ActiveContext 的结构化发现
+ * - qualityReport: 多维度质量评分
+ *
+ * @param {object} analystResult - { reply, toolCalls }
+ * @param {string} dimensionId 维度 ID
+ * @param {object} [projectGraph] - ProjectGraph 实例
+ * @param {object} [activeContext] - ActiveContext 实例
+ * @returns {AnalysisArtifact}
+ */
+export declare function buildAnalysisArtifact(analystResult: AnalystResult, dimensionId: string, projectGraph?: ProjectGraphLike | null, activeContext?: ActiveContextLike | null): {
+    analysisText: string;
+    findings: {
+        finding: string;
+        evidence: string;
+        importance: number;
+    }[];
+    referencedFiles: string[];
+    dimensionId: string;
+    evidenceMap: Map<string, import("./EvidenceCollector.js").EvidenceEntry>;
+    explorationLog: import("./EvidenceCollector.js").ExplorationEntry[];
+    negativeSignals: import("./EvidenceCollector.js").NegativeSignal[];
+    fullToolTrace: ToolCall[];
+    qualityReport: {
+        scores: QualityScores;
+        totalScore: number;
+        suggestions: string[];
+    };
+    metadata: {
+        artifactVersion: number;
+        iterations: number;
+        toolCallCount: number;
+        tokenUsage: {} | null;
+        reasoningQuality: {} | null;
+    };
+    searchQueries: string[];
+    classesExplored: string[];
+};
+/**
+ * 分析质量门控
+ *
+ * 自动检测 v1 (AnalysisReport) 和 v2 (AnalysisArtifact):
+ * - v2: 从 qualityReport.totalScore 计算
+ * - v1: 使用 4 条规则
+ *
+ * @param {AnalysisReport|AnalysisArtifact} report
+ * @param {object} [options]
+ * @param {string} [options.outputType] - 'analysis' | 'dual' | 'candidate'
+ * @returns {{ pass: boolean, reason?: string, action?: 'retry' | 'degrade' }}
+ */
+export declare function analysisQualityGate(report: GateableReport, options?: GateOptions): GateResult;
+/**
+ * 构建重试提示
+ *
+ * @param {string} reason - Gate 失败原因
+ * @returns {string}
+ */
+export declare function buildRetryPrompt(reason: string): string;
+/**
+ * 面向 PipelineStrategy gate.evaluator 的包装函数。
+ *
+ * 将 PipelineStrategy 的 (source, phaseResults, strategyContext) 签名
+ * 适配到 buildAnalysisArtifact + analysisQualityGate 调用链。
+ *
+ * @param {object} source 前一阶段 (analyze) 的 reactLoop 返回值
+ * @param {object} phaseResults 所有阶段结果
+ * @param {object} strategyContext - orchestrator 注入的运行时上下文
+ * @returns {{ action: 'pass'|'retry'|'degrade', reason: string, artifact: object }}
+ */
+export declare function insightGateEvaluator(source: unknown, phaseResults: Record<string, unknown>, strategyContext?: Record<string, unknown>): {
+    action: string;
+    reason: string;
+    artifact: null;
+} | {
+    action: string;
+    reason: string;
+    artifact: {
+        analysisText: string;
+        referencedFiles: string[];
+        searchQueries: string[];
+        classesExplored: string[];
+        dimensionId: string;
+        metadata: {
+            iterations: number;
+            toolCallCount: number;
+            tokenUsage: {} | null;
+            reasoningQuality: {} | null;
+        };
+    };
+};
+export {};
+/**
+ * @typedef {object} AnalysisReport
+ * @property {string} analysisText
+ * @property {string[]} referencedFiles
+ * @property {string[]} searchQueries
+ * @property {string[]} classesExplored
+ * @property {string} dimensionId
+ * @property {object} metadata - { iterations, toolCallCount }
+ */
+/**
+ * @typedef {object} AnalysisArtifact
+ * @property {string} analysisText
+ * @property {Array<{claim: string, evidence: string[], importance: number, source: string}>} findings
+ * @property {string[]} referencedFiles
+ * @property {string} dimensionId
+ * @property {Map<string, import('./EvidenceCollector.js').EvidenceEntry>} evidenceMap
+ * @property {import('./EvidenceCollector.js').ExplorationEntry[]} explorationLog
+ * @property {import('./EvidenceCollector.js').NegativeSignal[]} negativeSignals
+ * @property {Array} [fullToolTrace]
+ * @property {{ scores: object, totalScore: number, suggestions: string[] }} qualityReport
+ * @property {object} metadata
+ * @property {string[]} searchQueries
+ * @property {string[]} classesExplored
+ */
+//# sourceMappingURL=insight-gate.d.ts.map

package/dist/lib/service/agent/domain/insight-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-gate.d.ts","sourceRoot":"","sources":["../../../../../lib/service/agent/domain/insight-gate.ts"],"names":[],"mappings":"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"}