@empline/preflight 1.0.20

package/dist/checks/deployment/rollback-compatibility.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env tsx
+/**
+ * Rollback Compatibility Preflight (WARNING)
+ *
+ * Ensures code can gracefully degrade if rolled back to a previous version.
+ * Prevents deployments that can't be safely rolled back.
+ *
+ * Checks for:
+ * - Database columns accessed but not in previous schema
+ * - New required environment variables
+ * - Breaking API contract changes
+ * - Feature flags without fallback defaults
+ *
+ * Usage:
+ *   pnpm preflight:rollback-compatibility
+ *   pnpm preflight:rollback-compatibility --verbose
+ *   pnpm preflight:rollback-compatibility --blocking
+ *
+ * @since 2026-01-03
+ */
+export declare const id = "deployment/rollback-compatibility";
+export declare const name = "Rollback Compatibility";
+export declare const category = "deployment";
+export declare const blocking = false;
+export declare const description = "Rollback Compatibility Preflight (WARNING)";
+export declare const tags: string[];
+//# sourceMappingURL=rollback-compatibility.d.ts.map

package/dist/checks/deployment/rollback-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback-compatibility.d.ts","sourceRoot":"","sources":["../../../src/checks/deployment/rollback-compatibility.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,eAAO,MAAM,EAAE,sCAAsC,CAAC;AACtD,eAAO,MAAM,IAAI,2BAA2B,CAAC;AAC7C,eAAO,MAAM,QAAQ,eAAe,CAAC;AACrC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,+CAA+C,CAAC;AACxE,eAAO,MAAM,IAAI,UAAiB,CAAC"}

package/dist/checks/deployment/rollback-compatibility.js

@@ -0,0 +1,327 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Rollback Compatibility Preflight (WARNING)
+ *
+ * Ensures code can gracefully degrade if rolled back to a previous version.
+ * Prevents deployments that can't be safely rolled back.
+ *
+ * Checks for:
+ * - Database columns accessed but not in previous schema
+ * - New required environment variables
+ * - Breaking API contract changes
+ * - Feature flags without fallback defaults
+ *
+ * Usage:
+ *   pnpm preflight:rollback-compatibility
+ *   pnpm preflight:rollback-compatibility --verbose
+ *   pnpm preflight:rollback-compatibility --blocking
+ *
+ * @since 2026-01-03
+ */
+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 child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "deployment/rollback-compatibility";
+exports.name = "Rollback Compatibility";
+exports.category = "deployment";
+exports.blocking = false;
+exports.description = "Rollback Compatibility Preflight (WARNING)";
+exports.tags = ["deployment"];
+const isVerbose = process.argv.includes("--verbose");
+const isBlocking = process.argv.includes("--blocking");
+const baseBranch = process.argv.find((a) => a.startsWith("--base="))?.split("=")[1] || "main";
+function runGitCommand(cmd) {
+    try {
+        return (0, child_process_1.execSync)(cmd, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+    }
+    catch {
+        return "";
+    }
+}
+function getFileFromBranch(file, branch) {
+    try {
+        return runGitCommand(`git show ${branch}:${file} 2>/dev/null`);
+    }
+    catch {
+        return "";
+    }
+}
+function getCurrentFile(file) {
+    try {
+        return fs.readFileSync(file, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+function checkSchemaRollback() {
+    const issues = [];
+    const schemaFile = "prisma/schema.prisma";
+    const oldSchema = getFileFromBranch(schemaFile, baseBranch);
+    const newSchema = getCurrentFile(schemaFile);
+    if (!oldSchema || !newSchema)
+        return issues;
+    // Extract fields from schema
+    const extractFields = (content) => {
+        const fields = new Set();
+        const fieldRegex = /^\s+(\w+)\s+\w+/gm;
+        let match;
+        while ((match = fieldRegex.exec(content)) !== null) {
+            if (!match[1].startsWith("@@") && !match[1].startsWith("//")) {
+                fields.add(match[1]);
+            }
+        }
+        return fields;
+    };
+    const oldFields = extractFields(oldSchema);
+    const newFields = extractFields(newSchema);
+    // Find new fields that code might depend on
+    const addedFields = [];
+    for (const field of newFields) {
+        if (!oldFields.has(field)) {
+            addedFields.push(field);
+        }
+    }
+    if (addedFields.length > 0) {
+        // Check if new fields are accessed in code
+        const codeFiles = (0, child_process_1.execSync)('git diff --name-only HEAD~10..HEAD -- "*.ts" "*.tsx" 2>/dev/null || echo ""', { encoding: "utf-8" })
+            .split("\n")
+            .filter(Boolean);
+        for (const field of addedFields) {
+            // Check if field is accessed in changed files
+            for (const codeFile of codeFiles) {
+                if (!fs.existsSync(codeFile))
+                    continue;
+                const content = fs.readFileSync(codeFile, "utf-8");
+                if (content.includes(`.${field}`) || content.includes(`["${field}"]`)) {
+                    issues.push({
+                        type: "schema",
+                        file: codeFile,
+                        message: `Code accesses new field "${field}" - rollback would cause runtime error`,
+                        severity: "warning",
+                        rollbackRisk: "High - code expects field that won't exist in previous version",
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}
+function checkEnvRollback() {
+    const issues = [];
+    // Compare .env.example files
+    const envExampleFile = ".env.example";
+    const oldEnv = getFileFromBranch(envExampleFile, baseBranch);
+    const newEnv = getCurrentFile(envExampleFile);
+    if (!oldEnv || !newEnv)
+        return issues;
+    // Extract env variable names
+    const extractVars = (content) => {
+        const vars = new Set();
+        const lines = content.split("\n");
+        for (const line of lines) {
+            const match = line.match(/^([A-Z][A-Z0-9_]*)\s*=/);
+            if (match) {
+                vars.add(match[1]);
+            }
+        }
+        return vars;
+    };
+    const oldVars = extractVars(oldEnv);
+    const newVars = extractVars(newEnv);
+    // Find new required variables
+    for (const v of newVars) {
+        if (!oldVars.has(v)) {
+            // Check if it's used as required (no default/fallback)
+            const usagePattern = new RegExp(`process\\.env\\.${v}(?!\\s*\\|\\|)`, "g");
+            const changedFiles = runGitCommand('git diff --name-only HEAD~5..HEAD -- "*.ts" "*.tsx"')
+                .split("\n")
+                .filter(Boolean);
+            for (const file of changedFiles) {
+                if (!fs.existsSync(file))
+                    continue;
+                const content = fs.readFileSync(file, "utf-8");
+                if (usagePattern.test(content)) {
+                    issues.push({
+                        type: "env",
+                        file,
+                        message: `New env variable "${v}" used without fallback - rollback would cause undefined`,
+                        severity: "warning",
+                        rollbackRisk: "Medium - new env var may not be set in previous deployment",
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}
+function checkFeatureFlagRollback() {
+    const issues = [];
+    // Find new feature flag usages without defaults
+    const changedFiles = runGitCommand('git diff --name-only HEAD~5..HEAD -- "*.ts" "*.tsx"')
+        .split("\n")
+        .filter(Boolean);
+    for (const file of changedFiles) {
+        if (!fs.existsSync(file))
+            continue;
+        const content = fs.readFileSync(file, "utf-8");
+        // Check for feature flag usage without default
+        const flagPatterns = [
+            /useFeatureFlag\s*\(\s*['"][^'"]+['"]\s*\)(?!\s*\?\?)/g,
+            /isFeatureEnabled\s*\(\s*['"][^'"]+['"]\s*\)(?!\s*\?\?)/g,
+        ];
+        for (const pattern of flagPatterns) {
+            if (pattern.test(content)) {
+                // Check if there's a default value nearby
+                const hasDefault = content.includes("?? false") || content.includes("?? true");
+                if (!hasDefault) {
+                    issues.push({
+                        type: "feature-flag",
+                        file,
+                        message: "Feature flag used without default value",
+                        severity: "warning",
+                        rollbackRisk: "Low - feature flag may not exist in previous version",
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}
+function checkApiContractRollback() {
+    const issues = [];
+    // Check for new API response fields that clients depend on
+    const apiRoutes = runGitCommand('git diff --name-only HEAD~5..HEAD -- "app/api/**/*.ts"')
+        .split("\n")
+        .filter(Boolean);
+    for (const route of apiRoutes) {
+        if (!fs.existsSync(route))
+            continue;
+        const newContent = fs.readFileSync(route, "utf-8");
+        const oldContent = getFileFromBranch(route, baseBranch);
+        if (!oldContent) {
+            // New API route - rollback would remove it
+            issues.push({
+                type: "api",
+                file: route,
+                message: "New API route - rollback would return 404",
+                severity: "warning",
+                rollbackRisk: "High - clients may already be using this endpoint",
+            });
+        }
+    }
+    return issues;
+}
+async function main() {
+    console.log(`\n${console_chars_1.emoji.undo} Rollback Compatibility Check`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`Comparing against: ${baseBranch}\n`);
+    const allIssues = [];
+    // Check schema rollback safety
+    console.log(`${console_chars_1.emoji.search} Checking schema rollback safety...`);
+    const schemaIssues = checkSchemaRollback();
+    allIssues.push(...schemaIssues);
+    // Check env rollback safety
+    console.log(`${console_chars_1.emoji.search} Checking environment variable rollback safety...`);
+    const envIssues = checkEnvRollback();
+    allIssues.push(...envIssues);
+    // Check feature flag rollback safety
+    console.log(`${console_chars_1.emoji.search} Checking feature flag rollback safety...`);
+    const flagIssues = checkFeatureFlagRollback();
+    allIssues.push(...flagIssues);
+    // Check API contract rollback safety
+    console.log(`${console_chars_1.emoji.search} Checking API contract rollback safety...`);
+    const apiIssues = checkApiContractRollback();
+    allIssues.push(...apiIssues);
+    // Report results
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+    const errors = allIssues.filter((i) => i.severity === "error");
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    if (allIssues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No rollback compatibility issues detected`);
+    }
+    else {
+        // Group by type
+        const byType = new Map();
+        for (const issue of allIssues) {
+            const existing = byType.get(issue.type) || [];
+            existing.push(issue);
+            byType.set(issue.type, existing);
+        }
+        for (const [type, issues] of byType) {
+            console.log(`\n${console_chars_1.emoji.warning} ${type.toUpperCase()} ROLLBACK RISKS (${issues.length}):`);
+            for (const issue of issues.slice(0, isVerbose ? issues.length : 3)) {
+                console.log(`   ${issue.file}`);
+                console.log(`   ${console_chars_1.chars.treeCorner} ${issue.message}`);
+                console.log(`      Risk: ${issue.rollbackRisk}\n`);
+            }
+            if (!isVerbose && issues.length > 3) {
+                console.log(`   ... and ${issues.length - 3} more\n`);
+            }
+        }
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        console.log("To ensure safe rollback:");
+        console.log("   1. Add fallback defaults for new env variables");
+        console.log("   2. Use optional chaining for new schema fields");
+        console.log("   3. Provide default values for feature flags");
+        console.log("   4. Deploy schema migrations separately from code");
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.chart} Rollback Compatibility Summary`);
+    console.log(`   ${console_chars_1.emoji.error} Errors: ${errors.length}`);
+    console.log(`   ${console_chars_1.emoji.warning} Warnings: ${warnings.length}`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    if (isBlocking && allIssues.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} ROLLBACK COMPATIBILITY CHECK FAILED`);
+        process.exit(1);
+    }
+    if (allIssues.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} ROLLBACK RISKS DETECTED (non-blocking)`);
+        console.log("   Run with --blocking to enforce.");
+        process.exit(0);
+    }
+    console.log(`\n${console_chars_1.emoji.success} ROLLBACK COMPATIBILITY CHECK PASSED`);
+    process.exit(0);
+}
+main().catch((err) => {
+    console.error(`${console_chars_1.emoji.error} Fatal error:`, err);
+    process.exit(1);
+});
+//# sourceMappingURL=rollback-compatibility.js.map

package/dist/checks/deployment/rollback-compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback-compatibility.js","sourceRoot":"","sources":["../../../src/checks/deployment/rollback-compatibility.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAAyC;AACzC,uCAAyB;AACzB,6DAAwE;AAGxE,iBAAiB;AACJ,QAAA,EAAE,GAAG,mCAAmC,CAAC;AACzC,QAAA,IAAI,GAAG,wBAAwB,CAAC;AAChC,QAAA,QAAQ,GAAG,YAAY,CAAC;AACxB,QAAA,QAAQ,GAAG,KAAK,CAAC;AACjB,QAAA,WAAW,GAAG,4CAA4C,CAAC;AAC3D,QAAA,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;AAUnC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACrD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACvD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;AAE9F,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC;QACH,OAAO,IAAA,wBAAQ,EAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,MAAc;IACrD,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,YAAY,MAAM,IAAI,IAAI,cAAc,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB;IAC1B,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,sBAAsB,CAAC;IAE1C,MAAM,SAAS,GAAG,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAE7C,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAE5C,6BAA6B;IAC7B,MAAM,aAAa,GAAG,CAAC,OAAe,EAAe,EAAE;QACrD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,MAAM,UAAU,GAAG,mBAAmB,CAAC;QACvC,IAAI,KAAK,CAAC;QACV,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7D,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAE3C,4CAA4C;IAC5C,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,2CAA2C;QAC3C,MAAM,SAAS,GAAG,IAAA,wBAAQ,EACxB,6EAA6E,EAC7E,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB;aACE,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC,CAAC;QAEnB,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,8CAA8C;YAC9C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBACvC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAEnD,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;oBACtE,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,4BAA4B,KAAK,wCAAwC;wBAClF,QAAQ,EAAE,SAAS;wBACnB,YAAY,EAAE,gEAAgE;qBAC/E,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,6BAA6B;IAC7B,MAAM,cAAc,GAAG,cAAc,CAAC;IACtC,MAAM,MAAM,GAAG,iBAAiB,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;IAE9C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAEtC,6BAA6B;IAC7B,MAAM,WAAW,GAAG,CAAC,OAAe,EAAe,EAAE;QACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACnD,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEpC,8BAA8B;IAC9B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,uDAAuD;YACvD,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;YAE3E,MAAM,YAAY,GAAG,aAAa,CAAC,qDAAqD,CAAC;iBACtF,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,OAAO,CAAC,CAAC;YAEnB,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACnC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAE/C,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC/B,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,KAAK;wBACX,IAAI;wBACJ,OAAO,EAAE,qBAAqB,CAAC,0DAA0D;wBACzF,QAAQ,EAAE,SAAS;wBACnB,YAAY,EAAE,4DAA4D;qBAC3E,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB;IAC/B,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,gDAAgD;IAChD,MAAM,YAAY,GAAG,aAAa,CAAC,qDAAqD,CAAC;SACtF,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE/C,+CAA+C;QAC/C,MAAM,YAAY,GAAG;YACnB,uDAAuD;YACvD,yDAAyD;SAC1D,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,0CAA0C;gBAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAE/E,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,cAAc;wBACpB,IAAI;wBACJ,OAAO,EAAE,yCAAyC;wBAClD,QAAQ,EAAE,SAAS;wBACnB,YAAY,EAAE,sDAAsD;qBACrE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB;IAC/B,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,2DAA2D;IAC3D,MAAM,SAAS,GAAG,aAAa,CAAC,wDAAwD,CAAC;SACtF,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAExD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,2CAA2C;YAC3C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,2CAA2C;gBACpD,QAAQ,EAAE,SAAS;gBACnB,YAAY,EAAE,mDAAmD;aAClE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,IAAI,+BAA+B,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,IAAI,CAAC,CAAC;IAElD,MAAM,SAAS,GAAoB,EAAE,CAAC;IAEtC,+BAA+B;IAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,MAAM,qCAAqC,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC;IAC3C,SAAS,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;IAEhC,4BAA4B;IAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,MAAM,mDAAmD,CAAC,CAAC;IAChF,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAE7B,qCAAqC;IACrC,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,MAAM,2CAA2C,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;IAC9C,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAE9B,qCAAqC;IACrC,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,MAAM,2CAA2C,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,wBAAwB,EAAE,CAAC;IAC7C,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAE7B,iBAAiB;IACjB,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAEnE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,4CAA4C,CAAC,CAAC;IAC5E,CAAC;SAAM,CAAC;QACN,gBAAgB;QAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,oBAAoB,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YAE3F,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvD,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;YACrD,CAAC;YAED,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,KAAK,iCAAiC,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,KAAK,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,OAAO,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAExC,IAAI,UAAU,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,KAAK,sCAAsC,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,qBAAK,CAAC,KAAK,eAAe,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/checks/deprecated-api-usage.d.ts

@@ -0,0 +1,86 @@
+#!/usr/bin/env tsx
+/**
+ * Deprecated API Usage Preflight
+ *
+ * Detects usage of deprecated APIs that cause visual bugs or will break in future versions.
+ *
+ * Checks:
+ * 1. InputLabelProps (deprecated) - Use slotProps.inputLabel instead
+ *    - Causes label overlap with field content
+ *    - TextField component uses slotProps.inputLabel.shrink, not InputLabelProps
+ *
+ * 2. Autocomplete renderInput without slotProps.inputLabel.shrink
+ *    - Causes label overlap with placeholder/selected values
+ *
+ * Usage:
+ *   pnpm preflight:deprecated-api              # All checks
+ *   pnpm preflight:deprecated-api input-label  # InputLabelProps only
+ *   pnpm preflight:deprecated-api autocomplete # Autocomplete shrink only
+ *
+ * Auto-fix:
+ *   pnpm fix:deprecated-api                    # Dry run
+ *   pnpm fix:deprecated-api:apply              # Apply fixes
+ */
+export declare const id = "misc/deprecated-api-usage";
+export declare const name = "Deprecated Api Usage";
+export declare const category = "misc";
+export declare const blocking = false;
+export declare const description = "Deprecated API Usage Preflight";
+export declare const tags: string[];
+interface Issue {
+    file: string;
+    line: number;
+    type: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    suggestion?: string;
+    snippet?: string;
+    autoFixable?: boolean;
+}
+interface CheckResult {
+    name: string;
+    passed: boolean;
+    blocking: boolean;
+    issues: Issue[];
+    duration: number;
+}
+interface ModuleResult {
+    module: string;
+    passed: boolean;
+    totalDuration: number;
+    checks: CheckResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        errors: number;
+        warnings: number;
+    };
+}
+declare class DeprecatedApiPreflightModule {
+    private verbose;
+    private applyFixes;
+    constructor(options?: {
+        verbose?: boolean;
+        applyFixes?: boolean;
+    });
+    private getFiles;
+    /**
+     * Check for deprecated InputLabelProps usage
+     *
+     * The custom TextField component uses slotProps.inputLabel.shrink, not InputLabelProps.
+     * Using InputLabelProps causes the label not to shrink, resulting in label overlap.
+     */
+    checkInputLabelProps(): Promise<CheckResult>;
+    /**
+     * Check for Autocomplete renderInput without shrink
+     *
+     * When using Autocomplete with renderInput, the TextField inside needs
+     * slotProps={{ inputLabel: { shrink: true } }} to prevent label overlap.
+     */
+    checkAutocompleteShrink(): Promise<CheckResult>;
+    runAll(): Promise<ModuleResult>;
+    private printResults;
+}
+export { DeprecatedApiPreflightModule };
+//# sourceMappingURL=deprecated-api-usage.d.ts.map

package/dist/checks/deprecated-api-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-api-usage.d.ts","sourceRoot":"","sources":["../../src/checks/deprecated-api-usage.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAUH,eAAO,MAAM,EAAE,8BAA8B,CAAC;AAC9C,eAAO,MAAM,IAAI,yBAAyB,CAAC;AAC3C,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,mCAAmC,CAAC;AAC5D,eAAO,MAAM,IAAI,UAAW,CAAC;AAE7B,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9F;AAYD,cAAM,4BAA4B;IAChC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAU;gBAEhB,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO;YAKvD,QAAQ;IAItB;;;;;OAKG;IACG,oBAAoB,IAAI,OAAO,CAAC,WAAW,CAAC;IAqElD;;;;;OAKG;IACG,uBAAuB,IAAI,OAAO,CAAC,WAAW,CAAC;IA4E/C,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IA+BrC,OAAO,CAAC,YAAY;CA2ErB;AAyFD,OAAO,EAAE,4BAA4B,EAAE,CAAC"}