specmem-hardwicksoftware 3.5.99

package/dist/events/Publisher.js

@@ -0,0 +1,439 @@
+/**
+ * Publisher.ts - LWJEB-inspired Event Publishing System
+ *
+ * Adapted from Hippo's LWJEB (https://github.com/Hippo/LWJEB)
+ * TypeScript implementation for SpecMem MCP
+ *
+ * Key features from LWJEB:
+ * - PubSub pattern with result caching
+ * - Async dispatcher threads (via setImmediate/setTimeout in JS)
+ * - WeakRef-based subscriber management
+ * - Sub-25ms dispatch latency target
+ *
+ * @author hardwicksoftwareservices (adapted from Hippo's Java implementation)
+ */
+import { EventEmitter } from 'events';
+import { getDefaultConfiguration } from './config.js';
+import { createMetrics } from './metrics.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Dead message result - when no handlers exist
+ * Equivalent to LWJEB's DeadMessagePublicationResult
+ */
+export class DeadPublicationResult {
+    topic;
+    handlers = [];
+    timestamp;
+    constructor(topic) {
+        this.topic = topic;
+        this.timestamp = Date.now();
+    }
+    async dispatch() {
+        return {
+            success: false,
+            handlersInvoked: 0,
+            errors: [],
+            durationMs: 0
+        };
+    }
+    async() {
+        // No-op for dead messages
+    }
+    asyncWithTimeout(_timeoutMs) {
+        // No-op for dead messages
+    }
+}
+/**
+ * Standard publication result with handlers
+ * Equivalent to LWJEB's StandardMessagePublicationResult
+ */
+export class StandardPublicationResult {
+    topic;
+    handlers;
+    timestamp;
+    publisher;
+    dispatched = false;
+    constructor(publisher, topic, handlers) {
+        this.publisher = publisher;
+        this.topic = topic;
+        this.handlers = handlers;
+        this.timestamp = Date.now();
+    }
+    async dispatch() {
+        if (this.dispatched) {
+            return {
+                success: false,
+                handlersInvoked: 0,
+                errors: [new Error('Already dispatched')],
+                durationMs: 0
+            };
+        }
+        this.dispatched = true;
+        const startTime = performance.now();
+        const errors = [];
+        let handlersInvoked = 0;
+        // Sort by priority (higher = first)
+        const sortedHandlers = [...this.handlers].sort((a, b) => b.priority - a.priority);
+        for (const registered of sortedHandlers) {
+            // Apply filter if present
+            if (registered.filter && !registered.filter(this.topic)) {
+                continue;
+            }
+            try {
+                await registered.handler(this.topic);
+                handlersInvoked++;
+                // Remove one-time handlers
+                if (registered.once) {
+                    this.publisher.removeHandler(registered);
+                }
+            }
+            catch (error) {
+                errors.push(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        const durationMs = performance.now() - startTime;
+        return {
+            success: errors.length === 0,
+            handlersInvoked,
+            errors,
+            durationMs
+        };
+    }
+    async() {
+        setImmediate(() => {
+            this.dispatch().catch(err => {
+                logger.error({ error: err }, 'async dispatch failed');
+            });
+        });
+    }
+    asyncWithTimeout(timeoutMs) {
+        const timeoutHandle = setTimeout(() => {
+            if (!this.dispatched) {
+                logger.warn({ topic: this.topic, timeoutMs }, 'async dispatch timed out');
+            }
+        }, timeoutMs);
+        setImmediate(() => {
+            this.dispatch()
+                .then(() => clearTimeout(timeoutHandle))
+                .catch(err => {
+                clearTimeout(timeoutHandle);
+                logger.error({ error: err }, 'async dispatch failed');
+            });
+        });
+    }
+}
+/**
+ * EventPublisher - TypeScript adaptation of LWJEB's PubSub<T>
+ *
+ * Features:
+ * - Result caching for identical topics (performance optimization)
+ * - WeakRef subscriber management
+ * - Priority-based handler ordering
+ * - Filter support for selective handling
+ * - Performance metrics tracking
+ */
+export class EventPublisher extends EventEmitter {
+    config;
+    metrics;
+    // Subscriber map: topic class/type -> handlers
+    // Equivalent to LWJEB's subscriberMap
+    subscriberMap = new Map();
+    // Result cache for performance (LWJEB's resultCache HashMap)
+    resultCache = new Map();
+    // Async dispatch queue (LWJEB's BlockingQueue)
+    dispatchQueue = [];
+    isProcessingQueue = false;
+    // Shutdown flag
+    shutdown = false;
+    constructor(config) {
+        super();
+        this.config = { ...getDefaultConfiguration(), ...config };
+        this.metrics = createMetrics(this.config.identifier);
+        // Start dispatcher "threads" (via intervals)
+        this.setupDispatchers();
+        logger.info({ identifier: this.config.identifier }, 'EventPublisher initialized');
+    }
+    /**
+     * Setup async dispatchers - equivalent to LWJEB's setupDispatchers()
+     * Uses setInterval instead of Java threads
+     */
+    setupDispatchers() {
+        const processInterval = setInterval(() => {
+            if (this.shutdown) {
+                clearInterval(processInterval);
+                return;
+            }
+            this.processDispatchQueue();
+        }, 1); // Process queue every 1ms for low latency
+        // Allow process to exit even if interval is running
+        if (processInterval.unref) {
+            processInterval.unref();
+        }
+    }
+    /**
+     * Process the async dispatch queue
+     */
+    async processDispatchQueue() {
+        if (this.isProcessingQueue || this.dispatchQueue.length === 0) {
+            return;
+        }
+        this.isProcessingQueue = true;
+        try {
+            // Process up to dispatcherCount items per tick
+            const batchSize = Math.min(this.config.dispatcherCount, this.dispatchQueue.length);
+            for (let i = 0; i < batchSize; i++) {
+                const result = this.dispatchQueue.shift();
+                if (result) {
+                    await result.dispatch();
+                }
+            }
+        }
+        finally {
+            this.isProcessingQueue = false;
+        }
+    }
+    /**
+     * Post/publish a topic - equivalent to LWJEB's post(T topic)
+     *
+     * Uses caching for performance: if we've seen this exact topic before
+     * and handlers haven't changed, return cached result
+     */
+    post(topic) {
+        const startTime = performance.now();
+        // Generate cache key from topic
+        const cacheKey = this.generateCacheKey(topic);
+        // Check cache if enabled
+        if (this.config.cacheEnabled) {
+            const cached = this.resultCache.get(cacheKey);
+            if (cached) {
+                this.metrics.recordCacheHit();
+                this.metrics.recordPublish(performance.now() - startTime);
+                return cached;
+            }
+            this.metrics.recordCacheMiss();
+        }
+        // Get handlers for this topic type
+        const topicType = this.getTopicType(topic);
+        const handlers = this.subscriberMap.get(topicType) ?? [];
+        // Create result
+        let result;
+        if (handlers.length === 0) {
+            result = new DeadPublicationResult(topic);
+            this.emit('deadMessage', topic);
+        }
+        else {
+            result = new StandardPublicationResult(this, topic, [...handlers]);
+        }
+        // Cache the result
+        if (this.config.cacheEnabled) {
+            this.resultCache.set(cacheKey, result);
+            // Enforce cache size limit
+            if (this.resultCache.size > this.config.maxCacheSize) {
+                const firstKey = this.resultCache.keys().next().value;
+                if (firstKey) {
+                    this.resultCache.delete(firstKey);
+                }
+            }
+        }
+        const duration = performance.now() - startTime;
+        this.metrics.recordPublish(duration);
+        // Warn if exceeding latency target
+        if (duration > this.config.maxLatencyMs) {
+            logger.warn({
+                duration,
+                target: this.config.maxLatencyMs,
+                topicType
+            }, 'publish exceeded latency target');
+        }
+        return result;
+    }
+    /**
+     * Subscribe a handler - equivalent to LWJEB's subscribe(Object parent)
+     */
+    subscribe(topicType, handler, options = {}) {
+        const registered = {
+            handler,
+            priority: options.priority ?? 0,
+            filter: options.filter,
+            once: options.once ?? false,
+            subscriberId: options.subscriberId ?? this.generateSubscriberId()
+        };
+        const handlers = this.subscriberMap.get(topicType) ?? [];
+        handlers.push(registered);
+        this.subscriberMap.set(topicType, handlers);
+        // Invalidate cache when subscriptions change
+        this.invalidateCaches();
+        this.metrics.recordSubscribe();
+        logger.debug({
+            topicType,
+            subscriberId: registered.subscriberId,
+            priority: registered.priority
+        }, 'handler subscribed');
+    }
+    /**
+     * Subscribe once - handler is removed after first invocation
+     */
+    subscribeOnce(topicType, handler, options = {}) {
+        this.subscribe(topicType, handler, { ...options, once: true });
+    }
+    /**
+     * Unsubscribe handlers - equivalent to LWJEB's unsubscribe(Object parent)
+     */
+    unsubscribe(topicType, subscriberId) {
+        if (!this.subscriberMap.has(topicType)) {
+            return;
+        }
+        if (subscriberId) {
+            // Remove specific subscriber
+            const handlers = this.subscriberMap.get(topicType) ?? [];
+            const filtered = handlers.filter(h => h.subscriberId !== subscriberId);
+            this.subscriberMap.set(topicType, filtered);
+        }
+        else {
+            // Remove all handlers for topic type
+            this.subscriberMap.delete(topicType);
+        }
+        // Invalidate cache when subscriptions change
+        this.invalidateCaches();
+        this.metrics.recordUnsubscribe();
+        logger.debug({ topicType, subscriberId }, 'handler unsubscribed');
+    }
+    /**
+     * Remove a specific handler registration
+     * Used internally for one-time handlers
+     */
+    removeHandler(registered) {
+        for (const [topicType, handlers] of this.subscriberMap.entries()) {
+            const index = handlers.indexOf(registered);
+            if (index >= 0) {
+                handlers.splice(index, 1);
+                this.invalidateCaches();
+                break;
+            }
+        }
+    }
+    /**
+     * Invalidate all caches - equivalent to LWJEB's invalidateCaches()
+     */
+    invalidateCaches() {
+        this.resultCache.clear();
+        this.metrics.recordCacheInvalidation();
+    }
+    /**
+     * Add message to async dispatch queue
+     * Equivalent to LWJEB's addMessage()
+     */
+    addToQueue(result) {
+        if (this.dispatchQueue.length >= this.config.maxQueueSize) {
+            logger.warn({
+                queueSize: this.dispatchQueue.length,
+                maxSize: this.config.maxQueueSize
+            }, 'dispatch queue full - dropping message');
+            return;
+        }
+        this.dispatchQueue.push(result);
+    }
+    /**
+     * Get current metrics
+     */
+    getMetrics() {
+        return this.metrics;
+    }
+    /**
+     * Get subscriber count for a topic type
+     */
+    getSubscriberCount(topicType) {
+        return this.subscriberMap.get(topicType)?.length ?? 0;
+    }
+    /**
+     * Get all registered topic types
+     */
+    getTopicTypes() {
+        return Array.from(this.subscriberMap.keys());
+    }
+    /**
+     * Shutdown the publisher - equivalent to LWJEB's shutdown()
+     */
+    async shutdownGracefully(timeoutMs = 5000) {
+        logger.info({ identifier: this.config.identifier }, 'shutting down publisher...');
+        // Wait for queue to drain (with timeout)
+        const startTime = Date.now();
+        while (this.dispatchQueue.length > 0 && (Date.now() - startTime) < timeoutMs) {
+            await new Promise(resolve => setTimeout(resolve, 10));
+        }
+        if (this.dispatchQueue.length > 0) {
+            logger.warn({
+                remainingMessages: this.dispatchQueue.length
+            }, 'shutdown timeout - some messages not dispatched');
+        }
+        this.shutdown = true;
+        this.removeAllListeners();
+        logger.info({ identifier: this.config.identifier }, 'publisher shut down');
+    }
+    /**
+     * Force immediate shutdown - equivalent to LWJEB's forceShutdown()
+     */
+    forceShutdown() {
+        this.shutdown = true;
+        this.dispatchQueue.length = 0;
+        this.removeAllListeners();
+        logger.info({ identifier: this.config.identifier }, 'publisher force shut down');
+    }
+    /**
+     * Generate cache key for a topic
+     */
+    generateCacheKey(topic) {
+        // For objects, use JSON stringification
+        // For primitives, use toString
+        if (typeof topic === 'object' && topic !== null) {
+            try {
+                return JSON.stringify(topic);
+            }
+            catch (e) {
+                // Circular reference or non-serializable - fall back to String
+                return String(topic);
+            }
+        }
+        return String(topic);
+    }
+    /**
+     * Get topic type identifier
+     */
+    getTopicType(topic) {
+        if (typeof topic === 'object' && topic !== null) {
+            // Use constructor name or 'object'
+            return topic.constructor?.name ?? 'object';
+        }
+        return typeof topic;
+    }
+    /**
+     * Generate unique subscriber ID
+     */
+    generateSubscriberId() {
+        return `sub_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+/**
+ * Create a new EventPublisher instance
+ * Factory function for convenience
+ */
+export function createPublisher(config) {
+    return new EventPublisher(config);
+}
+/**
+ * Global publisher singleton for convenience
+ */
+let globalPublisher = null;
+export function getGlobalPublisher() {
+    if (!globalPublisher) {
+        globalPublisher = createPublisher({ identifier: 'specmem-global' });
+    }
+    return globalPublisher;
+}
+export function resetGlobalPublisher() {
+    if (globalPublisher) {
+        globalPublisher.forceShutdown();
+        globalPublisher = null;
+    }
+}
+//# sourceMappingURL=Publisher.js.map

package/dist/events/Publisher.js.map

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

package/dist/events/config.d.ts

@@ -0,0 +1,139 @@
+/**
+ * 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
+ */
+/**
+ * Main event bus configuration
+ * Equivalent to LWJEB's BusConfiguration + AsynchronousPublicationConfiguration
+ */
+export interface EventBusConfiguration {
+    /** Unique identifier for this bus instance */
+    identifier: string;
+    /** Number of async dispatchers (equivalent to LWJEB's dispatcherCount) */
+    dispatcherCount: number;
+    /** Use daemon-style processing (allow process exit) */
+    daemonMode: boolean;
+    /** Suppress interrupt exceptions during shutdown */
+    suppressDispatcherInterrupt: boolean;
+    /** Enable result caching for performance */
+    cacheEnabled: boolean;
+    /** Maximum cache entries before eviction */
+    maxCacheSize: number;
+    /** Maximum async queue size */
+    maxQueueSize: number;
+    /** Target latency in milliseconds (warn if exceeded) */
+    maxLatencyMs: number;
+    /** Exception handler callback */
+    exceptionHandler: ExceptionHandler;
+}
+/**
+ * Exception handler type
+ * Equivalent to LWJEB's ExceptionHandlingConfiguration
+ */
+export type ExceptionHandler = (error: Error, context?: Record<string, unknown>) => void;
+/**
+ * Default exception handler - logs errors
+ */
+export declare const defaultExceptionHandler: ExceptionHandler;
+/**
+ * Get default configuration
+ * Equivalent to LWJEB's BusConfigurations.getDefault()
+ */
+export declare function getDefaultConfiguration(): EventBusConfiguration;
+/**
+ * Configuration builder pattern
+ * Equivalent to LWJEB's BusConfigurations.Builder
+ */
+export declare class EventBusConfigurationBuilder {
+    private config;
+    constructor();
+    /**
+     * Set bus identifier
+     */
+    identifier(id: string): this;
+    /**
+     * Set dispatcher count
+     */
+    dispatchers(count: number): this;
+    /**
+     * Enable/disable daemon mode
+     */
+    daemon(enabled: boolean): this;
+    /**
+     * Enable/disable caching
+     */
+    caching(enabled: boolean): this;
+    /**
+     * Set maximum cache size
+     */
+    maxCache(size: number): this;
+    /**
+     * Set maximum queue size
+     */
+    maxQueue(size: number): this;
+    /**
+     * Set latency target (for warnings)
+     */
+    latencyTarget(ms: number): this;
+    /**
+     * Set exception handler
+     */
+    onException(handler: ExceptionHandler): this;
+    /**
+     * Build the configuration
+     */
+    build(): EventBusConfiguration;
+}
+/**
+ * Create a configuration builder
+ */
+export declare function configBuilder(): EventBusConfigurationBuilder;
+/**
+ * Predefined configuration profiles
+ * Equivalent to common LWJEB use cases
+ */
+export declare const ConfigProfiles: {
+    /**
+     * High performance configuration
+     * Optimized for sub-10ms latency
+     */
+    highPerformance(): EventBusConfiguration;
+    /**
+     * Memory efficient configuration
+     * Reduced cache/queue sizes
+     */
+    memoryEfficient(): EventBusConfiguration;
+    /**
+     * Debug configuration
+     * Verbose logging, strict latency
+     */
+    debug(): EventBusConfiguration;
+    /**
+     * MCP optimized configuration
+     * Balanced for MCP tool integration
+     */
+    mcpOptimized(): EventBusConfiguration;
+};
+/**
+ * Load configuration from environment variables
+ */
+export declare function loadConfigFromEnv(): Partial<EventBusConfiguration>;
+/**
+ * Validate configuration
+ */
+export declare function validateConfiguration(config: EventBusConfiguration): string[];
+/**
+ * Merge configurations with validation
+ */
+export declare function mergeConfigurations(base: EventBusConfiguration, override: Partial<EventBusConfiguration>): EventBusConfiguration;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/events/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IAEnB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;IAExB,uDAAuD;IACvD,UAAU,EAAE,OAAO,CAAC;IAEpB,oDAAoD;IACpD,2BAA2B,EAAE,OAAO,CAAC;IAErC,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IAEtB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IAErB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IAErB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAErC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,qBAAqB,CAY/D;AAED;;;GAGG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,MAAM,CAAwB;;IAMtC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQhC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAK9B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAK/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ5B;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ/B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAK5C;;OAEG;IACH,KAAK,IAAI,qBAAqB;CAG/B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,4BAA4B,CAE5D;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;IACzB;;;OAGG;uBACgB,qBAAqB;IAYxC;;;OAGG;uBACgB,qBAAqB;IAYxC;;;OAGG;aACM,qBAAqB;IAmB9B;;;OAGG;oBACa,qBAAqB;CAWtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAkClE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAwB7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,qBAAqB,EAC3B,QAAQ,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACvC,qBAAqB,CASvB"}