{"_id":"@agents-forge/qa-reporter","name":"@agents-forge/qa-reporter","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@agents-forge/qa-reporter","version":"1.0.0","description":"AI QA Reporter agent — runs Playwright tests and writes a plain English summary report for stakeholders. v2.0 will add Allure report integration.","keywords":["ai","agent","qa","playwright","reporting","allure","quality-engineering","claude","anthropic","agents-forge"],"author":{"name":"Rohan Patil"},"license":"MIT","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"bin":{"qa-reporter":"dist/cli.js"},"scripts":{"build":"tsc","dev":"npx tsx src/cli.ts","start":"node dist/cli.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"engines":{"node":">=18.0.0"},"dependencies":{"@anthropic-ai/claude-agent-sdk":"latest"},"devDependencies":{"@types/node":"^20.0.0","dotenv":"^16.0.0","tsx":"^4.0.0","typescript":"^5.4.0"},"peerDependencies":{"@playwright/test":">=1.40.0","dotenv":">=16"},"peerDependenciesMeta":{"dotenv":{"optional":true},"@playwright/test":{"optional":false}},"_id":"@agents-forge/qa-reporter@1.0.0","_nodeVersion":"22.19.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-eXsZ6FeYyj+wcaCAZF6F4pH2iRl+aUUiEVuke7gNM6BWsu/UmwH1pqlUmJs/kYzKtRtTEpiJBRQRUOnSVcavzg==","shasum":"f0814d54aae91192729ecdcd3f58cb25a1b39d0e","tarball":"https://registry.npmjs.org/@agents-forge/qa-reporter/-/qa-reporter-1.0.0.tgz","fileCount":15,"unpackedSize":41585,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIQCGWGRhuD5LO0Etwm++xqJNzRyfoJi5J/x4nqpmtQuYQQIfWN3vVleNRwIm1RTSBCne+sc0UoJPuh/3ggu8Hy4laA=="}]},"_npmUser":{"name":"rohan12patil","email":"rohan12patil@gmail.com"},"directories":{},"maintainers":[{"name":"rohan12patil","email":"rohan12patil@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/qa-reporter_1.0.0_1782073901380_0.6862356985592271"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-21T20:31:41.159Z","1.0.0":"2026-06-21T20:31:41.528Z","modified":"2026-06-21T20:31:41.867Z"},"maintainers":[{"name":"rohan12patil","email":"rohan12patil@gmail.com"}],"description":"AI QA Reporter agent — runs Playwright tests and writes a plain English summary report for stakeholders. v2.0 will add Allure report integration.","keywords":["ai","agent","qa","playwright","reporting","allure","quality-engineering","claude","anthropic","agents-forge"],"author":{"name":"Rohan Patil"},"license":"MIT","readme":"# 📊 QA Reporter Agent\n\n[![npm version](https://img.shields.io/npm/v/@agents-forge/qa-reporter.svg)](https://www.npmjs.com/package/@agents-forge/qa-reporter)\n\nRuns your Playwright tests and writes a plain English `summary_report.md` that any stakeholder can understand — with failed test explanations, recommendations, and next steps.\n\nPart of the **[@agents-forge](https://www.npmjs.com/org/agents-forge) AIQA pipeline**:\n```\nanalyst → qa-planner → qa-engineer → qa-reviewer → qa-reporter\n```\n\n> **v1.0** uses Playwright's built-in JSON reporter.\n> **v2.0** will add Allure report integration for richer analytics.\n\n---\n\n## Install\n\n```bash\nnpm install @agents-forge/qa-reporter\nnpm install --save-dev @playwright/test\nnpx playwright install chromium\n```\n\n---\n\n## Quick Start\n\n```bash\n# Run all tests + generate stakeholder report\nnpx @agents-forge/qa-reporter\n\n# Smoke tests only\nnpx @agents-forge/qa-reporter --grep @smoke\n```\n\n---\n\n## Authentication\n\nAuto-detected — no config needed:\n\n| Method | Setup |\n|---|---|\n| Anthropic API key | `ANTHROPIC_API_KEY=sk-ant-...` in `.env` |\n| Claude subscription | `npm install -g @anthropic-ai/claude-code` → `claude login` |\n| GitHub Copilot | `gh auth login` |\n\n---\n\n## Features\n\n- 🎭 **Runs Playwright tests** — with optional grep filter or spec file\n- 📖 **Reads JSON results** — parses Playwright's built-in JSON reporter\n- 📝 **Writes `summary_report.md`** — plain English for stakeholders\n- ❌ **Explains failures** — error messages + likely cause + recommended fix\n- 📋 **Cross-references** `review_report.md` — flags predicted vs actual failures\n- 🔐 **Multi-provider auth** — API key, claude login, or GitHub Copilot\n- 🔄 **Results-only mode** — skip test run, just report on existing results\n\n---\n\n## CLI Usage\n\n```bash\n# Run all tests\nnpx @agents-forge/qa-reporter\n\n# Filter by tag\nnpx @agents-forge/qa-reporter --grep @smoke\nnpx @agents-forge/qa-reporter --grep @regression\n\n# Custom output\nnpx @agents-forge/qa-reporter --output sprint_23_report.md\n\n# Single spec file\nnpx @agents-forge/qa-reporter --spec tests/login.spec.ts\n\n# Read existing results (no test run)\nnpx @agents-forge/qa-reporter --results-only\n\n# Different directory\nnpx @agents-forge/qa-reporter --dir ./my-project\n```\n\n---\n\n## Programmatic Usage\n\n```typescript\nimport { runQAReporter } from \"@agents-forge/qa-reporter\";\n\nconst result = await runQAReporter({\n  grep: \"@smoke\",                    // optional tag filter\n  specFile: \"tests/login.spec.ts\",   // optional specific file\n  outputFile: \"smoke_report.md\",     // optional output name\n  cwd: process.cwd(),                // optional directory\n  resultsOnly: false,                // optional skip test run\n});\n\nconsole.log(`Passed: ${result.passed}, Failed: ${result.failed}`);\n```\n\n---\n\n## Output: `summary_report.md`\n\n```markdown\n# Test Execution Report\nStatus: ✅ PASSED / ❌ FAILED / ⚠️ PARTIAL\n\n## Results Summary\n| ✅ Passed | ❌ Failed | ⏭️ Skipped | 🔄 Flaky | Total | Duration |\n\n## Test Suite Breakdown\n| Module | Passed | Failed | Skipped | Duration |\n\n## ❌ Failed Tests\n(with error message, likely cause, recommended fix per test)\n\n## 🔄 Flaky Tests\n## ⏱️ Performance (slowest tests)\n## Browser Matrix Results\n## Known Issues Cross-reference\n## Recommendations\n## Next Steps\n```\n\n---\n\n## Playwright Config Requirements\n\nYour `playwright.config.ts` must include the JSON reporter:\n```typescript\nreporter: [\n  [\"json\", { outputFile: \"test-results/results.json\" }],\n  [\"html\", { outputFolder: \"playwright-report\" }],\n]\n```\nThis is automatically configured if you used `@agents-forge/qa-engineer`.\n\n---\n\n## Full Pipeline\n\n```bash\nnpx @agents-forge/analyst https://my-app.com requirements.md\nnpx @agents-forge/qa-planner requirements.md test_plan.md\nnpx @agents-forge/qa-engineer test_plan.md --url https://my-app.com\nnpx @agents-forge/qa-reviewer\nnpx @agents-forge/qa-reporter --grep @smoke\n```\n\n---\n\n## Roadmap\n\n| Version | Reporter | Status |\n|---|---|---|\n| v1.0 | Playwright built-in JSON | ✅ Current |\n| v2.0 | Allure Reports | 🔲 Planned |\n\n---\n\n## Troubleshooting\n\n| Error | Fix |\n|---|---|\n| `Playwright not found` | `npm install --save-dev @playwright/test` |\n| `playwright.config.ts not found` | Run `@agents-forge/qa-engineer` first |\n| `No JSON results file found` | Add JSON reporter to `playwright.config.ts` |\n| `Authentication failed` | Set `ANTHROPIC_API_KEY` or run `claude login` |\n| Tests fail on CI | Set `BASE_URL` env var in your CI config |\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-89c93a9edebca8d462f551158c6b62e9"}