@eduardbar/drift 0.1.0 → 0.2.0

package/dist/cli.js

@@ -18,8 +18,9 @@ program
     .option('--min-score <n>', 'Exit with code 1 if overall score exceeds this threshold', '0')
     .action((targetPath, options) => {
     const resolvedPath = resolve(targetPath ?? '.');
-    console.error(`\nScanning ${resolvedPath}...`);
+    process.stderr.write(`\nScanning ${resolvedPath}...\n`);
     const files = analyzeProject(resolvedPath);
+    process.stderr.write(`  Found ${files.length} TypeScript file(s)\n\n`);
     const report = buildReport(resolvedPath, files);
     if (options.json) {
         process.stdout.write(JSON.stringify(report, null, 2));

package/dist/printer.js

@@ -1,7 +1,10 @@
 import kleur from 'kleur';
+import { scoreToGrade, severityIcon, scoreBar } from './utils.js';
 export function printConsole(report) {
+    const sep = kleur.gray('  ' + '─'.repeat(50));
     console.log();
-    console.log(kleur.bold().white('  drift') + kleur.gray(' — vibe coding debt detector'));
+    console.log(kleur.bold().white('  drift') + kleur.gray('  —  vibe coding debt detector'));
+    console.log(sep);
     console.log();
     const grade = scoreToGrade(report.totalScore);
     const scoreColor = report.totalScore === 0
@@ -9,8 +12,19 @@ export function printConsole(report) {
         : report.totalScore < 45
             ? kleur.yellow
             : kleur.red;
-    console.log(`  Score  ${scoreColor().bold(String(report.totalScore).padStart(3))}${kleur.gray('/100')}  ${grade.badge}`);
-    console.log(kleur.gray(`  ${report.files.length} file(s) with issues  ·  ${report.summary.errors} errors  ·  ${report.summary.warnings} warnings  ·  ${report.summary.infos} info`));
+    const bar = scoreBar(report.totalScore);
+    console.log(`  Score   ${kleur.gray(bar)}  ${scoreColor().bold(String(report.totalScore))}/100  ${grade.badge}`);
+    const cleanFiles = report.totalFiles - report.files.length;
+    console.log(kleur.gray(`  ${report.files.length} file(s) with issues  ·  ${report.summary.errors} errors  ·  ${report.summary.warnings} warnings  ·  ${report.summary.infos} info  ·  ${cleanFiles} files clean`));
+    console.log();
+    // Top issues in header
+    const topRules = Object.entries(report.summary.byRule).sort((a, b) => b[1] - a[1]).slice(0, 3);
+    if (topRules.length > 0) {
+        const parts = topRules.map(([rule, count]) => `${kleur.cyan(rule)} ${kleur.gray(`×${count}`)}`);
+        console.log(`  Top issues:  ${parts.join(kleur.gray('  ·  '))}`);
+        console.log();
+    }
+    console.log(sep);
     console.log();
     if (report.files.length === 0) {
         console.log(kleur.green('  No drift detected. Clean codebase.'));
@@ -35,37 +49,11 @@ export function printConsole(report) {
                 `  ` +
                 kleur.white(issue.message));
             if (issue.snippet) {
-                console.log(kleur.gray(`       ${issue.snippet.split('\n')[0].slice(0, 100)}`));
+                const snippetIndent = '    ' + ' '.repeat(icon.length + 1);
+                console.log(kleur.gray(`${snippetIndent}${issue.snippet.split('\n')[0].slice(0, 120)}`));
             }
         }
         console.log();
     }
-    // Top drifting rules summary
-    const sorted = Object.entries(report.summary.byRule).sort((a, b) => b[1] - a[1]).slice(0, 3);
-    if (sorted.length > 0) {
-        console.log(kleur.gray('  Top rules:'));
-        for (const [rule, count] of sorted) {
-            console.log(kleur.gray(`    · ${rule}: ${count}`));
-        }
-        console.log();
-    }
-}
-function scoreToGrade(score) {
-    if (score === 0)
-        return { badge: kleur.green('CLEAN') };
-    if (score < 20)
-        return { badge: kleur.green('LOW') };
-    if (score < 45)
-        return { badge: kleur.yellow('MODERATE') };
-    if (score < 70)
-        return { badge: kleur.red('HIGH') };
-    return { badge: kleur.bold().red('CRITICAL') };
-}
-function severityIcon(s) {
-    if (s === 'error')
-        return '✖';
-    if (s === 'warning')
-        return '▲';
-    return '◦';
 }
 //# sourceMappingURL=printer.js.map

package/dist/reporter.js

@@ -1,3 +1,4 @@
+import { scoreToGradeText, severityIcon } from './utils.js';
 export function buildReport(targetPath, files) {
     const allIssues = files.flatMap((f) => f.issues);
     const byRule = {};
@@ -13,6 +14,7 @@ export function buildReport(targetPath, files) {
         files: files.filter((f) => f.issues.length > 0).sort((a, b) => b.score - a.score),
         totalIssues: allIssues.length,
         totalScore,
+        totalFiles: files.length,
         summary: {
             errors: allIssues.filter((i) => i.severity === 'error').length,
             warnings: allIssues.filter((i) => i.severity === 'warning').length,
@@ -22,7 +24,7 @@ export function buildReport(targetPath, files) {
     };
 }
 export function formatMarkdown(report) {
-    const grade = scoreToGrade(report.totalScore);
+    const grade = scoreToGradeText(report.totalScore);
     const lines = [];
     lines.push(`# drift report`);
     lines.push(``);
@@ -62,7 +64,7 @@ export function formatMarkdown(report) {
             for (const issue of file.issues) {
                 const icon = severityIcon(issue.severity);
                 lines.push(`**${icon} [${issue.rule}]** Line ${issue.line}: ${issue.message}`);
-                lines.push(`\`\`\``);
+                lines.push(`\`\`\`typescript`);
                 lines.push(issue.snippet);
                 lines.push(`\`\`\``);
                 lines.push(``);
@@ -71,22 +73,4 @@ export function formatMarkdown(report) {
     }
     return lines.join('\n');
 }
-function scoreToGrade(score) {
-    if (score === 0)
-        return { badge: '✦ CLEAN', label: 'clean' };
-    if (score < 20)
-        return { badge: '◎ LOW', label: 'low' };
-    if (score < 45)
-        return { badge: '◈ MODERATE', label: 'moderate' };
-    if (score < 70)
-        return { badge: '◉ HIGH', label: 'high' };
-    return { badge: '⬡ CRITICAL', label: 'critical' };
-}
-function severityIcon(s) {
-    if (s === 'error')
-        return '✖';
-    if (s === 'warning')
-        return '▲';
-    return '◦';
-}
 //# sourceMappingURL=reporter.js.map

package/dist/types.d.ts

@@ -17,6 +17,7 @@ export interface DriftReport {
     files: FileReport[];
     totalIssues: number;
     totalScore: number;
+    totalFiles: number;
     summary: {
         errors: number;
         warnings: number;

package/dist/utils.d.ts

@@ -0,0 +1,10 @@
+import type { DriftIssue } from './types.js';
+export interface Grade {
+    badge: string;
+    label: string;
+}
+export declare function scoreToGrade(score: number): Grade;
+export declare function scoreToGradeText(score: number): Grade;
+export declare function severityIcon(s: DriftIssue['severity']): string;
+export declare function scoreBar(score: number, width?: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -0,0 +1,36 @@
+import kleur from 'kleur';
+export function scoreToGrade(score) {
+    if (score === 0)
+        return { badge: kleur.green('CLEAN'), label: 'clean' };
+    if (score < 20)
+        return { badge: kleur.green('LOW'), label: 'low' };
+    if (score < 45)
+        return { badge: kleur.yellow('MODERATE'), label: 'moderate' };
+    if (score < 70)
+        return { badge: kleur.red('HIGH'), label: 'high' };
+    return { badge: kleur.bold().red('CRITICAL'), label: 'critical' };
+}
+export function scoreToGradeText(score) {
+    if (score === 0)
+        return { badge: '✦ CLEAN', label: 'clean' };
+    if (score < 20)
+        return { badge: '◎ LOW', label: 'low' };
+    if (score < 45)
+        return { badge: '◈ MODERATE', label: 'moderate' };
+    if (score < 70)
+        return { badge: '◉ HIGH', label: 'high' };
+    return { badge: '⬡ CRITICAL', label: 'critical' };
+}
+export function severityIcon(s) {
+    if (s === 'error')
+        return '✖';
+    if (s === 'warning')
+        return '▲';
+    return '◦';
+}
+export function scoreBar(score, width = 20) {
+    const filled = Math.round((score / 100) * width);
+    const empty = width - filled;
+    return '█'.repeat(filled) + '░'.repeat(empty);
+}
+//# sourceMappingURL=utils.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eduardbar/drift",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Detect silent technical debt left by AI-generated code",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,14 @@
     "start": "node dist/cli.js",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["vibe-coding", "technical-debt", "ai", "cli", "typescript", "static-analysis"],
+  "keywords": [
+    "vibe-coding",
+    "technical-debt",
+    "ai",
+    "cli",
+    "typescript",
+    "static-analysis"
+  ],
   "author": "eduardbar",
   "license": "MIT",
   "dependencies": {

package/src/cli.ts

@@ -1,50 +1,50 @@
-#!/usr/bin/env node
-import { Command } from 'commander'
-import { writeFileSync } from 'node:fs'
-import { resolve } from 'node:path'
-import { analyzeProject } from './analyzer.js'
-import { buildReport, formatMarkdown } from './reporter.js'
-import { printConsole } from './printer.js'
-
-const program = new Command()
-
-program
-  .name('drift')
-  .description('Detect silent technical debt left by AI-generated code')
-  .version('0.1.0')
-
-program
-  .command('scan [path]', { isDefault: true })
-  .description('Scan a directory for vibe coding drift')
-  .option('-o, --output <file>', 'Write report to a Markdown file')
-  .option('--json', 'Output raw JSON report')
-  .option('--min-score <n>', 'Exit with code 1 if overall score exceeds this threshold', '0')
-  .action((targetPath: string | undefined, options: { output?: string; json?: boolean; minScore: string }) => {
-    const resolvedPath = resolve(targetPath ?? '.')
-
-    console.error(`\nScanning ${resolvedPath}...`)
-
-    const files = analyzeProject(resolvedPath)
-    const report = buildReport(resolvedPath, files)
-
-    if (options.json) {
-      process.stdout.write(JSON.stringify(report, null, 2))
-      return
-    }
-
-    printConsole(report)
-
-    if (options.output) {
-      const md = formatMarkdown(report)
-      const outPath = resolve(options.output)
-      writeFileSync(outPath, md, 'utf8')
-      console.error(`Report saved to ${outPath}`)
-    }
-
-    const minScore = Number(options.minScore)
-    if (minScore > 0 && report.totalScore > minScore) {
-      process.exit(1)
-    }
-  })
-
-program.parse()
+#!/usr/bin/env node
+import { Command } from 'commander'
+import { writeFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { analyzeProject } from './analyzer.js'
+import { buildReport, formatMarkdown } from './reporter.js'
+import { printConsole } from './printer.js'
+
+const program = new Command()
+
+program
+  .name('drift')
+  .description('Detect silent technical debt left by AI-generated code')
+  .version('0.1.0')
+
+program
+  .command('scan [path]', { isDefault: true })
+  .description('Scan a directory for vibe coding drift')
+  .option('-o, --output <file>', 'Write report to a Markdown file')
+  .option('--json', 'Output raw JSON report')
+  .option('--min-score <n>', 'Exit with code 1 if overall score exceeds this threshold', '0')
+  .action((targetPath: string | undefined, options: { output?: string; json?: boolean; minScore: string }) => {
+    const resolvedPath = resolve(targetPath ?? '.')
+
+    process.stderr.write(`\nScanning ${resolvedPath}...\n`)
+    const files = analyzeProject(resolvedPath)
+    process.stderr.write(`  Found ${files.length} TypeScript file(s)\n\n`)
+    const report = buildReport(resolvedPath, files)
+
+    if (options.json) {
+      process.stdout.write(JSON.stringify(report, null, 2))
+      return
+    }
+
+    printConsole(report)
+
+    if (options.output) {
+      const md = formatMarkdown(report)
+      const outPath = resolve(options.output)
+      writeFileSync(outPath, md, 'utf8')
+      console.error(`Report saved to ${outPath}`)
+    }
+
+    const minScore = Number(options.minScore)
+    if (minScore > 0 && report.totalScore > minScore) {
+      process.exit(1)
+    }
+  })
+
+program.parse()

package/src/printer.ts

@@ -1,86 +1,81 @@
-import kleur from 'kleur'
-import type { DriftReport, DriftIssue } from './types.js'
-
-export function printConsole(report: DriftReport): void {
-  console.log()
-  console.log(kleur.bold().white('  drift') + kleur.gray(' — vibe coding debt detector'))
-  console.log()
-
-  const grade = scoreToGrade(report.totalScore)
-  const scoreColor = report.totalScore === 0
-    ? kleur.green
-    : report.totalScore < 45
-    ? kleur.yellow
-    : kleur.red
-
-  console.log(
-    `  Score  ${scoreColor().bold(String(report.totalScore).padStart(3))}${kleur.gray('/100')}  ${grade.badge}`
-  )
-  console.log(
-    kleur.gray(
-      `  ${report.files.length} file(s) with issues  ·  ${report.summary.errors} errors  ·  ${report.summary.warnings} warnings  ·  ${report.summary.infos} info`
-    )
-  )
-  console.log()
-
-  if (report.files.length === 0) {
-    console.log(kleur.green('  No drift detected. Clean codebase.'))
-    console.log()
-    return
-  }
-
-  for (const file of report.files) {
-    const rel = file.path.replace(report.targetPath, '').replace(/^[\\/]/, '')
-    console.log(
-      kleur.bold().white(`  ${rel}`) +
-        kleur.gray(` (score ${file.score}/100)`)
-    )
-
-    for (const issue of file.issues) {
-      const icon = severityIcon(issue.severity)
-      const colorFn = (s: string) =>
-        issue.severity === 'error'
-          ? kleur.red(s)
-          : issue.severity === 'warning'
-          ? kleur.yellow(s)
-          : kleur.cyan(s)
-
-      console.log(
-        `    ${colorFn(icon)} ` +
-          kleur.gray(`L${issue.line}`) +
-          `  ` +
-          colorFn(issue.rule) +
-          `  ` +
-          kleur.white(issue.message)
-      )
-      if (issue.snippet) {
-        console.log(kleur.gray(`       ${issue.snippet.split('\n')[0].slice(0, 100)}`))
-      }
-    }
-    console.log()
-  }
-
-  // Top drifting rules summary
-  const sorted = Object.entries(report.summary.byRule).sort((a, b) => b[1] - a[1]).slice(0, 3)
-  if (sorted.length > 0) {
-    console.log(kleur.gray('  Top rules:'))
-    for (const [rule, count] of sorted) {
-      console.log(kleur.gray(`    · ${rule}: ${count}`))
-    }
-    console.log()
-  }
-}
-
-function scoreToGrade(score: number): { badge: string } {
-  if (score === 0) return { badge: kleur.green('CLEAN') }
-  if (score < 20) return { badge: kleur.green('LOW') }
-  if (score < 45) return { badge: kleur.yellow('MODERATE') }
-  if (score < 70) return { badge: kleur.red('HIGH') }
-  return { badge: kleur.bold().red('CRITICAL') }
-}
-
-function severityIcon(s: DriftIssue['severity']): string {
-  if (s === 'error') return '✖'
-  if (s === 'warning') return '▲'
-  return '◦'
-}
+import kleur from 'kleur'
+import type { DriftReport } from './types.js'
+import { scoreToGrade, severityIcon, scoreBar } from './utils.js'
+
+export function printConsole(report: DriftReport): void {
+  const sep = kleur.gray('  ' + '─'.repeat(50))
+
+  console.log()
+  console.log(kleur.bold().white('  drift') + kleur.gray('  —  vibe coding debt detector'))
+  console.log(sep)
+  console.log()
+
+  const grade = scoreToGrade(report.totalScore)
+  const scoreColor = report.totalScore === 0
+    ? kleur.green
+    : report.totalScore < 45
+    ? kleur.yellow
+    : kleur.red
+
+  const bar = scoreBar(report.totalScore)
+  console.log(
+    `  Score   ${kleur.gray(bar)}  ${scoreColor().bold(String(report.totalScore))}/100  ${grade.badge}`
+  )
+
+  const cleanFiles = report.totalFiles - report.files.length
+  console.log(
+    kleur.gray(
+      `  ${report.files.length} file(s) with issues  ·  ${report.summary.errors} errors  ·  ${report.summary.warnings} warnings  ·  ${report.summary.infos} info  ·  ${cleanFiles} files clean`
+    )
+  )
+  console.log()
+
+  // Top issues in header
+  const topRules = Object.entries(report.summary.byRule).sort((a, b) => b[1] - a[1]).slice(0, 3)
+  if (topRules.length > 0) {
+    const parts = topRules.map(([rule, count]) => `${kleur.cyan(rule)} ${kleur.gray(`×${count}`)}`)
+    console.log(`  Top issues:  ${parts.join(kleur.gray('  ·  '))}`)
+    console.log()
+  }
+
+  console.log(sep)
+  console.log()
+
+  if (report.files.length === 0) {
+    console.log(kleur.green('  No drift detected. Clean codebase.'))
+    console.log()
+    return
+  }
+
+  for (const file of report.files) {
+    const rel = file.path.replace(report.targetPath, '').replace(/^[\\/]/, '')
+    console.log(
+      kleur.bold().white(`  ${rel}`) +
+        kleur.gray(` (score ${file.score}/100)`)
+    )
+
+    for (const issue of file.issues) {
+      const icon = severityIcon(issue.severity)
+      const colorFn = (s: string) =>
+        issue.severity === 'error'
+          ? kleur.red(s)
+          : issue.severity === 'warning'
+          ? kleur.yellow(s)
+          : kleur.cyan(s)
+
+      console.log(
+        `    ${colorFn(icon)} ` +
+          kleur.gray(`L${issue.line}`) +
+          `  ` +
+          colorFn(issue.rule) +
+          `  ` +
+          kleur.white(issue.message)
+      )
+      if (issue.snippet) {
+        const snippetIndent = '    ' + ' '.repeat(icon.length + 1)
+        console.log(kleur.gray(`${snippetIndent}${issue.snippet.split('\n')[0].slice(0, 120)}`))
+      }
+    }
+    console.log()
+  }
+}

package/src/reporter.ts

@@ -1,97 +1,85 @@
-import type { FileReport, DriftReport, DriftIssue } from './types.js'
-
-export function buildReport(targetPath: string, files: FileReport[]): DriftReport {
-  const allIssues = files.flatMap((f) => f.issues)
-  const byRule: Record<string, number> = {}
-
-  for (const issue of allIssues) {
-    byRule[issue.rule] = (byRule[issue.rule] ?? 0) + 1
-  }
-
-  const totalScore =
-    files.length > 0
-      ? Math.round(files.reduce((sum, f) => sum + f.score, 0) / files.length)
-      : 0
-
-  return {
-    scannedAt: new Date().toISOString(),
-    targetPath,
-    files: files.filter((f) => f.issues.length > 0).sort((a, b) => b.score - a.score),
-    totalIssues: allIssues.length,
-    totalScore,
-    summary: {
-      errors: allIssues.filter((i) => i.severity === 'error').length,
-      warnings: allIssues.filter((i) => i.severity === 'warning').length,
-      infos: allIssues.filter((i) => i.severity === 'info').length,
-      byRule,
-    },
-  }
-}
-
-export function formatMarkdown(report: DriftReport): string {
-  const grade = scoreToGrade(report.totalScore)
-  const lines: string[] = []
-
-  lines.push(`# drift report`)
-  lines.push(``)
-  lines.push(`> Generated: ${new Date(report.scannedAt).toLocaleString()}`)
-  lines.push(`> Path: \`${report.targetPath}\``)
-  lines.push(``)
-  lines.push(`## Overall drift score: ${report.totalScore}/100 ${grade.badge}`)
-  lines.push(``)
-  lines.push(`| | Count |`)
-  lines.push(`|---|---|`)
-  lines.push(`| Errors | ${report.summary.errors} |`)
-  lines.push(`| Warnings | ${report.summary.warnings} |`)
-  lines.push(`| Info | ${report.summary.infos} |`)
-  lines.push(`| Files with issues | ${report.files.length} |`)
-  lines.push(`| Total issues | ${report.totalIssues} |`)
-  lines.push(``)
-
-  if (Object.keys(report.summary.byRule).length > 0) {
-    lines.push(`## Issues by rule`)
-    lines.push(``)
-    const sorted = Object.entries(report.summary.byRule).sort((a, b) => b[1] - a[1])
-    for (const [rule, count] of sorted) {
-      lines.push(`- \`${rule}\`: ${count}`)
-    }
-    lines.push(``)
-  }
-
-  if (report.files.length === 0) {
-    lines.push(`## No drift detected`)
-    lines.push(``)
-    lines.push(`No issues found. Clean codebase.`)
-  } else {
-    lines.push(`## Files (sorted by drift score)`)
-    lines.push(``)
-    for (const file of report.files) {
-      lines.push(`### \`${file.path}\` — score ${file.score}/100`)
-      lines.push(``)
-      for (const issue of file.issues) {
-        const icon = severityIcon(issue.severity)
-        lines.push(`**${icon} [${issue.rule}]** Line ${issue.line}: ${issue.message}`)
-        lines.push(`\`\`\``)
-        lines.push(issue.snippet)
-        lines.push(`\`\`\``)
-        lines.push(``)
-      }
-    }
-  }
-
-  return lines.join('\n')
-}
-
-function scoreToGrade(score: number): { badge: string; label: string } {
-  if (score === 0) return { badge: '✦ CLEAN', label: 'clean' }
-  if (score < 20) return { badge: '◎ LOW', label: 'low' }
-  if (score < 45) return { badge: '◈ MODERATE', label: 'moderate' }
-  if (score < 70) return { badge: '◉ HIGH', label: 'high' }
-  return { badge: '⬡ CRITICAL', label: 'critical' }
-}
-
-function severityIcon(s: DriftIssue['severity']): string {
-  if (s === 'error') return '✖'
-  if (s === 'warning') return '▲'
-  return '◦'
-}
+import type { FileReport, DriftReport } from './types.js'
+import { scoreToGradeText, severityIcon } from './utils.js'
+
+export function buildReport(targetPath: string, files: FileReport[]): DriftReport {
+  const allIssues = files.flatMap((f) => f.issues)
+  const byRule: Record<string, number> = {}
+
+  for (const issue of allIssues) {
+    byRule[issue.rule] = (byRule[issue.rule] ?? 0) + 1
+  }
+
+  const totalScore =
+    files.length > 0
+      ? Math.round(files.reduce((sum, f) => sum + f.score, 0) / files.length)
+      : 0
+
+  return {
+    scannedAt: new Date().toISOString(),
+    targetPath,
+    files: files.filter((f) => f.issues.length > 0).sort((a, b) => b.score - a.score),
+    totalIssues: allIssues.length,
+    totalScore,
+    totalFiles: files.length,
+    summary: {
+      errors: allIssues.filter((i) => i.severity === 'error').length,
+      warnings: allIssues.filter((i) => i.severity === 'warning').length,
+      infos: allIssues.filter((i) => i.severity === 'info').length,
+      byRule,
+    },
+  }
+}
+
+export function formatMarkdown(report: DriftReport): string {
+  const grade = scoreToGradeText(report.totalScore)
+  const lines: string[] = []
+
+  lines.push(`# drift report`)
+  lines.push(``)
+  lines.push(`> Generated: ${new Date(report.scannedAt).toLocaleString()}`)
+  lines.push(`> Path: \`${report.targetPath}\``)
+  lines.push(``)
+  lines.push(`## Overall drift score: ${report.totalScore}/100 ${grade.badge}`)
+  lines.push(``)
+  lines.push(`| | Count |`)
+  lines.push(`|---|---|`)
+  lines.push(`| Errors | ${report.summary.errors} |`)
+  lines.push(`| Warnings | ${report.summary.warnings} |`)
+  lines.push(`| Info | ${report.summary.infos} |`)
+  lines.push(`| Files with issues | ${report.files.length} |`)
+  lines.push(`| Total issues | ${report.totalIssues} |`)
+  lines.push(``)
+
+  if (Object.keys(report.summary.byRule).length > 0) {
+    lines.push(`## Issues by rule`)
+    lines.push(``)
+    const sorted = Object.entries(report.summary.byRule).sort((a, b) => b[1] - a[1])
+    for (const [rule, count] of sorted) {
+      lines.push(`- \`${rule}\`: ${count}`)
+    }
+    lines.push(``)
+  }
+
+  if (report.files.length === 0) {
+    lines.push(`## No drift detected`)
+    lines.push(``)
+    lines.push(`No issues found. Clean codebase.`)
+  } else {
+    lines.push(`## Files (sorted by drift score)`)
+    lines.push(``)
+    for (const file of report.files) {
+      lines.push(`### \`${file.path}\` — score ${file.score}/100`)
+      lines.push(``)
+      for (const issue of file.issues) {
+        const icon = severityIcon(issue.severity)
+        lines.push(`**${icon} [${issue.rule}]** Line ${issue.line}: ${issue.message}`)
+        lines.push(`\`\`\`typescript`)
+        lines.push(issue.snippet)
+        lines.push(`\`\`\``)
+        lines.push(``)
+      }
+    }
+  }
+
+  return lines.join('\n')
+}

package/src/types.ts

@@ -1,28 +1,29 @@
-export interface DriftIssue {
-  rule: string
-  severity: 'error' | 'warning' | 'info'
-  message: string
-  line: number
-  column: number
-  snippet: string
-}
-
-export interface FileReport {
-  path: string
-  issues: DriftIssue[]
-  score: number // 0–100, higher = more drift
-}
-
-export interface DriftReport {
-  scannedAt: string
-  targetPath: string
-  files: FileReport[]
-  totalIssues: number
-  totalScore: number
-  summary: {
-    errors: number
-    warnings: number
-    infos: number
-    byRule: Record<string, number>
-  }
-}
+export interface DriftIssue {
+  rule: string
+  severity: 'error' | 'warning' | 'info'
+  message: string
+  line: number
+  column: number
+  snippet: string
+}
+
+export interface FileReport {
+  path: string
+  issues: DriftIssue[]
+  score: number // 0–100, higher = more drift
+}
+
+export interface DriftReport {
+  scannedAt: string
+  targetPath: string
+  files: FileReport[]
+  totalIssues: number
+  totalScore: number
+  totalFiles: number
+  summary: {
+    errors: number
+    warnings: number
+    infos: number
+    byRule: Record<string, number>
+  }
+}

package/src/utils.ts

@@ -0,0 +1,35 @@
+import kleur from 'kleur'
+import type { DriftIssue } from './types.js'
+
+export interface Grade {
+  badge: string
+  label: string
+}
+
+export function scoreToGrade(score: number): Grade {
+  if (score === 0) return { badge: kleur.green('CLEAN'), label: 'clean' }
+  if (score < 20) return { badge: kleur.green('LOW'), label: 'low' }
+  if (score < 45) return { badge: kleur.yellow('MODERATE'), label: 'moderate' }
+  if (score < 70) return { badge: kleur.red('HIGH'), label: 'high' }
+  return { badge: kleur.bold().red('CRITICAL'), label: 'critical' }
+}
+
+export function scoreToGradeText(score: number): Grade {
+  if (score === 0) return { badge: '✦ CLEAN', label: 'clean' }
+  if (score < 20) return { badge: '◎ LOW', label: 'low' }
+  if (score < 45) return { badge: '◈ MODERATE', label: 'moderate' }
+  if (score < 70) return { badge: '◉ HIGH', label: 'high' }
+  return { badge: '⬡ CRITICAL', label: 'critical' }
+}
+
+export function severityIcon(s: DriftIssue['severity']): string {
+  if (s === 'error') return '✖'
+  if (s === 'warning') return '▲'
+  return '◦'
+}
+
+export function scoreBar(score: number, width = 20): string {
+  const filled = Math.round((score / 100) * width)
+  const empty = width - filled
+  return '█'.repeat(filled) + '░'.repeat(empty)
+}