nlm-memory 0.4.0

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 (472) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/.github/workflows/ci.yml +30 -0
  3. package/LICENSE +151 -0
  4. package/README.md +119 -0
  5. package/dist/cli/classify-parity.d.ts +48 -0
  6. package/dist/cli/classify-parity.js +182 -0
  7. package/dist/cli/classify-parity.js.map +1 -0
  8. package/dist/cli/launchctl-helpers.d.ts +26 -0
  9. package/dist/cli/launchctl-helpers.js +42 -0
  10. package/dist/cli/launchctl-helpers.js.map +1 -0
  11. package/dist/cli/nlm.d.ts +25 -0
  12. package/dist/cli/nlm.js +832 -0
  13. package/dist/cli/nlm.js.map +1 -0
  14. package/dist/core/actions/actions-log.d.ts +40 -0
  15. package/dist/core/actions/actions-log.js +72 -0
  16. package/dist/core/actions/actions-log.js.map +1 -0
  17. package/dist/core/actions/overlay.d.ts +30 -0
  18. package/dist/core/actions/overlay.js +101 -0
  19. package/dist/core/actions/overlay.js.map +1 -0
  20. package/dist/core/adapters/aider.d.ts +33 -0
  21. package/dist/core/adapters/aider.js +167 -0
  22. package/dist/core/adapters/aider.js.map +1 -0
  23. package/dist/core/adapters/claude-code.d.ts +32 -0
  24. package/dist/core/adapters/claude-code.js +270 -0
  25. package/dist/core/adapters/claude-code.js.map +1 -0
  26. package/dist/core/adapters/common.d.ts +20 -0
  27. package/dist/core/adapters/common.js +60 -0
  28. package/dist/core/adapters/common.js.map +1 -0
  29. package/dist/core/adapters/from-source.d.ts +11 -0
  30. package/dist/core/adapters/from-source.js +55 -0
  31. package/dist/core/adapters/from-source.js.map +1 -0
  32. package/dist/core/adapters/hermes-agent.d.ts +34 -0
  33. package/dist/core/adapters/hermes-agent.js +192 -0
  34. package/dist/core/adapters/hermes-agent.js.map +1 -0
  35. package/dist/core/adapters/hermes.d.ts +31 -0
  36. package/dist/core/adapters/hermes.js +247 -0
  37. package/dist/core/adapters/hermes.js.map +1 -0
  38. package/dist/core/adapters/jsonl-generic.d.ts +56 -0
  39. package/dist/core/adapters/jsonl-generic.js +185 -0
  40. package/dist/core/adapters/jsonl-generic.js.map +1 -0
  41. package/dist/core/adapters/opencode.d.ts +36 -0
  42. package/dist/core/adapters/opencode.js +213 -0
  43. package/dist/core/adapters/opencode.js.map +1 -0
  44. package/dist/core/adapters/pi.d.ts +32 -0
  45. package/dist/core/adapters/pi.js +233 -0
  46. package/dist/core/adapters/pi.js.map +1 -0
  47. package/dist/core/classifier/prompt.d.ts +60 -0
  48. package/dist/core/classifier/prompt.js +178 -0
  49. package/dist/core/classifier/prompt.js.map +1 -0
  50. package/dist/core/dataset/build-dataset.d.ts +87 -0
  51. package/dist/core/dataset/build-dataset.js +335 -0
  52. package/dist/core/dataset/build-dataset.js.map +1 -0
  53. package/dist/core/embedding/chunk-body.d.ts +30 -0
  54. package/dist/core/embedding/chunk-body.js +60 -0
  55. package/dist/core/embedding/chunk-body.js.map +1 -0
  56. package/dist/core/embedding/embed-backfill.d.ts +36 -0
  57. package/dist/core/embedding/embed-backfill.js +168 -0
  58. package/dist/core/embedding/embed-backfill.js.map +1 -0
  59. package/dist/core/embedding/embed-normalize.d.ts +28 -0
  60. package/dist/core/embedding/embed-normalize.js +98 -0
  61. package/dist/core/embedding/embed-normalize.js.map +1 -0
  62. package/dist/core/facts/backfill-facts.d.ts +58 -0
  63. package/dist/core/facts/backfill-facts.js +169 -0
  64. package/dist/core/facts/backfill-facts.js.map +1 -0
  65. package/dist/core/facts/extract-facts.d.ts +20 -0
  66. package/dist/core/facts/extract-facts.js +37 -0
  67. package/dist/core/facts/extract-facts.js.map +1 -0
  68. package/dist/core/hook/citation-detect.d.ts +32 -0
  69. package/dist/core/hook/citation-detect.js +105 -0
  70. package/dist/core/hook/citation-detect.js.map +1 -0
  71. package/dist/core/hook/cite-memo.d.ts +20 -0
  72. package/dist/core/hook/cite-memo.js +68 -0
  73. package/dist/core/hook/cite-memo.js.map +1 -0
  74. package/dist/core/hook/claude-settings.d.ts +34 -0
  75. package/dist/core/hook/claude-settings.js +117 -0
  76. package/dist/core/hook/claude-settings.js.map +1 -0
  77. package/dist/core/hook/gate.d.ts +11 -0
  78. package/dist/core/hook/gate.js +19 -0
  79. package/dist/core/hook/gate.js.map +1 -0
  80. package/dist/core/hook/hook-log.d.ts +25 -0
  81. package/dist/core/hook/hook-log.js +28 -0
  82. package/dist/core/hook/hook-log.js.map +1 -0
  83. package/dist/core/hook/memo-sweep.d.ts +55 -0
  84. package/dist/core/hook/memo-sweep.js +134 -0
  85. package/dist/core/hook/memo-sweep.js.map +1 -0
  86. package/dist/core/hook/memo.d.ts +20 -0
  87. package/dist/core/hook/memo.js +66 -0
  88. package/dist/core/hook/memo.js.map +1 -0
  89. package/dist/core/hook/pointer-block.d.ts +14 -0
  90. package/dist/core/hook/pointer-block.js +19 -0
  91. package/dist/core/hook/pointer-block.js.map +1 -0
  92. package/dist/core/hook/select.d.ts +21 -0
  93. package/dist/core/hook/select.js +15 -0
  94. package/dist/core/hook/select.js.map +1 -0
  95. package/dist/core/hook/transcript.d.ts +31 -0
  96. package/dist/core/hook/transcript.js +103 -0
  97. package/dist/core/hook/transcript.js.map +1 -0
  98. package/dist/core/ingest/ingest-session.d.ts +40 -0
  99. package/dist/core/ingest/ingest-session.js +71 -0
  100. package/dist/core/ingest/ingest-session.js.map +1 -0
  101. package/dist/core/providers/provider-models.d.ts +24 -0
  102. package/dist/core/providers/provider-models.js +72 -0
  103. package/dist/core/providers/provider-models.js.map +1 -0
  104. package/dist/core/providers/provider-registry.d.ts +62 -0
  105. package/dist/core/providers/provider-registry.js +143 -0
  106. package/dist/core/providers/provider-registry.js.map +1 -0
  107. package/dist/core/recall/citation-log.d.ts +28 -0
  108. package/dist/core/recall/citation-log.js +90 -0
  109. package/dist/core/recall/citation-log.js.map +1 -0
  110. package/dist/core/recall/filter.d.ts +11 -0
  111. package/dist/core/recall/filter.js +20 -0
  112. package/dist/core/recall/filter.js.map +1 -0
  113. package/dist/core/recall/index.d.ts +6 -0
  114. package/dist/core/recall/index.js +5 -0
  115. package/dist/core/recall/index.js.map +1 -0
  116. package/dist/core/recall/match-fields.d.ts +10 -0
  117. package/dist/core/recall/match-fields.js +37 -0
  118. package/dist/core/recall/match-fields.js.map +1 -0
  119. package/dist/core/recall/query-log.d.ts +36 -0
  120. package/dist/core/recall/query-log.js +112 -0
  121. package/dist/core/recall/query-log.js.map +1 -0
  122. package/dist/core/recall/query-shape.d.ts +22 -0
  123. package/dist/core/recall/query-shape.js +64 -0
  124. package/dist/core/recall/query-shape.js.map +1 -0
  125. package/dist/core/recall/recall-service.d.ts +19 -0
  126. package/dist/core/recall/recall-service.js +252 -0
  127. package/dist/core/recall/recall-service.js.map +1 -0
  128. package/dist/core/recall/recent-log.d.ts +16 -0
  129. package/dist/core/recall/recent-log.js +46 -0
  130. package/dist/core/recall/recent-log.js.map +1 -0
  131. package/dist/core/recall/tokenize.d.ts +7 -0
  132. package/dist/core/recall/tokenize.js +18 -0
  133. package/dist/core/recall/tokenize.js.map +1 -0
  134. package/dist/core/recall/useful-scan.d.ts +52 -0
  135. package/dist/core/recall/useful-scan.js +300 -0
  136. package/dist/core/recall/useful-scan.js.map +1 -0
  137. package/dist/core/recall-facts/fact-query-log.d.ts +42 -0
  138. package/dist/core/recall-facts/fact-query-log.js +115 -0
  139. package/dist/core/recall-facts/fact-query-log.js.map +1 -0
  140. package/dist/core/recall-facts/fact-recall-service.d.ts +34 -0
  141. package/dist/core/recall-facts/fact-recall-service.js +246 -0
  142. package/dist/core/recall-facts/fact-recall-service.js.map +1 -0
  143. package/dist/core/scheduler/scan-once.d.ts +32 -0
  144. package/dist/core/scheduler/scan-once.js +100 -0
  145. package/dist/core/scheduler/scan-once.js.map +1 -0
  146. package/dist/core/scheduler/scheduler.d.ts +59 -0
  147. package/dist/core/scheduler/scheduler.js +158 -0
  148. package/dist/core/scheduler/scheduler.js.map +1 -0
  149. package/dist/core/sources/source-registry.d.ts +68 -0
  150. package/dist/core/sources/source-registry.js +208 -0
  151. package/dist/core/sources/source-registry.js.map +1 -0
  152. package/dist/core/storage/db-restore.d.ts +53 -0
  153. package/dist/core/storage/db-restore.js +113 -0
  154. package/dist/core/storage/db-restore.js.map +1 -0
  155. package/dist/core/storage/live-status.d.ts +15 -0
  156. package/dist/core/storage/live-status.js +43 -0
  157. package/dist/core/storage/live-status.js.map +1 -0
  158. package/dist/core/storage/migrate.d.ts +14 -0
  159. package/dist/core/storage/migrate.js +52 -0
  160. package/dist/core/storage/migrate.js.map +1 -0
  161. package/dist/core/storage/sqlite-fact-store.d.ts +50 -0
  162. package/dist/core/storage/sqlite-fact-store.js +256 -0
  163. package/dist/core/storage/sqlite-fact-store.js.map +1 -0
  164. package/dist/core/storage/sqlite-session-store.d.ts +152 -0
  165. package/dist/core/storage/sqlite-session-store.js +587 -0
  166. package/dist/core/storage/sqlite-session-store.js.map +1 -0
  167. package/dist/hook/pre-compact-hook.d.ts +26 -0
  168. package/dist/hook/pre-compact-hook.js +94 -0
  169. package/dist/hook/pre-compact-hook.js.map +1 -0
  170. package/dist/hook/prompt-recall-hook.d.ts +23 -0
  171. package/dist/hook/prompt-recall-hook.js +141 -0
  172. package/dist/hook/prompt-recall-hook.js.map +1 -0
  173. package/dist/hook/session-end-hook.d.ts +18 -0
  174. package/dist/hook/session-end-hook.js +67 -0
  175. package/dist/hook/session-end-hook.js.map +1 -0
  176. package/dist/hook/session-start-hook.d.ts +25 -0
  177. package/dist/hook/session-start-hook.js +129 -0
  178. package/dist/hook/session-start-hook.js.map +1 -0
  179. package/dist/hook/stop-hook.d.ts +38 -0
  180. package/dist/hook/stop-hook.js +171 -0
  181. package/dist/hook/stop-hook.js.map +1 -0
  182. package/dist/hook/subagent-start-hook.d.ts +30 -0
  183. package/dist/hook/subagent-start-hook.js +108 -0
  184. package/dist/hook/subagent-start-hook.js.map +1 -0
  185. package/dist/http/app.d.ts +65 -0
  186. package/dist/http/app.js +1009 -0
  187. package/dist/http/app.js.map +1 -0
  188. package/dist/install/claude-code.d.ts +57 -0
  189. package/dist/install/claude-code.js +76 -0
  190. package/dist/install/claude-code.js.map +1 -0
  191. package/dist/install/codex.d.ts +82 -0
  192. package/dist/install/codex.js +277 -0
  193. package/dist/install/codex.js.map +1 -0
  194. package/dist/install/hermes-agent.d.ts +35 -0
  195. package/dist/install/hermes-agent.js +48 -0
  196. package/dist/install/hermes-agent.js.map +1 -0
  197. package/dist/install/hermes.d.ts +29 -0
  198. package/dist/install/hermes.js +52 -0
  199. package/dist/install/hermes.js.map +1 -0
  200. package/dist/install/ollama.d.ts +54 -0
  201. package/dist/install/ollama.js +178 -0
  202. package/dist/install/ollama.js.map +1 -0
  203. package/dist/install/setup.d.ts +37 -0
  204. package/dist/install/setup.js +339 -0
  205. package/dist/install/setup.js.map +1 -0
  206. package/dist/llm/classifier-box.d.ts +29 -0
  207. package/dist/llm/classifier-box.js +43 -0
  208. package/dist/llm/classifier-box.js.map +1 -0
  209. package/dist/llm/deepseek-client.d.ts +40 -0
  210. package/dist/llm/deepseek-client.js +114 -0
  211. package/dist/llm/deepseek-client.js.map +1 -0
  212. package/dist/llm/env-autoload.d.ts +8 -0
  213. package/dist/llm/env-autoload.js +54 -0
  214. package/dist/llm/env-autoload.js.map +1 -0
  215. package/dist/llm/ollama-client.d.ts +47 -0
  216. package/dist/llm/ollama-client.js +156 -0
  217. package/dist/llm/ollama-client.js.map +1 -0
  218. package/dist/mcp/server.d.ts +64 -0
  219. package/dist/mcp/server.js +430 -0
  220. package/dist/mcp/server.js.map +1 -0
  221. package/dist/ports/fact-store.d.ts +82 -0
  222. package/dist/ports/fact-store.js +16 -0
  223. package/dist/ports/fact-store.js.map +1 -0
  224. package/dist/ports/llm-client.d.ts +42 -0
  225. package/dist/ports/llm-client.js +14 -0
  226. package/dist/ports/llm-client.js.map +1 -0
  227. package/dist/ports/logger.d.ts +13 -0
  228. package/dist/ports/logger.js +8 -0
  229. package/dist/ports/logger.js.map +1 -0
  230. package/dist/ports/session-store.d.ts +29 -0
  231. package/dist/ports/session-store.js +9 -0
  232. package/dist/ports/session-store.js.map +1 -0
  233. package/dist/ports/transcript-adapter.d.ts +48 -0
  234. package/dist/ports/transcript-adapter.js +15 -0
  235. package/dist/ports/transcript-adapter.js.map +1 -0
  236. package/dist/shared/types.d.ts +129 -0
  237. package/dist/shared/types.js +6 -0
  238. package/dist/shared/types.js.map +1 -0
  239. package/dist/ui/assets/index-BA6IpU8g.css +1 -0
  240. package/dist/ui/assets/index-B_qIVV0k.js +69 -0
  241. package/dist/ui/index.html +13 -0
  242. package/docs/methodology/re-derivation-rate.md +112 -0
  243. package/docs/methodology/useful-hit-rate.md +79 -0
  244. package/docs/plans/2026-05-20-fts5-lexical-recall.md +1088 -0
  245. package/docs/plans/2026-05-20-recall-daemon-wedge-fix.md +662 -0
  246. package/docs/plans/2026-05-20-recall-hook-design.md +131 -0
  247. package/docs/plans/2026-05-20-recall-hook-implementation.md +1222 -0
  248. package/docs/plans/desktop-product.md +69 -0
  249. package/docs/plans/factstore-design.md +236 -0
  250. package/logs/CHANGELOG/CHANGELOG-2026.md +1389 -0
  251. package/logs/CHANGELOG/CHANGELOG.md +320 -0
  252. package/migrations/000_initial_schema.sql +174 -0
  253. package/migrations/001_entity_type_rename.sql +17 -0
  254. package/migrations/002_adapter_state_extend.sql +12 -0
  255. package/migrations/003_session_embeddings.sql +11 -0
  256. package/migrations/004_facts.sql +46 -0
  257. package/migrations/005_sources.sql +31 -0
  258. package/migrations/006_providers.sql +33 -0
  259. package/migrations/007_source_tokens.sql +17 -0
  260. package/migrations/008_fts_rebuild.sql +9 -0
  261. package/migrations/009_session_embedding_chunks.sql +46 -0
  262. package/migrations/010_sources_opencode.sql +30 -0
  263. package/migrations/011_sources_hermes_agent.sql +30 -0
  264. package/migrations/012_sources_aider.sql +30 -0
  265. package/migrations/013_adapter_state_failure_count.sql +12 -0
  266. package/package.json +56 -0
  267. package/plugin/.codex-plugin/plugin.json +22 -0
  268. package/plugin/.mcp.json +8 -0
  269. package/plugin/README.md +51 -0
  270. package/plugin/hooks/hooks.json +25 -0
  271. package/plugin/scripts/prompt-recall-hook.mjs +202 -0
  272. package/plugin/scripts/stop-hook.mjs +306 -0
  273. package/plugin-hermes-agent/README.md +49 -0
  274. package/plugin-hermes-agent/__init__.py +75 -0
  275. package/plugin-hermes-agent/plugin.yaml +15 -0
  276. package/scripts/backfill-citations.mjs +0 -0
  277. package/scripts/build-codex-plugin.mjs +61 -0
  278. package/scripts/deepseek-probe.mjs +67 -0
  279. package/scripts/extract-triples.mjs +207 -0
  280. package/scripts/longmemeval/embedding-cache.ts +77 -0
  281. package/scripts/longmemeval/fetch-dataset.sh +25 -0
  282. package/scripts/longmemeval/run-harness.ts +315 -0
  283. package/scripts/longmemeval/scorer.ts +99 -0
  284. package/scripts/longmemeval/tsconfig.json +9 -0
  285. package/scripts/longmemeval/types.ts +35 -0
  286. package/scripts/nlm-daily-digest.py +239 -0
  287. package/scripts/nlm-daily-digest.sh +28 -0
  288. package/src/cli/classify-parity.ts +257 -0
  289. package/src/cli/launchctl-helpers.ts +49 -0
  290. package/src/cli/nlm.ts +885 -0
  291. package/src/core/actions/actions-log.ts +118 -0
  292. package/src/core/actions/overlay.ts +117 -0
  293. package/src/core/adapters/aider.ts +205 -0
  294. package/src/core/adapters/claude-code.ts +293 -0
  295. package/src/core/adapters/common.ts +54 -0
  296. package/src/core/adapters/from-source.ts +57 -0
  297. package/src/core/adapters/hermes-agent.ts +240 -0
  298. package/src/core/adapters/hermes.ts +277 -0
  299. package/src/core/adapters/jsonl-generic.ts +208 -0
  300. package/src/core/adapters/opencode.ts +281 -0
  301. package/src/core/adapters/pi.ts +264 -0
  302. package/src/core/classifier/prompt.ts +200 -0
  303. package/src/core/dataset/build-dataset.ts +463 -0
  304. package/src/core/embedding/chunk-body.ts +76 -0
  305. package/src/core/embedding/embed-backfill.ts +210 -0
  306. package/src/core/embedding/embed-normalize.ts +135 -0
  307. package/src/core/facts/backfill-facts.ts +254 -0
  308. package/src/core/facts/extract-facts.ts +50 -0
  309. package/src/core/hook/citation-detect.ts +124 -0
  310. package/src/core/hook/cite-memo.ts +68 -0
  311. package/src/core/hook/claude-settings.ts +166 -0
  312. package/src/core/hook/gate.ts +25 -0
  313. package/src/core/hook/hook-log.ts +41 -0
  314. package/src/core/hook/memo-sweep.ts +164 -0
  315. package/src/core/hook/memo.ts +67 -0
  316. package/src/core/hook/pointer-block.ts +26 -0
  317. package/src/core/hook/select.ts +32 -0
  318. package/src/core/hook/transcript.ts +121 -0
  319. package/src/core/ingest/ingest-session.ts +111 -0
  320. package/src/core/providers/provider-models.ts +100 -0
  321. package/src/core/providers/provider-registry.ts +196 -0
  322. package/src/core/recall/citation-log.ts +108 -0
  323. package/src/core/recall/filter.ts +27 -0
  324. package/src/core/recall/index.ts +6 -0
  325. package/src/core/recall/match-fields.ts +40 -0
  326. package/src/core/recall/query-log.ts +149 -0
  327. package/src/core/recall/query-shape.ts +66 -0
  328. package/src/core/recall/recall-service.ts +320 -0
  329. package/src/core/recall/recent-log.ts +59 -0
  330. package/src/core/recall/tokenize.ts +18 -0
  331. package/src/core/recall/useful-scan.ts +336 -0
  332. package/src/core/recall-facts/fact-query-log.ts +150 -0
  333. package/src/core/recall-facts/fact-recall-service.ts +327 -0
  334. package/src/core/scheduler/scan-once.ts +142 -0
  335. package/src/core/scheduler/scheduler.ts +225 -0
  336. package/src/core/sources/source-registry.ts +260 -0
  337. package/src/core/storage/db-restore.ts +133 -0
  338. package/src/core/storage/live-status.ts +45 -0
  339. package/src/core/storage/migrate.ts +72 -0
  340. package/src/core/storage/sqlite-fact-store.ts +304 -0
  341. package/src/core/storage/sqlite-session-store.ts +765 -0
  342. package/src/hook/prompt-recall-hook.ts +174 -0
  343. package/src/hook/session-end-hook.ts +81 -0
  344. package/src/hook/session-start-hook.ts +165 -0
  345. package/src/hook/stop-hook.ts +236 -0
  346. package/src/http/app.ts +1114 -0
  347. package/src/install/claude-code.ts +128 -0
  348. package/src/install/codex.ts +367 -0
  349. package/src/install/hermes-agent.ts +76 -0
  350. package/src/install/hermes.ts +78 -0
  351. package/src/install/ollama.ts +208 -0
  352. package/src/install/setup.ts +368 -0
  353. package/src/llm/classifier-box.ts +64 -0
  354. package/src/llm/deepseek-client.ts +150 -0
  355. package/src/llm/env-autoload.ts +55 -0
  356. package/src/llm/ollama-client.ts +189 -0
  357. package/src/mcp/server.ts +534 -0
  358. package/src/ports/fact-store.ts +102 -0
  359. package/src/ports/llm-client.ts +52 -0
  360. package/src/ports/logger.ts +16 -0
  361. package/src/ports/session-store.ts +45 -0
  362. package/src/ports/transcript-adapter.ts +55 -0
  363. package/src/shared/types.ts +145 -0
  364. package/src/ui/App.tsx +58 -0
  365. package/src/ui/components/PromoteOpenButton.tsx +65 -0
  366. package/src/ui/components/SessionDrawer.tsx +136 -0
  367. package/src/ui/components/SideNav.tsx +162 -0
  368. package/src/ui/components/Skeleton.tsx +107 -0
  369. package/src/ui/index.html +13 -0
  370. package/src/ui/lib/actions.ts +30 -0
  371. package/src/ui/lib/api.ts +92 -0
  372. package/src/ui/lib/dataset.ts +141 -0
  373. package/src/ui/lib/registries.ts +155 -0
  374. package/src/ui/lib/view-settings.ts +41 -0
  375. package/src/ui/main.tsx +15 -0
  376. package/src/ui/pages/Live.tsx +229 -0
  377. package/src/ui/pages/Pulse.tsx +415 -0
  378. package/src/ui/pages/Recall.tsx +190 -0
  379. package/src/ui/pages/River.tsx +308 -0
  380. package/src/ui/pages/Search.tsx +93 -0
  381. package/src/ui/pages/Stub.tsx +9 -0
  382. package/src/ui/pages/Thread.tsx +262 -0
  383. package/src/ui/pages/settings/Classifier.tsx +227 -0
  384. package/src/ui/pages/settings/Data.tsx +190 -0
  385. package/src/ui/pages/settings/Index.tsx +65 -0
  386. package/src/ui/pages/settings/Labels.tsx +224 -0
  387. package/src/ui/pages/settings/Providers.tsx +305 -0
  388. package/src/ui/pages/settings/SettingsSubnav.tsx +28 -0
  389. package/src/ui/pages/settings/Sources.tsx +326 -0
  390. package/src/ui/pages/settings/Views.tsx +96 -0
  391. package/src/ui/styles.css +1766 -0
  392. package/src/ui/tsconfig.json +21 -0
  393. package/src/ui/vite.config.ts +19 -0
  394. package/tests/fixtures/claude_code/short_session.jsonl +2 -0
  395. package/tests/fixtures/claude_code/standard_iso.jsonl +4 -0
  396. package/tests/fixtures/claude_code/tool_heavy.jsonl +8 -0
  397. package/tests/fixtures/claude_code/with_subagent.jsonl +7 -0
  398. package/tests/fixtures/facts.ts +17 -0
  399. package/tests/fixtures/golden-corpus.ts +85 -0
  400. package/tests/fixtures/hermes/paired_request_dump.json +24 -0
  401. package/tests/fixtures/hermes/paired_session.json +23 -0
  402. package/tests/fixtures/hermes/request_dump.json +28 -0
  403. package/tests/fixtures/hermes/session_iso.json +38 -0
  404. package/tests/fixtures/hermes/session_unix.json +38 -0
  405. package/tests/fixtures/hermes/system_only.json +18 -0
  406. package/tests/fixtures/pi/error-connection-abort.jsonl +8 -0
  407. package/tests/fixtures/pi/short-successful.jsonl +5 -0
  408. package/tests/fixtures/pi/with-custom-message.jsonl +6 -0
  409. package/tests/fixtures/sessions.ts +22 -0
  410. package/tests/integration/backfill-facts.test.ts +362 -0
  411. package/tests/integration/citation-explicit.test.ts +111 -0
  412. package/tests/integration/cite-event.test.ts +169 -0
  413. package/tests/integration/cite-memo.test.ts +87 -0
  414. package/tests/integration/db-restore.test.ts +153 -0
  415. package/tests/integration/embed-backfill.test.ts +176 -0
  416. package/tests/integration/fact-supersedence.test.ts +313 -0
  417. package/tests/integration/fts-index.test.ts +60 -0
  418. package/tests/integration/getbyids-sqlite.test.ts +60 -0
  419. package/tests/integration/hermes-agent-hooks.test.ts +248 -0
  420. package/tests/integration/hook-claude-settings.test.ts +205 -0
  421. package/tests/integration/hook-log.test.ts +54 -0
  422. package/tests/integration/hook-memo.test.ts +68 -0
  423. package/tests/integration/hook-pre-compact.test.ts +105 -0
  424. package/tests/integration/hook-subagent-start.test.ts +102 -0
  425. package/tests/integration/http.test.ts +401 -0
  426. package/tests/integration/keyword-search-fts.test.ts +66 -0
  427. package/tests/integration/mcp-recall-logging.test.ts +88 -0
  428. package/tests/integration/mcp.test.ts +248 -0
  429. package/tests/integration/memo-sweep.test.ts +91 -0
  430. package/tests/integration/prompt-recall-hook.test.ts +88 -0
  431. package/tests/integration/provider-registry.test.ts +107 -0
  432. package/tests/integration/recall-golden.test.ts +59 -0
  433. package/tests/integration/recall-sqlite.test.ts +169 -0
  434. package/tests/integration/scheduler.test.ts +391 -0
  435. package/tests/integration/session-end-hook.test.ts +48 -0
  436. package/tests/integration/session-start-hook.test.ts +126 -0
  437. package/tests/integration/source-registry.test.ts +120 -0
  438. package/tests/integration/sqlite-fact-store.test.ts +346 -0
  439. package/tests/integration/stop-hook.test.ts +560 -0
  440. package/tests/integration/wal-checkpoint.test.ts +49 -0
  441. package/tests/unit/cli/launchctl-helpers.test.ts +60 -0
  442. package/tests/unit/core/adapters/aider.test.ts +230 -0
  443. package/tests/unit/core/adapters/claude-code.test.ts +118 -0
  444. package/tests/unit/core/adapters/hermes-agent.test.ts +329 -0
  445. package/tests/unit/core/adapters/hermes.test.ts +81 -0
  446. package/tests/unit/core/adapters/jsonl-generic.test.ts +142 -0
  447. package/tests/unit/core/adapters/opencode.test.ts +354 -0
  448. package/tests/unit/core/adapters/pi.test.ts +110 -0
  449. package/tests/unit/core/classifier/prompt.test.ts +126 -0
  450. package/tests/unit/core/embedding/chunk-body.test.ts +100 -0
  451. package/tests/unit/core/facts/extract-facts.test.ts +117 -0
  452. package/tests/unit/core/filter.test.ts +40 -0
  453. package/tests/unit/core/hook/citation-detect-cite-session.test.ts +96 -0
  454. package/tests/unit/core/hook/citation-detect.test.ts +124 -0
  455. package/tests/unit/core/hook/gate.test.ts +29 -0
  456. package/tests/unit/core/hook/pointer-block.test.ts +22 -0
  457. package/tests/unit/core/hook/select.test.ts +66 -0
  458. package/tests/unit/core/match-fields.test.ts +39 -0
  459. package/tests/unit/core/mcp-cite-session.test.ts +51 -0
  460. package/tests/unit/core/providers/provider-models.test.ts +101 -0
  461. package/tests/unit/core/query-shape.test.ts +92 -0
  462. package/tests/unit/core/recall-facts/fact-recall-service.test.ts +258 -0
  463. package/tests/unit/core/recall-service.test.ts +200 -0
  464. package/tests/unit/core/storage/live-status.test.ts +54 -0
  465. package/tests/unit/core/tokenize.test.ts +32 -0
  466. package/tests/unit/core/useful-scan.test.ts +537 -0
  467. package/tests/unit/llm/embed.test.ts +93 -0
  468. package/tests/unit/llm/ollama-client.test.ts +124 -0
  469. package/tests/unit/scripts/longmemeval-scorer.test.ts +114 -0
  470. package/tsconfig.json +31 -0
  471. package/tsconfig.test.json +11 -0
  472. package/vitest.config.ts +22 -0
@@ -0,0 +1,229 @@
1
+ import { useEffect, useRef, useState } from "react";
2
+ import { usePolledEndpoint, relativeTime } from "../lib/api.js";
3
+ import type { PolledResult, RecentMarker, RecentRead, RecentWrite } from "../lib/api.js";
4
+ import { SessionDrawer } from "../components/SessionDrawer.js";
5
+
6
+ const POLL_MS = 3000;
7
+ /** Past this many ms with no successful fetch, the board is treated as stale. */
8
+ const STALE_MS = POLL_MS * 3;
9
+
10
+ interface ReadsResponse { entries: RecentRead[] }
11
+ interface WritesResponse { writes: RecentWrite[] }
12
+ interface MarkersResponse { markers: RecentMarker[] }
13
+
14
+ /**
15
+ * Tracks which row keys are newly arrived so they can flash once. The first
16
+ * populated render seeds the seen-set silently — only genuinely new rows
17
+ * after that are reported fresh, for ~1.2s each.
18
+ */
19
+ function useFreshKeys(keys: string[]): Set<string> {
20
+ const seen = useRef<Set<string> | null>(null);
21
+ const [fresh, setFresh] = useState<Set<string>>(new Set());
22
+ const signature = keys.join("|");
23
+
24
+ useEffect(() => {
25
+ if (keys.length === 0) return;
26
+ if (seen.current === null) {
27
+ seen.current = new Set(keys);
28
+ return;
29
+ }
30
+ const added = keys.filter((k) => !seen.current!.has(k));
31
+ for (const k of keys) seen.current!.add(k);
32
+ if (added.length === 0) return;
33
+ setFresh((prev) => new Set([...prev, ...added]));
34
+ const t = setTimeout(() => {
35
+ setFresh((prev) => {
36
+ const next = new Set(prev);
37
+ for (const k of added) next.delete(k);
38
+ return next;
39
+ });
40
+ }, 1200);
41
+ return () => clearTimeout(t);
42
+ // signature captures the ordered key list; keys identity is unstable.
43
+ }, [signature]); // eslint-disable-line react-hooks/exhaustive-deps
44
+
45
+ return fresh;
46
+ }
47
+
48
+ export function LivePage() {
49
+ const reads = usePolledEndpoint<ReadsResponse>("/api/recall/recent?limit=50", POLL_MS, { entries: [] });
50
+ const writes = usePolledEndpoint<WritesResponse>("/api/live/recent-writes?limit=50", POLL_MS, { writes: [] });
51
+ const markers = usePolledEndpoint<MarkersResponse>("/api/live/recent-markers?limit=50", POLL_MS, { markers: [] });
52
+
53
+ const [sessionId, setSessionId] = useState<string | null>(null);
54
+
55
+ const readKeys = reads.data.entries.map((r) => `${r.ts}|${r.source}|${r.query ?? ""}`);
56
+ const writeKeys = writes.data.writes.map((w) => w.id);
57
+ const markerKeys = markers.data.markers.map((m) => `${m.sessionId}|${m.kind}|${m.text}`);
58
+ const freshReads = useFreshKeys(readKeys);
59
+ const freshWrites = useFreshKeys(writeKeys);
60
+ const freshMarkers = useFreshKeys(markerKeys);
61
+
62
+ return (
63
+ <div className="live-page">
64
+ <ConnectionBar reads={reads} writes={writes} markers={markers} />
65
+
66
+ <div className="live-board">
67
+ <Column
68
+ title="Reads"
69
+ count={reads.data.entries.length}
70
+ loading={reads.loading}
71
+ emptyLabel="no recent recall"
72
+ >
73
+ {reads.data.entries.map((r, i) => {
74
+ const key = readKeys[i]!;
75
+ return (
76
+ <div className={`live-row${freshReads.has(key) ? " is-new" : ""}`} key={key}>
77
+ <span className="live-tag">{r.source}</span>
78
+ <span className="label">{r.query ?? "(no query)"}</span>
79
+ <div className="body">{r.mode} · {r.nResults} hit{r.nResults === 1 ? "" : "s"}</div>
80
+ <div className="meta">{relativeTime(r.ts)}</div>
81
+ </div>
82
+ );
83
+ })}
84
+ </Column>
85
+
86
+ <Column
87
+ title="Writes"
88
+ count={writes.data.writes.length}
89
+ loading={writes.loading}
90
+ emptyLabel="no recent writes"
91
+ >
92
+ {writes.data.writes.map((w) => (
93
+ <Row
94
+ key={w.id}
95
+ fresh={freshWrites.has(w.id)}
96
+ onOpen={() => setSessionId(w.id)}
97
+ >
98
+ <span className="live-tag">{w.runtime.split("/")[0]}</span>
99
+ <span className="label">{w.label}</span>
100
+ <div className="body">{w.summary}</div>
101
+ <div className="meta">{relativeTime(w.createdAt)} · {w.id}</div>
102
+ </Row>
103
+ ))}
104
+ </Column>
105
+
106
+ <Column
107
+ title="Markers"
108
+ count={markers.data.markers.length}
109
+ loading={markers.loading}
110
+ emptyLabel="no recent markers"
111
+ >
112
+ {markers.data.markers.map((m, i) => {
113
+ const key = markerKeys[i]!;
114
+ return (
115
+ <Row
116
+ key={key}
117
+ fresh={freshMarkers.has(key)}
118
+ onOpen={() => setSessionId(m.sessionId)}
119
+ >
120
+ <span className="live-tag" data-kind={m.kind}>{m.kind}</span>
121
+ <span className="label">{m.text}</span>
122
+ <div className="body">{m.label}</div>
123
+ <div className="meta">{relativeTime(m.createdAt)}</div>
124
+ </Row>
125
+ );
126
+ })}
127
+ </Column>
128
+ </div>
129
+
130
+ {sessionId && (
131
+ <SessionDrawer sessionId={sessionId} onClose={() => setSessionId(null)} />
132
+ )}
133
+ </div>
134
+ );
135
+ }
136
+
137
+ function ConnectionBar({
138
+ reads,
139
+ writes,
140
+ markers,
141
+ }: {
142
+ reads: PolledResult<unknown>;
143
+ writes: PolledResult<unknown>;
144
+ markers: PolledResult<unknown>;
145
+ }) {
146
+ const all = [reads, writes, markers];
147
+ const loading = all.every((p) => p.loading);
148
+ const stamps = all.map((p) => p.lastUpdated).filter((t): t is number => t !== null);
149
+ const freshest = stamps.length > 0 ? Math.max(...stamps) : null;
150
+ const anyError = all.some((p) => p.error !== null);
151
+ const stale = freshest !== null && Date.now() - freshest > STALE_MS;
152
+
153
+ let status: "connecting" | "live" | "reconnecting";
154
+ if (loading) status = "connecting";
155
+ else if (stale || anyError) status = "reconnecting";
156
+ else status = "live";
157
+
158
+ const label =
159
+ status === "connecting" ? "Connecting…"
160
+ : status === "reconnecting" ? "Reconnecting…"
161
+ : "Live";
162
+
163
+ return (
164
+ <div className="live-status">
165
+ <span className={`live-status-dot live-status-${status}`} aria-hidden="true" />
166
+ <span className="live-status-label">{label}</span>
167
+ {freshest !== null && (
168
+ <span className="muted small">
169
+ updated {relativeTime(new Date(freshest).toISOString())}
170
+ </span>
171
+ )}
172
+ <span className="header-spacer" />
173
+ <span className="muted small mono">polling every {POLL_MS / 1000}s</span>
174
+ </div>
175
+ );
176
+ }
177
+
178
+ function Column({
179
+ title,
180
+ count,
181
+ loading,
182
+ emptyLabel,
183
+ children,
184
+ }: {
185
+ title: string;
186
+ count: number;
187
+ loading: boolean;
188
+ emptyLabel: string;
189
+ children: React.ReactNode;
190
+ }) {
191
+ const isEmpty = count === 0;
192
+ return (
193
+ <section className="live-col">
194
+ <header className="live-col-head">
195
+ <span className="live-col-title">{title}</span>
196
+ <span className="live-col-count">{count}</span>
197
+ </header>
198
+ <div className="live-col-body">
199
+ {isEmpty
200
+ ? <div className="live-empty">{loading ? "loading…" : emptyLabel}</div>
201
+ : children}
202
+ </div>
203
+ </section>
204
+ );
205
+ }
206
+
207
+ function Row({
208
+ fresh,
209
+ onOpen,
210
+ children,
211
+ }: {
212
+ fresh: boolean;
213
+ onOpen: () => void;
214
+ children: React.ReactNode;
215
+ }) {
216
+ return (
217
+ <div
218
+ className={`live-row clickable${fresh ? " is-new" : ""}`}
219
+ onClick={onOpen}
220
+ role="button"
221
+ tabIndex={0}
222
+ onKeyDown={(e) => {
223
+ if (e.key === "Enter" || e.key === " ") { e.preventDefault(); onOpen(); }
224
+ }}
225
+ >
226
+ {children}
227
+ </div>
228
+ );
229
+ }
@@ -0,0 +1,415 @@
1
+ import { useEffect, useMemo, useState } from "react";
2
+ import { Link, useNavigate } from "react-router-dom";
3
+ import { useDataset, relativeAge } from "../lib/dataset.js";
4
+ import type { DatasetAlert, DatasetEntity, DatasetRuntime, DatasetSession } from "../lib/dataset.js";
5
+ import { postAction } from "../lib/actions.js";
6
+ import { SessionDrawer } from "../components/SessionDrawer.js";
7
+ import { PromoteOpenButton } from "../components/PromoteOpenButton.js";
8
+ import { PulseSkeleton } from "../components/Skeleton.js";
9
+
10
+ type SeverityFilter = "all" | "high" | "medium";
11
+ type AlertSort = "oldest" | "recent";
12
+
13
+ export function PulsePage() {
14
+ const { data, loading, error, refetch } = useDataset();
15
+ const [severity, setSeverity] = useState<SeverityFilter>("all");
16
+ const [sort, setSort] = useState<AlertSort>("oldest");
17
+ const [detailId, setDetailId] = useState<string | null>(null);
18
+ const [sessionId, setSessionId] = useState<string | null>(null);
19
+
20
+ const filteredAlerts = useMemo(() => {
21
+ if (!data) return [];
22
+ const filtered = severity === "all" ? data.alerts : data.alerts.filter((a) => a.severity === severity);
23
+ return [...filtered].sort((a, b) => (sort === "oldest" ? b.age_days - a.age_days : a.age_days - b.age_days));
24
+ }, [data, severity, sort]);
25
+
26
+ const dismissAlert = async (alertId: string) => {
27
+ await postAction({ kind: "dismiss", subject_type: "alert", subject_id: alertId });
28
+ await refetch();
29
+ };
30
+ const snoozeAlert = async (alertId: string, days: number) => {
31
+ const until = new Date(Date.now() + days * 86_400_000).toISOString();
32
+ await postAction({
33
+ kind: "snooze",
34
+ subject_type: "alert",
35
+ subject_id: alertId,
36
+ payload: { snoozed_until: until },
37
+ });
38
+ await refetch();
39
+ };
40
+
41
+ const recent = useMemo(() => {
42
+ if (!data) return [];
43
+ return [...data.sessions]
44
+ .sort((a, b) => (b.started_at ?? "").localeCompare(a.started_at ?? ""))
45
+ .slice(0, 20);
46
+ }, [data]);
47
+
48
+ if (loading && !data) return <PulseSkeleton />;
49
+ if (error && !data) return <div className="page-pad"><div className="muted error">{error}</div></div>;
50
+ if (!data) return null;
51
+
52
+ const detailAlert = detailId ? data.alerts.find((a) => a.id === detailId) ?? null : null;
53
+
54
+ return (
55
+ <div className="page-pad">
56
+ <div className="kpi-row">
57
+ <Kpi label="This week" value={data.metrics.this_week} hint={`${data.metrics.last_week} last week`} />
58
+ <Kpi label="Sessions" value={data.meta.sessions_total} hint="total" />
59
+ <Kpi label="Entities" value={data.meta.entities_total} hint="catalogued" />
60
+ <Kpi label="Decisions" value={data.metrics.closed_decisions} hint="non-superseded" />
61
+ <KpiSparkline values={data.metrics.sparkline} />
62
+ </div>
63
+
64
+ <div className="pulse-grid">
65
+ <section className="card pulse-area-coherence">
66
+ <header className="card-head"><h3>Coherence</h3></header>
67
+ <CoherenceBars metrics={data.metrics} />
68
+ </section>
69
+
70
+ <section className="card pulse-area-runtimes">
71
+ <header className="card-head"><h3>Runtimes</h3></header>
72
+ <RuntimesPanel runtimes={data.runtimes} />
73
+ </section>
74
+
75
+ <section className="card pulse-scroll-card pulse-area-recent">
76
+ <header className="card-head"><h3>Recent sessions</h3></header>
77
+ <div className="pulse-scroll-body">
78
+ <ul className="session-list">
79
+ {recent.map((s) => (
80
+ <li
81
+ key={s.id}
82
+ className="session-row clickable"
83
+ onClick={() => setSessionId(s.id)}
84
+ role="button"
85
+ tabIndex={0}
86
+ onKeyDown={(e) => { if (e.key === "Enter" || e.key === " ") { e.preventDefault(); setSessionId(s.id); } }}
87
+ >
88
+ <span className={`chip-inline status-${s.status}`}>{s.status}</span>
89
+ <span className="session-label">{s.label}</span>
90
+ <span className="session-meta">{relativeAge(s.started_at)} · {s.entities.slice(0, 3).join(", ")}{s.entities.length > 3 ? ` +${s.entities.length - 3}` : ""}</span>
91
+ </li>
92
+ ))}
93
+ </ul>
94
+ </div>
95
+ </section>
96
+
97
+ <section className="card pulse-scroll-card pulse-area-stale">
98
+ <header className="card-head card-head-stack">
99
+ <div className="card-head-row">
100
+ <h3>Stale alerts</h3>
101
+ <span className="muted small">
102
+ {filteredAlerts.length}{filteredAlerts.length !== data.alerts.length ? ` / ${data.alerts.length}` : ""}
103
+ </span>
104
+ </div>
105
+ <div className="card-filters">
106
+ <div className="filter-group" role="group" aria-label="Severity">
107
+ {(["all", "high", "medium"] as const).map((s) => (
108
+ <button
109
+ key={s}
110
+ type="button"
111
+ className={`chip${severity === s ? " active" : ""}`}
112
+ data-severity={s === "all" ? undefined : s}
113
+ onClick={() => setSeverity(s)}
114
+ >{s}</button>
115
+ ))}
116
+ </div>
117
+ <div className="filter-group" role="group" aria-label="Sort">
118
+ <button type="button" className={`chip${sort === "oldest" ? " active" : ""}`} onClick={() => setSort("oldest")}>oldest</button>
119
+ <button type="button" className={`chip${sort === "recent" ? " active" : ""}`} onClick={() => setSort("recent")}>recent</button>
120
+ </div>
121
+ </div>
122
+ </header>
123
+ <div className="pulse-scroll-body">
124
+ <ul className="alert-list">
125
+ {filteredAlerts.map((a) => (
126
+ <li
127
+ key={a.id}
128
+ className="alert-row clickable"
129
+ onClick={() => setDetailId(a.id)}
130
+ role="button"
131
+ tabIndex={0}
132
+ onKeyDown={(e) => { if (e.key === "Enter" || e.key === " ") { e.preventDefault(); setDetailId(a.id); } }}
133
+ >
134
+ <span className={`chip-inline severity-${a.severity}`}>{a.severity}</span>
135
+ <span className="alert-entity">{a.entity}</span>
136
+ <span className="alert-summary">{a.summary}</span>
137
+ <div className="alert-actions" onClick={(e) => e.stopPropagation()}>
138
+ <button type="button" className="chip" onClick={() => void snoozeAlert(a.id, 7)}>snooze 7d</button>
139
+ <button type="button" className="chip" onClick={() => void dismissAlert(a.id)}>dismiss</button>
140
+ </div>
141
+ </li>
142
+ ))}
143
+ {filteredAlerts.length === 0 && (
144
+ <li className="muted alert-row-empty">
145
+ {data.alerts.length === 0 ? "No stale alerts." : "No alerts match the current filters."}
146
+ </li>
147
+ )}
148
+ </ul>
149
+ </div>
150
+ </section>
151
+ </div>
152
+
153
+ {detailAlert && (
154
+ <AlertDrawer
155
+ alert={detailAlert}
156
+ entity={data.entities.find((e) => e.canonical === detailAlert.entity) ?? null}
157
+ entityColor={data.entity_colors[detailAlert.entity] ?? "#666"}
158
+ sessions={data.sessions}
159
+ onClose={() => setDetailId(null)}
160
+ onDismiss={async () => { await dismissAlert(detailAlert.id); setDetailId(null); }}
161
+ onSnooze={async (days) => { await snoozeAlert(detailAlert.id, days); setDetailId(null); }}
162
+ onPromoted={refetch}
163
+ />
164
+ )}
165
+
166
+ {sessionId && (
167
+ <SessionDrawer
168
+ sessionId={sessionId}
169
+ onClose={() => setSessionId(null)}
170
+ entityColor={(() => {
171
+ const s = data.sessions.find((x) => x.id === sessionId);
172
+ const e = s?.entities[0];
173
+ return e ? data.entity_colors[e] : undefined;
174
+ })()}
175
+ />
176
+ )}
177
+ </div>
178
+ );
179
+ }
180
+
181
+ interface AlertDrawerProps {
182
+ alert: DatasetAlert;
183
+ entity: DatasetEntity | null;
184
+ entityColor: string;
185
+ sessions: DatasetSession[];
186
+ onClose: () => void;
187
+ onDismiss: () => Promise<void> | void;
188
+ onSnooze: (days: number) => Promise<void> | void;
189
+ onPromoted: () => Promise<void> | void;
190
+ }
191
+
192
+ const DRAWER_PAGE_SIZES = [10, 25, 50] as const;
193
+
194
+ function AlertDrawer({ alert, entity, entityColor, sessions, onClose, onDismiss, onSnooze, onPromoted }: AlertDrawerProps) {
195
+ const navigate = useNavigate();
196
+ const [pageSize, setPageSize] = useState<number>(10);
197
+ const [page, setPage] = useState(0);
198
+
199
+ const related = useMemo(() => {
200
+ return sessions
201
+ .filter((s) => s.entities.includes(alert.entity))
202
+ .sort((a, b) => (b.started_at ?? "").localeCompare(a.started_at ?? ""));
203
+ }, [sessions, alert.entity]);
204
+
205
+ // Reset page when alert changes (drawer opened for a different entity) or page size changes.
206
+ useEffect(() => { setPage(0); }, [alert.id, pageSize]);
207
+
208
+ const pageCount = Math.max(1, Math.ceil(related.length / pageSize));
209
+ const currentPage = Math.min(page, pageCount - 1);
210
+ const start = currentPage * pageSize;
211
+ const sessionSlice = related.slice(start, start + pageSize);
212
+
213
+ const openQuestions = useMemo(
214
+ () => related.flatMap((s) => s.open_questions.map((q) => ({ id: q.id, text: q.text, sid: s.id, when: s.started_at }))),
215
+ [related],
216
+ );
217
+
218
+ const decisions = useMemo(
219
+ () => related.flatMap((s) => s.decisions.map((d) => ({ text: d, sid: s.id, when: s.started_at }))),
220
+ [related],
221
+ );
222
+
223
+ useEffect(() => {
224
+ const onEsc = (e: KeyboardEvent) => { if (e.key === "Escape") onClose(); };
225
+ window.addEventListener("keydown", onEsc);
226
+ return () => window.removeEventListener("keydown", onEsc);
227
+ }, [onClose]);
228
+
229
+ return (
230
+ <>
231
+ <div className="drawer-backdrop" onClick={onClose} />
232
+ <aside className="session-drawer" role="dialog" aria-modal="true" aria-label={`Alert detail: ${alert.entity}`}>
233
+ <header className="drawer-head">
234
+ <span className="dot lg" style={{ background: entityColor }} />
235
+ <h3 className="drawer-title">{alert.entity}</h3>
236
+ <span className={`chip-inline severity-${alert.severity}`}>{alert.severity}</span>
237
+ <button type="button" className="drawer-close" onClick={onClose} aria-label="Close">×</button>
238
+ </header>
239
+ <div className="drawer-body">
240
+ <p className="drawer-paragraph">{alert.summary}</p>
241
+
242
+ <dl className="kv-list">
243
+ <dt className="kv-label">Last touch</dt>
244
+ <dd className="kv-value">{alert.age_days} day{alert.age_days === 1 ? "" : "s"} ago</dd>
245
+ <dt className="kv-label">Last session</dt>
246
+ <dd className="kv-value mono small">{alert.last_touch_at ?? "—"}</dd>
247
+ {entity && (
248
+ <>
249
+ <dt className="kv-label">Entity type</dt>
250
+ <dd className="kv-value">{entity.type}</dd>
251
+ <dt className="kv-label">Total sessions</dt>
252
+ <dd className="kv-value mono">{entity.session_count}</dd>
253
+ </>
254
+ )}
255
+ </dl>
256
+
257
+ <div className="drawer-actions">
258
+ <button type="button" className="btn btn-accent" onClick={() => navigate(`/thread?entity=${encodeURIComponent(alert.entity)}`)}>
259
+ Open thread
260
+ </button>
261
+ <button type="button" className="btn" onClick={() => void onSnooze(7)}>Snooze 7d</button>
262
+ <button type="button" className="btn" onClick={() => void onSnooze(30)}>Snooze 30d</button>
263
+ <button type="button" className="btn btn-danger" onClick={() => void onDismiss()}>Dismiss</button>
264
+ </div>
265
+
266
+ {openQuestions.length > 0 && (
267
+ <>
268
+ <h4 className="drawer-section">Open questions ({openQuestions.length})</h4>
269
+ <ul className="drawer-list">
270
+ {openQuestions.slice(0, 12).map((q, i) => (
271
+ <li key={`${q.id}-${i}`} className="marker-row-promotable">
272
+ <span className="live-tag" data-kind="open">open</span>
273
+ <span className="marker-text">{q.text}</span>
274
+ <PromoteOpenButton openId={q.id} defaultText={q.text} onPromoted={onPromoted} />
275
+ <span className="muted small">{relativeAge(q.when)}</span>
276
+ </li>
277
+ ))}
278
+ </ul>
279
+ {openQuestions.length > 12 && <p className="muted small">Showing first 12 of {openQuestions.length}.</p>}
280
+ </>
281
+ )}
282
+
283
+ {decisions.length > 0 && (
284
+ <>
285
+ <h4 className="drawer-section">Decisions ({decisions.length})</h4>
286
+ <ul className="drawer-list">
287
+ {decisions.slice(0, 8).map((d, i) => (
288
+ <li key={`${d.sid}-${i}`}>
289
+ <span className="live-tag" data-kind="decision">decision</span>
290
+ <span className="marker-text">{d.text}</span>
291
+ <span className="muted small">{relativeAge(d.when)}</span>
292
+ </li>
293
+ ))}
294
+ </ul>
295
+ {decisions.length > 8 && <p className="muted small">Showing first 8 of {decisions.length}.</p>}
296
+ </>
297
+ )}
298
+
299
+ <h4 className="drawer-section">Recent sessions ({related.length})</h4>
300
+ <ul className="session-list">
301
+ {sessionSlice.map((s) => (
302
+ <li key={s.id} className="session-row">
303
+ <span className={`chip-inline status-${s.status}`}>{s.status}</span>
304
+ <div className="session-row-main">
305
+ <Link to={`/thread?entity=${encodeURIComponent(alert.entity)}&session=${encodeURIComponent(s.id)}`} className="session-label">{s.label}</Link>
306
+ <span className="session-meta">{s.summary}</span>
307
+ </div>
308
+ <span className="muted small mono">{relativeAge(s.started_at)}</span>
309
+ </li>
310
+ ))}
311
+ </ul>
312
+ {related.length > 0 && (
313
+ <div className="pagination pagination-compact">
314
+ <div className="page-size">
315
+ <label className="form-label">Per page</label>
316
+ <select
317
+ className="form-input form-input-inline"
318
+ value={pageSize}
319
+ onChange={(e) => setPageSize(Number.parseInt(e.target.value, 10))}
320
+ >
321
+ {DRAWER_PAGE_SIZES.map((n) => <option key={n} value={n}>{n}</option>)}
322
+ </select>
323
+ </div>
324
+ <span className="header-spacer" />
325
+ <span className="muted small">
326
+ {start + 1}–{Math.min(start + pageSize, related.length)} of {related.length}
327
+ </span>
328
+ <div className="page-nav">
329
+ <button type="button" className="chip" disabled={currentPage === 0} onClick={() => setPage(0)}>«</button>
330
+ <button type="button" className="chip" disabled={currentPage === 0} onClick={() => setPage((p) => Math.max(0, p - 1))}>‹</button>
331
+ <span className="page-indicator mono">{currentPage + 1} / {pageCount}</span>
332
+ <button type="button" className="chip" disabled={currentPage >= pageCount - 1} onClick={() => setPage((p) => Math.min(pageCount - 1, p + 1))}>›</button>
333
+ <button type="button" className="chip" disabled={currentPage >= pageCount - 1} onClick={() => setPage(pageCount - 1)}>»</button>
334
+ </div>
335
+ </div>
336
+ )}
337
+ </div>
338
+ </aside>
339
+ </>
340
+ );
341
+ }
342
+
343
+ function Kpi({ label, value, hint }: { label: string; value: number; hint?: string }) {
344
+ return (
345
+ <div className="kpi">
346
+ <span className="kpi-label">{label}</span>
347
+ <span className="kpi-value">{value.toLocaleString()}</span>
348
+ {hint && <span className="kpi-hint">{hint}</span>}
349
+ </div>
350
+ );
351
+ }
352
+
353
+ function KpiSparkline({ values }: { values: number[] }) {
354
+ const max = Math.max(1, ...values);
355
+ return (
356
+ <div className="kpi kpi-sparkline">
357
+ <span className="kpi-label">Last 7 days</span>
358
+ <div className="sparkline">
359
+ {values.map((v, i) => (
360
+ <span key={i} className="spark-bar" style={{ height: `${(v / max) * 100}%` }} title={`${v} sessions`} />
361
+ ))}
362
+ </div>
363
+ </div>
364
+ );
365
+ }
366
+
367
+ function CoherenceBars({ metrics }: { metrics: { healthy: number; sparse: number; stale: number } }) {
368
+ const total = metrics.healthy + metrics.sparse + metrics.stale;
369
+ const pct = (v: number) => (total > 0 ? (v / total) * 100 : 0);
370
+ return (
371
+ <div className="bar-stack">
372
+ <Bar tone="active" label="Healthy" value={metrics.healthy} pct={pct(metrics.healthy)} />
373
+ <Bar tone="warn" label="Sparse" value={metrics.sparse} pct={pct(metrics.sparse)} />
374
+ <Bar tone="danger" label="Stale" value={metrics.stale} pct={pct(metrics.stale)} />
375
+ </div>
376
+ );
377
+ }
378
+
379
+ function RuntimesPanel({ runtimes }: { runtimes: DatasetRuntime[] }) {
380
+ if (runtimes.length === 0) {
381
+ return <div className="muted small" style={{ padding: "8px 12px" }}>No runtime activity yet.</div>;
382
+ }
383
+ return (
384
+ <ul className="runtime-list">
385
+ {runtimes.map((r) => (
386
+ <li key={r.name} className="runtime-row">
387
+ <span className={`runtime-dot runtime-${r.status}`} title={r.status} />
388
+ <span className="runtime-name mono">{r.name}</span>
389
+ <span className="runtime-counts muted small">
390
+ {r.this_week}<span className="runtime-counts-sep">·</span><span className="runtime-counts-prev">{r.last_week} prev</span>
391
+ </span>
392
+ <span className="muted small mono runtime-age">{relativeAge(r.last_session_at)}</span>
393
+ </li>
394
+ ))}
395
+ </ul>
396
+ );
397
+ }
398
+
399
+ function Bar({ tone, label, value, pct }: {
400
+ tone: "active" | "warn" | "danger";
401
+ label: string;
402
+ value: number;
403
+ pct: number;
404
+ }) {
405
+ const rounded = Math.round(pct);
406
+ return (
407
+ <div className="bar-item">
408
+ <span className="bar-label">{label}</span>
409
+ <div className="bar-track" title={`${value.toLocaleString()} entit${value === 1 ? "y" : "ies"} · ${rounded}% of total`}>
410
+ <div className={`bar-fill tone-${tone}`} style={{ width: `${pct}%` }} />
411
+ </div>
412
+ <span className="bar-value mono">{value.toLocaleString()}<span className="bar-pct muted small"> · {rounded}%</span></span>
413
+ </div>
414
+ );
415
+ }