clawvault 2.1.1 → 2.2.0

package/dist/index.js

@@ -1,27 +1,60 @@
+import {
+  buildSessionRecap,
+  formatSessionRecapMarkdown,
+  sessionRecapCommand
+} from "./chunk-ZKGY7WTT.js";
+import {
+  setupCommand
+} from "./chunk-KNDVXXKC.js";
+import {
+  registerSyncBdCommand,
+  syncBdCommand
+} from "./chunk-MGDEINGP.js";
 import {
   buildTemplateVariables,
   renderTemplate
 } from "./chunk-7766SIJP.js";
+import {
+  migrateObservations,
+  migrateObservationsCommand,
+  registerMigrateObservationsCommand
+} from "./chunk-WZI3OAE5.js";
 import {
   SessionWatcher,
   observeCommand,
   registerObserveCommand
-} from "./chunk-UPHUI5PD.js";
+} from "./chunk-LB6P4CD5.js";
 import {
-  buildSessionRecap,
-  formatSessionRecapMarkdown,
-  sessionRecapCommand
-} from "./chunk-ZKGY7WTT.js";
+  parseSessionFile
+} from "./chunk-P5EPF6MB.js";
+import {
+  rebuildCommand,
+  registerRebuildCommand
+} from "./chunk-73P7XCQM.js";
+import {
+  reflectCommand,
+  registerReflectCommand
+} from "./chunk-GJEGPO7U.js";
 import "./chunk-HRLWZGMA.js";
 import {
-  setupCommand
-} from "./chunk-PIJGYMQZ.js";
+  registerReplayCommand,
+  replayCommand
+} from "./chunk-L6NB43WV.js";
 import {
   Compressor,
   Observer,
-  Reflector,
-  parseSessionFile
-} from "./chunk-USAY3OIO.js";
+  Reflector
+} from "./chunk-2HM7ZI4X.js";
+import {
+  runReflection
+} from "./chunk-GQVYQCY5.js";
+import {
+  archiveCommand,
+  registerArchiveCommand
+} from "./chunk-VR5NE7PZ.js";
+import {
+  archiveObservations
+} from "./chunk-MQUJNOHK.js";
 import {
   buildContext,
   contextCommand,
@@ -30,7 +63,9 @@ import {
   normalizeContextProfileInput,
   registerContextCommand,
   resolveContextProfile
-} from "./chunk-TBVI4N53.js";
+} from "./chunk-6RIHODNR.js";
+import "./chunk-K6XHCUFL.js";
+import "./chunk-Z2XBWN7A.js";
 import {
   checkOpenClawCompatibility,
   compatCommand,
@@ -40,7 +75,7 @@ import {
   ClawVault,
   createVault,
   findVault
-} from "./chunk-QFBKWDYR.js";
+} from "./chunk-IFGDPIFI.js";
 import {
   DEFAULT_CATEGORIES,
   DEFAULT_CONFIG,
@@ -55,17 +90,17 @@ import {
   hasQmd,
   qmdEmbed,
   qmdUpdate
-} from "./chunk-MIIXBNO3.js";
+} from "./chunk-DHBDH4DN.js";
 import {
   graphCommand,
   graphSummary
-} from "./chunk-TXO34J3O.js";
+} from "./chunk-H7JW4L7H.js";
 import {
   MEMORY_GRAPH_SCHEMA_VERSION,
   buildOrUpdateMemoryGraphIndex,
   getMemoryGraph,
   loadMemoryGraphIndex
-} from "./chunk-O5V7SD5C.js";
+} from "./chunk-ZZA73MFY.js";
 import {
   findNearestVaultPath,
   getVaultPath,
@@ -87,6 +122,7 @@ var VERSION = readPackageVersion();
 function registerCommanderCommands(program) {
   registerContextCommand(program);
   registerObserveCommand(program);
+  registerReflectCommand(program);
   return program;
 }
 export {
@@ -105,6 +141,8 @@ export {
   SessionWatcher,
   TYPE_TO_CATEGORY,
   VERSION,
+  archiveCommand,
+  archiveObservations,
   buildContext,
   buildOrUpdateMemoryGraphIndex,
   buildSessionRecap,
@@ -127,17 +165,30 @@ export {
   hasQmd,
   inferContextProfile,
   loadMemoryGraphIndex,
+  migrateObservations,
+  migrateObservationsCommand,
   normalizeContextProfileInput,
   observeCommand,
   parseSessionFile,
   qmdEmbed,
   qmdUpdate,
+  rebuildCommand,
+  reflectCommand,
+  registerArchiveCommand,
   registerCommanderCommands,
   registerContextCommand,
+  registerMigrateObservationsCommand,
   registerObserveCommand,
+  registerRebuildCommand,
+  registerReflectCommand,
+  registerReplayCommand,
+  registerSyncBdCommand,
   renderTemplate,
+  replayCommand,
   resolveContextProfile,
   resolveVaultPath,
+  runReflection,
   sessionRecapCommand,
-  setupCommand
+  setupCommand,
+  syncBdCommand
 };

package/hooks/clawvault/HOOK.md

@@ -4,7 +4,7 @@ description: "Context resilience - recovery detection, auto-checkpoint, and sess
 metadata:
   openclaw:
     emoji: "🐘"
-    events: ["gateway:startup", "gateway:heartbeat", "command:new", "session:start", "compaction:memoryFlush"]
+    events: ["gateway:startup", "gateway:heartbeat", "command:new", "session:start", "compaction:memoryFlush", "cron.weekly"]
     requires:
       bins: ["clawvault"]
 ---
@@ -18,6 +18,7 @@ Integrates ClawVault's context death resilience into OpenClaw:
 - **On /new command**: Auto-checkpoints before session reset
 - **On context compaction**: Forces incremental observation flush before context is lost
 - **On session start**: Injects relevant vault context for the initial prompt
+- **On weekly cron**: Runs `clawvault reflect` every Sunday midnight (UTC)
 
 ## Installation
 
@@ -63,7 +64,7 @@ Injection format:
 
 ### Event Compatibility
 
-The hook accepts canonical OpenClaw events (`gateway:startup`, `gateway:heartbeat`, `command:new`, `session:start`, `compaction:memoryFlush`) and tolerates alias payload shapes (`event`, `eventName`, `name`, `hook`, `trigger`) to remain robust across runtime wrappers.
+The hook accepts canonical OpenClaw events (`gateway:startup`, `gateway:heartbeat`, `command:new`, `session:start`, `compaction:memoryFlush`, `cron.weekly`) and tolerates alias payload shapes (`event`, `eventName`, `name`, `hook`, `trigger`) to remain robust across runtime wrappers.
 
 ## No Configuration Needed
 

package/hooks/clawvault/handler.js

@@ -544,6 +544,49 @@ function runActiveObservation(vaultPath, agentId, options = {}) {
   return true;
 }
 
+function extractEventTimestamp(event) {
+  const candidates = [
+    event?.timestamp,
+    event?.scheduledAt,
+    event?.time,
+    event?.context?.timestamp,
+    event?.context?.scheduledAt
+  ];
+  for (const candidate of candidates) {
+    if (!candidate) continue;
+    const parsed = new Date(candidate);
+    if (!Number.isNaN(parsed.getTime())) {
+      return parsed;
+    }
+  }
+  return null;
+}
+
+function isSundayMidnightUtc(date) {
+  return date.getUTCDay() === 0 && date.getUTCHours() === 0 && date.getUTCMinutes() === 0;
+}
+
+async function handleWeeklyReflect(event) {
+  const vaultPath = findVaultPath();
+  if (!vaultPath) {
+    console.log('[clawvault] No vault found, skipping weekly reflection');
+    return;
+  }
+
+  const timestamp = extractEventTimestamp(event) || new Date();
+  if (!isSundayMidnightUtc(timestamp)) {
+    console.log('[clawvault] Weekly reflect skipped (not Sunday midnight UTC)');
+    return;
+  }
+
+  const result = runClawvault(['reflect', '-v', vaultPath], { timeoutMs: 120000 });
+  if (!result.success) {
+    console.warn('[clawvault] Weekly reflection failed');
+    return;
+  }
+  console.log('[clawvault] Weekly reflection complete');
+}
+
 // Handle gateway startup - check for context death
 async function handleStartup(event) {
   const vaultPath = findVaultPath();
@@ -724,6 +767,14 @@ const handler = async (event) => {
       return;
     }
 
+    if (
+      eventMatches(event, 'cron', 'weekly')
+      || eventIncludesToken(event, 'cron:weekly')
+    ) {
+      await handleWeeklyReflect(event);
+      return;
+    }
+
     if (
       eventMatches(event, 'gateway', 'heartbeat')
       || eventMatches(event, 'session', 'heartbeat')

package/hooks/clawvault/handler.test.js

@@ -240,4 +240,24 @@ describe('clawvault hook handler', () => {
 
     fs.rmSync(vaultPath, { recursive: true, force: true });
   });
+
+  it('runs weekly reflection on cron.weekly at Sunday midnight', async () => {
+    const vaultPath = makeVaultFixture();
+    process.env.CLAWVAULT_PATH = vaultPath;
+    execFileSyncMock.mockReturnValue('');
+
+    const handler = await loadHandler();
+    await handler({
+      eventName: 'cron.weekly',
+      timestamp: '2026-02-15T00:00:00.000Z'
+    });
+
+    expect(execFileSyncMock).toHaveBeenCalledWith(
+      'clawvault',
+      expect.arrayContaining(['reflect', '-v', vaultPath]),
+      expect.objectContaining({ shell: false })
+    );
+
+    fs.rmSync(vaultPath, { recursive: true, force: true });
+  });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawvault",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "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",
@@ -29,7 +29,7 @@
     ]
   },
   "scripts": {
-    "build": "tsup src/index.ts src/commands/entities.ts src/commands/link.ts src/commands/checkpoint.ts src/commands/recover.ts src/commands/status.ts src/commands/template.ts src/commands/setup.ts src/commands/context.ts src/commands/observe.ts src/commands/session-recap.ts src/commands/wake.ts src/commands/sleep.ts src/commands/doctor.ts src/commands/compat.ts src/commands/graph.ts src/commands/shell-init.ts src/commands/repair-session.ts src/lib/entity-index.ts src/lib/auto-linker.ts src/lib/config.ts src/lib/template-engine.ts src/lib/session-utils.ts src/lib/session-repair.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/commands/entities.ts src/commands/link.ts src/commands/checkpoint.ts src/commands/recover.ts src/commands/status.ts src/commands/template.ts src/commands/setup.ts src/commands/context.ts src/commands/observe.ts src/commands/reflect.ts src/commands/archive.ts src/commands/rebuild.ts src/commands/replay.ts src/commands/migrate-observations.ts src/commands/sync-bd.ts src/commands/session-recap.ts src/commands/wake.ts src/commands/sleep.ts src/commands/doctor.ts src/commands/compat.ts src/commands/graph.ts src/commands/shell-init.ts src/commands/repair-session.ts src/lib/entity-index.ts src/lib/auto-linker.ts src/lib/config.ts src/lib/template-engine.ts src/lib/session-utils.ts src/lib/session-repair.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts src/commands/*.ts src/lib/*.ts --format esm --dts --watch",
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",