autosnippet 3.3.6 → 3.3.8

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

@@ -23,18 +23,10 @@
  * @module CodeEntityGraph
  */
 import Logger from '../../infrastructure/logging/Logger.js';
-interface CeDbLike {
-    getDb?: () => CeDbLike;
-    transaction(fn: () => void): () => void;
-    exec(sql: string): void;
-    prepare(sql: string): {
-        run(...params: unknown[]): {
-            changes: number;
-        };
-        get(...params: unknown[]): Record<string, unknown> | undefined;
-        all(...params: unknown[]): Record<string, unknown>[];
-    };
-}
+import type { CodeEntityRepositoryImpl } from '../../repository/code/CodeEntityRepository.js';
+import type { KnowledgeEdgeRepositoryImpl } from '../../repository/knowledge/KnowledgeEdgeRepository.js';
+type EntityRepoLike = Pick<CodeEntityRepositoryImpl, 'upsert' | 'batchUpsert' | 'findByEntityId' | 'findByEntityIdOnly' | 'listByType' | 'searchByName' | 'clearProject' | 'deleteByFile' | 'deleteByFileAndType' | 'countByType'>;
+type EdgeRepoLike = Pick<KnowledgeEdgeRepositoryImpl, 'upsertEdge' | 'removeEdge' | 'findOutgoing' | 'findIncoming' | 'findIncomingByRelation' | 'findOutgoingByRelation' | 'findOutgoingToId' | 'findIncomingByFromTypes' | 'findConformances' | 'findByRelation' | 'countByRelation' | 'getHotNodes' | 'countIncomingByRelation' | 'countByRelationType' | 'deleteByMetadataLike'>;
 interface AstClass {
     name: string;
     isCategory?: boolean;
@@ -85,6 +77,12 @@ interface DepGraphNode {
     id?: string;
     label?: string;
     type?: string;
+    layer?: string;
+    version?: string;
+    group?: string;
+    fullPath?: string;
+    indirect?: boolean;
+    [key: string]: unknown;
 }
 interface DepGraphData {
     nodes?: (DepGraphNode | string)[];
@@ -138,16 +136,6 @@ interface MappedEdge {
     weight: number;
     metadata: Record<string, unknown>;
 }
-interface PreparedStatements {
-    upsert: ReturnType<CeDbLike['prepare']>;
-    getEntity: ReturnType<CeDbLike['prepare']>;
-    listByType: ReturnType<CeDbLike['prepare']>;
-    clearEntities: ReturnType<CeDbLike['prepare']>;
-    addEdge: ReturnType<CeDbLike['prepare']>;
-    getCallers: ReturnType<CeDbLike['prepare']>;
-    getCallees: ReturnType<CeDbLike['prepare']>;
-    getEdge: ReturnType<CeDbLike['prepare']>;
-}
 interface SearchOptions {
     type?: string;
     limit?: number;
@@ -159,10 +147,8 @@ interface ContextAgentOptions {
 export declare class CodeEntityGraph {
     #private;
     projectRoot: string;
-    db: CeDbLike;
     log: ReturnType<typeof Logger.getInstance>;
-    stmts: PreparedStatements;
-    constructor(db: CeDbLike, options?: {
+    constructor(entityRepo: EntityRepoLike, edgeRepo: EdgeRepoLike, options?: {
         projectRoot?: string;
         logger?: ReturnType<typeof Logger.getInstance>;
     });
@@ -173,7 +159,7 @@ export declare class CodeEntityGraph {
      *
      * @param astSummary analyzeProject() 产出的 ProjectAstSummary
      */
-    populateFromAst(astSummary: ProjectAstSummary | null): GraphPopulateResult;
+    populateFromAst(astSummary: ProjectAstSummary | null): Promise<GraphPopulateResult>;
     /**
      * 从 SPM 依赖图填充模块实体 (Phase 2)
      *
@@ -182,56 +168,53 @@ export declare class CodeEntityGraph {
      *
      * @param depGraphData spm.getDependencyGraph() 产出
      */
-    populateFromSpm(depGraphData: DepGraphData | null): GraphPopulateResult;
+    populateFromSpm(depGraphData: DepGraphData | null): Promise<GraphPopulateResult>;
     /**
      * 从候选的 Relations 字段提取边写入图谱 (Phase 5/6)
      *
      * @param candidates 扁平关系数组或 Relations 对象
      */
-    populateFromCandidateRelations(candidates: CandidateWithRelations[] | null): GraphPopulateResult;
+    populateFromCandidateRelations(candidates: CandidateWithRelations[] | null): Promise<GraphPopulateResult>;
     /** 获取单个实体信息 */
-    getEntity(entityId: string, entityType?: string): MappedCodeEntity | null;
+    getEntity(entityId: string, entityType?: string): Promise<MappedCodeEntity | null>;
     /**
      * 按类型列出所有实体
      * @param entityType 'class'|'protocol'|'category'|'module'|'pattern'
      */
-    listEntities(entityType: string, limit?: number): MappedCodeEntity[];
+    listEntities(entityType: string, limit?: number): Promise<MappedCodeEntity[]>;
     /**
      * 搜索实体 (名称模糊匹配)
      * @param [options.type] 过滤类型
      */
-    searchEntities(query: string, options?: SearchOptions): MappedCodeEntity[];
+    searchEntities(query: string, options?: SearchOptions): Promise<MappedCodeEntity[]>;
     /**
      * 获取实体的所有关系边
-     * @returns }
      */
-    getEntityEdges(entityId: string, entityType: string, direction?: string): {
+    getEntityEdges(entityId: string, entityType: string, direction?: string): Promise<{
         outgoing: MappedEdge[];
         incoming: MappedEdge[];
-    };
+    }>;
     /**
      * 获取继承链 (向上遍历 inherits 边)
      * @returns 继承链 [class, parent, grandparent, ...]
      */
-    getInheritanceChain(className: string, maxDepth?: number): string[];
+    getInheritanceChain(className: string, maxDepth?: number): Promise<string[]>;
     /**
      * 获取所有子类/实现者 (向下遍历)
      * @param entityType 'class'|'protocol'
-     * @returns >}
      */
-    getDescendants(entityId: string, entityType: string, maxDepth?: number): {
+    getDescendants(entityId: string, entityType: string, maxDepth?: number): Promise<{
         id: string;
         type: string;
         depth: number;
         relation: string;
-    }[];
+    }[]>;
     /** 获取协议遵循关系 (className → 遵循的协议列表) */
-    getConformances(className: string): string[];
+    getConformances(className: string): Promise<string[]>;
     /**
      * 查找两个实体间的路径 (BFS)
-     * @returns }
      */
-    findPath(fromId: string, fromType: string, toId: string, toType: string, maxDepth?: number): {
+    findPath(fromId: string, fromType: string, toId: string, toType: string, maxDepth?: number): Promise<{
         found: boolean;
         path: {
             from: {
@@ -245,60 +228,59 @@ export declare class CodeEntityGraph {
             relation: string;
         }[];
         depth: number;
-    };
+    }>;
     /**
      * 影响分析: 修改某实体后，哪些实体可能受影响
-     * @returns >}
      */
-    getImpactRadius(entityId: string, entityType: string, maxDepth?: number): {
+    getImpactRadius(entityId: string, entityType: string, maxDepth?: number): Promise<{
         id: string;
         type: string;
         relation: string;
         depth: number;
-    }[];
+    }[]>;
     /** 项目拓扑概览 — 统计信息 + 关键度排名 */
-    getTopology(): {
-        entities: any;
-        edges: any;
+    getTopology(): Promise<{
+        entities: Record<string, number>;
+        edges: Record<string, number>;
         totalEntities: number;
         totalEdges: number;
         hotNodes: {
-            id: unknown;
-            type: unknown;
-            inDegree: unknown;
+            id: string;
+            type: string;
+            inDegree: number;
         }[];
-    };
+    }>;
     /** 生成 Agent 可用的图谱上下文 (Markdown) */
-    generateContextForAgent(options?: ContextAgentOptions): string;
+    generateContextForAgent(options?: ContextAgentOptions): Promise<string>;
     /**
      * 从解析后的调用边填充图谱 (Phase 5)
      *
      * @param callEdges
      * @param dataFlowEdges
      */
-    populateCallGraph(callEdges: CallEdge[], dataFlowEdges: DataFlowEdge[]): GraphPopulateResult;
+    populateCallGraph(callEdges: CallEdge[], dataFlowEdges: DataFlowEdge[]): Promise<GraphPopulateResult>;
     /**
      * 获取调用者 — 谁调用了这个方法？
      *
      * @param methodId "ClassName.methodName" 或 FQN
      * @returns >}
      */
-    getCallers(methodId: string, maxDepth?: number): {
+    getCallers(methodId: string, maxDepth?: number): Promise<{
         caller: string;
         depth: number;
         callType: string;
-    }[];
+    }[]>;
     /**
      * 获取被调用者 — 这个方法调用了谁？
      *
      * @param methodId "ClassName.methodName" 或 FQN
      * @returns >}
      */
-    getCallees(methodId: string, maxDepth?: number): {
+    getCallees(methodId: string, maxDepth?: number): Promise<{
         callee: string;
         depth: number;
         callType: string;
-    }[];
+    }[]>;
     /**
      * 获取方法的 Impact Radius (基于调用图)
      * — 修改此方法可能影响哪些上游方法？
@@ -306,11 +288,11 @@ export declare class CodeEntityGraph {
      * @param methodId "ClassName.methodName"
      * @returns }
      */
-    getCallImpactRadius(methodId: string): {
+    getCallImpactRadius(methodId: string): Promise<{
         directCallers: number;
         transitiveCallers: number;
         affectedFiles: string[];
-    };
+    }>;
     /**
      * 从 FQN 中提取短 Entity ID
      *
@@ -319,16 +301,16 @@ export declare class CodeEntityGraph {
      */
     _extractEntityId(fqn: string): string;
     /** 清除项目的所有代码实体 (重新 populate 前调用) */
-    clearProject(): void;
+    clearProject(): Promise<void>;
     /**
      * 增量清除 — 仅删除指定文件的 call graph 边和 method 实体
      *
      * @param filePaths 变更文件的相对路径列表
      * @returns }
      */
-    clearCallGraphForFiles(filePaths: string[] | null): {
+    clearCallGraphForFiles(filePaths: string[] | null): Promise<{
         deletedEdges: number;
         deletedEntities: number;
-    };
+    }>;
 }
 export default CodeEntityGraph;