@optave/codegraph 3.5.0 → 3.6.0

package/src/types.ts

@@ -22,10 +22,11 @@ export type CoreSymbolKind =
   | 'enum'
   | 'trait'
   | 'record'
-  | 'module';
+  | 'module'
+  | 'namespace';
 
 /** Sub-declaration kinds (Phase 1). Includes 'method' for class child nodes. */
-export type ExtendedSymbolKind = 'parameter' | 'property' | 'constant' | 'method';
+export type ExtendedSymbolKind = 'parameter' | 'property' | 'constant' | 'variable' | 'method';
 
 /** All queryable symbol kinds. */
 export type SymbolKind = CoreSymbolKind | ExtendedSymbolKind;
@@ -83,7 +84,13 @@ export type LanguageId =
   | 'csharp'
   | 'ruby'
   | 'php'
-  | 'hcl';
+  | 'hcl'
+  | 'c'
+  | 'cpp'
+  | 'kotlin'
+  | 'swift'
+  | 'scala'
+  | 'bash';
 
 /** Engine mode selector. */
 export type EngineMode = 'native' | 'wasm' | 'auto';
@@ -433,6 +440,11 @@ export interface Import {
   csharpUsing?: boolean;
   rubyRequire?: boolean;
   phpUse?: boolean;
+  cInclude?: boolean;
+  kotlinImport?: boolean;
+  swiftImport?: boolean;
+  scalaImport?: boolean;
+  bashSource?: boolean;
 }
 
 /** A class/struct/trait relationship (extends or implements). */
@@ -883,6 +895,13 @@ export interface EngineOpts {
   ast: boolean;
   /** Persistent NativeDatabase connection for build writes (Phase 6.15). */
   nativeDb?: NativeDatabase;
+  /**
+   * Suspend the JS (better-sqlite3) connection before a native write to avoid
+   * dual-connection WAL corruption. Call `resumeJsDb()` after the write completes.
+   * Only set during pipeline builds where both connections coexist.
+   */
+  suspendJsDb?: () => void;
+  resumeJsDb?: () => void;
 }
 
 /** A file change detected during incremental builds. */
@@ -2014,14 +2033,14 @@ export interface NativeDatabase {
         name: string;
         kind: string;
         line: number;
-        endLine?: number | null;
-        visibility?: string | null;
+        endLine?: number;
+        visibility?: string;
         children: Array<{
           name: string;
           kind: string;
           line: number;
-          endLine?: number | null;
-          visibility?: string | null;
+          endLine?: number;
+          visibility?: string;
         }>;
       }>;
       exports: Array<{ name: string; kind: string; line: number }>;
@@ -2050,6 +2069,56 @@ export interface NativeDatabase {
       }>;
     }>,
   ): number;
+  bulkInsertComplexity?(
+    rows: Array<{
+      nodeId: number;
+      cognitive: number;
+      cyclomatic: number;
+      maxNesting: number;
+      loc: number;
+      sloc: number;
+      commentLines: number;
+      halsteadN1: number;
+      halsteadN2: number;
+      halsteadBigN1: number;
+      halsteadBigN2: number;
+      halsteadVocabulary: number;
+      halsteadLength: number;
+      halsteadVolume: number;
+      halsteadDifficulty: number;
+      halsteadEffort: number;
+      halsteadBugs: number;
+      maintainabilityIndex: number;
+    }>,
+  ): number;
+  bulkInsertCfg?(
+    entries: Array<{
+      nodeId: number;
+      blocks: Array<{
+        index: number;
+        blockType: string;
+        startLine?: number | null;
+        endLine?: number | null;
+        label?: string | null;
+      }>;
+      edges: Array<{
+        sourceIndex: number;
+        targetIndex: number;
+        kind: string;
+      }>;
+    }>,
+  ): number;
+  bulkInsertDataflow?(
+    edges: Array<{
+      sourceId: number;
+      targetId: number;
+      kind: string;
+      paramIndex?: number | null;
+      expression?: string | null;
+      line?: number | null;
+      confidence: number;
+    }>,
+  ): number;
   classifyRolesFull(): {
     entry: number;
     core: number;
@@ -2078,6 +2147,119 @@ export interface NativeDatabase {
   } | null;
   purgeFilesData(files: string[], purgeHashes?: boolean, reverseDepFiles?: string[]): void;
 
+  // ── Batched query methods ────────────────────────────────────────────
+  /** All graph statistics in a single napi call (replaces ~11 queries in module-map). */
+  getGraphStats?(noTests: boolean): {
+    totalNodes: number;
+    totalEdges: number;
+    nodesByKind: Array<{ kind: string; count: number }>;
+    edgesByKind: Array<{ kind: string; count: number }>;
+    roleCounts: Array<{ role: string; count: number }>;
+    quality: {
+      callableTotal: number;
+      callableWithCallers: number;
+      callEdges: number;
+      highConfCallEdges: number;
+    };
+    hotspots: Array<{ file: string; fanIn: number; fanOut: number }>;
+    complexity: {
+      analyzed: number;
+      avgCognitive: number;
+      avgCyclomatic: number;
+      maxCognitive: number;
+      maxCyclomatic: number;
+      avgMi: number;
+      minMi: number;
+    } | null;
+    embeddings: {
+      count: number;
+      model: string | null;
+      dim: number | null;
+      builtAt: string | null;
+    } | null;
+  };
+  /** All 6 directional dataflow edge sets for a node in one call. */
+  getDataflowEdges?(nodeId: number): {
+    flowsToOut: Array<{
+      name: string;
+      kind: string;
+      file: string;
+      line: number | null;
+      paramIndex: number | null;
+      expression: string | null;
+      confidence: number | null;
+    }>;
+    flowsToIn: Array<{
+      name: string;
+      kind: string;
+      file: string;
+      line: number | null;
+      paramIndex: number | null;
+      expression: string | null;
+      confidence: number | null;
+    }>;
+    returnsOut: Array<{
+      name: string;
+      kind: string;
+      file: string;
+      line: number | null;
+      paramIndex: number | null;
+      expression: string | null;
+      confidence: number | null;
+    }>;
+    returnsIn: Array<{
+      name: string;
+      kind: string;
+      file: string;
+      line: number | null;
+      paramIndex: number | null;
+      expression: string | null;
+      confidence: number | null;
+    }>;
+    mutatesOut: Array<{
+      name: string;
+      kind: string;
+      file: string;
+      line: number | null;
+      paramIndex: number | null;
+      expression: string | null;
+      confidence: number | null;
+    }>;
+    mutatesIn: Array<{
+      name: string;
+      kind: string;
+      file: string;
+      line: number | null;
+      paramIndex: number | null;
+      expression: string | null;
+      confidence: number | null;
+    }>;
+  };
+  /** Hotspot rows for a metric/kind/limit in one call. */
+  getHotspots?(
+    kind: string,
+    metric: string,
+    noTests: boolean,
+    limit: number,
+  ): Array<{
+    name: string;
+    kind: string;
+    lineCount: number | null;
+    symbolCount: number | null;
+    importCount: number | null;
+    exportCount: number | null;
+    fanIn: number | null;
+    fanOut: number | null;
+    cohesion: number | null;
+    fileCount: number | null;
+  }>;
+  /** Batch fan-in/fan-out for multiple node IDs in one call. */
+  batchFanMetrics?(nodeIds: number[]): Array<{
+    nodeId: number;
+    fanIn: number;
+    fanOut: number;
+  }>;
+
   // ── Generic query execution & version validation (6.16) ─────────────
   /** Execute a parameterized SELECT and return all rows as objects. */
   queryAll(sql: string, params: Array<string | number | null>): Record<string, unknown>[];