create-byan-agent 2.0.1 → 2.1.0

package/README.MD

@@ -0,0 +1,225 @@
+# Guide Rapide - Utilisation depuis ~/conception
+
+**Version BYAN:** 1.0.2  
+**Date:** 2026-02-02  
+**Agents principaux:** BYAN, RACHID, MARC
+
+## ✅ Agents Disponibles
+
+### Dans GitHub Copilot CLI
+
+```bash
+cd ~/conception
+copilot
+/agent
+```
+
+Tu verras maintenant **23 agents** dont :
+- **byan** - Créateur d'agents (interview intelligente)
+- **rachid** - Spécialiste NPM/NPX (déploiement)
+- **marc** - Spécialiste Copilot CLI (intégration)
+- **bmad-master** - Orchestrateur BMAD
+- **bmb-agent-builder** - Constructeur d'agents
+- **bmm-*** - Équipe Merise Maker (PM, Dev, Analyst, etc.)
+- **cis-*** - Creative Innovation Suite (brainstorming, design thinking, etc.)
+- **tea** - Équipe d'analyse
+
+## 🚀 Workflows Principaux
+
+### 1. Créer un nouvel agent avec BYAN
+
+```bash
+cd ~/conception
+copilot
+/agent
+# Sélectionner: byan
+
+# Dans BYAN:
+[INT]  # Interview intelligente (30-45 min)
+# ou
+[QC]   # Quick Create (10 min)
+```
+
+### 2. Déployer BYAN sur npm avec RACHID
+
+```bash
+cd ~/conception
+copilot
+/agent
+# Sélectionner: rachid
+
+# Dans RACHID:
+[VALIDATE]     # Valider la structure _bmad
+[FIX-DEPS]     # Corriger les dépendances
+[PUBLISH]      # Publier sur npm
+[TEST-NPX]     # Tester npx create-byan-agent
+```
+
+### 3. Intégrer agents avec MARC
+
+```bash
+cd ~/conception
+copilot
+/agent
+# Sélectionner: marc
+
+# Dans MARC:
+[VALIDATE]       # Valider .github/agents/
+[TEST]           # Tester détection /agent
+[CREATE-STUB]    # Créer stub pour nouvel agent
+[FIX-YAML]       # Corriger YAML frontmatter
+```
+
+## 📁 Structure dans ~/conception
+
+```
+~/conception/
+├── _bmad/
+│   └── bmb/
+│       ├── agents/
+│       │   ├── byan.md          ✅ Créateur d'agents
+│       │   ├── rachid.md        ✅ Spécialiste NPM
+│       │   ├── marc.md          ✅ Spécialiste Copilot CLI
+│       │   ├── agent-builder.md
+│       │   ├── module-builder.md
+│       │   └── workflow-builder.md
+│       ├── workflows/
+│       │   └── byan/
+│       │       ├── interview-workflow.md
+│       │       ├── quick-create-workflow.md
+│       │       ├── edit-agent-workflow.md
+│       │       ├── delete-agent-workflow.md
+│       │       ├── validate-agent-workflow.md
+│       │       ├── templates/
+│       │       └── data/
+│       └── config.yaml
+├── .github/
+│   └── agents/
+│       ├── bmad-agent-byan.md      ✅ Stub BYAN
+│       ├── bmad-agent-rachid.md    ✅ Stub RACHID
+│       ├── bmad-agent-marc.md      ✅ Stub MARC
+│       └── [20 autres agents...]
+└── install/
+    ├── bin/
+    │   ├── create-byan-agent-fixed.js  ✅ v1.0.2 corrigé
+    │   └── create-byan-agent.js        (ancien)
+    ├── package.json
+    └── README.md
+```
+
+## 🎯 Cas d'Usage Courants
+
+### Cas 1: Créer un agent backend avec BYAN
+```bash
+copilot
+/agent → byan
+[INT]
+# Réponds aux questions:
+# - Nom: backend-dev
+# - Domain: API REST Node.js
+# - Capacités: CRUD, validation, tests
+# - Mantras: TDD, Clean Code, YAGNI
+```
+
+### Cas 2: Publier create-byan-agent sur npm
+```bash
+copilot
+/agent → rachid
+[VALIDATE]  # Vérifie structure
+[AUDIT]     # Sécurité
+[PUBLISH]   # npm publish
+```
+
+### Cas 3: Ajouter un nouvel agent à Copilot CLI
+```bash
+# 1. Crée l'agent complet dans _bmad/bmb/agents/
+# 2. Utilise MARC pour créer le stub:
+
+copilot
+/agent → marc
+[CREATE-STUB]
+# Nom: mon-agent
+# Module: bmb
+# Description: Mon agent spécialisé
+```
+
+### Cas 4: Diagnostiquer problème /agent
+```bash
+copilot
+/agent → marc
+[VALIDATE]     # Vérifie .github/agents/
+[TEST]         # Teste détection
+[FIX-YAML]     # Répare YAML si besoin
+```
+
+## 🔧 Commandes Utiles
+
+### Activer un agent spécifique
+```bash
+copilot --agent=byan --prompt "créer un agent backend"
+copilot --agent=rachid --prompt "valider package.json"
+copilot --agent=marc --prompt "tester détection agents"
+```
+
+### Lister tous les agents
+```bash
+cd ~/conception
+ls -1 .github/agents/
+```
+
+### Vérifier config BMAD
+```bash
+cat ~/conception/_bmad/bmb/config.yaml
+```
+
+### Tester installation NPX
+```bash
+cd /tmp/test-install
+npx ~/conception/install/bin/create-byan-agent-fixed.js
+```
+
+## 📖 Documentation Complète
+
+- **INSTALLATION-COMPLETE.md** : Guide d'installation complet
+- **README.md** (install/) : Documentation package npm
+- **Workflows** : `_bmad/bmb/workflows/byan/`
+- **Templates** : `_bmad/bmb/workflows/byan/templates/`
+
+## 🆘 Aide
+
+### Si un agent ne se charge pas:
+```bash
+copilot
+/agent → marc
+[VALIDATE]
+[FIX-YAML]
+```
+
+### Si problème npm:
+```bash
+copilot
+/agent → rachid
+[FIX-DEPS]
+[AUDIT]
+```
+
+### Si besoin d'aide BYAN:
+```bash
+copilot
+/agent → byan
+/bmad-help je veux créer un agent pour...
+```
+
+## ⚡ Tips
+
+1. **Plan Mode** : `Shift+Tab` pour planifier avant d'agir
+2. **Référence fichier** : `@chemin/fichier.md` pour inclure contexte
+3. **Délégation** : `& task` pour déléguer à Copilot coding agent
+4. **Context** : `/context` pour voir usage tokens
+5. **Usage** : `/usage` pour statistiques session
+
+---
+
+**Prêt à utiliser depuis ~/conception !** 🚀
+
+Les 3 nouveaux agents (BYAN, RACHID, MARC) sont intégrés avec les 20 agents existants.

package/__tests__/byan-v2/context/copilot-context.test.js

@@ -0,0 +1,327 @@
+const getCopilotContext = require('../../../src/byan-v2/context/copilot-context');
+const SessionState = require('../../../src/byan-v2/context/session-state');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+jest.mock('fs');
+jest.mock('os');
+
+describe('Copilot Context Integration', () => {
+  let originalEnv;
+
+  beforeEach(() => {
+    originalEnv = { ...process.env };
+    jest.clearAllMocks();
+  });
+
+  afterEach(() => {
+    process.env = originalEnv;
+  });
+
+  describe('AC1: getCopilotContext() function', () => {
+    test('should exist and be callable', () => {
+      expect(typeof getCopilotContext).toBe('function');
+    });
+
+    test('should return object with required properties', () => {
+      process.env.PWD = '/home/test/project';
+      process.env.USER = 'testuser';
+      process.env.GIT_BRANCH = 'main';
+      
+      const context = getCopilotContext();
+      
+      expect(context).toHaveProperty('projectRoot');
+      expect(context).toHaveProperty('userName');
+      expect(context).toHaveProperty('workingDir');
+      expect(context).toHaveProperty('gitBranch');
+    });
+
+    test('should return object type', () => {
+      const context = getCopilotContext();
+      expect(typeof context).toBe('object');
+      expect(context).not.toBeNull();
+    });
+  });
+
+  describe('AC2: Access project-root variable', () => {
+    test('should read projectRoot from PWD environment variable', () => {
+      process.env.PWD = '/home/yan/conception';
+      
+      const context = getCopilotContext();
+      
+      expect(context.projectRoot).toBe('/home/yan/conception');
+    });
+
+    test('should return absolute path', () => {
+      process.env.PWD = '/absolute/path/to/project';
+      
+      const context = getCopilotContext();
+      
+      expect(context.projectRoot).toMatch(/^\//);
+    });
+
+    test('should fallback to process.cwd() if PWD not set', () => {
+      delete process.env.PWD;
+      const expectedCwd = process.cwd();
+      
+      const context = getCopilotContext();
+      
+      expect(context.projectRoot).toBe(expectedCwd);
+    });
+
+    test('should handle GITHUB_WORKSPACE if available', () => {
+      process.env.GITHUB_WORKSPACE = '/github/workspace/repo';
+      
+      const context = getCopilotContext();
+      
+      expect(context.projectRoot).toBe('/github/workspace/repo');
+    });
+
+    test('should prioritize GITHUB_WORKSPACE over PWD', () => {
+      process.env.PWD = '/home/user/project';
+      process.env.GITHUB_WORKSPACE = '/github/workspace/repo';
+      
+      const context = getCopilotContext();
+      
+      expect(context.projectRoot).toBe('/github/workspace/repo');
+    });
+  });
+
+  describe('AC3: Access user_name from config', () => {
+    test('should read userName from USER environment variable', () => {
+      process.env.USER = 'yan';
+      
+      const context = getCopilotContext();
+      
+      expect(context.userName).toBe('yan');
+    });
+
+    test('should read from COPILOT_USER_NAME if available', () => {
+      process.env.COPILOT_USER_NAME = 'copilot-user';
+      
+      const context = getCopilotContext();
+      
+      expect(context.userName).toBe('copilot-user');
+    });
+
+    test('should prioritize COPILOT_USER_NAME over USER', () => {
+      process.env.USER = 'systemuser';
+      process.env.COPILOT_USER_NAME = 'copilot-user';
+      
+      const context = getCopilotContext();
+      
+      expect(context.userName).toBe('copilot-user');
+    });
+
+    test('should fallback to os.userInfo().username if no env vars', () => {
+      delete process.env.USER;
+      delete process.env.COPILOT_USER_NAME;
+      os.userInfo.mockReturnValue({ username: 'os-username' });
+      
+      const context = getCopilotContext();
+      
+      expect(context.userName).toBe('os-username');
+    });
+
+    test('should read from .github/copilot/config.yaml if exists', () => {
+      process.env.PWD = '/home/yan/conception';
+      const configPath = '/home/yan/conception/.github/copilot/config.yaml';
+      const yamlContent = 'user_name: yan-from-config\nproject_name: test';
+      
+      fs.existsSync.mockImplementation((p) => p === configPath);
+      fs.readFileSync.mockReturnValue(yamlContent);
+      
+      const context = getCopilotContext();
+      
+      expect(context.userName).toBe('yan-from-config');
+    });
+
+    test('should handle missing config.yaml gracefully', () => {
+      process.env.PWD = '/home/yan/conception';
+      process.env.USER = 'fallback-user';
+      fs.existsSync.mockReturnValue(false);
+      
+      const context = getCopilotContext();
+      
+      expect(context.userName).toBe('fallback-user');
+    });
+  });
+
+  describe('AC4: Merge with SessionState', () => {
+    test('SessionState should have mergeContext method', () => {
+      const sessionState = new SessionState();
+      expect(typeof sessionState.mergeContext).toBe('function');
+    });
+
+    test('mergeContext should store context in sessionState.context', () => {
+      const sessionState = new SessionState();
+      const copilotContext = {
+        projectRoot: '/home/test',
+        userName: 'testuser',
+        workingDir: '/home/test',
+        gitBranch: 'main'
+      };
+      
+      sessionState.mergeContext(copilotContext);
+      
+      expect(sessionState.context).toEqual(copilotContext);
+    });
+
+    test('should preserve existing SessionState data when merging', () => {
+      const sessionState = new SessionState();
+      sessionState.addQuestion('Test question');
+      sessionState.addResponse('q1', 'Test response');
+      
+      const copilotContext = {
+        projectRoot: '/home/test',
+        userName: 'testuser',
+        workingDir: '/home/test',
+        gitBranch: 'main'
+      };
+      
+      sessionState.mergeContext(copilotContext);
+      
+      expect(sessionState.questionHistory).toHaveLength(1);
+      expect(sessionState.userResponses).toHaveLength(1);
+      expect(sessionState.context).toEqual(copilotContext);
+    });
+
+    test('should allow context to be updated multiple times', () => {
+      const sessionState = new SessionState();
+      
+      sessionState.mergeContext({ projectRoot: '/old/path' });
+      expect(sessionState.context.projectRoot).toBe('/old/path');
+      
+      sessionState.mergeContext({ projectRoot: '/new/path' });
+      expect(sessionState.context.projectRoot).toBe('/new/path');
+    });
+  });
+
+  describe('AC5: Additional context properties', () => {
+    test('should read workingDir from PWD', () => {
+      process.env.PWD = '/home/user/current/dir';
+      
+      const context = getCopilotContext();
+      
+      expect(context.workingDir).toBe('/home/user/current/dir');
+    });
+
+    test('should read gitBranch from GIT_BRANCH env', () => {
+      process.env.GIT_BRANCH = 'feature/test-branch';
+      
+      const context = getCopilotContext();
+      
+      expect(context.gitBranch).toBe('feature/test-branch');
+    });
+
+    test('should read gitBranch from GITHUB_REF_NAME', () => {
+      process.env.GITHUB_REF_NAME = 'main';
+      
+      const context = getCopilotContext();
+      
+      expect(context.gitBranch).toBe('main');
+    });
+
+    test('should prioritize GITHUB_REF_NAME over GIT_BRANCH', () => {
+      process.env.GIT_BRANCH = 'local-branch';
+      process.env.GITHUB_REF_NAME = 'github-branch';
+      
+      const context = getCopilotContext();
+      
+      expect(context.gitBranch).toBe('github-branch');
+    });
+
+    test('should fallback to empty string if no git branch found', () => {
+      delete process.env.GIT_BRANCH;
+      delete process.env.GITHUB_REF_NAME;
+      
+      const context = getCopilotContext();
+      
+      expect(context.gitBranch).toBe('');
+    });
+  });
+
+  describe('AC6: Integration tests', () => {
+    test('should work end-to-end with SessionState', () => {
+      process.env.PWD = '/home/yan/conception';
+      process.env.USER = 'yan';
+      process.env.GIT_BRANCH = 'feature/byan-v2';
+      
+      const context = getCopilotContext();
+      const sessionState = new SessionState();
+      sessionState.mergeContext(context);
+      
+      expect(sessionState.context.projectRoot).toBe('/home/yan/conception');
+      expect(sessionState.context.userName).toBe('yan');
+      expect(sessionState.context.gitBranch).toBe('feature/byan-v2');
+    });
+
+    test('should serialize context in toJSON()', () => {
+      const sessionState = new SessionState();
+      const context = {
+        projectRoot: '/test',
+        userName: 'test',
+        workingDir: '/test',
+        gitBranch: 'main'
+      };
+      
+      sessionState.mergeContext(context);
+      const json = sessionState.toJSON();
+      
+      expect(json.context).toEqual(context);
+    });
+
+    test('should restore context from fromJSON()', () => {
+      const sessionState = new SessionState();
+      sessionState.mergeContext({
+        projectRoot: '/test',
+        userName: 'test',
+        workingDir: '/test',
+        gitBranch: 'main'
+      });
+      
+      const json = sessionState.toJSON();
+      const restored = SessionState.fromJSON(json);
+      
+      expect(restored.context).toEqual(sessionState.context);
+    });
+  });
+
+  describe('Edge Cases', () => {
+    test('should handle undefined environment variables', () => {
+      delete process.env.PWD;
+      delete process.env.USER;
+      delete process.env.GIT_BRANCH;
+      os.userInfo.mockReturnValue({ username: 'default' });
+      
+      const context = getCopilotContext();
+      
+      expect(context.projectRoot).toBeDefined();
+      expect(context.userName).toBe('default');
+      expect(context.gitBranch).toBe('');
+    });
+
+    test('should handle empty string environment variables', () => {
+      process.env.PWD = '';
+      process.env.USER = '';
+      
+      const context = getCopilotContext();
+      
+      expect(context.projectRoot).toBeTruthy();
+      expect(context.userName).toBeTruthy();
+    });
+
+    test('should not crash if os.userInfo() throws', () => {
+      delete process.env.USER;
+      delete process.env.COPILOT_USER_NAME;
+      os.userInfo.mockImplementation(() => {
+        throw new Error('Unable to get user info');
+      });
+      
+      const context = getCopilotContext();
+      
+      expect(context.userName).toBe('unknown');
+    });
+  });
+});