@boshu2/vibe-check 2.0.0 → 2.2.1

package/README.md

@@ -73,12 +73,38 @@ npx @boshu2/vibe-check dashboard
 
 ## What It Measures
 
+### Core Metrics
+
 | Metric | Question | Target |
 |--------|----------|--------|
 | **Trust Pass Rate** | Does the code stick? | >95% |
 | **Rework Ratio** | Building or debugging? | <30% |
 | **Debug Spirals** | Are you stuck? | 0 active |
 
+### Enhanced Metrics (v2.2.0)
+
+Three deeper metrics for understanding development habits:
+
+| Metric | Question | Target |
+|--------|----------|--------|
+| **Tracer Bullet Ratio** | Are you validating assumptions? | >20% |
+| **Investigation Time** | How much hidden debugging? | 0 min |
+| **Domain Cohesion** | Are changes focused? | >80% |
+
+**Tracer Bullets** — Use `tracer:` or `tb:` prefix for validation commits:
+
+```
+tracer(auth): validate OAuth token refresh
+tb(api): test streaming endpoint response
+```
+
+- Tracers **before features** = proactive validation ✅
+- Tracers **before fixes** = reactive debugging ❌ (too late!)
+
+**Investigation Gaps** — Detects hidden debugging time (15-120 min gaps followed by fix commits).
+
+**Domain Cohesion** — Measures how scattered changes are. Single-domain commits indicate clean vertical slices.
+
 ---
 
 ## The 12 Failure Patterns
@@ -187,6 +213,34 @@ vibe-check profile              # XP and achievements
 vibe-check insights             # Your spiral patterns
 ```
 
+### Code Quality
+
+```bash
+vibe-check audit                # Scan for monoliths, test gaps, TODOs, eldritch horrors
+vibe-check modularity           # Pattern-aware modularity analysis
+vibe-check modularity --verbose # Detailed breakdown with metrics
+vibe-check modularity -f json   # JSON output for CI integration
+```
+
+#### Audit Command (v2.2.0)
+
+The `audit` command now includes **Eldritch Horror Detection**—identifying oversized functions that are symptomatic of AI-generated code gone wrong:
+
+```
+👹 Eldritch Horrors (oversized functions):
+  src/services/auth.ts:45
+    handleAuthentication: 523 lines (CRITICAL)
+  src/api/routes.ts:120
+    processRequest: 287 lines (warning)
+```
+
+| Severity | Threshold | What It Means |
+|----------|-----------|---------------|
+| Warning | >200 lines | Hard to understand |
+| Critical | >500 lines | Impossible to maintain |
+
+Supports: TypeScript, JavaScript, Python, Go
+
 ### Tools
 
 ```bash
@@ -241,6 +295,92 @@ When inner loop issues are detected:
 
 ---
 
+## Modularity Analysis
+
+Goes beyond simple LOC counting to assess whether large files are well-organized or problematic.
+
+```bash
+vibe-check modularity
+```
+
+```
+📐 Modularity Analysis
+────────────────────────────────────────────────────────────
+
+Analyzed 584 files (195,345 lines)
+Average modularity score: 9.5/10
+
+Score Distribution:
+  Elite (9-10):      ████████████████░░░░ 82%
+  Good (7-8):        ███░░░░░░░░░░░░░░░░░ 15%
+  Acceptable (5-6):  ░░░░░░░░░░░░░░░░░░░░ 2%
+  Needs Work (3-4):  ░░░░░░░░░░░░░░░░░░░░ 1%
+  Poor (0-2):        ░░░░░░░░░░░░░░░░░░░░ 0%
+
+⚠️  Files Needing Attention (8):
+
+  6/10 stores/network.js 1023 lines [state-machine]
+       ⚠ no sections/organization
+  5/10 server/WebSocketGateway.ts 702 lines
+       ⚠ no sections/organization
+  4/10 client/App.tsx 568 lines [component]
+       ⚠ no sections/organization, ⚠ high coupling
+
+👍 Good modularity. Minor improvements possible.
+```
+
+### Pattern-Aware Scoring
+
+A 2,500-line file can score **10/10** if well-organized. A 300-line file can score **4/10** if it's a mess.
+
+| Factor | Impact | What It Checks |
+|--------|--------|----------------|
+| **Pattern Match** | +1 | Is it a controller/store/routes/state-machine? |
+| **Internal Sections** | +1/-2 | Does it use `// ====` dividers or nested classes? |
+| **Single Responsibility** | +2/-2 | Can purpose be described in one sentence? |
+| **Coupling** | -1/-2 | >15 imports = high coupling warning |
+| **Export Surface** | -1 | >20 exports = bloated API |
+
+### Pattern-Specific Thresholds
+
+Different file types have different acceptable sizes:
+
+| Pattern | Yellow | Red | Why |
+|---------|--------|-----|-----|
+| `store` | 1,500 | 2,500 | Data layer naturally groups many methods |
+| `controller` | 800 | 1,200 | K8s-style with reconciliation loops |
+| `routes` | 1,000 | 1,500 | Vertical slice entry points |
+| `component` | 250 | 400 | React components should stay focused |
+| `utility` | 150 | 250 | Utilities should be smallest |
+
+### Automatic Exemptions
+
+These patterns skip modularity checks:
+- `*.test.ts` — Tests can be comprehensive
+- `*.generated.ts` — Generated files
+- Type definition files — Central types are OK to be large
+
+### Forensics Integration
+
+Modularity is also included in `vibe-check forensics` for complete code health analysis:
+
+```bash
+vibe-check forensics
+```
+
+```
+Modularity Health:
+  Average Score: 9.5/10 (303 files analyzed)
+  ⚠️  8 files need attention:
+     6/10 stores/network.js 1023 lines (no-internal-structure)
+     5/10 server/WebSocketGateway.ts 702 lines
+     ...
+```
+
+Poor modularity (score <5) triggers the **SWEEP** recommendation alongside commit pattern issues.
+
+---
+
 ## For Autonomous Agents
 
 vibe-check measures **human-AI collaboration sessions**—the inner loop where you're working with an AI assistant.

package/dist/analyzers/eldritch.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Eldritch Horror Detector
+ *
+ * Detects oversized functions that are symptomatic of the "Eldritch Horror"
+ * middle loop failure pattern from vibe coding. This pattern occurs when
+ * AI generates monolithic functions that are impossible to understand.
+ *
+ * Thresholds:
+ * - Warning: Functions > 200 lines
+ * - Critical: Functions > 500 lines
+ *
+ * Detection is heuristic-based (not full AST parsing) to keep it fast
+ * and work across multiple languages.
+ */
+export interface EldritchHorror {
+    file: string;
+    functionName: string;
+    lineStart: number;
+    lineCount: number;
+    severity: 'warning' | 'critical';
+}
+export interface EldritchHorrorResult {
+    detected: boolean;
+    horrors: EldritchHorror[];
+    totalCount: number;
+    criticalCount: number;
+    warningCount: number;
+}
+/**
+ * Detect oversized functions in source files.
+ *
+ * @param files - List of file paths to analyze
+ * @returns Detection result with list of horrors
+ */
+export declare function detectEldritchHorrors(files: string[]): EldritchHorrorResult;
+/**
+ * Run eldritch horror detection on a directory.
+ */
+export declare function scanForHorrors(dir: string): EldritchHorrorResult;
+//# sourceMappingURL=eldritch.d.ts.map

package/dist/analyzers/eldritch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eldritch.d.ts","sourceRoot":"","sources":["../../src/analyzers/eldritch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAqBD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAuB3E;AA8HD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAGhE"}

package/dist/analyzers/eldritch.js

@@ -0,0 +1,202 @@
+/**
+ * Eldritch Horror Detector
+ *
+ * Detects oversized functions that are symptomatic of the "Eldritch Horror"
+ * middle loop failure pattern from vibe coding. This pattern occurs when
+ * AI generates monolithic functions that are impossible to understand.
+ *
+ * Thresholds:
+ * - Warning: Functions > 200 lines
+ * - Critical: Functions > 500 lines
+ *
+ * Detection is heuristic-based (not full AST parsing) to keep it fast
+ * and work across multiple languages.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const WARNING_THRESHOLD = 200;
+const CRITICAL_THRESHOLD = 500;
+// Pattern matchers for function declarations across languages
+const FUNCTION_PATTERNS = {
+    // JavaScript/TypeScript
+    jsFunction: /^\s*(?:export\s+)?(?:async\s+)?function\s+(\w+)\s*\(/,
+    jsArrow: /^\s*(?:export\s+)?(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s+)?\(/,
+    jsMethod: /^\s*(?:async\s+)?(\w+)\s*\([^)]*\)\s*{/,
+    jsClass: /^\s*(?:export\s+)?class\s+(\w+)/,
+    // Python
+    pyFunction: /^\s*(?:async\s+)?def\s+(\w+)\s*\(/,
+    pyClass: /^\s*class\s+(\w+)/,
+    // Go
+    goFunction: /^\s*func\s+(?:\([^)]+\)\s+)?(\w+)\s*\(/,
+};
+/**
+ * Detect oversized functions in source files.
+ *
+ * @param files - List of file paths to analyze
+ * @returns Detection result with list of horrors
+ */
+export function detectEldritchHorrors(files) {
+    const horrors = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, 'utf-8');
+            const fileHorrors = analyzeFile(file, content);
+            horrors.push(...fileHorrors);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    const criticalCount = horrors.filter((h) => h.severity === 'critical').length;
+    const warningCount = horrors.filter((h) => h.severity === 'warning').length;
+    return {
+        detected: horrors.length > 0,
+        horrors: horrors.sort((a, b) => b.lineCount - a.lineCount),
+        totalCount: horrors.length,
+        criticalCount,
+        warningCount,
+    };
+}
+/**
+ * Analyze a single file for oversized functions.
+ */
+function analyzeFile(filePath, content) {
+    const horrors = [];
+    const lines = content.split('\n');
+    const ext = path.extname(filePath).toLowerCase();
+    // Determine which patterns to use based on file extension
+    const patterns = getPatterns(ext);
+    let currentFunction = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        // Check if this line starts a new function
+        for (const pattern of patterns) {
+            const match = line.match(pattern);
+            if (match) {
+                // If we were tracking a function, close it out
+                if (currentFunction) {
+                    const lineCount = lineNum - currentFunction.startLine;
+                    if (lineCount >= WARNING_THRESHOLD) {
+                        horrors.push(createHorror(filePath, currentFunction.name, currentFunction.startLine, lineCount));
+                    }
+                }
+                currentFunction = {
+                    name: match[1] || 'anonymous',
+                    startLine: lineNum,
+                    braceDepth: countBraces(line),
+                };
+                break;
+            }
+        }
+        // Track brace depth
+        if (currentFunction && !line.match(/^\s*\/\//)) {
+            currentFunction.braceDepth += countBraces(line);
+            // Check for function end (Python uses indentation, others use braces)
+            if (ext === '.py') {
+                // For Python, check if we hit a line with less indentation
+                // This is a simplified heuristic
+                if (i + 1 < lines.length) {
+                    const nextLine = lines[i + 1];
+                    if (nextLine.match(/^(?:def|class|@|\S)/) && !nextLine.match(/^\s*#/)) {
+                        const lineCount = lineNum - currentFunction.startLine + 1;
+                        if (lineCount >= WARNING_THRESHOLD) {
+                            horrors.push(createHorror(filePath, currentFunction.name, currentFunction.startLine, lineCount));
+                        }
+                        currentFunction = null;
+                    }
+                }
+            }
+            else if (currentFunction.braceDepth <= 0) {
+                // For brace-based languages, function ends when braces balance
+                const lineCount = lineNum - currentFunction.startLine + 1;
+                if (lineCount >= WARNING_THRESHOLD) {
+                    horrors.push(createHorror(filePath, currentFunction.name, currentFunction.startLine, lineCount));
+                }
+                currentFunction = null;
+            }
+        }
+    }
+    // Handle function that extends to end of file
+    if (currentFunction) {
+        const lineCount = lines.length - currentFunction.startLine + 1;
+        if (lineCount >= WARNING_THRESHOLD) {
+            horrors.push(createHorror(filePath, currentFunction.name, currentFunction.startLine, lineCount));
+        }
+    }
+    return horrors;
+}
+function getPatterns(ext) {
+    switch (ext) {
+        case '.ts':
+        case '.tsx':
+        case '.js':
+        case '.jsx':
+            return [
+                FUNCTION_PATTERNS.jsFunction,
+                FUNCTION_PATTERNS.jsArrow,
+                FUNCTION_PATTERNS.jsMethod,
+            ];
+        case '.py':
+            return [FUNCTION_PATTERNS.pyFunction];
+        case '.go':
+            return [FUNCTION_PATTERNS.goFunction];
+        default:
+            // Default to JS-like patterns
+            return [FUNCTION_PATTERNS.jsFunction, FUNCTION_PATTERNS.jsMethod];
+    }
+}
+function countBraces(line) {
+    // Simple brace counting (doesn't handle strings/comments perfectly)
+    let count = 0;
+    for (const char of line) {
+        if (char === '{')
+            count++;
+        if (char === '}')
+            count--;
+    }
+    return count;
+}
+function createHorror(file, functionName, lineStart, lineCount) {
+    return {
+        file,
+        functionName,
+        lineStart,
+        lineCount,
+        severity: lineCount >= CRITICAL_THRESHOLD ? 'critical' : 'warning',
+    };
+}
+/**
+ * Run eldritch horror detection on a directory.
+ */
+export function scanForHorrors(dir) {
+    const files = scanDirectory(dir);
+    return detectEldritchHorrors(files);
+}
+// Utility to scan directory (matching audit.ts pattern)
+const IGNORE_DIRS = ['node_modules', 'dist', 'coverage', '.git', '.vibe-check', '__pycache__'];
+function scanDirectory(dir) {
+    const results = [];
+    try {
+        const list = fs.readdirSync(dir);
+        for (const file of list) {
+            const filePath = path.join(dir, file);
+            const stat = fs.statSync(filePath);
+            if (stat && stat.isDirectory()) {
+                if (!IGNORE_DIRS.includes(file) && !file.startsWith('.')) {
+                    results.push(...scanDirectory(filePath));
+                }
+            }
+            else {
+                if (file.match(/\.(ts|js|jsx|tsx|py|go)$/)) {
+                    results.push(filePath);
+                }
+            }
+        }
+    }
+    catch {
+        // Silently skip unreadable directories
+    }
+    return results;
+}
+//# sourceMappingURL=eldritch.js.map

package/dist/analyzers/eldritch.js.map

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

package/dist/analyzers/modularity.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Modularity Analyzer
+ *
+ * Pattern-aware modularity assessment that goes beyond simple LOC counting.
+ * Recognizes that a well-organized 2,500-line file can be more maintainable
+ * than a poorly-structured 300-line file.
+ *
+ * Based on research into:
+ * - K8s-style controller patterns
+ * - Cohesion metrics (LCOM)
+ * - Coupling analysis (CBO, fan-in/fan-out)
+ * - Single Responsibility Principle indicators
+ */
+export interface ModularityResult {
+    files: FileModularity[];
+    summary: ModularitySummary;
+    exempted: ExemptedFile[];
+}
+export interface FileModularity {
+    file: string;
+    lines: number;
+    pattern: FilePattern | null;
+    score: number;
+    rating: ModularityRating;
+    flags: ModularityFlag[];
+    details: ModularityDetails;
+}
+export interface ModularityDetails {
+    hasSections: boolean;
+    sectionCount: number;
+    exportCount: number;
+    importCount: number;
+    hasNestedClasses: boolean;
+    methodCount: number;
+}
+export interface ModularitySummary {
+    totalFiles: number;
+    totalLines: number;
+    avgScore: number;
+    distribution: {
+        elite: number;
+        good: number;
+        acceptable: number;
+        needsWork: number;
+        poor: number;
+    };
+    largestFiles: {
+        file: string;
+        lines: number;
+        score: number;
+    }[];
+}
+export interface ExemptedFile {
+    file: string;
+    lines: number;
+    reason: string;
+}
+export type ModularityRating = 'elite' | 'good' | 'acceptable' | 'needs-work' | 'poor';
+export type ModularityFlag = 'no-single-responsibility' | 'no-internal-structure' | 'high-coupling' | 'low-cohesion' | 'missing-tests' | 'god-class' | 'utility-grab-bag';
+export type FilePattern = 'controller' | 'store' | 'routes' | 'types' | 'state-machine' | 'test' | 'generated' | 'component' | 'middleware' | 'utility';
+export interface ModularityOptions {
+    minLines?: number;
+    includeAll?: boolean;
+    patterns?: FilePattern[];
+}
+export declare function analyzeModularity(rootDir: string, options?: ModularityOptions): ModularityResult;
+//# sourceMappingURL=modularity.d.ts.map

package/dist/analyzers/modularity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modularity.d.ts","sourceRoot":"","sources":["../../src/analyzers/modularity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;AAEvF,MAAM,MAAM,cAAc,GACtB,0BAA0B,GAC1B,uBAAuB,GACvB,eAAe,GACf,cAAc,GACd,eAAe,GACf,WAAW,GACX,kBAAkB,CAAC;AAEvB,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,OAAO,GACP,eAAe,GACf,MAAM,GACN,WAAW,GACX,WAAW,GACX,YAAY,GACZ,SAAS,CAAC;AAyMd,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAoClB"}