@empline/preflight 1.0.20

package/dist/checks/database/unused-schema-detection.js

@@ -0,0 +1,624 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Unused Schema Detection Preflight (WARNING)
+ *
+ * Detects Prisma schema tables (models) and columns (fields) that are not
+ * referenced anywhere in the codebase. Helps identify dead schema that can
+ * be safely removed to reduce database complexity and migration overhead.
+ *
+ * Checks for:
+ * - Models defined in schema.prisma but never used in code
+ * - Fields defined on models but never accessed in code
+ * - Relation fields that are defined but never included/selected
+ *
+ * Usage:
+ *   pnpm preflight:unused-schema
+ *   pnpm preflight:unused-schema --verbose
+ *   pnpm preflight:unused-schema --strict (exit 1 on any unused)
+ *
+ * Note: This is a WARNING-level preflight by default since unused schema
+ * may be intentional (future features, external integrations, etc.)
+ */
+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");
+// Check metadata
+exports.id = "database/unused-schema-detection";
+exports.name = "Unused Schema Detection";
+exports.category = "database";
+exports.blocking = true;
+exports.description = "Unused Schema Detection Preflight (WARNING)";
+exports.tags = ["database"];
+// Directories to scan for Prisma usage
+const SCAN_DIRS = ["app", "lib", "components", "hooks", "contexts", "scripts"];
+// File extensions to check
+const EXTENSIONS = [".ts", ".tsx", ".js", ".jsx"];
+// Models to ignore (system tables, Prisma internals, etc.)
+const IGNORED_MODELS = new Set(["_prisma_migrations", "PrismaMigrations"]);
+// Models with documented future plans (allowlisted)
+// These are intentionally unused but have specs/docs for implementation
+const ALLOWLISTED_MODELS = new Set([
+    // Platform integrations (eBay, Amazon, etc.) - planned feature
+    "jobsIntegrationSync",
+    "jobsPlatformListings",
+    "jobsPlatformOrders",
+    // Review system - planned feature
+    "userReviewHelpfulVotes",
+    "UserReviewImages",
+    "userReviewResponses",
+    // Image voting for catalog quality - documented in database-guide.md
+    "productImagePairVotes",
+    // Models accessed via raw SQL (not Prisma client) - still in use
+    "SystemSearchCache", // lib/search-cache.ts uses raw SQL
+]);
+// Fields to ignore (common auto-generated fields)
+const IGNORED_FIELDS = new Set(["id", "createdAt", "updatedAt"]);
+// Fields that exist on multiple models - require stricter matching
+// Map of fieldName -> Set of models that have this field
+const AMBIGUOUS_FIELDS = new Map();
+/**
+ * Build a map of fields that exist on multiple models
+ * These need stricter context checking to avoid false positives
+ */
+function buildAmbiguousFieldsMap(models) {
+    const fieldToModels = new Map();
+    for (const model of models) {
+        for (const field of model.fields) {
+            if (IGNORED_FIELDS.has(field.name))
+                continue;
+            if (!fieldToModels.has(field.name)) {
+                fieldToModels.set(field.name, []);
+            }
+            fieldToModels.get(field.name).push(model.name);
+        }
+    }
+    // Only track fields that exist on 2+ models
+    for (const [fieldName, modelNames] of fieldToModels) {
+        if (modelNames.length > 1) {
+            AMBIGUOUS_FIELDS.set(fieldName, new Set(modelNames));
+        }
+    }
+}
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+// SCHEMA PARSING
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+function parseSchema(schemaPath) {
+    const content = fs.readFileSync(schemaPath, "utf-8");
+    const lines = content.split("\n");
+    const models = [];
+    let currentModel = null;
+    let braceDepth = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        const lineNumber = i + 1;
+        // Start of model
+        const modelMatch = trimmed.match(/^model\s+(\w+)\s*\{/);
+        if (modelMatch) {
+            currentModel = {
+                name: modelMatch[1],
+                tableName: modelMatch[1], // Will be updated if @@map found
+                fields: [],
+                lineNumber,
+            };
+            braceDepth = 1;
+            continue;
+        }
+        // Inside a model
+        if (currentModel) {
+            // Track brace depth
+            braceDepth += (line.match(/\{/g) || []).length;
+            braceDepth -= (line.match(/\}/g) || []).length;
+            // End of model
+            if (braceDepth === 0) {
+                if (!IGNORED_MODELS.has(currentModel.name)) {
+                    models.push(currentModel);
+                }
+                currentModel = null;
+                continue;
+            }
+            // @@map directive for table name
+            const mapMatch = trimmed.match(/@@map\s*\(\s*["']([^"']+)["']\s*\)/);
+            if (mapMatch) {
+                currentModel.tableName = mapMatch[1];
+                continue;
+            }
+            // Skip comments, indexes, and other directives
+            if (trimmed.startsWith("//") ||
+                trimmed.startsWith("@@") ||
+                trimmed === "" ||
+                trimmed === "{" ||
+                trimmed === "}") {
+                continue;
+            }
+            // Parse field
+            const fieldMatch = trimmed.match(/^(\w+)\s+(\w+)(\[\])?\??/);
+            if (fieldMatch) {
+                const fieldName = fieldMatch[1];
+                const fieldType = fieldMatch[2];
+                const isArray = !!fieldMatch[3];
+                // Check for @map directive
+                const fieldMapMatch = trimmed.match(/@map\s*\(\s*["']([^"']+)["']\s*\)/);
+                const columnName = fieldMapMatch ? fieldMapMatch[1] : fieldName;
+                // Determine if it's a relation (type is another model or has @relation)
+                const isRelation = trimmed.includes("@relation") ||
+                    (/^[A-Z]/.test(fieldType) &&
+                        ![
+                            "String",
+                            "Int",
+                            "Float",
+                            "Boolean",
+                            "DateTime",
+                            "Json",
+                            "Decimal",
+                            "BigInt",
+                            "Bytes",
+                        ].includes(fieldType));
+                currentModel.fields.push({
+                    name: fieldName,
+                    columnName,
+                    type: fieldType + (isArray ? "[]" : ""),
+                    isRelation,
+                    lineNumber,
+                });
+            }
+        }
+    }
+    return models;
+}
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+// CODEBASE SCANNING
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+async function getFilesToScan() {
+    const files = [];
+    for (const dir of SCAN_DIRS) {
+        const dirPath = path.join(process.cwd(), dir);
+        if (!fs.existsSync(dirPath))
+            continue;
+        const patterns = EXTENSIONS.map((ext) => `${dir}/**/*${ext}`);
+        for (const pattern of patterns) {
+            const matches = await (0, glob_1.glob)(pattern, {
+                ignore: [
+                    "**/node_modules/**",
+                    "**/*.test.*",
+                    "**/*.spec.*",
+                    "**/dist/**",
+                    "**/__mocks__/**",
+                ],
+            });
+            files.push(...matches);
+        }
+    }
+    return [...new Set(files)];
+}
+/**
+ * Detect if we're inside a Prisma write context (create, update, upsert, etc.)
+ * by looking at surrounding code patterns
+ */
+function isWriteContext(content, matchIndex) {
+    // Look backwards up to 200 chars for write operation keywords
+    const lookbackStart = Math.max(0, matchIndex - 200);
+    const lookback = content.slice(lookbackStart, matchIndex);
+    // Prisma write operations
+    const writePatterns = [
+        /\.create\s*\(\s*\{[^}]*data\s*:\s*\{[^}]*$/,
+        /\.createMany\s*\(\s*\{[^}]*data\s*:/,
+        /\.update\s*\(\s*\{[^}]*data\s*:\s*\{[^}]*$/,
+        /\.updateMany\s*\(\s*\{[^}]*data\s*:/,
+        /\.upsert\s*\(\s*\{[^}]*(create|update)\s*:\s*\{[^}]*$/,
+        /data\s*:\s*\{[^}]*$/, // Generic data object (common in Prisma)
+    ];
+    for (const pattern of writePatterns) {
+        if (pattern.test(lookback)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Detect if we're inside a Prisma read context (select, include, property access)
+ */
+function isReadContext(content, matchIndex, fieldName) {
+    // Look backwards up to 150 chars
+    const lookbackStart = Math.max(0, matchIndex - 150);
+    const lookback = content.slice(lookbackStart, matchIndex);
+    // Look forward up to 50 chars for property access patterns
+    const lookahead = content.slice(matchIndex, matchIndex + fieldName.length + 50);
+    // Read patterns
+    const readPatterns = [
+        /\.select\s*\(\s*\{[^}]*$/,
+        /select\s*:\s*\{[^}]*$/,
+        /\.include\s*\(\s*\{[^}]*$/,
+        /include\s*:\s*\{[^}]*$/,
+        /orderBy\s*:\s*\{[^}]*$/,
+        /where\s*:\s*\{[^}]*$/,
+    ];
+    for (const pattern of readPatterns) {
+        if (pattern.test(lookback)) {
+            return true;
+        }
+    }
+    // Property access: .fieldName or ?.fieldName (reading from result)
+    if (new RegExp(`\\.${fieldName}\\b`).test(lookahead) ||
+        new RegExp(`\\?\\.${fieldName}\\b`).test(lookahead)) {
+        // Check if this is actually a property access, not an assignment
+        const afterField = content.slice(matchIndex + fieldName.length, matchIndex + fieldName.length + 10);
+        if (!/^\s*[=:]/.test(afterField)) {
+            return true;
+        }
+    }
+    // Destructuring: { fieldName } or { fieldName: alias }
+    if (/\{\s*[^}]*$/.test(lookback) && !/data\s*:\s*\{[^}]*$/.test(lookback)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if a field usage is in the context of a specific model
+ * This helps disambiguate fields that exist on multiple models
+ */
+function isFieldInModelContext(content, matchIndex, modelName, camelCaseName) {
+    // Look backwards up to 500 chars for model context
+    const lookbackStart = Math.max(0, matchIndex - 500);
+    const lookback = content.slice(lookbackStart, matchIndex);
+    // Patterns that indicate we're working with this specific model:
+    // 1. prisma.modelName.create/update/findMany etc
+    // 2. Prisma.ModelNameCreateInput type
+    // 3. Variable typed as ModelName
+    // 4. Function parameter typed as ModelName
+    const modelPatterns = [
+        new RegExp(`prisma\\.${camelCaseName}\\.(create|update|upsert|findMany|findFirst|findUnique|delete|deleteMany|updateMany|createMany)\\s*\\(`),
+        new RegExp(`Prisma\\.${modelName}(CreateInput|UpdateInput|WhereInput|Select|Include)`),
+        new RegExp(`:\\s*${modelName}\\b`),
+        new RegExp(`as\\s+${modelName}\\b`),
+        new RegExp(`<${modelName}>`),
+    ];
+    for (const pattern of modelPatterns) {
+        if (pattern.test(lookback)) {
+            return true;
+        }
+    }
+    // Also check if there's a DIFFERENT model's Prisma call closer to the field
+    // If so, this field likely belongs to that other model
+    const otherModelMatch = lookback.match(/prisma\.(\w+)\.(create|update|upsert|findMany|findFirst|findUnique|delete|deleteMany|updateMany|createMany)\s*\([^)]*$/);
+    if (otherModelMatch) {
+        const foundModel = otherModelMatch[1];
+        // If the closest Prisma call is for a different model, this field is probably not for our model
+        if (foundModel !== camelCaseName) {
+            return false;
+        }
+    }
+    // Default: if we can't determine context, assume it might be for this model
+    // (conservative approach - may still have false positives)
+    return true;
+}
+function scanFileForUsage(filePath, content, models, stats) {
+    // Skip if no Prisma-related content
+    if (!content.includes("prisma") && !content.includes("Prisma")) {
+        return;
+    }
+    const relativePath = path.relative(process.cwd(), filePath);
+    for (const model of models) {
+        // Check for model usage patterns:
+        // 1. prisma.modelName (camelCase)
+        // 2. Prisma.ModelNameCreateInput etc (PascalCase types)
+        // 3. Direct model name references in types
+        const camelCaseName = model.name.charAt(0).toLowerCase() + model.name.slice(1);
+        const patterns = [
+            new RegExp(`prisma\\.${camelCaseName}\\b`, "g"),
+            new RegExp(`Prisma\\.${model.name}\\w*`, "g"),
+            new RegExp(`\\b${model.name}\\b`, "g"),
+        ];
+        let modelUsed = false;
+        for (const pattern of patterns) {
+            if (pattern.test(content)) {
+                modelUsed = true;
+                break;
+            }
+        }
+        if (modelUsed) {
+            if (!stats.modelUsages.has(model.name)) {
+                stats.modelUsages.set(model.name, new Set());
+            }
+            stats.modelUsages.get(model.name).add(relativePath);
+            // Now check for field usage within this file
+            for (const field of model.fields) {
+                if (IGNORED_FIELDS.has(field.name))
+                    continue;
+                // Initialize field usage tracking
+                if (!stats.fieldUsages.has(model.name)) {
+                    stats.fieldUsages.set(model.name, new Map());
+                }
+                const modelFields = stats.fieldUsages.get(model.name);
+                if (!modelFields.has(field.name)) {
+                    modelFields.set(field.name, { reads: new Set(), writes: new Set() });
+                }
+                const fieldUsage = modelFields.get(field.name);
+                // For ambiguous fields (exist on multiple models), require model context
+                const isAmbiguous = AMBIGUOUS_FIELDS.has(field.name);
+                // Find all occurrences of the field name
+                const fieldPattern = new RegExp(`\\b${field.name}\\b`, "g");
+                let match;
+                while ((match = fieldPattern.exec(content)) !== null) {
+                    const matchIndex = match.index;
+                    // For ambiguous fields, verify this usage is in context of THIS model
+                    if (isAmbiguous) {
+                        if (!isFieldInModelContext(content, matchIndex, model.name, camelCaseName)) {
+                            continue; // Skip - this field usage is likely for a different model
+                        }
+                    }
+                    // Determine if this is a read or write context
+                    if (isWriteContext(content, matchIndex)) {
+                        fieldUsage.writes.add(relativePath);
+                    }
+                    else if (isReadContext(content, matchIndex, field.name)) {
+                        fieldUsage.reads.add(relativePath);
+                    }
+                    else {
+                        // Ambiguous - could be either, check for common patterns
+                        const surroundingStart = Math.max(0, matchIndex - 30);
+                        const surroundingEnd = Math.min(content.length, matchIndex + field.name.length + 30);
+                        const surrounding = content.slice(surroundingStart, surroundingEnd);
+                        // Property access on a variable (likely read)
+                        if (new RegExp(`\\w+\\.${field.name}\\b`).test(surrounding) ||
+                            new RegExp(`\\w+\\?\\.${field.name}\\b`).test(surrounding)) {
+                            fieldUsage.reads.add(relativePath);
+                        }
+                        // Object key with colon (could be write in data object)
+                        else if (new RegExp(`${field.name}\\s*:`).test(surrounding)) {
+                            // Check if it's in a data/create/update context
+                            if (isWriteContext(content, matchIndex)) {
+                                fieldUsage.writes.add(relativePath);
+                            }
+                            else {
+                                // Default to read for select/include patterns
+                                fieldUsage.reads.add(relativePath);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+// ANALYSIS
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+function findUnusedItems(models, stats) {
+    const unused = [];
+    for (const model of models) {
+        // Skip allowlisted models (planned features with documentation)
+        if (ALLOWLISTED_MODELS.has(model.name)) {
+            continue;
+        }
+        const modelUsage = stats.modelUsages.get(model.name);
+        if (!modelUsage || modelUsage.size === 0) {
+            unused.push({
+                type: "model",
+                modelName: model.name,
+                lineNumber: model.lineNumber,
+                suggestion: `Consider removing model ${model.name} if no longer needed`,
+            });
+            continue; // Don't report fields for unused models
+        }
+        // Check fields for used models
+        const fieldUsages = stats.fieldUsages.get(model.name) || new Map();
+        for (const field of model.fields) {
+            if (IGNORED_FIELDS.has(field.name))
+                continue;
+            const fieldUsage = fieldUsages.get(field.name);
+            const hasReads = fieldUsage && fieldUsage.reads.size > 0;
+            const hasWrites = fieldUsage && fieldUsage.writes.size > 0;
+            if (!hasReads && !hasWrites) {
+                // Completely unused
+                const suggestion = field.isRelation
+                    ? `Relation ${field.name} on ${model.name} may be unused (check includes)`
+                    : `Field ${field.name} on ${model.name} appears unused`;
+                unused.push({
+                    type: "field",
+                    modelName: model.name,
+                    fieldName: field.name,
+                    lineNumber: field.lineNumber,
+                    suggestion,
+                });
+            }
+            else if (hasWrites && !hasReads && !field.isRelation) {
+                // Write-only field (written but never read) - skip relations as they're often implicit
+                unused.push({
+                    type: "write-only",
+                    modelName: model.name,
+                    fieldName: field.name,
+                    lineNumber: field.lineNumber,
+                    suggestion: `Field ${field.name} on ${model.name} is written but never read - consider exposing in API or removing`,
+                });
+            }
+        }
+    }
+    return unused;
+}
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+// REPORTING
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+function printReport(models, stats, unused, verbose) {
+    console.log("\n" + (0, console_chars_1.createDivider)(80, "double"));
+    console.log("  UNUSED SCHEMA DETECTION");
+    console.log((0, console_chars_1.createDivider)(80, "double"));
+    // Stats
+    const totalModels = models.length;
+    const usedModels = stats.modelUsages.size;
+    const totalFields = models.reduce((sum, m) => sum + m.fields.filter((f) => !IGNORED_FIELDS.has(f.name)).length, 0);
+    const usedFields = Array.from(stats.fieldUsages.values()).reduce((sum, fields) => {
+        let count = 0;
+        for (const [, usage] of fields) {
+            if (usage.reads.size > 0 || usage.writes.size > 0)
+                count++;
+        }
+        return sum + count;
+    }, 0);
+    console.log(`\n${console_chars_1.emoji.chart} SCHEMA STATS:`);
+    console.log(`   Models: ${usedModels}/${totalModels} used`);
+    console.log(`   Fields: ${usedFields}/${totalFields} used (excluding id/timestamps)`);
+    const unusedModels = unused.filter((u) => u.type === "model");
+    const unusedFields = unused.filter((u) => u.type === "field");
+    const writeOnlyFields = unused.filter((u) => u.type === "write-only");
+    if (unusedModels.length > 0) {
+        console.log("\n" + (0, console_chars_1.createDivider)(80, "light"));
+        console.log(`${console_chars_1.emoji.warning}  UNUSED MODELS (${unusedModels.length}):`);
+        console.log((0, console_chars_1.createDivider)(80, "light"));
+        for (const item of unusedModels) {
+            console.log(`   ${console_chars_1.emoji.bell} ${item.modelName} (line ${item.lineNumber})`);
+            if (verbose) {
+                console.log(`      ${item.suggestion}`);
+            }
+        }
+    }
+    if (unusedFields.length > 0) {
+        console.log("\n" + (0, console_chars_1.createDivider)(80, "light"));
+        console.log(`${console_chars_1.emoji.warning}  UNUSED FIELDS (${unusedFields.length}):`);
+        console.log((0, console_chars_1.createDivider)(80, "light"));
+        // Group by model
+        const byModel = new Map();
+        for (const item of unusedFields) {
+            if (!byModel.has(item.modelName)) {
+                byModel.set(item.modelName, []);
+            }
+            byModel.get(item.modelName).push(item);
+        }
+        for (const [modelName, fields] of byModel) {
+            console.log(`\n   ${modelName}:`);
+            for (const field of fields.slice(0, verbose ? fields.length : 5)) {
+                console.log(`      ${console_chars_1.emoji.bell} ${field.fieldName} (line ${field.lineNumber})`);
+            }
+            if (!verbose && fields.length > 5) {
+                console.log(`      ... and ${fields.length - 5} more`);
+            }
+        }
+    }
+    if (writeOnlyFields.length > 0) {
+        console.log("\n" + (0, console_chars_1.createDivider)(80, "light"));
+        console.log(`${console_chars_1.emoji.hint}  WRITE-ONLY FIELDS (${writeOnlyFields.length}):`);
+        console.log("   These fields are written to the database but never read back.");
+        console.log((0, console_chars_1.createDivider)(80, "light"));
+        // Group by model
+        const byModel = new Map();
+        for (const item of writeOnlyFields) {
+            if (!byModel.has(item.modelName)) {
+                byModel.set(item.modelName, []);
+            }
+            byModel.get(item.modelName).push(item);
+        }
+        for (const [modelName, fields] of byModel) {
+            console.log(`\n   ${modelName}:`);
+            for (const field of fields.slice(0, verbose ? fields.length : 5)) {
+                console.log(`      ${console_chars_1.emoji.bell} ${field.fieldName} (line ${field.lineNumber})`);
+                if (verbose) {
+                    console.log(`         ${field.suggestion}`);
+                }
+            }
+            if (!verbose && fields.length > 5) {
+                console.log(`      ... and ${fields.length - 5} more`);
+            }
+        }
+    }
+    if (unused.length === 0) {
+        console.log("\n" + (0, console_chars_1.createDivider)(80, "light"));
+        console.log(`${console_chars_1.emoji.success} ALL SCHEMA ELEMENTS ARE IN USE`);
+        console.log((0, console_chars_1.createDivider)(80, "light"));
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(80, "double"));
+    if (unused.length > 0) {
+        console.log(`\n${console_chars_1.emoji.hint} Tips:`);
+        console.log(`   ${console_chars_1.chars.bullet} Unused models may be for future features or external integrations`);
+        console.log(`   ${console_chars_1.chars.bullet} Unused fields might be accessed via raw SQL or external tools`);
+        console.log("   ${chars.bullet} Write-only fields store data that is never retrieved - expose in API or remove");
+        console.log(`   ${console_chars_1.chars.bullet} Run with --verbose for detailed suggestions`);
+        console.log(`   ${console_chars_1.chars.bullet} Run with --strict to fail on any unused schema`);
+    }
+}
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+// MAIN
+// ${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}${box.horizontal}
+async function main() {
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const strict = args.includes("--strict");
+    const schemaPath = path.join(process.cwd(), "prisma", "schema.prisma");
+    if (!fs.existsSync(schemaPath)) {
+        console.error(`${console_chars_1.emoji.error} Prisma schema not found: ${schemaPath}`);
+        process.exit(1);
+    }
+    console.log(`${console_chars_1.emoji.search} Parsing Prisma schema...`);
+    const models = parseSchema(schemaPath);
+    console.log(`   Found ${models.length} models`);
+    // Build map of fields that exist on multiple models (need stricter matching)
+    buildAmbiguousFieldsMap(models);
+    console.log(`   Found ${AMBIGUOUS_FIELDS.size} ambiguous field names (exist on multiple models)`);
+    console.log(`${console_chars_1.emoji.search} Scanning codebase for usage...`);
+    const files = await getFilesToScan();
+    console.log(`   Scanning ${files.length} files...`);
+    const stats = {
+        modelUsages: new Map(),
+        fieldUsages: new Map(),
+    };
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            scanFileForUsage(file, content, models, stats);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    const unused = findUnusedItems(models, stats);
+    printReport(models, stats, unused, verbose);
+    // Exit code - strict mode only fails on unused MODELS (not fields)
+    const unusedModels = unused.filter((u) => u.type === "model");
+    if (strict && unusedModels.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} STRICT MODE: Found ${unusedModels.length} unused models`);
+        process.exit(1);
+    }
+    // Always exit 0 in non-strict mode (warning only)
+    process.exit(0);
+}
+main().catch((error) => {
+    console.error(`${console_chars_1.emoji.error} Unexpected error:`, error);
+    process.exit(1);
+});
+//# sourceMappingURL=unused-schema-detection.js.map