@empline/preflight 1.0.20

package/dist/checks/file-naming-conventions.js

@@ -0,0 +1,1258 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * File Naming Conventions Preflight (BLOCKING)
+ *
+ * Enforces consistent file naming across the codebase.
+ *
+ * BLOCKING: Fails build if violations found.
+ *
+ * Usage:
+ *   pnpm preflight:file-naming              - BLOCKING mode
+ *   pnpm preflight:file-naming --warning    - Warning mode
+ *   pnpm preflight:file-naming --verbose    - Show all files checked
+ *   pnpm preflight:file-naming --fix-preview - Show suggested renames
+ */
+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 glob_1 = require("glob");
+const path = __importStar(require("path"));
+const console_chars_1 = require("../utils/console-chars");
+const universal_progress_reporter_1 = require("./system/universal-progress-reporter");
+const findings_writer_1 = require("../utils/findings-writer");
+// Check metadata
+exports.id = "misc/file-naming-conventions";
+exports.name = "File Naming Conventions";
+exports.category = "misc";
+exports.blocking = true;
+exports.description = "File Naming Conventions Preflight (BLOCKING)";
+exports.tags = ["misc"];
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+// CONFIGURATION
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+const APP_ROUTER_RESERVED = new Set([
+    // Core route files
+    "page.tsx",
+    "page.ts",
+    "layout.tsx",
+    "layout.ts",
+    "loading.tsx",
+    "loading.ts",
+    "error.tsx",
+    "error.ts",
+    "global-error.tsx",
+    "global-error.ts",
+    "not-found.tsx",
+    "not-found.ts",
+    "template.tsx",
+    "template.ts",
+    "default.tsx",
+    "default.ts",
+    "head.tsx",
+    "head.ts",
+    "route.tsx",
+    "route.ts",
+    // Metadata helpers
+    "generateMetadata.ts",
+    "generateMetadata.tsx",
+    "generateStaticParams.ts",
+    "generateStaticParams.tsx",
+    "viewport.ts",
+    "viewport.tsx",
+    // Assets / manifest
+    "opengraph-image.tsx",
+    "twitter-image.tsx",
+    "icon.tsx",
+    "apple-icon.tsx",
+    "sitemap.ts",
+    "sitemap.xml",
+    "robots.ts",
+    "robots.txt",
+    "manifest.ts",
+    "manifest.json",
+    "providers.tsx",
+]);
+const CONFIG = {
+    // Directories to scan
+    includeDirs: [
+        "app",
+        "components",
+        "lib",
+        "hooks",
+        "contexts",
+        "types",
+        "scripts",
+        "tests",
+        "packages",
+    ],
+    // Files/directories to skip
+    excludePatterns: [
+        "**/node_modules/**",
+        "**/.next/**",
+        "**/dist/**",
+        "**/coverage/**",
+        "**/.git/**",
+        "**/test-results/**",
+        "**/*.d.ts",
+        "**/prisma/migrations/**",
+        "**/__mocks__/**",
+        "**/backups/**",
+    ],
+    // Fixed filenames that are always valid
+    fixedNames: new Set([
+        ...APP_ROUTER_RESERVED,
+        "middleware.ts",
+        "middleware.tsx",
+        "index.ts",
+        "index.tsx",
+        "index.js",
+        "types.ts",
+        "constants.ts",
+        "utils.ts",
+        "utils.tsx",
+        "helpers.ts",
+        "helpers.tsx",
+        "config.ts",
+        "schema.ts",
+        "seed.ts",
+        "setup.ts",
+        "teardown.ts",
+        "presets.ts",
+        "presets.tsx",
+        "variants.ts",
+        "variants.tsx",
+        "jest.config.js",
+        "jest.config.ts",
+        "jest.setup.ts",
+        "jest.setup.js",
+        "vitest.config.ts",
+        "playwright.config.ts",
+        "playwright.env.ts",
+        "auth.setup.ts",
+        "global.setup.ts",
+        "global.teardown.ts",
+        "tailwind.config.ts",
+        "postcss.config.mjs",
+        "next.config.js",
+        "next.config.mjs",
+        "tsconfig.json",
+        "package.json",
+        ".env",
+        ".env.local",
+        ".env.development",
+        ".env.production",
+        ".env.test",
+        "README.md",
+        "CHANGELOG.md",
+        "LICENSE",
+    ]),
+    // Filename suffixes that modify the base convention
+    // These are appended to the base name with a dot
+    validSuffixes: new Set([
+        ".server", // Next.js server-only files
+        ".client", // Next.js client-only files
+        ".stories", // Storybook stories
+        ".examples", // Component examples
+        ".test", // Test files
+        ".spec", // Spec files
+        ".e2e", // E2E test files
+        ".worker", // Web Worker files
+        ".mock", // Mock files
+        ".fixture", // Test fixtures
+        ".config", // Config files
+        ".seller", // Seller-specific tests
+        ".admin", // Admin-specific tests
+        ".buyer", // Buyer-specific tests
+        ".auth", // Auth-specific tests
+    ]),
+};
+// Helper to strip valid suffixes from filename for validation
+function stripSuffixes(filename) {
+    let result = filename;
+    for (const suffix of CONFIG.validSuffixes) {
+        // Match suffix before extension (e.g., Button.stories.tsx -> Button.tsx)
+        const suffixPattern = new RegExp(`\\${suffix}\\.(tsx?|jsx?|js|mjs)$`);
+        if (suffixPattern.test(result)) {
+            result = result.replace(suffix, "");
+        }
+    }
+    return result;
+}
+// Helper to check if filename has valid suffix pattern
+function hasValidSuffix(filename) {
+    for (const suffix of CONFIG.validSuffixes) {
+        if (filename.includes(suffix + ".")) {
+            return true;
+        }
+    }
+    return false;
+}
+const NAMING_RULES = [
+    // Components directory - PascalCase (with optional suffixes like .stories, .examples)
+    {
+        pattern: /^components\/.*\.(tsx|jsx)$/,
+        convention: "PascalCase",
+        description: "React components must use PascalCase",
+        examples: ["UserCard.tsx", "ProductGrid.tsx", "Button.stories.tsx"],
+        validator: (name) => {
+            const stripped = stripSuffixes(name);
+            return /^[A-Z][a-zA-Z0-9]*\.(tsx|jsx)$/.test(stripped);
+        },
+        suggestFix: (name) => toPascalCase(name.replace(/\.(tsx|jsx)$/, "")) + path.extname(name),
+    },
+    // Lib directory - kebab-case (with optional suffixes like .server, .worker)
+    {
+        pattern: /^lib\/.*\.(ts|js)$/,
+        convention: "kebab-case",
+        description: "Library files must use kebab-case",
+        examples: ["user-service.ts", "api-utils.ts", "listing-utils.server.ts"],
+        validator: (name) => {
+            const stripped = stripSuffixes(name);
+            // Allow numbers in kebab-case (e.g., 130point-scraper.ts)
+            return /^[a-z0-9][a-z0-9]*(-[a-z0-9]+)*\.(ts|js)$/.test(stripped);
+        },
+        suggestFix: (name) => toKebabCase(name.replace(/\.(ts|js)$/, "")) + path.extname(name),
+    },
+    // Hooks directory - kebab-case starting with "use-" OR camelCase starting with "use"
+    {
+        pattern: /^hooks\/.*\.(ts|tsx)$/,
+        convention: "camelCase",
+        description: "Hooks must start with 'use' (useAuth.ts or use-auth.ts)",
+        examples: ["useAuth.ts", "useCart.ts", "use-local-storage.ts"],
+        validator: (name) => {
+            // Allow both useAuth.ts (camelCase) and use-auth.ts (kebab-case)
+            return (/^use[A-Z][a-zA-Z0-9]*\.(ts|tsx)$/.test(name) ||
+                /^use-[a-z][a-z0-9]*(-[a-z0-9]+)*\.(ts|tsx)$/.test(name));
+        },
+        suggestFix: (name) => {
+            const base = name.replace(/\.(ts|tsx)$/, "");
+            if (!base.startsWith("use")) {
+                return "use" + toPascalCase(base) + path.extname(name);
+            }
+            if (/^use-[a-z0-9-]+$/.test(base)) {
+                return "use" + toPascalCase(base.replace(/^use-/, "")) + path.extname(name);
+            }
+            return name; // Already valid
+        },
+    },
+    // Contexts directory - PascalCase ending with Context
+    {
+        pattern: /^contexts\/.*\.(tsx|ts)$/,
+        convention: "PascalCase",
+        description: "Context files must use PascalCase (preferably ending with Context)",
+        examples: ["AuthContext.tsx", "CartContext.tsx", "ThemeContext.tsx"],
+        validator: (name) => /^[A-Z][a-zA-Z0-9]*\.(tsx|ts)$/.test(name),
+        suggestFix: (name) => toPascalCase(name.replace(/\.(tsx|ts)$/, "")) + path.extname(name),
+    },
+    // Types directory - kebab-case
+    {
+        pattern: /^types\/.*\.(ts)$/,
+        convention: "kebab-case",
+        description: "Type definition files must use kebab-case",
+        examples: ["api-types.ts", "user-types.ts", "product-types.ts"],
+        validator: (name) => /^[a-z][a-z0-9]*(-[a-z0-9]+)*\.ts$/.test(name),
+        suggestFix: (name) => toKebabCase(name.replace(/\.ts$/, "")) + ".ts",
+    },
+    // Scripts directory - kebab-case (allow numbers, underscores for legacy)
+    {
+        pattern: /^scripts\/.*\.(ts|js|mjs)$/,
+        convention: "kebab-case",
+        description: "Script files must use kebab-case",
+        examples: ["run-migrations.ts", "seed-database.ts", "404-detector.ts"],
+        validator: (name) => {
+            const stripped = stripSuffixes(name);
+            // Allow numbers at start (404-detector.ts), underscores for legacy (inspect_tables.ts)
+            return /^[a-z0-9][a-z0-9_]*(-[a-z0-9_]+)*\.(ts|js|mjs)$/.test(stripped);
+        },
+        suggestFix: (name) => toKebabCase(name.replace(/\.(ts|js|mjs)$/, "")) + path.extname(name),
+    },
+    // Test files - kebab-case OR PascalCase (for component tests)
+    {
+        pattern: /^tests\/.*\.(ts|tsx|js|jsx)$/,
+        convention: "kebab-case",
+        description: "Test files must use kebab-case or PascalCase (for component tests)",
+        examples: ["user-service.test.ts", "auth-flow.spec.ts", "CartContext.test.tsx"],
+        validator: (name) => {
+            const stripped = stripSuffixes(name);
+            // Allow kebab-case (user-service.test.ts)
+            if (/^[a-z][a-z0-9]*(-[a-z0-9]+)*\.(ts|tsx|js|jsx)$/.test(stripped)) {
+                return true;
+            }
+            // Allow PascalCase for component tests (CartContext.test.tsx)
+            if (/^[A-Z][a-zA-Z0-9]*\.(ts|tsx|js|jsx)$/.test(stripped)) {
+                return true;
+            }
+            // Allow camelCase for specific patterns (normalizeHashNumberSpacing.test.ts)
+            if (/^[a-z][a-zA-Z0-9]*\.(ts|tsx|js|jsx)$/.test(stripped)) {
+                return true;
+            }
+            // Allow dot-separated kebab-case (empty-states.wishlist.spec.ts)
+            if (/^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)*\.(ts|tsx|js|jsx)$/.test(stripped)) {
+                return true;
+            }
+            // Allow dot-separated with camelCase segments (text-utils.normalizeHashNumberSpacing.test.ts)
+            if (/^[a-z][a-z0-9-]*(\.[a-zA-Z][a-zA-Z0-9]*)*\.(ts|tsx|js|jsx)$/.test(stripped)) {
+                return true;
+            }
+            return false;
+        },
+        suggestFix: (name) => name, // Don't suggest fixes for tests - multiple conventions allowed
+    },
+    // App directory Client components - PascalCase ending with Client
+    {
+        pattern: /^app\/.*Client\.(tsx|ts)$/,
+        convention: "PascalCase",
+        description: "Client components in app/ must use PascalCase ending with 'Client'",
+        examples: ["ProductsClient.tsx", "DashboardClient.tsx", "SettingsClient.tsx"],
+        validator: (name) => /^[A-Z][a-zA-Z0-9]*Client\.(tsx|ts)$/.test(name),
+        suggestFix: (name) => {
+            const base = name.replace(/Client\.(tsx|ts)$/, "").replace(/\.(tsx|ts)$/, "");
+            return toPascalCase(base) + "Client" + path.extname(name);
+        },
+    },
+    // App directory _components - PascalCase
+    {
+        pattern: /^app\/.*\/_components\/.*\.(tsx|jsx)$/,
+        convention: "PascalCase",
+        description: "Components in app/_components/ must use PascalCase",
+        examples: ["ProductFilters.tsx", "SearchBar.tsx", "Pagination.tsx"],
+        validator: (name) => /^[A-Z][a-zA-Z0-9]*\.(tsx|jsx)$/.test(name),
+        suggestFix: (name) => toPascalCase(name.replace(/\.(tsx|jsx)$/, "")) + path.extname(name),
+    },
+    // App directory utils folders - kebab-case for .ts, PascalCase for .tsx
+    {
+        pattern: /^app\/.*\/utils\/.*\.(ts)$/,
+        convention: "kebab-case",
+        description: "Utility files (.ts) in app/*/utils/ must use kebab-case",
+        examples: ["seller-helpers.ts", "format-utils.ts", "api-helpers.ts"],
+        validator: (name) => /^[a-z][a-z0-9]*(-[a-z0-9]+)*\.ts$/.test(name),
+        suggestFix: (name) => toKebabCase(name.replace(/\.ts$/, "")) + ".ts",
+    },
+    // App directory utils folders - .tsx files should be PascalCase (they contain JSX)
+    {
+        pattern: /^app\/.*\/utils\/.*\.(tsx)$/,
+        convention: "PascalCase",
+        description: "TSX files in app/*/utils/ must use PascalCase (contain JSX components)",
+        examples: ["SellerHelpers.tsx", "StatusChips.tsx", "ActionButtons.tsx"],
+        validator: (name) => /^[A-Z][a-zA-Z0-9]*\.tsx$/.test(name),
+        suggestFix: (name) => toPascalCase(name.replace(/\.tsx$/, "")) + ".tsx",
+    },
+    // App directory general .tsx files (not in _components, not *Client) - PascalCase
+    // This catches data files, helper components, etc.
+    {
+        pattern: /^app\/.*\.(tsx)$/,
+        convention: "PascalCase",
+        description: "TSX files in app/ must use PascalCase (they contain JSX)",
+        examples: ["BlogData.tsx", "ChecklistsContent.tsx", "PerformanceDashboard.tsx"],
+        validator: (name) => {
+            // Skip Next.js special files
+            if (isAppRouterReservedFile(name)) {
+                return true;
+            }
+            // Skip *Client.tsx (handled by separate rule)
+            if (/Client\.tsx$/.test(name)) {
+                return true;
+            }
+            // Skip files with valid suffixes (.stories.tsx, .test.tsx, etc.) - validate base name
+            if (hasValidSuffix(name)) {
+                const stripped = stripSuffixes(name);
+                return /^[A-Z][a-zA-Z0-9]*\.tsx$/.test(stripped);
+            }
+            // Must be PascalCase
+            return /^[A-Z][a-zA-Z0-9]*\.tsx$/.test(name);
+        },
+        suggestFix: (name) => toPascalCase(name.replace(/\.tsx$/, "")) + ".tsx",
+    },
+    // Storybook MDX stories - PascalCase base name
+    {
+        pattern: /^components\/.*\.stories\.mdx$/,
+        convention: "PascalCase",
+        description: "Storybook MDX stories must mirror component PascalCase names",
+        examples: ["Button.stories.mdx", "ProductGrid.stories.mdx"],
+        validator: (name) => {
+            const base = name.replace(/\.stories\.mdx$/, "");
+            return /^[A-Z][a-zA-Z0-9]*$/.test(base);
+        },
+        suggestFix: (name) => {
+            const base = name.replace(/\.stories\.mdx$/, "");
+            return toPascalCase(base) + ".stories.mdx";
+        },
+    },
+    // Packages UI components - PascalCase
+    {
+        pattern: /^packages\/ui\/.*\.(tsx|jsx)$/,
+        convention: "PascalCase",
+        description: "UI package components must use PascalCase",
+        examples: ["Button.tsx", "Card.tsx", "Dialog.tsx"],
+        validator: (name) => /^[A-Z][a-zA-Z0-9]*\.(tsx|jsx)$/.test(name),
+        suggestFix: (name) => toPascalCase(name.replace(/\.(tsx|jsx)$/, "")) + path.extname(name),
+    },
+    // Other packages - kebab-case utilities/entrypoints
+    {
+        pattern: /^packages\/(?!ui\/).*\.(ts|tsx|js|jsx)$/,
+        convention: "kebab-case",
+        description: "Package source files must use kebab-case (non-UI packages)",
+        examples: ["packages/api-client/client.ts", "packages/utils/logger.ts"],
+        validator: (name) => {
+            const stripped = stripSuffixes(name);
+            return /^[a-z0-9][a-z0-9]*(-[a-z0-9]+)*\.(ts|tsx|js|jsx)$/.test(stripped);
+        },
+        suggestFix: (name) => toKebabCase(name.replace(/\.(ts|tsx|js|jsx)$/, "")) + path.extname(name),
+    },
+];
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+// UTILITY FUNCTIONS
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+function toPascalCase(str) {
+    return str
+        .replace(/[-_](.)/g, (_, char) => char.toUpperCase())
+        .replace(/^(.)/, (_, char) => char.toUpperCase());
+}
+function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, "$1-$2")
+        .replace(/[_\s]+/g, "-")
+        .toLowerCase();
+}
+function toCamelCase(str) {
+    return str
+        .replace(/[-_](.)/g, (_, char) => char.toUpperCase())
+        .replace(/^(.)/, (_, char) => char.toLowerCase());
+}
+function isAppRouterReservedFile(filename) {
+    return APP_ROUTER_RESERVED.has(filename);
+}
+function normalizeShadowPath(relativePath) {
+    const parts = relativePath.split("/");
+    if (parts.length < 2)
+        return null;
+    const [root, ...rest] = parts;
+    if (root === "packages" && rest.length >= 2 && rest[1] === "src") {
+        // packages/<name>/src/... -> normalize to ...
+        return rest.slice(2).join("/");
+    }
+    if (root === "packages" && rest.length >= 1) {
+        return rest.slice(1).join("/");
+    }
+    return rest.join("/");
+}
+function safeRead(absPath) {
+    try {
+        return fs.readFileSync(absPath, "utf8");
+    }
+    catch (error) {
+        return null;
+    }
+}
+class FileNamingValidator {
+    violations = [];
+    warnings = [];
+    info = [];
+    filesChecked = 0;
+    dirSummaries = [];
+    allFiles = [];
+    basenameMap = new Map();
+    lowerCaseMap = new Map();
+    storyIndex = new Map();
+    storyPathIndex = new Map();
+    componentIndex = new Map();
+    relativePathMap = new Map();
+    dirSegments = new Set();
+    defaultExportCandidates = [];
+    packageEntrypoints = [];
+    verbose;
+    warningOnly;
+    fixPreview;
+    statsOnly;
+    noFailFast;
+    checkDuplicates;
+    requireStories;
+    barrelWarn;
+    configGuard;
+    reservedGuard;
+    snapshotGuard;
+    clientServerGuard;
+    dirNameGuard;
+    uiExportGuard;
+    mdxGuard;
+    e2eGroupingGuard;
+    suggestionCache = new Map();
+    constructor(options = {}) {
+        this.verbose = options.verbose || false;
+        this.warningOnly = options.warningOnly || false;
+        this.fixPreview = options.fixPreview || false;
+        this.statsOnly = options.statsOnly || false;
+        this.noFailFast = options.noFailFast || false;
+        this.checkDuplicates = options.checkDuplicates || false;
+        this.requireStories = options.requireStories || false;
+        this.barrelWarn = options.barrelWarn || false;
+        this.configGuard = options.configGuard || false;
+        this.reservedGuard = options.reservedGuard || false;
+        this.snapshotGuard = options.snapshotGuard || false;
+        this.clientServerGuard = options.clientServerGuard || false;
+        this.dirNameGuard = options.dirNameGuard || false;
+        this.uiExportGuard = options.uiExportGuard || false;
+        this.mdxGuard = options.mdxGuard || false;
+        this.e2eGroupingGuard = options.e2eGroupingGuard || false;
+    }
+    async validate() {
+        console.log("\n" + (0, console_chars_1.createDivider)(80, "double"));
+        console.log("  FILE NAMING CONVENTIONS VALIDATOR (BLOCKING)");
+        console.log((0, console_chars_1.createDivider)(80, "double"));
+        let shortCircuited = false;
+        for (const dir of CONFIG.includeDirs) {
+            const files = await this.findFiles(dir);
+            let dirChecked = 0;
+            const before = this.violations.length;
+            for (const file of files) {
+                dirChecked += 1;
+                this.checkFile(file);
+                if (!this.noFailFast && !this.warningOnly && this.violations.length > before) {
+                    shortCircuited = true;
+                    break;
+                }
+            }
+            const after = this.violations.length;
+            this.dirSummaries.push({ dir, scanned: dirChecked, violations: after - before });
+            if (shortCircuited) {
+                if (this.verbose) {
+                    console.log(`${console_chars_1.emoji.stop} Stopped after detecting violations in ${dir}/ (fail-fast)`);
+                }
+                break;
+            }
+        }
+        if (!shortCircuited || this.noFailFast) {
+            this.runPostValidations();
+        }
+        (0, findings_writer_1.writeFindings)(this.violations.map((v) => ({
+            severity: this.warningOnly ? "warning" : "error",
+            message: `File naming violation: ${v.rule.description}`,
+            file: v.file,
+            code: "file-naming",
+        })));
+        this.printReport();
+        return this.violations.length === 0;
+    }
+    async findFiles(dir) {
+        const pattern = `${dir}/**/*.{ts,tsx,js,jsx,mdx}`;
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: CONFIG.excludePatterns,
+            nodir: true,
+        });
+        return matches;
+    }
+    checkFile(filePath) {
+        const filename = path.basename(filePath);
+        const relativePath = filePath.replace(/\\/g, "/");
+        const basenameNoExt = path.parse(stripSuffixes(filename)).name;
+        const dir = path.dirname(relativePath);
+        this.filesChecked++;
+        this.allFiles.push(relativePath);
+        // Track basenames for collision and casing drift detection
+        if (!this.basenameMap.has(basenameNoExt))
+            this.basenameMap.set(basenameNoExt, []);
+        this.basenameMap.get(basenameNoExt).push(relativePath);
+        const lower = basenameNoExt.toLowerCase();
+        if (!this.lowerCaseMap.has(lower))
+            this.lowerCaseMap.set(lower, new Set());
+        this.lowerCaseMap.get(lower).add(basenameNoExt);
+        // Track components and stories for parity checks
+        const dirSet = this.componentIndex.get(dir) || new Set();
+        this.componentIndex.set(dir, dirSet);
+        const storySet = this.storyIndex.get(dir) || new Set();
+        this.storyIndex.set(dir, storySet);
+        const storyPathMap = this.storyPathIndex.get(dir) || new Map();
+        this.storyPathIndex.set(dir, storyPathMap);
+        if (/\.stories\.(tsx|mdx)$/.test(filename)) {
+            const storyBase = basenameNoExt.replace(/\.stories$/, "");
+            storySet.add(storyBase);
+            storyPathMap.set(storyBase, relativePath);
+        }
+        if (/(\.tsx|\.jsx)$/.test(filename)) {
+            dirSet.add(basenameNoExt);
+        }
+        // Track relative path (minus root) for shadowing detection
+        const shadowKey = normalizeShadowPath(relativePath);
+        if (shadowKey) {
+            const arr = this.relativePathMap.get(shadowKey) || [];
+            arr.push(relativePath);
+            this.relativePathMap.set(shadowKey, arr);
+        }
+        // Track directory segments for naming guard
+        const segments = relativePath.split("/");
+        segments.pop();
+        for (let i = 1; i <= segments.length; i++) {
+            const sub = segments.slice(0, i).join("/");
+            this.dirSegments.add(sub);
+        }
+        // Default export check candidates (components/app/ui packages only)
+        if (/(components\/|app\/|packages\/ui\/).*(\.tsx|\.jsx)$/.test(relativePath) &&
+            !hasValidSuffix(filename)) {
+            this.defaultExportCandidates.push(relativePath);
+        }
+        // Package entrypoints under packages/*/src
+        if (/^packages\/[^/]+\/src\/[^/]+\.(ts|tsx|js|jsx)$/.test(relativePath)) {
+            this.packageEntrypoints.push(relativePath);
+        }
+        // Skip fixed names
+        if (CONFIG.fixedNames.has(filename)) {
+            if (this.verbose) {
+                this.info.push(`${console_chars_1.chars.check} ${relativePath} (fixed name)`);
+            }
+            return false;
+        }
+        // Skip directories that start with underscore (Next.js private folders)
+        if (relativePath.includes("/_") && !relativePath.includes("/_components/")) {
+            if (this.verbose) {
+                this.info.push(`${console_chars_1.chars.check} ${relativePath} (private folder)`);
+            }
+            return false;
+        }
+        // Reject spaces in filenames
+        if (filename.includes(" ")) {
+            this.violations.push({
+                file: relativePath,
+                rule: {
+                    pattern: /.*/,
+                    convention: "kebab-case",
+                    description: "Filenames must not contain spaces",
+                    examples: ["my-file.ts"],
+                    validator: () => false,
+                },
+                filename,
+            });
+            return true;
+        }
+        // Reject underscores outside scripts/ legacy allowance
+        if (!relativePath.startsWith("scripts/") &&
+            filename.includes("_") &&
+            !/^__.*__$/.test(filename)) {
+            this.addViolation("Use kebab-case instead of underscores", "kebab-case", ["my-file.ts"], relativePath);
+            return true;
+        }
+        // Config / fixture suffix enforcement (exact keyword endings only)
+        const base = path.parse(filename).name;
+        const isConfigName = /(?:^|[-_.])config$/i.test(base);
+        const hasConfigSuffix = /\.config\.(ts|js|mjs|tsx|jsx)$/i.test(filename);
+        const hasDashConfig = /[-_.]config\.(ts|js|mjs|tsx|jsx)$/i.test(filename);
+        if (isConfigName && !(hasConfigSuffix || hasDashConfig)) {
+            this.addViolation("Config files must use .config.<ext> suffix", "kebab-case", ["app.config.ts"], relativePath, relativePath.replace(path.basename(relativePath), `${base}.config${path.extname(filename)}`));
+            return true;
+        }
+        const isFixtureName = /(?:^|[-_.])fixtures?$/i.test(base);
+        const hasFixtureSuffix = /\.fixtures?\.(ts|js|mjs|tsx|jsx)$/i.test(filename);
+        const hasDashFixture = /[-_.]fixtures?\.(ts|js|mjs|tsx|jsx)$/i.test(filename);
+        if (isFixtureName && !(hasFixtureSuffix || hasDashFixture)) {
+            this.addViolation("Fixture files must use .fixture(s).<ext> suffix", "kebab-case", ["user.fixture.ts"], relativePath, relativePath.replace(path.basename(relativePath), `${base}.fixture${path.extname(filename)}`));
+            return true;
+        }
+        // Enforce test placement before rule matching
+        if (this.isStrayTestFile(relativePath, filename)) {
+            const suggested = this.suggestTestLocation(relativePath, filename);
+            this.violations.push({
+                file: relativePath,
+                rule: {
+                    pattern: /.*/,
+                    convention: "kebab-case",
+                    description: "Test files must live in tests/ or __tests__/ (e2e in tests/e2e)",
+                    examples: ["tests/user-service.test.ts", "tests/e2e/login.e2e.ts"],
+                    validator: () => false,
+                },
+                filename,
+                suggestedFix: suggested,
+            });
+            return true;
+        }
+        // Find applicable rule
+        const rule = NAMING_RULES.find((r) => r.pattern.test(relativePath));
+        if (!rule) {
+            // No specific rule - allow any reasonable name
+            if (this.verbose) {
+                this.info.push(`○ ${relativePath} (no specific rule)`);
+            }
+            return false;
+        }
+        // Validate against rule
+        if (rule.validator(filename)) {
+            if (this.verbose) {
+                this.info.push(`${console_chars_1.chars.check} ${relativePath}`);
+            }
+            return false;
+        }
+        else {
+            const cacheKey = `${relativePath}:${filename}`;
+            const cached = this.suggestionCache.get(cacheKey);
+            const suggestedFix = cached !== undefined ? cached : rule.suggestFix ? rule.suggestFix(filename) : undefined;
+            this.suggestionCache.set(cacheKey, suggestedFix);
+            this.violations.push({
+                file: relativePath,
+                rule,
+                filename,
+                suggestedFix,
+            });
+            return true;
+        }
+    }
+    isStrayTestFile(relativePath, filename) {
+        const testPattern = /\.(test|spec|e2e)\.(ts|tsx|js|jsx)$/;
+        if (!testPattern.test(filename))
+            return false;
+        const topLevel = relativePath.split("/")[0];
+        const inTestsFolder = relativePath.startsWith("tests/");
+        const inUnderTests = relativePath.includes("/__tests__/");
+        // E2E tests must live under tests/e2e
+        if (filename.includes(".e2e.")) {
+            return !relativePath.startsWith("tests/e2e/");
+        }
+        // Allow colocated tests in primary source dirs
+        const allowedRoots = new Set([
+            "app",
+            "components",
+            "lib",
+            "hooks",
+            "contexts",
+            "types",
+            "packages",
+            "scripts",
+        ]);
+        if (inTestsFolder || inUnderTests)
+            return false;
+        if (allowedRoots.has(topLevel))
+            return false;
+        return true;
+    }
+    suggestTestLocation(relativePath, filename) {
+        if (filename.includes(".e2e.")) {
+            return `tests/e2e/${filename}`;
+        }
+        return `tests/${filename}`;
+    }
+    runPostValidations() {
+        if (this.checkDuplicates) {
+            this.checkDuplicateBasenames();
+        }
+        if (this.checkDuplicates) {
+            this.checkShadowedPaths();
+        }
+        this.checkCasingDrift();
+        this.checkStoryParity();
+        if (this.requireStories) {
+            this.checkMissingStories();
+        }
+        this.checkPackageEntrypoints();
+        this.checkDynamicRoutes();
+        this.checkIndexRoutes();
+        this.checkDefaultExports();
+        if (this.barrelWarn) {
+            this.checkBarrelHygiene();
+        }
+        if (this.configGuard) {
+            this.checkConfigSurface();
+        }
+        if (this.reservedGuard) {
+            this.checkReservedPathDrift();
+        }
+        if (this.snapshotGuard) {
+            this.checkSnapshotMockNames();
+        }
+        if (this.clientServerGuard) {
+            this.checkClientServerImports();
+        }
+        if (this.dirNameGuard) {
+            this.checkDirectoryNames();
+        }
+        if (this.uiExportGuard) {
+            this.checkUiExportSurface();
+        }
+        if (this.mdxGuard) {
+            this.checkMdxPlacement();
+        }
+        if (this.e2eGroupingGuard) {
+            this.checkE2EGrouping();
+        }
+    }
+    addViolation(description, convention, examples, file, suggestedFix) {
+        this.violations.push({
+            file,
+            rule: {
+                pattern: /.*/,
+                convention,
+                description,
+                examples,
+                validator: () => false,
+            },
+            filename: path.basename(file),
+            suggestedFix,
+        });
+    }
+    addWarning(message, file) {
+        this.warnings.push(file ? `${message} [${file}]` : message);
+    }
+    checkDuplicateBasenames() {
+        for (const [base, paths] of this.basenameMap.entries()) {
+            if (paths.length <= 1)
+                continue;
+            const withoutStories = paths.filter((p) => !/\.stories\.(tsx|mdx)$/.test(p));
+            if (withoutStories.length <= 1)
+                continue;
+            const hasPackages = withoutStories.some((p) => p.startsWith("packages/"));
+            const hasComponents = withoutStories.some((p) => p.startsWith("components/"));
+            if (!(hasPackages && hasComponents))
+                continue; // Only enforce collisions between components/ and packages/
+            this.addViolation(`Duplicate basename collision detected across roots (${base})`, "PascalCase", ["components/Button.tsx vs packages/ui/Button.tsx"], withoutStories[0]);
+        }
+    }
+    checkShadowedPaths() {
+        for (const [shadow, paths] of this.relativePathMap.entries()) {
+            if (paths.length <= 1)
+                continue;
+            const roots = new Set(paths.map((p) => p.split("/")[0]));
+            if (roots.size <= 1)
+                continue;
+            // Only flag if components/ participates (shared UI drift)
+            const involvesComponents = paths.some((p) => p.startsWith("components/"));
+            if (!involvesComponents)
+                continue;
+            this.addViolation(`Shadowed relative path across roots: ${shadow}`, "PascalCase", ["components/foo/Bar.tsx vs packages/ui/src/foo/Bar.tsx"], paths[0]);
+        }
+    }
+    checkCasingDrift() {
+        for (const [lower, cases] of this.lowerCaseMap.entries()) {
+            if (cases.size <= 1)
+                continue;
+            const paths = [];
+            for (const variant of cases) {
+                const p = this.basenameMap.get(variant);
+                if (p)
+                    paths.push(...p);
+            }
+            const topLevels = new Set(paths.map((p) => p.split("/")[0]));
+            if (topLevels.size > 1)
+                continue; // Ignore cross-root casing differences
+            const sample = paths[0] ?? "";
+            this.addViolation("Case drift detected: files differ only by letter casing (breaks on Linux)", "kebab-case", ["Card.tsx vs card.tsx"], sample);
+        }
+    }
+    checkStoryParity() {
+        for (const [dir, stories] of this.storyIndex.entries()) {
+            const components = this.componentIndex.get(dir) || new Set();
+            for (const storyBase of stories) {
+                if (!components.has(storyBase)) {
+                    const storyPath = this.storyPathIndex.get(dir)?.get(storyBase) || `${dir}/${storyBase}.stories.tsx`;
+                    this.addViolation("Storybook story missing matching component in same folder", "PascalCase", ["Button.stories.tsx alongside Button.tsx"], storyPath);
+                }
+            }
+        }
+    }
+    checkMissingStories() {
+        for (const [dir, components] of this.componentIndex.entries()) {
+            if (!dir.startsWith("components/"))
+                continue;
+            const stories = this.storyIndex.get(dir) || new Set();
+            for (const component of components) {
+                if (stories.has(component))
+                    continue;
+                this.addViolation("Component missing colocated Storybook story", "PascalCase", ["Button.tsx => Button.stories.tsx"], `${dir}/${component}.tsx`, `${dir}/${component}.stories.tsx`);
+            }
+        }
+    }
+    checkPackageEntrypoints() {
+        for (const entry of this.packageEntrypoints) {
+            const file = path.basename(entry);
+            const allowed = new Set(["index.ts", "index.tsx", "main.ts", "main.tsx"]);
+            if (hasValidSuffix(file))
+                continue;
+            if (!allowed.has(file)) {
+                this.addViolation("Package entrypoints must be index.ts(x) or main.ts(x)", "kebab-case", ["packages/foo/src/index.ts"], entry, entry.replace(file, "index.ts"));
+            }
+        }
+    }
+    checkDynamicRoutes() {
+        for (const file of this.allFiles) {
+            if (!file.startsWith("app/"))
+                continue;
+            const segments = file.split("/");
+            for (const seg of segments) {
+                if (/^\[\.\.\.?.+\]$/.test(seg)) {
+                    const inner = seg.replace(/^\[\.\.\.?/, "").replace(/\]$/, "");
+                    if (!/^[a-z0-9-]+$/.test(inner)) {
+                        this.addViolation("Dynamic route segments must be kebab-case (lowercase, digits, hyphen)", "kebab-case", ["[player-id]", "[...slug]"], file);
+                        break;
+                    }
+                }
+            }
+        }
+    }
+    checkIndexRoutes() {
+        for (const file of this.allFiles) {
+            if (/^app\/.*\/index\.(ts|tsx|js|jsx)$/.test(file) &&
+                !file.includes("/_components/") &&
+                !file.includes("/components/")) {
+                this.addViolation("App Router should use page.tsx instead of index.tsx", "PascalCase", ["app/dashboard/page.tsx"], file, file.replace(/index\.(ts|tsx|js|jsx)$/, "page.tsx"));
+            }
+        }
+    }
+    checkDefaultExports() {
+        for (const file of this.defaultExportCandidates) {
+            const baseName = path.basename(file);
+            if (isAppRouterReservedFile(baseName) || baseName.includes("[")) {
+                continue;
+            }
+            if (/^index\.(ts|tsx|js|jsx)$/i.test(baseName)) {
+                continue; // index files can export any default name
+            }
+            try {
+                const absolute = path.resolve(file);
+                const content = fs.readFileSync(absolute, "utf8");
+                const base = path.parse(stripSuffixes(path.basename(file))).name;
+                const match = content.match(/export default function\s+([A-Za-z0-9_]+)/) ||
+                    content.match(/export default class\s+([A-Za-z0-9_]+)/) ||
+                    content.match(/export default\s+([A-Za-z0-9_]+)/);
+                if (match && match[1] !== base) {
+                    this.addViolation("Default export name must match filename", "PascalCase", ["Button.tsx => export default function Button()"], file);
+                }
+            }
+            catch (error) {
+                // Ignore read errors silently
+            }
+        }
+    }
+    checkBarrelHygiene() {
+        const barrelFiles = this.allFiles.filter((f) => /\/index\.(ts|tsx)$/.test(f));
+        for (const file of barrelFiles) {
+            try {
+                const content = fs.readFileSync(path.resolve(file), "utf8");
+                const lines = content.split(/\r?\n/);
+                const hasNonExport = lines.some((line) => {
+                    const trimmed = line.trim();
+                    if (!trimmed || trimmed.startsWith("//") || trimmed.startsWith("/*"))
+                        return false;
+                    if (trimmed.startsWith("export ") || trimmed.startsWith("import "))
+                        return false;
+                    return true;
+                });
+                if (hasNonExport) {
+                    this.addWarning("Barrel file should only contain exports/imports", file);
+                }
+            }
+            catch (error) {
+                // ignore
+            }
+        }
+    }
+    checkConfigSurface() {
+        const configFiles = this.allFiles.filter((f) => /config\.(ts|js|mjs|tsx|jsx)$/i.test(f));
+        for (const file of configFiles) {
+            try {
+                const content = fs.readFileSync(path.resolve(file), "utf8");
+                if (/from\s+["']@\/app/.test(content) || /from\s+["']\.\.\/app/.test(content)) {
+                    this.addWarning("Config file imports from app/ (avoid runtime deps)", file);
+                }
+                const defaultExport = content.match(/export default\s+([A-Za-z0-9_]+)/);
+                if (defaultExport && !/(config|defineConfig|nextConfig)/.test(defaultExport[1])) {
+                    this.addWarning("Config default export should be named config/defineConfig", file);
+                }
+            }
+            catch (error) {
+                // ignore
+            }
+        }
+    }
+    checkReservedPathDrift() {
+        const candidates = new Set([
+            "metadata",
+            "route-segment-config",
+            "sitemap-index",
+            "generateViewport",
+        ]);
+        const reservedBasenames = new Set(Array.from(APP_ROUTER_RESERVED).map((n) => n.replace(/\.(tsx?|jsx?)$/, "")));
+        for (const file of this.allFiles) {
+            if (!file.startsWith("app/"))
+                continue;
+            const base = path.basename(file).replace(/\.(tsx?|jsx?|js|ts)$/, "");
+            if (reservedBasenames.has(base))
+                continue;
+            if (candidates.has(base)) {
+                this.addViolation("Potential Next.js reserved filename not in APP_ROUTER_RESERVED (add to allowlist)", "PascalCase", ["app/route-segment-config.ts"], file);
+            }
+        }
+    }
+    checkSnapshotMockNames() {
+        for (const file of this.allFiles) {
+            const base = path.basename(file);
+            const ext = path.extname(base);
+            const name = base.replace(ext, "");
+            if (/snapshot/i.test(name) && !/\.snap$/i.test(base) && !/\.snapshot\./i.test(base)) {
+                this.addWarning("Snapshot files should use .snap", file);
+            }
+            if (/mock/i.test(name) && !/\.mock\./i.test(base) && !/mockServiceWorker\.js$/i.test(base)) {
+                this.addWarning("Mocks should use .mock.<ext> for clarity", file);
+            }
+        }
+    }
+    checkClientServerImports() {
+        const serverOnlyImports = [
+            /\bfrom\s+["']fs["']/,
+            /\bfrom\s+["']path["']/,
+            /from\s+["']node:/,
+            /from\s+["']next\/server["']/,
+        ];
+        const clientOnlyImports = [
+            /from\s+["']react-dom\/client["']/,
+            /from\s+["']next\/navigation["']/,
+        ];
+        for (const file of this.allFiles) {
+            if (!file.startsWith("app/"))
+                continue;
+            const base = path.basename(file);
+            const abs = path.resolve(file);
+            if (base.endsWith(".client.tsx") || base.endsWith(".client.ts")) {
+                const content = safeRead(abs);
+                if (!content)
+                    continue;
+                if (serverOnlyImports.some((re) => re.test(content))) {
+                    this.addWarning("Client component imports server-only module", file);
+                }
+            }
+            if (base.endsWith(".server.tsx") || base.endsWith(".server.ts")) {
+                const content = safeRead(abs);
+                if (!content)
+                    continue;
+                if (clientOnlyImports.some((re) => re.test(content))) {
+                    this.addWarning("Server module imports client-only module", file);
+                }
+            }
+        }
+    }
+    checkDirectoryNames() {
+        for (const dir of this.dirSegments) {
+            if (!(dir.startsWith("components/") || dir.startsWith("lib/")))
+                continue;
+            const last = dir.split("/").pop() || "";
+            if (!last || last.startsWith("_"))
+                continue; // allow private dirs
+            if (/^[a-z0-9]+(-[a-z0-9]+)*$/.test(last))
+                continue;
+            this.addWarning("Directory should be kebab-case", dir);
+        }
+    }
+    checkUiExportSurface() {
+        const indexPath = path.resolve("packages/ui/src/index.ts");
+        if (!fs.existsSync(indexPath))
+            return;
+        const content = safeRead(indexPath);
+        if (!content)
+            return;
+        const exportRe = /export\s+\{[^}]*\}\s+from\s+["'](.+)["']/g;
+        let match;
+        while ((match = exportRe.exec(content))) {
+            const target = match[1];
+            const resolved = path.resolve(path.dirname(indexPath), `${target}.ts`);
+            const resolvedTsx = path.resolve(path.dirname(indexPath), `${target}.tsx`);
+            if (!fs.existsSync(resolved) && !fs.existsSync(resolvedTsx)) {
+                this.addWarning("packages/ui export points to missing file", `packages/ui/src/${target}`);
+            }
+        }
+    }
+    checkMdxPlacement() {
+        for (const file of this.allFiles) {
+            if (!file.endsWith(".mdx"))
+                continue;
+            const isStory = file.endsWith(".stories.mdx");
+            const inComponents = file.startsWith("components/");
+            if (isStory && !inComponents) {
+                this.addWarning("Story MDX should live under components/", file);
+            }
+            if (!isStory && inComponents) {
+                this.addWarning("Non-story MDX found in components/", file);
+            }
+        }
+    }
+    checkE2EGrouping() {
+        for (const file of this.allFiles) {
+            if (!/\.e2e\.(ts|tsx|js|jsx)$/.test(file))
+                continue;
+            if (!file.startsWith("tests/e2e/"))
+                continue;
+            const parts = file.split("/");
+            if (parts.length <= 3) {
+                this.addWarning("E2E tests should be grouped under tests/e2e/<area>/", file);
+            }
+        }
+    }
+    printReport() {
+        // Stats
+        console.log(`${console_chars_1.emoji.chart} VALIDATION STATS:`);
+        console.log(`   Files checked:  ${this.filesChecked}`);
+        console.log(`   Violations:     ${this.violations.length}`);
+        if (this.dirSummaries.length) {
+            console.log("   Per directory:");
+            for (const summary of this.dirSummaries) {
+                console.log(`     - ${summary.dir}/ scanned=${summary.scanned} violations=${summary.violations}`);
+            }
+        }
+        if (this.violations.length === 0) {
+            console.log("\n" + (0, console_chars_1.createDivider)(80, "light"));
+            console.log(`${console_chars_1.emoji.success} ALL FILES FOLLOW NAMING CONVENTIONS`);
+            console.log((0, console_chars_1.createDivider)(80, "light"));
+            if (this.statsOnly) {
+                console.log("(--stats) Skipped detailed report; no violations detected.");
+            }
+            if (this.warnings.length) {
+                console.log(`Warnings: ${this.warnings.length}`);
+                for (const w of this.warnings.slice(0, 10)) {
+                    console.log(` - ${w}`);
+                }
+                if (this.warnings.length > 10) {
+                    console.log(` ... and ${this.warnings.length - 10} more warnings`);
+                }
+            }
+            return;
+        }
+        // Group violations by rule
+        const byRule = new Map();
+        for (const v of this.violations) {
+            const key = v.rule.description;
+            if (!byRule.has(key)) {
+                byRule.set(key, []);
+            }
+            byRule.get(key).push(v);
+        }
+        console.log("\n" + (0, console_chars_1.createDivider)(80, "light"));
+        console.log(`${console_chars_1.emoji.error} VIOLATIONS: ${this.violations.length}`);
+        console.log((0, console_chars_1.createDivider)(80, "light"));
+        for (const [description, violations] of byRule) {
+            const rule = violations[0].rule;
+            console.log(`\n${console_chars_1.emoji.bell} ${description} (${violations.length})`);
+            console.log(`   Convention: ${rule.convention}`);
+            console.log(`   Examples: ${rule.examples.join(", ")}`);
+            console.log("");
+            const toShow = this.verbose ? violations : violations.slice(0, 5);
+            for (const v of toShow) {
+                console.log(`   ${console_chars_1.emoji.error} ${v.file}`);
+                if (this.fixPreview && v.suggestedFix) {
+                    console.log(`      ${console_chars_1.chars.arrow} Rename to: ${v.suggestedFix}`);
+                }
+            }
+            if (!this.verbose && violations.length > 5) {
+                console.log(`   ... and ${violations.length - 5} more`);
+            }
+        }
+        // Summary
+        console.log("\n" + (0, console_chars_1.createDivider)(80, "double"));
+        if (this.warningOnly) {
+            console.log(`${console_chars_1.emoji.warning}  VALIDATION COMPLETED (warning mode - not blocking)`);
+        }
+        else {
+            console.log(`${console_chars_1.emoji.error} VALIDATION FAILED`);
+            console.log(`   ${this.violations.length} file(s) must be renamed before commit.`);
+        }
+        console.log((0, console_chars_1.createDivider)(80, "double"));
+        if (this.warnings.length) {
+            console.log(`\n${console_chars_1.emoji.info} WARNINGS (${this.warnings.length}):`);
+            for (const w of this.warnings.slice(0, 10)) {
+                console.log(` - ${w}`);
+            }
+            if (this.warnings.length > 10) {
+                console.log(`   ... and ${this.warnings.length - 10} more`);
+            }
+        }
+        // Help
+        console.log("\n📖 NAMING CONVENTIONS:");
+        console.log(`   ${console_chars_1.chars.bullet} components/     ${console_chars_1.chars.arrow} PascalCase (UserCard.tsx)`);
+        console.log(`   ${console_chars_1.chars.bullet} lib/            ${console_chars_1.chars.arrow} kebab-case (user-service.ts)`);
+        console.log(`   ${console_chars_1.chars.bullet} hooks/          ${console_chars_1.chars.arrow} camelCase with 'use' prefix (useAuth.ts)`);
+        console.log(`   ${console_chars_1.chars.bullet} contexts/       ${console_chars_1.chars.arrow} PascalCase (AuthContext.tsx)`);
+        console.log(`   ${console_chars_1.chars.bullet} types/          ${console_chars_1.chars.arrow} kebab-case (api-types.ts)`);
+        console.log(`   ${console_chars_1.chars.bullet} scripts/        ${console_chars_1.chars.arrow} kebab-case (run-migrations.ts)`);
+        console.log(`   ${console_chars_1.chars.bullet} tests/          ${console_chars_1.chars.arrow} kebab-case.test.ts (user-service.test.ts)`);
+        console.log(`   ${console_chars_1.chars.bullet} app/*Client.tsx ${console_chars_1.chars.arrow} PascalCase+Client (ProductsClient.tsx)`);
+        console.log(`\n${console_chars_1.emoji.docs} DOCS: .kiro/steering/development-guide.md\n`);
+    }
+}
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+// CLI
+// ${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}${box.doubleHorizontal}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    const args = process.argv.slice(2);
+    const warningOnly = args.includes("--warning") || args.includes("--warning-only");
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const fixPreview = args.includes("--fix-preview") || args.includes("--fix");
+    const statsOnly = args.includes("--stats");
+    const noFailFast = args.includes("--no-fail-fast") || args.includes("--scan-all");
+    const checkDuplicates = args.includes("--check-duplicates");
+    const requireStories = args.includes("--require-stories");
+    const barrelWarn = args.includes("--barrel-warn");
+    const configGuard = args.includes("--config-guard");
+    const reservedGuard = args.includes("--reserved-guard");
+    const snapshotGuard = args.includes("--snapshot-guard");
+    const clientServerGuard = args.includes("--client-server-guard");
+    const dirNameGuard = args.includes("--dir-name-guard");
+    const uiExportGuard = args.includes("--ui-export-guard");
+    const mdxGuard = args.includes("--mdx-guard");
+    const e2eGroupingGuard = args.includes("--e2e-grouping-guard");
+    const validator = new FileNamingValidator({
+        verbose,
+        warningOnly,
+        fixPreview,
+        statsOnly,
+        noFailFast,
+        checkDuplicates,
+        requireStories,
+        barrelWarn,
+        configGuard,
+        reservedGuard,
+        snapshotGuard,
+        clientServerGuard,
+        dirNameGuard,
+        uiExportGuard,
+        mdxGuard,
+        e2eGroupingGuard,
+    });
+    const passed = await validator.validate();
+    if (warningOnly) {
+        console.log(`${console_chars_1.emoji.warning}  Running in WARNING mode (not blocking)\n`);
+        process.exit(0);
+    }
+    process.exit(passed ? 0 : 1);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=file-naming-conventions.js.map