@dirgha/code 1.21.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 (282) 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 +148 -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 +45 -22
  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/health-monitor.d.ts +8 -8
  98. package/dist/intelligence/health-monitor.js +105 -74
  99. package/dist/intelligence/health-monitor.js.map +1 -1
  100. package/dist/intelligence/prices.d.ts +6 -4
  101. package/dist/intelligence/prices.js +36 -10
  102. package/dist/intelligence/prices.js.map +1 -1
  103. package/dist/kernel/agent-loop.js +60 -17
  104. package/dist/kernel/agent-loop.js.map +1 -1
  105. package/dist/kernel/types.d.ts +3 -0
  106. package/dist/lsp/client.js +29 -16
  107. package/dist/lsp/client.js.map +1 -1
  108. package/dist/lsp/detector.js +7 -6
  109. package/dist/lsp/detector.js.map +1 -1
  110. package/dist/mcp/client.d.ts +1 -1
  111. package/dist/mcp/client.js +19 -16
  112. package/dist/mcp/client.js.map +1 -1
  113. package/dist/mcp/transport.js +46 -38
  114. package/dist/mcp/transport.js.map +1 -1
  115. package/dist/providers/deepseek.js +1 -1
  116. package/dist/providers/deepseek.js.map +1 -1
  117. package/dist/providers/dispatch.js +15 -1
  118. package/dist/providers/dispatch.js.map +1 -1
  119. package/dist/providers/index.d.ts +11 -0
  120. package/dist/providers/index.js +29 -2
  121. package/dist/providers/index.js.map +1 -1
  122. package/dist/providers/nvidia.js +1 -1
  123. package/dist/providers/nvidia.js.map +1 -1
  124. package/dist/providers/openai-compat.js +4 -2
  125. package/dist/providers/openai-compat.js.map +1 -1
  126. package/dist/providers/openrouter.js +1 -1
  127. package/dist/providers/openrouter.js.map +1 -1
  128. package/dist/safety/audit-log.d.ts +15 -0
  129. package/dist/safety/audit-log.js +21 -0
  130. package/dist/safety/audit-log.js.map +1 -1
  131. package/dist/state/db-telemetry.d.ts +21 -0
  132. package/dist/state/db-telemetry.js +116 -0
  133. package/dist/state/db-telemetry.js.map +1 -0
  134. package/dist/state/db.d.ts +7 -0
  135. package/dist/state/db.js +132 -7
  136. package/dist/state/db.js.map +1 -1
  137. package/dist/state/sync-index.d.ts +74 -0
  138. package/dist/state/sync-index.js +246 -0
  139. package/dist/state/sync-index.js.map +1 -0
  140. package/dist/state/transaction.d.ts +62 -0
  141. package/dist/state/transaction.js +65 -0
  142. package/dist/state/transaction.js.map +1 -0
  143. package/dist/state/vec.d.ts +28 -0
  144. package/dist/state/vec.js +113 -0
  145. package/dist/state/vec.js.map +1 -0
  146. package/dist/telemetry/gateway-push.d.ts +17 -0
  147. package/dist/telemetry/gateway-push.js +48 -0
  148. package/dist/telemetry/gateway-push.js.map +1 -0
  149. package/dist/telemetry/index.d.ts +9 -0
  150. package/dist/telemetry/index.js +9 -0
  151. package/dist/telemetry/index.js.map +1 -0
  152. package/dist/tools/browser.js +24 -16
  153. package/dist/tools/browser.js.map +1 -1
  154. package/dist/tools/checkpoint.d.ts +6 -1
  155. package/dist/tools/checkpoint.js +79 -62
  156. package/dist/tools/checkpoint.js.map +1 -1
  157. package/dist/tools/cron.js +1 -3
  158. package/dist/tools/cron.js.map +1 -1
  159. package/dist/tools/db-workspace-info.d.ts +10 -0
  160. package/dist/tools/db-workspace-info.js +76 -0
  161. package/dist/tools/db-workspace-info.js.map +1 -0
  162. package/dist/tools/diff.js +25 -21
  163. package/dist/tools/diff.js.map +1 -1
  164. package/dist/tools/exec.d.ts +6 -1
  165. package/dist/tools/exec.js +46 -4
  166. package/dist/tools/exec.js.map +1 -1
  167. package/dist/tools/fs-edit.d.ts +3 -5
  168. package/dist/tools/fs-edit.js +8 -23
  169. package/dist/tools/fs-edit.js.map +1 -1
  170. package/dist/tools/fs-ls.js +6 -8
  171. package/dist/tools/fs-ls.js.map +1 -1
  172. package/dist/tools/fs-read.d.ts +1 -1
  173. package/dist/tools/fs-read.js +37 -28
  174. package/dist/tools/fs-read.js.map +1 -1
  175. package/dist/tools/fs-write.d.ts +1 -1
  176. package/dist/tools/fs-write.js +33 -33
  177. package/dist/tools/fs-write.js.map +1 -1
  178. package/dist/tools/git.js +12 -6
  179. package/dist/tools/git.js.map +1 -1
  180. package/dist/tools/github.d.ts +13 -0
  181. package/dist/tools/github.js +257 -0
  182. package/dist/tools/github.js.map +1 -0
  183. package/dist/tools/graph-neighbors.d.ts +9 -0
  184. package/dist/tools/graph-neighbors.js +77 -0
  185. package/dist/tools/graph-neighbors.js.map +1 -0
  186. package/dist/tools/graph-traverse.d.ts +10 -0
  187. package/dist/tools/graph-traverse.js +90 -0
  188. package/dist/tools/graph-traverse.js.map +1 -0
  189. package/dist/tools/index.d.ts +10 -2
  190. package/dist/tools/index.js +17 -4
  191. package/dist/tools/index.js.map +1 -1
  192. package/dist/tools/kb-search.d.ts +13 -0
  193. package/dist/tools/kb-search.js +113 -0
  194. package/dist/tools/kb-search.js.map +1 -0
  195. package/dist/tools/multimodal.js +11 -12
  196. package/dist/tools/multimodal.js.map +1 -1
  197. package/dist/tools/registry.d.ts +10 -0
  198. package/dist/tools/registry.js.map +1 -1
  199. package/dist/tools/rtk.js +22 -9
  200. package/dist/tools/rtk.js.map +1 -1
  201. package/dist/tools/search-glob.d.ts +1 -1
  202. package/dist/tools/search-glob.js +42 -24
  203. package/dist/tools/search-glob.js.map +1 -1
  204. package/dist/tools/search-grep.d.ts +1 -1
  205. package/dist/tools/search-grep.js +56 -32
  206. package/dist/tools/search-grep.js.map +1 -1
  207. package/dist/tools/shell.d.ts +7 -1
  208. package/dist/tools/shell.js +178 -61
  209. package/dist/tools/shell.js.map +1 -1
  210. package/dist/tools/transactional-write.d.ts +10 -0
  211. package/dist/tools/transactional-write.js +132 -0
  212. package/dist/tools/transactional-write.js.map +1 -0
  213. package/dist/tui/ink/App.d.ts +2 -1
  214. package/dist/tui/ink/App.js +319 -83
  215. package/dist/tui/ink/App.js.map +1 -1
  216. package/dist/tui/ink/components/DenseToolMessage.js +23 -8
  217. package/dist/tui/ink/components/DenseToolMessage.js.map +1 -1
  218. package/dist/tui/ink/components/InputBox.js +16 -25
  219. package/dist/tui/ink/components/InputBox.js.map +1 -1
  220. package/dist/tui/ink/components/KeySetOverlay.d.ts +1 -1
  221. package/dist/tui/ink/components/KeySetOverlay.js +18 -16
  222. package/dist/tui/ink/components/KeySetOverlay.js.map +1 -1
  223. package/dist/tui/ink/components/Logo.d.ts +20 -0
  224. package/dist/tui/ink/components/Logo.js +67 -1
  225. package/dist/tui/ink/components/Logo.js.map +1 -1
  226. package/dist/tui/ink/components/ModelPicker.d.ts +2 -2
  227. package/dist/tui/ink/components/ModelPicker.js +34 -26
  228. package/dist/tui/ink/components/ModelPicker.js.map +1 -1
  229. package/dist/tui/ink/components/PasteCollapse.d.ts +3 -1
  230. package/dist/tui/ink/components/PasteCollapse.js +11 -9
  231. package/dist/tui/ink/components/PasteCollapse.js.map +1 -1
  232. package/dist/tui/ink/components/SandboxPicker.d.ts +18 -0
  233. package/dist/tui/ink/components/SandboxPicker.js +77 -0
  234. package/dist/tui/ink/components/SandboxPicker.js.map +1 -0
  235. package/dist/tui/ink/components/SpinnerGlyph.d.ts +4 -4
  236. package/dist/tui/ink/components/SpinnerGlyph.js +34 -14
  237. package/dist/tui/ink/components/SpinnerGlyph.js.map +1 -1
  238. package/dist/tui/ink/components/StatusBar.d.ts +7 -0
  239. package/dist/tui/ink/components/StatusBar.js +11 -5
  240. package/dist/tui/ink/components/StatusBar.js.map +1 -1
  241. package/dist/tui/ink/components/ThinkingBlock.d.ts +15 -4
  242. package/dist/tui/ink/components/ThinkingBlock.js +34 -17
  243. package/dist/tui/ink/components/ThinkingBlock.js.map +1 -1
  244. package/dist/tui/ink/components/ToolBox.js +23 -13
  245. package/dist/tui/ink/components/ToolBox.js.map +1 -1
  246. package/dist/tui/ink/components/VirtualTranscript.d.ts +19 -0
  247. package/dist/tui/ink/components/VirtualTranscript.js +31 -0
  248. package/dist/tui/ink/components/VirtualTranscript.js.map +1 -0
  249. package/dist/tui/ink/index.js +17 -1
  250. package/dist/tui/ink/index.js.map +1 -1
  251. package/dist/tui/ink/markdown/syntax-highlight.d.ts +13 -0
  252. package/dist/tui/ink/markdown/syntax-highlight.js +91 -0
  253. package/dist/tui/ink/markdown/syntax-highlight.js.map +1 -0
  254. package/dist/tui/ink/theme-context.js +6 -3
  255. package/dist/tui/ink/theme-context.js.map +1 -1
  256. package/dist/tui/ink/use-declined-versions.js +6 -2
  257. package/dist/tui/ink/use-declined-versions.js.map +1 -1
  258. package/dist/tui/ink/use-elapsed.d.ts +14 -0
  259. package/dist/tui/ink/use-elapsed.js +61 -0
  260. package/dist/tui/ink/use-elapsed.js.map +1 -0
  261. package/dist/tui/ink/use-event-projection.d.ts +10 -0
  262. package/dist/tui/ink/use-event-projection.js +111 -12
  263. package/dist/tui/ink/use-event-projection.js.map +1 -1
  264. package/dist/tui/ink/use-flicker-detector.d.ts +12 -0
  265. package/dist/tui/ink/use-flicker-detector.js +37 -0
  266. package/dist/tui/ink/use-flicker-detector.js.map +1 -0
  267. package/dist/tui/ink/use-overlays.d.ts +2 -2
  268. package/dist/tui/ink/use-overlays.js +16 -17
  269. package/dist/tui/ink/use-overlays.js.map +1 -1
  270. package/dist/tui/ink/use-render-metrics.d.ts +14 -0
  271. package/dist/tui/ink/use-render-metrics.js +106 -0
  272. package/dist/tui/ink/use-render-metrics.js.map +1 -0
  273. package/dist/tui/ink/use-transcript-scroll.d.ts +19 -0
  274. package/dist/tui/ink/use-transcript-scroll.js +83 -0
  275. package/dist/tui/ink/use-transcript-scroll.js.map +1 -0
  276. package/dist/utils/env.d.ts +1 -0
  277. package/dist/utils/env.js +60 -0
  278. package/dist/utils/env.js.map +1 -0
  279. package/dist/utils/fs.d.ts +10 -0
  280. package/dist/utils/fs.js +37 -0
  281. package/dist/utils/fs.js.map +1 -0
  282. package/package.json +10 -7
@@ -0,0 +1,21 @@
1
+ /**
2
+ * DB write telemetry.
3
+ *
4
+ * Tracks SQLite write failures so they are not silently swallowed.
5
+ * Stores counts in ~/.dirgha/state.json under `dbErrors`. When 10+
6
+ * errors accumulate in a single process lifetime, a warning is
7
+ * written to stderr so the user knows session data may not persist.
8
+ */
9
+ interface DbTelemetryData {
10
+ totalWrites: number;
11
+ failedWrites: number;
12
+ lastError: string;
13
+ lastErrorTime: string;
14
+ }
15
+ export declare function recordDbError(err: unknown): void;
16
+ export declare function recordDbSuccess(): void;
17
+ export declare function getDbErrorCount(): number;
18
+ export declare function getDbTelemetry(): Readonly<DbTelemetryData>;
19
+ export declare function flushDbTelemetry(): Promise<void>;
20
+ export declare function loadDbTelemetry(): Promise<void>;
21
+ export {};
@@ -0,0 +1,116 @@
1
+ /**
2
+ * DB write telemetry.
3
+ *
4
+ * Tracks SQLite write failures so they are not silently swallowed.
5
+ * Stores counts in ~/.dirgha/state.json under `dbErrors`. When 10+
6
+ * errors accumulate in a single process lifetime, a warning is
7
+ * written to stderr so the user knows session data may not persist.
8
+ */
9
+ import { homedir } from "node:os";
10
+ import { join } from "node:path";
11
+ import { readFile, writeFile, mkdir } from "node:fs/promises";
12
+ const DIRGHA_DIR = join(homedir(), ".dirgha");
13
+ const STATE_PATH = join(DIRGHA_DIR, "state.json");
14
+ let telemetry = {
15
+ totalWrites: 0,
16
+ failedWrites: 0,
17
+ lastError: "",
18
+ lastErrorTime: "",
19
+ };
20
+ let warned = false;
21
+ let loaded = false;
22
+ let firstSuccess = true;
23
+ async function ensureLoaded() {
24
+ if (loaded)
25
+ return;
26
+ loaded = true;
27
+ await loadDbTelemetry();
28
+ }
29
+ async function persist() {
30
+ try {
31
+ await mkdir(DIRGHA_DIR, { recursive: true });
32
+ let existing = {};
33
+ try {
34
+ const raw = await readFile(STATE_PATH, "utf8");
35
+ existing = JSON.parse(raw);
36
+ }
37
+ catch {
38
+ /* first write */
39
+ }
40
+ existing.dbErrors = {
41
+ totalWrites: telemetry.totalWrites,
42
+ failedWrites: telemetry.failedWrites,
43
+ lastError: telemetry.lastError,
44
+ lastErrorTime: telemetry.lastErrorTime,
45
+ };
46
+ await writeFile(STATE_PATH, JSON.stringify(existing, null, 2), "utf8");
47
+ }
48
+ catch {
49
+ /* best-effort; don't recurse on persist failure */
50
+ }
51
+ }
52
+ let persistTimer = null;
53
+ function schedulePersist() {
54
+ if (persistTimer)
55
+ clearTimeout(persistTimer);
56
+ persistTimer = setTimeout(() => {
57
+ persistTimer = null;
58
+ void persist();
59
+ }, 5000);
60
+ }
61
+ export function recordDbError(err) {
62
+ void ensureLoaded();
63
+ telemetry.totalWrites++;
64
+ telemetry.failedWrites++;
65
+ telemetry.lastError = err instanceof Error ? err.message : String(err);
66
+ telemetry.lastErrorTime = new Date().toISOString();
67
+ if (!warned && telemetry.failedWrites >= 10) {
68
+ warned = true;
69
+ const suffix = telemetry.lastError
70
+ ? ` (${telemetry.lastError})`
71
+ : "";
72
+ process.stderr.write(`[Dirgha] DB writes failing — session data may not persist.${suffix}\n`);
73
+ }
74
+ schedulePersist();
75
+ }
76
+ export function recordDbSuccess() {
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
+ }
84
+ telemetry.totalWrites++;
85
+ schedulePersist();
86
+ }
87
+ export function getDbErrorCount() {
88
+ void ensureLoaded();
89
+ return telemetry.failedWrites;
90
+ }
91
+ export function getDbTelemetry() {
92
+ void ensureLoaded();
93
+ return { ...telemetry };
94
+ }
95
+ export async function flushDbTelemetry() {
96
+ if (persistTimer) {
97
+ clearTimeout(persistTimer);
98
+ persistTimer = null;
99
+ }
100
+ await persist();
101
+ }
102
+ export async function loadDbTelemetry() {
103
+ try {
104
+ await mkdir(DIRGHA_DIR, { recursive: true });
105
+ const raw = await readFile(STATE_PATH, "utf8");
106
+ const existing = JSON.parse(raw);
107
+ const dbErrors = existing.dbErrors;
108
+ if (dbErrors) {
109
+ telemetry = { ...dbErrors };
110
+ }
111
+ }
112
+ catch {
113
+ /* no prior state */
114
+ }
115
+ }
116
+ //# sourceMappingURL=db-telemetry.js.map
@@ -0,0 +1 @@
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,26 +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";
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);
14
19
  const DB_DIR = join(homedir(), ".dirgha");
15
20
  const DB_PATH = join(DB_DIR, "dirgha.db");
16
21
  // Lazy singleton — only opened when first needed.
17
22
  let _db = null;
23
+ let _watcher = null;
24
+ let _indexBootstrapped = false;
18
25
  function getDb() {
19
26
  if (_db)
20
27
  return _db;
21
28
  try {
22
- const Database = require("better-sqlite3");
29
+ const Database = _require("better-sqlite3");
23
30
  mkdirSync(DB_DIR, { recursive: true });
24
31
  _db = new Database(DB_PATH);
25
32
  _db.pragma("journal_mode = WAL");
26
33
  _db.pragma("synchronous = NORMAL");
27
- initSchema(_db);
28
- return _db;
34
+ const db = _db;
35
+ initSchema(db);
36
+ migrateSchema(db);
37
+ loadVecExtension(db);
38
+ ensureIndexStateTable(db);
39
+ bootstrapIndexOnce(db);
40
+ return db;
29
41
  }
30
42
  catch {
31
43
  throw new Error(`SQLite unavailable (optional feature) — run "dirgha setup --features" to install.`);
32
44
  }
33
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
+ }
34
82
  function initSchema(db) {
35
83
  db.exec(`
36
84
  CREATE TABLE IF NOT EXISTS sessions (
@@ -57,8 +105,83 @@ function initSchema(db) {
57
105
  INSERT INTO messages_fts(rowid, content, session_id, role)
58
106
  VALUES (new.id, new.content, new.session_id, new.role);
59
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);
60
130
  `);
61
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
+ }
62
185
  export function dbOpenSession(id, model, cwd) {
63
186
  try {
64
187
  const db = getDb();
@@ -72,9 +195,10 @@ export function dbCloseSession(id) {
72
195
  try {
73
196
  const db = getDb();
74
197
  db.prepare("UPDATE sessions SET ended_at = ? WHERE id = ?").run(Date.now(), id);
198
+ recordDbSuccess();
75
199
  }
76
- catch {
77
- /* never block the CLI */
200
+ catch (err) {
201
+ recordDbError(err);
78
202
  }
79
203
  }
80
204
  export function dbAppendMessage(sessionId, message) {
@@ -84,9 +208,10 @@ export function dbAppendMessage(sessionId, message) {
84
208
  ? message.content
85
209
  : JSON.stringify(message.content);
86
210
  db.prepare("INSERT INTO messages(session_id, role, content, ts) VALUES (?, ?, ?, ?)").run(sessionId, message.role, content, Date.now());
211
+ recordDbSuccess();
87
212
  }
88
- catch {
89
- /* never block the CLI */
213
+ catch (err) {
214
+ recordDbError(err);
90
215
  }
91
216
  }
92
217
  export function dbSearchChats(query, limit = 20) {
@@ -1 +1 @@
1
- {"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/state/db.ts"],"names":[],"mappings":"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"}
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
+ };