clawvault 2.5.3 → 2.6.0

package/README.md

@@ -1,159 +1,159 @@
-# ClawVault 🐘
-
-Structured memory system for AI agents and operators: typed markdown memory, graph-aware context, task/project primitives, Obsidian views, and OpenClaw hook integration.
-
-[![npm](https://img.shields.io/npm/v/clawvault)](https://www.npmjs.com/package/clawvault)
-
-> Local-first. Markdown-first. Built to survive long-running autonomous work.
-
-## Requirements
-
-- Node.js 18+
-- `qmd` installed and available on `PATH`
-
-ClawVault currently relies on `qmd` for core vault/query flows. Install it before first use.
-
-## Install
-
-```bash
-npm install -g clawvault
-```
-
-## 5-Minute Setup
-
-```bash
-# 1) Create or initialize a vault
-clawvault init ~/memory --name my-brain
-
-# 2) Optional vault bootstrap for Obsidian
-clawvault setup --theme neural --canvas
-
-# 3) Verify OpenClaw compatibility in this environment
-clawvault compat
-```
-
-## OpenClaw Setup (Canonical)
-
-If you want hook-based lifecycle integration, use this sequence:
-
-```bash
-# Install CLI
-npm install -g clawvault
-
-# Install and enable hook pack
-openclaw hooks install clawvault
-openclaw hooks enable clawvault
-
-# Verify
-openclaw hooks list --verbose
-openclaw hooks info clawvault
-openclaw hooks check
-clawvault compat
-```
-
-Important:
-
-- `clawhub install clawvault` installs skill guidance, but does not replace hook-pack installation.
-- After enabling hooks, restart the OpenClaw gateway process so hook registration reloads.
-
-## Minimal AGENTS.md Additions
-
-Append these to your existing memory workflow. Do not replace your full prompt setup:
-
-```markdown
-## ClawVault
-- Run `clawvault wake` at session start.
-- Run `clawvault checkpoint` during heavy work.
-- Run `clawvault sleep "summary" --next "next steps"` before ending.
-- Use `clawvault context "<task>"` or `clawvault inject "<message>"` before complex decisions.
-```
-
-## Real CLI Surface (Current)
-
-Core:
-
-- `init`, `setup`, `store`, `capture`
-- `remember`, `list`, `get`, `stats`, `reindex`, `sync`
-
-Context + memory:
-
-- `search`, `vsearch`, `context`, `inject`
-- `observe`, `reflect`, `session-recap`
-- `graph`, `entities`, `link`, `embed`
-
-Resilience:
-
-- `wake`, `sleep`, `handoff`, `recap`
-- `checkpoint`, `recover`, `status`, `clean-exit`, `repair-session`
-- `compat`, `doctor`
-
-Execution primitives:
-
-- `task ...`, `backlog ...`, `blocked`, `project ...`, `kanban ...`
-- `canvas` (generates default `dashboard.canvas`)
-
-Networking:
-
-- `tailscale-status`, `tailscale-sync`, `tailscale-serve`, `tailscale-discover`
-
-## Quick Usage
-
-```bash
-# Store and retrieve memory
-clawvault remember decision "Use PostgreSQL" --content "Chosen for JSONB and reliability"
-clawvault search "postgresql"
-clawvault vsearch "what did we decide about storage"
-
-# Session lifecycle
-clawvault wake
-clawvault checkpoint --working-on "auth rollout" --focus "token refresh edge cases"
-clawvault sleep "finished auth rollout plan" --next "implement migration"
-
-# Work management
-clawvault task add "Ship v2 onboarding" --owner agent --project core --priority high
-clawvault blocked
-clawvault project list --status active
-clawvault kanban sync
-
-# Obsidian projection
-clawvault canvas
-```
-
-## Obsidian Integration
-
-- Setup can generate:
-  - graph theme/snippet config (`--theme neural|minimal|none`)
-  - Bases views (`all-tasks.base`, `blocked.base`, `by-project.base`, `by-owner.base`, `backlog.base`)
-  - default canvas (`dashboard.canvas`) via `--canvas` or `clawvault canvas`
-- Kanban round-trip:
-  - export: `clawvault kanban sync`
-  - import lane changes back to task metadata: `clawvault kanban import`
-
-## Tailscale + WebDAV
-
-ClawVault can serve vault content for sync over Tailscale and exposes WebDAV under `/webdav` for mobile-oriented workflows.
-
-```bash
-clawvault tailscale-status
-clawvault tailscale-serve --vault ~/memory
-clawvault tailscale-discover
-```
-
-## Troubleshooting
-
-- Hook not found after enable:
-  - run `openclaw hooks install clawvault` first
-  - then `openclaw hooks enable clawvault`
-  - restart gateway
-  - verify with `openclaw hooks list --verbose`
-- `qmd` errors:
-  - ensure `qmd --version` works from same shell
-  - rerun `clawvault setup` after qmd install
-- OpenClaw integration drift:
-  - run `clawvault compat`
-- Session transcript corruption:
-  - run `clawvault repair-session --dry-run` then `clawvault repair-session`
-
-## License
-
-MIT
+# ClawVault 🐘
+
+Structured memory system for AI agents and operators: typed markdown memory, graph-aware context, task/project primitives, Obsidian views, and OpenClaw hook integration.
+
+[![npm](https://img.shields.io/npm/v/clawvault)](https://www.npmjs.com/package/clawvault)
+
+> Local-first. Markdown-first. Built to survive long-running autonomous work.
+
+## Requirements
+
+- Node.js 18+
+- `qmd` installed and available on `PATH`
+
+ClawVault currently relies on `qmd` for core vault/query flows. Install it before first use.
+
+## Install
+
+```bash
+npm install -g clawvault
+```
+
+## 5-Minute Setup
+
+```bash
+# 1) Create or initialize a vault
+clawvault init ~/memory --name my-brain
+
+# 2) Optional vault bootstrap for Obsidian
+clawvault setup --theme neural --canvas
+
+# 3) Verify OpenClaw compatibility in this environment
+clawvault compat
+```
+
+## OpenClaw Setup (Canonical)
+
+If you want hook-based lifecycle integration, use this sequence:
+
+```bash
+# Install CLI
+npm install -g clawvault
+
+# Install and enable hook pack
+openclaw hooks install clawvault
+openclaw hooks enable clawvault
+
+# Verify
+openclaw hooks list --verbose
+openclaw hooks info clawvault
+openclaw hooks check
+clawvault compat
+```
+
+Important:
+
+- `clawhub install clawvault` installs skill guidance, but does not replace hook-pack installation.
+- After enabling hooks, restart the OpenClaw gateway process so hook registration reloads.
+
+## Minimal AGENTS.md Additions
+
+Append these to your existing memory workflow. Do not replace your full prompt setup:
+
+```markdown
+## ClawVault
+- Run `clawvault wake` at session start.
+- Run `clawvault checkpoint` during heavy work.
+- Run `clawvault sleep "summary" --next "next steps"` before ending.
+- Use `clawvault context "<task>"` or `clawvault inject "<message>"` before complex decisions.
+```
+
+## Real CLI Surface (Current)
+
+Core:
+
+- `init`, `setup`, `store`, `capture`
+- `remember`, `list`, `get`, `stats`, `reindex`, `sync`
+
+Context + memory:
+
+- `search`, `vsearch`, `context`, `inject`
+- `observe`, `reflect`, `session-recap`
+- `graph`, `entities`, `link`, `embed`
+
+Resilience:
+
+- `wake`, `sleep`, `handoff`, `recap`
+- `checkpoint`, `recover`, `status`, `clean-exit`, `repair-session`
+- `compat`, `doctor`
+
+Execution primitives:
+
+- `task ...`, `backlog ...`, `blocked`, `project ...`, `kanban ...`
+- `canvas` (generates default `dashboard.canvas`)
+
+Networking:
+
+- `tailscale-status`, `tailscale-sync`, `tailscale-serve`, `tailscale-discover`
+
+## Quick Usage
+
+```bash
+# Store and retrieve memory
+clawvault remember decision "Use PostgreSQL" --content "Chosen for JSONB and reliability"
+clawvault search "postgresql"
+clawvault vsearch "what did we decide about storage"
+
+# Session lifecycle
+clawvault wake
+clawvault checkpoint --working-on "auth rollout" --focus "token refresh edge cases"
+clawvault sleep "finished auth rollout plan" --next "implement migration"
+
+# Work management
+clawvault task add "Ship v2 onboarding" --owner agent --project core --priority high
+clawvault blocked
+clawvault project list --status active
+clawvault kanban sync
+
+# Obsidian projection
+clawvault canvas
+```
+
+## Obsidian Integration
+
+- Setup can generate:
+  - graph theme/snippet config (`--theme neural|minimal|none`)
+  - Bases views (`all-tasks.base`, `blocked.base`, `by-project.base`, `by-owner.base`, `backlog.base`)
+  - default canvas (`dashboard.canvas`) via `--canvas` or `clawvault canvas`
+- Kanban round-trip:
+  - export: `clawvault kanban sync`
+  - import lane changes back to task metadata: `clawvault kanban import`
+
+## Tailscale + WebDAV
+
+ClawVault can serve vault content for sync over Tailscale and exposes WebDAV under `/webdav` for mobile-oriented workflows.
+
+```bash
+clawvault tailscale-status
+clawvault tailscale-serve --vault ~/memory
+clawvault tailscale-discover
+```
+
+## Troubleshooting
+
+- Hook not found after enable:
+  - run `openclaw hooks install clawvault` first
+  - then `openclaw hooks enable clawvault`
+  - restart gateway
+  - verify with `openclaw hooks list --verbose`
+- `qmd` errors:
+  - ensure `qmd --version` works from same shell
+  - rerun `clawvault setup` after qmd install
+- OpenClaw integration drift:
+  - run `clawvault compat`
+- Session transcript corruption:
+  - run `clawvault repair-session --dry-run` then `clawvault repair-session`
+
+## License
+
+MIT

package/bin/clawvault.js

@@ -1,112 +1,112 @@
-#!/usr/bin/env node
-
-/**
- * ClawVault CLI 🐘
- * An elephant never forgets.
- */
-
-import { Command } from 'commander';
-import chalk from 'chalk';
-import * as fs from 'fs';
-import * as path from 'path';
-import { registerMaintenanceCommands } from './register-maintenance-commands.js';
-import { registerCoreCommands } from './register-core-commands.js';
-import { registerQueryCommands } from './register-query-commands.js';
-import { registerResilienceCommands } from './register-resilience-commands.js';
-import { registerSessionLifecycleCommands } from './register-session-lifecycle-commands.js';
-import { registerTemplateCommands } from './register-template-commands.js';
-import { registerVaultOperationsCommands } from './register-vault-operations-commands.js';
-import { registerConfigCommands } from './register-config-commands.js';
-import { registerRouteCommands } from './register-route-commands.js';
-import { registerKanbanCommands } from './register-kanban-commands.js';
-import { registerProjectCommands } from './register-project-commands.js';
-
-import { registerTaskCommands } from './register-task-commands.js';
-
-import { registerTailscaleCommands } from './register-tailscale-commands.js';
-import {
-  getVault,
-  resolveVaultPath,
-  runQmd,
-  printQmdMissing,
-  QmdUnavailableError
-} from './command-runtime.js';
-import {
-  createVault
-} from '../dist/index.js';
-
-const program = new Command();
-
-const CLI_VERSION = (() => {
-  try {
-    const pkgUrl = new URL('../package.json', import.meta.url);
-    const pkg = JSON.parse(fs.readFileSync(pkgUrl, 'utf-8'));
-    return pkg.version || '0.0.0';
-  } catch {
-    return '0.0.0';
-  }
-})();
-
-program
-  .name('clawvault')
-  .description('🐘 An elephant never forgets. Structured memory for AI agents.')
-  .version(CLI_VERSION);
-
-registerCoreCommands(program, {
-  chalk,
-  path,
-  fs,
-  createVault,
-  getVault,
-  runQmd
-});
-
-registerQueryCommands(program, {
-  chalk,
-  getVault,
-  resolveVaultPath,
-  QmdUnavailableError,
-  printQmdMissing
-});
-
-registerSessionLifecycleCommands(program, {
-  chalk,
-  resolveVaultPath,
-  QmdUnavailableError,
-  printQmdMissing,
-  getVault,
-  runQmd
-});
-
-registerTemplateCommands(program, { chalk });
-registerMaintenanceCommands(program, { chalk });
-registerResilienceCommands(program, { chalk, resolveVaultPath });
-registerVaultOperationsCommands(program, {
-  chalk,
-  fs,
-  getVault,
-  runQmd,
-  resolveVaultPath,
-  path
-});
-
-
-registerTaskCommands(program, {
-  chalk,
-  resolveVaultPath
-});
-registerKanbanCommands(program, {
-  chalk,
-  resolveVaultPath
-});
-registerProjectCommands(program, {
-  chalk,
-  resolveVaultPath
-});
-
-registerTailscaleCommands(program, { chalk });
-registerConfigCommands(program, { chalk, resolveVaultPath });
-registerRouteCommands(program, { chalk, resolveVaultPath });
-
-// Parse and run
+#!/usr/bin/env node
+
+/**
+ * ClawVault CLI 🐘
+ * An elephant never forgets.
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import * as fs from 'fs';
+import * as path from 'path';
+import { registerMaintenanceCommands } from './register-maintenance-commands.js';
+import { registerCoreCommands } from './register-core-commands.js';
+import { registerQueryCommands } from './register-query-commands.js';
+import { registerResilienceCommands } from './register-resilience-commands.js';
+import { registerSessionLifecycleCommands } from './register-session-lifecycle-commands.js';
+import { registerTemplateCommands } from './register-template-commands.js';
+import { registerVaultOperationsCommands } from './register-vault-operations-commands.js';
+import { registerConfigCommands } from './register-config-commands.js';
+import { registerRouteCommands } from './register-route-commands.js';
+import { registerKanbanCommands } from './register-kanban-commands.js';
+import { registerProjectCommands } from './register-project-commands.js';
+
+import { registerTaskCommands } from './register-task-commands.js';
+
+import { registerTailscaleCommands } from './register-tailscale-commands.js';
+import {
+  getVault,
+  resolveVaultPath,
+  runQmd,
+  printQmdMissing,
+  QmdUnavailableError
+} from './command-runtime.js';
+import {
+  createVault
+} from '../dist/index.js';
+
+const program = new Command();
+
+const CLI_VERSION = (() => {
+  try {
+    const pkgUrl = new URL('../package.json', import.meta.url);
+    const pkg = JSON.parse(fs.readFileSync(pkgUrl, 'utf-8'));
+    return pkg.version || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+})();
+
+program
+  .name('clawvault')
+  .description('🐘 An elephant never forgets. Structured memory for AI agents.')
+  .version(CLI_VERSION);
+
+registerCoreCommands(program, {
+  chalk,
+  path,
+  fs,
+  createVault,
+  getVault,
+  runQmd
+});
+
+registerQueryCommands(program, {
+  chalk,
+  getVault,
+  resolveVaultPath,
+  QmdUnavailableError,
+  printQmdMissing
+});
+
+registerSessionLifecycleCommands(program, {
+  chalk,
+  resolveVaultPath,
+  QmdUnavailableError,
+  printQmdMissing,
+  getVault,
+  runQmd
+});
+
+registerTemplateCommands(program, { chalk });
+registerMaintenanceCommands(program, { chalk });
+registerResilienceCommands(program, { chalk, resolveVaultPath });
+registerVaultOperationsCommands(program, {
+  chalk,
+  fs,
+  getVault,
+  runQmd,
+  resolveVaultPath,
+  path
+});
+
+
+registerTaskCommands(program, {
+  chalk,
+  resolveVaultPath
+});
+registerKanbanCommands(program, {
+  chalk,
+  resolveVaultPath
+});
+registerProjectCommands(program, {
+  chalk,
+  resolveVaultPath
+});
+
+registerTailscaleCommands(program, { chalk });
+registerConfigCommands(program, { chalk, resolveVaultPath });
+registerRouteCommands(program, { chalk, resolveVaultPath });
+
+// Parse and run
 program.parse();