create-byan-agent 2.4.6 → 2.5.0

package/src/byan-v2/fact-check/level-scorer.js

@@ -0,0 +1,45 @@
+/**
+ * LevelScorer - Scores a fact's confidence based on its proof level
+ * 
+ * LEVEL-1 : Official spec / RFC / Primary documentation  → 95
+ * LEVEL-2 : Reproducible benchmark / Executable code     → 80
+ * LEVEL-3 : Peer-reviewed article / Independent source   → 65
+ * LEVEL-4 : Community consensus (> 1000 votes)           → 50
+ * LEVEL-5 : Opinion / Personal experience                → 20
+ */
+
+const LEVEL_SCORES = { 1: 95, 2: 80, 3: 65, 4: 50, 5: 20 };
+
+const STRICT_DOMAIN_MIN_LEVEL = {
+  security:    2,
+  performance: 2,
+  compliance:  1
+};
+
+class LevelScorer {
+  score(level) {
+    if (!Number.isInteger(level) || level < 1 || level > 5) {
+      throw new Error('Level must be an integer between 1 and 5');
+    }
+    return LEVEL_SCORES[level];
+  }
+
+  isBlockedInDomain(level, domain) {
+    const minLevel = STRICT_DOMAIN_MIN_LEVEL[domain];
+    if (!minLevel) return false;
+    return level > minLevel;
+  }
+
+  describeLevel(level) {
+    const descriptions = {
+      1: 'Official spec / RFC / Primary documentation',
+      2: 'Reproducible benchmark / Executable proof',
+      3: 'Peer-reviewed / Independent source',
+      4: 'Community consensus',
+      5: 'Opinion / Personal experience'
+    };
+    return descriptions[level] || 'Unknown level';
+  }
+}
+
+module.exports = LevelScorer;

package/src/byan-v2/orchestrator/glossary-builder.js

@@ -6,11 +6,13 @@
  */
 
 const Logger = require('../observability/logger');
+const FactChecker = require('../fact-check/index');
 
 class GlossaryBuilder {
-  constructor(sessionState, logger = null) {
+  constructor(sessionState, logger = null, factChecker = null) {
     this.sessionState = sessionState;
     this.logger = logger || new Logger('glossary-builder');
+    this.factChecker = factChecker || new FactChecker({ output_fact_sheet: false }, sessionState);
     this.concepts = [];
     this.minConcepts = 5;
     this.minDefinitionLength = 20;
@@ -65,6 +67,11 @@ class GlossaryBuilder {
     this.concepts.push(concept);
     this.logger.info('Concept added', { name: concept.name, clarityScore: concept.clarityScore });
 
+    const factCheck = this.factChecker.parse(definition);
+    if (factCheck.length > 0) {
+      this.logger.info('Fact-check triggered on definition', { name, patterns: factCheck.map(f => f.matched) });
+    }
+
     const suggestions = this.suggestRelatedConcepts(this.concepts);
 
     return {

package/install/MARC-COPILOT-CLI-TEST-GUIDE.md

@@ -1,441 +0,0 @@
-# 🧪 MARC - Quick Test Guide for Copilot CLI Integration
-
-**Package:** create-byan-agent v1.0.4  
-**Test Duration:** 10 minutes  
-**Tester:** Rachid (ou tout utilisateur)
-
----
-
-## 🎯 OBJECTIF
-
-Valider que les agents BYAN, RACHID et MARC sont correctement détectés et activables dans GitHub Copilot CLI.
-
----
-
-## 📋 PRÉREQUIS
-
-- ✅ GitHub Copilot CLI installé
-- ✅ Package `create-byan-agent` installé dans un projet test
-- ✅ Projet Git initialisé (recommandé)
-
-**Installation:**
-```bash
-mkdir /tmp/test-copilot-integration
-cd /tmp/test-copilot-integration
-git init
-npx create-byan-agent
-# Suivre l'installation interactive
-```
-
----
-
-## 🧪 TEST 1: Détection Agents (3 min)
-
-### Commande
-
-```bash
-copilot
-```
-
-**Dans le prompt Copilot, taper:**
-```
-/agent
-```
-
-### Résultat Attendu
-
-Une liste d'agents devrait s'afficher incluant :
-
-```
-Available agents:
-- bmad-agent-byan - byan agent
-- bmad-agent-rachid - NPM/NPX deployment specialist for BYAN installation
-- bmad-agent-marc - GitHub Copilot CLI integration specialist for BMAD agents
-[... autres agents si présents ...]
-```
-
-### ✅ PASS SI:
-- [ ] Les 3 agents (byan, rachid, marc) apparaissent dans la liste
-- [ ] Les noms commencent par `bmad-agent-`
-- [ ] Les descriptions sont affichées
-
-### ❌ FAIL SI:
-- [ ] Aucun agent n'apparaît
-- [ ] Un ou plusieurs agents manquent
-- [ ] Erreur de parsing YAML
-
-**Diagnostic si FAIL:**
-```bash
-# Vérifier présence des fichiers
-ls -la .github/agents/bmad-agent-*.md
-
-# Vérifier YAML frontmatter
-head -n 5 .github/agents/bmad-agent-byan.md
-# Doit commencer par:
-# ---
-# name: 'bmad-agent-byan'
-# description: '...'
-# ---
-```
-
----
-
-## 🧪 TEST 2: Activation BYAN (2 min)
-
-### Commande
-
-**Dans le prompt Copilot, taper:**
-```
-@byan
-```
-
-OU sélectionner dans le menu `/agent` puis choisir `bmad-agent-byan`.
-
-### Résultat Attendu
-
-```
-🏗️ BYAN - Builder of YAN - Agent Creator Specialist
-
-Bonjour [VotreNom] ! Je suis BYAN, votre assistant pour créer des agents IA personnalisés...
-
-MENU PRINCIPAL:
-1. [MH] Redisplay Menu Help
-2. [CH] Chat with BYAN
-3. [INT] Start Intelligent Interview
-4. [QC] Quick Create agent
-5. [LA] List all agents
-6. [EA] Edit existing agent
-7. [VA] Validate agent
-8. [DA] Delete agent
-9. [PC] Show Project Context
-10. [MAN] Display 64 Mantras
-11. [PM] Start Party Mode
-12. [EXIT] Dismiss BYAN Agent
-
-Tapez /bmad-help à tout moment pour obtenir de l'aide.
-
-Que voulez-vous faire ?
-```
-
-### ✅ PASS SI:
-- [ ] Greeting BYAN s'affiche avec nom utilisateur (depuis config.yaml)
-- [ ] Menu complet avec 12 items visible
-- [ ] `/bmad-help` mentionné
-- [ ] Agent attend input
-
-### ❌ FAIL SI:
-- [ ] Erreur "agent not found"
-- [ ] Erreur de chargement du fichier source
-- [ ] Greeting incomplet ou manquant
-- [ ] Menu non affiché
-
-**Diagnostic si FAIL:**
-```bash
-# Vérifier agent source
-cat _byan/bmb/agents/byan.md | head -30
-
-# Vérifier stub
-cat .github/agents/bmad-agent-byan.md | head -20
-
-# Vérifier config
-cat _byan/bmb/config.yaml
-```
-
-**Tester une commande:**
-```
-LA
-```
-
-**Résultat attendu:** Liste des agents dans `_byan/bmb/agents/`
-
----
-
-## 🧪 TEST 3: Activation RACHID (2 min)
-
-### Commande
-
-**Dans Copilot prompt:**
-```
-@rachid
-```
-
-### Résultat Attendu
-
-```
-📦 RACHID - NPM/NPX Deployment Specialist
-
-Salut [VotreNom] ! Je suis RACHID, expert en déploiement npm/npx...
-
-MENU PRINCIPAL:
-1. [INSTALL] Install BYAN via npx
-2. [VALIDATE] Validate _byan structure
-3. [FIX-DEPS] Fix npm dependencies
-4. [UPDATE-PKG] Update package.json
-5. [PUBLISH] Publish to npm
-6. [TEST-NPX] Test npx installation
-7. [AUDIT] Security audit
-8. [HELP] NPM Help
-9. [EXIT] Exit RACHID
-
-Que puis-je faire pour toi ?
-```
-
-### ✅ PASS SI:
-- [ ] Greeting RACHID s'affiche
-- [ ] Menu NPM/NPX visible (9 items)
-- [ ] Agent répond en français (si configuré)
-
-### ❌ FAIL SI:
-- [ ] Agent non trouvé
-- [ ] Menu incomplet
-- [ ] Erreur de chargement
-
----
-
-## 🧪 TEST 4: Activation MARC (2 min)
-
-### Commande
-
-**Dans Copilot prompt:**
-```
-@marc
-```
-
-### Résultat Attendu
-
-```
-🤖 MARC - GitHub Copilot CLI Integration Specialist
-
-Hello [VotreNom]! I'm MARC, your GitHub Copilot CLI integration expert...
-
-MAIN MENU:
-1. [VALIDATE] Validate .github/agents/
-2. [TEST] Test /agent detection
-3. [CREATE-STUB] Create agent stub
-4. [FIX-YAML] Fix YAML frontmatter
-5. [MCP] Configure MCP server
-6. [TEST-INVOKE] Test agent invocation
-7. [OPTIMIZE] Optimize context
-8. [HELP] Copilot CLI Help
-9. [EXIT] Exit Marc
-
-What can I help you with?
-```
-
-### ✅ PASS SI:
-- [ ] Greeting MARC s'affiche
-- [ ] Menu Copilot CLI visible (9 items)
-- [ ] Agent répond correctement
-
-### ❌ FAIL SI:
-- [ ] Agent non détecté
-- [ ] Menu manquant
-- [ ] Erreur activation
-
----
-
-## 🧪 TEST 5: Invocation Directe (1 min)
-
-### Test @byan avec Prompt
-
-**Commande:**
-```bash
-copilot --agent=bmad-agent-byan --prompt "List all agents in this project"
-```
-
-### Résultat Attendu
-
-Agent BYAN s'active et répond avec la liste des agents dans `_byan/bmb/agents/`.
-
-### ✅ PASS SI:
-- [ ] Agent BYAN activé directement
-- [ ] Prompt traité
-- [ ] Réponse pertinente
-
-### ❌ FAIL SI:
-- [ ] Erreur "agent not found"
-- [ ] Nom agent non reconnu
-
-**Note:** Si erreur, essayer avec le nom exact du fichier:
-```bash
-copilot --agent=bmad-agent-byan
-```
-
----
-
-## 📊 RÉSULTATS TESTS
-
-### Score Global
-
-| Test | Status | Notes |
-|------|--------|-------|
-| 1. Détection Agents | ☐ PASS / ☐ FAIL | ___ agents détectés |
-| 2. Activation BYAN | ☐ PASS / ☐ FAIL | Menu complet: Oui/Non |
-| 3. Activation RACHID | ☐ PASS / ☐ FAIL | Menu complet: Oui/Non |
-| 4. Activation MARC | ☐ PASS / ☐ FAIL | Menu complet: Oui/Non |
-| 5. Invocation Directe | ☐ PASS / ☐ FAIL | Prompt traité: Oui/Non |
-
-### Verdict Final
-
-- [ ] ✅ **TOUS LES TESTS PASSÉS** → Prêt pour publication
-- [ ] ⚠️ **1-2 TESTS ÉCHOUÉS** → Corrections mineures nécessaires
-- [ ] ❌ **3+ TESTS ÉCHOUÉS** → Révision majeure requise
-
----
-
-## 🐛 TROUBLESHOOTING
-
-### Problème: Aucun agent détecté
-
-**Causes possibles:**
-1. `.github/agents/` directory manquant
-2. YAML frontmatter invalide
-3. Permissions fichiers incorrectes
-4. Copilot CLI cache obsolète
-
-**Solutions:**
-```bash
-# Vérifier structure
-ls -la .github/agents/
-
-# Vérifier YAML
-cat .github/agents/bmad-agent-byan.md | head -5
-
-# Clear Copilot cache (si nécessaire)
-rm -rf ~/.copilot/cache/
-
-# Relancer Copilot
-copilot
-```
-
----
-
-### Problème: Agent détecté mais ne charge pas
-
-**Causes possibles:**
-1. Fichier source `_byan/bmb/agents/*.md` manquant
-2. Erreur dans `<agent-activation>` block
-3. Chemin `{project-root}` mal résolu
-4. Config.yaml manquant
-
-**Solutions:**
-```bash
-# Vérifier agents sources
-ls -la _byan/bmb/agents/
-
-# Vérifier config
-cat _byan/bmb/config.yaml
-
-# Tester résolution path
-pwd
-# Doit correspondre au {project-root}
-```
-
----
-
-### Problème: Menu incomplet ou manquant
-
-**Causes possibles:**
-1. Agent source corrompu
-2. Section `<menu>` mal formatée
-3. Erreur parsing XML
-
-**Solutions:**
-```bash
-# Réinstaller l'agent
-npx create-byan-agent
-# Répondre "Yes" pour overwrite
-
-# Ou restaurer depuis template
-cp templates/_byan/bmb/agents/byan.md _byan/bmb/agents/
-```
-
----
-
-### Problème: Langue incorrecte
-
-**Cause:** `communication_language` dans config.yaml
-
-**Solution:**
-```bash
-# Éditer config
-nano _byan/bmb/config.yaml
-
-# Changer:
-communication_language: Francais  # ou English
-
-# Sauvegarder et relancer agent
-```
-
----
-
-## 🎯 VALIDATION FINALE
-
-### Checklist de Clôture
-
-- [ ] Tous les tests passés (5/5)
-- [ ] Les 3 agents (BYAN, RACHID, MARC) fonctionnels
-- [ ] Menu complet sur chaque agent
-- [ ] Greeting personnalisé avec nom utilisateur
-- [ ] Commandes de menu répondent correctement
-
-### Si TOUS LES TESTS PASSENT:
-
-**✅ VALIDATION COMPLÈTE**
-
-L'intégration GitHub Copilot CLI est **FONCTIONNELLE** et **PRÊTE POUR PUBLICATION**.
-
-**Prochaines étapes:**
-1. Publier sur npm : `npm publish --access public`
-2. Tester installation publique
-3. Documenter et partager
-
----
-
-### Si DES TESTS ÉCHOUENT:
-
-**⚠️ CORRECTIONS NÉCESSAIRES**
-
-Avant publication npm:
-1. Identifier causes des échecs (voir Troubleshooting)
-2. Corriger les problèmes
-3. Re-tester complètement
-4. Valider avec MARC
-
-**Ne pas publier tant que Score < 4/5**
-
----
-
-## 📝 RAPPORT DE TEST
-
-**Testeur:** _______________  
-**Date:** _______________  
-**Environnement:**
-- OS: _______________
-- Node.js version: _______________
-- Copilot CLI version: _______________
-- Package version: 1.0.4
-
-**Tests Effectués:**
-- [ ] Test 1: Détection Agents
-- [ ] Test 2: Activation BYAN
-- [ ] Test 3: Activation RACHID
-- [ ] Test 4: Activation MARC
-- [ ] Test 5: Invocation Directe
-
-**Score:** ___/5
-
-**Verdict:** ☐ PASS / ☐ FAIL
-
-**Notes supplémentaires:**
-_________________________________
-_________________________________
-_________________________________
-
-**Signature Validation:** _______________
-
----
-
-**Guide créé par:** MARC - GitHub Copilot CLI Integration Specialist  
-**Méthodologie:** Test-Driven Validation  
-**Contact:** Via agents BYAN/RACHID/MARC