create-byan-agent 2.0.1 → 2.1.1

package/install/PUBLICATION-CHECKLIST.md

@@ -0,0 +1,265 @@
+# Checklist Publication NPM - create-byan-agent v1.0.2
+
+**Date:** 2026-02-02  
+**Version:** 1.0.2  
+**Par:** RACHID + Yan
+
+---
+
+## ✅ Pré-Publication (COMPLÉTÉ)
+
+### Structure Package
+- [x] Dossier `templates/` créé
+- [x] `templates/_bmad/bmb/agents/` - 6 agents copiés
+  - [x] byan.md (12.8 KB)
+  - [x] rachid.md (7.2 KB) ← NOUVEAU
+  - [x] marc.md (10.8 KB) ← NOUVEAU
+  - [x] agent-builder.md
+  - [x] module-builder.md
+  - [x] workflow-builder.md
+- [x] `templates/_bmad/bmb/workflows/byan/` - workflows complets
+  - [x] interview-workflow.md
+  - [x] quick-create-workflow.md
+  - [x] edit-agent-workflow.md
+  - [x] delete-agent-workflow.md
+  - [x] validate-agent-workflow.md
+  - [x] templates/base-agent-template.md
+  - [x] data/mantras.yaml
+  - [x] data/templates.yaml
+- [x] `templates/.github/agents/` - 24 stubs copiés
+  - [x] bmad-agent-byan.md (13.2 KB)
+  - [x] bmad-agent-rachid.md (1.8 KB) ← NOUVEAU
+  - [x] bmad-agent-marc.md (1.9 KB) ← NOUVEAU
+  - [x] 21 autres stubs BMAD
+
+### Code
+- [x] `bin/create-byan-agent.js` mis à jour (11.6 KB)
+- [x] Version 1.0.2 dans le code
+- [x] Fonction `getTemplateDir()` implémentée
+- [x] Logique copie fichiers depuis templates/
+- [x] Vérification 10 checks
+- [x] Messages post-installation améliorés
+- [x] Backup créé: `create-byan-agent-backup.js`
+
+### Configuration
+- [x] `package.json` mis à jour
+  - [x] Version: 1.0.2
+  - [x] Description avec "RACHID and MARC"
+  - [x] Keywords: ajout rachid, marc, npm, deployment
+  - [x] Files: templates/ ajouté
+  - [x] Scripts: test ajouté
+- [x] `CHANGELOG.md` créé
+- [x] `PUBLISH-GUIDE.md` créé
+- [x] `UPDATE-SUMMARY.md` créé
+- [x] `README.md` mis à jour avec RACHID et MARC
+
+---
+
+## 🔍 Tests Locaux (À FAIRE)
+
+### Test 1: Version
+```bash
+cd /home/yan/conception/install
+node bin/create-byan-agent.js --version
+# Attendu: 1.0.2
+```
+- [ ] Version affichée: 1.0.2 ✓
+
+### Test 2: Package Content
+```bash
+cd /home/yan/conception/install
+npm pack --dry-run | grep -E "(templates|bin|README)"
+```
+- [ ] templates/ présent dans tarball
+- [ ] bin/ présent dans tarball
+- [ ] README.md, LICENSE, CHANGELOG.md présents
+
+### Test 3: Tarball Local
+```bash
+cd /home/yan/conception/install
+npm pack
+tar -tzf create-byan-agent-1.0.2.tgz | wc -l
+# Attendu: ~50+ fichiers
+```
+- [ ] Tarball créé: create-byan-agent-1.0.2.tgz
+- [ ] Nombre de fichiers > 40
+
+### Test 4: Installation Locale
+```bash
+mkdir -p /tmp/test-byan-1.0.2
+cd /tmp/test-byan-1.0.2
+npm init -y
+npx /home/yan/conception/install/create-byan-agent-1.0.2.tgz
+```
+- [ ] Installation démarre sans erreur
+- [ ] Choix plateforme affiché
+- [ ] Prompts nom et langue fonctionnent
+- [ ] Structure _bmad/ créée
+- [ ] 3 agents copiés dans _bmad/bmb/agents/
+- [ ] Workflows copiés dans _bmad/bmb/workflows/byan/
+- [ ] Stubs copiés dans .github/agents/
+- [ ] config.yaml créé
+- [ ] Vérification: 10/10 checks ✓
+
+### Test 5: Vérification Post-Installation
+```bash
+cd /tmp/test-byan-1.0.2
+ls -la _bmad/bmb/agents/
+# Attendu: byan.md, rachid.md, marc.md, etc.
+
+ls -la .github/agents/
+# Attendu: bmad-agent-byan.md, bmad-agent-rachid.md, bmad-agent-marc.md
+
+cat _bmad/bmb/config.yaml
+# Attendu: user_name, communication_language, etc.
+```
+- [ ] byan.md présent (> 12 KB)
+- [ ] rachid.md présent (> 7 KB)
+- [ ] marc.md présent (> 10 KB)
+- [ ] 24 stubs dans .github/agents/
+- [ ] config.yaml valide
+
+### Test 6: Audit Sécurité
+```bash
+cd /home/yan/conception/install
+npm audit
+```
+- [ ] Aucune vulnérabilité critique
+- [ ] Aucune vulnérabilité high
+
+---
+
+## 🚀 Publication NPM (À FAIRE APRÈS TESTS)
+
+### Étape 1: Git Commit & Tag
+```bash
+cd /home/yan/conception
+
+# Commit
+git add install/
+git commit -m "chore: release create-byan-agent v1.0.2
+
+- Add RACHID agent for NPM deployment
+- Add MARC agent for Copilot CLI integration
+- Add templates/ directory with all BYAN files
+- Update installer with enhanced verification
+- Update documentation with RACHID and MARC usage"
+
+# Tag
+git tag -a v1.0.2 -m "Release v1.0.2 - RACHID + MARC agents"
+
+# Push (si remote configuré)
+git push origin main
+git push origin v1.0.2
+```
+- [ ] Commit créé
+- [ ] Tag v1.0.2 créé
+- [ ] Poussé sur GitHub (optionnel)
+
+### Étape 2: NPM Login
+```bash
+npm whoami
+# Si non connecté:
+npm login
+```
+- [ ] Connecté en tant que: __________
+
+### Étape 3: Dry Run
+```bash
+cd /home/yan/conception/install
+npm publish --dry-run
+```
+- [ ] Dry run réussi sans erreur
+
+### Étape 4: Publication Réelle
+```bash
+cd /home/yan/conception/install
+npm publish
+```
+- [ ] Publication réussie
+- [ ] URL npm: https://www.npmjs.com/package/create-byan-agent
+
+---
+
+## ✅ Post-Publication (À FAIRE)
+
+### Vérification NPM Registry
+```bash
+# Attendre 1-2 minutes
+npm view create-byan-agent version
+# Attendu: 1.0.2
+
+npm view create-byan-agent
+```
+- [ ] Version 1.0.2 visible sur npm
+- [ ] Description correcte
+- [ ] Keywords corrects
+
+### Test Installation depuis NPM
+```bash
+mkdir -p /tmp/test-npm-final
+cd /tmp/test-npm-final
+npx create-byan-agent@1.0.2
+```
+- [ ] Installation depuis npm fonctionne
+- [ ] Tous les fichiers copiés correctement
+- [ ] Agents: byan, rachid, marc présents
+
+### Test Copilot CLI
+```bash
+cd /tmp/test-npm-final
+copilot
+/agent
+# Vérifier que byan, rachid, marc apparaissent
+```
+- [ ] Agent byan détecté
+- [ ] Agent rachid détecté
+- [ ] Agent marc détecté
+
+### Documentation
+- [ ] README.md sur npmjs.com à jour
+- [ ] CHANGELOG visible
+- [ ] License MIT affichée
+
+---
+
+## 📊 Métriques Finales
+
+| Métrique | Valeur |
+|----------|--------|
+| Version | 1.0.2 |
+| Taille package | ~200 KB |
+| Fichiers totaux | ~45 |
+| Agents | 3 (BYAN, RACHID, MARC) |
+| Workflows | 5 |
+| Stubs | 24 |
+| Checks validation | 10 |
+| Node.js requis | >=18.0.0 |
+| Dépendances | 6 |
+
+---
+
+## 🎯 Statut Global
+
+- [x] **Pré-publication:** COMPLÉTÉ
+- [ ] **Tests locaux:** EN ATTENTE
+- [ ] **Publication NPM:** EN ATTENTE
+- [ ] **Post-publication:** EN ATTENTE
+
+---
+
+## 📝 Notes
+
+- Backup du code original: `create-byan-agent-backup.js`
+- Tarball local pour tests: `create-byan-agent-1.0.2.tgz`
+- Documentation complète dans `PUBLISH-GUIDE.md`
+
+---
+
+**Prêt pour tests:** ✅  
+**Prêt pour publication:** ⏳ (après tests)
+
+---
+
+**Créé par:** RACHID  
+**Date:** 2026-02-02 16:52 UTC

package/install/PUBLISH-GUIDE.md

@@ -0,0 +1,190 @@
+# Guide de Publication NPM - create-byan-agent
+
+## Pré-requis
+
+1. **Compte NPM**
+   ```bash
+   npm whoami  # Vérifier connexion
+   npm login   # Se connecter si nécessaire
+   ```
+
+2. **Validation locale**
+   ```bash
+   cd /home/yan/conception/install
+   npm install
+   npm test    # Teste le script d'installation
+   ```
+
+## Étapes de Publication
+
+### 1. Vérification du package
+
+```bash
+# Vérifier la version
+cat package.json | grep version
+
+# Vérifier le contenu du package
+npm pack --dry-run
+
+# Créer un tarball local pour inspection
+npm pack
+tar -tzf create-byan-agent-1.0.2.tgz | head -50
+```
+
+### 2. Tests locaux
+
+```bash
+# Test dans un dossier temporaire
+mkdir -p /tmp/test-byan-v1.0.2
+cd /tmp/test-byan-v1.0.2
+
+# Test avec le tarball local
+npm init -y
+npx /home/yan/conception/install/create-byan-agent-1.0.2.tgz
+
+# Vérifier l'installation
+ls -la _bmad/bmb/agents/    # Doit contenir byan, rachid, marc
+ls -la .github/agents/       # Doit contenir les stubs
+```
+
+### 3. Audit de sécurité
+
+```bash
+cd /home/yan/conception/install
+npm audit
+npm audit fix  # Si vulnérabilités trouvées
+```
+
+### 4. Publication
+
+```bash
+cd /home/yan/conception/install
+
+# Publication en mode dry-run (simulation)
+npm publish --dry-run
+
+# Publication réelle
+npm publish
+```
+
+### 5. Vérification post-publication
+
+```bash
+# Attendre 1-2 minutes pour propagation
+
+# Test avec npx depuis npm registry
+mkdir -p /tmp/test-byan-npm
+cd /tmp/test-byan-npm
+npx create-byan-agent
+
+# Vérifier dans npm
+npm view create-byan-agent
+npm view create-byan-agent versions
+```
+
+## Commandes Utiles
+
+### Mise à jour de version
+
+```bash
+# Patch (1.0.2 -> 1.0.3)
+npm version patch
+
+# Minor (1.0.2 -> 1.1.0)
+npm version minor
+
+# Major (1.0.2 -> 2.0.0)
+npm version major
+```
+
+### Dépublication (en cas d'urgence)
+
+```bash
+# Dépublier une version spécifique (dans les 72h)
+npm unpublish create-byan-agent@1.0.2
+
+# Déprécier une version
+npm deprecate create-byan-agent@1.0.2 "Version obsolète, utiliser 1.0.3"
+```
+
+## Checklist Pré-Publication
+
+- [ ] Version mise à jour dans package.json
+- [ ] CHANGELOG.md mis à jour
+- [ ] README.md mis à jour
+- [ ] Tous les fichiers dans templates/ sont corrects
+- [ ] npm audit ne montre aucune vulnérabilité critique
+- [ ] Test local avec npm pack réussi
+- [ ] Test avec npx local réussi
+- [ ] Git commit et tag créés
+- [ ] Connecté à npm avec le bon compte
+
+## Git Tagging
+
+```bash
+cd /home/yan/conception
+
+# Commiter les changements
+git add install/
+git commit -m "chore: release create-byan-agent v1.0.2
+
+- Add RACHID agent for NPM deployment
+- Add MARC agent for Copilot CLI integration
+- Add templates/ directory with all BYAN files
+- Update installer with enhanced verification
+- Update documentation"
+
+# Créer un tag
+git tag -a v1.0.2 -m "Release v1.0.2 - RACHID + MARC agents"
+
+# Pousser sur GitHub (si distant configuré)
+git push origin main
+git push origin v1.0.2
+```
+
+## En cas de problème
+
+### Erreur: Version existe déjà
+```bash
+npm version patch  # Incrémente à 1.0.3
+```
+
+### Erreur: Fichiers manquants
+```bash
+# Vérifier package.json "files"
+cat package.json | grep -A 10 "files"
+
+# Recréer le tarball
+npm pack
+```
+
+### Erreur: Authentification
+```bash
+npm logout
+npm login
+npm whoami
+```
+
+## Post-Publication
+
+1. **Mettre à jour la documentation externe**
+   - GitHub README
+   - Site web (si applicable)
+   - Annonce sur réseaux sociaux
+
+2. **Tester dans un nouveau projet**
+   ```bash
+   mkdir -p ~/test-new-byan
+   cd ~/test-new-byan
+   npx create-byan-agent@latest
+   ```
+
+3. **Monitorer les issues**
+   - Vérifier npm registry: https://www.npmjs.com/package/create-byan-agent
+   - Monitorer les téléchargements
+
+---
+
+**Date:** 2026-02-02  
+**Version:** 1.0.2  
+**Agents:** BYAN, RACHID, MARC