vaspera 2.9.2 → 2.10.1

package/dist/scanners/scale/bottleneck-detector.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Bottleneck Detector
+ *
+ * Analyzes load test results and code patterns to identify performance bottlenecks.
+ *
+ * @module scanners/scale/bottleneck-detector
+ */
+import type { Bottleneck, LoadTestResult } from "./types.js";
+/**
+ * Detect bottlenecks in a project
+ */
+export declare function detectBottlenecks(projectPath: string, loadTestResults?: LoadTestResult): Promise<Bottleneck[]>;
+/**
+ * Calculate bottleneck score (100 = no bottlenecks)
+ */
+export declare function calculateBottleneckScore(bottlenecks: Bottleneck[]): number;
+//# sourceMappingURL=bottleneck-detector.d.ts.map

package/dist/scanners/scale/bottleneck-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bottleneck-detector.d.ts","sourceRoot":"","sources":["../../../src/scanners/scale/bottleneck-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA+M7D;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,cAAc,GAC/B,OAAO,CAAC,UAAU,EAAE,CAAC,CA0BvB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAqB1E"}

package/dist/scanners/scale/bottleneck-detector.js

@@ -0,0 +1,250 @@
+/**
+ * Bottleneck Detector
+ *
+ * Analyzes load test results and code patterns to identify performance bottlenecks.
+ *
+ * @module scanners/scale/bottleneck-detector
+ */
+import { readFile, readdir } from "fs/promises";
+import { join } from "path";
+import { logger } from "../../logger.js";
+/**
+ * N+1 query pattern detection
+ */
+const N_PLUS_ONE_PATTERNS = [
+    // Prisma
+    /\.findMany\(\s*\{[^}]*include\s*:\s*\{/g,
+    // Sequelize
+    /\.findAll\(\s*\{[^}]*include\s*:\s*\[/g,
+    // TypeORM
+    /\.find\(\s*\{[^}]*relations\s*:\s*\[/g,
+    // Raw SQL in loop
+    /for\s*\([^)]*\)\s*\{[^}]*(?:SELECT|INSERT|UPDATE|DELETE)/gi,
+    // forEach with await
+    /\.forEach\(\s*async/g,
+];
+/**
+ * Memory leak patterns
+ */
+const MEMORY_LEAK_PATTERNS = [
+    // Growing arrays in closures
+    /const\s+\w+\s*=\s*\[\s*\][\s\S]*setInterval/g,
+    // Event listeners without cleanup
+    /addEventListener\([^)]+\)(?![\s\S]*removeEventListener)/g,
+    // Global state accumulation
+    /global\.\w+\s*=\s*\[[\s\S]*\.push\(/g,
+];
+/**
+ * Blocking operation patterns
+ */
+const BLOCKING_PATTERNS = [
+    // Sync file operations
+    /(?:readFileSync|writeFileSync|existsSync|statSync)/g,
+    // Blocking crypto
+    /crypto\.(?:pbkdf2Sync|scryptSync|randomBytes)\s*\(/g,
+    // Large JSON parsing
+    /JSON\.parse\([^)]*\.length\s*>\s*\d{6}/g,
+];
+/**
+ * Analyze source code for potential bottlenecks
+ */
+async function analyzeSourceCode(projectPath) {
+    const bottlenecks = [];
+    const srcDirs = ["src", "app", "pages", "api", "lib"];
+    for (const dir of srcDirs) {
+        try {
+            const dirPath = join(projectPath, dir);
+            const files = await readdir(dirPath, { recursive: true });
+            for (const file of files) {
+                if (typeof file !== "string")
+                    continue;
+                if (!file.match(/\.(ts|js|tsx|jsx)$/))
+                    continue;
+                try {
+                    const filePath = join(dirPath, file);
+                    const content = await readFile(filePath, "utf-8");
+                    // Check for N+1 patterns
+                    for (const pattern of N_PLUS_ONE_PATTERNS) {
+                        const matches = content.match(pattern);
+                        if (matches && matches.length > 0) {
+                            bottlenecks.push({
+                                type: "database",
+                                location: `${dir}/${file}`,
+                                severity: "high",
+                                description: `Potential N+1 query pattern detected (${matches.length} occurrences)`,
+                                metrics: {
+                                    current: matches.length,
+                                    threshold: 0,
+                                    unit: "patterns",
+                                },
+                                recommendation: "Consider using eager loading or batching queries",
+                            });
+                        }
+                    }
+                    // Check for memory leak patterns
+                    for (const pattern of MEMORY_LEAK_PATTERNS) {
+                        const matches = content.match(pattern);
+                        if (matches && matches.length > 0) {
+                            bottlenecks.push({
+                                type: "memory",
+                                location: `${dir}/${file}`,
+                                severity: "medium",
+                                description: `Potential memory leak pattern detected`,
+                                metrics: {
+                                    current: matches.length,
+                                    threshold: 0,
+                                    unit: "patterns",
+                                },
+                                recommendation: "Ensure proper cleanup of resources and event listeners",
+                            });
+                        }
+                    }
+                    // Check for blocking patterns
+                    for (const pattern of BLOCKING_PATTERNS) {
+                        const matches = content.match(pattern);
+                        if (matches && matches.length > 0) {
+                            bottlenecks.push({
+                                type: "cpu",
+                                location: `${dir}/${file}`,
+                                severity: "medium",
+                                description: `Blocking operation detected: ${matches[0]}`,
+                                metrics: {
+                                    current: matches.length,
+                                    threshold: 0,
+                                    unit: "occurrences",
+                                },
+                                recommendation: "Use async alternatives to avoid blocking the event loop",
+                            });
+                        }
+                    }
+                }
+                catch {
+                    // Skip files that can't be read
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist
+        }
+    }
+    return bottlenecks;
+}
+/**
+ * Analyze load test results for bottlenecks
+ */
+function analyzeLoadTestResults(results) {
+    const bottlenecks = [];
+    // Check for high latency
+    if (results.summary.latency.p95 > 500) {
+        bottlenecks.push({
+            type: "endpoint",
+            location: "Overall API",
+            severity: results.summary.latency.p95 > 1000 ? "critical" : "high",
+            description: `High 95th percentile latency: ${results.summary.latency.p95.toFixed(0)}ms`,
+            metrics: {
+                current: results.summary.latency.p95,
+                threshold: 500,
+                unit: "ms",
+            },
+            recommendation: "Profile endpoints to identify slow operations, add caching, or optimize queries",
+        });
+    }
+    // Check for high error rate
+    if (results.summary.errorRate > 0.01) {
+        bottlenecks.push({
+            type: "endpoint",
+            location: "Overall API",
+            severity: results.summary.errorRate > 0.05 ? "critical" : "high",
+            description: `High error rate: ${(results.summary.errorRate * 100).toFixed(2)}%`,
+            metrics: {
+                current: results.summary.errorRate,
+                threshold: 0.01,
+                unit: "rate",
+            },
+            recommendation: "Check error logs, add retry logic, or scale resources",
+        });
+    }
+    // Check for low throughput
+    if (results.summary.avgThroughput < 100) {
+        bottlenecks.push({
+            type: "endpoint",
+            location: "Overall API",
+            severity: "medium",
+            description: `Low throughput: ${results.summary.avgThroughput.toFixed(1)} req/s`,
+            metrics: {
+                current: results.summary.avgThroughput,
+                threshold: 100,
+                unit: "req/s",
+            },
+            recommendation: "Consider horizontal scaling or optimizing request handling",
+        });
+    }
+    // Check individual endpoints
+    for (const scenario of results.scenarios) {
+        for (const endpoint of scenario.endpoints) {
+            if (endpoint.latency.p95 > 500) {
+                bottlenecks.push({
+                    type: "endpoint",
+                    location: `${endpoint.method} ${endpoint.path}`,
+                    severity: endpoint.latency.p95 > 1000 ? "critical" : "high",
+                    description: `Slow endpoint: p95=${endpoint.latency.p95.toFixed(0)}ms`,
+                    metrics: {
+                        current: endpoint.latency.p95,
+                        threshold: 500,
+                        unit: "ms",
+                    },
+                    recommendation: "Add endpoint-specific caching or optimize the handler",
+                });
+            }
+        }
+    }
+    return bottlenecks;
+}
+/**
+ * Detect bottlenecks in a project
+ */
+export async function detectBottlenecks(projectPath, loadTestResults) {
+    const bottlenecks = [];
+    logger.info("scale.bottleneck_detection_started", { projectPath });
+    // Analyze source code
+    const codeBottlenecks = await analyzeSourceCode(projectPath);
+    bottlenecks.push(...codeBottlenecks);
+    // Analyze load test results if available
+    if (loadTestResults) {
+        const loadBottlenecks = analyzeLoadTestResults(loadTestResults);
+        bottlenecks.push(...loadBottlenecks);
+    }
+    // Sort by severity
+    const severityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+    bottlenecks.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+    logger.info("scale.bottleneck_detection_completed", {
+        total: bottlenecks.length,
+        critical: bottlenecks.filter((b) => b.severity === "critical").length,
+        high: bottlenecks.filter((b) => b.severity === "high").length,
+    });
+    return bottlenecks;
+}
+/**
+ * Calculate bottleneck score (100 = no bottlenecks)
+ */
+export function calculateBottleneckScore(bottlenecks) {
+    let score = 100;
+    for (const bottleneck of bottlenecks) {
+        switch (bottleneck.severity) {
+            case "critical":
+                score -= 25;
+                break;
+            case "high":
+                score -= 15;
+                break;
+            case "medium":
+                score -= 8;
+                break;
+            case "low":
+                score -= 3;
+                break;
+        }
+    }
+    return Math.max(0, score);
+}
+//# sourceMappingURL=bottleneck-detector.js.map

package/dist/scanners/scale/bottleneck-detector.js.map

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

package/dist/scanners/scale/capacity-estimator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Capacity Estimator
+ *
+ * Estimates maximum capacity and projects costs based on load test results.
+ *
+ * @module scanners/scale/capacity-estimator
+ */
+import type { CapacityEstimate, LoadTestResult, Bottleneck } from "./types.js";
+/**
+ * Estimate capacity for a project
+ */
+export declare function estimateCapacity(loadTestResult?: LoadTestResult, bottlenecks?: Bottleneck[]): Promise<CapacityEstimate>;
+/**
+ * Calculate capacity score (100 = excellent capacity margin)
+ */
+export declare function calculateCapacityScore(estimate: CapacityEstimate, targetConcurrent?: number): number;
+//# sourceMappingURL=capacity-estimator.d.ts.map

package/dist/scanners/scale/capacity-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacity-estimator.d.ts","sourceRoot":"","sources":["../../../src/scanners/scale/capacity-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiK/E;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,CAAC,EAAE,cAAc,EAC/B,WAAW,GAAE,UAAU,EAAO,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,gBAAgB,GAAE,MAAY,GAC7B,MAAM,CAUR"}

package/dist/scanners/scale/capacity-estimator.js

@@ -0,0 +1,197 @@
+/**
+ * Capacity Estimator
+ *
+ * Estimates maximum capacity and projects costs based on load test results.
+ *
+ * @module scanners/scale/capacity-estimator
+ */
+import { logger } from "../../logger.js";
+/**
+ * Instance type pricing (approximate monthly costs)
+ */
+const INSTANCE_PRICING = {
+    // AWS EC2 (us-east-1)
+    "t3.micro": { cpu: 2, memory: 1, price: 8 },
+    "t3.small": { cpu: 2, memory: 2, price: 15 },
+    "t3.medium": { cpu: 2, memory: 4, price: 30 },
+    "t3.large": { cpu: 2, memory: 8, price: 60 },
+    "t3.xlarge": { cpu: 4, memory: 16, price: 120 },
+    "m5.large": { cpu: 2, memory: 8, price: 70 },
+    "m5.xlarge": { cpu: 4, memory: 16, price: 140 },
+    "m5.2xlarge": { cpu: 8, memory: 32, price: 280 },
+    // Vercel (approximate)
+    "vercel-hobby": { cpu: 1, memory: 1, price: 0 },
+    "vercel-pro": { cpu: 1, memory: 1, price: 20 },
+    "vercel-enterprise": { cpu: 4, memory: 4, price: 500 },
+    // Railway
+    "railway-starter": { cpu: 1, memory: 0.5, price: 5 },
+    "railway-pro": { cpu: 2, memory: 2, price: 20 },
+};
+/**
+ * Estimate breakpoint (where system starts failing)
+ */
+function estimateBreakpoint(loadTestResult) {
+    // Use Little's Law and observed metrics
+    const avgLatency = loadTestResult.summary.latency.mean;
+    const throughput = loadTestResult.summary.avgThroughput;
+    const errorRate = loadTestResult.summary.errorRate;
+    // Find the scenario with highest VUs
+    const maxVus = Math.max(...loadTestResult.scenarios.map((s) => s.vusMax));
+    // If error rate is already high, breakpoint is near current load
+    if (errorRate > 0.05) {
+        return {
+            vus: Math.round(maxVus * 0.8),
+            confidence: 0.7,
+        };
+    }
+    // If latency is degraded but not failing, estimate 50% more capacity
+    if (loadTestResult.summary.latency.p95 > 500) {
+        return {
+            vus: Math.round(maxVus * 1.2),
+            confidence: 0.6,
+        };
+    }
+    // System handling load well, estimate 2x capacity
+    if (errorRate < 0.01 && avgLatency < 200) {
+        return {
+            vus: Math.round(maxVus * 2.5),
+            confidence: 0.5,
+        };
+    }
+    // Default conservative estimate
+    return {
+        vus: Math.round(maxVus * 1.5),
+        confidence: 0.4,
+    };
+}
+/**
+ * Calculate maximum requests per second
+ */
+function estimateMaxRPS(loadTestResult) {
+    const breakpoint = estimateBreakpoint(loadTestResult);
+    const currentRPS = loadTestResult.summary.avgThroughput;
+    const currentVUs = Math.max(...loadTestResult.scenarios.map((s) => s.vusMax));
+    if (currentVUs === 0)
+        return 0;
+    // Linear extrapolation with degradation factor
+    const rpsPerVU = currentRPS / currentVUs;
+    const degradationFactor = 0.8; // Assume 20% degradation at scale
+    return Math.round(breakpoint.vus * rpsPerVU * degradationFactor);
+}
+/**
+ * Generate recommendations based on results
+ */
+function generateRecommendations(loadTestResult, bottlenecks) {
+    const recommendations = [];
+    // High latency recommendations
+    if (loadTestResult.summary.latency.p95 > 500) {
+        recommendations.push("Add application-level caching (Redis, Memcached) to reduce database load");
+        recommendations.push("Consider using a CDN for static assets and cacheable API responses");
+    }
+    // High error rate recommendations
+    if (loadTestResult.summary.errorRate > 0.01) {
+        recommendations.push("Implement circuit breakers to prevent cascade failures");
+        recommendations.push("Add rate limiting to protect against traffic spikes");
+    }
+    // Database bottlenecks
+    const dbBottlenecks = bottlenecks.filter((b) => b.type === "database");
+    if (dbBottlenecks.length > 0) {
+        recommendations.push("Optimize database queries - add indexes and use connection pooling");
+        recommendations.push("Consider read replicas for read-heavy workloads");
+    }
+    // Memory bottlenecks
+    const memBottlenecks = bottlenecks.filter((b) => b.type === "memory");
+    if (memBottlenecks.length > 0) {
+        recommendations.push("Profile memory usage and fix potential leaks");
+        recommendations.push("Consider increasing instance memory or using smaller request payloads");
+    }
+    // General scaling recommendations
+    if (loadTestResult.summary.avgThroughput < 100) {
+        recommendations.push("Consider horizontal scaling with a load balancer");
+    }
+    // Add default if no specific recommendations
+    if (recommendations.length === 0) {
+        recommendations.push("System performing well - monitor for degradation at higher loads");
+    }
+    return recommendations;
+}
+/**
+ * Project infrastructure costs
+ */
+function projectCosts(maxRPS, maxConcurrent) {
+    // Simple heuristic: 1000 RPS per m5.large
+    const rpsPerInstance = 1000;
+    const instancesNeeded = Math.ceil(maxRPS / rpsPerInstance);
+    // Choose appropriate instance type
+    let instanceType = "t3.medium";
+    if (maxConcurrent > 500)
+        instanceType = "t3.large";
+    if (maxConcurrent > 1000)
+        instanceType = "m5.large";
+    if (maxConcurrent > 5000)
+        instanceType = "m5.xlarge";
+    const pricing = INSTANCE_PRICING[instanceType];
+    return {
+        provider: "AWS",
+        instanceType,
+        instances: Math.max(2, instancesNeeded), // At least 2 for HA
+        monthlyCost: Math.max(2, instancesNeeded) * pricing.price,
+    };
+}
+/**
+ * Estimate capacity for a project
+ */
+export async function estimateCapacity(loadTestResult, bottlenecks = []) {
+    logger.info("scale.capacity_estimation_started");
+    // If no load test results, return conservative estimates
+    if (!loadTestResult) {
+        return {
+            maxConcurrentUsers: 100,
+            maxRequestsPerSecond: 50,
+            estimatedBreakpoint: {
+                vus: 200,
+                confidence: 0.2,
+            },
+            recommendations: [
+                "Run load tests to get accurate capacity estimates",
+                "Start with baseline performance monitoring",
+            ],
+        };
+    }
+    const breakpoint = estimateBreakpoint(loadTestResult);
+    const maxRPS = estimateMaxRPS(loadTestResult);
+    const recommendations = generateRecommendations(loadTestResult, bottlenecks);
+    const costProjection = projectCosts(maxRPS, breakpoint.vus);
+    const estimate = {
+        maxConcurrentUsers: breakpoint.vus,
+        maxRequestsPerSecond: maxRPS,
+        estimatedBreakpoint: breakpoint,
+        recommendations,
+        costProjection,
+    };
+    logger.info("scale.capacity_estimation_completed", {
+        maxConcurrent: estimate.maxConcurrentUsers,
+        maxRPS: estimate.maxRequestsPerSecond,
+        confidence: breakpoint.confidence,
+    });
+    return estimate;
+}
+/**
+ * Calculate capacity score (100 = excellent capacity margin)
+ */
+export function calculateCapacityScore(estimate, targetConcurrent = 100) {
+    // Score based on how much headroom we have
+    const headroom = estimate.maxConcurrentUsers / targetConcurrent;
+    if (headroom >= 5)
+        return 100; // 5x headroom
+    if (headroom >= 3)
+        return 90; // 3x headroom
+    if (headroom >= 2)
+        return 80; // 2x headroom
+    if (headroom >= 1.5)
+        return 70; // 1.5x headroom
+    if (headroom >= 1)
+        return 50; // Just meeting target
+    return Math.round(headroom * 50); // Below target
+}
+//# sourceMappingURL=capacity-estimator.js.map

package/dist/scanners/scale/capacity-estimator.js.map

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

package/dist/scanners/scale/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Scale Assessment Scanner
+ *
+ * Orchestrates load testing, bottleneck detection, and capacity estimation.
+ * This is the entry point for M8 scale assessment capabilities.
+ *
+ * @module scanners/scale
+ */
+import { detectBottlenecks } from "./bottleneck-detector.js";
+import type { ScaleAssessmentResult } from "./types.js";
+export * from "./types.js";
+export { detectLoadTool, discoverProfiles, runK6Test, generateSampleProfile, loadProfile, isK6Available, } from "./load-profiler.js";
+export { detectBottlenecks, calculateBottleneckScore, } from "./bottleneck-detector.js";
+export { estimateCapacity, calculateCapacityScore, } from "./capacity-estimator.js";
+/**
+ * Run full scale assessment
+ *
+ * 1. Detect load testing tool
+ * 2. Discover and run load profiles
+ * 3. Detect bottlenecks
+ * 4. Estimate capacity
+ * 5. Calculate scores
+ */
+export declare function runScaleAssessment(projectPath: string, baseUrl: string, options?: {
+    timeout?: number;
+    profileName?: string;
+    skipLoadTest?: boolean;
+    targetConcurrent?: number;
+}): Promise<ScaleAssessmentResult>;
+/**
+ * Quick bottleneck scan (no load testing)
+ */
+export declare function quickBottleneckScan(projectPath: string): Promise<{
+    bottlenecks: Awaited<ReturnType<typeof detectBottlenecks>>;
+    score: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/scanners/scale/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scanners/scale/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,EACL,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,WAAW,EACX,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACtB,GACL,OAAO,CAAC,qBAAqB,CAAC,CA8EhC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAKD"}

package/dist/scanners/scale/index.js

@@ -0,0 +1,101 @@
+/**
+ * Scale Assessment Scanner
+ *
+ * Orchestrates load testing, bottleneck detection, and capacity estimation.
+ * This is the entry point for M8 scale assessment capabilities.
+ *
+ * @module scanners/scale
+ */
+import { logger } from "../../logger.js";
+import { detectLoadTool, discoverProfiles, runK6Test, } from "./load-profiler.js";
+import { detectBottlenecks, calculateBottleneckScore, } from "./bottleneck-detector.js";
+import { estimateCapacity, calculateCapacityScore, } from "./capacity-estimator.js";
+export * from "./types.js";
+export { detectLoadTool, discoverProfiles, runK6Test, generateSampleProfile, loadProfile, isK6Available, } from "./load-profiler.js";
+export { detectBottlenecks, calculateBottleneckScore, } from "./bottleneck-detector.js";
+export { estimateCapacity, calculateCapacityScore, } from "./capacity-estimator.js";
+/**
+ * Run full scale assessment
+ *
+ * 1. Detect load testing tool
+ * 2. Discover and run load profiles
+ * 3. Detect bottlenecks
+ * 4. Estimate capacity
+ * 5. Calculate scores
+ */
+export async function runScaleAssessment(projectPath, baseUrl, options = {}) {
+    const startTime = Date.now();
+    const { timeout = 600000, profileName, skipLoadTest = false, targetConcurrent = 100 } = options;
+    logger.info("scale.assessment_started", { projectPath, baseUrl });
+    let loadTestResult;
+    // Step 1: Run load tests if not skipped
+    if (!skipLoadTest) {
+        // Check for load testing tools
+        const tool = await detectLoadTool();
+        if (!tool) {
+            logger.warn("scale.no_load_tool", {
+                message: "No load testing tool found. Install k6 or Artillery.",
+            });
+        }
+        else {
+            // Discover profiles
+            const profiles = await discoverProfiles(projectPath);
+            if (profiles.length === 0) {
+                logger.info("scale.no_profiles_found", {
+                    message: "No load profiles found. Generate one with scale_profile_generate.",
+                });
+            }
+            else {
+                // Find matching profile or use first
+                const selectedProfile = profileName
+                    ? profiles.find((p) => p.profile.name === profileName)
+                    : profiles[0];
+                if (selectedProfile && tool === "k6") {
+                    loadTestResult = await runK6Test(selectedProfile.profile, baseUrl, {
+                        timeout,
+                    });
+                }
+            }
+        }
+    }
+    // Step 2: Detect bottlenecks
+    const bottlenecks = await detectBottlenecks(projectPath, loadTestResult);
+    const bottleneckScore = calculateBottleneckScore(bottlenecks);
+    // Step 3: Estimate capacity
+    const capacity = await estimateCapacity(loadTestResult, bottlenecks);
+    const capacityScore = calculateCapacityScore(capacity, targetConcurrent);
+    // Step 4: Calculate overall score
+    const loadTestScore = loadTestResult?.score ?? 50; // Neutral if no test
+    const overallScore = Math.round((loadTestScore * 0.4) + (bottleneckScore * 0.35) + (capacityScore * 0.25));
+    const result = {
+        success: overallScore >= 70,
+        loadTest: loadTestResult,
+        bottlenecks,
+        capacity,
+        score: {
+            loadTestScore,
+            bottleneckScore,
+            capacityScore,
+            overallScore,
+        },
+        duration: Date.now() - startTime,
+    };
+    logger.info("scale.assessment_completed", {
+        success: result.success,
+        overallScore,
+        loadTestScore,
+        bottleneckScore,
+        capacityScore,
+        duration: result.duration,
+    });
+    return result;
+}
+/**
+ * Quick bottleneck scan (no load testing)
+ */
+export async function quickBottleneckScan(projectPath) {
+    const bottlenecks = await detectBottlenecks(projectPath);
+    const score = calculateBottleneckScore(bottlenecks);
+    return { bottlenecks, score };
+}
+//# sourceMappingURL=index.js.map

package/dist/scanners/scale/index.js.map

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