@empline/preflight 1.1.0

package/dist/checks/config/configuration-drift-detection.js

@@ -0,0 +1,286 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Configuration Drift Detection Preflight (BLOCKING)
+ *
+ * Detects hardcoded configuration values that should use centralized constants.
+ * Prevents configuration drift between different entry points (upload, import, API).
+ *
+ * CHECKS:
+ * 1. Pagination values - should use PAGINATION_DEFAULTS from limits.ts
+ * 2. Image quality values - should use IMAGE_QUALITY from image-variants-config.ts
+ * 3. AI model names - should use AI_MODELS from ai-models.ts
+ *
+ * Usage:
+ *   pnpm preflight:config-drift
+ *   pnpm preflight:config-drift --verbose
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+const console_chars_1 = require("../../utils/console-chars");
+const exclusions_1 = require("../../shared/exclusions");
+const fs = __importStar(require("fs"));
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const glob_1 = require("glob");
+// App-specific exclusions loaded from config
+let appExclusions = [];
+// METADATA - Required for plugin loader discovery
+exports.id = "config/configuration-drift-detection";
+exports.name = "Configuration Drift Detection";
+exports.description = "Detects hardcoded config values that should use centralized constants";
+exports.category = "config";
+exports.blocking = true;
+exports.tags = ["configuration", "drift", "constants", "pagination", "image-quality", "ai-models"];
+// ============================================================
+// CONFIGURATION FILES (Source of Truth)
+// ============================================================
+const CONFIG_FILES = [
+    "lib/constants/limits.ts",
+    "lib/constants/ai-models.ts",
+    "lib/image-variants-config.ts",
+    "lib/image-processing-config.ts",
+];
+// Files that are allowed to define constants
+const ALLOWED_DEFINITION_FILES = [
+    ...CONFIG_FILES,
+    // Type definition files
+    "**/*.d.ts",
+    // Test files
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    // Scripts
+    "scripts/**",
+];
+const DRIFT_PATTERNS = [
+    // Pagination drift
+    {
+        pattern: /(?:const|let|var)\s+(?:PAGE_SIZE|PAGINATION_DEFAULTS)\s*=\s*(?:\{|\d)/,
+        code: "local-pagination-constant",
+        message: "Local pagination constant shadows centralized config",
+        suggestion: "Import PAGINATION_DEFAULTS from @/lib/constants/limits",
+        severity: "error",
+        allowedIn: [/limits\.ts$/],
+    },
+    {
+        pattern: /pageSize\s*[=:]\s*(?:12|24|50|100)\b(?!\s*\*)/,
+        code: "hardcoded-page-size",
+        message: "Hardcoded page size value",
+        suggestion: "Use PAGINATION_DEFAULTS.PAGE_SIZE or PAGINATION_DEFAULTS.MOBILE_PAGE_SIZE",
+        severity: "warning",
+        allowedIn: [/limits\.ts$/, /\.test\.ts$/, /\.spec\.ts$/],
+    },
+    // Image quality drift
+    {
+        pattern: /quality:\s*(?:80|85|90|95|100)\b/,
+        code: "hardcoded-quality-int",
+        message: "Hardcoded image quality value (integer)",
+        suggestion: "Use IMAGE_QUALITY constants from @/lib/image-variants-config",
+        severity: "warning",
+        allowedIn: [/image-variants-config\.ts$/, /\.test\.ts$/],
+    },
+    {
+        pattern: /quality:\s*0\.(?:8|85|9|95)\b/,
+        code: "hardcoded-quality-decimal",
+        message: "Hardcoded image quality value (decimal)",
+        suggestion: "Use IMAGE_QUALITY.CLIENT_PREVIEW or IMAGE_QUALITY.CLIENT_COMPRESS",
+        severity: "warning",
+        allowedIn: [/image-variants-config\.ts$/, /\.test\.ts$/],
+    },
+    // AI model drift
+    {
+        pattern: /["']gpt-4o-mini["']/,
+        code: "hardcoded-gpt4o-mini",
+        message: "Hardcoded AI model name 'gpt-4o-mini'",
+        suggestion: "Use AI_MODELS.GPT_4O_MINI from @/lib/constants/ai-models",
+        severity: "error",
+        allowedIn: [/ai-models\.ts$/, /\.test\.ts$/],
+    },
+    {
+        pattern: /["']gpt-4o["'](?!-mini)/,
+        code: "hardcoded-gpt4o",
+        message: "Hardcoded AI model name 'gpt-4o'",
+        suggestion: "Use AI_MODELS.GPT_4O from @/lib/constants/ai-models",
+        severity: "error",
+        allowedIn: [/ai-models\.ts$/, /\.test\.ts$/],
+    },
+    // Max dimensions drift
+    {
+        pattern: /maxWidth:\s*(?:1200|2048|4096)\b/,
+        code: "hardcoded-max-width",
+        message: "Hardcoded max width value",
+        suggestion: "Use IMAGE_VARIANT_DIMENSIONS from @/lib/image-variants-config",
+        severity: "warning",
+        allowedIn: [/image-variants-config\.ts$/, /image-utils\.ts$/, /\.test\.ts$/],
+    },
+];
+// ============================================================
+// FILE SCANNING
+// ============================================================
+async function findFilesToCheck() {
+    const patterns = [
+        "lib/**/*.ts",
+        "app/**/*.ts",
+        "app/**/*.tsx",
+        "components/**/*.ts",
+        "components/**/*.tsx",
+        "hooks/**/*.ts",
+    ];
+    const allFiles = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: ["**/node_modules/**", "**/*.test.ts", "**/*.spec.ts", "**/*.d.ts"],
+        });
+        allFiles.push(...matches);
+    }
+    // Filter using centralized exclusions
+    return allFiles.filter((file) => !(0, exclusions_1.shouldExcludeFile)(file, appExclusions));
+}
+function isAllowedFile(filePath, pattern) {
+    if (!pattern.allowedIn)
+        return false;
+    return pattern.allowedIn.some((allowed) => allowed.test(filePath));
+}
+function checkFile(filePath, content) {
+    const issues = [];
+    const lines = content.split("\n");
+    for (const pattern of DRIFT_PATTERNS) {
+        // Skip if this file is allowed to have this pattern
+        if (isAllowedFile(filePath, pattern))
+            continue;
+        // Check if content matches the drift pattern
+        let match;
+        const regex = new RegExp(pattern.pattern.source, "g");
+        while ((match = regex.exec(content)) !== null) {
+            // Find line number
+            let lineNumber = 1;
+            let charCount = 0;
+            for (let i = 0; i < lines.length; i++) {
+                charCount += lines[i].length + 1;
+                if (charCount > match.index) {
+                    lineNumber = i + 1;
+                    break;
+                }
+            }
+            // Check for preflight-ignore comment on the line
+            const line = lines[lineNumber - 1] || "";
+            if (/preflight-ignore|config-drift-ignore/.test(line))
+                continue;
+            // Check for preflight-ignore comment on previous line
+            const prevLine = lines[lineNumber - 2] || "";
+            if (/preflight-ignore|config-drift-ignore/.test(prevLine))
+                continue;
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                severity: pattern.severity,
+                message: pattern.message,
+                suggestion: pattern.suggestion,
+                code: pattern.code,
+            });
+        }
+    }
+    return issues;
+}
+// ============================================================
+// MAIN
+// ============================================================
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const verbose = process.argv.includes("--verbose") || process.argv.includes("-v");
+    console.log(`${console_chars_1.emoji.search} Configuration Drift Detection Preflight`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    // Load app-specific exclusions
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    const files = await findFilesToCheck();
+    console.log(`Scanning ${files.length} files for configuration drift...\n`);
+    const allIssues = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            const issues = checkFile(file, content);
+            allIssues.push(...issues);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    // Group by severity
+    const errors = allIssues.filter((i) => i.severity === "error");
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} ERRORS (blocking):`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of errors) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            console.log("");
+        }
+    }
+    if (warnings.length > 0 && (verbose || errors.length === 0)) {
+        console.log(`${console_chars_1.emoji.warning}  WARNINGS:`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of warnings) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            if (verbose) {
+                console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+            console.log("");
+        }
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`Files scanned: ${files.length}`);
+    console.log(`Errors: ${errors.length}`);
+    console.log(`Warnings: ${warnings.length}`);
+    if (errors.length === 0 && warnings.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No configuration drift detected`);
+    }
+    console.log(`\n${console_chars_1.emoji.docs} Centralized configuration files:`);
+    for (const configFile of CONFIG_FILES) {
+        console.log(`   ${console_chars_1.chars.bullet} ${configFile}`);
+    }
+    console.log(`\n${console_chars_1.emoji.hint} Add // config-drift-ignore to skip specific lines`);
+    if (errors.length > 0) {
+        process.exit(1);
+    }
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=configuration-drift-detection.js.map

package/dist/checks/config/configuration-drift-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-drift-detection.js","sourceRoot":"","sources":["../../../src/checks/config/configuration-drift-detection.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsNH,kBAuEC;AA3RD,6DAAwE;AACxE,wDAA2E;AAC3E,uCAAyB;AAEzB,uFAAwF;AACxF,+BAA4B;AAE5B,6CAA6C;AAC7C,IAAI,aAAa,GAAa,EAAE,CAAC;AAEjC,kDAAkD;AAErC,QAAA,EAAE,GAAG,sCAAsC,CAAC;AAC5C,QAAA,IAAI,GAAG,+BAA+B,CAAC;AACvC,QAAA,WAAW,GAAG,uEAAuE,CAAC;AACtF,QAAA,QAAQ,GAAG,QAAQ,CAAC;AACpB,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,IAAI,GAAG,CAAC,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;AAWxG,+DAA+D;AAC/D,wCAAwC;AACxC,+DAA+D;AAE/D,MAAM,YAAY,GAAG;IACnB,yBAAyB;IACzB,4BAA4B;IAC5B,8BAA8B;IAC9B,gCAAgC;CACjC,CAAC;AAEF,6CAA6C;AAC7C,MAAM,wBAAwB,GAAG;IAC/B,GAAG,YAAY;IACf,wBAAwB;IACxB,WAAW;IACX,aAAa;IACb,cAAc;IACd,cAAc;IACd,UAAU;IACV,YAAY;CACb,CAAC;AAgBF,MAAM,cAAc,GAAmB;IACrC,mBAAmB;IACnB;QACE,OAAO,EAAE,uEAAuE;QAChF,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,sDAAsD;QAC/D,UAAU,EAAE,wDAAwD;QACpE,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,CAAC,aAAa,CAAC;KAC3B;IACD;QACE,OAAO,EAAE,+CAA+C;QACxD,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,2BAA2B;QACpC,UAAU,EAAE,2EAA2E;QACvF,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,aAAa,CAAC;KACzD;IAED,sBAAsB;IACtB;QACE,OAAO,EAAE,kCAAkC;QAC3C,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,yCAAyC;QAClD,UAAU,EAAE,8DAA8D;QAC1E,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,CAAC,4BAA4B,EAAE,aAAa,CAAC;KACzD;IACD;QACE,OAAO,EAAE,+BAA+B;QACxC,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,yCAAyC;QAClD,UAAU,EAAE,mEAAmE;QAC/E,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,CAAC,4BAA4B,EAAE,aAAa,CAAC;KACzD;IAED,iBAAiB;IACjB;QACE,OAAO,EAAE,qBAAqB;QAC9B,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,uCAAuC;QAChD,UAAU,EAAE,0DAA0D;QACtE,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,CAAC,gBAAgB,EAAE,aAAa,CAAC;KAC7C;IACD;QACE,OAAO,EAAE,yBAAyB;QAClC,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,kCAAkC;QAC3C,UAAU,EAAE,qDAAqD;QACjE,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,CAAC,gBAAgB,EAAE,aAAa,CAAC;KAC7C;IAED,uBAAuB;IACvB;QACE,OAAO,EAAE,kCAAkC;QAC3C,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,2BAA2B;QACpC,UAAU,EAAE,+DAA+D;QAC3E,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,CAAC,4BAA4B,EAAE,kBAAkB,EAAE,aAAa,CAAC;KAC7E;CACF,CAAC;AAEF,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAE/D,KAAK,UAAU,gBAAgB;IAC7B,MAAM,QAAQ,GAAG;QACf,aAAa;QACb,aAAa;QACb,cAAc;QACd,oBAAoB;QACpB,qBAAqB;QACrB,eAAe;KAChB,CAAC;IAEF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,IAAA,WAAI,EAAC,OAAO,EAAE;YAClC,MAAM,EAAE,CAAC,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,CAAC;SAC5E,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,sCAAsC;IACtC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAA,8BAAiB,EAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,OAAqB;IAC5D,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,OAAe;IAClD,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,oDAAoD;QACpD,IAAI,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC;YAAE,SAAS;QAE/C,6CAA6C;QAC7C,IAAI,KAAK,CAAC;QACV,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAEtD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9C,mBAAmB;YACnB,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;gBACjC,IAAI,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC5B,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;oBACnB,MAAM;gBACR,CAAC;YACH,CAAC;YAED,iDAAiD;YACjD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEhE,sDAAsD;YACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,sCAAsC,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAEpE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+DAA+D;AAC/D,OAAO;AACP,+DAA+D;AAExD,KAAK,UAAU,GAAG;IACvB,MAAM,QAAQ,GAAG,IAAA,6DAA+B,EAAC,YAAI,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAElF,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,MAAM,0CAA0C,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAExC,+BAA+B;IAC/B,aAAa,GAAG,MAAM,IAAA,0BAAa,EAAC,UAAE,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,MAAM,qCAAqC,CAAC,CAAC;IAE3E,MAAM,SAAS,GAAY,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAEnE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,KAAK,qBAAqB,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,OAAO,qBAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,aAAa,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,OAAO,qBAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,IAAI,mCAAmC,CAAC,CAAC;IAChE,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,IAAI,oDAAoD,CAAC,CAAC;IAEjF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAGD,yBAAyB;AACzB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/checks/config/env-completeness.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env tsx
+/**
+ * Environment Variable Completeness Preflight
+ *
+ * Ensures all environment variables used in code are:
+ * 1. Documented in .env.example
+ * 2. Have proper type definitions
+ * 3. Are validated at startup
+ *
+ * Usage:
+ *   pnpm preflight:env-completeness
+ *   pnpm preflight:env-completeness --verbose
+ */
+export declare const id = "config/env-completeness";
+export declare const name = "Env Completeness";
+export declare const category = "config";
+export declare const blocking = false;
+export declare const description = "Environment Variable Completeness Preflight";
+export declare const tags: string[];
+//# sourceMappingURL=env-completeness.d.ts.map

package/dist/checks/config/env-completeness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-completeness.d.ts","sourceRoot":"","sources":["../../../src/checks/config/env-completeness.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAUH,eAAO,MAAM,EAAE,4BAA4B,CAAC;AAC5C,eAAO,MAAM,IAAI,qBAAqB,CAAC;AACvC,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,gDAAgD,CAAC;AACzE,eAAO,MAAM,IAAI,UAAa,CAAC"}

package/dist/checks/config/env-completeness.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Environment Variable Completeness Preflight
+ *
+ * Ensures all environment variables used in code are:
+ * 1. Documented in .env.example
+ * 2. Have proper type definitions
+ * 3. Are validated at startup
+ *
+ * Usage:
+ *   pnpm preflight:env-completeness
+ *   pnpm preflight:env-completeness --verbose
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const fs = __importStar(require("fs"));
+const file_cache_1 = require("../../shared/file-cache");
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "config/env-completeness";
+exports.name = "Env Completeness";
+exports.category = "config";
+exports.blocking = false;
+exports.description = "Environment Variable Completeness Preflight";
+exports.tags = ["config"];
+const isVerbose = process.argv.includes("--verbose");
+console.log("🔐 Environment Variable Completeness Preflight");
+console.log((0, console_chars_1.createDivider)(60, "heavy"));
+const issues = [];
+// Known system env vars that don't need documentation
+const SYSTEM_ENV_VARS = new Set([
+    "NODE_ENV",
+    "VERCEL",
+    "VERCEL_ENV",
+    "VERCEL_URL",
+    "VERCEL_GIT_COMMIT_SHA",
+    "VERCEL_GIT_COMMIT_MESSAGE",
+    "VERCEL_GIT_COMMIT_AUTHOR_LOGIN",
+    "VERCEL_GIT_COMMIT_AUTHOR_NAME",
+    "VERCEL_GIT_PREVIOUS_SHA",
+    "VERCEL_GIT_PROVIDER",
+    "VERCEL_GIT_REPO_ID",
+    "VERCEL_GIT_REPO_OWNER",
+    "VERCEL_GIT_REPO_SLUG",
+    "CI",
+    "HOME",
+    "PATH",
+    "PWD",
+    "SHELL",
+    "USER",
+    "HOSTNAME",
+    "PORT",
+    "TZ",
+]);
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    // 1. Find all env var usages in code
+    const envUsages = new Map();
+    const files = await file_cache_1.fileCache.getFiles("{app,lib,components,scripts}/**/*.{ts,tsx,js,jsx}", {
+        ignore: ["node_modules/**", ".next/**", "**/*.test.*", "**/*.spec.*"],
+    });
+    console.log(`\n${console_chars_1.emoji.search} Scanning ${files.length} files for env var usage...\n`);
+    // Patterns to find env var usage
+    const patterns = [/process\.env\.(\w+)/g, /process\.env\[['"](\w+)['"]\]/g, /env\.(\w+)/g];
+    for (const file of files) {
+        const content = fs.readFileSync(file, "utf-8");
+        const lines = content.split("\n");
+        const relativePath = path.relative(process.cwd(), file);
+        for (const pattern of patterns) {
+            let match;
+            const regex = new RegExp(pattern.source, pattern.flags);
+            while ((match = regex.exec(content)) !== null) {
+                const varName = match[1];
+                // Skip system vars
+                if (SYSTEM_ENV_VARS.has(varName))
+                    continue;
+                const lineNum = content.substring(0, match.index).split("\n").length;
+                const usages = envUsages.get(varName) || [];
+                usages.push({ variable: varName, file: relativePath, line: lineNum });
+                envUsages.set(varName, usages);
+            }
+        }
+    }
+    console.log(`${console_chars_1.emoji.chart} Found ${envUsages.size} unique environment variables\n`);
+    // 2. Read .env.example to see what's documented
+    const envExamplePath = path.join(process.cwd(), ".env.example");
+    const documentedVars = new Set();
+    if (fs.existsSync(envExamplePath)) {
+        const envExample = fs.readFileSync(envExamplePath, "utf-8");
+        const varPattern = /^(\w+)=/gm;
+        let match;
+        while ((match = varPattern.exec(envExample)) !== null) {
+            documentedVars.add(match[1]);
+        }
+        console.log(`${console_chars_1.emoji.file} .env.example documents ${documentedVars.size} variables\n`);
+    }
+    else {
+        console.log(`${console_chars_1.emoji.warning}  No .env.example file found\n`);
+    }
+    // 3. Check for undocumented variables
+    for (const [varName, usages] of envUsages) {
+        if (!documentedVars.has(varName)) {
+            issues.push({
+                variable: varName,
+                type: "warning",
+                message: `Environment variable not documented in .env.example`,
+                usages,
+            });
+        }
+    }
+    // 4. Check for documented but unused variables
+    for (const varName of documentedVars) {
+        if (!envUsages.has(varName) && !SYSTEM_ENV_VARS.has(varName)) {
+            // This might be used in config files or external tools
+            if (isVerbose) {
+                console.log(`${console_chars_1.emoji.info}  ${varName} is documented but not found in code (may be used elsewhere)`);
+            }
+        }
+    }
+    // Report results
+    if (issues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} All environment variables are properly documented`);
+        process.exit(0);
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.clipboard} Undocumented Environment Variables:`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    for (const issue of issues) {
+        console.log(`\n${console_chars_1.emoji.warning}  ${issue.variable}`);
+        console.log(`   ${issue.message}`);
+        console.log(`   Used in ${issue.usages.length} file(s):`);
+        const displayUsages = isVerbose ? issue.usages : issue.usages.slice(0, 3);
+        for (const usage of displayUsages) {
+            console.log(`   - ${usage.file}:${usage.line}`);
+        }
+        if (!isVerbose && issue.usages.length > 3) {
+            console.log(`   ... and ${issue.usages.length - 3} more`);
+        }
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Documented:    ${documentedVars.size}`);
+    console.log(`   Used in code:  ${envUsages.size}`);
+    console.log(`   Undocumented:  ${issues.length}`);
+    console.log(`\n${console_chars_1.emoji.clipboard} To fix, add these to .env.example:`);
+    for (const issue of issues) {
+        console.log(`   ${issue.variable}=`);
+    }
+    console.log(`\n${console_chars_1.emoji.warning}  PASSED with warnings`);
+    console.log("   Document environment variables in .env.example for team clarity.");
+    process.exit(0);
+}
+main().catch((error) => {
+    console.error("Error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=env-completeness.js.map

package/dist/checks/config/env-completeness.js.map

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

package/dist/checks/coverage-gap-analysis.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env tsx
+/**
+ * Missing Test Coverage Preflight
+ *
+ * Scans the 'app' directory for pages and attempts to find corresponding
+ * E2E tests in the 'tests/e2e' directory.
+ *
+ * Algorithm:
+ * 1. Find all `page.tsx` files.
+ * 2. Generate "expected" test names based on the route path.
+ *    - app/store/shipping/page.tsx -> store-shipping.spec.ts, shipping.spec.ts
+ * 3. Search 'tests/e2e' for matching files.
+ * 4. Report pages with no likely test coverage.
+ */
+export declare const id = "misc/coverage-gap-analysis";
+export declare const name = "Coverage Gap Analysis";
+export declare const category = "misc";
+export declare const blocking = false;
+export declare const description = "Missing Test Coverage Preflight";
+export declare const tags: string[];
+//# sourceMappingURL=coverage-gap-analysis.d.ts.map

package/dist/checks/coverage-gap-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-gap-analysis.d.ts","sourceRoot":"","sources":["../../src/checks/coverage-gap-analysis.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAYH,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAC5C,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,oCAAoC,CAAC;AAC7D,eAAO,MAAM,IAAI,UAAW,CAAC"}