@empline/preflight 1.0.20

package/dist/checks/drift-prevention/component-prop-consistency.js

@@ -0,0 +1,289 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Component Prop Consistency Drift Prevention
+ *
+ * Prevents drift in component prop patterns that could lead to:
+ * - Inconsistent prop naming conventions
+ * - Missing required props
+ * - Prop type inconsistencies
+ * - Breaking changes in component APIs
+ * - Inconsistent event handler naming
+ */
+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 path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "drift-prevention/component-prop-consistency";
+exports.name = "Component Prop Consistency";
+exports.category = "drift-prevention";
+exports.blocking = true;
+exports.description = "Component Prop Consistency Drift Prevention";
+exports.tags = ["drift-prevention"];
+const PROP_CONVENTIONS = {
+    // Event handler naming
+    eventHandlers: {
+        pattern: /on[A-Z]\w*/,
+        examples: ["onClick", "onChange", "onSubmit", "onClose"],
+    },
+    // Boolean prop naming
+    booleanProps: {
+        pattern: /^(is|has|can|should|will|was)[A-Z]\w*|^(disabled|loading|open|visible|active|selected)$/,
+        examples: ["isOpen", "hasError", "canEdit", "disabled", "loading"],
+    },
+    // Size/variant props
+    sizeVariants: {
+        pattern: /^(small|medium|large|sm|md|lg|xl)$/,
+        examples: ["small", "medium", "large", "sm", "md", "lg"],
+    },
+    // Color variants
+    colorVariants: {
+        pattern: /^(primary|secondary|success|error|warning|info|default)$/,
+        examples: ["primary", "secondary", "success", "error"],
+    },
+};
+const ANTI_PATTERNS = [
+    {
+        pattern: /interface\s+\w+Props[\s\S]*?\{[\s\S]*?\bany\b[\s\S]*?\}/g,
+        issue: 'Props interface uses "any" type - use specific types',
+        severity: "warning",
+    },
+    {
+        pattern: /\w+\?\s*:\s*\|\s*undefined/g,
+        issue: 'Redundant "| undefined" on optional prop',
+        severity: "info",
+    },
+    {
+        pattern: /onClick\s*:\s*\(\)\s*=>\s*void/g,
+        issue: "onClick should accept MouseEvent parameter",
+        severity: "warning",
+    },
+    {
+        pattern: /onChange\s*:\s*\([^)]*\)\s*=>\s*void/g,
+        issue: "onChange should follow consistent parameter pattern",
+        severity: "info",
+    },
+];
+const REQUIRED_PROP_PATTERNS = [
+    {
+        componentPattern: /Button/,
+        requiredProps: ["children", "onClick"],
+        optionalProps: ["variant", "size", "disabled", "loading"],
+    },
+    {
+        componentPattern: /Input|TextField/,
+        requiredProps: ["value", "onChange"],
+        optionalProps: ["placeholder", "disabled", "error", "helperText"],
+    },
+    {
+        componentPattern: /Modal|Dialog/,
+        requiredProps: ["open", "onClose"],
+        optionalProps: ["title", "maxWidth", "fullScreen"],
+    },
+];
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedAllTsTsxFiles = null;
+async function getAllTsTsxFiles() {
+    if (!_cachedAllTsTsxFiles) {
+        _cachedAllTsTsxFiles = await file_cache_1.fileCache.getAllTsTsx();
+    }
+    return _cachedAllTsTsxFiles;
+}
+async function analyzeComponentProps(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const issues = [];
+    // Extract component name from file
+    const componentName = path.basename(filePath, path.extname(filePath));
+    // Skip non-component files
+    if (!content.includes("interface") && !content.includes("type") && !content.includes("Props")) {
+        return issues;
+    }
+    // Find Props interfaces/types
+    const propsRegex = /(interface|type)\s+(\w*Props)\s*[=\{][\s\S]*?\}/g;
+    let match;
+    while ((match = propsRegex.exec(content)) !== null) {
+        const propsName = match[2];
+        const propsContent = match[0];
+        const startLine = content.substring(0, match.index).split("\n").length;
+        // Check for anti-patterns
+        for (const { pattern, issue, severity } of ANTI_PATTERNS) {
+            if (pattern.test(propsContent)) {
+                issues.push({
+                    file: filePath,
+                    line: startLine,
+                    issue,
+                    severity,
+                    component: componentName,
+                });
+            }
+        }
+        // Extract individual props
+        const propLines = propsContent.split("\n").slice(1, -1); // Remove interface declaration and closing brace
+        for (let i = 0; i < propLines.length; i++) {
+            const propLine = propLines[i].trim();
+            const lineNumber = startLine + i + 1;
+            if (!propLine || propLine.startsWith("//") || propLine.startsWith("*")) {
+                continue;
+            }
+            // Extract prop name
+            const propMatch = propLine.match(/(\w+)(\?)?:/);
+            if (!propMatch)
+                continue;
+            const propName = propMatch[1];
+            const isOptional = !!propMatch[2];
+            // Check event handler naming
+            if (propName.startsWith("on") && !PROP_CONVENTIONS.eventHandlers.pattern.test(propName)) {
+                issues.push({
+                    file: filePath,
+                    line: lineNumber,
+                    issue: `Event handler "${propName}" doesn't follow onCamelCase convention`,
+                    severity: "warning",
+                    component: componentName,
+                });
+            }
+            // Check boolean prop naming
+            if (propLine.includes(": boolean") && !PROP_CONVENTIONS.booleanProps.pattern.test(propName)) {
+                issues.push({
+                    file: filePath,
+                    line: lineNumber,
+                    issue: `Boolean prop "${propName}" should use is/has/can prefix or common boolean names`,
+                    severity: "info",
+                    component: componentName,
+                });
+            }
+            // Check for inconsistent prop types across similar components
+            if (propName === "size" && !propLine.includes("string") && !propLine.includes("Size")) {
+                const hasSizeVariants = PROP_CONVENTIONS.sizeVariants.examples.some((size) => propLine.includes(`"${size}"`));
+                if (!hasSizeVariants) {
+                    issues.push({
+                        file: filePath,
+                        line: lineNumber,
+                        issue: `Size prop should use standard variants: ${PROP_CONVENTIONS.sizeVariants.examples.join(", ")}`,
+                        severity: "info",
+                        component: componentName,
+                    });
+                }
+            }
+        }
+        // Check required props for known component patterns
+        for (const { componentPattern, requiredProps } of REQUIRED_PROP_PATTERNS) {
+            if (componentPattern.test(componentName)) {
+                for (const requiredProp of requiredProps) {
+                    if (!propsContent.includes(requiredProp)) {
+                        issues.push({
+                            file: filePath,
+                            line: startLine,
+                            issue: `${componentName} component missing required prop: ${requiredProp}`,
+                            severity: "warning",
+                            component: componentName,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return issues;
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    console.log(`${console_chars_1.emoji.search} Scanning for component prop consistency drift...`);
+    const files = await getAllTsTsxFiles();
+    const allIssues = [];
+    for (const file of files) {
+        const issues = await analyzeComponentProps(file);
+        allIssues.push(...issues);
+    }
+    // Group by severity
+    const errors = allIssues.filter((i) => i.severity === "error");
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    const infos = allIssues.filter((i) => i.severity === "info");
+    console.log(`\n${console_chars_1.emoji.chart} Component Prop Analysis:`);
+    console.log(`   ${console_chars_1.emoji.stop} Errors:   ${errors.length} (blocking)`);
+    console.log(`   ${console_chars_1.emoji.warning} Warnings: ${warnings.length}`);
+    console.log(`   ${console_chars_1.emoji.info}  Info:     ${infos.length}`);
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} BLOCKING ERRORS:`);
+        errors.slice(0, 10).forEach((issue) => {
+            console.log(`   ${issue.file}:${issue.line} - ${issue.issue}`);
+        });
+        if (errors.length > 10) {
+            console.log(`   ... and ${errors.length - 10} more errors`);
+        }
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  WARNINGS:`);
+        warnings.slice(0, 5).forEach((issue) => {
+            console.log(`   ${issue.file}:${issue.line} - ${issue.issue}`);
+        });
+        if (warnings.length > 5) {
+            console.log(`   ... and ${warnings.length - 5} more warnings`);
+        }
+    }
+    // Component analysis summary
+    const componentIssues = allIssues.reduce((acc, issue) => {
+        acc[issue.component] = (acc[issue.component] || 0) + 1;
+        return acc;
+    }, {});
+    const topComponents = Object.entries(componentIssues)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 5);
+    if (topComponents.length > 0) {
+        console.log(`\n${console_chars_1.emoji.graph} Components with most issues:`);
+        topComponents.forEach(([component, count]) => {
+            console.log(`   ${component}: ${count} issues`);
+        });
+    }
+    // Exit with error if blocking issues found
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.hint} Fix suggestions:`);
+        console.log('   - Use specific types instead of "any"');
+        console.log("   - Follow onCamelCase convention for event handlers");
+        console.log("   - Use is/has/can prefixes for boolean props");
+        console.log("   - Add required props for component patterns");
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} No blocking component prop issues found`);
+    process.exit(0);
+}
+if (require.main === module) {
+    main().catch(console.error);
+}
+//# sourceMappingURL=component-prop-consistency.js.map

package/dist/checks/drift-prevention/component-prop-consistency.js.map

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

package/dist/checks/drift-prevention/database-query-patterns.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env tsx
+/**
+ * Database Query Patterns Drift Prevention
+ *
+ * Prevents drift in database query patterns that could lead to:
+ * - N+1 query problems
+ * - Missing soft delete filters
+ * - Inconsistent error handling
+ * - Missing transaction boundaries
+ * - Performance regressions
+ * - Data integrity issues
+ */
+export declare const id = "drift-prevention/database-query-patterns";
+export declare const name = "Database Query Patterns";
+export declare const category = "drift-prevention";
+export declare const blocking = true;
+export declare const description = "Database Query Patterns Drift Prevention";
+export declare const tags: string[];
+//# sourceMappingURL=database-query-patterns.d.ts.map

package/dist/checks/drift-prevention/database-query-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-query-patterns.d.ts","sourceRoot":"","sources":["../../../src/checks/drift-prevention/database-query-patterns.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAUH,eAAO,MAAM,EAAE,6CAA6C,CAAC;AAC7D,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAC3C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,6CAA6C,CAAC;AACtE,eAAO,MAAM,IAAI,UAAkC,CAAC"}

package/dist/checks/drift-prevention/database-query-patterns.js

@@ -0,0 +1,340 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Database Query Patterns Drift Prevention
+ *
+ * Prevents drift in database query patterns that could lead to:
+ * - N+1 query problems
+ * - Missing soft delete filters
+ * - Inconsistent error handling
+ * - Missing transaction boundaries
+ * - Performance regressions
+ * - Data integrity issues
+ */
+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 = "drift-prevention/database-query-patterns";
+exports.name = "Database Query Patterns";
+exports.category = "drift-prevention";
+exports.blocking = true;
+exports.description = "Database Query Patterns Drift Prevention";
+exports.tags = ["drift-prevention", "database"];
+const RISKY_PATTERNS = [
+    // N+1 query patterns
+    {
+        pattern: /\.map\s*\(\s*async\s*\([^)]*\)\s*=>\s*[\s\S]*?\.find(First|Unique|Many)/g,
+        issue: "Potential N+1 query - use include/select or batch queries",
+        severity: "warning",
+        queryType: "N+1",
+    },
+    // Missing soft delete filters
+    {
+        pattern: /\.find(Many|First|Unique)\s*\(\s*\{[\s\S]*?\}\s*\)(?![\s\S]*?deletedAt)/g,
+        issue: "Query missing deletedAt filter for soft delete",
+        severity: "warning",
+        queryType: "soft-delete",
+    },
+    // Raw queries using Unsafe variant
+    {
+        pattern: /\$queryRawUnsafe/g,
+        issue: "Use of $queryRawUnsafe - SQL injection risk",
+        severity: "error",
+        queryType: "sql-injection",
+    },
+    // Missing transaction for multi-table operations
+    {
+        // Heuristic: flag multiple Prisma creates on the same code path.
+        // Avoid false positives across function boundaries and switch cases.
+        pattern: /prisma\.\w+\.create\s*\([^)]*\)(?:(?!(?:\bexport\b|\bfunction\b|\bcase\b|\bdefault\b|\bswitch\b))[\s\S]){0,4000}?prisma\.\w+\.create\s*\([^)]*\)(?![\s\S]{0,2000}?\$transaction)/g,
+        issue: "Multiple creates without transaction - data consistency risk",
+        severity: "error",
+        queryType: "transaction",
+    },
+    // Inefficient count queries
+    {
+        pattern: /\.findMany\s*\([^)]*\)[\s\S]*?\.length/g,
+        issue: "Using findMany().length instead of count() - performance issue",
+        severity: "warning",
+        queryType: "performance",
+    },
+    // Missing error handling
+    {
+        pattern: /prisma\.\w+\.(find|create|update|delete|upsert)[\s\S]*?\)(?![\s\S]*?(catch|try))/g,
+        issue: "Database operation without error handling",
+        severity: "warning",
+        queryType: "error-handling",
+    },
+    // Overly broad select
+    {
+        pattern: /\.findMany\s*\(\s*\{[\s\S]*?\}\s*\)(?![\s\S]*?(select|include))/g,
+        issue: "Query without select/include - may fetch unnecessary data",
+        severity: "info",
+        queryType: "performance",
+    },
+    // Dangerous delete operations
+    {
+        pattern: /\.deleteMany\s*\(\s*\{\s*\}\s*\)/g,
+        issue: "deleteMany with empty where clause - will delete all records",
+        severity: "error",
+        queryType: "data-safety",
+    },
+    // Non-singleton Prisma Client usage
+    {
+        pattern: /new\s+PrismaClient\(\)/g,
+        issue: "Instantiating new PrismaClient - use singleton from @/lib/prisma to prevent connection exhaustion",
+        severity: "error",
+        queryType: "connection-resource",
+    },
+    // Unbounded queries (Pagination)
+    {
+        pattern: /\.findMany\s*\(\s*\{(?![\s\S]*?(take:|cursor:))/g,
+        issue: "findMany query without limit (take/cursor) - performance risk on large datasets",
+        severity: "warning",
+        queryType: "scalability",
+    },
+];
+const GOOD_PATTERNS = [
+    // Proper transaction usage
+    /\$transaction\s*\(/,
+    // Proper error handling
+    /try\s*\{[\s\S]*?prisma[\s\S]*?\}\s*catch/,
+    /\.catch\s*\(/,
+    // Proper soft delete handling
+    /deletedAt\s*:\s*null/,
+    /deletedAt\s*:\s*\{\s*not\s*:\s*null\s*\}/,
+    // Efficient queries
+    /\.\s*(select|include)\s*:/,
+    /\.count\s*\(/,
+    // Parameterized queries
+    /\$queryRaw\s*\(/,
+    /Prisma\.sql`/,
+];
+const MODELS_WITH_SOFT_DELETE = [
+    "coreListings",
+    "authUser",
+    "authStores",
+    "userProductReviews",
+    "systemStoreReviews",
+];
+async function analyzeQueryPatterns(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const issues = [];
+    // Skip files that don't use Prisma
+    if (!content.includes("prisma.") &&
+        !content.includes("$queryRaw") &&
+        !content.includes("$executeRaw")) {
+        return issues;
+    }
+    for (const { pattern, issue, severity, queryType } of RISKY_PATTERNS) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            const lineNumber = content.substring(0, match.index).split("\n").length;
+            const lineContent = lines[lineNumber - 1]?.trim() || "";
+            // Skip if it's in a comment
+            if (lineContent.startsWith("//") || lineContent.startsWith("*")) {
+                continue;
+            }
+            // Check if it's a false positive by looking for good patterns in context
+            const contextStart = Math.max(0, match.index - 1000);
+            const contextEnd = Math.min(content.length, match.index + 1000);
+            const context = content.substring(contextStart, contextEnd);
+            // Skip if good patterns are present
+            if (queryType === "soft-delete") {
+                const hasGoodPattern = GOOD_PATTERNS.some((goodPattern) => goodPattern.test(context));
+                if (hasGoodPattern) {
+                    continue;
+                }
+                // Check if the model actually has soft delete
+                const modelMatch = match[0].match(/prisma\.(\w+)\./);
+                if (modelMatch && !MODELS_WITH_SOFT_DELETE.includes(modelMatch[1])) {
+                    continue;
+                }
+            }
+            if (queryType === "connection-resource" ||
+                queryType === "data-safety" ||
+                queryType === "transaction") {
+                const normalizedPath = filePath.replace(/\\/g, "/");
+                if (normalizedPath.includes("tests/") ||
+                    normalizedPath.includes("docs/") ||
+                    normalizedPath.includes("backups/") ||
+                    normalizedPath.includes("tmp/")) {
+                    continue;
+                }
+            }
+            // Special handling for lib/ files that use manual transactions or don't need them
+            const normalizedLibPath = filePath.replace(/\\/g, "/");
+            if (queryType === "transaction" &&
+                normalizedLibPath.includes("lib/") &&
+                (normalizedLibPath.includes("card-brands-service.ts") ||
+                    normalizedLibPath.includes("card-operations.ts"))) {
+                continue;
+            }
+            if (queryType === "connection-resource") {
+                const normalizedPath = filePath.replace(/\\/g, "/");
+                if (normalizedPath.includes("scripts/")) {
+                    continue;
+                }
+            }
+            // Scripts are administrative tools and may use raw queries or bulk operations without transactions
+            if (queryType === "transaction" || queryType === "sql-injection") {
+                const normalizedPath = filePath.replace(/\\/g, "/");
+                if (normalizedPath.includes("scripts/") || normalizedPath.includes("prisma/seed.ts")) {
+                    continue;
+                }
+            }
+            if (queryType === "error-handling") {
+                // Use larger context for error handling to catch large try-catch blocks
+                const largeStart = Math.max(0, match.index - 5000);
+                const largeEnd = Math.min(content.length, match.index + 5000);
+                const largeContext = content.substring(largeStart, largeEnd);
+                const hasErrorHandling = /try\s*\{[\s\S]*?\}\s*catch|\.catch\s*\(/.test(largeContext);
+                if (hasErrorHandling) {
+                    continue;
+                }
+            }
+            if (queryType === "transaction") {
+                const hasTransaction = /\$transaction/.test(context);
+                const hasBypass = /(\/\/|\/\*) \$transaction not needed/.test(context);
+                if (hasTransaction || hasBypass) {
+                    continue;
+                }
+            }
+            if (queryType === "sql-injection") {
+                const hasBypass = /(\/\/|\/\*) preflight-ignore: sql-injection/.test(context);
+                if (hasBypass) {
+                    continue;
+                }
+            }
+            // Skip performance warning for findMany().length if it includes take/cursor (bounded query)
+            if (queryType === "performance" && issue.includes("findMany().length")) {
+                if (match[0].includes("take:") || match[0].includes("cursor:")) {
+                    continue;
+                }
+            }
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                issue,
+                severity,
+                queryType,
+            });
+        }
+    }
+    return issues;
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    console.log(`${console_chars_1.emoji.search} Scanning for database query pattern drift...`);
+    const files = await (0, glob_1.glob)("**/*.{ts,tsx}", {
+        ignore: [
+            "node_modules/**",
+            ".next/**",
+            "dist/**",
+            "build/**",
+            "**/*.test.{ts,tsx}",
+            "**/*.spec.{ts,tsx}",
+            "__mocks__/**",
+            "prisma/migrations/**",
+        ],
+    });
+    const allIssues = [];
+    for (const file of files) {
+        const issues = await analyzeQueryPatterns(file);
+        allIssues.push(...issues);
+    }
+    // Group by severity and type
+    const errors = allIssues.filter((i) => i.severity === "error");
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    const infos = allIssues.filter((i) => i.severity === "info");
+    console.log(`\n${console_chars_1.emoji.chart} Database Query Pattern Analysis:`);
+    console.log(`   ${console_chars_1.emoji.stop} Errors:   ${errors.length} (blocking)`);
+    console.log(`   ${console_chars_1.emoji.warning} Warnings: ${warnings.length}`);
+    console.log(`   ${console_chars_1.emoji.info}  Info:     ${infos.length}`);
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} BLOCKING ERRORS:`);
+        errors.slice(0, 10).forEach((issue) => {
+            console.log(`   ${issue.file}:${issue.line} - ${issue.issue}`);
+            console.log(`      Type: ${issue.queryType}`);
+        });
+        if (errors.length > 10) {
+            console.log(`   ... and ${errors.length - 10} more errors`);
+        }
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  WARNINGS:`);
+        warnings.slice(0, 5).forEach((issue) => {
+            console.log(`   ${issue.file}:${issue.line} - ${issue.issue}`);
+            console.log(`      Type: ${issue.queryType}`);
+        });
+        if (warnings.length > 5) {
+            console.log(`   ... and ${warnings.length - 5} more warnings`);
+        }
+    }
+    // Query type analysis
+    const issuesByType = allIssues.reduce((acc, issue) => {
+        acc[issue.queryType] = (acc[issue.queryType] || 0) + 1;
+        return acc;
+    }, {});
+    console.log(`\n${console_chars_1.emoji.graph} Issues by query type:`);
+    Object.entries(issuesByType)
+        .sort(([, a], [, b]) => b - a)
+        .forEach(([type, count]) => {
+        console.log(`   ${type}: ${count} issues`);
+    });
+    // Exit with error if blocking issues found
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.hint} Fix suggestions:`);
+        console.log("   - Use parameterized queries instead of string interpolation");
+        console.log("   - Wrap multi-table operations in transactions");
+        console.log("   - Add deletedAt filters for soft delete models");
+        console.log("   - Use count() instead of findMany().length");
+        console.log("   - Add try-catch blocks around database operations");
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} No blocking database query issues found`);
+    process.exit(0);
+}
+if (require.main === module) {
+    main().catch(console.error);
+}
+//# sourceMappingURL=database-query-patterns.js.map