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
@@ -4,9 +4,9 @@ import * as path from "node:path";
4
4
  import { afterEach, beforeEach, describe, it } from "node:test";
5
5
  import { _resetAuthCache, authoriseRequest, clearToken, resolveAuthToken, rotateToken, setToken, } from "../src/auth.js";
6
6
  const envVar = "PVM_API_TOKEN";
7
- const noop = () => { };
8
7
  const cleanupEnv = () => {
9
8
  delete process.env[envVar];
9
+ delete process.env.PVM_TOKEN_MANAGER;
10
10
  _resetAuthCache();
11
11
  };
12
12
  const tmpVault = () => {
@@ -18,81 +18,83 @@ const tmpVault = () => {
18
18
  };
19
19
  describe("auth (server-side bearer token)", () => {
20
20
  let savedEnv;
21
- let homeSnapshot;
22
- let fakeHome = null;
21
+ let savedManagerToken;
22
+ let savedCwd;
23
+ let testDir;
23
24
  beforeEach(() => {
24
25
  savedEnv = process.env[envVar];
25
- homeSnapshot = process.env.HOME;
26
+ savedManagerToken = process.env.PVM_TOKEN_MANAGER;
27
+ savedCwd = process.cwd();
26
28
  cleanupEnv();
27
- fakeHome = tmpVault();
28
- process.env.HOME = fakeHome;
29
+ testDir = tmpVault();
30
+ process.chdir(testDir);
29
31
  });
30
32
  afterEach(() => {
31
33
  if (savedEnv === undefined)
32
34
  delete process.env[envVar];
33
35
  else
34
36
  process.env[envVar] = savedEnv;
35
- if (homeSnapshot === undefined)
36
- process.env.HOME = undefined;
37
+ if (savedManagerToken === undefined)
38
+ delete process.env.PVM_TOKEN_MANAGER;
37
39
  else
38
- process.env.HOME = homeSnapshot;
39
- if (fakeHome)
40
- fs.rmSync(fakeHome, { recursive: true });
40
+ process.env.PVM_TOKEN_MANAGER = savedManagerToken;
41
+ process.chdir(savedCwd);
42
+ if (testDir)
43
+ fs.rmSync(testDir, { recursive: true });
41
44
  _resetAuthCache();
42
45
  });
43
- it("env var wins over dotenv and config", () => {
46
+ it("env var wins over dotenv", () => {
44
47
  process.env[envVar] = "env-token";
45
- fs.mkdirSync(path.join(fakeHome, ".pi", "agent"), { recursive: true });
46
- fs.writeFileSync(path.join(fakeHome, ".pi", "agent", "vault-mind.env"), 'PVM_API_TOKEN="dotenv-token"\n', "utf-8");
48
+ const dotenvDir = path.join(process.cwd(), ".vault-mind");
49
+ fs.mkdirSync(dotenvDir, { recursive: true });
50
+ fs.writeFileSync(path.join(dotenvDir, "vault-mind.env"), 'PVM_API_TOKEN="dotenv-token"\n', "utf-8");
51
+ assert.equal(resolveAuthToken(), "env-token");
52
+ });
53
+ it("dotenv is used when env is unset", () => {
54
+ const dotenvDir = path.join(process.cwd(), ".vault-mind");
55
+ fs.mkdirSync(dotenvDir, { recursive: true });
56
+ fs.writeFileSync(path.join(dotenvDir, "vault-mind.env"), 'PVM_API_TOKEN="dotenv-token"\n', "utf-8");
57
+ assert.equal(resolveAuthToken(), "dotenv-token");
58
+ });
59
+ it("remoteApiKey never authenticates a bridge request", () => {
60
+ process.env.PVM_TOKEN_MANAGER = "BRIDGE_ONLY_SENTINEL";
47
61
  const cfg = {
48
62
  version: 2,
49
63
  collections: {},
50
64
  injectors: [],
51
65
  vaultMind: {
52
66
  dataDir: ".lancedb",
53
- embedding: { remoteUrl: "https://pvm.modal.run", modal: { apiToken: "cfg-token" } },
67
+ embedding: {
68
+ remoteUrl: "https://pvm.modal.run",
69
+ remoteApiKey: "REMOTE_PROVIDER_SENTINEL",
70
+ },
54
71
  },
55
72
  };
56
- assert.equal(resolveAuthToken(cfg), "env-token");
57
- });
58
- it("dotenv wins over config when env is unset", () => {
59
- fs.mkdirSync(path.join(fakeHome, ".pi", "agent"), { recursive: true });
60
- fs.writeFileSync(path.join(fakeHome, ".pi", "agent", "vault-mind.env"), 'PVM_API_TOKEN="dotenv-token"\n', "utf-8");
61
- const cfg = {
62
- version: 2,
63
- collections: {},
64
- injectors: [],
65
- vaultMind: {
66
- dataDir: ".lancedb",
67
- embedding: { remoteUrl: "https://pvm.modal.run", modal: { apiToken: "cfg-token" } },
68
- },
69
- };
70
- assert.equal(resolveAuthToken(cfg), "dotenv-token");
71
- });
72
- it("config wins when env and dotenv are unset", () => {
73
- const cfg = {
74
- version: 2,
75
- collections: {},
76
- injectors: [],
77
- vaultMind: {
78
- dataDir: ".lancedb",
79
- embedding: { remoteUrl: "https://pvm.modal.run", modal: { apiToken: "cfg-token" } },
80
- },
81
- };
82
- assert.equal(resolveAuthToken(cfg), "cfg-token");
73
+ const result = Reflect.apply(authoriseRequest, undefined, [
74
+ { headers: { authorization: "Bearer REMOTE_PROVIDER_SENTINEL" } },
75
+ cfg,
76
+ ]);
77
+ assert.deepEqual(result, { ok: false, reason: "mismatch" });
78
+ assert.equal(JSON.stringify(result).includes("REMOTE_PROVIDER_SENTINEL"), false);
79
+ assert.equal(JSON.stringify(result).includes("BRIDGE_ONLY_SENTINEL"), false);
83
80
  });
84
81
  it("returns null when nothing is configured (auth off)", () => {
85
82
  assert.equal(resolveAuthToken(), null);
86
83
  });
87
84
  it("dotenv parsing handles comments, blank lines, and quotes", () => {
88
- fs.mkdirSync(path.join(fakeHome, ".pi", "agent"), { recursive: true });
89
- fs.writeFileSync(path.join(fakeHome, ".pi", "agent", "vault-mind.env"), '# a comment\n\nOTHER_VAR=foo\nPVM_API_TOKEN="quoted token"\nPVM_API_TOKEN=unquoted\n', "utf-8");
85
+ const dotenvDir = path.join(process.cwd(), ".vault-mind");
86
+ fs.mkdirSync(dotenvDir, { recursive: true });
87
+ fs.writeFileSync(path.join(dotenvDir, "vault-mind.env"), '# a comment\n\nOTHER_VAR=foo\nPVM_API_TOKEN="quoted token"\nPVM_API_TOKEN=unquoted\n', "utf-8");
90
88
  assert.equal(resolveAuthToken(), "quoted token");
91
89
  });
92
90
  it("authoriseRequest returns ok when no token is configured", () => {
93
91
  const result = authoriseRequest({ headers: {} });
94
92
  assert.equal(result.ok, true);
95
93
  });
94
+ it("auth completely off authorizes an arbitrary bearer header", () => {
95
+ const result = authoriseRequest({ headers: { authorization: "Bearer anything" } });
96
+ assert.deepEqual(result, { ok: true });
97
+ });
96
98
  it("authoriseRequest rejects requests with no Authorization header", () => {
97
99
  process.env[envVar] = "secret";
98
100
  const result = authoriseRequest({ headers: {} });
@@ -116,18 +118,19 @@ describe("auth (server-side bearer token)", () => {
116
118
  const result = authoriseRequest({ headers: { authorization: "Bearer secret" } });
117
119
  assert.equal(result.ok, true);
118
120
  });
119
- it("uses os.homedir() and does not consult process.cwd()", () => {
120
- // Set a token in the fake home; switch cwd somewhere else; expect the token.
121
- fs.mkdirSync(path.join(fakeHome, ".pi", "agent"), { recursive: true });
122
- fs.writeFileSync(path.join(fakeHome, ".pi", "agent", "vault-mind.env"), 'PVM_API_TOKEN="home-token"\n', "utf-8");
123
- const cwd = process.cwd();
121
+ it("uses process.cwd() and does not consult os.homedir()", () => {
122
+ // Write a token in the cwd's .vault-mind; switch cwd somewhere else; expect null.
123
+ const dotenvDir = path.join(process.cwd(), ".vault-mind");
124
+ fs.mkdirSync(dotenvDir, { recursive: true });
125
+ fs.writeFileSync(path.join(dotenvDir, "vault-mind.env"), 'PVM_API_TOKEN="cwd-token"\n', "utf-8");
126
+ const origCwd = process.cwd();
124
127
  const other = tmpVault();
125
128
  try {
126
129
  process.chdir(other);
127
- assert.equal(resolveAuthToken(), "home-token");
130
+ assert.equal(resolveAuthToken(), null);
128
131
  }
129
132
  finally {
130
- process.chdir(cwd);
133
+ process.chdir(origCwd);
131
134
  fs.rmSync(other, { recursive: true });
132
135
  }
133
136
  });
@@ -147,9 +150,9 @@ describe("auth (server-side bearer token)", () => {
147
150
  // base64url chars only
148
151
  assert.match(token, /^[A-Za-z0-9_-]+$/, "token should be base64url");
149
152
  });
150
- it("rotateToken writes PVM_API_TOKEN to <home>/.pi/agent/vault-mind.env", () => {
153
+ it("rotateToken writes PVM_API_TOKEN to <cwd>/.vault-mind/vault-mind.env", () => {
151
154
  const token = rotateToken();
152
- const envPath = path.join(fakeHome, ".pi", "agent", "vault-mind.env");
155
+ const envPath = path.join(process.cwd(), ".vault-mind", "vault-mind.env");
153
156
  assert.ok(fs.existsSync(envPath), "vault-mind.env should be created");
154
157
  const content = fs.readFileSync(envPath, "utf-8");
155
158
  assert.ok(content.includes(`PVM_API_TOKEN="${token}"`), "file should contain new token");
@@ -170,7 +173,7 @@ describe("auth (server-side bearer token)", () => {
170
173
  assert.equal(newResult.ok, true);
171
174
  });
172
175
  it("rotateToken preserves other lines in vault-mind.env", () => {
173
- const envDir = path.join(fakeHome, ".pi", "agent");
176
+ const envDir = path.join(process.cwd(), ".vault-mind");
174
177
  fs.mkdirSync(envDir, { recursive: true });
175
178
  const envPath = path.join(envDir, "vault-mind.env");
176
179
  fs.writeFileSync(envPath, '# machine config\nOTHER_VAR=hello\nPVM_API_TOKEN="old-token"\n', "utf-8");
@@ -181,6 +184,4 @@ describe("auth (server-side bearer token)", () => {
181
184
  assert.ok(content.includes(`PVM_API_TOKEN="${newToken}"`), "new token line should be present");
182
185
  assert.ok(!content.includes("old-token"), "old token should be gone");
183
186
  });
184
- // silence unused-var
185
- noop();
186
187
  });
@@ -19,7 +19,7 @@ import * as path from "node:path";
19
19
  import { after, afterEach, before, beforeEach, describe, it } from "node:test";
20
20
  import { MessageBus } from "../src/agent-bus/MessageBus.js";
21
21
  import { createBridge, isToolAllowed, registerAgentIdentity, unregisterAgentIdentity, } from "../src/bridge.js";
22
- import { buildIdentityFromRole } from "../src/engine.js";
22
+ import { buildIdentityFromRole, mergeIdentityProfiles } from "../src/engine.js";
23
23
  import { registerAllExtensionTools } from "../src/vm-handlers.js";
24
24
  // ── Shared bus + bridge (one per file — module-level handlers are singletons) ─
25
25
  const fakePi = {
@@ -73,7 +73,9 @@ function getResultText(resp) {
73
73
  /** Write a minimal project config. dataDir must be an absolute path outside dir to avoid
74
74
  * cleanup races with the background upsertEntry call in handleVmAppend. */
75
75
  function writeProjectConfig(dir, dataDir) {
76
- fs.writeFileSync(path.join(dir, "pi-vault-mind.config.json"), JSON.stringify({
76
+ const configDir = path.join(dir, ".vault-mind");
77
+ fs.mkdirSync(configDir, { recursive: true });
78
+ fs.writeFileSync(path.join(configDir, "vault-mind.config.json"), JSON.stringify({
77
79
  version: 2,
78
80
  collections: {
79
81
  main: {
@@ -90,7 +92,7 @@ function writeProjectConfig(dir, dataDir) {
90
92
  injectors: [],
91
93
  vaultMind: {
92
94
  dataDir,
93
- embedding: { provider: "transformers" },
95
+ embedding: {},
94
96
  ftsEnabled: false,
95
97
  graph: { enabled: false },
96
98
  },
@@ -386,3 +388,32 @@ describe("handleVmPromote — canPublish guard", () => {
386
388
  assert.ok(!text.includes("not authorized to publish"), `Got unexpected auth error: "${text}"`);
387
389
  });
388
390
  });
391
+ // ─────────────────────────────────────────────────────────────────────────────
392
+ // Merged identity registration — bridge read-back regression
393
+ // ─────────────────────────────────────────────────────────────────────────────
394
+ // The pure mergeIdentityProfiles contract (field precedence, empty-array deny,
395
+ // id/role immutability, P2/P3 field merge) lives in engine-identity.test.ts.
396
+ // Here we assert only the bridge-specific wiring: a merged identity, once
397
+ // registered, is read back by isToolAllowed (its sole consumer today).
398
+ describe("merged identity registration (bridge read-back)", () => {
399
+ const base = buildIdentityFromRole("miner", `merge-base-${randomUUID()}`);
400
+ // Partial-but-valid IdentityConfig: `undefined` means "leave base untouched".
401
+ const layer = (over = {}) => ({
402
+ allowedTools: undefined,
403
+ readCollections: undefined,
404
+ writeCollections: undefined,
405
+ allowedVaultPaths: undefined,
406
+ canPublish: undefined,
407
+ ...over,
408
+ });
409
+ it("reads back the merged identity that was registered (regression for bridge identity map)", () => {
410
+ // merge returns the identity; registerAgentIdentity puts it in a map;
411
+ // isToolAllowed is the only path that reads the registered identity back.
412
+ const defaultProfile = layer({ allowedTools: ["vm_search"] });
413
+ const merged = mergeIdentityProfiles(base, defaultProfile, undefined);
414
+ registerAgentIdentity(merged);
415
+ assert.equal(isToolAllowed(merged.id, "vm_search"), true);
416
+ assert.equal(isToolAllowed(merged.id, "vm_append"), false); // not in override
417
+ unregisterAgentIdentity(merged.id);
418
+ });
419
+ });
@@ -0,0 +1,51 @@
1
+ import { strict as assert } from "node:assert";
2
+ import { describe, it } from "node:test";
3
+ import { classifySearchMode } from "../src/vault-tools.js";
4
+ describe("classifySearchMode", () => {
5
+ it("classifies quoted phrases as fts", () => {
6
+ const r = classifySearchMode('"exact phrase"');
7
+ assert.equal(r.mode, "fts");
8
+ assert.ok(r.rationale.length > 0);
9
+ });
10
+ it("classifies entity queries as graph", () => {
11
+ const r = classifySearchMode("who is Ada");
12
+ assert.equal(r.mode, "graph");
13
+ assert.ok(r.rationale.length > 0);
14
+ });
15
+ it("classifies natural-language questions as semantic", () => {
16
+ const r = classifySearchMode("how do I auth?");
17
+ assert.equal(r.mode, "semantic");
18
+ assert.ok(r.rationale.length > 0);
19
+ });
20
+ it("classifies short keywords as hybrid", () => {
21
+ const r = classifySearchMode("auth token");
22
+ assert.equal(r.mode, "hybrid");
23
+ assert.ok(r.rationale.length > 0);
24
+ });
25
+ it("classifies long descriptive phrases as semantic", () => {
26
+ const r = classifySearchMode("implement the search backend bridge gaps plan");
27
+ assert.equal(r.mode, "semantic");
28
+ assert.ok(r.rationale.length > 0);
29
+ });
30
+ it("classifies empty query as hybrid", () => {
31
+ const r = classifySearchMode("");
32
+ assert.equal(r.mode, "hybrid");
33
+ assert.ok(r.rationale.length > 0);
34
+ });
35
+ it("classifies 'what are the connections' as graph", () => {
36
+ const r = classifySearchMode("what are the connections of Project X");
37
+ assert.equal(r.mode, "graph");
38
+ assert.ok(r.rationale.length > 0);
39
+ });
40
+ it("classifies 'related to' as graph", () => {
41
+ const r = classifySearchMode("notes related to authentication");
42
+ assert.equal(r.mode, "graph");
43
+ assert.ok(r.rationale.length > 0);
44
+ });
45
+ it("always provides a non-empty rationale", () => {
46
+ const queries = ["", "test", '"quoted"', "who is X", "how?", "a b c d e"];
47
+ for (const q of queries) {
48
+ assert.ok(classifySearchMode(q).rationale.length > 0, `empty rationale for "${q}"`);
49
+ }
50
+ });
51
+ });