specweave 1.0.586 → 1.0.588

package/bin/specweave.js

@@ -377,6 +377,36 @@ program
     await createIncrementCommand(options);
   });
 
+// Handoff command - Assemble a portable cross-tool work-handoff doc + diff
+program
+  .command('handoff [incrementId]')
+  .description('Write a portable, secret-scrubbed work-handoff doc + diff so you can resume in another AI tool')
+  .option('--reason <reason>', 'Why you are handing off (e.g. "out of tokens")')
+  .option('--summary <summary>', 'Short summary of where things stand')
+  .option('--next <next>', 'The exact next step for the resuming agent')
+  .option('--gotcha <gotcha>', 'A gotcha / warning for the next agent')
+  .option('--decision <decision>', 'A key decision (repeatable)', (val, acc) => { (acc || []).push(val); return acc || [val]; }, [])
+  .option('--inline', 'Embed the full scrubbed doc body in the paste-prompt (cross-machine resume)')
+  .option('--clipboard', 'Alias for --inline')
+  .option('--non-specweave', 'Force the .handoff/ fallback even inside a SpecWeave workspace')
+  .option('--out <path>', 'Override the doc output path')
+  .option('--json', 'Output the full result as JSON (for programmatic use)')
+  .action(async (incrementId, options) => {
+    const { handoffCommand } = await import('../dist/src/cli/commands/handoff.js');
+    await handoffCommand({
+      incrementId,
+      reason: options.reason,
+      summary: options.summary,
+      next: options.next,
+      gotcha: options.gotcha,
+      decision: options.decision,
+      inline: options.inline || options.clipboard,
+      nonSpecweave: options.nonSpecweave,
+      out: options.out,
+      json: options.json,
+    });
+  });
+
 // Next ID command - Return the next available increment number
 program
   .command('next-id')