claude-memory-layer 1.0.31 → 1.0.33

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