@velvetmonkey/flywheel-memory 2.4.1 → 2.4.3

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);
@@ -8391,6 +8392,155 @@ function createStepTracker() {
     }
   };
 }
+function compactStep(step) {
+  const out = step.output ?? {};
+  let summary;
+  switch (step.name) {
+    case "entity_scan":
+      summary = {
+        entity_count: asNum(out.entity_count),
+        added_count: asArrayLen(out.added),
+        removed_count: asArrayLen(out.removed),
+        alias_change_count: asArrayLen(out.alias_changes),
+        category_change_count: asArrayLen(out.category_changes)
+      };
+      break;
+    case "hub_scores":
+      summary = {
+        updated: asNum(out.updated),
+        diff_count: asArrayLen(out.diffs)
+      };
+      break;
+    case "forward_links":
+      summary = {
+        total_resolved: asNum(out.total_resolved),
+        total_dead: asNum(out.total_dead),
+        new_dead_count: asArrayLen(out.new_dead_links),
+        diff_count: asArrayLen(out.link_diffs)
+      };
+      break;
+    case "wikilink_check":
+      summary = {
+        tracked_count: asArrayLen(out.tracked),
+        mention_count: asArrayLen(out.mentions)
+      };
+      break;
+    case "prospect_scan": {
+      const prospects = Array.isArray(out.prospects) ? out.prospects : [];
+      summary = {
+        implicit_count: prospects.reduce((s, p) => s + (Array.isArray(p.implicit) ? p.implicit.length : 0), 0),
+        dead_match_count: prospects.reduce((s, p) => s + (Array.isArray(p.deadLinkMatches) ? p.deadLinkMatches.length : 0), 0)
+      };
+      break;
+    }
+    case "suggestion_scoring":
+      summary = { scored_files: asNum(out.scored_files) };
+      break;
+    case "implicit_feedback":
+      summary = {
+        removal_count: asArrayLen(out.removals),
+        addition_count: asArrayLen(out.additions),
+        suppressed_count: asArrayLen(out.newly_suppressed)
+      };
+      break;
+    case "note_embeddings":
+      summary = { updated: asNum(out.updated), removed: asNum(out.removed) };
+      break;
+    case "entity_embeddings":
+      summary = { updated: asNum(out.updated) };
+      break;
+    case "fts5_incremental":
+      summary = { updated: asNum(out.updated), removed: asNum(out.removed) };
+      break;
+    case "index_rebuild":
+      summary = {
+        note_count: asNum(out.note_count),
+        entity_count: asNum(out.entity_count),
+        tag_count: asNum(out.tag_count)
+      };
+      break;
+    case "index_cache":
+      summary = { saved: asBool(out.saved) };
+      break;
+    case "task_cache":
+      summary = { updated: asNum(out.updated), removed: asNum(out.removed) };
+      break;
+    case "tag_scan":
+      summary = { added_count: asNum(out.total_added), removed_count: asNum(out.total_removed) };
+      break;
+    case "drain_proactive_queue":
+      summary = {
+        total_applied: asNum(out.total_applied),
+        expired: asNum(out.expired),
+        skipped_mtime: asNum(out.skipped_mtime),
+        skipped_daily_cap: asNum(out.skipped_daily_cap)
+      };
+      break;
+    case "proactive_enqueue":
+      summary = { enqueued: asNum(out.enqueued), total_candidates: asNum(out.total_candidates) };
+      break;
+    case "recency":
+    case "cooccurrence":
+    case "edge_weights":
+      summary = { rebuilt: asBool(out.rebuilt) };
+      break;
+    case "incremental_recency":
+      summary = { entities_updated: asNum(out.entities_updated) };
+      break;
+    case "corrections":
+      summary = { processed: asNum(out.processed) };
+      break;
+    case "retrieval_cooccurrence":
+      summary = { pairs_inserted: asNum(out.pairs_inserted) };
+      break;
+    case "integrity_check":
+    case "maintenance":
+      summary = {
+        ...out.skipped != null ? { skipped: asBool(out.skipped) } : {},
+        ...typeof out.reason === "string" ? { reason: out.reason } : {}
+      };
+      break;
+    case "note_moves":
+      summary = { count: asNum(out.count ?? (Array.isArray(out.renames) ? out.renames.length : 0)) };
+      break;
+    default:
+      summary = {};
+      for (const [k, v] of Object.entries(out)) {
+        if (typeof v === "number" || typeof v === "boolean" || typeof v === "string") {
+          summary[k] = v;
+        }
+      }
+      break;
+  }
+  return {
+    name: step.name,
+    duration_ms: step.duration_ms,
+    ...step.skipped ? { skipped: true, skip_reason: step.skip_reason } : {},
+    summary
+  };
+}
+function compactPipelineRun(event) {
+  const paths = event.changed_paths ?? [];
+  return {
+    timestamp: event.timestamp,
+    trigger: event.trigger,
+    duration_ms: event.duration_ms,
+    files_changed: event.files_changed,
+    changed_paths_total: event.files_changed ?? paths.length,
+    changed_paths_sample: paths.slice(0, 3),
+    step_count: event.steps?.length ?? 0,
+    steps: (event.steps ?? []).map(compactStep)
+  };
+}
+function asNum(v) {
+  return typeof v === "number" ? v : 0;
+}
+function asBool(v) {
+  return typeof v === "boolean" ? v : false;
+}
+function asArrayLen(v) {
+  return Array.isArray(v) ? v.length : 0;
+}
 function recordIndexEvent(stateDb2, event) {
   stateDb2.db.prepare(
     `INSERT INTO index_events (timestamp, trigger, duration_ms, success, note_count, files_changed, changed_paths, error, steps)
@@ -10013,7 +10163,7 @@ var PipelineRunner = class {
           }
         }
         if (newlyTracked.length > 0) {
-          trackWikilinkApplications(p.sd, diff.file, newlyTracked);
+          trackWikilinkApplications(p.sd, diff.file, newlyTracked, "manual_detected");
         }
       }
     }
@@ -11406,7 +11556,7 @@ function getSessionHistory(stateDb2, sessionId) {
   }));
 }
 function getSessionDetail(stateDb2, sessionId, options = {}) {
-  const { include_children = true, limit = 200 } = options;
+  const { include_children = true, limit = 50 } = options;
   const rows = include_children ? stateDb2.db.prepare(`
         SELECT * FROM tool_invocations
         WHERE session_id = ? OR session_id LIKE ?
@@ -13329,7 +13479,8 @@ function registerQueryTools(server2, getIndex, getVaultPath, getStateDb4) {
     async ({ query, where, has_tag, has_any_tag, has_all_tags, include_children, folder, title_contains, modified_after, modified_before, sort_by, order, prefix, limit: requestedLimit, detail_count: requestedDetailCount, context_note, consumer }) => {
       requireIndex();
       const limit = Math.min(requestedLimit ?? 10, MAX_LIMIT);
-      const detailN = requestedDetailCount ?? 5;
+      const enrichN = Math.min(requestedDetailCount ?? 5, limit);
+      const expandN = Math.min(enrichN, 8);
       const index = getIndex();
       const vaultPath2 = getVaultPath();
       if (prefix && query) {
@@ -13383,7 +13534,7 @@ function registerQueryTools(server2, getIndex, getVaultPath, getStateDb4) {
         const limitedNotes = matchingNotes.slice(0, limit);
         const stateDb2 = getStateDb4();
         const notes = limitedNotes.map(
-          (note, i) => (i < detailN ? enrichResult : enrichResultLight)({ path: note.path, title: note.title }, index, stateDb2)
+          (note, i) => (i < enrichN ? enrichResult : enrichResultLight)({ path: note.path, title: note.title }, index, stateDb2)
         );
         return { content: [{ type: "text", text: JSON.stringify({
           total_matches: totalMatches,
@@ -13518,7 +13669,7 @@ function registerQueryTools(server2, getIndex, getVaultPath, getStateDb4) {
             await enhanceSnippets(results2, query, vaultPath2);
             if (consumer === "llm") {
               applySandwichOrdering(results2);
-              await expandToSections(results2, index, vaultPath2, detailN);
+              await expandToSections(results2, index, vaultPath2, expandN);
               stripInternalFields(results2);
             }
             const entitySection2 = await entitySectionPromise;
@@ -13566,7 +13717,7 @@ function registerQueryTools(server2, getIndex, getVaultPath, getStateDb4) {
           await enhanceSnippets(results2, query, vaultPath2);
           if (consumer === "llm") {
             applySandwichOrdering(results2);
-            await expandToSections(results2, index, vaultPath2, detailN);
+            await expandToSections(results2, index, vaultPath2, expandN);
             stripInternalFields(results2);
           }
           const entitySection2 = await entitySectionPromise;
@@ -13593,7 +13744,7 @@ function registerQueryTools(server2, getIndex, getVaultPath, getStateDb4) {
         await enhanceSnippets(results, query, vaultPath2);
         if (consumer === "llm") {
           applySandwichOrdering(results);
-          await expandToSections(results, index, vaultPath2, detailN);
+          await expandToSections(results, index, vaultPath2, expandN);
           stripInternalFields(results);
         }
         const entitySection = await entitySectionPromise;
@@ -14532,13 +14683,28 @@ function registerGraphExportTools(server2, getIndex, getVaultPath, getStateDb4)
       include_cooccurrence: z3.boolean().default(true).describe("Include co-occurrence edges between entities"),
       min_edge_weight: z3.number().default(0).describe("Minimum edge weight threshold (filters weighted edges)"),
       center_entity: z3.string().optional().describe("Center the export on this entity (ego network). Only includes nodes within `depth` hops."),
-      depth: z3.number().default(1).describe("Hops from center_entity to include (default 1). Ignored without center_entity.")
+      depth: z3.number().default(1).describe("Hops from center_entity to include (default 1). Ignored without center_entity."),
+      max_nodes: z3.number().default(500).describe("Maximum nodes in export when no center_entity. Pass higher for full vault exports.")
     },
-    async ({ format, include_cooccurrence, min_edge_weight, center_entity, depth }) => {
+    async ({ format, include_cooccurrence, min_edge_weight, center_entity, depth, max_nodes }) => {
       requireIndex();
       const index = getIndex();
       const stateDb2 = getStateDb4?.() ?? null;
       const data = buildGraphData(index, stateDb2, { include_cooccurrence, min_edge_weight, center_entity, depth });
+      if (!center_entity && data.nodes.length > max_nodes) {
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              error: `Graph has ${data.nodes.length} nodes and ${data.edges.length} edges, exceeding max_nodes=${max_nodes}. Use center_entity to scope, or pass a higher max_nodes.`,
+              node_count: data.nodes.length,
+              edge_count: data.edges.length,
+              max_nodes
+            })
+          }],
+          isError: true
+        };
+      }
       let output;
       if (format === "json") {
         output = JSON.stringify(data, null, 2);
@@ -15402,6 +15568,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;
@@ -15447,31 +15662,33 @@ function registerHealthTools(server2, getIndex, getVaultPath, getConfig2 = () =>
       trigger: z5.string(),
       duration_ms: z5.number(),
       files_changed: z5.number().nullable(),
-      changed_paths: z5.array(z5.string()).nullable(),
+      changed_paths_total: z5.number().describe("Total number of changed files"),
+      changed_paths_sample: z5.array(z5.string()).describe("Up to 3 sample changed paths"),
+      step_count: z5.number().describe("Number of pipeline steps"),
       steps: z5.array(z5.object({
         name: z5.string(),
         duration_ms: z5.number(),
-        input: z5.record(z5.unknown()),
-        output: z5.record(z5.unknown()),
         skipped: z5.boolean().optional(),
-        skip_reason: z5.string().optional()
-      }))
-    }).optional().describe("Most recent watcher pipeline run with per-step timing"),
+        skip_reason: z5.string().optional(),
+        summary: z5.record(z5.union([z5.number(), z5.boolean(), z5.string()]))
+      })).optional().describe("Compact step summaries (full mode only)")
+    }).optional().describe("Most recent watcher pipeline run"),
     recent_pipelines: z5.array(z5.object({
       timestamp: z5.number(),
       trigger: z5.string(),
       duration_ms: z5.number(),
       files_changed: z5.number().nullable(),
-      changed_paths: z5.array(z5.string()).nullable(),
+      changed_paths_total: z5.number(),
+      changed_paths_sample: z5.array(z5.string()),
+      step_count: z5.number(),
       steps: z5.array(z5.object({
         name: z5.string(),
         duration_ms: z5.number(),
-        input: z5.record(z5.unknown()),
-        output: z5.record(z5.unknown()),
         skipped: z5.boolean().optional(),
-        skip_reason: z5.string().optional()
+        skip_reason: z5.string().optional(),
+        summary: z5.record(z5.union([z5.number(), z5.boolean(), z5.string()]))
       }))
-    })).optional().describe("Up to 5 most recent pipeline runs with steps data"),
+    })).optional().describe("Up to 5 most recent pipeline runs with compact step summaries (full mode only)"),
     fts5_ready: z5.boolean().describe("Whether the FTS5 keyword search index is ready"),
     fts5_building: z5.boolean().describe("Whether the FTS5 keyword search index is currently building"),
     embeddings_building: z5.boolean().describe("Whether semantic embeddings are currently building"),
@@ -15527,6 +15744,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(
@@ -15659,14 +15885,13 @@ function registerHealthTools(server2, getIndex, getVaultPath, getConfig2 = () =>
         try {
           const evt = getRecentPipelineEvent(stateDb2);
           if (evt && evt.steps && evt.steps.length > 0) {
-            lastPipeline = {
-              timestamp: evt.timestamp,
-              trigger: evt.trigger,
-              duration_ms: evt.duration_ms,
-              files_changed: evt.files_changed,
-              changed_paths: evt.changed_paths,
-              steps: evt.steps
-            };
+            const compact = compactPipelineRun(evt);
+            if (isFull) {
+              lastPipeline = compact;
+            } else {
+              const { steps: _steps, ...metadataOnly } = compact;
+              lastPipeline = metadataOnly;
+            }
           }
         } catch {
         }
@@ -15674,14 +15899,7 @@ function registerHealthTools(server2, getIndex, getVaultPath, getConfig2 = () =>
           try {
             const events = getRecentIndexEvents(stateDb2, 10).filter((e) => e.steps && e.steps.length > 0).slice(0, 5);
             if (events.length > 0) {
-              recentPipelines = events.map((e) => ({
-                timestamp: e.timestamp,
-                trigger: e.trigger,
-                duration_ms: e.duration_ms,
-                files_changed: e.files_changed,
-                changed_paths: e.changed_paths,
-                steps: e.steps
-              }));
+              recentPipelines = events.map((e) => compactPipelineRun(e));
             }
           } catch {
           }
@@ -15779,6 +15997,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 {
@@ -15826,13 +16062,7 @@ function registerHealthTools(server2, getIndex, getVaultPath, getConfig2 = () =>
         if (stateDb2) {
           try {
             const events = getRecentIndexEvents(stateDb2, 10).filter((e) => e.steps && e.steps.length > 0).slice(0, 5);
-            output.recent_runs = events.map((e) => ({
-              timestamp: e.timestamp,
-              trigger: e.trigger,
-              duration_ms: e.duration_ms,
-              files_changed: e.files_changed,
-              steps: e.steps
-            }));
+            output.recent_runs = events.map((e) => compactPipelineRun(e));
           } catch {
           }
         }
@@ -17060,7 +17290,7 @@ function registerSystemTools(server2, getIndex, setIndex, getVaultPath, setConfi
       description: "Use when listing all linkable entities grouped by category. Produces the full entity index from the state database with names, aliases, hub scores, and categories. Returns an array of entity profiles. Does not search note content \u2014 only returns entity metadata from the index.",
       inputSchema: {
         category: z6.string().optional().describe('Filter to a specific category (e.g. "people", "technologies")'),
-        limit: z6.coerce.number().default(2e3).describe("Maximum entities per category")
+        limit: z6.coerce.number().default(200).describe("Maximum entities per category (default 200; pass higher for full hydration)")
       }
     },
     async ({
@@ -17215,10 +17445,11 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig2 = ()
       description: "Use after search identifies a note you need detail on. Produces heading tree, frontmatter, tags, word count, backlink and outlink counts, and optionally full section content. Returns enriched note structure with entity metadata when available. Does not search \u2014 requires an exact path from a prior search result.",
       inputSchema: {
         path: z7.string().describe("Path to the note"),
-        include_content: z7.boolean().default(true).describe("Include the text content under each top-level section. Set false to get structure only.")
+        include_content: z7.boolean().default(false).describe("Include the text content under each top-level section. Default false for structure only."),
+        max_content_chars: z7.number().default(2e4).describe("Max total chars of section content to include. Sections are truncated at paragraph boundaries.")
       }
     },
-    async ({ path: path40, include_content }) => {
+    async ({ path: path40, include_content, max_content_chars }) => {
       const index = getIndex();
       const vaultPath2 = getVaultPath();
       const result = await getNoteStructure(index, path40, vaultPath2);
@@ -17227,11 +17458,26 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig2 = ()
           content: [{ type: "text", text: JSON.stringify({ error: "Note not found", path: path40 }, null, 2) }]
         };
       }
+      let totalChars = 0;
+      let truncated = false;
       if (include_content) {
         for (const section of result.sections) {
+          if (totalChars >= max_content_chars) {
+            truncated = true;
+            break;
+          }
           const sectionResult = await getSectionContent(index, path40, section.heading.text, vaultPath2, true);
           if (sectionResult) {
-            section.content = sectionResult.content;
+            let content = sectionResult.content;
+            const remaining = max_content_chars - totalChars;
+            if (content.length > remaining) {
+              const sliced = content.slice(0, remaining);
+              const lastBreak = sliced.lastIndexOf("\n\n");
+              content = lastBreak > 0 ? sliced.slice(0, lastBreak) : sliced;
+              truncated = true;
+            }
+            section.content = content;
+            totalChars += content.length;
           }
         }
       }
@@ -17258,6 +17504,10 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig2 = ()
         } catch {
         }
       }
+      if (include_content) {
+        enriched.truncated = truncated;
+        enriched.returned_chars = totalChars;
+      }
       return {
         content: [{ type: "text", text: JSON.stringify(enriched, null, 2) }]
       };
@@ -17271,10 +17521,11 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig2 = ()
       inputSchema: {
         path: z7.string().describe("Path to the note"),
         heading: z7.string().describe("Heading text to find"),
-        include_subheadings: z7.boolean().default(true).describe("Include content under subheadings")
+        include_subheadings: z7.boolean().default(true).describe("Include content under subheadings"),
+        max_content_chars: z7.number().default(1e4).describe("Max chars of section content. Truncated at paragraph boundaries.")
       }
     },
-    async ({ path: path40, heading, include_subheadings }) => {
+    async ({ path: path40, heading, include_subheadings, max_content_chars }) => {
       const index = getIndex();
       const vaultPath2 = getVaultPath();
       const result = await getSectionContent(index, path40, heading, vaultPath2, include_subheadings);
@@ -17287,8 +17538,15 @@ function registerPrimitiveTools(server2, getIndex, getVaultPath, getConfig2 = ()
           }, null, 2) }]
         };
       }
+      let truncated = false;
+      if (result.content.length > max_content_chars) {
+        const sliced = result.content.slice(0, max_content_chars);
+        const lastBreak = sliced.lastIndexOf("\n\n");
+        result.content = lastBreak > 0 ? sliced.slice(0, lastBreak) : sliced;
+        truncated = true;
+      }
       return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify({ ...result, truncated }, null, 2) }]
       };
     }
   );
@@ -24028,6 +24286,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",
@@ -24049,23 +24325,33 @@ 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);
+        const kept = [];
         for (const section of sections) {
-          totalTokens2 += section.estimated_tokens;
-          if (totalTokens2 > args.max_tokens) {
-            if (Array.isArray(section.content)) {
-              const remaining = Math.max(0, args.max_tokens - (totalTokens2 - section.estimated_tokens));
-              const itemTokens = section.estimated_tokens / Math.max(1, section.content.length);
-              const keepCount = Math.max(1, Math.floor(remaining / itemTokens));
-              section.content = section.content.slice(0, keepCount);
-              section.estimated_tokens = estimateTokens2(section.content);
-            }
+          if (totalTokens2 >= args.max_tokens) {
+            break;
+          }
+          if (totalTokens2 + section.estimated_tokens <= args.max_tokens) {
+            totalTokens2 += section.estimated_tokens;
+            kept.push(section);
+          } else if (Array.isArray(section.content)) {
+            const remaining = args.max_tokens - totalTokens2;
+            const itemTokens = section.estimated_tokens / Math.max(1, section.content.length);
+            const keepCount = Math.max(1, Math.floor(remaining / itemTokens));
+            section.content = section.content.slice(0, keepCount);
+            section.estimated_tokens = estimateTokens2(section.content);
+            totalTokens2 += section.estimated_tokens;
+            kept.push(section);
+            break;
           }
         }
+        sections.length = 0;
+        sections.push(...kept);
       }
       const response = {};
       let totalTokens = 0;
@@ -24448,7 +24734,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);
       }
@@ -24576,7 +24862,32 @@ function registerMetricsTools(server2, getIndex, getStateDb4) {
           const recentEvents = getRecentIndexEvents(stateDb2, eventLimit ?? 20);
           result = {
             mode: "index_activity",
-            index_activity: { summary, recent_events: recentEvents }
+            index_activity: {
+              summary,
+              recent_events: recentEvents.map((e) => {
+                const base = {
+                  id: e.id,
+                  timestamp: e.timestamp,
+                  trigger: e.trigger,
+                  duration_ms: e.duration_ms,
+                  success: e.success,
+                  note_count: e.note_count,
+                  files_changed: e.files_changed,
+                  error: e.error
+                };
+                if (e.steps) {
+                  const compact = compactPipelineRun(e);
+                  return {
+                    ...base,
+                    changed_paths_total: compact.changed_paths_total,
+                    changed_paths_sample: compact.changed_paths_sample,
+                    step_count: compact.step_count,
+                    steps: compact.steps
+                  };
+                }
+                return base;
+              })
+            }
           };
           break;
         }
@@ -24602,7 +24913,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)")
@@ -24666,6 +24977,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) }]
+          };
+        }
       }
     }
   );
@@ -25816,7 +26145,7 @@ function registerSessionHistoryTools(server2, getStateDb4) {
     {
       session_id: z36.string().optional().describe("Session ID for detail view. Omit for recent sessions list."),
       include_children: z36.boolean().optional().describe("Include child sessions (default: true)"),
-      limit: z36.number().min(1).max(500).optional().describe("Max invocations to return in detail view (default: 200)")
+      limit: z36.number().min(1).max(500).optional().describe("Max invocations to return in detail view (default: 50)")
     },
     async (args) => {
       const stateDb2 = getStateDb4();
@@ -26178,6 +26507,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.1",
+  "version": "2.4.3",
   "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.1",
+    "@velvetmonkey/vault-core": "^2.4.3",
     "better-sqlite3": "^12.0.0",
     "chokidar": "^4.0.0",
     "gray-matter": "^4.0.3",