pi-vault-mind 0.14.2 → 0.16.3

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 (164) hide show
  1. package/CHANGELOG.md +293 -0
  2. package/README.md +5 -5
  3. package/agents/broadcaster.agent.md +2 -2
  4. package/agents/heavy-lifter.agent.md +1 -1
  5. package/agents/main.agent.md +29 -0
  6. package/agents/manager.agent.md +1 -1
  7. package/agents/miner.agent.md +1 -1
  8. package/dist/packages/obsidian/src/client.js +331 -0
  9. package/dist/packages/obsidian/src/types.js +1 -0
  10. package/dist/src/activity.d.ts +49 -0
  11. package/dist/src/activity.js +175 -0
  12. package/dist/src/agent-bus/Agent.d.ts +9 -1
  13. package/dist/src/agent-bus/Agent.js +18 -2
  14. package/dist/src/agent-bus/index.d.ts +5 -5
  15. package/dist/src/agent-bus/index.js +1 -1
  16. package/dist/src/agent-queue.js +12 -3
  17. package/dist/src/agents/BroadcasterAgent.d.ts +1 -1
  18. package/dist/src/agents/BroadcasterAgent.js +2 -2
  19. package/dist/src/agents/HeavyLifterAgent.d.ts +1 -1
  20. package/dist/src/agents/HeavyLifterAgent.js +2 -2
  21. package/dist/src/agents/ManagerAgent.js +1 -1
  22. package/dist/src/agents/MinerAgent.d.ts +1 -1
  23. package/dist/src/agents/MinerAgent.js +2 -2
  24. package/dist/src/agents/index.d.ts +2 -2
  25. package/dist/src/agents/index.js +2 -2
  26. package/dist/src/auth.d.ts +17 -15
  27. package/dist/src/auth.js +26 -37
  28. package/dist/src/autosync.js +2 -2
  29. package/dist/src/commands.d.ts +2 -19
  30. package/dist/src/commands.js +301 -231
  31. package/dist/src/config-keys.d.ts +16 -0
  32. package/dist/src/config-keys.js +45 -0
  33. package/dist/src/discover-schema.js +4 -4
  34. package/dist/src/edits.d.ts +21 -0
  35. package/dist/src/edits.js +75 -0
  36. package/dist/src/embedding-probe.d.ts +34 -0
  37. package/dist/src/embedding-probe.js +142 -0
  38. package/dist/src/embedding-providers.d.ts +133 -0
  39. package/dist/src/embedding-providers.js +173 -0
  40. package/dist/src/embedding-secrets.d.ts +38 -0
  41. package/dist/src/embedding-secrets.js +291 -0
  42. package/dist/src/engine.d.ts +6 -0
  43. package/dist/src/engine.js +78 -6
  44. package/dist/src/events.js +7 -10
  45. package/dist/src/extension-packages.d.ts +9 -0
  46. package/dist/src/extension-packages.js +14 -0
  47. package/dist/src/git.d.ts +19 -0
  48. package/dist/src/git.js +78 -0
  49. package/dist/src/graph.d.ts +2 -1
  50. package/dist/src/graph.js +47 -13
  51. package/dist/src/identities-config.d.ts +6 -0
  52. package/dist/src/identities-config.js +39 -0
  53. package/dist/src/identity-injector.js +1 -1
  54. package/dist/src/index.js +9 -26
  55. package/dist/src/lance.d.ts +9 -0
  56. package/dist/src/lance.js +143 -203
  57. package/dist/src/modal-client.d.ts +16 -0
  58. package/dist/src/modal-client.js +16 -0
  59. package/dist/src/modal-config.d.ts +37 -14
  60. package/dist/src/modal-config.js +59 -32
  61. package/dist/src/model-router.d.ts +27 -0
  62. package/dist/src/model-router.js +67 -0
  63. package/dist/src/models.d.ts +42 -0
  64. package/dist/src/models.js +78 -0
  65. package/dist/src/personalize.js +17 -3
  66. package/dist/src/scaffold.d.ts +48 -0
  67. package/dist/src/scaffold.js +246 -0
  68. package/dist/src/server.d.ts +47 -4
  69. package/dist/src/server.js +988 -221
  70. package/dist/src/session-search.d.ts +63 -0
  71. package/dist/src/session-search.js +379 -0
  72. package/dist/src/settings-ui.d.ts +2 -2
  73. package/dist/src/settings-ui.js +76 -135
  74. package/dist/src/sync.d.ts +3 -3
  75. package/dist/src/sync.js +19 -15
  76. package/dist/src/tool-catalog.d.ts +18 -0
  77. package/dist/src/tool-catalog.js +232 -0
  78. package/dist/src/tools/marksman.js +1 -1
  79. package/dist/src/tools.js +111 -65
  80. package/dist/src/types.d.ts +127 -71
  81. package/dist/src/utils.d.ts +57 -6
  82. package/dist/src/utils.js +114 -28
  83. package/dist/src/vault-tools.d.ts +34 -0
  84. package/dist/src/vault-tools.js +99 -0
  85. package/dist/src/vault-writer.js +4 -1
  86. package/dist/src/vm-handlers.js +140 -43
  87. package/dist/src/watcher.js +9 -9
  88. package/dist/test/activity-tool.test.js +54 -0
  89. package/dist/test/agent-bus/Agent.test.js +174 -0
  90. package/dist/test/agent-bus/AgentLoader.test.js +180 -0
  91. package/dist/test/agent-bus/AgentRegistry.test.js +86 -0
  92. package/dist/test/agent-bus/LLMProvider.test.js +162 -0
  93. package/dist/test/agent-bus/TaskQueue.test.js +256 -0
  94. package/dist/test/agent-dispatch-context.test.js +73 -0
  95. package/dist/test/agent-queue.test.js +1 -1
  96. package/dist/test/agents/Agents.test.js +282 -0
  97. package/dist/test/auth.test.js +57 -56
  98. package/dist/test/bridge-identity.test.js +34 -3
  99. package/dist/test/classify-search-mode.test.js +51 -0
  100. package/dist/test/commands.test.js +410 -0
  101. package/dist/test/config-merge.test.js +98 -0
  102. package/dist/test/context-capture.test.js +56 -0
  103. package/dist/test/discover-schema.test.js +8 -5
  104. package/dist/test/dispatch.test.js +45 -91
  105. package/dist/test/edits.test.js +144 -0
  106. package/dist/test/embedding-probe.test.js +424 -0
  107. package/dist/test/embedding-providers.test.js +157 -0
  108. package/dist/test/embedding-secrets.test.js +210 -0
  109. package/dist/test/engine-identity.test.js +1 -1
  110. package/dist/test/events.test.js +675 -0
  111. package/dist/test/git-bridge.test.js +160 -0
  112. package/dist/test/graph.test.js +464 -0
  113. package/dist/test/helpers/server.js +81 -0
  114. package/dist/test/identity-injector.test.js +197 -0
  115. package/dist/test/index.test.js +5 -7
  116. package/dist/test/lance-modal.test.js +67 -2
  117. package/dist/test/lance.test.js +429 -0
  118. package/dist/test/modal-client.test.js +1 -1
  119. package/dist/test/modal-config.test.js +92 -79
  120. package/dist/test/model-readiness.test.js +122 -0
  121. package/dist/test/model-router.test.js +99 -0
  122. package/dist/test/obsidian-client.test.js +42 -0
  123. package/dist/test/personalize.test.js +1 -1
  124. package/dist/test/rest-models.test.js +153 -0
  125. package/dist/test/rest-queue.test.js +135 -87
  126. package/dist/test/rest-setup.test.js +625 -115
  127. package/dist/test/rest-vm.test.js +355 -94
  128. package/dist/test/server-cors.test.js +48 -0
  129. package/dist/test/server-ws.test.js +61 -34
  130. package/dist/test/session-crud.test.js +323 -0
  131. package/dist/test/session-search.test.js +139 -0
  132. package/dist/test/settings-ui.test.js +113 -4
  133. package/dist/test/sync.test.js +12 -12
  134. package/dist/test/tombstone.test.js +8 -10
  135. package/dist/test/tool-catalog.test.js +86 -0
  136. package/dist/test/utils.test.js +588 -0
  137. package/dist/test/vault-tools.test.js +103 -12
  138. package/dist/test/vault-writer.test.js +371 -0
  139. package/dist/test/vm-handlers.test.js +620 -0
  140. package/extension-packages.json +9 -0
  141. package/package.json +107 -90
  142. package/pi-vault-mind.config.example.json +24 -2
  143. package/scripts/check-deps.sh +35 -32
  144. package/scripts/cli-e2e.mjs +215 -0
  145. package/scripts/configuration-e2e.mjs +783 -0
  146. package/scripts/e2e-commands.mjs +391 -0
  147. package/scripts/e2e-ws.mjs +3 -2
  148. package/scripts/fetch-modal-token.sh +4 -3
  149. package/scripts/generate-config-keys-json.mjs +45 -0
  150. package/scripts/generate-extension-packages-json.mjs +55 -0
  151. package/scripts/pi-session-query +0 -0
  152. package/scripts/publish-obsidian-plugin.sh +0 -0
  153. package/scripts/reset-test-vault.sh +2 -2
  154. package/scripts/setup-test-config.sh +0 -0
  155. package/scripts/setup-vault-pi.sh +48 -9
  156. package/scripts/test-slash-commands.mjs +2 -2
  157. package/scripts/vault-pi.sh +12 -3
  158. package/skills/github-release-notes-file/SKILL.md +42 -0
  159. package/skills/obsidian-guided-test-session/SKILL.md +110 -0
  160. package/skills/obsidian-interactive-test/SKILL.md +88 -0
  161. package/skills/obsidian-plugin-publish/SKILL.md +58 -0
  162. package/skills/pi-vault-mind-release/SKILL.md +141 -0
  163. package/skills/pre-test-release/SKILL.md +116 -0
  164. package/dist/test/auto-indexer.test.js +0 -2
@@ -0,0 +1,588 @@
1
+ import { strict as assert } from "node:assert";
2
+ import { randomUUID } from "node:crypto";
3
+ import * as fs from "node:fs";
4
+ import { homedir, tmpdir } from "node:os";
5
+ import * as path from "node:path";
6
+ import { afterEach, beforeEach, describe, it } from "node:test";
7
+ import { collectionNames, deriveCollectionNameFromVaultPath, ensureDir, expandHome, getConfigPath, getPiContextConfig, getTokenEnvPath, isPiContextEnabled, isVaultMindReady, loadConfig, normalizeCollectionName, resolveInitCollectionName, resolvePath, resolveVaultFile, resolveVaultFolder, resolveVaultMindDir, resolveVaultMindPaths, shrinkHome, } from "../src/utils.js";
8
+ // ── Helpers ──────────────────────────────────────────────────────────────────
9
+ const savedHome = process.env.HOME;
10
+ const savedUserProfile = process.env.USERPROFILE;
11
+ const savedPiAgentDir = process.env.PI_CODING_AGENT_DIR;
12
+ const restoreEnv = () => {
13
+ if (savedHome !== undefined) {
14
+ process.env.HOME = savedHome;
15
+ process.env.USERPROFILE = savedUserProfile;
16
+ }
17
+ else {
18
+ delete process.env.HOME;
19
+ delete process.env.USERPROFILE;
20
+ }
21
+ if (savedPiAgentDir !== undefined) {
22
+ process.env.PI_CODING_AGENT_DIR = savedPiAgentDir;
23
+ }
24
+ else {
25
+ delete process.env.PI_CODING_AGENT_DIR;
26
+ }
27
+ };
28
+ const writeConfig = (dir, overrides) => {
29
+ const configDir = path.join(dir, ".vault-mind");
30
+ fs.mkdirSync(configDir, { recursive: true });
31
+ fs.writeFileSync(path.join(configDir, "vault-mind.config.json"), JSON.stringify(overrides, null, 2), "utf-8");
32
+ };
33
+ // ── Pure functions (no filesystem) ───────────────────────────────────────────
34
+ describe("expandHome", () => {
35
+ it("expands ~/ to the home directory", () => {
36
+ const home = homedir();
37
+ const result = expandHome("~/Documents");
38
+ assert.equal(result, path.join(home, "Documents"));
39
+ });
40
+ it("expands bare ~ to the home directory", () => {
41
+ const home = homedir();
42
+ const result = expandHome("~");
43
+ assert.equal(result, home);
44
+ });
45
+ it("leaves absolute paths unchanged", () => {
46
+ assert.equal(expandHome("/usr/local/bin"), "/usr/local/bin");
47
+ });
48
+ it("leaves relative paths unchanged", () => {
49
+ assert.equal(expandHome("foo/bar"), "foo/bar");
50
+ });
51
+ it("leaves paths with ~ in the middle unchanged", () => {
52
+ assert.equal(expandHome("/foo/~/bar"), "/foo/~/bar");
53
+ });
54
+ it("returns the original path when HOME is unset", () => {
55
+ delete process.env.HOME;
56
+ delete process.env.USERPROFILE;
57
+ const result = expandHome("~/Documents");
58
+ // Without HOME, the ~ is not expanded
59
+ assert.equal(result, "~/Documents");
60
+ restoreEnv();
61
+ });
62
+ });
63
+ describe("shrinkHome", () => {
64
+ it("shrinks a path under home to ~/...", () => {
65
+ const home = homedir();
66
+ const result = shrinkHome(path.join(home, "Documents"));
67
+ assert.equal(result, "~/Documents");
68
+ });
69
+ it("shrinks the home directory itself to ~", () => {
70
+ const home = homedir();
71
+ const result = shrinkHome(home);
72
+ assert.equal(result, "~");
73
+ });
74
+ it("leaves paths outside home unchanged", () => {
75
+ assert.equal(shrinkHome("/usr/local/bin"), "/usr/local/bin");
76
+ });
77
+ it("leaves relative paths unchanged", () => {
78
+ assert.equal(shrinkHome("foo/bar"), "foo/bar");
79
+ });
80
+ it("returns the original path when HOME is unset", () => {
81
+ delete process.env.HOME;
82
+ delete process.env.USERPROFILE;
83
+ const result = shrinkHome("/some/path");
84
+ assert.equal(result, "/some/path");
85
+ restoreEnv();
86
+ });
87
+ });
88
+ describe("resolvePath", () => {
89
+ it("resolves a relative path against cwd", () => {
90
+ const result = resolvePath("/home/user", "Documents/project");
91
+ assert.equal(result, path.join("/home/user", "Documents/project"));
92
+ });
93
+ it("leaves absolute paths unchanged", () => {
94
+ assert.equal(resolvePath("/home/user", "/etc/hosts"), "/etc/hosts");
95
+ });
96
+ it("resolves . against cwd", () => {
97
+ const result = resolvePath("/home/user", ".");
98
+ assert.equal(result, "/home/user");
99
+ });
100
+ });
101
+ describe("normalizeCollectionName", () => {
102
+ it("lowercases the input", () => {
103
+ assert.equal(normalizeCollectionName("MyCollection"), "mycollection");
104
+ });
105
+ it("replaces non-alphanumeric characters with underscores and trims edges", () => {
106
+ // "my collection!" → "my_collection_" → trimmed to "my_collection"
107
+ assert.equal(normalizeCollectionName("my collection!"), "my_collection");
108
+ });
109
+ it("trims leading and trailing underscores", () => {
110
+ assert.equal(normalizeCollectionName(" hello world "), "hello_world");
111
+ });
112
+ it("trims to 64 characters", () => {
113
+ const long = "a".repeat(100);
114
+ const result = normalizeCollectionName(long);
115
+ assert.equal(result.length, 64);
116
+ assert.equal(result, "a".repeat(64));
117
+ });
118
+ it("handles empty string", () => {
119
+ assert.equal(normalizeCollectionName(""), "");
120
+ });
121
+ it("handles only special characters", () => {
122
+ assert.equal(normalizeCollectionName("!@#$%"), "");
123
+ });
124
+ it("preserves numbers", () => {
125
+ assert.equal(normalizeCollectionName("v2_collection_123"), "v2_collection_123");
126
+ });
127
+ });
128
+ describe("deriveCollectionNameFromVaultPath", () => {
129
+ it("extracts the basename and normalizes it", () => {
130
+ const result = deriveCollectionNameFromVaultPath("/home/user/My Vault");
131
+ assert.equal(result, "my_vault");
132
+ });
133
+ it("falls back to 'main' when normalization yields empty", () => {
134
+ const result = deriveCollectionNameFromVaultPath("/home/user/!!!");
135
+ assert.equal(result, "main");
136
+ });
137
+ it("handles relative paths", () => {
138
+ const result = deriveCollectionNameFromVaultPath("../My-Vault");
139
+ assert.equal(result, "my_vault");
140
+ });
141
+ });
142
+ describe("resolveInitCollectionName", () => {
143
+ it("uses the override when provided", () => {
144
+ const result = resolveInitCollectionName("/vaults/main", "custom-name");
145
+ assert.equal(result, "custom_name");
146
+ });
147
+ it("derives from vault path when override is empty string", () => {
148
+ const result = resolveInitCollectionName("/vaults/My Vault", "");
149
+ assert.equal(result, "my_vault");
150
+ });
151
+ it("derives from vault path when override is whitespace only", () => {
152
+ const result = resolveInitCollectionName("/vaults/My Vault", " ");
153
+ assert.equal(result, "my_vault");
154
+ });
155
+ it("derives from vault path when override is undefined", () => {
156
+ const result = resolveInitCollectionName("/vaults/My Vault");
157
+ assert.equal(result, "my_vault");
158
+ });
159
+ it("falls back to derive when override normalizes to empty", () => {
160
+ const result = resolveInitCollectionName("/vaults/My Vault", "!!!");
161
+ assert.equal(result, "my_vault");
162
+ });
163
+ });
164
+ describe("resolveVaultFolder", () => {
165
+ const cfg = {
166
+ dataDir: ".lancedb",
167
+ embedding: {},
168
+ };
169
+ it("returns the default inbox folder", () => {
170
+ assert.equal(resolveVaultFolder(cfg, "inbox"), "Agent/Inbox");
171
+ });
172
+ it("returns the default library folder", () => {
173
+ assert.equal(resolveVaultFolder(cfg, "library"), "Agent/Library");
174
+ });
175
+ it("returns the default presentations folder", () => {
176
+ assert.equal(resolveVaultFolder(cfg, "presentations"), "Agent/Presentations");
177
+ });
178
+ it("returns the default journal folder", () => {
179
+ assert.equal(resolveVaultFolder(cfg, "journal"), "Agent/Journal");
180
+ });
181
+ it("returns a configured override", () => {
182
+ const cfgWithOverride = {
183
+ dataDir: ".lancedb",
184
+ embedding: {},
185
+ folders: { inbox: "Custom/Inbox" },
186
+ };
187
+ assert.equal(resolveVaultFolder(cfgWithOverride, "inbox"), "Custom/Inbox");
188
+ });
189
+ it("falls back to default when override is not set for a different key", () => {
190
+ const cfgWithOverride = {
191
+ dataDir: ".lancedb",
192
+ embedding: {},
193
+ folders: { inbox: "Custom/Inbox" },
194
+ };
195
+ assert.equal(resolveVaultFolder(cfgWithOverride, "library"), "Agent/Library");
196
+ });
197
+ });
198
+ describe("resolveVaultFile", () => {
199
+ const cfg = {
200
+ dataDir: ".lancedb",
201
+ embedding: {},
202
+ };
203
+ it("returns the default queue path", () => {
204
+ assert.equal(resolveVaultFile(cfg, "queue"), ".vault-mind/agent-queue.jsonl");
205
+ });
206
+ it("returns the default serverState path", () => {
207
+ assert.equal(resolveVaultFile(cfg, "serverState"), ".vault-mind/server.json");
208
+ });
209
+ it("returns the default manualDispatch path", () => {
210
+ assert.equal(resolveVaultFile(cfg, "manualDispatch"), ".vault-mind/manual-dispatch.md");
211
+ });
212
+ it("returns a configured override", () => {
213
+ const cfgWithOverride = {
214
+ dataDir: ".lancedb",
215
+ embedding: {},
216
+ files: { queue: "custom/queue.jsonl" },
217
+ };
218
+ assert.equal(resolveVaultFile(cfgWithOverride, "queue"), "custom/queue.jsonl");
219
+ });
220
+ it("falls back to default when override is not set for a different key", () => {
221
+ const cfgWithOverride = {
222
+ dataDir: ".lancedb",
223
+ embedding: {},
224
+ files: { queue: "custom/queue.jsonl" },
225
+ };
226
+ assert.equal(resolveVaultFile(cfgWithOverride, "serverState"), ".vault-mind/server.json");
227
+ });
228
+ });
229
+ describe("collectionNames", () => {
230
+ it("returns the keys of cfg.collections", () => {
231
+ const cfg = {
232
+ version: 2,
233
+ collections: {
234
+ main: { path: "collections/main.jsonl", schema: ["id"] },
235
+ pending: { path: "collections/pending.jsonl", schema: ["id"] },
236
+ },
237
+ injectors: [],
238
+ vaultMind: { dataDir: ".lancedb", embedding: {} },
239
+ };
240
+ const names = collectionNames(cfg);
241
+ assert.deepEqual(names.sort(), ["main", "pending"]);
242
+ });
243
+ it("returns an empty array when there are no collections", () => {
244
+ const cfg = {
245
+ version: 2,
246
+ collections: {},
247
+ injectors: [],
248
+ vaultMind: { dataDir: ".lancedb", embedding: {} },
249
+ };
250
+ assert.deepEqual(collectionNames(cfg), []);
251
+ });
252
+ });
253
+ describe("isPiContextEnabled", () => {
254
+ it("returns true when pi-context is enabled", () => {
255
+ const cfg = {
256
+ version: 2,
257
+ collections: {},
258
+ injectors: [],
259
+ vaultMind: { dataDir: ".lancedb", embedding: {} },
260
+ extensionCompatibility: {
261
+ "pi-context": { enabled: true },
262
+ },
263
+ };
264
+ assert.equal(isPiContextEnabled(cfg), true);
265
+ });
266
+ it("returns false when pi-context is disabled", () => {
267
+ const cfg = {
268
+ version: 2,
269
+ collections: {},
270
+ injectors: [],
271
+ vaultMind: { dataDir: ".lancedb", embedding: {} },
272
+ extensionCompatibility: {
273
+ "pi-context": { enabled: false },
274
+ },
275
+ };
276
+ assert.equal(isPiContextEnabled(cfg), false);
277
+ });
278
+ it("returns false when pi-context is not configured", () => {
279
+ const cfg = {
280
+ version: 2,
281
+ collections: {},
282
+ injectors: [],
283
+ vaultMind: { dataDir: ".lancedb", embedding: {} },
284
+ };
285
+ assert.equal(isPiContextEnabled(cfg), false);
286
+ });
287
+ it("returns false when extensionCompatibility is undefined", () => {
288
+ const cfg = {
289
+ version: 2,
290
+ collections: {},
291
+ injectors: [],
292
+ vaultMind: { dataDir: ".lancedb", embedding: {} },
293
+ extensionCompatibility: undefined,
294
+ };
295
+ assert.equal(isPiContextEnabled(cfg), false);
296
+ });
297
+ });
298
+ describe("getPiContextConfig", () => {
299
+ it("returns defaults when no pi-context config exists", () => {
300
+ const cfg = {
301
+ version: 2,
302
+ collections: {},
303
+ injectors: [],
304
+ vaultMind: { dataDir: ".lancedb", embedding: {} },
305
+ };
306
+ const result = getPiContextConfig(cfg);
307
+ assert.deepEqual(result, {
308
+ enabled: true,
309
+ tagPatterns: [],
310
+ enhanceInjectors: false,
311
+ autoEnableAcm: true,
312
+ indexContextEvents: true,
313
+ });
314
+ });
315
+ it("merges user overrides with defaults", () => {
316
+ const cfg = {
317
+ version: 2,
318
+ collections: {},
319
+ injectors: [],
320
+ vaultMind: { dataDir: ".lancedb", embedding: {} },
321
+ extensionCompatibility: {
322
+ "pi-context": {
323
+ enabled: false,
324
+ tagPatterns: ["#todo"],
325
+ },
326
+ },
327
+ };
328
+ const result = getPiContextConfig(cfg);
329
+ assert.deepEqual(result, {
330
+ enabled: false,
331
+ tagPatterns: ["#todo"],
332
+ enhanceInjectors: false,
333
+ autoEnableAcm: true,
334
+ indexContextEvents: true,
335
+ });
336
+ });
337
+ });
338
+ // ── Path helpers (pure, no filesystem) ───────────────────────────────────────
339
+ describe("resolveVaultMindDir", () => {
340
+ it("returns <cwd>/.vault-mind", () => {
341
+ assert.equal(resolveVaultMindDir("/home/user/vault"), "/home/user/vault/.vault-mind");
342
+ });
343
+ });
344
+ describe("getConfigPath", () => {
345
+ it("returns <cwd>/.vault-mind/vault-mind.config.json", () => {
346
+ assert.equal(getConfigPath("/home/user/vault"), "/home/user/vault/.vault-mind/vault-mind.config.json");
347
+ });
348
+ });
349
+ describe("getTokenEnvPath", () => {
350
+ it("returns <cwd>/.vault-mind/vault-mind.env", () => {
351
+ assert.equal(getTokenEnvPath("/home/user/vault"), "/home/user/vault/.vault-mind/vault-mind.env");
352
+ });
353
+ });
354
+ // ── Config functions (need temp dir) ─────────────────────────────────────────
355
+ describe("loadConfig", () => {
356
+ let testDir;
357
+ beforeEach(() => {
358
+ testDir = path.join(tmpdir(), `utils-test-${randomUUID()}`);
359
+ fs.mkdirSync(testDir, { recursive: true });
360
+ process.env.HOME = testDir;
361
+ process.env.USERPROFILE = testDir;
362
+ });
363
+ afterEach(() => {
364
+ restoreEnv();
365
+ try {
366
+ fs.rmSync(testDir, { recursive: true, force: true });
367
+ }
368
+ catch {
369
+ /* ignore */
370
+ }
371
+ });
372
+ it("returns merged config with empty collections when no config file exists", () => {
373
+ const cfg = loadConfig(testDir);
374
+ assert.equal(cfg.version, 2);
375
+ // mergeConfigLayer overwrites collections with resolved (empty) when no layer provides them
376
+ assert.deepEqual(cfg.collections, {});
377
+ assert.equal(cfg.vaultMind.dataDir, ".lancedb");
378
+ assert.equal(cfg.vaultMind.embedding.localUrl, "http://127.0.0.1:11434");
379
+ });
380
+ it("merges user config over defaults", () => {
381
+ writeConfig(testDir, {
382
+ version: 3,
383
+ vaultMind: {
384
+ dataDir: "custom-db",
385
+ embedding: { model: "custom-model" },
386
+ },
387
+ });
388
+ const cfg = loadConfig(testDir);
389
+ assert.equal(cfg.version, 3);
390
+ assert.equal(cfg.vaultMind.dataDir, "custom-db");
391
+ assert.equal(cfg.vaultMind.embedding.model, "custom-model");
392
+ // Default embedding.localUrl should still be present from merge
393
+ assert.equal(cfg.vaultMind.embedding.localUrl, "http://127.0.0.1:11434");
394
+ });
395
+ it("resolves collection paths relative to cwd", () => {
396
+ writeConfig(testDir, {
397
+ collections: {
398
+ custom: { path: "my-collections/custom.jsonl", schema: ["id", "fact"] },
399
+ },
400
+ });
401
+ const cfg = loadConfig(testDir);
402
+ assert.equal(cfg.collections.custom.path, path.join(testDir, "my-collections/custom.jsonl"));
403
+ });
404
+ it("expands ~ in vault paths", () => {
405
+ writeConfig(testDir, {
406
+ vaultMind: {
407
+ vaults: {
408
+ default: { path: "~/Documents/vault" },
409
+ },
410
+ },
411
+ });
412
+ const cfg = loadConfig(testDir);
413
+ const home = homedir();
414
+ assert.equal(cfg.vaultMind.vaults?.default.path, path.join(home, "Documents/vault"));
415
+ });
416
+ });
417
+ describe("isVaultMindReady", () => {
418
+ let testDir;
419
+ beforeEach(() => {
420
+ testDir = path.join(tmpdir(), `utils-ready-${randomUUID()}`);
421
+ fs.mkdirSync(testDir, { recursive: true });
422
+ process.env.HOME = testDir;
423
+ process.env.USERPROFILE = testDir;
424
+ });
425
+ afterEach(() => {
426
+ restoreEnv();
427
+ try {
428
+ fs.rmSync(testDir, { recursive: true, force: true });
429
+ }
430
+ catch {
431
+ /* ignore */
432
+ }
433
+ });
434
+ it("returns false when no config file exists", () => {
435
+ assert.equal(isVaultMindReady(testDir), false);
436
+ });
437
+ it("returns false when config has no vault path", () => {
438
+ writeConfig(testDir, {
439
+ vaultMind: {
440
+ embedding: { model: "test-model" },
441
+ },
442
+ });
443
+ assert.equal(isVaultMindReady(testDir), false);
444
+ });
445
+ it("returns false when config has no embedding config", () => {
446
+ writeConfig(testDir, {
447
+ vaultMind: {
448
+ vaults: { default: { path: "/some/vault" } },
449
+ },
450
+ });
451
+ assert.equal(isVaultMindReady(testDir), false);
452
+ });
453
+ it("returns true when vault path and embedding model are set", () => {
454
+ writeConfig(testDir, {
455
+ vaultMind: {
456
+ vaults: { default: { path: "/some/vault" } },
457
+ embedding: { model: "test-model" },
458
+ },
459
+ });
460
+ assert.equal(isVaultMindReady(testDir), true);
461
+ });
462
+ it("returns true when vault path and embedding localUrl are set", () => {
463
+ writeConfig(testDir, {
464
+ vaultMind: {
465
+ vaults: { default: { path: "/some/vault" } },
466
+ embedding: { localUrl: "http://127.0.0.1:11434" },
467
+ },
468
+ });
469
+ assert.equal(isVaultMindReady(testDir), true);
470
+ });
471
+ it("returns true when vault path and embedding remoteUrl are set", () => {
472
+ writeConfig(testDir, {
473
+ vaultMind: {
474
+ vaults: { default: { path: "/some/vault" } },
475
+ embedding: { remoteUrl: "https://example.com/v1" },
476
+ },
477
+ });
478
+ assert.equal(isVaultMindReady(testDir), true);
479
+ });
480
+ it("returns true when vault path and embedding provider are set", () => {
481
+ writeConfig(testDir, {
482
+ vaultMind: {
483
+ vaults: { default: { path: "/some/vault" } },
484
+ embedding: { provider: "openai" },
485
+ },
486
+ });
487
+ assert.equal(isVaultMindReady(testDir), true);
488
+ });
489
+ it("returns false when config file is invalid JSON", () => {
490
+ const configDir = path.join(testDir, ".vault-mind");
491
+ fs.mkdirSync(configDir, { recursive: true });
492
+ fs.writeFileSync(path.join(configDir, "vault-mind.config.json"), "not json", "utf-8");
493
+ assert.equal(isVaultMindReady(testDir), false);
494
+ });
495
+ });
496
+ describe("ensureDir", () => {
497
+ let testDir;
498
+ beforeEach(() => {
499
+ testDir = path.join(tmpdir(), `utils-ensuredir-${randomUUID()}`);
500
+ });
501
+ afterEach(() => {
502
+ try {
503
+ fs.rmSync(testDir, { recursive: true, force: true });
504
+ }
505
+ catch {
506
+ /* ignore */
507
+ }
508
+ });
509
+ it("creates the parent directory if it does not exist", () => {
510
+ const filePath = path.join(testDir, "subdir", "nested", "file.txt");
511
+ ensureDir(filePath);
512
+ assert.ok(fs.existsSync(path.join(testDir, "subdir", "nested")));
513
+ });
514
+ it("does not throw when the directory already exists", () => {
515
+ const filePath = path.join(testDir, "subdir", "file.txt");
516
+ fs.mkdirSync(path.join(testDir, "subdir"), { recursive: true });
517
+ // Should not throw
518
+ ensureDir(filePath);
519
+ assert.ok(fs.existsSync(path.join(testDir, "subdir")));
520
+ });
521
+ });
522
+ describe("resolveVaultMindPaths", () => {
523
+ let testDir;
524
+ beforeEach(() => {
525
+ testDir = path.join(tmpdir(), `utils-paths-${randomUUID()}`);
526
+ fs.mkdirSync(testDir, { recursive: true });
527
+ // Isolate agent dir under the temp vault
528
+ process.env.PI_CODING_AGENT_DIR = path.join(testDir, ".vault-mind", ".pi", "agent");
529
+ process.env.HOME = testDir;
530
+ process.env.USERPROFILE = testDir;
531
+ // Write a minimal config so loadConfig works
532
+ writeConfig(testDir, {
533
+ vaultMind: {
534
+ vaults: { default: { path: testDir } },
535
+ embedding: { model: "test-model" },
536
+ },
537
+ });
538
+ });
539
+ afterEach(() => {
540
+ restoreEnv();
541
+ try {
542
+ fs.rmSync(testDir, { recursive: true, force: true });
543
+ }
544
+ catch {
545
+ /* ignore */
546
+ }
547
+ });
548
+ it("returns all resolved paths for a vault", () => {
549
+ const paths = resolveVaultMindPaths(testDir);
550
+ assert.equal(paths.vaultPath, testDir);
551
+ assert.equal(paths.vaultMindDir, path.join(testDir, ".vault-mind"));
552
+ assert.equal(paths.config, path.join(testDir, ".vault-mind", "vault-mind.config.json"));
553
+ assert.equal(paths.tokenEnv, path.join(testDir, ".vault-mind", "vault-mind.env"));
554
+ assert.equal(paths.queue, path.join(testDir, ".vault-mind", "agent-queue.jsonl"));
555
+ assert.equal(paths.serverState, path.join(testDir, ".vault-mind", "server.json"));
556
+ assert.equal(paths.manualDispatch, path.join(testDir, ".vault-mind", "manual-dispatch.md"));
557
+ });
558
+ it("returns relative paths keyed by the same names", () => {
559
+ const paths = resolveVaultMindPaths(testDir);
560
+ assert.equal(paths.relative.vaultMindDir, ".vault-mind");
561
+ assert.equal(paths.relative.config, path.join(".vault-mind", "vault-mind.config.json"));
562
+ assert.equal(paths.relative.tokenEnv, path.join(".vault-mind", "vault-mind.env"));
563
+ });
564
+ it("reports whether key files exist on disk", () => {
565
+ const paths = resolveVaultMindPaths(testDir);
566
+ // Config was written by writeConfig, so it exists
567
+ assert.equal(paths.exists.config, true);
568
+ // Token env was not written
569
+ assert.equal(paths.exists.tokenEnv, false);
570
+ });
571
+ it("returns null for captureNote when not configured", () => {
572
+ const paths = resolveVaultMindPaths(testDir);
573
+ assert.equal(paths.captureNote, null);
574
+ assert.equal(paths.relative.captureNote, null);
575
+ });
576
+ it("resolves captureNote when configured", () => {
577
+ writeConfig(testDir, {
578
+ vaultMind: {
579
+ vaults: { default: { path: testDir } },
580
+ embedding: { model: "test-model" },
581
+ files: { captureNote: "notes/capture.md" },
582
+ },
583
+ });
584
+ const paths = resolveVaultMindPaths(testDir);
585
+ assert.equal(paths.captureNote, path.join(testDir, "notes", "capture.md"));
586
+ assert.equal(paths.relative.captureNote, path.join("notes", "capture.md"));
587
+ });
588
+ });