autosnippet 3.3.7 → 3.3.8

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

@@ -20,27 +20,24 @@ const SILENT_LOGGER = {
 export class PanoramaScanner {
     #projectRoot;
     #container;
+    #entityRepo;
+    #edgeRepo;
     #logger;
     #hasScanned = false;
     constructor(opts) {
         this.#projectRoot = opts.projectRoot;
         this.#container = opts.container;
+        this.#entityRepo = opts.entityRepo;
+        this.#edgeRepo = opts.edgeRepo;
         this.#logger = opts.logger ?? SILENT_LOGGER;
     }
     /**
      * 检测 DB 中是否已有该项目的 code_entities 数据
      */
-    hasData() {
+    async hasData() {
         try {
-            const db = this.#container.get('database');
-            const rawDb = db?.getDb ? db.getDb() : db;
-            if (!rawDb?.prepare) {
-                return false;
-            }
-            const row = rawDb
-                .prepare(`SELECT COUNT(*) as cnt FROM code_entities WHERE project_root = ?`)
-                .get(this.#projectRoot);
-            return (row?.cnt ?? 0) > 0;
+            const cnt = await this.#entityRepo.getEntityCount(this.#projectRoot);
+            return cnt > 0;
         }
         catch {
             return false;
@@ -51,7 +48,7 @@ export class PanoramaScanner {
      * 幂等：扫描过一次后不再重复（重启进程或手动 reset 可重新触发）。
      */
     async ensureData() {
-        if (this.#hasScanned || this.hasData()) {
+        if (this.#hasScanned || (await this.hasData())) {
             return null;
         }
         return this.scan();
@@ -135,7 +132,7 @@ export class PanoramaScanner {
             // 当 Phase 2.1 未产出 module 实体时（无 Package.swift / build.gradle 等），
             // 从已有 code_entities 按顶层目录分组写入 module 实体
             if (modules === 0 && entities > 0) {
-                modules = this.#inferModulesFromDirectories();
+                modules = await this.#inferModulesFromDirectories();
             }
         }
         catch (err) {
@@ -157,25 +154,17 @@ export class PanoramaScanner {
      * 从 code_entities 中按顶层目录分组写入 module 实体 + is_part_of 边。
      * 仅在 Phase 2.1 未产出 module 时调用。
      */
-    #inferModulesFromDirectories() {
+    async #inferModulesFromDirectories() {
         try {
-            const db = this.#container.get('database');
-            const rawDb = db?.getDb ? db.getDb() : db;
-            if (!rawDb?.prepare) {
-                return 0;
-            }
             // 查询所有非 module 实体的文件路径
-            const rows = rawDb
-                .prepare(`SELECT DISTINCT entity_id, file_path FROM code_entities
-           WHERE project_root = ? AND file_path IS NOT NULL AND entity_type != 'module'`)
-                .all(this.#projectRoot);
+            const rows = await this.#entityRepo.findDistinctEntityIdsWithFilePath(this.#projectRoot);
             if (rows.length === 0) {
                 return 0;
             }
             // 按顶层目录分组
             const groups = new Map();
             for (const row of rows) {
-                const filePath = row.file_path;
+                const filePath = row.filePath;
                 if (!filePath) {
                     continue;
                 }
@@ -189,22 +178,34 @@ export class PanoramaScanner {
                 if (!groups.has(firstDir)) {
                     groups.set(firstDir, []);
                 }
-                groups.get(firstDir).push(row.entity_id);
+                groups.get(firstDir).push(row.entityId);
             }
             if (groups.size === 0) {
                 return 0;
             }
-            // 写入 module 实体 + is_part_of 边
-            const insertEntity = rawDb.prepare(`INSERT OR IGNORE INTO code_entities (entity_id, name, entity_type, file_path, project_root)
-         VALUES (?, ?, 'module', NULL, ?)`);
-            const insertEdge = rawDb.prepare(`INSERT OR IGNORE INTO knowledge_edges (from_id, from_type, to_id, to_type, relation, weight)
-         VALUES (?, 'entity', ?, 'module', 'is_part_of', 1.0)`);
+            // 写入 module 实体
+            const moduleEntities = [...groups.keys()].map((dirName) => ({
+                entityId: dirName,
+                name: dirName,
+                entityType: 'module',
+                projectRoot: this.#projectRoot,
+            }));
+            await this.#entityRepo.batchInsertIgnore(moduleEntities);
+            // 写入 is_part_of 边
+            const edges = [];
             for (const [dirName, entityIds] of groups) {
-                insertEntity.run(dirName, dirName, this.#projectRoot);
                 for (const entityId of entityIds) {
-                    insertEdge.run(entityId, dirName);
+                    edges.push({
+                        fromId: entityId,
+                        fromType: 'entity',
+                        toId: dirName,
+                        toType: 'module',
+                        relation: 'is_part_of',
+                        weight: 1.0,
+                    });
                 }
             }
+            await this.#edgeRepo.bulkInsertIgnore(edges);
             this.#logger.info(`[PanoramaScanner] Directory fallback: inferred ${groups.size} modules from top-level dirs`);
             return groups.size;
         }

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

@@ -13,13 +13,16 @@
  * @module PanoramaService
  */
 import type { SignalBus } from '../../infrastructure/signal/SignalBus.js';
-import { ModuleDiscoverer } from './ModuleDiscoverer.js';
+import type { KnowledgeEdgeRepositoryImpl } from '../../repository/knowledge/KnowledgeEdgeRepository.js';
+import type { KnowledgeRepositoryImpl } from '../../repository/knowledge/KnowledgeRepository.impl.js';
+import type { ModuleDiscoverer } from './ModuleDiscoverer.js';
 import type { PanoramaAggregator } from './PanoramaAggregator.js';
 import type { PanoramaScanner } from './PanoramaScanner.js';
-import type { CeDbLike, HealthRadar, KnowledgeGap, PanoramaModule, PanoramaResult } from './PanoramaTypes.js';
+import type { HealthRadar, KnowledgeGap, PanoramaModule, PanoramaResult } from './PanoramaTypes.js';
 export interface PanoramaServiceOptions {
     aggregator: PanoramaAggregator;
-    db: CeDbLike;
+    edgeRepo: KnowledgeEdgeRepositoryImpl;
+    knowledgeRepo: KnowledgeRepositoryImpl;
     projectRoot: string;
     scanner?: PanoramaScanner;
     moduleDiscoverer?: ModuleDiscoverer;
@@ -92,23 +95,23 @@ export declare class PanoramaService {
     /**
      * 获取项目全景概览
      */
-    getOverview(): PanoramaOverview;
+    getOverview(): Promise<PanoramaOverview>;
     /**
      * 获取单模块详情 (enriched with file groups, recipes, and summary)
      */
-    getModule(moduleName: string): PanoramaModuleDetail | null;
+    getModule(moduleName: string): Promise<PanoramaModuleDetail | null>;
     /**
      * 获取知识空白区
      */
-    getGaps(): KnowledgeGap[];
+    getGaps(): Promise<KnowledgeGap[]>;
     /**
      * 获取全景健康度
      */
-    getHealth(): PanoramaHealth;
+    getHealth(): Promise<PanoramaHealth>;
     /**
      * 获取完整 PanoramaResult（内部使用或 Bootstrap 注入）
      */
-    getResult(): PanoramaResult;
+    getResult(): Promise<PanoramaResult>;
     /**
      * 确保全景数据已就绪（无数据时自动扫描）
      * MCP handler / HTTP route 应在返回数据前调用此方法

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

@@ -12,13 +12,14 @@
  *
  * @module PanoramaService
  */
-import { ModuleDiscoverer } from './ModuleDiscoverer.js';
+import { COUNTABLE_LIFECYCLES } from '../../domain/knowledge/Lifecycle.js';
 /* ═══ Constants ═══════════════════════════════════════════ */
 const STALE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24h
 /* ═══ PanoramaService Class ═══════════════════════════════ */
 export class PanoramaService {
     #aggregator;
-    #db;
+    #edgeRepo;
+    #knowledgeRepo;
     #projectRoot;
     #scanner;
     #moduleDiscoverer;
@@ -28,11 +29,15 @@ export class PanoramaService {
     #lastOverview = null;
     constructor(opts) {
         this.#aggregator = opts.aggregator;
-        this.#db = opts.db;
+        this.#edgeRepo = opts.edgeRepo;
+        this.#knowledgeRepo = opts.knowledgeRepo;
         this.#projectRoot = opts.projectRoot;
         this.#scanner = opts.scanner ?? null;
         this.#moduleDiscoverer =
-            opts.moduleDiscoverer ?? new ModuleDiscoverer(opts.db, opts.projectRoot);
+            opts.moduleDiscoverer ??
+                (() => {
+                    throw new Error('moduleDiscoverer is required');
+                })();
         this.#signalBus = opts.signalBus ?? null;
         // Phase 2: 订阅信号标记缓存失效
         if (this.#signalBus) {
@@ -45,8 +50,8 @@ export class PanoramaService {
     /**
      * 获取项目全景概览
      */
-    getOverview() {
-        const result = this.#getOrCompute();
+    async getOverview() {
+        const result = await this.#getOrCompute();
         const isStale = Date.now() - result.computedAt > STALE_THRESHOLD_MS;
         let totalFiles = 0;
         for (const [, mod] of result.modules) {
@@ -98,8 +103,8 @@ export class PanoramaService {
     /**
      * 获取单模块详情 (enriched with file groups, recipes, and summary)
      */
-    getModule(moduleName) {
-        const result = this.#getOrCompute();
+    async getModule(moduleName) {
+        const result = await this.#getOrCompute();
         const mod = result.modules.get(moduleName);
         if (!mod) {
             return null;
@@ -109,33 +114,27 @@ export class PanoramaService {
         // File groups: group by immediate subdirectory within the module
         const fileGroups = PanoramaService.#groupFilesBySubdir(mod.files);
         // Matched recipes from DB
-        const recipes = this.#findModuleRecipes(moduleName, mod);
+        const recipes = await this.#findModuleRecipes(moduleName, mod);
         // Uncovered file count estimate
         const coveredFileCount = Math.min(recipes.length * 2, mod.fileCount); // rough heuristic
         const uncoveredFileCount = Math.max(0, mod.fileCount - coveredFileCount);
-        // Neighbors from DB edges
+        // Neighbors from edge repo
         const neighbors = [];
-        const outNeighbors = this.#db
-            .prepare(`SELECT DISTINCT to_id, weight FROM knowledge_edges
-         WHERE from_id = ? AND from_type = 'module' AND relation = 'depends_on'`)
-            .all(moduleName);
-        for (const n of outNeighbors) {
-            neighbors.push({
-                name: n.to_id,
-                direction: 'out',
-                weight: Number(n.weight ?? 1),
-            });
+        const outEdges = await this.#edgeRepo.findOutgoingByRelation(moduleName, 'depends_on');
+        const seenOut = new Set();
+        for (const e of outEdges) {
+            if (!seenOut.has(e.toId)) {
+                seenOut.add(e.toId);
+                neighbors.push({ name: e.toId, direction: 'out', weight: e.weight });
+            }
         }
-        const inNeighbors = this.#db
-            .prepare(`SELECT DISTINCT from_id, weight FROM knowledge_edges
-         WHERE to_id = ? AND to_type = 'module' AND relation = 'depends_on'`)
-            .all(moduleName);
-        for (const n of inNeighbors) {
-            neighbors.push({
-                name: n.from_id,
-                direction: 'in',
-                weight: Number(n.weight ?? 1),
-            });
+        const inEdges = await this.#edgeRepo.findIncomingByRelation(moduleName, 'depends_on');
+        const seenIn = new Set();
+        for (const e of inEdges) {
+            if (!seenIn.has(e.fromId)) {
+                seenIn.add(e.fromId);
+                neighbors.push({ name: e.fromId, direction: 'in', weight: e.weight });
+            }
         }
         // Generate summary
         const summary = PanoramaService.#generateModuleSummary(mod, layerName, fileGroups, recipes, neighbors);
@@ -199,7 +198,7 @@ export class PanoramaService {
         return prefix;
     }
     /** Find recipes related to this module by category, trigger, or title match */
-    #findModuleRecipes(moduleName, mod) {
+    async #findModuleRecipes(moduleName, mod) {
         try {
             // Map refined role to typical recipe categories
             const roleCategories = {
@@ -213,31 +212,7 @@ export class PanoramaService {
                 feature: ['Feature'],
             };
             const categories = roleCategories[mod.refinedRole] ?? [];
-            // Build a LIKE query that matches module name or related categories
-            const conditions = [];
-            const params = [];
-            // Match by module name in title or trigger
-            conditions.push('(title LIKE ? OR trigger LIKE ?)');
-            params.push(`%${moduleName}%`, `%${moduleName}%`);
-            // Match by category
-            for (const cat of categories) {
-                conditions.push('category = ?');
-                params.push(cat);
-            }
-            const whereClause = conditions.join(' OR ');
-            const rows = this.#db
-                .prepare(`SELECT id, title, trigger, kind FROM knowledge_entries
-           WHERE lifecycle IN ('active', 'staging', 'pending')
-             AND (${whereClause})
-           ORDER BY lifecycle ASC
-           LIMIT 20`)
-                .all(...params);
-            return rows.map((r) => ({
-                id: String(r.id ?? ''),
-                title: String(r.title ?? ''),
-                trigger: String(r.trigger ?? ''),
-                kind: String(r.kind ?? ''),
-            }));
+            return await this.#knowledgeRepo.findModuleRecipes(COUNTABLE_LIFECYCLES, moduleName, categories, 20);
         }
         catch {
             return [];
@@ -280,15 +255,15 @@ export class PanoramaService {
     /**
      * 获取知识空白区
      */
-    getGaps() {
-        const result = this.#getOrCompute();
+    async getGaps() {
+        const result = await this.#getOrCompute();
         return result.gaps;
     }
     /**
      * 获取全景健康度
      */
-    getHealth() {
-        const result = this.#getOrCompute();
+    async getHealth() {
+        const result = await this.#getOrCompute();
         let totalCoupling = 0;
         let count = 0;
         for (const [, mod] of result.modules) {
@@ -318,8 +293,8 @@ export class PanoramaService {
     /**
      * 获取完整 PanoramaResult（内部使用或 Bootstrap 注入）
      */
-    getResult() {
-        return this.#getOrCompute();
+    async getResult() {
+        return await this.#getOrCompute();
     }
     /**
      * 确保全景数据已就绪（无数据时自动扫描）
@@ -356,13 +331,13 @@ export class PanoramaService {
         }
     }
     /* ─── Cache + Compute ───────────────────────────── */
-    #getOrCompute() {
+    async #getOrCompute() {
         if (this.#cache) {
             return this.#cache;
         }
-        const candidates = this.#moduleDiscoverer.discover();
-        const configLayers = this.#moduleDiscoverer.readConfigLayers();
-        this.#cache = this.#aggregator.compute(candidates, { configLayers });
+        const candidates = await this.#moduleDiscoverer.discover();
+        const configLayers = await this.#moduleDiscoverer.readConfigLayers();
+        this.#cache = await this.#aggregator.compute(candidates, { configLayers });
         return this.#cache;
     }
 }

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

@@ -83,6 +83,8 @@ export interface LayerViolation {
 export interface LayerHierarchy {
     levels: LayerLevel[];
     violations: LayerViolation[];
+    /** 是否基于配置文件（如 Boxfile）声明的层级推断（而非纯拓扑） */
+    configBased?: boolean;
 }
 export interface CyclicDependency {
     cycle: string[];
@@ -154,6 +156,7 @@ export interface CallFlowSummary {
     dataProducers: string[];
     dataConsumers: string[];
 }
+export type { ModuleRole } from '#shared/LanguageProfiles.js';
 export interface PanoramaResult {
     modules: Map<string, PanoramaModule>;
     layers: LayerHierarchy;

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

@@ -13,8 +13,11 @@
  *
  * @module RoleRefiner
  */
-import type { CeDbLike } from './PanoramaTypes.js';
-export type ModuleRole = 'core' | 'service' | 'ui' | 'networking' | 'storage' | 'test' | 'app' | 'routing' | 'utility' | 'model' | 'auth' | 'config' | 'feature';
+import type { BootstrapRepositoryImpl } from '../../repository/bootstrap/BootstrapRepository.js';
+import type { CodeEntityRepositoryImpl } from '../../repository/code/CodeEntityRepository.js';
+import type { KnowledgeEdgeRepositoryImpl } from '../../repository/knowledge/KnowledgeEdgeRepository.js';
+import type { ModuleRole } from './PanoramaTypes.js';
+export type { ModuleRole } from './PanoramaTypes.js';
 export interface RoleSignal {
     role: ModuleRole;
     confidence: number;
@@ -38,13 +41,13 @@ export interface ModuleCandidate {
 }
 export declare class RoleRefiner {
     #private;
-    constructor(db: CeDbLike, projectRoot: string);
+    constructor(bootstrapRepo: BootstrapRepositoryImpl, entityRepo: CodeEntityRepositoryImpl, edgeRepo: KnowledgeEdgeRepositoryImpl, projectRoot: string);
     /**
      * 精化单个模块的角色
      */
-    refineRole(module: ModuleCandidate): RefinedRole;
+    refineRole(module: ModuleCandidate): Promise<RefinedRole>;
     /**
      * 批量精化所有模块
      */
-    refineAll(modules: ModuleCandidate[]): Map<string, RefinedRole>;
+    refineAll(modules: ModuleCandidate[]): Promise<Map<string, RefinedRole>>;
 }