create-byan-agent 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -0,0 +1,64 @@
+# Changelog - create-byan-agent
+
+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.0.2] - 2026-02-02
+
+### Added
+- **RACHID Agent**: NPM/NPX deployment specialist
+  - Install BYAN via npx create-byan-agent
+  - Validate _bmad directory structure
+  - Fix npm dependency conflicts
+  - Update package.json and scripts
+  - Publish to npm registry
+  - Test npx installations
+  - Security audits
+  - NPM best practices guidance
+
+- **MARC Agent**: GitHub Copilot CLI integration specialist
+  - Validate .github/agents/ structure
+  - Test /agent detection in Copilot CLI
+  - Create agent stubs for new agents
+  - Fix YAML frontmatter issues
+  - Configure MCP servers
+  - Test agent invocation
+  - Optimize context loading
+  - Troubleshoot agent loading issues
+
+- **Templates Directory**: All BYAN files now packaged
+  - Complete _bmad/bmb/ structure
+  - All agent definitions (byan.md, rachid.md, marc.md)
+  - All workflows with steps
+  - Templates and data files
+  - .github/agents/ stubs for Copilot CLI
+
+### Changed
+- Installer now copies complete file structure from templates/
+- Version bumped to 1.0.2
+- Enhanced verification checks (10 checks total)
+- Improved post-installation messages with usage for all 3 agents
+- Updated README with RACHID and MARC documentation
+
+### Fixed
+- Template directory resolution in getTemplateDir()
+- File copying logic for production npm packages
+- GitHub agents directory creation
+
+## [1.0.1] - 2026-02-01
+
+### Changed
+- Minor bug fixes
+- Documentation updates
+
+## [1.0.0] - 2026-02-01
+
+### Added
+- Initial release
+- BYAN agent with intelligent interview workflow
+- Multi-platform support (Copilot, VSCode, Claude, Codex)
+- 64 Mantras methodology
+- Merise Agile + TDD approach
+- NPX installer scaffolding

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,8 @@
 # BYAN - Builder of YAN
 
-**Version:** 1.0.0  
-**Methodology:** Merise Agile + TDD + 64 Mantras
+**Version:** 1.0.2  
+**Methodology:** Merise Agile + TDD + 64 Mantras  
+**Agents Included:** BYAN, RACHID, MARC
 
 ---
 
@@ -16,6 +17,8 @@
 - Multi-platform support (Copilot, VSCode, Claude, Codex)
 - TDD-driven validation
 - Consequences evaluation before actions
+- **NEW:** RACHID agent for NPM/NPX deployment
+- **NEW:** MARC agent for GitHub Copilot CLI integration
 
 ---
 
@@ -44,21 +47,31 @@ cd byan
 
 ## 📖 Usage
 
-### Activate BYAN
+### Activate Agents
 
 **GitHub Copilot CLI:**
 ```bash
-gh copilot suggest "activate byan agent"
+copilot
+# In interactive mode:
+/agent
+# Select one of:
+# - byan (create agents)
+# - rachid (NPM deployment)
+# - marc (Copilot CLI integration)
 ```
 
 **VSCode:**
 1. Open Command Palette (Ctrl+Shift+P)
-2. Type: "Activate BYAN Agent"
-3. Select BYAN from list
+2. Type: "Activate Agent"
+3. Select BYAN, RACHID, or MARC from list
 
 **Claude Code:**
 ```bash
 claude chat --agent byan
+# or
+claude chat --agent rachid
+# or
+claude chat --agent marc
 ```
 
 ### Create Your First Agent
@@ -77,6 +90,41 @@ Best for: Additional agents, clear requirements, existing project context
 
 ---
 
+## 🎯 Three Specialized Agents
+
+### 1. BYAN - Agent Creator
+**Full Interview (30-45 min):**
+```
+[INT] Start Intelligent Interview
+```
+Best for: First agent, critical agents, complex requirements
+
+**Quick Create (10 min):**
+```
+[QC] Quick Create
+```
+Best for: Additional agents, clear requirements, existing project context
+
+### 2. RACHID - NPM/NPX Specialist
+**Deploy to NPM:**
+```
+[PUBLISH] Publish to npm
+[VALIDATE] Validate _bmad structure
+[TEST-NPX] Test npx installation
+```
+Best for: Package deployment, dependency management, npm workflows
+
+### 3. MARC - Copilot CLI Expert
+**Copilot Integration:**
+```
+[VALIDATE] Validate .github/agents/
+[TEST] Test /agent detection
+[CREATE-STUB] Create agent stub
+```
+Best for: GitHub Copilot CLI integration, agent detection, MCP configuration
+
+---
+
 ## 🎯 BYAN Menu
 
 | Command | Description | Duration |

package/bin/create-byan-agent-backup.js

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+
+const fs = require('fs-extra');
+const path = require('path');
+const { program } = require('commander');
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const ora = require('ora');
+const yaml = require('js-yaml');
+
+const BYAN_VERSION = '1.0.0';
+
+// ASCII Art Banner
+const banner = `
+${chalk.blue('╔════════════════════════════════════════════════════════════╗')}
+${chalk.blue('║')}                                                            ${chalk.blue('║')}
+${chalk.blue('║')}   ${chalk.bold('🏗️  BYAN INSTALLER v' + BYAN_VERSION)}                        ${chalk.blue('║')}
+${chalk.blue('║')}   ${chalk.gray('Builder of YAN - Agent Creator')}                          ${chalk.blue('║')}
+${chalk.blue('║')}                                                            ${chalk.blue('║')}
+${chalk.blue('║')}   ${chalk.gray('Methodology: Merise Agile + TDD + 64 Mantras')}           ${chalk.blue('║')}
+${chalk.blue('║')}                                                            ${chalk.blue('║')}
+${chalk.blue('╚════════════════════════════════════════════════════════════╝')}
+`;
+
+// Main installer
+async function install() {
+  console.clear();
+  console.log(banner);
+  
+  const projectRoot = process.cwd();
+  
+  // Step 1: Detect project type
+  const spinner = ora('Detecting project type...').start();
+  
+  const isGitRepo = await fs.pathExists(path.join(projectRoot, '.git'));
+  const hasPackageJson = await fs.pathExists(path.join(projectRoot, 'package.json'));
+  const hasPyProject = await fs.pathExists(path.join(projectRoot, 'pyproject.toml'));
+  
+  if (!isGitRepo && !hasPackageJson && !hasPyProject) {
+    spinner.warn('Not in a recognized project directory');
+    
+    const { continueAnyway } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'continueAnyway',
+        message: 'BYAN works best in a project with version control. Continue anyway?',
+        default: false
+      }
+    ]);
+    
+    if (!continueAnyway) {
+      console.log(chalk.yellow('Installation cancelled.'));
+      process.exit(0);
+    }
+  } else {
+    spinner.succeed('Project detected');
+  }
+  
+  // Step 2: Platform selection
+  const { platform } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'platform',
+      message: 'Select platform to install for:',
+      choices: [
+        { name: 'GitHub Copilot CLI', value: 'copilot' },
+        { name: 'VSCode', value: 'vscode' },
+        { name: 'Claude Code', value: 'claude' },
+        { name: 'Codex', value: 'codex' },
+        { name: 'All platforms', value: 'all' }
+      ]
+    }
+  ]);
+  
+  // Step 3: User configuration
+  const config = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'userName',
+      message: 'Your name:',
+      default: 'Developer'
+    },
+    {
+      type: 'list',
+      name: 'language',
+      message: 'Communication language:',
+      choices: ['Francais', 'English'],
+      default: 'English'
+    }
+  ]);
+  
+  // Step 4: Create directory structure
+  const installSpinner = ora('Creating directory structure...').start();
+  
+  const bmadDir = path.join(projectRoot, '_bmad');
+  const bmbDir = path.join(bmadDir, 'bmb');
+  
+  await fs.ensureDir(path.join(bmadDir, 'bmb', 'agents'));
+  await fs.ensureDir(path.join(bmadDir, 'bmb', 'workflows', 'byan', 'steps'));
+  await fs.ensureDir(path.join(bmadDir, 'bmb', 'workflows', 'byan', 'templates'));
+  await fs.ensureDir(path.join(bmadDir, 'bmb', 'workflows', 'byan', 'data'));
+  await fs.ensureDir(path.join(bmadDir, 'core'));
+  await fs.ensureDir(path.join(bmadDir, '_config'));
+  await fs.ensureDir(path.join(bmadDir, '_memory'));
+  await fs.ensureDir(path.join(bmadDir, '_output'));
+  
+  installSpinner.succeed('Directory structure created');
+  
+  // Step 5: Copy BYAN files
+  const copySpinner = ora('Installing BYAN files...').start();
+  
+  // In production, these would be copied from the package
+  // For now, we'll create minimal config
+  
+  const configContent = {
+    bmb_creations_output_folder: "{project-root}/_bmad-output/bmb-creations",
+    user_name: config.userName,
+    communication_language: config.language,
+    document_output_language: config.language,
+    output_folder: "{project-root}/_bmad-output",
+    platform: platform
+  };
+  
+  const configPath = path.join(bmbDir, 'config.yaml');
+  await fs.writeFile(configPath, yaml.dump(configContent), 'utf8');
+  
+  copySpinner.succeed('BYAN files installed');
+  
+  // Step 6: Create shortcuts
+  const shortcutSpinner = ora('Creating shortcuts...').start();
+  
+  // Create package.json scripts if it exists
+  if (hasPackageJson) {
+    const pkgPath = path.join(projectRoot, 'package.json');
+    const pkg = await fs.readJson(pkgPath);
+    
+    if (!pkg.scripts) pkg.scripts = {};
+    
+    if (!pkg.scripts.byan) {
+      pkg.scripts.byan = 'echo "BYAN agent installed. Activate in your AI platform."';
+      await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+      shortcutSpinner.succeed('NPM script added');
+    } else {
+      shortcutSpinner.info('NPM script already exists');
+    }
+  } else {
+    shortcutSpinner.succeed('Shortcuts created');
+  }
+  
+  // Step 7: Verification
+  const verifySpinner = ora('Verifying installation...').start();
+  
+  const checks = [
+    await fs.pathExists(path.join(bmbDir, 'agents')),
+    await fs.pathExists(path.join(bmbDir, 'workflows', 'byan')),
+    await fs.pathExists(configPath)
+  ];
+  
+  const passed = checks.filter(Boolean).length;
+  
+  if (passed === checks.length) {
+    verifySpinner.succeed(`Verification: ${passed}/${checks.length} checks passed`);
+  } else {
+    verifySpinner.warn(`Verification: ${passed}/${checks.length} checks passed`);
+  }
+  
+  // Success message
+  console.log('');
+  console.log(chalk.green('╔════════════════════════════════════════════════════════════╗'));
+  console.log(chalk.green('║                                                            ║'));
+  console.log(chalk.green('║   ✅ BYAN INSTALLATION COMPLETE!                           ║'));
+  console.log(chalk.green('║                                                            ║'));
+  console.log(chalk.green('╚════════════════════════════════════════════════════════════╝'));
+  console.log('');
+  
+  console.log(chalk.bold('Installation Summary:'));
+  console.log(`  • Platform: ${chalk.cyan(platform)}`);
+  console.log(`  • Installation Directory: ${chalk.cyan(bmbDir)}`);
+  console.log(`  • Configuration: ${chalk.cyan(configPath)}`);
+  console.log(`  • User: ${chalk.cyan(config.userName)}`);
+  console.log(`  • Language: ${chalk.cyan(config.language)}`);
+  console.log('');
+  
+  console.log(chalk.bold('Next Steps:'));
+  console.log('');
+  console.log(chalk.yellow('1. Activate BYAN:'));
+  
+  if (platform === 'copilot') {
+    console.log(`   ${chalk.blue('gh copilot suggest "activate byan agent"')}`);
+  } else if (platform === 'vscode') {
+    console.log('   Open VSCode Command Palette (Ctrl+Shift+P)');
+    console.log('   Type: "Activate BYAN Agent"');
+  } else if (platform === 'claude') {
+    console.log(`   ${chalk.blue('claude chat --agent byan')}`);
+  }
+  
+  console.log('');
+  console.log(chalk.yellow('2. Create your first agent:'));
+  console.log('   [INT] Start Intelligent Interview (30-45 min)');
+  console.log('   [QC] Quick Create (10 min)');
+  console.log('');
+  
+  console.log(chalk.yellow('3. Explore documentation:'));
+  console.log(`   • Configuration: ${chalk.cyan(configPath)}`);
+  console.log(`   • Workflows: ${chalk.cyan(path.join(bmbDir, 'workflows', 'byan'))}`);
+  console.log('');
+  
+  console.log(chalk.gray('Need help? Type \'/bmad-help\' when BYAN is active'));
+  console.log('');
+  console.log(chalk.blue('Happy agent building! 🏗️'));
+}
+
+// CLI Program
+program
+  .name('create-byan-agent')
+  .description('Install BYAN - Builder of YAN agent creator')
+  .version(BYAN_VERSION)
+  .action(install);
+
+program.parse(process.argv);