ai-localize-reporting 2.0.0 → 2.0.3

package/src/cli-reporter.ts

@@ -1,29 +1,601 @@
 import type { Report } from "ai-localize-shared";
 
+// ─── Terminal helpers ─────────────────────────────────────────────────────────
+
+/** ANSI escape sequences — inline so the package stays dependency-free. */
+const A = {
+  reset:     '\x1b[0m',
+  bold:      '\x1b[1m',
+  dim:       '\x1b[2m',
+  italic:    '\x1b[3m',
+  underline: '\x1b[4m',
+  // foreground
+  black:     '\x1b[30m',
+  red:       '\x1b[31m',
+  green:   '\x1b[32m',
+  yellow:    '\x1b[33m',
+  blue:      '\x1b[34m',
+  magenta:   '\x1b[35m',
+  cyan:      '\x1b[36m',
+  white:     '\x1b[37m',
+  // bright foreground
+  brightRed:     '\x1b[91m',
+  brightGreen:   '\x1b[92m',
+  brightYellow:  '\x1b[93m',
+  brightBlue:    '\x1b[94m',
+  brightMagenta: '\x1b[95m',
+  brightCyan:    '\x1b[96m',
+  brightWhite:   '\x1b[97m',
+  // background
+  bgRed:     '\x1b[41m',
+  bgGreen:   '\x1b[42m',
+  bgYellow:  '\x1b[43m',
+  bgBlue:    '\x1b[44m',
+  bgMagenta: '\x1b[45m',
+  bgCyan:    '\x1b[46m',
+};
+
+function c(color: keyof typeof A, text: string): string {
+  return A[color] + text + A.reset;
+}
+function bold(text: string): string { return A.bold + text + A.reset; }
+function dim(text: string): string  { return A.dim  + text + A.reset; }
+
+/** Detect whether the terminal supports colour (respects NO_COLOR env). */
+function supportsColor(): boolean {
+  if (process.env.NO_COLOR || process.env.TERM === 'dumb') return false;
+  if (process.stdout && !process.stdout.isTTY) return false;
+  return true;
+}
+
+/** Strips ANSI codes — used when colour is disabled. */
+function strip(text: string): string {
+  // eslint-disable-next-line no-control-regex
+  return text.replace(/\x1b\[[0-9;]*m/g, '');
+}
+
+/** Returns the printable (non-ANSI) length of a string. */
+function visLen(s: string): number {
+  return strip(s).length;
+}
+
+/** Pad a string on the right to `width` visible characters. */
+function padEnd(s: string, width: number): string {
+  const pad = width - visLen(s);
+  return pad > 0 ? s + ' '.repeat(pad) : s;
+}
+
+/** Pad a string on the left to `width` visible characters. */
+function padStart(s: string, width: number): string {
+  const pad = width - visLen(s);
+  return pad > 0 ? ' '.repeat(pad) + s : s;
+}
+
+// ─── UI primitives ────────────────────────────────────────────────────────────
+
+/** Gets the terminal column width, defaulting to 100. */
+function termWidth(): number {
+  return Math.min(process.stdout.columns || 100, 120);
+}
+
+/** Draws a horizontal rule. */
+function hr(char = '─', color: keyof typeof A = 'dim'): string {
+  const line = char.repeat(termWidth());
+  return supportsColor() ? A[color] + line + A.reset : line;
+}
+
+/** Centres text within the terminal width. */
+function centre(text: string): string {
+  const visible = visLen(text);
+  const tw = termWidth();
+  if (visible >= tw) return text;
+  const pad = Math.floor((tw - visible) / 2);
+  return ' '.repeat(pad) + text;
+}
+
+/** Renders a status indicator badge. */
+function badge(text: string, ok: boolean): string {
+  return ok
+    ? c('bgGreen', c('black', ` ${text} `))
+    : c('bgRed',   c('white', ` ${text} `));
+}
+
+/** Renders a mini horizontal bar of filled/empty blocks. */
+function miniBar(value: number, max: number, width = 20, color: keyof typeof A = 'cyan'): string {
+  const filled = max > 0 ? Math.round((value / max) * width) : 0;
+  const empty  = width - filled;
+  const bar = c(color, '█'.repeat(filled)) + dim('░'.repeat(empty));
+  return '[' + bar + ']';
+}
+
+/** Renders a progress bar for a percentage value. */
+function progressBar(pct: number, width = 24): string {
+  const filled = Math.round((pct / 100) * width);
+  const empty  = width - filled;
+  let color: keyof typeof A = 'brightGreen';
+  if (pct < 50) color = 'brightRed';
+  else if (pct < 80) color = 'brightYellow';
+  const bar = c(color, '█'.repeat(filled)) + dim('░'.repeat(empty));
+  return '[' + bar + ']';
+}
+
+/** A small status dot. */
+function dot(ok: boolean, warn?: boolean): string {
+  if (ok)   return c('brightGreen', '●');
+  if (warn) return c('brightYellow', '●');
+  return c('brightRed', '●');
+}
+
+
+/** Formats a number with thousands separators. */
+function fmt(n: number): string {
+  return n.toLocaleString();
+}
+
+// ─── Table renderer ───────────────────────────────────────────────────────────
+
+interface Column {
+  header: string;
+  align?: 'left' | 'right' | 'center';
+  maxWidth?: number;
+}
+
+function renderTable(columns: Column[], rows: string[][]): string {
+  if (rows.length === 0) return '';
+
+  // Compute column widths
+  const widths = columns.map((col, i) => {
+    const headerW = visLen(col.header);
+    const maxDataW = rows.reduce((m, row) => Math.max(m, visLen(row[i] ?? '')), 0);
+    const w = Math.max(headerW, maxDataW);
+    return col.maxWidth ? Math.min(w, col.maxWidth) : w;
+  });
+
+  const sepLine = '├' + widths.map((w) => '─'.repeat(w + 2)).join('┼') + '┤';
+  const topLine = '┌' + widths.map((w) => '─'.repeat(w + 2)).join('┬') + '┐';
+  const botLine = '└' + widths.map((w) => '─'.repeat(w + 2)).join('┴') + '┘';
+
+  function renderRow(cells: string[], isHeader = false): string {
+    const parts = cells.map((cell, i) => {
+      const w = widths[i];
+    const col = columns[i];
+// Truncate if needed
+      let s = visLen(cell) > w ? strip(cell).slice(0, w - 1) + '…' : cell;
+      if (isHeader) s = bold(strip(s));
+      // Align
+      if (col?.align === 'right')  s = padStart(s, w);
+  else if (col?.align === 'center') {
+        const p = Math.floor((w - visLen(s)) / 2);
+        s = ' '.repeat(p) + s + ' '.repeat(w - visLen(s) - p);
+      } else {
+     s = padEnd(s, w);
+      }
+    return ' ' + s + ' ';
+    });
+    return '│' + parts.join('│') + '│';
+  }
+
+  const lines: string[] = [];
+  lines.push(dim(topLine));
+  lines.push(renderRow(columns.map((c) => c.header), true));
+  lines.push(dim(sepLine));
+  for (const row of rows) {
+    lines.push(renderRow(row));
+  }
+lines.push(dim(botLine));
+  return lines.join('\n');
+}
+
+// ─── Insight computation ──────────────────────────────────────────────────────
+
+interface CliInsights {
+  coveragePct: number;
+  totalUniqueKeys: number;
+  duplicateTextGroups: number;
+  namespaceCount: number;
+  topMissingLanguages: Array<{ lang: string; count: number }>;
+  topNamespaces: Array<{ ns: string; count: number }>;
+  topContexts: Array<{ ctx: string; count: number }>;
+  unusedTopKeys: string[];
+}
+
+function computeCliInsights(report: Report): CliInsights {
+  const { details } = report;
+
+  // Coverage
+  const totalUniqueKeys = new Set(details.detectedTexts.map((d) => d.suggestedKey)).size;
+  const coveragePct = totalUniqueKeys > 0
+    ? Math.round(((totalUniqueKeys - details.missingKeys.length) / totalUniqueKeys) * 100)
+    : 100;
+
+  // Duplicate texts
+  const textMap = new Map<string, Set<string>>();
+  for (const dt of details.detectedTexts) {
+    const t = dt.text.trim();
+    if (!textMap.has(t)) textMap.set(t, new Set());
+    textMap.get(t)!.add(dt.suggestedKey);
+  }
+  let duplicateTextGroups = 0;
+  for (const [, keys] of textMap) {
+    if (keys.size > 1) duplicateTextGroups++;
+  }
+
+  // Namespace distribution
+  const nsCounts = new Map<string, number>();
+  for (const dt of details.detectedTexts) {
+    const ns = dt.suggestedKey.split('.')[0] || 'default';
+ nsCounts.set(ns, (nsCounts.get(ns) || 0) + 1);
+  }
+  const topNamespaces = [...nsCounts.entries()]
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, 6)
+    .map(([ns, count]) => ({ ns, count }));
+
+  // Context distribution
+  const ctxCounts = new Map<string, number>();
+  for (const dt of details.detectedTexts) {
+    ctxCounts.set(dt.context, (ctxCounts.get(dt.context) || 0) + 1);
+  }
+  const topContexts = [...ctxCounts.entries()]
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, 6)
+.map(([ctx, count]) => ({ ctx, count }));
+
+  // Missing by language
+  const byLang = new Map<string, number>();
+  for (const mk of details.missingKeys) {
+    if (mk.language) byLang.set(mk.language, (byLang.get(mk.language) || 0) + 1);
+  }
+  const topMissingLanguages = [...byLang.entries()]
+  .sort((a, b) => b[1] - a[1])
+    .slice(0, 6)
+    .map(([lang, count]) => ({ lang, count }));
+
+  // Unused top keys
+  const unusedTopKeys = details.unusedKeysList.slice(0, 5);
+
+  return {
+    coveragePct, totalUniqueKeys, duplicateTextGroups,
+    namespaceCount: nsCounts.size,
+    topMissingLanguages, topNamespaces, topContexts, unusedTopKeys,
+  };
+}
+
+// ─── Section renderers ────────────────────────────────────────────────────────
+
+function renderSectionHeader(icon: string, title: string, count?: number, warn = false): string {
+  const countStr = count !== undefined
+    ? ' ' + (count === 0 ? c('brightGreen', `(${count})`) : warn ? c('brightYellow', `(${count})`) : c('brightRed', `(${count})`))
+    : '';
+  return '\n' + bold(c('brightCyan', icon + ' ' + title)) + countStr;
+}
+
+function renderKeyValueSection(pairs: Array<[string, string]>, indent = '  '): string {
+  const keyWidth = Math.max(...pairs.map(([k]) => k.length)) + 1;
+  return pairs.map(([k, v]) =>
+    indent + dim(padEnd(k + ':', keyWidth + 1)) + '  ' + v
+  ).join('\n');
+}
+
+// ─── Main export ──────────────────────────────────────────────────────────────
+
 export function printCliSummary(report: Report): void {
-  const lines = [
-    "",
-    "╔════════════════════════════════════════════════════╗",
-    "║          ai-localize-core  Report Summary      ║",
-    "╚════════════════════════════════════════════════════╝",
-    "",
-    `  Framework        : ${report.framework}`,
-    `  Timestamp        : ${report.timestamp}`,
-    `  Duration         : ${report.duration}ms`,
-    "",
-    "  ─── Localization ────────────────────────────────",
-    `  Files Scanned : ${report.filesScanned}`,
-    `  Hardcoded Texts  : ${report.hardcodedTexts}`,
-    `  Keys Generated   : ${report.localeKeysGenerated}`,
-    `  Missing Trans.   : ${report.missingTranslations}`,
-    `  Unused Keys      : ${report.unusedKeys}`,
-    "",
-    "  ─── Assets / CDN ────────────────────────────────",
-    `  Total Assets     : ${report.assets.totalAssets}`,
-    `  Uploaded Assets  : ${report.assets.uploadedAssets}`,
-    `  Replaced URLs    : ${report.assets.replacedUrls}`,
-    `Legacy CDN URLs  : ${report.assets.legacyCdnUrls}`,
-    "",
-  ];
-  console.log(lines.join('\n'));
+  const {
+    timestamp, framework, duration, filesScanned,
+    hardcodedTexts, localeKeysGenerated: _localeKeysGenerated, unusedKeys, missingTranslations,
+    assets, details,
+  } = report;
+
+  const scanDate = new Date(timestamp).toLocaleString();
+  const ins = computeCliInsights(report);
+  const w = termWidth();
+
+  const out: string[] = [];
+  const ln = (s = '') => out.push(s);
+
+  // ── Banner ────────────────────────────────────────────────────────────────
+  ln();
+  ln(hr('═', 'cyan'));
+  ln(centre(bold(c('brightCyan', '  🌐  ai-localize  ·  Localization Report  '))));
+  ln(hr('═', 'cyan'));
+  ln();
+
+  // ── Meta row ──────────────────────────────────────────────────────────────
+  ln(centre(
+    dim('Framework: ') + c('brightWhite', framework) +
+    dim('  │  ') +
+    dim('Scanned: ') + c('brightWhite', scanDate) +
+    dim('  │  ') +
+    dim('Duration: ') + c('brightWhite', duration + 'ms')
+  ));
+  ln();
+
+  // ── Summary stat cards (2-col layout) ─────────────────────────────────────
+  ln(hr('─'));
+  ln(bold(c('white', '  📊  Summary')));
+  ln(hr('─'));
+  ln();
+
+
+  function statLine(
+    icon: string, label: string, value: number | string,
+    statusOk: boolean, statusWarn = false,
+    hint = ''
+  ): string {
+    const valStr = typeof value === 'number'
+      ? (statusOk ? c('brightGreen', fmt(value)) : statusWarn ? c('brightYellow', fmt(value)) : c('brightRed', fmt(value)))
+      : c('brightWhite', String(value));
+    const d = dot(statusOk, !statusOk && statusWarn);
+    const left  = '  ' + d + ' ' + padEnd(icon + ' ' + label, 26) + ' ' + padStart(valStr, 8);
+    const right = hint ? dim('  ← ' + hint) : '';
+    return left + right;
+}
+
+  ln(statLine('📁', 'Files Scanned',  filesScanned,        true,  false, 'source files processed'));
+  ln(statLine('🔍', 'Hardcoded Texts',     hardcodedTexts,      hardcodedTexts === 0, hardcodedTexts === 0, 'raw strings not yet in t()'));
+  ln(statLine('🔑', 'Unique Keys Generated', ins.totalUniqueKeys, true,  false, 'deduplicated locale keys'));
+  ln(statLine('❌', 'Missing Translations',  missingTranslations, missingTranslations === 0, false, 'absent in target languages'));
+  ln(statLine('🗑 ', 'Unused Keys',           unusedKeys,          unusedKeys === 0, true, 'in locale but not in source'));
+  ln(statLine('📋', 'Duplicate Text Groups', ins.duplicateTextGroups, ins.duplicateTextGroups === 0, true, 'same text → multiple keys'));
+  ln(statLine('📦', 'Total Assets',       assets.totalAssets,  true,  false, 'static asset references'));
+  ln(statLine('☁ ', 'Uploaded to CDN',       assets.uploadedAssets, true, false, 'pushed to S3/CloudFront'));
+  ln(statLine('🔗', 'Legacy CDN URLs',  assets.legacyCdnUrls, assets.legacyCdnUrls === 0, true, 'old CDN refs pending replace'));
+  ln();
+
+  // ── Coverage bar ──────────────────────────────────────────────────────────
+  ln(hr('─'));
+  const covColor: keyof typeof A = ins.coveragePct >= 80 ? 'brightGreen' : ins.coveragePct >= 50 ? 'brightYellow' : 'brightRed';
+  const covLabel = ins.coveragePct === 100 ? '✓ Fully Covered' : ins.coveragePct >= 80 ? '~ Good Coverage' : '✗ Low Coverage';
+  ln(
+    '  ' + bold('🎯 Translation Coverage') + '  ' +
+    progressBar(ins.coveragePct) +
+    '  ' + c(covColor, ins.coveragePct + '%') +
+    '  ' + dim(covLabel)
+  );
+  ln();
+
+  // ── Localization section ───────────────────────────────────────────────────
+  if (details.detectedTexts.length > 0) {
+    ln(hr('─'));
+    ln(renderSectionHeader('🔍', 'Hardcoded Texts', hardcodedTexts, true));
+    ln(dim('  Strings detected in source that are not yet wrapped in a translation call.'));
+    ln();
+
+    // Show top 10 with minibar
+    const maxCount = hardcodedTexts;
+    const topFiles = new Map<string, number>();
+    for (const dt of details.detectedTexts) {
+      const f = dt.filePath.split('/').slice(-2).join('/');
+  topFiles.set(f, (topFiles.get(f) || 0) + 1);
+    }
+    const topFilesSorted = [...topFiles.entries()].sort((a, b) => b[1] - a[1]).slice(0, 8);
+
+    if (topFilesSorted.length > 0) {
+      ln('  ' + bold('Top files with hardcoded text:'));
+      ln();
+ for (const [file, cnt] of topFilesSorted) {
+        ln('  ' + padEnd(dim(file), 48) + ' ' + miniBar(cnt, maxCount, 16) + ' ' + c('brightYellow', String(cnt)));
+      }
+      ln();
+    }
+
+  // Sample of detected texts
+    const sample = details.detectedTexts.slice(0, 5);
+    if (sample.length > 0) {
+      ln('  ' + bold('Sample detected strings:'));
+      ln();
+      const sampleRows = sample.map((t) => [
+        c('cyan', t.filePath.split('/').slice(-2).join('/')),
+        dim(String(t.line)),
+        c('brightWhite', t.text.length > 50 ? t.text.slice(0, 50) + '…' : t.text),
+        dim(t.context),
+      ]);
+      ln(renderTable(
+        [
+       { header: 'File', maxWidth: 36 },
+          { header: 'Line', align: 'right', maxWidth: 6 },
+          { header: 'Text', maxWidth: 52 },
+          { header: 'Context', maxWidth: 20 },
+  ],
+        sampleRows
+    ).split('\n').map((l) => '  ' + l).join('\n'));
+   if (details.detectedTexts.length > 5) {
+     ln();
+  ln('  ' + dim(`… and ${details.detectedTexts.length - 5} more. Run `) + c('cyan', 'ai-localize report') + dim(' for the full HTML report.'));
+    }
+      ln();
+    }
+  }
+
+  // ── Missing translations ───────────────────────────────────────────────────
+  if (missingTranslations > 0) {
+    ln(hr('─'));
+    ln(renderSectionHeader('❌', 'Missing Translations', missingTranslations));
+    ln(dim('  Keys present in the default language but absent in one or more target language files.'));
+    ln();
+
+    if (ins.topMissingLanguages.length > 0) {
+      const maxMissing = ins.topMissingLanguages[0].count;
+      ln('  ' + bold('Missing keys by language:'));
+      ln();
+      for (const { lang, count } of ins.topMissingLanguages) {
+        ln('  ' + padEnd(c('brightMagenta', lang), 18) + ' ' + miniBar(count, maxMissing, 20, 'brightRed') + ' ' + c('brightRed', String(count) + ' key' + (count > 1 ? 's' : '')));
+      }
+      ln();
+    }
+
+    // Sample missing keys
+ const missSample = details.missingKeys.slice(0, 5);
+    if (missSample.length > 0) {
+      ln('  ' + bold('Sample missing keys:'));
+      ln();
+      const missRows = missSample.map((e) => [
+        c('cyan', e.key.length > 42 ? e.key.slice(0, 42) + '…' : e.key),
+        e.language ? c('brightMagenta', e.language) : dim('—'),
+        dim(e.filePath ? e.filePath.split('/').slice(-2).join('/') : '—'),
+  ]);
+      ln(renderTable(
+        [
+    { header: 'Key', maxWidth: 44 },
+          { header: 'Language', maxWidth: 14 },
+          { header: 'Locale File', maxWidth: 36 },
+ ],
+        missRows
+      ).split('\n').map((l) => '  ' + l).join('\n'));
+      if (details.missingKeys.length > 5) {
+        ln();
+        ln('  ' + dim(`… and ${details.missingKeys.length - 5} more.`));
+      }
+      ln();
+  }
+
+    ln('  ' + dim('💡 Tip: Run ') + c('cyan', 'ai-localize extract') + dim(' to seed target language files with source values.'));
+    ln();
+  } else {
+    ln(hr('─'));
+  ln('  ' + dot(true) + ' ' + bold(c('brightGreen', 'Missing Translations')) + '  ' + c('brightGreen', 'All translations present ✓'));
+    ln();
+}
+
+  // ── Unused keys ────────────────────────────────────────────────────────────
+  if (unusedKeys > 0) {
+    ln(hr('─'));
+  ln(renderSectionHeader('🗑 ', 'Unused Keys', unusedKeys, true));
+    ln(dim('  Translation keys in locale files that are not referenced anywhere in source code.'));
+    ln();
+    if (ins.unusedTopKeys.length > 0) {
+      ln('  ' + bold('Examples:'));
+      for (const key of ins.unusedTopKeys) {
+      ln('  ' + c('yellow', '  ⚠  ') + c('brightYellow', key));
+}
+      if (unusedKeys > ins.unusedTopKeys.length) {
+        ln('  ' + dim(`  … and ${unusedKeys - ins.unusedTopKeys.length} more.`));
+      }
+    }
+    ln();
+    ln('  ' + dim('💡 Tip: Run ') + c('cyan', 'ai-localize cleanup') + dim(' to remove unused keys safely.'));
+    ln();
+  } else {
+    ln(hr('─'));
+    ln('  ' + dot(true) + ' ' + bold(c('brightGreen', 'Unused Keys')) + '  ' + c('brightGreen', 'No unused keys — locale files are clean ✓'));
+    ln();
+  }
+
+  // ── Namespace distribution ─────────────────────────────────────────────────
+  if (ins.topNamespaces.length > 0) {
+    ln(hr('─'));
+    ln(renderSectionHeader('📦', 'Namespace Distribution', ins.namespaceCount));
+    ln(dim('  How locale keys are distributed across namespaces.'));
+    ln();
+    const maxNs = ins.topNamespaces[0]?.count ?? 1;
+    for (const { ns, count } of ins.topNamespaces) {
+      ln('  ' + padEnd(c('brightBlue', ns), 26) + ' ' + miniBar(count, maxNs, 18, 'blue') + ' ' + dim(String(count) + ' key' + (count > 1 ? 's' : '')));
+    }
+    if (ins.namespaceCount > ins.topNamespaces.length) {
+ ln('  ' + dim(`  … and ${ins.namespaceCount - ins.topNamespaces.length} more namespaces.`));
+    }
+    ln();
+  }
+
+  // ── AST context distribution ───────────────────────────────────────────────
+  if (ins.topContexts.length > 0) {
+    ln(hr('─'));
+    ln(renderSectionHeader('🏷 ', 'Text Context Distribution', undefined));
+    ln(dim('  Where hardcoded strings were detected in the AST.'));
+    ln();
+    const maxCtx = ins.topContexts[0]?.count ?? 1;
+    for (const { ctx, count } of ins.topContexts) {
+    ln('  ' + padEnd(c('brightMagenta', ctx), 26) + ' ' + miniBar(count, maxCtx, 18, 'magenta') + ' ' + dim(String(count)));
+    }
+    ln();
+  }
+
+  // ── Assets / CDN ───────────────────────────────────────────────────────────
+  if (assets.totalAssets > 0 || assets.legacyCdnUrls > 0) {
+    ln(hr('─'));
+    ln(renderSectionHeader('📦', 'CDN Assets', undefined));
+    ln();
+    ln(renderKeyValueSection([
+      ['Total Assets Found',   c('brightWhite',  fmt(assets.totalAssets))],
+      ['Uploaded to S3/CDN',   c('brightGreen',  fmt(assets.uploadedAssets))],
+  ['URLs Replaced',        c('brightGreen',  fmt(assets.replacedUrls))],
+      ['Legacy CDN URLs',      assets.legacyCdnUrls > 0
+        ? c('brightYellow', fmt(assets.legacyCdnUrls)) + dim(' ← run ai-localize replace-cdn')
+        : c('brightGreen',  '0')],
+    ]));
+    ln();
+  }
+
+  // ── AI Insights summary ────────────────────────────────────────────────────
+  const hasInsights = ins.duplicateTextGroups > 0 || ins.topMissingLanguages.length > 0 || unusedKeys > 0;
+  ln(hr('─'));
+  ln(bold(c('brightMagenta', '  🤖  AI Insights') + dim(' (deterministic analysis)')));
+  ln();
+
+  if (ins.duplicateTextGroups > 0) {
+ ln('  ' + c('brightYellow', '⚠ ') + c('yellow', ins.duplicateTextGroups + ' duplicate text group' + (ins.duplicateTextGroups > 1 ? 's' : '')) + dim(' — same string mapped to multiple keys. Consider consolidating.'));
+  } else {
+    ln('  ' + c('brightGreen', '✓ ') + dim('No duplicate texts detected.'));
+  }
+
+  if (missingTranslations > 0) {
+    const langList = ins.topMissingLanguages.slice(0, 3).map((l) => c('brightMagenta', l.lang)).join(', ');
+    ln('  ' + c('brightRed', '✗ ') + c('red', missingTranslations + ' missing translation' + (missingTranslations > 1 ? 's' : '')) + dim(' in: ') + langList + (ins.topMissingLanguages.length > 3 ? dim(' + more') : ''));
+  } else {
+    ln('  ' + c('brightGreen', '✓ ') + dim('All translations present across all languages.'));
+  }
+
+  if (unusedKeys > 0) {
+    ln('  ' + c('brightYellow', '⚠ ') + c('yellow', unusedKeys + ' unused key' + (unusedKeys > 1 ? 's' : '')) + dim(' bloating your locale bundles.'));
+  } else {
+    ln('  ' + c('brightGreen', '✓ ') + dim('No unused keys — locale files are lean.'));
+  }
+
+  if (!hasInsights) {
+    ln('  ' + c('brightGreen', '✓ ') + dim('No issues detected. Your localization is in great shape!'));
+  }
+  ln();
+
+  // ── Footer ─────────────────────────────────────────────────────────────────
+  ln(hr('═', 'cyan'));
+
+  // Coverage badge
+  const covBadge = ins.coveragePct === 100
+    ? badge('COVERAGE 100%', true)
+    : ins.coveragePct >= 80
+    ? c('bgYellow', c('black', ` COVERAGE ${ins.coveragePct}% `))
+    : badge(`COVERAGE ${ins.coveragePct}%`, false);
+
+  // Overall status badge
+  const allOk = missingTranslations === 0 && unusedKeys === 0 && hardcodedTexts === 0;
+  const overallBadge = allOk ? badge('  PASS  ', true) : badge('  ISSUES ', false);
+
+  ln(centre(overallBadge + '  ' + covBadge));
+  ln();
+  ln(centre(dim('Generated by ') + bold('ai-localize-core') + dim(' · deterministic, offline-capable i18n tooling')));
+  ln(hr('═', 'cyan'));
+  ln();
+
+  // ── Next-step hints ────────────────────────────────────────────────────────
+  if (!allOk) {
+    ln(bold('  ⚡ Recommended next steps:'));
+    ln();
+    if (hardcodedTexts > 0) {
+      ln('' + c('cyan', '1.') + ' Run ' + c('brightCyan', 'ai-localize full-migrate') + dim(' to wrap hardcoded strings with translation calls.'));
+    }
+    if (missingTranslations > 0) {
+    ln('  ' + c('cyan', '2.') + ' Run ' + c('brightCyan', 'ai-localize extract') + dim(' to seed target language files.'));
+    }
+    if (unusedKeys > 0) {
+      ln('  ' + c('cyan', '3.') + ' Run ' + c('brightCyan', 'ai-localize cleanup') + dim(' to remove unused keys.'));
+    }
+    if (assets.legacyCdnUrls > 0) {
+      ln('  ' + c('cyan', '4.') + ' Run ' + c('brightCyan', 'ai-localize replace-cdn') + dim(' to migrate legacy CDN URLs to CloudFront.'));
+    }
+    ln();
+  }
+
+  // Print everything
+  const output = out.join('\n');
+  process.stdout.write(supportsColor() ? output : strip(output));
 }