qa360 2.2.1 → 2.2.13

package/docs/AUDIT-GLOBAL-DEC2025.md

@@ -1,271 +0,0 @@
-# 🔍 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

@@ -1,257 +0,0 @@
-# 🚀 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.