create-byan-agent 1.2.3 → 1.2.4

package/CHANGELOG.md

@@ -5,7 +5,21 @@ 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.3] - 2026-02-03
+## [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

package/README.md

@@ -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.3';
-
-// 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,11 +92,75 @@ 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 {
@@ -122,18 +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({
-      agents: answers.agents,
-      targetPlatforms: answers.targetPlatforms,
-      mode: answers.mode,
-      projectRoot,
-      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) {
@@ -148,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
@@ -98,18 +98,20 @@ async function writeFile(filePath, content) {
  * @param {string} dirPath - Directory path
  * @returns {Promise<string[]>} - Array of file/directory names
  */
-async function readDir(dirPath) {
-  return fs.readdir(dirPath);
-}
-
-module.exports = {
-  copy,
-  exists,
-  ensureDir,
-  remove,
-  readJSON,
-  writeJSON,
-  readFile,
-  writeFile,
-  readDir
-};
+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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-byan-agent",
-  "version": "1.2.3",
+  "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"