turboflux 1.0.0

package/dist/tools/memory/loaders.js

@@ -0,0 +1,292 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { sanitizeMemoryText } from './sanitizer';
+const MEMORIES_PER_GROUP_MAX = 32;
+const FILE_BYTES_MAX = 64 * 1024;
+const FACTS_JSONL_BYTES_MAX = 4 * 1024 * 1024;
+function memoryId(absPath, index) {
+    let hash = 5381;
+    for (let i = 0; i < absPath.length; i += 1) {
+        hash = ((hash << 5) + hash + absPath.charCodeAt(i)) | 0;
+    }
+    return `mem_${(hash >>> 0).toString(36)}_${index}`;
+}
+function toRelative(workspacePath, absPath) {
+    const rel = path.relative(workspacePath, absPath).replace(/\\/g, '/');
+    return rel.startsWith('..') ? absPath.replace(/\\/g, '/') : rel;
+}
+function readTextFileSafe(absPath, ctx, maxBytes = FILE_BYTES_MAX) {
+    try {
+        const stat = fs.statSync(absPath);
+        if (!stat.isFile())
+            return null;
+        if (stat.size > maxBytes) {
+            ctx.warnings.push(`Skipped ${toRelative(ctx.workspacePath, absPath)}: file exceeds ${maxBytes} bytes`);
+            return null;
+        }
+        return fs.readFileSync(absPath, 'utf-8');
+    }
+    catch (error) {
+        const code = error.code;
+        if (code && code !== 'ENOENT' && code !== 'ENOTDIR') {
+            ctx.warnings.push(`Failed to read ${toRelative(ctx.workspacePath, absPath)}: ${code}`);
+        }
+        return null;
+    }
+}
+function stripFrontmatter(content) {
+    if (!content.startsWith('---'))
+        return { text: content, tags: [] };
+    const endIdx = content.indexOf('\n---', 3);
+    if (endIdx < 0)
+        return { text: content, tags: [] };
+    const body = content.slice(endIdx + 4).replace(/^\n+/, '');
+    const head = content.slice(3, endIdx);
+    const tags = [];
+    for (const line of head.split(/\r?\n/)) {
+        const match = /^\s*([A-Za-z_][\w-]*)\s*:\s*(.+?)\s*$/.exec(line);
+        if (!match)
+            continue;
+        const key = match[1].toLowerCase();
+        const value = match[2].replace(/^["'`]|["'`]$/g, '');
+        if (value && value !== 'true' && value !== 'false') {
+            tags.push(`${key}:${value}`.slice(0, 64));
+        }
+        else if (value === 'true') {
+            tags.push(key);
+        }
+    }
+    return { text: body, tags };
+}
+function splitMarkdownIntoBullets(body) {
+    const trimmed = body.trim();
+    if (!trimmed)
+        return [];
+    const lines = trimmed.split(/\r?\n/);
+    const bullets = [];
+    let current = [];
+    const bulletStart = /^\s*(?:[-*+]|\d+[.)])\s+/;
+    const flush = () => {
+        if (current.length === 0)
+            return;
+        const joined = current.join(' ').replace(/\s+/g, ' ').trim();
+        if (joined)
+            bullets.push(joined);
+        current = [];
+    };
+    for (const line of lines) {
+        if (bulletStart.test(line)) {
+            flush();
+            current.push(line.replace(bulletStart, ''));
+        }
+        else if (/^\s*#{1,6}\s+/.test(line)) {
+            flush();
+        }
+        else if (/^\s*$/.test(line)) {
+            flush();
+        }
+        else if (current.length > 0) {
+            current.push(line.trim());
+        }
+        else {
+            current.push(line.trim());
+        }
+    }
+    flush();
+    return bullets.length === 0 ? [trimmed.replace(/\s+/g, ' ').trim()] : bullets;
+}
+function buildMemoriesFromBody(absPath, body, extraTags, ctx) {
+    const bullets = splitMarkdownIntoBullets(body);
+    const relSource = toRelative(ctx.workspacePath, absPath);
+    let mtime = Date.now();
+    try {
+        mtime = fs.statSync(absPath).mtimeMs;
+    }
+    catch {
+    }
+    const out = [];
+    for (let i = 0; i < bullets.length && out.length < MEMORIES_PER_GROUP_MAX; i += 1) {
+        const sanitized = sanitizeMemoryText(bullets[i]);
+        if (!sanitized)
+            continue;
+        out.push({
+            id: memoryId(absPath, i),
+            scope: 'workspace_shared',
+            kind: 'rule',
+            text: sanitized,
+            source: relSource,
+            evidence: [{ kind: 'file', path: relSource }],
+            confidence: 'asserted',
+            createdAt: mtime,
+            updatedAt: mtime,
+            pinned: false,
+            tags: extraTags,
+            reviewState: 'user_edited',
+            status: 'active',
+        });
+    }
+    if (bullets.length > MEMORIES_PER_GROUP_MAX) {
+        ctx.warnings.push(`Capped ${relSource}: ${bullets.length - MEMORIES_PER_GROUP_MAX} additional rules ignored`);
+    }
+    return out;
+}
+function loadMarkdownRuleFile(absPath, groupLabel, loaderName, extraTags, ctx) {
+    const raw = readTextFileSafe(absPath, ctx);
+    if (raw == null)
+        return null;
+    const { text, tags } = stripFrontmatter(raw);
+    const items = buildMemoriesFromBody(absPath, text, [...extraTags, ...tags], ctx);
+    if (items.length === 0)
+        return null;
+    return {
+        id: `grp_${memoryId(absPath, 0)}`,
+        label: groupLabel,
+        source: toRelative(ctx.workspacePath, absPath),
+        loader: loaderName,
+        items,
+    };
+}
+function loadRuleDirectory(absDirPath, groupLabel, loaderName, fileExtensions, ctx) {
+    let entries;
+    try {
+        const stat = fs.statSync(absDirPath);
+        if (!stat.isDirectory())
+            return [];
+        entries = fs.readdirSync(absDirPath, { withFileTypes: true });
+    }
+    catch (error) {
+        const code = error.code;
+        if (code && code !== 'ENOENT' && code !== 'ENOTDIR') {
+            ctx.warnings.push(`Failed to scan ${toRelative(ctx.workspacePath, absDirPath)}: ${code}`);
+        }
+        return [];
+    }
+    const groups = [];
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (!entry.isFile())
+            continue;
+        if (!fileExtensions.some(ext => entry.name.toLowerCase().endsWith(ext)))
+            continue;
+        const group = loadMarkdownRuleFile(path.join(absDirPath, entry.name), `${groupLabel} - ${entry.name}`, loaderName, [], ctx);
+        if (group)
+            groups.push(group);
+    }
+    return groups;
+}
+function loadTurbofluxFactsJsonl(absPath, ctx) {
+    const raw = readTextFileSafe(absPath, ctx, FACTS_JSONL_BYTES_MAX);
+    if (raw == null)
+        return null;
+    const relSource = toRelative(ctx.workspacePath, absPath);
+    let mtime = Date.now();
+    try {
+        mtime = fs.statSync(absPath).mtimeMs;
+    }
+    catch {
+    }
+    const byId = new Map();
+    const lines = raw.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i].trim();
+        if (!line || line.startsWith('//') || line.startsWith('#'))
+            continue;
+        let parsed = null;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!parsed || typeof parsed.text !== 'string')
+            continue;
+        const sanitized = sanitizeMemoryText(parsed.text);
+        if (!sanitized)
+            continue;
+        const id = parsed.id || memoryId(absPath, i);
+        byId.set(id, {
+            id,
+            scope: parsed.scope || 'workspace_shared',
+            kind: parsed.kind || 'fact',
+            text: sanitized,
+            source: typeof parsed.source === 'string' ? parsed.source : relSource,
+            evidence: Array.isArray(parsed.evidence) && parsed.evidence.length > 0
+                ? parsed.evidence
+                : [{ kind: 'file', path: relSource }],
+            confidence: parsed.confidence || 'observed',
+            createdAt: typeof parsed.createdAt === 'number' ? parsed.createdAt : mtime,
+            updatedAt: typeof parsed.updatedAt === 'number' ? parsed.updatedAt : mtime,
+            pinned: parsed.pinned === true,
+            tags: Array.isArray(parsed.tags) ? parsed.tags.slice(0, 12) : [],
+            reviewState: parsed.reviewState || 'auto',
+            status: parsed.status || 'active',
+            supersededBy: typeof parsed.supersededBy === 'string' ? parsed.supersededBy : undefined,
+        });
+    }
+    const items = Array.from(byId.values())
+        .filter(m => m.status === 'active')
+        .slice(0, MEMORIES_PER_GROUP_MAX);
+    if (items.length === 0)
+        return null;
+    return {
+        id: `grp_${memoryId(absPath, 0)}`,
+        label: 'Project Facts',
+        source: relSource,
+        loader: 'turboflux_facts_jsonl',
+        items,
+    };
+}
+export function loadAllMemoryGroups(workspacePath) {
+    const ctx = { workspacePath, warnings: [] };
+    const groups = [];
+    const loadersAttempted = [];
+    loadersAttempted.push('turboflux_md');
+    for (const candidate of ['TURBOFLUX.md', 'turboflux.md', '.turboflux/TURBOFLUX.md']) {
+        const group = loadMarkdownRuleFile(path.join(workspacePath, candidate), 'Project Instructions', 'turboflux_md', ['turboflux', 'project'], ctx);
+        if (group) {
+            groups.push(group);
+            break;
+        }
+    }
+    loadersAttempted.push('turboflux_rules_md');
+    const turbofluxRules = loadMarkdownRuleFile(path.join(workspacePath, '.turboflux', 'memory', 'rules.md'), 'Project Rules', 'turboflux_rules_md', ['turboflux'], ctx);
+    if (turbofluxRules)
+        groups.push(turbofluxRules);
+    loadersAttempted.push('turboflux_facts_jsonl');
+    const turbofluxFacts = loadTurbofluxFactsJsonl(path.join(workspacePath, '.turboflux', 'memory', 'facts.jsonl'), ctx);
+    if (turbofluxFacts)
+        groups.push(turbofluxFacts);
+    loadersAttempted.push('claude_md');
+    for (const candidate of ['CLAUDE.md', 'claude.md', '.claude/CLAUDE.md', '.claude/claude.md']) {
+        const group = loadMarkdownRuleFile(path.join(workspacePath, candidate), `Claude Rules - ${candidate}`, 'claude_md', ['claude'], ctx);
+        if (group) {
+            groups.push(group);
+            break;
+        }
+    }
+    loadersAttempted.push('agents_md');
+    for (const candidate of ['AGENTS.md', 'agents.md']) {
+        const group = loadMarkdownRuleFile(path.join(workspacePath, candidate), `Agents Rules - ${candidate}`, 'agents_md', ['agents'], ctx);
+        if (group) {
+            groups.push(group);
+            break;
+        }
+    }
+    loadersAttempted.push('cursorrules');
+    const cursorLegacy = loadMarkdownRuleFile(path.join(workspacePath, '.cursorrules'), 'Cursor Rules', 'cursorrules', ['cursor'], ctx);
+    if (cursorLegacy)
+        groups.push(cursorLegacy);
+    loadersAttempted.push('cursor_rules_dir');
+    groups.push(...loadRuleDirectory(path.join(workspacePath, '.cursor', 'rules'), 'Cursor Rules', 'cursor_rules_dir', ['.md', '.mdc'], ctx));
+    loadersAttempted.push('windsurfrules');
+    const windsurfLegacy = loadMarkdownRuleFile(path.join(workspacePath, '.windsurfrules'), 'Windsurf Rules', 'windsurfrules', ['windsurf'], ctx);
+    if (windsurfLegacy)
+        groups.push(windsurfLegacy);
+    loadersAttempted.push('windsurf_rules_dir');
+    groups.push(...loadRuleDirectory(path.join(workspacePath, '.windsurf', 'rules'), 'Windsurf Rules', 'windsurf_rules_dir', ['.md'], ctx));
+    loadersAttempted.push('clinerules');
+    const cline = loadMarkdownRuleFile(path.join(workspacePath, '.clinerules'), 'Cline Rules', 'clinerules', ['cline'], ctx);
+    if (cline)
+        groups.push(cline);
+    return { groups, warnings: ctx.warnings, loadersAttempted };
+}
+//# sourceMappingURL=loaders.js.map

package/dist/tools/memory/loaders.js.map

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

package/dist/tools/memory/sanitizer.d.ts

@@ -0,0 +1,6 @@
+export declare const MEMORY_TEXT_MAX_LENGTH = 500;
+export declare const MEMORY_EVIDENCE_QUOTE_MAX_LENGTH = 200;
+export interface SanitizeOptions {
+    maxLength?: number;
+}
+export declare function sanitizeMemoryText(input: string, options?: SanitizeOptions): string;

package/dist/tools/memory/sanitizer.js

@@ -0,0 +1,48 @@
+const CONTROL_TOKEN_PATTERNS = [
+    /<\|im_start\|>/gi,
+    /<\|im_end\|>/gi,
+    /<\|begin_of_text\|>/gi,
+    /<\|end_of_text\|>/gi,
+    /<\|eot_id\|>/gi,
+    /<\|start_header_id\|>/gi,
+    /<\|end_header_id\|>/gi,
+    /<\|fim_(prefix|middle|suffix)\|>/gi,
+    /<\/?antml:[^>]+>/gi,
+    /<\/?anthropic[^>]*>/gi,
+    /<\/?human>/gi,
+    /<\/?assistant>/gi,
+    /<\/?thinking>/gi,
+    /\[INST\]/gi,
+    /\[\/INST\]/gi,
+    /<\|tool_call_(start|end)\|>/gi,
+    /<workspace_memory[^>]*>/gi,
+    /<\/workspace_memory>/gi,
+    /<\/?memory[^>]*>/gi,
+    /<\/?tool_retry_hint>/gi,
+    /<\/?evidence_policy>/gi,
+];
+const INVISIBLE_CODEPOINTS = /[\u200B-\u200F\u202A-\u202E\u2060-\u206F\uFEFF]/g;
+export const MEMORY_TEXT_MAX_LENGTH = 500;
+export const MEMORY_EVIDENCE_QUOTE_MAX_LENGTH = 200;
+export function sanitizeMemoryText(input, options) {
+    if (typeof input !== 'string')
+        return '';
+    let out = input;
+    out = out.replace(/\u001B\[[0-9;]*[A-Za-z]/g, '');
+    out = out.replace(INVISIBLE_CODEPOINTS, '');
+    for (const pattern of CONTROL_TOKEN_PATTERNS) {
+        out = out.replace(pattern, '');
+    }
+    out = out
+        .replace(/[ \t\f\v]+/g, ' ')
+        .replace(/\n{3,}/g, '\n\n')
+        .replace(/^[ \t]+/gm, '')
+        .replace(/[ \t]+$/gm, '')
+        .trim();
+    const limit = Math.max(1, options?.maxLength ?? MEMORY_TEXT_MAX_LENGTH);
+    if (out.length > limit) {
+        out = out.slice(0, limit - 1).trimEnd() + '…';
+    }
+    return out;
+}
+//# sourceMappingURL=sanitizer.js.map

package/dist/tools/memory/sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../../src/tools/memory/sanitizer.ts"],"names":[],"mappings":"AAkBA,MAAM,sBAAsB,GAAa;IAEvC,kBAAkB;IAClB,gBAAgB;IAChB,uBAAuB;IACvB,qBAAqB;IACrB,gBAAgB;IAChB,yBAAyB;IACzB,uBAAuB;IACvB,oCAAoC;IAGpC,oBAAoB;IACpB,uBAAuB;IACvB,cAAc;IACd,kBAAkB;IAClB,iBAAiB;IAGjB,YAAY;IACZ,cAAc;IAGd,+BAA+B;IAK/B,2BAA2B;IAC3B,wBAAwB;IACxB,oBAAoB;IACpB,wBAAwB;IACxB,wBAAwB;CACzB,CAAA;AAID,MAAM,oBAAoB,GAAG,kDAAkD,CAAA;AAI/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAA;AAGzC,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,CAAA;AAanD,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,OAAyB;IACzE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IACxC,IAAI,GAAG,GAAG,KAAK,CAAA;IAGf,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAA;IAGjD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;IAG3C,KAAK,MAAM,OAAO,IAAI,sBAAsB,EAAE,CAAC;QAC7C,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAChC,CAAC;IAKD,GAAG,GAAG,GAAG;SACN,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,IAAI,EAAE,CAAA;IAET,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,IAAI,sBAAsB,CAAC,CAAA;IACvE,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACvB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,GAAG,CAAA;IAC/C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/tools/memory/service.d.ts

@@ -0,0 +1,24 @@
+import type { Memory, MemoryQueryParams, MemorySnapshot, MemoryWriteRequest, MemoryWriteResponse, MemoryForgetRequest, MemoryForgetResponse, MemoryUpdateRequest, MemoryUpdateResponse } from '../../shared/memoryTypes';
+export declare class MemoryService {
+    private readonly cache;
+    private readonly writer;
+    constructor();
+    getSnapshot(workspacePath: string, options?: {
+        force?: boolean;
+    }): Promise<MemorySnapshot>;
+    invalidate(workspacePath: string): void;
+    query(params: MemoryQueryParams): Promise<Memory[]>;
+    getRelevantInjection(workspacePath: string, query: string, options?: {
+        tokenBudget?: number;
+        minScore?: number;
+        baselineRules?: number;
+    }): Promise<{
+        text: string;
+        tokens: number;
+        includedCount: number;
+        totalCount: number;
+    }>;
+    remember(request: MemoryWriteRequest): Promise<MemoryWriteResponse>;
+    forget(request: MemoryForgetRequest): Promise<MemoryForgetResponse>;
+    update(request: MemoryUpdateRequest): Promise<MemoryUpdateResponse>;
+}

package/dist/tools/memory/service.js

@@ -0,0 +1,273 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { loadAllMemoryGroups } from './loaders';
+import { MemoryWriter } from './writer';
+function approxTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+const MEMORY_INJECTION_TOKEN_BUDGET = 2000;
+const MEMORY_QUERY_TOKEN_BUDGET = 1000;
+const FINGERPRINT_PATHS = [
+    '.turboflux/memory/rules.md',
+    '.turboflux/memory/facts.jsonl',
+    'CLAUDE.md',
+    'claude.md',
+    '.claude/CLAUDE.md',
+    '.claude/claude.md',
+    'AGENTS.md',
+    'agents.md',
+    '.cursorrules',
+    '.windsurfrules',
+    '.clinerules',
+];
+const FINGERPRINT_DIRS = [
+    '.cursor/rules',
+    '.windsurf/rules',
+];
+function computeFingerprint(workspacePath) {
+    const parts = [];
+    for (const rel of FINGERPRINT_PATHS) {
+        const abs = path.join(workspacePath, rel);
+        try {
+            const stat = fs.statSync(abs);
+            parts.push(`${rel}:${stat.size}:${Math.floor(stat.mtimeMs)}`);
+        }
+        catch {
+            parts.push(`${rel}:absent`);
+        }
+    }
+    for (const rel of FINGERPRINT_DIRS) {
+        const abs = path.join(workspacePath, rel);
+        try {
+            const stat = fs.statSync(abs);
+            if (!stat.isDirectory()) {
+                parts.push(`${rel}:notdir`);
+                continue;
+            }
+            const entries = fs.readdirSync(abs, { withFileTypes: true })
+                .filter(d => d.isFile())
+                .map(d => d.name)
+                .sort();
+            const dirSig = entries
+                .map(name => {
+                try {
+                    const sub = fs.statSync(path.join(abs, name));
+                    return `${name}:${sub.size}:${Math.floor(sub.mtimeMs)}`;
+                }
+                catch {
+                    return `${name}:err`;
+                }
+            })
+                .join(',');
+            parts.push(`${rel}:[${dirSig}]`);
+        }
+        catch {
+            parts.push(`${rel}:absent`);
+        }
+    }
+    return parts.join('|');
+}
+function renderInjection(groups, budgetTokens) {
+    if (groups.length === 0)
+        return { text: '', tokens: 0 };
+    const header = 'Project memory from this workspace. Rules are hard constraints. If a user request contradicts a rule, surface the conflict.';
+    const lines = ['<workspace_memory>', header, ''];
+    let tokensUsed = approxTokens(lines.join('\n'));
+    let truncated = false;
+    for (const group of groups) {
+        if (truncated)
+            break;
+        const escapedSource = group.source.replace(/"/g, '&quot;');
+        const escapedLabel = group.label.replace(/"/g, '&quot;');
+        const groupOpen = `<group label="${escapedLabel}" source="${escapedSource}" loader="${group.loader}">`;
+        const groupClose = '</group>';
+        lines.push(groupOpen);
+        tokensUsed += approxTokens(groupOpen);
+        for (const item of group.items) {
+            const tag = getKindTag(item.kind);
+            const itemLine = `  - <${tag}>${item.text}</${tag}>`;
+            const cost = approxTokens(itemLine);
+            if (tokensUsed + cost > budgetTokens) {
+                lines.push('  - <truncated>additional items omitted for token budget</truncated>');
+                truncated = true;
+                break;
+            }
+            lines.push(itemLine);
+            tokensUsed += cost;
+        }
+        lines.push(groupClose);
+        tokensUsed += approxTokens(groupClose);
+    }
+    lines.push('</workspace_memory>');
+    tokensUsed += approxTokens('</workspace_memory>');
+    return { text: lines.join('\n'), tokens: tokensUsed };
+}
+function getKindTag(kind) {
+    switch (kind) {
+        case 'rule': return 'rule';
+        case 'fact': return 'fact';
+        case 'preference': return 'pref';
+        case 'strategy': return 'strategy';
+        case 'pitfall': return 'pitfall';
+        case 'workflow': return 'workflow';
+        case 'episode': return 'episode';
+        case 'todo': return 'todo';
+        case 'verdict': return 'verdict';
+        default: return 'memory';
+    }
+}
+function tokenizeMemoryText(text) {
+    if (!text)
+        return [];
+    return text
+        .toLowerCase()
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/[^a-z0-9_\u4e00-\u9fff]+/g, ' ')
+        .split(/\s+/)
+        .filter(t => t.length > 1);
+}
+function scoreItemAgainstQuery(itemText, queryTokens) {
+    if (queryTokens.size === 0)
+        return 1;
+    const itemTokens = new Set(tokenizeMemoryText(itemText));
+    if (itemTokens.size === 0)
+        return 0;
+    let overlap = 0;
+    for (const token of itemTokens) {
+        if (queryTokens.has(token))
+            overlap += 1;
+    }
+    return overlap / Math.sqrt(itemTokens.size);
+}
+export class MemoryService {
+    cache = new Map();
+    writer;
+    constructor() {
+        this.writer = new MemoryWriter();
+    }
+    async getSnapshot(workspacePath, options) {
+        const fingerprint = computeFingerprint(workspacePath);
+        const cached = this.cache.get(workspacePath);
+        if (!options?.force && cached && cached.fingerprint === fingerprint) {
+            return cached.snapshot;
+        }
+        const { groups, warnings, loadersAttempted } = loadAllMemoryGroups(workspacePath);
+        const totalCount = groups.reduce((sum, group) => sum + group.items.length, 0);
+        const { text, tokens } = renderInjection(groups, MEMORY_INJECTION_TOKEN_BUDGET);
+        const snapshot = {
+            workspacePath,
+            injectionText: text,
+            injectionTokens: tokens,
+            groups,
+            totalCount,
+            warnings,
+            loadersAttempted,
+            builtAt: Date.now(),
+        };
+        this.cache.set(workspacePath, { fingerprint, snapshot });
+        return snapshot;
+    }
+    invalidate(workspacePath) {
+        this.cache.delete(workspacePath);
+        this.writer.invalidate(workspacePath);
+    }
+    async query(params) {
+        const snapshot = await this.getSnapshot(params.workspacePath);
+        const { scope, kind, query, limit, includeStale } = params;
+        const cap = Math.min(Math.max(1, limit ?? 50), 200);
+        const queryTokens = new Set(tokenizeMemoryText(query || ''));
+        const scored = [];
+        let order = 0;
+        for (const group of snapshot.groups) {
+            for (const item of group.items) {
+                order += 1;
+                if (scope && item.scope !== scope)
+                    continue;
+                if (kind && item.kind !== kind)
+                    continue;
+                if (!includeStale && item.status !== 'active')
+                    continue;
+                const score = scoreItemAgainstQuery(item.text, queryTokens);
+                if (queryTokens.size > 0 && score <= 0)
+                    continue;
+                scored.push({ item, score, order });
+            }
+        }
+        return scored
+            .sort((a, b) => b.score - a.score || a.order - b.order)
+            .slice(0, cap)
+            .map(entry => entry.item);
+    }
+    async getRelevantInjection(workspacePath, query, options) {
+        const snapshot = await this.getSnapshot(workspacePath);
+        if (snapshot.groups.length === 0) {
+            return { text: '', tokens: 0, includedCount: 0, totalCount: 0 };
+        }
+        const budget = options?.tokenBudget ?? MEMORY_QUERY_TOKEN_BUDGET;
+        const minScore = options?.minScore ?? 0.15;
+        const baselineRules = options?.baselineRules ?? 5;
+        const queryTokens = new Set(tokenizeMemoryText(query));
+        const allItems = [];
+        for (const group of snapshot.groups) {
+            for (const item of group.items) {
+                if (item.status !== 'active')
+                    continue;
+                allItems.push({ group, item, score: scoreItemAgainstQuery(item.text, queryTokens) });
+            }
+        }
+        const baseline = allItems.slice(0, baselineRules);
+        const includedIds = new Set(baseline.map(entry => entry.item.id));
+        const orderedItems = [...baseline];
+        for (const scored of allItems
+            .slice(baselineRules)
+            .filter(entry => entry.score >= minScore)
+            .sort((a, b) => b.score - a.score)) {
+            if (includedIds.has(scored.item.id))
+                continue;
+            includedIds.add(scored.item.id);
+            orderedItems.push(scored);
+        }
+        const groupMap = new Map();
+        for (const scored of orderedItems) {
+            const key = scored.group.source;
+            const entry = groupMap.get(key) || { group: scored.group, items: [] };
+            entry.items.push(scored.item);
+            groupMap.set(key, entry);
+        }
+        const filteredGroups = Array.from(groupMap.values()).map(({ group, items }) => ({
+            ...group,
+            items,
+        }));
+        const { text, tokens } = renderInjection(filteredGroups, budget);
+        return {
+            text,
+            tokens,
+            includedCount: orderedItems.length,
+            totalCount: snapshot.totalCount,
+        };
+    }
+    async remember(request) {
+        const result = await this.writer.remember(request);
+        if (result.success) {
+            this.cache.delete(request.workspacePath);
+        }
+        return result;
+    }
+    async forget(request) {
+        const result = await this.writer.forget(request);
+        if (result.success) {
+            this.cache.delete(request.workspacePath);
+        }
+        return result;
+    }
+    async update(request) {
+        const result = await this.writer.update(request);
+        if (result.success) {
+            this.cache.delete(request.workspacePath);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=service.js.map