wizz-method 2.0.0 → 2.1.0

package/tools/installer/modules/official-modules.js

@@ -1,10 +1,8 @@
-const path = require('node:path');
-const fs = require('../fs-native');
-const yaml = require('yaml');
 const prompts = require('../prompts');
-const { getProjectRoot, getSourcePath, getModulePath } = require('../project-root');
-const { CLIUtils } = require('../banner');
 const { ExternalModuleManager } = require('./external-manager');
+const { ModuleCatalog, isMissingDefault: isMissingDefaultShared } = require('./module-catalog');
+const { ModuleInstallerMethods } = require('./module-installer');
+const { ConfigCollectorMethods } = require('./config-collector');
 
 class OfficialModules {
   /**
@@ -16,22 +14,28 @@ class OfficialModules {
    * @returns {boolean} True when the field has no usable default.
    */
   static isMissingDefault(defaultValue) {
-    return defaultValue === undefined || defaultValue === null;
+    return isMissingDefaultShared(defaultValue);
   }
 
   constructor(options = {}) {
     this.externalModuleManager = new ExternalModuleManager();
+    // Camada de leitura pura (item 20, etapa 2). Compartilha o mesmo
+    // externalModuleManager: as resoluções de canal/pin gravadas durante a
+    // coleta de config precisam ser as mesmas vistas no install.
+    this.catalog = new ModuleCatalog({
+      externalModuleManager: this.externalModuleManager,
+      channelOptions: options.channelOptions || null,
+      // Ponto único de override: tudo que o catálogo resolve internamente
+      // passa por este wrapper, então stubar `officialModules.findModuleSource`
+      // (padrão de test-atomic-writes.js) cobre também listAvailable,
+      // getModuleInfo e scanModuleSchemas.
+      findModuleSource: (code, opts) => this.findModuleSource(code, opts),
+    });
     // Config collection state (merged from ConfigCollector)
     this.collectedConfig = {};
-    this._existingConfig = null;
     // Tracked during interactive config collection so {directory_name}
     // placeholder defaults can be resolved in buildQuestion().
     this.currentProjectDir = null;
-    // Install-time channel flag state. Set by Config.build once, then used as
-    // the default for every findModuleSource/cloneExternalModule call so that
-    // pre-install config collection and the install step agree on which ref
-    // to clone.
-    this.channelOptions = options.channelOptions || null;
   }
 
   /**
@@ -41,6 +45,22 @@ class OfficialModules {
     return this.collectedConfig;
   }
 
+  /**
+   * Existing module configurations read from a previous installation.
+   *
+   * Lê o armazém do catálogo direto (item 20, auditoria 2026-09-11): antes
+   * `_existingConfig` era um *snapshot* copiado em loadExistingConfig, e
+   * qualquer repopulação do catálogo (ou uma chamada isolada de
+   * `catalog.loadExistingConfig`) deixava os dois lados divergentes.
+   */
+  get _existingConfig() {
+    return this.catalog.existingConfigData || null;
+  }
+
+  set _existingConfig(value) {
+    this.catalog.existingConfigData = value;
+  }
+
   /**
    * Existing module configurations read from a previous installation.
    */
@@ -48,6 +68,21 @@ class OfficialModules {
     return this._existingConfig;
   }
 
+  /**
+   * Install-time channel flag state. Set by Config.build once, then used as
+   * the default for every findModuleSource/cloneExternalModule call so that
+   * pre-install config collection and the install step agree on which ref
+   * to clone. Encaminhado ao catálogo (quem de fato lê o valor) para que uma
+   * atribuição externa não vire um no-op silencioso.
+   */
+  get channelOptions() {
+    return this.catalog.channelOptions;
+  }
+
+  set channelOptions(value) {
+    this.catalog.channelOptions = value || null;
+  }
+
   /**
    * Build a configured OfficialModules instance from install config.
    * @param {Object} config - Clean install config (from Config.build)
@@ -83,747 +118,37 @@ class OfficialModules {
   }
 
   /**
-   * Copy a file to the target location
-   * @param {string} sourcePath - Source file path
-   * @param {string} targetPath - Target file path
-   * @param {boolean} overwrite - Whether to overwrite existing files (default: true)
-   */
-  async copyFile(sourcePath, targetPath, overwrite = true) {
-    await fs.copy(sourcePath, targetPath, { overwrite });
-  }
-
-  /**
-   * Copy a directory recursively
-   * @param {string} sourceDir - Source directory path
-   * @param {string} targetDir - Target directory path
-   * @param {boolean} overwrite - Whether to overwrite existing files (default: true)
+   * Emit the warnings the catalog could not emit itself (it must not import
+   * `prompts`). Restaura o comportamento pré-split: um module.yaml ilegível
+   * gerava um `log.warn` por módulo em vez de um `catch {}` mudo.
    */
-  async copyDirectory(sourceDir, targetDir, overwrite = true) {
-    await fs.ensureDir(targetDir);
-    const entries = await fs.readdir(sourceDir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      const sourcePath = path.join(sourceDir, entry.name);
-      const targetPath = path.join(targetDir, entry.name);
-
-      if (entry.isDirectory()) {
-        await this.copyDirectory(sourcePath, targetPath, overwrite);
-      } else {
-        await this.copyFile(sourcePath, targetPath, overwrite);
-      }
+  async _flushCatalogLoadErrors() {
+    for (const { module, error } of this.catalog.takeLoadErrors()) {
+      await prompts.log.warn(`Could not read module.yaml for "${module}": ${error.message}`);
     }
   }
 
   /**
-   * List all available built-in modules (core and bmm).
-   * All other modules come from external-official-modules.yaml
-   * @returns {Object} Object with modules array
+   * Leitura de módulos (listar, descrever, localizar fonte) — delegada ao
+   * ModuleCatalog (item 20, etapa 2). A classe mantém os métodos como wrappers
+   * finos para compatibilidade com os callers existentes (ui.js, quick-update,
+   * installer core, testes que monkey-patcham estes prototypes).
    */
-  async listAvailable() {
-    const modules = [];
-
-    // Add built-in core module (directly under src/core-skills)
-    const corePath = getSourcePath('core-skills');
-    if (await fs.pathExists(corePath)) {
-      const coreInfo = await this.getModuleInfo(corePath, 'core', 'src/core-skills');
-      if (coreInfo) {
-        modules.push(coreInfo);
-      }
-    }
-
-    // Add built-in bmm module (directly under src/bmm-skills)
-    const bmmPath = getSourcePath('bmm-skills');
-    if (await fs.pathExists(bmmPath)) {
-      const bmmInfo = await this.getModuleInfo(bmmPath, 'bmm', 'src/bmm-skills');
-      if (bmmInfo) {
-        modules.push(bmmInfo);
-      }
-    }
 
-    // Add bundled local modules (src/modules/<code>), e.g. wizz. Without this
-    // they never appear in the picker nor in the --yes defaults, even with
-    // default_selected: true — findModuleSource resolves them, but nothing
-    // ever selects them (bug: maestro/agentes de área não instalavam via npx).
-    const bundledDir = getSourcePath('modules');
-    if (await fs.pathExists(bundledDir)) {
-      const entries = await fs.readdir(bundledDir, { withFileTypes: true });
-      const seen = new Set(modules.map((m) => m.id));
-      for (const entry of entries) {
-        if (!entry.isDirectory()) continue;
-        const modulePath = path.join(bundledDir, entry.name);
-        if (!(await fs.pathExists(path.join(modulePath, 'module.yaml')))) continue;
-        const info = await this.getModuleInfo(modulePath, entry.name, `src/modules/${entry.name}`);
-        if (info && !seen.has(info.id)) {
-          modules.push(info);
-          seen.add(info.id);
-        }
-      }
-    }
-
-    return { modules };
+  async listAvailable() {
+    const result = await this.catalog.listAvailable();
+    await this._flushCatalogLoadErrors();
+    return result;
   }
 
-  /**
-   * Get module information from a module path
-   * @param {string} modulePath - Path to the module directory
-   * @param {string} defaultName - Default name for the module
-   * @param {string} sourceDescription - Description of where the module was found
-   * @returns {Object|null} Module info or null if not a valid module
-   */
   async getModuleInfo(modulePath, defaultName, sourceDescription) {
-    const moduleConfigPath = path.join(modulePath, 'module.yaml');
-
-    if (!(await fs.pathExists(moduleConfigPath))) {
-      // Check resolution cache for strategy 5 modules (no module.yaml on disk)
-      const { CustomModuleManager } = require('./custom-module-manager');
-      const customMgr = new CustomModuleManager();
-      const resolved = customMgr.getResolution(defaultName);
-      if (resolved && resolved.synthesizedModuleYaml) {
-        return {
-          id: resolved.code,
-          path: modulePath,
-          name: resolved.name,
-          description: resolved.description,
-          version: resolved.version || '1.0.0',
-          source: sourceDescription,
-          dependencies: [],
-          defaultSelected: false,
-        };
-      }
-      return null;
-    }
-
-    const moduleInfo = {
-      id: defaultName,
-      path: modulePath,
-      name: defaultName
-        .split('-')
-        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-        .join(' '),
-      description: 'Wizz Method Module',
-      version: '5.0.0',
-      source: sourceDescription,
-    };
-
-    // Read module config for metadata
-    try {
-      const configContent = await fs.readFile(moduleConfigPath, 'utf8');
-      const config = yaml.parse(configContent);
-
-      // Use the code property as the id if available
-      if (config.code) {
-        moduleInfo.id = config.code;
-      }
-
-      moduleInfo.name = config.name || moduleInfo.name;
-      moduleInfo.description = config.description || moduleInfo.description;
-      moduleInfo.version = config.version || moduleInfo.version;
-      moduleInfo.dependencies = config.dependencies || [];
-      moduleInfo.defaultSelected = config.default_selected === undefined ? false : config.default_selected;
-    } catch (error) {
-      await prompts.log.warn(`Failed to read config for ${defaultName}: ${error.message}`);
-    }
-
-    return moduleInfo;
+    const info = await this.catalog.getModuleInfo(modulePath, defaultName, sourceDescription);
+    await this._flushCatalogLoadErrors();
+    return info;
   }
 
-  /**
-   * Find the source path for a module by searching all possible locations
-   * @param {string} moduleCode - Code of the module to find (from module.yaml)
-   * @returns {string|null} Path to the module source or null if not found
-   */
   async findModuleSource(moduleCode, options = {}) {
-    // Inherit channelOptions from the install-scoped instance when the caller
-    // didn't pass one explicitly. Keeps pre-install config collection and the
-    // actual install step looking at the same git ref.
-    if (options.channelOptions === undefined && this.channelOptions) {
-      options = { ...options, channelOptions: this.channelOptions };
-    }
-    const projectRoot = getProjectRoot();
-
-    // Check for core module (directly under src/core-skills)
-    if (moduleCode === 'core') {
-      const corePath = getSourcePath('core-skills');
-      if (await fs.pathExists(corePath)) {
-        return corePath;
-      }
-    }
-
-    // Check for built-in bmm module (directly under src/bmm-skills)
-    if (moduleCode === 'bmm') {
-      const bmmPath = getSourcePath('bmm-skills');
-      if (await fs.pathExists(bmmPath)) {
-        return bmmPath;
-      }
-    }
-
-    // Check bundled local modules (directly under src/modules/<code>), e.g. wizz.
-    // These ship inside this repo and are auto-discovered by list-options.js.
-    const bundledPath = getSourcePath('modules', moduleCode);
-    if (await fs.pathExists(path.join(bundledPath, 'module.yaml'))) {
-      return bundledPath;
-    }
-
-    // Check external official modules (pass channelOptions so channel plan applies)
-    const externalSource = await this.externalModuleManager.findExternalModuleSource(moduleCode, options);
-    if (externalSource) {
-      return externalSource;
-    }
-
-    // Check custom modules (from user-provided URLs, already cloned to cache)
-    const { CustomModuleManager } = require('./custom-module-manager');
-    const customMgr = new CustomModuleManager();
-    const customSource = await customMgr.findModuleSourceByCode(moduleCode, options);
-    if (customSource) {
-      return customSource;
-    }
-
-    return null;
-  }
-
-  /**
-   * Install a module
-   * @param {string} moduleName - Code of the module to install (from module.yaml)
-   * @param {string} wizzDir - Target wizz directory
-   * @param {Function} fileTrackingCallback - Optional callback to track installed files
-   * @param {Object} options - Additional installation options
-   * @param {Array<string>} options.installedIDEs - Array of IDE codes that were installed
-   * @param {Object} options.moduleConfig - Module configuration from config collector
-   * @param {Object} options.logger - Logger instance for output
-   */
-  async install(moduleName, wizzDir, fileTrackingCallback = null, options = {}) {
-    // Aliases (ex.: bauto → bmad-loop) chegam crus via --modules e via
-    // moduleIds de instalações antigas; sem normalizar aqui, o cache de
-    // getPluginResolution, o targetPath e o manifest usariam o código legado.
-    moduleName = await this.externalModuleManager.resolveCanonicalCode(moduleName);
-
-    // Check if this module has a plugin resolution (custom marketplace install)
-    const { CustomModuleManager } = require('./custom-module-manager');
-    const customMgr = new CustomModuleManager();
-    const resolved = customMgr.getResolution(moduleName);
-    if (resolved) {
-      return this.installFromResolution(resolved, wizzDir, fileTrackingCallback, options);
-    }
-
-    const sourcePath = await this.findModuleSource(moduleName, {
-      silent: options.silent,
-      channelOptions: options.channelOptions,
-    });
-    const targetPath = path.join(wizzDir, moduleName);
-
-    if (!sourcePath) {
-      throw new Error(
-        `Source for module '${moduleName}' is not available. It will be retained but cannot be updated without its source files.`,
-      );
-    }
-
-    if (await fs.pathExists(targetPath)) {
-      await fs.remove(targetPath);
-    }
-
-    // Módulos marketplace-plugin do registry mantêm as skills instaláveis fora do
-    // diretório que contém o module.yaml (sourcePath aponta para o assets/ da
-    // skill -setup), então não dá para instalá-los copiando o sourcePath. Copia
-    // os diretórios de skill resolvidos, do mesmo jeito que um install custom de
-    // marketplace monta um módulo. Todo o resto (manifest, versão) segue pelo
-    // caminho padrão de módulo externo abaixo.
-    const marketplaceInfo = await this.externalModuleManager.getModuleByCode(moduleName);
-    if (marketplaceInfo && marketplaceInfo.marketplacePlugin) {
-      const pluginResolution = this.externalModuleManager.getPluginResolution(moduleName);
-      // Falha alto: copiar o sourcePath aqui instalaria só o assets/ da skill
-      // -setup (module.yaml + module-help.csv) e nenhuma skill — um install
-      // parcial e silenciosamente quebrado. Aborta em vez disso.
-      if (!pluginResolution || !Array.isArray(pluginResolution.skillPaths) || pluginResolution.skillPaths.length === 0) {
-        throw new Error(
-          `Module '${moduleName}' is registered as a marketplace plugin but its skills could not be resolved ` +
-            `from .claude-plugin/marketplace.json (missing or malformed on the selected channel). ` +
-            `Aborting to avoid a partial install with no skills.`,
-        );
-      }
-      await this._copyResolvedSkills(pluginResolution, targetPath, fileTrackingCallback, options.moduleConfig);
-    } else {
-      await this.copyModuleWithFiltering(sourcePath, targetPath, fileTrackingCallback, options.moduleConfig);
-    }
-
-    if (!options.skipModuleInstaller) {
-      await this.createModuleDirectories(moduleName, wizzDir, options);
-    }
-
-    const { Manifest } = require('../core/manifest');
-    const manifestObj = new Manifest();
-    const versionInfo = await manifestObj.getModuleVersionInfo(moduleName, wizzDir, sourcePath);
-
-    // Pick up channel resolution recorded by the external manager (the only
-    // manager that does pre-clone resolution now that community is retired).
-    const resolution = this.externalModuleManager.getResolution(moduleName);
-
-    await manifestObj.addModule(wizzDir, moduleName, {
-      version: resolution?.version || versionInfo.version,
-      source: versionInfo.source,
-      npmPackage: versionInfo.npmPackage,
-      repoUrl: versionInfo.repoUrl,
-      channel: resolution?.channel,
-      sha: resolution?.sha,
-    });
-
-    return { success: true, module: moduleName, path: targetPath, versionInfo };
-  }
-
-  /**
-   * Assenta em disco uma resolução do PluginResolver: copia cada diretório de
-   * skill resolvido (achatado pelo nome da folha) para targetPath e coloca o
-   * module-help.csv na raiz do módulo. Compartilhado pelos installs custom de
-   * marketplace (installFromResolution) e pelos installs oficiais de módulo
-   * marketplace-plugin (install), para os dois caminhos não divergirem.
-   * @param {Object} resolved - ResolvedModule do PluginResolver
-   * @param {string} targetPath - Diretório de destino do módulo (ex.: wizzDir/<code>)
-   * @param {Function} fileTrackingCallback - Callback opcional de rastreio de arquivos
-   * @param {Object} moduleConfig - Configuração do módulo repassada ao filtro de cópia
-   */
-  async _copyResolvedSkills(resolved, targetPath, fileTrackingCallback = null, moduleConfig = {}) {
-    await fs.ensureDir(targetPath);
-
-    // Copia cada diretório de skill, achatado pelo nome da folha. Os nomes de
-    // folha precisam ser únicos — duas skills que achatam para o mesmo diretório
-    // se sobrescreveriam em silêncio, então falha alto em vez disso.
-    const seenLeaves = new Map();
-    for (const skillPath of resolved.skillPaths) {
-      const skillDirName = path.basename(skillPath);
-      if (seenLeaves.has(skillDirName)) {
-        throw new Error(
-          `Cannot install module '${resolved.code}': skill directories '${seenLeaves.get(skillDirName)}' and ` +
-            `'${skillPath}' share the leaf name '${skillDirName}' and would overwrite each other. ` +
-            `Skill directory names must be unique.`,
-        );
-      }
-      seenLeaves.set(skillDirName, skillPath);
-      const skillTarget = path.join(targetPath, skillDirName);
-      await this.copyModuleWithFiltering(skillPath, skillTarget, fileTrackingCallback, moduleConfig);
-    }
-
-    // Coloca o module-help.csv na raiz do módulo.
-    const helpTarget = path.join(targetPath, 'module-help.csv');
-    if (resolved.moduleHelpCsvPath) {
-      // Estratégias 1-4: copia o arquivo existente.
-      await fs.copy(resolved.moduleHelpCsvPath, helpTarget, { overwrite: true });
-      if (fileTrackingCallback) fileTrackingCallback(helpTarget);
-    } else if (resolved.synthesizedHelpCsv) {
-      // Estratégia 5: escreve o conteúdo sintetizado.
-      await fs.writeFile(helpTarget, resolved.synthesizedHelpCsv, 'utf8');
-      if (fileTrackingCallback) fileTrackingCallback(helpTarget);
-    }
-  }
-
-  /**
-   * Install a module from a PluginResolver resolution result.
-   * Copies specific skill directories and places module-help.csv at the target root.
-   * @param {Object} resolved - ResolvedModule from PluginResolver
-   * @param {string} wizzDir - Target wizz directory
-   * @param {Function} fileTrackingCallback - Optional callback to track installed files
-   * @param {Object} options - Installation options
-   */
-  async installFromResolution(resolved, wizzDir, fileTrackingCallback = null, options = {}) {
-    const targetPath = path.join(wizzDir, resolved.code);
-
-    if (await fs.pathExists(targetPath)) {
-      await fs.remove(targetPath);
-    }
-
-    await this._copyResolvedSkills(resolved, targetPath, fileTrackingCallback, options.moduleConfig);
-
-    // Create directories declared in module.yaml (strategies 1-4 may have these)
-    if (!options.skipModuleInstaller) {
-      await this.createModuleDirectories(resolved.code, wizzDir, options);
-    }
-
-    // Update manifest. For custom-source installs we derive channel from the
-    // cloneRef (present → pinned, absent → next; local paths have no channel).
-    const { Manifest } = require('../core/manifest');
-    const manifestObj = new Manifest();
-
-    const hasGitClone = !!resolved.repoUrl;
-    const manifestEntry = {
-      version: resolved.cloneRef || (hasGitClone ? 'main' : resolved.version || null),
-      source: 'custom',
-      npmPackage: null,
-      repoUrl: resolved.repoUrl || null,
-    };
-    if (hasGitClone) {
-      manifestEntry.channel = resolved.cloneRef ? 'pinned' : 'next';
-      if (resolved.cloneSha) manifestEntry.sha = resolved.cloneSha;
-      if (resolved.rawInput) manifestEntry.rawSource = resolved.rawInput;
-    }
-    if (resolved.localPath) manifestEntry.localPath = resolved.localPath;
-    await manifestObj.addModule(wizzDir, resolved.code, manifestEntry);
-
-    return {
-      success: true,
-      module: resolved.code,
-      path: targetPath,
-      // Mirror the manifestEntry.version precedence above so downstream summary
-      // lines show the same string we just wrote to disk (custom git-backed
-      // installs show the cloned ref or 'main').
-      versionInfo: {
-        version: resolved.cloneRef || (hasGitClone ? 'main' : resolved.version || ''),
-      },
-    };
-  }
-
-  /**
-   * Update an existing module
-   * @param {string} moduleName - Name of the module to update
-   * @param {string} wizzDir - Target wizz directory
-   */
-  async update(moduleName, wizzDir) {
-    const sourcePath = await this.findModuleSource(moduleName);
-    const targetPath = path.join(wizzDir, moduleName);
-
-    if (!sourcePath) {
-      throw new Error(`Module '${moduleName}' not found in any source location`);
-    }
-
-    if (!(await fs.pathExists(targetPath))) {
-      throw new Error(`Module '${moduleName}' is not installed`);
-    }
-
-    await this.syncModule(sourcePath, targetPath);
-
-    return {
-      success: true,
-      module: moduleName,
-      path: targetPath,
-    };
-  }
-
-  /**
-   * Remove a module
-   * @param {string} moduleName - Name of the module to remove
-   * @param {string} wizzDir - Target wizz directory
-   */
-  async remove(moduleName, wizzDir) {
-    const targetPath = path.join(wizzDir, moduleName);
-
-    if (!(await fs.pathExists(targetPath))) {
-      throw new Error(`Module '${moduleName}' is not installed`);
-    }
-
-    await fs.remove(targetPath);
-
-    return {
-      success: true,
-      module: moduleName,
-    };
-  }
-
-  /**
-   * Check if a module is installed
-   * @param {string} moduleName - Name of the module
-   * @param {string} wizzDir - Target wizz directory
-   * @returns {boolean} True if module is installed
-   */
-  async isInstalled(moduleName, wizzDir) {
-    const targetPath = path.join(wizzDir, moduleName);
-    return await fs.pathExists(targetPath);
-  }
-
-  /**
-   * Get installed module info
-   * @param {string} moduleName - Name of the module
-   * @param {string} wizzDir - Target wizz directory
-   * @returns {Object|null} Module info or null if not installed
-   */
-  async getInstalledInfo(moduleName, wizzDir) {
-    const targetPath = path.join(wizzDir, moduleName);
-
-    if (!(await fs.pathExists(targetPath))) {
-      return null;
-    }
-
-    const configPath = path.join(targetPath, 'config.yaml');
-    const moduleInfo = {
-      id: moduleName,
-      path: targetPath,
-      installed: true,
-    };
-
-    if (await fs.pathExists(configPath)) {
-      try {
-        const configContent = await fs.readFile(configPath, 'utf8');
-        const config = yaml.parse(configContent);
-        Object.assign(moduleInfo, config);
-      } catch (error) {
-        await prompts.log.warn(`Failed to read installed module config: ${error.message}`);
-      }
-    }
-
-    return moduleInfo;
-  }
-
-  /**
-   * Copy module with filtering for localskip agents and conditional content
-   * @param {string} sourcePath - Source module path
-   * @param {string} targetPath - Target module path
-   * @param {Function} fileTrackingCallback - Optional callback to track installed files
-   * @param {Object} moduleConfig - Module configuration with conditional flags
-   */
-  async copyModuleWithFiltering(sourcePath, targetPath, fileTrackingCallback = null, moduleConfig = {}) {
-    // Get all files in source
-    const sourceFiles = await this.getFileList(sourcePath);
-
-    for (const file of sourceFiles) {
-      // Skip sub-modules directory - these are IDE-specific and handled separately
-      if (file.startsWith('sub-modules/')) {
-        continue;
-      }
-
-      // Skip sidecar directories - these contain agent-specific assets not needed at install time
-      const isInSidecarDirectory = path
-        .dirname(file)
-        .split('/')
-        .some((dir) => dir.toLowerCase().endsWith('-sidecar'));
-
-      if (isInSidecarDirectory) {
-        continue;
-      }
-
-      // Skip module.yaml at root - it's only needed at install time
-      if (file === 'module.yaml') {
-        continue;
-      }
-
-      // Skip module root config.yaml only - generated by config collector with actual values
-      // Workflow-level config.yaml (e.g. workflows/orchestrate-story/config.yaml) must be copied
-      // for custom modules that use workflow-specific configuration
-      if (file === 'config.yaml') {
-        continue;
-      }
-
-      const sourceFile = path.join(sourcePath, file);
-      const targetFile = path.join(targetPath, file);
-
-      // Check if this is an agent file
-      if (file.startsWith('agents/') && file.endsWith('.md')) {
-        // Read the file to check for localskip
-        const content = await fs.readFile(sourceFile, 'utf8');
-
-        // Check for localskip="true" in the agent tag
-        const agentMatch = content.match(/<agent[^>]*\slocalskip="true"[^>]*>/);
-        if (agentMatch) {
-          await prompts.log.message(`  Skipping web-only agent: ${path.basename(file)}`);
-          continue; // Skip this agent
-        }
-      }
-
-      // Copy the file with placeholder replacement
-      await this.copyFile(sourceFile, targetFile);
-
-      // Track the file if callback provided
-      if (fileTrackingCallback) {
-        fileTrackingCallback(targetFile);
-      }
-    }
-  }
-
-  /**
-   * Create directories declared in module.yaml's `directories` key
-   * This replaces the security-risky module installer pattern with declarative config
-   * During updates, if a directory path changed, moves the old directory to the new path
-   * @param {string} moduleName - Name of the module
-   * @param {string} wizzDir - Target wizz directory
-   * @param {Object} options - Installation options
-   * @param {Object} options.moduleConfig - Module configuration from config collector
-   * @param {Object} options.existingModuleConfig - Previous module config (for detecting path changes during updates)
-   * @param {Object} options.coreConfig - Core configuration
-   * @returns {Promise<{createdDirs: string[], movedDirs: string[], createdWdsFolders: string[]}>} Created directories info
-   */
-  async createModuleDirectories(moduleName, wizzDir, options = {}) {
-    const moduleConfig = options.moduleConfig || {};
-    const existingModuleConfig = options.existingModuleConfig || {};
-    const projectRoot = path.dirname(wizzDir);
-    const emptyResult = { createdDirs: [], movedDirs: [], createdWdsFolders: [] };
-
-    // Special handling for core module - it's in src/core-skills not src/modules
-    let sourcePath;
-    if (moduleName === 'core') {
-      sourcePath = getSourcePath('core-skills');
-    } else {
-      sourcePath = await this.findModuleSource(moduleName, { silent: true });
-      if (!sourcePath) {
-        return emptyResult; // No source found, skip
-      }
-    }
-
-    // Read module.yaml to find the `directories` key
-    const moduleYamlPath = path.join(sourcePath, 'module.yaml');
-    if (!(await fs.pathExists(moduleYamlPath))) {
-      return emptyResult; // No module.yaml, skip
-    }
-
-    let moduleYaml;
-    try {
-      const yamlContent = await fs.readFile(moduleYamlPath, 'utf8');
-      moduleYaml = yaml.parse(yamlContent);
-    } catch (error) {
-      await prompts.log.warn(`Invalid module.yaml for ${moduleName}: ${error.message}`);
-      return emptyResult;
-    }
-
-    if (!moduleYaml || !moduleYaml.directories) {
-      return emptyResult; // No directories declared, skip
-    }
-
-    const directories = moduleYaml.directories;
-    const wdsFolders = moduleYaml.wds_folders || [];
-    const createdDirs = [];
-    const movedDirs = [];
-    const createdWdsFolders = [];
-
-    for (const dirRef of directories) {
-      // Parse variable reference like "{design_artifacts}"
-      const varMatch = dirRef.match(/^\{([^}]+)\}$/);
-      if (!varMatch) {
-        // Not a variable reference, skip
-        continue;
-      }
-
-      const configKey = varMatch[1];
-      const dirValue = moduleConfig[configKey];
-      if (!dirValue || typeof dirValue !== 'string') {
-        continue; // No value or not a string, skip
-      }
-
-      // Strip {project-root}/ prefix if present
-      let dirPath = dirValue.replace(/^\{project-root\}\/?/, '');
-
-      // Handle remaining {project-root} anywhere in the path
-      dirPath = dirPath.replaceAll('{project-root}', '');
-
-      // Resolve to absolute path
-      const fullPath = path.join(projectRoot, dirPath);
-
-      // Validate path is within project root (prevent directory traversal)
-      const normalizedPath = path.normalize(fullPath);
-      const normalizedRoot = path.normalize(projectRoot);
-      if (!normalizedPath.startsWith(normalizedRoot + path.sep) && normalizedPath !== normalizedRoot) {
-        const color = await prompts.getColor();
-        await prompts.log.warn(color.yellow(`${configKey} path escapes project root, skipping: ${dirPath}`));
-        continue;
-      }
-
-      // Check if directory path changed from previous config (update/modify scenario)
-      const oldDirValue = existingModuleConfig[configKey];
-      let oldFullPath = null;
-      let oldDirPath = null;
-      if (oldDirValue && typeof oldDirValue === 'string') {
-        // F3: Normalize both values before comparing to avoid false negatives
-        // from trailing slashes, separator differences, or prefix format variations
-        let normalizedOld = oldDirValue.replace(/^\{project-root\}\/?/, '');
-        normalizedOld = path.normalize(normalizedOld.replaceAll('{project-root}', ''));
-        const normalizedNew = path.normalize(dirPath);
-
-        if (normalizedOld !== normalizedNew) {
-          oldDirPath = normalizedOld;
-          oldFullPath = path.join(projectRoot, oldDirPath);
-          const normalizedOldAbsolute = path.normalize(oldFullPath);
-          if (!normalizedOldAbsolute.startsWith(normalizedRoot + path.sep) && normalizedOldAbsolute !== normalizedRoot) {
-            oldFullPath = null; // Old path escapes project root, ignore it
-          }
-
-          // F13: Prevent parent/child move (e.g. docs/planning → docs/planning/v2)
-          if (oldFullPath) {
-            const normalizedNewAbsolute = path.normalize(fullPath);
-            if (
-              normalizedOldAbsolute.startsWith(normalizedNewAbsolute + path.sep) ||
-              normalizedNewAbsolute.startsWith(normalizedOldAbsolute + path.sep)
-            ) {
-              const color = await prompts.getColor();
-              await prompts.log.warn(
-                color.yellow(
-                  `${configKey}: cannot move between parent/child paths (${oldDirPath} / ${dirPath}), creating new directory instead`,
-                ),
-              );
-              oldFullPath = null;
-            }
-          }
-        }
-      }
-
-      const dirName = configKey.replaceAll('_', ' ');
-
-      if (oldFullPath && (await fs.pathExists(oldFullPath)) && !(await fs.pathExists(fullPath))) {
-        // Path changed and old dir exists → move old to new location
-        // F1: Use fs.move() instead of fs.rename() for cross-device/volume support
-        // F2: Wrap in try/catch — fallback to creating new dir on failure
-        try {
-          await fs.ensureDir(path.dirname(fullPath));
-          await fs.move(oldFullPath, fullPath);
-          movedDirs.push(`${dirName}: ${oldDirPath} → ${dirPath}`);
-        } catch (moveError) {
-          const color = await prompts.getColor();
-          await prompts.log.warn(
-            color.yellow(
-              `Failed to move ${oldDirPath} → ${dirPath}: ${moveError.message}\n  Creating new directory instead. Please move contents from the old directory manually.`,
-            ),
-          );
-          await fs.ensureDir(fullPath);
-          createdDirs.push(`${dirName}: ${dirPath}`);
-        }
-      } else if (oldFullPath && (await fs.pathExists(oldFullPath)) && (await fs.pathExists(fullPath))) {
-        // F5: Both old and new directories exist — warn user about potential orphaned documents
-        const color = await prompts.getColor();
-        await prompts.log.warn(
-          color.yellow(
-            `${dirName}: path changed but both directories exist:\n  Old: ${oldDirPath}\n  New: ${dirPath}\n  Old directory may contain orphaned documents — please review and merge manually.`,
-          ),
-        );
-      } else if (!(await fs.pathExists(fullPath))) {
-        // New directory doesn't exist yet → create it
-        createdDirs.push(`${dirName}: ${dirPath}`);
-        await fs.ensureDir(fullPath);
-      }
-
-      // Create WDS subfolders if this is the design_artifacts directory
-      if (configKey === 'design_artifacts' && wdsFolders.length > 0) {
-        for (const subfolder of wdsFolders) {
-          const subPath = path.join(fullPath, subfolder);
-          if (!(await fs.pathExists(subPath))) {
-            await fs.ensureDir(subPath);
-            createdWdsFolders.push(subfolder);
-          }
-        }
-      }
-    }
-
-    return { createdDirs, movedDirs, createdWdsFolders };
-  }
-
-  /**
-   * Private: Sync module files (preserving user modifications)
-   * @param {string} sourcePath - Source module path
-   * @param {string} targetPath - Target module path
-   */
-  async syncModule(sourcePath, targetPath) {
-    // Get list of all source files
-    const sourceFiles = await this.getFileList(sourcePath);
-
-    for (const file of sourceFiles) {
-      const sourceFile = path.join(sourcePath, file);
-      const targetFile = path.join(targetPath, file);
-
-      // Check if target file exists and has been modified
-      if (await fs.pathExists(targetFile)) {
-        const sourceStats = await fs.stat(sourceFile);
-        const targetStats = await fs.stat(targetFile);
-
-        // Skip if target is newer (user modified)
-        if (targetStats.mtime > sourceStats.mtime) {
-          continue;
-        }
-      }
-
-      // Copy file with placeholder replacement
-      await this.copyFile(sourceFile, targetFile);
-    }
+    return this.catalog.findModuleSource(moduleCode, options);
   }
 
   /**
@@ -833,88 +158,19 @@ class OfficialModules {
    * @returns {Array} List of relative file paths
    */
   async getFileList(dir, baseDir = dir) {
-    const files = [];
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      const fullPath = path.join(dir, entry.name);
-
-      if (entry.isDirectory()) {
-        const subFiles = await this.getFileList(fullPath, baseDir);
-        files.push(...subFiles);
-      } else {
-        files.push(path.relative(baseDir, fullPath));
-      }
-    }
-
-    return files;
+    return this.catalog.getFileList(dir, baseDir);
   }
 
   // ─── Config collection methods (merged from ConfigCollector) ───
 
   /**
-   * Find the wizz installation directory in a project
-   * V6+ installations can use ANY folder name but ALWAYS have _config/manifest.yaml
+   * Find the wizz installation directory in a project.
+   * Delegated to ModuleCatalog (item 20, etapa 2).
    * @param {string} projectDir - Project directory
    * @returns {Promise<string>} Path to wizz directory
    */
   async findWizzDir(projectDir) {
-    // Check if project directory exists
-    if (!(await fs.pathExists(projectDir))) {
-      // Project doesn't exist yet, return default
-      return path.join(projectDir, 'wizz');
-    }
-
-    // V6+ strategy: Look for ANY directory with _config/manifest.yaml
-    // This is the definitive marker of a V6+ installation
-    try {
-      const entries = await fs.readdir(projectDir, { withFileTypes: true });
-      for (const entry of entries) {
-        if (entry.isDirectory()) {
-          const manifestPath = path.join(projectDir, entry.name, '_config', 'manifest.yaml');
-          if (await fs.pathExists(manifestPath)) {
-            // Found a V6+ installation
-            return path.join(projectDir, entry.name);
-          }
-        }
-      }
-    } catch {
-      // Ignore errors, fall through to default
-    }
-
-    // No V6+ installation found, return default
-    // This will be used for new installations
-    return path.join(projectDir, 'wizz');
-  }
-
-  /**
-   * Detect the existing WIZZ folder name in a project
-   * @param {string} projectDir - Project directory
-   * @returns {Promise<string|null>} Folder name (just the name, not full path) or null if not found
-   */
-  async detectExistingWizzFolder(projectDir) {
-    // Check if project directory exists
-    if (!(await fs.pathExists(projectDir))) {
-      return null;
-    }
-
-    // Look for ANY directory with _config/manifest.yaml
-    try {
-      const entries = await fs.readdir(projectDir, { withFileTypes: true });
-      for (const entry of entries) {
-        if (entry.isDirectory()) {
-          const manifestPath = path.join(projectDir, entry.name, '_config', 'manifest.yaml');
-          if (await fs.pathExists(manifestPath)) {
-            // Found a V6+ installation, return just the folder name
-            return entry.name;
-          }
-        }
-      }
-    } catch {
-      // Ignore errors
-    }
-
-    return null;
+    return this.catalog.findWizzDir(projectDir);
   }
 
   /**
@@ -922,127 +178,18 @@ class OfficialModules {
    * @param {string} projectDir - Target project directory
    */
   async loadExistingConfig(projectDir) {
-    this._existingConfig = {};
-
-    // Check if project directory exists first
-    if (!(await fs.pathExists(projectDir))) {
-      return false;
-    }
-
-    // Find the actual wizz directory (handles custom folder names)
-    const wizzDir = await this.findWizzDir(projectDir);
-
-    // Check if wizz directory exists
-    if (!(await fs.pathExists(wizzDir))) {
-      return false;
-    }
-
-    // Primary source: installer-written config.toml + config.user.toml (v6+).
-    // Both files together hold all install answers; config.user.toml carries
-    // user-scoped keys like user_name that would otherwise be re-prompted on
-    // every reinstall.
-    let foundAny = false;
-    for (const fileName of ['config.toml', 'config.user.toml']) {
-      const tomlPath = path.join(wizzDir, fileName);
-      if (!(await fs.pathExists(tomlPath))) continue;
-      try {
-        const content = await fs.readFile(tomlPath, 'utf8');
-        const parsed = parseCentralToml(content);
-        for (const [section, values] of Object.entries(parsed)) {
-          if (values && typeof values === 'object' && !Array.isArray(values)) {
-            if (!this._existingConfig[section]) this._existingConfig[section] = {};
-            Object.assign(this._existingConfig[section], values);
-            foundAny = true;
-          }
-        }
-      } catch {
-        // Ignore parse errors
-      }
-    }
-
-    if (foundAny) {
-      return true;
-    }
-
-    // Fallback: legacy per-module config.yaml files (pre-v6 installations).
-    const entries = await fs.readdir(wizzDir, { withFileTypes: true });
-    const nonModuleDirs = new Set(['_config', '_memory', 'memory', 'docs', 'scripts', 'custom']);
-    for (const entry of entries) {
-      if (entry.isDirectory()) {
-        if (nonModuleDirs.has(entry.name)) {
-          continue;
-        }
-
-        const moduleConfigPath = path.join(wizzDir, entry.name, 'config.yaml');
-
-        if (await fs.pathExists(moduleConfigPath)) {
-          try {
-            const content = await fs.readFile(moduleConfigPath, 'utf8');
-            const moduleConfig = yaml.parse(content);
-            // Only keep plain object parses. A corrupt config.yaml that parses
-            // to a scalar or array would crash later code that does `key in cfg`
-            // / `Object.keys(cfg)`; treat it the same as a parse error.
-            if (moduleConfig && typeof moduleConfig === 'object' && !Array.isArray(moduleConfig)) {
-              this._existingConfig[entry.name] = moduleConfig;
-              foundAny = true;
-            }
-          } catch {
-            // Ignore parse errors for individual modules
-          }
-        }
-      }
-    }
-
-    if (foundAny) {
-      await this._hoistCoreKeysFromLegacyModuleConfigs();
-    }
-
-    return foundAny;
+    // O catálogo é o dono do armazém; `_existingConfig` é um getter que lê
+    // dele, então não há snapshot para sincronizar aqui.
+    await this.catalog.loadExistingConfig(projectDir);
+    return this._existingConfig && Object.keys(this._existingConfig).length > 0;
   }
 
   /**
-   * Migrate prior answers when a key has moved from a non-core module to core
-   * (e.g. project_name moving from bmm to core in #2279). Without this, the
-   * partition logic in writeCentralConfig drops the value from the bmm bucket
-   * (because it's now a core key) without re-homing it under [core], so the
-   * user's prior answer silently disappears on the next install/quick-update.
+   * Migrate prior answers when a key has moved from a non-core module to core.
+   * Delegated to ModuleCatalog (item 20, etapa 2).
    */
   async _hoistCoreKeysFromLegacyModuleConfigs() {
-    const coreSchemaPath = path.join(getSourcePath(), 'core-skills', 'module.yaml');
-    if (!(await fs.pathExists(coreSchemaPath))) return;
-
-    let coreSchema;
-    try {
-      coreSchema = yaml.parse(await fs.readFile(coreSchemaPath, 'utf8'));
-    } catch {
-      return;
-    }
-    if (!coreSchema || typeof coreSchema !== 'object') return;
-
-    const coreKeys = new Set(
-      Object.entries(coreSchema)
-        .filter(([, v]) => v && typeof v === 'object' && 'prompt' in v)
-        .map(([k]) => k),
-    );
-    if (coreKeys.size === 0) return;
-
-    // Belt-and-suspenders: loadExistingConfig already filters non-object parses,
-    // but anyone calling _hoistCoreKeysFromLegacyModuleConfigs in isolation (or
-    // future code paths populating _existingConfig directly) shouldn't be able
-    // to crash this with a scalar / array.
-    const existingCore = this._existingConfig.core;
-    this._existingConfig.core = existingCore && typeof existingCore === 'object' && !Array.isArray(existingCore) ? existingCore : {};
-
-    for (const [moduleName, cfg] of Object.entries(this._existingConfig)) {
-      if (moduleName === 'core' || !cfg || typeof cfg !== 'object' || Array.isArray(cfg)) continue;
-      for (const key of Object.keys(cfg)) {
-        if (!coreKeys.has(key)) continue;
-        if (!(key in this._existingConfig.core)) {
-          this._existingConfig.core[key] = cfg[key];
-        }
-        delete cfg[key];
-      }
-    }
+    await this.catalog._hoistCoreKeysFromLegacyModuleConfigs();
   }
 
   /**
@@ -1052,1250 +199,29 @@ class OfficialModules {
    * @returns {Promise<Array>} Array of {moduleName, displayName, questionCount, hasFieldsWithoutDefaults}
    */
   async scanModuleSchemas(modules) {
-    const metadataFields = new Set(['code', 'name', 'header', 'subheader', 'default_selected']);
-    const results = [];
-
-    for (const moduleName of modules) {
-      // Resolve module.yaml path - standard location first, then OfficialModules search
-      let moduleConfigPath = null;
-      const standardPath = path.join(getModulePath(moduleName), 'module.yaml');
-      if (await fs.pathExists(standardPath)) {
-        moduleConfigPath = standardPath;
-      } else {
-        const moduleSourcePath = await this.findModuleSource(moduleName, { silent: true });
-        if (moduleSourcePath) {
-          moduleConfigPath = path.join(moduleSourcePath, 'module.yaml');
-        }
-      }
-
-      if (!moduleConfigPath || !(await fs.pathExists(moduleConfigPath))) {
-        continue;
-      }
+    const results = await this.catalog.scanModuleSchemas(modules);
+    await this._flushCatalogLoadErrors();
+    return results;
+  }
+}
 
-      try {
-        const content = await fs.readFile(moduleConfigPath, 'utf8');
-        const moduleConfig = yaml.parse(content);
-        if (!moduleConfig) continue;
+// Mixins do split do item 20 (etapa 3): o lado install mora em
+// module-installer.js e a coleta interativa em config-collector.js. Montados
+// no prototype para o estado continuar na mesma instância e o monkey-patching
+// de métodos (dos callers e dos testes) continuar funcionando.
+//
+// Definidos como não-enumeráveis (como os métodos declarados em `class`), para
+// que um `for...in` sobre uma instância não passe a listar os métodos vindos
+// dos mixins.
+function defineMixin(target, methods) {
+  const descriptors = {};
+  for (const [name, value] of Object.entries(methods)) {
+    descriptors[name] = { value, writable: true, enumerable: false, configurable: true };
+  }
+  Object.defineProperties(target, descriptors);
+}
 
-        const displayName = moduleConfig.header || `${moduleName.toUpperCase()} Module`;
-        const configKeys = Object.keys(moduleConfig).filter((key) => key !== 'prompt');
-        const questionKeys = configKeys.filter((key) => {
-          if (metadataFields.has(key)) return false;
-          const item = moduleConfig[key];
-          return item && typeof item === 'object' && item.prompt;
-        });
-
-        const hasFieldsWithoutDefaults = questionKeys.some((key) => {
-          const item = moduleConfig[key];
-          return OfficialModules.isMissingDefault(item.default);
-        });
-
-        results.push({
-          moduleName,
-          displayName,
-          questionCount: questionKeys.length,
-          hasFieldsWithoutDefaults,
-        });
-      } catch (error) {
-        await prompts.log.warn(`Could not read schema for module "${moduleName}": ${error.message}`);
-      }
-    }
-
-    return results;
-  }
-
-  /**
-   * Collect configuration for all modules
-   * @param {Array} modules - List of modules to configure (including 'core')
-   * @param {string} projectDir - Target project directory
-   * @param {Object} options - Additional options
-   * @param {boolean} options.skipPrompts - Skip prompts and use defaults (for --yes flag)
-   */
-  async collectAllConfigurations(modules, projectDir, options = {}) {
-    this.skipPrompts = options.skipPrompts || false;
-    this.modulesToCustomize = undefined;
-    await this.loadExistingConfig(projectDir);
-
-    // Check if core was already collected (e.g., in early collection phase)
-    const coreAlreadyCollected = this.collectedConfig.core && Object.keys(this.collectedConfig.core).length > 0;
-
-    // If core wasn't already collected, include it
-    const allModules = coreAlreadyCollected ? modules.filter((m) => m !== 'core') : ['core', ...modules.filter((m) => m !== 'core')];
-
-    // Store all answers across modules for cross-referencing
-    if (!this.allAnswers) {
-      this.allAnswers = {};
-    }
-
-    // Split processing: core first, then gateway, then remaining modules
-    const coreModules = allModules.filter((m) => m === 'core');
-    const nonCoreModules = allModules.filter((m) => m !== 'core');
-
-    // Collect core config first (always fully prompted)
-    for (const moduleName of coreModules) {
-      await this.collectModuleConfig(moduleName, projectDir);
-    }
-
-    // Show batch configuration gateway for non-core modules
-    // Scan all non-core module schemas for display names and config metadata
-    let scannedModules = [];
-    if (!this.skipPrompts && nonCoreModules.length > 0) {
-      scannedModules = await this.scanModuleSchemas(nonCoreModules);
-      const customizableModules = scannedModules.filter((m) => m.questionCount > 0);
-
-      if (customizableModules.length > 0) {
-        const configMode = await prompts.select({
-          message: 'Module configuration',
-          choices: [
-            { name: 'Express Setup', value: 'express', hint: 'accept all defaults (recommended)' },
-            { name: 'Customize', value: 'customize', hint: 'choose modules to configure' },
-          ],
-          default: 'express',
-        });
-
-        if (configMode === 'customize') {
-          const choices = customizableModules.map((m) => ({
-            name: `${m.displayName} (${m.questionCount} option${m.questionCount === 1 ? '' : 's'})`,
-            value: m.moduleName,
-            hint: m.hasFieldsWithoutDefaults ? 'has fields without defaults' : undefined,
-            checked: m.hasFieldsWithoutDefaults,
-          }));
-          const selected = await prompts.multiselect({
-            message: 'Select modules to customize:',
-            choices,
-            required: false,
-          });
-          this.modulesToCustomize = new Set(selected);
-        } else {
-          // Express mode: no modules to customize
-          this.modulesToCustomize = new Set();
-        }
-      } else {
-        // All non-core modules have zero config - no gateway needed
-        this.modulesToCustomize = new Set();
-      }
-    }
-
-    // Collect remaining non-core modules
-    if (this.modulesToCustomize === undefined) {
-      // No gateway was shown (skipPrompts, no non-core modules, or direct call) - process all normally
-      for (const moduleName of nonCoreModules) {
-        await this.collectModuleConfig(moduleName, projectDir);
-      }
-    } else {
-      // Split into default modules (tasks progress) and customized modules (interactive)
-      const defaultModules = nonCoreModules.filter((m) => !this.modulesToCustomize.has(m));
-      const customizeModules = nonCoreModules.filter((m) => this.modulesToCustomize.has(m));
-
-      // Run default modules with a single spinner
-      if (defaultModules.length > 0) {
-        // Build display name map from all scanned modules for pre-call spinner messages
-        const displayNameMap = new Map();
-        for (const m of scannedModules) {
-          displayNameMap.set(m.moduleName, m.displayName);
-        }
-
-        const configSpinner = await prompts.spinner();
-        configSpinner.start('Configuring modules...');
-        try {
-          for (const moduleName of defaultModules) {
-            const displayName = displayNameMap.get(moduleName) || moduleName.toUpperCase();
-            configSpinner.message(`Configuring ${displayName}...`);
-            try {
-              this._silentConfig = true;
-              await this.collectModuleConfig(moduleName, projectDir);
-            } finally {
-              this._silentConfig = false;
-            }
-          }
-        } finally {
-          configSpinner.stop(customizeModules.length > 0 ? 'Module defaults applied' : 'Module configuration complete');
-        }
-      }
-
-      // Run customized modules individually (may show interactive prompts)
-      for (const moduleName of customizeModules) {
-        await this.collectModuleConfig(moduleName, projectDir);
-      }
-
-      if (customizeModules.length > 0) {
-        await prompts.log.step('Module configuration complete');
-      }
-    }
-
-    // Add metadata
-    this.collectedConfig._meta = {
-      version: require(path.join(getProjectRoot(), 'package.json')).version,
-      installDate: new Date().toISOString(),
-      lastModified: new Date().toISOString(),
-    };
-
-    return this.collectedConfig;
-  }
-
-  /**
-   * Collect configuration for a single module (Quick Update mode - only new fields)
-   * @param {string} moduleName - Module name
-   * @param {string} projectDir - Target project directory
-   * @param {boolean} silentMode - If true, only prompt for new/missing fields
-   * @returns {boolean} True if new fields were prompted, false if all fields existed
-   */
-  async collectModuleConfigQuick(moduleName, projectDir, silentMode = true) {
-    this.currentProjectDir = projectDir;
-    // Load existing config if not already loaded
-    if (!this._existingConfig) {
-      await this.loadExistingConfig(projectDir);
-    }
-
-    // Initialize allAnswers if not already initialized
-    if (!this.allAnswers) {
-      this.allAnswers = {};
-    }
-
-    // Load module's config schema from module.yaml
-    // First, try the standard src/modules location
-    let moduleConfigPath = path.join(getModulePath(moduleName), 'module.yaml');
-
-    // If not found in src/modules, we need to find it by searching the project
-    if (!(await fs.pathExists(moduleConfigPath))) {
-      const moduleSourcePath = await this.findModuleSource(moduleName, { silent: true });
-
-      if (moduleSourcePath) {
-        moduleConfigPath = path.join(moduleSourcePath, 'module.yaml');
-      }
-    }
-
-    if (!(await fs.pathExists(moduleConfigPath))) {
-      // No config schema for this module - use existing values
-      if (this._existingConfig && this._existingConfig[moduleName]) {
-        if (!this.collectedConfig[moduleName]) {
-          this.collectedConfig[moduleName] = {};
-        }
-        this.collectedConfig[moduleName] = { ...this._existingConfig[moduleName] };
-      }
-      return false;
-    }
-
-    const configContent = await fs.readFile(moduleConfigPath, 'utf8');
-    const moduleConfig = yaml.parse(configContent);
-
-    if (!moduleConfig) {
-      return false;
-    }
-
-    // Compare schema with existing config to find new/missing fields
-    const configKeys = Object.keys(moduleConfig).filter((key) => key !== 'prompt');
-    const existingKeys = this._existingConfig && this._existingConfig[moduleName] ? Object.keys(this._existingConfig[moduleName]) : [];
-
-    // Check if this module has no configuration keys at all (like CIS)
-    // Filter out metadata fields and only count actual config objects
-    const metadataFields = new Set(['code', 'name', 'header', 'subheader', 'default_selected']);
-    const actualConfigKeys = configKeys.filter((key) => !metadataFields.has(key));
-    const hasNoConfig = actualConfigKeys.length === 0;
-
-    // If module has no config keys at all, handle it specially
-    if (hasNoConfig && moduleConfig.subheader) {
-      const moduleDisplayName = moduleConfig.header || `${moduleName.toUpperCase()} Module`;
-      await prompts.log.step(moduleDisplayName);
-      await prompts.log.message(`  \u2713 ${moduleConfig.subheader}`);
-      return false; // No new fields
-    }
-
-    // Find new interactive fields (with prompt)
-    const newKeys = configKeys.filter((key) => {
-      const item = moduleConfig[key];
-      // Check if it's a config item and doesn't exist in existing config
-      return item && typeof item === 'object' && item.prompt && !existingKeys.includes(key);
-    });
-
-    // Find new static fields (without prompt, just result)
-    const newStaticKeys = configKeys.filter((key) => {
-      const item = moduleConfig[key];
-      return item && typeof item === 'object' && !item.prompt && item.result && !existingKeys.includes(key);
-    });
-
-    // If in silent mode and no new keys (neither interactive nor static), use existing config and skip prompts
-    if (silentMode && newKeys.length === 0 && newStaticKeys.length === 0) {
-      if (this._existingConfig && this._existingConfig[moduleName]) {
-        if (!this.collectedConfig[moduleName]) {
-          this.collectedConfig[moduleName] = {};
-        }
-        this.collectedConfig[moduleName] = { ...this._existingConfig[moduleName] };
-
-        // Special handling for user_name: ensure it has a value
-        if (
-          moduleName === 'core' &&
-          (!this.collectedConfig[moduleName].user_name || this.collectedConfig[moduleName].user_name === '[USER_NAME]')
-        ) {
-          this.collectedConfig[moduleName].user_name = this.getDefaultUsername();
-        }
-
-        // Also populate allAnswers for cross-referencing
-        for (const [key, value] of Object.entries(this._existingConfig[moduleName])) {
-          // Ensure user_name is properly set in allAnswers too
-          let finalValue = value;
-          if (moduleName === 'core' && key === 'user_name' && (!value || value === '[USER_NAME]')) {
-            finalValue = this.getDefaultUsername();
-          }
-          this.allAnswers[`${moduleName}_${key}`] = finalValue;
-        }
-      } else if (moduleName === 'core') {
-        // No existing core config - ensure we at least have user_name
-        if (!this.collectedConfig[moduleName]) {
-          this.collectedConfig[moduleName] = {};
-        }
-        if (!this.collectedConfig[moduleName].user_name) {
-          this.collectedConfig[moduleName].user_name = this.getDefaultUsername();
-          this.allAnswers[`${moduleName}_user_name`] = this.getDefaultUsername();
-        }
-      }
-
-      // Show "no config" message for modules with no new questions (that have config keys)
-      await prompts.log.message(`  \u2713 ${moduleName.toUpperCase()} module already up to date`);
-      return false; // No new fields
-    }
-
-    // If we have new fields (interactive or static), process them
-    if (newKeys.length > 0 || newStaticKeys.length > 0) {
-      const questions = [];
-      const staticAnswers = {};
-
-      // Build questions for interactive fields
-      for (const key of newKeys) {
-        const item = moduleConfig[key];
-        const question = await this.buildQuestion(moduleName, key, item, moduleConfig);
-        if (question) {
-          questions.push(question);
-        }
-      }
-
-      // Prepare static answers (no prompt, just result)
-      for (const key of newStaticKeys) {
-        staticAnswers[`${moduleName}_${key}`] = undefined;
-      }
-
-      // Collect all answers (static + prompted)
-      let allAnswers = { ...staticAnswers };
-
-      if (questions.length > 0 && silentMode) {
-        // In silent mode (quick update), use defaults for new fields instead of prompting
-        for (const q of questions) {
-          allAnswers[q.name] = typeof q.default === 'function' ? q.default({}) : q.default;
-        }
-        await prompts.log.message(`  \u2713 ${moduleName.toUpperCase()} module configured with defaults`);
-      } else if (questions.length > 0) {
-        // Only show header if we actually have questions
-        await CLIUtils.displayModuleConfigHeader(moduleName, moduleConfig.header, moduleConfig.subheader);
-        await prompts.log.message('');
-        const promptedAnswers = await prompts.prompt(questions);
-
-        // Merge prompted answers with static answers
-        Object.assign(allAnswers, promptedAnswers);
-      } else if (newStaticKeys.length > 0) {
-        // Only static fields, no questions - show no config message
-        await prompts.log.message(`  \u2713 ${moduleName.toUpperCase()} module configuration updated`);
-      }
-
-      // Store all answers for cross-referencing
-      Object.assign(this.allAnswers, allAnswers);
-
-      // Process all answers (both static and prompted)
-      // First, copy existing config to preserve values that aren't being updated
-      if (this._existingConfig && this._existingConfig[moduleName]) {
-        this.collectedConfig[moduleName] = { ...this._existingConfig[moduleName] };
-      } else {
-        this.collectedConfig[moduleName] = {};
-      }
-
-      for (const key of Object.keys(allAnswers)) {
-        const originalKey = key.replace(`${moduleName}_`, '');
-        const item = moduleConfig[originalKey];
-        const value = allAnswers[key];
-
-        let result;
-        if (Array.isArray(value)) {
-          result = value;
-        } else if (item.result) {
-          result = this.processResultTemplate(item.result, value);
-        } else {
-          result = value;
-        }
-
-        // Update the collected config with new/updated values
-        this.collectedConfig[moduleName][originalKey] = result;
-      }
-    }
-
-    // Copy over existing values for fields that weren't prompted
-    if (this._existingConfig && this._existingConfig[moduleName]) {
-      if (!this.collectedConfig[moduleName]) {
-        this.collectedConfig[moduleName] = {};
-      }
-      for (const [key, value] of Object.entries(this._existingConfig[moduleName])) {
-        if (!this.collectedConfig[moduleName][key]) {
-          this.collectedConfig[moduleName][key] = value;
-          this.allAnswers[`${moduleName}_${key}`] = value;
-        }
-      }
-    }
-
-    await this.displayModulePostConfigNotes(moduleName, moduleConfig);
-
-    return newKeys.length > 0 || newStaticKeys.length > 0; // Return true if we had any new fields (interactive or static)
-  }
-
-  /**
-   * Process a result template with value substitution
-   * @param {*} resultTemplate - The result template
-   * @param {*} value - The value to substitute
-   * @returns {*} Processed result
-   */
-  processResultTemplate(resultTemplate, value) {
-    let result = resultTemplate;
-
-    if (typeof result === 'string' && value !== undefined) {
-      if (typeof value === 'string') {
-        result = result.replace('{value}', value);
-      } else if (typeof value === 'boolean' || typeof value === 'number') {
-        if (result === '{value}') {
-          result = value;
-        } else {
-          result = result.replace('{value}', value);
-        }
-      } else {
-        result = value;
-      }
-
-      if (typeof result === 'string') {
-        result = result.replaceAll(/{([^}]+)}/g, (match, configKey) => {
-          if (configKey === 'project-root') {
-            return '{project-root}';
-          }
-          if (configKey === 'value') {
-            return match;
-          }
-
-          let configValue = this.allAnswers[configKey] || this.allAnswers[`${configKey}`];
-          if (!configValue) {
-            for (const [answerKey, answerValue] of Object.entries(this.allAnswers)) {
-              if (answerKey.endsWith(`_${configKey}`)) {
-                configValue = answerValue;
-                break;
-              }
-            }
-          }
-
-          if (!configValue) {
-            for (const mod of Object.keys(this.collectedConfig)) {
-              if (mod !== '_meta' && this.collectedConfig[mod] && this.collectedConfig[mod][configKey]) {
-                configValue = this.collectedConfig[mod][configKey];
-                if (typeof configValue === 'string' && configValue.includes('{project-root}/')) {
-                  configValue = configValue.replace('{project-root}/', '');
-                }
-                break;
-              }
-            }
-          }
-
-          return configValue || match;
-        });
-      }
-    }
-
-    return result;
-  }
-
-  /**
-   * Get the default username from the system
-   * @returns {string} Capitalized username\
-   */
-  getDefaultUsername() {
-    let result = 'Wizz';
-    try {
-      const os = require('node:os');
-      const userInfo = os.userInfo();
-      if (userInfo && userInfo.username) {
-        const username = userInfo.username;
-        result = username.charAt(0).toUpperCase() + username.slice(1);
-      }
-    } catch {
-      // Do nothing, just return 'Wizz'
-    }
-    return result;
-  }
-
-  /**
-   * Collect configuration for a single module
-   * @param {string} moduleName - Module name
-   * @param {string} projectDir - Target project directory
-   * @param {boolean} skipLoadExisting - Skip loading existing config (for early core collection)
-   * @param {boolean} skipCompletion - Skip showing completion message (for early core collection)
-   */
-  async collectModuleConfig(moduleName, projectDir, skipLoadExisting = false, skipCompletion = false) {
-    this.currentProjectDir = projectDir;
-    // Load existing config if needed and not already loaded
-    if (!skipLoadExisting && !this._existingConfig) {
-      await this.loadExistingConfig(projectDir);
-    }
-
-    // Initialize allAnswers if not already initialized
-    if (!this.allAnswers) {
-      this.allAnswers = {};
-    }
-    // Load module's config
-    let moduleConfigPath = path.join(getModulePath(moduleName), 'module.yaml');
-
-    // If not found in src/modules or custom paths, search the project
-    if (!(await fs.pathExists(moduleConfigPath))) {
-      const moduleSourcePath = await this.findModuleSource(moduleName, { silent: true });
-
-      if (moduleSourcePath) {
-        moduleConfigPath = path.join(moduleSourcePath, 'module.yaml');
-      }
-    }
-
-    let configPath = null;
-    if (await fs.pathExists(moduleConfigPath)) {
-      configPath = moduleConfigPath;
-    } else {
-      // No config for this module
-      return;
-    }
-
-    const configContent = await fs.readFile(configPath, 'utf8');
-    const moduleConfig = yaml.parse(configContent);
-
-    if (!moduleConfig) {
-      return;
-    }
-
-    // Process each config item
-    const questions = [];
-    const staticAnswers = {};
-    const configKeys = Object.keys(moduleConfig).filter((key) => key !== 'prompt');
-
-    for (const key of configKeys) {
-      const item = moduleConfig[key];
-
-      // Skip if not a config object
-      if (!item || typeof item !== 'object') {
-        continue;
-      }
-
-      // Handle static values (no prompt, just result)
-      if (!item.prompt && item.result) {
-        // Add to static answers with a marker value
-        staticAnswers[`${moduleName}_${key}`] = undefined;
-        continue;
-      }
-
-      // Handle interactive values (with prompt)
-      if (item.prompt) {
-        const question = await this.buildQuestion(moduleName, key, item, moduleConfig);
-        if (question) {
-          questions.push(question);
-        }
-      }
-    }
-
-    // Collect all answers (static + prompted)
-    let allAnswers = { ...staticAnswers };
-
-    // If there are questions to ask, prompt for accepting defaults vs customizing
-    if (questions.length > 0) {
-      const moduleDisplayName = moduleConfig.header || `${moduleName.toUpperCase()} Module`;
-
-      // Skip prompts mode: use all defaults without asking
-      if (this.skipPrompts) {
-        await prompts.log.info(`Using default configuration for ${moduleDisplayName}`);
-        // Use defaults for all questions
-        for (const question of questions) {
-          const hasDefault = !OfficialModules.isMissingDefault(question.default);
-          if (hasDefault && typeof question.default !== 'function') {
-            allAnswers[question.name] = question.default;
-          }
-        }
-      } else {
-        if (!this._silentConfig) await prompts.log.step(`Configuring ${moduleDisplayName}`);
-        let useDefaults = true;
-        if (moduleName === 'core') {
-          useDefaults = false; // Core: always show all questions
-        } else if (this.modulesToCustomize === undefined) {
-          // Fallback: original per-module confirm (backward compat for direct calls)
-          const customizeAnswer = await prompts.prompt([
-            {
-              type: 'confirm',
-              name: 'customize',
-              message: 'Accept Defaults (no to customize)?',
-              default: true,
-            },
-          ]);
-          useDefaults = customizeAnswer.customize;
-        } else {
-          // Batch mode: use defaults unless module was selected for customization
-          useDefaults = !this.modulesToCustomize.has(moduleName);
-        }
-
-        if (useDefaults && moduleName !== 'core') {
-          // Accept defaults - only ask questions that have NO default value
-          const questionsWithoutDefaults = questions.filter((q) => OfficialModules.isMissingDefault(q.default));
-
-          if (questionsWithoutDefaults.length > 0) {
-            await prompts.log.message(`  Asking required questions for ${moduleName.toUpperCase()}...`);
-            const promptedAnswers = await prompts.prompt(questionsWithoutDefaults);
-            Object.assign(allAnswers, promptedAnswers);
-          }
-
-          // For questions with defaults that weren't asked, we need to process them with their default values
-          const questionsWithDefaults = questions.filter((q) => !OfficialModules.isMissingDefault(q.default));
-          for (const question of questionsWithDefaults) {
-            // Skip function defaults - these are dynamic and will be evaluated later
-            if (typeof question.default === 'function') {
-              continue;
-            }
-            allAnswers[question.name] = question.default;
-          }
-        } else {
-          const promptedAnswers = await prompts.prompt(questions);
-          Object.assign(allAnswers, promptedAnswers);
-        }
-      }
-    }
-
-    // Store all answers for cross-referencing
-    Object.assign(this.allAnswers, allAnswers);
-
-    // Process all answers (both static and prompted)
-    // Always process if we have any answers or static answers
-    if (Object.keys(allAnswers).length > 0 || Object.keys(staticAnswers).length > 0) {
-      const answers = allAnswers;
-
-      // Process answers and build result values
-      for (const key of Object.keys(answers)) {
-        const originalKey = key.replace(`${moduleName}_`, '');
-        const item = moduleConfig[originalKey];
-        const value = answers[key];
-
-        // Build the result using the template
-        let result;
-
-        // For arrays (multi-select), handle differently
-        if (Array.isArray(value)) {
-          result = value;
-        } else if (item.result) {
-          result = item.result;
-
-          // Replace placeholders only for strings
-          if (typeof result === 'string' && value !== undefined) {
-            // Replace {value} with the actual value
-            if (typeof value === 'string') {
-              result = result.replace('{value}', value);
-            } else if (typeof value === 'boolean' || typeof value === 'number') {
-              // For boolean and number values, if result is just "{value}", use the raw value
-              if (result === '{value}') {
-                result = value;
-              } else {
-                result = result.replace('{value}', value);
-              }
-            } else {
-              result = value;
-            }
-
-            // Only do further replacements if result is still a string
-            if (typeof result === 'string') {
-              // Replace references to other config values
-              result = result.replaceAll(/{([^}]+)}/g, (match, configKey) => {
-                // Check if it's a special placeholder
-                if (configKey === 'project-root') {
-                  return '{project-root}';
-                }
-
-                // Skip if it's the 'value' placeholder we already handled
-                if (configKey === 'value') {
-                  return match;
-                }
-
-                // Look for the config value across all modules
-                // First check if it's in the current module's answers
-                let configValue = answers[`${moduleName}_${configKey}`];
-
-                // Then check all answers (for cross-module references like outputFolder)
-                if (!configValue) {
-                  // Try with various module prefixes
-                  for (const [answerKey, answerValue] of Object.entries(this.allAnswers)) {
-                    if (answerKey.endsWith(`_${configKey}`)) {
-                      configValue = answerValue;
-                      break;
-                    }
-                  }
-                }
-
-                // Check in already collected config
-                if (!configValue) {
-                  for (const mod of Object.keys(this.collectedConfig)) {
-                    if (mod !== '_meta' && this.collectedConfig[mod] && this.collectedConfig[mod][configKey]) {
-                      configValue = this.collectedConfig[mod][configKey];
-                      break;
-                    }
-                  }
-                }
-
-                return configValue || match;
-              });
-            }
-          }
-        } else {
-          result = value;
-        }
-
-        // Store only the result value (no prompts, defaults, examples, etc.)
-        if (!this.collectedConfig[moduleName]) {
-          this.collectedConfig[moduleName] = {};
-        }
-        this.collectedConfig[moduleName][originalKey] = result;
-      }
-
-      // No longer display completion boxes - keep output clean
-    } else {
-      // No questions for this module - show completion message with header if available
-      const moduleDisplayName = moduleConfig.header || `${moduleName.toUpperCase()} Module`;
-
-      // Check if this module has NO configuration keys at all (like CIS)
-      // Filter out metadata fields and only count actual config objects
-      const metadataFields = new Set(['code', 'name', 'header', 'subheader', 'default_selected']);
-      const actualConfigKeys = configKeys.filter((key) => !metadataFields.has(key));
-      const hasNoConfig = actualConfigKeys.length === 0;
-
-      if (!this._silentConfig) {
-        if (hasNoConfig && (moduleConfig.subheader || moduleConfig.header)) {
-          await prompts.log.step(moduleDisplayName);
-          if (moduleConfig.subheader) {
-            await prompts.log.message(`  \u2713 ${moduleConfig.subheader}`);
-          } else {
-            await prompts.log.message(`  \u2713 No custom configuration required`);
-          }
-        } else {
-          // Module has config but just no questions to ask
-          await prompts.log.message(`  \u2713 ${moduleName.toUpperCase()} module configured`);
-        }
-      }
-    }
-
-    // If we have no collected config for this module, but we have a module schema,
-    // ensure we have at least an empty object
-    if (!this.collectedConfig[moduleName]) {
-      this.collectedConfig[moduleName] = {};
-
-      // If we accepted defaults and have no answers, we still need to check
-      // if there are any static values in the schema that should be applied
-      if (moduleConfig) {
-        for (const key of Object.keys(moduleConfig)) {
-          if (key !== 'prompt' && moduleConfig[key] && typeof moduleConfig[key] === 'object') {
-            const item = moduleConfig[key];
-            // For static items (no prompt, just result), apply the result
-            if (!item.prompt && item.result) {
-              // Apply any placeholder replacements to the result
-              let result = item.result;
-              if (typeof result === 'string') {
-                result = this.replacePlaceholders(result, moduleName, moduleConfig);
-              }
-              this.collectedConfig[moduleName][key] = result;
-            }
-          }
-        }
-      }
-    }
-
-    await this.displayModulePostConfigNotes(moduleName, moduleConfig);
-  }
-
-  /**
-   * Replace placeholders in a string with collected config values
-   * @param {string} str - String with placeholders
-   * @param {string} currentModule - Current module name (to look up defaults in same module)
-   * @param {Object} moduleConfig - Current module's config schema (to look up defaults)
-   * @returns {string} String with placeholders replaced
-   */
-  replacePlaceholders(str, currentModule = null, moduleConfig = null) {
-    if (typeof str !== 'string') {
-      return str;
-    }
-
-    return str.replaceAll(/{([^}]+)}/g, (match, configKey) => {
-      // Preserve special placeholders
-      if (configKey === 'project-root' || configKey === 'value' || configKey === 'directory_name') {
-        return match;
-      }
-
-      const configValue = this.resolveConfigValue(configKey, currentModule, moduleConfig);
-
-      return configValue || match;
-    });
-  }
-
-  /**
-   * Clean a stored path-like value for prompt display/input reuse.
-   * @param {*} value - Stored value
-   * @returns {*} Cleaned value
-   */
-  cleanPromptValue(value) {
-    if (typeof value === 'string' && value.startsWith('{project-root}/')) {
-      return value.replace('{project-root}/', '');
-    }
-
-    return value;
-  }
-
-  /**
-   * Resolve a config key from answers, collected config, existing config, or schema defaults.
-   * @param {string} configKey - Config key to resolve
-   * @param {string} currentModule - Current module name
-   * @param {Object} moduleConfig - Current module config schema
-   * @returns {*} Resolved value
-   */
-  resolveConfigValue(configKey, currentModule = null, moduleConfig = null) {
-    // Look for the config value in allAnswers (already answered questions)
-    let configValue = this.allAnswers?.[configKey] || this.allAnswers?.[`core_${configKey}`];
-
-    if (!configValue && this.allAnswers) {
-      for (const [answerKey, answerValue] of Object.entries(this.allAnswers)) {
-        if (answerKey.endsWith(`_${configKey}`)) {
-          configValue = answerValue;
-          break;
-        }
-      }
-    }
-
-    // Prefer the current module's persisted value when re-prompting an existing install
-    if (!configValue && currentModule && this._existingConfig?.[currentModule]?.[configKey] !== undefined) {
-      configValue = this._existingConfig[currentModule][configKey];
-    }
-
-    // Check in already collected config
-    if (!configValue) {
-      for (const mod of Object.keys(this.collectedConfig)) {
-        if (mod !== '_meta' && this.collectedConfig[mod] && this.collectedConfig[mod][configKey]) {
-          configValue = this.collectedConfig[mod][configKey];
-          break;
-        }
-      }
-    }
-
-    // Fall back to other existing module config values
-    if (!configValue && this._existingConfig) {
-      for (const mod of Object.keys(this._existingConfig)) {
-        if (mod !== '_meta' && this._existingConfig[mod] && this._existingConfig[mod][configKey]) {
-          configValue = this._existingConfig[mod][configKey];
-          break;
-        }
-      }
-    }
-
-    // If still not found and we're in the same module, use the default from the config schema
-    if (!configValue && currentModule && moduleConfig && moduleConfig[configKey]) {
-      const referencedItem = moduleConfig[configKey];
-      if (referencedItem && referencedItem.default !== undefined) {
-        configValue = referencedItem.default;
-      }
-    }
-
-    return this.cleanPromptValue(configValue);
-  }
-
-  /**
-   * Convert an existing stored value back into the prompt-facing value for templated fields.
-   * For example, "{test_artifacts}/{value}" + "_wizz-output/test-artifacts/test-design"
-   * becomes "test-design" so the template is not applied twice on modify.
-   * @param {*} existingValue - Stored config value
-   * @param {string} moduleName - Module name
-   * @param {Object} item - Config item definition
-   * @param {Object} moduleConfig - Current module config schema
-   * @returns {*} Prompt-facing default value
-   */
-  normalizeExistingValueForPrompt(existingValue, moduleName, item, moduleConfig = null) {
-    const cleanedValue = this.cleanPromptValue(existingValue);
-
-    if (typeof cleanedValue !== 'string' || typeof item?.result !== 'string' || !item.result.includes('{value}')) {
-      return cleanedValue;
-    }
-
-    const [prefixTemplate = '', suffixTemplate = ''] = item.result.split('{value}');
-    const prefix = this.cleanPromptValue(this.replacePlaceholders(prefixTemplate, moduleName, moduleConfig));
-    const suffix = this.cleanPromptValue(this.replacePlaceholders(suffixTemplate, moduleName, moduleConfig));
-
-    if ((prefix && !cleanedValue.startsWith(prefix)) || (suffix && !cleanedValue.endsWith(suffix))) {
-      return cleanedValue;
-    }
-
-    const startIndex = prefix.length;
-    const endIndex = suffix ? cleanedValue.length - suffix.length : cleanedValue.length;
-    if (endIndex < startIndex) {
-      return cleanedValue;
-    }
-
-    let promptValue = cleanedValue.slice(startIndex, endIndex);
-    if (promptValue.startsWith('/')) {
-      promptValue = promptValue.slice(1);
-    }
-    if (promptValue.endsWith('/')) {
-      promptValue = promptValue.slice(0, -1);
-    }
-
-    return promptValue || cleanedValue;
-  }
-
-  /**
-   * Build a prompt question from a config item
-   * @param {string} moduleName - Module name
-   * @param {string} key - Config key
-   * @param {Object} item - Config item definition
-   * @param {Object} moduleConfig - Full module config schema (for resolving defaults)
-   */
-  async buildQuestion(moduleName, key, item, moduleConfig = null) {
-    const questionName = `${moduleName}_${key}`;
-
-    // Check for existing value
-    let existingValue = null;
-    if (this._existingConfig && this._existingConfig[moduleName]) {
-      existingValue = this._existingConfig[moduleName][key];
-      existingValue = this.normalizeExistingValueForPrompt(existingValue, moduleName, item, moduleConfig);
-    }
-
-    // Special handling for user_name: default to system user
-    if (moduleName === 'core' && key === 'user_name' && !existingValue) {
-      item.default = this.getDefaultUsername();
-    }
-
-    // Determine question type and default value
-    let questionType = 'input';
-    let defaultValue = item.default;
-    let choices = null;
-
-    // Check if default contains references to other fields in the same module
-    const hasSameModuleReference = typeof defaultValue === 'string' && defaultValue.match(/{([^}]+)}/);
-    let dynamicDefault = false;
-
-    // Replace placeholders in default value with collected config values
-    if (typeof defaultValue === 'string') {
-      if (defaultValue.includes('{directory_name}') && this.currentProjectDir) {
-        const dirName = path.basename(this.currentProjectDir);
-        defaultValue = defaultValue.replaceAll('{directory_name}', dirName);
-      }
-
-      // Check if this references another field in the same module (for dynamic defaults)
-      if (hasSameModuleReference && moduleConfig) {
-        const matches = defaultValue.match(/{([^}]+)}/g);
-        if (matches) {
-          for (const match of matches) {
-            const fieldName = match.slice(1, -1); // Remove { }
-            // Check if this field exists in the same module config
-            if (moduleConfig[fieldName]) {
-              dynamicDefault = true;
-              break;
-            }
-          }
-        }
-      }
-
-      // If not dynamic, replace placeholders now
-      if (!dynamicDefault) {
-        defaultValue = this.replacePlaceholders(defaultValue, moduleName, moduleConfig);
-      }
-
-      // Strip {project-root}/ from defaults since it will be added back by result template
-      // This makes the display cleaner and user input simpler
-      if (defaultValue.includes('{project-root}/')) {
-        defaultValue = defaultValue.replace('{project-root}/', '');
-      }
-    }
-
-    // Handle different question types
-    if (item['single-select']) {
-      questionType = 'list';
-      choices = item['single-select'].map((choice) => {
-        // If choice is an object with label and value
-        if (typeof choice === 'object' && choice.label && choice.value !== undefined) {
-          return {
-            name: choice.label,
-            value: choice.value,
-          };
-        }
-        // Otherwise it's a simple string choice
-        return {
-          name: choice,
-          value: choice,
-        };
-      });
-      if (existingValue) {
-        defaultValue = existingValue;
-      }
-    } else if (item['multi-select']) {
-      questionType = 'checkbox';
-      choices = item['multi-select'].map((choice) => {
-        // If choice is an object with label and value
-        if (typeof choice === 'object' && choice.label && choice.value !== undefined) {
-          return {
-            name: choice.label,
-            value: choice.value,
-            checked: existingValue
-              ? existingValue.includes(choice.value)
-              : item.default && Array.isArray(item.default)
-                ? item.default.includes(choice.value)
-                : false,
-          };
-        }
-        // Otherwise it's a simple string choice
-        return {
-          name: choice,
-          value: choice,
-          checked: existingValue
-            ? existingValue.includes(choice)
-            : item.default && Array.isArray(item.default)
-              ? item.default.includes(choice)
-              : false,
-        };
-      });
-    } else if (typeof defaultValue === 'boolean') {
-      questionType = 'confirm';
-    }
-
-    // Build the prompt message
-    let message = '';
-
-    // Handle array prompts for multi-line messages
-    if (Array.isArray(item.prompt)) {
-      message = item.prompt.join('\n');
-    } else {
-      message = item.prompt;
-    }
-
-    // Replace placeholders in prompt message with collected config values
-    if (typeof message === 'string') {
-      message = this.replacePlaceholders(message, moduleName, moduleConfig);
-    }
-
-    // Add current value indicator for existing configs
-    const color = await prompts.getColor();
-    if (existingValue !== null && existingValue !== undefined) {
-      if (typeof existingValue === 'boolean') {
-        message += color.dim(` (current: ${existingValue ? 'true' : 'false'})`);
-      } else if (Array.isArray(existingValue)) {
-        message += color.dim(` (current: ${existingValue.join(', ')})`);
-      } else if (questionType !== 'list') {
-        // Show the cleaned value (without {project-root}/) for display
-        message += color.dim(` (current: ${existingValue})`);
-      }
-    } else if (item.example && questionType === 'input') {
-      // Show example for input fields
-      let exampleText = typeof item.example === 'string' ? item.example : JSON.stringify(item.example);
-      // Replace placeholders in example
-      if (typeof exampleText === 'string') {
-        exampleText = this.replacePlaceholders(exampleText, moduleName, moduleConfig);
-        exampleText = exampleText.replace('{project-root}/', '');
-      }
-      message += color.dim(` (e.g., ${exampleText})`);
-    }
-
-    // Build the question object
-    const question = {
-      type: questionType,
-      name: questionName,
-      message: message,
-    };
-
-    // Set default - if it's dynamic, use a function that the prompt will evaluate with current answers
-    // But if we have an existing value, always use that instead
-    if (existingValue !== null && existingValue !== undefined && questionType !== 'list') {
-      question.default = existingValue;
-    } else if (dynamicDefault && typeof item.default === 'string') {
-      const originalDefault = item.default;
-      question.default = (answers) => {
-        // Replace placeholders using answers from previous questions in the same batch
-        let resolved = originalDefault;
-        resolved = resolved.replaceAll(/{([^}]+)}/g, (match, fieldName) => {
-          // Look for the answer in the current batch (prefixed with module name)
-          const answerKey = `${moduleName}_${fieldName}`;
-          if (answers[answerKey] !== undefined) {
-            return answers[answerKey];
-          }
-          // Fall back to collected config
-          return this.collectedConfig[moduleName]?.[fieldName] || match;
-        });
-        // Strip {project-root}/ for cleaner display
-        if (resolved.includes('{project-root}/')) {
-          resolved = resolved.replace('{project-root}/', '');
-        }
-        return resolved;
-      };
-    } else {
-      question.default = defaultValue;
-    }
-
-    // Add choices for select types
-    if (choices) {
-      question.choices = choices;
-    }
-
-    // Add validation for input fields
-    if (questionType === 'input') {
-      question.validate = (input) => {
-        if (!input && item.required) {
-          return 'This field is required';
-        }
-        // Validate against regex pattern if provided
-        if (input && item.regex) {
-          const regex = new RegExp(item.regex);
-          if (!regex.test(input)) {
-            return `Invalid format. Must match pattern: ${item.regex}`;
-          }
-        }
-        return true;
-      };
-    }
-
-    // Add validation for checkbox (multi-select) fields
-    if (questionType === 'checkbox' && item.required) {
-      question.validate = (answers) => {
-        if (!answers || answers.length === 0) {
-          return 'At least one option must be selected';
-        }
-        return true;
-      };
-    }
-
-    return question;
-  }
-
-  /**
-   * Display post-configuration notes for a module
-   * Shows prerequisite guidance based on collected config values
-   * Reads notes from the module's `post-install-notes` section in module.yaml
-   * Supports two formats:
-   *   - Simple string: always displayed
-   *   - Object keyed by config field name, with value-specific messages
-   * @param {string} moduleName - Module name
-   * @param {Object} moduleConfig - Parsed module.yaml content
-   */
-  async displayModulePostConfigNotes(moduleName, moduleConfig) {
-    if (this._silentConfig) return;
-    if (!moduleConfig || !moduleConfig['post-install-notes']) return;
-
-    const notes = moduleConfig['post-install-notes'];
-    const color = await prompts.getColor();
-
-    // Format 1: Simple string - always display
-    if (typeof notes === 'string') {
-      await prompts.log.message('');
-      for (const line of notes.trim().split('\n')) {
-        await prompts.log.message(color.dim(line));
-      }
-      return;
-    }
-
-    // Format 2: Conditional on config values
-    if (typeof notes === 'object') {
-      const config = this.collectedConfig[moduleName];
-      if (!config) return;
-
-      let hasOutput = false;
-      for (const [configKey, valueMessages] of Object.entries(notes)) {
-        const selectedValue = config[configKey];
-        if (!selectedValue || !valueMessages[selectedValue]) continue;
-
-        if (hasOutput) await prompts.log.message('');
-        hasOutput = true;
-
-        const message = valueMessages[selectedValue];
-        for (const line of message.trim().split('\n')) {
-          const trimmedLine = line.trim();
-          if (trimmedLine.endsWith(':') && !trimmedLine.startsWith(' ')) {
-            await prompts.log.info(color.bold(trimmedLine));
-          } else {
-            await prompts.log.message(color.dim('  ' + trimmedLine));
-          }
-        }
-      }
-    }
-  }
-
-  /**
-   * Deep merge two objects
-   * @param {Object} target - Target object
-   * @param {Object} source - Source object
-   */
-  deepMerge(target, source) {
-    const result = { ...target };
-
-    for (const key in source) {
-      if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
-        if (result[key] && typeof result[key] === 'object' && !Array.isArray(result[key])) {
-          result[key] = this.deepMerge(result[key], source[key]);
-        } else {
-          result[key] = source[key];
-        }
-      } else {
-        result[key] = source[key];
-      }
-    }
-
-    return result;
-  }
-}
-
-/**
- * Parse a config.toml or config.user.toml written by writeCentralConfig.
- * Only handles the subset of TOML the installer produces: [core],
- * [modules.<code>], string/bool/number scalar values. [agents.*] and other
- * sections are ignored. Returns a plain object keyed by section name where
- * module sections use the bare code (e.g. "bmm"), not the full "modules.bmm".
- */
-function parseCentralToml(content) {
-  const result = {};
-  let currentSection = null;
-
-  for (const rawLine of content.split('\n')) {
-    const line = rawLine.trim();
-    if (!line || line.startsWith('#')) continue;
-
-    const sectionMatch = line.match(/^\[([^\]]+)\]\s*$/);
-    if (sectionMatch) {
-      const name = sectionMatch[1];
-      if (name === 'core') {
-        currentSection = 'core';
-      } else if (name.startsWith('modules.')) {
-        currentSection = name.slice('modules.'.length);
-      } else {
-        currentSection = null;
-      }
-      if (currentSection && !result[currentSection]) {
-        result[currentSection] = {};
-      }
-      continue;
-    }
-
-    if (!currentSection) continue;
-
-    const kvMatch = line.match(/^([a-zA-Z_][a-zA-Z0-9_]*)\s*=\s*(.+)$/);
-    if (!kvMatch) continue;
-
-    const key = kvMatch[1];
-    const raw = kvMatch[2].trim();
-    let value;
-    if (raw.startsWith('"') && raw.endsWith('"')) {
-      value = raw.slice(1, -1).replaceAll(/\\(["\\nrbt])/g, (_, c) => ({ '"': '"', '\\': '\\', n: '\n', r: '\r', b: '\b', t: '\t' })[c]);
-    } else if (raw === 'true') {
-      value = true;
-    } else if (raw === 'false') {
-      value = false;
-    } else if (raw !== '' && !isNaN(raw)) {
-      value = Number(raw);
-    } else {
-      value = raw;
-    }
-    result[currentSection][key] = value;
-  }
-
-  return result;
-}
+defineMixin(OfficialModules.prototype, ModuleInstallerMethods);
+defineMixin(OfficialModules.prototype, ConfigCollectorMethods);
 
 module.exports = { OfficialModules };