cmp-standards 2.7.0 → 2.8.0

package/dist/performance/Debouncer.js

@@ -0,0 +1,198 @@
+/**
+ * @file Debouncer - Hook debouncing for performance optimization
+ * @description Prevents redundant operations by tracking recent calls
+ *
+ * Features:
+ * - Time-based debouncing (skip if same operation within window)
+ * - Hash-based key generation
+ * - Auto-cleanup of expired entries
+ * - Statistics tracking
+ */
+import { createHash } from 'crypto';
+const DEFAULT_CONFIG = {
+    windowMs: 5000, // 5 seconds
+    maxEntries: 500,
+    debug: false,
+};
+// =============================================================================
+// Debouncer Implementation
+// =============================================================================
+export class Debouncer {
+    config;
+    entries = new Map();
+    stats = {
+        totalCalls: 0,
+        skipped: 0,
+    };
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Check if operation should be skipped
+     * Returns true if same operation was called within debounce window
+     */
+    shouldSkip(key) {
+        this.stats.totalCalls++;
+        const now = Date.now();
+        const entry = this.entries.get(key);
+        if (entry && now - entry.lastCall < this.config.windowMs) {
+            this.stats.skipped++;
+            entry.callCount++;
+            if (this.config.debug) {
+                console.log(`[Debouncer] Skipping (called ${entry.callCount}x in window)`);
+            }
+            return true;
+        }
+        // Update or create entry
+        this.entries.set(key, { lastCall: now, callCount: 1 });
+        // Cleanup if needed
+        if (this.entries.size > this.config.maxEntries) {
+            this.cleanup();
+        }
+        return false;
+    }
+    /**
+     * Generate hash key from tool name and params
+     */
+    createKey(toolName, params) {
+        const paramsStr = JSON.stringify(params, Object.keys(params).sort());
+        const content = `${toolName}:${paramsStr}`;
+        return createHash('md5').update(content).digest('hex');
+    }
+    /**
+     * Check if tool call should skip embedding lookup
+     */
+    shouldSkipEmbedding(toolName, params) {
+        const key = this.createKey(toolName, params);
+        return this.shouldSkip(`embed:${key}`);
+    }
+    /**
+     * Check if expert review should be skipped
+     */
+    shouldSkipReview(files) {
+        const filesKey = files.sort().join('|');
+        const key = createHash('md5').update(filesKey).digest('hex');
+        return this.shouldSkip(`review:${key}`);
+    }
+    /**
+     * Mark operation as complete (update timestamp)
+     */
+    markComplete(key) {
+        this.entries.set(key, { lastCall: Date.now(), callCount: 1 });
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.entries) {
+            if (now - entry.lastCall > this.config.windowMs) {
+                this.entries.delete(key);
+                removed++;
+            }
+        }
+        if (this.config.debug && removed > 0) {
+            console.log(`[Debouncer] Cleaned up ${removed} expired entries`);
+        }
+        return removed;
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return {
+            totalCalls: this.stats.totalCalls,
+            skipped: this.stats.skipped,
+            executed: this.stats.totalCalls - this.stats.skipped,
+            skipRate: this.stats.totalCalls > 0
+                ? this.stats.skipped / this.stats.totalCalls
+                : 0,
+            activeEntries: this.entries.size,
+        };
+    }
+    /**
+     * Reset all state
+     */
+    reset() {
+        this.entries.clear();
+        this.stats = { totalCalls: 0, skipped: 0 };
+    }
+    /**
+     * Get config
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update config
+     */
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+// =============================================================================
+// Specialized Debouncers
+// =============================================================================
+/**
+ * Debouncer for embedding lookups
+ */
+export class EmbeddingDebouncer extends Debouncer {
+    constructor(config = {}) {
+        super({
+            windowMs: 5000,
+            maxEntries: 200,
+            ...config,
+        });
+    }
+    shouldSkipLookup(text) {
+        const key = createHash('md5').update(text.toLowerCase().trim()).digest('hex');
+        return this.shouldSkip(`embed:${key}`);
+    }
+}
+/**
+ * Debouncer for hook operations
+ */
+export class HookDebouncer extends Debouncer {
+    constructor(config = {}) {
+        super({
+            windowMs: 2000,
+            maxEntries: 100,
+            ...config,
+        });
+    }
+    shouldSkipHook(hookName, context) {
+        const key = this.createKey(hookName, context);
+        return this.shouldSkip(`hook:${key}`);
+    }
+}
+// =============================================================================
+// Singleton Instances
+// =============================================================================
+let globalDebouncer = null;
+let globalEmbeddingDebouncer = null;
+let globalHookDebouncer = null;
+export function getDebouncer(config) {
+    if (!globalDebouncer) {
+        globalDebouncer = new Debouncer(config);
+    }
+    return globalDebouncer;
+}
+export function getEmbeddingDebouncer(config) {
+    if (!globalEmbeddingDebouncer) {
+        globalEmbeddingDebouncer = new EmbeddingDebouncer(config);
+    }
+    return globalEmbeddingDebouncer;
+}
+export function getHookDebouncer(config) {
+    if (!globalHookDebouncer) {
+        globalHookDebouncer = new HookDebouncer(config);
+    }
+    return globalHookDebouncer;
+}
+export function resetDebouncers() {
+    globalDebouncer = null;
+    globalEmbeddingDebouncer = null;
+    globalHookDebouncer = null;
+}
+//# sourceMappingURL=Debouncer.js.map

package/dist/performance/Debouncer.js.map

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

package/dist/performance/MemoryDecay.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @file MemoryDecay - Memory scoring with exponential decay
+ * @description Calculates relevance scores for memories based on age, usage, and feedback
+ *
+ * Formula:
+ * score = (feedbackScore * decayFactor) + usageBoost + pinBonus
+ *
+ * Where:
+ * - decayFactor = exp(-age / halfLife)
+ * - usageBoost = min(accessCount * 0.05, 0.3)
+ * - pinBonus = 0.5 if pinned
+ */
+export interface MemoryForScoring {
+    id: string;
+    createdAt: string | Date;
+    /** Base relevance score (0-1) */
+    feedbackScore?: number;
+    /** Number of times accessed */
+    accessCount?: number;
+    /** Is memory pinned (never decays) */
+    pinned?: boolean;
+    /** Last accessed timestamp */
+    lastAccessedAt?: string | Date;
+}
+export interface ScoredMemory extends MemoryForScoring {
+    calculatedScore: number;
+    ageInDays: number;
+    decayFactor: number;
+}
+export interface DecayConfig {
+    /** Half-life in days (default 90) */
+    halfLifeDays: number;
+    /** Maximum usage boost (default 0.3) */
+    maxUsageBoost: number;
+    /** Boost per access (default 0.05) */
+    perAccessBoost: number;
+    /** Bonus for pinned memories (default 0.5) */
+    pinBonus: number;
+    /** Recent access bonus (accessed in last 7 days) */
+    recentAccessBonus: number;
+    /** Days considered "recent" */
+    recentDays: number;
+}
+export declare class MemoryDecay {
+    private config;
+    constructor(config?: Partial<DecayConfig>);
+    /**
+     * Calculate score for a single memory
+     */
+    calculateScore(memory: MemoryForScoring): ScoredMemory;
+    /**
+     * Score and sort memories by relevance
+     */
+    rankMemories(memories: MemoryForScoring[]): ScoredMemory[];
+    /**
+     * Filter memories by minimum score
+     */
+    filterByScore(memories: MemoryForScoring[], minScore?: number): ScoredMemory[];
+    /**
+     * Get stale memories (low scores)
+     */
+    getStaleMemories(memories: MemoryForScoring[], threshold?: number): ScoredMemory[];
+    /**
+     * Calculate what score a memory will have at a future date
+     */
+    projectScore(memory: MemoryForScoring, daysInFuture: number): number;
+    /**
+     * Estimate days until memory falls below threshold
+     */
+    estimateDaysUntilStale(memory: MemoryForScoring, threshold?: number): number | null;
+    /**
+     * Get config
+     */
+    getConfig(): DecayConfig;
+    /**
+     * Update config
+     */
+    setConfig(config: Partial<DecayConfig>): void;
+}
+export declare function getMemoryDecay(config?: Partial<DecayConfig>): MemoryDecay;
+export declare function resetMemoryDecay(): void;
+//# sourceMappingURL=MemoryDecay.d.ts.map

package/dist/performance/MemoryDecay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryDecay.d.ts","sourceRoot":"","sources":["../../src/performance/MemoryDecay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAA;IACrB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAA;IACtB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAA;IACzB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAeD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAI7C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY;IA6CtD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,YAAY,EAAE;IAM1D;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,QAAQ,GAAE,MAAY,GACrB,YAAY,EAAE;IAIjB;;OAEG;IACH,gBAAgB,CACd,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,SAAS,GAAE,MAAY,GACtB,YAAY,EAAE;IAMjB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAmBpE;;OAEG;IACH,sBAAsB,CACpB,MAAM,EAAE,gBAAgB,EACxB,SAAS,GAAE,MAAY,GACtB,MAAM,GAAG,IAAI;IAwBhB;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;CAG9C;AAQD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAKzE;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/performance/MemoryDecay.js

@@ -0,0 +1,153 @@
+/**
+ * @file MemoryDecay - Memory scoring with exponential decay
+ * @description Calculates relevance scores for memories based on age, usage, and feedback
+ *
+ * Formula:
+ * score = (feedbackScore * decayFactor) + usageBoost + pinBonus
+ *
+ * Where:
+ * - decayFactor = exp(-age / halfLife)
+ * - usageBoost = min(accessCount * 0.05, 0.3)
+ * - pinBonus = 0.5 if pinned
+ */
+const DEFAULT_CONFIG = {
+    halfLifeDays: 90,
+    maxUsageBoost: 0.3,
+    perAccessBoost: 0.05,
+    pinBonus: 0.5,
+    recentAccessBonus: 0.1,
+    recentDays: 7,
+};
+// =============================================================================
+// MemoryDecay Implementation
+// =============================================================================
+export class MemoryDecay {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Calculate score for a single memory
+     */
+    calculateScore(memory) {
+        const now = Date.now();
+        const createdAt = new Date(memory.createdAt).getTime();
+        const ageInDays = (now - createdAt) / (1000 * 60 * 60 * 24);
+        // Base score from feedback (default 0.5)
+        const feedbackScore = memory.feedbackScore ?? 0.5;
+        // Decay factor (pinned = no decay)
+        const decayFactor = memory.pinned
+            ? 1.0
+            : Math.exp(-ageInDays / this.config.halfLifeDays);
+        // Usage boost
+        const usageBoost = memory.accessCount
+            ? Math.min(memory.accessCount * this.config.perAccessBoost, this.config.maxUsageBoost)
+            : 0;
+        // Recent access bonus
+        let recentBonus = 0;
+        if (memory.lastAccessedAt) {
+            const lastAccess = new Date(memory.lastAccessedAt).getTime();
+            const daysSinceAccess = (now - lastAccess) / (1000 * 60 * 60 * 24);
+            if (daysSinceAccess < this.config.recentDays) {
+                recentBonus = this.config.recentAccessBonus;
+            }
+        }
+        // Pin bonus
+        const pinBonus = memory.pinned ? this.config.pinBonus : 0;
+        // Final score
+        const calculatedScore = Math.min((feedbackScore * decayFactor) + usageBoost + recentBonus + pinBonus, 1.0);
+        return {
+            ...memory,
+            calculatedScore,
+            ageInDays,
+            decayFactor,
+        };
+    }
+    /**
+     * Score and sort memories by relevance
+     */
+    rankMemories(memories) {
+        return memories
+            .map(m => this.calculateScore(m))
+            .sort((a, b) => b.calculatedScore - a.calculatedScore);
+    }
+    /**
+     * Filter memories by minimum score
+     */
+    filterByScore(memories, minScore = 0.1) {
+        return this.rankMemories(memories).filter(m => m.calculatedScore >= minScore);
+    }
+    /**
+     * Get stale memories (low scores)
+     */
+    getStaleMemories(memories, threshold = 0.2) {
+        return this.rankMemories(memories).filter(m => m.calculatedScore < threshold && !m.pinned);
+    }
+    /**
+     * Calculate what score a memory will have at a future date
+     */
+    projectScore(memory, daysInFuture) {
+        const scored = this.calculateScore(memory);
+        if (memory.pinned) {
+            return scored.calculatedScore;
+        }
+        // Project decay
+        const futureAge = scored.ageInDays + daysInFuture;
+        const futureDecay = Math.exp(-futureAge / this.config.halfLifeDays);
+        const feedbackScore = memory.feedbackScore ?? 0.5;
+        const usageBoost = memory.accessCount
+            ? Math.min(memory.accessCount * this.config.perAccessBoost, this.config.maxUsageBoost)
+            : 0;
+        return Math.min((feedbackScore * futureDecay) + usageBoost, 1.0);
+    }
+    /**
+     * Estimate days until memory falls below threshold
+     */
+    estimateDaysUntilStale(memory, threshold = 0.2) {
+        if (memory.pinned)
+            return null;
+        const currentScore = this.calculateScore(memory).calculatedScore;
+        if (currentScore < threshold)
+            return 0;
+        // Binary search for the day when score drops below threshold
+        let low = 0;
+        let high = 365 * 5; // 5 years max
+        while (high - low > 1) {
+            const mid = Math.floor((low + high) / 2);
+            const projectedScore = this.projectScore(memory, mid);
+            if (projectedScore >= threshold) {
+                low = mid;
+            }
+            else {
+                high = mid;
+            }
+        }
+        return high;
+    }
+    /**
+     * Get config
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update config
+     */
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+// =============================================================================
+// Singleton
+// =============================================================================
+let globalDecay = null;
+export function getMemoryDecay(config) {
+    if (!globalDecay) {
+        globalDecay = new MemoryDecay(config);
+    }
+    return globalDecay;
+}
+export function resetMemoryDecay() {
+    globalDecay = null;
+}
+//# sourceMappingURL=MemoryDecay.js.map

package/dist/performance/MemoryDecay.js.map

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

package/dist/performance/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file Performance Module - cmp-standards v2.8
+ * @description Performance optimization utilities
+ */
+export { Debouncer, DebouncerConfig, DebouncerStats, EmbeddingDebouncer, HookDebouncer, getDebouncer, getEmbeddingDebouncer, getHookDebouncer, resetDebouncers, } from './Debouncer.js';
+export { MemoryDecay, MemoryForScoring, ScoredMemory, DecayConfig, getMemoryDecay, resetMemoryDecay, } from './MemoryDecay.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/performance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/performance/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAA"}

package/dist/performance/index.js

@@ -0,0 +1,9 @@
+/**
+ * @file Performance Module - cmp-standards v2.8
+ * @description Performance optimization utilities
+ */
+// Debouncing
+export { Debouncer, EmbeddingDebouncer, HookDebouncer, getDebouncer, getEmbeddingDebouncer, getHookDebouncer, resetDebouncers, } from './Debouncer.js';
+// Memory Decay
+export { MemoryDecay, getMemoryDecay, resetMemoryDecay, } from './MemoryDecay.js';
+//# sourceMappingURL=index.js.map

package/dist/performance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/performance/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,aAAa;AACb,OAAO,EACL,SAAS,EAGT,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAEvB,eAAe;AACf,OAAO,EACL,WAAW,EAIX,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAA"}