@velvetmonkey/flywheel-memory 2.0.84 → 2.0.86

package/dist/index.js

@@ -1,6 +1,12 @@
 #!/usr/bin/env node
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
@@ -1575,7 +1581,7 @@ var init_taskHelpers = __esm({
 import * as path32 from "path";
 import { readFileSync as readFileSync5, realpathSync } from "fs";
 import { fileURLToPath } from "url";
-import { dirname as dirname4, join as join17 } from "path";
+import { dirname as dirname5, join as join17 } from "path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
@@ -1891,12 +1897,41 @@ function setEmbeddingsBuildState(state2) {
 function setEmbeddingsDatabase(database) {
   db = database;
 }
+function clearModelCache(modelId) {
+  try {
+    const candidates = [];
+    try {
+      const transformersDir = path2.dirname(__require.resolve("@huggingface/transformers/package.json"));
+      candidates.push(path2.join(transformersDir, ".cache", ...modelId.split("/")));
+    } catch {
+    }
+    const home = process.env.HOME || process.env.USERPROFILE || "";
+    if (home) {
+      const npxDir = path2.join(home, ".npm", "_npx");
+      if (fs3.existsSync(npxDir)) {
+        for (const hash of fs3.readdirSync(npxDir)) {
+          const candidate = path2.join(npxDir, hash, "node_modules", "@huggingface", "transformers", ".cache", ...modelId.split("/"));
+          if (fs3.existsSync(candidate)) candidates.push(candidate);
+        }
+      }
+    }
+    for (const cacheDir of candidates) {
+      if (fs3.existsSync(cacheDir)) {
+        fs3.rmSync(cacheDir, { recursive: true, force: true });
+        console.error(`[Semantic] Deleted corrupted model cache: ${cacheDir}`);
+      }
+    }
+  } catch (e) {
+    console.error(`[Semantic] Could not clear model cache: ${e instanceof Error ? e.message : e}`);
+  }
+}
 async function initEmbeddings() {
   if (pipeline) return;
   if (initPromise) return initPromise;
   initPromise = (async () => {
     const MAX_RETRIES = 3;
     const RETRY_DELAYS = [2e3, 5e3, 1e4];
+    let cacheCleared = false;
     for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
       try {
         const transformers = await Function("specifier", "return import(specifier)")("@huggingface/transformers");
@@ -1918,9 +1953,17 @@ async function initEmbeddings() {
             "Semantic search requires @huggingface/transformers. Install it with: npm install @huggingface/transformers"
           );
         }
+        const errMsg = err instanceof Error ? err.message : String(err);
+        if (!cacheCleared && (errMsg.includes("Protobuf parsing failed") || errMsg.includes("onnx"))) {
+          console.error(`[Semantic] Corrupted model cache detected: ${errMsg}`);
+          clearModelCache(activeModelConfig.id);
+          cacheCleared = true;
+          pipeline = null;
+          continue;
+        }
         if (attempt < MAX_RETRIES) {
           const delay = RETRY_DELAYS[attempt - 1];
-          console.error(`[Semantic] Model load failed (attempt ${attempt}/${MAX_RETRIES}): ${err instanceof Error ? err.message : err}`);
+          console.error(`[Semantic] Model load failed (attempt ${attempt}/${MAX_RETRIES}): ${errMsg}`);
           console.error(`[Semantic] Retrying in ${delay / 1e3}s...`);
           await new Promise((resolve2) => setTimeout(resolve2, delay));
           pipeline = null;
@@ -7551,10 +7594,10 @@ function queryTasksFromCache(options) {
   if (!db3) {
     throw new Error("Task cache database not initialized.");
   }
-  const { status = "all", folder, tag, excludeTags = [], has_due_date, limit, offset = 0 } = options;
+  const { status, folder, tag, excludeTags = [], has_due_date, limit, offset = 0 } = options;
   const conditions = [];
   const params = [];
-  if (status !== "all") {
+  if (status) {
     conditions.push("status = ?");
     params.push(status);
   }
@@ -9731,11 +9774,11 @@ function sortNotes(notes, sortBy, order) {
 function registerQueryTools(server2, getIndex, getVaultPath, getStateDb) {
   server2.tool(
     "search",
-    'Search the vault \u2014 always try this before reading files. Returns frontmatter, backlinks (with lines), outlinks (with lines + exists), headings, content snippet or preview, entity metadata, and timestamps for every hit.\n\nSearch the vault across metadata, content, and entities. Scope controls what to search: "metadata" for frontmatter/tags/folders, "content" for full-text search (FTS5), "entities" for people/projects/technologies, "all" (default) tries metadata then falls back to content search. When embeddings have been built (via init_semantic), content and all scopes automatically include embedding-based results via hybrid ranking.\n\nExample: search({ query: "quarterly review", scope: "content", limit: 5 })\nExample: search({ where: { type: "project", status: "active" }, scope: "metadata" })',
+    'Search the vault \u2014 always try this before reading files. Returns frontmatter, backlinks (with lines), outlinks (with lines + exists), headings, content snippet or preview, entity metadata, and timestamps for every hit.\n\nSearches across metadata (frontmatter/tags/folders), content (FTS5 full-text + hybrid semantic), and entities (people/projects/technologies). Uses filters to narrow by frontmatter fields, tags, folders, or dates. Hybrid semantic results are automatically included when embeddings have been built (via init_semantic).\n\nExample: search({ query: "quarterly review", limit: 5 })\nExample: search({ where: { type: "project", status: "active" } })',
     {
-      query: z4.string().optional().describe('Search query text. Required for scope "content", "entities", "all". For "metadata" scope, use filters instead.'),
-      scope: z4.enum(["metadata", "content", "entities", "all"]).default("all").describe("What to search: metadata (frontmatter/tags/folders), content (FTS5 full-text), entities (people/projects), all (metadata then content). Semantic results are automatically included when embeddings have been built (via init_semantic)."),
-      // Metadata filters (used with scope "metadata" or "all")
+      query: z4.string().optional().describe("Search query text. Required unless using metadata filters (where, has_tag, folder, etc.)"),
+      scope: z4.enum(["metadata", "content", "entities", "all"]).optional().describe('Narrow to a specific search type. Omit for best results (searches everything). Use "metadata" for frontmatter-only queries, "entities" for entity lookup.'),
+      // Metadata filters
       where: z4.record(z4.unknown()).optional().describe('Frontmatter filters as key-value pairs. Example: { "type": "project", "status": "active" }'),
       has_tag: z4.string().optional().describe("Filter to notes with this tag"),
       has_any_tag: z4.array(z4.string()).optional().describe("Filter to notes with any of these tags"),
@@ -9756,7 +9799,8 @@ function registerQueryTools(server2, getIndex, getVaultPath, getStateDb) {
       // Context boost (edge weights)
       context_note: z4.string().optional().describe("Path of the note providing context. When set, results connected to this note via weighted edges get an RRF boost.")
     },
-    async ({ query, scope, where, has_tag, has_any_tag, has_all_tags, include_children, folder, title_contains, modified_after, modified_before, sort_by, order, prefix, limit: requestedLimit, context_note }) => {
+    async ({ query, scope: rawScope, where, has_tag, has_any_tag, has_all_tags, include_children, folder, title_contains, modified_after, modified_before, sort_by, order, prefix, limit: requestedLimit, context_note }) => {
+      const scope = rawScope || "all";
       const limit = Math.min(requestedLimit ?? 20, MAX_LIMIT);
       const index = getIndex();
       const vaultPath2 = getVaultPath();
@@ -10678,7 +10722,7 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig = ()
       description: "Read the structure of a specific note. Use after search identifies a note you need more detail on. Returns headings, frontmatter, tags, word count. Set include_content: true to get the full markdown.",
       inputSchema: {
         path: z6.string().describe("Path to the note"),
-        include_content: z6.boolean().default(false).describe("Include the text content under each top-level section")
+        include_content: z6.boolean().default(true).describe("Include the text content under each top-level section. Set false to get structure only.")
       }
     },
     async ({ path: path33, include_content }) => {
@@ -10791,7 +10835,7 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig = ()
       description: 'Query tasks from the vault. Use path to scope to a single note. Use status to filter (default: "open"). Use has_due_date to find tasks with due dates.',
       inputSchema: {
         path: z6.string().optional().describe("Scope to tasks from this specific note path"),
-        status: z6.enum(["open", "completed", "cancelled", "all"]).default("open").describe("Filter by task status"),
+        status: z6.enum(["open", "completed", "cancelled"]).default("open").describe("Filter by task status"),
         has_due_date: z6.boolean().optional().describe("If true, only return tasks with due dates (sorted by date)"),
         folder: z6.string().optional().describe("Limit to tasks in notes within this folder"),
         tag: z6.string().optional().describe("Filter to tasks with this tag"),
@@ -10812,7 +10856,7 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig = ()
           };
         }
         let filtered = result2;
-        if (status !== "all") {
+        if (status) {
           filtered = result2.filter((t) => t.status === status);
         }
         const paged2 = filtered.slice(offset, offset + limit);
@@ -13465,19 +13509,19 @@ Example: vault_add_to_section({ path: "daily/2026-02-15.md", section: "Log", con
       format: z11.enum(["plain", "bullet", "task", "numbered", "timestamp-bullet"]).default("plain").describe("How to format the content"),
       commit: z11.boolean().default(false).describe("If true, commit this change to git (creates undo point)"),
       skipWikilinks: z11.boolean().default(false).describe("If true, skip auto-wikilink application (wikilinks are applied by default)"),
-      preserveListNesting: z11.boolean().default(true).describe("Detect and preserve the indentation level of surrounding list items. Set false to disable."),
-      bumpHeadings: z11.boolean().default(true).describe("Auto-bump heading levels in inserted content so they nest under the target section (e.g., ## in a ## section becomes ###). Set false to disable."),
-      suggestOutgoingLinks: z11.boolean().default(true).describe('Append suggested outgoing wikilinks based on content (e.g., "\u2192 [[AI]], [[Philosophy]]"). Set false to disable.'),
-      maxSuggestions: z11.number().min(1).max(10).default(5).describe("Maximum number of suggested wikilinks to append (1-10, default: 5)"),
-      validate: z11.boolean().default(true).describe("Check input for common issues (double timestamps, non-markdown bullets, etc.)"),
-      normalize: z11.boolean().default(true).describe("Auto-fix common issues before formatting (replace \u2022 with -, trim excessive whitespace, etc.)"),
-      guardrails: z11.enum(["warn", "strict", "off"]).default("warn").describe('Output validation mode: "warn" returns issues but proceeds, "strict" blocks on errors, "off" disables'),
+      suggestOutgoingLinks: z11.boolean().default(true).describe("Suggest related outgoing wikilinks based on content. Set false to disable."),
+      maxSuggestions: z11.number().min(1).max(10).default(5).describe("Maximum number of suggested wikilinks (1-10, default: 5)"),
       linkedEntities: z11.array(z11.string()).optional().describe("Entity names already linked in the content. When skipWikilinks=true, these are tracked for feedback without re-processing the content."),
       dry_run: z11.boolean().optional().default(false).describe("Preview changes without writing to disk"),
       agent_id: z11.string().optional().describe('Agent identifier for multi-agent scoping (e.g., "claude-opus", "planning-agent")'),
       session_id: z11.string().optional().describe('Session identifier for conversation scoping (e.g., "sess-abc123")')
     },
-    async ({ path: notePath, section, content, create_if_missing, position, format, commit, skipWikilinks, preserveListNesting, bumpHeadings, suggestOutgoingLinks, maxSuggestions, validate, normalize, guardrails, linkedEntities, dry_run, agent_id, session_id }) => {
+    async ({ path: notePath, section, content, create_if_missing, position, format, commit, skipWikilinks, suggestOutgoingLinks, maxSuggestions, linkedEntities, dry_run, agent_id, session_id }) => {
+      const preserveListNesting = true;
+      const bumpHeadings = true;
+      const validate = true;
+      const normalize = true;
+      const guardrails = "warn";
       let noteCreated = false;
       let templateUsed;
       if (create_if_missing) {
@@ -13609,16 +13653,16 @@ Example: vault_add_to_section({ path: "daily/2026-02-15.md", section: "Log", con
       useRegex: z11.boolean().default(false).describe("Treat search as regex"),
       commit: z11.boolean().default(false).describe("If true, commit this change to git (creates undo point)"),
       skipWikilinks: z11.boolean().default(false).describe("If true, skip auto-wikilink application on replacement text"),
-      suggestOutgoingLinks: z11.boolean().default(true).describe('Append suggested outgoing wikilinks based on content (e.g., "\u2192 [[AI]], [[Philosophy]]"). Set false to disable.'),
-      maxSuggestions: z11.number().min(1).max(10).default(5).describe("Maximum number of suggested wikilinks to append (1-10, default: 5)"),
-      validate: z11.boolean().default(true).describe("Check input for common issues (double timestamps, non-markdown bullets, etc.)"),
-      normalize: z11.boolean().default(true).describe("Auto-fix common issues before formatting (replace \u2022 with -, trim excessive whitespace, etc.)"),
-      guardrails: z11.enum(["warn", "strict", "off"]).default("warn").describe('Output validation mode: "warn" returns issues but proceeds, "strict" blocks on errors, "off" disables'),
+      suggestOutgoingLinks: z11.boolean().default(true).describe("Suggest related outgoing wikilinks based on content. Set false to disable."),
+      maxSuggestions: z11.number().min(1).max(10).default(5).describe("Maximum number of suggested wikilinks (1-10, default: 5)"),
       dry_run: z11.boolean().optional().default(false).describe("Preview changes without writing to disk"),
       agent_id: z11.string().optional().describe("Agent identifier for multi-agent scoping"),
       session_id: z11.string().optional().describe("Session identifier for conversation scoping")
     },
-    async ({ path: notePath, section, search, replacement, mode, useRegex, commit, skipWikilinks, suggestOutgoingLinks, maxSuggestions, validate, normalize, guardrails, dry_run, agent_id, session_id }) => {
+    async ({ path: notePath, section, search, replacement, mode, useRegex, commit, skipWikilinks, suggestOutgoingLinks, maxSuggestions, dry_run, agent_id, session_id }) => {
+      const validate = true;
+      const normalize = true;
+      const guardrails = "warn";
       return withVaultFile(
         {
           vaultPath: vaultPath2,
@@ -17527,7 +17571,7 @@ function getEdgeWeightBoost(entityName, edgeWeightMap) {
 async function performRecall(stateDb2, query, options = {}) {
   const {
     max_results = 20,
-    focus = "all",
+    focus,
     entity,
     max_tokens,
     diversity = 0.7,
@@ -17537,7 +17581,7 @@ async function performRecall(stateDb2, query, options = {}) {
   const recencyIndex2 = loadRecencyFromStateDb();
   const edgeWeightMap = getEntityEdgeWeightMap(stateDb2);
   const feedbackBoosts = getAllFeedbackBoosts(stateDb2);
-  if (focus === "all" || focus === "entities") {
+  if (!focus || focus === "entities") {
     try {
       const entityResults = searchEntitiesDb2(stateDb2, query, max_results);
       for (const e of entityResults) {
@@ -17566,7 +17610,7 @@ async function performRecall(stateDb2, query, options = {}) {
     } catch {
     }
   }
-  if (focus === "all" || focus === "notes") {
+  if (!focus || focus === "notes") {
     try {
       const noteResults = searchFTS5("", query, max_results);
       for (const n of noteResults) {
@@ -17589,7 +17633,7 @@ async function performRecall(stateDb2, query, options = {}) {
     } catch {
     }
   }
-  if (focus === "all" || focus === "memories") {
+  if (!focus || focus === "memories") {
     try {
       const memResults = searchMemories(stateDb2, {
         query,
@@ -17617,7 +17661,7 @@ async function performRecall(stateDb2, query, options = {}) {
     } catch {
     }
   }
-  if ((focus === "all" || focus === "entities") && query.length >= 20 && hasEntityEmbeddingsIndex()) {
+  if ((!focus || focus === "entities") && query.length >= 20 && hasEntityEmbeddingsIndex()) {
     try {
       const embedding = await embedTextCached(query);
       const semanticMatches = findSemanticallySimilarEntities(embedding, max_results);
@@ -17726,7 +17770,7 @@ function registerRecallTools(server2, getStateDb, getVaultPath) {
     {
       query: z24.string().describe('What to recall (e.g., "Project X", "meetings about auth")'),
       max_results: z24.number().min(1).max(100).optional().describe("Max results (default: 20)"),
-      focus: z24.enum(["entities", "notes", "memories", "all"]).optional().describe("Limit search to specific type (default: all)"),
+      focus: z24.enum(["entities", "notes", "memories"]).optional().describe("Limit to a specific result type. Omit for best results (searches everything)."),
       entity: z24.string().optional().describe("Filter memories by entity association"),
       max_tokens: z24.number().optional().describe("Token budget for response (truncates lower-ranked results)"),
       diversity: z24.number().min(0).max(1).optional().describe("Relevance vs diversity tradeoff (0=max diversity, 1=pure relevance, default: 0.7)")
@@ -19309,7 +19353,7 @@ function registerVaultResources(server2, getIndex) {
 
 // src/index.ts
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname4(__filename);
+var __dirname = dirname5(__filename);
 var pkg = JSON.parse(readFileSync5(join17(__dirname, "../package.json"), "utf-8"));
 var vaultPath = process.env.PROJECT_PATH || process.env.VAULT_PATH || findVaultRoot();
 var resolvedVaultPath;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velvetmonkey/flywheel-memory",
-  "version": "2.0.84",
+  "version": "2.0.86",
   "description": "MCP server that gives Claude full read/write access to your Obsidian vault. Select from 51 tools for search, backlinks, graph queries, mutations, agent memory, and hybrid semantic search.",
   "type": "module",
   "main": "dist/index.js",
@@ -53,7 +53,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@velvetmonkey/vault-core": "^2.0.84",
+    "@velvetmonkey/vault-core": "^2.0.86",
     "better-sqlite3": "^11.0.0",
     "chokidar": "^4.0.0",
     "gray-matter": "^4.0.3",