chekk 0.1.0 → 0.2.0

package/bin/chekk.js

@@ -7,11 +7,12 @@ const program = new Command();
 
 program
   .name('chekk')
-  .description('See how you prompt. Analyze your AI coding workflow.')
-  .version('0.1.0')
-  .option('--offline', 'Skip prose generation and show raw metrics only')
+  .description('The engineering capability score. See how you prompt.')
+  .version('0.2.0')
+  .option('--offline', 'Skip AI prose generation, show data-driven output')
+  .option('--verbose', 'Show detailed per-project and per-metric breakdowns')
   .option('--json', 'Output raw metrics as JSON')
-  .option('--no-upload', 'Skip the claim/upload prompt')
+  .option('--no-upload', 'Skip the claim prompt')
   .action(async (options) => {
     await run(options);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chekk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "See how you prompt. Chekk analyzes your AI coding workflow and tells you what kind of engineer you are.",
   "bin": {
     "chekk": "./bin/chekk.js"

package/src/display.js

@@ -1,137 +1,371 @@
 import chalk from 'chalk';
 
-/**
- * Display detection results.
- */
-export function displayDetection(tools) {
+// ── Color palette ──
+const gold = chalk.hex('#FFD700');
+const purple = chalk.hex('#A855F7');
+const blue = chalk.hex('#3B82F6');
+const green = chalk.hex('#22C55E');
+const cyan = chalk.hex('#06B6D4');
+const dim = chalk.dim;
+const bold = chalk.bold;
+const white = chalk.white;
+
+function tierColor(tier) {
+  if (tier === 'LEGENDARY') return gold;
+  if (tier === 'RARE') return purple;
+  if (tier === 'UNCOMMON') return blue;
+  return dim;
+}
+
+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');
+}
+
+function progressBar(score, width = 18) {
+  const filled = Math.round((score / 100) * width);
+  const empty = width - filled;
+  return scoreColor(score)('\u2588'.repeat(filled)) + dim('\u2591'.repeat(empty));
+}
+
+function numberFormat(n) {
+  if (n >= 1000) return (n / 1000).toFixed(1).replace(/\.0$/, '') + 'k';
+  return String(n);
+}
+
+function pad(str, len) {
+  const visible = str.replace(/\u001b\[[0-9;]*m/g, '');
+  return str + ' '.repeat(Math.max(0, len - visible.length));
+}
+
+// ── Box drawing ──
+
+function box(lines, width = 43) {
+  const out = [];
+  out.push(dim('  \u250C' + '\u2500'.repeat(width) + '\u2510'));
+  for (const line of lines) {
+    const visible = line.replace(/\u001b\[[0-9;]*m/g, '');
+    const padding = Math.max(0, width - visible.length);
+    out.push(dim('  \u2502') + line + ' '.repeat(padding) + dim('\u2502'));
+  }
+  out.push(dim('  \u2514' + '\u2500'.repeat(width) + '\u2518'));
+  return out;
+}
+
+function doubleRule(width = 47) {
+  return dim('  ' + '\u2550'.repeat(width));
+}
+
+// ══════════════════════════════════════════════
+// HEADER
+// ══════════════════════════════════════════════
+
+export function displayHeader() {
+  console.log();
+  const lines = [
+    '',
+    `   ${bold.white('chekk')}${dim(' v0.2.0')}`,
+    `   ${dim('the engineering capability score')}`,
+    '',
+  ];
+  for (const l of box(lines)) console.log(l);
   console.log();
+}
+
+// ══════════════════════════════════════════════
+// SCAN RESULTS
+// ══════════════════════════════════════════════
+
+export function displayScan(tools) {
+  console.log(dim('  Scanning local AI tools...\n'));
 
   for (const tool of tools) {
     if (tool.status === 'detected_not_supported') {
-      console.log(chalk.dim(`   Found ${tool.tool} — ${tool.message}`));
+      console.log(`  ${dim('\u25CB')} ${dim(tool.tool)}${dim('         detected \u2014 V2')}`);
     } else {
+      const sessions = numberFormat(tool.sessions);
+      const projects = tool.projects.length;
+      const exchanges = numberFormat(tool.estimatedPrompts);
       console.log(
-        chalk.green(`   Found ${tool.tool}`) +
-        chalk.dim(` (${tool.sessions} sessions across ${tool.projects.length} projects)`)
+        `  ${cyan('\u2726')} ${bold.white(tool.tool)}    ` +
+        dim(`${sessions} sessions  \u00B7  ${projects} projects`)
       );
     }
   }
   console.log();
 }
 
-/**
- * Display a progress bar.
- */
-function progressBar(score, width = 20) {
-  const filled = Math.round((score / 100) * width);
-  const empty = width - filled;
+// ══════════════════════════════════════════════
+// ANALYSIS PROGRESS BAR
+// ══════════════════════════════════════════════
+
+export function displayAnalysisStart(dateRange) {
+  console.log(`  ${dim('Analyzing')} ${white(dateRange)}${dim('...\n')}`);
+}
 
-  const color = score >= 80 ? chalk.green :
-                score >= 60 ? chalk.yellow :
-                score >= 40 ? chalk.hex('#FFA500') :
-                chalk.red;
+export async function displayProgressBar(durationMs = 2000) {
+  const width = 40;
+  const steps = 40;
+  const stepTime = durationMs / steps;
 
-  return color('\u2588'.repeat(filled)) + chalk.dim('\u2591'.repeat(empty));
+  for (let i = 0; i <= steps; i++) {
+    const filled = i;
+    const empty = width - filled;
+    const pct = Math.round((i / steps) * 100);
+    const bar = green('\u2588'.repeat(filled)) + dim('\u2591'.repeat(empty));
+    process.stdout.write(`\r  ${bar} ${dim(pct + '%')}`);
+    if (i < steps) await sleep(stepTime);
+  }
+  console.log();
+  console.log();
+  console.log(`  ${green('\u2713')} ${dim('Score generated.')}`);
+  console.log();
 }
 
-/**
- * Display the final Chekk results with prose from the API.
- */
-export function displayResults(result, prose) {
-  const { overall, archetype, tier } = result;
+// ══════════════════════════════════════════════
+// MAIN SCORE DISPLAY
+// ══════════════════════════════════════════════
 
-  const tierColor = tier === 'LEGENDARY' ? chalk.hex('#FFD700') :
-                    tier === 'RARE' ? chalk.hex('#A855F7') :
-                    tier === 'UNCOMMON' ? chalk.hex('#3B82F6') :
-                    chalk.dim;
+export function displayScore(result, prose) {
+  const { overall, scores, archetype, tier } = result;
+  const tc = tierColor(tier);
+  const sc = scoreColor(overall);
 
-  console.log(chalk.dim('\u2500'.repeat(50)));
+  // Big score block
+  console.log(doubleRule());
+  console.log();
+  console.log(dim('  YOUR CHEKK SCORE'));
+  console.log();
+  console.log(`                    ${sc.bold(String(overall))}`);
+  console.log(`               ${tc('\u2500\u2500 ' + tier + ' \u2500\u2500')}`);
   console.log();
+  console.log(`  ${dim('Archetype:')} ${bold.white(archetype.name)}`);
 
-  // Prose sections
+  if (prose && prose.tagline) {
+    console.log(`  ${dim('"' + prose.tagline + '"')}`);
+  }
+  console.log();
+  console.log(doubleRule());
+  console.log();
+
+  // Dimensions box
+  console.log(dim('  DIMENSIONS\n'));
+  const dimLines = [
+    '',
+    `  ${pad(bold('Thinking'), 20)}  ${progressBar(scores.decomposition)}  ${bold(String(scores.decomposition))}`,
+    `  ${pad(bold('Debugging'), 20)} ${progressBar(scores.debugCycles)}  ${bold(String(scores.debugCycles))}`,
+    `  ${pad(bold('AI Leverage'), 20)}${progressBar(scores.aiLeverage)}  ${bold(String(scores.aiLeverage))}`,
+    `  ${pad(bold('Workflow'), 20)}  ${progressBar(scores.sessionStructure)}  ${bold(String(scores.sessionStructure))}`,
+    '',
+  ];
+  for (const l of box(dimLines)) console.log(l);
+  console.log();
+}
+
+// ══════════════════════════════════════════════
+// DIMENSION NARRATIVES (data-driven, punchy)
+// ══════════════════════════════════════════════
+
+export function displayNarratives(metrics, prose) {
   if (prose && prose.sections) {
+    // Use DeepSeek-generated prose
     for (const section of prose.sections) {
-      console.log(`   ${section.emoji}  ${chalk.bold(section.title)}`);
-      // Word-wrap the description
-      const lines = wordWrap(section.description, 45);
+      console.log(`  ${section.emoji} ${bold(section.title.toUpperCase())}`);
+      const lines = section.description.split('\n').filter(l => l.trim());
       for (const line of lines) {
-        console.log(chalk.italic(`   ${chalk.dim('"')}${line}${chalk.dim('"')}`));
+        console.log(`  ${dim(line.trim())}`);
       }
       console.log();
     }
+  } else {
+    // Fallback: data-driven bullet points
+    displayDataNarratives(metrics);
   }
+}
+
+function displayDataNarratives(metrics) {
+  const d = metrics.decomposition.details;
+  const db = metrics.debugCycles.details;
+  const ai = metrics.aiLeverage.details;
+  const ss = metrics.sessionStructure.details;
 
-  console.log(chalk.dim('\u2500'.repeat(50)));
+  // Thinking
+  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')}`);
   console.log();
 
-  // Archetype + tier
-  console.log(`   ${chalk.bold('\u2192')} You're ${chalk.bold.white(archetype.name)}`);
-  if (prose && prose.tagline) {
-    console.log(`     ${chalk.dim('"' + prose.tagline + '"')}`);
-  }
+  // Debugging
+  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`)}`);
+  console.log();
+
+  // AI Leverage
+  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`)}`);
   console.log();
-  console.log(`   ${chalk.bold('\u2192')} Tier: ${tierColor(tier)}  ${progressBar(overall)} ${chalk.bold(overall)}`);
+
+  // Workflow
+  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'}`)}`);
   console.log();
 }
 
-/**
- * Display offline/raw metric results (no API call).
- */
-export function displayOfflineResults(result) {
-  const { overall, scores, archetype, tier } = result;
+// ══════════════════════════════════════════════
+// EASTER EGGS
+// ══════════════════════════════════════════════
 
-  const tierColor = tier === 'LEGENDARY' ? chalk.hex('#FFD700') :
-                    tier === 'RARE' ? chalk.hex('#A855F7') :
-                    tier === 'UNCOMMON' ? chalk.hex('#3B82F6') :
-                    chalk.dim;
+export function displayEasterEggs(result, metrics) {
+  const { overall } = result;
+  const db = metrics.debugCycles.details;
 
-  console.log(chalk.dim('\u2500'.repeat(50)));
-  console.log();
+  const eggs = [];
+
+  if (overall >= 90) {
+    eggs.push('Top-tier. Companies should be applying to you.');
+  }
 
-  console.log(`   ${chalk.bold('Decomposition')}    ${progressBar(scores.decomposition)}  ${scores.decomposition}`);
-  console.log(`   ${chalk.bold('Debug Efficiency')} ${progressBar(scores.debugCycles)}  ${scores.debugCycles}`);
-  console.log(`   ${chalk.bold('AI Leverage')}      ${progressBar(scores.aiLeverage)}  ${scores.aiLeverage}`);
-  console.log(`   ${chalk.bold('Workflow')}         ${progressBar(scores.sessionStructure)}  ${scores.sessionStructure}`);
+  if (db.longLoops === 0 && db.totalDebugSequences > 10) {
+    eggs.push('Zero debug spirals. Either you\'re exceptional or your AI is.');
+  }
+
+  if (db.vagueReports === 0 && db.totalDebugSequences > 20) {
+    eggs.push('Never once said "it\'s broken, fix it." Respect.');
+  }
+
+  if (eggs.length > 0) {
+    for (const egg of eggs) {
+      console.log(`  ${dim('\u2727')} ${dim.italic(egg)}`);
+    }
+    console.log();
+  }
+}
+
+// ══════════════════════════════════════════════
+// VIRAL ENDING
+// ══════════════════════════════════════════════
+
+export function displayEnding(result) {
+  const { overall, archetype, tier } = result;
+  const tc = tierColor(tier);
+
+  console.log(doubleRule());
   console.log();
-  console.log(chalk.dim('\u2500'.repeat(50)));
+  console.log(`  ${dim('\u2192 Claim your profile:')}  ${cyan.underline('chekk.dev/claim')}`);
+  console.log(`  ${dim('\u2192 Leaderboard:')}         ${cyan.underline('chekk.dev/leaderboard')}`);
   console.log();
 
-  console.log(`   ${chalk.bold('\u2192')} You're ${chalk.bold.white(archetype.name)}`);
-  console.log(`   ${chalk.bold('\u2192')} Tier: ${tierColor(tier)}  ${progressBar(overall)} ${chalk.bold(overall)}`);
+  // Copy-paste share line
+  const shareLine = `${overall} \u2014 ${tier} \u2014 ${archetype.name}`;
+  console.log(`  ${dim('"')}${tc(shareLine)}${dim('"')}`);
+  console.log(`  ${dim('\u2191 Copy this to share')}`);
   console.log();
-  console.log(chalk.dim('   Run without --offline for personalized AI-generated insights'));
+  console.log(doubleRule());
+  console.log(`  ${dim('chekk.dev \u2014 the engineering capability score')}`);
   console.log();
 }
 
-/**
- * Display the claim prompt.
- */
-export function displayClaimPrompt(claimUrl) {
-  console.log(chalk.dim('\u2500'.repeat(50)));
+// ══════════════════════════════════════════════
+// VERBOSE: DETAILED BREAKDOWN
+// ══════════════════════════════════════════════
+
+export function displayVerbose(metrics, sessions) {
+  console.log(doubleRule());
+  console.log(dim('\n  DETAILED BREAKDOWN\n'));
+
+  // Per-project stats
+  const projects = {};
+  for (const s of sessions) {
+    const p = s.project || 'unknown';
+    if (!projects[p]) projects[p] = { sessions: 0, exchanges: 0, minutes: 0 };
+    projects[p].sessions++;
+    projects[p].exchanges += s.exchangeCount;
+    projects[p].minutes += s.durationMinutes || 0;
+  }
+
+  console.log(bold('  PROJECTS'));
+  for (const [name, data] of Object.entries(projects).sort((a, b) => b[1].exchanges - a[1].exchanges)) {
+    const shortName = name.length > 30 ? '...' + name.slice(-27) : name;
+    console.log(`  ${dim(pad(shortName, 32))} ${dim(data.sessions + ' sessions')}  ${dim(numberFormat(data.exchanges) + ' exchanges')}`);
+  }
   console.log();
-  console.log(`   ${chalk.bold('Claim your profile:')} ${chalk.cyan.underline(claimUrl)}`);
+
+  // 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') ? '%' : ''))}`);
+  }
   console.log();
-  console.log(chalk.dim('   Connect GitHub + LinkedIn to make your profile'));
-  console.log(chalk.dim('   visible to companies hiring AI-native engineers.'));
+
+  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))}`);
+  }
   console.log();
-}
 
-/**
- * Word wrap text to a max width.
- */
-function wordWrap(text, maxWidth) {
-  const words = text.split(' ');
-  const lines = [];
-  let current = '';
+  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))}`);
+    }
+  }
+  console.log();
 
-  for (const word of words) {
-    if (current.length + word.length + 1 > maxWidth && current.length > 0) {
-      lines.push(current);
-      current = word;
+  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 {
-      current = current ? current + ' ' + word : word;
+      console.log(`  ${dim(pad(k, 30))} ${dim(String(v) + (typeof v === 'number' && k.includes('Ratio') ? '%' : ''))}`);
     }
   }
-  if (current) lines.push(current);
-  return lines;
+  console.log();
+}
+
+// ══════════════════════════════════════════════
+// OFFLINE DISPLAY (no API)
+// ══════════════════════════════════════════════
+
+export function displayOffline(result, metrics) {
+  displayScore(result, null);
+  displayDataNarratives(metrics);
+  displayEasterEggs(result, metrics);
+  console.log(dim('  Run without --offline for personalized AI-generated insights\n'));
+  displayEnding(result);
+}
+
+// ══════════════════════════════════════════════
+// FULL ONLINE DISPLAY
+// ══════════════════════════════════════════════
+
+export function displayFull(result, metrics, prose) {
+  displayScore(result, prose);
+  displayNarratives(metrics, prose);
+  displayEasterEggs(result, metrics);
+  displayEnding(result);
+}
+
+// ── Utility ──
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
 }

package/src/index.js

@@ -1,5 +1,4 @@
 import chalk from 'chalk';
-import ora from 'ora';
 import { detectTools } from './detect.js';
 import { parseAllProjects } from './parsers/claude-code.js';
 import { computeDecomposition } from './metrics/decomposition.js';
@@ -7,81 +6,76 @@ import { computeDebugCycles } from './metrics/debug-cycles.js';
 import { computeAILeverage } from './metrics/ai-leverage.js';
 import { computeSessionStructure } from './metrics/session-structure.js';
 import { computeOverallScore } from './scorer.js';
-import { displayDetection, displayResults, displayOfflineResults, displayClaimPrompt } from './display.js';
+import {
+  displayHeader,
+  displayScan,
+  displayAnalysisStart,
+  displayProgressBar,
+  displayFull,
+  displayOffline,
+  displayVerbose,
+} from './display.js';
 import { generateProse, askClaim, uploadAndClaim } from './upload.js';
 
 export async function run(options = {}) {
-  console.log();
-  console.log(chalk.bold('   chekk') + chalk.dim(' — see how you prompt'));
-  console.log();
+  // ── Header ──
+  displayHeader();
 
-  // Step 1: Detect tools
-  const spinner = ora({ text: 'Scanning for AI coding tools...', indent: 3 }).start();
+  // ── Step 1: Detect tools ──
   const tools = detectTools();
 
   if (tools.length === 0) {
-    spinner.fail('No AI coding tools detected');
-    console.log();
-    console.log(chalk.dim('   Chekk currently supports Claude Code.'));
-    console.log(chalk.dim('   Cursor and Codex support coming in V2.'));
-    console.log();
+    console.log(chalk.dim('  No AI coding tools detected.'));
+    console.log(chalk.dim('  Chekk currently supports Claude Code.'));
+    console.log(chalk.dim('  Cursor and Codex coming in V2.\n'));
     process.exit(1);
   }
 
   const supported = tools.filter(t => t.status !== 'detected_not_supported');
   if (supported.length === 0) {
-    spinner.fail('No supported AI tools found');
-    console.log();
+    console.log(chalk.dim('  No supported tools found.\n'));
     for (const t of tools) {
-      console.log(chalk.dim(`   Found ${t.tool} — ${t.message}`));
+      console.log(chalk.dim(`  ${t.tool} \u2014 ${t.message}`));
     }
     console.log();
     process.exit(1);
   }
 
-  spinner.succeed('Found AI coding tools');
-  displayDetection(tools);
-
-  // Step 2: Parse sessions
-  const parseSpinner = ora({ text: 'Parsing session history...', indent: 3 }).start();
+  displayScan(tools);
 
+  // ── Step 2: Parse sessions ──
   let allSessions = [];
   for (const tool of supported) {
     if (tool.tool === 'Claude Code') {
-      const sessions = parseAllProjects(tool.basePath);
-      allSessions.push(...sessions);
+      allSessions.push(...parseAllProjects(tool.basePath));
     }
   }
 
   if (allSessions.length === 0) {
-    parseSpinner.fail('No sessions found to analyze');
-    console.log();
+    console.log(chalk.dim('  No sessions found to analyze.\n'));
     process.exit(1);
   }
 
-  // Count stats
+  // Stats
   const totalExchanges = allSessions.reduce((sum, s) => sum + s.exchangeCount, 0);
   const projects = [...new Set(allSessions.map(s => s.project))];
-
-  // Date range
   const allTimestamps = allSessions
     .map(s => s.startTime)
     .filter(Boolean)
     .map(t => new Date(t))
     .sort((a, b) => a - b);
-  const dateRange = allTimestamps.length >= 2
+
+  const dateRangeShort = allTimestamps.length >= 2
+    ? formatDateRange(allTimestamps[0], allTimestamps[allTimestamps.length - 1])
+    : 'recent history';
+
+  const dateRangeFull = allTimestamps.length >= 2
     ? `${allTimestamps[0].toLocaleDateString()} to ${allTimestamps[allTimestamps.length - 1].toLocaleDateString()}`
     : 'unknown';
 
-  parseSpinner.succeed(
-    `Parsed ${chalk.bold(allSessions.length)} sessions, ${chalk.bold(totalExchanges)} exchanges`
-  );
-  console.log(chalk.dim(`      ${projects.length} projects — ${dateRange}`));
-  console.log();
-
-  // Step 3: Compute metrics
-  const metricsSpinner = ora({ text: 'Analyzing your workflow patterns...', indent: 3 }).start();
+  displayAnalysisStart(dateRangeShort);
 
+  // ── Step 3: Compute metrics ──
   const metrics = {
     decomposition: computeDecomposition(allSessions),
     debugCycles: computeDebugCycles(allSessions),
@@ -91,64 +85,73 @@ export async function run(options = {}) {
 
   const result = computeOverallScore(metrics);
 
-  metricsSpinner.succeed('Analysis complete');
-  console.log();
-
   const sessionStats = {
     totalSessions: allSessions.length,
     totalExchanges,
     projectCount: projects.length,
-    dateRange,
+    dateRange: dateRangeFull,
     tools: supported.map(t => t.tool),
   };
 
-  // JSON output mode
+  // Progress bar animation
+  await displayProgressBar(1500);
+
+  // ── JSON output ──
   if (options.json) {
     console.log(JSON.stringify({ metrics, result, sessionStats }, null, 2));
     return;
   }
 
-  // Step 4: Generate prose (unless offline)
+  // ── Step 4: Display results ──
   if (options.offline) {
-    displayOfflineResults(result);
+    displayOffline(result, metrics);
   } else {
-    const proseSpinner = ora({ text: 'Generating your personalized profile...', indent: 3 }).start();
-
+    // Generate prose from API
+    let prose = null;
     try {
-      const proseResponse = await generateProse(metrics, result, sessionStats);
-      proseSpinner.succeed('Profile generated');
-      console.log();
-      displayResults(result, proseResponse);
-    } catch (err) {
-      proseSpinner.warn('Could not reach chekk.dev — showing raw scores');
-      console.log();
-      displayOfflineResults(result);
+      prose = await generateProse(metrics, result, sessionStats);
+    } catch {
+      // Silently fall back to data-driven display
     }
+    displayFull(result, metrics, prose);
   }
 
-  // Step 5: Claim prompt
+  // ── Verbose breakdown ──
+  if (options.verbose) {
+    displayVerbose(metrics, allSessions);
+  }
+
+  // ── Step 5: Claim prompt ──
   if (options.upload !== false) {
     try {
       const wantsClaim = await askClaim();
       if (wantsClaim) {
-        const claimSpinner = ora({ text: 'Creating your profile...', indent: 3 }).start();
         try {
           const claimResult = await uploadAndClaim(metrics, result, sessionStats);
-          claimSpinner.succeed('Profile created');
-          displayClaimPrompt(claimResult.claimUrl || 'https://chekk.dev/claim');
+          console.log();
+          console.log(`  ${chalk.green('\u2713')} ${chalk.dim('Profile created:')} ${chalk.cyan.underline(claimResult.claimUrl || 'https://chekk.dev/claim')}`);
+          console.log();
         } catch (err) {
-          claimSpinner.fail('Could not create profile — try again later');
-          console.log(chalk.dim(`      ${err.message}`));
+          console.log();
+          console.log(chalk.dim(`  Could not create profile \u2014 try again later`));
           console.log();
         }
       } else {
         console.log();
-        console.log(chalk.dim('   No worries. Run `npx chekk` again anytime to claim your score.'));
-        console.log();
+        console.log(chalk.dim('  Run `npx chekk` again anytime.\n'));
       }
     } catch {
-      // stdin not available (piped), skip claim
       console.log();
     }
   }
 }
+
+function formatDateRange(start, end) {
+  const months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+  const s = `${months[start.getMonth()]} ${start.getDate()}`;
+  const e = `${months[end.getMonth()]} ${end.getDate()}, ${end.getFullYear()}`;
+  if (start.getFullYear() === end.getFullYear()) {
+    return `${s} \u2013 ${e}`;
+  }
+  return `${s}, ${start.getFullYear()} \u2013 ${e}`;
+}