hippo-memory 0.36.0 → 0.37.0

package/dist/src/importers.js

@@ -0,0 +1,399 @@
+/**
+ * Memory importers for Hippo.
+ * Imports memories from ChatGPT, Claude, Cursor, generic files, and structured markdown.
+ */
+import * as fs from 'fs';
+import { createMemory, Layer } from './memory.js';
+import { loadAllEntries, writeEntry } from './store.js';
+import { textOverlap } from './search.js';
+import { getGlobalRoot, initGlobal } from './shared.js';
+// ---------------------------------------------------------------------------
+// Shared core: dedup + write
+// ---------------------------------------------------------------------------
+/**
+ * Given an array of raw text chunks, deduplicate against existing memories,
+ * create MemoryEntry objects, write them (unless dry-run), and return a result.
+ */
+export function importEntries(chunks, source, tags, options) {
+    const targetRoot = options.global ? getGlobalRoot() : options.hippoRoot;
+    // Ensure store is ready
+    if (options.global) {
+        initGlobal();
+    }
+    const existing = loadAllEntries(targetRoot);
+    const allTags = [...new Set([...tags, ...(options.extraTags ?? [])])];
+    let total = 0;
+    let imported = 0;
+    let skipped = 0;
+    const entries = [];
+    for (const raw of chunks) {
+        const trimmed = raw.trim();
+        if (trimmed.length > 1000) {
+            console.error(`Warning: imported memory truncated from ${trimmed.length} to 1000 chars`);
+        }
+        const chunk = trimmed.slice(0, 1000);
+        // Skip empty or too-short chunks
+        if (!chunk || chunk.length < 10) {
+            skipped++;
+            continue;
+        }
+        total++;
+        // Dedup check: textOverlap > 0.7 with any existing memory = skip
+        let isDuplicate = false;
+        for (const existing_entry of existing) {
+            if (textOverlap(chunk, existing_entry.content) > 0.7) {
+                isDuplicate = true;
+                break;
+            }
+        }
+        if (isDuplicate) {
+            skipped++;
+            continue;
+        }
+        // A3: kind defaults to 'distilled'. ChatGPT/Claude/Cursor exports are curated
+        // user pastes, not raw transcripts from a system of record, so distilled is
+        // correct here. E1.3 (Slack ingestion) shipped 2026-04-29 in src/connectors/slack/
+        // and sets kind: 'raw' + routes deletions through archiveRawMemory() — these
+        // importers stay 'distilled' per the original reasoning. See MEMORY_ENVELOPE.md.
+        const entry = createMemory(chunk, {
+            layer: Layer.Episodic,
+            tags: allTags,
+            source,
+            confidence: 'observed',
+        });
+        entries.push(entry);
+        if (!options.dryRun) {
+            writeEntry(targetRoot, entry);
+            // Add to existing so subsequent chunks dedup against freshly imported ones
+            existing.push(entry);
+        }
+        imported++;
+    }
+    return { total, imported, skipped, entries };
+}
+// ---------------------------------------------------------------------------
+// ChatGPT importer
+// ---------------------------------------------------------------------------
+/**
+ * Parse ChatGPT memory export file.
+ * Supports:
+ *   - JSON array of strings: ["memory 1", "memory 2"]
+ *   - JSON array of objects: [{"content": "...", "created": "..."}]
+ *   - ChatGPT export format: {"memories": [{"content": "...", "created_at": "..."}]}
+ *   - Plain text: one memory per line
+ */
+function parseChatGPTFile(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf8').trim();
+    // Try JSON first
+    if (raw.startsWith('[') || raw.startsWith('{')) {
+        try {
+            const parsed = JSON.parse(raw);
+            // {"memories": [...]} - ChatGPT export format
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed) && Array.isArray(parsed.memories)) {
+                return parsed.memories
+                    .map((m) => {
+                    if (typeof m === 'string')
+                        return m;
+                    if (m && typeof m === 'object') {
+                        const obj = m;
+                        return String(obj['content'] ?? obj['text'] ?? '');
+                    }
+                    return '';
+                })
+                    .filter(Boolean);
+            }
+            // Array format
+            if (Array.isArray(parsed)) {
+                return parsed
+                    .map((m) => {
+                    if (typeof m === 'string')
+                        return m;
+                    if (m && typeof m === 'object') {
+                        const obj = m;
+                        return String(obj['content'] ?? obj['text'] ?? '');
+                    }
+                    return '';
+                })
+                    .filter(Boolean);
+            }
+        }
+        catch {
+            // Fall through to plain text
+        }
+    }
+    // Plain text: one memory per line
+    return raw.split('\n').map((l) => l.trim()).filter(Boolean);
+}
+export function importChatGPT(filePath, options) {
+    const chunks = parseChatGPTFile(filePath);
+    return importEntries(chunks, 'import:chatgpt', ['imported', 'chatgpt'], options);
+}
+// ---------------------------------------------------------------------------
+// Claude importer
+// ---------------------------------------------------------------------------
+const HIPPO_START = '<!-- hippo:start -->';
+const HIPPO_END = '<!-- hippo:end -->';
+/**
+ * Strip the hippo hook block from markdown content.
+ */
+function stripHippoBlock(content) {
+    const startIdx = content.indexOf(HIPPO_START);
+    const endIdx = content.indexOf(HIPPO_END);
+    if (startIdx === -1 || endIdx === -1)
+        return content;
+    return content.slice(0, startIdx) + content.slice(endIdx + HIPPO_END.length);
+}
+/**
+ * Split markdown into meaningful chunks (headings + bullet points).
+ */
+function splitMarkdown(content) {
+    const chunks = [];
+    const lines = content.split('\n');
+    let current = '';
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Heading: start a new chunk
+        if (/^#{1,6}\s+/.test(trimmed)) {
+            if (current.trim())
+                chunks.push(current.trim());
+            current = trimmed;
+            continue;
+        }
+        // Bullet point: each bullet is its own chunk (flush previous if not a bullet context)
+        if (/^[-*+]\s+/.test(trimmed)) {
+            if (current.trim() && !/^[-*+]\s+/.test(current.split('\n')[0])) {
+                chunks.push(current.trim());
+                current = '';
+            }
+            if (current.trim()) {
+                chunks.push(current.trim());
+                current = '';
+            }
+            current = trimmed.replace(/^[-*+]\s+/, '').trim();
+            continue;
+        }
+        // Numbered list item
+        if (/^\d+\.\s+/.test(trimmed)) {
+            if (current.trim()) {
+                chunks.push(current.trim());
+                current = '';
+            }
+            current = trimmed.replace(/^\d+\.\s+/, '').trim();
+            continue;
+        }
+        // Empty line
+        if (!trimmed) {
+            if (current.trim()) {
+                chunks.push(current.trim());
+                current = '';
+            }
+            continue;
+        }
+        // Regular line: append to current
+        current = current ? current + ' ' + trimmed : trimmed;
+    }
+    if (current.trim())
+        chunks.push(current.trim());
+    return chunks.filter(Boolean);
+}
+/**
+ * Parse CLAUDE.md or Claude memory.json.
+ */
+function parseClaudeFile(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    // JSON memory file
+    if (filePath.endsWith('.json')) {
+        try {
+            const parsed = JSON.parse(raw.trim());
+            if (Array.isArray(parsed)) {
+                return parsed
+                    .map((m) => {
+                    if (typeof m === 'string')
+                        return m;
+                    if (m && typeof m === 'object') {
+                        const obj = m;
+                        return String(obj['content'] ?? obj['text'] ?? '');
+                    }
+                    return '';
+                })
+                    .filter(Boolean);
+            }
+        }
+        catch {
+            // Fall through to markdown
+        }
+    }
+    // Markdown file: strip hippo block and split
+    const cleaned = stripHippoBlock(raw);
+    return splitMarkdown(cleaned);
+}
+export function importClaude(filePath, options) {
+    const chunks = parseClaudeFile(filePath);
+    return importEntries(chunks, 'import:claude', ['imported', 'claude'], options);
+}
+// ---------------------------------------------------------------------------
+// Cursor importer
+// ---------------------------------------------------------------------------
+/**
+ * Split cursor rules file into chunks.
+ * Priority: numbered items, then bullet points, then double newlines.
+ */
+function parseCursorFile(content) {
+    const chunks = [];
+    const lines = content.split('\n');
+    let current = '';
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip comment-only lines that are empty after stripping #
+        if (!trimmed || trimmed === '#') {
+            if (current.trim()) {
+                chunks.push(current.trim());
+                current = '';
+            }
+            continue;
+        }
+        // Numbered item: 1. 2. 3.
+        if (/^\d+\.\s+/.test(trimmed)) {
+            if (current.trim()) {
+                chunks.push(current.trim());
+                current = '';
+            }
+            current = trimmed.replace(/^\d+\.\s+/, '').trim();
+            continue;
+        }
+        // Bullet: - or *
+        if (/^[-*]\s+/.test(trimmed)) {
+            if (current.trim()) {
+                chunks.push(current.trim());
+                current = '';
+            }
+            current = trimmed.replace(/^[-*]\s+/, '').trim();
+            continue;
+        }
+        // Regular line
+        current = current ? current + ' ' + trimmed : trimmed;
+    }
+    if (current.trim())
+        chunks.push(current.trim());
+    // Also split on double newlines within chunks if they somehow ended up there
+    return chunks.flatMap((c) => {
+        const parts = c.split(/\n{2,}/);
+        return parts.map((p) => p.trim()).filter(Boolean);
+    });
+}
+export function importCursor(filePath, options) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const chunks = parseCursorFile(raw);
+    return importEntries(chunks, 'import:cursor', ['imported', 'cursor'], options);
+}
+// ---------------------------------------------------------------------------
+// Generic file importer
+// ---------------------------------------------------------------------------
+/**
+ * Split a generic file into chunks.
+ * Markdown: split on headings and bullet points.
+ * Plain text: split on double newlines or one-per-line.
+ */
+function parseGenericFile(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const isMarkdown = filePath.endsWith('.md') || filePath.endsWith('.mdx');
+    if (isMarkdown) {
+        return splitMarkdown(raw);
+    }
+    // Plain text: try double newlines first
+    const byParagraph = raw.split(/\n{2,}/).map((p) => p.trim()).filter(Boolean);
+    if (byParagraph.length > 1)
+        return byParagraph;
+    // Fall back to one-per-line
+    return raw.split('\n').map((l) => l.trim()).filter(Boolean);
+}
+export function importGenericFile(filePath, options) {
+    const chunks = parseGenericFile(filePath);
+    return importEntries(chunks, 'import:file', ['imported'], options);
+}
+// ---------------------------------------------------------------------------
+// Structured markdown importer (MEMORY.md / AGENTS.md format)
+// ---------------------------------------------------------------------------
+/**
+ * Slugify a heading for use as a tag.
+ * "Data Pipeline & Cache" -> "data-pipeline-cache"
+ */
+function slugify(heading) {
+    return heading
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, ' ')
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .slice(0, 50);
+}
+/**
+ * Parse structured markdown into {content, sectionSlug} pairs.
+ * Each heading starts a new section. Bullet points / numbered items under
+ * the heading become individual memories tagged with the section slug.
+ */
+function parseStructuredMarkdown(raw) {
+    const results = [];
+    const lines = raw.split('\n');
+    let currentSection = '';
+    let currentSlug = '';
+    let pendingText = '';
+    function flush() {
+        if (!pendingText.trim())
+            return;
+        results.push({ content: pendingText.trim(), sectionSlug: currentSlug });
+        pendingText = '';
+    }
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Heading
+        const headingMatch = trimmed.match(/^(#{1,6})\s+(.+)/);
+        if (headingMatch) {
+            flush();
+            currentSection = headingMatch[2].trim();
+            currentSlug = slugify(currentSection);
+            continue;
+        }
+        // Bullet or numbered item: flush previous, start new
+        if (/^[-*+]\s+/.test(trimmed) || /^\d+\.\s+/.test(trimmed)) {
+            flush();
+            const itemText = trimmed.replace(/^[-*+]\s+/, '').replace(/^\d+\.\s+/, '').trim();
+            pendingText = itemText;
+            continue;
+        }
+        // Empty line: flush current pending
+        if (!trimmed) {
+            flush();
+            continue;
+        }
+        // Continuation of current item
+        pendingText = pendingText ? pendingText + ' ' + trimmed : trimmed;
+    }
+    flush();
+    return results.filter((r) => r.content.length > 0);
+}
+export function importMarkdown(filePath, options) {
+    const raw = fs.readFileSync(filePath, 'utf8');
+    const parsed = parseStructuredMarkdown(raw);
+    // Group by section slug so we can pass per-chunk tags
+    // We call importEntries per unique slug to get the right tags per section
+    const bySlug = new Map();
+    for (const { content, sectionSlug } of parsed) {
+        const list = bySlug.get(sectionSlug) ?? [];
+        list.push(content);
+        bySlug.set(sectionSlug, list);
+    }
+    let totalResult = { total: 0, imported: 0, skipped: 0, entries: [] };
+    for (const [slug, chunks] of bySlug.entries()) {
+        const sectionTags = slug ? ['imported', slug] : ['imported'];
+        const result = importEntries(chunks, 'import:markdown', sectionTags, options);
+        totalResult = {
+            total: totalResult.total + result.total,
+            imported: totalResult.imported + result.imported,
+            skipped: totalResult.skipped + result.skipped,
+            entries: [...totalResult.entries, ...result.entries],
+        };
+    }
+    return totalResult;
+}
+//# sourceMappingURL=importers.js.map

package/dist/src/importers.js.map

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

package/dist/src/index.js

@@ -0,0 +1,25 @@
+/**
+ * Hippo public API  - re-exports for programmatic use.
+ */
+export { Layer, calculateStrength, resolveConfidence, createMemory, applyOutcome, generateId, computeSchemaFit } from './memory.js';
+export { search, hybridSearch, physicsSearch, markRetrieved, estimateTokens, textOverlap, tokenize, explainMatch, detectTemporalDirection, temporalBoost, computeTemporalRange } from './search.js';
+export { multihopSearch } from './multihop.js';
+export { initStore, loadAllEntries, loadSearchEntries, writeEntry, readEntry, deleteEntry, loadIndex, rebuildIndex, saveActiveTaskSnapshot, loadActiveTaskSnapshot, clearActiveTaskSnapshot, appendSessionEvent, listSessionEvents, listMemoryConflicts, replaceDetectedConflicts, resolveConflict, saveSessionHandoff, loadLatestHandoff, loadHandoffById, loadSessionDecayContext, } from './store.js';
+export { consolidate } from './consolidate.js';
+// Feature 1: Embedding search
+export { isEmbeddingAvailable, getEmbedding, cosineSimilarity, loadEmbeddingIndex, saveEmbeddingIndex, embedMemory, embedAll, } from './embeddings.js';
+// Feature 2: Auto-learn from errors
+export { captureError, extractLessons, deduplicateLesson, runWatched, fetchGitLog, } from './autolearn.js';
+// Feature 3: Cross-agent shared memory
+export { getGlobalRoot, initGlobal, promoteToGlobal, searchBoth, searchBothHybrid, syncGlobalToLocal, transferScore, shareMemory, listPeers, autoShare, } from './shared.js';
+// Feature 5: Working memory
+export { wmPush, wmRead, wmClear, wmFlush, WM_MAX_ENTRIES, } from './working-memory.js';
+// Feature 4: Memory importers
+export { importChatGPT, importClaude, importCursor, importGenericFile, importMarkdown, importEntries, } from './importers.js';
+// Feature eval suite
+export { runFeatureEval, formatResult, resultToBaseline, detectRegressions, buildSyntheticCorpus, } from './eval-suite.js';
+// Pineal gland: salience gate
+export { computeSalience, } from './salience.js';
+// Pineal gland: ambient state vector
+export { computeAmbientState, renderAmbientSummary, formatAmbientVector, } from './ambient.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAe,KAAK,EAAmD,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClM,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,oBAAoB,EAAkC,MAAM,aAAa,CAAC;AACpO,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,GAExB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,WAAW,EAAuB,MAAM,kBAAkB,CAAC;AAEpE,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,oCAAoC;AACpC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,uCAAuC;AACvC,OAAO,EACL,aAAa,EACb,UAAU,EACV,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EAEjB,aAAa,EACb,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,4BAA4B;AAC5B,OAAO,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EAEP,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,aAAa,GAGd,MAAM,gBAAgB,CAAC;AAExB,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,8BAA8B;AAC9B,OAAO,EACL,eAAe,GAIhB,MAAM,eAAe,CAAC;AAEvB,qCAAqC;AACrC,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GAEpB,MAAM,cAAc,CAAC"}

package/dist/src/invalidation.js

@@ -0,0 +1,94 @@
+import { loadAllEntries, writeEntry } from './store.js';
+/**
+ * Extract what was replaced/removed from a commit message.
+ * Returns null if the commit isn't a breaking/migration change.
+ */
+export function extractInvalidationTarget(message) {
+    // Strip conventional commit prefix (e.g., "feat(scope): ")
+    const body = message.replace(/^[a-z]+(\([^)]*\))?:\s*/i, '').trim();
+    // Pattern: "migrate/switch/move/convert/transition/upgrade from X to Y"
+    const fromToMatch = body.match(/(?:migrat\w+|switch\w*|mov\w+|convert\w*|transition\w*|upgrad\w+)\s+(?:from\s+)?(.+?)\s+to\s+(.+)/i);
+    if (fromToMatch) {
+        return { from: fromToMatch[1].trim(), to: fromToMatch[2].trim(), type: 'migration' };
+    }
+    // Pattern: "from X to Y" (standalone)
+    const standaloneFromTo = body.match(/from\s+(.+?)\s+to\s+(.+)/i);
+    if (standaloneFromTo) {
+        return { from: standaloneFromTo[1].trim(), to: standaloneFromTo[2].trim(), type: 'migration' };
+    }
+    // Pattern: "replace X with Y"
+    const replaceMatch = body.match(/replac\w+\s+(.+?)\s+with\s+(.+)/i);
+    if (replaceMatch) {
+        return { from: replaceMatch[1].trim(), to: replaceMatch[2].trim(), type: 'migration' };
+    }
+    // Pattern: "deprecate X"
+    const deprecateMatch = body.match(/deprecat\w+\s+(.+)/i);
+    if (deprecateMatch) {
+        return { from: deprecateMatch[1].trim(), to: null, type: 'deprecation' };
+    }
+    // Pattern: "remove/drop X" (but not trivial removals)
+    const removeMatch = body.match(/(?:remov\w+|drop\w*)\s+(.+)/i);
+    if (removeMatch) {
+        const target = removeMatch[1].trim();
+        const words = target.split(/\s+/);
+        const trivialWords = new Set(['extra', 'unused', 'empty', 'old', 'whitespace', 'spaces', 'blank', 'dead', 'commented']);
+        const isTrivial = words.length <= 2 && words.some(w => trivialWords.has(w.toLowerCase()));
+        if (isTrivial)
+            return null;
+        return { from: target, to: null, type: 'removal' };
+    }
+    return null;
+}
+/**
+ * Find memories that reference the invalidated pattern and weaken them.
+ * - Halves half_life_days
+ * - Sets confidence to 'stale'
+ * - Adds 'invalidated' tag
+ * - Skips pinned memories
+ */
+export function invalidateMatching(hippoRoot, target) {
+    const entries = loadAllEntries(hippoRoot);
+    const fromTokens = invalidationTokenize(target.from);
+    const result = { invalidated: 0, targets: [] };
+    for (const entry of entries) {
+        if (entry.pinned)
+            continue;
+        const contentTokens = invalidationTokenize(entry.content);
+        const tagTokens = entry.tags.map(t => t.toLowerCase());
+        // Check if the memory references the old pattern
+        const tokenMatch = matchScore(fromTokens, contentTokens);
+        const tagMatch = fromTokens.some(t => tagTokens.includes(t));
+        if (tokenMatch >= 0.5 || tagMatch) {
+            entry.half_life_days = Math.max(1, Math.floor(entry.half_life_days / 2));
+            entry.confidence = 'stale';
+            if (!entry.tags.includes('invalidated')) {
+                entry.tags.push('invalidated');
+            }
+            writeEntry(hippoRoot, entry);
+            result.invalidated++;
+            result.targets.push(entry.id);
+        }
+    }
+    return result;
+}
+const STOPWORDS = new Set([
+    'the', 'an', 'is', 'it', 'in', 'on', 'at', 'to', 'for', 'of', 'by',
+    'and', 'or', 'but', 'not', 'with', 'from', 'that', 'this', 'was', 'are',
+    'be', 'has', 'had', 'have', 'been', 'will', 'would', 'could', 'should',
+    'do', 'does', 'did', 'all', 'our', 'old', 'new', 'use', 'used', 'using',
+]);
+function invalidationTokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s_.-]/g, ' ')
+        .split(/\s+/)
+        .filter(t => t.length >= 2 && !STOPWORDS.has(t));
+}
+function matchScore(fromTokens, contentTokens) {
+    if (fromTokens.length === 0)
+        return 0;
+    const contentSet = new Set(contentTokens);
+    const matches = fromTokens.filter(t => contentSet.has(t)).length;
+    return matches / fromTokens.length;
+}
+//# sourceMappingURL=invalidation.js.map

package/dist/src/invalidation.js.map

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

package/dist/src/mcp/framing.js

@@ -0,0 +1,45 @@
+// MCP stdio transport framing.
+//
+// Spec: messages are newline-delimited JSON-RPC, with no embedded newlines.
+//   https://modelcontextprotocol.io/specification/.../basic/transports#stdio
+// We also accept legacy LSP-style `Content-Length` framing so the
+// printf-and-pipe smoke test from issue #13 still works.
+const HEADER_DELIM = Buffer.from('\r\n\r\n');
+export function parseFrame(buffer) {
+    // Strip leading whitespace/newlines between messages.
+    let start = 0;
+    while (start < buffer.length &&
+        (buffer[start] === 0x0a || buffer[start] === 0x0d ||
+            buffer[start] === 0x20 || buffer[start] === 0x09)) {
+        start++;
+    }
+    if (start === buffer.length)
+        return { kind: 'incomplete' };
+    const trimmed = buffer.subarray(start);
+    // LSP-style Content-Length framing.
+    if (trimmed[0] === 0x43 /* 'C' */ || trimmed[0] === 0x63 /* 'c' */) {
+        const headerEnd = trimmed.indexOf(HEADER_DELIM);
+        if (headerEnd === -1)
+            return { kind: 'incomplete' };
+        const header = trimmed.subarray(0, headerEnd).toString('utf-8');
+        const match = header.match(/Content-Length:\s*(\d+)/i);
+        if (!match)
+            return { kind: 'skip', rest: Buffer.from(trimmed.subarray(headerEnd + 4)) };
+        const contentLength = parseInt(match[1], 10);
+        const bodyStart = headerEnd + 4;
+        if (trimmed.length < bodyStart + contentLength)
+            return { kind: 'incomplete' };
+        const body = trimmed.subarray(bodyStart, bodyStart + contentLength).toString('utf-8');
+        return { kind: 'message', body, rest: Buffer.from(trimmed.subarray(bodyStart + contentLength)) };
+    }
+    // Newline-delimited JSON (MCP spec).
+    const newlineIdx = trimmed.indexOf(0x0a);
+    if (newlineIdx === -1)
+        return { kind: 'incomplete' };
+    const line = trimmed.subarray(0, newlineIdx).toString('utf-8').trimEnd();
+    const rest = Buffer.from(trimmed.subarray(newlineIdx + 1));
+    if (!line)
+        return { kind: 'skip', rest };
+    return { kind: 'message', body: line, rest };
+}
+//# sourceMappingURL=framing.js.map

package/dist/src/mcp/framing.js.map

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