clawvault 2.2.0 → 2.2.1

package/bin/register-core-commands.js

@@ -23,8 +23,14 @@ export function registerCoreCommands(
           qmdCollection: options.qmdCollection
         });
 
+        const categories = vault.getCategories();
+        const memoryCategories = categories.filter(c => !['templates', 'tasks', 'backlog'].includes(c));
+        const workCategories = categories.filter(c => ['tasks', 'backlog'].includes(c));
+
         console.log(chalk.green('✓ Vault created'));
-        console.log(chalk.dim(`  Categories: ${vault.getCategories().join(', ')}`));
+        console.log(chalk.dim(`  Memory:  ${memoryCategories.join(', ')}`));
+        console.log(chalk.dim(`  Work:    ${workCategories.join(', ')}`));
+        console.log(chalk.dim(`  Ledger:  ledger/raw, ledger/observations, ledger/reflections`));
 
         console.log(chalk.cyan('\nSetting up qmd collection...'));
         try {
@@ -43,9 +49,13 @@ export function registerCoreCommands(
         }
 
         console.log(chalk.green('\n✅ ClawVault ready!\n'));
-        console.log(chalk.dim('Next steps:'));
-        console.log(chalk.dim('  clawvault store --category inbox --title "My note" --content "Hello world"'));
-        console.log(chalk.dim('  clawvault search "hello"'));
+        console.log('  ' + chalk.bold('Try these:'));
+        console.log(chalk.dim('  clawvault capture "my first thought"     # quick capture'));
+        console.log(chalk.dim('  clawvault graph                          # see your knowledge graph'));
+        console.log(chalk.dim('  clawvault context "topic"                # graph-aware context'));
+        console.log(chalk.dim('  clawvault checkpoint --working-on "task"  # save progress'));
+        console.log();
+        console.log(chalk.dim('  Full docs: https://docs.clawvault.dev'));
         console.log();
       } catch (err) {
         console.error(chalk.red(`Error: ${err.message}`));

package/dist/{chunk-DHBDH4DN.js → chunk-FDJIZKCW.js}

@@ -8,7 +8,14 @@ var DEFAULT_CATEGORIES = [
   "goals",
   "transcripts",
   "inbox",
-  "templates"
+  "templates",
+  "lessons",
+  "agents",
+  "commitments",
+  "handoffs",
+  "research",
+  "tasks",
+  "backlog"
 ];
 var MEMORY_TYPES = [
   "fact",

package/dist/{chunk-6RIHODNR.js → chunk-I5X6J4FX.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-Z2XBWN7A.js";
 import {
   ClawVault
-} from "./chunk-IFGDPIFI.js";
+} from "./chunk-OTQW3OMC.js";
 import {
   getMemoryGraph
 } from "./chunk-ZZA73MFY.js";

package/dist/{chunk-IFGDPIFI.js → chunk-OTQW3OMC.js}

@@ -8,7 +8,7 @@ import {
   hasQmd,
   qmdEmbed,
   qmdUpdate
-} from "./chunk-DHBDH4DN.js";
+} from "./chunk-FDJIZKCW.js";
 import {
   buildOrUpdateMemoryGraphIndex
 } from "./chunk-ZZA73MFY.js";
@@ -58,11 +58,19 @@ var ClawVault = class {
         fs.mkdirSync(catPath, { recursive: true });
       }
     }
+    const ledgerDirs = ["ledger/raw", "ledger/observations", "ledger/reflections"];
+    for (const dir of ledgerDirs) {
+      const dirPath = path.join(vaultPath, dir);
+      if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+      }
+    }
     await this.createTemplates();
     const readmePath = path.join(vaultPath, "README.md");
     if (!fs.existsSync(readmePath)) {
       fs.writeFileSync(readmePath, this.generateReadme());
     }
+    await this.createWelcomeNote();
     const configPath = path.join(vaultPath, CONFIG_FILE);
     const meta = {
       name: this.config.name,
@@ -628,6 +636,51 @@ var ClawVault = class {
       }
     }
   }
+  async createWelcomeNote() {
+    const inboxPath = path.join(this.config.path, "inbox", "welcome.md");
+    if (fs.existsSync(inboxPath)) return;
+    const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const content = `---
+title: "Welcome to ${this.config.name}"
+date: ${now}
+type: fact
+tags: [welcome, getting-started]
+---
+
+# Welcome to ${this.config.name}
+
+Your vault is ready. Here's what you can do:
+
+## Quick Start
+
+- **Capture a thought:** \`clawvault capture "your note here"\`
+- **Store structured memory:** \`clawvault store --category decisions --title "My Choice" --content "..."\`
+- **Search your vault:** \`clawvault search "query"\`
+- **See your knowledge graph:** \`clawvault graph\`
+- **Get context for a topic:** \`clawvault context "topic"\`
+
+## Vault Structure
+
+Your vault organizes memories by type \u2014 decisions, lessons, people, projects, and more.
+Each category is a folder. Each memory is a markdown file with frontmatter.
+
+## Observational Memory
+
+When connected to an AI agent (like OpenClaw), your vault can automatically observe
+conversations and extract important memories \u2014 decisions, lessons, commitments \u2014 without
+manual effort.
+
+## Wiki-Links
+
+Use \`[[double brackets]]\` to link between notes. Your memory graph tracks these
+connections, building a knowledge network that grows with you.
+
+---
+
+*Delete this file anytime. It's just here to say hello.*
+`;
+    fs.writeFileSync(inboxPath, content);
+  }
   async syncMemoryGraphIndex(options = {}) {
     try {
       await buildOrUpdateMemoryGraphIndex(this.config.path, options);
@@ -635,29 +688,51 @@ var ClawVault = class {
     }
   }
   generateReadme() {
-    return `# ${this.config.name} \u{1F418}
+    const coreCategories = this.config.categories.filter((c) => !["templates", "tasks", "backlog"].includes(c));
+    const workCategories = this.config.categories.filter((c) => ["tasks", "backlog"].includes(c));
+    return `# ${this.config.name}
 
 An elephant never forgets.
 
 ## Structure
 
-${this.config.categories.map((c) => `- \`/${c}/\` \u2014 ${this.getCategoryDescription(c)}`).join("\n")}
+### Memory Categories
+${coreCategories.map((c) => `- \`${c}/\` \u2014 ${this.getCategoryDescription(c)}`).join("\n")}
 
-## Quick Search
+### Work Tracking
+${workCategories.map((c) => `- \`${c}/\` \u2014 ${this.getCategoryDescription(c)}`).join("\n")}
+
+### Observational Memory
+- \`ledger/raw/\` \u2014 Raw session transcripts (source of truth)
+- \`ledger/observations/\` \u2014 Compressed observations with importance scores
+- \`ledger/reflections/\` \u2014 Weekly reflection summaries
+
+## Quick Reference
 
 \`\`\`bash
+# Capture a thought
+clawvault capture "important insight about X"
+
+# Store structured memory
+clawvault store --category decisions --title "Choice" --content "We chose X because..."
+
+# Search
 clawvault search "query"
-\`\`\`
+clawvault vsearch "semantic query"    # vector search
 
-## Quick Capture
+# Knowledge graph
+clawvault graph                       # vault stats
+clawvault context "topic"             # graph-aware context retrieval
 
-\`\`\`bash
-clawvault store --category inbox --title "note" --content "..."
+# Session lifecycle
+clawvault checkpoint --working-on "task"
+clawvault sleep "what I did" --next "what's next"
+clawvault wake                        # restore context on startup
 \`\`\`
 
 ---
 
-*Managed by [ClawVault](https://github.com/Versatly/clawvault)*
+*Managed by [ClawVault](https://clawvault.dev)*
 `;
   }
   getCategoryDescription(category) {
@@ -677,7 +752,11 @@ clawvault store --category inbox --title "note" --content "..."
       goals: "Long-term and short-term objectives",
       patterns: "Recurring behaviors (\u2192 lessons)",
       inbox: "Quick capture \u2192 process later",
-      templates: "Templates for each document type"
+      templates: "Templates for each document type",
+      agents: "Other agents \u2014 capabilities, trust levels, coordination notes",
+      research: "Deep dives, analysis, reference material",
+      tasks: "Active work items with status and context",
+      backlog: "Future work \u2014 ideas and tasks not yet started"
     };
     return descriptions[category] || category;
   }

package/dist/{chunk-KNDVXXKC.js → chunk-W463YRED.js}

@@ -1,7 +1,7 @@
 import {
   DEFAULT_CATEGORIES,
   hasQmd
-} from "./chunk-DHBDH4DN.js";
+} from "./chunk-FDJIZKCW.js";
 
 // src/commands/setup.ts
 import * as fs from "fs";

package/dist/commands/context.js

@@ -3,11 +3,11 @@ import {
   contextCommand,
   formatContextMarkdown,
   registerContextCommand
-} from "../chunk-6RIHODNR.js";
+} from "../chunk-I5X6J4FX.js";
 import "../chunk-K6XHCUFL.js";
 import "../chunk-Z2XBWN7A.js";
-import "../chunk-IFGDPIFI.js";
-import "../chunk-DHBDH4DN.js";
+import "../chunk-OTQW3OMC.js";
+import "../chunk-FDJIZKCW.js";
 import "../chunk-ZZA73MFY.js";
 export {
   buildContext,

package/dist/commands/doctor.js

@@ -10,10 +10,10 @@ import {
 import {
   ClawVault,
   findVault
-} from "../chunk-IFGDPIFI.js";
+} from "../chunk-OTQW3OMC.js";
 import {
   hasQmd
-} from "../chunk-DHBDH4DN.js";
+} from "../chunk-FDJIZKCW.js";
 import "../chunk-J7ZWCI2C.js";
 import {
   loadMemoryGraphIndex

package/dist/commands/setup.js

@@ -1,7 +1,7 @@
 import {
   setupCommand
-} from "../chunk-KNDVXXKC.js";
-import "../chunk-DHBDH4DN.js";
+} from "../chunk-W463YRED.js";
+import "../chunk-FDJIZKCW.js";
 export {
   setupCommand
 };

package/dist/commands/sleep.js

@@ -15,10 +15,10 @@ import "../chunk-K6XHCUFL.js";
 import "../chunk-Z2XBWN7A.js";
 import {
   ClawVault
-} from "../chunk-IFGDPIFI.js";
+} from "../chunk-OTQW3OMC.js";
 import {
   qmdUpdate
-} from "../chunk-DHBDH4DN.js";
+} from "../chunk-FDJIZKCW.js";
 import "../chunk-ZZA73MFY.js";
 
 // src/commands/sleep.ts

package/dist/commands/status.js

@@ -6,11 +6,11 @@ import {
 } from "../chunk-7ZRP733D.js";
 import {
   ClawVault
-} from "../chunk-IFGDPIFI.js";
+} from "../chunk-OTQW3OMC.js";
 import {
   QmdUnavailableError,
   hasQmd
-} from "../chunk-DHBDH4DN.js";
+} from "../chunk-FDJIZKCW.js";
 import "../chunk-J7ZWCI2C.js";
 import {
   loadMemoryGraphIndex

package/dist/commands/wake.js

@@ -13,8 +13,8 @@ import {
 import "../chunk-7ZRP733D.js";
 import {
   ClawVault
-} from "../chunk-IFGDPIFI.js";
-import "../chunk-DHBDH4DN.js";
+} from "../chunk-OTQW3OMC.js";
+import "../chunk-FDJIZKCW.js";
 import "../chunk-ZZA73MFY.js";
 
 // src/commands/wake.ts

package/dist/index.d.ts

@@ -144,6 +144,7 @@ declare class ClawVault {
     private slugify;
     private saveIndex;
     private createTemplates;
+    private createWelcomeNote;
     private syncMemoryGraphIndex;
     private generateReadme;
     private getCategoryDescription;

package/dist/index.js

@@ -5,7 +5,7 @@ import {
 } from "./chunk-ZKGY7WTT.js";
 import {
   setupCommand
-} from "./chunk-KNDVXXKC.js";
+} from "./chunk-W463YRED.js";
 import {
   registerSyncBdCommand,
   syncBdCommand
@@ -63,7 +63,7 @@ import {
   normalizeContextProfileInput,
   registerContextCommand,
   resolveContextProfile
-} from "./chunk-6RIHODNR.js";
+} from "./chunk-I5X6J4FX.js";
 import "./chunk-K6XHCUFL.js";
 import "./chunk-Z2XBWN7A.js";
 import {
@@ -75,7 +75,7 @@ import {
   ClawVault,
   createVault,
   findVault
-} from "./chunk-IFGDPIFI.js";
+} from "./chunk-OTQW3OMC.js";
 import {
   DEFAULT_CATEGORIES,
   DEFAULT_CONFIG,
@@ -90,7 +90,7 @@ import {
   hasQmd,
   qmdEmbed,
   qmdUpdate
-} from "./chunk-DHBDH4DN.js";
+} from "./chunk-FDJIZKCW.js";
 import {
   graphCommand,
   graphSummary

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawvault",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "ClawVault™ - 🐘 An elephant never forgets. Structured memory for OpenClaw agents. Context death resilience, Obsidian-compatible markdown, local semantic search.",
   "type": "module",
   "main": "dist/index.cjs",