nlm-memory 0.5.0 → 0.5.2

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 (257) hide show
  1. package/README.md +89 -34
  2. package/dist/cli/digest.d.ts +20 -0
  3. package/dist/cli/digest.js +142 -0
  4. package/dist/cli/digest.js.map +1 -0
  5. package/dist/cli/nlm.d.ts +1 -0
  6. package/dist/cli/nlm.js +25 -1
  7. package/dist/cli/nlm.js.map +1 -1
  8. package/dist/core/digest/compose.d.ts +38 -0
  9. package/dist/core/digest/compose.js +93 -0
  10. package/dist/core/digest/compose.js.map +1 -0
  11. package/dist/core/digest/hook-liveness.d.ts +32 -0
  12. package/dist/core/digest/hook-liveness.js +54 -0
  13. package/dist/core/digest/hook-liveness.js.map +1 -0
  14. package/dist/http/app.js +2 -1
  15. package/dist/http/app.js.map +1 -1
  16. package/dist/mcp/server.js +20 -1
  17. package/dist/mcp/server.js.map +1 -1
  18. package/dist/ui/assets/{index-C8cpwbYJ.css → index-Beo8psd-.css} +1 -1
  19. package/dist/ui/assets/{index-CB50QnL-.js → index-CSPTTeeM.js} +8 -8
  20. package/dist/ui/index.html +2 -2
  21. package/package.json +26 -1
  22. package/.agents/plugins/marketplace.json +0 -20
  23. package/.github/workflows/ci.yml +0 -30
  24. package/docs/methodology/re-derivation-rate.md +0 -112
  25. package/docs/methodology/useful-hit-rate.md +0 -79
  26. package/docs/plans/2026-05-20-fts5-lexical-recall.md +0 -1088
  27. package/docs/plans/2026-05-20-recall-daemon-wedge-fix.md +0 -662
  28. package/docs/plans/2026-05-20-recall-hook-design.md +0 -131
  29. package/docs/plans/2026-05-20-recall-hook-implementation.md +0 -1222
  30. package/docs/plans/desktop-product.md +0 -69
  31. package/docs/plans/factstore-design.md +0 -236
  32. package/logs/CHANGELOG/CHANGELOG-2026.md +0 -1575
  33. package/logs/CHANGELOG/CHANGELOG.md +0 -209
  34. package/migrations/000_initial_schema.sql +0 -174
  35. package/migrations/001_entity_type_rename.sql +0 -17
  36. package/migrations/002_adapter_state_extend.sql +0 -12
  37. package/migrations/003_session_embeddings.sql +0 -11
  38. package/migrations/004_facts.sql +0 -46
  39. package/migrations/005_sources.sql +0 -31
  40. package/migrations/006_providers.sql +0 -33
  41. package/migrations/007_source_tokens.sql +0 -17
  42. package/migrations/008_fts_rebuild.sql +0 -9
  43. package/migrations/009_session_embedding_chunks.sql +0 -46
  44. package/migrations/010_sources_opencode.sql +0 -30
  45. package/migrations/011_sources_hermes_agent.sql +0 -30
  46. package/migrations/012_sources_aider.sql +0 -30
  47. package/migrations/013_adapter_state_failure_count.sql +0 -12
  48. package/migrations/014_sources_cursor.sql +0 -30
  49. package/migrations/015_sources_windsurf.sql +0 -30
  50. package/plugin-hermes-agent/README.md +0 -49
  51. package/plugin-hermes-agent/__init__.py +0 -75
  52. package/plugin-hermes-agent/plugin.yaml +0 -15
  53. package/scripts/backfill-citations.mjs +0 -0
  54. package/scripts/build-codex-plugin.mjs +0 -61
  55. package/scripts/deepseek-probe.mjs +0 -67
  56. package/scripts/extract-triples.mjs +0 -207
  57. package/scripts/longmemeval/embedding-cache.ts +0 -77
  58. package/scripts/longmemeval/fetch-dataset.sh +0 -25
  59. package/scripts/longmemeval/run-harness.ts +0 -315
  60. package/scripts/longmemeval/scorer.ts +0 -99
  61. package/scripts/longmemeval/tsconfig.json +0 -9
  62. package/scripts/longmemeval/types.ts +0 -35
  63. package/scripts/nlm-daily-digest.py +0 -239
  64. package/scripts/nlm-daily-digest.sh +0 -28
  65. package/src/cli/classify-parity.ts +0 -257
  66. package/src/cli/launchctl-helpers.ts +0 -49
  67. package/src/cli/nlm.ts +0 -1078
  68. package/src/core/actions/actions-log.ts +0 -118
  69. package/src/core/actions/overlay.ts +0 -117
  70. package/src/core/adapters/aider.ts +0 -205
  71. package/src/core/adapters/claude-code.ts +0 -293
  72. package/src/core/adapters/common.ts +0 -54
  73. package/src/core/adapters/cursor.ts +0 -486
  74. package/src/core/adapters/from-source.ts +0 -67
  75. package/src/core/adapters/hermes-agent.ts +0 -240
  76. package/src/core/adapters/hermes.ts +0 -277
  77. package/src/core/adapters/jsonl-generic.ts +0 -208
  78. package/src/core/adapters/opencode.ts +0 -281
  79. package/src/core/adapters/pi.ts +0 -264
  80. package/src/core/adapters/windsurf.ts +0 -386
  81. package/src/core/classifier/prompt.ts +0 -200
  82. package/src/core/dataset/build-dataset.ts +0 -463
  83. package/src/core/embedding/chunk-body.ts +0 -76
  84. package/src/core/embedding/embed-backfill.ts +0 -210
  85. package/src/core/embedding/embed-normalize.ts +0 -135
  86. package/src/core/facts/backfill-facts.ts +0 -254
  87. package/src/core/facts/extract-facts.ts +0 -50
  88. package/src/core/hook/citation-detect.ts +0 -124
  89. package/src/core/hook/cite-memo.ts +0 -68
  90. package/src/core/hook/claude-settings.ts +0 -187
  91. package/src/core/hook/gate.ts +0 -25
  92. package/src/core/hook/hook-log.ts +0 -41
  93. package/src/core/hook/memo-sweep.ts +0 -164
  94. package/src/core/hook/memo.ts +0 -67
  95. package/src/core/hook/pointer-block.ts +0 -26
  96. package/src/core/hook/select.ts +0 -32
  97. package/src/core/hook/transcript.ts +0 -121
  98. package/src/core/ingest/ingest-session.ts +0 -111
  99. package/src/core/providers/provider-models.ts +0 -100
  100. package/src/core/providers/provider-registry.ts +0 -196
  101. package/src/core/recall/citation-log.ts +0 -108
  102. package/src/core/recall/filter.ts +0 -27
  103. package/src/core/recall/index.ts +0 -6
  104. package/src/core/recall/match-fields.ts +0 -40
  105. package/src/core/recall/query-log.ts +0 -149
  106. package/src/core/recall/query-shape.ts +0 -66
  107. package/src/core/recall/recall-service.ts +0 -320
  108. package/src/core/recall/recent-log.ts +0 -59
  109. package/src/core/recall/tokenize.ts +0 -18
  110. package/src/core/recall/useful-scan.ts +0 -336
  111. package/src/core/recall-facts/fact-query-log.ts +0 -150
  112. package/src/core/recall-facts/fact-recall-service.ts +0 -327
  113. package/src/core/scheduler/scan-once.ts +0 -142
  114. package/src/core/scheduler/scheduler.ts +0 -225
  115. package/src/core/sources/source-registry.ts +0 -278
  116. package/src/core/storage/db-restore.ts +0 -133
  117. package/src/core/storage/live-status.ts +0 -45
  118. package/src/core/storage/migrate.ts +0 -72
  119. package/src/core/storage/sqlite-fact-store.ts +0 -304
  120. package/src/core/storage/sqlite-session-store.ts +0 -810
  121. package/src/hook/hook-auth.ts +0 -18
  122. package/src/hook/prompt-recall-hook.ts +0 -180
  123. package/src/hook/session-end-hook.ts +0 -81
  124. package/src/hook/session-start-hook.ts +0 -168
  125. package/src/hook/stop-hook.ts +0 -239
  126. package/src/http/app.ts +0 -1215
  127. package/src/install/claude-code.ts +0 -128
  128. package/src/install/codex.ts +0 -367
  129. package/src/install/cursor.ts +0 -68
  130. package/src/install/hermes-agent.ts +0 -76
  131. package/src/install/hermes.ts +0 -78
  132. package/src/install/nlm-dir-perms.ts +0 -55
  133. package/src/install/ollama.ts +0 -284
  134. package/src/install/setup.ts +0 -489
  135. package/src/install/windsurf.ts +0 -68
  136. package/src/llm/classifier-box.ts +0 -64
  137. package/src/llm/deepseek-client.ts +0 -150
  138. package/src/llm/env-autoload.ts +0 -55
  139. package/src/llm/ollama-client.ts +0 -189
  140. package/src/mcp/server.ts +0 -534
  141. package/src/ports/fact-store.ts +0 -102
  142. package/src/ports/llm-client.ts +0 -52
  143. package/src/ports/logger.ts +0 -16
  144. package/src/ports/session-store.ts +0 -45
  145. package/src/ports/transcript-adapter.ts +0 -55
  146. package/src/shared/types.ts +0 -149
  147. package/src/ui/App.tsx +0 -58
  148. package/src/ui/components/PromoteOpenButton.tsx +0 -65
  149. package/src/ui/components/SessionDrawer.tsx +0 -199
  150. package/src/ui/components/SideNav.tsx +0 -162
  151. package/src/ui/components/Skeleton.tsx +0 -107
  152. package/src/ui/index.html +0 -13
  153. package/src/ui/lib/actions.ts +0 -30
  154. package/src/ui/lib/api.ts +0 -92
  155. package/src/ui/lib/dataset.ts +0 -141
  156. package/src/ui/lib/registries.ts +0 -155
  157. package/src/ui/lib/view-settings.ts +0 -41
  158. package/src/ui/main.tsx +0 -15
  159. package/src/ui/pages/Live.tsx +0 -229
  160. package/src/ui/pages/Pulse.tsx +0 -415
  161. package/src/ui/pages/Recall.tsx +0 -190
  162. package/src/ui/pages/River.tsx +0 -354
  163. package/src/ui/pages/Search.tsx +0 -386
  164. package/src/ui/pages/Stub.tsx +0 -9
  165. package/src/ui/pages/Thread.tsx +0 -473
  166. package/src/ui/pages/settings/Classifier.tsx +0 -227
  167. package/src/ui/pages/settings/Data.tsx +0 -190
  168. package/src/ui/pages/settings/Index.tsx +0 -65
  169. package/src/ui/pages/settings/Labels.tsx +0 -224
  170. package/src/ui/pages/settings/Providers.tsx +0 -305
  171. package/src/ui/pages/settings/SettingsSubnav.tsx +0 -28
  172. package/src/ui/pages/settings/Sources.tsx +0 -326
  173. package/src/ui/pages/settings/Views.tsx +0 -96
  174. package/src/ui/styles.css +0 -1890
  175. package/src/ui/tsconfig.json +0 -21
  176. package/src/ui/vite.config.ts +0 -19
  177. package/tests/fixtures/claude_code/short_session.jsonl +0 -2
  178. package/tests/fixtures/claude_code/standard_iso.jsonl +0 -4
  179. package/tests/fixtures/claude_code/tool_heavy.jsonl +0 -8
  180. package/tests/fixtures/claude_code/with_subagent.jsonl +0 -7
  181. package/tests/fixtures/facts.ts +0 -17
  182. package/tests/fixtures/golden-corpus.ts +0 -85
  183. package/tests/fixtures/hermes/paired_request_dump.json +0 -24
  184. package/tests/fixtures/hermes/paired_session.json +0 -23
  185. package/tests/fixtures/hermes/request_dump.json +0 -28
  186. package/tests/fixtures/hermes/session_iso.json +0 -38
  187. package/tests/fixtures/hermes/session_unix.json +0 -38
  188. package/tests/fixtures/hermes/system_only.json +0 -18
  189. package/tests/fixtures/pi/error-connection-abort.jsonl +0 -8
  190. package/tests/fixtures/pi/short-successful.jsonl +0 -5
  191. package/tests/fixtures/pi/with-custom-message.jsonl +0 -6
  192. package/tests/fixtures/sessions.ts +0 -22
  193. package/tests/integration/backfill-facts.test.ts +0 -362
  194. package/tests/integration/citation-explicit.test.ts +0 -111
  195. package/tests/integration/cite-event.test.ts +0 -169
  196. package/tests/integration/cite-memo.test.ts +0 -87
  197. package/tests/integration/db-restore.test.ts +0 -153
  198. package/tests/integration/embed-backfill.test.ts +0 -176
  199. package/tests/integration/fact-supersedence.test.ts +0 -313
  200. package/tests/integration/fts-index.test.ts +0 -60
  201. package/tests/integration/getbyids-sqlite.test.ts +0 -100
  202. package/tests/integration/hermes-agent-hooks.test.ts +0 -248
  203. package/tests/integration/hook-claude-settings.test.ts +0 -218
  204. package/tests/integration/hook-log.test.ts +0 -54
  205. package/tests/integration/hook-memo.test.ts +0 -68
  206. package/tests/integration/hook-pre-compact.test.ts +0 -105
  207. package/tests/integration/hook-subagent-start.test.ts +0 -102
  208. package/tests/integration/http.test.ts +0 -401
  209. package/tests/integration/keyword-search-fts.test.ts +0 -66
  210. package/tests/integration/mcp-recall-logging.test.ts +0 -88
  211. package/tests/integration/mcp.test.ts +0 -260
  212. package/tests/integration/memo-sweep.test.ts +0 -91
  213. package/tests/integration/prompt-recall-hook.test.ts +0 -88
  214. package/tests/integration/provider-registry.test.ts +0 -107
  215. package/tests/integration/recall-golden.test.ts +0 -59
  216. package/tests/integration/recall-sqlite.test.ts +0 -169
  217. package/tests/integration/scheduler.test.ts +0 -391
  218. package/tests/integration/session-end-hook.test.ts +0 -48
  219. package/tests/integration/session-start-hook.test.ts +0 -126
  220. package/tests/integration/source-registry.test.ts +0 -122
  221. package/tests/integration/sqlite-fact-store.test.ts +0 -346
  222. package/tests/integration/stop-hook.test.ts +0 -560
  223. package/tests/integration/wal-checkpoint.test.ts +0 -49
  224. package/tests/unit/cli/launchctl-helpers.test.ts +0 -60
  225. package/tests/unit/core/adapters/aider.test.ts +0 -230
  226. package/tests/unit/core/adapters/claude-code.test.ts +0 -118
  227. package/tests/unit/core/adapters/cursor.test.ts +0 -485
  228. package/tests/unit/core/adapters/hermes-agent.test.ts +0 -329
  229. package/tests/unit/core/adapters/hermes.test.ts +0 -81
  230. package/tests/unit/core/adapters/jsonl-generic.test.ts +0 -142
  231. package/tests/unit/core/adapters/opencode.test.ts +0 -354
  232. package/tests/unit/core/adapters/pi.test.ts +0 -110
  233. package/tests/unit/core/adapters/windsurf.test.ts +0 -416
  234. package/tests/unit/core/classifier/prompt.test.ts +0 -126
  235. package/tests/unit/core/embedding/chunk-body.test.ts +0 -100
  236. package/tests/unit/core/facts/extract-facts.test.ts +0 -117
  237. package/tests/unit/core/filter.test.ts +0 -40
  238. package/tests/unit/core/hook/citation-detect-cite-session.test.ts +0 -96
  239. package/tests/unit/core/hook/citation-detect.test.ts +0 -124
  240. package/tests/unit/core/hook/gate.test.ts +0 -29
  241. package/tests/unit/core/hook/pointer-block.test.ts +0 -22
  242. package/tests/unit/core/hook/select.test.ts +0 -66
  243. package/tests/unit/core/match-fields.test.ts +0 -39
  244. package/tests/unit/core/mcp-cite-session.test.ts +0 -51
  245. package/tests/unit/core/providers/provider-models.test.ts +0 -101
  246. package/tests/unit/core/query-shape.test.ts +0 -92
  247. package/tests/unit/core/recall-facts/fact-recall-service.test.ts +0 -258
  248. package/tests/unit/core/recall-service.test.ts +0 -200
  249. package/tests/unit/core/storage/live-status.test.ts +0 -54
  250. package/tests/unit/core/tokenize.test.ts +0 -32
  251. package/tests/unit/core/useful-scan.test.ts +0 -537
  252. package/tests/unit/llm/embed.test.ts +0 -93
  253. package/tests/unit/llm/ollama-client.test.ts +0 -124
  254. package/tests/unit/scripts/longmemeval-scorer.test.ts +0 -114
  255. package/tsconfig.json +0 -31
  256. package/tsconfig.test.json +0 -11
  257. package/vitest.config.ts +0 -22
@@ -1,485 +0,0 @@
1
- /**
2
- * CursorAdapter unit tests.
3
- *
4
- * Each test builds an in-memory SQLite DB seeded with the cursorDiskKV
5
- * key-value schema Cursor uses, writes it to a temp file so the adapter
6
- * can open it with better-sqlite3 in readonly mode.
7
- */
8
-
9
- import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
10
- import { tmpdir } from "node:os";
11
- import { dirname, join } from "node:path";
12
- import Database from "better-sqlite3";
13
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
14
- import { CursorAdapter } from "../../../../src/core/adapters/cursor.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 cursorDiskKV (
22
- key TEXT PRIMARY KEY,
23
- value TEXT
24
- );
25
- `);
26
- return db;
27
- }
28
-
29
- function addComposerInline(
30
- db: Database.Database,
31
- composerId: string,
32
- opts: {
33
- name?: string;
34
- createdAt?: string;
35
- lastUpdatedAt?: string;
36
- conversation?: Array<{ type: number; text: string }>;
37
- } = {},
38
- ): void {
39
- const data = {
40
- composerId,
41
- name: opts.name ?? "Test session",
42
- createdAt: opts.createdAt ?? new Date(Date.now() - 3600_000).toISOString(),
43
- lastUpdatedAt: opts.lastUpdatedAt ?? new Date().toISOString(),
44
- conversation: opts.conversation ?? [],
45
- };
46
- db.prepare(`INSERT INTO cursorDiskKV (key, value) VALUES (?, ?)`).run(
47
- `composerData:${composerId}`,
48
- JSON.stringify(data),
49
- );
50
- }
51
-
52
- function addBubble(
53
- db: Database.Database,
54
- composerId: string,
55
- bubbleId: string,
56
- type: 1 | 2,
57
- text: string,
58
- ): void {
59
- const data = { type, text };
60
- db.prepare(`INSERT INTO cursorDiskKV (key, value) VALUES (?, ?)`).run(
61
- `bubbleId:${composerId}:${bubbleId}`,
62
- JSON.stringify(data),
63
- );
64
- }
65
-
66
- // ── Workspace helpers ─────────────────────────────────────────────────────────
67
-
68
- const CHAT_KEY = "workbench.panel.aichat.view.aichat.chatdata";
69
-
70
- function createWorkspaceDb(path: string): Database.Database {
71
- mkdirSync(dirname(path), { recursive: true });
72
- const db = new Database(path);
73
- db.exec(`CREATE TABLE IF NOT EXISTS ItemTable (key TEXT PRIMARY KEY, value TEXT);`);
74
- return db;
75
- }
76
-
77
- function addWorkspaceComposer(
78
- db: Database.Database,
79
- composerId: string,
80
- opts: { name?: string; createdAt?: string; lastUpdatedAt?: string; conversation?: Array<{ type: number; text: string }> } = {},
81
- ): void {
82
- const allComposers = [{ composerId, name: opts.name ?? "ws composer", createdAt: opts.createdAt, lastUpdatedAt: opts.lastUpdatedAt, conversation: opts.conversation ?? [] }];
83
- db.prepare(`INSERT OR REPLACE INTO ItemTable (key, value) VALUES (?, ?)`).run(
84
- "composer.composerData",
85
- JSON.stringify({ allComposers }),
86
- );
87
- }
88
-
89
- function addWorkspaceChatTab(
90
- db: Database.Database,
91
- tabs: Array<{ tabId: string; chatTitle?: string; lastSendTime?: number; bubbles?: Array<{ type: "user" | "ai"; text?: string }> }>,
92
- ): void {
93
- db.prepare(`INSERT OR REPLACE INTO ItemTable (key, value) VALUES (?, ?)`).run(
94
- CHAT_KEY,
95
- JSON.stringify({ tabs }),
96
- );
97
- }
98
-
99
- // ── Test setup ────────────────────────────────────────────────────────────────
100
-
101
- let tmp: string;
102
- let dbPath: string;
103
- let adapter: CursorAdapter;
104
-
105
- beforeEach(() => {
106
- tmp = mkdtempSync(join(tmpdir(), "nlm-cursor-"));
107
- // globalStorage/state.vscdb — adapter derives workspaceStorage from its parent's parent
108
- dbPath = join(tmp, "globalStorage", "state.vscdb");
109
- mkdirSync(dirname(dbPath), { recursive: true });
110
- adapter = new CursorAdapter({ dbPath });
111
- });
112
-
113
- afterEach(() => {
114
- rmSync(tmp, { recursive: true, force: true });
115
- });
116
-
117
- // ── detect() ─────────────────────────────────────────────────────────────────
118
-
119
- describe("detect()", () => {
120
- it("returns enabled when DB exists", () => {
121
- const db = createDb(dbPath);
122
- db.close();
123
- const result = adapter.detect();
124
- expect(result.enabled).toBe(true);
125
- expect(result.path).toBe(dbPath);
126
- expect(result.hint).toBeNull();
127
- });
128
-
129
- it("returns disabled when DB is absent", () => {
130
- const result = adapter.detect();
131
- expect(result.enabled).toBe(false);
132
- expect(result.path).toBeNull();
133
- expect(result.hint).toMatch(/Cursor/);
134
- });
135
- });
136
-
137
- // ── discover() ───────────────────────────────────────────────────────────────
138
-
139
- describe("discover()", () => {
140
- it("returns empty array when DB is absent", async () => {
141
- expect(await adapter.discover()).toEqual([]);
142
- });
143
-
144
- it("returns prefixed composerIds for all composer entries", async () => {
145
- const db = createDb(dbPath);
146
- addComposerInline(db, "composer-aaa");
147
- addComposerInline(db, "composer-bbb");
148
- db.close();
149
-
150
- const ids = await adapter.discover();
151
- expect(ids).toEqual(["cr_composer-aaa", "cr_composer-bbb"]);
152
- });
153
-
154
- it("returns empty array when DB has no cursorDiskKV table", async () => {
155
- const db = new Database(dbPath);
156
- db.exec(`CREATE TABLE ItemTable (key TEXT, value TEXT);`);
157
- db.close();
158
- expect(await adapter.discover()).toEqual([]);
159
- });
160
-
161
- it("skips entries whose value is not valid JSON", async () => {
162
- const db = createDb(dbPath);
163
- db.prepare(`INSERT INTO cursorDiskKV (key, value) VALUES (?, ?)`).run(
164
- "composerData:broken",
165
- "not-json",
166
- );
167
- addComposerInline(db, "composer-good");
168
- db.close();
169
-
170
- const ids = await adapter.discover();
171
- expect(ids).toEqual(["cr_composer-good"]);
172
- });
173
-
174
- it("filters by since when lastUpdatedAt is set", async () => {
175
- const db = createDb(dbPath);
176
- const old = new Date(Date.now() - 10 * 24 * 3600_000).toISOString();
177
- const recent = new Date().toISOString();
178
- addComposerInline(db, "old-composer", { lastUpdatedAt: old });
179
- addComposerInline(db, "new-composer", { lastUpdatedAt: recent });
180
- db.close();
181
-
182
- const cutoff = new Date(Date.now() - 5 * 24 * 3600_000);
183
- const ids = await adapter.discover({ since: cutoff });
184
- expect(ids).toEqual(["cr_new-composer"]);
185
- });
186
- });
187
-
188
- // ── parseSession() ────────────────────────────────────────────────────────────
189
-
190
- describe("parseSession()", () => {
191
- it("returns null when DB is absent", async () => {
192
- expect(await adapter.parseSession("any-id")).toBeNull();
193
- });
194
-
195
- it("returns null for unknown composerId", async () => {
196
- const db = createDb(dbPath);
197
- db.close();
198
- expect(await adapter.parseSession("ghost-id")).toBeNull();
199
- });
200
-
201
- it("returns null for composer with no turns", async () => {
202
- const db = createDb(dbPath);
203
- addComposerInline(db, "empty-id", { conversation: [] });
204
- db.close();
205
- expect(await adapter.parseSession("empty-id")).toBeNull();
206
- });
207
-
208
- it("extracts turns from inline conversation[]", async () => {
209
- const db = createDb(dbPath);
210
- addComposerInline(db, "inline-id", {
211
- name: "My session",
212
- conversation: [
213
- { type: 1, text: "Hello" },
214
- { type: 2, text: "Hi there" },
215
- ],
216
- });
217
- db.close();
218
-
219
- const chunk = await adapter.parseSession("inline-id");
220
- expect(chunk).not.toBeNull();
221
- expect(chunk!.turnCount).toBe(2);
222
- expect(chunk!.text).toContain("user: Hello");
223
- expect(chunk!.text).toContain("assistant: Hi there");
224
- });
225
-
226
- it("falls back to bubbleId:* separate storage when conversation is empty", async () => {
227
- const db = createDb(dbPath);
228
- addComposerInline(db, "sep-id", { conversation: [] });
229
- addBubble(db, "sep-id", "b1", 1, "What is 2+2?");
230
- addBubble(db, "sep-id", "b2", 2, "It is 4.");
231
- db.close();
232
-
233
- const chunk = await adapter.parseSession("sep-id");
234
- expect(chunk).not.toBeNull();
235
- expect(chunk!.turnCount).toBe(2);
236
- expect(chunk!.text).toContain("user: What is 2+2?");
237
- expect(chunk!.text).toContain("assistant: It is 4.");
238
- });
239
-
240
- it("uses composer name as label", async () => {
241
- const db = createDb(dbPath);
242
- addComposerInline(db, "named-id", {
243
- name: "Refactor the auth module",
244
- conversation: [{ type: 1, text: "Let's refactor" }],
245
- });
246
- db.close();
247
-
248
- const chunk = await adapter.parseSession("named-id");
249
- expect(chunk!.label).toBe("Refactor the auth module");
250
- });
251
-
252
- it("falls back to first user turn as label when name is absent", async () => {
253
- const db = createDb(dbPath);
254
- const data = {
255
- composerId: "unlabeled-id",
256
- createdAt: new Date().toISOString(),
257
- lastUpdatedAt: new Date().toISOString(),
258
- conversation: [
259
- { type: 1, text: "Tell me about TypeScript generics" },
260
- { type: 2, text: "Generics allow..." },
261
- ],
262
- };
263
- db.prepare(`INSERT INTO cursorDiskKV (key, value) VALUES (?, ?)`).run(
264
- "composerData:unlabeled-id",
265
- JSON.stringify(data),
266
- );
267
- db.close();
268
-
269
- const chunk = await adapter.parseSession("unlabeled-id");
270
- expect(chunk!.label).toBe("Tell me about TypeScript generics");
271
- });
272
-
273
- it("sets correct id prefix and runtimeSessionId", async () => {
274
- const db = createDb(dbPath);
275
- addComposerInline(db, "id-check", {
276
- conversation: [{ type: 1, text: "Hello" }],
277
- });
278
- db.close();
279
-
280
- const chunk = await adapter.parseSession("id-check");
281
- expect(chunk!.runtimeSessionId).toBe("id-check");
282
- expect(chunk!.id).toMatch(/^cr_/);
283
- });
284
-
285
- it("sets sourcePath to dbPath::composerId", async () => {
286
- const db = createDb(dbPath);
287
- addComposerInline(db, "path-check", {
288
- conversation: [{ type: 1, text: "Hello" }],
289
- });
290
- db.close();
291
-
292
- const chunk = await adapter.parseSession("path-check");
293
- expect(chunk!.sourcePath).toBe(`${dbPath}::path-check`);
294
- });
295
-
296
- it("skips bubbles with empty text", async () => {
297
- const db = createDb(dbPath);
298
- addComposerInline(db, "sparse-id", {
299
- conversation: [
300
- { type: 1, text: "" },
301
- { type: 1, text: "Real question" },
302
- { type: 2, text: "Real answer" },
303
- ],
304
- });
305
- db.close();
306
-
307
- const chunk = await adapter.parseSession("sparse-id");
308
- expect(chunk!.turnCount).toBe(2);
309
- });
310
-
311
- it("skips bubbles with unknown type", async () => {
312
- const db = createDb(dbPath);
313
- const data = {
314
- composerId: "typed-id",
315
- conversation: [
316
- { type: 99, text: "system message" },
317
- { type: 1, text: "user question" },
318
- { type: 2, text: "assistant answer" },
319
- ],
320
- };
321
- db.prepare(`INSERT INTO cursorDiskKV (key, value) VALUES (?, ?)`).run(
322
- "composerData:typed-id",
323
- JSON.stringify(data),
324
- );
325
- db.close();
326
-
327
- const chunk = await adapter.parseSession("typed-id");
328
- expect(chunk!.turnCount).toBe(2);
329
- });
330
-
331
- it("populates byteRange[1] equal to transcript byte length", async () => {
332
- const db = createDb(dbPath);
333
- addComposerInline(db, "bytes-id", {
334
- conversation: [
335
- { type: 1, text: "Hello" },
336
- { type: 2, text: "Hi" },
337
- ],
338
- });
339
- db.close();
340
-
341
- const chunk = await adapter.parseSession("bytes-id");
342
- const expected = Buffer.byteLength(chunk!.text, "utf8");
343
- expect(chunk!.byteRange[1]).toBe(expected);
344
- });
345
- });
346
-
347
- // ── workspace composer (crw_) ─────────────────────────────────────────────────
348
-
349
- describe("workspace composer (crw_)", () => {
350
- function wsDbPath(hash = "ws-hash-1"): string {
351
- return join(tmp, "workspaceStorage", hash, "state.vscdb");
352
- }
353
-
354
- it("discover() returns crw_ ids from workspace ItemTable", async () => {
355
- const db = createWorkspaceDb(wsDbPath());
356
- addWorkspaceComposer(db, "ws-comp-aaa", { conversation: [{ type: 1, text: "hi" }] });
357
- db.close();
358
-
359
- const ids = await adapter.discover();
360
- expect(ids).toContain("crw_ws-comp-aaa");
361
- });
362
-
363
- it("parseSession(crw_<id>) returns chunk from workspace composer", async () => {
364
- const db = createWorkspaceDb(wsDbPath());
365
- addWorkspaceComposer(db, "ws-comp-abc", {
366
- name: "My workspace session",
367
- conversation: [
368
- { type: 1, text: "Fix the bug" },
369
- { type: 2, text: "Done!" },
370
- ],
371
- });
372
- db.close();
373
-
374
- const chunk = await adapter.parseSession("crw_ws-comp-abc");
375
- expect(chunk).not.toBeNull();
376
- expect(chunk!.turnCount).toBe(2);
377
- expect(chunk!.text).toContain("user: Fix the bug");
378
- expect(chunk!.text).toContain("assistant: Done!");
379
- expect(chunk!.label).toBe("My workspace session");
380
- expect(chunk!.id).toMatch(/^crw_/);
381
- expect(chunk!.runtimeSessionId).toBe("ws-comp-abc");
382
- });
383
-
384
- it("parseSession(crw_<id>) returns null when composer has no turns", async () => {
385
- const db = createWorkspaceDb(wsDbPath());
386
- addWorkspaceComposer(db, "empty-ws-comp", { conversation: [] });
387
- db.close();
388
-
389
- expect(await adapter.parseSession("crw_empty-ws-comp")).toBeNull();
390
- });
391
- });
392
-
393
- // ── workspace chat tab (crc_) ─────────────────────────────────────────────────
394
-
395
- describe("workspace chat tab (crc_)", () => {
396
- function wsDbPath(hash = "ws-chat-hash"): string {
397
- return join(tmp, "workspaceStorage", hash, "state.vscdb");
398
- }
399
-
400
- it("discover() returns crc_ ids from workspace chat tab ItemTable", async () => {
401
- const db = createWorkspaceDb(wsDbPath());
402
- addWorkspaceChatTab(db, [
403
- { tabId: "chat-aaa", bubbles: [{ type: "user", text: "Hello" }] },
404
- { tabId: "chat-bbb", bubbles: [{ type: "ai", text: "Hi" }] },
405
- ]);
406
- db.close();
407
-
408
- const ids = await adapter.discover();
409
- expect(ids).toContain("crc_chat-aaa");
410
- expect(ids).toContain("crc_chat-bbb");
411
- });
412
-
413
- it("discover() skips chat tabs with no bubbles", async () => {
414
- const db = createWorkspaceDb(wsDbPath());
415
- addWorkspaceChatTab(db, [
416
- { tabId: "empty-tab", bubbles: [] },
417
- { tabId: "good-tab", bubbles: [{ type: "user", text: "Hi" }] },
418
- ]);
419
- db.close();
420
-
421
- const ids = await adapter.discover();
422
- expect(ids).not.toContain("crc_empty-tab");
423
- expect(ids).toContain("crc_good-tab");
424
- });
425
-
426
- it("discover() filters chat tabs by since using lastSendTime", async () => {
427
- const db = createWorkspaceDb(wsDbPath());
428
- const old = Date.now() - 10 * 24 * 3600_000;
429
- const recent = Date.now();
430
- addWorkspaceChatTab(db, [
431
- { tabId: "old-chat", lastSendTime: old, bubbles: [{ type: "user", text: "Old" }] },
432
- { tabId: "new-chat", lastSendTime: recent, bubbles: [{ type: "user", text: "New" }] },
433
- ]);
434
- db.close();
435
-
436
- const cutoff = new Date(Date.now() - 5 * 24 * 3600_000);
437
- const ids = await adapter.discover({ since: cutoff });
438
- expect(ids).not.toContain("crc_old-chat");
439
- expect(ids).toContain("crc_new-chat");
440
- });
441
-
442
- it("discover() includes chat tab with lastSendTime=0 even when since is set", async () => {
443
- const db = createWorkspaceDb(wsDbPath());
444
- addWorkspaceChatTab(db, [
445
- { tabId: "zero-ts-chat", lastSendTime: 0, bubbles: [{ type: "user", text: "Hi" }] },
446
- ]);
447
- db.close();
448
-
449
- const cutoff = new Date(); // very recent cutoff
450
- const ids = await adapter.discover({ since: cutoff });
451
- expect(ids).toContain("crc_zero-ts-chat");
452
- });
453
-
454
- it("parseSession(crc_<id>) returns chunk from workspace chat tab", async () => {
455
- const db = createWorkspaceDb(wsDbPath());
456
- addWorkspaceChatTab(db, [
457
- {
458
- tabId: "crc-parse-tab",
459
- chatTitle: "Chat test",
460
- bubbles: [
461
- { type: "user", text: "Question" },
462
- { type: "ai", text: "Answer" },
463
- ],
464
- },
465
- ]);
466
- db.close();
467
-
468
- const chunk = await adapter.parseSession("crc_crc-parse-tab");
469
- expect(chunk).not.toBeNull();
470
- expect(chunk!.turnCount).toBe(2);
471
- expect(chunk!.label).toBe("Chat test");
472
- expect(chunk!.id).toMatch(/^crc_/);
473
- expect(chunk!.runtimeSessionId).toBe("crc-parse-tab");
474
- });
475
- });
476
-
477
- // ── metadata ──────────────────────────────────────────────────────────────────
478
-
479
- describe("adapter metadata", () => {
480
- it("has correct name, runtimeVersion, and transcriptKind", () => {
481
- expect(adapter.name).toBe("cursor");
482
- expect(adapter.runtimeVersion).toBe("cursor/1.0");
483
- expect(adapter.transcriptKind).toBe("cursor-sqlite");
484
- });
485
- });