claude-mem-lite 2.5.4 → 2.9.2

package/install.mjs

@@ -1854,6 +1854,75 @@ const RESOURCE_METADATA = {
 
 };
 
+// ─── Marketing / SEO resources → on_request mode ────────────────────────────
+// These resources are rarely useful during programming sessions.
+// They only surface when the user explicitly asks for marketing/SEO help.
+const MARKETING_ON_REQUEST = new Set([
+  // Skills — marketing domain
+  'skill:ab-test-setup',
+  'skill:ad-creative',
+  'skill:ai-seo',
+  'skill:analytics-tracking',
+  'skill:churn-prevention',
+  'skill:cold-email',
+  'skill:competitor-alternatives',
+  'skill:content-strategy',
+  'skill:copy-editing',
+  'skill:copywriting',
+  'skill:email-sequence',
+  'skill:form-cro',
+  'skill:free-tool-strategy',
+  'skill:launch-strategy',
+  'skill:marketing-ideas',
+  'skill:marketing-psychology',
+  'skill:onboarding-cro',
+  'skill:page-cro',
+  'skill:paid-ads',
+  'skill:paywall-upgrade-cro',
+  'skill:popup-cro',
+  'skill:pricing-strategy',
+  'skill:product-marketing-context',
+  'skill:programmatic-seo',
+  'skill:referral-program',
+  'skill:schema-markup',
+  'skill:mktg-seo-audit',
+  'skill:signup-flow-cro',
+  'skill:social-content',
+  // Skills — SEO domain
+  'skill:seo-audit',
+  'skill:seo-competitor-pages',
+  'skill:seo-content',
+  'skill:seo-geo',
+  'skill:seo-hreflang',
+  'skill:seo-images',
+  'skill:seo-page',
+  'skill:seo-plan',
+  'skill:seo-programmatic',
+  'skill:seo-schema',
+  'skill:seo-sitemap',
+  'skill:seo-technical',
+  // Agents — SEO
+  'agent:seo-content-agent',
+  'agent:seo-performance-agent',
+  'agent:seo-schema-agent',
+  'agent:seo-sitemap-agent',
+  'agent:seo-technical-agent',
+  'agent:seo-visual-agent',
+  'agent:seo-analysis-monitoring',
+  'agent:seo-content-creation',
+  'agent:seo-technical-optimization',
+  // Agents — marketing / sales
+  'agent:content-marketing',
+  'agent:customer-sales-automation',
+]);
+
+// Stamp recommendation_mode into metadata so both insert and update paths read it
+for (const key of MARKETING_ON_REQUEST) {
+  if (RESOURCE_METADATA[key]) {
+    RESOURCE_METADATA[key].recommendation_mode = 'on_request';
+  }
+}
+
 /**
  * Apply curated metadata to existing resource DB entries.
  * Fixes existing installs that have generic name-echo metadata.
@@ -1865,6 +1934,7 @@ function reindexKnownResources(rdb) {
       intent_tags = ?, domain_tags = ?,
       capability_summary = ?, trigger_patterns = ?,
       invocation_name = CASE WHEN ? != '' THEN ? ELSE invocation_name END,
+      recommendation_mode = CASE WHEN ? != '' THEN ? ELSE recommendation_mode END,
       updated_at = datetime('now')
     WHERE type = ? AND name = ?
   `);
@@ -1876,10 +1946,12 @@ function reindexKnownResources(rdb) {
       const type = key.slice(0, sep);
       const name = key.slice(sep + 1);
       const invName = meta.invocation_name || '';
+      const recMode = meta.recommendation_mode || '';
       update.run(
         meta.intent_tags, meta.domain_tags,
         meta.capability_summary, meta.trigger_patterns,
         invName, invName,
+        recMode, recMode,
         type, name
       );
     }
@@ -1897,9 +1969,9 @@ function registerVirtualResources(rdb) {
   const insert = rdb.prepare(`
     INSERT OR IGNORE INTO resources (name, type, status, source, local_path, invocation_name,
       intent_tags, domain_tags, capability_summary, trigger_patterns,
-      keywords, tech_stack, use_cases,
+      keywords, tech_stack, use_cases, recommendation_mode,
       created_at, updated_at)
-    VALUES (?, ?, 'active', 'preinstalled', '', ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'), datetime('now'))
+    VALUES (?, ?, 'active', 'preinstalled', '', ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'), datetime('now'))
   `);
 
   // Backfill FTS5 fields for existing resources that have empty keywords/tech_stack/use_cases
@@ -1930,6 +2002,7 @@ function registerVirtualResources(rdb) {
         meta.keywords || '',
         meta.tech_stack || '',
         meta.use_cases || '',
+        meta.recommendation_mode || 'proactive',
       );
       count += changes;
 
@@ -1989,11 +2062,11 @@ async function install() {
   const SOURCE_FILES = [
     'server.mjs', 'server-internals.mjs', 'tool-schemas.mjs',
     'hook.mjs', 'hook-shared.mjs', 'hook-llm.mjs', 'hook-memory.mjs',
-    'hook-semaphore.mjs', 'hook-episode.mjs', 'hook-context.mjs', 'hook-handoff.mjs',
+    'hook-semaphore.mjs', 'hook-episode.mjs', 'hook-context.mjs', 'hook-handoff.mjs', 'hook-update.mjs',
     'haiku-client.mjs', 'utils.mjs', 'schema.mjs', 'package.json', 'skill.md',
     'registry.mjs', 'registry-scanner.mjs', 'registry-indexer.mjs',
     'registry-retriever.mjs', 'resource-discovery.mjs',
-    'dispatch.mjs', 'dispatch-inject.mjs', 'dispatch-feedback.mjs', 'dispatch-workflow.mjs',
+    'dispatch.mjs', 'dispatch-inject.mjs', 'dispatch-feedback.mjs', 'dispatch-patterns.mjs', 'dispatch-workflow.mjs',
   ];
 
   if (IS_DEV) {
@@ -2742,6 +2815,70 @@ function writeSettings(settings) {
   renameSync(tmp, SETTINGS_PATH);
 }
 
+// ─── Manual Update ───────────────────────────────────────────────────────────
+
+async function manualUpdate() {
+  console.log('\nclaude-mem-lite update\n');
+
+  // Force check by importing hook-update (bypasses throttle for manual use)
+  const { checkForUpdate, getCurrentVersion } = await import('./hook-update.mjs');
+  log('Checking for updates...');
+  const result = await checkForUpdate();
+
+  if (result?.updated) {
+    ok(`Updated: v${result.from} → v${result.to}`);
+  } else if (result?.updateAvailable) {
+    warn(`v${result.to} available but install failed — try: node install.mjs install`);
+  } else {
+    const ver = getCurrentVersion();
+    ok(`Already up to date (v${ver})`);
+  }
+  console.log('');
+}
+
+// ─── Release: Sync Versions ─────────────────────────────────────────────────
+
+function syncVersions() {
+  console.log('\nclaude-mem-lite release — sync versions\n');
+
+  const pkg = JSON.parse(readFileSync(join(PROJECT_DIR, 'package.json'), 'utf8'));
+  const version = pkg.version;
+  log(`package.json version: ${version}`);
+
+  // Sync plugin.json
+  const pluginJsonPath = join(PROJECT_DIR, '.claude-plugin', 'plugin.json');
+  if (existsSync(pluginJsonPath)) {
+    const pluginJson = JSON.parse(readFileSync(pluginJsonPath, 'utf8'));
+    if (pluginJson.version !== version) {
+      pluginJson.version = version;
+      writeFileSync(pluginJsonPath, JSON.stringify(pluginJson, null, 2) + '\n');
+      ok(`plugin.json: ${pluginJson.version} → ${version}`);
+    } else {
+      ok(`plugin.json: already ${version}`);
+    }
+  } else {
+    warn('plugin.json not found');
+  }
+
+  // Sync marketplace.json
+  const marketJsonPath = join(PROJECT_DIR, '.claude-plugin', 'marketplace.json');
+  if (existsSync(marketJsonPath)) {
+    const marketJson = JSON.parse(readFileSync(marketJsonPath, 'utf8'));
+    const plugin = marketJson.plugins?.[0];
+    if (plugin && plugin.version !== version) {
+      plugin.version = version;
+      writeFileSync(marketJsonPath, JSON.stringify(marketJson, null, 2) + '\n');
+      ok(`marketplace.json: ${plugin.version} → ${version}`);
+    } else if (plugin) {
+      ok(`marketplace.json: already ${version}`);
+    }
+  } else {
+    warn('marketplace.json not found');
+  }
+
+  console.log('');
+}
+
 // ─── Main ───────────────────────────────────────────────────────────────────
 
 switch (cmd) {
@@ -2757,6 +2894,12 @@ switch (cmd) {
   case 'doctor':
     await doctor();
     break;
+  case 'update':
+    await manualUpdate();
+    break;
+  case 'release':
+    syncVersions();
+    break;
   default:
     if (IS_NPX) {
       // npx claude-mem-lite (no args) → auto install
@@ -2772,6 +2915,8 @@ Usage:
   node install.mjs uninstall --purge  Remove and delete all data
   node install.mjs status             Show current status
   node install.mjs doctor             Diagnose issues
+  node install.mjs update             Check for and install updates
+  node install.mjs release            Sync version to plugin.json + marketplace.json
 
   npx claude-mem-lite                 Install via npx (one-liner)
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "2.5.4",
+  "version": "2.9.2",
   "description": "Lightweight persistent memory system for Claude Code",
   "type": "module",
   "engines": {
@@ -33,10 +33,12 @@
     "hook-episode.mjs",
     "hook-context.mjs",
     "hook-handoff.mjs",
+    "hook-update.mjs",
     "haiku-client.mjs",
     "dispatch.mjs",
     "dispatch-inject.mjs",
     "dispatch-feedback.mjs",
+    "dispatch-patterns.mjs",
     "dispatch-workflow.mjs",
     "registry.mjs",
     "registry-retriever.mjs",

package/registry/preinstalled.json

@@ -1127,6 +1127,19 @@
         "natural"
       ]
     },
+    {
+      "name": "claudeception",
+      "type": "skill",
+      "repo": "https://github.com/blader/Claudeception",
+      "path": ".",
+      "tags": [
+        "meta",
+        "skill-extraction",
+        "learning",
+        "continuous",
+        "autonomous"
+      ]
+    },
     {
       "name": "anthropic-architect",
       "type": "skill",

package/registry-retriever.mjs

@@ -23,6 +23,7 @@ export const DISPATCH_SYNONYMS = {
   'plan':     ['planning', 'architecture', 'spec', 'blueprint', 'rfc', 'proposal', 'roadmap'],
   'build':    ['compile', 'bundle', 'webpack', 'vite', 'typescript', 'tsc', 'esbuild', 'rollup', 'parcel', 'babel', 'swc', 'transpile'],
   'lint':     ['eslint', 'prettier', 'biome', 'stylelint', 'format', 'style'],
+  'search':   ['lookup', 'latest', 'best-practices', 'perplexity'],
   // Chinese intent mappings
   '清理':     ['refactor', 'clean', 'lint', 'format', 'simplify'],
   '测试':     ['test', 'testing', 'tdd', 'qa', 'spec', 'jest', 'vitest', 'pytest'],
@@ -44,6 +45,7 @@ export const DISPATCH_SYNONYMS = {
   '打包':     ['bundle', 'build', 'webpack', 'vite'],
   '容器':     ['docker', 'container', 'kubernetes', 'infrastructure'],
   '运维':     ['devops', 'infrastructure', 'deploy', 'docker'],
+  '搜索':     ['search', 'lookup', 'latest', 'perplexity'],
 };
 
 // ─── CJK Tokenization ───────────────────────────────────────────────────────
@@ -98,6 +100,9 @@ const CJK_INTENT_MAP = {
   '接口': 'api', '路由': 'route',
   // plan
   '规划': 'planning', '架构': 'architecture', '方案': 'plan', '设计方案': 'architecture',
+  // search — only web/info search, NOT code search (grep/find)
+  '联网搜索': 'search', '网上搜索': 'search', '查资料': 'search', '找资料': 'search',
+  '搜索最新': 'search', '搜索资料': 'search', '搜索文档': 'search',
 };
 
 // Merge all CJK keys from both maps, longest-first to avoid partial matches
@@ -346,30 +351,30 @@ const COMPOSITE_EXPR = `(
     bm25(resources_fts, 5.0, 3.0, 3.0, 2.0, 2.0, 1.0, 1.0, 1.0) * 0.4
     - COALESCE(r.repo_stars * 1.0 / (r.repo_stars + 100.0), 0) * 0.15
     - (
-        (r.success_count + 1.0) / (r.recommend_count + 2.0) * 0.5
+        (COALESCE(r.success_count, 0) + 1.0) / (COALESCE(r.recommend_count, 0) + 2.0) * 0.5
         + COALESCE(
             (SELECT (SUM(CASE WHEN i.outcome='success' THEN 1 ELSE 0 END) + 1.0)
                   / (COUNT(*) + 2.0)
              FROM invocations i WHERE i.resource_id = r.id
                AND i.created_at > datetime('now', '-30 days')),
-            (r.success_count + 1.0) / (r.recommend_count + 2.0)
+            (COALESCE(r.success_count, 0) + 1.0) / (COALESCE(r.recommend_count, 0) + 2.0)
           ) * 0.5
       ) * 0.15
     - (
-        (r.adopt_count + 1.0) / (r.recommend_count + 2.0) * 0.5
+        (COALESCE(r.adopt_count, 0) + 1.0) / (COALESCE(r.recommend_count, 0) + 2.0) * 0.5
         + COALESCE(
             (SELECT (SUM(CASE WHEN i.adopted=1 THEN 1 ELSE 0 END) + 1.0)
                   / (COUNT(*) + 2.0)
              FROM invocations i WHERE i.resource_id = r.id
                AND i.created_at > datetime('now', '-30 days')),
-            (r.adopt_count + 1.0) / (r.recommend_count + 2.0)
+            (COALESCE(r.adopt_count, 0) + 1.0) / (COALESCE(r.recommend_count, 0) + 2.0)
           ) * 0.5
       ) * 0.10
-    - CASE WHEN r.recommend_count < 10
-        THEN 0.10 * (1.0 - r.recommend_count * 1.0 / 10.0)
+    - CASE WHEN COALESCE(r.recommend_count, 0) < 10
+        THEN 0.10 * (1.0 - COALESCE(r.recommend_count, 0) * 1.0 / 10.0)
         ELSE 0 END
-    + CASE WHEN r.recommend_count > 15
-           AND (r.adopt_count + 1.0) / (r.recommend_count + 2.0) < 0.1
+    + CASE WHEN COALESCE(r.recommend_count, 0) > 8
+           AND (COALESCE(r.adopt_count, 0) + 1.0) / (COALESCE(r.recommend_count, 0) + 2.0) < 0.1
         THEN 0.10
         ELSE 0 END
   )`;

package/registry.mjs

@@ -37,6 +37,9 @@ const RESOURCES_SCHEMA = `
     recommend_count   INTEGER DEFAULT 0,
     adopt_count       INTEGER DEFAULT 0,
     success_count     INTEGER DEFAULT 0,
+    silenced_until TEXT,
+    cooldown_hours    INTEGER DEFAULT 0,
+    recommendation_mode TEXT DEFAULT 'proactive',
     indexed_at    TEXT,
     created_at    TEXT DEFAULT (datetime('now')),
     updated_at    TEXT DEFAULT (datetime('now'))
@@ -106,7 +109,7 @@ const INVOCATIONS_SCHEMA = `
     adopted       INTEGER DEFAULT 0,
     outcome       TEXT CHECK(outcome IN ('success','partial','failure','skipped','ignored') OR outcome IS NULL),
     score         REAL,
-    rejection_reason TEXT CHECK(rejection_reason IN ('alternative','manual','context_switch','session_end','unknown') OR rejection_reason IS NULL),
+    rejection_reason TEXT CHECK(rejection_reason IN ('alternative','manual','context_switch','session_end','unknown','no_events','unclassified') OR rejection_reason IS NULL),
     created_at    TEXT DEFAULT (datetime('now'))
   );
 
@@ -115,6 +118,9 @@ const INVOCATIONS_SCHEMA = `
 
   CREATE INDEX IF NOT EXISTS idx_inv_session
     ON invocations(session_id);
+
+  CREATE INDEX IF NOT EXISTS idx_inv_created_at
+    ON invocations(created_at);
 `;
 
 const PREINSTALLED_SCHEMA = `
@@ -156,13 +162,15 @@ export function ensureRegistryDb(dbPath) {
 
   db.exec(RESOURCES_SCHEMA);
 
-  // Migrate: add invocation_name column if missing (safe for existing DBs)
+  // Migrate: add missing columns to resources (single PRAGMA call for all)
   try {
-    const cols = db.prepare("PRAGMA table_info(resources)").all();
-    if (!cols.some(c => c.name === 'invocation_name')) {
-      db.exec("ALTER TABLE resources ADD COLUMN invocation_name TEXT DEFAULT ''");
-    }
-  } catch (e) { debugCatch(e, 'invocation_name-migration'); }
+    const resCols = new Set(db.prepare("PRAGMA table_info(resources)").all().map(c => c.name));
+    if (!resCols.has('invocation_name')) db.exec("ALTER TABLE resources ADD COLUMN invocation_name TEXT DEFAULT ''");
+    if (!resCols.has('silenced_until')) db.exec("ALTER TABLE resources ADD COLUMN silenced_until TEXT");
+    if (!resCols.has('cooldown_hours')) db.exec("ALTER TABLE resources ADD COLUMN cooldown_hours INTEGER DEFAULT 0");
+    // recommendation_mode: 'proactive' (default, actively recommended), 'on_request' (only when explicitly asked)
+    if (!resCols.has('recommendation_mode')) db.exec("ALTER TABLE resources ADD COLUMN recommendation_mode TEXT DEFAULT 'proactive'");
+  } catch (e) { debugCatch(e, 'resources-column-migration'); }
 
   // FTS5 + triggers: only create if not exists
   const hasFts = db.prepare(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='resources_fts'`).get();

package/server.mjs

@@ -4,7 +4,7 @@
 
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { jaccardSimilarity, truncate, typeIcon, sanitizeFtsQuery, relaxFtsQueryToOr, inferProject, computeMinHash, estimateJaccardFromMinHash, scrubSecrets, cjkBigrams, fmtDate, isoWeekKey, debugLog, debugCatch, COMPRESSED_AUTO, COMPRESSED_PENDING_PURGE } from './utils.mjs';
+import { jaccardSimilarity, truncate, typeIcon, sanitizeFtsQuery, relaxFtsQueryToOr, inferProject, computeMinHash, estimateJaccardFromMinHash, scrubSecrets, cjkBigrams, fmtDate, isoWeekKey, debugLog, debugCatch, COMPRESSED_PENDING_PURGE } from './utils.mjs';
 import { ensureDb, DB_PATH, REGISTRY_DB_PATH } from './schema.mjs';
 import { reRankWithContext, markSuperseded, extractPRFTerms, expandQueryByConcepts, autoBoostIfNeeded, runIdleCleanup } from './server-internals.mjs';
 import { memSearchSchema, memTimelineSchema, memGetSchema, memDeleteSchema, memSaveSchema, memStatsSchema, memCompressSchema, memMaintainSchema, memRegistrySchema } from './tool-schemas.mjs';
@@ -56,6 +56,27 @@ function getRegistryDb() {
 
 // inferProject, jaccardSimilarity, sanitizeFtsQuery, typeIcon, truncate, fmtDate imported from utils.mjs
 
+// ─── Project Name Resolution ────────────────────────────────────────────────
+// Users naturally type short names like "mem" but inferProject() stores
+// "projects--mem" (parent--base from CWD). resolveProject() bridges this gap.
+
+const _projectCache = new Map();
+
+function resolveProject(name) {
+  if (!name) return name;
+  if (_projectCache.has(name)) return _projectCache.get(name);
+  // Already a canonical name (contains "--")? Use as-is.
+  if (name.includes('--')) { _projectCache.set(name, name); return name; }
+  // Short name: prefer the canonical "parent--name" form (from inferProject())
+  // which typically has far more data than manually-saved short names.
+  const suffixed = db.prepare(
+    'SELECT project FROM observations WHERE project LIKE ? GROUP BY project ORDER BY COUNT(*) DESC LIMIT 1'
+  ).get(`%--${name}`);
+  const resolved = suffixed ? suffixed.project : name;
+  _projectCache.set(name, resolved);
+  return resolved;
+}
+
 // ─── Scoring Model Constants ────────────────────────────────────────────────
 //
 // Composite scoring: BM25(weights) × recency_decay × [project_boost] × [importance] × [access_bonus]
@@ -97,8 +118,12 @@ const server = new McpServer(
       '- Non-obvious debugging discovery → mem_save with type="bugfix"',
       '- Key architecture decision → mem_save with type="decision"',
       '- Important pattern or convention found → mem_save with type="discovery"',
+      '- Do NOT save: ephemeral task state, git history, obvious code patterns, or info derivable from code.',
       '',
-      'WORKFLOW: mem_search → mem_timeline(anchor=ID) → mem_get(ids=[...]) for full context.',
+      'SEARCH WORKFLOW: mem_search → mem_timeline(anchor=ID) for surrounding context → mem_get(ids=[...]) for full details.',
+      'Search tips: use short keywords (2-3 words), not full sentences. Filter with obs_type when relevant.',
+      '',
+      'MAINTENANCE: mem_compress consolidates old observations. mem_maintain runs dedup/cleanup/reindex.',
     ].join('\n'),
   },
 );
@@ -214,15 +239,15 @@ function searchObservations(ctx) {
       const orQuery = relaxFtsQueryToOr(ftsQuery);
       if (orQuery) {
         try {
-          const orRows = db.prepare(buildObsFtsQuery('full', { multiplier: 0.8, withSnippet: true, withOffset: true }))
+          const orRows = db.prepare(buildObsFtsQuery('full', { multiplier: 0.5, withSnippet: true, withOffset: true }))
             .all(...buildObsFtsParams({ now, projectBoost, ftsQuery: orQuery, args, epochFrom, epochTo, limit: perSourceLimit, offset: perSourceOffset }));
           for (const r of orRows) results.push(ftsRowToResult(r, { snippet: true }));
         } catch (e) { debugCatch(e, 'searchObservations-or-fallback'); }
       }
     }
 
-    // Two-phase query expansion for sparse results
-    if (rows.length > 0 && results.length < limit) {
+    // Two-phase query expansion for sparse results (only when well below limit)
+    if (rows.length > 0 && results.length < Math.ceil(limit / 2)) {
       const existingIds = new Set(results.map(r => r.id));
       expandObsByConceptCo(ctx, now, existingIds, results);
       expandObsByPRF(ctx, now, rows.length, existingIds, results);
@@ -404,11 +429,17 @@ function searchPrompts(ctx) {
 
 function formatSearchOutput(paginatedResults, args, ftsQuery, totalCount, isCrossSource) {
   if (paginatedResults.length === 0) {
-    const hint = ['No results found.'];
-    if (args.query) {
-      const expanded = ftsQuery || args.query;
-      if (expanded !== args.query) hint.push(`Searched as: ${expanded}`);
-      hint.push('Tip: check spelling, try broader terms, or use mem_stats to see available data.');
+    const hint = [];
+    if (args.query && !ftsQuery) {
+      hint.push(`Query "${args.query}" was filtered (FTS5 keywords/special chars only).`);
+      hint.push('Tip: use content words instead of operators (AND, OR, NOT, NEAR).');
+    } else {
+      hint.push('No results found.');
+      if (args.query) {
+        const expanded = ftsQuery || args.query;
+        if (expanded !== args.query) hint.push(`Searched as: ${expanded}`);
+        hint.push('Tip: check spelling, try broader terms, or use mem_stats to see available data.');
+      }
     }
     return { content: [{ type: 'text', text: hint.join('\n') }] };
   }
@@ -446,6 +477,7 @@ server.registerTool(
     inputSchema: memSearchSchema,
   },
   safeHandler(async (args) => {
+    if (args.project) args = { ...args, project: resolveProject(args.project) };
     const limit = args.limit ?? 20;
     const offset = args.offset ?? 0;
     const ftsQuery = sanitizeFtsQuery(args.query);
@@ -463,8 +495,13 @@ server.registerTool(
     if (epochTo !== null && args.date_to && /^\d{4}-\d{2}-\d{2}$/.test(args.date_to)) {
       epochTo += 86400000 - 1; // extend to 23:59:59.999
     }
-    if (epochFrom !== null && isNaN(epochFrom)) throw new Error(`Invalid date_from: ${args.date_from}`);
-    if (epochTo !== null && isNaN(epochTo)) throw new Error(`Invalid date_to: ${args.date_to}`);
+    if (epochFrom !== null && isNaN(epochFrom)) throw new Error(`Invalid date_from: "${args.date_from}" (use ISO 8601 or YYYY-MM-DD)`);
+    if (epochTo !== null && isNaN(epochTo)) throw new Error(`Invalid date_to: "${args.date_to}" (use ISO 8601 or YYYY-MM-DD)`);
+
+    // Early return when query was provided but sanitized to nothing (all FTS5 keywords/special chars)
+    if (args.query && !ftsQuery && !epochFrom && !epochTo && !args.obs_type && !args.importance) {
+      return formatSearchOutput([], args, ftsQuery, 0, false);
+    }
 
     const ctx = { ftsQuery, searchType, args, epochFrom, epochTo, perSourceLimit, perSourceOffset, currentProject, limit };
     const results = [];
@@ -506,6 +543,7 @@ server.registerTool(
     inputSchema: memTimelineSchema,
   },
   safeHandler(async (args) => {
+    if (args.project) args = { ...args, project: resolveProject(args.project) };
     const before = args.before ?? 5;
     const after = args.after ?? 5;
     let anchorId = args.anchor;
@@ -705,7 +743,10 @@ server.registerTool(
     });
     const result = deleteTx();
 
-    return { content: [{ type: 'text', text: `Deleted ${result.changes} observation(s).` }] };
+    const missing = args.ids.filter(id => !rows.some(r => r.id === id));
+    const msg = [`Deleted ${result.changes} observation(s).`];
+    if (missing.length > 0) msg.push(`Note: ID(s) ${missing.join(', ')} not found.`);
+    return { content: [{ type: 'text', text: msg.join(' ') }] };
   })
 );
 
@@ -718,6 +759,7 @@ server.registerTool(
     inputSchema: memSaveSchema,
   },
   safeHandler(async (args) => {
+    if (args.project) args = { ...args, project: resolveProject(args.project) };
     const now = new Date();
     const project = args.project || inferProject();
     const type = args.type || 'discovery';
@@ -770,6 +812,7 @@ server.registerTool(
     inputSchema: memStatsSchema,
   },
   safeHandler(async (args) => {
+    if (args.project) args = { ...args, project: resolveProject(args.project) };
     const days = args.days ?? 30;
     const cutoff = Date.now() - days * 86400000;
     const projectFilter = args.project ? 'AND project = ?' : '';
@@ -865,6 +908,7 @@ server.registerTool(
     inputSchema: memCompressSchema,
   },
   safeHandler(async (args) => {
+    if (args.project) args = { ...args, project: resolveProject(args.project) };
     const preview = args.preview !== false;
     const ageDays = args.age_days ?? 60;
     const cutoff = Date.now() - ageDays * 86400000;
@@ -977,6 +1021,7 @@ server.registerTool(
     inputSchema: memMaintainSchema,
   },
   safeHandler(async (args) => {
+    if (args.project) args = { ...args, project: resolveProject(args.project) };
     const STALE_AGE_MS = 30 * 86400000;
     const SIMILARITY_THRESHOLD = 0.7;
     const SCAN_LIMIT = 500;