qa360 2.1.7 → 2.2.0

package/docs/AUDIT-GLOBAL-DEC2025.md

@@ -0,0 +1,271 @@
+# 🔍 AUDIT GLOBAL QA360 - Décembre 2025
+
+## 📊 Résumé Exécutif
+
+| Métrique | Valeur | Status |
+|----------|--------|--------|
+| **Version** | 1.0.1 | ✅ |
+| **Packages** | 3 (cli, core, mcp) | ✅ |
+| **Tests** | 665 (99% passing) | ✅ |
+| **Coverage globale** | ~37% | ⚠️ |
+| **CI/CD** | 13 jobs green | ✅ |
+| **Phases complétées** | 7/11 (64%) | ✅ |
+| **npm publish** | Déclaré mais non vérifié | ⚠️ |
+
+---
+
+## 🏗️ Architecture Vérifiée
+
+### Structure Monorepo
+```
+QA360/
+├── cli/                     # CLI principal (v1.0.1)
+│   ├── src/commands/        # 9 commandes
+│   │   ├── ask.ts          ✅ Production
+│   │   ├── doctor.ts       ✅ Production
+│   │   ├── history.ts      ✅ Production (implémenté)
+│   │   ├── pack.ts         ✅ Production
+│   │   ├── report.ts       ✅ Production (implémenté)
+│   │   ├── run.ts          ✅ Production (Phase3Runner)
+│   │   ├── secrets.ts      ✅ Production
+│   │   ├── serve.ts        ✅ Production
+│   │   └── verify.ts       ✅ Production (Ed25519)
+│   └── package.json        # qa360@1.0.1
+│
+├── core/                    # Moteur (v1.0.0)
+│   ├── src/
+│   │   ├── adapters/       # 7 adapters
+│   │   ├── hooks/          # Lifecycle hooks
+│   │   ├── pack/           # Validation & migration
+│   │   ├── proof/          # Ed25519 signatures
+│   │   ├── runner/         # Phase3Runner
+│   │   ├── secrets/        # AES-256-GCM
+│   │   ├── security/       # Redaction PII
+│   │   ├── serve/          # Observability server
+│   │   ├── types/          # TypeScript types
+│   │   └── vault/          # SQLite Evidence Vault
+│   └── package.json        # qa360-core@1.0.0
+│
+├── packages/
+│   └── mcp/                 # MCP Server (v1.0.0)
+│       ├── src/
+│       │   ├── cli/        # CLI MCP
+│       │   ├── server/     # Full MCP server
+│       │   └── tools/      # 23 tools
+│       └── package.json    # qa360-mcp@1.0.0
+│
+├── docs/                    # 38+ fichiers MD
+├── examples/                # Exemples packs
+└── .github/workflows/       # 3 workflows CI
+```
+
+---
+
+## ✅ Points Forts
+
+### 1. Architecture Solide
+- ✅ Monorepo pnpm bien structuré
+- ✅ Séparation claire CLI / Core / MCP
+- ✅ TypeScript 5+ strict mode
+- ✅ ESM natif
+
+### 2. Sécurité Enterprise-Grade
+- ✅ Ed25519 pour signatures (tweetnacl)
+- ✅ SHA-256 pour hashing
+- ✅ AES-256-GCM pour secrets
+- ✅ JSON Schema (AJV 2020-12)
+- ✅ SBOM CycloneDX
+
+### 3. Core Fonctionnel
+- ✅ Phase3Runner complet (~400 lignes)
+- ✅ Evidence Vault SQLite WAL
+- ✅ 7 adapters implémentés
+- ✅ 9 commandes CLI
+
+### 4. CI/CD Robuste
+- ✅ Node 18/20/22
+- ✅ 3 OS (Ubuntu, macOS, Windows)
+- ✅ 13 jobs tous verts
+
+---
+
+## ⚠️ Points Faibles Critiques
+
+### 1. Coverage Adapters: 6.9% ❌
+```
+adapters/           6.9%   ← CRITIQUE
+hooks/              7.9%   ← CRITIQUE
+security/          52.3%   ← Moyen
+serve/             42.4%   ← Moyen
+pack/              46.7%   ← Moyen
+```
+
+**Impact**: Les 7 adapters sont le cœur du produit mais quasi non testés.
+
+### 2. Tests Adapters Superficiels
+Les tests dans `core/src/adapters/__tests__/` sont des **mocks** qui ne testent pas le code réel:
+```typescript
+// Exemple de test actuel (NE TESTE RIEN)
+it('should create adapter instance', () => {
+  const adapter = {};  // ← Objet vide!
+  expect(adapter).toBeDefined();
+});
+```
+
+### 3. npm Publish Non Vérifié
+- Windsurf déclare avoir publié sur npm
+- Impossible de confirmer via recherche web
+- Packages non indexés (normal si récent)
+
+### 4. Incohérences Documentation
+| Document | Dit | Réalité |
+|----------|-----|---------|
+| README.md | 412 tests | 665 tests |
+| README.md | 55% coverage | ~37% coverage |
+| STATUS.md | report 🟡 | report ✅ implémenté |
+| STATUS.md | history 🟡 | history ✅ implémenté |
+
+### 5. Workflow Git Violé
+- Travail effectué sur `main` au lieu de `develop`
+- Historique git montre commits directs sur main
+
+---
+
+## 📋 Plan d'Action Priorité
+
+### 🔴 P0 - Critique (Cette semaine)
+
+#### 1. Vérifier npm publish
+```bash
+npm view qa360
+npm view qa360-core  
+npm view qa360-mcp
+```
+**Si échec**: Refaire le publish proprement depuis `main`
+
+#### 2. Tests Adapters Réels (Coverage 6.9% → 50%+)
+
+**Fichiers à créer/refaire:**
+| Adapter | Fichier Test | Priorité |
+|---------|--------------|----------|
+| playwright-api | `playwright-api.test.ts` | P0 |
+| playwright-ui | `playwright-ui.test.ts` | P0 |
+| k6-perf | `k6-perf.test.ts` | P0 |
+| semgrep-sast | `semgrep-sast.test.ts` | P1 |
+| zap-dast | `zap-dast.test.ts` | P1 |
+| gitleaks-secrets | `gitleaks-secrets.test.ts` | P1 |
+| osv-deps | `osv-deps.test.ts` | P1 |
+
+**Approche**: Tester la logique (parsing, validation, formatting) sans exécuter les outils externes.
+
+### 🟡 P1 - Important (Semaine 2)
+
+#### 3. Test E2E Workflow Complet
+```
+qa360 ask "test API" 
+  → génère pack.yml
+qa360 run pack.yml 
+  → exécute + stocke vault
+qa360 verify <run_id> 
+  → vérifie Ed25519
+qa360 report <run_id> 
+  → génère PDF
+qa360 history 
+  → affiche runs
+```
+
+#### 4. Corriger Documentation
+- [ ] README.md: Badges corrects
+- [ ] STATUS.md: Refléter réalité
+- [ ] docs/quickstart-5min.md: Tester pas à pas
+
+### 🟢 P2 - Amélioration (Semaine 3-4)
+
+#### 5. Coverage Hooks (7.9% → 40%+)
+- Tester `HooksRunner`
+- Tester lifecycle complet
+
+#### 6. Coverage Security (52% → 70%+)
+- Tester patterns de redaction
+- Tester edge cases PII
+
+---
+
+## 📊 Objectifs Mesurables
+
+| Métrique | Actuel | Cible S+1 | Cible S+2 |
+|----------|--------|-----------|-----------|
+| Coverage adapters | 6.9% | 40% | 60% |
+| Coverage hooks | 7.9% | 30% | 50% |
+| Coverage global | ~37% | 50% | 65% |
+| Tests E2E | 0 | 1 workflow | 3 workflows |
+| Doc accuracy | 60% | 90% | 100% |
+
+---
+
+## 🛠️ Actions Immédiates
+
+### Action 1: Vérification npm (5 min)
+Exécute ces commandes et partage le résultat:
+```bash
+npm view qa360 version
+npm view qa360-core version
+npm view qa360-mcp version
+```
+
+### Action 2: Tests Adapters (2-3h)
+Je peux créer des vrais tests pour `playwright-api` qui:
+- Testent `parseTestSpec()` avec différents formats
+- Testent `calculateSummary()` avec différents résultats
+- Testent `generateJUnit()` pour XML valide
+- Testent `validateConfig()` pour edge cases
+- Mockent Playwright pour `runSmokeTests()`
+
+### Action 3: Synchroniser branches
+```bash
+git checkout develop
+git merge main
+git push origin develop
+```
+
+---
+
+## 🎯 Critères de Succès Final
+
+Pour déclarer QA360 **vraiment production-ready**:
+
+- [ ] npm packages vérifiés et installables
+- [ ] Coverage adapters ≥ 50%
+- [ ] Coverage global ≥ 50%
+- [ ] 1 test E2E workflow complet passant
+- [ ] Documentation 100% exacte
+- [ ] CI 100% green
+- [ ] Workflow Git respecté (develop → main)
+
+---
+
+## 📅 Timeline Proposée
+
+| Jour | Tâche | Livrable |
+|------|-------|----------|
+| J1 | Vérif npm + Tests playwright-api | 20% coverage adapters |
+| J2 | Tests playwright-ui, k6-perf | 35% coverage adapters |
+| J3 | Tests semgrep, zap, gitleaks, osv | 50% coverage adapters |
+| J4 | Test E2E workflow | 1 test E2E passant |
+| J5 | Doc cleanup + Coverage hooks | 50% coverage global |
+
+---
+
+## 💡 Recommandation
+
+**Continuer sans Windsurf** pour:
+1. Qualité supérieure (vrais tests, pas des mocks)
+2. Workflow Git respecté
+3. Vérification systématique
+4. Avancement contrôlé
+
+**Tu exécutes les commandes bash**, je **crée le code et les tests**.
+
+---
+
+**Prochaine étape recommandée**: Exécute `npm view qa360` pour confirmer l'état npm, puis on attaque les tests adapters.

package/docs/BETA_TESTING.md

@@ -0,0 +1,257 @@
+# 🚀 QA360 - Programme Beta Test
+
+**Dates :** 15 Janvier - 26 Février 2025 (6 semaines)
+
+---
+
+## 📋 C'est quoi QA360 ?
+
+**QA360** est un outil de test qui génère des **preuves vérifiables** de vos tests.
+
+> En simple : vous lancez des tests → QA360 signe les résultats → vous avez une preuve infalsifiable que les tests ont passé
+
+### Pourquoi participer ?
+
+- ✅ Tester les nouvelles fonctionnalités **avant tout le monde**
+- ✅ Aider à améliorer l'outil pour qu'il soit **simple à utiliser**
+- ✅ Votre nom dans la liste des contributeurs
+- ✅ Bonus pour les participants les plus actifs
+
+---
+
+## 🎯 Objectif du Beta Test
+
+Valider que QA360 est :
+1. **Simple à installer** sur Windows, Mac et Linux
+2. **Simple à utiliser** au quotidien
+3. **Fiable** (les tests passent quand ils doivent passer)
+4. **Documenté** clairement
+
+---
+
+## ⚡ Installation (3 minutes)
+
+### Windows
+
+```powershell
+# Ouvrir PowerShell en administrateur
+npm install -g qa360
+```
+
+### macOS / Linux
+
+```bash
+npm install -g qa360
+```
+
+### Vérifier que ça marche
+
+```bash
+qa360 --version
+# Vous devriez voir : v2.0.0 ou plus
+```
+
+### Si ça ne marche pas ?
+
+```bash
+# Diagnostique automatique
+qa360 doctor --fix
+```
+
+> **Problème ?** Envoyez un screenshot de l'erreur → [Comment signaler un problème](#-problme--comment-signaler)
+
+---
+
+## 🧪 Premier Test (5 minutes)
+
+### Étape 1 : Créer un dossier de test
+
+```bash
+# Créer un dossier
+mkdir qa360-test
+cd qa360-test
+```
+
+### Étape 2 : Copier un exemple
+
+```bash
+qa360 examples copy api-basic
+```
+
+### Étape 3 : Lancer les tests
+
+```bash
+qa360 run api-basic/qa360.yml
+```
+
+### Ce que vous devez voir
+
+```
+✅ Tests exécutés
+✅ Preuve générée
+✅ Fichier : .qa360/runs/xxxxx-proof.json
+```
+
+---
+
+## ✅ Checklist Beta (10 tests min)
+
+Cochez ce qui fonctionne :
+
+| # | Test | Résultat | Notes |
+|---|------|----------|-------|
+| 1 | Installation | ⬜ OK / ⬜ KO | |
+| 2 | `qa360 --version` affiche la version | ⬜ OK / ⬜ KO | |
+| 3 | `qa360 doctor` ne trouve pas d'erreur | ⬜ OK / ⬜ KO | |
+| 4 | `qa360 examples copy api-basic` marche | ⬜ OK / ⬜ KO | |
+| 5 | `qa360 run api-basic/qa360.yml` passe | ⬜ OK / ⬜ KO | |
+| 6 | `qa360 verify .qa360/runs/<dernier>-proof.json` marche | ⬜ OK / ⬜ KO | |
+| 7 | `qa360 history list` affiche l'historique | ⬜ OK / ⬜ KO | |
+| 8 | `qa360 init --beginner` crée un pack | ⬜ OK / ⬜ KO | |
+| 9 | Les messages d'erreur sont clairs | ⬜ OK / ⬜ KO | |
+| 10 | La documentation est compréhensible | ⬜ OK / ⬜ KO | |
+
+---
+
+## 📁 Tests par Plateforme
+
+### Windows (PowerShell)
+
+```powershell
+# Installer
+npm install -g qa360
+
+# Tester
+qa360 doctor
+qa360 examples copy api-basic
+qa360 run api-basic/qa360.yml
+```
+
+### macOS (Terminal)
+
+```bash
+# Installer
+npm install -g qa360
+
+# Tester
+qa360 doctor
+qa360 examples copy api-basic
+qa360 run api-basic/qa360.yml
+```
+
+### Linux (Bash)
+
+```bash
+# Installer
+npm install -g qa360
+
+# Tester
+qa360 doctor
+qa360 examples copy api-basic
+qa360 run api-basic/qa360.yml
+```
+
+---
+
+## 🔧 Commandes Essentielles
+
+| Commande | À quoi ça sert |
+|----------|----------------|
+| `qa360 --help` | Voir toutes les commandes |
+| `qa360 doctor` | Vérifier que tout va bien |
+| `qa360 run <fichier.yml>` | Lancer des tests |
+| `qa360 verify <preuve.json>` | Vérifier une preuve |
+| `qa360 history list` | Voir les tests passés |
+| `qa360 examples list` | Voir les exemples |
+| `qa360 init --beginner` | Créer son premier test |
+
+---
+
+## 🐛 Problème ? Comment signaler
+
+### 1. Diagnostiquer d'abord
+
+```bash
+qa360 doctor --fix > diagnostic.txt
+```
+
+### 2. Copier les infos importantes
+
+```
+- Votre OS : Windows / macOS / Linux
+- Version Node : node --version
+- Version QA360 : qa360 --version
+- Message d'erreur : [copier-coller]
+```
+
+### 3. Envoyer le rapport
+
+- **GitHub** : https://github.com/xyqotech/qa360/issues
+- **Discord** : https://discord.gg/qa360
+- **Email** : beta@qa360.ai
+
+### Template de rapport
+
+```markdown
+## OS
+Windows 11 / macOS 14 / Ubuntu 22.04
+
+## Commande qui échoue
+qa360 run api-basic/qa360.yml
+
+## Message d'erreur
+[copier-coller l'erreur]
+
+## Diagnostic
+[copier le contenu de diagnostic.txt]
+```
+
+---
+
+## 🏆 Récompenses
+
+### Pour tous les participants
+
+- ✅ Votre nom dans la liste des Beta Testers
+- ✅ Badge Beta Tester sur Discord
+- ✅ Accès prioritaire au support
+
+### Pour les 10 meilleurs
+
+- ✅ Licence Pro gratuite pour v3.0
+- ✅ Feature sur le site qa360.ai
+- ✅ Pack de goodies QA360
+- ✅ Invitation à l'événement de lancement
+
+---
+
+## 📅 Calendrier
+
+| Semaine | Dates | Focus |
+|---------|-------|-------|
+| 1-2 | 15-28 Jan | Installation et premiers tests |
+| 3-4 | 29 Jan - 9 Fév | Tests approfondis |
+| 5-6 | 10-26 Fév | Finalisation et feedback |
+
+---
+
+## 📚 Ressources
+
+- [Guide de démarrage rapide](../QUICK_START.md)
+- [Guide utilisateur](./USER_GUIDE.md)
+- [Documentation complète](./ARCHITECTURE.md)
+- [Exemples de tests](../examples/)
+
+---
+
+## 💬 Besoin d'aide ?
+
+- **Discord** : https://discord.gg/qa360 (le plus rapide)
+- **Email** : beta@qa360.ai
+- **GitHub Issues** : https://github.com/xyqotech/qa360/issues
+
+---
+
+**Merci de participer au beta test !** 🚀
+
+Votre feedback fait de QA360 un meilleur outil pour tous.