qa360 2.1.7 → 2.2.0

package/.BETA_TESTING_FEEDBACK.md

@@ -0,0 +1,256 @@
+# QA360 - Beta Testing Feedback
+
+**Document de suivi des retours beta testing - NE PAS COMMIT SUR GIT**
+
+Ce document recense tous les bugs, problèmes d'UX et améliorations suggérées pendant la période de test beta.
+
+---
+
+## Format des entrées
+
+**Date:** YYYY-MM-DD
+**Version:** vX.X.X
+**Testeur:** [Nom]
+**Priorité:** 🔴 Critique / 🟠 Important / 🟢 Amélioration
+**Statut:** ⬜ Nouveau / 🔄 En cours / ✅ Corrigé / ⏸️ Reporté
+
+---
+
+## Retours
+
+### 2025-01-03
+
+#### 1. Message par défaut peu friendly (Commande sans argument)
+
+**Commande:** `qa360` (sans argument)
+
+**Problème:**
+```
+command required.
+(Run 'qa360 --help' to see all commands)
+```
+
+**Attendu:** Message de bienvenue plus explicite avec des commandes suggérées.
+
+**Priorité:** 🟠 Important
+**Statut:** ⬜ Nouveau
+
+**Suggestion:**
+```
+Welcome to QA360!
+
+Get started:
+  qa360 examples list      # See example test packs
+  qa360 run <pack>         # Run tests
+  qa360 --help              # See all commands
+```
+
+---
+
+#### 2. Historique vide affiche un tableau vide
+
+**Commande:** `qa360 history list`
+
+**Problème:**
+- Quand aucun run n'existe dans le vault, affiche un tableau vide "No runs found in vault"
+- Pas clair pour l'utilisateur qu'il doit d'abord lancer `qa360 run`
+
+**Attendu:** Message plus explicite avec suggestion.
+
+**Priorité:** 🟢 Amélioration
+**Statut:** ⬜ Nouveau
+
+**Suggestion:**
+```
+No test runs found in vault.
+
+To get started:
+  1. Run 'qa360 examples copy api-basic' to get an example pack
+  2. Run 'qa360 run api-basic/qa360.yml' to execute tests
+  3. Run 'qa360 history list' again to see results
+```
+
+---
+
+#### 3. Nom du pack incorrect dans history list
+
+**Commande:** `qa360 history list`
+
+**Problème:**
+- Le nom du pack affiché est toujours "test-pack" au lieu du vrai nom du pack (ex: "test-ui-vitest")
+- Le pack_path est hardcoded dans le code à 'test-pack.yaml'
+
+**Attendu:** Afficher le vrai nom du pack tel que défini dans le fichier YAML (champ `name`)
+
+**Priorité:** 🟠 Important
+**Statut:** ✅ Corrigé (v2.0.5)
+
+**Cause:** `phase3-runner.ts` ligne 940: `pack_path: 'test-pack.yaml'` est hardcoded
+
+---
+
+#### 4. Durée incorrecte dans history list
+
+**Commande:** `qa360 history list`
+
+**Problème:**
+- La durée affichée est "0s" au lieu de la durée réelle (ex: "5s" pour un run de 5135ms)
+- Problème d'arrondi : `Math.round(duration / 1000)` avec duration en ms donne des valeurs incorrectes
+
+**Attendu:** Afficher la durée correcte en secondes (ex: "5s" pour 5135ms)
+
+**Priorité:** 🟢 Amélioration (mineur)
+**Statut:** ⬜ Nouveau (à faire plus tard)
+
+---
+
+#### 5. Message de migration v1 → v2 confusant
+
+**Commande:** `qa360 run` (après `qa360 init`)
+
+**Problème:**
+- Le template généré par `qa360 init` est en format v1
+- Au lancement, un message de migration apparaît : "📦 Migrated v1 → v2 format"
+- L'utilisateur voit des détails techniques de migration (gates, budgets, targets)
+- C'est confusant pour l'utilisateur qui vient de créer son pack
+
+**Attendu:** `qa360 init` devrait générer directement des packs au format v2 pour éviter ce message
+
+**Exemple du message:**
+```
+📦 Migrated v1 → v2 format
+Changes: Migrated gate "api_smoke" to "smoke" with adapter "playwright-api", ...
+```
+
+**Priorité:** 🟢 Amélioration (mineur)
+**Statut:** ⬜ Nouveau (à faire plus tard)
+
+---
+
+### Template pour ajouter de nouveaux retours
+
+```markdown
+#### [Titre du problème]
+
+**Commande:** `qa360 <commande>`
+
+**Problème:**
+[Description du problème]
+
+**Attendu:** [Ce qui était attendu]
+
+**Priorité:** 🔴 / 🟠 / 🟢
+**Statut:** ⬜ / 🔄 / ✅ / ⏸️
+
+**Suggestion:**
+[Proposition de solution]
+```
+
+---
+
+#### 6. Commande pin ne fonctionne pas avec les short IDs
+
+**Commande:** `qa360 history pin <short-id>`
+
+**Problème:**
+- La commande `qa360 history pin cf0af564` affiche "Run pinned successfully!"
+- Mais dans `qa360 history list`, la pin 📌 ne s'affiche pas
+- La base de données montre toujours `pinned=0`
+
+**Attendu:** La pin doit s'afficher dans la liste
+
+**Priorité:** 🔴 Critique
+**Statut:** ✅ Corrigé (v2.0.7)
+
+**Cause:** La fonction `pin()` utilisait l'ID court directement pour l'UPDATE SQL, mais l'ID complet (UUID) est nécessaire. Le code doit résoudre l'ID court en ID complet avant d'appeler `vault.pinRun()`.
+
+---
+
+#### 7. Format de pack v1.0.0 non reconnu (ancienne génération AI)
+
+**Commande:** `qa360 run` (après `qa360 examples copy complete` ou ancienne génération AI)
+
+**Problème:**
+- Le fichier `.qa360/pack.yml` a `version: 1.0.0` (format semver)
+- Erreur: "Unknown pack format. Version: 1.0.0"
+- Le format legacy avec `adapters` et `tests` n'est plus supporté
+
+**Attendu:** Soit migrer le format, soit donner un message d'erreur clair
+
+**Priorité:** 🟠 Important
+**Statut:** ✅ Corrigé (v2.0.7)
+
+**Solution:**
+- Ajouté support pour les versions semver (1.0.0 → détecté comme v1, 2.0.0 → détecté comme v2)
+- Ajouté message d'erreur explicite pour le format legacy (v0.9.x avec adapters/tests)
+
+**Nouveau message:**
+```
+Legacy pack format detected (version 1.0.0). This format is no longer supported.
+
+To fix this:
+  1. Delete the old pack file: /path/to/pack.yml
+  2. Create a new pack: qa360 init
+  3. Or copy an example: qa360 examples copy api-basic
+```
+
+---
+
+#### 8. Commandes pack validate/lint/migrate non disponibles
+
+**Commande:** `qa360 pack validate` ou `qa360 pack lint`
+
+**Problème:**
+- Les commandes `qa360 pack validate/lint/migrate` retournent "error: unknown command 'pack'"
+- Les imports et l'enregistrement des commandes pack étaient commentés dans `src/index.ts`
+- Le fichier `src/commands/pack.ts` était exclu du `tsconfig.json`
+
+**Attendu:** Les commandes pack doivent être disponibles
+
+**Priorité:** 🟠 Important
+**Statut:** ✅ Corrigé (v2.0.8)
+
+**Solution:**
+- Réactivé l'import des commandes pack dans `src/index.ts`
+- Réactivé l'enregistrement des sous-commandes (validate, lint, migrate)
+- Retiré `pack.ts` de la liste d'exclusion dans `tsconfig.json`
+- Mis à jour `scripts/bundle-for-npm.sh` pour ne pas restaurer `index.ts` et `tsconfig.json`
+
+---
+
+## Statistiques
+
+- **Bugs critiques (🔴):** 1 (corrigé)
+- **Importants (🟠):** 3 (3 corrigés)
+- **Améliorations (🟢):** 4
+- **Total:** 8
+
+---
+
+## Changelog des versions corrigées
+
+### v2.0.8 (2025-01-04)
+- ✅ Fix: Commandes `pack validate/lint/migrate` réactivées et disponibles
+- ✅ Fix: tsconfig.json mis à jour pour inclure pack.ts
+- ✅ Fix: bundle script mis à jour pour préserver index.ts et tsconfig.json
+
+### v2.0.7 (2025-01-04)
+- ✅ Fix: Commande `history pin` résout maintenant les IDs courts
+- ✅ Fix: Support des versions semver (1.0.0, 2.0.0) dans `detectVersion()`
+- ✅ Fix: Message d'erreur explicite pour le format legacy v0.9.x
+- ✅ Fix: Script de bundle mis à jour pour `utils/config.ts`
+
+### v2.0.6 (2025-01-04)
+- ✅ Fix: `history diff` supporte maintenant les IDs courts
+
+### v2.0.5 (2025-01-03)
+- ✅ Fix: Nom du pack correct dans history list
+
+### v2.0.4 (2025-01-03)
+- ✅ Fix: Codes ANSI retirés du tableau history list
+
+### v2.0.3 (2025-01-03)
+- ✅ Fix: Affichage des descriptions des gates dans `qa360 init`
+
+### v2.0.2 (2025-01-03)
+- ✅ Fix: Import inquirer pour CommonJS/ESM interop

package/.claude/settings.local.json

@@ -0,0 +1,154 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(cat:*)",
+      "Bash(ls:*)",
+      "Bash(pnpm run build:*)",
+      "Bash(pnpm run type-check:*)",
+      "Bash(find:*)",
+      "Bash(grep:*)",
+      "Bash(pnpm ls --depth=0)",
+      "Bash(pnpm test:*)",
+      "Bash(pnpm list --depth=0)",
+      "Bash(node:*)",
+      "Bash(pnpm run check:*)",
+      "Bash(pnpm run lint:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git restore:*)",
+      "Bash(git push:*)",
+      "Bash(git rev-list:*)",
+      "Bash(git checkout:*)",
+      "Bash(git merge:*)",
+      "Bash(git fetch:*)",
+      "Bash(git branch:*)",
+      "Bash(git worktree:*)",
+      "Bash(gh run list:*)",
+      "Bash(gh run view:*)",
+      "Bash(pnpm install)",
+      "Bash(pnpm build:*)",
+      "Bash(pnpm type-check:*)",
+      "Bash(cloc:*)",
+      "Bash(qa360 --help:*)",
+      "Bash(npm view:*)",
+      "Bash(git tag:*)",
+      "Bash(npm publish:*)",
+      "Bash(chmod:*)",
+      "Bash(npm run build:bundle:*)",
+      "Bash(npm run publish:dry:*)",
+      "Bash(gh run watch:*)",
+      "Bash(python3:*)",
+      "Bash(npm install:*)",
+      "Bash(npm run publish:real:*)",
+      "Bash(pnpm test:cli:*)",
+      "Bash(pnpm run publish:real:*)",
+      "Bash(qa360 run:*)",
+      "Bash(git pull:*)",
+      "Bash(for file in cli/examples/*.yml examples/restful-api-dev/*.yml)",
+      "Bash(do echo \"Testing: $file\" node cli/bin/qa360.js run \"$file\")",
+      "Bash(npm run test:all:*)",
+      "Bash(npm run type-check:*)",
+      "Bash(npm test:*)",
+      "Bash(wc:*)",
+      "Bash(pnpm lint:*)",
+      "Bash(pnpm clean:*)",
+      "Bash(pnpm build:pkg:*)",
+      "Bash(npx tsc:*)",
+      "Bash(tsc:*)",
+      "Bash(ln:*)",
+      "Bash(npx vitest:*)",
+      "Bash(git check-ignore:*)",
+      "Bash(pnpm add:*)",
+      "Bash(test:*)",
+      "Bash(gh release create:*)",
+      "Bash(gh release view:*)",
+      "Bash(gh release edit:*)",
+      "Bash(pnpm test:coverage:*)",
+      "Bash(pnpm vitest run:*)",
+      "Bash(git reset:*)",
+      "Bash(npm version:*)",
+      "Bash(pnpm test:core:*)",
+      "Bash(npm pack:*)",
+      "Bash(bash scripts/bundle-for-npm.sh:*)",
+      "Bash(pnpm list:*)",
+      "Bash(readlink:*)",
+      "Bash(pnpm --filter qa360 build:*)",
+      "Bash(qa360 history --help:*)",
+      "Bash(pnpm --filter qa360 test:*)",
+      "Bash(npx qa360:*)",
+      "Bash(qa360-mcp serve:*)",
+      "Bash(./setup.sh:*)",
+      "Bash(npm uninstall:*)",
+      "Bash(pnpm install:*)",
+      "Bash(NODE_PATH=/Users/bassiroudiop/QA360/node_modules node:*)",
+      "Bash(export NODE_OPTIONS:*)",
+      "Bash(/Users/bassiroudiop/testQA360/test-mcp.sh:*)",
+      "Bash(qa360-mcp:*)",
+      "Bash(qa360 init --help:*)",
+      "Bash(qa360 examples --help:*)",
+      "Bash(qa360 examples list:*)",
+      "Bash(qa360 verify:*)",
+      "WebSearch",
+      "Bash(git clean:*)",
+      "Bash(cut:*)",
+      "Bash(HARDENING=true pnpm test:*)",
+      "Bash(ENABLE_E2E_TESTS=1 pnpm test:core:*)",
+      "Bash(pnpm test:all:*)",
+      "Bash(npx tsx:*)",
+      "Bash(npm run test:*)",
+      "Bash(npm run test:e2e:*)",
+      "Bash(qa360:*)",
+      "Bash(npm link:*)",
+      "Bash(for file in report.ts serve.ts)",
+      "Bash(do npx tsc:*)",
+      "Bash(done)",
+      "Bash(/Users/bassiroudiop/QA360/cli/bin/qa360.js:*)",
+      "Bash(for:*)",
+      "Bash(do echo \"Compiling $dir...\" find /Users/bassiroudiop/QA360/core/src/$dir -name \"*.ts\" ! -name \"*.test.ts\" ! -name \"*.spec.ts\" ! -path \"*/__tests__/*\" -exec npx tsc {} --outDir /Users/bassiroudiop/QA360/core/dist --moduleResolution node16 --module Node16 --target es2020 --esModuleInterop --skipLibCheck --declaration)",
+      "Bash(bash:*)",
+      "Bash(xargs:*)",
+      "Bash(git rm:*)",
+      "Bash(pnpm test:e2e:*)",
+      "Bash(tree:*)",
+      "Bash(gh workflow run:*)",
+      "Bash(curl:*)",
+      "Bash(pkill:*)",
+      "Bash(/tmp/test-dash3.sh:*)",
+      "Bash(lsof:*)",
+      "Bash(jq:*)",
+      "Bash(pnpm docs:*)",
+      "Bash(npx typedoc)",
+      "Bash(git rev-parse:*)",
+      "Bash(while read:*)",
+      "Bash(sqlite3:*)",
+      "Bash(pnpm --filter qa360 build:bundle:*)",
+      "Bash(pnpm run build:bundle:*)",
+      "Bash(QA360_HOME=/tmp/qa360-secrets-test node dist/index.js secrets list:*)",
+      "Bash(QA360_HOME=/tmp/qa360-secrets-test node:*)",
+      "Bash(gh api:*)",
+      "Bash(git revert:*)",
+      "Bash(pnpm:*)",
+      "Bash(git stash:*)",
+      "Bash(do:*)",
+      "Bash(then echo \"  ✅ $adapter.ts\")",
+      "Bash(else echo \"  ❌ $adapter.ts \\(MANQUANT\\)\")",
+      "Bash(fi:*)",
+      "Bash(du:*)",
+      "Bash(git -C /Users/bassiroudiop/QA360 ls-files)",
+      "Bash(npm unlink:*)",
+      "Bash(got object\" errors.\n\nThis commit transforms page objects into full absolute URLs before\npassing them to the adapter, supporting both formats:\n- String format: [\"path1\", \"path2\"]\n- Object format: [{ url: \"path1\", ... }]\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(got object\" errors.\n\nThis commit transforms page objects into full absolute URLs before\npassing them to the adapter, supporting both formats:\n- String format: [\"path1\", \"path2\"]\n- Object format: [{ url: \"path1\", ... }]\nEOF\n\\)\")",
+      "Bash(gh pr create:*)",
+      "Bash(gh pr close:*)",
+      "Bash(git cherry-pick:*)",
+      "Bash(npm run build:*)",
+      "Bash(echo:*)",
+      "Bash(status\"\n- Valid scenario actions: navigate, fill, click, etc.\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(npm run version:sync:*)",
+      "Bash(tar:*)"
+    ]
+  },
+  "enabledPlugins": {
+    "context7@claude-plugins-official": true
+  }
+}

package/.editorconfig

@@ -0,0 +1,21 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.{js,ts,json}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

package/.github/CODEOWNERS

@@ -0,0 +1,23 @@
+# QA360 Code Owners
+# These owners will be requested for review when someone opens a pull request
+# that modifies files in the specified paths
+
+# Core proof system - requires review for any changes
+/core/src/proof/** @xyqotech/qa360-core-team
+
+# CLI doctor command - critical for CI/CD health
+/cli/src/commands/doctor.ts @xyqotech/qa360-core-team
+
+# CI/CD workflows - requires review to prevent pipeline breakage
+/.github/workflows/** @xyqotech/qa360-core-team
+
+# Package manifests and lockfiles - version control
+/package.json @xyqotech/qa360-core-team
+/pnpm-lock.yaml @xyqotech/qa360-core-team
+/pnpm-workspace.yaml @xyqotech/qa360-core-team
+
+# Security and invariants scripts
+/scripts/ci/** @xyqotech/qa360-core-team
+
+# Schema validation
+/core/src/proof/__tests__/schema-validation-manual.mjs @xyqotech/qa360-core-team

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,108 @@
+name: 🐛 Bug Report
+description: Report a bug in QA360 Proof CLI
+title: "[Bug]: "
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the information below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear description of what the bug is
+      placeholder: What happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Run command '...'
+        2. See error '...'
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+      placeholder: What should have happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+      placeholder: What actually happened?
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: QA360 CLI Version
+      description: Run `qa360 --version`
+      placeholder: "1.1.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - macOS
+        - Linux (Ubuntu)
+        - Linux (other)
+        - Windows 10
+        - Windows 11
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: node
+    attributes:
+      label: Node.js Version
+      description: Run `node --version`
+      placeholder: "v20.10.0"
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error Logs
+      description: Paste any error messages or logs
+      render: shell
+      placeholder: |
+        Error: ...
+        Stack trace: ...
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context about the problem
+      placeholder: Screenshots, related issues, etc.
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Pre-submission Checklist
+      options:
+        - label: I have searched existing issues
+          required: true
+        - label: I have run `qa360 doctor` to check system health
+          required: false
+        - label: I have tried with the latest version
+          required: false

package/.github/ISSUE_TEMPLATE/feedback_dx.yml

@@ -0,0 +1,121 @@
+name: 💡 Developer Experience Feedback
+description: Share feedback about using QA360 Proof CLI
+title: "[DX]: "
+labels: ["feedback", "dx"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        We value your feedback! Help us improve the developer experience.
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Feedback Category
+      options:
+        - Installation
+        - Documentation
+        - Command UX
+        - Error Messages
+        - Performance
+        - Feature Request
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: feedback
+    attributes:
+      label: Your Feedback
+      description: What would you like to share?
+      placeholder: |
+        What worked well?
+        What was confusing?
+        What could be improved?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: satisfaction
+    attributes:
+      label: Overall Satisfaction
+      options:
+        - "5 - Very satisfied"
+        - "4 - Satisfied"
+        - "3 - Neutral"
+        - "2 - Dissatisfied"
+        - "1 - Very dissatisfied"
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: QA360 CLI Version
+      description: Run `qa360 --version`
+      placeholder: "1.1.0"
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - macOS
+        - Linux (Ubuntu)
+        - Linux (other)
+        - Windows 10
+        - Windows 11
+        - Other
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Your Use Case
+      description: How are you using QA360?
+      placeholder: |
+        - Testing environment: CI/CD, local, etc.
+        - Proof volume: daily, weekly, etc.
+        - Integration: standalone, pipeline, etc.
+
+  - type: textarea
+    id: liked
+    attributes:
+      label: What You Liked
+      description: What features or aspects did you appreciate?
+      placeholder: |
+        - Feature X was great because...
+        - The documentation was clear on...
+
+  - type: textarea
+    id: frustrating
+    attributes:
+      label: What Was Frustrating
+      description: What could be better?
+      placeholder: |
+        - I struggled with...
+        - It would be better if...
+
+  - type: textarea
+    id: missing
+    attributes:
+      label: What's Missing
+      description: What features would you like to see?
+      placeholder: |
+        - I wish there was...
+        - It would be useful to have...
+
+  - type: checkboxes
+    id: recommend
+    attributes:
+      label: Would you recommend QA360?
+      options:
+        - label: Yes, I would recommend QA360 to colleagues
+        - label: Maybe, with some improvements
+        - label: No, not in its current state
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Comments
+      description: Anything else you'd like to share?
+      placeholder: Any other thoughts, suggestions, or context