@teevee98/synapse-hub 0.0.0-stage → 3.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +171 -0
  190. package/README.md +170 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +198 -0
  196. package/docs/ARCHITECTURE.md +199 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +31 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2074 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2403 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +306 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +725 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1271 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,401 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
3
+ # SPDX-License-Identifier: MIT
4
+ # Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
5
+
6
+ """
7
+ tools/ui_server.py — Synapse Hub Interactive QA Mission Control Web Server
8
+ -------------------------------------------------------------------------
9
+ Lightweight local web server (pure Python standard library, zero external deps).
10
+ Provides real-time interactive QA dashboard:
11
+ 1. 1-Click execution for 10 Quality Gates DoD, Infer Linter, and Micro-Mutation.
12
+ 2. Real-time streaming console logs directly in the browser via polling/SSE.
13
+ 3. Interactive repository health, diagnostics, and Excel export.
14
+ """
15
+
16
+ import os
17
+ import sys
18
+ import json
19
+ import time
20
+ import socket
21
+ import argparse
22
+ import threading
23
+ import subprocess
24
+ import webbrowser
25
+ import urllib.parse
26
+ from http.server import HTTPServer, BaseHTTPRequestHandler
27
+ from socketserver import ThreadingMixIn
28
+ from typing import Dict, Any, Optional
29
+
30
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
31
+ if hasattr(sys.stdout, 'reconfigure'):
32
+ try:
33
+ sys.stdout.reconfigure(encoding='utf-8')
34
+ sys.stderr.reconfigure(encoding='utf-8')
35
+ except Exception:
36
+ pass
37
+
38
+ REPO_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
39
+ TEMPLATE_PATH = os.path.join(REPO_ROOT, "templates", "ui", "index.html")
40
+
41
+ COMMAND_MAP = {
42
+ "verify": [sys.executable, os.path.join(REPO_ROOT, "tools", "verify_all.py"), "--mode", "hub"],
43
+ "lint": [sys.executable, os.path.join(REPO_ROOT, "tools", "infer_linter.py")],
44
+ "mutate": [sys.executable, os.path.join(REPO_ROOT, "tools", "micro_mutator.py"), "--min-score", "80"],
45
+ "doctor": [sys.executable, os.path.join(REPO_ROOT, "tools", "check_env.py")],
46
+ "analyze": [sys.executable, os.path.join(REPO_ROOT, "tools", "analyze_project.py")],
47
+ "export-excel": [sys.executable, os.path.join(REPO_ROOT, "tools", "template_excel_exporter.py")],
48
+ "init-config": [sys.executable, os.path.join(REPO_ROOT, "tools", "init_config.py"), "--force"],
49
+ "dashboard": [sys.executable, os.path.join(REPO_ROOT, "tools", "dashboard_generator.py")],
50
+ "trend": [sys.executable, os.path.join(REPO_ROOT, "tools", "trend_analytics.py")],
51
+ "version": [sys.executable, os.path.join(REPO_ROOT, "tools", "cli.py"), "version"],
52
+ }
53
+
54
+
55
+ def get_command_for_target(command_name: str, target_dir: Optional[str] = None) -> list:
56
+ """Resolves command execution arguments scoped to target project or Hub mode."""
57
+ target = os.path.abspath(target_dir) if target_dir else None
58
+ is_target_mode = target is not None and target != REPO_ROOT
59
+
60
+ if not is_target_mode:
61
+ return list(COMMAND_MAP[command_name])
62
+
63
+ # Target Project Scoped Commands
64
+ if command_name == "verify":
65
+ return [sys.executable, os.path.join(REPO_ROOT, "tools", "verify_all.py"), target, "--mode", "target"]
66
+ elif command_name == "lint":
67
+ return [sys.executable, os.path.join(REPO_ROOT, "tools", "infer_linter.py"), target]
68
+ elif command_name == "mutate":
69
+ return [sys.executable, os.path.join(REPO_ROOT, "tools", "micro_mutator.py"), target, "--min-score", "80"]
70
+ elif command_name == "doctor":
71
+ return [sys.executable, os.path.join(REPO_ROOT, "tools", "check_env.py"), target]
72
+ elif command_name == "analyze":
73
+ return [sys.executable, os.path.join(REPO_ROOT, "tools", "analyze_project.py"), target]
74
+ elif command_name == "dashboard":
75
+ return [sys.executable, os.path.join(REPO_ROOT, "tools", "dashboard_generator.py"), target]
76
+ elif command_name == "init-config":
77
+ return [sys.executable, os.path.join(REPO_ROOT, "tools", "init_config.py"), "--force", target]
78
+ elif command_name in COMMAND_MAP:
79
+ return list(COMMAND_MAP[command_name])
80
+ raise ValueError(f"Unknown or disallowed command: '{command_name}'")
81
+
82
+
83
+ class JobManager:
84
+ """Thread-safe manager for tracking asynchronous background tool execution."""
85
+
86
+ def __init__(self, target_dir: Optional[str] = None):
87
+ self.jobs: Dict[str, Dict[str, Any]] = {}
88
+ self.lock = threading.Lock()
89
+ self.target_dir = os.path.abspath(target_dir) if target_dir else None
90
+
91
+ def start_job(self, command_name: str, cwd: Optional[str] = None) -> str:
92
+ if command_name not in COMMAND_MAP:
93
+ raise ValueError(f"Unknown or disallowed command: '{command_name}'")
94
+
95
+ exec_cwd = os.path.abspath(cwd) if cwd else (self.target_dir or REPO_ROOT)
96
+ cmd_list = get_command_for_target(command_name, exec_cwd)
97
+ job_id = f"job_{int(time.time() * 1000)}"
98
+
99
+ job = {
100
+ "id": job_id,
101
+ "command": command_name,
102
+ "cmd_list": cmd_list,
103
+ "status": "RUNNING",
104
+ "logs": [],
105
+ "exit_code": None,
106
+ "start_time": time.time(),
107
+ "end_time": None
108
+ }
109
+
110
+ with self.lock:
111
+ self.jobs[job_id] = job
112
+
113
+ def worker():
114
+ try:
115
+ env = os.environ.copy()
116
+ env["PYTHONUNBUFFERED"] = "1"
117
+ env["PYTHONIOENCODING"] = "utf-8"
118
+ proc = subprocess.Popen(
119
+ cmd_list,
120
+ cwd=exec_cwd,
121
+ stdout=subprocess.PIPE,
122
+ stderr=subprocess.STDOUT,
123
+ text=True,
124
+ encoding="utf-8",
125
+ errors="replace",
126
+ bufsize=1,
127
+ env=env
128
+ )
129
+ if proc.stdout:
130
+ for line in iter(proc.stdout.readline, ''):
131
+ if not line:
132
+ break
133
+ with self.lock:
134
+ job["logs"].append(line)
135
+ proc.stdout.close()
136
+ proc.wait()
137
+ with self.lock:
138
+ job["status"] = "PASSED" if proc.returncode == 0 else "FAILED"
139
+ job["exit_code"] = proc.returncode
140
+ job["end_time"] = time.time()
141
+ except Exception as e:
142
+ with self.lock:
143
+ job["logs"].append(f"[ERROR] Process execution failure: {str(e)}\n")
144
+ job["status"] = "FAILED"
145
+ job["exit_code"] = -1
146
+ job["end_time"] = time.time()
147
+
148
+ t = threading.Thread(target=worker, daemon=True)
149
+ t.start()
150
+ return job_id
151
+
152
+ def get_job(self, job_id: str, offset: int = 0) -> Optional[Dict[str, Any]]:
153
+ with self.lock:
154
+ if job_id not in self.jobs:
155
+ return None
156
+ j = self.jobs[job_id]
157
+ logs = j["logs"][offset:]
158
+ return {
159
+ "id": j["id"],
160
+ "command": j["command"],
161
+ "status": j["status"],
162
+ "logs": logs,
163
+ "next_offset": len(j["logs"]),
164
+ "exit_code": j["exit_code"],
165
+ "duration": round((j["end_time"] or time.time()) - j["start_time"], 2)
166
+ }
167
+
168
+
169
+ JOB_MANAGER = JobManager()
170
+
171
+
172
+ class ThreadingHTTPServer(ThreadingMixIn, HTTPServer):
173
+ daemon_threads = True
174
+
175
+
176
+ def _is_allowed_origin(origin: str) -> bool:
177
+ """Validates that CORS origin is strictly localhost or 127.0.0.1 to block origin spoofing."""
178
+ if not origin:
179
+ return False
180
+ try:
181
+ parsed = urllib.parse.urlparse(origin)
182
+ return parsed.scheme in ("http", "https") and parsed.hostname in ("localhost", "127.0.0.1")
183
+ except Exception:
184
+ return False
185
+
186
+
187
+ class SynapseUiHandler(BaseHTTPRequestHandler):
188
+ """HTTP Request Handler serving SPA interface and REST APIs."""
189
+
190
+ def log_message(self, format, *args):
191
+ # Suppress routine GET log spam to keep console clean
192
+ pass
193
+
194
+ def send_json(self, status_code: int, data: Any):
195
+ body = json.dumps(data, ensure_ascii=False).encode("utf-8")
196
+ self.send_response(status_code)
197
+ self.send_header("Content-Type", "application/json; charset=utf-8")
198
+ self.send_header("Content-Length", str(len(body)))
199
+ origin = self.headers.get("Origin", "")
200
+ if _is_allowed_origin(origin):
201
+ self.send_header("Access-Control-Allow-Origin", origin)
202
+ self.send_header("Vary", "Origin")
203
+ self.send_header("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
204
+ self.send_header("Access-Control-Allow-Headers", "Content-Type, Authorization")
205
+ self.end_headers()
206
+ self.wfile.write(body)
207
+
208
+ def do_OPTIONS(self):
209
+ self.send_response(200)
210
+ origin = self.headers.get("Origin", "")
211
+ if _is_allowed_origin(origin):
212
+ self.send_header("Access-Control-Allow-Origin", origin)
213
+ self.send_header("Vary", "Origin")
214
+ self.send_header("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
215
+ self.send_header("Access-Control-Allow-Headers", "Content-Type, Authorization")
216
+ self.send_header("Content-Length", "0")
217
+ self.end_headers()
218
+
219
+ def do_GET(self):
220
+ parsed = urllib.parse.urlparse(self.path)
221
+ path = parsed.path
222
+
223
+ if path in ("/", "/index.html"):
224
+ if os.path.exists(TEMPLATE_PATH):
225
+ with open(TEMPLATE_PATH, "r", encoding="utf-8") as f:
226
+ content = f.read().encode("utf-8")
227
+ self.send_response(200)
228
+ self.send_header("Content-Type", "text/html; charset=utf-8")
229
+ self.send_header("Content-Length", str(len(content)))
230
+ self.end_headers()
231
+ self.wfile.write(content)
232
+ else:
233
+ self.send_error(404, "UI Template file not found on disk.")
234
+ return
235
+
236
+ if path == "/api/status":
237
+ active_target = JOB_MANAGER.target_dir or REPO_ROOT
238
+ self.send_json(200, {
239
+ "version": "3.8.3",
240
+ "status": "ONLINE",
241
+ "os": sys.platform,
242
+ "workspace": active_target,
243
+ "hub_root": REPO_ROOT,
244
+ "target_mode": os.path.abspath(active_target) != REPO_ROOT,
245
+ "author": "Thế Vị (@TeeVee98)",
246
+ "license": "MIT"
247
+ })
248
+ return
249
+
250
+ if path == "/api/trends":
251
+ try:
252
+ import trend_analytics
253
+ active_target = JOB_MANAGER.target_dir or REPO_ROOT
254
+ target_ledger = os.path.join(active_target, "reports", "history_ledger.json") if os.path.abspath(active_target) != REPO_ROOT else None
255
+ ledger_arg = target_ledger if (target_ledger and os.path.isfile(target_ledger)) else None
256
+ self.send_json(200, {
257
+ "svg_trend": trend_analytics.generate_trend_svg(ledger_path=ledger_arg),
258
+ "svg_duration": trend_analytics.generate_duration_svg(ledger_path=ledger_arg),
259
+ "ledger": trend_analytics.load_history_ledger(ledger_path=ledger_arg)[-10:]
260
+ })
261
+ except Exception as err:
262
+ self.send_json(500, {"error": str(err)})
263
+ return
264
+
265
+ if path.startswith("/api/run/"):
266
+ job_id = path[len("/api/run/"):]
267
+ query = urllib.parse.parse_qs(parsed.query)
268
+ offset = int(query.get("offset", [0])[0])
269
+ job_info = JOB_MANAGER.get_job(job_id, offset)
270
+ if job_info is None:
271
+ self.send_json(404, {"error": "Job not found"})
272
+ else:
273
+ self.send_json(200, job_info)
274
+ return
275
+
276
+ # Serve static reports safely with path traversal protection
277
+ unquoted_path = urllib.parse.unquote(path)
278
+ if unquoted_path.startswith("/reports/"):
279
+ rel_file = unquoted_path.lstrip("/")
280
+ safe_target = None
281
+
282
+ # 1. Check target project reports directory first if scoped to a Spoke project
283
+ if JOB_MANAGER.target_dir and os.path.abspath(JOB_MANAGER.target_dir) != REPO_ROOT:
284
+ target_reports_dir = os.path.realpath(os.path.join(JOB_MANAGER.target_dir, "reports"))
285
+ candidate = os.path.realpath(os.path.join(JOB_MANAGER.target_dir, rel_file))
286
+ if candidate.startswith(target_reports_dir + os.sep) and os.path.isfile(candidate):
287
+ safe_target = candidate
288
+
289
+ # 2. Fallback to Hub reports directory
290
+ if not safe_target:
291
+ reports_dir = os.path.realpath(os.path.join(REPO_ROOT, "reports"))
292
+ candidate = os.path.realpath(os.path.join(REPO_ROOT, rel_file))
293
+ if candidate.startswith(reports_dir + os.sep) and os.path.isfile(candidate):
294
+ safe_target = candidate
295
+
296
+ if not safe_target:
297
+ self.send_error(404, "Report file not found.")
298
+ return
299
+
300
+ with open(safe_target, "rb") as f:
301
+ body = f.read()
302
+ mime = "text/html; charset=utf-8" if safe_target.endswith(".html") else "application/octet-stream"
303
+ if safe_target.endswith(".json"):
304
+ mime = "application/json; charset=utf-8"
305
+ self.send_response(200)
306
+ self.send_header("Content-Type", mime)
307
+ self.send_header("Content-Length", str(len(body)))
308
+ origin = self.headers.get("Origin", "")
309
+ if _is_allowed_origin(origin):
310
+ self.send_header("Access-Control-Allow-Origin", origin)
311
+ self.send_header("Vary", "Origin")
312
+ self.end_headers()
313
+ self.wfile.write(body)
314
+ return
315
+
316
+ self.send_error(404, "Endpoint not found.")
317
+
318
+ def do_POST(self):
319
+ parsed = urllib.parse.urlparse(self.path)
320
+ if parsed.path == "/api/run":
321
+ length = int(self.headers.get("Content-Length", 0))
322
+ body_raw = self.rfile.read(length).decode("utf-8", errors="ignore")
323
+ try:
324
+ payload = json.loads(body_raw) if body_raw else {}
325
+ cmd = payload.get("command", "")
326
+ job_id = JOB_MANAGER.start_job(cmd)
327
+ self.send_json(200, {"job_id": job_id, "command": cmd, "status": "STARTED"})
328
+ except ValueError as err:
329
+ self.send_json(400, {"error": str(err)})
330
+ except Exception as err:
331
+ self.send_json(500, {"error": f"Internal execution error: {err}"})
332
+ return
333
+
334
+ self.send_error(404, "Endpoint not found.")
335
+
336
+
337
+ def find_free_port(start_port: int = 8080, max_attempts: int = 20) -> int:
338
+ """Finds an available local TCP port."""
339
+ for port in range(start_port, start_port + max_attempts):
340
+ with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
341
+ if s.connect_ex(("127.0.0.1", port)) != 0:
342
+ return port
343
+ return start_port
344
+
345
+
346
+ def run_server(host: str = "127.0.0.1", port: int = 8080, open_browser: bool = True, target_dir: Optional[str] = None):
347
+ """Starts the Synapse Hub Mission Control HTTP server."""
348
+ if target_dir:
349
+ JOB_MANAGER.target_dir = os.path.abspath(target_dir)
350
+ elif os.path.abspath(os.getcwd()) != REPO_ROOT:
351
+ JOB_MANAGER.target_dir = os.path.abspath(os.getcwd())
352
+ else:
353
+ JOB_MANAGER.target_dir = REPO_ROOT
354
+
355
+ actual_port = find_free_port(port)
356
+ server_address = (host, actual_port)
357
+ httpd = ThreadingHTTPServer(server_address, SynapseUiHandler)
358
+
359
+ url = f"http://{host}:{actual_port}"
360
+ print("\n" + "=" * 70)
361
+ print(" ⚡ SYNAPSE HUB — INTERACTIVE QA MISSION CONTROL")
362
+ print("=" * 70)
363
+ print(f" Server URL : {url}")
364
+ print(f" Workspace : {JOB_MANAGER.target_dir}")
365
+ print(f" Hub Root : {REPO_ROOT}")
366
+ print(f" Scope Mode : {'TARGET PROJECT' if JOB_MANAGER.target_dir != REPO_ROOT else 'HUB'}")
367
+ print(" Created by : Thế Vị (@TeeVee98) <https://github.com/TeeVee98/Synapse-Hub>")
368
+ print(" License : MIT")
369
+ print("=" * 70)
370
+ print(" [INFO] Press Ctrl+C in terminal to stop server.\n")
371
+
372
+ if open_browser:
373
+ def opener():
374
+ time.sleep(0.5)
375
+ webbrowser.open(url)
376
+ threading.Thread(target=opener, daemon=True).start()
377
+
378
+ try:
379
+ httpd.serve_forever()
380
+ except KeyboardInterrupt:
381
+ print("\n[INFO] Stopping Synapse Hub Mission Control server...")
382
+ finally:
383
+ httpd.server_close()
384
+ print("[INFO] Server stopped gracefully.")
385
+
386
+
387
+ def main():
388
+ parser = argparse.ArgumentParser(description="Launch Synapse Hub Interactive QA Mission Control Web UI")
389
+ parser.add_argument("target", nargs="?", default=None, help="Target project directory (defaults to CWD or Hub root)")
390
+ parser.add_argument("--target", dest="target_opt", default=None, help="Target project directory")
391
+ parser.add_argument("--host", default="127.0.0.1", help="Host interface to bind (default: 127.0.0.1)")
392
+ parser.add_argument("--port", "-p", type=int, default=8080, help="Initial port to bind (default: 8080)")
393
+ parser.add_argument("--no-browser", action="store_true", help="Do not automatically open browser on startup")
394
+ args = parser.parse_args()
395
+
396
+ target_path = args.target_opt or args.target
397
+ run_server(host=args.host, port=args.port, open_browser=not args.no_browser, target_dir=target_path)
398
+
399
+
400
+ if __name__ == "__main__":
401
+ main()