claude-memory-layer 1.0.31 → 1.0.32

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