@empline/preflight 1.1.0

package/dist/checks/code-hygiene/unicode-console-compatibility.js

@@ -0,0 +1,240 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Unicode Console Compatibility Preflight
+ *
+ * Detects hardcoded Unicode box-drawing characters and emojis in scripts that
+ * will render as garbled text (öüΓöü) on Windows CMD / Kiro terminals.
+ *
+ * Files should use the console-chars utility instead:
+ *   import { createDivider, emoji, box } from '../utils/console-chars';
+ *
+ * Usage:
+ *   pnpm preflight:unicode-console    # Check for issues
+ *   pnpm preflight:unicode-console -v # Verbose output
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const file_cache_1 = require("../../shared/file-cache");
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const exclusions_1 = require("../../shared/exclusions");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "code-hygiene/unicode-console-compatibility";
+exports.name = "Unicode Console Compatibility";
+exports.category = "code-hygiene";
+exports.blocking = false;
+exports.description = "Unicode Console Compatibility Preflight";
+exports.tags = ["code-hygiene"];
+// Unicode characters that cause issues on Windows CMD
+const PROBLEMATIC_CHARS = [
+    // Box drawing - heavy
+    { char: "${box.heavyHorizontal}", name: "heavy horizontal", regex: /${box.heavyHorizontal}/g },
+    { char: "${box.heavyVertical}", name: "heavy vertical", regex: /${box.heavyVertical}/g },
+    // Box drawing - double
+    { char: "${box.doubleHorizontal}", name: "double horizontal", regex: /${box.doubleHorizontal}/g },
+    { char: "${box.doubleVertical}", name: "double vertical", regex: /${box.doubleVertical}/g },
+    { char: "╔", name: "double top-left", regex: /╔/g },
+    { char: "╗", name: "double top-right", regex: /╗/g },
+    { char: "╚", name: "double bottom-left", regex: /╚/g },
+    { char: "╝", name: "double bottom-right", regex: /╝/g },
+    // Box drawing - light
+    { char: "${box.horizontal}", name: "light horizontal", regex: /${box.horizontal}/g },
+    { char: "${box.vertical}", name: "light vertical", regex: /${box.vertical}/g },
+    { char: "${box.topLeft}", name: "light top-left", regex: /${box.topLeft}/g },
+    { char: "${box.topRight}", name: "light top-right", regex: /${box.topRight}/g },
+    { char: "${box.bottomLeft}", name: "light bottom-left", regex: /${box.bottomLeft}/g },
+    { char: "${box.bottomRight}", name: "light bottom-right", regex: /${box.bottomRight}/g },
+    { char: "${box.teeLeft}", name: "light tee-left", regex: /${box.teeLeft}/g },
+    { char: "${box.teeRight}", name: "light tee-right", regex: /${box.teeRight}/g },
+    { char: "┬", name: "light tee-top", regex: /┬/g },
+    { char: "┴", name: "light tee-bottom", regex: /┴/g },
+    { char: "┼", name: "light cross", regex: /┼/g },
+    // Progress bar chars
+    { char: "█", name: "full block", regex: /█/g },
+    { char: "░", name: "light shade", regex: /░/g },
+    { char: "▓", name: "dark shade", regex: /▓/g },
+    { char: "▒", name: "medium shade", regex: /▒/g },
+    // Spinner chars
+    { char: "⠋", name: "braille spinner", regex: /[⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏]/g },
+    // Common emojis in console output
+    { char: "✓", name: "check mark", regex: /✓/g },
+    { char: "✗", name: "cross mark", regex: /✗/g },
+    { char: "${emoji.success}", name: "check emoji", regex: /${emoji.success}/g },
+    { char: "${emoji.error}", name: "cross emoji", regex: /${emoji.error}/g },
+    { char: "${emoji.warning}", name: "warning", regex: /${emoji.warning}/g },
+    { char: "ℹ", name: "info", regex: /ℹ/g },
+    { char: "${emoji.hint}", name: "hint", regex: /${emoji.hint}/g },
+    { char: "${emoji.search}", name: "search", regex: /${emoji.search}/g },
+    { char: "${emoji.file}", name: "file", regex: /${emoji.file}/g },
+    { char: "${emoji.folder}", name: "folder", regex: /${emoji.folder}/g },
+    { char: "${emoji.wrench}", name: "wrench", regex: /${emoji.wrench}/g },
+    { char: "${emoji.testTube}", name: "test tube", regex: /${emoji.testTube}/g },
+    { char: "${emoji.rocket}", name: "rocket", regex: /${emoji.rocket}/g },
+    { char: "${emoji.lock}", name: "lock", regex: /${emoji.lock}/g },
+];
+let appExclusions = [];
+// Files/patterns to exclude
+const EXCLUDED_PATTERNS = [
+    "**/node_modules/**",
+    "**/.next/**",
+    "**/__mocks__/**",
+    "**/dist/**",
+    "**/coverage/**",
+    "**/console-chars.ts", // The utility itself is allowed
+    "**/console-chars.js",
+    "**/unicode-console-compatibility.ts", // This file
+];
+function shouldSkipFile(filePath) {
+    return (0, exclusions_1.shouldExcludeFile)(filePath, appExclusions);
+}
+// Patterns that indicate the line is in a comment or documentation
+const COMMENT_PATTERNS = [
+    /^\s*\/\//, // Single line comment
+    /^\s*\*/, // Multi-line comment continuation
+    /^\s*\/\*/, // Multi-line comment start
+    /@example/, // JSDoc example
+    /\* /, // JSDoc line
+];
+function isInComment(line) {
+    return COMMENT_PATTERNS.some((p) => p.test(line));
+}
+function isInConsoleOutput(line) {
+    return (/console\.(log|warn|error|info)/.test(line) ||
+        /process\.stdout/.test(line) ||
+        /process\.stderr/.test(line));
+}
+async function scanFile(filePath) {
+    const issues = [];
+    const content = fs.readFileSync(filePath, "utf8");
+    const lines = content.split("\n");
+    // Skip if file imports console-chars (it's using the utility)
+    if (/import\s+.*from\s+['"].*console-chars/.test(content)) {
+        // Still check for hardcoded chars in console.log statements
+        // that bypass the utility
+    }
+    lines.forEach((line, index) => {
+        const inComment = isInComment(line);
+        const inConsole = isInConsoleOutput(line);
+        // Only flag issues in actual console output, not comments/docs
+        if (!inConsole && !inComment)
+            return;
+        if (inComment)
+            return; // Skip comments entirely
+        for (const { char, name, regex } of PROBLEMATIC_CHARS) {
+            regex.lastIndex = 0; // Reset regex state
+            if (regex.test(line)) {
+                issues.push({
+                    file: filePath,
+                    line: index + 1,
+                    char,
+                    charName: name,
+                    context: line.trim().substring(0, 80),
+                    inComment,
+                });
+            }
+        }
+    });
+    return issues;
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    console.log(`\n${console_chars_1.emoji.search} UNICODE CONSOLE COMPATIBILITY`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    // Find all script files
+    const files = await file_cache_1.fileCache.getFiles("scripts/**/*.{ts,js,mjs}", { ignore: EXCLUDED_PATTERNS });
+    console.log(`Scanning ${files.length} script files...\n`);
+    const allIssues = [];
+    for (const file of files) {
+        if (shouldSkipFile(file)) {
+            continue;
+        }
+        const issues = await scanFile(file);
+        allIssues.push(...issues);
+    }
+    // Filter out comment-only issues
+    const consoleIssues = allIssues.filter((i) => !i.inComment);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    if (consoleIssues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No hardcoded Unicode in console output\n`);
+        process.exit(0);
+    }
+    // Group by file
+    const byFile = new Map();
+    for (const issue of consoleIssues) {
+        const existing = byFile.get(issue.file) || [];
+        existing.push(issue);
+        byFile.set(issue.file, existing);
+    }
+    console.log(`${console_chars_1.emoji.warning} Found ${consoleIssues.length} hardcoded Unicode character(s) in ${byFile.size} file(s):\n`);
+    for (const [file, issues] of byFile) {
+        const relPath = path.relative(process.cwd(), file);
+        console.log(`  ${console_chars_1.emoji.file} ${relPath}`);
+        if (verbose) {
+            for (const issue of issues.slice(0, 5)) {
+                console.log(`     Line ${issue.line}: ${issue.charName} (${issue.char})`);
+                console.log(`     ${issue.context}`);
+            }
+            if (issues.length > 5) {
+                console.log(`     ... and ${issues.length - 5} more`);
+            }
+        }
+        else {
+            const charTypes = [...new Set(issues.map((i) => i.charName))];
+            console.log(`     ${issues.length} issue(s): ${charTypes.slice(0, 3).join(", ")}${charTypes.length > 3 ? "..." : ""}`);
+        }
+        console.log("");
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.hint} Fix: Import from console-chars utility instead:`);
+    console.log(`   import { createDivider, emoji, box } from '../utils/console-chars';`);
+    console.log(`   console.log(createDivider(60, "heavy")); // ASCII-safe`);
+    console.log(`   console.log(\`\${emoji.success} Done!\`);  // ASCII-safe\n`);
+    // Warning only, don't block
+    console.log(`${console_chars_1.emoji.warning} UNICODE COMPATIBILITY: ${consoleIssues.length} issue(s) (non-blocking)\n`);
+    process.exit(0); // Non-blocking for now
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=unicode-console-compatibility.js.map

package/dist/checks/code-hygiene/unicode-console-compatibility.js.map

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

package/dist/checks/code-quality/api-route-patterns.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env tsx
+/**
+ * API Route Patterns Preflight
+ *
+ * Detects duplicated boilerplate patterns in API routes that could
+ * be consolidated using middleware or wrapper utilities.
+ *
+ * Anti-patterns detected:
+ * - Duplicated try/catch error handling
+ * - Repeated auth checks with error handling
+ * - Repeated JSON parsing with try/catch
+ * - Duplicated response formatting
+ * - Missing error handling
+ * - Inconsistent error response formats
+ *
+ * Correct patterns:
+ * - Use withAuth() wrapper for authenticated routes
+ * - Use withValidation(schema) for Zod validation
+ * - Use apiError() utility for consistent error responses
+ * - Use apiSuccess() utility for consistent success responses
+ */
+import { PreflightCheckResult } from "../../core/types";
+export declare const id = "code-quality/api-route-patterns";
+export declare const name = "API Route Patterns";
+export declare const description = "Detects duplicated boilerplate in API routes";
+export declare const category = "code-quality";
+export declare const blocking = false;
+export declare const tags: string[];
+export declare function run(): Promise<PreflightCheckResult>;
+//# sourceMappingURL=api-route-patterns.d.ts.map

package/dist/checks/code-quality/api-route-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-route-patterns.d.ts","sourceRoot":"","sources":["../../../src/checks/code-quality/api-route-patterns.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAK1E,eAAO,MAAM,EAAE,oCAAoC,CAAC;AACpD,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,WAAW,iDAAiD,CAAC;AAC1E,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,IAAI,UAAoE,CAAC;AAsNtF,wBAAsB,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAgHzD"}

package/dist/checks/code-quality/api-route-patterns.js

@@ -0,0 +1,356 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * API Route Patterns Preflight
+ *
+ * Detects duplicated boilerplate patterns in API routes that could
+ * be consolidated using middleware or wrapper utilities.
+ *
+ * Anti-patterns detected:
+ * - Duplicated try/catch error handling
+ * - Repeated auth checks with error handling
+ * - Repeated JSON parsing with try/catch
+ * - Duplicated response formatting
+ * - Missing error handling
+ * - Inconsistent error response formats
+ *
+ * Correct patterns:
+ * - Use withAuth() wrapper for authenticated routes
+ * - Use withValidation(schema) for Zod validation
+ * - Use apiError() utility for consistent error responses
+ * - Use apiSuccess() utility for consistent success responses
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+const exclusions_1 = require("../../shared/exclusions");
+let appExclusions = [];
+// METADATA
+exports.id = "code-quality/api-route-patterns";
+exports.name = "API Route Patterns";
+exports.description = "Detects duplicated boilerplate in API routes";
+exports.category = "code-quality";
+exports.blocking = false;
+exports.tags = ["api", "routes", "boilerplate", "consistency", "error-handling"];
+// Anti-patterns to detect
+const ANTI_PATTERNS = [
+    // Duplicated auth check pattern
+    {
+        pattern: /const\s+session\s*=\s*await\s+(?:requireAuth|getServerSession|auth)\s*\([^)]*\);?\s*(?:\n\s*)?if\s*\(\s*!session\s*\)/,
+        name: "inline-auth-check",
+        message: "Inline auth check with manual error handling",
+        suggestion: "Use withAuth() wrapper which handles auth checks and errors automatically",
+        severity: "info",
+    },
+    // Duplicated JSON parsing with try/catch
+    {
+        pattern: /let\s+(?:body|data|json)\s*(?::\s*\w+)?;?\s*\n?\s*try\s*\{\s*(?:body|data|json)\s*=\s*await\s+request\.json\(\)/,
+        name: "json-parse-try-catch",
+        message: "JSON parsing with manual try/catch",
+        suggestion: "Use withValidation(schema) which handles parsing and validation together",
+        severity: "info",
+    },
+    // Nested try/catch (outer for general, inner for JSON)
+    {
+        pattern: /try\s*\{[\s\S]{0,100}try\s*\{[\s\S]{0,50}await\s+request\.json\(\)/,
+        name: "nested-try-catch",
+        message: "Nested try/catch blocks for request handling",
+        suggestion: "Use route wrapper utilities to reduce nesting",
+        severity: "warning",
+    },
+    // Manual error response formatting
+    {
+        pattern: /return\s+(?:new\s+)?(?:NextResponse|Response)\.json\(\s*\{\s*(?:error|message)\s*:/,
+        name: "manual-error-response",
+        message: "Manual error response formatting",
+        suggestion: "Use apiError() utility for consistent error responses",
+        severity: "info",
+    },
+    // Inconsistent status codes in catch blocks
+    {
+        pattern: /catch\s*\([^)]*\)\s*\{[\s\S]{0,200}return[\s\S]{0,100}status:\s*(?:400|401|403|404|500)/,
+        name: "catch-with-status",
+        message: "Status code in catch block",
+        suggestion: "Use apiError() which maps error types to appropriate status codes",
+        severity: "info",
+    },
+    // Missing error handling (no try/catch in async function)
+    {
+        pattern: /export\s+async\s+function\s+(?:GET|POST|PUT|PATCH|DELETE)\s*\([^)]*\)\s*\{(?:(?!try\s*\{)[\s\S]){50,}return/,
+        name: "missing-error-handling",
+        message: "Async route handler without try/catch",
+        suggestion: "Add try/catch or use withErrorHandling() wrapper",
+        severity: "warning",
+    },
+    // Repeated requireAuth in multiple handlers in same file
+    {
+        pattern: /requireAuth\s*\(\)[\s\S]*?requireAuth\s*\(\)/,
+        name: "multiple-auth-calls",
+        message: "Multiple requireAuth() calls in same file",
+        suggestion: "Consider using withAuth() wrapper at the handler level",
+        severity: "info",
+    },
+    // Zod validation without proper error handling
+    {
+        pattern: /\.parse\s*\([\s\S]{0,50}\)[\s\S]{0,200}(?!catch)/,
+        name: "zod-parse-without-catch",
+        message: "Zod .parse() without error handling",
+        suggestion: "Use .safeParse() or withValidation() wrapper for proper error handling",
+        severity: "warning",
+    },
+    // Console.error in production routes
+    {
+        pattern: /console\.(?:error|log)\s*\(/,
+        name: "console-in-route",
+        message: "console.log/error in API route",
+        suggestion: "Use logger utility for proper logging with context",
+        severity: "info",
+    },
+];
+// Good patterns to track
+const GOOD_PATTERNS = [
+    {
+        pattern: /import\s*\{[^}]*apiError[^}]*\}\s*from/,
+        name: "uses-api-error",
+    },
+    {
+        pattern: /import\s*\{[^}]*apiSuccess[^}]*\}\s*from/,
+        name: "uses-api-success",
+    },
+    {
+        pattern: /import\s*\{[^}]*withAuth[^}]*\}\s*from/,
+        name: "uses-with-auth",
+    },
+    {
+        pattern: /import\s*\{[^}]*withValidation[^}]*\}\s*from/,
+        name: "uses-with-validation",
+    },
+    {
+        pattern: /import\s*\{[^}]*logger[^}]*\}\s*from/,
+        name: "uses-logger",
+    },
+    {
+        pattern: /\.safeParse\s*\(/,
+        name: "uses-safe-parse",
+    },
+];
+async function findApiRouteFiles() {
+    const patterns = [
+        "app/api/**/route.ts",
+        "app/api/**/route.tsx",
+    ];
+    const allFiles = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: ["**/node_modules/**"],
+        });
+        allFiles.push(...matches);
+    }
+    return [...new Set(allFiles)].filter((file) => !(0, exclusions_1.shouldExcludeFile)(file, appExclusions));
+}
+function countPatternOccurrences(content, pattern) {
+    const globalPattern = new RegExp(pattern.source, "g");
+    const matches = content.match(globalPattern);
+    return matches ? matches.length : 0;
+}
+function checkFile(filePath, content) {
+    const issues = [];
+    const lines = content.split("\n");
+    // Calculate stats
+    const stats = {
+        methodCount: countPatternOccurrences(content, /export\s+async\s+function\s+(?:GET|POST|PUT|PATCH|DELETE)/),
+        tryCatchCount: countPatternOccurrences(content, /try\s*\{/),
+        authCheckCount: countPatternOccurrences(content, /requireAuth|getServerSession/),
+        jsonParseCount: countPatternOccurrences(content, /request\.json\(\)/),
+    };
+    // Check for good patterns
+    const goodPatternsFound = GOOD_PATTERNS.filter((gp) => gp.pattern.test(content)).map((gp) => gp.name);
+    // Check anti-patterns
+    for (const antiPattern of ANTI_PATTERNS) {
+        // Skip certain warnings if using good patterns
+        if (goodPatternsFound.includes("uses-api-error") && antiPattern.name === "manual-error-response")
+            continue;
+        if (goodPatternsFound.includes("uses-with-auth") && antiPattern.name === "inline-auth-check")
+            continue;
+        if (goodPatternsFound.includes("uses-logger") && antiPattern.name === "console-in-route")
+            continue;
+        if (goodPatternsFound.includes("uses-safe-parse") && antiPattern.name === "zod-parse-without-catch")
+            continue;
+        const match = content.match(antiPattern.pattern);
+        if (match) {
+            let lineNumber = 1;
+            let charCount = 0;
+            for (let i = 0; i < lines.length; i++) {
+                charCount += lines[i].length + 1;
+                if (charCount > (match.index || 0)) {
+                    lineNumber = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                severity: antiPattern.severity,
+                message: antiPattern.message,
+                suggestion: antiPattern.suggestion,
+                code: antiPattern.name,
+            });
+        }
+    }
+    return { file: filePath, issues, stats };
+}
+function analyzeRouteComplexity(results) {
+    // Find routes with high boilerplate
+    const highBoilerplateRoutes = results
+        .filter((r) => r.stats.tryCatchCount >= 2 || (r.stats.authCheckCount >= 2 && r.stats.jsonParseCount >= 2))
+        .sort((a, b) => (b.stats.tryCatchCount + b.stats.authCheckCount) - (a.stats.tryCatchCount + a.stats.authCheckCount));
+    if (highBoilerplateRoutes.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  HIGH BOILERPLATE ROUTES:`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const route of highBoilerplateRoutes.slice(0, 5)) {
+            console.log(`  ${route.file}`);
+            console.log(`    Methods: ${route.stats.methodCount}, Try/Catch: ${route.stats.tryCatchCount}, Auth: ${route.stats.authCheckCount}`);
+        }
+    }
+}
+async function run() {
+    const startTime = Date.now();
+    const verbose = process.argv.includes("--verbose") || process.argv.includes("-v");
+    const preflightFindings = [];
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.search} API Route Patterns`);
+    console.log(`Checking for API route boilerplate patterns...\n`);
+    try {
+        appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    }
+    catch {
+        appExclusions = [];
+    }
+    const files = await findApiRouteFiles();
+    console.log(`Scanning ${files.length} API route files...\n`);
+    const results = [];
+    const allIssues = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            const result = checkFile(file, content);
+            results.push(result);
+            allIssues.push(...result.issues);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    // Summary stats
+    const totalMethods = results.reduce((sum, r) => sum + r.stats.methodCount, 0);
+    const totalTryCatch = results.reduce((sum, r) => sum + r.stats.tryCatchCount, 0);
+    const totalAuthChecks = results.reduce((sum, r) => sum + r.stats.authCheckCount, 0);
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    const info = allIssues.filter((i) => i.severity === "info");
+    // Group issues by code
+    const issuesByCode = new Map();
+    for (const issue of allIssues) {
+        if (!issuesByCode.has(issue.code)) {
+            issuesByCode.set(issue.code, []);
+        }
+        issuesByCode.get(issue.code).push(issue);
+    }
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  POTENTIAL ISSUES:`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const [code, issues] of issuesByCode) {
+            if (issues[0].severity !== "warning")
+                continue;
+            console.log(`\n  ${console_chars_1.chars.bullet} ${code} (${issues.length} occurrences):`);
+            for (const issue of issues.slice(0, 3)) {
+                console.log(`    ${issue.file}:${issue.line}`);
+                preflightFindings.push({
+                    level: "warning",
+                    message: issue.message,
+                    file: issue.file,
+                    startLine: issue.line,
+                    suggestion: issue.suggestion,
+                    ruleId: `api-route/${issue.code}`,
+                });
+            }
+            if (issues.length > 3) {
+                console.log(`    ...and ${issues.length - 3} more`);
+            }
+            if (verbose) {
+                console.log(`    ${console_chars_1.emoji.hint} ${issues[0].suggestion}`);
+            }
+        }
+        console.log("");
+    }
+    if (verbose) {
+        analyzeRouteComplexity(results);
+        if (info.length > 0) {
+            console.log(`\n${console_chars_1.emoji.info}  CONSOLIDATION OPPORTUNITIES:`);
+            console.log((0, console_chars_1.createDivider)(60, "light"));
+            for (const [code, issues] of issuesByCode) {
+                if (issues[0].severity !== "info")
+                    continue;
+                console.log(`  ${console_chars_1.chars.bullet} ${code}: ${issues.length} occurrences`);
+            }
+        }
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`API routes scanned: ${files.length}`);
+    console.log(`Total route handlers: ${totalMethods}`);
+    console.log(`Total try/catch blocks: ${totalTryCatch}`);
+    console.log(`Total auth checks: ${totalAuthChecks}`);
+    console.log(`\nWarnings: ${warnings.length}`);
+    console.log(`Info: ${info.length}`);
+    if (warnings.length === 0 && info.length < 10) {
+        console.log(`\n${console_chars_1.emoji.success} API route patterns look good\n`);
+        return { passed: true, findings: [], duration: Date.now() - startTime };
+    }
+    console.log(`\n${console_chars_1.emoji.docs} Recommended utilities:`);
+    console.log(`   ${console_chars_1.chars.bullet} apiError(message, status) - Consistent error responses`);
+    console.log(`   ${console_chars_1.chars.bullet} apiSuccess(data) - Consistent success responses`);
+    console.log(`   ${console_chars_1.chars.bullet} withAuth(handler) - Wrapper with auth check`);
+    console.log(`   ${console_chars_1.chars.bullet} withValidation(schema)(handler) - Wrapper with Zod validation`);
+    console.log(`   ${console_chars_1.chars.bullet} logger.error() - Structured logging\n`);
+    return { passed: true, findings: preflightFindings, duration: Date.now() - startTime };
+}
+// CLI execution
+if (require.main === module) {
+    run().then((result) => process.exit(result.passed ? 0 : 1)).catch(() => process.exit(1));
+}
+//# sourceMappingURL=api-route-patterns.js.map