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,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
+ }