@velvetmonkey/flywheel-memory 2.4.0 → 2.4.2

package/dist/index.js

@@ -2069,14 +2069,15 @@ function getAllSuppressionPenalties(stateDb2, now) {
   }
   return penalties;
 }
-function trackWikilinkApplications(stateDb2, notePath, entities) {
+function trackWikilinkApplications(stateDb2, notePath, entities, source = "tool") {
   const upsert = stateDb2.db.prepare(`
-    INSERT INTO wikilink_applications (entity, note_path, matched_term, applied_at, status)
-    VALUES (?, ?, ?, datetime('now'), 'applied')
+    INSERT INTO wikilink_applications (entity, note_path, matched_term, applied_at, status, source)
+    VALUES (?, ?, ?, datetime('now'), 'applied', ?)
     ON CONFLICT(entity, note_path) DO UPDATE SET
       matched_term = COALESCE(?, matched_term),
       applied_at = datetime('now'),
-      status = 'applied'
+      status = 'applied',
+      source = ?
   `);
   const lookupCanonical = stateDb2.db.prepare(
     `SELECT name FROM entities WHERE LOWER(name) = LOWER(?) LIMIT 1`
@@ -2087,7 +2088,7 @@ function trackWikilinkApplications(stateDb2, notePath, entities) {
       const matchedTerm = typeof item === "string" ? null : item.matchedTerm ?? null;
       const row = lookupCanonical.get(entityName);
       const canonicalName = row?.name ?? entityName;
-      upsert.run(canonicalName, notePath, matchedTerm, matchedTerm);
+      upsert.run(canonicalName, notePath, matchedTerm, source, matchedTerm, source);
     }
   });
   transaction();
@@ -4718,7 +4719,7 @@ async function applyProactiveSuggestions(filePath, vaultPath2, suggestions, conf
     return { applied: [], skipped: candidates.map((c) => c.entity) };
   }
   if (stateDb2) {
-    trackWikilinkApplications(stateDb2, filePath, result.linkedEntities);
+    trackWikilinkApplications(stateDb2, filePath, result.linkedEntities, "proactive");
     try {
       const markApplied = stateDb2.db.prepare(
         `UPDATE suggestion_events SET applied = 1
@@ -5001,7 +5002,7 @@ async function drainProactiveQueue(stateDb2, vaultPath2, config, applyFn) {
   todayMidnight.setHours(0, 0, 0, 0);
   const todayStr = todayMidnight.toISOString().slice(0, 10);
   const countTodayApplied = stateDb2.db.prepare(
-    `SELECT COUNT(*) as cnt FROM wikilink_applications WHERE note_path = ? AND applied_at >= ?`
+    `SELECT COUNT(*) as cnt FROM wikilink_applications WHERE note_path = ? AND applied_at >= ? AND source = 'proactive'`
   );
   for (const [filePath, suggestions] of byFile) {
     const fullPath = path12.join(vaultPath2, filePath);
@@ -10013,7 +10014,7 @@ var PipelineRunner = class {
           }
         }
         if (newlyTracked.length > 0) {
-          trackWikilinkApplications(p.sd, diff.file, newlyTracked);
+          trackWikilinkApplications(p.sd, diff.file, newlyTracked, "manual_detected");
         }
       }
     }
@@ -15402,6 +15403,55 @@ function getActivitySummary(index, days) {
 import { SCHEMA_VERSION } from "@velvetmonkey/vault-core";
 init_embeddings();
 init_serverLog();
+
+// src/core/shared/proactiveLinkingStats.ts
+function toSqliteTimestamp(date) {
+  return date.toISOString().replace("T", " ").replace(/\.\d{3}Z$/, "");
+}
+function getProactiveLinkingSummary(stateDb2, daysBack = 1) {
+  const now = /* @__PURE__ */ new Date();
+  const since = new Date(now.getTime() - daysBack * 24 * 60 * 60 * 1e3);
+  const sinceStr = toSqliteTimestamp(since);
+  const untilStr = toSqliteTimestamp(now);
+  const survived = stateDb2.db.prepare(
+    `SELECT COUNT(*) as cnt FROM wikilink_applications
+     WHERE source = 'proactive' AND applied_at >= ? AND status = 'applied'`
+  ).get(sinceStr);
+  const removed = stateDb2.db.prepare(
+    `SELECT COUNT(*) as cnt FROM wikilink_applications
+     WHERE source = 'proactive' AND applied_at >= ? AND status = 'removed'`
+  ).get(sinceStr);
+  const files = stateDb2.db.prepare(
+    `SELECT COUNT(DISTINCT note_path) as cnt FROM wikilink_applications
+     WHERE source = 'proactive' AND applied_at >= ?`
+  ).get(sinceStr);
+  const recent = stateDb2.db.prepare(
+    `SELECT entity, note_path, applied_at, status FROM wikilink_applications
+     WHERE source = 'proactive' AND applied_at >= ?
+     ORDER BY applied_at DESC LIMIT 10`
+  ).all(sinceStr);
+  const totalApplied = survived.cnt + removed.cnt;
+  const survivalRate = totalApplied > 0 ? survived.cnt / totalApplied : null;
+  return {
+    window: { kind: "rolling_24h", since: sinceStr, until: untilStr },
+    total_applied: totalApplied,
+    survived: survived.cnt,
+    removed: removed.cnt,
+    files_touched: files.cnt,
+    survival_rate: survivalRate,
+    recent
+  };
+}
+function getProactiveLinkingOneLiner(stateDb2, daysBack = 1) {
+  const summary = getProactiveLinkingSummary(stateDb2, daysBack);
+  if (summary.total_applied === 0) return null;
+  const linkWord = summary.total_applied === 1 ? "link" : "links";
+  const noteWord = summary.files_touched === 1 ? "note" : "notes";
+  const rate = summary.survival_rate !== null ? `${Math.round(summary.survival_rate * 100)}%` : "n/a";
+  return `${summary.total_applied} ${linkWord} applied across ${summary.files_touched} ${noteWord} (${summary.survived} survived, ${rate} rate)`;
+}
+
+// src/tools/read/health.ts
 init_wikilinkFeedback();
 init_embeddings();
 var STALE_THRESHOLD_SECONDS = 300;
@@ -15527,6 +15577,15 @@ function registerHealthTools(server2, getIndex, getVaultPath, getConfig2 = () =>
         unlinked_mentions: z5.number()
       })).describe("Entities with the most unlinked plain-text mentions")
     }).optional().describe("Background sweep results (graph hygiene metrics, updated every 5 min)"),
+    proactive_linking: z5.object({
+      enabled: z5.boolean().describe("Whether proactive linking is enabled in config"),
+      queue_pending: z5.number().describe("Number of queued proactive suggestions awaiting drain"),
+      summary: z5.string().nullable().describe('One-liner: "12 links applied across 8 notes (11 survived, 92% rate)"'),
+      total_applied_24h: z5.number().describe("Total proactive applications in last 24h"),
+      survived_24h: z5.number().describe("Proactive links still present"),
+      removed_24h: z5.number().describe("Proactive links removed by user"),
+      files_24h: z5.number().describe("Distinct files touched by proactive linking")
+    }).optional().describe("Proactive linking observability (full mode only)"),
     recommendations: z5.array(z5.string()).describe("Suggested actions if any issues detected")
   };
   server2.registerTool(
@@ -15779,6 +15838,24 @@ function registerHealthTools(server2, getIndex, getVaultPath, getConfig2 = () =>
         dead_link_count: isFull ? deadLinkCount : void 0,
         top_dead_link_targets: isFull ? topDeadLinkTargets : void 0,
         sweep: isFull ? getSweepResults() ?? void 0 : void 0,
+        proactive_linking: isFull && stateDb2 ? (() => {
+          const config = getConfig2();
+          const enabled = config.proactive_linking !== false;
+          const queuePending = stateDb2.db.prepare(
+            `SELECT COUNT(*) as cnt FROM proactive_queue WHERE status = 'pending'`
+          ).get();
+          const summary = getProactiveLinkingSummary(stateDb2, 1);
+          const oneLiner = getProactiveLinkingOneLiner(stateDb2, 1);
+          return {
+            enabled,
+            queue_pending: queuePending.cnt,
+            summary: oneLiner,
+            total_applied_24h: summary.total_applied,
+            survived_24h: summary.survived,
+            removed_24h: summary.removed,
+            files_24h: summary.files_touched
+          };
+        })() : void 0,
         recommendations
       };
       return {
@@ -16085,10 +16162,17 @@ function registerHealthTools(server2, getIndex, getVaultPath, getConfig2 = () =>
           checks.push({ name: "embedding_coverage", status: "ok", detail: `${embCount}/${noteCount} notes embedded (${coverage}%), model: ${getActiveModelId() || "default"}` });
         }
         const entityEmbCount = getEntityEmbeddingsCount();
-        const entityCount = indexBuilt ? index.entities.size : 0;
+        const entityCount = (() => {
+          if (!stateDb2) return 0;
+          try {
+            return stateDb2.db.prepare("SELECT COUNT(*) as cnt FROM entities").get()?.cnt ?? 0;
+          } catch {
+            return 0;
+          }
+        })();
         if (entityCount > 0) {
           const entityCoverage = Math.round(entityEmbCount / entityCount * 100);
-          checks.push({ name: "entity_embedding_coverage", status: entityCoverage < 50 ? "warning" : "ok", detail: `${entityEmbCount}/${entityCount} entities embedded (${entityCoverage}%)` });
+          checks.push({ name: "entity_embedding_coverage", status: entityCoverage < 50 ? "warning" : "ok", detail: `${entityEmbCount}/${entityCount} canonical entities embedded (${entityCoverage}%)` });
         }
       } else if (!embReady) {
         checks.push({ name: "embedding_coverage", status: "warning", detail: "Semantic embeddings not built", fix: "Run init_semantic to enable hybrid search" });
@@ -24021,6 +24105,24 @@ function buildVaultPulseSection(stateDb2) {
     estimated_tokens: estimateTokens2(content)
   };
 }
+function buildProactiveLinkingSection(stateDb2) {
+  const summary = getProactiveLinkingSummary(stateDb2, 1);
+  if (summary.total_applied === 0) return null;
+  const content = {
+    summary: `${summary.total_applied} ${summary.total_applied === 1 ? "link" : "links"} applied across ${summary.files_touched} ${summary.files_touched === 1 ? "note" : "notes"} (${summary.survived} survived, ${summary.survival_rate !== null ? Math.round(summary.survival_rate * 100) + "%" : "n/a"} rate)`,
+    total_applied_24h: summary.total_applied,
+    survived_24h: summary.survived,
+    removed_24h: summary.removed,
+    files_24h: summary.files_touched,
+    recent: summary.recent
+  };
+  return {
+    name: "proactive_linking",
+    priority: 6,
+    content,
+    estimated_tokens: estimateTokens2(content)
+  };
+}
 function registerBriefTools(server2, getStateDb4) {
   server2.tool(
     "brief",
@@ -24042,8 +24144,9 @@ function registerBriefTools(server2, getStateDb4) {
         buildActiveEntitiesSection(stateDb2, 10),
         buildActiveMemoriesSection(stateDb2, 20),
         buildCorrectionsSection(stateDb2, 10),
-        buildVaultPulseSection(stateDb2)
-      ];
+        buildVaultPulseSection(stateDb2),
+        buildProactiveLinkingSection(stateDb2)
+      ].filter((s) => s !== null);
       if (args.max_tokens) {
         let totalTokens2 = 0;
         sections.sort((a, b) => a.priority - b.priority);
@@ -24441,7 +24544,7 @@ async function executeEnrich(stateDb2, vaultPath2, dryRun, batchSize, offset) {
       await fs33.writeFile(fullPath, result.content, "utf-8");
       notesModified++;
       if (stateDb2) {
-        trackWikilinkApplications(stateDb2, relativePath, entities);
+        trackWikilinkApplications(stateDb2, relativePath, entities, "enrichment");
         const newLinks = extractLinkedEntities(result.content);
         updateStoredNoteLinks(stateDb2, relativePath, newLinks);
       }
@@ -24595,7 +24698,7 @@ function registerActivityTools(server2, getStateDb4, getSessionId2) {
       title: "Vault Activity",
       description: "Use when checking what tools have been used and what notes have been accessed. Produces tool invocation records with session context and note paths. Returns activity entries filtered by tool name, session, or time range. Does not modify tracking data \u2014 read-only activity log.",
       inputSchema: {
-        mode: z31.enum(["session", "sessions", "note_access", "tool_usage"]).describe("Activity query mode"),
+        mode: z31.enum(["session", "sessions", "note_access", "tool_usage", "proactive_linking"]).describe("Activity query mode"),
         session_id: z31.string().optional().describe("Specific session ID (for session mode, defaults to current)"),
         days_back: z31.number().optional().describe("Number of days to look back (default: 30)"),
         limit: z31.number().optional().describe("Maximum results to return (default: 20)")
@@ -24659,6 +24762,24 @@ function registerActivityTools(server2, getStateDb4, getSessionId2) {
             }, null, 2) }]
           };
         }
+        case "proactive_linking": {
+          const since = new Date(Date.now() - daysBack * 24 * 60 * 60 * 1e3);
+          const sinceStr = since.toISOString().replace("T", " ").replace(/\.\d{3}Z$/, "");
+          const rows = stateDb2.db.prepare(
+            `SELECT entity, note_path, applied_at, status, matched_term
+             FROM wikilink_applications
+             WHERE source = 'proactive' AND applied_at >= ?
+             ORDER BY applied_at DESC LIMIT ?`
+          ).all(sinceStr, limit);
+          return {
+            content: [{ type: "text", text: JSON.stringify({
+              mode: "proactive_linking",
+              days_back: daysBack,
+              count: rows.length,
+              applications: rows
+            }, null, 2) }]
+          };
+        }
       }
     }
   );
@@ -26171,6 +26292,25 @@ function getLearningReport(stateDb2, entityCount, linkCount, daysBack = 7, compa
     funnel: queryFunnel(stateDb2, bounds.start, bounds.end, bounds.startMs, bounds.endMs),
     graph: { link_count: linkCount, entity_count: entityCount }
   };
+  const sourceRows = stateDb2.db.prepare(`
+    SELECT source,
+      COUNT(*) as total_applied,
+      SUM(CASE WHEN status = 'applied' THEN 1 ELSE 0 END) as survived,
+      SUM(CASE WHEN status = 'removed' THEN 1 ELSE 0 END) as removed
+    FROM wikilink_applications
+    WHERE applied_at >= ? AND applied_at <= ?
+    GROUP BY source
+    ORDER BY total_applied DESC
+  `).all(bounds.start, bounds.end);
+  if (sourceRows.length > 0) {
+    report.source_breakdown = sourceRows.map((r) => ({
+      source: r.source,
+      total_applied: r.total_applied,
+      survived: r.survived,
+      removed: r.removed,
+      survival_rate: r.total_applied > 0 ? r.survived / r.total_applied : null
+    }));
+  }
   const toolSelection = getToolSelectionReport(stateDb2, daysBack);
   if (toolSelection) {
     report.tool_selection = toolSelection;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velvetmonkey/flywheel-memory",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "MCP tools that search, write, and auto-link your Obsidian vault — and learn from your edits.",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,7 @@
   "dependencies": {
     "@huggingface/transformers": "^3.8.1",
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@velvetmonkey/vault-core": "^2.4.0",
+    "@velvetmonkey/vault-core": "^2.4.2",
     "better-sqlite3": "^12.0.0",
     "chokidar": "^4.0.0",
     "gray-matter": "^4.0.3",