@empline/preflight 1.0.20

package/dist/checks/help-center-validation.js

@@ -0,0 +1,325 @@
+#!/usr/bin/env ts-node
+"use strict";
+/**
+ * Help Center Validation Preflight
+ *
+ * Validates help center articles for consistency and completeness:
+ * - All articles have required fields
+ * - Related articles exist
+ * - Tags are consistent
+ * - Categories are valid
+ * - Content meets minimum length
+ * - lastUpdated dates are valid
+ *
+ * @usage pnpm preflight:help-center
+ */
+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 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 = "misc/help-center-validation";
+exports.name = "Help Center Validation";
+exports.category = "misc";
+exports.blocking = false;
+exports.description = "Help Center Validation Preflight";
+exports.tags = ["misc", "validation"];
+const VALID_CATEGORIES = ["Buying", "Selling", "Account", "Payments", "Shipping", "Safety"];
+const MIN_CONTENT_LENGTH = 200;
+const MIN_SUMMARY_LENGTH = 20;
+const MAX_SUMMARY_LENGTH = 200;
+const MIN_TAGS = 2;
+const MAX_TAGS = 10;
+function validateArticles(articles) {
+    const issues = [];
+    const articleIds = new Set(articles.map((a) => a.id));
+    const allTags = new Map();
+    for (const article of articles) {
+        // Check required fields
+        if (!article.id) {
+            issues.push({ level: "error", articleId: "unknown", message: "Article missing id" });
+            continue;
+        }
+        if (!article.title || article.title.trim().length === 0) {
+            issues.push({ level: "error", articleId: article.id, message: "Missing or empty title" });
+        }
+        if (!article.summary || article.summary.trim().length === 0) {
+            issues.push({ level: "error", articleId: article.id, message: "Missing or empty summary" });
+        }
+        else if (article.summary.length < MIN_SUMMARY_LENGTH) {
+            issues.push({
+                level: "warning",
+                articleId: article.id,
+                message: `Summary too short (${article.summary.length} chars, min ${MIN_SUMMARY_LENGTH})`,
+            });
+        }
+        else if (article.summary.length > MAX_SUMMARY_LENGTH) {
+            issues.push({
+                level: "warning",
+                articleId: article.id,
+                message: `Summary too long (${article.summary.length} chars, max ${MAX_SUMMARY_LENGTH})`,
+            });
+        }
+        // Validate category
+        if (!article.category) {
+            issues.push({ level: "error", articleId: article.id, message: "Missing category" });
+        }
+        else if (!VALID_CATEGORIES.includes(article.category)) {
+            issues.push({
+                level: "error",
+                articleId: article.id,
+                message: `Invalid category "${article.category}". Valid: ${VALID_CATEGORIES.join(", ")}`,
+            });
+        }
+        // Validate content
+        if (!article.content || article.content.trim().length === 0) {
+            issues.push({ level: "error", articleId: article.id, message: "Missing or empty content" });
+        }
+        else if (article.content.length < MIN_CONTENT_LENGTH) {
+            issues.push({
+                level: "warning",
+                articleId: article.id,
+                message: `Content too short (${article.content.length} chars, min ${MIN_CONTENT_LENGTH})`,
+            });
+        }
+        // Validate tags
+        if (!article.tags || !Array.isArray(article.tags)) {
+            issues.push({
+                level: "error",
+                articleId: article.id,
+                message: "Missing or invalid tags array",
+            });
+        }
+        else {
+            if (article.tags.length < MIN_TAGS) {
+                issues.push({
+                    level: "warning",
+                    articleId: article.id,
+                    message: `Too few tags (${article.tags.length}, min ${MIN_TAGS})`,
+                });
+            }
+            if (article.tags.length > MAX_TAGS) {
+                issues.push({
+                    level: "warning",
+                    articleId: article.id,
+                    message: `Too many tags (${article.tags.length}, max ${MAX_TAGS})`,
+                });
+            }
+            // Track tag usage
+            for (const tag of article.tags) {
+                allTags.set(tag, (allTags.get(tag) || 0) + 1);
+            }
+        }
+        // Validate related articles
+        if (article.relatedArticles) {
+            for (const relatedId of article.relatedArticles) {
+                if (!articleIds.has(relatedId)) {
+                    issues.push({
+                        level: "error",
+                        articleId: article.id,
+                        message: `Related article "${relatedId}" does not exist`,
+                    });
+                }
+            }
+        }
+        // Validate lastUpdated
+        if (!article.lastUpdated) {
+            issues.push({ level: "error", articleId: article.id, message: "Missing lastUpdated date" });
+        }
+        else {
+            const date = new Date(article.lastUpdated);
+            if (isNaN(date.getTime())) {
+                issues.push({
+                    level: "error",
+                    articleId: article.id,
+                    message: `Invalid lastUpdated date format: "${article.lastUpdated}"`,
+                });
+            }
+            else if (date > new Date()) {
+                issues.push({
+                    level: "warning",
+                    articleId: article.id,
+                    message: `lastUpdated date is in the future: "${article.lastUpdated}"`,
+                });
+            }
+        }
+        // Check for duplicate IDs
+        const duplicates = articles.filter((a) => a.id === article.id);
+        if (duplicates.length > 1) {
+            issues.push({
+                level: "error",
+                articleId: article.id,
+                message: `Duplicate article ID found (${duplicates.length} occurrences)`,
+            });
+        }
+    }
+    // Check for orphan tags (used only once)
+    for (const [tag, count] of allTags) {
+        if (count === 1) {
+            issues.push({
+                level: "info",
+                articleId: "global",
+                message: `Tag "${tag}" is only used once - consider if it's useful for discovery`,
+            });
+        }
+    }
+    // Check category balance
+    const categoryCount = new Map();
+    for (const article of articles) {
+        if (article.category) {
+            categoryCount.set(article.category, (categoryCount.get(article.category) || 0) + 1);
+        }
+    }
+    const avgPerCategory = articles.length / VALID_CATEGORIES.length;
+    for (const [category, count] of categoryCount) {
+        if (count < avgPerCategory * 0.5) {
+            issues.push({
+                level: "info",
+                articleId: "global",
+                message: `Category "${category}" has fewer articles (${count}) than average (${Math.round(avgPerCategory)})`,
+            });
+        }
+    }
+    return issues;
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    console.log(`${console_chars_1.emoji.search} Help Center Validation Preflight\n`);
+    // Read and parse the help articles file
+    const helpArticlesPath = path.join(process.cwd(), "app/help/help-articles.ts");
+    if (!fs.existsSync(helpArticlesPath)) {
+        console.error(`${console_chars_1.emoji.error} ERROR: help-articles.ts not found at`, helpArticlesPath);
+        process.exit(1);
+    }
+    const fileContent = fs.readFileSync(helpArticlesPath, "utf-8");
+    // Extract the articles array using regex (simple approach)
+    // This is a simplified parser - in production you'd use proper AST parsing
+    const articlesMatch = fileContent.match(/export const helpArticles: HelpArticle\[\] = \[([\s\S]*?)\];/);
+    if (!articlesMatch) {
+        console.error(`${console_chars_1.emoji.error} ERROR: Could not parse helpArticles array`);
+        process.exit(1);
+    }
+    // Count articles by looking for id patterns
+    const idMatches = fileContent.match(/id: "[^"]+"/g) || [];
+    const articleCount = idMatches.length;
+    // Count categories
+    const categoryMatches = fileContent.match(/category: "[^"]+"/g) || [];
+    const categories = new Map();
+    for (const match of categoryMatches) {
+        const category = match.replace('category: "', "").replace('"', "");
+        categories.set(category, (categories.get(category) || 0) + 1);
+    }
+    // Check for required fields
+    const issues = [];
+    // Check all articles have lastUpdated
+    const lastUpdatedCount = (fileContent.match(/lastUpdated: "/g) || []).length;
+    if (lastUpdatedCount < articleCount) {
+        issues.push({
+            level: "error",
+            articleId: "global",
+            message: `${articleCount - lastUpdatedCount} articles missing lastUpdated field`,
+        });
+    }
+    // Check for related articles that might not exist
+    const relatedMatches = fileContent.match(/relatedArticles: \[([^\]]+)\]/g) || [];
+    const allIds = new Set(idMatches.map((m) => m.replace('id: "', "").replace('"', "")));
+    for (const match of relatedMatches) {
+        const relatedIds = match.match(/"[^"]+"/g) || [];
+        for (const relatedId of relatedIds) {
+            const id = relatedId.replace(/"/g, "");
+            if (!allIds.has(id)) {
+                issues.push({
+                    level: "error",
+                    articleId: "unknown",
+                    message: `Related article "${id}" does not exist`,
+                });
+            }
+        }
+    }
+    // Print summary
+    console.log(`${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Total articles: ${articleCount}`);
+    console.log(`   Categories: ${categories.size}`);
+    for (const [category, count] of categories) {
+        console.log(`     - ${category}: ${count} articles`);
+    }
+    console.log("");
+    // Print issues
+    const errors = issues.filter((i) => i.level === "error");
+    const warnings = issues.filter((i) => i.level === "warning");
+    const infos = issues.filter((i) => i.level === "info");
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} ERRORS:`);
+        for (const issue of errors) {
+            console.log(`   [${issue.articleId}] ${issue.message}`);
+        }
+        console.log("");
+    }
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  WARNINGS:`);
+        for (const issue of warnings) {
+            console.log(`   [${issue.articleId}] ${issue.message}`);
+        }
+        console.log("");
+    }
+    if (infos.length > 0) {
+        console.log(`${console_chars_1.emoji.info}  INFO:`);
+        for (const issue of infos) {
+            console.log(`   [${issue.articleId}] ${issue.message}`);
+        }
+        console.log("");
+    }
+    // Final result
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} FAILED: ${errors.length} error(s), ${warnings.length} warning(s)`);
+        process.exit(1);
+    }
+    else if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  PASSED with ${warnings.length} warning(s)`);
+        process.exit(0);
+    }
+    else {
+        console.log(`\n${console_chars_1.emoji.success} PASSED: All help center articles are valid`);
+        process.exit(0);
+    }
+}
+main().catch((err) => {
+    console.error(`${console_chars_1.emoji.error} Unexpected error:`, err);
+    process.exit(1);
+});
+//# sourceMappingURL=help-center-validation.js.map

package/dist/checks/help-center-validation.js.map

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

package/dist/checks/image/card-edge-protection.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Card Edge Protection Preflight
+ *
+ * CRITICAL: Ensures image processing code does NOT trim into actual card edges.
+ *
+ * Background removal (cropping out white/black backgrounds) is GOOD.
+ * Trimming INTO the card edges is BAD - it hides condition issues like:
+ * - Corner wear/whitening
+ * - Edge damage/dings
+ * - Border imperfections
+ *
+ * Buyers need to see the TRUE condition of a card.
+ */
+export declare const id = "image/card-edge-protection";
+export declare const name = "Card Edge Protection";
+export declare const category = "image";
+export declare const blocking = true;
+export declare const description = "Card Edge Protection Preflight";
+export declare const tags: string[];
+interface Violation {
+    file: string;
+    line: number;
+    code: string;
+    issue: string;
+    severity: "error" | "warning";
+}
+export declare function runCardEdgeProtectionPreflight(): Promise<{
+    success: boolean;
+    violations: Violation[];
+    summary: string;
+}>;
+export {};
+//# sourceMappingURL=card-edge-protection.d.ts.map

package/dist/checks/image/card-edge-protection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-edge-protection.d.ts","sourceRoot":"","sources":["../../../src/checks/image/card-edge-protection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,yBAAyB,CAAC;AAC3C,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,mCAAmC,CAAC;AAC5D,eAAO,MAAM,IAAI,UAAY,CAAC;AAE9B,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAmHD,wBAAsB,8BAA8B,IAAI,OAAO,CAAC;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CA4ED"}

package/dist/checks/image/card-edge-protection.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Card Edge Protection Preflight
+ *
+ * CRITICAL: Ensures image processing code does NOT trim into actual card edges.
+ *
+ * Background removal (cropping out white/black backgrounds) is GOOD.
+ * Trimming INTO the card edges is BAD - it hides condition issues like:
+ * - Corner wear/whitening
+ * - Edge damage/dings
+ * - Border imperfections
+ *
+ * Buyers need to see the TRUE condition of a card.
+ */
+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;
+exports.runCardEdgeProtectionPreflight = runCardEdgeProtectionPreflight;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "image/card-edge-protection";
+exports.name = "Card Edge Protection";
+exports.category = "image";
+exports.blocking = true;
+exports.description = "Card Edge Protection Preflight";
+exports.tags = ["image"];
+const IMAGE_PROCESSING_FILES = [
+    "lib/image-border-removal.ts",
+    "lib/image-white-border-removal.ts",
+    "lib/image-border-resolution.ts",
+    "lib/image-optimization.ts",
+    "lib/api/cards/identify/image-processor.ts",
+];
+// Patterns that indicate trimming INTO the card (BAD)
+const DANGEROUS_PATTERNS = [
+    {
+        pattern: /SAFETY_MARGIN\s*=\s*[1-9]/,
+        issue: "SAFETY_MARGIN adds extra pixels to crop, trimming into card edges",
+    },
+    {
+        pattern: /\+\s*(?:SAFETY_MARGIN|safetyMargin|margin|padding|extra|buffer)\s*(?:;|\))/i,
+        issue: "Adding extra pixels to border detection result trims into card",
+    },
+    {
+        pattern: /borderThickness\s*\+\s*\d+/,
+        issue: "Adding to border thickness trims into card edges",
+    },
+    {
+        pattern: /cropLeft\s*\+\s*\d+|cropTop\s*\+\s*\d+|cropRight\s*\+\s*\d+|cropBottom\s*\+\s*\d+/,
+        issue: "Adding to crop coordinates trims into card edges",
+    },
+    {
+        pattern: /inset|shrink.*border|trim.*extra|cut.*into/i,
+        issue: "Potential card edge trimming detected - verify this doesn't cut into card",
+    },
+];
+// Patterns that are GOOD (background removal, not card trimming)
+const SAFE_PATTERNS = [
+    /edgeConsistency/, // Detecting where background ends
+    /blackThreshold|whiteThreshold/, // Color detection thresholds
+    /borderDetected/, // Just detecting, not adding
+    /minBorderThickness/, // Minimum to consider a border
+    /maxBorderThickness/, // Maximum border size
+];
+function checkFile(filePath) {
+    const violations = [];
+    if (!fs.existsSync(filePath)) {
+        return violations;
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    lines.forEach((line, index) => {
+        const lineNum = index + 1;
+        // Skip comments
+        if (line.trim().startsWith("//") || line.trim().startsWith("*")) {
+            return;
+        }
+        for (const { pattern, issue } of DANGEROUS_PATTERNS) {
+            if (pattern.test(line)) {
+                // Check if this is in a safe context
+                const isSafeContext = SAFE_PATTERNS.some((safe) => safe.test(line));
+                if (!isSafeContext) {
+                    violations.push({
+                        file: filePath,
+                        line: lineNum,
+                        code: line.trim().substring(0, 80),
+                        issue,
+                        severity: "error",
+                    });
+                }
+            }
+        }
+    });
+    return violations;
+}
+function checkForMissingProtectionComment(filePath) {
+    const violations = [];
+    if (!fs.existsSync(filePath)) {
+        return violations;
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    // Files that do border removal should have a comment about preserving card edges
+    if (content.includes("removeBlackBorders") || content.includes("removeWhiteBorders")) {
+        const hasProtectionComment = (content.includes("preserve") && content.includes("card edge")) ||
+            content.includes("NO safety margin") ||
+            content.includes("must NOT trim") ||
+            content.includes("hide corner wear") ||
+            content.includes("hide condition");
+        if (!hasProtectionComment) {
+            violations.push({
+                file: filePath,
+                line: 1,
+                code: "Border removal function",
+                issue: "Missing comment about preserving card edges - add documentation to prevent future regressions",
+                severity: "warning",
+            });
+        }
+    }
+    return violations;
+}
+async function runCardEdgeProtectionPreflight() {
+    console.log(`${console_chars_1.emoji.shield}  Card Edge Protection Preflight`);
+    console.log("=".repeat(60));
+    console.log("Checking that image processing does NOT trim into card edges...\n");
+    const allViolations = [];
+    for (const file of IMAGE_PROCESSING_FILES) {
+        const filePath = path.join(process.cwd(), file);
+        const violations = checkFile(filePath);
+        const commentViolations = checkForMissingProtectionComment(filePath);
+        allViolations.push(...violations, ...commentViolations);
+    }
+    // Also scan for any new image processing files
+    const libDir = path.join(process.cwd(), "lib");
+    if (fs.existsSync(libDir)) {
+        const files = fs.readdirSync(libDir);
+        for (const file of files) {
+            if (file.includes("image") &&
+                file.endsWith(".ts") &&
+                !IMAGE_PROCESSING_FILES.includes(`lib/${file}`)) {
+                const filePath = path.join(libDir, file);
+                const violations = checkFile(filePath);
+                allViolations.push(...violations);
+            }
+        }
+    }
+    // Report results
+    const errors = allViolations.filter((v) => v.severity === "error");
+    const warnings = allViolations.filter((v) => v.severity === "warning");
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} ERRORS (BLOCKING):`);
+        errors.forEach((v) => {
+            console.log(`   ${v.file}:${v.line}`);
+            console.log(`   Issue: ${v.issue}`);
+            console.log(`   Code: ${v.code}`);
+            console.log();
+        });
+    }
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  WARNINGS:`);
+        warnings.forEach((v) => {
+            console.log(`   ${v.file}:${v.line}`);
+            console.log(`   Issue: ${v.issue}`);
+            console.log();
+        });
+    }
+    const success = errors.length === 0;
+    console.log("=".repeat(60));
+    if (success) {
+        console.log(`${console_chars_1.emoji.success} Card edge protection: PASSED`);
+        console.log("   Image processing preserves actual card edges.");
+    }
+    else {
+        console.log(`${console_chars_1.emoji.error} Card edge protection: FAILED`);
+        console.log("   Found code that may trim INTO card edges, hiding condition issues.");
+        console.log("   Buyers need to see corner wear, edge damage, and border imperfections.");
+    }
+    const summary = `${errors.length} errors, ${warnings.length} warnings`;
+    console.log(`   ${summary}\n`);
+    return {
+        success,
+        violations: allViolations,
+        summary,
+    };
+}
+// CLI execution
+if (require.main === module) {
+    runCardEdgeProtectionPreflight()
+        .then((result) => {
+        process.exit(result.success ? 0 : 1);
+    })
+        .catch((error) => {
+        console.error("Preflight failed:", error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=card-edge-protection.js.map

package/dist/checks/image/card-edge-protection.js.map

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

package/dist/checks/image/card-orientation-validation.d.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env tsx
+/**
+ * Card Orientation Validation Preflight
+ *
+ * Validates the card orientation service follows best practices:
+ * 1. Graded cards orient by grade label (not card content)
+ * 2. Text-based orientation uses AI for accuracy
+ * 3. Edge-based cropping handles missing corners
+ * 4. Proper fallback chain exists
+ * 5. Vercel-compatible (no long-running operations)
+ *
+ * BLOCKING: Fails build if critical patterns are violated
+ */
+export declare const id = "image/card-orientation-validation";
+export declare const name = "Card Orientation Validation";
+export declare const category = "image";
+export declare const blocking = false;
+export declare const description = "Card Orientation Validation Preflight";
+export declare const tags: string[];
+interface ValidationIssue {
+    file: string;
+    line: number;
+    rule: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    suggestion: string;
+}
+export declare function runCardOrientationValidation(): Promise<{
+    success: boolean;
+    issues: ValidationIssue[];
+    summary: string;
+}>;
+export {};
+//# sourceMappingURL=card-orientation-validation.d.ts.map

package/dist/checks/image/card-orientation-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-orientation-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/image/card-orientation-validation.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG;AAQH,eAAO,MAAM,EAAE,sCAAsC,CAAC;AACtD,eAAO,MAAM,IAAI,gCAAgC,CAAC;AAClD,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,0CAA0C,CAAC;AACnE,eAAO,MAAM,IAAI,UAAyB,CAAC;AAE3C,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AA4eD,wBAAsB,4BAA4B,IAAI,OAAO,CAAC;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAgBD"}