Function renderMapPretty

src/core/codebase-map.ts:584–679

(map: CodebaseMapSummary)

/** Render a `CodebaseMapSummary` to terminal-friendly box output. */
export function renderMapPretty(map: CodebaseMapSummary): string {
  const ascii = process.env.CODEBASE_CONTEXT_ASCII === '1';
  const h = ascii ? '-' : '─';
  const v = ascii ? '|' : '│';
  const tl = ascii ? '+' : '┌';
  const tr = ascii ? '+' : '┐';
  const bl = ascii ? '+' : '└';
  const br = ascii ? '+' : '┘';
  const lm = ascii ? '+' : '├';
  const rm = ascii ? '+' : '┤';

  const width = 60;
  const inner = width - 2;

  function box(title: string, lines: string[]): string {
    const top = `${tl}${h.repeat(inner)}${tr}`;
    const mid = `${lm}${h.repeat(inner)}${rm}`;
    const bot = `${bl}${h.repeat(inner)}${br}`;
    const titleLine = `${v} ${title.padEnd(inner - 1)}${v}`;
    const contentLines = lines.map((l) => {
      const truncated = l.length > inner - 2 ? l.slice(0, inner - 5) + '...' : l;
      return `${v}  ${truncated.padEnd(inner - 2)}${v}`;
    });
    return [top, titleLine, mid, ...contentLines, bot].join('\n');
  }

  const sections: string[] = [];

  sections.push(box(`Codebase Map — ${map.project}`, []));

  const layerLines =
    map.architecture.layers.length === 0
      ? ['(none)']
      : map.architecture.layers.map((l) =>
          l.hubFile
            ? `${l.name}  ${l.fileCount} files  [${l.hubFile}]`
            : `${l.name}  ${l.fileCount} files`
        );
  sections.push(box('Architecture Layers', layerLines));

  const epLines =
    map.architecture.entrypoints.length === 0 ? ['(none detected)'] : map.architecture.entrypoints;
  sections.push(box('Entrypoints', epLines));

  const hubLines =
    map.architecture.hubFiles.length === 0 ? ['(none detected)'] : map.architecture.hubFiles;
  sections.push(box('Hub Files', hubLines));

  const kiLines =
    map.architecture.keyInterfaces.length === 0
      ? ['(none detected)']
      : map.architecture.keyInterfaces.map(
          (ki) => `${ki.name} ${ki.kind}  ${ki.file} (×${ki.importerCount})`
        );
  sections.push(box('Key Interfaces', kiLines));

  const apiLines =
    map.architecture.apiSurface.length === 0