@empline/preflight 1.0.20

package/dist/checks/governance/seller-store-naming-consistency.js

@@ -0,0 +1,241 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Seller vs Store Naming Consistency (WARNING)
+ *
+ * Validates consistent use of "seller" vs "store" terminology in code.
+ *
+ * RULES:
+ * - "store" = business entity (storefront, profile, settings)
+ * - "seller" = user role OR actions taken by that role
+ *
+ * VALID seller_ usage:
+ * - sellerApproved, sellerNotes (actions by seller)
+ * - finance_seller_* (seller receives money)
+ * - isSeller(), hasSeller (role checks)
+ * - Role.SELLER (enum value)
+ *
+ * VALID store_ usage:
+ * - store_scans_*, description (entity properties)
+ * - authStores (database table)
+ * - storeId, storeName (entity references)
+ *
+ * SUSPICIOUS patterns (flagged for review):
+ * - sellerScans, sellerLimit (should be storeScans, storeLimit)
+ * - new variables mixing seller/store for same concept
+ */
+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");
+// Check metadata
+exports.id = "governance/seller-store-naming-consistency";
+exports.name = "Seller Store Naming Consistency";
+exports.category = "governance";
+exports.blocking = false;
+exports.description = "Seller vs Store Naming Consistency (WARNING)";
+exports.tags = ["governance"];
+const ROOT = process.cwd();
+const SCAN_DIRS = ["app", "components", "lib"];
+const args = process.argv.slice(2);
+const isVerbose = args.includes("--verbose");
+const isWarnOnly = args.includes("--warn");
+// Patterns that suggest seller_ should be store_ (entity properties)
+const SUSPICIOUS_SELLER_PATTERNS = [
+    { regex: /seller[_]?scans/gi, suggestion: "Use store_scans (store-level quota)" },
+    { regex: /seller[_]?limit(?!ed)/gi, suggestion: "Use store_limit if entity property" },
+    { regex: /seller[_]?quota/gi, suggestion: "Use store_quota (store-level quota)" },
+    { regex: /seller[_]?settings/gi, suggestion: "Use store_settings (entity config)" },
+    { regex: /seller[_]?profile/gi, suggestion: "Use store profile (entity)" },
+    { regex: /seller[_]?banner/gi, suggestion: "Use store_banner (entity property)" },
+    { regex: /seller[_]?description/gi, suggestion: "Use description (entity property)" },
+    { regex: /seller[_]?theme/gi, suggestion: "Use theme (entity property)" },
+];
+// Known valid patterns (don't flag these)
+const VALID_SELLER_PATTERNS = [
+    /seller[_]?approved/i, // Action: seller approved
+    /seller[_]?notes/i, // Notes from seller
+    /seller[_]?response/i, // Response from seller
+    /seller[_]?reviewed/i, // Reviewed by seller
+    /seller[_]?sku/i, // Seller's SKU
+    /seller[_]?box/i, // Seller's box ref
+    /seller[_]?row/i, // Seller's row ref
+    /seller[_]?since/i, // When became seller
+    /amazon[_]?seller/i, // External platform
+    /isSeller/i, // Role check
+    /hasSeller/i, // Role check
+    /hasSellerProfile/i, // Role check (has store)
+    /sellerProfile/i, // Checking if user is seller (common pattern)
+    /Role\.SELLER/i, // Enum
+    /featured[_]?seller/i, // Feature flag
+    /finance[_]?seller/i, // Financial (seller receives)
+    /system[_]?seller[_]?plans/i, // Subscription plans
+    /SellerApprovalStatus/i, // Enum type
+    /SellerPageLayout/i, // Layout component (legacy name OK)
+    /SellerDashboard/i, // Component (legacy name OK)
+    /sellerPlan/i, // Seller's subscription plan
+    /sellerCta/i, // CTA for becoming seller
+];
+// Files/paths to ignore
+const IGNORE_PATTERNS = [
+    /node_modules/,
+    /\.next/,
+    /dist/,
+    /coverage/,
+    /\.git/,
+    /migrations/, // Migrations have historical names
+    /schema\.prisma/, // Schema has its own preflight
+    /seller-store-naming/, // This file
+    /store-seller-route/, // Route preflight
+    /quick-decisions\.md/, // Documentation
+];
+function shouldIgnore(filePath) {
+    return IGNORE_PATTERNS.some((p) => p.test(filePath));
+}
+function isValidSellerUsage(line) {
+    return VALID_SELLER_PATTERNS.some((p) => p.test(line));
+}
+function scanFile(filePath) {
+    const issues = [];
+    const relPath = path.relative(ROOT, filePath);
+    if (shouldIgnore(relPath))
+        return issues;
+    let content;
+    try {
+        content = fs.readFileSync(filePath, "utf8");
+    }
+    catch {
+        return issues;
+    }
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        // Skip comments
+        const trimmed = line.trim();
+        if (trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*")) {
+            continue;
+        }
+        // Skip if line contains valid seller usage
+        if (isValidSellerUsage(line))
+            continue;
+        // Check for suspicious patterns
+        for (const { regex, suggestion } of SUSPICIOUS_SELLER_PATTERNS) {
+            const match = line.match(regex);
+            if (match) {
+                issues.push({
+                    file: relPath,
+                    line: lineNum,
+                    pattern: match[0],
+                    suggestion,
+                    severity: isWarnOnly ? "warning" : "warning", // Always warning for this check
+                });
+            }
+        }
+    }
+    return issues;
+}
+function listFiles(dir) {
+    const files = [];
+    if (!fs.existsSync(dir))
+        return files;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (["node_modules", ".next", "dist", ".git"].includes(entry.name))
+                continue;
+            files.push(...listFiles(fullPath));
+        }
+        else if (entry.isFile() && /\.(ts|tsx|js|jsx)$/.test(entry.name)) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+function main() {
+    console.log(`\n${console_chars_1.emoji.search} Seller vs Store Naming Consistency`);
+    console.log("═".repeat(60));
+    const allIssues = [];
+    for (const dir of SCAN_DIRS) {
+        const absDir = path.join(ROOT, dir);
+        const files = listFiles(absDir);
+        for (const file of files) {
+            allIssues.push(...scanFile(file));
+        }
+    }
+    if (allIssues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No seller/store naming inconsistencies found`);
+        console.log("   All naming follows the convention.\n");
+        return;
+    }
+    // Group by file
+    const byFile = new Map();
+    for (const issue of allIssues) {
+        const existing = byFile.get(issue.file) || [];
+        existing.push(issue);
+        byFile.set(issue.file, existing);
+    }
+    console.log(`\n${console_chars_1.emoji.warning} Found ${allIssues.length} potential naming inconsistencies:\n`);
+    const limit = isVerbose ? byFile.size : 5;
+    let shown = 0;
+    for (const [file, issues] of byFile) {
+        if (shown >= limit)
+            break;
+        console.log(`   ${file}:`);
+        for (const issue of issues.slice(0, isVerbose ? issues.length : 3)) {
+            console.log(`      L${issue.line}: "${issue.pattern}" → ${issue.suggestion}`);
+        }
+        if (!isVerbose && issues.length > 3) {
+            console.log(`      ... and ${issues.length - 3} more`);
+        }
+        console.log();
+        shown++;
+    }
+    if (!isVerbose && byFile.size > limit) {
+        console.log(`   ... and ${byFile.size - limit} more files\n`);
+    }
+    console.log("─".repeat(60));
+    console.log(`${console_chars_1.emoji.info} Naming Convention:`);
+    console.log("   • store_ = entity properties (store_scans, store_settings)");
+    console.log("   • seller_ = role/actions (sellerApproved, isSeller)");
+    console.log("\n   See: #quick-decisions → 'Which Naming Convention?'\n");
+    // This is a warning-only check, doesn't block
+    console.log(`${console_chars_1.emoji.success} PASSED (${allIssues.length} warnings for review)\n`);
+}
+main();
+//# sourceMappingURL=seller-store-naming-consistency.js.map

package/dist/checks/governance/seller-store-naming-consistency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-store-naming-consistency.js","sourceRoot":"","sources":["../../../src/checks/governance/seller-store-naming-consistency.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAC7B,6DAAkD;AAGlD,iBAAiB;AACJ,QAAA,EAAE,GAAG,4CAA4C,CAAC;AAClD,QAAA,IAAI,GAAG,iCAAiC,CAAC;AACzC,QAAA,QAAQ,GAAG,YAAY,CAAC;AACxB,QAAA,QAAQ,GAAG,KAAK,CAAC;AACjB,QAAA,WAAW,GAAG,8CAA8C,CAAC;AAC7D,QAAA,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;AAUnC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAC3B,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;AAE/C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAE3C,qEAAqE;AACrE,MAAM,0BAA0B,GAAG;IACjC,EAAE,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,qCAAqC,EAAE;IACjF,EAAE,KAAK,EAAE,yBAAyB,EAAE,UAAU,EAAE,oCAAoC,EAAE;IACtF,EAAE,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,qCAAqC,EAAE;IACjF,EAAE,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,oCAAoC,EAAE;IACnF,EAAE,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,4BAA4B,EAAE;IAC1E,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,oCAAoC,EAAE;IACjF,EAAE,KAAK,EAAE,yBAAyB,EAAE,UAAU,EAAE,mCAAmC,EAAE;IACrF,EAAE,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,6BAA6B,EAAE;CAC1E,CAAC;AAEF,0CAA0C;AAC1C,MAAM,qBAAqB,GAAG;IAC5B,qBAAqB,EAAE,0BAA0B;IACjD,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;IAC9C,qBAAqB,EAAE,qBAAqB;IAC5C,gBAAgB,EAAE,eAAe;IACjC,gBAAgB,EAAE,mBAAmB;IACrC,gBAAgB,EAAE,mBAAmB;IACrC,kBAAkB,EAAE,qBAAqB;IACzC,mBAAmB,EAAE,oBAAoB;IACzC,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,aAAa;IAC3B,mBAAmB,EAAE,yBAAyB;IAC9C,gBAAgB,EAAE,8CAA8C;IAChE,eAAe,EAAE,OAAO;IACxB,qBAAqB,EAAE,eAAe;IACtC,oBAAoB,EAAE,8BAA8B;IACpD,4BAA4B,EAAE,qBAAqB;IACnD,uBAAuB,EAAE,YAAY;IACrC,mBAAmB,EAAE,oCAAoC;IACzD,kBAAkB,EAAE,6BAA6B;IACjD,aAAa,EAAE,6BAA6B;IAC5C,YAAY,EAAE,0BAA0B;CACzC,CAAC;AAEF,wBAAwB;AACxB,MAAM,eAAe,GAAG;IACtB,cAAc;IACd,QAAQ;IACR,MAAM;IACN,UAAU;IACV,OAAO;IACP,YAAY,EAAE,mCAAmC;IACjD,gBAAgB,EAAE,+BAA+B;IACjD,qBAAqB,EAAE,YAAY;IACnC,oBAAoB,EAAE,kBAAkB;IACxC,qBAAqB,EAAE,gBAAgB;CACxC,CAAC;AAEF,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE9C,IAAI,YAAY,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAEzC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QAEtB,gBAAgB;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpF,SAAS;QACX,CAAC;QAED,2CAA2C;QAC3C,IAAI,kBAAkB,CAAC,IAAI,CAAC;YAAE,SAAS;QAEvC,gCAAgC;QAChC,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,0BAA0B,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;oBACjB,UAAU;oBACV,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,gCAAgC;iBAC/E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC7E,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,IAAI;IACX,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,MAAM,qCAAqC,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAY,EAAE,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,+CAA+C,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,UAAU,SAAS,CAAC,MAAM,sCAAsC,CAAC,CAAC;IAEhG,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,IAAI,KAAK,IAAI,KAAK;YAAE,MAAM;QAE1B,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,KAAK,EAAE,CAAC;IACV,CAAC;IAED,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,IAAI,GAAG,KAAK,eAAe,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,IAAI,qBAAqB,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IAEzE,8CAA8C;IAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,YAAY,SAAS,CAAC,MAAM,yBAAyB,CAAC,CAAC;AACrF,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/checks/governance/store-seller-route-names.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env tsx
+/**
+ * Store vs Seller Route Naming (BLOCKING)
+ *
+ * Canonical seller workspace routes: /store/*
+ * Legacy compatibility routes: /seller/* (allowed only in app/seller re-export pages)
+ *
+ * This preflight prevents drift by forbidding new /seller/* route usage in
+ * application code.
+ */
+export declare const id = "governance/store-seller-route-names";
+export declare const name = "Store Seller Route Names";
+export declare const category = "governance";
+export declare const blocking = true;
+export declare const description = "Store vs Seller Route Naming (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=store-seller-route-names.d.ts.map

package/dist/checks/governance/store-seller-route-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-seller-route-names.d.ts","sourceRoot":"","sources":["../../../src/checks/governance/store-seller-route-names.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAQH,eAAO,MAAM,EAAE,wCAAwC,CAAC;AACxD,eAAO,MAAM,IAAI,6BAA6B,CAAC;AAC/C,eAAO,MAAM,QAAQ,eAAe,CAAC;AACrC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,4CAA4C,CAAC;AACrE,eAAO,MAAM,IAAI,UAAiB,CAAC"}

package/dist/checks/governance/store-seller-route-names.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Store vs Seller Route Naming (BLOCKING)
+ *
+ * Canonical seller workspace routes: /store/*
+ * Legacy compatibility routes: /seller/* (allowed only in app/seller re-export pages)
+ *
+ * This preflight prevents drift by forbidding new /seller/* route usage in
+ * application code.
+ */
+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");
+// Check metadata
+exports.id = "governance/store-seller-route-names";
+exports.name = "Store Seller Route Names";
+exports.category = "governance";
+exports.blocking = true;
+exports.description = "Store vs Seller Route Naming (BLOCKING)";
+exports.tags = ["governance"];
+const ROOT = process.cwd();
+const SCAN_DIRS = ["app", "components", "lib", "email-templates"];
+const IGNORE_PREFIXES = [
+    // Legacy alias route implementations live here and may contain /seller links.
+    "app/seller/",
+    // Robots disallow may include /seller (legacy + safety)
+    "app/robots.ts",
+    // URL mapping legitimately handles both /store and /seller during migration.
+    "lib/navigation/url-mapping.ts",
+    // Proxy/middleware matcher supports both.
+    "proxy.ts",
+];
+function toPosix(p) {
+    return p.replaceAll("\\", "/");
+}
+function shouldIgnore(rel) {
+    const r = toPosix(rel);
+    return IGNORE_PREFIXES.some((prefix) => r.startsWith(prefix));
+}
+function listFiles(dirAbs) {
+    const out = [];
+    if (!fs.existsSync(dirAbs))
+        return out;
+    const entries = fs.readdirSync(dirAbs, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name.startsWith("."))
+            continue;
+        const full = path.join(dirAbs, entry.name);
+        if (entry.isDirectory()) {
+            // Skip build output and deps just in case
+            if (["node_modules", ".next", "dist", "coverage", ".turbo"].includes(entry.name))
+                continue;
+            out.push(...listFiles(full));
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        if (!/\.(ts|tsx|js|jsx)$/.test(entry.name))
+            continue;
+        out.push(full);
+    }
+    return out;
+}
+function findSellerRouteRefs(fileAbs) {
+    const rel = toPosix(path.relative(ROOT, fileAbs));
+    if (shouldIgnore(rel))
+        return [];
+    let content = "";
+    try {
+        content = fs.readFileSync(fileAbs, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const offenses = [];
+    const lines = content.split("\n");
+    // Only flag actual URL path usage of `/seller/*`.
+    // Avoid false positives like `components/seller/...` by requiring a boundary.
+    // Examples caught:
+    //   "/seller/dashboard"
+    //   callbackUrl=/seller/dashboard
+    //   `${SITE_URL}/seller/...`
+    const matcher = /(^|[^A-Za-z0-9_-])\/seller(?:\/|$|\?|#)/g;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Don't block on comments or doc strings
+        if (trimmed.startsWith("//") ||
+            trimmed.startsWith("/*") ||
+            trimmed.startsWith("*") ||
+            trimmed.startsWith("*/")) {
+            continue;
+        }
+        if (!matcher.test(line))
+            continue;
+        // Allow the rare case of external URLs containing /seller on other domains
+        // (e.g. whatnot.com/seller). Heuristic: if line contains "http" and not SITE_URL/base.
+        if (/https?:\/\//.test(line) && !/SITE_URL|NEXT_PUBLIC_BASE_URL/.test(line)) {
+            continue;
+        }
+        offenses.push({
+            file: rel,
+            line: i + 1,
+            snippet: line.trim().slice(0, 240),
+        });
+    }
+    return offenses;
+}
+function main() {
+    const offenders = [];
+    for (const dir of SCAN_DIRS) {
+        const abs = path.join(ROOT, dir);
+        for (const file of listFiles(abs)) {
+            offenders.push(...findSellerRouteRefs(file));
+        }
+    }
+    if (offenders.length === 0) {
+        console.log(`${console_chars_1.emoji.success} Store vs Seller route naming: OK (no new /seller/* usage)`);
+        return;
+    }
+    console.error(`${console_chars_1.emoji.error} Store vs Seller route naming violations`);
+    console.error("   Canonical seller workspace is /store/* (legacy /seller/* is restricted)");
+    console.error("");
+    for (const o of offenders.slice(0, 80)) {
+        console.error(`  - ${o.file}:${o.line}  ${o.snippet}`);
+    }
+    if (offenders.length > 80) {
+        console.error(`\n  ...and ${offenders.length - 80} more`);
+    }
+    console.error("\nFix: replace /seller/* with /store/* in app/components/lib code.");
+    process.exit(1);
+}
+main();
+//# sourceMappingURL=store-seller-route-names.js.map

package/dist/checks/governance/store-seller-route-names.js.map

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

package/dist/checks/grading-config-usage.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env tsx
+/**
+ * Grading Config Usage Preflight
+ *
+ * Ensures the centralized grading config (lib/grading/grading-config.ts) is used
+ * consistently across the codebase. Detects:
+ *
+ * 1. Hardcoded grade validation that should use the config
+ * 2. Hardcoded grading company lists that might drift
+ * 3. Magic numbers for grade min/max values
+ *
+ * Usage:
+ *   pnpm tsx scripts/active/preflights/code-quality/grading-config-usage.ts
+ */
+interface Violation {
+    file: string;
+    line: number;
+    issue: string;
+    snippet: string;
+}
+declare function detectViolations(): Promise<Violation[]>;
+export { detectViolations };
+//# sourceMappingURL=grading-config-usage.d.ts.map

package/dist/checks/grading-config-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grading-config-usage.d.ts","sourceRoot":"","sources":["../../src/checks/grading-config-usage.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAOH,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AA+CD,iBAAe,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAiEtD;AA0DD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}