@boshu2/vibe-check 1.0.0

package/README.md

@@ -0,0 +1,115 @@
+# vibe-check
+
+Measure vibe coding effectiveness with git commit analysis.
+
+## What is Vibe Coding?
+
+Vibe coding is AI-assisted development where you collaborate with an AI coding assistant. This tool measures how effectively that collaboration is working by analyzing your git commit patterns.
+
+## Installation
+
+```bash
+npm install -g vibe-check
+```
+
+Or run directly with npx:
+
+```bash
+npx vibe-check
+```
+
+## Usage
+
+```bash
+# Analyze current repository
+vibe-check
+
+# Analyze last week
+vibe-check --since "1 week ago"
+
+# JSON output for CI/automation
+vibe-check --format json
+
+# Markdown report
+vibe-check --format markdown
+
+# Analyze specific repo
+vibe-check --repo /path/to/repo
+```
+
+## The 5 Core Metrics (FAAFO)
+
+| Metric | What It Measures | Target |
+|--------|------------------|--------|
+| **Iteration Velocity** | Commits per hour | >5/hr = Elite |
+| **Rework Ratio** | % commits that are fixes | <30% = Elite |
+| **Trust Pass Rate** | % commits that stick (no immediate fix) | >95% = Elite |
+| **Debug Spiral Duration** | Time spent in fix chains | <15m = Elite |
+| **Flow Efficiency** | % time in productive work vs debugging | >90% = Elite |
+
+## Output Ratings
+
+| Rating | Meaning |
+|--------|---------|
+| **ELITE** | Vibe coding working excellently |
+| **HIGH** | Good effectiveness, minor improvements possible |
+| **MEDIUM** | Room for improvement |
+| **LOW** | Process issues, reassess approach |
+
+## Example Output
+
+```
+╔════════════════════════════════════════════════════════════╗
+║                    VIBE CHECK RESULTS                       ║
+╠════════════════════════════════════════════════════════════╣
+║  Period: Nov 21 - Nov 28, 2025                             ║
+║  Commits Analyzed: 47                                       ║
+╠════════════════════════════════════════════════════════════╣
+║                                                             ║
+║  Iteration Velocity    ████████████░░░░  4.2/hr    HIGH    ║
+║  Rework Ratio          ██████░░░░░░░░░░  35%       MEDIUM  ║
+║  Trust Pass Rate       ████████████████  92%       HIGH    ║
+║  Debug Spiral Duration ██████████████░░  18min     HIGH    ║
+║  Flow Efficiency       ██████████████░░  85%       HIGH    ║
+║                                                             ║
+╠════════════════════════════════════════════════════════════╣
+║  Overall Rating: HIGH                                       ║
+╚════════════════════════════════════════════════════════════╝
+```
+
+## Debug Spiral Detection
+
+When the tool detects fix chains (multiple fix commits in a row), it identifies:
+- Which component had issues
+- Pattern category (e.g., `API_MISMATCH`, `SSL_TLS`, `VOLUME_CONFIG`)
+- Duration of the spiral
+- Suggested tracer test to prevent recurrence
+
+## Integration with Claude Code
+
+This tool is designed to work with the RPI (Research-Plan-Implement) workflow:
+
+1. **Before implementation**: Run `vibe-check` to establish baseline
+2. **After implementation**: Run `vibe-check --since "<start-time>"` to measure session
+3. **Weekly review**: Run `vibe-check --since "1 week ago" --format markdown`
+
+## Options
+
+```
+-V, --version        Output version number
+--since <date>       Start date for analysis (e.g., "1 week ago", "2025-11-01")
+--until <date>       End date for analysis (default: now)
+-f, --format <type>  Output format: terminal, json, markdown (default: terminal)
+-r, --repo <path>    Repository path (default: current directory)
+-v, --verbose        Show verbose output
+-h, --help           Display help
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Git repository with commit history
+
+## License
+
+MIT

package/bin/vibe-check.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/cli.js');

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const git_1 = require("./git");
+const metrics_1 = require("./metrics");
+const output_1 = require("./output");
+const program = new commander_1.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 = ['terminal', 'json', 'markdown'];
+        if (!validFormats.includes(format)) {
+            console.error(chalk_1.default.red(`Invalid format: ${format}`));
+            console.error(chalk_1.default.gray(`Valid formats: ${validFormats.join(', ')}`));
+            process.exit(1);
+        }
+        // Check if repo is valid
+        if (!(await (0, git_1.isGitRepo)(repo))) {
+            console.error(chalk_1.default.red(`Not a git repository: ${repo}`));
+            process.exit(1);
+        }
+        if (verbose) {
+            console.error(chalk_1.default.gray(`Analyzing repository: ${repo}`));
+            if (since)
+                console.error(chalk_1.default.gray(`Since: ${since}`));
+            if (until)
+                console.error(chalk_1.default.gray(`Until: ${until}`));
+        }
+        // Get commits
+        const commits = await (0, git_1.getCommits)(repo, since, until);
+        if (commits.length === 0) {
+            if (format === 'terminal') {
+                console.log(chalk_1.default.yellow('\nNo commits found in the specified range.\n'));
+                if (!since) {
+                    console.log(chalk_1.default.gray('Try specifying a date range:'));
+                    console.log(chalk_1.default.gray('  vibe-check --since "1 week ago"'));
+                    console.log(chalk_1.default.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_1.default.gray(`Found ${commits.length} commits`));
+        }
+        // Analyze commits
+        const result = (0, metrics_1.analyzeCommits)(commits);
+        // Output result
+        const output = (0, output_1.formatOutput)(result, format);
+        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_1.default.red(`Error: ${error.message}`));
+            if (options.verbose) {
+                console.error(chalk_1.default.gray(error.stack));
+            }
+        }
+        else {
+            console.error(chalk_1.default.red('An unexpected error occurred'));
+        }
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,4 @@
+import { Commit } from './types';
+export declare function getCommits(repoPath: string, since?: string, until?: string): Promise<Commit[]>;
+export declare function isGitRepo(repoPath: string): Promise<boolean>;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB;AA+BD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQlE"}

package/dist/git.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCommits = getCommits;
+exports.isGitRepo = isGitRepo;
+const simple_git_1 = __importDefault(require("simple-git"));
+const COMMIT_TYPES = ['feat', 'fix', 'docs', 'chore', 'refactor', 'test', 'style'];
+async function getCommits(repoPath, since, until) {
+    const git = (0, simple_git_1.default)(repoPath);
+    // Build options for git log
+    const options = {};
+    if (since) {
+        options['--since'] = since;
+    }
+    if (until) {
+        options['--until'] = until;
+    }
+    try {
+        const log = 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) {
+    const { hash, date, message, author_name } = entry;
+    // Parse conventional commit format: type(scope): description
+    const conventionalMatch = message.match(/^(\w+)(?:\(([^)]+)\))?:\s*(.+)/);
+    let type = 'other';
+    let scope = null;
+    if (conventionalMatch) {
+        const [, rawType, rawScope] = conventionalMatch;
+        const normalizedType = rawType.toLowerCase();
+        if (COMMIT_TYPES.includes(normalizedType)) {
+            type = normalizedType;
+        }
+        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,
+    };
+}
+async function isGitRepo(repoPath) {
+    const git = (0, simple_git_1.default)(repoPath);
+    try {
+        await git.status();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":";;;;;AAKA,gCA2BC;AA+BD,8BAQC;AAvED,4DAA+E;AAG/E,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAErF,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,KAAc,EACd,KAAc;IAEd,MAAM,GAAG,GAAc,IAAA,oBAAS,EAAC,QAAQ,CAAC,CAAC;IAE3C,4BAA4B;IAC5B,MAAM,OAAO,GAA8C,EAAE,CAAC;IAE9D,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAgC,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEhE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAuB;IAC1C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAEnD,6DAA6D;IAC7D,MAAM,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAE1E,IAAI,IAAI,GAAmB,OAAO,CAAC;IACnC,IAAI,KAAK,GAAkB,IAAI,CAAC;IAEhC,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,iBAAiB,CAAC;QAChD,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAE7C,IAAI,YAAY,CAAC,QAAQ,CAAC,cAA6C,CAAC,EAAE,CAAC;YACzE,IAAI,GAAG,cAAgC,CAAC;QAC1C,CAAC;QACD,KAAK,GAAG,QAAQ,IAAI,IAAI,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB;QACnD,IAAI;QACJ,KAAK;QACL,MAAM,EAAE,WAAW;KACpB,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,QAAgB;IAC9C,MAAM,GAAG,GAAc,IAAA,oBAAS,EAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/metrics/flow.d.ts

@@ -0,0 +1,3 @@
+import { FixChain, MetricResult } from '../types';
+export declare function calculateFlowEfficiency(activeMinutes: number, spirals: FixChain[]): MetricResult;
+//# sourceMappingURL=flow.d.ts.map

package/dist/metrics/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/metrics/flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAU,MAAM,UAAU,CAAC;AAE1D,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,QAAQ,EAAE,GAClB,YAAY,CAwBd"}

package/dist/metrics/flow.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateFlowEfficiency = calculateFlowEfficiency;
+function calculateFlowEfficiency(activeMinutes, spirals) {
+    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) {
+    if (efficiency > 90)
+        return 'elite';
+    if (efficiency >= 75)
+        return 'high';
+    if (efficiency >= 50)
+        return 'medium';
+    return 'low';
+}
+function getDescription(rating, spiralMinutes) {
+    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`;
+    }
+}
+//# sourceMappingURL=flow.js.map

package/dist/metrics/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/metrics/flow.ts"],"names":[],"mappings":";;AAEA,0DA2BC;AA3BD,SAAgB,uBAAuB,CACrC,aAAqB,EACrB,OAAmB;IAEnB,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,yBAAyB;SACvC,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,OAAO;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SACzB,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAE3C,MAAM,UAAU,GAAG,CAAC,CAAC,aAAa,GAAG,aAAa,CAAC,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC;IAC3E,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAE5C,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC;QACpC,IAAI,EAAE,GAAG;QACT,MAAM;QACN,WAAW,EAAE,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,UAAkB;IACnC,IAAI,UAAU,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IACpC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,UAAU,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,aAAqB;IAC3D,MAAM,UAAU,GACd,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,0BAA0B,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAEtF,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,GAAG,UAAU,6BAA6B,CAAC;QACpD,KAAK,MAAM;YACT,OAAO,GAAG,UAAU,gBAAgB,CAAC;QACvC,KAAK,QAAQ;YACX,OAAO,GAAG,UAAU,kCAAkC,CAAC;QACzD,KAAK,KAAK;YACR,OAAO,GAAG,UAAU,gCAAgC,CAAC;IACzD,CAAC;AACH,CAAC"}

package/dist/metrics/index.d.ts

@@ -0,0 +1,4 @@
+import { Commit, VibeCheckResult } from '../types';
+export declare function analyzeCommits(commits: Commit[]): VibeCheckResult;
+export { calculateActiveHours } from './velocity';
+//# sourceMappingURL=index.d.ts.map

package/dist/metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAyB,MAAM,UAAU,CAAC;AAW1E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,eAAe,CAsDjE;AAuGD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/metrics/index.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateActiveHours = void 0;
+exports.analyzeCommits = analyzeCommits;
+const velocity_1 = require("./velocity");
+const rework_1 = require("./rework");
+const trust_1 = require("./trust");
+const spirals_1 = require("./spirals");
+const flow_1 = require("./flow");
+function analyzeCommits(commits) {
+    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 = (0, velocity_1.calculateActiveHours)(sorted);
+    // Count commit types
+    const commitCounts = countCommitTypes(sorted);
+    // Detect fix chains
+    const fixChains = (0, spirals_1.detectFixChains)(sorted);
+    // Calculate all metrics
+    const iterationVelocity = (0, velocity_1.calculateIterationVelocity)(sorted);
+    const reworkRatio = (0, rework_1.calculateReworkRatio)(sorted);
+    const trustPassRate = (0, trust_1.calculateTrustPassRate)(sorted);
+    const debugSpiralDuration = (0, spirals_1.calculateDebugSpiralDuration)(fixChains);
+    const flowEfficiency = (0, flow_1.calculateFlowEfficiency)(activeHours * 60, fixChains);
+    // Calculate pattern summary
+    const patterns = (0, spirals_1.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) {
+    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) {
+    const scores = {
+        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() {
+    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',
+    };
+}
+var velocity_2 = require("./velocity");
+Object.defineProperty(exports, "calculateActiveHours", { enumerable: true, get: function () { return velocity_2.calculateActiveHours; } });
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

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

package/dist/metrics/rework.d.ts

@@ -0,0 +1,3 @@
+import { Commit, MetricResult } from '../types';
+export declare function calculateReworkRatio(commits: Commit[]): MetricResult;
+//# sourceMappingURL=rework.d.ts.map

package/dist/metrics/rework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rework.d.ts","sourceRoot":"","sources":["../../src/metrics/rework.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAU,MAAM,UAAU,CAAC;AAExD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,CAoBpE"}

package/dist/metrics/rework.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateReworkRatio = calculateReworkRatio;
+function calculateReworkRatio(commits) {
+    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) {
+    if (ratio < 30)
+        return 'elite';
+    if (ratio < 50)
+        return 'high';
+    if (ratio < 70)
+        return 'medium';
+    return 'low';
+}
+function getDescription(rating, fixes, total) {
+    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`;
+    }
+}
+//# sourceMappingURL=rework.js.map

package/dist/metrics/rework.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rework.js","sourceRoot":"","sources":["../../src/metrics/rework.ts"],"names":[],"mappings":";;AAEA,oDAoBC;AApBD,SAAgB,oBAAoB,CAAC,OAAiB;IACpD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,kBAAkB;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;IAClE,MAAM,KAAK,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;IAClD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAEhC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QACxB,IAAI,EAAE,GAAG;QACT,MAAM;QACN,WAAW,EAAE,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IAC/B,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,QAAQ,CAAC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,KAAa,EAAE,KAAa;IAClE,MAAM,OAAO,GAAG,GAAG,KAAK,IAAI,KAAK,oBAAoB,CAAC;IAEtD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,GAAG,OAAO,2BAA2B,CAAC;QAC/C,KAAK,MAAM;YACT,OAAO,GAAG,OAAO,2BAA2B,CAAC;QAC/C,KAAK,QAAQ;YACX,OAAO,GAAG,OAAO,iDAAiD,CAAC;QACrE,KAAK,KAAK;YACR,OAAO,GAAG,OAAO,2CAA2C,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/metrics/spirals.d.ts

@@ -0,0 +1,9 @@
+import { Commit, FixChain, MetricResult } from '../types';
+export declare function detectFixChains(commits: Commit[]): FixChain[];
+export declare function calculateDebugSpiralDuration(chains: FixChain[]): MetricResult;
+export declare function calculatePatternSummary(chains: FixChain[]): {
+    categories: Record<string, number>;
+    total: number;
+    tracerAvailable: number;
+};
+//# sourceMappingURL=spirals.d.ts.map

package/dist/metrics/spirals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spirals.d.ts","sourceRoot":"","sources":["../../src/metrics/spirals.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAU,MAAM,UAAU,CAAC;AAclE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAyC7D;AA8CD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAsB7E;AAwBD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG;IAC3D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;CACzB,CAoBA"}