guardrail-cli 2.4.13 → 2.5.1

package/dist/scanner/route-detector.js

@@ -0,0 +1,455 @@
+"use strict";
+/**
+ * Route Detector for Client-Side Routers
+ *
+ * Detects routes in various routing frameworks:
+ * - Next.js/Remix (file-based routing)
+ * - React Router (component-based)
+ * - Wouter (lightweight router)
+ * - Generic route inference mode
+ */
+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.RouteDetector = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class RouteDetector {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Detect routes in the project
+     */
+    async detectRoutes() {
+        // Try framework-specific detection first
+        const frameworkResult = await this.detectFrameworkRoutes();
+        if (frameworkResult.routes.length > 0) {
+            return frameworkResult;
+        }
+        // Fall back to generic route inference
+        const genericResult = await this.detectGenericRoutes();
+        if (genericResult.routes.length > 0) {
+            return genericResult;
+        }
+        // If we still have no routes, check for route hints
+        if (this.config.routeHints && this.config.routeHints.length > 0) {
+            return {
+                routes: this.config.routeHints.map((hint) => ({
+                    path: hint.path,
+                    file: hint.file,
+                    source: 'config',
+                })),
+                framework: this.config.framework || 'unknown',
+                confidence: 'medium',
+                message: 'Routes detected from configuration hints',
+            };
+        }
+        // No routes found - provide helpful message
+        return {
+            routes: [],
+            framework: this.config.framework || 'unknown',
+            confidence: 'low',
+            message: 'Route system not recognized. Enable route hints in .guardrailrc',
+            hints: [
+                'Add route hints to .guardrailrc configuration file',
+                'Example config: { "routes": [{ "path": "/home", "file": "src/pages/home.tsx" }] }',
+                'Or use framework-specific route detection for Next.js, Remix, React Router, or Wouter',
+            ],
+        };
+    }
+    /**
+     * Detect routes based on detected framework
+     */
+    async detectFrameworkRoutes() {
+        const framework = this.config.framework?.toLowerCase() || '';
+        if (framework.includes('next')) {
+            return this.detectNextJSRoutes();
+        }
+        if (framework.includes('remix')) {
+            return this.detectRemixRoutes();
+        }
+        // React Router or Wouter - detect component-based routes
+        const componentResult = await this.detectComponentRoutes();
+        if (componentResult.routes.length > 0) {
+            return componentResult;
+        }
+        return {
+            routes: [],
+            framework: framework || 'unknown',
+            confidence: 'low',
+        };
+    }
+    /**
+     * Detect Next.js file-based routes
+     */
+    async detectNextJSRoutes() {
+        const routes = [];
+        const pagesDir = path.join(this.config.projectPath, 'pages');
+        const appDir = path.join(this.config.projectPath, 'app');
+        if (fs.existsSync(pagesDir)) {
+            // Next.js pages router
+            const pages = await this.findRouteFiles(pagesDir);
+            routes.push(...pages);
+        }
+        else if (fs.existsSync(appDir)) {
+            // Next.js app router
+            const pages = await this.findRouteFiles(appDir);
+            routes.push(...pages);
+        }
+        return {
+            routes,
+            framework: 'nextjs',
+            confidence: routes.length > 0 ? 'high' : 'low',
+        };
+    }
+    /**
+     * Detect Remix routes
+     */
+    async detectRemixRoutes() {
+        const routes = [];
+        const routesDir = path.join(this.config.projectPath, 'app', 'routes');
+        if (fs.existsSync(routesDir)) {
+            const files = await this.findRouteFiles(routesDir);
+            routes.push(...files);
+        }
+        return {
+            routes,
+            framework: 'remix',
+            confidence: routes.length > 0 ? 'high' : 'low',
+        };
+    }
+    /**
+     * Detect component-based routes (React Router, Wouter)
+     */
+    async detectComponentRoutes() {
+        const routes = [];
+        const srcFiles = await this.findSourceFiles(this.config.projectPath);
+        // Patterns for React Router
+        const reactRouterPatterns = [
+            /<Route\s+path=["']([^"']+)["']/gi,
+            /path:\s*["']([^"']+)["']/gi,
+            /route\(["']([^"']+)["']/gi,
+        ];
+        // Patterns for Wouter
+        const wouterPatterns = [
+            /<Route\s+path=["']([^"']+)["']/gi,
+            /route\(["']([^"']+)["']/gi,
+            /useRoute\(["']([^"']+)["']/gi,
+        ];
+        for (const file of srcFiles.slice(0, 100)) {
+            // Limit for performance
+            try {
+                const content = await fs.promises.readFile(file, 'utf-8');
+                const lines = content.split('\n');
+                // Check for React Router patterns
+                for (let i = 0; i < lines.length; i++) {
+                    const line = lines[i];
+                    for (const pattern of [...reactRouterPatterns, ...wouterPatterns]) {
+                        let match;
+                        pattern.lastIndex = 0;
+                        while ((match = pattern.exec(line)) !== null) {
+                            const routePath = match[1];
+                            if (routePath) {
+                                routes.push({
+                                    path: routePath,
+                                    file: path.relative(this.config.projectPath, file),
+                                    line: i + 1,
+                                    source: 'component',
+                                    dynamic: routePath.includes(':') || routePath.includes('*'),
+                                    params: this.extractRouteParams(routePath),
+                                });
+                            }
+                        }
+                    }
+                }
+                // Check for route arrays/configs
+                const routeArrayMatch = content.match(/routes\s*[:=]\s*\[([\s\S]*?)\]/);
+                if (routeArrayMatch) {
+                    const routeConfigs = this.parseRouteArray(routeArrayMatch[1]);
+                    for (const routeConfig of routeConfigs) {
+                        routes.push({
+                            ...routeConfig,
+                            file: path.relative(this.config.projectPath, file),
+                            source: 'config',
+                        });
+                    }
+                }
+            }
+            catch (e) {
+                // Skip unreadable files
+            }
+        }
+        // Determine framework based on imports
+        const framework = await this.detectRouterFramework();
+        return {
+            routes: this.deduplicateRoutes(routes),
+            framework: framework || 'react-router',
+            confidence: routes.length > 0 ? 'medium' : 'low',
+        };
+    }
+    /**
+     * Generic route inference mode
+     */
+    async detectGenericRoutes() {
+        const routes = [];
+        const srcFiles = await this.findSourceFiles(this.config.projectPath);
+        // Look for common route patterns
+        const routePatterns = [
+            /path\s*[:=]\s*["']([^"']+)["']/gi,
+            /route\s*[:=]\s*["']([^"']+)["']/gi,
+            /["']([\/][^"']+)["']/g, // Path-like strings starting with /
+        ];
+        for (const file of srcFiles.slice(0, 50)) {
+            // Limit for performance
+            try {
+                const content = await fs.promises.readFile(file, 'utf-8');
+                const lines = content.split('\n');
+                for (let i = 0; i < lines.length; i++) {
+                    const line = lines[i];
+                    for (const pattern of routePatterns) {
+                        let match;
+                        pattern.lastIndex = 0;
+                        while ((match = pattern.exec(line)) !== null) {
+                            const candidate = match[1];
+                            if (this.looksLikeRoute(candidate)) {
+                                routes.push({
+                                    path: candidate,
+                                    file: path.relative(this.config.projectPath, file),
+                                    line: i + 1,
+                                    source: 'inferred',
+                                    dynamic: candidate.includes(':'),
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+            catch (e) {
+                // Skip unreadable files
+            }
+        }
+        return {
+            routes: this.deduplicateRoutes(routes),
+            framework: 'generic',
+            confidence: 'low',
+        };
+    }
+    /**
+     * Detect router framework from dependencies
+     */
+    async detectRouterFramework() {
+        const packageJsonPath = path.join(this.config.projectPath, 'package.json');
+        if (!fs.existsSync(packageJsonPath))
+            return null;
+        try {
+            const packageJson = JSON.parse(await fs.promises.readFile(packageJsonPath, 'utf-8'));
+            const deps = {
+                ...packageJson.dependencies,
+                ...packageJson.devDependencies,
+            };
+            if (deps.wouter)
+                return 'wouter';
+            if (deps['react-router'] || deps['react-router-dom']) {
+                return 'react-router';
+            }
+            if (deps.next)
+                return 'nextjs';
+            if (deps.remix)
+                return 'remix';
+        }
+        catch (e) {
+            // Ignore
+        }
+        return null;
+    }
+    /**
+     * Check if a string looks like a route path
+     */
+    looksLikeRoute(candidate) {
+        // Must start with / and be reasonable length
+        if (!candidate.startsWith('/') || candidate.length < 2)
+            return false;
+        // Common non-route patterns to exclude
+        const excludePatterns = [
+            /^\/node_modules\//,
+            /^\/\./,
+            /\.(js|ts|tsx|jsx|json|md|css)$/,
+            /^\/src\//,
+            /^\/public\//,
+        ];
+        return !excludePatterns.some((pattern) => pattern.test(candidate));
+    }
+    /**
+     * Extract route parameters from path
+     */
+    extractRouteParams(routePath) {
+        const params = [];
+        const paramPattern = /:(\w+)/g;
+        let match;
+        while ((match = paramPattern.exec(routePath)) !== null) {
+            params.push(match[1]);
+        }
+        return params;
+    }
+    /**
+     * Parse route array from config
+     */
+    parseRouteArray(content) {
+        const routes = [];
+        // Simple parsing - look for path: "..." patterns
+        const pathPattern = /path\s*:\s*["']([^"']+)["']/gi;
+        let match;
+        while ((match = pathPattern.exec(content)) !== null) {
+            routes.push({
+                path: match[1],
+                source: 'config',
+                dynamic: match[1].includes(':'),
+            });
+        }
+        return routes;
+    }
+    /**
+     * Find route files in directory (for file-based routing)
+     */
+    async findRouteFiles(dir) {
+        const routes = [];
+        const files = await this.getAllFiles(dir);
+        for (const file of files) {
+            const relativePath = path.relative(dir, file);
+            const routePath = this.filePathToRoute(relativePath);
+            if (routePath) {
+                routes.push({
+                    path: routePath,
+                    file: path.relative(this.config.projectPath, file),
+                    source: 'file_based',
+                    dynamic: routePath.includes('[') || routePath.includes(':'),
+                });
+            }
+        }
+        return routes;
+    }
+    /**
+     * Convert file path to route path
+     */
+    filePathToRoute(filePath) {
+        // Remove extension
+        let route = filePath.replace(/\.[^/.]+$/, '');
+        // Handle index files
+        if (route.endsWith('/index')) {
+            route = route.slice(0, -6);
+        }
+        // Handle Next.js dynamic routes [id].tsx -> /:id
+        route = route.replace(/\[([^\]]+)\]/g, ':$1');
+        // Must start with /
+        if (!route.startsWith('/')) {
+            route = '/' + route;
+        }
+        return route || '/';
+    }
+    /**
+     * Find all source files in project
+     */
+    async findSourceFiles(dir) {
+        const files = [];
+        const extensions = ['.ts', '.tsx', '.js', '.jsx'];
+        try {
+            const entries = await fs.promises.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                // Skip node_modules, .git, etc.
+                if (entry.name.startsWith('.') ||
+                    entry.name === 'node_modules' ||
+                    entry.name === 'dist' ||
+                    entry.name === 'build') {
+                    continue;
+                }
+                if (entry.isDirectory()) {
+                    const subFiles = await this.findSourceFiles(fullPath);
+                    files.push(...subFiles);
+                }
+                else if (entry.isFile()) {
+                    const ext = path.extname(entry.name);
+                    if (extensions.includes(ext)) {
+                        files.push(fullPath);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            // Skip unreadable directories
+        }
+        return files;
+    }
+    /**
+     * Get all files recursively
+     */
+    async getAllFiles(dir) {
+        const files = [];
+        try {
+            const entries = await fs.promises.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    const subFiles = await this.getAllFiles(fullPath);
+                    files.push(...subFiles);
+                }
+                else if (entry.isFile()) {
+                    files.push(fullPath);
+                }
+            }
+        }
+        catch (e) {
+            // Skip unreadable directories
+        }
+        return files;
+    }
+    /**
+     * Deduplicate routes
+     */
+    deduplicateRoutes(routes) {
+        const seen = new Set();
+        const unique = [];
+        for (const route of routes) {
+            const key = `${route.path}:${route.file || ''}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                unique.push(route);
+            }
+        }
+        return unique;
+    }
+}
+exports.RouteDetector = RouteDetector;
+//# sourceMappingURL=route-detector.js.map

package/dist/scanner/route-detector.js.map

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

package/dist/scanner/scoring.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Improved Scoring System
+ *
+ * Separates score components for better transparency:
+ * - Integrity score (routes, links, 404s)
+ * - Production readiness (placeholders, mocks, TODOs)
+ * - Security score (secrets, vulnerabilities)
+ *
+ * Provides weighted final score that's less punitive
+ */
+export interface ScoreComponent {
+    name: string;
+    score: number;
+    maxScore: number;
+    weight: number;
+    details: {
+        label: string;
+        value: number;
+        impact: number;
+    }[];
+}
+export interface ScoringResult {
+    integrity: ScoreComponent;
+    productionReadiness: ScoreComponent;
+    security: ScoreComponent;
+    overall: {
+        score: number;
+        maxScore: number;
+        percentage: number;
+        grade: string;
+    };
+    breakdown: {
+        category: string;
+        score: number;
+        weight: number;
+        weightedScore: number;
+    }[];
+}
+export interface ScoringInputs {
+    integrity?: {
+        routes?: number;
+        deadLinks?: number;
+        orphanRoutes?: number;
+        runtime404s?: number;
+        unresolvedDynamic?: number;
+    };
+    productionReadiness?: {
+        placeholders?: number;
+        mocks?: number;
+        todos?: number;
+        testData?: number;
+    };
+    security?: {
+        secrets?: number;
+        vulnerabilities?: number;
+        complianceIssues?: number;
+    };
+}
+/**
+ * Calculate comprehensive score
+ */
+export declare function calculateScore(inputs: ScoringInputs): ScoringResult;
+/**
+ * Format score as text
+ */
+export declare function formatScoreAsText(result: ScoringResult): string;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/scanner/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/scanner/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;CACL;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,cAAc,CAAC;IAC1B,mBAAmB,EAAE,cAAc,CAAC;IACpC,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;CACL;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,mBAAmB,CAAC,EAAE;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AA2ND;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CA+CnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA0D/D"}