create-byan-agent 2.7.0 → 2.7.2

package/lib/project-agents-generator.js

@@ -0,0 +1,238 @@
+/**
+ * Generate project-agents.md from Phase 2 analysis results
+ * Creates a structured document describing the agent ecosystem for the project
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+
+/**
+ * Generate the project-agents.md file
+ * @param {Object} phase2Results - JSON from yanstaller-phase2 agent
+ * @param {Object} genericAnswers - Q1-Q10 answers
+ * @param {Object} domainAnswers - Domain-specific answers
+ * @param {string} outputDir - Directory to write the file
+ * @returns {string} Path to generated file
+ */
+async function generateProjectAgentsDoc(phase2Results, genericAnswers, domainAnswers, outputDir) {
+  const lines = [];
+  
+  // Header
+  lines.push('# Project Agents Configuration');
+  lines.push('');
+  lines.push('> Generated by BYAN Yanstaller - Intelligent Interview');
+  lines.push(`> Date: ${new Date().toISOString().split('T')[0]}`);
+  lines.push('');
+  
+  // Project Overview
+  lines.push('## Project Overview');
+  lines.push('');
+  lines.push(`- **Type**: ${genericAnswers.projectType}`);
+  lines.push(`- **Domain**: ${genericAnswers.domain}`);
+  lines.push(`- **Team Size**: ${genericAnswers.teamSize}`);
+  lines.push(`- **Methodology**: ${genericAnswers.methodology}`);
+  lines.push(`- **Quality Level**: ${genericAnswers.quality}`);
+  lines.push('');
+  
+  // Domain Details
+  if (Object.keys(domainAnswers).length > 0) {
+    lines.push('### Tech Stack');
+    lines.push('');
+    for (const [key, value] of Object.entries(domainAnswers)) {
+      lines.push(`- **${formatKey(key)}**: ${value}`);
+    }
+    lines.push('');
+  }
+  
+  // Core Agents
+  if (phase2Results.coreAgents && phase2Results.coreAgents.length > 0) {
+    lines.push('## Core Agents');
+    lines.push('');
+    lines.push('These agents are essential for your project workflow.');
+    lines.push('');
+    
+    for (const agent of phase2Results.coreAgents) {
+      lines.push(`### ${formatAgentName(agent.name)}`);
+      lines.push('');
+      lines.push(`**Role**: ${agent.role}`);
+      lines.push('');
+      lines.push(`**Expertise**: ${agent.expertise.join(', ')}`);
+      lines.push('');
+      lines.push(`**Complexity**: ${getComplexityBadge(agent.complexity)}`);
+      lines.push('');
+    }
+  }
+  
+  // Optional Agents
+  if (phase2Results.optionalAgents && phase2Results.optionalAgents.length > 0) {
+    lines.push('## Optional Agents');
+    lines.push('');
+    lines.push('Activate these agents when specific conditions are met.');
+    lines.push('');
+    
+    for (const agent of phase2Results.optionalAgents) {
+      lines.push(`### ${formatAgentName(agent.name)}`);
+      lines.push('');
+      lines.push(`**Role**: ${agent.role}`);
+      lines.push('');
+      lines.push(`**When to use**: ${agent.when || 'As needed'}`);
+      lines.push('');
+    }
+  }
+  
+  // Agent Relationships
+  if (phase2Results.agentRelationships && phase2Results.agentRelationships.length > 0) {
+    lines.push('## Agent Relationships');
+    lines.push('');
+    lines.push('```mermaid');
+    lines.push('graph LR');
+    
+    for (const rel of phase2Results.agentRelationships) {
+      const arrow = getRelationshipArrow(rel.type);
+      lines.push(`    ${rel.from}${arrow}${rel.to}`);
+    }
+    
+    lines.push('```');
+    lines.push('');
+    lines.push('### Relationship Details');
+    lines.push('');
+    lines.push('| From | To | Type | Description |');
+    lines.push('|------|-----|------|-------------|');
+    
+    for (const rel of phase2Results.agentRelationships) {
+      lines.push(`| ${rel.from} | ${rel.to} | ${rel.type} | ${rel.description || '-'} |`);
+    }
+    lines.push('');
+  }
+  
+  // Project Structure
+  if (phase2Results.projectStructure) {
+    lines.push('## Project Structure');
+    lines.push('');
+    lines.push(`**Architecture**: ${phase2Results.projectStructure.type}`);
+    lines.push('');
+    
+    if (phase2Results.projectStructure.folders) {
+      lines.push('### Recommended Folders');
+      lines.push('');
+      lines.push('```');
+      for (const folder of phase2Results.projectStructure.folders) {
+        lines.push(folder);
+      }
+      lines.push('```');
+      lines.push('');
+    }
+    
+    if (phase2Results.projectStructure.keyFiles) {
+      lines.push('### Key Files');
+      lines.push('');
+      for (const file of phase2Results.projectStructure.keyFiles) {
+        lines.push(`- \`${file}\``);
+      }
+      lines.push('');
+    }
+  }
+  
+  // Custom Agents to Create
+  if (phase2Results.customAgentsToCreate && phase2Results.customAgentsToCreate.length > 0) {
+    lines.push('## Custom Agents to Create');
+    lines.push('');
+    lines.push('These specialized agents will be generated for your project.');
+    lines.push('');
+    
+    for (const agent of phase2Results.customAgentsToCreate) {
+      lines.push(`### ${formatAgentName(agent.name)}`);
+      lines.push('');
+      lines.push(`**Based on**: ${agent.template} template`);
+      lines.push('');
+      lines.push(`**Focus**: ${agent.focus}`);
+      lines.push('');
+      if (agent.mantras && agent.mantras.length > 0) {
+        lines.push('**Key Mantras**:');
+        for (const mantra of agent.mantras) {
+          lines.push(`- ${mantra}`);
+        }
+        lines.push('');
+      }
+    }
+  }
+  
+  // Configuration
+  lines.push('## Configuration');
+  lines.push('');
+  lines.push(`**Recommended Model**: \`${phase2Results.recommendedModel || 'gpt-5-mini'}\``);
+  lines.push('');
+  if (phase2Results.rationale) {
+    lines.push('### Rationale');
+    lines.push('');
+    lines.push(phase2Results.rationale);
+    lines.push('');
+  }
+  
+  // Usage Instructions
+  lines.push('## Usage');
+  lines.push('');
+  lines.push('### Activate Core Agents');
+  lines.push('');
+  lines.push('```bash');
+  lines.push('copilot');
+  lines.push('# Then type: /agent');
+  lines.push('# Select the agent you need');
+  lines.push('```');
+  lines.push('');
+  lines.push('### Create Custom Agents');
+  lines.push('');
+  lines.push('```bash');
+  lines.push('copilot --agent=byan');
+  lines.push('# Select: 1. Create New Agent');
+  lines.push('# Follow the interview process');
+  lines.push('```');
+  lines.push('');
+  
+  // Write file
+  const content = lines.join('\n');
+  const filePath = path.join(outputDir, 'project-agents.md');
+  await fs.ensureDir(outputDir);
+  await fs.writeFile(filePath, content, 'utf8');
+  
+  return filePath;
+}
+
+// Helper functions
+
+function formatKey(key) {
+  return key
+    .replace(/([A-Z])/g, ' $1')
+    .replace(/^./, str => str.toUpperCase())
+    .trim();
+}
+
+function formatAgentName(name) {
+  return name
+    .split('-')
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(' ');
+}
+
+function getComplexityBadge(complexity) {
+  switch (complexity) {
+    case 'simple': return '🟢 Simple (1-2 mantras)';
+    case 'medium': return '🟡 Medium (3-5 mantras)';
+    case 'complex': return '🔴 Complex (6+ mantras)';
+    default: return '⚪ Unknown';
+  }
+}
+
+function getRelationshipArrow(type) {
+  switch (type) {
+    case 'triggers': return ' -->|triggers| ';
+    case 'blocks': return ' -.->|blocks| ';
+    case 'informs': return ' -->|informs| ';
+    case 'depends': return ' ==>|depends| ';
+    default: return ' --> ';
+  }
+}
+
+module.exports = {
+  generateProjectAgentsDoc
+};

package/lib/utils/config-loader.js

@@ -0,0 +1,79 @@
+/**
+ * Config Loader Utility
+ * 
+ * Loads configuration files with variable resolution.
+ * 
+ * @module utils/config-loader
+ */
+
+const path = require('path');
+const yamlUtils = require('./yaml-utils');
+
+/**
+ * Load config file and resolve variables
+ * 
+ * @param {string} configPath - Path to config.yaml
+ * @param {Object} context - Context for variable resolution
+ * @returns {Promise<Object>}
+ */
+async function loadConfig(configPath, context = {}) {
+  const config = await yamlUtils.readYAML(configPath);
+  return resolveVariables(config, context);
+}
+
+/**
+ * Resolve variables in config object
+ * 
+ * @param {Object} config - Config object
+ * @param {Object} context - Context for variable resolution
+ * @returns {Object}
+ */
+function resolveVariables(config, context) {
+  const resolved = {};
+  
+  for (const [key, value] of Object.entries(config)) {
+    if (typeof value === 'string') {
+      resolved[key] = resolveVariable(value, context);
+    } else if (typeof value === 'object' && value !== null) {
+      resolved[key] = resolveVariables(value, context);
+    } else {
+      resolved[key] = value;
+    }
+  }
+  
+  return resolved;
+}
+
+/**
+ * Resolve single variable string
+ * 
+ * @param {string} value - Value with potential variables
+ * @param {Object} context - Context for variable resolution
+ * @returns {string}
+ */
+function resolveVariable(value, context) {
+  let resolved = value;
+  
+  // Replace {project-root}
+  if (context.projectRoot) {
+    resolved = resolved.replace(/\{project-root\}/g, context.projectRoot);
+  }
+  
+  // Replace {output_folder}
+  if (context.outputFolder) {
+    resolved = resolved.replace(/\{output_folder\}/g, context.outputFolder);
+  }
+  
+  // Replace {user_name}
+  if (context.userName) {
+    resolved = resolved.replace(/\{user_name\}/g, context.userName);
+  }
+  
+  return resolved;
+}
+
+module.exports = {
+  loadConfig,
+  resolveVariables,
+  resolveVariable
+};

package/lib/utils/file-utils.js

@@ -0,0 +1,104 @@
+/**
+ * File Utilities
+ * 
+ * Wrapper around fs-extra for common file operations.
+ * 
+ * @module utils/file-utils
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+
+/**
+ * Copy file or directory
+ * 
+ * @param {string} src - Source path
+ * @param {string} dest - Destination path
+ * @returns {Promise<void>}
+ */
+async function copy(src, dest) {
+  await fs.copy(src, dest);
+}
+
+/**
+ * Check if path exists
+ * 
+ * @param {string} filePath - File or directory path
+ * @returns {Promise<boolean>}
+ */
+async function exists(filePath) {
+  return fs.pathExists(filePath);
+}
+
+/**
+ * Ensure directory exists (create if not)
+ * 
+ * @param {string} dirPath - Directory path
+ * @returns {Promise<void>}
+ */
+async function ensureDir(dirPath) {
+  await fs.ensureDir(dirPath);
+}
+
+/**
+ * Remove file or directory
+ * 
+ * @param {string} filePath - File or directory path
+ * @returns {Promise<void>}
+ */
+async function remove(filePath) {
+  await fs.remove(filePath);
+}
+
+/**
+ * Read JSON file
+ * 
+ * @param {string} filePath - JSON file path
+ * @returns {Promise<Object>}
+ */
+async function readJSON(filePath) {
+  return fs.readJSON(filePath);
+}
+
+/**
+ * Write JSON file
+ * 
+ * @param {string} filePath - JSON file path
+ * @param {Object} data - Data to write
+ * @returns {Promise<void>}
+ */
+async function writeJSON(filePath, data) {
+  await fs.writeJSON(filePath, data, { spaces: 2 });
+}
+
+/**
+ * Read text file
+ * 
+ * @param {string} filePath - Text file path
+ * @returns {Promise<string>}
+ */
+async function readFile(filePath) {
+  return fs.readFile(filePath, 'utf8');
+}
+
+/**
+ * Write text file
+ * 
+ * @param {string} filePath - Text file path
+ * @param {string} content - Content to write
+ * @returns {Promise<void>}
+ */
+async function writeFile(filePath, content) {
+  await fs.writeFile(filePath, content, 'utf8');
+}
+
+module.exports = {
+  copy,
+  exists,
+  ensureDir,
+  remove,
+  readJSON,
+  writeJSON,
+  readFile,
+  writeFile
+};

package/lib/utils/git-detector.js

@@ -0,0 +1,35 @@
+/**
+ * Git Detector Utility
+ * 
+ * Detects if Git is installed.
+ * 
+ * @module utils/git-detector
+ */
+
+const { execSync } = require('child_process');
+
+/**
+ * Detect if Git is installed
+ * 
+ * @returns {Promise<{installed: boolean, version: string | null}>}
+ */
+async function detect() {
+  try {
+    const version = execSync('git --version', { encoding: 'utf8' }).trim();
+    const versionMatch = version.match(/git version ([\d.]+)/);
+    
+    return {
+      installed: true,
+      version: versionMatch ? versionMatch[1] : null
+    };
+  } catch {
+    return {
+      installed: false,
+      version: null
+    };
+  }
+}
+
+module.exports = {
+  detect
+};

package/lib/utils/logger.js

@@ -0,0 +1,64 @@
+/**
+ * Logger Utility
+ * 
+ * Wrapper around chalk and console for colored logging.
+ * 
+ * @module utils/logger
+ */
+
+const chalk = require('chalk');
+
+/**
+ * Log info message
+ * 
+ * @param {string} message - Message to log
+ */
+function info(message) {
+  console.log(chalk.blue('ℹ'), message);
+}
+
+/**
+ * Log success message
+ * 
+ * @param {string} message - Message to log
+ */
+function success(message) {
+  console.log(chalk.green('✓'), message);
+}
+
+/**
+ * Log warning message
+ * 
+ * @param {string} message - Message to log
+ */
+function warn(message) {
+  console.log(chalk.yellow('⚠'), message);
+}
+
+/**
+ * Log error message
+ * 
+ * @param {string} message - Message to log
+ */
+function error(message) {
+  console.error(chalk.red('✖'), message);
+}
+
+/**
+ * Log debug message (only if DEBUG env var set)
+ * 
+ * @param {string} message - Message to log
+ */
+function debug(message) {
+  if (process.env.DEBUG) {
+    console.log(chalk.gray('[DEBUG]'), message);
+  }
+}
+
+module.exports = {
+  info,
+  success,
+  warn,
+  error,
+  debug
+};

package/lib/utils/node-detector.js

@@ -0,0 +1,58 @@
+/**
+ * Node.js Detector Utility
+ * 
+ * Detects Node.js version.
+ * 
+ * @module utils/node-detector
+ */
+
+/**
+ * Detect Node.js version
+ * 
+ * @returns {string} - Version string (e.g., '18.19.0')
+ */
+function detect() {
+  return process.version.slice(1); // Remove 'v' prefix
+}
+
+/**
+ * Compare two semver versions
+ * 
+ * Strips version suffixes (-beta, -rc1, etc.) before comparison.
+ * 
+ * @param {string} version1 - First version
+ * @param {string} version2 - Second version
+ * @returns {number} - -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+ */
+function compareVersions(version1, version2) {
+  // Strip suffixes: '18.0.0-beta' → '18.0.0'
+  const cleanV1 = version1.replace(/-.*$/, '');
+  const cleanV2 = version2.replace(/-.*$/, '');
+  
+  const v1Parts = cleanV1.split('.').map(Number);
+  const v2Parts = cleanV2.split('.').map(Number);
+  
+  for (let i = 0; i < 3; i++) {
+    if (v1Parts[i] > v2Parts[i]) return 1;
+    if (v1Parts[i] < v2Parts[i]) return -1;
+  }
+  
+  return 0;
+}
+
+/**
+ * Check if Node version meets minimum requirement
+ * 
+ * @param {string} currentVersion - Current Node version
+ * @param {string} requiredVersion - Required Node version
+ * @returns {boolean}
+ */
+function meetsRequirement(currentVersion, requiredVersion) {
+  return compareVersions(currentVersion, requiredVersion) >= 0;
+}
+
+module.exports = {
+  detect,
+  compareVersions,
+  meetsRequirement
+};

package/lib/utils/os-detector.js

@@ -0,0 +1,74 @@
+/**
+ * OS Detector Utility
+ * 
+ * Detects operating system and version.
+ * 
+ * @module utils/os-detector
+ */
+
+const os = require('os');
+
+/**
+ * Detect operating system
+ * 
+ * @returns {{name: string, version: string, platform: string}}
+ */
+function detect() {
+  const platform = os.platform();
+  const release = os.release();
+  
+  let name;
+  switch (platform) {
+    case 'win32':
+      name = 'windows';
+      break;
+    case 'darwin':
+      name = 'macos';
+      break;
+    case 'linux':
+      name = 'linux';
+      break;
+    default:
+      name = 'unknown';
+  }
+  
+  return {
+    name,
+    version: release,
+    platform
+  };
+}
+
+/**
+ * Check if running on Windows
+ * 
+ * @returns {boolean}
+ */
+function isWindows() {
+  return os.platform() === 'win32';
+}
+
+/**
+ * Check if running on macOS
+ * 
+ * @returns {boolean}
+ */
+function isMacOS() {
+  return os.platform() === 'darwin';
+}
+
+/**
+ * Check if running on Linux
+ * 
+ * @returns {boolean}
+ */
+function isLinux() {
+  return os.platform() === 'linux';
+}
+
+module.exports = {
+  detect,
+  isWindows,
+  isMacOS,
+  isLinux
+};