wizz-method 2.11.2 → 2.13.0

package/tools/installer/ui.js

@@ -27,6 +27,9 @@ const { resolveMcps, partitionGloballyConfigured } = require('./modules/mcp-conf
 const { resolveClis, detectClis } = require('./modules/cli-config');
 const prompts = require('./prompts');
 const { parseSetEntries } = require('./set-overrides');
+const { isGuidedEligible, runGuidedInstall } = require('./guided/flow');
+const guidedSteps = require('./guided/steps');
+const { normalizeLang, t: guidedT } = require('./guided/messages');
 
 const manifest = new Manifest();
 
@@ -232,12 +235,21 @@ class UI {
    * @returns {Object} Installation configuration
    */
   async promptInstall(options = {}) {
-    await CLIUtils.displayLogo();
-
-    // Display version-specific start message from install-messages.yaml
-    const { MessageLoader } = require('./message-loader');
-    const messageLoader = new MessageLoader();
-    await messageLoader.displayStartMessage();
+    // Guided path (2026-09-25): first install in an interactive terminal with
+    // no scripting flags. The opening screen lists its four steps and the
+    // language comes first; everything else keeps the legacy flow.
+    const guided = isGuidedEligible(options);
+    let lang = normalizeLang(options.lang) || 'en';
+    await CLIUtils.displayLogo({ steps: guided, lang, version: installerPackageJson.version });
+
+    if (guided) {
+      if (!normalizeLang(options.lang)) lang = await guidedSteps.askLanguage();
+    } else {
+      // Display version-specific start message from install-messages.yaml
+      const { MessageLoader } = require('./message-loader');
+      const messageLoader = new MessageLoader();
+      await messageLoader.displayStartMessage();
+    }
 
     // Probe the local Python before any other prompts. Since audit item 29
     // (2026-09-12) this is INFORMATIONAL only: Node is the sole prerequisite
@@ -285,6 +297,9 @@ class UI {
       }
       confirmedDirectory = expandedDir;
       await prompts.log.info(`Using directory from command-line: ${confirmedDirectory}`);
+    } else if (guided) {
+      await guidedSteps.stepHeader(lang, 1);
+      confirmedDirectory = await guidedSteps.askDirectory(this, lang);
     } else {
       confirmedDirectory = await this.getConfirmedDirectory();
     }
@@ -297,6 +312,13 @@ class UI {
     // Track action type (only set if there's an existing installation)
     let actionType;
 
+    if (guided && !hasExistingInstall) {
+      return runGuidedInstall(this, options, { directory: confirmedDirectory, lang, channelOptions });
+    }
+    if (guided && hasExistingInstall) {
+      await prompts.log.info(guidedT(lang, 'existingFound'));
+    }
+
     // Only show action menu if there's an existing installation
     if (hasExistingInstall) {
       // Get version information
@@ -310,12 +332,16 @@ class UI {
         choices.push({
           name: 'Quick Update',
           value: 'quick-update',
-          hint: 'Atualiza só os módulos instalados. Não instala skills/MCPs/CLIs novos (use Modify Wizz Installation para isso)',
+          hint: 'Refresh the installed modules only; use Modify to add skills, MCPs or CLIs',
         });
       }
 
       // Common actions
-      choices.push({ name: 'Modify Wizz Installation', value: 'update' });
+      choices.push({
+        name: 'Modify Wizz Installation',
+        value: 'update',
+        hint: 'Add or remove modules and AI tools, and review the settings',
+      });
 
       // Check if action is provided via command-line
       if (options.action) {
@@ -703,7 +729,7 @@ class UI {
     if (options.yes) return { toWrite: [], toRecommend: resolved };
 
     const selected = await prompts.multiselect({
-      message: 'Quais MCPs configurar no .mcp.json? (não marcados viram comando pra rodar depois)',
+      message: options.mcpMessage || 'Quais MCPs configurar no .mcp.json? (não marcados viram comando pra rodar depois)',
       options: resolved.map((m) => ({
         label: m.id,
         value: m.id,
@@ -780,15 +806,24 @@ class UI {
     // PRE-CHECKED, so pressing enter installs them; everything else stays
     // unchecked. Nothing installs à revelia — a recommended entry can still be
     // unchecked here, and the --yes/non-TTY paths above never reach this.
+    // The guided installer passes its own message and option builder (short
+    // translated description + requirement badges instead of the raw `when`).
+    const defaultOption = (c) => ({
+      label: c.recommended ? `${c.id} (recomendado)` : c.id,
+      value: c.id,
+      // M27/M14: prefer the upgrade/verify-failure reason when present —
+      // more actionable than the generic `when` in those two cases.
+      hint: c.upgradeMessage || c.verifyWarning || c.when,
+    });
+    const buildOption = options.cliOption
+      ? (c) => {
+          const option = options.cliOption(c);
+          return c.upgradeMessage || c.verifyWarning ? { ...option, hint: c.upgradeMessage || c.verifyWarning } : option;
+        }
+      : defaultOption;
     const selected = await prompts.multiselect({
-      message: 'Quais CLIs instalar agora? (não marcados viram comando pra rodar depois)',
-      options: missing.map((c) => ({
-        label: c.recommended ? `${c.id} (recomendado)` : c.id,
-        value: c.id,
-        // M27/M14: prefer the upgrade/verify-failure reason when present —
-        // more actionable than the generic `when` in those two cases.
-        hint: c.upgradeMessage || c.verifyWarning || c.when,
-      })),
+      message: options.cliMessage || 'Quais CLIs instalar agora? (não marcados viram comando pra rodar depois)',
+      options: missing.map((c) => buildOption(c)),
       initialValues: missing.filter((c) => c.recommended).map((c) => c.id),
       required: false,
     });
@@ -1185,19 +1220,19 @@ class UI {
       const coreConfig = {};
       if (options.userName) {
         coreConfig.user_name = options.userName;
-        await prompts.log.info(`Using user name from command-line: ${options.userName}`);
+        if (!options.quiet) await prompts.log.info(`Using user name from command-line: ${options.userName}`);
       }
       if (options.communicationLanguage) {
         coreConfig.communication_language = options.communicationLanguage;
-        await prompts.log.info(`Using communication language from command-line: ${options.communicationLanguage}`);
+        if (!options.quiet) await prompts.log.info(`Using communication language from command-line: ${options.communicationLanguage}`);
       }
       if (options.documentOutputLanguage) {
         coreConfig.document_output_language = options.documentOutputLanguage;
-        await prompts.log.info(`Using document output language from command-line: ${options.documentOutputLanguage}`);
+        if (!options.quiet) await prompts.log.info(`Using document output language from command-line: ${options.documentOutputLanguage}`);
       }
       if (options.outputFolder) {
         coreConfig.output_folder = options.outputFolder;
-        await prompts.log.info(`Using output folder from command-line: ${options.outputFolder}`);
+        if (!options.quiet) await prompts.log.info(`Using output folder from command-line: ${options.outputFolder}`);
       }
 
       // Load existing config to merge with provided options
@@ -1234,7 +1269,7 @@ class UI {
           document_output_language: 'English',
           output_folder: '_wizz-output',
         };
-        await prompts.log.info('Using default configuration (--yes flag)');
+        if (!options.quiet) await prompts.log.info('Using default configuration (--yes flag)');
       }
     }
 

package/wizz-modules.yaml

@@ -145,6 +145,7 @@ modules:
     code: automator
     name: "Wizz Automator Epic Builder Experimental"
     description: "EXPERIMENTAL: only supports claude and codex currently"
+    advanced_only: true
     defaultSelected: false
     type: experimental
     npmPackage: bmad-story-automator