@empline/preflight 1.0.20

package/dist/checks/code-hygiene/log-level-misuse.js

@@ -0,0 +1,383 @@
+"use strict";
+/**
+ * Log Level Misuse Detection Preflight
+ *
+ * Detects logger calls using incorrect log levels:
+ * - logger.warn() for informational messages (should be logger.info or logger.debug)
+ * - logger.error() for non-error conditions
+ * - console.warn() for informational messages
+ *
+ * Best Practices:
+ * - ERROR: Actual errors that need attention (exceptions, failures, data corruption)
+ * - WARN: Potential problems that might need attention (deprecations, approaching limits, recoverable issues)
+ * - INFO: Normal operations worth noting (successful operations, state changes, business events)
+ * - DEBUG: Diagnostic information for troubleshooting (query parameters, data transformations, tracing)
+ *
+ * Usage:
+ *   pnpm preflight:log-level-misuse
+ *   pnpm preflight:log-level-misuse:warn
+ */
+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 = __importStar(require("glob"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "code-hygiene/log-level-misuse";
+exports.name = "Log Level Misuse";
+exports.category = "code-hygiene";
+exports.blocking = false;
+exports.description = "Log Level Misuse Detection Preflight";
+exports.tags = ["code-hygiene"];
+// Patterns that indicate INFO level (normal operations)
+const INFO_PATTERNS = [
+    /converting.*to.*enum/i,
+    /normalized.*→/i,
+    /normalized.*->/i,
+    /found existing/i,
+    /match found/i,
+    /created new/i,
+    /successfully/i,
+    /completed/i,
+    /processed/i,
+    /loaded/i,
+    /initialized/i,
+    /connected/i,
+    /started/i,
+    /finished/i,
+    /saved/i,
+    /updated/i,
+    /deleted/i,
+    /inserted/i,
+    /fetched/i,
+    /retrieved/i,
+    /returned/i,
+    /sending/i,
+    /received/i,
+    /${emoji.success}/, // Success emoji
+    /➕/, // Plus emoji (creating)
+];
+// Patterns that indicate DEBUG level (diagnostic tracing)
+const DEBUG_PATTERNS = [
+    /looking for/i,
+    /searching for/i,
+    /query parameters/i,
+    /database query/i,
+    /checking/i,
+    /validating/i,
+    /parsing/i,
+    /processing item/i,
+    /iterating/i,
+    /entering/i,
+    /exiting/i,
+    /calling/i,
+    /invoking/i,
+    /attempting/i,
+    /trying/i,
+    /${emoji.search}/, // Search emoji
+    /\[.*Helper\]/, // Helper class tracing
+    /\[.*Service\]/, // Service class tracing
+];
+// Patterns that indicate actual WARNING level (potential problems)
+const ACTUAL_WARNING_PATTERNS = [
+    /deprecated/i,
+    /approaching limit/i,
+    /rate limit/i,
+    /retry/i,
+    /timeout/i,
+    /slow/i,
+    /performance/i,
+    /memory/i,
+    /disk space/i,
+    /expir/i,
+    /invalid.*defaulting/i,
+    /fallback/i,
+    /missing.*using default/i,
+    /skipping/i,
+    /ignoring/i,
+    /unexpected/i,
+    /unusual/i,
+    /${emoji.warning}/, // Warning emoji
+];
+// Patterns that indicate actual ERROR level
+const ACTUAL_ERROR_PATTERNS = [
+    /failed/i,
+    /error/i,
+    /exception/i,
+    /crash/i,
+    /fatal/i,
+    /critical/i,
+    /corrupt/i,
+    /invalid/i,
+    /unauthorized/i,
+    /forbidden/i,
+    /not found.*cannot/i,
+    /${emoji.error}/, // Error emoji (when indicating failure, not just "not found")
+];
+// Files/patterns to skip (all RegExp)
+const SKIP_PATTERNS = [
+    /node_modules/,
+    /\.next/,
+    /dist/,
+    /build/,
+    /\.git/,
+    /scripts\/active\/preflights\//, // Don't check preflight scripts
+    /logger\.ts$/, // Don't check logger itself
+    /\.test\.(ts|tsx)$/, // Don't check unit tests
+    /\.spec\.(ts|tsx)$/, // Don't check e2e tests
+    /tests\//, // Don't check test directory
+];
+function shouldSkipFile(filePath) {
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    return SKIP_PATTERNS.some((pattern) => pattern.test(normalizedPath));
+}
+function detectMisusedLevel(line, lineNumber, filePath) {
+    // Check for logger.warn or console.warn
+    const warnMatch = line.match(/(logger\.warn|console\.warn)\s*\(\s*[`'"]/);
+    if (!warnMatch)
+        return null;
+    // Extract the message content
+    const messageMatch = line.match(/(?:logger\.warn|console\.warn)\s*\(\s*[`'"]([^`'"]*)/);
+    const message = messageMatch ? messageMatch[1] : line;
+    // Check if it's actually a warning (potential problem)
+    const isActualWarning = ACTUAL_WARNING_PATTERNS.some((p) => p.test(message));
+    if (isActualWarning)
+        return null;
+    // Check if it should be DEBUG (diagnostic tracing)
+    const shouldBeDebug = DEBUG_PATTERNS.some((p) => p.test(message));
+    if (shouldBeDebug) {
+        return {
+            file: filePath,
+            line: lineNumber,
+            level: "warning",
+            message: `logger.warn used for diagnostic tracing - should be logger.debug`,
+            code: line.trim().substring(0, 100),
+            suggestedLevel: "debug",
+        };
+    }
+    // Check if it should be INFO (normal operation)
+    const shouldBeInfo = INFO_PATTERNS.some((p) => p.test(message));
+    if (shouldBeInfo) {
+        return {
+            file: filePath,
+            line: lineNumber,
+            level: "warning",
+            message: `logger.warn used for informational message - should be logger.info`,
+            code: line.trim().substring(0, 100),
+            suggestedLevel: "info",
+        };
+    }
+    // Check for "not found" patterns - these are usually INFO (expected outcome)
+    if (/not found|no match|no.*found/i.test(message) && !/cannot|error|fail/i.test(message)) {
+        return {
+            file: filePath,
+            line: lineNumber,
+            level: "info",
+            message: `logger.warn used for "not found" result - consider logger.info (expected outcome)`,
+            code: line.trim().substring(0, 100),
+            suggestedLevel: "info",
+        };
+    }
+    return null;
+}
+// Valid logger methods
+const VALID_LOGGER_METHODS = ["error", "warn", "info", "debug"];
+function detectInvalidLoggerMethod(line, lineNumber, filePath) {
+    // Check for logger.* calls
+    const loggerMatch = line.match(/logger\.(\w+)\s*\(/);
+    if (!loggerMatch)
+        return null;
+    const method = loggerMatch[1];
+    // Check if it's a valid method
+    if (!VALID_LOGGER_METHODS.includes(method)) {
+        return {
+            file: filePath,
+            line: lineNumber,
+            level: "error",
+            message: `logger.${method}() does not exist - use logger.error/warn/info/debug`,
+            code: line.trim().substring(0, 100),
+            suggestedLevel: method === "success" ? "info" : "info",
+        };
+    }
+    return null;
+}
+function detectErrorMisuse(line, lineNumber, filePath) {
+    // Check for logger.error or console.error
+    const errorMatch = line.match(/(logger\.error|console\.error)\s*\(\s*[`'"]/);
+    if (!errorMatch)
+        return null;
+    // Extract the message content
+    const messageMatch = line.match(/(?:logger\.error|console\.error)\s*\(\s*[`'"]([^`'"]*)/);
+    const message = messageMatch ? messageMatch[1] : line;
+    // Check if it's actually an error
+    const isActualError = ACTUAL_ERROR_PATTERNS.some((p) => p.test(message));
+    if (isActualError)
+        return null;
+    // Check if it should be INFO
+    const shouldBeInfo = INFO_PATTERNS.some((p) => p.test(message));
+    if (shouldBeInfo) {
+        return {
+            file: filePath,
+            line: lineNumber,
+            level: "warning",
+            message: `logger.error used for informational message - should be logger.info`,
+            code: line.trim().substring(0, 100),
+            suggestedLevel: "info",
+        };
+    }
+    // Check if it should be WARNING
+    const shouldBeWarning = ACTUAL_WARNING_PATTERNS.some((p) => p.test(message));
+    if (shouldBeWarning) {
+        return {
+            file: filePath,
+            line: lineNumber,
+            level: "info",
+            message: `logger.error used for warning condition - consider logger.warn`,
+            code: line.trim().substring(0, 100),
+            suggestedLevel: "warn",
+        };
+    }
+    return null;
+}
+function analyzeFile(filePath) {
+    const issues = [];
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const lines = content.split("\n");
+        lines.forEach((line, index) => {
+            const lineNumber = index + 1;
+            // Skip comments
+            if (line.trim().startsWith("//") || line.trim().startsWith("*")) {
+                return;
+            }
+            // Check for warn misuse
+            const warnIssue = detectMisusedLevel(line, lineNumber, filePath);
+            if (warnIssue) {
+                issues.push(warnIssue);
+            }
+            // Check for invalid logger methods (e.g., logger.success)
+            const invalidMethodIssue = detectInvalidLoggerMethod(line, lineNumber, filePath);
+            if (invalidMethodIssue) {
+                issues.push(invalidMethodIssue);
+            }
+            // Check for error misuse
+            const errorIssue = detectErrorMisuse(line, lineNumber, filePath);
+            if (errorIssue) {
+                issues.push(errorIssue);
+            }
+        });
+    }
+    catch (error) {
+        console.error(`Error reading file ${filePath}:`, error);
+    }
+    return issues;
+}
+function main() {
+    const args = process.argv.slice(2);
+    const isWarnMode = args.includes("--warn");
+    const isVerbose = args.includes("--verbose");
+    console.log(`${console_chars_1.emoji.search} Log Level Misuse Detection\n`);
+    console.log("Checking for incorrect log level usage...\n");
+    // Find all TypeScript files
+    const files = glob.sync("**/*.{ts,tsx}", {
+        ignore: ["node_modules/**", ".next/**", "dist/**", "build/**", "coverage/**"],
+    });
+    const allIssues = [];
+    files.forEach((file) => {
+        if (shouldSkipFile(file))
+            return;
+        const issues = analyzeFile(file);
+        allIssues.push(...issues);
+    });
+    // Group by file
+    const issuesByFile = new Map();
+    allIssues.forEach((issue) => {
+        const existing = issuesByFile.get(issue.file) || [];
+        existing.push(issue);
+        issuesByFile.set(issue.file, existing);
+    });
+    // Count by severity
+    const errorCount = allIssues.filter((i) => i.level === "error").length;
+    const warningCount = allIssues.filter((i) => i.level === "warning").length;
+    const infoCount = allIssues.filter((i) => i.level === "info").length;
+    // Print results
+    if (allIssues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No log level misuse detected!\n`);
+        process.exit(0);
+    }
+    console.log(`Found ${allIssues.length} potential log level issues:\n`);
+    // Print by file
+    issuesByFile.forEach((issues, file) => {
+        console.log(`${console_chars_1.emoji.file} ${file}`);
+        issues.forEach((issue) => {
+            const icon = issue.level === "error"
+                ? `${console_chars_1.emoji.error}`
+                : issue.level === "warning"
+                    ? `${console_chars_1.emoji.warning}`
+                    : `${console_chars_1.emoji.info}`;
+            console.log(`   ${icon} Line ${issue.line}: ${issue.message}`);
+            if (isVerbose) {
+                console.log(`      Code: ${issue.code}`);
+                console.log(`      Suggested: logger.${issue.suggestedLevel}()`);
+            }
+        });
+        console.log();
+    });
+    // Summary
+    console.log((0, console_chars_1.createDivider)(60, "light"));
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Errors: ${errorCount}`);
+    console.log(`   Warnings: ${warningCount}`);
+    console.log(`   Info: ${infoCount}`);
+    console.log(`   Total: ${allIssues.length}`);
+    // Best practices reminder
+    console.log(`\n${console_chars_1.emoji.docs} Log Level Best Practices:`);
+    console.log("   ERROR  - Actual errors needing attention (exceptions, failures)");
+    console.log("   WARN   - Potential problems (deprecations, approaching limits, fallbacks)");
+    console.log("   INFO   - Normal operations (successful ops, state changes, business events)");
+    console.log("   DEBUG  - Diagnostic tracing (query params, data transforms, method entry/exit)");
+    console.log(`\n${console_chars_1.emoji.hint} To fix:`);
+    console.log("   pnpm fix:log-levels          # Preview changes");
+    console.log("   pnpm fix:log-levels:apply    # Apply changes");
+    // Exit code - warnings are non-blocking since they're style recommendations
+    if (isWarnMode || warningCount > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} ${warningCount} log level recommendations. Consider fixing before committing.`);
+        process.exit(0); // Non-blocking - just recommendations
+    }
+    process.exit(0);
+}
+main();
+//# sourceMappingURL=log-level-misuse.js.map

package/dist/checks/code-hygiene/log-level-misuse.js.map

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

package/dist/checks/code-hygiene/missing-logger-import.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Missing Logger Import Detection Preflight
+ *
+ * Detects files that use logger.* but don't import the logger.
+ * This prevents runtime "logger is not defined" errors.
+ *
+ * Usage:
+ *   pnpm preflight:missing-logger-import
+ */
+export declare const id = "code-hygiene/missing-logger-import";
+export declare const name = "Missing Logger Import";
+export declare const category = "code-hygiene";
+export declare const blocking = false;
+export declare const description = "Missing Logger Import Detection Preflight";
+export declare const tags: string[];
+//# sourceMappingURL=missing-logger-import.d.ts.map

package/dist/checks/code-hygiene/missing-logger-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-logger-import.d.ts","sourceRoot":"","sources":["../../../src/checks/code-hygiene/missing-logger-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,eAAO,MAAM,EAAE,uCAAuC,CAAC;AACvD,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAC5C,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,8CAA8C,CAAC;AACvE,eAAO,MAAM,IAAI,UAAmB,CAAC"}

package/dist/checks/code-hygiene/missing-logger-import.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Missing Logger Import Detection Preflight
+ *
+ * Detects files that use logger.* but don't import the logger.
+ * This prevents runtime "logger is not defined" errors.
+ *
+ * Usage:
+ *   pnpm preflight:missing-logger-import
+ */
+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 = __importStar(require("glob"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "code-hygiene/missing-logger-import";
+exports.name = "Missing Logger Import";
+exports.category = "code-hygiene";
+exports.blocking = false;
+exports.description = "Missing Logger Import Detection Preflight";
+exports.tags = ["code-hygiene"];
+// Files/patterns to skip (all RegExp)
+const SKIP_PATTERNS = [
+    /node_modules/,
+    /\.next/,
+    /dist/,
+    /build/,
+    /\.git/,
+    /scripts\/active\/preflights/, // Don't check preflight scripts themselves
+    /logger\.ts$/, // Don't check logger itself
+    /\.test\.(ts|tsx)$/, // Don't check unit tests
+    /\.spec\.(ts|tsx)$/, // Don't check e2e tests
+    /tests\//, // Don't check test directory
+];
+function stripCommentsAndStrings(content) {
+    return content
+        .replace(/\/\/.*$/gm, "")
+        .replace(/\/\*[\s\S]*?\*\//g, "")
+        .replace(/`[^`]*`/g, '""')
+        .replace(/'(?:\\.|[^'\\])*'/g, "''")
+        .replace(/\"(?:\\.|[^\"\\])*\"/g, '""');
+}
+function shouldSkipFile(filePath) {
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    return SKIP_PATTERNS.some((pattern) => pattern.test(normalizedPath));
+}
+function analyzeFile(filePath) {
+    const issues = [];
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const cleanContent = stripCommentsAndStrings(content);
+        const lines = content.split("\n");
+        // Check if file uses logger
+        const usesLogger = /\blogger\.(debug|info|warn|error)\s*\(/.test(cleanContent);
+        if (!usesLogger)
+            return [];
+        // If the file defines its own logger (e.g., const logger = createRouteLogger(...)),
+        // it's not missing an import.
+        const hasLocalLoggerDeclaration = /\b(const|let|var)\s+logger\b/.test(cleanContent) ||
+            /\bfunction\s+logger\b/.test(cleanContent);
+        if (hasLocalLoggerDeclaration)
+            return [];
+        // Check if file imports logger
+        const hasLoggerImport = /import\s+.*\blogger\b.*from/.test(cleanContent) ||
+            /import\s*{\s*logger\s*}/.test(cleanContent) ||
+            /const\s+{\s*logger\s*}\s*=\s*require/.test(cleanContent);
+        if (!hasLoggerImport) {
+            // Find the first usage of logger
+            for (let i = 0; i < lines.length; i++) {
+                const rawLine = lines[i] ?? "";
+                const line = stripCommentsAndStrings(rawLine);
+                if (/\blogger\.(debug|info|warn|error)\s*\(/.test(line)) {
+                    issues.push({
+                        file: filePath,
+                        line: i + 1,
+                        code: rawLine.trim().substring(0, 80),
+                    });
+                    break; // Only report first usage
+                }
+            }
+        }
+    }
+    catch (error) {
+        console.error(`Error reading file ${filePath}:`, error);
+    }
+    return issues;
+}
+function main() {
+    console.log(`${console_chars_1.emoji.search} Missing Logger Import Detection\n`);
+    console.log("Checking for files using logger without importing it...\n");
+    // Find all TypeScript files
+    const files = glob.sync("**/*.{ts,tsx}", {
+        ignore: ["node_modules/**", ".next/**", "dist/**", "build/**", "coverage/**"],
+    });
+    const allIssues = [];
+    files.forEach((file) => {
+        if (shouldSkipFile(file))
+            return;
+        const issues = analyzeFile(file);
+        allIssues.push(...issues);
+    });
+    // Print results
+    if (allIssues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} All files using logger have proper imports!\n`);
+        process.exit(0);
+    }
+    console.log(`Found ${allIssues.length} files using logger without importing it:\n`);
+    allIssues.forEach((issue) => {
+        console.log(`${console_chars_1.emoji.error} ${issue.file}:${issue.line}`);
+        console.log(`   ${issue.code}`);
+        console.log(`   Fix: Add "import { logger } from '@/lib/logger';" at the top\n`);
+    });
+    console.log((0, console_chars_1.createDivider)(60, "light"));
+    console.log(`\n${console_chars_1.emoji.error} ${allIssues.length} files need logger import added.`);
+    console.log("\nTo fix, add this import to each file:");
+    console.log('   import { logger } from "@/lib/logger";');
+    process.exit(1);
+}
+main();
+//# sourceMappingURL=missing-logger-import.js.map

package/dist/checks/code-hygiene/missing-logger-import.js.map

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

package/dist/checks/code-hygiene/root-file-hygiene.d.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env tsx
+/**
+ * Root File Hygiene Preflight (BLOCKING)
+ *
+ * Catches orphaned temporary/fix scripts in the project root that should be:
+ * 1. Deleted after use (one-time fix scripts)
+ * 2. Moved to scripts/active/ or scripts/archived/ if reusable
+ * 3. Added to .gitignore if local-only
+ *
+ * Patterns detected:
+ * - fix-*.ts/js - One-time fix scripts
+ * - cleanup*.ts/js - Cleanup scripts
+ * - debug-*.ts/js - Debug scripts
+ * - check-*.ts/js - Check scripts (should be preflights)
+ * - test-*.ts/js - Test scripts (not in tests/)
+ * - *_types.js - Type fix scripts
+ *
+ * BLOCKING: Fails build if violations found (unless allowlisted).
+ *
+ * Usage:
+ *   pnpm preflight:root-hygiene              - BLOCKING mode
+ *   pnpm preflight:root-hygiene --warning    - Warning mode
+ *   pnpm preflight:root-hygiene --verbose    - Show details
+ */
+export declare const id = "code-hygiene/root-file-hygiene";
+export declare const name = "Root File Hygiene";
+export declare const category = "code-hygiene";
+export declare const blocking = true;
+export declare const description = "Root File Hygiene Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=root-file-hygiene.d.ts.map

package/dist/checks/code-hygiene/root-file-hygiene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-file-hygiene.d.ts","sourceRoot":"","sources":["../../../src/checks/code-hygiene/root-file-hygiene.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH,eAAO,MAAM,EAAE,mCAAmC,CAAC;AACnD,eAAO,MAAM,IAAI,sBAAsB,CAAC;AACxC,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,2CAA2C,CAAC;AACpE,eAAO,MAAM,IAAI,UAAmB,CAAC"}