autosnippet 3.3.6 → 3.3.8

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

@@ -14,9 +14,11 @@ import { ConflictError, NotFoundError, ValidationError } from '../../shared/erro
  */
 export class KnowledgeService {
     _confidenceRouter;
+    _edgeRepo;
     _eventBus;
     _fileWriter;
     _knowledgeGraphService;
+    _proposalRepo;
     _qualityScorer;
     _skillHooks;
     auditLogger;
@@ -33,6 +35,8 @@ export class KnowledgeService {
         this._confidenceRouter = options.confidenceRouter || null;
         this._qualityScorer = options.qualityScorer || null;
         this._eventBus = options.eventBus || null;
+        this._edgeRepo = options.edgeRepo || null;
+        this._proposalRepo = options.proposalRepo || null;
         this.logger = Logger.getInstance();
     }
     /* ═══ CRUD ══════════════════════════════════════════════ */
@@ -93,13 +97,17 @@ export class KnowledgeService {
             // 注意: staging 条目由 StagingManager.checkAndPromote() 在到期后自动转为 active。
             // autoApprovable 标记保留，供前端显示「推荐批准」徽章。
             // CursorDelivery 已支持高置信度 staging/pending 条目的交付。
+            // ── file-first: 先落盘 .md，再写 DB（文件=真相源） ──
+            // fileWriter.persist() 会设置 entry.sourceFile，
+            // 后续 repository.create() 自动包含 sourceFile 字段，无需异步回写。
+            if (this._fileWriter) {
+                this._fileWriter.persist(entry);
+            }
             const saved = await this.repository.create(entry);
             // 同步 relations → knowledge_edges
             this._syncRelationsToGraph(saved.id, saved.relations);
             // 自动发现同域条目建立 related 边（best effort, 不阻塞）
             this._autoDiscoverRelations(saved.id, saved).catch((err) => this.logger.warn('_autoDiscoverRelations error', { id: saved.id, error: err.message }));
-            // 落盘 .md 文件
-            this._persistToFile(saved);
             // 审计日志
             await this._audit('create_knowledge', saved.id, context.userId, {
                 title: saved.title,
@@ -237,13 +245,20 @@ export class KnowledgeService {
                 throw new ValidationError('No updatable fields provided');
             }
             dbUpdates.updatedAt = Math.floor(Date.now() / 1000);
+            // ── file-first: 先落盘 .md，再写 DB（文件=真相源） ──
+            if (this._fileWriter) {
+                Object.assign(_entry, dbUpdates);
+                this._fileWriter.persist(_entry);
+                // fileWriter 可能更新 sourceFile，同步到 dbUpdates
+                if (_entry.sourceFile) {
+                    dbUpdates.sourceFile = _entry.sourceFile;
+                }
+            }
             const updated = await this.repository.update(id, dbUpdates);
             // 若 relations 变更，同步到 knowledge_edges
             if (dbUpdates.relations) {
                 this._syncRelationsToGraph(id, data.relations);
             }
-            // 落盘
-            this._persistToFile(updated);
             await this._audit('update_knowledge', id, context.userId, {
                 fields: Object.keys(dbUpdates),
             });
@@ -520,17 +535,40 @@ export class KnowledgeService {
             // 为 QualityScorer 适配输入字段
             const scorerInput = this._adaptForScorer(entry);
             const result = this._qualityScorer.score(scorerInput);
-            // 更新 Quality 值对象
-            await this.repository.update(id, {
-                quality: JSON.stringify({
-                    completeness: result.dimensions.completeness,
-                    adaptation: result.dimensions.metadata,
-                    documentation: result.dimensions.format,
-                    overall: result.score,
-                    grade: result.grade,
-                }),
+            // 更新 Quality 值对象；同步计算 authority（0‑5）
+            const qualityJson = {
+                completeness: result.dimensions.completeness,
+                adaptation: result.dimensions.deliveryReady,
+                documentation: result.dimensions.contentDepth,
+                overall: result.score,
+                grade: result.grade,
+            };
+            // 当 authority 从未手动设置（仍为 0）时，从 quality.overall 自动推导
+            const currentAuthority = entry.stats?.authority ?? 0;
+            const updatePayload = {
+                quality: JSON.stringify(qualityJson),
                 updatedAt: Math.floor(Date.now() / 1000),
-            });
+            };
+            if (currentAuthority === 0 && result.score > 0) {
+                const statsObj = entry.stats?.toJSON?.() ?? (typeof entry.stats === 'object' ? { ...entry.stats } : {});
+                updatePayload.stats = JSON.stringify({
+                    ...statsObj,
+                    authority: Math.round(result.score * 5),
+                });
+            }
+            await this.repository.update(id, updatePayload);
+            // ── .md 文件同步: quality 更新后重新落盘，保持文件=真相源 ──
+            if (this._fileWriter) {
+                try {
+                    const updated = await this.repository.findById(id);
+                    if (updated) {
+                        this._fileWriter.persist(updated);
+                    }
+                }
+                catch {
+                    /* best effort — 不阻塞质量更新流程 */
+                }
+            }
             if (context.userId) {
                 await this._audit('update_knowledge_quality', id, context.userId, {
                     score: result.score,
@@ -565,6 +603,8 @@ export class KnowledgeService {
                     detail: `Lifecycle ${method} failed for ${id}`,
                 });
             }
+            // 标记操作人到最后一条 lifecycleHistory 条目
+            entry.stampLastTransition(context.userId);
             // 构建 DB 更新
             // 注意: 不在此处 JSON.stringify — repository.update() 内部
             // 通过 _entityToRow() 统一执行序列化, 传入原始值即可
@@ -592,19 +632,11 @@ export class KnowledgeService {
             if (entry.autoApprovable !== undefined) {
                 dbUpdates.autoApprovable = entry.autoApprovable ? 1 : 0;
             }
-            const updated = await this.repository.update(id, dbUpdates);
-            // 文件位置迁移（candidate ↔ recipe 目录）
+            // ── file-first: 先迁移 .md 文件，再更新 DB lifecycle（文件=真相源） ──
             if (this._fileWriter) {
-                try {
-                    this._fileWriter.moveOnLifecycleChange(updated);
-                }
-                catch (err) {
-                    this.logger.warn('moveOnLifecycleChange failed (non-blocking)', {
-                        id,
-                        error: err instanceof Error ? err.message : String(err),
-                    });
-                }
+                this._fileWriter.moveOnLifecycleChange(entry);
             }
+            const updated = await this.repository.update(id, dbUpdates);
             await this._audit(`${method}_knowledge`, id, context.userId, {
                 from: prevLifecycle,
                 to: entry.lifecycle,
@@ -659,24 +691,43 @@ export class KnowledgeService {
     }
     /**
      * 为 QualityScorer 适配输入
-     * QualityScorer 需要: title, trigger, code, language, category, summary, usageGuide, headers, tags
+     * QualityScorer v2 needs: title, trigger, description, language, category,
+     * doClause, dontClause, whenClause, coreCode, usageGuide,
+     * contentMarkdown, contentRationale, reasoningWhyStandard, reasoningSources,
+     * reasoningConfidence, source, headers, tags, views, clicks, rating
      */
     _adaptForScorer(entry) {
-        // 从 Stats 值对象提取 engagement 指标，映射到 QualityScorer 期望的 views/clicks/rating
+        // 从 Stats 值对象提取 engagement 指标
         const stats = entry.stats && typeof entry.stats === 'object'
             ? entry.stats
             : {};
+        // 从 Content 值对象提取深度字段
+        const content = entry.content && typeof entry.content === 'object'
+            ? entry.content
+            : {};
+        // 从 Reasoning 值对象提取溯源字段
+        const reasoning = entry.reasoning && typeof entry.reasoning === 'object'
+            ? entry.reasoning
+            : {};
         return {
             title: entry.title,
             trigger: entry.trigger,
-            code: entry.content?.pattern || entry.content?.markdown || '',
+            description: entry.description || '',
             language: entry.language,
             category: entry.category,
-            summary: entry.description || '',
-            usageGuide: entry.content?.markdown || entry.doClause || '',
+            doClause: entry.doClause || '',
+            dontClause: entry.dontClause || '',
+            whenClause: entry.whenClause || '',
+            coreCode: entry.coreCode || '',
+            usageGuide: entry.usageGuide || content.markdown || entry.doClause || '',
+            contentMarkdown: content.markdown || '',
+            contentRationale: content.rationale || '',
+            reasoningWhyStandard: reasoning.whyStandard || '',
+            reasoningSources: reasoning.sources || [],
+            reasoningConfidence: reasoning.confidence || 0,
+            source: entry.source || '',
             headers: entry.headers || [],
             tags: entry.tags || [],
-            // engagement: views → views, adoptions+applications → clicks, authority → rating
             views: (stats.views ?? 0) + (stats.searchHits ?? 0),
             clicks: (stats.adoptions ?? 0) + (stats.applications ?? 0) + (stats.guardHits ?? 0),
             rating: stats.authority ?? 0,
@@ -695,20 +746,22 @@ export class KnowledgeService {
         }
         try {
             const candidates = [];
-            // 仅与已发布 Recipe（active）建立关联，不与其他候选（pending）互关联
-            const activeOnly = { lifecycle: Lifecycle.ACTIVE };
-            // 按 moduleName 查同模块已发布条目
+            // 与可消费 Recipe（active/staging/evolving）建立关联
+            const consumableFilter = {
+                lifecycle: [Lifecycle.ACTIVE, Lifecycle.STAGING, Lifecycle.EVOLVING],
+            };
+            // 按 moduleName 查同模块可消费条目
             if (entry.moduleName) {
-                const sameModule = await this.repository.findWithPagination({ ...activeOnly, moduleName: entry.moduleName }, { page: 1, pageSize: 20 });
+                const sameModule = await this.repository.findWithPagination({ ...consumableFilter, moduleName: entry.moduleName }, { page: 1, pageSize: 20 });
                 for (const r of sameModule.data) {
                     if (r.id !== id) {
                         candidates.push({ target: r.id, relation: 'related', weight: 0.8 });
                     }
                 }
             }
-            // 按 category 查同类已发布条目（弱关联）
+            // 按 category 查同类可消费条目（弱关联）
             if (entry.category && candidates.length < 10) {
-                const sameCat = await this.repository.findWithPagination({ ...activeOnly, category: entry.category }, { page: 1, pageSize: 10 });
+                const sameCat = await this.repository.findWithPagination({ ...consumableFilter, category: entry.category }, { page: 1, pageSize: 10 });
                 for (const r of sameCat.data) {
                     if (r.id !== id && !candidates.some((c) => c.target === r.id)) {
                         candidates.push({ target: r.id, relation: 'related', weight: 0.4 });
@@ -757,9 +810,9 @@ export class KnowledgeService {
             return;
         }
         try {
-            gs.db
-                .prepare(`DELETE FROM knowledge_edges WHERE from_id = ? AND from_type = 'knowledge'`)
-                .run(id);
+            if (this._edgeRepo) {
+                this._edgeRepo.deleteOutgoing(id, 'knowledge');
+            }
             if (!relations || typeof relations !== 'object') {
                 return;
             }
@@ -791,12 +844,11 @@ export class KnowledgeService {
     }
     /** 删除所有关联边 */
     _removeAllEdges(id) {
-        const gs = this._knowledgeGraphService;
-        if (!gs) {
+        if (!this._edgeRepo) {
             return;
         }
         try {
-            gs.db.prepare(`DELETE FROM knowledge_edges WHERE from_id = ? OR to_id = ?`).run(id, id);
+            this._edgeRepo.deleteByEntryId(id);
         }
         catch (err) {
             this.logger.warn('Failed to remove edges', {
@@ -807,12 +859,11 @@ export class KnowledgeService {
     }
     /** 删除关联的 evolution_proposals（target_recipe_id 无 CASCADE） */
     _removeRelatedProposals(id) {
-        const gs = this._knowledgeGraphService;
-        if (!gs) {
+        if (!this._proposalRepo) {
             return;
         }
         try {
-            gs.db.prepare(`DELETE FROM evolution_proposals WHERE target_recipe_id = ?`).run(id);
+            this._proposalRepo.deleteByTargetRecipeId(id);
         }
         catch (err) {
             this.logger.warn('Failed to remove related proposals', {

package/dist/lib/service/knowledge/RecipeProductionGateway.d.ts

@@ -11,8 +11,6 @@
  *   5. Quality Scoring — 质量评分
  *   6. Supersede Proposal — 创建替代提案
  *   7. Audit — 统一审计
- *
- * @see docs/copilot/recipe-lifecycle-management.md §6
  */
 /** Lightweight log interface — avoids importing static-only Logger class. */
 interface GatewayLogger {

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

@@ -11,8 +11,6 @@
  *   5. Quality Scoring — 质量评分
  *   6. Supersede Proposal — 创建替代提案
  *   7. Audit — 统一审计
- *
- * @see docs/copilot/recipe-lifecycle-management.md §6
  */
 import { UnifiedValidator } from '#domain/knowledge/UnifiedValidator.js';
 /* ═══════════════════ Gateway ═══════════════════ */

package/dist/lib/service/knowledge/SourceRefReconciler.d.ts

@@ -10,15 +10,8 @@
  *   stale   — 路径失效，无法自动修复
  */
 import type { SignalBus } from '../../infrastructure/signal/SignalBus.js';
-interface DatabaseLike {
-    prepare(sql: string): {
-        all(...params: unknown[]): Record<string, unknown>[];
-        get(...params: unknown[]): Record<string, unknown> | undefined;
-        run(...params: unknown[]): {
-            changes: number;
-        };
-    };
-}
+import type KnowledgeRepositoryImpl from '../../repository/knowledge/KnowledgeRepository.impl.js';
+import type { RecipeSourceRefRepositoryImpl } from '../../repository/sourceref/RecipeSourceRefRepository.js';
 export interface ReconcileReport {
     /** 新插入的 sourceRef 条目 */
     inserted: number;
@@ -45,7 +38,7 @@ export interface ApplyReport {
 }
 export declare class SourceRefReconciler {
     #private;
-    constructor(projectRoot: string, db: DatabaseLike, options?: {
+    constructor(projectRoot: string, sourceRefRepo: RecipeSourceRefRepositoryImpl, knowledgeRepo: KnowledgeRepositoryImpl, options?: {
         ttlMs?: number;
         signalBus?: SignalBus;
     });
@@ -55,7 +48,7 @@ export declare class SourceRefReconciler {
      */
     reconcile(opts?: {
         force?: boolean;
-    }): ReconcileReport;
+    }): Promise<ReconcileReport>;
     /**
      * 对 stale 条目尝试 git rename 修复。
      * 使用 execFile() 安全执行 git log（防止命令注入）。
@@ -65,6 +58,5 @@ export declare class SourceRefReconciler {
      * 将 renamed 条目的 new_path 写回 Recipe .md 文件的 _reasoning.sources。
      * 完成后 status → active。
      */
-    applyRepairs(): ApplyReport;
+    applyRepairs(): Promise<ApplyReport>;
 }
-export {};

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

@@ -20,13 +20,15 @@ const execFileAsync = promisify(execFile);
 const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
 export class SourceRefReconciler {
     #projectRoot;
-    #db;
+    #sourceRefRepo;
+    #knowledgeRepo;
     #signalBus;
     #logger = Logger.getInstance();
     #ttlMs;
-    constructor(projectRoot, db, options) {
+    constructor(projectRoot, sourceRefRepo, knowledgeRepo, options) {
         this.#projectRoot = projectRoot;
-        this.#db = db;
+        this.#sourceRefRepo = sourceRefRepo;
+        this.#knowledgeRepo = knowledgeRepo;
         this.#signalBus = options?.signalBus ?? null;
         this.#ttlMs = options?.ttlMs ?? DEFAULT_TTL_MS;
     }
@@ -34,7 +36,7 @@ export class SourceRefReconciler {
      * 从 knowledge_entries.reasoning 填充 recipe_source_refs 表。
      * 对已有条目验证路径存在性，更新 status。
      */
-    reconcile(opts) {
+    async reconcile(opts) {
         const force = opts?.force ?? false;
         const report = {
             inserted: 0,
@@ -43,12 +45,13 @@ export class SourceRefReconciler {
             skipped: 0,
             recipesProcessed: 0,
         };
-        // 确保表存在（兼容未跑 migration 的场景）
-        this.#ensureTable();
+        // 确保表可访问
+        if (!this.#sourceRefRepo.isAccessible()) {
+            this.#logger.warn('SourceRefReconciler: recipe_source_refs table not accessible, skipping');
+            return report;
+        }
         // 获取所有有 reasoning 的知识条目
-        const rows = this.#db
-            .prepare(`SELECT id, reasoning FROM knowledge_entries WHERE reasoning IS NOT NULL AND reasoning != '{}'`)
-            .all();
+        const rows = await this.#knowledgeRepo.findAllIdAndReasoning();
         const now = Date.now();
         for (const row of rows) {
             let sources = [];
@@ -67,12 +70,10 @@ export class SourceRefReconciler {
             report.recipesProcessed++;
             for (const sourcePath of sources) {
                 // 检查是否已有记录
-                const existing = this.#db
-                    .prepare(`SELECT status, verified_at FROM recipe_source_refs WHERE recipe_id = ? AND source_path = ?`)
-                    .get(row.id, sourcePath);
+                const existing = this.#sourceRefRepo.findOne(row.id, sourcePath);
                 if (existing && !force) {
                     // TTL 检查：跳过近期已验证的条目
-                    if (now - existing.verified_at < this.#ttlMs) {
+                    if (now - existing.verifiedAt < this.#ttlMs) {
                         report.skipped++;
                         if (existing.status === 'active') {
                             report.active++;
@@ -89,24 +90,34 @@ export class SourceRefReconciler {
                 if (existing) {
                     // 更新已有记录
                     if (exists) {
-                        this.#db
-                            .prepare(`UPDATE recipe_source_refs SET status = 'active', new_path = NULL, verified_at = ? WHERE recipe_id = ? AND source_path = ?`)
-                            .run(now, row.id, sourcePath);
+                        this.#sourceRefRepo.upsert({
+                            recipeId: row.id,
+                            sourcePath,
+                            status: 'active',
+                            newPath: null,
+                            verifiedAt: now,
+                        });
                         report.active++;
                     }
                     else {
-                        this.#db
-                            .prepare(`UPDATE recipe_source_refs SET status = 'stale', verified_at = ? WHERE recipe_id = ? AND source_path = ?`)
-                            .run(now, row.id, sourcePath);
+                        this.#sourceRefRepo.upsert({
+                            recipeId: row.id,
+                            sourcePath,
+                            status: 'stale',
+                            verifiedAt: now,
+                        });
                         report.stale++;
                     }
                 }
                 else {
                     // 新增记录
                     const status = exists ? 'active' : 'stale';
-                    this.#db
-                        .prepare(`INSERT OR REPLACE INTO recipe_source_refs (recipe_id, source_path, status, verified_at) VALUES (?, ?, ?, ?)`)
-                        .run(row.id, sourcePath, status, now);
+                    this.#sourceRefRepo.upsert({
+                        recipeId: row.id,
+                        sourcePath,
+                        status,
+                        verifiedAt: now,
+                    });
                     report.inserted++;
                     if (exists) {
                         report.active++;
@@ -139,21 +150,15 @@ export class SourceRefReconciler {
             return;
         }
         try {
-            const staleRecipes = this.#db
-                .prepare(`SELECT recipe_id, COUNT(*) AS stale_count,
-                  (SELECT COUNT(*) FROM recipe_source_refs r2 WHERE r2.recipe_id = r.recipe_id) AS total_count
-           FROM recipe_source_refs r
-           WHERE status = 'stale'
-           GROUP BY recipe_id`)
-                .all();
+            const staleRecipes = this.#sourceRefRepo.getStaleCountsByRecipe();
             for (const row of staleRecipes) {
-                const staleRatio = row.stale_count / row.total_count;
+                const staleRatio = row.staleCount / row.totalCount;
                 this.#signalBus.send('quality', 'SourceRefReconciler', staleRatio, {
-                    target: row.recipe_id,
+                    target: row.recipeId,
                     metadata: {
                         reason: 'source_ref_stale',
-                        staleCount: row.stale_count,
-                        totalRefs: row.total_count,
+                        staleCount: row.staleCount,
+                        totalRefs: row.totalCount,
                     },
                 });
             }
@@ -169,9 +174,7 @@ export class SourceRefReconciler {
     async repairRenames() {
         const report = { renamed: 0, stillStale: 0 };
         // 获取所有 stale 条目
-        const staleRows = this.#db
-            .prepare(`SELECT recipe_id, source_path FROM recipe_source_refs WHERE status = 'stale'`)
-            .all();
+        const staleRows = this.#sourceRefRepo.findStale();
         if (staleRows.length === 0) {
             return report;
         }
@@ -179,14 +182,18 @@ export class SourceRefReconciler {
         const renameMap = await this.#getGitRenameMap();
         const now = Date.now();
         for (const row of staleRows) {
-            const newPath = renameMap.get(row.source_path);
+            const newPath = renameMap.get(row.sourcePath);
             if (newPath) {
                 // 验证 newPath 存在
                 const absNewPath = path.resolve(this.#projectRoot, newPath);
                 if (fs.existsSync(absNewPath)) {
-                    this.#db
-                        .prepare(`UPDATE recipe_source_refs SET status = 'renamed', new_path = ?, verified_at = ? WHERE recipe_id = ? AND source_path = ?`)
-                        .run(newPath, now, row.recipe_id, row.source_path);
+                    this.#sourceRefRepo.upsert({
+                        recipeId: row.recipeId,
+                        sourcePath: row.sourcePath,
+                        status: 'renamed',
+                        newPath,
+                        verifiedAt: now,
+                    });
                     report.renamed++;
                     continue;
                 }
@@ -215,29 +222,25 @@ export class SourceRefReconciler {
      * 将 renamed 条目的 new_path 写回 Recipe .md 文件的 _reasoning.sources。
      * 完成后 status → active。
      */
-    applyRepairs() {
+    async applyRepairs() {
         const report = { applied: 0, failed: 0 };
-        const renamedRows = this.#db
-            .prepare(`SELECT recipe_id, source_path, new_path FROM recipe_source_refs WHERE status = 'renamed' AND new_path IS NOT NULL`)
-            .all();
+        const renamedRows = this.#sourceRefRepo.findRenamed();
         if (renamedRows.length === 0) {
             return report;
         }
-        // 按 recipe_id 分组
+        // 按 recipeId 分组
         const byRecipe = new Map();
         for (const row of renamedRows) {
-            if (!byRecipe.has(row.recipe_id)) {
-                byRecipe.set(row.recipe_id, []);
+            if (!byRecipe.has(row.recipeId)) {
+                byRecipe.set(row.recipeId, []);
             }
-            byRecipe.get(row.recipe_id)?.push({ source_path: row.source_path, new_path: row.new_path });
+            byRecipe.get(row.recipeId)?.push({ sourcePath: row.sourcePath, newPath: row.newPath });
         }
         // 获取 recipe 的 sourceFile 以定位 .md 文件
         const now = Date.now();
         for (const [recipeId, renames] of byRecipe) {
             try {
-                const entry = this.#db
-                    .prepare(`SELECT sourceFile, reasoning FROM knowledge_entries WHERE id = ?`)
-                    .get(recipeId);
+                const entry = await this.#knowledgeRepo.findSourceFileAndReasoning(recipeId);
                 if (!entry?.sourceFile || !entry.reasoning) {
                     report.failed += renames.length;
                     continue;
@@ -260,9 +263,9 @@ export class SourceRefReconciler {
                 const sources = Array.isArray(reasoning.sources) ? [...reasoning.sources] : [];
                 let modified = false;
                 for (const rename of renames) {
-                    const idx = sources.indexOf(rename.source_path);
+                    const idx = sources.indexOf(rename.sourcePath);
                     if (idx >= 0) {
-                        sources[idx] = rename.new_path;
+                        sources[idx] = rename.newPath;
                         modified = true;
                     }
                 }
@@ -272,14 +275,10 @@ export class SourceRefReconciler {
                     // 查找 YAML frontmatter 中的 reasoning 并替换
                     const updatedReasoning = JSON.stringify(reasoning);
                     // 更新 DB reasoning 列
-                    this.#db
-                        .prepare(`UPDATE knowledge_entries SET reasoning = ?, updatedAt = ? WHERE id = ?`)
-                        .run(updatedReasoning, now, recipeId);
+                    await this.#knowledgeRepo.updateReasoning(recipeId, updatedReasoning, now);
                     // 更新 recipe_source_refs 状态
                     for (const rename of renames) {
-                        this.#db
-                            .prepare(`UPDATE recipe_source_refs SET status = 'active', source_path = ?, new_path = NULL, verified_at = ? WHERE recipe_id = ? AND source_path = ?`)
-                            .run(rename.new_path, now, recipeId, rename.source_path);
+                        this.#sourceRefRepo.replaceSourcePath(recipeId, rename.sourcePath, rename.newPath, now);
                     }
                     report.applied += renames.length;
                 }
@@ -301,25 +300,6 @@ export class SourceRefReconciler {
         return report;
     }
     /* ═══ Private helpers ═══════════════════════════════ */
-    #ensureTable() {
-        try {
-            this.#db.prepare(`SELECT 1 FROM recipe_source_refs LIMIT 1`).get();
-        }
-        catch {
-            // 表不存在，创建之
-            this.#db.exec?.(`CREATE TABLE IF NOT EXISTS recipe_source_refs (
-          recipe_id    TEXT    NOT NULL,
-          source_path  TEXT    NOT NULL,
-          status       TEXT    NOT NULL DEFAULT 'active',
-          new_path     TEXT,
-          verified_at  INTEGER NOT NULL,
-          PRIMARY KEY (recipe_id, source_path),
-          FOREIGN KEY (recipe_id) REFERENCES knowledge_entries(id) ON DELETE CASCADE
-        );
-        CREATE INDEX IF NOT EXISTS idx_rsr_path   ON recipe_source_refs(source_path);
-        CREATE INDEX IF NOT EXISTS idx_rsr_status ON recipe_source_refs(status);`);
-        }
-    }
     /**
      * 通过 git log 获取 rename 映射（旧路径 → 新路径）
      * 使用 execFile 防止命令注入

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';