autosnippet 3.3.5 → 3.3.6

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

@@ -5,17 +5,7 @@ export declare const PROJECT_ROOT: string;
 export declare const SKILLS_DIR: string;
 /** 项目级 skills 目录 */
 export declare const PROJECT_SKILLS_DIR: string;
-export declare const DIMENSION_DISPLAY_GROUP: {
-    architecture: string;
-    'code-pattern': string;
-    'project-profile': string;
-    'best-practice': string;
-    'code-standard': string;
-    'event-and-data-flow': string;
-    'objc-deep-scan': string;
-    'category-scan': string;
-    'agent-guidelines': string;
-};
+export { DIMENSION_DISPLAY_GROUP } from '#domain/dimension/DimensionRegistry.js';
 /**
  * 基于维度元数据 (dimensionMeta) 检查提交是否合法
  * @param dimensionMeta
@@ -25,10 +15,7 @@ export declare const DIMENSION_DISPLAY_GROUP: {
 export declare function checkDimensionType(dimensionMeta: DimensionMeta, params: Record<string, unknown>, logger?: {
     info(msg: string, ...args: unknown[]): void;
     warn(msg: string, ...args: unknown[]): void;
-} | null): {
-    status: string;
-    reason: string;
-} | null;
+} | null): null;
 /** DI container service lookup (returns dynamic service instances) */
 export interface ServiceContainer {
     get(name: string): any;
@@ -67,3 +54,8 @@ export interface ToolSchemaEntry {
     description: string;
     parameters: Record<string, unknown>;
 }
+/**
+ * 剥离标题中冗余的项目名前缀（如 "BiliDili 分页控制器" → "分页控制器"）
+ * 同一知识库内所有条目都属于同一项目，标题中重复项目名没有信息量。
+ */
+export declare function stripProjectNamePrefix(title: string, projectRoot: string): string;

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

@@ -6,18 +6,8 @@ export const PROJECT_ROOT = PACKAGE_ROOT;
 export const SKILLS_DIR = _SKILLS_DIR;
 /** 项目级 skills 目录 */
 export const PROJECT_SKILLS_DIR = path.resolve(PACKAGE_ROOT, '.autosnippet', 'skills');
-// Bootstrap 维度展示分组 — 将 9 个细粒度维度合并为 4 个展示组
-export const DIMENSION_DISPLAY_GROUP = {
-    architecture: 'architecture', // → 架构与设计
-    'code-pattern': 'architecture', // → 架构与设计
-    'project-profile': 'architecture', // → 架构与设计
-    'best-practice': 'best-practice', // → 规范与实践
-    'code-standard': 'best-practice', // → 规范与实践
-    'event-and-data-flow': 'event-and-data-flow', // → 事件与数据流
-    'objc-deep-scan': 'objc-deep-scan', // → 深度扫描
-    'category-scan': 'objc-deep-scan', // → 深度扫描
-    'agent-guidelines': 'agent-guidelines', // skill-only
-};
+// Bootstrap 维度展示分组 — 从 DimensionRegistry 自动生成
+export { DIMENSION_DISPLAY_GROUP } from '#domain/dimension/DimensionRegistry.js';
 /**
  * 基于维度元数据 (dimensionMeta) 检查提交是否合法
  * @param dimensionMeta
@@ -25,15 +15,7 @@ export const DIMENSION_DISPLAY_GROUP = {
  * @returns | null} 不合法返回 rejected，合法返回 null
  */
 export function checkDimensionType(dimensionMeta, params, logger) {
-    // 1. Skill-only 维度不允许提交 Candidate
-    if (dimensionMeta.outputType === 'skill') {
-        logger?.info(`[submit_knowledge] ✗ rejected — dimension "${dimensionMeta.id}" is skill-only, cannot submit candidates`);
-        return {
-            status: 'rejected',
-            reason: `当前维度 "${dimensionMeta.id}" 的输出类型为 skill-only，不允许调用 submit_knowledge。请只在最终回复中提供 dimensionDigest JSON。`,
-        };
-    }
-    // 2. knowledgeType 校验 — 不在允许列表时自动修正为第一个允许类型
+    // 1. knowledgeType 校验 — 不在允许列表时自动修正为第一个允许类型
     const allowed = dimensionMeta.allowedKnowledgeTypes || [];
     if (allowed.length > 0 && params.knowledgeType) {
         if (!allowed.includes(params.knowledgeType)) {
@@ -44,3 +26,20 @@ export function checkDimensionType(dimensionMeta, params, logger) {
     }
     return null;
 }
+/**
+ * 剥离标题中冗余的项目名前缀（如 "BiliDili 分页控制器" → "分页控制器"）
+ * 同一知识库内所有条目都属于同一项目，标题中重复项目名没有信息量。
+ */
+export function stripProjectNamePrefix(title, projectRoot) {
+    if (!title || !projectRoot) {
+        return title;
+    }
+    const projectName = path.basename(projectRoot);
+    if (!projectName || projectName.length < 2) {
+        return title;
+    }
+    // 匹配: "ProjectName 标题" / "ProjectName的标题" / "ProjectName — 标题"
+    const prefix = new RegExp(`^${projectName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*[的—–-]?\\s*`, 'i');
+    const stripped = title.replace(prefix, '');
+    return stripped.length > 0 ? stripped : title;
+}

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 {};