pi-vault-mind 0.16.5 → 0.16.7

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 0.16.7 / 0.6.10 — 2026-07-18
+
+### Fixed
+
+- **Obsidian Markdown lifecycle.** Assistant Markdown renders through Obsidian's native renderer, renderer components unload on panel close or remount, stale asynchronous opens cannot remount a closed panel, and deferred message fills cannot hijack a replacement message placeholder.
+- **Generated sandbox constants.** Root builds now format the sandbox extension-package catalog they regenerate, so the release build cannot invalidate the sandbox verification suite.
+- **Repository-only documentation.** Removed the obsolete MkDocs configuration, GitHub Pages deployment workflow, publication badges, and generated-site instructions while retaining maintained Markdown documentation in the repository.
+
+### Tests
+
+- Added focused regressions for Markdown cleanup ownership, direct remount disposal, close-during-refresh cancellation, and deferred placeholder isolation.
+
+## 0.6.9 — 2026-07-18
+
+### Fixed
+
+- **First-run personalization recovery.** The configured-vault onboarding card now retains its active personalization state until durable runtime status confirms completion, including when the prompt acknowledgement fails or a permission request is pending. The chat feed and composer remain correctly gated until then.
+- **Portable model selection.** The shared panel contract now passes opaque model IDs end-to-end; the Obsidian adapter resolves each ID to Pi's provider/model RPC payload internally, preserving IDs that contain `/` or `:`.
+
+### Tests
+
+- Added focused regressions for acknowledgement failure, pending permission delivery, re-entry protection, and exact model-ID selection ordering.
+
+## 0.16.6 / 0.6.8 — 2026-07-18
+
+### Fixed
+
+- **First-run personalization handoff.** Configured vaults now remain on a dedicated personalization card until `/vm personalize` durably completes, including the valid all-suggestions-rejected path. The chat feed and composer are revealed only after the persisted completion status is observed.
+- **Live Pi model selection.** The first-run card now loads the active model and catalog from typed Pi RPC state, preserves provider and model ID for selection, and starts Pi only when a configured panel refresh needs that catalog.
+
+### Tests
+
+- Added regression coverage for first-run gating, model selection ordering, delayed personalization completion, and demand-driven Pi model loading.
+
 ## 0.16.5 / 0.6.7 — 2026-07-18
 
 ### Fixed

package/README.md

@@ -3,8 +3,6 @@
 [![npm version](https://img.shields.io/npm/v/pi-vault-mind)](https://www.npmjs.com/package/pi-vault-mind)
 [![license](https://img.shields.io/npm/l/pi-vault-mind)](LICENSE)
 [![pi-extension](https://img.shields.io/badge/pi-extension-blue)](https://github.com/mariozechner/pi)
-[![docs](https://img.shields.io/badge/docs-pi--vault--mind-blue)](https://kylebrodeur.github.io/pi-vault-mind/)
-[![docs build](https://github.com/kylebrodeur/pi-vault-mind/actions/workflows/docs.yml/badge.svg)](https://github.com/kylebrodeur/pi-vault-mind/actions/workflows/docs.yml)
 
 Passive Obsidian vault extension for the [pi](https://github.com/mariozechner/pi) agent ecosystem. Watches `@agent` markers in your vault, dispatches forked subagents, and stores results in LanceDB with vector + FTS + graph. Multi-agent "Drop & Forget" workflow.
 
@@ -363,19 +361,16 @@ Edit `pi-vault-mind.config.json` to match your domain:
 
 ## Documentation
 
-> **Full docs site:** [kylebrodeur.github.io/pi-vault-mind](https://kylebrodeur.github.io/pi-vault-mind/) (GH Pages, built from [`docs/`](docs/)).
-> The links below point to the source files in this repository.
+Documentation is maintained directly in this repository.
 
 ### Getting started
 
 | Doc | Description |
 |---|---|
-| [docs/getting-started/QUICKSTART.md](docs/getting-started/QUICKSTART.md) | **Fastest path** — 60-second install, setup, first append |
-| [docs/getting-started/NEW_VAULT_WALKTHROUGH.md](docs/getting-started/NEW_VAULT_WALKTHROUGH.md) | **Fresh Mac → new vault → Modal → sync → verified**, one linear path (incl. multi-vault storage isolation) |
-| [docs/getting-started/INSTALL.md](docs/getting-started/INSTALL.md) | **Canonical install playbook** — all 5 layers (pi ext, skills, Obsidian, config, external CLIs) |
-| [docs/getting-started/GETTING_STARTED.md](docs/getting-started/GETTING_STARTED.md) | End-to-end workflow + daily "drop & forget" usage |
-| [docs/getting-started/CLI_ONLY_WALKTHROUGH.md](docs/getting-started/CLI_ONLY_WALKTHROUGH.md) | Same setup + daily commands, entirely CLI — no Obsidian plugin required |
-| [docs/getting-started/WALKTHROUGH_PROMPT.md](docs/getting-started/WALKTHROUGH_PROMPT.md) | Paste-into-pi guided setup with checkpoints between phases |
+| [Install playbook](docs/_reference/reference_archive/getting-started/INSTALL.md) | Canonical install procedure for the extension, skills, Obsidian plugin, configuration, and external CLIs |
+| [Getting started](docs/_reference/reference_archive/getting-started/GETTING_STARTED.md) | End-to-end setup and daily “drop and forget” workflow |
+| [CLI-only walkthrough](docs/_reference/reference_archive/getting-started/CLI_ONLY_WALKTHROUGH.md) | Setup and daily commands without the Obsidian plugin |
+| [ReturnVape walkthrough](docs/getting-started/WALKTHROUGH.md) | Current guided Obsidian test-vault procedure |
 
 ### Architecture & design
 
@@ -384,8 +379,6 @@ Edit `pi-vault-mind.config.json` to match your domain:
 | [docs/architecture/AGENTS.md](docs/architecture/AGENTS.md) | Agent Roster and Multi-Agent Architecture ("Fork & Review" model) |
 | [docs/architecture/EXTENSION_WIRING.md](docs/architecture/EXTENSION_WIRING.md) | Extension dependencies, runtime wiring, auto-install patterns |
 | [docs/architecture/DISPATCHER_SPEC.md](docs/architecture/DISPATCHER_SPEC.md) | Technical spec for the passive file-watcher and subagent routing — incl. the "Fork & Dispatch" rationale and thread resume |
-| [docs/architecture/AGENTS.md](docs/architecture/AGENTS.md) | Agent roster + the Miner's "Drop & Forget" ingestion pipeline |
-| [docs/integrations/OBSIDIAN_SETUP.md](docs/integrations/OBSIDIAN_SETUP.md) | Recommended Obsidian vault structure, plugins, and CLI |
 
 ### Modal embedding service (local integration done)
 
@@ -401,8 +394,6 @@ full design.
 | Doc | Description |
 |---|---|
 | [docs/integrations/MODAL_EMBEDDING.md](docs/integrations/MODAL_EMBEDDING.md) | Design of record: ADRs, HTTP contract, sync protocol, roadmap for the cloud embedding service |
-| [docs/plans/modal-embedding-plan.md](docs/plans/modal-embedding-plan.md) | **Consolidated plan & next steps** — phases, owners, status, decision gate (in repo, not on the docs site) |
-| [docs/plans/embedding-open-questions.md](docs/plans/embedding-open-questions.md) | Embedding-strategy decision log (decided + open questions) |
 | [modal/](modal/) | The deployable Modal app: embedding service + bulk worker + sync + dataset generator |
 | [eval/](eval/) | Retrieval eval harness + labeled benchmark datasets for picking the canonical model |
 
@@ -412,17 +403,10 @@ full design.
 |---|---|
 | [skills/vault-mind/SKILL.md](skills/vault-mind/SKILL.md) | The Manager skill — what pi auto-loads about this extension |
 | [docs/CHANGELOG.md](docs/CHANGELOG.md) | Version history (rename from `pi-knowledge-store` to `pi-vault-mind` was v0.7.0) |
-| [docs/reference/tools.md](docs/reference/tools.md) | The 11 `vm_*` and `vm_query`/`vm_append`/etc. tools — parameters, return shapes |
-| [docs/reference/commands.md](docs/reference/commands.md) | Full `/vm` slash command tree |
-| [docs/reference/configuration.md](docs/reference/configuration.md) | The complete `pi-vault-mind.config.json` schema |
-| [docs/reference/skill.md](docs/reference/skill.md) | Manifest of all bundled skills and their trigger phrases |
-
-### Testing
-
-| Doc | Description |
-|---|---|
-| [docs/testing/TESTING.md](docs/testing/TESTING.md) | Test plan for agent / human / HITL personas, regression suite |
-| [docs/testing/E2E_MANUAL_TEST.md](docs/testing/E2E_MANUAL_TEST.md) | Manual end-to-end verification procedure (watcher → dispatch → vault) |
+| [Tools reference](docs/_reference/reference_archive/tools.md) | Registered Vault Mind tools, parameters, and return shapes |
+| [Commands reference](docs/_reference/reference_archive/commands.md) | Full `/vm` slash command tree |
+| [Configuration reference](docs/_reference/reference_archive/configuration.md) | Complete `pi-vault-mind.config.json` schema |
+| [Skill manifest](docs/_reference/reference_archive/skill.md) | Bundled skills and their trigger phrases |
 
 ### Development
 
@@ -430,22 +414,13 @@ full design.
 |---|---|
 | [docs/development/CONTRIBUTING.md](docs/development/CONTRIBUTING.md) | Dev setup, testing, and commit conventions |
 | [docs/development/PUBLISHING.md](docs/development/PUBLISHING.md) | How to publish this extension to npm |
-| [docs/development/FUTURE_WORK.md](docs/development/FUTURE_WORK.md) | Roadmap — codegraph integration, pagination, TUI rendering, etc. |
-
-### Research
-
-| Doc | Description |
-|---|---|
-| [docs/research/COMPETITOR_COMPARISON.md](docs/research/COMPETITOR_COMPARISON.md) | Tier 1/2/3 comparison vs. other Obsidian-LLM tools (22 competitors) |
-| [docs/research/naming-decisions.md](docs/research/naming-decisions.md) | Historical record of the 2026-06-06 decision to name the project `pi-vault-mind` |
-| [docs/research/obsidian-links-reviewed.csv](docs/research/obsidian-links-reviewed.csv) | Curated subset of starred Obsidian repos with adoption verdicts |
 
 ### Archive
 
 | Doc | Description |
 |---|---|
 | [docs/_archive/](docs/_archive/) | Historical docs kept for context (e.g. the `pi-knowledge-store` → `pi-vault-mind` rename audit) |
-| [docs/_archive/legacy-audit.md](docs/_archive/legacy-audit.md) | The 2026-06-08 legacy-terminology audit (139 findings, 13 blockers) and its resolution log. Resolved 2026-06-09; archived 2026-06-16 (in the repo, not on the docs site) |
+| [docs/_archive/legacy-audit.md](docs/_archive/legacy-audit.md) | The 2026-06-08 legacy-terminology audit (139 findings, 13 blockers) and its resolution log. Resolved 2026-06-09 and archived 2026-06-16. |
 
 ## Contributing
 

package/dist/src/commands.js

@@ -1760,7 +1760,8 @@ export const registerCommands = (pi) => {
                 case "remote":
                     return handleModal(rest, ctx, pi);
                 case "personalize":
-                    return runPersonalize(ctx, pi);
+                    await runPersonalize(ctx, pi);
+                    return;
                 case "setup":
                     return handleSetup(rest, ctx, pi);
                 case "token":

package/dist/src/personalize.d.ts

@@ -44,4 +44,6 @@ export declare const presentAndApplyDiff: (suggestions: SuggestionResult, ctx: E
     rejected: string[];
 }>;
 /** Orchestrate /vm personalize: analyze, suggest, confirm, apply. */
-export declare const runPersonalize: (ctx: ExtensionContext, pi: ExtensionAPI) => Promise<void>;
+export declare const runPersonalize: (ctx: ExtensionContext, pi: ExtensionAPI) => Promise<{
+    completed: boolean;
+}>;

package/dist/src/personalize.js

@@ -2,7 +2,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { parseFrontmatter } from "@earendil-works/pi-coding-agent";
 import { getStatus } from "./lance.js";
-import { expandHome, loadConfig, resolveAgentDir } from "./utils.js";
+import { expandHome, getPersonalizedMarkerPath, loadConfig, resolveAgentDir } from "./utils.js";
 /** Resolve the vault path: configured default vault wins, otherwise ctx.cwd. */
 export const resolveVaultPath = (ctx) => {
     const cfg = loadConfig(ctx.cwd);
@@ -359,8 +359,14 @@ export const runPersonalize = async (ctx, pi) => {
     try {
         const suggestions = await generateSuggestions(pi, profile, currentConfig);
         await presentAndApplyDiff(suggestions, ctx, currentConfig);
+        const markerPath = getPersonalizedMarkerPath(vaultPath);
+        await fs.promises.mkdir(path.dirname(markerPath), { recursive: true });
+        await fs.promises.writeFile(markerPath, JSON.stringify({ completed: true, completedAt: new Date().toISOString() }, null, 2));
+        return { completed: true };
     }
     catch (err) {
-        ctx.ui.notify(`Personalization failed: ${err.message}`, "error");
+        const message = err instanceof Error ? err.message : String(err);
+        ctx.ui.notify(`Personalization failed: ${message}`, "error");
+        return { completed: false };
     }
 };

package/dist/src/server.js

@@ -45,7 +45,7 @@ import { readModelProviders } from "./models.js";
 import { scaffoldVaultConfig } from "./scaffold.js";
 import { archiveSession, deleteSession, exportSession, getSession, listSessions, renameSession, resolveSessionsDir, searchSessions, } from "./session-search.js";
 import { listAllTools } from "./tool-catalog.js";
-import { ensureDir, expandHome, findConfig, getConfigPath, loadConfig, resolveVaultFile, resolveVaultMindPaths, shrinkHome, } from "./utils.js";
+import { ensureDir, expandHome, findConfig, getConfigPath, isPersonalized, loadConfig, resolveVaultFile, resolveVaultMindPaths, shrinkHome, } from "./utils.js";
 import { classifySearchMode, normalizeGraphResult, searchVaultNative } from "./vault-tools.js";
 import { createManualDispatch, processQueue, scanFile, startWatcher, stopWatcher, } from "./watcher.js";
 export function createServerState(port = 11435) {
@@ -1100,12 +1100,14 @@ function handleVmStatus(res, serverState) {
     }
     const cfg = loadConfig(vaultPath);
     const configured = !!findConfig(vaultPath).project;
+    const personalized = isPersonalized(vaultPath);
     const model = cfg.vaultMind.embedding[EMBEDDING_FLAT_KEYS[2]] || "embeddinggemma";
     const dim = cfg.vaultMind.embedding[EMBEDDING_FLAT_KEYS[4]] ?? 768;
     res.writeHead(200);
     res.end(JSON.stringify({
         ok: true,
         configured,
+        personalized,
         vaultPath,
         watcher: ws?.running ?? false,
         embedding: {
@@ -1635,30 +1637,32 @@ async function handleVmSearch(req, res, serverState, overrideBody) {
         res.end(JSON.stringify({ error: `Unknown mode: ${mode}` }));
         return;
     }
+    const sources = Array.isArray(body.sources) ? body.sources : ["vault"];
+    const includeVault = sources.includes("vault");
     try {
-        let results;
+        let results = [];
         let relations;
         let message;
-        if (resolvedMode === "hybrid") {
+        if (includeVault && resolvedMode === "hybrid") {
             results = await searchHybridRanked(cfg.vaultMind.dataDir, collection, query, limit, cfg.vaultMind, identity);
         }
-        else if (resolvedMode === "semantic") {
+        else if (includeVault && resolvedMode === "semantic") {
             results = await searchHybrid(cfg.vaultMind.dataDir, collection, query, limit, cfg.vaultMind, identity);
         }
-        else if (resolvedMode === "fts") {
+        else if (includeVault && resolvedMode === "fts") {
             results = await searchFts(cfg.vaultMind.dataDir, collection, query, limit, cfg.vaultMind, identity);
         }
-        else if (resolvedMode === "graph") {
+        else if (includeVault && resolvedMode === "graph") {
             const depth = body.depth ?? 1;
             const norm = normalizeGraphResult(await queryGraph(cfg.vaultMind.dataDir, cfg.vaultMind, entity, depth, identity));
             results = norm.hits;
             relations = norm.relations;
             message = norm.message;
         }
-        else if (resolvedMode === "vault") {
+        else if (includeVault && resolvedMode === "vault") {
             results = await searchVaultNative(vaultPath, query, limit, body.tags);
         }
-        else {
+        else if (includeVault) {
             // mode === "full"
             const depth = body.depth ?? 1;
             const [hybrid, semantic, fts, graph, vault] = await Promise.all([
@@ -1707,7 +1711,6 @@ async function handleVmSearch(req, res, serverState, overrideBody) {
             addResults(vault, "vault");
             results = merged.slice(0, limit);
         }
-        const sources = Array.isArray(body.sources) ? body.sources : ["vault"];
         if (sources.includes("sessions")) {
             results = [...results, ...searchSessions(resolveSessionsDir(), query, limit)];
         }

package/dist/src/utils.d.ts

@@ -13,6 +13,9 @@ export declare const resolveAgentDir: (cwd: string) => string;
 export declare const resolveVaultMindDir: (cwd: string) => string;
 /** Active pi-vault-mind config: `<vault>/.vault-mind/vault-mind.config.json`. */
 export declare const getConfigPath: (cwd: string) => string;
+export declare const getPersonalizedMarkerPath: (cwd: string) => string;
+/** Check if a vault has a valid personalization completion marker. */
+export declare function isPersonalized(cwd: string): boolean;
 /** Token env file: `<vault>/.vault-mind/vault-mind.env`. */
 export declare const getTokenEnvPath: (cwd: string) => string;
 export declare const EXT_ROOT: string;

package/dist/src/utils.js

@@ -18,6 +18,19 @@ export const resolveAgentDir = (cwd) => {
 export const resolveVaultMindDir = (cwd) => path.join(cwd, VAULT_MIND_DIR);
 /** Active pi-vault-mind config: `<vault>/.vault-mind/vault-mind.config.json`. */
 export const getConfigPath = (cwd) => path.join(resolveVaultMindDir(cwd), "vault-mind.config.json");
+export const getPersonalizedMarkerPath = (cwd) => path.join(resolveVaultMindDir(cwd), "personalized.json");
+/** Check if a vault has a valid personalization completion marker. */
+export function isPersonalized(cwd) {
+    const p = getPersonalizedMarkerPath(cwd);
+    try {
+        const content = fs.readFileSync(p, "utf8");
+        const marker = JSON.parse(content);
+        return marker && typeof marker === "object" && marker.completed === true;
+    }
+    catch {
+        return false;
+    }
+}
 /** Token env file: `<vault>/.vault-mind/vault-mind.env`. */
 export const getTokenEnvPath = (cwd) => path.join(resolveVaultMindDir(cwd), "vault-mind.env");
 export const EXT_ROOT = path.join(import.meta.dirname, "..", "..");

package/dist/test/personalize.test.js

@@ -192,6 +192,69 @@ describe("personalize", () => {
         // AGENTS.md was never created, so rejection means it still does not exist.
         assert.equal(fs.existsSync(path.join(testDir, "AGENTS.md")), false);
     });
+    it("persists a completion marker even when all suggestions are rejected", async () => {
+        const { runPersonalize } = await import("../src/personalize.js");
+        const pi = makePi(JSON.stringify({
+            commentary: "No changes needed.",
+            files: [
+                { path: ".pi/agent/system.md", action: "create", content: "# System" },
+                { path: "AGENTS.md", action: "create", content: "# Agents" },
+            ],
+        }));
+        const ctx = makeCtx(testDir, [false, false]);
+        await runPersonalize(ctx, pi);
+        const markerPath = path.join(testDir, ".vault-mind", "personalized.json");
+        assert.ok(fs.existsSync(markerPath), "runPersonalize must write a durable completion marker after the flow finishes, even when the user rejects every actionable suggestion");
+        const marker = JSON.parse(fs.readFileSync(markerPath, "utf-8"));
+        assert.strictEqual(marker.completed, true);
+        assert.ok(typeof marker.completedAt === "string");
+    });
+    it("persists a completion marker after approved suggestions", async () => {
+        const { runPersonalize } = await import("../src/personalize.js");
+        const pi = makePi(JSON.stringify({
+            commentary: "Updated tuning.",
+            files: [{ path: ".pi/agent/system.md", action: "create", content: "# New system" }],
+        }));
+        const ctx = makeCtx(testDir, [true]);
+        await runPersonalize(ctx, pi);
+        const markerPath = path.join(testDir, ".vault-mind", "personalized.json");
+        assert.ok(fs.existsSync(markerPath), "runPersonalize must write a durable completion marker after approved suggestions are applied");
+        const marker = JSON.parse(fs.readFileSync(markerPath, "utf-8"));
+        assert.strictEqual(marker.completed, true);
+        assert.ok(typeof marker.completedAt === "string");
+    });
+    it("returns a successful result when all suggestions are rejected", async () => {
+        const { runPersonalize: raw } = await import("../src/personalize.js");
+        const runPersonalize = raw;
+        const pi = makePi(JSON.stringify({
+            commentary: "No changes needed.",
+            files: [
+                { path: ".pi/agent/system.md", action: "create", content: "# System" },
+                { path: "AGENTS.md", action: "create", content: "# Agents" },
+            ],
+        }));
+        const ctx = makeCtx(testDir, [false, false]);
+        const result = await runPersonalize(ctx, pi);
+        assert.ok(result, "runPersonalize must return a result, not void");
+        assert.strictEqual(result.completed, true, "all-rejected personalization must resolve as a successful completion");
+    });
+    it("returns a failed result when suggestion generation fails", async () => {
+        const { runPersonalize: raw } = await import("../src/personalize.js");
+        const runPersonalize = raw;
+        const pi = makePi("not valid JSON");
+        const ctx = makeCtx(testDir, []);
+        const result = await runPersonalize(ctx, pi);
+        assert.ok(result, "runPersonalize must return a result, not void");
+        assert.strictEqual(result.completed, false, "a generation failure must resolve as a failed personalization, distinguishable from success");
+    });
+    it("does not persist a completion marker when suggestion generation fails", async () => {
+        const { runPersonalize } = await import("../src/personalize.js");
+        const pi = makePi("not valid JSON");
+        const ctx = makeCtx(testDir, []);
+        await runPersonalize(ctx, pi);
+        const markerPath = path.join(testDir, ".vault-mind", "personalized.json");
+        assert.strictEqual(fs.existsSync(markerPath), false, "runPersonalize must not leave a completion marker after a failed personalization");
+    });
     it("presentAndApplyDiff creates missing directories for new files", async () => {
         const { presentAndApplyDiff } = await import("../src/personalize.js");
         const ctx = makeCtx(testDir, [true]);

package/dist/test/rest-vm.test.js

@@ -4,6 +4,7 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { after, before, describe, it } from "node:test";
 import { _resetAuthCache } from "../src/auth.js";
+import { resetConnection } from "../src/lance.js";
 import { fakePi, fetchJson, makeVault, startTestServer, TEST_TOKEN, } from "./helpers/server.js";
 const envVar = "PVM_API_TOKEN";
 describe("REST vm routes", () => {
@@ -265,8 +266,8 @@ describe("REST vm routes", () => {
             assert.ok(Array.isArray(d.sources), "sources should be echoed");
         }
     });
-    it("POST /vm/search with sources sessions merges session hits", async () => {
-        // Seed a temp sessions dir
+    it("POST /vm/search with only sessions succeeds without an available vault index", async () => {
+        // Seed a temp sessions dir while the configured LanceDB index remains unavailable.
         const tmpSessions = fs.mkdtempSync(path.join(os.tmpdir(), "pvm-rest-sessions-"));
         const slugDir = path.join(tmpSessions, "--test--");
         fs.mkdirSync(slugDir, { recursive: true });
@@ -284,18 +285,24 @@ describe("REST vm routes", () => {
         const savedDir = process.env.PI_SESSIONS_DIR;
         try {
             process.env.PI_SESSIONS_DIR = tmpSessions;
+            resetConnection();
+            const vaultIndexPath = path.join(vaultPath, ".lancedb");
+            fs.rmSync(vaultIndexPath, { recursive: true, force: true });
+            assert.equal(fs.existsSync(vaultIndexPath), false, "the vault index fixture must be absent");
             const { status, body } = await fetchJson(port, "POST", "/vm/search", {
-                body: { query: "searchtestquery", mode: "vault", sources: ["sessions"] },
+                body: { query: "searchtestquery", mode: "hybrid", sources: ["sessions"] },
                 token: TEST_TOKEN,
             });
-            assert.ok(status === 200 || status === 500, `expected 200 or 500, got ${status}`);
-            if (status === 200) {
-                const d = body;
-                const hits = d.hits;
-                assert.ok(hits.some((h) => h._source === "session"), "should contain at least one session hit");
-            }
+            assert.equal(status, 200, "sessions-only search must not initialize or query the vault index");
+            assert.equal(fs.existsSync(vaultIndexPath), false, "sessions-only search must leave the unavailable vault index untouched");
+            const d = body;
+            assert.deepEqual(d.sources, ["sessions"], "the response must preserve the isolated source");
+            const hits = d.hits;
+            assert.ok(hits.length > 0, "sessions-only search should return the seeded session hit");
+            assert.ok(hits.every((hit) => hit._source === "session"), "sessions-only search must not merge vault hits");
         }
         finally {
+            resetConnection();
             if (savedDir === undefined)
                 delete process.env.PI_SESSIONS_DIR;
             else

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-vault-mind",
-	"version": "0.16.5",
+	"version": "0.16.7",
 	"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.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -64,7 +64,7 @@
 	"scripts": {
 		"prepare": "husky",
 		"check": "biome check --write . && tsc --noEmit",
-		"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",
+		"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 packages/obsidian-ui/src/extension-packages.json",
 		"build": "npm run generate-constants && tsc && tsc -p tsconfig.test.json",
 		"dev": "tsc --watch",
 		"test": "node --test \"dist/test/**/*.test.js\"",