@nahisaho/musubix-security 1.8.0 → 1.8.5

package/dist/intelligence/predictive-analyzer.d.ts

@@ -0,0 +1,317 @@
+/**
+ * @fileoverview Predictive Security Analyzer
+ * @module @nahisaho/musubix-security/intelligence/predictive-analyzer
+ *
+ * Provides security prediction, anomaly forecasting, risk projection,
+ * and proactive security recommendations.
+ */
+import type { VulnerabilityStats, SecurityMetric } from './security-analytics.js';
+import type { ThreatContext } from './threat-intelligence.js';
+/**
+ * Prediction confidence level
+ */
+export type PredictionConfidence = 'high' | 'medium' | 'low' | 'uncertain';
+/**
+ * Risk projection
+ */
+export interface RiskProjection {
+    /** Projection ID */
+    id: string;
+    /** Current risk score */
+    currentRisk: number;
+    /** Projected risk score */
+    projectedRisk: number;
+    /** Projection period (days) */
+    periodDays: number;
+    /** Change direction */
+    direction: 'increasing' | 'decreasing' | 'stable';
+    /** Change magnitude */
+    magnitude: number;
+    /** Confidence level */
+    confidence: PredictionConfidence;
+    /** Confidence score (0-1) */
+    confidenceScore: number;
+    /** Contributing factors */
+    factors: {
+        name: string;
+        impact: number;
+        description: string;
+    }[];
+    /** Recommendations */
+    recommendations: string[];
+    /** Projected at */
+    projectedAt: Date;
+}
+/**
+ * Vulnerability prediction
+ */
+export interface VulnerabilityPrediction {
+    /** Prediction ID */
+    id: string;
+    /** Vulnerability type */
+    type: string;
+    /** Predicted count */
+    predictedCount: number;
+    /** Current count */
+    currentCount: number;
+    /** Change */
+    change: number;
+    /** Likelihood (0-1) */
+    likelihood: number;
+    /** Confidence */
+    confidence: PredictionConfidence;
+    /** Time frame (days) */
+    timeFrame: number;
+    /** Risk level if materialized */
+    riskLevel: 'critical' | 'high' | 'medium' | 'low';
+    /** Prevention strategies */
+    preventionStrategies: string[];
+}
+/**
+ * Security anomaly
+ */
+export interface SecurityAnomaly {
+    /** Anomaly ID */
+    id: string;
+    /** Anomaly type */
+    type: 'spike' | 'drop' | 'pattern-break' | 'unusual-activity';
+    /** Metric affected */
+    metric: string;
+    /** Expected value */
+    expectedValue: number;
+    /** Actual value */
+    actualValue: number;
+    /** Deviation */
+    deviation: number;
+    /** Severity */
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    /** Detection confidence */
+    confidence: number;
+    /** Detected at */
+    detectedAt: Date;
+    /** Possible causes */
+    possibleCauses: string[];
+    /** Recommended actions */
+    recommendedActions: string[];
+}
+/**
+ * Proactive alert
+ */
+export interface ProactiveAlert {
+    /** Alert ID */
+    id: string;
+    /** Alert type */
+    type: 'risk-increase' | 'vulnerability-surge' | 'pattern-detected' | 'threshold-breach';
+    /** Alert title */
+    title: string;
+    /** Alert message */
+    message: string;
+    /** Severity */
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    /** Confidence */
+    confidence: PredictionConfidence;
+    /** Time to impact (hours) */
+    timeToImpact?: number;
+    /** Recommended actions */
+    actions: string[];
+    /** Related predictions */
+    relatedPredictions: string[];
+    /** Created at */
+    createdAt: Date;
+}
+/**
+ * Security forecast
+ */
+export interface SecurityForecast {
+    /** Forecast ID */
+    id: string;
+    /** Forecast period */
+    period: {
+        start: Date;
+        end: Date;
+    };
+    /** Risk projections */
+    riskProjections: RiskProjection[];
+    /** Vulnerability predictions */
+    vulnerabilityPredictions: VulnerabilityPrediction[];
+    /** Expected trends */
+    expectedTrends: {
+        metric: string;
+        direction: 'up' | 'down' | 'stable';
+        magnitude: number;
+        confidence: number;
+    }[];
+    /** Key risks */
+    keyRisks: string[];
+    /** Opportunities */
+    opportunities: string[];
+    /** Recommendations */
+    recommendations: string[];
+    /** Generated at */
+    generatedAt: Date;
+}
+/**
+ * Historical data point
+ */
+export interface HistoricalDataPoint {
+    timestamp: Date;
+    value: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Predictive Analyzer options
+ */
+export interface PredictiveAnalyzerOptions {
+    /** Historical data lookback (days) */
+    lookbackDays?: number;
+    /** Forecast horizon (days) */
+    forecastDays?: number;
+    /** Anomaly detection sensitivity (0-1) */
+    anomalySensitivity?: number;
+    /** Alert thresholds */
+    alertThresholds?: {
+        riskIncrease: number;
+        vulnerabilitySurge: number;
+        deviationPercent: number;
+    };
+    /** Enable proactive alerts */
+    enableProactiveAlerts?: boolean;
+}
+/**
+ * Predictive Security Analyzer
+ */
+export declare class PredictiveAnalyzer {
+    private options;
+    private historicalData;
+    private alerts;
+    private anomalies;
+    constructor(options?: PredictiveAnalyzerOptions);
+    /**
+     * Add historical data point
+     */
+    addDataPoint(metric: string, dataPoint: HistoricalDataPoint): void;
+    /**
+     * Add multiple historical data points
+     */
+    addDataPoints(metric: string, dataPoints: HistoricalDataPoint[]): void;
+    /**
+     * Prune old data
+     */
+    private pruneOldData;
+    /**
+     * Import data from metrics
+     */
+    importFromMetrics(metrics: SecurityMetric[]): void;
+    /**
+     * Import data from vulnerability stats
+     */
+    importFromVulnStats(stats: VulnerabilityStats, timestamp?: Date): void;
+    /**
+     * Project future risk
+     */
+    projectRisk(currentRiskScore: number, threatContext?: ThreatContext): RiskProjection;
+    /**
+     * Forecast a value using simple linear regression
+     */
+    private forecastValue;
+    /**
+     * Calculate confidence level
+     */
+    private calculateConfidence;
+    /**
+     * Generate risk recommendations
+     */
+    private generateRiskRecommendations;
+    /**
+     * Predict vulnerabilities
+     */
+    predictVulnerabilities(): VulnerabilityPrediction[];
+    /**
+     * Get prevention strategies
+     */
+    private getPreventionStrategies;
+    /**
+     * Detect anomalies
+     */
+    detectAnomalies(): SecurityAnomaly[];
+    /**
+     * Detect anomaly in a metric
+     */
+    private detectMetricAnomaly;
+    /**
+     * Get possible causes for anomaly
+     */
+    private getPossibleCauses;
+    /**
+     * Get recommended actions for anomaly
+     */
+    private getAnomalyActions;
+    /**
+     * Create proactive alert
+     */
+    private createAlert;
+    /**
+     * Get all alerts
+     */
+    getAlerts(): ProactiveAlert[];
+    /**
+     * Get alerts by severity
+     */
+    getAlertsBySeverity(severity: ProactiveAlert['severity']): ProactiveAlert[];
+    /**
+     * Clear old alerts
+     */
+    clearOldAlerts(maxAgeDays?: number): number;
+    /**
+     * Generate security forecast
+     */
+    generateForecast(): SecurityForecast;
+    /**
+     * Get statistics
+     */
+    getStatistics(): {
+        dataPointsCount: number;
+        metricsTracked: number;
+        alertsCount: number;
+        anomaliesCount: number;
+        oldestData: Date | null;
+        latestData: Date | null;
+    };
+    /**
+     * Get anomalies
+     */
+    getAnomalies(): SecurityAnomaly[];
+    /**
+     * Export data
+     */
+    exportData(): {
+        historicalData: Record<string, HistoricalDataPoint[]>;
+        alerts: ProactiveAlert[];
+        anomalies: SecurityAnomaly[];
+    };
+    /**
+     * Import data
+     */
+    importData(data: {
+        historicalData?: Record<string, HistoricalDataPoint[]>;
+        alerts?: ProactiveAlert[];
+        anomalies?: SecurityAnomaly[];
+    }): void;
+}
+/**
+ * Create a PredictiveAnalyzer instance
+ */
+export declare function createPredictiveAnalyzer(options?: PredictiveAnalyzerOptions): PredictiveAnalyzer;
+/**
+ * Quick risk projection
+ */
+export declare function projectRisk(currentRisk: number, historicalData: HistoricalDataPoint[]): RiskProjection;
+/**
+ * Quick vulnerability prediction
+ */
+export declare function predictVulnerabilities(vulnStats: VulnerabilityStats[]): VulnerabilityPrediction[];
+/**
+ * Quick anomaly detection
+ */
+export declare function detectAnomalies(metrics: SecurityMetric[]): SecurityAnomaly[];
+//# sourceMappingURL=predictive-analyzer.d.ts.map

package/dist/intelligence/predictive-analyzer.d.ts.map

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