@empline/preflight 1.1.3 → 1.1.4

package/dist/checks/card-processing/dimension-variance-blocking.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+export declare const id = "card-processing/dimension-variance-blocking";
+export declare const name = "Dimension Variance Blocking Validation";
+export declare const description = "Validates that dimension variance checking is implemented across ALL import paths to block mismatched front/back images";
+export declare const category = "card-processing";
+export declare const blocking = true;
+export declare const tags: string[];
+//# sourceMappingURL=dimension-variance-blocking.d.ts.map

package/dist/checks/card-processing/dimension-variance-blocking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-variance-blocking.d.ts","sourceRoot":"","sources":["../../../src/checks/card-processing/dimension-variance-blocking.ts"],"names":[],"mappings":";AAWA,eAAO,MAAM,EAAE,gDAAgD,CAAC;AAChE,eAAO,MAAM,IAAI,2CAA2C,CAAC;AAC7D,eAAO,MAAM,WAAW,4HAA4H,CAAC;AACrJ,eAAO,MAAM,QAAQ,oBAAoB,CAAC;AAC1C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAoF,CAAC"}

package/dist/checks/card-processing/dimension-variance-blocking.js

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+const fs_1 = __importDefault(require("fs"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+const exclusions_1 = require("../../shared/exclusions");
+// App-specific exclusions loaded from config
+let appExclusions = [];
+// METADATA - Required for plugin loader discovery
+exports.id = "card-processing/dimension-variance-blocking";
+exports.name = "Dimension Variance Blocking Validation";
+exports.description = "Validates that dimension variance checking is implemented across ALL import paths to block mismatched front/back images";
+exports.category = "card-processing";
+exports.blocking = true;
+exports.tags = ["card-processing", "images", "dimension-variance", "imports", "quality-control"];
+// Import routes that MUST have dimension variance blocking
+const IMPORT_ROUTES_WITH_FRONT_BACK_IMAGES = [
+    {
+        path: "app/api/store/integrations/woocommerce/preview-images/route.ts",
+        name: "WooCommerce Preview",
+        requiresBlocking: true,
+    },
+    {
+        path: "app/api/store/integrations/woocommerce/import/route.ts",
+        name: "WooCommerce Import",
+        requiresBlocking: true,
+    },
+    {
+        path: "app/api/store/integrations/shopify/preview-images/route.ts",
+        name: "Shopify Preview",
+        requiresBlocking: true,
+    },
+    {
+        path: "app/api/store/integrations/csv/import/route.ts",
+        name: "CSV Import",
+        requiresBlocking: true,
+    },
+];
+// UI components that must use "blocked" mode (not "acknowledge" mode)
+const UI_COMPONENTS_REQUIRING_BLOCKED_MODE = [
+    {
+        path: "components/upload/paired-card-slots/PairedCardSlots.tsx",
+        name: "Direct Upload (PairedCardSlots)",
+        // This is the direct upload component - must hard block
+    },
+    {
+        path: "components/woocommerce/steps/ImageReviewStep.tsx",
+        name: "WooCommerce Image Review",
+    },
+    {
+        path: "components/shopify/steps/ImageReviewStep.tsx",
+        name: "Shopify Image Review",
+    },
+    {
+        path: "components/shared/integration/ImageReviewStep.tsx",
+        name: "Shared Image Review",
+    },
+];
+// Routes that don't process front/back pairs (can skip)
+const ROUTES_WITHOUT_FRONT_BACK = [
+    "app/api/store/integrations/ebay/import/route.ts", // Placeholder
+    "app/api/store/integrations/shopify/import/route.ts", // Just fetches data
+    "app/api/store/integrations/amazon/route.ts", // Config management only
+];
+async function main() {
+    console.log(`\n${console_chars_1.emoji.ruler || "[RULER]"} DIMENSION VARIANCE BLOCKING VALIDATION`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    // Load centralized exclusions
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    const issues = [];
+    const warnings = [];
+    // Check 1: Verify DIMENSION_VARIANCE_THRESHOLD constant exists
+    console.log(`\n${console_chars_1.emoji.search || "[SEARCH]"} Checking threshold constant...`);
+    const constantsPath = "lib/image-processing-constants.ts";
+    if (fs_1.default.existsSync(constantsPath)) {
+        const constantsContent = fs_1.default.readFileSync(constantsPath, "utf-8");
+        if (!constantsContent.includes("DIMENSION_VARIANCE_THRESHOLD")) {
+            issues.push(`${constantsPath}: Missing DIMENSION_VARIANCE_THRESHOLD constant`);
+        }
+        else {
+            // Extract the value
+            const match = constantsContent.match(/DIMENSION_VARIANCE_THRESHOLD\s*=\s*([\d.]+)/);
+            if (match) {
+                const threshold = parseFloat(match[1]);
+                console.log(`   ${console_chars_1.emoji.success || "[OK]"} DIMENSION_VARIANCE_THRESHOLD = ${threshold * 100}%`);
+                if (threshold > 0.05) {
+                    warnings.push(`Threshold ${threshold * 100}% may be too permissive (recommended: 3%)`);
+                }
+            }
+        }
+    }
+    else {
+        issues.push(`${constantsPath}: File not found!`);
+    }
+    // Check 2: Validate API routes have dimension variance checking
+    console.log(`\n${console_chars_1.emoji.search || "[SEARCH]"} Checking API routes for dimension variance...`);
+    for (const route of IMPORT_ROUTES_WITH_FRONT_BACK_IMAGES) {
+        if ((0, exclusions_1.shouldExcludeFile)(route.path, appExclusions)) {
+            console.log(`   ${console_chars_1.emoji.skip || "[SKIP]"} ${route.name} (excluded)`);
+            continue;
+        }
+        if (!fs_1.default.existsSync(route.path)) {
+            warnings.push(`${route.path}: File not found`);
+            continue;
+        }
+        const content = fs_1.default.readFileSync(route.path, "utf-8");
+        // Check for threshold import or usage
+        const hasThresholdImport = /DIMENSION_VARIANCE_THRESHOLD/i.test(content);
+        // Check for variance calculation
+        const hasVarianceCalc = /calculateDimensionVariance|dimensionVariance|variancePercent|widthVariance.*heightVariance/i.test(content);
+        // Check for variance flagging
+        const hasVarianceFlag = /dimensionVarianceFlag|variance\.flag|varianceResult/i.test(content);
+        if (!hasThresholdImport) {
+            issues.push(`${route.name} (${route.path}): Missing DIMENSION_VARIANCE_THRESHOLD usage`);
+        }
+        if (!hasVarianceCalc) {
+            issues.push(`${route.name} (${route.path}): Missing dimension variance calculation`);
+        }
+        if (!hasVarianceFlag) {
+            issues.push(`${route.name} (${route.path}): Missing dimension variance flagging`);
+        }
+        if (hasThresholdImport && hasVarianceCalc && hasVarianceFlag) {
+            console.log(`   ${console_chars_1.emoji.success || "[OK]"} ${route.name}`);
+        }
+    }
+    // Check 3: Validate UI components use "blocked" mode (not "acknowledge")
+    console.log(`\n${console_chars_1.emoji.search || "[SEARCH]"} Checking UI components for hard blocking...`);
+    for (const component of UI_COMPONENTS_REQUIRING_BLOCKED_MODE) {
+        if ((0, exclusions_1.shouldExcludeFile)(component.path, appExclusions)) {
+            console.log(`   ${console_chars_1.emoji.skip || "[SKIP]"} ${component.name} (excluded)`);
+            continue;
+        }
+        if (!fs_1.default.existsSync(component.path)) {
+            warnings.push(`${component.path}: File not found`);
+            continue;
+        }
+        const content = fs_1.default.readFileSync(component.path, "utf-8");
+        // Check if component handles dimension variance
+        const handlesDimensionVariance = /variancePercent|dimensionVariance|variance\.flag|variance\.percent/i.test(content);
+        if (!handlesDimensionVariance) {
+            // It's OK if component doesn't deal with variance at all
+            console.log(`   ${console_chars_1.emoji.info || "[INFO]"} ${component.name} (no variance handling)`);
+            continue;
+        }
+        // If it handles variance, ensure it uses hard blocking (not acknowledgment)
+        const usesAcknowledgment = /acknowledgedVariance|mode\s*=\s*["']acknowledge["']|onAcknowledgeChange/i.test(content);
+        const usesBlockedMode = /mode\s*=\s*["']blocked["']|cannot be imported|Cannot Submit/i.test(content);
+        const hasVarianceGating = /disabled.*variance|variance.*disabled|\bsubmitDisabled\b/i.test(content);
+        if (usesAcknowledgment && !usesBlockedMode) {
+            issues.push(`${component.name} (${component.path}): Uses acknowledgment mode for dimension variance! ` +
+                `Must use mode="blocked" to prevent submission of mismatched images.`);
+        }
+        // Check for submit button disabling when variance detected
+        if (handlesDimensionVariance && !hasVarianceGating && !usesBlockedMode) {
+            warnings.push(`${component.name} (${component.path}): Handles variance but may not disable submit button. Verify manually.`);
+        }
+        if (handlesDimensionVariance && (usesBlockedMode || hasVarianceGating) && !usesAcknowledgment) {
+            console.log(`   ${console_chars_1.emoji.success || "[OK]"} ${component.name} (hard blocking)`);
+        }
+        else if (handlesDimensionVariance) {
+            console.log(`   ${console_chars_1.emoji.warning || "[WARN]"} ${component.name} (needs review)`);
+        }
+    }
+    // Check 4: Verify DimensionVarianceWarning component supports "blocked" mode
+    console.log(`\n${console_chars_1.emoji.search || "[SEARCH]"} Checking shared warning component...`);
+    const warningComponentPath = "components/shared/integration/DimensionVarianceWarning.tsx";
+    if (fs_1.default.existsSync(warningComponentPath)) {
+        const content = fs_1.default.readFileSync(warningComponentPath, "utf-8");
+        const hasBlockedMode = /mode\s*[:=]\s*["']blocked["']/i.test(content);
+        const hasAcknowledgeMode = /mode\s*[:=]\s*["']acknowledge["']/i.test(content);
+        const hasDefaultBlocked = /defaultVariants.*blocked|mode\s*=\s*["']blocked["']/i.test(content);
+        if (!hasBlockedMode) {
+            issues.push(`${warningComponentPath}: Missing "blocked" mode support`);
+        }
+        else {
+            console.log(`   ${console_chars_1.emoji.success || "[OK]"} DimensionVarianceWarning supports blocked mode`);
+        }
+        // Warn if "acknowledge" mode is still the default
+        if (hasAcknowledgeMode && !hasDefaultBlocked) {
+            warnings.push(`${warningComponentPath}: "acknowledge" mode should not be the default. ` +
+                `Consider making "blocked" the default to enforce hard blocking.`);
+        }
+    }
+    else {
+        issues.push(`${warningComponentPath}: Shared component not found!`);
+    }
+    // Check 5: Scan for any NEW import routes that might need variance checking
+    console.log(`\n${console_chars_1.emoji.search || "[SEARCH]"} Scanning for potential new import routes...`);
+    const allImportRoutes = await (0, glob_1.glob)("app/api/**/import/**/route.ts", {
+        ignore: ["node_modules/**", ".next/**"],
+    });
+    const allPreviewRoutes = await (0, glob_1.glob)("app/api/**/preview-images/**/route.ts", {
+        ignore: ["node_modules/**", ".next/**"],
+    });
+    const allRoutes = [...new Set([...allImportRoutes, ...allPreviewRoutes])];
+    for (const routePath of allRoutes) {
+        // Skip known routes
+        if (IMPORT_ROUTES_WITH_FRONT_BACK_IMAGES.some(r => r.path === routePath))
+            continue;
+        if (ROUTES_WITHOUT_FRONT_BACK.includes(routePath))
+            continue;
+        if ((0, exclusions_1.shouldExcludeFile)(routePath, appExclusions))
+            continue;
+        const content = fs_1.default.readFileSync(routePath, "utf-8");
+        // Check if this route processes images (likely front/back pairs)
+        const hasImageProcessing = /generateMultipleImageVariants|ImageBorderResolution|processImage|frontImage.*backImage|backImage.*frontImage/i.test(content);
+        const hasMultipleImages = /images\[0\].*images\[1\]|frontImageUrl.*backImageUrl|\.images/i.test(content);
+        if (hasImageProcessing || hasMultipleImages) {
+            const hasVarianceCheck = /DIMENSION_VARIANCE_THRESHOLD|dimensionVariance|calculateDimensionVariance/i.test(content);
+            if (!hasVarianceCheck) {
+                warnings.push(`${routePath}: New import route with image processing but no dimension variance check! ` +
+                    `Add variance checking or add to ROUTES_WITHOUT_FRONT_BACK if not applicable.`);
+            }
+        }
+    }
+    // Summary
+    console.log(`\n${console_chars_1.emoji.chart || "[CHART]"} Summary:`);
+    console.log(`   API routes checked: ${IMPORT_ROUTES_WITH_FRONT_BACK_IMAGES.length}`);
+    console.log(`   UI components checked: ${UI_COMPONENTS_REQUIRING_BLOCKED_MODE.length}`);
+    console.log(`   Additional routes scanned: ${allRoutes.length}`);
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning || "[WARN]"} Warnings (${warnings.length}):`);
+        for (const warning of warnings) {
+            console.log(`   - ${warning}`);
+        }
+    }
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success || "[OK]"} DIMENSION VARIANCE BLOCKING VALIDATION PASSED`);
+        console.log(`\nAll import paths enforce hard blocking when front/back dimensions don't match.`);
+        process.exit(0);
+    }
+    console.log(`\n${console_chars_1.emoji.error || "[ERROR]"} Found ${issues.length} issues:`);
+    for (const issue of issues) {
+        console.log(`   - ${issue}`);
+    }
+    console.log(`\n${console_chars_1.emoji.error || "[ERROR]"} DIMENSION VARIANCE BLOCKING VALIDATION FAILED`);
+    console.log(`\nTo fix:`);
+    console.log(`1. Import DIMENSION_VARIANCE_THRESHOLD from @/lib/image-processing-constants`);
+    console.log(`2. Calculate dimension variance between front and back images after processing`);
+    console.log(`3. Flag products with variance > threshold (currently 3%)`);
+    console.log(`4. BLOCK submission of flagged products (no acknowledgment/bypass option)`);
+    console.log(`5. Use DimensionVarianceWarning with mode="blocked" in UI components`);
+    console.log(`\nPolicy: Users CANNOT import cards with mismatched front/back dimensions.`);
+    console.log(`This ensures image quality consistency in the catalog.`);
+    process.exit(1);
+}
+main().catch((err) => {
+    console.error(`${console_chars_1.emoji.error || "[ERROR]"} Preflight failed:`, err);
+    process.exit(1);
+});
+//# sourceMappingURL=dimension-variance-blocking.js.map

package/dist/checks/card-processing/dimension-variance-blocking.js.map

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

package/dist/checks/card-processing/edge-detection-integration.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+export declare const id = "card-processing/edge-detection-integration";
+export declare const name = "Edge Detection Integration Validation";
+export declare const description = "Validates that edge detection is properly integrated across all image import flows";
+export declare const category = "card-processing";
+export declare const blocking = true;
+export declare const tags: string[];
+//# sourceMappingURL=edge-detection-integration.d.ts.map

package/dist/checks/card-processing/edge-detection-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-detection-integration.d.ts","sourceRoot":"","sources":["../../../src/checks/card-processing/edge-detection-integration.ts"],"names":[],"mappings":";AAWA,eAAO,MAAM,EAAE,+CAA+C,CAAC;AAC/D,eAAO,MAAM,IAAI,0CAA0C,CAAC;AAC5D,eAAO,MAAM,WAAW,uFAAuF,CAAC;AAChH,eAAO,MAAM,QAAQ,oBAAoB,CAAC;AAC1C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAA4E,CAAC"}

package/dist/checks/card-processing/edge-detection-integration.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+const fs_1 = __importDefault(require("fs"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+const exclusions_1 = require("../../shared/exclusions");
+// App-specific exclusions loaded from config
+let appExclusions = [];
+// METADATA - Required for plugin loader discovery
+exports.id = "card-processing/edge-detection-integration";
+exports.name = "Edge Detection Integration Validation";
+exports.description = "Validates that edge detection is properly integrated across all image import flows";
+exports.category = "card-processing";
+exports.blocking = true;
+exports.tags = ["card-processing", "images", "edge-detection", "imports", "integration"];
+/**
+ * Edge Detection Integration Validation
+ *
+ * Ensures that all import routes that process images also include edge detection analysis.
+ * This prevents regression where new import routes might skip edge detection.
+ *
+ * Required patterns in import routes with image processing:
+ * 1. Must import analyzeEdgeDetection from @/lib/edge-detection-analyzer
+ * 2. Must call analyzeEdgeDetection or analyzeEdgeDetectionForUrls
+ * 3. Must store edge warnings in metadata
+ */
+// Import routes that should have edge detection
+const IMPORT_ROUTES_WITH_IMAGE_PROCESSING = [
+    "app/api/store/integrations/woocommerce/import/route.ts",
+    "app/api/store/integrations/woocommerce/preview-images/route.ts",
+    "app/api/store/integrations/csv/import/route.ts",
+];
+// Routes that are placeholders or don't process images (can skip)
+const PLACEHOLDER_ROUTES = [
+    "app/api/store/integrations/ebay/import/route.ts", // Placeholder - returns empty array
+    "app/api/store/integrations/shopify/import/route.ts", // Just fetches data, doesn't create listings
+    "app/api/store/integrations/shopify/import-products/route.ts", // Edge detection TODO - preview step handles image quality
+    "app/api/store/integrations/amazon/route.ts", // Config management only
+];
+async function main() {
+    console.log(`\n${console_chars_1.emoji.ruler || "[RULER]"} EDGE DETECTION INTEGRATION VALIDATION`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    // Load centralized exclusions
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    const issues = [];
+    const warnings = [];
+    // Check required import routes
+    console.log(`\n${console_chars_1.emoji.search || "[SEARCH]"} Checking import routes for edge detection...`);
+    for (const routePath of IMPORT_ROUTES_WITH_IMAGE_PROCESSING) {
+        if ((0, exclusions_1.shouldExcludeFile)(routePath, appExclusions)) {
+            console.log(`   ${console_chars_1.emoji.skip || "[SKIP]"} ${routePath} (excluded)`);
+            continue;
+        }
+        if (!fs_1.default.existsSync(routePath)) {
+            warnings.push(`${routePath}: File not found`);
+            continue;
+        }
+        const content = fs_1.default.readFileSync(routePath, "utf-8");
+        // Check for edge detection import
+        const hasEdgeImport = /import.*analyzeEdgeDetection.*from.*edge-detection-analyzer/i.test(content);
+        // Check for edge detection call
+        const hasEdgeCall = /analyzeEdgeDetection\s*\(|analyzeEdgeDetectionForUrls\s*\(/i.test(content);
+        // Check for edge warnings storage
+        const hasEdgeStorage = /edgeDetectionWarnings|edgeWarnings|edgeAnalysis/i.test(content);
+        if (!hasEdgeImport) {
+            issues.push(`${routePath}: Missing edge detection import (analyzeEdgeDetection from @/lib/edge-detection-analyzer)`);
+        }
+        if (!hasEdgeCall) {
+            issues.push(`${routePath}: Missing edge detection analysis call`);
+        }
+        if (!hasEdgeStorage) {
+            issues.push(`${routePath}: Missing edge warnings storage in metadata`);
+        }
+        if (hasEdgeImport && hasEdgeCall && hasEdgeStorage) {
+            console.log(`   ${console_chars_1.emoji.success || "[OK]"} ${routePath}`);
+        }
+    }
+    // Check for new import routes that might need edge detection
+    console.log(`\n${console_chars_1.emoji.search || "[SEARCH]"} Scanning for potential new import routes...`);
+    const allImportRoutes = await (0, glob_1.glob)("app/api/**/import/**/route.ts", {
+        ignore: ["node_modules/**", ".next/**"],
+    });
+    const integrationRoutes = await (0, glob_1.glob)("app/api/store/integrations/**/route.ts", {
+        ignore: ["node_modules/**", ".next/**"],
+    });
+    const allRoutes = [...new Set([...allImportRoutes, ...integrationRoutes])];
+    for (const routePath of allRoutes) {
+        // Normalize path separators for cross-platform compatibility
+        const normalizedPath = routePath.replace(/\\/g, "/");
+        // Skip known routes
+        if (IMPORT_ROUTES_WITH_IMAGE_PROCESSING.includes(normalizedPath))
+            continue;
+        if (PLACEHOLDER_ROUTES.includes(normalizedPath))
+            continue;
+        if ((0, exclusions_1.shouldExcludeFile)(normalizedPath, appExclusions))
+            continue;
+        const content = fs_1.default.readFileSync(routePath, "utf-8");
+        // Check if this route processes images
+        const hasImageProcessing = /generateMultipleImageVariants|ImageBorderResolution|processImage/i.test(content);
+        const hasImageUrls = /imageUrls|imageUrl|\.images/i.test(content);
+        if (hasImageProcessing && hasImageUrls) {
+            const hasEdgeDetection = /analyzeEdgeDetection|edgeDetectionWarnings/i.test(content);
+            if (!hasEdgeDetection) {
+                issues.push(`${routePath}: New import route with image processing but no edge detection! Add edge detection or add to PLACEHOLDER_ROUTES if not applicable.`);
+            }
+        }
+    }
+    // Check that edge-detection-analyzer exists and has required exports
+    console.log(`\n${console_chars_1.emoji.search || "[SEARCH]"} Validating edge detection library...`);
+    const analyzerPath = "lib/edge-detection-analyzer.ts";
+    if (fs_1.default.existsSync(analyzerPath)) {
+        const analyzerContent = fs_1.default.readFileSync(analyzerPath, "utf-8");
+        const requiredExports = [
+            "analyzeEdgeDetection",
+            "EdgeAnalysisResult",
+            "EdgeReliability",
+            "EdgeConcernReason",
+        ];
+        for (const exportName of requiredExports) {
+            const hasExport = new RegExp(`export\\s+(async\\s+)?function\\s+${exportName}|export\\s+(type|interface)\\s+${exportName}`, "i").test(analyzerContent);
+            if (!hasExport) {
+                issues.push(`${analyzerPath}: Missing required export: ${exportName}`);
+            }
+        }
+        console.log(`   ${console_chars_1.emoji.success || "[OK]"} Edge detection library validated`);
+    }
+    else {
+        issues.push(`${analyzerPath}: Edge detection library not found!`);
+    }
+    // Check shared components exist
+    console.log(`\n${console_chars_1.emoji.search || "[SEARCH]"} Validating shared edge detection components...`);
+    const sharedComponents = [
+        "components/shared/integration/EdgeDetectionWarning.tsx",
+        "components/shared/integration/DimensionVarianceWarning.tsx",
+    ];
+    for (const componentPath of sharedComponents) {
+        if (fs_1.default.existsSync(componentPath)) {
+            console.log(`   ${console_chars_1.emoji.success || "[OK]"} ${componentPath}`);
+        }
+        else {
+            issues.push(`${componentPath}: Shared component not found!`);
+        }
+    }
+    // Summary
+    console.log(`\n${console_chars_1.emoji.chart || "[CHART]"} Summary:`);
+    console.log(`   Import routes checked: ${IMPORT_ROUTES_WITH_IMAGE_PROCESSING.length}`);
+    console.log(`   Additional routes scanned: ${allRoutes.length}`);
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning || "[WARN]"} Warnings (${warnings.length}):`);
+        for (const warning of warnings) {
+            console.log(`   - ${warning}`);
+        }
+    }
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success || "[OK]"} EDGE DETECTION INTEGRATION VALIDATION PASSED`);
+        process.exit(0);
+    }
+    console.log(`\n${console_chars_1.emoji.error || "[ERROR]"} Found ${issues.length} issues:`);
+    for (const issue of issues) {
+        console.log(`   - ${issue}`);
+    }
+    console.log(`\n${console_chars_1.emoji.error || "[ERROR]"} EDGE DETECTION INTEGRATION VALIDATION FAILED`);
+    console.log(`\nTo fix:`);
+    console.log(`1. Ensure all import routes that process images include edge detection`);
+    console.log(`2. Import analyzeEdgeDetection from @/lib/edge-detection-analyzer`);
+    console.log(`3. Call analyzeEdgeDetection(buffer) or analyzeEdgeDetectionForUrls(urls)`);
+    console.log(`4. Store results in metadata.edgeDetectionWarnings`);
+    console.log(`5. If route is a placeholder, add it to PLACEHOLDER_ROUTES in this preflight`);
+    process.exit(1);
+}
+main().catch((err) => {
+    console.error(`${console_chars_1.emoji.error || "[ERROR]"} Preflight failed:`, err);
+    process.exit(1);
+});
+//# sourceMappingURL=edge-detection-integration.js.map

package/dist/checks/card-processing/edge-detection-integration.js.map

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

package/dist/checks/card-processing/front-back-detection-validation.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+export declare const id = "card-processing/front-back-detection-validation";
+export declare const name = "Front/Back Detection Validation";
+export declare const description = "Validates front/back detection is integrated into single AI call";
+export declare const category = "card-processing";
+export declare const blocking = true;
+export declare const tags: string[];
+//# sourceMappingURL=front-back-detection-validation.d.ts.map

package/dist/checks/card-processing/front-back-detection-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"front-back-detection-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/card-processing/front-back-detection-validation.ts"],"names":[],"mappings":";AAaA,eAAO,MAAM,EAAE,oDAAoD,CAAC;AACpE,eAAO,MAAM,IAAI,oCAAoC,CAAC;AACtD,eAAO,MAAM,WAAW,qEAAqE,CAAC;AAC9F,eAAO,MAAM,QAAQ,oBAAoB,CAAC;AAC1C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAmD,CAAC"}

package/dist/checks/card-processing/front-back-detection-validation.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+/**
+ * Front/Back Detection Validation Preflight
+ *
+ * Enforces the "iron-clad" rule: when a back image exists, orientation detection
+ * must be integrated into the *same* AI call (no extra OpenAI calls).
+ */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+// METADATA - Required for plugin loader discovery
+exports.id = "card-processing/front-back-detection-validation";
+exports.name = "Front/Back Detection Validation";
+exports.description = "Validates front/back detection is integrated into single AI call";
+exports.category = "card-processing";
+exports.blocking = true;
+exports.tags = ["card-processing", "ai", "images", "detection"];
+function findFunctionBlock(content, functionName) {
+    const idx = content.indexOf(`async ${functionName}`);
+    if (idx === -1)
+        return null;
+    // Naive brace matching from first '{' after signature.
+    const startBrace = content.indexOf("{", idx);
+    if (startBrace === -1)
+        return null;
+    let depth = 0;
+    for (let i = startBrace; i < content.length; i++) {
+        const ch = content[i];
+        if (ch === "{")
+            depth++;
+        if (ch === "}")
+            depth--;
+        if (depth === 0) {
+            return content.slice(startBrace, i + 1);
+        }
+    }
+    return null;
+}
+function countOccurrences(haystack, needle) {
+    return (haystack.match(new RegExp(needle.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g")) || [])
+        .length;
+}
+function main() {
+    console.log(`\n${console_chars_1.emoji.search} FRONT/BACK DETECTION VALIDATION`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    const visionServicePath = path_1.default.join(process.cwd(), "lib", "vision", "service.ts");
+    if (!fs_1.default.existsSync(visionServicePath)) {
+        console.error(`${console_chars_1.emoji.error} Missing lib/vision/service.ts`);
+        process.exit(1);
+    }
+    const content = fs_1.default.readFileSync(visionServicePath, "utf8");
+    const block = findFunctionBlock(content, "analyzeCard");
+    if (!block) {
+        console.error(`${console_chars_1.emoji.error} Could not locate analyzeCard() in lib/vision/service.ts`);
+        process.exit(1);
+    }
+    const openAiCallCount = countOccurrences(block, "openai.chat.completions.create");
+    if (openAiCallCount > 1) {
+        console.error(`${console_chars_1.emoji.error} analyzeCard() contains ${openAiCallCount} OpenAI calls. Must be exactly 1.`);
+        process.exit(1);
+    }
+    // Orientation must be included in the prompt/response contract.
+    const hasOrientationInstructions = /imageOrientation/.test(block);
+    if (!hasOrientationInstructions) {
+        console.warn(`${console_chars_1.emoji.warning} analyzeCard() does not reference imageOrientation in the prompt/parse path (verify orientation is still integrated).`);
+    }
+    console.log(`${console_chars_1.emoji.success} Front/back detection validation passed (single-call enforced).`);
+    process.exit(0);
+}
+try {
+    main();
+}
+catch (err) {
+    console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+    process.exit(1);
+}
+//# sourceMappingURL=front-back-detection-validation.js.map

package/dist/checks/card-processing/front-back-detection-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"front-back-detection-validation.js","sourceRoot":"","sources":["../../../src/checks/card-processing/front-back-detection-validation.ts"],"names":[],"mappings":"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"}

package/dist/checks/card-processing/image-deskew-system.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+export declare const id = "card-processing/image-deskew-system";
+export declare const name = "Image Deskew System Validation";
+export declare const description = "Validates that image deskew functionality is properly implemented";
+export declare const category = "card-processing";
+export declare const blocking = false;
+export declare const tags: string[];
+//# sourceMappingURL=image-deskew-system.d.ts.map

package/dist/checks/card-processing/image-deskew-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-deskew-system.d.ts","sourceRoot":"","sources":["../../../src/checks/card-processing/image-deskew-system.ts"],"names":[],"mappings":";AAWA,eAAO,MAAM,EAAE,wCAAwC,CAAC;AACxD,eAAO,MAAM,IAAI,mCAAmC,CAAC;AACrD,eAAO,MAAM,WAAW,sEAAsE,CAAC;AAC/F,eAAO,MAAM,QAAQ,oBAAoB,CAAC;AAC1C,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,IAAI,UAAsD,CAAC"}