clawvault 3.4.1 → 3.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -267,24 +267,23 @@ clawvault setup --theme neural --canvas --bases
267
267
 
268
268
  ## OpenClaw Integration
269
269
 
270
- ClawVault integrates with OpenClaw as a plugin package (not the deprecated `openclaw hooks install/enable` flow):
270
+ For hook-based lifecycle integration with OpenClaw:
271
271
 
272
272
  ```bash
273
- # Install ClawVault
274
- npm install -g clawvault
275
-
276
- # Add ClawVault package path to plugins.load.paths in openclaw.json
277
- # (You can use `npm root -g` to locate node_modules)
273
+ # Install and enable hook pack
274
+ openclaw hooks install clawvault
275
+ openclaw hooks enable clawvault
278
276
 
279
- # Enable plugin + memory slot in openclaw.json:
280
- # plugins.slots.memory = "clawvault"
281
- # plugins.entries.clawvault.enabled = true
282
-
283
- # Verify runtime assumptions
277
+ # Verify
278
+ openclaw hooks list --verbose
279
+ openclaw hooks check
284
280
  clawvault compat
285
281
  ```
286
282
 
287
- The plugin provides lifecycle hooks, memory tools, and protocol-safe messaging behavior for OpenClaw sessions.
283
+ The hook automatically:
284
+ - Detects context death and injects recovery alerts
285
+ - Auto-checkpoints before session resets
286
+ - Provides `--profile auto` for context queries
288
287
 
289
288
  ### MEMORY.md vs Vault
290
289
 
@@ -352,26 +351,27 @@ clawvault compat
352
351
 
353
352
  ## OpenClaw Setup (Canonical)
354
353
 
355
- Use this sequence for plugin-based OpenClaw integration:
354
+ If you want hook-based lifecycle integration, use this sequence:
356
355
 
357
356
  ```bash
358
357
  # Install CLI
359
358
  npm install -g clawvault
360
359
 
361
- # Locate global node_modules
362
- npm root -g
360
+ # Install and enable hook pack
361
+ openclaw hooks install clawvault
362
+ openclaw hooks enable clawvault
363
363
 
364
- # In openclaw.json:
365
- # - add <npm-root>/clawvault to plugins.load.paths
366
- # - set plugins.slots.memory = "clawvault"
367
- # - set plugins.entries.clawvault.enabled = true
368
- # - set plugins.entries.clawvault.config.vaultPath as needed
364
+ # Verify
365
+ openclaw hooks list --verbose
366
+ openclaw hooks info clawvault
367
+ openclaw hooks check
368
+ clawvault compat
369
369
  ```
370
370
 
371
371
  Important:
372
372
 
373
- - `clawhub install clawvault` installs skill guidance, but does not configure OpenClaw plugin loading.
374
- - After changing plugin config, restart the OpenClaw gateway process.
373
+ - `clawhub install clawvault` installs skill guidance, but does not replace hook-pack installation.
374
+ - After enabling hooks, restart the OpenClaw gateway process so hook registration reloads.
375
375
 
376
376
  ## Minimal AGENTS.md Additions
377
377
 
@@ -488,10 +488,10 @@ vault/
488
488
  - `qmd` fallback errors:
489
489
  - `qmd` is optional; in-process BM25 search is available without it
490
490
  - if you want fallback compatibility, ensure `qmd --version` works in the same shell
491
- - Plugin not active in OpenClaw:
492
- - verify `plugins.load.paths` includes the ClawVault package path
493
- - verify `plugins.slots.memory` is `clawvault`
494
- - verify `plugins.entries.clawvault.enabled` is `true`
491
+ - Hook/plugin not active in OpenClaw:
492
+ - run `openclaw hooks install clawvault`
493
+ - run `openclaw hooks enable clawvault`
494
+ - verify with `openclaw hooks list --verbose`
495
495
  - OpenClaw integration drift:
496
496
  - run `clawvault compat`
497
497
  - Session transcript corruption:
@@ -6,13 +6,13 @@ import {
6
6
  } from "./chunk-DOIUYIXV.js";
7
7
  import {
8
8
  registerInjectCommand
9
- } from "./chunk-OFOCU2V4.js";
9
+ } from "./chunk-QL34TMGN.js";
10
10
  import {
11
11
  registerMaintainCommand
12
- } from "./chunk-D5U3Q4N5.js";
12
+ } from "./chunk-IOKLQR4W.js";
13
13
  import {
14
14
  registerObserveCommand
15
- } from "./chunk-BLQXXX7Q.js";
15
+ } from "./chunk-FNFP7N6A.js";
16
16
  import {
17
17
  registerContextCommand
18
18
  } from "./chunk-GFCHWMGD.js";
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  observeActiveSessions
3
- } from "./chunk-VXAGOLDP.js";
3
+ } from "./chunk-LCBHM3D6.js";
4
4
  import {
5
5
  Observer
6
- } from "./chunk-7SWP5FKU.js";
6
+ } from "./chunk-FSYISBTU.js";
7
7
  import {
8
8
  resolveVaultPath
9
9
  } from "./chunk-GJO3CFUN.js";
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  Observer
3
- } from "./chunk-7SWP5FKU.js";
3
+ } from "./chunk-FSYISBTU.js";
4
4
  import {
5
5
  resolveVaultPath
6
6
  } from "./chunk-GJO3CFUN.js";
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  Observer
3
- } from "./chunk-7SWP5FKU.js";
3
+ } from "./chunk-FSYISBTU.js";
4
4
  import {
5
5
  getSessionsDir
6
6
  } from "./chunk-HRLWZGMA.js";
@@ -1,9 +1,9 @@
1
+ import {
2
+ Observer
3
+ } from "./chunk-FSYISBTU.js";
1
4
  import {
2
5
  runReflection
3
6
  } from "./chunk-TWMI3SNN.js";
4
- import {
5
- Observer
6
- } from "./chunk-7SWP5FKU.js";
7
7
  import {
8
8
  resolveVaultPath
9
9
  } from "./chunk-GJO3CFUN.js";