@optave/codegraph 3.7.0 → 3.8.1

package/src/shared/normalize.ts

@@ -3,6 +3,15 @@ interface DbHandle {
   prepare(sql: string): { get(...params: unknown[]): unknown };
 }
 
+/** Anything that can look up a file hash — either a raw DB or a Repository. */
+interface HashSource {
+  getFileHash(file: string): string | null;
+}
+
+function isHashSource(x: unknown): x is HashSource {
+  return typeof x === 'object' && x !== null && typeof (x as HashSource).getFileHash === 'function';
+}
+
 export function getFileHash(db: DbHandle, file: string): string | null {
   const row = db.prepare('SELECT hash FROM file_hashes WHERE file = ?').get(file) as
     | { hash: string }
@@ -55,25 +64,35 @@ interface RawSymbolRow {
   role?: string | null;
 }
 
+/**
+ * Resolve a file hash, using the cache when available.
+ * Accepts a raw DB handle (with .prepare) or a Repository (with .getFileHash).
+ */
+function resolveFileHash(
+  db: DbHandle | HashSource,
+  file: string,
+  hashCache?: Map<string, string | null>,
+): string | null {
+  const lookupHash = isHashSource(db)
+    ? (f: string) => db.getFileHash(f)
+    : (f: string) => getFileHash(db as DbHandle, f);
+  if (!hashCache) return lookupHash(file);
+  if (!hashCache.has(file)) {
+    hashCache.set(file, lookupHash(file));
+  }
+  return hashCache.get(file) ?? null;
+}
+
 /**
  * Normalize a raw DB/query row into the stable 7-field symbol shape.
+ * Accepts a raw DB handle (with .prepare), a Repository (with .getFileHash), or null.
  */
 export function normalizeSymbol(
   row: RawSymbolRow,
-  db?: DbHandle | null,
+  db?: DbHandle | HashSource | null,
   hashCache?: Map<string, string | null>,
 ): NormalizedSymbol {
-  let fileHash: string | null = null;
-  if (db) {
-    if (hashCache) {
-      if (!hashCache.has(row.file)) {
-        hashCache.set(row.file, getFileHash(db, row.file));
-      }
-      fileHash = hashCache.get(row.file) ?? null;
-    } else {
-      fileHash = getFileHash(db, row.file);
-    }
-  }
+  const fileHash = db ? resolveFileHash(db, row.file, hashCache) : null;
   return {
     name: row.name,
     kind: row.kind,

package/src/shared/paginate.ts

@@ -105,20 +105,3 @@ export function paginateResult<T extends Record<string, unknown>>(
   const { items, pagination } = paginate(arr, { limit, offset });
   return { ...result, [field]: items, _pagination: pagination };
 }
-
-/**
- * Print data as newline-delimited JSON (NDJSON).
- *
- * Emits a `_meta` line with pagination info (if present), then one JSON
- * line per item in the named array field.
- */
-export function printNdjson(
-  data: Record<string, unknown> & { _pagination?: PaginationMeta },
-  field: string,
-): void {
-  if (data._pagination) console.log(JSON.stringify({ _meta: data._pagination }));
-  const items = data[field];
-  if (Array.isArray(items)) {
-    for (const item of items) console.log(JSON.stringify(item));
-  }
-}

package/src/types.ts

@@ -61,7 +61,7 @@ export type EdgeKind = CoreEdgeKind | StructuralEdgeKind;
 export type AnyEdgeKind = EdgeKind | DataflowEdgeKind;
 
 /** AST node kinds extracted during analysis. */
-export type ASTNodeKind = 'call' | 'new' | 'string' | 'regex' | 'throw' | 'await';
+export type ASTNodeKind = 'new' | 'string' | 'regex' | 'throw' | 'await';
 
 /** Coarse role classifications for symbols based on connectivity. */
 export type CoreRole = 'entry' | 'core' | 'utility' | 'adapter' | 'dead' | 'test-only' | 'leaf';
@@ -96,7 +96,19 @@ export type LanguageId =
   | 'dart'
   | 'zig'
   | 'haskell'
-  | 'ocaml';
+  | 'ocaml'
+  | 'ocaml-interface'
+  | 'fsharp'
+  | 'gleam'
+  | 'clojure'
+  | 'julia'
+  | 'r'
+  | 'erlang'
+  | 'solidity'
+  | 'objc'
+  | 'cuda'
+  | 'groovy'
+  | 'verilog';
 
 /** Engine mode selector. */
 export type EngineMode = 'native' | 'wasm' | 'auto';
@@ -316,6 +328,11 @@ export interface Repository {
   hasEmbeddings(): boolean;
   hasDataflowTable(): boolean;
   getComplexityForNode(nodeId: number): ComplexityMetrics | undefined;
+
+  // ── Convenience queries ──────────────────────────────────────────
+  getFileHash(file: string): string | null;
+  hasImplementsEdges(): boolean;
+  hasCoChangesTable(): boolean;
 }
 
 /**
@@ -383,6 +400,7 @@ export interface SubDeclaration {
   line: number;
   endLine?: number;
   visibility?: 'public' | 'private' | 'protected';
+  decorators?: string[];
 }
 
 /** Complexity metrics attached to a definition post-analysis. */
@@ -1828,8 +1846,54 @@ export interface NativeAddon {
   ): Array<{ fromFile: string; importSource: string; resolvedPath: string }>;
   computeConfidence(callerFile: string, targetFile: string, importedFrom: string | null): number;
   detectCycles(edges: Array<{ source: string; target: string }>): string[][];
+  bfsTraversal(
+    edges: Array<{ source: string; target: string }>,
+    startIds: string[],
+    maxDepth?: number | null,
+    direction?: string | null,
+  ): Array<{ node: string; depth: number }>;
+  shortestPath(
+    edges: Array<{ source: string; target: string }>,
+    fromId: string,
+    toId: string,
+  ): string[];
+  fanInOut(
+    edges: Array<{ source: string; target: string }>,
+  ): Array<{ node: string; fanIn: number; fanOut: number }>;
+  louvainCommunities(
+    edges: Array<{ source: string; target: string }>,
+    nodeIds: string[],
+    resolution?: number | null,
+    randomSeed?: number | null,
+  ): {
+    assignments: Array<{ node: string; community: number }>;
+    modularity: number;
+  };
   buildCallEdges(files: unknown[], nodes: unknown[], builtinReceivers: string[]): unknown[];
+  buildImportEdges?(
+    files: unknown[],
+    resolvedImports: unknown[],
+    fileReexports: unknown[],
+    fileNodeIds: unknown[],
+    barrelFiles: string[],
+    rootDir: string,
+  ): unknown[];
   engineVersion(): string;
+  analyzeComplexity(
+    source: string,
+    filePath: string,
+    langId?: string | null,
+  ): NativeFunctionComplexityResult[];
+  buildCfgAnalysis(
+    source: string,
+    filePath: string,
+    langId?: string | null,
+  ): NativeFunctionCfgResult[];
+  extractDataflowAnalysis(
+    source: string,
+    filePath: string,
+    langId?: string | null,
+  ): DataflowResult | null;
   ParseTreeCache: new () => NativeParseTreeCache;
   NativeDatabase: {
     openReadWrite(dbPath: string): NativeDatabase;
@@ -1837,6 +1901,40 @@ export interface NativeAddon {
   };
 }
 
+/** Per-function complexity result from native standalone analysis (napi output shape). */
+export interface NativeFunctionComplexityResult {
+  name: string;
+  line: number;
+  endLine: number | null;
+  complexity: {
+    cognitive: number;
+    cyclomatic: number;
+    maxNesting: number;
+    halstead?: {
+      n1: number;
+      n2: number;
+      bigN1: number;
+      bigN2: number;
+      vocabulary: number;
+      length: number;
+      volume: number;
+      difficulty: number;
+      effort: number;
+      bugs: number;
+    };
+    loc?: { loc: number; sloc: number; commentLines: number };
+    maintainabilityIndex?: number | null;
+  };
+}
+
+/** Per-function CFG result from native standalone analysis. */
+export interface NativeFunctionCfgResult {
+  name: string;
+  line: number;
+  endLine: number | null;
+  cfg: { blocks: CfgBlock[]; edges: CfgEdge[] };
+}
+
 /** Native parse-tree cache instance. */
 export interface NativeParseTreeCache {
   get(filePath: string): unknown;
@@ -2029,7 +2127,10 @@ export interface NativeDatabase {
   hasCfgTables(): boolean;
   hasEmbeddings(): boolean;
   hasDataflowTable(): boolean;
+  hasImplementsEdges(): boolean;
+  hasCoChangesTable(): boolean;
   getComplexityForNode(nodeId: number): NativeComplexityMetrics | null;
+  getFileHash(file: string): string | null;
 
   // ── Build pipeline writes (6.15) ───────────────────────────────────
   bulkInsertNodes(
@@ -2119,7 +2220,7 @@ export interface NativeDatabase {
       sourceId: number;
       targetId: number;
       kind: string;
-      paramIndex?: number | null;
+      paramIndex?: number;
       expression?: string | null;
       line?: number | null;
       confidence: number;
@@ -2266,6 +2367,32 @@ export interface NativeDatabase {
     fanOut: number;
   }>;
 
+  // ── Batched build-glue queries (6.18) ────────────────────────────────
+  /** All file_hashes rows + table existence + max mtime in one call. */
+  getFileHashData?(): {
+    exists: boolean;
+    rows: Array<{ file: string; hash: string; mtime: number; size: number }>;
+    maxMtime: number;
+  };
+  /** CFG and dataflow table counts (-1 = table missing). */
+  checkPendingAnalysis?(): { cfgCount: number; dataflowCount: number };
+  /** Batch upsert file_hashes for metadata healing. */
+  healFileMetadata?(
+    entries: Array<{ file: string; hash: string; mtime: number; size: number }>,
+  ): number;
+  /** Find files with edges pointing to changed files. */
+  findReverseDependencies?(changedFiles: string[]): string[];
+  /** Node + edge counts in one call. */
+  getFinalizeCounts?(): { nodeCount: number; edgeCount: number };
+  /** Orphaned embeddings, stale embeddings, unused exports in one call. */
+  runAdvisoryChecks?(hasEmbeddings: boolean): {
+    orphanedEmbeddings: number;
+    embedBuiltAt: string | null;
+    unusedExports: number;
+  };
+  /** File_hashes count + all file paths in one call. */
+  getCollectFilesData?(): { count: number; files: string[] };
+
   // ── 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>[];
@@ -2273,6 +2400,14 @@ export interface NativeDatabase {
   queryGet(sql: string, params: Array<string | number | null>): Record<string, unknown> | null;
   /** Validate DB codegraph_version matches expected. Warns on mismatch. */
   validateSchemaVersion(expectedVersion: string): boolean;
+
+  // ── Full Rust build orchestration (#695) ─────────────────────────────
+  /**
+   * Run the entire build pipeline in Rust with zero napi boundary crossings.
+   * Returns a JSON string with timing and build result data.
+   * When unavailable, the JS pipeline (runPipelineStages) is used as fallback.
+   */
+  buildGraph?(rootDir: string, configJson: string, aliasesJson: string, optsJson: string): string;
 }
 
 // ════════════════════════════════════════════════════════════════════════