@boshu2/vibe-check 1.0.0

package/dist/output/terminal.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTerminal = formatTerminal;
+const chalk_1 = __importDefault(require("chalk"));
+const date_fns_1 = require("date-fns");
+function formatTerminal(result) {
+    const lines = [];
+    // Header
+    lines.push('');
+    lines.push(chalk_1.default.bold.cyan('='.repeat(64)));
+    lines.push(chalk_1.default.bold.cyan('                    VIBE-CHECK RESULTS'));
+    lines.push(chalk_1.default.bold.cyan('='.repeat(64)));
+    // Period info
+    const fromStr = (0, date_fns_1.format)(result.period.from, 'MMM d, yyyy');
+    const toStr = (0, date_fns_1.format)(result.period.to, 'MMM d, yyyy');
+    lines.push('');
+    lines.push(chalk_1.default.gray(`  Period: ${fromStr} - ${toStr} (${result.period.activeHours}h active)`));
+    lines.push(chalk_1.default.gray(`  Commits: ${result.commits.total} total (${result.commits.feat} feat, ${result.commits.fix} fix, ${result.commits.docs} docs, ${result.commits.other} other)`));
+    // Metrics table
+    lines.push('');
+    lines.push(chalk_1.default.bold.white('  METRIC                      VALUE      RATING'));
+    lines.push(chalk_1.default.gray('  ' + '-'.repeat(50)));
+    const metrics = [
+        { name: 'Iteration Velocity', metric: result.metrics.iterationVelocity },
+        { name: 'Rework Ratio', metric: result.metrics.reworkRatio },
+        { name: 'Trust Pass Rate', metric: result.metrics.trustPassRate },
+        { name: 'Debug Spiral Duration', metric: result.metrics.debugSpiralDuration },
+        { name: 'Flow Efficiency', metric: result.metrics.flowEfficiency },
+    ];
+    for (const { name, metric } of metrics) {
+        const valueStr = `${metric.value}${metric.unit}`.padEnd(10);
+        const ratingStr = formatRating(metric.rating);
+        lines.push(`  ${name.padEnd(26)} ${valueStr} ${ratingStr}`);
+    }
+    // Overall rating
+    lines.push('');
+    lines.push(chalk_1.default.bold.cyan('-'.repeat(64)));
+    lines.push(`  ${chalk_1.default.bold('OVERALL:')} ${formatOverallRating(result.overall)}`);
+    lines.push(chalk_1.default.bold.cyan('-'.repeat(64)));
+    // Debug spirals
+    if (result.fixChains.length > 0) {
+        lines.push('');
+        lines.push(chalk_1.default.bold.yellow(`  DEBUG SPIRALS (${result.fixChains.length} detected):`));
+        for (const chain of result.fixChains) {
+            const patternStr = chain.pattern ? ` (${chain.pattern})` : '';
+            lines.push(chalk_1.default.yellow(`  - ${chain.component}: ${chain.commits} commits, ${chain.duration}m${patternStr}`));
+        }
+    }
+    // Patterns
+    if (result.patterns.total > 0) {
+        lines.push('');
+        lines.push(chalk_1.default.bold.magenta('  PATTERNS:'));
+        for (const [pattern, count] of Object.entries(result.patterns.categories)) {
+            const tracerNote = pattern !== 'OTHER' ? ' (tracer available)' : '';
+            lines.push(chalk_1.default.magenta(`  - ${pattern}: ${count} fixes${tracerNote}`));
+        }
+    }
+    lines.push('');
+    lines.push(chalk_1.default.bold.cyan('='.repeat(64)));
+    lines.push('');
+    return lines.join('\n');
+}
+function formatRating(rating) {
+    switch (rating) {
+        case 'elite':
+            return chalk_1.default.green.bold('ELITE');
+        case 'high':
+            return chalk_1.default.blue.bold('HIGH');
+        case 'medium':
+            return chalk_1.default.yellow.bold('MEDIUM');
+        case 'low':
+            return chalk_1.default.red.bold('LOW');
+    }
+}
+function formatOverallRating(rating) {
+    switch (rating) {
+        case 'ELITE':
+            return chalk_1.default.green.bold('ELITE');
+        case 'HIGH':
+            return chalk_1.default.blue.bold('HIGH');
+        case 'MEDIUM':
+            return chalk_1.default.yellow.bold('MEDIUM');
+        case 'LOW':
+            return chalk_1.default.red.bold('LOW');
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/output/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/output/terminal.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+export type Rating = 'elite' | 'high' | 'medium' | 'low';
+export type OutputFormat = 'terminal' | 'json' | 'markdown';
+export type OverallRating = 'ELITE' | 'HIGH' | 'MEDIUM' | 'LOW';
+export interface Commit {
+    hash: string;
+    date: Date;
+    message: string;
+    type: 'feat' | 'fix' | 'docs' | 'chore' | 'refactor' | 'test' | 'style' | 'other';
+    scope: string | null;
+    author: string;
+}
+export interface MetricResult {
+    value: number;
+    unit: string;
+    rating: Rating;
+    description: string;
+}
+export interface FixChain {
+    component: string;
+    commits: number;
+    duration: number;
+    isSpiral: boolean;
+    pattern: string | null;
+    firstCommit: Date;
+    lastCommit: Date;
+}
+export interface PatternSummary {
+    categories: Record<string, number>;
+    total: number;
+    tracerAvailable: number;
+}
+export interface VibeCheckResult {
+    period: {
+        from: Date;
+        to: Date;
+        activeHours: number;
+    };
+    commits: {
+        total: number;
+        feat: number;
+        fix: number;
+        docs: number;
+        other: number;
+    };
+    metrics: {
+        iterationVelocity: MetricResult;
+        reworkRatio: MetricResult;
+        trustPassRate: MetricResult;
+        debugSpiralDuration: MetricResult;
+        flowEfficiency: MetricResult;
+    };
+    fixChains: FixChain[];
+    patterns: PatternSummary;
+    overall: OverallRating;
+}
+export interface CliOptions {
+    since?: string;
+    until?: string;
+    format: OutputFormat;
+    repo: string;
+    verbose: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AACzD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEhE,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAClF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,IAAI,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE;QACN,IAAI,EAAE,IAAI,CAAC;QACX,EAAE,EAAE,IAAI,CAAC;QACT,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,OAAO,EAAE;QACP,iBAAiB,EAAE,YAAY,CAAC;QAChC,WAAW,EAAE,YAAY,CAAC;QAC1B,aAAa,EAAE,YAAY,CAAC;QAC5B,mBAAmB,EAAE,YAAY,CAAC;QAClC,cAAc,EAAE,YAAY,CAAC;KAC9B,CAAC;IACF,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@boshu2/vibe-check",
+  "version": "1.0.0",
+  "description": "Measure vibe coding effectiveness with git commit analysis",
+  "main": "dist/cli.js",
+  "bin": {
+    "vibe-check": "./bin/vibe-check.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/cli.ts",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "vibe-coding",
+    "git",
+    "metrics",
+    "developer-productivity",
+    "cli"
+  ],
+  "author": "bodefuller",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boshu2/vibe-check"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^12.1.0",
+    "date-fns": "^3.6.0",
+    "simple-git": "^3.27.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.6",
+    "typescript": "^5.6.3",
+    "ts-node": "^10.9.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { getCommits, isGitRepo } from './git';
+import { analyzeCommits } from './metrics';
+import { formatOutput } from './output';
+import { OutputFormat } from './types';
+
+const program = new Command();
+
+program
+  .name('vibe-check')
+  .description('Measure vibe coding effectiveness with git commit analysis')
+  .version('1.0.0')
+  .option('--since <date>', 'Start date for analysis (e.g., "1 week ago", "2025-11-01")')
+  .option('--until <date>', 'End date for analysis (default: now)')
+  .option(
+    '-f, --format <type>',
+    'Output format: terminal, json, markdown',
+    'terminal'
+  )
+  .option('-r, --repo <path>', 'Repository path (default: current directory)', process.cwd())
+  .option('-v, --verbose', 'Show verbose output', false)
+  .action(async (options) => {
+    try {
+      const { since, until, format, repo, verbose } = options;
+
+      // Validate format
+      const validFormats: OutputFormat[] = ['terminal', 'json', 'markdown'];
+      if (!validFormats.includes(format)) {
+        console.error(chalk.red(`Invalid format: ${format}`));
+        console.error(chalk.gray(`Valid formats: ${validFormats.join(', ')}`));
+        process.exit(1);
+      }
+
+      // Check if repo is valid
+      if (!(await isGitRepo(repo))) {
+        console.error(chalk.red(`Not a git repository: ${repo}`));
+        process.exit(1);
+      }
+
+      if (verbose) {
+        console.error(chalk.gray(`Analyzing repository: ${repo}`));
+        if (since) console.error(chalk.gray(`Since: ${since}`));
+        if (until) console.error(chalk.gray(`Until: ${until}`));
+      }
+
+      // Get commits
+      const commits = await getCommits(repo, since, until);
+
+      if (commits.length === 0) {
+        if (format === 'terminal') {
+          console.log(chalk.yellow('\nNo commits found in the specified range.\n'));
+          if (!since) {
+            console.log(chalk.gray('Try specifying a date range:'));
+            console.log(chalk.gray('  vibe-check --since "1 week ago"'));
+            console.log(chalk.gray('  vibe-check --since "2025-11-01"'));
+          }
+        } else if (format === 'json') {
+          console.log(JSON.stringify({ error: 'No commits found', commits: 0 }));
+        } else {
+          console.log('# Vibe-Check Report\n\nNo commits found in the specified range.');
+        }
+        process.exit(0);
+      }
+
+      if (verbose) {
+        console.error(chalk.gray(`Found ${commits.length} commits`));
+      }
+
+      // Analyze commits
+      const result = analyzeCommits(commits);
+
+      // Output result
+      const output = formatOutput(result, format as OutputFormat);
+      console.log(output);
+
+      // Exit with appropriate code based on overall rating
+      if (result.overall === 'LOW') {
+        process.exit(1);
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        console.error(chalk.red(`Error: ${error.message}`));
+        if (options.verbose) {
+          console.error(chalk.gray(error.stack));
+        }
+      } else {
+        console.error(chalk.red('An unexpected error occurred'));
+      }
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/src/git.ts

@@ -0,0 +1,72 @@
+import simpleGit, { SimpleGit, LogResult, DefaultLogFields } from 'simple-git';
+import { Commit } from './types';
+
+const COMMIT_TYPES = ['feat', 'fix', 'docs', 'chore', 'refactor', 'test', 'style'] as const;
+
+export async function getCommits(
+  repoPath: string,
+  since?: string,
+  until?: string
+): Promise<Commit[]> {
+  const git: SimpleGit = simpleGit(repoPath);
+
+  // Build options for git log
+  const options: Record<string, string | number | boolean> = {};
+
+  if (since) {
+    options['--since'] = since;
+  }
+  if (until) {
+    options['--until'] = until;
+  }
+
+  try {
+    const log: LogResult<DefaultLogFields> = await git.log(options);
+
+    return log.all.map((entry) => parseCommit(entry));
+  } catch (error) {
+    if (error instanceof Error) {
+      throw new Error(`Failed to read git log: ${error.message}`);
+    }
+    throw error;
+  }
+}
+
+function parseCommit(entry: DefaultLogFields): Commit {
+  const { hash, date, message, author_name } = entry;
+
+  // Parse conventional commit format: type(scope): description
+  const conventionalMatch = message.match(/^(\w+)(?:\(([^)]+)\))?:\s*(.+)/);
+
+  let type: Commit['type'] = 'other';
+  let scope: string | null = null;
+
+  if (conventionalMatch) {
+    const [, rawType, rawScope] = conventionalMatch;
+    const normalizedType = rawType.toLowerCase();
+
+    if (COMMIT_TYPES.includes(normalizedType as typeof COMMIT_TYPES[number])) {
+      type = normalizedType as Commit['type'];
+    }
+    scope = rawScope || null;
+  }
+
+  return {
+    hash: hash.substring(0, 7),
+    date: new Date(date),
+    message: message.split('\n')[0], // First line only
+    type,
+    scope,
+    author: author_name,
+  };
+}
+
+export async function isGitRepo(repoPath: string): Promise<boolean> {
+  const git: SimpleGit = simpleGit(repoPath);
+  try {
+    await git.status();
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/metrics/flow.ts

@@ -0,0 +1,53 @@
+import { FixChain, MetricResult, Rating } from '../types';
+
+export function calculateFlowEfficiency(
+  activeMinutes: number,
+  spirals: FixChain[]
+): MetricResult {
+  if (activeMinutes === 0) {
+    return {
+      value: 100,
+      unit: '%',
+      rating: 'elite',
+      description: 'No active time recorded',
+    };
+  }
+
+  const spiralMinutes = spirals
+    .filter((s) => s.isSpiral)
+    .reduce((sum, s) => sum + s.duration, 0);
+
+  const efficiency = ((activeMinutes - spiralMinutes) / activeMinutes) * 100;
+  const clampedEfficiency = Math.max(0, Math.min(100, efficiency));
+  const rating = getRating(clampedEfficiency);
+
+  return {
+    value: Math.round(clampedEfficiency),
+    unit: '%',
+    rating,
+    description: getDescription(rating, spiralMinutes),
+  };
+}
+
+function getRating(efficiency: number): Rating {
+  if (efficiency > 90) return 'elite';
+  if (efficiency >= 75) return 'high';
+  if (efficiency >= 50) return 'medium';
+  return 'low';
+}
+
+function getDescription(rating: Rating, spiralMinutes: number): string {
+  const spiralText =
+    spiralMinutes > 0 ? `${spiralMinutes}m spent in debug spirals` : 'No debug spirals';
+
+  switch (rating) {
+    case 'elite':
+      return `${spiralText}. Excellent productive flow`;
+    case 'high':
+      return `${spiralText}. Good balance`;
+    case 'medium':
+      return `${spiralText}. Significant debugging overhead`;
+    case 'low':
+      return `${spiralText}. More debugging than building`;
+  }
+}

package/src/metrics/index.ts

@@ -0,0 +1,169 @@
+import { Commit, VibeCheckResult, OverallRating, Rating } from '../types';
+import { calculateIterationVelocity, calculateActiveHours } from './velocity';
+import { calculateReworkRatio } from './rework';
+import { calculateTrustPassRate } from './trust';
+import {
+  detectFixChains,
+  calculateDebugSpiralDuration,
+  calculatePatternSummary,
+} from './spirals';
+import { calculateFlowEfficiency } from './flow';
+
+export function analyzeCommits(commits: Commit[]): VibeCheckResult {
+  if (commits.length === 0) {
+    return emptyResult();
+  }
+
+  // Sort commits by date
+  const sorted = [...commits].sort((a, b) => a.date.getTime() - b.date.getTime());
+  const from = sorted[0].date;
+  const to = sorted[sorted.length - 1].date;
+  const activeHours = calculateActiveHours(sorted);
+
+  // Count commit types
+  const commitCounts = countCommitTypes(sorted);
+
+  // Detect fix chains
+  const fixChains = detectFixChains(sorted);
+
+  // Calculate all metrics
+  const iterationVelocity = calculateIterationVelocity(sorted);
+  const reworkRatio = calculateReworkRatio(sorted);
+  const trustPassRate = calculateTrustPassRate(sorted);
+  const debugSpiralDuration = calculateDebugSpiralDuration(fixChains);
+  const flowEfficiency = calculateFlowEfficiency(activeHours * 60, fixChains);
+
+  // Calculate pattern summary
+  const patterns = calculatePatternSummary(fixChains);
+
+  // Determine overall rating
+  const overall = calculateOverallRating([
+    iterationVelocity.rating,
+    reworkRatio.rating,
+    trustPassRate.rating,
+    debugSpiralDuration.rating,
+    flowEfficiency.rating,
+  ]);
+
+  return {
+    period: {
+      from,
+      to,
+      activeHours: Math.round(activeHours * 10) / 10,
+    },
+    commits: commitCounts,
+    metrics: {
+      iterationVelocity,
+      reworkRatio,
+      trustPassRate,
+      debugSpiralDuration,
+      flowEfficiency,
+    },
+    fixChains,
+    patterns,
+    overall,
+  };
+}
+
+function countCommitTypes(commits: Commit[]): VibeCheckResult['commits'] {
+  const counts = {
+    total: commits.length,
+    feat: 0,
+    fix: 0,
+    docs: 0,
+    other: 0,
+  };
+
+  for (const commit of commits) {
+    switch (commit.type) {
+      case 'feat':
+        counts.feat++;
+        break;
+      case 'fix':
+        counts.fix++;
+        break;
+      case 'docs':
+        counts.docs++;
+        break;
+      default:
+        counts.other++;
+    }
+  }
+
+  return counts;
+}
+
+function calculateOverallRating(ratings: Rating[]): OverallRating {
+  const scores: Record<Rating, number> = {
+    elite: 4,
+    high: 3,
+    medium: 2,
+    low: 1,
+  };
+
+  const avgScore =
+    ratings.reduce((sum, r) => sum + scores[r], 0) / ratings.length;
+
+  if (avgScore >= 3.5) return 'ELITE';
+  if (avgScore >= 2.5) return 'HIGH';
+  if (avgScore >= 1.5) return 'MEDIUM';
+  return 'LOW';
+}
+
+function emptyResult(): VibeCheckResult {
+  return {
+    period: {
+      from: new Date(),
+      to: new Date(),
+      activeHours: 0,
+    },
+    commits: {
+      total: 0,
+      feat: 0,
+      fix: 0,
+      docs: 0,
+      other: 0,
+    },
+    metrics: {
+      iterationVelocity: {
+        value: 0,
+        unit: 'commits/hour',
+        rating: 'low',
+        description: 'No commits found',
+      },
+      reworkRatio: {
+        value: 0,
+        unit: '%',
+        rating: 'elite',
+        description: 'No commits found',
+      },
+      trustPassRate: {
+        value: 100,
+        unit: '%',
+        rating: 'elite',
+        description: 'No commits found',
+      },
+      debugSpiralDuration: {
+        value: 0,
+        unit: 'min',
+        rating: 'elite',
+        description: 'No debug spirals detected',
+      },
+      flowEfficiency: {
+        value: 100,
+        unit: '%',
+        rating: 'elite',
+        description: 'No active time recorded',
+      },
+    },
+    fixChains: [],
+    patterns: {
+      categories: {},
+      total: 0,
+      tracerAvailable: 0,
+    },
+    overall: 'HIGH',
+  };
+}
+
+export { calculateActiveHours } from './velocity';

package/src/metrics/rework.ts

@@ -0,0 +1,45 @@
+import { Commit, MetricResult, Rating } from '../types';
+
+export function calculateReworkRatio(commits: Commit[]): MetricResult {
+  if (commits.length === 0) {
+    return {
+      value: 0,
+      unit: '%',
+      rating: 'elite',
+      description: 'No commits found',
+    };
+  }
+
+  const fixCommits = commits.filter((c) => c.type === 'fix').length;
+  const ratio = (fixCommits / commits.length) * 100;
+  const rating = getRating(ratio);
+
+  return {
+    value: Math.round(ratio),
+    unit: '%',
+    rating,
+    description: getDescription(rating, fixCommits, commits.length),
+  };
+}
+
+function getRating(ratio: number): Rating {
+  if (ratio < 30) return 'elite';
+  if (ratio < 50) return 'high';
+  if (ratio < 70) return 'medium';
+  return 'low';
+}
+
+function getDescription(rating: Rating, fixes: number, total: number): string {
+  const fixText = `${fixes}/${total} commits are fixes`;
+
+  switch (rating) {
+    case 'elite':
+      return `${fixText}. Mostly forward progress`;
+    case 'high':
+      return `${fixText}. Normal for complex work`;
+    case 'medium':
+      return `${fixText}. Consider validating assumptions before coding`;
+    case 'low':
+      return `${fixText}. High rework, stop and reassess approach`;
+  }
+}