@whenmoon-afk/memory-mcp 2.0.0

package/dist/scoring/importance.js

@@ -0,0 +1,150 @@
+/**
+ * Importance scoring system for memories
+ */
+import { calculateComplexity, isUserPreference, isExplicit } from '../extractors/fact-extractor.js';
+/**
+ * Calculate importance score automatically (0-10)
+ */
+export function calculateImportance(content, type, entities, metadata, hasProvenance) {
+    const factors = analyzeImportanceFactors(content, type, entities, metadata, hasProvenance);
+    return calculateImportanceFromFactors(factors);
+}
+/**
+ * Analyze factors that contribute to importance
+ */
+export function analyzeImportanceFactors(content, type, entities, metadata, hasProvenance) {
+    return {
+        contentComplexity: calculateComplexity(content),
+        entityCount: entities.length,
+        isUserPreference: isUserPreference(content),
+        hasProvenance,
+        hasMetadata: Object.keys(metadata).length > 0,
+        isExplicit: isExplicit(content),
+        typeBonus: calculateTypeBonus(type),
+    };
+}
+/**
+ * Calculate importance from analyzed factors
+ */
+export function calculateImportanceFromFactors(factors) {
+    // Start with baseline
+    let score = 3.0;
+    // Content complexity (0-3 points)
+    score += factors.contentComplexity * 3;
+    // Entity connections (0-2 points, max out at 4 entities)
+    score += Math.min(factors.entityCount * 0.5, 2.0);
+    // User preference boost (0 or 2 points)
+    if (factors.isUserPreference) {
+        score += 2.0;
+    }
+    // Provenance tracking (0 or 0.5 points)
+    if (factors.hasProvenance) {
+        score += 0.5;
+    }
+    // Rich metadata (0 or 0.5 points)
+    if (factors.hasMetadata) {
+        score += 0.5;
+    }
+    // Explicit facts are more trustworthy (0 or 1 point)
+    if (factors.isExplicit) {
+        score += 1.0;
+    }
+    // Type-specific bonus
+    score += factors.typeBonus;
+    // Clamp to 0-10 range
+    return Math.max(0, Math.min(10, Math.round(score * 10) / 10));
+}
+/**
+ * Calculate type-specific importance bonus
+ */
+function calculateTypeBonus(type) {
+    switch (type) {
+        case 'relationship':
+            return 1.0; // Relationships connect knowledge
+        case 'entity':
+            return 0.5; // Entities are moderately important
+        case 'fact':
+            return 0.0; // Facts use default importance
+        default:
+            return 0.0;
+    }
+}
+/**
+ * Adjust importance based on context signals
+ */
+export function adjustImportanceForContext(baseImportance, signals) {
+    let adjusted = baseImportance;
+    // Security-sensitive: max importance
+    if (signals.isSecuritySensitive) {
+        adjusted = Math.max(adjusted, 10);
+    }
+    // User identity: very high importance
+    if (signals.isUserIdentity) {
+        adjusted = Math.max(adjusted, 9);
+    }
+    // Project requirement: high importance
+    if (signals.isProjectRequirement) {
+        adjusted = Math.max(adjusted, 7);
+    }
+    // Deprecated: low importance
+    if (signals.isDeprecated) {
+        adjusted = Math.min(adjusted, 2);
+    }
+    // User explicitly marked: boost by 2 points
+    if (signals.userExplicitlyMarked) {
+        adjusted += 2;
+    }
+    return Math.max(0, Math.min(10, adjusted));
+}
+/**
+ * Get recommended TTL for importance level
+ */
+export function getRecommendedTTL(importance) {
+    if (importance >= 10)
+        return null; // Permanent
+    if (importance >= 8)
+        return 365; // 1 year
+    if (importance >= 6)
+        return 180; // 6 months
+    if (importance >= 4)
+        return 90; // 3 months
+    if (importance >= 2)
+        return 30; // 1 month
+    return 7; // 1 week
+}
+/**
+ * Calculate effective importance (with decay over time)
+ */
+export function calculateEffectiveImportance(baseImportance, lastAccessed, now) {
+    const daysSinceAccess = (now - lastAccessed) / (1000 * 60 * 60 * 24);
+    if (baseImportance < 6) {
+        // Low-importance memories decay faster (1% per day)
+        const decayRate = 0.01;
+        const decayFactor = 1 - daysSinceAccess * decayRate * 2;
+        return baseImportance * Math.max(decayFactor, 0.5);
+    }
+    else {
+        // High-importance memories resist decay (0.5% per day)
+        const decayRate = 0.005;
+        const decayFactor = 1 - daysSinceAccess * decayRate;
+        return baseImportance * Math.max(decayFactor, 0.8);
+    }
+}
+/**
+ * Boost importance on repeated access
+ */
+export function boostImportanceOnAccess(currentImportance, accessCount, daysSinceCreated) {
+    // If accessed multiple times in short period, boost importance
+    const accessRate = accessCount / Math.max(daysSinceCreated, 1);
+    if (accessRate > 0.1) {
+        // Accessed frequently (>10% of days)
+        return Math.min(currentImportance + 1, 10);
+    }
+    else if (accessRate > 0.05) {
+        // Accessed moderately (>5% of days)
+        return Math.min(currentImportance + 0.5, 10);
+    }
+    // No boost
+    return currentImportance;
+}
+//# sourceMappingURL=importance.js.map

package/dist/scoring/importance.js.map

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

package/dist/scoring/ttl-manager.d.ts

@@ -0,0 +1,33 @@
+/**
+ * TTL (Time-To-Live) management for memories
+ */
+import type { TTLConfig } from '../types/index.js';
+/**
+ * Default TTL configuration
+ */
+export declare const DEFAULT_TTL_CONFIG: TTLConfig;
+/**
+ * Calculate TTL in days based on importance
+ */
+export declare function calculateTTLDays(importance: number, config?: TTLConfig): number | null;
+/**
+ * Calculate expiration timestamp
+ */
+export declare function calculateExpiresAt(ttlDays: number | null, importance: number, createdAt?: number): number | null;
+/**
+ * Check if memory should be refreshed on access
+ */
+export declare function shouldRefreshTTL(importance: number, lastAccessed: number, now?: number, config?: TTLConfig): boolean;
+/**
+ * Calculate new TTL on access (refresh)
+ */
+export declare function refreshTTL(originalTTLDays: number | null, importance: number, lastAccessed: number, now?: number, config?: TTLConfig): number | null;
+/**
+ * Check if memory is expired
+ */
+export declare function isExpired(expiresAt: number | null, now?: number): boolean;
+/**
+ * Calculate time until expiration
+ */
+export declare function getTimeUntilExpiration(expiresAt: number | null, now?: number): number | null;
+//# sourceMappingURL=ttl-manager.d.ts.map

package/dist/scoring/ttl-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl-manager.d.ts","sourceRoot":"","sources":["../../src/scoring/ttl-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAKhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,SAA8B,GAAG,MAAM,GAAG,IAAI,CAa1G;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAmB,GAC7B,MAAM,GAAG,IAAI,CAWf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,MAAmB,EACxB,MAAM,GAAE,SAA8B,GACrC,OAAO,CAeT;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,MAAmB,EACxB,MAAM,GAAE,SAA8B,GACrC,MAAM,GAAG,IAAI,CAwBf;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAMrF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,IAAI,CAOxG"}

package/dist/scoring/ttl-manager.js

@@ -0,0 +1,99 @@
+/**
+ * TTL (Time-To-Live) management for memories
+ */
+import { getRecommendedTTL } from './importance.js';
+/**
+ * Default TTL configuration
+ */
+export const DEFAULT_TTL_CONFIG = {
+    defaultDays: 90,
+    importanceMultiplier: 0.7, // Multiply base TTL by this factor based on importance
+    accessBonusDays: 30, // Bonus days added on access for important memories
+    refreshThresholdDays: 7, // Minimum days since last access before refresh
+};
+/**
+ * Calculate TTL in days based on importance
+ */
+export function calculateTTLDays(importance, config = DEFAULT_TTL_CONFIG) {
+    // Use recommended TTL from importance tier
+    const recommended = getRecommendedTTL(importance);
+    if (recommended === null) {
+        return null; // Permanent
+    }
+    // Apply importance multiplier to base TTL
+    const importanceFactor = (importance / 10) * config.importanceMultiplier;
+    const adjusted = Math.round(recommended * (1 + importanceFactor));
+    return Math.max(1, adjusted);
+}
+/**
+ * Calculate expiration timestamp
+ */
+export function calculateExpiresAt(ttlDays, importance, createdAt = Date.now()) {
+    if (ttlDays === null) {
+        return null; // Permanent memory
+    }
+    const baseTTL = ttlDays * 24 * 60 * 60 * 1000;
+    // Add importance bonus (up to 7 extra days for importance 10)
+    const importanceBonus = (importance / 10) * 7 * 24 * 60 * 60 * 1000;
+    return createdAt + baseTTL + importanceBonus;
+}
+/**
+ * Check if memory should be refreshed on access
+ */
+export function shouldRefreshTTL(importance, lastAccessed, now = Date.now(), config = DEFAULT_TTL_CONFIG) {
+    const daysSinceAccess = (now - lastAccessed) / (1000 * 60 * 60 * 24);
+    // Important memories (>=6): refresh if accessed after 7+ days
+    if (importance >= 6 && daysSinceAccess > config.refreshThresholdDays) {
+        return true;
+    }
+    // Moderately important (4-5): refresh if accessed after 30+ days
+    if (importance >= 4 && daysSinceAccess > 30) {
+        return true;
+    }
+    // Low importance (1-3): don't refresh, let it expire
+    return false;
+}
+/**
+ * Calculate new TTL on access (refresh)
+ */
+export function refreshTTL(originalTTLDays, importance, lastAccessed, now = Date.now(), config = DEFAULT_TTL_CONFIG) {
+    if (originalTTLDays === null) {
+        return null; // Permanent memory, no refresh needed
+    }
+    if (!shouldRefreshTTL(importance, lastAccessed, now, config)) {
+        return null; // No refresh
+    }
+    // Calculate access bonus
+    const accessBonus = (importance / 10) * config.accessBonusDays * 24 * 60 * 60 * 1000;
+    // Base TTL + access bonus
+    const baseTTL = originalTTLDays * 24 * 60 * 60 * 1000;
+    if (importance >= 6) {
+        // Important memories: full refresh + bonus
+        return now + baseTTL + accessBonus;
+    }
+    else if (importance >= 4) {
+        // Moderately important: refresh + half bonus
+        return now + baseTTL + accessBonus / 2;
+    }
+    return null;
+}
+/**
+ * Check if memory is expired
+ */
+export function isExpired(expiresAt, now = Date.now()) {
+    if (expiresAt === null) {
+        return false; // Permanent memory never expires
+    }
+    return expiresAt <= now;
+}
+/**
+ * Calculate time until expiration
+ */
+export function getTimeUntilExpiration(expiresAt, now = Date.now()) {
+    if (expiresAt === null) {
+        return null; // Permanent memory
+    }
+    const timeLeft = expiresAt - now;
+    return Math.max(0, timeLeft);
+}
+//# sourceMappingURL=ttl-manager.js.map

package/dist/scoring/ttl-manager.js.map

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

package/dist/search/semantic-search.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Full-text search implementation using SQLite FTS5
+ * Replaces vector embeddings with lightweight keyword/phrase matching
+ */
+import type Database from 'better-sqlite3';
+import type { MemorySearchResult, SearchOptionsInternal } from '../types/index.js';
+/**
+ * Perform full-text search on memories using FTS5
+ * Returns: { results: MemorySearchResult[], totalCount: number }
+ */
+export declare function semanticSearch(db: Database.Database, options: SearchOptionsInternal): {
+    results: MemorySearchResult[];
+    totalCount: number;
+};
+//# sourceMappingURL=semantic-search.d.ts.map

package/dist/search/semantic-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search.d.ts","sourceRoot":"","sources":["../../src/search/semantic-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAEV,kBAAkB,EAClB,qBAAqB,EAKtB,MAAM,mBAAmB,CAAC;AA2B3B;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,qBAAqB,GAC7B;IAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAmDvD"}

package/dist/search/semantic-search.js

@@ -0,0 +1,236 @@
+/**
+ * Full-text search implementation using SQLite FTS5
+ * Replaces vector embeddings with lightweight keyword/phrase matching
+ */
+import { deserializeMetadata } from '../database/connection.js';
+/**
+ * Perform full-text search on memories using FTS5
+ * Returns: { results: MemorySearchResult[], totalCount: number }
+ */
+export function semanticSearch(db, options) {
+    const { query, type, entities, limit = 10, offset = 0, minImportance, includeExpired = false, } = options;
+    // Build FTS5 query (use simple keyword matching)
+    // FTS5 syntax: "phrase search" OR keyword1 keyword2
+    const ftsQuery = query.trim();
+    // Pre-filter candidates using FTS5
+    const filters = { includeExpired };
+    if (type !== undefined)
+        filters.type = type;
+    if (entities !== undefined)
+        filters.entities = entities;
+    if (minImportance !== undefined)
+        filters.minImportance = minImportance;
+    const candidates = getFilteredCandidates(db, ftsQuery, filters);
+    // Calculate hybrid scores (FTS rank + importance + recency)
+    const scoredResults = candidates.map((memory) => {
+        const hybridScore = calculateHybridScore(memory);
+        return {
+            ...memory,
+            score: hybridScore,
+            entities: [], // Will be populated later
+            provenance: [], // Will be populated later
+        };
+    });
+    // Sort by score
+    scoredResults.sort((a, b) => b.score - a.score);
+    // Total count before pagination
+    const totalCount = scoredResults.length;
+    // Apply pagination
+    const paginatedResults = scoredResults.slice(offset, offset + limit);
+    // Enrich with entities and provenance
+    const enrichedResults = enrichResults(db, paginatedResults);
+    return {
+        results: enrichedResults,
+        totalCount,
+    };
+}
+/**
+ * Get filtered candidate memories using FTS5
+ */
+function getFilteredCandidates(db, ftsQuery, filters) {
+    const { type, entities, minImportance, includeExpired } = filters;
+    // Use FTS5 for keyword search
+    let query = `
+    SELECT m.*
+    FROM memories m
+    JOIN memories_fts fts ON m.id = fts.memory_id
+    WHERE fts.memories_fts MATCH ?
+      AND m.is_deleted = 0
+  `;
+    const params = [ftsQuery];
+    // Type filter
+    if (type) {
+        query += ` AND m.type = ?`;
+        params.push(type);
+    }
+    // Importance filter
+    if (minImportance !== undefined) {
+        query += ` AND m.importance >= ?`;
+        params.push(minImportance);
+    }
+    // Expiration filter
+    if (!includeExpired) {
+        query += ` AND (m.expires_at IS NULL OR m.expires_at > ?)`;
+        params.push(Date.now());
+    }
+    // Entity filter (if specified)
+    if (entities && entities.length > 0) {
+        query += `
+      AND m.id IN (
+        SELECT memory_id FROM memory_entities
+        WHERE entity_id IN (
+          SELECT id FROM entities WHERE name IN (${entities.map(() => '?').join(',')})
+        )
+      )
+    `;
+        params.push(...entities);
+    }
+    // Order by importance and recency (FTS match is implicit by MATCH clause)
+    // Actual ranking happens in calculateHybridScore()
+    query += ` ORDER BY m.importance DESC, m.last_accessed DESC`;
+    const stmt = db.prepare(query);
+    const rows = stmt.all(...params);
+    return rows.map(rowToMemory);
+}
+/**
+ * Calculate hybrid score (FTS rank + importance + recency)
+ */
+function calculateHybridScore(memory) {
+    const now = Date.now();
+    // Importance component (0-1)
+    const importanceScore = memory.importance / 10;
+    // Recency component (0-1)
+    const recencyScore = calculateRecencyScore(memory.last_accessed, now);
+    // Frequency component (0-1)
+    const frequencyScore = Math.min(memory.access_count / 100, 1.0);
+    // Weighted combination
+    return (importanceScore * 0.4 + // 40% importance
+        recencyScore * 0.3 + // 30% recency
+        frequencyScore * 0.2 + // 20% frequency
+        0.1 // 10% base score
+    );
+}
+/**
+ * Calculate recency score (0-1)
+ */
+function calculateRecencyScore(lastAccessed, now) {
+    const hoursAgo = (now - lastAccessed) / (1000 * 60 * 60);
+    if (hoursAgo < 1)
+        return 1.0;
+    if (hoursAgo < 6)
+        return 0.8;
+    if (hoursAgo < 24)
+        return 0.6;
+    if (hoursAgo < 168)
+        return 0.4;
+    if (hoursAgo < 720)
+        return 0.2;
+    return 0.0;
+}
+/**
+ * Enrich results with entities and provenance
+ */
+function enrichResults(db, results) {
+    if (results.length === 0) {
+        return results;
+    }
+    // Batch fetch entities
+    const memoryIds = results.map((r) => r.id);
+    const entitiesMap = batchFetchEntities(db, memoryIds);
+    // Batch fetch provenance (last 3 records per memory)
+    const provenanceMap = batchFetchProvenance(db, memoryIds);
+    return results.map((result) => ({
+        ...result,
+        entities: entitiesMap.get(result.id) || [],
+        provenance: provenanceMap.get(result.id) || [],
+    }));
+}
+/**
+ * Batch fetch entities for memories
+ */
+function batchFetchEntities(db, memoryIds) {
+    const entitiesMap = new Map();
+    if (memoryIds.length === 0) {
+        return entitiesMap;
+    }
+    const placeholders = memoryIds.map(() => '?').join(',');
+    const query = `
+    SELECT me.memory_id, e.*
+    FROM memory_entities me
+    JOIN entities e ON me.entity_id = e.id
+    WHERE me.memory_id IN (${placeholders})
+    ORDER BY e.name
+  `;
+    const rows = db.prepare(query).all(...memoryIds);
+    for (const row of rows) {
+        const memoryId = row.memory_id;
+        if (!entitiesMap.has(memoryId)) {
+            entitiesMap.set(memoryId, []);
+        }
+        entitiesMap.get(memoryId)?.push({
+            id: row.id,
+            name: row.name,
+            type: row.type,
+            metadata: deserializeMetadata(row.metadata),
+            created_at: row.created_at,
+        });
+    }
+    return entitiesMap;
+}
+/**
+ * Batch fetch provenance for memories
+ */
+function batchFetchProvenance(db, memoryIds) {
+    const provenanceMap = new Map();
+    if (memoryIds.length === 0) {
+        return provenanceMap;
+    }
+    const placeholders = memoryIds.map(() => '?').join(',');
+    const query = `
+    SELECT *
+    FROM provenance
+    WHERE memory_id IN (${placeholders})
+    ORDER BY memory_id, timestamp DESC
+  `;
+    const rows = db.prepare(query).all(...memoryIds);
+    for (const row of rows) {
+        const memoryId = row.memory_id;
+        if (!provenanceMap.has(memoryId)) {
+            provenanceMap.set(memoryId, []);
+        }
+        const provenance = provenanceMap.get(memoryId);
+        if (provenance && provenance.length < 3) {
+            // Only keep last 3 provenance records
+            provenance.push({
+                id: row.id,
+                memory_id: row.memory_id,
+                operation: row.operation,
+                timestamp: row.timestamp,
+                source: row.source,
+                context: row.context,
+                user_id: row.user_id,
+                changes: row.changes ? deserializeMetadata(row.changes) : null,
+            });
+        }
+    }
+    return provenanceMap;
+}
+/**
+ * Convert database row to Memory object
+ */
+function rowToMemory(row) {
+    return {
+        id: row.id,
+        content: row.content,
+        summary: row.summary,
+        type: row.type,
+        importance: row.importance,
+        created_at: row.created_at,
+        last_accessed: row.last_accessed,
+        access_count: row.access_count,
+        expires_at: row.expires_at,
+        metadata: deserializeMetadata(row.metadata),
+        is_deleted: row.is_deleted === 1,
+    };
+}
+//# sourceMappingURL=semantic-search.js.map

package/dist/search/semantic-search.js.map

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

package/dist/tools/memory-forget.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Memory forget tool - Soft delete memories
+ */
+import type Database from 'better-sqlite3';
+import type { ForgetResponse } from '../types/index.js';
+/**
+ * Forget (soft delete) a memory
+ */
+export declare function memoryForget(db: Database.Database, id: string, reason?: string): Promise<ForgetResponse>;
+//# sourceMappingURL=memory-forget.d.ts.map

package/dist/tools/memory-forget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-forget.d.ts","sourceRoot":"","sources":["../../src/tools/memory-forget.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD;;GAEG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CAwCzB"}

package/dist/tools/memory-forget.js

@@ -0,0 +1,34 @@
+/**
+ * Memory forget tool - Soft delete memories
+ */
+import { now, generateId, serializeMetadata } from '../database/connection.js';
+import { ValidationError } from '../types/index.js';
+/**
+ * Forget (soft delete) a memory
+ */
+export async function memoryForget(db, id, reason) {
+    // Check if memory exists
+    const existing = db
+        .prepare('SELECT id FROM memories WHERE id = ? AND is_deleted = 0')
+        .get(id);
+    if (!existing) {
+        throw new ValidationError(`Memory ${id} not found or already deleted`);
+    }
+    // Soft delete (mark as deleted)
+    const currentTime = now();
+    db.prepare('UPDATE memories SET is_deleted = 1 WHERE id = ?').run(id);
+    // Create provenance record
+    const provenanceId = generateId('prov');
+    db.prepare(`
+    INSERT INTO provenance (
+      id, memory_id, operation, timestamp, source, context, user_id, changes
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(provenanceId, id, 'delete', currentTime, 'user', reason || 'User requested deletion', null, serializeMetadata({ soft_delete: true }));
+    const response = {
+        success: true,
+        memory_id: id,
+        message: `Memory soft-deleted successfully. Reason: ${reason || 'Not specified'}`,
+    };
+    return response;
+}
+//# sourceMappingURL=memory-forget.js.map

package/dist/tools/memory-forget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-forget.js","sourceRoot":"","sources":["../../src/tools/memory-forget.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAqB,EACrB,EAAU,EACV,MAAe;IAEf,yBAAyB;IACzB,MAAM,QAAQ,GAAG,EAAE;SAChB,OAAO,CAAC,yDAAyD,CAAC;SAClE,GAAG,CAAC,EAAE,CAA+B,CAAC;IAEzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,+BAA+B,CAAC,CAAC;IACzE,CAAC;IAED,gCAAgC;IAChC,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC;IAC1B,EAAE,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEtE,2BAA2B;IAC3B,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACxC,EAAE,CAAC,OAAO,CACR;;;;GAID,CACA,CAAC,GAAG,CACH,YAAY,EACZ,EAAE,EACF,QAAQ,EACR,WAAW,EACX,MAAM,EACN,MAAM,IAAI,yBAAyB,EACnC,IAAI,EACJ,iBAAiB,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CACzC,CAAC;IAEF,MAAM,QAAQ,GAAmB;QAC/B,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,6CAA6C,MAAM,IAAI,eAAe,EAAE;KAClF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/memory-recall.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Memory recall tool - Token-aware semantic search
+ * v3.0: Dual-response pattern (index + details) for skill-like progressive loading
+ */
+import type Database from 'better-sqlite3';
+import type { SearchOptions, RecallResponse } from '../types/index.js';
+/**
+ * Recall memories using semantic search with intelligent token budgeting
+ * Returns: index (all matches as summaries) + details (top matches with full content)
+ */
+export declare function memoryRecall(db: Database.Database, options: SearchOptions): Promise<RecallResponse>;
+//# sourceMappingURL=memory-recall.d.ts.map

package/dist/tools/memory-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-recall.d.ts","sourceRoot":"","sources":["../../src/tools/memory-recall.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,aAAa,EAEb,cAAc,EAMf,MAAM,mBAAmB,CAAC;AAM3B;;;GAGG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CAwGzB"}