autosnippet 3.3.4 → 3.3.6

package/dist/lib/agent/tools/evolution-tools.js

@@ -0,0 +1,161 @@
+/**
+ * evolution-tools.ts — Evolution Agent 专用工具
+ *
+ * 三个提案驱动的决策工具，供 Evolution Agent 在 rescan 时对现有 Recipe 做出明确决策：
+ *   - propose_evolution: 附加进化提案（代码已变但知识仍有价值）
+ *   - confirm_deprecation: 确认 Recipe 应被废弃（加速 deprecate 流程）
+ *   - skip_evolution: 显式跳过进化决策（仍然有效或信息不足）
+ *
+ * @module agent/tools/evolution-tools
+ */
+// ──────────────────────────────────────────────────────────
+// propose_evolution — 为现有 Recipe 附加进化提案
+// ──────────────────────────────────────────────────────────
+export const proposeEvolution = {
+    name: 'propose_evolution',
+    description: '为现有 Recipe 附加进化提案（代码已变化但知识仍有价值时使用，不创建新 Recipe）',
+    parameters: {
+        type: 'object',
+        properties: {
+            recipeId: { type: 'string', description: '目标 Recipe ID' },
+            type: {
+                type: 'string',
+                enum: ['enhance', 'correction'],
+                description: '提案类型: enhance=增强补充（代码迁移/扩展）, correction=纠正错误（代码变更导致描述不准确）',
+            },
+            description: {
+                type: 'string',
+                description: '描述发生了什么变化、为什么需要更新（人类可读）',
+            },
+            evidence: {
+                type: 'object',
+                description: '代码验证证据',
+                properties: {
+                    sourceStatus: {
+                        type: 'string',
+                        enum: ['exists', 'moved', 'modified', 'deleted'],
+                        description: '源文件状态: exists=存在但内容变化, moved=迁移到新位置, modified=签名/结构变化, deleted=已删除但有替代',
+                    },
+                    currentCode: {
+                        type: 'string',
+                        description: '当前实际代码片段（验证时读到的）',
+                    },
+                    newLocation: {
+                        type: 'string',
+                        description: '新文件路径（仅 moved 时填写）',
+                    },
+                    suggestedChanges: {
+                        type: 'string',
+                        description: '建议对 Recipe 做出的具体更新',
+                    },
+                },
+                required: ['sourceStatus', 'suggestedChanges'],
+            },
+            confidence: {
+                type: 'number',
+                description: '置信度 0.0-1.0（基于代码验证的确定程度）',
+            },
+        },
+        required: ['recipeId', 'type', 'description', 'evidence', 'confidence'],
+    },
+    handler: async (params, ctx) => {
+        const { recipeId, type, description, evidence, confidence } = params;
+        // 通过 ProposalRepository 创建提案
+        const proposalRepo = ctx.container.get('proposalRepository');
+        if (!proposalRepo) {
+            return {
+                status: 'error',
+                message: 'ProposalRepository not available',
+                recipeId,
+            };
+        }
+        const proposal = proposalRepo.create({
+            type,
+            targetRecipeId: recipeId,
+            relatedRecipeIds: [],
+            confidence: Math.max(0, Math.min(1, confidence)),
+            source: 'decay-scan',
+            description,
+            evidence: [
+                {
+                    sourceStatus: evidence.sourceStatus,
+                    currentCode: evidence.currentCode,
+                    newLocation: evidence.newLocation,
+                    suggestedChanges: evidence.suggestedChanges,
+                    verifiedBy: 'evolution-agent',
+                    verifiedAt: Date.now(),
+                },
+            ],
+        });
+        if (!proposal) {
+            return {
+                status: 'error',
+                message: 'Failed to create proposal (target recipe may not exist or duplicate proposal)',
+                recipeId,
+            };
+        }
+        return {
+            status: 'proposed',
+            proposalId: proposal.id,
+            recipeId,
+            type,
+            expiresAt: proposal.expiresAt,
+        };
+    },
+};
+// ──────────────────────────────────────────────────────────
+// confirm_deprecation — 确认 Recipe 应被废弃
+// ──────────────────────────────────────────────────────────
+export const confirmDeprecation = {
+    name: 'confirm_deprecation',
+    description: '确认一个衰退 Recipe 应被废弃（加速废弃流程，跳过观察窗口）',
+    parameters: {
+        type: 'object',
+        properties: {
+            recipeId: { type: 'string', description: '要废弃的 Recipe ID' },
+            reason: { type: 'string', description: '废弃原因（人类可读）' },
+        },
+        required: ['recipeId', 'reason'],
+    },
+    handler: async (params, ctx) => {
+        const { recipeId, reason } = params;
+        // 1. 通过 knowledgeService 将 lifecycle 转为 deprecated
+        const knowledgeService = ctx.container.get('knowledgeService');
+        const result = knowledgeService.deprecate(recipeId, reason, { userId: 'evolution-agent' });
+        // 2. 尝试解决关联的 deprecate proposal（status → executed）
+        try {
+            const proposalRepo = ctx.container.get('proposalRepository');
+            if (proposalRepo) {
+                const existing = proposalRepo.findByTarget(recipeId);
+                for (const p of existing) {
+                    if (p.type === 'deprecate') {
+                        proposalRepo.markExecuted(p.id, `Evolution Agent confirmed deprecation: ${reason}`, 'evolution-agent');
+                    }
+                }
+            }
+        }
+        catch {
+            // ProposalRepository 不可用时静默失败
+        }
+        return { status: 'deprecated', recipeId, reason, result };
+    },
+};
+// ──────────────────────────────────────────────────────────
+// skip_evolution — 显式跳过进化决策
+// ──────────────────────────────────────────────────────────
+export const skipEvolution = {
+    name: 'skip_evolution',
+    description: '显式跳过一个 Recipe 的进化决策（信息不足或不紧急，交给时限机制处理）',
+    parameters: {
+        type: 'object',
+        properties: {
+            recipeId: { type: 'string', description: '跳过的 Recipe ID' },
+            reason: { type: 'string', description: '跳过原因' },
+        },
+        required: ['recipeId', 'reason'],
+    },
+    handler: async (params, _ctx) => {
+        // 不修改 proposal 状态，仅记录决策
+        return { status: 'skipped', recipeId: params.recipeId, reason: params.reason };
+    },
+};

package/dist/lib/agent/tools/index.d.ts

@@ -6,6 +6,7 @@
 import { enrichCandidate, refineBootstrapCandidates } from './ai-analysis.js';
 import { getCategoryMap, getClassHierarchy, getClassInfo, getMethodOverrides, getPreviousAnalysis, getPreviousEvidence, getProjectOverview, getProtocolInfo, noteFinding, queryCallGraph, queryCodeGraph } from './ast-graph.js';
 import { analyzeCode, getToolDetails, knowledgeOverview, planTask, reviewMyOutput, submitWithCheck } from './composite.js';
+import { confirmDeprecation, proposeEvolution, skipEvolution } from './evolution-tools.js';
 import { getRecommendations, guardCheckCode, listGuardRules, queryViolations } from './guard.js';
 import { bootstrapKnowledgeTool, createSkillTool, graphImpactAnalysis, loadSkill, queryAuditLog, rebuildIndex, suggestSkills } from './infrastructure.js';
 import { addGraphEdge, checkDuplicate } from './knowledge-graph.js';
@@ -14,76 +15,8 @@ import { getFileSummary, listProjectStructure, readProjectFile, searchProjectCod
 import { getProjectStats, getRecipeDetail, getRelatedRecipes, searchCandidates, searchKnowledge, searchRecipes } from './query.js';
 import { collectScanRecipe } from './scan-recipe.js';
 import { getEnvironmentInfo, runSafeCommand, writeProjectFile } from './system-interaction.js';
-export { searchProjectCode, readProjectFile, listProjectStructure, getFileSummary, semanticSearchCode, searchRecipes, searchCandidates, getRecipeDetail, getProjectStats, searchKnowledge, getRelatedRecipes, enrichCandidate, refineBootstrapCandidates, listGuardRules, getRecommendations, guardCheckCode, queryViolations, checkDuplicate, addGraphEdge, submitCandidate, approveCandidate, rejectCandidate, publishRecipe, deprecateRecipe, updateRecipe, recordUsage, qualityScore, validateCandidate, getFeedbackStats, graphImpactAnalysis, rebuildIndex, queryAuditLog, loadSkill, createSkillTool, suggestSkills, bootstrapKnowledgeTool, analyzeCode, knowledgeOverview, submitWithCheck, getToolDetails, planTask, reviewMyOutput, getProjectOverview, getClassHierarchy, getClassInfo, getProtocolInfo, getMethodOverrides, getCategoryMap, getPreviousAnalysis, noteFinding, getPreviousEvidence, queryCodeGraph, queryCallGraph, collectScanRecipe, runSafeCommand, writeProjectFile, getEnvironmentInfo, };
+export { searchProjectCode, readProjectFile, listProjectStructure, getFileSummary, semanticSearchCode, searchRecipes, searchCandidates, getRecipeDetail, getProjectStats, searchKnowledge, getRelatedRecipes, enrichCandidate, refineBootstrapCandidates, listGuardRules, getRecommendations, guardCheckCode, queryViolations, checkDuplicate, addGraphEdge, submitCandidate, approveCandidate, rejectCandidate, publishRecipe, deprecateRecipe, updateRecipe, recordUsage, qualityScore, validateCandidate, getFeedbackStats, graphImpactAnalysis, rebuildIndex, queryAuditLog, loadSkill, createSkillTool, suggestSkills, bootstrapKnowledgeTool, analyzeCode, knowledgeOverview, submitWithCheck, getToolDetails, planTask, reviewMyOutput, getProjectOverview, getClassHierarchy, getClassInfo, getProtocolInfo, getMethodOverrides, getCategoryMap, getPreviousAnalysis, noteFinding, getPreviousEvidence, queryCodeGraph, queryCallGraph, collectScanRecipe, runSafeCommand, writeProjectFile, getEnvironmentInfo, proposeEvolution, confirmDeprecation, skipEvolution, };
 export declare const ALL_TOOLS: ({
-    name: string;
-    description: string;
-    parameters: {
-        type: string;
-        properties: {
-            candidateIds: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-        };
-        required: string[];
-    };
-    handler: (params: Record<string, unknown>, ctx: import("./_shared.js").ToolHandlerContext) => Promise<{
-        total: number;
-        needsEnrichment: number;
-        needsRecipeFields: number;
-        fullyComplete: number;
-        entries: import("../../external/mcp/handlers/types.js").EnrichResultEntry[];
-        hint: string;
-    } | {
-        success: boolean;
-        errorCode: string | null;
-        message: string;
-        data: {
-            total: number;
-            needsEnrichment: number;
-            needsRecipeFields: number;
-            fullyComplete: number;
-            entries: import("../../external/mcp/handlers/types.js").EnrichResultEntry[];
-            hint: string;
-        } | null;
-        meta: {
-            source?: string | undefined;
-            responseTimeMs?: number | undefined;
-            version: string;
-            tool?: string | undefined;
-        };
-    } | {
-        error: string;
-    }>;
-} | {
-    name: string;
-    description: string;
-    parameters: {
-        type: string;
-        properties: {
-            candidateIds: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-            userPrompt: {
-                type: string;
-                description: string;
-            };
-            dryRun: {
-                type: string;
-                description: string;
-            };
-        };
-    };
-    handler: (params: Record<string, unknown>, ctx: import("./_shared.js").ToolHandlerContext) => Promise<{}>;
-} | {
     name: string;
     description: string;
     parameters: {
@@ -397,13 +330,14 @@ export declare const ALL_TOOLS: ({
                 type: string;
                 description: string;
             };
+            supersedes: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };
     handler: (params: import("./composite.js").SubmitWithCheckParams, ctx: import("./_shared.js").ToolHandlerContext) => Promise<{
-        status: string;
-        reason: string;
-    } | {
         submitted: boolean;
         status: string;
         reason: string;
@@ -413,10 +347,19 @@ export declare const ALL_TOOLS: ({
             confidence: string;
             hint: string;
         };
+        error?: undefined;
+        similar?: undefined;
+        highestSimilarity?: undefined;
+    } | {
+        submitted: boolean;
+        reason: string;
+        error: string;
+        status?: undefined;
+        errors?: undefined;
+        warnings?: undefined;
+        _meta?: undefined;
         similar?: undefined;
         highestSimilarity?: undefined;
-        entry?: undefined;
-        error?: undefined;
     } | {
         submitted: boolean;
         reason: string;
@@ -433,37 +376,28 @@ export declare const ALL_TOOLS: ({
         status?: undefined;
         errors?: undefined;
         warnings?: undefined;
-        entry?: undefined;
         error?: undefined;
     } | {
+        _meta: {
+            confidence: string;
+            hint: string;
+        };
+        _supersedeProposal?: {
+            proposalId: string;
+        } | undefined;
         submitted: boolean;
-        entry: any;
+        entry: unknown;
         similar: {
             file: string;
             title: string;
             similarity: number;
         }[];
-        _meta: {
-            confidence: string;
-            hint: string;
-        };
         status?: undefined;
         reason?: undefined;
         errors?: undefined;
         warnings?: undefined;
-        highestSimilarity?: undefined;
         error?: undefined;
-    } | {
-        submitted: boolean;
-        reason: string;
-        error: string;
-        status?: undefined;
-        errors?: undefined;
-        warnings?: undefined;
-        _meta?: undefined;
-        similar?: undefined;
         highestSimilarity?: undefined;
-        entry?: undefined;
     }>;
 } | {
     name: string;
@@ -592,6 +526,71 @@ export declare const ALL_TOOLS: ({
         }[];
         message: string;
     }>;
+} | {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            recipeId: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            evidence: {
+                type: string;
+                description: string;
+                properties: {
+                    sourceStatus: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    currentCode: {
+                        type: string;
+                        description: string;
+                    };
+                    newLocation: {
+                        type: string;
+                        description: string;
+                    };
+                    suggestedChanges: {
+                        type: string;
+                        description: string;
+                    };
+                };
+                required: string[];
+            };
+            confidence: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: import("./evolution-tools.js").ProposeEvolutionParams, ctx: import("./_shared.js").ToolHandlerContext) => Promise<{
+        status: "error";
+        message: string;
+        recipeId: string;
+        proposalId?: undefined;
+        type?: undefined;
+        expiresAt?: undefined;
+    } | {
+        status: "proposed";
+        proposalId: string;
+        recipeId: string;
+        type: "enhance" | "correction";
+        expiresAt: number;
+        message?: undefined;
+    }>;
 } | {
     name: string;
     description: string;
@@ -1024,10 +1023,14 @@ export declare const ALL_TOOLS: ({
                 type: string;
                 description: string;
             };
+            supersedes: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };
-    handler: (params: import("./lifecycle.js").SubmitKnowledgeParams, ctx: import("./_shared.js").ToolHandlerContext) => Promise<any>;
+    handler: (params: import("./lifecycle.js").SubmitKnowledgeParams, ctx: import("./_shared.js").ToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -1850,5 +1853,73 @@ export declare const ALL_TOOLS: ({
         required: never[];
     };
     handler: (params: import("./system-interaction.js").GetEnvironmentInfoParams, ctx: import("./_shared.js").ToolHandlerContext) => Promise<import("./system-interaction.js").EnvironmentInfo>;
+} | {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            candidateIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: Record<string, unknown>, ctx: import("./_shared.js").ToolHandlerContext) => Promise<{
+        total: number;
+        needsEnrichment: number;
+        needsRecipeFields: number;
+        fullyComplete: number;
+        entries: import("../../external/mcp/handlers/types.js").EnrichResultEntry[];
+        hint: string;
+    } | {
+        success: boolean;
+        errorCode: string | null;
+        message: string;
+        data: {
+            total: number;
+            needsEnrichment: number;
+            needsRecipeFields: number;
+            fullyComplete: number;
+            entries: import("../../external/mcp/handlers/types.js").EnrichResultEntry[];
+            hint: string;
+        } | null;
+        meta: {
+            source?: string | undefined;
+            responseTimeMs?: number | undefined;
+            version: string;
+            tool?: string | undefined;
+        };
+    } | {
+        error: string;
+    }>;
+} | {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            candidateIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            userPrompt: {
+                type: string;
+                description: string;
+            };
+            dryRun: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    handler: (params: Record<string, unknown>, ctx: import("./_shared.js").ToolHandlerContext) => Promise<{}>;
 })[];
 export default ALL_TOOLS;

package/dist/lib/agent/tools/index.js

@@ -9,6 +9,8 @@ import { enrichCandidate, refineBootstrapCandidates } from './ai-analysis.js';
 import { getCategoryMap, getClassHierarchy, getClassInfo, getMethodOverrides, getPreviousAnalysis, getPreviousEvidence, getProjectOverview, getProtocolInfo, noteFinding, queryCallGraph, queryCodeGraph, } from './ast-graph.js';
 // ── 组合工具 + 元工具 (6) ──
 import { analyzeCode, getToolDetails, knowledgeOverview, planTask, reviewMyOutput, submitWithCheck, } from './composite.js';
+// ── Evolution Agent 工具 (3) ──
+import { confirmDeprecation, proposeEvolution, skipEvolution } from './evolution-tools.js';
 // ── Guard 安全类 (4) ──
 import { getRecommendations, guardCheckCode, listGuardRules, queryViolations } from './guard.js';
 // ── 基础设施类 (7) ──
@@ -54,7 +56,9 @@ queryCallGraph,
 // 扫描 Recipe 收集
 collectScanRecipe, 
 // 系统交互类
-runSafeCommand, writeProjectFile, getEnvironmentInfo, };
+runSafeCommand, writeProjectFile, getEnvironmentInfo, 
+// Evolution Agent 工具
+proposeEvolution, confirmDeprecation, skipEvolution, };
 // ── ALL_TOOLS 数组（与原始 tools.js 顺序一致）──
 export const ALL_TOOLS = [
     // 项目数据访问 (5) — 含 v10 Agent-Pull 工具
@@ -131,5 +135,9 @@ export const ALL_TOOLS = [
     getEnvironmentInfo,
     // 扫描 Recipe 收集 (1) — scanKnowledge produce 阶段专用
     collectScanRecipe,
+    // Evolution Agent 工具 (3) — 提案驱动的 Recipe 进化决策
+    proposeEvolution,
+    confirmDeprecation,
+    skipEvolution,
 ];
 export default ALL_TOOLS;

package/dist/lib/agent/tools/lifecycle.d.ts

@@ -42,6 +42,8 @@ export interface SubmitKnowledgeParams {
     usageGuide?: string;
     sourceFile?: string;
     _category?: string;
+    /** 被替代的旧 Recipe ID（进化架构入口） */
+    supersedes?: string;
     [key: string]: unknown;
 }
 export declare const submitCandidate: {
@@ -132,10 +134,14 @@ export declare const submitCandidate: {
                 type: string;
                 description: string;
             };
+            supersedes: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };
-    handler: (params: SubmitKnowledgeParams, ctx: ToolHandlerContext) => Promise<any>;
+    handler: (params: SubmitKnowledgeParams, ctx: ToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 export declare const approveCandidate: {
     name: string;