@skillsmith/core 0.5.6 → 0.5.8

package/dist/learning/ReasoningBankIntegration.types.d.ts

@@ -1,167 +0,0 @@
-/**
- * ReasoningBank Integration Type Definitions
- * @module @skillsmith/core/learning/ReasoningBankIntegration.types
- */
-import type { ISignalCollector } from './interfaces.js';
-/**
- * Configuration for V3 intelligence module initialization
- * @see claude-flow/v3 intelligence module
- */
-export interface IntelligenceConfig {
-    /** Path to pattern storage database */
-    storagePath?: string;
-    /** Enable neural pattern training */
-    enableNeural?: boolean;
-    /** Maximum patterns to retain */
-    maxPatterns?: number;
-    /** Similarity threshold for pattern matching */
-    similarityThreshold?: number;
-}
-/**
- * A single step in a reasoning trajectory
- */
-export interface TrajectoryStep {
-    /** Step identifier */
-    id: string;
-    /** Action taken (e.g., 'recommend', 'user_action') */
-    action: string;
-    /** Observation or context at this step */
-    observation: string;
-    /** Reward signal for this step */
-    reward: number;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Verdict judgment for a trajectory
- */
-export interface TrajectoryVerdict {
-    /** Overall success/failure */
-    success: boolean;
-    /** Confidence score [0-1] */
-    confidence: number;
-    /** Reasoning for the verdict */
-    reasoning?: string;
-}
-/**
- * Pattern returned from similarity search
- */
-export interface SimilarPattern {
-    /** Pattern identifier */
-    id: string;
-    /** Similarity score [0-1] */
-    similarity: number;
-    /** Associated trajectory steps */
-    trajectory: TrajectoryStep[];
-    /** Stored verdict */
-    verdict: TrajectoryVerdict;
-    /** Pattern metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Options for pattern search
- */
-export interface PatternSearchOptions {
-    /** Maximum results to return */
-    limit?: number;
-    /** Minimum similarity threshold */
-    minSimilarity?: number;
-    /** Filter by action type */
-    actionFilter?: string;
-}
-/**
- * V3 ReasoningBank instance interface
- */
-export interface IReasoningBank {
-    /** Record a trajectory with verdict */
-    recordTrajectory(steps: TrajectoryStep[], verdict: TrajectoryVerdict): Promise<string>;
-    /** Find similar patterns to a query */
-    findSimilarPatterns(query: string, options?: PatternSearchOptions): Promise<SimilarPattern[]>;
-    /** Get pattern by ID */
-    getPattern(id: string): Promise<SimilarPattern | null>;
-    /** Clear all patterns */
-    clear(): Promise<void>;
-    /** Get total pattern count */
-    getPatternCount(): Promise<number>;
-}
-/**
- * Reward values for different user actions
- * These map user signals to trajectory rewards for reinforcement learning
- */
-export declare const TRAJECTORY_REWARDS: {
-    /** User accepted recommendation - positive signal */
-    readonly ACCEPT: 1;
-    /** User dismissed recommendation - mild negative signal */
-    readonly DISMISS: -0.5;
-    /** User actively uses skill - reinforcement signal */
-    readonly USAGE: 0.3;
-    /** Skill abandoned (installed but unused) - negative signal */
-    readonly ABANDONMENT: -0.3;
-    /** User uninstalled skill - strong negative signal */
-    readonly UNINSTALL: -0.7;
-};
-/**
- * Verdict confidence thresholds
- */
-export declare const CONFIDENCE_THRESHOLDS: {
-    /** High confidence - strong signal pattern */
-    readonly HIGH: 0.8;
-    /** Medium confidence - moderate signal pattern */
-    readonly MEDIUM: 0.5;
-    /** Low confidence - weak signal pattern */
-    readonly LOW: 0.3;
-    /** Minimum for personalization */
-    readonly MINIMUM: 0.1;
-};
-/**
- * Result from querying learned confidence for a skill
- */
-export interface SkillVerdict {
-    /** Skill identifier */
-    skillId: string;
-    /** Learned confidence score [-1, 1] where positive = likely to be accepted */
-    confidence: number;
-    /** Number of patterns used to derive confidence */
-    patternCount: number;
-    /** Whether enough data exists for confident prediction */
-    hasEnoughData: boolean;
-    /** Breakdown of signals contributing to verdict */
-    signalBreakdown?: {
-        accepts: number;
-        dismisses: number;
-        usages: number;
-        abandonments: number;
-        uninstalls: number;
-    };
-}
-/**
- * Batch verdict query result
- */
-export interface BatchVerdictResult {
-    /** Individual skill verdicts */
-    verdicts: SkillVerdict[];
-    /** Total patterns searched */
-    totalPatterns: number;
-    /** Query latency in milliseconds */
-    latencyMs: number;
-}
-/**
- * Configuration for ReasoningBankIntegration
- */
-export interface ReasoningBankIntegrationConfig {
-    /** V3 intelligence module configuration */
-    intelligenceConfig?: IntelligenceConfig;
-    /** Underlying signal collector for backwards compatibility */
-    signalCollector?: ISignalCollector;
-    /** Enable dual-write to both ReasoningBank and legacy storage */
-    enableDualWrite?: boolean;
-    /** Minimum patterns required for confident verdict */
-    minPatternsForVerdict?: number;
-    /** Similarity threshold for pattern matching */
-    patternSimilarityThreshold?: number;
-}
-/**
- * Default configuration values
- */
-export declare const DEFAULT_CONFIG: Required<ReasoningBankIntegrationConfig>;
-//# sourceMappingURL=ReasoningBankIntegration.types.d.ts.map

package/dist/learning/ReasoningBankIntegration.types.d.ts.map

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

package/dist/learning/ReasoningBankIntegration.types.js

@@ -1,51 +0,0 @@
-/**
- * ReasoningBank Integration Type Definitions
- * @module @skillsmith/core/learning/ReasoningBankIntegration.types
- */
-// ============================================================================
-// Reward Constants
-// ============================================================================
-/**
- * Reward values for different user actions
- * These map user signals to trajectory rewards for reinforcement learning
- */
-export const TRAJECTORY_REWARDS = {
-    /** User accepted recommendation - positive signal */
-    ACCEPT: 1.0,
-    /** User dismissed recommendation - mild negative signal */
-    DISMISS: -0.5,
-    /** User actively uses skill - reinforcement signal */
-    USAGE: 0.3,
-    /** Skill abandoned (installed but unused) - negative signal */
-    ABANDONMENT: -0.3,
-    /** User uninstalled skill - strong negative signal */
-    UNINSTALL: -0.7,
-};
-/**
- * Verdict confidence thresholds
- */
-export const CONFIDENCE_THRESHOLDS = {
-    /** High confidence - strong signal pattern */
-    HIGH: 0.8,
-    /** Medium confidence - moderate signal pattern */
-    MEDIUM: 0.5,
-    /** Low confidence - weak signal pattern */
-    LOW: 0.3,
-    /** Minimum for personalization */
-    MINIMUM: 0.1,
-};
-/**
- * Default configuration values
- */
-export const DEFAULT_CONFIG = {
-    intelligenceConfig: {
-        enableNeural: true,
-        maxPatterns: 10000,
-        similarityThreshold: 0.7,
-    },
-    signalCollector: undefined,
-    enableDualWrite: true,
-    minPatternsForVerdict: 3,
-    patternSimilarityThreshold: 0.6,
-};
-//# sourceMappingURL=ReasoningBankIntegration.types.js.map

package/dist/learning/ReasoningBankIntegration.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReasoningBankIntegration.types.js","sourceRoot":"","sources":["../../src/learning/ReasoningBankIntegration.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+FH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,qDAAqD;IACrD,MAAM,EAAE,GAAG;IACX,2DAA2D;IAC3D,OAAO,EAAE,CAAC,GAAG;IACb,sDAAsD;IACtD,KAAK,EAAE,GAAG;IACV,+DAA+D;IAC/D,WAAW,EAAE,CAAC,GAAG;IACjB,sDAAsD;IACtD,SAAS,EAAE,CAAC,GAAG;CACP,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,8CAA8C;IAC9C,IAAI,EAAE,GAAG;IACT,kDAAkD;IAClD,MAAM,EAAE,GAAG;IACX,2CAA2C;IAC3C,GAAG,EAAE,GAAG;IACR,kCAAkC;IAClC,OAAO,EAAE,GAAG;CACJ,CAAA;AA4DV;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA6C;IACtE,kBAAkB,EAAE;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,KAAK;QAClB,mBAAmB,EAAE,GAAG;KACzB;IACD,eAAe,EAAE,SAAwC;IACzD,eAAe,EAAE,IAAI;IACrB,qBAAqB,EAAE,CAAC;IACxB,0BAA0B,EAAE,GAAG;CAChC,CAAA"}

package/dist/learning/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * @fileoverview Learning Module Exports
- * @module @skillsmith/core/learning
- *
- * Exports for the recommendation learning system including:
- * - Signal collection and user preferences
- * - ReasoningBank integration for trajectory learning
- * - PatternStore with EWC++ for pattern preservation
- */
-export type { SignalType, SignalEvent, SignalFilter, SignalMetadata, RecommendationContext, DismissReason, SkillCategory, UserPreferenceProfile, LearningConfig, PersonalizedRecommendation, AggregateStats, UserDataExport, LearningEvents, } from './types.js';
-export { SIGNAL_WEIGHTS, DEFAULT_LEARNING_CONFIG, COLD_START_WEIGHTS } from './types.js';
-export type { ISignalCollector, IPreferenceLearner, IPrivacyManager, IPersonalizationEngine, IUserPreferenceRepository, } from './interfaces.js';
-export { ReasoningBankIntegration, createReasoningBankIntegration, hasConfidentVerdict, indicatesPreference, indicatesRejection, type ReasoningBankIntegrationConfig, type IntelligenceConfig, type TrajectoryStep, type TrajectoryVerdict, type SkillVerdict, type BatchVerdictResult, type IReasoningBank, TRAJECTORY_REWARDS, CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG as DEFAULT_REASONING_BANK_CONFIG, } from './ReasoningBankIntegration.js';
-export { PatternStore, createPatternStore, FisherInformationMatrix, type EWCConfig, type PatternStoreConfig, type PatternOutcomeType, type PatternOutcome, type PatternRecommendationContext, type SkillFeatures, type Pattern, type StoredPattern, type PatternQuery, type SimilarPattern, type ConsolidationResult, type PatternStoreMetrics, type IFisherInformationMatrix, DEFAULT_EWC_CONFIG, DEFAULT_PATTERN_STORE_CONFIG, PATTERN_REWARDS, } from './PatternStore.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/learning/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,0BAA0B,EAC1B,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAGxF,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,8BAA8B,EACnC,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,IAAI,6BAA6B,GAChD,MAAM,+BAA+B,CAAA;AAGtC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,4BAA4B,EAC5B,eAAe,GAChB,MAAM,mBAAmB,CAAA"}

package/dist/learning/index.js

@@ -1,15 +0,0 @@
-/**
- * @fileoverview Learning Module Exports
- * @module @skillsmith/core/learning
- *
- * Exports for the recommendation learning system including:
- * - Signal collection and user preferences
- * - ReasoningBank integration for trajectory learning
- * - PatternStore with EWC++ for pattern preservation
- */
-export { SIGNAL_WEIGHTS, DEFAULT_LEARNING_CONFIG, COLD_START_WEIGHTS } from './types.js';
-// ReasoningBank Integration (SMI-1520)
-export { ReasoningBankIntegration, createReasoningBankIntegration, hasConfidentVerdict, indicatesPreference, indicatesRejection, TRAJECTORY_REWARDS, CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG as DEFAULT_REASONING_BANK_CONFIG, } from './ReasoningBankIntegration.js';
-// PatternStore with EWC++ (SMI-1522)
-export { PatternStore, createPatternStore, FisherInformationMatrix, DEFAULT_EWC_CONFIG, DEFAULT_PATTERN_STORE_CONFIG, PATTERN_REWARDS, } from './PatternStore.js';
-//# sourceMappingURL=index.js.map

package/dist/learning/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAWxF,uCAAuC;AACvC,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAQlB,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,IAAI,6BAA6B,GAChD,MAAM,+BAA+B,CAAA;AAEtC,qCAAqC;AACrC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EAcvB,kBAAkB,EAClB,4BAA4B,EAC5B,eAAe,GAChB,MAAM,mBAAmB,CAAA"}

package/dist/learning/interfaces.d.ts

@@ -1,338 +0,0 @@
-/**
- * @fileoverview Service interfaces for Recommendation Learning Loop
- * @module @skillsmith/core/learning/interfaces
- * @see docs/phase4/epic1/recommendation-learning-loop-design.md
- *
- * Defines contracts for:
- * - SignalCollector: Recording user interactions
- * - PreferenceLearner: Learning from signals
- * - PrivacyManager: Data lifecycle management
- * - PersonalizationEngine: Applying learned preferences
- */
-import type { SignalEvent, SignalFilter, RecommendationContext, SignalMetadata, DismissReason, UserPreferenceProfile, LearningConfig, PersonalizedRecommendation, UserDataExport, AggregateStats } from './types.js';
-/**
- * Service for collecting user interaction signals
- *
- * Responsibilities:
- * - Record accept/dismiss/usage events
- * - Store signals in local SQLite database
- * - Query signals for learning algorithm
- *
- * @example
- * ```typescript
- * const collector = new SignalCollector(dbPath)
- * await collector.recordAccept('anthropic/commit', {
- *   installed_skills: ['anthropic/review-pr'],
- *   original_score: 0.85
- * })
- * ```
- */
-export interface ISignalCollector {
-    /**
-     * Record user accepting a recommendation
-     *
-     * @param skillId - Skill that was accepted
-     * @param context - Context when skill was recommended
-     * @param metadata - Optional metadata (timing, suggestion count)
-     * @throws {SkillsmithError} If database write fails
-     */
-    recordAccept(skillId: string, context: RecommendationContext, metadata?: SignalMetadata): Promise<void>;
-    /**
-     * Record user dismissing a recommendation
-     *
-     * @param skillId - Skill that was dismissed
-     * @param context - Context when skill was recommended
-     * @param reason - Optional reason for dismissal
-     * @throws {SkillsmithError} If database write fails
-     */
-    recordDismiss(skillId: string, context: RecommendationContext, reason?: DismissReason): Promise<void>;
-    /**
-     * Record skill usage event
-     *
-     * Called by usage tracker to record daily/weekly usage
-     *
-     * @param skillId - Skill that was used
-     * @param frequency - Usage frequency (daily or weekly)
-     * @throws {SkillsmithError} If database write fails
-     */
-    recordUsage(skillId: string, frequency: 'daily' | 'weekly'): Promise<void>;
-    /**
-     * Record skill abandonment (installed but never used)
-     *
-     * @param skillId - Skill that was abandoned
-     * @param daysSinceInstall - Days since installation
-     * @throws {SkillsmithError} If database write fails
-     */
-    recordAbandonment(skillId: string, daysSinceInstall: number): Promise<void>;
-    /**
-     * Record skill uninstallation
-     *
-     * @param skillId - Skill that was uninstalled
-     * @param daysSinceInstall - Days since installation
-     * @throws {SkillsmithError} If database write fails
-     */
-    recordUninstall(skillId: string, daysSinceInstall: number): Promise<void>;
-    /**
-     * Query signals with filtering
-     *
-     * @param filter - Filter criteria
-     * @param limit - Maximum results to return
-     * @returns Array of matching signal events
-     * @throws {SkillsmithError} If database query fails
-     */
-    getSignals(filter: SignalFilter, limit?: number): Promise<SignalEvent[]>;
-    /**
-     * Get total signal count
-     *
-     * @returns Total number of signals recorded
-     */
-    getSignalCount(): Promise<number>;
-    /**
-     * Get signals for specific skill
-     *
-     * @param skillId - Skill identifier
-     * @returns All signals for this skill
-     */
-    getSignalsForSkill(skillId: string): Promise<SignalEvent[]>;
-}
-/**
- * Service for learning user preferences from signals
- *
- * Responsibilities:
- * - Update preference weights based on signals
- * - Apply time decay to old signals
- * - Maintain weight bounds
- * - Calculate personalized scores
- *
- * @example
- * ```typescript
- * const learner = new PreferenceLearner(config)
- * const updatedProfile = await learner.updateProfile(
- *   currentProfile,
- *   newSignalEvent
- * )
- * ```
- */
-export interface IPreferenceLearner {
-    /**
-     * Update user profile based on new signal
-     *
-     * Applies learning algorithm to adjust weights:
-     * - Category weights
-     * - Trust tier weights
-     * - Keyword weights
-     * - Negative patterns
-     *
-     * @param profile - Current user profile
-     * @param signal - New signal event to learn from
-     * @returns Updated profile with adjusted weights
-     */
-    updateProfile(profile: UserPreferenceProfile, signal: SignalEvent): Promise<UserPreferenceProfile>;
-    /**
-     * Batch update profile from multiple signals
-     *
-     * More efficient than individual updates for bulk processing
-     *
-     * @param profile - Current user profile
-     * @param signals - Array of signal events
-     * @returns Updated profile
-     */
-    batchUpdateProfile(profile: UserPreferenceProfile, signals: SignalEvent[]): Promise<UserPreferenceProfile>;
-    /**
-     * Apply time decay to weights
-     *
-     * Reduces influence of old signals to allow preference evolution
-     *
-     * @param profile - Current user profile
-     * @param decayFactor - Decay multiplier (0.8-1.0)
-     * @returns Profile with decayed weights
-     */
-    decayWeights(profile: UserPreferenceProfile, decayFactor?: number): Promise<UserPreferenceProfile>;
-    /**
-     * Calculate personalized score for a skill
-     *
-     * @param skillData - Skill metadata (category, keywords, etc.)
-     * @param baseScore - Base recommendation score [0-1]
-     * @param profile - User preference profile
-     * @returns Personalized recommendation with score breakdown
-     */
-    calculatePersonalizedScore(skillData: {
-        id: string;
-        category?: string;
-        trustTier?: string;
-        keywords?: string[];
-        triggerPhrases?: string[];
-    }, baseScore: number, profile: UserPreferenceProfile): PersonalizedRecommendation;
-    /**
-     * Get learning configuration
-     */
-    getConfig(): LearningConfig;
-    /**
-     * Update learning configuration
-     *
-     * @param config - Partial config to merge
-     */
-    setConfig(config: Partial<LearningConfig>): void;
-}
-/**
- * Service for managing data privacy and lifecycle
- *
- * Responsibilities:
- * - Purge old signals (retention policy)
- * - Export user data (GDPR compliance)
- * - Complete data wipe
- * - Anonymize for analytics
- *
- * @example
- * ```typescript
- * const privacy = new PrivacyManager(dbPath)
- * const deleted = await privacy.purgeOldSignals(90) // 90 day retention
- * console.log(`Deleted ${deleted} old signals`)
- * ```
- */
-export interface IPrivacyManager {
-    /**
-     * Purge signals older than retention period
-     *
-     * @param retentionDays - Keep signals from last N days
-     * @returns Number of signals deleted
-     * @throws {SkillsmithError} If database operation fails
-     */
-    purgeOldSignals(retentionDays: number): Promise<number>;
-    /**
-     * Export all user data (GDPR-style)
-     *
-     * Includes:
-     * - User preference profile
-     * - All signal events
-     * - Aggregate statistics
-     *
-     * @returns Complete user data export
-     * @throws {SkillsmithError} If export fails
-     */
-    exportUserData(): Promise<UserDataExport>;
-    /**
-     * Complete data wipe (user request)
-     *
-     * Deletes:
-     * - All signals
-     * - User profile
-     * - Aggregate stats
-     *
-     * @returns Number of records deleted
-     * @throws {SkillsmithError} If wipe fails
-     */
-    wipeAllData(): Promise<number>;
-    /**
-     * Anonymize signals for aggregate analysis
-     *
-     * Strips all PII and creates aggregate statistics
-     *
-     * @returns Anonymized aggregate stats
-     */
-    anonymizeForAnalytics(): Promise<AggregateStats>;
-    /**
-     * Get current storage size
-     *
-     * @returns Database size in bytes
-     */
-    getStorageSize(): Promise<number>;
-    /**
-     * Verify no data leaks (for testing)
-     *
-     * Checks that no PII is in aggregate tables
-     *
-     * @returns True if privacy-preserving
-     */
-    verifyPrivacy(): Promise<boolean>;
-}
-/**
- * Service for applying personalization to recommendations
- *
- * Responsibilities:
- * - Load user profile
- * - Apply personalized scoring
- * - Handle cold start
- * - Re-rank recommendations
- *
- * @example
- * ```typescript
- * const engine = new PersonalizationEngine(learner, profileStore)
- * const personalized = await engine.personalizeRecommendations(
- *   baseRecommendations,
- *   userContext
- * )
- * ```
- */
-export interface IPersonalizationEngine {
-    /**
-     * Personalize recommendation results
-     *
-     * @param baseRecommendations - Recommendations with base scores
-     * @param userId - User identifier (for profile lookup)
-     * @returns Re-ranked recommendations with personalized scores
-     */
-    personalizeRecommendations(baseRecommendations: Array<{
-        skill_id: string;
-        base_score: number;
-        skill_data: {
-            category?: string;
-            trustTier?: string;
-            keywords?: string[];
-        };
-    }>, userId?: string): Promise<PersonalizedRecommendation[]>;
-    /**
-     * Check if user has enough data for personalization
-     *
-     * @param userId - User identifier
-     * @returns True if personalization should be applied
-     */
-    shouldPersonalize(userId?: string): Promise<boolean>;
-    /**
-     * Get user preference profile
-     *
-     * @param userId - User identifier
-     * @returns User profile or default cold start profile
-     */
-    getUserProfile(userId?: string): Promise<UserPreferenceProfile>;
-    /**
-     * Reset to cold start (clear personalization)
-     *
-     * @param userId - User identifier
-     */
-    resetToDefault(userId?: string): Promise<void>;
-}
-/**
- * Repository interface for user preference storage
- *
- * Abstraction over SQLite for testability
- */
-export interface IUserPreferenceRepository {
-    /**
-     * Get user preference profile
-     *
-     * @param userId - User identifier (default: 'default')
-     * @returns Profile or null if not exists
-     */
-    getProfile(userId?: string): Promise<UserPreferenceProfile | null>;
-    /**
-     * Save user preference profile
-     *
-     * @param profile - Profile to save
-     * @param userId - User identifier (default: 'default')
-     */
-    saveProfile(profile: UserPreferenceProfile, userId?: string): Promise<void>;
-    /**
-     * Delete user profile
-     *
-     * @param userId - User identifier
-     */
-    deleteProfile(userId?: string): Promise<void>;
-    /**
-     * Check if profile exists
-     *
-     * @param userId - User identifier
-     */
-    exists(userId?: string): Promise<boolean>;
-}
-//# sourceMappingURL=interfaces.d.ts.map

package/dist/learning/interfaces.d.ts.map

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

package/dist/learning/interfaces.js

@@ -1,13 +0,0 @@
-/**
- * @fileoverview Service interfaces for Recommendation Learning Loop
- * @module @skillsmith/core/learning/interfaces
- * @see docs/phase4/epic1/recommendation-learning-loop-design.md
- *
- * Defines contracts for:
- * - SignalCollector: Recording user interactions
- * - PreferenceLearner: Learning from signals
- * - PrivacyManager: Data lifecycle management
- * - PersonalizationEngine: Applying learned preferences
- */
-export {};
-//# sourceMappingURL=interfaces.js.map

package/dist/learning/interfaces.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/learning/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}