pi-vault-mind 0.16.6 → 0.16.7

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # 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

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/server.js

@@ -1637,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([
@@ -1709,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/test/personalize.test.js

@@ -192,19 +192,19 @@ 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 or skipped", async () => {
+    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: "skip" },
-                { path: "AGENTS.md", action: "skip" },
+                { path: ".pi/agent/system.md", action: "create", content: "# System" },
+                { path: "AGENTS.md", action: "create", content: "# Agents" },
             ],
         }));
-        const ctx = makeCtx(testDir, []);
+        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 every diff is rejected");
+        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");
@@ -229,11 +229,11 @@ describe("personalize", () => {
         const pi = makePi(JSON.stringify({
             commentary: "No changes needed.",
             files: [
-                { path: ".pi/agent/system.md", action: "skip" },
-                { path: "AGENTS.md", action: "skip" },
+                { path: ".pi/agent/system.md", action: "create", content: "# System" },
+                { path: "AGENTS.md", action: "create", content: "# Agents" },
             ],
         }));
-        const ctx = makeCtx(testDir, []);
+        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");

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.6",
+	"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\"",