@velvetmonkey/vault-core 2.0.98 → 2.0.99

package/dist/types.d.ts

@@ -131,9 +131,9 @@ export interface ImplicitEntityConfig {
     detectImplicit?: boolean;
     /**
      * Which patterns to use for detection
-     * @default ['proper-nouns', 'quoted-terms']
+     * @default ['proper-nouns']
      */
-    implicitPatterns?: Array<'proper-nouns' | 'quoted-terms' | 'single-caps' | 'camel-case' | 'acronyms'>;
+    implicitPatterns?: Array<'proper-nouns' | 'single-caps' | 'camel-case' | 'acronyms'>;
     /**
      * Regex patterns to exclude from implicit detection
      * @default ['^The ', '^A ', '^An ', '^This ', '^That ', '^These ', '^Those ']
@@ -165,7 +165,7 @@ export interface ImplicitEntityMatch {
     /** End position in content */
     end: number;
     /** Detection method used */
-    pattern: 'proper-nouns' | 'quoted-terms' | 'single-caps' | 'camel-case' | 'acronyms';
+    pattern: 'proper-nouns' | 'single-caps' | 'camel-case' | 'acronyms';
 }
 /**
  * Options for resolving alias-based wikilinks

package/dist/wikilinks.d.ts

@@ -5,7 +5,7 @@
  * respecting protected zones (code, frontmatter, existing links, etc.)
  *
  * Also supports:
- * - Pattern-based detection for implicit entities (proper nouns, quoted terms)
+ * - Pattern-based detection for implicit entities (proper nouns, acronyms, CamelCase)
  * - Alias resolution for existing wikilinks (resolves [[alias]] to [[Entity|alias]])
  */
 import type { WikilinkOptions, WikilinkResult, Entity, ExtendedWikilinkOptions, ImplicitEntityMatch, ImplicitEntityConfig, ResolveAliasOptions } from './types.js';
@@ -62,7 +62,7 @@ export declare const IMPLICIT_EXCLUDE_WORDS: Set<string>;
  * This finds potential entities that don't have existing files:
  * - Multi-word proper nouns (e.g., "Marcus Johnson", "Project Alpha")
  * - Single capitalized words after lowercase (e.g., "discussed with Marcus")
- * - Quoted terms (e.g., "Turbopump" becomes [[Turbopump]])
+ * - CamelCase words (e.g., TypeScript, HuggingFace)
  *
  * @param content - The markdown content to analyze
  * @param config - Configuration for detection patterns

package/dist/wikilinks.js

@@ -5,7 +5,7 @@
  * respecting protected zones (code, frontmatter, existing links, etc.)
  *
  * Also supports:
- * - Pattern-based detection for implicit entities (proper nouns, quoted terms)
+ * - Pattern-based detection for implicit entities (proper nouns, acronyms, CamelCase)
  * - Alias resolution for existing wikilinks (resolves [[alias]] to [[Entity|alias]])
  */
 import { getProtectedZones, rangeOverlapsProtectedZone } from './protectedZones.js';
@@ -44,6 +44,12 @@ const EXCLUDE_WORDS = new Set([
     // Stop words
     'the', 'and', 'for', 'with', 'from', 'this', 'that',
     'christmas', 'holiday', 'break',
+    // Common adjectives that should never be entities
+    'safe', 'new', 'old', 'local', 'native', 'first', 'related', 'similar',
+    'simple', 'basic', 'early', 'real', 'clear', 'fixed',
+    // Common verbs that should never be entities
+    'remember', 'include', 'avoid', 'provide', 'create', 'build', 'target',
+    'define', 'test', 'enable', 'handle', 'focus', 'track',
 ]);
 /**
  * Escape special regex characters in a string
@@ -55,7 +61,12 @@ function escapeRegex(str) {
  * Check if an entity should be excluded from wikilikning
  */
 function shouldExcludeEntity(entity) {
-    return EXCLUDE_WORDS.has(entity.toLowerCase());
+    if (EXCLUDE_WORDS.has(entity.toLowerCase()))
+        return true;
+    // Skip lowercase hyphenated descriptors (e.g., self-improving, local-first, Claude-native)
+    if (entity.includes('-') && entity === entity.toLowerCase())
+        return true;
+    return false;
 }
 /**
  * Find all matches of an entity in content with word boundaries
@@ -454,7 +465,7 @@ export function resolveAliasWikilinks(content, entities, options = {}) {
  */
 const DEFAULT_IMPLICIT_CONFIG = {
     detectImplicit: false,
-    implicitPatterns: ['proper-nouns', 'quoted-terms'],
+    implicitPatterns: ['proper-nouns'],
     excludePatterns: ['^The ', '^A ', '^An ', '^This ', '^That ', '^These ', '^Those '],
     minEntityLength: 3,
 };
@@ -498,12 +509,19 @@ const SENTENCE_STARTER_WORDS = new Set([
     'think', 'know', 'feel', 'seem', 'look', 'hear', 'watch', 'wait', 'work',
     'start', 'stop', 'open', 'close', 'move', 'turn', 'bring', 'send', 'leave',
     'meet', 'join', 'follow', 'include', 'consider', 'remember', 'forget',
+    // Additional common verbs/imperative starters
+    'target', 'create', 'build', 'write', 'avoid', 'provide', 'maintain',
+    'define', 'ensure', 'place', 'focus', 'track', 'enable', 'apply', 'test',
+    'handle', 'load', 'link', 'pass', 'save', 'lead', 'frame', 'point',
     // Pronouns, possessives, determiners — capitalized at sentence start but not proper nouns
     'my', 'your', 'his', 'her', 'its', 'our', 'their',
     'some', 'any', 'every', 'each', 'both', 'few', 'many', 'most',
     // Common adjectives that precede proper nouns at sentence start
     'poor', 'old', 'new', 'big', 'little', 'great', 'good', 'bad',
     'first', 'last', 'next', 'other', 'more', 'just', 'very',
+    // Additional adjectives/adverbs that appear capitalized at sentence starts
+    'still', 'clear', 'fixed', 'based', 'using', 'real', 'even',
+    'safe', 'local', 'native', 'early', 'similar', 'simple', 'basic', 'related',
 ]);
 /**
  * Detect implicit entities in content using pattern matching
@@ -511,7 +529,7 @@ const SENTENCE_STARTER_WORDS = new Set([
  * This finds potential entities that don't have existing files:
  * - Multi-word proper nouns (e.g., "Marcus Johnson", "Project Alpha")
  * - Single capitalized words after lowercase (e.g., "discussed with Marcus")
- * - Quoted terms (e.g., "Turbopump" becomes [[Turbopump]])
+ * - CamelCase words (e.g., TypeScript, HuggingFace)
  *
  * @param content - The markdown content to analyze
  * @param config - Configuration for detection patterns
@@ -598,22 +616,6 @@ export function detectImplicitEntities(content, config = {}) {
             }
         }
     }
-    // Pattern 3: Quoted terms (explicit entity markers)
-    // Matches "Turbopump" -> [[Turbopump]]
-    if (implicitPatterns.includes('quoted-terms')) {
-        const quotedRegex = /"([^"]{3,30})"/g;
-        let match;
-        while ((match = quotedRegex.exec(content)) !== null) {
-            const text = match[1];
-            // Include the quotes in the position for replacement
-            const start = match.index;
-            const end = start + match[0].length;
-            if (!shouldExclude(text) && !isProtected(start, end)) {
-                detected.push({ text, start, end, pattern: 'quoted-terms' });
-                seenTexts.add(text.toLowerCase());
-            }
-        }
-    }
     // Pattern 4: CamelCase words (TypeScript, YouTube, HuggingFace)
     if (implicitPatterns.includes('camel-case')) {
         const camelRegex = /\b([A-Z][a-z]+[A-Z][a-zA-Z]*)\b/g;
@@ -634,6 +636,10 @@ export function detectImplicitEntities(content, config = {}) {
         let match;
         while ((match = acronymRegex.exec(content)) !== null) {
             const text = match[1];
+            // Skip long ALL-CAPS words (>5 chars) — likely English words in caps, not acronyms
+            // Real acronyms are typically 2-5 chars (API, SQL, LLM, ONNX)
+            if (text.length > 5)
+                continue;
             const start = match.index;
             const end = start + text.length;
             if (!shouldExclude(text) && !isProtected(start, end)) {
@@ -739,18 +745,10 @@ export function processWikilinks(content, entities, options = {}) {
         let wikilink;
         let replaceStart;
         let replaceEnd;
-        if (match.pattern === 'quoted-terms') {
-            // Replace "Term" with [[Term]] (remove quotes)
-            wikilink = `[[${match.text}]]`;
-            replaceStart = match.start;
-            replaceEnd = match.end;
-        }
-        else {
-            // Replace Term with [[Term]]
-            wikilink = `[[${match.text}]]`;
-            replaceStart = match.start;
-            replaceEnd = match.end;
-        }
+        // Replace Term with [[Term]]
+        wikilink = `[[${match.text}]]`;
+        replaceStart = match.start;
+        replaceEnd = match.end;
         processedContent =
             processedContent.slice(0, replaceStart) +
                 wikilink +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velvetmonkey/vault-core",
-  "version": "2.0.98",
+  "version": "2.0.99",
   "description": "Shared vault utilities for Flywheel ecosystem (entity scanning, wikilinks, protected zones)",
   "type": "module",
   "main": "dist/index.js",