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
@@ -1,68 +1,30 @@
1
1
  import { strict as assert } from "node:assert";
2
2
  import * as fs from "node:fs";
3
- import * as http from "node:http";
3
+ import * as os from "node:os";
4
4
  import * as path from "node:path";
5
5
  import { after, before, describe, it } from "node:test";
6
6
  import { _resetAuthCache } from "../src/auth.js";
7
- import { createServerState, startServer, stopServer } from "../src/server.js";
8
- import { createWatcherState } from "../src/watcher.js";
7
+ import { fakePi, fetchJson, makeVault, startTestServer, TEST_TOKEN, } from "./helpers/server.js";
9
8
  const envVar = "PVM_API_TOKEN";
10
- const tmpVault = () => {
11
- const p = path.join(process.cwd(), `.tmp-rest-vm-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
12
- if (fs.existsSync(p))
13
- fs.rmSync(p, { recursive: true });
14
- fs.mkdirSync(p, { recursive: true });
15
- return p;
16
- };
17
- const fetchJson = (port, method, path, body, token) => new Promise((resolve, reject) => {
18
- const opts = {
19
- hostname: "127.0.0.1",
20
- port,
21
- path,
22
- method,
23
- headers: {
24
- "Content-Type": "application/json",
25
- ...(token ? { Authorization: `Bearer ${token}` } : {}),
26
- },
27
- };
28
- const req = http.request(opts, (res) => {
29
- let raw = "";
30
- res.on("data", (chunk) => {
31
- raw += chunk.toString();
32
- });
33
- res.on("end", () => {
34
- try {
35
- resolve({ status: res.statusCode ?? 0, data: JSON.parse(raw) });
36
- }
37
- catch {
38
- resolve({ status: res.statusCode ?? 0, data: raw });
39
- }
40
- });
41
- });
42
- req.on("error", reject);
43
- if (body !== undefined)
44
- req.write(JSON.stringify(body));
45
- req.end();
46
- });
47
9
  describe("REST vm routes", () => {
48
10
  let vaultPath;
49
11
  let port;
50
- let serverState;
51
- let watcherState;
12
+ let srv;
52
13
  let savedEnv;
53
- let savedHome;
54
- const fakePi = {
55
- sendUserMessage: () => { },
56
- events: { emit: () => { } },
57
- };
14
+ let savedCwd;
58
15
  before(async () => {
59
16
  savedEnv = process.env[envVar];
60
- savedHome = process.env.HOME;
61
- process.env[envVar] = "test-token";
62
- vaultPath = tmpVault();
63
- process.env.HOME = vaultPath;
64
- // Create a minimal vault config so loadConfig works
65
- fs.writeFileSync(path.join(vaultPath, "pi-vault-mind.config.json"), JSON.stringify({
17
+ savedCwd = process.cwd();
18
+ process.env[envVar] = TEST_TOKEN;
19
+ vaultPath = makeVault("rest-vm");
20
+ process.chdir(vaultPath);
21
+ // Create the collection file in the vault
22
+ fs.mkdirSync(path.join(vaultPath, "collections"), { recursive: true });
23
+ fs.writeFileSync(path.join(vaultPath, "collections", "main.jsonl"), "", "utf-8");
24
+ // Write config to .vault-mind/ (cwd is vaultPath, so this is vault-local)
25
+ const configDir = path.join(vaultPath, ".vault-mind");
26
+ fs.mkdirSync(configDir, { recursive: true });
27
+ fs.writeFileSync(path.join(configDir, "vault-mind.config.json"), JSON.stringify({
66
28
  version: 2,
67
29
  collections: {
68
30
  main: {
@@ -73,93 +35,392 @@ describe("REST vm routes", () => {
73
35
  },
74
36
  vaultMind: {
75
37
  dataDir: ".lancedb",
76
- embedding: { provider: "transformers" },
38
+ embedding: {},
77
39
  ftsEnabled: true,
40
+ vaults: { default: { path: vaultPath } },
78
41
  },
79
42
  }), "utf-8");
80
- // Create the collection file
81
- fs.mkdirSync(path.join(vaultPath, "collections"), { recursive: true });
82
- fs.writeFileSync(path.join(vaultPath, "collections", "main.jsonl"), "", "utf-8");
83
- // Create a global config pointing to this vault
84
- fs.mkdirSync(path.join(vaultPath, ".pi", "agent"), { recursive: true });
85
- fs.writeFileSync(path.join(vaultPath, ".pi", "agent", "vault-mind.config.json"), JSON.stringify({ vaultMind: { vaults: { default: { path: vaultPath } } } }), "utf-8");
86
- serverState = createServerState(0);
87
- watcherState = createWatcherState();
88
- startServer(fakePi, serverState, watcherState);
89
- // Wait for the server to be ready (port 0 means OS assigns a random port)
90
- await new Promise((resolve) => {
91
- const check = () => {
92
- if (serverState.server?.listening)
93
- resolve();
94
- else
95
- setTimeout(check, 10);
96
- };
97
- check();
98
- });
99
- port = serverState.port;
43
+ srv = await startTestServer(fakePi);
44
+ port = srv.port;
100
45
  });
101
46
  after(() => {
102
- stopServer(serverState);
47
+ srv.stop();
103
48
  if (savedEnv === undefined)
104
49
  delete process.env[envVar];
105
50
  else
106
51
  process.env[envVar] = savedEnv;
107
- if (savedHome === undefined)
108
- process.env.HOME = undefined;
109
- else
110
- process.env.HOME = savedHome;
52
+ process.chdir(savedCwd);
111
53
  if (fs.existsSync(vaultPath))
112
54
  fs.rmSync(vaultPath, { recursive: true });
113
55
  _resetAuthCache();
114
56
  });
115
57
  it("POST /vm/search returns 401 without token", async () => {
116
- const { status } = await fetchJson(port, "POST", "/vm/search", { query: "test" });
58
+ const { status } = await fetchJson(port, "POST", "/vm/search", { body: { query: "test" } });
117
59
  assert.equal(status, 401);
118
60
  });
119
61
  it("POST /vm/search returns 200 or 500 with valid token (index may not be built)", async () => {
120
- const { status, data } = await fetchJson(port, "POST", "/vm/search", { query: "test" }, "test-token");
62
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
63
+ body: { query: "test" },
64
+ token: TEST_TOKEN,
65
+ });
121
66
  // 200 if index exists, 500 if LanceDB table not initialized — both are valid responses
122
67
  assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
123
68
  if (status === 200) {
124
- const d = data;
69
+ const d = body;
125
70
  assert.ok(Array.isArray(d.hits));
126
71
  }
127
72
  });
128
73
  it("POST /vm/search returns 400 when query is missing", async () => {
129
- const { status } = await fetchJson(port, "POST", "/vm/search", {}, "test-token");
74
+ const { status } = await fetchJson(port, "POST", "/vm/search", {
75
+ body: {},
76
+ token: TEST_TOKEN,
77
+ });
130
78
  assert.equal(status, 400);
131
79
  });
132
80
  it("POST /vm/search respects collection and limit params", async () => {
133
- const { status } = await fetchJson(port, "POST", "/vm/search", { collection: "main", query: "test", limit: 3 }, "test-token");
81
+ const { status } = await fetchJson(port, "POST", "/vm/search", {
82
+ body: { collection: "main", query: "test", limit: 3 },
83
+ token: TEST_TOKEN,
84
+ });
134
85
  assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
135
86
  });
136
87
  it("POST /vm/append returns 401 without token", async () => {
137
88
  const { status } = await fetchJson(port, "POST", "/vm/append", {
138
- collection: "main",
139
- entry: { id: "1", fact: "hello" },
89
+ body: { collection: "main", entry: { id: "1", fact: "hello" } },
140
90
  });
141
91
  assert.equal(status, 401);
142
92
  });
143
93
  it("POST /vm/append returns 200 or 500 with valid token (index may not be built)", async () => {
144
94
  const { status } = await fetchJson(port, "POST", "/vm/append", {
145
- collection: "main",
146
- mode: "autopilot",
147
- entry: { id: "test-1", domain: "test", source: "test", fact: "hello world", tag: "test" },
148
- }, "test-token");
95
+ body: {
96
+ collection: "main",
97
+ mode: "autopilot",
98
+ entry: { id: "test-1", domain: "test", source: "test", fact: "hello world", tag: "test" },
99
+ },
100
+ token: TEST_TOKEN,
101
+ });
149
102
  assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
150
103
  });
151
104
  it("POST /vm/append returns 400 for unknown collection", async () => {
152
- const { status } = await fetchJson(port, "POST", "/vm/append", { collection: "nonexistent", entry: { id: "1", fact: "x" } }, "test-token");
105
+ const { status } = await fetchJson(port, "POST", "/vm/append", {
106
+ body: { collection: "nonexistent", entry: { id: "1", fact: "x" } },
107
+ token: TEST_TOKEN,
108
+ });
153
109
  assert.equal(status, 400);
154
110
  });
155
111
  it("POST /vm/append returns 400 when entry is missing", async () => {
156
- const { status } = await fetchJson(port, "POST", "/vm/append", { collection: "main" }, "test-token");
112
+ const { status } = await fetchJson(port, "POST", "/vm/append", {
113
+ body: { collection: "main" },
114
+ token: TEST_TOKEN,
115
+ });
116
+ assert.equal(status, 400);
117
+ });
118
+ it("POST /vm/reindex returns 401 without token", async () => {
119
+ const { status } = await fetchJson(port, "POST", "/vm/reindex");
120
+ assert.equal(status, 401);
121
+ });
122
+ it("POST /vm/reindex returns 400 when Modal is not configured", async () => {
123
+ const { status, body } = await fetchJson(port, "POST", "/vm/reindex", {
124
+ body: {},
125
+ token: TEST_TOKEN,
126
+ });
127
+ assert.equal(status, 400);
128
+ assert.ok(typeof body === "object" && body !== null);
129
+ assert.ok("error" in body);
130
+ });
131
+ it("POST /vm/reindex returns 405 for GET method", async () => {
132
+ const { status } = await fetchJson(port, "GET", "/vm/reindex", { token: TEST_TOKEN });
133
+ assert.equal(status, 405);
134
+ });
135
+ it("POST /vm/search defaults to hybrid mode when mode is omitted", async () => {
136
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
137
+ body: { query: "test" },
138
+ token: TEST_TOKEN,
139
+ });
140
+ assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
141
+ if (status === 200) {
142
+ const d = body;
143
+ assert.equal(d.mode, "hybrid");
144
+ }
145
+ });
146
+ it("POST /vm/search mode semantic returns vector-only results", async () => {
147
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
148
+ body: { query: "test", mode: "semantic" },
149
+ token: TEST_TOKEN,
150
+ });
151
+ assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
152
+ if (status === 200) {
153
+ const d = body;
154
+ assert.equal(d.mode, "semantic");
155
+ assert.ok(Array.isArray(d.hits));
156
+ }
157
+ });
158
+ it("POST /vm/search mode fts returns FTS results", async () => {
159
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
160
+ body: { query: "test", mode: "fts" },
161
+ token: TEST_TOKEN,
162
+ });
163
+ assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
164
+ if (status === 200) {
165
+ const d = body;
166
+ assert.equal(d.mode, "fts");
167
+ assert.ok(Array.isArray(d.hits));
168
+ }
169
+ });
170
+ it("POST /vm/search mode graph returns graph results", async () => {
171
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
172
+ body: { query: "test", mode: "graph", entity: "test" },
173
+ token: TEST_TOKEN,
174
+ });
175
+ assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
176
+ if (status === 200) {
177
+ const d = body;
178
+ assert.equal(d.mode, "graph");
179
+ assert.ok(Array.isArray(d.hits), "graph hits is a flat array");
180
+ assert.ok(Array.isArray(d.relations), "graph response has a relations sibling array");
181
+ assert.ok(d.hits.every((h) => h._source === "graph"), "every graph hit is tagged _source: graph");
182
+ }
183
+ });
184
+ it("POST /vm/search mode invalid returns 400", async () => {
185
+ const { status } = await fetchJson(port, "POST", "/vm/search", {
186
+ body: { query: "test", mode: "invalid" },
187
+ token: TEST_TOKEN,
188
+ });
157
189
  assert.equal(status, 400);
158
190
  });
159
191
  it("POST /vm/search and /vm/append both require POST method", async () => {
160
- const s1 = await fetchJson(port, "GET", "/vm/search", undefined, "test-token");
161
- const s2 = await fetchJson(port, "GET", "/vm/append", undefined, "test-token");
192
+ const s1 = await fetchJson(port, "GET", "/vm/search", { token: TEST_TOKEN });
193
+ const s2 = await fetchJson(port, "GET", "/vm/append", { token: TEST_TOKEN });
162
194
  assert.equal(s1.status, 405);
163
195
  assert.equal(s2.status, 405);
164
196
  });
197
+ it("POST /vm/search mode full returns merged results", async () => {
198
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
199
+ body: { query: "test", mode: "full" },
200
+ token: TEST_TOKEN,
201
+ });
202
+ assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
203
+ if (status === 200) {
204
+ const d = body;
205
+ assert.equal(d.mode, "full");
206
+ assert.ok(Array.isArray(d.hits), "full hits is a flat array");
207
+ assert.ok(Array.isArray(d.relations), "full response has a relations sibling array");
208
+ }
209
+ });
210
+ it("POST /vm/search mode vault returns Obsidian-native hits", async () => {
211
+ fs.writeFileSync(path.join(vaultPath, "Alpha Note.md"), "---\ntitle: Alpha Note\ntags: [project]\n---\nBody about alpha.", "utf-8");
212
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
213
+ body: { query: "Alpha", mode: "vault" },
214
+ token: TEST_TOKEN,
215
+ });
216
+ assert.equal(status, 200, `vault mode should not touch LanceDB; got ${status}`);
217
+ const d = body;
218
+ assert.equal(d.mode, "vault");
219
+ assert.ok(Array.isArray(d.hits), "vault hits is a flat array");
220
+ const hits = d.hits;
221
+ assert.ok(hits.some((h) => h._source === "vault" && String(h.source).endsWith("Alpha Note.md")), "vault mode surfaces the matching note tagged _source: vault");
222
+ });
223
+ it("POST /vm/search mode auto returns resolvedMode and rationale", async () => {
224
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
225
+ body: { query: "test", mode: "auto" },
226
+ token: TEST_TOKEN,
227
+ });
228
+ assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
229
+ if (status === 200) {
230
+ const d = body;
231
+ assert.equal(d.mode, "auto");
232
+ assert.ok(d.resolvedMode !== undefined, "resolvedMode should be present");
233
+ const rm = d.resolvedMode;
234
+ assert.ok(rm === "hybrid" || rm === "semantic" || rm === "fts" || rm === "graph", `resolvedMode should be a concrete mode, got ${rm}`);
235
+ assert.ok(typeof d.rationale === "string" && d.rationale.length > 0, "rationale should be non-empty");
236
+ assert.ok(Array.isArray(d.sources), "sources should be an array");
237
+ }
238
+ });
239
+ it("POST /vm/search mode auto with quoted query resolves to fts", async () => {
240
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
241
+ body: { query: '"exact phrase"', mode: "auto" },
242
+ token: TEST_TOKEN,
243
+ });
244
+ assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
245
+ if (status === 200) {
246
+ const d = body;
247
+ assert.equal(d.resolvedMode, "fts");
248
+ }
249
+ });
250
+ it("POST /vm/search mode auto with no query returns 400", async () => {
251
+ const { status } = await fetchJson(port, "POST", "/vm/search", {
252
+ body: { mode: "auto" },
253
+ token: TEST_TOKEN,
254
+ });
255
+ assert.equal(status, 400);
256
+ });
257
+ it("POST /vm/search echoes sources in response", async () => {
258
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
259
+ body: { query: "test", sources: ["vault"] },
260
+ token: TEST_TOKEN,
261
+ });
262
+ assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
263
+ if (status === 200) {
264
+ const d = body;
265
+ assert.ok(Array.isArray(d.sources), "sources should be echoed");
266
+ }
267
+ });
268
+ it("POST /vm/search with sources sessions merges session hits", async () => {
269
+ // Seed a temp sessions dir
270
+ const tmpSessions = fs.mkdtempSync(path.join(os.tmpdir(), "pvm-rest-sessions-"));
271
+ const slugDir = path.join(tmpSessions, "--test--");
272
+ fs.mkdirSync(slugDir, { recursive: true });
273
+ const sessionFile = path.join(slugDir, "2026-07-13T14-25-00_abc.jsonl");
274
+ fs.writeFileSync(sessionFile, [
275
+ JSON.stringify({ type: "session", id: "s1", cwd: "/test", timestamp: "T" }),
276
+ JSON.stringify({ type: "session_name", name: "Test" }),
277
+ JSON.stringify({
278
+ type: "message",
279
+ id: "m1",
280
+ timestamp: "T",
281
+ message: { role: "user", content: "searchtestquery content here" },
282
+ }),
283
+ ].join("\n") + "\n", "utf-8");
284
+ const savedDir = process.env.PI_SESSIONS_DIR;
285
+ try {
286
+ process.env.PI_SESSIONS_DIR = tmpSessions;
287
+ const { status, body } = await fetchJson(port, "POST", "/vm/search", {
288
+ body: { query: "searchtestquery", mode: "vault", sources: ["sessions"] },
289
+ token: TEST_TOKEN,
290
+ });
291
+ assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
292
+ if (status === 200) {
293
+ const d = body;
294
+ const hits = d.hits;
295
+ assert.ok(hits.some((h) => h._source === "session"), "should contain at least one session hit");
296
+ }
297
+ }
298
+ finally {
299
+ if (savedDir === undefined)
300
+ delete process.env.PI_SESSIONS_DIR;
301
+ else
302
+ process.env.PI_SESSIONS_DIR = savedDir;
303
+ fs.rmSync(tmpSessions, { recursive: true, force: true });
304
+ }
305
+ });
306
+ describe("/vm/edits", () => {
307
+ it("POST /vm/edits returns 401 without token", async () => {
308
+ const { status } = await fetchJson(port, "POST", "/vm/edits", {
309
+ body: { path: "notes/edit.md", oldText: "old", newText: "new" },
310
+ });
311
+ assert.equal(status, 401);
312
+ });
313
+ it("POST /vm/edits returns 400 when missing required fields", async () => {
314
+ const { status, body } = await fetchJson(port, "POST", "/vm/edits", {
315
+ body: { path: "notes/edit.md" },
316
+ token: TEST_TOKEN,
317
+ });
318
+ assert.equal(status, 400);
319
+ assert.ok(typeof body === "object" && body !== null);
320
+ assert.ok("error" in body);
321
+ });
322
+ it("POST /vm/edits returns 201 with valid data and returns the created edit", async () => {
323
+ const { status, body } = await fetchJson(port, "POST", "/vm/edits", {
324
+ body: {
325
+ path: "notes/edit.md",
326
+ oldText: "hello world",
327
+ newText: "hello vault mind",
328
+ },
329
+ token: TEST_TOKEN,
330
+ });
331
+ assert.equal(status, 201);
332
+ assert.ok(typeof body === "object" && body !== null);
333
+ const d = body;
334
+ assert.ok("edit" in d);
335
+ const edit = d.edit;
336
+ assert.equal(edit.path, "notes/edit.md");
337
+ assert.equal(edit.oldText, "hello world");
338
+ assert.equal(edit.newText, "hello vault mind");
339
+ assert.equal(edit.status, "pending");
340
+ });
341
+ it("GET /vm/edits returns 200 with list of edits", async () => {
342
+ const { status, body } = await fetchJson(port, "GET", "/vm/edits", { token: TEST_TOKEN });
343
+ assert.equal(status, 200);
344
+ assert.ok(typeof body === "object" && body !== null);
345
+ const d = body;
346
+ assert.ok(Array.isArray(d.edits));
347
+ assert.ok(d.edits.length >= 1);
348
+ });
349
+ it("GET /vm/edits returns 200 filtered by path", async () => {
350
+ const { status, body } = await fetchJson(port, "GET", "/vm/edits?path=notes/edit.md", {
351
+ token: TEST_TOKEN,
352
+ });
353
+ assert.equal(status, 200);
354
+ const d = body;
355
+ assert.ok(Array.isArray(d.edits));
356
+ assert.ok(d.edits.every((e) => e.path === "notes/edit.md"));
357
+ });
358
+ it("GET /vm/edits/:id returns 200 for existing edit", async () => {
359
+ const create = await fetchJson(port, "POST", "/vm/edits", {
360
+ body: { path: "notes/get.md", oldText: "a", newText: "b" },
361
+ token: TEST_TOKEN,
362
+ });
363
+ const id = String(create.body.edit.id);
364
+ const { status, body } = await fetchJson(port, "GET", `/vm/edits/${id}`, {
365
+ token: TEST_TOKEN,
366
+ });
367
+ assert.equal(status, 200);
368
+ const d = body;
369
+ assert.equal(d.edit.id, id);
370
+ });
371
+ it("GET /vm/edits/:id returns 404 for non-existent edit", async () => {
372
+ const { status, body } = await fetchJson(port, "GET", "/vm/edits/non-existent-id", {
373
+ token: TEST_TOKEN,
374
+ });
375
+ assert.equal(status, 404);
376
+ assert.ok(typeof body === "object" && body !== null);
377
+ assert.ok("error" in body);
378
+ });
379
+ it("POST /vm/edits/:id/apply returns 200 for valid edit", async () => {
380
+ const filePath = "notes/apply-target.md";
381
+ fs.mkdirSync(path.join(vaultPath, "notes"), { recursive: true });
382
+ fs.writeFileSync(path.join(vaultPath, filePath), "original text", "utf-8");
383
+ const create = await fetchJson(port, "POST", "/vm/edits", {
384
+ body: {
385
+ path: filePath,
386
+ oldText: "original text",
387
+ newText: "updated text",
388
+ },
389
+ token: TEST_TOKEN,
390
+ });
391
+ const id = String(create.body.edit.id);
392
+ const { status, body } = await fetchJson(port, "POST", `/vm/edits/${id}/apply`, {
393
+ token: TEST_TOKEN,
394
+ });
395
+ assert.equal(status, 200);
396
+ assert.ok(typeof body === "object" && body !== null);
397
+ assert.equal(body.ok, true);
398
+ assert.equal(fs.readFileSync(path.join(vaultPath, filePath), "utf-8"), "updated text");
399
+ });
400
+ it("POST /vm/edits/:id/reject returns 200 for valid edit", async () => {
401
+ const create = await fetchJson(port, "POST", "/vm/edits", {
402
+ body: {
403
+ path: "notes/reject.md",
404
+ oldText: "old",
405
+ newText: "new",
406
+ },
407
+ token: TEST_TOKEN,
408
+ });
409
+ const id = String(create.body.edit.id);
410
+ const { status, body } = await fetchJson(port, "POST", `/vm/edits/${id}/reject`, {
411
+ token: TEST_TOKEN,
412
+ });
413
+ assert.equal(status, 200);
414
+ assert.ok(typeof body === "object" && body !== null);
415
+ assert.equal(body.ok, true);
416
+ const get = await fetchJson(port, "GET", `/vm/edits/${id}`, { token: TEST_TOKEN });
417
+ assert.equal(get.body.edit.status, "rejected");
418
+ });
419
+ it("unsupported /vm/edits verbs return 405", async () => {
420
+ const s1 = await fetchJson(port, "PUT", "/vm/edits", { token: TEST_TOKEN });
421
+ const s2 = await fetchJson(port, "DELETE", "/vm/edits", { token: TEST_TOKEN });
422
+ assert.equal(s1.status, 405);
423
+ assert.equal(s2.status, 405);
424
+ });
425
+ });
165
426
  });
@@ -0,0 +1,48 @@
1
+ import { strict as assert } from "node:assert";
2
+ import { describe, it } from "node:test";
3
+ import { applyCorsPolicy } from "../src/server.js";
4
+ const SERVER_PORT = 11435;
5
+ function fakeResponse() {
6
+ const headers = {};
7
+ return {
8
+ setHeader(name, value) {
9
+ headers[name] = value;
10
+ },
11
+ get headers() {
12
+ return headers;
13
+ },
14
+ };
15
+ }
16
+ const REST_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"];
17
+ function assertCorsMethods(headers) {
18
+ const methods = String(headers["Access-Control-Allow-Methods"] ?? "");
19
+ for (const method of REST_METHODS) {
20
+ assert.ok(methods.includes(method), `expected ${method} in Access-Control-Allow-Methods: ${methods}`);
21
+ }
22
+ }
23
+ describe("applyCorsPolicy", () => {
24
+ it("reflects the Obsidian renderer origin and allows Authorization + Content-Type headers", () => {
25
+ const res = fakeResponse();
26
+ applyCorsPolicy("app://obsidian.md", SERVER_PORT, res);
27
+ assert.equal(res.headers["Access-Control-Allow-Origin"], "app://obsidian.md");
28
+ const allowed = String(res.headers["Access-Control-Allow-Headers"] ?? "");
29
+ assert.ok(allowed.includes("Authorization"), `expected Authorization in ${allowed}`);
30
+ assert.ok(allowed.includes("Content-Type"), `expected Content-Type in ${allowed}`);
31
+ assert.equal(res.headers["Vary"], "Origin");
32
+ assertCorsMethods(res.headers);
33
+ });
34
+ it("preserves the server's own http://localhost:11435 origin", () => {
35
+ const res = fakeResponse();
36
+ applyCorsPolicy(`http://localhost:${SERVER_PORT}`, SERVER_PORT, res);
37
+ assert.equal(res.headers["Access-Control-Allow-Origin"], `http://localhost:${SERVER_PORT}`);
38
+ assert.equal(res.headers["Vary"], "Origin");
39
+ assertCorsMethods(res.headers);
40
+ });
41
+ it("does not reflect an untrusted origin", () => {
42
+ const res = fakeResponse();
43
+ applyCorsPolicy("https://evil.example.com", SERVER_PORT, res);
44
+ assert.notEqual(res.headers["Access-Control-Allow-Origin"], "https://evil.example.com");
45
+ assert.equal(res.headers["Vary"], "Origin");
46
+ assertCorsMethods(res.headers);
47
+ });
48
+ });