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