cmp-standards 2.8.0 → 2.8.1

package/dist/hooks/index.d.ts

@@ -8,5 +8,6 @@ export { MemoryCheckpointHook, runMemoryCheckpointHook } from './memory-checkpoi
 export { onSessionStart as cloudSessionStart } from './cloud-session-start.js';
 export { onPreToolUse as cloudPreToolUse } from './cloud-pre-tool-use.js';
 export { onPostToolUse as cloudPostToolUse } from './cloud-post-tool-use.js';
+export { onSessionEnd, getSessionSummaries, getSessionStats, SessionEndEvent, SessionSummary, SessionEndResult, } from './session-end.js';
 export { ExpertReviewHook, ExpertReviewConfig, ReviewRequest, ReviewResult, getExpertReviewHook, resetExpertReviewHook, onExpertReview, } from './expert-review.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAGtF,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAG5E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAGtF,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAG5E,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAA"}

package/dist/hooks/index.js

@@ -10,6 +10,8 @@ export { MemoryCheckpointHook, runMemoryCheckpointHook } from './memory-checkpoi
 export { onSessionStart as cloudSessionStart } from './cloud-session-start.js';
 export { onPreToolUse as cloudPreToolUse } from './cloud-pre-tool-use.js';
 export { onPostToolUse as cloudPostToolUse } from './cloud-post-tool-use.js';
+// Session End hook (v2.8 - Analytics)
+export { onSessionEnd, getSessionSummaries, getSessionStats, } from './session-end.js';
 // Expert Review hook (v2.8)
 export { ExpertReviewHook, getExpertReviewHook, resetExpertReviewHook, onExpertReview, } from './expert-review.js';
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAEtF,gCAAgC;AAChC,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE5E,4BAA4B;AAC5B,OAAO,EACL,gBAAgB,EAIhB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAEtF,gCAAgC;AAChC,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE5E,sCAAsC;AACtC,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,eAAe,GAIhB,MAAM,kBAAkB,CAAA;AAEzB,4BAA4B;AAC5B,OAAO,EACL,gBAAgB,EAIhB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAA"}

package/dist/hooks/session-end.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @file Session End Hook
+ * @description Captures session analytics and persists summary for learning
+ *
+ * Features:
+ * - Record session duration and tool usage
+ * - Track files modified during session
+ * - Count patterns detected and memories created
+ * - Enable session-over-session trend analysis
+ *
+ * @version 1.0.0
+ */
+import type { DevSystem } from '../types/index.js';
+export interface SessionEndEvent {
+    cwd: string;
+    sessionId: string;
+    reason?: 'user_exit' | 'timeout' | 'error' | 'unknown';
+}
+export interface SessionSummary {
+    id: string;
+    sessionId: string;
+    system: DevSystem;
+    duration: number;
+    startedAt: string;
+    endedAt: string;
+    reason: string;
+    toolCalls: Record<string, number>;
+    totalToolCalls: number;
+    filesModified: string[];
+    filesRead: string[];
+    tasksStarted: number;
+    tasksCompleted: number;
+    memoriesCreated: number;
+    memoriesAccessed: number;
+    patternsDetected: number;
+    improvementsGenerated: number;
+    cacheHitRate: number;
+    debounceSkipRate: number;
+}
+export interface SessionEndResult {
+    success: boolean;
+    summaryId?: string;
+    duration?: number;
+    error?: string;
+}
+export declare function onSessionEnd(event: SessionEndEvent): Promise<SessionEndResult>;
+/**
+ * Get session summaries for analytics
+ */
+export declare function getSessionSummaries(system: DevSystem, limit?: number): Promise<SessionSummary[]>;
+/**
+ * Get aggregate statistics across sessions
+ */
+export declare function getSessionStats(system: DevSystem, days?: number): Promise<{
+    totalSessions: number;
+    avgDuration: number;
+    totalToolCalls: number;
+    avgTasksCompleted: number;
+    avgCacheHitRate: number;
+    avgDebounceRate: number;
+    topTools: Array<{
+        tool: string;
+        count: number;
+    }>;
+}>;
+export default onSessionEnd;
+//# sourceMappingURL=session-end.d.ts.map

package/dist/hooks/session-end.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-end.d.ts","sourceRoot":"","sources":["../../src/hooks/session-end.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAMlD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;CACvD;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IAGd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,cAAc,EAAE,MAAM,CAAA;IAGtB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,SAAS,EAAE,MAAM,EAAE,CAAA;IAGnB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IAGtB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IAGxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,qBAAqB,EAAE,MAAM,CAAA;IAG7B,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAuBD,wBAAsB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoKpF;AAMD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,KAAK,SAAK,GACT,OAAO,CAAC,cAAc,EAAE,CAAC,CAqB3B;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC;IAC1E,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACjD,CAAC,CAoDD;AA0BD,eAAe,YAAY,CAAA"}

package/dist/hooks/session-end.js

@@ -0,0 +1,268 @@
+/**
+ * @file Session End Hook
+ * @description Captures session analytics and persists summary for learning
+ *
+ * Features:
+ * - Record session duration and tool usage
+ * - Track files modified during session
+ * - Count patterns detected and memories created
+ * - Enable session-over-session trend analysis
+ *
+ * @version 1.0.0
+ */
+import { ulid } from 'ulid';
+import { config } from 'dotenv';
+import { resolve } from 'path';
+import { turso } from '../db/turso-client.js';
+import { upstash } from '../db/upstash-client.js';
+import { getSmartDebouncer } from '../performance/Debouncer.js';
+import { getEmbeddingCache } from '../cache/EmbeddingCache.js';
+import { feedbackCollector } from '../services/FeedbackCollector.js';
+// =============================================================================
+// System Detection (copied from session-start for standalone use)
+// =============================================================================
+function detectSystem(cwd) {
+    if (cwd.includes('swarmscale') || cwd.includes('SwarmScale')) {
+        return 'SWARMSCALE';
+    }
+    if (cwd.includes('easycharter') || cwd.includes('charter')) {
+        return 'PANEL';
+    }
+    if (cwd.includes('carlosmartinpavon')) {
+        return 'ECOSYSTEM';
+    }
+    return 'ECOSYSTEM';
+}
+// =============================================================================
+// Hook Implementation
+// =============================================================================
+export async function onSessionEnd(event) {
+    // Load environment
+    const envPaths = [
+        resolve(event.cwd, '.env'),
+        resolve(event.cwd, '../.env'),
+        resolve(event.cwd, '../../.env')
+    ];
+    for (const envPath of envPaths) {
+        config({ path: envPath });
+    }
+    const system = detectSystem(event.cwd);
+    const endedAt = new Date().toISOString();
+    try {
+        const db = turso.getClient();
+        // 1. Get session info from Redis
+        let sessionInfo = null;
+        try {
+            const cached = await upstash.getCache(`session_metrics:${event.sessionId}`);
+            sessionInfo = cached;
+        }
+        catch {
+            // Redis might not be available
+        }
+        const startedAt = sessionInfo?.startedAt || new Date(Date.now() - 3600000).toISOString();
+        const duration = new Date(endedAt).getTime() - new Date(startedAt).getTime();
+        // 2. Get task counts for this session
+        const taskCounts = await db.execute({
+            sql: `SELECT
+              SUM(CASE WHEN json_extract(content, '$.sessionId') = ? AND status = 'active' THEN 1 ELSE 0 END) as started,
+              SUM(CASE WHEN json_extract(content, '$.sessionId') = ? AND status = 'done' THEN 1 ELSE 0 END) as completed
+            FROM items
+            WHERE system = ? AND type = 'task'`,
+            args: [event.sessionId, event.sessionId, system]
+        });
+        const taskRow = taskCounts.rows[0] || { started: 0, completed: 0 };
+        // 3. Get memory counts for this session
+        const memoryCounts = await db.execute({
+            sql: `SELECT COUNT(*) as created FROM items
+            WHERE system = ? AND type = 'memory'
+            AND json_extract(content, '$.sessionId') = ?`,
+            args: [system, event.sessionId]
+        });
+        const memoryRow = memoryCounts.rows[0] || { created: 0 };
+        // 4. Get pattern counts for this session
+        const patternCounts = await db.execute({
+            sql: `SELECT COUNT(*) as detected FROM items
+            WHERE system = ? AND type = 'pattern'
+            AND date(created_at) = date('now')`,
+            args: [system]
+        });
+        const patternRow = patternCounts.rows[0] || { detected: 0 };
+        // 5. Get improvement counts
+        const improvementCounts = await db.execute({
+            sql: `SELECT COUNT(*) as generated FROM items
+            WHERE system = ? AND type = 'auto_improvement'
+            AND date(created_at) = date('now')`,
+            args: [system]
+        });
+        const improvementRow = improvementCounts.rows[0] || { generated: 0 };
+        // 6. Get performance metrics
+        const embeddingCache = getEmbeddingCache();
+        const cacheStats = embeddingCache.getStats();
+        const smartDebouncer = getSmartDebouncer();
+        const debounceStats = smartDebouncer.getStats();
+        // 7. Get top-scored memories accessed count
+        const topScored = await feedbackCollector.getTopScoredMemories(system, 10);
+        const memoriesAccessed = topScored.reduce((sum, m) => sum + m.accessCount, 0);
+        // 8. Build summary
+        const summary = {
+            id: `ss_${ulid()}`,
+            sessionId: event.sessionId,
+            system,
+            duration,
+            startedAt,
+            endedAt,
+            reason: event.reason || 'unknown',
+            toolCalls: sessionInfo?.toolCalls || {},
+            totalToolCalls: Object.values(sessionInfo?.toolCalls || {}).reduce((a, b) => a + b, 0),
+            filesModified: sessionInfo?.filesModified || [],
+            filesRead: sessionInfo?.filesRead || [],
+            tasksStarted: Number(taskRow.started) || 0,
+            tasksCompleted: Number(taskRow.completed) || 0,
+            memoriesCreated: Number(memoryRow.created) || 0,
+            memoriesAccessed,
+            patternsDetected: Number(patternRow.detected) || 0,
+            improvementsGenerated: Number(improvementRow.generated) || 0,
+            cacheHitRate: cacheStats.hitRate,
+            debounceSkipRate: debounceStats.skipRate
+        };
+        // 9. Persist summary
+        await db.execute({
+            sql: `INSERT INTO items (id, type, system, status, content, created_at, updated_at)
+            VALUES (?, 'session_summary', ?, 'active', ?, ?, ?)`,
+            args: [
+                summary.id,
+                system,
+                JSON.stringify(summary),
+                endedAt,
+                endedAt
+            ]
+        });
+        // 10. Cleanup Redis session data
+        try {
+            await upstash.deleteCache(`session_metrics:${event.sessionId}`);
+            await upstash.deleteCache(`session:${event.sessionId}`);
+        }
+        catch {
+            // Redis cleanup is best-effort
+        }
+        console.log(`[session-end] Session ${event.sessionId} completed:`);
+        console.log(`  Duration: ${Math.round(duration / 1000 / 60)} minutes`);
+        console.log(`  Tool calls: ${summary.totalToolCalls}`);
+        console.log(`  Files modified: ${summary.filesModified.length}`);
+        console.log(`  Tasks completed: ${summary.tasksCompleted}`);
+        console.log(`  Cache hit rate: ${(summary.cacheHitRate * 100).toFixed(1)}%`);
+        return {
+            success: true,
+            summaryId: summary.id,
+            duration
+        };
+    }
+    catch (error) {
+        console.error('[session-end] Error:', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error'
+        };
+    }
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Get session summaries for analytics
+ */
+export async function getSessionSummaries(system, limit = 20) {
+    try {
+        const db = turso.getClient();
+        const result = await db.execute({
+            sql: `SELECT content FROM items
+            WHERE system = ? AND type = 'session_summary' AND status = 'active'
+            ORDER BY created_at DESC
+            LIMIT ?`,
+            args: [system, limit]
+        });
+        return result.rows.map(row => {
+            const content = typeof row.content === 'string'
+                ? JSON.parse(row.content)
+                : row.content;
+            return content;
+        });
+    }
+    catch (error) {
+        console.error('[session-end] Failed to get summaries:', error);
+        return [];
+    }
+}
+/**
+ * Get aggregate statistics across sessions
+ */
+export async function getSessionStats(system, days = 7) {
+    const summaries = await getSessionSummaries(system, 100);
+    if (summaries.length === 0) {
+        return {
+            totalSessions: 0,
+            avgDuration: 0,
+            totalToolCalls: 0,
+            avgTasksCompleted: 0,
+            avgCacheHitRate: 0,
+            avgDebounceRate: 0,
+            topTools: []
+        };
+    }
+    // Filter to last N days
+    const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+    const recent = summaries.filter(s => new Date(s.endedAt).getTime() > cutoff);
+    const toolCounts = new Map();
+    let totalDuration = 0;
+    let totalCalls = 0;
+    let totalTasksCompleted = 0;
+    let totalCacheRate = 0;
+    let totalDebounceRate = 0;
+    for (const s of recent) {
+        totalDuration += s.duration;
+        totalCalls += s.totalToolCalls;
+        totalTasksCompleted += s.tasksCompleted;
+        totalCacheRate += s.cacheHitRate;
+        totalDebounceRate += s.debounceSkipRate;
+        for (const [tool, count] of Object.entries(s.toolCalls)) {
+            toolCounts.set(tool, (toolCounts.get(tool) || 0) + count);
+        }
+    }
+    const topTools = Array.from(toolCounts.entries())
+        .map(([tool, count]) => ({ tool, count }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 10);
+    return {
+        totalSessions: recent.length,
+        avgDuration: recent.length > 0 ? totalDuration / recent.length : 0,
+        totalToolCalls: totalCalls,
+        avgTasksCompleted: recent.length > 0 ? totalTasksCompleted / recent.length : 0,
+        avgCacheHitRate: recent.length > 0 ? totalCacheRate / recent.length : 0,
+        avgDebounceRate: recent.length > 0 ? totalDebounceRate / recent.length : 0,
+        topTools
+    };
+}
+// =============================================================================
+// CLI Entry Point
+// =============================================================================
+if (process.argv[1]?.includes('session-end')) {
+    const cwd = process.cwd();
+    const sessionId = process.argv[2] || `session_${Date.now()}`;
+    const reason = process.argv[3] || 'user_exit';
+    onSessionEnd({ cwd, sessionId, reason })
+        .then(result => {
+        if (result.success) {
+            console.log(`Session ended successfully. Summary: ${result.summaryId}`);
+        }
+        else {
+            console.error(`Session end failed: ${result.error}`);
+            process.exit(1);
+        }
+    })
+        .catch(error => {
+        console.error('Error:', error.message);
+        process.exit(1);
+    });
+}
+export default onSessionEnd;
+//# sourceMappingURL=session-end.js.map

package/dist/hooks/session-end.js.map

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

package/dist/mcp/schemas.d.ts

@@ -139,12 +139,12 @@ export declare const FeedbackSubmitSchema: z.ZodObject<{
     helpful: z.ZodBoolean;
     comment: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    memoryId: string;
     helpful: boolean;
+    memoryId: string;
     comment?: string | undefined;
 }, {
-    memoryId: string;
     helpful: boolean;
+    memoryId: string;
     comment?: string | undefined;
 }>;
 export declare const TaskStartSchema: z.ZodObject<{

package/dist/performance/Debouncer.d.ts

@@ -23,6 +23,19 @@ export interface DebouncerStats {
     skipRate: number;
     activeEntries: number;
 }
+/**
+ * Tool-specific debounce windows
+ * Different tools have different optimal debounce times
+ */
+export declare const TOOL_DEBOUNCE_CONFIG: Record<string, number>;
+/**
+ * Get debounce window for a specific tool
+ */
+export declare function getToolDebounceMs(toolName: string): number;
+/**
+ * Check if a tool should never be debounced (write operations)
+ */
+export declare function isWriteOperation(toolName: string): boolean;
 export declare class Debouncer {
     private config;
     private entries;
@@ -84,8 +97,52 @@ export declare class HookDebouncer extends Debouncer {
     constructor(config?: Partial<DebouncerConfig>);
     shouldSkipHook(hookName: string, context: Record<string, unknown>): boolean;
 }
+/**
+ * Smart Debouncer with tool-specific windows
+ * Uses different debounce times based on tool type
+ */
+export declare class SmartDebouncer {
+    private entries;
+    private maxEntries;
+    private debug;
+    private stats;
+    constructor(options?: {
+        maxEntries?: number;
+        debug?: boolean;
+    });
+    /**
+     * Check if operation should be skipped based on tool-specific window
+     */
+    shouldSkip(toolName: string, params: Record<string, unknown>): boolean;
+    private trackCall;
+    /**
+     * Cleanup old entries (uses longest debounce window)
+     */
+    cleanup(): number;
+    /**
+     * Get statistics including per-tool breakdown
+     */
+    getStats(): {
+        totalCalls: number;
+        skipped: number;
+        skipRate: number;
+        byTool: Record<string, {
+            total: number;
+            skipped: number;
+            skipRate: number;
+        }>;
+    };
+    /**
+     * Reset all state
+     */
+    reset(): void;
+}
 export declare function getDebouncer(config?: Partial<DebouncerConfig>): Debouncer;
 export declare function getEmbeddingDebouncer(config?: Partial<DebouncerConfig>): EmbeddingDebouncer;
 export declare function getHookDebouncer(config?: Partial<DebouncerConfig>): HookDebouncer;
+export declare function getSmartDebouncer(options?: {
+    maxEntries?: number;
+    debug?: boolean;
+}): SmartDebouncer;
 export declare function resetDebouncers(): void;
 //# sourceMappingURL=Debouncer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Debouncer.d.ts","sourceRoot":"","sources":["../../src/performance/Debouncer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;CACtB;AAiBD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,KAAK,CAGZ;gBAEW,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAIjD;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IA4BhC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAMpE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAK/E;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO;IAM1C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,OAAO,IAAI,MAAM;IAkBjB;;OAEG;IACH,QAAQ,IAAI,cAAc;IAY1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,SAAS,IAAI,eAAe;IAI5B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;CAGlD;AAMD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQjD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAIxC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQjD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAI5E;AAUD,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAKzE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,kBAAkB,CAK3F;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,aAAa,CAKjF;AAED,wBAAgB,eAAe,IAAI,IAAI,CAItC"}
+{"version":3,"file":"Debouncer.d.ts","sourceRoot":"","sources":["../../src/performance/Debouncer.ts"],"names":[],"mappings":"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"}

package/dist/performance/Debouncer.js

@@ -15,6 +15,45 @@ const DEFAULT_CONFIG = {
     debug: false,
 };
 // =============================================================================
+// Smart Debouncing by Tool Type
+// =============================================================================
+/**
+ * Tool-specific debounce windows
+ * Different tools have different optimal debounce times
+ */
+export const TOOL_DEBOUNCE_CONFIG = {
+    // Read operations - frequent, short debounce
+    'Read': 1000,
+    'Glob': 2000,
+    'Grep': 2000,
+    'LSP': 1000,
+    // Write operations - no debounce (always execute)
+    'Write': 0,
+    'Edit': 0,
+    'NotebookEdit': 0,
+    // External operations - longer debounce
+    'WebSearch': 5000,
+    'WebFetch': 5000,
+    'Bash': 3000,
+    // Task/Agent operations - medium debounce
+    'Task': 3000,
+    'Skill': 2000,
+    // Default for unknown tools
+    'default': 3000
+};
+/**
+ * Get debounce window for a specific tool
+ */
+export function getToolDebounceMs(toolName) {
+    return TOOL_DEBOUNCE_CONFIG[toolName] ?? TOOL_DEBOUNCE_CONFIG['default'];
+}
+/**
+ * Check if a tool should never be debounced (write operations)
+ */
+export function isWriteOperation(toolName) {
+    return ['Write', 'Edit', 'NotebookEdit'].includes(toolName);
+}
+// =============================================================================
 // Debouncer Implementation
 // =============================================================================
 export class Debouncer {
@@ -166,12 +205,115 @@ export class HookDebouncer extends Debouncer {
         return this.shouldSkip(`hook:${key}`);
     }
 }
+/**
+ * Smart Debouncer with tool-specific windows
+ * Uses different debounce times based on tool type
+ */
+export class SmartDebouncer {
+    entries = new Map();
+    maxEntries;
+    debug;
+    stats = {
+        totalCalls: 0,
+        skipped: 0,
+        byTool: new Map()
+    };
+    constructor(options = {}) {
+        this.maxEntries = options.maxEntries ?? 500;
+        this.debug = options.debug ?? false;
+    }
+    /**
+     * Check if operation should be skipped based on tool-specific window
+     */
+    shouldSkip(toolName, params) {
+        const debounceMs = getToolDebounceMs(toolName);
+        // Write operations are never debounced
+        if (debounceMs === 0) {
+            this.trackCall(toolName, false);
+            return false;
+        }
+        this.stats.totalCalls++;
+        const now = Date.now();
+        const paramsStr = JSON.stringify(params, Object.keys(params).sort());
+        const key = createHash('md5').update(`${toolName}:${paramsStr}`).digest('hex');
+        const entry = this.entries.get(key);
+        if (entry && now - entry.lastCall < debounceMs) {
+            this.stats.skipped++;
+            entry.callCount++;
+            this.trackCall(toolName, true);
+            if (this.debug) {
+                console.log(`[SmartDebouncer] Skipping ${toolName} (window: ${debounceMs}ms, called ${entry.callCount}x)`);
+            }
+            return true;
+        }
+        // Update or create entry
+        this.entries.set(key, { lastCall: now, callCount: 1 });
+        // Cleanup if needed
+        if (this.entries.size > this.maxEntries) {
+            this.cleanup();
+        }
+        this.trackCall(toolName, false);
+        return false;
+    }
+    trackCall(toolName, skipped) {
+        const existing = this.stats.byTool.get(toolName) ?? { total: 0, skipped: 0 };
+        existing.total++;
+        if (skipped)
+            existing.skipped++;
+        this.stats.byTool.set(toolName, existing);
+    }
+    /**
+     * Cleanup old entries (uses longest debounce window)
+     */
+    cleanup() {
+        const now = Date.now();
+        const maxWindow = Math.max(...Object.values(TOOL_DEBOUNCE_CONFIG));
+        let removed = 0;
+        for (const [key, entry] of this.entries) {
+            if (now - entry.lastCall > maxWindow) {
+                this.entries.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Get statistics including per-tool breakdown
+     */
+    getStats() {
+        const byTool = {};
+        for (const [tool, stats] of this.stats.byTool) {
+            byTool[tool] = {
+                ...stats,
+                skipRate: stats.total > 0 ? stats.skipped / stats.total : 0
+            };
+        }
+        return {
+            totalCalls: this.stats.totalCalls,
+            skipped: this.stats.skipped,
+            skipRate: this.stats.totalCalls > 0 ? this.stats.skipped / this.stats.totalCalls : 0,
+            byTool
+        };
+    }
+    /**
+     * Reset all state
+     */
+    reset() {
+        this.entries.clear();
+        this.stats = {
+            totalCalls: 0,
+            skipped: 0,
+            byTool: new Map()
+        };
+    }
+}
 // =============================================================================
 // Singleton Instances
 // =============================================================================
 let globalDebouncer = null;
 let globalEmbeddingDebouncer = null;
 let globalHookDebouncer = null;
+let globalSmartDebouncer = null;
 export function getDebouncer(config) {
     if (!globalDebouncer) {
         globalDebouncer = new Debouncer(config);
@@ -190,9 +332,16 @@ export function getHookDebouncer(config) {
     }
     return globalHookDebouncer;
 }
+export function getSmartDebouncer(options) {
+    if (!globalSmartDebouncer) {
+        globalSmartDebouncer = new SmartDebouncer(options);
+    }
+    return globalSmartDebouncer;
+}
 export function resetDebouncers() {
     globalDebouncer = null;
     globalEmbeddingDebouncer = null;
     globalHookDebouncer = null;
+    globalSmartDebouncer = null;
 }
 //# sourceMappingURL=Debouncer.js.map