specmem-hardwicksoftware 3.5.99

package/dist/events/config.js

@@ -0,0 +1,266 @@
+/**
+ * config.ts - Event Bus Configuration System
+ *
+ * Adapted from Hippo's LWJEB BusConfigurations pattern
+ * (https://github.com/Hippo/LWJEB)
+ *
+ * Provides configuration management equivalent to:
+ * - BusConfiguration
+ * - BusPubSubConfiguration
+ * - AsynchronousPublicationConfiguration
+ * - ExceptionHandlingConfiguration
+ *
+ * @author hardwicksoftwareservices
+ */
+import { logger } from '../utils/logger.js';
+/**
+ * Default exception handler - logs errors
+ */
+export const defaultExceptionHandler = (error, context) => {
+    logger.error({ error, ...context }, 'event bus exception');
+};
+/**
+ * Get default configuration
+ * Equivalent to LWJEB's BusConfigurations.getDefault()
+ */
+export function getDefaultConfiguration() {
+    return {
+        identifier: 'LWJEB-TS',
+        dispatcherCount: 3,
+        daemonMode: true,
+        suppressDispatcherInterrupt: true,
+        cacheEnabled: true,
+        maxCacheSize: 1000, // reduced from 10000 to save RAM
+        maxQueueSize: 5000, // reduced from 100000 to save RAM
+        maxLatencyMs: 25, // Sub-25ms target as per requirements
+        exceptionHandler: defaultExceptionHandler
+    };
+}
+/**
+ * Configuration builder pattern
+ * Equivalent to LWJEB's BusConfigurations.Builder
+ */
+export class EventBusConfigurationBuilder {
+    config;
+    constructor() {
+        this.config = getDefaultConfiguration();
+    }
+    /**
+     * Set bus identifier
+     */
+    identifier(id) {
+        this.config.identifier = id;
+        return this;
+    }
+    /**
+     * Set dispatcher count
+     */
+    dispatchers(count) {
+        if (count < 1) {
+            throw new Error('dispatcher count must be at least 1');
+        }
+        this.config.dispatcherCount = count;
+        return this;
+    }
+    /**
+     * Enable/disable daemon mode
+     */
+    daemon(enabled) {
+        this.config.daemonMode = enabled;
+        return this;
+    }
+    /**
+     * Enable/disable caching
+     */
+    caching(enabled) {
+        this.config.cacheEnabled = enabled;
+        return this;
+    }
+    /**
+     * Set maximum cache size
+     */
+    maxCache(size) {
+        if (size < 0) {
+            throw new Error('cache size must be non-negative');
+        }
+        this.config.maxCacheSize = size;
+        return this;
+    }
+    /**
+     * Set maximum queue size
+     */
+    maxQueue(size) {
+        if (size < 1) {
+            throw new Error('queue size must be at least 1');
+        }
+        this.config.maxQueueSize = size;
+        return this;
+    }
+    /**
+     * Set latency target (for warnings)
+     */
+    latencyTarget(ms) {
+        if (ms < 1) {
+            throw new Error('latency target must be at least 1ms');
+        }
+        this.config.maxLatencyMs = ms;
+        return this;
+    }
+    /**
+     * Set exception handler
+     */
+    onException(handler) {
+        this.config.exceptionHandler = handler;
+        return this;
+    }
+    /**
+     * Build the configuration
+     */
+    build() {
+        return { ...this.config };
+    }
+}
+/**
+ * Create a configuration builder
+ */
+export function configBuilder() {
+    return new EventBusConfigurationBuilder();
+}
+/**
+ * Predefined configuration profiles
+ * Equivalent to common LWJEB use cases
+ */
+export const ConfigProfiles = {
+    /**
+     * High performance configuration
+     * Optimized for sub-10ms latency
+     */
+    highPerformance() {
+        return configBuilder()
+            .identifier('high-perf')
+            .dispatchers(5)
+            .daemon(true)
+            .caching(true)
+            .maxCache(50000)
+            .maxQueue(500000)
+            .latencyTarget(10)
+            .build();
+    },
+    /**
+     * Memory efficient configuration
+     * Reduced cache/queue sizes
+     */
+    memoryEfficient() {
+        return configBuilder()
+            .identifier('mem-efficient')
+            .dispatchers(2)
+            .daemon(true)
+            .caching(true)
+            .maxCache(1000)
+            .maxQueue(10000)
+            .latencyTarget(50)
+            .build();
+    },
+    /**
+     * Debug configuration
+     * Verbose logging, strict latency
+     */
+    debug() {
+        return configBuilder()
+            .identifier('debug')
+            .dispatchers(1)
+            .daemon(false)
+            .caching(false)
+            .maxCache(100)
+            .maxQueue(1000)
+            .latencyTarget(100)
+            .onException((error, context) => {
+            logger.error({ error, ...context }, '[DEBUG] event bus exception');
+            // In debug mode, also log stack trace
+            if (error.stack) {
+                logger.debug({ stack: error.stack }, 'stack trace');
+            }
+        })
+            .build();
+    },
+    /**
+     * MCP optimized configuration
+     * Balanced for MCP tool integration
+     */
+    mcpOptimized() {
+        return configBuilder()
+            .identifier('specmem-mcp')
+            .dispatchers(3)
+            .daemon(true)
+            .caching(true)
+            .maxCache(10000)
+            .maxQueue(50000)
+            .latencyTarget(25) // Sub-25ms as per requirements
+            .build();
+    }
+};
+/**
+ * Load configuration from environment variables
+ */
+export function loadConfigFromEnv() {
+    const config = {};
+    const identifier = process.env['SPECMEM_EVENT_BUS_ID'];
+    if (identifier) {
+        config.identifier = identifier;
+    }
+    const dispatchers = process.env['SPECMEM_EVENT_DISPATCHERS'];
+    if (dispatchers) {
+        config.dispatcherCount = parseInt(dispatchers, 10);
+    }
+    const cacheEnabled = process.env['SPECMEM_EVENT_CACHE_ENABLED'];
+    if (cacheEnabled !== undefined) {
+        config.cacheEnabled = cacheEnabled.toLowerCase() === 'true';
+    }
+    const maxCache = process.env['SPECMEM_EVENT_MAX_CACHE'];
+    if (maxCache) {
+        config.maxCacheSize = parseInt(maxCache, 10);
+    }
+    const maxQueue = process.env['SPECMEM_EVENT_MAX_QUEUE'];
+    if (maxQueue) {
+        config.maxQueueSize = parseInt(maxQueue, 10);
+    }
+    const latencyTarget = process.env['SPECMEM_EVENT_LATENCY_TARGET'];
+    if (latencyTarget) {
+        config.maxLatencyMs = parseInt(latencyTarget, 10);
+    }
+    return config;
+}
+/**
+ * Validate configuration
+ */
+export function validateConfiguration(config) {
+    const errors = [];
+    if (!config.identifier || config.identifier.trim() === '') {
+        errors.push('identifier is required');
+    }
+    if (config.dispatcherCount < 1) {
+        errors.push('dispatcherCount must be at least 1');
+    }
+    if (config.maxCacheSize < 0) {
+        errors.push('maxCacheSize must be non-negative');
+    }
+    if (config.maxQueueSize < 1) {
+        errors.push('maxQueueSize must be at least 1');
+    }
+    if (config.maxLatencyMs < 1) {
+        errors.push('maxLatencyMs must be at least 1');
+    }
+    return errors;
+}
+/**
+ * Merge configurations with validation
+ */
+export function mergeConfigurations(base, override) {
+    const merged = { ...base, ...override };
+    const errors = validateConfiguration(merged);
+    if (errors.length > 0) {
+        throw new Error(`Invalid configuration: ${errors.join(', ')}`);
+    }
+    return merged;
+}
+//# sourceMappingURL=config.js.map

package/dist/events/config.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * events/index.ts - LWJEB-inspired Event Bus System
+ *
+ * TypeScript adaptation of Hippo's LWJEB (https://github.com/Hippo/LWJEB)
+ * Optimized for SpecMem MCP with sub-25ms dispatch latency target.
+ *
+ * Key Features:
+ * - PubSub pattern with result caching
+ * - Async dispatcher queues
+ * - Performance metrics tracking
+ * - MCP tool integration
+ *
+ * @author hardwicksoftwareservices
+ */
+export { EventPublisher, createPublisher, getGlobalPublisher, resetGlobalPublisher, MessageHandler, RegisteredHandler, PublicationResult, DispatchResult, DeadPublicationResult, StandardPublicationResult } from './Publisher.js';
+export { EventBusConfiguration, ExceptionHandler, defaultExceptionHandler, getDefaultConfiguration, EventBusConfigurationBuilder, configBuilder, ConfigProfiles, loadConfigFromEnv, validateConfiguration, mergeConfigurations } from './config.js';
+export { PerformanceMetrics, MetricStats, LatencyPercentiles, createMetrics, MetricsAggregator, AggregatedMetricStats, LatencyHealthReport, getGlobalAggregator, resetGlobalAggregator, formatMetricStats } from './metrics.js';
+export { BaseEvent, ToolExecutionStartEvent, ToolExecutionCompleteEvent, MemoryStoredEvent, MemoryRetrievedEvent, MemoryDeletedEvent, CacheEvent, PerformanceAlertEvent, SystemEvent, SpecMemEvent, MCPEventBus, getMCPEventBus, resetMCPEventBus, wrapToolWithEvents, createMemoryEventHelpers, publishEvent, subscribeToEvent, emitStartup, emitShutdown, emitError, setupPerformanceMonitoring } from './integration.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,SAAS,EACT,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,YAAY,EAGZ,WAAW,EACX,cAAc,EACd,gBAAgB,EAGhB,kBAAkB,EAClB,wBAAwB,EAGxB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,SAAS,EAGT,0BAA0B,EAC3B,MAAM,kBAAkB,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,31 @@
+/**
+ * events/index.ts - LWJEB-inspired Event Bus System
+ *
+ * TypeScript adaptation of Hippo's LWJEB (https://github.com/Hippo/LWJEB)
+ * Optimized for SpecMem MCP with sub-25ms dispatch latency target.
+ *
+ * Key Features:
+ * - PubSub pattern with result caching
+ * - Async dispatcher queues
+ * - Performance metrics tracking
+ * - MCP tool integration
+ *
+ * @author hardwicksoftwareservices
+ */
+// Publisher exports
+export { EventPublisher, createPublisher, getGlobalPublisher, resetGlobalPublisher, DeadPublicationResult, StandardPublicationResult } from './Publisher.js';
+// Configuration exports
+export { defaultExceptionHandler, getDefaultConfiguration, EventBusConfigurationBuilder, configBuilder, ConfigProfiles, loadConfigFromEnv, validateConfiguration, mergeConfigurations } from './config.js';
+// Metrics exports
+export { createMetrics, MetricsAggregator, getGlobalAggregator, resetGlobalAggregator, formatMetricStats } from './metrics.js';
+// Integration exports
+export { 
+// Event bus
+MCPEventBus, getMCPEventBus, resetMCPEventBus, 
+// Tool integration
+wrapToolWithEvents, createMemoryEventHelpers, 
+// Convenience functions
+publishEvent, subscribeToEvent, emitStartup, emitShutdown, emitError, 
+// Performance monitoring
+setupPerformanceMonitoring } from './integration.js';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EAKpB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,wBAAwB;AACxB,OAAO,EAGL,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB,kBAAkB;AAClB,OAAO,EAIL,aAAa,EACb,iBAAiB,EAGjB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAEtB,sBAAsB;AACtB,OAAO;AAaL,YAAY;AACZ,WAAW,EACX,cAAc,EACd,gBAAgB;AAEhB,mBAAmB;AACnB,kBAAkB,EAClB,wBAAwB;AAExB,wBAAwB;AACxB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,SAAS;AAET,yBAAyB;AACzB,0BAA0B,EAC3B,MAAM,kBAAkB,CAAC"}

package/dist/events/integration.d.ts

@@ -0,0 +1,206 @@
+/**
+ * integration.ts - MCP Tool Integration for Event Bus
+ *
+ * Provides seamless integration between the LWJEB-inspired event bus
+ * and SpecMem's MCP tool ecosystem.
+ *
+ * Features:
+ * - Tool execution events (before/after hooks)
+ * - Memory operation events
+ * - Performance monitoring integration
+ * - Easy subscription patterns for MCP tools
+ *
+ * @author hardwicksoftwareservices
+ */
+import { MessageHandler, DispatchResult } from './Publisher.js';
+import { EventBusConfiguration } from './config.js';
+import { MCPTool } from '../mcp/toolRegistry.js';
+/**
+ * Base event interface
+ */
+export interface BaseEvent {
+    type: string;
+    timestamp: number;
+    source: string;
+}
+/**
+ * Tool execution started event
+ */
+export interface ToolExecutionStartEvent extends BaseEvent {
+    type: 'tool:execution:start';
+    toolName: string;
+    params: unknown;
+}
+/**
+ * Tool execution completed event
+ */
+export interface ToolExecutionCompleteEvent extends BaseEvent {
+    type: 'tool:execution:complete';
+    toolName: string;
+    params: unknown;
+    result: unknown;
+    durationMs: number;
+    success: boolean;
+    error?: Error;
+}
+/**
+ * Memory stored event
+ */
+export interface MemoryStoredEvent extends BaseEvent {
+    type: 'memory:stored';
+    memoryId: string;
+    content: string;
+    tags: string[];
+    importance: string;
+}
+/**
+ * Memory retrieved event
+ */
+export interface MemoryRetrievedEvent extends BaseEvent {
+    type: 'memory:retrieved';
+    memoryIds: string[];
+    query?: string;
+    count: number;
+}
+/**
+ * Memory deleted event
+ */
+export interface MemoryDeletedEvent extends BaseEvent {
+    type: 'memory:deleted';
+    memoryId: string;
+}
+/**
+ * Cache event
+ */
+export interface CacheEvent extends BaseEvent {
+    type: 'cache:hit' | 'cache:miss' | 'cache:invalidate';
+    key?: string;
+}
+/**
+ * Performance alert event
+ */
+export interface PerformanceAlertEvent extends BaseEvent {
+    type: 'performance:alert';
+    metric: string;
+    value: number;
+    threshold: number;
+    severity: 'warning' | 'critical';
+}
+/**
+ * System event
+ */
+export interface SystemEvent extends BaseEvent {
+    type: 'system:startup' | 'system:shutdown' | 'system:error';
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Union of all event types
+ */
+export type SpecMemEvent = ToolExecutionStartEvent | ToolExecutionCompleteEvent | MemoryStoredEvent | MemoryRetrievedEvent | MemoryDeletedEvent | CacheEvent | PerformanceAlertEvent | SystemEvent;
+/**
+ * MCP Event Bus - specialized publisher for SpecMem MCP events
+ */
+export declare class MCPEventBus {
+    private publisher;
+    private aggregator;
+    constructor(config?: Partial<EventBusConfiguration>);
+    /**
+     * Publish an event
+     */
+    publish(event: SpecMemEvent): Promise<DispatchResult>;
+    /**
+     * Publish an event asynchronously
+     */
+    publishAsync(event: SpecMemEvent): void;
+    /**
+     * Subscribe to events by type
+     */
+    on<E extends SpecMemEvent>(eventType: E['type'], handler: MessageHandler<E>, options?: {
+        priority?: number;
+        once?: boolean;
+        subscriberId?: string;
+    }): void;
+    /**
+     * Subscribe once to an event type
+     */
+    once<E extends SpecMemEvent>(eventType: E['type'], handler: MessageHandler<E>): void;
+    /**
+     * Unsubscribe from event type
+     */
+    off(eventType: string, subscriberId?: string): void;
+    /**
+     * Get performance metrics
+     */
+    getMetrics(): import("./metrics.js").MetricStats;
+    /**
+     * Get formatted metrics string
+     */
+    getFormattedMetrics(): string;
+    /**
+     * Shutdown the event bus
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Wrap an MCP tool to emit events on execution
+ */
+export declare function wrapToolWithEvents<TInput, TOutput>(tool: MCPTool<TInput, TOutput>, eventBus: MCPEventBus): MCPTool<TInput, TOutput>;
+/**
+ * Create event helpers for memory operations
+ */
+export declare function createMemoryEventHelpers(eventBus: MCPEventBus): {
+    /**
+     * Emit memory stored event
+     */
+    onMemoryStored(memoryId: string, content: string, tags: string[], importance: string): void;
+    /**
+     * Emit memory retrieved event
+     */
+    onMemoryRetrieved(memoryIds: string[], query?: string): void;
+    /**
+     * Emit memory deleted event
+     */
+    onMemoryDeleted(memoryId: string): void;
+    /**
+     * Emit cache event
+     */
+    onCache(type: "hit" | "miss" | "invalidate", key?: string): void;
+};
+/**
+ * Get the global MCP event bus instance
+ */
+export declare function getMCPEventBus(): MCPEventBus;
+/**
+ * Reset the global event bus (for testing)
+ */
+export declare function resetMCPEventBus(): Promise<void>;
+/**
+ * Quick publish to global bus
+ */
+export declare function publishEvent(event: SpecMemEvent): void;
+/**
+ * Quick subscribe to global bus
+ */
+export declare function subscribeToEvent<E extends SpecMemEvent>(eventType: E['type'], handler: MessageHandler<E>): void;
+/**
+ * Emit system startup event
+ */
+export declare function emitStartup(message: string, details?: Record<string, unknown>): void;
+/**
+ * Emit system shutdown event
+ */
+export declare function emitShutdown(message: string, details?: Record<string, unknown>): void;
+/**
+ * Emit system error event
+ */
+export declare function emitError(message: string, details?: Record<string, unknown>): void;
+/**
+ * Setup automatic performance monitoring
+ */
+export declare function setupPerformanceMonitoring(eventBus: MCPEventBus, options?: {
+    latencyThresholdMs?: number;
+    checkIntervalMs?: number;
+    onAlert?: (alert: PerformanceAlertEvent) => void;
+}): () => void;
+//# sourceMappingURL=integration.d.ts.map

package/dist/events/integration.d.ts.map

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