@superdesign/cli 0.1.9 → 0.1.10

package/dist/index.cjs

@@ -875,7 +875,17 @@ superdesign --help
         };
     }
     function createIterateDesignDraftCommand() {
-        const command = new external_commander_namespaceObject.Command('iterate-design-draft').description('Generate design based on existing draft or template, the main design exploration tool').requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--json', 'Output in JSON format').addOption(new external_commander_namespaceObject.Option('--project-id <id>').hideHelp()).action(async (options)=>{
+        const command = new external_commander_namespaceObject.Command('iterate-design-draft').description(`Generate design based on existing draft or template, the main design exploration tool
+
+Usage Examples:
+  # Iterate: replace mode (single variation, updates in place)
+  superdesign iterate-design-draft --draft-id <id> -p "..." --mode replace --json
+
+  # Iterate: Explore multiple versions & variations (each prompt = one variation, prompt should be just directional, do not specify color, style, let superdesign design expert fill in details, you just give direction)
+  superdesign iterate-design-draft --draft-id <id> -p "dark theme" -p "minimal" -p "bold" --mode branch --json
+
+  # Iterate: Auto explore (only give exploration direction, and let Superdesign fill in details, e.g. explore different styles; Default do NOT use auto explore mode)
+  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--json', 'Output in JSON format').addOption(new external_commander_namespaceObject.Option('--project-id <id>').hideHelp()).action(async (options)=>{
             if (options.json) setJsonMode(true);
             job_runner_requireAuth(manager_isAuthenticated);
             const { prompts, count, mode } = validateOptions(options);

package/dist/index.js

@@ -785,7 +785,17 @@ function validateOptions(options) {
     };
 }
 function createIterateDesignDraftCommand() {
-    const command = new Command('iterate-design-draft').description('Generate design based on existing draft or template, the main design exploration tool').requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--json', 'Output in JSON format').addOption(new Option('--project-id <id>').hideHelp()).action(async (options)=>{
+    const command = new Command('iterate-design-draft').description(`Generate design based on existing draft or template, the main design exploration tool
+
+Usage Examples:
+  # Iterate: replace mode (single variation, updates in place)
+  superdesign iterate-design-draft --draft-id <id> -p "..." --mode replace --json
+
+  # Iterate: Explore multiple versions & variations (each prompt = one variation, prompt should be just directional, do not specify color, style, let superdesign design expert fill in details, you just give direction)
+  superdesign iterate-design-draft --draft-id <id> -p "dark theme" -p "minimal" -p "bold" --mode branch --json
+
+  # Iterate: Auto explore (only give exploration direction, and let Superdesign fill in details, e.g. explore different styles; Default do NOT use auto explore mode)
+  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--json', 'Output in JSON format').addOption(new Option('--project-id <id>').hideHelp()).action(async (options)=>{
         if (options.json) setJsonMode(true);
         job_runner_requireAuth(manager_isAuthenticated);
         const { prompts, count, mode } = validateOptions(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdesign/cli",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "CLI for SuperDesign Platform - agent skills for Claude Code",
   "type": "module",
   "main": "./dist/index.cjs",