claude-memory-layer 1.0.26 → 1.0.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (328) hide show
  1. package/.env.example +7 -0
  2. package/AGENTS.md +11 -0
  3. package/README.md +184 -41
  4. package/benchmarks/replay/anonymized-real-sessions.json +48 -0
  5. package/dist/cli/index.js +10097 -6003
  6. package/dist/cli/index.js.map +4 -4
  7. package/dist/core/index.js +9745 -5587
  8. package/dist/core/index.js.map +4 -4
  9. package/dist/hooks/post-tool-use.js +6545 -5270
  10. package/dist/hooks/post-tool-use.js.map +4 -4
  11. package/dist/hooks/semantic-daemon.js +6646 -5354
  12. package/dist/hooks/semantic-daemon.js.map +4 -4
  13. package/dist/hooks/session-end.js +6618 -5347
  14. package/dist/hooks/session-end.js.map +4 -4
  15. package/dist/hooks/session-start.js +6619 -5354
  16. package/dist/hooks/session-start.js.map +4 -4
  17. package/dist/hooks/stop.js +6614 -5325
  18. package/dist/hooks/stop.js.map +4 -4
  19. package/dist/hooks/user-prompt-submit.js +6702 -5356
  20. package/dist/hooks/user-prompt-submit.js.map +4 -4
  21. package/dist/index.js +13537 -0
  22. package/dist/index.js.map +7 -0
  23. package/dist/mcp/index.js +20770 -0
  24. package/dist/mcp/index.js.map +7 -0
  25. package/dist/server/api/index.js +6632 -5319
  26. package/dist/server/api/index.js.map +4 -4
  27. package/dist/server/index.js +6667 -5340
  28. package/dist/server/index.js.map +4 -4
  29. package/dist/services/memory-service.js +6568 -5350
  30. package/dist/services/memory-service.js.map +4 -4
  31. package/dist/ui/assets/js/bootstrap.js +244 -0
  32. package/dist/ui/assets/js/chat.js +373 -0
  33. package/dist/ui/assets/js/disclosure.js +232 -0
  34. package/dist/ui/assets/js/modals.js +298 -0
  35. package/dist/ui/assets/js/overview.js +655 -0
  36. package/dist/ui/assets/js/state.js +72 -0
  37. package/dist/ui/assets/js/views.js +468 -0
  38. package/dist/ui/index.html +43 -1
  39. package/dist/ui/index.ts +3 -0
  40. package/dist/ui/style.css +222 -0
  41. package/docs/ARCHITECTURE_COMPARISON_AND_RECOMMENDATIONS.md +627 -0
  42. package/docs/HERMES_MEMORY_INGESTION_ANALYSIS.md +440 -0
  43. package/docs/MEMORY_USEFULNESS_AUDIT.md +371 -0
  44. package/docs/MEMORY_USEFULNESS_AUDIT_RAW.json +80 -0
  45. package/docs/MEMSEARCH_PROJECT_STRUCTURE_ANALYSIS.md +333 -0
  46. package/docs/PRODUCT_VALIDATION_MATRIX.md +82 -0
  47. package/docs/PROJECT_STRUCTURE_ANALYSIS.md +421 -0
  48. package/docs/REFACTORING_MILESTONES_AND_ISSUES.md +501 -0
  49. package/docs/REFACTORING_PLAN_THIN_CORE.md +414 -0
  50. package/docs/REFERENCE_PROJECT_ANALYSES.md +25 -0
  51. package/docs/SUPERLOCALMEMORY_PROJECT_STRUCTURE_ANALYSIS.md +452 -0
  52. package/docs/TARGET_ARCHITECTURE_AND_FOLDER_STRUCTURE.md +446 -0
  53. package/docs/architecture/comparison-index.md +47 -0
  54. package/docs/reports/codex-real-data-validation-20260505T040447Z.md +46 -0
  55. package/package.json +9 -5
  56. package/scripts/build.ts +25 -8
  57. package/scripts/generate-session-qrels.ts +126 -0
  58. package/scripts/replay-retrieval-benchmark.ts +69 -0
  59. package/specs/thin-core-refactor/context.md +275 -0
  60. package/specs/thin-core-refactor/plan.md +536 -0
  61. package/specs/thin-core-refactor/spec.md +465 -0
  62. package/src/adapters/claude/capture/index.ts +3 -0
  63. package/src/adapters/claude/context/index.ts +3 -0
  64. package/src/adapters/claude/hooks/index.ts +21 -0
  65. package/src/adapters/claude/hooks/post-tool-use.ts +239 -0
  66. package/src/adapters/claude/hooks/prompt-injection-policy.ts +104 -0
  67. package/src/adapters/claude/hooks/semantic-daemon-client.ts +209 -0
  68. package/src/adapters/claude/hooks/semantic-daemon.ts +283 -0
  69. package/src/adapters/claude/hooks/session-end.ts +59 -0
  70. package/src/adapters/claude/hooks/session-start.ts +73 -0
  71. package/src/adapters/claude/hooks/stop.ts +128 -0
  72. package/src/adapters/claude/hooks/user-prompt-submit.ts +361 -0
  73. package/src/adapters/claude/index.ts +4 -0
  74. package/src/adapters/claude/transcript/index.ts +4 -0
  75. package/src/adapters/claude/transcript/transcript-reader.ts +57 -0
  76. package/src/adapters/claude/transcript/turn-reconstructor.ts +65 -0
  77. package/src/apps/cli/claude-settings-hooks.ts +138 -0
  78. package/src/apps/cli/codex-import-runner.ts +125 -0
  79. package/src/apps/cli/codex-validation-output.ts +95 -0
  80. package/src/apps/cli/hermes-import-runner.ts +130 -0
  81. package/src/apps/cli/hermes-validation-output.ts +91 -0
  82. package/src/apps/cli/index.ts +1731 -0
  83. package/src/apps/cli/mcp-install.ts +106 -0
  84. package/src/apps/cli/retrieval-disclosure-output.ts +196 -0
  85. package/src/apps/dashboard/assets/js/bootstrap.js +244 -0
  86. package/src/apps/dashboard/assets/js/chat.js +373 -0
  87. package/src/apps/dashboard/assets/js/disclosure.js +232 -0
  88. package/src/apps/dashboard/assets/js/modals.js +298 -0
  89. package/src/apps/dashboard/assets/js/overview.js +655 -0
  90. package/src/apps/dashboard/assets/js/state.js +72 -0
  91. package/src/apps/dashboard/assets/js/views.js +468 -0
  92. package/src/{ui → apps/dashboard}/index.html +43 -1
  93. package/src/apps/dashboard/index.ts +3 -0
  94. package/src/{ui → apps/dashboard}/style.css +222 -0
  95. package/src/apps/index.ts +5 -0
  96. package/src/apps/server/api/chat.ts +244 -0
  97. package/src/apps/server/api/citations.ts +105 -0
  98. package/src/apps/server/api/events.ts +137 -0
  99. package/src/apps/server/api/health.ts +53 -0
  100. package/src/apps/server/api/index.ts +26 -0
  101. package/src/apps/server/api/projects.ts +74 -0
  102. package/src/apps/server/api/search.ts +184 -0
  103. package/src/apps/server/api/sessions.ts +115 -0
  104. package/src/apps/server/api/stats.ts +723 -0
  105. package/src/apps/server/api/turns.ts +143 -0
  106. package/src/apps/server/api/utils.ts +65 -0
  107. package/src/apps/server/index.ts +111 -0
  108. package/src/cli/index.ts +2 -1311
  109. package/src/cli/retrieval-disclosure-output.ts +2 -0
  110. package/src/compat/index.ts +5 -0
  111. package/src/core/derive/fact-deriver.ts +170 -0
  112. package/src/core/derive/index.ts +2 -0
  113. package/src/core/derive/summary-deriver.ts +76 -0
  114. package/src/core/embedder.ts +4 -152
  115. package/src/core/engine/embedding-maintenance-service.ts +187 -0
  116. package/src/core/engine/endless-memory-services.ts +4 -0
  117. package/src/core/engine/index.ts +19 -0
  118. package/src/core/engine/memory-engine-services.ts +170 -0
  119. package/src/core/engine/memory-ingest-service.ts +317 -0
  120. package/src/core/engine/memory-query-service.ts +173 -0
  121. package/src/core/engine/memory-runtime-service.ts +162 -0
  122. package/src/core/engine/memory-service-composition.ts +231 -0
  123. package/src/core/engine/retrieval-analytics-service.ts +181 -0
  124. package/src/core/engine/retrieval-disclosure-service.ts +420 -0
  125. package/src/core/engine/retrieval-orchestrator.ts +377 -0
  126. package/src/core/engine/retrieval-services.ts +176 -0
  127. package/src/core/engine/shared-memory-services.ts +4 -0
  128. package/src/core/entity-repo.ts +1 -3
  129. package/src/core/event-store.ts +3 -3
  130. package/src/core/evidence-aligner.ts +2 -2
  131. package/src/core/external-market-context.ts +582 -0
  132. package/src/core/graduation.ts +2 -3
  133. package/src/core/index.ts +21 -0
  134. package/src/core/matcher.ts +2 -4
  135. package/src/core/model/memory-fact.ts +30 -0
  136. package/src/core/model/memory-rule.ts +14 -0
  137. package/src/core/model/memory-summary.ts +21 -0
  138. package/src/core/model/raw-event.ts +28 -0
  139. package/src/core/model/retrieval-result.ts +35 -0
  140. package/src/core/privacy/filter.ts +21 -10
  141. package/src/core/product-validation-matrix.ts +314 -0
  142. package/src/core/progressive-retriever.ts +1 -2
  143. package/src/core/registry/project-path.ts +54 -0
  144. package/src/core/registry/session-registry.ts +69 -0
  145. package/src/core/replay-evaluator.ts +625 -0
  146. package/src/core/retrieval-benchmark.ts +117 -0
  147. package/src/core/retrieval-quality.ts +109 -0
  148. package/src/core/retriever.ts +53 -15
  149. package/src/core/session-qrels.ts +360 -0
  150. package/src/core/shared-event-store.ts +1 -1
  151. package/src/core/sqlite-event-store.ts +35 -11
  152. package/src/core/task/blocker-resolver.ts +2 -2
  153. package/src/core/task/task-resolver.ts +0 -1
  154. package/src/core/vector-outbox.ts +1 -10
  155. package/src/core/vector-worker.ts +1 -1
  156. package/src/extensions/endless-memory/endless-memory-services.ts +350 -0
  157. package/src/extensions/endless-memory/index.ts +1 -0
  158. package/src/extensions/index.ts +5 -0
  159. package/src/extensions/mcp/handlers.ts +960 -0
  160. package/src/extensions/mcp/index.ts +48 -0
  161. package/src/extensions/mcp/tools.ts +252 -0
  162. package/src/extensions/shared-memory/index.ts +1 -0
  163. package/src/extensions/shared-memory/shared-memory-services.ts +211 -0
  164. package/src/extensions/vector/embedder.ts +197 -0
  165. package/src/extensions/vector/index.ts +1 -0
  166. package/src/hooks/post-tool-use.ts +3 -236
  167. package/src/hooks/semantic-daemon-client.ts +1 -208
  168. package/src/hooks/semantic-daemon.ts +6 -271
  169. package/src/hooks/session-end.ts +4 -79
  170. package/src/hooks/session-start.ts +4 -73
  171. package/src/hooks/stop.ts +3 -173
  172. package/src/hooks/user-prompt-submit.ts +3 -338
  173. package/src/index.ts +13 -0
  174. package/src/mcp/handlers.ts +2 -212
  175. package/src/mcp/index.ts +3 -46
  176. package/src/mcp/tools.ts +2 -78
  177. package/src/server/api/chat.ts +2 -244
  178. package/src/server/api/citations.ts +2 -105
  179. package/src/server/api/events.ts +2 -137
  180. package/src/server/api/health.ts +2 -53
  181. package/src/server/api/index.ts +2 -26
  182. package/src/server/api/projects.ts +2 -74
  183. package/src/server/api/search.ts +2 -102
  184. package/src/server/api/sessions.ts +2 -115
  185. package/src/server/api/stats.ts +2 -724
  186. package/src/server/api/turns.ts +2 -143
  187. package/src/server/api/utils.ts +2 -46
  188. package/src/server/index.ts +2 -100
  189. package/src/services/bootstrap-organizer.ts +46 -26
  190. package/src/services/codex-session-history-importer.ts +521 -29
  191. package/src/services/hermes-session-history-importer.ts +733 -0
  192. package/src/services/memory-service-config.ts +36 -0
  193. package/src/services/memory-service-registry.ts +150 -0
  194. package/src/services/memory-service.ts +211 -1325
  195. package/src/services/session-history-importer.ts +58 -14
  196. package/tests/README.md +23 -0
  197. package/tests/adapters/claude/claude-semantic-daemon-adapter.test.ts +54 -0
  198. package/tests/adapters/claude/claude-transcript-reconstructor.test.ts +98 -0
  199. package/tests/adapters/claude-hook-prompt-injection-policy.test.ts +99 -0
  200. package/tests/apps/app-layer-boundary.test.ts +48 -0
  201. package/tests/apps/claude-settings-hooks.test.ts +107 -0
  202. package/tests/apps/cli-disclosure-output.test.ts +212 -0
  203. package/tests/apps/codex-import-runner.test.ts +99 -0
  204. package/tests/apps/codex-validation-output.test.ts +100 -0
  205. package/tests/apps/hermes-import-runner.test.ts +99 -0
  206. package/tests/apps/mcp-install-command.test.ts +59 -0
  207. package/tests/apps/package-build-entrypoints.test.ts +30 -0
  208. package/tests/apps/search-api-disclosure.test.ts +162 -0
  209. package/tests/apps/stats-api-lightweight.test.ts +67 -0
  210. package/tests/apps/ui-disclosure-output.test.ts +140 -0
  211. package/tests/{bootstrap-organizer.test.ts → core/bootstrap-organizer.test.ts} +1 -1
  212. package/tests/{canonical-key.test.ts → core/canonical-key.test.ts} +1 -1
  213. package/tests/core/codex-session-history-importer-validation.test.ts +185 -0
  214. package/tests/{consolidation-worker.test.ts → core/consolidation-worker.test.ts} +2 -2
  215. package/tests/core/embedding-maintenance-service.test.ts +282 -0
  216. package/tests/{evidence-aligner.test.ts → core/evidence-aligner.test.ts} +1 -1
  217. package/tests/core/external-market-context.test.ts +209 -0
  218. package/tests/core/fact-deriver.test.ts +79 -0
  219. package/tests/core/hermes-session-history-importer-validation.test.ts +609 -0
  220. package/tests/{ingest-interceptor.test.ts → core/ingest-interceptor.test.ts} +1 -1
  221. package/tests/{markdown-mirror.test.ts → core/markdown-mirror.test.ts} +2 -2
  222. package/tests/{matcher.test.ts → core/matcher.test.ts} +1 -1
  223. package/tests/{md-mirror.test.ts → core/md-mirror.test.ts} +2 -2
  224. package/tests/core/memory-engine-services.test.ts +240 -0
  225. package/tests/core/memory-ingest-service.test.ts +296 -0
  226. package/tests/core/memory-query-service.test.ts +129 -0
  227. package/tests/core/memory-runtime-service.test.ts +201 -0
  228. package/tests/core/memory-service-composition.test.ts +192 -0
  229. package/tests/core/memory-service-config.test.ts +41 -0
  230. package/tests/core/memory-service-facade.test.ts +30 -0
  231. package/tests/core/memory-service-registry.test.ts +206 -0
  232. package/tests/core/product-validation-matrix.test.ts +61 -0
  233. package/tests/core/project-registry.test.ts +78 -0
  234. package/tests/core/replay-evaluator.test.ts +181 -0
  235. package/tests/core/retrieval-analytics-service.test.ts +210 -0
  236. package/tests/core/retrieval-benchmark.test.ts +93 -0
  237. package/tests/core/retrieval-disclosure-service.test.ts +264 -0
  238. package/tests/core/retrieval-orchestrator.test.ts +403 -0
  239. package/tests/core/retrieval-quality.test.ts +31 -0
  240. package/tests/core/retrieval-services.test.ts +185 -0
  241. package/tests/{retriever-fallback-chain.test.ts → core/retriever-fallback-chain.test.ts} +3 -3
  242. package/tests/{retriever-strategy-scope.test.ts → core/retriever-strategy-scope.test.ts} +70 -3
  243. package/tests/{retriever.memu-adoption.test.ts → core/retriever.memu-adoption.test.ts} +3 -3
  244. package/tests/core/session-history-importer-filter.test.ts +78 -0
  245. package/tests/core/session-qrels.test.ts +250 -0
  246. package/tests/{sqlite-event-store-replication.test.ts → core/sqlite-event-store-replication.test.ts} +36 -1
  247. package/tests/core/summary-deriver.test.ts +66 -0
  248. package/tests/extensions/embedder-warning-suppression.test.ts +53 -0
  249. package/tests/extensions/endless-memory-extension-boundary.test.ts +17 -0
  250. package/tests/extensions/endless-memory-services.test.ts +325 -0
  251. package/tests/extensions/mcp-context-tools.test.ts +905 -0
  252. package/tests/extensions/mcp-extension-boundary.test.ts +21 -0
  253. package/tests/extensions/mcp-package-build.test.ts +22 -0
  254. package/tests/extensions/mcp-project-aware-tools.test.ts +102 -0
  255. package/tests/extensions/shared-memory-extension-boundary.test.ts +24 -0
  256. package/tests/extensions/shared-memory-services.test.ts +309 -0
  257. package/tests/extensions/vector-extension-boundary.test.ts +21 -0
  258. package/.claude/settings.local.json +0 -25
  259. package/.npm-cache/_cacache/content-v2/sha512/04/76/c098f88dfe584a2b80870bff7421b05d17d3d9ee1027f77772332a22d3f93a9a57101a2855107f6ad82077a818bba912b2bc317f2361b5ddb09ad284d9ce +0 -0
  260. package/.npm-cache/_cacache/content-v2/sha512/60/25/d2ecd39cfc7cab58351162814be77f935c6d6491c10c3745d456da7ddb2117ffd90c10e53fe3c0f1ed16b403307841543634504398b16ee4e6b6dd8e0c45 +0 -0
  261. package/.npm-cache/_cacache/index-v5/2b/9a/7f8f40206ed8a2e0a84efaa953ccaed1f5d001e14b931083f2e7a0738007 +0 -2
  262. package/.npm-cache/_cacache/index-v5/2e/d9/fcfa5c6a6abdc2a3644ab84a95936047298c465a2f47ee03db8f7fe1e946 +0 -3
  263. package/.npm-cache/_cacache/index-v5/a9/42/e519633356d12d3d2f19da66a8301016d496c8f5c3e0554124aaa62dc043 +0 -2
  264. package/.npm-cache/_logs/2026-02-26T12_04_52_729Z-debug-0.log +0 -256
  265. package/.npm-cache/_logs/2026-02-26T12_05_36_835Z-debug-0.log +0 -18
  266. package/.npm-cache/_logs/2026-02-26T12_05_45_982Z-debug-0.log +0 -32
  267. package/.npm-cache/_logs/2026-02-26T12_05_48_515Z-debug-0.log +0 -260
  268. package/.npm-cache/_logs/2026-02-26T12_05_53_567Z-debug-0.log +0 -69
  269. package/.npm-cache/_update-notifier-last-checked +0 -0
  270. package/bootstrap-kb/decisions/decisions.md +0 -244
  271. package/bootstrap-kb/glossary/glossary.md +0 -46
  272. package/bootstrap-kb/modules/.claude-plugin.md +0 -22
  273. package/bootstrap-kb/modules/agents.md.md +0 -15
  274. package/bootstrap-kb/modules/claude.md.md +0 -15
  275. package/bootstrap-kb/modules/context.md.md +0 -15
  276. package/bootstrap-kb/modules/docs.md +0 -18
  277. package/bootstrap-kb/modules/handoff.md.md +0 -15
  278. package/bootstrap-kb/modules/package-lock.json.md +0 -15
  279. package/bootstrap-kb/modules/package.json.md +0 -15
  280. package/bootstrap-kb/modules/plan.md.md +0 -15
  281. package/bootstrap-kb/modules/readme.md.md +0 -15
  282. package/bootstrap-kb/modules/scripts.md +0 -26
  283. package/bootstrap-kb/modules/spec.md.md +0 -15
  284. package/bootstrap-kb/modules/specs.md +0 -20
  285. package/bootstrap-kb/modules/src.md +0 -51
  286. package/bootstrap-kb/modules/tests.md +0 -42
  287. package/bootstrap-kb/modules/tsconfig.json.md +0 -15
  288. package/bootstrap-kb/modules/vitest.config.ts.md +0 -15
  289. package/bootstrap-kb/overview/overview.md +0 -40
  290. package/bootstrap-kb/sources/manifest.json +0 -950
  291. package/bootstrap-kb/sources/manifest.md +0 -227
  292. package/bootstrap-kb/timeline/timeline.md +0 -57
  293. package/claude-memory-layer-1.0.14.tgz +0 -0
  294. package/d.sh +0 -3
  295. package/deploy.sh +0 -3
  296. package/dist/ui/app.js +0 -2101
  297. package/memory/.claude-plugin/commands/2026-02-25.md +0 -263
  298. package/memory/_index.md +0 -418
  299. package/memory/agent_response/uncategorized/2026-02-26.md +0 -176
  300. package/memory/agent_response/uncategorized/2026-03-03.md +0 -14
  301. package/memory/agent_response/uncategorized/2026-03-04.md +0 -1421
  302. package/memory/agent_response/uncategorized/2026-03-05.md +0 -48
  303. package/memory/default/uncategorized/2026-02-25.md +0 -4839
  304. package/memory/session_summary/uncategorized/2026-02-26.md +0 -13
  305. package/memory/session_summary/uncategorized/2026-03-03.md +0 -5
  306. package/memory/session_summary/uncategorized/2026-03-04.md +0 -50
  307. package/memory/specs/20260207-dashboard-upgrade/2026-02-25.md +0 -142
  308. package/memory/specs/citations-system/2026-02-25.md +0 -1121
  309. package/memory/specs/endless-mode/2026-02-25.md +0 -1392
  310. package/memory/specs/entity-edge-model/2026-02-25.md +0 -1263
  311. package/memory/specs/evidence-aligner-v2/2026-02-25.md +0 -1028
  312. package/memory/specs/mcp-desktop-integration/2026-02-25.md +0 -1334
  313. package/memory/specs/post-tool-use-hook/2026-02-25.md +0 -1164
  314. package/memory/specs/private-tags/2026-02-25.md +0 -1057
  315. package/memory/specs/progressive-disclosure/2026-02-25.md +0 -1436
  316. package/memory/specs/task-entity-system/2026-02-25.md +0 -924
  317. package/memory/specs/vector-outbox-v2/2026-02-25.md +0 -1510
  318. package/memory/specs/web-viewer-ui/2026-02-25.md +0 -1709
  319. package/memory/tool_observation/uncategorized/2026-02-26.md +0 -209
  320. package/memory/tool_observation/uncategorized/2026-03-03.md +0 -21
  321. package/memory/tool_observation/uncategorized/2026-03-04.md +0 -1033
  322. package/memory/tool_observation/uncategorized/2026-03-05.md +0 -29
  323. package/memory/user_prompt/uncategorized/2026-02-26.md +0 -25
  324. package/memory/user_prompt/uncategorized/2026-03-04.md +0 -634
  325. package/specs/optional-duckdb/context.md +0 -77
  326. package/specs/optional-duckdb/plan.md +0 -142
  327. package/specs/optional-duckdb/spec.md +0 -35
  328. package/src/ui/app.js +0 -2101
@@ -0,0 +1,609 @@
1
+ import Database = require('better-sqlite3');
2
+ import { mkdtempSync, rmSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import { afterEach, describe, expect, it, vi } from 'vitest';
6
+
7
+ import {
8
+ createHermesSessionHistoryImporter,
9
+ HERMES_IMPORTABLE_SESSION_SCAN_FACTOR,
10
+ validateHermesSessions
11
+ } from '../../src/services/hermes-session-history-importer.js';
12
+
13
+ const tempDirs: string[] = [];
14
+
15
+ function tempDir() {
16
+ const dir = mkdtempSync(join(tmpdir(), 'cml-hermes-validation-'));
17
+ tempDirs.push(dir);
18
+ return dir;
19
+ }
20
+
21
+ function createHermesStateDb(dbPath: string, projectA: string, projectB: string) {
22
+ const db = new Database(dbPath);
23
+ db.exec(`
24
+ CREATE TABLE sessions (
25
+ id TEXT PRIMARY KEY,
26
+ source TEXT NOT NULL,
27
+ user_id TEXT,
28
+ model TEXT,
29
+ model_config TEXT,
30
+ system_prompt TEXT,
31
+ parent_session_id TEXT,
32
+ started_at REAL NOT NULL,
33
+ ended_at REAL,
34
+ end_reason TEXT,
35
+ message_count INTEGER DEFAULT 0,
36
+ tool_call_count INTEGER DEFAULT 0,
37
+ title TEXT
38
+ );
39
+
40
+ CREATE TABLE messages (
41
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
42
+ session_id TEXT NOT NULL,
43
+ role TEXT NOT NULL,
44
+ content TEXT,
45
+ tool_call_id TEXT,
46
+ tool_calls TEXT,
47
+ tool_name TEXT,
48
+ timestamp REAL NOT NULL,
49
+ token_count INTEGER,
50
+ finish_reason TEXT,
51
+ reasoning TEXT,
52
+ reasoning_content TEXT,
53
+ reasoning_details TEXT,
54
+ codex_reasoning_items TEXT,
55
+ codex_message_items TEXT
56
+ );
57
+ `);
58
+
59
+ const insertSession = db.prepare(`
60
+ INSERT INTO sessions (id, source, user_id, model, system_prompt, started_at, title, message_count)
61
+ VALUES (@id, @source, @userId, @model, @systemPrompt, @startedAt, @title, @messageCount)
62
+ `);
63
+ const insertMessage = db.prepare(`
64
+ INSERT INTO messages (session_id, role, content, tool_name, timestamp)
65
+ VALUES (@sessionId, @role, @content, @toolName, @timestamp)
66
+ `);
67
+
68
+ insertSession.run({
69
+ id: 'session-a',
70
+ source: 'discord',
71
+ userId: 'user-a',
72
+ model: 'gpt-5.5',
73
+ systemPrompt: `Project Context\nCurrent Session Context\n${projectA}`,
74
+ startedAt: 1_779_000_000,
75
+ title: 'claude-memory-layer thread',
76
+ messageCount: 4
77
+ });
78
+ insertMessage.run({
79
+ sessionId: 'session-a',
80
+ role: 'user',
81
+ content: `please build Hermes SessionDB adapter password=sensitive-fixture-value for ${projectA}`,
82
+ toolName: null,
83
+ timestamp: 1_779_000_001
84
+ });
85
+ insertMessage.run({
86
+ sessionId: 'session-a',
87
+ role: 'assistant',
88
+ content: 'implemented a safe adapter with token=sensitive-fixture-value and no live sync by default',
89
+ toolName: null,
90
+ timestamp: 1_779_000_002
91
+ });
92
+ insertMessage.run({
93
+ sessionId: 'session-a',
94
+ role: 'tool',
95
+ content: 'raw terminal output should never be imported',
96
+ toolName: 'terminal',
97
+ timestamp: 1_779_000_003
98
+ });
99
+ insertMessage.run({
100
+ sessionId: 'session-a',
101
+ role: 'assistant',
102
+ content: '',
103
+ toolName: null,
104
+ timestamp: 1_779_000_004
105
+ });
106
+
107
+ insertSession.run({
108
+ id: 'session-b',
109
+ source: 'discord',
110
+ userId: 'user-b',
111
+ model: 'gpt-5.5',
112
+ systemPrompt: `Project Context\n${projectB}`,
113
+ startedAt: 1_779_000_100,
114
+ title: 'other project thread',
115
+ messageCount: 1
116
+ });
117
+ insertMessage.run({
118
+ sessionId: 'session-b',
119
+ role: 'user',
120
+ content: 'this belongs to another project and should not match project a',
121
+ toolName: null,
122
+ timestamp: 1_779_000_101
123
+ });
124
+
125
+ insertSession.run({
126
+ id: 'session-no-project',
127
+ source: 'cli',
128
+ userId: 'user-c',
129
+ model: 'gpt-5.5',
130
+ systemPrompt: null,
131
+ startedAt: 1_779_000_200,
132
+ title: null,
133
+ messageCount: 1
134
+ });
135
+ insertMessage.run({
136
+ sessionId: 'session-no-project',
137
+ role: 'user',
138
+ content: 'session without project context should be counted as missing context',
139
+ toolName: null,
140
+ timestamp: 1_779_000_201
141
+ });
142
+
143
+ db.close();
144
+ }
145
+
146
+ afterEach(() => {
147
+ for (const dir of tempDirs.splice(0)) {
148
+ rmSync(dir, { recursive: true, force: true });
149
+ }
150
+ });
151
+
152
+ describe('Hermes SessionDB validation/import', () => {
153
+ it('dry-runs matching Hermes sessions by project context without exposing transcript content', async () => {
154
+ const dir = tempDir();
155
+ const stateDbPath = join(dir, 'state.db');
156
+ const projectA = join(dir, 'project-a');
157
+ const projectB = join(dir, 'project-b');
158
+ createHermesStateDb(stateDbPath, projectA, projectB);
159
+
160
+ const report = await validateHermesSessions({
161
+ stateDbPath,
162
+ projectPath: projectA,
163
+ now: new Date('2026-05-05T00:00:00.000Z')
164
+ });
165
+
166
+ expect(report.dryRun).toBe(true);
167
+ expect(report.willMutate).toBe(false);
168
+ expect(report.source.stateDbPath).toBe(stateDbPath);
169
+ expect(report.source.projectPath).toBe(projectA);
170
+ expect(report.source.projectFilterApplied).toBe(true);
171
+ expect(report.totals.sessionsScanned).toBe(3);
172
+ expect(report.totals.sessionsMatched).toBe(1);
173
+ expect(report.totals.messagesRead).toBe(4);
174
+ expect(report.totals.messagesNormalized).toBe(2);
175
+ expect(report.totals.turnsNormalized).toBe(1);
176
+ expect(report.totals.userMessages).toBe(1);
177
+ expect(report.totals.assistantMessages).toBe(1);
178
+ expect(report.totals.skippedUnsupportedMessages).toBe(1);
179
+ expect(report.totals.emptyAssistantMessages).toBe(1);
180
+ expect(report.totals.missingProjectContext).toBe(1);
181
+ expect(report.topSources[0]).toMatchObject({ source: 'discord', sessions: 1, userMessages: 1, assistantMessages: 1 });
182
+
183
+ const serialized = JSON.stringify(report);
184
+ expect(serialized).not.toContain('please build Hermes SessionDB adapter');
185
+ expect(serialized).not.toContain('implemented a safe adapter');
186
+ expect(serialized).not.toContain('sensitive-fixture-value');
187
+ expect(serialized).not.toContain('raw terminal output');
188
+ expect(serialized).not.toContain('another project');
189
+ });
190
+
191
+ it('imports only matched user/assistant turns, redacts secrets, and skips tool messages', async () => {
192
+ const dir = tempDir();
193
+ const stateDbPath = join(dir, 'state.db');
194
+ const projectA = join(dir, 'project-a');
195
+ const projectB = join(dir, 'project-b');
196
+ createHermesStateDb(stateDbPath, projectA, projectB);
197
+
198
+ const memoryService = {
199
+ startSession: vi.fn(async (_sessionId: string, _projectPath?: string) => undefined),
200
+ endSession: vi.fn(async (_sessionId: string) => undefined),
201
+ deleteSessionEvents: vi.fn(async (_sessionId: string) => 0),
202
+ storeUserPrompt: vi.fn(async (
203
+ _sessionId: string,
204
+ _content: string,
205
+ _metadata?: Record<string, unknown>
206
+ ) => ({ success: true, isDuplicate: false })),
207
+ storeAgentResponse: vi.fn(async (
208
+ _sessionId: string,
209
+ _content: string,
210
+ _metadata?: Record<string, unknown>
211
+ ) => ({ success: true, isDuplicate: false }))
212
+ };
213
+
214
+ const importer = createHermesSessionHistoryImporter(memoryService as never, { stateDbPath });
215
+ const result = await importer.importProject(projectA, { force: true });
216
+
217
+ expect(memoryService.deleteSessionEvents).toHaveBeenCalledWith('hermes:session-a');
218
+ expect(memoryService.startSession).toHaveBeenCalledWith('hermes:session-a', projectA);
219
+ expect(memoryService.endSession).toHaveBeenCalledWith('hermes:session-a');
220
+ expect(memoryService.storeUserPrompt).toHaveBeenCalledTimes(1);
221
+ expect(memoryService.storeAgentResponse).toHaveBeenCalledTimes(1);
222
+
223
+ const [promptSessionId, promptContent, promptMetadata] = memoryService.storeUserPrompt.mock.calls[0];
224
+ expect(promptSessionId).toBe('hermes:session-a');
225
+ expect(promptContent).toContain('[REDACTED]');
226
+ expect(promptContent).not.toContain('sensitive-fixture-value');
227
+ expect(promptMetadata).toMatchObject({
228
+ source: 'hermes',
229
+ hermesSource: 'discord',
230
+ sourceSessionId: 'session-a',
231
+ importedFrom: stateDbPath
232
+ });
233
+
234
+ const [, responseContent, responseMetadata] = memoryService.storeAgentResponse.mock.calls[0];
235
+ expect(responseContent).toContain('[REDACTED]');
236
+ expect(responseContent).not.toContain('sensitive-fixture-value');
237
+ expect(responseMetadata).toMatchObject({
238
+ source: 'hermes',
239
+ hermesSource: 'discord',
240
+ sourceSessionId: 'session-a',
241
+ importedFrom: stateDbPath
242
+ });
243
+
244
+ expect(result).toMatchObject({
245
+ totalSessions: 1,
246
+ totalMessages: 4,
247
+ importedPrompts: 1,
248
+ importedResponses: 1,
249
+ skippedDuplicates: 0,
250
+ errors: []
251
+ });
252
+ });
253
+
254
+ it('imports only the latest matching Hermes session when sessionLimit is set', async () => {
255
+ const dir = tempDir();
256
+ const stateDbPath = join(dir, 'state.db');
257
+ const projectA = join(dir, 'project-a');
258
+ const projectB = join(dir, 'project-b');
259
+ createHermesStateDb(stateDbPath, projectA, projectB);
260
+
261
+ const db = new Database(stateDbPath);
262
+ db.prepare(`
263
+ INSERT INTO sessions (id, source, user_id, model, system_prompt, started_at, title, message_count)
264
+ VALUES (@id, @source, @userId, @model, @systemPrompt, @startedAt, @title, @messageCount)
265
+ `).run({
266
+ id: 'session-newer-a',
267
+ source: 'discord',
268
+ userId: 'user-newer',
269
+ model: 'gpt-5.5',
270
+ systemPrompt: `Project Context\n${projectA}`,
271
+ startedAt: 1_779_000_300,
272
+ title: 'newer project a thread',
273
+ messageCount: 1
274
+ });
275
+ db.prepare(`
276
+ INSERT INTO messages (session_id, role, content, tool_name, timestamp)
277
+ VALUES (@sessionId, @role, @content, @toolName, @timestamp)
278
+ `).run({
279
+ sessionId: 'session-newer-a',
280
+ role: 'user',
281
+ content: 'latest Hermes project session should be imported now',
282
+ toolName: null,
283
+ timestamp: 1_779_000_301
284
+ });
285
+ db.close();
286
+
287
+ const memoryService = {
288
+ startSession: vi.fn(async (_sessionId: string, _projectPath?: string) => undefined),
289
+ endSession: vi.fn(async (_sessionId: string) => undefined),
290
+ deleteSessionEvents: vi.fn(async (_sessionId: string) => 0),
291
+ storeUserPrompt: vi.fn(async () => ({ success: true, isDuplicate: false })),
292
+ storeAgentResponse: vi.fn(async () => ({ success: true, isDuplicate: false }))
293
+ };
294
+
295
+ const importer = createHermesSessionHistoryImporter(memoryService as never, { stateDbPath });
296
+ const result = await importer.importProject(projectA, { sessionLimit: 1 });
297
+
298
+ expect(result.totalSessions).toBe(1);
299
+ expect(memoryService.startSession).toHaveBeenCalledTimes(1);
300
+ expect(memoryService.startSession).toHaveBeenCalledWith('hermes:session-newer-a', projectA);
301
+ expect(memoryService.storeUserPrompt).toHaveBeenCalledTimes(1);
302
+ });
303
+
304
+ it('skips newer empty Hermes sessions when selecting latest project sessions for import', async () => {
305
+ const dir = tempDir();
306
+ const stateDbPath = join(dir, 'state.db');
307
+ const projectA = join(dir, 'project-a');
308
+ const projectB = join(dir, 'project-b');
309
+ createHermesStateDb(stateDbPath, projectA, projectB);
310
+
311
+ const db = new Database(stateDbPath);
312
+ db.prepare(`
313
+ INSERT INTO sessions (id, source, user_id, model, system_prompt, started_at, title, message_count)
314
+ VALUES (@id, @source, @userId, @model, @systemPrompt, @startedAt, @title, @messageCount)
315
+ `).run({
316
+ id: 'session-empty-newest-a',
317
+ source: 'discord',
318
+ userId: 'user-empty',
319
+ model: 'gpt-5.5',
320
+ systemPrompt: `Project Context\n${projectA}`,
321
+ startedAt: 1_779_000_400,
322
+ title: 'newest empty project a routing shell',
323
+ messageCount: 0
324
+ });
325
+ db.prepare(`
326
+ INSERT INTO sessions (id, source, user_id, model, system_prompt, started_at, title, message_count)
327
+ VALUES (@id, @source, @userId, @model, @systemPrompt, @startedAt, @title, @messageCount)
328
+ `).run({
329
+ id: 'session-newer-nonempty-a',
330
+ source: 'discord',
331
+ userId: 'user-newer',
332
+ model: 'gpt-5.5',
333
+ systemPrompt: `Project Context\n${projectA}`,
334
+ startedAt: 1_779_000_300,
335
+ title: 'newer non-empty project a thread',
336
+ messageCount: 1
337
+ });
338
+ db.prepare(`
339
+ INSERT INTO messages (session_id, role, content, tool_name, timestamp)
340
+ VALUES (@sessionId, @role, @content, @toolName, @timestamp)
341
+ `).run({
342
+ sessionId: 'session-newer-nonempty-a',
343
+ role: 'user',
344
+ content: 'latest non-empty Hermes project session should be imported despite newer empty shells',
345
+ toolName: null,
346
+ timestamp: 1_779_000_301
347
+ });
348
+ db.close();
349
+
350
+ const memoryService = {
351
+ startSession: vi.fn(async (_sessionId: string, _projectPath?: string) => undefined),
352
+ endSession: vi.fn(async (_sessionId: string) => undefined),
353
+ deleteSessionEvents: vi.fn(async (_sessionId: string) => 0),
354
+ storeUserPrompt: vi.fn(async () => ({ success: true, isDuplicate: false })),
355
+ storeAgentResponse: vi.fn(async () => ({ success: true, isDuplicate: false }))
356
+ };
357
+
358
+ const importer = createHermesSessionHistoryImporter(memoryService as never, { stateDbPath });
359
+ const result = await importer.importProject(projectA, { sessionLimit: 1 });
360
+
361
+ expect(result.totalSessions).toBe(1);
362
+ expect(result.totalMessages).toBe(1);
363
+ expect(memoryService.startSession).toHaveBeenCalledTimes(1);
364
+ expect(memoryService.startSession).toHaveBeenCalledWith('hermes:session-newer-nonempty-a', projectA);
365
+ expect(memoryService.startSession).not.toHaveBeenCalledWith('hermes:session-empty-newest-a', projectA);
366
+ expect(memoryService.storeUserPrompt).toHaveBeenCalledTimes(1);
367
+ });
368
+
369
+ it('skips newer Hermes sessions that cannot store any prompt or response when selecting latest imports', async () => {
370
+ const dir = tempDir();
371
+ const stateDbPath = join(dir, 'state.db');
372
+ const projectA = join(dir, 'project-a');
373
+ const projectB = join(dir, 'project-b');
374
+ createHermesStateDb(stateDbPath, projectA, projectB);
375
+
376
+ const db = new Database(stateDbPath);
377
+ const insertSession = db.prepare(`
378
+ INSERT INTO sessions (id, source, user_id, model, system_prompt, started_at, title, message_count)
379
+ VALUES (@id, @source, @userId, @model, @systemPrompt, @startedAt, @title, @messageCount)
380
+ `);
381
+ const insertMessage = db.prepare(`
382
+ INSERT INTO messages (session_id, role, content, tool_name, timestamp)
383
+ VALUES (@sessionId, @role, @content, @toolName, @timestamp)
384
+ `);
385
+
386
+ insertSession.run({
387
+ id: 'session-assistant-only-newest-a',
388
+ source: 'discord',
389
+ userId: 'user-assistant-only',
390
+ model: 'gpt-5.5',
391
+ systemPrompt: `Project Context\n${projectA}`,
392
+ startedAt: 1_779_000_500,
393
+ title: 'assistant-only shell',
394
+ messageCount: 1
395
+ });
396
+ insertMessage.run({
397
+ sessionId: 'session-assistant-only-newest-a',
398
+ role: 'assistant',
399
+ content: 'assistant-only content should not make this session consume the freshness slot',
400
+ toolName: null,
401
+ timestamp: 1_779_000_501
402
+ });
403
+
404
+ insertSession.run({
405
+ id: 'session-trivial-user-newer-a',
406
+ source: 'discord',
407
+ userId: 'user-trivial',
408
+ model: 'gpt-5.5',
409
+ systemPrompt: `Project Context\n${projectA}`,
410
+ startedAt: 1_779_000_400,
411
+ title: 'trivial user shell',
412
+ messageCount: 2
413
+ });
414
+ insertMessage.run({
415
+ sessionId: 'session-trivial-user-newer-a',
416
+ role: 'user',
417
+ content: 'ok',
418
+ toolName: null,
419
+ timestamp: 1_779_000_401
420
+ });
421
+ insertMessage.run({
422
+ sessionId: 'session-trivial-user-newer-a',
423
+ role: 'assistant',
424
+ content: 'assistant response after trivial prompt should not be stored without a real turn',
425
+ toolName: null,
426
+ timestamp: 1_779_000_402
427
+ });
428
+
429
+ insertSession.run({
430
+ id: 'session-meaningful-older-a',
431
+ source: 'discord',
432
+ userId: 'user-meaningful',
433
+ model: 'gpt-5.5',
434
+ systemPrompt: `Project Context\n${projectA}`,
435
+ startedAt: 1_779_000_300,
436
+ title: 'meaningful project a thread',
437
+ messageCount: 2
438
+ });
439
+ insertMessage.run({
440
+ sessionId: 'session-meaningful-older-a',
441
+ role: 'user',
442
+ content: 'meaningful Hermes prompt should be selected after newer non-storable shells',
443
+ toolName: null,
444
+ timestamp: 1_779_000_301
445
+ });
446
+ insertMessage.run({
447
+ sessionId: 'session-meaningful-older-a',
448
+ role: 'assistant',
449
+ content: 'meaningful Hermes response should be imported after the selected prompt',
450
+ toolName: null,
451
+ timestamp: 1_779_000_302
452
+ });
453
+ db.close();
454
+
455
+ const memoryService = {
456
+ startSession: vi.fn(async (_sessionId: string, _projectPath?: string) => undefined),
457
+ endSession: vi.fn(async (_sessionId: string) => undefined),
458
+ deleteSessionEvents: vi.fn(async (_sessionId: string) => 0),
459
+ storeUserPrompt: vi.fn(async () => ({ success: true, isDuplicate: false })),
460
+ storeAgentResponse: vi.fn(async () => ({ success: true, isDuplicate: false }))
461
+ };
462
+
463
+ const importer = createHermesSessionHistoryImporter(memoryService as never, { stateDbPath });
464
+ const result = await importer.importProject(projectA, { sessionLimit: 1 });
465
+
466
+ expect(result.totalSessions).toBe(1);
467
+ expect(result.totalMessages).toBe(2);
468
+ expect(result.importedPrompts).toBe(1);
469
+ expect(result.importedResponses).toBe(1);
470
+ expect(memoryService.startSession).toHaveBeenCalledTimes(1);
471
+ expect(memoryService.startSession).toHaveBeenCalledWith('hermes:session-meaningful-older-a', projectA);
472
+ expect(memoryService.startSession).not.toHaveBeenCalledWith('hermes:session-assistant-only-newest-a', projectA);
473
+ expect(memoryService.startSession).not.toHaveBeenCalledWith('hermes:session-trivial-user-newer-a', projectA);
474
+ });
475
+
476
+ it('bounds finite sessionLimit freshness selection to the newest candidate window', async () => {
477
+ const dir = tempDir();
478
+ const stateDbPath = join(dir, 'state.db');
479
+ const projectA = join(dir, 'project-a');
480
+ const projectB = join(dir, 'project-b');
481
+ createHermesStateDb(stateDbPath, projectA, projectB);
482
+
483
+ const db = new Database(stateDbPath);
484
+ const insertSession = db.prepare(`
485
+ INSERT INTO sessions (id, source, user_id, model, system_prompt, started_at, title, message_count)
486
+ VALUES (@id, @source, @userId, @model, @systemPrompt, @startedAt, @title, @messageCount)
487
+ `);
488
+ const insertMessage = db.prepare(`
489
+ INSERT INTO messages (session_id, role, content, tool_name, timestamp)
490
+ VALUES (@sessionId, @role, @content, @toolName, @timestamp)
491
+ `);
492
+
493
+ const freshnessScanWindow = HERMES_IMPORTABLE_SESSION_SCAN_FACTOR;
494
+ for (let index = 0; index < freshnessScanWindow + 1; index++) {
495
+ const sessionId = `session-assistant-shell-${index}`;
496
+ insertSession.run({
497
+ id: sessionId,
498
+ source: 'discord',
499
+ userId: `user-shell-${index}`,
500
+ model: 'gpt-5.5',
501
+ systemPrompt: `Project Context\n${projectA}`,
502
+ startedAt: 1_779_001_000 - index,
503
+ title: `assistant-only shell ${index}`,
504
+ messageCount: 1
505
+ });
506
+ insertMessage.run({
507
+ sessionId,
508
+ role: 'assistant',
509
+ content: 'assistant-only shell content should not trigger deep freshness scans',
510
+ toolName: null,
511
+ timestamp: 1_779_001_000 - index + 0.1
512
+ });
513
+ }
514
+
515
+ insertSession.run({
516
+ id: 'session-meaningful-beyond-window-a',
517
+ source: 'discord',
518
+ userId: 'user-meaningful',
519
+ model: 'gpt-5.5',
520
+ systemPrompt: `Project Context\n${projectA}`,
521
+ startedAt: 1_779_000_100,
522
+ title: 'meaningful but outside freshness window',
523
+ messageCount: 1
524
+ });
525
+ insertMessage.run({
526
+ sessionId: 'session-meaningful-beyond-window-a',
527
+ role: 'user',
528
+ content: 'meaningful Hermes prompt should not be reached beyond the bounded freshness scan window',
529
+ toolName: null,
530
+ timestamp: 1_779_000_101
531
+ });
532
+ db.close();
533
+
534
+ const memoryService = {
535
+ startSession: vi.fn(async (_sessionId: string, _projectPath?: string) => undefined),
536
+ endSession: vi.fn(async (_sessionId: string) => undefined),
537
+ deleteSessionEvents: vi.fn(async (_sessionId: string) => 0),
538
+ storeUserPrompt: vi.fn(async () => ({ success: true, isDuplicate: false })),
539
+ storeAgentResponse: vi.fn(async () => ({ success: true, isDuplicate: false }))
540
+ };
541
+
542
+ const importer = createHermesSessionHistoryImporter(memoryService as never, { stateDbPath });
543
+ const result = await importer.importProject(projectA, { sessionLimit: 1 });
544
+
545
+ expect(result.totalSessions).toBe(0);
546
+ expect(memoryService.startSession).not.toHaveBeenCalled();
547
+ expect(memoryService.storeUserPrompt).not.toHaveBeenCalled();
548
+ });
549
+
550
+ it('applies Hermes import limit per selected matching session', async () => {
551
+ const dir = tempDir();
552
+ const stateDbPath = join(dir, 'state.db');
553
+ const projectA = join(dir, 'project-a');
554
+ const projectB = join(dir, 'project-b');
555
+ createHermesStateDb(stateDbPath, projectA, projectB);
556
+
557
+ const db = new Database(stateDbPath);
558
+ db.prepare(`
559
+ INSERT INTO sessions (id, source, user_id, model, system_prompt, started_at, title, message_count)
560
+ VALUES (@id, @source, @userId, @model, @systemPrompt, @startedAt, @title, @messageCount)
561
+ `).run({
562
+ id: 'session-newer-a',
563
+ source: 'discord',
564
+ userId: 'user-newer',
565
+ model: 'gpt-5.5',
566
+ systemPrompt: `Project Context\n${projectA}`,
567
+ startedAt: 1_779_000_300,
568
+ title: 'newer project a thread',
569
+ messageCount: 2
570
+ });
571
+ const insertMessage = db.prepare(`
572
+ INSERT INTO messages (session_id, role, content, tool_name, timestamp)
573
+ VALUES (@sessionId, @role, @content, @toolName, @timestamp)
574
+ `);
575
+ insertMessage.run({
576
+ sessionId: 'session-newer-a',
577
+ role: 'user',
578
+ content: 'latest Hermes project prompt should be imported under per-session limit',
579
+ toolName: null,
580
+ timestamp: 1_779_000_301
581
+ });
582
+ insertMessage.run({
583
+ sessionId: 'session-newer-a',
584
+ role: 'assistant',
585
+ content: 'latest Hermes response should be skipped by a per-session limit of one',
586
+ toolName: null,
587
+ timestamp: 1_779_000_302
588
+ });
589
+ db.close();
590
+
591
+ const memoryService = {
592
+ startSession: vi.fn(async (_sessionId: string, _projectPath?: string) => undefined),
593
+ endSession: vi.fn(async (_sessionId: string) => undefined),
594
+ deleteSessionEvents: vi.fn(async (_sessionId: string) => 0),
595
+ storeUserPrompt: vi.fn(async () => ({ success: true, isDuplicate: false })),
596
+ storeAgentResponse: vi.fn(async () => ({ success: true, isDuplicate: false }))
597
+ };
598
+
599
+ const importer = createHermesSessionHistoryImporter(memoryService as never, { stateDbPath });
600
+ const result = await importer.importProject(projectA, { sessionLimit: 2, limit: 1 });
601
+
602
+ expect(result.totalSessions).toBe(2);
603
+ expect(memoryService.startSession).toHaveBeenCalledTimes(2);
604
+ expect(memoryService.startSession).toHaveBeenCalledWith('hermes:session-newer-a', projectA);
605
+ expect(memoryService.startSession).toHaveBeenCalledWith('hermes:session-a', projectA);
606
+ expect(memoryService.storeUserPrompt).toHaveBeenCalledTimes(2);
607
+ expect(memoryService.storeAgentResponse).not.toHaveBeenCalled();
608
+ });
609
+ });
@@ -1,5 +1,5 @@
1
1
  import { describe, it, expect } from 'vitest';
2
- import { IngestInterceptorRegistry, mergeHierarchicalMetadata } from '../src/core/ingest-interceptor.js';
2
+ import { IngestInterceptorRegistry, mergeHierarchicalMetadata } from '../../src/core/ingest-interceptor.js';
3
3
 
4
4
  describe('IngestInterceptorRegistry', () => {
5
5
  it('runs before/after interceptors in staged order', async () => {
@@ -3,8 +3,8 @@ import * as os from 'os';
3
3
  import * as path from 'path';
4
4
  import * as fs from 'fs/promises';
5
5
  import { randomUUID } from 'crypto';
6
- import { buildMirrorPath, MarkdownMirror } from '../src/core/markdown-mirror.js';
7
- import { SQLiteEventStore } from '../src/core/sqlite-event-store.js';
6
+ import { buildMirrorPath, MarkdownMirror } from '../../src/core/markdown-mirror.js';
7
+ import { SQLiteEventStore } from '../../src/core/sqlite-event-store.js';
8
8
 
9
9
  describe('markdown mirror', () => {
10
10
  it('builds sanitized path with defaults', () => {
@@ -3,7 +3,7 @@
3
3
  */
4
4
 
5
5
  import { describe, it, expect } from 'vitest';
6
- import { Matcher } from '../src/core/matcher.js';
6
+ import { Matcher } from '../../src/core/matcher.js';
7
7
 
8
8
  describe('Matcher', () => {
9
9
  const matcher = new Matcher();
@@ -2,8 +2,8 @@ import { describe, it, expect } from 'vitest';
2
2
  import * as os from 'node:os';
3
3
  import * as path from 'node:path';
4
4
  import * as fs from 'node:fs';
5
- import { buildMirrorPath, MarkdownMirror } from '../src/core/md-mirror.js';
6
- import type { MemoryEventInput } from '../src/core/types.js';
5
+ import { buildMirrorPath, MarkdownMirror } from '../../src/core/md-mirror.js';
6
+ import type { MemoryEventInput } from '../../src/core/types.js';
7
7
 
8
8
  function makeEvent(): MemoryEventInput {
9
9
  return {