@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
@@ -6,26 +6,18 @@ profiles: [playwright, full]
6
6
 
7
7
  # Mandatory Playwright Live Interaction & Swarm Protocols
8
8
 
9
- > ⚠️ **Contextual Activation Scope:** This rule is activated ONLY when `playwright.config.*` exists or when running Web / Browser E2E automation. For pure API, Mobile Appium, or Performance tests, strictly adhere to their respective rules (`stack-auto-router.md`, `mobile_appium_rules.md`, `performance_testing_rules.md`) and do not apply browser session/viewport constraints.
9
+ > ⚠️ **Contextual Activation Scope:** This rule is activated ONLY when `playwright.config.*` exists or when running Web / Browser E2E automation. For pure API, Mobile Appium, or Performance tests, strictly adhere to their respective rules (`api_testing_rules.md`, `mobile_appium_rules.md`, `performance_testing_rules.md`) and do not apply browser session/viewport constraints.
10
10
 
11
- 1. **Autonomous Swarm FSM (5 Stages):**
12
- Lead QA Orchestrator governs tasks via 5 sequential FSM stages:
13
- - **Stage 1: Discover & Design:** `live-explorer` (DOM/AOM probe) & `test-designer` (AI-RBT matrices, validation checklists, Excel suites).
14
- - **Stage 2: Craft:** `pom-crafter` (Clean POM Page Classes, `AUTO_` prefix) & `api-engineer` (OpenAPI matrices, CDC contracts, network mocks).
15
- - **Stage 3: Execute:** `test-runner` (headless CLI execution), `perf-engineer` (load profiles), & `api-engineer` (contract suites).
16
- - **Stage 4: Diagnose & Heal:** `failure-analyst` (crash diagnostics from logs/screenshots, surgical locator healing).
17
- - **Stage 5: Gatekeep:** `quality-gatekeeper` (enforces 10 Quality Gates DoD, UTF-8 No BOM, attribution integrity, zero bypasses).
18
-
19
- 2. **Anti-Redundancy Protocol:**
11
+ 1. **Anti-Redundancy Protocol:**
20
12
  - Single sign-on via Zero-Second Auth (`session.json` / `storageState`); never re-enter login forms.
21
13
  - Live Explorer emits JSON Data Contract -> Code Crafter consumes to codify. Zero redundant DOM rescanning.
22
14
  - Targeted re-tests only on failed cases; never re-run entire suites for single-case bug fixes.
23
15
  - Deep RCA only on actual FAILED cases; immediately accept PASSED runs.
24
16
 
25
- 3. **Mandatory Pure Headless Mode & Resolution Standard:**
17
+ 2. **Mandatory Pure Headless Mode & Resolution Standard:**
26
18
  - All flow discovery, live probing, and bug fixing **MUST RUN IN PURE HEADLESS MODE** (`viewport: { width: 1920, height: 1080 }`). Never open GUI browser windows to steal user focus.
27
19
 
28
- 4. **Native Playwright Assertions & Zero-Sleep Standard:**
20
+ 3. **Native Playwright Assertions & Zero-Sleep Standard:**
29
21
  - **Web-First Assertions Only:** Always utilize native auto-retrying matchers: `await expect(locator).toBeVisible()`, `await expect(locator).toBeEnabled()`, `await expect(locator).toHaveText(...)`.
30
22
  - **Zero Static Sleeps (AGENTS.md Rule 1.3):** Static delays (`page.waitForTimeout`, `time.sleep`, `Thread.sleep`) are strictly prohibited in test scripts. Synchronize via locator auto-waiting or bounded `page.waitForLoadState('networkidle')`.
31
23
  - **Clean POM Locator Hierarchy:** Page Classes must prioritize semantic locators:
@@ -36,4 +28,4 @@ profiles: [playwright, full]
36
28
  5. Resilient CSS selector
37
29
  6. Raw XPath (strictly encapsulated in Page Class; never in test scripts).
38
30
 
39
- 5. **5 Superpowers:** Zero-Second Auth (`storageState`), Direct API Seeding, Accessibility Tree (AOM), Multi-Context Dual Role, Route Mocking (`page.route`).
31
+ 4. **5 Superpowers:** Zero-Second Auth (`storageState`), Direct API Seeding, Accessibility Tree (AOM), Multi-Context Dual Role, Route Mocking (`page.route`).
@@ -10,6 +10,8 @@ policies:
10
10
  ---
11
11
  # Playwright Webapp Testing — Enterprise Server-Lifecycle Standard
12
12
 
13
+ > 💡 **Canonical Delegation Notice:** This skill is canonicalized under `e2e-testing-patterns` (`automation/shared-utils/e2e-testing-patterns/SKILL.md`). For unified multi-browser E2E lifecycle and architecture patterns, prefer delegating directly to `e2e-testing-patterns`.
14
+ >
13
15
  > **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
16
 
15
17
  ---
@@ -47,9 +47,12 @@ policies:
47
47
  - Naming convention: `TC-<Number>_<FeatureName>` (e.g. `TC-101_CreateUserAccount.groovy` or `tc-101-create-user.spec.ts`).
48
48
  2. **Unified Inheritance from `BasePage`:**
49
49
  - All Page Classes inherit from `BasePage`.
50
- 3. **Zero Raw Locators in Scripts:**
51
- - Scripts only orchestrate business workflows. All locators and UI interactions are encapsulated in Page Classes.
52
- 4. **Mandatory 100% UTF-8 No BOM:**
50
+ 3. **Zero Raw Locators in Scripts (ISO/IEC/IEEE 29119-5 Keyword-Driven Separation):**
51
+ - Scripts only orchestrate business workflows. All locators and UI interactions are encapsulated in Page Classes, strictly adhering to ISO/IEC/IEEE 29119-5 Keyword-Driven separation of business logic from technical implementation.
52
+ 4. **Clean POM Flat vs Screenplay Pattern Rationale:**
53
+ - Enforce Clean POM Flat Architecture (max 1-level shallow inheritance from `BasePage`).
54
+ - Screenplay Pattern (Actor/Task/Interaction/Ability micro-class fragmentation) is intentionally prohibited to prevent LLM Context Blowout and token waste.
55
+ 5. **Mandatory 100% UTF-8 No BOM:**
53
56
  - Zero BOM bytes (`0xEF, 0xBB, 0xBF`) across all test files.
54
57
 
55
58
  ### Phase 2: Master Locator Priority Map (6 Tiers)
@@ -156,6 +159,14 @@ Before authoring or modifying any automated test script or Page Class, pass this
156
159
  3. **Primary Boundary:** Why does existing proof miss it? Every contract belongs to one primary owner at the strongest boundary.
157
160
  4. **Zero Test-Only Seams:** Does this test require synthetic flags, wrappers, or public methods in Page Classes that have no real production caller?
158
161
 
162
+ ### Phase 8: Story-to-Script LAM Generation (Integrated from lam-script-generator)
163
+
164
+ When transforming natural language user stories and acceptance criteria into runnable tests:
165
+ 1. **World Model Decomposition:** Parse requirements into atomic user action sequences (e.g. login -> navigate -> submit -> verify).
166
+ 2. **Action Engine Mapping:** Map actions to methods in existing Clean POM Page Classes (`LoginPage`, `InvoicePage`). Do not invent ad-hoc inline locators.
167
+ 3. **Dynamic Idempotency:** Inject dynamic timestamps/unique codes (`BasePage.uniqueCode("AUTO_")`) into creation payloads with mandatory teardown.
168
+ 4. **Pure Script Synthesis:** Synthesize test scripts calling Page Class methods exclusively, with 0 raw selectors in test files.
169
+
159
170
  ---
160
171
 
161
172
  ## 4. Verification Points & DoD
@@ -38,7 +38,7 @@ Engineering standard for structuring, scaling, and maintaining large-scale End-t
38
38
 
39
39
  ---
40
40
 
41
- ### Test Pyramid & E2E Scope Boundary
41
+ ### Test Pyramid & E2E Scope Boundary (Mike Cohn Golden Ratio)
42
42
 
43
43
  ```mermaid
44
44
  flowchart TD
@@ -49,6 +49,8 @@ flowchart TD
49
49
  Unit --> Integ --> E2E
50
50
  ```
51
51
 
52
+ - **Mike Cohn's Test Pyramid Standard:** 60% Unit Tests — 30% Service/Integration/API Tests — 10% E2E UI Tests.
53
+ - **ISTQB CT-TAE Alignment:** Implements TAA (Test Automation Architecture) layered separation: Test Generation (`test-designer`), Test Definition (`pom-crafter`), Test Execution (`test-runner`), and Test Adaptation (Playwright CDP / W3C WebDriver BiDi).
52
54
  - **What belongs in E2E:** High-risk customer journeys (Sign-up, Onboarding, Checkout, File Export, Role transitions).
53
55
  - **What to avoid in E2E:** Exhaustive boundary value checks of simple form fields (delegate to Unit/API tests).
54
56
 
@@ -176,6 +178,15 @@ npx playwright test --shard=1/4 --reporter=html,junit:results.xml
176
178
 
177
179
  ---
178
180
 
181
+ ### Managed Webapp Server Lifecycle (Integrated from playwright-webapp-testing)
182
+ When tests run against local dynamic web applications:
183
+ 1. **Spawn Server:** Start local dev server in background with dynamic port allocation to prevent port collisions.
184
+ 2. **Poll Readiness:** Dynamic polling loop against health endpoint or port availability before dispatching browser.
185
+ 3. **Headless Execution:** Run Playwright headless suites at standard 1920x1080 resolution.
186
+ 4. **Guaranteed Teardown:** Execute process cleanup in `finally` / teardown block so 0 background processes linger.
187
+
188
+ ---
189
+
179
190
  ## 4. Verification Points & DoD
180
191
 
181
192
  1. Test scenarios map to critical business user journeys with explicit assertions.
@@ -10,6 +10,8 @@ policies:
10
10
  ---
11
11
  # LAM Script Generator — Large Action Model for Test Automation
12
12
 
13
+ > 💡 **Canonical Delegation Notice:** This skill is canonicalized under `clean-pom-crafter` (`automation/shared-utils/clean-pom-crafter/SKILL.md`). For unified Page Class design and script synthesis, prefer delegating directly to `clean-pom-crafter`.
14
+ >
13
15
  > **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
16
 
15
17
  ---
@@ -3,7 +3,7 @@
3
3
  [🇻🇳 Tiếng Việt](ARCHITECTURE.md) | [🇬🇧 English Edition](ARCHITECTURE.en.md)
4
4
 
5
5
  > **Scope:** Enterprise Multi-Agent QA Hub
6
- > **Version:** `4.3.1` | **Status:** Active / Production Standard
6
+ > **Version:** `4.4.1` | **Status:** Active / Production Standard
7
7
 
8
8
  ---
9
9
 
@@ -42,7 +42,7 @@ flowchart TD
42
42
 
43
43
  ## 2. Four-Tier Skill Stratification
44
44
 
45
- The 56 skills in the hub are structured into four progressive operational tiers:
45
+ The 57 skills in the hub are structured into four progressive operational tiers:
46
46
 
47
47
 
48
48
  ```mermaid
@@ -85,7 +85,7 @@ All automated test code authored, modified, or refactored by AI agents must pass
85
85
  | Gate | Title | Verifier Tool | Strict Acceptance Criteria |
86
86
  | :---: | :--- | :--- | :--- |
87
87
  | **Gate 1** | **UTF-8 No BOM Clean Encoding** | `verify_all.py` | Scans 100% of repository files; zero BOM bytes (`0xEF, 0xBB, 0xBF`) and zero mojibake errors. |
88
- | **Gate 2** | **Path Portability** | `verify_all.py` | Rejects workstation-specific absolute paths (`/Users/...`, `C:\...`); mandates root-relative resolution. |
88
+ | **Gate 2** | **Path Portability** | `verify_all.py` | Rejects workstation-specific absolute paths (e.g. user home directories, drive letters); mandates root-relative resolution. |
89
89
  | **Gate 3** | **Clean POM Flat Architecture** | `verify_all.py` | Enforces 100% locator encapsulation in Page Classes; strictly prohibits raw XPaths in test scripts. |
90
90
  | **Gate 4** | **AI Docs Anti-Drift** | `lint_ai_docs.py` | Reconciles real AST classes against `PROJECT_AI_GUIDE.md`; eliminates hallucinated PageClasses. |
91
91
  | **Gate 5** | **Temporary File Blacklist** | `verify_all.py` | Ensures zero build debris, memory dumps, or temporary sandbox databases leak into version control. |
@@ -200,3 +200,96 @@ To maintain strict engineering rigor (**Truth Anchor**), Synapse Hub discloses a
200
200
  - Node.js >= 18.0.0 (Node.js 20 or 22 LTS recommended).
201
201
  - Python >= 3.10 (fully tested on 3.10, 3.11, 3.12, 3.13, 3.15).
202
202
  - Headless browser: Playwright Chromium required for live DOM/AOM probing and self-healing locators.
203
+
204
+ ---
205
+
206
+ ## 10. Monorepo Governance & Lowest-Layer Design Axiom
207
+
208
+ Synthesized from enterprise monorepo architectures (Next.js, Cloudflare Workers-SDK, Airflow, Sentry):
209
+ 1. **Hierarchical Scoping:** Instead of a bloated 4,000-line root rules file, Synapse Hub adopts distributed scoping: root `AGENTS.md` mandates global invariants (DoD, Clean POM, UTF-8 No BOM, Zero Secret Leaks). Nested packages (`packages/*/AGENTS.md`) define scoped runners and domain tools.
210
+ 2. **Lowest-Layer Design Axiom:** Test execution and modifications are always triggered at the lowest package level possible (e.g. `pnpm test -F <package>` instead of entire workspace) to minimize blast radius and protect monorepo lockfiles.
211
+ 3. **Single Source of Truth:** `AGENTS.md` serves as the authoritative source for all AI coding agents (Claude, Cursor, Copilot, Windsurf, Antigravity). Auxiliary configurations (`.cursorrules`, `CLAUDE.md`) act as legacy symlinks or inheritance pointers.
212
+
213
+ ---
214
+
215
+ ## 11. International Standards & Industry Alignment
216
+
217
+ To fulfill enterprise compliance, audit readiness, and global QA delivery standards, Synapse Hub natively implements a comprehensive multi-pillar standard framework spanning functional test automation, performance engineering, and distributed observability:
218
+
219
+ ### 11.1 International Process & Documentation Standards: ISO/IEC/IEEE 29119 (Parts 1, 2, 3, 4, 5)
220
+ Synapse Hub directly operationalizes the ISO/IEC/IEEE 29119 series into autonomous AI agent workflows:
221
+ - **ISO/IEC/IEEE 29119-1 & 29119-2 (Concepts & Test Processes):** Embeds phased test execution via a 5-Stage Finite State Machine (Discovery → Code Synthesis → Headless Execution → Failure Autopsy → DoD Acceptance) orchestrated by the `orchestrator` subagent. Formulates Risk-Based Testing (RBT) via the `rbt-manual-testing` skill to prioritize tests based on business impact and failure likelihood.
222
+ - **ISO/IEC/IEEE 29119-3 (Test Documentation for Functional & Non-Functional):** Standardizes all test artifacts:
223
+ - *Functional Test Specification:* Standardized 12-column test case matrix (ID, Precondition, Steps, Expected, Postcondition, Risk, Automatable, Tags), exported to Excel (`tools/template_excel_exporter.py`, `tools/mcp_excel_server.py`) or Word (`tools/mcp_docx_server.py`).
224
+ - *Performance Test Plan (PTP):* Standardized non-functional test plan conforming to ISO 29119-3 (`.agents/templates/performance-test-plan-template.md`), defining test environment topology, target workloads, parameterization datasets, emergency abort criteria, and SRE SLA budgets.
225
+ - *Test Execution Report:* Polyglot test execution reporting integrating Allure Reports (`tools/generate_allure_report.py`), consolidated reports (`tools/build_consolidated_report.py`), raw JTL performance autopsy (`tools/jtl_analyzer.py`), and interactive dashboards (`tools/dashboard_generator.py`).
226
+ - **ISO/IEC/IEEE 29119-4 (Non-Functional Test Techniques):** Codifies structured load generation techniques: capacity limit verification, endurance/soak testing, spike surge testing, and step-up break-point testing via `backend-load-and-stress-patterns`.
227
+ - **ISO/IEC/IEEE 29119-5 (Keyword-Driven Testing):** Strictly decouples the Business Layer from the Technical Layer via Clean POM Flat Architecture. Facilitates keyword and script transpilation across Gherkin BDD (`tools/gherkin_suite.py`), Katalon Studio Groovy Keywords (`katalon-cli-runner`), and Universal IR (`tools/omni_transpiler.py`).
228
+
229
+ ### 11.2 Software Product Quality Model: ISO/IEC 25010:2023 (SQuaRE System)
230
+ Synapse Hub embeds the core quality characteristic **Performance Efficiency** into subagent `perf-engineer` and Gate 10 DoD verification:
231
+ - **1. Time Behaviour:** Evaluates response times, turnaround times, and throughput via linear interpolation statistical calculations for P50, P90, P95, and P99 tail percentiles, alongside Throughput (TPS/RPS) in `tools/jtl_analyzer.py` and `tools/perf/benchmark_perf_runner.py`.
232
+ - **2. Resource Utilization:** Evaluates Pearson correlation coefficients ($r \ge 0.7$) linking client response latencies directly with server resource consumption: CPU Utilization (%), RAM/JVM GC Pauses (%), Database Connection Pool Saturation, and Disk/Network I/O via `tools/telemetry_correlator.py`.
233
+ - **3. Capacity:** Determines maximum throughput and concurrency limits through step-up stress workloads, identifying degradation cliffs and scalability limits to prevent out-of-memory errors (OOM) or database pool starvation.
234
+
235
+ ### 11.3 Engineering Competency & Methodologies: ISTQB (CT-TAE & CT-PT)
236
+ Synapse Hub concurrently aligns with both Test Automation Engineering (CT-TAE) and Performance Testing (CT-PT) methodologies:
237
+ - **TAA 4-Layer Architecture (Test Automation Architecture - CT-TAE):**
238
+ 1. *Test Generation Layer:* Subagent `test-designer`, `tools/pairwise_generator.py`, `tools/generate_tc_from_story.py`, and `synthetic-test-data-generator` applying formal ISTQB techniques (EP, BVA, Decision Table, State Transition, Pairwise).
239
+ 2. *Test Definition Layer:* Subagent `pom-crafter`, `clean-pom-crafter`, and `lam-script-generator` structuring business-only workflows on Page Classes.
240
+ 3. *Test Execution Layer:* Subagent `test-runner`, `tools/verify_all.py`, parallel sharding via `tools/matrix_sharder.py`, and sandbox isolation via `tools/reversible_sandbox.py` and `tools/db_sandbox.py`.
241
+ 4. *Test Adaptation Layer:* Skill `playwright-live-interaction` communicating via CDP/BiDi, `mobile-appium-som` driving mobile devices, and `consumer-driven-contract-testing` (Pact) enforcing API contracts.
242
+ - **Performance Testing Methodology (CT-PT):**
243
+ - *Standardized 6 Workload Archetypes:* Smoke Test (1-5 VUs), Average Load Test (50-200 VUs), Stress Test (200-2,000 VUs), Spike Test (10 -> 1,000 VUs), Soak/Endurance Test (2-12h memory leak detection), and Scalability Test (evaluating linear scale-up/out elasticity).
244
+ - *Operational Profile Realism:* Models authentic user traffic with Pareto 70/20/10 distribution (`--weighted-mix`), enforces realistic user think-time (Uniform Random Timers 1s–5s), forbids socket-hammer zero think-time, and distinguishes open arrival-rate vs closed concurrency models.
245
+ - *Bottleneck Root Cause Analysis (RCA):* Isolates infrastructure degradation via `tools/telemetry_correlator.py` correlating tail latencies with database, memory, and CPU limits.
246
+
247
+ ### 11.4 Enterprise Benchmark & Transaction Standards: IEEE 829 & TPC / SPEC
248
+ - **Steady-State Measurement Discipline (TPC / SPEC Standards):**
249
+ - Inherits the measurement rigors established by TPC (Transaction Processing Performance Council) and SPEC (Standard Performance Evaluation Corporation): Enforces mandatory exclusion of warm-up and cool-down transients, evaluating SLA thresholds strictly against steady-state execution windows as codified in `.agents/rules/performance_testing_rules.md`.
250
+ - Local benchmark runner `tools/perf/benchmark_perf_runner.py` produces verifiable, deterministic transaction measurements, outputting standard JTL and k6 summary artifacts for Gate 10.
251
+
252
+ ### 11.5 Operational & Observability De Facto Standards
253
+ - **Google SRE Framework (SLA / SLO / SLI):**
254
+ - Operationalized as **Gate 10: Performance & SLA Sentinel** in `tools/verify_all.py`.
255
+ - Completely eliminates misleading average response times (Average Masking). Enforces tail latency budgets (P90, P95, P99) and max error rates (< 1.0%), autonomously halting CI/CD delivery upon SLA breaches.
256
+ - **W3C Web Performance Standards:**
257
+ - Implements W3C Navigation Timing Level 2 (`performance.getEntriesByType('navigation')`) and Resource Timing API within `web-vitals-and-performance-profiler`.
258
+ - Profiles Core Web Vitals: LCP ($\le 2.5\text{s}$), CLS ($\le 0.1$), INP ($\le 200\text{ms}$), and TTFB ($\le 800\text{ms}$) under throttled network/CPU profiles (Fast 3G, 4x CPU slowdown).
259
+ - **APM & OpenTelemetry (OTel) Distributed Tracing:**
260
+ - Injects W3C Trace Context (`traceparent` header) in load generator requests (`tools/generate_jmx_plan.py`) to maintain trace continuity across microservice architectures and APM backends (Prometheus, InfluxDB, Grafana, Jaeger).
261
+ - Produces structured markdown and JSON RCA reports conforming to OpenTelemetry semantic conventions.
262
+ - **W3C WebDriver & WebDriver BiDi / CDP:**
263
+ - Web automation harnesses Playwright event streaming directly over CDP (Chrome DevTools Protocol) and W3C WebDriver BiDi (< 200ms DOM/AOM probing in `playwright-live-interaction`).
264
+ - Prohibits static delays (`Thread.sleep`, `time.sleep`, `waitForTimeout`), mandating web-first auto-waiting and dynamic smart waits (`mandatory-playwright-live.md`).
265
+ - Mobile automation adheres strictly to the W3C WebDriver Mobile Spec via Appium (`mobile_appium_rules.md`, `mobile-appium-som`).
266
+ - Automated accessibility auditing compliant with W3C WAI WCAG 2.2 AA via `tools/wcag_audit.py` and `wcag-audit-patterns`.
267
+ - **Design Patterns — Clean POM Flat vs Screenplay:**
268
+ - *Clean Page Object Model (POM):* Mandatory invariant (Gate 3 DoD). All locators and DOM operations are encapsulated in Page Classes inheriting flatly (max 1 level) from `BasePage`. Test scripts contain 0 raw selectors.
269
+ - *Deliberate Screenplay Pattern Omission:* Screenplay Pattern decomposes scenarios across numerous micro-classes (Actor, Task, Interaction, Ability, Question). For AI agents, this creates severe **Context Blowout**, exhausts token budgets across fragmented files, and increases LLM latency. Synapse Hub adheres to the *Lean Senior Dev Protocol (YAGNI & 7-Rung Ladder)* to keep architecture flat, lean, and deterministic.
270
+ - **Mike Cohn's Test Pyramid:**
271
+ - Golden distribution ratio codified in `e2e-testing-patterns`: **60% Unit Tests — 30% Service/API Tests — 10% E2E UI Tests**.
272
+ - Subagent `api-engineer` with `consumer-driven-contract-testing` (Pact) and `api-spec-to-e2e-matrix` shifts verification left to the API layer, blocking the duplication of simple input boundary tests into brittle E2E UI suites.
273
+
274
+ ### 11.6 API Reliability & Performance Standards (Google SRE & IETF/OAS)
275
+ Synapse Hub integrates 5 comprehensive international pillars dedicated to API performance and reliability verification:
276
+ - **1. Google SRE Four Golden Signals for APIs:**
277
+ - *Latency:* Disaggregates successful latency (`p95_success_ms`) and failed latency (`p95_failed_ms`) in `tools/jtl_analyzer.py`, eliminating fast-fail HTTP 500 distortions.
278
+ - *Traffic:* Measures real-time throughput via Requests Per Second (RPS/TPS) and Network KB/s.
279
+ - *Errors:* Monitors explicit errors (HTTP 4xx/5xx) and implicit false 200s (empty body `{}` or corrupted schema intercepted by `tools/api_drift_sentinel.py` and `api-engineer`).
280
+ - *Saturation:* Measures system saturation (CPU, Memory, DB Connection Pool, Thread Pool) via `tools/telemetry_correlator.py`.
281
+ - **2. Percentile Measurement (P50/P95/P99/P99.9):**
282
+ - Strictly bans misleading Average response times. Adopts P50 (Median), P95 (Commercial SLA), and P99 / P99.9 (Tail Latency - *Google Tail at Scale*) for banking and high-concurrency e-commerce.
283
+ - **3. Tiered Industry SLA Benchmarks:**
284
+ - *Tier 1 (Read-only / Cache):* P95 $< 100\text{ms}$, P99 $< 200\text{ms}$, Error $< 0.01\%$.
285
+ - *Tier 2 (Standard CRUD / Indexed Search):* P95 $< 500\text{ms}$, P99 $< 1,000\text{ms}$, Error $< 0.1\%$.
286
+ - *Tier 3 (Complex / Payment / Aggregation):* P95 $< 2,000\text{ms}$, P99 $< 3,000\text{ms}$, Error $< 0.1\%$.
287
+ - *Tier 4 (Async / Batch):* Returns HTTP 202 Accepted in $< 200\text{ms}$, P99 $< 500\text{ms}$, Error $< 0.01\%$.
288
+ - **4. Technical Protocols (IETF, OpenAPI & CNCF gRPC):**
289
+ - *RFC 9110 / 9112 / 9113:* Optimizes Keep-Alive, connection pooling, compression (Gzip/Brotli), and TTFB budgets.
290
+ - *OpenAPI OAS 3.0 / 3.1:* Validates API contracts, detects Schema Drift, and prevents over-fetching bandwidth waste.
291
+ - *gRPC / Protobuf (CNCF):* Benchmarks binary RPC communication with $5\times - 10\times$ lower latency expectations vs REST/JSON (P99 $< 50\text{ms}$).
292
+ - **5. Distributed Architectural Guardrails:**
293
+ - *Rate Limiting & Throttling (RFC 6585):* Enforces HTTP 429 Too Many Requests with `Retry-After` header under surge load instead of crashing with 500/502 (mocked via `tools/network_mock_shield.py` and probed by `tools/api_fuzzer.py`).
294
+ - *Timeout & Circuit Breaker:* Mandates $3\text{s} - 5\text{s}$ connection cutoffs and circuit breakers to prevent thread pool starvation.
295
+ - *Database Connection Pool Saturation:* Audits connection limits (HikariCP / pgpool) and detects connection leaks under peak traffic.
@@ -3,7 +3,7 @@
3
3
  [🇻🇳 Tiếng Việt](ARCHITECTURE.md) | [🇬🇧 English Edition](ARCHITECTURE.en.md)
4
4
 
5
5
  > **Phạm vi:** Enterprise Multi-Agent QA Hub
6
- > **Version:** `4.3.1` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
6
+ > **Version:** `4.4.1` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
7
7
  > **Tác giả:** Thế Vị (@TeeVee98) | **Giấy phép:** MIT License
8
8
 
9
9
  ---
@@ -43,7 +43,7 @@ flowchart TD
43
43
 
44
44
  ## 2. 4 Phân Tầng Kỹ Năng Trong Hub (4-Tier Skill Stratification)
45
45
 
46
- 53 kỹ năng QA trong Hub được phân chia thành 4 tầng rõ rệt:
46
+ 57 kỹ năng QA trong Hub được phân chia thành 4 tầng rõ rệt:
47
47
 
48
48
 
49
49
  ```mermaid
@@ -86,7 +86,7 @@ Trước khi commit code hoặc merge Pull Request, toàn bộ mã kiểm thử
86
86
  | Cổng | Tên Cổng | Công Cụ Kiểm Tra | Tiêu Chuẩn Vượt Qua (DoD) |
87
87
  | :---: | :--- | :--- | :--- |
88
88
  | **Gate 1** | **Chuẩn Mã Hóa UTF-8 No BOM** | `verify_all.py` | 100% file không chứa ký tự BOM rác (`0xEF, 0xBB, 0xBF`), không vỡ font trên Linux/CI. |
89
- | **Gate 2** | **Đường Dẫn Linh Hoạt (Path Portability)** | `verify_all.py` | Cấm hardcode đường dẫn máy cá nhân (`/Users/...`, `C:\...`); bắt buộc dùng path tương đối. |
89
+ | **Gate 2** | **Đường Dẫn Linh Hoạt (Path Portability)** | `verify_all.py` | Cấm hardcode đường dẫn máy cá nhân (như thư mục người dùng, ổ đĩa tuyệt đối); bắt buộc dùng path tương đối. |
90
90
  | **Gate 3** | **Kiến Trúc Clean POM (Flat Architecture)** | `verify_all.py` | 100% selector nằm trong Page Class; cấm triệt để selector thô trong file test. |
91
91
  | **Gate 4** | **Chống AI Bịa Đặt (Anti-Drift Linter)** | `lint_ai_docs.py` | Đối chiếu tài liệu với AST thực tế; cấm AI nhắc tới PageClass hay hàm không tồn tại. |
92
92
  | **Gate 5** | **Chặn File Rác Lọt Vào Git** | `verify_all.py` | Cấm commit file tạm, file dump bộ nhớ hay log rác (`*.tmp`, `.ruff_cache`, heap dump). |
@@ -210,3 +210,87 @@ Học hỏi từ các monorepo quy mô toàn cầu (Next.js, Cloudflare Workers-
210
210
  1. **Phân Tầng Đa Cấp (Hierarchical Scoping):** Thay vì duy trì một tệp quy tắc 4,000 dòng cồng kềnh tại thư mục gốc, hệ thống áp dụng mô hình phân tán: tệp `AGENTS.md` gốc chỉ định các bất biến toàn cục (DoD, Clean POM, UTF-8 No BOM, Zero Secret Leaks). Các package con (`packages/*/AGENTS.md`) chịu trách nhiệm về tooling, runner và phạm vi kiểm thử hẹp tương ứng.
211
211
  2. **Nguyên Lý Thiết Kế Tầng Thấp Nhất (Lowest-Layer Design Axiom):** Khi thực hiện kiểm thử hoặc sửa đổi mã nguồn trong kiến trúc monorepo, quy tắc và test command luôn được kích hoạt tại package thấp nhất có thể (ví dụ: `pnpm test -F <package>` thay vì chạy toàn bộ workspace) nhằm giảm thiểu bán kính rủi ro (blast radius) và bảo vệ lockfile monorepo.
212
212
  3. **Nguồn Chân Lý Duy Nhất (Single Source of Truth):** `AGENTS.md` là nguồn chân lý duy nhất cho toàn bộ AI coding agents (Claude, Cursor, Copilot, Windsurf, Antigravity). Các cấu hình khác (`.cursorrules`, `CLAUDE.md`) chỉ đóng vai trò symlink hoặc con trỏ kế thừa.
213
+
214
+ ---
215
+
216
+ ## 11. Chuẩn Hóa Quốc Tế & Kiến Trúc Kiểm Thử (International Standards & Industry Alignment)
217
+
218
+ Để đáp ứng các yêu cầu kiểm toán doanh nghiệp, đánh giá chất lượng và quy chuẩn bàn giao phần mềm quốc tế, Synapse Hub tích hợp đầy đủ hệ thống tiêu chuẩn kiểm thử tự động và kiểm thử hiệu năng toàn diện:
219
+
220
+ ### 11.1 Chuẩn Quy Trình & Tài Liệu Quốc Tế: ISO/IEC/IEEE 29119 (Phần 1, 2, 3, 4, 5)
221
+ Synapse Hub hiện thực hóa trực tiếp bộ tiêu chuẩn quốc tế ISO/IEC/IEEE 29119 vào luồng vận hành của AI:
222
+ - **ISO/IEC/IEEE 29119-1 & 29119-2 (Khái niệm & Quy trình kiểm thử):** Tích hợp quy trình kiểm thử theo giai đoạn thông qua cỗ máy trạng thái hữu hạn 5 bước (5-Stage FSM: Discovery → Code Synthesis → Headless Execution → Failure Autopsy → DoD Acceptance) do subagent `orchestrator` làm nhạc trưởng. Áp dụng kỹ thuật kiểm thử dựa trên rủi ro (Risk-Based Testing - RBT) tại skill `rbt-manual-testing` để phân bổ trọng số kiểm thử dựa trên tác động nghiệp vụ và khả năng xảy ra lỗi.
223
+ - **ISO/IEC/IEEE 29119-3 (Tài liệu kiểm thử chức năng & phi chức năng):** Chuẩn hóa toàn bộ cấu trúc tài liệu test:
224
+ - *Đặc tả kiểm thử chức năng (Functional Test Specification):* Ma trận test case 12 cột chuẩn quốc tế (ID, Precondition, Steps, Expected, Postcondition, Risk, Automatable, Tags), xuất ra định dạng Excel (`tools/template_excel_exporter.py`, `tools/mcp_excel_server.py`) hoặc Word (`tools/mcp_docx_server.py`).
225
+ - *Kế hoạch kiểm thử hiệu năng (Performance Test Plan - PTP):* Biểu mẫu chuẩn hóa theo ISO 29119-3 cho Non-Functional Testing (`.agents/templates/performance-test-plan-template.md`), xác định rõ cấu hình môi trường, tải mục tiêu, dữ liệu tham số hóa, tiêu chí dừng khẩn cấp và ngân sách SLA.
226
+ - *Báo cáo thực thi kiểm thử (Test Execution Report):* Báo cáo kiểm thử đa nền tảng, tích hợp Allure Report (`tools/generate_allure_report.py`), báo cáo tổng hợp (`tools/build_consolidated_report.py`), phân tích kết quả tải JTL (`tools/jtl_analyzer.py`) và bảng điều khiển trực quan (`tools/dashboard_generator.py`).
227
+ - **ISO/IEC/IEEE 29119-4 (Kỹ thuật kiểm thử phi chức năng):** Áp dụng các kỹ thuật kiểm thử tải có cấu trúc: phân tích giới hạn chịu tải, kiểm thử độ dẻo dai (Endurance/Soak), kiểm thử đột biến (Spike) và kiểm thử bước nhảy tải (Step-up stress testing) thông qua skill `backend-load-and-stress-patterns`.
228
+ - **ISO/IEC/IEEE 29119-5 (Kiểm thử theo từ khóa - Keyword-Driven Testing):** Tách biệt triệt để lớp nghiệp vụ (Business Layer) và lớp mã kỹ thuật (Technical Layer) qua chuẩn kiến trúc Clean POM Flat Architecture. Hỗ trợ chuyển đổi từ khóa kịch bản qua Gherkin BDD (`tools/gherkin_suite.py`), Groovy Keywords của Katalon Studio (`katalon-cli-runner`) và bộ chuyển ngữ Universal IR (`tools/omni_transpiler.py`).
229
+
230
+ ### 11.2 Chuẩn Mô Hình Chất Lượng Phần Mềm: ISO/IEC 25010:2023 (Hệ thống SQuaRE)
231
+ Synapse Hub tích hợp trực tiếp đặc tính chất lượng **Hiệu Năng & Độ Hiệu Quả (Performance Efficiency)** của chuẩn ISO/IEC 25010 vào subagent `perf-engineer` và hệ thống cổng kiểm soát Gate 10:
232
+ - **1. Hành vi thời gian (Time Behaviour):** Đo lường chi tiết thời gian phản hồi (Response Time), độ trễ phân vị đuôi (Tail Latency P50, P90, P95, P99), thời gian xử lý và thông lượng giao dịch (Throughput TPS/RPS) thông qua bộ máy phân tích nội suy tuyến tính `tools/jtl_analyzer.py` và `tools/perf/benchmark_perf_runner.py`.
233
+ - **2. Tận dụng tài nguyên (Resource Utilization):** Giám sát và đánh giá hệ số tương quan tuyến tính Pearson ($r \ge 0.7$) giữa độ trễ client với mức độ tiêu hao tài nguyên máy chủ: CPU Utilization (%), RAM/JVM GC Pauses (%), Database Connection Pool Saturation, Disk I/O và Network Throughput qua `tools/telemetry_correlator.py`.
234
+ - **3. Giới hạn dung lượng (Capacity):** Đo lường giới hạn chịu tải cực đại của hệ thống thông qua các kịch bản Stress Testing (bước tải Step-up), xác định điểm sập (Degradation Cliff) và năng lực co giãn (Scalability Envelope) để đảm bảo không xảy ra hiện tượng tràn bộ nhớ JVM (OOM) hay rò rỉ kết nối cơ sở dữ liệu.
235
+
236
+ ### 11.3 Chuẩn Năng Lực & Phương Pháp Luận Chuyên Sâu: ISTQB (CT-TAE & CT-PT)
237
+ Synapse Hub chuẩn hóa song hành theo cả hai phương pháp luận Test Automation Engineering (CT-TAE) và Performance Testing (CT-PT):
238
+ - **Kiến trúc TAA 4 Phân Tầng (Test Automation Architecture - CT-TAE):**
239
+ 1. *Test Generation Layer:* Subagent `test-designer`, tool `tools/pairwise_generator.py`, `tools/generate_tc_from_story.py`, skill `synthetic-test-data-generator` áp dụng các kỹ thuật ISTQB chính quy (EP, BVA, Decision Table, State Transition, Pairwise).
240
+ 2. *Test Definition Layer:* Subagent `pom-crafter`, skill `clean-pom-crafter`, `lam-script-generator` xây dựng kịch bản thuần logic nghiệp vụ trên Page Class.
241
+ 3. *Test Execution Layer:* Subagent `test-runner`, tool `tools/verify_all.py`, phân mảnh song song qua `tools/matrix_sharder.py`, kiểm soát trạng thái sandbox qua `tools/reversible_sandbox.py` và `tools/db_sandbox.py`.
242
+ 4. *Test Adaptation Layer:* Skill `playwright-live-interaction` giao tiếp CDP/BiDi với trình duyệt, `mobile-appium-som` điều khiển thiết bị di động, và `consumer-driven-contract-testing` (Pact) chặn kiểm thử hợp đồng API.
243
+ - **Phương pháp luận kiểm thử hiệu năng thực chiến (CT-PT):**
244
+ - *Chuẩn hóa 6 Archetypes kiểm thử tải:* Smoke Test (1-5 VUs), Average Load Test (50-200 VUs), Stress Test (200-2,000 VUs), Spike Test (10 -> 1,000 VUs đột biến), Soak/Endurance Test (2-12h phát hiện rò rỉ bộ nhớ), và Scalability Test (đo lường tính co giãn tuyến tính Scale-Up & Scale-Out).
245
+ - *Hồ sơ vận hành thực tế (Operational Profile):* Mô hình hóa lưu lượng thực với tỷ lệ phân bổ Pareto 70/20/10 (`--weighted-mix`), giả lập thời gian suy nghĩ người dùng thực tế (Uniform Random Timers 1s–5s), chống fake think-time, phân tách rõ mô hình mở (Arrival-Rate) và mô hình đóng (Closed Concurrency).
246
+ - *Chẩn đoán điểm nghẽn (Bottleneck Root Cause Analysis):* Cô lập chính xác nguyên nhân gây suy giảm hiệu năng bằng `tools/telemetry_correlator.py` dựa trên tương quan độ trễ và tài nguyên máy chủ.
247
+
248
+ ### 11.4 Chuẩn Benchmark & Đo Lường Giao Dịch Doanh Nghiệp: IEEE 829 & TPC / SPEC
249
+ - **Nguyên tắc đo lường trạng thái ổn định (TPC / SPEC Measurement Discipline):**
250
+ - Kế thừa tiêu chuẩn đo lường khắt khe của TPC (Transaction Processing Performance Council) và SPEC (Standard Performance Evaluation Corporation): Đánh giá SLA bắt buộc loại trừ giai đoạn làm nóng (Warm-up transient) và hạ tải (Cool-down), chỉ đo đạc các chỉ số hiệu năng trong trạng thái ổn định (Steady-State Interval) được quy định rõ tại `.agents/rules/performance_testing_rules.md`.
251
+ - Bộ công cụ benchmark nội bộ chuẩn hóa `tools/perf/benchmark_perf_runner.py` cung cấp kết quả đo lường giao dịch thực tế, sinh các tệp bằng chứng chuẩn JTL và k6 summary cho Gate 10.
252
+
253
+ ### 11.5 Chuẩn Vận Hành Thực Chiến & Quan Sát Hiện Đại (De Facto Standards)
254
+ - **Google SRE Framework (SLA / SLO / SLI):**
255
+ - Hiện thực hóa thành **Gate 10: Performance & SLA Sentinel** trong `tools/verify_all.py`.
256
+ - Triệt tiêu hoàn toàn báo cáo bằng thời gian trung bình (Average Masking). Bắt buộc thiết lập ngân sách độ trễ P90/P95/P99 và tỷ lệ lỗi tối đa cho phép (< 1.0%), tự động chặn triển khai mã nếu vi phạm ngưỡng cam kết dịch vụ.
257
+ - **Chuẩn hiệu năng W3C Web Performance Standards:**
258
+ - Áp dụng W3C Navigation Timing Level 2 (`performance.getEntriesByType('navigation')`) và Resource Timing API trong skill `web-vitals-and-performance-profiler`.
259
+ - Giám sát toàn diện Google Core Web Vitals: LCP ($\le 2.5\text{s}$), CLS ($\le 0.1$), INP ($\le 200\text{ms}$) và TTFB ($\le 800\text{ms}$) dưới các profile giả lập mạng/CPU (Fast 3G, 4x CPU slowdown).
260
+ - **Chuẩn giám sát APM & OpenTelemetry (OTel):**
261
+ - Tích hợp chuẩn ngữ cảnh truy vết phân tán W3C Trace Context (`traceparent` header) vào các kịch bản JMeter/k6 được sinh bởi `tools/generate_jmx_plan.py` để liên kết thông suốt từ luồng bắn tải sang hạ tầng APM (Prometheus, InfluxDB, Grafana, Jaeger).
262
+ - Xuất báo cáo chẩn đoán nguyên nhân gốc (RCA) tương thích cấu trúc OpenTelemetry.
263
+ - **W3C WebDriver & WebDriver BiDi / CDP:**
264
+ - Web Automation dựa trên nền tảng Playwright kết nối trực tiếp qua giao thức sự kiện DOM/AOM <200ms của CDP (Chrome DevTools Protocol) và W3C WebDriver BiDi (`playwright-live-interaction`).
265
+ - Nghiêm cấm static sleep (`Thread.sleep`, `time.sleep`, `waitForTimeout`), bắt buộc sử dụng web-first auto-waiting và dynamic smart wait (`mandatory-playwright-live.md`).
266
+ - Mobile Automation tuân thủ đặc tả chuẩn W3C WebDriver Mobile Spec qua Appium (`mobile_appium_rules.md`, `mobile-appium-som`).
267
+ - Kiểm toán khả năng tiếp cận chuẩn W3C WAI WCAG 2.2 AA tự động qua `tools/wcag_audit.py` và skill `wcag-audit-patterns`.
268
+ - **Design Patterns — Clean POM Flat vs Screenplay:**
269
+ - *Clean Page Object Model (POM):* Tiêu chuẩn thiết kế bắt buộc cấp độ Invariant (Gate 3 DoD). Toàn bộ locator và thao tác DOM đóng gói 100% trong Page Class kế thừa phẳng 1 cấp từ `BasePage`. Test script không chứa bất kỳ raw selector nào.
270
+ - *Lý do loại trừ Screenplay Pattern:* Screenplay Pattern chia nhỏ kịch bản thành quá nhiều class (Actor, Task, Interaction, Ability, Question). Đối với tác tử AI (LLM Agent), cấu trúc phân mảnh này gây ra hiện tượng phình ngữ cảnh (**Context Blowout**), tiêu tốn hàng nghìn token vô ích khi đọc hàng chục file nhỏ và làm tăng độ trễ suy luận. Hub áp dụng nguyên lý *Lean Senior Dev Protocol (YAGNI & 7-Rung Ladder)* để giữ kiến trúc phẳng, tinh gọn và hiệu năng cao nhất.
271
+ - **Kim Tự Tháp Kiểm Thử (Mike Cohn's Test Pyramid):**
272
+ - Tỷ lệ phân bổ vàng được chuẩn hóa tại skill `e2e-testing-patterns`: **60% Unit Test — 30% Service/API Test — 10% E2E UI Test**.
273
+ - Subagent `api-engineer` cùng kỹ năng `consumer-driven-contract-testing` (Pact) và `api-spec-to-e2e-matrix` đảm nhận vai trò chốt chặn dịch chuyển sang trái (shift-left) tại tầng API, nghiêm cấm nhân bản các ca kiểm thử biên đơn giản lên tầng E2E UI.
274
+
275
+ ### 11.6 Chuẩn Đo Lường & Kiến Trúc Kiểm Thử API (Google SRE & IETF/OAS)
276
+ Synapse Hub tích hợp đầy đủ 5 trụ cột tiêu chuẩn quốc tế dành riêng cho kiểm thử và đánh giá độ tin cậy của API:
277
+ - **1. Google SRE Four Golden Signals cho API:**
278
+ - *Latency:* Phân tách độc lập độ trễ của request thành công (`p95_success_ms`) và request lỗi (`p95_failed_ms`) trong `tools/jtl_analyzer.py`, triệt tiêu hoàn toàn hiện tượng fast-fail HTTP 500 làm giảm độ trễ ảo.
279
+ - *Traffic:* Đo lường lưu lượng tải thực tế qua Throughput (RPS/TPS) và Network KB/s.
280
+ - *Errors:* Giám sát cả lỗi tường minh (HTTP 4xx/5xx) và lỗi ngầm định (HTTP 200 trả về payload rỗng `{}` hoặc sai schema được chặn bởi `tools/api_drift_sentinel.py` và invariant của `api-engineer`).
281
+ - *Saturation:* Đo lường độ bão hòa tài nguyên hệ thống (CPU, Memory, DB Connection Pool, Thread Pool) qua `tools/telemetry_correlator.py`.
282
+ - **2. Đo Lường Theo Phân Vị (Percentiles P50/P95/P99/P99.9):**
283
+ - Nghiêm cấm dùng giá trị trung bình (Average) che giấu điểm nghẽn. Áp dụng chuẩn P50 (Median), P95 (SLA thương mại), P99 và P99.9 (Tail Latency - *Google Tail at Scale*) cho các giao dịch ngân hàng và thương mại điện tử.
284
+ - **3. Khung Ngưỡng Phản Hồi API Chuẩn Ngành (Tiered Industry SLA Benchmarks):**
285
+ - *Tier 1 (Read-only / Cache):* P95 $< 100\text{ms}$, P99 $< 200\text{ms}$, Error $< 0.01\%$.
286
+ - *Tier 2 (Standard CRUD / Search có index):* P95 $< 500\text{ms}$, P99 $< 1,000\text{ms}$, Error $< 0.1\%$.
287
+ - *Tier 3 (Complex / Payment / Aggregation):* P95 $< 2,000\text{ms}$, P99 $< 3,000\text{ms}$, Error $< 0.1\%$.
288
+ - *Tier 4 (Async / Batch):* Trả về HTTP 202 Accepted trong $< 200\text{ms}$, P99 $< 500\text{ms}$, Error $< 0.01\%$.
289
+ - **4. Tiêu Chuẩn Giao Thức Kỹ Thuật (IETF, OpenAPI & CNCF gRPC):**
290
+ - *RFC 9110 / 9112 / 9113:* Tối ưu Keep-Alive, HTTP Connection Pooling, nén dữ liệu (Gzip/Brotli) và kiểm soát TTFB.
291
+ - *OpenAPI Specification (OAS 3.0 / 3.1):* Thẩm định hợp đồng API, kiểm soát kích thước payload chống Over-fetching và phát hiện Schema Drift.
292
+ - *gRPC / Protobuf (CNCF):* Đo lường hiệu năng giao tiếp nhị phân nội bộ (Microservices RPC) với kỳ vọng giảm độ trễ $5\times - 10\times$ so với REST/JSON (P99 $< 50\text{ms}$).
293
+ - **5. Kiểm Thử Cơ Chế Bảo Vệ Kiến Trúc Phân Tán:**
294
+ - *Rate Limiting & Throttling (RFC 6585):* Bắt buộc trả về đúng mã HTTP 429 Too Many Requests kèm header `Retry-After` khi quá tải thay vì sập 500/502 (được giả lập bởi `tools/network_mock_shield.py` và kiểm thử bởi `tools/api_fuzzer.py`).
295
+ - *Timeout & Circuit Breaker:* Thiết lập ngưỡng ngắt kết nối $3\text{s} - 5\text{s}$ và cơ chế ngắt mạch tự động chống cạn kiệt Thread Pool.
296
+ - *Database Connection Pool Saturation:* Kiểm toán giới hạn kết nối mở tới CSDL (HikariCP / pgpool), chống rò rỉ kết nối (Connection Leak) khi lưu lượng đạt đỉnh.
@@ -1,7 +1,7 @@
1
1
  # Synapse Hub — Tooling Ecosystem Catalog & Runbook
2
2
 
3
3
  > **Audience:** QA Engineers, Autonomous AI Agents (Lead Orchestrator, POM-Crafter, Test-Runner, Failure-Analyst, Quality-Gatekeeper).
4
- > **Total Tools Cataloged:** `130` | **Stable:** `130` | **Experimental:** `0`
4
+ > **Total Tools Cataloged:** `142` | **Stable:** `142` | **Experimental:** `0`
5
5
 
6
6
  ## 1. Primary Enterprise CLI Tools
7
7
 
@@ -10,10 +10,13 @@
10
10
  | `python tools/_openapi_parser.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/_openapi_parser.py — Shared OpenAPI & Swagger Specification Parser |
11
11
  | `python tools/agent_canary.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | ENTERPRISE AUTONOMOUS AGENT Canary & Mutation Testing Arena |
12
12
  | `python tools/agentless_patcher.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `modifying` | Agentless 3-Stage Deterministic Patcher (OpenAutoCoder Agentless Pattern) |
13
+ | `python tools/ai_eval_sentinel.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/ai_eval_sentinel.py — Enterprise RAG & LLM Evaluation Sentinel (NIST AI RMF & ISO 42001) |
13
14
  | `python tools/analyze_project.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Comprehensive health audit analyzing environment, POM structure, and Quality Gates. |
14
15
  | `python tools/api_drift_sentinel.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Detects contract drift and breaking schema mutations against OpenAPI specifications. |
15
16
  | `python tools/api_fuzzer.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Autonomous API Fuzzing & Chaos Breaker |
17
+ | `python tools/assertion_optimizer.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/assertion_optimizer.py — Unified Assertion Optimization & Tuning Suite |
16
18
  | `python tools/ast_cache.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/ast_cache.py — AST Dataflow Pre-Validation Cache (Boost B3) |
19
+ | `python tools/asvs_auditor.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/asvs_auditor.py — OWASP Application Security Verification Standard (ASVS 4.0.3) Engine |
17
20
  | `python tools/author_integrity.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/author_integrity.py — Author Attribution & Repository Provenance Guard |
18
21
  | `python tools/auto_heal.py` | **Failure Autopsy & Healing** | `failure-analyst` | 🟢 Stable | `modifying` | Closed-loop locator self-healing engine matching broken selectors against DOM/AOM. |
19
22
  | `python tools/auto_heal_reflexion.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `modifying` | Multi-Trial Episodic Reflexion Loop for Autonomous Healing (Noah Shinn / Reflexion Pattern) |
@@ -22,18 +25,19 @@
22
25
  | `python tools/break_ui_generator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/break_ui_generator.py — Edge-Case UI Stress Testing Data Generator |
23
26
  | `python tools/browsergym_eval.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | BrowserGym Web Agent Benchmark Harness (BrowserGym / WebArena Pattern) |
24
27
  | `python tools/bug_reporter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Auto-Bug Reporter & Root Cause Analysis (RCA) Ticket Generator |
25
- | `python tools/build_consolidated_report.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/build_consolidated_report.py — Generate Unified Top 20 Skills & Agents Evaluation Report |
26
28
  | `python tools/bump_version.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `modifying` | tools/bump_version.py — Atomic Universal Version Bumper for Synapse Hub |
27
29
  | `python tools/cache_resolver.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Local Semantic Memory Cache & Self-Healing Resolver |
30
+ | `python tools/chaos_resilience_probe.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/chaos_resilience_probe.py — Enterprise Chaos Engineering & Reliability Sentinel |
28
31
  | `python tools/check_env.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | ============================================================================== |
29
32
  | `python tools/check_version_sync.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `modifying` | tools/check_version_sync.py — Version Synchronization Sentinel for Synapse Hub |
30
33
  | `python tools/ci_healing_hook.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `modifying` | CI/CD Silent Self-Healing Pipeline Hook |
34
+ | `python tools/cldr_l10n_verifier.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/cldr_l10n_verifier.py — Enterprise Unicode CLDR & L10n/I18n Verification Engine |
31
35
  | `python tools/cli.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Agent-QA CLI Entrypoint |
32
36
  | `python tools/config_decoupler.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Environment & Secret Decoupling Engine |
33
37
  | `python tools/contract_validator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Swarm Data Contract Validator (Single Front-Door Integrity Guard) |
34
38
  | `python tools/count_tokens.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Cross-Platform Token & Cost Auditor (Synapse-Hub) |
35
39
  | `python tools/coverage_reporter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/coverage_reporter.py — Standardized Coverage Metrics & Roadmap Evaluator |
36
- | `python tools/create_mock_docx.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Generates a lightweight valid mock DOCX fixture (< 20 KB) for OpenXML Guard / Word reader tests. |
40
+ | `python tools/cvss_calculator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/cvss_calculator.py — Enterprise Common Vulnerability Scoring System Engine |
37
41
  | `python tools/dashboard_generator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/dashboard_generator.py — Standalone One-Page Enterprise QA HTML Dashboard |
38
42
  | `python tools/db_sandbox.py` | **Sandboxing & Isolation** | `failure-analyst` | 🟢 Stable | `modifying` | Database state isolation sentinel with granular consent-governed snapshot and purge capabilities. |
39
43
  | `python tools/debt_harvester.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/debt_harvester.py — Technical Debt & Shortcut Harvester |
@@ -42,6 +46,7 @@
42
46
  | `python tools/distill_skill.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `destructive` | tools/distill_skill.py — Dual-Skill Distillation Engine |
43
47
  | `python tools/dspy_qa_signatures.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Declarative QA Signature Compilation Engine (Stanford DSPy Pattern) |
44
48
  | `python tools/e2e_flow_prober.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise E2E Flow Prober & XPath Crawler Dispatcher (Cross-Platform) |
49
+ | `python tools/etl_data_reconciler.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/etl_data_reconciler.py — Enterprise Data Quality & ETL Reconciliation Engine |
45
50
  | `python tools/export_postman_collection.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Exports API test matrices into runnable Postman Collections with pre-request scripts. |
46
51
  | `python tools/flaky_detector.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Flaky Test Detector & Quarantine Sentinel |
47
52
  | `python tools/fsm_enforcer.py` | **Orchestration** | `orchestrator` | 🟢 Stable | `modifying` | 5-Stage QA Multi-Agent Finite State Machine enforcer with cryptographic proof tokens. |
@@ -78,8 +83,10 @@
78
83
  | `python tools/mechanical_ui_gate.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/mechanical_ui_gate.py — Headless Chrome Mechanical Layout & Contrast Gate |
79
84
  | `python tools/micro_mutator.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Syntactic micro-mutation sentinel eliminating tautological tests and measuring assertion sensitivity. |
80
85
  | `python tools/mipro_assertion_tuner.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | MIPROv2 Prompt Assertion Tuner (Stanford DSPy v2 & Optuna TPE Pattern) |
86
+ | `python tools/mobile_resilience_sentinel.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/mobile_resilience_sentinel.py — Mobile Hardware Interrupts, MASVS & HIG Sentinel |
81
87
  | `python tools/network_mock_shield.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `modifying` | Network interception shield stubbing external routes and injecting chaos network faults. |
82
88
  | `python tools/newman_analyzer.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Sub-0.1s Postman/Newman JSON test report analyzer enforcing CI/CD quality gates. |
89
+ | `python tools/observability_tester.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/observability_tester.py — OpenTelemetry Trace & Log Hygiene Verification Sentinel |
83
90
  | `python tools/omni_emitter.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `read_only` | Universal polyglot code generator emitting Clean POM Flat Architecture scripts. |
84
91
  | `python tools/omni_parser.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `read_only` | Deterministic 0-token polyglot AST parser extracting Page Classes and test workflows. |
85
92
  | `python tools/omni_transpiler.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `modifying` | Instant 0-token transpiler between Playwright, Selenium, and Katalon. |
@@ -87,14 +94,17 @@
87
94
  | `python tools/output_formatter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Standardized Output Formatter & Exit Code Specification |
88
95
  | `python tools/package_release.py` | **CI/CD & Packaging** | `orchestrator` | 🟢 Stable | `modifying` | Enterprise release packager preserving .github/workflows and generating SHA-256 provenance. |
89
96
  | `python tools/pairwise_generator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/pairwise_generator.py — Pairwise (2-Way) Combinatorial Test Case Generator |
97
+ | `python tools/payment_interop_simulator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/payment_interop_simulator.py — ISO 8583 & Financial Gateway Interoperability Sentinel |
90
98
  | `python tools/pentest_scope_guard.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/pentest_scope_guard.py — Enterprise Pentest Scope & DAST Runtime Guard |
91
99
  | `python tools/pinpoint_failure.py` | **Failure Autopsy & Healing** | `failure-analyst` | 🟢 Stable | `read_only` | Sub-0.1s JUnit XML autopsy parser diagnosing test crashes without LLM token waste. |
100
+ | `python tools/pre_push_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `modifying` | Pre-Push Quality & Anti-Hallucination Guard (Multi-Session Audit) |
92
101
  | `python tools/project_state.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Project State Machine & Token-Capped Memory Anchor |
93
102
  | `python tools/qa_event_stream.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Immutable QA Event Stream Engine (OpenHands EventStream Pattern) |
103
+ | `python tools/regulatory_compliance.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/regulatory_compliance.py — Enterprise Regulatory & Compliance Audit Sentinel |
94
104
  | `python tools/repo_map.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Repository Map Compressor (Inspired by Aider-AI/aider) |
95
105
  | `python tools/reversible_sandbox.py` | **Sandboxing & Isolation** | `failure-analyst` | 🟢 Stable | `modifying` | Two-phase commit write-ahead logging (WAL) execution sandbox providing crash-resilient rollback guarantees. |
96
106
  | `python tools/rules_router.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/rules_router.py — Progressive Rules Router & Context Optimizer (Boost B2) |
97
- | `python tools/runaway_stopper.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/runaway_stopper.py — Agent Runaway & Token Loop Sentinel |
107
+ | `python tools/runaway_stopper.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/runaway_stopper.py — Agent Runaway & Token Loop Sentinel (Stub / Re-export) |
98
108
  | `python tools/safety_firewall.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Non-bypassable safety firewall blocking destructive operations (drop database, git push force, rm -rf). |
99
109
  | `python tools/security_coverage_ledger.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Mathematical Security Coverage Ledger & Audit Tracker |
100
110
  | `python tools/security_scanner.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Comprehensive enterprise security sentinel auditing Python & NPM dependencies and threat-model defense. |
@@ -119,6 +129,7 @@
119
129
  | `python tools/test_impact.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Test Impact Analyzer (Graphify AST-Powered) |
120
130
  | `python tools/test_memory_os.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Hierarchical QA Test Memory OS (Letta / MemGPT Pattern) |
121
131
  | `python tools/textgrad_mutation_optimizer.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Mutant-Directed Textual Loss Optimizer (Deterministic TextGrad-Style Heuristic) |
132
+ | `python tools/tmmi_auditor.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/tmmi_auditor.py — Enterprise TMMi (Test Maturity Model integration) Assessment Sentinel |
122
133
  | `python tools/tms_sync_bridge.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `modifying` | Enterprise ALM & TMS Sync Bridge (Jira / Xray / Zephyr / TestRail) |
123
134
  | `python tools/token_telemetry.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/token_telemetry.py — Live LLM Token & MTTR Telemetry Engine |
124
135
  | `python tools/tot_exploratory_tester.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `read_only` | Tree-of-Thoughts exploratory scenario generator with risk scoring and boundary decomposition. |
@@ -134,6 +145,7 @@
134
145
  | `python tools/verify_all.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | One-command 10 Quality Gates Definition of Done (DoD) verification sentinel. |
135
146
  | `python tools/visual_diff_canvas.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Canvas Visual Diff & Regression Checker |
136
147
  | `python tools/visual_som_helper.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Vision-Grounded Fallback & Set-of-Marks (SoM) Engine |
148
+ | `python tools/vpat_exporter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/vpat_exporter.py — Enterprise Section 508 & EN 301 549 VPAT Report Generator |
137
149
  | `python tools/watch_mode.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/watch_mode.py — Incremental Watch Mode & Real-Time Test Engineering HUD |
138
150
  | `python tools/wcag_audit.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/wcag_audit.py - Automated Accessibility (WCAG 2.2) Linter & Auditor |
139
151
  | `python tools/welcome_page.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/welcome_page.py — Interactive Visual Landing Page for Synapse Hub |
@@ -145,4 +157,4 @@
145
157
  - `network`: Queries external APIs, monitors npm registry, or checks live URLs.
146
158
  - `destructive`: High-impact actions guarded by `safety_firewall.py` (e.g. drop database, hard resets).
147
159
 
148
- *Catalog generated: `2026-11-16T14:33:14.461153+00:00` by `tools/generate_tool_catalog.py`*
160
+ *Catalog generated: `2026-11-17T12:38:10.135761+00:00` by `tools/generate_tool_catalog.py`*