@empline/preflight 1.1.2 → 1.1.4

package/dist/checks/data/hardcoded-options-validation.js

@@ -0,0 +1,362 @@
+#!/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 = [];
+/**
+ * Hardcoded Options Validation Preflight
+ *
+ * Detects hardcoded option arrays AND inline MenuItem patterns that should use centralized constants.
+ * These patterns indicate dummy/sample data that bypasses the single source of truth.
+ *
+ * BLOCKING: Yes - hardcoded options cause data inconsistency
+ *
+ * Run: pnpm preflight:hardcoded-options
+ *
+ * Detects:
+ * 1. const SAMPLE_CATEGORIES = [...] - Local constant definitions
+ * 2. <MenuItem value="BASEBALL">Baseball</MenuItem> - Inline enum-like values
+ * 3. <MenuItem value="PSA">PSA</MenuItem> - Grading companies
+ * 4. <MenuItem value="flat">Flat Rate</MenuItem> - Shipping types
+ */
+// METADATA - Required for plugin loader discovery
+exports.id = "data/hardcoded-options-validation";
+exports.name = "Hardcoded Options Validation";
+exports.description = "Detects hardcoded option arrays that should use centralized constants";
+exports.category = "data";
+exports.blocking = true;
+exports.tags = ["data", "constants", "forms", "options"];
+// Patterns for local constant definitions
+const LOCAL_CONSTANT_PATTERNS = [
+    {
+        name: "SAMPLE_CATEGORIES",
+        pattern: /const\s+SAMPLE_CATEGORIES\s*=\s*\[/,
+        suggestion: "Use PRODUCT_TYPE_OPTIONS from @/lib/constants/enums",
+    },
+    {
+        name: "CARD_CATEGORIES (local)",
+        pattern: /const\s+CARD_CATEGORIES\s*=\s*\[\s*\{/,
+        suggestion: "Use PRODUCT_TYPE_OPTIONS from @/lib/constants/enums",
+    },
+    {
+        name: "Hardcoded category array",
+        pattern: /\[\s*\{\s*value:\s*["'](?:BASEBALL|BASKETBALL|FOOTBALL|POKEMON|SPORTS_CARD)["']/,
+        suggestion: "Use PRODUCT_TYPE_OPTIONS or SPORT_OPTIONS from @/lib/constants/enums",
+    },
+    {
+        name: "Hardcoded status options",
+        pattern: /const\s+(?:STATUS_OPTIONS|ORDER_STATUS_OPTIONS|LISTING_STATUS_OPTIONS)\s*=\s*\[\s*\{/,
+        suggestion: "Import from @/lib/constants/enums",
+    },
+    {
+        name: "Hardcoded US states array",
+        pattern: /const\s+(?:US_STATES|STATES|STATE_OPTIONS)\s*=\s*\[\s*(?:\{|["'](?:AL|AK|AZ|AR|CA))/,
+        suggestion: "Use US_STATES from @/lib/constants/geographic",
+    },
+    {
+        name: "Hardcoded countries array",
+        pattern: /const\s+(?:COUNTRIES|COUNTRY_OPTIONS)\s*=\s*\[\s*\{/,
+        suggestion: "Use COUNTRIES from @/lib/constants/geographic",
+    },
+    {
+        name: "Hardcoded shipping carriers",
+        pattern: /const\s+(?:CARRIERS|SHIPPING_CARRIERS)\s*=\s*\[\s*\{/,
+        suggestion: "Use SHIPPING_CARRIER_OPTIONS from @/lib/constants/shipping",
+    },
+];
+function isCommentLine(line) {
+    const trimmed = line.trim();
+    return (trimmed.startsWith("//") ||
+        trimmed.startsWith("/*") ||
+        trimmed.startsWith("*") ||
+        trimmed.startsWith("*/"));
+}
+function checkPlayerNameUtilsLexicon(filePath, lines) {
+    const issues = [];
+    const normalized = filePath.replace(/\\/g, "/");
+    if (!normalized.endsWith("lib/player-name-utils.ts")) {
+        return issues;
+    }
+    // Specifically catch regressions where AI re-introduces these lexicons inline
+    // instead of using lib/constants/player-name-parsing.ts
+    lines.forEach((line, index) => {
+        if (isCommentLine(line))
+            return;
+        if (/const\s+BRANDS\s*=\s*\[/.test(line)) {
+            issues.push({
+                file: filePath,
+                line: index + 1,
+                pattern: "BRANDS lexicon in player-name-utils",
+                suggestion: "Use PLAYER_NAME_PARSING_BRANDS from @/lib/constants/player-name-parsing",
+                code: line.trim().substring(0, 80),
+                type: "constant",
+            });
+        }
+        if (/const\s+SERIES_WORDS\s*=\s*(?:new\s+Set\s*\(\s*)?\[/.test(line)) {
+            issues.push({
+                file: filePath,
+                line: index + 1,
+                pattern: "SERIES_WORDS lexicon in player-name-utils",
+                suggestion: "Use PLAYER_NAME_PARSING_SERIES_WORDS / PLAYER_NAME_PARSING_SERIES_WORD_SET from @/lib/constants/player-name-parsing",
+                code: line.trim().substring(0, 80),
+                type: "constant",
+            });
+        }
+    });
+    return issues;
+}
+function checkOcrBrandLexicon(filePath, lines) {
+    const issues = [];
+    const normalized = filePath.replace(/\\/g, "/");
+    const isOcrFile = normalized.endsWith("lib/vision/ocr.ts");
+    const isImageResolutionFile = normalized.endsWith("lib/image-resolution.ts");
+    if (!isOcrFile && !isImageResolutionFile) {
+        return issues;
+    }
+    lines.forEach((line, index) => {
+        if (isCommentLine(line))
+            return;
+        if (/const\s+brands\s*=\s*\[/.test(line)) {
+            issues.push({
+                file: filePath,
+                line: index + 1,
+                pattern: "Inline OCR brands lexicon",
+                suggestion: "Use OCR_BRAND_KEYWORDS from @/lib/constants/ocr-brand-keywords",
+                code: line.trim().substring(0, 80),
+                type: "constant",
+            });
+        }
+    });
+    return issues;
+}
+// Inline MenuItem patterns - detect hardcoded enum values in JSX
+const INLINE_MENUITEM_PATTERNS = [
+    {
+        name: "Inline sport MenuItems",
+        pattern: /<MenuItem\s+value=["'](BASEBALL|BASKETBALL|FOOTBALL|HOCKEY|SOCCER|GOLF|TENNIS|BOXING|MMA|WRESTLING|RACING)["']/,
+        suggestion: "Use SPORT_OPTIONS from @/lib/constants/enums and map over them",
+        category: "sports",
+    },
+    {
+        name: "Inline TCG game MenuItems",
+        pattern: /<MenuItem\s+value=["'](POKEMON|MAGIC_THE_GATHERING|YU_GI_OH|ONE_PIECE|DRAGON_BALL|LORCANA)["']/,
+        suggestion: "Use TCG_GAME_OPTIONS from @/lib/constants/enums and map over them",
+        category: "tcg",
+    },
+    {
+        name: "Inline grading company MenuItems",
+        pattern: /<MenuItem\s+value=["'](PSA|BGS|SGC|CGC|CSG|HGA|TAG|AGS)["']>/,
+        suggestion: "Use GRADING_COMPANY_OPTIONS from @/lib/constants/enums and map over them",
+        category: "grading",
+    },
+    {
+        name: "Inline business type MenuItems",
+        pattern: /<MenuItem\s+value=["'](INDIVIDUAL|BUSINESS)["']>/,
+        suggestion: "Use BUSINESS_TYPE_OPTIONS from @/lib/constants/enums and map over them",
+        category: "business",
+    },
+    {
+        name: "Inline fulfillment type MenuItems",
+        pattern: /<MenuItem\s+value=["'](FBM|FBA)["']>/,
+        suggestion: "Use FULFILLMENT_TYPE_OPTIONS from @/lib/constants/enums and map over them",
+        category: "fulfillment",
+    },
+    {
+        name: "Inline rate type MenuItems",
+        pattern: /<MenuItem\s+value=["'](flat|weight_based|price_based|free)["']>/,
+        suggestion: "Use RATE_CALCULATION_TYPE_OPTIONS from @/lib/constants/shipping and map over them",
+        category: "shipping",
+    },
+    {
+        name: "Inline zone type MenuItems",
+        pattern: /<MenuItem\s+value=["'](domestic|international|custom)["']>/,
+        suggestion: "Use ZONE_TYPE_OPTIONS from @/lib/constants/shipping and map over them",
+        category: "zone",
+    },
+    {
+        name: "Inline quantity discount MenuItems",
+        pattern: /<MenuItem\s+value=["'](PERCENTAGE|FIXED_AMOUNT|FREE_SHIPPING)["']>/,
+        suggestion: "Use QUANTITY_DISCOUNT_TYPE_OPTIONS from @/lib/constants/shipping and map over them",
+        category: "discount",
+    },
+    {
+        name: "Inline review status MenuItems",
+        pattern: /<MenuItem\s+value=["'](pending|approved|rejected)["']>(?:Pending|Approved|Rejected)/,
+        suggestion: "Use REVIEW_STATUS_OPTIONS from @/lib/constants/enums and map over them",
+        category: "review",
+    },
+    {
+        name: "Inline store sort MenuItems",
+        pattern: /<MenuItem\s+value=["'](featured|rating|sales|listings|newest)["']>(?:Featured|Highest|Most|Newest)/,
+        suggestion: "Use STORE_SORT_OPTIONS from @/lib/constants/enums and map over them",
+        category: "storesort",
+    },
+    {
+        name: "Inline condition MenuItems",
+        pattern: /<MenuItem\s+value=["'](UNGRADED|MINT|NEAR_MINT|EXCELLENT|VERY_GOOD|GOOD|FAIR|POOR)["']>/,
+        suggestion: "Use CONDITION_OPTIONS from @/lib/constants/enums and map over them",
+        category: "condition",
+    },
+    {
+        name: "Inline platform MenuItems",
+        pattern: /<MenuItem\s+value=["'](EBAY|AMAZON|TCGPLAYER|SHOPIFY|WOOCOMMERCE)["']>/,
+        suggestion: "Use PLATFORM_OPTIONS from @/lib/constants/enums and map over them",
+        category: "platform",
+    },
+];
+// Note: File exclusions are handled via centralized config in preflight.config.js
+// using getExclusions() and shouldExcludeFile() from @empline/preflight
+function checkFile(filePath) {
+    const issues = [];
+    const content = fs_1.default.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    // Check for local constant definitions
+    for (const { name, pattern, suggestion } of LOCAL_CONSTANT_PATTERNS) {
+        lines.forEach((line, index) => {
+            if (isCommentLine(line))
+                return;
+            if (pattern.test(line)) {
+                issues.push({
+                    file: filePath,
+                    line: index + 1,
+                    pattern: name,
+                    suggestion,
+                    code: line.trim().substring(0, 80),
+                    type: "constant",
+                });
+            }
+        });
+    }
+    issues.push(...checkPlayerNameUtilsLexicon(filePath, lines));
+    issues.push(...checkOcrBrandLexicon(filePath, lines));
+    // Check for inline MenuItem patterns - group by category
+    const menuItemGroups = new Map();
+    for (const { name, pattern, suggestion, category } of INLINE_MENUITEM_PATTERNS) {
+        lines.forEach((line, index) => {
+            if (isCommentLine(line))
+                return;
+            if (pattern.test(line)) {
+                const key = `${category}-${filePath}`;
+                if (!menuItemGroups.has(key)) {
+                    menuItemGroups.set(key, {
+                        name,
+                        suggestion,
+                        category,
+                        lines: [],
+                        firstLine: index + 1,
+                    });
+                }
+                menuItemGroups.get(key).lines.push(index + 1);
+            }
+        });
+    }
+    // Convert grouped MenuItems to issues (one per category per file)
+    for (const [key, group] of menuItemGroups) {
+        if (group.lines.length >= 2) {
+            issues.push({
+                file: filePath,
+                line: group.firstLine,
+                pattern: group.name,
+                suggestion: group.suggestion,
+                code: `${group.lines.length} inline MenuItems found (lines: ${group.lines.slice(0, 5).join(", ")}${group.lines.length > 5 ? "..." : ""})`,
+                type: "inline",
+                count: group.lines.length,
+            });
+        }
+    }
+    return issues;
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const warnOnly = args.includes("--warn");
+    console.log(`${console_chars_1.emoji.search} Checking for hardcoded options arrays and inline MenuItems...\n`);
+    // Load app-specific exclusions from config
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    const allFiles = glob_1.glob.sync("**/*.{ts,tsx}", {
+        ignore: ["node_modules/**", ".next/**", "dist/**"],
+    });
+    const files = allFiles.filter((file) => !(0, exclusions_1.shouldExcludeFile)(file, appExclusions));
+    let totalIssues = [];
+    for (const file of files) {
+        const issues = checkFile(file);
+        if (issues.length > 0) {
+            totalIssues.push(...issues);
+        }
+    }
+    if (totalIssues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No hardcoded options arrays or inline MenuItems found\n`);
+        process.exit(0);
+    }
+    const constantIssues = totalIssues.filter((i) => i.type === "constant");
+    const inlineIssues = totalIssues.filter((i) => i.type === "inline");
+    console.log(`${warnOnly ? "${emoji.warning}" : "${emoji.error}"} Found ${totalIssues.length} hardcoded option issue(s):\n`);
+    if (constantIssues.length > 0) {
+        console.log((0, console_chars_1.createDivider)(60, "heavy"));
+        console.log(`${console_chars_1.emoji.package} LOCAL CONSTANT DEFINITIONS (${constantIssues.length})`);
+        console.log((0, console_chars_1.createDivider)(60, "heavy"));
+        const byFile = {};
+        for (const issue of constantIssues) {
+            if (!byFile[issue.file])
+                byFile[issue.file] = [];
+            byFile[issue.file].push(issue);
+        }
+        for (const [file, issues] of Object.entries(byFile)) {
+            console.log(`\n${console_chars_1.emoji.file} ${file}`);
+            for (const issue of issues) {
+                console.log(`   Line ${issue.line}: ${issue.pattern}`);
+                if (verbose)
+                    console.log(`   Code: ${issue.code}`);
+                console.log(`   ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+        }
+    }
+    if (inlineIssues.length > 0) {
+        console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+        console.log(`INLINE MENUITEM PATTERNS (${inlineIssues.length})`);
+        console.log((0, console_chars_1.createDivider)(60, "heavy"));
+        const byFile = {};
+        for (const issue of inlineIssues) {
+            if (!byFile[issue.file])
+                byFile[issue.file] = [];
+            byFile[issue.file].push(issue);
+        }
+        for (const [file, issues] of Object.entries(byFile)) {
+            console.log(`\n${console_chars_1.emoji.file} ${file}`);
+            for (const issue of issues) {
+                console.log(`   ${issue.pattern}`);
+                console.log(`   ${issue.code}`);
+                console.log(`   ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+        }
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "light"));
+    console.log(`\nTotal: ${totalIssues.length} issue(s)`);
+    console.log(`  - ${constantIssues.length} local constant definition(s)`);
+    console.log(`  - ${inlineIssues.length} inline MenuItem pattern(s)`);
+    console.log(`\n${console_chars_1.emoji.clipboard} How to fix inline MenuItems:\n`);
+    console.log("Instead of:");
+    console.log('  <MenuItem value="BASEBALL">Baseball</MenuItem>');
+    console.log('  <MenuItem value="BASKETBALL">Basketball</MenuItem>');
+    console.log("\nUse:");
+    console.log('  import { SPORT_OPTIONS } from "@/lib/constants/enums";');
+    console.log("  {SPORT_OPTIONS.map(option => (");
+    console.log("    <MenuItem key={option.value} value={option.value}>");
+    console.log("      {option.label}");
+    console.log("    </MenuItem>");
+    console.log("  ))}");
+    process.exit(warnOnly ? 0 : 1);
+}
+main().catch((err) => {
+    console.error("Error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=hardcoded-options-validation.js.map

package/dist/checks/data/hardcoded-options-validation.js.map

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

package/dist/checks/data/league-data-integrity-with-env.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * League Data Integrity Check
+ *
+ * Validates league reference data integrity.
+ * This check is consolidated into the Database module.
+ */
+export declare const id = "data/league-data-integrity-with-env";
+export declare const name = "League Data Integrity";
+export declare const description = "Validates league reference data integrity (consolidated into Database module)";
+export declare const category = "data";
+export declare const blocking = false;
+export declare const tags: string[];
+//# sourceMappingURL=league-data-integrity-with-env.d.ts.map

package/dist/checks/data/league-data-integrity-with-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"league-data-integrity-with-env.d.ts","sourceRoot":"","sources":["../../../src/checks/data/league-data-integrity-with-env.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAIH,eAAO,MAAM,EAAE,wCAAwC,CAAC;AACxD,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAC5C,eAAO,MAAM,WAAW,kFAAkF,CAAC;AAC3G,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,IAAI,UAAuC,CAAC"}

package/dist/checks/data/league-data-integrity-with-env.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * League Data Integrity Check
+ *
+ * Validates league reference data integrity.
+ * This check is consolidated into the Database module.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+// METADATA - Required for plugin loader discovery
+exports.id = "data/league-data-integrity-with-env";
+exports.name = "League Data Integrity";
+exports.description = "Validates league reference data integrity (consolidated into Database module)";
+exports.category = "data";
+exports.blocking = false;
+exports.tags = ["data", "league", "reference-data"];
+const console_chars_1 = require("../../utils/console-chars");
+console.log(`${console_chars_1.emoji.success} League Data integrity check passed (consolidated into Database module)`);
+process.exit(0);
+//# sourceMappingURL=league-data-integrity-with-env.js.map

package/dist/checks/data/league-data-integrity-with-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"league-data-integrity-with-env.js","sourceRoot":"","sources":["../../../src/checks/data/league-data-integrity-with-env.ts"],"names":[],"mappings":";;AAEA;;;;;GAKG;;;AAEH,kDAAkD;AAErC,QAAA,EAAE,GAAG,qCAAqC,CAAC;AAC3C,QAAA,IAAI,GAAG,uBAAuB,CAAC;AAC/B,QAAA,WAAW,GAAG,+EAA+E,CAAC;AAC9F,QAAA,QAAQ,GAAG,MAAM,CAAC;AAClB,QAAA,QAAQ,GAAG,KAAK,CAAC;AACjB,QAAA,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAEzD,6DAAkD;AAClD,OAAO,CAAC,GAAG,CACT,GAAG,qBAAK,CAAC,OAAO,yEAAyE,CAC1F,CAAC;AACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/checks/data/product-slug-architecture.d.ts

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * Product Slug Architecture Validation Preflight
+ *
+ * Validates that product URLs are based on catalog cards, not individual listings.
+ * Product pages should use canonical catalog-card-based slugs that are human-readable
+ * and don't include arbitrary listing ID suffixes.
+ *
+ * BLOCKING: Yes - listing-based slugs like "card-name-2" are confusing to users
+ *
+ * Run: pnpm preflight:product-slug-architecture
+ *
+ * Validates:
+ * - Slug generation uses catalog card data, not listing IDs
+ * - Slugs don't end in numeric suffixes from listing IDs
+ * - Product URLs should be like /product/2021-panini-contenders-deandre-hopkins
+ *   NOT like /product/2021-panini-contenders-deandre-hopkins-abc123
+ */
+export declare const id = "data/product-slug-architecture";
+export declare const name = "Product Slug Architecture Validation";
+export declare const description = "Validates product slugs are catalog-card-based, not listing-ID-based";
+export declare const category = "data";
+export declare const blocking = true;
+export declare const tags: string[];
+interface Issue {
+    file: string;
+    line: number;
+    pattern: string;
+    suggestion: string;
+}
+export declare function run(): Promise<{
+    passed: boolean;
+    issues: Issue[];
+}>;
+export {};
+//# sourceMappingURL=product-slug-architecture.d.ts.map

package/dist/checks/data/product-slug-architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-slug-architecture.d.ts","sourceRoot":"","sources":["../../../src/checks/data/product-slug-architecture.ts"],"names":[],"mappings":";AAMA;;;;;;;;;;;;;;;;GAgBG;AAGH,eAAO,MAAM,EAAE,mCAAmC,CAAC;AACnD,eAAO,MAAM,IAAI,yCAAyC,CAAC;AAC3D,eAAO,MAAM,WAAW,yEAAyE,CAAC;AAClG,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAmD,CAAC;AAKrE,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AA+FD,wBAAsB,GAAG,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,CAAC,CAgDzE"}

package/dist/checks/data/product-slug-architecture.js

@@ -0,0 +1,167 @@
+#!/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;
+exports.run = run;
+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");
+/**
+ * Product Slug Architecture Validation Preflight
+ *
+ * Validates that product URLs are based on catalog cards, not individual listings.
+ * Product pages should use canonical catalog-card-based slugs that are human-readable
+ * and don't include arbitrary listing ID suffixes.
+ *
+ * BLOCKING: Yes - listing-based slugs like "card-name-2" are confusing to users
+ *
+ * Run: pnpm preflight:product-slug-architecture
+ *
+ * Validates:
+ * - Slug generation uses catalog card data, not listing IDs
+ * - Slugs don't end in numeric suffixes from listing IDs
+ * - Product URLs should be like /product/2021-panini-contenders-deandre-hopkins
+ *   NOT like /product/2021-panini-contenders-deandre-hopkins-abc123
+ */
+// METADATA - Required for plugin loader discovery
+exports.id = "data/product-slug-architecture";
+exports.name = "Product Slug Architecture Validation";
+exports.description = "Validates product slugs are catalog-card-based, not listing-ID-based";
+exports.category = "data";
+exports.blocking = true;
+exports.tags = ["data", "slugs", "urls", "seo", "architecture"];
+// App-specific exclusions
+let appExclusions = [];
+// Patterns that indicate listing-ID-based slug generation (anti-pattern)
+const PROBLEMATIC_SLUG_PATTERNS = [
+    {
+        // Slug generation that appends listing ID suffix
+        pattern: /slug.*=.*listingId\.split\(['"_"']\)\.pop\(\)/,
+        name: "Slug uses listing ID suffix",
+        suggestion: "Product slugs should be generated from catalog card data (year, brand, series, player), not listing IDs",
+    },
+    {
+        // Template literal appending listing ID to slug
+        pattern: /`\$\{baseSlug\}-\$\{listingId/,
+        name: "Slug template appends listing ID",
+        suggestion: "Use catalog card identifiers for unique slugs, not listing IDs",
+    },
+    {
+        // generateSlug function that takes listingId parameter
+        pattern: /function generateSlug\([^)]*listingId/,
+        name: "generateSlug function takes listingId",
+        suggestion: "Slug generation should not depend on listing IDs - use catalog card data instead",
+    },
+    {
+        // Slug based on listingId.split
+        pattern: /\$\{listingId\.split/,
+        name: "Slug constructed from listingId.split()",
+        suggestion: "Catalog card slugs should be deterministic from card metadata, not listing IDs",
+    },
+];
+// Files/directories to exclude from checking
+const EXCLUDED_PATHS = [
+    "node_modules",
+    ".next",
+    "dist",
+    "build",
+    "__tests__",
+    "tests/",
+    "*.test.ts",
+    "*.test.tsx",
+    "*.spec.ts",
+    "*.spec.tsx",
+    "docs/",
+    "scripts/preflights/", // Don't check preflight files themselves
+    "*.d.ts",
+];
+function isExcludedPath(filePath) {
+    const normalized = filePath.replace(/\\/g, "/");
+    return EXCLUDED_PATHS.some((excluded) => {
+        if (excluded.startsWith("*.")) {
+            return normalized.endsWith(excluded.slice(1));
+        }
+        return normalized.includes(excluded);
+    });
+}
+function isCommentLine(line) {
+    const trimmed = line.trim();
+    return (trimmed.startsWith("//") ||
+        trimmed.startsWith("/*") ||
+        trimmed.startsWith("*") ||
+        trimmed.startsWith("*/"));
+}
+function checkFile(filePath) {
+    const issues = [];
+    if (isExcludedPath(filePath)) {
+        return issues;
+    }
+    const content = fs_1.default.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    lines.forEach((line, index) => {
+        if (isCommentLine(line))
+            return;
+        for (const { pattern, name, suggestion } of PROBLEMATIC_SLUG_PATTERNS) {
+            if (pattern.test(line)) {
+                issues.push({
+                    file: filePath,
+                    line: index + 1,
+                    pattern: name,
+                    suggestion,
+                });
+            }
+        }
+    });
+    return issues;
+}
+async function run() {
+    console.log((0, console_chars_1.createDivider)("Product Slug Architecture Validation"));
+    console.log(`${console_chars_1.emoji.search} Checking for listing-ID-based slug patterns...\n`);
+    // Load app-specific exclusions
+    try {
+        appExclusions = await (0, exclusions_1.getExclusions)("product-slug-architecture");
+    }
+    catch {
+        appExclusions = [];
+    }
+    const files = await (0, glob_1.glob)("**/*.{ts,tsx}", {
+        ignore: ["node_modules/**", ".next/**", "dist/**", "build/**", "**/*.d.ts", "**/*.test.ts", "**/*.spec.ts", "scripts/preflights/**"],
+    });
+    const allIssues = [];
+    for (const file of files) {
+        if ((0, exclusions_1.shouldExcludeFile)(file, appExclusions)) {
+            continue;
+        }
+        const issues = checkFile(file);
+        allIssues.push(...issues);
+    }
+    if (allIssues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No listing-ID-based slug patterns found\n`);
+        return { passed: true, issues: [] };
+    }
+    console.log(`${console_chars_1.emoji.error} Found ${allIssues.length} listing-ID-based slug issue(s):\n`);
+    for (const issue of allIssues) {
+        console.log(`  ${console_chars_1.emoji.warning} ${issue.file}:${issue.line}`);
+        console.log(`     Pattern: ${issue.pattern}`);
+        console.log(`     Fix: ${issue.suggestion}\n`);
+    }
+    console.log(`\n${console_chars_1.emoji.info} Product slugs should be based on CATALOG CARD data, not listing IDs.`);
+    console.log(`   Good: /product/2021-panini-contenders-deandre-hopkins`);
+    console.log(`   Bad:  /product/2021-panini-contenders-deandre-hopkins-abc123`);
+    console.log(`\n   Catalog-based slugs are:`);
+    console.log(`   - Human-readable and SEO-friendly`);
+    console.log(`   - Shared across all listings for the same card`);
+    console.log(`   - Deterministic from card metadata\n`);
+    return { passed: false, issues: allIssues };
+}
+// CLI execution
+if (process.argv[1]?.includes("product-slug-architecture")) {
+    run().then(({ passed }) => {
+        process.exit(passed ? 0 : 1);
+    });
+}
+//# sourceMappingURL=product-slug-architecture.js.map

package/dist/checks/data/product-slug-architecture.js.map

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