optave-codegraph 3.13.0

package/dist/db/repository/nodes.js

@@ -0,0 +1,203 @@
+import { ConfigError } from '../../shared/errors.js';
+import { EVERY_SYMBOL_KIND, VALID_ROLES } from '../../shared/kinds.js';
+import { buildFileConditionSQL, NodeQuery } from '../query-builder.js';
+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.
+ */
+export function findNodesWithFanIn(db, namePattern, opts = {}, nativeDb) {
+    const q = new NodeQuery()
+        .select('n.*, COALESCE(fi.cnt, 0) AS fan_in')
+        .withFanIn()
+        .where('n.name LIKE ?', namePattern);
+    if (opts.kinds) {
+        q.kinds(opts.kinds);
+    }
+    if (opts.file) {
+        q.fileFilter(opts.file);
+    }
+    return q.all(db, nativeDb);
+}
+/** Validate kind and role options, throwing on invalid values. */
+function validateTriageOpts(opts) {
+    if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
+        throw new ConfigError(`Invalid kind: ${opts.kind} (expected one of ${EVERY_SYMBOL_KIND.join(', ')})`);
+    }
+    if (opts.role && !VALID_ROLES.includes(opts.role)) {
+        throw new ConfigError(`Invalid role: ${opts.role} (expected one of ${VALID_ROLES.join(', ')})`);
+    }
+}
+/**
+ * Fetch nodes for triage scoring: fan-in + complexity + churn.
+ */
+export function findNodesForTriage(db, opts = {}, nativeDb) {
+    validateTriageOpts(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.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,
+              COALESCE(fc.cyclomatic, 0) AS cyclomatic,
+              COALESCE(fc.max_nesting, 0) AS max_nesting,
+              COALESCE(fcc.commit_count, 0) AS churn`)
+        .kinds(kindsToUse)
+        .withFanIn()
+        .withComplexity()
+        .withChurn()
+        .excludeTests(opts.noTests)
+        .fileFilter(opts.file)
+        .roleFilter(opts.role)
+        .orderBy('n.file, n.line');
+    return q.all(db, nativeDb);
+}
+/**
+ * Shared query builder for function/method/class node listing.
+ */
+function _functionNodeQuery(opts = {}) {
+    return new NodeQuery()
+        .select('name, kind, file, line, end_line, role')
+        .kinds(['function', 'method', 'class'])
+        .fileFilter(opts.file)
+        .nameLike(opts.pattern)
+        .excludeTests(opts.noTests)
+        .orderBy('file, line');
+}
+/**
+ * List function/method/class nodes with basic info.
+ */
+export function listFunctionNodes(db, opts = {}, nativeDb) {
+    return _functionNodeQuery(opts).all(db, nativeDb);
+}
+/**
+ * Iterator version of listFunctionNodes for memory efficiency.
+ */
+export function iterateFunctionNodes(db, opts = {}) {
+    return _functionNodeQuery(opts).iterate(db);
+}
+// ─── Statement caches (one prepared statement per db instance) ────────────
+// WeakMap keys on the db object so statements are GC'd when the db closes.
+const _countNodesStmt = new WeakMap();
+const _countEdgesStmt = new WeakMap();
+const _countFilesStmt = new WeakMap();
+const _findNodeByIdStmt = new WeakMap();
+const _findNodesByFileStmt = new WeakMap();
+const _findFileNodesStmt = new WeakMap();
+const _getNodeIdStmt = new WeakMap();
+const _getFunctionNodeIdStmt = new WeakMap();
+const _bulkNodeIdsByFileStmt = new WeakMap();
+const _findNodeChildrenStmt = new WeakMap();
+const _findNodeByQualifiedNameStmt = new WeakMap();
+/**
+ * Count total nodes.
+ */
+export function countNodes(db) {
+    return cachedStmt(_countNodesStmt, db, 'SELECT COUNT(*) AS cnt FROM nodes').get()?.cnt ?? 0;
+}
+/**
+ * Count total edges.
+ */
+export function countEdges(db) {
+    return cachedStmt(_countEdgesStmt, db, 'SELECT COUNT(*) AS cnt FROM edges').get()?.cnt ?? 0;
+}
+/**
+ * Count distinct files.
+ */
+export function countFiles(db) {
+    return (cachedStmt(_countFilesStmt, db, 'SELECT COUNT(DISTINCT file) AS cnt FROM nodes').get()?.cnt ?? 0);
+}
+// ─── Shared node lookups ───────────────────────────────────────────────
+/**
+ * Find a single node by ID.
+ */
+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.
+ */
+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.
+ */
+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.
+ */
+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).
+ */
+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.
+ */
+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.
+ */
+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).
+ */
+export function findNodesByScope(db, scopeName, opts = {}) {
+    let sql = 'SELECT * FROM nodes WHERE scope = ?';
+    const params = [scopeName];
+    if (opts.kind) {
+        sql += ' AND kind = ?';
+        params.push(opts.kind);
+    }
+    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.
+ */
+export function findNodeByQualifiedName(db, qualifiedName, opts = {}) {
+    const fc = buildFileConditionSQL(opts.file ?? '', 'file');
+    if (fc.sql) {
+        return db
+            .prepare(`SELECT * FROM nodes WHERE qualified_name = ?${fc.sql} ORDER BY file, line`)
+            .all(qualifiedName, ...fc.params);
+    }
+    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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,59 @@
+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 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[];
+    findCallersBatch(nodeIds: number[]): Map<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;
+    getFileHash(file: string): string | null;
+    hasImplementsEdges(): boolean;
+    hasCoChangesTable(): boolean;
+}
+//# sourceMappingURL=sqlite-repository.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,199 @@
+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, 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';
+/**
+ * SqliteRepository — wraps existing `fn(db, ...)` repository functions
+ * behind the Repository interface so callers can use `repo.method(...)`.
+ */
+export class SqliteRepository extends Repository {
+    #db;
+    constructor(db) {
+        super();
+        this.#db = db;
+    }
+    /** Expose the underlying db for code that still needs raw access. */
+    get db() {
+        return this.#db;
+    }
+    // ── Node lookups ──────────────────────────────────────────────────
+    findNodeById(id) {
+        return findNodeById(this.#db, id);
+    }
+    findNodesByFile(file) {
+        return findNodesByFile(this.#db, file);
+    }
+    findFileNodes(fileLike) {
+        return findFileNodes(this.#db, fileLike);
+    }
+    findNodesWithFanIn(namePattern, opts) {
+        return findNodesWithFanIn(this.#db, namePattern, opts);
+    }
+    countNodes() {
+        return countNodes(this.#db);
+    }
+    countEdges() {
+        return countEdges(this.#db);
+    }
+    countFiles() {
+        return countFiles(this.#db);
+    }
+    getNodeId(name, kind, file, line) {
+        return getNodeId(this.#db, name, kind, file, line);
+    }
+    getFunctionNodeId(name, file, line) {
+        return getFunctionNodeId(this.#db, name, file, line);
+    }
+    bulkNodeIdsByFile(file) {
+        return bulkNodeIdsByFile(this.#db, file);
+    }
+    findNodeChildren(parentId) {
+        return findNodeChildren(this.#db, parentId);
+    }
+    findNodesByScope(scopeName, opts) {
+        return findNodesByScope(this.#db, scopeName, opts);
+    }
+    findNodeByQualifiedName(qualifiedName, opts) {
+        return findNodeByQualifiedName(this.#db, qualifiedName, opts);
+    }
+    listFunctionNodes(opts) {
+        return listFunctionNodes(this.#db, opts);
+    }
+    iterateFunctionNodes(opts) {
+        return iterateFunctionNodes(this.#db, opts);
+    }
+    findNodesForTriage(opts) {
+        return findNodesForTriage(this.#db, opts);
+    }
+    // ── Edge queries ──────────────────────────────────────────────────
+    findCallees(nodeId) {
+        return findCallees(this.#db, nodeId);
+    }
+    findCallers(nodeId) {
+        return findCallers(this.#db, nodeId);
+    }
+    findCallersBatch(nodeIds) {
+        if (nodeIds.length === 0)
+            return new Map();
+        const placeholders = nodeIds.map(() => '?').join(',');
+        const rows = this.#db
+            .prepare(`SELECT e.target_id AS queried_id, n.id, n.name, n.kind, n.file, n.line, n.end_line
+         FROM edges e JOIN nodes n ON e.source_id = n.id
+         WHERE e.target_id IN (${placeholders}) AND e.kind = 'calls'`)
+            .all(...nodeIds);
+        const result = new Map();
+        for (const row of rows) {
+            const qid = row.queried_id;
+            if (!result.has(qid))
+                result.set(qid, []);
+            result.get(qid).push({
+                id: row.id,
+                name: row.name,
+                kind: row.kind,
+                file: row.file,
+                line: row.line,
+                end_line: row.end_line,
+            });
+        }
+        return result;
+    }
+    findDistinctCallers(nodeId) {
+        return findDistinctCallers(this.#db, nodeId);
+    }
+    findAllOutgoingEdges(nodeId) {
+        return findAllOutgoingEdges(this.#db, nodeId);
+    }
+    findAllIncomingEdges(nodeId) {
+        return findAllIncomingEdges(this.#db, nodeId);
+    }
+    findCalleeNames(nodeId) {
+        return findCalleeNames(this.#db, nodeId);
+    }
+    findCallerNames(nodeId) {
+        return findCallerNames(this.#db, nodeId);
+    }
+    findImportTargets(nodeId) {
+        return findImportTargets(this.#db, nodeId);
+    }
+    findImportSources(nodeId) {
+        return findImportSources(this.#db, nodeId);
+    }
+    findImportDependents(nodeId) {
+        return findImportDependents(this.#db, nodeId);
+    }
+    findCrossFileCallTargets(file) {
+        return findCrossFileCallTargets(this.#db, file);
+    }
+    countCrossFileCallers(nodeId, file) {
+        return countCrossFileCallers(this.#db, nodeId, file);
+    }
+    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);
+    }
+    // ── Graph-read queries ────────────────────────────────────────────
+    getCallableNodes() {
+        return getCallableNodes(this.#db);
+    }
+    getCallEdges() {
+        return getCallEdges(this.#db);
+    }
+    getFileNodesAll() {
+        return getFileNodesAll(this.#db);
+    }
+    getImportEdges() {
+        return getImportEdges(this.#db);
+    }
+    // ── Optional table checks ─────────────────────────────────────────
+    hasCfgTables() {
+        return hasCfgTables(this.#db);
+    }
+    hasEmbeddings() {
+        return hasEmbeddings(this.#db);
+    }
+    hasDataflowTable() {
+        return hasDataflowTable(this.#db);
+    }
+    getComplexityForNode(nodeId) {
+        return getComplexityForNode(this.#db, nodeId);
+    }
+    // ── Convenience queries ────────────────────────────────────────────
+    getFileHash(file) {
+        const row = this.#db.prepare('SELECT hash FROM file_hashes WHERE file = ?').get(file);
+        return row?.hash ?? null;
+    }
+    #implementsEdgesCache;
+    hasImplementsEdges() {
+        if (this.#implementsEdgesCache !== undefined)
+            return this.#implementsEdgesCache;
+        this.#implementsEdgesCache = !!this.#db
+            .prepare("SELECT 1 FROM edges WHERE kind = 'implements' LIMIT 1")
+            .get();
+        return this.#implementsEdgesCache;
+    }
+    #coChangesTableCache;
+    hasCoChangesTable() {
+        if (this.#coChangesTableCache !== undefined)
+            return this.#coChangesTableCache;
+        try {
+            this.#coChangesTableCache = !!this.#db.prepare('SELECT 1 FROM co_changes LIMIT 1').get();
+        }
+        catch {
+            this.#coChangesTableCache = false;
+        }
+        return this.#coChangesTableCache;
+    }
+}
+//# sourceMappingURL=sqlite-repository.js.map

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

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

package/dist/domain/analysis/brief.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Produce a token-efficient file brief: symbols with roles and caller counts,
+ * importer info with transitive count, and file risk tier.
+ */
+export declare function briefData(file: string, customDbPath: string, opts?: {
+    noTests?: boolean;
+    config?: any;
+}): {
+    file: string;
+    results: {
+        file: string;
+        risk: "high" | "medium" | "low";
+        imports: string[];
+        importedBy: string[];
+        totalImporterCount: number;
+        symbols: {
+            name: string;
+            kind: import("../../types.js").AnyNodeKind;
+            line: number;
+            role: import("../../types.js").Role | null;
+            callerCount: number;
+        }[];
+    }[];
+};
+//# sourceMappingURL=brief.d.ts.map

package/dist/domain/analysis/brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../../src/domain/analysis/brief.ts"],"names":[],"mappings":"AAqGA;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAO;;;;;;;;;;;;;;;;EAwD/C"}

package/dist/domain/analysis/brief.js

@@ -0,0 +1,136 @@
+import { loadConfig } from '../../infrastructure/config.js';
+import { isTestFile } from '../../infrastructure/test-filter.js';
+import { withRepo } from './query-helpers.js';
+/** Symbol kinds meaningful for a file brief — excludes parameters, properties, constants. */
+const BRIEF_KINDS = new Set([
+    'function',
+    'method',
+    'class',
+    'interface',
+    'type',
+    'struct',
+    'enum',
+    'trait',
+    'record',
+    'module',
+]);
+/**
+ * Compute file risk tier from symbol roles and max fan-in.
+ */
+function computeRiskTier(symbols, highThreshold = 10, mediumThreshold = 3) {
+    let maxCallers = 0;
+    let hasCoreRole = false;
+    for (const s of symbols) {
+        if (s.callerCount > maxCallers)
+            maxCallers = s.callerCount;
+        if (s.role === 'core')
+            hasCoreRole = true;
+    }
+    if (maxCallers >= highThreshold || hasCoreRole)
+        return 'high';
+    if (maxCallers >= mediumThreshold)
+        return 'medium';
+    return 'low';
+}
+/**
+ * BFS to count transitive callers for a single node.
+ * Lightweight variant — only counts, does not collect details.
+ */
+function countTransitiveCallers(repo, startId, noTests, maxDepth = 5) {
+    const visited = new Set([startId]);
+    let frontier = [startId];
+    for (let d = 1; d <= maxDepth; d++) {
+        const nextFrontier = [];
+        for (const fid of frontier) {
+            const callers = repo.findDistinctCallers(fid);
+            for (const c of callers) {
+                if (!visited.has(c.id) && (!noTests || !isTestFile(c.file))) {
+                    visited.add(c.id);
+                    nextFrontier.push(c.id);
+                }
+            }
+        }
+        frontier = nextFrontier;
+        if (frontier.length === 0)
+            break;
+    }
+    return visited.size - 1;
+}
+/**
+ * Count transitive file-level import dependents via BFS.
+ * Depth-bounded to match countTransitiveCallers and keep hook latency predictable.
+ */
+function countTransitiveImporters(repo, fileNodeIds, noTests, maxDepth = 5) {
+    const visited = new Set(fileNodeIds);
+    let frontier = [...fileNodeIds];
+    for (let d = 1; d <= maxDepth; d++) {
+        const nextFrontier = [];
+        for (const current of frontier) {
+            const dependents = repo.findImportDependents(current);
+            for (const dep of dependents) {
+                if (!visited.has(dep.id) && (!noTests || !isTestFile(dep.file))) {
+                    visited.add(dep.id);
+                    nextFrontier.push(dep.id);
+                }
+            }
+        }
+        frontier = nextFrontier;
+        if (frontier.length === 0)
+            break;
+    }
+    return visited.size - fileNodeIds.length;
+}
+/**
+ * Produce a token-efficient file brief: symbols with roles and caller counts,
+ * importer info with transitive count, and file risk tier.
+ */
+export function briefData(file, customDbPath, opts = {}) {
+    return withRepo(customDbPath, (repo) => {
+        const noTests = opts.noTests || false;
+        const config = opts.config || loadConfig();
+        const callerDepth = config.analysis?.briefCallerDepth ?? 5;
+        const importerDepth = config.analysis?.briefImporterDepth ?? 5;
+        const highRiskCallers = config.analysis?.briefHighRiskCallers ?? 10;
+        const mediumRiskCallers = config.analysis?.briefMediumRiskCallers ?? 3;
+        const fileNodes = repo.findFileNodes(`%${file}%`);
+        if (fileNodes.length === 0) {
+            return { file, results: [] };
+        }
+        const results = fileNodes.map((fn) => {
+            // Direct importers
+            let importedBy = repo.findImportSources(fn.id);
+            if (noTests)
+                importedBy = importedBy.filter((i) => !isTestFile(i.file));
+            const directImporters = [...new Set(importedBy.map((i) => i.file))];
+            // Transitive importer count
+            const totalImporterCount = countTransitiveImporters(repo, [fn.id], noTests, importerDepth);
+            // Direct imports
+            let importsTo = repo.findImportTargets(fn.id);
+            if (noTests)
+                importsTo = importsTo.filter((i) => !isTestFile(i.file));
+            // Symbol definitions with roles and caller counts
+            const defs = repo.findNodesByFile(fn.file).filter((d) => BRIEF_KINDS.has(d.kind));
+            const symbols = defs.map((d) => {
+                const callerCount = countTransitiveCallers(repo, d.id, noTests, callerDepth);
+                return {
+                    name: d.name,
+                    kind: d.kind,
+                    line: d.line,
+                    role: d.role || null,
+                    callerCount,
+                };
+            });
+            const riskTier = computeRiskTier(symbols, highRiskCallers, mediumRiskCallers);
+            return {
+                file: fn.file,
+                risk: riskTier,
+                imports: importsTo.map((i) => i.file),
+                importedBy: directImporters,
+                totalImporterCount,
+                symbols,
+            };
+        });
+        return { file, results };
+    });
+}
+//# sourceMappingURL=brief.js.map