claude-memory-layer 1.0.31 → 1.0.32

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 (313) hide show
  1. package/README.md +9 -2
  2. package/dist/cli/index.js +1 -1
  3. package/package.json +11 -2
  4. package/scripts/postinstall-embedding-backend.cjs +16 -12
  5. package/AGENTS.md +0 -71
  6. package/CLAUDE.md +0 -30
  7. package/HANDOFF.md +0 -92
  8. package/Memo.txt +0 -558
  9. package/benchmarks/replay/anonymized-real-sessions.json +0 -48
  10. package/config/kpi-thresholds.json +0 -7
  11. package/context.md +0 -636
  12. package/docs/ARCHITECTURE_COMPARISON_AND_RECOMMENDATIONS.md +0 -627
  13. package/docs/HERMES_MEMORY_INGESTION_ANALYSIS.md +0 -440
  14. package/docs/MCP_MEMORY_SERVICE_COMPARATIVE_REVIEW.md +0 -271
  15. package/docs/MEMORY_USEFULNESS_AUDIT.md +0 -371
  16. package/docs/MEMORY_USEFULNESS_AUDIT_RAW.json +0 -80
  17. package/docs/MEMSEARCH_PROJECT_STRUCTURE_ANALYSIS.md +0 -333
  18. package/docs/MEMU_ADOPTION.md +0 -40
  19. package/docs/OPERATIONS.md +0 -18
  20. package/docs/PRODUCT_VALIDATION_MATRIX.md +0 -82
  21. package/docs/PROJECT_STRUCTURE_ANALYSIS.md +0 -421
  22. package/docs/REFACTORING_MILESTONES_AND_ISSUES.md +0 -501
  23. package/docs/REFACTORING_PLAN_THIN_CORE.md +0 -414
  24. package/docs/REFERENCE_PROJECT_ANALYSES.md +0 -25
  25. package/docs/SUPERLOCALMEMORY_PROJECT_STRUCTURE_ANALYSIS.md +0 -452
  26. package/docs/TARGET_ARCHITECTURE_AND_FOLDER_STRUCTURE.md +0 -446
  27. package/docs/architecture/comparison-index.md +0 -47
  28. package/docs/reports/codex-real-data-validation-20260505T040447Z.md +0 -46
  29. package/plan.md +0 -1642
  30. package/scripts/build.ts +0 -159
  31. package/scripts/bump-patch-version.sh +0 -18
  32. package/scripts/delete-unknown-projects.js +0 -154
  33. package/scripts/fix-sync-gap.js +0 -32
  34. package/scripts/generate-session-qrels.ts +0 -126
  35. package/scripts/heartbeat-memory-orchestrator.sh +0 -28
  36. package/scripts/replay-retrieval-benchmark.ts +0 -69
  37. package/scripts/report-sync-gap.js +0 -26
  38. package/scripts/review-queue-auto-resolve.js +0 -21
  39. package/scripts/sync-gap-auto-heal.sh +0 -17
  40. package/spec.md +0 -624
  41. package/specs/20260207-dashboard-upgrade/context.md +0 -38
  42. package/specs/20260207-dashboard-upgrade/spec.md +0 -96
  43. package/specs/citations-system/context.md +0 -243
  44. package/specs/citations-system/plan.md +0 -495
  45. package/specs/citations-system/spec.md +0 -371
  46. package/specs/endless-mode/context.md +0 -305
  47. package/specs/endless-mode/plan.md +0 -620
  48. package/specs/endless-mode/spec.md +0 -455
  49. package/specs/entity-edge-model/context.md +0 -401
  50. package/specs/entity-edge-model/plan.md +0 -459
  51. package/specs/entity-edge-model/spec.md +0 -391
  52. package/specs/evidence-aligner-v2/context.md +0 -401
  53. package/specs/evidence-aligner-v2/plan.md +0 -303
  54. package/specs/evidence-aligner-v2/spec.md +0 -312
  55. package/specs/mcp-desktop-integration/context.md +0 -278
  56. package/specs/mcp-desktop-integration/plan.md +0 -550
  57. package/specs/mcp-desktop-integration/spec.md +0 -494
  58. package/specs/memory-utilization-improvements/context.md +0 -145
  59. package/specs/memory-utilization-improvements/plan.md +0 -361
  60. package/specs/memory-utilization-improvements/spec.md +0 -361
  61. package/specs/post-tool-use-hook/context.md +0 -319
  62. package/specs/post-tool-use-hook/plan.md +0 -469
  63. package/specs/post-tool-use-hook/spec.md +0 -364
  64. package/specs/private-tags/context.md +0 -288
  65. package/specs/private-tags/plan.md +0 -412
  66. package/specs/private-tags/spec.md +0 -345
  67. package/specs/progressive-disclosure/context.md +0 -346
  68. package/specs/progressive-disclosure/plan.md +0 -663
  69. package/specs/progressive-disclosure/spec.md +0 -415
  70. package/specs/selective-tool-observation/context.md +0 -100
  71. package/specs/selective-tool-observation/plan.md +0 -158
  72. package/specs/selective-tool-observation/spec.md +0 -127
  73. package/specs/task-entity-system/context.md +0 -297
  74. package/specs/task-entity-system/plan.md +0 -301
  75. package/specs/task-entity-system/spec.md +0 -314
  76. package/specs/thin-core-refactor/context.md +0 -275
  77. package/specs/thin-core-refactor/plan.md +0 -536
  78. package/specs/thin-core-refactor/spec.md +0 -465
  79. package/specs/vector-outbox-v2/context.md +0 -470
  80. package/specs/vector-outbox-v2/plan.md +0 -562
  81. package/specs/vector-outbox-v2/spec.md +0 -466
  82. package/specs/web-viewer-ui/context.md +0 -384
  83. package/specs/web-viewer-ui/plan.md +0 -797
  84. package/specs/web-viewer-ui/spec.md +0 -516
  85. package/src/adapters/claude/capture/index.ts +0 -3
  86. package/src/adapters/claude/context/index.ts +0 -3
  87. package/src/adapters/claude/hooks/index.ts +0 -21
  88. package/src/adapters/claude/hooks/post-tool-use.ts +0 -239
  89. package/src/adapters/claude/hooks/prompt-injection-policy.ts +0 -104
  90. package/src/adapters/claude/hooks/semantic-daemon-client.ts +0 -209
  91. package/src/adapters/claude/hooks/semantic-daemon.ts +0 -283
  92. package/src/adapters/claude/hooks/session-end.ts +0 -59
  93. package/src/adapters/claude/hooks/session-start.ts +0 -73
  94. package/src/adapters/claude/hooks/stop.ts +0 -128
  95. package/src/adapters/claude/hooks/user-prompt-submit.ts +0 -361
  96. package/src/adapters/claude/index.ts +0 -4
  97. package/src/adapters/claude/transcript/index.ts +0 -4
  98. package/src/adapters/claude/transcript/transcript-reader.ts +0 -57
  99. package/src/adapters/claude/transcript/turn-reconstructor.ts +0 -65
  100. package/src/apps/cli/claude-settings-hooks.ts +0 -138
  101. package/src/apps/cli/codex-import-runner.ts +0 -125
  102. package/src/apps/cli/codex-validation-output.ts +0 -95
  103. package/src/apps/cli/hermes-import-runner.ts +0 -130
  104. package/src/apps/cli/hermes-validation-output.ts +0 -91
  105. package/src/apps/cli/index.ts +0 -1735
  106. package/src/apps/cli/mcp-install.ts +0 -106
  107. package/src/apps/cli/retrieval-disclosure-output.ts +0 -196
  108. package/src/apps/dashboard/assets/js/bootstrap.js +0 -244
  109. package/src/apps/dashboard/assets/js/chat.js +0 -373
  110. package/src/apps/dashboard/assets/js/disclosure.js +0 -232
  111. package/src/apps/dashboard/assets/js/modals.js +0 -298
  112. package/src/apps/dashboard/assets/js/overview.js +0 -655
  113. package/src/apps/dashboard/assets/js/state.js +0 -72
  114. package/src/apps/dashboard/assets/js/views.js +0 -468
  115. package/src/apps/dashboard/index.html +0 -543
  116. package/src/apps/dashboard/index.ts +0 -3
  117. package/src/apps/dashboard/style.css +0 -1750
  118. package/src/apps/index.ts +0 -5
  119. package/src/apps/server/api/chat.ts +0 -244
  120. package/src/apps/server/api/citations.ts +0 -105
  121. package/src/apps/server/api/events.ts +0 -137
  122. package/src/apps/server/api/health.ts +0 -53
  123. package/src/apps/server/api/index.ts +0 -26
  124. package/src/apps/server/api/projects.ts +0 -74
  125. package/src/apps/server/api/search.ts +0 -184
  126. package/src/apps/server/api/sessions.ts +0 -115
  127. package/src/apps/server/api/stats.ts +0 -723
  128. package/src/apps/server/api/turns.ts +0 -143
  129. package/src/apps/server/api/utils.ts +0 -65
  130. package/src/apps/server/index.ts +0 -111
  131. package/src/cli/index.ts +0 -3
  132. package/src/cli/retrieval-disclosure-output.ts +0 -2
  133. package/src/compat/index.ts +0 -5
  134. package/src/core/canonical-key.ts +0 -186
  135. package/src/core/citation-generator.ts +0 -63
  136. package/src/core/consolidated-store.ts +0 -356
  137. package/src/core/consolidation-worker.ts +0 -493
  138. package/src/core/context-formatter.ts +0 -276
  139. package/src/core/continuity-manager.ts +0 -341
  140. package/src/core/db-wrapper.ts +0 -64
  141. package/src/core/derive/fact-deriver.ts +0 -170
  142. package/src/core/derive/index.ts +0 -2
  143. package/src/core/derive/summary-deriver.ts +0 -76
  144. package/src/core/edge-repo.ts +0 -333
  145. package/src/core/embedder.ts +0 -4
  146. package/src/core/engine/embedding-maintenance-service.ts +0 -187
  147. package/src/core/engine/endless-memory-services.ts +0 -4
  148. package/src/core/engine/index.ts +0 -19
  149. package/src/core/engine/memory-engine-services.ts +0 -170
  150. package/src/core/engine/memory-ingest-service.ts +0 -317
  151. package/src/core/engine/memory-query-service.ts +0 -173
  152. package/src/core/engine/memory-runtime-service.ts +0 -162
  153. package/src/core/engine/memory-service-composition.ts +0 -231
  154. package/src/core/engine/retrieval-analytics-service.ts +0 -181
  155. package/src/core/engine/retrieval-disclosure-service.ts +0 -420
  156. package/src/core/engine/retrieval-orchestrator.ts +0 -377
  157. package/src/core/engine/retrieval-services.ts +0 -176
  158. package/src/core/engine/shared-memory-services.ts +0 -4
  159. package/src/core/entity-repo.ts +0 -349
  160. package/src/core/event-store.ts +0 -779
  161. package/src/core/evidence-aligner.ts +0 -635
  162. package/src/core/external-market-context.ts +0 -582
  163. package/src/core/graduation-worker.ts +0 -171
  164. package/src/core/graduation.ts +0 -377
  165. package/src/core/index.ts +0 -64
  166. package/src/core/ingest-interceptor.ts +0 -80
  167. package/src/core/markdown-mirror.ts +0 -70
  168. package/src/core/matcher.ts +0 -208
  169. package/src/core/md-mirror.ts +0 -92
  170. package/src/core/metadata-extractor.ts +0 -203
  171. package/src/core/model/memory-fact.ts +0 -30
  172. package/src/core/model/memory-rule.ts +0 -14
  173. package/src/core/model/memory-summary.ts +0 -21
  174. package/src/core/model/raw-event.ts +0 -28
  175. package/src/core/model/retrieval-result.ts +0 -35
  176. package/src/core/mongo-sync-config.ts +0 -165
  177. package/src/core/mongo-sync-worker.ts +0 -381
  178. package/src/core/privacy/filter.ts +0 -190
  179. package/src/core/privacy/index.ts +0 -20
  180. package/src/core/privacy/tag-parser.ts +0 -145
  181. package/src/core/product-validation-matrix.ts +0 -314
  182. package/src/core/progressive-retriever.ts +0 -414
  183. package/src/core/registry/project-path.ts +0 -54
  184. package/src/core/registry/session-registry.ts +0 -69
  185. package/src/core/replay-evaluator.ts +0 -625
  186. package/src/core/retrieval-benchmark.ts +0 -117
  187. package/src/core/retrieval-quality.ts +0 -109
  188. package/src/core/retriever.ts +0 -800
  189. package/src/core/session-qrels.ts +0 -360
  190. package/src/core/shared-event-store.ts +0 -114
  191. package/src/core/shared-promoter.ts +0 -249
  192. package/src/core/shared-store.ts +0 -289
  193. package/src/core/shared-vector-store.ts +0 -203
  194. package/src/core/sqlite-event-store.ts +0 -1846
  195. package/src/core/sqlite-wrapper.ts +0 -116
  196. package/src/core/sync-worker.ts +0 -228
  197. package/src/core/tag-taxonomy.ts +0 -51
  198. package/src/core/task/blocker-resolver.ts +0 -333
  199. package/src/core/task/index.ts +0 -9
  200. package/src/core/task/task-matcher.ts +0 -240
  201. package/src/core/task/task-projector.ts +0 -358
  202. package/src/core/task/task-resolver.ts +0 -421
  203. package/src/core/turn-state.ts +0 -207
  204. package/src/core/types.ts +0 -952
  205. package/src/core/vector-outbox.ts +0 -299
  206. package/src/core/vector-store.ts +0 -231
  207. package/src/core/vector-worker.ts +0 -521
  208. package/src/core/working-set-store.ts +0 -257
  209. package/src/extensions/endless-memory/endless-memory-services.ts +0 -350
  210. package/src/extensions/endless-memory/index.ts +0 -1
  211. package/src/extensions/index.ts +0 -5
  212. package/src/extensions/mcp/handlers.ts +0 -960
  213. package/src/extensions/mcp/index.ts +0 -48
  214. package/src/extensions/mcp/tools.ts +0 -252
  215. package/src/extensions/shared-memory/index.ts +0 -1
  216. package/src/extensions/shared-memory/shared-memory-services.ts +0 -211
  217. package/src/extensions/vector/embedder.ts +0 -234
  218. package/src/extensions/vector/index.ts +0 -1
  219. package/src/hooks/post-tool-use.ts +0 -9
  220. package/src/hooks/semantic-daemon-client.ts +0 -1
  221. package/src/hooks/semantic-daemon.ts +0 -11
  222. package/src/hooks/session-end.ts +0 -9
  223. package/src/hooks/session-start.ts +0 -9
  224. package/src/hooks/stop.ts +0 -9
  225. package/src/hooks/user-prompt-submit.ts +0 -9
  226. package/src/index.ts +0 -13
  227. package/src/mcp/handlers.ts +0 -2
  228. package/src/mcp/index.ts +0 -4
  229. package/src/mcp/tools.ts +0 -2
  230. package/src/server/api/chat.ts +0 -2
  231. package/src/server/api/citations.ts +0 -2
  232. package/src/server/api/events.ts +0 -2
  233. package/src/server/api/health.ts +0 -2
  234. package/src/server/api/index.ts +0 -2
  235. package/src/server/api/projects.ts +0 -2
  236. package/src/server/api/search.ts +0 -2
  237. package/src/server/api/sessions.ts +0 -2
  238. package/src/server/api/stats.ts +0 -2
  239. package/src/server/api/turns.ts +0 -2
  240. package/src/server/api/utils.ts +0 -2
  241. package/src/server/index.ts +0 -2
  242. package/src/services/bootstrap-organizer.ts +0 -463
  243. package/src/services/codex-session-history-importer.ts +0 -966
  244. package/src/services/hermes-session-history-importer.ts +0 -733
  245. package/src/services/memory-service-config.ts +0 -36
  246. package/src/services/memory-service-registry.ts +0 -150
  247. package/src/services/memory-service.ts +0 -688
  248. package/src/services/session-history-importer.ts +0 -629
  249. package/tests/README.md +0 -23
  250. package/tests/adapters/claude/claude-semantic-daemon-adapter.test.ts +0 -54
  251. package/tests/adapters/claude/claude-transcript-reconstructor.test.ts +0 -98
  252. package/tests/adapters/claude-hook-prompt-injection-policy.test.ts +0 -99
  253. package/tests/apps/app-layer-boundary.test.ts +0 -48
  254. package/tests/apps/claude-settings-hooks.test.ts +0 -107
  255. package/tests/apps/cli-disclosure-output.test.ts +0 -212
  256. package/tests/apps/codex-import-runner.test.ts +0 -99
  257. package/tests/apps/codex-validation-output.test.ts +0 -100
  258. package/tests/apps/hermes-import-runner.test.ts +0 -99
  259. package/tests/apps/mcp-install-command.test.ts +0 -59
  260. package/tests/apps/package-build-entrypoints.test.ts +0 -30
  261. package/tests/apps/postinstall-embedding-backend.test.ts +0 -185
  262. package/tests/apps/search-api-disclosure.test.ts +0 -162
  263. package/tests/apps/stats-api-lightweight.test.ts +0 -67
  264. package/tests/apps/ui-disclosure-output.test.ts +0 -140
  265. package/tests/core/bootstrap-organizer.test.ts +0 -111
  266. package/tests/core/canonical-key.test.ts +0 -101
  267. package/tests/core/codex-session-history-importer-validation.test.ts +0 -185
  268. package/tests/core/consolidation-worker.test.ts +0 -75
  269. package/tests/core/embedding-maintenance-service.test.ts +0 -282
  270. package/tests/core/evidence-aligner.test.ts +0 -152
  271. package/tests/core/external-market-context.test.ts +0 -209
  272. package/tests/core/fact-deriver.test.ts +0 -79
  273. package/tests/core/hermes-session-history-importer-validation.test.ts +0 -609
  274. package/tests/core/ingest-interceptor.test.ts +0 -38
  275. package/tests/core/markdown-mirror.test.ts +0 -85
  276. package/tests/core/matcher.test.ts +0 -112
  277. package/tests/core/md-mirror.test.ts +0 -50
  278. package/tests/core/memory-engine-services.test.ts +0 -240
  279. package/tests/core/memory-ingest-service.test.ts +0 -296
  280. package/tests/core/memory-query-service.test.ts +0 -129
  281. package/tests/core/memory-runtime-service.test.ts +0 -201
  282. package/tests/core/memory-service-composition.test.ts +0 -192
  283. package/tests/core/memory-service-config.test.ts +0 -41
  284. package/tests/core/memory-service-facade.test.ts +0 -30
  285. package/tests/core/memory-service-registry.test.ts +0 -206
  286. package/tests/core/product-validation-matrix.test.ts +0 -61
  287. package/tests/core/project-registry.test.ts +0 -78
  288. package/tests/core/replay-evaluator.test.ts +0 -181
  289. package/tests/core/retrieval-analytics-service.test.ts +0 -210
  290. package/tests/core/retrieval-benchmark.test.ts +0 -93
  291. package/tests/core/retrieval-disclosure-service.test.ts +0 -264
  292. package/tests/core/retrieval-orchestrator.test.ts +0 -403
  293. package/tests/core/retrieval-quality.test.ts +0 -31
  294. package/tests/core/retrieval-services.test.ts +0 -185
  295. package/tests/core/retriever-fallback-chain.test.ts +0 -223
  296. package/tests/core/retriever-strategy-scope.test.ts +0 -164
  297. package/tests/core/retriever.memu-adoption.test.ts +0 -122
  298. package/tests/core/session-history-importer-filter.test.ts +0 -78
  299. package/tests/core/session-qrels.test.ts +0 -250
  300. package/tests/core/sqlite-event-store-replication.test.ts +0 -127
  301. package/tests/core/summary-deriver.test.ts +0 -66
  302. package/tests/extensions/embedder-warning-suppression.test.ts +0 -84
  303. package/tests/extensions/endless-memory-extension-boundary.test.ts +0 -17
  304. package/tests/extensions/endless-memory-services.test.ts +0 -325
  305. package/tests/extensions/mcp-context-tools.test.ts +0 -905
  306. package/tests/extensions/mcp-extension-boundary.test.ts +0 -21
  307. package/tests/extensions/mcp-package-build.test.ts +0 -22
  308. package/tests/extensions/mcp-project-aware-tools.test.ts +0 -102
  309. package/tests/extensions/shared-memory-extension-boundary.test.ts +0 -24
  310. package/tests/extensions/shared-memory-services.test.ts +0 -309
  311. package/tests/extensions/vector-extension-boundary.test.ts +0 -21
  312. package/tsconfig.json +0 -24
  313. package/vitest.config.ts +0 -15
@@ -1,609 +0,0 @@
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,38 +0,0 @@
1
- import { describe, it, expect } from 'vitest';
2
- import { IngestInterceptorRegistry, mergeHierarchicalMetadata } from '../../src/core/ingest-interceptor.js';
3
-
4
- describe('IngestInterceptorRegistry', () => {
5
- it('runs before/after interceptors in staged order', async () => {
6
- const registry = new IngestInterceptorRegistry();
7
- const stages: string[] = [];
8
-
9
- registry.registerBefore((ctx) => stages.push(`before:${ctx.operation}`));
10
- registry.registerAfter((ctx) => stages.push(`after:${ctx.operation}`));
11
-
12
- const event = {
13
- eventType: 'user_prompt' as const,
14
- sessionId: 's1',
15
- timestamp: new Date(),
16
- content: 'hello'
17
- };
18
-
19
- await registry.run('before', { operation: 'user_prompt', sessionId: 's1', event });
20
- await registry.run('after', { operation: 'user_prompt', sessionId: 's1', event });
21
-
22
- expect(stages).toEqual(['before:user_prompt', 'after:user_prompt']);
23
- });
24
- });
25
-
26
- describe('mergeHierarchicalMetadata', () => {
27
- it('deep merges nested metadata without clobbering siblings', () => {
28
- const merged = mergeHierarchicalMetadata(
29
- { scope: { project: { id: 'alpha', env: 'dev' } }, ingest: { source: 'hook' } },
30
- { scope: { project: { env: 'prod' }, turn: { id: 't1' } } }
31
- );
32
-
33
- expect(merged).toEqual({
34
- scope: { project: { id: 'alpha', env: 'prod' }, turn: { id: 't1' } },
35
- ingest: { source: 'hook' }
36
- });
37
- });
38
- });