@nindroidsystems/pluginator 2.3.0

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

@@ -0,0 +1,129 @@
+/**
+ * Discovery Types
+ *
+ * Type definitions for plugin discovery functionality.
+ *
+ * @since v1.66.4
+ */
+import type { RegistryPlugin } from '../../registry/registry-types.js';
+import type { CuratedCollection } from '../recommendation-types.js';
+/**
+ * Discovery section types
+ */
+export type DiscoverySectionType = 'new' | 'trending' | 'staff_picks' | 'for_you' | 'category' | 'explore';
+/**
+ * A discovery section
+ */
+export interface DiscoverySection {
+    /** Section type */
+    type: DiscoverySectionType;
+    /** Section title */
+    title: string;
+    /** Section subtitle/description */
+    subtitle?: string;
+    /** Icon for the section */
+    icon: string;
+    /** Plugins in this section */
+    plugins: DiscoveryItem[];
+    /** Related collection if applicable */
+    collection?: CuratedCollection;
+    /** Category if category-based */
+    category?: string;
+    /** Whether section is expanded */
+    expanded?: boolean;
+}
+/**
+ * A discoverable plugin item
+ */
+export interface DiscoveryItem {
+    /** The plugin */
+    plugin: RegistryPlugin;
+    /** Why this plugin is being shown */
+    reason: string;
+    /** Badge text (e.g., "New!", "Trending") */
+    badge?: string;
+    /** Badge type for styling */
+    badgeType?: 'new' | 'trending' | 'popular' | 'recommended';
+    /** Growth rate if trending */
+    growthRate?: number;
+    /** Position in trending list */
+    trendingRank?: number;
+    /** Is this saved/wishlisted */
+    saved?: boolean;
+}
+/**
+ * User discovery preferences
+ */
+export interface DiscoveryPreferences {
+    /** Preferred categories to show */
+    preferredCategories: string[];
+    /** Categories to hide */
+    hiddenCategories: string[];
+    /** Saved/wishlisted plugin IDs */
+    savedPlugins: Set<string>;
+    /** Hidden plugin IDs (don't show again) */
+    hiddenPlugins: Set<string>;
+    /** Show curated collections */
+    showCurated: boolean;
+    /** Show trending section */
+    showTrending: boolean;
+    /** Show new plugins section */
+    showNew: boolean;
+    /** Number of items per section */
+    itemsPerSection: number;
+}
+/**
+ * Discovery feed result
+ */
+export interface DiscoveryFeed {
+    /** All sections to display */
+    sections: DiscoverySection[];
+    /** Total plugins across all sections */
+    totalPlugins: number;
+    /** Generation timestamp */
+    generatedAt: number;
+    /** Context that generated this feed */
+    context: {
+        installedCategories: string[];
+        installedTags: string[];
+    };
+}
+/**
+ * New plugin criteria
+ */
+export interface NewPluginCriteria {
+    /** Maximum days since creation */
+    maxDaysOld: number;
+    /** Minimum downloads to include */
+    minDownloads: number;
+    /** Minimum rating to include */
+    minRating: number;
+}
+/**
+ * Trending plugin criteria
+ */
+export interface TrendingCriteria {
+    /** Minimum growth rate (e.g., 1.5 = 50% growth) */
+    minGrowthRate: number;
+    /** Time period for growth calculation (days) */
+    periodDays: number;
+    /** Minimum downloads to be considered */
+    minDownloads: number;
+}
+/**
+ * Default discovery preferences
+ */
+export declare const DEFAULT_DISCOVERY_PREFERENCES: DiscoveryPreferences;
+/**
+ * Default new plugin criteria
+ */
+export declare const DEFAULT_NEW_CRITERIA: NewPluginCriteria;
+/**
+ * Default trending criteria
+ */
+export declare const DEFAULT_TRENDING_CRITERIA: TrendingCriteria;
+/**
+ * Section icons
+ */
+export declare const SECTION_ICONS: Record<DiscoverySectionType, string>;
+//# sourceMappingURL=discovery-types.d.ts.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Discovery Module
+ *
+ * Plugin discovery and personalized feed functionality.
+ *
+ * @since v1.66.4
+ */
+export type { DiscoverySectionType, DiscoverySection, DiscoveryItem, DiscoveryPreferences, DiscoveryFeed, NewPluginCriteria, TrendingCriteria, } from './discovery-types.js';
+export { DEFAULT_DISCOVERY_PREFERENCES, DEFAULT_NEW_CRITERIA, DEFAULT_TRENDING_CRITERIA, SECTION_ICONS, } from './discovery-types.js';
+export { DiscoveryService, getDiscoveryService, resetDiscoveryService, } from './discovery-service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/recommendations/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Recommendations Module
+ *
+ * Plugin recommendation system with multiple algorithms.
+ *
+ * @since v1.66.0
+ */
+export type { RecommendationType, RecommendationSource, ReasonType, RecommendationReason, Recommendation, RecommendationFeedback, RecommendationPreferences, RecommendationContext, AlgorithmResult, RecommendationResults, RecommendationConfig, PluginSimilarity, CooccurrenceEntry, TrendingData, CuratedCollection, } from './recommendation-types.js';
+export { DEFAULT_RECOMMENDATION_CONFIG, DEFAULT_RECOMMENDATION_PREFERENCES, BUILTIN_COLLECTIONS, } from './recommendation-types.js';
+export { calculatePluginSimilarity, findSimilarPlugins, runSimilarAlgorithm, CooccurrenceMatrix, DEFAULT_COOCCURRENCE_DATA, findComplementaryPlugins, createDefaultMatrix, runCooccurrenceAlgorithm, calculatePopularityScore, findPopularPlugins, runPopularAlgorithm, calculateTrendingScore, findTrendingPlugins, runTrendingAlgorithm, COMMON_DEPENDENCIES, COMPATIBILITY_REQUIREMENTS, findMissingDependencies, runMissingAlgorithm, UPGRADE_PATHS, calculateQualityMetrics, findUpgrades, runUpgradeAlgorithm, } from './algorithms/index.js';
+export { calculateBoost, applyAlgorithmWeight, scoreAndRank, mergeWithDiversity, generateContextHash, } from './scorer.js';
+export { RecommendationEngine, getRecommendationEngine, resetRecommendationEngine, } from './recommendation-engine.js';
+export type { UsageDataConfig, AnonymousUsageReport, LocalCooccurrenceRecord, PairStatistics, CommunityCooccurrenceData, ABTestConfig, ABTestMetrics, } from './cooccurrence/index.js';
+export { DEFAULT_USAGE_CONFIG, CONFIDENCE_THRESHOLDS, CooccurrenceService, getCooccurrenceService, resetCooccurrenceService, UsageCollectionService, getUsageCollectionService, resetUsageCollectionService, mean, standardDeviation, wilsonConfidenceInterval, correlationCoefficient, getConfidenceLevel, isSignificantDifference, detectTrend, findPluginClusters, calculateCentrality, getSummaryStatistics, } from './cooccurrence/index.js';
+export type { FeatureSupport, FeatureComparison, ComparisonStats, ComparisonResult, MigrationGuide, } from './comparison/index.js';
+export { COMMON_FEATURE_CATEGORIES, KNOWN_PLUGIN_FEATURES, DEFAULT_COMPARISON_CONFIG, ComparisonService, getComparisonService, resetComparisonService, } from './comparison/index.js';
+export type { DiscoverySectionType, DiscoveryItem, DiscoverySection, DiscoveryFeed, DiscoveryPreferences, NewPluginCriteria, TrendingCriteria, } from './discovery/index.js';
+export { DEFAULT_DISCOVERY_PREFERENCES, DEFAULT_NEW_CRITERIA, DEFAULT_TRENDING_CRITERIA, SECTION_ICONS, DiscoveryService, getDiscoveryService, resetDiscoveryService, } from './discovery/index.js';
+export type { ReviewSource, PluginReview, AggregatedRating, ServerStory, CompatibilityReport, GitHubIssueSummary, DiscordCommunity, CommunityQuestion, CommunityInsights, CommunityServiceConfig, ReviewFilters, ReviewSortBy, } from './community/index.js';
+export { DEFAULT_COMMUNITY_CONFIG, SENTIMENT_THRESHOLDS, SOURCE_WEIGHTS, ACTIVITY_THRESHOLDS, CommunityService, getCommunityService, resetCommunityService, } from './community/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/recommendations/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,EAClC,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAGpC,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,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,EAC3B,IAAI,EACJ,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/core/recommendations/recommendation-engine.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Recommendation Engine
+ *
+ * Main orchestrator for plugin recommendations.
+ * Runs multiple algorithms and combines results.
+ *
+ * @since v1.66.0
+ */
+import type { RegistryPlugin } from '../registry/registry-types.js';
+import type { CuratedCollection, Recommendation, RecommendationConfig, RecommendationPreferences, RecommendationResults } from './recommendation-types.js';
+/**
+ * Recommendation Engine
+ */
+export declare class RecommendationEngine {
+    private config;
+    private cooccurrenceMatrix;
+    private cache;
+    constructor(config?: Partial<RecommendationConfig>);
+    /**
+     * Update configuration
+     */
+    setConfig(config: Partial<RecommendationConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): RecommendationConfig;
+    /**
+     * Clear the results cache
+     */
+    clearCache(): void;
+    /**
+     * Generate recommendations for the given context
+     */
+    generateRecommendations(installedPlugins: RegistryPlugin[], registryPlugins: RegistryPlugin[], preferences?: Partial<RecommendationPreferences>): Promise<RecommendationResults>;
+    /**
+     * Get recommendations by type
+     */
+    getByType(type: Recommendation['type'], installedPlugins: RegistryPlugin[], registryPlugins: RegistryPlugin[], preferences?: Partial<RecommendationPreferences>, limit?: number): Promise<Recommendation[]>;
+    /**
+     * Get curated collections
+     */
+    getCollections(): CuratedCollection[];
+    /**
+     * Get plugins from a collection
+     */
+    getCollectionPlugins(collectionId: string, registryPlugins: RegistryPlugin[]): RegistryPlugin[];
+    /**
+     * Get featured collections
+     */
+    getFeaturedCollections(): CuratedCollection[];
+    /**
+     * Dismiss a recommendation
+     */
+    dismissRecommendation(recommendations: Recommendation[], pluginId: string): Recommendation[];
+    /**
+     * Save a recommendation for later
+     */
+    saveRecommendation(recommendations: Recommendation[], pluginId: string): Recommendation[];
+    /**
+     * Get saved recommendations
+     */
+    getSaved(recommendations: Recommendation[]): Recommendation[];
+    /**
+     * Get statistics about recommendation generation
+     */
+    getStats(results: RecommendationResults): {
+        totalRecommendations: number;
+        byType: Record<string, number>;
+        bySource: Record<string, number>;
+        averageScore: number;
+        executionTime: number;
+        algorithmStats: Array<{
+            name: string;
+            count: number;
+            time: number;
+            success: boolean;
+        }>;
+    };
+}
+/**
+ * Get the recommendation engine instance
+ */
+export declare function getRecommendationEngine(config?: Partial<RecommendationConfig>): RecommendationEngine;
+/**
+ * Reset the engine instance (for testing)
+ */
+export declare function resetRecommendationEngine(): void;
+//# sourceMappingURL=recommendation-engine.d.ts.map

package/dist/core/recommendations/recommendation-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation-engine.d.ts","sourceRoot":"","sources":["../../../src/core/recommendations/recommendation-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAWpE,OAAO,KAAK,EAAmB,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,EAAyB,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAInM;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,KAAK,CAIG;gBAEJ,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAKlD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAKtD;;OAEG;IACH,SAAS,IAAI,oBAAoB;IAIjC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACG,uBAAuB,CAAC,gBAAgB,EAAE,cAAc,EAAE,EAAE,eAAe,EAAE,cAAc,EAAE,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA+FtL;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAC5B,gBAAgB,EAAE,cAAc,EAAE,EAClC,eAAe,EAAE,cAAc,EAAE,EACjC,WAAW,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,EAChD,KAAK,SAAK,GACT,OAAO,CAAC,cAAc,EAAE,CAAC;IAM5B;;OAEG;IACH,cAAc,IAAI,iBAAiB,EAAE;IAIrC;;OAEG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAO/F;;OAEG;IACH,sBAAsB,IAAI,iBAAiB,EAAE;IAI7C;;OAEG;IACH,qBAAqB,CAAC,eAAe,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAI5F;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAIzF;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAI7D;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG;QACxC,oBAAoB,EAAE,MAAM,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,KAAK,CAAC;YACpB,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,OAAO,CAAC;SAClB,CAAC,CAAC;KACJ;CAyBF;AAOD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAOpG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

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

@@ -0,0 +1,243 @@
+/**
+ * Recommendation Types
+ *
+ * Type definitions for the plugin recommendation system.
+ *
+ * @since v1.66.0
+ */
+import type { RegistryPlugin } from '../registry/registry-types.js';
+/**
+ * Types of recommendations the system can generate
+ */
+export type RecommendationType = 'similar' | 'complementary' | 'popular' | 'trending' | 'missing' | 'upgrade';
+/**
+ * Source of the recommendation
+ */
+export type RecommendationSource = 'algorithm' | 'curated' | 'community';
+/**
+ * Reason types for recommendations
+ */
+export type ReasonType = 'similar_to' | 'works_with' | 'popular_in' | 'replaces' | 'extends' | 'required_by' | 'trending' | 'new_release';
+/**
+ * A reason why a plugin is recommended
+ */
+export interface RecommendationReason {
+    /** Type of reason */
+    type: ReasonType;
+    /** Reference plugin name or category */
+    reference?: string;
+    /** Human-readable description */
+    description: string;
+    /** Weight of this reason (0-1) */
+    weight: number;
+}
+/**
+ * A plugin recommendation
+ */
+export interface Recommendation {
+    /** The recommended plugin */
+    plugin: RegistryPlugin;
+    /** Type of recommendation */
+    type: RecommendationType;
+    /** Confidence score (0-1) */
+    score: number;
+    /** Reasons for the recommendation */
+    reasons: RecommendationReason[];
+    /** Source of the recommendation */
+    source: RecommendationSource;
+    /** Timestamp when generated */
+    generatedAt: number;
+    /** Whether user has dismissed this */
+    dismissed?: boolean;
+    /** Whether user has saved this */
+    saved?: boolean;
+}
+/**
+ * User feedback on a recommendation
+ */
+export interface RecommendationFeedback {
+    /** Plugin ID */
+    pluginId: string;
+    /** Feedback type */
+    action: 'dismiss' | 'save' | 'install' | 'view';
+    /** Timestamp */
+    timestamp: number;
+    /** Recommendation type that led to this */
+    recommendationType: RecommendationType;
+}
+/**
+ * User preferences for recommendations
+ */
+export interface RecommendationPreferences {
+    /** Dismissed plugin IDs */
+    dismissedPlugins: Set<string>;
+    /** Saved plugin IDs */
+    savedPlugins: Set<string>;
+    /** Preferred categories */
+    preferredCategories: string[];
+    /** Excluded categories */
+    excludedCategories: string[];
+    /** Minimum score threshold */
+    minScore: number;
+    /** Maximum recommendations to show */
+    maxRecommendations: number;
+}
+/**
+ * Context for generating recommendations
+ */
+export interface RecommendationContext {
+    /** Currently installed plugins */
+    installedPlugins: RegistryPlugin[];
+    /** All available plugins from registry */
+    registryPlugins: RegistryPlugin[];
+    /** User preferences */
+    preferences: RecommendationPreferences;
+    /** Plugin categories in use */
+    activeCategories: string[];
+    /** Plugin tags in use */
+    activeTags: string[];
+}
+/**
+ * Result from a recommendation algorithm
+ */
+export interface AlgorithmResult {
+    /** Algorithm name */
+    algorithm: string;
+    /** Recommendations from this algorithm */
+    recommendations: Recommendation[];
+    /** Execution time in ms */
+    executionTime: number;
+    /** Whether algorithm completed successfully */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Combined recommendations from all algorithms
+ */
+export interface RecommendationResults {
+    /** Final ranked recommendations */
+    recommendations: Recommendation[];
+    /** Results from individual algorithms */
+    algorithmResults: AlgorithmResult[];
+    /** Total execution time */
+    totalTime: number;
+    /** Generation timestamp */
+    generatedAt: number;
+    /** Context hash for cache invalidation */
+    contextHash: string;
+}
+/**
+ * Configuration for the recommendation engine
+ */
+export interface RecommendationConfig {
+    /** Enable/disable specific algorithms */
+    algorithms: {
+        similar: boolean;
+        complementary: boolean;
+        popular: boolean;
+        trending: boolean;
+        missing: boolean;
+        upgrade: boolean;
+    };
+    /** Algorithm weights for final scoring */
+    weights: {
+        similar: number;
+        complementary: number;
+        popular: number;
+        trending: number;
+        missing: number;
+        upgrade: number;
+    };
+    /** Boost factors for plugin qualities */
+    boosts: {
+        verified: number;
+        popular: number;
+        recentUpdate: number;
+        highRating: number;
+        manyDownloads: number;
+    };
+    /** Minimum score to include in results */
+    minScore: number;
+    /** Maximum results per algorithm */
+    maxPerAlgorithm: number;
+    /** Maximum total results */
+    maxTotal: number;
+    /** Cache TTL in milliseconds */
+    cacheTtl: number;
+}
+/**
+ * Default recommendation configuration
+ */
+export declare const DEFAULT_RECOMMENDATION_CONFIG: RecommendationConfig;
+/**
+ * Default user preferences
+ */
+export declare const DEFAULT_RECOMMENDATION_PREFERENCES: RecommendationPreferences;
+/**
+ * Plugin similarity data
+ */
+export interface PluginSimilarity {
+    /** Plugin ID */
+    pluginId: string;
+    /** Similarity score (0-1) */
+    similarity: number;
+    /** Common tags */
+    commonTags: string[];
+    /** Same category */
+    sameCategory: boolean;
+}
+/**
+ * Co-occurrence entry
+ */
+export interface CooccurrenceEntry {
+    /** Plugin A ID */
+    pluginA: string;
+    /** Plugin B ID */
+    pluginB: string;
+    /** Probability of co-occurrence (0-1) */
+    probability: number;
+    /** Sample size (number of servers observed) */
+    sampleSize: number;
+}
+/**
+ * Trending data for a plugin
+ */
+export interface TrendingData {
+    /** Plugin ID */
+    pluginId: string;
+    /** Download count this period */
+    periodDownloads: number;
+    /** Download count previous period */
+    previousDownloads: number;
+    /** Growth rate */
+    growthRate: number;
+    /** Trending score */
+    trendingScore: number;
+}
+/**
+ * Curated collection of plugins
+ */
+export interface CuratedCollection {
+    /** Collection ID */
+    id: string;
+    /** Collection name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Plugin IDs in this collection */
+    pluginIds: string[];
+    /** Category/theme */
+    category?: string;
+    /** Icon */
+    icon?: string;
+    /** Featured flag */
+    featured: boolean;
+    /** Creation date */
+    createdAt: number;
+}
+/**
+ * Built-in curated collections
+ */
+export declare const BUILTIN_COLLECTIONS: CuratedCollection[];
+//# sourceMappingURL=recommendation-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation-types.d.ts","sourceRoot":"","sources":["../../../src/core/recommendations/recommendation-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,eAAe,GACf,SAAS,GACT,UAAU,GACV,SAAS,GACT,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,SAAS,GACT,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,SAAS,GACT,aAAa,GACb,UAAU,GACV,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,6BAA6B;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,mCAAmC;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAChD,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2BAA2B;IAC3B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,uBAAuB;IACvB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,2BAA2B;IAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,0CAA0C;IAC1C,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,uBAAuB;IACvB,WAAW,EAAE,yBAAyB,CAAC;IACvC,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,yBAAyB;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,yCAAyC;IACzC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,OAAO,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,0CAA0C;IAC1C,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,yCAAyC;IACzC,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,oBA4B3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC,EAAE,yBAOhD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB;IACpB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAyClD,CAAC"}

package/dist/core/recommendations/scorer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Recommendation Scorer
+ *
+ * Handles final scoring, boosting, and ranking of recommendations.
+ *
+ * @since v1.66.0
+ */
+import type { RegistryPlugin } from '../registry/registry-types.js';
+import type { Recommendation, RecommendationConfig } from './recommendation-types.js';
+/**
+ * Calculate boost multiplier for a plugin based on its qualities
+ */
+export declare function calculateBoost(plugin: RegistryPlugin, boosts: RecommendationConfig['boosts']): number;
+/**
+ * Apply algorithm weight to a recommendation score
+ */
+export declare function applyAlgorithmWeight(score: number, algorithmType: string, weights: RecommendationConfig['weights']): number;
+/**
+ * Score and rank recommendations from multiple algorithms
+ */
+export declare function scoreAndRank(recommendations: Recommendation[], config: RecommendationConfig): Recommendation[];
+/**
+ * Merge recommendations with diversity
+ *
+ * Ensures variety in recommendation types rather than
+ * all recommendations being from one algorithm.
+ */
+export declare function mergeWithDiversity(recommendations: Recommendation[], config: RecommendationConfig, diversityFactor?: number): Recommendation[];
+/**
+ * Generate context hash for cache invalidation
+ */
+export declare function generateContextHash(installedIds: string[], preferences: {
+    preferredCategories: string[];
+    excludedCategories: string[];
+}): string;
+//# sourceMappingURL=scorer.d.ts.map

package/dist/core/recommendations/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../../src/core/recommendations/scorer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAiC,cAAc,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAErH;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAgCrG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,GAAG,MAAM,CAG3H;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAgC9G;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,eAAe,SAAM,GAAG,cAAc,EAAE,CAqD3I;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE;IAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAAC,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAkBhJ"}

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

@@ -0,0 +1,9 @@
+/**
+ * Plugin Registry Module
+ *
+ * Provides curated plugin database with pre-configured sources
+ */
+export * from './registry-types.js';
+export { RegistryService, getRegistryService, createRegistryService } from './registry-service.js';
+export { RegistryDownloadService, createRegistryDownloadService, type RegistryDownloadOptions, type RegistryDownloadResult, type ResolveResult, } from './registry-download.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC"}