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,81 +0,0 @@
1
- /**
2
- * HermesAdapter parity tests against the same synthetic JSON fixtures the
3
- * Python pytest suite uses. Mirrors test_adapter_hermes.py.
4
- */
5
-
6
- import { basename, resolve } from "node:path";
7
- import { describe, expect, it } from "vitest";
8
- import { HermesAdapter } from "../../../../src/core/adapters/hermes.js";
9
- import { safeSessionId } from "../../../../src/core/adapters/common.js";
10
-
11
- const FIXTURES = resolve(__dirname, "../../../fixtures/hermes");
12
-
13
- function stem(p: string): string {
14
- return basename(p, ".json");
15
- }
16
-
17
- describe("HermesAdapter.discover", () => {
18
- it("dedupes paired session + dump files (session wins) → 5 paths total", async () => {
19
- const adapter = new HermesAdapter({ sessionsPath: FIXTURES });
20
- const found = await adapter.discover();
21
- const stems = new Set(found.map(stem));
22
-
23
- expect(stems.has("session_iso")).toBe(true);
24
- expect(stems.has("session_unix")).toBe(true);
25
- expect(stems.has("request_dump")).toBe(true);
26
- expect(stems.has("system_only")).toBe(true);
27
-
28
- expect(stems.has("paired_session")).toBe(true);
29
- expect(stems.has("paired_request_dump")).toBe(false);
30
-
31
- expect(found.length).toBe(5);
32
- });
33
- });
34
-
35
- describe("HermesAdapter.parseSession", () => {
36
- const adapter = new HermesAdapter({ sessionsPath: FIXTURES });
37
-
38
- it("session_iso: 4 turns (system stripped), id prefixed hm_, non-empty timestamps", async () => {
39
- const chunk = await adapter.parseSession(`${FIXTURES}/session_iso.json`);
40
- expect(chunk).not.toBeNull();
41
- if (!chunk) return;
42
- expect(chunk.runtime).toBe("hermes/1.0");
43
- expect(chunk.turnCount).toBe(4);
44
- expect(chunk.startedAt).toBeTruthy();
45
- expect(chunk.endedAt).toBeTruthy();
46
- expect(chunk.id.startsWith("hm_")).toBe(true);
47
- });
48
-
49
- it("session_unix: Unix int message timestamps get normalized to ISO strings", async () => {
50
- // Headline regression test for the b8a3400 class of bug.
51
- const chunk = await adapter.parseSession(`${FIXTURES}/session_unix.json`);
52
- expect(chunk).not.toBeNull();
53
- if (!chunk) return;
54
- expect(chunk.startedAt).toBeTruthy();
55
- expect(chunk.startedAt).toMatch(/T/);
56
- expect(chunk.turnCount).toBe(4);
57
- });
58
-
59
- it("request_dump: nested request.body.messages parsed, 2 turns (system stripped)", async () => {
60
- const chunk = await adapter.parseSession(`${FIXTURES}/request_dump.json`);
61
- expect(chunk).not.toBeNull();
62
- if (!chunk) return;
63
- expect(chunk.turnCount).toBe(2);
64
- expect(chunk.startedAt).toBeTruthy();
65
- });
66
-
67
- it("system_only: returns null when no real turns exist", async () => {
68
- const chunk = await adapter.parseSession(`${FIXTURES}/system_only.json`);
69
- expect(chunk).toBeNull();
70
- });
71
- });
72
-
73
- describe("safeSessionId collision resistance", () => {
74
- it("two Hermes session_ids with same date prefix produce distinct ids", () => {
75
- const a = safeSessionId("hm", "20260310_100000_abc123");
76
- const b = safeSessionId("hm", "20260310_100000_def456");
77
- expect(a).not.toBe(b);
78
- expect(a.startsWith("hm_")).toBe(true);
79
- expect(b.startsWith("hm_")).toBe(true);
80
- });
81
- });
@@ -1,142 +0,0 @@
1
- /**
2
- * JsonlGenericAdapter — generic JSONL parser driven by parseConfig.
3
- *
4
- * Covers: discover filtering by extension + mtime; parseSession handling
5
- * default field shapes, OpenAI-style content arrays, missing role field,
6
- * label/session_id fallback to filename, idle adapters returning [].
7
- */
8
-
9
- import { mkdtempSync, rmSync, writeFileSync, utimesSync } from "node:fs";
10
- import { tmpdir } from "node:os";
11
- import { join } from "node:path";
12
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
13
- import { JsonlGenericAdapter } from "../../../../src/core/adapters/jsonl-generic.js";
14
-
15
- function write(path: string, lines: object[]): void {
16
- writeFileSync(path, lines.map((l) => JSON.stringify(l)).join("\n") + "\n");
17
- }
18
-
19
- describe("JsonlGenericAdapter", () => {
20
- let dir: string;
21
-
22
- beforeEach(() => {
23
- dir = mkdtempSync(join(tmpdir(), "nlm-jsonl-"));
24
- });
25
-
26
- afterEach(() => {
27
- rmSync(dir, { recursive: true, force: true });
28
- });
29
-
30
- it("returns disabled when path is missing", () => {
31
- const a = new JsonlGenericAdapter({
32
- name: "custom",
33
- path: join(dir, "no-such-dir"),
34
- runtime: "custom/1.0",
35
- config: {},
36
- });
37
- expect(a.detect().enabled).toBe(false);
38
- });
39
-
40
- it("discovers .jsonl files only by default", async () => {
41
- writeFileSync(join(dir, "a.jsonl"), "{}\n");
42
- writeFileSync(join(dir, "b.json"), "{}\n");
43
- writeFileSync(join(dir, "c.jsonl"), "{}\n");
44
- const a = new JsonlGenericAdapter({
45
- name: "custom", path: dir, runtime: "custom/1.0", config: {},
46
- });
47
- const files = await a.discover();
48
- expect(files.map((f) => f.split("/").pop()).sort()).toEqual(["a.jsonl", "c.jsonl"]);
49
- });
50
-
51
- it("respects `since` mtime filter", async () => {
52
- const oldFile = join(dir, "old.jsonl");
53
- const newFile = join(dir, "new.jsonl");
54
- writeFileSync(oldFile, "{}\n");
55
- writeFileSync(newFile, "{}\n");
56
- const old = (Date.now() - 7 * 86_400_000) / 1000;
57
- utimesSync(oldFile, old, old);
58
- const a = new JsonlGenericAdapter({
59
- name: "custom", path: dir, runtime: "custom/1.0", config: {},
60
- });
61
- const files = await a.discover({ since: new Date(Date.now() - 86_400_000) });
62
- expect(files.length).toBe(1);
63
- expect(files[0]?.endsWith("new.jsonl")).toBe(true);
64
- });
65
-
66
- it("parses a session with default config (role + content fields)", async () => {
67
- const file = join(dir, "sess.jsonl");
68
- write(file, [
69
- { role: "user", content: "Help me debug this query", timestamp: "2026-05-19T10:00:00Z" },
70
- { role: "assistant", content: "Sure — what's the error?", timestamp: "2026-05-19T10:00:30Z" },
71
- ]);
72
- const a = new JsonlGenericAdapter({
73
- name: "custom", path: dir, runtime: "custom/1.0", config: {},
74
- });
75
- const session = await a.parseSession(file);
76
- expect(session).not.toBeNull();
77
- expect(session!.turnCount).toBe(2);
78
- expect(session!.text).toContain("User: Help me debug");
79
- expect(session!.text).toContain("Assistant: Sure");
80
- expect(session!.startedAt).toBe("2026-05-19T10:00:00Z");
81
- expect(session!.runtime).toBe("custom/1.0");
82
- });
83
-
84
- it("extracts text from OpenAI-style content arrays", async () => {
85
- const file = join(dir, "sess.jsonl");
86
- write(file, [
87
- { role: "user", content: [{ type: "text", text: "Hello there" }] },
88
- { role: "assistant", content: [{ type: "text", text: "Hi!" }] },
89
- ]);
90
- const a = new JsonlGenericAdapter({
91
- name: "custom", path: dir, runtime: "custom/1.0", config: {},
92
- });
93
- const session = await a.parseSession(file);
94
- expect(session?.text).toContain("Hello there");
95
- expect(session?.text).toContain("Hi!");
96
- });
97
-
98
- it("falls back to filename when sessionIdField / labelField missing", async () => {
99
- const file = join(dir, "fallback-name.jsonl");
100
- write(file, [{ role: "user", content: "anything" }]);
101
- const a = new JsonlGenericAdapter({
102
- name: "custom", path: dir, runtime: "custom/1.0", config: {},
103
- });
104
- const session = await a.parseSession(file);
105
- expect(session?.label).toBe("fallback-name");
106
- expect(session?.runtimeSessionId).toBe("fallback-name");
107
- });
108
-
109
- it("honors custom field mapping", async () => {
110
- const file = join(dir, "weird.jsonl");
111
- write(file, [
112
- { who: "human", body: "ping", at: "2026-05-19T09:00:00Z", convo: "abc-123" },
113
- { who: "ai", body: "pong", at: "2026-05-19T09:00:05Z", convo: "abc-123" },
114
- ]);
115
- const a = new JsonlGenericAdapter({
116
- name: "weird", path: dir, runtime: "weird/1.0",
117
- config: {
118
- textField: "body",
119
- roleField: "who",
120
- userRole: "human",
121
- assistantRole: "ai",
122
- timestampField: "at",
123
- sessionIdField: "convo",
124
- },
125
- });
126
- const session = await a.parseSession(file);
127
- expect(session?.turnCount).toBe(2);
128
- expect(session?.runtimeSessionId).toBe("abc-123");
129
- });
130
-
131
- it("returns null for empty or all-garbage files", async () => {
132
- const empty = join(dir, "empty.jsonl");
133
- writeFileSync(empty, "");
134
- const garbage = join(dir, "garbage.jsonl");
135
- writeFileSync(garbage, "not json\nstill not json\n");
136
- const a = new JsonlGenericAdapter({
137
- name: "custom", path: dir, runtime: "custom/1.0", config: {},
138
- });
139
- expect(await a.parseSession(empty)).toBeNull();
140
- expect(await a.parseSession(garbage)).toBeNull();
141
- });
142
- });
@@ -1,354 +0,0 @@
1
- /**
2
- * OpenCodeAdapter unit tests.
3
- *
4
- * Each test builds an in-memory SQLite DB seeded with the minimal schema
5
- * OpenCode uses, then writes it to a temp file so the adapter can open it
6
- * with better-sqlite3 in readonly mode.
7
- */
8
-
9
- import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
10
- import { tmpdir } from "node:os";
11
- import { join } from "node:path";
12
- import Database from "better-sqlite3";
13
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
14
- import { OpenCodeAdapter } from "../../../../src/core/adapters/opencode.js";
15
-
16
- // ── Schema helpers ────────────────────────────────────────────────────────────
17
-
18
- function createDb(path: string): Database.Database {
19
- const db = new Database(path);
20
- db.exec(`
21
- CREATE TABLE IF NOT EXISTS session (
22
- id TEXT PRIMARY KEY,
23
- project_id TEXT NOT NULL DEFAULT 'proj_1',
24
- directory TEXT NOT NULL DEFAULT '/tmp/test',
25
- title TEXT NOT NULL DEFAULT 'New session',
26
- version TEXT NOT NULL DEFAULT '1.0',
27
- slug TEXT NOT NULL DEFAULT 'test',
28
- time_created INTEGER NOT NULL,
29
- time_updated INTEGER NOT NULL,
30
- time_archived INTEGER
31
- );
32
- CREATE TABLE IF NOT EXISTS message (
33
- id TEXT PRIMARY KEY,
34
- session_id TEXT NOT NULL REFERENCES session(id) ON DELETE CASCADE,
35
- time_created INTEGER NOT NULL,
36
- time_updated INTEGER NOT NULL DEFAULT 0,
37
- data TEXT NOT NULL
38
- );
39
- CREATE TABLE IF NOT EXISTS part (
40
- id TEXT PRIMARY KEY,
41
- message_id TEXT NOT NULL REFERENCES message(id) ON DELETE CASCADE,
42
- session_id TEXT NOT NULL,
43
- time_created INTEGER NOT NULL,
44
- time_updated INTEGER NOT NULL DEFAULT 0,
45
- data TEXT NOT NULL
46
- );
47
- `);
48
- return db;
49
- }
50
-
51
- function addSession(
52
- db: Database.Database,
53
- opts: {
54
- id: string;
55
- directory?: string;
56
- title?: string;
57
- timeCreated?: number;
58
- timeUpdated?: number;
59
- archived?: boolean;
60
- },
61
- ): void {
62
- const now = Date.now();
63
- db.prepare(
64
- `INSERT INTO session (id, directory, title, time_created, time_updated, time_archived)
65
- VALUES (?, ?, ?, ?, ?, ?)`,
66
- ).run(
67
- opts.id,
68
- opts.directory ?? "/tmp/proj",
69
- opts.title ?? "New session",
70
- opts.timeCreated ?? now - 3600_000,
71
- opts.timeUpdated ?? now,
72
- opts.archived ? now : null,
73
- );
74
- }
75
-
76
- function addMessage(
77
- db: Database.Database,
78
- sessionId: string,
79
- msgId: string,
80
- role: "user" | "assistant",
81
- timeCreated: number,
82
- ): void {
83
- db.prepare(
84
- `INSERT INTO message (id, session_id, time_created, data)
85
- VALUES (?, ?, ?, ?)`,
86
- ).run(msgId, sessionId, timeCreated, JSON.stringify({ role }));
87
- }
88
-
89
- function addTextPart(
90
- db: Database.Database,
91
- sessionId: string,
92
- msgId: string,
93
- text: string,
94
- opts: { ignored?: boolean } = {},
95
- ): void {
96
- const id = `part_${Math.random().toString(36).slice(2)}`;
97
- db.prepare(
98
- `INSERT INTO part (id, message_id, session_id, time_created, data)
99
- VALUES (?, ?, ?, ?, ?)`,
100
- ).run(
101
- id,
102
- msgId,
103
- sessionId,
104
- Date.now(),
105
- JSON.stringify({ type: "text", text, ...(opts.ignored ? { ignored: true } : {}) }),
106
- );
107
- }
108
-
109
- function addToolPart(
110
- db: Database.Database,
111
- sessionId: string,
112
- msgId: string,
113
- toolName: string,
114
- ): void {
115
- const id = `part_${Math.random().toString(36).slice(2)}`;
116
- db.prepare(
117
- `INSERT INTO part (id, message_id, session_id, time_created, data)
118
- VALUES (?, ?, ?, ?, ?)`,
119
- ).run(
120
- id,
121
- msgId,
122
- sessionId,
123
- Date.now(),
124
- JSON.stringify({ type: "tool", tool: toolName, callID: "call_1", state: {} }),
125
- );
126
- }
127
-
128
- // ── Test setup ────────────────────────────────────────────────────────────────
129
-
130
- let tmp: string;
131
- let dbPath: string;
132
- let db: Database.Database;
133
-
134
- beforeEach(() => {
135
- tmp = mkdtempSync(join(tmpdir(), "nlm-oc-"));
136
- dbPath = join(tmp, "opencode.db");
137
- db = createDb(dbPath);
138
- });
139
-
140
- afterEach(() => {
141
- db.close();
142
- rmSync(tmp, { recursive: true, force: true });
143
- });
144
-
145
- // ── detect() ─────────────────────────────────────────────────────────────────
146
-
147
- describe("OpenCodeAdapter.detect", () => {
148
- it("returns enabled=true when DB file exists", () => {
149
- const adapter = new OpenCodeAdapter({ dbPath });
150
- expect(adapter.detect().enabled).toBe(true);
151
- expect(adapter.detect().path).toBe(dbPath);
152
- });
153
-
154
- it("returns enabled=false when DB file is absent", () => {
155
- const adapter = new OpenCodeAdapter({ dbPath: join(tmp, "missing.db") });
156
- expect(adapter.detect().enabled).toBe(false);
157
- expect(adapter.detect().path).toBeNull();
158
- });
159
- });
160
-
161
- // ── discover() ───────────────────────────────────────────────────────────────
162
-
163
- describe("OpenCodeAdapter.discover", () => {
164
- it("returns all non-archived session IDs", async () => {
165
- addSession(db, { id: "sess_a" });
166
- addSession(db, { id: "sess_b" });
167
- db.close();
168
-
169
- const adapter = new OpenCodeAdapter({ dbPath });
170
- const ids = await adapter.discover();
171
- expect(ids).toContain("sess_a");
172
- expect(ids).toContain("sess_b");
173
- expect(ids.length).toBe(2);
174
- });
175
-
176
- it("excludes archived sessions", async () => {
177
- addSession(db, { id: "sess_live" });
178
- addSession(db, { id: "sess_archived", archived: true });
179
- db.close();
180
-
181
- const adapter = new OpenCodeAdapter({ dbPath });
182
- const ids = await adapter.discover();
183
- expect(ids).toContain("sess_live");
184
- expect(ids).not.toContain("sess_archived");
185
- });
186
-
187
- it("respects the since option", async () => {
188
- const old = Date.now() - 7 * 24 * 3600_000;
189
- const recent = Date.now() - 3600_000;
190
- addSession(db, { id: "sess_old", timeCreated: old - 1000, timeUpdated: old });
191
- addSession(db, { id: "sess_new", timeCreated: recent - 1000, timeUpdated: recent });
192
- db.close();
193
-
194
- const adapter = new OpenCodeAdapter({ dbPath });
195
- const cutoff = new Date(old + 1);
196
- const ids = await adapter.discover({ since: cutoff });
197
- expect(ids).toContain("sess_new");
198
- expect(ids).not.toContain("sess_old");
199
- });
200
-
201
- it("returns empty array when DB is absent", async () => {
202
- db.close();
203
- const adapter = new OpenCodeAdapter({ dbPath: join(tmp, "no.db") });
204
- const ids = await adapter.discover();
205
- expect(ids).toEqual([]);
206
- });
207
- });
208
-
209
- // ── parseSession() ────────────────────────────────────────────────────────────
210
-
211
- describe("OpenCodeAdapter.parseSession", () => {
212
- it("returns null for an unknown session ID", async () => {
213
- db.close();
214
- const adapter = new OpenCodeAdapter({ dbPath });
215
- expect(await adapter.parseSession("nonexistent")).toBeNull();
216
- });
217
-
218
- it("returns null when session has no usable turns", async () => {
219
- addSession(db, { id: "sess_empty" });
220
- // message with only an ignored text part
221
- addMessage(db, "sess_empty", "msg_1", "user", Date.now());
222
- addTextPart(db, "sess_empty", "msg_1", "ignored text", { ignored: true });
223
- db.close();
224
-
225
- const adapter = new OpenCodeAdapter({ dbPath });
226
- expect(await adapter.parseSession("sess_empty")).toBeNull();
227
- });
228
-
229
- it("builds the correct turn count and roles", async () => {
230
- const now = Date.now();
231
- addSession(db, { id: "sess_1", timeCreated: now - 5000, timeUpdated: now });
232
- addMessage(db, "sess_1", "msg_u1", "user", now - 4000);
233
- addTextPart(db, "sess_1", "msg_u1", "hello");
234
- addMessage(db, "sess_1", "msg_a1", "assistant", now - 3000);
235
- addTextPart(db, "sess_1", "msg_a1", "world");
236
- addMessage(db, "sess_1", "msg_u2", "user", now - 2000);
237
- addTextPart(db, "sess_1", "msg_u2", "follow-up");
238
- db.close();
239
-
240
- const adapter = new OpenCodeAdapter({ dbPath });
241
- const chunk = await adapter.parseSession("sess_1");
242
- expect(chunk).not.toBeNull();
243
- expect(chunk!.turnCount).toBe(3);
244
- expect(chunk!.id).toBe("oc_sess_1");
245
- expect(chunk!.runtime).toBe("opencode/1.0");
246
- });
247
-
248
- it("skips ignored text parts", async () => {
249
- const now = Date.now();
250
- addSession(db, { id: "sess_2", timeCreated: now - 2000, timeUpdated: now });
251
- addMessage(db, "sess_2", "msg_1", "user", now - 1000);
252
- addTextPart(db, "sess_2", "msg_1", "visible");
253
- addTextPart(db, "sess_2", "msg_1", "ignored part", { ignored: true });
254
- db.close();
255
-
256
- const adapter = new OpenCodeAdapter({ dbPath });
257
- const chunk = await adapter.parseSession("sess_2");
258
- expect(chunk!.text).toContain("visible");
259
- expect(chunk!.text).not.toContain("ignored part");
260
- });
261
-
262
- it("summarizes tool parts as [tool: <name>]", async () => {
263
- const now = Date.now();
264
- addSession(db, { id: "sess_3", timeCreated: now - 2000, timeUpdated: now });
265
- addMessage(db, "sess_3", "msg_u", "user", now - 1500);
266
- addTextPart(db, "sess_3", "msg_u", "run a command");
267
- addMessage(db, "sess_3", "msg_a", "assistant", now - 1000);
268
- addToolPart(db, "sess_3", "msg_a", "bash");
269
- db.close();
270
-
271
- const adapter = new OpenCodeAdapter({ dbPath });
272
- const chunk = await adapter.parseSession("sess_3");
273
- expect(chunk!.text).toContain("[tool: bash]");
274
- expect(chunk!.turnCount).toBe(2);
275
- });
276
-
277
- it("uses the session title as label when it is not 'New session'", async () => {
278
- const now = Date.now();
279
- addSession(db, { id: "sess_4", title: "Fix the auth bug", timeCreated: now - 2000, timeUpdated: now });
280
- addMessage(db, "sess_4", "msg_1", "user", now - 1000);
281
- addTextPart(db, "sess_4", "msg_1", "first message");
282
- db.close();
283
-
284
- const adapter = new OpenCodeAdapter({ dbPath });
285
- const chunk = await adapter.parseSession("sess_4");
286
- expect(chunk!.label).toBe("Fix the auth bug");
287
- });
288
-
289
- it("falls back to first user turn for label when title is 'New session'", async () => {
290
- const now = Date.now();
291
- addSession(db, { id: "sess_5", title: "New session", timeCreated: now - 2000, timeUpdated: now });
292
- addMessage(db, "sess_5", "msg_1", "user", now - 1000);
293
- addTextPart(db, "sess_5", "msg_1", "implement the feature");
294
- db.close();
295
-
296
- const adapter = new OpenCodeAdapter({ dbPath });
297
- const chunk = await adapter.parseSession("sess_5");
298
- expect(chunk!.label).toBe("implement the feature");
299
- });
300
-
301
- it("sets sourcePath to dbPath::sessionId", async () => {
302
- const now = Date.now();
303
- addSession(db, { id: "sess_6", timeCreated: now - 1000, timeUpdated: now });
304
- addMessage(db, "sess_6", "msg_1", "user", now - 500);
305
- addTextPart(db, "sess_6", "msg_1", "hello");
306
- db.close();
307
-
308
- const adapter = new OpenCodeAdapter({ dbPath });
309
- const chunk = await adapter.parseSession("sess_6");
310
- expect(chunk!.sourcePath).toBe(`${dbPath}::sess_6`);
311
- });
312
-
313
- it("sets projectDir from session directory column", async () => {
314
- const now = Date.now();
315
- addSession(db, { id: "sess_7", directory: "/home/user/myproject", timeCreated: now - 1000, timeUpdated: now });
316
- addMessage(db, "sess_7", "msg_1", "user", now - 500);
317
- addTextPart(db, "sess_7", "msg_1", "hello");
318
- db.close();
319
-
320
- const adapter = new OpenCodeAdapter({ dbPath });
321
- const chunk = await adapter.parseSession("sess_7");
322
- expect(chunk!.projectDir).toBe("/home/user/myproject");
323
- });
324
-
325
- it("returns null when DB is absent", async () => {
326
- db.close();
327
- const adapter = new OpenCodeAdapter({ dbPath: join(tmp, "absent.db") });
328
- expect(await adapter.parseSession("any")).toBeNull();
329
- });
330
-
331
- it("timestamps are ISO strings", async () => {
332
- const now = Date.now();
333
- addSession(db, { id: "sess_8", timeCreated: now - 5000, timeUpdated: now });
334
- addMessage(db, "sess_8", "msg_1", "user", now - 4000);
335
- addTextPart(db, "sess_8", "msg_1", "hello");
336
- db.close();
337
-
338
- const adapter = new OpenCodeAdapter({ dbPath });
339
- const chunk = await adapter.parseSession("sess_8");
340
- expect(chunk!.startedAt).toMatch(/T/);
341
- expect(chunk!.endedAt).toMatch(/T/);
342
- });
343
- });
344
-
345
- // ── runtime metadata ──────────────────────────────────────────────────────────
346
-
347
- describe("OpenCodeAdapter metadata", () => {
348
- it("has the correct name, runtimeVersion, and transcriptKind", () => {
349
- const adapter = new OpenCodeAdapter({ dbPath });
350
- expect(adapter.name).toBe("opencode");
351
- expect(adapter.runtimeVersion).toBe("opencode/1.0");
352
- expect(adapter.transcriptKind).toBe("opencode-sqlite");
353
- });
354
- });
@@ -1,110 +0,0 @@
1
- /**
2
- * PiAdapter parity tests. Mirrors test_adapter_pi.py — parser-only slice
3
- * (scan_once + record_classified are Phase D Scheduler work).
4
- */
5
-
6
- import { copyFileSync, mkdtempSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
7
- import { tmpdir } from "node:os";
8
- import { basename, join, resolve } from "node:path";
9
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
10
- import { PiAdapter } from "../../../../src/core/adapters/pi.js";
11
-
12
- const FIXTURES = resolve(__dirname, "../../../fixtures/pi");
13
-
14
- function stem(p: string): string {
15
- return basename(p, ".jsonl");
16
- }
17
-
18
- describe("PiAdapter.parseSession — successful session", () => {
19
- const adapter = new PiAdapter({ sessionsPath: FIXTURES });
20
-
21
- it("short-successful: 2 turns, pi/1.0 runtime, ISO timestamps, pi_ id prefix", async () => {
22
- const chunk = await adapter.parseSession(`${FIXTURES}/short-successful.jsonl`);
23
- expect(chunk).not.toBeNull();
24
- if (!chunk) return;
25
- expect(chunk.runtime).toBe("pi/1.0");
26
- expect(chunk.id.startsWith("pi_")).toBe(true);
27
- expect(chunk.startedAt).toBeTruthy();
28
- expect(chunk.endedAt).toBeTruthy();
29
- expect(chunk.startedAt).toMatch(/T/);
30
- expect(chunk.turnCount).toBe(2);
31
- expect(chunk.label).toBeTruthy();
32
- });
33
-
34
- it("short-successful: project_dir populated from session-event cwd", async () => {
35
- const chunk = await adapter.parseSession(`${FIXTURES}/short-successful.jsonl`);
36
- expect(chunk?.projectDir).toBe("/private/tmp");
37
- });
38
- });
39
-
40
- describe("PiAdapter.parseSession — aborted session", () => {
41
- const adapter = new PiAdapter({ sessionsPath: FIXTURES });
42
-
43
- it("error-connection-abort: still ingests; user turn carries content", async () => {
44
- const chunk = await adapter.parseSession(`${FIXTURES}/error-connection-abort.jsonl`);
45
- expect(chunk).not.toBeNull();
46
- if (!chunk) return;
47
- expect(chunk.runtime).toBe("pi/1.0");
48
- expect(chunk.id.startsWith("pi_")).toBe(true);
49
- expect(chunk.turnCount).toBeGreaterThanOrEqual(1);
50
- expect(chunk.label).toBeTruthy();
51
- });
52
-
53
- it("error session is flagged via gitBranch='aborted' sentinel", async () => {
54
- const chunk = await adapter.parseSession(`${FIXTURES}/error-connection-abort.jsonl`);
55
- expect(chunk?.gitBranch).toBe("aborted");
56
- });
57
- });
58
-
59
- describe("PiAdapter.parseSession — custom_message excluded", () => {
60
- const adapter = new PiAdapter({ sessionsPath: FIXTURES });
61
-
62
- it("with-custom-message: custom_message events do not count as turns", async () => {
63
- const chunk = await adapter.parseSession(`${FIXTURES}/with-custom-message.jsonl`);
64
- expect(chunk).not.toBeNull();
65
- if (!chunk) return;
66
- expect(chunk.turnCount).toBe(2); // user + assistant only
67
- });
68
- });
69
-
70
- describe("PiAdapter.discover", () => {
71
- it("finds all 3 fixtures", async () => {
72
- const adapter = new PiAdapter({ sessionsPath: FIXTURES });
73
- const found = await adapter.discover();
74
- const stems = new Set(found.map(stem));
75
- expect(stems).toEqual(
76
- new Set(["short-successful", "error-connection-abort", "with-custom-message"]),
77
- );
78
- });
79
-
80
- it("skips zero-byte files", async () => {
81
- const tmp = mkdtempSync(join(tmpdir(), "pi-"));
82
- copyFileSync(
83
- `${FIXTURES}/short-successful.jsonl`,
84
- join(tmp, "real.jsonl"),
85
- );
86
- writeFileSync(join(tmp, "empty.jsonl"), "");
87
-
88
- const adapter = new PiAdapter({ sessionsPath: tmp });
89
- const found = await adapter.discover();
90
- const stems = new Set(found.map(stem));
91
- expect(stems.has("empty")).toBe(false);
92
- expect(stems.has("real")).toBe(true);
93
- rmSync(tmp, { recursive: true, force: true });
94
- });
95
-
96
- it("walks subdirectories recursively (<sessions>/<cwd-slug>/<file>.jsonl)", async () => {
97
- const tmp = mkdtempSync(join(tmpdir(), "pi-nested-"));
98
- const slug = join(tmp, "private-tmp");
99
- mkdirSync(slug);
100
- copyFileSync(
101
- `${FIXTURES}/short-successful.jsonl`,
102
- join(slug, "nested.jsonl"),
103
- );
104
- const adapter = new PiAdapter({ sessionsPath: tmp });
105
- const found = await adapter.discover();
106
- expect(found).toHaveLength(1);
107
- expect(found[0]).toContain("private-tmp");
108
- rmSync(tmp, { recursive: true, force: true });
109
- });
110
- });