@teevee98/synapse-hub 0.0.0-stage → 3.8.3
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.
- package/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +171 -0
- package/README.md +170 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +198 -0
- package/docs/ARCHITECTURE.md +199 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +174 -0
- package/docs/CLI_REFERENCE.md +176 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +118 -0
- package/docs/QUALITY_GATES.md +118 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1358 -0
- package/docs/schemas/synapse.config.schema.json +86 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +31 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2074 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +262 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +190 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2403 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +306 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +725 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1271 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- package/tools/welcome_page.py +290 -0
|
@@ -0,0 +1,522 @@
|
|
|
1
|
+
# E2E Testing Patterns Implementation Playbook
|
|
2
|
+
|
|
3
|
+
This file contains detailed patterns, checklists, and code samples referenced by the skill.
|
|
4
|
+
|
|
5
|
+
## Core Concepts
|
|
6
|
+
|
|
7
|
+
### 1. E2E Testing Fundamentals
|
|
8
|
+
|
|
9
|
+
**What to Test with E2E:**
|
|
10
|
+
- Critical user journeys (login, checkout, signup)
|
|
11
|
+
- Complex interactions (drag-and-drop, multi-step forms)
|
|
12
|
+
- Cross-browser compatibility
|
|
13
|
+
- Real API integration
|
|
14
|
+
- Authentication flows
|
|
15
|
+
|
|
16
|
+
**What NOT to Test with E2E:**
|
|
17
|
+
- Unit-level logic (use unit tests)
|
|
18
|
+
- API contracts (use integration tests)
|
|
19
|
+
- Edge cases (too slow)
|
|
20
|
+
- Internal implementation details
|
|
21
|
+
|
|
22
|
+
### 2. Test Philosophy
|
|
23
|
+
|
|
24
|
+
**The Testing Pyramid:**
|
|
25
|
+
```
|
|
26
|
+
/\
|
|
27
|
+
/E2E\ ← Few, focused on critical paths
|
|
28
|
+
/─────\
|
|
29
|
+
/Integr\ ← More, test component interactions
|
|
30
|
+
/────────\
|
|
31
|
+
/Unit Tests\ ← Many, fast, isolated
|
|
32
|
+
/────────────\
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
**Best Practices:**
|
|
36
|
+
- Test user behavior, not implementation
|
|
37
|
+
- Keep tests independent
|
|
38
|
+
- Make tests deterministic
|
|
39
|
+
- Optimize for speed
|
|
40
|
+
- Use data-testid, not CSS selectors
|
|
41
|
+
|
|
42
|
+
## Playwright Patterns
|
|
43
|
+
|
|
44
|
+
### Setup and Configuration
|
|
45
|
+
|
|
46
|
+
```typescript
|
|
47
|
+
// playwright.config.ts
|
|
48
|
+
import { defineConfig, devices } from '@playwright/test';
|
|
49
|
+
|
|
50
|
+
export default defineConfig({
|
|
51
|
+
testDir: './e2e',
|
|
52
|
+
timeout: 30000,
|
|
53
|
+
expect: {
|
|
54
|
+
timeout: 5000,
|
|
55
|
+
},
|
|
56
|
+
fullyParallel: true,
|
|
57
|
+
forbidOnly: !!process.env.CI,
|
|
58
|
+
retries: process.env.CI ? 2 : 0,
|
|
59
|
+
workers: process.env.CI ? 1 : undefined,
|
|
60
|
+
reporter: [
|
|
61
|
+
['html'],
|
|
62
|
+
['junit', { outputFile: 'results.xml' }],
|
|
63
|
+
],
|
|
64
|
+
use: {
|
|
65
|
+
baseURL: 'http://localhost:3000',
|
|
66
|
+
trace: 'on-first-retry',
|
|
67
|
+
screenshot: 'only-on-failure',
|
|
68
|
+
video: 'retain-on-failure',
|
|
69
|
+
},
|
|
70
|
+
projects: [
|
|
71
|
+
{ name: 'chromium', use: { ...devices['Desktop Chrome'] } },
|
|
72
|
+
{ name: 'firefox', use: { ...devices['Desktop Firefox'] } },
|
|
73
|
+
{ name: 'webkit', use: { ...devices['Desktop Safari'] } },
|
|
74
|
+
{ name: 'mobile', use: { ...devices['iPhone 13'] } },
|
|
75
|
+
],
|
|
76
|
+
});
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### Pattern 1: Page Object Model
|
|
80
|
+
|
|
81
|
+
```typescript
|
|
82
|
+
// pages/LoginPage.ts
|
|
83
|
+
import { Page, Locator } from '@playwright/test';
|
|
84
|
+
|
|
85
|
+
export class LoginPage {
|
|
86
|
+
readonly page: Page;
|
|
87
|
+
readonly emailInput: Locator;
|
|
88
|
+
readonly passwordInput: Locator;
|
|
89
|
+
readonly loginButton: Locator;
|
|
90
|
+
readonly errorMessage: Locator;
|
|
91
|
+
|
|
92
|
+
constructor(page: Page) {
|
|
93
|
+
this.page = page;
|
|
94
|
+
this.emailInput = page.getByLabel('Email');
|
|
95
|
+
this.passwordInput = page.getByLabel('Password');
|
|
96
|
+
this.loginButton = page.getByRole('button', { name: 'Login' });
|
|
97
|
+
this.errorMessage = page.getByRole('alert');
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
async goto() {
|
|
101
|
+
await this.page.goto('/login');
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
async login(email: string, password: string) {
|
|
105
|
+
await this.emailInput.fill(email);
|
|
106
|
+
await this.passwordInput.fill(password);
|
|
107
|
+
await this.loginButton.click();
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
async getErrorMessage(): Promise<string> {
|
|
111
|
+
return await this.errorMessage.textContent() ?? '';
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
// Test using Page Object
|
|
116
|
+
import { test, expect } from '@playwright/test';
|
|
117
|
+
import { LoginPage } from './pages/LoginPage';
|
|
118
|
+
|
|
119
|
+
test('successful login', async ({ page }) => {
|
|
120
|
+
const loginPage = new LoginPage(page);
|
|
121
|
+
await loginPage.goto();
|
|
122
|
+
await loginPage.login('user@example.com', process.env.TEST_PASSWORD || 'SecretAuth123!');
|
|
123
|
+
|
|
124
|
+
await expect(page).toHaveURL('/dashboard');
|
|
125
|
+
await expect(page.getByRole('heading', { name: 'Dashboard' }))
|
|
126
|
+
.toBeVisible();
|
|
127
|
+
});
|
|
128
|
+
|
|
129
|
+
test('failed login shows error', async ({ page }) => {
|
|
130
|
+
const loginPage = new LoginPage(page);
|
|
131
|
+
await loginPage.goto();
|
|
132
|
+
await loginPage.login('invalid@example.com', 'wrong');
|
|
133
|
+
|
|
134
|
+
const error = await loginPage.getErrorMessage();
|
|
135
|
+
expect(error).toContain('Invalid credentials');
|
|
136
|
+
});
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### Pattern 2: Fixtures for Test Data
|
|
140
|
+
|
|
141
|
+
```typescript
|
|
142
|
+
// fixtures/test-data.ts
|
|
143
|
+
import { test as base } from '@playwright/test';
|
|
144
|
+
|
|
145
|
+
type TestData = {
|
|
146
|
+
testUser: {
|
|
147
|
+
email: string;
|
|
148
|
+
password: string;
|
|
149
|
+
name: string;
|
|
150
|
+
};
|
|
151
|
+
adminUser: {
|
|
152
|
+
email: string;
|
|
153
|
+
password: string;
|
|
154
|
+
};
|
|
155
|
+
};
|
|
156
|
+
|
|
157
|
+
export const test = base.extend<TestData>({
|
|
158
|
+
testUser: async ({}, use) => {
|
|
159
|
+
const user = {
|
|
160
|
+
email: `test-${Date.now()}@example.com`,
|
|
161
|
+
password: process.env.TEST_USER_PASSWORD || 'DynamicTestPwd!123',
|
|
162
|
+
name: 'Test User',
|
|
163
|
+
};
|
|
164
|
+
// Setup: Create user in database
|
|
165
|
+
await createTestUser(user);
|
|
166
|
+
await use(user);
|
|
167
|
+
// Teardown: Clean up user
|
|
168
|
+
await deleteTestUser(user.email);
|
|
169
|
+
},
|
|
170
|
+
|
|
171
|
+
adminUser: async ({}, use) => {
|
|
172
|
+
await use({
|
|
173
|
+
email: 'admin@example.com',
|
|
174
|
+
password: process.env.ADMIN_PASSWORD!,
|
|
175
|
+
});
|
|
176
|
+
},
|
|
177
|
+
});
|
|
178
|
+
|
|
179
|
+
// Usage in tests
|
|
180
|
+
import { test } from './fixtures/test-data';
|
|
181
|
+
|
|
182
|
+
test('user can update profile', async ({ page, testUser }) => {
|
|
183
|
+
await page.goto('/login');
|
|
184
|
+
await page.getByLabel('Email').fill(testUser.email);
|
|
185
|
+
await page.getByLabel('Password').fill(testUser.password);
|
|
186
|
+
await page.getByRole('button', { name: 'Login' }).click();
|
|
187
|
+
|
|
188
|
+
await page.goto('/profile');
|
|
189
|
+
await page.getByLabel('Name').fill('Updated Name');
|
|
190
|
+
await page.getByRole('button', { name: 'Save' }).click();
|
|
191
|
+
|
|
192
|
+
await expect(page.getByText('Profile updated')).toBeVisible();
|
|
193
|
+
});
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
### Pattern 3: Waiting Strategies
|
|
197
|
+
|
|
198
|
+
```typescript
|
|
199
|
+
// ❌ Bad: Fixed timeouts
|
|
200
|
+
await page.waitForTimeout(3000); // Flaky!
|
|
201
|
+
|
|
202
|
+
// ✅ Good: Wait for specific conditions
|
|
203
|
+
await page.waitForLoadState('networkidle');
|
|
204
|
+
await page.waitForURL('/dashboard');
|
|
205
|
+
await page.waitForSelector('[data-testid="user-profile"]');
|
|
206
|
+
|
|
207
|
+
// ✅ Better: Auto-waiting with assertions
|
|
208
|
+
await expect(page.getByText('Welcome')).toBeVisible();
|
|
209
|
+
await expect(page.getByRole('button', { name: 'Submit' }))
|
|
210
|
+
.toBeEnabled();
|
|
211
|
+
|
|
212
|
+
// Wait for API response
|
|
213
|
+
const responsePromise = page.waitForResponse(
|
|
214
|
+
response => response.url().includes('/api/users') && response.status() === 200
|
|
215
|
+
);
|
|
216
|
+
await page.getByRole('button', { name: 'Load Users' }).click();
|
|
217
|
+
const response = await responsePromise;
|
|
218
|
+
const data = await response.json();
|
|
219
|
+
expect(data.users).toHaveLength(10);
|
|
220
|
+
|
|
221
|
+
// Wait for multiple conditions
|
|
222
|
+
await Promise.all([
|
|
223
|
+
page.waitForURL('/success'),
|
|
224
|
+
page.waitForLoadState('networkidle'),
|
|
225
|
+
expect(page.getByText('Payment successful')).toBeVisible(),
|
|
226
|
+
]);
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
### Pattern 4: Network Mocking and Interception
|
|
230
|
+
|
|
231
|
+
```typescript
|
|
232
|
+
// Mock API responses
|
|
233
|
+
test('displays error when API fails', async ({ page }) => {
|
|
234
|
+
await page.route('**/api/users', route => {
|
|
235
|
+
route.fulfill({
|
|
236
|
+
status: 500,
|
|
237
|
+
contentType: 'application/json',
|
|
238
|
+
body: JSON.stringify({ error: 'Internal Server Error' }),
|
|
239
|
+
});
|
|
240
|
+
});
|
|
241
|
+
|
|
242
|
+
await page.goto('/users');
|
|
243
|
+
await expect(page.getByText('Failed to load users')).toBeVisible();
|
|
244
|
+
});
|
|
245
|
+
|
|
246
|
+
// Intercept and modify requests
|
|
247
|
+
test('can modify API request', async ({ page }) => {
|
|
248
|
+
await page.route('**/api/users', async route => {
|
|
249
|
+
const request = route.request();
|
|
250
|
+
const postData = JSON.parse(request.postData() || '{}');
|
|
251
|
+
|
|
252
|
+
// Modify request
|
|
253
|
+
postData.role = 'admin';
|
|
254
|
+
|
|
255
|
+
await route.continue({
|
|
256
|
+
postData: JSON.stringify(postData),
|
|
257
|
+
});
|
|
258
|
+
});
|
|
259
|
+
|
|
260
|
+
// Test continues...
|
|
261
|
+
});
|
|
262
|
+
|
|
263
|
+
// Mock third-party services
|
|
264
|
+
test('payment flow with mocked Stripe', async ({ page }) => {
|
|
265
|
+
await page.route('**/api/stripe/**', route => {
|
|
266
|
+
route.fulfill({
|
|
267
|
+
status: 200,
|
|
268
|
+
body: JSON.stringify({
|
|
269
|
+
id: 'mock_payment_id',
|
|
270
|
+
status: 'succeeded',
|
|
271
|
+
}),
|
|
272
|
+
});
|
|
273
|
+
});
|
|
274
|
+
|
|
275
|
+
// Test payment flow with mocked response
|
|
276
|
+
});
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
## Cypress Patterns
|
|
280
|
+
|
|
281
|
+
### Setup and Configuration
|
|
282
|
+
|
|
283
|
+
```typescript
|
|
284
|
+
// cypress.config.ts
|
|
285
|
+
import { defineConfig } from 'cypress';
|
|
286
|
+
|
|
287
|
+
export default defineConfig({
|
|
288
|
+
e2e: {
|
|
289
|
+
baseUrl: 'http://localhost:3000',
|
|
290
|
+
viewportWidth: 1280,
|
|
291
|
+
viewportHeight: 720,
|
|
292
|
+
video: false,
|
|
293
|
+
screenshotOnRunFailure: true,
|
|
294
|
+
defaultCommandTimeout: 10000,
|
|
295
|
+
requestTimeout: 10000,
|
|
296
|
+
setupNodeEvents(on, config) {
|
|
297
|
+
// Implement node event listeners
|
|
298
|
+
},
|
|
299
|
+
},
|
|
300
|
+
});
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
### Pattern 1: Custom Commands
|
|
304
|
+
|
|
305
|
+
```typescript
|
|
306
|
+
// cypress/support/commands.ts
|
|
307
|
+
declare global {
|
|
308
|
+
namespace Cypress {
|
|
309
|
+
interface Chainable {
|
|
310
|
+
login(email: string, password: string): Chainable<void>;
|
|
311
|
+
createUser(userData: UserData): Chainable<User>;
|
|
312
|
+
dataCy(value: string): Chainable<JQuery<HTMLElement>>;
|
|
313
|
+
}
|
|
314
|
+
}
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
Cypress.Commands.add('login', (email: string, password: string) => {
|
|
318
|
+
cy.visit('/login');
|
|
319
|
+
cy.get('[data-testid="email"]').type(email);
|
|
320
|
+
cy.get('[data-testid="password"]').type(password);
|
|
321
|
+
cy.get('[data-testid="login-button"]').click();
|
|
322
|
+
cy.url().should('include', '/dashboard');
|
|
323
|
+
});
|
|
324
|
+
|
|
325
|
+
Cypress.Commands.add('createUser', (userData: UserData) => {
|
|
326
|
+
return cy.request('POST', '/api/users', userData)
|
|
327
|
+
.its('body');
|
|
328
|
+
});
|
|
329
|
+
|
|
330
|
+
Cypress.Commands.add('dataCy', (value: string) => {
|
|
331
|
+
return cy.get(`[data-cy="${value}"]`);
|
|
332
|
+
});
|
|
333
|
+
|
|
334
|
+
// Usage
|
|
335
|
+
cy.login('user@example.com', 'password');
|
|
336
|
+
cy.dataCy('submit-button').click();
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
### Pattern 2: Cypress Intercept
|
|
340
|
+
|
|
341
|
+
```typescript
|
|
342
|
+
// Mock API calls
|
|
343
|
+
cy.intercept('GET', '/api/users', {
|
|
344
|
+
statusCode: 200,
|
|
345
|
+
body: [
|
|
346
|
+
{ id: 1, name: 'John' },
|
|
347
|
+
{ id: 2, name: 'Jane' },
|
|
348
|
+
],
|
|
349
|
+
}).as('getUsers');
|
|
350
|
+
|
|
351
|
+
cy.visit('/users');
|
|
352
|
+
cy.wait('@getUsers');
|
|
353
|
+
cy.get('[data-testid="user-list"]').children().should('have.length', 2);
|
|
354
|
+
|
|
355
|
+
// Modify responses
|
|
356
|
+
cy.intercept('GET', '/api/users', (req) => {
|
|
357
|
+
req.reply((res) => {
|
|
358
|
+
// Modify response
|
|
359
|
+
res.body.users = res.body.users.slice(0, 5);
|
|
360
|
+
res.send();
|
|
361
|
+
});
|
|
362
|
+
});
|
|
363
|
+
|
|
364
|
+
// Simulate slow network
|
|
365
|
+
cy.intercept('GET', '/api/data', (req) => {
|
|
366
|
+
req.reply((res) => {
|
|
367
|
+
res.delay(3000); // 3 second delay
|
|
368
|
+
res.send();
|
|
369
|
+
});
|
|
370
|
+
});
|
|
371
|
+
```
|
|
372
|
+
|
|
373
|
+
## Advanced Patterns
|
|
374
|
+
|
|
375
|
+
### Pattern 1: Visual Regression Testing
|
|
376
|
+
|
|
377
|
+
```typescript
|
|
378
|
+
// With Playwright
|
|
379
|
+
import { test, expect } from '@playwright/test';
|
|
380
|
+
|
|
381
|
+
test('homepage looks correct', async ({ page }) => {
|
|
382
|
+
await page.goto('/');
|
|
383
|
+
await expect(page).toHaveScreenshot('homepage.png', {
|
|
384
|
+
fullPage: true,
|
|
385
|
+
maxDiffPixels: 100,
|
|
386
|
+
});
|
|
387
|
+
});
|
|
388
|
+
|
|
389
|
+
test('button in all states', async ({ page }) => {
|
|
390
|
+
await page.goto('/components');
|
|
391
|
+
|
|
392
|
+
const button = page.getByRole('button', { name: 'Submit' });
|
|
393
|
+
|
|
394
|
+
// Default state
|
|
395
|
+
await expect(button).toHaveScreenshot('button-default.png');
|
|
396
|
+
|
|
397
|
+
// Hover state
|
|
398
|
+
await button.hover();
|
|
399
|
+
await expect(button).toHaveScreenshot('button-hover.png');
|
|
400
|
+
|
|
401
|
+
// Disabled state
|
|
402
|
+
await button.evaluate(el => el.setAttribute('disabled', 'true'));
|
|
403
|
+
await expect(button).toHaveScreenshot('button-disabled.png');
|
|
404
|
+
});
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
### Pattern 2: Parallel Testing with Sharding
|
|
408
|
+
|
|
409
|
+
```typescript
|
|
410
|
+
// playwright.config.ts
|
|
411
|
+
export default defineConfig({
|
|
412
|
+
projects: [
|
|
413
|
+
{
|
|
414
|
+
name: 'shard-1',
|
|
415
|
+
use: { ...devices['Desktop Chrome'] },
|
|
416
|
+
grepInvert: /@slow/,
|
|
417
|
+
shard: { current: 1, total: 4 },
|
|
418
|
+
},
|
|
419
|
+
{
|
|
420
|
+
name: 'shard-2',
|
|
421
|
+
use: { ...devices['Desktop Chrome'] },
|
|
422
|
+
shard: { current: 2, total: 4 },
|
|
423
|
+
},
|
|
424
|
+
// ... more shards
|
|
425
|
+
],
|
|
426
|
+
});
|
|
427
|
+
|
|
428
|
+
// Run in CI
|
|
429
|
+
// npx playwright test --shard=1/4
|
|
430
|
+
// npx playwright test --shard=2/4
|
|
431
|
+
```
|
|
432
|
+
|
|
433
|
+
### Pattern 3: Accessibility Testing
|
|
434
|
+
|
|
435
|
+
```typescript
|
|
436
|
+
// Install: npm install @axe-core/playwright
|
|
437
|
+
import { test, expect } from '@playwright/test';
|
|
438
|
+
import AxeBuilder from '@axe-core/playwright';
|
|
439
|
+
|
|
440
|
+
test('page should not have accessibility violations', async ({ page }) => {
|
|
441
|
+
await page.goto('/');
|
|
442
|
+
|
|
443
|
+
const accessibilityScanResults = await new AxeBuilder({ page })
|
|
444
|
+
.exclude('#third-party-widget')
|
|
445
|
+
.analyze();
|
|
446
|
+
|
|
447
|
+
expect(accessibilityScanResults.violations).toEqual([]);
|
|
448
|
+
});
|
|
449
|
+
|
|
450
|
+
test('form is accessible', async ({ page }) => {
|
|
451
|
+
await page.goto('/signup');
|
|
452
|
+
|
|
453
|
+
const results = await new AxeBuilder({ page })
|
|
454
|
+
.include('form')
|
|
455
|
+
.analyze();
|
|
456
|
+
|
|
457
|
+
expect(results.violations).toEqual([]);
|
|
458
|
+
});
|
|
459
|
+
```
|
|
460
|
+
|
|
461
|
+
## Best Practices
|
|
462
|
+
|
|
463
|
+
1. **Use Data Attributes**: `data-testid` or `data-cy` for stable selectors
|
|
464
|
+
2. **Avoid Brittle Selectors**: Don't rely on CSS classes or DOM structure
|
|
465
|
+
3. **Test User Behavior**: Click, type, see - not implementation details
|
|
466
|
+
4. **Keep Tests Independent**: Each test should run in isolation
|
|
467
|
+
5. **Clean Up Test Data**: Create and destroy test data in each test
|
|
468
|
+
6. **Use Page Objects**: Encapsulate page logic
|
|
469
|
+
7. **Meaningful Assertions**: Check actual user-visible behavior
|
|
470
|
+
8. **Optimize for Speed**: Mock when possible, parallel execution
|
|
471
|
+
|
|
472
|
+
```typescript
|
|
473
|
+
// ❌ Bad selectors
|
|
474
|
+
cy.get('.btn.btn-primary.submit-button').click();
|
|
475
|
+
cy.get('div > form > div:nth-child(2) > input').type('text');
|
|
476
|
+
|
|
477
|
+
// ✅ Good selectors
|
|
478
|
+
cy.getByRole('button', { name: 'Submit' }).click();
|
|
479
|
+
cy.getByLabel('Email address').type('user@example.com');
|
|
480
|
+
cy.get('[data-testid="email-input"]').type('user@example.com');
|
|
481
|
+
```
|
|
482
|
+
|
|
483
|
+
## Common Pitfalls
|
|
484
|
+
|
|
485
|
+
- **Flaky Tests**: Use proper waits, not fixed timeouts
|
|
486
|
+
- **Slow Tests**: Mock external APIs, use parallel execution
|
|
487
|
+
- **Over-Testing**: Don't test every edge case with E2E
|
|
488
|
+
- **Coupled Tests**: Tests should not depend on each other
|
|
489
|
+
- **Poor Selectors**: Avoid CSS classes and nth-child
|
|
490
|
+
- **No Cleanup**: Clean up test data after each test
|
|
491
|
+
- **Testing Implementation**: Test user behavior, not internals
|
|
492
|
+
|
|
493
|
+
## Debugging Failing Tests
|
|
494
|
+
|
|
495
|
+
```typescript
|
|
496
|
+
// Playwright debugging
|
|
497
|
+
// 1. Run in headed mode
|
|
498
|
+
npx playwright test --headed
|
|
499
|
+
|
|
500
|
+
// 2. Run in debug mode
|
|
501
|
+
npx playwright test --debug
|
|
502
|
+
|
|
503
|
+
// 3. Use trace viewer
|
|
504
|
+
await page.screenshot({ path: 'screenshot.png' });
|
|
505
|
+
await page.video()?.saveAs('video.webm');
|
|
506
|
+
|
|
507
|
+
// 4. Add test.step for better reporting
|
|
508
|
+
test('checkout flow', async ({ page }) => {
|
|
509
|
+
await test.step('Add item to cart', async () => {
|
|
510
|
+
await page.goto('/products');
|
|
511
|
+
await page.getByRole('button', { name: 'Add to Cart' }).click();
|
|
512
|
+
});
|
|
513
|
+
|
|
514
|
+
await test.step('Proceed to checkout', async () => {
|
|
515
|
+
await page.goto('/cart');
|
|
516
|
+
await page.getByRole('button', { name: 'Checkout' }).click();
|
|
517
|
+
});
|
|
518
|
+
});
|
|
519
|
+
|
|
520
|
+
// 5. Inspect page state
|
|
521
|
+
await page.pause(); // Pauses execution, opens inspector
|
|
522
|
+
```
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: event-stream-qa-orchestrator
|
|
3
|
+
description: "Immutable EventStream orchestrator recording deterministic action/observation timelines with SHA-256 hash chains and reversible checkpoint rollbacks. Use when tracing test executions and managing replayable state."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# QA Event Stream Orchestrator Skill — Immutable Audit & Replay Timeline
|
|
7
|
+
|
|
8
|
+
> **Paradigm Attribution:** Inspired by **All-Hands-AI OpenHands (EventStream & CodeAct Runtime)**.
|
|
9
|
+
> **Core Principle:** Treat automated testing sessions as an append-only, immutable stream of events. Prevent state corruption and lost context by chaining each event with cryptographic SHA-256 hashes and enabling deterministic check-pointed rollbacks.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. The EventStream Pipeline
|
|
14
|
+
|
|
15
|
+
```mermaid
|
|
16
|
+
flowchart LR
|
|
17
|
+
Init["init-stream<br/>Genesis Hash (000...0)"] --> Act["record-event<br/>ACTION_NAVIGATE / ACTION_CLICK"]
|
|
18
|
+
Act --> Obs["record-event<br/>OBSERVATION_DOM / ASSERTION"]
|
|
19
|
+
Obs --> Check["Checkpoint Anchor<br/>CHECKPOINT_PRE_SUBMIT"]
|
|
20
|
+
Check --> Verify["verify-stream<br/>Cryptographic Audit"]
|
|
21
|
+
Verify --> Rollback["rollback<br/>Rewind to Checkpoint"]
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
1. **Immutable Event Logging (`record-event`):**
|
|
25
|
+
- Each event records: `index`, `session_id`, `event_type`, `actor`, `payload`, `timestamp`, `prev_hash`, and `event_hash`.
|
|
26
|
+
- Continuous SHA-256 hash chaining prevents unobserved event injection or tampering.
|
|
27
|
+
|
|
28
|
+
2. **Reversible Checkpointing (`rollback`):**
|
|
29
|
+
- In conjunction with GoEx LIFO undo stack (`tools/reversible_sandbox.py`), enables restoring the browser or data state when an unexpected crash occurs.
|
|
30
|
+
- Appends a `ROLLBACK_EXECUTED` event to the stream without destroying the audit trail.
|
|
31
|
+
|
|
32
|
+
3. **Cryptographic Verification (`verify-stream`):**
|
|
33
|
+
- Verifies hash continuity from genesis to latest event.
|
|
34
|
+
- Ensures zero missing or out-of-order events before certifying run results.
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## 2. CLI Tool Usage
|
|
39
|
+
|
|
40
|
+
Autonomous commands via `tools/qa_event_stream.py`:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
# 1. Initialize stream
|
|
44
|
+
python tools/qa_event_stream.py init-stream \
|
|
45
|
+
--session-id "CHECKOUT_E2E_001" \
|
|
46
|
+
--out-file .agent_memory/timeline.jsonl
|
|
47
|
+
|
|
48
|
+
# 2. Record an action event
|
|
49
|
+
python tools/qa_event_stream.py record-event \
|
|
50
|
+
--stream .agent_memory/timeline.jsonl \
|
|
51
|
+
--event-type ACTION_CLICK \
|
|
52
|
+
--actor live-explorer \
|
|
53
|
+
--payload '{"page":"CartPage","element":"checkout_button"}'
|
|
54
|
+
|
|
55
|
+
# 3. Create a state checkpoint
|
|
56
|
+
python tools/qa_event_stream.py record-event \
|
|
57
|
+
--stream .agent_memory/timeline.jsonl \
|
|
58
|
+
--event-type CHECKPOINT \
|
|
59
|
+
--actor test-runner \
|
|
60
|
+
--payload '{"cart_total": 99.99}' \
|
|
61
|
+
--checkpoint-id "PRE_CHECKOUT_FORM"
|
|
62
|
+
|
|
63
|
+
# 4. Verify stream integrity
|
|
64
|
+
python tools/qa_event_stream.py verify-stream \
|
|
65
|
+
--stream .agent_memory/timeline.jsonl
|
|
66
|
+
|
|
67
|
+
# 5. Rollback to checkpoint on test failure
|
|
68
|
+
python tools/qa_event_stream.py rollback \
|
|
69
|
+
--stream .agent_memory/timeline.jsonl \
|
|
70
|
+
--to-checkpoint "PRE_CHECKOUT_FORM"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## 3. Strict Operating Invariants
|
|
76
|
+
|
|
77
|
+
- **Hash Chain Integrity:** All events must compute `SHA-256(prev_hash | session_id | event_type | actor | payload | timestamp)`.
|
|
78
|
+
- **Zero Log Tampering:** Never edit `timeline.jsonl` lines manually; always append via the CLI tool.
|
|
79
|
+
- **UTF-8 No BOM:** Timeline files must remain clean UTF-8 without byte-order marks.
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
{"index": 0, "session_id": "SESSION_DEMO_001", "event_type": "STREAM_INIT", "actor": "system", "payload": {"initialized_at": "2026-11-04T12:00:00Z"}, "timestamp": "2026-11-04T12:00:00Z", "prev_hash": "0000000000000000000000000000000000000000000000000000000000000000", "event_hash": "1a2b3c4d5e6f"}
|
|
2
|
+
{"index": 1, "session_id": "SESSION_DEMO_001", "event_type": "ACTION_NAVIGATE", "actor": "live-explorer", "payload": {"url": "https://app.local/login"}, "timestamp": "2026-11-04T12:00:01Z", "prev_hash": "1a2b3c4d5e6f", "event_hash": "2b3c4d5e6f7a"}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: failure-autopsy-and-healing
|
|
3
|
+
description: "Triage test failures from JUnit XML/screenshots and heal broken Page Class locators. Use when diagnosing failed test runs and producing closed-loop healing plans."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Failure Autopsy & Auto-Healing (Diagnostic & Self-Healing Engine)
|
|
7
|
+
|
|
8
|
+
Specialized skill for diagnosing batch test execution failures across automated test cases, performing visual autopsies via `Screenshots/FAILED_*.png`, parsing `JUnit_Report.xml`, and healing Page Classes (`Keywords/<namespace>/pages/*.groovy` or `pages/*.ts`) in place.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. Five-Step Enterprise Autopsy Protocol
|
|
13
|
+
|
|
14
|
+
```mermaid
|
|
15
|
+
flowchart LR
|
|
16
|
+
A["1. Detect FAILED TC"] --> B["2. Inspect Screenshots/FAILED_*.png"]
|
|
17
|
+
B --> C["3. Parse JUnit_Report.xml"]
|
|
18
|
+
C --> D["4. Heal Page Class in-place"]
|
|
19
|
+
D --> E["5. Re-run suite: 100% PASS"]
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
1. **Zero-Token Triage:** Pinpoint failed line and cause instantly (<50 tokens):
|
|
23
|
+
```bash
|
|
24
|
+
python tools/pinpoint_failure.py
|
|
25
|
+
# or bash .agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh
|
|
26
|
+
```
|
|
27
|
+
2. **Visual Autopsy:** Inspect the latest error screenshot to immediately detect: disabled buttons, missing required fields, UI overlaps, or obscuring modal backdrops.
|
|
28
|
+
3. **XML Parsing:** Extract stacktrace and exception messages from `Reports/<Timestamp>/JUnit_Report.xml` or Playwright test results.
|
|
29
|
+
4. **In-Place Healing:** Update the corresponding Page Class in `Keywords/<project_namespace>/pages/` or `pages/`.
|
|
30
|
+
5. **Regression Guard:** Verify 100% UTF-8 No BOM and re-run the targeted suite to confirm 100% Pass.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 2. Dynamic Module & Page Class Mapping Architecture
|
|
35
|
+
|
|
36
|
+
| Functional Module Category | Target Page Class to Heal | Common Failure Vector | Recommended Auto-Heal Strategy |
|
|
37
|
+
| :--- | :--- | :--- | :--- |
|
|
38
|
+
| **Authentication & Session** | `LoginPage` | Stale session, cookie expiration | Switch to zero-second storage state / token injection |
|
|
39
|
+
| **System Admin & RBAC** | `UserAdminPage` | Role permission dialog overlay | Smart wait for dialog animation + backdrop dismissal |
|
|
40
|
+
| **Master Data & Catalogs** | `CategoryPage` | Table virtualization lazy-load | Scroll into view + waitForLoadState('networkidle') |
|
|
41
|
+
| **Workflows & Approvals** | `PlanningPage` | Button disabled state / slow API | Await formControl valid state before trigger click |
|
|
42
|
+
| **Data Tables & Search** | `DataManagementPage`| Dynamic table pagination index | Target semantic cell content or unique row testid |
|
|
43
|
+
| **Reporting & Exports** | `ReportPage` | Background worker generation lag | Poll download trigger with timeout rather than static wait |
|
|
44
|
+
| **API & Integrations** | `ApiTokenPage` | Bearer token header mismatch | Validate token generation response payload schema |
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## 3. Reference Documentation
|
|
49
|
+
|
|
50
|
+
- [**Diagnostic & Healing Matrix (`healing_matrix.md`)**](references/healing_matrix.md): Concrete code prescriptions for disabled buttons, boundary overlaps, `ElementClickInterceptedException`, `StaleElementReferenceException`, and 4 flaky test root causes.
|
|
51
|
+
- [**Fast-Fix Triad & Runtime Helper (`tools/browser_helpers.js`)**](../../../tools/browser_helpers.js): In-browser diagnosis engine via `window.__qa` (`audit`, `heal`, `clickSafe`, `hud`).
|
|
52
|
+
- **Automated Triage Script:** `python tools/pinpoint_failure.py` and `scripts/triage_failures.sh`.
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 4. Boundary vs `self-healing-locator` (Do Not Confuse)
|
|
57
|
+
|
|
58
|
+
- **This skill** = the general physician: accepts ANY failed test run, performs
|
|
59
|
+
root-cause analysis (JUnit XML, logs, screenshots), queries the memory cache,
|
|
60
|
+
files the bug ticket, and produces a full healing plan (which may involve
|
|
61
|
+
environment, data, timing, or code fixes).
|
|
62
|
+
- **`self-healing-locator`** = the orthopedic specialist: one failure class only
|
|
63
|
+
— broken locators/stale elements. Its matching cascade is *dispatched by*
|
|
64
|
+
this skill's plan when the RCA concludes "locator drift".
|
|
65
|
+
- Rule of thumb: if the failure reason is not yet known, start here; only after
|
|
66
|
+
the RCA says "locator broke" hand the repair to `self-healing-locator`.
|