@teevee98/synapse-hub 0.0.0-stage → 3.8.2

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 +172 -0
  190. package/README.md +171 -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 +197 -0
  196. package/docs/ARCHITECTURE.md +198 -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 +175 -0
  200. package/docs/CLI_REFERENCE.md +177 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +121 -0
  206. package/docs/QUALITY_GATES.md +121 -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 +1359 -0
  212. package/docs/schemas/synapse.config.schema.json +87 -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 +32 -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 +2079 -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 +258 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +184 -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 +2419 -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 +307 -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 +724 -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 +1259 -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,127 @@
1
+ # 3rd-Party Plugin Development Guide — Synapse Hub
2
+
3
+ > **Specification Version:** 2.2.4
4
+ > **Hub Core Provenance:** Thế Vị (@TeeVee998) — [Synapse Hub](https://github.com/TeeVee998/Synapse-Hub)
5
+ > **Reference Example:** [examples/plugins/sample-custom-plugin](../examples/plugins/sample-custom-plugin)
6
+
7
+ ---
8
+
9
+ ## 1. Overview
10
+
11
+ Synapse Hub provides a decoupled, modular architecture enabling 3rd-party teams and community contributors to extend the Hub with specialized QA skills, runner adapters, or domain-specific security linters.
12
+
13
+ Every 3rd-party plugin is an independent package registered via `plugin.json` and vetted by the built-in **SkillSpector Security Sentinel** (`tools/skillspector.py`).
14
+
15
+ ---
16
+
17
+ ## 2. Plugin Structure & File Conventions
18
+
19
+ A standard Synapse Hub plugin adheres to the following directory layout:
20
+
21
+ ```text
22
+ my-custom-plugin/
23
+ ├── plugin.json # Mandatory plugin manifest
24
+ ├── README.md # Plugin documentation & quickstart
25
+ ├── skills/ # Packaged AI skills (one folder per skill)
26
+ │ └── custom-security-audit/
27
+ │ ├── SKILL.md # Standardized YAML frontmatter + prompt
28
+ │ └── examples/
29
+ │ └── audit_sample.json # Demonstrable example fixture
30
+ └── tools/ # Executable CLI tools (Python 3.9+)
31
+ └── custom_auditor.py # Deterministic, standalone tool
32
+ ```
33
+
34
+ ---
35
+
36
+ ## 3. Plugin Manifest Specification (`plugin.json`)
37
+
38
+ The root `plugin.json` declares identity, capabilities, and dependencies:
39
+
40
+ ```json
41
+ {
42
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
43
+ "name": "sample-custom-plugin",
44
+ "version": "1.0.0",
45
+ "description": "3rd-party plugin extending Synapse Hub with custom HTTP security header auditing.",
46
+ "author": "Community Contributor",
47
+ "license": "MIT",
48
+ "repository": "https://github.com/example/sample-custom-plugin",
49
+ "skills": [
50
+ "custom-security-headers-audit"
51
+ ],
52
+ "tools": [
53
+ "tools/custom_security_headers.py"
54
+ ],
55
+ "minHubVersion": "2.2.0"
56
+ }
57
+ ```
58
+
59
+ ### Manifest Fields:
60
+ - `name` *(string, required)*: Unique kebab-case identifier.
61
+ - `version` *(string, required)*: Semantic versioning (`x.y.z`).
62
+ - `description` *(string, required)*: Concise summary of provided capabilities.
63
+ - `skills` *(array of strings)*: List of skill folder names inside `skills/`.
64
+ - `tools` *(array of strings)*: Relative file paths to executable scripts in `tools/`.
65
+ - `minHubVersion` *(string)*: Minimum compatible Synapse Hub core version.
66
+
67
+ ---
68
+
69
+ ## 4. Skill Authoring Standard (`SKILL.md`)
70
+
71
+ Each skill must contain valid YAML frontmatter followed by clear, token-optimized instructions:
72
+
73
+ ```markdown
74
+ ---
75
+ name: custom-security-headers-audit
76
+ description: Audits web applications for missing or misconfigured HTTP security headers (CSP, HSTS, X-Frame-Options).
77
+ version: 1.0.0
78
+ category: security_and_compliance
79
+ ---
80
+
81
+ # Custom Security Headers Audit Skill
82
+
83
+ ## Purpose
84
+ Inspects target endpoint response headers and reports compliance against OWASP ASVS Section 14.
85
+
86
+ ## Quick CLI Execution
87
+ ```bash
88
+ python tools/custom_security_headers.py https://staging.example.com --json report.json
89
+ ```
90
+ ```
91
+
92
+ ### Skill Invariants:
93
+ 1. **Token Ceiling:** Every `SKILL.md` must be $\le 1.500$ tokens (enforced by `scripts/lint_skills.ps1`).
94
+ 2. **100% UTF-8 No BOM:** Zero BOM bytes (`0xEF, 0xBB, 0xBF`).
95
+ 3. **Evidence-First:** Must reference deterministic tools rather than guessing.
96
+
97
+ ---
98
+
99
+ ## 5. Security & Safety Invariants (DoD Compliance)
100
+
101
+ All 3rd-party tools and scripts must adhere to Synapse Hub's safety rules:
102
+
103
+ 1. **Zero `shell=True` Policy:** Never invoke `subprocess.Popen` or `subprocess.run` with `shell=True`. Always pass structured lists:
104
+ ```python
105
+ # Correct:
106
+ subprocess.run(["curl", "-I", url], capture_output=True, check=True)
107
+ # FORBIDDEN (will be rejected by Gatekeeper):
108
+ subprocess.run(f"curl -I {url}", shell=True)
109
+ ```
110
+ 2. **Environment Allowlist Guard:** Any tool performing destructive modifications or fuzzing must verify staging allowlists (`SYNAPSE_ALLOW_PROD_FUZZ=1`).
111
+ 3. **No Hardcoded Credentials:** Never store plaintext secrets or passwords.
112
+
113
+ ---
114
+
115
+ ## 6. Vetting & Verification Pipeline
116
+
117
+ Before distributing or publishing a plugin, run the Hub's verification sentinels:
118
+
119
+ ```bash
120
+ # 1. Run SkillSpector Security Scan (Must report 0 High/Critical warnings)
121
+ python tools/skillspector.py --target path/to/my-custom-plugin
122
+
123
+ # 2. Run Quality Gates Linting
124
+ python tools/verify_all.py --target path/to/my-custom-plugin
125
+ ```
126
+
127
+ Once passed, the plugin can be mounted directly into the Antigravity Plugin directory (`~/.gemini/config/plugins/`) or integrated via `skills_manifest.json`.
@@ -0,0 +1,121 @@
1
+ # 🛡️ 11 Quality Gates Definition of Done (DoD) Standard
2
+
3
+ [🇻🇳 Tiếng Việt](QUALITY_GATES.md) | [🇬🇧 English Edition](QUALITY_GATES.en.md)
4
+
5
+ > **Scope:** Enterprise automated verification sentinel enforcing 11 non-negotiable Quality Gates across Synapse Hub and target client projects.
6
+ > **Command:** `python3 tools/verify_all.py` or `npx synapse-hub verify`
7
+ > **Integrity Guard:** Synapse Hub created by **Thế Vị (@TeeVee998)** (<https://github.com/TeeVee998/Synapse-Hub>) under MIT License.
8
+
9
+ ---
10
+
11
+ ## 📋 Quality Gates Matrix Overview
12
+
13
+ | Gate | Name | Target Scope | Engine / Tool | Exit Code | Passing Criteria (DoD) |
14
+ | :---: | :--- | :--- | :--- | :---: | :--- |
15
+ | **Gate 0** | **Author Attribution & MIT Integrity** | Repository-wide | `tools/author_integrity.py` | 0 | MIT License notice and author attribution intact across all source files. |
16
+ | **Gate 1** | **UTF-8 No BOM Encoding** | All source & config files | `tools/verify_all.py` | 0 | Zero Byte Order Mark (`0xEF, 0xBB, 0xBF`) bytes across any file. |
17
+ | **Gate 2** | **Path Portability** | All source & test files | `tools/verify_all.py` | 0 | Zero hardcoded personal/machine absolute paths (`/Users/...`, `C:\...`). |
18
+ | **Gate 3** | **Clean POM & Flat Architecture** | Test scripts (`tests/`, `Scripts/`) | `tools/verify_all.py` | 0 | Zero raw XPaths or CSS selectors in test scripts; 100% locators encapsulated in Page Classes. |
19
+ | **Gate 4** | **AI Documentation & Anti-Drift** | `PROJECT_AI_GUIDE.md` & AST | `tools/lint_ai_docs.py` | 0 | 0 hallucinated PageClasses; 100% documented methods exist in codebase AST. |
20
+ | **Gate 5** | **Temporary Files Blacklist** | Repository tree | `tools/verify_all.py` | 0 | Zero scratch files, heap dumps, or temporary artifacts (`*.tmp`, `.ruff_cache`, memory dumps). |
21
+ | **Gate 6** | **Credential & Secret Security** | All files & git index | `tools/verify_all.py` | 0 | Zero plaintext passwords, API keys, private tokens, or AWS/JWT credentials committed. |
22
+ | **Gate 7** | **Static Defect & Fake-Pass Sentinel** | Test scripts & tools | `tools/infer_linter.py` | 0 | Zero empty assertions (0 assert), zero swallowed exceptions (`pass`), zero hardcoded sleeps (>= 3000ms). |
23
+ | **Gate 8** | **Assertion Sensitivity (Mutation Score)** | Test assertions | `tools/micro_mutator.py` | 0 | Mutation kill score >= 80% (heuristic static mutant detection catches >= 80% syntactic modifications). |
24
+ | **Gate 9** | **Skill Routing & Collision Guard** | Skill descriptions | `tools/skill_collision_guard.py` | 0 | Zero overlapping trigger collisions (semantic cosine similarity < 0.75 across all skill pairs). |
25
+ | **Gate 10** | **Performance & SLA Sentinel** | `Reports/perf/` (`.jtl`, `.csv`, `summary.json`) | `tools/verify_all.py` | 0 | Meets SLA budgets (P95 $\le$ 500ms, P99 $\le$ 1000ms, Error Rate $\le$ 1.0%); automatically SKIPPED/PASS when no perf tests exist. |
26
+
27
+ ---
28
+
29
+ ## 🔍 Detailed Gate Specifications
30
+
31
+ ### Gate 0: Author Attribution & MIT License Integrity
32
+ - **Objective:** Protects open-source attribution provenance under MIT License.
33
+ - **Verification Rule:** Rejects any commit, pull request, or modification that attempts to strip copyright notices, false-claim authorship, or remove provenance headers referencing Thế Vị (@TeeVee998).
34
+ - **Remediation:** Restore license headers and canonical notice in `LICENSE` and `NOTICE`.
35
+
36
+ ### Gate 1: UTF-8 No BOM Encoding Integrity
37
+ - **Objective:** Eliminates cross-platform file encoding corruption between Windows, macOS, and Linux CI/CD runners.
38
+ - **Verification Rule:** Inspects raw bytes of all text files. Any occurrence of BOM bytes (`0xEF, 0xBB, 0xBF`) causes immediate failure.
39
+ - **Remediation:** Run `python3 tools/verify_all.py --fix-bom` to strip BOM bytes automatically.
40
+
41
+ ### Gate 2: Path Portability
42
+ - **Objective:** Guarantees test scripts and tooling execute seamlessly across team developer workstations, Docker containers, and CI pipelines.
43
+ - **Verification Rule:** Regex scans for machine-specific path roots (`/Users/`, `/home/`, `C:\`, `D:\`).
44
+ - **Remediation:** Replace absolute paths with dynamic workspace resolution (`Path(__file__).resolve().parent.parent` or `resolve_target_repo()`).
45
+
46
+ ### Gate 3: Clean POM & Flat Architecture
47
+ - **Objective:** Enforces clean separation of concerns. Test scripts must contain solely business workflow actions, never DOM traversal.
48
+ - **Verification Rule:** Prohibits raw CSS selectors, XPaths, or `findTestObject` inside `tests/` or `Scripts/`. All UI operations must be delegated to methods on Page Classes extending `BasePage`.
49
+ - **Remediation:** Encapsulate locators and interaction logic inside dedicated Page Classes.
50
+
51
+ ### Gate 4: AI Documentation & Anti-Drift Linter
52
+ - **Objective:** Prevents AI context drift where documentation refers to non-existent Page Classes or obsolete method signatures.
53
+ - **Verification Rule:** Extracts all documented Page Classes and methods from `PROJECT_AI_GUIDE.md` and verifies their physical AST existence in the codebase.
54
+ - **Remediation:** Run `python3 tools/lint_ai_docs.py` to identify drifts, then re-index via `python3 tools/repo_map.py`.
55
+
56
+ ### Gate 5: Temporary Files Blacklist
57
+ - **Objective:** Maintains git hygiene and prevents polluting repositories with binary dumps or local IDE caches.
58
+ - **Verification Rule:** Scans for prohibited extensions: `*.tmp`, `*.dump`, `*.log`, `*.orig`, `*.bak`, `.ruff_cache/`, `.mypy_cache/`.
59
+ - **Remediation:** Add unignored patterns to `.gitignore` and delete temporary files.
60
+
61
+ ### Gate 6: Credential Security Sentinel
62
+ - **Objective:** Prevents enterprise credential leaks (API tokens, database connection strings, private keys).
63
+ - **Verification Rule:** High-entropy regex scanner detecting AWS secret keys, Bearer tokens, private RSA keys, and hardcoded passwords.
64
+ - **Remediation:** Move credentials to environment variables or `.env` (ensuring `.env` is listed in `.gitignore`).
65
+
66
+ ### Gate 7: Static Defect & Fake-Pass Sentinel
67
+ - **Objective:** Eliminates "fake passes" created by AI code generation (tests that pass trivially without asserting anything).
68
+ - **Verification Rule:**
69
+ - Flags tests containing 0 assertions.
70
+ - Flags empty catch blocks (`except Exception: pass`) swallowing failure exceptions.
71
+ - Flags hardcoded sleeps (`sleep(5000)`, `Thread.sleep(5000)`).
72
+ - Flags unawaited Playwright assertions (`expect(el).toBeVisible()` without `await`).
73
+ - **Remediation:** Add meaningful assertions; replace sleeps with smart waits (`waitForLoadState('networkidle')`, element visibility checks).
74
+
75
+ ### Gate 8: Assertion Sensitivity & Syntactic Mutation Sentinel
76
+ - **Objective:** Guarantees assertions are sensitive enough to catch real defects, not tautological (always-true) expressions.
77
+ - **Verification Rule:** Injects syntactic mutations (reversing comparison operators `==` to `!=`, swapping boolean constants, altering return values). Requires Mutation Score >= 80%.
78
+ - **Remediation:** Run `python3 tools/micro_mutator.py --strict` to inspect surviving mutants and tighten test assertions.
79
+
80
+ ### Gate 9: Tier-2 Skill Routing & Collision Guard
81
+ - **Objective:** Prevents AI agent prompt confusion caused by overlapping skill trigger descriptions.
82
+ - **Verification Rule:** Computes pairwise cosine similarity between all skill `SKILL.md` description fields. Similarity must remain strictly < 0.75.
83
+ - **Remediation:** Differentiate skill descriptions using the standardized formula `[Function] + Use when [context]` (<= 350 characters).
84
+
85
+ ### Gate 10: Performance & SLA Sentinel
86
+ - **Objective:** Prevents latency regressions, unbounded response degradation, or uncontained error bursts from merging or deploying to target environments.
87
+ - **Verification Rule:** Detects and parses load testing artifacts in `Reports/perf/` (`.jtl`, `.csv`, `summary.json`). Enforces SLA thresholds (P95 $\le$ 500ms, P99 $\le$ 1000ms, Error Rate $\le$ 1.0%), returning Exit Code 1 on failure. Automatically yields `PASS (SKIPPED)` within < 1ms if no performance test artifacts exist in the project.
88
+ - **Remediation:** Optimize slow endpoints or DB queries, review thread pool / connection pooling, or adjust custom SLA thresholds in `synapse.config.json` to reflect project-specific capacity budgets.
89
+
90
+ ---
91
+
92
+ ## 🚀 Execution & CI/CD Integration
93
+
94
+ ### Run Locally:
95
+ ```bash
96
+ # Verify all 11 Gates on current repository
97
+ python3 tools/verify_all.py
98
+
99
+ # Verify target project from Hub
100
+ python3 tools/verify_all.py --target /path/to/project
101
+
102
+ # Output as JUnit XML for CI/CD reporting
103
+ python3 tools/verify_all.py --format junit --output reports/dod_gates.xml
104
+ ```
105
+
106
+ ### GitHub Actions Pipeline (`.github/workflows/verify.yml`):
107
+ ```yaml
108
+ name: Synapse Hub 11 DoD Quality Gates
109
+ on: [push, pull_request]
110
+
111
+ jobs:
112
+ quality-gates:
113
+ runs-on: ubuntu-latest
114
+ steps:
115
+ - uses: actions/checkout@v4
116
+ - uses: actions/setup-python@v5
117
+ with:
118
+ python-version: '3.11'
119
+ - name: Run 11 Quality Gates
120
+ run: python tools/verify_all.py --mode target
121
+ ```
@@ -0,0 +1,121 @@
1
+ # 🛡️ Tiêu Chuẩn 11 Cổng Chất Lượng DoD (Definition of Done)
2
+
3
+ [🇻🇳 Tiếng Việt](QUALITY_GATES.md) | [🇬🇧 English Edition](QUALITY_GATES.en.md)
4
+
5
+ > **Phạm vi:** Hệ thống chốt chặn tự động kiểm tra 11 Cổng Chất Lượng bắt buộc trên Synapse Hub và các dự án kiểm thử con.
6
+ > **Lệnh thực thi:** `python3 tools/verify_all.py` hoặc `npx synapse-hub verify`
7
+ > **Bảo toàn tác quyền:** Synapse Hub được sáng lập bởi **Thế Vị (@TeeVee998)** (<https://github.com/TeeVee998/Synapse-Hub>) theo giấy phép MIT.
8
+
9
+ ---
10
+
11
+ ## 📋 Bảng Tổng Quan 11 Cổng Kiểm Định Chất Lượng
12
+
13
+ | Cổng | Tên Cổng | Phạm Vi Quét | Công Cụ Kiểm Tra | Mã Thoát | Tiêu Chuẩn Đạt (DoD) |
14
+ | :---: | :--- | :--- | :--- | :---: | :--- |
15
+ | **Gate 0** | **Bảo Toàn Tác Quyền & Giấy Phép MIT** | Toàn bộ repo | `tools/author_integrity.py` | 0 | Giữ nguyên thông báo bản quyền MIT và tác giả gốc Thế Vị (@TeeVee998). |
16
+ | **Gate 1** | **Chuẩn Mã Hóa UTF-8 No BOM** | Toàn bộ file code & config | `tools/verify_all.py` | 0 | 100% file không chứa ký tự BOM rác (`0xEF, 0xBB, 0xBF`). |
17
+ | **Gate 2** | **Đường Dẫn Linh Hoạt (Path Portability)** | Code test & script công cụ | `tools/verify_all.py` | 0 | Không hardcode đường dẫn tuyệt đối của máy cá nhân (`/Users/...`, `C:\...`). |
18
+ | **Gate 3** | **Kiến Trúc Clean POM (Flat Architecture)** | Thư mục test (`tests/`, `Scripts/`) | `tools/verify_all.py` | 0 | 100% locator nằm trong Page Class; không để XPath/CSS selector trong file test. |
19
+ | **Gate 4** | **Chống Bịa Đặt Tài Liệu AI (Anti-Drift)** | `PROJECT_AI_GUIDE.md` & AST code | `tools/lint_ai_docs.py` | 0 | 0 PageClass ảo; 100% hàm tài liệu hóa phải tồn tại thật trong AST codebase. |
20
+ | **Gate 5** | **Chặn File Rác Lọt Vào Git** | Toàn bộ cây thư mục | `tools/verify_all.py` | 0 | Không để file rác, file tạm lọt vào git (`*.tmp`, `.ruff_cache`, heap dump, log). |
21
+ | **Gate 6** | **Quét Mật Khẩu & Token Bí Mật** | Toàn bộ file & git index | `tools/verify_all.py` | 0 | Không commit mật khẩu dạng plaintext, API key, token JWT hoặc private key. |
22
+ | **Gate 7** | **Bắt Lỗi Tĩnh & Test Pass Ảo** | File test & công cụ | `tools/infer_linter.py` | 0 | Chặn đứng test 0 assert, try-catch nuốt lỗi (`pass`), dùng sleep cứng (>= 3000ms). |
23
+ | **Gate 8** | **Đo Độ Nhạy Của Assert (Mutation Score)** | Toàn bộ câu lệnh assert | `tools/micro_mutator.py` | 0 | Tỷ lệ diệt đột biến $\ge 80\%$ (bắt được ít nhất 80% đột biến cú pháp cố ý). |
24
+ | **Gate 9** | **Điều Phối Kỹ Năng Tránh Trùng Lặp** | File `SKILL.md` của các skill | `tools/skill_collision_guard.py` | 0 | Mô tả kích hoạt kỹ năng không được đè phạm vi của nhau (cosine similarity < 0.75). |
25
+ | **Gate 10** | **Kiểm Soát Hiệu Năng & Tiêu Chuẩn SLA** | `Reports/perf/` (`.jtl`, `.csv`, `summary.json`) | `tools/verify_all.py` | 0 | Đạt chuẩn SLA (P95 $\le$ 500ms, P99 $\le$ 1000ms, Error Rate $\le$ 1.0%); tự động SKIPPED/PASS khi dự án không chạy test tải. |
26
+
27
+ ---
28
+
29
+ ## 🔍 Chi Tiết Tiêu Chuẩn Từng Cổng & Cách Khắc Phục
30
+
31
+ ### Gate 0: Bảo Toàn Tác Quyền & Giấy Phép MIT
32
+ - **Mục tiêu:** Bảo vệ nguồn gốc xuất xứ và tuân thủ điều khoản Attribution bắt buộc của Giấy phép MIT.
33
+ - **Quy tắc kiểm tra:** Chặn đứng mọi hành vi xóa bỏ notice bản quyền, mạo nhận quyền tác giả hoặc gỡ tên tác giả Thế Vị (@TeeVee998).
34
+ - **Cách khắc phục:** Khôi phục lại header bản quyền và thông tin nguồn gốc trong `LICENSE` và `NOTICE`.
35
+
36
+ ### Gate 1: Chuẩn Mã Hóa UTF-8 No BOM
37
+ - **Mục tiêu:** Tránh lỗi vỡ font hoặc xung đột đọc file giữa Windows, macOS và môi trường Linux CI/CD.
38
+ - **Quy tắc kiểm tra:** Quét raw bytes của tất cả file văn bản. Báo lỗi ngay nếu xuất hiện ký tự BOM (`0xEF, 0xBB, 0xBF`).
39
+ - **Cách khắc phục:** Chạy `python3 tools/verify_all.py --fix-bom` để công cụ tự động dọn sạch byte BOM.
40
+
41
+ ### Gate 2: Đường Dẫn Linh Hoạt (Path Portability)
42
+ - **Mục tiêu:** Đảm bảo code test và script công cụ chạy được trên mọi máy dev, Docker container và CI runner.
43
+ - **Quy tắc kiểm tra:** Dùng regex quét tìm các path gắn cứng theo máy cục bộ (`/Users/`, `/home/`, `C:\`, `D:\`).
44
+ - **Cách khắc phục:** Dùng đường dẫn tương đối phân giải từ thư mục gốc (`Path(__file__).resolve().parent.parent` hoặc `resolve_target_repo()`).
45
+
46
+ ### Gate 3: Kiến Trúc Clean POM (Flat Architecture)
47
+ - **Mục tiêu:** Phân định ranh giới rõ ràng: file test chỉ chứa các bước nghiệp vụ, tuyệt đối không chọc thẳng vào DOM.
48
+ - **Quy tắc kiểm tra:** Cấm selector thô (CSS selector, XPath, `findTestObject`) trong thư mục `tests/` hoặc `Scripts/`. Thao tác UI phải thông qua hàm của Page Class kế thừa `BasePage`.
49
+ - **Cách khắc phục:** Đưa locator và thao tác click/nhập liệu vào đúng Page Class tương ứng.
50
+
51
+ ### Gate 4: Chống Bịa Đặt Tài Liệu AI (Anti-Drift Linter)
52
+ - **Mục tiêu:** Tránh hiện tượng AI bị "ảo giác" (hallucination), đọc tài liệu cũ rồi gọi các Page Class hoặc hàm không hề tồn tại trong code.
53
+ - **Quy tắc kiểm tra:** Quét toàn bộ Page Class và method được ghi trong `PROJECT_AI_GUIDE.md`, kiểm tra xem chúng có tồn tại thật trong AST codebase hay không.
54
+ - **Cách khắc phục:** Chạy `python3 tools/lint_ai_docs.py` để tìm dòng sai lệch, sau đó chạy `python3 tools/repo_map.py` để đồng bộ lại bản đồ code.
55
+
56
+ ### Gate 5: Chặn File Rác Lọt Vào Git
57
+ - **Mục tiêu:** Giữ git index luôn sạch sẽ, không bị phình dung lượng bởi rác build hoặc cache IDE.
58
+ - **Quy tắc kiểm tra:** Quét các đuôi file cấm: `*.tmp`, `*.dump`, `*.log`, `*.orig`, `*.bak`, `.ruff_cache/`, `.mypy_cache/`.
59
+ - **Cách khắc phục:** Khai báo các mẫu file này vào `.gitignore` và xóa bỏ các file tạm hiện có trong repo.
60
+
61
+ ### Gate 6: Quét Mật Khẩu & Token Bí Mật (Secret Sentinel)
62
+ - **Mục tiêu:** Chống rò rỉ thông tin nhạy cảm của dự án (API token, chuỗi kết nối DB, private key, mật khẩu).
63
+ - **Quy tắc kiểm tra:** Quét regex entropy cao để phát hiện chuỗi khóa bí mật AWS, Bearer token, RSA key và mật khẩu bị gán cứng.
64
+ - **Cách khắc phục:** Chuyển sang dùng biến môi trường hoặc file `.env` (nhớ thêm `.env` vào `.gitignore`).
65
+
66
+ ### Gate 7: Bắt Lỗi Tĩnh & Test Pass Ảo
67
+ - **Mục tiêu:** Loại bỏ triệt để các bài test do AI viết chạy xanh nhưng thực chất là vô dụng:
68
+ - **Quy tắc kiểm tra:**
69
+ - Bắt các bài test có **0 câu lệnh assert**.
70
+ - Bắt các khối try-catch rỗng (`except Exception: pass`) nuốt mất lỗi khi test fail.
71
+ - Bắt các lệnh sleep cứng (`sleep(5000)`, `Thread.sleep(5000)`).
72
+ - Bắt assertion của Playwright bị quên `await` (`expect(el).toBeVisible()` thiếu `await`).
73
+ - **Cách khắc phục:** Bổ sung assert thực tế; thay toàn bộ `sleep` cố định bằng smart wait (`waitForLoadState('networkidle')`, kiểm tra element hiển thị).
74
+
75
+ ### Gate 8: Đo Độ Nhạy Của Assert (Micro-Mutation Testing)
76
+ - **Mục tiêu:** Đảm bảo các câu lệnh assert có giá trị kiểm thử thật sự, không phải là biểu thức "luôn luôn đúng" (tautology).
77
+ - **Quy tắc kiểm tra:** Tự động tiêm các đột biến cú pháp (đổi `==` thành `!=`, đảo boolean `True` sang `False`, thay giá trị return). Yêu cầu test phải bắt trượt và diệt được ít nhất 80% đột biến (Mutation Score $\ge 80\%$).
78
+ - **Cách khắc phục:** Chạy `python3 tools/micro_mutator.py --strict` để xem mutant nào còn sống sót và siết chặt lại assertion.
79
+
80
+ ### Gate 9: Điều Phối Kỹ Năng Tránh Trùng Lặp
81
+ - **Mục tiêu:** Tránh việc AI kích hoạt nhầm kỹ năng do mô tả trong các file `SKILL.md` bị chồng chéo nhau.
82
+ - **Quy tắc kiểm tra:** Tính độ tương đồng cosine giữa phần mô tả của từng cặp kỹ năng. Yêu cầu chỉ số tương đồng phải $< 0.75$.
83
+ - **Cách khắc phục:** Viết lại mô tả kỹ năng theo công thức chuẩn: `[Tính năng] + Dùng khi [ngữ cảnh cụ thể]` (tối đa 350 ký tự).
84
+
85
+ ### Gate 10: Kiểm Soát Hiệu Năng & SLA (Performance & SLA Sentinel)
86
+ - **Mục tiêu:** Chặn đứng các bản build hoặc mã gây suy thoái độ trễ nghiêm trọng (latency regressions hoặc lỗi quá ngưỡng) trước khi merge hoặc deploy.
87
+ - **Quy tắc kiểm tra:** Tự động phát hiện và phân tích kết quả chạy tải trong `Reports/perf/` (`.jtl`, `.csv`, `k6_summary.json`). Báo lỗi (Exit Code 1) nếu P95 > 500ms, P99 > 1000ms hoặc Error Rate > 1.0%. Tự động ghi nhận `PASS (SKIPPED)` trong < 1ms nếu dự án không phát sinh file kết quả chạy tải.
88
+ - **Cách khắc phục:** Tối ưu hóa API/DB query, kiểm tra tài nguyên hệ thống, hoặc tùy chỉnh lại ngưỡng SLA trong `synapse.config.json` theo yêu cầu dự án.
89
+
90
+ ---
91
+
92
+ ## 🚀 Cách Chạy & Tích Hợp Vào CI/CD
93
+
94
+ ### Chạy Cục Bộ Trên Máy:
95
+ ```bash
96
+ # Kiểm định toàn bộ 11 Cổng trên repo hiện tại
97
+ python3 tools/verify_all.py
98
+
99
+ # Kiểm định dự án test mục tiêu từ Hub
100
+ python3 tools/verify_all.py --target /duong-dan/toi/du-an-test
101
+
102
+ # Xuất kết quả ra file JUnit XML để CI/CD đọc
103
+ python3 tools/verify_all.py --format junit --output reports/dod_gates.xml
104
+ ```
105
+
106
+ ### Đường Ống GitHub Actions (`.github/workflows/verify.yml`):
107
+ ```yaml
108
+ name: Synapse Hub 11 DoD Quality Gates
109
+ on: [push, pull_request]
110
+
111
+ jobs:
112
+ quality-gates:
113
+ runs-on: ubuntu-latest
114
+ steps:
115
+ - uses: actions/checkout@v4
116
+ - uses: actions/setup-python@v5
117
+ with:
118
+ python-version: '3.11'
119
+ - name: Run 11 Quality Gates
120
+ run: python tools/verify_all.py --mode target
121
+ ```
@@ -0,0 +1,41 @@
1
+ # Enterprise Token & Context Engineering Playbook (AI QA Hub)
2
+
3
+ > **Objective:** Maximize AI Agent performance, eliminate context rot, and optimize token quota across the automated test engineering lifecycle.
4
+
5
+ ---
6
+
7
+ ## 1. AI Model Allocation Matrix
8
+
9
+ Avoid depleting high-tier model quotas by applying the **"Right Task - Right Model"** strategy:
10
+
11
+ | AI Model Tier | Capability & Relative Cost | Recommended QA Workloads | Token Consumption |
12
+ | :--- | :--- | :--- | :--- |
13
+ | **Claude Sonnet / Opus / GPT-4o** | ⭐⭐⭐ High | • Complex logic, nested Shadow DOM / iFrames<br>• Race conditions & complex async synchronization<br>• Flaky test root-cause autopsy & Clean POM refactoring | 🔴 Expensive (Use selectively) |
14
+ | **Gemini Pro / Claude 3.5 Sonnet** | ⭐⭐ Balanced | • Everyday POM code generation, assertions, locator updates<br>• User Story to automated test transpilation<br>• Unit tests, REST API stubs & mock routes | 🟡 Moderate |
15
+ | **Gemini Flash / Claude Haiku** | ⭐ High-Speed & Low-Cost | • Parsing multi-thousand-line CI/CD logs (`distill_log.py`)<br>• Generating synthetic test data (JSON/CSV rows)<br>• Compact AOM extraction & DOM structure filtering<br>• Summaries, documentation, commit messages | 🟢 Ultra-economical |
16
+
17
+ ---
18
+
19
+ ## 2. Operational Mode Strategy
20
+
21
+ - **Planning Mode:**
22
+ - Bootstrap new test automation frameworks from scratch.
23
+ - Architect multi-tier Page Object Model hierarchies for large modules.
24
+ - Analyze complex End-to-End user journeys traversing multiple microservices.
25
+ - **Fast / Chat Mode:**
26
+ - Add individual test cases to existing Page Classes.
27
+ - Heal single selectors after UI builds.
28
+ - Debug and re-run isolated test scripts.
29
+
30
+ ---
31
+
32
+ ## 3. Context Window Invariants (Zero Context Rot)
33
+
34
+ 1. **Progressive Disclosure (Never Load Large Files Whole):**
35
+ - Never load classes over 500 lines into the active conversation prompt.
36
+ - Query `tools/repo_map.txt` for method signatures first (~500 tokens). Micro-read targeted 20-50 line slices (`StartLine`, `EndLine`).
37
+ 2. **Log Distillation (`distill_log.py`):**
38
+ - Never dump thousands of lines of raw build/runner output.
39
+ - Run `python3 tools/distill_log.py <path_to_log>` to filter out 95% noise, extracting only the exact failure line and last 3 HTTP requests.
40
+ 3. **Compaction State Anchoring (`project_state.py`):**
41
+ - Antigravity automatically triggers Context Compaction near the ~135k token threshold. Ensure active test run statuses and defect IDs are persisted to `PROJECT_STATE.md` on disk to avoid lossy state compression.
@@ -0,0 +1,129 @@
1
+ # Synapse Hub — Tooling Ecosystem Catalog & Runbook
2
+
3
+ > **Audience:** QA Engineers, Autonomous AI Agents (Lead Orchestrator, POM-Crafter, Test-Runner, Failure-Analyst, Quality-Gatekeeper).
4
+ > **Total Tools Cataloged:** `111` | **Stable:** `111` | **Experimental:** `0`
5
+
6
+ ## 1. Primary Enterprise CLI Tools
7
+
8
+ | Command | Category | Owner Role | Status | Risk Level | Description |
9
+ |---|---|:---:|:---:|:---:|---|
10
+ | `python tools/_openapi_parser.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/_openapi_parser.py — Shared OpenAPI & Swagger Specification Parser |
11
+ | `python tools/agent_canary.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | ENTERPRISE AUTONOMOUS AGENT Canary & Mutation Testing Arena |
12
+ | `python tools/agentless_patcher.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Agentless 3-Stage Deterministic Patcher (OpenAutoCoder Agentless Pattern) |
13
+ | `python tools/analyze_project.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Comprehensive health audit analyzing environment, POM structure, and Quality Gates. |
14
+ | `python tools/api_drift_sentinel.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Detects contract drift and breaking schema mutations against OpenAPI specifications. |
15
+ | `python tools/api_fuzzer.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Autonomous API Fuzzing & Chaos Breaker |
16
+ | `python tools/author_integrity.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/author_integrity.py — Author Attribution & MIT License Compliance Guard |
17
+ | `python tools/auto_heal.py` | **Failure Autopsy & Healing** | `failure-analyst` | 🟢 Stable | `modifying` | Closed-loop locator self-healing engine matching broken selectors against DOM/AOM. |
18
+ | `python tools/auto_heal_reflexion.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Multi-Trial Episodic Reflexion Loop for Autonomous Healing (Noah Shinn / Reflexion Pattern) |
19
+ | `python tools/autogen_qa_broker.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Asynchronous Actor QA Message Broker (Microsoft AutoGen v0.4+ Pattern) |
20
+ | `python tools/benchmark_swarm_context.py` | **Benchmarking** | `orchestrator` | 🟢 Stable | `read_only` | Empirical context token reduction benchmark harness proving >= 40% savings. |
21
+ | `python tools/browsergym_eval.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | BrowserGym Web Agent Benchmark Harness (BrowserGym / WebArena Pattern) |
22
+ | `python tools/bug_reporter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Auto-Bug Reporter & Root Cause Analysis (RCA) Ticket Generator |
23
+ | `python tools/bump_version.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/bump_version.py — Atomic Universal Version Bumper for Synapse Hub |
24
+ | `python tools/cache_resolver.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Local Semantic Memory Cache & Self-Healing Resolver |
25
+ | `python tools/check_env.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | ============================================================================== |
26
+ | `python tools/check_version_sync.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/check_version_sync.py — Version Synchronization Sentinel for Synapse Hub |
27
+ | `python tools/ci_healing_hook.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | CI/CD Silent Self-Healing Pipeline Hook |
28
+ | `python tools/cli.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Agent-QA CLI Entrypoint |
29
+ | `python tools/config_decoupler.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Environment & Secret Decoupling Engine |
30
+ | `python tools/contract_validator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Swarm Data Contract Validator (Single Front-Door Integrity Guard) |
31
+ | `python tools/count_tokens.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Cross-Platform Token & Cost Auditor (Synapse-Hub) |
32
+ | `python tools/create_mock_docx.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Generates a lightweight valid mock DOCX fixture (< 20 KB) for OpenXML Guard / Word reader tests. |
33
+ | `python tools/dashboard_generator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/dashboard_generator.py — Standalone One-Page Enterprise QA HTML Dashboard |
34
+ | `python tools/db_sandbox.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Zero-Pollution Database Sandbox & Ephemeral Teardown Engine |
35
+ | `python tools/debt_harvester.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/debt_harvester.py — Technical Debt & Shortcut Harvester |
36
+ | `python tools/distill_log.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/distill_log.py — Cross-Platform Log Distiller for Katalon KRE, Gradle, and Playwright |
37
+ | `python tools/dspy_qa_signatures.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Declarative QA Signature Compilation Engine (Stanford DSPy Pattern) |
38
+ | `python tools/e2e_flow_prober.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise E2E Flow Prober & XPath Crawler Dispatcher (Cross-Platform) |
39
+ | `python tools/export_postman_collection.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Exports API test matrices into runnable Postman Collections with pre-request scripts. |
40
+ | `python tools/flaky_detector.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Flaky Test Detector & Quarantine Sentinel |
41
+ | `python tools/fsm_enforcer.py` | **Orchestration** | `orchestrator` | 🟢 Stable | `modifying` | 5-Stage QA Multi-Agent Finite State Machine enforcer with cryptographic proof tokens. |
42
+ | `python tools/fsm_middleware.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Runtime FSM Interceptor & Tool Proxy Middleware |
43
+ | `python tools/fuzz_payloads.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Edge-Case Fuzzing & Input Sanitization Payload Catalog |
44
+ | `python tools/generate_allure_report.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Allure HTML Report Generator (Cross-Platform) |
45
+ | `python tools/generate_api_matrix.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Converts OpenAPI/Swagger specs into automated positive, boundary, and negative test matrices. |
46
+ | `python tools/generate_jmx_plan.py` | **Performance Testing** | `perf-engineer` | 🟢 Stable | `read_only` | Enterprise Apache JMeter 5.x & Locust test plan generator from OpenAPI/Postman/HAR specs. |
47
+ | `python tools/generate_sbom.py` | **Security** | `orchestrator` | 🟢 Stable | `read_only` | Standard SPDX 2.3 JSON Software Bill of Materials (SBOM) generator for software supply chain security. |
48
+ | `python tools/generate_tc_from_story.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/generate_tc_from_story.py — Large Action Model (LAM) Script Generator |
49
+ | `python tools/generate_test_reports.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Test Report Aggregator & summaryTemp Generator (Cross-Platform) |
50
+ | `python tools/generate_tool_catalog.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/generate_tool_catalog.py — Enterprise Tooling Ecosystem Catalog Generator |
51
+ | `python tools/gherkin_suite.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `read_only` | Compiles Gherkin .feature specs into expanded test matrices and coverage reports. |
52
+ | `python tools/git_pre_commit_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Git Pre-Commit Architecture & Discipline Guard |
53
+ | `python tools/goldfish_review.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/goldfish_review.py — Zero-Context Test Specification Reviewer |
54
+ | `python tools/heal_pr_automator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Self-Healing Confidence Scorer & PR Automator |
55
+ | `python tools/heuristic_locator_matcher.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | 3-Layer Heuristic Locator Matcher (0-Token Autonomous Recovery) |
56
+ | `python tools/hub_publisher.py` | **CI/CD & Packaging** | `orchestrator` | 🟢 Stable | `modifying` | Autonomous 1-click 5-step release pipeline for Synapse Hub. |
57
+ | `python tools/humanize_linter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Humanize & Anti-AI Slop Linter (Enterprise QA Hub) |
58
+ | `python tools/infer_linter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal QA Static Defect & Assertion Sentinel (Inspired by facebook/infer) |
59
+ | `python tools/init_config.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/init_config.py — Standardized Project Configuration Bootstrapper |
60
+ | `python tools/interview_story.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `read_only` | Interactive requirement interrogation engine surfacing hidden assumptions and ambiguous acceptance criteria. |
61
+ | `python tools/jira_sync.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/jira_sync.py — Jira / Xray / Zephyr Enterprise 2-Way Synchronization Engine |
62
+ | `python tools/jtl_analyzer.py` | **Performance Testing** | `perf-engineer` | 🟢 Stable | `read_only` | Sub-0.1s Apache JMeter JTL results analyzer enforcing automated CI/CD SLA quality gates. |
63
+ | `python tools/lint_ai_docs.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise AI Documentation & Artifact Linter (Anti-Drift Guard v2.0) |
64
+ | `python tools/lookup_tc.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise QA: Fast Test Case Metadata Lookup (lookup_tc.py) |
65
+ | `python tools/lookup_xpath.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise QA: Fast XPath / Selector Lookup (lookup_xpath.py) |
66
+ | `python tools/matrix_sharder.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Duration-Balanced Test Matrix Sharder |
67
+ | `python tools/mcp_docx_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Cross-Platform MCP Docx Server (Zero-Dependency) |
68
+ | `python tools/mcp_excel_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Cross-Platform MCP Excel Server (Zero-Dependency) |
69
+ | `python tools/mcp_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Model Context Protocol (MCP) Standard Server |
70
+ | `python tools/md_to_xlsx.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Markdown to Excel (.xlsx) Enterprise Converter |
71
+ | `python tools/micro_mutator.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Syntactic micro-mutation sentinel eliminating tautological tests and measuring assertion sensitivity. |
72
+ | `python tools/mipro_assertion_tuner.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | MIPROv2 Prompt Assertion Tuner (Stanford DSPy v2 & Optuna TPE Pattern) |
73
+ | `python tools/network_mock_shield.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `modifying` | Network interception shield stubbing external routes and injecting chaos network faults. |
74
+ | `python tools/newman_analyzer.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Sub-0.1s Postman/Newman JSON test report analyzer enforcing CI/CD quality gates. |
75
+ | `python tools/omni_emitter.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `read_only` | Universal polyglot code generator emitting Clean POM Flat Architecture scripts. |
76
+ | `python tools/omni_parser.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `read_only` | Deterministic 0-token polyglot AST parser extracting Page Classes and test workflows. |
77
+ | `python tools/omni_transpiler.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `modifying` | Instant 0-token transpiler between Playwright, Selenium, and Katalon. |
78
+ | `python tools/openxml_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | OpenXML Security & Protocol Defense Guard |
79
+ | `python tools/output_formatter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Standardized Output Formatter & Exit Code Specification |
80
+ | `python tools/package_release.py` | **CI/CD & Packaging** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise release packager preserving .github/workflows and generating SHA-256 provenance. |
81
+ | `python tools/pinpoint_failure.py` | **Failure Autopsy & Healing** | `failure-analyst` | 🟢 Stable | `read_only` | Sub-0.1s JUnit XML autopsy parser diagnosing test crashes without LLM token waste. |
82
+ | `python tools/project_state.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Project State Machine & Token-Capped Memory Anchor |
83
+ | `python tools/qa_event_stream.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Immutable QA Event Stream Engine (OpenHands EventStream Pattern) |
84
+ | `python tools/repo_map.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Repository Map Compressor (Inspired by Aider-AI/aider) |
85
+ | `python tools/reversible_sandbox.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Reversible Execution Sandbox & Automated Teardown Engine (GoEx Pattern) |
86
+ | `python tools/safety_firewall.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Non-bypassable safety firewall blocking destructive operations (drop database, git push force, rm -rf). |
87
+ | `python tools/security_coverage_ledger.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Mathematical Security Coverage Ledger & Audit Tracker |
88
+ | `python tools/security_scanner.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Comprehensive enterprise security sentinel auditing Python & NPM dependencies and threat-model defense. |
89
+ | `python tools/senior_code_review.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/senior_code_review.py — Senior Developer Quality & Lean Diff Reviewer |
90
+ | `python tools/setup_project.py` | **Setup & Onboarding** | `orchestrator` | 🟢 Stable | `modifying` | Zero-command automated project bootstrap tailoring AI agent rules to the target stack. |
91
+ | `python tools/skill_collision_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Tier-2 Skill Routing & Collision Guard (Addy Osmani Pattern) |
92
+ | `python tools/skill_profiles.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/skill_profiles.py — Skill Catalog Capability Profile Manager |
93
+ | `python tools/skill_vault.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | SkillVault Lifelong Page Object Model & Interaction Library (MineDojo / Voyager Pattern) |
94
+ | `python tools/skillspector.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Security scanner detecting prompt injection, Unicode obfuscation, and dangerous CLI tools. |
95
+ | `python tools/smart_visual_masker.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Smart Visual Masker & Anti-Flake Visual Engine |
96
+ | `python tools/spec_drift_sentinel.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/spec_drift_sentinel.py — Spec-to-Code Drift Sentinel |
97
+ | `python tools/swe_qa_aci.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | QA Agent-Computer Interface (SWE-agent ACI Pattern) |
98
+ | `python tools/synapse_observer.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Synapse Cognitive Observer & Tradeoff Sentinel |
99
+ | `python tools/synapse_qa_bench.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Synapse-QA-Bench: Tool Function Calling Benchmark (Gorilla BFCL Pattern) |
100
+ | `python tools/sync_agent_rules.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/sync_agent_rules.py — Synchronizes AGENTS.md single-source rules to all AI bridges |
101
+ | `python tools/telemetry_correlator.py` | **Performance Testing** | `perf-engineer` | 🟢 Stable | `read_only` | Full-stack APM & server telemetry performance correlator linking client latencies with server hardware. |
102
+ | `python tools/template_excel_exporter.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `modifying` | Enterprise template-driven Excel test case exporter with dropdown Data Validation. |
103
+ | `python tools/test_impact.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Test Impact Analyzer (Graphify AST-Powered) |
104
+ | `python tools/test_memory_os.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Hierarchical QA Test Memory OS (Letta / MemGPT Pattern) |
105
+ | `python tools/textgrad_mutation_optimizer.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Mutant-Directed Textual Loss Optimizer (Deterministic TextGrad-Style Heuristic) |
106
+ | `python tools/tms_sync_bridge.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise ALM & TMS Sync Bridge (Jira / Xray / Zephyr / TestRail) |
107
+ | `python tools/tot_exploratory_tester.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `read_only` | Tree-of-Thoughts exploratory scenario generator with risk scoring and boundary decomposition. |
108
+ | `python tools/trace_data_flow.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Data Flow & Teardown Tracer (Taint Analysis) |
109
+ | `python tools/traffic_session_converter.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Converts recorded HAR traffic sessions into executable API automation test cases. |
110
+ | `python tools/trend_analytics.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/trend_analytics.py — Historical Quality Trend & Flakiness Analytics Engine |
111
+ | `python tools/ui_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/ui_server.py — Synapse Hub Interactive QA Mission Control Web Server |
112
+ | `python tools/universal_ir.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `read_only` | Language-agnostic and framework-agnostic AST data model for automated test suites. |
113
+ | `python tools/update_sentinel.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Synapse-Hub Auto-Update & Version Drift Sentinel |
114
+ | `python tools/validate_groovy_scripts.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Pre-check validator for Groovy scripts and POM keywords in enterprise test suites. |
115
+ | `python tools/verify_all.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | One-command 11 Quality Gates Definition of Done (DoD) verification sentinel. |
116
+ | `python tools/visual_diff_canvas.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Canvas Visual Diff & Regression Checker |
117
+ | `python tools/visual_som_helper.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Vision-Grounded Fallback & Set-of-Marks (SoM) Engine |
118
+ | `python tools/watch_mode.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/watch_mode.py — Incremental Watch Mode & Real-Time Test Engineering HUD |
119
+ | `python tools/wcag_audit.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/wcag_audit.py - Automated Accessibility (WCAG 2.2) Linter & Auditor |
120
+ | `python tools/welcome_page.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/welcome_page.py — Interactive Visual Landing Page for Synapse Hub |
121
+
122
+ ## 2. Risk & Operational Classification
123
+
124
+ - `read_only`: Diagnostic, linting, AST inspection, reporting (zero side effects on workspace or git).
125
+ - `modifying`: Generates files, updates Page Classes, or writes test suites.
126
+ - `network`: Queries external APIs, monitors npm registry, or checks live URLs.
127
+ - `destructive`: High-impact actions guarded by `safety_firewall.py` (e.g. drop database, hard resets).
128
+
129
+ *Catalog generated: `2026-11-12T08:56:38.327652+00:00` by `tools/generate_tool_catalog.py`*