@velvetmonkey/flywheel-memory 2.0.85 → 2.0.86

package/dist/index.js

@@ -7594,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);
   }
@@ -9774,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"),
@@ -9799,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();
@@ -10721,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 }) => {
@@ -10834,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"),
@@ -10855,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);
@@ -13508,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) {
@@ -13652,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,
@@ -17570,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,
@@ -17580,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) {
@@ -17609,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) {
@@ -17632,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,
@@ -17660,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);
@@ -17769,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)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velvetmonkey/flywheel-memory",
-  "version": "2.0.85",
+  "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.85",
+    "@velvetmonkey/vault-core": "^2.0.86",
     "better-sqlite3": "^11.0.0",
     "chokidar": "^4.0.0",
     "gray-matter": "^4.0.3",