specmem-hardwicksoftware 3.5.99

package/dist/utils/metrics.js

@@ -0,0 +1,558 @@
+/**
+ * metrics.ts - Prometheus Metrics Export for SpecMem
+ *
+ * yo this exposes metrics in Prometheus format
+ * request counts, latencies, memory usage, all that good stuff
+ * scrape it at /metrics and youre set fr fr
+ *
+ * Issue #27 fix - metrics export with Prometheus
+ */
+import { logger } from './logger.js';
+/**
+ * Metric types
+ */
+export var MetricType;
+(function (MetricType) {
+    MetricType["COUNTER"] = "counter";
+    MetricType["GAUGE"] = "gauge";
+    MetricType["HISTOGRAM"] = "histogram";
+    MetricType["SUMMARY"] = "summary";
+})(MetricType || (MetricType = {}));
+/**
+ * Counter metric
+ */
+class Counter {
+    values = new Map();
+    name;
+    help;
+    labelNames;
+    constructor(config) {
+        this.name = config.name;
+        this.help = config.help;
+        this.labelNames = config.labelNames || [];
+    }
+    inc(labels = {}, value = 1) {
+        const key = this.labelKey(labels);
+        this.values.set(key, (this.values.get(key) || 0) + value);
+    }
+    reset() {
+        this.values.clear();
+    }
+    collect() {
+        const lines = [
+            `# HELP ${this.name} ${this.help}`,
+            `# TYPE ${this.name} counter`
+        ];
+        for (const [key, value] of this.values) {
+            const labelStr = key ? `{${key}}` : '';
+            lines.push(`${this.name}${labelStr} ${value}`);
+        }
+        return lines.join('\n');
+    }
+    labelKey(labels) {
+        if (this.labelNames.length === 0)
+            return '';
+        return this.labelNames
+            .map(name => `${name}="${labels[name] || ''}"`)
+            .join(',');
+    }
+}
+/**
+ * Gauge metric
+ */
+class Gauge {
+    values = new Map();
+    name;
+    help;
+    labelNames;
+    constructor(config) {
+        this.name = config.name;
+        this.help = config.help;
+        this.labelNames = config.labelNames || [];
+    }
+    set(labelsOrValue, maybeValue) {
+        if (typeof labelsOrValue === 'number') {
+            this.values.set('', labelsOrValue);
+        }
+        else {
+            const key = this.labelKey(labelsOrValue);
+            this.values.set(key, maybeValue);
+        }
+    }
+    inc(labels = {}, value = 1) {
+        const key = this.labelKey(labels);
+        this.values.set(key, (this.values.get(key) || 0) + value);
+    }
+    dec(labels = {}, value = 1) {
+        const key = this.labelKey(labels);
+        this.values.set(key, (this.values.get(key) || 0) - value);
+    }
+    reset() {
+        this.values.clear();
+    }
+    collect() {
+        const lines = [
+            `# HELP ${this.name} ${this.help}`,
+            `# TYPE ${this.name} gauge`
+        ];
+        for (const [key, value] of this.values) {
+            const labelStr = key ? `{${key}}` : '';
+            lines.push(`${this.name}${labelStr} ${value}`);
+        }
+        return lines.join('\n');
+    }
+    labelKey(labels) {
+        if (this.labelNames.length === 0)
+            return '';
+        return this.labelNames
+            .map(name => `${name}="${labels[name] || ''}"`)
+            .join(',');
+    }
+}
+/**
+ * Histogram metric
+ */
+class Histogram {
+    buckets;
+    counts = new Map();
+    sums = new Map();
+    totalCounts = new Map();
+    name;
+    help;
+    labelNames;
+    constructor(config) {
+        this.name = config.name;
+        this.help = config.help;
+        this.labelNames = config.labelNames || [];
+        // Default buckets for latency in seconds
+        this.buckets = config.buckets || [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+    }
+    observe(labelsOrValue, maybeValue) {
+        let labels = {};
+        let value;
+        if (typeof labelsOrValue === 'number') {
+            value = labelsOrValue;
+        }
+        else {
+            labels = labelsOrValue;
+            value = maybeValue;
+        }
+        const key = this.labelKey(labels);
+        // Initialize bucket counts if needed
+        if (!this.counts.has(key)) {
+            this.counts.set(key, new Map(this.buckets.map(b => [b, 0])));
+        }
+        // Update bucket counts
+        const bucketCounts = this.counts.get(key);
+        for (const bucket of this.buckets) {
+            if (value <= bucket) {
+                bucketCounts.set(bucket, (bucketCounts.get(bucket) || 0) + 1);
+            }
+        }
+        // Update sum and count
+        this.sums.set(key, (this.sums.get(key) || 0) + value);
+        this.totalCounts.set(key, (this.totalCounts.get(key) || 0) + 1);
+    }
+    /**
+     * Timer helper for measuring durations
+     */
+    startTimer(labels = {}) {
+        const start = process.hrtime.bigint();
+        return () => {
+            const end = process.hrtime.bigint();
+            const durationSeconds = Number(end - start) / 1e9;
+            this.observe(labels, durationSeconds);
+        };
+    }
+    reset() {
+        this.counts.clear();
+        this.sums.clear();
+        this.totalCounts.clear();
+    }
+    collect() {
+        const lines = [
+            `# HELP ${this.name} ${this.help}`,
+            `# TYPE ${this.name} histogram`
+        ];
+        for (const [key, bucketCounts] of this.counts) {
+            const labelPrefix = key ? `${key},` : '';
+            let cumulative = 0;
+            for (const bucket of this.buckets) {
+                cumulative += bucketCounts.get(bucket) || 0;
+                const le = bucket === Infinity ? '+Inf' : bucket.toString();
+                lines.push(`${this.name}_bucket{${labelPrefix}le="${le}"} ${cumulative}`);
+            }
+            // +Inf bucket (total count)
+            lines.push(`${this.name}_bucket{${labelPrefix}le="+Inf"} ${this.totalCounts.get(key) || 0}`);
+            lines.push(`${this.name}_sum{${key || ''}} ${this.sums.get(key) || 0}`);
+            lines.push(`${this.name}_count{${key || ''}} ${this.totalCounts.get(key) || 0}`);
+        }
+        return lines.join('\n');
+    }
+    labelKey(labels) {
+        if (this.labelNames.length === 0)
+            return '';
+        return this.labelNames
+            .map(name => `${name}="${labels[name] || ''}"`)
+            .join(',');
+    }
+}
+/**
+ * MetricsRegistry - manages all metrics
+ */
+class MetricsRegistry {
+    counters = new Map();
+    gauges = new Map();
+    histograms = new Map();
+    collectCallbacks = [];
+    /**
+     * Create and register a counter
+     */
+    counter(config) {
+        if (this.counters.has(config.name)) {
+            return this.counters.get(config.name);
+        }
+        const counter = new Counter(config);
+        this.counters.set(config.name, counter);
+        return counter;
+    }
+    /**
+     * Create and register a gauge
+     */
+    gauge(config) {
+        if (this.gauges.has(config.name)) {
+            return this.gauges.get(config.name);
+        }
+        const gauge = new Gauge(config);
+        this.gauges.set(config.name, gauge);
+        return gauge;
+    }
+    /**
+     * Create and register a histogram
+     */
+    histogram(config) {
+        if (this.histograms.has(config.name)) {
+            return this.histograms.get(config.name);
+        }
+        const histogram = new Histogram(config);
+        this.histograms.set(config.name, histogram);
+        return histogram;
+    }
+    /**
+     * Register a callback to collect metrics on demand
+     */
+    registerCollectCallback(callback) {
+        this.collectCallbacks.push(callback);
+    }
+    /**
+     * Collect all metrics in Prometheus format
+     */
+    collect() {
+        // Run collect callbacks first
+        for (const callback of this.collectCallbacks) {
+            try {
+                callback();
+            }
+            catch (error) {
+                logger.warn({ error }, 'metric collect callback failed');
+            }
+        }
+        const sections = [];
+        // Collect counters
+        for (const counter of this.counters.values()) {
+            sections.push(counter.collect());
+        }
+        // Collect gauges
+        for (const gauge of this.gauges.values()) {
+            sections.push(gauge.collect());
+        }
+        // Collect histograms
+        for (const histogram of this.histograms.values()) {
+            sections.push(histogram.collect());
+        }
+        return sections.join('\n\n') + '\n';
+    }
+    /**
+     * Reset all metrics
+     */
+    reset() {
+        for (const counter of this.counters.values()) {
+            counter.reset();
+        }
+        for (const gauge of this.gauges.values()) {
+            gauge.reset();
+        }
+        for (const histogram of this.histograms.values()) {
+            histogram.reset();
+        }
+    }
+    /**
+     * Clear the registry
+     */
+    clear() {
+        this.counters.clear();
+        this.gauges.clear();
+        this.histograms.clear();
+        this.collectCallbacks = [];
+    }
+}
+// Singleton registry
+let registryInstance = null;
+/**
+ * Get the global metrics registry
+ */
+export function getMetricsRegistry() {
+    if (!registryInstance) {
+        registryInstance = new MetricsRegistry();
+        initializeDefaultMetrics();
+    }
+    return registryInstance;
+}
+/**
+ * Reset the global registry
+ */
+export function resetMetricsRegistry() {
+    if (registryInstance) {
+        registryInstance.clear();
+    }
+    registryInstance = null;
+}
+// ============================================================================
+// Default SpecMem Metrics
+// ============================================================================
+/**
+ * Initialize default metrics for SpecMem
+ */
+function initializeDefaultMetrics() {
+    const registry = registryInstance;
+    // HTTP request metrics
+    registry.counter({
+        name: 'specmem_http_requests_total',
+        help: 'Total number of HTTP requests',
+        labelNames: ['method', 'path', 'status']
+    });
+    registry.histogram({
+        name: 'specmem_http_request_duration_seconds',
+        help: 'HTTP request latency in seconds',
+        labelNames: ['method', 'path'],
+        buckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5]
+    });
+    // Database metrics
+    registry.counter({
+        name: 'specmem_db_queries_total',
+        help: 'Total number of database queries',
+        labelNames: ['operation', 'status']
+    });
+    registry.histogram({
+        name: 'specmem_db_query_duration_seconds',
+        help: 'Database query latency in seconds',
+        labelNames: ['operation'],
+        buckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10]
+    });
+    registry.gauge({
+        name: 'specmem_db_pool_total_connections',
+        help: 'Total connections in database pool'
+    });
+    registry.gauge({
+        name: 'specmem_db_pool_idle_connections',
+        help: 'Idle connections in database pool'
+    });
+    registry.gauge({
+        name: 'specmem_db_pool_waiting_requests',
+        help: 'Requests waiting for database connection'
+    });
+    // Memory metrics
+    registry.gauge({
+        name: 'specmem_memory_heap_used_bytes',
+        help: 'Heap memory used in bytes'
+    });
+    registry.gauge({
+        name: 'specmem_memory_heap_total_bytes',
+        help: 'Total heap memory in bytes'
+    });
+    registry.gauge({
+        name: 'specmem_memory_rss_bytes',
+        help: 'Resident set size in bytes'
+    });
+    registry.gauge({
+        name: 'specmem_memory_external_bytes',
+        help: 'External memory in bytes'
+    });
+    registry.gauge({
+        name: 'specmem_memory_pressure_level',
+        help: 'Memory pressure level (0=normal, 1=warning, 2=critical, 3=emergency)',
+        labelNames: ['level']
+    });
+    // Embedding cache metrics
+    registry.gauge({
+        name: 'specmem_embedding_cache_size',
+        help: 'Number of entries in embedding cache'
+    });
+    registry.counter({
+        name: 'specmem_embedding_cache_hits_total',
+        help: 'Total embedding cache hits'
+    });
+    registry.counter({
+        name: 'specmem_embedding_cache_misses_total',
+        help: 'Total embedding cache misses'
+    });
+    // MCP tool metrics
+    registry.counter({
+        name: 'specmem_mcp_tool_calls_total',
+        help: 'Total MCP tool calls',
+        labelNames: ['tool', 'status']
+    });
+    registry.histogram({
+        name: 'specmem_mcp_tool_duration_seconds',
+        help: 'MCP tool call duration in seconds',
+        labelNames: ['tool'],
+        buckets: [0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30]
+    });
+    // Memory count metrics
+    registry.gauge({
+        name: 'specmem_memories_total',
+        help: 'Total number of memories in database'
+    });
+    registry.gauge({
+        name: 'specmem_memories_with_embeddings',
+        help: 'Number of memories with embeddings'
+    });
+    // File indexer metrics
+    registry.gauge({
+        name: 'specmem_codebase_files_total',
+        help: 'Total files in codebase index'
+    });
+    registry.gauge({
+        name: 'specmem_codebase_lines_total',
+        help: 'Total lines of code indexed'
+    });
+    // Error metrics
+    registry.counter({
+        name: 'specmem_errors_total',
+        help: 'Total errors',
+        labelNames: ['type', 'severity']
+    });
+    // Circuit breaker metrics
+    registry.gauge({
+        name: 'specmem_circuit_breaker_state',
+        help: 'Circuit breaker state (0=closed, 1=half-open, 2=open)',
+        labelNames: ['name']
+    });
+    registry.counter({
+        name: 'specmem_circuit_breaker_trips_total',
+        help: 'Total circuit breaker trips',
+        labelNames: ['name']
+    });
+    // WebSocket metrics
+    registry.gauge({
+        name: 'specmem_websocket_connections',
+        help: 'Current WebSocket connections'
+    });
+    registry.counter({
+        name: 'specmem_websocket_messages_total',
+        help: 'Total WebSocket messages',
+        labelNames: ['direction', 'type']
+    });
+    // Register process metrics collection
+    registry.registerCollectCallback(collectProcessMetrics);
+}
+/**
+ * Collect Node.js process metrics
+ */
+function collectProcessMetrics() {
+    const registry = registryInstance;
+    if (!registry)
+        return;
+    const mem = process.memoryUsage();
+    const heapUsed = registry.gauge({
+        name: 'specmem_memory_heap_used_bytes',
+        help: 'Heap memory used in bytes'
+    });
+    heapUsed.set(mem.heapUsed);
+    const heapTotal = registry.gauge({
+        name: 'specmem_memory_heap_total_bytes',
+        help: 'Total heap memory in bytes'
+    });
+    heapTotal.set(mem.heapTotal);
+    const rss = registry.gauge({
+        name: 'specmem_memory_rss_bytes',
+        help: 'Resident set size in bytes'
+    });
+    rss.set(mem.rss);
+    const external = registry.gauge({
+        name: 'specmem_memory_external_bytes',
+        help: 'External memory in bytes'
+    });
+    external.set(mem.external);
+}
+// ============================================================================
+// Convenience functions
+// ============================================================================
+/**
+ * Get HTTP request counter
+ */
+export function getHttpRequestCounter() {
+    return getMetricsRegistry().counter({
+        name: 'specmem_http_requests_total',
+        help: 'Total number of HTTP requests',
+        labelNames: ['method', 'path', 'status']
+    });
+}
+/**
+ * Get HTTP request duration histogram
+ */
+export function getHttpDurationHistogram() {
+    return getMetricsRegistry().histogram({
+        name: 'specmem_http_request_duration_seconds',
+        help: 'HTTP request latency in seconds',
+        labelNames: ['method', 'path']
+    });
+}
+/**
+ * Get database query counter
+ */
+export function getDbQueryCounter() {
+    return getMetricsRegistry().counter({
+        name: 'specmem_db_queries_total',
+        help: 'Total number of database queries',
+        labelNames: ['operation', 'status']
+    });
+}
+/**
+ * Get database query duration histogram
+ */
+export function getDbDurationHistogram() {
+    return getMetricsRegistry().histogram({
+        name: 'specmem_db_query_duration_seconds',
+        help: 'Database query latency in seconds',
+        labelNames: ['operation']
+    });
+}
+/**
+ * Get MCP tool counter
+ */
+export function getMcpToolCounter() {
+    return getMetricsRegistry().counter({
+        name: 'specmem_mcp_tool_calls_total',
+        help: 'Total MCP tool calls',
+        labelNames: ['tool', 'status']
+    });
+}
+/**
+ * Get error counter
+ */
+export function getErrorCounter() {
+    return getMetricsRegistry().counter({
+        name: 'specmem_errors_total',
+        help: 'Total errors',
+        labelNames: ['type', 'severity']
+    });
+}
+/**
+ * Collect all metrics and return as Prometheus format string
+ */
+export function collectMetrics() {
+    return getMetricsRegistry().collect();
+}
+export { Counter, Gauge, Histogram, MetricsRegistry };
+//# sourceMappingURL=metrics.js.map

package/dist/utils/metrics.js.map

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

package/dist/utils/pathValidator.d.ts

@@ -0,0 +1,96 @@
+/**
+ * pathValidator.ts - File Path Security for SpecMem
+ *
+ * yo this module sanitizes all file paths
+ * prevents directory traversal attacks and other sketchy stuff
+ * no more ../../../etc/passwd fr fr
+ *
+ * Issue #36 fix - input sanitization on file paths
+ */
+/**
+ * Path validation result
+ */
+export interface PathValidationResult {
+    valid: boolean;
+    normalizedPath: string | null;
+    error?: string;
+    securityIssue?: string;
+}
+/**
+ * Path validator configuration
+ */
+export interface PathValidatorConfig {
+    /** Allowed base directories (whitelist) */
+    allowedBaseDirs: string[];
+    /** Maximum path length */
+    maxPathLength: number;
+    /** Allow symlinks */
+    allowSymlinks: boolean;
+    /** Blocked path patterns (regex) */
+    blockedPatterns: RegExp[];
+    /** Blocked file names */
+    blockedFileNames: string[];
+}
+/**
+ * PathValidator - secure file path handling
+ *
+ * Features that keep us SAFE:
+ * - Directory traversal detection
+ * - Path normalization
+ * - Whitelist enforcement
+ * - Symlink protection
+ * - Sensitive file blocking
+ */
+export declare class PathValidator {
+    private config;
+    constructor(config?: Partial<PathValidatorConfig>);
+    /**
+     * Validate and normalize a file path
+     */
+    validate(inputPath: string, basePath?: string): PathValidationResult;
+    /**
+     * Quick check for directory traversal patterns
+     */
+    private containsTraversal;
+    /**
+     * Sanitize a filename (just the name, no path)
+     */
+    sanitizeFileName(fileName: string): string;
+    /**
+     * Check if a path is within a specific directory
+     */
+    isWithinDirectory(targetPath: string, baseDir: string): boolean;
+    /**
+     * Get a safe relative path
+     */
+    getSafeRelativePath(fullPath: string, baseDir: string): string | null;
+    /**
+     * Add a directory to the whitelist
+     */
+    addAllowedBaseDir(dir: string): void;
+    /**
+     * Remove a directory from the whitelist
+     */
+    removeAllowedBaseDir(dir: string): void;
+}
+/**
+ * Get the global path validator
+ */
+export declare function getPathValidator(config?: Partial<PathValidatorConfig>): PathValidator;
+/**
+ * Reset the global path validator (for testing)
+ */
+export declare function resetPathValidator(): void;
+/**
+ * Convenience function - validate a path
+ */
+export declare function validatePath(inputPath: string, basePath?: string): PathValidationResult;
+/**
+ * Convenience function - sanitize a filename
+ */
+export declare function sanitizeFileName(fileName: string): string;
+/**
+ * Convenience function - check if path is within directory
+ */
+export declare function isPathWithin(targetPath: string, baseDir: string): boolean;
+//# sourceMappingURL=pathValidator.d.ts.map

package/dist/utils/pathValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathValidator.d.ts","sourceRoot":"","sources":["../../src/utils/pathValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,yBAAyB;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAkCD;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAIrD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,oBAAoB;IA0JpE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAuB1C;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAQ/D;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUrE;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQpC;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAQxC;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,aAAa,CAKrF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAEvF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzE"}