@optave/codegraph 3.3.1 → 3.4.1

package/dist/db/repository/nodes.d.ts

@@ -1,151 +1,86 @@
+import type { BetterSqlite3Database, ChildNodeRow, ListFunctionOpts, NodeIdRow, NodeRow, NodeRowWithFanIn, QueryOpts, TriageNodeRow, TriageQueryOpts } from '../../types.js';
 /**
  * Find nodes matching a name pattern, with fan-in count.
- * @param {object} db
- * @param {string} namePattern - LIKE pattern (already wrapped with %)
- * @param {object} [opts]
- * @param {string[]} [opts.kinds]
- * @param {string} [opts.file]
- * @returns {object[]}
  */
-export function findNodesWithFanIn(db: object, namePattern: string, opts?: {
-    kinds?: string[] | undefined;
-    file?: string | undefined;
-}): object[];
+export declare function findNodesWithFanIn(db: BetterSqlite3Database, namePattern: string, opts?: QueryOpts): NodeRowWithFanIn[];
 /**
  * Fetch nodes for triage scoring: fan-in + complexity + churn.
- * @param {object} db
- * @param {object} [opts]
- * @returns {object[]}
  */
-export function findNodesForTriage(db: object, opts?: object): object[];
+export declare function findNodesForTriage(db: BetterSqlite3Database, opts?: TriageQueryOpts): TriageNodeRow[];
 /**
  * List function/method/class nodes with basic info.
- * @param {object} db
- * @param {object} [opts]
- * @returns {object[]}
  */
-export function listFunctionNodes(db: object, opts?: object): object[];
+export declare function listFunctionNodes(db: BetterSqlite3Database, opts?: ListFunctionOpts): NodeRow[];
 /**
  * Iterator version of listFunctionNodes for memory efficiency.
- * @param {object} db
- * @param {object} [opts]
- * @returns {IterableIterator}
  */
-export function iterateFunctionNodes(db: object, opts?: object): IterableIterator<any>;
+export declare function iterateFunctionNodes(db: BetterSqlite3Database, opts?: ListFunctionOpts): IterableIterator<NodeRow>;
 /**
  * Count total nodes.
- * @param {object} db
- * @returns {number}
  */
-export function countNodes(db: object): number;
+export declare function countNodes(db: BetterSqlite3Database): number;
 /**
  * Count total edges.
- * @param {object} db
- * @returns {number}
  */
-export function countEdges(db: object): number;
+export declare function countEdges(db: BetterSqlite3Database): number;
 /**
  * Count distinct files.
- * @param {object} db
- * @returns {number}
  */
-export function countFiles(db: object): number;
+export declare function countFiles(db: BetterSqlite3Database): number;
 /**
  * Find a single node by ID.
- * @param {object} db
- * @param {number} id
- * @returns {object|undefined}
  */
-export function findNodeById(db: object, id: number): object | undefined;
+export declare function findNodeById(db: BetterSqlite3Database, id: number): NodeRow | undefined;
 /**
  * Find non-file nodes for a given file path (exact match), ordered by line.
- * @param {object} db
- * @param {string} file - Exact file path
- * @returns {object[]}
  */
-export function findNodesByFile(db: object, file: string): object[];
+export declare function findNodesByFile(db: BetterSqlite3Database, file: string): NodeRow[];
 /**
  * Find file-kind nodes matching a LIKE pattern.
- * @param {object} db
- * @param {string} fileLike - LIKE pattern (caller wraps with %)
- * @returns {object[]}
  */
-export function findFileNodes(db: object, fileLike: string): object[];
+export declare function findFileNodes(db: BetterSqlite3Database, fileLike: string): NodeRow[];
 /**
  * Look up a node's ID by its unique (name, kind, file, line) tuple.
- * Shared by builder, watcher, structure, complexity, cfg, engine.
- * @param {object} db
- * @param {string} name
- * @param {string} kind
- * @param {string} file
- * @param {number} line
- * @returns {number|undefined}
  */
-export function getNodeId(db: object, name: string, kind: string, file: string, line: number): number | undefined;
+export declare function getNodeId(db: BetterSqlite3Database, name: string, kind: string, file: string, line: number): number | undefined;
 /**
  * Look up a function/method node's ID (kind-restricted variant of getNodeId).
- * Used by complexity.js, cfg.js where only function/method kinds are expected.
- * @param {object} db
- * @param {string} name
- * @param {string} file
- * @param {number} line
- * @returns {number|undefined}
  */
-export function getFunctionNodeId(db: object, name: string, file: string, line: number): number | undefined;
+export declare function getFunctionNodeId(db: BetterSqlite3Database, name: string, file: string, line: number): number | undefined;
 /**
  * Bulk-fetch all node IDs for a file in one query.
- * Returns rows suitable for building a `name|kind|line -> id` lookup map.
- * Shared by builder, ast.js, ast-analysis/engine.js.
- * @param {object} db
- * @param {string} file
- * @returns {{ id: number, name: string, kind: string, line: number }[]}
  */
-export function bulkNodeIdsByFile(db: object, file: string): {
-    id: number;
-    name: string;
-    kind: string;
-    line: number;
-}[];
+export declare function bulkNodeIdsByFile(db: BetterSqlite3Database, file: string): NodeIdRow[];
 /**
  * Find child nodes (parameters, properties, constants) of a parent.
- * @param {object} db
- * @param {number} parentId
- * @returns {{ name: string, kind: string, line: number, end_line: number|null, qualified_name: string|null, scope: string|null, visibility: string|null }[]}
- */
-export function findNodeChildren(db: object, parentId: number): {
-    name: string;
-    kind: string;
-    line: number;
-    end_line: number | null;
-    qualified_name: string | null;
-    scope: string | null;
-    visibility: string | null;
-}[];
+ */
+export declare function findNodeChildren(db: BetterSqlite3Database, parentId: number): ChildNodeRow[];
 /**
  * Find all nodes that belong to a given scope (by scope column).
- * Enables "all methods of class X" without traversing edges.
+ */
+export declare function findNodesByScope(db: BetterSqlite3Database, scopeName: string, opts?: QueryOpts): NodeRow[];
+/**
+ * Find nodes by qualified name.
+ */
+export declare function findNodeByQualifiedName(db: BetterSqlite3Database, qualifiedName: string, opts?: {
+    file?: string;
+}): NodeRow[];
+/**
+ * Get line_count from node_metrics for a given node.
  * @param {object} db
- * @param {string} scopeName - The scope to search for (e.g., class name)
- * @param {object} [opts]
- * @param {string} [opts.kind] - Filter by node kind
- * @param {string} [opts.file] - Filter by file path (LIKE match)
- * @returns {object[]}
- */
-export function findNodesByScope(db: object, scopeName: string, opts?: {
-    kind?: string | undefined;
-    file?: string | undefined;
-}): object[];
-/**
- * Find nodes by qualified name. Returns all matches since the same
- * qualified_name can exist in different files (e.g., two classes named
- * `DateHelper.format` in separate modules). Pass `opts.file` to narrow.
+ * @param {number} nodeId
+ * @returns {{ line_count: number } | undefined}
+ */
+export declare function getLineCountForNode(db: BetterSqlite3Database, nodeId: number): {
+    line_count: number;
+} | undefined;
+/**
+ * Get the maximum end_line across all nodes in a file.
  * @param {object} db
- * @param {string} qualifiedName - e.g., 'DateHelper.format'
- * @param {object} [opts]
- * @param {string} [opts.file] - Filter by file path (LIKE match)
- * @returns {object[]}
- */
-export function findNodeByQualifiedName(db: object, qualifiedName: string, opts?: {
-    file?: string | undefined;
-}): object[];
+ * @param {string} file
+ * @returns {{ max_end: number | null } | undefined}
+ */
+export declare function getMaxEndLineForFile(db: BetterSqlite3Database, file: string): {
+    max_end: number | null;
+} | undefined;
 //# sourceMappingURL=nodes.d.ts.map

package/dist/db/repository/nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/db/repository/nodes.js"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,uCAPW,MAAM,eACN,MAAM,SAEd;IAAwB,KAAK;IACP,IAAI;CAC1B,GAAU,MAAM,EAAE,CAgBpB;AAED;;;;;GAKG;AACH,uCAJW,MAAM,SACN,MAAM,GACJ,MAAM,EAAE,CAiCpB;AAiBD;;;;;GAKG;AACH,sCAJW,MAAM,SACN,MAAM,GACJ,MAAM,EAAE,CAIpB;AAED;;;;;GAKG;AACH,yCAJW,MAAM,SACN,MAAM,yBAKhB;AAgBD;;;;GAIG;AACH,+BAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,+BAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;;;GAIG;AACH,+BAHW,MAAM,GACJ,MAAM,CAIlB;AAID;;;;;GAKG;AACH,iCAJW,MAAM,MACN,MAAM,GACJ,MAAM,GAAC,SAAS,CAI5B;AAED;;;;;GAKG;AACH,oCAJW,MAAM,QACN,MAAM,GACJ,MAAM,EAAE,CAQpB;AAED;;;;;GAKG;AACH,kCAJW,MAAM,YACN,MAAM,GACJ,MAAM,EAAE,CAQpB;AAED;;;;;;;;;GASG;AACH,8BAPW,MAAM,QACN,MAAM,QACN,MAAM,QACN,MAAM,QACN,MAAM,GACJ,MAAM,GAAC,SAAS,CAQ5B;AAED;;;;;;;;GAQG;AACH,sCANW,MAAM,QACN,MAAM,QACN,MAAM,QACN,MAAM,GACJ,MAAM,GAAC,SAAS,CAQ5B;AAED;;;;;;;GAOG;AACH,sCAJW,MAAM,QACN,MAAM,GACJ;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAQtE;AAED;;;;;GAKG;AACH,qCAJW,MAAM,YACN,MAAM,GACJ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,GAAC,IAAI,CAAA;CAAE,EAAE,CAQ3J;AAED;;;;;;;;;GASG;AACH,qCAPW,MAAM,aACN,MAAM,SAEd;IAAsB,IAAI;IACJ,IAAI;CAC1B,GAAU,MAAM,EAAE,CAcpB;AAED;;;;;;;;;GASG;AACH,4CANW,MAAM,iBACN,MAAM,SAEd;IAAsB,IAAI;CAC1B,GAAU,MAAM,EAAE,CAcpB"}
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/db/repository/nodes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,SAAS,EAET,aAAa,EACb,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAMxB;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,qBAAqB,EACzB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,SAAc,GACnB,gBAAgB,EAAE,CAcpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,qBAAqB,EACzB,IAAI,GAAE,eAAoB,GACzB,aAAa,EAAE,CAgCjB;AAeD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,qBAAqB,EACzB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,EAAE,CAEX;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,qBAAqB,EACzB,IAAI,GAAE,gBAAqB,GAC1B,gBAAgB,CAAC,OAAO,CAAC,CAE3B;AAgBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,qBAAqB,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,qBAAqB,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,qBAAqB,GAAG,MAAM,CAI5D;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,qBAAqB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEvF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAMlF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAMpF;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,qBAAqB,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAMpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,qBAAqB,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAMpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAMtF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAM5F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,qBAAqB,EACzB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,SAAc,GACnB,OAAO,EAAE,CAYX;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,qBAAqB,EACzB,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3B,OAAO,EAAE,CAYX;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM;gBARrB,MAAM;cAc7D;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM;aARtB,MAAM,GAAG,IAAI;cAclE"}

package/dist/db/repository/nodes.js

@@ -5,12 +5,6 @@ import { cachedStmt } from './cached-stmt.js';
 // ─── Query-builder based lookups (moved from src/db/repository.js) ─────
 /**
  * Find nodes matching a name pattern, with fan-in count.
- * @param {object} db
- * @param {string} namePattern - LIKE pattern (already wrapped with %)
- * @param {object} [opts]
- * @param {string[]} [opts.kinds]
- * @param {string} [opts.file]
- * @returns {object[]}
  */
 export function findNodesWithFanIn(db, namePattern, opts = {}) {
     const q = new NodeQuery()
@@ -27,9 +21,6 @@ export function findNodesWithFanIn(db, namePattern, opts = {}) {
 }
 /**
  * Fetch nodes for triage scoring: fan-in + complexity + churn.
- * @param {object} db
- * @param {object} [opts]
- * @returns {object[]}
  */
 export function findNodesForTriage(db, opts = {}) {
     if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
@@ -40,7 +31,8 @@ export function findNodesForTriage(db, opts = {}) {
     }
     const kindsToUse = opts.kind ? [opts.kind] : ['function', 'method', 'class'];
     const q = new NodeQuery()
-        .select(`n.id, n.name, n.kind, n.file, n.line, n.end_line, n.role,
+        .select(`n.id, n.name, n.kind, n.file, n.line, n.end_line,
+              n.parent_id, n.exported, n.qualified_name, n.scope, n.visibility, n.role,
               COALESCE(fi.cnt, 0) AS fan_in,
               COALESCE(fc.cognitive, 0) AS cognitive,
               COALESCE(fc.maintainability_index, 0) AS mi,
@@ -59,8 +51,6 @@ export function findNodesForTriage(db, opts = {}) {
 }
 /**
  * Shared query builder for function/method/class node listing.
- * @param {object} [opts]
- * @returns {NodeQuery}
  */
 function _functionNodeQuery(opts = {}) {
     return new NodeQuery()
@@ -73,18 +63,12 @@ function _functionNodeQuery(opts = {}) {
 }
 /**
  * List function/method/class nodes with basic info.
- * @param {object} db
- * @param {object} [opts]
- * @returns {object[]}
  */
 export function listFunctionNodes(db, opts = {}) {
     return _functionNodeQuery(opts).all(db);
 }
 /**
  * Iterator version of listFunctionNodes for memory efficiency.
- * @param {object} db
- * @param {object} [opts]
- * @returns {IterableIterator}
  */
 export function iterateFunctionNodes(db, opts = {}) {
     return _functionNodeQuery(opts).iterate(db);
@@ -104,110 +88,67 @@ const _findNodeChildrenStmt = new WeakMap();
 const _findNodeByQualifiedNameStmt = new WeakMap();
 /**
  * Count total nodes.
- * @param {object} db
- * @returns {number}
  */
 export function countNodes(db) {
-    return cachedStmt(_countNodesStmt, db, 'SELECT COUNT(*) AS cnt FROM nodes').get().cnt;
+    return cachedStmt(_countNodesStmt, db, 'SELECT COUNT(*) AS cnt FROM nodes').get()?.cnt ?? 0;
 }
 /**
  * Count total edges.
- * @param {object} db
- * @returns {number}
  */
 export function countEdges(db) {
-    return cachedStmt(_countEdgesStmt, db, 'SELECT COUNT(*) AS cnt FROM edges').get().cnt;
+    return cachedStmt(_countEdgesStmt, db, 'SELECT COUNT(*) AS cnt FROM edges').get()?.cnt ?? 0;
 }
 /**
  * Count distinct files.
- * @param {object} db
- * @returns {number}
  */
 export function countFiles(db) {
-    return cachedStmt(_countFilesStmt, db, 'SELECT COUNT(DISTINCT file) AS cnt FROM nodes').get().cnt;
+    return (cachedStmt(_countFilesStmt, db, 'SELECT COUNT(DISTINCT file) AS cnt FROM nodes').get()?.cnt ?? 0);
 }
 // ─── Shared node lookups ───────────────────────────────────────────────
 /**
  * Find a single node by ID.
- * @param {object} db
- * @param {number} id
- * @returns {object|undefined}
  */
 export function findNodeById(db, id) {
     return cachedStmt(_findNodeByIdStmt, db, 'SELECT * FROM nodes WHERE id = ?').get(id);
 }
 /**
  * Find non-file nodes for a given file path (exact match), ordered by line.
- * @param {object} db
- * @param {string} file - Exact file path
- * @returns {object[]}
  */
 export function findNodesByFile(db, file) {
     return cachedStmt(_findNodesByFileStmt, db, "SELECT * FROM nodes WHERE file = ? AND kind != 'file' ORDER BY line").all(file);
 }
 /**
  * Find file-kind nodes matching a LIKE pattern.
- * @param {object} db
- * @param {string} fileLike - LIKE pattern (caller wraps with %)
- * @returns {object[]}
  */
 export function findFileNodes(db, fileLike) {
     return cachedStmt(_findFileNodesStmt, db, "SELECT * FROM nodes WHERE file LIKE ? AND kind = 'file'").all(fileLike);
 }
 /**
  * Look up a node's ID by its unique (name, kind, file, line) tuple.
- * Shared by builder, watcher, structure, complexity, cfg, engine.
- * @param {object} db
- * @param {string} name
- * @param {string} kind
- * @param {string} file
- * @param {number} line
- * @returns {number|undefined}
  */
 export function getNodeId(db, name, kind, file, line) {
     return cachedStmt(_getNodeIdStmt, db, 'SELECT id FROM nodes WHERE name = ? AND kind = ? AND file = ? AND line = ?').get(name, kind, file, line)?.id;
 }
 /**
  * Look up a function/method node's ID (kind-restricted variant of getNodeId).
- * Used by complexity.js, cfg.js where only function/method kinds are expected.
- * @param {object} db
- * @param {string} name
- * @param {string} file
- * @param {number} line
- * @returns {number|undefined}
  */
 export function getFunctionNodeId(db, name, file, line) {
     return cachedStmt(_getFunctionNodeIdStmt, db, "SELECT id FROM nodes WHERE name = ? AND kind IN ('function','method') AND file = ? AND line = ?").get(name, file, line)?.id;
 }
 /**
  * Bulk-fetch all node IDs for a file in one query.
- * Returns rows suitable for building a `name|kind|line -> id` lookup map.
- * Shared by builder, ast.js, ast-analysis/engine.js.
- * @param {object} db
- * @param {string} file
- * @returns {{ id: number, name: string, kind: string, line: number }[]}
  */
 export function bulkNodeIdsByFile(db, file) {
     return cachedStmt(_bulkNodeIdsByFileStmt, db, 'SELECT id, name, kind, line FROM nodes WHERE file = ?').all(file);
 }
 /**
  * Find child nodes (parameters, properties, constants) of a parent.
- * @param {object} db
- * @param {number} parentId
- * @returns {{ name: string, kind: string, line: number, end_line: number|null, qualified_name: string|null, scope: string|null, visibility: string|null }[]}
  */
 export function findNodeChildren(db, parentId) {
     return cachedStmt(_findNodeChildrenStmt, db, 'SELECT name, kind, line, end_line, qualified_name, scope, visibility FROM nodes WHERE parent_id = ? ORDER BY line').all(parentId);
 }
 /**
  * Find all nodes that belong to a given scope (by scope column).
- * Enables "all methods of class X" without traversing edges.
- * @param {object} db
- * @param {string} scopeName - The scope to search for (e.g., class name)
- * @param {object} [opts]
- * @param {string} [opts.kind] - Filter by node kind
- * @param {string} [opts.file] - Filter by file path (LIKE match)
- * @returns {object[]}
  */
 export function findNodesByScope(db, scopeName, opts = {}) {
     let sql = 'SELECT * FROM nodes WHERE scope = ?';
@@ -216,24 +157,17 @@ export function findNodesByScope(db, scopeName, opts = {}) {
         sql += ' AND kind = ?';
         params.push(opts.kind);
     }
-    const fc = buildFileConditionSQL(opts.file, 'file');
+    const fc = buildFileConditionSQL(opts.file ?? '', 'file');
     sql += fc.sql;
     params.push(...fc.params);
     sql += ' ORDER BY file, line';
     return db.prepare(sql).all(...params);
 }
 /**
- * Find nodes by qualified name. Returns all matches since the same
- * qualified_name can exist in different files (e.g., two classes named
- * `DateHelper.format` in separate modules). Pass `opts.file` to narrow.
- * @param {object} db
- * @param {string} qualifiedName - e.g., 'DateHelper.format'
- * @param {object} [opts]
- * @param {string} [opts.file] - Filter by file path (LIKE match)
- * @returns {object[]}
+ * Find nodes by qualified name.
  */
 export function findNodeByQualifiedName(db, qualifiedName, opts = {}) {
-    const fc = buildFileConditionSQL(opts.file, 'file');
+    const fc = buildFileConditionSQL(opts.file ?? '', 'file');
     if (fc.sql) {
         return db
             .prepare(`SELECT * FROM nodes WHERE qualified_name = ?${fc.sql} ORDER BY file, line`)
@@ -241,4 +175,25 @@ export function findNodeByQualifiedName(db, qualifiedName, opts = {}) {
     }
     return cachedStmt(_findNodeByQualifiedNameStmt, db, 'SELECT * FROM nodes WHERE qualified_name = ? ORDER BY file, line').all(qualifiedName);
 }
+// ─── Metric helpers ──────────────────────────────────────────────────────
+const _getLineCountForNodeStmt = new WeakMap();
+/**
+ * Get line_count from node_metrics for a given node.
+ * @param {object} db
+ * @param {number} nodeId
+ * @returns {{ line_count: number } | undefined}
+ */
+export function getLineCountForNode(db, nodeId) {
+    return cachedStmt(_getLineCountForNodeStmt, db, 'SELECT line_count FROM node_metrics WHERE node_id = ?').get(nodeId);
+}
+const _getMaxEndLineForFileStmt = new WeakMap();
+/**
+ * Get the maximum end_line across all nodes in a file.
+ * @param {object} db
+ * @param {string} file
+ * @returns {{ max_end: number | null } | undefined}
+ */
+export function getMaxEndLineForFile(db, file) {
+    return cachedStmt(_getMaxEndLineForFileStmt, db, 'SELECT MAX(end_line) as max_end FROM nodes WHERE file = ?').get(file);
+}
 //# sourceMappingURL=nodes.js.map

package/dist/db/repository/nodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../../src/db/repository/nodes.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../../src/db/repository/nodes.ts"],"names":[],"mappings":"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"}

package/dist/db/repository/sqlite-repository.d.ts

@@ -1,100 +1,55 @@
+import type { AdjacentEdgeRow, BetterSqlite3Database, CallableNodeRow, CallEdgeRow, ChildNodeRow, ComplexityMetrics, FileNodeRow, ImportEdgeRow, ImportGraphEdgeRow, IntraFileCallEdge, ListFunctionOpts, NodeIdRow, NodeRow, NodeRowWithFanIn, QueryOpts, RelatedNodeRow, TriageNodeRow, TriageQueryOpts } from '../../types.js';
+import { Repository } from './base.js';
 /**
  * SqliteRepository — wraps existing `fn(db, ...)` repository functions
  * behind the Repository interface so callers can use `repo.method(...)`.
  */
-export class SqliteRepository extends Repository {
-    /** @param {object} db - better-sqlite3 Database instance */
-    constructor(db: object);
-    /** Expose the underlying db for code that still needs raw access. */
-    get db(): object;
-    findNodeById(id: any): object | undefined;
-    findNodesByFile(file: any): object[];
-    findFileNodes(fileLike: any): object[];
-    findNodesWithFanIn(namePattern: any, opts: any): object[];
-    getNodeId(name: any, kind: any, file: any, line: any): number | undefined;
-    getFunctionNodeId(name: any, file: any, line: any): number | undefined;
-    bulkNodeIdsByFile(file: any): {
-        id: number;
-        name: string;
-        kind: string;
-        line: number;
-    }[];
-    findNodeChildren(parentId: any): {
-        name: string;
-        kind: string;
-        line: number;
-        end_line: number | null;
-        qualified_name: string | null;
-        scope: string | null;
-        visibility: string | null;
-    }[];
-    findNodesByScope(scopeName: any, opts: any): object[];
-    findNodeByQualifiedName(qualifiedName: any, opts: any): object[];
-    listFunctionNodes(opts: any): object[];
-    iterateFunctionNodes(opts: any): IterableIterator<any>;
-    findNodesForTriage(opts: any): object[];
-    findCallees(nodeId: any): {
-        id: number;
-        name: string;
-        kind: string;
-        file: string;
-        line: number;
-        end_line: number | null;
-    }[];
-    findCallers(nodeId: any): {
-        id: number;
-        name: string;
-        kind: string;
-        file: string;
-        line: number;
-    }[];
-    findDistinctCallers(nodeId: any): {
-        id: number;
-        name: string;
-        kind: string;
-        file: string;
-        line: number;
-    }[];
-    findAllOutgoingEdges(nodeId: any): {
-        name: string;
-        kind: string;
-        file: string;
-        line: number;
-        edge_kind: string;
-    }[];
-    findAllIncomingEdges(nodeId: any): {
-        name: string;
-        kind: string;
-        file: string;
-        line: number;
-        edge_kind: string;
-    }[];
-    findCalleeNames(nodeId: any): string[];
-    findCallerNames(nodeId: any): string[];
-    findImportTargets(nodeId: any): {
-        file: string;
-        edge_kind: string;
-    }[];
-    findImportSources(nodeId: any): {
-        file: string;
-        edge_kind: string;
-    }[];
-    findImportDependents(nodeId: any): object[];
-    findCrossFileCallTargets(file: any): Set<number>;
-    countCrossFileCallers(nodeId: any, file: any): number;
-    getClassHierarchy(classNodeId: any): Set<number>;
-    findIntraFileCallEdges(file: any): {
-        caller_name: string;
-        callee_name: string;
-    }[];
-    getComplexityForNode(nodeId: any): {
-        cognitive: number;
-        cyclomatic: number;
-        max_nesting: number;
-        maintainability_index: number;
-        halstead_volume: number;
-    } | undefined;
+export declare class SqliteRepository extends Repository {
     #private;
+    constructor(db: BetterSqlite3Database);
+    /** Expose the underlying db for code that still needs raw access. */
+    get db(): BetterSqlite3Database;
+    findNodeById(id: number): NodeRow | undefined;
+    findNodesByFile(file: string): NodeRow[];
+    findFileNodes(fileLike: string): NodeRow[];
+    findNodesWithFanIn(namePattern: string, opts?: QueryOpts): NodeRowWithFanIn[];
+    countNodes(): number;
+    countEdges(): number;
+    countFiles(): number;
+    getNodeId(name: string, kind: string, file: string, line: number): number | undefined;
+    getFunctionNodeId(name: string, file: string, line: number): number | undefined;
+    bulkNodeIdsByFile(file: string): NodeIdRow[];
+    findNodeChildren(parentId: number): ChildNodeRow[];
+    findNodesByScope(scopeName: string, opts?: QueryOpts): NodeRow[];
+    findNodeByQualifiedName(qualifiedName: string, opts?: {
+        file?: string;
+    }): NodeRow[];
+    listFunctionNodes(opts?: ListFunctionOpts): NodeRow[];
+    iterateFunctionNodes(opts?: ListFunctionOpts): IterableIterator<NodeRow>;
+    findNodesForTriage(opts?: TriageQueryOpts): TriageNodeRow[];
+    findCallees(nodeId: number): RelatedNodeRow[];
+    findCallers(nodeId: number): RelatedNodeRow[];
+    findDistinctCallers(nodeId: number): RelatedNodeRow[];
+    findAllOutgoingEdges(nodeId: number): AdjacentEdgeRow[];
+    findAllIncomingEdges(nodeId: number): AdjacentEdgeRow[];
+    findCalleeNames(nodeId: number): string[];
+    findCallerNames(nodeId: number): string[];
+    findImportTargets(nodeId: number): ImportEdgeRow[];
+    findImportSources(nodeId: number): ImportEdgeRow[];
+    findImportDependents(nodeId: number): NodeRow[];
+    findCrossFileCallTargets(file: string): Set<number>;
+    countCrossFileCallers(nodeId: number, file: string): number;
+    getClassHierarchy(classNodeId: number): Set<number>;
+    findImplementors(nodeId: number): RelatedNodeRow[];
+    findInterfaces(nodeId: number): RelatedNodeRow[];
+    findIntraFileCallEdges(file: string): IntraFileCallEdge[];
+    getCallableNodes(): CallableNodeRow[];
+    getCallEdges(): CallEdgeRow[];
+    getFileNodesAll(): FileNodeRow[];
+    getImportEdges(): ImportGraphEdgeRow[];
+    hasCfgTables(): boolean;
+    hasEmbeddings(): boolean;
+    hasDataflowTable(): boolean;
+    getComplexityForNode(nodeId: number): ComplexityMetrics | undefined;
 }
-import { Repository } from './base.js';
 //# sourceMappingURL=sqlite-repository.d.ts.map

package/dist/db/repository/sqlite-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-repository.d.ts","sourceRoot":"","sources":["../../../src/db/repository/sqlite-repository.js"],"names":[],"mappings":"AAyCA;;;GAGG;AACH;IAGE,4DAA4D;IAC5D,gBADY,MAAM,EAIjB;IAED,qEAAqE;IACrE,iBAEC;IAID,0CAEC;IAED,qCAEC;IAED,uCAEC;IAED,0DAEC;IAcD,0EAEC;IAED,uEAEC;IAED;;;;;QAEC;IAED;;;;;;;;QAEC;IAED,sDAEC;IAED,iEAEC;IAED,uCAEC;IAED,uDAEC;IAED,wCAEC;IAID;;;;;;;QAEC;IAED;;;;;;QAEC;IAED;;;;;;QAEC;IAED;;;;;;QAEC;IAED;;;;;;QAEC;IAED,uCAEC;IAED,uCAEC;IAED;;;QAEC;IAED;;;QAEC;IAED,4CAEC;IAED,iDAEC;IAED,sDAEC;IAED,iDAEC;IAED;;;QAEC;IAkCD;;;;;;kBAEC;;CACF;2BA1N0B,WAAW"}
+{"version":3,"file":"sqlite-repository.d.ts","sourceRoot":"","sources":["../../../src/db/repository/sqlite-repository.ts"],"names":[],"mappings":"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"}

package/dist/db/repository/sqlite-repository.js

@@ -2,7 +2,7 @@ import { Repository } from './base.js';
 import { hasCfgTables } from './cfg.js';
 import { getComplexityForNode } from './complexity.js';
 import { hasDataflowTable } from './dataflow.js';
-import { countCrossFileCallers, findAllIncomingEdges, findAllOutgoingEdges, findCalleeNames, findCallees, findCallerNames, findCallers, findCrossFileCallTargets, findDistinctCallers, findImportDependents, findImportSources, findImportTargets, findIntraFileCallEdges, getClassHierarchy, } from './edges.js';
+import { countCrossFileCallers, findAllIncomingEdges, findAllOutgoingEdges, findCalleeNames, findCallees, findCallerNames, findCallers, findCrossFileCallTargets, findDistinctCallers, findImplementors, findImportDependents, findImportSources, findImportTargets, findInterfaces, findIntraFileCallEdges, getClassHierarchy, } from './edges.js';
 import { hasEmbeddings } from './embeddings.js';
 import { getCallableNodes, getCallEdges, getFileNodesAll, getImportEdges } from './graph-read.js';
 import { bulkNodeIdsByFile, countEdges, countFiles, countNodes, findFileNodes, findNodeById, findNodeByQualifiedName, findNodeChildren, findNodesByFile, findNodesByScope, findNodesForTriage, findNodesWithFanIn, getFunctionNodeId, getNodeId, iterateFunctionNodes, listFunctionNodes, } from './nodes.js';
@@ -12,7 +12,6 @@ import { bulkNodeIdsByFile, countEdges, countFiles, countNodes, findFileNodes, f
  */
 export class SqliteRepository extends Repository {
     #db;
-    /** @param {object} db - better-sqlite3 Database instance */
     constructor(db) {
         super();
         this.#db = db;
@@ -110,6 +109,12 @@ export class SqliteRepository extends Repository {
     getClassHierarchy(classNodeId) {
         return getClassHierarchy(this.#db, classNodeId);
     }
+    findImplementors(nodeId) {
+        return findImplementors(this.#db, nodeId);
+    }
+    findInterfaces(nodeId) {
+        return findInterfaces(this.#db, nodeId);
+    }
     findIntraFileCallEdges(file) {
         return findIntraFileCallEdges(this.#db, file);
     }