qa360 2.1.2 → 2.1.4

package/CONTRIBUTING.md

@@ -0,0 +1,273 @@
+# Contributing to QA360
+
+## 🚀 IMPORTANT - AI INTEGRATION IN PROGRESS
+
+**Status**: Phases 1-3 terminées | Phase 4 en préparation
+
+QA360 est en cours de **transformation AI-native** avec Ollama (100% gratuit, local).
+
+**Progression**: Voir [`docs/OLLAMA_REFACTORING_ROADMAP.md`](./docs/OLLAMA_REFACTORING_ROADMAP.md)
+
+---
+
+## Mission Statement
+
+QA360 transforms software testing into **verifiable, signed, and traceable proofs**.
+
+Our goal: Make quality **executable, measurable, and legally provable** while remaining **simple, portable, and sovereign**.
+
+## 🔄 Architecture Pivot (2025)
+
+### Bilan des Phases Terminées
+
+| Phase | Composant | Tests | Statut |
+|-------|-----------|-------|--------|
+| **Phase 1** | Ollama Provider | 96 | ✅ Terminé |
+| **Phase 2** | Auth Module (9 providers) | 92 | ✅ Terminé |
+| **Phase 3** | Pack Validation | 210 | ✅ Terminé |
+
+**Total Phases 1-3**: 398 tests ajoutés
+
+### Ce qui a changé
+
+| Aspect | Avant | Après |
+|--------|-------|-------|
+| **AI Provider** | Non | OllamaProvider (retry, timeout) |
+| **Test Discovery** | Manuel (pack.yml) | TestDiscoverer (auto-détection) |
+| **Authentification** | Secrets chiffrés simples | 9 providers (JWT, OAuth2, TOTP, Cloud, UI Login) |
+| **Pack Format** | Simple (array-based) | Complet (object-based + auth profiles) |
+| **Validation** | PackValidator basic | PackValidator (36 codes d'erreur) |
+
+### Ce qui est PRÉSERVÉ (Le cœur de QA360)
+
+✅ **Proof System** - Signatures Ed25519, vérification, canonicalisation
+✅ **Evidence Vault** - SQLite + CAS, stockage immuable
+✅ **Pack System** - Configuration déclarative
+✅ **Security Redactor** - Protection des secrets
+✅ **Adapters** - Playwright, k6, Semgrep, ZAP, Gitleaks, OSV
+
+### Prochaines Phases
+
+| Phase | Sujet | Statut |
+|-------|-------|--------|
+| **Phase 4** | AI Test Generation | ⏳ À faire |
+| **Phase 5** | Integration & Polish | ⏳ À faire |
+
+---
+
+## Development Principles
+
+### 📌 Versioning System
+
+**IMPORTANT**: QA360 uses **Node.js-style versioning** (Major.Minor.Patch).
+
+Example: `v1.4.5` (similar to Node.js `v18.20.5`)
+
+- **Major** (X.0.0): Breaking changes, major rewrites
+- **Minor** (1.X.0): New features, backward compatible
+- **Patch** (1.4.X): Bug fixes, minor improvements
+
+Always reference versions with the **`v`** prefix in documentation and commits.
+
+### 🎯 Core Values
+- **Simplicity**: One command, one file, one proof
+- **Auditability**: Every action is traceable and verifiable
+- **Elegance**: Clean code that speaks for itself
+- **Portability**: Works everywhere, depends on nothing external
+- **AI-Native**: Utilise Ollama pour une génération intelligente
+- **Auth-Complete**: Gère tous les scénarios d'authentification
+
+### 🏗️ Architecture Guidelines
+- **Local-first**: Ollama runs locally, no cloud dependency for AI
+- **BYOCI**: Bring Your Own CI/CD integration
+- **Monorepo**: All components in one repository
+- **TypeScript**: Type safety and developer experience
+- **AI-Enhanced**: Generation de code via Ollama (DeepSeek Coder)
+
+---
+
+## Development Workflow
+
+### Branch Strategy (SIMPLIFIED)
+
+```
+main        ← Production releases (STABLE)
+  ↑
+develop     ← Development branch (WORK HERE)
+```
+
+**IMPORTANT - Workflow simplifié**:
+1. Travailler **directement sur `develop`**
+2. Committer et pousser sur `develop`
+3. Vérifier que la **CI est verte** sur `develop`
+4. Merger `develop` vers `main` **uniquement quand tout est vert**
+5. Vérifier que la **CI est aussi verte** sur `main`
+6. **Supprimer toutes les autres branches** (pas de `feature/*`, pas de confusion)
+
+### Workflow complet
+
+```bash
+# 1. S'assurer d'être sur develop
+git checkout develop
+git pull origin develop
+
+# 2. Travailler sur develop
+# ... faire les modifications ...
+
+# 3. Committer
+git add .
+git commit -m "fix(scope): description"
+
+# 4. Pusher
+git push origin develop
+
+# 5. Attendre que la CI soit verte sur develop
+
+# 6. Merger vers main
+git checkout main
+git pull origin main
+git merge develop
+git push origin main
+
+# 7. Vérifier que la CI est verte sur main
+
+# 8. Nettoyer les branches locales (supprimer feature/*)
+git branch | grep -E 'feature/' | xargs git branch -D 2>/dev/null || true
+```
+
+### ⚠️ Règles strictes
+
+**OBLIGATOIRE**:
+- ✅ Travailler sur `develop` uniquement
+- ✅ CI verte sur `develop` avant merge vers `main`
+- ✅ CI verte sur `main` après merge
+- ✅ Supprimer les branches `feature/*` locales et distantes
+
+**INTERDIT**:
+- ❌ Créer des branches `feature/*`
+- ❌ Travailler directement sur `main`
+- ❌ Merge vers `main` si la CI n'est pas verte
+- ❌ Laisser des branches orphelines
+
+### Commit Convention
+
+Nous utilisons [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+feat(ai): add Ollama provider with DeepSeek Coder support
+feat(auth): implement JWT manager with auto-refresh
+feat(cli): add generate command for AI test generation
+fix(core): resolve signature verification edge case
+refactor(adapters): inject auth manager into playwright adapter
+docs(auth): add authentication guide
+test(vault): add evidence storage integration tests
+chore(deps): add ollama dependency
+```
+
+### ⛔ Publication NPM - DÉACTIVÉ
+
+**ATTENTION**: Les publications NPM sont temporairement désactivées pendant la refactorisation.
+
+Le workflow `.github/workflows/release.yml` est désactivé via `if: false`.
+
+**Ne PAS**:
+- ❌ Créer de tag `v*` sur `main`
+- ❌ Publier sur npm
+- ❌ Incrémenter la version dans `package.json`
+
+**Oui, continuez à**:
+- ✅ Travailler sur `develop`
+- ✅ Committer et pousser régulièrement
+- ✅ Faire des commits conventionnels
+
+---
+
+## Phase-by-Phase Development
+
+**Phase actuelle**: **Phase 3 terminée, Phase 4 en préparation**
+
+| Phase | Status | Description | Tests |
+|-------|--------|-------------|-------|
+| **Phase 1** | ✅ Terminé | Ollama Provider, TestDiscoverer, PackConfig | 96 |
+| **Phase 2** | ✅ Terminé | Auth Module (9 providers) | 92 |
+| **Phase 3** | ✅ Terminé | Pack Validation, Migration, Loader | 210 |
+| **Phase 4** | ⏳ À faire | AI Test Generation | - |
+| **Phase 5** | ⏳ À faire | Integration & Polish | - |
+
+**Tests Globaux**: 1859 passing (CLI: 358, Core: 1455, MCP: 46)
+
+---
+
+## Code Standards
+
+### TypeScript Configuration
+- Strict mode enabled
+- No `any` types allowed
+- Comprehensive error handling
+
+### Testing Requirements
+- Unit tests for all core functions
+- Integration tests for CLI commands
+- End-to-end tests for complete workflows
+
+### Documentation Standards
+- Every module has a README.md
+- Usage examples for all public APIs
+- Error messages are pedagogical and guiding
+
+---
+
+## Getting Started
+
+### Prerequisites
+
+**Obligatoire**:
+- Node.js 18+
+- TypeScript 5+
+- pnpm 9+
+
+**Optionnel mais recommandé pour le développement**:
+- Ollama (pour IA locale) - `brew install ollama`
+- DeepSeek Coder model - `ollama pull deepseek-coder`
+
+### Setup
+```bash
+git clone <repository>
+cd QA360
+pnpm install
+pnpm run build
+pnpm test
+```
+
+### Ollama Setup (pour développement IA)
+```bash
+# Installer Ollama
+brew install ollama  # macOS
+# Ou https://ollama.com pour d'autres OS
+
+# Démarrer Ollama
+ollama serve
+
+# Télécharger le modèle de code
+ollama pull deepseek-coder
+
+# Vérifier
+ollama list
+```
+
+---
+
+## Running Tests
+
+```bash
+pnpm test           # Tous les tests
+pnpm test:core      # Tests core uniquement
+pnpm test:cli       # Tests CLI uniquement
+pnpm lint           # Code quality
+pnpm type-check     # TypeScript validation
+pnpm test:all       # Tout (lint + type-check + test)
+```
+
+---
+
+## Code Standards

package/NOVICE_USER_GUIDE.md

@@ -0,0 +1,272 @@
+# 🚀 Guide QA360 MCP - Ultra Simple
+
+Ce guide est pour vous si vous ne connaissez **RIEN** au code.
+
+Suivez les étapes dans l'ordre. Copiez-collez les commandes exactement comme elles sont.
+
+---
+
+## 📋 Étape 1 - Créer votre dossier de travail
+
+**Ce qu'il faut faire** :
+1. Ouvrez le **Finder** (icône du sourire bleu 🟦 en bas à gauche de votre écran)
+2. Cliquez sur **"Fichier"** (en haut)
+3. Cliquez sur **"Nouveau dossier"**
+4. Nommez-le : `mon-test-qa360`
+5. Mettez-le sur votre **Bureau**
+
+---
+
+## 📋 Étape 2 - Ouvrir le Terminal
+
+**Ce qu'il faut faire** :
+1. Appuyez simultanément sur ces 2 touches : `⌘` (Commande) + `Espace`
+2. Tapez : **Terminal**
+3. Appuyez sur `Entrée`
+
+**Ce qui se passe** : Une fenêtre noire avec du texte blanc s'ouvre. C'est normal ! 😊
+
+---
+
+## 📋 Étape 3 - Se déplacer dans votre dossier
+
+**Copiez-collez ceci** dans le Terminal (toute la ligne d'un coup) :
+
+```bash
+cd ~/Desktop/mon-test-qa360
+```
+
+Puis appuyez sur `Entrée`.
+
+**Ce qui se passe** : Le curseur clignote. C'est normal ! Vous êtes maintenant dans votre dossier.
+
+---
+
+## 📋 Étape 4 - Générer votre pack de tests automatiquement
+
+**Copiez-collez ceci** dans le Terminal :
+
+```bash
+qa360 examples copy api-basic
+```
+
+Puis appuyez sur `Entrée`.
+
+**Ce qui se passe** : QA360 crée automatiquement un fichier `qa360.yml` avec des tests déjà prêts !
+
+**Ce que vous voyez** :
+```
+✅ Example copied successfully!
+
+📄 File: qa360.yml
+📋 Gates: api_smoke
+```
+
+---
+
+## 📋 Étape 5 - Voir le fichier créé
+
+**Copiez-collez ceci** dans le Terminal :
+
+```bash
+ls -la
+```
+
+Puis appuyez sur `Entrée`.
+
+**Ce que vous voyez** : Vous devez voir **`qa360.yml`** dans la liste. C'est votre fichier de tests !
+
+---
+
+## 📋 Étape 6 - Lancer vos premiers tests (Option 1 - Sans MCP)
+
+**Copiez-collez ceci** dans le Terminal :
+
+```bash
+qa360 run
+```
+
+Puis appuyez sur `Entrée`.
+
+**Attendez 10-30 secondes...**
+
+**Ce que vous voyez** (si tout marche bien) :
+```
+QA360 Core v1.4.4
+
+📦 Loading pack: qa360.yml
+   ✅ Pack loaded: api-health-check
+   Gates: api_smoke
+
+🎯 Phase 2: Quality Gates
+
+  🎯 Gate: api_smoke
+🌐 Running API smoke tests (4 endpoints)
+  ✅ GET https://httpbin.org/status/200 -> 200
+  ✅ GET https://httpbin.org/json -> 200
+  ✅ GET https://httpbin.org/uuid -> 200
+  ✅ POST https://httpbin.org/post -> 200
+    ✅ api_smoke passed
+
+✅ All quality gates passed!
+
+📊 EXECUTION SUMMARY
+⏱️  Duration: ~1s
+🎯 Trust Score: 100%
+📋 Gates: 1/1 passed
+```
+
+🎉 **FÉLICITATIONS !** Vous avez lancé votre **premier test automatique** !
+
+---
+
+## 📋 Étape 7 - Voir la preuve cryptographique
+
+**Copiez-collez ceci** dans le Terminal :
+
+```bash
+ls -la .qa360/runs/
+```
+
+Puis appuyez sur `Entrée`.
+
+**Ce que vous voyez** : Un fichier `proof.json`. C'est la **preuve cryptographique** de vos tests ! Personne ne peut le falsifier.
+
+---
+
+## 📋 Étape 8 - Ouvrir VS Code (Option 2 - Avec MCP)
+
+**Ce qu'il faut faire** :
+1. Appuyez sur `⌘` + `Espace`
+2. Tapez : **Visual Studio Code**
+3. Appuyez sur `Entrée`
+
+---
+
+## 📋 Étape 9 - Ouvrir votre dossier dans VS Code
+
+**Ce qu'il faut faire** :
+1. Dans VS Code, cliquez sur **"Fichier"** (en haut à gauche)
+2. Cliquez sur **"Ouvrir un dossier..."**
+3. Cliquez sur **"Bureau"** dans la colonne de gauche
+4. Double-cliquez sur **"mon-test-qa360"**
+5. Cliquez sur **"Ouvrir"**
+
+---
+
+## 📋 Étape 10 - Démarrer 
+
+**Ce qu'il faut faire** :
+1. Dans VS Code, regardez la barre **à gauche** de l'écran
+2. Cherchez l'icône **"Claude"** (ou faites `⌘` + `Shift` + `P`)
+3. Tapez **"Claude"**
+4. Cliquez sur **": Start New Session"**
+
+---
+
+## 📋 Étape 11 - Vérifier que QA360 MCP est connecté
+
+Dans la zone de chat , tapez :
+
+```
+/mcp
+```
+
+Puis appuyez sur `Entrée`.
+
+**Ce que vous voyez** (si ça marche) :
+```
+Available MCP servers:
+- qa360 (23 tools available)
+```
+
+---
+
+## 📋 Étape 12 - Lancer un test avec Claude (LE Petit Plus !)
+
+Dans la zone de chat , tapez :
+
+```
+/qa360.run
+```
+
+Puis appuyez sur `Entrée`.
+
+**Ce qui se passe** : Claude lance vos tests **directement depuis le chat** ! Vous voyez le résultat dans la conversation.
+
+**Alternative encore plus simple** : Demandez à Claude en français :
+```
+Lance les tests QA360 pour moi
+```
+
+Claude comprend et lance les tests automatiquement ! 
+
+---
+
+## 🎉 TERMINÉ !
+
+**Bravo !** Vous avez réussi à :
+- ✅ Générer un pack de tests automatiquement
+- ✅ Lancer des tests automatiques sur une API
+- ✅ Obtenir une preuve cryptographique inviolable
+- ✅ Utiliser QA360 avec Claude AI
+
+---
+
+## 🆘 Si ça ne marche pas...
+
+### Problème : "command not found: qa360"
+
+**Solution** : Copiez-collez ceci dans le Terminal :
+
+```bash
+cd ~/QA360 && npm install -g ./packages/mcp
+```
+
+Ensuite réessayez l'Étape 4.
+
+---
+
+### Problème : "/mcp ne fonctionne pas"
+
+**Solution** :
+1. Vérifiez que VS Code est **fermé complètement**
+2. Rouvrez VS Code
+3. Réessayez l'Étape 11
+
+---
+
+## 📝 Autres exemples de tests
+
+Vous voulez tester autre chose ? Voici les commandes :
+
+**Tests UI (navigateur web)** :
+```bash
+qa360 examples copy ui-basic
+```
+
+**Tests complets (API + UI + Sécurité + Performance)** :
+```bash
+qa360 examples copy complete
+```
+
+**Tests de sécurité** :
+```bash
+qa360 examples copy security
+```
+
+---
+
+## 💡 Astuce de Pro
+
+Après avoir lancé des tests, vous pouvez les vérifier n'importe quand :
+
+```bash
+qa360 verify .qa360/runs/proof.json
+```
+
+C'est comme un **notaire** qui certifie que vos tests ont bien été exécutés ! 🔐
+
+---
+
+**Note importante** : Si vous bloquez à une étape, notez laquelle ! Ça nous aide à améliorer QA360. 😊