clawvault 2.1.2 → 2.2.1

package/bin/command-registration.test.js

@@ -47,7 +47,7 @@ describe('CLI command registration modules', () => {
     });
 
     const names = listCommandNames(program);
-    expect(names).toEqual(expect.arrayContaining(['search', 'vsearch', 'context', 'observe', 'session-recap']));
+    expect(names).toEqual(expect.arrayContaining(['search', 'vsearch', 'context', 'observe', 'reflect', 'session-recap']));
 
     const contextCommand = program.commands.find((command) => command.name() === 'context');
     const profileOption = contextCommand?.options.find((option) => option.flags.includes('--profile <profile>'));
@@ -115,6 +115,11 @@ describe('CLI command registration modules', () => {
       'graph',
       'entities',
       'link',
+      'rebuild',
+      'archive',
+      'migrate-observations',
+      'replay',
+      'sync-bd',
       'checkpoint',
       'recover',
       'status',

package/bin/help-contract.test.js

@@ -8,6 +8,8 @@ describe('CLI help contract', () => {
     expect(help).toContain('context');
     expect(help).toContain('compat');
     expect(help).toContain('graph');
+    expect(help).toContain('reflect');
+    expect(help).toContain('replay');
     expect(help).toContain('repair-session');
     expect(help).toContain('template');
   });

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/bin/register-maintenance-commands.js

@@ -134,4 +134,115 @@ export function registerMaintenanceCommands(program, { chalk }) {
         process.exit(1);
       }
     });
+
+  // === REBUILD ===
+  program
+    .command('rebuild')
+    .description('Rebuild observations from ledger/raw transcripts')
+    .option('--from <date>', 'Start date (YYYY-MM-DD)')
+    .option('--to <date>', 'End date (YYYY-MM-DD)')
+    .option('-v, --vault <path>', 'Vault path')
+    .action(async (options) => {
+      try {
+        const { rebuildCommand } = await import('../dist/commands/rebuild.js');
+        await rebuildCommand({
+          vaultPath: options.vault,
+          from: options.from,
+          to: options.to
+        });
+      } catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+      }
+    });
+
+  // === ARCHIVE ===
+  program
+    .command('archive')
+    .description('Archive old observations into ledger/archive')
+    .option('--older-than <days>', 'Archive observations older than this many days', '14')
+    .option('--dry-run', 'Show archive candidates without writing')
+    .option('-v, --vault <path>', 'Vault path')
+    .action(async (options) => {
+      try {
+        const { archiveCommand } = await import('../dist/commands/archive.js');
+        const olderThan = Number.parseInt(options.olderThan, 10);
+        if (!Number.isFinite(olderThan) || olderThan <= 0) {
+          throw new Error(`Invalid --older-than value: ${options.olderThan}`);
+        }
+        await archiveCommand({
+          vaultPath: options.vault,
+          olderThan,
+          dryRun: options.dryRun
+        });
+      } catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+      }
+    });
+
+  // === MIGRATE-OBSERVATIONS ===
+  program
+    .command('migrate-observations')
+    .description('Convert legacy emoji observations to scored format')
+    .option('--dry-run', 'Show migration candidates without writing')
+    .option('-v, --vault <path>', 'Vault path')
+    .action(async (options) => {
+      try {
+        const { migrateObservationsCommand } = await import('../dist/commands/migrate-observations.js');
+        await migrateObservationsCommand({
+          vaultPath: options.vault,
+          dryRun: options.dryRun
+        });
+      } catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+      }
+    });
+
+  // === REPLAY ===
+  program
+    .command('replay')
+    .description('Replay historical conversation exports through observe pipeline')
+    .requiredOption('--source <platform>', 'Source platform (chatgpt|claude|opencode|openclaw)')
+    .requiredOption('--input <path>', 'Input export file or directory')
+    .option('--from <date>', 'Start date (YYYY-MM-DD)')
+    .option('--to <date>', 'End date (YYYY-MM-DD)')
+    .option('--dry-run', 'Preview replay candidates without writing')
+    .option('-v, --vault <path>', 'Vault path')
+    .action(async (options) => {
+      try {
+        const { replayCommand } = await import('../dist/commands/replay.js');
+        await replayCommand({
+          source: options.source,
+          inputPath: options.input,
+          from: options.from,
+          to: options.to,
+          dryRun: options.dryRun,
+          vaultPath: options.vault
+        });
+      } catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+      }
+    });
+
+  // === SYNC-BD ===
+  program
+    .command('sync-bd')
+    .description('Sync active Beads tasks into views/now.md (optional)')
+    .option('--dry-run', 'Show sync output without writing')
+    .option('-v, --vault <path>', 'Vault path')
+    .action(async (options) => {
+      try {
+        const { syncBdCommand } = await import('../dist/commands/sync-bd.js');
+        await syncBdCommand({
+          vaultPath: options.vault,
+          dryRun: options.dryRun
+        });
+      } catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+      }
+    });
 }

package/bin/register-query-commands.js

@@ -132,15 +132,20 @@ export function registerQueryCommands(
     .option('--include-observations', 'Include observation memories in output', true)
     .option('--budget <number>', 'Optional token budget for assembled context')
     .option('--profile <profile>', 'Context profile (default|planning|incident|handoff|auto)', 'default')
+    .option('--max-hops <n>', 'Maximum graph expansion hops', '2')
     .option('-v, --vault <path>', 'Vault path')
     .action(async (task, options) => {
       try {
         const vaultPath = resolveVaultPath(options.vault);
         const format = options.format === 'json' ? 'json' : 'markdown';
         const parsedBudget = options.budget ? Number.parseInt(options.budget, 10) : undefined;
+        const parsedMaxHops = Number.parseInt(options.maxHops, 10);
         if (options.budget && (!Number.isFinite(parsedBudget) || parsedBudget <= 0)) {
           throw new Error(`Invalid --budget value: ${options.budget}`);
         }
+        if (!Number.isFinite(parsedMaxHops) || parsedMaxHops <= 0) {
+          throw new Error(`Invalid --max-hops value: ${options.maxHops}`);
+        }
 
         const { contextCommand } = await import('../dist/commands/context.js');
         await contextCommand(task, {
@@ -150,7 +155,8 @@ export function registerQueryCommands(
           recent: options.recent,
           includeObservations: options.includeObservations,
           budget: parsedBudget,
-          profile: options.profile
+          profile: options.profile,
+          maxHops: parsedMaxHops
         });
       } catch (err) {
         if (err instanceof QmdUnavailableError) {
@@ -216,6 +222,31 @@ export function registerQueryCommands(
       }
     });
 
+  // === REFLECT ===
+  program
+    .command('reflect')
+    .description('Promote stable observations into weekly reflections')
+    .option('--days <n>', 'Observation window in days', '14')
+    .option('--dry-run', 'Show reflection output candidates without writing')
+    .option('-v, --vault <path>', 'Vault path')
+    .action(async (options) => {
+      try {
+        const { reflectCommand } = await import('../dist/commands/reflect.js');
+        const days = Number.parseInt(options.days, 10);
+        if (!Number.isFinite(days) || days <= 0) {
+          throw new Error(`Invalid --days value: ${options.days}`);
+        }
+        await reflectCommand({
+          vaultPath: resolveVaultPath(options.vault),
+          days,
+          dryRun: options.dryRun
+        });
+      } catch (err) {
+        console.error(chalk.red(`Error: ${err.message}`));
+        process.exit(1);
+      }
+    });
+
   // === SESSION-RECAP ===
   program
     .command('session-recap <sessionKey>')

package/bin/register-session-lifecycle-commands.js

@@ -54,6 +54,7 @@ export function registerSessionLifecycleCommands(
     .option('-f, --feeling <state>', 'Emotional/energy state')
     .option('-s, --session <key>', 'Session key')
     .option('--session-transcript <path>', 'Session transcript path for auto-observe')
+    .option('--reflect', 'Run weekly reflection pass after sleep handoff')
     .option('--index', 'Update qmd index after handoff')
     .option('--no-git', 'Skip git commit prompt')
     .option('-v, --vault <path>', 'Vault path')
@@ -70,6 +71,7 @@ export function registerSessionLifecycleCommands(
           feeling: options.feeling,
           sessionKey: options.session,
           sessionTranscript: options.sessionTranscript,
+          reflect: options.reflect,
           vaultPath,
           index: options.index,
           git: options.git