@ai-qa/workflow 2.0.8 → 2.0.10

package/install.js

@@ -0,0 +1,319 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const TEMPLATE_DIR =   __dirname;
+const YES = process.argv.includes('--yes') || process.argv.includes('-y');
+const IS_UPDATE = process.argv.includes('--update') || process.argv.includes('-u');
+const IS_SELF = process.argv.includes('--self') || process.argv.includes('-s');
+
+// Files that belong to the user — NEVER overwritten
+const USER_FILES = new Set([
+  '.qa-workflow.json',
+  'opencode.json',
+  'docs/application-context.md',
+]);
+
+// Directories that are pure user data — NEVER touched
+const USER_DIRS = new Set([
+  'user-story',
+  'specs',
+  'tests',
+  'test-results',
+  'agents',
+ 
+  
+  
+  
+]);
+
+// Template files to copy/update
+const QA_ITEMS = [
+  { src: 'ai-qa-workflow.js', dest: 'ai-qa-workflow.js' },
+  { src: 'scripts', dest: 'scripts', dir: true },
+  { src: 'opencode.json', dest: 'opencode.json' },
+  { src: '.qa-workflow.json', dest: '.qa-workflow.json' },
+  { src: 'prompts', dest: 'prompts', dir: true },
+  { src: '.github/agents', dest: '.github/agents', dir: true },
+  { src: '.opencode', dest: '.opencode', dir: true },
+   { src: 'README.md', dest: 'README.md' },
+  { src: 'PROJECT_GUIDE.md', dest: 'PROJECT_GUIDE.md' },
+    { src: '.cursorrules', dest: '.cursorrules' },
+     { src: '.geminirules', dest: '.geminirules' },
+     { src: '.github/copilot-instructions.md', dest: '.github/copilot-instructions.md' },
+      { src: 'router.md', dest: 'agents/router.md' },
+      { src: 'user-story', dest: 'user-story', dir: true },
+      { src: 'specs', dest: 'specs', dir: true },
+      { src: 'tests', dest: 'tests', dir: true },
+
+    ];
+
+// Files to copy even during update (excludes user config files)
+const UPDATE_ITEMS = QA_ITEMS.filter(item => {
+  if (item.dir) return !USER_DIRS.has(item.dest);
+  return !USER_FILES.has(item.dest);
+});
+
+const DIRS_TO_CREATE = ['user-story', 'specs', 'tests', 'test-results'];
+
+const NPM_SCRIPTS = {
+  'qa': 'node ai-qa-workflow.js',
+  'qa:init': 'node ai-qa-workflow.js init',
+  'qa:plan': 'node ai-qa-workflow.js plan',
+  'qa:generate': 'node ai-qa-workflow.js generate',
+  'qa:execute': 'node ai-qa-workflow.js execute',
+  'qa:heal': 'node ai-qa-workflow.js heal',
+  'qa:report': 'node ai-qa-workflow.js report',
+  'qa:report:allure': 'node ai-qa-workflow.js report:allure',
+  'qa:run': 'node ai-qa-workflow.js run',
+  'qa:status': 'node ai-qa-workflow.js status',
+  'qa:list': 'node ai-qa-workflow.js list',
+  'dashboard': 'cd qa-dashboard && npm start',
+  'dashboard:dev': 'cd qa-dashboard && npx nodemon app.js',
+  'dashboard:stop': 'npx kill-port 4000',
+};
+
+const BANNER = `
+  ╔══════════════════════════════════════════╗
+  ║    AI QA Pipeline Installer v2.0         ║
+  ╚══════════════════════════════════════════╝
+`;
+
+function copyRecursive(src, dest, skipDirs) {
+  skipDirs = skipDirs || new Set();
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    const base = path.basename(src);
+    if (skipDirs.has(base)) return;
+    if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
+    fs.readdirSync(src).forEach(item => copyRecursive(path.join(src, item), path.join(dest, item), skipDirs));
+  } else {
+    if (!fs.existsSync(dest) || fs.readFileSync(src).length !== fs.readFileSync(dest).length) {
+      fs.copyFileSync(src, dest);
+      return true;
+    }
+  }
+  return false;
+}
+
+function countFiles(dir) {
+  let count = 0;
+  if (!fs.existsSync(dir)) return 0;
+  fs.readdirSync(dir).forEach(item => {
+    try {
+      const full = path.join(dir, item);
+      if (fs.statSync(full).isDirectory()) count += countFiles(full);
+      else count++;
+    } catch (e) {}
+  });
+  return count;
+}
+
+function addNpmScripts(pkgPath, overwrite) {
+  if (!fs.existsSync(pkgPath)) return;
+  let pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+  if (!pkg.scripts) pkg.scripts = {};
+  let changed = 0;
+  for (const [key, val] of Object.entries(NPM_SCRIPTS)) {
+    if (!pkg.scripts[key] || overwrite) {
+      pkg.scripts[key] = val;
+      changed++;
+    }
+  }
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+  return changed;
+}
+
+function ask(query) {
+  const rl = require('readline').createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => rl.question(query, a => { rl.close(); resolve(a.toLowerCase()); }));
+}
+
+async function install(targetPath, mode) {
+  const isUpdate = mode === 'update';
+
+  console.log(BANNER);
+  console.log(`  Mode: ${isUpdate ? 'UPDATE (preserves config)' : 'FRESH INSTALL'}`);
+  console.log(`  Target: ${targetPath}\n`);
+
+  // 1. Copy template files
+  const items = isUpdate ? UPDATE_ITEMS : QA_ITEMS;
+  console.log(`  ── Step 1: QA Pipeline Files ──`);
+  for (const item of items) {
+    const srcPath = path.join(TEMPLATE_DIR, item.src);
+    const destPath = path.join(targetPath, item.dest);
+    if (!fs.existsSync(srcPath)) { console.log(`  ⚠  ${item.src} not found, skipping`); continue; }
+    if (item.dir) {
+      if (!fs.existsSync(destPath)) fs.mkdirSync(destPath, { recursive: true });
+      const skipDirs = isUpdate ? new Set(['node_modules', 'data']) : new Set();
+      copyRecursive(srcPath, destPath, skipDirs);
+      const count = countFiles(srcPath);
+      console.log(`  ✓ ${item.dest}/ (${count} files)`);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+      console.log(`  ✓ ${item.dest}`);
+    }
+  }
+
+  // 2. Create directories (fresh install only)
+  if (!isUpdate) {
+    console.log(`\n  ── Step 2: Project Directories ──`);
+    for (const dir of DIRS_TO_CREATE) {
+      const dirPath = path.join(targetPath, dir);
+      if (!fs.existsSync(dirPath)) { fs.mkdirSync(dirPath, { recursive: true }); console.log(`  ✓ ${dir}/`); }
+      else console.log(`  • ${dir}/ (exists)`);
+    }
+  }
+
+  // 3. Add/update npm scripts
+  console.log(`\n  ── Step 3: NPM Scripts ──`);
+  const pkgPath = path.join(targetPath, 'package.json');
+  const changed = addNpmScripts(pkgPath, isUpdate);
+  if (changed > 0) console.log(`  ✓ ${isUpdate ? 'Updated' : 'Added'} ${changed} npm scripts (qa:*, dashboard)`);
+  else console.log(`  • Scripts already configured`);
+
+  // 4. Dashboard
+  const dashboardSrc = path.join(TEMPLATE_DIR, 'qa-dashboard');
+  const dashboardDest = path.join(targetPath, 'qa-dashboard');
+  if (fs.existsSync(dashboardSrc)) {
+    console.log(`\n  ── Step 4: QA Dashboard ──`);
+    if (!fs.existsSync(dashboardDest)) {
+      fs.mkdirSync(dashboardDest, { recursive: true });
+      copyRecursive(dashboardSrc, dashboardDest);
+      console.log(`  ✓ Dashboard copied to qa-dashboard/`);
+      console.log(`  → Installing dashboard dependencies...`);
+      try { execSync('npm install', { cwd: dashboardDest, stdio: 'pipe', timeout: 120000 }); console.log(`  ✓ Dashboard deps installed`); } catch (e) { console.log(`  ⚠  cd qa-dashboard && npm install`); }
+    } else {
+      const skipDirs = new Set(['node_modules', 'data']);
+      copyRecursive(dashboardSrc, dashboardDest, skipDirs);
+      console.log(`  ✓ Dashboard updated (preserved data/, node_modules/)`);
+      if (!isUpdate) {
+        console.log(`  → Installing dashboard dependencies...`);
+        try { execSync('npm install', { cwd: dashboardDest, stdio: 'pipe', timeout: 120000 }); console.log(`  ✓ Dashboard deps installed`); } catch (e) { console.log(`  ⚠  cd qa-dashboard && npm install`); }
+      }
+    }
+  }
+
+  // 5. Register project in dashboard (fresh install only)
+  if (!isUpdate && fs.existsSync(dashboardDest)) {
+    console.log(`\n  ── Step 5: Link Dashboard → Project ──`);
+    const dashDataDir = path.join(dashboardDest, 'data');
+    const dashProjectsFile = path.join(dashDataDir, 'projects.json');
+    if (fs.existsSync(dashDataDir)) {
+      let projects = [];
+      if (fs.existsSync(dashProjectsFile)) {
+        try { projects = JSON.parse(fs.readFileSync(dashProjectsFile, 'utf-8')); } catch(e) {}
+      }
+      const projectName = path.basename(targetPath);
+      const projectId = projectName.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+      if (!projects.find(p => p.id === projectId)) {
+        projects.push({ id: projectId, name: projectName, path: targetPath, createdAt: new Date().toISOString(), updatedAt: new Date().toISOString() });
+        fs.writeFileSync(dashProjectsFile, JSON.stringify(projects, null, 2));
+        console.log(`  ✓ Project "${projectName}" registered in dashboard`);
+      }
+    }
+  }
+
+  // 6. Install Playwright (fresh only)
+  if (!isUpdate) {
+    console.log(`\n  ── Step 6: Dependencies ──`);
+    if (!fs.existsSync(path.join(targetPath, 'node_modules', '@playwright'))) {
+      console.log(`  → Installing @playwright/test...`);
+      try { execSync('npm install @playwright/test', { cwd: targetPath, stdio: 'pipe', timeout: 120000 }); console.log(`  ✓ Playwright installed`); } catch (e) { console.log(`  ⚠  npm install failed: npm install @playwright/test`); }
+    } else console.log(`  • Playwright already installed`);
+  }
+
+  // Summary
+  const totalFiles = countFiles(path.join(targetPath, 'scripts'));
+  const dashboardCount = countFiles(path.join(targetPath, 'qa-dashboard'));
+
+  console.log(`\n  ╔══════════════════════════════════════════╗`);
+  console.log(`  ║   ✓ ${isUpdate ? 'UPDATE COMPLETE' : 'INSTALLATION COMPLETE'}${' '.repeat(isUpdate ? 13 : 7)}║`);
+  console.log(`  ╚══════════════════════════════════════════╝\n`);
+
+  if (isUpdate) {
+    console.log(`  Pipeline files updated. Your config and data are preserved.`);
+    console.log(`  Restart the dashboard if it was running.\n`);
+  } else {
+    console.log(`  Files: ~${totalFiles} scripts + ${dashboardCount} dashboard files`);
+    console.log(`  Next:\n`);
+    console.log(`  npm run qa:init      Initialize pipeline (auto-detect config)`);
+    console.log(`  npm run qa:run       Run a user story through full pipeline`);
+    console.log(`  npm run qa:status    Check pipeline state`);
+    console.log(`  npm run dashboard    Start dashboard (port 4000)\n`);
+  }
+}
+
+// ---- CLI entry ----
+const args = process.argv.slice(2);
+const isHelp = !args.length || args.includes('--help') || args.includes('-h');
+
+if (isHelp) {
+  console.log(`
+AI QA Pipeline Installer
+
+  USAGE:
+
+    npx ai-qa-workflow init [--yes]     Install into current directory
+    npx ai-qa-workflow update [--yes]   Update pipeline files (preserves config)
+
+  Or from the template directory:
+
+    node install.js <target> [--yes]        Fresh install into target project
+    node install.js <target> --update       Update existing installation
+    node install.js . --yes                 Install into current directory
+
+  FLAGS:
+    --yes, -y    Skip all prompts
+    --update,-u  Update mode (preserves config, stories, results)
+
+  EXAMPLES:
+    npx ai-qa-workflow init --yes
+    node install.js ../my-project --yes
+    node install.js ../my-project --update
+`);
+  process.exit(0);
+}
+
+async function main() {
+  let targetPath;
+  let mode = 'install';
+
+  // Parse flags and target
+  const nonFlagArgs = args.filter(a => !a.startsWith('-'));
+
+  if (IS_SELF || args.includes('init')) {
+    targetPath = process.cwd();
+    mode = 'install';
+  } else if (args.includes('update')) {
+    targetPath = process.cwd();
+    mode = 'update';
+  } else if (IS_UPDATE) {
+    targetPath = path.resolve(nonFlagArgs[0] || process.cwd());
+    mode = 'update';
+  } else if (nonFlagArgs.length > 0) {
+    targetPath = path.resolve(nonFlagArgs[0]);
+    mode = 'install';
+  } else {
+    targetPath = process.cwd();
+    mode = 'install';
+  }
+
+  if (!fs.existsSync(targetPath) || !fs.statSync(targetPath).isDirectory()) {
+    console.error(`  ✗ Target not found: ${targetPath}`);
+    process.exit(1);
+  }
+
+  // Confirm unless --yes
+  if (!YES) {
+    const modeLabel = mode === 'update' ? 'UPDATE pipeline files' : 'INSTALL pipeline';
+    const answer = await ask(`  ${modeLabel} in "${path.basename(targetPath)}"? (Y/n) `);
+    if (answer.startsWith('n')) { console.log('  Aborted.'); process.exit(0); }
+  }
+
+  await install(targetPath, mode);
+}
+
+main().catch(e => { console.error(e); process.exit(1); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-qa/workflow",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "One-command AI QA Pipeline — User Story to Test Report. Auto-detects project config, generates Playwright tests, self-heals failures, dashboard UI.",
   "keywords": [
     "qa",
@@ -25,12 +25,14 @@
     "templates/",
     "ai-qa-workflow.js",
     "cli.js",
+    "install.js",
     "README.md",
     "PROJECT_GUIDE.md",
     ".cursorrules",
     ".geminirules",
     ".opencode/",
     ".qa-workflow.json",
+    "router.md",
     ".github/"
   ],
   "license": "MIT",

package/{agents/router.md → router.md}

@@ -1,29 +1,29 @@
-# 🧠 AI QA Workflow - Agent Router (Core Engine)
-
-Tu es l'Intelligence Artificielle (Copilot, RooCode, Cursor,opencode, Antigravity, Gemini, etc.) assignée à ce projet d'automatisation QA.
-Ce projet contient plusieurs profils d'agents (dans `.github/agents/` ou `agents/`) et plusieurs instructions (dans `prompts/`).
-
-**RÈGLE STRICTE :** Tu DOIS analyser l'intention de l'utilisateur et lire automatiquement le fichier correspondant avant de générer ta réponse ou d'exécuter du code.
-
-## 🧭 Routage Automatique du Contexte
-
-### 1. Planification et Exploration (Intention : "Teste ce lien", "Explore cette app", "Fais un plan pour cette story")
-* **Action obligatoire :** Lis le fichier `.github/agents/playwright-test-planner.agent.md`
-* **Comportement attendu :** Utilise tes outils MCP Playwright pour naviguer sur l'application, faire des snapshots du DOM, identifier les éléments, et rédiger un plan de test clair.
-
-### 2. Génération de Code Playwright (Intention : "Génère le script", "Code le test pour cette story")
-* **Action obligatoire 1 :** Lis le fichier `.github/agents/playwright-test-generator.agent.md`
-* **Action obligatoire 2 :** Lis le fichier `prompts/QAe2eprompt.md` pour respecter les conventions du framework.
-* **Comportement attendu :** Rédige les fichiers `.spec.ts` dans le dossier `tests/`. Tu as l'interdiction d'halluciner (deviner) des sélecteurs CSS. Utilise tes outils MCP pour trouver les locators sémantiques exacts (`getByRole`, `getByText`) sur la page réelle.
-
-### 3. Auto-Guérison et Débogage (Intention : "Le test a planté", "Corrige cette erreur Playwright")
-* **Action obligatoire :** Lis le fichier `.github/agents/playwright-test-healer.agent.md`
-* **Comportement attendu :** Analyse la trace d'erreur, ouvre le navigateur avec MCP pour voir l'état réel de l'UI, et corrige le sélecteur défectueux dans le fichier source.
-
-### 4. Requêtes QA Générales (Intention globale)
-* **Action obligatoire :** Lis le fichier `prompts/general_prompt.md`
-
-## ⚠️ Directives Techniques
-* Ne demande jamais la permission de lire ces fichiers, fais-le silencieusement en arrière-plan.
-* Utilise toujours des sélecteurs Playwright robustes et sémantiques.
-* Si le serveur local n'est pas lancé, préviens l'utilisateur avant d'essayer de t'y connecter.
+# 🧠 AI QA Workflow - Agent Router (Core Engine)
+
+Tu es l'Intelligence Artificielle (Copilot, RooCode, Cursor,opencode, Antigravity, Gemini, etc.) assignée à ce projet d'automatisation QA.
+Ce projet contient plusieurs profils d'agents (dans `.github/agents/` ou `agents/`) et plusieurs instructions (dans `prompts/`).
+
+**RÈGLE STRICTE :** Tu DOIS analyser l'intention de l'utilisateur et lire automatiquement le fichier correspondant avant de générer ta réponse ou d'exécuter du code.
+
+## 🧭 Routage Automatique du Contexte
+
+### 1. Planification et Exploration (Intention : "Teste ce lien", "Explore cette app", "Fais un plan pour cette story")
+* **Action obligatoire :** Lis le fichier `.github/agents/playwright-test-planner.agent.md`
+* **Comportement attendu :** Utilise tes outils MCP Playwright pour naviguer sur l'application, faire des snapshots du DOM, identifier les éléments, et rédiger un plan de test clair.
+
+### 2. Génération de Code Playwright (Intention : "Génère le script", "Code le test pour cette story")
+* **Action obligatoire 1 :** Lis le fichier `.github/agents/playwright-test-generator.agent.md`
+* **Action obligatoire 2 :** Lis le fichier `prompts/QAe2eprompt.md` pour respecter les conventions du framework.
+* **Comportement attendu :** Rédige les fichiers `.spec.ts` dans le dossier `tests/`. Tu as l'interdiction d'halluciner (deviner) des sélecteurs CSS. Utilise tes outils MCP pour trouver les locators sémantiques exacts (`getByRole`, `getByText`) sur la page réelle.
+
+### 3. Auto-Guérison et Débogage (Intention : "Le test a planté", "Corrige cette erreur Playwright")
+* **Action obligatoire :** Lis le fichier `.github/agents/playwright-test-healer.agent.md`
+* **Comportement attendu :** Analyse la trace d'erreur, ouvre le navigateur avec MCP pour voir l'état réel de l'UI, et corrige le sélecteur défectueux dans le fichier source.
+
+### 4. Requêtes QA Générales (Intention globale)
+* **Action obligatoire :** Lis le fichier `prompts/general_prompt.md`
+
+## ⚠️ Directives Techniques
+* Ne demande jamais la permission de lire ces fichiers, fais-le silencieusement en arrière-plan.
+* Utilise toujours des sélecteurs Playwright robustes et sémantiques.
+* Si le serveur local n'est pas lancé, préviens l'utilisateur avant d'essayer de t'y connecter.

package/tests/us-expense-01.spec.ts

@@ -1,30 +0,0 @@
-import { test, expect } from '@playwright/test';
-import { chromium } from '@playwright/test';
-
-test.describe('Soumission de Demande d\'Alimentation de Compte Professionnel', () => {
-
-  test.beforeEach(async () => {
-    // const browser = await chromium.launch({ headless: !process.env.HEADED });
-    // const page = await browser.newPage();
-    // global.page = page;
-  });
-
-  test.afterEach(async () => {
-    // Cleanup if needed
-  });
-
-  test('Scenario 1', async () => {
-    // TODO: Implement test steps from plan
-    // Reference: specs/us-expense-01-test-plan.md (Scenario 3.1)
-    // 
-    // Step 1: *Montant demandé* (valeur numérique positive)
-    // Step 2: *Motif de la demande* (texte, minimum 15 caractères)
-    // Step 3: *Projet associé* (sélection dans une liste déroulante active)
-    // Step 4: Le montant demandé doit être compris entre 10 EUR et 5 000 EUR.
-    // Step 5: Les messages d'erreur de validation doivent s'afficher en temps réel sous les champs incorrects.
-    // 
-    // Expected: Workflow completes successfully
-    
-  });
-
-});

package/user-story/Demande-alimentation.md

@@ -1,24 +0,0 @@
-# Soumission de Demande d'Alimentation de Compte Professionnel
-
-**Story ID**: US-EXPENSE-01
-**Title**: Demande d'Alimentation de Compte
-**Author**: QA Automation Team
-
-## Description
-En tant que collaborateur d'entreprise, je souhaite soumettre une demande d'alimentation pour mon compte de dépenses professionnel afin de couvrir les frais liés à mes déplacements clients sans avancer de fonds personnels.
-
-## Preconditions
-- L'utilisateur est authentifié sur le portail collaborateur.
-- Le compte de l'utilisateur est actif et rattaché à un centre de coût valide.
-- Le solde actuel du compte de dépenses est inférieur à 500 EUR.
-
-## Acceptance Criteria
-1. **Accès au formulaire** : Un bouton "Nouvelle Demande d'Alimentation" doit être visible depuis le tableau de bord principal.
-2. **Saisie des informations** : Le formulaire doit comporter les champs obligatoires suivants :
-   - *Montant demandé* (valeur numérique positive)
-   - *Motif de la demande* (texte, minimum 15 caractères)
-   - *Projet associé* (sélection dans une liste déroulante active)
-3. **Contrôles de validation de surface** :
-   - Le montant demandé doit être compris entre 10 EUR et 5 000 EUR.
-   - Les messages d'erreur de validation doivent s'afficher en temps réel sous les champs incorrects.
-4. **Soumission et Historique** : Après soumission réussie, un spinner de chargement doit s'afficher temporairement, suivi d'un toast de succès. L'utilisateur doit être redirigé vers l'historique où la demande doit apparaître avec le statut "En attente de validation".