@sparkleideas/claude-flow-patch 3.1.0-alpha.44.patch.8 → 3.1.0-alpha.44.patch.9

package/CLAUDE.md

@@ -325,6 +325,7 @@ Both are idempotent: skip if `new` already present, warn if `old` not found.
 | `EXECUTOR` | `init/executor.js` | @claude-flow/cli |
 | `INIT_CMD` | `commands/init.js` | @claude-flow/cli |
 | `START_CMD` | `commands/start.js` | @claude-flow/cli |
+| `CMDS_INDEX` | `commands/index.js` | @claude-flow/cli |
 | `ruvector_cli` | `bin/cli.js` | ruvector |
 
 To target a new file, add a variable to `lib/common.py` following the existing pattern.

package/lib/common.py

@@ -84,6 +84,7 @@ EXECUTOR = init + "/executor.js" if init else ""
 TYPES = init + "/types.js" if init else ""
 INIT_CMD = commands + "/init.js" if commands else ""
 START_CMD = commands + "/start.js" if commands else ""
+CMDS_INDEX = commands + "/index.js" if commands else ""
 
 # Source helpers (shipped with package, copied by writeHelpers when source dir found)
 _pkg_root = os.path.dirname(os.path.dirname(base)) if base else ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sparkleideas/claude-flow-patch",
-  "version": "3.1.0-alpha.44.patch.8",
+  "version": "3.1.0-alpha.44.patch.9",
   "description": "Patch toolkit for @claude-flow/cli init/runtime defects with verify and post-init repair commands",
   "scripts": {
     "preflight": "node scripts/preflight.mjs",

package/patch/320-SG-004-wizard-parity/README.md

@@ -9,12 +9,13 @@ The `wizardCommand.action` in `commands/init.js` was implemented as a
 standalone code path that diverges from the parent `initAction`. It skips the
 already-initialized guard, ignores `--force`, `--start-all`, `--start-daemon`,
 `--codex`, and `--dual` flags, and never shows "Next steps" hints. The wizard
-is conceptually "init with interactive value selection" but behaves as a
-completely separate command.
+is also only reachable as a subcommand of `init` with no `options` array, so
+the parser cannot validate flags for the wizard context.
 
 ## Fix
 
-Four ops bring the wizard to full parity with `init`:
+Ten ops bring the wizard to full parity with `init` and promote it to a
+top-level command (`claude-flow wizard`):
 
 | Op | What it does |
 |----|-------------|
@@ -22,11 +23,18 @@ Four ops bring the wizard to full parity with `init`:
 | SG-004b | Adds `--codex`/`--dual` handling after executeInit succeeds |
 | SG-004c | Adds `--start-all`/`--start-daemon` service startup + "Next steps" hints |
 | SG-004d | Fixes catch block — catches errors cleanly instead of re-throwing |
+| SG-004e | Exports `wizardCommand` from init.js, adds `options` + `examples` arrays |
+| SG-004f | Imports `wizardCommand` in the command registry (`commands/index.js`) |
+| SG-004g | Adds wizard to `commandLoaders` for lazy-loading |
+| SG-004h | Pre-populates wizard in the loaded commands cache |
+| SG-004i | Adds `wizardCommand` to the `commands` array (parser registration) |
+| SG-004j | Adds `wizardCommand` to `commandsByCategory.primary` for help display |
 
 ## Files Patched
 
 - `commands/init.js`
+- `commands/index.js`
 
 ## Ops
 
-4 ops in fix.py
+10 ops in fix.py

package/patch/320-SG-004-wizard-parity/fix.py

@@ -3,10 +3,14 @@
 #
 # The wizard was implemented as a standalone code path that ignores
 # --force, --start-all, --start-daemon, --codex, --dual, and skips
-# the already-initialized guard and "Next steps" hints.
+# the already-initialized guard and "Next steps" hints. It is also only
+# reachable as a subcommand of `init` with no options array, so the parser
+# cannot validate flags for the wizard context.
 #
-# 4 ops: init-guard + force (a), codex/dual (b), start-all + next-steps (c),
-#         catch-block error handling (d)
+# 10 ops: init-guard + force (a), codex/dual (b), start-all + next-steps (c),
+#          catch-block error handling (d), export + options (e),
+#          import in registry (f), loaders (g), cache (h),
+#          commands array (i), category (j)
 
 # Op 1: Add already-initialized guard + pass --force to executeInit options
 patch("SG-004a: wizard init-guard + --force",
@@ -131,3 +135,74 @@ patch("SG-004d: wizard catch block handles errors cleanly",
             }
             output.printError(`Failed to initialize: ${error instanceof Error ? error.message : String(error)}`);
             return { success: false, exitCode: 1 };""")
+
+# ── Promote wizard to top-level command ──
+# Ops e–j: export wizardCommand with options, register in command registry
+
+# Op 5: Export wizardCommand + add options/examples arrays
+patch("SG-004e: export wizardCommand with options",
+    INIT_CMD,
+    """// Wizard subcommand for interactive setup
+const wizardCommand = {
+    name: 'wizard',
+    description: 'Interactive setup wizard for comprehensive configuration',
+    action: async (ctx) => {""",
+    """// Wizard — top-level command + init subcommand — SG-004
+export const wizardCommand = {
+    name: 'wizard',
+    aliases: ['wiz'],
+    description: 'Interactive setup wizard for comprehensive configuration',
+    options: [
+        { name: 'force', short: 'f', description: 'Overwrite existing configuration', type: 'boolean', default: false },
+        { name: 'start-all', description: 'Auto-start daemon, memory, and swarm after init', type: 'boolean', default: false },
+        { name: 'start-daemon', description: 'Auto-start daemon after init', type: 'boolean', default: false },
+        { name: 'codex', description: 'Initialize for OpenAI Codex CLI', type: 'boolean', default: false },
+        { name: 'dual', description: 'Initialize for both Claude Code and Codex', type: 'boolean', default: false },
+        { name: 'with-embeddings', description: 'Initialize ONNX embedding subsystem', type: 'boolean', default: false },
+        { name: 'embedding-model', description: 'ONNX embedding model', type: 'string', default: 'all-MiniLM-L6-v2', choices: ['all-MiniLM-L6-v2', 'all-mpnet-base-v2'] },
+    ],
+    examples: [
+        { command: 'claude-flow wizard', description: 'Run interactive setup wizard' },
+        { command: 'claude-flow wizard --start-all', description: 'Wizard then start all services' },
+        { command: 'claude-flow wizard --force', description: 'Reinitialize with wizard' },
+        { command: 'claude-flow wizard --codex', description: 'Wizard with Codex integration' },
+    ],
+    action: async (ctx) => {""")
+
+# Op 6: Import wizardCommand in command registry
+patch("SG-004f: import wizardCommand in command registry",
+    CMDS_INDEX,
+    """import { initCommand } from './init.js';""",
+    """import { initCommand, wizardCommand } from './init.js';""")
+
+# Op 7: Add wizard to commandLoaders for lazy loading
+patch("SG-004g: add wizard to commandLoaders",
+    CMDS_INDEX,
+    """    init: () => import('./init.js'),""",
+    """    init: () => import('./init.js'),
+    wizard: () => import('./init.js'),""")
+
+# Op 8: Pre-populate wizard in loadedCommands cache
+patch("SG-004h: cache wizard command",
+    CMDS_INDEX,
+    """loadedCommands.set('init', initCommand);""",
+    """loadedCommands.set('init', initCommand);
+loadedCommands.set('wizard', wizardCommand);""")
+
+# Op 9: Add wizardCommand to commands array (triggers parser registration)
+patch("SG-004i: register wizard in commands array",
+    CMDS_INDEX,
+    """    initCommand,
+    startCommand,""",
+    """    initCommand,
+    wizardCommand,
+    startCommand,""")
+
+# Op 10: Add wizardCommand to commandsByCategory.primary for help display
+patch("SG-004j: add wizard to primary category",
+    CMDS_INDEX,
+    """    primary: [
+        initCommand,""",
+    """    primary: [
+        initCommand,
+        wizardCommand,""")

package/patch/320-SG-004-wizard-parity/sentinel

@@ -1 +1,3 @@
 grep "SG-004" commands/init.js
+grep "export const wizardCommand" commands/init.js
+grep "wizardCommand" commands/index.js