@teevee98/synapse-hub 4.3.1 → 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 (289) 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 +9 -1
  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 +11 -5
  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 +14 -3
  26. package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/SKILL.md +12 -1
  27. package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/SKILL.md +2 -0
  28. package/docs/ARCHITECTURE.en.md +96 -3
  29. package/docs/ARCHITECTURE.md +87 -3
  30. package/docs/TOOL_CATALOG.md +17 -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/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/SKILL.md +8 -0
  44. package/synapse.config.json +1 -1
  45. package/templates/ai_bridges/CLAUDE.md +4 -5
  46. package/templates/ai_bridges/copilot-instructions.md +1 -0
  47. package/templates/ai_bridges/cursor_synapse_qa.mdc +4 -2
  48. package/templates/ai_bridges/windsurfrules +3 -10
  49. package/templates/test-plan/performance-test-plan-template.md +106 -0
  50. package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/SKILL.md +11 -5
  51. package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/SKILL.md +8 -1
  52. package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/SKILL.md +4 -1
  53. package/testing/api-contracts/api_testing_rules.md +74 -0
  54. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/SKILL.md +2 -0
  55. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/SKILL.md +5 -11
  56. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/SKILL.md +2 -0
  57. package/testing/manual/manual-qa-and-rtm-bridge/SKILL.md +92 -0
  58. package/testing/manual/manual-qa-and-rtm-bridge/examples/sample_bug_and_rtm.json +38 -0
  59. package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/SKILL.md +5 -2
  60. package/testing/performance/backend-load-and-stress-patterns/references/performance_test_plan_29119.md +106 -0
  61. package/{.agents/rules → testing/performance}/performance_testing_rules.md +27 -3
  62. package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/SKILL.md +75 -14
  63. package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/SKILL.md +13 -2
  64. package/{.agents/rules → testing/security-a11y}/security_testing_rules.md +19 -0
  65. package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/SKILL.md +4 -1
  66. package/tools/.infer_baseline.json +44 -3
  67. package/tools/TOOLS_RUNBOOK.md +246 -4
  68. package/tools/TOOL_CATALOG.json +199 -19
  69. package/tools/TOOL_INDEX.json +160 -0
  70. package/tools/__init__.py +1 -1
  71. package/tools/ai_eval_sentinel.py +403 -0
  72. package/tools/assertion_optimizer.py +188 -0
  73. package/tools/asvs_auditor.py +410 -0
  74. package/tools/author_integrity.py +12 -1
  75. package/tools/benchmark_swarm_context.py +1 -1
  76. package/tools/browser_helpers.js +2 -2
  77. package/tools/catalogs/api_contract_testing.json +107 -0
  78. package/tools/catalogs/auxiliary_utilities.json +1536 -0
  79. package/tools/catalogs/benchmarking.json +23 -0
  80. package/tools/catalogs/ci_cd_packaging.json +46 -0
  81. package/tools/catalogs/code_generation_ast.json +70 -0
  82. package/tools/catalogs/failure_autopsy_healing.json +41 -0
  83. package/tools/catalogs/manual_testing_design.json +80 -0
  84. package/tools/catalogs/orchestration.json +25 -0
  85. package/tools/catalogs/performance_testing.json +71 -0
  86. package/tools/catalogs/quality_gates.json +65 -0
  87. package/tools/catalogs/sandboxing_isolation.json +42 -0
  88. package/tools/catalogs/security.json +72 -0
  89. package/tools/catalogs/setup_onboarding.json +26 -0
  90. package/tools/catalogs/testing_utilities.json +111 -0
  91. package/tools/chaos_resilience_probe.py +362 -0
  92. package/tools/check_env.py +16 -3
  93. package/tools/check_version_sync.py +114 -63
  94. package/tools/cldr_l10n_verifier.py +309 -0
  95. package/tools/cli.py +971 -3
  96. package/tools/core/circuit_breaker.py +106 -0
  97. package/tools/core/token_estimator.py +56 -7
  98. package/tools/cvss_calculator.py +412 -0
  99. package/tools/dashboard_generator.py +12 -12
  100. package/tools/etl_data_reconciler.py +460 -0
  101. package/tools/generate_jmx_plan.py +12 -4
  102. package/tools/generate_tool_catalog.py +60 -2
  103. package/tools/jtl_analyzer.py +23 -1
  104. package/tools/mcp_docx_server.py +1 -1
  105. package/tools/mcp_excel_server.py +1 -1
  106. package/tools/mcp_server.py +5 -1
  107. package/tools/mobile_resilience_sentinel.py +273 -0
  108. package/tools/observability_tester.py +235 -0
  109. package/tools/payment_interop_simulator.py +337 -0
  110. package/tools/pre_push_guard.py +306 -0
  111. package/tools/project_state.py +17 -10
  112. package/tools/regulatory_compliance.py +336 -0
  113. package/tools/reversible_sandbox.py +7 -2
  114. package/tools/rules_router.py +6 -4
  115. package/tools/runaway_stopper.py +19 -111
  116. package/tools/setup_project.py +1 -1
  117. package/tools/skill_canonical_digest.py +2 -2
  118. package/tools/skillspector.py +78 -10
  119. package/tools/sync_agent_rules.py +15 -27
  120. package/tools/sync_skills_manifest.py +38 -4
  121. package/tools/tmmi_auditor.py +179 -0
  122. package/tools/ui_server.py +1 -1
  123. package/tools/update_sentinel.py +4 -4
  124. package/tools/validate_host_interop.py +3 -1
  125. package/tools/validate_skills_schema.py +49 -2
  126. package/tools/vpat_exporter.py +428 -0
  127. package/tools/welcome_page.py +4 -4
  128. package/.agents/rules/stack-auto-router.md +0 -30
  129. package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +0 -114
  130. package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +0 -9
  131. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/SKILL.md +0 -123
  132. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/examples/sample_gitlab_ci.yml +0 -17
  133. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/SKILL.md +0 -133
  134. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/examples/Jenkinsfile.example +0 -21
  135. package/.cursor/rules/language.mdc +0 -7
  136. package/templates/ci/github-actions-synapse.yml +0 -95
  137. package/templates/ci/gitlab-ci-synapse.yml +0 -16
  138. package/tools/build_consolidated_report.py +0 -1643
  139. package/tools/create_mock_docx.py +0 -107
  140. /package/{.agents → ai-agents/hooks}/hooks.json +0 -0
  141. /package/{.agents → ai-agents}/hooks/session_start.py +0 -0
  142. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/SKILL.md +0 -0
  143. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/examples/broker_sharding_sample.json +0 -0
  144. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/SKILL.md +0 -0
  145. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +0 -0
  146. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/SKILL.md +0 -0
  147. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +0 -0
  148. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/SKILL.md +0 -0
  149. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/examples/task_plan_example.md +0 -0
  150. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/SKILL.md +0 -0
  151. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/examples/archival_memory_sample.json +0 -0
  152. /package/{.agents → ai-agents}/workflows/graphify.md +0 -0
  153. /package/{.agents → ai-agents}/workflows/test-impact.md +0 -0
  154. /package/{.agents → ai-agents}/workflows/verify.md +0 -0
  155. /package/{.agents/rules → automation/cypress}/cypress_rules.md +0 -0
  156. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/SKILL.md +0 -0
  157. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/examples/headless_kre_exec.sh +0 -0
  158. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/groovy-patterns.md +0 -0
  159. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/katalon-api.md +0 -0
  160. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/runner_commands.md +0 -0
  161. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/SKILL.md +0 -0
  162. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/BaseScreen.java +0 -0
  163. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/LoginScreen.java +0 -0
  164. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/TC_MobileLogin.java +0 -0
  165. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/SKILL.md +0 -0
  166. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/examples/sample_flow.yaml +0 -0
  167. /package/{.agents/rules → automation/mobile}/mobile_appium_rules.md +0 -0
  168. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/SKILL.md +0 -0
  169. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/examples/live_probe_script.js +0 -0
  170. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/advanced_superpowers.md +0 -0
  171. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/compact_accessibility_snapshots.md +0 -0
  172. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/recipes.md +0 -0
  173. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/swarm_orchestration.md +0 -0
  174. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/examples/server_lifecycle_playwright.py +0 -0
  175. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/SKILL.md +0 -0
  176. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +0 -0
  177. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/storage_state_sample.json +0 -0
  178. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/SKILL.md +0 -0
  179. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/examples/cli_runner_test.bats +0 -0
  180. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/resources/implementation-playbook.md +0 -0
  181. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/examples/standard_test_case.groovy +0 -0
  182. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/references/pom_patterns.groovy +0 -0
  183. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/examples/playwright_sharded_config.ts +0 -0
  184. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/resources/implementation-playbook.md +0 -0
  185. /package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/examples/user_story_sample.md +0 -0
  186. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/SKILL.md +0 -0
  187. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/examples/sample_openapi.json +0 -0
  188. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/SKILL.md +0 -0
  189. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/examples/0001-record-architecture-decisions.md +0 -0
  190. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/pocock_grilling_decision_rubric.md +0 -0
  191. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/sample_spec_review.md +0 -0
  192. /package/{.agents → requirement}/workflows/analyze_requirement_document.md +0 -0
  193. /package/{.agents → requirement}/workflows/generate_requirements_from_website.md +0 -0
  194. /package/{.agents/rules → standards/coding-standards}/author-integrity-guard.md +0 -0
  195. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/SKILL.md +0 -0
  196. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +0 -0
  197. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +0 -0
  198. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/resources/implementation-playbook.md +0 -0
  199. /package/{.agents/rules → standards/coding-standards}/communication-style.md +0 -0
  200. /package/{.agents/rules → standards/coding-standards}/git-push-protocol.md +0 -0
  201. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/SKILL.md +0 -0
  202. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/examples/dependency_blast_radius.json +0 -0
  203. /package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/examples/ladder_walkthrough.md +0 -0
  204. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/SKILL.md +0 -0
  205. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_audit_walkthrough.md +0 -0
  206. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_repo_audit.md +0 -0
  207. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/SKILL.md +0 -0
  208. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/examples/sample_review_walkthrough.md +0 -0
  209. /package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/examples/surgical_vs_scope_creep.md +0 -0
  210. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/SKILL.md +0 -0
  211. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_debt_ledger.md +0 -0
  212. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_ledger_output.md +0 -0
  213. /package/{.agents/rules → standards/context-ai}/context-engineering.md +0 -0
  214. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/SKILL.md +0 -0
  215. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/examples/qa_prompt_template.md +0 -0
  216. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/compiled_module_sample.json +0 -0
  217. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +0 -0
  218. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/SKILL.md +0 -0
  219. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_code_window_walkthrough.md +0 -0
  220. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_edit_sample.json +0 -0
  221. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/SKILL.md +0 -0
  222. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/examples/distilled_log_sample.txt +0 -0
  223. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/references/context_engineering_guide.md +0 -0
  224. /package/{.agents/rules → standards/qa-process}/graphify.md +0 -0
  225. /package/{.agents/rules → standards/qa-process}/lessons-learned.md +0 -0
  226. /package/{.agents/rules → standards/qa-process}/skill-precedence.md +0 -0
  227. /package/{.agents/rules → standards/quality-gates}/systematic-debugging.md +0 -0
  228. /package/{.agents/templates → templates/test-report}/completion_report.md +0 -0
  229. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/SKILL.md +0 -0
  230. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/checkout.feature +0 -0
  231. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/suite_report_sample.json +0 -0
  232. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_cross_module_test_plan.md +0 -0
  233. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_testcases_from_requirements.md +0 -0
  234. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/SKILL.md +0 -0
  235. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +0 -0
  236. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/tot_graph_sample.json +0 -0
  237. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +0 -0
  238. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/references/field_validation_checklist.md +0 -0
  239. /package/{.agents → test-design/manual-rbt}/workflows/export_testcases_excel.md +0 -0
  240. /package/{.agents → test-design/manual-rbt}/workflows/generate_manual_testcases_rbt.md +0 -0
  241. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/SKILL.md +0 -0
  242. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/examples/db_fixture_seed.json +0 -0
  243. /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/examples/sample_export_schema.json +0 -0
  244. /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/examples/idempotent_data_recipe.json +0 -0
  245. /package/{.agents → test-design/test-data}/workflows/generate_combinatorial_test_data.md +0 -0
  246. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/SKILL.md +0 -0
  247. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/examples/network_route_stub.json +0 -0
  248. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/SKILL.md +0 -0
  249. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/examples/order_service_pact.json +0 -0
  250. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/healing_report_sample.json +0 -0
  251. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/three_phase_repair_workflow.md +0 -0
  252. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/SKILL.md +0 -0
  253. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/dod_gate_policy.json +0 -0
  254. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +0 -0
  255. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +0 -0
  256. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/sample_junit_failure.xml +0 -0
  257. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/healing_matrix.md +0 -0
  258. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/qa_investigation_protocol.md +0 -0
  259. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/scripts/triage_failures.sh +0 -0
  260. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/SKILL.md +0 -0
  261. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +0 -0
  262. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/examples/aom_diff_sample.json +0 -0
  263. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/SKILL.md +0 -0
  264. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/examples/four_phase_case.md +0 -0
  265. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/SKILL.md +0 -0
  266. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/examples/red_green_refactor_qa.md +0 -0
  267. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/SKILL.md +0 -0
  268. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/examples/evidence_log_example.md +0 -0
  269. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/SKILL.md +0 -0
  270. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/examples/visual_mask_rules.json +0 -0
  271. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +0 -0
  272. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/k6_load_template.js +0 -0
  273. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/SKILL.md +0 -0
  274. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_benchmark_gain.md +0 -0
  275. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_scoreboard.md +0 -0
  276. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +0 -0
  277. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +0 -0
  278. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/examples/dast_scan_config.json +0 -0
  279. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/AI-AND-LLM.md +0 -0
  280. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/ATTACK-CLASSES.md +0 -0
  281. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/dast_recipes.ts +0 -0
  282. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/SKILL.md +0 -0
  283. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/audit_threat_vectors_report.json +0 -0
  284. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/safe_mcp_config.json +0 -0
  285. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/examples/wcag_compliance_checklist.json +0 -0
  286. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/resources/implementation-playbook.md +0 -0
  287. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/SKILL.md +0 -0
  288. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +0 -0
  289. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +0 -0
@@ -0,0 +1,428 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
3
+ # SPDX-License-Identifier: MIT
4
+ # Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
5
+
6
+ """
7
+ tools/vpat_exporter.py — Enterprise Section 508 & EN 301 549 VPAT Report Generator
8
+ ---------------------------------------------------------------------------------
9
+ Translates WCAG 2.1 & 2.2 accessibility scan findings (from tools/wcag_audit.py
10
+ or axe-core) into standardized Voluntary Product Accessibility Template (VPAT 2.5)
11
+ compliance reports covering:
12
+ - Revised Section 508 (US Public Sector / Federal Standard)
13
+ - EN 301 549 (European Union Accessibility Standard for ICT)
14
+ - W3C WCAG 2.1 / 2.2 (Levels A and AA)
15
+
16
+ Outputs:
17
+ - Markdown (.md)
18
+ - HTML (.html)
19
+ - JSON (.json)
20
+
21
+ Usage:
22
+ python tools/vpat_exporter.py --url https://staging.example.com --out-md VPAT_REPORT.md
23
+ python tools/vpat_exporter.py --input wcag_results.json --format html --out VPAT.html
24
+ python tools/vpat_exporter.py --html-file path/to/index.html --out-md VPAT.md
25
+ """
26
+
27
+ import sys
28
+ import json
29
+ import argparse
30
+ from datetime import datetime, timezone
31
+ from typing import Dict, List, Any
32
+
33
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
34
+ if hasattr(sys.stdout, "reconfigure"):
35
+ try:
36
+ sys.stdout.reconfigure(encoding="utf-8")
37
+ sys.stderr.reconfigure(encoding="utf-8")
38
+ except Exception:
39
+ pass
40
+
41
+ # Import wcag_audit dynamically if present
42
+ try:
43
+ from tools.wcag_audit import WCAGAuditor
44
+ except ImportError:
45
+ try:
46
+ from wcag_audit import WCAGAuditor
47
+ except ImportError:
48
+ WCAGAuditor = None
49
+
50
+
51
+ # ==============================================================================
52
+ # VPAT 2.5 CRITERIA MAPPING TABLE
53
+ # ==============================================================================
54
+
55
+ VPAT_CRITERIA_CATALOG = [
56
+ {
57
+ "wcag_id": "1.1.1",
58
+ "name": "Non-text Content",
59
+ "level": "A",
60
+ "section_508": "501.1 (Web), 504.2 (Authoring Tools)",
61
+ "en_301_549": "9.1.1.1 (Web), 10.1.1.1 (Non-web docs), 11.1.1.1 (Software)",
62
+ "desc": "All non-text content that is presented to the user has a text alternative that serves the equivalent purpose.",
63
+ },
64
+ {
65
+ "wcag_id": "1.3.1",
66
+ "name": "Info and Relationships",
67
+ "level": "A",
68
+ "section_508": "501.1 (Web), 504.2",
69
+ "en_301_549": "9.1.3.1 (Web), 11.1.3.1 (Software)",
70
+ "desc": "Information, structure, and relationships conveyed through presentation can be programmatically determined or are available in text.",
71
+ },
72
+ {
73
+ "wcag_id": "1.4.3",
74
+ "name": "Contrast (Minimum)",
75
+ "level": "AA",
76
+ "section_508": "501.1 (Web), 504.2",
77
+ "en_301_549": "9.1.4.3 (Web), 11.1.4.3 (Software)",
78
+ "desc": "The visual presentation of text and images of text has a contrast ratio of at least 4.5:1 (3:1 for large text).",
79
+ },
80
+ {
81
+ "wcag_id": "2.1.1",
82
+ "name": "Keyboard",
83
+ "level": "A",
84
+ "section_508": "501.1 (Web), 504.2",
85
+ "en_301_549": "9.2.1.1 (Web), 11.2.1.1 (Software)",
86
+ "desc": "All functionality of the content is operable through a keyboard interface without requiring specific timings for individual keystrokes.",
87
+ },
88
+ {
89
+ "wcag_id": "2.1.2",
90
+ "name": "No Keyboard Trap",
91
+ "level": "A",
92
+ "section_508": "501.1 (Web), 504.2",
93
+ "en_301_549": "9.2.1.2 (Web), 11.2.1.2 (Software)",
94
+ "desc": "If keyboard focus can be moved to a component using a keyboard interface, focus can be moved away without trapping the user.",
95
+ },
96
+ {
97
+ "wcag_id": "2.4.4",
98
+ "name": "Link Purpose (In Context)",
99
+ "level": "A",
100
+ "section_508": "501.1 (Web), 504.2",
101
+ "en_301_549": "9.2.4.4 (Web), 11.2.4.4 (Software)",
102
+ "desc": "The purpose of each link can be determined from the link text alone or from the link text together with programmatic context.",
103
+ },
104
+ {
105
+ "wcag_id": "2.4.11",
106
+ "name": "Focus Not Obscured (Minimum)",
107
+ "level": "AA",
108
+ "section_508": "Revised 508 (Aligned with WCAG 2.2)",
109
+ "en_301_549": "9.2.4.11 (Web, WCAG 2.2 Draft)",
110
+ "desc": "When an item gets keyboard focus, it is not entirely obscured by author-created content (sticky headers, banners).",
111
+ },
112
+ {
113
+ "wcag_id": "2.5.8",
114
+ "name": "Target Size (Minimum)",
115
+ "level": "AA",
116
+ "section_508": "Revised 508 (Aligned with WCAG 2.2)",
117
+ "en_301_549": "9.2.5.8 (Web, WCAG 2.2 Draft)",
118
+ "desc": "The target size for pointer inputs is at least 24 by 24 CSS pixels, or has sufficient offset/spacing.",
119
+ },
120
+ {
121
+ "wcag_id": "3.2.6",
122
+ "name": "Consistent Help",
123
+ "level": "A",
124
+ "section_508": "Revised 508 (Aligned with WCAG 2.2)",
125
+ "en_301_549": "9.3.2.6 (Web, WCAG 2.2)",
126
+ "desc": "If help mechanism is available, it appears in the same relative order across multiple web pages.",
127
+ },
128
+ {
129
+ "wcag_id": "3.3.7",
130
+ "name": "Redundant Entry",
131
+ "level": "A",
132
+ "section_508": "Revised 508 (Aligned with WCAG 2.2)",
133
+ "en_301_549": "9.3.3.7 (Web, WCAG 2.2)",
134
+ "desc": "Information previously entered or provided is auto-populated or available for selection in multi-step processes.",
135
+ },
136
+ {
137
+ "wcag_id": "3.3.8",
138
+ "name": "Accessible Authentication (Minimum)",
139
+ "level": "AA",
140
+ "section_508": "Revised 508 (Aligned with WCAG 2.2)",
141
+ "en_301_549": "9.3.3.8 (Web, WCAG 2.2)",
142
+ "desc": "A cognitive function test (such as solving a puzzle or remembering a password) is not required for authentication without an alternative.",
143
+ },
144
+ {
145
+ "wcag_id": "4.1.2",
146
+ "name": "Name, Role, Value",
147
+ "level": "A",
148
+ "section_508": "501.1 (Web), 504.2",
149
+ "en_301_549": "9.4.1.2 (Web), 11.4.1.2 (Software)",
150
+ "desc": "For all UI components, the name and role can be programmatically determined; states and properties can be set programmatically.",
151
+ },
152
+ ]
153
+
154
+
155
+ def audit_html_source(html_content: str) -> List[Dict[str, Any]]:
156
+ """Runs WCAGAuditor parser on HTML content to extract violations."""
157
+ if WCAGAuditor is None:
158
+ return []
159
+ auditor = WCAGAuditor()
160
+ try:
161
+ auditor.feed(html_content)
162
+ except Exception:
163
+ pass
164
+ return auditor.violations
165
+
166
+
167
+ def compile_vpat_assessment(
168
+ violations: List[Dict[str, Any]],
169
+ product_name: str = "Enterprise Web Application",
170
+ product_version: str = "1.0.0",
171
+ vendor: str = "Quality Engineering Team",
172
+ ) -> Dict[str, Any]:
173
+ """Compiles audit violations into standard VPAT conformance criteria."""
174
+ assessed_table = []
175
+ supports_count = 0
176
+ partially_count = 0
177
+ not_support_count = 0
178
+
179
+ # Group violations by WCAG criterion ID
180
+ violation_map: Dict[str, List[Dict[str, Any]]] = {}
181
+ for v in violations:
182
+ crit_str = v.get("criterion", "")
183
+ for c in VPAT_CRITERIA_CATALOG:
184
+ if c["wcag_id"] in crit_str or c["name"].lower() in crit_str.lower():
185
+ violation_map.setdefault(c["wcag_id"], []).append(v)
186
+ break
187
+
188
+ for c in VPAT_CRITERIA_CATALOG:
189
+ cid = c["wcag_id"]
190
+ viols = violation_map.get(cid, [])
191
+
192
+ if not viols:
193
+ conformance = "Supports"
194
+ remarks = "The web application satisfies the criterion with zero automated defects detected."
195
+ supports_count += 1
196
+ elif len(viols) <= 2 and not any(v.get("severity") == "CRITICAL" for v in viols):
197
+ conformance = "Partially Supports"
198
+ remarks = f"{len(viols)} minor defect(s) detected: " + "; ".join(v.get("message", "") for v in viols[:2])
199
+ partially_count += 1
200
+ else:
201
+ conformance = "Does Not Support"
202
+ remarks = f"{len(viols)} violation(s) identified. Sample: " + "; ".join(v.get("message", "") for v in viols[:3])
203
+ not_support_count += 1
204
+
205
+ assessed_table.append({
206
+ "wcag_id": cid,
207
+ "name": c["name"],
208
+ "level": c["level"],
209
+ "section_508": c["section_508"],
210
+ "en_301_549": c["en_301_549"],
211
+ "conformance": conformance,
212
+ "remarks": remarks,
213
+ "violations_count": len(viols),
214
+ "samples": viols[:3],
215
+ })
216
+
217
+ total = len(assessed_table)
218
+ conformance_rate = round((supports_count + (0.5 * partially_count)) / total * 100, 1)
219
+
220
+ return {
221
+ "vpat_version": "2.5 (Revised Section 508 & EN 301 549 Edition)",
222
+ "report_date": datetime.now(timezone.utc).strftime("%Y-%m-%d"),
223
+ "product_name": product_name,
224
+ "product_version": product_version,
225
+ "vendor": vendor,
226
+ "evaluation_methods": "Automated AST inspection, W3C WCAG 2.2 Linter (tools/wcag_audit.py), and DOM traversal.",
227
+ "conformance_summary": {
228
+ "total_criteria": total,
229
+ "supports": supports_count,
230
+ "partially_supports": partially_count,
231
+ "does_not_support": not_support_count,
232
+ "conformance_rate_pct": conformance_rate,
233
+ },
234
+ "criteria": assessed_table,
235
+ }
236
+
237
+
238
+ # ==============================================================================
239
+ # EXPORTERS (MARKDOWN & HTML)
240
+ # ==============================================================================
241
+
242
+ def export_vpat_markdown(vpat_data: Dict[str, Any]) -> str:
243
+ """Renders VPAT report in official Markdown format."""
244
+ lines = [
245
+ "# Accessibility Conformance Report (VPAT® Version 2.5)",
246
+ "",
247
+ f"**Product Name:** {vpat_data['product_name']} ",
248
+ f"**Product Version:** {vpat_data['product_version']} ",
249
+ f"**Vendor / Organization:** {vpat_data['vendor']} ",
250
+ f"**Report Date:** {vpat_data['report_date']} ",
251
+ f"**Evaluation Methods:** {vpat_data['evaluation_methods']} ",
252
+ "",
253
+ "## Applicable Standards & Guidelines",
254
+ "- **Web Content Accessibility Guidelines (WCAG) 2.2** (Levels A and AA)",
255
+ "- **Revised Section 508 Standards** (US Access Board)",
256
+ "- **EN 301 549 Accessibility Requirements for ICT Products and Services** (European Standard)",
257
+ "",
258
+ "## Conformance Terms",
259
+ "- **Supports:** The functionality has at least one method that addresses the criterion without known defects.",
260
+ "- **Partially Supports:** Some functionality does not meet the criterion.",
261
+ "- **Does Not Support:** The majority of functionality does not meet the criterion.",
262
+ "- **Not Applicable:** The criterion is not relevant to the product.",
263
+ "",
264
+ f"### Executive Summary Conformance Rate: **{vpat_data['conformance_summary']['conformance_rate_pct']}%**",
265
+ f"- Fully Supports: `{vpat_data['conformance_summary']['supports']}` criteria",
266
+ f"- Partially Supports: `{vpat_data['conformance_summary']['partially_supports']}` criteria",
267
+ f"- Does Not Support: `{vpat_data['conformance_summary']['does_not_support']}` criteria",
268
+ "",
269
+ "---",
270
+ "",
271
+ "## Table 1: Success Criteria, Level A & AA (WCAG 2.2 / Section 508 / EN 301 549)",
272
+ "",
273
+ "| Criteria | Level | Section 508 Chapter 5 | EN 301 549 Clause 9 | Conformance Level | Remarks and Explanations |",
274
+ "| :--- | :---: | :--- | :--- | :---: | :--- |",
275
+ ]
276
+
277
+ for c in vpat_data["criteria"]:
278
+ crit_title = f"**{c['wcag_id']} {c['name']}**"
279
+ lines.append(
280
+ f"| {crit_title} | Level {c['level']} | {c['section_508']} | {c['en_301_549']} | **{c['conformance']}** | {c['remarks']} |"
281
+ )
282
+
283
+ lines.append("")
284
+ lines.append("---")
285
+ lines.append("*Report generated automatically via Synapse Hub Enterprise Accessibility Sentinel (`tools/vpat_exporter.py`).*")
286
+ return "\n".join(lines)
287
+
288
+
289
+ def export_vpat_html(vpat_data: Dict[str, Any]) -> str:
290
+ """Renders VPAT report in standalone styled HTML format."""
291
+ rate = vpat_data["conformance_summary"]["conformance_rate_pct"]
292
+ rate_color = "#10b981" if rate >= 85 else ("#f59e0b" if rate >= 65 else "#ef4444")
293
+
294
+ rows_html = []
295
+ for c in vpat_data["criteria"]:
296
+ bg_col = "#ecfdf5" if c["conformance"] == "Supports" else ("#fffbeb" if c["conformance"] == "Partially Supports" else "#fef2f2")
297
+ badge_col = "#047857" if c["conformance"] == "Supports" else ("#b45309" if c["conformance"] == "Partially Supports" else "#b91c1c")
298
+
299
+ rows_html.append(f"""
300
+ <tr style="background-color: {bg_col};">
301
+ <td style="padding: 10px; border: 1px solid #e5e7eb;"><strong>{c['wcag_id']} {c['name']}</strong></td>
302
+ <td style="padding: 10px; border: 1px solid #e5e7eb; text-align: center;">Level {c['level']}</td>
303
+ <td style="padding: 10px; border: 1px solid #e5e7eb; font-size: 13px;">{c['section_508']}</td>
304
+ <td style="padding: 10px; border: 1px solid #e5e7eb; font-size: 13px;">{c['en_301_549']}</td>
305
+ <td style="padding: 10px; border: 1px solid #e5e7eb; text-align: center;">
306
+ <span style="display: inline-block; padding: 4px 8px; border-radius: 4px; font-weight: bold; font-size: 12px; color: white; background-color: {badge_col};">
307
+ {c['conformance']}
308
+ </span>
309
+ </td>
310
+ <td style="padding: 10px; border: 1px solid #e5e7eb; font-size: 13px;">{c['remarks']}</td>
311
+ </tr>
312
+ """)
313
+
314
+ return f"""<!DOCTYPE html>
315
+ <html lang="en">
316
+ <head>
317
+ <meta charset="UTF-8">
318
+ <title>VPAT® 2.5 - {vpat_data['product_name']}</title>
319
+ <style>
320
+ body {{ font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; line-height: 1.5; margin: 30px; color: #1f2937; }}
321
+ h1 {{ color: #111827; }}
322
+ .meta-box {{ background: #f3f4f6; border-radius: 8px; padding: 15px 20px; margin-bottom: 25px; }}
323
+ .scorecard {{ display: inline-block; font-size: 28px; font-weight: bold; color: {rate_color}; }}
324
+ table {{ width: 100%; border-collapse: collapse; margin-top: 20px; }}
325
+ th {{ background: #1f2937; color: white; padding: 12px; text-align: left; font-size: 14px; border: 1px solid #1f2937; }}
326
+ </style>
327
+ </head>
328
+ <body>
329
+ <h1>Accessibility Conformance Report (VPAT® 2.5)</h1>
330
+ <div class="meta-box">
331
+ <p><strong>Product:</strong> {vpat_data['product_name']} (v{vpat_data['product_version']}) | <strong>Date:</strong> {vpat_data['report_date']}</p>
332
+ <p><strong>Evaluation Standards:</strong> WCAG 2.2 (A/AA), Revised Section 508, EN 301 549</p>
333
+ <p><strong>Conformance Rating:</strong> <span class="scorecard">{rate}%</span> ({vpat_data['conformance_summary']['supports']} Supports / {vpat_data['conformance_summary']['partially_supports']} Partial / {vpat_data['conformance_summary']['does_not_support']} Does Not Support)</p>
334
+ </div>
335
+ <table>
336
+ <thead>
337
+ <tr>
338
+ <th>Success Criteria</th>
339
+ <th>Level</th>
340
+ <th>Section 508</th>
341
+ <th>EN 301 549</th>
342
+ <th>Conformance Level</th>
343
+ <th>Remarks and Explanations</th>
344
+ </tr>
345
+ </thead>
346
+ <tbody>
347
+ {"".join(rows_html)}
348
+ </tbody>
349
+ </table>
350
+ </body>
351
+ </html>"""
352
+
353
+
354
+ # ==============================================================================
355
+ # CLI HANDLER
356
+ # ==============================================================================
357
+
358
+ def main():
359
+ parser = argparse.ArgumentParser(
360
+ description="Synapse Hub Section 508 & EN 301 549 VPAT Exporter",
361
+ formatter_class=argparse.RawDescriptionHelpFormatter,
362
+ )
363
+ parser.add_argument("--url", help="Target URL to fetch HTML and audit")
364
+ parser.add_argument("--html-file", help="Path to local HTML file to inspect")
365
+ parser.add_argument("--input", help="Path to pre-existing wcag_audit JSON results file")
366
+ parser.add_argument("--format", choices=["md", "html", "json"], default="md", help="Export format (md, html, json)")
367
+ parser.add_argument("--out", help="Output file path (defaults to stdout)")
368
+ parser.add_argument("--out-md", help="Shortcut to write markdown directly to specified file")
369
+ parser.add_argument("--product-name", default="Enterprise Web Application", help="Product name for the VPAT report")
370
+ parser.add_argument("--product-version", default="1.0.0", help="Product version for the VPAT report")
371
+ parser.add_argument("--gate", action="store_true", help="Exit code 1 if any Level A/AA criteria is 'Does Not Support'")
372
+
373
+ args = parser.parse_args()
374
+
375
+ violations = []
376
+
377
+ if args.input:
378
+ with open(args.input, "r", encoding="utf-8") as f:
379
+ data = json.load(f)
380
+ violations = data if isinstance(data, list) else data.get("violations", [])
381
+ elif args.html_file:
382
+ with open(args.html_file, "r", encoding="utf-8") as f:
383
+ html = f.read()
384
+ violations = audit_html_source(html)
385
+ elif args.url:
386
+ import urllib.request
387
+ req = urllib.request.Request(args.url, headers={"User-Agent": "Synapse-Hub-VPAT/4.3.1"})
388
+ with urllib.request.urlopen(req, timeout=10) as resp:
389
+ html = resp.read().decode("utf-8", errors="ignore")
390
+ violations = audit_html_source(html)
391
+
392
+ vpat_data = compile_vpat_assessment(
393
+ violations,
394
+ product_name=args.product_name,
395
+ product_version=args.product_version,
396
+ )
397
+
398
+ fmt = "md"
399
+ if args.out_md:
400
+ fmt = "md"
401
+ out_path = args.out_md
402
+ else:
403
+ fmt = args.format
404
+ out_path = args.out
405
+
406
+ if fmt == "md":
407
+ rendered = export_vpat_markdown(vpat_data)
408
+ elif fmt == "html":
409
+ rendered = export_vpat_html(vpat_data)
410
+ else:
411
+ rendered = json.dumps(vpat_data, indent=2, ensure_ascii=False)
412
+
413
+ if out_path:
414
+ with open(out_path, "w", encoding="utf-8") as f:
415
+ f.write(rendered)
416
+ print(f"✅ Exported VPAT 2.5 ({fmt.upper()}) report to {out_path}")
417
+ else:
418
+ print(rendered)
419
+
420
+ if args.gate and vpat_data["conformance_summary"]["does_not_support"] > 0:
421
+ print(f"🚨 Quality Gate Failed: {vpat_data['conformance_summary']['does_not_support']} criteria 'Does Not Support'!", file=sys.stderr)
422
+ return 1
423
+
424
+ return 0
425
+
426
+
427
+ if __name__ == "__main__":
428
+ sys.exit(main())
@@ -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.3.1",
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