@skillsmith/core 0.4.0 → 0.4.2

package/dist/src/learning/PatternStore.types.d.ts

@@ -0,0 +1,308 @@
+/**
+ * @fileoverview PatternStore type definitions and constants
+ * @module @skillsmith/core/learning/PatternStore.types
+ *
+ * Types for EWC++ (Elastic Weight Consolidation++) pattern storage.
+ */
+/**
+ * EWC++ algorithm configuration
+ *
+ * @see https://arxiv.org/abs/1801.10112 (Progress & Compress)
+ */
+export interface EWCConfig {
+    /**
+     * Lambda (regularization strength).
+     * Higher values = stronger preservation of old patterns.
+     *
+     * - 0.1-1.0: Allows more plasticity (learning new patterns)
+     * - 1.0-10.0: Balanced preservation and learning
+     * - 10.0-100.0: Strong preservation (minimal forgetting)
+     *
+     * @default 5.0
+     */
+    lambda: number;
+    /**
+     * Decay factor for online Fisher Information updates.
+     * Applied to running sum before adding new gradient squared.
+     *
+     * - 0.9: Fast decay, recent patterns dominate
+     * - 0.99: Slow decay, historical patterns preserved longer
+     * - 1.0: No decay (original EWC, not recommended)
+     *
+     * @default 0.95
+     */
+    fisherDecay: number;
+    /**
+     * Minimum importance threshold for pattern preservation.
+     * Patterns below this threshold are eligible for overwriting.
+     *
+     * @default 0.01
+     */
+    importanceThreshold: number;
+    /**
+     * Number of patterns to sample for Fisher Information estimation.
+     * Higher values = more accurate importance estimates but slower.
+     *
+     * @default 100
+     */
+    fisherSampleSize: number;
+    /**
+     * Consolidation trigger threshold.
+     * Consolidate when (new_patterns / total_patterns) exceeds this.
+     *
+     * @default 0.1 (10%)
+     */
+    consolidationThreshold: number;
+    /**
+     * Maximum patterns to retain before pruning low-importance ones.
+     *
+     * @default 10000
+     */
+    maxPatterns: number;
+}
+/**
+ * PatternStore configuration
+ */
+export interface PatternStoreConfig {
+    /**
+     * Path to SQLite database for pattern storage.
+     * If not provided, uses in-memory database.
+     */
+    dbPath?: string;
+    /**
+     * EWC++ algorithm parameters.
+     */
+    ewc?: Partial<EWCConfig>;
+    /**
+     * Embedding dimensions (must match embedding model).
+     * @default 384 (all-MiniLM-L6-v2)
+     */
+    dimensions?: number;
+    /**
+     * Enable automatic consolidation on pattern insertion.
+     * @default true
+     */
+    autoConsolidate?: boolean;
+    /**
+     * Enable pattern access tracking for importance boosting.
+     * @default true
+     */
+    trackAccess?: boolean;
+    /**
+     * Enable V3 ReasoningBank integration.
+     * @default true (auto-detect)
+     */
+    useV3Integration?: boolean;
+}
+/**
+ * Default EWC++ configuration
+ */
+export declare const DEFAULT_EWC_CONFIG: EWCConfig;
+/**
+ * Default PatternStore configuration
+ */
+export declare const DEFAULT_PATTERN_STORE_CONFIG: Required<Omit<PatternStoreConfig, 'dbPath'>> & {
+    dbPath?: string;
+};
+/**
+ * Pattern outcome types aligned with ReasoningBankIntegration rewards
+ *
+ * @see ReasoningBankIntegration.TRAJECTORY_REWARDS
+ */
+export type PatternOutcomeType = 'accept' | 'usage' | 'frequent' | 'dismiss' | 'abandonment' | 'uninstall';
+/**
+ * Outcome result for a pattern
+ */
+export interface PatternOutcome {
+    /** Type of outcome */
+    type: PatternOutcomeType;
+    /** Reward value [-1.0, 1.0] */
+    reward: number;
+    /** Confidence in this outcome (for partial observations) */
+    confidence?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Reward values for pattern outcomes
+ * Matches ReasoningBankIntegration.TRAJECTORY_REWARDS
+ */
+export declare const PATTERN_REWARDS: Record<PatternOutcomeType, number>;
+/**
+ * Context that led to a recommendation
+ */
+export interface PatternRecommendationContext {
+    /** User's current installed skills */
+    installedSkills: string[];
+    /** Frameworks/languages detected in project */
+    frameworks?: string[];
+    /** Keywords from user query or context */
+    keywords?: string[];
+    /** Time of day (for temporal patterns) */
+    timeOfDay?: 'morning' | 'afternoon' | 'evening' | 'night';
+    /** Day type (for usage patterns) */
+    dayType?: 'weekday' | 'weekend';
+    /** Session duration in minutes */
+    sessionDuration?: number;
+    /** Number of recommendations shown in session */
+    recommendationsShown?: number;
+}
+/**
+ * Skill features used in pattern matching
+ */
+export interface SkillFeatures {
+    /** Skill identifier (author/name format) */
+    skillId: string;
+    /** Skill category */
+    category?: string;
+    /** Trust tier (verified, community, experimental) */
+    trustTier?: string;
+    /** Skill keywords/tags */
+    keywords?: string[];
+    /** Trigger phrases */
+    triggerPhrases?: string[];
+    /** Quality score [0-100] */
+    qualityScore?: number;
+    /** Install count */
+    installCount?: number;
+}
+/**
+ * Complete pattern definition
+ */
+export interface Pattern {
+    /** Unique pattern identifier (auto-generated if not provided) */
+    id?: string;
+    /** Recommendation context that led to this match */
+    context: PatternRecommendationContext;
+    /** Skill that was recommended */
+    skill: SkillFeatures;
+    /** Original recommendation score [0-1] */
+    originalScore: number;
+    /** Source of the recommendation (search, recommend, install) */
+    source: 'search' | 'recommend' | 'install' | 'compare';
+}
+/**
+ * Stored pattern with computed fields
+ */
+export interface StoredPattern extends Pattern {
+    /** Pattern ID (guaranteed after storage) */
+    id: string;
+    /** Context embedding vector */
+    contextEmbedding: Float32Array;
+    /** Pattern outcome */
+    outcome: PatternOutcome;
+    /** Pattern importance (from Fisher Information) */
+    importance: number;
+    /** Number of times this pattern was accessed */
+    accessCount: number;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last access timestamp */
+    lastAccessedAt: Date;
+}
+/**
+ * Pattern query for similarity search
+ */
+export interface PatternQuery {
+    /** Context to match against */
+    context: PatternRecommendationContext;
+    /** Optional skill to filter by */
+    skillId?: string;
+    /** Optional category filter */
+    category?: string;
+    /** Minimum importance threshold */
+    minImportance?: number;
+    /** Outcome type filter */
+    outcomeType?: PatternOutcomeType;
+    /** Only positive outcomes (accept, usage, frequent) */
+    positiveOnly?: boolean;
+}
+/**
+ * Similar pattern result
+ */
+export interface SimilarPattern {
+    /** The matched pattern */
+    pattern: StoredPattern;
+    /** Similarity score [0-1] */
+    similarity: number;
+    /** Importance-weighted similarity */
+    weightedSimilarity: number;
+    /** Rank in results */
+    rank: number;
+}
+/**
+ * Consolidation operation result
+ */
+export interface ConsolidationResult {
+    /** Whether consolidation was performed */
+    consolidated: boolean;
+    /** Patterns processed during consolidation */
+    patternsProcessed: number;
+    /** Patterns preserved (importance above threshold) */
+    patternsPreserved: number;
+    /** Patterns pruned (importance below threshold) */
+    patternsPruned: number;
+    /** Preservation rate (should be >= 0.95) */
+    preservationRate: number;
+    /** Time taken in milliseconds */
+    durationMs: number;
+    /** New average importance after consolidation */
+    averageImportance: number;
+}
+/**
+ * PatternStore metrics for monitoring
+ */
+export interface PatternStoreMetrics {
+    /** Total patterns stored */
+    totalPatterns: number;
+    /** Patterns by outcome type */
+    patternsByOutcome: Record<PatternOutcomeType, number>;
+    /** Average pattern importance */
+    averageImportance: number;
+    /** High importance patterns (above 90th percentile) */
+    highImportancePatterns: number;
+    /** Consolidation statistics */
+    consolidation: {
+        totalConsolidations: number;
+        lastConsolidation: Date | null;
+        averagePreservationRate: number;
+        patternsPruned: number;
+    };
+    /** Storage statistics */
+    storage: {
+        sizeBytes: number;
+        fisherMatrixSizeBytes: number;
+    };
+    /** Query performance */
+    queryPerformance: {
+        averageLatencyMs: number;
+        queriesPerformed: number;
+    };
+}
+/**
+ * Internal consolidation state
+ */
+export interface ConsolidationState {
+    lastConsolidation: Date | null;
+    patternsSinceLastConsolidation: number;
+    totalPatterns: number;
+}
+/**
+ * Database row type for pattern queries
+ */
+export interface PatternRow {
+    pattern_id: string;
+    context_embedding: Buffer;
+    skill_id: string;
+    skill_features: string;
+    context_data: string;
+    outcome_type: string;
+    outcome_reward: number;
+    importance: number;
+    original_score: number;
+    source: string;
+    access_count: number;
+    created_at: number;
+    last_accessed_at: number;
+}
+//# sourceMappingURL=PatternStore.types.d.ts.map

package/dist/src/learning/PatternStore.types.d.ts.map

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

package/dist/src/learning/PatternStore.types.js

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview PatternStore type definitions and constants
+ * @module @skillsmith/core/learning/PatternStore.types
+ *
+ * Types for EWC++ (Elastic Weight Consolidation++) pattern storage.
+ */
+// ============================================================================
+// Default Configuration Constants
+// ============================================================================
+/**
+ * Default EWC++ configuration
+ */
+export const DEFAULT_EWC_CONFIG = {
+    lambda: 5.0,
+    fisherDecay: 0.95,
+    importanceThreshold: 0.01,
+    fisherSampleSize: 100,
+    consolidationThreshold: 0.1,
+    maxPatterns: 10000,
+};
+/**
+ * Default PatternStore configuration
+ */
+export const DEFAULT_PATTERN_STORE_CONFIG = {
+    dbPath: undefined,
+    ewc: DEFAULT_EWC_CONFIG,
+    dimensions: 384,
+    autoConsolidate: true,
+    trackAccess: true,
+    useV3Integration: true,
+};
+/**
+ * Reward values for pattern outcomes
+ * Matches ReasoningBankIntegration.TRAJECTORY_REWARDS
+ */
+export const PATTERN_REWARDS = {
+    accept: 1.0,
+    usage: 0.3,
+    frequent: 0.5,
+    dismiss: -0.5,
+    abandonment: -0.3,
+    uninstall: -0.7,
+};
+//# sourceMappingURL=PatternStore.types.js.map

package/dist/src/learning/PatternStore.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternStore.types.js","sourceRoot":"","sources":["../../../src/learning/PatternStore.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4GH,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,MAAM,EAAE,GAAG;IACX,WAAW,EAAE,IAAI;IACjB,mBAAmB,EAAE,IAAI;IACzB,gBAAgB,EAAE,GAAG;IACrB,sBAAsB,EAAE,GAAG;IAC3B,WAAW,EAAE,KAAK;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAErC;IACF,MAAM,EAAE,SAAS;IACjB,GAAG,EAAE,kBAAkB;IACvB,UAAU,EAAE,GAAG;IACf,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,IAAI;IACjB,gBAAgB,EAAE,IAAI;CACvB,CAAA;AAoCD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAuC;IACjE,MAAM,EAAE,GAAG;IACX,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,CAAC,GAAG;IACb,WAAW,EAAE,CAAC,GAAG;IACjB,SAAS,EAAE,CAAC,GAAG;CAChB,CAAA"}