brief.ts

import {
  findDistinctCallers,
  findFileNodes,
  findImportDependents,
  findImportSources,
  findImportTargets,
  findNodesByFile,
  openReadonlyOrFail,
} from '../../db/index.js';
import { loadConfig } from '../../infrastructure/config.js';
import { isTestFile } from '../../infrastructure/test-filter.js';
import type { BetterSqlite3Database, ImportEdgeRow, NodeRow, RelatedNodeRow } from '../../types.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: Array<{ role: string | null; callerCount: number }>,
  highThreshold = 10,
  mediumThreshold = 3,
): 'high' | 'medium' | 'low' {
  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(
  db: BetterSqlite3Database,
  startId: number,
  noTests: boolean,
  maxDepth = 5,
): number {
  const visited = new Set([startId]);
  let frontier = [startId];

  for (let d = 1; d <= maxDepth; d++) {
    const nextFrontier: number[] = [];
    for (const fid of frontier) {
      const callers = findDistinctCallers(db, fid) as RelatedNodeRow[];
      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(
  db: BetterSqlite3Database,
  fileNodeIds: number[],
  noTests: boolean,
  maxDepth = 5,
): number {
  const visited = new Set(fileNodeIds);
  let frontier = [...fileNodeIds];

  for (let d = 1; d <= maxDepth; d++) {
    const nextFrontier: number[] = [];
    for (const current of frontier) {
      const dependents = findImportDependents(db, current) as RelatedNodeRow[];
      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: string,
  customDbPath: string,
  // biome-ignore lint/suspicious/noExplicitAny: config shape is dynamic
  opts: { noTests?: boolean; config?: any } = {},
) {
  const db = openReadonlyOrFail(customDbPath);
  try {
    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 = findFileNodes(db, `%${file}%`) as NodeRow[];
    if (fileNodes.length === 0) {
      return { file, results: [] };
    }

    const results = fileNodes.map((fn) => {
      // Direct importers
      let importedBy = findImportSources(db, fn.id) as ImportEdgeRow[];
      if (noTests) importedBy = importedBy.filter((i) => !isTestFile(i.file));
      const directImporters = [...new Set(importedBy.map((i) => i.file))];

      // Transitive importer count
      const totalImporterCount = countTransitiveImporters(db, [fn.id], noTests, importerDepth);

      // Direct imports
      let importsTo = findImportTargets(db, fn.id) as ImportEdgeRow[];
      if (noTests) importsTo = importsTo.filter((i) => !isTestFile(i.file));

      // Symbol definitions with roles and caller counts
      const defs = (findNodesByFile(db, fn.file) as NodeRow[]).filter((d) =>
        BRIEF_KINDS.has(d.kind),
      );
      const symbols = defs.map((d) => {
        const callerCount = countTransitiveCallers(db, 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 };
  } finally {
    db.close();
  }
}