autosnippet 3.3.5 → 3.3.7

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

@@ -47,6 +47,8 @@ export interface SubmitWithCheckParams {
     sourceFile?: string;
     threshold?: number;
     knowledgeType?: string;
+    /** 被替代的旧 Recipe ID（进化架构入口） */
+    supersedes?: string;
     [key: string]: unknown;
 }
 export interface PlanTaskParams {
@@ -188,13 +190,14 @@ export declare const submitWithCheck: {
                 type: string;
                 description: string;
             };
+            supersedes: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };
     handler: (params: SubmitWithCheckParams, ctx: ToolHandlerContext) => Promise<{
-        status: string;
-        reason: string;
-    } | {
         submitted: boolean;
         status: string;
         reason: string;
@@ -204,10 +207,19 @@ export declare const submitWithCheck: {
             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;
@@ -224,37 +236,28 @@ export declare const submitWithCheck: {
         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;
     }>;
 };
 /**

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

@@ -9,9 +9,8 @@
  * ──  review_my_output   元工具: 自我质量审查
  */
 import { getInternalAgentRequiredFields, getSystemInjectedFields, } from '#domain/knowledge/FieldSpec.js';
-import { UnifiedValidator } from '#domain/knowledge/UnifiedValidator.js';
 import { findSimilarRecipes } from '#service/candidate/SimilarityService.js';
-import { checkDimensionType, DIMENSION_DISPLAY_GROUP, } from './_shared.js';
+import { checkDimensionType, DIMENSION_DISPLAY_GROUP, stripProjectNamePrefix, } from './_shared.js';
 // ────────────────────────────────────────────────────────────
 // 34. analyze_code — 组合工具 (Guard + Recipe 搜索)
 // ────────────────────────────────────────────────────────────
@@ -182,13 +181,24 @@ export const submitWithCheck = {
                 enum: ['basic', 'intermediate', 'advanced'],
                 description: '复杂度',
             },
-            sourceFile: { type: 'string', description: '来源文件相对路径' },
+            sourceFile: {
+                type: 'string',
+                description: 'Recipe md 文件相对路径（由系统自动设置，无需手动填写）',
+            },
             threshold: { type: 'number', description: '相似度阈值，默认 0.7' },
+            supersedes: {
+                type: 'string',
+                description: '被替代的旧 Recipe ID。传入后将创建 supersede 提案，72h 观察窗口后自动替代。',
+            },
         },
         required: getInternalAgentRequiredFields(),
     },
     handler: async (params, ctx) => {
         const projectRoot = ctx.projectRoot;
+        // ── 标题正规化：剥离冗余的项目名前缀 ──
+        if (params.title) {
+            params.title = stripProjectNamePrefix(params.title, projectRoot);
+        }
         // ── Bootstrap 维度类型校验 ──
         const dimMeta = ctx._dimensionMeta;
         if (dimMeta && ctx.source === 'system') {
@@ -206,122 +216,111 @@ export const submitWithCheck = {
                 params.tags.push('bootstrap');
             }
         }
-        // Step 0.5: UnifiedValidator 质量验证（与 submit_knowledge 对齐）
+        // ── 系统自动设置 ──
+        const item = {
+            ...params,
+            language: ctx._projectLanguage || '',
+            category: dimMeta ? dimMeta.id : 'general',
+            knowledgeType: dimMeta?.allowedKnowledgeTypes?.[0] || params.knowledgeType || 'code-pattern',
+            source: ctx.source === 'system' ? 'bootstrap' : 'agent',
+            agentNotes: dimMeta
+                ? { dimensionId: dimMeta.id, outputType: dimMeta.outputType || 'candidate' }
+                : null,
+        };
         if (dimMeta && ctx.source === 'system') {
-            const validator = ctx._validator ||
-                new UnifiedValidator({
-                    existingTitles: ctx._submittedTitles || new Set(),
-                    existingFingerprints: ctx._submittedPatterns || new Set(),
-                });
-            const validResult = validator.validate(params, {
-                systemInjectedFields: getSystemInjectedFields(),
+            const displayGroup = DIMENSION_DISPLAY_GROUP[dimMeta.id] || dimMeta.id;
+            item.tags = [...new Set([...(item.tags || []), displayGroup])];
+        }
+        // ── 委托 RecipeProductionGateway 统一管道（含查重） ──
+        try {
+            const { RecipeProductionGateway } = await import('#service/knowledge/RecipeProductionGateway.js');
+            const gateway = new RecipeProductionGateway({
+                knowledgeService: ctx.container.get('knowledgeService'),
+                projectRoot,
+                logger: ctx.logger,
+                proposalRepository: ctx.container.get('proposalRepository') ?? null,
+                findSimilarRecipes,
             });
-            if (!validResult.pass) {
-                ctx.logger?.info(`[submit_with_check] ✗ validator rejected: ${validResult.errors.join('; ')}`);
+            const gatewayResult = await gateway.create({
+                source: 'agent-tool',
+                items: [item],
+                options: {
+                    skipSimilarityCheck: false,
+                    skipConsolidation: true,
+                    similarityThreshold: params.threshold || 0.7,
+                    supersedes: params.supersedes,
+                    existingTitles: ctx._submittedTitles,
+                    existingFingerprints: ctx._submittedPatterns,
+                    systemInjectedFields: getSystemInjectedFields(),
+                    userId: 'agent',
+                },
+            });
+            // ── 映射 Gateway 结果 → 原有返回格式 ──
+            // 验证拒绝
+            if (gatewayResult.rejected.length > 0 && gatewayResult.created.length === 0) {
+                const rej = gatewayResult.rejected[0];
+                if (rej.reason === 'validation_failed') {
+                    return {
+                        submitted: false,
+                        status: 'rejected',
+                        reason: 'validation_failed',
+                        errors: rej.errors,
+                        warnings: rej.warnings,
+                        _meta: {
+                            confidence: 'high',
+                            hint: '请根据错误信息调整内容后重新提交。',
+                        },
+                    };
+                }
+                return { submitted: false, reason: 'submit_error', error: rej.errors.join('\n') };
+            }
+            // 重复阻止
+            if (gatewayResult.duplicates.length > 0) {
+                const dup = gatewayResult.duplicates[0];
                 return {
                     submitted: false,
-                    status: 'rejected',
-                    reason: 'validation_failed',
-                    errors: validResult.errors,
-                    warnings: validResult.warnings,
+                    reason: 'duplicate_blocked',
+                    similar: dup.similarTo,
+                    highestSimilarity: dup.similarTo[0]?.similarity || 0,
                     _meta: {
                         confidence: 'high',
-                        hint: '请根据错误信息调整内容后重新提交。',
+                        hint: `发现高度相似 Recipe（相似度 ${((dup.similarTo[0]?.similarity || 0) * 100).toFixed(0)}%），已阻止提交。`,
                     },
                 };
             }
-        }
-        // Step 1: 查重
-        const threshold = params.threshold || 0.7;
-        const contentObj2 = params.content && typeof params.content === 'object'
-            ? params.content
-            : { markdown: '', pattern: '' };
-        const cand = {
-            title: params.title || '',
-            summary: params.description || '',
-            code: contentObj2.markdown || contentObj2.pattern || '',
-        };
-        const similar = findSimilarRecipes(projectRoot, cand, { threshold: 0.5, topK: 5 });
-        const hasDuplicate = similar.some((s) => s.similarity >= threshold);
-        if (hasDuplicate) {
-            return {
-                submitted: false,
-                reason: 'duplicate_blocked',
-                similar,
-                highestSimilarity: similar[0]?.similarity || 0,
-                _meta: {
-                    confidence: 'high',
-                    hint: `发现高度相似 Recipe（相似度 ${(similar[0]?.similarity * 100).toFixed(0)}%），已阻止提交。`,
-                },
-            };
-        }
-        // Step 2: 提交 — 委托给 submit_knowledge handler
-        try {
-            const knowledgeService = ctx.container.get('knowledgeService');
-            const reasoning = params.reasoning || {
-                whyStandard: '',
-                sources: ['agent'],
-                confidence: 0.7,
-            };
-            const systemFields = {
-                language: ctx._projectLanguage || '',
-                category: dimMeta
-                    ? DIMENSION_DISPLAY_GROUP[dimMeta.id] || dimMeta.id
-                    : 'general',
-                knowledgeType: dimMeta?.allowedKnowledgeTypes?.[0] || 'code-pattern',
-                source: ctx.source === 'system' ? 'bootstrap' : 'agent',
-            };
-            const data = {
-                ...systemFields,
-                title: params.title || '',
-                description: params.description || '',
-                tags: params.tags || [],
-                trigger: params.trigger || '',
-                kind: params.kind || 'pattern',
-                topicHint: params.topicHint || '',
-                whenClause: params.whenClause || '',
-                doClause: params.doClause || '',
-                dontClause: params.dontClause || '',
-                coreCode: contentObj2.pattern || '',
-                content: contentObj2,
-                reasoning,
-                // V3 扩展字段直透（与 submit_knowledge 对齐）
-                headers: params.headers || [],
-                usageGuide: params.usageGuide || '',
-                scope: params.scope || '',
-                complexity: params.complexity || '',
-                // 注意: sourceFile 由 KnowledgeFileWriter.persist() 自动设置，
-                // 不应从 AI params/reasoning.sources 取值（那是项目源文件路径，不是知识文件路径）
-                sourceFile: '',
-                // agentNotes / aiInsight（与 submit_knowledge 对齐）
-                agentNotes: dimMeta
-                    ? { dimensionId: dimMeta.id, outputType: dimMeta.outputType || 'candidate' }
-                    : null,
-                aiInsight: reasoning.whyStandard || params.description || null,
-            };
-            if (dimMeta && ctx.source === 'system') {
-                const displayGroup = DIMENSION_DISPLAY_GROUP[dimMeta.id] || dimMeta.id;
-                data.tags = [...new Set([...(data.tags || []), displayGroup])];
-            }
-            const created = await knowledgeService.create(data, { userId: 'agent' });
-            // QualityScorer 自动评分（与 submit_knowledge 对齐）
-            try {
-                await knowledgeService.updateQuality(created.id, { userId: 'agent' });
-            }
-            catch {
-                /* best effort */
+            // 成功创建
+            if (gatewayResult.created.length > 0) {
+                const created = gatewayResult.created[0];
+                const raw = created.raw;
+                const entry = typeof raw.toJSON === 'function'
+                    ? raw.toJSON()
+                    : raw;
+                // 获取低相似度匹配（如有）
+                const contentObj2 = params.content && typeof params.content === 'object'
+                    ? params.content
+                    : { markdown: '', pattern: '' };
+                const cand = {
+                    title: params.title || '',
+                    summary: params.description || '',
+                    code: contentObj2.markdown || contentObj2.pattern || '',
+                };
+                const similar = findSimilarRecipes(projectRoot, cand, { threshold: 0.5, topK: 5 });
+                return {
+                    submitted: true,
+                    entry,
+                    similar: similar.length > 0 ? similar : [],
+                    ...(gatewayResult.supersedeProposal
+                        ? { _supersedeProposal: gatewayResult.supersedeProposal }
+                        : {}),
+                    _meta: {
+                        confidence: 'high',
+                        hint: similar.length > 0
+                            ? `已提交，但有 ${similar.length} 个低相似度匹配。`
+                            : '已提交，无重复风险。',
+                    },
+                };
             }
-            return {
-                submitted: true,
-                entry: typeof created.toJSON === 'function' ? created.toJSON() : created,
-                similar: similar.length > 0 ? similar : [],
-                _meta: {
-                    confidence: 'high',
-                    hint: similar.length > 0
-                        ? `已提交，但有 ${similar.length} 个低相似度匹配。`
-                        : '已提交，无重复风险。',
-                },
-            };
+            return { submitted: false, reason: 'submit_error', error: 'No items created' };
         }
         catch (err) {
             return { submitted: false, reason: 'submit_error', error: err.message };

package/dist/lib/agent/tools/evolution-tools.d.ts

@@ -0,0 +1,145 @@
+/**
+ * evolution-tools.ts — Evolution Agent 专用工具
+ *
+ * 三个提案驱动的决策工具，供 Evolution Agent 在 rescan 时对现有 Recipe 做出明确决策：
+ *   - propose_evolution: 附加进化提案（代码已变但知识仍有价值）
+ *   - confirm_deprecation: 确认 Recipe 应被废弃（加速 deprecate 流程）
+ *   - skip_evolution: 显式跳过进化决策（仍然有效或信息不足）
+ *
+ * @module agent/tools/evolution-tools
+ */
+import type { ToolHandlerContext } from './_shared.js';
+export interface ProposeEvolutionParams {
+    recipeId: string;
+    type: 'enhance' | 'correction';
+    description: string;
+    evidence: {
+        sourceStatus: 'exists' | 'moved' | 'modified' | 'deleted';
+        currentCode?: string;
+        newLocation?: string;
+        suggestedChanges: string;
+    };
+    confidence: number;
+}
+interface ConfirmDeprecationParams {
+    recipeId: string;
+    reason: string;
+}
+interface SkipEvolutionParams {
+    recipeId: string;
+    reason: string;
+}
+export declare const proposeEvolution: {
+    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: ProposeEvolutionParams, ctx: 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;
+    }>;
+};
+export declare const confirmDeprecation: {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            recipeId: {
+                type: string;
+                description: string;
+            };
+            reason: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: ConfirmDeprecationParams, ctx: ToolHandlerContext) => Promise<{
+        status: string;
+        recipeId: string;
+        reason: string;
+        result: unknown;
+    }>;
+};
+export declare const skipEvolution: {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            recipeId: {
+                type: string;
+                description: string;
+            };
+            reason: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: SkipEvolutionParams, _ctx: ToolHandlerContext) => Promise<{
+        status: string;
+        recipeId: string;
+        reason: string;
+    }>;
+};
+export {};

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 };
+    },
+};