@velvetmonkey/vault-core 0.1.0 → 0.2.1

package/README.md

@@ -1,6 +1,44 @@
+> **Part of the Flywheel Suite:** Shared foundation for vault operations. See [Flywheel](https://github.com/velvetmonkey/flywheel) for graph intelligence and [Flywheel-Crank](https://github.com/velvetmonkey/flywheel-crank) for safe mutations.
+
 # @velvetmonkey/vault-core
 
-Shared vault utilities for the Flywheel ecosystem. Used by both [Flywheel](https://github.com/velvetmonkey/flywheel) (Obsidian plugin) and [Flywheel-Crank](https://github.com/velvetmonkey/flywheel-crank) (CLI).
+Shared vault utilities for the Flywheel ecosystem.
+
+[![npm version](https://img.shields.io/npm/v/@velvetmonkey/vault-core.svg)](https://www.npmjs.com/package/@velvetmonkey/vault-core)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
+
+---
+
+## Why This Exists
+
+Flywheel and Flywheel-Crank both need to:
+- Scan vaults for entity names (people, projects, technologies)
+- Detect protected zones (code blocks, frontmatter, existing links)
+- Apply wikilinks safely without corrupting content
+
+Rather than duplicate this logic, vault-core provides the shared foundation.
+
+```
+┌─────────────────────────────────────────┐
+│           Flywheel (read)               │
+│      44 graph intelligence tools        │
+└──────────────────┬──────────────────────┘
+                   │
+                   ▼
+┌─────────────────────────────────────────┐
+│           vault-core                    │
+│  Entity scanning · Protected zones ·    │
+│  Wikilink application                   │
+└──────────────────┬──────────────────────┘
+                   │
+                   ▼
+┌─────────────────────────────────────────┐
+│        Flywheel-Crank (write)           │
+│        11 mutation tools                │
+└─────────────────────────────────────────┘
+```
+
+---
 
 ## Installation
 
@@ -8,9 +46,12 @@ Shared vault utilities for the Flywheel ecosystem. Used by both [Flywheel](https
 npm install @velvetmonkey/vault-core
 ```
 
-## Features
+---
+
+## Modules
 
 ### Entity Scanning
+
 Scan an Obsidian vault to build an index of entities (notes) organized by category.
 
 ```typescript
@@ -21,8 +62,11 @@ const entities = getAllEntities(index);
 const nonPeriodic = filterPeriodicNotes(entities);
 ```
 
+**Detected categories:** People (`team/`, `people/`), Projects (`projects/`, `systems/`), Decisions (`decisions/`, `adr/`), and more.
+
 ### Protected Zones
-Detect regions in markdown that shouldn't be modified (frontmatter, code blocks, etc.).
+
+Detect regions in markdown that shouldn't be modified during wikilink insertion.
 
 ```typescript
 import { getProtectedZones, isInProtectedZone } from '@velvetmonkey/vault-core';
@@ -31,7 +75,15 @@ const zones = getProtectedZones(markdownContent);
 const safe = !isInProtectedZone(zones, cursorPosition);
 ```
 
+**Protected zone types:**
+- YAML frontmatter (`---` blocks)
+- Code blocks (fenced and indented)
+- Inline code (backticks)
+- Existing wikilinks (`[[...]]`)
+- URLs and markdown links
+
 ### Wikilinks
+
 Apply or suggest wikilinks to entity names in markdown content.
 
 ```typescript
@@ -41,28 +93,45 @@ const suggestions = suggestWikilinks(content, entityIndex);
 const linked = applyWikilinks(content, entityIndex, options);
 ```
 
-## API
+Wikilinks are only applied in safe zones—never inside code, frontmatter, or existing links.
+
+---
+
+## API Reference
 
 ### Types
-- `EntityIndex` - Map of category to entity names
-- `EntityCategory` - Entity category identifier
-- `ProtectedZone` - Region that shouldn't be modified
-- `ScanOptions` - Options for vault scanning
-- `WikilinkOptions` - Options for wikilink application
-- `WikilinkResult` - Result of wikilink suggestion
+
+| Type | Description |
+|------|-------------|
+| `EntityIndex` | Map of category to entity names |
+| `EntityCategory` | Entity category identifier |
+| `ProtectedZone` | Region that shouldn't be modified |
+| `ScanOptions` | Options for vault scanning |
+| `WikilinkOptions` | Options for wikilink application |
+| `WikilinkResult` | Result of wikilink suggestion |
 
 ### Functions
-- `scanVaultEntities(path, options)` - Scan vault for entities
-- `getAllEntities(index)` - Get flat list of all entities
-- `filterPeriodicNotes(entities)` - Remove daily/weekly/etc notes
-- `loadEntityCache(path)` / `saveEntityCache(path, index)` - Cache management
-- `getProtectedZones(content)` - Find protected regions
-- `isInProtectedZone(zones, position)` - Check if position is protected
-- `rangeOverlapsProtectedZone(zones, start, end)` - Check range overlap
-- `findFrontmatterEnd(content)` - Find end of YAML frontmatter
-- `applyWikilinks(content, index, options)` - Apply wikilinks to content
-- `suggestWikilinks(content, index)` - Get wikilink suggestions
-
-## License
-
-AGPL-3.0 - See [LICENSE](LICENSE) for details.
+
+| Function | Description |
+|----------|-------------|
+| `scanVaultEntities(path, options)` | Scan vault for entities |
+| `getAllEntities(index)` | Get flat list of all entities |
+| `filterPeriodicNotes(entities)` | Remove daily/weekly/etc notes |
+| `loadEntityCache(path)` / `saveEntityCache(path, index)` | Cache management |
+| `getProtectedZones(content)` | Find protected regions |
+| `isInProtectedZone(zones, position)` | Check if position is protected |
+| `rangeOverlapsProtectedZone(zones, start, end)` | Check range overlap |
+| `findFrontmatterEnd(content)` | Find end of YAML frontmatter |
+| `applyWikilinks(content, index, options)` | Apply wikilinks to content |
+| `suggestWikilinks(content, index)` | Get wikilink suggestions |
+
+---
+
+## Related Projects
+
+- [Flywheel](https://github.com/velvetmonkey/flywheel) — Read-only graph intelligence MCP server
+- [Flywheel-Crank](https://github.com/velvetmonkey/flywheel-crank) — Safe mutation MCP server
+
+---
+
+Apache-2.0 License · [GitHub](https://github.com/velvetmonkey/vault-core) · [Issues](https://github.com/velvetmonkey/vault-core/issues)

package/dist/entities.d.ts

@@ -5,15 +5,28 @@
  * that can be wikilinked. Filters out periodic notes and categorizes
  * entities by type.
  */
-import type { EntityIndex, ScanOptions } from './types.js';
+import type { EntityIndex, ScanOptions, Entity } from './types.js';
+/**
+ * Current cache version - bump when schema changes
+ */
+export declare const ENTITY_CACHE_VERSION = 2;
 /**
  * Scan vault for entities (markdown file stems) that can be wikilinked
  */
 export declare function scanVaultEntities(vaultPath: string, options?: ScanOptions): Promise<EntityIndex>;
 /**
  * Get all entities as a flat array (for wikilink matching)
+ * Handles both legacy string format and new EntityWithAliases format
+ */
+export declare function getAllEntities(index: EntityIndex): Entity[];
+/**
+ * Get entity name from an Entity (handles both string and object formats)
+ */
+export declare function getEntityName(entity: Entity): string;
+/**
+ * Get entity aliases from an Entity (returns empty array for strings)
  */
-export declare function getAllEntities(index: EntityIndex): string[];
+export declare function getEntityAliases(entity: Entity): string[];
 /**
  * Filter periodic notes from a list of entities
  * Useful when loading from external sources

package/dist/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAkB,WAAW,EAAE,MAAM,YAAY,CAAC;AA2H3E;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,WAAW,CAAC,CAmDtB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,CAQ3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEhE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAOpF;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAkB,WAAW,EAAqB,MAAM,EAAE,MAAM,YAAY,CAAC;AAEtG;;GAEG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AA2PtC;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,WAAW,CAAC,CAsEtB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,CAQ3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEhE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAOpF;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/entities.js

@@ -7,6 +7,20 @@
  */
 import fs from 'fs/promises';
 import path from 'path';
+/**
+ * Current cache version - bump when schema changes
+ */
+export const ENTITY_CACHE_VERSION = 2;
+/**
+ * Maximum entity name/alias length for suggestions
+ * Filters out article titles, clippings, and other long names
+ */
+const MAX_ENTITY_LENGTH = 25;
+/**
+ * Maximum word count for entity names/aliases
+ * Concepts are typically 1-3 words; longer names are article titles
+ */
+const MAX_ENTITY_WORDS = 3;
 /**
  * Default patterns for filtering out periodic notes and system files
  */
@@ -35,6 +49,83 @@ const DEFAULT_TECH_KEYWORDS = [
     'javascript', 'python', 'docker', 'kubernetes',
     'adf', 'adb', 'net', 'aws', 'gcp', 'terraform',
 ];
+/**
+ * Check if an alias passes the length and word count filters
+ * Uses same rules as entity names: ≤25 chars, ≤3 words
+ */
+function isValidAlias(alias) {
+    if (typeof alias !== 'string' || alias.length === 0) {
+        return false;
+    }
+    // Length filter
+    if (alias.length > MAX_ENTITY_LENGTH) {
+        return false;
+    }
+    // Word count filter
+    const words = alias.split(/\s+/).filter(w => w.length > 0);
+    if (words.length > MAX_ENTITY_WORDS) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Parse frontmatter from markdown content and extract aliases
+ * Handles YAML array format: aliases: [Alias1, Alias2]
+ * And YAML list format:
+ *   aliases:
+ *     - Alias1
+ *     - Alias2
+ */
+function extractAliasesFromContent(content) {
+    // Check for frontmatter delimiter
+    if (!content.startsWith('---')) {
+        return [];
+    }
+    // Find end of frontmatter
+    const endIndex = content.indexOf('\n---', 3);
+    if (endIndex === -1) {
+        return [];
+    }
+    const frontmatter = content.substring(4, endIndex);
+    // Try inline array format: aliases: [Alias1, Alias2]
+    const inlineMatch = frontmatter.match(/^aliases:\s*\[([^\]]*)\]/m);
+    if (inlineMatch) {
+        return inlineMatch[1]
+            .split(',')
+            .map(s => s.trim().replace(/^["']|["']$/g, '')) // Remove quotes
+            .filter(s => s.length > 0 && isValidAlias(s));
+    }
+    // Try multiline list format
+    const lines = frontmatter.split('\n');
+    const aliasIdx = lines.findIndex(line => /^aliases:\s*$/.test(line));
+    if (aliasIdx === -1) {
+        // Check for single value format: aliases: SingleAlias
+        const singleMatch = frontmatter.match(/^aliases:\s+(.+)$/m);
+        if (singleMatch && !singleMatch[1].startsWith('[')) {
+            const alias = singleMatch[1].trim().replace(/^["']|["']$/g, '');
+            return isValidAlias(alias) ? [alias] : [];
+        }
+        return [];
+    }
+    // Parse list items following "aliases:"
+    const aliases = [];
+    for (let i = aliasIdx + 1; i < lines.length; i++) {
+        const line = lines[i];
+        // Stop at next top-level key or empty line
+        if (/^[a-z_]+:/i.test(line) || line.trim() === '') {
+            break;
+        }
+        // Match list item: - Alias or - "Alias"
+        const listMatch = line.match(/^\s*-\s*["']?(.+?)["']?\s*$/);
+        if (listMatch) {
+            const alias = listMatch[1].trim();
+            if (isValidAlias(alias)) {
+                aliases.push(alias);
+            }
+        }
+    }
+    return aliases;
+}
 /**
  * Check if a file/folder name should be skipped (dot-prefixed)
  */
@@ -72,8 +163,11 @@ function categorizeEntity(name, techKeywords) {
 }
 /**
  * Recursively scan a directory for markdown files
+ * @param dirPath - Absolute path to scan
+ * @param basePath - Vault root path (for relative path calculation)
+ * @param excludeFolders - Folders to skip
  */
-async function scanDirectory(dirPath, excludeFolders) {
+async function scanDirectory(dirPath, basePath, excludeFolders) {
     const entities = [];
     try {
         const entries = await fs.readdir(dirPath, { withFileTypes: true });
@@ -89,13 +183,27 @@ async function scanDirectory(dirPath, excludeFolders) {
             }
             if (entry.isDirectory()) {
                 // Recurse into subdirectory
-                const subEntities = await scanDirectory(fullPath, excludeFolders);
+                const subEntities = await scanDirectory(fullPath, basePath, excludeFolders);
                 entities.push(...subEntities);
             }
             else if (entry.isFile() && entry.name.endsWith('.md')) {
                 // Extract file stem (without .md extension)
                 const stem = path.basename(entry.name, '.md');
-                entities.push(stem);
+                const relativePath = path.relative(basePath, fullPath);
+                // Read file content to extract aliases
+                let aliases = [];
+                try {
+                    const content = await fs.readFile(fullPath, 'utf-8');
+                    aliases = extractAliasesFromContent(content);
+                }
+                catch {
+                    // Skip if can't read file - just use empty aliases
+                }
+                entities.push({
+                    name: stem,
+                    relativePath,
+                    aliases,
+                });
             }
         }
     }
@@ -112,11 +220,18 @@ export async function scanVaultEntities(vaultPath, options = {}) {
     const excludeFolders = options.excludeFolders ?? [];
     const techKeywords = options.techKeywords ?? DEFAULT_TECH_KEYWORDS;
     // Scan vault for all markdown files
-    const allEntities = await scanDirectory(vaultPath, excludeFolders);
+    const allEntities = await scanDirectory(vaultPath, vaultPath, excludeFolders);
     // Filter out periodic notes and invalid entries
-    const validEntities = allEntities.filter(entity => entity.length >= 2 && !matchesExcludePattern(entity));
-    // Remove duplicates
-    const uniqueEntities = [...new Set(validEntities)];
+    const validEntities = allEntities.filter(entity => entity.name.length >= 2 && !matchesExcludePattern(entity.name));
+    // Remove duplicates by name (keep first occurrence)
+    const seenNames = new Set();
+    const uniqueEntities = validEntities.filter(entity => {
+        if (seenNames.has(entity.name.toLowerCase())) {
+            return false;
+        }
+        seenNames.add(entity.name.toLowerCase());
+        return true;
+    });
     // Categorize entities
     const index = {
         technologies: [],
@@ -129,18 +244,30 @@ export async function scanVaultEntities(vaultPath, options = {}) {
             generated_at: new Date().toISOString(),
             vault_path: vaultPath,
             source: 'vault-core scanVaultEntities',
+            version: ENTITY_CACHE_VERSION,
         },
     };
     for (const entity of uniqueEntities) {
-        const category = categorizeEntity(entity, techKeywords);
-        index[category].push(entity);
-    }
-    // Sort each category
-    index.technologies.sort();
-    index.acronyms.sort();
-    index.people.sort();
-    index.projects.sort();
-    index.other.sort();
+        const category = categorizeEntity(entity.name, techKeywords);
+        // Store as EntityWithAliases object
+        const entityObj = {
+            name: entity.name,
+            path: entity.relativePath,
+            aliases: entity.aliases,
+        };
+        index[category].push(entityObj);
+    }
+    // Sort each category by name
+    const sortByName = (a, b) => {
+        const nameA = typeof a === 'string' ? a : a.name;
+        const nameB = typeof b === 'string' ? b : b.name;
+        return nameA.localeCompare(nameB);
+    };
+    index.technologies.sort(sortByName);
+    index.acronyms.sort(sortByName);
+    index.people.sort(sortByName);
+    index.projects.sort(sortByName);
+    index.other.sort(sortByName);
     // Update metadata
     index._metadata.total_entities =
         index.technologies.length +
@@ -152,6 +279,7 @@ export async function scanVaultEntities(vaultPath, options = {}) {
 }
 /**
  * Get all entities as a flat array (for wikilink matching)
+ * Handles both legacy string format and new EntityWithAliases format
  */
 export function getAllEntities(index) {
     return [
@@ -162,6 +290,18 @@ export function getAllEntities(index) {
         ...index.other,
     ];
 }
+/**
+ * Get entity name from an Entity (handles both string and object formats)
+ */
+export function getEntityName(entity) {
+    return typeof entity === 'string' ? entity : entity.name;
+}
+/**
+ * Get entity aliases from an Entity (returns empty array for strings)
+ */
+export function getEntityAliases(entity) {
+    return typeof entity === 'string' ? [] : entity.aliases;
+}
 /**
  * Filter periodic notes from a list of entities
  * Useful when loading from external sources

package/dist/entities.js.map

@@ -1 +1 @@
-{"version":3,"file":"entities.js","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,8 +4,8 @@
  * Shared vault utilities for the Flywheel ecosystem.
  * Used by both Flywheel (read) and Flywheel-Crank (write).
  */
-export type { EntityIndex, EntityCategory, ProtectedZone, ProtectedZoneType, ScanOptions, WikilinkOptions, WikilinkResult, } from './types.js';
-export { scanVaultEntities, getAllEntities, filterPeriodicNotes, loadEntityCache, saveEntityCache, } from './entities.js';
+export type { EntityIndex, EntityCategory, EntityWithAliases, Entity, ProtectedZone, ProtectedZoneType, ScanOptions, WikilinkOptions, WikilinkResult, } from './types.js';
+export { scanVaultEntities, getAllEntities, getEntityName, getEntityAliases, filterPeriodicNotes, loadEntityCache, saveEntityCache, ENTITY_CACHE_VERSION, } from './entities.js';
 export { getProtectedZones, isInProtectedZone, rangeOverlapsProtectedZone, findFrontmatterEnd, } from './protectedZones.js';
 export { applyWikilinks, suggestWikilinks, } from './wikilinks.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -5,7 +5,7 @@
  * Used by both Flywheel (read) and Flywheel-Crank (write).
  */
 // Entity scanning
-export { scanVaultEntities, getAllEntities, filterPeriodicNotes, loadEntityCache, saveEntityCache, } from './entities.js';
+export { scanVaultEntities, getAllEntities, getEntityName, getEntityAliases, filterPeriodicNotes, loadEntityCache, saveEntityCache, ENTITY_CACHE_VERSION, } from './entities.js';
 // Protected zones
 export { getProtectedZones, isInProtectedZone, rangeOverlapsProtectedZone, findFrontmatterEnd, } from './protectedZones.js';
 // Wikilinks

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,YAAY;AACZ,OAAO,EACL,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,YAAY;AACZ,OAAO,EACL,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/types.d.ts

@@ -5,20 +5,38 @@
  * Categories for entity classification
  */
 export type EntityCategory = 'technologies' | 'acronyms' | 'people' | 'projects' | 'other';
+/**
+ * Entity with optional aliases from frontmatter
+ */
+export interface EntityWithAliases {
+    /** Primary entity name (file stem) */
+    name: string;
+    /** Relative path to the file within vault */
+    path: string;
+    /** Aliases from frontmatter (filtered by length/word count) */
+    aliases: string[];
+}
+/**
+ * Entity can be either a simple string (legacy) or full object with aliases
+ */
+export type Entity = string | EntityWithAliases;
 /**
  * Entity index structure matching wikilink-cache.py output
+ * Now supports both string[] (legacy) and EntityWithAliases[] (v2)
  */
 export interface EntityIndex {
-    technologies: string[];
-    acronyms: string[];
-    people: string[];
-    projects: string[];
-    other: string[];
+    technologies: Entity[];
+    acronyms: Entity[];
+    people: Entity[];
+    projects: Entity[];
+    other: Entity[];
     _metadata: {
         total_entities: number;
         generated_at: string;
         vault_path: string;
         source: string;
+        /** Cache version for migration detection */
+        version?: number;
     };
 }
 /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,UAAU,GACV,QAAQ,GACR,UAAU,GACV,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE;QACT,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,YAAY,GACZ,aAAa,GACb,UAAU,GACV,eAAe,GACf,KAAK,GACL,SAAS,GACT,UAAU,GACV,kBAAkB,GAClB,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,UAAU,GACV,QAAQ,GACR,UAAU,GACV,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE;QACT,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,4CAA4C;QAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,YAAY,GACZ,aAAa,GACb,UAAU,GACV,eAAe,GACf,KAAK,GACL,SAAS,GACT,UAAU,GACV,kBAAkB,GAClB,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/wikilinks.d.ts

@@ -4,21 +4,21 @@
  * Applies [[wikilinks]] to known entities in content while
  * respecting protected zones (code, frontmatter, existing links, etc.)
  */
-import type { WikilinkOptions, WikilinkResult } from './types.js';
+import type { WikilinkOptions, WikilinkResult, Entity } from './types.js';
 /**
  * Apply wikilinks to entities in content
  *
  * @param content - The markdown content to process
- * @param entities - List of entity names to look for
+ * @param entities - List of entity names or Entity objects to look for
  * @param options - Wikilink options
  * @returns Result with updated content and statistics
  */
-export declare function applyWikilinks(content: string, entities: string[], options?: WikilinkOptions): WikilinkResult;
+export declare function applyWikilinks(content: string, entities: Entity[], options?: WikilinkOptions): WikilinkResult;
 /**
  * Suggest wikilinks without applying them
  * Returns a list of potential links with their positions
  */
-export declare function suggestWikilinks(content: string, entities: string[], options?: WikilinkOptions): Array<{
+export declare function suggestWikilinks(content: string, entities: Entity[], options?: WikilinkOptions): Array<{
     entity: string;
     start: number;
     end: number;

package/dist/wikilinks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wikilinks.d.ts","sourceRoot":"","sources":["../src/wikilinks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuDlE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,eAAoB,GAC5B,cAAc,CA8EhB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,eAAoB,GAC5B,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA2DxE"}
+{"version":3,"file":"wikilinks.d.ts","sourceRoot":"","sources":["../src/wikilinks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAmF1E;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,eAAoB,GAC5B,cAAc,CAgNhB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,eAAoB,GAC5B,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA4DxE"}