@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,147 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: consumer-driven-contract-testing
|
|
3
|
+
description: "Standardize Consumer-Driven Contract (CDC) testing with Pact and OpenAPI Bidirectional Contract Testing. Detect and prevent breaking schema changes, payload drift, and microservice integration failures."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Consumer-Driven Contract (CDC) Testing — Schema Drift & Integration Sentinel
|
|
7
|
+
|
|
8
|
+
> **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. Overview & Architecture
|
|
13
|
+
|
|
14
|
+
Consumer-Driven Contract (CDC) Testing shifts integration verification left by formalizing expectations between API consumers (Web/Mobile frontends, backend BFFs) and API providers (microservices) into explicit, machine-readable contracts.
|
|
15
|
+
|
|
16
|
+
Instead of relying on fragile, slow, and expensive multi-service end-to-end environments, CDC enables isolated testing:
|
|
17
|
+
1. **Consumer Tests:** The consumer defines its exact expectation contract (HTTP method, headers, request body, response schema, status code) against a mock provider. A signed Pact file (`.json`) or OpenAPI specification is generated.
|
|
18
|
+
2. **Contract Broker:** The contract is published to the Pact Broker / Contract Ledger with semantic versioning.
|
|
19
|
+
3. **Provider Verification:** The provider independently replays all registered consumer contracts against its live endpoints (or generated stubs) in CI/CD without needing any running consumers.
|
|
20
|
+
4. **Deploy Gate (`can-i-deploy`):** Verifies that both consumer and provider versions are compatible before promoting artifacts to staging or production.
|
|
21
|
+
|
|
22
|
+
```mermaid
|
|
23
|
+
flowchart LR
|
|
24
|
+
subgraph Consumer_CI ["1. Consumer Pipeline"]
|
|
25
|
+
CT["Consumer Test"] -->|Record expectations| MockProv["Pact Mock Server"]
|
|
26
|
+
MockProv -->|Generate| Contract["pact-contract.json"]
|
|
27
|
+
Contract -->|Publish| Broker[("Pact Broker / Contract Ledger")]
|
|
28
|
+
end
|
|
29
|
+
|
|
30
|
+
subgraph Provider_CI ["2. Provider Pipeline"]
|
|
31
|
+
Broker -->|Fetch contracts| Verifier["Pact Verifier / OpenAPI Diff"]
|
|
32
|
+
Verifier -->|Replay requests| RealProv["Provider Microservice"]
|
|
33
|
+
RealProv -->|Verification results| Broker
|
|
34
|
+
end
|
|
35
|
+
|
|
36
|
+
subgraph Release_Gate ["3. Promotion Gate"]
|
|
37
|
+
Broker -->|can-i-deploy| Gate{"Compatible?"}
|
|
38
|
+
Gate -->|Yes| Deploy["Deploy to Production"]
|
|
39
|
+
Gate -->|No (Breaking Drift)| Block["Block Release & Alert"]
|
|
40
|
+
end
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 2. Bi-Directional Contract Testing (BDCT) & OpenAPI Diffing
|
|
46
|
+
|
|
47
|
+
In bi-directional contract testing, consumers use mock fixtures or recorded network HAR traffic, while providers supply their authoritative OpenAPI 3.0/3.1 specification. The engine executes automated schema diffing:
|
|
48
|
+
|
|
49
|
+
### Breaking Changes Checklist (Strictly Blocked by Gatekeeper):
|
|
50
|
+
- ❌ **Removing an existing field** that any consumer contract depends on.
|
|
51
|
+
- ❌ **Adding a new mandatory (`required`) field** to a request body without a default value.
|
|
52
|
+
- ❌ **Mutating property data types** (e.g., `id: string` changed to `id: integer`, or `amount: number` to `amount: string`).
|
|
53
|
+
- ❌ **Narrowing enum values** (removing an enum value that consumers submit or expect).
|
|
54
|
+
- ❌ **Altering response status codes** (e.g., changing HTTP 201 Created to HTTP 200 OK without consumer migration).
|
|
55
|
+
- ❌ **Tightening validation rules** (e.g., lowering `maxLength` below existing consumer field lengths).
|
|
56
|
+
|
|
57
|
+
### Non-Breaking Changes (Permitted):
|
|
58
|
+
- ✅ Adding optional fields (`required: false`) to response bodies.
|
|
59
|
+
- ✅ Adding new endpoints without touching existing routes.
|
|
60
|
+
- ✅ Loosening validation rules (e.g., increasing `maxLength` or expanding enum options).
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## 3. Consumer Contract Authoring Standards (Clean POM & Pact DSL)
|
|
65
|
+
|
|
66
|
+
Consumer contracts must use flexible matchers rather than hardcoded static payloads to prevent flakiness:
|
|
67
|
+
|
|
68
|
+
### TypeScript / Playwright Pact Pattern:
|
|
69
|
+
```typescript
|
|
70
|
+
import { PactV3, MatchersV3 } from '@pact-foundation/pact';
|
|
71
|
+
|
|
72
|
+
const { like, regex, integer, eachLike } = MatchersV3;
|
|
73
|
+
|
|
74
|
+
const provider = new PactV3({
|
|
75
|
+
consumer: 'SynapseWebFrontend',
|
|
76
|
+
provider: 'OrderService',
|
|
77
|
+
dir: './pacts'
|
|
78
|
+
});
|
|
79
|
+
|
|
80
|
+
describe('Order Service CDC Suite', () => {
|
|
81
|
+
it('validates order creation contract', async () => {
|
|
82
|
+
await provider
|
|
83
|
+
.uponReceiving('a request to create a new order')
|
|
84
|
+
.withRequest({
|
|
85
|
+
method: 'POST',
|
|
86
|
+
path: '/api/v1/orders',
|
|
87
|
+
headers: { 'Content-Type': 'application/json', 'Authorization': regex('Bearer .+') },
|
|
88
|
+
body: {
|
|
89
|
+
customerId: like('CUST_1001'),
|
|
90
|
+
items: eachLike({
|
|
91
|
+
sku: regex('^[A-Z0-9_-]{3,20}$', 'SKU_ITEM_01'),
|
|
92
|
+
quantity: integer(1),
|
|
93
|
+
price: like(49.99)
|
|
94
|
+
})
|
|
95
|
+
}
|
|
96
|
+
})
|
|
97
|
+
.willRespondWith({
|
|
98
|
+
status: 201,
|
|
99
|
+
headers: { 'Content-Type': 'application/json' },
|
|
100
|
+
body: {
|
|
101
|
+
orderId: regex('^ORD-[0-9]{8}$', 'ORD-20261106'),
|
|
102
|
+
status: regex('^(PENDING|CONFIRMED)$', 'CONFIRMED'),
|
|
103
|
+
createdAt: like('2026-11-06T10:00:00Z')
|
|
104
|
+
}
|
|
105
|
+
})
|
|
106
|
+
.executeTest(async (mockserver) => {
|
|
107
|
+
const client = new OrderApiClient(mockserver.url);
|
|
108
|
+
const response = await client.createOrder({ ... });
|
|
109
|
+
expect(response.status).toBe('CONFIRMED');
|
|
110
|
+
});
|
|
111
|
+
});
|
|
112
|
+
});
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 4. Provider Verification Protocol
|
|
118
|
+
|
|
119
|
+
Providers verify all active consumer contracts against their test instances:
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
# Verify provider implementation against contracts registered in broker
|
|
123
|
+
pact-verifier \
|
|
124
|
+
--provider-base-url="http://localhost:8080" \
|
|
125
|
+
--pact-broker-url="https://broker.synapse-qa.internal" \
|
|
126
|
+
--provider="OrderService" \
|
|
127
|
+
--publish-verification-results \
|
|
128
|
+
--provider-app-version="3.2.0" \
|
|
129
|
+
--provider-version-branch="main"
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## 5. Automated CI/CD Deployment Verification (`can-i-deploy`)
|
|
135
|
+
|
|
136
|
+
Before triggering deployment in CI/CD, the release pipeline invokes the compatibility ledger:
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
# Enforce deployment gatekeeper
|
|
140
|
+
pact-broker can-i-deploy \
|
|
141
|
+
--pact-broker-url="https://broker.synapse-qa.internal" \
|
|
142
|
+
--pacticipant="SynapseWebFrontend" \
|
|
143
|
+
--version="3.2.0" \
|
|
144
|
+
--to-environment="production"
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
If any contract is unverified or broken, the command exits with non-zero code, blocking deployment and preventing live customer-facing API outages.
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
{
|
|
2
|
+
"consumer": {
|
|
3
|
+
"name": "SynapseWebFrontend"
|
|
4
|
+
},
|
|
5
|
+
"provider": {
|
|
6
|
+
"name": "OrderService"
|
|
7
|
+
},
|
|
8
|
+
"interactions": [
|
|
9
|
+
{
|
|
10
|
+
"description": "a request to create a new order",
|
|
11
|
+
"request": {
|
|
12
|
+
"method": "POST",
|
|
13
|
+
"path": "/api/v1/orders",
|
|
14
|
+
"headers": {
|
|
15
|
+
"Content-Type": "application/json"
|
|
16
|
+
},
|
|
17
|
+
"body": {
|
|
18
|
+
"customerId": "CUST_1001",
|
|
19
|
+
"items": [
|
|
20
|
+
{
|
|
21
|
+
"sku": "SKU_ITEM_01",
|
|
22
|
+
"quantity": 1,
|
|
23
|
+
"price": 49.99
|
|
24
|
+
}
|
|
25
|
+
]
|
|
26
|
+
}
|
|
27
|
+
},
|
|
28
|
+
"response": {
|
|
29
|
+
"status": 201,
|
|
30
|
+
"headers": {
|
|
31
|
+
"Content-Type": "application/json"
|
|
32
|
+
},
|
|
33
|
+
"body": {
|
|
34
|
+
"orderId": "ORD-20261106",
|
|
35
|
+
"status": "CONFIRMED"
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
],
|
|
40
|
+
"metadata": {
|
|
41
|
+
"pactSpecification": {
|
|
42
|
+
"version": "3.0.0"
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: db-state-verifier-and-seeder
|
|
3
|
+
description: "Seed isolated test fixtures and assert database mutations across SQL and NoSQL. Use when seeding, verifying, or cleaning database state around tests."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Database State Verifier & Seeder Skill
|
|
7
|
+
|
|
8
|
+
> **Target:** Eliminate shallow UI-only validations by asserting exact backend database mutations (PostgreSQL, MySQL, Oracle, MongoDB, Redis) and providing isolated, idempotent fixture seeding.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. Core Principles
|
|
13
|
+
|
|
14
|
+
1. **Dual-Layer Assertion (UI + DB):**
|
|
15
|
+
- Asserting a green UI toast is insufficient for transactional operations. Test suites must query the persistence layer to ensure records are properly inserted with correct foreign keys and audit fields (`created_at`, `created_by`).
|
|
16
|
+
2. **Transaction Isolation & Fast Rollback:**
|
|
17
|
+
- Whenever possible, seed data inside transactional boundaries or maintain automated deletion queues tied to entity unique codes.
|
|
18
|
+
3. **Zero Plaintext Connection Credentials:**
|
|
19
|
+
- All connection strings must be sourced strictly from environment variables (`DB_HOST`, `DB_USER`, `DB_PASS`).
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 2. Standard SQL Query & State Assertion Patterns
|
|
24
|
+
|
|
25
|
+
### Pattern A: PostgreSQL / MySQL Record Persistence Assertion
|
|
26
|
+
```python
|
|
27
|
+
import os
|
|
28
|
+
import psycopg2
|
|
29
|
+
|
|
30
|
+
def assert_record_created(unique_code: str, expected_status: str = "ACTIVE"):
|
|
31
|
+
conn = psycopg2.connect(
|
|
32
|
+
host=os.getenv("DB_HOST", "localhost"),
|
|
33
|
+
database=os.getenv("DB_NAME", "qa_db"),
|
|
34
|
+
user=os.getenv("DB_USER", "postgres"),
|
|
35
|
+
password=os.getenv("DB_PASS", "")
|
|
36
|
+
)
|
|
37
|
+
cursor = conn.cursor()
|
|
38
|
+
cursor.execute("SELECT id, status, is_deleted FROM business_entities WHERE code = %s", (unique_code,))
|
|
39
|
+
row = cursor.fetchone()
|
|
40
|
+
|
|
41
|
+
assert row is not None, f"Database assertion failed: Record with code {unique_code} not found!"
|
|
42
|
+
assert row[1] == expected_status, f"Expected status {expected_status}, but found {row[1]}"
|
|
43
|
+
assert row[2] is False, "Record flagged as deleted prematurely"
|
|
44
|
+
|
|
45
|
+
conn.close()
|
|
46
|
+
print(f"[PASS] Verified database persistence for code: {unique_code}")
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### Pattern B: Idempotent SQL Teardown Cleanup
|
|
50
|
+
```python
|
|
51
|
+
def teardown_test_entity(unique_code: str):
|
|
52
|
+
conn = psycopg2.connect(...)
|
|
53
|
+
cursor = conn.cursor()
|
|
54
|
+
cursor.execute("DELETE FROM business_entities WHERE code = %s", (unique_code,))
|
|
55
|
+
conn.commit()
|
|
56
|
+
conn.close()
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 3. Standard NoSQL Patterns (MongoDB & Redis)
|
|
62
|
+
|
|
63
|
+
### Pattern C: MongoDB Document Mutation & JSON Schema Assertion
|
|
64
|
+
```python
|
|
65
|
+
import os
|
|
66
|
+
from pymongo import MongoClient
|
|
67
|
+
|
|
68
|
+
def assert_mongo_document_persisted(order_id: str, expected_item_count: int):
|
|
69
|
+
client = MongoClient(os.getenv("MONGO_URI", "mongodb://localhost:27017"))
|
|
70
|
+
db = client[os.getenv("MONGO_DB", "orders_db")]
|
|
71
|
+
collection = db["customer_orders"]
|
|
72
|
+
|
|
73
|
+
doc = collection.find_one({"orderId": order_id})
|
|
74
|
+
assert doc is not None, f"MongoDB error: Order {order_id} not found!"
|
|
75
|
+
assert len(doc.get("items", [])) == expected_item_count, f"Item count mismatch in doc: {doc}"
|
|
76
|
+
assert doc.get("paymentStatus") == "CONFIRMED", "Payment status is not CONFIRMED"
|
|
77
|
+
|
|
78
|
+
# Cleanup teardown
|
|
79
|
+
collection.delete_one({"orderId": order_id})
|
|
80
|
+
client.close()
|
|
81
|
+
print(f"[PASS] Verified and cleaned MongoDB document: {order_id}")
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Pattern D: Redis Cache Expiry & Invalidation Verification
|
|
85
|
+
```python
|
|
86
|
+
import os
|
|
87
|
+
import redis
|
|
88
|
+
|
|
89
|
+
def assert_cache_invalidated(cache_key: str):
|
|
90
|
+
r = redis.Redis.from_url(os.getenv("REDIS_URL", "redis://localhost:6379/0"))
|
|
91
|
+
val = r.get(cache_key)
|
|
92
|
+
assert val is None, f"Cache leak error: Key '{cache_key}' should have been invalidated after mutation!"
|
|
93
|
+
print(f"[PASS] Verified Redis cache eviction for key: {cache_key}")
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## 4. Zero-Pollution DB Sandbox & Ephemeral Teardown (`tools/db_sandbox.py`)
|
|
99
|
+
|
|
100
|
+
To eliminate cascading flakiness and orphan test junk in parallel CI runs, agents utilize deterministic DB Sandbox operations:
|
|
101
|
+
|
|
102
|
+
### 1. Transaction Savepoint Rollback Context
|
|
103
|
+
Wrap E2E test data creation inside transactional savepoints:
|
|
104
|
+
```bash
|
|
105
|
+
python tools/db_sandbox.py rollback-test --db-path "path/to/db.sqlite"
|
|
106
|
+
```
|
|
107
|
+
*Guarantees zero leftover records: state is automatically rolled back to pristine baseline upon test completion.*
|
|
108
|
+
|
|
109
|
+
### 2. Ephemeral Snapshot & Instant Restore (< 0.5s)
|
|
110
|
+
```bash
|
|
111
|
+
# Before test suite runs: capture pristine database baseline
|
|
112
|
+
python tools/db_sandbox.py snapshot --id pristine_baseline
|
|
113
|
+
|
|
114
|
+
# After suite execution: instantly restore clean database
|
|
115
|
+
python tools/db_sandbox.py restore --id pristine_baseline
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### 3. Taint Pollution Audit & Cascading Purge
|
|
119
|
+
Scan all tables for orphan records carrying test prefixes (`AUTO_`, `TEST_`) and purge them cleanly:
|
|
120
|
+
```bash
|
|
121
|
+
python tools/db_sandbox.py audit
|
|
122
|
+
```
|
|
123
|
+
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: e2e-testing-patterns
|
|
3
|
+
description: "Design robust multi-browser E2E test architectures, parallel sharding, and retry governance. Use when designing end-to-end test suites for web applications."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# E2E Testing Architectural Patterns
|
|
7
|
+
|
|
8
|
+
Engineering standard for structuring, scaling, and maintaining large-scale End-to-End (E2E) test automation suites across modern web frameworks (React, Angular, Vue, Next.js).
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. Test Pyramid & E2E Scope Boundary
|
|
13
|
+
|
|
14
|
+
```mermaid
|
|
15
|
+
flowchart TD
|
|
16
|
+
E2E["<b>E2E Tests (10%)</b><br/>Critical User Journeys, Multi-Page Flows, Payment, SSO"]
|
|
17
|
+
Integ["<b>Integration Tests (30%)</b><br/>Component contracts, API Routes, DB persistence"]
|
|
18
|
+
Unit["<b>Unit Tests (60%)</b><br/>Pure functions, business logic, validation rules"]
|
|
19
|
+
|
|
20
|
+
Unit --> Integ --> E2E
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
- **What belongs in E2E:** High-risk customer journeys (Sign-up, Onboarding, Checkout, File Export, Role transitions).
|
|
24
|
+
- **What to avoid in E2E:** Exhaustive boundary value checks of simple form fields (delegate to Unit/API tests).
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## 2. Core Operational Patterns
|
|
29
|
+
|
|
30
|
+
### Pattern A: Clean Page Object Model (POM) with Typed Interfaces
|
|
31
|
+
```typescript
|
|
32
|
+
// pages/base.page.ts
|
|
33
|
+
import { Page, Locator, expect } from '@playwright/test';
|
|
34
|
+
|
|
35
|
+
export abstract class BasePage {
|
|
36
|
+
constructor(protected readonly page: Page) {}
|
|
37
|
+
|
|
38
|
+
async waitForNetworkIdle(): Promise<void> {
|
|
39
|
+
await this.page.waitForLoadState('networkidle');
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
async clickSafe(locator: Locator): Promise<void> {
|
|
43
|
+
await locator.waitFor({ state: 'visible' });
|
|
44
|
+
await locator.click();
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
```typescript
|
|
50
|
+
// pages/checkout.page.ts
|
|
51
|
+
import { Locator, expect } from '@playwright/test';
|
|
52
|
+
import { BasePage } from './base.page';
|
|
53
|
+
|
|
54
|
+
export class CheckoutPage extends BasePage {
|
|
55
|
+
readonly submitBtn: Locator = this.page.getByRole('button', { name: /Complete Purchase/i });
|
|
56
|
+
readonly confirmationToast: Locator = this.page.getByTestId('checkout-toast');
|
|
57
|
+
|
|
58
|
+
async completeOrder(): Promise<void> {
|
|
59
|
+
await this.clickSafe(this.submitBtn);
|
|
60
|
+
await expect(this.confirmationToast).toBeVisible({ timeout: 5000 });
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Pattern B: Isolated Storage State Fixture (Zero Login Repetition)
|
|
66
|
+
```typescript
|
|
67
|
+
// fixtures/auth.fixture.ts
|
|
68
|
+
import { test as base, Page } from '@playwright/test';
|
|
69
|
+
|
|
70
|
+
export const test = base.extend<{ authedPage: Page }>({
|
|
71
|
+
authedPage: async ({ browser }, use) => {
|
|
72
|
+
const context = await browser.newContext({ storageState: '.auth/user.json' });
|
|
73
|
+
const page = await context.newPage();
|
|
74
|
+
await use(page);
|
|
75
|
+
await context.close();
|
|
76
|
+
},
|
|
77
|
+
});
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Pattern C: Resilient Synchronization (No Static Delays)
|
|
81
|
+
```typescript
|
|
82
|
+
// ANTI-PATTERN:
|
|
83
|
+
// await page.waitForTimeout(5000); // Flaky and slow!
|
|
84
|
+
|
|
85
|
+
// CORRECT PATTERN:
|
|
86
|
+
// 1. Wait for specific API response
|
|
87
|
+
const responsePromise = page.waitForResponse(resp => resp.url().includes('/api/orders') && resp.status() === 201);
|
|
88
|
+
await page.getByRole('button', { name: 'Save' }).click();
|
|
89
|
+
await responsePromise;
|
|
90
|
+
|
|
91
|
+
// 2. Assert final visual DOM state
|
|
92
|
+
await expect(page.getByText('Order Created')).toBeVisible();
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## 3. Parallel Sharding & CI/CD Governance
|
|
98
|
+
```bash
|
|
99
|
+
# Run test suite sharded across 4 parallel CI workers
|
|
100
|
+
npx playwright test --shard=1/4 --reporter=html,junit:results.xml
|
|
101
|
+
```
|
|
102
|
+
- **Retries:** Maximum 1 retry on CI, 0 retries locally. Never rely on retries to mask structural flakiness.
|
|
103
|
+
- **Trace on Failure:** Always configure `trace: 'retain-on-failure'` and `screenshot: 'only-on-failure'`.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { defineConfig, devices } from '@playwright/test';
|
|
2
|
+
|
|
3
|
+
export default defineConfig({
|
|
4
|
+
testDir: './tests',
|
|
5
|
+
fullyParallel: true,
|
|
6
|
+
retries: 2,
|
|
7
|
+
workers: process.env.CI ? 4 : undefined,
|
|
8
|
+
use: {
|
|
9
|
+
headless: true,
|
|
10
|
+
trace: 'on-first-retry',
|
|
11
|
+
},
|
|
12
|
+
});
|