clawvault 3.0.0 → 3.2.0

package/dist/plugin/vault.d.cts

@@ -1,68 +0,0 @@
-import { Observation } from './observe.cjs';
-
-/**
- * Template-Aware Vault File Writing for ClawVault
- *
- * Writes vault files with proper frontmatter based on template schemas.
- * Validates enum fields, applies defaults, and adds timestamps.
- */
-
-interface WriteOptions {
-    primitiveType?: string;
-    title?: string;
-    content?: string;
-    extraFields?: Record<string, unknown>;
-    source?: string;
-    sessionId?: string;
-    directory?: string;
-    filename?: string;
-    overwrite?: boolean;
-}
-interface WriteResult {
-    success: boolean;
-    path: string;
-    primitiveType: string;
-    errors: string[];
-    created: boolean;
-    updated: boolean;
-}
-interface LedgerEntry {
-    timestamp: Date;
-    category: string;
-    actor?: string;
-    content: string;
-    primitiveType?: string;
-    tags?: string[];
-}
-declare function writeVaultFile(vaultPath: string, options: WriteOptions): WriteResult;
-declare function writeObservation(vaultPath: string, observation: Observation, options?: {
-    source?: string;
-    sessionId?: string;
-}): WriteResult;
-declare function writeObservations(vaultPath: string, observations: Observation[], options?: {
-    source?: string;
-    sessionId?: string;
-}): WriteResult[];
-declare function appendToLedger(vaultPath: string, entry: LedgerEntry): void;
-declare function appendObservationToLedger(vaultPath: string, observation: Observation, actor?: string): void;
-interface BatchWriteResult {
-    total: number;
-    successful: number;
-    failed: number;
-    results: WriteResult[];
-}
-declare function batchWriteObservations(vaultPath: string, observations: Observation[], options?: {
-    source?: string;
-    sessionId?: string;
-    writeLedger?: boolean;
-    writeFiles?: boolean;
-    actor?: string;
-}): BatchWriteResult;
-declare function ensureVaultStructure(vaultPath: string): void;
-declare function getVaultStats(vaultPath: string): {
-    directories: string[];
-    fileCount: number;
-    primitiveTypes: Record<string, number>;
-};
-
-export { type BatchWriteResult, type LedgerEntry, type WriteOptions, type WriteResult, appendObservationToLedger, appendToLedger, batchWriteObservations, ensureVaultStructure, getVaultStats, writeObservation, writeObservations, writeVaultFile };

package/dist/plugin/vault.d.ts

@@ -1,68 +0,0 @@
-import { Observation } from './observe.js';
-
-/**
- * Template-Aware Vault File Writing for ClawVault
- *
- * Writes vault files with proper frontmatter based on template schemas.
- * Validates enum fields, applies defaults, and adds timestamps.
- */
-
-interface WriteOptions {
-    primitiveType?: string;
-    title?: string;
-    content?: string;
-    extraFields?: Record<string, unknown>;
-    source?: string;
-    sessionId?: string;
-    directory?: string;
-    filename?: string;
-    overwrite?: boolean;
-}
-interface WriteResult {
-    success: boolean;
-    path: string;
-    primitiveType: string;
-    errors: string[];
-    created: boolean;
-    updated: boolean;
-}
-interface LedgerEntry {
-    timestamp: Date;
-    category: string;
-    actor?: string;
-    content: string;
-    primitiveType?: string;
-    tags?: string[];
-}
-declare function writeVaultFile(vaultPath: string, options: WriteOptions): WriteResult;
-declare function writeObservation(vaultPath: string, observation: Observation, options?: {
-    source?: string;
-    sessionId?: string;
-}): WriteResult;
-declare function writeObservations(vaultPath: string, observations: Observation[], options?: {
-    source?: string;
-    sessionId?: string;
-}): WriteResult[];
-declare function appendToLedger(vaultPath: string, entry: LedgerEntry): void;
-declare function appendObservationToLedger(vaultPath: string, observation: Observation, actor?: string): void;
-interface BatchWriteResult {
-    total: number;
-    successful: number;
-    failed: number;
-    results: WriteResult[];
-}
-declare function batchWriteObservations(vaultPath: string, observations: Observation[], options?: {
-    source?: string;
-    sessionId?: string;
-    writeLedger?: boolean;
-    writeFiles?: boolean;
-    actor?: string;
-}): BatchWriteResult;
-declare function ensureVaultStructure(vaultPath: string): void;
-declare function getVaultStats(vaultPath: string): {
-    directories: string[];
-    fileCount: number;
-    primitiveTypes: Record<string, number>;
-};
-
-export { type BatchWriteResult, type LedgerEntry, type WriteOptions, type WriteResult, appendObservationToLedger, appendToLedger, batchWriteObservations, ensureVaultStructure, getVaultStats, writeObservation, writeObservations, writeVaultFile };

package/dist/plugin/vault.js

@@ -1,22 +0,0 @@
-import {
-  appendObservationToLedger,
-  appendToLedger,
-  batchWriteObservations,
-  ensureVaultStructure,
-  getVaultStats,
-  writeObservation,
-  writeObservations,
-  writeVaultFile
-} from "../chunk-MFM6K7PU.js";
-import "../chunk-GQSLDZTS.js";
-import "../chunk-3RG5ZIWI.js";
-export {
-  appendObservationToLedger,
-  appendToLedger,
-  batchWriteObservations,
-  ensureVaultStructure,
-  getVaultStats,
-  writeObservation,
-  writeObservations,
-  writeVaultFile
-};

package/dist/types-Y2_Um2Ls.d.ts

@@ -1,205 +0,0 @@
-/**
- * ClawVault Types - The elephant's memory structure
- */
-interface VaultConfig {
-    /** Root path of the vault */
-    path: string;
-    /** Name of the vault */
-    name: string;
-    /** Categories to create on init */
-    categories: string[];
-    /** qmd collection name (defaults to vault name if not set) */
-    qmdCollection?: string;
-    /** Root path for qmd collection (defaults to vault path) */
-    qmdRoot?: string;
-    /** Custom templates path (optional) */
-    templatesPath?: string;
-}
-interface VaultMeta {
-    name: string;
-    version: string;
-    created: string;
-    lastUpdated: string;
-    categories: string[];
-    documentCount: number;
-    /** qmd collection name (defaults to vault name if not set) */
-    qmdCollection?: string;
-    /** Root path for qmd collection (defaults to vault path) */
-    qmdRoot?: string;
-}
-interface Document {
-    /** Unique ID (relative path without extension) */
-    id: string;
-    /** Full file path */
-    path: string;
-    /** Category (folder name) */
-    category: string;
-    /** Document title */
-    title: string;
-    /** Raw content */
-    content: string;
-    /** Frontmatter metadata */
-    frontmatter: Record<string, unknown>;
-    /** Extracted wiki-links [[like-this]] */
-    links: string[];
-    /** Tags extracted from content */
-    tags: string[];
-    /** Last modified timestamp */
-    modified: Date;
-}
-interface SearchResult {
-    /** Document that matched */
-    document: Document;
-    /** Relevance score (0-1) */
-    score: number;
-    /** Matching snippet */
-    snippet: string;
-    /** Which terms matched */
-    matchedTerms: string[];
-}
-interface SearchOptions {
-    /** Max results to return */
-    limit?: number;
-    /** Minimum score threshold (0-1) */
-    minScore?: number;
-    /** Filter by category */
-    category?: string;
-    /** Filter by tags */
-    tags?: string[];
-    /** Include full content in results */
-    fullContent?: boolean;
-    /** Boost recent documents in ranking */
-    temporalBoost?: boolean;
-    /**
-     * v2.7 — Enable chunk-level BM25 pre-filtering before semantic search.
-     * Chunks documents into ~600-char sentence windows and ranks chunks by
-     * keyword overlap so that relevant content deep in long documents isn't
-     * silently dropped by fixed-N embedding limits.
-     */
-    chunkPrefilter?: boolean;
-    /**
-     * v2.7 — Exhaustive threshold-based retrieval for aggregation queries.
-     * Instead of a fixed top_k, keeps pulling results until the normalised
-     * relevance score drops below this threshold (0-1).  Set to e.g. 0.01
-     * for aggregation / "list all" queries.  Overrides `limit` when set.
-     */
-    relevanceThreshold?: number;
-    /**
-     * v2.7 — Maximum results when using relevanceThreshold.
-     * Prevents runaway result sets. Default 40.
-     */
-    thresholdMaxResults?: number;
-}
-/**
- * v2.7 — A date reference extracted from document content at ingest time.
- */
-interface ExtractedDate {
-    /** ISO date string (YYYY-MM-DD) or "duration:<value>" */
-    date: string;
-    /** Surrounding context snippet (~150 chars) */
-    context: string;
-    /** Document id the date was extracted from */
-    documentId: string;
-}
-/**
- * v2.7 — An extracted user preference from conversation content.
- */
-interface ExtractedPreference {
-    /** The preference category (tool, hobby, brand, etc.) */
-    category: string;
-    /** The preference value */
-    value: string;
-    /** Document id it was extracted from */
-    documentId: string;
-    /** Surrounding context snippet */
-    context: string;
-}
-interface StoreOptions {
-    /** Category to store in */
-    category: string;
-    /** Document title (used for filename) */
-    title: string;
-    /** Content body */
-    content: string;
-    /** Frontmatter metadata */
-    frontmatter?: Record<string, unknown>;
-    /** Override existing file */
-    overwrite?: boolean;
-    /** Trigger qmd update after storing */
-    qmdUpdate?: boolean;
-    /** Trigger qmd embed after storing (implies qmdUpdate) */
-    qmdEmbed?: boolean;
-    /** Optional qmd index name override (defaults to configured/global index) */
-    qmdIndexName?: string;
-}
-interface SyncOptions {
-    /** Target directory to sync to */
-    target: string;
-    /** Delete files in target not in source */
-    deleteOrphans?: boolean;
-    /** Dry run - don't actually sync */
-    dryRun?: boolean;
-}
-interface SyncResult {
-    copied: string[];
-    deleted: string[];
-    unchanged: string[];
-    errors: string[];
-}
-type Category = 'preferences' | 'decisions' | 'rules' | 'patterns' | 'people' | 'projects' | 'goals' | 'transcripts' | 'inbox' | 'templates' | 'facts' | 'feelings' | 'lessons' | 'commitments' | 'handoffs' | string;
-declare const DEFAULT_CATEGORIES: Category[];
-/**
- * Memory Type Taxonomy (Benthic's 8 categories)
- * Knowing WHAT KIND of thing helps you know WHERE to put it
- */
-type MemoryType = 'fact' | 'feeling' | 'decision' | 'lesson' | 'commitment' | 'preference' | 'relationship' | 'project';
-declare const MEMORY_TYPES: MemoryType[];
-/**
- * Memory type to category mapping
- */
-declare const TYPE_TO_CATEGORY: Record<MemoryType, Category>;
-/**
- * Handoff document - bridges sessions
- */
-interface HandoffDocument {
-    /** When this handoff was created */
-    created: string;
-    /** Session key or identifier */
-    sessionKey?: string;
-    /** What I was working on */
-    workingOn: string[];
-    /** What is currently blocked */
-    blocked: string[];
-    /** What comes next */
-    nextSteps: string[];
-    /** Emotional state/energy */
-    feeling?: string;
-    /** Key decisions made */
-    decisions?: string[];
-    /** Open questions */
-    openQuestions?: string[];
-}
-/**
- * Session recap - who I was when I woke up
- */
-interface SessionRecap {
-    /** When recap was generated */
-    generated: string;
-    /** Recent handoffs (last N) */
-    recentHandoffs: HandoffDocument[];
-    /** Active projects */
-    activeProjects: string[];
-    /** Pending commitments */
-    pendingCommitments: string[];
-    /** Recent decisions made */
-    recentDecisions?: string[];
-    /** Recent lessons learned */
-    recentLessons: string[];
-    /** Key relationships to remember */
-    keyRelationships: string[];
-    /** Current emotional arc */
-    emotionalArc?: string;
-}
-declare const DEFAULT_CONFIG: Partial<VaultConfig>;
-
-export { type Category as C, type Document as D, type ExtractedDate as E, type HandoffDocument as H, type MemoryType as M, type StoreOptions as S, TYPE_TO_CATEGORY as T, type VaultConfig as V, type SearchOptions as a, type SearchResult as b, type SyncOptions as c, type SyncResult as d, type SessionRecap as e, type ExtractedPreference as f, DEFAULT_CATEGORIES as g, DEFAULT_CONFIG as h, MEMORY_TYPES as i, type VaultMeta as j };

package/templates/memory-event.md

@@ -1,67 +0,0 @@
----
-primitive: memory_event
-description: Canonical schema for append-only observer memory events.
-fields:
-  type:
-    type: string
-    required: true
-    default: memory_event
-    description: Primitive discriminator for memory events.
-  status:
-    type: string
-    required: true
-    default: recorded
-    enum:
-      - recorded
-      - superseded
-      - corrected
-    description: Memory event lifecycle state.
-  created:
-    type: datetime
-    required: true
-    default: "{{datetime}}"
-    description: Event ingestion timestamp.
-  observed_at:
-    type: datetime
-    required: true
-    description: Source session timestamp for observed behavior.
-  source:
-    type: string
-    required: true
-    enum:
-      - openclaw
-      - claude-code
-      - replay
-      - manual-correction
-    description: Event source channel.
-  session_id:
-    type: string
-    description: Runtime session identifier.
-  continuity_event:
-    type: string
-    enum:
-      - none
-      - new
-      - reset
-    default: none
-    description: Continuity marker for /new or /reset transitions.
-  confidence:
-    type: number
-    description: Confidence score for extracted event.
-  importance:
-    type: number
-    description: Importance score used by promotion and retrieval.
-  run_id:
-    type: string
-    description: Related run primitive identifier.
-  summary:
-    type: string
-    required: true
-    description: Structured summary of the observed memory event.
----
-
-# {{title}}
-
-{{links_line}}
-
-{{content}}

package/templates/party.md

@@ -1,63 +0,0 @@
----
-primitive: party
-description: Canonical schema for parties (humans, agents, systems).
-fields:
-  type:
-    type: string
-    required: true
-    default: party
-    description: Primitive discriminator for party documents.
-  status:
-    type: string
-    required: true
-    default: active
-    enum:
-      - active
-      - inactive
-      - archived
-    description: Party lifecycle state.
-  created:
-    type: datetime
-    required: true
-    default: "{{datetime}}"
-    description: ISO timestamp when party was added.
-  updated:
-    type: datetime
-    required: true
-    default: "{{datetime}}"
-    description: ISO timestamp of the latest update.
-  party_type:
-    type: string
-    required: true
-    enum:
-      - human
-      - agent
-      - runtime
-      - service
-    description: Role classification.
-  handle:
-    type: string
-    required: true
-    description: Primary identifier for routing and ownership.
-  owner:
-    type: string
-    description: Owner or steward for this party entry.
-  capabilities:
-    type: string[]
-    description: Capability tags used for assignment.
-  runtime:
-    type: string
-    description: Runtime name when party_type is agent/runtime.
-  policy_profile:
-    type: string
-    description: Policy profile applied to this party.
-  description:
-    type: string
-    description: One-line party summary.
----
-
-# {{title}}
-
-{{links_line}}
-
-{{content}}