@velvetmonkey/flywheel-memory 2.0.8 → 2.0.9

package/dist/index.js

@@ -567,6 +567,7 @@ function injectMutationMetadata(frontmatter, scoping) {
     if (scoping.session_id) {
       frontmatter._session_id = scoping.session_id;
     }
+    frontmatter._source = "ai";
     if (scoping.agent_id && scoping.session_id) {
       frontmatter._last_modified_by = `${scoping.agent_id}:${scoping.session_id}`;
     } else if (scoping.agent_id) {
@@ -6140,7 +6141,7 @@ function sortNotes(notes, sortBy, order) {
 function registerQueryTools(server2, getIndex, getVaultPath, getStateDb) {
   server2.tool(
     "search",
-    'Search 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.',
+    'Search 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.\n\nExample: search({ query: "quarterly review", scope: "content", limit: 5 })\nExample: search({ where: { type: "project", status: "active" }, scope: "metadata" })',
     {
       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)"),
@@ -7411,7 +7412,7 @@ function registerGraphAnalysisTools(server2, getIndex, getVaultPath) {
     "graph_analysis",
     {
       title: "Graph Analysis",
-      description: 'Analyze vault link graph structure. Use analysis to pick the mode:\n- "orphans": Notes with no backlinks (disconnected content)\n- "dead_ends": Notes with backlinks but no outgoing links\n- "sources": Notes with outgoing links but no backlinks\n- "hubs": Highly connected notes (many links to/from)\n- "stale": Important notes (by backlink count) not recently modified',
+      description: 'Analyze vault link graph structure. Use analysis to pick the mode:\n- "orphans": Notes with no backlinks (disconnected content)\n- "dead_ends": Notes with backlinks but no outgoing links\n- "sources": Notes with outgoing links but no backlinks\n- "hubs": Highly connected notes (many links to/from)\n- "stale": Important notes (by backlink count) not recently modified\n\nExample: graph_analysis({ analysis: "hubs", limit: 10 })\nExample: graph_analysis({ analysis: "stale", days: 30, min_backlinks: 3 })',
       inputSchema: {
         analysis: z8.enum(["orphans", "dead_ends", "sources", "hubs", "stale"]).describe("Type of graph analysis to perform"),
         folder: z8.string().optional().describe("Limit to notes in this folder (orphans, dead_ends, sources)"),
@@ -7984,7 +7985,7 @@ function registerVaultSchemaTools(server2, getIndex, getVaultPath) {
     "vault_schema",
     {
       title: "Vault Schema",
-      description: 'Analyze and validate vault frontmatter schema. Use analysis to pick the mode:\n- "overview": Schema of all frontmatter fields across the vault\n- "field_values": All unique values for a specific field\n- "inconsistencies": Fields with multiple types across notes\n- "validate": Validate notes against a provided schema\n- "missing": Find notes missing expected fields by folder\n- "conventions": Auto-detect metadata conventions for a folder\n- "incomplete": Find notes missing expected fields (inferred)\n- "suggest_values": Suggest values for a field based on usage',
+      description: 'Analyze and validate vault frontmatter schema. Use analysis to pick the mode:\n- "overview": Schema of all frontmatter fields across the vault\n- "field_values": All unique values for a specific field\n- "inconsistencies": Fields with multiple types across notes\n- "validate": Validate notes against a provided schema\n- "missing": Find notes missing expected fields by folder\n- "conventions": Auto-detect metadata conventions for a folder\n- "incomplete": Find notes missing expected fields (inferred)\n- "suggest_values": Suggest values for a field based on usage\n\nExample: vault_schema({ analysis: "field_values", field: "status" })\nExample: vault_schema({ analysis: "conventions", folder: "projects" })',
       inputSchema: {
         analysis: z9.enum([
           "overview",
@@ -8554,7 +8555,7 @@ function registerNoteIntelligenceTools(server2, getIndex, getVaultPath) {
     "note_intelligence",
     {
       title: "Note Intelligence",
-      description: 'Analyze a note for patterns, suggestions, and consistency. Use analysis to pick the mode:\n- "prose_patterns": Find "Key: Value" or "Key: [[wikilink]]" patterns in prose\n- "suggest_frontmatter": Suggest YAML frontmatter from detected prose patterns\n- "suggest_wikilinks": Find frontmatter values that could be wikilinks\n- "cross_layer": Check consistency between frontmatter and prose references\n- "compute": Auto-compute derived fields (word_count, link_count, etc.)\n- "all": Run all analyses and return combined result',
+      description: 'Analyze a note for patterns, suggestions, and consistency. Use analysis to pick the mode:\n- "prose_patterns": Find "Key: Value" or "Key: [[wikilink]]" patterns in prose\n- "suggest_frontmatter": Suggest YAML frontmatter from detected prose patterns\n- "suggest_wikilinks": Find frontmatter values that could be wikilinks\n- "cross_layer": Check consistency between frontmatter and prose references\n- "compute": Auto-compute derived fields (word_count, link_count, etc.)\n- "all": Run all analyses and return combined result\n\nExample: note_intelligence({ path: "projects/alpha.md", analysis: "wikilinks" })\nExample: note_intelligence({ path: "projects/alpha.md", analysis: "compute", fields: ["word_count", "link_count"] })',
       inputSchema: {
         analysis: z10.enum([
           "prose_patterns",
@@ -9031,7 +9032,9 @@ async function createNoteFromTemplate(vaultPath2, notePath, config) {
 function registerMutationTools(server2, vaultPath2, getConfig = () => ({})) {
   server2.tool(
     "vault_add_to_section",
-    "Add content to a specific section in a markdown note. Set create_if_missing=true to auto-create the note from template if it doesn't exist (enables 1-call daily capture).",
+    `Add content to a specific section in a markdown note. Set create_if_missing=true to auto-create the note from template if it doesn't exist (enables 1-call daily capture).
+
+Example: vault_add_to_section({ path: "daily/2026-02-15.md", section: "Log", content: "Met with team about Q1", format: "timestamp-bullet", create_if_missing: true })`,
     {
       path: z11.string().describe('Vault-relative path to the note (e.g., "daily-notes/2026-01-28.md")'),
       section: z11.string().describe('Heading text to add to (e.g., "Log" or "## Log")'),
@@ -9295,7 +9298,7 @@ function toggleTask(content, lineNumber) {
 function registerTaskTools(server2, vaultPath2) {
   server2.tool(
     "vault_toggle_task",
-    "Toggle a task checkbox between checked and unchecked",
+    'Toggle a task checkbox between checked and unchecked.\n\nExample: vault_toggle_task({ path: "daily/2026-02-15.md", task: "review PR", section: "Tasks" })',
     {
       path: z12.string().describe("Vault-relative path to the note"),
       task: z12.string().describe("Task text to find (partial match supported)"),
@@ -9355,7 +9358,7 @@ function registerTaskTools(server2, vaultPath2) {
   );
   server2.tool(
     "vault_add_task",
-    "Add a new task to a section in a markdown note",
+    'Add a new task to a section in a markdown note.\n\nExample: vault_add_task({ path: "daily/2026-02-15.md", section: "Tasks", task: "Write unit tests for auth module" })',
     {
       path: z12.string().describe("Vault-relative path to the note"),
       section: z12.string().describe("Section to add the task to"),
@@ -9433,7 +9436,9 @@ import { z as z13 } from "zod";
 function registerFrontmatterTools(server2, vaultPath2) {
   server2.tool(
     "vault_update_frontmatter",
-    "Update frontmatter fields in a note (merge with existing). Set only_if_missing=true to only add fields that don't already exist (absorbed vault_add_frontmatter_field).",
+    `Update frontmatter fields in a note (merge with existing). Set only_if_missing=true to only add fields that don't already exist (absorbed vault_add_frontmatter_field).
+
+Example: vault_update_frontmatter({ path: "projects/alpha.md", frontmatter: { status: "active", priority: 1 }, only_if_missing: true })`,
     {
       path: z13.string().describe("Vault-relative path to the note"),
       frontmatter: z13.record(z13.any()).describe("Frontmatter fields to update (JSON object)"),
@@ -9494,7 +9499,7 @@ import path18 from "path";
 function registerNoteTools(server2, vaultPath2, getIndex) {
   server2.tool(
     "vault_create_note",
-    "Create a new note in the vault with optional frontmatter and content",
+    'Create a new note in the vault with optional frontmatter and content.\n\nExample: vault_create_note({ path: "people/Jane Smith.md", content: "# Jane Smith\\n\\nProduct manager at Acme.", frontmatter: { type: "person", company: "Acme" } })',
     {
       path: z14.string().describe('Vault-relative path for the new note (e.g., "daily-notes/2026-01-28.md")'),
       content: z14.string().default("").describe("Initial content for the note"),
@@ -11471,6 +11476,109 @@ function registerPolicyTools(server2, vaultPath2) {
   );
 }
 
+// src/resources/vault.ts
+function registerVaultResources(server2, getIndex) {
+  server2.registerResource(
+    "vault-stats",
+    "vault://stats",
+    {
+      title: "Vault Statistics",
+      description: "Overview of vault size, tags, links, and orphan count",
+      mimeType: "application/json"
+    },
+    async (uri) => {
+      const index = getIndex();
+      if (!index) {
+        return {
+          contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify({ error: "Index not ready" }) }]
+        };
+      }
+      const noteCount = index.notes.size;
+      const tagCount = index.tags.size;
+      let totalLinks = 0;
+      for (const note of index.notes.values()) {
+        totalLinks += note.outlinks.length;
+      }
+      let orphanCount = 0;
+      for (const note of index.notes.values()) {
+        const normalizedTitle = note.title.toLowerCase();
+        const backlinks = index.backlinks.get(normalizedTitle);
+        if (!backlinks || backlinks.length === 0) {
+          orphanCount++;
+        }
+      }
+      const stats = {
+        note_count: noteCount,
+        tag_count: tagCount,
+        total_links: totalLinks,
+        orphan_count: orphanCount,
+        index_built_at: index.builtAt.toISOString()
+      };
+      return {
+        contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(stats, null, 2) }]
+      };
+    }
+  );
+  server2.registerResource(
+    "vault-schema",
+    "vault://schema",
+    {
+      title: "Vault Schema",
+      description: "Frontmatter field summary: field names, types, frequency",
+      mimeType: "application/json"
+    },
+    async (uri) => {
+      const index = getIndex();
+      if (!index) {
+        return {
+          contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify({ error: "Index not ready" }) }]
+        };
+      }
+      const schema = getFrontmatterSchema(index);
+      const compact = {
+        total_notes: schema.total_notes,
+        notes_with_frontmatter: schema.notes_with_frontmatter,
+        field_count: schema.field_count,
+        fields: schema.fields.map((f) => ({
+          name: f.name,
+          types: f.types,
+          count: f.count,
+          examples: f.examples.slice(0, 3)
+        }))
+      };
+      return {
+        contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(compact, null, 2) }]
+      };
+    }
+  );
+  server2.registerResource(
+    "vault-recent",
+    "vault://recent",
+    {
+      title: "Recently Modified Notes",
+      description: "Last 10 modified notes in the vault",
+      mimeType: "application/json"
+    },
+    async (uri) => {
+      const index = getIndex();
+      if (!index) {
+        return {
+          contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify({ error: "Index not ready" }) }]
+        };
+      }
+      const notes = Array.from(index.notes.values()).sort((a, b) => b.modified.getTime() - a.modified.getTime()).slice(0, 10).map((n) => ({
+        path: n.path,
+        title: n.title,
+        modified: n.modified.toISOString(),
+        tags: n.tags
+      }));
+      return {
+        contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify({ recent_notes: notes }, null, 2) }]
+      };
+    }
+  );
+}
+
 // src/index.ts
 var vaultPath = process.env.PROJECT_PATH || process.env.VAULT_PATH || findVaultRoot();
 var vaultIndex;
@@ -11661,6 +11769,7 @@ registerNoteTools(server, vaultPath, () => vaultIndex);
 registerMoveNoteTools(server, vaultPath);
 registerSystemTools2(server, vaultPath);
 registerPolicyTools(server, vaultPath);
+registerVaultResources(server, () => vaultIndex ?? null);
 console.error(`[Memory] Registered ${_registeredCount} tools, skipped ${_skippedCount}`);
 async function main() {
   console.error(`[Memory] Starting Flywheel Memory server...`);

package/package.json

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