synabun 2026.3.307 → 2026.3.310

package/mcp-server/dist/tools/recall.js

@@ -0,0 +1,275 @@
+import { z } from 'zod';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { generateEmbedding } from '../services/local-embeddings.js';
+import { searchMemories, searchMemoriesFTS, updatePayload, searchSessionChunks } from '../services/sqlite.js';
+import { validateCategory } from '../services/categories.js';
+import { coerceStringArray } from './utils.js';
+import { config, detectProject } from '../config.js';
+import { text } from './response.js';
+export function buildRecallSchema() {
+    return {
+        query: z.string().describe('What to search for, in natural language.'),
+        category: z
+            .string()
+            .optional()
+            .describe('Optional: filter by category name.'),
+        project: z
+            .string()
+            .optional()
+            .describe('Optional: filter by project. If omitted, searches all projects but boosts current project.'),
+        tags: coerceStringArray()
+            .optional()
+            .describe('Optional: filter by tags (any match).'),
+        limit: z
+            .coerce.number()
+            .min(1)
+            .max(20)
+            .optional()
+            .describe('Number of results (default 5).'),
+        min_importance: z
+            .coerce.number()
+            .min(1)
+            .max(10)
+            .optional()
+            .describe('Minimum importance threshold.'),
+        min_score: z
+            .coerce.number()
+            .min(0)
+            .max(1)
+            .optional()
+            .describe('Minimum similarity score 0-1 (default 0.3).'),
+        include_sessions: z
+            .boolean()
+            .optional()
+            .describe('Override session chunk search. Auto-triggers on temporal queries or sparse results. Set true to force, false to disable.'),
+        recency_boost: z
+            .boolean()
+            .optional()
+            .describe('Prioritize recent memories. Shifts scoring to favor recency over semantic similarity (14-day half-life, 55% recency weight). Ideal for session-start boot queries.'),
+    };
+}
+export const recallSchema = buildRecallSchema();
+export const recallDescription = 'Search your persistent memory for relevant information. Use this at the start of any task to check what you already know, or when you need context about past decisions, known issues, or architectural patterns.';
+function applyTimeDecay(rawScore, createdAt, importance, accessCount, recencyBoost = false) {
+    const ageInDays = (Date.now() - new Date(createdAt).getTime()) / (1000 * 60 * 60 * 24);
+    const accessBoost = Math.min(0.1, accessCount * 0.01);
+    if (recencyBoost) {
+        // Recency-first scoring: 14-day half-life, recency dominates
+        const recencyMultiplier = Math.pow(0.5, ageInDays / 14);
+        return rawScore * 0.35 + recencyMultiplier * 0.55 + accessBoost;
+    }
+    // Default scoring: semantic similarity dominates, 90-day half-life
+    if (importance >= 8)
+        return rawScore;
+    const recencyMultiplier = Math.pow(0.5, ageInDays / 90);
+    return rawScore * 0.7 + recencyMultiplier * 0.2 + accessBoost;
+}
+function formatAge(isoDate) {
+    const diffMs = Date.now() - new Date(isoDate).getTime();
+    const days = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    if (days === 0)
+        return 'today';
+    if (days === 1)
+        return '1 day ago';
+    if (days < 30)
+        return `${days} days ago`;
+    const months = Math.floor(days / 30);
+    if (months === 1)
+        return '1 month ago';
+    return `${months} months ago`;
+}
+const RECALL_DEFAULTS = {
+    limit: 5,
+    minImportance: 0,
+    minScore: 0.3,
+    maxChars: 0,
+    includeSessions: 'auto',
+    recencyBoost: false,
+};
+function getRecallDefaults() {
+    try {
+        const settingsPath = path.resolve(config.dataDir, 'display-settings.json');
+        const data = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        const d = data.recallDefaults;
+        if (!d) {
+            // Legacy: only recallMaxChars exists
+            return { ...RECALL_DEFAULTS, maxChars: data.recallMaxChars ?? 0 };
+        }
+        return {
+            limit: d.limit ?? RECALL_DEFAULTS.limit,
+            minImportance: d.minImportance ?? RECALL_DEFAULTS.minImportance,
+            minScore: d.minScore ?? RECALL_DEFAULTS.minScore,
+            maxChars: d.maxChars ?? RECALL_DEFAULTS.maxChars,
+            includeSessions: d.includeSessions ?? RECALL_DEFAULTS.includeSessions,
+            recencyBoost: d.recencyBoost ?? RECALL_DEFAULTS.recencyBoost,
+        };
+    }
+    catch {
+        return { ...RECALL_DEFAULTS };
+    }
+}
+export async function handleRecall(args) {
+    const defaults = getRecallDefaults();
+    const query = args.query;
+    const category = args.category;
+    const project = args.project;
+    const tags = args.tags;
+    const limit = args.limit ?? defaults.limit;
+    const minImportance = args.min_importance ?? (defaults.minImportance > 0 ? defaults.minImportance : undefined);
+    const minScore = args.min_score ?? defaults.minScore;
+    const includeSessionsExplicit = args.include_sessions ??
+        (defaults.includeSessions === 'always' ? true : defaults.includeSessions === 'never' ? false : undefined);
+    const recencyBoost = args.recency_boost ?? defaults.recencyBoost;
+    if (category) {
+        const catCheck = validateCategory(category);
+        if (!catCheck.valid) {
+            return text(catCheck.error);
+        }
+    }
+    const vector = await generateEmbedding(query);
+    const must = [];
+    if (category)
+        must.push({ key: 'category', match: { value: category } });
+    if (project)
+        must.push({ key: 'project', match: { value: project } });
+    if (tags && tags.length > 0) {
+        for (const tag of tags) {
+            must.push({ key: 'tags', match: { value: tag } });
+        }
+    }
+    if (minImportance) {
+        must.push({ key: 'importance', range: { gte: minImportance } });
+    }
+    const filter = must.length > 0 ? { must } : undefined;
+    // Use a lower raw threshold for the DB query — time decay, importance,
+    // and project boosts can lift borderline results well above minScore.
+    // The actual minScore filter is applied after adjustments below.
+    const rawThreshold = Math.min(minScore, minScore * 0.5);
+    const results = await searchMemories(vector, limit * 2, filter, rawThreshold);
+    const currentProject = detectProject();
+    const scored = results
+        .map((r) => {
+        const payload = r.payload;
+        let adjustedScore = applyTimeDecay(r.score, payload.created_at, payload.importance, payload.access_count, recencyBoost);
+        if (!project && payload.project === currentProject) {
+            adjustedScore *= 1.2;
+        }
+        return { id: r.id, score: adjustedScore, payload };
+    })
+        .filter((r) => r.score >= minScore)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+    // FTS5 keyword fallback — when vector results are weak, supplement with
+    // full-text search to catch exact identifiers, error codes, proper nouns
+    const FTS_TRIGGER_SCORE = 0.45;
+    const vectorWeak = scored.length === 0 ||
+        (scored.length < limit && scored[0]?.score < FTS_TRIGGER_SCORE);
+    if (vectorWeak) {
+        try {
+            const existingIds = new Set(scored.map(r => r.id));
+            const ftsResults = await searchMemoriesFTS(query, limit, filter, existingIds);
+            for (const fts of ftsResults) {
+                if (scored.length >= limit)
+                    break;
+                scored.push(fts);
+            }
+            // Re-sort after merge
+            scored.sort((a, b) => b.score - a.score);
+        }
+        catch {
+            // FTS fallback failure is non-fatal
+        }
+    }
+    // Update access tracking (fire-and-forget)
+    const now = new Date().toISOString();
+    for (const result of scored) {
+        updatePayload(result.id, {
+            accessed_at: now,
+            access_count: result.payload.access_count + 1,
+        }).catch(() => { });
+    }
+    if (scored.length === 0) {
+        return text(`No memories found for "${query}"${category ? ` in category ${category}` : ''}${project ? ` for project ${project}` : ''}.`);
+    }
+    const maxChars = defaults.maxChars;
+    const lines = scored.map((r, i) => {
+        const p = r.payload;
+        const score = (r.score * 100).toFixed(0);
+        const tagStr = p.tags?.length ? ` [${p.tags.join(', ')}]` : '';
+        const sub = p.subcategory ? `/${p.subcategory}` : '';
+        const files = p.related_files?.length
+            ? `\n   Files: ${p.related_files.join(', ')}`
+            : '';
+        const displayContent = (maxChars > 0 && p.content.length > maxChars)
+            ? p.content.substring(0, maxChars) + '...'
+            : p.content;
+        return `${i + 1}. [${r.id}] (${score}% match, importance: ${p.importance}, ${formatAge(p.created_at)})\n   ${p.category}${sub} | ${p.project}${tagStr}\n   ${displayContent}${files}`;
+    });
+    // Session chunk search — auto-trigger when useful, or explicit override
+    const shouldIncludeSessions = (() => {
+        // Explicit override takes priority
+        if (includeSessionsExplicit !== undefined)
+            return includeSessionsExplicit;
+        // Temporal/process keywords → likely asking about past sessions
+        const q = query.toLowerCase();
+        const sessionKeywords = [
+            'yesterday', 'last session', 'last time', 'remember when',
+            'how did we', 'what did we', 'earlier today', 'previous session',
+            'conversation about', 'we discussed', 'we worked on', 'we talked about',
+            'that session', 'that conversation', 'the other day', 'last week',
+            'before', 'recently', 'a while ago', 'few days ago',
+        ];
+        if (sessionKeywords.some(kw => q.includes(kw)))
+            return true;
+        // Sparse/weak memory results → widen the net
+        if (scored.length < 3)
+            return true;
+        if (scored.length > 0 && scored[0].score < 0.45)
+            return true;
+        return false;
+    })();
+    let sessionLines = [];
+    if (shouldIncludeSessions) {
+        try {
+            const sessionFilter = {};
+            if (project) {
+                sessionFilter.must = [{ key: 'project', match: { value: project } }];
+            }
+            const sessionLimit = Math.max(3, Math.floor(limit / 2));
+            const sessionResults = await searchSessionChunks(vector, sessionLimit * 2, Object.keys(sessionFilter).length > 0 ? sessionFilter : undefined, rawThreshold);
+            // Deduplicate: skip chunks whose dedup_memory_id matches a returned memory
+            const memoryIds = new Set(scored.map((r) => r.id));
+            const filteredSessions = sessionResults.filter((r) => {
+                const payload = r.payload;
+                return !payload.dedup_memory_id || !memoryIds.has(payload.dedup_memory_id);
+            }).slice(0, sessionLimit);
+            sessionLines = filteredSessions.map((r, i) => {
+                const p = r.payload;
+                const score = (r.score * 100).toFixed(0);
+                const timeRange = p.start_timestamp && p.end_timestamp
+                    ? `${new Date(p.start_timestamp).toISOString().slice(0, 16)} - ${new Date(p.end_timestamp).toISOString().slice(11, 16)}`
+                    : 'unknown time';
+                const toolStr = p.tools_used?.length ? `Tools: ${p.tools_used.join(', ')}` : '';
+                const fileStr = p.files_modified?.length ? `Files: ${p.files_modified.join(', ')}` : '';
+                const linkedMems = p.related_memory_ids?.length ? `Linked memories: ${p.related_memory_ids.join(', ')}` : '';
+                const details = [toolStr, fileStr, linkedMems].filter(Boolean).join(' | ');
+                return `SESSION: [${r.id}] (${score}% match, ${timeRange}, branch: ${p.git_branch || 'unknown'})\n   Session: ${p.session_id} | Chunk ${p.chunk_index + 1} | ${p.project}\n   ${p.summary}\n   ${details}`;
+            });
+        }
+        catch {
+            // Session search failure is non-fatal
+        }
+    }
+    const allLines = [...lines];
+    if (sessionLines.length > 0) {
+        allLines.push('', '--- Session Context ---');
+        allLines.push(...sessionLines);
+    }
+    const totalCount = scored.length + sessionLines.length;
+    const label = sessionLines.length > 0
+        ? `Found ${scored.length} memories and ${sessionLines.length} session chunks`
+        : `Found ${scored.length} memories`;
+    return text(`${label} for "${query}":\n\n${allLines.join('\n\n')}`);
+}
+//# sourceMappingURL=recall.js.map

package/mcp-server/dist/tools/recall.js.map

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

package/mcp-server/dist/tools/reflect.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+export declare function buildReflectSchema(): {
+    memory_id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    add_tags: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    subcategory: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    related_files: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    related_memory_ids: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    project: z.ZodOptional<z.ZodString>;
+};
+export declare const reflectSchema: {
+    memory_id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    add_tags: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    subcategory: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    related_files: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    related_memory_ids: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    project: z.ZodOptional<z.ZodString>;
+};
+export declare const reflectDescription = "Update or annotate an existing memory. Use this when you discover additional context, when a decision changes, or when you want to adjust importance based on new information.";
+export declare function handleReflect(args: {
+    memory_id: string;
+    content?: string;
+    importance?: number;
+    tags?: string[];
+    add_tags?: string[];
+    subcategory?: string;
+    category?: string;
+    related_files?: string[];
+    related_memory_ids?: string[];
+    project?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=reflect.d.ts.map

package/mcp-server/dist/tools/reflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.d.ts","sourceRoot":"","sources":["../../src/tools/reflect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,wBAAgB,kBAAkB;;;;;;;;;;;EA6BjC;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;CAAuB,CAAC;AAElD,eAAO,MAAM,kBAAkB,mLACmJ,CAAC;AAEnL,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;;;;;GAuFA"}

package/mcp-server/dist/tools/reflect.js

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+import { getMemory, updatePayload, updateVector } from '../services/sqlite.js';
+import { generateEmbedding } from '../services/local-embeddings.js';
+import { validateCategory } from '../services/categories.js';
+import { coerceStringArray } from './utils.js';
+import { invalidateCache } from '../services/neural-interface.js';
+import { computeChecksums } from '../services/file-checksums.js';
+import { text } from './response.js';
+export function buildReflectSchema() {
+    return {
+        memory_id: z.string().describe('The ID of the memory to update. MUST be the full UUID format (e.g., 8f7cab3b-644e-4cea-8662-de0ca695bdf2), not a shortened version. Use recall to get the full UUID.'),
+        content: z
+            .string()
+            .optional()
+            .describe('Updated content. If provided, the embedding vector is regenerated.'),
+        importance: z.coerce.number().min(1).max(10).optional().describe('Updated importance score.'),
+        tags: coerceStringArray()
+            .optional()
+            .describe('Replace all tags with these.'),
+        add_tags: coerceStringArray()
+            .optional()
+            .describe('Add tags without replacing existing ones.'),
+        subcategory: z.string().optional().describe('Updated subcategory.'),
+        category: z
+            .string()
+            .optional()
+            .describe('Change the category name.'),
+        related_files: coerceStringArray()
+            .optional()
+            .describe('Updated related file paths.'),
+        related_memory_ids: coerceStringArray()
+            .optional()
+            .describe('Link to related memories.'),
+        project: z.string().optional().describe('Change the project this memory belongs to (e.g. "criticalpixel", "synabun", "synabun-website").'),
+    };
+}
+export const reflectSchema = buildReflectSchema();
+export const reflectDescription = 'Update or annotate an existing memory. Use this when you discover additional context, when a decision changes, or when you want to adjust importance based on new information.';
+export async function handleReflect(args) {
+    const memoryId = args.memory_id;
+    // Validate UUID format
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (!uuidRegex.test(memoryId)) {
+        return text(`Invalid memory_id format. Expected full UUID (e.g., 8f7cab3b-644e-4cea-8662-de0ca695bdf2), got: ${memoryId}\n\nUse the full UUID returned by 'remember', or call 'recall' to find the full UUID of an existing memory.`);
+    }
+    if (args.category) {
+        const catCheck = validateCategory(args.category);
+        if (!catCheck.valid) {
+            return text(catCheck.error);
+        }
+    }
+    const existing = await getMemory(memoryId);
+    if (!existing) {
+        return text(`Memory "${memoryId}" not found.`);
+    }
+    const payload = existing.payload;
+    const now = new Date().toISOString();
+    const updates = { updated_at: now };
+    const changes = [];
+    if (args.content) {
+        updates.content = args.content;
+        changes.push('content');
+    }
+    if (args.importance !== undefined) {
+        updates.importance = args.importance;
+        changes.push(`importance -> ${args.importance}`);
+    }
+    if (args.category) {
+        updates.category = args.category;
+        changes.push(`category -> ${args.category}`);
+    }
+    if (args.subcategory) {
+        updates.subcategory = args.subcategory;
+        changes.push(`subcategory -> ${args.subcategory}`);
+    }
+    if (args.tags) {
+        updates.tags = args.tags;
+        changes.push(`tags replaced`);
+    }
+    if (args.add_tags) {
+        const existingTags = payload.tags || [];
+        updates.tags = [...new Set([...existingTags, ...args.add_tags])];
+        changes.push(`tags added: ${args.add_tags.join(', ')}`);
+    }
+    if (args.related_files) {
+        updates.related_files = args.related_files;
+        changes.push('related_files updated');
+    }
+    if (args.related_memory_ids) {
+        updates.related_memory_ids = args.related_memory_ids;
+        changes.push('related_memory_ids updated');
+    }
+    if (args.project) {
+        updates.project = args.project;
+        changes.push(`project -> ${args.project}`);
+    }
+    if (changes.length === 0) {
+        return text('No changes specified.');
+    }
+    // Recompute file checksums whenever the memory is updated
+    const finalFiles = (updates.related_files ?? payload.related_files);
+    if (finalFiles?.length) {
+        const cs = computeChecksums(finalFiles);
+        updates.file_checksums = Object.keys(cs).length > 0 ? cs : undefined;
+    }
+    if (args.content) {
+        const mergedPayload = { ...payload, ...updates };
+        const vector = await generateEmbedding(mergedPayload.content);
+        await updateVector(memoryId, vector, mergedPayload);
+    }
+    else {
+        await updatePayload(memoryId, updates);
+    }
+    // Invalidate Neural Interface link cache (fire-and-forget)
+    invalidateCache('reflect');
+    return text(`Updated [${memoryId.slice(0, 8)}]: ${changes.join(', ')}`);
+}
+//# sourceMappingURL=reflect.js.map

package/mcp-server/dist/tools/reflect.js.map

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

package/mcp-server/dist/tools/remember.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export declare function buildRememberSchema(): {
+    content: z.ZodString;
+    category: z.ZodString;
+    project: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    subcategory: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<["user-told", "self-discovered", "auto-saved"]>>;
+    related_files: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+};
+export declare const rememberSchema: {
+    content: z.ZodString;
+    category: z.ZodString;
+    project: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    subcategory: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<["user-told", "self-discovered", "auto-saved"]>>;
+    related_files: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
+};
+export declare const rememberDescription = "Store a piece of information in persistent memory. Use this when you learn something important, make a decision, discover a pattern, fix a hard bug, or want to preserve context for future sessions.";
+export declare function handleRemember(args: {
+    content: string;
+    category: string;
+    project?: string;
+    tags?: string[];
+    importance?: number;
+    subcategory?: string;
+    source?: string;
+    related_files?: string[];
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=remember.d.ts.map

package/mcp-server/dist/tools/remember.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.d.ts","sourceRoot":"","sources":["../../src/tools/remember.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,wBAAgB,mBAAmB;;;;;;;;;EAyClC;AAED,eAAO,MAAM,cAAc;;;;;;;;;CAAwB,CAAC;AAEpD,eAAO,MAAM,mBAAmB,0MACyK,CAAC;AAE1M,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;;;;;GA6CA"}

package/mcp-server/dist/tools/remember.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { v4 as uuidv4 } from 'uuid';
+import { generateEmbedding } from '../services/local-embeddings.js';
+import { upsertMemory } from '../services/sqlite.js';
+import { validateCategory } from '../services/categories.js';
+import { coerceStringArray } from './utils.js';
+import { detectProject } from '../config.js';
+import { computeChecksums } from '../services/file-checksums.js';
+import { invalidateCache } from '../services/neural-interface.js';
+import { text } from './response.js';
+export function buildRememberSchema() {
+    return {
+        content: z
+            .string()
+            .describe('The information to remember. Be specific and include context.'),
+        category: z
+            .string()
+            .describe('Category name. Call category tool with action "list" to see valid categories.'),
+        project: z
+            .string()
+            .optional()
+            .describe('Project this belongs to (e.g. "criticalpixel"). Defaults to auto-detected from working directory.'),
+        tags: coerceStringArray()
+            .optional()
+            .describe('Tags for categorization (e.g. ["redis", "cache", "pricing"])'),
+        importance: z
+            .coerce.number()
+            .min(1)
+            .max(10)
+            .optional()
+            .describe('1=trivial, 5=normal, 7=significant, 8+=critical. Default 5. Use 8+ for hard-won bug fixes and architecture decisions.'),
+        subcategory: z
+            .string()
+            .optional()
+            .describe('Optional refinement: architecture, bug-fix, api-quirk, performance, config, deployment, etc.'),
+        source: z
+            .enum(['user-told', 'self-discovered', 'auto-saved'])
+            .optional()
+            .describe('How this was learned. user-told=user explicitly shared, self-discovered=found during work, auto-saved=session context.'),
+        related_files: coerceStringArray()
+            .optional()
+            .describe('File paths this memory relates to.'),
+    };
+}
+export const rememberSchema = buildRememberSchema();
+export const rememberDescription = 'Store a piece of information in persistent memory. Use this when you learn something important, make a decision, discover a pattern, fix a hard bug, or want to preserve context for future sessions.';
+export async function handleRemember(args) {
+    const catCheck = validateCategory(args.category);
+    if (!catCheck.valid) {
+        return text(catCheck.error);
+    }
+    const content = args.content;
+    const category = args.category;
+    const project = args.project || detectProject();
+    const tags = args.tags || [];
+    const importance = args.importance ?? 5;
+    const subcategory = args.subcategory;
+    const source = args.source || 'self-discovered';
+    const related_files = args.related_files;
+    const id = uuidv4();
+    const now = new Date().toISOString();
+    const payload = {
+        content,
+        category,
+        subcategory,
+        project,
+        tags,
+        importance,
+        source,
+        created_at: now,
+        updated_at: now,
+        accessed_at: now,
+        access_count: 0,
+        related_files,
+        file_checksums: (() => {
+            if (!related_files?.length)
+                return undefined;
+            const cs = computeChecksums(related_files);
+            return Object.keys(cs).length > 0 ? cs : undefined;
+        })(),
+    };
+    const vector = await generateEmbedding(content);
+    await upsertMemory(id, vector, payload);
+    // Invalidate Neural Interface link cache (fire-and-forget)
+    invalidateCache('remember');
+    return text(`Remembered [${id}] (${category}/${project}, importance: ${importance}): "${content.slice(0, 100)}${content.length > 100 ? '...' : ''}"`);
+}
+//# sourceMappingURL=remember.js.map

package/mcp-server/dist/tools/remember.js.map

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

package/mcp-server/dist/tools/response.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP response helpers — eliminates verbose response object boilerplate.
+ * Inspired by FastMCP's approach of letting tools return simple values.
+ *
+ * Before:  return { content: [{ type: 'text' as const, text: msg }] };
+ * After:   return text(msg);
+ */
+/** Wrap a string in the MCP text response format. */
+export declare function text(msg: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/** Wrap base64 image data in the MCP image response format. */
+export declare function image(data: string, mimeType: string): {
+    content: {
+        type: "image";
+        data: string;
+        mimeType: string;
+    }[];
+};
+//# sourceMappingURL=response.d.ts.map

package/mcp-server/dist/tools/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/tools/response.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,qDAAqD;AACrD,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM;;;;;EAE/B;AAED,+DAA+D;AAC/D,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;;;;;EAEnD"}