chekk 0.2.5 → 0.4.0

package/src/display.js

@@ -1,4 +1,5 @@
 import chalk from 'chalk';
+import { BENCHMARKS, DIM_RANGES } from './insights.js';
 
 // ── Color palette ──
 const gold = chalk.hex('#FFD700');
@@ -6,6 +7,9 @@ const purple = chalk.hex('#A855F7');
 const blue = chalk.hex('#3B82F6');
 const green = chalk.hex('#22C55E');
 const cyan = chalk.hex('#06B6D4');
+const orange = chalk.hex('#F97316');
+const red = chalk.hex('#EF4444');
+const yellow = chalk.hex('#EAB308');
 const dim = chalk.dim;
 const bold = chalk.bold;
 const white = chalk.white;
@@ -21,9 +25,9 @@ function tierColor(tier) {
 function scoreColor(score) {
   if (score >= 85) return green;
   if (score >= 70) return cyan;
-  if (score >= 55) return chalk.hex('#EAB308');
-  if (score >= 40) return chalk.hex('#F97316');
-  return chalk.hex('#EF4444');
+  if (score >= 55) return yellow;
+  if (score >= 40) return orange;
+  return red;
 }
 
 function progressBar(score, width = 18) {
@@ -42,9 +46,27 @@ function pad(str, len) {
   return str + ' '.repeat(Math.max(0, len - visible.length));
 }
 
-function snippet(prompt, maxLen = 70) {
+// ── Qualitative tier labels for dimensions ──
+function dimTierLabel(score) {
+  if (score >= 80) return 'EXCEPTIONAL';
+  if (score >= 65) return 'STRONG';
+  if (score >= 50) return 'SOLID';
+  if (score >= 35) return 'DEVELOPING';
+  return 'NEEDS WORK';
+}
+
+function dimTierColor(score) {
+  if (score >= 80) return green;
+  if (score >= 65) return cyan;
+  if (score >= 50) return yellow;
+  if (score >= 35) return orange;
+  return red;
+}
+
+// ── Snippet helpers ──
+
+function cleanPrompt(prompt, maxLen = 120) {
   if (!prompt) return null;
-  // Clean up whitespace / newlines
   let clean = prompt.replace(/\s+/g, ' ').trim();
   if (clean.length > maxLen) {
     clean = clean.slice(0, maxLen - 1) + '\u2026';
@@ -52,10 +74,10 @@ function snippet(prompt, maxLen = 70) {
   return clean;
 }
 
-function displaySnippet(prompt, maxLen = 70) {
-  const s = snippet(prompt, maxLen);
+function displayLabeledSnippet(label, prompt, maxLen = 120) {
+  const s = cleanPrompt(prompt, maxLen);
   if (!s) return;
-  console.log(`  ${dim('\u201C')}${dim.italic(s)}${dim('\u201D')}`);
+  console.log(`  ${dim('\u21B3')} ${dim(label + ':')} ${dim.italic('\u201C' + s + '\u201D')}`);
 }
 
 function pickExample(examples, type) {
@@ -66,7 +88,7 @@ function pickExample(examples, type) {
 
 // ── Box drawing ──
 
-function box(lines, width = 43) {
+function box(lines, width = 47) {
   const out = [];
   out.push(dim('  \u250C' + '\u2500'.repeat(width) + '\u2510'));
   for (const line of lines) {
@@ -78,33 +100,44 @@ function box(lines, width = 43) {
   return out;
 }
 
-function doubleRule(width = 47) {
+function doubleRule(width = 53) {
   return dim('  ' + '\u2550'.repeat(width));
 }
 
+function wrapText(text, maxWidth = 49) {
+  const words = text.split(' ');
+  const lines = [];
+  let current = '';
+  for (const word of words) {
+    if (current.length + word.length + 1 > maxWidth) {
+      lines.push(current);
+      current = word;
+    } else {
+      current = current ? current + ' ' + word : word;
+    }
+  }
+  if (current) lines.push(current);
+  return lines;
+}
+
 // ══════════════════════════════════════════════
-// HEADER
+// HEADER — Scanning + progress
 // ══════════════════════════════════════════════
 
 export function displayHeader() {
   console.log();
   const lines = [
     '',
-    `   ${bold.white('chekk')}${dim(' v0.2.5')}`,
-    `   ${dim('the engineering capability score')}`,
+    `   ${bold.white('chekk')}${dim(' v0.4.0')}`,
+    `   ${dim('engineering capability profile')}`,
     '',
   ];
   for (const l of box(lines, 45)) console.log(l);
   console.log();
 }
 
-// ══════════════════════════════════════════════
-// SCAN RESULTS
-// ══════════════════════════════════════════════
-
 export function displayScan(tools) {
   console.log(dim('  Scanning local AI tools...\n'));
-
   for (const tool of tools) {
     const sessions = numberFormat(tool.sessions);
     const projects = tool.projects.length;
@@ -116,10 +149,6 @@ export function displayScan(tools) {
   console.log();
 }
 
-// ══════════════════════════════════════════════
-// ANALYSIS PROGRESS BAR
-// ══════════════════════════════════════════════
-
 export function displayAnalysisStart(dateRange) {
   console.log(`  ${dim('Analyzing')} ${white(dateRange)}${dim('...\n')}`);
 }
@@ -128,7 +157,6 @@ export async function displayProgressBar(durationMs = 2000) {
   const width = 40;
   const steps = 40;
   const stepTime = durationMs / steps;
-
   for (let i = 0; i <= steps; i++) {
     const filled = i;
     const empty = width - filled;
@@ -139,87 +167,217 @@ export async function displayProgressBar(durationMs = 2000) {
   }
   console.log();
   console.log();
-  console.log(`  ${green('\u2713')} ${dim('Score generated.')}`);
+  console.log(`  ${green('\u2713')} ${dim('Profile generated.')}`);
   console.log();
 }
 
 // ══════════════════════════════════════════════
-// MAIN SCORE DISPLAY
+// PROFILE HEADER — Official document feel
 // ══════════════════════════════════════════════
 
-export function displayScore(result, prose) {
-  const { overall, scores, archetype, tier, tierBadge, tierPercentile } = result;
-  const tc = tierColor(tier);
-  const sc = scoreColor(overall);
+function displayProfileHeader(result, extra = {}) {
+  const { sessionStats } = extra;
+  const now = new Date();
+  const months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+  const dateStr = `${months[now.getMonth()]} ${now.getDate()}, ${now.getFullYear()}`;
 
-  // Big score block
   console.log(doubleRule());
   console.log();
-  console.log(dim('  YOUR CHEKK SCORE'));
+  console.log(`  ${bold.white('ENGINEERING CAPABILITY PROFILE')}`);
   console.log();
-  console.log(`                    ${sc.bold(String(overall))}`);
-  const badgeStr = tierBadge ? ` ${tierBadge}` : '';
-  const pctStr = tierPercentile ? `  ${dim(tierPercentile)}` : '';
-  console.log(`               ${tc('\u2500\u2500 ' + tier + ' \u2500\u2500')}${badgeStr}${pctStr}`);
+  if (sessionStats) {
+    console.log(`  ${dim(`Generated ${dateStr} | chekk v0.4.0`)}`);
+    console.log(`  ${dim(`Analysis: ${sessionStats.totalSessions} sessions \u00B7 ${sessionStats.tools.length} tool${sessionStats.tools.length > 1 ? 's' : ''} \u00B7 ${numberFormat(sessionStats.totalExchanges)} exchanges`)}`);
+    if (sessionStats.dateRangeShort) {
+      console.log(`  ${dim(`Period: ${sessionStats.dateRangeShort}`)}`);
+    }
+  }
   console.log();
-  console.log(`  ${dim('Archetype:')} ${bold.white(archetype.name)}`);
+  console.log(doubleRule());
+}
 
-  if (prose && prose.tagline) {
-    console.log(`  ${dim('"' + prose.tagline + '"')}`);
+// ══════════════════════════════════════════════
+// SUMMARY BLOCK
+// ══════════════════════════════════════════════
+
+function displaySummary(result, extra = {}) {
+  const { overall, scores, archetype, tier, tierBadge, tierPercentile } = result;
+  const { scoreDelta, perToolScores, insights, sessionStats } = extra;
+  const tc = tierColor(tier);
+
+  // Find strongest and weakest
+  const dims = [
+    { label: 'Thinking', score: scores.decomposition },
+    { label: 'Debugging', score: scores.debugCycles },
+    { label: 'AI Leverage', score: scores.aiLeverage },
+    { label: 'Workflow', score: scores.sessionStructure },
+  ];
+  dims.sort((a, b) => b.score - a.score);
+  const strongest = dims[0];
+  const weakest = dims[dims.length - 1];
+
+  console.log();
+  console.log(dim('  SUMMARY'));
+
+  const badge = tierBadge || '';
+  const toolsList = sessionStats ? sessionStats.tools.join(' \u00B7 ') : '';
+  const sessionCount = sessionStats ? `${sessionStats.totalSessions} across ${sessionStats.projectCount} projects` : '';
+  const period = sessionStats?.dateRangeShort || '';
+
+  // Delta string
+  let deltaStr = '';
+  if (scoreDelta !== null && scoreDelta !== undefined) {
+    if (scoreDelta > 0) deltaStr = `  ${green('\u2191 +' + scoreDelta)}`;
+    else if (scoreDelta < 0) deltaStr = `  ${orange('\u2193 ' + scoreDelta)}`;
   }
+
+  const summaryLines = [
+    '',
+    `  ${dim('Score')}          ${scoreColor(overall).bold(String(overall))}${deltaStr}`,
+    `  ${dim('Tier')}           ${tc(tier)} ${badge} ${dim('\u2014')} ${dim(tierPercentile)}`,
+    `  ${dim('Archetype')}      ${bold.white(archetype.name)}`,
+  ];
+  if (toolsList) summaryLines.push(`  ${dim('Tools')}          ${dim(toolsList)}`);
+  if (sessionCount) summaryLines.push(`  ${dim('Sessions')}       ${dim(sessionCount)}`);
+  if (period) summaryLines.push(`  ${dim('Period')}         ${dim(period)}`);
+  summaryLines.push(`  ${dim('Strongest')}      ${dim(strongest.label + ' (' + dimTierLabel(strongest.score) + ')')}`);
+  summaryLines.push(`  ${dim('Growth Area')}    ${dim(weakest.label + ' (' + dimTierLabel(weakest.score) + ')')}`);
+  summaryLines.push('');
+
+  for (const l of box(summaryLines, 53)) console.log(l);
   console.log();
-  console.log(doubleRule());
+}
+
+// ══════════════════════════════════════════════
+// ARCHETYPE DEFINITION
+// ══════════════════════════════════════════════
+
+function displayArchetype(result) {
+  const { archetype } = result;
+  console.log(`  ${bold.white(archetype.name)}`);
   console.log();
+  if (archetype.description) {
+    const lines = wrapText(archetype.description, 51);
+    for (const line of lines) {
+      console.log(`  ${dim(line)}`);
+    }
+  }
+  if (archetype.distribution) {
+    console.log();
+    console.log(`  ${dim('Distribution: ' + archetype.distribution + ' of scored engineers')}`);
+  }
+  console.log();
+}
 
-  // Dimensions box
-  console.log(dim('  DIMENSIONS\n'));
+// ══════════════════════════════════════════════
+// DIMENSIONS — with ranges and qualitative labels
+// ══════════════════════════════════════════════
 
-  // Build dimension lines with fixed-width layout
-  // Format: "  Label          ██████████████░░░░  XX "
-  // Visible: 2 + 15 + 18 + 2 + 3 + 1 = ~41 chars
-  function dimLine(label, score) {
+function displayDimensions(result) {
+  const { scores } = result;
+  console.log(dim('  DIMENSIONS'));
+  console.log();
+
+  // Score weight transparency
+  console.log(`  ${dim('Weights: Thinking 25% | Debugging 25% | AI Leverage 30% | Workflow 20%')}`);
+  console.log();
+
+  function dimLine(label, key, score) {
     const labelStr = bold(label);
     const labelVisible = label.length;
     const labelPad = ' '.repeat(Math.max(0, 15 - labelVisible));
-    const scoreStr = String(score);
-    const scorePad = score < 10 ? '  ' : score < 100 ? ' ' : '';
-    return `  ${labelStr}${labelPad}${progressBar(score)} ${scorePad}${bold(scoreStr)} `;
+    const tierLabel = dimTierLabel(score);
+    const tierStr = dimTierColor(score)(pad(tierLabel, 11));
+    const range = DIM_RANGES[key];
+    const rangeStr = dim(`range: ${range.min}-${range.max} | you: ${score}`);
+    return [
+      `  ${labelStr}${labelPad}${progressBar(score)}  ${tierStr}`,
+      `  ${' '.repeat(15)}${rangeStr}`,
+    ];
   }
 
-  const dimLines = [
-    '',
-    dimLine('Thinking', scores.decomposition),
-    dimLine('Debugging', scores.debugCycles),
-    dimLine('AI Leverage', scores.aiLeverage),
-    dimLine('Workflow', scores.sessionStructure),
-    '',
-  ];
-  for (const l of box(dimLines, 45)) console.log(l);
+  const allLines = [''];
+  allLines.push(...dimLine('Thinking', 'decomposition', scores.decomposition));
+  allLines.push('');
+  allLines.push(...dimLine('Debugging', 'debugCycles', scores.debugCycles));
+  allLines.push('');
+  allLines.push(...dimLine('AI Leverage', 'aiLeverage', scores.aiLeverage));
+  allLines.push('');
+  allLines.push(...dimLine('Workflow', 'sessionStructure', scores.sessionStructure));
+  allLines.push('');
+
+  for (const l of box(allLines, 53)) console.log(l);
+  console.log();
+}
+
+// ══════════════════════════════════════════════
+// CROSS-PLATFORM
+// ══════════════════════════════════════════════
+
+function displayCrossPlatform(perToolScores) {
+  if (!perToolScores || Object.keys(perToolScores).length <= 1) return;
+
+  console.log(dim('  CROSS-PLATFORM\n'));
+  const sorted = Object.entries(perToolScores).sort((a, b) => {
+    if (a[1].score === null) return 1;
+    if (b[1].score === null) return -1;
+    return b[1].score - a[1].score;
+  });
+  const maxSessions = Math.max(...sorted.map(([, v]) => v.sessions));
+
+  for (const [tool, data] of sorted) {
+    if (data.score !== null) {
+      const isPrimary = data.sessions === maxSessions;
+      const label = isPrimary ? 'primary tool' : data.sessions < 5 ? 'limited usage' : 'active';
+      console.log(`  ${pad(bold(tool), 18)} ${bold(String(data.score))} ${progressBar(data.score)}  ${dim(label)}`);
+    } else {
+      console.log(`  ${pad(bold(tool), 18)} ${dim('--')} ${dim('\u2591'.repeat(18))}  ${dim('limited data')}`);
+    }
+  }
   console.log();
 }
 
 // ══════════════════════════════════════════════
-// DIMENSION NARRATIVES (data-driven, punchy)
+// PROJECT ANALYSIS
+// ══════════════════════════════════════════════
+
+function displayProjects(insights) {
+  const projects = insights?.projectComplexity;
+  if (!projects || projects.length === 0) return;
+
+  console.log(dim('  PROJECT ANALYSIS\n'));
+  for (const p of projects) {
+    const compColor = p.complexity === 'HIGH' ? green : p.complexity === 'MEDIUM' ? yellow : dim;
+    const signals = p.signals.length > 0 ? p.signals.join(' \u00B7 ') : '';
+    console.log(`  ${pad(bold(p.name), 32)} Complexity: ${compColor(p.complexity)}`);
+    if (signals) {
+      console.log(`  ${dim(signals)}`);
+    }
+    console.log(`  ${dim(`${p.sessions} sessions \u00B7 ${numberFormat(p.exchanges)} exchanges \u00B7 ${p.daysActive} days active`)}`);
+    console.log();
+  }
+}
+
+// ══════════════════════════════════════════════
+// DIMENSION NARRATIVES — Clinical, benchmarked
 // ══════════════════════════════════════════════
 
 export function displayNarratives(metrics, prose) {
-  // Track shown snippets globally to avoid duplicates across sections
   const shownSnippets = new Set();
-  function showUniqueSnippet(prompt) {
+  function showLabeledSnippet(label, prompt) {
     if (!prompt) return;
-    const s = snippet(prompt, 70);
+    const s = cleanPrompt(prompt, 120);
     if (shownSnippets.has(s)) return;
     shownSnippets.add(s);
-    displaySnippet(prompt);
+    displayLabeledSnippet(label, prompt);
   }
 
   if (prose && prose.sections) {
-    // Use DeepSeek-generated prose with inline prompt snippets per section
     const sectionSnippetMap = {
-      'thinking': pickExample(metrics.decomposition.examples, 'decomposition'),
-      'debugging': pickExample(metrics.debugCycles.examples, 'specific_report') || pickExample(metrics.debugCycles.examples, 'quick_fix'),
-      'ai leverage': pickExample(metrics.aiLeverage.examples, 'architectural') || pickExample(metrics.aiLeverage.examples, 'planning'),
-      'workflow': pickExample(metrics.sessionStructure.examples, 'context_setting') || pickExample(metrics.sessionStructure.examples, 'refinement'),
+      'thinking': { label: 'Evidence', prompt: pickExample(metrics.decomposition.examples, 'decomposition') },
+      'debugging': { label: 'Evidence', prompt: pickExample(metrics.debugCycles.examples, 'specific_report') || pickExample(metrics.debugCycles.examples, 'quick_fix') },
+      'ai leverage': { label: 'Evidence', prompt: pickExample(metrics.aiLeverage.examples, 'architectural') || pickExample(metrics.aiLeverage.examples, 'planning') },
+      'workflow': { label: 'Evidence', prompt: pickExample(metrics.sessionStructure.examples, 'context_setting') || pickExample(metrics.sessionStructure.examples, 'refinement') },
     };
 
     for (const section of prose.sections) {
@@ -228,115 +386,204 @@ export function displayNarratives(metrics, prose) {
       for (const line of lines) {
         console.log(`  ${dim(line.trim())}`);
       }
-      // Show relevant prompt snippet under this section
       const titleLower = section.title.toLowerCase();
-      const matchedSnippet = sectionSnippetMap[titleLower];
-      if (matchedSnippet) showUniqueSnippet(matchedSnippet);
+      const matched = sectionSnippetMap[titleLower];
+      if (matched && matched.prompt) showLabeledSnippet(matched.label, matched.prompt);
       console.log();
     }
   } else {
-    // Fallback: data-driven bullet points with inline snippets
-    displayDataNarrativesWithTracker(metrics, shownSnippets);
+    displayDataNarratives(metrics, shownSnippets);
   }
 }
 
-function displayDataNarrativesWithTracker(metrics, shownSnippets) {
+function displayDataNarratives(metrics, shownSnippets) {
   const d = metrics.decomposition.details;
   const db = metrics.debugCycles.details;
   const ai = metrics.aiLeverage.details;
   const ss = metrics.sessionStructure.details;
-  const dEx = metrics.decomposition.examples || [];
-  const dbEx = metrics.debugCycles.examples || [];
-  const aiEx = metrics.aiLeverage.examples || [];
-  const ssEx = metrics.sessionStructure.examples || [];
 
-  function showUniqueSnippet(prompt) {
+  function showSnippet(label, prompt) {
     if (!prompt) return;
-    const s = snippet(prompt, 70);
+    const s = cleanPrompt(prompt, 120);
     if (shownSnippets.has(s)) return;
     shownSnippets.add(s);
-    displaySnippet(prompt);
+    displayLabeledSnippet(label, prompt);
   }
 
-  // Thinking
+  // Thinking — clinical
   console.log(`  ${bold('\uD83E\uDDE0 THINKING')}`);
-  const exchPerSession = d.avgExchangesPerSession;
-  console.log(`  ${dim(exchPerSession > 20 ? `${exchPerSession} avg exchanges/session \u2014 marathon builder` : exchPerSession > 8 ? `${exchPerSession} avg exchanges/session \u2014 iterative` : `${exchPerSession} avg exchanges/session \u2014 concise`)}`);
-  console.log(`  ${dim(d.avgPromptLength > 500 ? `${numberFormat(d.avgPromptLength)} char avg prompt \u2014 thinks out loud` : `${d.avgPromptLength} char avg prompt \u2014 concise communicator`)}`);
-  console.log(`  ${dim(d.multiStepSessions > d.singleShotSessions * 2 ? 'Multi-step decomposition over single-shot' : 'Mix of multi-step and single-shot sessions')}`);
-  showUniqueSnippet(pickExample(dEx, 'decomposition'));
+  console.log(`  ${dim(`Avg session depth: ${d.avgExchangesPerSession} exchanges (benchmark: ${BENCHMARKS.avgExchangesPerSession})`)}`);
+  console.log(`  ${dim(`Avg prompt length: ${numberFormat(d.avgPromptLength)} chars (benchmark: ${BENCHMARKS.avgPromptLength})`)}`);
+  console.log(`  ${dim(`Multi-step ratio: ${d.multiStepSessions}/${d.totalSessions} sessions (${Math.round(d.multiStepSessions / Math.max(1, d.totalSessions) * 100)}%)`)}`);
+  showSnippet('Evidence', pickExample(metrics.decomposition.examples, 'decomposition'));
   console.log();
 
-  // Debugging
+  // Debugging — clinical
   console.log(`  ${bold('\u26A1 DEBUGGING')}`);
-  const turns = db.avgTurnsToResolve;
-  console.log(`  ${dim(turns <= 2 ? `${turns} turns to resolve \u2014 surgical` : turns <= 4 ? `${turns} turns to resolve \u2014 efficient` : `${turns} turns to resolve \u2014 iterative`)}`);
-  console.log(`  ${dim(`${db.specificReportRatio}% specific error reports`)}`);
-  console.log(`  ${dim(db.longLoops === 0 ? 'Zero extended debug loops detected' : `${db.longLoops} extended debug loops`)}`);
-  showUniqueSnippet(pickExample(dbEx, 'specific_report') || pickExample(dbEx, 'quick_fix'));
+  console.log(`  ${dim(`Avg resolution: ${db.avgTurnsToResolve} turns (benchmark: ${BENCHMARKS.avgTurnsToResolve})`)}`);
+  console.log(`  ${dim(`Specific reports: ${db.specificReportRatio}% (benchmark: ${BENCHMARKS.specificReportRatio}%)`)}`);
+  console.log(`  ${dim(`Extended loops: ${db.longLoops} | Quick fixes: ${db.quickFixes}/${db.totalDebugSequences}`)}`);
+  showSnippet('Evidence', pickExample(metrics.debugCycles.examples, 'specific_report') || pickExample(metrics.debugCycles.examples, 'quick_fix'));
   console.log();
 
-  // AI Leverage
+  // AI Leverage — clinical
   console.log(`  ${bold('\uD83D\uDD27 AI LEVERAGE')}`);
-  console.log(`  ${dim(`${ai.highLevelRatio}% architecture prompts \u2014 ${ai.highLevelRatio > 25 ? 'high-level partner usage' : 'room to leverage AI more strategically'}`)}`);
-  const codingRatio = ai.toolDiversity.coding > ai.toolDiversity.research ? 'Coding-heavy' : 'Research-heavy';
-  console.log(`  ${dim(`${codingRatio} over ${ai.toolDiversity.coding > ai.toolDiversity.research ? 'research' : 'coding'}-heavy`)}`);
-  console.log(`  ${dim(`${ai.architecturalPrompts} architectural, ${ai.planningPrompts} planning, ${ai.exploratoryPrompts} exploratory`)}`);
-  showUniqueSnippet(pickExample(aiEx, 'architectural') || pickExample(aiEx, 'planning'));
+  console.log(`  ${dim(`High-level ratio: ${ai.highLevelRatio}% (benchmark: ${BENCHMARKS.highLevelRatio}%)`)}`);
+  console.log(`  ${dim(`Breakdown: ${ai.architecturalPrompts} architectural \u00B7 ${ai.planningPrompts} planning \u00B7 ${ai.exploratoryPrompts} exploratory`)}`);
+  console.log(`  ${dim(`Boilerplate: ${ai.boilerplatePrompts} (${Math.round(ai.boilerplatePrompts / Math.max(1, ai.totalPrompts) * 100)}%) \u00B7 Testing: ${ai.testingPrompts}`)}`);
+  showSnippet('Evidence', pickExample(metrics.aiLeverage.examples, 'architectural') || pickExample(metrics.aiLeverage.examples, 'planning'));
   console.log();
 
-  // Workflow
+  // Workflow — clinical
   console.log(`  ${bold('\uD83D\uDCD0 WORKFLOW')}`);
-  console.log(`  ${dim(`${ss.contextSetRatio}% context-setting rate \u2014 ${ss.contextSetRatio > 50 ? 'deliberate' : ss.contextSetRatio > 25 ? 'moderate' : 'low'}`)}`);
-  console.log(`  ${dim(`${ss.reviewEndRatio}% sessions end with review`)}`);
-  console.log(`  ${dim(`${ss.refinementRatio}% refinement rate \u2014 ${ss.refinementRatio > 20 ? 'critical eye' : 'accepts readily'}`)}`);
-  showUniqueSnippet(pickExample(ssEx, 'context_setting') || pickExample(ssEx, 'refinement'));
+  console.log(`  ${dim(`Context-setting: ${ss.contextSetRatio}% (benchmark: ${BENCHMARKS.contextSetRatio}%)`)}`);
+  console.log(`  ${dim(`Review at end: ${ss.reviewEndRatio}% (benchmark: ${BENCHMARKS.reviewEndRatio}%)`)}`);
+  console.log(`  ${dim(`Refinement rate: ${ss.refinementRatio}% (benchmark: ${BENCHMARKS.refinementRatio}%)`)}`);
+  showSnippet('Evidence', pickExample(metrics.sessionStructure.examples, 'context_setting') || pickExample(metrics.sessionStructure.examples, 'refinement'));
   console.log();
 }
 
-
 // ══════════════════════════════════════════════
-// EASTER EGGS
+// SIGNATURES — What makes you distinctive
 // ══════════════════════════════════════════════
 
-export function displayEasterEggs(result, metrics) {
-  const { overall } = result;
-  const db = metrics.debugCycles.details;
+function displaySignatures(insights) {
+  const sigs = insights?.signatures;
+  if (!sigs || sigs.length === 0) return;
+
+  console.log(dim('  YOUR SIGNATURES\n'));
+  for (const sig of sigs) {
+    console.log(`  ${cyan('\u2726')} ${bold(sig.name)}`);
+    const lines = wrapText(sig.detail, 49);
+    for (const line of lines) {
+      console.log(`    ${dim(line)}`);
+    }
+    console.log();
+  }
+}
+
+// ══════════════════════════════════════════════
+// WATCH POINTS — Areas to improve
+// ══════════════════════════════════════════════
 
-  const eggs = [];
+function displayWatchPoints(insights) {
+  const wps = insights?.watchPoints;
+  if (!wps || wps.length === 0) return;
 
-  if (overall >= 90) {
-    eggs.push('Top-tier. Companies should be applying to you.');
+  console.log(dim('  WATCH POINTS\n'));
+  for (const wp of wps) {
+    console.log(`  ${orange('\u26A0')} ${bold(wp.name)}`);
+    const lines = wrapText(wp.detail, 49);
+    for (const line of lines) {
+      console.log(`    ${dim(line)}`);
+    }
+    console.log();
   }
+}
 
-  if (db.longLoops === 0 && db.totalDebugSequences > 10) {
-    eggs.push('Zero debug spirals. Either you\'re exceptional or your AI is.');
+// ══════════════════════════════════════════════
+// TRAJECTORY — Weekly evolution
+// ══════════════════════════════════════════════
+
+function displayTrajectory(insights) {
+  const traj = insights?.trajectory;
+  if (!traj) return;
+
+  console.log(dim('  YOUR TRAJECTORY\n'));
+  for (let i = 0; i < traj.weeks.length; i++) {
+    const w = traj.weeks[i];
+    const prev = i > 0 ? traj.weeks[i - 1] : null;
+    const arrow = prev ? (w.score > prev.score ? green(' \u2191') : w.score < prev.score ? orange(' \u2193') : dim(' \u2192')) : '';
+    const tierLabel = dimTierLabel(w.score);
+    console.log(`  ${dim(pad(w.label, 16))} Score: ${scoreColor(w.score).bold(String(w.score))}  ${dimTierColor(w.score)(tierLabel)}${arrow}`);
   }
+  console.log();
+  const velColor = traj.velocityLabel === 'FAST' ? green : traj.velocityLabel === 'STEADY' ? cyan : traj.velocityLabel === 'STABLE' ? yellow : orange;
+  console.log(`  ${dim('Learning velocity:')} ${velColor(traj.velocityLabel)} ${dim('\u2014 ' + traj.velocityDetail)}`);
+  console.log();
+}
+
+// ══════════════════════════════════════════════
+// ASSESSMENT — Narrative paragraph
+// ══════════════════════════════════════════════
 
-  if (db.vagueReports === 0 && db.totalDebugSequences > 20) {
-    eggs.push('Never once said "it\'s broken, fix it." Respect.');
+function displayAssessment(insights) {
+  const assessment = insights?.assessment;
+  if (!assessment) return;
+
+  console.log(dim('  ASSESSMENT\n'));
+  const lines = wrapText(assessment, 51);
+  for (const line of lines) {
+    console.log(`  ${dim(line)}`);
   }
+  console.log();
+}
 
-  if (eggs.length > 0) {
-    for (const egg of eggs) {
-      console.log(`  ${dim('\u2727')} ${dim.italic(egg)}`);
-    }
+// ══════════════════════════════════════════════
+// CONFIDENCE INDICATOR
+// ══════════════════════════════════════════════
+
+function displayConfidence(insights, sessionStats) {
+  const conf = insights?.confidence;
+  if (!conf) return;
+
+  const barWidth = 18;
+  const filled = Math.round((conf.score / 100) * barWidth);
+  const empty = barWidth - filled;
+  const confColor = conf.level === 'HIGH' ? green : conf.level === 'MODERATE' ? yellow : orange;
+  const bar = confColor('\u2588'.repeat(filled)) + dim('\u2591'.repeat(empty));
+
+  console.log(`  ${dim('Profile confidence:')} ${bar}  ${confColor(conf.level)}`);
+  if (sessionStats) {
+    console.log(`  ${dim(`Based on ${sessionStats.totalSessions} sessions across ${sessionStats.tools.length} tool${sessionStats.tools.length > 1 ? 's' : ''}.`)}`);
+  }
+  console.log();
+  if (conf.level !== 'HIGH') {
+    console.log(`  ${dim('Confidence increases with more sessions and tool')}`);
+    console.log(`  ${dim('diversity. Run again in 30 days for updated assessment.')}`);
     console.log();
   }
 }
 
 // ══════════════════════════════════════════════
-// VIRAL ENDING
+// METHODOLOGY FOOTER
 // ══════════════════════════════════════════════
 
-export function displayEnding(result) {
+function displayMethodology() {
+  console.log(doubleRule());
+  console.log();
+  console.log(`  ${dim('METHODOLOGY')}`);
+  console.log(`  ${dim('Scores derived from structural analysis of prompt')}`);
+  console.log(`  ${dim('patterns, debug sequences, and session architecture')}`);
+  console.log(`  ${dim('across detected AI coding tools. Tier placement based')}`);
+  console.log(`  ${dim('on distribution of scored engineers. No prompt content')}`);
+  console.log(`  ${dim('is stored or transmitted. Learn more: chekk.dev/methodology')}`);
+  console.log();
+}
+
+// ══════════════════════════════════════════════
+// NEXT STEPS — Credential issuance
+// ══════════════════════════════════════════════
+
+function displayNextSteps(result) {
   const { overall, archetype, tier, tierBadge } = result;
   const tc = tierColor(tier);
 
   console.log(doubleRule());
   console.log();
-  console.log(`  ${dim('\u2192 Claim your profile:')}  ${cyan.underline('chekk.dev/claim')}`);
-  console.log(`  ${dim('\u2192 Leaderboard:')}         ${cyan.underline('chekk.dev/leaderboard')}`);
+  console.log(`  ${bold.white('NEXT STEPS')}`);
+  console.log();
+  console.log(`  ${dim('\u2192 Claim your verified profile')}`);
+  console.log(`    ${dim('Link your GitHub and LinkedIn to create your')}`);
+  console.log(`    ${dim('portable engineering credential.')}`);
+  console.log(`    ${cyan.underline('chekk.dev/claim')}`);
+  console.log();
+  console.log(`  ${dim('\u2192 View industry benchmarks')}`);
+  console.log(`    ${dim('See how you compare across scored engineers.')}`);
+  console.log(`    ${cyan.underline('chekk.dev/benchmarks')}`);
+  console.log();
+  console.log(`  ${dim('\u2192 Export this report')}`);
+  console.log(`    ${dim('npx chekk --json')}`);
   console.log();
 
   // Copy-paste share line
@@ -346,7 +593,7 @@ export function displayEnding(result) {
   console.log(`  ${dim('\u2191 Copy this to share')}`);
   console.log();
   console.log(doubleRule());
-  console.log(`  ${dim('chekk.dev \u2014 the engineering capability score')}`);
+  console.log(`  ${dim('chekk.dev \u2014 engineering capability profiles')}`);
   console.log();
 }
 
@@ -375,65 +622,98 @@ export function displayVerbose(metrics, sessions) {
   }
   console.log();
 
-  // Full metric details
-  console.log(bold('  DECOMPOSITION DETAILS'));
-  for (const [k, v] of Object.entries(metrics.decomposition.details)) {
-    console.log(`  ${dim(pad(k, 30))} ${dim(String(v) + (typeof v === 'number' && k.includes('Ratio') ? '%' : ''))}`);
-  }
+  // Decomposition
+  const d = metrics.decomposition.details;
+  console.log(bold('  DECOMPOSITION'));
+  console.log(`  ${dim(pad('Avg session depth', 30))} ${dim(String(d.avgExchangesPerSession))}  ${dim(`(benchmark: ${BENCHMARKS.avgExchangesPerSession})`)}`);
+  console.log(`  ${dim(pad('Avg prompt length', 30))} ${dim(d.avgPromptLength + ' chars')}  ${dim(`(benchmark: ${BENCHMARKS.avgPromptLength})`)}`);
+  console.log(`  ${dim(pad('Multi-step sessions', 30))} ${dim(String(d.multiStepSessions) + '/' + d.totalSessions)}  ${dim(d.multiStepSessions > d.totalSessions * 0.5 ? '\u2014 strong' : '\u2014 room to grow')}`);
+  console.log(`  ${dim(pad('Single-shot sessions', 30))} ${dim(String(d.singleShotSessions))}`);
+  console.log(`  ${dim(pad('Contextual followups', 30))} ${dim(d.contextualFollowupRatio + '%')}  ${dim(d.contextualFollowupRatio > 20 ? '\u2014 builds on context well' : '\u2014 could reference prior work more')}`);
   console.log();
 
-  console.log(bold('  DEBUG CYCLE DETAILS'));
-  for (const [k, v] of Object.entries(metrics.debugCycles.details)) {
-    console.log(`  ${dim(pad(k, 30))} ${dim(String(v))}`);
-  }
+  // Debug
+  const db = metrics.debugCycles.details;
+  console.log(bold('  DEBUG CYCLES'));
+  console.log(`  ${dim(pad('Total sequences', 30))} ${dim(String(db.totalDebugSequences))}`);
+  console.log(`  ${dim(pad('Avg turns to resolve', 30))} ${dim(String(db.avgTurnsToResolve))}  ${dim(`(benchmark: ${BENCHMARKS.avgTurnsToResolve})`)}`);
+  console.log(`  ${dim(pad('Quick fixes (\u22642 turns)', 30))} ${dim(String(db.quickFixes))}`);
+  console.log(`  ${dim(pad('Extended loops (>5 turns)', 30))} ${dim(String(db.longLoops))}  ${dim(db.longLoops === 0 ? '\u2014 zero spirals' : '')}`);
+  console.log(`  ${dim(pad('Specific report ratio', 30))} ${dim(db.specificReportRatio + '%')}  ${dim(`(benchmark: ${BENCHMARKS.specificReportRatio}%)`)}`);
+  console.log(`  ${dim(pad('Vague reports', 30))} ${dim(String(db.vagueReports))}  ${dim(db.vagueReports === 0 ? '\u2014 never vague' : '')}`);
   console.log();
 
-  console.log(bold('  AI LEVERAGE DETAILS'));
-  for (const [k, v] of Object.entries(metrics.aiLeverage.details)) {
-    if (typeof v === 'object') {
-      for (const [k2, v2] of Object.entries(v)) {
-        console.log(`  ${dim(pad(`  ${k}.${k2}`, 30))} ${dim(String(v2))}`);
-      }
-    } else {
-      console.log(`  ${dim(pad(k, 30))} ${dim(String(v))}`);
-    }
-  }
+  // AI Leverage
+  const ai = metrics.aiLeverage.details;
+  console.log(bold('  AI LEVERAGE'));
+  console.log(`  ${dim(pad('Total prompts', 30))} ${dim(numberFormat(ai.totalPrompts))}`);
+  console.log(`  ${dim(pad('Architectural', 30))} ${dim(String(ai.architecturalPrompts))} ${dim(`(${Math.round(ai.architecturalPrompts / Math.max(1, ai.totalPrompts) * 100)}%)`)}`);
+  console.log(`  ${dim(pad('Planning', 30))} ${dim(String(ai.planningPrompts))} ${dim(`(${Math.round(ai.planningPrompts / Math.max(1, ai.totalPrompts) * 100)}%)`)}`);
+  console.log(`  ${dim(pad('Exploratory', 30))} ${dim(String(ai.exploratoryPrompts))} ${dim(`(${Math.round(ai.exploratoryPrompts / Math.max(1, ai.totalPrompts) * 100)}%)`)}`);
+  console.log(`  ${dim(pad('Boilerplate', 30))} ${dim(String(ai.boilerplatePrompts))} ${dim(`(${Math.round(ai.boilerplatePrompts / Math.max(1, ai.totalPrompts) * 100)}%)`)}  ${dim(ai.boilerplatePrompts < ai.totalPrompts * 0.05 ? '\u2014 minimal' : '')}`);
+  console.log(`  ${dim(pad('Testing', 30))} ${dim(String(ai.testingPrompts))}`);
+  console.log(`  ${dim(pad('High-level ratio', 30))} ${dim(ai.highLevelRatio + '%')}  ${dim(`(benchmark: ${BENCHMARKS.highLevelRatio}%)`)}`);
   console.log();
 
-  console.log(bold('  SESSION STRUCTURE DETAILS'));
-  for (const [k, v] of Object.entries(metrics.sessionStructure.details)) {
-    if (typeof v === 'object') {
-      for (const [k2, v2] of Object.entries(v)) {
-        console.log(`  ${dim(pad(`  ${k}.${k2}`, 30))} ${dim(String(v2))}`);
-      }
-    } else {
-      console.log(`  ${dim(pad(k, 30))} ${dim(String(v) + (typeof v === 'number' && k.includes('Ratio') ? '%' : ''))}`);
-    }
+  // Session structure
+  const ss = metrics.sessionStructure.details;
+  console.log(bold('  SESSION STRUCTURE'));
+  console.log(`  ${dim(pad('Context-setting', 30))} ${dim(ss.contextSetRatio + '%')}  ${dim(`(benchmark: ${BENCHMARKS.contextSetRatio}%)`)}`);
+  console.log(`  ${dim(pad('Plan before code', 30))} ${dim(ss.planBeforeCodeRatio + '%')}`);
+  console.log(`  ${dim(pad('Review at end', 30))} ${dim(ss.reviewEndRatio + '%')}  ${dim(`(benchmark: ${BENCHMARKS.reviewEndRatio}%)`)}`);
+  console.log(`  ${dim(pad('Refinement rate', 30))} ${dim(ss.refinementRatio + '%')}  ${dim(`(benchmark: ${BENCHMARKS.refinementRatio}%)`)}`);
+  console.log(`  ${dim(pad('Avg first prompt', 30))} ${dim(ss.avgFirstPromptLength + ' chars')}`);
+  if (ss.durationDistribution) {
+    const dur = ss.durationDistribution;
+    console.log(`  ${dim(pad('Focused sessions (10-45m)', 30))} ${dim(String(dur.focused))}`);
+    console.log(`  ${dim(pad('Short (<5m)', 30))} ${dim(String(dur.short))}`);
+    console.log(`  ${dim(pad('Medium (5-60m)', 30))} ${dim(String(dur.medium))}`);
+    console.log(`  ${dim(pad('Long (>60m)', 30))} ${dim(String(dur.long))}`);
   }
   console.log();
 }
 
 // ══════════════════════════════════════════════
-// OFFLINE DISPLAY (no API)
+// OFFLINE DISPLAY
 // ══════════════════════════════════════════════
 
-export function displayOffline(result, metrics) {
-  displayScore(result, null);
-  displayDataNarrativesWithTracker(metrics, new Set());
-  displayEasterEggs(result, metrics);
-  console.log(dim('  Run without --offline for personalized AI-generated insights\n'));
-  displayEnding(result);
+export function displayOffline(result, metrics, extra = {}) {
+  displayProfileHeader(result, extra);
+  displaySummary(result, extra);
+  displayArchetype(result);
+  displayDimensions(result);
+  displayCrossPlatform(extra.perToolScores);
+  displayDataNarratives(metrics, new Set());
+  displayProjects(extra.insights);
+  displaySignatures(extra.insights);
+  displayWatchPoints(extra.insights);
+  displayTrajectory(extra.insights);
+  displayAssessment(extra.insights);
+  displayConfidence(extra.insights, extra.sessionStats);
+  displayMethodology();
+  console.log(dim('  Run without --offline for AI-generated narrative insights\n'));
+  displayNextSteps(result);
 }
 
 // ══════════════════════════════════════════════
 // FULL ONLINE DISPLAY
 // ══════════════════════════════════════════════
 
-export function displayFull(result, metrics, prose) {
-  displayScore(result, prose);
+export function displayFull(result, metrics, prose, extra = {}) {
+  displayProfileHeader(result, extra);
+  displaySummary(result, extra);
+  displayArchetype(result);
+  displayDimensions(result);
+  displayCrossPlatform(extra.perToolScores);
   displayNarratives(metrics, prose);
-  displayEasterEggs(result, metrics);
-  displayEnding(result);
+  displayProjects(extra.insights);
+  displaySignatures(extra.insights);
+  displayWatchPoints(extra.insights);
+  displayTrajectory(extra.insights);
+  displayAssessment(extra.insights);
+  displayConfidence(extra.insights, extra.sessionStats);
+  displayMethodology();
+  displayNextSteps(result);
 }
 
 // ── Utility ──