@owrede/vault-memory 2.0.0 → 2.2.0

package/CHANGELOG.md

@@ -14,6 +14,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 _Nothing yet._
 
+## [2.2.0] — 2026-06-29
+
+### Added
+
+- **ContextFit — a CPU-only, full-featured second retrieval engine (ADR-008).** vault-memory now supports a `RetrievalBackend` seam with two engines selectable **per vault**: the default `ollama` (embeddings + sqlite-vec + FTS5 hybrid) and a new `contextfit` ([ContextFit](https://www.context.fit/)) — a token-native, CPU-only engine (BM25 + Semantic-IDs; no embeddings, no GPU). Enable with `vault-memory add-vault <path> --backend contextfit` or `backend = "contextfit"` in `config.toml`. Makes vault-memory runnable on resource-limited, non-GPU hosts such as a Synology NAS. Requires `pipx install contextfit`. See `docs/v2/CONTEXTFIT-BACKEND.md`.
+
+  A ContextFit vault builds the **full SQLite content layer without embeddings** (`indexVault`/`indexNote` gain an `embeddings: "none"` mode), so the whole tool surface works — search (via the ContextFit engine), graph (`expand`/`cluster`/backlinks/forward-links/broken-links), sections/assembly (`get_outline`/`search_sections`/`get_document_bundle`/`assemble_dossier`), frontmatter/stats, **live re-indexing** (watcher refreshes SQLite + the KB, debounced), **catch-up reconciliation** on start, **incremental** hash-skip, and **write→KB refresh**. The only exception is `search_text` (Ollama-path FTS5), which returns a note pointing to `search_hybrid`/`search_semantic`.
+
+  Results use the canonical `SearchHit` shape (`scoreBreakdown.contextfit` carries the raw score). Ollama vaults are byte-identical — no behavior change when `backend` is omitted.
+
+### Fixed
+
+- **Live re-index now maintains sections.** The single-note indexer (`indexNote`, used by the watcher + catch-up) previously deleted chunks without first deleting the sections that reference them (FK violation) and never rebuilt sections — so live-edited notes silently lost their section rows. It now deletes sections before chunks and rebuilds them, for **both** the Ollama and ContextFit paths.
+
+## [2.1.0] — 2026-06-25
+
+### Added
+
+- **Alias-aware query expansion** (`ISSUE-aliases-not-in-fulltext-retrieval.md`). A note's frontmatter `aliases` live in `note_aliases`, not in the BM25 source (`chunks_fts`), so searching an exact alias (e.g. `JHE`) never surfaced its target person note. `search_hybrid` now resolves an exact-alias query and injects/promotes the target note to the top of the results. Additive and guarded — non-alias queries are byte-identical (no BM25/semantic scoring change). Set `aliasExpansion: false` to restore prior behavior. `SearchHit.scoreBreakdown` gains an optional `alias` provenance field.
+
+### Fixed
+
+- **Obsidian plugin self-heals when the `vault-memory` CLI isn't on the GUI PATH** (`ISSUE-install-vault-memory-skill-improvements.md` §23). When Obsidian is launched from Finder/Dock its stripped PATH can make even an absolute path to the CLI fail (the `#!/usr/bin/env node` shebang can't find `node`). On `ENOENT` the plugin now probes common dev-machine locations (homebrew, npm-global, `~/.local`, volta, asdf, nvm versioned dirs) for both the `vault-memory` script and `node`, and retries as `node <script> serve`. The not-found banner now lists every path it tried.
+
+### Changed
+
+- **Internal: `server.ts` split into per-domain handler modules.** The 3329-line request dispatcher is now `src/server/handlers/{vault,notes,search,graph,memory,brief,assembly,contracts}.ts` over a shared `HandlerDeps` bundle, with a boot-time completeness gate (every registered tool must have a handler). Pure structural refactor — no behavior or API change. Also extracted `errorMessage()` (`src/errors/format.ts`), replacing ~43 inline error-narrowing ternaries.
+
+### Docs
+
+- **ADR-032** — duplicate section anchors are collapsed (`INSERT OR IGNORE`), not positionally suffixed; documents why suffixing would violate ADR-003 H-7 (content-hash anchors / D-05 source hashes). Closes the deferred "better fix" from the two duplicate-anchor issues.
+
 ## [2.0.0] — 2026-06-25
 
 ### Fixed

package/README.md

@@ -177,32 +177,56 @@ phase plan and the v3/v4 deferred sections.
 
 ## Install and docs
 
+### Guided install (recommended)
+
+Ask your agent to **"install vault-memory"** (or run `/vmem:install`). The
+installer asks two questions — which retrieval engine, and which vault(s) — then
+installs every missing dependency for the chosen path, registers the vault(s),
+builds the index, and wires the MCP server. See
+[`docs/v2/CONTEXTFIT-BACKEND.md`](docs/v2/CONTEXTFIT-BACKEND.md) for the engine
+comparison.
+
+### Choose a retrieval engine
+
+vault-memory supports two engines, selectable **per vault**:
+
+- **Ollama (vector / embeddings)** — best semantic search; needs Ollama + an
+  embedding model resident (GPU recommended).
+- **ContextFit (CPU-only)** — token-native BM25 + Semantic-IDs; **no GPU, no
+  model**, ~41 MB deps. Ideal for resource-limited / non-GPU hosts (e.g. a
+  Synology NAS). Requires the `contextfit` CLI (`pipx install contextfit`).
+
 ### Prerequisites
 
 - **Node.js >= 22** — runtime for the MCP server (`brew install node@22`).
-- **[Ollama](https://ollama.com)** on `localhost:11434` — local embedding host
-  (`brew install ollama && brew services start ollama`).
-- **`bge-m3`** embedding model (~1.1 GB) — vectors for semantic search
-  (`ollama pull bge-m3`).
-- One or more Obsidian vaults — what you index.
-- An MCP-aware client — the agent that consumes the tools.
+- One or more Obsidian vaults; an MCP-aware client.
+- **Ollama engine only:** [Ollama](https://ollama.com) on `localhost:11434`
+  (`brew install ollama && brew services start ollama`) + the `bge-m3` model
+  (~1.1 GB, `ollama pull bge-m3`). Optional ONNX reranker
+  (`bge-reranker-v2-m3`, ~570 MB) via `bash scripts/download-reranker.sh`.
+- **ContextFit engine only:** Python 3.10+ and `pipx install contextfit`.
 
-Tested on macOS. Linux should work; Windows untested. Optional ONNX reranker
-(`bge-reranker-v2-m3`, ~570 MB) via `bash scripts/download-reranker.sh`.
+Tested on macOS. Linux should work; Windows untested.
 
-### Install
+### Manual install
 
 ```bash
 npm install -g @owrede/vault-memory
+
+# Ollama (default) vault:
 vault-memory add-vault "/path/to/your/obsidian/vault"
+
+# OR a CPU-only ContextFit vault (no Ollama/GPU):
+vault-memory add-vault "/path/to/your/obsidian/vault" --backend contextfit
+
 vault-memory serve
 ```
 
 The `add-vault` command appends a `[[vaults]]` block to
 `~/.vault-memory/config.toml`, writes a `.mcp.json` into the vault root, and runs
 the initial index. Idempotent — re-running on a known path fills in whatever is
-missing. Flags: `--name <slug>`, `--write` (enable MCP writes; default read-only),
-`--no-index` (skip the initial index).
+missing. Flags: `--name <slug>`, `--backend ollama|contextfit`, `--write`
+(enable MCP writes; default read-only), `--no-index` (skip the initial index).
 
 ### Documentation