e2e

E2E Testing — Playwright + AC Traceability

Generate Playwright E2E tests from spec.md acceptance criteria, run them, and produce a structured report that maps pass/fail results to AC-IDs. The report is evidence for whatever closure step you run.

Modes

Flag	Action
--generate <id>	Read spec.md → create one .spec.ts per US with one test() per AC
--run <id>	Execute npx playwright test → parse results → write e2e-report.json
--a11y <id>	Like --run but also scans each page with @axe-core/playwright

Combine --run + --a11y to get both functional and accessibility results. --generate ignores --a11y (warn if combined).

---

Step 1: Parse Arguments

Extract mode and increment ID from $ARGUMENTS:

# Parse: --generate 0042 | --run 0042 | --a11y 0042 | --run --a11y 0042
MODE="run"       # default
A11Y=false
INCREMENT_ID=""

for arg in $ARGUMENTS; do
  case "$arg" in
    --generate) MODE="generate" ;;
    --run)      MODE="run" ;;
    --a11y)     A11Y=true ;;
    *)          INCREMENT_ID="$arg" ;;
  esac
done

If no increment ID provided, check for an active increment:

ACTIVE=$(find .specweave/increments -maxdepth 2 -name "metadata.json" -exec grep -l '"active"' {} \; 2>/dev/null | head -1)

If still no ID → STOP: "No increment ID provided and no active increment found."

Resolve increment path: .specweave/increments/<id>/

Step 2: Environment Validation — Playwright Detection

MANDATORY before any operation. Detect Playwright installation:

# 1. Find playwright.config
PW_CONFIG=$(find . repositories -maxdepth 4 -name "playwright.config.ts" -o -name "playwright.config.js" 2>/dev/null | head -1)

# 2. Check for @playwright/test in package.json
PW_PACKAGE=$(grep -r '"@playwright/test"' package.json packages/*/package.json repositories/*/*/package.json 2>/dev/null | head -1)

Decision matrix:

Config	Package	Action
Found	Found	Proceed — use config path
Missing	Found	FAIL: "Playwright installed but no config found. Run npx playwright init to create playwright.config.ts"
Missing	Missing	FAIL: "Playwright not installed. Run npm init playwright@latest to set up E2E testing"
Found	Missing	Proceed with warning: "Playwright config found but package not in package.json (global install?)"