nlm-memory 0.4.2 → 0.5.1

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 (285) hide show
  1. package/README.md +72 -34
  2. package/dist/cli/nlm.js +223 -33
  3. package/dist/cli/nlm.js.map +1 -1
  4. package/dist/core/adapters/cursor.d.ts +45 -0
  5. package/dist/core/adapters/cursor.js +397 -0
  6. package/dist/core/adapters/cursor.js.map +1 -0
  7. package/dist/core/adapters/from-source.js +10 -0
  8. package/dist/core/adapters/from-source.js.map +1 -1
  9. package/dist/core/adapters/windsurf.d.ts +44 -0
  10. package/dist/core/adapters/windsurf.js +299 -0
  11. package/dist/core/adapters/windsurf.js.map +1 -0
  12. package/dist/core/hook/claude-settings.d.ts +12 -5
  13. package/dist/core/hook/claude-settings.js +21 -6
  14. package/dist/core/hook/claude-settings.js.map +1 -1
  15. package/dist/core/sources/source-registry.d.ts +1 -1
  16. package/dist/core/sources/source-registry.js +18 -0
  17. package/dist/core/sources/source-registry.js.map +1 -1
  18. package/dist/core/storage/sqlite-session-store.d.ts +2 -0
  19. package/dist/core/storage/sqlite-session-store.js +38 -2
  20. package/dist/core/storage/sqlite-session-store.js.map +1 -1
  21. package/dist/hook/hook-auth.d.ts +13 -0
  22. package/dist/hook/hook-auth.js +19 -0
  23. package/dist/hook/hook-auth.js.map +1 -0
  24. package/dist/hook/prompt-recall-hook.js +7 -1
  25. package/dist/hook/prompt-recall-hook.js.map +1 -1
  26. package/dist/hook/session-start-hook.js +4 -1
  27. package/dist/hook/session-start-hook.js.map +1 -1
  28. package/dist/hook/stop-hook.js +4 -1
  29. package/dist/hook/stop-hook.js.map +1 -1
  30. package/dist/http/app.d.ts +2 -0
  31. package/dist/http/app.js +76 -1
  32. package/dist/http/app.js.map +1 -1
  33. package/dist/install/claude-code.js +1 -1
  34. package/dist/install/claude-code.js.map +1 -1
  35. package/dist/install/cursor.d.ts +25 -0
  36. package/dist/install/cursor.js +43 -0
  37. package/dist/install/cursor.js.map +1 -0
  38. package/dist/install/nlm-dir-perms.d.ts +19 -0
  39. package/dist/install/nlm-dir-perms.js +43 -0
  40. package/dist/install/nlm-dir-perms.js.map +1 -0
  41. package/dist/install/ollama.d.ts +18 -1
  42. package/dist/install/ollama.js +62 -7
  43. package/dist/install/ollama.js.map +1 -1
  44. package/dist/install/setup.d.ts +4 -0
  45. package/dist/install/setup.js +141 -18
  46. package/dist/install/setup.js.map +1 -1
  47. package/dist/install/windsurf.d.ts +25 -0
  48. package/dist/install/windsurf.js +43 -0
  49. package/dist/install/windsurf.js.map +1 -0
  50. package/dist/mcp/server.js +20 -1
  51. package/dist/mcp/server.js.map +1 -1
  52. package/dist/shared/types.d.ts +4 -0
  53. package/dist/ui/assets/{index-BA6IpU8g.css → index-Beo8psd-.css} +1 -1
  54. package/dist/ui/assets/index-CSPTTeeM.js +69 -0
  55. package/dist/ui/index.html +2 -2
  56. package/package.json +26 -1
  57. package/plugin/scripts/prompt-recall-hook.mjs +55 -4
  58. package/plugin/scripts/stop-hook.mjs +57 -6
  59. package/.agents/plugins/marketplace.json +0 -20
  60. package/.github/workflows/ci.yml +0 -30
  61. package/dist/ui/assets/index-B_qIVV0k.js +0 -69
  62. package/docs/methodology/re-derivation-rate.md +0 -112
  63. package/docs/methodology/useful-hit-rate.md +0 -79
  64. package/docs/plans/2026-05-20-fts5-lexical-recall.md +0 -1088
  65. package/docs/plans/2026-05-20-recall-daemon-wedge-fix.md +0 -662
  66. package/docs/plans/2026-05-20-recall-hook-design.md +0 -131
  67. package/docs/plans/2026-05-20-recall-hook-implementation.md +0 -1222
  68. package/docs/plans/desktop-product.md +0 -69
  69. package/docs/plans/factstore-design.md +0 -236
  70. package/logs/CHANGELOG/CHANGELOG-2026.md +0 -1389
  71. package/logs/CHANGELOG/CHANGELOG.md +0 -337
  72. package/migrations/000_initial_schema.sql +0 -174
  73. package/migrations/001_entity_type_rename.sql +0 -17
  74. package/migrations/002_adapter_state_extend.sql +0 -12
  75. package/migrations/003_session_embeddings.sql +0 -11
  76. package/migrations/004_facts.sql +0 -46
  77. package/migrations/005_sources.sql +0 -31
  78. package/migrations/006_providers.sql +0 -33
  79. package/migrations/007_source_tokens.sql +0 -17
  80. package/migrations/008_fts_rebuild.sql +0 -9
  81. package/migrations/009_session_embedding_chunks.sql +0 -46
  82. package/migrations/010_sources_opencode.sql +0 -30
  83. package/migrations/011_sources_hermes_agent.sql +0 -30
  84. package/migrations/012_sources_aider.sql +0 -30
  85. package/migrations/013_adapter_state_failure_count.sql +0 -12
  86. package/plugin-hermes-agent/README.md +0 -49
  87. package/plugin-hermes-agent/__init__.py +0 -75
  88. package/plugin-hermes-agent/plugin.yaml +0 -15
  89. package/scripts/backfill-citations.mjs +0 -0
  90. package/scripts/build-codex-plugin.mjs +0 -61
  91. package/scripts/deepseek-probe.mjs +0 -67
  92. package/scripts/extract-triples.mjs +0 -207
  93. package/scripts/longmemeval/embedding-cache.ts +0 -77
  94. package/scripts/longmemeval/fetch-dataset.sh +0 -25
  95. package/scripts/longmemeval/run-harness.ts +0 -315
  96. package/scripts/longmemeval/scorer.ts +0 -99
  97. package/scripts/longmemeval/tsconfig.json +0 -9
  98. package/scripts/longmemeval/types.ts +0 -35
  99. package/scripts/nlm-daily-digest.py +0 -239
  100. package/scripts/nlm-daily-digest.sh +0 -28
  101. package/src/cli/classify-parity.ts +0 -257
  102. package/src/cli/launchctl-helpers.ts +0 -49
  103. package/src/cli/nlm.ts +0 -885
  104. package/src/core/actions/actions-log.ts +0 -118
  105. package/src/core/actions/overlay.ts +0 -117
  106. package/src/core/adapters/aider.ts +0 -205
  107. package/src/core/adapters/claude-code.ts +0 -293
  108. package/src/core/adapters/common.ts +0 -54
  109. package/src/core/adapters/from-source.ts +0 -57
  110. package/src/core/adapters/hermes-agent.ts +0 -240
  111. package/src/core/adapters/hermes.ts +0 -277
  112. package/src/core/adapters/jsonl-generic.ts +0 -208
  113. package/src/core/adapters/opencode.ts +0 -281
  114. package/src/core/adapters/pi.ts +0 -264
  115. package/src/core/classifier/prompt.ts +0 -200
  116. package/src/core/dataset/build-dataset.ts +0 -463
  117. package/src/core/embedding/chunk-body.ts +0 -76
  118. package/src/core/embedding/embed-backfill.ts +0 -210
  119. package/src/core/embedding/embed-normalize.ts +0 -135
  120. package/src/core/facts/backfill-facts.ts +0 -254
  121. package/src/core/facts/extract-facts.ts +0 -50
  122. package/src/core/hook/citation-detect.ts +0 -124
  123. package/src/core/hook/cite-memo.ts +0 -68
  124. package/src/core/hook/claude-settings.ts +0 -166
  125. package/src/core/hook/gate.ts +0 -25
  126. package/src/core/hook/hook-log.ts +0 -41
  127. package/src/core/hook/memo-sweep.ts +0 -164
  128. package/src/core/hook/memo.ts +0 -67
  129. package/src/core/hook/pointer-block.ts +0 -26
  130. package/src/core/hook/select.ts +0 -32
  131. package/src/core/hook/transcript.ts +0 -121
  132. package/src/core/ingest/ingest-session.ts +0 -111
  133. package/src/core/providers/provider-models.ts +0 -100
  134. package/src/core/providers/provider-registry.ts +0 -196
  135. package/src/core/recall/citation-log.ts +0 -108
  136. package/src/core/recall/filter.ts +0 -27
  137. package/src/core/recall/index.ts +0 -6
  138. package/src/core/recall/match-fields.ts +0 -40
  139. package/src/core/recall/query-log.ts +0 -149
  140. package/src/core/recall/query-shape.ts +0 -66
  141. package/src/core/recall/recall-service.ts +0 -320
  142. package/src/core/recall/recent-log.ts +0 -59
  143. package/src/core/recall/tokenize.ts +0 -18
  144. package/src/core/recall/useful-scan.ts +0 -336
  145. package/src/core/recall-facts/fact-query-log.ts +0 -150
  146. package/src/core/recall-facts/fact-recall-service.ts +0 -327
  147. package/src/core/scheduler/scan-once.ts +0 -142
  148. package/src/core/scheduler/scheduler.ts +0 -225
  149. package/src/core/sources/source-registry.ts +0 -260
  150. package/src/core/storage/db-restore.ts +0 -133
  151. package/src/core/storage/live-status.ts +0 -45
  152. package/src/core/storage/migrate.ts +0 -72
  153. package/src/core/storage/sqlite-fact-store.ts +0 -304
  154. package/src/core/storage/sqlite-session-store.ts +0 -765
  155. package/src/hook/prompt-recall-hook.ts +0 -174
  156. package/src/hook/session-end-hook.ts +0 -81
  157. package/src/hook/session-start-hook.ts +0 -165
  158. package/src/hook/stop-hook.ts +0 -236
  159. package/src/http/app.ts +0 -1137
  160. package/src/install/claude-code.ts +0 -128
  161. package/src/install/codex.ts +0 -367
  162. package/src/install/hermes-agent.ts +0 -76
  163. package/src/install/hermes.ts +0 -78
  164. package/src/install/ollama.ts +0 -211
  165. package/src/install/setup.ts +0 -368
  166. package/src/llm/classifier-box.ts +0 -64
  167. package/src/llm/deepseek-client.ts +0 -150
  168. package/src/llm/env-autoload.ts +0 -55
  169. package/src/llm/ollama-client.ts +0 -189
  170. package/src/mcp/server.ts +0 -534
  171. package/src/ports/fact-store.ts +0 -102
  172. package/src/ports/llm-client.ts +0 -52
  173. package/src/ports/logger.ts +0 -16
  174. package/src/ports/session-store.ts +0 -45
  175. package/src/ports/transcript-adapter.ts +0 -55
  176. package/src/shared/types.ts +0 -145
  177. package/src/ui/App.tsx +0 -58
  178. package/src/ui/components/PromoteOpenButton.tsx +0 -65
  179. package/src/ui/components/SessionDrawer.tsx +0 -136
  180. package/src/ui/components/SideNav.tsx +0 -162
  181. package/src/ui/components/Skeleton.tsx +0 -107
  182. package/src/ui/index.html +0 -13
  183. package/src/ui/lib/actions.ts +0 -30
  184. package/src/ui/lib/api.ts +0 -92
  185. package/src/ui/lib/dataset.ts +0 -141
  186. package/src/ui/lib/registries.ts +0 -155
  187. package/src/ui/lib/view-settings.ts +0 -41
  188. package/src/ui/main.tsx +0 -15
  189. package/src/ui/pages/Live.tsx +0 -229
  190. package/src/ui/pages/Pulse.tsx +0 -415
  191. package/src/ui/pages/Recall.tsx +0 -190
  192. package/src/ui/pages/River.tsx +0 -308
  193. package/src/ui/pages/Search.tsx +0 -93
  194. package/src/ui/pages/Stub.tsx +0 -9
  195. package/src/ui/pages/Thread.tsx +0 -262
  196. package/src/ui/pages/settings/Classifier.tsx +0 -227
  197. package/src/ui/pages/settings/Data.tsx +0 -190
  198. package/src/ui/pages/settings/Index.tsx +0 -65
  199. package/src/ui/pages/settings/Labels.tsx +0 -224
  200. package/src/ui/pages/settings/Providers.tsx +0 -305
  201. package/src/ui/pages/settings/SettingsSubnav.tsx +0 -28
  202. package/src/ui/pages/settings/Sources.tsx +0 -326
  203. package/src/ui/pages/settings/Views.tsx +0 -96
  204. package/src/ui/styles.css +0 -1766
  205. package/src/ui/tsconfig.json +0 -21
  206. package/src/ui/vite.config.ts +0 -19
  207. package/tests/fixtures/claude_code/short_session.jsonl +0 -2
  208. package/tests/fixtures/claude_code/standard_iso.jsonl +0 -4
  209. package/tests/fixtures/claude_code/tool_heavy.jsonl +0 -8
  210. package/tests/fixtures/claude_code/with_subagent.jsonl +0 -7
  211. package/tests/fixtures/facts.ts +0 -17
  212. package/tests/fixtures/golden-corpus.ts +0 -85
  213. package/tests/fixtures/hermes/paired_request_dump.json +0 -24
  214. package/tests/fixtures/hermes/paired_session.json +0 -23
  215. package/tests/fixtures/hermes/request_dump.json +0 -28
  216. package/tests/fixtures/hermes/session_iso.json +0 -38
  217. package/tests/fixtures/hermes/session_unix.json +0 -38
  218. package/tests/fixtures/hermes/system_only.json +0 -18
  219. package/tests/fixtures/pi/error-connection-abort.jsonl +0 -8
  220. package/tests/fixtures/pi/short-successful.jsonl +0 -5
  221. package/tests/fixtures/pi/with-custom-message.jsonl +0 -6
  222. package/tests/fixtures/sessions.ts +0 -22
  223. package/tests/integration/backfill-facts.test.ts +0 -362
  224. package/tests/integration/citation-explicit.test.ts +0 -111
  225. package/tests/integration/cite-event.test.ts +0 -169
  226. package/tests/integration/cite-memo.test.ts +0 -87
  227. package/tests/integration/db-restore.test.ts +0 -153
  228. package/tests/integration/embed-backfill.test.ts +0 -176
  229. package/tests/integration/fact-supersedence.test.ts +0 -313
  230. package/tests/integration/fts-index.test.ts +0 -60
  231. package/tests/integration/getbyids-sqlite.test.ts +0 -60
  232. package/tests/integration/hermes-agent-hooks.test.ts +0 -248
  233. package/tests/integration/hook-claude-settings.test.ts +0 -205
  234. package/tests/integration/hook-log.test.ts +0 -54
  235. package/tests/integration/hook-memo.test.ts +0 -68
  236. package/tests/integration/hook-pre-compact.test.ts +0 -105
  237. package/tests/integration/hook-subagent-start.test.ts +0 -102
  238. package/tests/integration/http.test.ts +0 -401
  239. package/tests/integration/keyword-search-fts.test.ts +0 -66
  240. package/tests/integration/mcp-recall-logging.test.ts +0 -88
  241. package/tests/integration/mcp.test.ts +0 -248
  242. package/tests/integration/memo-sweep.test.ts +0 -91
  243. package/tests/integration/prompt-recall-hook.test.ts +0 -88
  244. package/tests/integration/provider-registry.test.ts +0 -107
  245. package/tests/integration/recall-golden.test.ts +0 -59
  246. package/tests/integration/recall-sqlite.test.ts +0 -169
  247. package/tests/integration/scheduler.test.ts +0 -391
  248. package/tests/integration/session-end-hook.test.ts +0 -48
  249. package/tests/integration/session-start-hook.test.ts +0 -126
  250. package/tests/integration/source-registry.test.ts +0 -120
  251. package/tests/integration/sqlite-fact-store.test.ts +0 -346
  252. package/tests/integration/stop-hook.test.ts +0 -560
  253. package/tests/integration/wal-checkpoint.test.ts +0 -49
  254. package/tests/unit/cli/launchctl-helpers.test.ts +0 -60
  255. package/tests/unit/core/adapters/aider.test.ts +0 -230
  256. package/tests/unit/core/adapters/claude-code.test.ts +0 -118
  257. package/tests/unit/core/adapters/hermes-agent.test.ts +0 -329
  258. package/tests/unit/core/adapters/hermes.test.ts +0 -81
  259. package/tests/unit/core/adapters/jsonl-generic.test.ts +0 -142
  260. package/tests/unit/core/adapters/opencode.test.ts +0 -354
  261. package/tests/unit/core/adapters/pi.test.ts +0 -110
  262. package/tests/unit/core/classifier/prompt.test.ts +0 -126
  263. package/tests/unit/core/embedding/chunk-body.test.ts +0 -100
  264. package/tests/unit/core/facts/extract-facts.test.ts +0 -117
  265. package/tests/unit/core/filter.test.ts +0 -40
  266. package/tests/unit/core/hook/citation-detect-cite-session.test.ts +0 -96
  267. package/tests/unit/core/hook/citation-detect.test.ts +0 -124
  268. package/tests/unit/core/hook/gate.test.ts +0 -29
  269. package/tests/unit/core/hook/pointer-block.test.ts +0 -22
  270. package/tests/unit/core/hook/select.test.ts +0 -66
  271. package/tests/unit/core/match-fields.test.ts +0 -39
  272. package/tests/unit/core/mcp-cite-session.test.ts +0 -51
  273. package/tests/unit/core/providers/provider-models.test.ts +0 -101
  274. package/tests/unit/core/query-shape.test.ts +0 -92
  275. package/tests/unit/core/recall-facts/fact-recall-service.test.ts +0 -258
  276. package/tests/unit/core/recall-service.test.ts +0 -200
  277. package/tests/unit/core/storage/live-status.test.ts +0 -54
  278. package/tests/unit/core/tokenize.test.ts +0 -32
  279. package/tests/unit/core/useful-scan.test.ts +0 -537
  280. package/tests/unit/llm/embed.test.ts +0 -93
  281. package/tests/unit/llm/ollama-client.test.ts +0 -124
  282. package/tests/unit/scripts/longmemeval-scorer.test.ts +0 -114
  283. package/tsconfig.json +0 -31
  284. package/tsconfig.test.json +0 -11
  285. package/vitest.config.ts +0 -22
@@ -1,229 +0,0 @@
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
- }
@@ -1,415 +0,0 @@
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
- }