@skillsmith/core 2.1.0 → 2.1.2

package/dist/src/learning/index.js

@@ -0,0 +1,15 @@
+/**
+ * @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/src/learning/index.js.map

@@ -0,0 +1 @@
+{"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/src/routing/SONARouter.d.ts

@@ -0,0 +1,154 @@
+/**
+ * @fileoverview SONARouter - Specialized Optimized Network Architecture Router
+ * @module @skillsmith/core/routing/SONARouter
+ * @see SMI-1521: SONA routing for MCP tool optimization
+ *
+ * Routes MCP tool requests through an 8-expert MoE (Mixture of Experts)
+ * network to optimize tool execution based on accuracy requirements,
+ * latency constraints, and load distribution.
+ *
+ * Features:
+ * - O(1) routing decisions with LRU caching
+ * - V3 MoE integration with fallback to local scoring
+ * - Adaptive load balancing across experts
+ * - Health monitoring and circuit breaker patterns
+ * - Feature flags for gradual rollout
+ * - Prometheus-compatible metrics
+ *
+ * Performance targets:
+ * - 2.8-4.4x speed improvement
+ * - <5ms routing overhead (P95)
+ * - >60% cache hit rate
+ *
+ * @example
+ * ```typescript
+ * const router = new SONARouter()
+ * await router.initialize()
+ *
+ * const decision = await router.route({
+ *   requestId: 'req-123',
+ *   tool: 'search',
+ *   arguments: { query: 'testing skills' },
+ *   timestamp: new Date(),
+ * })
+ *
+ * console.log(decision.expertId) // 'accuracy-semantic'
+ * console.log(decision.confidence) // 0.92
+ * ```
+ */
+import type { ExpertDefinition, ExpertId, ExpertState, ExpertStatus, RoutingDecision, SONAMetrics, SONARouterConfig, ToolRequest, ToolResponse, ToolType } from './types.js';
+/**
+ * SONARouter routes MCP tool requests through an 8-expert MoE network.
+ *
+ * The router uses a weighted scoring algorithm to select the optimal expert
+ * for each request based on tool-specific weight profiles and real-time
+ * expert health/load status.
+ *
+ * When V3 MoE integration is enabled, it leverages Claude-Flow's neural
+ * routing for improved accuracy. Otherwise, it uses the local scoring algorithm.
+ */
+export declare class SONARouter {
+    private config;
+    private experts;
+    private expertStatus;
+    private cache;
+    private metrics;
+    private v3MoE;
+    private v3SONA;
+    private initialized;
+    private healthCheckInterval;
+    /**
+     * Create a new SONARouter instance.
+     *
+     * @param config - Router configuration
+     */
+    constructor(config?: SONARouterConfig);
+    /**
+     * Initialize the router with V3 MoE integration.
+     *
+     * Attempts to load V3 MoERouter and SONAOptimizer.
+     * Falls back to local scoring if V3 is unavailable.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if router is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Check if V3 MoE is being used
+     */
+    isUsingV3MoE(): boolean;
+    /**
+     * Shutdown the router and cleanup resources
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Route a tool request to the optimal expert.
+     *
+     * @param request - Tool request to route
+     * @returns Routing decision with selected expert and confidence
+     */
+    route(request: ToolRequest): Promise<RoutingDecision>;
+    /**
+     * Execute a tool request with SONA routing.
+     *
+     * Routes the request, executes via the selected expert, and records outcome.
+     *
+     * @param request - Tool request to execute
+     * @param executor - Function to execute the tool with given expert
+     * @returns Tool response with execution metadata
+     */
+    executeWithRouting<T>(request: ToolRequest, executor: (expertId: ExpertId, request: ToolRequest) => Promise<T>): Promise<ToolResponse<T>>;
+    /**
+     * Get current status of all experts
+     */
+    getExpertStatus(): ExpertStatus[];
+    /**
+     * Get status of a specific expert
+     */
+    getExpert(expertId: ExpertId): ExpertDefinition | undefined;
+    /**
+     * Update expert health status
+     */
+    updateExpertHealth(expertId: ExpertId, state: ExpertState, load?: number): void;
+    /**
+     * Get current routing metrics
+     */
+    getMetrics(): Partial<SONAMetrics>;
+    /**
+     * Reset metrics
+     */
+    resetMetrics(): void;
+    private ensureInitialized;
+    private createInitialStatus;
+    private initializeV3MoE;
+    private startHealthChecks;
+    private runHealthChecks;
+    private generateCacheKey;
+    private hashObject;
+    private getEligibleExperts;
+    private scoreExperts;
+    private calculateScores;
+    private selectBestExpert;
+    private generateDecisionReason;
+    private generateAlternativeReason;
+    private createFallbackDecision;
+    private recordOutcome;
+}
+/**
+ * Create and initialize a SONARouter instance
+ */
+export declare function createSONARouter(config?: SONARouterConfig): Promise<SONARouter>;
+/**
+ * Check if SONA routing should be used for a request
+ */
+export declare function shouldUseSONARouting(tool: ToolType, featureFlags: Record<string, boolean | number>, userTier?: string): boolean;
+/**
+ * Check if a routing decision indicates high confidence
+ */
+export declare function isHighConfidenceDecision(decision: RoutingDecision): boolean;
+/**
+ * Check if a routing decision used fallback
+ */
+export declare function usedFallback(decision: RoutingDecision): boolean;
+//# sourceMappingURL=SONARouter.d.ts.map

package/dist/src/routing/SONARouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SONARouter.d.ts","sourceRoot":"","sources":["../../../src/routing/SONARouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,eAAe,EAEf,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,QAAQ,EAET,MAAM,YAAY,CAAA;AAgNnB;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAuE;IACrF,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,mBAAmB,CAA8C;IAEzE;;;;OAIG;gBACS,MAAM,GAAE,gBAAqB;IA2BzC;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/B;;;;;OAKG;IACG,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAqC3D;;;;;;;;OAQG;IACG,kBAAkB,CAAC,CAAC,EACxB,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACjE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAkF3B;;OAEG;IACH,eAAe,IAAI,YAAY,EAAE;IAIjC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS;IAI3D;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAe/E;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAIlC;;OAEG;IACH,YAAY,IAAI,IAAI;IAQpB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,mBAAmB;YAYb,eAAe;IAwB7B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,eAAe;IAgDvB,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,sBAAsB;IAuB9B,OAAO,CAAC,aAAa;CAuBtB;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAIrF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,EAC9C,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAqBT;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAE/D"}