@empline/preflight 1.0.20

package/dist/checks/business/timezone-handling.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env tsx
+/**
+ * Timezone Handling Validation Preflight
+ *
+ * Ensures consistent timezone handling across the application.
+ * Inconsistent timezone handling causes issues with:
+ * - Order timestamps appearing wrong to users
+ * - Promotional pricing activating at wrong times
+ * - Analytics data being skewed
+ * - Scheduled tasks running at wrong times
+ *
+ * Checks for:
+ * - new Date() without timezone consideration
+ * - Date comparisons without normalization
+ * - Hardcoded timezone offsets
+ * - Missing timezone in date formatting
+ *
+ * Usage:
+ *   pnpm preflight:timezone
+ *   pnpm preflight:timezone --verbose
+ */
+export declare const id = "business/timezone-handling";
+export declare const name = "Timezone Handling";
+export declare const category = "business";
+export declare const blocking = true;
+export declare const description = "Timezone Handling Validation Preflight";
+export declare const tags: string[];
+//# sourceMappingURL=timezone-handling.d.ts.map

package/dist/checks/business/timezone-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone-handling.d.ts","sourceRoot":"","sources":["../../../src/checks/business/timezone-handling.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,sBAAsB,CAAC;AACxC,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,2CAA2C,CAAC;AACpE,eAAO,MAAM,IAAI,UAAe,CAAC"}

package/dist/checks/business/timezone-handling.js

@@ -0,0 +1,294 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Timezone Handling Validation Preflight
+ *
+ * Ensures consistent timezone handling across the application.
+ * Inconsistent timezone handling causes issues with:
+ * - Order timestamps appearing wrong to users
+ * - Promotional pricing activating at wrong times
+ * - Analytics data being skewed
+ * - Scheduled tasks running at wrong times
+ *
+ * Checks for:
+ * - new Date() without timezone consideration
+ * - Date comparisons without normalization
+ * - Hardcoded timezone offsets
+ * - Missing timezone in date formatting
+ *
+ * Usage:
+ *   pnpm preflight:timezone
+ *   pnpm preflight:timezone --verbose
+ */
+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;
+const fs = __importStar(require("fs"));
+const glob_1 = require("glob");
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "business/timezone-handling";
+exports.name = "Timezone Handling";
+exports.category = "business";
+exports.blocking = true;
+exports.description = "Timezone Handling Validation Preflight";
+exports.tags = ["business"];
+// Dangerous patterns that may cause timezone issues
+const DANGEROUS_PATTERNS = [
+    {
+        pattern: /new\s+Date\(\s*\)\.toISOString\(\)\.split\(['"]T['"]\)/gi,
+        message: 'Date split on "T" loses timezone information',
+        severity: "warning",
+        suggestion: "Use date-fns formatInTimeZone or dayjs with timezone plugin",
+    },
+    {
+        pattern: /\.getHours\(\)|\.getMinutes\(\)|\.getDate\(\)|\.getMonth\(\)/gi,
+        message: "Local time methods may return different values in different timezones",
+        severity: "info",
+        suggestion: "Use getUTCHours(), getUTCMinutes(), etc. or a timezone-aware library",
+    },
+    {
+        pattern: /setHours\s*\(\s*0\s*,\s*0\s*,\s*0/gi,
+        message: "Setting hours to 0 uses local timezone - may cause date boundary issues",
+        severity: "warning",
+        suggestion: "Use startOfDay from date-fns with timezone or setUTCHours",
+    },
+    {
+        pattern: /new\s+Date\s*\(\s*['"`]\d{4}-\d{2}-\d{2}['"`]\s*\)/gi,
+        message: "Date string without time/timezone parsed as local midnight",
+        severity: "warning",
+        suggestion: 'Append "T00:00:00Z" for UTC or use parseISO from date-fns',
+    },
+    {
+        pattern: /\.toLocaleDateString\s*\(\s*\)/gi,
+        message: "toLocaleDateString without locale may produce inconsistent results",
+        severity: "info",
+        suggestion: 'Specify locale: toLocaleDateString("en-US") or use Intl.DateTimeFormat',
+    },
+    {
+        pattern: /Date\.now\(\)\s*[+-]\s*\d+\s*\*\s*(?:60|3600|86400)/gi,
+        message: "Manual time arithmetic - consider DST transitions",
+        severity: "info",
+        suggestion: "Use date-fns addHours/addDays which handle DST correctly",
+    },
+    {
+        pattern: /getTimezoneOffset\s*\(\)/gi,
+        message: "getTimezoneOffset varies by date due to DST",
+        severity: "info",
+        suggestion: "Use a timezone library that handles DST transitions",
+    },
+    {
+        pattern: /[+-]\s*(?:5|6|7|8|9)\s*\*\s*60\s*\*\s*60\s*\*\s*1000/gi,
+        message: "Hardcoded timezone offset - will break during DST",
+        severity: "error",
+        suggestion: "Use IANA timezone names (America/New_York) with a timezone library",
+    },
+];
+// Patterns indicating proper timezone handling
+const SAFE_PATTERNS = [
+    /formatInTimeZone/,
+    /zonedTimeToUtc/,
+    /utcToZonedTime/,
+    /dayjs.*tz\s*\(/,
+    /moment.*tz\s*\(/,
+    /Intl\.DateTimeFormat.*timeZone/,
+    /toLocaleString.*timeZone/,
+    /\.toISOString\(\)/,
+    /getUTC(?:Hours|Minutes|Seconds|Date|Month|FullYear)/,
+    /setUTC(?:Hours|Minutes|Seconds|Date|Month|FullYear)/,
+];
+// Files/patterns to skip
+const SKIP_PATTERNS = [/\.test\./, /\.spec\./, /__mocks__/, /node_modules/, /\.d\.ts$/];
+async function findFiles() {
+    const patterns = [
+        "app/**/*.ts",
+        "app/**/*.tsx",
+        "lib/**/*.ts",
+        "components/**/*.ts",
+        "components/**/*.tsx",
+    ];
+    const files = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: ["**/node_modules/**", "**/*.test.ts", "**/*.spec.ts", "**/dist/**"],
+        });
+        files.push(...matches);
+    }
+    return [...new Set(files)];
+}
+function checkFile(filePath, content) {
+    const issues = [];
+    const lines = content.split("\n");
+    // Skip test files
+    if (SKIP_PATTERNS.some((p) => p.test(filePath))) {
+        return [];
+    }
+    // Check if file uses safe timezone patterns
+    const usesSafePatterns = SAFE_PATTERNS.some((p) => p.test(content));
+    for (const { pattern, message, severity, suggestion } of DANGEROUS_PATTERNS) {
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            const matchIndex = match.index;
+            // Find line number
+            let lineNumber = 1;
+            let charCount = 0;
+            for (let i = 0; i < lines.length; i++) {
+                charCount += lines[i].length + 1;
+                if (charCount > matchIndex) {
+                    lineNumber = i + 1;
+                    break;
+                }
+            }
+            // Check context for safe patterns
+            const contextStart = Math.max(0, matchIndex - 100);
+            const contextEnd = Math.min(content.length, matchIndex + match[0].length + 100);
+            const context = content.slice(contextStart, contextEnd);
+            const hasSafeContext = SAFE_PATTERNS.some((p) => p.test(context));
+            // Skip if using safe patterns in context
+            if (hasSafeContext) {
+                continue;
+            }
+            // Downgrade severity if file generally uses safe patterns
+            const adjustedSeverity = usesSafePatterns && severity === "error" ? "warning" : severity;
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                severity: adjustedSeverity,
+                message,
+                suggestion,
+            });
+        }
+    }
+    // Check for date comparisons in business logic
+    if (/(?:promotional|promo|sale|discount|coupon).*(?:start|end|expir)/i.test(content)) {
+        const hasDateComparison = /new\s+Date\s*\([^)]*\)\s*[<>=]/i.test(content);
+        const hasProperComparison = /(?:isBefore|isAfter|compareAsc|compareDesc|isSameDay)/i.test(content);
+        if (hasDateComparison && !hasProperComparison) {
+            issues.push({
+                file: filePath,
+                line: 1,
+                severity: "warning",
+                message: "Promotional date comparison may have timezone issues",
+                suggestion: "Use date-fns comparison functions or ensure UTC comparison",
+            });
+        }
+    }
+    return issues;
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    const verbose = process.argv.includes("--verbose") || process.argv.includes("-v");
+    console.log("🌍 Timezone Handling Validation Preflight");
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    const files = await findFiles();
+    console.log(`Scanning ${files.length} files for timezone issues...\n`);
+    const allIssues = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            const issues = checkFile(file, content);
+            allIssues.push(...issues);
+        }
+        catch (error) {
+            // Skip files that can't be read
+        }
+    }
+    // Deduplicate
+    const uniqueIssues = allIssues.filter((issue, index, self) => index ===
+        self.findIndex((i) => i.file === issue.file && i.line === issue.line && i.message === issue.message));
+    // Group by severity
+    const errors = uniqueIssues.filter((i) => i.severity === "error");
+    const warnings = uniqueIssues.filter((i) => i.severity === "warning");
+    const info = uniqueIssues.filter((i) => i.severity === "info");
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} ERRORS (blocking):`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of errors) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            console.log("");
+        }
+    }
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  WARNINGS:`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of warnings.slice(0, verbose ? warnings.length : 10)) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            if (verbose) {
+                console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+            console.log("");
+        }
+        if (!verbose && warnings.length > 10) {
+            console.log(`  ... and ${warnings.length - 10} more (use --verbose to see all)`);
+        }
+    }
+    if (verbose && info.length > 0) {
+        console.log(`${console_chars_1.emoji.info}  INFO:`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of info.slice(0, 20)) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            console.log("");
+        }
+        if (info.length > 20) {
+            console.log(`  ... and ${info.length - 20} more`);
+        }
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`Files scanned: ${files.length}`);
+    console.log(`Errors: ${errors.length}`);
+    console.log(`Warnings: ${warnings.length}`);
+    console.log(`Info: ${info.length}`);
+    if (errors.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No critical timezone issues detected`);
+    }
+    console.log(`\n${console_chars_1.emoji.docs} Best practices:`);
+    console.log(`   ${console_chars_1.chars.bullet} Store dates in UTC (ISO 8601 format)`);
+    console.log(`   ${console_chars_1.chars.bullet} Use IANA timezone names (America/New_York, not EST)`);
+    console.log(`   ${console_chars_1.chars.bullet} Convert to user timezone only for display`);
+    console.log(`   ${console_chars_1.chars.bullet} Use date-fns-tz or dayjs with timezone plugin`);
+    console.log(`   ${console_chars_1.chars.bullet} Test with different system timezones`);
+    if (errors.length > 0) {
+        process.exit(1);
+    }
+}
+main().catch(console.error);
+//# sourceMappingURL=timezone-handling.js.map

package/dist/checks/business/timezone-handling.js.map

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

package/dist/checks/code-hygiene/any-type-detection.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env tsx
+/**
+ * TypeScript 'any' Type Detection Preflight (BLOCKING)
+ *
+ * Detects usage of 'any' type which bypasses TypeScript's type safety.
+ *
+ * Patterns detected:
+ * - : any
+ * - as any
+ * - <any>
+ * - any[]
+ *
+ * Excludes:
+ * - Type definition files (.d.ts)
+ * - Test files
+ * - Third-party type augmentations
+ * - Legitimate uses with // @ts-expect-error or eslint-disable
+ *
+ * Usage:
+ *   pnpm preflight:any-type
+ *   pnpm preflight:any-type --warning
+ *   pnpm preflight:any-type --strict  (also flags 'unknown' casts)
+ */
+export declare const id = "code-hygiene/any-type-detection";
+export declare const name = "Any Type Detection";
+export declare const category = "code-hygiene";
+export declare const blocking = true;
+export declare const description = "TypeScript 'any' Type Detection Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=any-type-detection.d.ts.map

package/dist/checks/code-hygiene/any-type-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"any-type-detection.d.ts","sourceRoot":"","sources":["../../../src/checks/code-hygiene/any-type-detection.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAUH,eAAO,MAAM,EAAE,oCAAoC,CAAC;AACpD,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,yDAAyD,CAAC;AAClF,eAAO,MAAM,IAAI,UAAmB,CAAC"}

package/dist/checks/code-hygiene/any-type-detection.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * TypeScript 'any' Type Detection Preflight (BLOCKING)
+ *
+ * Detects usage of 'any' type which bypasses TypeScript's type safety.
+ *
+ * Patterns detected:
+ * - : any
+ * - as any
+ * - <any>
+ * - any[]
+ *
+ * Excludes:
+ * - Type definition files (.d.ts)
+ * - Test files
+ * - Third-party type augmentations
+ * - Legitimate uses with // @ts-expect-error or eslint-disable
+ *
+ * Usage:
+ *   pnpm preflight:any-type
+ *   pnpm preflight:any-type --warning
+ *   pnpm preflight:any-type --strict  (also flags 'unknown' casts)
+ */
+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;
+const fs = __importStar(require("fs"));
+const glob_1 = require("glob");
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "code-hygiene/any-type-detection";
+exports.name = "Any Type Detection";
+exports.category = "code-hygiene";
+exports.blocking = true;
+exports.description = "TypeScript 'any' Type Detection Preflight (BLOCKING)";
+exports.tags = ["code-hygiene"];
+const CONFIG = {
+    includeDirs: ["app", "components", "lib", "hooks", "contexts"],
+    excludePatterns: [
+        "**/node_modules/**",
+        "**/.next/**",
+        "**/*.d.ts",
+        "**/*.test.ts",
+        "**/*.test.tsx",
+        "**/*.spec.ts",
+        "**/*.spec.tsx",
+        "**/__tests__/**",
+        "**/__mocks__/**",
+        "**/types/**", // Type definition folders often need any
+        "**/prisma/**", // Generated Prisma types
+    ],
+    // Files that legitimately need 'any' (third-party integrations, etc.)
+    allowedFiles: [
+        "lib/paypal", // PayPal SDK types are incomplete
+        "lib/stripe", // Stripe webhook types
+        "lib/analytics", // Analytics libraries
+        "middleware.ts", // Next.js middleware edge cases
+    ],
+};
+// Patterns to detect 'any' usage
+const ANY_PATTERNS = [
+    { regex: /:\s*any\b(?!\w)/g, type: "type-annotation" },
+    { regex: /as\s+any\b(?!\w)/g, type: "type-cast" },
+    { regex: /<any\s*>/g, type: "generic" },
+    { regex: /:\s*any\[\]/g, type: "array" },
+    { regex: /:\s*Array<any>/g, type: "array" },
+];
+// Lines with these patterns are allowed
+const ALLOWED_LINE_PATTERNS = [
+    /\/\/\s*@ts-expect-error/,
+    /\/\/\s*@ts-ignore/,
+    /\/\/\s*eslint-disable/,
+    /\/\*\s*eslint-disable/,
+    /\/\/\s*TODO:/i, // Temporary any with TODO
+    /\/\/\s*FIXME:/i,
+];
+async function detectAnyType() {
+    const violations = [];
+    const patterns = CONFIG.includeDirs.map((dir) => `${dir}/**/*.{ts,tsx}`);
+    const files = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: CONFIG.excludePatterns,
+            nodir: true,
+        });
+        files.push(...matches);
+    }
+    for (const file of files) {
+        const relativePath = file.replace(/\\/g, "/");
+        // Skip allowed files
+        if (CONFIG.allowedFiles.some((allowed) => relativePath.includes(allowed))) {
+            continue;
+        }
+        const content = fs.readFileSync(file, "utf-8");
+        const lines = content.split("\n");
+        lines.forEach((line, index) => {
+            // Skip if line has allowed pattern
+            if (ALLOWED_LINE_PATTERNS.some((p) => p.test(line))) {
+                return;
+            }
+            // Skip comments
+            const trimmed = line.trim();
+            if (trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*")) {
+                return;
+            }
+            // Check each pattern
+            for (const { regex, type } of ANY_PATTERNS) {
+                if (regex.test(line)) {
+                    violations.push({
+                        file: relativePath,
+                        line: index + 1,
+                        content: trimmed.substring(0, 70),
+                        pattern: type,
+                    });
+                    break; // Only report once per line
+                }
+            }
+        });
+    }
+    return violations;
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    const args = process.argv.slice(2);
+    const warningOnly = args.includes("--warning") || args.includes("--warn");
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    console.log("\n" + (0, console_chars_1.createDivider)(70, "double"));
+    console.log("  'ANY' TYPE DETECTION" + (warningOnly ? " (warning mode)" : " (BLOCKING)"));
+    console.log((0, console_chars_1.createDivider)(70, "double"));
+    const violations = await detectAnyType();
+    if (violations.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No 'any' type usage found in production code\n`);
+        process.exit(0);
+    }
+    // Group by pattern type
+    const byPattern = new Map();
+    for (const v of violations) {
+        if (!byPattern.has(v.pattern))
+            byPattern.set(v.pattern, []);
+        byPattern.get(v.pattern).push(v);
+    }
+    console.log(`\n${console_chars_1.emoji.error} Found ${violations.length} 'any' type usages:\n`);
+    for (const [pattern, items] of byPattern) {
+        const label = {
+            "type-annotation": ": any (type annotation)",
+            "type-cast": "as any (type cast)",
+            generic: "<any> (generic)",
+            array: "any[] (array)",
+        }[pattern] || pattern;
+        console.log(`\n${console_chars_1.emoji.memo} ${label} (${items.length}):`);
+        const toShow = verbose ? items : items.slice(0, 5);
+        for (const v of toShow) {
+            console.log(`   ${v.file}:${v.line}`);
+            console.log(`      ${v.content}`);
+        }
+        if (!verbose && items.length > 5) {
+            console.log(`   ... and ${items.length - 5} more`);
+        }
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(70, "light"));
+    console.log(`${console_chars_1.emoji.hint} To fix:`);
+    console.log("   1. Use specific types: : string, : number, : MyInterface");
+    console.log("   2. Use unknown for truly unknown: : unknown (then narrow)");
+    console.log("   3. Use generics: <T>(value: T) => T");
+    console.log("   4. Create proper interfaces for complex objects");
+    console.log("   5. If unavoidable: add // @ts-expect-error with explanation");
+    console.log((0, console_chars_1.createDivider)(70, "light") + "\n");
+    if (warningOnly) {
+        console.log(`${console_chars_1.emoji.warning}  Warning mode - not blocking\n`);
+        process.exit(0);
+    }
+    process.exit(1);
+}
+main().catch(console.error);
+//# sourceMappingURL=any-type-detection.js.map

package/dist/checks/code-hygiene/any-type-detection.js.map

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

package/dist/checks/code-hygiene/api-error-handling.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+/**
+ * API Error Handling Preflight (BLOCKING)
+ *
+ * Ensures all API routes have proper error handling with try-catch.
+ * Unhandled errors in API routes cause 500 errors and poor UX.
+ *
+ * Checks:
+ * - All route handlers (GET, POST, PUT, DELETE, PATCH) have try-catch
+ * - Catch blocks return proper error responses
+ * - No bare throw statements without context
+ * - Safe JSON parsing (request.json() wrapped in try-catch)
+ * - Centralized logging (logger.error vs console.error)
+ *
+ * Consolidated from:
+ * - code-hygiene/api-error-handling.ts (primary)
+ * - observability/api-error-handling-validation.ts (merged)
+ *
+ * Usage:
+ *   pnpm preflight:api-error-handling
+ *   pnpm preflight:api-error-handling --warning
+ */
+export declare const id = "code-hygiene/api-error-handling";
+export declare const name = "Api Error Handling";
+export declare const category = "code-hygiene";
+export declare const blocking = true;
+export declare const description = "API Error Handling Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=api-error-handling.d.ts.map

package/dist/checks/code-hygiene/api-error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error-handling.d.ts","sourceRoot":"","sources":["../../../src/checks/code-hygiene/api-error-handling.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,eAAO,MAAM,EAAE,oCAAoC,CAAC;AACpD,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,4CAA4C,CAAC;AACrE,eAAO,MAAM,IAAI,UAAmB,CAAC"}