Function buildFileCode

src/ui-server/api/filecode.ts:142–188

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

}

export function buildFileCode(
  cg: CodeGraph,
  projectRoot: string,
  requested: string
): WireFileCodePayload {
  const started = Date.now();
  if (requested === '') throw badRequest('No file path was given. Use /api/filecode/<path>.');

  // Refusal first, index lookup second — see `resolveRequestedFile`.
  const { record, storedPath } = resolveRequestedFile(cg, projectRoot, requested);
  const posixPath = toPosixPath(storedPath);

  const nodes = cg.getNodesInFile(storedPath);
  const fileNode = nodes.find((n) => n.kind === 'file') ?? null;
  const { entries: outline, total: outlineTotal } = buildOutlineEntries(cg, nodes);

  const { calls, total: callTotal, intraFileCalls } = buildCalls(cg, nodes, posixPath);
  const outside = buildOutsideRefs(cg, storedPath);

  // One read answers both the drift verdict and the document's height.
  const shape = readFileShape(projectRoot, storedPath, record);

  return {
    file: {
      path: posixPath,
      language: record.language,
      size: record.size,
      indexedAt: record.indexedAt,
      contentHash: record.contentHash,
      generated: record.generated === true,
      test: isTestFile(posixPath),
      // Messages, not the raw records: the screen prints a count and a line,
      // and an extractor's file/line bookkeeping is not something a reader acts
      // on.
      errors: (record.errors ?? []).map((e) => e.message),
      id: fileNode?.id ?? null,
      totalLines: shape.totalLines,
    },
    drift: shape.drift,
    ...(shape.reason ? { reason: shape.reason } : {}),
    outline: wireList(outline, outlineTotal),
    calls: wireList(calls, callTotal),
    outside: wireList(outside.items, outside.total),
    intraFileCalls,
    timing: { elapsedMs: Date.now() - started },
  };
}

/**
 * Every outgoing edge from every symbol in the file, grouped twice over: by the