claude-memory-layer 1.0.27 → 1.0.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (331) hide show
  1. package/.env.example +7 -0
  2. package/AGENTS.md +11 -0
  3. package/README.md +374 -49
  4. package/benchmarks/replay/anonymized-real-sessions.json +48 -0
  5. package/dist/cli/index.js +10097 -6003
  6. package/dist/cli/index.js.map +4 -4
  7. package/dist/core/index.js +9745 -5587
  8. package/dist/core/index.js.map +4 -4
  9. package/dist/hooks/post-tool-use.js +6545 -5270
  10. package/dist/hooks/post-tool-use.js.map +4 -4
  11. package/dist/hooks/semantic-daemon.js +6646 -5354
  12. package/dist/hooks/semantic-daemon.js.map +4 -4
  13. package/dist/hooks/session-end.js +6618 -5347
  14. package/dist/hooks/session-end.js.map +4 -4
  15. package/dist/hooks/session-start.js +6619 -5354
  16. package/dist/hooks/session-start.js.map +4 -4
  17. package/dist/hooks/stop.js +6614 -5325
  18. package/dist/hooks/stop.js.map +4 -4
  19. package/dist/hooks/user-prompt-submit.js +6702 -5356
  20. package/dist/hooks/user-prompt-submit.js.map +4 -4
  21. package/dist/index.js +13537 -0
  22. package/dist/index.js.map +7 -0
  23. package/dist/mcp/index.js +20770 -0
  24. package/dist/mcp/index.js.map +7 -0
  25. package/dist/server/api/index.js +6632 -5319
  26. package/dist/server/api/index.js.map +4 -4
  27. package/dist/server/index.js +6667 -5340
  28. package/dist/server/index.js.map +4 -4
  29. package/dist/services/memory-service.js +6568 -5350
  30. package/dist/services/memory-service.js.map +4 -4
  31. package/dist/ui/assets/js/bootstrap.js +244 -0
  32. package/dist/ui/assets/js/chat.js +373 -0
  33. package/dist/ui/assets/js/disclosure.js +232 -0
  34. package/dist/ui/assets/js/modals.js +298 -0
  35. package/dist/ui/assets/js/overview.js +655 -0
  36. package/dist/ui/assets/js/state.js +72 -0
  37. package/dist/ui/assets/js/views.js +468 -0
  38. package/dist/ui/index.html +43 -1
  39. package/dist/ui/index.ts +3 -0
  40. package/dist/ui/style.css +222 -0
  41. package/docs/ARCHITECTURE_COMPARISON_AND_RECOMMENDATIONS.md +627 -0
  42. package/docs/HERMES_MEMORY_INGESTION_ANALYSIS.md +440 -0
  43. package/docs/MEMORY_USEFULNESS_AUDIT.md +371 -0
  44. package/docs/MEMORY_USEFULNESS_AUDIT_RAW.json +80 -0
  45. package/docs/MEMSEARCH_PROJECT_STRUCTURE_ANALYSIS.md +333 -0
  46. package/docs/PRODUCT_VALIDATION_MATRIX.md +82 -0
  47. package/docs/PROJECT_STRUCTURE_ANALYSIS.md +421 -0
  48. package/docs/REFACTORING_MILESTONES_AND_ISSUES.md +501 -0
  49. package/docs/REFACTORING_PLAN_THIN_CORE.md +414 -0
  50. package/docs/REFERENCE_PROJECT_ANALYSES.md +25 -0
  51. package/docs/SUPERLOCALMEMORY_PROJECT_STRUCTURE_ANALYSIS.md +452 -0
  52. package/docs/TARGET_ARCHITECTURE_AND_FOLDER_STRUCTURE.md +446 -0
  53. package/docs/architecture/comparison-index.md +47 -0
  54. package/docs/reports/codex-real-data-validation-20260505T040447Z.md +46 -0
  55. package/package.json +12 -5
  56. package/scripts/build.ts +25 -8
  57. package/scripts/generate-session-qrels.ts +126 -0
  58. package/scripts/postinstall-embedding-backend.cjs +142 -0
  59. package/scripts/replay-retrieval-benchmark.ts +69 -0
  60. package/specs/thin-core-refactor/context.md +275 -0
  61. package/specs/thin-core-refactor/plan.md +536 -0
  62. package/specs/thin-core-refactor/spec.md +465 -0
  63. package/src/adapters/claude/capture/index.ts +3 -0
  64. package/src/adapters/claude/context/index.ts +3 -0
  65. package/src/adapters/claude/hooks/index.ts +21 -0
  66. package/src/adapters/claude/hooks/post-tool-use.ts +239 -0
  67. package/src/adapters/claude/hooks/prompt-injection-policy.ts +104 -0
  68. package/src/adapters/claude/hooks/semantic-daemon-client.ts +209 -0
  69. package/src/adapters/claude/hooks/semantic-daemon.ts +283 -0
  70. package/src/adapters/claude/hooks/session-end.ts +59 -0
  71. package/src/adapters/claude/hooks/session-start.ts +73 -0
  72. package/src/adapters/claude/hooks/stop.ts +128 -0
  73. package/src/adapters/claude/hooks/user-prompt-submit.ts +361 -0
  74. package/src/adapters/claude/index.ts +4 -0
  75. package/src/adapters/claude/transcript/index.ts +4 -0
  76. package/src/adapters/claude/transcript/transcript-reader.ts +57 -0
  77. package/src/adapters/claude/transcript/turn-reconstructor.ts +65 -0
  78. package/src/apps/cli/claude-settings-hooks.ts +138 -0
  79. package/src/apps/cli/codex-import-runner.ts +125 -0
  80. package/src/apps/cli/codex-validation-output.ts +95 -0
  81. package/src/apps/cli/hermes-import-runner.ts +130 -0
  82. package/src/apps/cli/hermes-validation-output.ts +91 -0
  83. package/src/apps/cli/index.ts +1731 -0
  84. package/src/apps/cli/mcp-install.ts +106 -0
  85. package/src/apps/cli/retrieval-disclosure-output.ts +196 -0
  86. package/src/apps/dashboard/assets/js/bootstrap.js +244 -0
  87. package/src/apps/dashboard/assets/js/chat.js +373 -0
  88. package/src/apps/dashboard/assets/js/disclosure.js +232 -0
  89. package/src/apps/dashboard/assets/js/modals.js +298 -0
  90. package/src/apps/dashboard/assets/js/overview.js +655 -0
  91. package/src/apps/dashboard/assets/js/state.js +72 -0
  92. package/src/apps/dashboard/assets/js/views.js +468 -0
  93. package/src/{ui → apps/dashboard}/index.html +43 -1
  94. package/src/apps/dashboard/index.ts +3 -0
  95. package/src/{ui → apps/dashboard}/style.css +222 -0
  96. package/src/apps/index.ts +5 -0
  97. package/src/apps/server/api/chat.ts +244 -0
  98. package/src/apps/server/api/citations.ts +105 -0
  99. package/src/apps/server/api/events.ts +137 -0
  100. package/src/apps/server/api/health.ts +53 -0
  101. package/src/apps/server/api/index.ts +26 -0
  102. package/src/apps/server/api/projects.ts +74 -0
  103. package/src/apps/server/api/search.ts +184 -0
  104. package/src/apps/server/api/sessions.ts +115 -0
  105. package/src/apps/server/api/stats.ts +723 -0
  106. package/src/apps/server/api/turns.ts +143 -0
  107. package/src/apps/server/api/utils.ts +65 -0
  108. package/src/apps/server/index.ts +111 -0
  109. package/src/cli/index.ts +2 -1311
  110. package/src/cli/retrieval-disclosure-output.ts +2 -0
  111. package/src/compat/index.ts +5 -0
  112. package/src/core/derive/fact-deriver.ts +170 -0
  113. package/src/core/derive/index.ts +2 -0
  114. package/src/core/derive/summary-deriver.ts +76 -0
  115. package/src/core/embedder.ts +4 -152
  116. package/src/core/engine/embedding-maintenance-service.ts +187 -0
  117. package/src/core/engine/endless-memory-services.ts +4 -0
  118. package/src/core/engine/index.ts +19 -0
  119. package/src/core/engine/memory-engine-services.ts +170 -0
  120. package/src/core/engine/memory-ingest-service.ts +317 -0
  121. package/src/core/engine/memory-query-service.ts +173 -0
  122. package/src/core/engine/memory-runtime-service.ts +162 -0
  123. package/src/core/engine/memory-service-composition.ts +231 -0
  124. package/src/core/engine/retrieval-analytics-service.ts +181 -0
  125. package/src/core/engine/retrieval-disclosure-service.ts +420 -0
  126. package/src/core/engine/retrieval-orchestrator.ts +377 -0
  127. package/src/core/engine/retrieval-services.ts +176 -0
  128. package/src/core/engine/shared-memory-services.ts +4 -0
  129. package/src/core/entity-repo.ts +1 -3
  130. package/src/core/event-store.ts +3 -3
  131. package/src/core/evidence-aligner.ts +2 -2
  132. package/src/core/external-market-context.ts +582 -0
  133. package/src/core/graduation.ts +2 -3
  134. package/src/core/index.ts +21 -0
  135. package/src/core/matcher.ts +2 -4
  136. package/src/core/model/memory-fact.ts +30 -0
  137. package/src/core/model/memory-rule.ts +14 -0
  138. package/src/core/model/memory-summary.ts +21 -0
  139. package/src/core/model/raw-event.ts +28 -0
  140. package/src/core/model/retrieval-result.ts +35 -0
  141. package/src/core/privacy/filter.ts +21 -10
  142. package/src/core/product-validation-matrix.ts +314 -0
  143. package/src/core/progressive-retriever.ts +1 -2
  144. package/src/core/registry/project-path.ts +54 -0
  145. package/src/core/registry/session-registry.ts +69 -0
  146. package/src/core/replay-evaluator.ts +625 -0
  147. package/src/core/retrieval-benchmark.ts +117 -0
  148. package/src/core/retrieval-quality.ts +109 -0
  149. package/src/core/retriever.ts +53 -15
  150. package/src/core/session-qrels.ts +360 -0
  151. package/src/core/shared-event-store.ts +1 -1
  152. package/src/core/sqlite-event-store.ts +35 -11
  153. package/src/core/task/blocker-resolver.ts +2 -2
  154. package/src/core/task/task-resolver.ts +0 -1
  155. package/src/core/vector-outbox.ts +1 -10
  156. package/src/core/vector-worker.ts +1 -1
  157. package/src/extensions/endless-memory/endless-memory-services.ts +350 -0
  158. package/src/extensions/endless-memory/index.ts +1 -0
  159. package/src/extensions/index.ts +5 -0
  160. package/src/extensions/mcp/handlers.ts +960 -0
  161. package/src/extensions/mcp/index.ts +48 -0
  162. package/src/extensions/mcp/tools.ts +252 -0
  163. package/src/extensions/shared-memory/index.ts +1 -0
  164. package/src/extensions/shared-memory/shared-memory-services.ts +211 -0
  165. package/src/extensions/vector/embedder.ts +197 -0
  166. package/src/extensions/vector/index.ts +1 -0
  167. package/src/hooks/post-tool-use.ts +3 -236
  168. package/src/hooks/semantic-daemon-client.ts +1 -208
  169. package/src/hooks/semantic-daemon.ts +6 -271
  170. package/src/hooks/session-end.ts +4 -79
  171. package/src/hooks/session-start.ts +4 -73
  172. package/src/hooks/stop.ts +3 -173
  173. package/src/hooks/user-prompt-submit.ts +3 -338
  174. package/src/index.ts +13 -0
  175. package/src/mcp/handlers.ts +2 -212
  176. package/src/mcp/index.ts +3 -46
  177. package/src/mcp/tools.ts +2 -78
  178. package/src/server/api/chat.ts +2 -244
  179. package/src/server/api/citations.ts +2 -105
  180. package/src/server/api/events.ts +2 -137
  181. package/src/server/api/health.ts +2 -53
  182. package/src/server/api/index.ts +2 -26
  183. package/src/server/api/projects.ts +2 -74
  184. package/src/server/api/search.ts +2 -102
  185. package/src/server/api/sessions.ts +2 -115
  186. package/src/server/api/stats.ts +2 -724
  187. package/src/server/api/turns.ts +2 -143
  188. package/src/server/api/utils.ts +2 -46
  189. package/src/server/index.ts +2 -100
  190. package/src/services/bootstrap-organizer.ts +46 -26
  191. package/src/services/codex-session-history-importer.ts +521 -29
  192. package/src/services/hermes-session-history-importer.ts +733 -0
  193. package/src/services/memory-service-config.ts +36 -0
  194. package/src/services/memory-service-registry.ts +150 -0
  195. package/src/services/memory-service.ts +211 -1325
  196. package/src/services/session-history-importer.ts +58 -14
  197. package/tests/README.md +23 -0
  198. package/tests/adapters/claude/claude-semantic-daemon-adapter.test.ts +54 -0
  199. package/tests/adapters/claude/claude-transcript-reconstructor.test.ts +98 -0
  200. package/tests/adapters/claude-hook-prompt-injection-policy.test.ts +99 -0
  201. package/tests/apps/app-layer-boundary.test.ts +48 -0
  202. package/tests/apps/claude-settings-hooks.test.ts +107 -0
  203. package/tests/apps/cli-disclosure-output.test.ts +212 -0
  204. package/tests/apps/codex-import-runner.test.ts +99 -0
  205. package/tests/apps/codex-validation-output.test.ts +100 -0
  206. package/tests/apps/hermes-import-runner.test.ts +99 -0
  207. package/tests/apps/mcp-install-command.test.ts +59 -0
  208. package/tests/apps/package-build-entrypoints.test.ts +30 -0
  209. package/tests/apps/postinstall-embedding-backend.test.ts +167 -0
  210. package/tests/apps/search-api-disclosure.test.ts +162 -0
  211. package/tests/apps/stats-api-lightweight.test.ts +67 -0
  212. package/tests/apps/ui-disclosure-output.test.ts +140 -0
  213. package/tests/{bootstrap-organizer.test.ts → core/bootstrap-organizer.test.ts} +1 -1
  214. package/tests/{canonical-key.test.ts → core/canonical-key.test.ts} +1 -1
  215. package/tests/core/codex-session-history-importer-validation.test.ts +185 -0
  216. package/tests/{consolidation-worker.test.ts → core/consolidation-worker.test.ts} +2 -2
  217. package/tests/core/embedding-maintenance-service.test.ts +282 -0
  218. package/tests/{evidence-aligner.test.ts → core/evidence-aligner.test.ts} +1 -1
  219. package/tests/core/external-market-context.test.ts +209 -0
  220. package/tests/core/fact-deriver.test.ts +79 -0
  221. package/tests/core/hermes-session-history-importer-validation.test.ts +609 -0
  222. package/tests/{ingest-interceptor.test.ts → core/ingest-interceptor.test.ts} +1 -1
  223. package/tests/{markdown-mirror.test.ts → core/markdown-mirror.test.ts} +2 -2
  224. package/tests/{matcher.test.ts → core/matcher.test.ts} +1 -1
  225. package/tests/{md-mirror.test.ts → core/md-mirror.test.ts} +2 -2
  226. package/tests/core/memory-engine-services.test.ts +240 -0
  227. package/tests/core/memory-ingest-service.test.ts +296 -0
  228. package/tests/core/memory-query-service.test.ts +129 -0
  229. package/tests/core/memory-runtime-service.test.ts +201 -0
  230. package/tests/core/memory-service-composition.test.ts +192 -0
  231. package/tests/core/memory-service-config.test.ts +41 -0
  232. package/tests/core/memory-service-facade.test.ts +30 -0
  233. package/tests/core/memory-service-registry.test.ts +206 -0
  234. package/tests/core/product-validation-matrix.test.ts +61 -0
  235. package/tests/core/project-registry.test.ts +78 -0
  236. package/tests/core/replay-evaluator.test.ts +181 -0
  237. package/tests/core/retrieval-analytics-service.test.ts +210 -0
  238. package/tests/core/retrieval-benchmark.test.ts +93 -0
  239. package/tests/core/retrieval-disclosure-service.test.ts +264 -0
  240. package/tests/core/retrieval-orchestrator.test.ts +403 -0
  241. package/tests/core/retrieval-quality.test.ts +31 -0
  242. package/tests/core/retrieval-services.test.ts +185 -0
  243. package/tests/{retriever-fallback-chain.test.ts → core/retriever-fallback-chain.test.ts} +3 -3
  244. package/tests/{retriever-strategy-scope.test.ts → core/retriever-strategy-scope.test.ts} +70 -3
  245. package/tests/{retriever.memu-adoption.test.ts → core/retriever.memu-adoption.test.ts} +3 -3
  246. package/tests/core/session-history-importer-filter.test.ts +78 -0
  247. package/tests/core/session-qrels.test.ts +250 -0
  248. package/tests/{sqlite-event-store-replication.test.ts → core/sqlite-event-store-replication.test.ts} +36 -1
  249. package/tests/core/summary-deriver.test.ts +66 -0
  250. package/tests/extensions/embedder-warning-suppression.test.ts +53 -0
  251. package/tests/extensions/endless-memory-extension-boundary.test.ts +17 -0
  252. package/tests/extensions/endless-memory-services.test.ts +325 -0
  253. package/tests/extensions/mcp-context-tools.test.ts +905 -0
  254. package/tests/extensions/mcp-extension-boundary.test.ts +21 -0
  255. package/tests/extensions/mcp-package-build.test.ts +22 -0
  256. package/tests/extensions/mcp-project-aware-tools.test.ts +102 -0
  257. package/tests/extensions/shared-memory-extension-boundary.test.ts +24 -0
  258. package/tests/extensions/shared-memory-services.test.ts +309 -0
  259. package/tests/extensions/vector-extension-boundary.test.ts +21 -0
  260. package/.claude/settings.local.json +0 -25
  261. package/.npm-cache/_cacache/content-v2/sha512/04/76/c098f88dfe584a2b80870bff7421b05d17d3d9ee1027f77772332a22d3f93a9a57101a2855107f6ad82077a818bba912b2bc317f2361b5ddb09ad284d9ce +0 -0
  262. package/.npm-cache/_cacache/content-v2/sha512/60/25/d2ecd39cfc7cab58351162814be77f935c6d6491c10c3745d456da7ddb2117ffd90c10e53fe3c0f1ed16b403307841543634504398b16ee4e6b6dd8e0c45 +0 -0
  263. package/.npm-cache/_cacache/index-v5/2b/9a/7f8f40206ed8a2e0a84efaa953ccaed1f5d001e14b931083f2e7a0738007 +0 -2
  264. package/.npm-cache/_cacache/index-v5/2e/d9/fcfa5c6a6abdc2a3644ab84a95936047298c465a2f47ee03db8f7fe1e946 +0 -3
  265. package/.npm-cache/_cacache/index-v5/a9/42/e519633356d12d3d2f19da66a8301016d496c8f5c3e0554124aaa62dc043 +0 -2
  266. package/.npm-cache/_logs/2026-02-26T12_04_52_729Z-debug-0.log +0 -256
  267. package/.npm-cache/_logs/2026-02-26T12_05_36_835Z-debug-0.log +0 -18
  268. package/.npm-cache/_logs/2026-02-26T12_05_45_982Z-debug-0.log +0 -32
  269. package/.npm-cache/_logs/2026-02-26T12_05_48_515Z-debug-0.log +0 -260
  270. package/.npm-cache/_logs/2026-02-26T12_05_53_567Z-debug-0.log +0 -69
  271. package/.npm-cache/_update-notifier-last-checked +0 -0
  272. package/bootstrap-kb/decisions/decisions.md +0 -244
  273. package/bootstrap-kb/glossary/glossary.md +0 -46
  274. package/bootstrap-kb/modules/.claude-plugin.md +0 -22
  275. package/bootstrap-kb/modules/agents.md.md +0 -15
  276. package/bootstrap-kb/modules/claude.md.md +0 -15
  277. package/bootstrap-kb/modules/context.md.md +0 -15
  278. package/bootstrap-kb/modules/docs.md +0 -18
  279. package/bootstrap-kb/modules/handoff.md.md +0 -15
  280. package/bootstrap-kb/modules/package-lock.json.md +0 -15
  281. package/bootstrap-kb/modules/package.json.md +0 -15
  282. package/bootstrap-kb/modules/plan.md.md +0 -15
  283. package/bootstrap-kb/modules/readme.md.md +0 -15
  284. package/bootstrap-kb/modules/scripts.md +0 -26
  285. package/bootstrap-kb/modules/spec.md.md +0 -15
  286. package/bootstrap-kb/modules/specs.md +0 -20
  287. package/bootstrap-kb/modules/src.md +0 -51
  288. package/bootstrap-kb/modules/tests.md +0 -42
  289. package/bootstrap-kb/modules/tsconfig.json.md +0 -15
  290. package/bootstrap-kb/modules/vitest.config.ts.md +0 -15
  291. package/bootstrap-kb/overview/overview.md +0 -40
  292. package/bootstrap-kb/sources/manifest.json +0 -950
  293. package/bootstrap-kb/sources/manifest.md +0 -227
  294. package/bootstrap-kb/timeline/timeline.md +0 -57
  295. package/claude-memory-layer-1.0.14.tgz +0 -0
  296. package/d.sh +0 -3
  297. package/deploy.sh +0 -3
  298. package/dist/ui/app.js +0 -2101
  299. package/memory/.claude-plugin/commands/2026-02-25.md +0 -263
  300. package/memory/_index.md +0 -419
  301. package/memory/agent_response/uncategorized/2026-02-26.md +0 -176
  302. package/memory/agent_response/uncategorized/2026-03-03.md +0 -14
  303. package/memory/agent_response/uncategorized/2026-03-04.md +0 -1421
  304. package/memory/agent_response/uncategorized/2026-03-05.md +0 -157
  305. package/memory/default/uncategorized/2026-02-25.md +0 -4839
  306. package/memory/session_summary/uncategorized/2026-02-26.md +0 -13
  307. package/memory/session_summary/uncategorized/2026-03-03.md +0 -5
  308. package/memory/session_summary/uncategorized/2026-03-04.md +0 -50
  309. package/memory/specs/20260207-dashboard-upgrade/2026-02-25.md +0 -142
  310. package/memory/specs/citations-system/2026-02-25.md +0 -1121
  311. package/memory/specs/endless-mode/2026-02-25.md +0 -1392
  312. package/memory/specs/entity-edge-model/2026-02-25.md +0 -1263
  313. package/memory/specs/evidence-aligner-v2/2026-02-25.md +0 -1028
  314. package/memory/specs/mcp-desktop-integration/2026-02-25.md +0 -1334
  315. package/memory/specs/post-tool-use-hook/2026-02-25.md +0 -1164
  316. package/memory/specs/private-tags/2026-02-25.md +0 -1057
  317. package/memory/specs/progressive-disclosure/2026-02-25.md +0 -1436
  318. package/memory/specs/task-entity-system/2026-02-25.md +0 -924
  319. package/memory/specs/vector-outbox-v2/2026-02-25.md +0 -1510
  320. package/memory/specs/web-viewer-ui/2026-02-25.md +0 -1709
  321. package/memory/tool_observation/uncategorized/2026-02-26.md +0 -209
  322. package/memory/tool_observation/uncategorized/2026-03-03.md +0 -21
  323. package/memory/tool_observation/uncategorized/2026-03-04.md +0 -1033
  324. package/memory/tool_observation/uncategorized/2026-03-05.md +0 -33
  325. package/memory/user_prompt/uncategorized/2026-02-26.md +0 -25
  326. package/memory/user_prompt/uncategorized/2026-03-04.md +0 -634
  327. package/memory/user_prompt/uncategorized/2026-03-05.md +0 -6
  328. package/specs/optional-duckdb/context.md +0 -77
  329. package/specs/optional-duckdb/plan.md +0 -142
  330. package/specs/optional-duckdb/spec.md +0 -35
  331. package/src/ui/app.js +0 -2101
@@ -0,0 +1,212 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import {
3
+ formatDisclosureExpansion,
4
+ formatDisclosureSearch,
5
+ formatDisclosureSource,
6
+ formatPlainSearchResults
7
+ } from '../../src/apps/cli/retrieval-disclosure-output.js';
8
+
9
+ describe('retrieval disclosure CLI output', () => {
10
+ it('formats compact search envelopes with type badges, reasons, and source refs', () => {
11
+ const out = formatDisclosureSearch({
12
+ results: [
13
+ {
14
+ id: 'event:e1',
15
+ resultType: 'tool_evidence',
16
+ title: 'Tool evidence',
17
+ snippet: 'Applied checkout fix in src/cart.ts',
18
+ score: 0.91,
19
+ reasons: ['semantic_match', 'tool_followup'],
20
+ sourceRef: 'event:e1',
21
+ sessionId: 'session-1234567890'
22
+ }
23
+ ],
24
+ meta: {
25
+ total: 1,
26
+ usedVector: true,
27
+ usedKeyword: true,
28
+ fallbackApplied: false
29
+ }
30
+ });
31
+
32
+ expect(out).toContain('🔎 Progressive Search Results');
33
+ expect(out).toContain('Meta: total=1 vector=yes keyword=yes fallback=no');
34
+ expect(out).toContain('[tool_evidence] Tool evidence');
35
+ expect(out).toContain('event:e1');
36
+ expect(out).toContain('semantic_match, tool_followup');
37
+ expect(out).toContain('session-');
38
+ });
39
+
40
+ it('formats expand output with target, surrounding results, sources, and expanded context', () => {
41
+ const out = formatDisclosureExpansion({
42
+ target: {
43
+ id: 'event:e2',
44
+ resultType: 'source',
45
+ title: 'Agent response',
46
+ snippet: 'Use the disclosure API',
47
+ score: 1,
48
+ reasons: ['continuity_link'],
49
+ sourceRef: 'event:e2'
50
+ },
51
+ surroundingFacts: [
52
+ {
53
+ id: 'event:e1',
54
+ resultType: 'source',
55
+ snippet: 'Earlier user prompt',
56
+ score: 1,
57
+ reasons: ['continuity_link'],
58
+ sourceRef: 'event:e1'
59
+ }
60
+ ],
61
+ relatedSources: [{ sourceRef: 'event:e2', sourceType: 'raw_event', eventIds: ['e2'] }],
62
+ expandedContext: '[agent_response] Use the disclosure API'
63
+ });
64
+
65
+ expect(out).toContain('🧩 Expanded Retrieval Result');
66
+ expect(out).toContain('Target');
67
+ expect(out).toContain('Surrounding');
68
+ expect(out).toContain('Sources');
69
+ expect(out).toContain('[agent_response] Use the disclosure API');
70
+ });
71
+
72
+ it('formats shared disclosure provenance explicitly in expansion and source output', () => {
73
+ const expansionOut = formatDisclosureExpansion({
74
+ target: {
75
+ id: 'shared:shared-1',
76
+ resultType: 'rule',
77
+ title: 'Shared checkout troubleshooting',
78
+ snippet: 'clear cache and retry',
79
+ score: 0.88,
80
+ reasons: ['semantic_match'],
81
+ sourceRef: 'shared:shared-1',
82
+ metadata: {
83
+ sourceProjectHash: 'project-a',
84
+ sourceEntryId: 'e-shared',
85
+ topics: ['checkout']
86
+ }
87
+ },
88
+ relatedSources: [
89
+ {
90
+ sourceRef: 'shared:shared-1',
91
+ sourceType: 'shared_troubleshooting',
92
+ eventIds: [],
93
+ metadata: {
94
+ sourceProjectHash: 'project-a',
95
+ sourceEntryId: 'e-shared',
96
+ topics: ['checkout']
97
+ }
98
+ }
99
+ ],
100
+ expandedContext: '[shared_troubleshooting] Shared checkout troubleshooting\nRoot cause: stale cache'
101
+ });
102
+
103
+ const sourceOut = formatDisclosureSource({
104
+ sourceRef: 'shared:shared-1',
105
+ sourceType: 'shared_troubleshooting',
106
+ eventIds: [],
107
+ rawEvents: [],
108
+ metadata: {
109
+ sourceProjectHash: 'project-a',
110
+ sourceEntryId: 'e-shared',
111
+ topics: ['checkout'],
112
+ rootCause: 'stale cache',
113
+ solution: 'clear cache and retry'
114
+ }
115
+ });
116
+
117
+ expect(expansionOut).toContain('shared_troubleshooting');
118
+ expect(expansionOut).toContain('sourceProjectHash: project-a');
119
+ expect(expansionOut).toContain('topics: checkout');
120
+ expect(sourceOut).toContain('Shared Metadata');
121
+ expect(sourceOut).toContain('rootCause: stale cache');
122
+ expect(sourceOut).toContain('No local raw events for this shared source.');
123
+ });
124
+
125
+ it('formats source output with source type, event ids, and raw event previews', () => {
126
+ const out = formatDisclosureSource({
127
+ sourceRef: 'event:e3',
128
+ sourceType: 'raw_event',
129
+ eventIds: ['e3'],
130
+ rawEvents: [
131
+ {
132
+ id: 'e3',
133
+ sessionId: 'session-1',
134
+ eventType: 'user_prompt',
135
+ content: 'Show source details',
136
+ canonicalKey: 'canonical/e3',
137
+ dedupeKey: 'session-1:e3',
138
+ timestamp: new Date('2026-02-24T00:00:00.000Z'),
139
+ metadata: {}
140
+ }
141
+ ]
142
+ });
143
+
144
+ expect(out).toContain('📎 Retrieval Source');
145
+ expect(out).toContain('sourceType: raw_event');
146
+ expect(out).toContain('eventIds: e3');
147
+ expect(out).toContain('[user_prompt] Show source details');
148
+ });
149
+
150
+ it('formats plain search output with shared memories when includeShared is used', () => {
151
+ const out = formatPlainSearchResults({
152
+ memories: [
153
+ {
154
+ event: {
155
+ id: 'e1',
156
+ sessionId: 'session-1234567890',
157
+ eventType: 'agent_response',
158
+ content: 'Local checkout fix details',
159
+ canonicalKey: 'canonical/e1',
160
+ dedupeKey: 'session-1234567890:e1',
161
+ timestamp: new Date('2026-02-24T00:00:00.000Z'),
162
+ metadata: {}
163
+ },
164
+ score: 0.91
165
+ }
166
+ ],
167
+ matchResult: {
168
+ match: {
169
+ event: {
170
+ id: 'e1',
171
+ sessionId: 'session-1234567890',
172
+ eventType: 'agent_response',
173
+ content: 'Local checkout fix details',
174
+ canonicalKey: 'canonical/e1',
175
+ dedupeKey: 'session-1234567890:e1',
176
+ timestamp: new Date('2026-02-24T00:00:00.000Z'),
177
+ metadata: {}
178
+ },
179
+ score: 0.91
180
+ },
181
+ confidence: 'high'
182
+ },
183
+ totalTokens: 10,
184
+ context: 'Local checkout fix details',
185
+ sharedMemories: [
186
+ {
187
+ entryId: 'shared-1',
188
+ sourceProjectHash: 'project-a',
189
+ sourceEntryId: 'e-shared',
190
+ title: 'Shared checkout troubleshooting',
191
+ symptoms: ['checkout fails'],
192
+ rootCause: 'stale cache',
193
+ solution: 'clear cache and retry',
194
+ topics: ['checkout'],
195
+ confidence: 0.88,
196
+ usageCount: 3,
197
+ promotedAt: new Date('2026-02-23T00:00:00.000Z'),
198
+ createdAt: new Date('2026-02-23T00:00:00.000Z')
199
+ }
200
+ ]
201
+ });
202
+
203
+ expect(out).toContain('📚 Search Results');
204
+ expect(out).toContain('Total local memories found: 1');
205
+ expect(out).toContain('Shared memories found: 1');
206
+ expect(out).toContain('🌐 Shared Memories');
207
+ expect(out).toContain('Shared checkout troubleshooting');
208
+ expect(out).toContain('Source: shared:shared-1');
209
+ expect(out).toContain('Project: project-a');
210
+ expect(out).toContain('Solution: clear cache and retry');
211
+ });
212
+ });
@@ -0,0 +1,99 @@
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import type { ImportResult } from '../../src/services/session-history-importer.js';
3
+
4
+ const { runCodexImportOnce } = await import('../../src/apps/cli/codex-import-runner.js');
5
+
6
+ function makeImportResult(overrides: Partial<ImportResult> = {}): ImportResult {
7
+ return {
8
+ totalSessions: 1,
9
+ totalMessages: 2,
10
+ importedPrompts: 1,
11
+ importedResponses: 1,
12
+ skippedDuplicates: 0,
13
+ errors: [],
14
+ ...overrides
15
+ };
16
+ }
17
+
18
+ function makeService() {
19
+ return {
20
+ initialize: vi.fn(async () => undefined),
21
+ shutdown: vi.fn(async () => undefined),
22
+ processPendingEmbeddings: vi.fn(async () => 2),
23
+ ensureEmbeddingModelForImport: vi.fn(async () => ({ changed: false, previousModel: null, currentModel: 'test', enqueued: 0 }))
24
+ };
25
+ }
26
+
27
+ describe('Codex import runner', () => {
28
+ let projectService: ReturnType<typeof makeService>;
29
+ let globalService: ReturnType<typeof makeService>;
30
+ let importer: {
31
+ importProject: ReturnType<typeof vi.fn>;
32
+ importAll: ReturnType<typeof vi.fn>;
33
+ importSessionFile: ReturnType<typeof vi.fn>;
34
+ };
35
+ let deps: Parameters<typeof runCodexImportOnce>[1];
36
+
37
+ beforeEach(() => {
38
+ projectService = makeService();
39
+ globalService = makeService();
40
+ importer = {
41
+ importProject: vi.fn(async () => makeImportResult()),
42
+ importAll: vi.fn(async () => makeImportResult({ totalSessions: 3 })),
43
+ importSessionFile: vi.fn(async () => makeImportResult())
44
+ };
45
+ deps = {
46
+ cwd: () => '/repo/current',
47
+ getDefaultMemoryService: vi.fn(() => globalService as never),
48
+ getMemoryServiceForProject: vi.fn(() => projectService as never),
49
+ createImporter: vi.fn(() => importer as never),
50
+ onProgress: vi.fn()
51
+ };
52
+ });
53
+
54
+ it('imports the current project from Codex sessions into the project-scoped memory service', async () => {
55
+ const outcome = await runCodexImportOnce({ sessionsDir: '/tmp/codex-sessions', limit: '9', sessionLimit: '1' }, deps);
56
+
57
+ expect(deps?.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/current');
58
+ expect(deps?.getDefaultMemoryService).not.toHaveBeenCalled();
59
+ expect(deps?.createImporter).toHaveBeenCalledWith(projectService, { sessionsDir: '/tmp/codex-sessions' });
60
+ expect(projectService.initialize).toHaveBeenCalledTimes(1);
61
+ expect(projectService.ensureEmbeddingModelForImport).toHaveBeenCalledWith({ autoMigrate: true });
62
+ expect(importer.importProject).toHaveBeenCalledWith('/repo/current', expect.objectContaining({
63
+ projectPath: '/repo/current',
64
+ limit: 9,
65
+ sessionLimit: 1,
66
+ onProgress: deps?.onProgress
67
+ }));
68
+ expect(projectService.processPendingEmbeddings).toHaveBeenCalledTimes(1);
69
+ expect(projectService.shutdown).toHaveBeenCalledTimes(1);
70
+ expect(outcome).toMatchObject({ mode: 'project', storageScope: 'project', embedCount: 2 });
71
+ });
72
+
73
+ it('uses global storage only for explicit all-session imports without a project', async () => {
74
+ const outcome = await runCodexImportOnce({ all: true, processEmbeddings: false }, deps);
75
+
76
+ expect(deps?.getDefaultMemoryService).toHaveBeenCalledTimes(1);
77
+ expect(deps?.getMemoryServiceForProject).not.toHaveBeenCalled();
78
+ expect(importer.importAll).toHaveBeenCalledWith(expect.objectContaining({ force: undefined }));
79
+ expect(globalService.processPendingEmbeddings).not.toHaveBeenCalled();
80
+ expect(globalService.shutdown).toHaveBeenCalledTimes(1);
81
+ expect(outcome).toMatchObject({ mode: 'all', storageScope: 'global', embedCount: 0 });
82
+ });
83
+
84
+ it('imports a single Codex session file into the selected project scope', async () => {
85
+ await runCodexImportOnce({ project: '/repo/selected', session: '/tmp/session.jsonl', force: true }, deps);
86
+
87
+ expect(deps?.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/selected');
88
+ expect(importer.importSessionFile).toHaveBeenCalledWith('/tmp/session.jsonl', expect.objectContaining({
89
+ projectPath: '/repo/selected',
90
+ force: true
91
+ }));
92
+ });
93
+
94
+ it('rejects non-decimal integer limits instead of partially parsing them', async () => {
95
+ await expect(runCodexImportOnce({ limit: '1foo' }, deps)).rejects.toThrow('Invalid --limit');
96
+ await expect(runCodexImportOnce({ sessionLimit: '1.5' }, deps)).rejects.toThrow('Invalid --session-limit');
97
+ await expect(runCodexImportOnce({ sessionLimit: '1e2' }, deps)).rejects.toThrow('Invalid --session-limit');
98
+ });
99
+ });
@@ -0,0 +1,100 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import { formatCodexValidationReport } from '../../src/apps/cli/codex-validation-output.js';
4
+ import type { CodexSessionValidationReport } from '../../src/services/codex-session-history-importer.js';
5
+
6
+ function makeReport(): CodexSessionValidationReport {
7
+ return {
8
+ generatedAt: '2026-05-05T12:00:00.000Z',
9
+ dryRun: true,
10
+ willMutate: false,
11
+ source: {
12
+ sessionsDir: '/tmp/codex-sessions',
13
+ projectPath: '/tmp/project-a',
14
+ projectFilterApplied: true,
15
+ sourcePaths: ['/tmp/codex-sessions']
16
+ },
17
+ limits: {
18
+ sessionLimit: 10,
19
+ maxContentChars: 10_000
20
+ },
21
+ totals: {
22
+ sessionsScanned: 3,
23
+ sessionsMatched: 2,
24
+ filesRead: 2,
25
+ recordsRead: 9,
26
+ messagesNormalized: 4,
27
+ turnsNormalized: 2,
28
+ userMessages: 2,
29
+ assistantMessages: 2,
30
+ malformedLines: 1,
31
+ skippedUnsupportedRecords: 2,
32
+ emptyAssistantMessages: 1,
33
+ truncatedMessages: 1,
34
+ missingProjectCwd: 1,
35
+ warnings: 2
36
+ },
37
+ topProjects: [
38
+ {
39
+ projectHash: 'abc12345',
40
+ pathLabel: '/tmp/project-a',
41
+ sessions: 2,
42
+ messagesNormalized: 4,
43
+ turnsNormalized: 2,
44
+ userMessages: 2,
45
+ assistantMessages: 2,
46
+ malformedLines: 1,
47
+ skippedUnsupportedRecords: 2,
48
+ truncatedMessages: 1,
49
+ emptyAssistantMessages: 1
50
+ }
51
+ ],
52
+ sessions: [
53
+ {
54
+ sessionId: 'session-a',
55
+ filePath: '/tmp/codex-sessions/session-a.jsonl',
56
+ projectHash: 'abc12345',
57
+ pathLabel: '/tmp/project-a',
58
+ matched: true,
59
+ recordsRead: 9,
60
+ messagesNormalized: 4,
61
+ turnsNormalized: 2,
62
+ userMessages: 2,
63
+ assistantMessages: 2,
64
+ malformedLines: 1,
65
+ skippedUnsupportedRecords: 2,
66
+ emptyAssistantMessages: 1,
67
+ truncatedMessages: 1,
68
+ missingProjectCwd: false,
69
+ warnings: ['sample warning']
70
+ }
71
+ ],
72
+ warnings: ['1 session(s) missing cwd', '1 malformed JSONL line(s) skipped']
73
+ };
74
+ }
75
+
76
+ describe('Codex validation CLI output helpers', () => {
77
+ it('formats JSON reports without transcript text', () => {
78
+ const json = formatCodexValidationReport(makeReport(), 'json');
79
+ const parsed = JSON.parse(json) as CodexSessionValidationReport;
80
+
81
+ expect(parsed.dryRun).toBe(true);
82
+ expect(parsed.willMutate).toBe(false);
83
+ expect(parsed.totals.sessionsScanned).toBe(3);
84
+ expect(json).not.toContain('please implement');
85
+ expect(json).not.toContain('assistant response');
86
+ });
87
+
88
+ it('formats markdown totals, top projects, and safety status', () => {
89
+ const markdown = formatCodexValidationReport(makeReport(), 'markdown');
90
+
91
+ expect(markdown).toContain('# Codex dry-run validation report');
92
+ expect(markdown).toContain('Dry-run: yes');
93
+ expect(markdown).toContain('Sessions scanned: 3');
94
+ expect(markdown).toContain('Sessions matched: 2');
95
+ expect(markdown).toContain('Malformed lines: 1');
96
+ expect(markdown).toContain('Skipped/unsupported records: 2');
97
+ expect(markdown).toContain('abc12345');
98
+ expect(markdown).toContain('/tmp/project-a');
99
+ });
100
+ });
@@ -0,0 +1,99 @@
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import type { ImportResult } from '../../src/services/session-history-importer.js';
3
+
4
+ const { runHermesImportOnce } = await import('../../src/apps/cli/hermes-import-runner.js');
5
+
6
+ function makeImportResult(overrides: Partial<ImportResult> = {}): ImportResult {
7
+ return {
8
+ totalSessions: 1,
9
+ totalMessages: 2,
10
+ importedPrompts: 1,
11
+ importedResponses: 1,
12
+ skippedDuplicates: 0,
13
+ errors: [],
14
+ ...overrides
15
+ };
16
+ }
17
+
18
+ function makeService() {
19
+ return {
20
+ initialize: vi.fn(async () => undefined),
21
+ shutdown: vi.fn(async () => undefined),
22
+ processPendingEmbeddings: vi.fn(async () => 2),
23
+ ensureEmbeddingModelForImport: vi.fn(async () => ({ changed: false, previousModel: null, currentModel: 'test', enqueued: 0 }))
24
+ };
25
+ }
26
+
27
+ describe('Hermes import runner', () => {
28
+ let projectService: ReturnType<typeof makeService>;
29
+ let globalService: ReturnType<typeof makeService>;
30
+ let importer: {
31
+ importProject: ReturnType<typeof vi.fn>;
32
+ importAll: ReturnType<typeof vi.fn>;
33
+ importSession: ReturnType<typeof vi.fn>;
34
+ };
35
+ let deps: Parameters<typeof runHermesImportOnce>[1];
36
+
37
+ beforeEach(() => {
38
+ projectService = makeService();
39
+ globalService = makeService();
40
+ importer = {
41
+ importProject: vi.fn(async () => makeImportResult()),
42
+ importAll: vi.fn(async () => makeImportResult({ totalSessions: 3 })),
43
+ importSession: vi.fn(async () => makeImportResult())
44
+ };
45
+ deps = {
46
+ cwd: () => '/repo/current',
47
+ getDefaultMemoryService: vi.fn(() => globalService as never),
48
+ getMemoryServiceForProject: vi.fn(() => projectService as never),
49
+ createImporter: vi.fn(() => importer as never),
50
+ onProgress: vi.fn()
51
+ };
52
+ });
53
+
54
+ it('imports the current project from Hermes state.db into the project-scoped memory service', async () => {
55
+ const outcome = await runHermesImportOnce({ stateDb: '/tmp/hermes-state.db', limit: '9', sessionLimit: '1' }, deps);
56
+
57
+ expect(deps?.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/current');
58
+ expect(deps?.getDefaultMemoryService).not.toHaveBeenCalled();
59
+ expect(deps?.createImporter).toHaveBeenCalledWith(projectService, { stateDbPath: '/tmp/hermes-state.db' });
60
+ expect(projectService.initialize).toHaveBeenCalledTimes(1);
61
+ expect(projectService.ensureEmbeddingModelForImport).toHaveBeenCalledWith({ autoMigrate: true });
62
+ expect(importer.importProject).toHaveBeenCalledWith('/repo/current', expect.objectContaining({
63
+ projectPath: '/repo/current',
64
+ limit: 9,
65
+ sessionLimit: 1,
66
+ onProgress: deps?.onProgress
67
+ }));
68
+ expect(projectService.processPendingEmbeddings).toHaveBeenCalledTimes(1);
69
+ expect(projectService.shutdown).toHaveBeenCalledTimes(1);
70
+ expect(outcome).toMatchObject({ mode: 'project', storageScope: 'project', embedCount: 2 });
71
+ });
72
+
73
+ it('uses global storage only for explicit all-session imports without a project', async () => {
74
+ const outcome = await runHermesImportOnce({ all: true, processEmbeddings: false }, deps);
75
+
76
+ expect(deps?.getDefaultMemoryService).toHaveBeenCalledTimes(1);
77
+ expect(deps?.getMemoryServiceForProject).not.toHaveBeenCalled();
78
+ expect(importer.importAll).toHaveBeenCalledWith(expect.objectContaining({ force: undefined }));
79
+ expect(globalService.processPendingEmbeddings).not.toHaveBeenCalled();
80
+ expect(globalService.shutdown).toHaveBeenCalledTimes(1);
81
+ expect(outcome).toMatchObject({ mode: 'all', storageScope: 'global', embedCount: 0 });
82
+ });
83
+
84
+ it('imports a single Hermes session into the selected project scope', async () => {
85
+ await runHermesImportOnce({ project: '/repo/selected', session: '20260505_010203_abcd1234', force: true }, deps);
86
+
87
+ expect(deps?.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/selected');
88
+ expect(importer.importSession).toHaveBeenCalledWith('20260505_010203_abcd1234', expect.objectContaining({
89
+ projectPath: '/repo/selected',
90
+ force: true
91
+ }));
92
+ });
93
+
94
+ it('rejects non-decimal integer limits instead of partially parsing them', async () => {
95
+ await expect(runHermesImportOnce({ limit: '1foo' }, deps)).rejects.toThrow('Invalid --limit');
96
+ await expect(runHermesImportOnce({ sessionLimit: '1.5' }, deps)).rejects.toThrow('Invalid --session-limit');
97
+ await expect(runHermesImportOnce({ sessionLimit: '1e2' }, deps)).rejects.toThrow('Invalid --session-limit');
98
+ });
99
+ });
@@ -0,0 +1,59 @@
1
+ import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
2
+ import { tmpdir } from 'node:os';
3
+ import { join } from 'node:path';
4
+ import { afterEach, describe, expect, it } from 'vitest';
5
+ import {
6
+ getDefaultClaudeDesktopConfigPath,
7
+ installMcpServerConfig,
8
+ readJsonConfig,
9
+ saveJsonConfig
10
+ } from '../../src/apps/cli/mcp-install.js';
11
+
12
+ const tempDirs: string[] = [];
13
+
14
+ function tempDir() {
15
+ const dir = mkdtempSync(join(tmpdir(), 'cml-mcp-install-'));
16
+ tempDirs.push(dir);
17
+ return dir;
18
+ }
19
+
20
+ afterEach(() => {
21
+ for (const dir of tempDirs.splice(0)) {
22
+ rmSync(dir, { recursive: true, force: true });
23
+ }
24
+ });
25
+
26
+ describe('MCP install command helpers', () => {
27
+ it('resolves the Claude Desktop config path per platform', () => {
28
+ expect(getDefaultClaudeDesktopConfigPath('darwin', {}, '/Users/me')).toBe('/Users/me/Library/Application Support/Claude/claude_desktop_config.json');
29
+ expect(getDefaultClaudeDesktopConfigPath('linux', {}, '/home/me')).toBe('/home/me/.config/claude/claude_desktop_config.json');
30
+ expect(getDefaultClaudeDesktopConfigPath('win32', { APPDATA: 'C:/Users/me/AppData/Roaming' }, 'C:/Users/me')).toBe('C:/Users/me/AppData/Roaming/Claude/claude_desktop_config.json');
31
+ });
32
+
33
+ it('adds claude-memory-layer MCP server while preserving existing config', () => {
34
+ const config = installMcpServerConfig(
35
+ { mcpServers: { existing: { command: 'node', args: ['server.js'] } }, other: true },
36
+ { serverName: 'claude-memory-layer', command: 'claude-memory-layer-mcp', args: [] }
37
+ );
38
+
39
+ expect(config).toEqual({
40
+ mcpServers: {
41
+ existing: { command: 'node', args: ['server.js'] },
42
+ 'claude-memory-layer': { command: 'claude-memory-layer-mcp', args: [] }
43
+ },
44
+ other: true
45
+ });
46
+ });
47
+
48
+ it('atomically writes config files and creates parent directories', () => {
49
+ const configPath = join(tempDir(), 'Claude', 'claude_desktop_config.json');
50
+ saveJsonConfig(configPath, installMcpServerConfig({}, { serverName: 'code-memory', command: 'node', args: ['dist/mcp/index.js'] }));
51
+
52
+ expect(readJsonConfig(configPath)).toEqual({
53
+ mcpServers: {
54
+ 'code-memory': { command: 'node', args: ['dist/mcp/index.js'] }
55
+ }
56
+ });
57
+ expect(readFileSync(configPath, 'utf8')).toContain('"mcpServers"');
58
+ });
59
+ });
@@ -0,0 +1,30 @@
1
+ import { readFileSync } from 'node:fs';
2
+
3
+ import { describe, expect, it } from 'vitest';
4
+
5
+ interface PackageJson {
6
+ main: string;
7
+ bin: Record<string, string>;
8
+ }
9
+
10
+ describe('package build entrypoints', () => {
11
+ it('builds the root package main declared in package.json', () => {
12
+ const pkg = JSON.parse(readFileSync('package.json', 'utf-8')) as PackageJson;
13
+ const buildScript = readFileSync('scripts/build.ts', 'utf-8');
14
+
15
+ expect(pkg.main).toBe('dist/index.js');
16
+ expect(buildScript).toContain("entryPoints: ['src/index.ts']");
17
+ expect(buildScript).toContain("outfile: 'dist/index.js'");
18
+ });
19
+
20
+ it('keeps MCP package bin wiring covered by the build script', () => {
21
+ const pkg = JSON.parse(readFileSync('package.json', 'utf-8')) as PackageJson;
22
+ const lock = JSON.parse(readFileSync('package-lock.json', 'utf-8')) as { packages: Record<string, { bin?: Record<string, string> }> };
23
+ const buildScript = readFileSync('scripts/build.ts', 'utf-8');
24
+
25
+ expect(pkg.bin['claude-memory-layer-mcp']).toBe('dist/mcp/index.js');
26
+ expect(lock.packages[''].bin).toMatchObject(pkg.bin);
27
+ expect(buildScript).toContain("entryPoints: ['src/mcp/index.ts']");
28
+ expect(buildScript).toContain("outfile: 'dist/mcp/index.js'");
29
+ });
30
+ });