@nindroidsystems/pluginator 2.3.0

package/dist/core/recommendations/comparison/comparison-types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Plugin Comparison Types
+ *
+ * Type definitions for plugin comparison functionality.
+ *
+ * @since v1.66.3
+ */
+import type { RegistryPlugin } from '../../registry/registry-types.js';
+/**
+ * Feature support level
+ */
+export type FeatureSupport = 'full' | 'partial' | 'none' | 'unknown';
+/**
+ * A feature comparison entry
+ */
+export interface FeatureComparison {
+    /** Feature name */
+    name: string;
+    /** Category of the feature */
+    category: string;
+    /** Support level for each plugin (by plugin ID) */
+    support: Map<string, FeatureSupport>;
+    /** Description of the feature */
+    description?: string;
+}
+/**
+ * Statistics for comparison
+ */
+export interface ComparisonStats {
+    /** Plugin ID */
+    pluginId: string;
+    /** Total downloads */
+    downloads: number;
+    /** Average rating (0-5) */
+    rating: number;
+    /** Days since last update */
+    daysSinceUpdate: number;
+    /** Minecraft version range */
+    mcVersionRange: string;
+    /** Is plugin free */
+    isFree: boolean;
+    /** Price if premium */
+    price?: string;
+    /** Number of commands/features */
+    featureCount?: number;
+}
+/**
+ * Migration recommendation
+ */
+export interface MigrationGuide {
+    /** Source plugin ID */
+    fromPlugin: string;
+    /** Target plugin ID */
+    toPlugin: string;
+    /** Difficulty level */
+    difficulty: 'easy' | 'medium' | 'hard';
+    /** Migration steps */
+    steps: string[];
+    /** What you gain */
+    benefits: string[];
+    /** What you lose */
+    tradeoffs: string[];
+    /** Estimated time */
+    estimatedTime?: string;
+}
+/**
+ * Full comparison result
+ */
+export interface ComparisonResult {
+    /** Plugins being compared */
+    plugins: RegistryPlugin[];
+    /** Statistics for each plugin */
+    stats: ComparisonStats[];
+    /** Feature comparison matrix */
+    features: FeatureComparison[];
+    /** Migration guides if applicable */
+    migrationGuides: MigrationGuide[];
+    /** Winner in each category */
+    winners: {
+        category: string;
+        winnerId: string;
+        reason: string;
+    }[];
+    /** Overall recommendation */
+    recommendation?: {
+        pluginId: string;
+        reason: string;
+    };
+    /** Generated timestamp */
+    generatedAt: number;
+}
+/**
+ * Common features to compare
+ */
+export declare const COMMON_FEATURE_CATEGORIES: Record<string, string[]>;
+/**
+ * Known plugin features (curated data)
+ */
+export declare const KNOWN_PLUGIN_FEATURES: Record<string, Record<string, FeatureSupport>>;
+/**
+ * Default comparison config
+ */
+export declare const DEFAULT_COMPARISON_CONFIG: {
+    maxPlugins: number;
+    showUnknownFeatures: boolean;
+    showMigrationGuides: boolean;
+    showWinners: boolean;
+};
+//# sourceMappingURL=comparison-types.d.ts.map

package/dist/core/recommendations/comparison/comparison-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-types.d.ts","sourceRoot":"","sources":["../../../../src/core/recommendations/comparison/comparison-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,sBAAsB;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,iCAAiC;IACjC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,gCAAgC;IAChC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,qCAAqC;IACrC,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,8BAA8B;IAC9B,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,EAAE,CAAC;IACJ,6BAA6B;IAC7B,cAAc,CAAC,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAO9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAkEhF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;CAKrC,CAAC"}

package/dist/core/recommendations/comparison/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Plugin Comparison Module
+ *
+ * Plugin comparison and migration guide functionality.
+ *
+ * @since v1.66.3
+ */
+export type { FeatureSupport, FeatureComparison, ComparisonStats, MigrationGuide, ComparisonResult, } from './comparison-types.js';
+export { COMMON_FEATURE_CATEGORIES, KNOWN_PLUGIN_FEATURES, DEFAULT_COMPARISON_CONFIG, } from './comparison-types.js';
+export { ComparisonService, getComparisonService, resetComparisonService, } from './comparison-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/recommendations/comparison/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/recommendations/comparison/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC"}

package/dist/core/recommendations/cooccurrence/cooccurrence-service.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Co-occurrence Service
+ *
+ * Manages local co-occurrence tracking and data persistence.
+ *
+ * @since v1.66.1
+ */
+import { CooccurrenceMatrix } from '../algorithms/cooccurrence.js';
+import type { CooccurrenceEntry } from '../recommendation-types.js';
+import type { CommunityCooccurrenceData, PairStatistics } from './cooccurrence-types.js';
+/**
+ * Service for managing plugin co-occurrence data
+ */
+export declare class CooccurrenceService {
+    private matrix;
+    private localRecord;
+    private communityData;
+    private dataPath;
+    private dirty;
+    constructor(dataDir: string);
+    /**
+     * Initialize the service
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create empty local record
+     */
+    private createEmptyRecord;
+    /**
+     * Load local co-occurrence data from disk
+     */
+    private loadLocalData;
+    /**
+     * Save local co-occurrence data to disk
+     */
+    save(): Promise<void>;
+    /**
+     * Record an observation of plugins installed together
+     */
+    recordObservation(pluginIds: string[]): void;
+    /**
+     * Get the co-occurrence matrix
+     */
+    getMatrix(): CooccurrenceMatrix;
+    /**
+     * Get probability that two plugins are used together
+     */
+    getProbability(pluginA: string, pluginB: string): number;
+    /**
+     * Get plugins frequently used with a given plugin
+     */
+    getRelatedPlugins(pluginId: string, limit?: number): Array<{
+        pluginId: string;
+        probability: number;
+    }>;
+    /**
+     * Get statistics for a plugin pair
+     */
+    getPairStatistics(pluginA: string, pluginB: string): PairStatistics | null;
+    /**
+     * Get all statistics above a minimum probability
+     */
+    getAllStatistics(minProbability?: number): PairStatistics[];
+    /**
+     * Load community data from API response
+     */
+    loadCommunityData(data: CommunityCooccurrenceData): void;
+    /**
+     * Get local tracking statistics
+     */
+    getTrackingStats(): {
+        totalObservations: number;
+        uniquePairs: number;
+        trackingDays: number;
+        lastUpdated: number;
+    };
+    /**
+     * Export local data for anonymous reporting
+     */
+    exportAnonymousData(): CooccurrenceEntry[];
+    /**
+     * Clear local tracking data
+     */
+    clearLocalData(): void;
+    /**
+     * Get top plugin pairs by co-occurrence
+     */
+    getTopPairs(limit?: number): PairStatistics[];
+}
+/**
+ * Get or create the co-occurrence service
+ */
+export declare function getCooccurrenceService(dataDir: string): CooccurrenceService;
+/**
+ * Reset the service instance (for testing)
+ */
+export declare function resetCooccurrenceService(): void;
+//# sourceMappingURL=cooccurrence-service.d.ts.map

package/dist/core/recommendations/cooccurrence/cooccurrence-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooccurrence-service.d.ts","sourceRoot":"","sources":["../../../../src/core/recommendations/cooccurrence/cooccurrence-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,kBAAkB,EAA6B,MAAM,+BAA+B,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,yBAAyB,EAA2B,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGlH;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;gBAEV,OAAO,EAAE,MAAM;IAS3B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;YACW,aAAa;IAyB3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAuC5C;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAIxD;;OAEG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAK,GACT,KAAK,CAAC;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAIF;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAkC1E;;OAEG;IACH,gBAAgB,CAAC,cAAc,SAAM,GAAG,cAAc,EAAE;IAgBxD;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI;IASxD;;OAEG;IACH,gBAAgB,IAAI;QAClB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB;IAWD;;OAEG;IACH,mBAAmB,IAAI,iBAAiB,EAAE;IAS1C;;OAEG;IACH,cAAc,IAAI,IAAI;IAKtB;;OAEG;IACH,WAAW,CAAC,KAAK,SAAK,GAAG,cAAc,EAAE;CAG1C;AAOD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAK3E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/core/recommendations/cooccurrence/cooccurrence-types.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Co-occurrence Types
+ *
+ * Type definitions for plugin co-occurrence tracking and analysis.
+ *
+ * @since v1.66.1
+ */
+/**
+ * Configuration for usage data collection
+ */
+export interface UsageDataConfig {
+    /** Is data collection enabled (opt-in required) */
+    enabled: boolean;
+    /** Strip server identifiers for anonymity */
+    anonymous: boolean;
+    /** What data types to collect */
+    dataTypes: {
+        /** Track installed plugins */
+        installedPlugins: boolean;
+        /** Track plugin versions */
+        pluginVersions: boolean;
+        /** Track server type (Spigot/Paper/etc.) */
+        serverType: boolean;
+        /** Track update patterns */
+        updatePatterns: boolean;
+    };
+    /** Minimum days between reports */
+    reportInterval: number;
+    /** Last report timestamp */
+    lastReportAt?: number;
+}
+/**
+ * Anonymous usage report sent to API
+ */
+export interface AnonymousUsageReport {
+    /** SHA256 hash of machine ID (not reversible) */
+    hash: string;
+    /** List of plugin IDs installed */
+    plugins: string[];
+    /** Server platform type */
+    serverType: string;
+    /** Minecraft version */
+    mcVersion: string;
+    /** Report timestamp */
+    timestamp: number;
+    /** Pluginator version */
+    pluginatorVersion: string;
+}
+/**
+ * Local co-occurrence tracking record
+ */
+export interface LocalCooccurrenceRecord {
+    /** When tracking started */
+    trackingStarted: number;
+    /** Total observations (scans) */
+    totalObservations: number;
+    /** Plugin pair co-occurrences */
+    pairs: Array<{
+        pluginA: string;
+        pluginB: string;
+        count: number;
+        lastSeen: number;
+    }>;
+    /** Last updated timestamp */
+    lastUpdated: number;
+}
+/**
+ * Co-occurrence statistics for a plugin pair
+ */
+export interface PairStatistics {
+    /** Plugin A ID */
+    pluginA: string;
+    /** Plugin B ID */
+    pluginB: string;
+    /** Co-occurrence probability (0-1) */
+    probability: number;
+    /** Number of observations */
+    sampleSize: number;
+    /** Confidence level based on sample size */
+    confidence: 'low' | 'medium' | 'high';
+    /** Standard deviation */
+    stdDev?: number;
+    /** Trend direction over time */
+    trend?: 'increasing' | 'stable' | 'decreasing';
+}
+/**
+ * Community co-occurrence data from API
+ */
+export interface CommunityCooccurrenceData {
+    /** Data version */
+    version: string;
+    /** When data was generated */
+    generatedAt: number;
+    /** Total servers in sample */
+    totalServers: number;
+    /** Co-occurrence entries */
+    entries: Array<{
+        pluginA: string;
+        pluginB: string;
+        probability: number;
+        sampleSize: number;
+    }>;
+    /** Data freshness indicator */
+    staleness: 'fresh' | 'recent' | 'stale';
+}
+/**
+ * A/B test configuration for algorithms
+ */
+export interface ABTestConfig {
+    /** Test ID */
+    id: string;
+    /** Test name */
+    name: string;
+    /** Description of what's being tested */
+    description: string;
+    /** Algorithm variants */
+    variants: Array<{
+        id: string;
+        name: string;
+        weight: number;
+        config: Record<string, unknown>;
+    }>;
+    /** Start date */
+    startDate: number;
+    /** End date (undefined = ongoing) */
+    endDate?: number;
+    /** Is test active */
+    active: boolean;
+}
+/**
+ * A/B test result metrics
+ */
+export interface ABTestMetrics {
+    /** Test ID */
+    testId: string;
+    /** Variant ID */
+    variantId: string;
+    /** Number of users exposed */
+    exposures: number;
+    /** Number of clicks/installs */
+    conversions: number;
+    /** Conversion rate */
+    conversionRate: number;
+    /** Average recommendation score of installed plugins */
+    avgRecommendationScore: number;
+    /** User satisfaction (if collected) */
+    satisfaction?: number;
+}
+/**
+ * Default usage data configuration
+ */
+export declare const DEFAULT_USAGE_CONFIG: UsageDataConfig;
+/**
+ * Confidence thresholds for statistics
+ */
+export declare const CONFIDENCE_THRESHOLDS: {
+    readonly low: 50;
+    readonly medium: 200;
+    readonly high: 200;
+};
+//# sourceMappingURL=cooccurrence-types.d.ts.map

package/dist/core/recommendations/cooccurrence/cooccurrence-types.d.ts.map

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

package/dist/core/recommendations/cooccurrence/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Co-occurrence Module
+ *
+ * Plugin co-occurrence tracking and analysis.
+ *
+ * @since v1.66.1
+ */
+export type { UsageDataConfig, AnonymousUsageReport, LocalCooccurrenceRecord, PairStatistics, CommunityCooccurrenceData, ABTestConfig, ABTestMetrics, } from './cooccurrence-types.js';
+export { DEFAULT_USAGE_CONFIG, CONFIDENCE_THRESHOLDS, } from './cooccurrence-types.js';
+export { CooccurrenceService, getCooccurrenceService, resetCooccurrenceService, } from './cooccurrence-service.js';
+export { UsageCollectionService, getUsageCollectionService, resetUsageCollectionService, } from './usage-collection.js';
+export { mean, standardDeviation, wilsonConfidenceInterval, correlationCoefficient, getConfidenceLevel, isSignificantDifference, detectTrend, findPluginClusters, calculateCentrality, getSummaryStatistics, } from './statistics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/recommendations/cooccurrence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/recommendations/cooccurrence/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,yBAAyB,EACzB,YAAY,EACZ,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,IAAI,EACJ,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/core/recommendations/cooccurrence/statistics.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Co-occurrence Statistics
+ *
+ * Statistical analysis tools for co-occurrence data.
+ *
+ * @since v1.66.1
+ */
+import type { CooccurrenceEntry } from '../recommendation-types.js';
+/**
+ * Calculate mean of an array of numbers
+ */
+export declare function mean(values: number[]): number;
+/**
+ * Calculate standard deviation
+ */
+export declare function standardDeviation(values: number[]): number;
+/**
+ * Calculate confidence interval for a proportion
+ * Uses Wilson score interval for better accuracy with small samples
+ */
+export declare function wilsonConfidenceInterval(successes: number, total: number, confidence?: number): {
+    lower: number;
+    upper: number;
+};
+/**
+ * Calculate correlation coefficient between two plugin's co-occurrence patterns
+ */
+export declare function correlationCoefficient(entriesA: CooccurrenceEntry[], entriesB: CooccurrenceEntry[]): number;
+/**
+ * Determine confidence level from sample size
+ */
+export declare function getConfidenceLevel(sampleSize: number): 'low' | 'medium' | 'high';
+/**
+ * Calculate statistical significance of probability difference
+ * Uses two-proportion z-test
+ */
+export declare function isSignificantDifference(p1: number, n1: number, p2: number, n2: number, alpha?: number): boolean;
+/**
+ * Detect trend in time-series data using linear regression
+ */
+export declare function detectTrend(dataPoints: Array<{
+    timestamp: number;
+    value: number;
+}>): 'increasing' | 'stable' | 'decreasing';
+/**
+ * Find clusters of highly correlated plugins
+ */
+export declare function findPluginClusters(entries: CooccurrenceEntry[], minCorrelation?: number): string[][];
+/**
+ * Calculate plugin centrality (how connected it is to other plugins)
+ */
+export declare function calculateCentrality(pluginId: string, entries: CooccurrenceEntry[]): number;
+/**
+ * Get summary statistics for co-occurrence data
+ */
+export declare function getSummaryStatistics(entries: CooccurrenceEntry[]): {
+    totalPairs: number;
+    avgProbability: number;
+    medianProbability: number;
+    stdDevProbability: number;
+    highConfidencePairs: number;
+    avgSampleSize: number;
+};
+//# sourceMappingURL=statistics.d.ts.map

package/dist/core/recommendations/cooccurrence/statistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statistics.d.ts","sourceRoot":"","sources":["../../../../src/core/recommendations/cooccurrence/statistics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAIpE;;GAEG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAG7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAQ1D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,SAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAgB9H;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAgC3G;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAIhF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,OAAO,CAc7G;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,CAkC3H;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,cAAc,SAAM,GAAG,MAAM,EAAE,EAAE,CAoDjG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAkB1F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB,CAuBA"}

package/dist/core/recommendations/cooccurrence/usage-collection.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Usage Collection Service
+ *
+ * Handles opt-in anonymous usage data collection for improving recommendations.
+ *
+ * @since v1.66.1
+ */
+import type { AnonymousUsageReport, UsageDataConfig } from './cooccurrence-types.js';
+/**
+ * Service for managing anonymous usage data collection
+ */
+export declare class UsageCollectionService {
+    private config;
+    private configPath;
+    private machineHash;
+    constructor(dataDir: string, machineId: string);
+    /**
+     * Initialize the service
+     */
+    initialize(): Promise<void>;
+    /**
+     * Hash machine ID for anonymity
+     */
+    private hashMachineId;
+    /**
+     * Load configuration from disk
+     */
+    private loadConfig;
+    /**
+     * Save configuration to disk
+     */
+    saveConfig(): Promise<void>;
+    /**
+     * Check if data collection is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Enable data collection (opt-in)
+     */
+    enable(): Promise<void>;
+    /**
+     * Disable data collection
+     */
+    disable(): Promise<void>;
+    /**
+     * Get current configuration
+     */
+    getConfig(): UsageDataConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(updates: Partial<UsageDataConfig>): Promise<void>;
+    /**
+     * Check if it's time to send a report
+     */
+    shouldReport(): boolean;
+    /**
+     * Create an anonymous usage report
+     */
+    createReport(pluginIds: string[], pluginVersions: Map<string, string>, serverType: string, mcVersion: string, pluginatorVersion: string): AnonymousUsageReport | null;
+    /**
+     * Mark report as sent
+     */
+    markReportSent(): Promise<void>;
+    /**
+     * Get privacy-safe summary of what data would be sent
+     */
+    getDataSummary(pluginIds: string[], serverType: string, mcVersion: string): {
+        willSend: string[];
+        willNotSend: string[];
+    };
+    /**
+     * Get consent text for user display
+     */
+    getConsentText(): string;
+}
+/**
+ * Get or create the usage collection service
+ */
+export declare function getUsageCollectionService(dataDir: string, machineId: string): UsageCollectionService;
+/**
+ * Reset the service instance (for testing)
+ */
+export declare function resetUsageCollectionService(): void;
+//# sourceMappingURL=usage-collection.d.ts.map

package/dist/core/recommendations/cooccurrence/usage-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-collection.d.ts","sourceRoot":"","sources":["../../../../src/core/recommendations/cooccurrence/usage-collection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGrF;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAM9C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,SAAS,IAAI,eAAe;IAI5B;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE;;OAEG;IACH,YAAY,IAAI,OAAO;IAQvB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAerK;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC;;OAEG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;QACD,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB;IAoCD;;OAEG;IACH,cAAc,IAAI,MAAM;CAuBzB;AAOD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAKpG;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/core/recommendations/discovery/discovery-service.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Discovery Service
+ *
+ * Generates personalized plugin discovery feeds.
+ *
+ * @since v1.66.4
+ */
+import type { RegistryPlugin } from '../../registry/registry-types.js';
+import type { DiscoveryFeed, DiscoveryPreferences, DiscoverySection, NewPluginCriteria, TrendingCriteria } from './discovery-types.js';
+/**
+ * Service for generating discovery feeds
+ */
+export declare class DiscoveryService {
+    private preferences;
+    private newCriteria;
+    private trendingCriteria;
+    constructor(preferences?: Partial<DiscoveryPreferences>, newCriteria?: Partial<NewPluginCriteria>, trendingCriteria?: Partial<TrendingCriteria>);
+    /**
+     * Generate a discovery feed
+     */
+    generateFeed(registryPlugins: RegistryPlugin[], installedPlugins: RegistryPlugin[]): DiscoveryFeed;
+    /**
+     * Generate "New This Week" section
+     */
+    private generateNewSection;
+    /**
+     * Generate "Rising Stars" trending section
+     */
+    private generateTrendingSection;
+    /**
+     * Generate curated collection sections
+     */
+    private generateCuratedSections;
+    /**
+     * Generate personalized "For You" section
+     */
+    private generateForYouSection;
+    /**
+     * Generate category-based section
+     */
+    private generateCategorySection;
+    /**
+     * Generate random explore section
+     */
+    generateExploreSection(plugins: RegistryPlugin[], count?: number): DiscoverySection;
+    /**
+     * Save a plugin to wishlist
+     */
+    savePlugin(pluginId: string): void;
+    /**
+     * Remove plugin from wishlist
+     */
+    unsavePlugin(pluginId: string): void;
+    /**
+     * Hide a plugin from discovery
+     */
+    hidePlugin(pluginId: string): void;
+    /**
+     * Get saved plugins
+     */
+    getSavedPlugins(): Set<string>;
+    /**
+     * Update preferences
+     */
+    updatePreferences(updates: Partial<DiscoveryPreferences>): void;
+    /**
+     * Get current preferences
+     */
+    getPreferences(): DiscoveryPreferences;
+}
+/**
+ * Get or create the discovery service
+ */
+export declare function getDiscoveryService(preferences?: Partial<DiscoveryPreferences>): DiscoveryService;
+/**
+ * Reset the service instance (for testing)
+ */
+export declare function resetDiscoveryService(): void;
+//# sourceMappingURL=discovery-service.d.ts.map

package/dist/core/recommendations/discovery/discovery-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-service.d.ts","sourceRoot":"","sources":["../../../../src/core/recommendations/discovery/discovery-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAiB,oBAAoB,EAAE,gBAAgB,EAAwB,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG5K;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,WAAW,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAW/I;;OAEG;IACH,YAAY,CAAC,eAAe,EAAE,cAAc,EAAE,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,aAAa;IAmElG;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkC1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwC/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgC/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwD7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,KAAK,SAAI,GAAG,gBAAgB;IAqB9E;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC;IAI9B;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAS/D;;OAEG;IACH,cAAc,IAAI,oBAAoB;CAOvC;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,gBAAgB,CAKjG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}