@agents-forge/aiqa 1.0.0

package/dist/subagents/qa-engineer.d.ts

@@ -0,0 +1,4 @@
+import type { Session } from "../session.js";
+import type { AIQAPaths } from "../config.js";
+export declare function buildQAEngineerPrompt(session: Session, paths: Required<AIQAPaths>): string;
+//# sourceMappingURL=qa-engineer.d.ts.map

package/dist/subagents/qa-engineer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-engineer.d.ts","sourceRoot":"","sources":["../../src/subagents/qa-engineer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,CA2I1F"}

package/dist/subagents/qa-engineer.js

@@ -0,0 +1,139 @@
+export function buildQAEngineerPrompt(session, paths) {
+    const base = paths.base;
+    const scriptsDir = `${base}/${paths.testScripts}`;
+    const reportsDir = `${base}/${paths.reports}`;
+    const resultsDir = `${reportsDir}/test-results`;
+    const htmlDir = `${reportsDir}/playwright-report`;
+    const authState = `${base}/auth-state.json`;
+    const snapshotList = Object.values(session.snapshots)
+        .map((s) => `- ${s.page}: ${s.filePath} (${s.url})`)
+        .join("\n") || "- No snapshots available";
+    return `You are acting as a Senior QA Engineer with 15+ years experience.
+
+INPUTS:
+- Test plan: "${session.outputs.testPlan}"
+- Snapshots:
+${snapshotList}
+- Auth state: "${session.outputs.authState}" (if exists)
+
+OUTPUTS:
+- Test cases: "${session.outputs.testCasesDir}/<module>.md"
+- Spec files: "${session.outputs.specsDir}/<module>.spec.ts"
+- Playwright config: "${session.outputs.playwrightConfig}"
+
+BASE URL: "${session.baseUrl}"
+
+## Process
+
+### Step 1 — Read all inputs
+Read the test plan and every snapshot file.
+The snapshots contain accessibility trees with element refs — use these for accurate selectors.
+
+### Step 2 — For each module in the test plan
+
+#### 2a. Write test-cases/<module>.md
+\`\`\`markdown
+# <Module> — Test Cases
+
+## Smoke Tests (@smoke @p0)
+| ID | Title | Preconditions | Steps | Expected Result |
+|---|---|---|---|---|
+| TC-<MOD>-S-001 | ... | ... | 1. ... | ... |
+
+## Regression Tests (@regression @p1)
+## Negative Tests (@negative @p1)
+## Edge Cases (@edge @p2)
+\`\`\`
+
+#### 2b. Generate tests/<module>.spec.ts using playwright-cli
+
+First check if playwright-cli is available:
+\`\`\`bash
+playwright-cli --version
+\`\`\`
+
+If available — use it to generate scripts:
+\`\`\`bash
+playwright-cli generate "${session.outputs.specsDir}/<module>.spec.ts" --url "${session.baseUrl}/<module-path>"
+\`\`\`
+
+Then enhance the generated file by:
+- Reading the snapshot for this module to verify selectors
+- Organising into describe blocks by test type
+- Adding TC IDs matching the .md file
+- Adding tags (@smoke @p0 etc.)
+- Replacing any weak selectors with ones from the snapshot accessibility tree
+
+If playwright-cli is NOT available — write spec files directly using snapshot refs:
+
+\`\`\`typescript
+import { test, expect } from "@playwright/test";
+
+const BASE_URL = process.env.BASE_URL || "${session.baseUrl}";
+
+test.describe("<Module> — Smoke", () => {
+  test("TC-<MOD>-S-001 — <title> @smoke @p0", async ({ page }) => {
+    await page.goto(BASE_URL);
+    // Use REAL selectors from snapshot accessibility tree
+    await page.getByRole("button", { name: "<actual name from snapshot>" }).click();
+    await expect(page.getByRole("<role>", { name: "<name>" })).toBeVisible();
+  });
+});
+
+test.describe("<Module> — Regression", () => { /* ... */ });
+test.describe("<Module> — Negative", () => { /* ... */ });
+test.describe("<Module> — Edge Cases", () => { /* ... */ });
+\`\`\`
+
+### Step 3 — Write the Playwright config to "${session.outputs.playwrightConfig}"
+The config lives at the project root, but ALL generated test artifacts live under .aiqa/.
+Use these exact paths:
+\`\`\`typescript
+import { defineConfig, devices } from "@playwright/test";
+import fs from "fs";
+
+export default defineConfig({
+  testDir: "./${scriptsDir}",
+  // Keep ALL Playwright output under ${base}/ so nothing lands in the repo root.
+  outputDir: "./${resultsDir}",
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: [
+    ["html", { outputFolder: "./${htmlDir}", open: "never" }],
+    ["json", { outputFile: "./${resultsDir}/results.json" }],
+    ["junit", { outputFile: "./${resultsDir}/results.xml" }],
+  ],
+  use: {
+    baseURL: process.env.BASE_URL || "${session.baseUrl}",
+    trace: "on-first-retry",
+    screenshot: "only-on-failure",
+    video: "on-first-retry",
+    storageState: fs.existsSync("./${authState}")
+      ? "./${authState}"
+      : undefined,
+  },
+  projects: [
+    { name: "chromium", use: { ...devices["Desktop Chrome"] } },
+    { name: "firefox", use: { ...devices["Desktop Firefox"] } },
+    { name: "webkit", use: { ...devices["Desktop Safari"] } },
+    { name: "mobile", use: { ...devices["Pixel 5"] } },
+  ],
+});
+\`\`\`
+
+### Step 4 — Verify files
+\`\`\`bash
+find "${session.outputs.testCasesDir}" -name "*.md" | sort
+find "${session.outputs.specsDir}" -name "*.spec.ts" | sort
+\`\`\`
+
+## Quality standards
+- ALWAYS use selectors from snapshot accessibility trees — never guess
+- Every spec test must map to a TC ID in the corresponding .md file
+- Tests must be fully independent — no shared state
+- Use getByRole(), getByLabel(), getByTestId() — never CSS classes or XPath
+- If auth-state.json exists, use it so tests start authenticated where needed`;
+}
+//# sourceMappingURL=qa-engineer.js.map

package/dist/subagents/qa-engineer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-engineer.js","sourceRoot":"","sources":["../../src/subagents/qa-engineer.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,KAA0B;IAChF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,UAAU,GAAG,GAAG,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,GAAG,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,GAAG,UAAU,eAAe,CAAC;IAChD,MAAM,OAAO,GAAG,GAAG,UAAU,oBAAoB,CAAC;IAClD,MAAM,SAAS,GAAG,GAAG,IAAI,kBAAkB,CAAC;IAE5C,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC;SACnD,IAAI,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC;IAE5C,OAAO;;;gBAGO,OAAO,CAAC,OAAO,CAAC,QAAQ;;EAEtC,YAAY;iBACG,OAAO,CAAC,OAAO,CAAC,SAAS;;;iBAGzB,OAAO,CAAC,OAAO,CAAC,YAAY;iBAC5B,OAAO,CAAC,OAAO,CAAC,QAAQ;wBACjB,OAAO,CAAC,OAAO,CAAC,gBAAgB;;aAE3C,OAAO,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAiCD,OAAO,CAAC,OAAO,CAAC,QAAQ,6BAA6B,OAAO,CAAC,OAAO;;;;;;;;;;;;;;;4CAenD,OAAO,CAAC,OAAO;;;;;;;;;;;;;;;;+CAgBZ,OAAO,CAAC,OAAO,CAAC,gBAAgB;;;;;;;;gBAQ/D,UAAU;wCACc,IAAI;kBAC1B,UAAU;;;;;;kCAMM,OAAO;gCACT,UAAU;iCACT,UAAU;;;wCAGH,OAAO,CAAC,OAAO;;;;qCAIlB,SAAS;aACjC,SAAS;;;;;;;;;;;;;;QAcd,OAAO,CAAC,OAAO,CAAC,YAAY;QAC5B,OAAO,CAAC,OAAO,CAAC,QAAQ;;;;;;;;8EAQ8C,CAAC;AAC/E,CAAC"}

package/dist/subagents/qa-planner.d.ts

@@ -0,0 +1,3 @@
+import type { Session } from "../session.js";
+export declare function buildQAPlannerPrompt(session: Session): string;
+//# sourceMappingURL=qa-planner.d.ts.map

package/dist/subagents/qa-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-planner.d.ts","sourceRoot":"","sources":["../../src/subagents/qa-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAoE7D"}

package/dist/subagents/qa-planner.js

@@ -0,0 +1,69 @@
+export function buildQAPlannerPrompt(session) {
+    const snapshotList = Object.values(session.snapshots)
+        .map((s) => `- ${s.page}: ${s.filePath} (${s.url})`)
+        .join("\n") || "- No snapshots yet (analyst may still be running)";
+    return `You are acting as a Senior QA Lead / Test Manager with 15+ years experience.
+
+INPUT: "${session.outputs.requirements}"
+SNAPSHOTS:
+${snapshotList}
+OUTPUT: "${session.outputs.testPlan}"
+BASE URL: "${session.baseUrl}"
+
+## Process
+
+### Step 1 — Read inputs
+Use the Read tool to read:
+1. "${session.outputs.requirements}" — the requirements document
+2. Each snapshot file listed above — to understand actual UI complexity
+
+### Step 2 — Analyse snapshot complexity
+For each snapshot, assess:
+- Number of interactive elements (forms, buttons, links)
+- Authentication requirements
+- Dynamic content (lists, pagination, filters)
+- Integration points (payment, maps, social login)
+Use this to assign accurate P0/P1/P2 priorities and risk levels.
+
+### Step 3 — Write "${session.outputs.testPlan}"
+
+Sections:
+1. **Document Info** — version, date, status
+2. **Executive Summary** — testing objectives
+3. **Scope** — in scope / out of scope (reference actual features from requirements)
+4. **Test Objectives** — numbered, measurable goals
+5. **Test Strategy**
+   | Type | Description | Priority |
+   | Smoke | Critical path | P0 |
+   | Regression | Full coverage | P1 |
+   | Negative | Error handling | P1 |
+   | Edge | Boundaries | P2 |
+   | Accessibility | WCAG 2.1 AA | P2 |
+
+6. **Feature Areas & Test Coverage**
+   For each feature from requirements:
+   - Feature name
+   - Snapshot reference (which .yml file shows this)
+   - Test types needed
+   - Priority (P0/P1/P2)
+   - Risk level (High/Medium/Low)
+   - Risk reason (based on what you saw in the snapshot)
+
+7. **Risk Analysis** — table with likelihood, impact, mitigation
+8. **Test Environments** — browsers, devices, test data
+9. **Entry & Exit Criteria**
+10. **Test Tagging Model**
+    \`\`\`
+    @smoke @regression @negative @edge @p0 @p1 @p2
+    \`\`\`
+11. **Module List** — list every module to be tested (one per feature area)
+    This list will be used by qa-engineer to create one spec file per module.
+12. **Assumptions & Dependencies**
+13. **Sign-off**
+
+## Quality standards
+- Every feature area must reference its snapshot file
+- Risk levels must be justified by what you actually saw in the UI
+- Module list must be explicit — qa-engineer uses it directly`;
+}
+//# sourceMappingURL=qa-planner.js.map

package/dist/subagents/qa-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-planner.js","sourceRoot":"","sources":["../../src/subagents/qa-planner.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC;SACnD,IAAI,CAAC,IAAI,CAAC,IAAI,mDAAmD,CAAC;IAErE,OAAO;;UAEC,OAAO,CAAC,OAAO,CAAC,YAAY;;EAEpC,YAAY;WACH,OAAO,CAAC,OAAO,CAAC,QAAQ;aACtB,OAAO,CAAC,OAAO;;;;;;MAMtB,OAAO,CAAC,OAAO,CAAC,YAAY;;;;;;;;;;;sBAWZ,OAAO,CAAC,OAAO,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAuCgB,CAAC;AAC/D,CAAC"}

package/dist/subagents/qa-reporter.d.ts

@@ -0,0 +1,4 @@
+import type { Session } from "../session.js";
+import type { AIQAPaths } from "../config.js";
+export declare function buildQAReporterPrompt(session: Session, grep?: string, paths?: Required<AIQAPaths>): string;
+//# sourceMappingURL=qa-reporter.d.ts.map

package/dist/subagents/qa-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-reporter.d.ts","sourceRoot":"","sources":["../../src/subagents/qa-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,CA6F1G"}

package/dist/subagents/qa-reporter.js

@@ -0,0 +1,94 @@
+export function buildQAReporterPrompt(session, grep, paths) {
+    const resultsJson = `${session.outputs.testResultsDir}/results.json`;
+    const reportsRel = paths ? `${paths.base}/${paths.reports}` : ".aiqa/reports";
+    const resultsRel = `${reportsRel}/test-results`;
+    const htmlRel = `${reportsRel}/playwright-report`;
+    return `You are acting as a Senior QA Lead writing an executive test execution report.
+
+INPUTS:
+- Review report: "${session.outputs.reviewReport}"
+- Playwright config: "${session.outputs.playwrightConfig}"
+- Test results (after run): "${resultsJson}"
+- Snapshots dir: "${session.outputs.snapshotsDir}" (for failure context)
+
+OUTPUT: "${session.outputs.summaryReport}"
+BASE URL: "${session.baseUrl}"
+${grep ? `TEST FILTER: ${grep}` : ""}
+
+## Process
+
+### Step 1 — Run Playwright tests
+Use the Bash tool (run from the project root so playwright.config.ts is picked up):
+\`\`\`bash
+${grep
+        ? `npx playwright test --grep "${grep}" --reporter=json --reporter=html`
+        : `npx playwright test --reporter=json --reporter=html`}
+\`\`\`
+
+Note the exit code — 0 means all passed, non-zero means failures.
+
+### Step 2 — Read results
+\`\`\`bash
+cat "${resultsJson}"
+\`\`\`
+Extract:
+- Total: passed, failed, skipped, flaky
+- Duration
+- Per-suite breakdown
+- Failed test names + error messages + stack traces
+
+### Step 3 — Capture failure snapshots
+For each FAILED test, use playwright-cli to capture the failure state:
+\`\`\`bash
+playwright-cli open "${session.baseUrl}"
+playwright-cli navigate <failed-test-url>
+playwright-cli snapshot > "${session.outputs.snapshotsDir}/failure-<test-name>.yml"
+playwright-cli screenshot > "${session.outputs.testResultsDir}/failure-<test-name>.png"
+\`\`\`
+This gives visual context for every failure.
+
+### Step 4 — Cross-reference review report
+Read "${session.outputs.reviewReport}".
+For each failure — was it predicted by the reviewer?
+- Yes → "Known issue — flagged in review"
+- No → "Unexpected failure — needs investigation"
+
+### Step 5 — Write "${session.outputs.summaryReport}"
+
+\`\`\`markdown
+# Test Execution Report
+Date: <today>
+Environment: ${session.baseUrl}
+Run ID: ${session.runId}
+${grep ? `Filter: ${grep}` : "Full suite"}
+Status: ✅ PASSED / ❌ FAILED / ⚠️ PARTIAL
+Generated by: @agents-forge/aiqa
+
+## Results Summary
+| ✅ Passed | ❌ Failed | ⏭️ Skipped | 🔄 Flaky | Total | Duration |
+
+## Test Suite Breakdown
+| Module | Passed | Failed | Skipped | Duration |
+
+## ❌ Failed Tests
+For each failure:
+### <Test Name>
+- **TC ID:** TC-XXX-S-001
+- **Error:** <exact error>
+- **Predicted by reviewer:** Yes/No
+- **Failure snapshot:** ${resultsRel}/failure-<name>.png
+- **Likely cause:** <plain English>
+- **Recommended fix:** <specific action>
+
+## 🔄 Flaky Tests
+## ⏱️ Slowest Tests (top 5)
+## Browser Matrix Results
+## Known Issues Cross-reference
+## Recommendations
+## Next Steps
+- [ ] Fix failing tests
+- [ ] Re-run: npx playwright test --grep "<failed-test>"
+- [ ] View HTML report: npx playwright show-report ${htmlRel}
+\`\`\``;
+}
+//# sourceMappingURL=qa-reporter.js.map

package/dist/subagents/qa-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-reporter.js","sourceRoot":"","sources":["../../src/subagents/qa-reporter.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,IAAa,EAAE,KAA2B;IAChG,MAAM,WAAW,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,eAAe,CAAC;IACrE,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;IAC9E,MAAM,UAAU,GAAG,GAAG,UAAU,eAAe,CAAC;IAChD,MAAM,OAAO,GAAG,GAAG,UAAU,oBAAoB,CAAC;IAElD,OAAO;;;oBAGW,OAAO,CAAC,OAAO,CAAC,YAAY;wBACxB,OAAO,CAAC,OAAO,CAAC,gBAAgB;+BACzB,WAAW;oBACtB,OAAO,CAAC,OAAO,CAAC,YAAY;;WAErC,OAAO,CAAC,OAAO,CAAC,aAAa;aAC3B,OAAO,CAAC,OAAO;EAC1B,IAAI,CAAC,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;EAOlC,IAAI;QACJ,CAAC,CAAC,+BAA+B,IAAI,mCAAmC;QACxE,CAAC,CAAC,qDAAqD;;;;;;;OAOlD,WAAW;;;;;;;;;;;uBAWK,OAAO,CAAC,OAAO;;6BAET,OAAO,CAAC,OAAO,CAAC,YAAY;+BAC1B,OAAO,CAAC,OAAO,CAAC,cAAc;;;;;QAKrD,OAAO,CAAC,OAAO,CAAC,YAAY;;;;;sBAKd,OAAO,CAAC,OAAO,CAAC,aAAa;;;;;eAKpC,OAAO,CAAC,OAAO;UACpB,OAAO,CAAC,KAAK;EACrB,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY;;;;;;;;;;;;;;;;0BAgBf,UAAU;;;;;;;;;;;;qDAYiB,OAAO;OACrD,CAAC;AACR,CAAC"}

package/dist/subagents/qa-reviewer.d.ts

@@ -0,0 +1,3 @@
+import type { Session } from "../session.js";
+export declare function buildQAReviewerPrompt(session: Session): string;
+//# sourceMappingURL=qa-reviewer.d.ts.map

package/dist/subagents/qa-reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-reviewer.d.ts","sourceRoot":"","sources":["../../src/subagents/qa-reviewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAgG9D"}

package/dist/subagents/qa-reviewer.js

@@ -0,0 +1,97 @@
+export function buildQAReviewerPrompt(session) {
+    const snapshotList = Object.values(session.snapshots)
+        .map((s) => `- ${s.page}: ${s.filePath}`)
+        .join("\n") || "- No snapshots available";
+    return `You are acting as a Principal QA Engineer / Test Architect conducting a peer review.
+
+INPUTS:
+- Test plan: "${session.outputs.testPlan}"
+- Test cases dir: "${session.outputs.testCasesDir}"
+- Specs dir: "${session.outputs.specsDir}"
+- Playwright config: "${session.outputs.playwrightConfig}"
+- Snapshots (ground truth for selector validation):
+${snapshotList}
+
+OUTPUT: "${session.outputs.reviewReport}"
+
+## Process
+
+### Step 1 — Read all files
+Use Read and Glob tools to read:
+1. "${session.outputs.testPlan}"
+2. All files in "${session.outputs.testCasesDir}/*.md"
+3. All files in "${session.outputs.specsDir}/*.spec.ts"
+4. "${session.outputs.playwrightConfig}"
+5. Every snapshot file listed above
+
+### Step 2 — Validate selectors against snapshots (KEY FEATURE)
+For every selector used in spec files:
+- Find the corresponding snapshot file for that module
+- Check the selector exists in the accessibility tree
+- Flag any selector that does NOT appear in the snapshot as a 🔴 Critical Issue
+
+Example check:
+- Spec uses: page.getByRole("button", { name: "Add to Cart" })
+- Snapshot shows: role=button name="Add to Basket"
+- → Flag as CRITICAL: selector mismatch
+
+### Step 3 — Review test cases
+For each test-cases/<module>.md:
+- ✅ All test types present? (smoke/regression/negative/edge)
+- ✅ TC IDs unique and correctly formatted?
+- ✅ Steps clear and specific?
+- ✅ Expected results measurable?
+- ✅ Coverage complete vs test plan feature areas?
+- ❌ Missing negative/edge cases?
+- ❌ Vague steps or expected results?
+
+### Step 4 — Review spec files
+For each tests/<module>.spec.ts:
+- ✅ Selectors validated against snapshots?
+- ✅ Describe blocks by test type?
+- ✅ TC IDs in test names?
+- ✅ Tests independent?
+- ✅ BASE_URL from env var?
+- ✅ Meaningful assertions?
+- ❌ Brittle selectors?
+- ❌ Missing assertions?
+- ❌ Hardcoded credentials or URLs?
+
+### Step 5 — Check traceability
+Every TC ID in .md files → must have matching test in .spec.ts
+Every feature in test_plan.md → must have test cases
+
+### Step 6 — Write "${session.outputs.reviewReport}"
+
+\`\`\`markdown
+# QA Review Report
+Date: <today>
+Status: PASSED / PASSED WITH WARNINGS / NEEDS REVISION
+
+## Executive Summary
+## Selector Validation Results (vs snapshots)
+| Selector | Spec File | Found in Snapshot | Status |
+|---|---|---|---|
+
+## Coverage Summary
+| Module | Test Cases | Spec Tests | Traceability | Status |
+
+## Issues Found
+### 🔴 Critical (selector mismatches, missing tests)
+### 🟡 Warnings (weak assertions, style issues)
+### 🟢 Suggestions
+
+## Module Reviews
+(per module: test case quality + spec quality)
+
+## Traceability Matrix
+## Recommendations
+## Sign-off checklist
+\`\`\`
+
+## Quality standards
+- Selector validation against snapshots is MANDATORY — this is the key value of this reviewer
+- Be specific — reference actual file names, TC IDs, line content
+- Every critical issue must have a recommended fix`;
+}
+//# sourceMappingURL=qa-reviewer.js.map

package/dist/subagents/qa-reviewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-reviewer.js","sourceRoot":"","sources":["../../src/subagents/qa-reviewer.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;SACxC,IAAI,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC;IAE5C,OAAO;;;gBAGO,OAAO,CAAC,OAAO,CAAC,QAAQ;qBACnB,OAAO,CAAC,OAAO,CAAC,YAAY;gBACjC,OAAO,CAAC,OAAO,CAAC,QAAQ;wBAChB,OAAO,CAAC,OAAO,CAAC,gBAAgB;;EAEtD,YAAY;;WAEH,OAAO,CAAC,OAAO,CAAC,YAAY;;;;;;MAMjC,OAAO,CAAC,OAAO,CAAC,QAAQ;mBACX,OAAO,CAAC,OAAO,CAAC,YAAY;mBAC5B,OAAO,CAAC,OAAO,CAAC,QAAQ;MACrC,OAAO,CAAC,OAAO,CAAC,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAwChB,OAAO,CAAC,OAAO,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDA+BC,CAAC;AACpD,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@agents-forge/aiqa",
+  "version": "1.0.0",
+  "description": "AI Assisted Quality Engineering — single unified agent with playwright-cli snapshot-aware testing. analyst → qa-planner → qa-engineer → qa-reviewer → qa-reporter",
+  "keywords": [
+    "ai",
+    "agent",
+    "qa",
+    "playwright",
+    "playwright-cli",
+    "quality-engineering",
+    "test-automation",
+    "claude",
+    "anthropic",
+    "agents-forge",
+    "aiqa"
+  ],
+  "author": "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": {
+    "aiqa": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "CLAUDE.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "npx tsx src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "latest",
+    "jiti": "^2.7.0"
+  },
+  "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
+    }
+  }
+}