npm - create-byan-agent - Versions diffs - 2.6.1 → 2.7.0 - Mend

create-byan-agent 2.6.1 → 2.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (903) hide show

package/README-BYAN-V2.md DELETED Viewed

@@ -1,446 +0,0 @@
-# BYAN v2.0 - Intelligent Agent Creator for GitHub Copilot CLI
-**BYAN** (Builder of YAN) v2.0 is a specialized GitHub Copilot CLI agent that creates custom AI agents through intelligent, structured interviews.
-## 🎯 What is BYAN?
-BYAN guides you through a conversational interview to understand your needs, then automatically generates production-ready agent profiles for GitHub Copilot CLI. It applies **Merise Agile + TDD methodology** with **64 core mantras** to ensure quality and consistency.
-### Key Features
-#### Core Capabilities
-- **Intelligent Interview System**: 4-phase structured interview (Context → Business → Agent Needs → Validation)
-- **Automatic Profile Generation**: Creates `.md` agent files with YAML frontmatter + agent specifications
-- **Built-in Validation**: Validates agent profiles against GitHub Copilot CLI requirements
-- **Template System**: Flexible templates with placeholder resolution
-- **Quality Enforcement**: Mantra IA-23 (Zero Emoji Pollution), clean code principles
-- **State Machine Workflow**: INTERVIEW → ANALYSIS → GENERATION → COMPLETED
-#### 🆕 BMAD Features (v2.1.0)
-**NEW: 4 Advanced Modules for Enhanced Agent Creation**
-1. **📚 Glossary Builder**
-   - Auto-builds domain-specific glossaries during interviews
-   - Validates definition clarity (min score: 0.7)
-   - Auto-triggers for complex domains (ecommerce, finance, healthcare)
-   - Suggests related concepts based on context
-   - **Tests**: 86/86 passing
-2. **🔍 Five Whys Analyzer**
-   - Automated root cause analysis using "5 Whys" technique
-   - Detects pain points with 10+ keywords
-   - Asks up to 5 sequential WHY questions
-   - Early root cause detection at depth 3+
-   - Categorizes causes (technical/process/people/resource)
-   - **Tests**: 93/93 passing
-3. **👂 Active Listener**
-   - Intelligent response processing with reformulation
-   - Automatic reformulation every 3rd response
-   - Validates confirmations and detects ambiguity
-   - Analyzes session patterns
-   - Generates session summaries with insights
-   - **Tests**: 124/124 passing
-4. **✅ Mantras Validator**
-   - Validates agents against 64 BMAD/IA mantras
-   - Category-based validation (Philosophy, Process, Quality, AI-Specific)
-   - Compliance scoring (target: 80%+)
-   - Detailed violation reports
-   - Self-validating (meta!)
-   - **Tests**: 67/67 passing
-**Total BMAD Tests**: 417/417 passing (100%)
-See [BMAD-QUICK-REFERENCE.md](./BMAD-QUICK-REFERENCE.md) for usage examples.
-## 📦 Installation
-### Option 1: Via NPM (Recommandé)
-```bash
-# Installation globale
-npm install -g create-byan-agent
-# OU utilisation directe avec npx
-npx create-byan-agent
-```
-### Option 2: Via Git (Pour Développement)
-```bash
-# Cloner le repository
-git clone <repository-url>
-cd <repository-directory>
-# Installer les dépendances
-npm install
-# Lancer les tests
-npm test
-```
-## 🎬 Quick Start
-### Utilisation via NPX
-```bash
-# Créer un agent interactivement
-npx create-byan-agent
-# Ou utiliser l'API
-node -e "
-const ByanV2 = require('create-byan-agent');
-const byan = new ByanV2();
-byan.startSession().then(() => {
-  console.log('BYAN démarré!');
-});
-"
-```
-### Utilisation Programmatique
-```javascript
-const ByanV2 = require('create-byan-agent');
-// Créer une instance
-const byan = new ByanV2({
-  maxQuestions: 12,
-  outputDir: './_byan-output/bmb-creations'
-});
-// Démarrer une session
-await byan.startSession();
-// Obtenir une question
-const question = await byan.getNextQuestion();
-console.log(question.text);
-// Soumettre une réponse
-await byan.submitResponse('Ma réponse');
-// Continuer jusqu'à complétion...
-```
-for (let i = 0; i < 11; i++) {
-  const nextQuestion = await byan.getNextQuestion();
-  console.log(nextQuestion);
-  await byan.submitResponse('Your answer');
-}
-```
-### 4. Generate agent profile
-```javascript
-// Generate agent profile after interview
-const profile = await byan.generateProfile();
-// Profile is automatically saved to:
-// .github/copilot/agents/<agent-name>.md
-console.log('Agent profile created!');
-```
-## 💡 Usage Examples
-### Example 1: Create Code Review Agent
-```javascript
-const ByanV2 = require('create-byan-agent');
-async function createCodeReviewAgent() {
-  const byan = new ByanV2();
-  await byan.startSession();
-  // Answer interview questions
-  const responses = [
-    'code-review-assistant',
-    'An agent that reviews code for bugs and best practices',
-    'Software Development',
-    'Small team (1-5)',
-    'Yes',
-    'Code analysis, bug detection, best practices',
-    'Professional and constructive',
-    'Static analysis, pattern detection',
-    'Markdown reports with examples',
-    'Medium complexity',
-    'Yes',
-    'Yes'
-  ];
-  for (const response of responses) {
-    await byan.submitResponse(response);
-  }
-  const profile = await byan.generateProfile();
-  console.log('✅ Agent created:', profile.filePath);
-}
-createCodeReviewAgent();
-```
-### Example 2: With BMAD Features
-```javascript
-const ByanV2 = require('create-byan-agent');
-async function createWithBMAD() {
-  const byan = new ByanV2({
-    bmad_features: {
-      glossary_builder: { enabled: true },
-      five_whys: { enabled: true },
-      active_listener: { enabled: true },
-      mantras_validator: { enabled: true }
-    }
-  });
-  await byan.startSession();
-  // Start glossary for ecommerce domain
-  const glossary = byan.startGlossary('ecommerce');
-  byan.addConcept('Order', 'A customer purchase request...');
-  // Detect pain points
-  const detection = byan.detectPainPoints('Slow checkout process');
-  if (detection.needsWhys) {
-    const question = byan.askWhy();
-    // ... 5 Whys analysis
-  }
-  // Generate and validate
-  const profile = await byan.generateProfile();
-  const validation = byan.validateAgent(profile.content);
-  console.log(`Score: ${validation.score * 100}%`);
-}
-createWithBMAD();
-```
-### Example 3: Custom Configuration
-```javascript
-const byan = new ByanV2({
-  maxQuestions: 15,
-  outputDir: './my-agents',
-  env: 'standalone',
-  complexityThresholds: {
-    low: 25,
-    medium: 70
-  }
-});
-```
-## 📚 Core Concepts
-### State Machine
-BYAN uses a state machine to manage the workflow:
-```
-INTERVIEW → ANALYSIS → GENERATION → COMPLETED
-     ↓          ↓            ↓
-   ERROR ← ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
-```
-### Interview Phases
-1. **CONTEXT** (Questions 1-3): Project name, description, tech stack
-2. **BUSINESS** (Questions 4-6): Domain, actors, processes
-3. **AGENT_NEEDS** (Questions 7-9): Role, capabilities, style
-4. **VALIDATION** (Questions 10-12): Confirmation, edge cases
-### Profile Structure
-Generated agent profiles follow this structure:
-```markdown
----
-name: "agent-name"
-description: "Brief description"
----
-You must fully embody this agent's persona...
-```xml
-<agent id="agent.id" name="AgentName" title="Title" icon="🔧">
-  <activation>...</activation>
-  <persona>...</persona>
-  <capabilities>...</capabilities>
-</agent>
-\```
-```
-## 🔧 Configuration
-### Default Configuration
-```javascript
-{
-  maxQuestions: 12,
-  complexityThresholds: {
-    low: 30,
-    medium: 60
-  },
-  outputDir: './_byan-output/bmb-creations',
-  env: 'copilot' // or 'standalone'
-}
-```
-### Environment Variables
-- `GITHUB_COPILOT=true` - Enables Copilot CLI context detection
-## 🧪 Testing
-```bash
-# Run all tests
-npm test
-# Run specific test suite
-npm test -- __tests__/byan-v2/context
-# Run with coverage
-npm test -- --coverage
-```
-**Current Test Status**:
-- **Total**: 1,308 tests passing (100%)
-- **Core v2.0**: 891/891 passing
-- **BMAD v2.1**: 417/417 passing
-- **Coverage**: 95%+
-## 📖 API Reference
-See [API.md](./API.md) for complete API documentation.
-### ByanV2
-Main class for BYAN v2 operations.
-**Methods:**
-- `constructor(config)` - Initialize BYAN with optional config
-- `startSession()` - Start new interview session
-- `getNextQuestion()` - Get next interview question
-- `submitResponse(response)` - Submit response to current question
-- `generateProfile()` - Generate agent profile after interview
-- `endSession()` - End current session
-- `getMetricsSummary()` - Get session metrics
-- `isCopilotContext()` - Check if running in Copilot CLI
-### AgentProfileValidator
-Validate agent profile files.
-**Methods:**
-- `validate(profileContent)` - Validate profile content
-- `validateYamlFrontmatter(content)` - Validate YAML frontmatter
-- `validateNameFormat(name)` - Validate agent name format
-- `detectEmojis(text)` - Detect emoji pollution
-### ProfileTemplate
-Template rendering system.
-**Methods:**
-- `render(template, data)` - Render template with data
-- `loadTemplate(templateName)` - Load template from file
-- `renderFromFile(templateName, data)` - Load and render template
-- `validateTemplate(template, requiredPlaceholders)` - Validate template
-- `extractPlaceholders(template)` - Extract placeholders from template
-## ⚠️ Troubleshooting
-### Issue: Tests failing with winston errors
-**Solution**: Ensure winston is installed:
-```bash
-npm install winston
-```
-### Issue: UUID import errors
-**Solution**: BYAN v2 uses crypto.randomUUID() (Node 18+). Ensure Node version >= 18.
-### Issue: Agent profile not validated
-**Solution**: Check profile follows format:
-- Valid YAML frontmatter with `name` and `description`
-- Name format: lowercase, alphanumeric, hyphens only
-- Description: 10-200 characters
-- No emojis (Mantra IA-23)
-- File size < 50KB
-## 🤝 Contributing
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for development guidelines.
-### Development Setup
-```bash
-# Clone repo
-git clone <repository-url>
-# Install dependencies
-npm install
-# Run tests in watch mode
-npm test -- --watch
-# Check code style
-npm run lint
-```
-### Running in Development
-```bash
-# Start development mode
-npm run dev
-# Run single test file
-npm test -- __tests__/byan-v2/integration/system-integration.test.js
-```
-## 📐 Architecture
-See [ARCHITECTURE.md](./ARCHITECTURE.md) for detailed architecture documentation.
-### High-Level Components
-```
-┌─────────────────┐
-│   ByanV2 Main   │
-└────────┬────────┘
-         │
-    ┌────┴─────────────────┐
-    │                      │
-┌───▼────────┐      ┌─────▼──────┐
-│ Session    │      │ State      │
-│ State      │      │ Machine    │
-└────────────┘      └─────┬──────┘
-                          │
-              ┌───────────┼───────────┐
-              │           │           │
-         ┌────▼────┐ ┌───▼────┐ ┌───▼────────┐
-         │Interview│ │Analysis│ │Generation  │
-         │ State   │ │ State  │ │ State      │
-         └─────────┘ └────────┘ └────────────┘
-```
-## 📄 License
-See LICENSE file for details.
-## 🙏 Credits
-Built with:
-- **Merise Agile + TDD** methodology
-- **64 Core Mantras** for quality
-- **Zero Trust** principle (Challenge Before Confirm)
-- **Mantra IA-23**: Zero Emoji Pollution
----
-**Version**: 2.0.0-alpha
-**Status**: MVP Complete (64/77 SP delivered)
-**Test Coverage**: 95% (492/517 tests passing)

package/TEST-GUIDE-v2.3.2.md DELETED Viewed

@@ -1,161 +0,0 @@
-# Test Guide - v2.3.2 Node.js 12+ Compatibility
-## What Was Fixed
-### Problem on Server (Node v12.22.12)
-```
-SyntaxError: Unexpected token '.'
-at line 529: interviewResults.agents.essential?.join(', ')
-```
-**Root cause:** Optional chaining operator (`?.`) not supported in Node < 14
-### Solution Applied
-Replaced all optional chaining in `install/` directory:
-**Before (Node 14+ only):**
-```javascript
-interviewResults.agents.essential?.join(', ')
-config?.systemPrompt
-info?.specialist || null
-```
-**After (Node 12+ compatible):**
-```javascript
-interviewResults.agents.essential ? interviewResults.agents.essential.join(', ') : 'none'
-config ? config.systemPrompt : undefined
-info ? (info.specialist || null) : null
-```
-### Files Modified
-1. `install/bin/create-byan-agent-v2.js` - 4 fixes
-2. `install/lib/phase2-chat.js` - 1 fix
-3. `install/lib/yanstaller/platform-selector.js` - 2 fixes
-4. `install/lib/yanstaller/agent-launcher.js` - 2 fixes
-5. `package.json` - engines: `node >=12.0.0` (was >=18.0.0)
-**Total:** 9 optional chaining operators removed
----
-## Testing on Node 12
-### Install Test (Node v12.22.12)
-```bash
-# Clean install
-sudo npm install -g create-byan-agent@2.3.2
-# Should now work without syntax errors
-create-byan-agent --version
-# → 2.3.2
-```
-### Quick Mode Test
-```bash
-cd /tmp/test-project
-npm init -y
-# Run installer in AUTO mode
-npx create-byan-agent@2.3.2
-# Select: 🚀 AUTO - Quick install
-```
-### Custom Mode Test
-```bash
-cd /tmp/test-project-2
-npm init -y
-# Run installer in CUSTOM mode
-npx create-byan-agent@2.3.2
-# Select: 🎯 CUSTOM - Guided interview
-# Answer questions...
-# Select AI platform: GitHub Copilot CLI / Codex / Claude
-# Auth check should work
-# Phase 2 conversation should work
-```
----
-## Expected Behavior
-### ✅ Should Work
-- No syntax errors on Node 12+
-- Installation completes successfully
-- All interactive prompts work
-- Platform selection works
-- Auth verification works
-- Phase 2 conversation works (if authenticated)
-### ⚠️ Graceful Degradation
-If not authenticated to AI platform:
-```
-⚠️  copilot n'est pas authentifié ou non disponible
-   Pour vous connecter, exécutez: gh auth login
-? Continuer avec configuration AUTO (sans conversation)? (Y/n)
-```
----
-## Version History
-| Version | Date | Node Support | Changes |
-|---------|------|--------------|---------|
-| 2.3.0 | Feb 11 | >=18.0.0 | Cost optimizer integration |
-| 2.3.1 | Feb 11 | >=18.0.0 | AI platform selection + auth |
-| 2.3.2 | Feb 11 | >=12.0.0 | **Node 12+ compatibility** ✅ |
----
-## Verification Checklist
-**On Node 12 server:**
-- [ ] `npm install -g create-byan-agent@2.3.2` succeeds
-- [ ] `create-byan-agent --version` returns `2.3.2`
-- [ ] `create-byan-agent` launches without syntax errors
-- [ ] AUTO mode completes successfully
-- [ ] CUSTOM mode shows platform selection
-- [ ] Auth check provides helpful error if not logged in
-- [ ] Can fallback to AUTO if auth fails
-**On Node 18+ (modern):**
-- [ ] All above tests pass
-- [ ] No regressions
-- [ ] Cost optimizer worker still works
----
-## NPM Publication
-```bash
-cd ~/conception
-npm publish --access public --otp=XXXXXX
-```
-**Package:** create-byan-agent@2.3.2
-**Size:** 1.4 MB tarball, 5.5 MB unpacked
-**Files:** 894
-**Node:** >=12.0.0 ✅
----
-## Rollback Plan
-If issues on Node 18+:
-```bash
-npm install -g create-byan-agent@2.3.0
-```
-If issues on Node 12:
-```bash
-# Upgrade Node.js on server (recommended)
-nvm install 18
-nvm use 18
-npm install -g create-byan-agent@2.3.2
-```
----
-**Status:** Ready for NPM publication
-**Tested:** Syntax validation passed
-**Compatibility:** Node 12.0.0 to latest ✅

package/install/BUGFIX-SUMMARY.txt DELETED Viewed

@@ -1,91 +0,0 @@
-╔══════════════════════════════════════════════════════════════════════╗
-║                                                                      ║
-║               🚨 BYAN INSTALLER - BUG CRITIQUE RÉSOLU 🚨             ║
-║                                                                      ║
-╚══════════════════════════════════════════════════════════════════════╝
-DATE       : 2026-02-03
-VERSION    : 1.1.2 → 1.1.3
-RAPPORTÉ   : Dimitry
-RÉSOLU PAR : MARC 🤖 (GitHub Copilot CLI Integration Specialist)
-STATUS     : ✅ CORRIGÉ & VALIDÉ - PRÊT POUR PUBLICATION
-══════════════════════════════════════════════════════════════════════════
-🔴 PROBLÈME
-──────────────────────────────────────────────────────────────────────────
-npx create-byan-agent → 0 fichiers copiés
-Résultat : Installation inutilisable, utilisateurs bloqués
-══════════════════════════════════════════════════════════════════════════
-🐛 BUGS TROUVÉS (6)
-──────────────────────────────────────────────────────────────────────────
-1. Ligne 28  : Mauvais chemin template (remonte 2x au lieu d'1x)
-2. Ligne 139 : Pas de validation (échoue silencieusement)
-3. Ligne 154 : Chemin agents sans _bmad/
-4. Ligne 165 : Chemin workflows sans _bmad/
-5. Ligne 176 : Chemin .github remonte trop haut
-6. Lignes    : Logging insuffisant
-══════════════════════════════════════════════════════════════════════════
-✅ CORRECTIONS
-──────────────────────────────────────────────────────────────────────────
-path.join(__dirname, '..', '..', 'create-byan-agent', 'templates')  ❌
-path.join(__dirname, '..', 'templates')                             ✅
-+ Ajout _bmad/ dans chemins agents/workflows
-+ Suppression .. dans chemin .github
-+ Validation templateDir avant copie
-+ Meilleur logging
-══════════════════════════════════════════════════════════════════════════
-📊 IMPACT
-──────────────────────────────────────────────────────────────────────────
-Taux succès :    0% → 100% ✅
-Fichiers    :  0/37 → 37/37 ✅
-Agents      :   0/8 → 8/8 ✅
-Workflows   :   0/6 → 6/6 ✅
-Stubs       :  0/23 → 23/23 ✅
-══════════════════════════════════════════════════════════════════════════
-🧪 VALIDATION (100%)
-──────────────────────────────────────────────────────────────────────────
-✅ Structure templates : 6/6 dossiers
-✅ Fichiers agents     : 8/8 fichiers (71 KB)
-✅ Fichiers workflows  : 6/6 workflows
-✅ Stubs GitHub        : 23/23 stubs
-✅ Résolution Node.js  : 4/4 chemins
-══════════════════════════════════════════════════════════════════════════
-📚 DOCUMENTATION
-──────────────────────────────────────────────────────────────────────────
-BUGFIX-VISUAL-SUMMARY.md         (2 min)   ← START HERE
-BUGFIX-QUICKSTART.md             (30 sec)  ← Publier maintenant
-BUGFIX-PATH-RESOLUTION.md        (10 min)  ← Doc technique
-BUGFIX-VALIDATION-REPORT.md      (5 min)   ← Tests/validation
-BUGFIX-COMPLETE-REPORT.md        (20 min)  ← Rapport exhaustif
-BUGFIX-DOCUMENTATION-INDEX.md    (guide)   ← Navigation
-test-path-resolution.sh          (script)  ← Tests auto
-══════════════════════════════════════════════════════════════════════════
-🚀 PUBLIER v1.1.3
-──────────────────────────────────────────────────────────────────────────
-cd /home/yan/conception/install
-sed -i "s/'1.1.2'/'1.1.3'/" bin/create-byan-agent.js
-npm version 1.1.3 --no-git-tag-version
-git add . && git commit -m "fix: Critical template path resolution"
-npm publish
-git tag v1.1.3 && git push origin main v1.1.3
-══════════════════════════════════════════════════════════════════════════
-🎯 STATUS : ✅ PRÊT POUR PRODUCTION
-Confidence : 100% | Impact : Résout 100% des blocages
-— MARC 🤖