autosnippet 3.3.7 → 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),
             });
@@ -523,8 +538,8 @@ export class KnowledgeService {
             // 更新 Quality 值对象；同步计算 authority（0‑5）
             const qualityJson = {
                 completeness: result.dimensions.completeness,
-                adaptation: result.dimensions.metadata,
-                documentation: result.dimensions.format,
+                adaptation: result.dimensions.deliveryReady,
+                documentation: result.dimensions.contentDepth,
                 overall: result.score,
                 grade: result.grade,
             };
@@ -542,6 +557,18 @@ export class KnowledgeService {
                 });
             }
             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,
@@ -605,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,
@@ -672,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,
@@ -708,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 });
@@ -770,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;
             }
@@ -804,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', {
@@ -820,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/panorama/CouplingAnalyzer.d.ts

@@ -6,7 +6,9 @@
  *
  * @module CouplingAnalyzer
  */
-import type { CeDbLike, CyclicDependency, Edge } from './PanoramaTypes.js';
+import type { CodeEntityRepositoryImpl } from '../../repository/code/CodeEntityRepository.js';
+import type { KnowledgeEdgeRepositoryImpl } from '../../repository/knowledge/KnowledgeEdgeRepository.js';
+import type { CyclicDependency, Edge } from './PanoramaTypes.js';
 export interface CouplingMetrics {
     fanIn: number;
     fanOut: number;
@@ -26,11 +28,11 @@ export interface CouplingResult {
 }
 export declare class CouplingAnalyzer {
     #private;
-    constructor(db: CeDbLike, projectRoot: string);
+    constructor(edgeRepo: KnowledgeEdgeRepositoryImpl, entityRepo: CodeEntityRepositoryImpl, projectRoot: string);
     /**
      * 分析模块间耦合关系
      * @param moduleFiles - Map<moduleName, filePaths[]>
      * @param externalModules - 外部模块名集合（无源码但参与依赖图）
      */
-    analyze(moduleFiles: Map<string, string[]>, externalModules?: Set<string>): CouplingResult;
+    analyze(moduleFiles: Map<string, string[]>, externalModules?: Set<string>): Promise<CouplingResult>;
 }