@teevee98/synapse-hub 0.0.0-stage → 3.8.3

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 (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +171 -0
  190. package/README.md +170 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +198 -0
  196. package/docs/ARCHITECTURE.md +199 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +31 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2074 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2403 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +306 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +725 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1271 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: consumer-driven-contract-testing
3
+ description: "Standardize Consumer-Driven Contract (CDC) testing with Pact and OpenAPI Bidirectional Contract Testing. Detect and prevent breaking schema changes, payload drift, and microservice integration failures."
4
+ ---
5
+
6
+ # Consumer-Driven Contract (CDC) Testing — Schema Drift & Integration Sentinel
7
+
8
+ > **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.
9
+
10
+ ---
11
+
12
+ ## 1. Overview & Architecture
13
+
14
+ Consumer-Driven Contract (CDC) Testing shifts integration verification left by formalizing expectations between API consumers (Web/Mobile frontends, backend BFFs) and API providers (microservices) into explicit, machine-readable contracts.
15
+
16
+ Instead of relying on fragile, slow, and expensive multi-service end-to-end environments, CDC enables isolated testing:
17
+ 1. **Consumer Tests:** The consumer defines its exact expectation contract (HTTP method, headers, request body, response schema, status code) against a mock provider. A signed Pact file (`.json`) or OpenAPI specification is generated.
18
+ 2. **Contract Broker:** The contract is published to the Pact Broker / Contract Ledger with semantic versioning.
19
+ 3. **Provider Verification:** The provider independently replays all registered consumer contracts against its live endpoints (or generated stubs) in CI/CD without needing any running consumers.
20
+ 4. **Deploy Gate (`can-i-deploy`):** Verifies that both consumer and provider versions are compatible before promoting artifacts to staging or production.
21
+
22
+ ```mermaid
23
+ flowchart LR
24
+ subgraph Consumer_CI ["1. Consumer Pipeline"]
25
+ CT["Consumer Test"] -->|Record expectations| MockProv["Pact Mock Server"]
26
+ MockProv -->|Generate| Contract["pact-contract.json"]
27
+ Contract -->|Publish| Broker[("Pact Broker / Contract Ledger")]
28
+ end
29
+
30
+ subgraph Provider_CI ["2. Provider Pipeline"]
31
+ Broker -->|Fetch contracts| Verifier["Pact Verifier / OpenAPI Diff"]
32
+ Verifier -->|Replay requests| RealProv["Provider Microservice"]
33
+ RealProv -->|Verification results| Broker
34
+ end
35
+
36
+ subgraph Release_Gate ["3. Promotion Gate"]
37
+ Broker -->|can-i-deploy| Gate{"Compatible?"}
38
+ Gate -->|Yes| Deploy["Deploy to Production"]
39
+ Gate -->|No (Breaking Drift)| Block["Block Release & Alert"]
40
+ end
41
+ ```
42
+
43
+ ---
44
+
45
+ ## 2. Bi-Directional Contract Testing (BDCT) & OpenAPI Diffing
46
+
47
+ In bi-directional contract testing, consumers use mock fixtures or recorded network HAR traffic, while providers supply their authoritative OpenAPI 3.0/3.1 specification. The engine executes automated schema diffing:
48
+
49
+ ### Breaking Changes Checklist (Strictly Blocked by Gatekeeper):
50
+ - ❌ **Removing an existing field** that any consumer contract depends on.
51
+ - ❌ **Adding a new mandatory (`required`) field** to a request body without a default value.
52
+ - ❌ **Mutating property data types** (e.g., `id: string` changed to `id: integer`, or `amount: number` to `amount: string`).
53
+ - ❌ **Narrowing enum values** (removing an enum value that consumers submit or expect).
54
+ - ❌ **Altering response status codes** (e.g., changing HTTP 201 Created to HTTP 200 OK without consumer migration).
55
+ - ❌ **Tightening validation rules** (e.g., lowering `maxLength` below existing consumer field lengths).
56
+
57
+ ### Non-Breaking Changes (Permitted):
58
+ - ✅ Adding optional fields (`required: false`) to response bodies.
59
+ - ✅ Adding new endpoints without touching existing routes.
60
+ - ✅ Loosening validation rules (e.g., increasing `maxLength` or expanding enum options).
61
+
62
+ ---
63
+
64
+ ## 3. Consumer Contract Authoring Standards (Clean POM & Pact DSL)
65
+
66
+ Consumer contracts must use flexible matchers rather than hardcoded static payloads to prevent flakiness:
67
+
68
+ ### TypeScript / Playwright Pact Pattern:
69
+ ```typescript
70
+ import { PactV3, MatchersV3 } from '@pact-foundation/pact';
71
+
72
+ const { like, regex, integer, eachLike } = MatchersV3;
73
+
74
+ const provider = new PactV3({
75
+ consumer: 'SynapseWebFrontend',
76
+ provider: 'OrderService',
77
+ dir: './pacts'
78
+ });
79
+
80
+ describe('Order Service CDC Suite', () => {
81
+ it('validates order creation contract', async () => {
82
+ await provider
83
+ .uponReceiving('a request to create a new order')
84
+ .withRequest({
85
+ method: 'POST',
86
+ path: '/api/v1/orders',
87
+ headers: { 'Content-Type': 'application/json', 'Authorization': regex('Bearer .+') },
88
+ body: {
89
+ customerId: like('CUST_1001'),
90
+ items: eachLike({
91
+ sku: regex('^[A-Z0-9_-]{3,20}$', 'SKU_ITEM_01'),
92
+ quantity: integer(1),
93
+ price: like(49.99)
94
+ })
95
+ }
96
+ })
97
+ .willRespondWith({
98
+ status: 201,
99
+ headers: { 'Content-Type': 'application/json' },
100
+ body: {
101
+ orderId: regex('^ORD-[0-9]{8}$', 'ORD-20261106'),
102
+ status: regex('^(PENDING|CONFIRMED)$', 'CONFIRMED'),
103
+ createdAt: like('2026-11-06T10:00:00Z')
104
+ }
105
+ })
106
+ .executeTest(async (mockserver) => {
107
+ const client = new OrderApiClient(mockserver.url);
108
+ const response = await client.createOrder({ ... });
109
+ expect(response.status).toBe('CONFIRMED');
110
+ });
111
+ });
112
+ });
113
+ ```
114
+
115
+ ---
116
+
117
+ ## 4. Provider Verification Protocol
118
+
119
+ Providers verify all active consumer contracts against their test instances:
120
+
121
+ ```bash
122
+ # Verify provider implementation against contracts registered in broker
123
+ pact-verifier \
124
+ --provider-base-url="http://localhost:8080" \
125
+ --pact-broker-url="https://broker.synapse-qa.internal" \
126
+ --provider="OrderService" \
127
+ --publish-verification-results \
128
+ --provider-app-version="3.2.0" \
129
+ --provider-version-branch="main"
130
+ ```
131
+
132
+ ---
133
+
134
+ ## 5. Automated CI/CD Deployment Verification (`can-i-deploy`)
135
+
136
+ Before triggering deployment in CI/CD, the release pipeline invokes the compatibility ledger:
137
+
138
+ ```bash
139
+ # Enforce deployment gatekeeper
140
+ pact-broker can-i-deploy \
141
+ --pact-broker-url="https://broker.synapse-qa.internal" \
142
+ --pacticipant="SynapseWebFrontend" \
143
+ --version="3.2.0" \
144
+ --to-environment="production"
145
+ ```
146
+
147
+ If any contract is unverified or broken, the command exits with non-zero code, blocking deployment and preventing live customer-facing API outages.
@@ -0,0 +1,45 @@
1
+ {
2
+ "consumer": {
3
+ "name": "SynapseWebFrontend"
4
+ },
5
+ "provider": {
6
+ "name": "OrderService"
7
+ },
8
+ "interactions": [
9
+ {
10
+ "description": "a request to create a new order",
11
+ "request": {
12
+ "method": "POST",
13
+ "path": "/api/v1/orders",
14
+ "headers": {
15
+ "Content-Type": "application/json"
16
+ },
17
+ "body": {
18
+ "customerId": "CUST_1001",
19
+ "items": [
20
+ {
21
+ "sku": "SKU_ITEM_01",
22
+ "quantity": 1,
23
+ "price": 49.99
24
+ }
25
+ ]
26
+ }
27
+ },
28
+ "response": {
29
+ "status": 201,
30
+ "headers": {
31
+ "Content-Type": "application/json"
32
+ },
33
+ "body": {
34
+ "orderId": "ORD-20261106",
35
+ "status": "CONFIRMED"
36
+ }
37
+ }
38
+ }
39
+ ],
40
+ "metadata": {
41
+ "pactSpecification": {
42
+ "version": "3.0.0"
43
+ }
44
+ }
45
+ }
@@ -0,0 +1,123 @@
1
+ ---
2
+ name: db-state-verifier-and-seeder
3
+ description: "Seed isolated test fixtures and assert database mutations across SQL and NoSQL. Use when seeding, verifying, or cleaning database state around tests."
4
+ ---
5
+
6
+ # Database State Verifier & Seeder Skill
7
+
8
+ > **Target:** Eliminate shallow UI-only validations by asserting exact backend database mutations (PostgreSQL, MySQL, Oracle, MongoDB, Redis) and providing isolated, idempotent fixture seeding.
9
+
10
+ ---
11
+
12
+ ## 1. Core Principles
13
+
14
+ 1. **Dual-Layer Assertion (UI + DB):**
15
+ - Asserting a green UI toast is insufficient for transactional operations. Test suites must query the persistence layer to ensure records are properly inserted with correct foreign keys and audit fields (`created_at`, `created_by`).
16
+ 2. **Transaction Isolation & Fast Rollback:**
17
+ - Whenever possible, seed data inside transactional boundaries or maintain automated deletion queues tied to entity unique codes.
18
+ 3. **Zero Plaintext Connection Credentials:**
19
+ - All connection strings must be sourced strictly from environment variables (`DB_HOST`, `DB_USER`, `DB_PASS`).
20
+
21
+ ---
22
+
23
+ ## 2. Standard SQL Query & State Assertion Patterns
24
+
25
+ ### Pattern A: PostgreSQL / MySQL Record Persistence Assertion
26
+ ```python
27
+ import os
28
+ import psycopg2
29
+
30
+ def assert_record_created(unique_code: str, expected_status: str = "ACTIVE"):
31
+ conn = psycopg2.connect(
32
+ host=os.getenv("DB_HOST", "localhost"),
33
+ database=os.getenv("DB_NAME", "qa_db"),
34
+ user=os.getenv("DB_USER", "postgres"),
35
+ password=os.getenv("DB_PASS", "")
36
+ )
37
+ cursor = conn.cursor()
38
+ cursor.execute("SELECT id, status, is_deleted FROM business_entities WHERE code = %s", (unique_code,))
39
+ row = cursor.fetchone()
40
+
41
+ assert row is not None, f"Database assertion failed: Record with code {unique_code} not found!"
42
+ assert row[1] == expected_status, f"Expected status {expected_status}, but found {row[1]}"
43
+ assert row[2] is False, "Record flagged as deleted prematurely"
44
+
45
+ conn.close()
46
+ print(f"[PASS] Verified database persistence for code: {unique_code}")
47
+ ```
48
+
49
+ ### Pattern B: Idempotent SQL Teardown Cleanup
50
+ ```python
51
+ def teardown_test_entity(unique_code: str):
52
+ conn = psycopg2.connect(...)
53
+ cursor = conn.cursor()
54
+ cursor.execute("DELETE FROM business_entities WHERE code = %s", (unique_code,))
55
+ conn.commit()
56
+ conn.close()
57
+ ```
58
+
59
+ ---
60
+
61
+ ## 3. Standard NoSQL Patterns (MongoDB & Redis)
62
+
63
+ ### Pattern C: MongoDB Document Mutation & JSON Schema Assertion
64
+ ```python
65
+ import os
66
+ from pymongo import MongoClient
67
+
68
+ def assert_mongo_document_persisted(order_id: str, expected_item_count: int):
69
+ client = MongoClient(os.getenv("MONGO_URI", "mongodb://localhost:27017"))
70
+ db = client[os.getenv("MONGO_DB", "orders_db")]
71
+ collection = db["customer_orders"]
72
+
73
+ doc = collection.find_one({"orderId": order_id})
74
+ assert doc is not None, f"MongoDB error: Order {order_id} not found!"
75
+ assert len(doc.get("items", [])) == expected_item_count, f"Item count mismatch in doc: {doc}"
76
+ assert doc.get("paymentStatus") == "CONFIRMED", "Payment status is not CONFIRMED"
77
+
78
+ # Cleanup teardown
79
+ collection.delete_one({"orderId": order_id})
80
+ client.close()
81
+ print(f"[PASS] Verified and cleaned MongoDB document: {order_id}")
82
+ ```
83
+
84
+ ### Pattern D: Redis Cache Expiry & Invalidation Verification
85
+ ```python
86
+ import os
87
+ import redis
88
+
89
+ def assert_cache_invalidated(cache_key: str):
90
+ r = redis.Redis.from_url(os.getenv("REDIS_URL", "redis://localhost:6379/0"))
91
+ val = r.get(cache_key)
92
+ assert val is None, f"Cache leak error: Key '{cache_key}' should have been invalidated after mutation!"
93
+ print(f"[PASS] Verified Redis cache eviction for key: {cache_key}")
94
+ ```
95
+
96
+ ---
97
+
98
+ ## 4. Zero-Pollution DB Sandbox & Ephemeral Teardown (`tools/db_sandbox.py`)
99
+
100
+ To eliminate cascading flakiness and orphan test junk in parallel CI runs, agents utilize deterministic DB Sandbox operations:
101
+
102
+ ### 1. Transaction Savepoint Rollback Context
103
+ Wrap E2E test data creation inside transactional savepoints:
104
+ ```bash
105
+ python tools/db_sandbox.py rollback-test --db-path "path/to/db.sqlite"
106
+ ```
107
+ *Guarantees zero leftover records: state is automatically rolled back to pristine baseline upon test completion.*
108
+
109
+ ### 2. Ephemeral Snapshot & Instant Restore (< 0.5s)
110
+ ```bash
111
+ # Before test suite runs: capture pristine database baseline
112
+ python tools/db_sandbox.py snapshot --id pristine_baseline
113
+
114
+ # After suite execution: instantly restore clean database
115
+ python tools/db_sandbox.py restore --id pristine_baseline
116
+ ```
117
+
118
+ ### 3. Taint Pollution Audit & Cascading Purge
119
+ Scan all tables for orphan records carrying test prefixes (`AUTO_`, `TEST_`) and purge them cleanly:
120
+ ```bash
121
+ python tools/db_sandbox.py audit
122
+ ```
123
+
@@ -0,0 +1,12 @@
1
+ {
2
+ "table": "tenants",
3
+ "operation": "INSERT",
4
+ "records": [
5
+ {
6
+ "tenant_id": "AUTO_TENANT_01",
7
+ "status": "ACTIVE",
8
+ "plan": "ENTERPRISE"
9
+ }
10
+ ],
11
+ "teardown": "DELETE FROM tenants WHERE tenant_id = :tenant_id"
12
+ }
@@ -0,0 +1,103 @@
1
+ ---
2
+ name: e2e-testing-patterns
3
+ description: "Design robust multi-browser E2E test architectures, parallel sharding, and retry governance. Use when designing end-to-end test suites for web applications."
4
+ ---
5
+
6
+ # E2E Testing Architectural Patterns
7
+
8
+ Engineering standard for structuring, scaling, and maintaining large-scale End-to-End (E2E) test automation suites across modern web frameworks (React, Angular, Vue, Next.js).
9
+
10
+ ---
11
+
12
+ ## 1. Test Pyramid & E2E Scope Boundary
13
+
14
+ ```mermaid
15
+ flowchart TD
16
+ E2E["<b>E2E Tests (10%)</b><br/>Critical User Journeys, Multi-Page Flows, Payment, SSO"]
17
+ Integ["<b>Integration Tests (30%)</b><br/>Component contracts, API Routes, DB persistence"]
18
+ Unit["<b>Unit Tests (60%)</b><br/>Pure functions, business logic, validation rules"]
19
+
20
+ Unit --> Integ --> E2E
21
+ ```
22
+
23
+ - **What belongs in E2E:** High-risk customer journeys (Sign-up, Onboarding, Checkout, File Export, Role transitions).
24
+ - **What to avoid in E2E:** Exhaustive boundary value checks of simple form fields (delegate to Unit/API tests).
25
+
26
+ ---
27
+
28
+ ## 2. Core Operational Patterns
29
+
30
+ ### Pattern A: Clean Page Object Model (POM) with Typed Interfaces
31
+ ```typescript
32
+ // pages/base.page.ts
33
+ import { Page, Locator, expect } from '@playwright/test';
34
+
35
+ export abstract class BasePage {
36
+ constructor(protected readonly page: Page) {}
37
+
38
+ async waitForNetworkIdle(): Promise<void> {
39
+ await this.page.waitForLoadState('networkidle');
40
+ }
41
+
42
+ async clickSafe(locator: Locator): Promise<void> {
43
+ await locator.waitFor({ state: 'visible' });
44
+ await locator.click();
45
+ }
46
+ }
47
+ ```
48
+
49
+ ```typescript
50
+ // pages/checkout.page.ts
51
+ import { Locator, expect } from '@playwright/test';
52
+ import { BasePage } from './base.page';
53
+
54
+ export class CheckoutPage extends BasePage {
55
+ readonly submitBtn: Locator = this.page.getByRole('button', { name: /Complete Purchase/i });
56
+ readonly confirmationToast: Locator = this.page.getByTestId('checkout-toast');
57
+
58
+ async completeOrder(): Promise<void> {
59
+ await this.clickSafe(this.submitBtn);
60
+ await expect(this.confirmationToast).toBeVisible({ timeout: 5000 });
61
+ }
62
+ }
63
+ ```
64
+
65
+ ### Pattern B: Isolated Storage State Fixture (Zero Login Repetition)
66
+ ```typescript
67
+ // fixtures/auth.fixture.ts
68
+ import { test as base, Page } from '@playwright/test';
69
+
70
+ export const test = base.extend<{ authedPage: Page }>({
71
+ authedPage: async ({ browser }, use) => {
72
+ const context = await browser.newContext({ storageState: '.auth/user.json' });
73
+ const page = await context.newPage();
74
+ await use(page);
75
+ await context.close();
76
+ },
77
+ });
78
+ ```
79
+
80
+ ### Pattern C: Resilient Synchronization (No Static Delays)
81
+ ```typescript
82
+ // ANTI-PATTERN:
83
+ // await page.waitForTimeout(5000); // Flaky and slow!
84
+
85
+ // CORRECT PATTERN:
86
+ // 1. Wait for specific API response
87
+ const responsePromise = page.waitForResponse(resp => resp.url().includes('/api/orders') && resp.status() === 201);
88
+ await page.getByRole('button', { name: 'Save' }).click();
89
+ await responsePromise;
90
+
91
+ // 2. Assert final visual DOM state
92
+ await expect(page.getByText('Order Created')).toBeVisible();
93
+ ```
94
+
95
+ ---
96
+
97
+ ## 3. Parallel Sharding & CI/CD Governance
98
+ ```bash
99
+ # Run test suite sharded across 4 parallel CI workers
100
+ npx playwright test --shard=1/4 --reporter=html,junit:results.xml
101
+ ```
102
+ - **Retries:** Maximum 1 retry on CI, 0 retries locally. Never rely on retries to mask structural flakiness.
103
+ - **Trace on Failure:** Always configure `trace: 'retain-on-failure'` and `screenshot: 'only-on-failure'`.
@@ -0,0 +1,12 @@
1
+ import { defineConfig, devices } from '@playwright/test';
2
+
3
+ export default defineConfig({
4
+ testDir: './tests',
5
+ fullyParallel: true,
6
+ retries: 2,
7
+ workers: process.env.CI ? 4 : undefined,
8
+ use: {
9
+ headless: true,
10
+ trace: 'on-first-retry',
11
+ },
12
+ });