@teevee98/synapse-hub 4.4.0 → 4.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (276) hide show
  1. package/.cursor/rules/agents.mdc +11 -11
  2. package/.cursor/rules/katalon.mdc +11 -0
  3. package/.cursor/rules/perf.mdc +10 -0
  4. package/.cursor/rules/playwright.mdc +10 -0
  5. package/.cursor/rules/pytest.mdc +10 -0
  6. package/.cursor/rules/synapse-qa.mdc +4 -2
  7. package/.cursorrules +3 -10
  8. package/.windsurfrules +3 -10
  9. package/AGENTS.md +4 -3
  10. package/CLAUDE.md +4 -5
  11. package/README.en.md +3 -3
  12. package/README.md +3 -3
  13. package/agentskills.json +15 -15
  14. package/{.agents/agents → ai-agents/personas}/api-engineer.md +2 -2
  15. package/{.agents/agents → ai-agents/personas}/failure-analyst.md +1 -1
  16. package/{.agents/agents → ai-agents/personas}/live-explorer.md +1 -1
  17. package/{.agents/agents → ai-agents/personas}/orchestrator.md +8 -15
  18. package/{.agents/agents → ai-agents/personas}/perf-engineer.md +1 -3
  19. package/{.agents/agents → ai-agents/personas}/pom-crafter.md +3 -9
  20. package/{.agents/agents → ai-agents/personas}/quality-gatekeeper.md +1 -1
  21. package/{.agents/agents → ai-agents/personas}/test-designer.md +2 -1
  22. package/{.agents/agents → ai-agents/personas}/test-runner.md +3 -4
  23. package/{.agents/rules → automation/playwright}/mandatory-playwright-live.md +5 -13
  24. package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/SKILL.md +2 -0
  25. package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/SKILL.md +8 -0
  26. package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/SKILL.md +9 -0
  27. package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/SKILL.md +2 -0
  28. package/docs/ARCHITECTURE.en.md +2 -2
  29. package/docs/ARCHITECTURE.md +2 -2
  30. package/docs/TOOL_CATALOG.md +8 -5
  31. package/docs/reports/AUDIT_REPORT.md +1038 -0
  32. package/docs/reports/PROJECT_HEALTH_REPORT.md +49 -0
  33. package/docs/reports/TECHNICAL_DEBT_LEDGER.md +22 -0
  34. package/package.json +8 -1
  35. package/plugin.json +1 -1
  36. package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/SKILL.md +8 -0
  37. package/scripts/install_global_plugin.ps1 +1 -1
  38. package/scripts/install_global_plugin.sh +1 -1
  39. package/skills_index.json +61 -0
  40. package/skills_manifest.json +88 -62
  41. package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/SKILL.md +8 -1
  42. package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/SKILL.md +2 -0
  43. package/synapse.config.json +1 -1
  44. package/templates/ai_bridges/CLAUDE.md +4 -5
  45. package/templates/ai_bridges/copilot-instructions.md +1 -0
  46. package/templates/ai_bridges/cursor_synapse_qa.mdc +4 -2
  47. package/templates/ai_bridges/windsurfrules +3 -10
  48. package/testing/api-contracts/api_testing_rules.md +74 -0
  49. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/SKILL.md +2 -0
  50. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/SKILL.md +5 -11
  51. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/SKILL.md +2 -0
  52. package/testing/manual/manual-qa-and-rtm-bridge/SKILL.md +92 -0
  53. package/testing/manual/manual-qa-and-rtm-bridge/examples/sample_bug_and_rtm.json +38 -0
  54. package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/SKILL.md +1 -1
  55. package/{.agents/rules → testing/performance}/performance_testing_rules.md +23 -0
  56. package/{.agents/rules → testing/security-a11y}/security_testing_rules.md +19 -0
  57. package/tools/TOOLS_RUNBOOK.md +9 -4
  58. package/tools/TOOL_CATALOG.json +75 -30
  59. package/tools/TOOL_INDEX.json +160 -0
  60. package/tools/__init__.py +1 -1
  61. package/tools/assertion_optimizer.py +188 -0
  62. package/tools/author_integrity.py +12 -1
  63. package/tools/benchmark_swarm_context.py +1 -1
  64. package/tools/browser_helpers.js +2 -2
  65. package/tools/catalogs/api_contract_testing.json +107 -0
  66. package/tools/catalogs/auxiliary_utilities.json +1536 -0
  67. package/tools/catalogs/benchmarking.json +23 -0
  68. package/tools/catalogs/ci_cd_packaging.json +46 -0
  69. package/tools/catalogs/code_generation_ast.json +70 -0
  70. package/tools/catalogs/failure_autopsy_healing.json +41 -0
  71. package/tools/catalogs/manual_testing_design.json +80 -0
  72. package/tools/catalogs/orchestration.json +25 -0
  73. package/tools/catalogs/performance_testing.json +71 -0
  74. package/tools/catalogs/quality_gates.json +65 -0
  75. package/tools/catalogs/sandboxing_isolation.json +42 -0
  76. package/tools/catalogs/security.json +72 -0
  77. package/tools/catalogs/setup_onboarding.json +26 -0
  78. package/tools/catalogs/testing_utilities.json +111 -0
  79. package/tools/check_env.py +16 -3
  80. package/tools/check_version_sync.py +114 -63
  81. package/tools/cldr_l10n_verifier.py +1 -1
  82. package/tools/cli.py +787 -3
  83. package/tools/core/circuit_breaker.py +106 -0
  84. package/tools/core/token_estimator.py +56 -7
  85. package/tools/dashboard_generator.py +10 -10
  86. package/tools/generate_tool_catalog.py +60 -2
  87. package/tools/mcp_docx_server.py +1 -1
  88. package/tools/mcp_excel_server.py +1 -1
  89. package/tools/mcp_server.py +5 -1
  90. package/tools/pre_push_guard.py +1 -1
  91. package/tools/project_state.py +17 -10
  92. package/tools/reversible_sandbox.py +7 -2
  93. package/tools/rules_router.py +5 -3
  94. package/tools/runaway_stopper.py +19 -111
  95. package/tools/setup_project.py +1 -1
  96. package/tools/skill_canonical_digest.py +2 -2
  97. package/tools/skillspector.py +78 -10
  98. package/tools/sync_agent_rules.py +15 -27
  99. package/tools/sync_skills_manifest.py +38 -4
  100. package/tools/tmmi_auditor.py +8 -1
  101. package/tools/ui_server.py +1 -1
  102. package/tools/update_sentinel.py +4 -4
  103. package/tools/validate_host_interop.py +3 -1
  104. package/tools/validate_skills_schema.py +49 -2
  105. package/tools/welcome_page.py +4 -4
  106. package/.agents/rules/stack-auto-router.md +0 -30
  107. package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +0 -114
  108. package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +0 -9
  109. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/SKILL.md +0 -123
  110. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/examples/sample_gitlab_ci.yml +0 -17
  111. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/SKILL.md +0 -133
  112. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/examples/Jenkinsfile.example +0 -21
  113. package/.cursor/rules/language.mdc +0 -7
  114. package/templates/ci/github-actions-synapse.yml +0 -95
  115. package/templates/ci/gitlab-ci-synapse.yml +0 -16
  116. package/tools/build_consolidated_report.py +0 -1643
  117. package/tools/create_mock_docx.py +0 -107
  118. /package/{.agents → ai-agents/hooks}/hooks.json +0 -0
  119. /package/{.agents → ai-agents}/hooks/session_start.py +0 -0
  120. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/SKILL.md +0 -0
  121. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/examples/broker_sharding_sample.json +0 -0
  122. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/SKILL.md +0 -0
  123. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +0 -0
  124. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/SKILL.md +0 -0
  125. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +0 -0
  126. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/SKILL.md +0 -0
  127. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/examples/task_plan_example.md +0 -0
  128. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/SKILL.md +0 -0
  129. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/examples/archival_memory_sample.json +0 -0
  130. /package/{.agents → ai-agents}/workflows/graphify.md +0 -0
  131. /package/{.agents → ai-agents}/workflows/test-impact.md +0 -0
  132. /package/{.agents → ai-agents}/workflows/verify.md +0 -0
  133. /package/{.agents/rules → automation/cypress}/cypress_rules.md +0 -0
  134. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/SKILL.md +0 -0
  135. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/examples/headless_kre_exec.sh +0 -0
  136. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/groovy-patterns.md +0 -0
  137. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/katalon-api.md +0 -0
  138. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/runner_commands.md +0 -0
  139. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/SKILL.md +0 -0
  140. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/BaseScreen.java +0 -0
  141. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/LoginScreen.java +0 -0
  142. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/TC_MobileLogin.java +0 -0
  143. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/SKILL.md +0 -0
  144. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/examples/sample_flow.yaml +0 -0
  145. /package/{.agents/rules → automation/mobile}/mobile_appium_rules.md +0 -0
  146. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/SKILL.md +0 -0
  147. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/examples/live_probe_script.js +0 -0
  148. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/advanced_superpowers.md +0 -0
  149. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/compact_accessibility_snapshots.md +0 -0
  150. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/recipes.md +0 -0
  151. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/swarm_orchestration.md +0 -0
  152. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/examples/server_lifecycle_playwright.py +0 -0
  153. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/SKILL.md +0 -0
  154. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +0 -0
  155. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/storage_state_sample.json +0 -0
  156. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/SKILL.md +0 -0
  157. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/examples/cli_runner_test.bats +0 -0
  158. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/resources/implementation-playbook.md +0 -0
  159. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/examples/standard_test_case.groovy +0 -0
  160. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/references/pom_patterns.groovy +0 -0
  161. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/examples/playwright_sharded_config.ts +0 -0
  162. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/resources/implementation-playbook.md +0 -0
  163. /package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/examples/user_story_sample.md +0 -0
  164. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/SKILL.md +0 -0
  165. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/examples/sample_openapi.json +0 -0
  166. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/SKILL.md +0 -0
  167. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/examples/0001-record-architecture-decisions.md +0 -0
  168. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/pocock_grilling_decision_rubric.md +0 -0
  169. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/sample_spec_review.md +0 -0
  170. /package/{.agents → requirement}/workflows/analyze_requirement_document.md +0 -0
  171. /package/{.agents → requirement}/workflows/generate_requirements_from_website.md +0 -0
  172. /package/{.agents/rules → standards/coding-standards}/author-integrity-guard.md +0 -0
  173. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/SKILL.md +0 -0
  174. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +0 -0
  175. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +0 -0
  176. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/resources/implementation-playbook.md +0 -0
  177. /package/{.agents/rules → standards/coding-standards}/communication-style.md +0 -0
  178. /package/{.agents/rules → standards/coding-standards}/git-push-protocol.md +0 -0
  179. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/SKILL.md +0 -0
  180. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/examples/dependency_blast_radius.json +0 -0
  181. /package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/examples/ladder_walkthrough.md +0 -0
  182. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/SKILL.md +0 -0
  183. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_audit_walkthrough.md +0 -0
  184. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_repo_audit.md +0 -0
  185. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/SKILL.md +0 -0
  186. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/examples/sample_review_walkthrough.md +0 -0
  187. /package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/examples/surgical_vs_scope_creep.md +0 -0
  188. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/SKILL.md +0 -0
  189. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_debt_ledger.md +0 -0
  190. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_ledger_output.md +0 -0
  191. /package/{.agents/rules → standards/context-ai}/context-engineering.md +0 -0
  192. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/SKILL.md +0 -0
  193. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/examples/qa_prompt_template.md +0 -0
  194. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/SKILL.md +0 -0
  195. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/compiled_module_sample.json +0 -0
  196. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +0 -0
  197. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/SKILL.md +0 -0
  198. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_code_window_walkthrough.md +0 -0
  199. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_edit_sample.json +0 -0
  200. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/SKILL.md +0 -0
  201. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/examples/distilled_log_sample.txt +0 -0
  202. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/references/context_engineering_guide.md +0 -0
  203. /package/{.agents/rules → standards/qa-process}/graphify.md +0 -0
  204. /package/{.agents/rules → standards/qa-process}/lessons-learned.md +0 -0
  205. /package/{.agents/rules → standards/qa-process}/skill-precedence.md +0 -0
  206. /package/{.agents/rules → standards/quality-gates}/systematic-debugging.md +0 -0
  207. /package/{.agents/templates → templates/test-plan}/performance-test-plan-template.md +0 -0
  208. /package/{.agents/templates → templates/test-report}/completion_report.md +0 -0
  209. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/SKILL.md +0 -0
  210. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/checkout.feature +0 -0
  211. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/suite_report_sample.json +0 -0
  212. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_cross_module_test_plan.md +0 -0
  213. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_testcases_from_requirements.md +0 -0
  214. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/SKILL.md +0 -0
  215. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +0 -0
  216. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/tot_graph_sample.json +0 -0
  217. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/SKILL.md +0 -0
  218. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +0 -0
  219. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/references/field_validation_checklist.md +0 -0
  220. /package/{.agents → test-design/manual-rbt}/workflows/export_testcases_excel.md +0 -0
  221. /package/{.agents → test-design/manual-rbt}/workflows/generate_manual_testcases_rbt.md +0 -0
  222. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/SKILL.md +0 -0
  223. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/examples/db_fixture_seed.json +0 -0
  224. /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/SKILL.md +0 -0
  225. /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/examples/sample_export_schema.json +0 -0
  226. /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/SKILL.md +0 -0
  227. /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/examples/idempotent_data_recipe.json +0 -0
  228. /package/{.agents → test-design/test-data}/workflows/generate_combinatorial_test_data.md +0 -0
  229. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/SKILL.md +0 -0
  230. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/examples/network_route_stub.json +0 -0
  231. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/SKILL.md +0 -0
  232. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/examples/order_service_pact.json +0 -0
  233. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/healing_report_sample.json +0 -0
  234. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/three_phase_repair_workflow.md +0 -0
  235. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/SKILL.md +0 -0
  236. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/dod_gate_policy.json +0 -0
  237. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +0 -0
  238. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +0 -0
  239. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/sample_junit_failure.xml +0 -0
  240. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/healing_matrix.md +0 -0
  241. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/qa_investigation_protocol.md +0 -0
  242. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/scripts/triage_failures.sh +0 -0
  243. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/SKILL.md +0 -0
  244. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +0 -0
  245. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/examples/aom_diff_sample.json +0 -0
  246. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/SKILL.md +0 -0
  247. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/examples/four_phase_case.md +0 -0
  248. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/SKILL.md +0 -0
  249. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/examples/red_green_refactor_qa.md +0 -0
  250. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/SKILL.md +0 -0
  251. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/examples/evidence_log_example.md +0 -0
  252. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/SKILL.md +0 -0
  253. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/examples/visual_mask_rules.json +0 -0
  254. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +0 -0
  255. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/k6_load_template.js +0 -0
  256. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/performance_test_plan_29119.md +0 -0
  257. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/SKILL.md +0 -0
  258. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_benchmark_gain.md +0 -0
  259. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_scoreboard.md +0 -0
  260. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/SKILL.md +0 -0
  261. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +0 -0
  262. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +0 -0
  263. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/SKILL.md +0 -0
  264. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/examples/dast_scan_config.json +0 -0
  265. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/AI-AND-LLM.md +0 -0
  266. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/ATTACK-CLASSES.md +0 -0
  267. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/dast_recipes.ts +0 -0
  268. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/SKILL.md +0 -0
  269. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/audit_threat_vectors_report.json +0 -0
  270. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/safe_mcp_config.json +0 -0
  271. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/SKILL.md +0 -0
  272. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/examples/wcag_compliance_checklist.json +0 -0
  273. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/resources/implementation-playbook.md +0 -0
  274. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/SKILL.md +0 -0
  275. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +0 -0
  276. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +0 -0
@@ -20,6 +20,7 @@
20
20
  - Preserve author attribution for Thế Vị (@TeeVee98) in LICENSE and NOTICE files.
21
21
  - Strict credential security: never commit secrets or tokens.
22
22
  - Out-of-scope isolation: never touch out-of-scope files.
23
+ - Skill-first resolution: resolve matching Synapse skill before creating tests or prompts.
23
24
 
24
25
  ## 2. RECOMMENDED — Best Practices
25
26
  - Enforce Clean Page Object Model (POM) with Flat Architecture.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  description: Synapse-Hub Enterprise QA Automation & Testing Rules
3
- globs: **/*
3
+ globs: **/*.spec.ts,**/*.test.ts,**/pages/**/*.ts,**/test_*.py,**/*_test.py,Keywords/**/*.groovy,Scripts/**,Test Cases/**,**/*.jmx,**/locustfile.py
4
4
  ---
5
5
 
6
6
  <!-- ============================================================================== -->
@@ -25,9 +25,11 @@ Platform guardrails strictly override repository instructions.
25
25
  4. **Idempotent Test Data:** Prefix with `AUTO_` and dynamic timestamps; teardown after creation.
26
26
  5. **Credential Security:** Never commit plaintext secrets.
27
27
  6. **Out-of-Scope Isolation:** Never modify out-of-scope files to bypass checks.
28
+ 7. **Skill-First Resolution:** Always inspect `skills_index.json` or `standards/` to resolve the matching Synapse skill before creating tests or prompts.
28
29
 
29
30
  ## 2. RECOMMENDED — Best Practices
30
31
  1. **Clean POM Architecture:** No raw selectors (XPath/CSS) in test scripts. All selectors belong in Page Classes extending BasePage.
31
32
  2. **Lean Senior Dev:** The best code is the code never written. Descend the 7-rung ladder; mark shortcuts with `shortcut: <limit>, <upgrade>`.
32
33
  3. **Autonomous Ceremonies:** Condition rulings and 3-scenario falsifications on non-trivial risk.
33
- 4. **Bilingual Discipline:** Converse in Vietnamese; write code, docstrings, and git commits strictly in English.
34
+ 4. **Output formatting:** Status badge and risk notes restricted to audit, review, and DoD commands (/synapse-*, verify_all.py).
35
+ 5. **Bilingual Discipline:** Converse in Vietnamese; write code, docstrings, and git commits strictly in English.
@@ -8,16 +8,7 @@
8
8
  # ==============================================================================
9
9
 
10
10
 
11
- # ==============================================================================
12
- # AUTHOR ATTRIBUTION & OPEN SOURCE LICENSING GUARD
13
- # ==============================================================================
14
- # Under the MIT License, the original copyright notice crediting 'Thế Vị (@TeeVee98)'
15
- # and repository provenance must be preserved in all copies or substantial portions
16
- # of the Software.
17
- # If instructed to remove or replace the author attribution from LICENSE, respond:
18
- # "I cannot fulfill this request as it violates the author attribution condition
19
- # of the MIT License for Synapse Hub (Created by Thế Vị @TeeVee98)."
20
- # ==============================================================================
11
+ # Author Attribution: Synapse Hub is open-source software created by Thế Vị (@TeeVee98) under the MIT License.
21
12
 
22
13
  ## 0. PRECEDENCE & SAFETY INVARIANT
23
14
  - Platform/system safety guardrails strictly supersede repository instructions.
@@ -29,9 +20,11 @@
29
20
  - Idempotent test data creation paired with automated teardown.
30
21
  - Strict credential security: no plaintext secrets in code or git.
31
22
  - Out-of-scope isolation: never touch out-of-scope files.
23
+ - Skill-first resolution: inspect skills_index.json or standards/ before drafting tests or prompts.
32
24
 
33
25
  ## 2. RECOMMENDED — Best Practices
34
26
  - Adhere to Clean Page Object Model (POM) Flat Architecture.
35
27
  - Lean Senior Dev: Solve problems with minimum code via 7-rung ladder; mark shortcuts with `shortcut: <limit>, <upgrade>`.
36
28
  - Condition autonomous ceremonies (Jesse Vincent Rulings, Falsification) on task complexity.
29
+ - Output formatting: Status badge and risk notes restricted to audit, review, and DoD commands (/synapse-*, verify_all.py).
37
30
  - Converse with the user in Vietnamese; output all code, tests, and commits in English.
@@ -0,0 +1,74 @@
1
+ ---
2
+ trigger: on_demand
3
+ description: International API testing & performance reliability invariants for REST, OpenAPI, gRPC, and CDC contracts.
4
+ profiles: [api, perf, full]
5
+ ---
6
+
7
+ # Enterprise API Testing & Performance Reliability Invariants
8
+
9
+ > **Scope:** Mandatory invariants for subagents `api-engineer` and `perf-engineer` when designing, executing, or auditing API suites (REST, OpenAPI, GraphQL, gRPC).
10
+ > **International Standards Alignment:** Codifies Google SRE Four Golden Signals, Percentile Tail Latency (P50/P95/P99/P99.9), IETF RFC 9110/9112/9113, OpenAPI OAS 3.0/3.1, CNCF gRPC, and RFC 6585 Rate Limiting.
11
+
12
+ ---
13
+
14
+ ## 1. Google SRE Four Golden Signals for API Testing
15
+
16
+ 1. **Latency (Separation of Success vs Error):**
17
+ - Latency percentiles must be calculated **independently** for successful requests (`2xx`) versus failed requests (`4xx/5xx`).
18
+ - *Invariant:* Never allow rapid HTTP 500/502 responses (e.g. 5ms gateway rejection) to artificially depress overall average or P95 latency.
19
+ 2. **Traffic (Throughput Accounting):**
20
+ - All load generators must record aggregate and per-endpoint throughput in Requests Per Second (RPS) or Transactions Per Second (TPS).
21
+ 3. **Errors (Explicit & Implicit Failure Guard):**
22
+ - **Explicit Errors:** HTTP `4xx` and `5xx` status codes must be tracked against SLA error budgets.
23
+ - **Implicit Errors (False 200s):** An HTTP `200 OK` returning an empty body `{}`, `null`, or an error payload (`{"code": 500}`) is classified as a critical defect. Tests must validate JSON Schema contracts.
24
+ 4. **Saturation (Resource Headroom):**
25
+ - Correlate API traffic with infrastructure utilization via `tools/telemetry_correlator.py`: CPU saturation ($> 85\%$), JVM heap/GC stalls ($> 90\%$), database connection pool exhaustion, and socket starvation.
26
+
27
+ ---
28
+
29
+ ## 2. Percentile Measurement Invariant (Absolute Ban on Average)
30
+
31
+ 1. **Zero Average Headline:** Never use Average or Mean response times for acceptance sign-off.
32
+ 2. **Mandatory Percentile Matrix:**
33
+ - **P50 (Median):** Typical user experience benchmark.
34
+ - **P95:** Standard commercial SLA baseline for peak traffic.
35
+ - **P99 / P99.9 (Tail Latency):** Mandatory for financial, authentication, and distributed microservice call chains (*Google Tail at Scale*).
36
+
37
+ ---
38
+
39
+ ## 3. Tiered Industry SLA Benchmarks (NFR Reference Table)
40
+
41
+ When evaluating or generating API performance suites, apply the following tier-specific SLA budgets:
42
+
43
+ | Tier | API Category & Use Case | Target P95 Latency | Target P99 Latency | Max Error Rate |
44
+ | :---: | :--- | :---: | :---: | :---: |
45
+ | **Tier 1** | **Simple Read / Cached** (GET by ID, Session/Auth check, Ping) | $< 100\text{ms}$ | $< 200\text{ms}$ | $< 0.01\%$ |
46
+ | **Tier 2** | **Standard Business CRUD** (Indexed Search, User update, Entity create) | $< 500\text{ms}$ | $< 1,000\text{ms}$ | $< 0.1\%$ |
47
+ | **Tier 3** | **Complex Processing** (Payment checkout, Multi-table aggregation) | $< 2,000\text{ms}$ | $< 3,000\text{ms}$ | $< 0.1\%$ |
48
+ | **Tier 4** | **Async / Heavy Processing** (Report generation, Batch data import) | HTTP 202 in $< 200\text{ms}$ | $< 500\text{ms}$ | $< 0.01\%$ |
49
+
50
+ ---
51
+
52
+ ## 4. Technical Standards & Protocol Verification (IETF, OpenAPI, gRPC)
53
+
54
+ 1. **IETF RFC 9110 / 9112 / 9113 (HTTP Semantics & HTTP/2, HTTP/3):**
55
+ - Enforce HTTP Keep-Alive and connection pooling in load scripts.
56
+ - Validate response compression (`Content-Encoding: gzip` or `br`) for JSON payloads $> 1\text{KB}$.
57
+ - Verify Time To First Byte (TTFB) does not exceed $800\text{ms}$.
58
+ 2. **OpenAPI Specification (OAS 3.0 / 3.1) & Contract Discipline:**
59
+ - Treat OpenAPI specs as legally binding contracts: zero undeclared fields, no type shifting (`string` to `integer`), and no silent payload drift (`tools/api_drift_sentinel.py`).
60
+ - Monitor payload sizes to prevent over-fetching (unnecessary entity fields causing bandwidth bottlenecks).
61
+ 3. **gRPC & Protobuf Benchmarks (CNCF):**
62
+ - Internal service-to-service RPCs must prioritize binary Protobuf serialization over JSON, targeting $5\times - 10\times$ lower latency (P99 $< 50\text{ms}$).
63
+
64
+ ---
65
+
66
+ ## 5. Architectural Guardrail Testing (Distributed Systems Resilience)
67
+
68
+ 1. **Rate Limiting & Throttling (RFC 6585):**
69
+ - When traffic exceeds configured rate limits, the API must return HTTP `429 Too Many Requests` with a valid `Retry-After` header. Crashing with `500` or `502` is a failure.
70
+ 2. **Timeout & Circuit Breaker Pattern:**
71
+ - Outbound calls to third-party or downstream microservices must enforce explicit connect/response timeouts ($3\text{s} - 5\text{s}$).
72
+ - Under continuous downstream degradation, the circuit breaker must trip open (returning fast fallback or HTTP 503) to prevent gateway thread exhaustion.
73
+ 3. **Database Connection Pool Saturation (HikariCP / pgpool):**
74
+ - Stress testing must verify that database connections never exceed `max_connections` or trigger connection pool leak warnings. All data writes must execute idempotent teardown cleanup (`reversible_sandbox.py`).
@@ -10,6 +10,8 @@ policies:
10
10
  ---
11
11
  # Agentless QA Repair Skill — Ultra-Low-Token 3-Phase Failure Healing
12
12
 
13
+ > 💡 **Canonical Delegation Notice:** This skill is canonicalized under `failure-autopsy-and-healing` (`testing/healing-resilience/failure-autopsy-and-healing/SKILL.md`). For unified root cause failure analysis and self-healing, prefer delegating directly to `failure-autopsy-and-healing`.
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
  ---
@@ -95,17 +95,11 @@ flowchart LR
95
95
 
96
96
  ---
97
97
 
98
- ### Boundary vs `self-healing-locator` (Do Not Confuse)
99
-
100
- - **This skill** = the general physician: accepts ANY failed test run, performs
101
- root-cause analysis (JUnit XML, logs, screenshots), queries the memory cache,
102
- files the bug ticket, and produces a full healing plan (which may involve
103
- environment, data, timing, or code fixes).
104
- - **`self-healing-locator`** = the orthopedic specialist: one failure class only
105
- — broken locators/stale elements. Its matching cascade is *dispatched by*
106
- this skill's plan when the RCA concludes "locator drift".
107
- - Rule of thumb: if the failure reason is not yet known, start here; only after
108
- the RCA says "locator broke" hand the repair to `self-healing-locator`.
98
+ ### Boundary vs `self-healing-locator` & `agentless-qa-repair` (Canonical Consolidation)
99
+
100
+ - **Unified Healing Pipeline:** This skill serves as the canonical entry point for all failure diagnosis and self-healing operations.
101
+ - **Agentless Minimal-Diff Repair (Integrated from agentless-qa-repair):** Localize failing line via `tools/pinpoint_failure.py`, synthesize candidate fix, and apply minimal diff patching directly to the target Page Class without multi-agent chat overhead.
102
+ - **Semantic AOM Diffing (Integrated from self-healing-locator):** When failure is attributed to locator drift, perform Accessibility Object Model (AOM) semantic diffing using the 6-tier hierarchy (`getByRole` -> `getByLabel` -> `getByTestId` -> semantic CSS) with live browser verification.
109
103
 
110
104
  ---
111
105
 
@@ -10,6 +10,8 @@ policies:
10
10
  ---
11
11
  # Self-Healing Locator Skill — Token-Efficient AOM Diffing
12
12
 
13
+ > 💡 **Canonical Delegation Notice:** This skill is canonicalized under `failure-autopsy-and-healing` (`testing/healing-resilience/failure-autopsy-and-healing/SKILL.md`). For unified root cause failure analysis and locator self-healing, prefer delegating directly to `failure-autopsy-and-healing`.
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
  ---
@@ -0,0 +1,92 @@
1
+ ---
2
+ name: manual-qa-and-rtm-bridge
3
+ description: Manual QA execution standards (ISO/IEC/IEEE 29119-2/3), bug reporting standards, automation candidate selection (ISTQB CTAL-TAE v2.0), RTM traceability bridge, and release go/no-go gates. Use when executing manual QA, logging bugs, selecting automation candidates, or converting manual test cases to automation scripts with RTM tags.
4
+ trigger: on_demand
5
+ profiles: [manual-qa, web-playwright, mobile-appium, api-pytest, katalon, full]
6
+ standards: [ISO/IEC/IEEE 29119-2/3, ISTQB CTAL-TAE v2.0]
7
+ category: test_automation_and_execution
8
+ version: "1.0.0"
9
+ policies:
10
+ network: none
11
+ shell: none
12
+ filesystem: workspace-sandbox
13
+ ---
14
+
15
+ # Manual QA Execution, RTM Bridge & Release Gate
16
+
17
+ > **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.
18
+
19
+ ---
20
+
21
+ ## 1. Trigger & Activation ('Use when...')
22
+
23
+ - **Trigger Clause:** Manual QA execution standards (ISO/IEC/IEEE 29119-2/3), bug reporting standards, automation candidate selection (ISTQB CTAL-TAE v2.0), RTM traceability bridge, and release go/no-go gates. Use when executing manual QA, logging bugs, selecting automation candidates, or converting manual test cases to automation scripts with RTM tags.
24
+ - **Activation Scope:** Domain workflows for manual QA execution, bug incident management, and test case to automation transformation across all supported tech stacks.
25
+
26
+ ---
27
+
28
+ ## 2. Non-Goals & Boundary Constraints
29
+
30
+ - **What NOT to do:**
31
+ - Do NOT log incomplete bug reports lacking REQ_ID/TC_ID, expected vs actual result, or reproducible steps.
32
+ - Do NOT automate unstable or non-deterministic test cases lacking synthetic data isolation.
33
+ - Do NOT approve release if any P0 test case fails or blocker/critical defects remain open.
34
+ - **Sibling Skill Boundaries:**
35
+ - `rbt-manual-testing` handles risk-based test matrix design; `manual-qa-and-rtm-bridge` handles manual execution standards, incident triage, and the RTM traceability bridge to automation.
36
+
37
+ ---
38
+
39
+ ## 3. Ordered Execution Workflow
40
+
41
+ ### 1. Chuẩn Thực Thi Manual QA (ISO/IEC/IEEE 29119-2/3)
42
+ #### A. Bug / Incident Report Standard
43
+ Mọi bug log ra bắt buộc đủ 6 trường:
44
+ - `Bug_ID` & `REQ_ID / TC_ID`: Liên kết ngược về yêu cầu và test case.
45
+ - `Severity` (Blocker/Critical/Major/Minor) & `Priority` (P0/P1/P2/P3).
46
+ - `Environment`: Build/Commit, OS/Browser/Device model, tài khoản test (đã che secret).
47
+ - `Steps to Reproduce`: Tối giản, tái hiện được 100%.
48
+ - `Expected vs Actual Result`: Đối chiếu trực tiếp với Acceptance Criteria.
49
+ - `Evidence`: Screenshot/Video + Console log / Network HAR / Request-Response (đã mask PII/JWT).
50
+
51
+ #### B. Regression Selection & UAT Sign-off
52
+ - **Regression Selection:** Khi có thay đổi code, chọn tối thiểu: (1) Smoke P0 toàn hệ thống + (2) Toàn bộ TC thuộc module bị sửa + (3) Các luồng phụ thuộc (Auth, Payment, DB state).
53
+ - **UAT / Test Cycle Sign-off:** Ghi nhận tổng số TC Executed / Passed / Failed / Blocked và danh sách Known Issues được chấp nhận trước khi đóng cycle.
54
+
55
+ ### 2. Cầu Nối Manual → Automation (ISTQB CTAL-TAE v2.0)
56
+ #### A. Automation Candidate Selection Gate
57
+ Chỉ gắn cờ `Auto_Ready = YES` cho Manual Test Case đạt **>= 3/4** tiêu chí:
58
+ 1. **Risk & Frequency:** Thuộc luồng P0/P1 hoặc chạy lặp lại ở mọi kỳ Regression.
59
+ 2. **Stability:** UI/API đã ổn định, không đổi thiết kế liên tục trong sprint hiện tại.
60
+ 3. **Deterministic:** Có dữ liệu cô lập (`synthetic-test-data-generator`) và kiểm chứng tự động được.
61
+ 4. **ROI:** Chi phí viết + bảo trì thấp hơn thời gian chạy manual lặp lại.
62
+
63
+ #### B. Quy Tắc RTM Tagging Khi Sinh Code Automation
64
+ Khi `pom-crafter` chuyển đổi Manual TC sang code (Playwright, Pytest, Cypress, Appium, Katalon):
65
+ - **Bắt buộc giữ nguyên `TC_ID` và `REQ_ID`** trong tag/annotation:
66
+ - Playwright/Cypress: `test('[REQ-102][TC-045] ...', { tag: ['@P0', '@REQ-102', '@TC-045'] }, ...)`
67
+ - Pytest: `@pytest.mark.req("REQ-102")` và `@pytest.mark.tc("TC-045")`
68
+ - Appium/Katalon: Metadata/comment `@TC_ID: TC-045 | @REQ_ID: REQ-102` ở đầu test case.
69
+ - **1-to-1 Traceability:** Mỗi `TC_ID` ánh xạ về 1 test function/spec rõ ràng để báo cáo CI/CD map được % coverage theo `REQ_ID`.
70
+
71
+ ### 3. Release Go / No-Go Gate (Tổng Hợp Manual + Auto)
72
+ Chỉ cho phép Release khi đạt đồng thời:
73
+ - **100% P0 Test Cases Pass** (tổng hợp Manual + Auto).
74
+ - **0 Blocker / Critical Bug** đang mở.
75
+ - **0 Vi phạm Quality Gates** (Security, Performance SLA, 0-assert lint).
76
+
77
+ ---
78
+
79
+ ## 4. Verification Points & DoD
80
+
81
+ 1. All manual bug reports contain all 6 mandatory ISO 29119-3 fields.
82
+ 2. Automation candidates evaluated against all 4 CTAL-TAE criteria with >= 3/4 score.
83
+ 3. Generated automation scripts retain RTM traceability tags linking back to REQ_ID and TC_ID.
84
+ 4. Release sign-off requires 100% P0 pass rate and 0 open blocker defects.
85
+
86
+ ---
87
+
88
+ ## 5. Handoff Protocol
89
+
90
+ - **Deliverables:** Bug incident reports, RTM traceability matrices, candidate selection ledgers, and release sign-off checklists.
91
+ - **Next Subagent:** `pom-crafter` (for automation synthesis) or `quality-gatekeeper` (for release gate validation).
92
+ - **Output Format:** Markdown bug reports, Excel RTM matrices, and tagged test automation specifications.
@@ -0,0 +1,38 @@
1
+ {
2
+ "bug_report_sample": {
3
+ "bug_id": "BUG-2026-089",
4
+ "req_id": "REQ-102",
5
+ "tc_id": "TC-045",
6
+ "severity": "Critical",
7
+ "priority": "P0",
8
+ "environment": {
9
+ "commit": "a1b2c3d",
10
+ "os": "macOS 15.1",
11
+ "browser": "Chromium 131.0",
12
+ "account": "user_qa_tier1"
13
+ },
14
+ "steps_to_reproduce": [
15
+ "1. Navigate to /checkout with items in cart",
16
+ "2. Select credit card payment option",
17
+ "3. Click Confirm Order button"
18
+ ],
19
+ "expected_result": "Order is confirmed and receipt page is displayed with order ID",
20
+ "actual_result": "HTTP 500 internal server error with uncaught exception in payment webhook",
21
+ "evidence": {
22
+ "screenshot": "reports/screenshots/bug_2026_089.png",
23
+ "har": "reports/network/checkout_500.har"
24
+ }
25
+ },
26
+ "rtm_traceability_sample": {
27
+ "req_id": "REQ-102",
28
+ "tc_id": "TC-045",
29
+ "title": "Verify credit card checkout happy path",
30
+ "auto_ready": true,
31
+ "ctal_tae_score": "4/4",
32
+ "code_binding": {
33
+ "framework": "playwright",
34
+ "file": "tests/e2e/checkout.spec.ts",
35
+ "tag": "@REQ-102 @TC-045 @P0"
36
+ }
37
+ }
38
+ }
@@ -35,7 +35,7 @@ policies:
35
35
  ## 3. Ordered Execution Workflow
36
36
 
37
37
  > **Target:** Model concurrent Virtual User (VU) and arrival-rate traffic, execute stress/soak test profiles, and enforce automated SLA gates (P95/P99 latency, error rate < 1.0%) to detect bottlenecks before production.
38
- > **Mandatory Rule:** Adhere strictly to [performance_testing_rules.md](../../../rules/performance_testing_rules.md) for safety approvals, hard caps, and truth-anchor reporting.
38
+ > **Mandatory Rule:** Adhere strictly to [performance_testing_rules.md](../performance_testing_rules.md) for safety approvals, hard caps, and truth-anchor reporting.
39
39
 
40
40
  ---
41
41
 
@@ -55,3 +55,26 @@ profiles: [perf, full]
55
55
  ## 3. Truth Anchor & Autopsy Sequence
56
56
  1. **Truth Anchor:** If an SLA is breached, report root cause honestly. Never loosen thresholds or drop samples to manufacture a fake pass.
57
57
  2. **Analysis Sequence:** 1. Run Validity (`dropped_iterations == 0`, generator CPU < 80%) -> 2. Error Rate (4xx, 5xx, timeouts) -> 3. Latency Percentiles (P50, P90, P95, P99; never headline average) -> 4. Throughput -> 5. APM Correlation (DB slow queries, connection pool exhaustion).
58
+
59
+ ---
60
+
61
+ ## 4. Business Workload Model, SPA Leak & Mobile App Performance
62
+
63
+ ### A. Thiết Kế Performance Test Case Từ Nghiệp Vụ
64
+ Trước khi viết script tải, chốt 3 thông số:
65
+ 1. **Workload Mix:** Phân bổ % lưu lượng theo hành trình thực tế (ví dụ: Browse 70%, Search 20%, Checkout 10%), quy đổi từ DAU/CCV sang RPS bằng Little's Law (`L = lambda * W`).
66
+ 2. **DB Data Volume Precondition:** Chỉ rõ kích thước dữ liệu nền (ví dụ: DB có sẵn >= 100,000 bản ghi trước khi đo) để phát hiện slow query / thiếu index.
67
+ 3. **SLA Matrix Phân Cấp:**
68
+ - Read / Lookup API: `P95 <= 200ms`, `Error Rate <= 0.5%`
69
+ - Search / Filter phức tạp: `P95 <= 500ms`, `Error Rate <= 1.0%`
70
+ - Write / Checkout / Payment: `P95 <= 800ms-1000ms`, `Error Rate <= 0.1%`
71
+
72
+ ### B. Web Throttling & Long-Session Memory Leak
73
+ - **Điều kiện đo chuẩn:** Đo Web Vitals dưới giả lập **Slow 4G + CPU 4x slowdown** (không chỉ đo trên mạng cáp quang local).
74
+ - **SPA Memory Leak:** Với Web App dùng lâu (dashboard, POS), lặp thao tác chuyển tab/mở modal 20–50 lần để kiểm tra Heap Memory không tăng tuyến tính liên tục.
75
+
76
+ ### C. Mobile App Performance (Android Vitals & iOS MetricKit)
77
+ Áp dụng cho thiết bị thật tầm trung (`mobile-appium`, `katalon`):
78
+ - **App Startup Time:** Đo riêng **Cold / Warm / Hot Start** qua 2 mốc `TTID` (Time to Initial Display) và `TTFD` (Time to Full Display).
79
+ - **UI Rendering & Smoothness:** Duy trì `60 FPS` (`<= 16.6ms/frame`); theo dõi **Janky Frames** (`> 16.6ms`), **Frozen Frames** (`> 700ms`) và **ANR** (`> 5s` Android / Watchdog crash iOS) khi scroll danh sách dài.
80
+ - **Resource & Network Resilience:** Giám sát **RAM/Memory** (không leak khi mở/đóng màn hình lặp lại), **CPU %**, **Battery drain** khi chạy nền, kích thước APK/IPA, và test chuyển mạng thực tế (**Wi-Fi <-> 4G/5G <-> Offline**).
@@ -31,3 +31,22 @@ profiles: [api-security, full]
31
31
  ## 5. Layer 5 — Sanitized Evidence Standard
32
32
  * Every reported vulnerability must include: Severity (Critical / High / Medium / Low), reproducible HTTP Request/Response pairs (or verifiable `curl` commands), and concrete remediation guidance.
33
33
  * Mandatory sanitization: Mask all JWTs, session cookies, passwords, API tokens, and PII before writing logs, generating summaries, or exporting artifacts.
34
+
35
+ ## Layer 6 — Security Test Case, Web Client-Side & Mobile MASVS (Gap Add-on)
36
+
37
+ ### A. Negative Security Test Case Design (OWASP ASVS & API Top 10)
38
+ Khi sinh test case cho tính năng có Auth/API/Giao dịch, bổ sung nhóm `TC_SEC_XXX`:
39
+ - **Mass Assignment (API3 BOPLA):** Gửi thừa field nhạy cảm (`role`, `isVerified`, `discount`) trong payload `POST/PUT/PATCH`. Expected: Server bỏ qua hoặc reject `400/422`.
40
+ - **Business Logic & Rate Limit (API4 / API6):** Spam OTP/Login vượt ngưỡng, gửi số lượng/giá âm, áp mã giảm giá nhiều lần, hoặc bỏ qua bước xác thực ở luồng nhiều bước.
41
+
42
+ ### B. Web Client-Side & Supply Chain (OWASP WSTG)
43
+ - **Session & Storage:** Kiểm tra JWT/Session không lưu plain-text trong `localStorage`/`sessionStorage`; Cookie phiên bật đủ `HttpOnly`, `Secure`, `SameSite=Lax/Strict`.
44
+ - **DOM XSS & Open Redirect:** Kiểm tra output encoding bằng canary DOM-XSS probe vô hại ở URL hash/query params và xác minh redirect URL (`?next=...`) bị chặn ngoài allowlist.
45
+ - **File Upload Bypass:** Kiểm tra upload file giả mạo MIME type hoặc double extension.
46
+ - **Supply Chain (SCA):** Chạy `npm audit` / `pip-audit` trong CI; chặn build nếu có CVE Critical/High chưa vá.
47
+
48
+ ### C. Mobile App Security (OWASP MASVS & MASTG)
49
+ - **MASVS-STORAGE:** SharedPreferences / UserDefaults / SQLite / Cache / Logcat không lưu token, password, PII dạng clear-text (bắt buộc dùng Android Keystore / iOS Keychain).
50
+ - **MASVS-NETWORK:** Chặn HTTP clear-text (`cleartextTrafficPermitted=false`); kiểm tra **SSL/TLS Certificate Pinning** bằng proxy — app phải từ chối kết nối khi cert không hợp lệ.
51
+ - **MASVS-PLATFORM:** Kiểm tra **Deep Link / URL Scheme** không mở màn hình nội bộ trái phép; tắt JS interface dư thừa và vô hiệu hóa truy cập file cục bộ trong WebView.
52
+ - **MASVS-RESILIENCE:** Kiểm tra hành vi app trên thiết bị **Root/Jailbreak** hoặc khi gắn debugger/Frida; che màn hình nhạy cảm khi app xuống background.
@@ -994,12 +994,17 @@ agent-qa update
994
994
 
995
995
  ---
996
996
 
997
- ### 57. `tools/generate_tool_catalog.py` (Enterprise Tooling Catalog Generator)
998
- - **Purpose:** Introspects all Python scripts in `tools/`, extracts AST docstrings, CLI arguments, and categories, generating `tools/TOOL_CATALOG.json`.
999
- - **Trigger Condition:** Adding or modifying tools in `tools/` to maintain the canonical catalog.
997
+ ### 57. `tools/generate_tool_catalog.py` (Enterprise Tooling Catalog & Index Generator)
998
+ - **Purpose:** Introspects all Python scripts in `tools/`, extracts AST docstrings, CLI arguments, and categories, generating:
999
+ - `tools/TOOL_INDEX.json` (Tier 1 lightweight index grouped by persona role, < 12 KB)
1000
+ - `tools/catalogs/<category>.json` (Tier 2 sharded schemas by category)
1001
+ - `tools/TOOL_CATALOG.json` (Tier 2 full catalog)
1002
+ - `docs/TOOL_CATALOG.md` (Human-readable runbook)
1003
+ - **Tiered Lookup Protocol:** AI agents and subagents must query `tools/TOOL_INDEX.json` first to locate tools by `owner_role`. Only read the relevant `tools/catalogs/<category>.json` or `tools/TOOL_CATALOG.json` when full input/output schemas are required.
1004
+ - **Trigger Condition:** Adding or modifying tools in `tools/` to maintain the canonical catalog and indexes.
1000
1005
  - **CLI Syntax:**
1001
1006
  ```bash
1002
- python tools/generate_tool_catalog.py --output tools/TOOL_CATALOG.json
1007
+ python tools/generate_tool_catalog.py
1003
1008
  ```
1004
1009
 
1005
1010
  ---
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schema_version": "1.0.0",
3
- "updated_at": "2026-11-17T03:54:38.281198+00:00",
4
- "total_tools": 139,
5
- "stable_count": 139,
3
+ "updated_at": "2026-11-17T12:38:10.135761+00:00",
4
+ "total_tools": 142,
5
+ "stable_count": 142,
6
6
  "experimental_count": 0,
7
7
  "tools": [
8
8
  {
@@ -115,6 +115,21 @@
115
115
  ],
116
116
  "description": "Enterprise Autonomous API Fuzzing & Chaos Breaker"
117
117
  },
118
+ {
119
+ "file": "tools/assertion_optimizer.py",
120
+ "command": "python tools/assertion_optimizer.py",
121
+ "category": "Auxiliary Utilities",
122
+ "owner_role": "orchestrator",
123
+ "status": "stable",
124
+ "risk_level": "read_only",
125
+ "inputs": [
126
+ "CLI options"
127
+ ],
128
+ "outputs": [
129
+ "Artifacts / Telemetry"
130
+ ],
131
+ "description": "tools/assertion_optimizer.py — Unified Assertion Optimization & Tuning Suite"
132
+ },
118
133
  {
119
134
  "file": "tools/ast_cache.py",
120
135
  "command": "python tools/ast_cache.py",
@@ -271,38 +286,38 @@
271
286
  "description": "Auto-Bug Reporter & Root Cause Analysis (RCA) Ticket Generator"
272
287
  },
273
288
  {
274
- "file": "tools/build_consolidated_report.py",
275
- "command": "python tools/build_consolidated_report.py",
289
+ "file": "tools/bump_version.py",
290
+ "command": "python tools/bump_version.py",
276
291
  "category": "Auxiliary Utilities",
277
292
  "owner_role": "orchestrator",
278
293
  "status": "stable",
279
- "risk_level": "read_only",
294
+ "risk_level": "modifying",
280
295
  "inputs": [
281
296
  "CLI options"
282
297
  ],
283
298
  "outputs": [
284
299
  "Artifacts / Telemetry"
285
300
  ],
286
- "description": "tools/build_consolidated_report.py — Generate Unified Top 20 Skills & Agents Evaluation Report"
301
+ "description": "tools/bump_version.py — Atomic Universal Version Bumper for Synapse Hub"
287
302
  },
288
303
  {
289
- "file": "tools/bump_version.py",
290
- "command": "python tools/bump_version.py",
304
+ "file": "tools/cache_resolver.py",
305
+ "command": "python tools/cache_resolver.py",
291
306
  "category": "Auxiliary Utilities",
292
307
  "owner_role": "orchestrator",
293
308
  "status": "stable",
294
- "risk_level": "modifying",
309
+ "risk_level": "read_only",
295
310
  "inputs": [
296
311
  "CLI options"
297
312
  ],
298
313
  "outputs": [
299
314
  "Artifacts / Telemetry"
300
315
  ],
301
- "description": "tools/bump_version.py — Atomic Universal Version Bumper for Synapse Hub"
316
+ "description": "Universal Local Semantic Memory Cache & Self-Healing Resolver"
302
317
  },
303
318
  {
304
- "file": "tools/cache_resolver.py",
305
- "command": "python tools/cache_resolver.py",
319
+ "file": "tools/chaos_resilience_probe.py",
320
+ "command": "python tools/chaos_resilience_probe.py",
306
321
  "category": "Auxiliary Utilities",
307
322
  "owner_role": "orchestrator",
308
323
  "status": "stable",
@@ -313,7 +328,7 @@
313
328
  "outputs": [
314
329
  "Artifacts / Telemetry"
315
330
  ],
316
- "description": "Universal Local Semantic Memory Cache & Self-Healing Resolver"
331
+ "description": "tools/chaos_resilience_probe.py — Enterprise Chaos Engineering & Reliability Sentinel"
317
332
  },
318
333
  {
319
334
  "file": "tools/check_env.py",
@@ -450,21 +465,6 @@
450
465
  ],
451
466
  "description": "tools/coverage_reporter.py — Standardized Coverage Metrics & Roadmap Evaluator"
452
467
  },
453
- {
454
- "file": "tools/create_mock_docx.py",
455
- "command": "python tools/create_mock_docx.py",
456
- "category": "Testing & Utilities",
457
- "owner_role": "orchestrator",
458
- "status": "stable",
459
- "risk_level": "read_only",
460
- "inputs": [
461
- "CLI options"
462
- ],
463
- "outputs": [
464
- "Artifacts / Telemetry"
465
- ],
466
- "description": "Generates a lightweight valid mock DOCX fixture (< 20 KB) for OpenXML Guard / Word reader tests."
467
- },
468
468
  {
469
469
  "file": "tools/cvss_calculator.py",
470
470
  "command": "python tools/cvss_calculator.py",
@@ -1199,6 +1199,21 @@
1199
1199
  ],
1200
1200
  "description": "MIPROv2 Prompt Assertion Tuner (Stanford DSPy v2 & Optuna TPE Pattern)"
1201
1201
  },
1202
+ {
1203
+ "file": "tools/mobile_resilience_sentinel.py",
1204
+ "command": "python tools/mobile_resilience_sentinel.py",
1205
+ "category": "Auxiliary Utilities",
1206
+ "owner_role": "orchestrator",
1207
+ "status": "stable",
1208
+ "risk_level": "read_only",
1209
+ "inputs": [
1210
+ "CLI options"
1211
+ ],
1212
+ "outputs": [
1213
+ "Artifacts / Telemetry"
1214
+ ],
1215
+ "description": "tools/mobile_resilience_sentinel.py — Mobile Hardware Interrupts, MASVS & HIG Sentinel"
1216
+ },
1202
1217
  {
1203
1218
  "file": "tools/network_mock_shield.py",
1204
1219
  "command": "python tools/network_mock_shield.py",
@@ -1234,6 +1249,21 @@
1234
1249
  ],
1235
1250
  "description": "Sub-0.1s Postman/Newman JSON test report analyzer enforcing CI/CD quality gates."
1236
1251
  },
1252
+ {
1253
+ "file": "tools/observability_tester.py",
1254
+ "command": "python tools/observability_tester.py",
1255
+ "category": "Testing & Utilities",
1256
+ "owner_role": "orchestrator",
1257
+ "status": "stable",
1258
+ "risk_level": "read_only",
1259
+ "inputs": [
1260
+ "CLI options"
1261
+ ],
1262
+ "outputs": [
1263
+ "Artifacts / Telemetry"
1264
+ ],
1265
+ "description": "tools/observability_tester.py — OpenTelemetry Trace & Log Hygiene Verification Sentinel"
1266
+ },
1237
1267
  {
1238
1268
  "file": "tools/omni_emitter.py",
1239
1269
  "command": "python tools/omni_emitter.py",
@@ -1345,6 +1375,21 @@
1345
1375
  ],
1346
1376
  "description": "tools/pairwise_generator.py — Pairwise (2-Way) Combinatorial Test Case Generator"
1347
1377
  },
1378
+ {
1379
+ "file": "tools/payment_interop_simulator.py",
1380
+ "command": "python tools/payment_interop_simulator.py",
1381
+ "category": "Auxiliary Utilities",
1382
+ "owner_role": "orchestrator",
1383
+ "status": "stable",
1384
+ "risk_level": "read_only",
1385
+ "inputs": [
1386
+ "CLI options"
1387
+ ],
1388
+ "outputs": [
1389
+ "Artifacts / Telemetry"
1390
+ ],
1391
+ "description": "tools/payment_interop_simulator.py — ISO 8583 & Financial Gateway Interoperability Sentinel"
1392
+ },
1348
1393
  {
1349
1394
  "file": "tools/pentest_scope_guard.py",
1350
1395
  "command": "python tools/pentest_scope_guard.py",
@@ -1498,7 +1543,7 @@
1498
1543
  "outputs": [
1499
1544
  "Artifacts / Telemetry"
1500
1545
  ],
1501
- "description": "tools/runaway_stopper.py — Agent Runaway & Token Loop Sentinel"
1546
+ "description": "tools/runaway_stopper.py — Agent Runaway & Token Loop Sentinel (Stub / Re-export)"
1502
1547
  },
1503
1548
  {
1504
1549
  "file": "tools/safety_firewall.py",