@ninebix/nmt-system 1.0.0

package/dist/src/utils/index.js

@@ -0,0 +1,50 @@
+/**
+ * Utility Functions Export
+ * @module utils
+ */
+export * from './hash.js';
+export * from './uuid.js';
+export * from './similarity.js';
+export * from './logger.js';
+export * from './metrics.js';
+/**
+ * Get current ISO8601 timestamp
+ */
+export function now() {
+    return new Date().toISOString();
+}
+/**
+ * Sleep for specified milliseconds
+ */
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Retry a function with exponential backoff
+ */
+export async function retry(fn, maxRetries = 3, baseDelayMs = 100) {
+    let lastError;
+    for (let i = 0; i < maxRetries; i++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            if (i < maxRetries - 1) {
+                await sleep(baseDelayMs * Math.pow(2, i));
+            }
+        }
+    }
+    throw lastError;
+}
+/**
+ * Chunk an array into smaller arrays
+ */
+export function chunkArray(array, size) {
+    const chunks = [];
+    for (let i = 0; i < array.length; i += size) {
+        chunks.push(array.slice(i, i + size));
+    }
+    return chunks;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,aAAqB,CAAC,EACtB,cAAsB,GAAG;IAEzB,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAY,CAAC;YACzB,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAI,KAAU,EAAE,IAAY;IACpD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Structured Logger for NMT System
+ *
+ * Provides consistent logging across all modules with:
+ * - Log levels (DEBUG, INFO, WARN, ERROR)
+ * - Structured JSON output option
+ * - Module context tracking
+ * - Performance timing helpers
+ *
+ * @module utils/logger
+ */
+/**
+ * Log levels in order of severity
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    SILENT = 4
+}
+/**
+ * Log entry structure
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: keyof typeof LogLevel;
+    module: string;
+    message: string;
+    data?: Record<string, unknown>;
+    duration?: number;
+}
+/**
+ * Logger configuration
+ */
+export interface LoggerConfig {
+    level: LogLevel;
+    json: boolean;
+    includeTimestamp: boolean;
+    module?: string;
+}
+/**
+ * Logger class for module-specific logging
+ */
+export declare class Logger {
+    private module;
+    private config;
+    constructor(module: string, config?: Partial<LoggerConfig>);
+    private log;
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Create a timer for performance measurement
+     */
+    time(label: string): () => void;
+    /**
+     * Wrap an async function with timing
+     */
+    timed<T>(label: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Create a child logger with additional context
+     */
+    child(subModule: string): Logger;
+}
+/**
+ * Configure global logger settings
+ */
+export declare function configureLogger(config: Partial<LoggerConfig>): void;
+/**
+ * Create a logger for a specific module
+ */
+export declare function createLogger(module: string, config?: Partial<LoggerConfig>): Logger;
+/**
+ * Set global log level
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Enable JSON output mode
+ */
+export declare function setJsonOutput(enabled: boolean): void;
+export declare const coreLogger: Logger;
+export declare const storageLogger: Logger;
+export declare const servicesLogger: Logger;
+export declare const cliLogger: Logger;
+export declare const apiLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,MAAM,IAAI;CACX;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,OAAO,QAAQ,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuCD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAK1D,OAAO,CAAC,GAAG;IA4BX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,IAAI;IAQ/B;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS/D;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAGjC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAEnF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEpD;AAGD,eAAO,MAAM,UAAU,QAAuB,CAAC;AAC/C,eAAO,MAAM,aAAa,QAA0B,CAAC;AACrD,eAAO,MAAM,cAAc,QAA2B,CAAC;AACvD,eAAO,MAAM,SAAS,QAAsB,CAAC;AAC7C,eAAO,MAAM,SAAS,QAAsB,CAAC"}

package/dist/src/utils/logger.js

@@ -0,0 +1,157 @@
+/**
+ * Structured Logger for NMT System
+ *
+ * Provides consistent logging across all modules with:
+ * - Log levels (DEBUG, INFO, WARN, ERROR)
+ * - Structured JSON output option
+ * - Module context tracking
+ * - Performance timing helpers
+ *
+ * @module utils/logger
+ */
+/**
+ * Log levels in order of severity
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["SILENT"] = 4] = "SILENT";
+})(LogLevel || (LogLevel = {}));
+const DEFAULT_CONFIG = {
+    level: LogLevel.INFO,
+    json: false,
+    includeTimestamp: true,
+};
+let globalConfig = { ...DEFAULT_CONFIG };
+/**
+ * Format a log entry for console output
+ */
+function formatEntry(entry, config) {
+    if (config.json) {
+        return JSON.stringify(entry);
+    }
+    const parts = [];
+    if (config.includeTimestamp) {
+        parts.push(`[${entry.timestamp}]`);
+    }
+    parts.push(`[${entry.level}]`);
+    parts.push(`[${entry.module}]`);
+    parts.push(entry.message);
+    if (entry.duration !== undefined) {
+        parts.push(`(${entry.duration}ms)`);
+    }
+    if (entry.data && Object.keys(entry.data).length > 0) {
+        parts.push(JSON.stringify(entry.data));
+    }
+    return parts.join(' ');
+}
+/**
+ * Logger class for module-specific logging
+ */
+export class Logger {
+    module;
+    config;
+    constructor(module, config) {
+        this.module = module;
+        this.config = { ...globalConfig, ...config, module };
+    }
+    log(level, levelName, message, data) {
+        if (level < this.config.level)
+            return;
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: levelName,
+            module: this.module,
+            message,
+            data,
+        };
+        const formatted = formatEntry(entry, this.config);
+        switch (level) {
+            case LogLevel.ERROR:
+                console.error(formatted);
+                break;
+            case LogLevel.WARN:
+                console.warn(formatted);
+                break;
+            case LogLevel.DEBUG:
+                console.debug(formatted);
+                break;
+            default:
+                console.log(formatted);
+        }
+    }
+    debug(message, data) {
+        this.log(LogLevel.DEBUG, 'DEBUG', message, data);
+    }
+    info(message, data) {
+        this.log(LogLevel.INFO, 'INFO', message, data);
+    }
+    warn(message, data) {
+        this.log(LogLevel.WARN, 'WARN', message, data);
+    }
+    error(message, data) {
+        this.log(LogLevel.ERROR, 'ERROR', message, data);
+    }
+    /**
+     * Create a timer for performance measurement
+     */
+    time(label) {
+        const start = performance.now();
+        return () => {
+            const duration = Math.round(performance.now() - start);
+            this.info(`${label} completed`, { duration });
+        };
+    }
+    /**
+     * Wrap an async function with timing
+     */
+    async timed(label, fn) {
+        const end = this.time(label);
+        try {
+            return await fn();
+        }
+        finally {
+            end();
+        }
+    }
+    /**
+     * Create a child logger with additional context
+     */
+    child(subModule) {
+        return new Logger(`${this.module}:${subModule}`, this.config);
+    }
+}
+/**
+ * Configure global logger settings
+ */
+export function configureLogger(config) {
+    globalConfig = { ...globalConfig, ...config };
+}
+/**
+ * Create a logger for a specific module
+ */
+export function createLogger(module, config) {
+    return new Logger(module, config);
+}
+/**
+ * Set global log level
+ */
+export function setLogLevel(level) {
+    globalConfig.level = level;
+}
+/**
+ * Enable JSON output mode
+ */
+export function setJsonOutput(enabled) {
+    globalConfig.json = enabled;
+}
+// Pre-configured loggers for common modules
+export const coreLogger = createLogger('core');
+export const storageLogger = createLogger('storage');
+export const servicesLogger = createLogger('services');
+export const cliLogger = createLogger('cli');
+export const apiLogger = createLogger('api');
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

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

package/dist/src/utils/metrics.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Metrics System - Performance and Health Monitoring
+ *
+ * Provides basic metrics collection for monitoring system performance.
+ * Supports counters, gauges, and histograms.
+ *
+ * @module utils/metrics
+ */
+/**
+ * Metric types
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram';
+/**
+ * Single metric entry
+ */
+export interface MetricEntry {
+    name: string;
+    type: MetricType;
+    value: number;
+    labels: Record<string, string>;
+    timestamp: number;
+}
+/**
+ * Histogram bucket
+ */
+export interface HistogramBucket {
+    le: number;
+    count: number;
+}
+/**
+ * Histogram data
+ */
+export interface HistogramData {
+    buckets: HistogramBucket[];
+    sum: number;
+    count: number;
+    min: number;
+    max: number;
+}
+/**
+ * Metric snapshot for export
+ */
+export interface MetricSnapshot {
+    timestamp: string;
+    uptime: number;
+    counters: Record<string, number>;
+    gauges: Record<string, number>;
+    histograms: Record<string, HistogramData>;
+}
+/**
+ * Health check result
+ */
+export interface HealthCheck {
+    name: string;
+    healthy: boolean;
+    message?: string;
+    latency?: number;
+}
+/**
+ * System health status
+ */
+export interface SystemHealth {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    checks: HealthCheck[];
+    timestamp: string;
+}
+/**
+ * Metrics Collector
+ *
+ * Collects and aggregates system metrics for monitoring.
+ *
+ * @example
+ * ```typescript
+ * const metrics = MetricsCollector.getInstance();
+ *
+ * // Increment a counter
+ * metrics.increment('requests_total', { method: 'GET', path: '/api' });
+ *
+ * // Set a gauge
+ * metrics.gauge('active_connections', 42);
+ *
+ * // Record a timing
+ * metrics.histogram('request_duration_ms', 150);
+ *
+ * // Time an operation
+ * const timer = metrics.startTimer('operation_duration_ms');
+ * await performOperation();
+ * timer();
+ *
+ * // Get snapshot
+ * const snapshot = metrics.snapshot();
+ * ```
+ */
+export declare class MetricsCollector {
+    private static instance;
+    private counters;
+    private gauges;
+    private histograms;
+    private healthChecks;
+    private startTime;
+    private defaultBuckets;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): MetricsCollector;
+    /**
+     * Reset all metrics (useful for testing)
+     */
+    reset(): void;
+    /**
+     * Increment a counter
+     *
+     * @param name - Metric name
+     * @param labels - Optional labels
+     * @param value - Increment value (default: 1)
+     */
+    increment(name: string, labels?: Record<string, string>, value?: number): void;
+    /**
+     * Get counter value
+     */
+    getCounter(name: string, labels?: Record<string, string>): number;
+    /**
+     * Set a gauge value
+     *
+     * @param name - Metric name
+     * @param value - Current value
+     * @param labels - Optional labels
+     */
+    gauge(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Get gauge value
+     */
+    getGauge(name: string, labels?: Record<string, string>): number;
+    /**
+     * Increment a gauge
+     */
+    gaugeIncrement(name: string, value?: number, labels?: Record<string, string>): void;
+    /**
+     * Decrement a gauge
+     */
+    gaugeDecrement(name: string, value?: number, labels?: Record<string, string>): void;
+    /**
+     * Record a histogram value
+     *
+     * @param name - Metric name
+     * @param value - Observed value
+     * @param labels - Optional labels
+     */
+    histogram(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Get histogram data
+     */
+    getHistogram(name: string, labels?: Record<string, string>): HistogramData | null;
+    /**
+     * Start a timer and return a function to stop it
+     */
+    startTimer(name: string, labels?: Record<string, string>): () => number;
+    /**
+     * Time an async function
+     */
+    timed<T>(name: string, fn: () => Promise<T>, labels?: Record<string, string>): Promise<T>;
+    /**
+     * Register a health check
+     *
+     * @param name - Check name
+     * @param check - Async function that returns health status
+     */
+    registerHealthCheck(name: string, check: () => Promise<HealthCheck>): void;
+    /**
+     * Unregister a health check
+     */
+    unregisterHealthCheck(name: string): void;
+    /**
+     * Run all health checks
+     */
+    checkHealth(): Promise<SystemHealth>;
+    /**
+     * Get a snapshot of all metrics
+     */
+    snapshot(): MetricSnapshot;
+    /**
+     * Export metrics in Prometheus format
+     */
+    toPrometheus(): string;
+    private buildKey;
+}
+/**
+ * Get the global metrics instance
+ */
+export declare function getMetrics(): MetricsCollector;
+/**
+ * Increment a counter
+ */
+export declare function incrementCounter(name: string, labels?: Record<string, string>, value?: number): void;
+/**
+ * Set a gauge
+ */
+export declare function setGauge(name: string, value: number, labels?: Record<string, string>): void;
+/**
+ * Record a histogram value
+ */
+export declare function recordHistogram(name: string, value: number, labels?: Record<string, string>): void;
+/**
+ * Start a timer
+ */
+export declare function startTimer(name: string, labels?: Record<string, string>): () => number;
+/**
+ * Standard metric names used across the system
+ */
+export declare const MetricNames: {
+    readonly API_REQUESTS_TOTAL: "api_requests_total";
+    readonly API_REQUEST_DURATION_MS: "api_request_duration_ms";
+    readonly API_ERRORS_TOTAL: "api_errors_total";
+    readonly NEURONS_TOTAL: "neurons_total";
+    readonly NEURONS_CREATED: "neurons_created_total";
+    readonly NEURON_LOOKUPS: "neuron_lookups_total";
+    readonly NEURON_LOOKUP_DURATION_MS: "neuron_lookup_duration_ms";
+    readonly INFERENCE_REQUESTS: "inference_requests_total";
+    readonly INFERENCE_DURATION_MS: "inference_duration_ms";
+    readonly LEARNING_SESSIONS: "learning_sessions_total";
+    readonly PATTERNS_LEARNED: "patterns_learned_total";
+    readonly EXTRACTS_CREATED: "extracts_created_total";
+    readonly ATTRACTORS_TOTAL: "attractors_total";
+    readonly ATTRACTOR_ACTIVATIONS: "attractor_activations_total";
+    readonly SUPERPOSITION_COLLAPSES: "superposition_collapses_total";
+    readonly EVOLUTION_CYCLES: "evolution_cycles_total";
+    readonly EVOLUTION_DURATION_MS: "evolution_duration_ms";
+    readonly MEMORY_USAGE_BYTES: "memory_usage_bytes";
+    readonly ACTIVE_CONNECTIONS: "active_connections";
+};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/src/utils/metrics.d.ts.map

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