qa360 2.1.2 → 2.1.4

package/docs/COMPLETE_AUDIT_REFACTORING.md

@@ -0,0 +1,965 @@
+# QA360 - Audit Complet & Plan de Refactorisation
+
+**Date** : 31 Décembre 2024
+**Version** : 2.0 (Architecture Ollama + Auth)
+**Statut** : Proposition de refonte
+
+---
+
+## Résumé Exécutif
+
+QA360 doit évoluer d'un orchestrateur de tests avec templates vers une plateforme AI-native avec génération de code. Ce audit identifie ce qui doit être **gardé**, **refactorisé**, ou **supprimé**.
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    Architecture Future QA360                            │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                          │
+│  ┌────────────────────────────────────────────────────────────────────┐ │
+│  │                      Ollama AI Layer                               │ │
+│  │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐  │ │
+│  │  │ Code        │ │ Test        │ │ Smart       │ │ Chat        │  │ │
+│  │  │ Generator   │ │ Optimizer   │ │ Triage      │ │ Assistant   │  │ │
+│  │  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘  │ │
+│  └────────────────────────────────────────────────────────────────────┘ │
+│                                    ↓                                    │
+│  ┌────────────────────────────────────────────────────────────────────┐ │
+│  │                    Auth Module (NOUVEAU)                           │ │
+│  │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐  │ │
+│  │  │ JWT/OAuth2  │  │ Cloud ADC   │  │   TOTP      │  │ UI Login    │  │ │
+│  │  │ Manager     │  │ Manager     │  │ Manager     │  │ Manager     │  │ │
+│  │  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘  │ │
+│  └────────────────────────────────────────────────────────────────────┘ │
+│                                    ↓                                    │
+│  ┌────────────────────────────────────────────────────────────────────┐ │
+│  │                    Core (Conservé)                                │ │
+│  │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐                  │ │
+│  │  │ Proof       │  │ Evidence    │  │ Pack        │                  │ │
+│  │  │ System      │  │ Vault       │  │ Validator   │                  │ │
+│  │  └─────────────┘ └─────────────┘ └─────────────┘                  │ │
+│  └────────────────────────────────────────────────────────────────────┘ │
+│                                    ↓                                    │
+│  ┌────────────────────────────────────────────────────────────────────┐ │
+│  │                    Adapters (Refactorisés)                         │ │
+│  │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐  │ │
+│  │  │ Playwright  │  │     K6      │  │  Semgrep    │  │    Zap      │  │ │
+│  │  │ (API+UI)    │  │  (Perf)     │  │  (SAST)     │  │  (DAST)     │  │ │
+│  │  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘  │ │
+│  └────────────────────────────────────────────────────────────────────┘ │
+│                                    ↓                                    │
+│  ┌────────────────────────────────────────────────────────────────────┐ │
+│  │                    CLI (Nouvelles commandes)                      │ │
+│  │  run | verify | generate | ollama | chat | analyze                │ │
+│  └────────────────────────────────────────────────────────────────────┘ │
+│                                                                          │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Table des Matières
+
+1. [Audit CLI](#1-audit-cli)
+2. [Audit Core](#2-audit-core)
+3. [Audit MCP Server](#3-audit-mcp-server)
+4. [Nouveaux Modules](#4-nouveaux-modules)
+5. [Plan de Refactorisation](#5-plan-de-refactorisation)
+6. [Nouvelle Structure de Projet](#6-nouvelle-structure)
+
+---
+
+## 1. Audit CLI
+
+### 1.1 Commandes Actuelles
+
+| Commande | Fichier | Action | Priorité |
+|----------|---------|--------|----------|
+| **run** | `commands/run.ts` | ✅ GARDER | Core |
+| **verify** | `commands/verify.ts` | ✅ GARDER | Core |
+| **doctor** | `commands/doctor.ts` | ✅ GARDER | Core |
+| **init** | `commands/init.ts` | ✅ GARDER | Core |
+| **examples** | `commands/examples.ts` | ✅ GARDER | Utility |
+| **history** | `commands/history.ts` | ✅ GARDER | Utility |
+| **report** | `commands/report.ts` | 🔧 REFACTOR | Medium |
+| **ask** | `commands/ask.ts` | 🔄 RÉÉCRIRE | **HIGH** |
+| **serve** | `commands/serve.ts` | ❌ SUPPRIMER | Low |
+| **pack** | `commands/pack.ts` | ✅ GARDER | Utility |
+| **secrets** | `commands/secrets.ts` | 🔧 REFACTOR | High |
+| **proof** | `commands/proof.ts` | ✅ GARDER | Core |
+
+### 1.2 Nouvelles Commandes
+
+| Commande | Description | Priorité |
+|----------|-------------|----------|
+| **generate** | Génère des tests avec Ollama | **CRITICAL** |
+| **ollama** | Gère la connexion Ollama | **HIGH** |
+| **chat** | Assistant conversationnel | Medium |
+| **analyze** | Analyse les résultats avec IA | Medium |
+| **auth** | Gère les configurations d'auth | **HIGH** |
+
+### 1.3 Changements CLI
+
+```typescript
+// cli/src/index.ts - Nouvelle structure
+
+import { Command } from 'commander';
+
+// Core (inchangées)
+program.addCommand(runCommand);
+program.addCommand(verifyCommand);
+program.addCommand(doctorCommand);
+program.addCommand(initCommand);
+
+// IA (nouvelles)
+program.addCommand(generateCommand);     // ← NOUVEAU
+program.addCommand(ollamaCommand);       // ← NOUVEAU
+program.addCommand(chatCommand);         // ← NOUVEAU
+program.addCommand(analyzeCommand);      // ← NOUVEAU
+
+// Auth (nouveau)
+program.addCommand(authCommand);         // ← NOUVEAU
+
+// Utilities (refactorisées)
+program.addCommand(historyCommand);      // Améliorer
+program.addCommand(secretsCommand);      // Intégrer avec Auth
+program.addCommand(packCommand);         // Mettre à jour pour v2
+
+// Supprimés
+// - serveCommand (serveur obsolète)
+```
+
+---
+
+## 2. Audit Core
+
+### 2.1 Modules à Garder (Intacts)
+
+```
+core/src/
+├── proof/              ✅ GARDER - Coeur de la valeur
+│   ├── signer.ts       Signatures Ed25519
+│   ├── verifier.ts     Vérification
+│   ├── canonicalize.ts Canonicalisation JSON
+│   └── bundle.ts       Preuves
+│
+├── vault/              ✅ GARDER - Stockage immuable
+│   ├── index.ts        Opérations Vault
+│   └── cas.ts          Content-addressable storage
+│
+├── security/           ✅ GARDER
+│   └── redactor.ts     Masquage des secrets
+│
+├── pack/              🔧 METTRE À JOUR pour v2
+│   ├── validator.ts    Ajouter support v2
+│   └── migrator.ts     Migration v1 → v2
+│
+└── types/             🔧 METTRE À JOUR
+    └── pack-v1.ts     Ajouter pack-v2.ts
+```
+
+### 2.2 Modules à Refactoriser
+
+```
+core/src/
+├── runner/            🔧 REFACTOR MAJEUR
+│   └── phase3-runner.ts
+│   → Passer à exécution parallèle
+│   → Support test_files pattern
+│   → Intégrer auto-discovery
+│
+├── adapters/          🔧 REFACTOR
+│   ├── playwright-api.ts    → Injecter auth
+│   ├── playwright-ui.ts     → Injecter auth + session
+│   ├── k6-perf.ts          → Optimisation IA
+│   ├── semgrep-sast.ts     → Garder
+│   ├── zap-dast.ts         → Garder
+│   ├── gitleaks-secrets.ts → Garder
+│   └── osv-deps.ts         → Garder
+│
+└── hooks/             🔧 SIMPLIFIER
+    ├── compose.ts      → Rendre plus générique
+    └── runner.ts       → Fusionner avec compose
+```
+
+### 2.3 Modules à Supprimer
+
+```
+core/src/
+├── serve/             ❌ SUPPRIMER - Serveur d'observabilité
+│   ├── server.ts
+│   ├── health-checker.ts
+│   ├── diagnostics-collector.ts
+│   ├── metrics-collector.ts
+│   └── process-manager.ts
+│
+└── security/
+    └── redaction-patterns-extended.ts  ❌ SUPPRIMER - Doublon
+```
+
+---
+
+## 3. Audit MCP Server
+
+### 3.1 Outils à Garder (15 → 35)
+
+```
+packages/mcp/src/tools/
+
+├── History (6)          ✅ GARDER
+│   ├── list.ts
+│   ├── get.ts
+│   ├── diff.ts
+│   ├── trend.ts
+│   ├── pin.ts
+│   └── gc.ts
+│
+├── Pack (3)            ✅ GARDER
+│   ├── ask.ts          → Refactor pour appeler Ollama
+│   ├── validate.ts
+│   └── lint.ts
+│
+├── Execution (1)       ✅ GARDER
+│   └── run.ts
+│
+├── Triage (1)          ✅ GARDER
+│   └── explain_code.ts
+│
+├── Vault (2)           ✅ GARDER
+│   ├── get_run.ts
+│   └── get_artifacts.ts
+│
+└── Server (3)          ✅ GARDER
+    ├── health.ts
+    ├── diag.ts
+    └── metrics.ts
+```
+
+### 3.2 Outils à Supprimer
+
+```
+❌ SUPPRIMER :
+├── history/export.ts  → Peu utilisé
+├── history/migrate.ts → Peu pertinent
+├── pack/migrate.ts    → Rarement nécessaire
+├── report/sign.ts     → CLI-focused
+└── verify.ts          → CLI-focused
+```
+
+### 3.3 Nouveaux Outils
+
+```
+packages/mcp/src/tools/
+
+├── generation/         (NOUVEAU)
+│   ├── from_openapi.ts     Génération depuis OpenAPI
+│   ├── from_crawl.ts       Génération par crawling
+│   ├── from_stories.ts     Génération depuis user stories
+│   └── suggest.ts          Suggestions de tests
+│
+├── analysis/           (NOUVEAU)
+│   ├── testability.ts      Analyse de testabilité
+│   ├── coverage.ts         Analyse de couverture
+│   ├── fragile_selectors.ts Sélecteurs fragiles
+│   └── patterns.ts         Patterns de code
+│
+├── smart_triage/       (NOUVEAU)
+│   ├── analyze.ts          Analyse profonde échec
+│   ├── root_cause.ts       Cause racine IA
+│   └── fix.ts              Génération de correctif
+│
+└── collaboration/      (NOUVEAU)
+    ├── team_report.ts      Rapport équipe
+    ├── compare_runs.ts     Comparaison exécutions
+    └── export_slack.ts     Export Slack
+```
+
+### 3.4 Rôle du MCP Server
+
+**Positionnement : ADD-ON, pas Core**
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                   QA360 MCP Server                          │
+├─────────────────────────────────────────────────────────────┤
+│                                                              │
+│  Usage Primaire :                                            │
+│  └─ Intégration avec autres agents (Cursor, )    │
+│                                                              │
+│  Usage Secondaire :                                           │
+│  └─ Extensions pour utilisateurs avancés                    │
+│                                                              │
+│  N'EST PAS :                                                 │
+│  └─ Le moyen principal d'utiliser QA360 (CLI est)           │
+│                                                              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 4. Nouveaux Modules
+
+### 4.1 AI Module (Ollama)
+
+```typescript
+// core/src/ai/ - NOUVEAU MODULE
+
+core/src/ai/
+├── index.ts              Point d'entrée
+├── providers/
+│   ├── base.ts           Interface LLM Provider
+│   ├── ollama.ts         Provider Ollama (PRINCIPAL)
+│   ├── openai.ts         Provider OpenAI (optionnel)
+│   └── anthropic.ts      Provider Anthropic (optionnel)
+├── generators/
+│   ├── base.ts           Interface Generator
+│   ├── code-generator.ts Génération de code test
+│   ├── pack-generator.ts Génération de pack YAML
+│   └── prompt-templates.ts Templates de prompts
+├── optimizers/
+│   ├── test-optimizer.ts Optimisation de tests
+│   └── param-tuner.ts    Réglage paramètres
+└── analyzers/
+    ├── failure-analyzer.ts Analyse échecs
+    ├── pattern-detector.ts Détection patterns
+    └── triage.ts         Analyse intelligente
+```
+
+**Dépendances :**
+```json
+{
+  "ollama": "^0.5.0",
+  "openai": "^4.0.0"
+}
+```
+
+### 4.2 Auth Module
+
+```typescript
+// core/src/auth/ - NOUVEAU MODULE
+
+core/src/auth/
+├── index.ts              Point d'entrée
+├── managers/
+│   ├── base.ts           Interface Auth Manager
+│   ├── jwt-manager.ts    JWT avec auto-refresh
+│   ├── oauth2-manager.ts OAuth2 flows
+│   ├── api-key-manager.ts Gestion API Keys
+│   └── totp-manager.ts   Génération TOTP
+├── cloud/
+│   ├── gcp-adc.ts        GCP Application Default Credentials
+│   ├── aws-iam.ts        AWS IAM credentials
+│   └── azure-ad.ts       Azure AD token
+├── ui/
+│   ├── login-manager.ts  Login UI自动化
+│   ├── session-store.ts  Stockage sessions/cookies
+│   └── form-handler.ts   Gestion formulaires
+├── storage/
+│   └── credential-store.ts Stockage sécurisé (chiffré)
+└── types/
+    └── auth-config.ts    Types de configuration
+```
+
+**Dépendances :**
+```json
+{
+  "jsonwebtoken": "^9.0.0",
+  "otpauth": "^9.0.0",
+  "google-auth-library": "^9.0.0",
+  "aws-sdk": "^2.0.0",
+  "@azure/identity": "^4.0.0"
+}
+```
+
+### 4.3 Test Discoverer
+
+```typescript
+// core/src/discoverer/ - NOUVEAU MODULE
+
+core/src/discoverer/
+├── index.ts              Point d'entrée
+├── test-discoverer.ts    Découverte fichiers de test
+├── type-detector.ts      Détection type de test
+├── adapter-router.ts     Routage vers bon adapter
+└── parsers/
+    ├── playwright.ts     Parseur fichiers Playwright
+    ├── k6.ts             Parseur fichiers K6
+    └── cypress.ts        Parseur fichiers Cypress
+```
+
+### 4.4 Config Manager
+
+```typescript
+// core/src/config/ - NOUVEAU MODULE
+
+core/src/config/
+├── index.ts              Point d'entrée
+├── config-loader.ts      Chargement config
+├── config-validator.ts  Validation config
+├── environment.ts        Gestion environnements
+└── types/
+    └── config.ts         Types de configuration
+```
+
+---
+
+## 5. Plan de Refactorisation
+
+### Phase 1 : Fondations (Semaines 1-2)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 1                                                  │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ Créer core/src/ai/ avec provider Ollama                │
+│  ✅ Créer core/src/discoverer/ pour auto-découverte        │
+│  ✅ Mise à jour core/src/types/ pour pack-v2               │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 2                                                  │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ Créer core/src/auth/ structure de base                 │
+│  ✅ Implémenter JWT Manager                                 │
+│  ✅ Implémenter API Key Manager                             │
+│  ✅ Migrer core/src/pack/ vers v2                           │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Livraison :**
+- OllamaProvider fonctionnel
+- TestDiscoverer fonctionnel
+- PackV2 types définis
+- JWT/Auth basic
+
+### Phase 2 : Génération de Code (Semaines 3-4)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 3                                                  │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ CodeGenerator pour Playwright                          │
+│  ✅ CodeGenerator pour K6                                  │
+│  ✅ Prompt templates pour génération                       │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 4                                                  │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ Réécrire cli/src/commands/ask.ts avec Ollama          │
+│  ✅ Créer cli/src/commands/generate.ts                     │
+│  ✅ Créer cli/src/commands/ollama.ts                       │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Livraison :**
+- Génération de code fonctionnelle
+- Commande `qa360 generate` fonctionnelle
+- Commande `qa360 ollama` fonctionnelle
+
+### Phase 3 : Auth Complet (Semaines 5-6)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 5                                                  │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ OAuth2 Manager                                         │
+│  ✅ TOTP Manager                                           │
+│  ✅ Cloud ADC (GCP, AWS)                                   │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 6                                                  │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ UI Login Manager                                        │
+│  ✅ Session Store                                          │
+│  ✅ Intégration Auth dans Adapters                         │
+│  ✅ Créer cli/src/commands/auth.ts                         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Livraison :**
+- Module Auth complet
+- Adapters avec injection auth
+- Commande `qa360 auth` fonctionnelle
+
+### Phase 4 : Refactor Core (Semaines 7-8)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 7                                                  │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ Refactor Phase3Runner pour test_files pattern          │
+│  ✅ Exécution parallèle des gates                          │
+│  ✅ Intégration TestDiscoverer                             │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 8                                                  │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ Refactor Adapters avec injection Auth                 │
+│  ✅ Mettre à jour MCP tools                                │
+│  ✅ Supprimer modules obsolètes                            │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Livraison :**
+- Phase3Runner refactorisé
+- Adapters auth-aware
+- MCP tools mis à jour
+
+### Phase 5 : UX Avancée (Semaines 9-10)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 9                                                  │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ Commande qa360 chat                                    │
+│  ✅ Commande qa360 analyze                                 │
+│  ✅ Smart Triage avec IA                                   │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│  Semaine 10                                                 │
+├─────────────────────────────────────────────────────────────┤
+│  ✅ Améliorer sortie CLI                                    │
+│  ✅ Ajouter progress bars                                 │
+│  ✅ Messages d'erreur pédagogiques                         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Livraison :**
+- Chat interface fonctionnelle
+- Analyse IA des échecs
+- Améliorations UX
+
+---
+
+## 6. Nouvelle Structure de Projet
+
+### Structure Complète Après Refactorisation
+
+```
+qa360/
+├── cli/                           # CLI (interface utilisateur)
+│   ├── src/
+│   │   ├── commands/
+│   │   │   ├── run.ts            # Exécuter les tests
+│   │   │   ├── verify.ts         # Vérifier les preuves
+│   │   │   ├── doctor.ts         # Diagnostic
+│   │   │   ├── init.ts           # Initialiser projet
+│   │   │   ├── generate.ts       # ← NOUVEAU : Générer tests
+│   │   │   ├── ollama.ts         # ← NOUVEAU : Gérer Ollama
+│   │   │   ├── chat.ts           # ← NOUVEAU : Chat IA
+│   │   │   ├── analyze.ts        # ← NOUVEAU : Analyser résultats
+│   │   │   ├── auth.ts           # ← NOUVEAU : Gérer auth
+│   │   │   ├── history.ts        # Historique
+│   │   │   ├── secrets.ts        # Secrets (fusion avec auth)
+│   │   │   ├── pack.ts           # Gestion des packs
+│   │   │   └── report.ts         # Rapports
+│   │   ├── index.ts
+│   │   └── utils/
+│   ├── bin/
+│   │   └── qa360.js
+│   └── package.json
+│
+├── core/                          # Moteur core
+│   ├── src/
+│   │   ├── ai/                   # ← NOUVEAU : Module IA
+│   │   │   ├── index.ts
+│   │   │   ├── providers/
+│   │   │   │   ├── base.ts
+│   │   │   │   ├── ollama.ts     # Provider Ollama
+│   │   │   │   ├── openai.ts     # Provider OpenAI (option)
+│   │   │   │   └── anthropic.ts  # Provider Anthropic (option)
+│   │   │   ├── generators/
+│   │   │   │   ├── code-generator.ts      # Génération code
+│   │   │   │   ├── pack-generator.ts      # Génération pack
+│   │   │   │   └── prompt-templates.ts    # Templates prompts
+│   │   │   ├── analyzers/
+│   │   │   │   ├── failure-analyzer.ts
+│   │   │   │   ├── pattern-detector.ts
+│   │   │   │   └── triage.ts
+│   │   │   └── optimizers/
+│   │   │       ├── test-optimizer.ts
+│   │   │       └── param-tuner.ts
+│   │   │
+│   │   ├── auth/                 # ← NOUVEAU : Module Auth
+│   │   │   ├── index.ts
+│   │   │   ├── managers/
+│   │   │   │   ├── base.ts
+│   │   │   │   ├── jwt-manager.ts
+│   │   │   │   ├── oauth2-manager.ts
+│   │   │   │   ├── api-key-manager.ts
+│   │   │   │   └── totp-manager.ts
+│   │   │   ├── cloud/
+│   │   │   │   ├── gcp-adc.ts
+│   │   │   │   ├── aws-iam.ts
+│   │   │   │   └── azure-ad.ts
+│   │   │   ├── ui/
+│   │   │   │   ├── login-manager.ts
+│   │   │   │   ├── session-store.ts
+│   │   │   │   └── form-handler.ts
+│   │   │   └── storage/
+│   │   │       └── credential-store.ts
+│   │   │
+│   │   ├── discoverer/           # ← NOUVEAU : Découverte tests
+│   │   │   ├── index.ts
+│   │   │   ├── test-discoverer.ts
+│   │   │   ├── type-detector.ts
+│   │   │   ├── adapter-router.ts
+│   │   │   └── parsers/
+│   │   │       ├── playwright.ts
+│   │   │       ├── k6.ts
+│   │   │       └── cypress.ts
+│   │   │
+│   │   ├── config/               # ← NOUVEAU : Configuration
+│   │   │   ├── index.ts
+│   │   │   ├── config-loader.ts
+│   │   │   ├── config-validator.ts
+│   │   │   └── environment.ts
+│   │   │
+│   │   ├── proof/                # ✅ GARDER : Preuves
+│   │   │   ├── index.ts
+│   │   │   ├── signer.ts
+│   │   │   ├── verifier.ts
+│   │   │   ├── canonicalize.ts
+│   │   │   └── bundle.ts
+│   │   │
+│   │   ├── vault/                # ✅ GARDER : Vault
+│   │   │   ├── index.ts
+│   │   │   ├── cas.ts
+│   │   │   └── schema.sql
+│   │   │
+│   │   ├── pack/                 # 🔧 METTRE À JOUR
+│   │   │   ├── validator.ts      # Ajouter support v2
+│   │   │   └── migrator.ts       # Migration v1→v2
+│   │   │
+│   │   ├── types/                # 🔧 METTRE À JOUR
+│   │   │   ├── pack-v1.ts        # Garder pour compat
+│   │   │   └── pack-v2.ts        # ← NOUVEAU
+│   │   │
+│   │   ├── adapters/             # 🔧 REFACTOR
+│   │   │   ├── base.ts           # ← NOUVEAU : Interface commune
+│   │   │   ├── playwright-api.ts # + Auth injection
+│   │   │   ├── playwright-ui.ts  # + Auth + Session
+│   │   │   ├── k6-perf.ts        # + Optimisation IA
+│   │   │   ├── semgrep-sast.ts
+│   │   │   ├── zap-dast.ts
+│   │   │   ├── gitleaks-secrets.ts
+│   │   │   └── osv-deps.ts
+│   │   │
+│   │   ├── runner/               # 🔧 REFACTOR MAJEUR
+│   │   │   └── phase3-runner.ts   # + test_files, parallèle
+│   │   │
+│   │   ├── hooks/                # 🔧 SIMPLIFIER
+│   │   │   ├── compose.ts
+│   │   │   └── runner.ts
+│   │   │
+│   │   ├── security/             # ✅ GARDER
+│   │   │   └── redactor.ts
+│   │   │
+│   │   └── index.ts
+│   │
+│   ├── schemas/
+│   │   └── pack.schema.json      # ← Mettre à jour v2
+│   │
+│   └── package.json
+│
+├── packages/
+│   ├── mcp/                      # 🔧 MCP : ADD-ON (pas core)
+│   │   └── src/
+│   │       ├── tools/
+│   │       │   ├── history/       # ✅ Garder
+│   │       │   ├── pack/          # ✅ Garder + refactor ask
+│   │       │   ├── execution/     # ✅ Garder
+│   │       │   ├── generation/    # ← NOUVEAU
+│   │       │   ├── analysis/      # ← NOUVEAU
+│   │       │   ├── smart_triage/  # ← NOUVEAU
+│   │       │   └── collaboration/ # ← NOUVEAU
+│   │       ├── security/
+│   │       └── server/
+│   │
+│   └── (autres packages...)
+│
+├── examples/
+│   ├── packs/                    # Exemples packs v2
+│   │   ├── simple.yml
+│   │   ├── full.yml
+│   │   └── with-auth.yml         # ← NOUVEAU
+│   │
+│   └── generated-tests/          # ← NOUVEAU : Exemples générés
+│       ├── api/
+│       ├── ui/
+│       └── perf/
+│
+├── docs/
+│   ├── ARCHITECTURE.md
+│   ├── AI_INTEGRATION.md         # ← NOUVEAU
+│   ├── AUTH_GUIDE.md             # ← NOUVEAU
+│   └── MIGRATION_V1_V2.md        # ← NOUVEAU
+│
+├── .qa360/                       # Config globale (nouveau)
+│   ├── config.yml                # ← NOUVEAU
+│   ├── auth.yml                  # ← NOUVEAU : Configs auth
+│   └── models.json               # ← NOUVEAU : Modèles IA
+│
+├── package.json
+├── pnpm-workspace.yaml
+├── tsconfig.base.json
+└── tsconfig.build.json
+```
+
+---
+
+## 7. Nouveaux Fichiers de Configuration
+
+### 7.1 Config Globale QA360
+
+```yaml
+# .qa360/config.yml
+
+version: 1
+profile: default
+
+# IA Configuration
+ai:
+  enabled: true
+  provider: ollama              # ollama | openai | anthropic
+  model: deepseek-coder         # Modèle pour génération de code
+  fallback_model: llama3.2      # Modèle de secours
+
+  ollama:
+    base_url: http://localhost:11434
+    timeout: 120000             # 2 minutes
+
+  cost_optimization:
+    use_small_for_summaries: true
+    cache_enabled: true
+
+# Auth Configuration
+auth:
+  default_profile: default
+  profiles:
+    default:
+      type: none
+    api-staging:
+      type: jwt
+      issuer: https://auth-staging.example.com
+      client_id: ${JWT_CLIENT_ID}
+      client_secret: ${JWT_CLIENT_SECRET}
+      auto_refresh: true
+    api-prod:
+      type: oauth2
+      token_url: https://auth.example.com/oauth/token
+      client_id: ${OAUTH_CLIENT_ID}
+      client_secret: ${OAUTH_CLIENT_SECRET}
+    gcp:
+      type: gcp_adc
+      project_id: my-project
+    ui-staging:
+      type: ui_login
+      url: https://staging.example.com/login
+      username: ${LOGIN_USER}
+      password: ${LOGIN_PASSWORD}
+      totp_secret: ${TOTP_SECRET}
+
+# Execution Configuration
+execution:
+  parallel_gates: true
+  max_concurrency: 4
+  default_timeout: 30000
+  default_retries: 2
+
+# Reporting
+reporting:
+  formats: ["json", "html"]
+  output_dir: ".qa360/reports"
+  include_screenshots: true
+  include_logs: true
+
+# Security
+security:
+  scan_paths: ["src", "lib", "tests"]
+  exclude_patterns: ["node_modules", "dist", ".git"]
+  redaction_enabled: true
+```
+
+### 7.2 Pack V2
+
+```yaml
+# pack.yml (version 2)
+
+version: 2
+name: "my-app-tests"
+description: "Complete test suite for my application"
+profile: development
+
+# Auth par défaut pour tous les tests
+auth:
+  api: api-staging              # Référence au profil dans config
+  ui: ui-staging
+
+# Gates avec test_files
+gates:
+  api_smoke:
+    adapter: playwright
+    test_files: ["tests/api/**/*.spec.ts"]
+    budgets:
+      max_duration_ms: 10000
+    parallel: true
+
+  ui_e2e:
+    adapter: playwright
+    test_files: ["tests/e2e/**/*.spec.ts"]
+    budgets:
+      max_duration_ms: 30000
+    auth: ui-staging            # Override par défaut
+
+  perf:
+    adapter: k6
+    test_files: ["tests/perf/**/*.js"]
+    budgets:
+      p95_ms: 2000
+
+  security:
+    adapter: semgrep
+    test_files: ["tests/security/**/*.yaml"]
+    budgets:
+      max_high: 3
+      max_critical: 0
+
+# Hooks (inchangés)
+hooks:
+  beforeAll:
+    - run: "docker compose up -d"
+      timeout: 60000
+  afterAll:
+    - run: "docker compose down"
+      timeout: 30000
+
+# Exécution
+execution:
+  parallel: true
+  max_concurrency: 4
+  on_failure: continue
+```
+
+---
+
+## 8. Dépendances
+
+### 8.1 À Ajouter
+
+```json
+{
+  "dependencies": {
+    "ollama": "^0.5.0",
+    "openai": "^4.0.0",
+    "@anthropic-ai/sdk": "^0.30.0",
+    "jsonwebtoken": "^9.0.0",
+    "otpauth": "^9.0.0",
+    "google-auth-library": "^9.0.0",
+    "@aws-sdk/credential-providers": "^3.0.0",
+    "@azure/identity": "^4.0.0",
+    "zod": "^3.0.0"
+  }
+}
+```
+
+### 8.2 À Supprimer
+
+```json
+{
+  "dependencies": {
+    "sqlite3": "garder pour vault",
+    "adm-zip": "évaluer si toujours nécessaire"
+  }
+}
+```
+
+### 8.3 Versions Minimum
+
+```json
+{
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "packageManager": "pnpm@9.12.2"
+}
+```
+
+---
+
+## 9. Checklist de Migration
+
+```
+Phase 1 - Fondations:
+□ Créer core/src/ai/
+□ Créer core/src/discoverer/
+□ Créer core/src/config/
+□ Créer core/src/auth/ (structure de base)
+□ Mettre à jour types pour pack-v2
+
+Phase 2 - Génération:
+□ Implémenter OllamaProvider
+□ Implémenter CodeGenerator
+□ Réécrire command ask
+□ Créer commande generate
+□ Créer commande ollama
+
+Phase 3 - Auth:
+□ Implémenter JWTManager
+□ Implémenter OAuth2Manager
+□ Implémenter TOTPManager
+□ Implémenter Cloud ADC managers
+□ Implémenter UI LoginManager
+□ Créer commande auth
+□ Intégrer Auth dans Adapters
+
+Phase 4 - Core Refactor:
+□ Refactor Phase3Runner pour test_files
+□ Ajouter exécution parallèle
+□ Intégrer TestDiscoverer
+□ Mettre à jour Adapters avec Auth
+□ Supprimer modules obsolètes
+
+Phase 5 - UX:
+□ Créer commande chat
+□ Créer commande analyze
+□ Smart Triage avec IA
+□ Améliorer messages d'erreur
+□ Ajouter progress bars
+
+Phase 6 - Documentation:
+□ Documenter AI integration
+□ Documenter Auth module
+□ Guide de migration v1 → v2
+□ Exemples packs v2
+│ Exemples avec auth
+```
+
+---
+
+## 10. Risques et Atténuation
+
+| Risque | Impact | Atténuation |
+|--------|--------|-------------|
+| Dépendance Ollama | Performance locale | Documenter requis, fallback sur LLM cloud |
+| Complexité Auth | Courbe d'apprentissage | Templates, documentation, exemples |
+| Breaking changes | Utilisateurs existants | Migration guide, compat v1 |
+| Nouvelles dépendances | Taille du projet | Minimaliser, options |
+
+---
+
+## Conclusion
+
+Ce plan de refactorisation transforme QA360 en :
+
+1. **Plateforme AI-native** avec Ollama (gratuit, local)
+2. **Génération de code** de test (pas juste templates)
+3. **Auth complète** (JWT, OAuth2, TOTP, Cloud, UI)
+4. **Expérience unifiée** (CLI principal, MCP en add-on)
+
+**Le cœur de valeur (preuves, vault) est préservé.**
+
+**La durée estimée est de 10 semaines pour une mise en œuvre complète.**