claude-memory-layer 1.0.26 → 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 (328) 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 -418
  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 -48
  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 -29
  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/specs/optional-duckdb/context.md +0 -77
  326. package/specs/optional-duckdb/plan.md +0 -142
  327. package/specs/optional-duckdb/spec.md +0 -35
  328. package/src/ui/app.js +0 -2101
@@ -0,0 +1,373 @@
1
+ function loadChatHistory() {
2
+ try {
3
+ const raw = localStorage.getItem(CHAT_STORAGE_KEY);
4
+ return raw ? JSON.parse(raw) : [];
5
+ } catch { return []; }
6
+ }
7
+
8
+ function saveChatHistory(conversations) {
9
+ try {
10
+ // Keep last 50 conversations max
11
+ const trimmed = conversations.slice(-50);
12
+ localStorage.setItem(CHAT_STORAGE_KEY, JSON.stringify(trimmed));
13
+ } catch { /* storage full or unavailable */ }
14
+ }
15
+
16
+ function saveCurrentConversation() {
17
+ if (state.chatMessages.length === 0) return;
18
+ const conversations = loadChatHistory();
19
+ const firstUserMsg = state.chatMessages.find(m => m.role === 'user');
20
+ const title = firstUserMsg ? firstUserMsg.content.slice(0, 80) : 'Untitled';
21
+
22
+ if (state.chatConversationId) {
23
+ // Update existing
24
+ const idx = conversations.findIndex(c => c.id === state.chatConversationId);
25
+ if (idx >= 0) {
26
+ conversations[idx].messages = [...state.chatMessages];
27
+ conversations[idx].updatedAt = new Date().toISOString();
28
+ conversations[idx].title = title;
29
+ }
30
+ } else {
31
+ // Create new
32
+ state.chatConversationId = 'chat-' + Date.now();
33
+ conversations.push({
34
+ id: state.chatConversationId,
35
+ title,
36
+ messages: [...state.chatMessages],
37
+ createdAt: new Date().toISOString(),
38
+ updatedAt: new Date().toISOString(),
39
+ project: state.currentProject || 'global'
40
+ });
41
+ }
42
+ saveChatHistory(conversations);
43
+ }
44
+
45
+ function startNewConversation() {
46
+ saveCurrentConversation();
47
+ state.chatMessages = [];
48
+ state.chatConversationId = null;
49
+
50
+ const container = document.getElementById('chat-messages');
51
+ container.innerHTML = `
52
+ <div class="chat-welcome">
53
+ <div class="chat-welcome-icon">🧠</div>
54
+ <div class="chat-welcome-title">Ask about your memories</div>
55
+ <div class="chat-welcome-text">
56
+ I can search through your coding sessions, tool usage, and stored knowledge to answer questions.
57
+ </div>
58
+ </div>
59
+ `;
60
+ switchChatTab('chat');
61
+ }
62
+
63
+ function loadConversation(id) {
64
+ const conversations = loadChatHistory();
65
+ const conv = conversations.find(c => c.id === id);
66
+ if (!conv) return;
67
+
68
+ // Save current first
69
+ if (state.chatMessages.length > 0 && state.chatConversationId !== id) {
70
+ saveCurrentConversation();
71
+ }
72
+
73
+ state.chatConversationId = conv.id;
74
+ state.chatMessages = [...conv.messages];
75
+
76
+ // Render messages
77
+ const container = document.getElementById('chat-messages');
78
+ container.innerHTML = '';
79
+ for (const msg of conv.messages) {
80
+ appendChatMessage(msg.role, msg.content);
81
+ }
82
+
83
+ switchChatTab('chat');
84
+ }
85
+
86
+ function deleteConversation(id, evt) {
87
+ evt.stopPropagation();
88
+ const conversations = loadChatHistory().filter(c => c.id !== id);
89
+ saveChatHistory(conversations);
90
+ if (state.chatConversationId === id) {
91
+ state.chatMessages = [];
92
+ state.chatConversationId = null;
93
+ const container = document.getElementById('chat-messages');
94
+ container.innerHTML = `
95
+ <div class="chat-welcome">
96
+ <div class="chat-welcome-icon">🧠</div>
97
+ <div class="chat-welcome-title">Ask about your memories</div>
98
+ <div class="chat-welcome-text">
99
+ I can search through your coding sessions, tool usage, and stored knowledge to answer questions.
100
+ </div>
101
+ </div>
102
+ `;
103
+ }
104
+ renderHistoryList();
105
+ }
106
+
107
+ function renderHistoryList() {
108
+ const container = document.getElementById('chat-history-view');
109
+ const conversations = loadChatHistory().reverse(); // newest first
110
+
111
+ if (conversations.length === 0) {
112
+ container.innerHTML = '<div class="chat-history-empty">No conversation history yet.</div>';
113
+ return;
114
+ }
115
+
116
+ container.innerHTML = conversations.map(conv => {
117
+ const date = new Date(conv.updatedAt || conv.createdAt);
118
+ const dateStr = date.toLocaleDateString() + ' ' + date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
119
+ const msgCount = conv.messages.length;
120
+ const isActive = conv.id === state.chatConversationId;
121
+ return `
122
+ <div class="chat-history-item${isActive ? ' active' : ''}" onclick="loadConversation('${conv.id}')"
123
+ style="${isActive ? 'border-color:var(--accent-primary);background:rgba(123,97,255,0.08);' : ''}">
124
+ <div class="chat-history-item-title">${escapeHtml(conv.title)}</div>
125
+ <div class="chat-history-item-meta">
126
+ <span>${dateStr} &middot; ${msgCount} messages</span>
127
+ <button class="chat-history-item-delete" onclick="deleteConversation('${conv.id}', event)" title="Delete">
128
+ <i class="ri-delete-bin-line"></i>
129
+ </button>
130
+ </div>
131
+ </div>
132
+ `;
133
+ }).join('');
134
+ }
135
+
136
+ function switchChatTab(tab) {
137
+ const msgContainer = document.getElementById('chat-messages');
138
+ const historyContainer = document.getElementById('chat-history-view');
139
+ const inputArea = document.querySelector('.chat-input-area');
140
+
141
+ document.querySelectorAll('.chat-header-tab').forEach(t => {
142
+ t.classList.toggle('active', t.dataset.chatTab === tab);
143
+ });
144
+
145
+ if (tab === 'chat') {
146
+ msgContainer.classList.remove('hidden');
147
+ historyContainer.classList.remove('active');
148
+ if (inputArea) inputArea.style.display = '';
149
+ } else {
150
+ msgContainer.classList.add('hidden');
151
+ historyContainer.classList.add('active');
152
+ if (inputArea) inputArea.style.display = 'none';
153
+ renderHistoryList();
154
+ }
155
+
156
+ state.chatCurrentTab = tab;
157
+ }
158
+
159
+ function toggleChatPanel() {
160
+ if (state.isChatOpen) {
161
+ closeChatPanel();
162
+ } else {
163
+ openChatPanel();
164
+ }
165
+ }
166
+
167
+ function openChatPanel() {
168
+ const panel = document.getElementById('chat-panel');
169
+ if (panel) {
170
+ panel.classList.add('open');
171
+ state.isChatOpen = true;
172
+ updateChatProjectScope();
173
+ setTimeout(() => {
174
+ document.getElementById('chat-input')?.focus();
175
+ }, 300);
176
+ }
177
+ }
178
+
179
+ function closeChatPanel() {
180
+ const panel = document.getElementById('chat-panel');
181
+ if (panel) {
182
+ panel.classList.remove('open');
183
+ state.isChatOpen = false;
184
+ }
185
+ if (state.chatAbortController) {
186
+ state.chatAbortController.abort();
187
+ state.chatAbortController = null;
188
+ state.isChatStreaming = false;
189
+ }
190
+ // Auto-save on close
191
+ saveCurrentConversation();
192
+ }
193
+
194
+ function updateChatProjectScope() {
195
+ const el = document.getElementById('chat-project-scope');
196
+ if (!el) return;
197
+ if (state.currentProject) {
198
+ const proj = state.projects.find(p => p.hash === state.currentProject);
199
+ el.textContent = `Scope: ${proj?.projectName || state.currentProject}`;
200
+ } else {
201
+ el.textContent = 'Scope: All (Global)';
202
+ }
203
+ }
204
+
205
+ async function sendChatMessage() {
206
+ const input = document.getElementById('chat-input');
207
+ const message = input.value.trim();
208
+ if (!message) return;
209
+
210
+ input.value = '';
211
+ input.style.height = 'auto';
212
+ document.getElementById('chat-send-btn').disabled = true;
213
+
214
+ // Add user message
215
+ state.chatMessages.push({ role: 'user', content: message });
216
+ appendChatMessage('user', message);
217
+
218
+ // Remove welcome
219
+ const welcome = document.querySelector('.chat-welcome');
220
+ if (welcome) welcome.remove();
221
+
222
+ // Show loading
223
+ const loadingEl = appendChatLoading();
224
+
225
+ state.isChatStreaming = true;
226
+ state.chatAbortController = new AbortController();
227
+
228
+ try {
229
+ const response = await fetch(apiUrl(`${API_BASE}/chat`), {
230
+ method: 'POST',
231
+ headers: { 'Content-Type': 'application/json' },
232
+ body: JSON.stringify({
233
+ message,
234
+ history: state.chatMessages.slice(-10)
235
+ }),
236
+ signal: state.chatAbortController.signal
237
+ });
238
+
239
+ if (!response.ok) {
240
+ const err = await response.json().catch(() => ({ error: `HTTP ${response.status}` }));
241
+ throw new Error(err.error || `Request failed: ${response.status}`);
242
+ }
243
+
244
+ loadingEl.remove();
245
+ const msgEl = appendChatMessage('assistant', '', true);
246
+ let fullContent = '';
247
+
248
+ const reader = response.body.getReader();
249
+ const decoder = new TextDecoder();
250
+ let sseBuffer = '';
251
+
252
+ while (true) {
253
+ const { done, value } = await reader.read();
254
+ if (done) break;
255
+
256
+ sseBuffer += decoder.decode(value, { stream: true });
257
+ const lines = sseBuffer.split('\n');
258
+ sseBuffer = lines.pop() || '';
259
+
260
+ for (const line of lines) {
261
+ if (line.startsWith('data: ')) {
262
+ const dataStr = line.slice(6);
263
+ try {
264
+ const data = JSON.parse(dataStr);
265
+ if (data.content) {
266
+ fullContent += data.content;
267
+ updateChatMessageContent(msgEl, fullContent);
268
+ scrollChatToBottom();
269
+ }
270
+ if (data.error) {
271
+ fullContent += `\n\n**Error:** ${data.error}`;
272
+ updateChatMessageContent(msgEl, fullContent);
273
+ }
274
+ } catch { /* skip */ }
275
+ }
276
+ }
277
+ }
278
+
279
+ msgEl.classList.remove('streaming');
280
+ if (fullContent) {
281
+ state.chatMessages.push({ role: 'assistant', content: fullContent });
282
+ }
283
+
284
+ // Auto-save after each response
285
+ saveCurrentConversation();
286
+
287
+ } catch (err) {
288
+ if (loadingEl.parentNode) loadingEl.remove();
289
+ if (err.name !== 'AbortError') {
290
+ appendChatMessage('assistant',
291
+ `**Error:** ${err.message}\n\nMake sure the Claude CLI is installed and authenticated.`
292
+ );
293
+ }
294
+ } finally {
295
+ state.isChatStreaming = false;
296
+ state.chatAbortController = null;
297
+ const sendBtn = document.getElementById('chat-send-btn');
298
+ const chatInput = document.getElementById('chat-input');
299
+ if (sendBtn && chatInput) {
300
+ sendBtn.disabled = !chatInput.value.trim();
301
+ }
302
+ }
303
+ }
304
+
305
+ function appendChatMessage(role, content, streaming = false) {
306
+ const container = document.getElementById('chat-messages');
307
+ const el = document.createElement('div');
308
+ el.className = `chat-msg ${role}${streaming ? ' streaming' : ''}`;
309
+
310
+ if (role === 'assistant') {
311
+ el.innerHTML = renderMarkdown(content);
312
+ } else {
313
+ el.textContent = content;
314
+ }
315
+
316
+ container.appendChild(el);
317
+ scrollChatToBottom();
318
+ return el;
319
+ }
320
+
321
+ function appendChatLoading() {
322
+ const container = document.getElementById('chat-messages');
323
+ const el = document.createElement('div');
324
+ el.className = 'chat-loading';
325
+ el.innerHTML = `
326
+ <div class="chat-loading-dot"></div>
327
+ <div class="chat-loading-dot"></div>
328
+ <div class="chat-loading-dot"></div>
329
+ `;
330
+ container.appendChild(el);
331
+ scrollChatToBottom();
332
+ return el;
333
+ }
334
+
335
+ function updateChatMessageContent(el, content) {
336
+ el.innerHTML = renderMarkdown(content);
337
+ }
338
+
339
+ function scrollChatToBottom() {
340
+ const container = document.getElementById('chat-messages');
341
+ if (container) container.scrollTop = container.scrollHeight;
342
+ }
343
+
344
+ function renderMarkdown(text) {
345
+ if (!text) return '';
346
+
347
+ let html = escapeHtml(text);
348
+
349
+ // Code blocks
350
+ html = html.replace(/```(\w*)\n([\s\S]*?)```/g, '<pre><code>$2</code></pre>');
351
+
352
+ // Inline code
353
+ html = html.replace(/`([^`]+)`/g, '<code>$1</code>');
354
+
355
+ // Bold
356
+ html = html.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>');
357
+
358
+ // Italic
359
+ html = html.replace(/\*(.+?)\*/g, '<em>$1</em>');
360
+
361
+ // Headers
362
+ html = html.replace(/^### (.+)$/gm, '<div style="font-weight:600;color:var(--text-primary);margin:12px 0 4px;">$1</div>');
363
+ html = html.replace(/^## (.+)$/gm, '<div style="font-size:15px;font-weight:600;color:var(--text-primary);margin:12px 0 4px;">$1</div>');
364
+
365
+ // Lists
366
+ html = html.replace(/^- (.+)$/gm, '<div style="padding-left:16px;">&#8226; $1</div>');
367
+
368
+ // Line breaks
369
+ html = html.replace(/\n/g, '<br>');
370
+
371
+ return html;
372
+ }
373
+
@@ -0,0 +1,232 @@
1
+
2
+ // --- Progressive Disclosure Dashboard ---
3
+
4
+ function setupDisclosureSearchListeners() {
5
+ const input = document.getElementById('disclosure-search-input');
6
+ const button = document.getElementById('disclosure-search-btn');
7
+ if (button) button.addEventListener('click', handleDisclosureSearch);
8
+ if (input) {
9
+ input.addEventListener('keydown', (e) => {
10
+ if (e.key === 'Enter') {
11
+ e.preventDefault();
12
+ handleDisclosureSearch();
13
+ }
14
+ });
15
+ }
16
+ }
17
+
18
+ function renderDisclosureStatus(message, isError = false) {
19
+ const status = document.getElementById('disclosure-status');
20
+ if (!status) return;
21
+ status.textContent = message || '';
22
+ status.style.color = isError ? 'var(--error)' : 'var(--text-muted)';
23
+ }
24
+
25
+ async function handleDisclosureSearch() {
26
+ const input = document.getElementById('disclosure-search-input');
27
+ const query = (input?.value || '').trim();
28
+ if (!query || state.isDisclosureLoading) return;
29
+
30
+ const button = document.getElementById('disclosure-search-btn');
31
+ const includeShared = document.getElementById('disclosure-include-shared')?.checked || false;
32
+ const strategy = document.getElementById('disclosure-strategy')?.value || 'auto';
33
+ const topK = parseInt(document.getElementById('disclosure-topk')?.value || '8', 10);
34
+
35
+ state.isDisclosureLoading = true;
36
+ state.disclosureResults = [];
37
+ state.disclosureMeta = null;
38
+ state.disclosureSelectedId = null;
39
+ state.disclosureExpansion = null;
40
+ state.disclosureSource = null;
41
+ if (button) button.disabled = true;
42
+ renderDisclosureStatus('Searching compact retrieval envelopes...');
43
+ renderDisclosureResults();
44
+ renderDisclosureDrilldown();
45
+
46
+ try {
47
+ const res = await fetch(apiUrl(`${API_BASE}/search/disclosure`), {
48
+ method: 'POST',
49
+ headers: { 'Content-Type': 'application/json' },
50
+ body: JSON.stringify({
51
+ query,
52
+ options: {
53
+ topK: Number.isFinite(topK) ? topK : 8,
54
+ includeShared,
55
+ strategy
56
+ }
57
+ })
58
+ });
59
+ const data = await res.json();
60
+ if (!res.ok) throw new Error(data.error || 'Disclosure search failed');
61
+
62
+ state.disclosureResults = data.results || [];
63
+ state.disclosureMeta = data.meta || null;
64
+ renderDisclosureStatus(`Search layer returned ${state.disclosureResults.length} result(s). Click a result to expand/source.`);
65
+ renderDisclosureResults();
66
+ } catch (error) {
67
+ state.disclosureResults = [];
68
+ renderDisclosureStatus(error.message || 'Disclosure search failed', true);
69
+ renderDisclosureResults();
70
+ } finally {
71
+ state.isDisclosureLoading = false;
72
+ if (button) button.disabled = false;
73
+ }
74
+ }
75
+
76
+ function renderDisclosureResults() {
77
+ const container = document.getElementById('disclosure-results');
78
+ if (!container) return;
79
+
80
+ if (state.isDisclosureLoading) {
81
+ container.innerHTML = '<div class="disclosure-empty">Searching...</div>';
82
+ return;
83
+ }
84
+
85
+ if (!state.disclosureResults.length) {
86
+ container.innerHTML = '<div class="disclosure-empty">Search memory to inspect compact envelopes, expansion context, and raw sources.</div>';
87
+ return;
88
+ }
89
+
90
+ const meta = state.disclosureMeta || {};
91
+ const metaHtml = `
92
+ <div class="disclosure-meta">
93
+ total=${escapeHtml(String(meta.total ?? state.disclosureResults.length))}
94
+ · vector=${meta.usedVector ? 'yes' : 'no'}
95
+ · keyword=${meta.usedKeyword ? 'yes' : 'no'}
96
+ · fallback=${meta.fallbackApplied ? 'yes' : 'no'}
97
+ </div>`;
98
+
99
+ const resultHtml = state.disclosureResults.map((r, idx) => {
100
+ const active = r.id === state.disclosureSelectedId ? ' active' : '';
101
+ const score = Number(r.score || 0).toFixed(3);
102
+ const reasons = (r.reasons || []).map(reason => `<span class="disclosure-chip">${escapeHtml(reason)}</span>`).join('');
103
+ const provenance = renderDisclosureProvenance(r.metadata, ['sourceProjectHash', 'sourceEntryId', 'topics']);
104
+ return `
105
+ <button class="disclosure-result${active}" data-result-id="${escapeHtml(r.id)}">
106
+ <div class="disclosure-result-head">
107
+ <span class="event-type-badge">#${idx + 1} ${escapeHtml(r.resultType || 'result')}</span>
108
+ <span class="disclosure-score">score ${score}</span>
109
+ </div>
110
+ <div class="disclosure-title">${escapeHtml(r.title || r.sourceRef || r.id)}</div>
111
+ <div class="disclosure-snippet">${escapeHtml(r.snippet || '(no snippet)')}</div>
112
+ ${provenance}
113
+ <div class="disclosure-reasons">${reasons || '<span class="disclosure-chip">no_reason</span>'}</div>
114
+ </button>`;
115
+ }).join('');
116
+
117
+ container.innerHTML = metaHtml + resultHtml;
118
+ container.querySelectorAll('.disclosure-result').forEach(btn => {
119
+ btn.addEventListener('click', () => loadDisclosureDrilldown(btn.dataset.resultId));
120
+ });
121
+ }
122
+
123
+ async function loadDisclosureDrilldown(resultId) {
124
+ if (!resultId) return;
125
+ state.disclosureSelectedId = resultId;
126
+ state.disclosureExpansion = null;
127
+ state.disclosureSource = null;
128
+ renderDisclosureResults();
129
+ renderDisclosureDrilldown(true);
130
+
131
+ try {
132
+ const encodedId = encodeURIComponent(resultId);
133
+ const [expandRes, sourceRes] = await Promise.all([
134
+ fetch(apiUrl(`${API_BASE}/search/disclosure/${encodedId}/expand`, { windowSize: 3 })),
135
+ fetch(apiUrl(`${API_BASE}/search/disclosure/${encodedId}/source`))
136
+ ]);
137
+ const expansion = await expandRes.json();
138
+ const source = await sourceRes.json();
139
+ if (!expandRes.ok) throw new Error(expansion.error || 'Expand failed');
140
+ state.disclosureExpansion = expansion;
141
+ state.disclosureSource = sourceRes.ok ? source : null;
142
+ renderDisclosureDrilldown(false, sourceRes.ok ? null : (source.error || 'Source not found'));
143
+ } catch (error) {
144
+ renderDisclosureDrilldown(false, error.message || 'Failed to load drilldown', true);
145
+ }
146
+ }
147
+
148
+ function renderDisclosureDrilldown(isLoading = false, message = null, isError = false) {
149
+ const container = document.getElementById('disclosure-drilldown');
150
+ if (!container) return;
151
+ if (isLoading) {
152
+ container.innerHTML = '<div class="disclosure-empty">Loading expand/source layers...</div>';
153
+ return;
154
+ }
155
+ if (message && isError) {
156
+ container.innerHTML = `<div class="disclosure-empty" style="color:var(--error);">${escapeHtml(message)}</div>`;
157
+ return;
158
+ }
159
+ if (!state.disclosureSelectedId) {
160
+ container.innerHTML = '<div class="disclosure-empty">No result selected.</div>';
161
+ return;
162
+ }
163
+
164
+ const expansion = state.disclosureExpansion;
165
+ const source = state.disclosureSource;
166
+ if (!expansion) {
167
+ container.innerHTML = '<div class="disclosure-empty">Expansion not loaded yet.</div>';
168
+ return;
169
+ }
170
+
171
+ const surrounding = (expansion.surroundingFacts || []).map(f => `
172
+ <div class="disclosure-context-item">
173
+ <span class="event-type-badge">${escapeHtml(f.resultType || 'fact')}</span>
174
+ <span>${escapeHtml(f.snippet || f.title || f.id || '')}</span>
175
+ </div>`).join('') || '<div class="disclosure-empty compact">No surrounding facts.</div>';
176
+
177
+ const related = (expansion.relatedSources || []).map(s => `
178
+ <div class="disclosure-source-ref">
179
+ <span class="disclosure-chip">${escapeHtml(s.sourceRef)} · ${escapeHtml(s.sourceType || 'source')}</span>
180
+ ${renderDisclosureProvenance(s.metadata, ['sourceProjectHash', 'sourceEntryId', 'topics'])}
181
+ </div>`).join('') || '<span class="disclosure-chip">no source refs</span>';
182
+
183
+ const rawEvent = source?.primaryEvent || source?.rawEvents?.[0] || source?.rawEvent || source?.event || null;
184
+ const isSharedSource = source?.sourceType === 'shared_troubleshooting';
185
+ const sourcePreview = rawEvent
186
+ ? `${rawEvent.eventType || rawEvent.type || 'event'} · ${rawEvent.timestamp || ''}\n${rawEvent.content || rawEvent.preview || ''}`
187
+ : isSharedSource
188
+ ? 'No local raw events for this shared source.'
189
+ : (source ? JSON.stringify(source, null, 2) : (message || 'Source layer returned no raw event.'));
190
+ const sourceProvenance = source?.metadata
191
+ ? renderDisclosureProvenance(source.metadata, ['sourceProjectHash', 'sourceEntryId', 'topics', 'rootCause', 'solution', 'symptoms', 'confidence', 'usageCount'])
192
+ : '';
193
+ const sourceProvenanceBlock = sourceProvenance
194
+ ? `<div class="modal-section-title">${isSharedSource ? 'Shared source provenance' : 'Source metadata'}</div>${sourceProvenance}`
195
+ : '';
196
+
197
+ container.innerHTML = `
198
+ <div class="disclosure-layer">
199
+ <div class="modal-section-title">Expand layer</div>
200
+ <div class="modal-content-block">${escapeHtml(expansion.expandedContext || expansion.target?.snippet || '')}</div>
201
+ <div class="modal-section-title">Surrounding context</div>
202
+ <div class="disclosure-context-list">${surrounding}</div>
203
+ <div class="modal-section-title">Related sources</div>
204
+ <div class="disclosure-reasons">${related}</div>
205
+ </div>
206
+ <div class="disclosure-layer">
207
+ <div class="modal-section-title">Source layer</div>
208
+ <div class="modal-content-block">${escapeHtml(sourcePreview)}</div>
209
+ ${sourceProvenanceBlock}
210
+ </div>`;
211
+ }
212
+
213
+ function renderDisclosureProvenance(metadata, allowedKeys = null) {
214
+ if (!metadata) return '';
215
+ const entries = Object.entries(metadata)
216
+ .filter(([key, value]) => value !== undefined && value !== null && (!allowedKeys || allowedKeys.includes(key)));
217
+ if (!entries.length) return '';
218
+ return `
219
+ <div class="disclosure-provenance">
220
+ ${entries.map(([key, value]) => `
221
+ <div class="disclosure-provenance-row">
222
+ <span class="disclosure-provenance-key">${escapeHtml(key)}</span>
223
+ <span class="disclosure-provenance-value">${escapeHtml(formatDisclosureMetadataValue(value))}</span>
224
+ </div>`).join('')}
225
+ </div>`;
226
+ }
227
+
228
+ function formatDisclosureMetadataValue(value) {
229
+ if (Array.isArray(value)) return value.join(', ');
230
+ if (value && typeof value === 'object') return JSON.stringify(value);
231
+ return String(value);
232
+ }