@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,75 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: auth-session-and-cookie-manager
|
|
3
|
+
description: "Manage browser authentication sessions, storageState, JWT tokens, and multi-role state. Use when managing login sessions, storage state, or cookie reuse across tests."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Auth Session & Cookie Manager Skill
|
|
7
|
+
|
|
8
|
+
> **Target:** Eliminate repetitive, slow UI login forms by saving, refreshing, and injecting browser storage states, cookies, and JWT bearer tokens directly into execution contexts.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. Core Principles
|
|
13
|
+
|
|
14
|
+
1. **Zero-Second Auth Protocol:**
|
|
15
|
+
- Execute UI authentication once to produce a verified `session.json` / `storageState.json`.
|
|
16
|
+
- All subsequent test cases inject this saved state directly at context initialization.
|
|
17
|
+
2. **Multi-Role Context Isolation:**
|
|
18
|
+
- Maintain distinct session fixtures for different privilege tiers (e.g. `admin_state.json`, `reviewer_state.json`, `viewer_state.json`).
|
|
19
|
+
3. **Session Freshness & Auto-Refresh:**
|
|
20
|
+
- Inspect token expiry timestamp (`exp` in JWT payload); auto-refresh via API endpoint if token lifetime has elapsed.
|
|
21
|
+
4. **Security & Credential Hygiene:**
|
|
22
|
+
- Saved browser states contain live cookies, session tokens, and local storage values.
|
|
23
|
+
- **Mandatory:** Always add `.auth/` and `*storageState*.json` to your project's `.gitignore` to prevent committing live credentials to version control.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 2. Standard Playwright Implementation Patterns
|
|
28
|
+
|
|
29
|
+
### Pattern A: Generating and Reusing Storage State
|
|
30
|
+
```typescript
|
|
31
|
+
// 1. One-time Setup fixture (e.g. auth.setup.ts)
|
|
32
|
+
import { test as setup, expect } from '@playwright/test';
|
|
33
|
+
|
|
34
|
+
const adminFile = '.auth/admin_state.json';
|
|
35
|
+
|
|
36
|
+
setup('authenticate as admin', async ({ page }) => {
|
|
37
|
+
await page.goto('/login');
|
|
38
|
+
await page.fill('#username', process.env.ADMIN_USER!);
|
|
39
|
+
await page.fill('#password', process.env.ADMIN_PASS!);
|
|
40
|
+
await page.click('button[type="submit"]');
|
|
41
|
+
await page.waitForURL('**/dashboard');
|
|
42
|
+
|
|
43
|
+
await page.context().storageState({ path: adminFile });
|
|
44
|
+
});
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Pattern B: Injecting Session Directly (Zero-Second Login)
|
|
48
|
+
```typescript
|
|
49
|
+
// Reusing authenticated session without loading login form
|
|
50
|
+
import { test } from '@playwright/test';
|
|
51
|
+
|
|
52
|
+
test.use({ storageState: '.auth/admin_state.json' });
|
|
53
|
+
|
|
54
|
+
test('access protected admin table directly', async ({ page }) => {
|
|
55
|
+
await page.goto('/admin/users'); // Opens already logged in
|
|
56
|
+
// Continue immediately with business actions
|
|
57
|
+
});
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Pattern C: Multi-Context Dual Role Testing (Maker vs Checker)
|
|
61
|
+
```typescript
|
|
62
|
+
test('dual-role transaction approval', async ({ browser }) => {
|
|
63
|
+
// Context 1: Staff creates proposal
|
|
64
|
+
const staffContext = await browser.newContext({ storageState: '.auth/staff_state.json' });
|
|
65
|
+
const staffPage = await staffContext.newPage();
|
|
66
|
+
await staffPage.goto('/proposals/new');
|
|
67
|
+
// ... submit proposal ...
|
|
68
|
+
|
|
69
|
+
// Context 2: Manager reviews and approves
|
|
70
|
+
const managerContext = await browser.newContext({ storageState: '.auth/manager_state.json' });
|
|
71
|
+
const managerPage = await managerContext.newPage();
|
|
72
|
+
await managerPage.goto('/proposals/pending');
|
|
73
|
+
// ... approve proposal ...
|
|
74
|
+
});
|
|
75
|
+
```
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Multi-Role Authentication Matrix & Zero-Second Session Management
|
|
2
|
+
|
|
3
|
+
> **Principle:** Never log in via UI forms repeatedly. Seed authenticated storageState once per role and reuse across test suites for 0-second test startup.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. Role State Matrix
|
|
8
|
+
|
|
9
|
+
| Role | Permissions | Storage State File | Seeding Endpoint |
|
|
10
|
+
| :--- | :--- | :--- | :--- |
|
|
11
|
+
| **System Admin** | Full write, user management, billing, audits | `.auth/admin.json` | `POST /api/v1/auth/seed-admin` |
|
|
12
|
+
| **Branch Manager** | Order approval, invoice reconcile, read reports | `.auth/manager.json` | `POST /api/v1/auth/seed-manager` |
|
|
13
|
+
| **Cashier / Viewer** | View catalog, draft cart items, no billing | `.auth/cashier.json` | `POST /api/v1/auth/seed-cashier` |
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 2. Playwright Multi-Role Setup (`playwright.config.ts`)
|
|
18
|
+
|
|
19
|
+
```typescript
|
|
20
|
+
import { defineConfig, devices } from '@playwright/test';
|
|
21
|
+
|
|
22
|
+
export default defineConfig({
|
|
23
|
+
projects: [
|
|
24
|
+
// Setup project: runs once before all tests
|
|
25
|
+
{
|
|
26
|
+
name: 'auth-setup',
|
|
27
|
+
testMatch: /.*\.setup\.ts/,
|
|
28
|
+
},
|
|
29
|
+
// Admin Tests
|
|
30
|
+
{
|
|
31
|
+
name: 'admin-tests',
|
|
32
|
+
use: {
|
|
33
|
+
...devices['Desktop Chrome'],
|
|
34
|
+
storageState: '.auth/admin.json',
|
|
35
|
+
},
|
|
36
|
+
dependencies: ['auth-setup'],
|
|
37
|
+
},
|
|
38
|
+
// Manager Tests
|
|
39
|
+
{
|
|
40
|
+
name: 'manager-tests',
|
|
41
|
+
use: {
|
|
42
|
+
...devices['Desktop Chrome'],
|
|
43
|
+
storageState: '.auth/manager.json',
|
|
44
|
+
},
|
|
45
|
+
dependencies: ['auth-setup'],
|
|
46
|
+
},
|
|
47
|
+
],
|
|
48
|
+
});
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## 3. Silent Token Refresh Middleware
|
|
54
|
+
|
|
55
|
+
When API returns HTTP 401 mid-test, invoke direct refresh without re-entering login forms:
|
|
56
|
+
```typescript
|
|
57
|
+
export async function refreshSessionToken(page: Page, refreshToken: string): Promise<string> {
|
|
58
|
+
const response = await page.request.post('/api/auth/token/refresh', {
|
|
59
|
+
data: { refresh_token: refreshToken },
|
|
60
|
+
});
|
|
61
|
+
const body = await response.json();
|
|
62
|
+
await page.context().addCookies([{
|
|
63
|
+
name: 'session_jwt',
|
|
64
|
+
value: body.access_token,
|
|
65
|
+
domain: 'localhost',
|
|
66
|
+
path: '/',
|
|
67
|
+
}]);
|
|
68
|
+
return body.access_token;
|
|
69
|
+
}
|
|
70
|
+
```
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: backend-load-and-stress-patterns
|
|
3
|
+
description: "Orchestrate k6, Locust, and JMeter backend load, stress, and SLA endurance test suites. Use when designing load, stress, or spike test patterns for backend systems."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Backend Load & Performance Testing Skill
|
|
7
|
+
|
|
8
|
+
> **Target:** Model concurrent Virtual User (VU) and arrival-rate traffic, execute stress/soak test profiles, and enforce automated SLA gates (P95/P99 latency, error rate < 1.0%) to detect bottlenecks before production.
|
|
9
|
+
> **Mandatory Rule:** Adhere strictly to [performance_testing_rules.md](../../rules/performance_testing_rules.md) for safety approvals, hard caps, and truth-anchor reporting.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. Test Archetypes & SLA Targets
|
|
14
|
+
|
|
15
|
+
| Archetype | VUs / Rate | Duration | Objective | SLA Assertion |
|
|
16
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
17
|
+
| **Smoke Test** | 1 - 5 VUs | 1 - 2 min | Health sanity check | Error rate = 0%, P95 < 300ms |
|
|
18
|
+
| **Average Load** | 50 - 200 VUs | 10 - 30 min | Standard peak capacity | Error rate < 0.5%, P95 < 500ms |
|
|
19
|
+
| **Stress Test** | 200 -> 2,000 VUs | 20 - 45 min | Find degradation cliff | Graceful 429/503 (no JVM OOM) |
|
|
20
|
+
| **Spike Test** | 10 -> 1,000 VUs | 5 - 10 min | Autoscaling & rate limiters | Gateway recovery < 30s |
|
|
21
|
+
| **Soak Test** | 50 - 100 VUs | 2 - 12 hr | Memory leaks & connection leaks | Stable heap & steady latency |
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 2. Tooling Unified Runbook
|
|
26
|
+
|
|
27
|
+
### Option A: Apache JMeter (Headless CLI + JTL Analyzer)
|
|
28
|
+
```bash
|
|
29
|
+
# 1. Generate XML test plan from OpenAPI / Postman
|
|
30
|
+
synapse generate-jmx --spec api.json -o load_plan.jmx --vus 50 --duration 180 --sla-p95 500
|
|
31
|
+
|
|
32
|
+
# 2. Run headless benchmark
|
|
33
|
+
jmeter -n -t load_plan.jmx -l results.jtl -e -o ./html_report
|
|
34
|
+
|
|
35
|
+
# 3. Automated CI/CD Quality Gatekeeper
|
|
36
|
+
synapse analyze-jtl results.jtl --sla-p95 500 --max-error-rate 1.0
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Option B: k6 Production Load Testing (with Kill-Switch & Arrival Rate)
|
|
40
|
+
Execute high-concurrency production load tests with arrival-rate executors, user pooling, and automatic kill-switches.
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
# Execute k6 test suite with environment variables
|
|
44
|
+
k6 run -e BASE_URL=https://api.staging.enterprise.local tests/perf/load_test.js
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
👉 **Full Implementation Script:** Refer to [**k6 Load Testing Template (`references/k6_load_template.js`)**](references/k6_load_template.js) for arrival-rate scenarios, SLA thresholds (`P95 < 500ms`, `P99 < 1000ms`), and per-VU session isolation.
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## 3. Best Practices & Safety Invariants
|
|
52
|
+
|
|
53
|
+
- **Isolated Test Data:** Always use dynamic runtime identifiers (`PERF_AUTO_${Date.now()}`) to eliminate primary key collisions.
|
|
54
|
+
- **TearDown Hygiene:** Complement POST/creation load tests with automated teardown or ephemeral DB snapshots (`tools/db_sandbox.py`).
|
|
55
|
+
- **Telemetry Correlation:** Pair JTL/k6 metrics with server CPU/Memory traces via `tools/telemetry_correlator.py`.
|
|
56
|
+
- **Truth Anchor:** Never loosen thresholds to manufacture a false pass. A failing threshold indicates a system capacity limit to be investigated.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## 4. Code-as-Code Load Model (Locust)
|
|
61
|
+
|
|
62
|
+
> *Borrowed and adapted from the Locust load-testing model (MIT license, locustio/locust).*
|
|
63
|
+
|
|
64
|
+
When version-controlled, reviewable load tests matter more than XML tooling,
|
|
65
|
+
generate a runnable locustfile from the same API ingestion used for JMeter:
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
synapse generate-jmx --spec swagger.json --emit-locust locustfile.py \
|
|
69
|
+
--weighted-mix "70,20,10" --think-time-min 500 --think-time-max 1500
|
|
70
|
+
locust -f locustfile.py --host=https://api.staging.enterprise.local
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
The generated file follows the Locust shape — one `HttpUser` class, one
|
|
74
|
+
`@task(weight)` method per endpoint, `wait_time` from think-time — so QA
|
|
75
|
+
engineers can hand-tune scenarios in pure Python and commit them next to the
|
|
76
|
+
test suite.
|
|
77
|
+
|
|
78
|
+
1. **Weights are the traffic mix** — the same `--weighted-mix` percentages that
|
|
79
|
+
drive JMeter `ThroughputController`s drive `@task` weights; keep both exports
|
|
80
|
+
in sync from one spec.
|
|
81
|
+
2. **Prefer code-as-code for logic-heavy journeys** — conditional flows
|
|
82
|
+
(login → create → assert → delete) are Python, not XML; use the JMX export
|
|
83
|
+
for protocol breadth (JDBC/Kafka/gRPC/WS) and Locust for flow logic.
|
|
84
|
+
3. **Same SLA gates** — run `agent-qa analyze-jtl` semantics on Locust stats:
|
|
85
|
+
fail CI when P95 breaches the SLA budget.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import http from 'k6/http';
|
|
2
|
+
import { check, sleep } from 'k6';
|
|
3
|
+
|
|
4
|
+
export const options = {
|
|
5
|
+
vus: 10,
|
|
6
|
+
duration: '30s',
|
|
7
|
+
};
|
|
8
|
+
|
|
9
|
+
export default function () {
|
|
10
|
+
const res = http.get('https://test.k6.io');
|
|
11
|
+
check(res, { 'status was 200': (r) => r.status == 200 });
|
|
12
|
+
sleep(1);
|
|
13
|
+
}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Production-Ready k6 Load Testing Template
|
|
3
|
+
* Features ramping arrival rate, kill-switch thresholds, user pooling, and per-VU session isolation.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import http from 'k6/http';
|
|
7
|
+
import { check, sleep } from 'k6';
|
|
8
|
+
import { SharedArray } from 'k6/data';
|
|
9
|
+
|
|
10
|
+
// 1. Parameterized Test Data: Load pre-seeded user pool to avoid single-token bottleneck
|
|
11
|
+
const userPool = new SharedArray('perf_users', function () {
|
|
12
|
+
// In production: JSON.parse(open('./users.json')) or dynamic credential matrix
|
|
13
|
+
return Array.from({ length: 200 }, (_, i) => ({
|
|
14
|
+
username: `perf_user_${i + 1}@staging.enterprise.local`,
|
|
15
|
+
password: `P@ssw0rd2026_${i + 1}`,
|
|
16
|
+
}));
|
|
17
|
+
});
|
|
18
|
+
|
|
19
|
+
export const options = {
|
|
20
|
+
discardResponseBodies: true,
|
|
21
|
+
scenarios: {
|
|
22
|
+
steady_load: {
|
|
23
|
+
executor: 'ramping-arrival-rate',
|
|
24
|
+
startRate: 10,
|
|
25
|
+
timeUnit: '1s',
|
|
26
|
+
preAllocatedVUs: 50,
|
|
27
|
+
maxVUs: 200,
|
|
28
|
+
stages: [
|
|
29
|
+
{ duration: '2m', target: 50 }, // Ramp-up
|
|
30
|
+
{ duration: '10m', target: 50 }, // Steady state (SLA measured here)
|
|
31
|
+
{ duration: '2m', target: 0 }, // Ramp-down
|
|
32
|
+
],
|
|
33
|
+
},
|
|
34
|
+
},
|
|
35
|
+
thresholds: {
|
|
36
|
+
// 1. Steady state SLA thresholds
|
|
37
|
+
'http_req_failed{scenario:steady_load}': ['rate<0.01'],
|
|
38
|
+
'http_req_duration{scenario:steady_load,expected_response:true}': ['p(95)<500', 'p(99)<1000'],
|
|
39
|
+
'checks{scenario:steady_load}': ['rate>0.99'],
|
|
40
|
+
'dropped_iterations{scenario:steady_load}': ['count==0'],
|
|
41
|
+
// 2. Kill-switch: abort test if system fails catastrophically
|
|
42
|
+
http_req_failed: [{ threshold: 'rate<0.10', abortOnFail: true, delayAbortEval: '30s' }],
|
|
43
|
+
},
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
// 2. Virtual User journey (Authentic Per-VU Session Isolation)
|
|
47
|
+
export default function () {
|
|
48
|
+
// Assign isolated user identity per virtual thread to avoid gateway concurrency lockups
|
|
49
|
+
const user = userPool[__VU % userPool.length];
|
|
50
|
+
|
|
51
|
+
// Per-VU authentic session acquisition
|
|
52
|
+
const loginRes = http.post(`${__ENV.BASE_URL}/api/v1/auth/login`, JSON.stringify(user), {
|
|
53
|
+
headers: { 'Content-Type': 'application/json' },
|
|
54
|
+
tags: { name: 'POST /api/v1/auth/login' },
|
|
55
|
+
});
|
|
56
|
+
|
|
57
|
+
check(loginRes, {
|
|
58
|
+
'auth succeeded': (r) => r.status === 200 && r.json('token') !== undefined,
|
|
59
|
+
});
|
|
60
|
+
|
|
61
|
+
const authToken = loginRes.json('token');
|
|
62
|
+
const params = {
|
|
63
|
+
headers: {
|
|
64
|
+
'Authorization': `Bearer ${authToken}`,
|
|
65
|
+
'Content-Type': 'application/json',
|
|
66
|
+
},
|
|
67
|
+
tags: { name: 'GET /api/v1/items' },
|
|
68
|
+
};
|
|
69
|
+
|
|
70
|
+
const res = http.get(`${__ENV.BASE_URL}/api/v1/items?page=1&limit=20`, params);
|
|
71
|
+
check(res, {
|
|
72
|
+
'status is 200': (r) => r.status === 200,
|
|
73
|
+
});
|
|
74
|
+
|
|
75
|
+
// Realistic think time between actions (uniform 1s to 3s)
|
|
76
|
+
sleep(Math.random() * 2 + 1);
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
// 3. Ephemeral teardown cleanup
|
|
80
|
+
export function teardown() {
|
|
81
|
+
// Execute teardown API calls for created PERF_ entities
|
|
82
|
+
}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bats-testing-patterns
|
|
3
|
+
description: "Test bash/sh scripts, CLI tools, and CI/CD pipelines with Bats. Use when writing Bash automation tests with the BATS framework."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Bats Testing Patterns (Bash Automated Testing System)
|
|
7
|
+
|
|
8
|
+
Comprehensive test engineering standard for validating shell scripts, CI/CD scripts (`.sh`), CLI wrappers, and DevOps automation using Bats-core.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. Core Principles
|
|
13
|
+
|
|
14
|
+
1. **Deterministic Exit Codes:** Every script assertion must explicitly assert `$status` (0 for success, non-zero for explicit failure vectors).
|
|
15
|
+
2. **Standard Output & Error Isolation:** Assert exact error strings in `${lines[@]}` or `$output`.
|
|
16
|
+
3. **Sandbox Filesystem:** Never mutate user home or production directories. Use `$BATS_TEST_TMPDIR` for all temporary files and fixtures.
|
|
17
|
+
4. **Mock External CLI Commands:** Intercept destructive CLI commands (`curl`, `docker`, `kubectl`, `git push`) by prepending a mock binary directory to `$PATH`.
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## 2. Standard Test Architecture & Setup
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
#!/usr/bin/env bats
|
|
25
|
+
|
|
26
|
+
setup() {
|
|
27
|
+
# Load bats helper libraries if available
|
|
28
|
+
load 'test_helper/bats-support/load' || true
|
|
29
|
+
load 'test_helper/bats-assert/load' || true
|
|
30
|
+
|
|
31
|
+
# Create an isolated sandbox directory per test
|
|
32
|
+
TEST_DIR="$(mktemp -d "${BATS_TMPDIR}/bats_test.XXXXXX")"
|
|
33
|
+
export TEST_DIR
|
|
34
|
+
cd "$TEST_DIR"
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
teardown() {
|
|
38
|
+
# Ensure clean sandbox teardown
|
|
39
|
+
rm -rf "$TEST_DIR"
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 3. Production Test Patterns
|
|
46
|
+
|
|
47
|
+
### Pattern A: Exit Code and Output Verification
|
|
48
|
+
```bash
|
|
49
|
+
@test "script fails gracefully when required parameter is missing" {
|
|
50
|
+
run ./scripts/deploy.sh
|
|
51
|
+
[ "$status" -eq 1 ]
|
|
52
|
+
[[ "$output" =~ "ERROR: Missing --target environment" ]]
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
@test "script outputs version correctly on --version flag" {
|
|
56
|
+
run ./scripts/deploy.sh --version
|
|
57
|
+
[ "$status" -eq 0 ]
|
|
58
|
+
[ "${lines[0]}" = "deploy.sh version 2.4.0" ]
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### Pattern B: Mocking Destructive CLI Tools
|
|
63
|
+
```bash
|
|
64
|
+
@test "mock curl API failure triggers automatic retry loop" {
|
|
65
|
+
MOCK_DIR="${TEST_DIR}/bin"
|
|
66
|
+
mkdir -p "$MOCK_DIR"
|
|
67
|
+
|
|
68
|
+
# Create mock curl returning HTTP 503
|
|
69
|
+
cat << 'EOF' > "${MOCK_DIR}/curl"
|
|
70
|
+
#!/bin/bash
|
|
71
|
+
echo "HTTP/1.1 503 Service Unavailable" >&2
|
|
72
|
+
exit 22
|
|
73
|
+
EOF
|
|
74
|
+
chmod +x "${MOCK_DIR}/curl"
|
|
75
|
+
|
|
76
|
+
# Prepend mock path
|
|
77
|
+
PATH="${MOCK_DIR}:${PATH}" run ./scripts/sync_data.sh --retries 2
|
|
78
|
+
[ "$status" -ne 0 ]
|
|
79
|
+
[[ "$output" =~ "Retry attempt 2 failed" ]]
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Pattern C: File Creation & Mutation Verification
|
|
84
|
+
```bash
|
|
85
|
+
@test "script generates valid JSON report on completion" {
|
|
86
|
+
run ./scripts/generate_report.sh --output "${TEST_DIR}/summary.json"
|
|
87
|
+
[ "$status" -eq 0 ]
|
|
88
|
+
[ -f "${TEST_DIR}/summary.json" ]
|
|
89
|
+
run jq '.status' "${TEST_DIR}/summary.json"
|
|
90
|
+
[ "$output" = '"SUCCESS"' ]
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 4. CI/CD Pipeline Execution
|
|
97
|
+
```bash
|
|
98
|
+
# Execute full Bats test suite with JUnit report output for CI
|
|
99
|
+
bats test/*.bats --formatter junit > test-results.xml
|
|
100
|
+
```
|