@empline/preflight 1.1.48 → 1.1.49

package/dist/bin/init.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Preflight Init Command
+ *
+ * Interactive setup for @empline/preflight that prompts users about their stack.
+ *
+ * Usage:
+ *   npx preflight init
+ *   npx preflight-init
+ *
+ * This command:
+ *   - Prompts for CSS framework (recommends Tailwind)
+ *   - Prompts for hosting platform
+ *   - Installs additional dependencies based on selection
+ *   - Creates preflight.config.json with project configuration
+ */
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/bin/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/bin/init.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}

package/dist/bin/init.js

@@ -0,0 +1,369 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Preflight Init Command
+ *
+ * Interactive setup for @empline/preflight that prompts users about their stack.
+ *
+ * Usage:
+ *   npx preflight init
+ *   npx preflight-init
+ *
+ * This command:
+ *   - Prompts for CSS framework (recommends Tailwind)
+ *   - Prompts for hosting platform
+ *   - Installs additional dependencies based on selection
+ *   - Creates preflight.config.json with project configuration
+ */
+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 });
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const readline = __importStar(require("node:readline"));
+const node_child_process_1 = require("node:child_process");
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const CONFIG_FILENAME = "preflight.config.json";
+// ANSI colors
+const c = {
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+    green: "\x1b[32m",
+    cyan: "\x1b[36m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    gray: "\x1b[90m",
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+};
+// =============================================================================
+// PROMPTING UTILITIES
+// =============================================================================
+function createPrompt() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+async function askQuestion(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            resolve(answer.trim());
+        });
+    });
+}
+async function selectOption(rl, question, options) {
+    console.log(`\n${c.cyan}${c.bold}${question}${c.reset}\n`);
+    options.forEach((opt, i) => {
+        const num = `${i + 1}`;
+        const recommended = opt.recommended ? ` ${c.green}(Recommended)${c.reset}` : "";
+        const warning = opt.warning ? ` ${c.yellow}${opt.warning}${c.reset}` : "";
+        console.log(`  ${c.bold}${num}.${c.reset} ${opt.label}${recommended}${warning}`);
+    });
+    console.log();
+    while (true) {
+        const answer = await askQuestion(rl, `${c.gray}Enter number (1-${options.length}):${c.reset} `);
+        const num = parseInt(answer, 10);
+        if (num >= 1 && num <= options.length) {
+            const selected = options[num - 1];
+            // Show warning if MUI is selected
+            if (selected.value === "mui") {
+                console.log(`\n${c.yellow}${c.bold}Warning:${c.reset} ${c.yellow}MUI adds significant bundle size and complexity.${c.reset}`);
+                console.log(`${c.yellow}Consider migrating to Tailwind CSS for better performance and developer experience.${c.reset}`);
+                console.log(`${c.gray}See: https://tailwindcss.com/docs/installation${c.reset}\n`);
+                const confirm = await askQuestion(rl, `${c.yellow}Continue with MUI? (y/N):${c.reset} `);
+                if (confirm.toLowerCase() !== "y") {
+                    continue;
+                }
+            }
+            return selected.value;
+        }
+        console.log(`${c.red}Invalid selection. Please enter a number between 1 and ${options.length}.${c.reset}`);
+    }
+}
+// =============================================================================
+// PACKAGE MANAGER DETECTION
+// =============================================================================
+function detectPackageManager() {
+    const cwd = process.cwd();
+    if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (fs.existsSync(path.join(cwd, "bun.lockb")))
+        return "bun";
+    if (fs.existsSync(path.join(cwd, "yarn.lock")))
+        return "yarn";
+    if (fs.existsSync(path.join(cwd, "package-lock.json")))
+        return "npm";
+    // Check for global availability
+    try {
+        (0, node_child_process_1.execSync)("pnpm --version", { stdio: "ignore" });
+        return "pnpm";
+    }
+    catch {
+        return "npm";
+    }
+}
+// =============================================================================
+// DEPENDENCY INSTALLATION
+// =============================================================================
+async function installDependency(packageManager, packageName, dev = true) {
+    console.log(`${c.cyan}Installing ${packageName}...${c.reset}`);
+    const installCmd = {
+        pnpm: dev ? `pnpm add -D ${packageName}` : `pnpm add ${packageName}`,
+        npm: dev ? `npm install -D ${packageName}` : `npm install ${packageName}`,
+        yarn: dev ? `yarn add -D ${packageName}` : `yarn add ${packageName}`,
+        bun: dev ? `bun add -d ${packageName}` : `bun add ${packageName}`,
+    }[packageManager] || `npm install -D ${packageName}`;
+    return new Promise((resolve) => {
+        const child = (0, node_child_process_1.spawn)(installCmd, {
+            shell: true,
+            stdio: "inherit",
+            cwd: process.cwd(),
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                console.log(`${c.green}Installed ${packageName}${c.reset}`);
+                resolve(true);
+            }
+            else {
+                console.log(`${c.yellow}Failed to install ${packageName} (code ${code})${c.reset}`);
+                resolve(false);
+            }
+        });
+        child.on("error", (err) => {
+            console.log(`${c.yellow}Failed to install ${packageName}: ${err.message}${c.reset}`);
+            resolve(false);
+        });
+    });
+}
+async function installAgentSkills_exec() {
+    console.log(`${c.cyan}Installing vercel-labs/agent-skills...${c.reset}`);
+    console.log(`${c.gray}This installs React best practices and web design guidelines for AI agents.${c.reset}`);
+    return new Promise((resolve) => {
+        const child = (0, node_child_process_1.spawn)("npx add-skill vercel-labs/agent-skills --all", {
+            shell: true,
+            stdio: "inherit",
+            cwd: process.cwd(),
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                console.log(`${c.green}Installed vercel-labs/agent-skills${c.reset}`);
+                resolve(true);
+            }
+            else {
+                console.log(`${c.yellow}Failed to install agent-skills (code ${code})${c.reset}`);
+                console.log(`${c.gray}You can manually install later with: npx add-skill vercel-labs/agent-skills --all${c.reset}`);
+                resolve(false);
+            }
+        });
+        child.on("error", (err) => {
+            console.log(`${c.yellow}Failed to install agent-skills: ${err.message}${c.reset}`);
+            console.log(`${c.gray}You can manually install later with: npx add-skill vercel-labs/agent-skills --all${c.reset}`);
+            resolve(false);
+        });
+    });
+}
+// =============================================================================
+// CONFIG FILE MANAGEMENT
+// =============================================================================
+function loadExistingConfig() {
+    const configPath = path.join(process.cwd(), CONFIG_FILENAME);
+    if (!fs.existsSync(configPath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveConfig(config) {
+    const configPath = path.join(process.cwd(), CONFIG_FILENAME);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+    console.log(`${c.green}Created ${CONFIG_FILENAME}${c.reset}`);
+}
+// =============================================================================
+// MAIN
+// =============================================================================
+async function main() {
+    console.log();
+    console.log(`${c.blue}${c.bold}${"=".repeat(60)}${c.reset}`);
+    console.log(`${c.blue}${c.bold}  PREFLIGHT SETUP${c.reset}`);
+    console.log(`${c.blue}${c.bold}${"=".repeat(60)}${c.reset}`);
+    console.log();
+    console.log(`${c.gray}This wizard will configure @empline/preflight for your project.${c.reset}`);
+    console.log(`${c.gray}Your selections help us provide relevant preflights and recommendations.${c.reset}`);
+    // Check for existing config
+    const existingConfig = loadExistingConfig();
+    if (existingConfig) {
+        console.log(`\n${c.yellow}Found existing ${CONFIG_FILENAME}${c.reset}`);
+        console.log(`${c.gray}Current stack: ${existingConfig.stack.framework} + ${existingConfig.stack.cssFramework}${c.reset}`);
+    }
+    const rl = createPrompt();
+    const installedExtensions = [];
+    const recommendations = [];
+    try {
+        // Detect package manager
+        const packageManager = detectPackageManager();
+        console.log(`\n${c.gray}Detected package manager: ${c.cyan}${packageManager}${c.reset}`);
+        // ==========================================================================
+        // CSS Framework Selection
+        // ==========================================================================
+        const cssFramework = await selectOption(rl, "Which CSS framework are you using?", [
+            { value: "tailwind", label: "Tailwind CSS", recommended: true },
+            { value: "css-modules", label: "CSS Modules" },
+            { value: "styled-components", label: "Styled Components" },
+            { value: "chakra", label: "Chakra UI" },
+            { value: "mui", label: "Material UI (MUI)", warning: "- Not recommended (large bundle)" },
+            { value: "other", label: "Other / Custom" },
+        ]);
+        if (cssFramework === "tailwind") {
+            recommendations.push("Enable Tailwind-specific preflights for class consistency");
+        }
+        else if (cssFramework !== "mui") {
+            recommendations.push("Consider migrating to Tailwind CSS for improved performance and DX");
+        }
+        // ==========================================================================
+        // Framework Selection
+        // ==========================================================================
+        const framework = await selectOption(rl, "Which framework are you using?", [
+            { value: "nextjs", label: "Next.js", recommended: true },
+            { value: "remix", label: "Remix" },
+            { value: "astro", label: "Astro" },
+            { value: "vite", label: "Vite (React/Vue/Svelte)" },
+            { value: "cra", label: "Create React App", warning: "- Consider migrating to Vite" },
+            { value: "other", label: "Other" },
+        ]);
+        // ==========================================================================
+        // Hosting Platform Selection
+        // ==========================================================================
+        const hostingPlatform = await selectOption(rl, "Where will you deploy?", [
+            { value: "vercel", label: "Vercel", recommended: true },
+            { value: "netlify", label: "Netlify" },
+            { value: "cloudflare", label: "Cloudflare Pages/Workers" },
+            { value: "aws", label: "AWS (Amplify, Lambda, etc.)" },
+            { value: "railway", label: "Railway" },
+            { value: "self-hosted", label: "Self-hosted / Docker" },
+            { value: "other", label: "Other" },
+        ]);
+        // Install Vercel agent-skills if Vercel is selected
+        if (hostingPlatform === "vercel") {
+            console.log(`\n${c.cyan}${c.bold}Vercel detected!${c.reset}`);
+            console.log(`${c.gray}Vercel agent-skills provides React/Next.js best practices and web design guidelines for AI agents.${c.reset}`);
+            const installAgentSkills = await askQuestion(rl, `\n${c.cyan}Install vercel-labs/agent-skills? (Y/n):${c.reset} `);
+            if (installAgentSkills.toLowerCase() !== "n") {
+                const installed = await installAgentSkills_exec();
+                if (installed) {
+                    installedExtensions.push("vercel-labs/agent-skills (vercel-react-best-practices, web-design-guidelines)");
+                    recommendations.push("Agent skills installed - AI agents now have access to React/Next.js best practices");
+                }
+            }
+        }
+        // ==========================================================================
+        // Database Selection
+        // ==========================================================================
+        const database = await selectOption(rl, "Which database are you using?", [
+            { value: "postgresql", label: "PostgreSQL", recommended: true },
+            { value: "supabase", label: "Supabase" },
+            { value: "planetscale", label: "PlanetScale" },
+            { value: "mysql", label: "MySQL" },
+            { value: "mongodb", label: "MongoDB" },
+            { value: "sqlite", label: "SQLite" },
+            { value: "none", label: "None / Not yet decided" },
+            { value: "other", label: "Other" },
+        ]);
+        // ==========================================================================
+        // Create Configuration
+        // ==========================================================================
+        const config = {
+            version: 1,
+            initialized: new Date().toISOString(),
+            stack: {
+                cssFramework,
+                hostingPlatform,
+                database,
+                framework,
+                packageManager,
+            },
+            recommendations,
+            installedExtensions,
+        };
+        saveConfig(config);
+        // ==========================================================================
+        // Summary
+        // ==========================================================================
+        console.log();
+        console.log(`${c.green}${c.bold}${"=".repeat(60)}${c.reset}`);
+        console.log(`${c.green}${c.bold}  SETUP COMPLETE${c.reset}`);
+        console.log(`${c.green}${c.bold}${"=".repeat(60)}${c.reset}`);
+        console.log();
+        console.log(`${c.cyan}Your stack:${c.reset}`);
+        console.log(`  Framework:    ${c.bold}${framework}${c.reset}`);
+        console.log(`  CSS:          ${c.bold}${cssFramework}${c.reset}`);
+        console.log(`  Hosting:      ${c.bold}${hostingPlatform}${c.reset}`);
+        console.log(`  Database:     ${c.bold}${database}${c.reset}`);
+        console.log(`  Pkg Manager:  ${c.bold}${packageManager}${c.reset}`);
+        if (installedExtensions.length > 0) {
+            console.log();
+            console.log(`${c.cyan}Installed extensions:${c.reset}`);
+            installedExtensions.forEach((ext) => {
+                console.log(`  ${c.green}+${c.reset} ${ext}`);
+            });
+        }
+        if (recommendations.length > 0) {
+            console.log();
+            console.log(`${c.cyan}Recommendations:${c.reset}`);
+            recommendations.forEach((rec) => {
+                console.log(`  ${c.yellow}*${c.reset} ${rec}`);
+            });
+        }
+        console.log();
+        console.log(`${c.cyan}Next steps:${c.reset}`);
+        console.log(`  1. Run preflights: ${c.bold}npx preflight${c.reset}`);
+        console.log(`  2. View available checks: ${c.bold}npx preflight list-checks${c.reset}`);
+        console.log(`  3. Add to CI: ${c.bold}npx preflight --ci${c.reset}`);
+        console.log();
+    }
+    finally {
+        rl.close();
+    }
+}
+main().catch((error) => {
+    console.error(`${c.red}Setup failed:${c.reset}`, error.message);
+    process.exit(1);
+});
+//# sourceMappingURL=init.js.map

package/dist/bin/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/bin/init.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAA8B;AAC9B,gDAAkC;AAClC,wDAA0C;AAC1C,2DAAqD;AAErD,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,cAAc;AACd,MAAM,CAAC,GAAG;IACR,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;CACf,CAAC;AAsBF,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,SAAS,YAAY;IACnB,OAAO,QAAQ,CAAC,eAAe,CAAC;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,EAAsB,EAAE,QAAgB;IACjE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC/B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,EAAsB,EACtB,QAAgB,EAChB,OAAoF;IAEpF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAE3D,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,GAAG,WAAW,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,mBAAmB,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAChG,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAEjC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YAElC,kCAAkC;YAClC,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,mDAAmD,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC9H,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,sFAAsF,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBACxH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,iDAAiD,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;gBAEnF,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,MAAM,4BAA4B,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;gBACzF,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;oBAClC,SAAS;gBACX,CAAC;YACH,CAAC;YAED,OAAO,QAAQ,CAAC,KAAK,CAAC;QACxB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,0DAA0D,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7G,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,SAAS,oBAAoB;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACnE,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAErE,gCAAgC;IAChC,IAAI,CAAC;QACH,IAAA,6BAAQ,EAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,KAAK,UAAU,iBAAiB,CAAC,cAAsB,EAAE,WAAmB,EAAE,GAAG,GAAG,IAAI;IACtF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,cAAc,WAAW,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAE/D,MAAM,UAAU,GAAG;QACjB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,eAAe,WAAW,EAAE,CAAC,CAAC,CAAC,YAAY,WAAW,EAAE;QACpE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,kBAAkB,WAAW,EAAE,CAAC,CAAC,CAAC,eAAe,WAAW,EAAE;QACzE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,eAAe,WAAW,EAAE,CAAC,CAAC,CAAC,YAAY,WAAW,EAAE;QACpE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,cAAc,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,WAAW,EAAE;KAClE,CAAC,cAAc,CAAC,IAAI,kBAAkB,WAAW,EAAE,CAAC;IAErD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,UAAU,EAAE;YAC9B,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;SACnB,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,aAAa,WAAW,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC5D,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,qBAAqB,WAAW,UAAU,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBACpF,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,qBAAqB,WAAW,KAAK,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACrF,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,uBAAuB;IACpC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,yCAAyC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,8EAA8E,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAE9G,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,8CAA8C,EAAE;YAClE,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;SACnB,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,qCAAqC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBACtE,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,wCAAwC,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBAClF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,oFAAoF,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBACpH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,mCAAmC,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,oFAAoF,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACpH,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,SAAS,kBAAkB;IACzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAC7D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,MAAuB;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAC7D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,WAAW,eAAe,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,kEAAkE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,2EAA2E,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAE3G,4BAA4B;IAC5B,MAAM,cAAc,GAAG,kBAAkB,EAAE,CAAC;IAC5C,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,kBAAkB,eAAe,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,kBAAkB,cAAc,CAAC,KAAK,CAAC,SAAS,MAAM,cAAc,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5H,CAAC;IAED,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAC1B,MAAM,mBAAmB,GAAa,EAAE,CAAC;IACzC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,IAAI,CAAC;QACH,yBAAyB;QACzB,MAAM,cAAc,GAAG,oBAAoB,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,6BAA6B,CAAC,CAAC,IAAI,GAAG,cAAc,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAEzF,6EAA6E;QAC7E,0BAA0B;QAC1B,6EAA6E;QAC7E,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,oCAAoC,EAAE;YAChF,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE;YAC/D,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;YAC9C,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE;YAC1D,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE;YACvC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,kCAAkC,EAAE;YACzF,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAC5C,CAAmC,CAAC;QAErC,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;YAChC,eAAe,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QACpF,CAAC;aAAM,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;YAClC,eAAe,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QAC7F,CAAC;QAED,6EAA6E;QAC7E,sBAAsB;QACtB,6EAA6E;QAC7E,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,gCAAgC,EAAE;YACzE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE;YACxD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;YAClC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;YAClC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,EAAE;YACnD,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,8BAA8B,EAAE;YACpF,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;SACnC,CAAgC,CAAC;QAElC,6EAA6E;QAC7E,6BAA6B;QAC7B,6EAA6E;QAC7E,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,wBAAwB,EAAE;YACvE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE;YACvD,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;YACtC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,0BAA0B,EAAE;YAC1D,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,EAAE;YACtD,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;YACtC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,sBAAsB,EAAE;YACvD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;SACnC,CAAsC,CAAC;QAExC,oDAAoD;QACpD,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,qGAAqG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAErI,MAAM,kBAAkB,GAAG,MAAM,WAAW,CAC1C,EAAE,EACF,KAAK,CAAC,CAAC,IAAI,2CAA2C,CAAC,CAAC,KAAK,GAAG,CACjE,CAAC;YAEF,IAAI,kBAAkB,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;gBAC7C,MAAM,SAAS,GAAG,MAAM,uBAAuB,EAAE,CAAC;gBAClD,IAAI,SAAS,EAAE,CAAC;oBACd,mBAAmB,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;oBAC1G,eAAe,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;gBAC7G,CAAC;YACH,CAAC;QACH,CAAC;QAED,6EAA6E;QAC7E,qBAAqB;QACrB,6EAA6E;QAC7E,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,+BAA+B,EAAE;YACvE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE;YAC/D,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;YACxC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;YAC9C,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;YAClC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;YACtC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;YACpC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,wBAAwB,EAAE;YAClD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;SACnC,CAA+B,CAAC;QAEjC,6EAA6E;QAC7E,uBAAuB;QACvB,6EAA6E;QAC7E,MAAM,MAAM,GAAoB;YAC9B,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,KAAK,EAAE;gBACL,YAAY;gBACZ,eAAe;gBACf,QAAQ;gBACR,SAAS;gBACT,cAAc;aACf;YACD,eAAe;YACf,mBAAmB;SACpB,CAAC;QAEF,UAAU,CAAC,MAAM,CAAC,CAAC;QAEnB,6EAA6E;QAC7E,UAAU;QACV,6EAA6E;QAC7E,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,IAAI,GAAG,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,IAAI,GAAG,YAAY,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,IAAI,GAAG,eAAe,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,IAAI,GAAG,cAAc,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAEpE,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACxD,mBAAmB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACnD,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,IAAI,4BAA4B,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACxF,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/bin/preflight.js

@@ -57,6 +57,8 @@ const path = __importStar(require("node:path"));
 const crypto = __importStar(require("node:crypto"));
 const glob_1 = require("glob");
 const runner_1 = require("../runner");
+const activation_1 = require("../lib/activation");
+const ai_commands_1 = require("../lib/ai-commands");
 const args = process.argv.slice(2);
 const command = args[0];
 // ANSI colors
@@ -121,8 +123,15 @@ async function checkDrift() {
     }
 }
 async function run() {
+    // Check activation before any operation
+    await (0, activation_1.checkActivation)();
     // Handle subcommands
     switch (command) {
+        case "init": {
+            // Dynamic import to avoid loading init dependencies unless needed
+            await Promise.resolve().then(() => __importStar(require("./init")));
+            break;
+        }
         case "submit": {
             const { submit } = await Promise.resolve().then(() => __importStar(require("./submit")));
             const options = {
@@ -175,8 +184,200 @@ async function run() {
             await approve(options);
             break;
         }
+        // =========================================================================
+        // AI-FRIENDLY COMMANDS
+        // =========================================================================
+        case "list-categories":
+        case "categories": {
+            const jsonOutput = args.includes("--json") || args.includes("--ai");
+            const checksRoot = path.dirname(__dirname);
+            const appRoot = process.cwd();
+            const checks = await (0, ai_commands_1.discoverAllChecks)(checksRoot, appRoot);
+            const categories = (0, ai_commands_1.groupByCategory)(checks);
+            if (jsonOutput) {
+                console.log(JSON.stringify((0, ai_commands_1.formatCategoryListAI)(categories), null, 2));
+            }
+            else {
+                console.log((0, ai_commands_1.formatCategoryListHuman)(categories));
+            }
+            break;
+        }
+        case "list-checks":
+        case "checks": {
+            const jsonOutput = args.includes("--json") || args.includes("--ai");
+            const categoryFilter = args.find((a) => a.startsWith("--category="))?.split("=")[1];
+            const checksRoot = path.dirname(__dirname);
+            const appRoot = process.cwd();
+            let checks = await (0, ai_commands_1.discoverAllChecks)(checksRoot, appRoot);
+            if (categoryFilter) {
+                checks = checks.filter(c => c.category.toLowerCase() === categoryFilter.toLowerCase());
+            }
+            if (jsonOutput) {
+                console.log(JSON.stringify((0, ai_commands_1.formatCheckListAI)(checks), null, 2));
+            }
+            else {
+                console.log((0, ai_commands_1.formatCheckListHuman)(checks));
+            }
+            break;
+        }
+        case "explain": {
+            const checkName = args.slice(1).filter(a => !a.startsWith("-")).join(" ");
+            if (!checkName) {
+                console.log("Usage: preflight explain <check-name>");
+                console.log("Example: preflight explain 'Cart Quantity Validation'");
+                process.exit(1);
+            }
+            const jsonOutput = args.includes("--json") || args.includes("--ai");
+            const checksRoot = path.dirname(__dirname);
+            const appRoot = process.cwd();
+            const checks = await (0, ai_commands_1.discoverAllChecks)(checksRoot, appRoot);
+            const check = (0, ai_commands_1.findCheck)(checks, checkName);
+            if (!check) {
+                console.error(`${c.red}Check not found: "${checkName}"${c.reset}`);
+                console.error(`\nTry: npx preflight list-checks | grep -i "${checkName}"`);
+                process.exit(1);
+            }
+            if (jsonOutput) {
+                console.log(JSON.stringify((0, ai_commands_1.formatExplainAI)(check), null, 2));
+            }
+            else {
+                console.log((0, ai_commands_1.formatExplainHuman)(check));
+            }
+            break;
+        }
         default: {
+            // Handle --list-categories, --list-checks, --check, --explain as flags
+            const listCategories = args.includes("--list-categories");
+            const listChecks = args.includes("--list-checks");
+            const checkArg = args.find((a) => a.startsWith("--check="))?.split("=")[1] ||
+                (args.includes("--check") ? args[args.indexOf("--check") + 1] : undefined);
+            const recheckArg = args.find((a) => a.startsWith("--recheck="))?.split("=")[1] ||
+                (args.includes("--recheck") ? args[args.indexOf("--recheck") + 1] : undefined);
+            const explainArg = args.find((a) => a.startsWith("--explain="))?.split("=")[1] ||
+                (args.includes("--explain") ? args[args.indexOf("--explain") + 1] : undefined);
+            const jsonOutput = args.includes("--json") || args.includes("--ai");
+            const checksRoot = path.dirname(__dirname);
+            const appRoot = process.cwd();
+            // Handle --list-categories flag
+            if (listCategories) {
+                const checks = await (0, ai_commands_1.discoverAllChecks)(checksRoot, appRoot);
+                const categories = (0, ai_commands_1.groupByCategory)(checks);
+                if (jsonOutput) {
+                    console.log(JSON.stringify((0, ai_commands_1.formatCategoryListAI)(categories), null, 2));
+                }
+                else {
+                    console.log((0, ai_commands_1.formatCategoryListHuman)(categories));
+                }
+                break;
+            }
+            // Handle --list-checks flag
+            if (listChecks) {
+                const categoryFilter = args.find((a) => a.startsWith("--category="))?.split("=")[1];
+                let checks = await (0, ai_commands_1.discoverAllChecks)(checksRoot, appRoot);
+                if (categoryFilter) {
+                    checks = checks.filter(c => c.category.toLowerCase() === categoryFilter.toLowerCase());
+                }
+                if (jsonOutput) {
+                    console.log(JSON.stringify((0, ai_commands_1.formatCheckListAI)(checks), null, 2));
+                }
+                else {
+                    console.log((0, ai_commands_1.formatCheckListHuman)(checks));
+                }
+                break;
+            }
+            // Handle --explain flag
+            if (explainArg) {
+                const checks = await (0, ai_commands_1.discoverAllChecks)(checksRoot, appRoot);
+                const check = (0, ai_commands_1.findCheck)(checks, explainArg);
+                if (!check) {
+                    console.error(`${c.red}Check not found: "${explainArg}"${c.reset}`);
+                    process.exit(1);
+                }
+                if (jsonOutput) {
+                    console.log(JSON.stringify((0, ai_commands_1.formatExplainAI)(check), null, 2));
+                }
+                else {
+                    console.log((0, ai_commands_1.formatExplainHuman)(check));
+                }
+                break;
+            }
+            // Handle --check or --recheck flag (run single check)
+            const singleCheckName = checkArg || recheckArg;
+            if (singleCheckName) {
+                const checks = await (0, ai_commands_1.discoverAllChecks)(checksRoot, appRoot);
+                const check = (0, ai_commands_1.findCheck)(checks, singleCheckName);
+                if (!check) {
+                    console.error(`${c.red}Check not found: "${singleCheckName}"${c.reset}`);
+                    console.error(`\nAvailable checks matching "${singleCheckName}":`);
+                    const matches = checks.filter(c => c.name.toLowerCase().includes(singleCheckName.toLowerCase()) ||
+                        c.id.toLowerCase().includes(singleCheckName.toLowerCase())).slice(0, 5);
+                    for (const m of matches) {
+                        console.error(`  - ${m.name} (${m.category})`);
+                    }
+                    process.exit(1);
+                }
+                console.log(`\n${c.cyan}Running single check: ${check.name}${c.reset}`);
+                console.log(`Category: ${check.category} | Blocking: ${check.blocking ? "Yes" : "No"}`);
+                console.log("─".repeat(60));
+                const result = await (0, runner_1.runSingleCheck)(check.filePath, check.name, check.blocking);
+                if (jsonOutput) {
+                    console.log(JSON.stringify(result, null, 2));
+                }
+                else {
+                    const icon = result.passed ? "✅" : "❌";
+                    console.log(`\n${icon} ${result.name}: ${result.passed ? "PASSED" : "FAILED"}`);
+                    console.log(`   Duration: ${result.duration.toFixed(2)}s`);
+                    if (result.findings?.length) {
+                        console.log(`   Findings:`);
+                        for (const f of result.findings.slice(0, 10)) {
+                            const fIcon = f.severity === "error" ? "🔴" : f.severity === "warning" ? "🟡" : "🔵";
+                            console.log(`     ${fIcon} ${f.message}`);
+                            if (f.file)
+                                console.log(`        File: ${f.file}${f.line ? `:${f.line}` : ""}`);
+                            if (f.suggestion)
+                                console.log(`        Fix: ${f.suggestion}`);
+                        }
+                        if (result.findings.length > 10) {
+                            console.log(`     ... and ${result.findings.length - 10} more`);
+                        }
+                    }
+                }
+                process.exit(result.passed ? 0 : 1);
+            }
+            // Standard preflight execution continues below...
             const skipDrift = args.includes("--skip-drift") || args.includes("--no-drift");
+            const hasCategory = args.includes("--category") || args.some((a) => a.startsWith("--category="));
+            const hasJsonOutput = args.includes("--json") || args.includes("--ai");
+            const hasPipeWarningBypass = args.includes("--yes-run-all") || args.includes("-y");
+            // Check for help flag and AI commands early - these should always bypass pipe warning
+            const wantsHelp = args.includes("--help") || args.includes("-h");
+            const hasAiCommand = listCategories || listChecks || explainArg || singleCheckName;
+            // Detect if output is being piped (not a TTY) without category filtering
+            // This suggests the user might be trying to grep/filter output, which still runs ALL checks
+            if (!process.stdout.isTTY && !hasCategory && !hasJsonOutput && !hasPipeWarningBypass && !wantsHelp && !hasAiCommand) {
+                console.error("");
+                console.error(`${c.yellow}${c.bold}╔═══════════════════════════════════════════════════════════╗${c.reset}`);
+                console.error(`${c.yellow}${c.bold}║          ⚠️  PIPED OUTPUT DETECTED                        ║${c.reset}`);
+                console.error(`${c.yellow}${c.bold}╠═══════════════════════════════════════════════════════════╣${c.reset}`);
+                console.error(`${c.yellow}${c.bold}║${c.reset}  Piping to grep/filter still runs ALL checks!            ${c.yellow}${c.bold}║${c.reset}`);
+                console.error(`${c.yellow}${c.bold}║${c.reset}  This is slow and wastes resources.                      ${c.yellow}${c.bold}║${c.reset}`);
+                console.error(`${c.yellow}${c.bold}╚═══════════════════════════════════════════════════════════╝${c.reset}`);
+                console.error("");
+                console.error(`${c.cyan}${c.bold}To run only specific categories (RECOMMENDED):${c.reset}`);
+                console.error(`  npx preflight --category checkout --category cart`);
+                console.error("");
+                console.error(`${c.cyan}${c.bold}For AI-friendly JSON output:${c.reset}`);
+                console.error(`  npx preflight --ai`);
+                console.error("");
+                console.error(`${c.cyan}${c.bold}Available categories:${c.reset}`);
+                console.error(`  security, typescript, runtime, database, ui, quality,`);
+                console.error(`  performance, testing, organization, business, auth,`);
+                console.error(`  cart, checkout, api, architecture, code-hygiene, ...`);
+                console.error("");
+                console.error(`${c.yellow}To run all checks anyway, add ${c.cyan}--yes-run-all${c.yellow} or ${c.cyan}-y${c.reset}`);
+                console.error("");
+                process.exit(1);
+            }
             // Check for drift before running preflights
             const drift = await checkDrift();
             if (drift.hasDrift) {