@empline/preflight 1.0.20

package/dist/core/categories.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Category Definitions for Preflight Filtering
+ *
+ * Maps category names to regex filter patterns for selective preflight runs.
+ *
+ * Usage:
+ *   pnpm preflight typescript        # Single category
+ *   pnpm preflight ui database       # Multiple categories
+ *   pnpm preflight --quick           # Quick mode (critical only)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CATEGORY_CONFIGS = exports.QUICK_CATEGORIES = exports.CATEGORY_FILTERS = void 0;
+exports.buildFilterFromCategories = buildFilterFromCategories;
+exports.getCategoryNames = getCategoryNames;
+exports.isValidCategory = isValidCategory;
+exports.printCategoryHelp = printCategoryHelp;
+/**
+ * Category to filter pattern mapping
+ */
+exports.CATEGORY_FILTERS = {
+    // Core development categories
+    typescript: "TypeScript|Syntax Validation",
+    runtime: "Runtime|Hydration|process\\.env|publicEnv|Error Boundaries|Node Deprecations",
+    security: "Security|NextAuth|API Route|Env file|Env value|Rate Limiting|Webhook|Path Traversal|SQL Injection|Sensitive Data|CSRF",
+    database: "Database|Prisma|Schema|Transaction|Soft Delete|Migration",
+    // UI and component categories
+    ui: "UI |Component|Spacing|Accessibility|Mobile|Navigation|Breadcrumb|Touch Target|Viewport|Typography|Responsive|Media|Loading|Forms|Tokens|Style|Layout",
+    // Code quality categories
+    quality: "Quality|Shared Components|Dead Code|Import|Architecture|Styling Standards",
+    performance: "Performance|Bundle|Lazy|Image|Core Web Vitals|Script Performance",
+    testing: "Test|E2E|Coverage|Regression|Action Regression|Data Entry",
+    // Organization and structure
+    organization: "Organization|File|Route|Cleanup|Naming|API Route Naming",
+    // Business logic
+    business: "Business|Shipping|Price|Currency|Order|Inventory|Idempotency|Timezone",
+    // Advanced/specialized
+    hardened: "Hardened|DRAFT|Secret|Hook|Async|Console|Type Safety",
+    imports: "Import|N\\+1",
+    seo: "SEO|Hardcoded URLs|Missing Metadata",
+    // Framework compatibility
+    framework: "Compatibility|Next\\.js|Prisma|React|Zod|TanStack|Tailwind",
+};
+/**
+ * Quick mode categories - runs only fast, critical checks
+ */
+exports.QUICK_CATEGORIES = ["typescript", "runtime", "security", "hardened"];
+/**
+ * All available categories with descriptions
+ */
+exports.CATEGORY_CONFIGS = [
+    {
+        name: "typescript",
+        pattern: exports.CATEGORY_FILTERS.typescript,
+        description: "TypeScript compilation and syntax validation",
+    },
+    {
+        name: "runtime",
+        pattern: exports.CATEGORY_FILTERS.runtime,
+        description: "Runtime safety, env usage, hydration, error handling",
+    },
+    {
+        name: "security",
+        pattern: exports.CATEGORY_FILTERS.security,
+        description: "Security checks: auth, XSS, injection, secrets",
+    },
+    {
+        name: "database",
+        pattern: exports.CATEGORY_FILTERS.database,
+        description: "Database schema, Prisma, migrations",
+    },
+    {
+        name: "ui",
+        pattern: exports.CATEGORY_FILTERS.ui,
+        description: "UI components, spacing, accessibility, responsiveness",
+    },
+    {
+        name: "quality",
+        pattern: exports.CATEGORY_FILTERS.quality,
+        description: "Code quality, imports, dead code detection",
+    },
+    {
+        name: "performance",
+        pattern: exports.CATEGORY_FILTERS.performance,
+        description: "Bundle size, images, lazy loading, Core Web Vitals",
+    },
+    {
+        name: "testing",
+        pattern: exports.CATEGORY_FILTERS.testing,
+        description: "E2E tests, coverage, regression testing",
+    },
+    {
+        name: "organization",
+        pattern: exports.CATEGORY_FILTERS.organization,
+        description: "File organization, naming conventions, route structure",
+    },
+    {
+        name: "business",
+        pattern: exports.CATEGORY_FILTERS.business,
+        description: "Business logic: pricing, inventory, orders",
+    },
+    {
+        name: "hardened",
+        pattern: exports.CATEGORY_FILTERS.hardened,
+        description: "Iron-clad rules: DRAFT status, secrets, hooks",
+    },
+    {
+        name: "framework",
+        pattern: exports.CATEGORY_FILTERS.framework,
+        description: "Framework compatibility: Next.js, React, Prisma",
+    },
+];
+/**
+ * Build filter regex from category names
+ */
+function buildFilterFromCategories(categories) {
+    if (categories.length === 0)
+        return null;
+    const patterns = categories
+        .map((c) => exports.CATEGORY_FILTERS[c.toLowerCase()])
+        .filter(Boolean);
+    if (patterns.length === 0)
+        return null;
+    try {
+        return new RegExp(patterns.join("|"), "i");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get all category names
+ */
+function getCategoryNames() {
+    return Object.keys(exports.CATEGORY_FILTERS);
+}
+/**
+ * Check if a category name is valid
+ */
+function isValidCategory(name) {
+    return name.toLowerCase() in exports.CATEGORY_FILTERS;
+}
+/**
+ * Print category help
+ */
+function printCategoryHelp() {
+    console.log("\nAvailable categories:");
+    for (const config of exports.CATEGORY_CONFIGS) {
+        console.log(`  ${config.name.padEnd(15)} - ${config.description}`);
+    }
+    console.log("\nQuick mode categories:", exports.QUICK_CATEGORIES.join(", "));
+}
+//# sourceMappingURL=categories.js.map

package/dist/core/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/core/categories.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAgHH,8DAcC;AAKD,4CAEC;AAKD,0CAEC;AAKD,8CAMC;AAnJD;;GAEG;AACU,QAAA,gBAAgB,GAA2B;IACtD,8BAA8B;IAC9B,UAAU,EAAE,8BAA8B;IAC1C,OAAO,EAAE,8EAA8E;IACvF,QAAQ,EACN,uHAAuH;IACzH,QAAQ,EAAE,0DAA0D;IAEpE,8BAA8B;IAC9B,EAAE,EAAE,sJAAsJ;IAE1J,0BAA0B;IAC1B,OAAO,EAAE,2EAA2E;IACpF,WAAW,EAAE,kEAAkE;IAC/E,OAAO,EAAE,2DAA2D;IAEpE,6BAA6B;IAC7B,YAAY,EAAE,yDAAyD;IAEvE,iBAAiB;IACjB,QAAQ,EAAE,uEAAuE;IAEjF,uBAAuB;IACvB,QAAQ,EAAE,sDAAsD;IAChE,OAAO,EAAE,cAAc;IACvB,GAAG,EAAE,qCAAqC;IAE1C,0BAA0B;IAC1B,SAAS,EAAE,4DAA4D;CACxE,CAAC;AAEF;;GAEG;AACU,QAAA,gBAAgB,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAElF;;GAEG;AACU,QAAA,gBAAgB,GAAqB;IAChD;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,wBAAgB,CAAC,UAAU;QACpC,WAAW,EAAE,8CAA8C;KAC5D;IACD;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,wBAAgB,CAAC,OAAO;QACjC,WAAW,EAAE,sDAAsD;KACpE;IACD;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,wBAAgB,CAAC,QAAQ;QAClC,WAAW,EAAE,gDAAgD;KAC9D;IACD;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,wBAAgB,CAAC,QAAQ;QAClC,WAAW,EAAE,qCAAqC;KACnD;IACD;QACE,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,wBAAgB,CAAC,EAAE;QAC5B,WAAW,EAAE,uDAAuD;KACrE;IACD;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,wBAAgB,CAAC,OAAO;QACjC,WAAW,EAAE,4CAA4C;KAC1D;IACD;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,wBAAgB,CAAC,WAAW;QACrC,WAAW,EAAE,oDAAoD;KAClE;IACD;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,wBAAgB,CAAC,OAAO;QACjC,WAAW,EAAE,yCAAyC;KACvD;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,wBAAgB,CAAC,YAAY;QACtC,WAAW,EAAE,wDAAwD;KACtE;IACD;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,wBAAgB,CAAC,QAAQ;QAClC,WAAW,EAAE,4CAA4C;KAC1D;IACD;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,wBAAgB,CAAC,QAAQ;QAClC,WAAW,EAAE,+CAA+C;KAC7D;IACD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,wBAAgB,CAAC,SAAS;QACnC,WAAW,EAAE,iDAAiD;KAC/D;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,yBAAyB,CAAC,UAAoB;IAC5D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,QAAQ,GAAG,UAAU;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,wBAAgB,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;SAC7C,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,IAAI,CAAC;QACH,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,wBAAgB,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,wBAAgB,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,KAAK,MAAM,MAAM,IAAI,wBAAgB,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,wBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,87 @@
+/**
+ * App Configuration Loader
+ *
+ * Loads preflight.config.ts from the app root to determine:
+ * - Which categories to run
+ * - Which checks to include/exclude
+ * - App-specific plugin directories
+ * - Custom category definitions
+ *
+ * Usage:
+ *   import { loadAppConfig, AppConfig } from './config';
+ *
+ *   const config = await loadAppConfig();
+ *   console.log(config.appName);       // "trading-card-system"
+ *   console.log(config.categories);    // ["security", "business", "database"]
+ */
+/**
+ * App-level preflight configuration
+ */
+export interface AppConfig {
+    /** App identifier (inferred from directory name if not specified) */
+    appName: string;
+    /** Categories to run (if not specified, runs all) */
+    categories?: string[];
+    /** Categories to always skip */
+    excludeCategories?: string[];
+    /** Specific check IDs to always skip */
+    excludeChecks?: string[];
+    /** Specific check IDs to always include (even if category is excluded) */
+    includeChecks?: string[];
+    /** Directory containing app-specific preflights (relative to config file) */
+    pluginDir?: string;
+    /** Custom category definitions for this app */
+    customCategories?: Record<string, {
+        pattern: string;
+        description: string;
+    }>;
+    /** Whether to run in CI-only mode (skip checks marked as ciOnly when not in CI) */
+    respectCiOnly?: boolean;
+    /** Default timeout for checks in milliseconds */
+    defaultTimeout?: number;
+    /** Maximum concurrent checks */
+    concurrency?: number;
+    /** Output paths */
+    output?: {
+        json?: string;
+        sarif?: string;
+        junit?: string;
+    };
+}
+/**
+ * Resolved configuration with defaults applied
+ */
+export interface ResolvedAppConfig extends Required<Omit<AppConfig, 'customCategories' | 'output'>> {
+    customCategories: Record<string, {
+        pattern: string;
+        description: string;
+    }>;
+    output: {
+        json?: string;
+        sarif?: string;
+        junit?: string;
+    };
+    /** Absolute path to the config file */
+    configPath: string;
+    /** Absolute path to the app root */
+    appRoot: string;
+    /** Absolute path to the plugin directory */
+    pluginDirAbsolute: string;
+}
+/**
+ * Find the config file by walking up the directory tree
+ */
+export declare function findConfigFile(startDir?: string): string | null;
+/**
+ * Infer app name from directory path
+ */
+export declare function inferAppName(appRoot: string): string;
+/**
+ * Load and resolve the app configuration
+ */
+export declare function loadAppConfig(startDir?: string): Promise<ResolvedAppConfig>;
+/**
+ * Check if a check should be run based on config
+ */
+export declare function shouldRunCheck(checkId: string, checkCategory: string, config: ResolvedAppConfig): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAChC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAEH,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mBAAmB;IACnB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,GAAG,QAAQ,CAAC,CAAC;IACjG,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAUD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAe9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgEhG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAuBT"}

package/dist/core/config.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * App Configuration Loader
+ *
+ * Loads preflight.config.ts from the app root to determine:
+ * - Which categories to run
+ * - Which checks to include/exclude
+ * - App-specific plugin directories
+ * - Custom category definitions
+ *
+ * Usage:
+ *   import { loadAppConfig, AppConfig } from './config';
+ *
+ *   const config = await loadAppConfig();
+ *   console.log(config.appName);       // "trading-card-system"
+ *   console.log(config.categories);    // ["security", "business", "database"]
+ */
+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.findConfigFile = findConfigFile;
+exports.inferAppName = inferAppName;
+exports.loadAppConfig = loadAppConfig;
+exports.shouldRunCheck = shouldRunCheck;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const CONFIG_FILENAMES = [
+    "preflight.config.ts",
+    "preflight.config.js",
+    "preflight.config.mjs",
+    ".preflightrc.ts",
+    ".preflightrc.js",
+];
+/**
+ * Find the config file by walking up the directory tree
+ */
+function findConfigFile(startDir = process.cwd()) {
+    let currentDir = path.resolve(startDir);
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        for (const filename of CONFIG_FILENAMES) {
+            const configPath = path.join(currentDir, filename);
+            if (fs.existsSync(configPath)) {
+                return configPath;
+            }
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return null;
+}
+/**
+ * Infer app name from directory path
+ */
+function inferAppName(appRoot) {
+    return path.basename(appRoot);
+}
+/**
+ * Load and resolve the app configuration
+ */
+async function loadAppConfig(startDir = process.cwd()) {
+    const configPath = findConfigFile(startDir);
+    if (!configPath) {
+        // Return default config if no config file found
+        const appRoot = process.cwd();
+        return {
+            appName: inferAppName(appRoot),
+            categories: [],
+            excludeCategories: [],
+            excludeChecks: [],
+            includeChecks: [],
+            pluginDir: "scripts/active/preflights",
+            customCategories: {},
+            respectCiOnly: true,
+            defaultTimeout: 30000,
+            concurrency: 1,
+            output: {},
+            configPath: "",
+            appRoot,
+            pluginDirAbsolute: path.join(appRoot, "scripts/active/preflights"),
+        };
+    }
+    const appRoot = path.dirname(configPath);
+    // Load the config file
+    let userConfig = {};
+    try {
+        if (configPath.endsWith(".json") || configPath.endsWith("rc")) {
+            // JSON files can be read directly
+            const content = fs.readFileSync(configPath, "utf8");
+            userConfig = JSON.parse(content);
+        }
+        else {
+            // For JS/TS files, use require() for CommonJS compatibility
+            // Clear the require cache to ensure fresh load
+            const resolvedPath = require.resolve(configPath);
+            delete require.cache[resolvedPath];
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const module = require(configPath);
+            userConfig = module.default || module;
+        }
+    }
+    catch (error) {
+        console.warn(`Warning: Could not load config from ${configPath}:`, error);
+    }
+    const pluginDir = userConfig.pluginDir || "scripts/active/preflights";
+    return {
+        appName: userConfig.appName || inferAppName(appRoot),
+        categories: userConfig.categories || [],
+        excludeCategories: userConfig.excludeCategories || [],
+        excludeChecks: userConfig.excludeChecks || [],
+        includeChecks: userConfig.includeChecks || [],
+        pluginDir,
+        customCategories: userConfig.customCategories || {},
+        respectCiOnly: userConfig.respectCiOnly ?? true,
+        defaultTimeout: userConfig.defaultTimeout || 30000,
+        concurrency: userConfig.concurrency || 1,
+        output: userConfig.output || {},
+        configPath,
+        appRoot,
+        pluginDirAbsolute: path.join(appRoot, pluginDir),
+    };
+}
+/**
+ * Check if a check should be run based on config
+ */
+function shouldRunCheck(checkId, checkCategory, config) {
+    // Explicitly included checks always run
+    if (config.includeChecks.includes(checkId)) {
+        return true;
+    }
+    // Explicitly excluded checks never run
+    if (config.excludeChecks.includes(checkId)) {
+        return false;
+    }
+    // Check category exclusions
+    if (config.excludeCategories.includes(checkCategory)) {
+        return false;
+    }
+    // If categories are specified, check must be in one of them
+    if (config.categories.length > 0) {
+        return config.categories.includes(checkCategory);
+    }
+    // Default: run the check
+    return true;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Core Types for Preflight System
+ *
+ * These types define the structure of preflight checks, findings, and reports.
+ */
+/**
+ * Severity level for preflight findings
+ */
+export type PreflightSeverity = "error" | "warning" | "info";
+/**
+ * Result kind for preflight checks
+ */
+export type PreflightResultKind = "passed" | "failed" | "warning" | "skipped";
+/**
+ * Group classification for preflight checks
+ */
+export type PreflightGroup = "blocking" | "non-blocking" | "seo";
+/**
+ * Individual finding from a preflight check
+ */
+export interface PreflightFinding {
+    message: string;
+    level?: PreflightSeverity;
+    file?: string;
+    startLine?: number;
+    startColumn?: number;
+    endLine?: number;
+    endColumn?: number;
+    code?: string;
+}
+/**
+ * Result record from a single preflight check
+ */
+export interface PreflightRecord {
+    name: string;
+    group: PreflightGroup;
+    blocking: boolean;
+    pathOrCmd: string;
+    kind: PreflightResultKind;
+    durationSec: number;
+    stdoutTotal?: number;
+    stderrTotal?: number;
+    timedOut?: boolean;
+    exitCode?: number;
+    outputSnippet?: string;
+    findings?: PreflightFinding[];
+}
+/**
+ * Definition of a preflight check module
+ */
+export interface PreflightModule {
+    /** Unique identifier for the check */
+    id: string;
+    /** Display name for the check */
+    name: string;
+    /** Path to the check script (relative to package root) */
+    path: string;
+    /** Whether this check blocks deployment */
+    blocking: boolean;
+    /** Description of what this check validates */
+    description: string;
+    /** Category for filtering (e.g., "security", "business", "ui") */
+    category: string;
+    /** Tags for additional filtering */
+    tags?: string[];
+    /** Whether this check should only run in CI/Vercel */
+    ciOnly?: boolean;
+    /** The run function (if loaded as a module) */
+    run?: () => Promise<PreflightCheckResult>;
+    /** Promotion metadata - flag to promote this check to core package */
+    promoteToCore?: boolean;
+    /** Suggested category when promoting to core */
+    proposedCategory?: string;
+}
+/**
+ * Result from a single preflight check execution
+ */
+export interface PreflightCheckResult {
+    passed: boolean;
+    findings: PreflightFinding[];
+    duration: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for a preflight run
+ */
+export interface PreflightConfig {
+    /** Maximum time for each check in milliseconds */
+    timeoutMs?: number;
+    /** Stop on first failure */
+    failFast?: boolean;
+    /** Path for JSON report output */
+    jsonPath?: string;
+    /** Path for JUnit XML report output */
+    junitPath?: string;
+    /** Path for SARIF report output */
+    sarifPath?: string;
+    /** Maximum concurrent checks */
+    concurrency?: number;
+    /** Filter pattern for check names */
+    filter?: string | RegExp;
+    /** Verbose output */
+    verbose?: boolean;
+}
+/**
+ * Report from a complete preflight run
+ */
+export interface PreflightReport {
+    createdAtIso: string;
+    endedAtIso?: string;
+    durationSec: number;
+    records: PreflightRecord[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        warnings: number;
+        skipped: number;
+    };
+}
+/**
+ * Category configuration for preflight filtering
+ */
+export interface CategoryConfig {
+    name: string;
+    pattern: string;
+    description: string;
+}
+/**
+ * Baseline file for performance tracking
+ */
+export interface BaselineFile {
+    version: number;
+    updatedAtIso: string;
+    node: string;
+    durationsSecByKey: Record<string, number>;
+}
+/**
+ * Environment detection results
+ */
+export interface EnvironmentInfo {
+    isCI: boolean;
+    isVercel: boolean;
+    isCIOrVercel: boolean;
+    nodeVersion: string;
+    platform: string;
+}
+/**
+ * Promotion metadata for flagging checks to be promoted to core
+ */
+export interface PromotionMetadata {
+    /** Flag to indicate this check should be promoted to core */
+    promoteToCore: boolean;
+    /** Suggested category for the core package */
+    proposedCategory?: string;
+    /** Reason for promotion */
+    reason?: string;
+    /** Author who flagged for promotion */
+    proposedBy?: string;
+    /** Date when flagged */
+    proposedAt?: string;
+}
+/**
+ * A check that has been submitted for promotion review
+ */
+export interface ProposedCheck {
+    /** Original app where the check came from */
+    sourceApp: string;
+    /** Original file path in the source app */
+    sourcePath: string;
+    /** The check metadata */
+    check: PreflightModule;
+    /** Promotion metadata */
+    promotion: PromotionMetadata;
+    /** When it was submitted */
+    submittedAt: string;
+    /** Status of the proposal */
+    status: "pending" | "approved" | "rejected";
+    /** Review notes */
+    reviewNotes?: string;
+}
+/**
+ * Manifest file for tracking proposed checks
+ */
+export interface ProposedManifest {
+    version: number;
+    lastUpdated: string;
+    checks: ProposedCheck[];
+}
+/**
+ * Get environment information
+ */
+export declare function getEnvironmentInfo(): EnvironmentInfo;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Core Types for Preflight System
+ *
+ * These types define the structure of preflight checks, findings, and reports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnvironmentInfo = getEnvironmentInfo;
+/**
+ * Get environment information
+ */
+function getEnvironmentInfo() {
+    return {
+        isCI: process.env.CI === "1" || process.env.CI === "true",
+        isVercel: process.env.VERCEL === "1" || process.env.VERCEL === "true",
+        isCIOrVercel: process.env.CI === "1" ||
+            process.env.CI === "true" ||
+            process.env.VERCEL === "1" ||
+            process.env.VERCEL === "true",
+        nodeVersion: process.version,
+        platform: process.platform,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA4MH,gDAYC;AAfD;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM;QACzD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;QACrE,YAAY,EACV,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG;YACtB,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM;YACzB,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG;YAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;QAC/B,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC"}