@teevee98/synapse-hub 4.4.0 → 4.4.1
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/.cursor/rules/agents.mdc +11 -11
- package/.cursor/rules/katalon.mdc +11 -0
- package/.cursor/rules/perf.mdc +10 -0
- package/.cursor/rules/playwright.mdc +10 -0
- package/.cursor/rules/pytest.mdc +10 -0
- package/.cursor/rules/synapse-qa.mdc +4 -2
- package/.cursorrules +3 -10
- package/.windsurfrules +3 -10
- package/AGENTS.md +4 -3
- package/CLAUDE.md +4 -5
- package/README.en.md +3 -3
- package/README.md +3 -3
- package/agentskills.json +15 -15
- package/{.agents/agents → ai-agents/personas}/api-engineer.md +2 -2
- package/{.agents/agents → ai-agents/personas}/failure-analyst.md +1 -1
- package/{.agents/agents → ai-agents/personas}/live-explorer.md +1 -1
- package/{.agents/agents → ai-agents/personas}/orchestrator.md +8 -15
- package/{.agents/agents → ai-agents/personas}/perf-engineer.md +1 -3
- package/{.agents/agents → ai-agents/personas}/pom-crafter.md +3 -9
- package/{.agents/agents → ai-agents/personas}/quality-gatekeeper.md +1 -1
- package/{.agents/agents → ai-agents/personas}/test-designer.md +2 -1
- package/{.agents/agents → ai-agents/personas}/test-runner.md +3 -4
- package/{.agents/rules → automation/playwright}/mandatory-playwright-live.md +5 -13
- package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/SKILL.md +2 -0
- package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/SKILL.md +8 -0
- package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/SKILL.md +9 -0
- package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/SKILL.md +2 -0
- package/docs/ARCHITECTURE.en.md +2 -2
- package/docs/ARCHITECTURE.md +2 -2
- package/docs/TOOL_CATALOG.md +8 -5
- package/docs/reports/AUDIT_REPORT.md +1038 -0
- package/docs/reports/PROJECT_HEALTH_REPORT.md +49 -0
- package/docs/reports/TECHNICAL_DEBT_LEDGER.md +22 -0
- package/package.json +8 -1
- package/plugin.json +1 -1
- package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/SKILL.md +8 -0
- package/scripts/install_global_plugin.ps1 +1 -1
- package/scripts/install_global_plugin.sh +1 -1
- package/skills_index.json +61 -0
- package/skills_manifest.json +88 -62
- package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/SKILL.md +8 -1
- package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/SKILL.md +2 -0
- package/synapse.config.json +1 -1
- package/templates/ai_bridges/CLAUDE.md +4 -5
- package/templates/ai_bridges/copilot-instructions.md +1 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +4 -2
- package/templates/ai_bridges/windsurfrules +3 -10
- package/testing/api-contracts/api_testing_rules.md +74 -0
- package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/SKILL.md +2 -0
- package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/SKILL.md +5 -11
- package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/SKILL.md +2 -0
- package/testing/manual/manual-qa-and-rtm-bridge/SKILL.md +92 -0
- package/testing/manual/manual-qa-and-rtm-bridge/examples/sample_bug_and_rtm.json +38 -0
- package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/SKILL.md +1 -1
- package/{.agents/rules → testing/performance}/performance_testing_rules.md +23 -0
- package/{.agents/rules → testing/security-a11y}/security_testing_rules.md +19 -0
- package/tools/TOOLS_RUNBOOK.md +9 -4
- package/tools/TOOL_CATALOG.json +75 -30
- package/tools/TOOL_INDEX.json +160 -0
- package/tools/__init__.py +1 -1
- package/tools/assertion_optimizer.py +188 -0
- package/tools/author_integrity.py +12 -1
- package/tools/benchmark_swarm_context.py +1 -1
- package/tools/browser_helpers.js +2 -2
- package/tools/catalogs/api_contract_testing.json +107 -0
- package/tools/catalogs/auxiliary_utilities.json +1536 -0
- package/tools/catalogs/benchmarking.json +23 -0
- package/tools/catalogs/ci_cd_packaging.json +46 -0
- package/tools/catalogs/code_generation_ast.json +70 -0
- package/tools/catalogs/failure_autopsy_healing.json +41 -0
- package/tools/catalogs/manual_testing_design.json +80 -0
- package/tools/catalogs/orchestration.json +25 -0
- package/tools/catalogs/performance_testing.json +71 -0
- package/tools/catalogs/quality_gates.json +65 -0
- package/tools/catalogs/sandboxing_isolation.json +42 -0
- package/tools/catalogs/security.json +72 -0
- package/tools/catalogs/setup_onboarding.json +26 -0
- package/tools/catalogs/testing_utilities.json +111 -0
- package/tools/check_env.py +16 -3
- package/tools/check_version_sync.py +114 -63
- package/tools/cldr_l10n_verifier.py +1 -1
- package/tools/cli.py +787 -3
- package/tools/core/circuit_breaker.py +106 -0
- package/tools/core/token_estimator.py +56 -7
- package/tools/dashboard_generator.py +10 -10
- package/tools/generate_tool_catalog.py +60 -2
- package/tools/mcp_docx_server.py +1 -1
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +5 -1
- package/tools/pre_push_guard.py +1 -1
- package/tools/project_state.py +17 -10
- package/tools/reversible_sandbox.py +7 -2
- package/tools/rules_router.py +5 -3
- package/tools/runaway_stopper.py +19 -111
- package/tools/setup_project.py +1 -1
- package/tools/skill_canonical_digest.py +2 -2
- package/tools/skillspector.py +78 -10
- package/tools/sync_agent_rules.py +15 -27
- package/tools/sync_skills_manifest.py +38 -4
- package/tools/tmmi_auditor.py +8 -1
- package/tools/ui_server.py +1 -1
- package/tools/update_sentinel.py +4 -4
- package/tools/validate_host_interop.py +3 -1
- package/tools/validate_skills_schema.py +49 -2
- package/tools/welcome_page.py +4 -4
- package/.agents/rules/stack-auto-router.md +0 -30
- package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +0 -114
- package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +0 -9
- package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/SKILL.md +0 -123
- package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/examples/sample_gitlab_ci.yml +0 -17
- package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/SKILL.md +0 -133
- package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/examples/Jenkinsfile.example +0 -21
- package/.cursor/rules/language.mdc +0 -7
- package/templates/ci/github-actions-synapse.yml +0 -95
- package/templates/ci/gitlab-ci-synapse.yml +0 -16
- package/tools/build_consolidated_report.py +0 -1643
- package/tools/create_mock_docx.py +0 -107
- /package/{.agents → ai-agents/hooks}/hooks.json +0 -0
- /package/{.agents → ai-agents}/hooks/session_start.py +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/examples/broker_sharding_sample.json +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/examples/task_plan_example.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/examples/archival_memory_sample.json +0 -0
- /package/{.agents → ai-agents}/workflows/graphify.md +0 -0
- /package/{.agents → ai-agents}/workflows/test-impact.md +0 -0
- /package/{.agents → ai-agents}/workflows/verify.md +0 -0
- /package/{.agents/rules → automation/cypress}/cypress_rules.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/examples/headless_kre_exec.sh +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/groovy-patterns.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/katalon-api.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/runner_commands.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/BaseScreen.java +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/LoginScreen.java +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/TC_MobileLogin.java +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/examples/sample_flow.yaml +0 -0
- /package/{.agents/rules → automation/mobile}/mobile_appium_rules.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/examples/live_probe_script.js +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/advanced_superpowers.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/compact_accessibility_snapshots.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/recipes.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/swarm_orchestration.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/examples/server_lifecycle_playwright.py +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/storage_state_sample.json +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/examples/cli_runner_test.bats +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/resources/implementation-playbook.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/examples/standard_test_case.groovy +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/references/pom_patterns.groovy +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/examples/playwright_sharded_config.ts +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/resources/implementation-playbook.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/examples/user_story_sample.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/SKILL.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/examples/sample_openapi.json +0 -0
- /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/SKILL.md +0 -0
- /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/examples/0001-record-architecture-decisions.md +0 -0
- /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/pocock_grilling_decision_rubric.md +0 -0
- /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/sample_spec_review.md +0 -0
- /package/{.agents → requirement}/workflows/analyze_requirement_document.md +0 -0
- /package/{.agents → requirement}/workflows/generate_requirements_from_website.md +0 -0
- /package/{.agents/rules → standards/coding-standards}/author-integrity-guard.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/resources/implementation-playbook.md +0 -0
- /package/{.agents/rules → standards/coding-standards}/communication-style.md +0 -0
- /package/{.agents/rules → standards/coding-standards}/git-push-protocol.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/examples/dependency_blast_radius.json +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/examples/ladder_walkthrough.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_audit_walkthrough.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_repo_audit.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/examples/sample_review_walkthrough.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/examples/surgical_vs_scope_creep.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_debt_ledger.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_ledger_output.md +0 -0
- /package/{.agents/rules → standards/context-ai}/context-engineering.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/SKILL.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/examples/qa_prompt_template.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/SKILL.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/compiled_module_sample.json +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/SKILL.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_code_window_walkthrough.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_edit_sample.json +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/SKILL.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/examples/distilled_log_sample.txt +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/references/context_engineering_guide.md +0 -0
- /package/{.agents/rules → standards/qa-process}/graphify.md +0 -0
- /package/{.agents/rules → standards/qa-process}/lessons-learned.md +0 -0
- /package/{.agents/rules → standards/qa-process}/skill-precedence.md +0 -0
- /package/{.agents/rules → standards/quality-gates}/systematic-debugging.md +0 -0
- /package/{.agents/templates → templates/test-plan}/performance-test-plan-template.md +0 -0
- /package/{.agents/templates → templates/test-report}/completion_report.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/SKILL.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/checkout.feature +0 -0
- /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/suite_report_sample.json +0 -0
- /package/{.agents → test-design/bdd-gherkin}/workflows/generate_cross_module_test_plan.md +0 -0
- /package/{.agents → test-design/bdd-gherkin}/workflows/generate_testcases_from_requirements.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/SKILL.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +0 -0
- /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/tot_graph_sample.json +0 -0
- /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/SKILL.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/references/field_validation_checklist.md +0 -0
- /package/{.agents → test-design/manual-rbt}/workflows/export_testcases_excel.md +0 -0
- /package/{.agents → test-design/manual-rbt}/workflows/generate_manual_testcases_rbt.md +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/SKILL.md +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/examples/db_fixture_seed.json +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/SKILL.md +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/examples/sample_export_schema.json +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/SKILL.md +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/examples/idempotent_data_recipe.json +0 -0
- /package/{.agents → test-design/test-data}/workflows/generate_combinatorial_test_data.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/SKILL.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/examples/network_route_stub.json +0 -0
- /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/SKILL.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/examples/order_service_pact.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/healing_report_sample.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/three_phase_repair_workflow.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/dod_gate_policy.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/sample_junit_failure.xml +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/healing_matrix.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/qa_investigation_protocol.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/scripts/triage_failures.sh +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/examples/aom_diff_sample.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/examples/four_phase_case.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/examples/red_green_refactor_qa.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/examples/evidence_log_example.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/examples/visual_mask_rules.json +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/k6_load_template.js +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/performance_test_plan_29119.md +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/SKILL.md +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_benchmark_gain.md +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_scoreboard.md +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/SKILL.md +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/SKILL.md +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/examples/dast_scan_config.json +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/AI-AND-LLM.md +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/ATTACK-CLASSES.md +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/dast_recipes.ts +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/SKILL.md +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/audit_threat_vectors_report.json +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/safe_mcp_config.json +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/SKILL.md +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/examples/wcag_compliance_checklist.json +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/resources/implementation-playbook.md +0 -0
- /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +0 -0
- /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +0 -0
package/tools/welcome_page.py
CHANGED
|
@@ -47,8 +47,8 @@ def get_hub_metadata() -> Dict[str, Any]:
|
|
|
47
47
|
"""Retrieves version and catalog count from skills_manifest.json."""
|
|
48
48
|
manifest_path = os.path.join(HUB_ROOT, "skills_manifest.json")
|
|
49
49
|
meta = {
|
|
50
|
-
"version": "4.4.
|
|
51
|
-
"totalSkills":
|
|
50
|
+
"version": "4.4.1",
|
|
51
|
+
"totalSkills": 57,
|
|
52
52
|
"author": "Thế Vị (@TeeVee98)",
|
|
53
53
|
"repo": "https://github.com/TeeVee98/Synapse-Hub"
|
|
54
54
|
}
|
|
@@ -115,7 +115,7 @@ def generate_welcome_html(target_repo: Optional[str] = None, stack_info: Optiona
|
|
|
115
115
|
<body style="font-family:sans-serif;background:#0f172a;color:#f8fafc;padding:40px;text-align:center;">
|
|
116
116
|
<h1>🛡️ Synapse Hub Enterprise QA v{meta.get('version', '2.4.0')}</h1>
|
|
117
117
|
<p>{hero_pill_content}</p>
|
|
118
|
-
<p>Total Standardized Skills: {meta.get('totalSkills',
|
|
118
|
+
<p>Total Standardized Skills: {meta.get('totalSkills', 57)}</p>
|
|
119
119
|
<p>Author: {meta.get('author', 'Thế Vị (@TeeVee98)')}</p>
|
|
120
120
|
</body></html>"""
|
|
121
121
|
|
|
@@ -125,7 +125,7 @@ def generate_welcome_html(target_repo: Optional[str] = None, stack_info: Optiona
|
|
|
125
125
|
.replace("__NOW_STR__", now_str)
|
|
126
126
|
.replace("__VERSION__", str(meta.get("version", "2.4.0")))
|
|
127
127
|
.replace("__AUTHOR__", str(meta.get("author", "Thế Vị (@TeeVee98)")))
|
|
128
|
-
.replace("__TOTAL_SKILLS__", str(meta.get("totalSkills",
|
|
128
|
+
.replace("__TOTAL_SKILLS__", str(meta.get("totalSkills", 57)))
|
|
129
129
|
.replace("__REPO__", str(meta.get("repo", "https://github.com/TeeVee98/Synapse-Hub")))
|
|
130
130
|
)
|
|
131
131
|
return rendered_html
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
trigger: always_on
|
|
3
|
-
description: Context-aware progressive stack router and token-minimal rule/skill loader.
|
|
4
|
-
profiles: [core, full]
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Context-Aware Stack Router & Token-Minimal Loader (Boost B2)
|
|
8
|
-
|
|
9
|
-
> Added to Synapse-Hub `.agents/rules/` to minimize token consumption (~4,000 tokens/turn) and provide universal cross-project applicability.
|
|
10
|
-
|
|
11
|
-
## 1. Lazy-Loading Rules & Skills (Load Only What the Project Needs)
|
|
12
|
-
At session initialization, AI agents **scan the workspace root to a maximum depth of 2 levels** (or execute automated routing via `python tools/rules_router.py` / `agent-qa rules-router`) and load exclusively the rule and skill subset matching the active project stack (do NOT load all 56 skills or irrelevant platform rules):
|
|
13
|
-
|
|
14
|
-
* **Web / API (`playwright.config.*`, `cypress.config.*`, `openapi.*`, `pytest`, `jest`):** Load only `mandatory-playwright-live.md` (if using Playwright) + `clean-pom-crafter` + `api-network-mocking-interception`.
|
|
15
|
-
* **Mobile (`appium`, `*.xcodeproj`, `build.gradle`):** Load only `mobile_appium_rules.md` + `clean-pom-crafter` (following SOM standard). Omit `mandatory-playwright-live.md`.
|
|
16
|
-
* **Performance (`k6`, `*.jmx`, `locustfile.py`):** Load only `performance_testing_rules.md` + `backend-load-and-stress-patterns`.
|
|
17
|
-
* **Security (`burp`, `zap`, `nuclei`, pentest/DAST):** Load only `security_testing_rules.md` + `security-dast-sentinel` + `skillspector-security-guard`.
|
|
18
|
-
|
|
19
|
-
## 2. Token-Minimal Progressive Router (`tools/rules_router.py`)
|
|
20
|
-
AI agents can trigger the automated router to inspect and obtain the minimal configuration:
|
|
21
|
-
```bash
|
|
22
|
-
python tools/rules_router.py --summary
|
|
23
|
-
# Output: [RULES-ROUTER] Stacks: playwright,git | Rules: 5 | Saved: 2,635 tokens/turn (40.5%)
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## 3. Adaptive Verification (Fast Mode vs Full Gate)
|
|
27
|
-
* **Fast Mode (Quick fixes / authoring 1–2 test cases):** Perform static validation (0 hard sleeps, 0 secrets, verified `assert` statements) and execute the native test runner for **strictly the modified file**, achieving `Exit Code 0`.
|
|
28
|
-
* **Full Gate (PR Finalization / Release Acceptance):**
|
|
29
|
-
* If the project contains `tools/verify_all.py` (full Synapse-Hub environment): execute `python3 tools/verify_all.py`.
|
|
30
|
-
* If the target is an external repository without `tools/verify_all.py`: execute the complete test suite using the project's native command defined in `package.json` / `pyproject.toml` / `Makefile`, followed by credential leak scanning.
|
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: github-actions-templates
|
|
3
|
-
description: "Create production-ready GitHub Actions workflows for automated test suites and CI/CD. Use when wiring test pipelines, matrix shards, or quality gates into GitHub Actions."
|
|
4
|
-
category: architecture_and_analysis
|
|
5
|
-
version: "2.0.0"
|
|
6
|
-
policies:
|
|
7
|
-
network: none
|
|
8
|
-
shell: none
|
|
9
|
-
filesystem: workspace-sandbox
|
|
10
|
-
---
|
|
11
|
-
# GitHub Actions CI/CD Patterns for Test Automation
|
|
12
|
-
|
|
13
|
-
> **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.
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## 1. Trigger & Activation
|
|
18
|
-
|
|
19
|
-
- **Trigger Clause:** Use when configuring continuous integration pipelines, setting up multi-OS and multi-version test execution matrices, wiring quality gates into GitHub Actions, or generating automated test report artifacts.
|
|
20
|
-
- **Activation Scope:**
|
|
21
|
-
- Automated test suites (Playwright, Pytest, Katalon, Newman).
|
|
22
|
-
- Parallel matrix sharding across runners and execution stages.
|
|
23
|
-
- Quality Gate Definition of Done (DoD) verification.
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## 2. Non-Goals & Boundary Constraints
|
|
28
|
-
|
|
29
|
-
- **What NOT to do:**
|
|
30
|
-
- Do NOT use unpinned mutable tags (`@v4`, `@main`) for third-party actions; always pin to immutable 40-character commit SHAs.
|
|
31
|
-
- Do NOT hardcode credentials or tokens in workflow files; inject secrets exclusively through repository secrets (`${{ secrets.TEST_TOKEN }}`).
|
|
32
|
-
- Do NOT retain video and trace artifacts indefinitely; cap retention between 7 and 14 days.
|
|
33
|
-
- **Sibling Skill Boundaries:**
|
|
34
|
-
- `verification-before-completion`: Enforces DoD evidence collection prior to declaring task completion.
|
|
35
|
-
- `github-actions-templates` (this skill): Provides workflow blueprints, matrix sharding, and supply-chain-secure pipeline definitions.
|
|
36
|
-
|
|
37
|
-
---
|
|
38
|
-
|
|
39
|
-
## 3. Ordered Execution Workflow
|
|
40
|
-
|
|
41
|
-
### Phase 1: Workflow Configuration & Matrix Architecture
|
|
42
|
-
|
|
43
|
-
Author or update the CI/CD pipeline template (see reference `examples/matrix_test_pipeline.yml`).
|
|
44
|
-
|
|
45
|
-
<!-- classification: illustrative -->
|
|
46
|
-
```yaml
|
|
47
|
-
# Supply chain security: Pin actions to immutable full 40-character commit SHAs to mitigate tag hijacking and malicious upstream mutation risks.
|
|
48
|
-
name: Enterprise Automated E2E Test Suite
|
|
49
|
-
|
|
50
|
-
on:
|
|
51
|
-
push:
|
|
52
|
-
branches: [ main, develop ]
|
|
53
|
-
pull_request:
|
|
54
|
-
branches: [ main ]
|
|
55
|
-
|
|
56
|
-
jobs:
|
|
57
|
-
test-matrix:
|
|
58
|
-
runs-on: ubuntu-latest
|
|
59
|
-
strategy:
|
|
60
|
-
fail-fast: false
|
|
61
|
-
matrix:
|
|
62
|
-
shard: [1/4, 2/4, 3/4, 4/4]
|
|
63
|
-
|
|
64
|
-
steps:
|
|
65
|
-
- name: Checkout Code
|
|
66
|
-
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
|
67
|
-
|
|
68
|
-
- name: Setup Node.js
|
|
69
|
-
uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a # v4.2.0
|
|
70
|
-
with:
|
|
71
|
-
node-version: 20
|
|
72
|
-
cache: 'npm'
|
|
73
|
-
|
|
74
|
-
- name: Install Dependencies
|
|
75
|
-
run: npm ci
|
|
76
|
-
|
|
77
|
-
- name: Install Playwright Browsers
|
|
78
|
-
run: npx playwright install --with-deps chromium
|
|
79
|
-
|
|
80
|
-
- name: Run Sharded Playwright Tests
|
|
81
|
-
run: npx playwright test --shard=${{ matrix.shard }}
|
|
82
|
-
|
|
83
|
-
- name: Upload Test Report & Screenshots
|
|
84
|
-
if: always()
|
|
85
|
-
uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
|
|
86
|
-
with:
|
|
87
|
-
name: playwright-report-shard-${{ strategy.job-index }}
|
|
88
|
-
path: playwright-report/
|
|
89
|
-
retention-days: 14
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
### Phase 2: Security & Supply Chain Invariants
|
|
93
|
-
|
|
94
|
-
1. **Dependency Pinning:** Pin all third-party GitHub Actions to 40-character commit SHAs with version comments to protect against compromised release tags.
|
|
95
|
-
2. **Secret Masking:** Never echo secrets into workflow steps; pass them as environment variables mapped from GitHub Secrets.
|
|
96
|
-
3. **Concurrency Governance:** Cancel stale runs on pull request updates:
|
|
97
|
-
`concurrency: { group: ${{ github.workflow }}-${{ github.ref }}, cancel-in-progress: true }`.
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
## 4. Verification Points & DoD
|
|
102
|
-
|
|
103
|
-
1. **Syntax Validation:** Workflow passes YAML linting and GitHub Actions schema checks.
|
|
104
|
-
2. **Commit SHA Pinning:** All `uses:` directives reference 40-character commit hashes with supply chain risk disclosures.
|
|
105
|
-
3. **Secret Protection:** 0 exposed secrets in step definitions, run scripts, or job logs.
|
|
106
|
-
4. **Execution Verification:** Pipeline successfully executes test matrix and uploads artifacts upon completion.
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
## 5. Handoff Protocol
|
|
111
|
-
|
|
112
|
-
- **Deliverables:** Production-ready `.github/workflows/*.yml` workflow definitions and example templates in `examples/`.
|
|
113
|
-
- **Next Subagent:** Pass to `test-runner` for local execution or `quality-gatekeeper` for CI/CD integration acceptance.
|
|
114
|
-
- **Output Format:** Valid GitHub Actions YAML syntax adhering to enterprise security baselines.
|
package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml
DELETED
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
# Supply chain security: Pin actions to immutable full 40-character commit SHAs to mitigate tag hijacking and malicious upstream mutation risks.
|
|
2
|
-
name: Automated E2E Matrix
|
|
3
|
-
on: [push, pull_request]
|
|
4
|
-
jobs:
|
|
5
|
-
test:
|
|
6
|
-
runs-on: ubuntu-latest
|
|
7
|
-
steps:
|
|
8
|
-
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
|
9
|
-
- run: npx playwright test
|
|
@@ -1,123 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: gitlab-ci-templates
|
|
3
|
-
description: "Production GitLab CI/CD pipeline blueprints for test automation, Playwright matrix sharding, Katalon KRE execution, and artifact retention governance. Use when wiring test pipelines or quality gates into GitLab CI."
|
|
4
|
-
category: architecture_and_analysis
|
|
5
|
-
version: "1.0.0"
|
|
6
|
-
policies:
|
|
7
|
-
network: none
|
|
8
|
-
shell: none
|
|
9
|
-
filesystem: workspace-sandbox
|
|
10
|
-
---
|
|
11
|
-
# GitLab CI/CD Templates for Test Automation
|
|
12
|
-
|
|
13
|
-
> **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.
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## 1. Trigger & Activation
|
|
18
|
-
|
|
19
|
-
- **Trigger Clause:** Use when configuring GitLab CI/CD pipelines (`.gitlab-ci.yml`), creating parallel test execution matrices, setting up Katalon Runtime Engine (KRE) jobs, configuring dependency caching, or establishing artifact retention policies for test reports.
|
|
20
|
-
- **Activation Scope:**
|
|
21
|
-
- Automated test suites (Playwright, Cypress, Katalon, Pytest).
|
|
22
|
-
- Parallel matrix sharding across GitLab runners.
|
|
23
|
-
- Quality Gate Definition of Done (DoD) verification.
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## 2. Non-Goals & Boundary Constraints
|
|
28
|
-
|
|
29
|
-
- **What NOT to do:**
|
|
30
|
-
- Do NOT hardcode credentials, private tokens, or license keys in `.gitlab-ci.yml`; inject exclusively via GitLab CI/CD masked/protected variables (`$KATALON_API_KEY`, `$CI_JOB_TOKEN`).
|
|
31
|
-
- Do NOT configure unlimited artifact retention; always set `expire_in: 7 days` (or max 14 days) to avoid saturating runner storage.
|
|
32
|
-
- Do NOT leave runner processes hanging; always specify job-level `timeout: 30m`.
|
|
33
|
-
- **Sibling Skill Boundaries:**
|
|
34
|
-
- `github-actions-templates`: Owns GitHub Actions workflows (`.github/workflows/*.yml`).
|
|
35
|
-
- `gitlab-ci-templates` (this skill): Owns GitLab CI/CD pipeline definitions (`.gitlab-ci.yml`).
|
|
36
|
-
- `jenkins-pipeline-templates`: Owns Jenkins Declarative Pipelines (`Jenkinsfile`).
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## 3. Ordered Execution Workflow
|
|
41
|
-
|
|
42
|
-
### Phase 1: Pipeline Configuration & Parallel Sharding
|
|
43
|
-
|
|
44
|
-
Author or update the `.gitlab-ci.yml` pipeline configuration.
|
|
45
|
-
|
|
46
|
-
<!-- classification: illustrative -->
|
|
47
|
-
```yaml
|
|
48
|
-
stages:
|
|
49
|
-
- test
|
|
50
|
-
- report
|
|
51
|
-
|
|
52
|
-
default:
|
|
53
|
-
interruptible: true
|
|
54
|
-
timeout: 30m
|
|
55
|
-
|
|
56
|
-
# Cache dependencies across pipeline runs
|
|
57
|
-
.npm-cache: &npm-cache
|
|
58
|
-
cache:
|
|
59
|
-
key:
|
|
60
|
-
files:
|
|
61
|
-
- package-lock.json
|
|
62
|
-
paths:
|
|
63
|
-
- .npm/
|
|
64
|
-
policy: pull-push
|
|
65
|
-
|
|
66
|
-
# Playwright Parallel Matrix Sharding
|
|
67
|
-
test:playwright:
|
|
68
|
-
stage: test
|
|
69
|
-
image: mcr.microsoft.com/playwright:v1.49.0-noble
|
|
70
|
-
<<: *npm-cache
|
|
71
|
-
parallel: 4
|
|
72
|
-
before_script:
|
|
73
|
-
- npm ci --cache .npm --prefer-offline
|
|
74
|
-
script:
|
|
75
|
-
- npx playwright test --shard=${CI_NODE_INDEX}/${CI_NODE_TOTAL}
|
|
76
|
-
artifacts:
|
|
77
|
-
when: always
|
|
78
|
-
expire_in: 7 days
|
|
79
|
-
paths:
|
|
80
|
-
- playwright-report/
|
|
81
|
-
- test-results/
|
|
82
|
-
reports:
|
|
83
|
-
junit: test-results/results.xml
|
|
84
|
-
|
|
85
|
-
# Katalon Runtime Engine (KRE) Headless Execution
|
|
86
|
-
test:katalon:
|
|
87
|
-
stage: test
|
|
88
|
-
image: katalonstudio/katalon:latest
|
|
89
|
-
rules:
|
|
90
|
-
- if: '$KATALON_API_KEY'
|
|
91
|
-
script:
|
|
92
|
-
- katalonc -noSplash -runMode=console -projectPath="$(pwd)/project.prj" -retry=0 -testSuitePath="Test Suites/TS_Smoke" -browserType="Chrome (headless)" -executionProfile="default" -apiKey="$KATALON_API_KEY"
|
|
93
|
-
artifacts:
|
|
94
|
-
when: always
|
|
95
|
-
expire_in: 7 days
|
|
96
|
-
paths:
|
|
97
|
-
- Reports/
|
|
98
|
-
reports:
|
|
99
|
-
junit: Reports/**/JUnit_Report.xml
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
### Phase 2: Artifact & Storage Governance
|
|
103
|
-
|
|
104
|
-
1. **Selective Artifact Retention:** Always set `artifacts.expire_in: 7 days` for test traces, screenshots, and videos.
|
|
105
|
-
2. **Native JUnit Integration:** Map test result XML to `artifacts.reports.junit` for GitLab native test report parsing and MR telemetry.
|
|
106
|
-
3. **Fail-Fast & Timeout Controls:** Enforce `default.interruptible: true` to auto-cancel stale pipelines on push, and set explicit job timeouts.
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
## 4. Verification Points & DoD
|
|
111
|
-
|
|
112
|
-
1. **Syntax Validation:** `.gitlab-ci.yml` passes GitLab CI Lint API validation.
|
|
113
|
-
2. **Secret Protection:** Zero hardcoded API keys, passwords, or personal access tokens in pipeline YAML.
|
|
114
|
-
3. **Artifact Expiry:** Every job publishing artifacts defines an explicit `expire_in` policy ($\le 14$ days).
|
|
115
|
-
4. **Clean Execution:** All jobs complete with exit code 0 or cleanly capture JUnit XML on test assertion failure.
|
|
116
|
-
|
|
117
|
-
---
|
|
118
|
-
|
|
119
|
-
## 5. Handoff Protocol
|
|
120
|
-
|
|
121
|
-
- **Deliverables:** Production-ready `.gitlab-ci.yml` definitions and reusable job templates.
|
|
122
|
-
- **Next Subagent:** Pass to `test-runner` for runner validation or `quality-gatekeeper` for CI/CD acceptance.
|
|
123
|
-
- **Output Format:** Valid GitLab CI/CD YAML specification adhering to enterprise security baselines.
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
stages:
|
|
2
|
-
- test
|
|
3
|
-
|
|
4
|
-
test_playwright:
|
|
5
|
-
stage: test
|
|
6
|
-
image: mcr.microsoft.com/playwright:v1.49.0-noble
|
|
7
|
-
parallel: 2
|
|
8
|
-
script:
|
|
9
|
-
- npm ci
|
|
10
|
-
- npx playwright test --shard=${CI_NODE_INDEX}/${CI_NODE_TOTAL}
|
|
11
|
-
artifacts:
|
|
12
|
-
when: always
|
|
13
|
-
expire_in: 7 days
|
|
14
|
-
paths:
|
|
15
|
-
- playwright-report/
|
|
16
|
-
reports:
|
|
17
|
-
junit: test-results/results.xml
|
|
@@ -1,133 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: jenkins-pipeline-templates
|
|
3
|
-
description: "Enterprise Jenkins Declarative Pipeline templates for test automation, parallel stages, Katalon KRE runner, JUnit reporting, and workspace hygiene. Use when configuring Jenkins pipelines or quality gates."
|
|
4
|
-
category: architecture_and_analysis
|
|
5
|
-
version: "1.0.0"
|
|
6
|
-
policies:
|
|
7
|
-
network: none
|
|
8
|
-
shell: none
|
|
9
|
-
filesystem: workspace-sandbox
|
|
10
|
-
---
|
|
11
|
-
# Jenkins Pipeline Templates for Test Automation
|
|
12
|
-
|
|
13
|
-
> **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.
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## 1. Trigger & Activation
|
|
18
|
-
|
|
19
|
-
- **Trigger Clause:** Use when creating or standardizing Jenkins Declarative Pipelines (`Jenkinsfile`), configuring parallel execution stages across agent nodes, integrating Katalon Runtime Engine (KRE), publishing JUnit/HTML test results, or implementing workspace cleanup routines.
|
|
20
|
-
- **Activation Scope:**
|
|
21
|
-
- Automated test pipelines (Playwright, Cypress, Katalon, Pytest, Newman).
|
|
22
|
-
- Parallel execution across Jenkins agent nodes.
|
|
23
|
-
- Quality Gate Definition of Done (DoD) verification and post-build actions.
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## 2. Non-Goals & Boundary Constraints
|
|
28
|
-
|
|
29
|
-
- **What NOT to do:**
|
|
30
|
-
- Do NOT use Scripted Pipeline syntax (`node { ... }`) when Declarative Pipeline (`pipeline { agent ... }`) meets the architectural requirement.
|
|
31
|
-
- Do NOT commit plaintext passwords or credentials in `Jenkinsfile`; inject via `withCredentials([string(credentialsId: '...', variable: '...')])`.
|
|
32
|
-
- Do NOT omit post-execution workspace cleanup; always invoke `cleanWs()` in `post { always { ... } }`.
|
|
33
|
-
- **Sibling Skill Boundaries:**
|
|
34
|
-
- `github-actions-templates`: Owns GitHub Actions workflows.
|
|
35
|
-
- `gitlab-ci-templates`: Owns GitLab CI/CD pipelines.
|
|
36
|
-
- `jenkins-pipeline-templates` (this skill): Owns Jenkins Declarative Pipelines (`Jenkinsfile`).
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## 3. Ordered Execution Workflow
|
|
41
|
-
|
|
42
|
-
### Phase 1: Declarative Pipeline Template
|
|
43
|
-
|
|
44
|
-
Author or update the `Jenkinsfile` Declarative Pipeline configuration.
|
|
45
|
-
|
|
46
|
-
<!-- classification: illustrative -->
|
|
47
|
-
```groovy
|
|
48
|
-
pipeline {
|
|
49
|
-
agent any
|
|
50
|
-
|
|
51
|
-
options {
|
|
52
|
-
timeout(time: 45, unit: 'MINUTES')
|
|
53
|
-
buildDiscarder(logRotator(numToKeepStr: '15', artifactNumToKeepStr: '10'))
|
|
54
|
-
disableConcurrentBuilds()
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
environment {
|
|
58
|
-
KATALON_API_KEY = credentials('katalon-kre-api-key')
|
|
59
|
-
NODE_ENV = 'test'
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
stages {
|
|
63
|
-
stage('Checkout & Setup') {
|
|
64
|
-
steps {
|
|
65
|
-
checkout scm
|
|
66
|
-
sh 'npm ci'
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
stage('Parallel Automated Testing') {
|
|
71
|
-
parallel {
|
|
72
|
-
stage('Playwright E2E Shard 1') {
|
|
73
|
-
steps {
|
|
74
|
-
sh 'npx playwright test --shard=1/2'
|
|
75
|
-
}
|
|
76
|
-
}
|
|
77
|
-
stage('Playwright E2E Shard 2') {
|
|
78
|
-
steps {
|
|
79
|
-
sh 'npx playwright test --shard=2/2'
|
|
80
|
-
}
|
|
81
|
-
}
|
|
82
|
-
stage('Katalon KRE Suite') {
|
|
83
|
-
when {
|
|
84
|
-
expression { env.RUN_KATALON == 'true' }
|
|
85
|
-
}
|
|
86
|
-
steps {
|
|
87
|
-
sh '''
|
|
88
|
-
katalonc -noSplash -runMode=console \
|
|
89
|
-
-projectPath="$(pwd)/project.prj" \
|
|
90
|
-
-retry=0 \
|
|
91
|
-
-testSuitePath="Test Suites/TS_Smoke" \
|
|
92
|
-
-browserType="Chrome (headless)" \
|
|
93
|
-
-executionProfile="default" \
|
|
94
|
-
-apiKey="${KATALON_API_KEY}"
|
|
95
|
-
'''
|
|
96
|
-
}
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
post {
|
|
103
|
-
always {
|
|
104
|
-
junit testResults: '**/reports/*.xml, **/JUnit_Report.xml', allowEmptyResults: true
|
|
105
|
-
archiveArtifacts artifacts: 'playwright-report/**, Screenshots/FAILED_*.png', allowEmptyArchive: true, fingerprint: true
|
|
106
|
-
cleanWs deleteDirs: true, notFailBuild: true
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
### Phase 2: Pipeline Invariants & Hygiene
|
|
113
|
-
|
|
114
|
-
1. **Workspace Sanitization:** Always execute `cleanWs()` in the post-build block to prevent cross-build disk pollution and lingering lockfiles.
|
|
115
|
-
2. **Credential Masking:** Use Jenkins native `credentials()` helper to bind secrets securely; never echo or write credentials to workspace files.
|
|
116
|
-
3. **Artifact Retention:** Limit artifact history with `buildDiscarder(logRotator(numToKeepStr: '15', artifactNumToKeepStr: '10'))`.
|
|
117
|
-
|
|
118
|
-
---
|
|
119
|
-
|
|
120
|
-
## 4. Verification Points & DoD
|
|
121
|
-
|
|
122
|
-
1. **Syntax Validation:** `Jenkinsfile` adheres to Declarative Pipeline syntax and passes Jenkinsfile linter.
|
|
123
|
-
2. **Credential Binding:** Zero hardcoded secrets; 100% of credentials mapped via Jenkins credentials store.
|
|
124
|
-
3. **Report Publication:** Post-build actions configure `junit` result parsing and selective artifact archiving.
|
|
125
|
-
4. **Clean Teardown:** Post section enforces `cleanWs()` workspace sanitization.
|
|
126
|
-
|
|
127
|
-
---
|
|
128
|
-
|
|
129
|
-
## 5. Handoff Protocol
|
|
130
|
-
|
|
131
|
-
- **Deliverables:** Production-ready `Jenkinsfile` pipeline definitions and reusable stage libraries.
|
|
132
|
-
- **Next Subagent:** Pass to `test-runner` for local runner execution or `quality-gatekeeper` for CI/CD pipeline acceptance.
|
|
133
|
-
- **Output Format:** Valid Jenkins Declarative Pipeline Groovy syntax.
|
package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/examples/Jenkinsfile.example
DELETED
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
pipeline {
|
|
2
|
-
agent any
|
|
3
|
-
options {
|
|
4
|
-
timeout(time: 30, unit: 'MINUTES')
|
|
5
|
-
buildDiscarder(logRotator(numToKeepStr: '10'))
|
|
6
|
-
}
|
|
7
|
-
stages {
|
|
8
|
-
stage('Test') {
|
|
9
|
-
steps {
|
|
10
|
-
sh 'npm ci'
|
|
11
|
-
sh 'npx playwright test'
|
|
12
|
-
}
|
|
13
|
-
}
|
|
14
|
-
}
|
|
15
|
-
post {
|
|
16
|
-
always {
|
|
17
|
-
junit 'test-results/**/*.xml'
|
|
18
|
-
cleanWs()
|
|
19
|
-
}
|
|
20
|
-
}
|
|
21
|
-
}
|
|
@@ -1,95 +0,0 @@
|
|
|
1
|
-
name: Synapse QA Quality Gate & DoD Sentinel
|
|
2
|
-
|
|
3
|
-
on:
|
|
4
|
-
push:
|
|
5
|
-
branches: [ main, develop, master ]
|
|
6
|
-
pull_request:
|
|
7
|
-
branches: [ main, develop, master ]
|
|
8
|
-
|
|
9
|
-
permissions:
|
|
10
|
-
contents: read
|
|
11
|
-
pull-requests: write
|
|
12
|
-
|
|
13
|
-
jobs:
|
|
14
|
-
quality-gate:
|
|
15
|
-
name: DoD Quality Gates & AI Test Lint
|
|
16
|
-
runs-on: ubuntu-latest
|
|
17
|
-
steps:
|
|
18
|
-
- name: Checkout Project Source
|
|
19
|
-
uses: actions/checkout@v4
|
|
20
|
-
|
|
21
|
-
- name: Setup Node.js (NPX Runner)
|
|
22
|
-
uses: actions/setup-node@v4
|
|
23
|
-
with:
|
|
24
|
-
node-version: 20
|
|
25
|
-
|
|
26
|
-
- name: Setup Python Environment
|
|
27
|
-
uses: actions/setup-python@v5
|
|
28
|
-
with:
|
|
29
|
-
python-version: '3.12'
|
|
30
|
-
|
|
31
|
-
- name: Run Test Quality Linter (Fake-Pass & Sleep Detection)
|
|
32
|
-
id: lint
|
|
33
|
-
continue-on-error: true
|
|
34
|
-
run: |
|
|
35
|
-
mkdir -p reports
|
|
36
|
-
npx @teevee98/synapse-hub lint --json > reports/infer_linter_report.json || true
|
|
37
|
-
cat reports/infer_linter_report.json || true
|
|
38
|
-
|
|
39
|
-
- name: Run 10 Quality Gates DoD Verification
|
|
40
|
-
id: verify
|
|
41
|
-
run: |
|
|
42
|
-
npx @teevee98/synapse-hub verify
|
|
43
|
-
|
|
44
|
-
- name: Generate GitHub Step Summary
|
|
45
|
-
if: always()
|
|
46
|
-
run: |
|
|
47
|
-
echo "## 🧠 Synapse QA Quality Gate Scorecard" >> $GITHUB_STEP_SUMMARY
|
|
48
|
-
echo "" >> $GITHUB_STEP_SUMMARY
|
|
49
|
-
echo "| Check / Gate | Result | Notes |" >> $GITHUB_STEP_SUMMARY
|
|
50
|
-
echo "| :--- | :---: | :--- |" >> $GITHUB_STEP_SUMMARY
|
|
51
|
-
echo "| **Gate 1–10 DoD Verification** | ${{ steps.verify.outcome == 'success' && '✅ PASS' || '❌ FAIL' }} | Enforced 10 Quality Gates |" >> $GITHUB_STEP_SUMMARY
|
|
52
|
-
echo "| **AST Fake-Pass Linter** | ${{ steps.lint.outcome == 'success' && '✅ CLEAN' || '⚠️ FINDINGS' }} | Scanned zero asserts, sleeps & empty catches |" >> $GITHUB_STEP_SUMMARY
|
|
53
|
-
echo "" >> $GITHUB_STEP_SUMMARY
|
|
54
|
-
echo "> *Generated by [Synapse Hub](https://github.com/TeeVee98/Synapse-Hub) — Test Quality Linter & Guardrails for AI-Generated Tests.*" >> $GITHUB_STEP_SUMMARY
|
|
55
|
-
|
|
56
|
-
- name: Comment DoD Scorecard on Pull Request
|
|
57
|
-
if: github.event_name == 'pull_request' && always()
|
|
58
|
-
uses: actions/github-script@v7
|
|
59
|
-
with:
|
|
60
|
-
script: |
|
|
61
|
-
const verifySuccess = '${{ steps.verify.outcome }}' === 'success';
|
|
62
|
-
const lintSuccess = '${{ steps.lint.outcome }}' === 'success';
|
|
63
|
-
const statusIcon = verifySuccess ? '✅' : '❌';
|
|
64
|
-
|
|
65
|
-
const body = `### ${statusIcon} Synapse QA Quality Gate Report
|
|
66
|
-
| Quality Gate | Status | Description |
|
|
67
|
-
| :--- | :---: | :--- |
|
|
68
|
-
| **10 DoD Quality Gates** | ${verifySuccess ? '✅ PASSED' : '❌ FAILED'} | UTF-8, Path Portability, Clean POM, Secret Security, Mutation & SLA Sentinel |
|
|
69
|
-
| **AST Test Linter** | ${lintSuccess ? '✅ PASSED' : '⚠️ FINDINGS'} | Zero Fake-Pass, No Hardcoded Sleeps, No Swallowed Catches |
|
|
70
|
-
|
|
71
|
-
*Automated gatekeeper powered by [Synapse Hub](https://github.com/TeeVee98/Synapse-Hub).*`;
|
|
72
|
-
|
|
73
|
-
const { data: comments } = await github.rest.issues.listComments({
|
|
74
|
-
owner: context.repo.owner,
|
|
75
|
-
repo: context.repo.repo,
|
|
76
|
-
issue_number: context.issue.number,
|
|
77
|
-
});
|
|
78
|
-
|
|
79
|
-
const botComment = comments.find(c => c.body.includes('Synapse QA Quality Gate Report'));
|
|
80
|
-
|
|
81
|
-
if (botComment) {
|
|
82
|
-
await github.rest.issues.updateComment({
|
|
83
|
-
owner: context.repo.owner,
|
|
84
|
-
repo: context.repo.repo,
|
|
85
|
-
comment_id: botComment.id,
|
|
86
|
-
body: body,
|
|
87
|
-
});
|
|
88
|
-
} else {
|
|
89
|
-
await github.rest.issues.createComment({
|
|
90
|
-
owner: context.repo.owner,
|
|
91
|
-
repo: context.repo.repo,
|
|
92
|
-
issue_number: context.issue.number,
|
|
93
|
-
body: body,
|
|
94
|
-
});
|
|
95
|
-
}
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
# Synapse-Hub Enterprise QA Quality Gate Snippet for GitLab CI
|
|
2
|
-
# Include this job in your target project's .gitlab-ci.yml
|
|
3
|
-
|
|
4
|
-
stages:
|
|
5
|
-
- test
|
|
6
|
-
|
|
7
|
-
synapse-qa-gate:
|
|
8
|
-
stage: test
|
|
9
|
-
image: node:20-bookworm
|
|
10
|
-
before_script:
|
|
11
|
-
- apt-get update && apt-get install -y python3 python3-pip
|
|
12
|
-
script:
|
|
13
|
-
- npx @teevee98/synapse-hub verify
|
|
14
|
-
rules:
|
|
15
|
-
- if: $CI_PIPELINE_SOURCE == "merge_request_event"
|
|
16
|
-
- if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
|