@velvetmonkey/flywheel-mcp 1.27.14 → 1.27.16

package/dist/index.js

@@ -260,8 +260,8 @@ function updateIndexProgress(parsed, total) {
 function normalizeTarget(target) {
   return target.toLowerCase().replace(/\.md$/, "");
 }
-function normalizeNotePath(path12) {
-  return path12.toLowerCase().replace(/\.md$/, "");
+function normalizeNotePath(path13) {
+  return path13.toLowerCase().replace(/\.md$/, "");
 }
 async function buildVaultIndex(vaultPath2, options = {}) {
   const { timeoutMs = DEFAULT_TIMEOUT_MS, onProgress } = options;
@@ -455,7 +455,7 @@ function findSimilarEntity(index, target) {
   }
   const maxDist = normalizedLen <= 10 ? 1 : 2;
   let bestMatch;
-  for (const [entity, path12] of index.entities) {
+  for (const [entity, path13] of index.entities) {
     const lenDiff = Math.abs(entity.length - normalizedLen);
     if (lenDiff > maxDist) {
       continue;
@@ -463,7 +463,7 @@ function findSimilarEntity(index, target) {
     const dist = levenshteinDistance(normalized, entity);
     if (dist > 0 && dist <= maxDist) {
       if (!bestMatch || dist < bestMatch.distance) {
-        bestMatch = { path: path12, entity, distance: dist };
+        bestMatch = { path: path13, entity, distance: dist };
         if (dist === 1) {
           return bestMatch;
         }
@@ -889,14 +889,14 @@ function registerWikilinkTools(server2, getIndex, getVaultPath) {
   };
   function findSimilarEntity2(target, entities) {
     const targetLower = target.toLowerCase();
-    for (const [name, path12] of entities) {
+    for (const [name, path13] of entities) {
       if (name.startsWith(targetLower) || targetLower.startsWith(name)) {
-        return path12;
+        return path13;
       }
     }
-    for (const [name, path12] of entities) {
+    for (const [name, path13] of entities) {
       if (name.includes(targetLower) || targetLower.includes(name)) {
-        return path12;
+        return path13;
       }
     }
     return void 0;
@@ -1193,8 +1193,8 @@ function registerHealthTools(server2, getIndex, getVaultPath) {
     top_tags: z3.array(TagStatSchema).describe("Top 20 most used tags"),
     folders: z3.array(FolderStatSchema).describe("Note counts by top-level folder")
   };
-  function isPeriodicNote(path12) {
-    const filename = path12.split("/").pop() || "";
+  function isPeriodicNote(path13) {
+    const filename = path13.split("/").pop() || "";
     const nameWithoutExt = filename.replace(/\.md$/, "");
     const patterns = [
       /^\d{4}-\d{2}-\d{2}$/,
@@ -1209,7 +1209,7 @@ function registerHealthTools(server2, getIndex, getVaultPath) {
       // YYYY (yearly)
     ];
     const periodicFolders = ["daily", "weekly", "monthly", "quarterly", "yearly", "journal", "journals"];
-    const folder = path12.split("/")[0]?.toLowerCase() || "";
+    const folder = path13.split("/")[0]?.toLowerCase() || "";
     return patterns.some((p) => p.test(nameWithoutExt)) || periodicFolders.includes(folder);
   }
   server2.registerTool(
@@ -2131,8 +2131,8 @@ function getStaleNotes(index, days, minBacklinks = 0) {
     return b.days_since_modified - a.days_since_modified;
   });
 }
-function getContemporaneousNotes(index, path12, hours = 24) {
-  const targetNote = index.notes.get(path12);
+function getContemporaneousNotes(index, path13, hours = 24) {
+  const targetNote = index.notes.get(path13);
   if (!targetNote) {
     return [];
   }
@@ -2140,7 +2140,7 @@ function getContemporaneousNotes(index, path12, hours = 24) {
   const windowMs = hours * 60 * 60 * 1e3;
   const results = [];
   for (const note of index.notes.values()) {
-    if (note.path === path12) continue;
+    if (note.path === path13) continue;
     const timeDiff = Math.abs(note.modified.getTime() - targetTime);
     if (timeDiff <= windowMs) {
       results.push({
@@ -2932,14 +2932,14 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig = ()
         offset: z6.number().default(0).describe("Number of results to skip (for pagination)")
       }
     },
-    async ({ path: path12, hours, limit: requestedLimit, offset }) => {
+    async ({ path: path13, hours, limit: requestedLimit, offset }) => {
       const limit = Math.min(requestedLimit ?? 50, MAX_LIMIT);
       const index = getIndex();
-      const allResults = getContemporaneousNotes(index, path12, hours);
+      const allResults = getContemporaneousNotes(index, path13, hours);
       const result = allResults.slice(offset, offset + limit);
       return {
         content: [{ type: "text", text: JSON.stringify({
-          reference_note: path12,
+          reference_note: path13,
           window_hours: hours,
           total_count: allResults.length,
           returned_count: result.length,
@@ -2977,13 +2977,13 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig = ()
         path: z6.string().describe("Path to the note")
       }
     },
-    async ({ path: path12 }) => {
+    async ({ path: path13 }) => {
       const index = getIndex();
       const vaultPath2 = getVaultPath();
-      const result = await getNoteStructure(index, path12, vaultPath2);
+      const result = await getNoteStructure(index, path13, vaultPath2);
       if (!result) {
         return {
-          content: [{ type: "text", text: JSON.stringify({ error: "Note not found", path: path12 }, null, 2) }]
+          content: [{ type: "text", text: JSON.stringify({ error: "Note not found", path: path13 }, null, 2) }]
         };
       }
       return {
@@ -3000,18 +3000,18 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig = ()
         path: z6.string().describe("Path to the note")
       }
     },
-    async ({ path: path12 }) => {
+    async ({ path: path13 }) => {
       const index = getIndex();
       const vaultPath2 = getVaultPath();
-      const result = await getHeadings(index, path12, vaultPath2);
+      const result = await getHeadings(index, path13, vaultPath2);
       if (!result) {
         return {
-          content: [{ type: "text", text: JSON.stringify({ error: "Note not found", path: path12 }, null, 2) }]
+          content: [{ type: "text", text: JSON.stringify({ error: "Note not found", path: path13 }, null, 2) }]
         };
       }
       return {
         content: [{ type: "text", text: JSON.stringify({
-          path: path12,
+          path: path13,
           heading_count: result.length,
           headings: result
         }, null, 2) }]
@@ -3029,15 +3029,15 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig = ()
         include_subheadings: z6.boolean().default(true).describe("Include content under subheadings")
       }
     },
-    async ({ path: path12, heading, include_subheadings }) => {
+    async ({ path: path13, heading, include_subheadings }) => {
       const index = getIndex();
       const vaultPath2 = getVaultPath();
-      const result = await getSectionContent(index, path12, heading, vaultPath2, include_subheadings);
+      const result = await getSectionContent(index, path13, heading, vaultPath2, include_subheadings);
       if (!result) {
         return {
           content: [{ type: "text", text: JSON.stringify({
             error: "Section not found",
-            path: path12,
+            path: path13,
             heading
           }, null, 2) }]
         };
@@ -3114,19 +3114,19 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig = ()
         path: z6.string().describe("Path to the note")
       }
     },
-    async ({ path: path12 }) => {
+    async ({ path: path13 }) => {
       const index = getIndex();
       const vaultPath2 = getVaultPath();
       const config = getConfig();
-      const result = await getTasksFromNote(index, path12, vaultPath2, config.exclude_task_tags || []);
+      const result = await getTasksFromNote(index, path13, vaultPath2, config.exclude_task_tags || []);
       if (!result) {
         return {
-          content: [{ type: "text", text: JSON.stringify({ error: "Note not found", path: path12 }, null, 2) }]
+          content: [{ type: "text", text: JSON.stringify({ error: "Note not found", path: path13 }, null, 2) }]
         };
       }
       return {
         content: [{ type: "text", text: JSON.stringify({
-          path: path12,
+          path: path13,
           task_count: result.length,
           open: result.filter((t) => t.status === "open").length,
           completed: result.filter((t) => t.status === "completed").length,
@@ -3258,14 +3258,14 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig = ()
         offset: z6.number().default(0).describe("Number of results to skip (for pagination)")
       }
     },
-    async ({ path: path12, limit: requestedLimit, offset }) => {
+    async ({ path: path13, limit: requestedLimit, offset }) => {
       const limit = Math.min(requestedLimit ?? 50, MAX_LIMIT);
       const index = getIndex();
-      const allResults = findBidirectionalLinks(index, path12);
+      const allResults = findBidirectionalLinks(index, path13);
       const result = allResults.slice(offset, offset + limit);
       return {
         content: [{ type: "text", text: JSON.stringify({
-          scope: path12 || "all",
+          scope: path13 || "all",
           total_count: allResults.length,
           returned_count: result.length,
           pairs: result
@@ -5006,30 +5006,30 @@ var EventQueue = class {
    * Add a new event to the queue
    */
   push(type, rawPath) {
-    const path12 = normalizePath(rawPath);
+    const path13 = normalizePath(rawPath);
     const now = Date.now();
     const event = {
       type,
-      path: path12,
+      path: path13,
       timestamp: now
     };
-    let pending = this.pending.get(path12);
+    let pending = this.pending.get(path13);
     if (!pending) {
       pending = {
         events: [],
         timer: null,
         lastEvent: now
       };
-      this.pending.set(path12, pending);
+      this.pending.set(path13, pending);
     }
     pending.events.push(event);
     pending.lastEvent = now;
-    console.error(`[flywheel] QUEUE: pushed ${type} for ${path12}, pending=${this.pending.size}`);
+    console.error(`[flywheel] QUEUE: pushed ${type} for ${path13}, pending=${this.pending.size}`);
     if (pending.timer) {
       clearTimeout(pending.timer);
     }
     pending.timer = setTimeout(() => {
-      this.flushPath(path12);
+      this.flushPath(path13);
     }, this.config.debounceMs);
     if (this.pending.size >= this.config.batchSize) {
       this.flush();
@@ -5050,10 +5050,10 @@ var EventQueue = class {
   /**
    * Flush a single path's events
    */
-  flushPath(path12) {
-    const pending = this.pending.get(path12);
+  flushPath(path13) {
+    const pending = this.pending.get(path13);
     if (!pending || pending.events.length === 0) return;
-    console.error(`[flywheel] QUEUE: flushing ${path12}, events=${pending.events.length}`);
+    console.error(`[flywheel] QUEUE: flushing ${path13}, events=${pending.events.length}`);
     if (pending.timer) {
       clearTimeout(pending.timer);
       pending.timer = null;
@@ -5062,7 +5062,7 @@ var EventQueue = class {
     if (coalescedType) {
       const coalesced = {
         type: coalescedType,
-        path: path12,
+        path: path13,
         originalEvents: [...pending.events]
       };
       this.onBatch({
@@ -5070,7 +5070,7 @@ var EventQueue = class {
         timestamp: Date.now()
       });
     }
-    this.pending.delete(path12);
+    this.pending.delete(path13);
   }
   /**
    * Flush all pending events
@@ -5082,7 +5082,7 @@ var EventQueue = class {
     }
     if (this.pending.size === 0) return;
     const events = [];
-    for (const [path12, pending] of this.pending) {
+    for (const [path13, pending] of this.pending) {
       if (pending.timer) {
         clearTimeout(pending.timer);
       }
@@ -5090,7 +5090,7 @@ var EventQueue = class {
       if (coalescedType) {
         events.push({
           type: coalescedType,
-          path: path12,
+          path: path13,
           originalEvents: [...pending.events]
         });
       }
@@ -5239,31 +5239,31 @@ function createVaultWatcher(options) {
         usePolling: config.usePolling,
         interval: config.usePolling ? config.pollInterval : void 0
       });
-      watcher.on("add", (path12) => {
-        console.error(`[flywheel] RAW EVENT: add ${path12}`);
-        if (shouldWatch(path12, vaultPath2)) {
-          console.error(`[flywheel] ACCEPTED: add ${path12}`);
-          eventQueue.push("add", path12);
+      watcher.on("add", (path13) => {
+        console.error(`[flywheel] RAW EVENT: add ${path13}`);
+        if (shouldWatch(path13, vaultPath2)) {
+          console.error(`[flywheel] ACCEPTED: add ${path13}`);
+          eventQueue.push("add", path13);
         } else {
-          console.error(`[flywheel] FILTERED: add ${path12}`);
+          console.error(`[flywheel] FILTERED: add ${path13}`);
         }
       });
-      watcher.on("change", (path12) => {
-        console.error(`[flywheel] RAW EVENT: change ${path12}`);
-        if (shouldWatch(path12, vaultPath2)) {
-          console.error(`[flywheel] ACCEPTED: change ${path12}`);
-          eventQueue.push("change", path12);
+      watcher.on("change", (path13) => {
+        console.error(`[flywheel] RAW EVENT: change ${path13}`);
+        if (shouldWatch(path13, vaultPath2)) {
+          console.error(`[flywheel] ACCEPTED: change ${path13}`);
+          eventQueue.push("change", path13);
         } else {
-          console.error(`[flywheel] FILTERED: change ${path12}`);
+          console.error(`[flywheel] FILTERED: change ${path13}`);
         }
       });
-      watcher.on("unlink", (path12) => {
-        console.error(`[flywheel] RAW EVENT: unlink ${path12}`);
-        if (shouldWatch(path12, vaultPath2)) {
-          console.error(`[flywheel] ACCEPTED: unlink ${path12}`);
-          eventQueue.push("unlink", path12);
+      watcher.on("unlink", (path13) => {
+        console.error(`[flywheel] RAW EVENT: unlink ${path13}`);
+        if (shouldWatch(path13, vaultPath2)) {
+          console.error(`[flywheel] ACCEPTED: unlink ${path13}`);
+          eventQueue.push("unlink", path13);
         } else {
-          console.error(`[flywheel] FILTERED: unlink ${path12}`);
+          console.error(`[flywheel] FILTERED: unlink ${path13}`);
         }
       });
       watcher.on("ready", () => {
@@ -5294,6 +5294,109 @@ function createVaultWatcher(options) {
   return instance;
 }
 
+// src/core/hubExport.ts
+import fs13 from "fs/promises";
+import path12 from "path";
+function computeHubScores(index) {
+  const hubScores = /* @__PURE__ */ new Map();
+  for (const note of index.notes.values()) {
+    const backlinks = getBacklinksForNote(index, note.path);
+    const backlinkCount = backlinks.length;
+    const normalizedPath = normalizeTarget(note.path);
+    hubScores.set(normalizedPath, backlinkCount);
+    const title = note.title.toLowerCase();
+    if (!hubScores.has(title) || backlinkCount > hubScores.get(title)) {
+      hubScores.set(title, backlinkCount);
+    }
+  }
+  return hubScores;
+}
+function enrichEntity(entity, hubScores) {
+  const entityObj = typeof entity === "string" ? { name: entity, path: "", aliases: [] } : { ...entity };
+  let hubScore = 0;
+  if (entityObj.path) {
+    const normalizedPath = normalizeTarget(entityObj.path);
+    hubScore = hubScores.get(normalizedPath) ?? 0;
+  }
+  if (hubScore === 0) {
+    const normalizedName = entityObj.name.toLowerCase();
+    hubScore = hubScores.get(normalizedName) ?? 0;
+  }
+  entityObj.hubScore = hubScore;
+  return entityObj;
+}
+function enrichEntityIndex(index, hubScores) {
+  const categories = [
+    "technologies",
+    "acronyms",
+    "people",
+    "projects",
+    "organizations",
+    "locations",
+    "concepts",
+    "other"
+  ];
+  const enriched = {
+    ...index,
+    _metadata: {
+      ...index._metadata,
+      generated_at: (/* @__PURE__ */ new Date()).toISOString()
+    }
+  };
+  for (const category of categories) {
+    if (enriched[category]) {
+      enriched[category] = enriched[category].map((e) => enrichEntity(e, hubScores));
+    }
+  }
+  return enriched;
+}
+async function exportHubScores(vaultPath2, vaultIndex2) {
+  const cachePath = path12.join(vaultPath2, ".claude", "wikilink-entities.json");
+  try {
+    await fs13.access(cachePath);
+  } catch {
+    console.error("[Flywheel] Entity cache not found, skipping hub score export");
+    return -1;
+  }
+  let entityIndex;
+  try {
+    const content = await fs13.readFile(cachePath, "utf-8");
+    entityIndex = JSON.parse(content);
+  } catch (e) {
+    console.error("[Flywheel] Failed to load entity cache:", e);
+    return -1;
+  }
+  const hubScores = computeHubScores(vaultIndex2);
+  console.error(`[Flywheel] Computed hub scores for ${hubScores.size} notes`);
+  const enriched = enrichEntityIndex(entityIndex, hubScores);
+  let hubCount = 0;
+  const categories = [
+    "technologies",
+    "acronyms",
+    "people",
+    "projects",
+    "organizations",
+    "locations",
+    "concepts",
+    "other"
+  ];
+  for (const category of categories) {
+    for (const entity of enriched[category] ?? []) {
+      if (typeof entity !== "string" && entity.hubScore && entity.hubScore > 0) {
+        hubCount++;
+      }
+    }
+  }
+  try {
+    await fs13.writeFile(cachePath, JSON.stringify(enriched, null, 2), "utf-8");
+    console.error(`[Flywheel] Exported hub scores: ${hubCount} entities with backlinks`);
+    return hubCount;
+  } catch (e) {
+    console.error("[Flywheel] Failed to save enriched entity cache:", e);
+    return -1;
+  }
+}
+
 // src/index.ts
 var vaultPath = process.env.PROJECT_PATH || findVaultRoot();
 var flywheelConfig = {};
@@ -5396,11 +5499,12 @@ async function main() {
   console.error("Flywheel MCP server running on stdio");
   console.error("Building vault index in background...");
   const startTime = Date.now();
-  buildVaultIndex(vaultPath).then((index) => {
+  buildVaultIndex(vaultPath).then(async (index) => {
     vaultIndex = index;
     setIndexState("ready");
     const duration = Date.now() - startTime;
     console.error(`Vault index ready in ${duration}ms`);
+    await exportHubScores(vaultPath, index);
     const existing = loadConfig(vaultPath);
     const inferred = inferConfig(vaultIndex, vaultPath);
     saveConfig(vaultPath, inferred, existing);
@@ -5432,6 +5536,7 @@ async function main() {
               vaultIndex = await buildVaultIndex(vaultPath);
               setIndexState("ready");
               console.error(`[flywheel] Index rebuilt in ${Date.now() - startTime2}ms`);
+              await exportHubScores(vaultPath, vaultIndex);
             } catch (err) {
               setIndexState("error");
               setIndexError(err instanceof Error ? err : new Error(String(err)));
@@ -5462,15 +5567,16 @@ async function main() {
           }
         });
         let rebuildTimer;
-        legacyWatcher.on("all", (event, path12) => {
-          if (!path12.endsWith(".md")) return;
+        legacyWatcher.on("all", (event, path13) => {
+          if (!path13.endsWith(".md")) return;
           clearTimeout(rebuildTimer);
           rebuildTimer = setTimeout(() => {
             console.error("[flywheel] Rebuilding index (file changed)");
-            buildVaultIndex(vaultPath).then((index2) => {
+            buildVaultIndex(vaultPath).then(async (index2) => {
               vaultIndex = index2;
               setIndexState("ready");
               console.error("[flywheel] Index rebuilt successfully");
+              await exportHubScores(vaultPath, index2);
             }).catch((err) => {
               setIndexState("error");
               setIndexError(err instanceof Error ? err : new Error(String(err)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velvetmonkey/flywheel-mcp",
-  "version": "1.27.14",
+  "version": "1.27.16",
   "description": "Graph intelligence for markdown vaults. MCP server for Obsidian.",
   "type": "module",
   "main": "dist/index.js",