pi-vault-mind 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.7.1 - 2026-06-14
+
+### Fixed
+- Renamed skill directories to `vault-mind-{role}` for consistency.
+- Updated subagent dispatch names to match the new skill roles.
+- Fixed `vault-mind-setup` skill description formatting.
+
+### Changed
+- Documentation cleanup across README, skills, and setup FAQ.
+- CI configuration simplified for single-package repo.
+
+## 0.7.0 - 2026-06-10
+
+### Added
+- Initial release of `pi-vault-mind`.

package/README.md

@@ -182,6 +182,7 @@ The Broadcaster agent can generate podcasts, study guides, and slide decks from
 - **Embedding Provider** — choose one:
   - `@xenova/transformers` — built-in, no external deps (uses all-MiniLM-L6-v2, offline-capable)
   - `ollama` — requires Ollama running locally with `embeddinggemma` (higher quality)
+  - `modal` — optional: offload embedding + bulk re-index to a cloud GPU service and sync vectors down for offline search (see [docs/MODAL_EMBEDDING.md](docs/MODAL_EMBEDDING.md)). Default behavior is unchanged until you opt in.
 
 ### 1. Install with pi
 
@@ -343,12 +344,13 @@ Edit `pi-vault-mind.config.json` to match your domain:
 | `/wiki approve [collection]`   | Batch-review pending entries                              |
 | `/wiki settings`               | Open interactive settings dashboard                       |
 | `/wiki audit`                  | Audit config for missing defaults                         |
-| `/wiki reindex [--all] [--reembed]` | Rebuild FTS + vector indexes                       |
+| `/wiki reindex [--all] [--reembed] [--remote]` | Rebuild FTS + vector indexes; `--remote` offloads to Modal |
 | `/wiki collection select`      | Select active collection (shortcut: ctrl+alt+l)          |
 | `/wiki collection create`      | Interactive wizard to create a new collection              |
 | `/wiki injector create`        | Interactive wizard to create a new injector                |
 | `/wiki context enable \| disable \| status` | Manage pi-context integration              |
 | `/wiki embedding status \| use \| model \| models \| pull` | Manage embedding provider |
+| `/wiki modal status \| config \| sync \| jobs \| migrate` | Manage Modal embedding + vector sync |
 | `/wiki watcher start \| stop \| status` | Manage the passive file watcher                  |
 | `/wiki server status` | Show HTTP server status, port, and uptime |
 
@@ -362,6 +364,7 @@ Edit `pi-vault-mind.config.json` to match your domain:
 | Doc | Description |
 |---|---|
 | [docs/QUICKSTART.md](docs/QUICKSTART.md) | **Fastest path** — 60-second install, setup, first append |
+| [docs/NEW_VAULT_WALKTHROUGH.md](docs/NEW_VAULT_WALKTHROUGH.md) | **Fresh Mac → new vault → Modal → sync → verified**, one linear path (incl. multi-vault storage isolation) |
 | [docs/INSTALL.md](docs/INSTALL.md) | **Canonical install playbook** — all 5 layers (pi ext, skills, Obsidian, config, external CLIs) |
 | [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md) | End-to-end workflow + daily "drop & forget" usage |
 | [docs/WALKTHROUGH_PROMPT.md](docs/WALKTHROUGH_PROMPT.md) | Paste-into-pi guided setup with checkpoints between phases |
@@ -378,6 +381,25 @@ Edit `pi-vault-mind.config.json` to match your domain:
 | [docs/NOTEBOOKLM_PIPELINE.md](docs/NOTEBOOKLM_PIPELINE.md) | NotebookLM automated podcast and study guide generation |
 | [docs/OBSIDIAN_SETUP.md](docs/OBSIDIAN_SETUP.md) | Recommended Obsidian vault structure, plugins, and CLI |
 
+### Modal embedding service (local integration done)
+
+The local extension now integrates the Modal embedding service as a fully
+configurable embedding provider: on-demand `/embed` for search (with an offline
+fallback that degrades to FTS, never crashes), a sync-down path that pulls
+server-side vectors into the local LanceDB with a monotonic `seq` watermark,
+remote bulk re-index (`/wiki reindex --all --reembed --remote`), and debounced +
+batched append embedding via the coalescer. Existing non-modal users see no
+behavior change. See [docs/MODAL_EMBEDDING.md](docs/MODAL_EMBEDDING.md) for the
+full design.
+
+| Doc | Description |
+|---|---|
+| [docs/MODAL_EMBEDDING.md](docs/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 |
+
 ### Reference
 
 | Doc | Description |
@@ -417,7 +439,7 @@ Edit `pi-vault-mind.config.json` to match your domain:
 | Doc | Description |
 |---|---|
 | [docs/_archive/](docs/_archive/) | Historical docs kept for context (e.g. the `pi-llm-wiki` → `pi-vault-mind` rename audit) |
-| [docs/plans/legacy-audit.md](docs/plans/legacy-audit.md) | The 2026-06-08 legacy-terminology audit (139 findings, 13 blockers) and its resolution log (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; archived 2026-06-16 (in the repo, not on the docs site) |
 
 ## Contributing
 

package/dist/src/autosync.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Optional background vector sync (off by default).
+ *
+ * When `wiki.embedding.modal.sync.autoSync` is true, a background interval pulls
+ * new server-side vectors into the local LanceDB on a configurable cadence so
+ * search keeps working with the latest embeddings. It is guarded by config and
+ * safe to leave disabled — if Modal is not configured or auto-sync is off, the
+ * tick is a no-op.
+ *
+ * Config is re-read on each tick so changes take effect without a restart.
+ */
+/**
+ * Start the auto-sync interval. Returns a stop function (clears the timer).
+ * @param intervalMs fallback interval when config omits `autoSyncIntervalMs`.
+ */
+export declare const startAutoSync: (intervalMs?: number) => (() => void);

package/dist/src/autosync.js

@@ -0,0 +1,43 @@
+/**
+ * Optional background vector sync (off by default).
+ *
+ * When `wiki.embedding.modal.sync.autoSync` is true, a background interval pulls
+ * new server-side vectors into the local LanceDB on a configurable cadence so
+ * search keeps working with the latest embeddings. It is guarded by config and
+ * safe to leave disabled — if Modal is not configured or auto-sync is off, the
+ * tick is a no-op.
+ *
+ * Config is re-read on each tick so changes take effect without a restart.
+ */
+import { isModalConfigured } from "./modal-config.js";
+import { syncAll } from "./sync.js";
+import { loadConfig } from "./utils.js";
+/**
+ * Start the auto-sync interval. Returns a stop function (clears the timer).
+ * @param intervalMs fallback interval when config omits `autoSyncIntervalMs`.
+ */
+export const startAutoSync = (intervalMs = 300_000) => {
+    const tick = async () => {
+        try {
+            const cfg = loadConfig(process.cwd());
+            const sync = cfg.wiki.embedding.modal?.sync;
+            if (!sync?.autoSync)
+                return; // off by default
+            if (!isModalConfigured(cfg.wiki))
+                return; // nothing to sync
+            const ms = sync.autoSyncIntervalMs ?? intervalMs;
+            void ms; // cadence is fixed at start; tick honors config toggle
+            await syncAll(cfg);
+            console.log("[pi-vault-mind] auto-sync tick complete");
+        }
+        catch (err) {
+            console.warn(`[pi-vault-mind] auto-sync tick failed: ${err.message}`);
+        }
+    };
+    const id = setInterval(tick, intervalMs);
+    // setInterval holds the event loop alive; let the process exit if needed.
+    if (typeof id.unref === "function") {
+        id.unref();
+    }
+    return () => clearInterval(id);
+};

package/dist/src/commands.d.ts

@@ -2,6 +2,24 @@ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-a
 import type { ServerState } from "./server.js";
 export declare const auditConfig: (ctx: ExtensionContext) => Promise<void>;
 export declare const selectActiveCollection: (ctx: ExtensionContext) => Promise<void>;
+/**
+ * Vault-root `.gitignore` entries that keep pi-vault-mind compatible with
+ * `obsidian-git` (and, transitively, Obsidian Sync setups that also back up via
+ * git): the LanceDB index is a large, per-device, rebuildable binary and must
+ * never be committed; Obsidian's workspace UI state churns constantly. See
+ * docs/OBSIDIAN_SETUP.md §6.
+ */
+export declare const GITIGNORE_ENTRIES: string[];
+/**
+ * Decide what to do with the vault `.gitignore`, given its current contents
+ * (`null` if absent). Pure — does no I/O — so it is unit-testable. Creates the
+ * file when missing, appends only the entries that aren't already present
+ * (line-exact match, trimmed), and skips when everything is covered.
+ */
+export declare const planGitignore: (existing: string | null) => {
+    action: "create" | "append" | "skip";
+    content: string;
+};
 export declare const watcherState: import("./watcher.js").WatcherState;
 /** Module-level server state, referenced by the /wiki server command.
  *  Port is set when the server starts in index.ts. */