autosnippet 3.3.5 → 3.3.7

package/dist/lib/service/knowledge/RecipeProductionGateway.js

@@ -0,0 +1,384 @@
+/**
+ * RecipeProductionGateway — 统一 Recipe 生产入口
+ *
+ * 所有 Recipe 创建（Agent Tool / MCP / IDE Agent / Batch Import）
+ * 通过此 Gateway 的统一管道，保证前置校验一致：
+ *
+ *   1. Schema Validation (UnifiedValidator)
+ *   2. Similarity Check — 去重检测（可选跳过）
+ *   3. Consolidation Scan — 融合/重组建议（可选）
+ *   4. KnowledgeService.create() — 包含 ConfidenceRouter → staging / pending
+ *   5. Quality Scoring — 质量评分
+ *   6. Supersede Proposal — 创建替代提案
+ *   7. Audit — 统一审计
+ *
+ * @see docs/copilot/recipe-lifecycle-management.md §6
+ */
+import { UnifiedValidator } from '#domain/knowledge/UnifiedValidator.js';
+/* ═══════════════════ Gateway ═══════════════════ */
+export class RecipeProductionGateway {
+    #knowledgeService;
+    #projectRoot;
+    #logger;
+    #consolidationAdvisor;
+    #proposalRepo;
+    #findSimilarRecipes;
+    constructor(deps) {
+        this.#knowledgeService = deps.knowledgeService;
+        this.#projectRoot = deps.projectRoot;
+        this.#logger = deps.logger;
+        this.#consolidationAdvisor = deps.consolidationAdvisor ?? null;
+        this.#proposalRepo = deps.proposalRepository ?? null;
+        this.#findSimilarRecipes = deps.findSimilarRecipes ?? null;
+    }
+    /**
+     * 统一创建入口
+     *
+     * Pipeline:
+     *   1. Schema Validation (UnifiedValidator)
+     *   2. Similarity Check (除非 skipSimilarityCheck)
+     *   3. Consolidation Scan (除非 skipConsolidation)
+     *   4. KnowledgeService.create() — ConfidenceRouter → staging / pending
+     *   5. Quality Scoring
+     *   6. Supersede Proposal 创建 (if supersedes)
+     */
+    async create(request) {
+        const { source, items, options = {} } = request;
+        const userId = options.userId || this.#sourceToUserId(source);
+        const result = {
+            created: [],
+            rejected: [],
+            merged: [],
+            blocked: [],
+            duplicates: [],
+            supersedeProposal: null,
+        };
+        if (items.length === 0) {
+            return result;
+        }
+        // ── Step 1: Schema Validation ──
+        const validator = new UnifiedValidator({
+            existingTitles: options.existingTitles,
+            existingFingerprints: options.existingFingerprints,
+        });
+        const validItems = [];
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const validation = validator.validate(item, {
+                systemInjectedFields: options.systemInjectedFields,
+                skipUniqueness: options.skipUniqueness,
+            });
+            if (!validation.pass) {
+                result.rejected.push({
+                    index: i,
+                    title: item.title || '(untitled)',
+                    reason: 'validation_failed',
+                    errors: validation.errors,
+                    warnings: validation.warnings,
+                });
+                this.#logger?.info(`[Gateway] ✗ validation rejected item ${i}: ${validation.errors.join('; ')}`);
+            }
+            else {
+                validItems.push({ index: i, item });
+                // 记录已提交标题/指纹以防批量内重复
+                validator.recordSubmission(item.title, item.content?.pattern);
+            }
+        }
+        // ── Step 2: Similarity Check ──
+        let afterSimilarityItems = validItems;
+        if (!options.skipSimilarityCheck && this.#findSimilarRecipes) {
+            const threshold = options.similarityThreshold ?? 0.7;
+            afterSimilarityItems = [];
+            for (const entry of validItems) {
+                const { item, index } = entry;
+                const contentObj = item.content && typeof item.content === 'object' ? item.content : { markdown: '' };
+                const cand = {
+                    title: item.title || '',
+                    summary: item.description || '',
+                    code: contentObj.markdown || contentObj.pattern || '',
+                };
+                const similar = this.#findSimilarRecipes(this.#projectRoot, cand, {
+                    threshold: 0.5,
+                    topK: 5,
+                });
+                const hasDuplicate = similar.some((s) => s.similarity >= threshold);
+                if (hasDuplicate) {
+                    result.duplicates.push({
+                        index,
+                        title: item.title || '(untitled)',
+                        similarTo: similar,
+                    });
+                    this.#logger?.info(`[Gateway] ✗ duplicate blocked item ${index}: similarity ${similar[0]?.similarity}`);
+                }
+                else {
+                    afterSimilarityItems.push(entry);
+                }
+            }
+        }
+        // ── Step 3: Consolidation Scan ──
+        let submittableItems = afterSimilarityItems;
+        if (!options.skipConsolidation &&
+            this.#consolidationAdvisor &&
+            afterSimilarityItems.length > 0) {
+            submittableItems = [];
+            try {
+                const candidates = afterSimilarityItems.map((e) => ({
+                    title: e.item.title || '',
+                    category: e.item.category || e.item._category || '',
+                    ...e.item,
+                }));
+                const batchAdvice = this.#consolidationAdvisor.analyzeBatch(candidates);
+                for (let ai = 0; ai < batchAdvice.items.length; ai++) {
+                    const { advice } = batchAdvice.items[ai];
+                    const validEntry = afterSimilarityItems[ai];
+                    if (!validEntry) {
+                        continue;
+                    }
+                    if (advice.action === 'create') {
+                        submittableItems.push(validEntry);
+                    }
+                    else if (this.#proposalRepo) {
+                        const proposal = this.#createProposalFromAdvice(advice, validEntry.item);
+                        if (proposal) {
+                            result.merged.push({
+                                index: validEntry.index,
+                                proposalId: proposal.proposalId,
+                                type: proposal.type,
+                                targetRecipeId: proposal.targetRecipeId,
+                                targetTitle: proposal.targetTitle,
+                                status: proposal.status,
+                                expiresAt: proposal.expiresAt,
+                                message: proposal.message,
+                            });
+                        }
+                        else {
+                            // Proposal 创建失败 → blocked
+                            result.blocked.push({
+                                index: validEntry.index,
+                                title: validEntry.item.title || '(untitled)',
+                                consolidation: advice,
+                            });
+                        }
+                    }
+                    else {
+                        // 无 ProposalRepository → blocked
+                        result.blocked.push({
+                            index: validEntry.index,
+                            title: validEntry.item.title || '(untitled)',
+                            consolidation: advice,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                this.#logger?.warn(`[Gateway] ConsolidationAdvisor error, falling back to direct submit: ${err instanceof Error ? err.message : String(err)}`);
+                submittableItems = afterSimilarityItems;
+            }
+        }
+        // ── Step 4: Create via KnowledgeService ──
+        const createdIds = [];
+        for (const { item } of submittableItems) {
+            try {
+                const data = this.#prepareCreateData(item, source, userId);
+                const saved = await this.#knowledgeService.create(data, { userId });
+                result.created.push({
+                    id: saved.id,
+                    title: saved.title,
+                    lifecycle: saved.lifecycle,
+                    raw: saved,
+                });
+                createdIds.push(saved.id);
+                // ── Step 5: Quality Scoring (best effort) ──
+                try {
+                    await this.#knowledgeService.updateQuality(saved.id, { userId });
+                }
+                catch {
+                    /* best effort — 不阻塞创建流程 */
+                }
+            }
+            catch (err) {
+                result.rejected.push({
+                    index: items.indexOf(item),
+                    title: item.title || '(untitled)',
+                    reason: 'create_failed',
+                    errors: [err instanceof Error ? err.message : String(err)],
+                    warnings: [],
+                });
+                this.#logger?.warn(`[Gateway] ✗ create failed for "${item.title}": ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // ── Step 6: Supersede Proposal ──
+        if (options.supersedes && createdIds.length > 0) {
+            try {
+                // 直接使用 ProposalRepository（Gateway 不依赖 ServiceContainer）
+                if (this.#proposalRepo) {
+                    const proposal = this.#proposalRepo.create({
+                        type: 'supersede',
+                        targetRecipeId: options.supersedes,
+                        relatedRecipeIds: createdIds,
+                        confidence: 0.9,
+                        source: source === 'mcp-external' ? 'ide-agent' : 'ide-agent',
+                        description: `Supersede proposal: ${createdIds.length} new recipe(s) replace ${options.supersedes}`,
+                        evidence: [{ snapshotAt: Date.now(), newRecipeIds: createdIds }],
+                    });
+                    if (proposal) {
+                        result.supersedeProposal = { proposalId: proposal.id };
+                    }
+                }
+            }
+            catch (err) {
+                this.#logger?.warn(`[Gateway] Supersede proposal creation failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        this.#logger?.info(`[Gateway] create complete: ${result.created.length} created, ${result.rejected.length} rejected, ${result.merged.length} merged, ${result.duplicates.length} duplicates | source=${source}`);
+        return result;
+    }
+    /* ═══════════════════ Private ═══════════════════ */
+    #sourceToUserId(source) {
+        switch (source) {
+            case 'agent-tool':
+                return 'agent';
+            case 'mcp-external':
+                return 'mcp';
+            case 'ide-agent':
+                return 'ide-agent';
+            case 'batch-import':
+                return 'batch-import';
+        }
+    }
+    #prepareCreateData(item, source, _userId) {
+        const contentObj = item.content && typeof item.content === 'object'
+            ? item.content
+            : { markdown: '', pattern: '' };
+        const reasoning = item.reasoning || {
+            whyStandard: '',
+            sources: ['agent'],
+            confidence: 0.7,
+        };
+        if (Array.isArray(reasoning.sources) && reasoning.sources.length === 0) {
+            reasoning.sources = ['agent'];
+        }
+        return {
+            language: item.language || '',
+            category: item.category || item._category || 'general',
+            knowledgeType: item.knowledgeType || 'code-pattern',
+            source: item.source || this.#sourceLabel(source),
+            title: item.title || '',
+            description: item.description || '',
+            tags: item.tags || [],
+            trigger: item.trigger || '',
+            kind: item.kind || 'pattern',
+            topicHint: item.topicHint || '',
+            whenClause: item.whenClause || '',
+            doClause: item.doClause || '',
+            dontClause: item.dontClause || '',
+            coreCode: item.coreCode || contentObj.pattern || '',
+            sourceRefs: item.sourceRefs || [],
+            content: contentObj,
+            reasoning,
+            headers: item.headers || [],
+            usageGuide: item.usageGuide || '',
+            scope: item.scope || '',
+            complexity: item.complexity || '',
+            sourceFile: '',
+            agentNotes: item.agentNotes || null,
+            aiInsight: reasoning.whyStandard || item.description || null,
+        };
+    }
+    #sourceLabel(source) {
+        switch (source) {
+            case 'agent-tool':
+                return 'agent';
+            case 'mcp-external':
+                return 'mcp';
+            case 'ide-agent':
+                return 'ide-agent';
+            case 'batch-import':
+                return 'batch-import';
+        }
+    }
+    #createProposalFromAdvice(advice, item) {
+        if (!this.#proposalRepo) {
+            return null;
+        }
+        const evidence = [
+            {
+                snapshotAt: Date.now(),
+                candidateTitle: item.title,
+                candidateCategory: item.category,
+                analysisReason: advice.reason,
+                mergeDirection: advice.mergeDirection,
+            },
+        ];
+        if (advice.action === 'merge' && advice.targetRecipe) {
+            const proposal = this.#proposalRepo.create({
+                type: 'merge',
+                targetRecipeId: advice.targetRecipe.id,
+                confidence: advice.confidence,
+                source: 'ide-agent',
+                description: advice.reason,
+                evidence,
+            });
+            if (!proposal) {
+                return null;
+            }
+            return {
+                proposalId: proposal.id,
+                type: 'merge',
+                targetRecipeId: advice.targetRecipe.id,
+                targetTitle: advice.targetRecipe.title,
+                status: proposal.status,
+                expiresAt: proposal.expiresAt,
+                message: `已为「${advice.targetRecipe.title}」创建融合提案，${proposal.status === 'observing' ? '观察窗口 72h 后自动执行' : '等待开发者确认'}。`,
+            };
+        }
+        if (advice.action === 'reorganize' && advice.reorganizeTargets?.length) {
+            const target = advice.reorganizeTargets[0];
+            const proposal = this.#proposalRepo.create({
+                type: 'reorganize',
+                targetRecipeId: target.id,
+                relatedRecipeIds: advice.reorganizeTargets.slice(1).map((t) => t.id),
+                confidence: advice.confidence,
+                source: 'ide-agent',
+                description: advice.reason,
+                evidence,
+            });
+            if (!proposal) {
+                return null;
+            }
+            return {
+                proposalId: proposal.id,
+                type: 'reorganize',
+                targetRecipeId: target.id,
+                targetTitle: target.title,
+                status: proposal.status,
+                expiresAt: proposal.expiresAt,
+                message: `已为 ${advice.reorganizeTargets.length} 条 Recipe 创建重组提案，需开发者在 Dashboard 确认。`,
+            };
+        }
+        if (advice.action === 'insufficient' && advice.coveredBy?.length) {
+            const target = advice.coveredBy[0];
+            const proposal = this.#proposalRepo.create({
+                type: 'enhance',
+                targetRecipeId: target.id,
+                confidence: advice.confidence,
+                source: 'ide-agent',
+                description: advice.reason,
+                evidence,
+            });
+            if (!proposal) {
+                return null;
+            }
+            return {
+                proposalId: proposal.id,
+                type: 'enhance',
+                targetRecipeId: target.id,
+                targetTitle: target.title,
+                status: proposal.status,
+                expiresAt: proposal.expiresAt,
+                message: `候选独立价值不足，已创建增强提案建议补充到「${target.title}」。`,
+            };
+        }
+        return null;
+    }
+}

package/dist/lib/service/module/ModuleService.js

@@ -352,8 +352,10 @@ export class ModuleService {
         }
         const scannedFiles = files.map((f) => ({ name: f.name, path: f.relativePath }));
         this.#logger.info(`[ModuleService] scanTarget: ${targetName}, ${files.length} files`);
-        // 3. AI 提取
-        if (!this.#agentFactory) {
+        // 3. AI 提取 — mock 模式或无 agentFactory 时直接跳过
+        const aiManager = this.#container?.singletons
+            ?._aiProviderManager;
+        if (!this.#agentFactory || aiManager?.isMock) {
             return {
                 recipes: [],
                 scannedFiles,
@@ -375,21 +377,7 @@ export class ModuleService {
         this.#enrichRecipes(recipes);
         const result = { recipes, scannedFiles };
         if (recipes.length === 0) {
-            // 检查是否因为 AI Provider mock 导致空结果
-            try {
-                const singletons = this.#container?.singletons;
-                const aiProvider = singletons?.aiProvider;
-                if (!aiProvider || aiProvider.name === 'mock') {
-                    result.noAi = true;
-                    result.message = 'AI 未配置，已跳过智能提取。请在 .env 中设置 API Key 后重试。';
-                }
-                else {
-                    result.message = `AI 提取完成，但未发现可复用的代码模式（${targetName}, ${files.length} 个文件）`;
-                }
-            }
-            catch {
-                result.message = `AI 提取完成，但未发现可复用的代码模式（${targetName}, ${files.length} 个文件）`;
-            }
+            result.message = `AI 提取完成，但未发现可复用的代码模式（${targetName}, ${files.length} 个文件）`;
         }
         onProgress?.({
             type: 'scan:completed',
@@ -464,13 +452,15 @@ export class ModuleService {
             path: f.relativePath,
             targetName: f.targetName,
         }));
-        // 3. AI 提取 Recipes
+        // 3. AI 提取 Recipes — mock 模式跳过
         const allRecipes = [];
         const PER_BATCH_TIMEOUT = options.batchTimeout || 90000;
         const startTime = Date.now();
         const TOTAL_TIMEOUT = options.totalTimeout || 540000;
         let timedOut = false;
-        if (this.#agentFactory) {
+        const scanAiMgr = this.#container?.singletons
+            ?._aiProviderManager;
+        if (this.#agentFactory && !scanAiMgr?.isMock) {
             const BATCH_SIZE = options.batchSize || 20;
             for (let i = 0; i < allFiles.length; i += BATCH_SIZE) {
                 if (Date.now() - startTime > TOTAL_TIMEOUT) {
@@ -613,6 +603,7 @@ export class ModuleService {
             go: 'go',
             jvm: 'java',
             python: 'python',
+            customConfig: 'swift',
             generic: 'unknown',
         };
         return map[id] || 'unknown';

package/dist/lib/service/panorama/CouplingAnalyzer.d.ts

@@ -11,10 +11,18 @@ export interface CouplingMetrics {
     fanIn: number;
     fanOut: number;
 }
+export interface ExternalDepMetrics {
+    name: string;
+    fanIn: number;
+    /** 依赖此外部库的本地模块列表 */
+    dependedBy: string[];
+}
 export interface CouplingResult {
     cycles: CyclicDependency[];
     metrics: Map<string, CouplingMetrics>;
     edges: Edge[];
+    /** 外部依赖 fan-in 统计（按 fan-in 降序排列） */
+    externalDeps: ExternalDepMetrics[];
 }
 export declare class CouplingAnalyzer {
     #private;
@@ -22,6 +30,7 @@ export declare class CouplingAnalyzer {
     /**
      * 分析模块间耦合关系
      * @param moduleFiles - Map<moduleName, filePaths[]>
+     * @param externalModules - 外部模块名集合（无源码但参与依赖图）
      */
-    analyze(moduleFiles: Map<string, string[]>): CouplingResult;
+    analyze(moduleFiles: Map<string, string[]>, externalModules?: Set<string>): CouplingResult;
 }

package/dist/lib/service/panorama/CouplingAnalyzer.js

@@ -23,8 +23,9 @@ export class CouplingAnalyzer {
     /**
      * 分析模块间耦合关系
      * @param moduleFiles - Map<moduleName, filePaths[]>
+     * @param externalModules - 外部模块名集合（无源码但参与依赖图）
      */
-    analyze(moduleFiles) {
+    analyze(moduleFiles, externalModules) {
         // 1. 构建 file → module 反向索引
         const fileToModule = new Map();
         for (const [mod, files] of moduleFiles) {
@@ -66,9 +67,11 @@ export class CouplingAnalyzer {
                 toM.fanIn++;
             }
         }
+        // 5.5 外部依赖 fan-in 统计
+        const externalDeps = this.#computeExternalFanIn(moduleFiles, externalModules);
         // 去重边 (同 from→to 聚合)
         const dedupEdges = this.#deduplicateEdges(edges);
-        return { cycles, metrics, edges: dedupEdges };
+        return { cycles, metrics, edges: dedupEdges, externalDeps };
     }
     /* ─── Internal helpers ──────────────────────────── */
     #buildModuleEdges(moduleFiles, fileToModule) {
@@ -174,6 +177,45 @@ export class CouplingAnalyzer {
             severity: cycle.length > 3 ? 'error' : 'warning',
         }));
     }
+    /**
+     * 统计外部依赖的 fan-in（被多少本地模块依赖）
+     * 数据来源：knowledge_edges 中 from_type='module' AND to_type='module' 且 to 不在 moduleFiles 中
+     */
+    #computeExternalFanIn(moduleFiles, externalModules) {
+        const fanInMap = new Map();
+        // 从 DB 查询 module-to-module depends_on 边
+        const rows = this.#db
+            .prepare(`SELECT from_id, to_id FROM knowledge_edges
+         WHERE relation = 'depends_on' AND from_type = 'module' AND to_type = 'module'`)
+            .all();
+        for (const row of rows) {
+            const fromId = row.from_id;
+            const toId = row.to_id;
+            // from 必须是本地模块, to 必须是外部模块
+            if (!moduleFiles.has(fromId)) {
+                continue;
+            }
+            if (moduleFiles.has(toId)) {
+                continue;
+            }
+            // 如果提供了 externalModules 集合，检查 toId 是否在其中
+            if (externalModules && !externalModules.has(toId)) {
+                continue;
+            }
+            if (!fanInMap.has(toId)) {
+                fanInMap.set(toId, new Set());
+            }
+            fanInMap.get(toId).add(fromId);
+        }
+        // 转换为排序数组（按 fan-in 降序）
+        return [...fanInMap.entries()]
+            .map(([name, deps]) => ({
+            name,
+            fanIn: deps.size,
+            dependedBy: [...deps].sort(),
+        }))
+            .sort((a, b) => b.fanIn - a.fanIn);
+    }
     #deduplicateEdges(edges) {
         const key = (e) => `${e.from}→${e.to}`;
         const map = new Map();

package/dist/lib/service/panorama/DimensionAnalyzer.d.ts

@@ -1,13 +1,14 @@
 /**
  * DimensionAnalyzer — 多维度知识健康分析
  *
+ * **v2: 从统一维度注册表 (DimensionRegistry) 派生维度**
+ *
  * 灵感来源:
  *   - ISO/IEC 25010 质量模型 (8 大特性: 可靠性、安全性、可维护性…)
  *   - ThoughtWorks Tech Radar (Adopt/Trial/Assess/Hold 四环)
  *   - 雷达图/蛛网图可视化模型
  *
- * 核心思路: 不再按「模块 × 文件数」衡量覆盖，
- * 而是按「知识维度」衡量项目在各工程方向上的规范成熟度。
+ * 核心思路: 按「知识维度」衡量项目在各工程方向上的规范成熟度。
  * 某维度 Recipe 为 0 → 该方向完全空白，标示为 gap。
  *
  * @module DimensionAnalyzer
@@ -15,7 +16,7 @@
 import type { CeDbLike, HealthRadar, KnowledgeGap } from './PanoramaTypes.js';
 export declare class DimensionAnalyzer {
     #private;
-    constructor(db: CeDbLike);
+    constructor(db: CeDbLike, projectRoot: string);
     /**
      * 分析项目知识健康雷达
      *