claude-memory-layer 1.0.27 → 1.0.28

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 (329) hide show
  1. package/.env.example +7 -0
  2. package/AGENTS.md +11 -0
  3. package/README.md +184 -41
  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 +9 -5
  56. package/scripts/build.ts +25 -8
  57. package/scripts/generate-session-qrels.ts +126 -0
  58. package/scripts/replay-retrieval-benchmark.ts +69 -0
  59. package/specs/thin-core-refactor/context.md +275 -0
  60. package/specs/thin-core-refactor/plan.md +536 -0
  61. package/specs/thin-core-refactor/spec.md +465 -0
  62. package/src/adapters/claude/capture/index.ts +3 -0
  63. package/src/adapters/claude/context/index.ts +3 -0
  64. package/src/adapters/claude/hooks/index.ts +21 -0
  65. package/src/adapters/claude/hooks/post-tool-use.ts +239 -0
  66. package/src/adapters/claude/hooks/prompt-injection-policy.ts +104 -0
  67. package/src/adapters/claude/hooks/semantic-daemon-client.ts +209 -0
  68. package/src/adapters/claude/hooks/semantic-daemon.ts +283 -0
  69. package/src/adapters/claude/hooks/session-end.ts +59 -0
  70. package/src/adapters/claude/hooks/session-start.ts +73 -0
  71. package/src/adapters/claude/hooks/stop.ts +128 -0
  72. package/src/adapters/claude/hooks/user-prompt-submit.ts +361 -0
  73. package/src/adapters/claude/index.ts +4 -0
  74. package/src/adapters/claude/transcript/index.ts +4 -0
  75. package/src/adapters/claude/transcript/transcript-reader.ts +57 -0
  76. package/src/adapters/claude/transcript/turn-reconstructor.ts +65 -0
  77. package/src/apps/cli/claude-settings-hooks.ts +138 -0
  78. package/src/apps/cli/codex-import-runner.ts +125 -0
  79. package/src/apps/cli/codex-validation-output.ts +95 -0
  80. package/src/apps/cli/hermes-import-runner.ts +130 -0
  81. package/src/apps/cli/hermes-validation-output.ts +91 -0
  82. package/src/apps/cli/index.ts +1731 -0
  83. package/src/apps/cli/mcp-install.ts +106 -0
  84. package/src/apps/cli/retrieval-disclosure-output.ts +196 -0
  85. package/src/apps/dashboard/assets/js/bootstrap.js +244 -0
  86. package/src/apps/dashboard/assets/js/chat.js +373 -0
  87. package/src/apps/dashboard/assets/js/disclosure.js +232 -0
  88. package/src/apps/dashboard/assets/js/modals.js +298 -0
  89. package/src/apps/dashboard/assets/js/overview.js +655 -0
  90. package/src/apps/dashboard/assets/js/state.js +72 -0
  91. package/src/apps/dashboard/assets/js/views.js +468 -0
  92. package/src/{ui → apps/dashboard}/index.html +43 -1
  93. package/src/apps/dashboard/index.ts +3 -0
  94. package/src/{ui → apps/dashboard}/style.css +222 -0
  95. package/src/apps/index.ts +5 -0
  96. package/src/apps/server/api/chat.ts +244 -0
  97. package/src/apps/server/api/citations.ts +105 -0
  98. package/src/apps/server/api/events.ts +137 -0
  99. package/src/apps/server/api/health.ts +53 -0
  100. package/src/apps/server/api/index.ts +26 -0
  101. package/src/apps/server/api/projects.ts +74 -0
  102. package/src/apps/server/api/search.ts +184 -0
  103. package/src/apps/server/api/sessions.ts +115 -0
  104. package/src/apps/server/api/stats.ts +723 -0
  105. package/src/apps/server/api/turns.ts +143 -0
  106. package/src/apps/server/api/utils.ts +65 -0
  107. package/src/apps/server/index.ts +111 -0
  108. package/src/cli/index.ts +2 -1311
  109. package/src/cli/retrieval-disclosure-output.ts +2 -0
  110. package/src/compat/index.ts +5 -0
  111. package/src/core/derive/fact-deriver.ts +170 -0
  112. package/src/core/derive/index.ts +2 -0
  113. package/src/core/derive/summary-deriver.ts +76 -0
  114. package/src/core/embedder.ts +4 -152
  115. package/src/core/engine/embedding-maintenance-service.ts +187 -0
  116. package/src/core/engine/endless-memory-services.ts +4 -0
  117. package/src/core/engine/index.ts +19 -0
  118. package/src/core/engine/memory-engine-services.ts +170 -0
  119. package/src/core/engine/memory-ingest-service.ts +317 -0
  120. package/src/core/engine/memory-query-service.ts +173 -0
  121. package/src/core/engine/memory-runtime-service.ts +162 -0
  122. package/src/core/engine/memory-service-composition.ts +231 -0
  123. package/src/core/engine/retrieval-analytics-service.ts +181 -0
  124. package/src/core/engine/retrieval-disclosure-service.ts +420 -0
  125. package/src/core/engine/retrieval-orchestrator.ts +377 -0
  126. package/src/core/engine/retrieval-services.ts +176 -0
  127. package/src/core/engine/shared-memory-services.ts +4 -0
  128. package/src/core/entity-repo.ts +1 -3
  129. package/src/core/event-store.ts +3 -3
  130. package/src/core/evidence-aligner.ts +2 -2
  131. package/src/core/external-market-context.ts +582 -0
  132. package/src/core/graduation.ts +2 -3
  133. package/src/core/index.ts +21 -0
  134. package/src/core/matcher.ts +2 -4
  135. package/src/core/model/memory-fact.ts +30 -0
  136. package/src/core/model/memory-rule.ts +14 -0
  137. package/src/core/model/memory-summary.ts +21 -0
  138. package/src/core/model/raw-event.ts +28 -0
  139. package/src/core/model/retrieval-result.ts +35 -0
  140. package/src/core/privacy/filter.ts +21 -10
  141. package/src/core/product-validation-matrix.ts +314 -0
  142. package/src/core/progressive-retriever.ts +1 -2
  143. package/src/core/registry/project-path.ts +54 -0
  144. package/src/core/registry/session-registry.ts +69 -0
  145. package/src/core/replay-evaluator.ts +625 -0
  146. package/src/core/retrieval-benchmark.ts +117 -0
  147. package/src/core/retrieval-quality.ts +109 -0
  148. package/src/core/retriever.ts +53 -15
  149. package/src/core/session-qrels.ts +360 -0
  150. package/src/core/shared-event-store.ts +1 -1
  151. package/src/core/sqlite-event-store.ts +35 -11
  152. package/src/core/task/blocker-resolver.ts +2 -2
  153. package/src/core/task/task-resolver.ts +0 -1
  154. package/src/core/vector-outbox.ts +1 -10
  155. package/src/core/vector-worker.ts +1 -1
  156. package/src/extensions/endless-memory/endless-memory-services.ts +350 -0
  157. package/src/extensions/endless-memory/index.ts +1 -0
  158. package/src/extensions/index.ts +5 -0
  159. package/src/extensions/mcp/handlers.ts +960 -0
  160. package/src/extensions/mcp/index.ts +48 -0
  161. package/src/extensions/mcp/tools.ts +252 -0
  162. package/src/extensions/shared-memory/index.ts +1 -0
  163. package/src/extensions/shared-memory/shared-memory-services.ts +211 -0
  164. package/src/extensions/vector/embedder.ts +197 -0
  165. package/src/extensions/vector/index.ts +1 -0
  166. package/src/hooks/post-tool-use.ts +3 -236
  167. package/src/hooks/semantic-daemon-client.ts +1 -208
  168. package/src/hooks/semantic-daemon.ts +6 -271
  169. package/src/hooks/session-end.ts +4 -79
  170. package/src/hooks/session-start.ts +4 -73
  171. package/src/hooks/stop.ts +3 -173
  172. package/src/hooks/user-prompt-submit.ts +3 -338
  173. package/src/index.ts +13 -0
  174. package/src/mcp/handlers.ts +2 -212
  175. package/src/mcp/index.ts +3 -46
  176. package/src/mcp/tools.ts +2 -78
  177. package/src/server/api/chat.ts +2 -244
  178. package/src/server/api/citations.ts +2 -105
  179. package/src/server/api/events.ts +2 -137
  180. package/src/server/api/health.ts +2 -53
  181. package/src/server/api/index.ts +2 -26
  182. package/src/server/api/projects.ts +2 -74
  183. package/src/server/api/search.ts +2 -102
  184. package/src/server/api/sessions.ts +2 -115
  185. package/src/server/api/stats.ts +2 -724
  186. package/src/server/api/turns.ts +2 -143
  187. package/src/server/api/utils.ts +2 -46
  188. package/src/server/index.ts +2 -100
  189. package/src/services/bootstrap-organizer.ts +46 -26
  190. package/src/services/codex-session-history-importer.ts +521 -29
  191. package/src/services/hermes-session-history-importer.ts +733 -0
  192. package/src/services/memory-service-config.ts +36 -0
  193. package/src/services/memory-service-registry.ts +150 -0
  194. package/src/services/memory-service.ts +211 -1325
  195. package/src/services/session-history-importer.ts +58 -14
  196. package/tests/README.md +23 -0
  197. package/tests/adapters/claude/claude-semantic-daemon-adapter.test.ts +54 -0
  198. package/tests/adapters/claude/claude-transcript-reconstructor.test.ts +98 -0
  199. package/tests/adapters/claude-hook-prompt-injection-policy.test.ts +99 -0
  200. package/tests/apps/app-layer-boundary.test.ts +48 -0
  201. package/tests/apps/claude-settings-hooks.test.ts +107 -0
  202. package/tests/apps/cli-disclosure-output.test.ts +212 -0
  203. package/tests/apps/codex-import-runner.test.ts +99 -0
  204. package/tests/apps/codex-validation-output.test.ts +100 -0
  205. package/tests/apps/hermes-import-runner.test.ts +99 -0
  206. package/tests/apps/mcp-install-command.test.ts +59 -0
  207. package/tests/apps/package-build-entrypoints.test.ts +30 -0
  208. package/tests/apps/search-api-disclosure.test.ts +162 -0
  209. package/tests/apps/stats-api-lightweight.test.ts +67 -0
  210. package/tests/apps/ui-disclosure-output.test.ts +140 -0
  211. package/tests/{bootstrap-organizer.test.ts → core/bootstrap-organizer.test.ts} +1 -1
  212. package/tests/{canonical-key.test.ts → core/canonical-key.test.ts} +1 -1
  213. package/tests/core/codex-session-history-importer-validation.test.ts +185 -0
  214. package/tests/{consolidation-worker.test.ts → core/consolidation-worker.test.ts} +2 -2
  215. package/tests/core/embedding-maintenance-service.test.ts +282 -0
  216. package/tests/{evidence-aligner.test.ts → core/evidence-aligner.test.ts} +1 -1
  217. package/tests/core/external-market-context.test.ts +209 -0
  218. package/tests/core/fact-deriver.test.ts +79 -0
  219. package/tests/core/hermes-session-history-importer-validation.test.ts +609 -0
  220. package/tests/{ingest-interceptor.test.ts → core/ingest-interceptor.test.ts} +1 -1
  221. package/tests/{markdown-mirror.test.ts → core/markdown-mirror.test.ts} +2 -2
  222. package/tests/{matcher.test.ts → core/matcher.test.ts} +1 -1
  223. package/tests/{md-mirror.test.ts → core/md-mirror.test.ts} +2 -2
  224. package/tests/core/memory-engine-services.test.ts +240 -0
  225. package/tests/core/memory-ingest-service.test.ts +296 -0
  226. package/tests/core/memory-query-service.test.ts +129 -0
  227. package/tests/core/memory-runtime-service.test.ts +201 -0
  228. package/tests/core/memory-service-composition.test.ts +192 -0
  229. package/tests/core/memory-service-config.test.ts +41 -0
  230. package/tests/core/memory-service-facade.test.ts +30 -0
  231. package/tests/core/memory-service-registry.test.ts +206 -0
  232. package/tests/core/product-validation-matrix.test.ts +61 -0
  233. package/tests/core/project-registry.test.ts +78 -0
  234. package/tests/core/replay-evaluator.test.ts +181 -0
  235. package/tests/core/retrieval-analytics-service.test.ts +210 -0
  236. package/tests/core/retrieval-benchmark.test.ts +93 -0
  237. package/tests/core/retrieval-disclosure-service.test.ts +264 -0
  238. package/tests/core/retrieval-orchestrator.test.ts +403 -0
  239. package/tests/core/retrieval-quality.test.ts +31 -0
  240. package/tests/core/retrieval-services.test.ts +185 -0
  241. package/tests/{retriever-fallback-chain.test.ts → core/retriever-fallback-chain.test.ts} +3 -3
  242. package/tests/{retriever-strategy-scope.test.ts → core/retriever-strategy-scope.test.ts} +70 -3
  243. package/tests/{retriever.memu-adoption.test.ts → core/retriever.memu-adoption.test.ts} +3 -3
  244. package/tests/core/session-history-importer-filter.test.ts +78 -0
  245. package/tests/core/session-qrels.test.ts +250 -0
  246. package/tests/{sqlite-event-store-replication.test.ts → core/sqlite-event-store-replication.test.ts} +36 -1
  247. package/tests/core/summary-deriver.test.ts +66 -0
  248. package/tests/extensions/embedder-warning-suppression.test.ts +53 -0
  249. package/tests/extensions/endless-memory-extension-boundary.test.ts +17 -0
  250. package/tests/extensions/endless-memory-services.test.ts +325 -0
  251. package/tests/extensions/mcp-context-tools.test.ts +905 -0
  252. package/tests/extensions/mcp-extension-boundary.test.ts +21 -0
  253. package/tests/extensions/mcp-package-build.test.ts +22 -0
  254. package/tests/extensions/mcp-project-aware-tools.test.ts +102 -0
  255. package/tests/extensions/shared-memory-extension-boundary.test.ts +24 -0
  256. package/tests/extensions/shared-memory-services.test.ts +309 -0
  257. package/tests/extensions/vector-extension-boundary.test.ts +21 -0
  258. package/.claude/settings.local.json +0 -25
  259. package/.npm-cache/_cacache/content-v2/sha512/04/76/c098f88dfe584a2b80870bff7421b05d17d3d9ee1027f77772332a22d3f93a9a57101a2855107f6ad82077a818bba912b2bc317f2361b5ddb09ad284d9ce +0 -0
  260. package/.npm-cache/_cacache/content-v2/sha512/60/25/d2ecd39cfc7cab58351162814be77f935c6d6491c10c3745d456da7ddb2117ffd90c10e53fe3c0f1ed16b403307841543634504398b16ee4e6b6dd8e0c45 +0 -0
  261. package/.npm-cache/_cacache/index-v5/2b/9a/7f8f40206ed8a2e0a84efaa953ccaed1f5d001e14b931083f2e7a0738007 +0 -2
  262. package/.npm-cache/_cacache/index-v5/2e/d9/fcfa5c6a6abdc2a3644ab84a95936047298c465a2f47ee03db8f7fe1e946 +0 -3
  263. package/.npm-cache/_cacache/index-v5/a9/42/e519633356d12d3d2f19da66a8301016d496c8f5c3e0554124aaa62dc043 +0 -2
  264. package/.npm-cache/_logs/2026-02-26T12_04_52_729Z-debug-0.log +0 -256
  265. package/.npm-cache/_logs/2026-02-26T12_05_36_835Z-debug-0.log +0 -18
  266. package/.npm-cache/_logs/2026-02-26T12_05_45_982Z-debug-0.log +0 -32
  267. package/.npm-cache/_logs/2026-02-26T12_05_48_515Z-debug-0.log +0 -260
  268. package/.npm-cache/_logs/2026-02-26T12_05_53_567Z-debug-0.log +0 -69
  269. package/.npm-cache/_update-notifier-last-checked +0 -0
  270. package/bootstrap-kb/decisions/decisions.md +0 -244
  271. package/bootstrap-kb/glossary/glossary.md +0 -46
  272. package/bootstrap-kb/modules/.claude-plugin.md +0 -22
  273. package/bootstrap-kb/modules/agents.md.md +0 -15
  274. package/bootstrap-kb/modules/claude.md.md +0 -15
  275. package/bootstrap-kb/modules/context.md.md +0 -15
  276. package/bootstrap-kb/modules/docs.md +0 -18
  277. package/bootstrap-kb/modules/handoff.md.md +0 -15
  278. package/bootstrap-kb/modules/package-lock.json.md +0 -15
  279. package/bootstrap-kb/modules/package.json.md +0 -15
  280. package/bootstrap-kb/modules/plan.md.md +0 -15
  281. package/bootstrap-kb/modules/readme.md.md +0 -15
  282. package/bootstrap-kb/modules/scripts.md +0 -26
  283. package/bootstrap-kb/modules/spec.md.md +0 -15
  284. package/bootstrap-kb/modules/specs.md +0 -20
  285. package/bootstrap-kb/modules/src.md +0 -51
  286. package/bootstrap-kb/modules/tests.md +0 -42
  287. package/bootstrap-kb/modules/tsconfig.json.md +0 -15
  288. package/bootstrap-kb/modules/vitest.config.ts.md +0 -15
  289. package/bootstrap-kb/overview/overview.md +0 -40
  290. package/bootstrap-kb/sources/manifest.json +0 -950
  291. package/bootstrap-kb/sources/manifest.md +0 -227
  292. package/bootstrap-kb/timeline/timeline.md +0 -57
  293. package/claude-memory-layer-1.0.14.tgz +0 -0
  294. package/d.sh +0 -3
  295. package/deploy.sh +0 -3
  296. package/dist/ui/app.js +0 -2101
  297. package/memory/.claude-plugin/commands/2026-02-25.md +0 -263
  298. package/memory/_index.md +0 -419
  299. package/memory/agent_response/uncategorized/2026-02-26.md +0 -176
  300. package/memory/agent_response/uncategorized/2026-03-03.md +0 -14
  301. package/memory/agent_response/uncategorized/2026-03-04.md +0 -1421
  302. package/memory/agent_response/uncategorized/2026-03-05.md +0 -157
  303. package/memory/default/uncategorized/2026-02-25.md +0 -4839
  304. package/memory/session_summary/uncategorized/2026-02-26.md +0 -13
  305. package/memory/session_summary/uncategorized/2026-03-03.md +0 -5
  306. package/memory/session_summary/uncategorized/2026-03-04.md +0 -50
  307. package/memory/specs/20260207-dashboard-upgrade/2026-02-25.md +0 -142
  308. package/memory/specs/citations-system/2026-02-25.md +0 -1121
  309. package/memory/specs/endless-mode/2026-02-25.md +0 -1392
  310. package/memory/specs/entity-edge-model/2026-02-25.md +0 -1263
  311. package/memory/specs/evidence-aligner-v2/2026-02-25.md +0 -1028
  312. package/memory/specs/mcp-desktop-integration/2026-02-25.md +0 -1334
  313. package/memory/specs/post-tool-use-hook/2026-02-25.md +0 -1164
  314. package/memory/specs/private-tags/2026-02-25.md +0 -1057
  315. package/memory/specs/progressive-disclosure/2026-02-25.md +0 -1436
  316. package/memory/specs/task-entity-system/2026-02-25.md +0 -924
  317. package/memory/specs/vector-outbox-v2/2026-02-25.md +0 -1510
  318. package/memory/specs/web-viewer-ui/2026-02-25.md +0 -1709
  319. package/memory/tool_observation/uncategorized/2026-02-26.md +0 -209
  320. package/memory/tool_observation/uncategorized/2026-03-03.md +0 -21
  321. package/memory/tool_observation/uncategorized/2026-03-04.md +0 -1033
  322. package/memory/tool_observation/uncategorized/2026-03-05.md +0 -33
  323. package/memory/user_prompt/uncategorized/2026-02-26.md +0 -25
  324. package/memory/user_prompt/uncategorized/2026-03-04.md +0 -634
  325. package/memory/user_prompt/uncategorized/2026-03-05.md +0 -6
  326. package/specs/optional-duckdb/context.md +0 -77
  327. package/specs/optional-duckdb/plan.md +0 -142
  328. package/specs/optional-duckdb/spec.md +0 -35
  329. 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
+ });