@empline/preflight 1.1.48 → 1.1.49

package/dist/lib/ai-commands.js

@@ -0,0 +1,393 @@
+"use strict";
+/**
+ * AI-Friendly Commands for Preflight
+ *
+ * Provides commands optimized for AI consumption:
+ * - --list-categories: List all available categories
+ * - --list-checks: List all available checks
+ * - --check <name>: Run a single check by name
+ * - --explain <name>: Get detailed info about a check
+ * - --recheck <name>: Re-run a single check for verification
+ */
+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.discoverAllChecks = discoverAllChecks;
+exports.groupByCategory = groupByCategory;
+exports.findCheck = findCheck;
+exports.findChecksByCategory = findChecksByCategory;
+exports.formatCheckListHuman = formatCheckListHuman;
+exports.formatCheckListAI = formatCheckListAI;
+exports.formatCategoryListHuman = formatCategoryListHuman;
+exports.formatCategoryListAI = formatCategoryListAI;
+exports.formatExplainHuman = formatExplainHuman;
+exports.formatExplainAI = formatExplainAI;
+const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs"));
+const glob_1 = require("glob");
+/**
+ * Parse check metadata from a compiled JS file
+ */
+function parseCheckMetadata(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const extractExport = (key) => {
+            const patterns = [
+                new RegExp(`exports\\.${key}\\s*=\\s*["']([^"']+)["']`),
+                new RegExp(`module\\.exports\\.${key}\\s*=\\s*["']([^"']+)["']`),
+            ];
+            for (const pattern of patterns) {
+                const match = content.match(pattern);
+                if (match)
+                    return match[1];
+            }
+            return undefined;
+        };
+        const extractBoolExport = (key) => {
+            const patterns = [
+                new RegExp(`exports\\.${key}\\s*=\\s*(true|false)`),
+                new RegExp(`module\\.exports\\.${key}\\s*=\\s*(true|false)`),
+            ];
+            for (const pattern of patterns) {
+                const match = content.match(pattern);
+                if (match)
+                    return match[1] === "true";
+            }
+            return undefined;
+        };
+        const extractArrayExport = (key) => {
+            const patterns = [
+                new RegExp(`exports\\.${key}\\s*=\\s*\\[([^\\]]*?)\\]`),
+                new RegExp(`module\\.exports\\.${key}\\s*=\\s*\\[([^\\]]*?)\\]`),
+            ];
+            for (const pattern of patterns) {
+                const match = content.match(pattern);
+                if (match) {
+                    const arrayContent = match[1].trim();
+                    if (!arrayContent)
+                        return [];
+                    const strings = arrayContent.match(/["']([^"']+)["']/g);
+                    if (strings) {
+                        return strings.map(s => s.replace(/["']/g, ""));
+                    }
+                    return [];
+                }
+            }
+            return undefined;
+        };
+        const extractNumberExport = (key) => {
+            const patterns = [
+                new RegExp(`exports\\.${key}\\s*=\\s*(\\d+)`),
+                new RegExp(`module\\.exports\\.${key}\\s*=\\s*(\\d+)`),
+            ];
+            for (const pattern of patterns) {
+                const match = content.match(pattern);
+                if (match)
+                    return parseInt(match[1], 10);
+            }
+            return undefined;
+        };
+        const id = extractExport("id");
+        const name = extractExport("name");
+        if (!id || !name)
+            return null;
+        return {
+            id,
+            name,
+            category: extractExport("category") || path.dirname(filePath).split(path.sep).pop() || "general",
+            blocking: extractBoolExport("blocking") ?? false,
+            description: extractExport("description") || "",
+            source: "core",
+            filePath,
+            requires: extractArrayExport("requires"),
+            priority: extractNumberExport("priority"),
+            complexity: extractExport("complexity"),
+            estimatedFixTime: extractExport("estimatedFixTime"),
+            commonFixes: extractArrayExport("commonFixes"),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Discover all available checks
+ */
+async function discoverAllChecks(checksRoot, appRoot) {
+    const checks = [];
+    // Discover core checks
+    const coreChecksDir = path.join(checksRoot, "checks");
+    if (fs.existsSync(coreChecksDir)) {
+        const coreFiles = await (0, glob_1.glob)("**/*.js", {
+            cwd: coreChecksDir,
+            ignore: ["**/*.test.js", "**/*.spec.js"],
+            nodir: true,
+        });
+        for (const file of coreFiles) {
+            const filePath = path.join(coreChecksDir, file);
+            const metadata = parseCheckMetadata(filePath);
+            if (metadata) {
+                metadata.source = "core";
+                checks.push(metadata);
+            }
+        }
+    }
+    // Discover app-specific checks
+    if (appRoot) {
+        const appChecksDir = path.join(appRoot, "scripts", "active", "preflights");
+        if (fs.existsSync(appChecksDir)) {
+            const appFiles = await (0, glob_1.glob)("**/*.{ts,js}", {
+                cwd: appChecksDir,
+                ignore: ["**/*.test.ts", "**/*.spec.ts", "**/*.d.ts"],
+                nodir: true,
+            });
+            for (const file of appFiles) {
+                const filePath = path.join(appChecksDir, file);
+                const metadata = parseCheckMetadata(filePath);
+                if (metadata) {
+                    metadata.source = "app";
+                    checks.push(metadata);
+                }
+            }
+        }
+    }
+    return checks;
+}
+/**
+ * Group checks by category
+ */
+function groupByCategory(checks) {
+    const categoryMap = new Map();
+    for (const check of checks) {
+        const cat = check.category || "general";
+        if (!categoryMap.has(cat)) {
+            categoryMap.set(cat, []);
+        }
+        categoryMap.get(cat).push(check);
+    }
+    return Array.from(categoryMap.entries())
+        .map(([name, categoryChecks]) => ({
+        name,
+        checkCount: categoryChecks.length,
+        blockingCount: categoryChecks.filter(c => c.blocking).length,
+        checks: categoryChecks.map(c => c.name),
+    }))
+        .sort((a, b) => b.checkCount - a.checkCount);
+}
+/**
+ * Find a check by name (fuzzy match)
+ */
+function findCheck(checks, searchName) {
+    const searchLower = searchName.toLowerCase().trim();
+    // Exact match first
+    const exact = checks.find(c => c.name.toLowerCase() === searchLower);
+    if (exact)
+        return exact;
+    // Exact ID match
+    const idMatch = checks.find(c => c.id.toLowerCase() === searchLower);
+    if (idMatch)
+        return idMatch;
+    // Partial name match
+    const partial = checks.find(c => c.name.toLowerCase().includes(searchLower));
+    if (partial)
+        return partial;
+    // Partial ID match
+    const partialId = checks.find(c => c.id.toLowerCase().includes(searchLower));
+    if (partialId)
+        return partialId;
+    return undefined;
+}
+/**
+ * Find checks by category
+ */
+function findChecksByCategory(checks, category) {
+    const catLower = category.toLowerCase().trim();
+    return checks.filter(c => c.category.toLowerCase() === catLower);
+}
+/**
+ * Format check list for human output
+ */
+function formatCheckListHuman(checks) {
+    const lines = [];
+    const categories = groupByCategory(checks);
+    for (const cat of categories) {
+        lines.push(`\n📁 ${cat.name.toUpperCase()} (${cat.checkCount} checks, ${cat.blockingCount} blocking)`);
+        lines.push("─".repeat(60));
+        const categoryChecks = checks.filter(c => c.category === cat.name);
+        for (const check of categoryChecks) {
+            const blocking = check.blocking ? "🔴" : "🟢";
+            const source = check.source === "app" ? " [app]" : "";
+            lines.push(`  ${blocking} ${check.name}${source}`);
+            if (check.description) {
+                lines.push(`     ${check.description}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format check list for AI/JSON output
+ */
+function formatCheckListAI(checks) {
+    const categories = groupByCategory(checks);
+    return {
+        totalChecks: checks.length,
+        totalBlocking: checks.filter(c => c.blocking).length,
+        categories: categories.map(cat => ({
+            name: cat.name,
+            checkCount: cat.checkCount,
+            blockingCount: cat.blockingCount,
+        })),
+        checks: checks.map(c => ({
+            id: c.id,
+            name: c.name,
+            category: c.category,
+            blocking: c.blocking,
+            source: c.source,
+            description: c.description || undefined,
+            requires: c.requires?.length ? c.requires : undefined,
+            priority: c.priority,
+            complexity: c.complexity,
+        })),
+    };
+}
+/**
+ * Format category list for human output
+ */
+function formatCategoryListHuman(categories) {
+    const lines = [
+        "",
+        "📋 AVAILABLE CATEGORIES",
+        "═".repeat(60),
+        "",
+    ];
+    for (const cat of categories) {
+        const blockingPct = cat.checkCount > 0
+            ? Math.round((cat.blockingCount / cat.checkCount) * 100)
+            : 0;
+        lines.push(`  📁 ${cat.name.padEnd(25)} ${String(cat.checkCount).padStart(3)} checks (${blockingPct}% blocking)`);
+    }
+    lines.push("");
+    lines.push("Usage: npx preflight --category <name> [--category <name2>]");
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Format category list for AI/JSON output
+ */
+function formatCategoryListAI(categories) {
+    return {
+        totalCategories: categories.length,
+        categories: categories.map(cat => ({
+            name: cat.name,
+            checkCount: cat.checkCount,
+            blockingCount: cat.blockingCount,
+            checks: cat.checks,
+        })),
+        usage: {
+            runSingleCategory: "npx preflight --category <name>",
+            runMultipleCategories: "npx preflight --category <name1> --category <name2>",
+            runSingleCheck: "npx preflight --check '<check name>'",
+        },
+    };
+}
+/**
+ * Format check explanation for human output
+ */
+function formatExplainHuman(check) {
+    const lines = [
+        "",
+        `📋 CHECK: ${check.name}`,
+        "═".repeat(60),
+        "",
+        `ID:          ${check.id}`,
+        `Category:    ${check.category}`,
+        `Blocking:    ${check.blocking ? "Yes (deployment blocked if fails)" : "No (warning only)"}`,
+        `Source:      ${check.source === "app" ? "App-specific" : "Core"}`,
+        `File:        ${check.filePath}`,
+    ];
+    if (check.description) {
+        lines.push(`Description: ${check.description}`);
+    }
+    if (check.requires?.length) {
+        lines.push(`Requires:    ${check.requires.join(", ")}`);
+    }
+    if (check.priority) {
+        lines.push(`Priority:    ${check.priority} (lower = fix first)`);
+    }
+    if (check.complexity) {
+        lines.push(`Complexity:  ${check.complexity}`);
+    }
+    if (check.estimatedFixTime) {
+        lines.push(`Est. Fix:    ${check.estimatedFixTime}`);
+    }
+    if (check.commonFixes?.length) {
+        lines.push("");
+        lines.push("Common Fixes:");
+        for (const fix of check.commonFixes) {
+            lines.push(`  • ${fix}`);
+        }
+    }
+    lines.push("");
+    lines.push("To run this check:");
+    lines.push(`  npx preflight --check "${check.name}"`);
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Format check explanation for AI/JSON output
+ */
+function formatExplainAI(check) {
+    return {
+        check: {
+            id: check.id,
+            name: check.name,
+            category: check.category,
+            blocking: check.blocking,
+            source: check.source,
+            filePath: check.filePath,
+            description: check.description || null,
+            requires: check.requires || [],
+            priority: check.priority || null,
+            complexity: check.complexity || null,
+            estimatedFixTime: check.estimatedFixTime || null,
+            commonFixes: check.commonFixes || [],
+        },
+        commands: {
+            run: `npx preflight --check "${check.name}"`,
+            runCategory: `npx preflight --category ${check.category}`,
+        },
+    };
+}
+//# sourceMappingURL=ai-commands.js.map

package/dist/lib/ai-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-commands.js","sourceRoot":"","sources":["../../src/lib/ai-commands.ts"],"names":[],"mappings":"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"}

package/dist/runner.d.ts

@@ -34,6 +34,24 @@ export declare function runPreflights(options?: {
     segmented?: boolean;
     segmentSize?: number;
 }): Promise<PreflightReport>;
+/**
+ * Run a single check by file path (for --check and --recheck commands)
+ * Returns a result object with pass/fail status and findings
+ */
+export declare function runSingleCheck(filePath: string, checkName: string, blocking: boolean, timeout?: number): Promise<{
+    name: string;
+    passed: boolean;
+    duration: number;
+    blocking: boolean;
+    findings?: Array<{
+        severity: "error" | "warning" | "info";
+        message: string;
+        file?: string;
+        line?: number;
+        suggestion?: string;
+    }>;
+    error?: string;
+}>;
 /**
  * CLI entry point
  */

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EAEL,eAAe,EAGhB,MAAM,cAAc,CAAC;AAYtB,OAAO,EAIL,UAAU,EACX,MAAM,6BAA6B,CAAC;AA0XrC;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE;IAC3C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmUhC;AAwJD;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAoF1C"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EAEL,eAAe,EAGhB,MAAM,cAAc,CAAC;AAYtB,OAAO,EAIL,UAAU,EACX,MAAM,6BAA6B,CAAC;AA0XrC;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE;IAC3C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmUhC;AAwJD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,MAAc,GACtB,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;QACvC,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAgDD;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA2F1C"}

package/dist/runner.js

@@ -51,6 +51,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runPreflights = runPreflights;
+exports.runSingleCheck = runSingleCheck;
 exports.main = main;
 const path = __importStar(require("node:path"));
 const fs = __importStar(require("node:fs"));
@@ -768,6 +769,56 @@ function printAiOutput(report, failedBlocking) {
         process.exitCode = 1;
     }
 }
+/**
+ * Run a single check by file path (for --check and --recheck commands)
+ * Returns a result object with pass/fail status and findings
+ */
+async function runSingleCheck(filePath, checkName, blocking, timeout = 30000) {
+    const startTime = Date.now();
+    try {
+        // Try in-process execution first
+        if ((0, in_process_runner_1.canRunInProcess)(filePath)) {
+            const result = await (0, in_process_runner_1.runCheckInProcess)(filePath, timeout);
+            const duration = (Date.now() - startTime) / 1000;
+            return {
+                name: checkName,
+                passed: result.passed,
+                duration,
+                blocking,
+                findings: result.findings?.map(f => ({
+                    severity: f.level || "error",
+                    message: f.message,
+                    file: f.file,
+                    line: f.startLine,
+                    suggestion: f.suggestion,
+                })),
+            };
+        }
+        // Fallback to subprocess
+        const { exitCode, output } = await runCheckAsSubprocess(filePath, timeout);
+        const duration = (Date.now() - startTime) / 1000;
+        return {
+            name: checkName,
+            passed: exitCode === 0,
+            duration,
+            blocking,
+            findings: exitCode !== 0 ? [{
+                    severity: "error",
+                    message: output.trim().slice(0, 500) || "Check failed",
+                }] : undefined,
+        };
+    }
+    catch (error) {
+        const duration = (Date.now() - startTime) / 1000;
+        return {
+            name: checkName,
+            passed: false,
+            duration,
+            blocking,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
 /**
  * CLI entry point
  */
@@ -804,10 +855,21 @@ Environment Variables:
   PREFLIGHT_MAX_CONCURRENCY=N  Set maximum concurrency cap
   PREFLIGHT_SEQUENTIAL=1       Force sequential execution
 
-AI Assistant Usage:
-  For AI to debug preflight failures, use --ai flag:
-    npx preflight --ai
-    npx preflight security --ai
+AI Assistant Commands:
+  npx preflight list-categories         List all available categories
+  npx preflight list-checks             List all available checks
+  npx preflight list-checks --category=cart  List checks in a category
+  npx preflight --check "Check Name"    Run a single check by name
+  npx preflight --recheck "Check Name"  Re-verify a single check after fix
+  npx preflight explain "Check Name"    Get detailed info about a check
+
+  Add --ai to any command for JSON output (e.g., list-categories --ai)
+
+AI Debugging Workflow:
+  1. npx preflight --category cart --ai   # Run specific category, get JSON
+  2. Fix the issues shown
+  3. npx preflight --recheck "Check"      # Verify single check passes
+  4. npx preflight --category cart        # Confirm all fixed
 
   The --ai flag provides:
   - Compact JSON with only failures (minimal tokens)
@@ -815,12 +877,8 @@ AI Assistant Usage:
   - Suggested fixes when available
   - No per-check progress output (cleaner)
 
-  For human-readable but concise output, use --errors-only:
-    npx preflight --errors-only
-
   For segmented output (easier for AI to process in chunks):
     npx preflight --segmented              # Groups by category
-    npx preflight --segment-size=10        # 10 checks per segment
     npx preflight --segmented --errors-only # Only show failures, grouped
 
 Performance & Debugging: