qaa-agent 1.6.2 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/.mcp.json +8 -8
  2. package/CHANGELOG.md +93 -71
  3. package/CLAUDE.md +553 -553
  4. package/agents/qa-pipeline-orchestrator.md +1378 -1378
  5. package/agents/qaa-analyzer.md +539 -524
  6. package/agents/qaa-bug-detective.md +479 -446
  7. package/agents/qaa-codebase-mapper.md +935 -935
  8. package/agents/qaa-discovery.md +384 -0
  9. package/agents/qaa-e2e-runner.md +416 -415
  10. package/agents/qaa-executor.md +651 -651
  11. package/agents/qaa-planner.md +405 -390
  12. package/agents/qaa-project-researcher.md +319 -319
  13. package/agents/qaa-scanner.md +424 -424
  14. package/agents/qaa-testid-injector.md +643 -585
  15. package/agents/qaa-validator.md +490 -452
  16. package/bin/install.cjs +200 -198
  17. package/bin/lib/commands.cjs +709 -709
  18. package/bin/lib/config.cjs +307 -307
  19. package/bin/lib/core.cjs +497 -497
  20. package/bin/lib/frontmatter.cjs +299 -299
  21. package/bin/lib/init.cjs +989 -989
  22. package/bin/lib/milestone.cjs +241 -241
  23. package/bin/lib/model-profiles.cjs +60 -60
  24. package/bin/lib/phase.cjs +911 -911
  25. package/bin/lib/roadmap.cjs +306 -306
  26. package/bin/lib/state.cjs +748 -748
  27. package/bin/lib/template.cjs +222 -222
  28. package/bin/lib/verify.cjs +842 -842
  29. package/bin/qaa-tools.cjs +607 -607
  30. package/commands/qa-audit.md +119 -0
  31. package/commands/qa-create-test.md +288 -0
  32. package/commands/qa-fix.md +147 -0
  33. package/commands/qa-map.md +137 -0
  34. package/{.claude/commands → commands}/qa-pr.md +23 -23
  35. package/{.claude/commands → commands}/qa-start.md +22 -22
  36. package/{.claude/commands → commands}/qa-testid.md +19 -19
  37. package/docs/COMMANDS.md +341 -341
  38. package/docs/DEMO.md +182 -182
  39. package/docs/TESTING.md +156 -156
  40. package/package.json +6 -7
  41. package/{.claude/settings.json → settings.json} +1 -2
  42. package/templates/failure-classification.md +391 -391
  43. package/templates/gap-analysis.md +409 -409
  44. package/templates/pr-template.md +48 -48
  45. package/templates/qa-analysis.md +381 -381
  46. package/templates/qa-audit-report.md +465 -465
  47. package/templates/qa-repo-blueprint.md +636 -636
  48. package/templates/scan-manifest.md +312 -312
  49. package/templates/test-inventory.md +582 -582
  50. package/templates/testid-audit-report.md +354 -354
  51. package/templates/validation-report.md +243 -243
  52. package/workflows/qa-analyze.md +296 -296
  53. package/workflows/qa-from-ticket.md +536 -536
  54. package/workflows/qa-gap.md +309 -303
  55. package/workflows/qa-pr.md +389 -389
  56. package/workflows/qa-start.md +1192 -1168
  57. package/workflows/qa-testid.md +384 -356
  58. package/workflows/qa-validate.md +299 -295
  59. package/.claude/commands/create-test.md +0 -164
  60. package/.claude/commands/qa-audit.md +0 -37
  61. package/.claude/commands/qa-blueprint.md +0 -54
  62. package/.claude/commands/qa-fix.md +0 -36
  63. package/.claude/commands/qa-from-ticket.md +0 -24
  64. package/.claude/commands/qa-gap.md +0 -20
  65. package/.claude/commands/qa-map.md +0 -47
  66. package/.claude/commands/qa-pom.md +0 -36
  67. package/.claude/commands/qa-pyramid.md +0 -37
  68. package/.claude/commands/qa-report.md +0 -38
  69. package/.claude/commands/qa-research.md +0 -33
  70. package/.claude/commands/qa-validate.md +0 -42
  71. package/.claude/commands/update-test.md +0 -58
  72. package/.claude/skills/qa-learner/SKILL.md +0 -150
  73. /package/{.claude/skills → skills}/qa-bug-detective/SKILL.md +0 -0
  74. /package/{.claude/skills → skills}/qa-repo-analyzer/SKILL.md +0 -0
  75. /package/{.claude/skills → skills}/qa-self-validator/SKILL.md +0 -0
  76. /package/{.claude/skills → skills}/qa-template-engine/SKILL.md +0 -0
  77. /package/{.claude/skills → skills}/qa-testid-injector/SKILL.md +0 -0
  78. /package/{.claude/skills → skills}/qa-workflow-documenter/SKILL.md +0 -0
package/.mcp.json CHANGED
@@ -1,8 +1,8 @@
1
- {
2
- "mcpServers": {
3
- "playwright": {
4
- "command": "npx",
5
- "args": ["@playwright/mcp@latest"]
6
- }
7
- }
8
- }
1
+ {
2
+ "mcpServers": {
3
+ "playwright": {
4
+ "command": "npx",
5
+ "args": ["@playwright/mcp@latest"]
6
+ }
7
+ }
8
+ }
package/CHANGELOG.md CHANGED
@@ -1,71 +1,93 @@
1
-
2
- # Changelog
3
-
4
- All notable changes to QAA (QA Automation Agent) are documented here.
5
-
6
- ## [1.6.0] - 2026-03-25
7
-
8
- ### Added
9
- - Playwright MCP server bundled in agent package (`.mcp.json`) -- starts automatically when opening project in Claude Code
10
- - Persistent locator registry at `.qa-output/locators/` -- accumulates real locators across features over time
11
- - Per-feature files: `{feature}.locators.md` -- extracted locators for each feature tested
12
- - Central index: `LOCATOR_REGISTRY.md` -- all locators by page, searchable by any command
13
- - Browser-based locator extraction step in `/create-test` and `/qa-from-ticket` -- navigates live app with Playwright MCP and captures real data-testid, ARIA roles, and labels before generating tests
14
- - Registry cache: if locators for a feature already exist in the registry, browser extraction is skipped (reuses cached locators)
15
- - `--app-url` flag added to `/qa-from-ticket`
16
- - CHANGELOG.md
17
-
18
- ### Changed
19
- - `qaa-executor` now reads locator registry (when available) to use real locators in POMs instead of proposing them
20
- - `/create-test` flow: checks registry first, then extracts via browser if needed, BEFORE test generation
21
- - `/qa-from-ticket` workflow: locator extraction step added after source scan, before test case generation
22
-
23
- ### Removed
24
- - `/qa-analyze` command (deprecated since v1.4.0, fully replaced by `/qa-map`)
25
-
26
- ## [1.5.0] - 2026-03-24
27
-
28
- ### Added
29
- - Stable release
30
-
31
- ## [1.4.0]
32
-
33
- ### Changed
34
- - Merged `/qa-analyze` into `/qa-map` -- single command for codebase scanning and analysis
35
- - Consolidated pipeline flow
36
-
37
- ### Deprecated
38
- - `/qa-analyze` command (use `/qa-map` instead)
39
-
40
- ## [1.3.0]
41
-
42
- ### Added
43
- - `qa-learner` skill -- persistent preferences from user corrections
44
- - Preferences saved to `~/.claude/qaa/MY_PREFERENCES.md`
45
- - Trigger detection for English and Spanish frustration signals
46
-
47
- ## [1.2.0]
48
-
49
- ### Added
50
- - `qaa-codebase-mapper` agent -- 4 parallel focus areas (testability, risk, patterns, existing tests)
51
- - `qaa-project-researcher` agent -- researches best testing stack and practices
52
- - 8 codebase map documents produced by mapper
53
-
54
- ## [1.1.0]
55
-
56
- ### Added
57
- - Workflow definitions for all pipeline stages
58
- - Interactive installer (`npx qaa-agent`)
59
- - `qaa init` command for per-project initialization
60
- - npm package distribution
61
-
62
- ## [1.0.0]
63
-
64
- ### Added
65
- - Full QA automation pipeline -- 11 agents, 17 commands, 10 templates, 7 workflows
66
- - 3 workflow options (dev-only, immature QA, mature QA)
67
- - 4-layer test validation (syntax, structure, dependencies, logic)
68
- - Page Object Model generation with CLAUDE.md standards
69
- - Test ID injection for frontend components
70
- - Bug detective failure classification
71
- - Draft PR delivery with branch naming convention
1
+
2
+ # Changelog
3
+
4
+ All notable changes to QAA (QA Automation Agent) are documented here.
5
+
6
+ ## [1.7.0] - 2026-04-02
7
+
8
+ ### Added
9
+ - **qaa-testid-injector**: Playwright MCP integration for live DOM verification before injection, codebase map reading (CODE_PATTERNS, TEST_SURFACE, TESTABILITY), and locator registry cross-referencing
10
+ - **qaa-validator**: codebase map reading (CODE_PATTERNS, TEST_SURFACE, API_CONTRACTS) for structure and logic validation, locator registry cross-check for POM accuracy
11
+ - **qaa-planner**: locator registry reading to assess E2E feasibility and improve complexity estimation
12
+ - **qaa-analyzer**: locator registry reading to inform risk assessment and testing pyramid recommendations
13
+ - **qaa-e2e-runner**: locator registry update after execution -- all discovered real locators are persisted
14
+ - **qa-validate workflow**: now passes codebase map and locator registry to validator agent
15
+ - **qa-gap workflow**: now passes codebase map and locator registry to analyzer agent
16
+ - **qa-testid workflow**: now passes codebase map, locator registry, and app_url to injector agent
17
+
18
+ ### Changed
19
+ - **E2E runner max fix loops: 3 5** -- more attempts to fix locator/assertion mismatches before giving up
20
+ - **Installer**: updated paths for new package structure (commands/ and skills/ at root level), updated command list to reflect 7 consolidated commands
21
+ - **Package structure**: commands and skills now live at package root instead of `.claude/` subdirectory
22
+ - **Repository**: moved to `capmation/qaa-testing`
23
+
24
+ ### Consolidated
25
+ - 7 slash commands: `/qa-start`, `/qa-create-test`, `/qa-map`, `/qa-testid`, `/qa-pr`, `/qa-audit`, `/qa-fix`
26
+ - Removed standalone `/qa-analyze`, `/qa-validate`, `/qa-gap` -- integrated into other commands
27
+
28
+ ## [1.6.0] - 2026-03-25
29
+
30
+ ### Added
31
+ - Playwright MCP server bundled in agent package (`.mcp.json`) -- starts automatically when opening project in Claude Code
32
+ - Persistent locator registry at `.qa-output/locators/` -- accumulates real locators across features over time
33
+ - Per-feature files: `{feature}.locators.md` -- extracted locators for each feature tested
34
+ - Central index: `LOCATOR_REGISTRY.md` -- all locators by page, searchable by any command
35
+ - Browser-based locator extraction step in `/create-test` and `/qa-from-ticket` -- navigates live app with Playwright MCP and captures real data-testid, ARIA roles, and labels before generating tests
36
+ - Registry cache: if locators for a feature already exist in the registry, browser extraction is skipped (reuses cached locators)
37
+ - `--app-url` flag added to `/qa-from-ticket`
38
+ - CHANGELOG.md
39
+
40
+ ### Changed
41
+ - `qaa-executor` now reads locator registry (when available) to use real locators in POMs instead of proposing them
42
+ - `/create-test` flow: checks registry first, then extracts via browser if needed, BEFORE test generation
43
+ - `/qa-from-ticket` workflow: locator extraction step added after source scan, before test case generation
44
+
45
+ ### Removed
46
+ - `/qa-analyze` command (deprecated since v1.4.0, fully replaced by `/qa-map`)
47
+
48
+ ## [1.5.0] - 2026-03-24
49
+
50
+ ### Added
51
+ - Stable release
52
+
53
+ ## [1.4.0]
54
+
55
+ ### Changed
56
+ - Merged `/qa-analyze` into `/qa-map` -- single command for codebase scanning and analysis
57
+ - Consolidated pipeline flow
58
+
59
+ ### Deprecated
60
+ - `/qa-analyze` command (use `/qa-map` instead)
61
+
62
+ ## [1.3.0]
63
+
64
+ ### Added
65
+ - `qa-learner` skill -- persistent preferences from user corrections
66
+ - Preferences saved to `~/.claude/qaa/MY_PREFERENCES.md`
67
+ - Trigger detection for English and Spanish frustration signals
68
+
69
+ ## [1.2.0]
70
+
71
+ ### Added
72
+ - `qaa-codebase-mapper` agent -- 4 parallel focus areas (testability, risk, patterns, existing tests)
73
+ - `qaa-project-researcher` agent -- researches best testing stack and practices
74
+ - 8 codebase map documents produced by mapper
75
+
76
+ ## [1.1.0]
77
+
78
+ ### Added
79
+ - Workflow definitions for all pipeline stages
80
+ - Interactive installer (`npx qaa-agent`)
81
+ - `qaa init` command for per-project initialization
82
+ - npm package distribution
83
+
84
+ ## [1.0.0]
85
+
86
+ ### Added
87
+ - Full QA automation pipeline -- 11 agents, 17 commands, 10 templates, 7 workflows
88
+ - 3 workflow options (dev-only, immature QA, mature QA)
89
+ - 4-layer test validation (syntax, structure, dependencies, logic)
90
+ - Page Object Model generation with CLAUDE.md standards
91
+ - Test ID injection for frontend components
92
+ - Bug detective failure classification
93
+ - Draft PR delivery with branch naming convention