clawvault 3.1.0 → 3.2.1

package/dist/plugin/index.d.cts

@@ -1,36 +0,0 @@
-import { TemplateRegistry } from './templates.cjs';
-export { classifyText, getAllSchemas, getSchema, getSchemaNames, initializeTemplateRegistry } from './templates.cjs';
-export { detectCategory, extractObservations, extractSearchTerms, isObservable, processMessageForObservations } from './observe.cjs';
-export { buildFullContext, buildPreferenceContext, buildSessionRecap, formatMemoriesForContext, formatSearchResults, scanVaultFiles } from './inject.cjs';
-export { appendToLedger, batchWriteObservations, ensureVaultStructure, writeObservation, writeVaultFile } from './vault.cjs';
-
-/**
- * ClawVault OpenClaw Plugin v2.2.0
- *
- * Memory slot provider for OpenClaw. Template-driven observational memory architecture:
- * memories are captured automatically from conversations, classified against template
- * schemas, and stored with proper frontmatter validation.
- *
- * Architecture:
- *   ClawVault (engine) ←→ Plugin (integration) ←→ OpenClaw (agent platform)
- *   - ClawVault = vault, observations, search index, knowledge graph
- *   - Plugin = auto-recall, auto-capture, search tools, lifecycle hooks
- *   - OpenClaw = agent runtime, sessions, tools, channels
- *   - Templates = schema definitions for primitive types
- *
- * The plugin does NOT give the agent a "store memory" tool. Memory is
- * observational: the system watches conversations and captures automatically.
- * The agent searches memory; it doesn't manage it.
- */
-
-declare function getTemplateRegistry(): TemplateRegistry | null;
-declare const clawvaultPlugin: {
-    id: string;
-    name: string;
-    description: string;
-    version: string;
-    kind: "memory";
-    register(api: any): void;
-};
-
-export { clawvaultPlugin as default, getTemplateRegistry };

package/dist/plugin/inject.cjs

@@ -1,356 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/plugin/inject.ts
-var inject_exports = {};
-__export(inject_exports, {
-  buildFullContext: () => buildFullContext,
-  buildPreferenceContext: () => buildPreferenceContext,
-  buildSessionRecap: () => buildSessionRecap,
-  formatMemoriesForContext: () => formatMemoriesForContext,
-  formatSearchResults: () => formatSearchResults,
-  scanVaultFiles: () => scanVaultFiles
-});
-module.exports = __toCommonJS(inject_exports);
-var import_node_fs = require("fs");
-var import_node_path = require("path");
-function parseYamlFrontmatter(content) {
-  const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
-  if (!match) return null;
-  const yamlContent = match[1];
-  const body = match[2];
-  try {
-    const frontmatter = parseSimpleYaml(yamlContent);
-    return { frontmatter, body };
-  } catch {
-    return null;
-  }
-}
-function parseSimpleYaml(yaml) {
-  const result = {};
-  const lines = yaml.split("\n");
-  for (const line of lines) {
-    if (!line.trim() || line.trim().startsWith("#")) continue;
-    const colonIndex = line.indexOf(":");
-    if (colonIndex === -1) continue;
-    const key = line.slice(0, colonIndex).trim();
-    const valueStr = line.slice(colonIndex + 1).trim();
-    if (valueStr === "" || valueStr.startsWith("|") || valueStr.startsWith(">")) continue;
-    result[key] = parseYamlValue(valueStr);
-  }
-  return result;
-}
-function parseYamlValue(value) {
-  if (value === "" || value === "null" || value === "~") return null;
-  if (value === "true") return true;
-  if (value === "false") return false;
-  if (/^-?\d+$/.test(value)) return parseInt(value, 10);
-  if (/^-?\d+\.\d+$/.test(value)) return parseFloat(value);
-  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
-    return value.slice(1, -1);
-  }
-  return value;
-}
-function scanVaultFiles(vaultPath, options = {}) {
-  const files = [];
-  const maxAge = options.maxAge ?? 7 * 24 * 60 * 60 * 1e3;
-  const limit = options.limit ?? 100;
-  const now = Date.now();
-  const cutoff = now - maxAge;
-  const dirsToScan = findVaultDirectories(vaultPath);
-  for (const dir of dirsToScan) {
-    if (!(0, import_node_fs.existsSync)(dir)) continue;
-    try {
-      scanDirectory(dir, vaultPath, files, cutoff, options.primitiveTypes);
-    } catch {
-    }
-  }
-  files.sort((a, b) => b.modifiedAt.getTime() - a.modifiedAt.getTime());
-  return files.slice(0, limit);
-}
-function findVaultDirectories(vaultPath) {
-  const dirs = [];
-  dirs.push(vaultPath);
-  const commonDirs = [
-    "tasks",
-    "projects",
-    "decisions",
-    "people",
-    "persons",
-    "notes",
-    "daily",
-    "journal",
-    "ledger",
-    "memory",
-    "memories",
-    "observations",
-    "lessons",
-    "triggers",
-    "runs",
-    "checkpoints",
-    "handoffs",
-    "workspaces",
-    "parties"
-  ];
-  for (const subdir of commonDirs) {
-    const fullPath = (0, import_node_path.join)(vaultPath, subdir);
-    if ((0, import_node_fs.existsSync)(fullPath)) {
-      dirs.push(fullPath);
-    }
-  }
-  try {
-    const entries = (0, import_node_fs.readdirSync)(vaultPath, { withFileTypes: true });
-    for (const entry of entries) {
-      if (entry.isDirectory() && !entry.name.startsWith(".") && !entry.name.startsWith("_")) {
-        const fullPath = (0, import_node_path.join)(vaultPath, entry.name);
-        if (!dirs.includes(fullPath)) {
-          dirs.push(fullPath);
-        }
-      }
-    }
-  } catch {
-  }
-  return dirs;
-}
-function scanDirectory(dir, vaultPath, files, cutoff, primitiveTypes) {
-  const entries = (0, import_node_fs.readdirSync)(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    if (entry.name.startsWith(".") || entry.name.startsWith("_")) continue;
-    const fullPath = (0, import_node_path.join)(dir, entry.name);
-    if (entry.isDirectory()) {
-      const depth = fullPath.replace(vaultPath, "").split("/").length;
-      if (depth <= 3) {
-        scanDirectory(fullPath, vaultPath, files, cutoff, primitiveTypes);
-      }
-    } else if (entry.name.endsWith(".md")) {
-      try {
-        const stat = (0, import_node_fs.statSync)(fullPath);
-        if (stat.mtimeMs < cutoff) continue;
-        const content = (0, import_node_fs.readFileSync)(fullPath, "utf-8");
-        const parsed = parseYamlFrontmatter(content);
-        if (!parsed) continue;
-        const primitiveType = detectPrimitiveType(parsed.frontmatter, fullPath);
-        if (primitiveTypes && !primitiveTypes.includes(primitiveType)) continue;
-        files.push({
-          path: fullPath,
-          relativePath: (0, import_node_path.relative)(vaultPath, fullPath),
-          primitiveType,
-          frontmatter: parsed.frontmatter,
-          content: parsed.body,
-          modifiedAt: stat.mtime,
-          createdAt: stat.birthtime
-        });
-      } catch {
-      }
-    }
-  }
-}
-function detectPrimitiveType(frontmatter, filePath) {
-  if (frontmatter.primitive) return String(frontmatter.primitive);
-  if (frontmatter.type) return String(frontmatter.type);
-  const pathLower = filePath.toLowerCase();
-  if (pathLower.includes("/tasks/")) return "task";
-  if (pathLower.includes("/projects/")) return "project";
-  if (pathLower.includes("/decisions/")) return "decision";
-  if (pathLower.includes("/people/") || pathLower.includes("/persons/")) return "person";
-  if (pathLower.includes("/daily/") || pathLower.includes("/journal/")) return "daily-note";
-  if (pathLower.includes("/lessons/")) return "lesson";
-  if (pathLower.includes("/triggers/")) return "trigger";
-  if (pathLower.includes("/runs/")) return "run";
-  if (pathLower.includes("/checkpoints/")) return "checkpoint";
-  if (pathLower.includes("/handoffs/")) return "handoff";
-  if (pathLower.includes("/ledger/")) return "memory_event";
-  if (pathLower.includes("/memory/") || pathLower.includes("/memories/")) return "memory_event";
-  return "unknown";
-}
-function buildSessionRecap(vaultPath, options = {}) {
-  const maxAge = options.maxAge ?? 24 * 60 * 60 * 1e3;
-  const limit = options.limit ?? 20;
-  const includeContent = options.includeContent ?? false;
-  const files = scanVaultFiles(vaultPath, { maxAge, limit });
-  if (files.length === 0) {
-    return {
-      xml: "",
-      fileCount: 0,
-      primitiveGroups: {},
-      timeRange: null
-    };
-  }
-  const groups = {};
-  for (const file of files) {
-    const type = file.primitiveType;
-    if (!groups[type]) groups[type] = [];
-    groups[type].push(file);
-  }
-  const lines = ["<session-recap>"];
-  lines.push(`<summary>Found ${files.length} recent items across ${Object.keys(groups).length} categories</summary>`);
-  for (const [primitiveType, groupFiles] of Object.entries(groups)) {
-    lines.push(`<${primitiveType}-items count="${groupFiles.length}">`);
-    for (const file of groupFiles.slice(0, 5)) {
-      const title = file.frontmatter.title || file.frontmatter.summary || file.relativePath;
-      const status = file.frontmatter.status || "";
-      const modified = file.modifiedAt.toISOString().slice(0, 16).replace("T", " ");
-      lines.push(`  <item path="${file.relativePath}" modified="${modified}"${status ? ` status="${status}"` : ""}>`);
-      lines.push(`    <title>${escapeXml(String(title))}</title>`);
-      if (includeContent && file.content) {
-        const snippet = file.content.slice(0, 200).replace(/\n/g, " ").trim();
-        if (snippet) {
-          lines.push(`    <snippet>${escapeXml(snippet)}</snippet>`);
-        }
-      }
-      lines.push("  </item>");
-    }
-    if (groupFiles.length > 5) {
-      lines.push(`  <more count="${groupFiles.length - 5}" />`);
-    }
-    lines.push(`</${primitiveType}-items>`);
-  }
-  lines.push("</session-recap>");
-  const sortedByTime = [...files].sort((a, b) => a.modifiedAt.getTime() - b.modifiedAt.getTime());
-  const timeRange = {
-    oldest: sortedByTime[0].modifiedAt,
-    newest: sortedByTime[sortedByTime.length - 1].modifiedAt
-  };
-  const primitiveGroups = {};
-  for (const [type, groupFiles] of Object.entries(groups)) {
-    primitiveGroups[type] = groupFiles.length;
-  }
-  return {
-    xml: lines.join("\n"),
-    fileCount: files.length,
-    primitiveGroups,
-    timeRange
-  };
-}
-function buildPreferenceContext(vaultPath, options = {}) {
-  const maxAge = options.maxAge ?? 30 * 24 * 60 * 60 * 1e3;
-  const limit = options.limit ?? 50;
-  const files = scanVaultFiles(vaultPath, { maxAge, limit: limit * 2 });
-  const preferenceFiles = files.filter((file) => {
-    if (file.frontmatter.type === "preference") return true;
-    if (file.primitiveType === "memory_event" && file.frontmatter.type === "preference") return true;
-    const content = (file.content || "").toLowerCase();
-    if (/\b(prefer|like|love|hate|dislike|want|need|always|never)\b/.test(content)) {
-      return true;
-    }
-    return false;
-  }).slice(0, limit);
-  if (preferenceFiles.length === 0) {
-    return {
-      xml: "",
-      preferenceCount: 0,
-      categories: []
-    };
-  }
-  const categories = /* @__PURE__ */ new Set();
-  for (const file of preferenceFiles) {
-    if (file.frontmatter.category) {
-      categories.add(String(file.frontmatter.category));
-    }
-  }
-  const lines = ["<user-preferences>"];
-  for (const file of preferenceFiles) {
-    const summary = file.frontmatter.summary || file.frontmatter.title || extractPreferenceSummary(file.content);
-    if (!summary) continue;
-    const category = file.frontmatter.category || "general";
-    const sentiment = file.frontmatter.sentiment || inferSentiment(file.content);
-    lines.push(`  <preference category="${escapeXml(String(category))}" sentiment="${sentiment}">`);
-    lines.push(`    ${escapeXml(String(summary))}`);
-    lines.push("  </preference>");
-  }
-  lines.push("</user-preferences>");
-  return {
-    xml: lines.join("\n"),
-    preferenceCount: preferenceFiles.length,
-    categories: Array.from(categories)
-  };
-}
-function extractPreferenceSummary(content) {
-  if (!content) return "";
-  const sentences = content.split(/[.!?\n]+/).map((s) => s.trim()).filter((s) => s.length > 10);
-  for (const sentence of sentences) {
-    if (/\b(prefer|like|love|hate|dislike|want|need|always|never)\b/i.test(sentence)) {
-      return sentence.slice(0, 150);
-    }
-  }
-  return sentences[0]?.slice(0, 150) || "";
-}
-function inferSentiment(content) {
-  if (!content) return "neutral";
-  const lower = content.toLowerCase();
-  if (/\b(love|like|prefer|enjoy|want|need|always)\b/.test(lower)) return "positive";
-  if (/\b(hate|dislike|don't like|never|avoid)\b/.test(lower)) return "negative";
-  return "neutral";
-}
-function formatMemoriesForContext(results, collection) {
-  if (results.length === 0) return "";
-  const lines = results.map((r, i) => {
-    const file = (r.file || "").replace(`qmd://${collection}/`, "");
-    const snippet = (r.snippet || "").replace(/@@ .+? @@\s*\(.+?\)\n?/g, "").trim() || r.title || "";
-    return `${i + 1}. [${file}] ${snippet}`;
-  });
-  return `<relevant-memories>
-These are recalled from long-term vault memory. Treat as historical context.
-${lines.join("\n")}
-</relevant-memories>`;
-}
-function formatSearchResults(results, collection) {
-  if (results.length === 0) return "No relevant memories found.";
-  return results.map((r, i) => {
-    const file = (r.file || "").replace(`qmd://${collection}/`, "");
-    const snippet = (r.snippet || "").replace(/@@ .+? @@\s*\(.+?\)\n?/g, "").trim() || r.title || "(no content)";
-    const score = ((r.score ?? 0) * 100).toFixed(0);
-    return `${i + 1}. [${file}] ${snippet} (${score}%)`;
-  }).join("\n");
-}
-function escapeXml(str) {
-  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-}
-function buildFullContext(vaultPath, options = {}) {
-  const parts = [];
-  if (options.includeRecap !== false) {
-    const recap = buildSessionRecap(vaultPath, {
-      maxAge: options.recapMaxAge ?? 24 * 60 * 60 * 1e3,
-      limit: 15,
-      includeContent: true
-    });
-    if (recap.xml) {
-      parts.push(recap.xml);
-    }
-  }
-  if (options.includePreferences !== false) {
-    const prefs = buildPreferenceContext(vaultPath, {
-      maxAge: options.preferenceMaxAge ?? 30 * 24 * 60 * 60 * 1e3,
-      limit: 20
-    });
-    if (prefs.xml) {
-      parts.push(prefs.xml);
-    }
-  }
-  return parts.join("\n\n");
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildFullContext,
-  buildPreferenceContext,
-  buildSessionRecap,
-  formatMemoriesForContext,
-  formatSearchResults,
-  scanVaultFiles
-});

package/dist/plugin/inject.d.cts

@@ -1,54 +0,0 @@
-/**
- * Dynamic Context Injection for ClawVault
- *
- * Builds session recaps and preference context by dynamically scanning
- * the vault instead of using hardcoded paths. Groups files by primitive
- * type and builds context XML for injection.
- */
-interface VaultFile {
-    path: string;
-    relativePath: string;
-    primitiveType: string;
-    frontmatter: Record<string, unknown>;
-    content: string;
-    modifiedAt: Date;
-    createdAt: Date;
-}
-interface SessionRecap {
-    xml: string;
-    fileCount: number;
-    primitiveGroups: Record<string, number>;
-    timeRange: {
-        oldest: Date;
-        newest: Date;
-    } | null;
-}
-interface PreferenceContext {
-    xml: string;
-    preferenceCount: number;
-    categories: string[];
-}
-declare function scanVaultFiles(vaultPath: string, options?: {
-    maxAge?: number;
-    limit?: number;
-    primitiveTypes?: string[];
-}): VaultFile[];
-declare function buildSessionRecap(vaultPath: string, options?: {
-    maxAge?: number;
-    limit?: number;
-    includeContent?: boolean;
-}): SessionRecap;
-declare function buildPreferenceContext(vaultPath: string, options?: {
-    maxAge?: number;
-    limit?: number;
-}): PreferenceContext;
-declare function formatMemoriesForContext(results: any[], collection: string): string;
-declare function formatSearchResults(results: any[], collection: string): string;
-declare function buildFullContext(vaultPath: string, options?: {
-    includeRecap?: boolean;
-    includePreferences?: boolean;
-    recapMaxAge?: number;
-    preferenceMaxAge?: number;
-}): string;
-
-export { type PreferenceContext, type SessionRecap, type VaultFile, buildFullContext, buildPreferenceContext, buildSessionRecap, formatMemoriesForContext, formatSearchResults, scanVaultFiles };

package/dist/plugin/inject.d.ts

@@ -1,54 +0,0 @@
-/**
- * Dynamic Context Injection for ClawVault
- *
- * Builds session recaps and preference context by dynamically scanning
- * the vault instead of using hardcoded paths. Groups files by primitive
- * type and builds context XML for injection.
- */
-interface VaultFile {
-    path: string;
-    relativePath: string;
-    primitiveType: string;
-    frontmatter: Record<string, unknown>;
-    content: string;
-    modifiedAt: Date;
-    createdAt: Date;
-}
-interface SessionRecap {
-    xml: string;
-    fileCount: number;
-    primitiveGroups: Record<string, number>;
-    timeRange: {
-        oldest: Date;
-        newest: Date;
-    } | null;
-}
-interface PreferenceContext {
-    xml: string;
-    preferenceCount: number;
-    categories: string[];
-}
-declare function scanVaultFiles(vaultPath: string, options?: {
-    maxAge?: number;
-    limit?: number;
-    primitiveTypes?: string[];
-}): VaultFile[];
-declare function buildSessionRecap(vaultPath: string, options?: {
-    maxAge?: number;
-    limit?: number;
-    includeContent?: boolean;
-}): SessionRecap;
-declare function buildPreferenceContext(vaultPath: string, options?: {
-    maxAge?: number;
-    limit?: number;
-}): PreferenceContext;
-declare function formatMemoriesForContext(results: any[], collection: string): string;
-declare function formatSearchResults(results: any[], collection: string): string;
-declare function buildFullContext(vaultPath: string, options?: {
-    includeRecap?: boolean;
-    includePreferences?: boolean;
-    recapMaxAge?: number;
-    preferenceMaxAge?: number;
-}): string;
-
-export { type PreferenceContext, type SessionRecap, type VaultFile, buildFullContext, buildPreferenceContext, buildSessionRecap, formatMemoriesForContext, formatSearchResults, scanVaultFiles };

package/dist/plugin/inject.js

@@ -1,17 +0,0 @@
-import {
-  buildFullContext,
-  buildPreferenceContext,
-  buildSessionRecap,
-  formatMemoriesForContext,
-  formatSearchResults,
-  scanVaultFiles
-} from "../chunk-CMB7UL7C.js";
-import "../chunk-3RG5ZIWI.js";
-export {
-  buildFullContext,
-  buildPreferenceContext,
-  buildSessionRecap,
-  formatMemoriesForContext,
-  formatSearchResults,
-  scanVaultFiles
-};