@nahisaho/musubix-core 1.0.0

package/dist/utils/scalability-optimizer.d.ts

@@ -0,0 +1,294 @@
+/**
+ * Scalability Optimizer
+ *
+ * Optimizes system for scalability
+ *
+ * @packageDocumentation
+ * @module utils/scalability-optimizer
+ *
+ * @see REQ-PER-002 - Scalability Optimization
+ * @see Article IX - Continuous Adaptation
+ */
+/**
+ * Resource type
+ */
+export type ResourceType = 'cpu' | 'memory' | 'io' | 'network' | 'storage';
+/**
+ * Scaling strategy
+ */
+export type ScalingStrategy = 'horizontal' | 'vertical' | 'hybrid' | 'none';
+/**
+ * Resource metrics
+ */
+export interface ResourceMetrics {
+    /** Resource type */
+    type: ResourceType;
+    /** Current usage (0-1) */
+    usage: number;
+    /** Capacity */
+    capacity: number;
+    /** Available */
+    available: number;
+    /** Peak usage */
+    peakUsage: number;
+    /** Average usage */
+    avgUsage: number;
+}
+/**
+ * Load pattern
+ */
+export interface LoadPattern {
+    /** Pattern name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Average load */
+    avgLoad: number;
+    /** Peak load */
+    peakLoad: number;
+    /** Variance */
+    variance: number;
+    /** Predictable */
+    predictable: boolean;
+    /** Seasonal */
+    seasonal: boolean;
+}
+/**
+ * Bottleneck info
+ */
+export interface Bottleneck {
+    /** Resource type */
+    resource: ResourceType;
+    /** Severity (0-1) */
+    severity: number;
+    /** Description */
+    description: string;
+    /** Impact */
+    impact: string;
+    /** Recommendation */
+    recommendation: string;
+}
+/**
+ * Scaling recommendation
+ */
+export interface ScalingRecommendation {
+    /** Recommendation ID */
+    id: string;
+    /** Strategy */
+    strategy: ScalingStrategy;
+    /** Resource type */
+    resource: ResourceType;
+    /** Current capacity */
+    currentCapacity: number;
+    /** Recommended capacity */
+    recommendedCapacity: number;
+    /** Scale factor */
+    scaleFactor: number;
+    /** Priority */
+    priority: 'high' | 'medium' | 'low';
+    /** Rationale */
+    rationale: string;
+    /** Estimated cost impact */
+    costImpact?: 'increase' | 'decrease' | 'neutral';
+    /** Implementation steps */
+    steps: string[];
+}
+/**
+ * Optimization result
+ */
+export interface OptimizationResult {
+    /** Timestamp */
+    timestamp: Date;
+    /** Metrics analyzed */
+    metrics: ResourceMetrics[];
+    /** Load pattern */
+    loadPattern: LoadPattern;
+    /** Bottlenecks found */
+    bottlenecks: Bottleneck[];
+    /** Recommendations */
+    recommendations: ScalingRecommendation[];
+    /** Overall score (0-100) */
+    scalabilityScore: number;
+    /** Summary */
+    summary: string;
+}
+/**
+ * Capacity plan
+ */
+export interface CapacityPlan {
+    /** Plan ID */
+    id: string;
+    /** Name */
+    name: string;
+    /** Target date */
+    targetDate: Date;
+    /** Current capacity */
+    current: Record<ResourceType, number>;
+    /** Planned capacity */
+    planned: Record<ResourceType, number>;
+    /** Expected load */
+    expectedLoad: number;
+    /** Safety margin */
+    safetyMargin: number;
+    /** Cost estimate */
+    costEstimate?: number;
+}
+/**
+ * Scalability config
+ */
+export interface ScalabilityConfig {
+    /** Target utilization (0-1) */
+    targetUtilization: number;
+    /** Safety margin (0-1) */
+    safetyMargin: number;
+    /** Scale up threshold */
+    scaleUpThreshold: number;
+    /** Scale down threshold */
+    scaleDownThreshold: number;
+    /** Min instances */
+    minInstances: number;
+    /** Max instances */
+    maxInstances: number;
+    /** Cooldown period (ms) */
+    cooldownPeriod: number;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_SCALABILITY_CONFIG: ScalabilityConfig;
+/**
+ * Queue metrics
+ */
+export interface QueueMetrics {
+    /** Queue name */
+    name: string;
+    /** Current length */
+    length: number;
+    /** Max length */
+    maxLength: number;
+    /** Processing rate */
+    processingRate: number;
+    /** Arrival rate */
+    arrivalRate: number;
+    /** Wait time (ms) */
+    avgWaitTime: number;
+}
+/**
+ * Throughput metrics
+ */
+export interface ThroughputMetrics {
+    /** Requests per second */
+    rps: number;
+    /** Peak RPS */
+    peakRps: number;
+    /** Success rate */
+    successRate: number;
+    /** Error rate */
+    errorRate: number;
+    /** Latency p50 */
+    latencyP50: number;
+    /** Latency p99 */
+    latencyP99: number;
+}
+/**
+ * Scalability Optimizer
+ */
+export declare class ScalabilityOptimizer {
+    private config;
+    private metricsHistory;
+    private loadHistory;
+    private recommendationCounter;
+    constructor(config?: Partial<ScalabilityConfig>);
+    /**
+     * Analyze current metrics
+     */
+    analyze(metrics: ResourceMetrics[]): OptimizationResult;
+    /**
+     * Analyze load pattern
+     */
+    private analyzeLoadPattern;
+    /**
+     * Find bottlenecks
+     */
+    private findBottlenecks;
+    /**
+     * Describe bottleneck impact
+     */
+    private describeImpact;
+    /**
+     * Get bottleneck recommendation
+     */
+    private getBottleneckRecommendation;
+    /**
+     * Generate scaling recommendations
+     */
+    private generateRecommendations;
+    /**
+     * Recommend for specific resource
+     */
+    private recommendForResource;
+    /**
+     * Calculate scale factor
+     */
+    private calculateScaleFactor;
+    /**
+     * Determine scaling strategy
+     */
+    private determineStrategy;
+    /**
+     * Get scale up steps
+     */
+    private getScaleUpSteps;
+    /**
+     * Get scale down steps
+     */
+    private getScaleDownSteps;
+    /**
+     * Calculate scalability score
+     */
+    private calculateScalabilityScore;
+    /**
+     * Generate summary
+     */
+    private generateSummary;
+    /**
+     * Create capacity plan
+     */
+    createCapacityPlan(name: string, expectedLoadGrowth: number, targetDate: Date, currentMetrics: ResourceMetrics[]): CapacityPlan;
+    /**
+     * Analyze queue metrics
+     */
+    analyzeQueue(queue: QueueMetrics): {
+        healthy: boolean;
+        recommendation: string;
+    };
+    /**
+     * Analyze throughput
+     */
+    analyzeThroughput(throughput: ThroughputMetrics): {
+        healthy: boolean;
+        bottleneck?: string;
+        recommendation: string;
+    };
+    /**
+     * Calculate variance
+     */
+    private calculateVariance;
+    /**
+     * Detect seasonality (simplified)
+     */
+    private detectSeasonality;
+    /**
+     * Calculate correlation
+     */
+    private calculateCorrelation;
+    /**
+     * Format result as string
+     */
+    formatResult(result: OptimizationResult): string;
+}
+/**
+ * Create scalability optimizer instance
+ */
+export declare function createScalabilityOptimizer(config?: Partial<ScalabilityConfig>): ScalabilityOptimizer;
+//# sourceMappingURL=scalability-optimizer.d.ts.map

package/dist/utils/scalability-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalability-optimizer.d.ts","sourceRoot":"","sources":["../../src/utils/scalability-optimizer.ts"],"names":[],"mappings":"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"}