@nindroidsystems/pluginator 2.3.0

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

@@ -0,0 +1,231 @@
+/**
+ * Compatibility Matrix Types
+ *
+ * Type definitions for plugin-to-plugin compatibility tracking.
+ *
+ * @since v1.66.0
+ */
+/**
+ * Types of plugin conflicts
+ */
+export type ConflictType = 'api_conflict' | 'event_conflict' | 'command_conflict' | 'permission_conflict' | 'resource_conflict' | 'version_mismatch' | 'load_order' | 'incompatible';
+/**
+ * Compatibility status between two plugins
+ */
+export type CompatibilityStatus = 'compatible' | 'potential_issues' | 'known_conflict' | 'requires_config' | 'unknown';
+/**
+ * Plugin-to-plugin conflict definition
+ */
+export interface PluginConflict {
+    /** Unique conflict ID */
+    id: string;
+    /** Type of conflict */
+    type: ConflictType;
+    /** First plugin involved */
+    pluginA: string;
+    /** Second plugin involved */
+    pluginB: string;
+    /** Conflict severity */
+    severity: 'critical' | 'warning' | 'info';
+    /** Human-readable description */
+    description: string;
+    /** Specific features affected */
+    affectedFeatures?: string[];
+    /** Version ranges where conflict occurs */
+    affectedVersions?: {
+        pluginA?: string;
+        pluginB?: string;
+    };
+    /** Workaround if any */
+    workaround?: string;
+    /** Resolution steps */
+    resolution?: string;
+    /** Data source */
+    source: 'database' | 'analysis' | 'user_report';
+    /** When the conflict was reported/detected */
+    reportedAt: number;
+}
+/**
+ * Compatibility matrix entry
+ */
+export interface CompatibilityEntry {
+    /** First plugin */
+    pluginA: string;
+    /** Second plugin */
+    pluginB: string;
+    /** Overall compatibility status */
+    status: CompatibilityStatus;
+    /** Compatibility score (0-100, 100 = fully compatible) */
+    score: number;
+    /** Conflicts between these plugins */
+    conflicts: PluginConflict[];
+    /** Notes about the compatibility */
+    notes?: string;
+    /** Last updated timestamp */
+    lastUpdated: number;
+}
+/**
+ * Full compatibility matrix
+ */
+export interface CompatibilityMatrix {
+    /** Matrix entries indexed by "pluginA:pluginB" */
+    entries: Map<string, CompatibilityEntry>;
+    /** All known plugins in the matrix */
+    plugins: string[];
+    /** When the matrix was generated */
+    generatedAt: number;
+    /** Total number of entries */
+    totalEntries: number;
+    /** Number of known conflicts */
+    conflictCount: number;
+}
+/**
+ * Compatibility matrix summary
+ */
+export interface CompatibilityMatrixSummary {
+    /** Total plugins analyzed */
+    totalPlugins: number;
+    /** Total compatibility entries */
+    totalEntries: number;
+    /** Count by status */
+    byStatus: Record<CompatibilityStatus, number>;
+    /** All active conflicts */
+    conflicts: PluginConflict[];
+    /** Plugins with most conflicts */
+    problematicPlugins: Array<{
+        plugin: string;
+        conflictCount: number;
+        severityBreakdown: Record<'critical' | 'warning' | 'info', number>;
+    }>;
+    /** Overall compatibility score */
+    overallScore: number;
+    /** When generated */
+    generatedAt: number;
+}
+/**
+ * Dependency graph node
+ */
+export interface DependencyNode {
+    /** Plugin name */
+    plugin: string;
+    /** Hard dependencies */
+    hardDeps: string[];
+    /** Soft dependencies */
+    softDeps: string[];
+    /** Plugins that depend on this one */
+    dependents: string[];
+    /** Health score of this plugin */
+    healthScore?: number;
+    /** Whether this plugin is installed */
+    installed: boolean;
+}
+/**
+ * Dependency graph representing all plugin relationships
+ */
+export interface DependencyGraph {
+    /** All nodes in the graph */
+    nodes: Map<string, DependencyNode>;
+    /** Detected circular dependencies */
+    cycles: string[][];
+    /** Missing dependencies */
+    missing: Array<{
+        plugin: string;
+        requiredBy: string[];
+        type: 'hard' | 'soft';
+    }>;
+    /** Total plugins */
+    totalPlugins: number;
+    /** Total edges (dependencies) */
+    totalEdges: number;
+}
+/**
+ * Conflict resolution suggestion
+ */
+export interface ConflictResolution {
+    /** Conflict being resolved */
+    conflictId: string;
+    /** Suggested resolution approach */
+    approach: 'update' | 'configure' | 'replace' | 'remove' | 'load_order';
+    /** Detailed steps */
+    steps: string[];
+    /** Estimated effort */
+    effort: 'low' | 'medium' | 'high';
+    /** Success likelihood */
+    successLikelihood: 'high' | 'medium' | 'low';
+    /** Whether this can be automated */
+    automatable: boolean;
+    /** Automation action if applicable */
+    automationAction?: string;
+}
+/**
+ * Compatibility report for a set of plugins
+ */
+export interface CompatibilityReport {
+    /** Server or configuration name */
+    name: string;
+    /** Plugins analyzed */
+    plugins: string[];
+    /** Compatibility matrix */
+    matrix: CompatibilityMatrix;
+    /** Matrix summary */
+    summary: CompatibilityMatrixSummary;
+    /** Dependency graph */
+    dependencyGraph: DependencyGraph;
+    /** Suggested resolutions for conflicts */
+    resolutions: ConflictResolution[];
+    /** Overall risk assessment */
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    /** Risk factors */
+    riskFactors: string[];
+    /** Recommendations */
+    recommendations: string[];
+    /** Report generation time */
+    generatedAt: number;
+}
+/**
+ * Known conflict database entry
+ */
+export interface KnownConflictEntry {
+    /** Plugins involved (can be 2+) */
+    plugins: string[];
+    /** Conflict type */
+    type: ConflictType;
+    /** Severity */
+    severity: 'critical' | 'warning' | 'info';
+    /** Description */
+    description: string;
+    /** Affected versions */
+    affectedVersions?: Record<string, string>;
+    /** Workaround */
+    workaround?: string;
+    /** Fixed in versions */
+    fixedInVersions?: Record<string, string>;
+    /** Reference URL */
+    referenceUrl?: string;
+    /** When this was added to the database */
+    addedAt: number;
+    /** Last verified */
+    lastVerified?: number;
+}
+/**
+ * Configuration for compatibility checking
+ */
+export interface CompatibilityCheckConfig {
+    /** Include analysis-based detection */
+    analyzeApis: boolean;
+    /** Include command conflict detection */
+    analyzeCommands: boolean;
+    /** Include permission conflict detection */
+    analyzePermissions: boolean;
+    /** Check load order requirements */
+    checkLoadOrder: boolean;
+    /** Include user-reported conflicts */
+    includeUserReports: boolean;
+    /** Minimum confidence for analysis results */
+    minConfidence: number;
+}
+/**
+ * Default compatibility check configuration
+ */
+export declare const DEFAULT_COMPATIBILITY_CONFIG: CompatibilityCheckConfig;
+//# sourceMappingURL=compatibility-types.d.ts.map

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

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

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

@@ -0,0 +1,84 @@
+/**
+ * Dependency Health Checker
+ *
+ * Evaluates the health of a plugin's dependencies.
+ *
+ * @since v1.66.0
+ */
+import { type HealthComponent, type HealthIssue } from './health-types.js';
+/**
+ * Dependency status
+ */
+export type DependencyStatus = 'satisfied' | 'missing_required' | 'missing_optional' | 'unhealthy' | 'conflicting' | 'unknown';
+/**
+ * Single dependency check result
+ */
+export interface DependencyCheckItem {
+    /** Dependency plugin name */
+    name: string;
+    /** Whether it's a hard or soft dependency */
+    type: 'hard' | 'soft';
+    /** Whether the dependency is present */
+    present: boolean;
+    /** Health score of the dependency (if present) */
+    healthScore?: number;
+    /** Issues with this dependency */
+    issues: string[];
+}
+/**
+ * Dependency check result
+ */
+export interface DependencyCheckResult {
+    /** All required (hard) dependencies */
+    required: DependencyCheckItem[];
+    /** All optional (soft) dependencies */
+    optional: DependencyCheckItem[];
+    /** Overall dependency status */
+    status: DependencyStatus;
+    /** Score (0-100) */
+    score: number;
+    /** Human-readable description */
+    description: string;
+    /** Missing required dependencies */
+    missingRequired: string[];
+    /** Missing optional dependencies */
+    missingOptional: string[];
+}
+/**
+ * Plugin registry for checking dependency presence
+ */
+export interface DependencyRegistry {
+    /** Check if a plugin is installed */
+    isInstalled: (name: string) => boolean;
+    /** Get the health score of an installed plugin (optional) */
+    getHealthScore?: (name: string) => number | undefined;
+}
+/**
+ * Check if a dependency is satisfied
+ */
+export declare function checkDependency(name: string, type: 'hard' | 'soft', registry: DependencyRegistry): DependencyCheckItem;
+/**
+ * Check all dependencies for a plugin
+ */
+export declare function checkAllDependencies(hardDependencies: string[], softDependencies: string[], registry: DependencyRegistry): DependencyCheckResult;
+/**
+ * Calculate dependency score
+ */
+export declare function calculateDependencyScore(required: DependencyCheckItem[], optional: DependencyCheckItem[], missingRequired: string[], missingOptional: string[], unhealthyCount: number): number;
+/**
+ * Get dependency status description
+ */
+export declare function getDependencyDescription(status: DependencyStatus, missingRequired: string[], missingOptional: string[], unhealthyDeps: string[]): string;
+/**
+ * Check dependencies and return health component
+ */
+export declare function checkDependencyHealth(hardDependencies: string[], softDependencies: string[], registry: DependencyRegistry): HealthComponent;
+/**
+ * Generate health issues for dependency problems
+ */
+export declare function generateDependencyIssues(result: DependencyCheckResult, pluginName: string): HealthIssue[];
+/**
+ * Create a simple dependency registry from a list of installed plugins
+ */
+export declare function createSimpleDependencyRegistry(installedPlugins: string[], healthScores?: Record<string, number>): DependencyRegistry;
+//# sourceMappingURL=dependency-checker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-checker.d.ts","sourceRoot":"","sources":["../../../src/core/health/dependency-checker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAyB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAElG;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,kBAAkB,GAClB,kBAAkB,GAClB,WAAW,GACX,aAAa,GACb,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,uCAAuC;IACvC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,mBAAmB,CAsBtH;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,kBAAkB,GAAG,qBAAqB,CAyChJ;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,EAAE,QAAQ,EAAE,mBAAmB,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAc/L;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,CAexJ;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,kBAAkB,GAAG,eAAe,CAmB3I;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE,CAsDzG;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,kBAAkB,CAOpI"}

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

@@ -0,0 +1,52 @@
+/**
+ * Health Calculator Service
+ *
+ * Calculates comprehensive health scores for plugins by combining
+ * all component checkers.
+ *
+ * @since v1.66.0
+ */
+import { type BatchHealthCheckResult, type HealthCheckConfig, type PluginHealthMetadata, type PluginHealthScore } from './health-types.js';
+import { type DependencyRegistry } from './dependency-checker.js';
+/**
+ * Health Calculator Service
+ */
+export declare class HealthCalculator {
+    private config;
+    private serverMcVersion;
+    private dependencyRegistry;
+    constructor(serverMcVersion: string, dependencyRegistry: DependencyRegistry, config?: HealthCheckConfig);
+    /**
+     * Calculate health score for a single plugin
+     */
+    calculateHealthScore(metadata: PluginHealthMetadata): PluginHealthScore;
+    /**
+     * Calculate weighted overall score
+     */
+    private calculateOverallScore;
+    /**
+     * Calculate grade from score
+     */
+    private calculateGrade;
+    /**
+     * Collect all issues from components
+     */
+    private collectIssues;
+    /**
+     * Generate improvement recommendations
+     */
+    private generateRecommendations;
+    /**
+     * Calculate health scores for multiple plugins
+     */
+    calculateBatchHealthScores(plugins: PluginHealthMetadata[]): BatchHealthCheckResult;
+    /**
+     * Calculate server-wide health summary
+     */
+    private calculateServerSummary;
+}
+/**
+ * Create a health calculator instance
+ */
+export declare function createHealthCalculator(serverMcVersion: string, dependencyRegistry: DependencyRegistry, config?: HealthCheckConfig): HealthCalculator;
+//# sourceMappingURL=health-calculator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health-calculator.d.ts","sourceRoot":"","sources":["../../../src/core/health/health-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EAMtB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,KAAK,kBAAkB,EAAyE,MAAM,yBAAyB,CAAC;AAKzI;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,eAAe,EAAE,MAAM,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,GAAE,iBAAyC;IAM9H;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,iBAAiB;IAwDvE;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4ErB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiD/B;;OAEG;IACH,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,sBAAsB;IAkCnF;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAmE/B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAEpJ"}

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

@@ -0,0 +1,228 @@
+/**
+ * Health History & Trends Service
+ *
+ * Tracks health scores over time and calculates trends.
+ *
+ * @since v1.66.0
+ */
+import type { HealthGrade, PluginHealthScore, ServerHealthSummary } from './health-types.js';
+/**
+ * Time periods for trend calculation
+ */
+export type TrendPeriod = '24h' | '7d' | '30d' | '90d';
+/**
+ * Health history entry for a single plugin
+ */
+export interface PluginHealthHistoryEntry {
+    /** Plugin ID */
+    pluginId: string;
+    /** Overall score at this point */
+    score: number;
+    /** Grade at this point */
+    grade: HealthGrade;
+    /** Component scores */
+    components: {
+        version: number;
+        compatibility: number;
+        maintenance: number;
+        dependencies: number;
+        security: number;
+    };
+    /** Number of issues */
+    issueCount: number;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Server-wide health history entry
+ */
+export interface ServerHealthHistoryEntry {
+    /** Overall server score */
+    score: number;
+    /** Server grade */
+    grade: HealthGrade;
+    /** Total plugins */
+    totalPlugins: number;
+    /** Count by status */
+    byStatus: {
+        healthy: number;
+        warning: number;
+        outdated: number;
+        critical: number;
+    };
+    /** Total critical issues */
+    criticalIssueCount: number;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Health trend information
+ */
+export interface HealthTrend {
+    /** Current score */
+    currentScore: number;
+    /** Score at start of period */
+    startScore: number;
+    /** Score change */
+    change: number;
+    /** Percentage change */
+    changePercent: number;
+    /** Trend direction */
+    direction: 'improving' | 'declining' | 'stable';
+    /** Period analyzed */
+    period: TrendPeriod;
+    /** Sparkline data (normalized 0-1) */
+    sparkline: number[];
+    /** Number of data points */
+    dataPoints: number;
+}
+/**
+ * Health event (significant change)
+ */
+export interface HealthEvent {
+    /** Event ID */
+    id: string;
+    /** Event type */
+    type: 'score_change' | 'issue_detected' | 'issue_resolved' | 'plugin_added' | 'plugin_removed' | 'update_applied';
+    /** Plugin ID (if applicable) */
+    pluginId?: string;
+    /** Plugin name */
+    pluginName?: string;
+    /** Description */
+    description: string;
+    /** Score impact */
+    scoreImpact?: number;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Complete health history
+ */
+export interface HealthHistory {
+    /** Plugin histories */
+    plugins: Map<string, PluginHealthHistoryEntry[]>;
+    /** Server history */
+    server: ServerHealthHistoryEntry[];
+    /** Events */
+    events: HealthEvent[];
+    /** When history was last updated */
+    lastUpdated: number;
+}
+/**
+ * Health history configuration
+ */
+export interface HealthHistoryConfig {
+    /** Maximum history duration in days */
+    maxHistoryDays: number;
+    /** Sample interval in hours */
+    sampleIntervalHours: number;
+    /** Maximum samples to keep */
+    maxSamples: number;
+    /** Significant change threshold (for events) */
+    significantChangeThreshold: number;
+}
+/**
+ * Default history configuration
+ */
+export declare const DEFAULT_HISTORY_CONFIG: HealthHistoryConfig;
+/**
+ * Get milliseconds for a period
+ */
+export declare function getPeriodMs(period: TrendPeriod): number;
+/**
+ * Calculate trend from history entries
+ */
+export declare function calculateTrend(entries: Array<{
+    score: number;
+    timestamp: number;
+}>, period: TrendPeriod): HealthTrend;
+/**
+ * Health History Service
+ */
+export declare class HealthHistoryService {
+    private history;
+    private config;
+    constructor(config?: HealthHistoryConfig);
+    /**
+     * Get current configuration
+     */
+    getConfig(): HealthHistoryConfig;
+    /**
+     * Record plugin health scores
+     */
+    recordPluginScores(scores: PluginHealthScore[]): void;
+    /**
+     * Record server health summary
+     */
+    recordServerSummary(summary: ServerHealthSummary): void;
+    /**
+     * Add a health event
+     */
+    addEvent(event: HealthEvent): void;
+    /**
+     * Get plugin health trend
+     */
+    getPluginTrend(pluginId: string, period?: TrendPeriod): HealthTrend | null;
+    /**
+     * Get server health trend
+     */
+    getServerTrend(period?: TrendPeriod): HealthTrend;
+    /**
+     * Get plugin history
+     */
+    getPluginHistory(pluginId: string, period?: TrendPeriod): PluginHealthHistoryEntry[];
+    /**
+     * Get server history
+     */
+    getServerHistory(period?: TrendPeriod): ServerHealthHistoryEntry[];
+    /**
+     * Get recent events
+     */
+    getEvents(limit?: number, period?: TrendPeriod): HealthEvent[];
+    /**
+     * Get plugin events
+     */
+    getPluginEvents(pluginId: string, limit?: number): HealthEvent[];
+    /**
+     * Get all plugins with trends
+     */
+    getAllPluginTrends(period?: TrendPeriod): Map<string, HealthTrend>;
+    /**
+     * Get plugins with declining health
+     */
+    getDecliningPlugins(period?: TrendPeriod, threshold?: number): string[];
+    /**
+     * Get plugins with improving health
+     */
+    getImprovingPlugins(period?: TrendPeriod, threshold?: number): string[];
+    /**
+     * Prune old history entries
+     */
+    private pruneHistory;
+    /**
+     * Export history for persistence
+     */
+    exportHistory(): {
+        plugins: Array<[string, PluginHealthHistoryEntry[]]>;
+        server: ServerHealthHistoryEntry[];
+        events: HealthEvent[];
+        lastUpdated: number;
+    };
+    /**
+     * Import history from persistence
+     */
+    importHistory(data: ReturnType<HealthHistoryService['exportHistory']>): void;
+    /**
+     * Clear all history
+     */
+    clearHistory(): void;
+}
+/**
+ * Create a health history service instance
+ */
+export declare function createHealthHistoryService(config?: HealthHistoryConfig): HealthHistoryService;
+/**
+ * Generate ASCII sparkline from data
+ */
+export declare function generateSparkline(data: number[], width?: number): string;
+//# sourceMappingURL=health-history.d.ts.map

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

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