autosnippet 3.3.6 → 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();
@@ -103,11 +100,39 @@ export class PanoramaScanner {
                     modules = phase2.depGraphData.nodes?.length ?? 0;
                 }
             }
+            // Phase 2-extra: CustomConfig 增强
+            // 当主 discoverer 不是 customConfig 时，尝试 CustomConfigDiscoverer
+            // 以获取更丰富的模块视图（混编项目常见：jvm/node/dart 获胜但模块数偏少）
+            if (phase1.discoverer && phase1.discoverer.id !== 'customConfig') {
+                try {
+                    const { CustomConfigDiscoverer } = await import('../../core/discovery/CustomConfigDiscoverer.js');
+                    const ccDiscoverer = new CustomConfigDiscoverer();
+                    const ccDetect = await ccDiscoverer.detect(this.#projectRoot);
+                    if (ccDetect.match && ccDetect.confidence >= 0.7) {
+                        await ccDiscoverer.load(this.#projectRoot);
+                        const ccTargets = await ccDiscoverer.listTargets();
+                        // 仅当 CustomConfig 发现更多模块时才采纳
+                        if (ccTargets.length > modules) {
+                            this.#logger.info(`[PanoramaScanner] CustomConfig enrichment: ${ccTargets.length} modules ` +
+                                `(primary discoverer '${phase1.discoverer.id}' found ${modules})`);
+                            const ccPhase2 = await runPhase2_DependencyGraph(ccDiscoverer, this.#container, this.#logger, 'custom-enrichment');
+                            edges += ccPhase2.depEdgesWritten;
+                            if (ccPhase2.depGraphData) {
+                                await runPhase2_1_ModuleEntities(ccPhase2.depGraphData, this.#projectRoot, this.#container, this.#logger);
+                                modules = Math.max(modules, ccPhase2.depGraphData.nodes?.length ?? 0);
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // CustomConfig 增强失败不阻塞主流程
+                }
+            }
             // Phase 2.2: 目录推断兜底
             // 当 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) {
@@ -129,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;
                 }
@@ -161,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);
@@ -187,17 +186,19 @@ export class PanoramaService {
         let prefix = paths[0];
         for (const p of paths) {
             while (!p.startsWith(prefix)) {
-                const lastSlash = prefix.lastIndexOf('/');
+                // Strip trailing slash before searching for last separator
+                const trimmed = prefix.endsWith('/') ? prefix.slice(0, -1) : prefix;
+                const lastSlash = trimmed.lastIndexOf('/');
                 if (lastSlash < 0) {
                     return '';
                 }
-                prefix = prefix.slice(0, lastSlash + 1);
+                prefix = trimmed.slice(0, lastSlash + 1);
             }
         }
         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 = {
@@ -211,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 [];
@@ -278,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) {
@@ -316,8 +293,8 @@ export class PanoramaService {
     /**
      * 获取完整 PanoramaResult（内部使用或 Bootstrap 注入）
      */
-    getResult() {
-        return this.#getOrCompute();
+    async getResult() {
+        return await this.#getOrCompute();
     }
     /**
      * 确保全景数据已就绪（无数据时自动扫描）
@@ -328,8 +305,10 @@ export class PanoramaService {
             return;
         }
         if (!this.#scanPromise) {
-            this.#scanPromise = this.#scanner.ensureData().then(() => {
-                this.#cache = null; // 扫描后清除缓存以触发重新计算
+            this.#scanPromise = this.#scanner.ensureData().then((scanResult) => {
+                if (scanResult) {
+                    this.#cache = null; // 扫描后清除缓存以触发重新计算
+                }
             });
         }
         await this.#scanPromise;
@@ -352,12 +331,13 @@ export class PanoramaService {
         }
     }
     /* ─── Cache + Compute ───────────────────────────── */
-    #getOrCompute() {
+    async #getOrCompute() {
         if (this.#cache) {
             return this.#cache;
         }
-        const candidates = this.#moduleDiscoverer.discover();
-        this.#cache = this.#aggregator.compute(candidates);
+        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

@@ -33,6 +33,40 @@ export interface PanoramaModule {
     fileCount: number;
     recipeCount: number;
     coverageRatio: number;
+    /** 模块类型: local(有源码) / external(第三方) / host(宿主应用) */
+    kind?: 'local' | 'external' | 'host';
+}
+export interface ExternalDepProfile {
+    name: string;
+    /** 被多少本地模块依赖 */
+    fanIn: number;
+    /** 依赖此外部库的本地模块列表 */
+    dependedBy: string[];
+    /** 所属层级 */
+    layer?: string;
+    /** 声明版本 */
+    version?: string;
+    /** 技术栈分类标签 */
+    category?: string;
+}
+export interface TechStackProfile {
+    /** 按类别分组的外部依赖 */
+    categories: Array<{
+        name: string;
+        deps: Array<{
+            name: string;
+            fanIn: number;
+            version?: string;
+        }>;
+    }>;
+    /** 关键外部依赖（fan-in ≥ 3 的热点） */
+    hotspots: Array<{
+        name: string;
+        fanIn: number;
+        dependedBy: string[];
+    }>;
+    /** 外部依赖总数 */
+    totalExternalDeps: number;
 }
 export interface LayerLevel {
     level: number;
@@ -49,6 +83,8 @@ export interface LayerViolation {
 export interface LayerHierarchy {
     levels: LayerLevel[];
     violations: LayerViolation[];
+    /** 是否基于配置文件（如 Boxfile）声明的层级推断（而非纯拓扑） */
+    configBased?: boolean;
 }
 export interface CyclicDependency {
     cycle: string[];
@@ -120,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;
@@ -130,5 +167,9 @@ export interface PanoramaResult {
     callFlowSummary: CallFlowSummary;
     /** 项目级活跃 recipe 总数（不限模块匹配） */
     projectRecipeCount: number;
+    /** 外部依赖概况 */
+    externalDeps: ExternalDepProfile[];
+    /** 技术栈画像 */
+    techStack: TechStackProfile | null;
     computedAt: number;
 }

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;
@@ -33,16 +36,18 @@ export interface ModuleCandidate {
     name: string;
     inferredRole: ModuleRole;
     files: string[];
+    /** 来自配置文件的层级名称（如 Boxfile 中的 layer 声明） */
+    configLayer?: string;
 }
 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>>;
 }