@eduardbar/drift 0.7.0 → 0.9.0

package/src/cli.ts

@@ -2,6 +2,9 @@
 import { Command } from 'commander'
 import { writeFileSync } from 'node:fs'
 import { resolve } from 'node:path'
+import { createRequire } from 'node:module'
+const require = createRequire(import.meta.url)
+const { version: VERSION } = require('../package.json') as { version: string }
 import { analyzeProject } from './analyzer.js'
 import { buildReport, formatMarkdown, formatAIOutput } from './reporter.js'
 import { printConsole, printDiff } from './printer.js'
@@ -11,13 +14,14 @@ import { computeDiff } from './diff.js'
 import { generateHtmlReport } from './report.js'
 import { generateBadge } from './badge.js'
 import { emitCIAnnotations, printCISummary } from './ci.js'
+import { TrendAnalyzer, BlameAnalyzer } from './analyzer.js'
 
 const program = new Command()
 
 program
   .name('drift')
   .description('Detect silent technical debt left by AI-generated code')
-  .version('0.6.0')
+  .version(VERSION)
 
 program
   .command('scan [path]', { isDefault: true })
@@ -163,4 +167,46 @@ program
     }
   })
 
+program
+  .command('trend [period]')
+  .description('Analyze trend of technical debt over time')
+  .option('--since <date>', 'Start date for trend analysis (ISO format)')
+  .option('--until <date>', 'End date for trend analysis (ISO format)')
+  .action(async (period: string | undefined, options: { since?: string; until?: string }) => {
+    const resolvedPath = resolve('.')
+    process.stderr.write(`\nAnalyzing trend in ${resolvedPath}...\n`)
+    
+    const config = await loadConfig(resolvedPath)
+    const analyzer = new TrendAnalyzer(resolvedPath, config)
+    
+    const trendData = await analyzer.analyzeTrend({
+      period: period as 'week' | 'month' | 'quarter' | 'year',
+      since: options.since,
+      until: options.until
+    })
+    
+    process.stderr.write(`\nTrend analysis complete:\n`)
+    process.stdout.write(JSON.stringify(trendData, null, 2) + '\n')
+  })
+
+program
+  .command('blame [target]')
+  .description('Analyze which files/rules contribute most to technical debt')
+  .option('--top <n>', 'Number of top contributors to show (default: 10)', '10')
+  .action(async (target: string | undefined, options: { top: string }) => {
+    const resolvedPath = resolve('.')
+    process.stderr.write(`\nAnalyzing blame in ${resolvedPath}...\n`)
+    
+    const config = await loadConfig(resolvedPath)
+    const analyzer = new BlameAnalyzer(resolvedPath, config)
+    
+    const blameData = await analyzer.analyzeBlame({
+      target: target as 'file' | 'rule' | 'overall' | undefined,
+      top: Number(options.top)
+    })
+    
+    process.stderr.write(`\nBlame analysis complete:\n`)
+    process.stdout.write(JSON.stringify(blameData, null, 2) + '\n')
+  })
+
 program.parse()

package/src/printer.ts

@@ -118,66 +118,66 @@ function formatFixSuggestion(issue: DriftIssue): string[] {
 }
 
 export function printConsole(report: DriftReport, options?: { showFix?: boolean }): 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)
-
+  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}`) +

package/src/report.ts

@@ -1,7 +1,9 @@
 import { basename } from 'node:path'
+import { createRequire } from 'node:module'
 import { DriftReport, DriftIssue } from './types.js'
 
-const VERSION = '0.6.0'
+const require = createRequire(import.meta.url)
+const { version: VERSION } = require('../package.json') as { version: string }
 
 function severityColor(severity: DriftIssue['severity']): string {
   switch (severity) {

package/src/types.ts

@@ -1,18 +1,18 @@
-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 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
@@ -112,3 +112,47 @@ export interface DriftDiff {
   newIssuesCount: number
   resolvedIssuesCount: number
 }
+
+/** Historical analysis data for a single commit */
+export interface HistoricalAnalysis {
+  commitHash: string;
+  commitDate: Date;
+  author: string;
+  message: string;
+  files: FileReport[];
+  totalScore: number;
+  averageScore: number;
+}
+
+/** Trend data point for score evolution */
+export interface TrendDataPoint {
+  date: Date;
+  score: number;
+  fileCount: number;
+  avgIssuesPerFile: number;
+}
+
+/** Blame attribution data */
+export interface BlameAttribution {
+  author: string;
+  email: string;
+  commits: number;
+  linesChanged: number;
+  issuesIntroduced: number;
+  avgScoreImpact: number;
+}
+
+/** Extended DriftReport with historical context */
+export interface DriftTrendReport extends DriftReport {
+  trend: TrendDataPoint[];
+  regression: {
+    slope: number;
+    intercept: number;
+    r2: number;
+  };
+}
+
+/** Extended DriftReport with blame data */
+export interface DriftBlameReport extends DriftReport {
+  blame: BlameAttribution[];
+}

package/src/utils.ts

@@ -1,35 +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)
-}
+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)
+}