@velvetmonkey/flywheel-memory 2.0.6 → 2.0.8

package/dist/index.js

@@ -2732,9 +2732,9 @@ import { simpleGit, CheckRepoActions } from "simple-git";
 import path5 from "path";
 import fs5 from "fs/promises";
 import {
-  setCrankState,
-  getCrankState,
-  deleteCrankState
+  setWriteState,
+  getWriteState,
+  deleteWriteState
 } from "@velvetmonkey/vault-core";
 var moduleStateDb = null;
 function setGitStateDb(stateDb2) {
@@ -2747,9 +2747,9 @@ var DEFAULT_RETRY = {
   jitter: true
 };
 var STALE_LOCK_THRESHOLD_MS = 3e4;
-function saveLastCrankCommit(hash, message) {
+function saveLastMutationCommit(hash, message) {
   if (!moduleStateDb) {
-    console.error("[Crank] No StateDb available for saving last commit");
+    console.error("[Flywheel] No StateDb available for saving last commit");
     return;
   }
   const data = {
@@ -2758,27 +2758,27 @@ function saveLastCrankCommit(hash, message) {
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   };
   try {
-    setCrankState(moduleStateDb, "last_commit", data);
+    setWriteState(moduleStateDb, "last_commit", data);
   } catch (e) {
-    console.error("[Crank] Failed to save last commit to StateDb:", e);
+    console.error("[Flywheel] Failed to save last commit to StateDb:", e);
   }
 }
-function getLastCrankCommit() {
+function getLastMutationCommit() {
   if (!moduleStateDb) {
     return null;
   }
   try {
-    return getCrankState(moduleStateDb, "last_commit");
+    return getWriteState(moduleStateDb, "last_commit");
   } catch {
     return null;
   }
 }
-function clearLastCrankCommit() {
+function clearLastMutationCommit() {
   if (!moduleStateDb) {
     return;
   }
   try {
-    deleteCrankState(moduleStateDb, "last_commit");
+    deleteWriteState(moduleStateDb, "last_commit");
   } catch {
   }
 }
@@ -2860,7 +2860,7 @@ async function commitChange(vaultPath2, filePath, messagePrefix, retryConfig = D
       const commitMessage = `${messagePrefix} Update ${fileName}`;
       const result = await git.commit(commitMessage);
       if (result.commit) {
-        saveLastCrankCommit(result.commit, commitMessage);
+        saveLastMutationCommit(result.commit, commitMessage);
       }
       return {
         success: true,
@@ -2995,7 +2995,7 @@ Files:
 ${files.map((f) => `- ${f}`).join("\n")}`;
       const result = await git.commit(commitMessage);
       if (result.commit) {
-        saveLastCrankCommit(result.commit, commitMessage);
+        saveLastMutationCommit(result.commit, commitMessage);
       }
       return {
         success: true,
@@ -3040,8 +3040,8 @@ ${files.map((f) => `- ${f}`).join("\n")}`;
 
 // src/core/write/hints.ts
 import {
-  setCrankState as setCrankState2,
-  getCrankState as getCrankState2
+  setWriteState as setWriteState2,
+  getWriteState as getWriteState2
 } from "@velvetmonkey/vault-core";
 var moduleStateDb2 = null;
 function setHintsStateDb(stateDb2) {
@@ -3115,7 +3115,7 @@ async function buildRecencyIndex(vaultPath2, entities) {
       }
     }
   } catch (error) {
-    console.error(`[Crank] Error building recency index: ${error}`);
+    console.error(`[Flywheel] Error building recency index: ${error}`);
   }
   return {
     lastMentioned,
@@ -3158,16 +3158,16 @@ function loadRecencyFromStateDb() {
 }
 function saveRecencyToStateDb(index) {
   if (!moduleStateDb3) {
-    console.error("[Crank] No StateDb available for saving recency");
+    console.error("[Flywheel] No StateDb available for saving recency");
     return;
   }
   try {
     for (const [entityNameLower, timestamp] of index.lastMentioned) {
       recordEntityMention(moduleStateDb3, entityNameLower, new Date(timestamp));
     }
-    console.error(`[Crank] Saved ${index.lastMentioned.size} recency entries to StateDb`);
+    console.error(`[Flywheel] Saved ${index.lastMentioned.size} recency entries to StateDb`);
   } catch (e) {
-    console.error("[Crank] Failed to save recency to StateDb:", e);
+    console.error("[Flywheel] Failed to save recency to StateDb:", e);
   }
 }
 
@@ -4068,7 +4068,7 @@ function getCooccurrenceBoost(entityName, matchedEntities, cooccurrenceIndex2, r
 
 // src/core/write/wikilinks.ts
 var moduleStateDb4 = null;
-function setCrankStateDb(stateDb2) {
+function setWriteStateDb(stateDb2) {
   moduleStateDb4 = stateDb2;
   setGitStateDb(stateDb2);
   setHintsStateDb(stateDb2);
@@ -4113,21 +4113,21 @@ async function initializeEntityIndex(vaultPath2) {
           entityIndex = dbIndex;
           indexReady = true;
           lastLoadedAt = Date.now();
-          console.error(`[Crank] Loaded ${dbIndex._metadata.total_entities} entities from StateDb`);
+          console.error(`[Flywheel] Loaded ${dbIndex._metadata.total_entities} entities from StateDb`);
           return;
         }
       } catch (e) {
-        console.error("[Crank] Failed to load from StateDb:", e);
+        console.error("[Flywheel] Failed to load from StateDb:", e);
       }
     }
     await rebuildIndex(vaultPath2);
   } catch (error) {
     indexError2 = error instanceof Error ? error : new Error(String(error));
-    console.error(`[Crank] Failed to initialize entity index: ${indexError2.message}`);
+    console.error(`[Flywheel] Failed to initialize entity index: ${indexError2.message}`);
   }
 }
 async function rebuildIndex(vaultPath2) {
-  console.error(`[Crank] Scanning vault for entities...`);
+  console.error(`[Flywheel] Scanning vault for entities...`);
   const startTime = Date.now();
   entityIndex = await scanVaultEntities(vaultPath2, {
     excludeFolders: DEFAULT_EXCLUDE_FOLDERS
@@ -4135,13 +4135,13 @@ async function rebuildIndex(vaultPath2) {
   indexReady = true;
   lastLoadedAt = Date.now();
   const entityDuration = Date.now() - startTime;
-  console.error(`[Crank] Entity index built: ${entityIndex._metadata.total_entities} entities in ${entityDuration}ms`);
+  console.error(`[Flywheel] Entity index built: ${entityIndex._metadata.total_entities} entities in ${entityDuration}ms`);
   if (moduleStateDb4) {
     try {
       moduleStateDb4.replaceAllEntities(entityIndex);
-      console.error(`[Crank] Saved entities to StateDb`);
+      console.error(`[Flywheel] Saved entities to StateDb`);
     } catch (e) {
-      console.error(`[Crank] Failed to save entities to StateDb: ${e}`);
+      console.error(`[Flywheel] Failed to save entities to StateDb: ${e}`);
     }
   }
   const entities = getAllEntities(entityIndex);
@@ -4150,25 +4150,25 @@ async function rebuildIndex(vaultPath2) {
     const cooccurrenceStart = Date.now();
     cooccurrenceIndex = await mineCooccurrences(vaultPath2, entityNames);
     const cooccurrenceDuration = Date.now() - cooccurrenceStart;
-    console.error(`[Crank] Co-occurrence index built: ${cooccurrenceIndex._metadata.total_associations} associations in ${cooccurrenceDuration}ms`);
+    console.error(`[Flywheel] Co-occurrence index built: ${cooccurrenceIndex._metadata.total_associations} associations in ${cooccurrenceDuration}ms`);
   } catch (e) {
-    console.error(`[Crank] Failed to build co-occurrence index: ${e}`);
+    console.error(`[Flywheel] Failed to build co-occurrence index: ${e}`);
   }
   try {
     const cachedRecency = loadRecencyFromStateDb();
     const cacheAgeMs = cachedRecency ? Date.now() - cachedRecency.lastUpdated : Infinity;
     if (cachedRecency && cacheAgeMs < 60 * 60 * 1e3) {
       recencyIndex = cachedRecency;
-      console.error(`[Crank] Recency index loaded from StateDb (${recencyIndex.lastMentioned.size} entities)`);
+      console.error(`[Flywheel] Recency index loaded from StateDb (${recencyIndex.lastMentioned.size} entities)`);
     } else {
       const recencyStart = Date.now();
       recencyIndex = await buildRecencyIndex(vaultPath2, entities);
       const recencyDuration = Date.now() - recencyStart;
-      console.error(`[Crank] Recency index built: ${recencyIndex.lastMentioned.size} entities in ${recencyDuration}ms`);
+      console.error(`[Flywheel] Recency index built: ${recencyIndex.lastMentioned.size} entities in ${recencyDuration}ms`);
       saveRecencyToStateDb(recencyIndex);
     }
   } catch (e) {
-    console.error(`[Crank] Failed to build recency index: ${e}`);
+    console.error(`[Flywheel] Failed to build recency index: ${e}`);
   }
 }
 function isEntityIndexReady() {
@@ -4181,16 +4181,16 @@ function checkAndRefreshIfStale() {
     if (!metadata.entitiesBuiltAt) return;
     const dbBuiltAt = new Date(metadata.entitiesBuiltAt).getTime();
     if (dbBuiltAt > lastLoadedAt) {
-      console.error("[Crank] Entity index stale, reloading from StateDb...");
+      console.error("[Flywheel] Entity index stale, reloading from StateDb...");
       const dbIndex = getEntityIndexFromDb(moduleStateDb4);
       if (dbIndex._metadata.total_entities > 0) {
         entityIndex = dbIndex;
         lastLoadedAt = Date.now();
-        console.error(`[Crank] Reloaded ${dbIndex._metadata.total_entities} entities`);
+        console.error(`[Flywheel] Reloaded ${dbIndex._metadata.total_entities} entities`);
       }
     }
   } catch (e) {
-    console.error("[Crank] Failed to check for stale entities:", e);
+    console.error("[Flywheel] Failed to check for stale entities:", e);
   }
 }
 function sortEntitiesByPriority(entities, notePath) {
@@ -4210,7 +4210,7 @@ function sortEntitiesByPriority(entities, notePath) {
 }
 function processWikilinks(content, notePath) {
   if (!isEntityIndexReady() || !entityIndex) {
-    console.error("[Crank:DEBUG] Entity index not ready, entities:", entityIndex?._metadata?.total_entities ?? 0);
+    console.error("[Flywheel:DEBUG] Entity index not ready, entities:", entityIndex?._metadata?.total_entities ?? 0);
     return {
       content,
       linksAdded: 0,
@@ -4218,7 +4218,7 @@ function processWikilinks(content, notePath) {
     };
   }
   const entities = getAllEntities(entityIndex);
-  console.error(`[Crank:DEBUG] Processing wikilinks with ${entities.length} entities`);
+  console.error(`[Flywheel:DEBUG] Processing wikilinks with ${entities.length} entities`);
   const sortedEntities = sortEntitiesByPriority(entities, notePath);
   const resolved = resolveAliasWikilinks(content, sortedEntities, {
     caseInsensitive: true
@@ -4818,9 +4818,9 @@ async function initializeLogger2(vaultPath2) {
   try {
     const sessionId = generateSessionId2();
     setSessionId2(sessionId);
-    logger2 = await createLoggerFromConfig2(vaultPath2, "crank");
+    logger2 = await createLoggerFromConfig2(vaultPath2, "write");
   } catch (error) {
-    console.error(`[Crank] Failed to initialize logger: ${error}`);
+    console.error(`[Flywheel] Failed to initialize logger: ${error}`);
     logger2 = null;
   }
 }
@@ -9069,7 +9069,7 @@ function registerMutationTools(server2, vaultPath2, getConfig = () => ({})) {
           vaultPath: vaultPath2,
           notePath,
           commit,
-          commitPrefix: "[Crank:Add]",
+          commitPrefix: "[Flywheel:Add]",
           section,
           actionDescription: "add content",
           scoping: agent_id || session_id ? { agent_id, session_id } : void 0
@@ -9144,7 +9144,7 @@ function registerMutationTools(server2, vaultPath2, getConfig = () => ({})) {
           vaultPath: vaultPath2,
           notePath,
           commit,
-          commitPrefix: "[Crank:Remove]",
+          commitPrefix: "[Flywheel:Remove]",
           section,
           actionDescription: "remove content",
           scoping: agent_id || session_id ? { agent_id, session_id } : void 0
@@ -9195,7 +9195,7 @@ function registerMutationTools(server2, vaultPath2, getConfig = () => ({})) {
           vaultPath: vaultPath2,
           notePath,
           commit,
-          commitPrefix: "[Crank:Replace]",
+          commitPrefix: "[Flywheel:Replace]",
           section,
           actionDescription: "replace content",
           scoping: agent_id || session_id ? { agent_id, session_id } : void 0
@@ -9338,7 +9338,7 @@ function registerTaskTools(server2, vaultPath2) {
           finalFrontmatter = injectMutationMetadata(frontmatter, { agent_id, session_id });
         }
         await writeVaultFile(vaultPath2, notePath, toggleResult.content, finalFrontmatter);
-        const gitInfo = await handleGitCommit(vaultPath2, notePath, commit, "[Crank:Task]");
+        const gitInfo = await handleGitCommit(vaultPath2, notePath, commit, "[Flywheel:Task]");
         const newStatus = toggleResult.newState ? "completed" : "incomplete";
         const checkbox = toggleResult.newState ? "[x]" : "[ ]";
         return formatMcpResult(
@@ -9379,7 +9379,7 @@ function registerTaskTools(server2, vaultPath2) {
           vaultPath: vaultPath2,
           notePath,
           commit,
-          commitPrefix: "[Crank:Task]",
+          commitPrefix: "[Flywheel:Task]",
           section,
           actionDescription: "add task",
           scoping: agent_id || session_id ? { agent_id, session_id } : void 0
@@ -9446,7 +9446,7 @@ function registerFrontmatterTools(server2, vaultPath2) {
           vaultPath: vaultPath2,
           notePath,
           commit,
-          commitPrefix: "[Crank:FM]",
+          commitPrefix: "[Flywheel:FM]",
           actionDescription: "update frontmatter"
         },
         async (ctx) => {
@@ -9559,7 +9559,7 @@ function registerNoteTools(server2, vaultPath2, getIndex) {
           finalFrontmatter = injectMutationMetadata(frontmatter, { agent_id, session_id });
         }
         await writeVaultFile(vaultPath2, notePath, processedContent, finalFrontmatter);
-        const gitInfo = await handleGitCommit(vaultPath2, notePath, commit, "[Crank:Create]");
+        const gitInfo = await handleGitCommit(vaultPath2, notePath, commit, "[Flywheel:Create]");
         const infoLines = [wikilinkInfo, suggestInfo].filter(Boolean);
         const previewLines = [
           `Frontmatter fields: ${Object.keys(frontmatter).join(", ") || "none"}`,
@@ -9639,7 +9639,7 @@ ${sources}`;
         }
         const fullPath = path18.join(vaultPath2, notePath);
         await fs18.unlink(fullPath);
-        const gitInfo = await handleGitCommit(vaultPath2, notePath, commit, "[Crank:Delete]");
+        const gitInfo = await handleGitCommit(vaultPath2, notePath, commit, "[Flywheel:Delete]");
         const message = backlinkWarning ? `Deleted note: ${notePath}
 
 Warning: ${backlinkWarning}` : `Deleted note: ${notePath}`;
@@ -9843,7 +9843,7 @@ function registerMoveNoteTools(server2, vaultPath2) {
         let lockAgeMs;
         if (commit) {
           const filesToCommit = [newPath, ...backlinkUpdates.map((b) => b.path)];
-          const gitResult = await commitChange(vaultPath2, filesToCommit.join(", "), `[Crank:Move] ${oldPath} \u2192 ${newPath}`);
+          const gitResult = await commitChange(vaultPath2, filesToCommit.join(", "), `[Flywheel:Move] ${oldPath} \u2192 ${newPath}`);
           if (gitResult.success && gitResult.hash) {
             gitCommit = gitResult.hash;
             undoAvailable = gitResult.undoAvailable;
@@ -9854,7 +9854,7 @@ function registerMoveNoteTools(server2, vaultPath2) {
           }
         }
         initializeEntityIndex(vaultPath2).catch((err) => {
-          console.error(`[Crank] Entity cache rebuild failed: ${err}`);
+          console.error(`[Flywheel] Entity cache rebuild failed: ${err}`);
         });
         const previewLines = [
           `Moved: ${oldPath} \u2192 ${newPath}`
@@ -9918,7 +9918,7 @@ function registerMoveNoteTools(server2, vaultPath2) {
         }
         const sanitizedTitle = newTitle.replace(/[<>:"/\\|?*]/g, "");
         if (sanitizedTitle !== newTitle) {
-          console.error(`[Crank] Title sanitized: "${newTitle}" \u2192 "${sanitizedTitle}"`);
+          console.error(`[Flywheel] Title sanitized: "${newTitle}" \u2192 "${sanitizedTitle}"`);
         }
         const fullPath = path19.join(vaultPath2, notePath);
         const dir = path19.dirname(notePath);
@@ -9983,7 +9983,7 @@ function registerMoveNoteTools(server2, vaultPath2) {
         let lockAgeMs;
         if (commit) {
           const filesToCommit = [newPath, ...backlinkUpdates.map((b) => b.path)];
-          const gitResult = await commitChange(vaultPath2, filesToCommit.join(", "), `[Crank:Rename] ${oldTitle} \u2192 ${sanitizedTitle}`);
+          const gitResult = await commitChange(vaultPath2, filesToCommit.join(", "), `[Flywheel:Rename] ${oldTitle} \u2192 ${sanitizedTitle}`);
           if (gitResult.success && gitResult.hash) {
             gitCommit = gitResult.hash;
             undoAvailable = gitResult.undoAvailable;
@@ -9994,7 +9994,7 @@ function registerMoveNoteTools(server2, vaultPath2) {
           }
         }
         initializeEntityIndex(vaultPath2).catch((err) => {
-          console.error(`[Crank] Entity cache rebuild failed: ${err}`);
+          console.error(`[Flywheel] Entity cache rebuild failed: ${err}`);
         });
         const previewLines = [
           `Renamed: "${oldTitle}" \u2192 "${sanitizedTitle}"`
@@ -10036,7 +10036,7 @@ import { z as z16 } from "zod";
 function registerSystemTools2(server2, vaultPath2) {
   server2.tool(
     "vault_undo_last_mutation",
-    "Undo the last git commit (typically the last Crank mutation). Performs a soft reset.",
+    "Undo the last git commit (typically the last Flywheel mutation). Performs a soft reset.",
     {
       confirm: z16.boolean().default(false).describe("Must be true to confirm undo operation"),
       hash: z16.string().optional().describe("Expected commit hash. If provided, undo only proceeds if HEAD matches this hash. Prevents accidentally undoing the wrong commit.")
@@ -10095,15 +10095,15 @@ Actual HEAD: ${currentHead.hash} "${currentHead.message}"`
             return { content: [{ type: "text", text: JSON.stringify(result2, null, 2) }] };
           }
         }
-        const lastCrankCommit = getLastCrankCommit();
+        const lastMutationCommit = getLastMutationCommit();
         const lastCommit = await getLastCommit(vaultPath2);
-        if (lastCrankCommit && lastCommit) {
-          if (lastCommit.hash !== lastCrankCommit.hash) {
+        if (lastMutationCommit && lastCommit) {
+          if (lastCommit.hash !== lastMutationCommit.hash) {
             const result2 = {
               success: false,
-              message: `Cannot undo: HEAD (${lastCommit.hash.substring(0, 7)}) doesn't match last Crank commit (${lastCrankCommit.hash.substring(0, 7)}). Another process may have committed since your mutation.`,
+              message: `Cannot undo: HEAD (${lastCommit.hash.substring(0, 7)}) doesn't match last Flywheel commit (${lastMutationCommit.hash.substring(0, 7)}). Another process may have committed since your mutation.`,
               path: "",
-              preview: `Expected: ${lastCrankCommit.hash.substring(0, 7)} "${lastCrankCommit.message}"
+              preview: `Expected: ${lastMutationCommit.hash.substring(0, 7)} "${lastMutationCommit.message}"
 Actual HEAD: ${lastCommit.hash.substring(0, 7)} "${lastCommit.message}"`
             };
             return { content: [{ type: "text", text: JSON.stringify(result2, null, 2) }] };
@@ -10118,7 +10118,7 @@ Actual HEAD: ${lastCommit.hash.substring(0, 7)} "${lastCommit.message}"`
           };
           return { content: [{ type: "text", text: JSON.stringify(result2, null, 2) }] };
         }
-        clearLastCrankCommit();
+        clearLastMutationCommit();
         const result = {
           success: true,
           message: undoResult.message,
@@ -11477,9 +11477,8 @@ var vaultIndex;
 var flywheelConfig = {};
 var stateDb = null;
 var PRESETS = {
-  // Core tools: search, navigate, create, edit
-  minimal: ["search", "backlinks", "health", "tasks", "append", "frontmatter", "notes", "structure"],
-  // All tools (default)
+  // Presets
+  minimal: ["search", "structure", "append", "frontmatter", "notes"],
   full: [
     "search",
     "backlinks",
@@ -11496,7 +11495,13 @@ var PRESETS = {
     "notes",
     "git",
     "policy"
-  ]
+  ],
+  // Composable bundles
+  graph: ["backlinks", "orphans", "hubs", "paths"],
+  analysis: ["schema", "wikilinks"],
+  tasks: ["tasks"],
+  health: ["health"],
+  ops: ["git", "policy"]
 };
 var ALL_CATEGORIES = [
   "backlinks",
@@ -11552,7 +11557,6 @@ var TOOL_CATEGORY = {
   get_folder_structure: "health",
   refresh_index: "health",
   // absorbed rebuild_search_index
-  get_note_metadata: "health",
   get_all_entities: "health",
   get_unlinked_mentions: "health",
   // search (unified: metadata + content + entities)
@@ -11573,6 +11577,7 @@ var TOOL_CATEGORY = {
   get_note_structure: "structure",
   get_section_content: "structure",
   find_sections: "structure",
+  get_note_metadata: "structure",
   // tasks (unified: all task queries + write)
   tasks: "tasks",
   vault_toggle_task: "tasks",
@@ -11665,7 +11670,7 @@ async function main() {
     stateDb = openStateDb(vaultPath);
     console.error("[Memory] StateDb initialized");
     setFTS5Database(stateDb.db);
-    setCrankStateDb(stateDb);
+    setWriteStateDb(stateDb);
     await initializeEntityIndex(vaultPath);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
@@ -11812,6 +11817,9 @@ async function runPostIndexWork(index) {
     } else {
       const debounceMs = parseInt(process.env.FLYWHEEL_DEBOUNCE_MS || "60000");
       console.error(`[Memory] File watcher v1 enabled (debounce: ${debounceMs}ms)`);
+      if (debounceMs >= 6e4) {
+        console.error("[Memory] Warning: Legacy watcher using high debounce (60s). Set FLYWHEEL_WATCH_V2=true for 200ms responsiveness.");
+      }
       const legacyWatcher = chokidar2.watch(vaultPath, {
         ignored: /(^|[\/\\])\../,
         persistent: true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@velvetmonkey/flywheel-memory",
-  "version": "2.0.6",
-  "description": "MCP server that gives Claude full read/write access to your Obsidian vault. 76 tools for search, backlinks, graph queries, and mutations.",
+  "version": "2.0.8",
+  "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",
   "bin": {
@@ -40,6 +40,8 @@
     "test:watch": "vitest",
     "test:read": "vitest run test/read/",
     "test:write": "vitest run test/write/",
+    "test:security": "vitest run test/write/security/",
+    "test:stress": "vitest run test/write/stress/ test/write/battle-hardening/",
     "test:coverage": "vitest run --coverage",
     "test:ci": "vitest run --reporter=github-actions",
     "lint": "tsc --noEmit",
@@ -48,7 +50,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@velvetmonkey/vault-core": "^2.0.6",
+    "@velvetmonkey/vault-core": "^2.0.8",
     "better-sqlite3": "^11.0.0",
     "chokidar": "^4.0.0",
     "gray-matter": "^4.0.3",