commander-wizard 0.0.2 → 0.0.3

package/README.md

@@ -126,8 +126,9 @@ a numeric default alone does not perform that conversion.
 
 ## Compatibility limits
 
-Use root-only or nested leaf actions with global scalar options, short flags,
-positive/negative boolean pairs, positional arguments, choices, and leaf variadics.
+Use global scalar options, short flags, positive/negative boolean pairs,
+positional arguments, choices, and leaf variadics. Actions are optional:
+commands that read `.opts()` after parsing work unchanged in wizard mode.
 
 In wizard mode, put the full command path before flags:
 `cli group command --wizard --flag=value`. Keep short flags separate; avoid `-abc` and
@@ -135,8 +136,8 @@ In wizard mode, put the full command path before flags:
 
 You cannot use these Commander features in wizard mode:
 
-- Executable subcommands, legacy command listeners, actions on commands with
-  children, or implicit/default subcommands.
+- Executable subcommands, implicit/default subcommands, or targeting commands
+  with children.
 - Ancestor positional arguments or variadic options, positional/pass-through
   option modes, or shadowed global option names/flags.
 - Environment-bound options, optional option values (`--color [value]`), presets,

package/dist/wizard.js

@@ -169,8 +169,9 @@ function checkLayout(chain, wizardKey) {
         }
     }
     const leaf = chain.at(-1);
-    if (leaf.commands.length || !Reflect.get(leaf, '_actionHandler'))
-        fail('select an explicit in-process action command. Legacy listeners are unsupported.');
+    // No action requirement: parse-then-.opts() CLIs work unchanged — the re-parse validates and populates.
+    if (leaf.commands.length)
+        fail('select an explicit leaf command; commands with children are ambiguous in wizard mode.');
 }
 function defaults(owner, config) {
     if (owner.defaultValue === undefined)
@@ -323,7 +324,8 @@ async function collect(input, config, wizardKey) {
             summary.push(`${arg.name()}: ${inspect(arg.variadic ? values : values[0])}`);
         }
         positional.push(...input.positionals.slice(cursor)); // let Commander report excess arguments
-        argv.push('--', ...positional);
+        if (positional.length)
+            argv.push('--', ...positional);
         const invocation = config.invocation ?? [process.execPath, ...process.execArgv, process.argv[1] ?? fail('provide invocation.')];
         const tokens = [...invocation, ...argv];
         if (tokens.some(token => token.includes('\0')))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commander-wizard",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Interactive wizard mode for commander CLIs — collect, review, and rerun command inputs",
   "keywords": [
     "commander",