@empline/preflight 1.0.20

package/dist/checks/organization/route-structure-validation.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * Route Structure Validation Preflight
+ *
+ * Validates Next.js App Router structure for:
+ * 1. Route aliases are proper re-exports (not duplicate implementations)
+ * 2. No duplicate route implementations
+ * 3. Component folders follow conventions (_components for private, components for local)
+ * 4. No orphaned route folders
+ *
+ * Run: pnpm preflight:route-structure
+ */
+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 = "organization/route-structure-validation";
+exports.name = "Route Structure Validation";
+exports.category = "organization";
+exports.blocking = false;
+exports.description = "Route Structure Validation Preflight";
+exports.tags = ["organization", "validation"];
+const APP_DIR = path.join(process.cwd(), "app");
+// Known intentional route aliases (re-exports)
+const KNOWN_ALIASES = {
+    "app/seller/dashboard": "app/store/dashboard",
+    "app/seller/listings": "app/store/listings",
+    "app/seller/listings/new": "app/store/listings/new",
+    "app/dashboard": "app/account/dashboard",
+    "app/privacy": "app/privacy-policy",
+    "app/terms": "app/terms-conditions",
+};
+// Routes that should have implementations (not be empty)
+const REQUIRED_ROUTES = [
+    "app/store/dashboard",
+    "app/store/listings",
+    "app/account/dashboard",
+    "app/admin/dashboard", // Admin root redirects to dashboard
+];
+function isReExportFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        // Check for re-export pattern: export { default } from "@/app/..." or export { default, metadata } from "@/app/..."
+        const reExportMatch = content.match(/export\s*{\s*default(?:\s*,\s*\w+)*\s*}\s*from\s*["']@\/app\/([^"']+)["']/);
+        if (reExportMatch) {
+            return { isReExport: true, target: `app/${reExportMatch[1]}` };
+        }
+        return { isReExport: false };
+    }
+    catch {
+        return { isReExport: false };
+    }
+}
+function getRouteFiles(dir) {
+    const files = [];
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory() && !entry.name.startsWith("_") && !entry.name.startsWith(".")) {
+                files.push(...getRouteFiles(fullPath));
+            }
+            else if (entry.isFile() && entry.name === "page.tsx") {
+                files.push(fullPath);
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist
+    }
+    return files;
+}
+function validateRouteAliases(result) {
+    for (const [aliasPath, targetPath] of Object.entries(KNOWN_ALIASES)) {
+        const aliasPagePath = path.join(process.cwd(), aliasPath, "page.tsx");
+        if (!fs.existsSync(aliasPagePath)) {
+            result.info.push(`Route alias ${aliasPath} doesn't exist (may have been removed)`);
+            continue;
+        }
+        const { isReExport, target } = isReExportFile(aliasPagePath);
+        if (!isReExport) {
+            result.errors.push(`${aliasPath}/page.tsx should be a re-export to ${targetPath}, but has its own implementation. ` +
+                `This creates duplicate code. Convert to: export { default } from "@/${targetPath}/page";`);
+        }
+        else if (target) {
+            // Normalize paths for comparison (remove /page suffix, handle both formats)
+            const normalizedTarget = target.replace(/\/page$/, "").replace(/^app\//, "");
+            const expectedTarget = targetPath.replace(/^app\//, "");
+            if (normalizedTarget !== expectedTarget) {
+                result.warnings.push(`${aliasPath}/page.tsx re-exports from app/${normalizedTarget}, expected ${targetPath}`);
+            }
+        }
+    }
+}
+function findDuplicateRoutes(result) {
+    const routePages = getRouteFiles(APP_DIR);
+    const routesByFullPath = {};
+    for (const pagePath of routePages) {
+        const relativePath = path.relative(process.cwd(), pagePath).replace(/\\/g, "/");
+        const routeDir = path.dirname(relativePath);
+        // Skip known aliases
+        if (Object.keys(KNOWN_ALIASES).some((alias) => routeDir === alias || routeDir.startsWith(alias + "/"))) {
+            continue;
+        }
+        // Skip route groups (parentheses) and dynamic routes (brackets)
+        if (routeDir.includes("(") || routeDir.includes("[")) {
+            continue;
+        }
+        // Get the full route path for comparison (e.g., "account/dashboard" vs "admin/dashboard")
+        // These are DIFFERENT routes, not duplicates
+        const fullRoutePath = routeDir.replace("app/", "");
+        if (!routesByFullPath[fullRoutePath]) {
+            routesByFullPath[fullRoutePath] = [];
+        }
+        routesByFullPath[fullRoutePath].push(relativePath);
+    }
+    // Check for actual duplicates (same full path, multiple implementations)
+    for (const [routePath, paths] of Object.entries(routesByFullPath)) {
+        if (paths.length > 1) {
+            // Filter out re-exports
+            const implementations = paths.filter((p) => {
+                const { isReExport } = isReExportFile(path.join(process.cwd(), p));
+                return !isReExport;
+            });
+            if (implementations.length > 1) {
+                result.errors.push(`Duplicate implementations of route "/${routePath}": ${implementations.join(", ")}. ` +
+                    `One should be a re-export or they should be consolidated.`);
+            }
+        }
+    }
+}
+function validateComponentFolders(result) {
+    const routeDirs = getRouteFiles(APP_DIR).map((f) => path.dirname(f));
+    for (const routeDir of routeDirs) {
+        const hasComponents = fs.existsSync(path.join(routeDir, "components"));
+        const hasPrivateComponents = fs.existsSync(path.join(routeDir, "_components"));
+        // Check for both components/ and _components/ in same directory
+        if (hasComponents && hasPrivateComponents) {
+            // This is actually fine - components/ for UI, _components/ for hooks/utilities
+            // Just log as info
+            result.info.push(`${path.relative(process.cwd(), routeDir)} has both components/ and _components/ folders (OK if intentional)`);
+        }
+    }
+}
+function validateRequiredRoutes(result) {
+    for (const route of REQUIRED_ROUTES) {
+        const pagePath = path.join(process.cwd(), route, "page.tsx");
+        if (!fs.existsSync(pagePath)) {
+            result.errors.push(`Required route ${route}/page.tsx is missing`);
+        }
+    }
+}
+function main() {
+    const result = {
+        errors: [],
+        warnings: [],
+        info: [],
+    };
+    console.log(`${console_chars_1.emoji.search} Validating route structure...\n`);
+    validateRouteAliases(result);
+    findDuplicateRoutes(result);
+    validateComponentFolders(result);
+    validateRequiredRoutes(result);
+    // Output results
+    if (result.errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} ERRORS:`);
+        result.errors.forEach((e) => console.log(`  - ${e}`));
+        console.log();
+    }
+    if (result.warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  WARNINGS:`);
+        result.warnings.forEach((w) => console.log(`  - ${w}`));
+        console.log();
+    }
+    const verbose = process.argv.includes("--verbose");
+    if (verbose && result.info.length > 0) {
+        console.log(`${console_chars_1.emoji.info}  INFO:`);
+        result.info.forEach((i) => console.log(`  - ${i}`));
+        console.log();
+    }
+    // Summary
+    console.log(`${console_chars_1.emoji.chart} Summary:`);
+    console.log(`  Errors: ${result.errors.length}`);
+    console.log(`  Warnings: ${result.warnings.length}`);
+    console.log(`  Info: ${result.info.length}`);
+    if (result.errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Route structure validation FAILED`);
+        process.exit(1);
+    }
+    else if (result.warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  Route structure validation passed with warnings`);
+        process.exit(0);
+    }
+    else {
+        console.log(`\n${console_chars_1.emoji.success} Route structure validation PASSED`);
+        process.exit(0);
+    }
+}
+main();
+//# sourceMappingURL=route-structure-validation.js.map

package/dist/checks/organization/route-structure-validation.js.map

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

package/dist/checks/organization/steering-bloat-prevention.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Steering Quality & Bloat Prevention Preflight
+ *
+ * Ensures optimal agent steering quality and prevents token bloat:
+ *
+ * QUALITY CHECKS:
+ * - Front matter validation (inclusion, loadWith, lastUpdated)
+ * - Cross-reference integrity (no broken #references)
+ * - README index completeness (all files listed)
+ * - Best practices compliance
+ * - Date validation (future dates, invalid formats)
+ *
+ * BLOAT PREVENTION:
+ * - ASCII art diagrams (decorative boxes)
+ * - Verbose code examples (>25 lines)
+ * - Duplicate information across files
+ * - Always-loaded files that should be manual
+ * - Content redundancy between files
+ * - Redundant preflight commands
+ *
+ * DRIFT PREVENTION:
+ * - Orphaned files (not in README index)
+ * - Stale lastUpdated dates (>90 days)
+ * - Missing cross-references
+ * - Token budget trend tracking
+ * - Cross-reference dependency graph
+ *
+ * COST OPTIMIZATION:
+ * - Token budget tracking with historical trends
+ * - Always-loaded content minimization
+ * - Redundancy elimination suggestions
+ * - Whitelisted large files (comprehensive references)
+ *
+ * Run: pnpm preflight:steering-quality
+ *      pnpm preflight:steering-quality --fix (auto-fix suggestions)
+ *      pnpm preflight:steering-quality --graph (show dependency graph)
+ * Created: 2025-12-26
+ * Enhanced: 2026-01-04
+ */
+export declare const id = "organization/steering-bloat-prevention";
+export declare const name = "Steering Bloat Prevention";
+export declare const category = "organization";
+export declare const blocking = false;
+export declare const description = "Steering Quality & Bloat Prevention Preflight";
+export declare const tags: string[];
+interface SteeringIssue {
+    file: string;
+    line: number;
+    type: IssueType;
+    message: string;
+    severity: "error" | "warning" | "info";
+    relatedFile?: string;
+    similarity?: number;
+    suggestion?: string;
+    autoFixable?: boolean;
+}
+type IssueType = "ascii-art" | "verbose-code" | "duplicate-info" | "wrong-inclusion" | "content-redundancy" | "preflight-redundancy" | "broken-reference" | "missing-frontmatter" | "invalid-date" | "stale-content" | "orphaned-file" | "missing-from-index" | "token-budget" | "token-trend" | "best-practice";
+interface CrossRefGraph {
+    nodes: string[];
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+    incomingCount: Map<string, number>;
+    outgoingCount: Map<string, number>;
+}
+interface ValidationResult {
+    errors: SteeringIssue[];
+    warnings: SteeringIssue[];
+    info: SteeringIssue[];
+    stats: {
+        totalFiles: number;
+        alwaysLoadedFiles: number;
+        totalTokens: number;
+        alwaysLoadedTokens: number;
+        tokenTrend?: {
+            change: number;
+            direction: "up" | "down" | "stable";
+        };
+    };
+    graph?: CrossRefGraph;
+}
+export declare function validateSteeringQuality(options?: {
+    showGraph?: boolean;
+    fix?: boolean;
+}): Promise<ValidationResult>;
+export { validateSteeringQuality as validateSteeringBloat };
+//# sourceMappingURL=steering-bloat-prevention.d.ts.map

package/dist/checks/organization/steering-bloat-prevention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering-bloat-prevention.d.ts","sourceRoot":"","sources":["../../../src/checks/organization/steering-bloat-prevention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AASH,eAAO,MAAM,EAAE,2CAA2C,CAAC;AAC3D,eAAO,MAAM,IAAI,8BAA8B,CAAC;AAChD,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,kDAAkD,CAAC;AAC3E,eAAO,MAAM,IAAI,UAAmB,CAAC;AAIrC,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,KAAK,SAAS,GACV,WAAW,GACX,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,GAClB,qBAAqB,GACrB,cAAc,GACd,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,cAAc,GACd,aAAa,GACb,eAAe,CAAC;AAyCpB,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAA;SAAE,CAAC;KACtE,CAAC;IACF,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAgED,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACV,GACL,OAAO,CAAC,gBAAgB,CAAC,CA8E3B;AAsqCD,OAAO,EAAE,uBAAuB,IAAI,qBAAqB,EAAE,CAAC"}