@velvetmonkey/flywheel-memory 2.0.80 → 2.0.82

package/README.md

@@ -20,7 +20,7 @@
 | "What should I link?" | Not possible | 10-dimension scoring + semantic search |
 | Hubs, orphans, paths? | Not possible | Pre-indexed graph analysis |
 
-51 tools across 17 categories. 6-line config. Zero cloud dependencies.
+61 tools across 11 categories. 6-line config. Zero cloud dependencies.
 
 **Try in 60 seconds:**
 
@@ -304,7 +304,7 @@ Add `.mcp.json` to your vault root:
       "command": "npx",
       "args": ["-y", "@velvetmonkey/flywheel-memory"],
       "env": {
-        "FLYWHEEL_PRESET": "minimal"
+        "FLYWHEEL_PRESET": "default"
       }
     }
   }
@@ -315,7 +315,7 @@ Add `.mcp.json` to your vault root:
 cd /path/to/your/vault && claude
 ```
 
-Start with the `minimal` preset (11 tools). Add bundles as needed. See [docs/CONFIGURATION.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/CONFIGURATION.md) for all options.
+Defaults to the `default` preset (16 tools). Add bundles as needed. See [docs/CONFIGURATION.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/CONFIGURATION.md) for all options.
 
 > **Note:** Developed and tested with Claude Code. Other MCP clients may work but are untested.
 
@@ -325,22 +325,11 @@ Start with the `minimal` preset (11 tools). Add bundles as needed. See [docs/CON
 
 | Preset | Tools | What you get |
 |--------|-------|--------------|
-| `full` (default) | 51 | Everything — graph, schema, tasks, policy, memory |
-| `minimal` | 11 | Note-taking essentials — search, read, create, edit |
-| `writer` | 14 | minimal + task management |
-| `agent` | 14 | minimal + agent memory (brief, recall, memory) |
-| `researcher` | 12 | Search + graph navigation — read-heavy exploration |
+| `default` | 16 | Note-taking essentials — search, read, write, tasks |
+| `agent` | 16 | Autonomous AI agents — search, read, write, memory |
+| `full` | 61 | Everything — all 11 categories |
 
-Composable bundles (add to presets or each other):
-
-| Bundle | Tools | What it adds |
-|--------|-------|--------------|
-| `graph` | 7 | Backlinks, orphans, hubs, shortest paths |
-| `analysis` | 9 | Schema intelligence, wikilink validation, content similarity |
-| `tasks` | 3 | Task queries and mutations |
-| `health` | 12 | Vault diagnostics, index management, growth, config, merges |
-| `ops` | 2 | Git undo, policy automation |
-| `note-ops` | 4 | Delete, move, rename notes, merge entities |
+Composable bundles add capabilities to any preset. See [docs/CONFIGURATION.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/CONFIGURATION.md) for all bundles and fine-grained categories.
 
 The fewer tools you load, the less context Claude needs to pick the right one. See [docs/TOOLS.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/TOOLS.md) for the full reference.
 
@@ -351,7 +340,7 @@ The fewer tools you load, the less context Claude needs to pick the right one. S
 | Doc | Why read this |
 |---|---|
 | [PROVE-IT.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/PROVE-IT.md) | See it working in 5 minutes |
-| [TOOLS.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/TOOLS.md) | All 51 tools documented |
+| [TOOLS.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/TOOLS.md) | All 61 tools documented |
 | [ALGORITHM.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/ALGORITHM.md) | How the scoring works |
 | [COOKBOOK.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/COOKBOOK.md) | Example prompts by use case |
 | [SETUP.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/SETUP.md) | Full setup guide for your vault |

package/bin/flywheel-memory.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/index.js

@@ -19336,8 +19336,7 @@ var ALL_CATEGORIES = [
   "tasks",
   "memory",
   "note-ops",
-  "diagnostics",
-  "automation"
+  "diagnostics"
 ];
 var PRESETS = {
   // Presets
@@ -19352,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 = {
@@ -19373,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();
@@ -19427,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",
@@ -19488,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 = [];
@@ -19518,7 +19515,37 @@ 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. Describe what you want in plain
+language \u2014 Claude authors the YAML, saves it, and can execute it on demand. No YAML knowledge needed.
+
+Policies 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: ask "create a policy that generates a weekly review note, pulls open tasks, and updates
+project frontmatter" \u2014 Claude authors the YAML, saves it to .claude/policies/, and runs it whenever
+you say "run the weekly review for this week".`);
   }
   if (categories.has("memory")) {
     parts.push(`

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@velvetmonkey/flywheel-memory",
-  "version": "2.0.80",
+  "version": "2.0.82",
   "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",
   "bin": {
-    "flywheel-memory": "dist/index.js"
+    "flywheel-memory": "bin/flywheel-memory.js"
   },
   "repository": {
     "type": "git",
@@ -52,7 +52,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@velvetmonkey/vault-core": "^2.0.80",
+    "@velvetmonkey/vault-core": "^2.0.82",
     "better-sqlite3": "^11.0.0",
     "chokidar": "^4.0.0",
     "gray-matter": "^4.0.3",
@@ -76,6 +76,7 @@
   },
   "license": "Apache-2.0",
   "files": [
+    "bin",
     "dist",
     "README.md",
     "LICENSE"