@stanco323/oh-my-claude-code 4.10.3

package/dist/hooks/preemptive-compaction/constants.js

@@ -0,0 +1,90 @@
+/**
+ * Preemptive Compaction Constants
+ *
+ * Thresholds and messages for context usage monitoring.
+ *
+ * Adapted from oh-my-opencode's preemptive-compaction hook.
+ */
+/**
+ * Default threshold ratio to trigger warning (85%)
+ */
+export const DEFAULT_THRESHOLD = 0.85;
+/**
+ * Critical threshold ratio (95%)
+ */
+export const CRITICAL_THRESHOLD = 0.95;
+/**
+ * Minimum tokens before considering compaction
+ */
+export const MIN_TOKENS_FOR_COMPACTION = 50_000;
+/**
+ * Cooldown period between compaction warnings (1 minute)
+ */
+export const COMPACTION_COOLDOWN_MS = 60_000;
+/**
+ * Maximum warnings per session before stopping
+ */
+export const MAX_WARNINGS = 3;
+/**
+ * Default context limits for Claude models
+ */
+export const CLAUDE_DEFAULT_CONTEXT_LIMIT = process.env.ANTHROPIC_1M_CONTEXT === 'true' ||
+    process.env.VERTEX_ANTHROPIC_1M_CONTEXT === 'true'
+    ? 1_000_000
+    : 200_000;
+/**
+ * Average characters per token estimate
+ */
+export const CHARS_PER_TOKEN = 4;
+/**
+ * Warning message when context usage is high
+ */
+export const CONTEXT_WARNING_MESSAGE = `CONTEXT WINDOW WARNING - APPROACHING LIMIT
+
+Your context usage is getting high. Consider these actions to prevent hitting the limit:
+
+1. USE COMPACT COMMAND
+   - Run /compact to summarize the conversation
+   - This frees up context space while preserving important information
+
+2. BE MORE CONCISE
+   - Show only relevant code portions
+   - Use file paths instead of full code blocks
+   - Summarize instead of repeating information
+
+3. FOCUS YOUR REQUESTS
+   - Work on one task at a time
+   - Complete current tasks before starting new ones
+   - Avoid unnecessary back-and-forth
+
+Current Status: Context usage is high but recoverable.
+Action recommended: Use /compact when convenient.
+`;
+/**
+ * Critical warning message when context is almost full
+ */
+export const CONTEXT_CRITICAL_MESSAGE = `CRITICAL: CONTEXT WINDOW ALMOST FULL
+
+Your context usage is critically high. Immediate action required:
+
+1. COMPACT NOW
+   - Run /compact immediately to summarize the conversation
+   - Without compaction, the next few messages may fail
+
+2. AVOID LARGE OUTPUTS
+   - Do not show full files
+   - Use summaries instead of detailed outputs
+   - Be as concise as possible
+
+3. PREPARE FOR SESSION HANDOFF
+   - If compaction doesn't help enough, prepare to continue in a new session
+   - Note your current progress and next steps
+
+WARNING: Further messages may fail if context is not reduced.
+Action required: Run /compact now.
+`;
+/**
+ * Message when compaction was successful
+ */
+export const COMPACTION_SUCCESS_MESSAGE = `Context compacted successfully. Session can continue normally.`;
+//# sourceMappingURL=constants.js.map

package/dist/hooks/preemptive-compaction/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/preemptive-compaction/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GACvC,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,MAAM;IAC3C,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,MAAM;IAChD,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,OAAO,CAAC;AAEd;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBtC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;CAmBvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,gEAAgE,CAAC"}

package/dist/hooks/preemptive-compaction/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Preemptive Compaction Hook
+ *
+ * Monitors context usage and warns before hitting the context limit.
+ * Encourages proactive compaction to prevent context overflow.
+ *
+ * Adapted from oh-my-opencode's preemptive-compaction hook.
+ *
+ * Note: This is a simplified version for Claude Code's shell hook system.
+ * The original uses OpenCode's plugin event system for automatic summarization.
+ * This version injects warning messages to prompt manual compaction.
+ */
+import type { ContextUsageResult, PreemptiveCompactionConfig } from './types.js';
+/**
+ * Rapid-fire debounce window (ms).
+ * When multiple tool outputs arrive within this window (e.g. simultaneous
+ * subagent completions in swarm/ultrawork), only the first triggers
+ * context analysis. Subsequent calls within the window are skipped.
+ * This is much shorter than COMPACTION_COOLDOWN_MS (which debounces warnings)
+ * and specifically targets the concurrent flood scenario (issue #453).
+ */
+declare const RAPID_FIRE_DEBOUNCE_MS = 500;
+/**
+ * Estimate tokens from text content
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Analyze context usage based on conversation content
+ */
+export declare function analyzeContextUsage(content: string, config?: PreemptiveCompactionConfig): ContextUsageResult;
+/**
+ * Create preemptive compaction hook
+ *
+ * This hook monitors context usage and injects warning messages
+ * when approaching the context limit.
+ */
+export declare function createPreemptiveCompactionHook(config?: PreemptiveCompactionConfig): {
+    /**
+     * PostToolUse - Check context usage after large tool outputs
+     */
+    postToolUse: (input: {
+        tool_name: string;
+        session_id: string;
+        tool_input: Record<string, unknown>;
+        tool_response?: string;
+    }) => string | null;
+    /**
+     * Stop event - Check context before stopping
+     */
+    stop: (input: {
+        session_id: string;
+    }) => string | null;
+};
+/**
+ * Get estimated token usage for a session
+ */
+export declare function getSessionTokenEstimate(sessionId: string): number;
+/**
+ * Reset token estimate for a session (e.g., after compaction)
+ */
+export declare function resetSessionTokenEstimate(sessionId: string): void;
+/**
+ * Clear the rapid-fire debounce state for a session (for testing).
+ */
+export declare function clearRapidFireDebounce(sessionId: string): void;
+export type { ContextUsageResult, PreemptiveCompactionConfig, } from './types.js';
+export { RAPID_FIRE_DEBOUNCE_MS };
+export { DEFAULT_THRESHOLD, CRITICAL_THRESHOLD, COMPACTION_COOLDOWN_MS, MAX_WARNINGS, CLAUDE_DEFAULT_CONTEXT_LIMIT, CHARS_PER_TOKEN, CONTEXT_WARNING_MESSAGE, CONTEXT_CRITICAL_MESSAGE, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/preemptive-compaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/preemptive-compaction/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAKpB;;;;;;;GAOG;AACH,QAAA,MAAM,sBAAsB,MAAM,CAAC;AAwDnC;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,0BAA0B,GAClC,kBAAkB,CAyBpB;AA+DD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,CAAC,EAAE,0BAA0B;IAmBjC;;OAEG;yBACkB;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,KAAG,MAAM,GAAG,IAAI;IA2EjB;;OAEG;kBACW;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,KAAG,MAAM,GAAG,IAAI;EAkBvD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9D;AAGD,YAAY,EACV,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,4BAA4B,EAC5B,eAAe,EACf,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC"}

package/dist/hooks/preemptive-compaction/index.js

@@ -0,0 +1,278 @@
+/**
+ * Preemptive Compaction Hook
+ *
+ * Monitors context usage and warns before hitting the context limit.
+ * Encourages proactive compaction to prevent context overflow.
+ *
+ * Adapted from oh-my-opencode's preemptive-compaction hook.
+ *
+ * Note: This is a simplified version for Claude Code's shell hook system.
+ * The original uses OpenCode's plugin event system for automatic summarization.
+ * This version injects warning messages to prompt manual compaction.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { tmpdir } from 'os';
+import { DEFAULT_THRESHOLD, CRITICAL_THRESHOLD, COMPACTION_COOLDOWN_MS, MAX_WARNINGS, CLAUDE_DEFAULT_CONTEXT_LIMIT, CHARS_PER_TOKEN, CONTEXT_WARNING_MESSAGE, CONTEXT_CRITICAL_MESSAGE, } from './constants.js';
+const DEBUG = process.env.PREEMPTIVE_COMPACTION_DEBUG === '1';
+const DEBUG_FILE = path.join(tmpdir(), 'preemptive-compaction-debug.log');
+/**
+ * Rapid-fire debounce window (ms).
+ * When multiple tool outputs arrive within this window (e.g. simultaneous
+ * subagent completions in swarm/ultrawork), only the first triggers
+ * context analysis. Subsequent calls within the window are skipped.
+ * This is much shorter than COMPACTION_COOLDOWN_MS (which debounces warnings)
+ * and specifically targets the concurrent flood scenario (issue #453).
+ */
+const RAPID_FIRE_DEBOUNCE_MS = 500;
+/**
+ * Per-session timestamp of last postToolUse analysis.
+ * Used to debounce rapid-fire tool completions.
+ */
+const lastAnalysisTime = new Map();
+function debugLog(...args) {
+    if (DEBUG) {
+        const msg = `[${new Date().toISOString()}] [preemptive-compaction] ${args
+            .map((a) => typeof a === 'object' ? JSON.stringify(a, null, 2) : String(a))
+            .join(' ')}\n`;
+        fs.appendFileSync(DEBUG_FILE, msg);
+    }
+}
+/**
+ * State tracking for all sessions
+ */
+const sessionStates = new Map();
+/**
+ * Clean up stale session states
+ */
+function _cleanupSessionStates() {
+    const now = Date.now();
+    const MAX_AGE = 30 * 60 * 1000; // 30 minutes
+    for (const [sessionId, state] of sessionStates) {
+        if (now - state.lastWarningTime > MAX_AGE) {
+            sessionStates.delete(sessionId);
+            lastAnalysisTime.delete(sessionId);
+        }
+    }
+    // Clean orphaned debounce entries
+    for (const sessionId of lastAnalysisTime.keys()) {
+        if (!sessionStates.has(sessionId)) {
+            lastAnalysisTime.delete(sessionId);
+        }
+    }
+}
+// Run cleanup periodically
+let cleanupIntervalStarted = false;
+/**
+ * Estimate tokens from text content
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+/**
+ * Analyze context usage based on conversation content
+ */
+export function analyzeContextUsage(content, config) {
+    const warningThreshold = config?.warningThreshold ?? DEFAULT_THRESHOLD;
+    const criticalThreshold = config?.criticalThreshold ?? CRITICAL_THRESHOLD;
+    const contextLimit = CLAUDE_DEFAULT_CONTEXT_LIMIT;
+    const totalTokens = estimateTokens(content);
+    const usageRatio = totalTokens / contextLimit;
+    const isWarning = usageRatio >= warningThreshold;
+    const isCritical = usageRatio >= criticalThreshold;
+    let action = 'none';
+    if (isCritical) {
+        action = 'compact';
+    }
+    else if (isWarning) {
+        action = 'warn';
+    }
+    return {
+        totalTokens,
+        usageRatio,
+        isWarning,
+        isCritical,
+        action,
+    };
+}
+/**
+ * Get or create session state
+ */
+function getSessionState(sessionId) {
+    let state = sessionStates.get(sessionId);
+    if (!state) {
+        state = {
+            lastWarningTime: 0,
+            warningCount: 0,
+            estimatedTokens: 0,
+        };
+        sessionStates.set(sessionId, state);
+    }
+    return state;
+}
+/**
+ * Check if we should show a warning
+ */
+function shouldShowWarning(sessionId, config) {
+    const state = getSessionState(sessionId);
+    const cooldownMs = config?.cooldownMs ?? COMPACTION_COOLDOWN_MS;
+    const maxWarnings = config?.maxWarnings ?? MAX_WARNINGS;
+    const now = Date.now();
+    // Check cooldown
+    if (now - state.lastWarningTime < cooldownMs) {
+        debugLog('skipping warning - cooldown active', {
+            sessionId,
+            elapsed: now - state.lastWarningTime,
+            cooldown: cooldownMs,
+        });
+        return false;
+    }
+    // Check max warnings
+    if (state.warningCount >= maxWarnings) {
+        debugLog('skipping warning - max reached', {
+            sessionId,
+            warningCount: state.warningCount,
+            maxWarnings,
+        });
+        return false;
+    }
+    return true;
+}
+/**
+ * Record that a warning was shown
+ */
+function recordWarning(sessionId) {
+    const state = getSessionState(sessionId);
+    state.lastWarningTime = Date.now();
+    state.warningCount++;
+}
+/**
+ * Create preemptive compaction hook
+ *
+ * This hook monitors context usage and injects warning messages
+ * when approaching the context limit.
+ */
+export function createPreemptiveCompactionHook(config) {
+    debugLog('createPreemptiveCompactionHook called', { config });
+    if (config?.enabled === false) {
+        return {
+            postToolUse: () => null,
+            stop: () => null,
+        };
+    }
+    if (!cleanupIntervalStarted) {
+        cleanupIntervalStarted = true;
+        // Note: setInterval is intentionally NOT used here — this module runs in
+        // short-lived hook processes that exit before any timer fires. Cleanup is
+        // done lazily on each invocation via the rapid-fire debounce path instead.
+    }
+    return {
+        /**
+         * PostToolUse - Check context usage after large tool outputs
+         */
+        postToolUse: (input) => {
+            if (!input.tool_response) {
+                return null;
+            }
+            // Only check after tools that produce large outputs
+            const toolLower = input.tool_name.toLowerCase();
+            const largeOutputTools = ['read', 'grep', 'glob', 'bash', 'webfetch', 'task'];
+            if (!largeOutputTools.includes(toolLower)) {
+                return null;
+            }
+            // Rapid-fire debounce: skip analysis if another was done very recently
+            // for this session. Prevents concurrent flood when multiple subagents
+            // complete simultaneously (issue #453).
+            const now = Date.now();
+            const lastAnalysis = lastAnalysisTime.get(input.session_id) ?? 0;
+            if (now - lastAnalysis < RAPID_FIRE_DEBOUNCE_MS) {
+                debugLog('skipping analysis - rapid-fire debounce active', {
+                    sessionId: input.session_id,
+                    elapsed: now - lastAnalysis,
+                    debounceMs: RAPID_FIRE_DEBOUNCE_MS,
+                });
+                // Still track tokens even when debounced
+                const responseTokens = estimateTokens(input.tool_response);
+                const state = getSessionState(input.session_id);
+                state.estimatedTokens += responseTokens;
+                return null;
+            }
+            lastAnalysisTime.set(input.session_id, now);
+            // Estimate response size
+            const responseTokens = estimateTokens(input.tool_response);
+            // Track cumulative tokens for this session
+            const state = getSessionState(input.session_id);
+            state.estimatedTokens += responseTokens;
+            debugLog('tracking tool output', {
+                tool: toolLower,
+                responseTokens,
+                cumulativeTokens: state.estimatedTokens,
+            });
+            // Check if approaching limit
+            const usage = analyzeContextUsage('x'.repeat(state.estimatedTokens * CHARS_PER_TOKEN), config);
+            if (!usage.isWarning) {
+                return null;
+            }
+            if (!shouldShowWarning(input.session_id, config)) {
+                return null;
+            }
+            recordWarning(input.session_id);
+            debugLog('injecting context warning', {
+                sessionId: input.session_id,
+                usageRatio: usage.usageRatio,
+                isCritical: usage.isCritical,
+            });
+            if (config?.customMessage) {
+                return config.customMessage;
+            }
+            return usage.isCritical
+                ? CONTEXT_CRITICAL_MESSAGE
+                : CONTEXT_WARNING_MESSAGE;
+        },
+        /**
+         * Stop event - Check context before stopping
+         */
+        stop: (input) => {
+            const state = getSessionState(input.session_id);
+            // Reset warning count on stop (conversation might continue later)
+            if (state.warningCount > 0) {
+                debugLog('resetting warning count on stop', {
+                    sessionId: input.session_id,
+                    previousCount: state.warningCount,
+                });
+                state.warningCount = 0;
+            }
+            // Clear rapid-fire debounce state
+            lastAnalysisTime.delete(input.session_id);
+            return null;
+        },
+    };
+}
+/**
+ * Get estimated token usage for a session
+ */
+export function getSessionTokenEstimate(sessionId) {
+    const state = sessionStates.get(sessionId);
+    return state?.estimatedTokens ?? 0;
+}
+/**
+ * Reset token estimate for a session (e.g., after compaction)
+ */
+export function resetSessionTokenEstimate(sessionId) {
+    const state = sessionStates.get(sessionId);
+    if (state) {
+        state.estimatedTokens = 0;
+        state.warningCount = 0;
+        state.lastWarningTime = 0;
+    }
+    lastAnalysisTime.delete(sessionId);
+}
+/**
+ * Clear the rapid-fire debounce state for a session (for testing).
+ */
+export function clearRapidFireDebounce(sessionId) {
+    lastAnalysisTime.delete(sessionId);
+}
+export { RAPID_FIRE_DEBOUNCE_MS };
+export { DEFAULT_THRESHOLD, CRITICAL_THRESHOLD, COMPACTION_COOLDOWN_MS, MAX_WARNINGS, CLAUDE_DEFAULT_CONTEXT_LIMIT, CHARS_PER_TOKEN, CONTEXT_WARNING_MESSAGE, CONTEXT_CRITICAL_MESSAGE, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/preemptive-compaction/index.js.map

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

package/dist/hooks/preemptive-compaction/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Preemptive Compaction Types
+ *
+ * Type definitions for monitoring context usage and triggering compaction.
+ *
+ * Adapted from oh-my-opencode's preemptive-compaction hook.
+ */
+/**
+ * State for preemptive compaction tracking
+ */
+export interface PreemptiveCompactionState {
+    /** Map of session ID to last compaction timestamp */
+    lastCompactionTime: Map<string, number>;
+    /** Set of sessions currently undergoing compaction */
+    compactionInProgress: Set<string>;
+    /** Map of session ID to warning count */
+    warningCount: Map<string, number>;
+}
+/**
+ * Token usage information
+ */
+export interface TokenInfo {
+    /** Input tokens used */
+    input: number;
+    /** Output tokens generated */
+    output: number;
+    /** Reasoning tokens (for thinking models) */
+    reasoning: number;
+    /** Cache statistics */
+    cache: {
+        read: number;
+        write: number;
+    };
+}
+/**
+ * Model context limits
+ */
+export interface ModelLimits {
+    /** Maximum context tokens */
+    context: number;
+    /** Maximum output tokens */
+    output: number;
+}
+/**
+ * Context usage analysis result
+ */
+export interface ContextUsageResult {
+    /** Estimated total tokens used */
+    totalTokens: number;
+    /** Estimated usage ratio (0-1) */
+    usageRatio: number;
+    /** Whether usage is above warning threshold */
+    isWarning: boolean;
+    /** Whether usage is above critical threshold */
+    isCritical: boolean;
+    /** Suggested action */
+    action: 'none' | 'warn' | 'compact';
+}
+/**
+ * Configuration for preemptive compaction
+ */
+export interface PreemptiveCompactionConfig {
+    /** Enable preemptive compaction warnings */
+    enabled?: boolean;
+    /** Threshold ratio (0-1) to trigger warning (default: 0.85) */
+    warningThreshold?: number;
+    /** Threshold ratio (0-1) to trigger critical warning (default: 0.95) */
+    criticalThreshold?: number;
+    /** Cooldown period in ms between warnings (default: 60000) */
+    cooldownMs?: number;
+    /** Maximum warnings before stopping (default: 3) */
+    maxWarnings?: number;
+    /** Custom warning message */
+    customMessage?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/preemptive-compaction/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/preemptive-compaction/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,qDAAqD;IACrD,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,sDAAsD;IACtD,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,yCAAyC;IACzC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC;IACpB,uBAAuB;IACvB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/hooks/preemptive-compaction/types.js

@@ -0,0 +1,9 @@
+/**
+ * Preemptive Compaction Types
+ *
+ * Type definitions for monitoring context usage and triggering compaction.
+ *
+ * Adapted from oh-my-opencode's preemptive-compaction hook.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/preemptive-compaction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/preemptive-compaction/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/hooks/project-memory/__tests__/detector.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for Project Environment Detector
+ */
+export {};
+//# sourceMappingURL=detector.test.d.ts.map

package/dist/hooks/project-memory/__tests__/detector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.test.d.ts","sourceRoot":"","sources":["../../../../src/hooks/project-memory/__tests__/detector.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}