claude-memory-layer 1.0.18 → 1.0.20

package/dist/ui/style.css

@@ -329,6 +329,23 @@ body {
   opacity: 0.5;
 }
 
+.kpi-grid .stat-card .stat-value {
+  font-size: 28px;
+}
+.kpi-grid .stat-card .stat-label {
+  font-size: 12px;
+}
+.kpi-delta {
+  font-size: 11px;
+  margin-top: -4px;
+  margin-bottom: 8px;
+  color: var(--text-muted);
+  font-weight: 600;
+}
+.kpi-delta.good { color: var(--success); }
+.kpi-delta.bad { color: var(--error); }
+.kpi-delta.neutral { color: var(--text-muted); }
+
 .stat-value {
   font-size: 36px;
   font-weight: 700;
@@ -485,8 +502,11 @@ body {
 }
 
 .type-user { background: rgba(59, 130, 246, 0.2); color: #60A5FA; }
+.type-user-prompt { background: rgba(59, 130, 246, 0.2); color: #60A5FA; }
 .type-agent { background: rgba(16, 185, 129, 0.2); color: #34D399; }
+.type-agent-response { background: rgba(16, 185, 129, 0.2); color: #34D399; }
 .type-tool { background: rgba(245, 158, 11, 0.2); color: #FBBF24; }
+.type-tool-observation { background: rgba(245, 158, 11, 0.2); color: #FBBF24; }
 .type-system { background: rgba(139, 92, 246, 0.2); color: #A78BFA; }
 
 .event-time {
@@ -580,6 +600,10 @@ body {
   color: var(--accent-primary);
   font-weight: 600;
 }
+.sort-btn:disabled {
+  opacity: 0.35;
+  cursor: not-allowed;
+}
 
 /* Access Badge */
 .access-badge {
@@ -594,6 +618,23 @@ body {
   font-weight: 600;
 }
 
+.adherence-badge {
+  font-size: 10px;
+  padding: 3px 7px;
+  border-radius: 6px;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.2px;
+}
+.adherence-checked {
+  background: rgba(52, 211, 153, 0.14);
+  color: #34D399;
+}
+.adherence-skipped {
+  background: rgba(148, 163, 184, 0.14);
+  color: #94A3B8;
+}
+
 /* Section Label */
 .section-label {
   font-size: 12px;

package/memory/_index.md

@@ -4,6 +4,7 @@ Generated automatically by MarkdownMirror.
 
 - memory/.claude-plugin/commands/2026-02-25.md
 - memory/agent_response/uncategorized/2026-02-26.md
+- memory/agent_response/uncategorized/2026-03-03.md
 - memory/default/uncategorized/2026-02-25.md
 - memory/node_modules/abbrev/2026-02-25.md
 - memory/node_modules/abort-controller/2026-02-25.md
@@ -393,6 +394,7 @@ Generated automatically by MarkdownMirror.
 - memory/node_modules/yocto-queue/2026-02-25.md
 - memory/node_modules/zod/2026-02-25.md
 - memory/session_summary/uncategorized/2026-02-26.md
+- memory/session_summary/uncategorized/2026-03-03.md
 - memory/specs/20260207-dashboard-upgrade/2026-02-25.md
 - memory/specs/citations-system/2026-02-25.md
 - memory/specs/endless-mode/2026-02-25.md
@@ -406,4 +408,5 @@ Generated automatically by MarkdownMirror.
 - memory/specs/vector-outbox-v2/2026-02-25.md
 - memory/specs/web-viewer-ui/2026-02-25.md
 - memory/tool_observation/uncategorized/2026-02-26.md
+- memory/tool_observation/uncategorized/2026-03-03.md
 - memory/user_prompt/uncategorized/2026-02-26.md

package/memory/agent_response/uncategorized/2026-03-03.md

@@ -0,0 +1,14 @@
+
+## 2026-03-03T14:04:37.701Z | 55805b7d-13d2-4e6e-9c1d-bcdf1f1259f9
+- type: agent_response
+- session: 3252b490-16ca-40fb-b30c-1171456e2c89
+커밋 완료했습니다.
+
+**커밋 `b37aa13`** - `feat(cli): expand hook coverage to all lifecycle events`
+
+변경 내용:
+- `src/cli/index.ts`: `SessionStart`, `Stop`, `SessionEnd` 훅 추가, `makeHook` 헬퍼로 리팩토링, `REQUIRED_HOOK_FILES` 상수 및 `hasHook` 헬퍼 추가, install/uninstall/status 명령 업데이트
+- `scripts/delete-unknown-projects.js`: 세션 레지스트리에 없는 프로젝트 디렉토리 정리 스크립트 (신규)
+- `package.json` / `package-lock.json`: 버전 1.0.18, `ops:projects:clean-unknown` 스크립트 추가
+
+제외된 파일 (커밋 불포함): `.npm-cache/`, `bootstrap-kb/`, `claude-memory-layer-1.0.14.tgz`, `d.sh`, `deploy.sh`, `memory/`, `yarn.lock` (빌드 아티팩트 및 로컬 파일)

package/memory/session_summary/uncategorized/2026-03-03.md

@@ -0,0 +1,5 @@
+
+## 2026-03-03T14:04:47.970Z | 7dfbcdd9-f49f-482d-a0c6-9779331cc5cf
+- type: session_summary
+- session: 3252b490-16ca-40fb-b30c-1171456e2c89
+Session with 0 user prompts and 1 responses.

package/memory/tool_observation/uncategorized/2026-03-03.md

@@ -0,0 +1,21 @@
+
+## 2026-03-03T14:03:38.204Z | 46d8dc3c-a7ce-4602-ae18-daf4ed0266f1
+- type: tool_observation
+- session: 3252b490-16ca-40fb-b30c-1171456e2c89
+{"toolName":"Skill","toolInput":{"skill":"commit"},"toolOutput":"{\"success\":true,\"commandName\":\"commit\"}","durationMs":0,"success":true,"metadata":{"turnId":"5eaeff19-dda2-4bd7-a905-9009b5786672"}}
+## 2026-03-03T14:03:43.897Z | ae933ad8-5f37-4a0b-9028-85bb29bdb6fc
+- type: tool_observation
+- session: 3252b490-16ca-40fb-b30c-1171456e2c89
+{"toolName":"Bash","toolInput":{"command":"git status && git diff && git log --oneline -5","description":"Check git status, diff, and recent commits"},"toolOutput":"On branch main\nYour branch is up to date with 'origin/main'.\n\nChanges not staged for commit:\n  (use \"git add <file>...\" to update what will be committed)\n  (use \"git restore <file>...\" to discard changes in working directory)\n\tmodified:   package-lock.json\n\tmodified:   package.json\n\tmodified:   src/cli/index.ts\n\nUntracked files:\n  (use \"git add <file>...\" to include in what will be committed)\n\t.npm-cache/\n\tbootstrap-kb/\n\tclaude-memory-layer-1.0.14.tgz\n\td.sh\n\tdeploy.sh\n\tmemory/\n\tscripts/delete-unknown-projects.js\n\tyarn.lock\n\nno changes added to commit (use \"git add\" and/or \"git commit -a\")\ndiff --git package-lock.json package-lock.json\nindex c01b2e9..1181958 100644\n--- package-lock.json\n+++ package-lock.json\n@@ -1,12 +1,12 @@\n {\n   \"name\": \"claude-memory-layer\",\n-  \"version\": \"1.0.15\",\n+  \"version\": \"1.0.18\",\n   \"lockfileVersion\": 3,\n   \"requires\": true,\n   \"packages\": {\n     \"\": {\n       \"name\": \"claude-memory-layer\",\n-      \"version\": \"1.0.15\",\n+      \"version\": \"1.0.18\",\n       \"license\": \"MIT\",\n       \"dependencies\": {\n         \"@hono/node-server\": \"^1.13.0\",\ndiff --git package.json package.json\nindex bd41ac1..453d235 100644\n--- package.json\n+++ package.json\n@@ -1,6 +1,6 @@\n {\n   \"name\": \"claude-memory-layer\",\n-  \"version\": \"1.0.15\",\n+  \"version\": \"1.0.18\",\n\n... [121 lines truncated] ...\n\n       delete settings.hooks.PostToolUse;\n+      delete settings.hooks.Stop;\n+      delete settings.hooks.SessionEnd;\n \n       // Clean up empty hooks object\n       if (Object.keys(settings.hooks).length === 0) {\n@@ -219,19 +238,22 @@ program\n       console.log('\\n🧠 Claude Memory Layer Status\\n');\n \n       // Check hooks\n-      const hasUserPromptHook = settings.hooks?.UserPromptSubmit?.some(h =>\n-        h.hooks?.some(hook => hook.command?.includes('user-prompt-submit'))\n-      );\n-      const hasPostToolHook = settings.hooks?.PostToolUse?.some(h =>\n-        h.hooks?.some(hook => hook.command?.includes('post-tool-use'))\n-      );\n+      const hasSessionStartHook = hasHook(settings, 'SessionStart', 'session-start');\n+      const hasUserPromptHook = hasHook(settings, 'UserPromptSubmit', 'user-prompt-submit');\n+      const hasPostToolHook = hasHook(settings, 'PostToolUse', 'post-tool-use');\n+      const hasStopHook = hasHook(settings, 'Stop', 'stop');\n+      const hasSessionEndHook = hasHook(settings, 'SessionEnd', 'session-end');\n \n       console.log('Hooks:');\n+      console.log(`  SessionStart: ${hasSessionStartHook ? '✅ Installed' : '❌ Not installed'}`);\n       console.log(`  UserPromptSubmit: ${hasUserPromptHook ? '✅ Installed' : '❌ Not installed'}`);\n       console.log(`  PostToolUse: ${hasPostToolHook ? '✅ Installed' : '❌ Not installed'}`);\n+      console.log(`  Stop: ${hasStopHook ? '✅ Installed' : '❌ Not installed'}`);\n+      console.log(`  SessionEnd: ${hasSessionEndHook ? '✅ Installed' : '❌ Not installed'}`);\n \n       // Check plugin files\n-      const hooksExist = fs.existsSync(path.join(pluginPath, 'hooks', 'user-prompt-submit.js'));\n+      const hooksExist = REQUIRED_HOOK_FILES\n+        .every((file) => fs.existsSync(path.join(pluginPath, 'hooks', file)));\n       console.log(`\\nPlugin files: ${hooksExist ? '✅ Found' : '❌ Not found'}`);\n       console.log(`  Path: ${pluginPath}`);\n \n@@ -239,7 +261,7 @@ program\n       const dashboardRunning = await isServerRunning(37777);\n       console.log(`\\nDashboard: ${dashboardRunning ? '✅ Running at http://localhost:37777' : '⏹️  Not running'}`);\n \n-      if (!hasUserPromptHook || !hasPostToolHook) {\n+      if (!hasSessionStartHook || !hasUserPromptHook || !hasPostToolHook || !hasStopHook || !hasSessionEndHook) {\n         console.log('\\n💡 Run \"claude-memory-layer install\" to set up hooks.\\n');\n       } else {\n         console.log('\\n✅ Plugin is fully installed and configured.\\n');\n257241b fix(hook): use lightweight service in session-start\n60d59c6 fix(api): handle missing retrieval_traces table in read-only mode\n1ab58f2 feat(build): inject version from package.json at build time\n4d48779 tune(hook): raise default injection threshold with fallback retry for recall\n3c618db fix(import): normalize underscore/hyphen path variants for project folder matching","durationMs":0,"success":true,"metadata":{"command":"git status","turnId":"5eaeff19-dda2-4bd7-a905-9009b5786672"}}
+## 2026-03-03T14:03:55.698Z | 101afa33-2fd1-4008-88b8-c824465ccd69
+- type: tool_observation
+- session: 3252b490-16ca-40fb-b30c-1171456e2c89
+{"toolName":"Bash","toolInput":{"command":"cat scripts/delete-unknown-projects.js","description":"Check new script content"},"toolOutput":"#!/usr/bin/env node\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\n\nfunction parseArgs(argv) {\n  const result = {\n    apply: false,\n    hashes: []\n  };\n\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    if (arg === '--apply') {\n      result.apply = true;\n      continue;\n    }\n    if (arg === '--hash' && i + 1 < argv.length) {\n      result.hashes.push(String(argv[i + 1]).trim().toLowerCase());\n      i += 1;\n      continue;\n    }\n    if (arg.startsWith('--hash=')) {\n      result.hashes.push(arg.slice('--hash='.length).trim().toLowerCase());\n    }\n  }\n\n  return result;\n}\n\nfunction loadRegistryHashes(registryPath) {\n  if (!fs.existsSync(registryPath)) return new Set();\n  try {\n    const raw = JSON.parse(fs.readFileSync(registryPath, 'utf8'));\n    const sessions = raw && typeof raw === 'object' ? raw.sessions : null;\n    if (!sessions || typeof sessions !== 'object') return new Set();\n\n    const hashes = new Set();\n    for (const entry of Object.values(sessions)) {\n      if (!entry || typeof entry !== 'object') continue;\n      const hash = entry.projectHash;\n      if (typeof hash === 'string' && /^[a-f0-9]{8}$/.test(hash)) {\n        hashes.add(hash);\n      }\n    }\n    return hashes;\n  } catch {\n    return new Set();\n  }\n}\n\n... [54 lines truncated] ...\n\n    .map((entry) => entry.name)\n    .filter((name) => /^[a-f0-9]{8}$/.test(name))\n    .filter((hash) => !knownHashes.has(hash))\n    .filter((hash) => filterHashes.size === 0 || filterHashes.has(hash));\n\n  const projectInfo = candidates.map((hash) => {\n    const fullPath = path.join(projectsDir, hash);\n    const sizeBytes = getDirSizeBytes(fullPath);\n    return {\n      hash,\n      path: fullPath,\n      sizeBytes,\n      sizeHuman: formatBytes(sizeBytes)\n    };\n  });\n\n  const totalBytes = projectInfo.reduce((sum, item) => sum + item.sizeBytes, 0);\n\n  if (!args.apply) {\n    console.log(JSON.stringify({\n      status: 'dry-run',\n      message: 'Run with --apply to delete the directories below.',\n      memoryRoot,\n      projectsDir,\n      registryPath,\n      unknownCount: projectInfo.length,\n      totalSizeBytes: totalBytes,\n      totalSizeHuman: formatBytes(totalBytes),\n      projects: projectInfo\n    }, null, 2));\n    process.exit(0);\n  }\n\n  let deleted = 0;\n  for (const item of projectInfo) {\n    fs.rmSync(item.path, { recursive: true, force: true });\n    deleted += 1;\n  }\n\n  console.log(JSON.stringify({\n    status: 'ok',\n    mode: 'apply',\n    deletedCount: deleted,\n    deletedSizeBytes: totalBytes,\n    deletedSizeHuman: formatBytes(totalBytes),\n    deletedHashes: projectInfo.map((item) => item.hash)\n  }, null, 2));\n}\n\nmain();","durationMs":0,"success":true,"metadata":{"command":"cat","turnId":"5eaeff19-dda2-4bd7-a905-9009b5786672"}}
+## 2026-03-03T14:04:06.818Z | e92edb69-bd60-41e4-a490-08a7c50deadd
+- type: tool_observation
+- session: 3252b490-16ca-40fb-b30c-1171456e2c89
+{"toolName":"Bash","toolInput":{"command":"git add package.json package-lock.json src/cli/index.ts scripts/delete-unknown-projects.js","description":"Stage relevant changed and new files"},"toolOutput":"","durationMs":0,"success":true,"metadata":{"command":"git add","turnId":"5eaeff19-dda2-4bd7-a905-9009b5786672"}}
+## 2026-03-03T14:04:29.483Z | bff186d2-1eba-4fb3-bbb4-98a5dccbc508
+- type: tool_observation
+- session: 3252b490-16ca-40fb-b30c-1171456e2c89
+{"toolName":"Bash","toolInput":{"command":"git commit -m \"$(cat <<'EOF'\nfeat(cli): expand hook coverage to all lifecycle events\n\n- Add SessionStart, Stop, SessionEnd hooks alongside existing UserPromptSubmit and PostToolUse\n- Refactor getHooksConfig with makeHook helper to reduce repetition\n- Add REQUIRED_HOOK_FILES constant and hasHook helper for validation\n- Update install/uninstall/status commands to handle all 5 hooks\n- Add scripts/delete-unknown-projects.js for cleaning orphaned project dirs\n- Add ops:projects:clean-unknown npm script\n- Bump version to 1.0.18\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>\nEOF\n)\"","description":"Commit all staged changes"},"toolOutput":"[main b37aa13] feat(cli): expand hook coverage to all lifecycle events\n 4 files changed, 214 insertions(+), 37 deletions(-)\n create mode 100755 scripts/delete-unknown-projects.js","durationMs":0,"success":true,"metadata":{"command":"git commit","turnId":"5eaeff19-dda2-4bd7-a905-9009b5786672"}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory-layer",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "Claude Code plugin that learns from conversations to provide personalized assistance",
   "main": "dist/index.js",
   "bin": {
@@ -19,7 +19,8 @@
     "ops:sync-gap:heal": "bash scripts/sync-gap-auto-heal.sh",
     "ops:review:resolve": "node scripts/review-queue-auto-resolve.js",
     "ops:heartbeat": "bash scripts/heartbeat-memory-orchestrator.sh",
-    "ops:health": "npm run ops:sync-gap:report && npm run ops:sync-gap:heal && npm run ops:review:resolve"
+    "ops:health": "npm run ops:sync-gap:report && npm run ops:sync-gap:heal && npm run ops:review:resolve",
+    "ops:projects:clean-unknown": "node scripts/delete-unknown-projects.js"
   },
   "keywords": [
     "claude-code",

package/scripts/delete-unknown-projects.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+function parseArgs(argv) {
+  const result = {
+    apply: false,
+    hashes: []
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--apply') {
+      result.apply = true;
+      continue;
+    }
+    if (arg === '--hash' && i + 1 < argv.length) {
+      result.hashes.push(String(argv[i + 1]).trim().toLowerCase());
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith('--hash=')) {
+      result.hashes.push(arg.slice('--hash='.length).trim().toLowerCase());
+    }
+  }
+
+  return result;
+}
+
+function loadRegistryHashes(registryPath) {
+  if (!fs.existsSync(registryPath)) return new Set();
+  try {
+    const raw = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
+    const sessions = raw && typeof raw === 'object' ? raw.sessions : null;
+    if (!sessions || typeof sessions !== 'object') return new Set();
+
+    const hashes = new Set();
+    for (const entry of Object.values(sessions)) {
+      if (!entry || typeof entry !== 'object') continue;
+      const hash = entry.projectHash;
+      if (typeof hash === 'string' && /^[a-f0-9]{8}$/.test(hash)) {
+        hashes.add(hash);
+      }
+    }
+    return hashes;
+  } catch {
+    return new Set();
+  }
+}
+
+function getDirSizeBytes(targetPath) {
+  if (!fs.existsSync(targetPath)) return 0;
+  const stat = fs.statSync(targetPath);
+  if (stat.isFile()) return stat.size;
+  if (!stat.isDirectory()) return 0;
+
+  let total = 0;
+  const entries = fs.readdirSync(targetPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const child = path.join(targetPath, entry.name);
+    if (entry.isDirectory()) {
+      total += getDirSizeBytes(child);
+    } else if (entry.isFile()) {
+      total += fs.statSync(child).size;
+    }
+  }
+  return total;
+}
+
+function formatBytes(bytes) {
+  if (bytes <= 0) return '0 B';
+  const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+  let value = bytes;
+  let unitIdx = 0;
+  while (value >= 1024 && unitIdx < units.length - 1) {
+    value /= 1024;
+    unitIdx += 1;
+  }
+  return `${value.toFixed(1)} ${units[unitIdx]}`;
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const memoryRoot = process.env.CML_MEMORY_ROOT || path.join(os.homedir(), '.claude-code', 'memory');
+  const projectsDir = path.join(memoryRoot, 'projects');
+  const registryPath = path.join(memoryRoot, 'session-registry.json');
+
+  if (!fs.existsSync(projectsDir)) {
+    console.log(JSON.stringify({
+      status: 'skip',
+      reason: 'projects_dir_not_found',
+      projectsDir
+    }, null, 2));
+    process.exit(0);
+  }
+
+  const knownHashes = loadRegistryHashes(registryPath);
+  const filterHashes = new Set(
+    args.hashes.filter((h) => /^[a-f0-9]{8}$/.test(h))
+  );
+
+  const candidates = fs.readdirSync(projectsDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name)
+    .filter((name) => /^[a-f0-9]{8}$/.test(name))
+    .filter((hash) => !knownHashes.has(hash))
+    .filter((hash) => filterHashes.size === 0 || filterHashes.has(hash));
+
+  const projectInfo = candidates.map((hash) => {
+    const fullPath = path.join(projectsDir, hash);
+    const sizeBytes = getDirSizeBytes(fullPath);
+    return {
+      hash,
+      path: fullPath,
+      sizeBytes,
+      sizeHuman: formatBytes(sizeBytes)
+    };
+  });
+
+  const totalBytes = projectInfo.reduce((sum, item) => sum + item.sizeBytes, 0);
+
+  if (!args.apply) {
+    console.log(JSON.stringify({
+      status: 'dry-run',
+      message: 'Run with --apply to delete the directories below.',
+      memoryRoot,
+      projectsDir,
+      registryPath,
+      unknownCount: projectInfo.length,
+      totalSizeBytes: totalBytes,
+      totalSizeHuman: formatBytes(totalBytes),
+      projects: projectInfo
+    }, null, 2));
+    process.exit(0);
+  }
+
+  let deleted = 0;
+  for (const item of projectInfo) {
+    fs.rmSync(item.path, { recursive: true, force: true });
+    deleted += 1;
+  }
+
+  console.log(JSON.stringify({
+    status: 'ok',
+    mode: 'apply',
+    deletedCount: deleted,
+    deletedSizeBytes: totalBytes,
+    deletedSizeHuman: formatBytes(totalBytes),
+    deletedHashes: projectInfo.map((item) => item.hash)
+  }, null, 2));
+}
+
+main();

package/src/cli/index.ts

@@ -814,6 +814,7 @@ program
   .option('-a, --all', 'Import all sessions from all projects')
   .option('-l, --limit <number>', 'Limit messages per session')
   .option('-f, --force', 'Force reimport: delete existing events and reimport with turn_id grouping')
+  .option('--embedding-model <name>', 'Embedding model override (default: jinaai/jina-embeddings-v5-text-nano, or env CLAUDE_MEMORY_EMBEDDING_MODEL)')
   .option('-v, --verbose', 'Show detailed progress')
   .action(async (options) => {
     const startTime = Date.now();
@@ -821,6 +822,10 @@ program
     // Determine target project path for storage
     const targetProjectPath = options.project || process.cwd();
 
+    if (options.embeddingModel) {
+      process.env.CLAUDE_MEMORY_EMBEDDING_MODEL = options.embeddingModel;
+    }
+
     // Use project-specific memory service
     const service = getMemoryServiceForProject(targetProjectPath);
     const importer = createSessionHistoryImporter(service);
@@ -835,7 +840,16 @@ program
     try {
       console.log('\n⏳ Initializing memory service...');
       await service.initialize();
-      console.log('  ✅ Ready\n');
+      console.log(`  ✅ Ready (embedder: ${service.getEmbeddingModelName()})\n`);
+
+      const migration = await service.ensureEmbeddingModelForImport({ autoMigrate: true });
+      if (migration.changed) {
+        console.log('🔁 Embedding model migration detected/required');
+        console.log(`   Previous: ${migration.previousModel || 'legacy-unknown'}`);
+        console.log(`   Current:  ${migration.currentModel}`);
+        console.log(`   Re-queued embeddings: ${migration.enqueued}`);
+        console.log('   (Import will continue and process embeddings with the new model)\n');
+      }
 
       if (options.force) {
         console.log('🔄 Force mode: existing events will be deleted and reimported with turn_id grouping\n');
@@ -862,6 +876,14 @@ program
         const globalService = getDefaultMemoryService();
         const globalImporter = createSessionHistoryImporter(globalService);
         await globalService.initialize();
+        console.log(`  ✅ Global service ready (embedder: ${globalService.getEmbeddingModelName()})`);
+        const globalMigration = await globalService.ensureEmbeddingModelForImport({ autoMigrate: true });
+        if (globalMigration.changed) {
+          console.log('🔁 Global embedding migration detected');
+          console.log(`   Previous: ${globalMigration.previousModel || 'legacy-unknown'}`);
+          console.log(`   Current:  ${globalMigration.currentModel}`);
+          console.log(`   Re-queued embeddings: ${globalMigration.enqueued}`);
+        }
         result = await globalImporter.importAll(importOpts);
 
         // Process embeddings

package/src/core/embedder.ts

@@ -16,7 +16,7 @@ export class Embedder {
   private readonly modelName: string;
   private initialized = false;
 
-  constructor(modelName: string = 'Xenova/all-MiniLM-L6-v2') {
+  constructor(modelName: string = 'jinaai/jina-embeddings-v5-text-nano') {
     this.modelName = modelName;
   }
 
@@ -117,8 +117,9 @@ export class Embedder {
 let defaultEmbedder: Embedder | null = null;
 
 export function getDefaultEmbedder(): Embedder {
+  const envModel = process.env.CLAUDE_MEMORY_EMBEDDING_MODEL;
   if (!defaultEmbedder) {
-    defaultEmbedder = new Embedder();
+    defaultEmbedder = new Embedder(envModel || undefined);
   }
   return defaultEmbedder;
 }

package/src/core/sqlite-event-store.ts

@@ -865,6 +865,38 @@ export class SQLiteEventStore {
     );
   }
 
+  /**
+   * Clear embedding outbox (used for embedding model migration)
+   */
+  async clearEmbeddingOutbox(): Promise<void> {
+    await this.initialize();
+    sqliteRun(this.db, `DELETE FROM embedding_outbox`);
+  }
+
+  /**
+   * Count total events
+   */
+  async countEvents(): Promise<number> {
+    await this.initialize();
+    const row = sqliteGet<{ count: number }>(this.db, `SELECT COUNT(*) as count FROM events`);
+    return row?.count || 0;
+  }
+
+  /**
+   * Get events page in timestamp ascending order (stable migration/reindex scans)
+   */
+  async getEventsPage(limit: number = 1000, offset: number = 0): Promise<MemoryEvent[]> {
+    await this.initialize();
+
+    const rows = sqliteAll<Record<string, unknown>>(
+      this.db,
+      `SELECT * FROM events ORDER BY timestamp ASC LIMIT ? OFFSET ?`,
+      [limit, offset]
+    );
+
+    return rows.map(this.rowToEvent);
+  }
+
   /**
    * Mark outbox items as failed
    */

package/src/core/types.ts

@@ -152,8 +152,8 @@ export const ConfigSchema = z.object({
   }).default({}),
   embedding: z.object({
     provider: z.enum(['local', 'openai']).default('local'),
-    model: z.string().default('Xenova/all-MiniLM-L6-v2'),
-    openaiModel: z.string().default('text-embedding-3-small'),
+    model: z.string().default('jinaai/jina-embeddings-v5-text-nano'),
+    openaiModel: z.string().default('jinaai/jina-embeddings-v5-text-nano'),
     batchSize: z.number().default(32)
   }).default({}),
   retrieval: z.object({

package/src/core/vector-store.ts

@@ -194,6 +194,26 @@ export class VectorStore {
     return result;
   }
 
+  /**
+   * Clear all vectors (used for embedding model migration)
+   */
+  async clearAll(): Promise<void> {
+    await this.initialize();
+    if (!this.db) return;
+
+    try {
+      if (typeof (this.db as any).dropTable === 'function') {
+        await (this.db as any).dropTable(this.tableName);
+      } else if (typeof (this.db as any).drop_table === 'function') {
+        await (this.db as any).drop_table(this.tableName);
+      }
+    } catch {
+      // Ignore if table does not exist
+    }
+
+    this.table = null;
+  }
+
   /**
    * Check if vector exists for event
    */