@velvetmonkey/flywheel-memory 2.0.79 → 2.0.81

package/dist/index.js

@@ -9913,11 +9913,16 @@ function registerQueryTools(server2, getIndex, getVaultPath, getStateDb) {
             const merged = Array.from(allPaths).map((p) => {
               const title = fts5Map.get(p)?.title || semanticMap.get(p)?.title || entityMap.get(p)?.name || p.replace(/\.md$/, "").split("/").pop() || p;
               const snippet = fts5Map.get(p)?.snippet;
-              const rrfScore = rrfScores.get(p) || 0;
-              return { rrfScore, ...enrichResult({ path: p, title, snippet }, index, getStateDb()) };
+              return {
+                ...enrichResult({ path: p, title, snippet }, index, getStateDb()),
+                rrf_score: rrfScores.get(p) || 0,
+                in_fts5: fts5Map.has(p),
+                in_semantic: semanticMap.has(p),
+                in_entity: entityMap.has(p)
+              };
             });
-            merged.sort((a, b) => b.rrfScore - a.rrfScore);
-            const results = merged.slice(0, limit).map(({ rrfScore, ...rest }) => rest);
+            merged.sort((a, b) => b.rrf_score - a.rrf_score);
+            const results = merged.slice(0, limit);
             return { content: [{ type: "text", text: JSON.stringify({
               scope,
               method: "hybrid",
@@ -9934,8 +9939,8 @@ function registerQueryTools(server2, getIndex, getVaultPath, getStateDb) {
           const fts5Map = new Map(fts5Results.map((r) => [normalizePath2(r.path), r]));
           const entityRanked = entityResults.filter((r) => !fts5Map.has(normalizePath2(r.path)));
           const merged = [
-            ...fts5Results.map((r) => enrichResult({ path: r.path, title: r.title, snippet: r.snippet }, index, getStateDb())),
-            ...entityRanked.map((r) => enrichResult({ path: r.path, title: r.name }, index, getStateDb()))
+            ...fts5Results.map((r) => ({ ...enrichResult({ path: r.path, title: r.title, snippet: r.snippet }, index, getStateDb()), in_fts5: true })),
+            ...entityRanked.map((r) => ({ ...enrichResult({ path: r.path, title: r.name }, index, getStateDb()), in_entity: true }))
           ];
           return { content: [{ type: "text", text: JSON.stringify({
             scope: "content",
@@ -9945,7 +9950,7 @@ function registerQueryTools(server2, getIndex, getVaultPath, getStateDb) {
             results: merged.slice(0, limit)
           }, null, 2) }] };
         }
-        const enrichedFts5 = fts5Results.map((r) => enrichResult({ path: r.path, title: r.title, snippet: r.snippet }, index, getStateDb()));
+        const enrichedFts5 = fts5Results.map((r) => ({ ...enrichResult({ path: r.path, title: r.title, snippet: r.snippet }, index, getStateDb()), in_fts5: true }));
         return { content: [{ type: "text", text: JSON.stringify({
           scope: "content",
           method: "fts5",
@@ -19331,8 +19336,7 @@ var ALL_CATEGORIES = [
   "tasks",
   "memory",
   "note-ops",
-  "diagnostics",
-  "automation"
+  "diagnostics"
 ];
 var PRESETS = {
   // Presets
@@ -19347,8 +19351,7 @@ var PRESETS = {
   tasks: ["tasks"],
   memory: ["memory"],
   "note-ops": ["note-ops"],
-  diagnostics: ["diagnostics"],
-  automation: ["automation"]
+  diagnostics: ["diagnostics"]
 };
 var DEFAULT_PRESET = "default";
 var DEPRECATED_ALIASES = {
@@ -19368,9 +19371,9 @@ var DEPRECATED_ALIASES = {
   paths: "graph",
   health: "diagnostics",
   analysis: "wikilinks",
-  git: "automation",
-  ops: "automation",
-  policy: "automation"
+  git: "write",
+  ops: "write",
+  policy: "write"
 };
 function parseEnabledCategories() {
   const envValue = (process.env.FLYWHEEL_TOOLS ?? process.env.FLYWHEEL_PRESET)?.trim();
@@ -19422,12 +19425,14 @@ var TOOL_CATEGORY = {
   get_note_structure: "read",
   get_section_content: "read",
   find_sections: "read",
-  // write (5 tools) — content mutations + frontmatter + note creation
+  // write (7 tools) — content mutations + frontmatter + note creation + undo + policy
   vault_add_to_section: "write",
   vault_remove_from_section: "write",
   vault_replace_in_section: "write",
   vault_update_frontmatter: "write",
   vault_create_note: "write",
+  vault_undo_last_mutation: "write",
+  policy: "write",
   // graph (9 tools) — structural analysis + link detail
   graph_analysis: "graph",
   get_backlinks: "graph",
@@ -19483,10 +19488,7 @@ var TOOL_CATEGORY = {
   server_log: "diagnostics",
   suggest_entity_merges: "diagnostics",
   dismiss_merge_suggestion: "diagnostics",
-  vault_init: "diagnostics",
-  // automation (2 tools) — git undo + policy engine
-  vault_undo_last_mutation: "automation",
-  policy: "automation"
+  vault_init: "diagnostics"
 };
 function generateInstructions(categories) {
   const parts = [];
@@ -19513,7 +19515,34 @@ Escalation: "search" (enriched metadata + content preview) \u2192 "get_note_stru
     parts.push(`
 ## Write
 
-Write to existing notes with "vault_add_to_section". Create new notes with "vault_create_note". Update metadata with "vault_update_frontmatter". All writes auto-link entities \u2014 no manual [[wikilinks]] needed.`);
+Write to existing notes with "vault_add_to_section". Create new notes with "vault_create_note".
+Update metadata with "vault_update_frontmatter". All writes auto-link entities \u2014 no manual [[wikilinks]] needed.
+Use "vault_undo_last_mutation" to reverse the last write.
+
+**Frontmatter matters more than content** for Flywheel's intelligence. When creating or updating notes, always set:
+  - \`type:\` \u2014 drives entity categorization (person, project, technology). Without it, the category is guessed from the name alone.
+  - \`aliases:\` \u2014 alternative names so the entity is found when referred to differently.
+  - \`description:\` \u2014 one-line summary shown in search results and used by recall.
+  - Tags \u2014 used for filtering, suggestion scoring, and schema analysis.
+Good frontmatter is the highest-leverage action for improving suggestions, recall, and link quality.
+
+### Policies
+
+Use "policy" to build deterministic, repeatable vault workflows. Policies are YAML files that chain
+vault tools (add/remove/replace sections, create notes, update frontmatter, toggle tasks) into
+atomic operations \u2014 all steps succeed or all roll back, committed as a single git commit.
+
+Actions: "author" a policy from a description, "validate" the YAML, "preview" (dry-run),
+"execute" with variables, "list" saved policies, "revise" to modify.
+
+Key capabilities:
+  - **Variables** \u2014 parameterize policies (string, number, boolean, array, enum with defaults).
+  - **Conditions** \u2014 branch on file/section/frontmatter state (skip steps, don't abort).
+  - **Templates** \u2014 interpolate variables, builtins ({{today}}, {{now}}), and prior step outputs.
+  - **Atomicity** \u2014 failure at any step rolls back all changes. One policy = one git commit.
+
+Example: a "weekly-review" policy that creates a weekly note from template, pulls open tasks
+from daily notes, updates project frontmatter with hours logged, and links the review to active clients.`);
   }
   if (categories.has("memory")) {
     parts.push(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velvetmonkey/flywheel-memory",
-  "version": "2.0.79",
+  "version": "2.0.81",
   "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",
@@ -52,7 +52,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@velvetmonkey/vault-core": "^2.0.78",
+    "@velvetmonkey/vault-core": "^2.0.81",
     "better-sqlite3": "^11.0.0",
     "chokidar": "^4.0.0",
     "gray-matter": "^4.0.3",