create-byan-agent 1.2.2 → 1.2.4

package/CHANGELOG.md

@@ -5,14 +5,123 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.4] - 2026-02-04
+
+### Added
+- **Interactive override**: `--interactive` flag to force prompts even without TTY (useful in npm scripts).
+
+### Changed
+- **Interview defaults**: Preselect detected or provided platforms during the interview.
+- **E2E**: Run with explicit platforms to validate stub generation.
+
+### Fixed
+- **Silent mode**: Skip interview and wizard with safe defaults to prevent hangs in non-interactive runs.
+- **Platform normalization**: Map `claude` to `claude-code` for installer/platform parity.
+- **Validator**: Use YAML parser correctly and remove false warnings (permissions/templates).
+
+## [1.2.3] - 2026-02-03
+
+### Added
+- **E2E Test Suite** - Automated end-to-end testing before npm publish
+  - Tests complete installation flow (7 steps)
+  - Validates directory structure, agent files, config, platform stubs
+  - Smoke tests for all 8 YANSTALLER modules
+  - Runs automatically via `prepublishOnly` hook
+  - Prevents broken releases (caught 8 bugs before production)
+  - Command: `npm run test:e2e`
+  - Documentation: TEST-E2E-GUIDE.md
+
+### Fixed
+- **CRITICAL BUG #1**: Fixed recommender crash when platforms is undefined
+  - `recommender.recommend()` now properly handles both direct detection object and options wrapper
+  - Added default empty array for platforms parameter in `getRecommendedAgents()`
+  - Added null-check before calling `.some()` on platforms array
+  - Fixed display of detected platforms in CLI (was showing "[object Object]")
+  
+- **CRITICAL BUG #2**: Fixed backup crash on wrong parameter format
+  - Fixed `backuper.backup()` call - now passes bmadPath directly instead of object wrapper
+  
+- **CRITICAL BUG #3**: Fixed installation result property access
+  - Fixed `installResult` property access - uses `agentsInstalled` instead of `installedAgents.length`
+  - Removed references to non-existent properties (`createdDirectories`, `generatedStubs`)
+  - Added error reporting for installation failures
+
+- **CRITICAL BUG #4**: Fixed wizard crash on undefined properties
+  - Added null-checks for `config.agents`, `config.targetPlatforms`, `config.platforms`
+  - Fixed wizard call to pass correct config object with all required properties
+  - Prevents crash when displaying installation summary
+
+- **CRITICAL BUG #5**: Fixed agent templates not found
+  - Limited recommendations to available agents only (byan, rachid, patnote, marc, etc.)
+  - Removed recommendations for non-existent agents (architect, dev, quinn, pm, ux-designer, tech-writer)
+  - Prevents installation failures due to missing template files
+
+- **CRITICAL BUG #6**: Fixed missing fileUtils.readDir function
+  - Added `readDir()` function to file-utils.js
+  - Fixes validator crashes when checking workflow directories
+  - Properly exports readDir in module.exports
+
+- **CRITICAL BUG #7**: Fixed installer config parameter mismatch
+  - Fixed installer.install() call to pass `targetPlatforms` instead of `platforms`
+  - Config file now created correctly during installation
+  - Matches InstallConfig typedef definition
+
+- **BUG #8**: Removed carmack from recommendations
+  - carmack.md template does not exist in templates/_bmad/
+  - Removed from baseAgents to prevent installation failures
+  - Updated E2E test to not expect carmack agent
+
 ## [1.2.2] - 2026-02-03
 
+### Added
+- **E2E Test Suite** - Automated end-to-end testing before npm publish
+  - Tests complete installation flow (7 steps)
+  - Validates directory structure, agent files, config, platform stubs
+  - Smoke tests for all 8 YANSTALLER modules
+  - Runs automatically via `prepublishOnly` hook
+  - Prevents broken releases (caught 7 bugs before production)
+  - Command: `npm run test:e2e`
+  - Documentation: TEST-E2E-GUIDE.md
+
 ### Fixed
-- **CRITICAL BUG**: Fixed recommender crash when platforms is undefined
+- **CRITICAL BUG #1**: Fixed recommender crash when platforms is undefined
   - `recommender.recommend()` now properly handles both direct detection object and options wrapper
   - Added default empty array for platforms parameter in `getRecommendedAgents()`
   - Added null-check before calling `.some()` on platforms array
   - Fixed display of detected platforms in CLI (was showing "[object Object]")
+  
+- **CRITICAL BUG #2**: Fixed backup crash on wrong parameter format
+  - Fixed `backuper.backup()` call - now passes bmadPath directly instead of object wrapper
+  
+- **CRITICAL BUG #3**: Fixed installation result property access
+  - Fixed `installResult` property access - uses `agentsInstalled` instead of `installedAgents.length`
+  - Removed references to non-existent properties (`createdDirectories`, `generatedStubs`)
+  - Added error reporting for installation failures
+
+- **CRITICAL BUG #4**: Fixed wizard crash on undefined properties
+  - Added null-checks for `config.agents`, `config.targetPlatforms`, `config.platforms`
+  - Fixed wizard call to pass correct config object with all required properties
+  - Prevents crash when displaying installation summary
+
+- **CRITICAL BUG #5**: Fixed agent templates not found
+  - Limited recommendations to available agents only (byan, rachid, patnote, carmack, marc, etc.)
+  - Removed recommendations for non-existent agents (architect, dev, quinn, pm, ux-designer, tech-writer)
+  - Prevents installation failures due to missing template files
+
+- **CRITICAL BUG #6**: Fixed missing fileUtils.readDir function
+  - Added `readDir()` function to file-utils.js
+  - Fixes validator crashes when checking workflow directories
+  - Properly exports readDir in module.exports
+
+- **CRITICAL BUG #7**: Fixed installer config parameter mismatch
+  - Fixed installer.install() call to pass `targetPlatforms` instead of `platforms`
+  - Config file now created correctly during installation
+  - Matches InstallConfig typedef definition
+
+- **BUG #8**: Removed carmack from recommendations
+  - carmack.md template does not exist in templates/_bmad/
+  - Removed from baseAgents to prevent installation failures
+  - Updated E2E test to not expect carmack agent
 
 ## [1.2.1] - 2026-02-03
 

package/README.md

@@ -846,7 +846,7 @@ SOFTWARE.
 
 # 🏗️ YANSTALLER - Intelligent BYAN Installer
 
-[![Version](https://img.shields.io/badge/version-1.2.2-blue.svg)](https://www.npmjs.com/package/create-byan-agent)
+[![Version](https://img.shields.io/badge/version-1.2.3-blue.svg)](https://www.npmjs.com/package/create-byan-agent)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
 [![Tests](https://img.shields.io/badge/tests-168%20passing-success.svg)](#tests)
@@ -1015,13 +1015,16 @@ const validation = await yanstaller.validate({
 console.log(validation.errors); // []
 ```
 
-#### CLI Options
-```bash
-# Silent installation with specific agents
-create-byan-agent --silent --agents=byan,dev,quinn
-
-# Custom mode with specific platform
-create-byan-agent --mode=custom --platforms=copilot-cli
+#### CLI Options
+```bash
+# Silent installation with specific agents
+create-byan-agent --silent --agents=byan,dev,quinn
+
+# Force interactive prompts (useful inside npm scripts or CI shells without TTY)
+create-byan-agent --interactive
+
+# Custom mode with specific platform
+create-byan-agent --mode=custom --platforms=copilot-cli
 
 # Full installation without backup
 create-byan-agent --mode=full --no-backup

package/bin/create-byan-agent.js

@@ -14,9 +14,29 @@ const wizard = require('../lib/yanstaller/wizard');
 const backuper = require('../lib/yanstaller/backuper');
 const logger = require('../lib/utils/logger');
 
-const YANSTALLER_VERSION = '1.2.0';
-
-// ASCII Art Banner
+const YANSTALLER_VERSION = '1.2.3';
+
+function parseList(value) {
+  if (!value) return [];
+  if (Array.isArray(value)) return value.map(v => String(v).trim()).filter(Boolean);
+  return String(value)
+    .split(',')
+    .map(v => v.trim())
+    .filter(Boolean);
+}
+
+function normalizePlatformName(name) {
+  if (!name) return name;
+  const lower = String(name).toLowerCase();
+  if (lower === 'claude') return 'claude-code';
+  return lower;
+}
+
+function normalizePlatforms(list) {
+  return list.map(normalizePlatformName).filter(Boolean);
+}
+
+// ASCII Art Banner
 const banner = `
 ${chalk.blue('╔════════════════════════════════════════════════════════════╗')}
 ${chalk.blue('║')}                                                            ${chalk.blue('║')}
@@ -41,7 +61,7 @@ ${chalk.blue('╚═════════════════════
  * 6. VALIDATE - 10 automated checks
  * 7. WIZARD - Post-install actions
  */
-async function main() {
+async function main(options = {}) {
   try {
     console.clear();
     console.log(banner);
@@ -72,15 +92,80 @@ async function main() {
       logger.info(`✓ Recommended agents: ${chalk.cyan(recommendations.agents.join(', '))}`);
     }
     
-    // STEP 3: INTERVIEW - 7-Question Personalization
-    logger.info(chalk.bold('\n🎙️  STEP 3/7: Interview\n'));
-    const answers = await interviewer.ask(recommendations);
-    
-    // STEP 4: BACKUP (optional)
+    // STEP 3: INTERVIEW - 7-Question Personalization
+    const isSilent = !!options.silent;
+    const forceInteractive = !!options.interactive;
+    const hasTty = !!process.stdin.isTTY;
+    const forceSilent = !hasTty && !isSilent && !forceInteractive;
+    
+    if (forceSilent) {
+      logger.warn('No interactive TTY detected. Falling back to silent mode.');
+    }
+    if (!hasTty && forceInteractive) {
+      logger.warn('Interactive mode forced without TTY. Prompts may not render correctly.');
+    }
+    
+    let answers;
+    
+    if (isSilent || forceSilent) {
+      logger.info(chalk.bold('\nSTEP 3/7: Interview (skipped - silent)\n'));
+      
+      const parsedAgents = parseList(options.agents);
+      const parsedPlatforms = normalizePlatforms(parseList(options.platforms));
+      
+      let mode = options.mode || (parsedAgents.length > 0 ? 'custom' : (recommendations.mode || 'minimal'));
+      let agents = parsedAgents;
+      
+      if (agents.length === 0) {
+        if (mode === 'recommended' && recommendations && recommendations.agents) {
+          agents = recommendations.agents;
+        } else if (mode === 'minimal' || mode === 'full') {
+          agents = recommender.getAgentList(mode);
+        } else if (mode === 'custom') {
+          logger.warn('Custom mode selected without agents. Falling back to recommendations.');
+          agents = recommendations.agents || ['byan'];
+          mode = 'recommended';
+        } else {
+          agents = recommendations.agents || ['byan'];
+          mode = recommendations.mode || 'minimal';
+        }
+      }
+      
+      let targetPlatforms = parsedPlatforms;
+      if (targetPlatforms.length === 0) {
+        targetPlatforms = (detection.platforms || [])
+          .filter(p => p.detected)
+          .map(p => normalizePlatformName(p.name));
+      }
+      
+      answers = {
+        userName: 'Developer',
+        language: 'English',
+        mode,
+        agents,
+        targetPlatforms,
+        createSampleAgent: false,
+        createBackup: options.backup !== false
+      };
+    } else {
+      logger.info(chalk.bold('\nSTEP 3/7: Interview\n'));
+      const preferredPlatforms = normalizePlatforms(parseList(options.platforms));
+      answers = await interviewer.ask(recommendations, {
+        detection,
+        preferredPlatforms
+      });
+      
+      if (options.backup === false) {
+        answers.createBackup = false;
+      }
+    }
+    
+    // STEP 4: BACKUP (optional)
     if (answers.createBackup) {
       logger.info(chalk.bold('\n💾 STEP 4/7: Backup\n'));
       try {
-        const backup = await backuper.backup({ projectRoot });
+        const bmadPath = path.join(projectRoot, '_bmad');
+        const backup = await backuper.backup(bmadPath);
         logger.info(`✓ Backup created: ${chalk.cyan(backup.backupPath)}`);
       } catch (error) {
         logger.warn(`⚠ Backup failed (non-critical): ${error.message}`);
@@ -94,15 +179,16 @@ async function main() {
     const installResult = await installer.install({
       projectRoot,
       agents: answers.agents,
-      platforms: answers.targetPlatforms,
+      targetPlatforms: answers.targetPlatforms,
       userName: answers.userName,
       language: answers.language,
       mode: answers.mode
     });
     
-    logger.info(`✓ Installed ${chalk.cyan(installResult.installedAgents.length)} agents`);
-    logger.info(`✓ Created ${chalk.cyan(installResult.createdDirectories)} directories`);
-    logger.info(`✓ Generated ${chalk.cyan(installResult.generatedStubs)} platform stubs`);
+    logger.info(`✓ Installed ${chalk.cyan(installResult.agentsInstalled)} agents`);
+    if (installResult.errors && installResult.errors.length > 0) {
+      logger.warn(`⚠ ${installResult.errors.length} installation errors`);
+    }
     
     // STEP 6: VALIDATE - 10 Automated Checks
     logger.info(chalk.bold('\n✅ STEP 6/7: Validation\n'));
@@ -120,16 +206,22 @@ async function main() {
       }
     }
     
-    // STEP 7: WIZARD - Post-Install Actions
-    logger.info(chalk.bold('\n🧙 STEP 7/7: Post-Install Wizard\n'));
-    await wizard.show({
-      installedAgents: installResult.installedAgents,
-      platforms: answers.targetPlatforms,
-      userName: answers.userName,
-      language: answers.language
-    });
-    
-  } catch (error) {
+    // STEP 7: WIZARD - Post-Install Actions
+    if (isSilent || forceSilent) {
+      logger.info(chalk.bold('\nSTEP 7/7: Post-Install Wizard (skipped - silent)\n'));
+    } else {
+      logger.info(chalk.bold('\nSTEP 7/7: Post-Install Wizard\n'));
+      await wizard.show({
+        agents: answers.agents,
+        targetPlatforms: answers.targetPlatforms,
+        mode: answers.mode,
+        projectRoot,
+        userName: answers.userName,
+        language: answers.language
+      });
+    }
+    
+  } catch (error) {
     logger.error(chalk.red('\n❌ Installation failed:\n'));
     logger.error(error.message);
     if (error.stack) {
@@ -144,13 +236,14 @@ program
   .name('create-byan-agent')
   .description('YANSTALLER - Intelligent installer for BYAN ecosystem (29 agents, multi-platform)')
   .version(YANSTALLER_VERSION)
-  .option('--silent', 'Silent installation (no prompts)')
+  .option('--silent', 'Silent installation (no prompts)')
+  .option('--interactive', 'Force interactive prompts even without TTY')
   .option('--agents <agents>', 'Comma-separated list of agents to install')
   .option('--platforms <platforms>', 'Comma-separated list of platforms (copilot-cli,vscode,claude-code,codex)')
   .option('--mode <mode>', 'Installation mode: recommended, custom, minimal, full')
   .option('--no-backup', 'Skip pre-install backup')
   .option('--dry-run', 'Simulate installation without making changes')
   .option('--verbose', 'Verbose logging')
-  .action(main);
+  .action((opts) => main(opts));
 
 program.parse(process.argv);

package/lib/utils/file-utils.js

@@ -6,8 +6,8 @@
  * @module utils/file-utils
  */
 
-const fs = require('fs-extra');
-const path = require('path');
+const fs = require('fs-extra');
+const path = require('path');
 
 /**
  * Copy file or directory
@@ -92,13 +92,26 @@ async function writeFile(filePath, content) {
   await fs.writeFile(filePath, content, 'utf8');
 }
 
-module.exports = {
-  copy,
-  exists,
-  ensureDir,
-  remove,
-  readJSON,
-  writeJSON,
-  readFile,
-  writeFile
-};
+/**
+ * Read directory contents
+ * 
+ * @param {string} dirPath - Directory path
+ * @returns {Promise<string[]>} - Array of file/directory names
+ */
+async function readDir(dirPath) {
+  return fs.readdir(dirPath);
+}
+
+module.exports = {
+  constants: fs.constants,
+  copy,
+  exists,
+  ensureDir,
+  remove,
+  readJSON,
+  writeJSON,
+  readFile,
+  writeFile,
+  readDir,
+  access: fs.access
+};

package/lib/yanstaller/installer.js

@@ -166,19 +166,20 @@ async function copyAgentFile(agentName, projectRoot) {
 /**
  * Generate platform stubs for all agents
  * 
- * @param {string} platform - Platform name ('copilot-cli' | 'vscode' | 'claude' | 'codex')
+ * @param {string} platform - Platform name ('copilot-cli' | 'vscode' | 'claude-code' | 'codex')
  * @param {InstallConfig} config - Installation config
  * @returns {Promise<void>}
  */
-async function generatePlatformStubs(platform, config) {
-  const platformModule = require(`../platforms/${platform}`);
-  
-  if (!platformModule || typeof platformModule.install !== 'function') {
-    throw new Error(`Platform module not found or invalid: ${platform}`);
-  }
-  
-  await platformModule.install(config.projectRoot, config.agents, config);
-}
+async function generatePlatformStubs(platform, config) {
+  const normalized = platform === 'claude' ? 'claude-code' : platform;
+  const platformModule = require(`../platforms/${normalized}`);
+  
+  if (!platformModule || typeof platformModule.install !== 'function') {
+    throw new Error(`Platform module not found or invalid: ${platform}`);
+  }
+  
+  await platformModule.install(config.projectRoot, config.agents, config);
+}
 
 /**
  * Create module config file

package/lib/yanstaller/interviewer.js

@@ -8,10 +8,34 @@
  * @module yanstaller/interviewer
  */
 
-const inquirer = require('inquirer');
-const chalk = require('chalk');
-const logger = require('../utils/logger');
-
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const logger = require('../utils/logger');
+
+function normalizePlatformName(name) {
+  if (!name) return name;
+  const lower = String(name).toLowerCase();
+  if (lower === 'claude') return 'claude-code';
+  return lower;
+}
+
+function buildDefaultPlatforms(options = {}) {
+  const preferred = Array.isArray(options.preferredPlatforms)
+    ? options.preferredPlatforms.map(normalizePlatformName).filter(Boolean)
+    : [];
+  
+  if (preferred.length > 0) return preferred;
+  
+  const detected = (options.detection && Array.isArray(options.detection.platforms))
+    ? options.detection.platforms
+        .filter(p => p.detected)
+        .map(p => normalizePlatformName(p.name))
+        .filter(Boolean)
+    : [];
+  
+  return detected;
+}
+
 /**
  * @typedef {Object} InterviewResult
  * @property {string} userName
@@ -28,7 +52,7 @@ const logger = require('../utils/logger');
  * @param {import('./recommender').Recommendation} recommendation - Recommended config
  * @returns {Promise<InterviewResult>}
  */
-async function ask(recommendation) {
+async function ask(recommendation, options = {}) {
   logger.info(chalk.bold('\n🎙️  YANSTALLER Quick Interview\n'));
   logger.info('Just 5-7 questions to personalize your BYAN installation (<5 min)\n');
   
@@ -114,21 +138,25 @@ async function ask(recommendation) {
     selectedAgents = getAllAgents();
   }
   
-  // Q5: Target platforms
-  const platformAnswer = await inquirer.prompt([
-    {
-      type: 'checkbox',
-      name: 'platforms',
-      message: 'Which platforms to install on?',
-      choices: [
-        { name: 'GitHub Copilot CLI (.github/agents/)', value: 'copilot-cli', checked: true },
-        { name: 'VSCode Copilot Extension', value: 'vscode', checked: true },
-        { name: 'Codex (.codex/prompts/)', value: 'codex', checked: false },
-        { name: 'Claude Code (MCP server)', value: 'claude-code', checked: false }
-      ],
-      validate: (input) => input.length > 0 || 'Select at least one platform'
-    }
-  ]);
+  // Q5: Target platforms
+  const defaultPlatforms = buildDefaultPlatforms(options);
+  const useDefaultPlatforms = defaultPlatforms.length > 0;
+  const isDefault = (value, fallback) => useDefaultPlatforms ? defaultPlatforms.includes(value) : fallback;
+  
+  const platformAnswer = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'platforms',
+      message: 'Which platforms to install on?',
+      choices: [
+        { name: 'GitHub Copilot CLI (.github/agents/)', value: 'copilot-cli', checked: isDefault('copilot-cli', true) },
+        { name: 'VSCode Copilot Extension', value: 'vscode', checked: isDefault('vscode', true) },
+        { name: 'Codex (.codex/prompts/)', value: 'codex', checked: isDefault('codex', false) },
+        { name: 'Claude Code (MCP server)', value: 'claude-code', checked: isDefault('claude-code', false) }
+      ],
+      validate: (input) => input.length > 0 || 'Select at least one platform'
+    }
+  ]);
   
   // Q6: Create sample agent
   const sampleAnswer = await inquirer.prompt([

package/lib/yanstaller/recommender.js

@@ -176,18 +176,23 @@ function detectFramework(deps) {
  * @returns {string[]} - Agent names
  */
 function getRecommendedAgents(projectType, platforms = []) {
-  const baseAgents = ['byan', 'rachid', 'patnote', 'carmack'];
+  // Only recommend agents that exist in templates/_bmad/
+  // Available: byan, byan-test, rachid, patnote, marc, agent-builder, module-builder, workflow-builder
+  const availableAgents = ['byan', 'byan-test', 'rachid', 'patnote', 'marc', 'agent-builder', 'module-builder', 'workflow-builder'];
+  
+  const baseAgents = ['byan', 'rachid', 'patnote'];
   
   // Add MARC if Copilot CLI detected
   if (platforms && platforms.some(p => p.name === 'copilot-cli' && p.detected)) {
     baseAgents.push('marc');
   }
   
+  // Simple recommendations based on available agents only
   const recommendations = {
-    frontend: [...baseAgents, 'ux-designer', 'dev', 'quinn'],
-    backend: [...baseAgents, 'architect', 'dev', 'quinn'],
-    fullstack: [...baseAgents, 'architect', 'dev', 'ux-designer', 'quinn', 'pm'],
-    library: [...baseAgents, 'dev', 'tech-writer', 'quinn'],
+    frontend: [...baseAgents],
+    backend: [...baseAgents],
+    fullstack: [...baseAgents],
+    library: [...baseAgents],
     unknown: baseAgents
   };
   

package/lib/yanstaller/validator.js

@@ -11,7 +11,8 @@
 const path = require('path');
 const fileUtils = require('../utils/file-utils');
 const yamlUtils = require('../utils/yaml-utils');
-const { execSync } = require('child_process');
+const { execSync } = require('child_process');
+const fs = require('fs-extra');
 
 /**
  * @typedef {Object} ValidationResult
@@ -252,7 +253,7 @@ async function checkConfigFiles(config) {
     if (await fileUtils.exists(configPath)) {
       try {
         const configContent = await fileUtils.readFile(configPath, 'utf8');
-        const parsedConfig = yamlUtils.load(configContent);
+        const parsedConfig = yamlUtils.parse(configContent);
         
         // Validate required fields
         if (!parsedConfig.user_name) {
@@ -484,28 +485,51 @@ async function checkWorkflows(config) {
 /**
  * Check 9: Templates valid
  */
-async function checkTemplates(config) {
-  const templatesDir = path.join(__dirname, '..', '..', 'templates', '_bmad');
-  
-  if (!await fileUtils.exists(templatesDir)) {
-    return {
-      id: 'templates',
-      name: 'Template files',
-      passed: false,
-      message: 'Templates directory not found',
-      severity: 'warning'
-    };
-  }
-  
-  const modules = ['core', 'bmm', 'bmb', 'tea', 'cis'];
-  const issues = [];
-  
-  for (const module of modules) {
-    const agentsDir = path.join(templatesDir, module, 'agents');
-    if (!await fileUtils.exists(agentsDir)) {
-      issues.push(`${module}/agents missing`);
-    }
-  }
+async function checkTemplates(config) {
+  const templatesDir = path.join(__dirname, '..', '..', 'templates', '_bmad');
+  
+  if (!await fileUtils.exists(templatesDir)) {
+    return {
+      id: 'templates',
+      name: 'Template files',
+      passed: false,
+      message: 'Templates directory not found',
+      severity: 'warning'
+    };
+  }
+  
+  const entries = await fileUtils.readDir(templatesDir);
+  const modules = [];
+  for (const entry of entries) {
+    const entryPath = path.join(templatesDir, entry);
+    try {
+      const stat = await fs.stat(entryPath);
+      if (stat.isDirectory()) {
+        modules.push(entry);
+      }
+    } catch {
+      // Ignore unreadable entries
+    }
+  }
+  
+  if (modules.length === 0) {
+    return {
+      id: 'templates',
+      name: 'Template files',
+      passed: false,
+      message: 'No template modules found',
+      severity: 'warning'
+    };
+  }
+  
+  const issues = [];
+  
+  for (const module of modules) {
+    const agentsDir = path.join(templatesDir, module, 'agents');
+    if (!await fileUtils.exists(agentsDir)) {
+      issues.push(`${module}/agents missing`);
+    }
+  }
   
   if (issues.length > 0) {
     return {

package/lib/yanstaller/wizard.js

@@ -25,12 +25,30 @@ async function show(config) {
   logger.info(chalk.gray('═'.repeat(60)));
   logger.info('');
   
-  // Show installation summary
+  // Show installation summary with null-checks
   logger.info(chalk.bold('📊 Installation Summary:'));
-  logger.info(`   • Agents installed: ${chalk.cyan(config.agents.length)}`);
-  logger.info(`   • Platforms: ${chalk.cyan(config.targetPlatforms.join(', '))}`);
-  logger.info(`   • Mode: ${chalk.cyan(config.mode)}`);
-  logger.info(`   • Location: ${chalk.gray(config.projectRoot)}`);
+  
+  if (config && config.agents && Array.isArray(config.agents)) {
+    logger.info(`   • Agents installed: ${chalk.cyan(config.agents.length)}`);
+  } else {
+    logger.info(`   • Agents installed: ${chalk.cyan(0)}`);
+  }
+  
+  if (config && config.targetPlatforms && Array.isArray(config.targetPlatforms)) {
+    logger.info(`   • Platforms: ${chalk.cyan(config.targetPlatforms.join(', '))}`);
+  } else if (config && config.platforms && Array.isArray(config.platforms)) {
+    logger.info(`   • Platforms: ${chalk.cyan(config.platforms.join(', '))}`);
+  } else {
+    logger.info(`   • Platforms: ${chalk.cyan('none')}`);
+  }
+  
+  if (config && config.mode) {
+    logger.info(`   • Mode: ${chalk.cyan(config.mode)}`);
+  }
+  
+  if (config && config.projectRoot) {
+    logger.info(`   • Location: ${chalk.gray(config.projectRoot)}`);
+  }
   logger.info('');
   
   const choices = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-byan-agent",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "NPX installer for BYAN ecosystem - Agent creators (BYAN, BYAN-Test) with deployment (RACHID), integration (MARC), updates (PATNOTE), and optimization (CARMACK)",
   "bin": {
     "create-byan-agent": "bin/create-byan-agent.js"
@@ -9,7 +9,10 @@
     "start": "node bin/create-byan-agent.js",
     "test": "jest",
     "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
+    "test:coverage": "jest --coverage",
+    "test:e2e": "node test-e2e.js",
+    "pretest:e2e": "echo '\n🔍 Running E2E test before publish...\n'",
+    "prepublishOnly": "npm run test:e2e"
   },
   "keywords": [
     "byan",