specmem-hardwicksoftware 3.5.99

package/dist/events/metrics.js

@@ -0,0 +1,343 @@
+/**
+ * metrics.ts - Performance Monitoring System
+ *
+ * Tracks event bus performance metrics to ensure sub-25ms dispatch latency
+ * Inspired by LWJEB's focus on speed and performance optimization
+ *
+ * Key metrics tracked:
+ * - Publish latency (p50, p95, p99)
+ * - Cache hit/miss rates
+ * - Handler execution times
+ * - Queue depths
+ * - Error rates
+ *
+ * @author hardwicksoftwareservices
+ */
+import { logger } from '../utils/logger.js';
+/**
+ * Performance metrics implementation
+ */
+class PerformanceMetricsImpl {
+    identifier;
+    totalPublishes = 0;
+    totalSubscribes = 0;
+    totalUnsubscribes = 0;
+    totalDispatches = 0;
+    totalErrors = 0;
+    cacheHits = 0;
+    cacheMisses = 0;
+    cacheInvalidations = 0;
+    publishLatencies = [];
+    dispatchLatencies = [];
+    startTime;
+    maxSamples;
+    warningThresholdMs;
+    constructor(identifier, maxSamples = 10000, warningThresholdMs = 25) {
+        this.identifier = identifier;
+        this.startTime = Date.now();
+        this.maxSamples = maxSamples;
+        this.warningThresholdMs = warningThresholdMs;
+    }
+    recordPublish(durationMs) {
+        this.totalPublishes++;
+        this.addLatencySample(this.publishLatencies, durationMs);
+        // Warn if exceeding threshold
+        if (durationMs > this.warningThresholdMs) {
+            logger.warn({
+                metric: 'publishLatency',
+                duration: durationMs,
+                threshold: this.warningThresholdMs
+            }, 'publish latency exceeded threshold');
+        }
+    }
+    recordDispatch(durationMs) {
+        this.totalDispatches++;
+        this.addLatencySample(this.dispatchLatencies, durationMs);
+        // Warn if exceeding threshold
+        if (durationMs > this.warningThresholdMs) {
+            logger.warn({
+                metric: 'dispatchLatency',
+                duration: durationMs,
+                threshold: this.warningThresholdMs
+            }, 'dispatch latency exceeded threshold');
+        }
+    }
+    recordCacheHit() {
+        this.cacheHits++;
+    }
+    recordCacheMiss() {
+        this.cacheMisses++;
+    }
+    recordCacheInvalidation() {
+        this.cacheInvalidations++;
+    }
+    recordSubscribe() {
+        this.totalSubscribes++;
+    }
+    recordUnsubscribe() {
+        this.totalUnsubscribes++;
+    }
+    recordError() {
+        this.totalErrors++;
+    }
+    addLatencySample(samples, value) {
+        samples.push(value);
+        // Keep only recent samples to bound memory
+        if (samples.length > this.maxSamples) {
+            samples.shift();
+        }
+    }
+    getStats() {
+        const uptime = (Date.now() - this.startTime) / 1000; // seconds
+        return {
+            identifier: this.identifier,
+            uptime,
+            publishRate: uptime > 0 ? this.totalPublishes / uptime : 0,
+            dispatchRate: uptime > 0 ? this.totalDispatches / uptime : 0,
+            publishLatency: this.calculatePercentiles(this.publishLatencies),
+            dispatchLatency: this.calculatePercentiles(this.dispatchLatencies),
+            cacheHitRate: this.calculateRate(this.cacheHits, this.cacheHits + this.cacheMisses),
+            cacheMissRate: this.calculateRate(this.cacheMisses, this.cacheHits + this.cacheMisses),
+            errorRate: this.calculateRate(this.totalErrors, this.totalDispatches),
+            totals: {
+                publishes: this.totalPublishes,
+                subscribes: this.totalSubscribes,
+                unsubscribes: this.totalUnsubscribes,
+                dispatches: this.totalDispatches,
+                errors: this.totalErrors,
+                cacheHits: this.cacheHits,
+                cacheMisses: this.cacheMisses,
+                cacheInvalidations: this.cacheInvalidations
+            }
+        };
+    }
+    reset() {
+        this.totalPublishes = 0;
+        this.totalSubscribes = 0;
+        this.totalUnsubscribes = 0;
+        this.totalDispatches = 0;
+        this.totalErrors = 0;
+        this.cacheHits = 0;
+        this.cacheMisses = 0;
+        this.cacheInvalidations = 0;
+        this.publishLatencies = [];
+        this.dispatchLatencies = [];
+        this.startTime = Date.now();
+    }
+    calculatePercentiles(samples) {
+        if (samples.length === 0) {
+            return {
+                min: 0,
+                max: 0,
+                mean: 0,
+                p50: 0,
+                p95: 0,
+                p99: 0
+            };
+        }
+        const sorted = [...samples].sort((a, b) => a - b);
+        const len = sorted.length;
+        return {
+            min: sorted[0] ?? 0,
+            max: sorted[len - 1] ?? 0,
+            mean: samples.reduce((a, b) => a + b, 0) / len,
+            p50: this.percentile(sorted, 50),
+            p95: this.percentile(sorted, 95),
+            p99: this.percentile(sorted, 99)
+        };
+    }
+    percentile(sorted, p) {
+        if (sorted.length === 0)
+            return 0;
+        const index = Math.ceil((p / 100) * sorted.length) - 1;
+        return sorted[Math.max(0, Math.min(index, sorted.length - 1))] ?? 0;
+    }
+    calculateRate(numerator, denominator) {
+        return denominator > 0 ? numerator / denominator : 0;
+    }
+}
+/**
+ * Create a new metrics instance
+ */
+export function createMetrics(identifier) {
+    return new PerformanceMetricsImpl(identifier);
+}
+/**
+ * Metrics aggregator for multiple publishers
+ */
+export class MetricsAggregator {
+    metrics = new Map();
+    /**
+     * Register a metrics instance
+     */
+    register(metrics) {
+        this.metrics.set(metrics.identifier, metrics);
+    }
+    /**
+     * Unregister a metrics instance
+     */
+    unregister(identifier) {
+        this.metrics.delete(identifier);
+    }
+    /**
+     * Get aggregated stats across all instances
+     */
+    getAggregatedStats() {
+        const allStats = Array.from(this.metrics.values()).map(m => m.getStats());
+        if (allStats.length === 0) {
+            return this.emptyAggregatedStats();
+        }
+        // Aggregate totals
+        const totals = allStats.reduce((acc, stats) => ({
+            publishes: acc.publishes + stats.totals.publishes,
+            subscribes: acc.subscribes + stats.totals.subscribes,
+            unsubscribes: acc.unsubscribes + stats.totals.unsubscribes,
+            dispatches: acc.dispatches + stats.totals.dispatches,
+            errors: acc.errors + stats.totals.errors,
+            cacheHits: acc.cacheHits + stats.totals.cacheHits,
+            cacheMisses: acc.cacheMisses + stats.totals.cacheMisses,
+            cacheInvalidations: acc.cacheInvalidations + stats.totals.cacheInvalidations
+        }), {
+            publishes: 0,
+            subscribes: 0,
+            unsubscribes: 0,
+            dispatches: 0,
+            errors: 0,
+            cacheHits: 0,
+            cacheMisses: 0,
+            cacheInvalidations: 0
+        });
+        // Calculate aggregate rates
+        const totalCacheRequests = totals.cacheHits + totals.cacheMisses;
+        return {
+            instanceCount: allStats.length,
+            averageUptime: allStats.reduce((sum, s) => sum + s.uptime, 0) / allStats.length,
+            aggregatePublishRate: allStats.reduce((sum, s) => sum + s.publishRate, 0),
+            aggregateDispatchRate: allStats.reduce((sum, s) => sum + s.dispatchRate, 0),
+            averagePublishLatency: this.averageLatencyPercentiles(allStats.map(s => s.publishLatency)),
+            averageDispatchLatency: this.averageLatencyPercentiles(allStats.map(s => s.dispatchLatency)),
+            aggregateCacheHitRate: totalCacheRequests > 0 ? totals.cacheHits / totalCacheRequests : 0,
+            aggregateErrorRate: totals.dispatches > 0 ? totals.errors / totals.dispatches : 0,
+            totals,
+            byInstance: Object.fromEntries(allStats.map(s => [s.identifier, s]))
+        };
+    }
+    /**
+     * Check if any instance is exceeding latency targets
+     */
+    checkLatencyHealth(targetMs = 25) {
+        const violations = [];
+        for (const metrics of this.metrics.values()) {
+            const stats = metrics.getStats();
+            if (stats.publishLatency.p95 > targetMs || stats.dispatchLatency.p95 > targetMs) {
+                violations.push({
+                    identifier: stats.identifier,
+                    p95: Math.max(stats.publishLatency.p95, stats.dispatchLatency.p95),
+                    p99: Math.max(stats.publishLatency.p99, stats.dispatchLatency.p99)
+                });
+            }
+        }
+        return {
+            healthy: violations.length === 0,
+            targetMs,
+            violations
+        };
+    }
+    averageLatencyPercentiles(all) {
+        if (all.length === 0) {
+            return { min: 0, max: 0, mean: 0, p50: 0, p95: 0, p99: 0 };
+        }
+        return {
+            min: Math.min(...all.map(p => p.min)),
+            max: Math.max(...all.map(p => p.max)),
+            mean: all.reduce((sum, p) => sum + p.mean, 0) / all.length,
+            p50: all.reduce((sum, p) => sum + p.p50, 0) / all.length,
+            p95: all.reduce((sum, p) => sum + p.p95, 0) / all.length,
+            p99: all.reduce((sum, p) => sum + p.p99, 0) / all.length
+        };
+    }
+    emptyAggregatedStats() {
+        return {
+            instanceCount: 0,
+            averageUptime: 0,
+            aggregatePublishRate: 0,
+            aggregateDispatchRate: 0,
+            averagePublishLatency: { min: 0, max: 0, mean: 0, p50: 0, p95: 0, p99: 0 },
+            averageDispatchLatency: { min: 0, max: 0, mean: 0, p50: 0, p95: 0, p99: 0 },
+            aggregateCacheHitRate: 0,
+            aggregateErrorRate: 0,
+            totals: {
+                publishes: 0,
+                subscribes: 0,
+                unsubscribes: 0,
+                dispatches: 0,
+                errors: 0,
+                cacheHits: 0,
+                cacheMisses: 0,
+                cacheInvalidations: 0
+            },
+            byInstance: {}
+        };
+    }
+}
+/**
+ * Global metrics aggregator singleton
+ */
+let globalAggregator = null;
+export function getGlobalAggregator() {
+    if (!globalAggregator) {
+        globalAggregator = new MetricsAggregator();
+    }
+    return globalAggregator;
+}
+export function resetGlobalAggregator() {
+    globalAggregator = null;
+}
+/**
+ * Format metrics for display
+ */
+export function formatMetricStats(stats) {
+    const lines = [
+        `=== Event Bus Metrics: ${stats.identifier} ===`,
+        `Uptime: ${stats.uptime.toFixed(1)}s`,
+        '',
+        '-- Throughput --',
+        `Publish Rate: ${stats.publishRate.toFixed(2)}/s`,
+        `Dispatch Rate: ${stats.dispatchRate.toFixed(2)}/s`,
+        '',
+        '-- Publish Latency (ms) --',
+        `  Min: ${stats.publishLatency.min.toFixed(2)}`,
+        `  Mean: ${stats.publishLatency.mean.toFixed(2)}`,
+        `  P50: ${stats.publishLatency.p50.toFixed(2)}`,
+        `  P95: ${stats.publishLatency.p95.toFixed(2)}`,
+        `  P99: ${stats.publishLatency.p99.toFixed(2)}`,
+        `  Max: ${stats.publishLatency.max.toFixed(2)}`,
+        '',
+        '-- Dispatch Latency (ms) --',
+        `  Min: ${stats.dispatchLatency.min.toFixed(2)}`,
+        `  Mean: ${stats.dispatchLatency.mean.toFixed(2)}`,
+        `  P50: ${stats.dispatchLatency.p50.toFixed(2)}`,
+        `  P95: ${stats.dispatchLatency.p95.toFixed(2)}`,
+        `  P99: ${stats.dispatchLatency.p99.toFixed(2)}`,
+        `  Max: ${stats.dispatchLatency.max.toFixed(2)}`,
+        '',
+        '-- Cache Performance --',
+        `Hit Rate: ${(stats.cacheHitRate * 100).toFixed(1)}%`,
+        `Miss Rate: ${(stats.cacheMissRate * 100).toFixed(1)}%`,
+        '',
+        '-- Error Rate --',
+        `${(stats.errorRate * 100).toFixed(2)}%`,
+        '',
+        '-- Totals --',
+        `Publishes: ${stats.totals.publishes}`,
+        `Dispatches: ${stats.totals.dispatches}`,
+        `Subscribes: ${stats.totals.subscribes}`,
+        `Unsubscribes: ${stats.totals.unsubscribes}`,
+        `Errors: ${stats.totals.errors}`,
+        `Cache Hits: ${stats.totals.cacheHits}`,
+        `Cache Misses: ${stats.totals.cacheMisses}`,
+        `Cache Invalidations: ${stats.totals.cacheInvalidations}`
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=metrics.js.map

package/dist/events/metrics.js.map

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

package/dist/hooks/cli.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * SPECMEM HOOKS CLI
+ * =================
+ *
+ * CLI entry point for SpecMem hooks.
+ * This allows hooks to be called from  Code settings.
+ *
+ * Usage in ~/.claude/settings.json:
+ * {
+ *   "hooks": {
+ *     "UserPromptSubmit": {
+ *       "command": "npx specmem-hook"
+ *     }
+ *   }
+ * }
+ *
+ * Or if installed globally:
+ * {
+ *   "hooks": {
+ *     "UserPromptSubmit": {
+ *       "command": "specmem-hook"
+ *     }
+ *   }
+ * }
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/hooks/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/hooks/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}

package/dist/hooks/cli.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * SPECMEM HOOKS CLI
+ * =================
+ *
+ * CLI entry point for SpecMem hooks.
+ * This allows hooks to be called from  Code settings.
+ *
+ * Usage in ~/.claude/settings.json:
+ * {
+ *   "hooks": {
+ *     "UserPromptSubmit": {
+ *       "command": "npx specmem-hook"
+ *     }
+ *   }
+ * }
+ *
+ * Or if installed globally:
+ * {
+ *   "hooks": {
+ *     "UserPromptSubmit": {
+ *       "command": "specmem-hook"
+ *     }
+ *   }
+ * }
+ */
+import { contextInjectionHook } from './contextInjectionHook.js';
+import { startDrilldown, getFinalContext, DRILLDOWN_DEPTHS } from './drilldownHook.js';
+async function main() {
+    // Read input from stdin
+    let input = '';
+    process.stdin.setEncoding('utf8');
+    for await (const chunk of process.stdin) {
+        input += chunk;
+    }
+    // Determine hook mode from args
+    const mode = process.argv[2] || 'context';
+    // Parse input - could be JSON or plain text
+    let prompt = '';
+    let sessionId = `hook_${Date.now()}`;
+    try {
+        const data = JSON.parse(input);
+        prompt = data.prompt || data.message || data.content || '';
+        sessionId = data.sessionId || sessionId;
+    }
+    catch {
+        prompt = input.trim();
+    }
+    // Skip if prompt too short
+    if (!prompt || prompt.length < 5) {
+        process.exit(0);
+    }
+    try {
+        switch (mode) {
+            case 'context':
+                // Default mode: inject context
+                const context = await contextInjectionHook(prompt);
+                if (context) {
+                    console.log(context);
+                }
+                break;
+            case 'drilldown':
+                // Interactive drilldown mode
+                const depth = process.argv[3] || 'standard';
+                if (!DRILLDOWN_DEPTHS[depth]) {
+                    console.error(`Invalid depth: ${depth}. Use: light, standard, deep, exhaustive`);
+                    process.exit(1);
+                }
+                const state = await startDrilldown(sessionId, prompt, depth);
+                const drillContext = getFinalContext(sessionId);
+                console.log(drillContext);
+                break;
+            case 'help':
+                console.log(`
+SpecMem Hooks CLI
+=================
+
+Usage: specmem-hook [mode] [options]
+
+Modes:
+  context     (default) Inject related SpecMem context into prompt
+  drilldown   Start interactive drilldown session
+  help        Show this help
+
+Drilldown depths:
+  light       10 memories, 0.4 threshold, 50MB RAM
+  standard    20 memories, 0.3 threshold, 100MB RAM
+  deep        50 memories, 0.2 threshold, 150MB RAM
+  exhaustive  100 memories, 0.1 threshold, 150MB RAM
+
+Environment variables:
+  SPECMEM_DB_HOST       Database host (default: localhost)
+  SPECMEM_DB_PORT       Database port (default: 5432)
+  SPECMEM_DB_NAME       Database name (default: specmem)
+  SPECMEM_DB_USER       Database user (default: specmem)
+  SPECMEM_DB_PASSWORD   Database password (default: specmem)
+  SPECMEM_CONFIG_PATH   Path to config file (default: ~/.specmem/config.json)
+  SPECMEM_CONTEXT_HOOK  Enable/disable hook (default: true)
+  SPECMEM_COMPRESS      Enable Chinese Compactor (default: true)
+
+Examples:
+  echo "how does auth work" | specmem-hook
+  echo "explain the database schema" | specmem-hook drilldown deep
+        `);
+                break;
+            default:
+                console.error(`Unknown mode: ${mode}`);
+                process.exit(1);
+        }
+    }
+    catch (error) {
+        // Silent fail - don't break the prompt
+        console.error(`[SpecMem Hook Error] ${error instanceof Error ? error.message : 'Unknown error'}`);
+        process.exit(0);
+    }
+}
+main().catch(() => process.exit(0));
+//# sourceMappingURL=cli.js.map

package/dist/hooks/cli.js.map

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

package/dist/hooks/contextInjectionHook.d.ts

@@ -0,0 +1,60 @@
+/**
+ * SPECMEM CONTEXT INJECTION HOOK
+ * ==============================
+ *
+ * Native SpecMem hook that auto-injects context into every prompt.
+ * This is the CORE of the drilldown flow - it intercepts prompts
+ * and enriches them with relevant memory context.
+ *
+ * Flow:
+ *   1. User submits prompt
+ *   2. Hook generates embedding for prompt (via sandboxed container)
+ *   3. Hook searches SpecMem for semantically similar memories
+ *   4. Context is injected into the prompt
+ *   5.  sees enriched prompt with related context
+ *
+ * This hook uses:
+ *   - Sandboxed embedding container (all-MiniLM-L6-v2, 384 dims)
+ *   - PostgreSQL pgvector for semantic search
+ *   - Chinese Compactor for token efficiency
+ */
+export interface ContextHookConfig {
+    searchLimit: number;
+    threshold: number;
+    maxContentLength: number;
+    dbHost: string;
+    dbPort: number;
+    dbName: string;
+    dbUser: string;
+    dbPassword: string;
+    embeddingSocket: string;
+    enabled: boolean;
+    compressContext: boolean;
+    includeMetadata: boolean;
+}
+declare const DEFAULT_CONFIG: ContextHookConfig;
+/**
+ * Memory search result
+ */
+export interface MemoryResult {
+    id: string;
+    content: string;
+    importance: string;
+    tags: string[];
+    similarity: number;
+}
+/**
+ * Search SpecMem for related memories
+ * NOW PER-PROJECT - only searches memories from current project!
+ */
+export declare function searchRelatedMemories(prompt: string, config?: Partial<ContextHookConfig>): Promise<MemoryResult[]>;
+/**
+ * Format memories for context injection
+ */
+export declare function formatContextInjection(memories: MemoryResult[], config?: Partial<ContextHookConfig>): string;
+/**
+ * Main hook handler - call this from  Code hooks
+ */
+export declare function contextInjectionHook(prompt: string, config?: Partial<ContextHookConfig>): Promise<string>;
+export { DEFAULT_CONFIG };
+//# sourceMappingURL=contextInjectionHook.d.ts.map

package/dist/hooks/contextInjectionHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextInjectionHook.d.ts","sourceRoot":"","sources":["../../src/hooks/contextInjectionHook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAaH,MAAM,WAAW,iBAAiB;IAEhC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IAGnB,eAAe,EAAE,MAAM,CAAC;IAGxB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAiDD,QAAA,MAAM,cAAc,EAAE,iBAKpB,CAAC;AAkHH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACtC,OAAO,CAAC,YAAY,EAAE,CAAC,CAyCzB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACtC,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACtC,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAgCD,OAAO,EAAE,cAAc,EAAE,CAAC"}