squish-memory 0.7.0

package/dist/adapters/claude-code/plugin-wrapper.js

@@ -0,0 +1,239 @@
+/**
+ * Squish Plugin Wrapper - Hook handlers for Claude Code integration
+ */
+import 'dotenv/config';
+import { captureUserPrompt, captureToolUse, queueForSummarization } from './capture.js';
+import { injectContextIntoSession } from './injection.js';
+import { generateAndInjectFolderContext } from '../../core/search/folder-context.js';
+import { getDb } from '../../db/index.js';
+import { startWorker, forceLifecycleMaintenance } from '../../core/worker.js';
+import { getPinnedMemories } from '../../core/governance.js';
+import { summarizeSession } from '../../core/summarization.js';
+import { config } from '../../config.js';
+import { logger } from '../../core/logger.js';
+import { initializeCoreMemory, formatCoreMemoryForInjection } from '../../core/core-memory.js';
+import { initializeContextSession } from '../../core/context-paging.js';
+import { ensureProject } from '../../core/projects.js';
+import { hybridSearch } from '../../core/memory/hybrid-retrieval.js';
+function getProjectPath(context) {
+    return context.workingDirectory || process.cwd();
+}
+/**
+ * Helper to log errors without breaking execution
+ */
+function logError(message, error) {
+    logger.error(message, error);
+}
+/**
+ * Hybrid search configuration for smart context retrieval
+ */
+const SMART_SEARCH_CONFIG = {
+    candidateLimit: 50,
+    resultLimit: 3,
+    hybridOptions: {
+        weights: {
+            semantic: 0.35,
+            recency: 0.25,
+            coactivation: 0.20,
+            importance: 0.20,
+        },
+        decayDays: 7,
+    },
+};
+function isAutoCapture(context) {
+    return context.config?.autoCapture !== false;
+}
+/**
+ * Detect if user message looks like it's asking a question or seeking information
+ */
+function shouldSmartSearch(userMessage) {
+    if (!userMessage || userMessage.length < 3)
+        return false;
+    // Question detection: explicit question mark or question keywords
+    const isExplicitQuestion = userMessage.includes('?');
+    const questionKeywords = [
+        'what ', 'where ', 'when ', 'how ', 'why ',
+        'remember', 'recall', 'tell me', 'explain', 'show me',
+        'find ', 'search ', 'look for', 'do you know'
+    ];
+    const isQuestionLike = questionKeywords.some(kw => userMessage.toLowerCase().includes(kw));
+    // Context clue detection: user is trying to solve a problem or understand code
+    const contextKeywords = [
+        'debug', 'error', 'issue', 'problem', 'fix ',
+        'broken', 'not working', 'why is', 'what went',
+        'help', 'stuck', 'confused', 'doesn\'t work'
+    ];
+    const hasContextClue = contextKeywords.some(kw => userMessage.toLowerCase().includes(kw));
+    return isExplicitQuestion || isQuestionLike || hasContextClue;
+}
+/**
+ * Format memory search results for injection
+ */
+function formatMemoriesForInjection(memories) {
+    if (memories.length === 0)
+        return '';
+    const MAX_CONTENT_LENGTH = 150;
+    const parts = ['## Relevant Memory\n'];
+    memories.slice(0, 3).forEach((memory, index) => {
+        const content = memory.content || '';
+        const type = memory.type || 'memory';
+        const truncated = content.length > MAX_CONTENT_LENGTH
+            ? content.substring(0, MAX_CONTENT_LENGTH) + '...'
+            : content;
+        parts.push(`${index + 1}. [${type}] ${truncated.replace(/\n/g, ' ')}`);
+    });
+    return parts.join('\n');
+}
+/**
+ * Wrap async function with timeout
+ */
+async function withTimeout(promise, timeoutMs, defaultValue) {
+    return Promise.race([
+        promise,
+        new Promise((resolve) => setTimeout(() => resolve(defaultValue), timeoutMs))
+    ]);
+}
+export async function onInstall(_context) {
+    logger.info('Installation hook triggered');
+    await getDb();
+    try {
+        if (config.lifecycleEnabled || config.summarizationEnabled) {
+            await startWorker();
+            logger.info('Background worker initialized');
+        }
+    }
+    catch (error) {
+        logger.error('Failed to start background worker', error);
+    }
+    logger.info('Squish v0.6.0 ready');
+}
+export async function onSessionStart(context) {
+    const projectPath = getProjectPath(context);
+    logger.info(`Session started in ${projectPath}`);
+    let coreMemoryText = '';
+    // Initialize core memory and context session for this project
+    try {
+        const project = await ensureProject(projectPath);
+        if (project?.id) {
+            // Initialize core memory (creates sections if they don't exist)
+            await initializeCoreMemory(project.id);
+            // NEW: Retrieve and format core memory for injection
+            coreMemoryText = await withTimeout(formatCoreMemoryForInjection(project.id), 2000, 'Core memory loading timed out');
+            // Initialize context session tracking
+            if (context.sessionId) {
+                await initializeContextSession(context.sessionId, project.id);
+            }
+        }
+    }
+    catch (error) {
+        logger.error('Failed to retrieve core memory:', error);
+        return 'Core memory unavailable (database initialization in progress)';
+    }
+    if (context.config?.autoInject !== false) {
+        await injectContextIntoSession(context, projectPath).catch(err => logError('Context injection error', err));
+    }
+    if (context.config?.generateFolderContext !== false) {
+        await generateAndInjectFolderContext(projectPath).catch(err => logError('Folder context error', err));
+    }
+    if (config.governanceEnabled && context.config?.autoInject !== false) {
+        try {
+            const pinnedMemories = await getPinnedMemories();
+            if (pinnedMemories.length > 0) {
+                logger.info(`Injecting ${pinnedMemories.length} pinned memories`);
+            }
+        }
+        catch (error) {
+            logError('Failed to load pinned memories', error);
+        }
+    }
+    // Return formatted core memory for hook injection
+    return coreMemoryText || 'Core memory initialized (empty)';
+}
+export async function onUserPromptSubmit(context) {
+    const projectPath = getProjectPath(context);
+    // Keep existing auto-capture (background operation) - records user prompts for later analysis
+    if (isAutoCapture(context) && context.userMessage) {
+        captureUserPrompt(projectPath, context.userMessage, context).catch(err => logger.info('Prompt capture error', err));
+    }
+    // Smart heuristic search: Look for relevant memories only when user is asking questions or seeking help
+    // This balances automation with user control - Claude still has final say via explicit /squish:search
+    if (!context.userMessage || !shouldSmartSearch(context.userMessage)) {
+        return '';
+    }
+    try {
+        const project = await ensureProject(projectPath);
+        if (!project?.id) {
+            return '';
+        }
+        // Smart search with HYBRID scoring: semantic + recency + coactivation + importance
+        // Fetches 50 candidates, re-ranks using multi-factor scoring, returns top 3
+        const relevantMemories = await withTimeout(hybridSearch({
+            query: context.userMessage,
+            project: projectPath,
+            ...SMART_SEARCH_CONFIG,
+        }), 2000, []);
+        if (relevantMemories.length === 0) {
+            return '';
+        }
+        const formattedMemories = formatMemoriesForInjection(relevantMemories);
+        logger.info(`Smart search: Injecting ${relevantMemories.length} relevant memories`);
+        return formattedMemories;
+    }
+    catch (error) {
+        logger.error('Smart search failed:', error);
+        return '';
+    }
+}
+export async function onPostToolUse(context) {
+    if (!isAutoCapture(context) || !context.toolName)
+        return;
+    const projectPath = getProjectPath(context);
+    captureToolUse(projectPath, context.toolName, context.toolArguments, context.toolResult, context)
+        .then(observation => {
+        if (observation?.id) {
+            queueForSummarization(observation.id, projectPath).catch(err => logger.info('Summarization queue error', err));
+        }
+    })
+        .catch(err => logger.error('Tool capture error', err));
+}
+export async function onSessionStop(context) {
+    const projectPath = getProjectPath(context);
+    logger.info(`Session ended in ${projectPath}`);
+    if (context.config?.generateFolderContext !== false) {
+        await generateAndInjectFolderContext(projectPath).catch(err => logger.error('Final folder context error', err));
+    }
+    if (config.summarizationEnabled && context.sessionId) {
+        try {
+            await summarizeSession(context.sessionId, 'final');
+            logger.info('Session summarized (final)');
+        }
+        catch (error) {
+            logger.error('Failed to create final summary', error);
+        }
+    }
+    if (config.lifecycleEnabled) {
+        try {
+            await forceLifecycleMaintenance(projectPath);
+            logger.info('Lifecycle maintenance completed on session end');
+        }
+        catch (error) {
+            logger.error('Failed to run lifecycle maintenance', error);
+        }
+    }
+}
+const SQUISH_VERSION = '0.6.0';
+export async function onUpdate(context) {
+    logger.info('Squish plugin update triggered');
+    // The postinstall script should handle rebuilding
+    // Just provide user feedback
+    return `Squish v${SQUISH_VERSION} updated successfully. The MCP server will reconnect automatically.`;
+}
+export default {
+    onInstall,
+    onUpdate,
+    onSessionStart,
+    onUserPromptSubmit,
+    onPostToolUse,
+    onSessionStop
+};
+//# sourceMappingURL=plugin-wrapper.js.map

package/dist/adapters/claude-code/plugin-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-wrapper.js","sourceRoot":"","sources":["../../../adapters/claude-code/plugin-wrapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAc,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAGrE,SAAS,cAAc,CAAC,OAAsB;IAC5C,OAAO,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,OAAe,EAAE,KAAc;IAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,mBAAmB,GAAG;IAC1B,cAAc,EAAE,EAAE;IAClB,WAAW,EAAE,CAAC;IACd,aAAa,EAAE;QACb,OAAO,EAAE;YACP,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,IAAI;SACjB;QACD,SAAS,EAAE,CAAC;KACb;CACF,CAAC;AAEF,SAAS,aAAa,CAAC,OAAsB;IAC3C,OAAO,OAAO,CAAC,MAAM,EAAE,WAAW,KAAK,KAAK,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,WAAmB;IAC5C,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEzD,kEAAkE;IAClE,MAAM,kBAAkB,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG;QACvB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;QAC1C,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;QACrD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa;KAC9C,CAAC;IACF,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3F,+EAA+E;IAC/E,MAAM,eAAe,GAAG;QACtB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM;QAC5C,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW;QAC9C,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe;KAC7C,CAAC;IACF,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1F,OAAO,kBAAkB,IAAI,cAAc,IAAI,cAAc,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,QAAe;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,kBAAkB,GAAG,GAAG,CAAC;IAC/B,MAAM,KAAK,GAAa,CAAC,sBAAsB,CAAC,CAAC;IAEjD,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC;QAErC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,kBAAkB;YACnD,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,kBAAkB,CAAC,GAAG,KAAK;YAClD,CAAC,CAAC,OAAO,CAAC;QAEZ,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,MAAM,IAAI,KAAK,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW,CACxB,OAAmB,EACnB,SAAiB,EACjB,YAAe;IAEf,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,OAAO;QACP,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC;KAChF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAuB;IACrD,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC3C,MAAM,KAAK,EAAE,CAAC;IAEd,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;YAC3D,MAAM,WAAW,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAsB;IACzD,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;IAEjD,IAAI,cAAc,GAAG,EAAE,CAAC;IAExB,8DAA8D;IAC9D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,EAAE,EAAE,CAAC;YAChB,gEAAgE;YAChE,MAAM,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAEvC,qDAAqD;YACrD,cAAc,GAAG,MAAM,WAAW,CAChC,4BAA4B,CAAC,OAAO,CAAC,EAAE,CAAC,EACxC,IAAI,EACJ,+BAA+B,CAChC,CAAC;YAEF,sCAAsC;YACtC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,wBAAwB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,+DAA+D,CAAC;IACzE,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,UAAU,KAAK,KAAK,EAAE,CAAC;QACzC,MAAM,wBAAwB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAC/D,QAAQ,CAAC,yBAAyB,EAAE,GAAG,CAAC,CACzC,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,qBAAqB,KAAK,KAAK,EAAE,CAAC;QACpD,MAAM,8BAA8B,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAC5D,QAAQ,CAAC,sBAAsB,EAAE,GAAG,CAAC,CACtC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,UAAU,KAAK,KAAK,EAAE,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;YACjD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,aAAa,cAAc,CAAC,MAAM,kBAAkB,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,OAAO,cAAc,IAAI,iCAAiC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAsB;IAC7D,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAE5C,8FAA8F;IAC9F,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAClD,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CACvE,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,CAAC,CACzC,CAAC;IACJ,CAAC;IAED,wGAAwG;IACxG,sGAAsG;IACtG,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACpE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,mFAAmF;QACnF,4EAA4E;QAC5E,MAAM,gBAAgB,GAAG,MAAM,WAAW,CACxC,YAAY,CAAC;YACX,KAAK,EAAE,OAAO,CAAC,WAAW;YAC1B,OAAO,EAAE,WAAW;YACpB,GAAG,mBAAmB;SACvB,CAAC,EACF,IAAI,EACJ,EAAE,CACH,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,2BAA2B,gBAAgB,CAAC,MAAM,oBAAoB,CAAC,CAAC;QAEpF,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC5C,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO;IAEzD,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAE5C,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC;SAC9F,IAAI,CAAC,WAAW,CAAC,EAAE;QAClB,IAAI,WAAW,EAAE,EAAE,EAAE,CAAC;YACpB,qBAAqB,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAC7D,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAC9C,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;IAE/C,IAAI,OAAO,CAAC,MAAM,EAAE,qBAAqB,KAAK,KAAK,EAAE,CAAC;QACpD,MAAM,8BAA8B,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAC5D,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAChD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,oBAAoB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,gBAAgB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,yBAAyB,CAAC,WAAW,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAsB;IACnD,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAE9C,kDAAkD;IAClD,6BAA6B;IAC7B,OAAO,WAAW,cAAc,qEAAqE,CAAC;AACxG,CAAC;AAED,eAAe;IACb,SAAS;IACT,QAAQ;IACR,cAAc;IACd,kBAAkB;IAClB,aAAa;IACb,aAAa;CACd,CAAC"}

package/dist/adapters/claude-code/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Plugin Context Types
+ * Defines the interface between Claude Code and Squish plugin
+ */
+export interface PluginConfig {
+    autoCapture?: boolean;
+    autoInject?: boolean;
+    generateFolderContext?: boolean;
+    privacyMode?: 'strict' | 'moderate' | 'off';
+    maxContextItems?: number;
+    maxContextTokens?: number;
+}
+export interface PluginContext {
+    workingDirectory?: string;
+    sessionId?: string;
+    conversationId?: string;
+    userMessage?: string;
+    userRole?: 'user' | 'assistant';
+    toolName?: string;
+    toolArguments?: Record<string, any>;
+    toolResult?: string | Record<string, any>;
+    config?: PluginConfig;
+    pluginVersion?: string;
+    pluginPath?: string;
+}
+export interface SessionContext {
+    id: string;
+    workingDirectory: string;
+    startTime: Date;
+    conversationId: string;
+    projectPath: string;
+    gitRemote?: string;
+    gitBranch?: string;
+}
+export interface CapturedObservation {
+    id: string;
+    type: 'tool_use' | 'user_prompt' | 'file_change' | 'error' | 'pattern' | 'insight';
+    action: string;
+    target: string;
+    summary: string;
+    details?: Record<string, any>;
+    timestamp: Date;
+    projectPath: string;
+    sessionId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/claude-code/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../adapters/claude-code/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAE5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAGhC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAG1C,MAAM,CAAC,EAAE,YAAY,CAAC;IAGtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/adapters/claude-code/types.js

@@ -0,0 +1,6 @@
+/**
+ * Plugin Context Types
+ * Defines the interface between Claude Code and Squish plugin
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/claude-code/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../adapters/claude-code/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/algorithms/merge/analytics/token-estimator.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Token estimation for calculating context window savings from merges.
+ * Uses simple heuristic: 1 token ≈ 4 characters (can be upgraded to tiktoken for accuracy).
+ */
+import type { Memory } from '../../../drizzle/schema.js';
+import type { MergedMemory } from '../strategies/merge-strategies.js';
+export declare function estimateTokensSaved(sources: Memory[], merged: MergedMemory): number;
+export declare function calculateProjectTokenSavings(projectId: string): Promise<{
+    totalSaved: number;
+    mergeCount: number;
+    avgSavingsPerMerge: number;
+    tokenSavingPercentage: number;
+    totalMemoryTokens: number;
+}>;
+/**
+ * Format token counts for display
+ *
+ * Converts token count to human-readable format with context usage
+ */
+export declare function formatTokenCount(tokens: number): string;
+/**
+ * Format savings report
+ */
+export declare function formatSavingsReport(savings: {
+    totalSaved: number;
+    mergeCount: number;
+    avgSavingsPerMerge: number;
+    tokenSavingPercentage: number;
+    totalMemoryTokens: number;
+}): string;
+/**
+ * Estimate savings for a proposed merge (preview)
+ *
+ * Used in merge preview to show user estimated savings
+ */
+export declare function estimateMergeSavingsPreview(sources: Memory[], merged: MergedMemory): {
+    savedTokens: number;
+    savedPercentage: number;
+};
+/**
+ * Get token statistics for a set of memories
+ */
+export declare function getTokenStatistics(memories: Memory[]): {
+    total: number;
+    min: number;
+    max: number;
+    average: number;
+    median: number;
+};
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/algorithms/merge/analytics/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../../../algorithms/merge/analytics/token-estimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAwDtE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAMnF;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC,CAuCD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAevD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAkBT;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,YAAY,GACnB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAOlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAmBA"}

package/dist/algorithms/merge/analytics/token-estimator.js

@@ -0,0 +1,154 @@
+/**
+ * Token estimation for calculating context window savings from merges.
+ * Uses simple heuristic: 1 token ≈ 4 characters (can be upgraded to tiktoken for accuracy).
+ */
+import { getDb } from '../../../db/index.js';
+import { getSchema } from '../../../db/schema.js';
+import { createDatabaseClient } from '../../../core/database.js';
+import { eq } from 'drizzle-orm';
+function estimateTokensSimple(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+function estimateMetadataOverhead() {
+    return 25;
+}
+function estimateMemoryTokens(memory) {
+    let tokens = 0;
+    tokens += estimateTokensSimple(memory.content);
+    if (memory.summary) {
+        tokens += estimateTokensSimple(memory.summary);
+    }
+    if (memory.tags && memory.tags.length > 0) {
+        tokens += estimateTokensSimple(memory.tags.join(' '));
+    }
+    if (memory.metadata) {
+        tokens += estimateTokensSimple(JSON.stringify(memory.metadata));
+    }
+    tokens += estimateMetadataOverhead();
+    return tokens;
+}
+function estimateMergedMemoryTokens(merged) {
+    let tokens = 0;
+    tokens += estimateTokensSimple(merged.content);
+    if (merged.summary) {
+        tokens += estimateTokensSimple(merged.summary);
+    }
+    if (merged.tags && merged.tags.length > 0) {
+        tokens += estimateTokensSimple(merged.tags.join(' '));
+    }
+    tokens += estimateTokensSimple(JSON.stringify(merged.metadata));
+    tokens += estimateMetadataOverhead();
+    return tokens;
+}
+export function estimateTokensSaved(sources, merged) {
+    const sourceTokens = sources.reduce((sum, memory) => sum + estimateMemoryTokens(memory), 0);
+    const mergedTokens = estimateMergedMemoryTokens(merged);
+    const savings = sourceTokens - mergedTokens;
+    return Math.max(0, savings);
+}
+export async function calculateProjectTokenSavings(projectId) {
+    const db = createDatabaseClient(await getDb());
+    const schema = await getSchema();
+    const memories = await db
+        .select()
+        .from(schema.memories)
+        .where(eq(schema.memories.projectId, projectId));
+    const totalMemoryTokens = memories.reduce((sum, m) => sum + estimateMemoryTokens(m), 0);
+    if (!schema.memoryMergeHistory) {
+        return {
+            totalSaved: 0,
+            mergeCount: 0,
+            avgSavingsPerMerge: 0,
+            tokenSavingPercentage: 0,
+            totalMemoryTokens,
+        };
+    }
+    const mergeHistory = await db
+        .select()
+        .from(schema.memoryMergeHistory)
+        .where(eq(schema.memoryMergeHistory.projectId, projectId));
+    // Sum up token savings
+    const totalSaved = mergeHistory.reduce((sum, record) => sum + (record.tokensSaved || 0), 0);
+    const mergeCount = mergeHistory.length;
+    const avgSavingsPerMerge = mergeCount > 0 ? Math.round(totalSaved / mergeCount) : 0;
+    const tokenSavingPercentage = totalMemoryTokens > 0 ? (totalSaved / totalMemoryTokens) * 100 : 0;
+    return {
+        totalSaved,
+        mergeCount,
+        avgSavingsPerMerge,
+        tokenSavingPercentage,
+        totalMemoryTokens,
+    };
+}
+/**
+ * Format token counts for display
+ *
+ * Converts token count to human-readable format with context usage
+ */
+export function formatTokenCount(tokens) {
+    // Show percentage of typical context window
+    // Claude 3 / GPT-4: 128k tokens (~32k practical for context)
+    const contextWindow = 128000;
+    const typicalUseful = 32000;
+    const percentage = (tokens / contextWindow) * 100;
+    const usefulPercent = (tokens / typicalUseful) * 100;
+    if (tokens < 1000) {
+        return `${tokens} tokens (${percentage.toFixed(3)}% of context)`;
+    }
+    const kiloTokens = (tokens / 1000).toFixed(1);
+    return `${kiloTokens}k tokens (${usefulPercent.toFixed(1)}% of typical recall window)`;
+}
+/**
+ * Format savings report
+ */
+export function formatSavingsReport(savings) {
+    const lines = [];
+    lines.push('Memory Merge Savings Report');
+    lines.push('='.repeat(40));
+    if (savings.mergeCount === 0) {
+        lines.push('No merges completed yet');
+        return lines.join('\n');
+    }
+    lines.push(`Total Merges: ${savings.mergeCount}`);
+    lines.push(`Total Tokens Saved: ${formatTokenCount(savings.totalSaved)}`);
+    lines.push(`Avg Savings per Merge: ${formatTokenCount(savings.avgSavingsPerMerge)}`);
+    lines.push(`Reduction: ${savings.tokenSavingPercentage.toFixed(2)}%`);
+    lines.push(`Total Memory Tokens: ${formatTokenCount(savings.totalMemoryTokens)}`);
+    return lines.join('\n');
+}
+/**
+ * Estimate savings for a proposed merge (preview)
+ *
+ * Used in merge preview to show user estimated savings
+ */
+export function estimateMergeSavingsPreview(sources, merged) {
+    const sourceTokens = sources.reduce((sum, m) => sum + estimateMemoryTokens(m), 0);
+    const mergedTokens = estimateMergedMemoryTokens(merged);
+    const savedTokens = Math.max(0, sourceTokens - mergedTokens);
+    const savedPercentage = sourceTokens > 0 ? (savedTokens / sourceTokens) * 100 : 0;
+    return { savedTokens, savedPercentage };
+}
+/**
+ * Get token statistics for a set of memories
+ */
+export function getTokenStatistics(memories) {
+    const counts = memories.map((m) => estimateMemoryTokens(m));
+    const total = counts.reduce((a, b) => a + b, 0);
+    const min = Math.min(...counts);
+    const max = Math.max(...counts);
+    const average = Math.round(total / counts.length);
+    // Calculate median
+    const sorted = [...counts].sort((a, b) => a - b);
+    const middle = Math.floor(sorted.length / 2);
+    const median = sorted.length % 2 !== 0 ? sorted[middle] : (sorted[middle - 1] + sorted[middle]) / 2;
+    return {
+        total,
+        min,
+        max,
+        average,
+        median: Math.round(median),
+    };
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/algorithms/merge/analytics/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../../../algorithms/merge/analytics/token-estimator.ts"],"names":[],"mappings":"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"}

package/dist/algorithms/merge/detection/hash-filters.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Hash-based duplicate detection filters (Stage 1).
+ * Uses SimHash and MinHash for fast approximate matching before semantic analysis.
+ */
+/**
+ * SimHash: Fast fingerprinting for near-duplicate detection.
+ * Tokenizes content, weights by frequency, and produces comparable hash fingerprints.
+ * Similar documents produce similar hashes with Hamming distance indicating edit distance.
+ */
+export declare class SimHashFilter {
+    private readonly dimensions;
+    generateHash(content: string): string;
+    hammingDistance(hash1: string, hash2: string): number;
+    findCandidates(targetHash: string, allHashes: Map<string, string>, threshold: number): string[];
+    private hashToken;
+    private popcount;
+}
+/**
+ * MinHash: Estimates Jaccard similarity using character n-grams and multiple hash functions.
+ * Keeps minimum hash for each function, resulting in comparable signatures.
+ * More effective than SimHash for paraphrases. 128 functions give ~1% error margin.
+ */
+export declare class MinHashFilter {
+    private readonly numPermutations;
+    private readonly ngramSize;
+    generateSignature(content: string): number[];
+    jaccardSimilarity(sig1: number[], sig2: number[]): number;
+    findCandidates(targetSig: number[], allSigs: Map<string, number[]>, threshold: number): string[];
+    private generateNgrams;
+    private hashNgramWithSeed;
+}
+export interface Stage1CandidatePair {
+    memoryId1: string;
+    memoryId2: string;
+    simhashDistance: number;
+    minhashSimilarity: number;
+    matched: 'simhash' | 'minhash' | 'both';
+}
+/**
+ * Combine SimHash and MinHash filters using union approach.
+ * Candidates pass if they match EITHER filter, casting wider net for stage 2 ranking.
+ */
+export declare function findCandidatePairs(memories: Map<string, string>, allSimhashes: Map<string, string>, allMinhashes: Map<string, number[]>, options: {
+    simhashThreshold?: number;
+    minhashThreshold?: number;
+}): Stage1CandidatePair[];
+//# sourceMappingURL=hash-filters.d.ts.map

package/dist/algorithms/merge/detection/hash-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-filters.d.ts","sourceRoot":"","sources":["../../../../algorithms/merge/detection/hash-filters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IAEjC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAuCrC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAOrD,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE;IAaX,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,QAAQ;CAQjB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAO;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAK;IAE/B,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAuB5C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;IAmBzD,cAAc,CACZ,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE;IAaX,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,iBAAiB;CAU1B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACnC,OAAO,EAAE;IACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,mBAAmB,EAAE,CAiDvB"}