wizz-method 2.12.0 → 2.13.0

package/tools/installer/guided/steps.js

@@ -0,0 +1,154 @@
+/**
+ * One function per guided screen. Each returns plain data; the order and the
+ * loop (change profile, customize) live in flow.js.
+ */
+const os = require('node:os');
+const fs = require('../fs-native');
+const prompts = require('../prompts');
+const { paint, BRAND_ORANGE } = require('../banner');
+const { t, LANGUAGES } = require('./messages');
+const { PROFILES } = require('./profiles');
+const { AREA_LABELS, cliBadges, cliDescription } = require('./labels');
+const { detectAiTools } = require('./detect-tools');
+
+const TOTAL_STEPS = 4;
+const OTHER_TOOLS = '__other__';
+
+async function stepHeader(lang, n) {
+  const color = await prompts.getColor();
+  const colorOn = color.isColorSupported !== false;
+  const track = Array.from({ length: TOTAL_STEPS }, (_, i) => (i < n ? '●' : '○')).join('───');
+  await prompts.log.message(`${paint(BRAND_ORANGE, track, colorOn)}  ${color.dim(t(lang, 'step', { n, total: TOTAL_STEPS }))}`);
+}
+
+async function askLanguage() {
+  return prompts.select({
+    message: t('en', 'languageQuestion'),
+    choices: LANGUAGES.map((l) => ({ name: l.label, value: l.value })),
+    default: 'en',
+  });
+}
+
+async function askDirectory(ui, lang) {
+  for (;;) {
+    const raw = await prompts.directory({
+      message: t(lang, 'dirQuestion'),
+      default: process.cwd(),
+      placeholder: process.cwd(),
+      validate: (input) => ui.validateDirectorySync(input),
+    });
+    const directory = raw && raw.trim() ? ui.expandUserPath(raw) : process.cwd();
+    if (await fs.pathExists(directory)) return directory;
+    const create = await prompts.confirm({ message: t(lang, 'dirCreate', { dir: directory }), default: true });
+    if (create) return directory;
+    await prompts.log.warn(t(lang, 'dirRetry'));
+  }
+}
+
+async function askProfile(lang, current) {
+  return prompts.select({
+    message: t(lang, 'profileQuestion'),
+    choices: PROFILES.map((p) => ({ name: p[lang].name, value: p.id, hint: p[lang].help })),
+    default: current || 'everything',
+  });
+}
+
+async function askAreas(lang, registry) {
+  const keys = Object.keys((registry && registry.areas) || {});
+  const selected = await prompts.multiselect({
+    message: t(lang, 'areasQuestion'),
+    options: keys.map((key) => {
+      const label = AREA_LABELS[key] ? AREA_LABELS[key][lang] : { name: key, help: '' };
+      return { label: label.name, value: key, hint: label.help };
+    }),
+    initialValues: keys,
+    required: true,
+  });
+  return selected.length === keys.length ? [] : selected;
+}
+
+async function askModules(lang, available) {
+  const selected = await prompts.multiselect({
+    message: t(lang, 'modulesQuestion'),
+    options: available.map((mod) => ({
+      label: mod.fromBmad ? `${mod.name} · ${t(lang, 'fromBmad')}` : mod.name,
+      value: mod.code,
+      hint: mod.description,
+    })),
+    initialValues: available.filter((mod) => mod.defaultSelected).map((mod) => mod.code),
+    required: true,
+  });
+  return selected;
+}
+
+async function askTools(lang, ideManager) {
+  const preferred = ideManager.getPreferredIdes();
+  const others = ideManager.getOtherIdes();
+  const detected = new Set(detectAiTools());
+  const initial = preferred.filter((ide) => detected.has(ide.value)).map((ide) => ide.value);
+  const picked = await prompts.multiselect({
+    message: t(lang, 'toolQuestion'),
+    options: [
+      ...preferred.map((ide) => ({
+        label: ide.name,
+        value: ide.value,
+        hint: detected.has(ide.value) ? t(lang, 'toolDetected') : undefined,
+      })),
+      { label: t(lang, 'toolOther'), value: OTHER_TOOLS, hint: t(lang, 'toolOtherHelp') },
+    ],
+    initialValues: initial.length > 0 ? initial : [preferred[0].value],
+    required: true,
+  });
+  const chosen = picked.filter((id) => id !== OTHER_TOOLS);
+  if (!picked.includes(OTHER_TOOLS)) return chosen;
+  const extra = await prompts.autocompleteMultiselect({
+    message: t(lang, 'toolOtherQuestion'),
+    options: others.map((ide) => ({ label: ide.name, value: ide.value })),
+    required: chosen.length === 0,
+    maxItems: 8,
+  });
+  return [...chosen, ...(extra || [])];
+}
+
+function defaultUserName() {
+  let name;
+  try {
+    name = os.userInfo().username;
+  } catch {
+    name = process.env.USER || process.env.USERNAME || 'User';
+  }
+  return name.charAt(0).toUpperCase() + name.slice(1);
+}
+
+async function askName(lang) {
+  const fallback = defaultUserName();
+  const value = await prompts.text({ message: t(lang, 'nameQuestion'), default: fallback, placeholder: fallback });
+  return (value && String(value).trim()) || fallback;
+}
+
+/**
+ * Label and hint for a CLI in the optional-tools list: plain description,
+ * then requirement badges ("free" when there are none).
+ */
+function cliOption(cli, lang) {
+  const badges = cliBadges(cli, lang);
+  const needs = badges.length > 0 ? badges.join(' · ') : t(lang, 'free');
+  const description = cliDescription(cli.id, lang);
+  // Description in the label, not the hint: clack only shows a hint for the
+  // focused row, and the point here is comparing tools at a glance.
+  const label = description ? `${cli.id.padEnd(14)} ${description} · ${needs}` : `${cli.id.padEnd(14)} ${needs}`;
+  return { label, value: cli.id };
+}
+
+module.exports = {
+  stepHeader,
+  askLanguage,
+  askDirectory,
+  askProfile,
+  askAreas,
+  askModules,
+  askTools,
+  askName,
+  cliOption,
+  defaultUserName,
+};

package/tools/installer/install-messages.yaml

@@ -6,11 +6,11 @@
 startMessage: |
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-  Método de agência orientado por IA, em PT-BR. Agentes por área, skills curadas e memória de projeto.
-  Escolha os módulos durante o setup para montar a instalação do seu jeito.
+  Full install: choices come from your flags or from the complete question list.
+  For the short guided install, run `npx wizz-method install` with no flags.
 
   📖 Docs:     https://method.wizzcomms.com/
-  ✉️  Suporte:  support@wizzcomms.com
+  ✉️  Support:  support@wizzcomms.com
 
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 

package/tools/installer/modules/external-manager.js

@@ -145,6 +145,10 @@ class ExternalModuleManager {
       marketplacePlugin: mod.marketplace_plugin === true || mod['marketplace-plugin'] === true || mod.marketplacePlugin === true,
       postInstallMessage: mod.post_install_message || mod['post-install-message'] || mod.postInstallMessage || null,
       builtIn: mod.built_in === true,
+      // Só aparece no modo avançado do instalador guiado (--advanced ou a
+      // lista completa de módulos); experimental ou de nicho demais pra
+      // quem instala pela primeira vez.
+      advancedOnly: mod.advanced_only === true,
       isExternal: mod.built_in !== true,
       // Códigos anteriores sob os quais este módulo foi registrado (ex.: `bmad-loop`
       // era `bauto`). Deixa um módulo renomeado continuar resolvendo instalações

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