claude-memory-layer 1.0.30 → 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 (338) hide show
  1. package/README.md +12 -5
  2. package/dist/cli/index.js +4 -3
  3. package/dist/cli/index.js.map +2 -2
  4. package/dist/core/index.js +3 -2
  5. package/dist/core/index.js.map +2 -2
  6. package/dist/hooks/post-tool-use.js +3 -2
  7. package/dist/hooks/post-tool-use.js.map +2 -2
  8. package/dist/hooks/semantic-daemon.js +3 -2
  9. package/dist/hooks/semantic-daemon.js.map +2 -2
  10. package/dist/hooks/session-end.js +3 -2
  11. package/dist/hooks/session-end.js.map +2 -2
  12. package/dist/hooks/session-start.js +3 -2
  13. package/dist/hooks/session-start.js.map +2 -2
  14. package/dist/hooks/stop.js +3 -2
  15. package/dist/hooks/stop.js.map +2 -2
  16. package/dist/hooks/user-prompt-submit.js +3 -2
  17. package/dist/hooks/user-prompt-submit.js.map +2 -2
  18. package/dist/index.js +3 -2
  19. package/dist/index.js.map +2 -2
  20. package/dist/mcp/index.js +3 -2
  21. package/dist/mcp/index.js.map +2 -2
  22. package/dist/server/api/index.js +3 -2
  23. package/dist/server/api/index.js.map +2 -2
  24. package/dist/server/index.js +3 -2
  25. package/dist/server/index.js.map +2 -2
  26. package/dist/services/memory-service.js +3 -2
  27. package/dist/services/memory-service.js.map +2 -2
  28. package/package.json +10 -3
  29. package/scripts/postinstall-embedding-backend.cjs +18 -16
  30. package/AGENTS.md +0 -71
  31. package/CLAUDE.md +0 -30
  32. package/HANDOFF.md +0 -92
  33. package/Memo.txt +0 -558
  34. package/benchmarks/replay/anonymized-real-sessions.json +0 -48
  35. package/config/kpi-thresholds.json +0 -7
  36. package/context.md +0 -636
  37. package/docs/ARCHITECTURE_COMPARISON_AND_RECOMMENDATIONS.md +0 -627
  38. package/docs/HERMES_MEMORY_INGESTION_ANALYSIS.md +0 -440
  39. package/docs/MCP_MEMORY_SERVICE_COMPARATIVE_REVIEW.md +0 -271
  40. package/docs/MEMORY_USEFULNESS_AUDIT.md +0 -371
  41. package/docs/MEMORY_USEFULNESS_AUDIT_RAW.json +0 -80
  42. package/docs/MEMSEARCH_PROJECT_STRUCTURE_ANALYSIS.md +0 -333
  43. package/docs/MEMU_ADOPTION.md +0 -40
  44. package/docs/OPERATIONS.md +0 -18
  45. package/docs/PRODUCT_VALIDATION_MATRIX.md +0 -82
  46. package/docs/PROJECT_STRUCTURE_ANALYSIS.md +0 -421
  47. package/docs/REFACTORING_MILESTONES_AND_ISSUES.md +0 -501
  48. package/docs/REFACTORING_PLAN_THIN_CORE.md +0 -414
  49. package/docs/REFERENCE_PROJECT_ANALYSES.md +0 -25
  50. package/docs/SUPERLOCALMEMORY_PROJECT_STRUCTURE_ANALYSIS.md +0 -452
  51. package/docs/TARGET_ARCHITECTURE_AND_FOLDER_STRUCTURE.md +0 -446
  52. package/docs/architecture/comparison-index.md +0 -47
  53. package/docs/reports/codex-real-data-validation-20260505T040447Z.md +0 -46
  54. package/plan.md +0 -1642
  55. package/scripts/build.ts +0 -159
  56. package/scripts/bump-patch-version.sh +0 -18
  57. package/scripts/delete-unknown-projects.js +0 -154
  58. package/scripts/fix-sync-gap.js +0 -32
  59. package/scripts/generate-session-qrels.ts +0 -126
  60. package/scripts/heartbeat-memory-orchestrator.sh +0 -28
  61. package/scripts/replay-retrieval-benchmark.ts +0 -69
  62. package/scripts/report-sync-gap.js +0 -26
  63. package/scripts/review-queue-auto-resolve.js +0 -21
  64. package/scripts/sync-gap-auto-heal.sh +0 -17
  65. package/spec.md +0 -624
  66. package/specs/20260207-dashboard-upgrade/context.md +0 -38
  67. package/specs/20260207-dashboard-upgrade/spec.md +0 -96
  68. package/specs/citations-system/context.md +0 -243
  69. package/specs/citations-system/plan.md +0 -495
  70. package/specs/citations-system/spec.md +0 -371
  71. package/specs/endless-mode/context.md +0 -305
  72. package/specs/endless-mode/plan.md +0 -620
  73. package/specs/endless-mode/spec.md +0 -455
  74. package/specs/entity-edge-model/context.md +0 -401
  75. package/specs/entity-edge-model/plan.md +0 -459
  76. package/specs/entity-edge-model/spec.md +0 -391
  77. package/specs/evidence-aligner-v2/context.md +0 -401
  78. package/specs/evidence-aligner-v2/plan.md +0 -303
  79. package/specs/evidence-aligner-v2/spec.md +0 -312
  80. package/specs/mcp-desktop-integration/context.md +0 -278
  81. package/specs/mcp-desktop-integration/plan.md +0 -550
  82. package/specs/mcp-desktop-integration/spec.md +0 -494
  83. package/specs/memory-utilization-improvements/context.md +0 -145
  84. package/specs/memory-utilization-improvements/plan.md +0 -361
  85. package/specs/memory-utilization-improvements/spec.md +0 -361
  86. package/specs/post-tool-use-hook/context.md +0 -319
  87. package/specs/post-tool-use-hook/plan.md +0 -469
  88. package/specs/post-tool-use-hook/spec.md +0 -364
  89. package/specs/private-tags/context.md +0 -288
  90. package/specs/private-tags/plan.md +0 -412
  91. package/specs/private-tags/spec.md +0 -345
  92. package/specs/progressive-disclosure/context.md +0 -346
  93. package/specs/progressive-disclosure/plan.md +0 -663
  94. package/specs/progressive-disclosure/spec.md +0 -415
  95. package/specs/selective-tool-observation/context.md +0 -100
  96. package/specs/selective-tool-observation/plan.md +0 -158
  97. package/specs/selective-tool-observation/spec.md +0 -127
  98. package/specs/task-entity-system/context.md +0 -297
  99. package/specs/task-entity-system/plan.md +0 -301
  100. package/specs/task-entity-system/spec.md +0 -314
  101. package/specs/thin-core-refactor/context.md +0 -275
  102. package/specs/thin-core-refactor/plan.md +0 -536
  103. package/specs/thin-core-refactor/spec.md +0 -465
  104. package/specs/vector-outbox-v2/context.md +0 -470
  105. package/specs/vector-outbox-v2/plan.md +0 -562
  106. package/specs/vector-outbox-v2/spec.md +0 -466
  107. package/specs/web-viewer-ui/context.md +0 -384
  108. package/specs/web-viewer-ui/plan.md +0 -797
  109. package/specs/web-viewer-ui/spec.md +0 -516
  110. package/src/adapters/claude/capture/index.ts +0 -3
  111. package/src/adapters/claude/context/index.ts +0 -3
  112. package/src/adapters/claude/hooks/index.ts +0 -21
  113. package/src/adapters/claude/hooks/post-tool-use.ts +0 -239
  114. package/src/adapters/claude/hooks/prompt-injection-policy.ts +0 -104
  115. package/src/adapters/claude/hooks/semantic-daemon-client.ts +0 -209
  116. package/src/adapters/claude/hooks/semantic-daemon.ts +0 -283
  117. package/src/adapters/claude/hooks/session-end.ts +0 -59
  118. package/src/adapters/claude/hooks/session-start.ts +0 -73
  119. package/src/adapters/claude/hooks/stop.ts +0 -128
  120. package/src/adapters/claude/hooks/user-prompt-submit.ts +0 -361
  121. package/src/adapters/claude/index.ts +0 -4
  122. package/src/adapters/claude/transcript/index.ts +0 -4
  123. package/src/adapters/claude/transcript/transcript-reader.ts +0 -57
  124. package/src/adapters/claude/transcript/turn-reconstructor.ts +0 -65
  125. package/src/apps/cli/claude-settings-hooks.ts +0 -138
  126. package/src/apps/cli/codex-import-runner.ts +0 -125
  127. package/src/apps/cli/codex-validation-output.ts +0 -95
  128. package/src/apps/cli/hermes-import-runner.ts +0 -130
  129. package/src/apps/cli/hermes-validation-output.ts +0 -91
  130. package/src/apps/cli/index.ts +0 -1735
  131. package/src/apps/cli/mcp-install.ts +0 -106
  132. package/src/apps/cli/retrieval-disclosure-output.ts +0 -196
  133. package/src/apps/dashboard/assets/js/bootstrap.js +0 -244
  134. package/src/apps/dashboard/assets/js/chat.js +0 -373
  135. package/src/apps/dashboard/assets/js/disclosure.js +0 -232
  136. package/src/apps/dashboard/assets/js/modals.js +0 -298
  137. package/src/apps/dashboard/assets/js/overview.js +0 -655
  138. package/src/apps/dashboard/assets/js/state.js +0 -72
  139. package/src/apps/dashboard/assets/js/views.js +0 -468
  140. package/src/apps/dashboard/index.html +0 -543
  141. package/src/apps/dashboard/index.ts +0 -3
  142. package/src/apps/dashboard/style.css +0 -1750
  143. package/src/apps/index.ts +0 -5
  144. package/src/apps/server/api/chat.ts +0 -244
  145. package/src/apps/server/api/citations.ts +0 -105
  146. package/src/apps/server/api/events.ts +0 -137
  147. package/src/apps/server/api/health.ts +0 -53
  148. package/src/apps/server/api/index.ts +0 -26
  149. package/src/apps/server/api/projects.ts +0 -74
  150. package/src/apps/server/api/search.ts +0 -184
  151. package/src/apps/server/api/sessions.ts +0 -115
  152. package/src/apps/server/api/stats.ts +0 -723
  153. package/src/apps/server/api/turns.ts +0 -143
  154. package/src/apps/server/api/utils.ts +0 -65
  155. package/src/apps/server/index.ts +0 -111
  156. package/src/cli/index.ts +0 -3
  157. package/src/cli/retrieval-disclosure-output.ts +0 -2
  158. package/src/compat/index.ts +0 -5
  159. package/src/core/canonical-key.ts +0 -186
  160. package/src/core/citation-generator.ts +0 -63
  161. package/src/core/consolidated-store.ts +0 -356
  162. package/src/core/consolidation-worker.ts +0 -493
  163. package/src/core/context-formatter.ts +0 -276
  164. package/src/core/continuity-manager.ts +0 -341
  165. package/src/core/db-wrapper.ts +0 -64
  166. package/src/core/derive/fact-deriver.ts +0 -170
  167. package/src/core/derive/index.ts +0 -2
  168. package/src/core/derive/summary-deriver.ts +0 -76
  169. package/src/core/edge-repo.ts +0 -333
  170. package/src/core/embedder.ts +0 -4
  171. package/src/core/engine/embedding-maintenance-service.ts +0 -187
  172. package/src/core/engine/endless-memory-services.ts +0 -4
  173. package/src/core/engine/index.ts +0 -19
  174. package/src/core/engine/memory-engine-services.ts +0 -170
  175. package/src/core/engine/memory-ingest-service.ts +0 -317
  176. package/src/core/engine/memory-query-service.ts +0 -173
  177. package/src/core/engine/memory-runtime-service.ts +0 -162
  178. package/src/core/engine/memory-service-composition.ts +0 -231
  179. package/src/core/engine/retrieval-analytics-service.ts +0 -181
  180. package/src/core/engine/retrieval-disclosure-service.ts +0 -420
  181. package/src/core/engine/retrieval-orchestrator.ts +0 -377
  182. package/src/core/engine/retrieval-services.ts +0 -176
  183. package/src/core/engine/shared-memory-services.ts +0 -4
  184. package/src/core/entity-repo.ts +0 -349
  185. package/src/core/event-store.ts +0 -779
  186. package/src/core/evidence-aligner.ts +0 -635
  187. package/src/core/external-market-context.ts +0 -582
  188. package/src/core/graduation-worker.ts +0 -171
  189. package/src/core/graduation.ts +0 -377
  190. package/src/core/index.ts +0 -64
  191. package/src/core/ingest-interceptor.ts +0 -80
  192. package/src/core/markdown-mirror.ts +0 -70
  193. package/src/core/matcher.ts +0 -208
  194. package/src/core/md-mirror.ts +0 -92
  195. package/src/core/metadata-extractor.ts +0 -203
  196. package/src/core/model/memory-fact.ts +0 -30
  197. package/src/core/model/memory-rule.ts +0 -14
  198. package/src/core/model/memory-summary.ts +0 -21
  199. package/src/core/model/raw-event.ts +0 -28
  200. package/src/core/model/retrieval-result.ts +0 -35
  201. package/src/core/mongo-sync-config.ts +0 -165
  202. package/src/core/mongo-sync-worker.ts +0 -381
  203. package/src/core/privacy/filter.ts +0 -190
  204. package/src/core/privacy/index.ts +0 -20
  205. package/src/core/privacy/tag-parser.ts +0 -145
  206. package/src/core/product-validation-matrix.ts +0 -314
  207. package/src/core/progressive-retriever.ts +0 -414
  208. package/src/core/registry/project-path.ts +0 -54
  209. package/src/core/registry/session-registry.ts +0 -69
  210. package/src/core/replay-evaluator.ts +0 -625
  211. package/src/core/retrieval-benchmark.ts +0 -117
  212. package/src/core/retrieval-quality.ts +0 -109
  213. package/src/core/retriever.ts +0 -800
  214. package/src/core/session-qrels.ts +0 -360
  215. package/src/core/shared-event-store.ts +0 -114
  216. package/src/core/shared-promoter.ts +0 -249
  217. package/src/core/shared-store.ts +0 -289
  218. package/src/core/shared-vector-store.ts +0 -203
  219. package/src/core/sqlite-event-store.ts +0 -1846
  220. package/src/core/sqlite-wrapper.ts +0 -116
  221. package/src/core/sync-worker.ts +0 -228
  222. package/src/core/tag-taxonomy.ts +0 -51
  223. package/src/core/task/blocker-resolver.ts +0 -333
  224. package/src/core/task/index.ts +0 -9
  225. package/src/core/task/task-matcher.ts +0 -240
  226. package/src/core/task/task-projector.ts +0 -358
  227. package/src/core/task/task-resolver.ts +0 -421
  228. package/src/core/turn-state.ts +0 -207
  229. package/src/core/types.ts +0 -952
  230. package/src/core/vector-outbox.ts +0 -299
  231. package/src/core/vector-store.ts +0 -231
  232. package/src/core/vector-worker.ts +0 -521
  233. package/src/core/working-set-store.ts +0 -257
  234. package/src/extensions/endless-memory/endless-memory-services.ts +0 -350
  235. package/src/extensions/endless-memory/index.ts +0 -1
  236. package/src/extensions/index.ts +0 -5
  237. package/src/extensions/mcp/handlers.ts +0 -960
  238. package/src/extensions/mcp/index.ts +0 -48
  239. package/src/extensions/mcp/tools.ts +0 -252
  240. package/src/extensions/shared-memory/index.ts +0 -1
  241. package/src/extensions/shared-memory/shared-memory-services.ts +0 -211
  242. package/src/extensions/vector/embedder.ts +0 -233
  243. package/src/extensions/vector/index.ts +0 -1
  244. package/src/hooks/post-tool-use.ts +0 -9
  245. package/src/hooks/semantic-daemon-client.ts +0 -1
  246. package/src/hooks/semantic-daemon.ts +0 -11
  247. package/src/hooks/session-end.ts +0 -9
  248. package/src/hooks/session-start.ts +0 -9
  249. package/src/hooks/stop.ts +0 -9
  250. package/src/hooks/user-prompt-submit.ts +0 -9
  251. package/src/index.ts +0 -13
  252. package/src/mcp/handlers.ts +0 -2
  253. package/src/mcp/index.ts +0 -4
  254. package/src/mcp/tools.ts +0 -2
  255. package/src/server/api/chat.ts +0 -2
  256. package/src/server/api/citations.ts +0 -2
  257. package/src/server/api/events.ts +0 -2
  258. package/src/server/api/health.ts +0 -2
  259. package/src/server/api/index.ts +0 -2
  260. package/src/server/api/projects.ts +0 -2
  261. package/src/server/api/search.ts +0 -2
  262. package/src/server/api/sessions.ts +0 -2
  263. package/src/server/api/stats.ts +0 -2
  264. package/src/server/api/turns.ts +0 -2
  265. package/src/server/api/utils.ts +0 -2
  266. package/src/server/index.ts +0 -2
  267. package/src/services/bootstrap-organizer.ts +0 -463
  268. package/src/services/codex-session-history-importer.ts +0 -966
  269. package/src/services/hermes-session-history-importer.ts +0 -733
  270. package/src/services/memory-service-config.ts +0 -36
  271. package/src/services/memory-service-registry.ts +0 -150
  272. package/src/services/memory-service.ts +0 -688
  273. package/src/services/session-history-importer.ts +0 -629
  274. package/tests/README.md +0 -23
  275. package/tests/adapters/claude/claude-semantic-daemon-adapter.test.ts +0 -54
  276. package/tests/adapters/claude/claude-transcript-reconstructor.test.ts +0 -98
  277. package/tests/adapters/claude-hook-prompt-injection-policy.test.ts +0 -99
  278. package/tests/apps/app-layer-boundary.test.ts +0 -48
  279. package/tests/apps/claude-settings-hooks.test.ts +0 -107
  280. package/tests/apps/cli-disclosure-output.test.ts +0 -212
  281. package/tests/apps/codex-import-runner.test.ts +0 -99
  282. package/tests/apps/codex-validation-output.test.ts +0 -100
  283. package/tests/apps/hermes-import-runner.test.ts +0 -99
  284. package/tests/apps/mcp-install-command.test.ts +0 -59
  285. package/tests/apps/package-build-entrypoints.test.ts +0 -30
  286. package/tests/apps/postinstall-embedding-backend.test.ts +0 -175
  287. package/tests/apps/search-api-disclosure.test.ts +0 -162
  288. package/tests/apps/stats-api-lightweight.test.ts +0 -67
  289. package/tests/apps/ui-disclosure-output.test.ts +0 -140
  290. package/tests/core/bootstrap-organizer.test.ts +0 -111
  291. package/tests/core/canonical-key.test.ts +0 -101
  292. package/tests/core/codex-session-history-importer-validation.test.ts +0 -185
  293. package/tests/core/consolidation-worker.test.ts +0 -75
  294. package/tests/core/embedding-maintenance-service.test.ts +0 -282
  295. package/tests/core/evidence-aligner.test.ts +0 -152
  296. package/tests/core/external-market-context.test.ts +0 -209
  297. package/tests/core/fact-deriver.test.ts +0 -79
  298. package/tests/core/hermes-session-history-importer-validation.test.ts +0 -609
  299. package/tests/core/ingest-interceptor.test.ts +0 -38
  300. package/tests/core/markdown-mirror.test.ts +0 -85
  301. package/tests/core/matcher.test.ts +0 -112
  302. package/tests/core/md-mirror.test.ts +0 -50
  303. package/tests/core/memory-engine-services.test.ts +0 -240
  304. package/tests/core/memory-ingest-service.test.ts +0 -296
  305. package/tests/core/memory-query-service.test.ts +0 -129
  306. package/tests/core/memory-runtime-service.test.ts +0 -201
  307. package/tests/core/memory-service-composition.test.ts +0 -192
  308. package/tests/core/memory-service-config.test.ts +0 -41
  309. package/tests/core/memory-service-facade.test.ts +0 -30
  310. package/tests/core/memory-service-registry.test.ts +0 -206
  311. package/tests/core/product-validation-matrix.test.ts +0 -61
  312. package/tests/core/project-registry.test.ts +0 -78
  313. package/tests/core/replay-evaluator.test.ts +0 -181
  314. package/tests/core/retrieval-analytics-service.test.ts +0 -210
  315. package/tests/core/retrieval-benchmark.test.ts +0 -93
  316. package/tests/core/retrieval-disclosure-service.test.ts +0 -264
  317. package/tests/core/retrieval-orchestrator.test.ts +0 -403
  318. package/tests/core/retrieval-quality.test.ts +0 -31
  319. package/tests/core/retrieval-services.test.ts +0 -185
  320. package/tests/core/retriever-fallback-chain.test.ts +0 -223
  321. package/tests/core/retriever-strategy-scope.test.ts +0 -164
  322. package/tests/core/retriever.memu-adoption.test.ts +0 -122
  323. package/tests/core/session-history-importer-filter.test.ts +0 -78
  324. package/tests/core/session-qrels.test.ts +0 -250
  325. package/tests/core/sqlite-event-store-replication.test.ts +0 -127
  326. package/tests/core/summary-deriver.test.ts +0 -66
  327. package/tests/extensions/embedder-warning-suppression.test.ts +0 -83
  328. package/tests/extensions/endless-memory-extension-boundary.test.ts +0 -17
  329. package/tests/extensions/endless-memory-services.test.ts +0 -325
  330. package/tests/extensions/mcp-context-tools.test.ts +0 -905
  331. package/tests/extensions/mcp-extension-boundary.test.ts +0 -21
  332. package/tests/extensions/mcp-package-build.test.ts +0 -22
  333. package/tests/extensions/mcp-project-aware-tools.test.ts +0 -102
  334. package/tests/extensions/shared-memory-extension-boundary.test.ts +0 -24
  335. package/tests/extensions/shared-memory-services.test.ts +0 -309
  336. package/tests/extensions/vector-extension-boundary.test.ts +0 -21
  337. package/tsconfig.json +0 -24
  338. package/vitest.config.ts +0 -15
@@ -1,905 +0,0 @@
1
- import { beforeEach, describe, expect, it, vi } from 'vitest';
2
-
3
- import { generateCitationId } from '../../src/core/citation-generator.js';
4
- import type { MemoryEvent } from '../../src/core/types.js';
5
-
6
- const mocks = vi.hoisted(() => {
7
- function createService() {
8
- return {
9
- initialize: vi.fn(async () => undefined),
10
- retrieveMemories: vi.fn(),
11
- getRecentEvents: vi.fn(),
12
- getStats: vi.fn(),
13
- processPendingEmbeddings: vi.fn()
14
- };
15
- }
16
-
17
- const defaultService = createService();
18
- const projectService = createService();
19
- const claudeImporter = { importProject: vi.fn() };
20
- const codexImporter = { importProject: vi.fn() };
21
- const hermesImporter = { importProject: vi.fn() };
22
-
23
- return {
24
- defaultService,
25
- projectService,
26
- claudeImporter,
27
- codexImporter,
28
- hermesImporter,
29
- fetchExternalMarketContext: vi.fn(),
30
- renderExternalMarketContextReport: vi.fn(),
31
- getDefaultMemoryService: vi.fn(() => defaultService),
32
- getMemoryServiceForProject: vi.fn(() => projectService),
33
- createSessionHistoryImporter: vi.fn(() => claudeImporter),
34
- createCodexSessionHistoryImporter: vi.fn(() => codexImporter),
35
- createHermesSessionHistoryImporter: vi.fn(() => hermesImporter)
36
- };
37
- });
38
-
39
- vi.mock('../../src/services/memory-service.js', () => ({
40
- getDefaultMemoryService: mocks.getDefaultMemoryService,
41
- getMemoryServiceForProject: mocks.getMemoryServiceForProject
42
- }));
43
-
44
- vi.mock('../../src/services/session-history-importer.js', () => ({
45
- createSessionHistoryImporter: mocks.createSessionHistoryImporter
46
- }));
47
-
48
- vi.mock('../../src/services/codex-session-history-importer.js', () => ({
49
- createCodexSessionHistoryImporter: mocks.createCodexSessionHistoryImporter
50
- }));
51
-
52
- vi.mock('../../src/services/hermes-session-history-importer.js', () => ({
53
- createHermesSessionHistoryImporter: mocks.createHermesSessionHistoryImporter
54
- }));
55
-
56
- vi.mock('../../src/core/external-market-context.js', () => ({
57
- fetchExternalMarketContext: mocks.fetchExternalMarketContext,
58
- renderExternalMarketContextReport: mocks.renderExternalMarketContextReport
59
- }));
60
-
61
- const { handleToolCall } = await import('../../src/extensions/mcp/handlers.js');
62
- const { tools } = await import('../../src/extensions/mcp/tools.js');
63
-
64
- function resetService(service: typeof mocks.defaultService) {
65
- service.initialize.mockReset().mockResolvedValue(undefined);
66
- service.retrieveMemories.mockReset().mockResolvedValue({ memories: [] });
67
- service.getRecentEvents.mockReset().mockResolvedValue([]);
68
- service.getStats.mockReset().mockResolvedValue({ totalEvents: 0, vectorCount: 0, levelStats: [] });
69
- service.processPendingEmbeddings.mockReset().mockResolvedValue(0);
70
- }
71
-
72
- function resetImporter(importer: typeof mocks.claudeImporter) {
73
- importer.importProject.mockReset().mockResolvedValue({
74
- totalSessions: 0,
75
- totalMessages: 0,
76
- importedPrompts: 0,
77
- importedResponses: 0,
78
- skippedDuplicates: 0,
79
- errors: []
80
- });
81
- }
82
-
83
- function event(overrides: Partial<MemoryEvent>): MemoryEvent {
84
- return {
85
- id: 'event-1',
86
- eventType: 'user_prompt',
87
- sessionId: 'session-a',
88
- timestamp: new Date('2026-05-05T00:00:00.000Z'),
89
- content: 'memory content',
90
- canonicalKey: 'canonical:event-1',
91
- dedupeKey: 'dedupe:event-1',
92
- metadata: {},
93
- ...overrides
94
- };
95
- }
96
-
97
- function textOf(result: Awaited<ReturnType<typeof handleToolCall>>): string {
98
- return String(result.content[0]?.text ?? '');
99
- }
100
-
101
- describe('MCP project context tools', () => {
102
- beforeEach(() => {
103
- resetService(mocks.defaultService);
104
- resetService(mocks.projectService);
105
- resetImporter(mocks.claudeImporter);
106
- resetImporter(mocks.codexImporter);
107
- resetImporter(mocks.hermesImporter);
108
- mocks.getDefaultMemoryService.mockClear();
109
- mocks.getMemoryServiceForProject.mockClear();
110
- mocks.createSessionHistoryImporter.mockClear();
111
- mocks.createCodexSessionHistoryImporter.mockClear();
112
- mocks.createHermesSessionHistoryImporter.mockClear();
113
- mocks.fetchExternalMarketContext.mockReset().mockResolvedValue({ analysis: { marketSnapshot: { schemaVersion: 'market-context-snapshot.v1' } } });
114
- mocks.renderExternalMarketContextReport.mockReset().mockReturnValue('### MarketContextSnapshot\n**Bull case**\n**Bear case**\n**Risks**\n**Catalysts**');
115
- });
116
-
117
- it('advertises context-pack, import-latest, project-timeline, and source-ref tools with projectPath support', () => {
118
- const byName = new Map(tools.map((tool) => [tool.name, tool]));
119
-
120
- for (const name of ['mem-context-pack', 'mem-import-latest', 'mem-project-timeline', 'mem-source-ref', 'external-market-context']) {
121
- const tool = byName.get(name);
122
- expect(tool).toBeDefined();
123
- expect(tool?.inputSchema).toMatchObject({ type: 'object' });
124
- const properties = tool?.inputSchema.properties as Record<string, unknown>;
125
- expect(properties.projectPath).toMatchObject({
126
- type: 'string',
127
- description: expect.stringContaining('project')
128
- });
129
- }
130
-
131
- const contextPackProperties = byName.get('mem-context-pack')?.inputSchema.properties as Record<string, unknown>;
132
- expect(contextPackProperties.refreshLatest).toMatchObject({
133
- type: 'boolean',
134
- description: expect.stringContaining('Explicit opt-in')
135
- });
136
- const marketContextProperties = byName.get('external-market-context')?.inputSchema.properties as Record<string, unknown>;
137
- expect(marketContextProperties.projectPath).toMatchObject({ type: 'string' });
138
- expect(marketContextProperties.includeSnapshot).toMatchObject({ type: 'boolean' });
139
- });
140
-
141
- it('handles external-market-context before memory service initialization and renders a read-only report', async () => {
142
- const result = await handleToolCall('external-market-context', {
143
- company: '삼성전자',
144
- dartCorpCode: '00126380',
145
- symbol: '005930.KS',
146
- providers: ['dart', 'fred', 'finnhub'],
147
- fredSeries: ['FEDFUNDS'],
148
- includeSnapshot: true,
149
- projectPath: '/repo/app'
150
- });
151
-
152
- expect(result.isError).not.toBe(true);
153
- expect(textOf(result)).toContain('MarketContextSnapshot');
154
- expect(mocks.defaultService.initialize).not.toHaveBeenCalled();
155
- expect(mocks.projectService.initialize).not.toHaveBeenCalled();
156
- expect(mocks.getMemoryServiceForProject).not.toHaveBeenCalled();
157
- expect(mocks.fetchExternalMarketContext).toHaveBeenCalledWith(expect.objectContaining({
158
- company: '삼성전자',
159
- dartCorpCode: '00126380',
160
- symbol: '005930.KS',
161
- providers: ['dart', 'fred', 'finnhub'],
162
- fredSeries: ['FEDFUNDS'],
163
- includeSnapshot: true
164
- }));
165
- });
166
-
167
- it('rejects invalid external-market-context providers before external fetch or memory initialization', async () => {
168
- const result = await handleToolCall('external-market-context', {
169
- company: '삼성전자',
170
- providers: ['dart', 'bogus']
171
- });
172
-
173
- expect(result.isError).toBe(true);
174
- expect(textOf(result)).toContain('Invalid providers');
175
- expect(mocks.fetchExternalMarketContext).not.toHaveBeenCalled();
176
- expect(mocks.defaultService.initialize).not.toHaveBeenCalled();
177
- expect(mocks.getMemoryServiceForProject).not.toHaveBeenCalled();
178
- });
179
-
180
- it('imports the latest selected project sessions through a privacy-safe MCP freshness tool', async () => {
181
- mocks.hermesImporter.importProject.mockResolvedValue({
182
- totalSessions: 1,
183
- totalMessages: 4,
184
- importedPrompts: 2,
185
- importedResponses: 2,
186
- skippedDuplicates: 0,
187
- errors: []
188
- });
189
- mocks.codexImporter.importProject.mockResolvedValue({
190
- totalSessions: 1,
191
- totalMessages: 3,
192
- importedPrompts: 1,
193
- importedResponses: 2,
194
- skippedDuplicates: 1,
195
- errors: []
196
- });
197
- mocks.projectService.processPendingEmbeddings.mockResolvedValue(5);
198
-
199
- const result = await handleToolCall('mem-import-latest', {
200
- projectPath: '/repo/app',
201
- sources: ['hermes', 'codex'],
202
- sessionLimit: 2,
203
- messageLimit: 50,
204
- force: true,
205
- processEmbeddings: true,
206
- stateDb: '/tmp/local-hermes-state.db',
207
- sessionsDir: '/tmp/local-codex-sessions'
208
- });
209
-
210
- const text = textOf(result);
211
- expect(result.isError).not.toBe(true);
212
- expect(mocks.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/app');
213
- expect(mocks.createHermesSessionHistoryImporter).toHaveBeenCalledWith(mocks.projectService, { stateDbPath: '/tmp/local-hermes-state.db' });
214
- expect(mocks.createCodexSessionHistoryImporter).toHaveBeenCalledWith(mocks.projectService, { sessionsDir: '/tmp/local-codex-sessions' });
215
- expect(mocks.hermesImporter.importProject).toHaveBeenCalledWith('/repo/app', {
216
- projectPath: '/repo/app',
217
- sessionLimit: 2,
218
- limit: 50,
219
- force: true
220
- });
221
- expect(mocks.codexImporter.importProject).toHaveBeenCalledWith('/repo/app', {
222
- projectPath: '/repo/app',
223
- sessionLimit: 2,
224
- limit: 50,
225
- force: true
226
- });
227
- expect(mocks.projectService.processPendingEmbeddings).toHaveBeenCalledTimes(1);
228
- expect(text).toContain('## Latest Session Import');
229
- expect(text).toContain('- Project: supplied');
230
- expect(text).not.toContain('app');
231
- expect(text).toContain('- hermes: sessions=1 messages=4 prompts=2 responses=2 skipped=0 errors=0');
232
- expect(text).toContain('- codex: sessions=1 messages=3 prompts=1 responses=2 skipped=1 errors=0');
233
- expect(text).toContain('Embeddings: processed 5');
234
- expect(text).not.toContain('/tmp/local-hermes-state.db');
235
- expect(text).not.toContain('/tmp/local-codex-sessions');
236
- });
237
-
238
- it('rejects mem-import-latest without an absolute projectPath before opening project storage', async () => {
239
- const result = await handleToolCall('mem-import-latest', {
240
- projectPath: 'relative/app',
241
- sources: ['hermes']
242
- });
243
-
244
- const text = textOf(result);
245
- expect(result.isError).toBe(true);
246
- expect(text).toContain('requires an explicit absolute projectPath');
247
- expect(mocks.getMemoryServiceForProject).not.toHaveBeenCalled();
248
- expect(mocks.createHermesSessionHistoryImporter).not.toHaveBeenCalled();
249
- });
250
-
251
- it('fails closed for invalid mem-import-latest sources before importing', async () => {
252
- const result = await handleToolCall('mem-import-latest', {
253
- projectPath: '/repo/app',
254
- sources: ['hermes', 'unknown']
255
- });
256
-
257
- const text = textOf(result);
258
- expect(result.isError).toBe(true);
259
- expect(text).toContain('Invalid source');
260
- expect(text).not.toContain('unknown');
261
- expect(mocks.createHermesSessionHistoryImporter).not.toHaveBeenCalled();
262
- expect(mocks.createCodexSessionHistoryImporter).not.toHaveBeenCalled();
263
- expect(mocks.createSessionHistoryImporter).not.toHaveBeenCalled();
264
- });
265
-
266
- it('redacts local paths from mem-import-latest source failures', async () => {
267
- mocks.hermesImporter.importProject.mockRejectedValue(new Error('failed to open /repo/app/private/state.db and C:\\Users\\me\\secret\\state.db'));
268
-
269
- const result = await handleToolCall('mem-import-latest', {
270
- projectPath: '/repo/app',
271
- sources: ['hermes']
272
- });
273
-
274
- const text = textOf(result);
275
- expect(result.isError).not.toBe(true);
276
- expect(text).toContain('- Project: supplied');
277
- expect(text).toContain('- hermes: failed');
278
- expect(text).toContain('[path]');
279
- expect(text).not.toContain('/repo/app');
280
- expect(text).not.toContain('C:\\Users\\me');
281
- expect(text).not.toContain('state.db');
282
- });
283
-
284
- it('refreshes latest sessions before building a context pack when explicitly requested', async () => {
285
- mocks.hermesImporter.importProject.mockResolvedValue({
286
- totalSessions: 1,
287
- totalMessages: 2,
288
- importedPrompts: 1,
289
- importedResponses: 1,
290
- skippedDuplicates: 0,
291
- errors: []
292
- });
293
- mocks.projectService.processPendingEmbeddings.mockResolvedValue(3);
294
- mocks.projectService.getRecentEvents.mockResolvedValue([
295
- event({
296
- id: '33333333-3333-4333-8333-333333333333',
297
- sessionId: 'hermes:fresh-session',
298
- eventType: 'agent_response',
299
- timestamp: new Date('2026-05-05T03:00:00.000Z'),
300
- content: 'Freshly imported context-pack auto-refresh implementation checkpoint.'
301
- })
302
- ]);
303
-
304
- const result = await handleToolCall('mem-context-pack', {
305
- projectPath: '/repo/app',
306
- query: 'continue',
307
- refreshLatest: true,
308
- refreshSources: ['hermes'],
309
- refreshSessionLimit: 2,
310
- refreshMessageLimit: 50,
311
- refreshForce: true,
312
- refreshEmbeddings: true,
313
- stateDb: '/tmp/local-hermes-state.db'
314
- });
315
-
316
- const text = textOf(result);
317
- expect(result.isError).not.toBe(true);
318
- expect(mocks.createHermesSessionHistoryImporter).toHaveBeenCalledWith(mocks.projectService, { stateDbPath: '/tmp/local-hermes-state.db' });
319
- expect(mocks.hermesImporter.importProject).toHaveBeenCalledWith('/repo/app', {
320
- projectPath: '/repo/app',
321
- sessionLimit: 2,
322
- limit: 50,
323
- force: true
324
- });
325
- expect(mocks.projectService.processPendingEmbeddings).toHaveBeenCalledTimes(1);
326
- expect(mocks.hermesImporter.importProject.mock.invocationCallOrder[0]).toBeLessThan(
327
- mocks.projectService.retrieveMemories.mock.invocationCallOrder[0]
328
- );
329
- expect(mocks.hermesImporter.importProject.mock.invocationCallOrder[0]).toBeLessThan(
330
- mocks.projectService.getRecentEvents.mock.invocationCallOrder[0]
331
- );
332
- expect(text).toContain('- Freshness refresh: attempted before retrieval (hermes)');
333
- expect(text).toContain('- Refresh limits: sessions=2 messages=50 force=yes embeddings=processed 3');
334
- expect(text).toContain('- hermes: sessions=1 messages=2 prompts=1 responses=1 skipped=0 errors=0');
335
- expect(text).toContain('Freshly imported context-pack auto-refresh implementation checkpoint.');
336
- expect(text).not.toContain('/repo/app');
337
- expect(text).not.toContain('/tmp/local-hermes-state.db');
338
- });
339
-
340
- it('rejects mem-context-pack refreshLatest without opening project storage when projectPath is not absolute', async () => {
341
- const result = await handleToolCall('mem-context-pack', {
342
- projectPath: 'relative/app',
343
- query: 'continue',
344
- refreshLatest: true
345
- });
346
-
347
- const text = textOf(result);
348
- expect(result.isError).toBe(true);
349
- expect(text).toContain('mem-context-pack refreshLatest requires an explicit absolute projectPath');
350
- expect(mocks.getMemoryServiceForProject).not.toHaveBeenCalled();
351
- expect(mocks.createHermesSessionHistoryImporter).not.toHaveBeenCalled();
352
- expect(mocks.projectService.retrieveMemories).not.toHaveBeenCalled();
353
- });
354
-
355
- it('builds a compact project context pack from relevant search results and recent timeline', async () => {
356
- const relevant = event({
357
- id: '11111111-1111-4111-8111-111111111111',
358
- sessionId: 'session-codex',
359
- timestamp: new Date('2026-05-05T01:00:00.000Z'),
360
- content: 'Codex import CLI and project-aware MCP integration were implemented.'
361
- });
362
- const recent = [
363
- event({
364
- id: '22222222-2222-4222-8222-222222222222',
365
- sessionId: 'session-hermes',
366
- eventType: 'agent_response',
367
- timestamp: new Date('2026-05-05T02:00:00.000Z'),
368
- content: 'Hermes adapter verification passed with targeted tests.',
369
- metadata: { importedFrom: 'hermes' }
370
- }),
371
- relevant,
372
- event({
373
- id: '33333333-3333-4333-8333-333333333333',
374
- sessionId: 'session-old',
375
- timestamp: new Date('2026-05-04T02:00:00.000Z'),
376
- content: 'Older cleanup note.',
377
- metadata: { importedFrom: 'claude-code' }
378
- })
379
- ];
380
-
381
- mocks.projectService.retrieveMemories.mockResolvedValue({ memories: [{ event: relevant, score: 0.93 }] });
382
- mocks.projectService.getRecentEvents.mockResolvedValue(recent);
383
-
384
- const result = await handleToolCall('mem-context-pack', {
385
- projectPath: '/repo/app',
386
- query: 'Codex Hermes MCP integration',
387
- topK: 2,
388
- recentLimit: 3,
389
- sessionLimit: 2
390
- });
391
-
392
- const text = textOf(result);
393
- expect(result.isError).not.toBe(true);
394
- expect(mocks.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/app');
395
- expect(mocks.projectService.retrieveMemories).toHaveBeenCalledWith('Codex Hermes MCP integration', {
396
- topK: 6,
397
- sessionId: undefined,
398
- recordTrace: false
399
- });
400
- expect(mocks.projectService.getRecentEvents).toHaveBeenCalledWith(3);
401
- expect(text).toContain('## Project Context Pack');
402
- expect(text).toContain('### Relevant Memories');
403
- expect(text).toContain('Codex import CLI');
404
- expect(text).toContain('### Recent Project Timeline');
405
- expect(text).toContain('Hermes adapter verification');
406
- expect(text).toContain(`[mem:${generateCitationId(relevant.id)}]`);
407
- expect(text.length).toBeLessThan(5000);
408
- });
409
-
410
- it('prioritizes recent project timeline and suppresses low-signal search noise for generic continuation queries', async () => {
411
- const mergedPr = event({
412
- id: '44444444-4444-4444-8444-444444444444',
413
- sessionId: 'session-latest',
414
- eventType: 'agent_response',
415
- timestamp: new Date('2026-05-06T03:00:00.000Z'),
416
- content: 'Merged CML PR #15 and synced local main; next recommended task is generic context quality hardening.',
417
- metadata: { source: 'hermes' }
418
- });
419
- const genericPrompt = event({
420
- id: '55555555-5555-4555-8555-555555555555',
421
- sessionId: 'session-latest',
422
- timestamp: new Date('2026-05-06T03:01:00.000Z'),
423
- content: '다음 추천작업은 뭐야?',
424
- metadata: { source: 'hermes' }
425
- });
426
- const unrelatedMemory = event({
427
- id: '66666666-6666-4666-8666-666666666666',
428
- sessionId: 'session-old',
429
- timestamp: new Date('2026-04-01T00:00:00.000Z'),
430
- content: 'FinRL stock trading experiments should tune Alpha AI Trader replay settings.'
431
- });
432
- const crossProjectRecentMemory = event({
433
- id: 'dddddddd-dddd-4ddd-8ddd-dddddddddddd',
434
- sessionId: 'session-latest',
435
- eventType: 'agent_response',
436
- timestamp: new Date('2026-05-06T03:04:00.000Z'),
437
- content: 'Created Alpha AI Trader specs at /Users/example/workspace/alpha-ai-trader/specs/ai-korea-stock-trader/plan.md.'
438
- });
439
- const commandArtifact = event({
440
- id: '77777777-7777-4777-8777-777777777777',
441
- sessionId: 'session-latest',
442
- timestamp: new Date('2026-05-06T02:59:00.000Z'),
443
- content: '<command-name>/model</command-name>\n<local-command-stdout>Using model opus</local-command-stdout>'
444
- });
445
- const environmentContext = event({
446
- id: '88888888-8888-4888-8888-888888888888',
447
- sessionId: 'session-latest',
448
- timestamp: new Date('2026-05-06T02:58:00.000Z'),
449
- content: '<environment_context><cwd>/repo/app</cwd><shell>zsh</shell></environment_context>'
450
- });
451
- const latestCommandArtifact = event({
452
- id: 'bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb',
453
- sessionId: 'session-latest',
454
- eventType: 'tool_observation',
455
- timestamp: new Date('2026-05-06T03:03:00.000Z'),
456
- content: '<command-name>/model</command-name>\n<local-command-stdout>Using model opus</local-command-stdout>'
457
- });
458
- const latestEnvironmentContext = event({
459
- id: 'cccccccc-cccc-4ccc-8ccc-cccccccccccc',
460
- sessionId: 'session-latest',
461
- timestamp: new Date('2026-05-06T03:02:00.000Z'),
462
- content: '<environment_context><cwd>/repo/app</cwd><shell>zsh</shell></environment_context>'
463
- });
464
-
465
- mocks.projectService.retrieveMemories.mockResolvedValue({
466
- memories: [
467
- { event: commandArtifact, score: 0.95 },
468
- { event: environmentContext, score: 0.9 },
469
- { event: crossProjectRecentMemory, score: 0.93 },
470
- { event: unrelatedMemory, score: 0.62 },
471
- { event: mergedPr, score: 0.61 }
472
- ]
473
- });
474
- mocks.projectService.getRecentEvents.mockResolvedValue([
475
- latestCommandArtifact,
476
- latestEnvironmentContext,
477
- genericPrompt,
478
- mergedPr
479
- ]);
480
-
481
- const result = await handleToolCall('mem-context-pack', {
482
- projectPath: '/repo/app',
483
- query: '다음 추천작업은 뭐야?',
484
- topK: 3,
485
- recentLimit: 10,
486
- sessionLimit: 2
487
- });
488
-
489
- const text = textOf(result);
490
- expect(result.isError).not.toBe(true);
491
- expect(mocks.projectService.retrieveMemories).toHaveBeenCalledWith('다음 추천작업은 뭐야?', {
492
- topK: 9,
493
- sessionId: undefined,
494
- recordTrace: false
495
- });
496
- expect(text).toContain('Generic continuation query: recent project timeline prioritized.');
497
- expect(text.indexOf('### Recent Project Timeline')).toBeLessThan(text.indexOf('### Relevant Memories'));
498
- expect(text).toContain('Merged CML PR #15');
499
- expect(text).not.toContain('FinRL stock trading');
500
- expect(text).not.toContain('Alpha AI Trader specs');
501
- expect(text).not.toContain('alpha-ai-trader');
502
- expect(text).not.toContain('<command-name>');
503
- expect(text).not.toContain('Using model opus');
504
- expect(text).not.toContain('<environment_context>');
505
- });
506
-
507
- it('keeps generic continuation timeline scoped to the latest work block', async () => {
508
- const newestWork = event({
509
- id: '81818181-8181-4818-8818-818181818181',
510
- sessionId: 'session-current',
511
- eventType: 'agent_response',
512
- timestamp: new Date('2026-05-06T15:04:00.000Z'),
513
- content: 'Continue freshness hardening after PR #18; implement latest-work-block timeline pruning.'
514
- });
515
- const priorSameDayPublish = event({
516
- id: '82828282-8282-4828-8828-828282828282',
517
- sessionId: 'session-publish',
518
- eventType: 'agent_response',
519
- timestamp: new Date('2026-05-06T12:26:00.000Z'),
520
- content: 'Bumped package version and prepared npm publish for claude-memory-layer.'
521
- });
522
- const priorSameDayDuckdb = event({
523
- id: '83838383-8383-4838-8838-838383838383',
524
- sessionId: 'session-duckdb',
525
- eventType: 'agent_response',
526
- timestamp: new Date('2026-05-06T12:27:00.000Z'),
527
- content: 'Diagnosed an x86_64 versus arm64 DuckDB native module mismatch.'
528
- });
529
-
530
- mocks.projectService.getRecentEvents.mockResolvedValue([
531
- newestWork,
532
- priorSameDayPublish,
533
- priorSameDayDuckdb
534
- ]);
535
-
536
- const result = await handleToolCall('mem-context-pack', {
537
- projectPath: '/repo/app',
538
- query: '다음 추천작업은 뭐야?',
539
- topK: 5,
540
- recentLimit: 10,
541
- sessionLimit: 5
542
- });
543
-
544
- const text = textOf(result);
545
- expect(result.isError).not.toBe(true);
546
- expect(text).toContain('- Recent sessions shown: 1');
547
- expect(text).toContain('latest-work-block timeline pruning');
548
- expect(text).not.toContain('npm publish');
549
- expect(text).not.toContain('DuckDB native module mismatch');
550
- });
551
-
552
- it('keeps generic continuation relevant memories sparse and high-confidence', async () => {
553
- const timelineNow = event({
554
- id: '12121212-1212-4212-8212-121212121212',
555
- sessionId: 'session-current',
556
- eventType: 'agent_response',
557
- timestamp: new Date('2026-05-06T04:00:00.000Z'),
558
- content: 'Merged CML PR #17 and reloaded the MCP server; next implementation focus is freshness-aware context filtering.'
559
- });
560
- const weakRecentPublish = event({
561
- id: '23232323-2323-4232-8232-232323232323',
562
- sessionId: 'session-publish',
563
- eventType: 'agent_response',
564
- timestamp: new Date('2026-05-05T12:26:00.000Z'),
565
- content: 'Bumped package version and prepared npm publish for claude-memory-layer.'
566
- });
567
- const weakRecentDuckdb = event({
568
- id: '34343434-3434-4343-8343-343434343434',
569
- sessionId: 'session-duckdb',
570
- eventType: 'agent_response',
571
- timestamp: new Date('2026-05-05T12:27:00.000Z'),
572
- content: 'Diagnosed an x86_64 versus arm64 DuckDB native module mismatch.'
573
- });
574
- const strongFreshnessPlan = event({
575
- id: '45454545-4545-4545-8545-454545454545',
576
- sessionId: 'session-current',
577
- eventType: 'agent_response',
578
- timestamp: new Date('2026-05-06T04:01:00.000Z'),
579
- content: 'Freshness filter design: for generic continuation prompts, suppress weak semantic memories and rely on recent project timeline first.'
580
- });
581
- const strongPrState = event({
582
- id: '56565656-5656-4565-8565-565656565656',
583
- sessionId: 'session-current',
584
- eventType: 'session_summary',
585
- timestamp: new Date('2026-05-06T04:02:00.000Z'),
586
- content: 'Current CML state: PR #17 merged, main synced, MCP runtime reloaded; continue with freshness-aware relevance filtering.'
587
- });
588
- const staleContinuationHandoff = event({
589
- id: '78787878-7878-4787-8787-787878787878',
590
- sessionId: 'session-old-handoff',
591
- eventType: 'agent_response',
592
- timestamp: new Date('2026-05-04T15:10:00.000Z'),
593
- content: 'Understood, stopping here. Let me know when you would like to continue with the design doc review and edits.'
594
- });
595
- const extraStrongButLowerPriority = event({
596
- id: '67676767-6767-4676-8676-676767676767',
597
- sessionId: 'session-current',
598
- eventType: 'agent_response',
599
- timestamp: new Date('2026-05-06T04:03:00.000Z'),
600
- content: 'Additional implementation note that should be omitted because generic continuation relevant memories are capped.'
601
- });
602
-
603
- mocks.projectService.retrieveMemories.mockResolvedValue({
604
- memories: [
605
- { event: staleContinuationHandoff, score: 0.99 },
606
- { event: weakRecentPublish, score: 0.62 },
607
- { event: strongFreshnessPlan, score: 0.82 },
608
- { event: strongPrState, score: 0.8 },
609
- { event: extraStrongButLowerPriority, score: 0.77 },
610
- { event: weakRecentDuckdb, score: 0.6 }
611
- ]
612
- });
613
- mocks.projectService.getRecentEvents.mockResolvedValue([
614
- timelineNow,
615
- weakRecentPublish,
616
- weakRecentDuckdb
617
- ]);
618
-
619
- const result = await handleToolCall('mem-context-pack', {
620
- projectPath: '/repo/app',
621
- query: 'continue',
622
- topK: 5,
623
- recentLimit: 10,
624
- sessionLimit: 3
625
- });
626
-
627
- const text = textOf(result);
628
- expect(result.isError).not.toBe(true);
629
- expect(mocks.projectService.retrieveMemories).toHaveBeenCalledWith('continue', {
630
- topK: 12,
631
- sessionId: undefined,
632
- recordTrace: false
633
- });
634
- expect(text).toContain('- Relevant memories: 2');
635
- expect(text).toContain('Freshness filter design');
636
- expect(text).toContain('Current CML state: PR #17 merged');
637
- expect(text).not.toContain('Bumped package version');
638
- expect(text).not.toContain('DuckDB native module mismatch');
639
- expect(text).not.toContain('Additional implementation note');
640
- expect(text).not.toContain('stopping here');
641
- expect(text).not.toContain('design doc review');
642
- });
643
-
644
- it('keeps non-generic context-pack ordering while suppressing low-signal artifacts', async () => {
645
- const commandArtifact = event({
646
- id: '99999999-9999-4999-8999-999999999999',
647
- sessionId: 'session-debug',
648
- timestamp: new Date('2026-05-06T02:59:00.000Z'),
649
- content: '<command-name>/model</command-name>\n<local-command-stdout>Using model opus</local-command-stdout>'
650
- });
651
- const agentsDump = event({
652
- id: '99999999-9999-4999-8999-999999999998',
653
- sessionId: 'session-debug',
654
- timestamp: new Date('2026-05-06T02:58:00.000Z'),
655
- content: '# AGENTS.md instructions for /repo/app <INSTRUCTIONS> ## Skills A skill is a set of local instructions.'
656
- });
657
- const relevantDebug = event({
658
- id: 'aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa',
659
- sessionId: 'session-debug',
660
- timestamp: new Date('2026-05-06T03:00:00.000Z'),
661
- content: 'Investigated MCP context-pack retrieval ranking for a topic-specific debug query.'
662
- });
663
- const crossProjectTimeline = event({
664
- id: 'eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee',
665
- sessionId: 'session-debug',
666
- eventType: 'agent_response',
667
- timestamp: new Date('2026-05-06T03:01:00.000Z'),
668
- content: 'Created Alpha AI Trader specs at /Users/example/workspace/alpha-ai-trader/specs/ai-korea-stock-trader/plan.md.'
669
- });
670
-
671
- mocks.projectService.retrieveMemories.mockResolvedValue({
672
- memories: [
673
- { event: commandArtifact, score: 0.95 },
674
- { event: agentsDump, score: 0.9 },
675
- { event: relevantDebug, score: 0.8 }
676
- ]
677
- });
678
- mocks.projectService.getRecentEvents.mockResolvedValue([
679
- commandArtifact,
680
- agentsDump,
681
- crossProjectTimeline,
682
- relevantDebug
683
- ]);
684
-
685
- const result = await handleToolCall('mem-context-pack', {
686
- projectPath: '/repo/app',
687
- query: 'debug command artifact retrieval quality',
688
- topK: 2,
689
- recentLimit: 10,
690
- sessionLimit: 2
691
- });
692
-
693
- const text = textOf(result);
694
- expect(result.isError).not.toBe(true);
695
- expect(mocks.projectService.retrieveMemories).toHaveBeenCalledWith('debug command artifact retrieval quality', {
696
- topK: 6,
697
- sessionId: undefined,
698
- recordTrace: false
699
- });
700
- expect(text).not.toContain('Generic continuation query');
701
- expect(text.indexOf('### Relevant Memories')).toBeLessThan(text.indexOf('### Recent Project Timeline'));
702
- expect(text).toContain('Investigated MCP context-pack retrieval ranking');
703
- expect(text).not.toContain('<command-name>');
704
- expect(text).not.toContain('Using model opus');
705
- expect(text).not.toContain('AGENTS.md instructions');
706
- expect(text).not.toContain('<INSTRUCTIONS>');
707
- expect(text).not.toContain('Alpha AI Trader specs');
708
- expect(text).not.toContain('alpha-ai-trader');
709
- });
710
-
711
- it('redacts credential-bearing connection strings from context-pack previews', async () => {
712
- const credentialUri = [
713
- 'mongodb://',
714
- 'fixture-user',
715
- ':',
716
- 'fixture-credential',
717
- '@',
718
- 'db.example.test:27017/admin?authSource=admin'
719
- ].join('');
720
- const sensitiveConnection = event({
721
- id: 'connection-redaction-1',
722
- timestamp: new Date('2026-05-05T01:30:00.000Z'),
723
- content: `Run mongo sync with --mongo-uri ${credentialUri} before checking status.`
724
- });
725
-
726
- mocks.projectService.retrieveMemories.mockResolvedValue({
727
- memories: [{ event: sensitiveConnection, score: 0.9 }]
728
- });
729
- mocks.projectService.getRecentEvents.mockResolvedValue([sensitiveConnection]);
730
-
731
- const result = await handleToolCall('mem-context-pack', {
732
- projectPath: '/repo/app',
733
- query: 'mongo sync status',
734
- topK: 1,
735
- recentLimit: 1,
736
- sessionLimit: 1
737
- });
738
-
739
- const text = textOf(result);
740
- expect(result.isError).not.toBe(true);
741
- expect(text).toContain('[REDACTED]');
742
- expect(text).not.toContain('fixture-user');
743
- expect(text).not.toContain('fixture-credential');
744
- expect(text).not.toContain('mongodb://');
745
- expect(text).not.toContain('db.example.test');
746
- expect(text).not.toContain('authSource=admin');
747
- });
748
-
749
- it('redacts password-only credential URLs from context-pack previews', async () => {
750
- const passwordOnlyUri = [
751
- 'redis://',
752
- ':',
753
- 'fixture-credential',
754
- '@',
755
- 'cache.example.test:6379/0'
756
- ].join('');
757
- const sensitiveConnection = event({
758
- id: 'connection-redaction-2',
759
- timestamp: new Date('2026-05-05T01:45:00.000Z'),
760
- content: `Check queue health with ${passwordOnlyUri} before retrying workers.`
761
- });
762
-
763
- mocks.projectService.retrieveMemories.mockResolvedValue({
764
- memories: [{ event: sensitiveConnection, score: 0.89 }]
765
- });
766
- mocks.projectService.getRecentEvents.mockResolvedValue([sensitiveConnection]);
767
-
768
- const result = await handleToolCall('mem-context-pack', {
769
- projectPath: '/repo/app',
770
- query: 'queue health workers',
771
- topK: 1,
772
- recentLimit: 1,
773
- sessionLimit: 1
774
- });
775
-
776
- const text = textOf(result);
777
- expect(result.isError).not.toBe(true);
778
- expect(text).toContain('[REDACTED]');
779
- expect(text).not.toContain('fixture-credential');
780
- expect(text).not.toContain('redis://');
781
- expect(text).not.toContain('cache.example.test');
782
- });
783
-
784
- it('summarizes a project timeline by recent sessions and source agent metadata', async () => {
785
- mocks.projectService.getRecentEvents.mockResolvedValue([
786
- event({
787
- id: 'a1',
788
- sessionId: 'session-a',
789
- eventType: 'user_prompt',
790
- timestamp: new Date('2026-05-05T01:00:00.000Z'),
791
- content: 'Implement Hermes context tools.',
792
- metadata: { importedFrom: '/Users/example/.hermes/state.db', source: 'hermes' }
793
- }),
794
- event({
795
- id: 'a2',
796
- sessionId: 'session-a',
797
- eventType: 'agent_response',
798
- timestamp: new Date('2026-05-05T01:02:00.000Z'),
799
- content: 'Added tests for context tools.',
800
- metadata: { importedFrom: '/Users/example/.hermes/state.db', source: 'hermes' }
801
- }),
802
- event({
803
- id: 'b1',
804
- sessionId: 'session-b',
805
- eventType: 'user_prompt',
806
- timestamp: new Date('2026-05-05T00:30:00.000Z'),
807
- content: 'Review Codex memory import.',
808
- metadata: { importedFrom: '/Users/example/.codex/sessions/project.jsonl', source: 'codex' }
809
- })
810
- ]);
811
-
812
- const result = await handleToolCall('mem-project-timeline', {
813
- projectPath: '/repo/app',
814
- limit: 10,
815
- sessionLimit: 2
816
- });
817
-
818
- const text = textOf(result);
819
- expect(result.isError).not.toBe(true);
820
- expect(mocks.projectService.getRecentEvents).toHaveBeenCalledWith(10);
821
- expect(text).toContain('## Project Memory Timeline');
822
- expect(text).toContain('session-a');
823
- expect(text).toContain('Events: 2');
824
- expect(text).toContain('Source: hermes');
825
- expect(text).toContain('user_prompt: 1');
826
- expect(text).toContain('agent_response: 1');
827
- expect(text).toContain('session-b');
828
- expect(text).toContain('Source: codex');
829
- expect(text).not.toContain('/Users/example');
830
- expect(text).not.toContain('.codex/sessions');
831
- });
832
-
833
- it('redacts sensitive source-agent metadata in timeline summaries', async () => {
834
- mocks.projectService.getRecentEvents.mockResolvedValue([
835
- event({
836
- id: 'source-redaction-1',
837
- sessionId: 'session-source-redaction',
838
- timestamp: new Date('2026-05-05T04:00:00.000Z'),
839
- content: 'Timeline source label should be safe.',
840
- metadata: { sourceAgent: 'token=leaky-source-fixture' }
841
- })
842
- ]);
843
-
844
- const result = await handleToolCall('mem-project-timeline', {
845
- projectPath: '/repo/app',
846
- limit: 10,
847
- sessionLimit: 1
848
- });
849
-
850
- const text = textOf(result);
851
- expect(result.isError).not.toBe(true);
852
- expect(text).toContain('Source: [REDACTED]');
853
- expect(text).not.toContain('leaky-source-fixture');
854
- });
855
-
856
- it('resolves source references with redacted preview and safe metadata only', async () => {
857
- const sensitive = event({
858
- id: '44444444-4444-4444-8444-444444444444',
859
- sessionId: 'session-sensitive',
860
- timestamp: new Date('2026-05-05T03:00:00.000Z'),
861
- content: 'Debug note with api_key=sensitive-fixture-value token=abc123 password=pw but useful MCP context.',
862
- metadata: {
863
- importedFrom: '/Users/example/.hermes/state.db',
864
- source: ['discord', 'token=leaky-array-fixture'],
865
- transcriptPath: '/tmp/private-transcript.jsonl',
866
- secret: 'sensitive-fixture-value'
867
- }
868
- });
869
- mocks.projectService.getRecentEvents.mockResolvedValue([sensitive]);
870
-
871
- const result = await handleToolCall('mem-source-ref', {
872
- projectPath: '/repo/app',
873
- ids: [sensitive.id],
874
- maxContentChars: 240
875
- });
876
-
877
- const text = textOf(result);
878
- expect(result.isError).not.toBe(true);
879
- expect(text).toContain('## Source References');
880
- expect(text).toContain(`[mem:${generateCitationId(sensitive.id)}]`);
881
- expect(text).toContain('[REDACTED]');
882
- expect(text).not.toContain('importedFrom');
883
- expect(text).not.toContain('/Users/example');
884
- expect(text).toContain('source: discord');
885
- expect(text).not.toContain('leaky-array-fixture');
886
- expect(text).not.toContain('sensitive-fixture-value');
887
- expect(text).not.toContain('abc123');
888
- expect(text).not.toContain('password=pw');
889
- expect(text).not.toContain('transcriptPath');
890
- expect(text).not.toContain('secret:');
891
- });
892
-
893
- it('resolves source references by short citation id', async () => {
894
- const target = event({ id: '55555555-5555-4555-8555-555555555555', content: 'Citation lookup target.' });
895
- mocks.projectService.getRecentEvents.mockResolvedValue([target]);
896
-
897
- const result = await handleToolCall('mem-source-ref', {
898
- projectPath: '/repo/app',
899
- ids: [generateCitationId(target.id)]
900
- });
901
-
902
- expect(result.isError).not.toBe(true);
903
- expect(textOf(result)).toContain('Citation lookup target');
904
- });
905
- });