vaspera 2.10.0 → 2.11.0

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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"}

package/dist/scanners/scale/load-profiler.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Load Profiler
+ *
+ * Runs load tests using k6, Artillery, or other tools.
+ * Generates k6 scripts from YAML profile definitions.
+ *
+ * @module scanners/scale/load-profiler
+ */
+import { type LoadProfile, type LoadTestResult, type LoadTool } from "./types.js";
+/**
+ * Check if k6 is installed
+ */
+export declare function isK6Available(): Promise<boolean>;
+/**
+ * Check if Artillery is installed
+ */
+export declare function isArtilleryAvailable(): Promise<boolean>;
+/**
+ * Detect best available load testing tool
+ */
+export declare function detectLoadTool(): Promise<LoadTool | null>;
+/**
+ * Generate k6 script from load profile
+ */
+export declare function generateK6Script(profile: LoadProfile, baseUrl: string): string;
+/**
+ * Load a profile from YAML file
+ */
+export declare function loadProfile(profilePath: string): Promise<LoadProfile>;
+/**
+ * Discover all load profiles in a project
+ */
+export declare function discoverProfiles(projectPath: string): Promise<Array<{
+    path: string;
+    profile: LoadProfile;
+}>>;
+/**
+ * Run a load test with k6
+ */
+export declare function runK6Test(profile: LoadProfile, baseUrl: string, options?: {
+    timeout?: number;
+    outputDir?: string;
+}): Promise<LoadTestResult>;
+/**
+ * Generate a sample load profile
+ */
+export declare function generateSampleProfile(projectPath: string, name?: string): Promise<string>;
+//# sourceMappingURL=load-profiler.d.ts.map

package/dist/scanners/scale/load-profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-profiler.d.ts","sourceRoot":"","sources":["../../../src/scanners/scale/load-profiler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,cAAc,EAGnB,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAMtD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAM7D;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAI/D;AAwBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsD9E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAI3E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC,CA0BxD;AAgDD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,cAAc,CAAC,CAkIzB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,MAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA8DjB"}