Function buildRelationshipHints

src/tools/search-codebase.ts:517–592

(result: SearchResult)

  }

  function buildRelationshipHints(result: SearchResult): RelationshipHints {
    const rPath = result.filePath;
    // Graph keys are relative paths with forward slashes; normalize for comparison
    const rPathNorm =
      path.relative(ctx.rootPath, rPath).replace(/\\/g, '/') || rPath.replace(/\\/g, '/');

    // importedBy: files that import this result (reverse lookup), collect with counts
    const importedByMap = new Map<string, number>();
    for (const [dep, importers] of reverseImports) {
      if (dep === rPathNorm || dep.endsWith(rPathNorm) || rPathNorm.endsWith(dep)) {
        for (const importer of importers) {
          importedByMap.set(importer, (importedByMap.get(importer) || 0) + 1);
        }
      }
    }

    // testedIn: heuristic — same basename with .spec/.test extension
    const testedIn: string[] = [];
    const baseName = path.basename(rPathNorm).replace(/\.[^.]+$/, '');
    const localImportsGraph = getImportsGraph();
    if (localImportsGraph) {
      for (const file of Object.keys(localImportsGraph)) {
        const fileBase = path.basename(file);
        if (
          (fileBase.includes('.spec.') || fileBase.includes('.test.')) &&
          fileBase.startsWith(baseName)
        ) {
          testedIn.push(file);
        }
      }
    }

    // Build condensed relationships
    const condensedRel: Record<string, number | boolean> = {};
    if (importedByMap.size > 0) {
      condensedRel.importedByCount = importedByMap.size;
    }
    if (testedIn.length > 0) {
      condensedRel.hasTests = true;
    }

    // Build hints object with capped arrays
    const hintsObj: Record<string, string[]> = {};

    // Rank importers by count descending, cap at 3
    if (importedByMap.size > 0) {
      const sortedCallers = Array.from(importedByMap.entries())
        .sort((a, b) => b[1] - a[1])
        .slice(0, 3)
        .map(([file]) => file);
      hintsObj.callers = sortedCallers;
      // NOTE: consumers removed — it was identical to callers (pure token waste)
    }

    // Cap tests at 3
    if (testedIn.length > 0) {
      hintsObj.tests = testedIn.slice(0, 3);
    }