@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
package/README.en.md ADDED
@@ -0,0 +1,172 @@
1
+ # 🧠 Synapse Hub — AI Test Quality Linter & Guardrails
2
+
3
+ ### *The Test Quality Linter & Guardrails for the Era of AI-Generated Code*
4
+
5
+ [🇻🇳 Tiếng Việt](README.md) | [🇬🇧 English Edition](README.en.md)
6
+
7
+ > **Core Mission:** A standalone linter and guardrail engine (zero external dependencies for core engine & DoD gates) safeguarding automated test suites when AI writes code — Automatically catching "fake-pass" tests (0 assertions, tautologies), eliminating fixed sleeps, compressing 95% of CI/CD log noise, and enforcing Clean POM architecture.
8
+ > **Author:** Thế Vị ([@TeeVee998](https://github.com/TeeVee998)) | **License:** MIT License
9
+ > **Version:** `v3.8.2` | **Scale:** 53 Standardized QA Skills, 9 Specialized AI Agents, 11 DoD Quality Gates.
10
+
11
+ [![npm version](https://img.shields.io/npm/v/synapse-hub.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/synapse-hub)
12
+ [![node version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
13
+ [![python version](https://img.shields.io/badge/python-%3E%3D3.10-blue.svg?style=flat-square)](https://python.org)
14
+ [![Quality Gates](https://img.shields.io/badge/Quality%20Gates-11%2F11%20DoD%20PASS-success.svg?style=flat-square)](docs/QUALITY_GATES.en.md)
15
+ [![Tests](https://img.shields.io/badge/tests-700%2B%20passing-brightgreen.svg?style=flat-square)](#)
16
+ [![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](https://github.com/TeeVee998/Synapse-Hub/blob/main/LICENSE)
17
+ [![Ecosystem](https://img.shields.io/badge/AI%20Ecosystem-Antigravity%20%7C%20Cursor%20%7C%20Claude%20%7C%20Copilot%20%7C%20Windsurf-orange.svg?style=flat-square)](#)
18
+
19
+ ---
20
+
21
+ ## 💡 What Problem Does Synapse Hub Solve?
22
+
23
+ When software engineers and QA teams use AI coding assistants (Cursor, Copilot, Claude Code, Antigravity) to write automated tests, AI often produces fragile code patterns:
24
+
25
+ | When AI Writes Tests Without Guardrails | When Protected by Synapse Hub 🛡️ |
26
+ | :--- | :--- |
27
+ | ❌ **"Fake-Pass" Tests:** Green checkmark, but contains **0 assertions** — verifies nothing. | ✅ **Detected in 0.1s:** Flags empty tests and requires concrete assertions. |
28
+ | ❌ **Hardcoded Sleeps:** Spams `sleep(5000)` indiscriminately, causing flaky CI builds. | ✅ **Smart Waits Enforced:** Flags hardcoded delays and guides dynamic wait adoption. |
29
+ | ❌ **AI Context Overflow:** 20,000-line CI logs overwhelm LLM context windows. | ✅ **95% Log Noise Distilled:** Isolates exact failing stacktraces in ~30 lines. |
30
+ | ❌ **Security Leaks:** Accidental commits containing plaintext tokens or passwords. | ✅ **Gate 6 Sentinel:** Detects and blocks hardcoded secrets before commit. |
31
+
32
+ ```mermaid
33
+ flowchart LR
34
+ subgraph Inputs["1. Initial Test Generation"]
35
+ AI["👨‍💻 <b>Developers / QA using AI</b><br/><i>(Cursor, Claude Code, Antigravity, Copilot)</i>"]
36
+ -->|Generates unverified tests| Raw["📄 <b>Raw Automated Test Scripts</b><br/><i>(Playwright, Pytest, Cypress, Katalon)</i>"]
37
+ end
38
+
39
+ subgraph Hub["🛡️ Synapse Hub — AST Linter & 11 DoD Quality Gates"]
40
+ direction LR
41
+ Linter["🔍 <b>Static AST Sentinel</b><br/>• Catches 0-assert fake passes<br/>• Eliminates flaky static sleeps<br/>• Blocks swallowed exceptions"]
42
+ --> CleanPOM["🏛️ <b>Clean POM Guard</b><br/>• Forbids raw XPath/CSS in scripts<br/>• 100% encapsulated in BasePage<br/>• Enforces Flat Architecture"]
43
+ --> Mutator["🧬 <b>Micro-Mutation</b><br/>• Injects syntactic logic faults<br/>• Enforces Kill Score &gt;= 80%<br/>• Eliminates weak assertions"]
44
+ --> Security["🔒 <b>Security & License</b><br/>• Blocks plaintext secrets/tokens<br/>• Prevents credential leakage<br/>• Preserves MIT @TeeVee998"]
45
+ end
46
+
47
+ subgraph Outputs["3. Verified Deliverables"]
48
+ direction TB
49
+ Pass["✅ <b>Production-Ready Test Suite</b><br/><i>(Approved for PR Merge & Green CI/CD)</i>"]
50
+ Distill["⚡ <b>95% Log Noise Distillation</b><br/><i>(distill_log: pinpoints root cause in ~30 lines)</i>"]
51
+ Reject["❌ <b>Hard Block Unreliable Tests</b><br/><i>(Triggers autonomous Reflexion K=3 self-healing)</i>"]
52
+ end
53
+
54
+ Raw ==>|Ingest for verification| Linter
55
+ Security ==>|Passed 11/11 DoD Gates| Pass
56
+ Security -.->|On CI Test Failure| Distill
57
+ Security -.->|Quality Violation| Reject
58
+
59
+ classDef passClass fill:#1b4725,stroke:#2ea043,stroke-width:2px;
60
+ classDef rejectClass fill:#4c1d1d,stroke:#da3633,stroke-width:2px;
61
+ classDef distillClass fill:#3b2d12,stroke:#d29922,stroke-width:2px;
62
+ class Pass passClass;
63
+ class Reject rejectClass;
64
+ class Distill distillClass;
65
+ ```
66
+
67
+ ---
68
+
69
+ ## ⚡ Quickstart in 60 Seconds (One-Command Onboarding 🚀)
70
+
71
+ You **never need to memorize** 53 skills or 90 internal tools. Synapse Hub activates autonomously when needed:
72
+
73
+
74
+ ```bash
75
+ # 1. Diagnose system prerequisites (Node, Python, Chrome, Git):
76
+ npx synapse-hub doctor
77
+
78
+ # 2. Activate protection for your test project (Playwright, Pytest, Cypress, Katalon):
79
+ npx synapse-hub setup --target /path/to/test-repo
80
+
81
+ # 3. Scan for fake-passes and hardcoded sleeps instantly:
82
+ npx synapse-hub lint ./tests
83
+
84
+ # 4. Verify the 11 DoD Quality Gates before pushing code:
85
+ npx synapse-hub verify
86
+ ```
87
+
88
+ > 💡 **Tip:** Install globally to invoke `synapse-hub <command>` directly without `npx`:
89
+ > `npm install -g synapse-hub` (or via Python: `pip install agent-qa`)
90
+
91
+ > 📦 **Enterprise Reference Test Suites:** Inspect working sample projects adhering to Clean POM & Guardrails in [`examples/`](examples/):
92
+ > [🎭 Playwright TS](examples/playwright-crm-suite) • [🌲 Cypress E2E](examples/cypress-ecommerce-suite) • [🐍 Pytest API](examples/pytest-api-suite) • [☕ Katalon Studio](examples/katalon-suite) • [🌐 Selenium Java](examples/selenium-suite)
93
+
94
+ ---
95
+
96
+ ## 🛠️ Daily Core CLI Commands
97
+
98
+ ```bash
99
+ # Catch fake-passes, hard sleeps, and swallowed exceptions (Polyglot TS/JS, Python, Groovy):
100
+ synapse-hub lint ./tests
101
+
102
+ # Run the comprehensive 11 Quality Gates Definition of Done (DoD) suite:
103
+ synapse-hub verify
104
+
105
+ # Generate an actionable executive project health report (PROJECT_HEALTH_REPORT.md):
106
+ synapse-hub analyze
107
+
108
+ # Distill 95% of CI log noise down to the true root cause and stacktrace:
109
+ synapse-hub distill path/to/ci.log
110
+
111
+ # Export User Stories into standard 12-column Excel sheets with P x I risk matrices:
112
+ synapse-hub export-excel
113
+
114
+ # Measure test assertion sensitivity via micro-mutation testing (~0.1s):
115
+ synapse-hub mutate ./tests
116
+ ```
117
+
118
+ ---
119
+
120
+ ## 🛡️ The 11 Definition-of-Done (DoD) Quality Gates
121
+
122
+ Every test code change must satisfy all 11 Quality Gates before pull request merge:
123
+
124
+ - **Gate 0:** Author Attribution & MIT License Provenance
125
+ - **Gate 1:** UTF-8 No BOM Clean Encoding (Zero corrupting BOM bytes)
126
+ - **Gate 2:** Path Portability (Zero hardcoded machine-specific absolute paths)
127
+ - **Gate 3:** Clean POM Flat Architecture (Zero locators inside test scripts)
128
+ - **Gate 4:** AI Docs Anti-Drift (Zero hallucinated PageClasses in AI guides)
129
+ - **Gate 5:** Temporary File Blacklist (Zero scratch files or binary dumps)
130
+ - **Gate 6:** Credential Security Sentinel (Zero plaintext secrets or API keys)
131
+ - **Gate 7:** Static Defect & Fake-Pass Sentinel (Zero 0-assert tests, zero sleeps)
132
+ - **Gate 8:** Assertion Sensitivity Sentinel (Syntactic Mutation Score $\ge 80\%$)
133
+ - **Gate 9:** Skill Routing & Collision Guard (Trigger similarity $< 0.75$)
134
+ - **Gate 10:** Performance & SLA Sentinel (P95 $\le$ 500ms, Error Rate $\le$ 1.0%)
135
+
136
+ *(For detailed gate specifications and remediation guides, see [docs/QUALITY_GATES.en.md](docs/QUALITY_GATES.en.md)).*
137
+
138
+ ---
139
+
140
+ ## 🔄 CI/CD & Pre-commit Integration
141
+
142
+ ```yaml
143
+ # GitHub Actions (.github/workflows/verify.yml):
144
+ - name: Run Synapse Hub Quality Gates
145
+ uses: TeeVee998/Synapse-Hub@v2
146
+ with:
147
+ mode: 'target'
148
+
149
+ # Or run directly on any CI provider (GitLab CI, Bitbucket, Jenkins):
150
+ - name: Run Synapse Hub Quality Gates
151
+ run: npx synapse-hub verify
152
+ ```
153
+
154
+ ```yaml
155
+ # Pre-commit hook (.pre-commit-config.yaml):
156
+ repos:
157
+ - repo: https://github.com/TeeVee998/Synapse-Hub
158
+ rev: v3.8.2
159
+ hooks:
160
+ - id: synapse-lint
161
+ - id: synapse-verify
162
+ ```
163
+
164
+ ---
165
+
166
+ ## 📚 Deep Technical Documentation
167
+
168
+ - 🏛️ **Architecture & Industry Comparison Matrix:** [docs/ARCHITECTURE.en.md](docs/ARCHITECTURE.en.md)
169
+ - 🛡️ **11 Quality Gates Definition of Done (DoD):** [docs/QUALITY_GATES.en.md](docs/QUALITY_GATES.en.md)
170
+ - 📖 **Comprehensive CLI Command Reference:** [docs/CLI_REFERENCE.en.md](docs/CLI_REFERENCE.en.md)
171
+ - 🚀 **CI/CD Pipeline Integration Playbook:** [docs/CI_CD_INTEGRATION.en.md](docs/CI_CD_INTEGRATION.en.md)
172
+ - 🤝 **Open-Source Contributing Guidelines:** [docs/CONTRIBUTING.en.md](docs/CONTRIBUTING.en.md)
package/README.md CHANGED
@@ -1,3 +1,172 @@
1
- # Temporary Holding Version
1
+ # 🧠 Synapse Hub — AI Test Quality Linter & Guardrails
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ ### *Bộ Linter & Chốt Chặn Chất Lượng Test Dành Cho Thời Đại AI Viết Code*
4
+
5
+ [🇻🇳 Tiếng Việt](README.md) | [🇬🇧 English Edition](README.en.md)
6
+
7
+ > **Định vị cốt lõi:** Bộ Linter & Guardrails độc lập (zero external dependencies cho core engine & DoD gates) bảo vệ độ tin cậy của test suite khi AI viết code — Tự động bắt test "pass ảo" (0 assert, tautology), loại bỏ hoàn toàn sleep cố định, nén 95% log CI/CD, và chuẩn hóa cấu trúc Clean POM.
8
+ > **Tác giả:** Thế Vị ([@TeeVee998](https://github.com/TeeVee998)) | **Giấy phép:** MIT License
9
+ > **Phiên bản:** `v3.8.2` | **Quy mô:** 53 Kỹ năng QA, 9 Vai trò AI Agent, 11 Cổng kiểm định DoD.
10
+
11
+ [![npm version](https://img.shields.io/npm/v/synapse-hub.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/synapse-hub)
12
+ [![node version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
13
+ [![python version](https://img.shields.io/badge/python-%3E%3D3.10-blue.svg?style=flat-square)](https://python.org)
14
+ [![Quality Gates](https://img.shields.io/badge/Quality%20Gates-11%2F11%20DoD%20PASS-success.svg?style=flat-square)](docs/QUALITY_GATES.md)
15
+ [![Tests](https://img.shields.io/badge/tests-700%2B%20passing-brightgreen.svg?style=flat-square)](#)
16
+ [![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](https://github.com/TeeVee998/Synapse-Hub/blob/main/LICENSE)
17
+ [![Ecosystem](https://img.shields.io/badge/AI%20Ecosystem-Antigravity%20%7C%20Cursor%20%7C%20Claude%20%7C%20Copilot%20%7C%20Windsurf-orange.svg?style=flat-square)](#)
18
+
19
+ ---
20
+
21
+ ## 💡 Synapse Hub Giải Quyết Vấn Đề Gì?
22
+
23
+ Khi lập trình viên và QA dùng AI (Cursor, Copilot, Claude Code, Antigravity) để viết test tự động, AI thường sinh ra mã kiểm thử có vấn đề:
24
+
25
+ | Khi để AI tự viết test (Chưa có Synapse) | Khi có Synapse Hub gác cổng 🛡️ |
26
+ | :--- | :--- |
27
+ | ❌ **Test "pass ảo":** Chạy xanh nhưng có **0 câu lệnh assert**, không kiểm tra gì cả. | ✅ **Phát hiện trong 0.1s:** Báo lỗi test rỗng, bắt buộc assertion có ý nghĩa. |
28
+ | ❌ **Dùng sleep cứng:** Chèn `sleep(5000)` bừa bãi làm test chậm và flaky trên CI. | ✅ **Ép dùng Smart Wait:** Tự động phát hiện và hướng dẫn thay thế smart wait. |
29
+ | ❌ **Tràn context AI:** Log CI dài 20.000 dòng làm AI quá tải, tốn token vô ích. | ✅ **Nén sạch 95% log:** Cô đọng còn ~30 dòng stacktrace nguyên nhân gốc. |
30
+ | ❌ **Thủng bảo mật:** AI vô tình commit mật khẩu hoặc API token dạng plaintext. | ✅ **Chốt chặn Gate 6:** Quét và chặn đứng chuỗi nhạy cảm trước khi commit. |
31
+
32
+ ```mermaid
33
+ flowchart LR
34
+ subgraph Inputs["1. Mã Kiểm Thử Ban Đầu"]
35
+ AI["👨‍💻 <b>Lập trình viên / QA dùng AI</b><br/><i>(Cursor, Claude Code, Antigravity, Copilot)</i>"]
36
+ -->|Sinh mã thô| Raw["📄 <b>Mã test tự động chưa kiểm định</b><br/><i>(Playwright, Pytest, Cypress, Katalon)</i>"]
37
+ end
38
+
39
+ subgraph Hub["🛡️ Synapse Hub — Bộ Linter & 11 Cổng Chất Lượng DoD"]
40
+ direction LR
41
+ Linter["🔍 <b>Cú Pháp Tĩnh AST</b><br/>• Bắt test 0-assert & pass ảo<br/>• Loại bỏ hoàn toàn sleep cố định<br/>• Ngăn nuốt ngoại lệ try-catch"]
42
+ --> CleanPOM["🏛️ <b>Chuẩn Clean POM</b><br/>• Cấm raw XPath/CSS trong script<br/>• Đóng gói 100% vào BasePage<br/>• Chuẩn hóa Flat Architecture"]
43
+ --> Mutator["🧬 <b>Micro-Mutation</b><br/>• Bơm đột biến vào câu assert<br/>• Bắt buộc Kill Score &gt;= 80%<br/>• Diệt sạch test assertion yếu"]
44
+ --> Security["🔒 <b>Bảo Mật & Bản Quyền</b><br/>• Quét sạch token/mật khẩu<br/>• Chặn leak biến môi trường<br/>• Giữ bản quyền Thế Vị @TeeVee998"]
45
+ end
46
+
47
+ subgraph Outputs["3. Đầu Ra Đã Kiểm Định"]
48
+ direction TB
49
+ Pass["✅ <b>Test Suite Chuẩn Doanh Nghiệp</b><br/><i>(Đủ điều kiện Merge PR / Xanh CI/CD)</i>"]
50
+ Distill["⚡ <b>Cô Đọng 95% Log Lỗi (distill_log)</b><br/><i>(Chỉ giữ ~30 dòng stacktrace gốc)</i>"]
51
+ Reject["❌ <b>Hard Block Test Rác</b><br/><i>(Chặn đứng lỗi, tự sửa Reflexion K=3)</i>"]
52
+ end
53
+
54
+ Raw ==>|Nạp vào kiểm định| Linter
55
+ Security ==>|Đạt 11/11 Cổng DoD| Pass
56
+ Security -.->|Phát hiện lỗi CI| Distill
57
+ Security -.->|Vi phạm chất lượng| Reject
58
+
59
+ classDef passClass fill:#1b4725,stroke:#2ea043,stroke-width:2px;
60
+ classDef rejectClass fill:#4c1d1d,stroke:#da3633,stroke-width:2px;
61
+ classDef distillClass fill:#3b2d12,stroke:#d29922,stroke-width:2px;
62
+ class Pass passClass;
63
+ class Reject rejectClass;
64
+ class Distill distillClass;
65
+ ```
66
+
67
+ ---
68
+
69
+ ## ⚡ Bắt Đầu Nhanh Trong 60 Giây (1 Lệnh Khởi Chạy 🚀)
70
+
71
+ Bạn **không cần học hay ghi nhớ** 53 kỹ năng hay các công cụ bên trong. Synapse Hub hoạt động tự động khi cần:
72
+
73
+
74
+ ```bash
75
+ # 1. Chẩn đoán môi trường hệ thống (Node, Python, Chrome, Git):
76
+ npx synapse-hub doctor
77
+
78
+ # 2. Kích hoạt bảo vệ dự án kiểm thử của bạn (Playwright, Pytest, Cypress, Katalon):
79
+ npx synapse-hub setup --target /duong-dan/toi/du-an-test
80
+
81
+ # 3. Quét lỗi test pass ảo & sleep cứng ngay lập tức:
82
+ npx synapse-hub lint ./tests
83
+
84
+ # 4. Kiểm định 11 Cổng Chất Lượng DoD trước khi đẩy code:
85
+ npx synapse-hub verify
86
+ ```
87
+
88
+ > 💡 **Mẹo:** Cài đặt toàn cục để gõ trực tiếp `synapse-hub <lệnh>` không cần tiền tố `npx`:
89
+ > `npm install -g synapse-hub` (hoặc qua Python: `pip install agent-qa`)
90
+
91
+ > 📦 **Kho Dự Án Mẫu Doanh Nghiệp (Reference Suites):** Xem các dự án mẫu đã chuẩn hóa Clean POM & Guardrails tại [`examples/`](examples/):
92
+ > [🎭 Playwright TS](examples/playwright-crm-suite) • [🌲 Cypress E2E](examples/cypress-ecommerce-suite) • [🐍 Pytest API](examples/pytest-api-suite) • [☕ Katalon Studio](examples/katalon-suite) • [🌐 Selenium Java](examples/selenium-suite)
93
+
94
+ ---
95
+
96
+ ## 🛠️ Các Lệnh CLI Cốt Lõi Hàng Ngày
97
+
98
+ ```bash
99
+ # Bắt test pass ảo, sleep cố định, try-catch nuốt lỗi (đa ngôn ngữ TS/JS, Python, Groovy):
100
+ synapse-hub lint ./tests
101
+
102
+ # Chạy toàn diện 11 Cổng Kiểm Định DoD (Definition of Done):
103
+ synapse-hub verify
104
+
105
+ # Chẩn đoán và xuất báo cáo sức khỏe dự án (PROJECT_HEALTH_REPORT.md):
106
+ synapse-hub analyze
107
+
108
+ # Nén 95% log CI thừa — lọc đúng nguyên nhân gốc rễ và stacktrace:
109
+ synapse-hub distill path/to/ci.log
110
+
111
+ # Xuất User Story thành file Excel chuẩn 12 cột kèm ma trận rủi ro:
112
+ synapse-hub export-excel
113
+
114
+ # Đo độ nhạy của các câu lệnh assert (Micro-Mutation testing ~0.1s):
115
+ synapse-hub mutate ./tests
116
+ ```
117
+
118
+ ---
119
+
120
+ ## 🛡️ 11 Cổng Kiểm Định Chất Lượng (DoD Gates)
121
+
122
+ Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 11 Cổng Chất Lượng trước khi merge PR:
123
+
124
+ - **Gate 0:** Bảo Toàn Tác Quyền & MIT License Provenance
125
+ - **Gate 1:** Mã Hóa Chuẩn 100% UTF-8 No BOM (Zero byte rác)
126
+ - **Gate 2:** Đường Dẫn Linh Hoạt (Zero hardcoded absolute paths)
127
+ - **Gate 3:** Kiến Trúc Clean POM (Flat Architecture) (Zero locator trong test script)
128
+ - **Gate 4:** Chống Lệch Tài Liệu AI (Zero hallucinated PageClasses)
129
+ - **Gate 5:** Danh Sách Đen File Tạm (Zero `.tmp`, heap dump làm bẩn git)
130
+ - **Gate 6:** Bảo Vệ Bí Mật & Mật Khẩu (Zero hardcoded credentials)
131
+ - **Gate 7:** Quét Lỗi Tĩnh & Bắt Test Pass Ảo (Zero 0-assert, zero sleep)
132
+ - **Gate 8:** Đo Độ Nhạy Assert Micro-Mutation (Mutation Score $\ge 80\%$)
133
+ - **Gate 9:** Điều Phối Kỹ Năng & Ngăn Xung Đột (Similarity $< 0.75$)
134
+ - **Gate 10:** Kiểm Soát Hiệu Năng & SLA Sentinel (P95 $\le$ 500ms, Error Rate $\le$ 1.0%)
135
+
136
+ *(Xem chi tiết tiêu chuẩn, mã lỗi và cách khắc phục tại [docs/QUALITY_GATES.md](docs/QUALITY_GATES.md)).*
137
+
138
+ ---
139
+
140
+ ## 🔄 Tích Hợp CI/CD & Pre-commit Hook
141
+
142
+ ```yaml
143
+ # GitHub Actions (.github/workflows/verify.yml):
144
+ - name: Run Synapse Hub Quality Gates
145
+ uses: TeeVee998/Synapse-Hub@v2
146
+ with:
147
+ mode: 'target'
148
+
149
+ # Hoặc chạy trực tiếp trên bất kỳ CI nào (GitLab, Bitbucket, Jenkins):
150
+ - name: Run Synapse Hub Quality Gates
151
+ run: npx synapse-hub verify
152
+ ```
153
+
154
+ ```yaml
155
+ # Pre-commit hook (.pre-commit-config.yaml):
156
+ repos:
157
+ - repo: https://github.com/TeeVee998/Synapse-Hub
158
+ rev: v3.8.2
159
+ hooks:
160
+ - id: synapse-lint
161
+ - id: synapse-verify
162
+ ```
163
+
164
+ ---
165
+
166
+ ## 📚 Tài Liệu Kỹ Thuật Chuyên Sâu
167
+
168
+ - 🏛️ **Kiến Trúc & Bảng So Sánh Chi Tiết:** [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
169
+ - 🛡️ **Đặc Tả 11 Cổng Chất Lượng (DoD):** [docs/QUALITY_GATES.md](docs/QUALITY_GATES.md)
170
+ - 📖 **Cẩm Nang Tra Cứu Lệnh CLI:** [docs/CLI_REFERENCE.md](docs/CLI_REFERENCE.md)
171
+ - 🚀 **Hướng Dẫn Tích Hợp CI/CD:** [docs/CI_CD_INTEGRATION.md](docs/CI_CD_INTEGRATION.md)
172
+ - 🤝 **Hướng Dẫn Đóng Góp:** [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)
package/action.yml ADDED
@@ -0,0 +1,51 @@
1
+ name: "Synapse Hub Quality Sentinel"
2
+ description: "Zero-dependency enterprise AI QA gatekeeper: verifies 11 DoD Quality Gates, detects fake-passes, and blocks flakiness in CI."
3
+ author: "Thế Vị (@TeeVee998)"
4
+
5
+ inputs:
6
+ mode:
7
+ description: "Verification mode: 'target' (for testing projects) or 'hub' (for skills hub)"
8
+ required: false
9
+ default: "target"
10
+ format:
11
+ description: "Report output format: 'text', 'json', or 'junit'"
12
+ required: false
13
+ default: "text"
14
+ test-cmd:
15
+ description: "Optional test execution command for Gate 8 dynamic mutation testing (e.g. 'pytest' or 'npx playwright test')"
16
+ required: false
17
+ default: ""
18
+ config:
19
+ description: "Path to optional synapse.config.json"
20
+ required: false
21
+ default: ""
22
+
23
+ branding:
24
+ icon: "shield"
25
+ color: "blue"
26
+
27
+ runs:
28
+ using: "composite"
29
+ steps:
30
+ - name: Set up Python
31
+ uses: actions/setup-python@v7
32
+ with:
33
+ python-version: "3.10"
34
+
35
+ - name: Run Synapse Hub Quality Gates
36
+ shell: bash
37
+ env:
38
+ INPUT_MODE: ${{ inputs.mode }}
39
+ INPUT_FORMAT: ${{ inputs.format }}
40
+ INPUT_TEST_CMD: ${{ inputs.test-cmd }}
41
+ INPUT_CONFIG: ${{ inputs.config }}
42
+ ACTION_PATH: ${{ github.action_path }}
43
+ run: |
44
+ ARGS=("--mode" "$INPUT_MODE" "--format" "$INPUT_FORMAT")
45
+ if [ -n "$INPUT_TEST_CMD" ]; then
46
+ ARGS+=("--test-cmd" "$INPUT_TEST_CMD")
47
+ fi
48
+ if [ -n "$INPUT_CONFIG" ]; then
49
+ ARGS+=("--config" "$INPUT_CONFIG")
50
+ fi
51
+ python3 "$ACTION_PATH/tools/verify_all.py" "${ARGS[@]}"
@@ -0,0 +1,16 @@
1
+ {
2
+ "$schema": "https://agentskills.io/schema/v1.json",
3
+ "name": "Synapse-Hub",
4
+ "version": "3.8.2",
5
+ "description": "Enterprise QA & Test Automation AI Skills Ecosystem adhering to Clean POM Flat Architecture.",
6
+ "author": "Thế Vị (@TeeVee998)",
7
+ "repository": "https://github.com/TeeVee998/Synapse-Hub",
8
+ "license": "MIT",
9
+ "skillsRoot": ".agents/skills",
10
+ "standards": [
11
+ "Clean-POM-Flat-Architecture",
12
+ "100%-UTF8-No-BOM",
13
+ "Truth-Anchor-No-Fake-Pass",
14
+ "11-Quality-Gates-DoD"
15
+ ]
16
+ }
@@ -0,0 +1,138 @@
1
+ #!/usr/bin/env node
2
+ // SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
3
+ // SPDX-License-Identifier: MIT
4
+ // Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
5
+
6
+ /**
7
+ * Enterprise Synapse-Hub NPM Launcher
8
+ * ====================================
9
+ * Dispatches CLI subcommands to the underlying Python Standard Library engine (tools/cli.py).
10
+ * Provides cross-platform zero-install execution via `npx synapse-hub <command>`.
11
+ */
12
+
13
+ const { spawn, execFileSync } = require('child_process');
14
+ const path = require('path');
15
+ const fs = require('fs');
16
+
17
+ const REPO_ROOT = path.resolve(__dirname, '..');
18
+ const CLI_PATH = path.join(REPO_ROOT, 'tools', 'cli.py');
19
+
20
+ // ANSI Color Helpers
21
+ const hasNoColor = 'NO_COLOR' in process.env;
22
+ const isDumbTerm = process.env.TERM === 'dumb';
23
+ const forceColor = ['1', 'true', 'TRUE'].includes(process.env.FORCE_COLOR);
24
+ const useColor = (Boolean(process.stdout.isTTY) || forceColor) && !hasNoColor && !isDumbTerm;
25
+ const RED = useColor ? '\x1b[91m' : '';
26
+ const GREEN = useColor ? '\x1b[92m' : '';
27
+ const YELLOW = useColor ? '\x1b[93m' : '';
28
+ const CYAN = useColor ? '\x1b[96m' : '';
29
+ const BOLD = useColor ? '\x1b[1m' : '';
30
+ const RESET = useColor ? '\x1b[0m' : '';
31
+
32
+ /**
33
+ * Resolves the available Python 3 executable across Windows, macOS, and Linux.
34
+ */
35
+ function resolvePython() {
36
+ const candidates = process.platform === 'win32'
37
+ ? ['python', 'py', 'python3']
38
+ : ['python3', 'python'];
39
+
40
+ for (const cmd of candidates) {
41
+ try {
42
+ const output = execFileSync(cmd, ['--version'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
43
+ const match = output.match(/Python\s+(\d+)\.(\d+)/i);
44
+ if (match) {
45
+ const major = parseInt(match[1], 10);
46
+ const minor = parseInt(match[2], 10);
47
+ if (major > 3 || (major === 3 && minor >= 10)) {
48
+ return { command: cmd, version: output };
49
+ }
50
+ }
51
+ } catch {
52
+ // Continue checking next candidate in path
53
+ continue;
54
+ }
55
+ }
56
+ return null;
57
+ }
58
+
59
+ const PASSTHROUGH_CMDS = ['sh', 'bash', '/bin/sh', '/bin/bash', 'cat'];
60
+
61
+ function main() {
62
+ const firstArg = process.argv[2];
63
+ if (firstArg && (PASSTHROUGH_CMDS.includes(firstArg) || (path.isAbsolute(firstArg) && fs.existsSync(firstArg)))) {
64
+ const child = spawn(firstArg, process.argv.slice(3), {
65
+ stdio: 'inherit',
66
+ env: process.env
67
+ });
68
+ child.on('error', (err) => {
69
+ console.error(`\n${BOLD}${RED}[ERROR] Failed to execute ${firstArg}:${RESET}`, err.message);
70
+ process.exit(1);
71
+ });
72
+ child.on('exit', (code, signal) => {
73
+ if (signal) {
74
+ process.kill(process.pid, signal);
75
+ } else {
76
+ process.exit(code ?? 0);
77
+ }
78
+ });
79
+ process.on('SIGINT', () => child.kill('SIGINT'));
80
+ process.on('SIGTERM', () => child.kill('SIGTERM'));
81
+ return;
82
+ }
83
+
84
+ const python = resolvePython();
85
+
86
+ if (!python) {
87
+ if (process.argv.includes('--first-run')) {
88
+ process.exit(0);
89
+ }
90
+ console.error(`\n${BOLD}${RED}[ERROR] Python 3.10+ is required to execute synapse-hub tools.${RESET}`);
91
+ console.error(`[LỖI] Cần cài đặt Python 3.10+ để thực thi các công cụ Synapse Hub.`);
92
+ console.error(`Neither ${CYAN}python3${RESET} nor ${CYAN}python${RESET} (>= 3.10) was found on your PATH.`);
93
+ console.error(`Không tìm thấy ${CYAN}python3${RESET} hoặc ${CYAN}python${RESET} (>= 3.10) trong biến môi trường PATH.`);
94
+ console.error(`👉 Please install Python from: ${BOLD}https://www.python.org/downloads/${RESET}`);
95
+ console.error(`👉 Tải và cài đặt Python tại: ${BOLD}https://www.python.org/downloads/${RESET}\n`);
96
+ process.exit(1);
97
+ }
98
+
99
+ if (!fs.existsSync(CLI_PATH)) {
100
+ console.error(`\n${BOLD}${RED}[ERROR] Core CLI engine not found at: ${CLI_PATH}${RESET}\n`);
101
+ process.exit(1);
102
+ }
103
+
104
+ let args;
105
+ if (process.argv[2] === '--py') {
106
+ args = process.argv.slice(3);
107
+ } else {
108
+ args = [CLI_PATH, ...process.argv.slice(2)];
109
+ }
110
+
111
+ // Spawn child Python process inheriting standard IO
112
+ const child = spawn(python.command, args, {
113
+ stdio: 'inherit',
114
+ env: { ...process.env, AGENT_QA_INVOKER: 'npm' }
115
+ });
116
+
117
+ child.on('error', (err) => {
118
+ console.error(`\n${BOLD}${RED}[ERROR] Failed to start synapse-hub CLI:${RESET}`, err.message);
119
+ process.exit(1);
120
+ });
121
+
122
+ child.on('exit', (code, signal) => {
123
+ if (signal) {
124
+ process.kill(process.pid, signal);
125
+ } else {
126
+ process.exit(code ?? 0);
127
+ }
128
+ });
129
+
130
+ process.on('SIGINT', () => child.kill('SIGINT'));
131
+ process.on('SIGTERM', () => child.kill('SIGTERM'));
132
+ }
133
+
134
+ if (require.main === module) {
135
+ main();
136
+ } else {
137
+ module.exports = { resolvePython, PASSTHROUGH_CMDS };
138
+ }
@@ -0,0 +1,74 @@
1
+ # SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
2
+ # SPDX-License-Identifier: MIT
3
+ # Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
4
+
5
+ # Enterprise Synapse-Hub Developer Compose Environment
6
+ # Enables running quality gates, linting, and health audits against local target test suites
7
+ # with zero host tool installation.
8
+
9
+ services:
10
+ # 1. Primary Quality Gate: 11 Quality Gates DoD Verification
11
+ # Usage: docker compose run --rm verify
12
+ verify:
13
+ build:
14
+ context: .
15
+ dockerfile: Dockerfile
16
+ image: ghcr.io/teevee998/synapse-hub:latest
17
+ container_name: synapse-qa-verify
18
+ volumes:
19
+ - ./target:/workspace/target
20
+ - ./reports:/workspace/reports
21
+ working_dir: /workspace/target
22
+ command: ["verify"]
23
+ environment:
24
+ - PYTHONUNBUFFERED=1
25
+ - LANG=C.UTF-8
26
+
27
+ # 2. Meta Infer-style AST Defect & Fake-Pass Linter
28
+ # Usage: docker compose run --rm lint
29
+ lint:
30
+ image: ghcr.io/teevee998/synapse-hub:latest
31
+ container_name: synapse-qa-lint
32
+ volumes:
33
+ - ./target:/workspace/target
34
+ working_dir: /workspace/target
35
+ command: ["lint"]
36
+
37
+ # 3. Comprehensive 5-in-1 Repository Health Audit
38
+ # Usage: docker compose run --rm analyze
39
+ analyze:
40
+ image: ghcr.io/teevee998/synapse-hub:latest
41
+ container_name: synapse-qa-analyze
42
+ volumes:
43
+ - ./target:/workspace/target
44
+ - ./reports:/workspace/reports
45
+ working_dir: /workspace/target
46
+ command: ["analyze"]
47
+
48
+ # 4. Syntactic Micro-Mutation Verification (Kill Score >= 80%)
49
+ # Usage: docker compose run --rm mutate
50
+ mutate:
51
+ image: ghcr.io/teevee998/synapse-hub:latest
52
+ container_name: synapse-qa-mutate
53
+ volumes:
54
+ - ./target:/workspace/target
55
+ - ./reports:/workspace/reports
56
+ working_dir: /workspace/target
57
+ command: ["mutate", "--min-score", "80"]
58
+
59
+ # 5. Interactive Developer Shell
60
+ # Usage: docker compose run --rm shell
61
+ shell:
62
+ build:
63
+ context: .
64
+ dockerfile: Dockerfile
65
+ image: ghcr.io/teevee998/synapse-hub:latest
66
+ container_name: synapse-qa-shell
67
+ entrypoint: ["/bin/bash"]
68
+ command: []
69
+ stdin_open: true
70
+ tty: true
71
+ volumes:
72
+ - ./target:/workspace/target
73
+ - ./reports:/workspace/reports
74
+ working_dir: /workspace/target