claude-memory-layer 1.0.27 → 1.0.29

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 (331) hide show
  1. package/.env.example +7 -0
  2. package/AGENTS.md +11 -0
  3. package/README.md +374 -49
  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 +12 -5
  56. package/scripts/build.ts +25 -8
  57. package/scripts/generate-session-qrels.ts +126 -0
  58. package/scripts/postinstall-embedding-backend.cjs +142 -0
  59. package/scripts/replay-retrieval-benchmark.ts +69 -0
  60. package/specs/thin-core-refactor/context.md +275 -0
  61. package/specs/thin-core-refactor/plan.md +536 -0
  62. package/specs/thin-core-refactor/spec.md +465 -0
  63. package/src/adapters/claude/capture/index.ts +3 -0
  64. package/src/adapters/claude/context/index.ts +3 -0
  65. package/src/adapters/claude/hooks/index.ts +21 -0
  66. package/src/adapters/claude/hooks/post-tool-use.ts +239 -0
  67. package/src/adapters/claude/hooks/prompt-injection-policy.ts +104 -0
  68. package/src/adapters/claude/hooks/semantic-daemon-client.ts +209 -0
  69. package/src/adapters/claude/hooks/semantic-daemon.ts +283 -0
  70. package/src/adapters/claude/hooks/session-end.ts +59 -0
  71. package/src/adapters/claude/hooks/session-start.ts +73 -0
  72. package/src/adapters/claude/hooks/stop.ts +128 -0
  73. package/src/adapters/claude/hooks/user-prompt-submit.ts +361 -0
  74. package/src/adapters/claude/index.ts +4 -0
  75. package/src/adapters/claude/transcript/index.ts +4 -0
  76. package/src/adapters/claude/transcript/transcript-reader.ts +57 -0
  77. package/src/adapters/claude/transcript/turn-reconstructor.ts +65 -0
  78. package/src/apps/cli/claude-settings-hooks.ts +138 -0
  79. package/src/apps/cli/codex-import-runner.ts +125 -0
  80. package/src/apps/cli/codex-validation-output.ts +95 -0
  81. package/src/apps/cli/hermes-import-runner.ts +130 -0
  82. package/src/apps/cli/hermes-validation-output.ts +91 -0
  83. package/src/apps/cli/index.ts +1731 -0
  84. package/src/apps/cli/mcp-install.ts +106 -0
  85. package/src/apps/cli/retrieval-disclosure-output.ts +196 -0
  86. package/src/apps/dashboard/assets/js/bootstrap.js +244 -0
  87. package/src/apps/dashboard/assets/js/chat.js +373 -0
  88. package/src/apps/dashboard/assets/js/disclosure.js +232 -0
  89. package/src/apps/dashboard/assets/js/modals.js +298 -0
  90. package/src/apps/dashboard/assets/js/overview.js +655 -0
  91. package/src/apps/dashboard/assets/js/state.js +72 -0
  92. package/src/apps/dashboard/assets/js/views.js +468 -0
  93. package/src/{ui → apps/dashboard}/index.html +43 -1
  94. package/src/apps/dashboard/index.ts +3 -0
  95. package/src/{ui → apps/dashboard}/style.css +222 -0
  96. package/src/apps/index.ts +5 -0
  97. package/src/apps/server/api/chat.ts +244 -0
  98. package/src/apps/server/api/citations.ts +105 -0
  99. package/src/apps/server/api/events.ts +137 -0
  100. package/src/apps/server/api/health.ts +53 -0
  101. package/src/apps/server/api/index.ts +26 -0
  102. package/src/apps/server/api/projects.ts +74 -0
  103. package/src/apps/server/api/search.ts +184 -0
  104. package/src/apps/server/api/sessions.ts +115 -0
  105. package/src/apps/server/api/stats.ts +723 -0
  106. package/src/apps/server/api/turns.ts +143 -0
  107. package/src/apps/server/api/utils.ts +65 -0
  108. package/src/apps/server/index.ts +111 -0
  109. package/src/cli/index.ts +2 -1311
  110. package/src/cli/retrieval-disclosure-output.ts +2 -0
  111. package/src/compat/index.ts +5 -0
  112. package/src/core/derive/fact-deriver.ts +170 -0
  113. package/src/core/derive/index.ts +2 -0
  114. package/src/core/derive/summary-deriver.ts +76 -0
  115. package/src/core/embedder.ts +4 -152
  116. package/src/core/engine/embedding-maintenance-service.ts +187 -0
  117. package/src/core/engine/endless-memory-services.ts +4 -0
  118. package/src/core/engine/index.ts +19 -0
  119. package/src/core/engine/memory-engine-services.ts +170 -0
  120. package/src/core/engine/memory-ingest-service.ts +317 -0
  121. package/src/core/engine/memory-query-service.ts +173 -0
  122. package/src/core/engine/memory-runtime-service.ts +162 -0
  123. package/src/core/engine/memory-service-composition.ts +231 -0
  124. package/src/core/engine/retrieval-analytics-service.ts +181 -0
  125. package/src/core/engine/retrieval-disclosure-service.ts +420 -0
  126. package/src/core/engine/retrieval-orchestrator.ts +377 -0
  127. package/src/core/engine/retrieval-services.ts +176 -0
  128. package/src/core/engine/shared-memory-services.ts +4 -0
  129. package/src/core/entity-repo.ts +1 -3
  130. package/src/core/event-store.ts +3 -3
  131. package/src/core/evidence-aligner.ts +2 -2
  132. package/src/core/external-market-context.ts +582 -0
  133. package/src/core/graduation.ts +2 -3
  134. package/src/core/index.ts +21 -0
  135. package/src/core/matcher.ts +2 -4
  136. package/src/core/model/memory-fact.ts +30 -0
  137. package/src/core/model/memory-rule.ts +14 -0
  138. package/src/core/model/memory-summary.ts +21 -0
  139. package/src/core/model/raw-event.ts +28 -0
  140. package/src/core/model/retrieval-result.ts +35 -0
  141. package/src/core/privacy/filter.ts +21 -10
  142. package/src/core/product-validation-matrix.ts +314 -0
  143. package/src/core/progressive-retriever.ts +1 -2
  144. package/src/core/registry/project-path.ts +54 -0
  145. package/src/core/registry/session-registry.ts +69 -0
  146. package/src/core/replay-evaluator.ts +625 -0
  147. package/src/core/retrieval-benchmark.ts +117 -0
  148. package/src/core/retrieval-quality.ts +109 -0
  149. package/src/core/retriever.ts +53 -15
  150. package/src/core/session-qrels.ts +360 -0
  151. package/src/core/shared-event-store.ts +1 -1
  152. package/src/core/sqlite-event-store.ts +35 -11
  153. package/src/core/task/blocker-resolver.ts +2 -2
  154. package/src/core/task/task-resolver.ts +0 -1
  155. package/src/core/vector-outbox.ts +1 -10
  156. package/src/core/vector-worker.ts +1 -1
  157. package/src/extensions/endless-memory/endless-memory-services.ts +350 -0
  158. package/src/extensions/endless-memory/index.ts +1 -0
  159. package/src/extensions/index.ts +5 -0
  160. package/src/extensions/mcp/handlers.ts +960 -0
  161. package/src/extensions/mcp/index.ts +48 -0
  162. package/src/extensions/mcp/tools.ts +252 -0
  163. package/src/extensions/shared-memory/index.ts +1 -0
  164. package/src/extensions/shared-memory/shared-memory-services.ts +211 -0
  165. package/src/extensions/vector/embedder.ts +197 -0
  166. package/src/extensions/vector/index.ts +1 -0
  167. package/src/hooks/post-tool-use.ts +3 -236
  168. package/src/hooks/semantic-daemon-client.ts +1 -208
  169. package/src/hooks/semantic-daemon.ts +6 -271
  170. package/src/hooks/session-end.ts +4 -79
  171. package/src/hooks/session-start.ts +4 -73
  172. package/src/hooks/stop.ts +3 -173
  173. package/src/hooks/user-prompt-submit.ts +3 -338
  174. package/src/index.ts +13 -0
  175. package/src/mcp/handlers.ts +2 -212
  176. package/src/mcp/index.ts +3 -46
  177. package/src/mcp/tools.ts +2 -78
  178. package/src/server/api/chat.ts +2 -244
  179. package/src/server/api/citations.ts +2 -105
  180. package/src/server/api/events.ts +2 -137
  181. package/src/server/api/health.ts +2 -53
  182. package/src/server/api/index.ts +2 -26
  183. package/src/server/api/projects.ts +2 -74
  184. package/src/server/api/search.ts +2 -102
  185. package/src/server/api/sessions.ts +2 -115
  186. package/src/server/api/stats.ts +2 -724
  187. package/src/server/api/turns.ts +2 -143
  188. package/src/server/api/utils.ts +2 -46
  189. package/src/server/index.ts +2 -100
  190. package/src/services/bootstrap-organizer.ts +46 -26
  191. package/src/services/codex-session-history-importer.ts +521 -29
  192. package/src/services/hermes-session-history-importer.ts +733 -0
  193. package/src/services/memory-service-config.ts +36 -0
  194. package/src/services/memory-service-registry.ts +150 -0
  195. package/src/services/memory-service.ts +211 -1325
  196. package/src/services/session-history-importer.ts +58 -14
  197. package/tests/README.md +23 -0
  198. package/tests/adapters/claude/claude-semantic-daemon-adapter.test.ts +54 -0
  199. package/tests/adapters/claude/claude-transcript-reconstructor.test.ts +98 -0
  200. package/tests/adapters/claude-hook-prompt-injection-policy.test.ts +99 -0
  201. package/tests/apps/app-layer-boundary.test.ts +48 -0
  202. package/tests/apps/claude-settings-hooks.test.ts +107 -0
  203. package/tests/apps/cli-disclosure-output.test.ts +212 -0
  204. package/tests/apps/codex-import-runner.test.ts +99 -0
  205. package/tests/apps/codex-validation-output.test.ts +100 -0
  206. package/tests/apps/hermes-import-runner.test.ts +99 -0
  207. package/tests/apps/mcp-install-command.test.ts +59 -0
  208. package/tests/apps/package-build-entrypoints.test.ts +30 -0
  209. package/tests/apps/postinstall-embedding-backend.test.ts +167 -0
  210. package/tests/apps/search-api-disclosure.test.ts +162 -0
  211. package/tests/apps/stats-api-lightweight.test.ts +67 -0
  212. package/tests/apps/ui-disclosure-output.test.ts +140 -0
  213. package/tests/{bootstrap-organizer.test.ts → core/bootstrap-organizer.test.ts} +1 -1
  214. package/tests/{canonical-key.test.ts → core/canonical-key.test.ts} +1 -1
  215. package/tests/core/codex-session-history-importer-validation.test.ts +185 -0
  216. package/tests/{consolidation-worker.test.ts → core/consolidation-worker.test.ts} +2 -2
  217. package/tests/core/embedding-maintenance-service.test.ts +282 -0
  218. package/tests/{evidence-aligner.test.ts → core/evidence-aligner.test.ts} +1 -1
  219. package/tests/core/external-market-context.test.ts +209 -0
  220. package/tests/core/fact-deriver.test.ts +79 -0
  221. package/tests/core/hermes-session-history-importer-validation.test.ts +609 -0
  222. package/tests/{ingest-interceptor.test.ts → core/ingest-interceptor.test.ts} +1 -1
  223. package/tests/{markdown-mirror.test.ts → core/markdown-mirror.test.ts} +2 -2
  224. package/tests/{matcher.test.ts → core/matcher.test.ts} +1 -1
  225. package/tests/{md-mirror.test.ts → core/md-mirror.test.ts} +2 -2
  226. package/tests/core/memory-engine-services.test.ts +240 -0
  227. package/tests/core/memory-ingest-service.test.ts +296 -0
  228. package/tests/core/memory-query-service.test.ts +129 -0
  229. package/tests/core/memory-runtime-service.test.ts +201 -0
  230. package/tests/core/memory-service-composition.test.ts +192 -0
  231. package/tests/core/memory-service-config.test.ts +41 -0
  232. package/tests/core/memory-service-facade.test.ts +30 -0
  233. package/tests/core/memory-service-registry.test.ts +206 -0
  234. package/tests/core/product-validation-matrix.test.ts +61 -0
  235. package/tests/core/project-registry.test.ts +78 -0
  236. package/tests/core/replay-evaluator.test.ts +181 -0
  237. package/tests/core/retrieval-analytics-service.test.ts +210 -0
  238. package/tests/core/retrieval-benchmark.test.ts +93 -0
  239. package/tests/core/retrieval-disclosure-service.test.ts +264 -0
  240. package/tests/core/retrieval-orchestrator.test.ts +403 -0
  241. package/tests/core/retrieval-quality.test.ts +31 -0
  242. package/tests/core/retrieval-services.test.ts +185 -0
  243. package/tests/{retriever-fallback-chain.test.ts → core/retriever-fallback-chain.test.ts} +3 -3
  244. package/tests/{retriever-strategy-scope.test.ts → core/retriever-strategy-scope.test.ts} +70 -3
  245. package/tests/{retriever.memu-adoption.test.ts → core/retriever.memu-adoption.test.ts} +3 -3
  246. package/tests/core/session-history-importer-filter.test.ts +78 -0
  247. package/tests/core/session-qrels.test.ts +250 -0
  248. package/tests/{sqlite-event-store-replication.test.ts → core/sqlite-event-store-replication.test.ts} +36 -1
  249. package/tests/core/summary-deriver.test.ts +66 -0
  250. package/tests/extensions/embedder-warning-suppression.test.ts +53 -0
  251. package/tests/extensions/endless-memory-extension-boundary.test.ts +17 -0
  252. package/tests/extensions/endless-memory-services.test.ts +325 -0
  253. package/tests/extensions/mcp-context-tools.test.ts +905 -0
  254. package/tests/extensions/mcp-extension-boundary.test.ts +21 -0
  255. package/tests/extensions/mcp-package-build.test.ts +22 -0
  256. package/tests/extensions/mcp-project-aware-tools.test.ts +102 -0
  257. package/tests/extensions/shared-memory-extension-boundary.test.ts +24 -0
  258. package/tests/extensions/shared-memory-services.test.ts +309 -0
  259. package/tests/extensions/vector-extension-boundary.test.ts +21 -0
  260. package/.claude/settings.local.json +0 -25
  261. package/.npm-cache/_cacache/content-v2/sha512/04/76/c098f88dfe584a2b80870bff7421b05d17d3d9ee1027f77772332a22d3f93a9a57101a2855107f6ad82077a818bba912b2bc317f2361b5ddb09ad284d9ce +0 -0
  262. package/.npm-cache/_cacache/content-v2/sha512/60/25/d2ecd39cfc7cab58351162814be77f935c6d6491c10c3745d456da7ddb2117ffd90c10e53fe3c0f1ed16b403307841543634504398b16ee4e6b6dd8e0c45 +0 -0
  263. package/.npm-cache/_cacache/index-v5/2b/9a/7f8f40206ed8a2e0a84efaa953ccaed1f5d001e14b931083f2e7a0738007 +0 -2
  264. package/.npm-cache/_cacache/index-v5/2e/d9/fcfa5c6a6abdc2a3644ab84a95936047298c465a2f47ee03db8f7fe1e946 +0 -3
  265. package/.npm-cache/_cacache/index-v5/a9/42/e519633356d12d3d2f19da66a8301016d496c8f5c3e0554124aaa62dc043 +0 -2
  266. package/.npm-cache/_logs/2026-02-26T12_04_52_729Z-debug-0.log +0 -256
  267. package/.npm-cache/_logs/2026-02-26T12_05_36_835Z-debug-0.log +0 -18
  268. package/.npm-cache/_logs/2026-02-26T12_05_45_982Z-debug-0.log +0 -32
  269. package/.npm-cache/_logs/2026-02-26T12_05_48_515Z-debug-0.log +0 -260
  270. package/.npm-cache/_logs/2026-02-26T12_05_53_567Z-debug-0.log +0 -69
  271. package/.npm-cache/_update-notifier-last-checked +0 -0
  272. package/bootstrap-kb/decisions/decisions.md +0 -244
  273. package/bootstrap-kb/glossary/glossary.md +0 -46
  274. package/bootstrap-kb/modules/.claude-plugin.md +0 -22
  275. package/bootstrap-kb/modules/agents.md.md +0 -15
  276. package/bootstrap-kb/modules/claude.md.md +0 -15
  277. package/bootstrap-kb/modules/context.md.md +0 -15
  278. package/bootstrap-kb/modules/docs.md +0 -18
  279. package/bootstrap-kb/modules/handoff.md.md +0 -15
  280. package/bootstrap-kb/modules/package-lock.json.md +0 -15
  281. package/bootstrap-kb/modules/package.json.md +0 -15
  282. package/bootstrap-kb/modules/plan.md.md +0 -15
  283. package/bootstrap-kb/modules/readme.md.md +0 -15
  284. package/bootstrap-kb/modules/scripts.md +0 -26
  285. package/bootstrap-kb/modules/spec.md.md +0 -15
  286. package/bootstrap-kb/modules/specs.md +0 -20
  287. package/bootstrap-kb/modules/src.md +0 -51
  288. package/bootstrap-kb/modules/tests.md +0 -42
  289. package/bootstrap-kb/modules/tsconfig.json.md +0 -15
  290. package/bootstrap-kb/modules/vitest.config.ts.md +0 -15
  291. package/bootstrap-kb/overview/overview.md +0 -40
  292. package/bootstrap-kb/sources/manifest.json +0 -950
  293. package/bootstrap-kb/sources/manifest.md +0 -227
  294. package/bootstrap-kb/timeline/timeline.md +0 -57
  295. package/claude-memory-layer-1.0.14.tgz +0 -0
  296. package/d.sh +0 -3
  297. package/deploy.sh +0 -3
  298. package/dist/ui/app.js +0 -2101
  299. package/memory/.claude-plugin/commands/2026-02-25.md +0 -263
  300. package/memory/_index.md +0 -419
  301. package/memory/agent_response/uncategorized/2026-02-26.md +0 -176
  302. package/memory/agent_response/uncategorized/2026-03-03.md +0 -14
  303. package/memory/agent_response/uncategorized/2026-03-04.md +0 -1421
  304. package/memory/agent_response/uncategorized/2026-03-05.md +0 -157
  305. package/memory/default/uncategorized/2026-02-25.md +0 -4839
  306. package/memory/session_summary/uncategorized/2026-02-26.md +0 -13
  307. package/memory/session_summary/uncategorized/2026-03-03.md +0 -5
  308. package/memory/session_summary/uncategorized/2026-03-04.md +0 -50
  309. package/memory/specs/20260207-dashboard-upgrade/2026-02-25.md +0 -142
  310. package/memory/specs/citations-system/2026-02-25.md +0 -1121
  311. package/memory/specs/endless-mode/2026-02-25.md +0 -1392
  312. package/memory/specs/entity-edge-model/2026-02-25.md +0 -1263
  313. package/memory/specs/evidence-aligner-v2/2026-02-25.md +0 -1028
  314. package/memory/specs/mcp-desktop-integration/2026-02-25.md +0 -1334
  315. package/memory/specs/post-tool-use-hook/2026-02-25.md +0 -1164
  316. package/memory/specs/private-tags/2026-02-25.md +0 -1057
  317. package/memory/specs/progressive-disclosure/2026-02-25.md +0 -1436
  318. package/memory/specs/task-entity-system/2026-02-25.md +0 -924
  319. package/memory/specs/vector-outbox-v2/2026-02-25.md +0 -1510
  320. package/memory/specs/web-viewer-ui/2026-02-25.md +0 -1709
  321. package/memory/tool_observation/uncategorized/2026-02-26.md +0 -209
  322. package/memory/tool_observation/uncategorized/2026-03-03.md +0 -21
  323. package/memory/tool_observation/uncategorized/2026-03-04.md +0 -1033
  324. package/memory/tool_observation/uncategorized/2026-03-05.md +0 -33
  325. package/memory/user_prompt/uncategorized/2026-02-26.md +0 -25
  326. package/memory/user_prompt/uncategorized/2026-03-04.md +0 -634
  327. package/memory/user_prompt/uncategorized/2026-03-05.md +0 -6
  328. package/specs/optional-duckdb/context.md +0 -77
  329. package/specs/optional-duckdb/plan.md +0 -142
  330. package/specs/optional-duckdb/spec.md +0 -35
  331. 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 {