feat: add REPORT=1 flag to dev-e2e for post-run HTML report

Opens the Playwright HTML report in a browser after tests finish,
showing screenshots, traces, and step-by-step test execution for
visual verification of tested workflows.

Usage: make dev-e2e FILE=navigation REPORT=1

Author: wrn14897

AGENTS.md

@@ -117,6 +117,7 @@ make e2e
 make dev-e2e FILE=navigation
 make dev-e2e FILE=navigation GREP="help menu"
 make dev-e2e GREP="should navigate"
+make dev-e2e FILE=navigation REPORT=1   # Open HTML report after run
 
 # Or call the script directly for more control:
 ./scripts/test-e2e.sh                                       # All E2E (full-stack)

Makefile

@@ -112,15 +112,19 @@ e2e:
 	@echo "Using E2E slot $(HDX_E2E_SLOT) (ch=$(HDX_E2E_CH_PORT) mongo=$(HDX_E2E_MONGO_PORT) api=$(HDX_E2E_API_PORT) app=$(HDX_E2E_APP_PORT))"
 	./scripts/test-e2e.sh
 
-# Run a specific E2E test file or grep pattern (dev mode: containers kept running)
+# Run a specific E2E test file or grep pattern (dev mode: hot reload)
 # Usage:
 #   make dev-e2e FILE=navigation                    # Run tests/e2e/**/navigation*.spec.ts
 #   make dev-e2e FILE=navigation GREP="help menu"   # Run matching tests within that file
 #   make dev-e2e GREP="should navigate"             # Run matching tests across all files
+#   make dev-e2e FILE=navigation REPORT=1           # Open HTML report after tests finish
 .PHONY: dev-e2e
 dev-e2e:
 	@echo "Using E2E slot $(HDX_E2E_SLOT) (ch=$(HDX_E2E_CH_PORT) mongo=$(HDX_E2E_MONGO_PORT) api=$(HDX_E2E_API_PORT) app=$(HDX_E2E_APP_PORT))"
-	./scripts/test-e2e.sh --dev $(if $(FILE),tests/e2e/**/$(FILE)*.spec.ts) $(if $(GREP),--grep "$(GREP)") $(ARGS)
+	./scripts/test-e2e.sh --dev $(if $(FILE),tests/e2e/**/$(FILE)*.spec.ts) $(if $(GREP),--grep "$(GREP)") $(ARGS); \
+	ret=$$?; \
+	$(if $(REPORT),cd packages/app && npx playwright show-report;) \
+	exit $$ret
 
 
 

agent_docs/development.md

@@ -105,6 +105,9 @@ make dev-e2e FILE=navigation GREP="help menu"
 # Grep across all files
 make dev-e2e GREP="should navigate"
 
+# Open HTML report after tests finish (screenshots, traces, step-by-step)
+make dev-e2e FILE=navigation REPORT=1
+
 # Or call the script directly for more control
 ./scripts/test-e2e.sh --ui --last-failed