clawvault 3.1.0 → 3.2.1

package/dist/inject-Bzi5E-By.d.cts

@@ -1,137 +0,0 @@
-import { Command } from 'commander';
-
-declare const MEMORY_GRAPH_SCHEMA_VERSION = 1;
-type NodeCategory = 'note' | 'daily' | 'observation' | 'handoff' | 'decision' | 'lesson' | 'project' | 'person' | 'commitment' | 'tag' | 'unresolved';
-type MemoryGraphNodeType = NodeCategory;
-type MemoryGraphEdgeType = 'wiki_link' | 'tag' | 'frontmatter_relation';
-interface MemoryGraphNode {
-    id: string;
-    title: string;
-    type: MemoryGraphNodeType;
-    category: string;
-    path: string | null;
-    tags: string[];
-    missing: boolean;
-    degree: number;
-    modifiedAt: string | null;
-}
-interface MemoryGraphEdge {
-    id: string;
-    source: string;
-    target: string;
-    type: MemoryGraphEdgeType;
-    label?: string;
-}
-interface MemoryGraphStats {
-    generatedAt: string;
-    nodeCount: number;
-    edgeCount: number;
-    nodeTypeCounts: Record<string, number>;
-    edgeTypeCounts: Record<string, number>;
-}
-interface MemoryGraph {
-    schemaVersion: number;
-    nodes: MemoryGraphNode[];
-    edges: MemoryGraphEdge[];
-    stats: MemoryGraphStats;
-}
-interface MemoryGraphFileFragment {
-    relativePath: string;
-    mtimeMs: number;
-    nodes: MemoryGraphNode[];
-    edges: MemoryGraphEdge[];
-}
-interface MemoryGraphIndex {
-    schemaVersion: number;
-    vaultPath: string;
-    generatedAt: string;
-    files: Record<string, MemoryGraphFileFragment>;
-    graph: MemoryGraph;
-}
-interface BuildGraphIndexOptions {
-    forceFull?: boolean;
-}
-declare function loadMemoryGraphIndex(vaultPath: string): MemoryGraphIndex | null;
-declare function buildOrUpdateMemoryGraphIndex(vaultPathInput: string, options?: BuildGraphIndexOptions): Promise<MemoryGraphIndex>;
-declare function getMemoryGraph(vaultPath: string, options?: {
-    refresh?: boolean;
-}): Promise<MemoryGraph>;
-
-type LlmProvider = 'anthropic' | 'openai' | 'gemini';
-interface LlmCompletionOptions {
-    prompt: string;
-    provider?: LlmProvider | null;
-    model?: string;
-    systemPrompt?: string;
-    temperature?: number;
-    maxTokens?: number;
-    fetchImpl?: typeof fetch;
-}
-declare function resolveLlmProvider(fetchImpl?: typeof fetch): Promise<LlmProvider | null>;
-declare function requestLlmCompletion(options: LlmCompletionOptions): Promise<string>;
-
-declare const INJECTABLE_CATEGORIES: readonly ["rules", "decisions", "preferences"];
-type InjectSourceCategory = (typeof INJECTABLE_CATEGORIES)[number];
-type InjectMatchSource = 'trigger' | 'keyword' | 'entity' | 'graph_1hop' | 'llm_intent';
-interface InjectableItem {
-    id: string;
-    category: InjectSourceCategory;
-    relativePath: string;
-    title: string;
-    content: string;
-    triggers: string[];
-    scope: string[];
-    priority: number;
-    searchKeywords: string[];
-    noteNodeId: string;
-}
-interface InjectMatchReason {
-    source: InjectMatchSource;
-    value: string;
-    weight: number;
-}
-interface InjectMatch {
-    item: InjectableItem;
-    score: number;
-    deterministicScore: number;
-    llmScore: number | null;
-    reasons: InjectMatchReason[];
-}
-interface InjectResult {
-    message: string;
-    generatedAt: string;
-    deterministicMs: number;
-    llmProvider: LlmProvider | null;
-    usedLlm: boolean;
-    matches: InjectMatch[];
-}
-interface InjectRuntimeOptions {
-    maxResults?: number;
-    useLlm?: boolean;
-    scope?: string | string[];
-    model?: string;
-    fetchImpl?: typeof fetch;
-}
-declare function indexInjectableItems(vaultPathInput: string): InjectableItem[];
-declare function deterministicInjectMatches(params: {
-    message: string;
-    items: InjectableItem[];
-    graph: MemoryGraph;
-    scope?: string | string[];
-}): InjectMatch[];
-declare function runPromptInjection(vaultPathInput: string, message: string, options?: InjectRuntimeOptions): Promise<InjectResult>;
-
-type InjectFormat = 'markdown' | 'json';
-interface InjectCommandOptions {
-    vaultPath: string;
-    maxResults?: number;
-    useLlm?: boolean;
-    scope?: string | string[];
-    format?: InjectFormat;
-    model?: string;
-}
-declare function buildInjectionResult(message: string, options: InjectCommandOptions): Promise<InjectResult>;
-declare function injectCommand(message: string, options: InjectCommandOptions): Promise<void>;
-declare function registerInjectCommand(program: Command): void;
-
-export { runPromptInjection as A, type InjectCommandOptions as I, type LlmCompletionOptions as L, MEMORY_GRAPH_SCHEMA_VERSION as M, type InjectFormat as a, type InjectMatch as b, type InjectMatchReason as c, type InjectMatchSource as d, type InjectResult as e, type InjectRuntimeOptions as f, type InjectSourceCategory as g, type InjectableItem as h, type LlmProvider as i, type MemoryGraph as j, type MemoryGraphEdge as k, type MemoryGraphEdgeType as l, type MemoryGraphIndex as m, type MemoryGraphNode as n, type MemoryGraphNodeType as o, type MemoryGraphStats as p, buildInjectionResult as q, buildOrUpdateMemoryGraphIndex as r, deterministicInjectMatches as s, getMemoryGraph as t, indexInjectableItems as u, injectCommand as v, loadMemoryGraphIndex as w, registerInjectCommand as x, requestLlmCompletion as y, resolveLlmProvider as z };

package/dist/lib/auto-linker.cjs

@@ -1,176 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/lib/auto-linker.ts
-var auto_linker_exports = {};
-__export(auto_linker_exports, {
-  autoLink: () => autoLink,
-  dryRunLink: () => dryRunLink,
-  findUnlinkedMentions: () => findUnlinkedMentions
-});
-module.exports = __toCommonJS(auto_linker_exports);
-
-// src/lib/entity-index.ts
-var import_gray_matter = __toESM(require("gray-matter"), 1);
-function getSortedAliases(index) {
-  const result = [];
-  for (const [alias, path] of index.entries) {
-    result.push({ alias, path });
-  }
-  result.sort((a, b) => b.alias.length - a.alias.length);
-  return result;
-}
-
-// src/lib/auto-linker.ts
-function findProtectedRanges(content) {
-  const ranges = [];
-  const fmMatch = content.match(/^---\n[\s\S]*?\n---/);
-  if (fmMatch) {
-    ranges.push({ start: 0, end: fmMatch[0].length });
-  }
-  const codeBlockRegex = /```[\s\S]*?```|~~~[\s\S]*?~~~/g;
-  let match;
-  while ((match = codeBlockRegex.exec(content)) !== null) {
-    ranges.push({ start: match.index, end: match.index + match[0].length });
-  }
-  const inlineCodeRegex = /`[^`]+`/g;
-  while ((match = inlineCodeRegex.exec(content)) !== null) {
-    ranges.push({ start: match.index, end: match.index + match[0].length });
-  }
-  const wikiLinkRegex = /\[\[[^\]]+\]\]/g;
-  while ((match = wikiLinkRegex.exec(content)) !== null) {
-    ranges.push({ start: match.index, end: match.index + match[0].length });
-  }
-  const urlRegex = /https?:\/\/[^\s)>\]]+/g;
-  while ((match = urlRegex.exec(content)) !== null) {
-    ranges.push({ start: match.index, end: match.index + match[0].length });
-  }
-  return ranges;
-}
-function isProtected(pos, ranges) {
-  return ranges.some((r) => pos >= r.start && pos < r.end);
-}
-function createLineLookup(content) {
-  const lines = content.split("\n");
-  let charPos = 0;
-  const lineStarts = [];
-  for (const line of lines) {
-    lineStarts.push(charPos);
-    charPos += line.length + 1;
-  }
-  return (pos) => {
-    for (let i = lineStarts.length - 1; i >= 0; i--) {
-      if (pos >= lineStarts[i]) return i + 1;
-    }
-    return 1;
-  };
-}
-function autoLink(content, index) {
-  const protectedRanges = findProtectedRanges(content);
-  const sortedAliases = getSortedAliases(index);
-  const linkedEntities = /* @__PURE__ */ new Set();
-  let result = content;
-  let offset = 0;
-  for (const { alias, path } of sortedAliases) {
-    if (linkedEntities.has(path)) continue;
-    const escapedAlias = alias.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const regex = new RegExp(`\\b${escapedAlias}\\b`, "gi");
-    let match;
-    while ((match = regex.exec(content)) !== null) {
-      const originalPos = match.index;
-      const adjustedPos = originalPos + offset;
-      if (isProtected(originalPos, protectedRanges)) continue;
-      const beforeMatch = result.substring(0, adjustedPos);
-      const openBrackets = (beforeMatch.match(/\[\[/g) || []).length;
-      const closeBrackets = (beforeMatch.match(/\]\]/g) || []).length;
-      if (openBrackets > closeBrackets) continue;
-      const originalText = match[0];
-      const replacement = originalText.toLowerCase() === path.split("/").pop()?.toLowerCase() ? `[[${path}]]` : `[[${path}|${originalText}]]`;
-      result = result.substring(0, adjustedPos) + replacement + result.substring(adjustedPos + originalText.length);
-      offset += replacement.length - originalText.length;
-      linkedEntities.add(path);
-      break;
-    }
-  }
-  return result;
-}
-function dryRunLink(content, index) {
-  const protectedRanges = findProtectedRanges(content);
-  const sortedAliases = getSortedAliases(index);
-  const linkedEntities = /* @__PURE__ */ new Set();
-  const matches = [];
-  const getLineNumber = createLineLookup(content);
-  for (const { alias, path } of sortedAliases) {
-    if (linkedEntities.has(path)) continue;
-    const escapedAlias = alias.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const regex = new RegExp(`\\b${escapedAlias}\\b`, "gi");
-    let match;
-    while ((match = regex.exec(content)) !== null) {
-      if (isProtected(match.index, protectedRanges)) continue;
-      matches.push({
-        alias: match[0],
-        path,
-        line: getLineNumber(match.index)
-      });
-      linkedEntities.add(path);
-      break;
-    }
-  }
-  return matches;
-}
-function findUnlinkedMentions(content, index) {
-  const protectedRanges = findProtectedRanges(content);
-  const sortedAliases = getSortedAliases(index);
-  const matches = [];
-  const seen = /* @__PURE__ */ new Set();
-  const getLineNumber = createLineLookup(content);
-  for (const { alias, path } of sortedAliases) {
-    if (seen.has(path)) continue;
-    const escapedAlias = alias.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const regex = new RegExp(`\\b${escapedAlias}\\b`, "gi");
-    let match;
-    while ((match = regex.exec(content)) !== null) {
-      if (isProtected(match.index, protectedRanges)) continue;
-      matches.push({
-        alias: match[0],
-        path,
-        line: getLineNumber(match.index)
-      });
-      seen.add(path);
-      break;
-    }
-  }
-  return matches;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  autoLink,
-  dryRunLink,
-  findUnlinkedMentions
-});

package/dist/lib/auto-linker.d.cts

@@ -1,26 +0,0 @@
-import { EntityIndex } from './entity-index.cjs';
-
-/**
- * Auto-link entities in markdown content.
- * Only links first occurrence of each entity.
- * Skips protected ranges (frontmatter, code, existing links, URLs).
- */
-declare function autoLink(content: string, index: EntityIndex): string;
-/**
- * Show what would be linked (dry run)
- */
-declare function dryRunLink(content: string, index: EntityIndex): Array<{
-    alias: string;
-    path: string;
-    line: number;
-}>;
-/**
- * Find unlinked mentions of entities (suggested links).
- */
-declare function findUnlinkedMentions(content: string, index: EntityIndex): Array<{
-    alias: string;
-    path: string;
-    line: number;
-}>;
-
-export { autoLink, dryRunLink, findUnlinkedMentions };

package/dist/lib/config.cjs

@@ -1,78 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/lib/config.ts
-var config_exports = {};
-__export(config_exports, {
-  findNearestVaultPath: () => findNearestVaultPath,
-  getVaultPath: () => getVaultPath,
-  resolveVaultPath: () => resolveVaultPath
-});
-module.exports = __toCommonJS(config_exports);
-var fs = __toESM(require("fs"), 1);
-var path = __toESM(require("path"), 1);
-function getVaultPath() {
-  const vaultPath = process.env.CLAWVAULT_PATH;
-  if (!vaultPath) {
-    throw new Error("CLAWVAULT_PATH environment variable not set");
-  }
-  return path.resolve(vaultPath);
-}
-function findNearestVaultPath(startPath = process.cwd()) {
-  let current = path.resolve(startPath);
-  while (true) {
-    if (fs.existsSync(path.join(current, ".clawvault.json"))) {
-      return current;
-    }
-    const parent = path.dirname(current);
-    if (parent === current) {
-      return null;
-    }
-    current = parent;
-  }
-}
-function resolveVaultPath(options = {}) {
-  if (options.explicitPath) {
-    return path.resolve(options.explicitPath);
-  }
-  if (process.env.CLAWVAULT_PATH) {
-    return path.resolve(process.env.CLAWVAULT_PATH);
-  }
-  const discovered = findNearestVaultPath(options.cwd ?? process.cwd());
-  if (discovered) {
-    return discovered;
-  }
-  throw new Error("No vault path found. Set CLAWVAULT_PATH, use --vault, or run inside a vault.");
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  findNearestVaultPath,
-  getVaultPath,
-  resolveVaultPath
-});

package/dist/lib/config.d.cts

@@ -1,11 +0,0 @@
-/**
- * Get the vault path from CLAWVAULT_PATH env var or throw
- */
-declare function getVaultPath(): string;
-declare function findNearestVaultPath(startPath?: string): string | null;
-declare function resolveVaultPath(options?: {
-    explicitPath?: string;
-    cwd?: string;
-}): string;
-
-export { findNearestVaultPath, getVaultPath, resolveVaultPath };

package/dist/lib/entity-index.cjs

@@ -1,84 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/lib/entity-index.ts
-var entity_index_exports = {};
-__export(entity_index_exports, {
-  buildEntityIndex: () => buildEntityIndex,
-  getSortedAliases: () => getSortedAliases
-});
-module.exports = __toCommonJS(entity_index_exports);
-var fs = __toESM(require("fs"), 1);
-var path = __toESM(require("path"), 1);
-var import_gray_matter = __toESM(require("gray-matter"), 1);
-function buildEntityIndex(vaultPath) {
-  const entries = /* @__PURE__ */ new Map();
-  const byPath = /* @__PURE__ */ new Map();
-  const entityFolders = ["people", "projects", "agents", "lessons", "decisions", "commitments"];
-  for (const folder of entityFolders) {
-    const folderPath = path.join(vaultPath, folder);
-    if (!fs.existsSync(folderPath)) continue;
-    const files = fs.readdirSync(folderPath).filter((f) => f.endsWith(".md"));
-    for (const file of files) {
-      const filePath = path.join(folderPath, file);
-      const content = fs.readFileSync(filePath, "utf-8");
-      const { data: frontmatter } = (0, import_gray_matter.default)(content);
-      const relativePath = `${folder}/${file.replace(".md", "")}`;
-      const baseName = file.replace(".md", "");
-      const aliases = [baseName];
-      if (frontmatter.title && frontmatter.title.toLowerCase() !== baseName.toLowerCase()) {
-        aliases.push(frontmatter.title);
-      }
-      if (Array.isArray(frontmatter.aliases)) {
-        aliases.push(...frontmatter.aliases);
-      }
-      for (const alias of aliases) {
-        const key = alias.toLowerCase();
-        if (!entries.has(key)) {
-          entries.set(key, relativePath);
-        }
-      }
-      byPath.set(relativePath, { path: relativePath, aliases });
-    }
-  }
-  return { entries, byPath };
-}
-function getSortedAliases(index) {
-  const result = [];
-  for (const [alias, path2] of index.entries) {
-    result.push({ alias, path: path2 });
-  }
-  result.sort((a, b) => b.alias.length - a.alias.length);
-  return result;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildEntityIndex,
-  getSortedAliases
-});

package/dist/lib/entity-index.d.cts

@@ -1,26 +0,0 @@
-interface EntityEntry {
-    path: string;
-    aliases: string[];
-}
-interface EntityIndex {
-    entries: Map<string, string>;
-    byPath: Map<string, EntityEntry>;
-}
-/**
- * Build an entity index from all markdown files in the vault.
- * Extracts linkable names from:
- * - Filename (without .md)
- * - Frontmatter `title` field
- * - Frontmatter `aliases` array
- */
-declare function buildEntityIndex(vaultPath: string): EntityIndex;
-/**
- * Get all entities sorted by alias length (longest first)
- * This ensures "Justin Dukes" is matched before "Justin"
- */
-declare function getSortedAliases(index: EntityIndex): Array<{
-    alias: string;
-    path: string;
-}>;
-
-export { type EntityEntry, type EntityIndex, buildEntityIndex, getSortedAliases };