promptspeak-mcp-server 0.1.0

package/dist/core/logging/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Unified Logging Module for PromptSpeak MCP Server
+ *
+ * This module provides a comprehensive logging solution with:
+ * - Structured logging with multiple severity levels
+ * - Correlation ID tracking across async operations
+ * - Multiple output formats (JSON for production, colored console for development)
+ * - Environment-based configuration via LOG_LEVEL env var
+ * - Module prefixes for easy log filtering
+ *
+ * @example
+ * ```typescript
+ * import { createLogger, LogContextManager } from './core/logging';
+ *
+ * const logger = createLogger('MyModule');
+ *
+ * // Basic logging
+ * logger.info('Operation started');
+ * logger.debug('Debug details', { key: 'value' });
+ * logger.error('Operation failed', error);
+ *
+ * // With correlation tracking
+ * LogContextManager.runWithCorrelation(() => {
+ *   logger.info('Request received');  // Includes correlation ID
+ *   processRequest();
+ *   logger.info('Request completed'); // Same correlation ID
+ * });
+ *
+ * // Child loggers
+ * const childLogger = logger.child('SubComponent');
+ * childLogger.info('Sub-component message'); // Module: MyModule:SubComponent
+ *
+ * // Timing operations
+ * await logger.time('fetchData', async () => {
+ *   return await fetchDataFromAPI();
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { LogLevel, LogContext, LogEntry, LoggerConfig, } from './types.js';
+export { LOG_LEVEL_PRIORITY, getDefaultConfig, } from './types.js';
+export { LogContextManager, withCorrelation, } from './context.js';
+export type { LogFormatter } from './formatters.js';
+export { ConsoleFormatter, JSONFormatter, createFormatter, } from './formatters.js';
+export { Logger, createLogger, configureLogger, getLoggerConfig, rootLogger, } from './logger.js';
+import { createLogger } from './logger.js';
+export default createLogger;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,YAAY,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,eAAe,EACf,eAAe,EACf,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,eAAe,YAAY,CAAC"}

package/dist/core/logging/index.js

@@ -0,0 +1,52 @@
+/**
+ * Unified Logging Module for PromptSpeak MCP Server
+ *
+ * This module provides a comprehensive logging solution with:
+ * - Structured logging with multiple severity levels
+ * - Correlation ID tracking across async operations
+ * - Multiple output formats (JSON for production, colored console for development)
+ * - Environment-based configuration via LOG_LEVEL env var
+ * - Module prefixes for easy log filtering
+ *
+ * @example
+ * ```typescript
+ * import { createLogger, LogContextManager } from './core/logging';
+ *
+ * const logger = createLogger('MyModule');
+ *
+ * // Basic logging
+ * logger.info('Operation started');
+ * logger.debug('Debug details', { key: 'value' });
+ * logger.error('Operation failed', error);
+ *
+ * // With correlation tracking
+ * LogContextManager.runWithCorrelation(() => {
+ *   logger.info('Request received');  // Includes correlation ID
+ *   processRequest();
+ *   logger.info('Request completed'); // Same correlation ID
+ * });
+ *
+ * // Child loggers
+ * const childLogger = logger.child('SubComponent');
+ * childLogger.info('Sub-component message'); // Module: MyModule:SubComponent
+ *
+ * // Timing operations
+ * await logger.time('fetchData', async () => {
+ *   return await fetchDataFromAPI();
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Runtime values
+export { LOG_LEVEL_PRIORITY, getDefaultConfig, } from './types.js';
+// Context Management
+export { LogContextManager, withCorrelation, } from './context.js';
+// Formatters (runtime values)
+export { ConsoleFormatter, JSONFormatter, createFormatter, } from './formatters.js';
+// Logger
+export { Logger, createLogger, configureLogger, getLoggerConfig, rootLogger, } from './logger.js';
+// Convenience re-export of the main factory function as default-like behavior
+import { createLogger } from './logger.js';
+export default createLogger;
+//# sourceMappingURL=index.js.map

package/dist/core/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAUH,iBAAiB;AACjB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,qBAAqB;AACrB,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,cAAc,CAAC;AAKtB,8BAA8B;AAC9B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EACL,MAAM,EACN,YAAY,EACZ,eAAe,EACf,eAAe,EACf,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,eAAe,YAAY,CAAC"}

package/dist/core/logging/logger.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Main Logger Class for PromptSpeak MCP Server
+ *
+ * Provides a structured, configurable logging interface with support for:
+ * - Multiple log levels (debug, info, warn, error, critical)
+ * - Structured data logging
+ * - Error serialization
+ * - Correlation ID tracking
+ * - Child loggers with module prefixes
+ * - Environment-based configuration
+ */
+import { LogContext, LoggerConfig } from './types.js';
+/**
+ * Configure the global logger settings
+ */
+export declare function configureLogger(config: Partial<LoggerConfig>): void;
+/**
+ * Get the current logger configuration
+ */
+export declare function getLoggerConfig(): LoggerConfig;
+/**
+ * Main Logger class providing structured logging capabilities.
+ */
+export declare class Logger {
+    private module;
+    private additionalContext;
+    /**
+     * Creates a new Logger instance.
+     *
+     * @param module - Module name to prefix log entries with (e.g., 'IntentManager')
+     */
+    constructor(module: string);
+    /**
+     * Log a debug message. Used for detailed debugging information.
+     */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log an info message. Used for general informational messages.
+     */
+    info(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log a warning message. Used for potentially problematic situations.
+     */
+    warn(message: string, data?: Record<string, unknown>, error?: Error): void;
+    /**
+     * Log an error message. Used for error conditions.
+     */
+    error(message: string, error?: Error, data?: Record<string, unknown>): void;
+    /**
+     * Log a critical message. Used for severe errors requiring immediate attention.
+     */
+    critical(message: string, error?: Error, data?: Record<string, unknown>): void;
+    /**
+     * Create a child logger with an extended module path.
+     *
+     * @param subModule - Sub-module name to append to the current module
+     * @returns A new Logger instance with the combined module path
+     *
+     * @example
+     * const logger = createLogger('IntentManager');
+     * const childLogger = logger.child('Parser');
+     * // childLogger's module will be 'IntentManager:Parser'
+     */
+    child(subModule: string): Logger;
+    /**
+     * Create a new logger with additional context that will be included in all log entries.
+     *
+     * @param context - Additional context to include in log entries
+     * @returns A new Logger instance with the additional context
+     *
+     * @example
+     * const logger = createLogger('API').withContext({ traceId: 'abc123' });
+     */
+    withContext(context: Partial<LogContext>): Logger;
+    /**
+     * Time an operation and log its duration.
+     *
+     * @param operationName - Name of the operation being timed
+     * @param fn - Function to execute and time
+     * @returns The result of the function
+     *
+     * @example
+     * const result = await logger.time('fetchData', async () => {
+     *   return await fetch('/api/data');
+     * });
+     */
+    time<T>(operationName: string, fn: () => T | Promise<T>): Promise<T>;
+    /**
+     * Core logging method that constructs and outputs log entries.
+     */
+    private log;
+    /**
+     * Serialize an Error object for logging.
+     */
+    private serializeError;
+    /**
+     * Write the formatted log entry to the appropriate output stream.
+     * NOTE: MCP servers must use stderr for ALL logging since stdout is
+     * reserved for JSON-RPC protocol communication.
+     */
+    private write;
+}
+/**
+ * Factory function to create a new Logger instance.
+ *
+ * @param module - Module name for the logger
+ * @returns A new Logger instance
+ *
+ * @example
+ * import { createLogger } from './core/logging';
+ *
+ * const logger = createLogger('IntentManager');
+ * logger.info('Processing intent', { intentType: 'query' });
+ */
+export declare function createLogger(module: string): Logger;
+/**
+ * Default application logger for use when a specific module isn't relevant.
+ */
+export declare const rootLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/logging/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAGL,UAAU,EACV,YAAY,EAGb,MAAM,YAAY,CAAC;AAYpB;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAKnE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;GAEG;AACH,qBAAa,MAAM;IAQL,OAAO,CAAC,MAAM;IAP1B,OAAO,CAAC,iBAAiB,CAA2B;IAEpD;;;;OAIG;gBACiB,MAAM,EAAE,MAAM;IAElC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAI1E;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3E;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9E;;;;;;;;;;OAUG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAMhC;;;;;;;;OAQG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM;IAMjD;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAc1E;;OAEG;IACH,OAAO,CAAC,GAAG;IAqCX;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;;;OAIG;IACH,OAAO,CAAC,KAAK;CAId;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,QAAsB,CAAC"}

package/dist/core/logging/logger.js

@@ -0,0 +1,213 @@
+/**
+ * Main Logger Class for PromptSpeak MCP Server
+ *
+ * Provides a structured, configurable logging interface with support for:
+ * - Multiple log levels (debug, info, warn, error, critical)
+ * - Structured data logging
+ * - Error serialization
+ * - Correlation ID tracking
+ * - Child loggers with module prefixes
+ * - Environment-based configuration
+ */
+import { LOG_LEVEL_PRIORITY, getDefaultConfig, } from './types.js';
+import { LogContextManager } from './context.js';
+import { createFormatter } from './formatters.js';
+/**
+ * Global logger configuration
+ */
+let globalConfig = getDefaultConfig();
+let globalFormatter = createFormatter(globalConfig.format, {
+    colorize: globalConfig.colorize,
+});
+/**
+ * Configure the global logger settings
+ */
+export function configureLogger(config) {
+    globalConfig = { ...globalConfig, ...config };
+    globalFormatter = createFormatter(globalConfig.format, {
+        colorize: globalConfig.colorize,
+    });
+}
+/**
+ * Get the current logger configuration
+ */
+export function getLoggerConfig() {
+    return { ...globalConfig };
+}
+/**
+ * Main Logger class providing structured logging capabilities.
+ */
+export class Logger {
+    module;
+    additionalContext = {};
+    /**
+     * Creates a new Logger instance.
+     *
+     * @param module - Module name to prefix log entries with (e.g., 'IntentManager')
+     */
+    constructor(module) {
+        this.module = module;
+    }
+    /**
+     * Log a debug message. Used for detailed debugging information.
+     */
+    debug(message, data) {
+        this.log('debug', message, data);
+    }
+    /**
+     * Log an info message. Used for general informational messages.
+     */
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    /**
+     * Log a warning message. Used for potentially problematic situations.
+     */
+    warn(message, data, error) {
+        this.log('warn', message, data, error);
+    }
+    /**
+     * Log an error message. Used for error conditions.
+     */
+    error(message, error, data) {
+        this.log('error', message, data, error);
+    }
+    /**
+     * Log a critical message. Used for severe errors requiring immediate attention.
+     */
+    critical(message, error, data) {
+        this.log('critical', message, data, error);
+    }
+    /**
+     * Create a child logger with an extended module path.
+     *
+     * @param subModule - Sub-module name to append to the current module
+     * @returns A new Logger instance with the combined module path
+     *
+     * @example
+     * const logger = createLogger('IntentManager');
+     * const childLogger = logger.child('Parser');
+     * // childLogger's module will be 'IntentManager:Parser'
+     */
+    child(subModule) {
+        const childLogger = new Logger(`${this.module}:${subModule}`);
+        childLogger.additionalContext = { ...this.additionalContext };
+        return childLogger;
+    }
+    /**
+     * Create a new logger with additional context that will be included in all log entries.
+     *
+     * @param context - Additional context to include in log entries
+     * @returns A new Logger instance with the additional context
+     *
+     * @example
+     * const logger = createLogger('API').withContext({ traceId: 'abc123' });
+     */
+    withContext(context) {
+        const contextLogger = new Logger(this.module);
+        contextLogger.additionalContext = { ...this.additionalContext, ...context };
+        return contextLogger;
+    }
+    /**
+     * Time an operation and log its duration.
+     *
+     * @param operationName - Name of the operation being timed
+     * @param fn - Function to execute and time
+     * @returns The result of the function
+     *
+     * @example
+     * const result = await logger.time('fetchData', async () => {
+     *   return await fetch('/api/data');
+     * });
+     */
+    async time(operationName, fn) {
+        const startTime = performance.now();
+        try {
+            const result = await fn();
+            const duration = Math.round(performance.now() - startTime);
+            this.debug(`${operationName} completed`, { duration });
+            return result;
+        }
+        catch (error) {
+            const duration = Math.round(performance.now() - startTime);
+            this.error(`${operationName} failed`, error instanceof Error ? error : undefined, { duration });
+            throw error;
+        }
+    }
+    /**
+     * Core logging method that constructs and outputs log entries.
+     */
+    log(level, message, data, error) {
+        // Check if this level should be logged
+        if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[globalConfig.minLevel]) {
+            return;
+        }
+        // Build the log entry
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            module: this.module,
+            correlationId: this.additionalContext.correlationId ?? LogContextManager.getCorrelationId(),
+            traceId: this.additionalContext.traceId ?? LogContextManager.getTraceId(),
+            duration: this.additionalContext.duration,
+        };
+        // Add data if present
+        if (data && Object.keys(data).length > 0) {
+            entry.data = data;
+        }
+        // Serialize error if present
+        if (error) {
+            entry.error = this.serializeError(error);
+        }
+        // Format and output
+        const output = globalFormatter.format(entry);
+        this.write(level, output);
+    }
+    /**
+     * Serialize an Error object for logging.
+     */
+    serializeError(error) {
+        const serialized = {
+            name: error.name,
+            message: error.message,
+        };
+        if (globalConfig.includeStackTraces && error.stack) {
+            serialized.stack = error.stack;
+        }
+        // Capture error code if present (common in Node.js errors)
+        if ('code' in error && typeof error.code === 'string') {
+            serialized.code = error.code;
+        }
+        return serialized;
+    }
+    /**
+     * Write the formatted log entry to the appropriate output stream.
+     * NOTE: MCP servers must use stderr for ALL logging since stdout is
+     * reserved for JSON-RPC protocol communication.
+     */
+    write(_level, output) {
+        // ALL output goes to stderr for MCP compatibility
+        console.error(output);
+    }
+}
+/**
+ * Factory function to create a new Logger instance.
+ *
+ * @param module - Module name for the logger
+ * @returns A new Logger instance
+ *
+ * @example
+ * import { createLogger } from './core/logging';
+ *
+ * const logger = createLogger('IntentManager');
+ * logger.info('Processing intent', { intentType: 'query' });
+ */
+export function createLogger(module) {
+    return new Logger(module);
+}
+/**
+ * Default application logger for use when a specific module isn't relevant.
+ */
+export const rootLogger = createLogger('App');
+//# sourceMappingURL=logger.js.map

package/dist/core/logging/logger.js.map

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

package/dist/core/logging/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Unified Logging Types for PromptSpeak MCP Server
+ *
+ * Provides type definitions for structured logging throughout the application.
+ */
+/**
+ * Log levels in order of severity (lowest to highest)
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'critical';
+/**
+ * Numeric priority values for log levels (used for filtering)
+ */
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+/**
+ * Context information attached to log entries
+ */
+export interface LogContext {
+    /** ISO 8601 timestamp of when the log entry was created */
+    timestamp: string;
+    /** Severity level of the log entry */
+    level: LogLevel;
+    /** Module or component that generated the log entry */
+    module?: string;
+    /** Correlation ID for tracking related operations across modules */
+    correlationId?: string;
+    /** Trace ID for distributed tracing */
+    traceId?: string;
+    /** Duration in milliseconds (for operation timing) */
+    duration?: number;
+}
+/**
+ * Complete log entry with message and optional data
+ */
+export interface LogEntry extends LogContext {
+    /** Human-readable log message */
+    message: string;
+    /** Additional structured data to include with the log entry */
+    data?: Record<string, unknown>;
+    /** Error information if this log entry is related to an error */
+    error?: {
+        name: string;
+        message: string;
+        stack?: string;
+        code?: string;
+    };
+}
+/**
+ * Configuration options for the logger
+ */
+export interface LoggerConfig {
+    /** Minimum log level to output (default: 'info' in production, 'debug' in development) */
+    minLevel: LogLevel;
+    /** Output format: 'json' for structured logs, 'console' for human-readable */
+    format: 'json' | 'console';
+    /** Whether to include stack traces in error logs */
+    includeStackTraces: boolean;
+    /** Whether to colorize console output (only applies to 'console' format) */
+    colorize: boolean;
+}
+/**
+ * Default logger configuration based on environment
+ */
+export declare function getDefaultConfig(): LoggerConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/logging/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/logging/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAMvD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,EAAE,QAAQ,CAAC;IAChB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,iEAAiE;IACjE,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0FAA0F;IAC1F,QAAQ,EAAE,QAAQ,CAAC;IACnB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,oDAAoD;IACpD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAU/C"}

package/dist/core/logging/types.js

@@ -0,0 +1,29 @@
+/**
+ * Unified Logging Types for PromptSpeak MCP Server
+ *
+ * Provides type definitions for structured logging throughout the application.
+ */
+/**
+ * Numeric priority values for log levels (used for filtering)
+ */
+export const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    critical: 4,
+};
+/**
+ * Default logger configuration based on environment
+ */
+export function getDefaultConfig() {
+    const isProduction = process.env.NODE_ENV === 'production';
+    const logLevel = process.env.LOG_LEVEL || (isProduction ? 'info' : 'debug');
+    return {
+        minLevel: logLevel,
+        format: isProduction ? 'json' : 'console',
+        includeStackTraces: !isProduction,
+        colorize: !isProduction && process.stdout.isTTY === true,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/core/logging/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/logging/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;CACZ,CAAC;AAmDF;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC3D,MAAM,QAAQ,GAAI,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAE1F,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QACzC,kBAAkB,EAAE,CAAC,YAAY;QACjC,QAAQ,EAAE,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;KACzD,CAAC;AACJ,CAAC"}

package/dist/core/patterns/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ===============================================================================
+ * COMMON DESIGN PATTERNS
+ * ===============================================================================
+ *
+ * Reusable pattern utilities to reduce boilerplate across the codebase.
+ *
+ * ===============================================================================
+ */
+export { createSingleton, createAsyncSingleton, createConfigurableSingleton, } from './singleton.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/patterns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC"}

package/dist/core/patterns/index.js

@@ -0,0 +1,11 @@
+/**
+ * ===============================================================================
+ * COMMON DESIGN PATTERNS
+ * ===============================================================================
+ *
+ * Reusable pattern utilities to reduce boilerplate across the codebase.
+ *
+ * ===============================================================================
+ */
+export { createSingleton, createAsyncSingleton, createConfigurableSingleton, } from './singleton.js';
+//# sourceMappingURL=index.js.map

package/dist/core/patterns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC"}

package/dist/core/patterns/singleton.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ===============================================================================
+ * SINGLETON PATTERN UTILITIES
+ * ===============================================================================
+ *
+ * Reusable singleton pattern implementation to reduce boilerplate.
+ * Used across: SwarmEventBus, HookRegistry, SwarmController, BootCampController, etc.
+ *
+ * Usage:
+ *   const [getInstance, resetInstance] = createSingleton(() => new MyClass());
+ *   export { getInstance as getMyClass, resetInstance as resetMyClass };
+ *
+ * ===============================================================================
+ */
+/**
+ * Creates a singleton factory with lazy initialization.
+ *
+ * @param factory - Function that creates the singleton instance
+ * @returns Tuple of [getInstance, resetInstance] functions
+ *
+ * @example
+ * ```typescript
+ * class DatabaseConnection {
+ *   constructor(private config: Config) {}
+ * }
+ *
+ * const [getDb, resetDb] = createSingleton(() => new DatabaseConnection(loadConfig()));
+ * export { getDb as getDatabaseConnection };
+ * ```
+ */
+export declare function createSingleton<T>(factory: () => T): [() => T, () => void];
+/**
+ * Creates a singleton factory with async initialization.
+ *
+ * @param factory - Async function that creates the singleton instance
+ * @returns Tuple of [getInstance, resetInstance] functions
+ *
+ * @example
+ * ```typescript
+ * const [getDb, resetDb] = createAsyncSingleton(async () => {
+ *   const db = new Database();
+ *   await db.connect();
+ *   return db;
+ * });
+ * ```
+ */
+export declare function createAsyncSingleton<T>(factory: () => Promise<T>): [() => Promise<T>, () => void];
+/**
+ * Creates a singleton with configurable initialization.
+ * Allows passing configuration on first call.
+ *
+ * @param factory - Function that creates the instance with config
+ * @returns Tuple of [getInstance, resetInstance] functions
+ *
+ * @example
+ * ```typescript
+ * const [getServer, resetServer] = createConfigurableSingleton(
+ *   (config: ServerConfig) => new Server(config)
+ * );
+ *
+ * // First call initializes with config
+ * const server = getServer({ port: 3000 });
+ *
+ * // Subsequent calls return same instance (config ignored)
+ * const sameServer = getServer({ port: 4000 }); // Returns 3000 server
+ * ```
+ */
+export declare function createConfigurableSingleton<T, C>(factory: (config: C) => T): [(config: C) => T, () => void];
+//# sourceMappingURL=singleton.d.ts.map

package/dist/core/patterns/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../../src/core/patterns/singleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAe1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAyBhC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,CAAC,EAC9C,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GACxB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC,CAehC"}