@dirgha/code 1.22.0 → 1.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (272) hide show
  1. package/CHANGELOG.md +171 -0
  2. package/README.md +8 -4
  3. package/dist/auth/keypool.js +40 -26
  4. package/dist/auth/keypool.js.map +1 -1
  5. package/dist/auth/keystore.js +16 -11
  6. package/dist/auth/keystore.js.map +1 -1
  7. package/dist/cli/config.d.ts +36 -5
  8. package/dist/cli/config.js +31 -3
  9. package/dist/cli/config.js.map +1 -1
  10. package/dist/cli/first-run.js +40 -24
  11. package/dist/cli/first-run.js.map +1 -1
  12. package/dist/cli/flows/wizard.js +12 -18
  13. package/dist/cli/flows/wizard.js.map +1 -1
  14. package/dist/cli/interactive.d.ts +4 -0
  15. package/dist/cli/interactive.js +45 -1
  16. package/dist/cli/interactive.js.map +1 -1
  17. package/dist/cli/main.js +69 -18
  18. package/dist/cli/main.js.map +1 -1
  19. package/dist/cli/slash/fleet.js +19 -1
  20. package/dist/cli/slash/fleet.js.map +1 -1
  21. package/dist/cli/slash/index.d.ts +2 -1
  22. package/dist/cli/slash/index.js +3 -1
  23. package/dist/cli/slash/index.js.map +1 -1
  24. package/dist/cli/slash/models.js +4 -2
  25. package/dist/cli/slash/models.js.map +1 -1
  26. package/dist/cli/slash/paste.js +4 -7
  27. package/dist/cli/slash/paste.js.map +1 -1
  28. package/dist/cli/slash/sandbox.d.ts +21 -0
  29. package/dist/cli/slash/sandbox.js +84 -0
  30. package/dist/cli/slash/sandbox.js.map +1 -0
  31. package/dist/cli/slash.d.ts +5 -0
  32. package/dist/cli/slash.js +26 -10
  33. package/dist/cli/slash.js.map +1 -1
  34. package/dist/cli/subcommands/audit.js +28 -8
  35. package/dist/cli/subcommands/audit.js.map +1 -1
  36. package/dist/cli/subcommands/doctor.d.ts +4 -0
  37. package/dist/cli/subcommands/doctor.js +117 -21
  38. package/dist/cli/subcommands/doctor.js.map +1 -1
  39. package/dist/cli/subcommands/feature-setup.js +6 -6
  40. package/dist/cli/subcommands/feature-setup.js.map +1 -1
  41. package/dist/cli/subcommands/memory.js +23 -0
  42. package/dist/cli/subcommands/memory.js.map +1 -1
  43. package/dist/cli/subcommands/telemetry.d.ts +2 -1
  44. package/dist/cli/subcommands/telemetry.js +47 -34
  45. package/dist/cli/subcommands/telemetry.js.map +1 -1
  46. package/dist/context/branch.d.ts +2 -2
  47. package/dist/context/branch.js +40 -23
  48. package/dist/context/branch.js.map +1 -1
  49. package/dist/context/compaction.js +44 -21
  50. package/dist/context/compaction.js.map +1 -1
  51. package/dist/context/default-soul.md +1 -0
  52. package/dist/context/git-state.js +31 -18
  53. package/dist/context/git-state.js.map +1 -1
  54. package/dist/context/knowledge.js +31 -20
  55. package/dist/context/knowledge.js.map +1 -1
  56. package/dist/context/memory.js +8 -1
  57. package/dist/context/memory.js.map +1 -1
  58. package/dist/context/mode-enforcement.js +11 -1
  59. package/dist/context/mode-enforcement.js.map +1 -1
  60. package/dist/context/mode.js +67 -30
  61. package/dist/context/mode.js.map +1 -1
  62. package/dist/context/primer.d.ts +17 -0
  63. package/dist/context/primer.js +50 -3
  64. package/dist/context/primer.js.map +1 -1
  65. package/dist/context/session.d.ts +4 -0
  66. package/dist/context/session.js.map +1 -1
  67. package/dist/embeddings/iface.d.ts +26 -0
  68. package/dist/embeddings/iface.js +15 -0
  69. package/dist/embeddings/iface.js.map +1 -0
  70. package/dist/embeddings/local.d.ts +24 -0
  71. package/dist/embeddings/local.js +112 -0
  72. package/dist/embeddings/local.js.map +1 -0
  73. package/dist/embeddings/remote.d.ts +31 -0
  74. package/dist/embeddings/remote.js +88 -0
  75. package/dist/embeddings/remote.js.map +1 -0
  76. package/dist/embeddings/select.d.ts +24 -0
  77. package/dist/embeddings/select.js +39 -0
  78. package/dist/embeddings/select.js.map +1 -0
  79. package/dist/fleet/apply-back.js +5 -1
  80. package/dist/fleet/apply-back.js.map +1 -1
  81. package/dist/fleet/cli-command.d.ts +2 -0
  82. package/dist/fleet/cli-command.js +15 -1
  83. package/dist/fleet/cli-command.js.map +1 -1
  84. package/dist/fleet/runner.js +35 -2
  85. package/dist/fleet/runner.js.map +1 -1
  86. package/dist/fleet/scratchpad.js +1 -2
  87. package/dist/fleet/scratchpad.js.map +1 -1
  88. package/dist/fleet/state.d.ts +4 -0
  89. package/dist/fleet/state.js +11 -2
  90. package/dist/fleet/state.js.map +1 -1
  91. package/dist/fleet/templates.d.ts +4 -0
  92. package/dist/fleet/templates.js.map +1 -1
  93. package/dist/fleet/types.d.ts +4 -0
  94. package/dist/fleet/types.js.map +1 -1
  95. package/dist/intelligence/failover-chain.js +10 -1
  96. package/dist/intelligence/failover-chain.js.map +1 -1
  97. package/dist/intelligence/prices.d.ts +6 -4
  98. package/dist/intelligence/prices.js +36 -10
  99. package/dist/intelligence/prices.js.map +1 -1
  100. package/dist/kernel/agent-loop.js +60 -17
  101. package/dist/kernel/agent-loop.js.map +1 -1
  102. package/dist/kernel/types.d.ts +3 -0
  103. package/dist/lsp/client.js +29 -16
  104. package/dist/lsp/client.js.map +1 -1
  105. package/dist/lsp/detector.js +7 -6
  106. package/dist/lsp/detector.js.map +1 -1
  107. package/dist/mcp/client.d.ts +1 -1
  108. package/dist/mcp/client.js +19 -16
  109. package/dist/mcp/client.js.map +1 -1
  110. package/dist/mcp/transport.js +46 -38
  111. package/dist/mcp/transport.js.map +1 -1
  112. package/dist/providers/deepseek.js +1 -1
  113. package/dist/providers/deepseek.js.map +1 -1
  114. package/dist/providers/dispatch.js +15 -1
  115. package/dist/providers/dispatch.js.map +1 -1
  116. package/dist/providers/index.d.ts +11 -0
  117. package/dist/providers/index.js +29 -2
  118. package/dist/providers/index.js.map +1 -1
  119. package/dist/providers/nvidia.js +1 -1
  120. package/dist/providers/nvidia.js.map +1 -1
  121. package/dist/providers/openai-compat.js +4 -2
  122. package/dist/providers/openai-compat.js.map +1 -1
  123. package/dist/providers/openrouter.js +1 -1
  124. package/dist/providers/openrouter.js.map +1 -1
  125. package/dist/safety/audit-log.d.ts +15 -0
  126. package/dist/safety/audit-log.js +21 -0
  127. package/dist/safety/audit-log.js.map +1 -1
  128. package/dist/state/db-telemetry.js +11 -1
  129. package/dist/state/db-telemetry.js.map +1 -1
  130. package/dist/state/db.d.ts +7 -0
  131. package/dist/state/db.js +125 -3
  132. package/dist/state/db.js.map +1 -1
  133. package/dist/state/sync-index.d.ts +74 -0
  134. package/dist/state/sync-index.js +246 -0
  135. package/dist/state/sync-index.js.map +1 -0
  136. package/dist/state/transaction.d.ts +62 -0
  137. package/dist/state/transaction.js +65 -0
  138. package/dist/state/transaction.js.map +1 -0
  139. package/dist/state/vec.d.ts +28 -0
  140. package/dist/state/vec.js +113 -0
  141. package/dist/state/vec.js.map +1 -0
  142. package/dist/telemetry/gateway-push.d.ts +17 -0
  143. package/dist/telemetry/gateway-push.js +48 -0
  144. package/dist/telemetry/gateway-push.js.map +1 -0
  145. package/dist/telemetry/index.d.ts +9 -0
  146. package/dist/telemetry/index.js +9 -0
  147. package/dist/telemetry/index.js.map +1 -0
  148. package/dist/tools/browser.js +24 -16
  149. package/dist/tools/browser.js.map +1 -1
  150. package/dist/tools/checkpoint.d.ts +6 -1
  151. package/dist/tools/checkpoint.js +79 -62
  152. package/dist/tools/checkpoint.js.map +1 -1
  153. package/dist/tools/cron.js +1 -3
  154. package/dist/tools/cron.js.map +1 -1
  155. package/dist/tools/db-workspace-info.d.ts +10 -0
  156. package/dist/tools/db-workspace-info.js +76 -0
  157. package/dist/tools/db-workspace-info.js.map +1 -0
  158. package/dist/tools/diff.js +25 -21
  159. package/dist/tools/diff.js.map +1 -1
  160. package/dist/tools/exec.d.ts +6 -1
  161. package/dist/tools/exec.js +46 -4
  162. package/dist/tools/exec.js.map +1 -1
  163. package/dist/tools/fs-edit.d.ts +3 -5
  164. package/dist/tools/fs-edit.js +8 -23
  165. package/dist/tools/fs-edit.js.map +1 -1
  166. package/dist/tools/fs-ls.js +6 -8
  167. package/dist/tools/fs-ls.js.map +1 -1
  168. package/dist/tools/fs-read.d.ts +1 -1
  169. package/dist/tools/fs-read.js +37 -28
  170. package/dist/tools/fs-read.js.map +1 -1
  171. package/dist/tools/fs-write.d.ts +1 -1
  172. package/dist/tools/fs-write.js +33 -33
  173. package/dist/tools/fs-write.js.map +1 -1
  174. package/dist/tools/git.js +12 -6
  175. package/dist/tools/git.js.map +1 -1
  176. package/dist/tools/github.d.ts +13 -0
  177. package/dist/tools/github.js +257 -0
  178. package/dist/tools/github.js.map +1 -0
  179. package/dist/tools/graph-neighbors.d.ts +9 -0
  180. package/dist/tools/graph-neighbors.js +77 -0
  181. package/dist/tools/graph-neighbors.js.map +1 -0
  182. package/dist/tools/graph-traverse.d.ts +10 -0
  183. package/dist/tools/graph-traverse.js +90 -0
  184. package/dist/tools/graph-traverse.js.map +1 -0
  185. package/dist/tools/index.d.ts +10 -2
  186. package/dist/tools/index.js +17 -4
  187. package/dist/tools/index.js.map +1 -1
  188. package/dist/tools/kb-search.d.ts +13 -0
  189. package/dist/tools/kb-search.js +113 -0
  190. package/dist/tools/kb-search.js.map +1 -0
  191. package/dist/tools/multimodal.js +11 -12
  192. package/dist/tools/multimodal.js.map +1 -1
  193. package/dist/tools/registry.d.ts +10 -0
  194. package/dist/tools/registry.js.map +1 -1
  195. package/dist/tools/rtk.js +22 -9
  196. package/dist/tools/rtk.js.map +1 -1
  197. package/dist/tools/search-glob.d.ts +1 -1
  198. package/dist/tools/search-glob.js +42 -24
  199. package/dist/tools/search-glob.js.map +1 -1
  200. package/dist/tools/search-grep.d.ts +1 -1
  201. package/dist/tools/search-grep.js +56 -32
  202. package/dist/tools/search-grep.js.map +1 -1
  203. package/dist/tools/shell.d.ts +7 -1
  204. package/dist/tools/shell.js +178 -61
  205. package/dist/tools/shell.js.map +1 -1
  206. package/dist/tools/transactional-write.d.ts +10 -0
  207. package/dist/tools/transactional-write.js +132 -0
  208. package/dist/tools/transactional-write.js.map +1 -0
  209. package/dist/tui/ink/App.d.ts +2 -1
  210. package/dist/tui/ink/App.js +304 -74
  211. package/dist/tui/ink/App.js.map +1 -1
  212. package/dist/tui/ink/components/DenseToolMessage.js +20 -3
  213. package/dist/tui/ink/components/DenseToolMessage.js.map +1 -1
  214. package/dist/tui/ink/components/InputBox.js +16 -15
  215. package/dist/tui/ink/components/InputBox.js.map +1 -1
  216. package/dist/tui/ink/components/KeySetOverlay.d.ts +1 -1
  217. package/dist/tui/ink/components/KeySetOverlay.js +18 -16
  218. package/dist/tui/ink/components/KeySetOverlay.js.map +1 -1
  219. package/dist/tui/ink/components/Logo.d.ts +20 -0
  220. package/dist/tui/ink/components/Logo.js +67 -1
  221. package/dist/tui/ink/components/Logo.js.map +1 -1
  222. package/dist/tui/ink/components/ModelPicker.d.ts +2 -2
  223. package/dist/tui/ink/components/ModelPicker.js +34 -26
  224. package/dist/tui/ink/components/ModelPicker.js.map +1 -1
  225. package/dist/tui/ink/components/PasteCollapse.d.ts +3 -1
  226. package/dist/tui/ink/components/PasteCollapse.js +11 -9
  227. package/dist/tui/ink/components/PasteCollapse.js.map +1 -1
  228. package/dist/tui/ink/components/SandboxPicker.d.ts +18 -0
  229. package/dist/tui/ink/components/SandboxPicker.js +77 -0
  230. package/dist/tui/ink/components/SandboxPicker.js.map +1 -0
  231. package/dist/tui/ink/components/SpinnerGlyph.d.ts +4 -4
  232. package/dist/tui/ink/components/SpinnerGlyph.js +34 -14
  233. package/dist/tui/ink/components/SpinnerGlyph.js.map +1 -1
  234. package/dist/tui/ink/components/StatusBar.js +0 -2
  235. package/dist/tui/ink/components/StatusBar.js.map +1 -1
  236. package/dist/tui/ink/components/ThinkingBlock.d.ts +15 -4
  237. package/dist/tui/ink/components/ThinkingBlock.js +34 -17
  238. package/dist/tui/ink/components/ThinkingBlock.js.map +1 -1
  239. package/dist/tui/ink/components/ToolBox.js +21 -13
  240. package/dist/tui/ink/components/ToolBox.js.map +1 -1
  241. package/dist/tui/ink/components/VirtualTranscript.d.ts +1 -1
  242. package/dist/tui/ink/components/VirtualTranscript.js +5 -3
  243. package/dist/tui/ink/components/VirtualTranscript.js.map +1 -1
  244. package/dist/tui/ink/index.js +17 -1
  245. package/dist/tui/ink/index.js.map +1 -1
  246. package/dist/tui/ink/markdown/syntax-highlight.d.ts +13 -0
  247. package/dist/tui/ink/markdown/syntax-highlight.js +91 -0
  248. package/dist/tui/ink/markdown/syntax-highlight.js.map +1 -0
  249. package/dist/tui/ink/theme-context.js +6 -3
  250. package/dist/tui/ink/theme-context.js.map +1 -1
  251. package/dist/tui/ink/use-declined-versions.js +6 -2
  252. package/dist/tui/ink/use-declined-versions.js.map +1 -1
  253. package/dist/tui/ink/use-elapsed.d.ts +9 -1
  254. package/dist/tui/ink/use-elapsed.js +17 -2
  255. package/dist/tui/ink/use-elapsed.js.map +1 -1
  256. package/dist/tui/ink/use-event-projection.d.ts +10 -0
  257. package/dist/tui/ink/use-event-projection.js +111 -12
  258. package/dist/tui/ink/use-event-projection.js.map +1 -1
  259. package/dist/tui/ink/use-flicker-detector.js +9 -0
  260. package/dist/tui/ink/use-flicker-detector.js.map +1 -1
  261. package/dist/tui/ink/use-overlays.d.ts +2 -2
  262. package/dist/tui/ink/use-overlays.js +16 -17
  263. package/dist/tui/ink/use-overlays.js.map +1 -1
  264. package/dist/tui/ink/use-render-metrics.js +18 -5
  265. package/dist/tui/ink/use-render-metrics.js.map +1 -1
  266. package/dist/utils/env.d.ts +1 -0
  267. package/dist/utils/env.js +60 -0
  268. package/dist/utils/env.js.map +1 -0
  269. package/dist/utils/fs.d.ts +10 -0
  270. package/dist/utils/fs.js +37 -0
  271. package/dist/utils/fs.js.map +1 -0
  272. package/package.json +10 -7
@@ -19,6 +19,7 @@ let telemetry = {
19
19
  };
20
20
  let warned = false;
21
21
  let loaded = false;
22
+ let firstSuccess = true;
22
23
  async function ensureLoaded() {
23
24
  if (loaded)
24
25
  return;
@@ -65,12 +66,21 @@ export function recordDbError(err) {
65
66
  telemetry.lastErrorTime = new Date().toISOString();
66
67
  if (!warned && telemetry.failedWrites >= 10) {
67
68
  warned = true;
68
- process.stderr.write("[Dirgha] DB writes failing — session data may not persist.\n");
69
+ const suffix = telemetry.lastError
70
+ ? ` (${telemetry.lastError})`
71
+ : "";
72
+ process.stderr.write(`[Dirgha] DB writes failing — session data may not persist.${suffix}\n`);
69
73
  }
70
74
  schedulePersist();
71
75
  }
72
76
  export function recordDbSuccess() {
73
77
  void ensureLoaded();
78
+ if (firstSuccess) {
79
+ firstSuccess = false;
80
+ telemetry.failedWrites = 0;
81
+ // Do not reset `warned` — once printed, the warning stays printed
82
+ // to avoid re-arming on subsequent failure periods.
83
+ }
74
84
  telemetry.totalWrites++;
75
85
  schedulePersist();
76
86
  }
@@ -1 +1 @@
1
- {"version":3,"file":"db-telemetry.js","sourceRoot":"","sources":["../../src/state/db-telemetry.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"db-telemetry.js","sourceRoot":"","sources":["../../src/state/db-telemetry.ts"],"names":[],"mappings":"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"}
@@ -9,6 +9,13 @@
9
9
  * Uses better-sqlite3 for synchronous, zero-config SQLite.
10
10
  */
11
11
  import type { Message } from "../kernel/types.js";
12
+ /**
13
+ * Stop the optional chokidar watcher and reset internal state. Used by
14
+ * tests that need to swap out the home directory between runs.
15
+ */
16
+ export declare function _resetForTests(): Promise<void>;
17
+ /** Return the shared SQLite database handle, opening it if needed. */
18
+ export declare function openDb(): import("better-sqlite3").Database;
12
19
  export declare function dbOpenSession(id: string, model?: string, cwd?: string): void;
13
20
  export declare function dbCloseSession(id: string): void;
14
21
  export declare function dbAppendMessage(sessionId: string, message: Message): void;
package/dist/state/db.js CHANGED
@@ -11,27 +11,74 @@
11
11
  import { join } from "node:path";
12
12
  import { homedir } from "node:os";
13
13
  import { mkdirSync } from "node:fs";
14
+ import { createRequire } from "node:module";
14
15
  import { recordDbError, recordDbSuccess } from "./db-telemetry.js";
16
+ import { loadVecExtension } from "./vec.js";
17
+ import { bootstrapIndex, ensureIndexStateTable, } from "./sync-index.js";
18
+ const _require = createRequire(import.meta.url);
15
19
  const DB_DIR = join(homedir(), ".dirgha");
16
20
  const DB_PATH = join(DB_DIR, "dirgha.db");
17
21
  // Lazy singleton — only opened when first needed.
18
22
  let _db = null;
23
+ let _watcher = null;
24
+ let _indexBootstrapped = false;
19
25
  function getDb() {
20
26
  if (_db)
21
27
  return _db;
22
28
  try {
23
- const Database = require("better-sqlite3");
29
+ const Database = _require("better-sqlite3");
24
30
  mkdirSync(DB_DIR, { recursive: true });
25
31
  _db = new Database(DB_PATH);
26
32
  _db.pragma("journal_mode = WAL");
27
33
  _db.pragma("synchronous = NORMAL");
28
- initSchema(_db);
29
- return _db;
34
+ const db = _db;
35
+ initSchema(db);
36
+ migrateSchema(db);
37
+ loadVecExtension(db);
38
+ ensureIndexStateTable(db);
39
+ bootstrapIndexOnce(db);
40
+ return db;
30
41
  }
31
42
  catch {
32
43
  throw new Error(`SQLite unavailable (optional feature) — run "dirgha setup --features" to install.`);
33
44
  }
34
45
  }
46
+ /**
47
+ * First-call only: walk ~/.dirgha/memory and ~/.dirgha/knowledge into
48
+ * `embedding_meta`, and (if chokidar is installed) attach a watcher.
49
+ * Wrapped in a flag so re-entrant `openDb()` calls during startup don't
50
+ * trigger a second sync. Failures are swallowed — the SQLite index is
51
+ * a derived view and must never block CLI boot.
52
+ */
53
+ function bootstrapIndexOnce(db) {
54
+ if (_indexBootstrapped)
55
+ return;
56
+ _indexBootstrapped = true;
57
+ try {
58
+ const { watcher } = bootstrapIndex(db);
59
+ _watcher = watcher;
60
+ }
61
+ catch (err) {
62
+ recordDbError(err);
63
+ }
64
+ }
65
+ /**
66
+ * Stop the optional chokidar watcher and reset internal state. Used by
67
+ * tests that need to swap out the home directory between runs.
68
+ */
69
+ export async function _resetForTests() {
70
+ if (_watcher) {
71
+ try {
72
+ await _watcher.close();
73
+ }
74
+ catch {
75
+ /* swallow */
76
+ }
77
+ _watcher = null;
78
+ }
79
+ _indexBootstrapped = false;
80
+ _db = null;
81
+ }
35
82
  function initSchema(db) {
36
83
  db.exec(`
37
84
  CREATE TABLE IF NOT EXISTS sessions (
@@ -58,8 +105,83 @@ function initSchema(db) {
58
105
  INSERT INTO messages_fts(rowid, content, session_id, role)
59
106
  VALUES (new.id, new.content, new.session_id, new.role);
60
107
  END;
108
+
109
+ -- Sprint 3 graph schema (docs/cli/index/agent-db.md).
110
+ -- graph_nodes + graph_edges with directed labelled edges.
111
+ CREATE TABLE IF NOT EXISTS graph_nodes (
112
+ id TEXT PRIMARY KEY,
113
+ type TEXT NOT NULL,
114
+ props TEXT,
115
+ ts INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
116
+ );
117
+ CREATE TABLE IF NOT EXISTS graph_edges (
118
+ src TEXT NOT NULL,
119
+ dst TEXT NOT NULL,
120
+ rel TEXT NOT NULL,
121
+ props TEXT,
122
+ ts INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
123
+ PRIMARY KEY (src, dst, rel),
124
+ FOREIGN KEY (src) REFERENCES graph_nodes(id) ON DELETE CASCADE,
125
+ FOREIGN KEY (dst) REFERENCES graph_nodes(id) ON DELETE CASCADE
126
+ );
127
+ CREATE INDEX IF NOT EXISTS idx_edges_src ON graph_edges(src, rel);
128
+ CREATE INDEX IF NOT EXISTS idx_edges_dst ON graph_edges(dst, rel);
129
+ CREATE INDEX IF NOT EXISTS idx_nodes_type ON graph_nodes(type);
61
130
  `);
62
131
  }
132
+ /**
133
+ * Idempotent schema migration for existing databases from earlier CLI
134
+ * versions. Adds missing columns without data loss; backfills ts from
135
+ * the legacy created_at text column when present.
136
+ *
137
+ * Failures are captured via recordDbError but never thrown — the CLI
138
+ * must continue to work without DB persistence rather than crash.
139
+ */
140
+ function migrateSchema(db) {
141
+ try {
142
+ // messages: add ts if it doesn't exist
143
+ const msgCols = db.pragma("table_info(messages)");
144
+ const hasTs = msgCols.some((c) => c.name === "ts");
145
+ const hasCreatedAt = msgCols.some((c) => c.name === "created_at");
146
+ if (!hasTs) {
147
+ db.exec("ALTER TABLE messages ADD COLUMN ts INTEGER NOT NULL DEFAULT 0");
148
+ }
149
+ if (hasCreatedAt) {
150
+ // Backfill ts from legacy text timestamp (once, for rows still at 0).
151
+ db.exec("UPDATE messages SET ts = CAST(strftime('%s', created_at) * 1000 AS INTEGER) WHERE ts = 0 AND created_at IS NOT NULL");
152
+ }
153
+ // sessions: align legacy schemas (some predate the current column set).
154
+ // Earlier CLI versions wrote sessions(id, title, model, tokens,
155
+ // created_at, updated_at, working_dir, ...) — but dbOpenSession's
156
+ // INSERT lists `cwd` and `started_at`. Add any missing columns.
157
+ const sessCols = db.pragma("table_info(sessions)");
158
+ const sessNames = new Set(sessCols.map((c) => c.name));
159
+ if (!sessNames.has("started_at")) {
160
+ db.exec("ALTER TABLE sessions ADD COLUMN started_at INTEGER NOT NULL DEFAULT 0");
161
+ }
162
+ if (!sessNames.has("cwd")) {
163
+ // Default to '' so the NOT-NULL semantics aren't a problem; if the
164
+ // legacy column `working_dir` exists, copy it across as a one-shot.
165
+ db.exec("ALTER TABLE sessions ADD COLUMN cwd TEXT");
166
+ if (sessNames.has("working_dir")) {
167
+ db.exec("UPDATE sessions SET cwd = working_dir WHERE cwd IS NULL AND working_dir IS NOT NULL");
168
+ }
169
+ }
170
+ if (!sessNames.has("model")) {
171
+ db.exec("ALTER TABLE sessions ADD COLUMN model TEXT");
172
+ }
173
+ if (!sessNames.has("ended_at")) {
174
+ db.exec("ALTER TABLE sessions ADD COLUMN ended_at INTEGER");
175
+ }
176
+ }
177
+ catch (err) {
178
+ recordDbError(err);
179
+ }
180
+ }
181
+ /** Return the shared SQLite database handle, opening it if needed. */
182
+ export function openDb() {
183
+ return getDb();
184
+ }
63
185
  export function dbOpenSession(id, model, cwd) {
64
186
  try {
65
187
  const db = getDb();
@@ -1 +1 @@
1
- {"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/state/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE1C,kDAAkD;AAClD,IAAI,GAAG,GAA6C,IAAI,CAAC;AAEzD,SAAS,KAAK;IACZ,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,QAAQ,GACZ,OAAO,CAAC,gBAAgB,CAAoC,CAAC;QAC/D,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,GAAG,GAAG,IAAK,QAG4B,CAAC,OAAO,CAAC,CAAC;QAChD,GAAyC,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACvE,GAAyC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC1E,UAAU,CAAC,GAAwC,CAAC,CAAC;QACrD,OAAO,GAAwC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,EAAqC;IACvD,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,KAAc,EAAE,GAAY;IACpE,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,EAAE,CAAC,OAAO,CACR,gFAAgF,CACjF,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,IAAI,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,EAAE,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC,GAAG,CAC7D,IAAI,CAAC,GAAG,EAAE,EACV,EAAE,CACH,CAAC;QACF,eAAe,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,aAAa,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,OAAgB;IACjE,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,MAAM,OAAO,GACX,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;YACjC,CAAC,CAAC,OAAO,CAAC,OAAO;YACjB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,EAAE,CAAC,OAAO,CACR,yEAAyE,CAC1E,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACpD,eAAe,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,aAAa,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AASD,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,OAAO,EAAE;aACN,OAAO,CACN;;;;;;;KAOH,CACE;aACA,GAAG,CAAC,KAAK,EAAE,KAAK,CAAiB,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,KAAK,EAAE,CAAC;QACR,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAK,GAAG,EAAE;IAOvC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,OAAO,EAAE;aACN,OAAO,CACN;;;;;;;;KAQH,CACE;aACA,GAAG,CAAC,KAAK,CAMV,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/state/db.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Markdown → SQLite indexer (Sprint 6 — docs/cli/index/agent-db.md).
3
+ *
4
+ * Walks `~/.dirgha/memory/*.md` and `~/.dirgha/knowledge/*.md`, indexing
5
+ * each file as a row in `embedding_meta` with source label
6
+ * `memory:<slug>` or `kb:<slug>`. The SQLite copy is a derived index —
7
+ * the markdown files on disk remain the source of truth.
8
+ *
9
+ * Skips files that haven't changed via an `index_state(source PK, mtime)`
10
+ * sidecar table. `rm -rf ~/.dirgha/dirgha.db` and a restart rebuilds
11
+ * cleanly because every markdown file looks "new" again.
12
+ *
13
+ * If chokidar is installed (optional dependency), watches the two
14
+ * directories and propagates add/change/unlink within ~200ms. When
15
+ * chokidar is absent, the startup-only sync is the entire mechanism.
16
+ *
17
+ * Public API:
18
+ * - syncMemoryAndKb(db, opts?) — one-shot walk + insert/update/delete
19
+ * - startWatchers(db, opts?) — optional chokidar wiring (returns null if absent)
20
+ *
21
+ * Both APIs return summaries useful for `dirgha doctor` and tests.
22
+ */
23
+ export interface SyncOptions {
24
+ /** Override ~/.dirgha root for tests. Defaults to `homedir()/.dirgha`. */
25
+ home?: string;
26
+ /** Set to true to log skip/insert/update counts to stderr. */
27
+ verbose?: boolean;
28
+ }
29
+ export interface SyncSummary {
30
+ inserted: number;
31
+ updated: number;
32
+ unchanged: number;
33
+ deleted: number;
34
+ total: number;
35
+ /** Most-recent file mtime (ms epoch) seen during this sync, or 0 when empty. */
36
+ latestMtime: number;
37
+ }
38
+ export interface KbStats {
39
+ count: number;
40
+ latestSync: number;
41
+ }
42
+ /**
43
+ * Bootstrap the `index_state` table used to skip-already-indexed files.
44
+ * Idempotent — safe to call on every openDb().
45
+ */
46
+ export declare function ensureIndexStateTable(db: import("better-sqlite3").Database): void;
47
+ /**
48
+ * One-shot walk over ~/.dirgha/memory and ~/.dirgha/knowledge. Inserts
49
+ * new files, refreshes changed ones, and removes rows for files no
50
+ * longer on disk.
51
+ */
52
+ export declare function syncMemoryAndKb(db: import("better-sqlite3").Database, opts?: SyncOptions): SyncSummary;
53
+ /**
54
+ * Count of currently indexed memory + KB chunks, plus the most recent
55
+ * sync timestamp. Used by `dirgha doctor`.
56
+ */
57
+ export declare function getKbChunkStats(db: import("better-sqlite3").Database): KbStats;
58
+ export interface WatcherHandle {
59
+ close(): Promise<void>;
60
+ }
61
+ /**
62
+ * Optional file watcher. Returns null when chokidar is not installed —
63
+ * callers should treat that as "startup-only sync, no live updates".
64
+ */
65
+ export declare function startWatchers(db: import("better-sqlite3").Database, opts?: SyncOptions): WatcherHandle | null;
66
+ /**
67
+ * Lazy startup hook — called from openDb() on first DB open per process.
68
+ * Wraps syncMemoryAndKb + startWatchers in a try/catch so a transient
69
+ * filesystem error never blocks the CLI from booting.
70
+ */
71
+ export declare function bootstrapIndex(db: import("better-sqlite3").Database, opts?: SyncOptions): {
72
+ summary: SyncSummary;
73
+ watcher: WatcherHandle | null;
74
+ };
@@ -0,0 +1,246 @@
1
+ /**
2
+ * Markdown → SQLite indexer (Sprint 6 — docs/cli/index/agent-db.md).
3
+ *
4
+ * Walks `~/.dirgha/memory/*.md` and `~/.dirgha/knowledge/*.md`, indexing
5
+ * each file as a row in `embedding_meta` with source label
6
+ * `memory:<slug>` or `kb:<slug>`. The SQLite copy is a derived index —
7
+ * the markdown files on disk remain the source of truth.
8
+ *
9
+ * Skips files that haven't changed via an `index_state(source PK, mtime)`
10
+ * sidecar table. `rm -rf ~/.dirgha/dirgha.db` and a restart rebuilds
11
+ * cleanly because every markdown file looks "new" again.
12
+ *
13
+ * If chokidar is installed (optional dependency), watches the two
14
+ * directories and propagates add/change/unlink within ~200ms. When
15
+ * chokidar is absent, the startup-only sync is the entire mechanism.
16
+ *
17
+ * Public API:
18
+ * - syncMemoryAndKb(db, opts?) — one-shot walk + insert/update/delete
19
+ * - startWatchers(db, opts?) — optional chokidar wiring (returns null if absent)
20
+ *
21
+ * Both APIs return summaries useful for `dirgha doctor` and tests.
22
+ */
23
+ import { readdirSync, statSync, readFileSync, existsSync } from "node:fs";
24
+ import { join } from "node:path";
25
+ import { homedir } from "node:os";
26
+ import { createRequire } from "node:module";
27
+ const _require = createRequire(import.meta.url);
28
+ const NAMESPACES = [
29
+ { dir: "memory", prefix: "memory:" },
30
+ { dir: "knowledge", prefix: "kb:" },
31
+ ];
32
+ /**
33
+ * Bootstrap the `index_state` table used to skip-already-indexed files.
34
+ * Idempotent — safe to call on every openDb().
35
+ */
36
+ export function ensureIndexStateTable(db) {
37
+ db.exec(`
38
+ CREATE TABLE IF NOT EXISTS index_state (
39
+ source TEXT PRIMARY KEY,
40
+ mtime INTEGER NOT NULL,
41
+ ts INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
42
+ );
43
+ `);
44
+ }
45
+ /**
46
+ * One-shot walk over ~/.dirgha/memory and ~/.dirgha/knowledge. Inserts
47
+ * new files, refreshes changed ones, and removes rows for files no
48
+ * longer on disk.
49
+ */
50
+ export function syncMemoryAndKb(db, opts = {}) {
51
+ ensureIndexStateTable(db);
52
+ const home = opts.home ?? homedir();
53
+ const root = join(home, ".dirgha");
54
+ const summary = {
55
+ inserted: 0,
56
+ updated: 0,
57
+ unchanged: 0,
58
+ deleted: 0,
59
+ total: 0,
60
+ latestMtime: 0,
61
+ };
62
+ const seen = new Set();
63
+ for (const ns of NAMESPACES) {
64
+ const dir = join(root, ns.dir);
65
+ if (!existsSync(dir))
66
+ continue;
67
+ let names;
68
+ try {
69
+ names = readdirSync(dir);
70
+ }
71
+ catch {
72
+ continue;
73
+ }
74
+ for (const name of names) {
75
+ if (!name.endsWith(".md"))
76
+ continue;
77
+ // Skip the human-readable index files generated by memory.ts /
78
+ // knowledge.ts — they're derived too and would just bloat the index.
79
+ if (name === "MEMORY.md" || name === "INDEX.md")
80
+ continue;
81
+ const slug = name.replace(/\.md$/, "");
82
+ const source = `${ns.prefix}${slug}`;
83
+ const path = join(dir, name);
84
+ seen.add(source);
85
+ let mtime;
86
+ try {
87
+ mtime = Math.floor(statSync(path).mtimeMs);
88
+ }
89
+ catch {
90
+ continue;
91
+ }
92
+ const prior = db
93
+ .prepare("SELECT mtime FROM index_state WHERE source = ?")
94
+ .get(source);
95
+ if (prior && prior.mtime === mtime) {
96
+ summary.unchanged++;
97
+ if (mtime > summary.latestMtime)
98
+ summary.latestMtime = mtime;
99
+ continue;
100
+ }
101
+ let body;
102
+ try {
103
+ body = readFileSync(path, "utf8");
104
+ }
105
+ catch {
106
+ continue;
107
+ }
108
+ const chunk = body.slice(0, 8_000); // cap per-row to keep DB manageable
109
+ const tx = db.transaction(() => {
110
+ // embedding_meta has no UNIQUE on source — clean prior rows for
111
+ // this source first so re-index leaves exactly one entry.
112
+ db.prepare("DELETE FROM embedding_meta WHERE source = ?").run(source);
113
+ db.prepare("INSERT INTO embedding_meta(source, chunk, ts) VALUES (?, ?, ?)").run(source, chunk, Date.now());
114
+ db.prepare("INSERT INTO index_state(source, mtime, ts) VALUES (?, ?, ?) " +
115
+ "ON CONFLICT(source) DO UPDATE SET mtime = excluded.mtime, ts = excluded.ts").run(source, mtime, Date.now());
116
+ });
117
+ tx();
118
+ if (prior)
119
+ summary.updated++;
120
+ else
121
+ summary.inserted++;
122
+ if (mtime > summary.latestMtime)
123
+ summary.latestMtime = mtime;
124
+ }
125
+ }
126
+ // Sweep stale rows — files deleted from disk should drop from the index.
127
+ const knownSources = db
128
+ .prepare("SELECT source FROM index_state")
129
+ .all();
130
+ for (const row of knownSources) {
131
+ if (!isMemoryOrKbSource(row.source))
132
+ continue;
133
+ if (seen.has(row.source))
134
+ continue;
135
+ db.transaction(() => {
136
+ db.prepare("DELETE FROM embedding_meta WHERE source = ?").run(row.source);
137
+ db.prepare("DELETE FROM index_state WHERE source = ?").run(row.source);
138
+ })();
139
+ summary.deleted++;
140
+ }
141
+ summary.total =
142
+ summary.inserted + summary.updated + summary.unchanged;
143
+ if (opts.verbose) {
144
+ process.stderr.write(`[Dirgha] sync-index: +${summary.inserted} ~${summary.updated} =${summary.unchanged} -${summary.deleted} (latest mtime ${new Date(summary.latestMtime || 0).toISOString()})\n`);
145
+ }
146
+ return summary;
147
+ }
148
+ function isMemoryOrKbSource(source) {
149
+ return source.startsWith("memory:") || source.startsWith("kb:");
150
+ }
151
+ /**
152
+ * Count of currently indexed memory + KB chunks, plus the most recent
153
+ * sync timestamp. Used by `dirgha doctor`.
154
+ */
155
+ export function getKbChunkStats(db) {
156
+ try {
157
+ const c = db
158
+ .prepare("SELECT COUNT(*) AS c FROM embedding_meta WHERE source LIKE 'memory:%' OR source LIKE 'kb:%'")
159
+ .get();
160
+ const m = db
161
+ .prepare("SELECT MAX(ts) AS m FROM index_state WHERE source LIKE 'memory:%' OR source LIKE 'kb:%'")
162
+ .get();
163
+ return { count: c.c ?? 0, latestSync: m.m ?? 0 };
164
+ }
165
+ catch {
166
+ return { count: 0, latestSync: 0 };
167
+ }
168
+ }
169
+ /**
170
+ * Optional file watcher. Returns null when chokidar is not installed —
171
+ * callers should treat that as "startup-only sync, no live updates".
172
+ */
173
+ export function startWatchers(db, opts = {}) {
174
+ let chokidar = null;
175
+ try {
176
+ chokidar = _require("chokidar");
177
+ }
178
+ catch {
179
+ return null;
180
+ }
181
+ const home = opts.home ?? homedir();
182
+ const targets = NAMESPACES.map((ns) => join(home, ".dirgha", ns.dir));
183
+ const watcher = chokidar.watch(targets, {
184
+ ignoreInitial: true,
185
+ persistent: false,
186
+ awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
187
+ });
188
+ // Coalesce add/change events into a 200 ms re-sync window so a single
189
+ // editor save doesn't fire syncMemoryAndKb three times.
190
+ let pending = null;
191
+ const schedule = () => {
192
+ if (pending)
193
+ return;
194
+ pending = setTimeout(() => {
195
+ pending = null;
196
+ try {
197
+ syncMemoryAndKb(db, opts);
198
+ }
199
+ catch (err) {
200
+ process.stderr.write(`[Dirgha] sync-index watcher error: ${err.message}\n`);
201
+ }
202
+ }, 200);
203
+ };
204
+ watcher.on("add", schedule);
205
+ watcher.on("change", schedule);
206
+ watcher.on("unlink", schedule);
207
+ return {
208
+ async close() {
209
+ if (pending) {
210
+ clearTimeout(pending);
211
+ pending = null;
212
+ }
213
+ await watcher.close();
214
+ },
215
+ };
216
+ }
217
+ /**
218
+ * Lazy startup hook — called from openDb() on first DB open per process.
219
+ * Wraps syncMemoryAndKb + startWatchers in a try/catch so a transient
220
+ * filesystem error never blocks the CLI from booting.
221
+ */
222
+ export function bootstrapIndex(db, opts = {}) {
223
+ let summary = {
224
+ inserted: 0,
225
+ updated: 0,
226
+ unchanged: 0,
227
+ deleted: 0,
228
+ total: 0,
229
+ latestMtime: 0,
230
+ };
231
+ try {
232
+ summary = syncMemoryAndKb(db, opts);
233
+ }
234
+ catch (err) {
235
+ process.stderr.write(`[Dirgha] sync-index startup failed (live updates may stop): ${err.message}\n`);
236
+ }
237
+ let watcher = null;
238
+ try {
239
+ watcher = startWatchers(db, opts);
240
+ }
241
+ catch {
242
+ /* chokidar present but failed to attach — fall back to startup-only */
243
+ }
244
+ return { summary, watcher };
245
+ }
246
+ //# sourceMappingURL=sync-index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync-index.js","sourceRoot":"","sources":["../../src/state/sync-index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ /**
2
+ * Multi-model transactional API. Wraps relational + FTS + vector + graph
3
+ * writes in a single SQLite BEGIN IMMEDIATE / COMMIT, so an agent can
4
+ * fire a furious burst of cross-model writes and either get them all or
5
+ * get nothing — no partial state.
6
+ *
7
+ * Use from agent tools (transactional_write tool exposes this) or from
8
+ * direct callers. The callback receives a typed `tx` object; throw or
9
+ * abort to roll back.
10
+ */
11
+ export interface MessageWrite {
12
+ role: "user" | "assistant" | "system" | "tool";
13
+ content: string;
14
+ ts?: number;
15
+ session_id?: string;
16
+ }
17
+ export interface EmbeddingWrite {
18
+ source: string;
19
+ chunk: string;
20
+ vec: number[];
21
+ }
22
+ export interface GraphNodeWrite {
23
+ id: string;
24
+ type: string;
25
+ props?: Record<string, unknown>;
26
+ }
27
+ export interface GraphEdgeWrite {
28
+ src: string;
29
+ dst: string;
30
+ rel: string;
31
+ props?: Record<string, unknown>;
32
+ }
33
+ export interface TxResult {
34
+ message_id?: number;
35
+ embedding_id?: number;
36
+ node_ids: string[];
37
+ edge_keys: string[];
38
+ }
39
+ export interface TxApi {
40
+ message: {
41
+ insert(w: MessageWrite): number;
42
+ };
43
+ embedding: {
44
+ insert(w: EmbeddingWrite): number;
45
+ };
46
+ graph: {
47
+ addNode(w: GraphNodeWrite): string;
48
+ addEdge(w: GraphEdgeWrite): {
49
+ src: string;
50
+ dst: string;
51
+ rel: string;
52
+ };
53
+ };
54
+ }
55
+ /**
56
+ * Run a callback inside a single SQLite transaction. All writes (messages,
57
+ * embeddings, graph nodes, graph edges) commit atomically via BEGIN IMMEDIATE.
58
+ *
59
+ * Pass an optional Database handle for testing with in-memory databases;
60
+ * defaults to the shared `openDb()` singleton.
61
+ */
62
+ export declare function transactional<T>(fn: (tx: TxApi) => T, db?: import("better-sqlite3").Database): T;