autosnippet 3.3.4 → 3.3.6

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

@@ -23,16 +23,17 @@ export const PRODUCER_SYSTEM_PROMPT = `你是知识管理专家。你会收到
 核心原则: 分析文本已经包含了所有发现，你的唯一工作是将它们格式化为 submit_knowledge 调用。
 
 每个候选必须:
-1. 有清晰的标题 (描述知识点的核心，使用项目真实类名)
+1. 有清晰的标题 (描述知识点的核心，使用项目真实类名，不以项目名开头)
 2. 有项目特写风格的正文 (content.markdown 字段，结合代码展示)
-3. 标注相关文件路径
+3. 标注相关文件的完整相对路径 + 行号（从项目根目录开始，如 Packages/AOXNetworkKit/Sources/.../NetworkClient.swift:42）
 4. 选择正确的 kind (rule/pattern/fact)
 5. 提供完整的 Cursor 交付字段 (trigger, doClause, whenClause 等)
+6. 标注所属模块/包名（如「所属模块: AOXNetworkKit」），特别是来自本地子包的知识
 
 工作流程:
 1. 阅读分析文本，识别每个独立的知识点/发现
 2. 用 read_project_file 批量获取关键代码片段:
-   read_project_file({ filePaths: ["FileA.m", "FileB.m"], maxLines: 80 })
+   read_project_file({ filePaths: ["Full/Path/To/FileA.swift", "Full/Path/To/FileB.swift"], maxLines: 80 })
 3. 立刻调用 submit_knowledge 提交
 4. 重复直到分析中的所有知识点都已提交
 
@@ -40,9 +41,11 @@ export const PRODUCER_SYSTEM_PROMPT = `你是知识管理专家。你会收到
 - 分析中的每个要点/段落都应转化为至少一个候选
 - read_project_file 支持 filePaths 数组批量读取多个文件，一次调用完成
 - read_project_file 时读取足够多的行数（startLine + maxLines 至少 30 行）
-- reasoning.sources 必须是非空数组，填写相关文件路径如 ["FileName.m"]
+- reasoning.sources 必须是非空数组，填写文件的完整相对路径如 ["Packages/AOXNetworkKit/Sources/AOXNetworkKit/Client/NetworkClient.swift"]（禁止只写文件名）
+- content.markdown 中的来源标注必须使用完整相对路径+行号: (来源: Full/Path/FileName.ext:行号)
 - 如果分析提到了 3 个模式，就应该提交 3 个候选，不要合并
 - 禁止: 不要搜索新文件、不要做额外分析，专注于格式化和提交
+- 【跨维度去重】每条候选必须聚焦当前维度独有的视角，不得将同一知识点换个说法重复提交。相同的类/模式只在最相关的维度出现一次，宁可少提交也不要充数
 
 容错规则:
 - 如果 read_project_file 返回"文件不存在"或错误，不要重试同一文件的其他路径变体
@@ -99,8 +102,10 @@ export function buildProducerPrompt(analysisReport, dimConfig, projectInfo) {
  * - §3 结构化发现 (findings)
  * - §4 代码证据 (evidenceMap → code context)
  * - §5 负空间信号
+ * - §9 (可选) Rescan 模式约束
+ * - §M1 (可选) 全景上下文
  */
-export function buildProducerPromptV2(artifact, dimConfig, projectInfo) {
+export function buildProducerPromptV2(artifact, dimConfig, projectInfo, rescanContext, panorama) {
     const parts = [];
     parts.push(`将以下对 ${projectInfo.name} 项目 "${dimConfig.label}" 维度的分析，转化为知识候选:`);
     parts.push(`---\n${artifact.analysisText}\n---`);
@@ -144,6 +149,56 @@ export function buildProducerPromptV2(artifact, dimConfig, projectInfo) {
     // §8 写作指南 + 提交要求
     parts.push(STYLE_GUIDE);
     parts.push(SUBMIT_REQUIREMENTS);
+    // §M1 全景上下文 — 帮助 Producer 理解模块定位
+    if (panorama) {
+        const pLines = [];
+        if (panorama.moduleRole) {
+            pLines.push(`模块角色: ${panorama.moduleRole}${panorama.moduleLayer !== null ? ` (L${panorama.moduleLayer})` : ''}`);
+        }
+        if (panorama.layerContext) {
+            pLines.push(`架构层级: ${panorama.layerContext}`);
+        }
+        if (panorama.knownGaps.length > 0) {
+            pLines.push(`知识空白区: ${panorama.knownGaps.join(', ')} — 优先为这些方向创建候选。`);
+        }
+        if (pLines.length > 0) {
+            parts.push(`## 🏗️ 项目全景\n${pLines.join('\n')}`);
+        }
+    }
+    // §9a Rescan 模式约束 — 限制提交数量，避免重复
+    if (rescanContext && rescanContext.gap > 0) {
+        const lines = [
+            '## ⚠️ 增量扫描模式 — 补齐约束',
+            `本维度已有 ${rescanContext.existing} 个有效知识，需补齐 **${rescanContext.gap}** 个。`,
+            `**提交上限: ${rescanContext.gap} 个候选**。达到目标后立即停止，不要多提交。`,
+        ];
+        if (rescanContext.occupiedTriggers.length > 0) {
+            lines.push(`已占用的 trigger: ${rescanContext.occupiedTriggers.slice(0, 15).join(', ')}`);
+            lines.push('禁止使用上述已占用的 trigger，必须为新模式创建新 trigger。');
+        }
+        if (rescanContext.existingRecipes.length > 0) {
+            lines.push('已有知识标题 (禁止重复):');
+            for (const r of rescanContext.existingRecipes.slice(0, 8)) {
+                lines.push(`- "${r.title}"`);
+            }
+        }
+        parts.push(lines.join('\n'));
+    }
+    // §9b 衰退 Recipe — 可用 supersedes 替换
+    if (rescanContext?.decayingRecipes && rescanContext.decayingRecipes.length > 0) {
+        const dLines = [
+            '## 🔄 可替换的衰退知识',
+            '以下 Recipe 正在衰退，如果 Analyst 发现了更新版本的模式，',
+            '你可以用 `supersedes` 参数提交替代版本：',
+        ];
+        for (const r of rescanContext.decayingRecipes.slice(0, 5)) {
+            dLines.push(`- [${r.id || '?'}] "${r.title}" — ${r.decayReason || '衰退中'}`);
+            dLines.push(`  → 替换方式: submit_knowledge({ ...newRecipe, supersedes: "${r.id || ''}" })`);
+        }
+        dLines.push('注意: supersedes 提交会创建观察窗口（72h），不是立即替换。');
+        dLines.push('替换的新 Recipe 必须基于当前代码，不要复制旧 Recipe 内容。');
+        parts.push(dLines.join('\n'));
+    }
     return parts.join('\n\n');
 }
 // ──────────────────────────────────────────────────────────────────

package/dist/lib/agent/domain/scan-prompts.js

@@ -30,32 +30,35 @@ export const SCAN_TASK_CONFIGS = {
 核心原则: 分析文本已经包含了所有发现，你的唯一工作是将它们格式化为 collect_scan_recipe 调用。
 
 每个候选必须:
-1. 有清晰的标题 (描述知识点的核心，使用项目真实类名)
+1. 有清晰的标题 (描述知识点的核心，使用项目真实类名，不以项目名开头)
 2. 有项目特写风格的正文 (content.markdown 字段，结合代码展示)
-3. 标注相关文件路径 (reasoning.sources)
+3. 标注相关文件的完整相对路径 + 行号 (reasoning.sources，如 ["Packages/ModuleName/Sources/.../FileName.swift"])
 4. 选择正确的 kind (rule/pattern/fact)
 5. 提供完整的 Cursor 交付字段 (trigger, doClause, whenClause 等)
+6. 标注所属模块/包名（特别是来自本地子包的知识）
 
 ## 「项目特写」写作要求（content.markdown）
 content.markdown 字段必须是「项目特写」：
 1. **项目选择了什么** — 采用了哪种写法/模式/约定
 2. **为什么这样选** — 统计分布、占比、历史决策
 3. **项目禁止什么** — 反模式、已废弃写法
-4. **新代码怎么写** — 可直接复制使用的代码模板 + 来源标注 (来源: FileName.ext:行号)
+4. **新代码怎么写** — 可直接复制使用的代码模板 + 来源标注 (来源: Full/Relative/Path/FileName.ext:行号)
 
 ## 工作流程
 1. 阅读分析文本，识别每个独立的知识点/发现
 2. 用 read_project_file 批量获取关键代码片段:
-   read_project_file({ filePaths: ["FileA.m", "FileB.m"], maxLines: 80 })
+   read_project_file({ filePaths: ["Full/Path/To/FileA.swift", "Full/Path/To/FileB.swift"], maxLines: 80 })
 3. 立刻调用 collect_scan_recipe 提交
 4. 重复直到分析中的所有知识点都已提交
 
 ## 关键规则
 - 分析中的每个要点/段落都应转化为至少一个候选
 - read_project_file 支持 filePaths 数组批量读取多个文件，一次调用完成
-- reasoning.sources 必须是非空数组，填写相关文件路径如 ["FileName.m"]
+- reasoning.sources 必须是非空数组，填写文件的完整相对路径（从项目根目录开始），禁止只写文件名
+- content.markdown 中的来源标注必须使用完整相对路径: (来源: Full/Path/FileName.ext:行号)
 - 如果分析提到了 3 个模式，就应该提交 3 个候选，不要合并
 - 禁止: 不要搜索新文件、不要做额外分析，专注于格式化和提交
+- 【跨维度去重】每条候选必须聚焦当前维度独有的视角，不得将同一知识点换个说法重复提交到不同维度。宁可少提交也不要充数
 
 容错规则:
 - 如果 read_project_file 返回"文件不存在"或错误，不要重试同一文件的其他路径变体
@@ -71,7 +74,7 @@ content.markdown 字段必须是「项目特写」：
 核心原则: 分析文本已经包含了所有发现，你的唯一工作是将它们格式化为 collect_scan_recipe 调用。
 
 这是单文件/代码片段的深度分析，提交一个（或少量）高质量的知识候选：
-1. 清晰的标题（描述代码的核心功能，使用项目真实类名）
+1. 清晰的标题（描述代码的核心功能，使用项目真实类名，不以项目名开头）
 2. 完整的技术文档正文（content.markdown 字段，≥200 字符）
 3. 实用的使用指南（usageGuide 字段，含示例）
 4. 准确的分类（category）和标签（tags）
@@ -206,7 +209,7 @@ export function buildScanPipelineStages({ task, producePrompt, analyzeCaps, prod
 2. content.markdown 字段 ≥ 200 字符，含代码块 (\`\`\`)
 3. content.rationale 必填 — 设计原理说明
 4. reasoning.sources 必须是非空数组
-5. 标题使用项目真实类名
+5. 标题使用项目真实类名，不以项目名开头
 6. 必填: trigger (@kebab-case)、kind (rule/pattern/fact)、doClause (英文祈使句)`;
                 },
                 skipOnDegrade: true,

package/dist/lib/agent/memory/ActiveContext.d.ts

@@ -21,6 +21,7 @@
  *
  * @module ActiveContext
  */
+import type { DistilledContext } from './memory-flush-contract.js';
 interface ActiveContextOptions {
     maxRecentRounds?: number;
     lightweight?: boolean;
@@ -189,34 +190,7 @@ export declare class ActiveContext {
      * 蒸馏 ActiveContext 为结构化报告
      * 在 Agent execute 结束时调用，结果写入 SessionStore
      */
-    distill(): {
-        keyFindings: {
-            finding: string;
-            evidence: string;
-            importance: number;
-        }[];
-        toolCallSummary: string[];
-        stats: {
-            totalRounds: number;
-            thoughtCount: number;
-            totalActions: number;
-            totalObservations: number;
-            reflectionCount: number;
-            totalDurationMs: number;
-        };
-        plan: {
-            steps: {
-                description: string;
-                status: string;
-                keywords: string[];
-            }[];
-            text: string;
-            createdAtIteration: number;
-            lastUpdatedAtIteration: number;
-        } | null;
-        totalObservations: number;
-        compressedCount: number;
-    };
+    distill(): DistilledContext;
     /**
      * 获取所有有 Thought 的轮次
      * @returns >}

package/dist/lib/agent/memory/MemoryCoordinator.d.ts

@@ -14,7 +14,7 @@
  * @module MemoryCoordinator
  */
 import { ActiveContext } from './ActiveContext.js';
-import type { SessionStore } from './SessionStore.js';
+import type { DimensionReportInput, SessionStore } from './SessionStore.js';
 /** PersistentMemory 接口 (声明式) */
 interface PersistentMemoryLike {
     toPromptSection(opts: {
@@ -153,7 +153,7 @@ export declare class MemoryCoordinator {
      * 完成维度: 蒸馏 + 存储到 SessionStore
      * @param [report] 附加报告数据
      */
-    completeDimension(scopeId: string, report?: Record<string, unknown>): void;
+    completeDimension(scopeId: string, report?: DimensionReportInput): void;
     /**
      * 完成会话: 触发 Consolidator
      * @returns |null>}

package/dist/lib/agent/memory/SessionStore.d.ts

@@ -22,6 +22,7 @@
  *
  * @module SessionStore
  */
+import type { SessionStoreSerialized } from './session-store-schema.js';
 /** Finding 结构 */
 export interface Finding {
     finding: string;
@@ -59,7 +60,10 @@ export interface WorkingMemoryDistilled {
         tool: string;
         summary: string;
     }>;
-    [key: string]: unknown;
+    stats?: Record<string, number>;
+    plan?: Record<string, unknown> | null;
+    totalObservations?: number;
+    compressedCount?: number;
 }
 /** 维度摘要 */
 export interface DimensionDigest {
@@ -168,17 +172,7 @@ export declare class SessionStore {
     set(toolName: string, args: ToolArgs, result: unknown): void;
     saveCheckpoint(projectRoot: string): Promise<void>;
     loadCheckpoint(projectRoot: string): Promise<boolean>;
-    toJSON(): {
-        dimensionReports: {
-            [k: string]: DimensionReport;
-        };
-        crossReferences: CrossReference[];
-        tierReflections: TierReflection[];
-        submittedCandidates: {
-            [k: string]: CandidateSummary[];
-        };
-        projectContext: Record<string, unknown>;
-    };
+    toJSON(): SessionStoreSerialized;
     static fromJSON(json: Record<string, unknown>): SessionStore;
     /** 获取所有已引用文件 (去重, F10) */
     getAllReferencedFiles(): Set<string>;

package/dist/lib/agent/memory/SessionStore.js

@@ -26,6 +26,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import Logger from '#infra/logging/Logger.js';
 import { CACHE } from '#shared/constants.js';
+import { validateSessionStoreShape } from './session-store-schema.js';
 // ── 类型定义 ──
 /** 副作用工具 — 不缓存结果 (B3 fix) */
 const NON_CACHEABLE = new Set([
@@ -570,24 +571,17 @@ export class SessionStore {
         };
     }
     static fromJSON(json) {
+        const validated = validateSessionStoreShape(json);
         const store = new SessionStore({
-            projectContext: json.projectContext || {},
+            projectContext: validated.projectContext,
         });
-        if (json.dimensionReports) {
-            for (const [k, v] of Object.entries(json.dimensionReports)) {
-                store.#dimensionReports.set(k, v);
-            }
-        }
-        if (json.crossReferences) {
-            store.#crossReferences = json.crossReferences;
+        for (const [k, v] of Object.entries(validated.dimensionReports)) {
+            store.#dimensionReports.set(k, v);
         }
-        if (json.tierReflections) {
-            store.#tierReflections = json.tierReflections;
-        }
-        if (json.submittedCandidates) {
-            for (const [k, v] of Object.entries(json.submittedCandidates)) {
-                store.#submittedCandidates.set(k, v);
-            }
+        store.#crossReferences = validated.crossReferences;
+        store.#tierReflections = validated.tierReflections;
+        for (const [k, v] of Object.entries(validated.submittedCandidates)) {
+            store.#submittedCandidates.set(k, v);
         }
         return store;
     }

package/dist/lib/agent/memory/memory-flush-contract.d.ts

@@ -0,0 +1,49 @@
+/**
+ * §11.3 H3: MemoryFlushContract — 层级数据流转规约
+ *
+ * 定义 completeDimension() 保存数据的显式检查表,
+ * 确保 distill() 的结果在 ActiveContext.clear() 之前完整提取。
+ */
+import type { Finding } from './SessionStore.js';
+/** ActiveContext.distill() 的结构化返回类型 */
+export interface DistilledContext {
+    keyFindings: Array<{
+        finding: string;
+        evidence: string;
+        importance: number;
+    }>;
+    toolCallSummary: string[];
+    stats: {
+        totalRounds: number;
+        thoughtCount: number;
+        totalActions: number;
+        totalObservations: number;
+        reflectionCount: number;
+        totalDurationMs: number;
+    };
+    plan: {
+        text: string;
+        steps: Array<{
+            description: string;
+            status: string;
+            keywords: string[];
+        }>;
+        createdAtIteration: number;
+        lastUpdatedAtIteration: number;
+    } | null;
+    totalObservations: number;
+    compressedCount: number;
+}
+/** completeDimension() 执行数据保存时使用的结构化清单 */
+export interface DimensionFlushManifest {
+    /** distill() 的结果 — 总是存入 SessionStore */
+    distilled: DistilledContext;
+    /** 原始 scratchpad findings — 重要性 >= threshold 的需要转发 */
+    highPriorityFindings: Finding[];
+    /** 工具调用统计 — 用于 SessionStore.toolCallLog */
+    toolCallSummary: string[];
+    /** 是否触发向 PersistentMemory 的异步 consolidation */
+    shouldConsolidate: boolean;
+}
+/** 从 DistilledContext 提取高优先级 findings (importance >= threshold) */
+export declare function extractHighPriorityFindings(distilled: DistilledContext, threshold?: number): Finding[];

package/dist/lib/agent/memory/memory-flush-contract.js

@@ -0,0 +1,16 @@
+/**
+ * §11.3 H3: MemoryFlushContract — 层级数据流转规约
+ *
+ * 定义 completeDimension() 保存数据的显式检查表,
+ * 确保 distill() 的结果在 ActiveContext.clear() 之前完整提取。
+ */
+/** 从 DistilledContext 提取高优先级 findings (importance >= threshold) */
+export function extractHighPriorityFindings(distilled, threshold = 7) {
+    return distilled.keyFindings
+        .filter((f) => f.importance >= threshold)
+        .map((f) => ({
+        finding: f.finding,
+        evidence: f.evidence,
+        importance: f.importance,
+    }));
+}

package/dist/lib/agent/memory/session-store-schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * SessionStore 序列化校验
+ *
+ * `SessionStore.fromJSON()` 的反序列化入口，对边界数据做轻量类型校验。
+ *
+ * @module agent/memory/session-store-schema
+ */
+import type { CandidateSummary, CrossReference, DimensionReport, TierReflection, WorkingMemoryDistilled } from './SessionStore.js';
+export interface SessionStoreSerialized {
+    dimensionReports: Record<string, DimensionReport>;
+    crossReferences: CrossReference[];
+    tierReflections: TierReflection[];
+    submittedCandidates: Record<string, CandidateSummary[]>;
+    projectContext: Record<string, unknown>;
+    workingMemory?: WorkingMemoryDistilled;
+}
+/**
+ * 校验反序列化数据的关键字段类型，返回类型安全的结构。
+ */
+export declare function validateSessionStoreShape(raw: Record<string, unknown>): SessionStoreSerialized;

package/dist/lib/agent/memory/session-store-schema.js

@@ -0,0 +1,41 @@
+/**
+ * SessionStore 序列化校验
+ *
+ * `SessionStore.fromJSON()` 的反序列化入口，对边界数据做轻量类型校验。
+ *
+ * @module agent/memory/session-store-schema
+ */
+// ── Helpers ──────────────────────────────────────────────────
+function isRecord(val) {
+    return val !== null && typeof val === 'object' && !Array.isArray(val);
+}
+// ── Public API ───────────────────────────────────────────────
+/**
+ * 校验反序列化数据的关键字段类型，返回类型安全的结构。
+ */
+export function validateSessionStoreShape(raw) {
+    if (raw.dimensionReports !== undefined && !isRecord(raw.dimensionReports)) {
+        throw new Error('SessionStore schema: dimensionReports must be a Record');
+    }
+    if (raw.crossReferences !== undefined && !Array.isArray(raw.crossReferences)) {
+        throw new Error('SessionStore schema: crossReferences must be an array');
+    }
+    if (raw.tierReflections !== undefined && !Array.isArray(raw.tierReflections)) {
+        throw new Error('SessionStore schema: tierReflections must be an array');
+    }
+    if (raw.submittedCandidates !== undefined && !isRecord(raw.submittedCandidates)) {
+        throw new Error('SessionStore schema: submittedCandidates must be a Record');
+    }
+    return {
+        dimensionReports: raw.dimensionReports ?? {},
+        crossReferences: raw.crossReferences ?? [],
+        tierReflections: raw.tierReflections ?? [],
+        submittedCandidates: raw.submittedCandidates ?? {},
+        projectContext: isRecord(raw.projectContext)
+            ? raw.projectContext
+            : {},
+        workingMemory: isRecord(raw.workingMemory)
+            ? raw.workingMemory
+            : undefined,
+    };
+}

package/dist/lib/agent/presets.d.ts

@@ -19,7 +19,7 @@
  *
  * @module presets
  */
-import { insightGateEvaluator } from './domain/insight-gate.js';
+import { evolutionGateEvaluator, insightGateEvaluator } from './domain/insight-gate.js';
 import { producerRejectionGateEvaluator } from './domain/insight-producer.js';
 import { BudgetPolicy, QualityGatePolicy, SafetyPolicy } from './policies.js';
 import { type Strategy } from './strategies.js';
@@ -168,6 +168,50 @@ export declare const PRESETS: Readonly<{
             enabled: boolean;
         };
     };
+    evolution: {
+        name: string;
+        description: string;
+        capabilities: string[];
+        strategy: {
+            type: string;
+            maxRetries: number;
+            stages: ({
+                name: string;
+                capabilities: string[];
+                budget: {
+                    temperature: number;
+                    timeoutMs: number;
+                    maxIterations: number;
+                    searchBudget: number;
+                    searchBudgetGrace: number;
+                    maxSubmits: number;
+                    softSubmitLimit: number;
+                    idleRoundsToExit: number;
+                };
+                systemPrompt: string;
+                promptBuilder: (ctx: Record<string, unknown>) => string;
+                gate?: undefined;
+            } | {
+                name: string;
+                gate: {
+                    evaluator: typeof evolutionGateEvaluator;
+                    maxRetries: number;
+                };
+                capabilities?: undefined;
+                budget?: undefined;
+                systemPrompt?: undefined;
+                promptBuilder?: undefined;
+            })[];
+        };
+        policies: ((config?: PolicyFactoryConfig) => BudgetPolicy)[];
+        persona: {
+            role: string;
+            description: string;
+        };
+        memory: {
+            enabled: boolean;
+        };
+    };
     lark: {
         name: string;
         description: string;
@@ -323,6 +367,50 @@ declare const _default: {
                 enabled: boolean;
             };
         };
+        evolution: {
+            name: string;
+            description: string;
+            capabilities: string[];
+            strategy: {
+                type: string;
+                maxRetries: number;
+                stages: ({
+                    name: string;
+                    capabilities: string[];
+                    budget: {
+                        temperature: number;
+                        timeoutMs: number;
+                        maxIterations: number;
+                        searchBudget: number;
+                        searchBudgetGrace: number;
+                        maxSubmits: number;
+                        softSubmitLimit: number;
+                        idleRoundsToExit: number;
+                    };
+                    systemPrompt: string;
+                    promptBuilder: (ctx: Record<string, unknown>) => string;
+                    gate?: undefined;
+                } | {
+                    name: string;
+                    gate: {
+                        evaluator: typeof evolutionGateEvaluator;
+                        maxRetries: number;
+                    };
+                    capabilities?: undefined;
+                    budget?: undefined;
+                    systemPrompt?: undefined;
+                    promptBuilder?: undefined;
+                })[];
+            };
+            policies: ((config?: PolicyFactoryConfig) => BudgetPolicy)[];
+            persona: {
+                role: string;
+                description: string;
+            };
+            memory: {
+                enabled: boolean;
+            };
+        };
         lark: {
             name: string;
             description: string;

package/dist/lib/agent/presets.js

@@ -21,7 +21,8 @@
  */
 // v3.0: 导入 Insight 领域函数 (domain/ 模块)
 import { ANALYST_BUDGET, ANALYST_SYSTEM_PROMPT, buildAnalystPrompt, } from './domain/insight-analyst.js';
-import { buildRetryPrompt, insightGateEvaluator } from './domain/insight-gate.js';
+import { buildEvolverPrompt, EVOLVER_BUDGET, EVOLVER_SYSTEM_PROMPT, } from './domain/insight-evolver.js';
+import { buildRetryPrompt, evolutionGateEvaluator, insightGateEvaluator, } from './domain/insight-gate.js';
 import { buildProducerPromptV2, PRODUCER_BUDGET, PRODUCER_SYSTEM_PROMPT, producerRejectionGateEvaluator, } from './domain/insight-producer.js';
 import { PipelineStrategy } from './PipelineStrategy.js';
 import { BudgetPolicy, QualityGatePolicy, SafetyPolicy } from './policies.js';
@@ -81,7 +82,7 @@ export const PRESETS = Object.freeze({
                         timeoutMs: 300_000,
                     },
                     systemPrompt: ANALYST_SYSTEM_PROMPT,
-                    promptBuilder: (ctx) => buildAnalystPrompt(ctx.dimConfig, ctx.projectInfo, ctx.dimContext, ctx.sessionStore, ctx.semanticMemory, ctx.codeEntityGraph),
+                    promptBuilder: (ctx) => buildAnalystPrompt(ctx.dimConfig, ctx.projectInfo, ctx.dimContext, ctx.sessionStore, ctx.semanticMemory, ctx.codeEntityGraph, ctx.rescanContext, ctx.panorama, ctx.evidenceStarters, ctx.gateArtifact),
                     retryPromptBuilder: (retryCtx, _origPrompt, prev) => {
                         const prevAnalysis = prev.analyze?.reply || '';
                         const retryHint = buildRetryPrompt(retryCtx.reason ?? '');
@@ -106,7 +107,7 @@ export const PRESETS = Object.freeze({
                     budget: { ...PRODUCER_BUDGET, temperature: 0.3, timeoutMs: 180_000 },
                     systemPrompt: PRODUCER_SYSTEM_PROMPT,
                     promptBuilder: (ctx) => buildProducerPromptV2(ctx.gateArtifact, // 来自 quality_gate 的 AnalysisArtifact
-                    ctx.dimConfig, ctx.projectInfo),
+                    ctx.dimConfig, ctx.projectInfo, ctx.rescanContext, ctx.panorama),
                     // 拒绝率过高时: 缩减预算 + 特定修复 prompt (对齐旧 ProducerAgent 的 rejection retry)
                     retryBudget: { maxIterations: 5, temperature: 0.3, timeoutMs: 120_000 },
                     retryPromptBuilder: (retryCtx, _origPrompt, prev) => {
@@ -129,7 +130,7 @@ export const PRESETS = Object.freeze({
 2. content.markdown 字段 ≥ 200 字符，含代码块 (\`\`\`)
 3. content.rationale 必填 — 设计原理说明（为什么这样设计）
 4. 包含来源标注 (来源: FileName.m:行号)
-5. 标题使用项目真实类名
+5. 标题使用项目真实类名，不以项目名开头
 6. 必填: trigger (@kebab-case)、kind (rule/pattern/fact)、doClause (英文祈使句)`;
                     },
                     skipOnDegrade: true,
@@ -150,7 +151,7 @@ export const PRESETS = Object.freeze({
                 maxIterations: config?.maxIterations ?? 24,
                 maxTokens: config?.maxTokens ?? 4096,
                 temperature: config?.temperature ?? 0.3,
-                timeoutMs: config?.timeoutMs ?? 600_000,
+                timeoutMs: config?.timeoutMs ?? 3_600_000,
             }),
             (config) => new QualityGatePolicy({
                 minEvidenceLength: config?.minEvidenceLength ?? 500,
@@ -166,6 +167,53 @@ export const PRESETS = Object.freeze({
             enabled: false, // 无状态 worker
         },
     },
+    // ─── evolution: 衰退 Recipe 进化决策 ─────────
+    evolution: {
+        name: '进化',
+        description: '审查衰退 Recipe，决定进化（supersede）、废弃或跳过。Evolve→EvolutionGate。',
+        capabilities: ['evolution_analysis'],
+        strategy: {
+            type: 'pipeline',
+            maxRetries: 1,
+            stages: [
+                // ── Phase 1: Evolver ──
+                {
+                    name: 'evolve',
+                    capabilities: ['evolution_analysis'],
+                    budget: {
+                        ...EVOLVER_BUDGET,
+                        temperature: 0.3,
+                        timeoutMs: 180_000,
+                    },
+                    systemPrompt: EVOLVER_SYSTEM_PROMPT,
+                    promptBuilder: (ctx) => buildEvolverPrompt(null, null, ctx),
+                },
+                // ── Phase 2: Evolution Gate ──
+                {
+                    name: 'evolution_gate',
+                    gate: {
+                        evaluator: evolutionGateEvaluator,
+                        maxRetries: 1,
+                    },
+                },
+            ],
+        },
+        policies: [
+            (config) => new BudgetPolicy({
+                maxIterations: config?.maxIterations ?? 16,
+                maxTokens: config?.maxTokens ?? 4096,
+                temperature: config?.temperature ?? 0.3,
+                timeoutMs: config?.timeoutMs ?? 180_000,
+            }),
+        ],
+        persona: {
+            role: 'analyst',
+            description: '知识进化专家',
+        },
+        memory: {
+            enabled: false,
+        },
+    },
     // ─── lark: 飞书知识管理对话 ─────────────
     lark: {
         name: '飞书对话',