Function buildFile

src/ui-server/api/file.ts:61–164

(cg: CodeGraph, projectRoot: string, requested: string)

}

export function buildFile(cg: CodeGraph, projectRoot: string, requested: string): unknown {
  // Refusal first, index lookup second — a traversal out of the project is a
  // refusal, not "no such file". See `resolveRequestedFile`.
  const { record, storedPath } = resolveRequestedFile(cg, projectRoot, requested);

  const nodes = cg.getNodesInFile(storedPath);
  const nodeIds = nodes.map((n) => n.id);
  const inThisFile = new Set(nodeIds);
  const nodeKindById = new Map(nodes.map((n) => [n.id, n.kind]));
  const fileNode = nodes.find((n) => n.kind === 'file') ?? null;

  // ---------------------------------------------------------------------------
  // Outline
  // ---------------------------------------------------------------------------
  const { entries: outline, total: outlineTotal } = buildOutlineEntries(cg, nodes);

  // ---------------------------------------------------------------------------
  // Import rails
  // ---------------------------------------------------------------------------
  const importsOut = cg.getOutgoingEdgesFrom(nodeIds, ['imports']);
  const importsIn = cg.getIncomingEdgesTo(nodeIds, ['imports']);

  const endpointIds = new Set<string>();
  for (const edge of importsOut) if (!inThisFile.has(edge.target)) endpointIds.add(edge.target);
  for (const edge of importsIn) if (!inThisFile.has(edge.source)) endpointIds.add(edge.source);
  const endpoints = cg.getNodesByIds([...endpointIds]);

  const imports = groupByFile(
    importsOut.filter((e) => !inThisFile.has(e.target)),
    (e) => e.target,
    endpoints
  );
  const importedBy = groupByFile(
    importsIn.filter((e) => !inThisFile.has(e.source)),
    (e) => e.source,
    endpoints
  );

  // Import statements that never resolved — the third-party packages and
  // runtime builtins. Attributed to the file node, which is where extraction
  // records a file-level import.
  const unresolvedImports = fileNode ? unresolvedImportsOf(cg, fileNode.id) : [];

  // Whether the file RUNS anything at its top level. Extraction records a
  // statement outside any definition as an edge out of the FILE node, so a
  // module that only defines things has none and a CLI entry point has many —
  // the same signal `/api/entrypoints` ranks on. It is worth a line on this
  // screen because the outline cannot show it: top-level code belongs to no
  // symbol, so the only way to read it is to open the file node itself.
  // A call made while initializing a module-level variable or constant is
  // attributed to that name (#693), so those names are top-level code too and
  // are counted with the file — the same set `getTopCallingFiles` ranks on.
  const moduleLevelValueIds = fileNode
    ? cg
        .getOutgoingEdgesFrom([fileNode.id], ['contains'])
        .map((e) => e.target)
        .filter((id) => {
          const kind = nodeKindById.get(id);