autosnippet 3.3.4 → 3.3.6

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

@@ -12,7 +12,7 @@
  *
  * @module insight-analyst
  */
-import { getDimensionSOP } from '#external/mcp/handlers/bootstrap/shared/dimension-sop.js';
+import { getDimensionSOP } from '#domain/dimension/DimensionSop.js';
 // ──────────────────────────────────────────────────────────────────
 // System Prompt — Analyst 专用 (~100 tokens)
 // ──────────────────────────────────────────────────────────────────
@@ -39,7 +39,10 @@ export const ANALYST_SYSTEM_PROMPT = `你是一位高级软件架构师，正在
 - **结构化查询优先**: get_class_hierarchy / get_class_info 比文本搜索更精确高效
 
 ## 输出要求
-输出你的分析发现，包括具体的文件路径和代码位置。
+输出你的分析发现，包括具体的文件完整相对路径（从项目根目录开始）和行号。
+每个文件引用格式: (来源: Full/Relative/Path/FileName.ext:行号)
+禁止只写文件名，必须写从项目根开始的完整路径。
+标注每个发现所属的模块/包名。
 用自然语言描述你的理解，不需要特定格式。`;
 // ──────────────────────────────────────────────────────────────────
 // Analyst 可用工具白名单 — 只做探索，不做提交
@@ -77,13 +80,10 @@ export const ANALYST_BUDGET = {
     softSubmitLimit: 0,
     idleRoundsToExit: 2,
 };
-// ──────────────────────────────────────────────────────────────────
-// 维度 Prompt 模板 (9 段式)
-// ──────────────────────────────────────────────────────────────────
 /**
  * 构建 Analyst Prompt
  *
- * 9 段结构:
+ * 12 段结构:
  *   §1 任务描述
  *   §2 维度指引
  *   §3 SOP (分析步骤 + 常见错误)
@@ -93,6 +93,9 @@ export const ANALYST_BUDGET = {
  *   §7 Tier Reflection 洞察
  *   §8 历史语义记忆 (Tier 3)
  *   §9 代码实体图谱 (Phase E)
+ *   §ES 分析起点证据 (Phase 1-4 Evidence Starters)
+ *   §M1 全景上下文 (Panorama Phase 1.8)
+ *   §10 Rescan 已有知识上下文
  *
  * @param dimConfig 维度配置 { id, label, guide, focusKeywords, outputType }
  * @param projectInfo { name, lang, fileCount }
@@ -100,8 +103,12 @@ export const ANALYST_BUDGET = {
  * @param [episodicMemory] SessionStore 实例 (v4.0 增强上下文)
  * @param [semanticMemory] PersistentMemory 实例 (v4.1 历史记忆)
  * @param [codeEntityGraph] CodeEntityGraph 实例 (Phase E 代码实体图谱)
+ * @param [rescanContext] Rescan 已有知识上下文 (增量扫描时注入)
+ * @param [panorama] 全景上下文 — 模块角色/层级/耦合/空白区 (Phase 1.8)
+ * @param [evidenceStarters] Phase 1-4 证据启发 — 维度级分析起点
+ * @param [evolutionResult] Evolution Stage 产出 — 避免重复分析已处理的 Recipe
  */
-export async function buildAnalystPrompt(dimConfig, projectInfo, dimensionContext, episodicMemory, semanticMemory, codeEntityGraph) {
+export async function buildAnalystPrompt(dimConfig, projectInfo, dimensionContext, episodicMemory, semanticMemory, codeEntityGraph, rescanContext, panorama, evidenceStarters, evolutionResult) {
     const parts = [];
     // §1 任务描述
     parts.push(`分析项目 ${projectInfo.name} (${projectInfo.lang}, ${projectInfo.fileCount} 个文件) 的 ${dimConfig.label}。`);
@@ -144,17 +151,21 @@ export async function buildAnalystPrompt(dimConfig, projectInfo, dimensionContex
     const outputType = dimConfig.outputType || 'analysis';
     const needsCandidates = outputType === 'dual' || outputType === 'candidate';
     const depthHint = needsCandidates
-        ? '你的分析将被转化为知识候选，请确保每个发现都有足够的代码证据和文件引用。目标: 发现 3-5 个独立的知识点。'
+        ? '你的分析将被转化为知识候选，请确保每个发现都有足够的代码证据和文件引用。按实际发现总结，有几个独立知识点就写几个。'
         : '';
     parts.push(`请将分析组织成结构化段落，包含:
-1. 在哪些文件/类中发现 (写出具体文件路径)
+1. 在哪些文件/类中发现 (写出从项目根目录开始的完整相对路径+行号，如 Packages/ModuleName/Sources/.../FileName.swift:42)
 2. 具体的实现方式和代码特征
 3. 为什么选择这种方式（设计意图）
 4. 统计数据 (如数量、占比)
+5. 所属模块/包名（特别是来自本地子包的发现）
 
-每个关键发现用编号列表呈现，引用 3 个以上具体文件。
+每个关键发现用编号列表呈现，引用 3 个以上具体文件（完整相对路径）。
+禁止只写文件名（如 NetworkClient.swift），必须写完整路径（如 Packages/AOXNetworkKit/Sources/AOXNetworkKit/Client/NetworkClient.swift:42）。
 ${depthHint}
-重要: 务必使用 read_project_file 阅读代码确认，不要假设文件存在。引用的每个文件路径都必须是你亲眼看到的。`);
+重要: 务必使用 read_project_file 阅读代码确认，不要假设文件存在。引用的每个文件路径都必须是你亲眼看到的。
+【跨维度去重】只分析属于当前维度视角的内容。不要将其他维度的知识点混入本维度来充数。例如: 分析 code-standard 时只关注命名/注释/文件组织，不要混入设计模式(code-pattern)或分层架构(architecture)的内容。如果某个发现与多个维度相关，则只从当前维度的核心视角分析，避免与其他维度产生重叠。
+【本地子包覆盖】如果项目有本地子包/模块（如 Packages/ 目录下的包），必须同时分析其内部实现，不得仅看主项目对其的调用。`);
     // §5 前序上下文提示
     parts.push('可以调用 get_previous_analysis 获取前序维度的分析结果，避免重复分析。');
     parts.push('使用 note_finding 工具记录关键发现到工作记忆，确保重要信息不会在后期被遗忘。');
@@ -218,5 +229,94 @@ ${depthHint}
             /* CodeEntityGraph context failed, non-critical */
         }
     }
+    // §ES: 分析起点证据 (Phase 1-4 Evidence Starters)
+    if (evidenceStarters && Object.keys(evidenceStarters).length > 0) {
+        const esLines = ['## 📊 分析起点 (Phase 1-4 自动检测)'];
+        esLines.push('以下是自动化分析阶段检测到的与本维度相关的信号，可作为分析起点:');
+        // 按 strength 降序排列，取前 6 个最强信号
+        const sorted = Object.entries(evidenceStarters)
+            .sort(([, a], [, b]) => (b.strength ?? 50) - (a.strength ?? 50))
+            .slice(0, 6);
+        for (const [key, entry] of sorted) {
+            const strengthBadge = (entry.strength ?? 50) >= 75 ? '⚠️' : '📝';
+            esLines.push(`${strengthBadge} **${key}**: ${entry.hint}`);
+            if (entry.data) {
+                const dataStr = Array.isArray(entry.data)
+                    ? entry.data
+                        .slice(0, 5)
+                        .map((d) => `  - ${typeof d === 'string' ? d : JSON.stringify(d)}`)
+                        .join('\n')
+                    : typeof entry.data === 'string'
+                        ? `  ${entry.data}`
+                        : `  ${JSON.stringify(entry.data, null, 0).slice(0, 300)}`;
+                esLines.push(dataStr);
+            }
+        }
+        esLines.push('');
+        esLines.push('利用上述信号作为分析切入点，用 read_project_file 验证并深入探索。');
+        parts.push(esLines.join('\n'));
+    }
+    // §M1: 全景上下文 (Panorama Phase 1.8) — 模块角色/层级/耦合/空白区
+    if (panorama) {
+        const pLines = ['## 🏗️ 项目全景 (Panorama)'];
+        if (panorama.layerContext) {
+            pLines.push(`架构层级: ${panorama.layerContext}`);
+        }
+        if (panorama.moduleRole) {
+            pLines.push(`当前模块角色: ${panorama.moduleRole}${panorama.moduleLayer !== null ? ` (L${panorama.moduleLayer})` : ''}`);
+        }
+        if (panorama.moduleCoupling) {
+            pLines.push(`耦合度: fanIn=${panorama.moduleCoupling.fanIn}, fanOut=${panorama.moduleCoupling.fanOut}`);
+        }
+        if (panorama.knownGaps.length > 0) {
+            pLines.push(`已知空白区: ${panorama.knownGaps.join(', ')}`);
+            pLines.push('分析时请特别关注上述空白区，它们是最可能产出新知识的方向。');
+        }
+        parts.push(pLines.join('\n'));
+    }
+    // §EVO: Evolution 结果 — 避免重复覆盖已被 Evolution Agent 处理的模式
+    if (evolutionResult && evolutionResult.totalRecipes && evolutionResult.totalRecipes > 0) {
+        const evoLines = [
+            '## 🔄 Evolution 结果',
+            `Evolution Agent 已审查本维度 ${evolutionResult.totalRecipes} 个现有 Recipe:`,
+            `- 进化: ${evolutionResult.evolved ?? 0} 个（已提交新版本替代旧 Recipe）`,
+            `- 废弃: ${evolutionResult.deprecated ?? 0} 个（已确认过时）`,
+            `- 跳过: ${evolutionResult.skipped ?? 0} 个（仍然有效或信息不足）`,
+            '',
+            '**你的分析应关注发现新知识点**，不要重复覆盖已处理的模式。',
+        ];
+        parts.push(evoLines.join('\n'));
+    }
+    // §10a: Rescan 有效知识上下文 — 避免重复分析已覆盖的模式
+    if (rescanContext && rescanContext.existingRecipes.length > 0) {
+        const lines = [
+            '## ⚠️ 增量扫描模式 — 已有知识 (勿重复)',
+            `本维度已有 ${rescanContext.existing} 个有效 Recipe，需补齐 ${rescanContext.gap} 个。`,
+            '已有 Recipe 标题:',
+        ];
+        for (const r of rescanContext.existingRecipes.slice(0, 10)) {
+            const triggerTag = r.trigger ? ` (trigger: ${r.trigger})` : '';
+            lines.push(`- "${r.title}"${triggerTag}`);
+        }
+        if (rescanContext.existingRecipes.length > 10) {
+            lines.push(`- ... 共 ${rescanContext.existingRecipes.length} 个`);
+        }
+        lines.push('');
+        lines.push('**你的任务**: 专注发现上述 Recipe **尚未覆盖**的新模式。不要重复分析相同的代码特征。');
+        parts.push(lines.join('\n'));
+    }
+    // §10b: Rescan 衰退知识 — 可以替换
+    if (rescanContext?.decayingRecipes && rescanContext.decayingRecipes.length > 0) {
+        const dLines = [
+            '## 🔄 衰退中的知识 (可替换)',
+            '以下 Recipe 正在衰退，其描述的模式可能已过时或迁移：',
+        ];
+        for (const r of rescanContext.decayingRecipes.slice(0, 5)) {
+            dLines.push(`- "${r.title}" — 衰退原因: ${r.decayReason || '未知'}`);
+        }
+        dLines.push('如果你在分析中发现了这些模式的**更新版本**（例如类改名、迁移到新模块），');
+        dLines.push('请记录下来，后续 Producer 可以用 supersedes 参数提交替代版本。');
+        parts.push(dLines.join('\n'));
+    }
     return parts.join('\n\n');
 }

package/dist/lib/agent/domain/insight-evolver.d.ts

@@ -0,0 +1,69 @@
+/**
+ * insight-evolver.ts — Evolution Agent 领域函数
+ *
+ * Evolution Agent 是管线中的专职进化角色：
+ *   - 接收当前维度的**全部**现有 Recipe（不仅是衰退的）
+ *   - 使用工具读取真实代码，验证每个 Recipe 的真实性
+ *   - 通过**附加提案**（Proposal）驱动状态变更，不创建新 Recipe
+ *   - 三种决策: propose_evolution / confirm_deprecation / skip_evolution
+ *
+ * 被 PipelineStrategy 的 evolution preset 引用。
+ * 按维度隔离：每个维度的 Evolve Stage 只处理属于该维度的 Recipe。
+ *
+ * @module insight-evolver
+ */
+/** 静态审计 hint（可选）— 来自 RecipeRelevanceAuditor */
+export interface AuditHint {
+    relevanceScore: number;
+    verdict: string;
+    evidence: {
+        triggerStillMatches: boolean;
+        symbolsAlive: number;
+        depsIntact: boolean;
+        codeFilesExist: number;
+    };
+    decayReasons: string[];
+}
+/** 现有 Recipe（含可选的 audit hint） */
+export interface ExistingRecipeForEvolution {
+    id: string;
+    title: string;
+    trigger: string;
+    content?: {
+        markdown?: string;
+        rationale?: string;
+        coreCode?: string;
+    };
+    sourceRefs?: string[];
+    /** 静态审计 hint — 仅供参考，Agent 应通过读代码自行验证 */
+    auditHint?: AuditHint | null;
+}
+/** Evolution Agent 上下文 */
+export interface EvolutionContext {
+    /** 当前维度的全部现有 Recipe（healthy + decaying），按维度过滤后注入 */
+    existingRecipes: ExistingRecipeForEvolution[];
+    dimensionId: string;
+    dimensionLabel: string;
+    projectOverview: {
+        primaryLang: string;
+        fileCount: number;
+        modules: string[];
+    };
+}
+export declare const EVOLVER_SYSTEM_PROMPT = "\u4F60\u662F AutoSnippet \u7684 **Evolution Agent**\uFF0C\u4E13\u804C\u9A8C\u8BC1\u9879\u76EE\u4E2D\u73B0\u6709\u77E5\u8BC6\u6761\u76EE\uFF08Recipe\uFF09\u7684\u771F\u5B9E\u6027\u4E0E\u65F6\u6548\u6027\u3002\n\n## \u6838\u5FC3\u804C\u8D23\n\n\u4F60\u901A\u8FC7\u9605\u8BFB\u9879\u76EE\u771F\u5B9E\u4EE3\u7801\u6765\u9A8C\u8BC1\u6BCF\u6761 Recipe \u662F\u5426\u4ECD\u7136\u53CD\u6620\u5F53\u524D\u9879\u76EE\u5B9E\u8DF5\u3002\n\u4F60\u7684\u5DE5\u4F5C\u7ED3\u679C\u4EE5**\u63D0\u6848\uFF08Proposal\uFF09**\u65B9\u5F0F\u9644\u52A0\u5230\u73B0\u6709 Recipe \u4E0A\uFF0C\u63A8\u52A8\u77E5\u8BC6\u5E93\u7684\u6E10\u8FDB\u5F0F\u6F14\u5316\u3002\n\u4F60**\u4E0D\u521B\u5EFA\u65B0 Recipe**\u2014\u2014\u90A3\u662F\u540E\u7EED Produce \u9636\u6BB5\u7684\u804C\u8D23\u3002\n\n## \u9A8C\u8BC1\u6D41\u7A0B\n\n\u5BF9\u6BCF\u4E2A Recipe \u6309\u4EE5\u4E0B\u6B65\u9AA4\u9A8C\u8BC1:\n1. \u9605\u8BFB Recipe \u7684\u6838\u5FC3\u4EE3\u7801\u7247\u6BB5\u548C\u6E90\u6587\u4EF6\u5F15\u7528\uFF0C\u7406\u89E3\u5176\u63CF\u8FF0\u7684\u6A21\u5F0F\n2. \u4F7F\u7528 `read_project_file` \u8BFB\u53D6\u6E90\u6587\u4EF6\uFF0C\u9A8C\u8BC1\u4EE3\u7801\u662F\u5426\u5B58\u5728\u4E14\u4E0E Recipe \u63CF\u8FF0\u5339\u914D\n3. \u5982\u679C\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728\u6216\u4EE3\u7801\u4E0D\u5339\u914D\uFF0C\u4F7F\u7528 `search_project_code` \u641C\u7D22\u8BE5\u6A21\u5F0F\u662F\u5426\u5DF2\u8FC1\u79FB\u5230\u5176\u4ED6\u4F4D\u7F6E\n4. \u57FA\u4E8E\u771F\u5B9E\u4EE3\u7801\u7684\u9A8C\u8BC1\u7ED3\u679C\u505A\u51FA\u51B3\u7B56\n\n## \u51B3\u7B56\u89C4\u5219\n\n\u6309\u4EE5\u4E0B\u51B3\u7B56\u6811\u5224\u65AD\uFF08\u4F18\u5148\u7EA7\u4ECE\u4E0A\u5230\u4E0B\uFF09:\n\n| \u9A8C\u8BC1\u7ED3\u679C | \u51B3\u7B56 | \u5DE5\u5177 |\n|---------|------|------|\n| \u6E90\u6587\u4EF6\u5B58\u5728 + \u4EE3\u7801\u5339\u914D Recipe \u63CF\u8FF0 | **\u8DF3\u8FC7**: \u4ECD\u7136\u6709\u6548 | `skip_evolution` |\n| \u6E90\u6587\u4EF6\u5B58\u5728 + \u4EE3\u7801\u5DF2\u53D8\u5316\uFF08\u63A5\u53E3\u6539\u53D8/\u91CD\u6784\uFF09 | **\u8FDB\u5316\u63D0\u6848**: \u9644\u52A0\u53D8\u66F4\u8BC1\u636E | `propose_evolution` |\n| \u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 + \u6A21\u5F0F\u5DF2\u8FC1\u79FB\u5230\u65B0\u4F4D\u7F6E | **\u8FDB\u5316\u63D0\u6848**: \u9644\u52A0\u8FC1\u79FB\u8BC1\u636E | `propose_evolution` |\n| \u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 + \u5B8C\u5168\u65E0\u66FF\u4EE3 | **\u786E\u8BA4\u5E9F\u5F03**: \u77E5\u8BC6\u5DF2\u5931\u6548 | `confirm_deprecation` |\n| \u4FE1\u606F\u4E0D\u8DB3\u4EE5\u505A\u51FA\u5224\u65AD | **\u8DF3\u8FC7**: \u4EA4\u7ED9\u65F6\u9650\u673A\u5236 | `skip_evolution` |\n\n## \u5DE5\u5177\u8BF4\u660E\n\n- `propose_evolution` \u2014 \u4E3A Recipe \u9644\u52A0\u8FDB\u5316\u63D0\u6848\uFF0C\u5305\u542B\u4EE3\u7801\u9A8C\u8BC1\u8BC1\u636E\u548C\u5EFA\u8BAE\u53D8\u66F4\u3002\u63D0\u6848\u8FDB\u5165\u89C2\u5BDF\u7A97\u53E3\uFF08enhance: 48h, correction: 24h\uFF09\uFF0C\u4E0D\u76F4\u63A5\u4FEE\u6539 Recipe\n- `confirm_deprecation` \u2014 \u786E\u8BA4 Recipe \u5DF2\u8FC7\u65F6\uFF0C\u7ACB\u5373\u6807\u8BB0\u4E3A deprecated\uFF08\u8DF3\u8FC7\u89C2\u5BDF\u7A97\u53E3\uFF09\n- `skip_evolution` \u2014 \u663E\u5F0F\u8DF3\u8FC7\uFF0Creason \u4E2D\u8BF4\u660E\u662F\"\u9A8C\u8BC1\u6709\u6548\"\u8FD8\u662F\"\u4FE1\u606F\u4E0D\u8DB3\"\n\n## \u91CD\u8981\u7EA6\u675F\n\n- \u6BCF\u4E2A Recipe \u5FC5\u987B\u6709\u4E00\u4E2A\u660E\u786E\u51B3\u7B56\uFF0C\u4E0D\u8981\u9057\u6F0F\u4EFB\u4F55\u4E00\u4E2A\n- `propose_evolution` \u7684 evidence \u5B57\u6BB5\u5FC5\u987B\u5305\u542B\u4F60\u8BFB\u5230\u7684\u771F\u5B9E\u4EE3\u7801\uFF0C\u4E0D\u8981\u7F16\u9020\n- `propose_evolution` \u7684 type \u533A\u5206: enhance\uFF08\u6A21\u5F0F\u8FC1\u79FB/\u529F\u80FD\u6269\u5C55\uFF09vs correction\uFF08\u63CF\u8FF0\u9519\u8BEF/\u63A5\u53E3\u53D8\u66F4\uFF09\n- \u90E8\u5206 Recipe \u9644\u5E26\u7CFB\u7EDF\u9884\u68C0\u63D0\u793A\uFF08auditHint\uFF09\uFF0C\u4EC5\u4F9B\u53C2\u8003\u2014\u2014\u4F60\u5FC5\u987B\u4EE5\u5B9E\u9645\u8BFB\u5230\u7684\u4EE3\u7801\u4E3A\u51C6\n- \u5373\u4F7F\u9884\u68C0\u63D0\u793A\u8BF4\"healthy\"\uFF0C\u4F60\u8BFB\u4EE3\u7801\u540E\u53D1\u73B0\u4E0D\u5339\u914D\u4E5F\u8981\u63D0\u4EA4\u63D0\u6848";
+export declare const EVOLVER_TOOLS: string[];
+export declare const EVOLVER_BUDGET: {
+    maxIterations: number;
+    searchBudget: number;
+    searchBudgetGrace: number;
+    maxSubmits: number;
+    softSubmitLimit: number;
+    idleRoundsToExit: number;
+};
+/**
+ * 构建 Evolution Agent 的用户 Prompt
+ *
+ * 按维度打包全部现有 Recipe 清单 + 可选 audit hint + 项目概览，
+ * 让 Agent 通过提案机制对每个 Recipe 做出进化/废弃/跳过决策。
+ */
+export declare function buildEvolverPrompt(_phaseInput: unknown, _phaseResults: unknown, strategyContext: EvolutionContext): string;

package/dist/lib/agent/domain/insight-evolver.js

@@ -0,0 +1,230 @@
+/**
+ * insight-evolver.ts — Evolution Agent 领域函数
+ *
+ * Evolution Agent 是管线中的专职进化角色：
+ *   - 接收当前维度的**全部**现有 Recipe（不仅是衰退的）
+ *   - 使用工具读取真实代码，验证每个 Recipe 的真实性
+ *   - 通过**附加提案**（Proposal）驱动状态变更，不创建新 Recipe
+ *   - 三种决策: propose_evolution / confirm_deprecation / skip_evolution
+ *
+ * 被 PipelineStrategy 的 evolution preset 引用。
+ * 按维度隔离：每个维度的 Evolve Stage 只处理属于该维度的 Recipe。
+ *
+ * @module insight-evolver
+ */
+// ──────────────────────────────────────────────────────────────────
+// System Prompt
+// ──────────────────────────────────────────────────────────────────
+export const EVOLVER_SYSTEM_PROMPT = `你是 AutoSnippet 的 **Evolution Agent**，专职验证项目中现有知识条目（Recipe）的真实性与时效性。
+
+## 核心职责
+
+你通过阅读项目真实代码来验证每条 Recipe 是否仍然反映当前项目实践。
+你的工作结果以**提案（Proposal）**方式附加到现有 Recipe 上，推动知识库的渐进式演化。
+你**不创建新 Recipe**——那是后续 Produce 阶段的职责。
+
+## 验证流程
+
+对每个 Recipe 按以下步骤验证:
+1. 阅读 Recipe 的核心代码片段和源文件引用，理解其描述的模式
+2. 使用 \`read_project_file\` 读取源文件，验证代码是否存在且与 Recipe 描述匹配
+3. 如果源文件不存在或代码不匹配，使用 \`search_project_code\` 搜索该模式是否已迁移到其他位置
+4. 基于真实代码的验证结果做出决策
+
+## 决策规则
+
+按以下决策树判断（优先级从上到下）:
+
+| 验证结果 | 决策 | 工具 |
+|---------|------|------|
+| 源文件存在 + 代码匹配 Recipe 描述 | **跳过**: 仍然有效 | \`skip_evolution\` |
+| 源文件存在 + 代码已变化（接口改变/重构） | **进化提案**: 附加变更证据 | \`propose_evolution\` |
+| 源文件不存在 + 模式已迁移到新位置 | **进化提案**: 附加迁移证据 | \`propose_evolution\` |
+| 源文件不存在 + 完全无替代 | **确认废弃**: 知识已失效 | \`confirm_deprecation\` |
+| 信息不足以做出判断 | **跳过**: 交给时限机制 | \`skip_evolution\` |
+
+## 工具说明
+
+- \`propose_evolution\` — 为 Recipe 附加进化提案，包含代码验证证据和建议变更。提案进入观察窗口（enhance: 48h, correction: 24h），不直接修改 Recipe
+- \`confirm_deprecation\` — 确认 Recipe 已过时，立即标记为 deprecated（跳过观察窗口）
+- \`skip_evolution\` — 显式跳过，reason 中说明是"验证有效"还是"信息不足"
+
+## 重要约束
+
+- 每个 Recipe 必须有一个明确决策，不要遗漏任何一个
+- \`propose_evolution\` 的 evidence 字段必须包含你读到的真实代码，不要编造
+- \`propose_evolution\` 的 type 区分: enhance（模式迁移/功能扩展）vs correction（描述错误/接口变更）
+- 部分 Recipe 附带系统预检提示（auditHint），仅供参考——你必须以实际读到的代码为准
+- 即使预检提示说"healthy"，你读代码后发现不匹配也要提交提案`;
+// ──────────────────────────────────────────────────────────────────
+// 工具白名单
+// ──────────────────────────────────────────────────────────────────
+export const EVOLVER_TOOLS = [
+    'read_project_file',
+    'search_project_code',
+    'propose_evolution',
+    'confirm_deprecation',
+    'skip_evolution',
+];
+// ──────────────────────────────────────────────────────────────────
+// 预算
+// ──────────────────────────────────────────────────────────────────
+export const EVOLVER_BUDGET = {
+    maxIterations: 20,
+    searchBudget: 10,
+    searchBudgetGrace: 4,
+    maxSubmits: 8,
+    softSubmitLimit: 8,
+    idleRoundsToExit: 2,
+};
+// ──────────────────────────────────────────────────────────────────
+// Prompt 构建
+// ──────────────────────────────────────────────────────────────────
+/**
+ * 构建 Evolution Agent 的用户 Prompt
+ *
+ * 按维度打包全部现有 Recipe 清单 + 可选 audit hint + 项目概览，
+ * 让 Agent 通过提案机制对每个 Recipe 做出进化/废弃/跳过决策。
+ */
+export function buildEvolverPrompt(_phaseInput, _phaseResults, strategyContext) {
+    const { existingRecipes, dimensionId, dimensionLabel, projectOverview } = strategyContext;
+    const parts = [];
+    // §1 任务概述
+    parts.push(`# 验证任务: ${dimensionLabel} [${dimensionId}]`);
+    parts.push(`你需要验证 **${existingRecipes.length}** 个现有 Recipe 的真实性。`);
+    parts.push(`项目概况: ${projectOverview.primaryLang} 语言，${projectOverview.fileCount} 个文件。`);
+    if (projectOverview.modules.length > 0) {
+        parts.push(`主要模块: ${projectOverview.modules.slice(0, 10).join(', ')}`);
+    }
+    // §2 现有 Recipe 清单
+    parts.push('# 现有 Recipe 清单');
+    parts.push('以下是需要你验证的全部 Recipe。对每一个，你需要读取源文件、验证代码、然后做出决策。');
+    for (let i = 0; i < existingRecipes.length; i++) {
+        const recipe = existingRecipes[i];
+        const lines = [];
+        lines.push(`## [${i + 1}/${existingRecipes.length}] ${recipe.title}`);
+        lines.push(`- **ID**: \`${recipe.id}\``);
+        lines.push(`- **Trigger**: \`${recipe.trigger}\``);
+        // 源文件引用 — 验证的起点
+        if (recipe.sourceRefs && recipe.sourceRefs.length > 0) {
+            lines.push(`- **源文件引用** (请用 \`read_project_file\` 读取验证):`);
+            for (const ref of recipe.sourceRefs.slice(0, 5)) {
+                lines.push(`  - \`${ref}\``);
+            }
+            if (recipe.sourceRefs.length > 5) {
+                lines.push(`  - ... 及其他 ${recipe.sourceRefs.length - 5} 个文件`);
+            }
+        }
+        else {
+            lines.push('- **源文件引用**: 无（需要用 `search_project_code` 搜索相关代码）');
+        }
+        // Recipe 声称的核心代码（缩略）
+        if (recipe.content?.coreCode) {
+            const truncated = recipe.content.coreCode.length > 400
+                ? `${recipe.content.coreCode.slice(0, 400)}...`
+                : recipe.content.coreCode;
+            lines.push(`- **Recipe 声称的核心代码** (需验证是否与实际一致):`);
+            lines.push(`\`\`\`\n${truncated}\n\`\`\``);
+        }
+        // Recipe 的设计原理
+        if (recipe.content?.rationale) {
+            const rationale = recipe.content.rationale.length > 200
+                ? `${recipe.content.rationale.slice(0, 200)}...`
+                : recipe.content.rationale;
+            lines.push(`- **设计原理**: ${rationale}`);
+        }
+        // 静态审计 hint（可选）
+        if (recipe.auditHint) {
+            lines.push('- **系统预检提示** ⚠️ 仅供参考，以你读到的代码为准:');
+            lines.push(`  - 评分: ${recipe.auditHint.relevanceScore}/100 → ${recipe.auditHint.verdict}`);
+            const ev = recipe.auditHint.evidence;
+            const checks = [
+                `Trigger: ${ev.triggerStillMatches ? '✅' : '❌'}`,
+                `符号: ${(ev.symbolsAlive * 100).toFixed(0)}%`,
+                `依赖: ${ev.depsIntact ? '✅' : '❌'}`,
+                `代码文件: ${(ev.codeFilesExist * 100).toFixed(0)}%`,
+            ];
+            lines.push(`  - ${checks.join(' | ')}`);
+            if (recipe.auditHint.decayReasons.length > 0) {
+                lines.push(`  - 预检原因: ${recipe.auditHint.decayReasons.join('; ')}`);
+            }
+        }
+        parts.push(lines.join('\n'));
+    }
+    // §3 验证工作流
+    parts.push('# 验证工作流');
+    parts.push('对每个 Recipe 按以下步骤执行:');
+    parts.push('');
+    parts.push('**步骤 1 — 读取源文件**');
+    parts.push('- 使用 `read_project_file` 读取 sourceRefs 中列出的文件');
+    parts.push('- 如果没有 sourceRefs，跳到步骤 2');
+    parts.push('');
+    parts.push('**步骤 2 — 搜索验证**（仅在源文件缺失或代码不匹配时）');
+    parts.push('- 使用 `search_project_code` 搜索 Recipe 中的类名、函数名、关键模式');
+    parts.push('- 确认该模式是否迁移到了新位置或已被完全移除');
+    parts.push('');
+    parts.push('**步骤 3 — 做出决策**');
+    parts.push('- 基于步骤 1-2 的验证结果，调用对应的决策工具');
+    // §4 决策指令
+    parts.push('# 决策指令');
+    parts.push('对上述每个 Recipe 做出以下三种决策之一:');
+    parts.push('');
+    parts.push('### 1. 🔄 附加进化提案 — 代码已变但知识仍有价值');
+    parts.push('调用 `propose_evolution`:');
+    parts.push('```json');
+    parts.push('{');
+    parts.push('  "recipeId": "recipe-xxx",');
+    parts.push('  "type": "enhance",        // enhance=模式迁移/功能扩展, correction=描述错误/接口变更');
+    parts.push('  "description": "说明发生了什么变化",');
+    parts.push('  "evidence": {');
+    parts.push('    "sourceStatus": "modified", // exists|moved|modified|deleted');
+    parts.push('    "currentCode": "你读到的实际代码片段",');
+    parts.push('    "newLocation": "新路径（仅 moved 时）",');
+    parts.push('    "suggestedChanges": "{结构化 JSON — 见下方格式}"');
+    parts.push('  },');
+    parts.push('  "confidence": 0.85');
+    parts.push('}');
+    parts.push('```');
+    parts.push('');
+    parts.push('#### suggestedChanges 格式（重要！）');
+    parts.push('suggestedChanges 必须是一个 JSON 字符串，格式如下:');
+    parts.push('```json');
+    parts.push('{');
+    parts.push('  "patchVersion": 1,');
+    parts.push('  "changes": [');
+    parts.push('    {');
+    parts.push('      "field": "coreCode",');
+    parts.push('      "action": "replace",');
+    parts.push('      "newValue": "更新后的代码片段"');
+    parts.push('    },');
+    parts.push('    {');
+    parts.push('      "field": "content.markdown",');
+    parts.push('      "action": "replace-section",');
+    parts.push('      "section": "### 使用指南",');
+    parts.push('      "newContent": "### 使用指南\\n更新后的内容"');
+    parts.push('    }');
+    parts.push('  ],');
+    parts.push('  "reasoning": "源代码变更原因说明"');
+    parts.push('}');
+    parts.push('```');
+    parts.push('');
+    parts.push('可修改的字段: `coreCode`, `doClause`, `dontClause`, `whenClause`, `content.markdown`, `content.rationale`, `sourceRefs`, `headers`');
+    parts.push('操作类型: `replace`=全量替换, `replace-section`=替换 Markdown section, `append`=追加');
+    parts.push('');
+    parts.push('### 2. ⛔ 确认废弃 — 知识确实过时，无法挽救');
+    parts.push('调用 `confirm_deprecation`:');
+    parts.push('```json');
+    parts.push('{ "recipeId": "recipe-xxx", "reason": "具体废弃原因" }');
+    parts.push('```');
+    parts.push('');
+    parts.push('### 3. ⏭️ 跳过 — 仍然有效 或 信息不足');
+    parts.push('调用 `skip_evolution`:');
+    parts.push('```json');
+    parts.push('{ "recipeId": "recipe-xxx", "reason": "验证有效: 代码与描述完全匹配" }');
+    parts.push('```');
+    parts.push('或:');
+    parts.push('```json');
+    parts.push('{ "recipeId": "recipe-xxx", "reason": "信息不足: 无法确认源文件位置" }');
+    parts.push('```');
+    return parts.join('\n\n');
+}

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

@@ -190,4 +190,46 @@ export declare function insightGateEvaluator(source: unknown, phaseResults: Reco
         };
     };
 };
+/** Tool call record for evolution gate */
+interface EvolutionToolCallRecord {
+    tool?: string;
+    name?: string;
+    args?: Record<string, unknown>;
+    result?: unknown;
+}
+/**
+ * Evolution Gate 评估器 — 面向 PipelineStrategy gate.evaluator
+ *
+ * 检查 Evolution Agent 是否对所有现有 Recipe 做出了决策:
+ * - evolved (submit_knowledge with supersedes)
+ * - deprecated (confirm_deprecation)
+ * - skipped (skip_evolution)
+ *
+ * 如果还有未处理的 Recipe，返回 retry 要求补充决策。
+ *
+ * 兼容旧字段: 优先读 existingRecipes，回退 decayedRecipes。
+ */
+export declare function evolutionGateEvaluator(source: {
+    toolCalls?: EvolutionToolCallRecord[];
+} | null | undefined, _phaseResults: unknown, strategyContext?: {
+    existingRecipes?: Array<{
+        id: string;
+    }>;
+    decayedRecipes?: Array<{
+        id: string;
+    }>;
+}): {
+    action: string;
+    reason: string;
+    artifact?: undefined;
+} | {
+    action: string;
+    artifact: {
+        evolved: number;
+        deprecated: number;
+        skipped: number;
+        totalRecipes: number;
+    };
+    reason?: undefined;
+};
 export {};

package/dist/lib/agent/domain/insight-gate.js

@@ -382,6 +382,47 @@ export function insightGateEvaluator(source, phaseResults, strategyContext = {})
         artifact,
     };
 }
+/**
+ * Evolution Gate 评估器 — 面向 PipelineStrategy gate.evaluator
+ *
+ * 检查 Evolution Agent 是否对所有现有 Recipe 做出了决策:
+ * - evolved (submit_knowledge with supersedes)
+ * - deprecated (confirm_deprecation)
+ * - skipped (skip_evolution)
+ *
+ * 如果还有未处理的 Recipe，返回 retry 要求补充决策。
+ *
+ * 兼容旧字段: 优先读 existingRecipes，回退 decayedRecipes。
+ */
+export function evolutionGateEvaluator(source, _phaseResults, strategyContext = {}) {
+    const totalRecipes = (strategyContext.existingRecipes ?? strategyContext.decayedRecipes ?? [])
+        .length;
+    const toolCalls = source?.toolCalls || [];
+    // 统计各决策数
+    const evolved = toolCalls.filter((tc) => {
+        const tool = tc.tool || tc.name;
+        return tool === 'submit_knowledge' && tc.args?.supersedes;
+    }).length;
+    const deprecated = toolCalls.filter((tc) => {
+        const tool = tc.tool || tc.name;
+        return tool === 'confirm_deprecation';
+    }).length;
+    const skipped = toolCalls.filter((tc) => {
+        const tool = tc.tool || tc.name;
+        return tool === 'skip_evolution';
+    }).length;
+    const processed = evolved + deprecated + skipped;
+    if (totalRecipes > 0 && processed < totalRecipes) {
+        return {
+            action: 'retry',
+            reason: `只处理了 ${processed}/${totalRecipes} 个 Recipe，还有 ${totalRecipes - processed} 个未决策`,
+        };
+    }
+    return {
+        action: 'pass',
+        artifact: { evolved, deprecated, skipped, totalRecipes },
+    };
+}
 // ──────────────────────────────────────────────────────────────────
 // 类型定义 (JSDoc)
 // ──────────────────────────────────────────────────────────────────

package/dist/lib/agent/domain/insight-producer.d.ts

@@ -62,7 +62,7 @@ interface GateStrategyContext {
     submitToolNames?: string[];
     [key: string]: unknown;
 }
-export declare const PRODUCER_SYSTEM_PROMPT = "\u4F60\u662F\u77E5\u8BC6\u7BA1\u7406\u4E13\u5BB6\u3002\u4F60\u4F1A\u6536\u5230\u4E00\u6BB5\u4EE3\u7801\u5206\u6790\u6587\u672C\uFF0C\u9700\u8981\u5C06\u5176\u4E2D\u7684\u77E5\u8BC6\u70B9\u8F6C\u5316\u4E3A\u7ED3\u6784\u5316\u7684\u77E5\u8BC6\u5019\u9009\u3002\n\n\u6838\u5FC3\u539F\u5219: \u5206\u6790\u6587\u672C\u5DF2\u7ECF\u5305\u542B\u4E86\u6240\u6709\u53D1\u73B0\uFF0C\u4F60\u7684\u552F\u4E00\u5DE5\u4F5C\u662F\u5C06\u5B83\u4EEC\u683C\u5F0F\u5316\u4E3A submit_knowledge \u8C03\u7528\u3002\n\n\u6BCF\u4E2A\u5019\u9009\u5FC5\u987B:\n1. \u6709\u6E05\u6670\u7684\u6807\u9898 (\u63CF\u8FF0\u77E5\u8BC6\u70B9\u7684\u6838\u5FC3\uFF0C\u4F7F\u7528\u9879\u76EE\u771F\u5B9E\u7C7B\u540D)\n2. \u6709\u9879\u76EE\u7279\u5199\u98CE\u683C\u7684\u6B63\u6587 (content.markdown \u5B57\u6BB5\uFF0C\u7ED3\u5408\u4EE3\u7801\u5C55\u793A)\n3. \u6807\u6CE8\u76F8\u5173\u6587\u4EF6\u8DEF\u5F84\n4. \u9009\u62E9\u6B63\u786E\u7684 kind (rule/pattern/fact)\n5. \u63D0\u4F9B\u5B8C\u6574\u7684 Cursor \u4EA4\u4ED8\u5B57\u6BB5 (trigger, doClause, whenClause \u7B49)\n\n\u5DE5\u4F5C\u6D41\u7A0B:\n1. \u9605\u8BFB\u5206\u6790\u6587\u672C\uFF0C\u8BC6\u522B\u6BCF\u4E2A\u72EC\u7ACB\u7684\u77E5\u8BC6\u70B9/\u53D1\u73B0\n2. \u7528 read_project_file \u6279\u91CF\u83B7\u53D6\u5173\u952E\u4EE3\u7801\u7247\u6BB5:\n   read_project_file({ filePaths: [\"FileA.m\", \"FileB.m\"], maxLines: 80 })\n3. \u7ACB\u523B\u8C03\u7528 submit_knowledge \u63D0\u4EA4\n4. \u91CD\u590D\u76F4\u5230\u5206\u6790\u4E2D\u7684\u6240\u6709\u77E5\u8BC6\u70B9\u90FD\u5DF2\u63D0\u4EA4\n\n\u5173\u952E\u89C4\u5219:\n- \u5206\u6790\u4E2D\u7684\u6BCF\u4E2A\u8981\u70B9/\u6BB5\u843D\u90FD\u5E94\u8F6C\u5316\u4E3A\u81F3\u5C11\u4E00\u4E2A\u5019\u9009\n- read_project_file \u652F\u6301 filePaths \u6570\u7EC4\u6279\u91CF\u8BFB\u53D6\u591A\u4E2A\u6587\u4EF6\uFF0C\u4E00\u6B21\u8C03\u7528\u5B8C\u6210\n- read_project_file \u65F6\u8BFB\u53D6\u8DB3\u591F\u591A\u7684\u884C\u6570\uFF08startLine + maxLines \u81F3\u5C11 30 \u884C\uFF09\n- reasoning.sources \u5FC5\u987B\u662F\u975E\u7A7A\u6570\u7EC4\uFF0C\u586B\u5199\u76F8\u5173\u6587\u4EF6\u8DEF\u5F84\u5982 [\"FileName.m\"]\n- \u5982\u679C\u5206\u6790\u63D0\u5230\u4E86 3 \u4E2A\u6A21\u5F0F\uFF0C\u5C31\u5E94\u8BE5\u63D0\u4EA4 3 \u4E2A\u5019\u9009\uFF0C\u4E0D\u8981\u5408\u5E76\n- \u7981\u6B62: \u4E0D\u8981\u641C\u7D22\u65B0\u6587\u4EF6\u3001\u4E0D\u8981\u505A\u989D\u5916\u5206\u6790\uFF0C\u4E13\u6CE8\u4E8E\u683C\u5F0F\u5316\u548C\u63D0\u4EA4\n\n\u5BB9\u9519\u89C4\u5219:\n- \u5982\u679C read_project_file \u8FD4\u56DE\"\u6587\u4EF6\u4E0D\u5B58\u5728\"\u6216\u9519\u8BEF\uFF0C\u4E0D\u8981\u91CD\u8BD5\u540C\u4E00\u6587\u4EF6\u7684\u5176\u4ED6\u8DEF\u5F84\u53D8\u4F53\n- \u6587\u4EF6\u8BFB\u53D6\u5931\u8D25\u65F6\uFF0C\u76F4\u63A5\u4F7F\u7528\u5206\u6790\u6587\u672C\u4E2D\u5DF2\u6709\u7684\u4EE3\u7801\u548C\u63CF\u8FF0\u6765\u63D0\u4EA4\u5019\u9009\n- \u6C38\u8FDC\u4E0D\u8981\u56E0\u4E3A\u6587\u4EF6\u8BFB\u53D6\u5931\u8D25\u800C\u8DF3\u8FC7\u77E5\u8BC6\u70B9 \u2014 \u5206\u6790\u6587\u672C\u5DF2\u7ECF\u5305\u542B\u8DB3\u591F\u4FE1\u606F\n- \u5148\u63D0\u4EA4\u5019\u9009\uFF0C\u518D\u8003\u8651\u662F\u5426\u9700\u8981\u8BFB\u53D6\u66F4\u591A\u4EE3\u7801\uFF08\u63D0\u4EA4\u4F18\u5148\u4E8E\u9A8C\u8BC1\uFF09";
+export declare const PRODUCER_SYSTEM_PROMPT = "\u4F60\u662F\u77E5\u8BC6\u7BA1\u7406\u4E13\u5BB6\u3002\u4F60\u4F1A\u6536\u5230\u4E00\u6BB5\u4EE3\u7801\u5206\u6790\u6587\u672C\uFF0C\u9700\u8981\u5C06\u5176\u4E2D\u7684\u77E5\u8BC6\u70B9\u8F6C\u5316\u4E3A\u7ED3\u6784\u5316\u7684\u77E5\u8BC6\u5019\u9009\u3002\n\n\u6838\u5FC3\u539F\u5219: \u5206\u6790\u6587\u672C\u5DF2\u7ECF\u5305\u542B\u4E86\u6240\u6709\u53D1\u73B0\uFF0C\u4F60\u7684\u552F\u4E00\u5DE5\u4F5C\u662F\u5C06\u5B83\u4EEC\u683C\u5F0F\u5316\u4E3A submit_knowledge \u8C03\u7528\u3002\n\n\u6BCF\u4E2A\u5019\u9009\u5FC5\u987B:\n1. \u6709\u6E05\u6670\u7684\u6807\u9898 (\u63CF\u8FF0\u77E5\u8BC6\u70B9\u7684\u6838\u5FC3\uFF0C\u4F7F\u7528\u9879\u76EE\u771F\u5B9E\u7C7B\u540D\uFF0C\u4E0D\u4EE5\u9879\u76EE\u540D\u5F00\u5934)\n2. \u6709\u9879\u76EE\u7279\u5199\u98CE\u683C\u7684\u6B63\u6587 (content.markdown \u5B57\u6BB5\uFF0C\u7ED3\u5408\u4EE3\u7801\u5C55\u793A)\n3. \u6807\u6CE8\u76F8\u5173\u6587\u4EF6\u7684\u5B8C\u6574\u76F8\u5BF9\u8DEF\u5F84 + \u884C\u53F7\uFF08\u4ECE\u9879\u76EE\u6839\u76EE\u5F55\u5F00\u59CB\uFF0C\u5982 Packages/AOXNetworkKit/Sources/.../NetworkClient.swift:42\uFF09\n4. \u9009\u62E9\u6B63\u786E\u7684 kind (rule/pattern/fact)\n5. \u63D0\u4F9B\u5B8C\u6574\u7684 Cursor \u4EA4\u4ED8\u5B57\u6BB5 (trigger, doClause, whenClause \u7B49)\n6. \u6807\u6CE8\u6240\u5C5E\u6A21\u5757/\u5305\u540D\uFF08\u5982\u300C\u6240\u5C5E\u6A21\u5757: AOXNetworkKit\u300D\uFF09\uFF0C\u7279\u522B\u662F\u6765\u81EA\u672C\u5730\u5B50\u5305\u7684\u77E5\u8BC6\n\n\u5DE5\u4F5C\u6D41\u7A0B:\n1. \u9605\u8BFB\u5206\u6790\u6587\u672C\uFF0C\u8BC6\u522B\u6BCF\u4E2A\u72EC\u7ACB\u7684\u77E5\u8BC6\u70B9/\u53D1\u73B0\n2. \u7528 read_project_file \u6279\u91CF\u83B7\u53D6\u5173\u952E\u4EE3\u7801\u7247\u6BB5:\n   read_project_file({ filePaths: [\"Full/Path/To/FileA.swift\", \"Full/Path/To/FileB.swift\"], maxLines: 80 })\n3. \u7ACB\u523B\u8C03\u7528 submit_knowledge \u63D0\u4EA4\n4. \u91CD\u590D\u76F4\u5230\u5206\u6790\u4E2D\u7684\u6240\u6709\u77E5\u8BC6\u70B9\u90FD\u5DF2\u63D0\u4EA4\n\n\u5173\u952E\u89C4\u5219:\n- \u5206\u6790\u4E2D\u7684\u6BCF\u4E2A\u8981\u70B9/\u6BB5\u843D\u90FD\u5E94\u8F6C\u5316\u4E3A\u81F3\u5C11\u4E00\u4E2A\u5019\u9009\n- read_project_file \u652F\u6301 filePaths \u6570\u7EC4\u6279\u91CF\u8BFB\u53D6\u591A\u4E2A\u6587\u4EF6\uFF0C\u4E00\u6B21\u8C03\u7528\u5B8C\u6210\n- read_project_file \u65F6\u8BFB\u53D6\u8DB3\u591F\u591A\u7684\u884C\u6570\uFF08startLine + maxLines \u81F3\u5C11 30 \u884C\uFF09\n- reasoning.sources \u5FC5\u987B\u662F\u975E\u7A7A\u6570\u7EC4\uFF0C\u586B\u5199\u6587\u4EF6\u7684\u5B8C\u6574\u76F8\u5BF9\u8DEF\u5F84\u5982 [\"Packages/AOXNetworkKit/Sources/AOXNetworkKit/Client/NetworkClient.swift\"]\uFF08\u7981\u6B62\u53EA\u5199\u6587\u4EF6\u540D\uFF09\n- content.markdown \u4E2D\u7684\u6765\u6E90\u6807\u6CE8\u5FC5\u987B\u4F7F\u7528\u5B8C\u6574\u76F8\u5BF9\u8DEF\u5F84+\u884C\u53F7: (\u6765\u6E90: Full/Path/FileName.ext:\u884C\u53F7)\n- \u5982\u679C\u5206\u6790\u63D0\u5230\u4E86 3 \u4E2A\u6A21\u5F0F\uFF0C\u5C31\u5E94\u8BE5\u63D0\u4EA4 3 \u4E2A\u5019\u9009\uFF0C\u4E0D\u8981\u5408\u5E76\n- \u7981\u6B62: \u4E0D\u8981\u641C\u7D22\u65B0\u6587\u4EF6\u3001\u4E0D\u8981\u505A\u989D\u5916\u5206\u6790\uFF0C\u4E13\u6CE8\u4E8E\u683C\u5F0F\u5316\u548C\u63D0\u4EA4\n- \u3010\u8DE8\u7EF4\u5EA6\u53BB\u91CD\u3011\u6BCF\u6761\u5019\u9009\u5FC5\u987B\u805A\u7126\u5F53\u524D\u7EF4\u5EA6\u72EC\u6709\u7684\u89C6\u89D2\uFF0C\u4E0D\u5F97\u5C06\u540C\u4E00\u77E5\u8BC6\u70B9\u6362\u4E2A\u8BF4\u6CD5\u91CD\u590D\u63D0\u4EA4\u3002\u76F8\u540C\u7684\u7C7B/\u6A21\u5F0F\u53EA\u5728\u6700\u76F8\u5173\u7684\u7EF4\u5EA6\u51FA\u73B0\u4E00\u6B21\uFF0C\u5B81\u53EF\u5C11\u63D0\u4EA4\u4E5F\u4E0D\u8981\u5145\u6570\n\n\u5BB9\u9519\u89C4\u5219:\n- \u5982\u679C read_project_file \u8FD4\u56DE\"\u6587\u4EF6\u4E0D\u5B58\u5728\"\u6216\u9519\u8BEF\uFF0C\u4E0D\u8981\u91CD\u8BD5\u540C\u4E00\u6587\u4EF6\u7684\u5176\u4ED6\u8DEF\u5F84\u53D8\u4F53\n- \u6587\u4EF6\u8BFB\u53D6\u5931\u8D25\u65F6\uFF0C\u76F4\u63A5\u4F7F\u7528\u5206\u6790\u6587\u672C\u4E2D\u5DF2\u6709\u7684\u4EE3\u7801\u548C\u63CF\u8FF0\u6765\u63D0\u4EA4\u5019\u9009\n- \u6C38\u8FDC\u4E0D\u8981\u56E0\u4E3A\u6587\u4EF6\u8BFB\u53D6\u5931\u8D25\u800C\u8DF3\u8FC7\u77E5\u8BC6\u70B9 \u2014 \u5206\u6790\u6587\u672C\u5DF2\u7ECF\u5305\u542B\u8DB3\u591F\u4FE1\u606F\n- \u5148\u63D0\u4EA4\u5019\u9009\uFF0C\u518D\u8003\u8651\u662F\u5426\u9700\u8981\u8BFB\u53D6\u66F4\u591A\u4EE3\u7801\uFF08\u63D0\u4EA4\u4F18\u5148\u4E8E\u9A8C\u8BC1\uFF09";
 export declare const PRODUCER_TOOLS: string[];
 export declare const PRODUCER_BUDGET: {
     maxIterations: number;
@@ -79,6 +79,29 @@ export declare const PRODUCER_BUDGET: {
  * @param projectInfo { name }
  */
 export declare function buildProducerPrompt(analysisReport: AnalysisReportLike, dimConfig: DimConfig, projectInfo: ProjectInfo): string;
+/** Panorama context for Producer */
+interface ProducerPanoramaContext {
+    moduleRole: string | null;
+    moduleLayer: number | null;
+    knownGaps: string[];
+    layerContext: string | null;
+}
+/** Rescan context for Producer — gap info + existing recipe titles */
+interface ProducerRescanContext {
+    existingRecipes: Array<{
+        title: string;
+        trigger: string;
+    }>;
+    decayingRecipes?: Array<{
+        id?: string;
+        title: string;
+        trigger: string;
+        decayReason?: string;
+    }>;
+    occupiedTriggers: string[];
+    gap: number;
+    existing: number;
+}
 /**
  * 构建 Producer Prompt v2 — 用于 AnalysisArtifact
  *
@@ -86,8 +109,10 @@ export declare function buildProducerPrompt(analysisReport: AnalysisReportLike,
  * - §3 结构化发现 (findings)
  * - §4 代码证据 (evidenceMap → code context)
  * - §5 负空间信号
+ * - §9 (可选) Rescan 模式约束
+ * - §M1 (可选) 全景上下文
  */
-export declare function buildProducerPromptV2(artifact: AnalysisArtifactLike, dimConfig: DimConfig, projectInfo: ProjectInfo): string;
+export declare function buildProducerPromptV2(artifact: AnalysisArtifactLike, dimConfig: DimConfig, projectInfo: ProjectInfo, rescanContext?: ProducerRescanContext | null, panorama?: ProducerPanoramaContext | null): string;
 /**
  * 从 evidenceMap 构建代码上下文段
  *