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
package/package.json CHANGED
@@ -1,91 +1,108 @@
1
1
  {
2
- "name": "pi-vault-mind",
3
- "version": "0.14.2",
4
- "description": "Passive Obsidian vault extension for pi. Watches @agent markers, dispatches forked subagents (Miner, Broadcaster, Heavy-Lifter), stores in LanceDB with vector + FTS + graph. Multi-agent 'Drop & Forget' workflow for the pi agent ecosystem.",
5
- "main": "dist/index.js",
6
- "types": "dist/index.d.ts",
7
- "type": "module",
8
- "files": [
9
- "dist",
10
- "agents",
11
- "skills",
12
- "scripts",
13
- "pi-vault-mind.config.example.json",
14
- "CHANGELOG.md",
15
- "README.md",
16
- "LICENSE"
17
- ],
18
- "keywords": [
19
- "pi-package",
20
- "pi-extension",
21
- "pi-skills",
22
- "vault-mind",
23
- "jsonl",
24
- "lance",
25
- "lancedb",
26
- "search",
27
- "knowledge-base",
28
- "agent-tools",
29
- "hitl",
30
- "semantic-search",
31
- "obsidian",
32
- "obsidian-vault",
33
- "subagent",
34
- "subagents",
35
- "passive",
36
- "file-watcher",
37
- "graph",
38
- "knowledge-graph",
39
- "notebooklm",
40
- "pkm"
41
- ],
42
- "author": "Kyle Brodeur",
43
- "license": "MIT",
44
- "repository": {
45
- "type": "git",
46
- "url": "git+https://github.com/kylebrodeur/pi-vault-mind.git"
47
- },
48
- "bugs": {
49
- "url": "https://github.com/kylebrodeur/pi-vault-mind/issues"
50
- },
51
- "homepage": "https://github.com/kylebrodeur/pi-vault-mind#readme",
52
- "engines": {
53
- "node": ">=20.6.0"
54
- },
55
- "pi": {
56
- "extensions": [
57
- "./dist/index.js"
58
- ],
59
- "skills": [
60
- "./skills"
61
- ]
62
- },
63
- "dependencies": {
64
- "@lancedb/lancedb": "latest",
65
- "@xenova/transformers": "latest",
66
- "apache-arrow": "^21.1.0",
67
- "ws": "^8.21.0"
68
- },
69
- "peerDependencies": {
70
- "@earendil-works/pi-coding-agent": ">=0.75.0 <1.0.0"
71
- },
72
- "devDependencies": {
73
- "@biomejs/biome": "^1.9.0",
74
- "@davidvkimball/obsidian-dev-skills": "^1.3.1",
75
- "@earendil-works/pi-coding-agent": "^0.79.0",
76
- "@earendil-works/pi-tui": "^0.79.0",
77
- "@types/node": "^20.0.0",
78
- "@types/ws": "^8.18.1",
79
- "husky": "^9.1.6",
80
- "typebox": "^1.1.0",
81
- "typescript": "^5.0.0"
82
- },
83
- "scripts": {
84
- "check": "biome check --write . && tsc --noEmit",
85
- "build": "tsc && tsc -p tsconfig.test.json",
86
- "dev": "tsc --watch",
87
- "test": "node --test dist/test/*.test.js",
88
- "e2e:ws": "node scripts/e2e-ws.mjs",
89
- "e2e:modal": "node scripts/modal-e2e-smoke.mjs"
90
- }
91
- }
2
+ "name": "pi-vault-mind",
3
+ "version": "0.16.3",
4
+ "description": "Passive Obsidian vault extension for pi. Watches @agent markers, dispatches forked subagents (Miner, Broadcaster, Heavy-Lifter), stores in LanceDB with vector + FTS + graph. Multi-agent 'Drop & Forget' workflow for the pi agent ecosystem.",
5
+ "main": "dist/index.js",
6
+ "types": "dist/index.d.ts",
7
+ "type": "module",
8
+ "files": [
9
+ "dist",
10
+ "agents",
11
+ "skills",
12
+ "scripts",
13
+ "extension-packages.json",
14
+ "pi-vault-mind.config.example.json",
15
+ "CHANGELOG.md",
16
+ "README.md",
17
+ "LICENSE"
18
+ ],
19
+ "keywords": [
20
+ "pi-package",
21
+ "pi-extension",
22
+ "pi-skills",
23
+ "vault-mind",
24
+ "jsonl",
25
+ "lance",
26
+ "lancedb",
27
+ "search",
28
+ "knowledge-base",
29
+ "agent-tools",
30
+ "hitl",
31
+ "semantic-search",
32
+ "obsidian",
33
+ "obsidian-vault",
34
+ "subagent",
35
+ "subagents",
36
+ "passive",
37
+ "file-watcher",
38
+ "graph",
39
+ "knowledge-graph",
40
+ "notebooklm",
41
+ "pkm"
42
+ ],
43
+ "author": "Kyle Brodeur",
44
+ "license": "MIT",
45
+ "repository": {
46
+ "type": "git",
47
+ "url": "git+https://github.com/kylebrodeur/pi-vault-mind.git"
48
+ },
49
+ "bugs": {
50
+ "url": "https://github.com/kylebrodeur/pi-vault-mind/issues"
51
+ },
52
+ "homepage": "https://github.com/kylebrodeur/pi-vault-mind#readme",
53
+ "engines": {
54
+ "node": ">=20.6.0"
55
+ },
56
+ "pi": {
57
+ "extensions": [
58
+ "./dist/index.js"
59
+ ],
60
+ "skills": [
61
+ "./skills"
62
+ ]
63
+ },
64
+ "scripts": {
65
+ "prepare": "husky",
66
+ "check": "biome check --write . && tsc --noEmit",
67
+ "generate-constants": "node scripts/generate-extension-packages-json.mjs && node scripts/generate-config-keys-json.mjs && biome check --write extension-packages.json config-keys.json packages/obsidian/src/extension-packages.json packages/obsidian/src/config-keys.json",
68
+ "build": "npm run generate-constants && tsc && tsc -p tsconfig.test.json",
69
+ "dev": "tsc --watch",
70
+ "test": "node --test \"dist/test/**/*.test.js\"",
71
+ "e2e:ws": "node scripts/e2e-ws.mjs",
72
+ "e2e:modal": "node scripts/modal-e2e-smoke.mjs",
73
+ "e2e:commands": "node scripts/e2e-commands.mjs"
74
+ },
75
+ "dependencies": {
76
+ "@lancedb/lancedb": "latest",
77
+ "@xenova/transformers": "latest",
78
+ "apache-arrow": "^21.1.0",
79
+ "ws": "^8.21.0"
80
+ },
81
+ "peerDependencies": {
82
+ "@earendil-works/pi-coding-agent": ">=0.80.0 <1.0.0"
83
+ },
84
+ "devDependencies": {
85
+ "@biomejs/biome": "^2.5.3",
86
+ "@davidvkimball/obsidian-dev-skills": "^1.3.1",
87
+ "@earendil-works/pi-coding-agent": "^0.80.0",
88
+ "@earendil-works/pi-tui": "^0.79.0",
89
+ "@types/node": "^20.0.0",
90
+ "@types/ws": "^8.18.1",
91
+ "husky": "^9.1.6",
92
+ "lint-staged": "^17.0.8",
93
+ "typebox": "^1.1.0",
94
+ "typescript": "^5.0.0"
95
+ },
96
+ "pnpm": {
97
+ "overrides": {
98
+ "fast-xml-parser": ">=5.7.0",
99
+ "brace-expansion": ">=5.0.6",
100
+ "ws@>=8": ">=8.20.1",
101
+ "protobufjs": ">=8.0.0",
102
+ "undici": "7.28.0"
103
+ },
104
+ "onlyBuiltDependencies": [
105
+ "@davidvkimball/obsidian-dev-skills"
106
+ ]
107
+ }
108
+ }
@@ -1,4 +1,5 @@
1
1
  {
2
+ "//": "Active config lives at <vault>/.vault-mind/vault-mind.config.json. This file is a reference sample.",
2
3
  "version": 2,
3
4
  "collections": {
4
5
  "main": {
@@ -16,7 +17,15 @@
16
17
  "dedupField": "id"
17
18
  }
18
19
  },
19
- "injectors": [],
20
+ "injectors": [
21
+ {
22
+ "name": "draft-context",
23
+ "regex": "draft\\s+(\\S+)",
24
+ "collection": "main",
25
+ "filterField": "tag",
26
+ "artifactPath": "collections/artifact.md"
27
+ }
28
+ ],
20
29
  "vaultMind": {
21
30
  "dataDir": ".lancedb",
22
31
  "embedding": {
@@ -25,7 +34,20 @@
25
34
  },
26
35
  "graph": {
27
36
  "enabled": true,
28
- "canvasSync": false
37
+ "canvasSync": false,
38
+ "canvasPath": "Agent/Library/Library-Graph.canvas"
39
+ },
40
+ "vaults": {
41
+ "default": {
42
+ "path": "~/Obsidian/MyVault",
43
+ "autoStart": false,
44
+ "collectionPrefix": "myvault"
45
+ }
46
+ },
47
+ "files": {
48
+ "queue": ".vault-mind/agent-queue.jsonl",
49
+ "serverState": ".vault-mind/server.json",
50
+ "manualDispatch": ".vault-mind/manual-dispatch.md"
29
51
  },
30
52
  "ftsEnabled": true,
31
53
  "httpPort": 11435,
@@ -41,7 +41,14 @@ echo ""
41
41
  echo "=== pi-vault-mind Dependency Audit ==="
42
42
  echo ""
43
43
 
44
- # ── pi extensions (required) ──────────────────────────────────────────────
44
+ # ── pi extensions (canonical list from extension-packages.json) ──────────
45
+
46
+ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
47
+ PKGS_JSON="${SCRIPT_DIR}/../extension-packages.json"
48
+
49
+ if ! command -v jq >/dev/null 2>&1; then
50
+ echo "WARNING: jq not found — skipping pi extension checks"
51
+ else
45
52
 
46
53
  echo "── pi extensions ──"
47
54
 
@@ -54,41 +61,37 @@ else
54
61
  MISSING_REQUIRED=$((MISSING_REQUIRED + 1))
55
62
  fi
56
63
 
57
- # pi-vault-mind
58
- check "pi-vault-mind"
59
- if pi list 2>/dev/null | grep -q "pi-vault-mind"; then
60
- pass "installed"
61
- else
62
- fail "not installed"
63
- if $FIX_MODE; then
64
- echo " → pi install npm:pi-vault-mind"
64
+ # Required extensions (from canonical JSON)
65
+ for pkg in $(jq -r '.required[]' "${PKGS_JSON}"); do
66
+ label="${pkg#npm:}"
67
+ check "${label}"
68
+ if pi list 2>/dev/null | grep -q "${label}"; then
69
+ pass "installed"
70
+ else
71
+ fail "not installed"
72
+ if $FIX_MODE; then
73
+ echo " → pi install ${pkg}"
74
+ fi
75
+ MISSING_REQUIRED=$((MISSING_REQUIRED + 1))
65
76
  fi
66
- MISSING_REQUIRED=$((MISSING_REQUIRED + 1))
67
- fi
77
+ done
68
78
 
69
- # pi-context (REQUIRED — context_checkpoint, context_log, context_tag)
70
- check "pi-context (context tools)"
71
- if pi list 2>/dev/null | grep -q "pi-context"; then
72
- pass "installed"
73
- else
74
- fail "not installed — required for context hygiene"
75
- if $FIX_MODE; then
76
- echo " → pi install npm:pi-context"
77
- fi
78
- MISSING_REQUIRED=$((MISSING_REQUIRED + 1))
79
- fi
80
79
 
81
- # pi-context (REQUIRED — context_checkpoint, context_log, context_tag)
82
- check "pi-context (context tools)"
83
- if pi list 2>/dev/null | grep -q "pi-context"; then
84
- pass "installed"
85
- else
86
- fail "REQUIRED — context_checkpoint/context_log/context_tag unavailable"
87
- if $FIX_MODE; then
88
- echo " → pi install npm:pi-context"
80
+ # Optional pi extensions (from canonical JSON)
81
+ for pkg in $(jq -r '.optional[]' "${PKGS_JSON}"); do
82
+ label="${pkg#npm:}"
83
+ check "${label} (optional)"
84
+ if pi list 2>/dev/null | grep -q "${label}"; then
85
+ pass "installed"
86
+ else
87
+ warn "not installed"
88
+ if $FIX_MODE; then
89
+ echo " → pi install ${pkg}"
90
+ fi
91
+ MISSING_OPTIONAL=$((MISSING_OPTIONAL + 1))
89
92
  fi
90
- MISSING_REQUIRED=$((MISSING_REQUIRED + 1))
91
- fi
93
+ done
94
+ fi # jq available
92
95
 
93
96
  # ── Optional pi extensions ────────────────────────────────────────────────
94
97
 
@@ -0,0 +1,215 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * CLI E2E integration test — exercises all HTTP surfaces built in CR-1.x, PR-2.x, TC-3.x.
4
+ *
5
+ * Creates a temp vault, starts the server, tests every route, verifies file outputs.
6
+ *
7
+ * Usage:
8
+ * pnpm build
9
+ * node scripts/cli-e2e.mjs
10
+ */
11
+
12
+ import * as fs from "node:fs";
13
+ import * as os from "node:os";
14
+ import * as path from "node:path";
15
+ import { fileURLToPath } from "node:url";
16
+
17
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
18
+ const REPO = path.resolve(__dirname, "..");
19
+
20
+ // Create temp vault
21
+ const vaultDir = fs.mkdtempSync(path.join(os.tmpdir(), "pvm-cli-e2e-"));
22
+ const vaultMindDir = path.join(vaultDir, ".vault-mind");
23
+ fs.mkdirSync(vaultMindDir, { recursive: true });
24
+
25
+ // Write a minimal config with vault path so the server can discover it
26
+ const configPath = path.join(vaultMindDir, "vault-mind.config.json");
27
+ const initialConfig = {
28
+ version: 2,
29
+ collections: {
30
+ main: {
31
+ path: "collections/main.jsonl",
32
+ schema: ["id", "domain", "source", "fact", "tag", "artifact"],
33
+ dedupField: "fact",
34
+ },
35
+ },
36
+ vaultMind: {
37
+ dataDir: ".lancedb",
38
+ embedding: {},
39
+ ftsEnabled: true,
40
+ graph: { enabled: true, canvasSync: true },
41
+ vaults: { default: { path: vaultDir } },
42
+ },
43
+ };
44
+ fs.writeFileSync(configPath, JSON.stringify(initialConfig, null, 2), "utf-8");
45
+
46
+ // Set token via env var (server reads from process.cwd(), not vault dir)
47
+ const TEST_TOKEN = `e2e-cli-${Math.random().toString(36).slice(2, 10)}`;
48
+ process.env.PVM_API_TOKEN = TEST_TOKEN;
49
+
50
+ // Also write to vault's env file for file-output verification tests
51
+ const tokenEnvPath = path.join(vaultMindDir, "vault-mind.env");
52
+ fs.writeFileSync(tokenEnvPath, `PVM_API_TOKEN=${TEST_TOKEN}\n`, "utf-8");
53
+
54
+ // Change cwd to vault dir so server operates on the temp vault
55
+ process.chdir(vaultDir);
56
+
57
+ // Set pi agent dir so model-router scaffold writes to vault
58
+ const agentDir = path.join(vaultMindDir, ".pi", "agent");
59
+ fs.mkdirSync(agentDir, { recursive: true });
60
+ process.env.PI_CODING_AGENT_DIR = agentDir;
61
+
62
+ // Import server + watcher
63
+ const { createServerState, startServer, stopServer } = await import(`${REPO}/dist/src/server.js`);
64
+ const { createWatcherState } = await import(`${REPO}/dist/src/watcher.js`);
65
+
66
+ // Start server on ephemeral port
67
+ const EPHEMERAL_PORT = 0;
68
+ const serverState = createServerState(EPHEMERAL_PORT);
69
+ const watcherState = createWatcherState();
70
+ const mockPi = { sendUserMessage: () => {}, registerCommand: () => {}, registerTool: () => {} };
71
+ startServer(mockPi, serverState, watcherState);
72
+ // Wait for server to be ready
73
+ await new Promise((resolve) => setTimeout(resolve, 200));
74
+ const port = serverState.port;
75
+ console.log(`Server: http://127.0.0.1:${port}`);
76
+
77
+ // Helper
78
+ const API = {
79
+ headers: { "Content-Type": "application/json", Authorization: `Bearer ${TEST_TOKEN}` },
80
+ base: `http://127.0.0.1:${port}`,
81
+ };
82
+
83
+ async function http(method, path, body) {
84
+ const res = await fetch(`${API.base}${path}`, {
85
+ method,
86
+ headers: API.headers,
87
+ body: body ? JSON.stringify(body) : undefined,
88
+ });
89
+ const text = await res.text();
90
+ return { status: res.status, body: text ? JSON.parse(text) : undefined, raw: text };
91
+ }
92
+
93
+ let pass = 0;
94
+ let fail = 0;
95
+ function check(label, ok) {
96
+ if (ok) {
97
+ pass++;
98
+ console.log(` \x1b[32m✓\x1b[0m ${label}`);
99
+ } else {
100
+ fail++;
101
+ console.log(` \x1b[31m✗\x1b[0m ${label}`);
102
+ }
103
+ }
104
+
105
+ // ── Test 1: POST /vm/setup ──
106
+ console.log("\n── Test 1: POST /vm/setup ──");
107
+ const setup = await http("POST", "/vm/setup", {
108
+ vault: vaultDir,
109
+ model: "embeddinggemma",
110
+ useTransformers: false,
111
+ });
112
+ check("returns 200", setup.status === 200);
113
+ check("returns ok:true", setup.body?.ok === true);
114
+
115
+ // ── Test 2: GET /vault-mind/config ──
116
+ console.log("\n── Test 2: GET /vault-mind/config ──");
117
+ const cfg = await http("GET", "/vault-mind/config");
118
+ check("returns 200", cfg.status === 200);
119
+ check("has vaultMind", !!cfg.body?.config?.vaultMind);
120
+ check("has hasToken", typeof cfg.body?.hasToken === "boolean");
121
+ check("has version", !!cfg.body?.version);
122
+
123
+ // ── Test 3: GET /vault-mind/paths ──
124
+ console.log("\n── Test 3: GET /vault-mind/paths ──");
125
+ const paths = await http("GET", "/vault-mind/paths");
126
+ check("returns 200", paths.status === 200);
127
+ check("has config", !!paths.body?.config);
128
+ check("has vaultPath", !!paths.body?.vaultPath);
129
+
130
+ // ── Test 4: POST /vm/token ──
131
+ console.log("\n── Test 4: POST /vm/token ──");
132
+ const tokenRes = await http("POST", "/vm/token", { token: "test-token-abc123" });
133
+ check("returns 200", tokenRes.status === 200);
134
+ check("returns ok:true", tokenRes.body?.ok === true);
135
+ check("returns path", !!tokenRes.body?.path);
136
+ const envContent = fs.readFileSync(tokenEnvPath, "utf-8");
137
+ check("file contains token", envContent.includes("test-token-abc123"));
138
+
139
+ // ── Test 5: PATCH /vm/config ──
140
+ console.log("\n── Test 5: PATCH /vm/config ──");
141
+ const patchRes = await http("PATCH", "/vm/config", {
142
+ vaultMind: { vaults: { default: { autoStart: true } } },
143
+ });
144
+ check("returns 200", patchRes.status === 200);
145
+ check("returns ok:true", patchRes.body?.ok === true);
146
+ const updatedConfig = JSON.parse(fs.readFileSync(configPath, "utf-8"));
147
+ check("autoStart is true", updatedConfig.vaultMind?.vaults?.default?.autoStart === true);
148
+
149
+ // ── Test 6: GET /vault-mind/tools ──
150
+ console.log("\n── Test 6: GET /vault-mind/tools ──");
151
+ const tools = await http("GET", "/vault-mind/tools");
152
+ check("returns 200", tools.status === 200);
153
+ check("has tools array", Array.isArray(tools.body?.tools));
154
+ check("has 20 entries", tools.body?.tools?.length === 20);
155
+ check("has identities", !!tools.body?.identities);
156
+ check("has roles", !!tools.body?.identities?.roles);
157
+
158
+ // ── Test 7: GET /vault-mind/identities ──
159
+ console.log("\n── Test 7: GET /vault-mind/identities ──");
160
+ const identities = await http("GET", "/vault-mind/identities");
161
+ check("returns 200", identities.status === 200);
162
+ check("has roles", !!identities.body?.roles);
163
+
164
+ // ── Test 8: PUT /vault-mind/identities/:role/allowedTools ──
165
+ console.log("\n── Test 8: PUT /vault-mind/identities/:role/allowedTools ──");
166
+ const putTools = await http("PUT", "/vault-mind/identities/main/allowedTools", {
167
+ allowedTools: ["read", "write", "edit"],
168
+ });
169
+ check("returns 200", putTools.status === 200);
170
+ check("returns ok:true", putTools.body?.ok === true);
171
+ check("returns role:main", putTools.body?.role === "main");
172
+ check(
173
+ "returns correct array",
174
+ JSON.stringify(putTools.body?.allowedTools) === JSON.stringify(["read", "write", "edit"])
175
+ );
176
+
177
+ // ── Test 9: POST /vault-mind/reload-identities ──
178
+ console.log("\n── Test 9: POST /vault-mind/reload-identities ──");
179
+ const reload = await http("POST", "/vault-mind/reload-identities");
180
+ check("returns 200", reload.status === 200);
181
+ check("returns ok:true", reload.body?.ok === true);
182
+ check("returns roles array", Array.isArray(reload.body?.roles));
183
+
184
+ // ── Test 10: Auth rejection ──
185
+ console.log("\n── Test 10: Auth rejection ──");
186
+ const badAuth = await fetch(`${API.base}/vm/token`, {
187
+ method: "POST",
188
+ headers: { "Content-Type": "application/json", Authorization: "Bearer wrong-token" },
189
+ body: JSON.stringify({ token: "x" }),
190
+ });
191
+ check("bad auth returns 401", badAuth.status === 401);
192
+
193
+ // ── Test 11: Method not allowed ──
194
+ console.log("\n── Test 11: Method not allowed ──");
195
+ const badMethod = await http("GET", "/vm/token");
196
+ check("GET /vm/token returns 405", badMethod.status === 405);
197
+
198
+ // ── Test 12: Verify scaffold output ──
199
+ console.log("\n── Test 12: Scaffold output ──");
200
+ const modelRouterPath = path.join(vaultMindDir, ".pi", "model-router.json");
201
+ check("model-router.json exists", fs.existsSync(modelRouterPath));
202
+ const collectionsDir = path.join(vaultDir, "collections");
203
+ check("collections/ dir exists", fs.existsSync(collectionsDir));
204
+ const mainJsonl = path.join(collectionsDir, "main.jsonl");
205
+ check("main.jsonl exists", fs.existsSync(mainJsonl));
206
+
207
+ // ── Cleanup ──
208
+ console.log("\n── Cleanup ──");
209
+ await stopServer(serverState);
210
+ fs.rmSync(vaultDir, { recursive: true, force: true });
211
+ console.log("Server stopped, vault cleaned up");
212
+
213
+ // ── Summary ──
214
+ console.log(`\n=== Results: ${pass} pass, ${fail} fail (${pass + fail} total) ===`);
215
+ process.exit(fail > 0 ? 1 : 0);