@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.
Files changed (276) hide show
  1. package/.cursor/rules/agents.mdc +11 -11
  2. package/.cursor/rules/katalon.mdc +11 -0
  3. package/.cursor/rules/perf.mdc +10 -0
  4. package/.cursor/rules/playwright.mdc +10 -0
  5. package/.cursor/rules/pytest.mdc +10 -0
  6. package/.cursor/rules/synapse-qa.mdc +4 -2
  7. package/.cursorrules +3 -10
  8. package/.windsurfrules +3 -10
  9. package/AGENTS.md +4 -3
  10. package/CLAUDE.md +4 -5
  11. package/README.en.md +3 -3
  12. package/README.md +3 -3
  13. package/agentskills.json +15 -15
  14. package/{.agents/agents → ai-agents/personas}/api-engineer.md +2 -2
  15. package/{.agents/agents → ai-agents/personas}/failure-analyst.md +1 -1
  16. package/{.agents/agents → ai-agents/personas}/live-explorer.md +1 -1
  17. package/{.agents/agents → ai-agents/personas}/orchestrator.md +8 -15
  18. package/{.agents/agents → ai-agents/personas}/perf-engineer.md +1 -3
  19. package/{.agents/agents → ai-agents/personas}/pom-crafter.md +3 -9
  20. package/{.agents/agents → ai-agents/personas}/quality-gatekeeper.md +1 -1
  21. package/{.agents/agents → ai-agents/personas}/test-designer.md +2 -1
  22. package/{.agents/agents → ai-agents/personas}/test-runner.md +3 -4
  23. package/{.agents/rules → automation/playwright}/mandatory-playwright-live.md +5 -13
  24. package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/SKILL.md +2 -0
  25. package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/SKILL.md +8 -0
  26. package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/SKILL.md +9 -0
  27. package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/SKILL.md +2 -0
  28. package/docs/ARCHITECTURE.en.md +2 -2
  29. package/docs/ARCHITECTURE.md +2 -2
  30. package/docs/TOOL_CATALOG.md +8 -5
  31. package/docs/reports/AUDIT_REPORT.md +1038 -0
  32. package/docs/reports/PROJECT_HEALTH_REPORT.md +49 -0
  33. package/docs/reports/TECHNICAL_DEBT_LEDGER.md +22 -0
  34. package/package.json +8 -1
  35. package/plugin.json +1 -1
  36. package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/SKILL.md +8 -0
  37. package/scripts/install_global_plugin.ps1 +1 -1
  38. package/scripts/install_global_plugin.sh +1 -1
  39. package/skills_index.json +61 -0
  40. package/skills_manifest.json +88 -62
  41. package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/SKILL.md +8 -1
  42. package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/SKILL.md +2 -0
  43. package/synapse.config.json +1 -1
  44. package/templates/ai_bridges/CLAUDE.md +4 -5
  45. package/templates/ai_bridges/copilot-instructions.md +1 -0
  46. package/templates/ai_bridges/cursor_synapse_qa.mdc +4 -2
  47. package/templates/ai_bridges/windsurfrules +3 -10
  48. package/testing/api-contracts/api_testing_rules.md +74 -0
  49. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/SKILL.md +2 -0
  50. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/SKILL.md +5 -11
  51. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/SKILL.md +2 -0
  52. package/testing/manual/manual-qa-and-rtm-bridge/SKILL.md +92 -0
  53. package/testing/manual/manual-qa-and-rtm-bridge/examples/sample_bug_and_rtm.json +38 -0
  54. package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/SKILL.md +1 -1
  55. package/{.agents/rules → testing/performance}/performance_testing_rules.md +23 -0
  56. package/{.agents/rules → testing/security-a11y}/security_testing_rules.md +19 -0
  57. package/tools/TOOLS_RUNBOOK.md +9 -4
  58. package/tools/TOOL_CATALOG.json +75 -30
  59. package/tools/TOOL_INDEX.json +160 -0
  60. package/tools/__init__.py +1 -1
  61. package/tools/assertion_optimizer.py +188 -0
  62. package/tools/author_integrity.py +12 -1
  63. package/tools/benchmark_swarm_context.py +1 -1
  64. package/tools/browser_helpers.js +2 -2
  65. package/tools/catalogs/api_contract_testing.json +107 -0
  66. package/tools/catalogs/auxiliary_utilities.json +1536 -0
  67. package/tools/catalogs/benchmarking.json +23 -0
  68. package/tools/catalogs/ci_cd_packaging.json +46 -0
  69. package/tools/catalogs/code_generation_ast.json +70 -0
  70. package/tools/catalogs/failure_autopsy_healing.json +41 -0
  71. package/tools/catalogs/manual_testing_design.json +80 -0
  72. package/tools/catalogs/orchestration.json +25 -0
  73. package/tools/catalogs/performance_testing.json +71 -0
  74. package/tools/catalogs/quality_gates.json +65 -0
  75. package/tools/catalogs/sandboxing_isolation.json +42 -0
  76. package/tools/catalogs/security.json +72 -0
  77. package/tools/catalogs/setup_onboarding.json +26 -0
  78. package/tools/catalogs/testing_utilities.json +111 -0
  79. package/tools/check_env.py +16 -3
  80. package/tools/check_version_sync.py +114 -63
  81. package/tools/cldr_l10n_verifier.py +1 -1
  82. package/tools/cli.py +787 -3
  83. package/tools/core/circuit_breaker.py +106 -0
  84. package/tools/core/token_estimator.py +56 -7
  85. package/tools/dashboard_generator.py +10 -10
  86. package/tools/generate_tool_catalog.py +60 -2
  87. package/tools/mcp_docx_server.py +1 -1
  88. package/tools/mcp_excel_server.py +1 -1
  89. package/tools/mcp_server.py +5 -1
  90. package/tools/pre_push_guard.py +1 -1
  91. package/tools/project_state.py +17 -10
  92. package/tools/reversible_sandbox.py +7 -2
  93. package/tools/rules_router.py +5 -3
  94. package/tools/runaway_stopper.py +19 -111
  95. package/tools/setup_project.py +1 -1
  96. package/tools/skill_canonical_digest.py +2 -2
  97. package/tools/skillspector.py +78 -10
  98. package/tools/sync_agent_rules.py +15 -27
  99. package/tools/sync_skills_manifest.py +38 -4
  100. package/tools/tmmi_auditor.py +8 -1
  101. package/tools/ui_server.py +1 -1
  102. package/tools/update_sentinel.py +4 -4
  103. package/tools/validate_host_interop.py +3 -1
  104. package/tools/validate_skills_schema.py +49 -2
  105. package/tools/welcome_page.py +4 -4
  106. package/.agents/rules/stack-auto-router.md +0 -30
  107. package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +0 -114
  108. package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +0 -9
  109. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/SKILL.md +0 -123
  110. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/examples/sample_gitlab_ci.yml +0 -17
  111. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/SKILL.md +0 -133
  112. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/examples/Jenkinsfile.example +0 -21
  113. package/.cursor/rules/language.mdc +0 -7
  114. package/templates/ci/github-actions-synapse.yml +0 -95
  115. package/templates/ci/gitlab-ci-synapse.yml +0 -16
  116. package/tools/build_consolidated_report.py +0 -1643
  117. package/tools/create_mock_docx.py +0 -107
  118. /package/{.agents → ai-agents/hooks}/hooks.json +0 -0
  119. /package/{.agents → ai-agents}/hooks/session_start.py +0 -0
  120. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/SKILL.md +0 -0
  121. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/examples/broker_sharding_sample.json +0 -0
  122. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/SKILL.md +0 -0
  123. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +0 -0
  124. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/SKILL.md +0 -0
  125. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +0 -0
  126. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/SKILL.md +0 -0
  127. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/examples/task_plan_example.md +0 -0
  128. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/SKILL.md +0 -0
  129. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/examples/archival_memory_sample.json +0 -0
  130. /package/{.agents → ai-agents}/workflows/graphify.md +0 -0
  131. /package/{.agents → ai-agents}/workflows/test-impact.md +0 -0
  132. /package/{.agents → ai-agents}/workflows/verify.md +0 -0
  133. /package/{.agents/rules → automation/cypress}/cypress_rules.md +0 -0
  134. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/SKILL.md +0 -0
  135. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/examples/headless_kre_exec.sh +0 -0
  136. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/groovy-patterns.md +0 -0
  137. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/katalon-api.md +0 -0
  138. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/runner_commands.md +0 -0
  139. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/SKILL.md +0 -0
  140. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/BaseScreen.java +0 -0
  141. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/LoginScreen.java +0 -0
  142. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/TC_MobileLogin.java +0 -0
  143. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/SKILL.md +0 -0
  144. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/examples/sample_flow.yaml +0 -0
  145. /package/{.agents/rules → automation/mobile}/mobile_appium_rules.md +0 -0
  146. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/SKILL.md +0 -0
  147. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/examples/live_probe_script.js +0 -0
  148. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/advanced_superpowers.md +0 -0
  149. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/compact_accessibility_snapshots.md +0 -0
  150. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/recipes.md +0 -0
  151. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/swarm_orchestration.md +0 -0
  152. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/examples/server_lifecycle_playwright.py +0 -0
  153. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/SKILL.md +0 -0
  154. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +0 -0
  155. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/storage_state_sample.json +0 -0
  156. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/SKILL.md +0 -0
  157. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/examples/cli_runner_test.bats +0 -0
  158. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/resources/implementation-playbook.md +0 -0
  159. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/examples/standard_test_case.groovy +0 -0
  160. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/references/pom_patterns.groovy +0 -0
  161. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/examples/playwright_sharded_config.ts +0 -0
  162. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/resources/implementation-playbook.md +0 -0
  163. /package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/examples/user_story_sample.md +0 -0
  164. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/SKILL.md +0 -0
  165. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/examples/sample_openapi.json +0 -0
  166. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/SKILL.md +0 -0
  167. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/examples/0001-record-architecture-decisions.md +0 -0
  168. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/pocock_grilling_decision_rubric.md +0 -0
  169. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/sample_spec_review.md +0 -0
  170. /package/{.agents → requirement}/workflows/analyze_requirement_document.md +0 -0
  171. /package/{.agents → requirement}/workflows/generate_requirements_from_website.md +0 -0
  172. /package/{.agents/rules → standards/coding-standards}/author-integrity-guard.md +0 -0
  173. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/SKILL.md +0 -0
  174. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +0 -0
  175. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +0 -0
  176. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/resources/implementation-playbook.md +0 -0
  177. /package/{.agents/rules → standards/coding-standards}/communication-style.md +0 -0
  178. /package/{.agents/rules → standards/coding-standards}/git-push-protocol.md +0 -0
  179. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/SKILL.md +0 -0
  180. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/examples/dependency_blast_radius.json +0 -0
  181. /package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/examples/ladder_walkthrough.md +0 -0
  182. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/SKILL.md +0 -0
  183. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_audit_walkthrough.md +0 -0
  184. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_repo_audit.md +0 -0
  185. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/SKILL.md +0 -0
  186. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/examples/sample_review_walkthrough.md +0 -0
  187. /package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/examples/surgical_vs_scope_creep.md +0 -0
  188. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/SKILL.md +0 -0
  189. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_debt_ledger.md +0 -0
  190. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_ledger_output.md +0 -0
  191. /package/{.agents/rules → standards/context-ai}/context-engineering.md +0 -0
  192. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/SKILL.md +0 -0
  193. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/examples/qa_prompt_template.md +0 -0
  194. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/SKILL.md +0 -0
  195. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/compiled_module_sample.json +0 -0
  196. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +0 -0
  197. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/SKILL.md +0 -0
  198. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_code_window_walkthrough.md +0 -0
  199. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_edit_sample.json +0 -0
  200. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/SKILL.md +0 -0
  201. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/examples/distilled_log_sample.txt +0 -0
  202. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/references/context_engineering_guide.md +0 -0
  203. /package/{.agents/rules → standards/qa-process}/graphify.md +0 -0
  204. /package/{.agents/rules → standards/qa-process}/lessons-learned.md +0 -0
  205. /package/{.agents/rules → standards/qa-process}/skill-precedence.md +0 -0
  206. /package/{.agents/rules → standards/quality-gates}/systematic-debugging.md +0 -0
  207. /package/{.agents/templates → templates/test-plan}/performance-test-plan-template.md +0 -0
  208. /package/{.agents/templates → templates/test-report}/completion_report.md +0 -0
  209. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/SKILL.md +0 -0
  210. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/checkout.feature +0 -0
  211. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/suite_report_sample.json +0 -0
  212. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_cross_module_test_plan.md +0 -0
  213. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_testcases_from_requirements.md +0 -0
  214. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/SKILL.md +0 -0
  215. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +0 -0
  216. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/tot_graph_sample.json +0 -0
  217. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/SKILL.md +0 -0
  218. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +0 -0
  219. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/references/field_validation_checklist.md +0 -0
  220. /package/{.agents → test-design/manual-rbt}/workflows/export_testcases_excel.md +0 -0
  221. /package/{.agents → test-design/manual-rbt}/workflows/generate_manual_testcases_rbt.md +0 -0
  222. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/SKILL.md +0 -0
  223. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/examples/db_fixture_seed.json +0 -0
  224. /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/SKILL.md +0 -0
  225. /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/examples/sample_export_schema.json +0 -0
  226. /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/SKILL.md +0 -0
  227. /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/examples/idempotent_data_recipe.json +0 -0
  228. /package/{.agents → test-design/test-data}/workflows/generate_combinatorial_test_data.md +0 -0
  229. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/SKILL.md +0 -0
  230. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/examples/network_route_stub.json +0 -0
  231. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/SKILL.md +0 -0
  232. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/examples/order_service_pact.json +0 -0
  233. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/healing_report_sample.json +0 -0
  234. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/three_phase_repair_workflow.md +0 -0
  235. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/SKILL.md +0 -0
  236. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/dod_gate_policy.json +0 -0
  237. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +0 -0
  238. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +0 -0
  239. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/sample_junit_failure.xml +0 -0
  240. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/healing_matrix.md +0 -0
  241. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/qa_investigation_protocol.md +0 -0
  242. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/scripts/triage_failures.sh +0 -0
  243. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/SKILL.md +0 -0
  244. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +0 -0
  245. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/examples/aom_diff_sample.json +0 -0
  246. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/SKILL.md +0 -0
  247. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/examples/four_phase_case.md +0 -0
  248. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/SKILL.md +0 -0
  249. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/examples/red_green_refactor_qa.md +0 -0
  250. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/SKILL.md +0 -0
  251. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/examples/evidence_log_example.md +0 -0
  252. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/SKILL.md +0 -0
  253. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/examples/visual_mask_rules.json +0 -0
  254. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +0 -0
  255. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/k6_load_template.js +0 -0
  256. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/performance_test_plan_29119.md +0 -0
  257. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/SKILL.md +0 -0
  258. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_benchmark_gain.md +0 -0
  259. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_scoreboard.md +0 -0
  260. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/SKILL.md +0 -0
  261. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +0 -0
  262. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +0 -0
  263. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/SKILL.md +0 -0
  264. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/examples/dast_scan_config.json +0 -0
  265. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/AI-AND-LLM.md +0 -0
  266. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/ATTACK-CLASSES.md +0 -0
  267. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/dast_recipes.ts +0 -0
  268. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/SKILL.md +0 -0
  269. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/audit_threat_vectors_report.json +0 -0
  270. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/safe_mcp_config.json +0 -0
  271. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/SKILL.md +0 -0
  272. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/examples/wcag_compliance_checklist.json +0 -0
  273. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/resources/implementation-playbook.md +0 -0
  274. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/SKILL.md +0 -0
  275. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +0 -0
  276. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +0 -0
@@ -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.0",
51
- "totalSkills": 56,
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', 42)}</p>
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", 42)))
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.
@@ -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.
@@ -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,7 +0,0 @@
1
- ---
2
- description: Always respond in Vietnamese.
3
- globs:
4
- alwaysApply: true
5
- ---
6
-
7
- Please always respond in Vietnamese.
@@ -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