@velvetmonkey/flywheel-crank 0.7.3 → 0.8.0

package/dist/index.js

@@ -518,6 +518,7 @@ import path4 from "path";
 
 // src/core/stemmer.ts
 var STOPWORDS = /* @__PURE__ */ new Set([
+  // Articles, pronouns, prepositions (basic)
   "the",
   "a",
   "an",
@@ -618,11 +619,385 @@ var STOPWORDS = /* @__PURE__ */ new Set([
   "there",
   "any",
   "now",
-  "new",
   "even",
   "much",
   "back",
-  "going"
+  // Common verbs (critical for reducing false positives)
+  // These create matches like "Completed" → "Complete Guide"
+  "going",
+  "went",
+  "gone",
+  "come",
+  "came",
+  "coming",
+  "work",
+  "worked",
+  "working",
+  "works",
+  "make",
+  "made",
+  "making",
+  "makes",
+  "take",
+  "took",
+  "taken",
+  "taking",
+  "takes",
+  "give",
+  "gave",
+  "given",
+  "giving",
+  "gives",
+  "find",
+  "found",
+  "finding",
+  "finds",
+  "know",
+  "knew",
+  "known",
+  "knowing",
+  "knows",
+  "think",
+  "thought",
+  "thinking",
+  "thinks",
+  "look",
+  "looked",
+  "looking",
+  "looks",
+  "want",
+  "wanted",
+  "wanting",
+  "wants",
+  "tell",
+  "told",
+  "telling",
+  "tells",
+  "keep",
+  "kept",
+  "keeping",
+  "keeps",
+  "start",
+  "started",
+  "starting",
+  "starts",
+  "complete",
+  "completed",
+  "completing",
+  "completes",
+  "finish",
+  "finished",
+  "finishing",
+  "finishes",
+  "begin",
+  "began",
+  "begun",
+  "beginning",
+  "begins",
+  "end",
+  "ended",
+  "ending",
+  "ends",
+  "add",
+  "added",
+  "adding",
+  "adds",
+  "update",
+  "updated",
+  "updating",
+  "updates",
+  "change",
+  "changed",
+  "changing",
+  "changes",
+  "remove",
+  "removed",
+  "removing",
+  "removes",
+  "fix",
+  "fixed",
+  "fixing",
+  "fixes",
+  "create",
+  "created",
+  "creating",
+  "creates",
+  "build",
+  "built",
+  "building",
+  "builds",
+  "run",
+  "ran",
+  "running",
+  "runs",
+  "test",
+  "tested",
+  "testing",
+  "tests",
+  "release",
+  "released",
+  "releasing",
+  "releases",
+  "use",
+  "used",
+  "using",
+  "uses",
+  "get",
+  "got",
+  "gotten",
+  "getting",
+  "gets",
+  "set",
+  "setting",
+  "sets",
+  "put",
+  "putting",
+  "puts",
+  "try",
+  "tried",
+  "trying",
+  "tries",
+  "move",
+  "moved",
+  "moving",
+  "moves",
+  "show",
+  "showed",
+  "shown",
+  "showing",
+  "shows",
+  "help",
+  "helped",
+  "helping",
+  "helps",
+  "read",
+  "reading",
+  "reads",
+  "write",
+  "wrote",
+  "written",
+  "writing",
+  "writes",
+  "call",
+  "called",
+  "calling",
+  "calls",
+  "feel",
+  "felt",
+  "feeling",
+  "feels",
+  "seem",
+  "seemed",
+  "seeming",
+  "seems",
+  "turn",
+  "turned",
+  "turning",
+  "turns",
+  "leave",
+  "left",
+  "leaving",
+  "leaves",
+  "play",
+  "played",
+  "playing",
+  "plays",
+  "hold",
+  "held",
+  "holding",
+  "holds",
+  "bring",
+  "brought",
+  "bringing",
+  "brings",
+  "happen",
+  "happened",
+  "happening",
+  "happens",
+  "include",
+  "included",
+  "including",
+  "includes",
+  "continue",
+  "continued",
+  "continuing",
+  "continues",
+  "send",
+  "sent",
+  "sending",
+  "sends",
+  "receive",
+  "received",
+  "receiving",
+  "receives",
+  "follow",
+  "followed",
+  "following",
+  "follows",
+  "stop",
+  "stopped",
+  "stopping",
+  "stops",
+  "open",
+  "opened",
+  "opening",
+  "opens",
+  "close",
+  "closed",
+  "closing",
+  "closes",
+  "done",
+  "doing",
+  // Time words
+  "today",
+  "tomorrow",
+  "yesterday",
+  "daily",
+  "weekly",
+  "monthly",
+  "yearly",
+  "annually",
+  "morning",
+  "afternoon",
+  "evening",
+  "night",
+  "week",
+  "month",
+  "year",
+  "hour",
+  "minute",
+  "second",
+  "time",
+  "date",
+  "day",
+  "days",
+  "weeks",
+  "months",
+  "years",
+  "currently",
+  "recently",
+  "later",
+  "earlier",
+  "soon",
+  "always",
+  "never",
+  "sometimes",
+  "often",
+  "usually",
+  "rarely",
+  // Generic/filler words
+  "thing",
+  "things",
+  "stuff",
+  "something",
+  "anything",
+  "nothing",
+  "everything",
+  "someone",
+  "anyone",
+  "noone",
+  "everyone",
+  "somewhere",
+  "anywhere",
+  "nowhere",
+  "everywhere",
+  "good",
+  "better",
+  "best",
+  "great",
+  "nice",
+  "okay",
+  "fine",
+  "right",
+  "wrong",
+  "bad",
+  "worse",
+  "worst",
+  "lot",
+  "lots",
+  "many",
+  "several",
+  "various",
+  "different",
+  "similar",
+  "another",
+  "next",
+  "last",
+  "first",
+  "second",
+  "third",
+  "new",
+  "old",
+  "big",
+  "small",
+  "large",
+  "little",
+  "long",
+  "short",
+  "high",
+  "low",
+  "full",
+  "empty",
+  "whole",
+  "part",
+  "real",
+  "true",
+  "false",
+  "actual",
+  "main",
+  "important",
+  // Descriptive/qualifier words
+  "really",
+  "actually",
+  "basically",
+  "probably",
+  "definitely",
+  "certainly",
+  "possibly",
+  "maybe",
+  "perhaps",
+  "like",
+  "likely",
+  "unlikely",
+  "almost",
+  "nearly",
+  "quite",
+  "rather",
+  "pretty",
+  "still",
+  "already",
+  "yet",
+  "though",
+  "although",
+  "however",
+  "therefore",
+  "thus",
+  "hence",
+  "truly",
+  "simply",
+  "easily",
+  "quickly",
+  "slowly",
+  "well",
+  "just",
+  "ever",
+  "either",
+  "neither",
+  "whether",
+  "because",
+  "since",
+  "while",
+  "until",
+  "unless",
+  "except",
+  "besides",
+  "anyway",
+  "otherwise",
+  "instead",
+  "meanwhile",
+  "furthermore",
+  "moreover",
+  "nevertheless"
 ]);
 function isConsonant(word, i) {
   const c = word[i];
@@ -1152,36 +1527,88 @@ function isLikelyArticleTitle(name) {
   }
   return false;
 }
-var MIN_SUGGESTION_SCORE = 5;
-var MIN_MATCH_RATIO = 0.4;
-function scoreEntity(entityName, contentTokens, contentStems) {
+var STRICTNESS_CONFIGS = {
+  conservative: {
+    minWordLength: 5,
+    minSuggestionScore: 15,
+    // Requires exact match (10) + at least one stem (5)
+    minMatchRatio: 0.6,
+    // 60% of multi-word entity must match
+    requireMultipleMatches: true,
+    // Single-word entities need multiple content matches
+    stemMatchBonus: 3,
+    // Lower bonus for stem-only matches
+    exactMatchBonus: 10
+    // Standard bonus for exact matches
+  },
+  balanced: {
+    minWordLength: 4,
+    minSuggestionScore: 8,
+    // At least one exact match or two stem matches
+    minMatchRatio: 0.4,
+    // 40% of multi-word entity must match
+    requireMultipleMatches: false,
+    stemMatchBonus: 5,
+    // Standard bonus for stem matches
+    exactMatchBonus: 10
+    // Standard bonus for exact matches
+  },
+  aggressive: {
+    minWordLength: 4,
+    minSuggestionScore: 5,
+    // Single stem match is enough
+    minMatchRatio: 0.3,
+    // 30% of multi-word entity must match
+    requireMultipleMatches: false,
+    stemMatchBonus: 6,
+    // Higher bonus for stem matches
+    exactMatchBonus: 10
+    // Standard bonus for exact matches
+  }
+};
+var DEFAULT_STRICTNESS = "conservative";
+var MIN_SUGGESTION_SCORE = STRICTNESS_CONFIGS.balanced.minSuggestionScore;
+var MIN_MATCH_RATIO = STRICTNESS_CONFIGS.balanced.minMatchRatio;
+function scoreEntity(entityName, contentTokens, contentStems, config) {
   const entityTokens = tokenize(entityName);
   if (entityTokens.length === 0)
     return 0;
   const entityStems = entityTokens.map((t) => stem(t));
   let score = 0;
   let matchedWords = 0;
+  let exactMatches = 0;
   for (let i = 0; i < entityTokens.length; i++) {
     const token = entityTokens[i];
     const entityStem = entityStems[i];
     if (contentTokens.has(token)) {
-      score += 10;
+      score += config.exactMatchBonus;
       matchedWords++;
+      exactMatches++;
     } else if (contentStems.has(entityStem)) {
-      score += 5;
+      score += config.stemMatchBonus;
       matchedWords++;
     }
   }
   if (entityTokens.length > 1) {
     const matchRatio = matchedWords / entityTokens.length;
-    if (matchRatio < MIN_MATCH_RATIO) {
+    if (matchRatio < config.minMatchRatio) {
+      return 0;
+    }
+  }
+  if (config.requireMultipleMatches && entityTokens.length === 1) {
+    if (exactMatches === 0) {
       return 0;
     }
   }
   return score;
 }
 function suggestRelatedLinks(content, options = {}) {
-  const { maxSuggestions = 3, excludeLinked = true } = options;
+  const {
+    maxSuggestions = 3,
+    excludeLinked = true,
+    strictness = DEFAULT_STRICTNESS
+  } = options;
+  const config = STRICTNESS_CONFIGS[strictness];
   const emptyResult = { suggestions: [], suffix: "" };
   if (SUGGESTION_PATTERN.test(content)) {
     return emptyResult;
@@ -1213,11 +1640,11 @@ function suggestRelatedLinks(content, options = {}) {
     if (linkedEntities.has(entityName.toLowerCase())) {
       continue;
     }
-    const score = scoreEntity(entityName, contentTokens, contentStems);
+    const score = scoreEntity(entityName, contentTokens, contentStems, config);
     if (score > 0) {
       directlyMatchedEntities.add(entityName);
     }
-    if (score >= MIN_SUGGESTION_SCORE) {
+    if (score >= config.minSuggestionScore) {
       scoredEntities.push({ name: entityName, score });
     }
   }
@@ -1237,7 +1664,7 @@ function suggestRelatedLinks(content, options = {}) {
         const existing = scoredEntities.find((e) => e.name === entityName);
         if (existing) {
           existing.score += boost;
-        } else if (boost >= MIN_SUGGESTION_SCORE) {
+        } else if (boost >= config.minSuggestionScore) {
           scoredEntities.push({ name: entityName, score: boost });
         }
       }
@@ -1271,9 +1698,10 @@ function registerMutationTools(server2, vaultPath2) {
       commit: z.boolean().default(false).describe("If true, commit this change to git (creates undo point)"),
       skipWikilinks: z.boolean().default(false).describe("If true, skip auto-wikilink application (wikilinks are applied by default)"),
       preserveListNesting: z.boolean().default(true).describe("Detect and preserve the indentation level of surrounding list items. Set false to disable."),
-      suggestOutgoingLinks: z.boolean().default(true).describe('Append suggested outgoing wikilinks based on content (e.g., "\u2192 [[AI]] [[Philosophy]]"). Set false to disable.')
+      suggestOutgoingLinks: z.boolean().default(true).describe('Append suggested outgoing wikilinks based on content (e.g., "\u2192 [[AI]] [[Philosophy]]"). Set false to disable.'),
+      maxSuggestions: z.number().min(1).max(10).default(3).describe("Maximum number of suggested wikilinks to append (1-10, default: 3)")
     },
-    async ({ path: notePath, section, content, position, format, commit, skipWikilinks, preserveListNesting, suggestOutgoingLinks }) => {
+    async ({ path: notePath, section, content, position, format, commit, skipWikilinks, preserveListNesting, suggestOutgoingLinks, maxSuggestions }) => {
       try {
         const fullPath = path5.join(vaultPath2, notePath);
         try {
@@ -1299,7 +1727,7 @@ function registerMutationTools(server2, vaultPath2) {
         let { content: processedContent, wikilinkInfo } = maybeApplyWikilinks(content, skipWikilinks);
         let suggestInfo;
         if (suggestOutgoingLinks && !skipWikilinks) {
-          const result2 = suggestRelatedLinks(processedContent);
+          const result2 = suggestRelatedLinks(processedContent, { maxSuggestions });
           if (result2.suffix) {
             processedContent = processedContent + " " + result2.suffix;
             suggestInfo = `Suggested: ${result2.suggestions.join(", ")}`;
@@ -1437,9 +1865,10 @@ function registerMutationTools(server2, vaultPath2) {
       useRegex: z.boolean().default(false).describe("Treat search as regex"),
       commit: z.boolean().default(false).describe("If true, commit this change to git (creates undo point)"),
       skipWikilinks: z.boolean().default(false).describe("If true, skip auto-wikilink application on replacement text"),
-      suggestOutgoingLinks: z.boolean().default(true).describe('Append suggested outgoing wikilinks based on content (e.g., "\u2192 [[AI]] [[Philosophy]]"). Set false to disable.')
+      suggestOutgoingLinks: z.boolean().default(true).describe('Append suggested outgoing wikilinks based on content (e.g., "\u2192 [[AI]] [[Philosophy]]"). Set false to disable.'),
+      maxSuggestions: z.number().min(1).max(10).default(3).describe("Maximum number of suggested wikilinks to append (1-10, default: 3)")
     },
-    async ({ path: notePath, section, search, replacement, mode, useRegex, commit, skipWikilinks, suggestOutgoingLinks }) => {
+    async ({ path: notePath, section, search, replacement, mode, useRegex, commit, skipWikilinks, suggestOutgoingLinks, maxSuggestions }) => {
       try {
         const fullPath = path5.join(vaultPath2, notePath);
         try {
@@ -1465,7 +1894,7 @@ function registerMutationTools(server2, vaultPath2) {
         let { content: processedReplacement, wikilinkInfo } = maybeApplyWikilinks(replacement, skipWikilinks);
         let suggestInfo;
         if (suggestOutgoingLinks && !skipWikilinks) {
-          const result2 = suggestRelatedLinks(processedReplacement);
+          const result2 = suggestRelatedLinks(processedReplacement, { maxSuggestions });
           if (result2.suffix) {
             processedReplacement = processedReplacement + " " + result2.suffix;
             suggestInfo = `Suggested: ${result2.suggestions.join(", ")}`;
@@ -1674,9 +2103,10 @@ function registerTaskTools(server2, vaultPath2) {
       commit: z2.boolean().default(false).describe("If true, commit this change to git (creates undo point)"),
       skipWikilinks: z2.boolean().default(false).describe("If true, skip auto-wikilink application (wikilinks are applied by default)"),
       suggestOutgoingLinks: z2.boolean().default(true).describe('Append suggested outgoing wikilinks based on content (e.g., "\u2192 [[AI]] [[Philosophy]]"). Set false to disable.'),
+      maxSuggestions: z2.number().min(1).max(10).default(3).describe("Maximum number of suggested wikilinks to append (1-10, default: 3)"),
       preserveListNesting: z2.boolean().default(true).describe("Preserve indentation when inserting into nested lists. Default: true")
     },
-    async ({ path: notePath, section, task, position, completed, commit, skipWikilinks, suggestOutgoingLinks, preserveListNesting }) => {
+    async ({ path: notePath, section, task, position, completed, commit, skipWikilinks, suggestOutgoingLinks, maxSuggestions, preserveListNesting }) => {
       try {
         const fullPath = path6.join(vaultPath2, notePath);
         try {
@@ -1702,7 +2132,7 @@ function registerTaskTools(server2, vaultPath2) {
         let { content: processedTask, wikilinkInfo } = maybeApplyWikilinks(task.trim(), skipWikilinks);
         let suggestInfo;
         if (suggestOutgoingLinks && !skipWikilinks) {
-          const result2 = suggestRelatedLinks(processedTask);
+          const result2 = suggestRelatedLinks(processedTask, { maxSuggestions });
           if (result2.suffix) {
             processedTask = processedTask + " " + result2.suffix;
             suggestInfo = `Suggested: ${result2.suggestions.join(", ")}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velvetmonkey/flywheel-crank",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "description": "Deterministic vault mutations for Obsidian via MCP",
   "type": "module",
   "main": "dist/index.js",