@nindroidsystems/pluginator 2.3.0

package/dist/core/health/health-types.d.ts

@@ -0,0 +1,298 @@
+/**
+ * Plugin Health & Compatibility Types
+ *
+ * Type definitions for the health scoring and compatibility system.
+ *
+ * @since v1.66.0
+ */
+/**
+ * Health issue severity levels
+ */
+export type HealthSeverity = 'critical' | 'warning' | 'info';
+/**
+ * Health status categories
+ */
+export type HealthStatus = 'good' | 'warning' | 'critical';
+/**
+ * Health grade levels (A+ through F)
+ */
+export type HealthGrade = 'A+' | 'A' | 'B+' | 'B' | 'C+' | 'C' | 'D' | 'F';
+/**
+ * Types of health issues that can be detected
+ */
+export type HealthIssueType = 'outdated_version' | 'mc_incompatible' | 'missing_dependency' | 'conflicting_dependency' | 'unmaintained' | 'security_vulnerability' | 'known_bug' | 'deprecated' | 'abandoned' | 'load_order_issue';
+/**
+ * Health component (individual score category)
+ */
+export interface HealthComponent {
+    /** Score from 0-100 */
+    score: number;
+    /** Weight contribution to overall score (0-1) */
+    weight: number;
+    /** Current status */
+    status: HealthStatus;
+    /** Human-readable details */
+    details: string;
+    /** When this component was last evaluated */
+    lastChecked: number;
+}
+/**
+ * Health issue detected for a plugin
+ */
+export interface HealthIssue {
+    /** Unique issue ID */
+    id: string;
+    /** Severity level */
+    severity: HealthSeverity;
+    /** Issue type for categorization */
+    type: HealthIssueType;
+    /** Short title */
+    title: string;
+    /** Detailed description */
+    description: string;
+    /** How to fix the issue */
+    remediation?: string;
+    /** Whether this can be auto-fixed */
+    autoFixable: boolean;
+    /** Auto-fix action ID if applicable */
+    autoFixAction?: string;
+    /** Related plugin (for dependency issues) */
+    relatedPlugin?: string;
+    /** When the issue was first detected */
+    detectedAt: number;
+}
+/**
+ * Health recommendation for improving plugin health
+ */
+export interface HealthRecommendation {
+    /** Unique recommendation ID */
+    id: string;
+    /** Priority (higher = more important) */
+    priority: number;
+    /** Short title */
+    title: string;
+    /** Detailed description */
+    description: string;
+    /** Expected score improvement if applied */
+    expectedImprovement: number;
+    /** Action to take */
+    action: RecommendationAction;
+}
+/**
+ * Types of recommendation actions
+ */
+export type RecommendationAction = {
+    type: 'update';
+    targetVersion: string;
+} | {
+    type: 'install';
+    pluginName: string;
+} | {
+    type: 'remove';
+    reason: string;
+} | {
+    type: 'configure';
+    setting: string;
+    value: string;
+} | {
+    type: 'review';
+    url: string;
+};
+/**
+ * Complete health score for a plugin
+ */
+export interface PluginHealthScore {
+    /** Plugin identifier */
+    pluginId: string;
+    /** Plugin name for display */
+    pluginName: string;
+    /** Overall health score (0-100) */
+    overall: number;
+    /** Letter grade */
+    grade: HealthGrade;
+    /** Individual component scores */
+    components: {
+        /** Is the plugin version current? */
+        version: HealthComponent;
+        /** Is the plugin compatible with current MC version? */
+        compatibility: HealthComponent;
+        /** Is the plugin actively maintained? */
+        maintenance: HealthComponent;
+        /** Are dependencies healthy? */
+        dependencies: HealthComponent;
+        /** Any known security vulnerabilities? */
+        security: HealthComponent;
+        /** Error history and stability */
+        stability: HealthComponent;
+    };
+    /** Detected issues */
+    issues: HealthIssue[];
+    /** Improvement recommendations */
+    recommendations: HealthRecommendation[];
+    /** When the score was last calculated */
+    lastChecked: number;
+    /** Score trend (positive = improving) */
+    trend?: number;
+}
+/**
+ * Server-wide health summary
+ */
+export interface ServerHealthSummary {
+    /** Overall server health score (0-100) */
+    overallScore: number;
+    /** Server health grade */
+    grade: HealthGrade;
+    /** Total plugins analyzed */
+    totalPlugins: number;
+    /** Plugins by health status */
+    byStatus: {
+        healthy: number;
+        warning: number;
+        outdated: number;
+        critical: number;
+    };
+    /** Plugins by grade */
+    byGrade: Record<HealthGrade, number>;
+    /** All critical issues across plugins */
+    criticalIssues: Array<{
+        pluginId: string;
+        pluginName: string;
+        issue: HealthIssue;
+    }>;
+    /** Top recommendations across all plugins */
+    topRecommendations: Array<{
+        pluginId: string;
+        pluginName: string;
+        recommendation: HealthRecommendation;
+    }>;
+    /** When the summary was generated */
+    generatedAt: number;
+    /** Score trend over time */
+    trend: number;
+}
+/**
+ * Health check configuration
+ */
+export interface HealthCheckConfig {
+    /** Component weights (must sum to 1.0) */
+    weights: {
+        version: number;
+        compatibility: number;
+        maintenance: number;
+        dependencies: number;
+        security: number;
+        stability: number;
+    };
+    /** Grade thresholds */
+    gradeThresholds: {
+        'A+': number;
+        A: number;
+        'B+': number;
+        B: number;
+        'C+': number;
+        C: number;
+        D: number;
+    };
+    /** Version freshness scoring */
+    versionScoring: {
+        current: number;
+        oneMinorBehind: number;
+        twoMinorBehind: number;
+        oneMajorBehind: number;
+        twoMajorBehind: number;
+    };
+    /** Maintenance activity scoring (days since update) */
+    maintenanceScoring: {
+        within30Days: number;
+        within90Days: number;
+        within180Days: number;
+        within1Year: number;
+        over1Year: number;
+        over2Years: number;
+    };
+    /** MC version compatibility scoring */
+    compatibilityScoring: {
+        exactMatch: number;
+        oneMinorBehind: number;
+        twoMinorBehind: number;
+        moreThanTwoBehind: number;
+        knownIncompatible: number;
+    };
+}
+/**
+ * Default health check configuration
+ */
+export declare const DEFAULT_HEALTH_CONFIG: HealthCheckConfig;
+/**
+ * Plugin metadata needed for health checks
+ */
+export interface PluginHealthMetadata {
+    /** Plugin identifier */
+    pluginId: string;
+    /** Plugin display name */
+    name: string;
+    /** Currently installed version */
+    currentVersion: string;
+    /** Latest available version */
+    latestVersion?: string;
+    /** When the plugin was last updated upstream */
+    lastUpdatedAt?: number;
+    /** Supported Minecraft versions */
+    supportedMcVersions?: string[];
+    /** Hard dependencies */
+    dependencies?: string[];
+    /** Soft dependencies */
+    softDependencies?: string[];
+    /** Known security vulnerabilities */
+    knownVulnerabilities?: SecurityVulnerability[];
+    /** Is the plugin deprecated? */
+    deprecated?: boolean;
+    /** Deprecation reason/alternative */
+    deprecationInfo?: string;
+}
+/**
+ * Security vulnerability information
+ */
+export interface SecurityVulnerability {
+    /** CVE or internal ID */
+    id: string;
+    /** Severity (CVSS-based) */
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    /** Description of the vulnerability */
+    description: string;
+    /** Affected versions */
+    affectedVersions: string;
+    /** Fixed in version (if patched) */
+    fixedInVersion?: string;
+    /** Reference URL */
+    referenceUrl?: string;
+}
+/**
+ * Health check result for a single plugin
+ */
+export interface HealthCheckResult {
+    /** Plugin ID */
+    pluginId: string;
+    /** Whether the check succeeded */
+    success: boolean;
+    /** The health score if successful */
+    score?: PluginHealthScore;
+    /** Error message if failed */
+    error?: string;
+    /** Duration of the check in ms */
+    durationMs: number;
+}
+/**
+ * Batch health check result
+ */
+export interface BatchHealthCheckResult {
+    /** Individual results */
+    results: HealthCheckResult[];
+    /** Server-wide summary */
+    summary: ServerHealthSummary;
+    /** Total duration in ms */
+    totalDurationMs: number;
+    /** Timestamp */
+    timestamp: number;
+}
+//# sourceMappingURL=health-types.d.ts.map

package/dist/core/health/health-types.d.ts.map

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

package/dist/core/health/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Plugin Health & Compatibility System
+ *
+ * Exports for the health scoring and compatibility checking system.
+ *
+ * @since v1.66.0
+ */
+export type { HealthSeverity, HealthStatus, HealthGrade, HealthIssueType, HealthComponent, HealthIssue, HealthRecommendation, RecommendationAction, PluginHealthScore, ServerHealthSummary, HealthCheckConfig, PluginHealthMetadata, SecurityVulnerability, HealthCheckResult, BatchHealthCheckResult, } from './health-types.js';
+export { DEFAULT_HEALTH_CONFIG } from './health-types.js';
+export { comparePluginVersions, calculateVersionScore, getVersionStatusDescription, checkVersionFreshness, isBreakingUpdate, getUpdateRecommendation, type VersionComparisonResult, } from './version-checker.js';
+export { daysSince, getMaintenanceStatus, calculateMaintenanceScore, getMaintenanceDescription, checkMaintenanceActivity, checkMaintenance, isAbandonmentRisk, getTimeSinceUpdate, type MaintenanceStatus, type MaintenanceCheckResult, } from './maintenance-checker.js';
+export { parseMcVersion, compareMcVersions, getMinorVersionsBehind, versionMatches, findHighestSupportedVersion, getCompatibilityStatus, calculateCompatibilityScore, getCompatibilityDescription, checkMcCompatibility, checkCompatibility, type McVersion, type CompatibilityStatus, type CompatibilityCheckResult, } from './compatibility-checker.js';
+export { checkDependency, checkAllDependencies, calculateDependencyScore, getDependencyDescription, checkDependencyHealth, generateDependencyIssues, createSimpleDependencyRegistry, type DependencyStatus, type DependencyCheckItem, type DependencyCheckResult, type DependencyRegistry, } from './dependency-checker.js';
+export { calculateSecurityScore, getSecurityStatus, getSecurityDescription, checkFixAvailable, checkSecurityHealth, checkSecurity, generateSecurityIssues, createMockVulnerability, filterVulnerabilitiesForVersion, type SecurityStatus, type SecurityCheckResult, } from './security-checker.js';
+export { HealthCalculator, createHealthCalculator, } from './health-calculator.js';
+export type { ConflictType, CompatibilityStatus as MatrixCompatibilityStatus, PluginConflict, CompatibilityEntry, CompatibilityMatrix, CompatibilityMatrixSummary, DependencyNode, DependencyGraph, ConflictResolution, CompatibilityReport, KnownConflictEntry, CompatibilityCheckConfig, } from './compatibility-types.js';
+export { DEFAULT_COMPATIBILITY_CONFIG } from './compatibility-types.js';
+export { getMatrixKey, detectCommandConflicts, detectPermissionConflicts, detectApiConflicts, detectVersionMismatch, checkKnownConflicts, calculateCompatibilityScore as calculateMatrixCompatibilityScore, getCompatibilityStatus as getMatrixCompatibilityStatus, buildCompatibilityEntry, buildCompatibilityMatrix, getCompatibilityEntry, getPluginConflicts, generateMatrixSummary, buildDependencyGraph, generateResolutions, assessRiskLevel, type PluginCompatInfo, } from './compatibility-matrix.js';
+export type { AlertConditionType, AlertOperator, AlertChannel, AlertSeverity, AlertCondition, AlertRule, Alert, AlertHistoryEntry, AlertEngineState, AlertCheckResult, WebhookAlertPayload, AlertConfig, } from './alert-types.js';
+export { DEFAULT_ALERT_RULES, DEFAULT_ALERT_CONFIG } from './alert-types.js';
+export { HealthAlertEngine, createAlertEngine, evaluateCondition, getConditionValue, isOnCooldown, evaluateRule, shouldResolveAlert, type PluginAlertData, } from './alert-engine.js';
+export { analyzePluginUpgrade, analyzeUpgrade, calculateRiskLevel, generateRiskFactors, generateRecommendedSteps, estimateUpgradeEffort, getRecommendedTargetVersion, type PluginUpgradeStatus, type PluginUpgradeInfo, type UpgradeRiskLevel, type UpgradeAnalysis, } from './upgrade-assistant.js';
+export { HealthHistoryService, createHealthHistoryService, calculateTrend, getPeriodMs, generateSparkline, DEFAULT_HISTORY_CONFIG, type TrendPeriod, type PluginHealthHistoryEntry, type ServerHealthHistoryEntry, type HealthTrend, type HealthEvent, type HealthHistory, type HealthHistoryConfig, } from './health-history.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/health/index.d.ts.map

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

package/dist/core/health/maintenance-checker.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Maintenance Activity Checker
+ *
+ * Evaluates how actively a plugin is being maintained based on update frequency.
+ *
+ * @since v1.66.0
+ */
+import { type HealthCheckConfig, type HealthComponent } from './health-types.js';
+/**
+ * Maintenance status categories
+ */
+export type MaintenanceStatus = 'active' | 'maintained' | 'slow' | 'infrequent' | 'stale' | 'abandoned' | 'unknown';
+/**
+ * Maintenance check result
+ */
+export interface MaintenanceCheckResult {
+    /** Last update timestamp (ms) */
+    lastUpdateAt: number | null;
+    /** Days since last update */
+    daysSinceUpdate: number | null;
+    /** Maintenance status category */
+    status: MaintenanceStatus;
+    /** Score (0-100) */
+    score: number;
+    /** Human-readable description */
+    description: string;
+}
+/**
+ * Calculate days since a timestamp
+ */
+export declare function daysSince(timestamp: number): number;
+/**
+ * Determine maintenance status from days since update
+ */
+export declare function getMaintenanceStatus(daysSinceUpdate: number | null): MaintenanceStatus;
+/**
+ * Calculate maintenance score based on days since update
+ */
+export declare function calculateMaintenanceScore(lastUpdateAt: number | null, config?: HealthCheckConfig['maintenanceScoring']): number;
+/**
+ * Get maintenance status description
+ */
+export declare function getMaintenanceDescription(lastUpdateAt: number | null, status: MaintenanceStatus): string;
+/**
+ * Check maintenance activity and return health component
+ */
+export declare function checkMaintenanceActivity(lastUpdateAt: number | null, config?: HealthCheckConfig['maintenanceScoring']): HealthComponent;
+/**
+ * Full maintenance check result
+ */
+export declare function checkMaintenance(lastUpdateAt: number | null, config?: HealthCheckConfig['maintenanceScoring']): MaintenanceCheckResult;
+/**
+ * Determine if a plugin should be flagged for abandonment risk
+ */
+export declare function isAbandonmentRisk(lastUpdateAt: number | null): boolean;
+/**
+ * Get friendly time since update string
+ */
+export declare function getTimeSinceUpdate(lastUpdateAt: number | null): string;
+//# sourceMappingURL=maintenance-checker.d.ts.map

package/dist/core/health/maintenance-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-checker.d.ts","sourceRoot":"","sources":["../../../src/core/health/maintenance-checker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAyB,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKxG;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,OAAO,GACP,WAAW,GACX,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6BAA6B;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kCAAkC;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAqBtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,GAAE,iBAAiB,CAAC,oBAAoB,CAA4C,GAAG,MAAM,CAwBzK;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAuBxG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,GAAE,iBAAiB,CAAC,oBAAoB,CAA4C,GAAG,eAAe,CAsBjL;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,GAAE,iBAAiB,CAAC,oBAAoB,CAA4C,GAAG,sBAAsB,CAahL;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAMtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CA0BtE"}

package/dist/core/health/security-checker.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Security Vulnerability Checker
+ *
+ * Evaluates plugins for known security vulnerabilities.
+ *
+ * @since v1.66.0
+ */
+import { type HealthComponent, type HealthIssue, type SecurityVulnerability } from './health-types.js';
+/**
+ * Security status
+ */
+export type SecurityStatus = 'secure' | 'low_risk' | 'medium_risk' | 'high_risk' | 'critical_risk' | 'unknown';
+/**
+ * Security check result
+ */
+export interface SecurityCheckResult {
+    /** Security status */
+    status: SecurityStatus;
+    /** Score (0-100) */
+    score: number;
+    /** Human-readable description */
+    description: string;
+    /** List of vulnerabilities */
+    vulnerabilities: SecurityVulnerability[];
+    /** Whether a fix is available for vulnerabilities */
+    fixAvailable: boolean;
+    /** Version that fixes vulnerabilities (if any) */
+    fixVersion?: string;
+}
+/**
+ * Calculate security score based on vulnerabilities
+ */
+export declare function calculateSecurityScore(vulnerabilities: SecurityVulnerability[]): number;
+/**
+ * Determine security status from vulnerabilities
+ */
+export declare function getSecurityStatus(vulnerabilities: SecurityVulnerability[]): SecurityStatus;
+/**
+ * Get security description
+ */
+export declare function getSecurityDescription(status: SecurityStatus, vulnerabilities: SecurityVulnerability[], fixAvailable: boolean): string;
+/**
+ * Check if a fix is available
+ */
+export declare function checkFixAvailable(vulnerabilities: SecurityVulnerability[], currentVersion: string): {
+    available: boolean;
+    fixVersion?: string;
+};
+/**
+ * Check security and return health component
+ */
+export declare function checkSecurityHealth(vulnerabilities: SecurityVulnerability[], currentVersion: string): HealthComponent;
+/**
+ * Full security check
+ */
+export declare function checkSecurity(vulnerabilities: SecurityVulnerability[], currentVersion: string): SecurityCheckResult;
+/**
+ * Generate health issues from security vulnerabilities
+ */
+export declare function generateSecurityIssues(vulnerabilities: SecurityVulnerability[], pluginName: string): HealthIssue[];
+/**
+ * Create a mock vulnerability for testing
+ */
+export declare function createMockVulnerability(id: string, severity: SecurityVulnerability['severity'], description: string, fixedInVersion?: string): SecurityVulnerability;
+/**
+ * Filter vulnerabilities that affect a specific version
+ */
+export declare function filterVulnerabilitiesForVersion(vulnerabilities: SecurityVulnerability[], currentVersion: string): SecurityVulnerability[];
+//# sourceMappingURL=security-checker.d.ts.map

package/dist/core/health/security-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-checker.d.ts","sourceRoot":"","sources":["../../../src/core/health/security-checker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAyB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE9H;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,UAAU,GACV,aAAa,GACb,WAAW,GACX,eAAe,GACf,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAC;IACtB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAcvF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,qBAAqB,EAAE,GAAG,cAAc,CAsB1F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,qBAAqB,EAAE,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CAetI;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,qBAAqB,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAoB/I;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,qBAAqB,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,eAAe,CAsBrH;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,eAAe,EAAE,qBAAqB,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,mBAAmB,CAcnH;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,qBAAqB,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE,CA6BlH;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,qBAAqB,CASpK;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,eAAe,EAAE,qBAAqB,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAWzI"}

package/dist/core/health/upgrade-assistant.d.ts

@@ -0,0 +1,114 @@
+/**
+ * MC Version Upgrade Assistant
+ *
+ * Helps users safely upgrade their Minecraft server version by
+ * analyzing plugin compatibility and providing a migration plan.
+ *
+ * @since v1.66.0
+ */
+import { type CompatibilityStatus, type McVersion } from './compatibility-checker.js';
+import type { PluginHealthMetadata } from './health-types.js';
+/**
+ * Plugin upgrade status
+ */
+export type PluginUpgradeStatus = 'ready' | 'update_required' | 'uncertain' | 'incompatible';
+/**
+ * Plugin upgrade info
+ */
+export interface PluginUpgradeInfo {
+    /** Plugin name */
+    pluginName: string;
+    /** Plugin ID */
+    pluginId: string;
+    /** Current version */
+    currentVersion: string;
+    /** Upgrade status */
+    status: PluginUpgradeStatus;
+    /** Current MC compatibility */
+    currentCompatibility: CompatibilityStatus;
+    /** Target MC compatibility */
+    targetCompatibility: CompatibilityStatus;
+    /** Required update version (if update_required) */
+    requiredVersion?: string;
+    /** Reason for status */
+    reason: string;
+    /** Last update date */
+    lastUpdated?: number;
+    /** Days since last update */
+    daysSinceUpdate?: number;
+}
+/**
+ * Upgrade risk level
+ */
+export type UpgradeRiskLevel = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Upgrade analysis result
+ */
+export interface UpgradeAnalysis {
+    /** Current MC version */
+    currentVersion: string;
+    /** Target MC version */
+    targetVersion: string;
+    /** Parsed current version */
+    parsedCurrent: McVersion | null;
+    /** Parsed target version */
+    parsedTarget: McVersion | null;
+    /** Whether upgrade is possible */
+    canUpgrade: boolean;
+    /** Upgrade risk level */
+    riskLevel: UpgradeRiskLevel;
+    /** Risk factors */
+    riskFactors: string[];
+    /** Plugins by status */
+    byStatus: {
+        ready: PluginUpgradeInfo[];
+        updateRequired: PluginUpgradeInfo[];
+        uncertain: PluginUpgradeInfo[];
+        incompatible: PluginUpgradeInfo[];
+    };
+    /** Total plugins */
+    totalPlugins: number;
+    /** Summary stats */
+    stats: {
+        readyCount: number;
+        updateRequiredCount: number;
+        uncertainCount: number;
+        incompatibleCount: number;
+        readyPercentage: number;
+    };
+    /** Recommended steps */
+    recommendedSteps: string[];
+    /** Estimated upgrade effort */
+    estimatedEffort: 'low' | 'medium' | 'high';
+    /** Analysis timestamp */
+    analyzedAt: number;
+}
+/**
+ * Analyze a single plugin for MC version upgrade
+ */
+export declare function analyzePluginUpgrade(plugin: PluginHealthMetadata, currentMcVersion: string, targetMcVersion: string): PluginUpgradeInfo;
+/**
+ * Calculate upgrade risk level
+ */
+export declare function calculateRiskLevel(stats: UpgradeAnalysis['stats'], incompatibleCount: number): UpgradeRiskLevel;
+/**
+ * Generate risk factors
+ */
+export declare function generateRiskFactors(analysis: Pick<UpgradeAnalysis, 'byStatus' | 'stats'>): string[];
+/**
+ * Generate recommended upgrade steps
+ */
+export declare function generateRecommendedSteps(analysis: Pick<UpgradeAnalysis, 'byStatus' | 'stats' | 'riskLevel' | 'targetVersion'>): string[];
+/**
+ * Estimate upgrade effort
+ */
+export declare function estimateUpgradeEffort(stats: UpgradeAnalysis['stats']): 'low' | 'medium' | 'high';
+/**
+ * Analyze MC version upgrade for a set of plugins
+ */
+export declare function analyzeUpgrade(plugins: PluginHealthMetadata[], currentMcVersion: string, targetMcVersion: string): UpgradeAnalysis;
+/**
+ * Get next recommended MC version to upgrade to
+ */
+export declare function getRecommendedTargetVersion(currentVersion: string): string[];
+//# sourceMappingURL=upgrade-assistant.d.ts.map

package/dist/core/health/upgrade-assistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-assistant.d.ts","sourceRoot":"","sources":["../../../src/core/health/upgrade-assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAA6D,MAAM,4BAA4B,CAAC;AACjJ,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,iBAAiB,GACjB,WAAW,GACX,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,+BAA+B;IAC/B,oBAAoB,EAAE,mBAAmB,CAAC;IAC1C,8BAA8B;IAC9B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,4BAA4B;IAC5B,YAAY,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,kCAAkC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,mBAAmB;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wBAAwB;IACxB,QAAQ,EAAE;QACR,KAAK,EAAE,iBAAiB,EAAE,CAAC;QAC3B,cAAc,EAAE,iBAAiB,EAAE,CAAC;QACpC,SAAS,EAAE,iBAAiB,EAAE,CAAC;QAC/B,YAAY,EAAE,iBAAiB,EAAE,CAAC;KACnC,CAAC;IACF,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+BAA+B;IAC/B,eAAe,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,iBAAiB,CA6DvI;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,EAAE,MAAM,GAAG,gBAAgB,CAgB/G;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,MAAM,EAAE,CAsBnG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,eAAe,CAAC,GAAG,MAAM,EAAE,CAwCxI;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAMhG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,eAAe,CA4ElI;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAoB5E"}

package/dist/core/health/version-checker.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Version Freshness Checker
+ *
+ * Evaluates how current a plugin version is compared to the latest available.
+ *
+ * @since v1.66.0
+ */
+import { type HealthCheckConfig, type HealthComponent } from './health-types.js';
+/**
+ * Version comparison result
+ */
+export interface VersionComparisonResult {
+    /** Current version string */
+    current: string;
+    /** Latest version string */
+    latest: string;
+    /** Number of major versions behind */
+    majorsBehind: number;
+    /** Number of minor versions behind */
+    minorsBehind: number;
+    /** Number of patch versions behind */
+    patchesBehind: number;
+    /** Whether the plugin is on the latest version */
+    isLatest: boolean;
+    /** Whether an update is available */
+    updateAvailable: boolean;
+}
+/**
+ * Compare two versions and determine how far behind the current is
+ */
+export declare function comparePluginVersions(current: string, latest: string): VersionComparisonResult;
+/**
+ * Calculate version freshness score
+ */
+export declare function calculateVersionScore(current: string, latest: string | undefined, config?: HealthCheckConfig['versionScoring']): number;
+/**
+ * Get version status description
+ */
+export declare function getVersionStatusDescription(current: string, latest: string | undefined): string;
+/**
+ * Check version freshness and return health component
+ */
+export declare function checkVersionFreshness(currentVersion: string, latestVersion: string | undefined, config?: HealthCheckConfig['versionScoring']): HealthComponent;
+/**
+ * Determine if a version update is a breaking change (major version bump)
+ */
+export declare function isBreakingUpdate(current: string, latest: string): boolean;
+/**
+ * Get recommended update action based on version difference
+ */
+export declare function getUpdateRecommendation(current: string, latest: string): 'none' | 'patch' | 'minor' | 'major' | 'critical';
+//# sourceMappingURL=version-checker.d.ts.map

package/dist/core/health/version-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-checker.d.ts","sourceRoot":"","sources":["../../../src/core/health/version-checker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAyB,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAExG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAyC9F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAE,iBAAiB,CAAC,gBAAgB,CAAwC,GAAG,MAAM,CA+B7K;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CA4B/F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,GAAE,iBAAiB,CAAC,gBAAgB,CAAwC,GAAG,eAAe,CAoBpM;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGzE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAgB1H"}