@teevee98/synapse-hub 0.0.0-stage → 3.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +172 -0
  190. package/README.md +171 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +197 -0
  196. package/docs/ARCHITECTURE.md +198 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +175 -0
  200. package/docs/CLI_REFERENCE.md +177 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +121 -0
  206. package/docs/QUALITY_GATES.md +121 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1359 -0
  212. package/docs/schemas/synapse.config.schema.json +87 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +32 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2079 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +258 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +184 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2419 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +307 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +724 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1259 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,514 @@
1
+ #!/usr/bin/env python3
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
+ Template-Driven Excel Test Case Exporter
8
+ -----------------------------------------
9
+ Enables zero-pollution, template-driven test case export into existing corporate
10
+ Excel workbooks. Preserves 100% of the original template's styling, formulas,
11
+ merged headers, summary dashboards, fonts, borders, and column widths.
12
+
13
+ Design Philosophy (Hub & Spoke):
14
+ - Hub remains 100% generic, zero hardcoding of any specific client/project.
15
+ - Client projects specify their template via `--template` or `.synapse.json`.
16
+ - If no template is provided, falls back cleanly to the Hub standard 12-column layout.
17
+ """
18
+
19
+ import os
20
+ import sys
21
+ import re
22
+ import json
23
+ import datetime
24
+ from pathlib import Path
25
+ from typing import Dict, Any, List, Optional
26
+
27
+ # Enforce UTF-8 stdio
28
+ if hasattr(sys.stdout, 'reconfigure'):
29
+ try:
30
+ sys.stdout.reconfigure(encoding='utf-8')
31
+ sys.stderr.reconfigure(encoding='utf-8')
32
+ except Exception:
33
+ pass
34
+
35
+ try:
36
+ import openpyxl
37
+ from openpyxl.styles import Font, PatternFill, Alignment, Border, Side
38
+ OPENPYXL_AVAILABLE = True
39
+ except ImportError:
40
+ OPENPYXL_AVAILABLE = False
41
+
42
+
43
+ def find_project_config(start_dir: Optional[str] = None) -> Optional[Dict[str, Any]]:
44
+ """Walks up from start_dir to find a .synapse.json configuration file."""
45
+ cur = Path(start_dir or os.getcwd()).resolve()
46
+ user_home = Path.home().resolve()
47
+ for p in [cur] + list(cur.parents):
48
+ if p == user_home:
49
+ # ~/.synapse.json in user home is a global user preference, not a project config
50
+ break
51
+ cfg_file = p / ".synapse.json"
52
+ if cfg_file.is_file():
53
+ try:
54
+ with open(cfg_file, "r", encoding="utf-8") as f:
55
+ data = json.load(f)
56
+ data["_config_dir"] = str(p)
57
+ return data
58
+ except Exception as _err:
59
+ _ = _err
60
+ return None
61
+
62
+
63
+ def parse_testcases_from_markdown(content: str) -> List[Dict[str, Any]]:
64
+ """
65
+ Parses test cases from a Markdown text.
66
+ Supports both table format (| TC_ID | ...) and structured list items.
67
+ """
68
+ rows = []
69
+ lines = content.splitlines()
70
+ in_table = False
71
+ headers = []
72
+
73
+ for line in lines:
74
+ line_s = line.strip()
75
+ if not line_s:
76
+ continue
77
+
78
+ # Check section header (e.g., "### 1. Màn hình [...]" or "**1. Màn hình [...]**")
79
+ sec_m = re.match(r'^(?:#{1,4}\s*|\*{2})?([0-9]+\.\s*Màn hình.*)', line_s, re.IGNORECASE)
80
+ if sec_m:
81
+ in_table = False
82
+ sec_title = sec_m.group(1).rstrip('*').strip()
83
+ rows.append({"type": "section", "text": sec_title})
84
+ continue
85
+
86
+ # Sub-action header (e.g. "Truy cập và kiểm tra...")
87
+ if line_s.startswith("## ") or (line_s.startswith("**") and line_s.endswith("**") and not line_s.startswith("|")):
88
+ in_table = False
89
+ action_title = line_s.strip("#* ").strip()
90
+ rows.append({"type": "subsection", "text": action_title})
91
+ continue
92
+
93
+ # Precondition block
94
+ if line_s.lower().startswith("tiền điều kiện:") or line_s.lower().startswith("**tiền điều kiện:**"):
95
+ in_table = False
96
+ precond_text = re.sub(r'^\*?\*?tiền điều kiện:\*?\*?\s*', '', line_s, flags=re.IGNORECASE).strip()
97
+ rows.append({"type": "precondition", "text": precond_text})
98
+ continue
99
+
100
+ # Markdown Table parsing
101
+ if line_s.startswith("|") and line_s.endswith("|"):
102
+ parts = [c.strip() for c in line_s.split("|")[1:-1]]
103
+ if not in_table or (parts and parts[0].lower() in ("testcase_id", "tc_id", "tc id", "tc", "stt")):
104
+ # Table headers
105
+ headers = [p.lower() for p in parts]
106
+ in_table = True
107
+ continue
108
+ elif all(re.match(r'^:?-+:?$', p) for p in parts if p):
109
+ # Separator line
110
+ continue
111
+ else:
112
+ # Data row
113
+ row_dict = {"type": "case"}
114
+ for i, h in enumerate(headers):
115
+ if i < len(parts):
116
+ row_dict[h] = parts[i]
117
+ rows.append(row_dict)
118
+ else:
119
+ in_table = False
120
+
121
+ return rows
122
+
123
+
124
+ def clone_and_export_template(
125
+ rows: List[Dict[str, Any]],
126
+ output_path: str,
127
+ template_path: str,
128
+ sample_sheet_name: Optional[str] = None,
129
+ target_sheet_name: Optional[str] = None,
130
+ module_code: str = "MODULE",
131
+ module_name: str = "Test Module",
132
+ author: str = "QA Engineer",
133
+ tester: str = "QA Engineer",
134
+ keep_other_sheets: bool = True
135
+ ) -> str:
136
+ """
137
+ Clones the template workbook or sample worksheet, updates metadata and formulas,
138
+ populates test cases, and writes to output_path.
139
+ """
140
+ if not OPENPYXL_AVAILABLE:
141
+ raise RuntimeError("openpyxl is required for template-driven Excel export. Run: pip install openpyxl")
142
+
143
+ if not os.path.exists(template_path):
144
+ raise FileNotFoundError(f"Template Excel file not found: {template_path}")
145
+
146
+ wb = openpyxl.load_workbook(template_path, data_only=False)
147
+
148
+ if not sample_sheet_name or sample_sheet_name not in wb.sheetnames:
149
+ # Fallback to first available sheet in the template
150
+ sample_sheet_name = wb.sheetnames[0]
151
+
152
+ src_sheet = wb[sample_sheet_name]
153
+ new_sheet_name = target_sheet_name or sample_sheet_name
154
+
155
+ if new_sheet_name == sample_sheet_name and not keep_other_sheets:
156
+ target_ws = src_sheet
157
+ elif new_sheet_name in wb.sheetnames and new_sheet_name != sample_sheet_name:
158
+ target_ws = wb[new_sheet_name]
159
+ else:
160
+ target_ws = wb.copy_worksheet(src_sheet)
161
+ target_ws.title = new_sheet_name
162
+
163
+ # Unmerge stale merged cells from row 11 downwards only
164
+ merged_to_remove = [rng for rng in target_ws.merged_cells.ranges if rng.min_row >= 11]
165
+ for rng in merged_to_remove:
166
+ target_ws.unmerge_cells(str(rng))
167
+
168
+ template_max_r = target_ws.max_row
169
+
170
+ # Update metadata header (rows 2-6)
171
+ target_ws["B2"] = module_code
172
+ target_ws["D2"] = module_name
173
+ target_ws["B3"] = author
174
+ target_ws["B4"] = datetime.datetime.now().strftime("%Y-%m-%d")
175
+ target_ws["B5"] = tester
176
+ target_ws["B6"] = datetime.datetime.now().strftime("%Y-%m-%d")
177
+
178
+ # Font and Border styles matching corporate template
179
+ font_case = Font(name="Times New Roman", size=11, bold=False, italic=False, color="000000")
180
+ font_case_bold = Font(name="Times New Roman", size=11, bold=True, italic=False, color="000000")
181
+ font_sec1 = Font(name="Times New Roman", size=11, bold=True, italic=False, color="000000")
182
+ font_sec2 = Font(name="Times New Roman", size=11, bold=True, italic=False, color="000000")
183
+ font_precond_label = Font(name="Times New Roman", size=11, bold=True, italic=True, color="0000FF")
184
+
185
+ # Fills matching template colors exactly
186
+ fill_sec1 = PatternFill(start_color="C9DAF8", end_color="C9DAF8", fill_type="solid") # Soft Blue
187
+ fill_sec2 = PatternFill(start_color="FCE5CD", end_color="FCE5CD", fill_type="solid") # Soft Peach
188
+ fill_white = PatternFill(start_color="FFFFFF", end_color="FFFFFF", fill_type="solid")
189
+ fill_pass = PatternFill(start_color="B7E1CD", end_color="B7E1CD", fill_type="solid") # Mint Green
190
+ fill_fail = PatternFill(start_color="FF0000", end_color="FF0000", fill_type="solid") # Bright Red
191
+ fill_na = PatternFill(start_color="FFF2CC", end_color="FFF2CC", fill_type="solid") # Soft Yellow
192
+ fill_prog = PatternFill(start_color="FCE5CD", end_color="FCE5CD", fill_type="solid") # In Progress Peach
193
+
194
+ font_fail = Font(name="Times New Roman", size=11, bold=True, color="FFFFFF")
195
+ font_pass = Font(name="Times New Roman", size=11, color="000000")
196
+ font_na = Font(name="Times New Roman", size=11, color="000000")
197
+
198
+ align_left = Alignment(horizontal="left", vertical="center", wrap_text=True)
199
+ align_top = Alignment(horizontal="left", vertical="top", wrap_text=True)
200
+ align_top_center = Alignment(horizontal="center", vertical="top", wrap_text=True)
201
+ thin_border = Border(
202
+ left=Side(style='thin', color='000000'),
203
+ right=Side(style='thin', color='000000'),
204
+ top=Side(style='thin', color='000000'),
205
+ bottom=Side(style='thin', color='000000')
206
+ )
207
+
208
+ # Clean existing data cells from row 11 downwards before writing new rows
209
+ for r in range(11, template_max_r + 1):
210
+ for c in range(1, 26):
211
+ cell = target_ws.cell(r, c)
212
+ cell.value = None
213
+ cell.fill = fill_white
214
+ cell.border = thin_border
215
+ cell.font = font_case
216
+ cell.alignment = align_top
217
+
218
+ def apply_status_style(cell, val):
219
+ val_str = str(val or "").strip()
220
+ if val_str.lower() == "pass":
221
+ cell.fill = fill_pass
222
+ cell.font = font_pass
223
+ elif val_str.lower() == "fail":
224
+ cell.fill = fill_fail
225
+ cell.font = font_fail
226
+ elif val_str.lower() in ("n/a", "na"):
227
+ cell.fill = fill_na
228
+ cell.font = font_na
229
+ elif val_str.lower() in ("in progress", "doing"):
230
+ cell.fill = fill_prog
231
+ cell.font = font_pass
232
+ else:
233
+ cell.fill = fill_white
234
+ cell.font = font_case
235
+
236
+ start_row = 11
237
+ cur_row = start_row
238
+ case_count = 0
239
+
240
+ for item in rows:
241
+ itype = item.get("type", "case")
242
+
243
+ if itype == "section":
244
+ # Section Level 1 row (Pastel Blue fill across all 21 columns)
245
+ for c in range(1, 22):
246
+ cell = target_ws.cell(cur_row, c)
247
+ cell.fill = fill_sec1
248
+ cell.border = thin_border
249
+ cell.font = font_sec1
250
+ target_ws.cell(cur_row, 2, item.get("text", "")).font = font_sec1
251
+ target_ws.cell(cur_row, 2).alignment = align_left
252
+ target_ws.row_dimensions[cur_row].height = 24
253
+ cur_row += 1
254
+
255
+ elif itype == "subsection":
256
+ # Section Level 2 row (Pastel Peach fill across all 21 columns)
257
+ for c in range(1, 22):
258
+ cell = target_ws.cell(cur_row, c)
259
+ cell.fill = fill_sec2
260
+ cell.border = thin_border
261
+ cell.font = font_sec2
262
+ target_ws.cell(cur_row, 3, item.get("text", "")).font = font_sec2
263
+ target_ws.cell(cur_row, 3).alignment = align_left
264
+ target_ws.row_dimensions[cur_row].height = 20
265
+ cur_row += 1
266
+
267
+ elif itype == "precondition":
268
+ # Precondition row: Col B = "Tiền điều kiện:" in Blue Bold, Cols C:D = MERGED
269
+ for c in range(1, 22):
270
+ cell = target_ws.cell(cur_row, c)
271
+ cell.border = thin_border
272
+ cell.fill = fill_white
273
+ cell.font = font_case
274
+
275
+ target_ws.cell(cur_row, 2, "Tiền điều kiện:").font = font_precond_label
276
+ target_ws.cell(cur_row, 2).alignment = align_left
277
+ target_ws.cell(cur_row, 3, item.get("text", "")).font = font_case
278
+ target_ws.cell(cur_row, 3).alignment = align_top
279
+
280
+ # Explicitly merge C{cur_row}:D{cur_row}
281
+ target_ws.merge_cells(start_row=cur_row, start_column=3, end_row=cur_row, end_column=4)
282
+ # Re-apply border to merged cells so no border lines are lost
283
+ target_ws.cell(cur_row, 3).border = thin_border
284
+ target_ws.cell(cur_row, 4).border = thin_border
285
+
286
+ # Auto-generated TC formula for Col A if formula-based
287
+ target_ws.cell(cur_row, 1, f'=IF(F{cur_row}="","",("TC_"&$B$2&"_0"&ROW()-10-COUNTBLANK($F$11:F{cur_row})))')
288
+ target_ws.cell(cur_row, 1).alignment = align_top
289
+ target_ws.cell(cur_row, 1).font = font_case
290
+
291
+ target_ws.row_dimensions[cur_row].height = 28
292
+ cur_row += 1
293
+
294
+ elif itype == "case":
295
+ # Concrete test case row
296
+ tc_id = item.get("testcase_id") or item.get("tc_id") or item.get("tc id")
297
+ title = item.get("tên testcase") or item.get("test title") or item.get("tiêu đề") or ""
298
+ precond = item.get("tiền điều kiện") or item.get("pre-condition") or item.get("precondition") or ""
299
+ steps = item.get("các bước thực hiện") or item.get("test steps") or item.get("steps") or ""
300
+ data_test = item.get("data test") or item.get("test data") or ""
301
+ expected = item.get("kết quả mong đợi") or item.get("expected result") or item.get("expected") or ""
302
+ depends = item.get("phụ thuộc testcase_id") or item.get("phụ thuộc") or ""
303
+ severity = item.get("mức độ nghiêm trọng lỗi") or item.get("mức độ") or item.get("severity") or "Major"
304
+ priority = item.get("độ ưu tiên") or item.get("priority") or "High"
305
+ res1 = item.get("lần 1") or item.get("result") or ""
306
+ res2 = item.get("lần 2") or ""
307
+ bug1 = item.get("bug id") or item.get("bug") or ""
308
+ notes1 = item.get("notes") or ""
309
+ notes = item.get("ghi chú") or ""
310
+
311
+ # Replace <br> with newlines
312
+ steps = re.sub(r'<br\s*/?>', '\n', steps, flags=re.IGNORECASE)
313
+ expected = re.sub(r'<br\s*/?>', '\n', expected, flags=re.IGNORECASE)
314
+ precond = re.sub(r'<br\s*/?>', '\n', precond, flags=re.IGNORECASE)
315
+
316
+ # Col 1: Formula if tc_id is not fixed
317
+ if tc_id and not tc_id.startswith("TC_AUTO"):
318
+ target_ws.cell(cur_row, 1, tc_id)
319
+ else:
320
+ target_ws.cell(cur_row, 1, f'=IF(F{cur_row}="","",("TC_"&$B$2&"_0"&ROW()-10-COUNTBLANK($F$11:F{cur_row})))')
321
+ target_ws.cell(cur_row, 1).alignment = align_top
322
+
323
+ # Col 2-6: Content
324
+ target_ws.cell(cur_row, 2, title).alignment = align_top
325
+ target_ws.cell(cur_row, 3, precond).alignment = align_top
326
+ target_ws.cell(cur_row, 4, steps).alignment = align_top
327
+ target_ws.cell(cur_row, 5, data_test).alignment = align_top
328
+ target_ws.cell(cur_row, 6, expected).alignment = align_top
329
+
330
+ # Col 7-9: Metadata
331
+ target_ws.cell(cur_row, 7, depends).alignment = align_top
332
+ target_ws.cell(cur_row, 8, severity).alignment = align_top_center
333
+ target_ws.cell(cur_row, 9, priority).alignment = align_top
334
+
335
+ # Execution round 1 (Cols 10-14) - Unexecuted test cases remain pristine/blank
336
+ c10 = target_ws.cell(cur_row, 10, res1 if res1 else None)
337
+ c10.alignment = align_top_center
338
+ if res1:
339
+ apply_status_style(c10, res1)
340
+
341
+ target_ws.cell(cur_row, 11, f'=IF(OR(J{cur_row}="Pass", J{cur_row}="Fail"), $B$5, "")').alignment = align_top_center
342
+ target_ws.cell(cur_row, 12, f'=IF(OR(J{cur_row}="", J{cur_row}="N/A"), "", IF(OR(L{cur_row}="", L{cur_row}=0), TODAY(), L{cur_row}))').alignment = align_top_center
343
+ target_ws.cell(cur_row, 13, bug1).alignment = align_top_center
344
+ target_ws.cell(cur_row, 14, notes1).alignment = align_top
345
+
346
+ # Execution round 2 (Cols 15-19)
347
+ c15 = target_ws.cell(cur_row, 15, res2 if res2 else None)
348
+ c15.alignment = align_top_center
349
+ if res2:
350
+ apply_status_style(c15, res2)
351
+
352
+ target_ws.cell(cur_row, 16, f'=IF(OR(O{cur_row}="Pass", O{cur_row}="Fail"), $B$5, "")').alignment = align_top_center
353
+ target_ws.cell(cur_row, 17, f'=IF(OR(O{cur_row}="", O{cur_row}="N/A"), "", IF(OR(Q{cur_row}="", Q{cur_row}=0), TODAY(), Q{cur_row}))').alignment = align_top_center
354
+ target_ws.cell(cur_row, 18, "").alignment = align_top_center
355
+ target_ws.cell(cur_row, 19, "").alignment = align_top
356
+
357
+ # Col 20: Dynamic result formula & Col 21: Notes
358
+ c20 = target_ws.cell(cur_row, 20, f'=IF(OR(J{cur_row}="N/A", O{cur_row}="Untested"), J{cur_row}, IF(COUNTA(J{cur_row},O{cur_row})=1, "In Progress", IF(OR(J{cur_row}="Fail", O{cur_row}="Fail"), "Fail", IF(AND(J{cur_row}="Pass", O{cur_row}="Pass"), "Pass", ""))))')
359
+ c20.alignment = align_top_center
360
+ if res1:
361
+ apply_status_style(c20, res1)
362
+
363
+ target_ws.cell(cur_row, 21, notes).alignment = align_top
364
+
365
+ # Unconditionally enforce exact font, border, and background on ALL cells (Cols 1 to 21)
366
+ for c in range(1, 22):
367
+ cell = target_ws.cell(cur_row, c)
368
+ if c == 8:
369
+ cell.font = font_case_bold
370
+ else:
371
+ if not (c in (10, 15, 20) and cell.value and str(cell.value).strip().lower() == "fail"):
372
+ cell.font = font_case
373
+ cell.border = thin_border
374
+ if cell.fill.fill_type != 'solid':
375
+ cell.fill = fill_white
376
+
377
+ # Height calculation
378
+ lines_cnt = max(len(steps.splitlines()), len(expected.splitlines()), 1)
379
+ target_ws.row_dimensions[cur_row].height = max(26, lines_cnt * 18)
380
+
381
+ cur_row += 1
382
+ case_count += 1
383
+
384
+ last_row = max(cur_row - 1, start_row)
385
+
386
+ # Cleanly remove any trailing rows from bottom up if template had more rows
387
+ if template_max_r > last_row:
388
+ target_ws.delete_rows(last_row + 1, template_max_r - last_row)
389
+
390
+ # Dynamic formula update in summary header (rows 3-7) to match exact case rows
391
+ target_ws["I3"] = f'=COUNTIFS($I$11:$I${last_row},I$2,$T$11:$T${last_row},$H3)'
392
+ target_ws["J3"] = f'=COUNTIFS($I$11:$I${last_row},$J$2,$T$11:$T${last_row},$H3)'
393
+ target_ws["K3"] = f'=COUNTIFS($I$11:$I${last_row},$K$2,$T$11:$T${last_row},$H3)'
394
+
395
+ target_ws["I4"] = f'=COUNTIFS($I$11:$I${last_row},$I$2,$T$11:$T${last_row},$H4)'
396
+ target_ws["J4"] = f'=COUNTIFS($I$11:$I${last_row},$J$2,$T$11:$T${last_row},$H4)'
397
+ target_ws["K4"] = f'=COUNTIFS($I$11:$I${last_row},$K$2,$T$11:$T${last_row},$H4)'
398
+
399
+ target_ws["I5"] = f'=COUNTIFS($I$11:$I${last_row},$I$2,$T$11:$T${last_row},$H5)'
400
+ target_ws["J5"] = f'=COUNTIFS($I$11:$I${last_row},$J$2,$T$11:$T${last_row},$H5)'
401
+ target_ws["K5"] = f'=COUNTIFS($I$11:$I${last_row},$K$2,$T$11:$T${last_row},$H5)'
402
+
403
+ target_ws["I6"] = f'=COUNTIFS($I$11:$I${last_row},$I$2,$T$11:$T${last_row},$H6)'
404
+ target_ws["J6"] = f'=COUNTIFS($I$11:$I${last_row},$J$2,$T$11:$T${last_row},$H6)'
405
+ target_ws["K6"] = f'=COUNTIFS($I$11:$I${last_row},$K$2,$T$11:$T${last_row},$H6)'
406
+
407
+ target_ws["Q3"] = f'=COUNTIF($I$11:$I${last_row},Q2)'
408
+ target_ws["R3"] = f'=COUNTIF($I$11:$I${last_row},R2)'
409
+ target_ws["S3"] = f'=COUNTIF($I$11:$I${last_row},S2)'
410
+
411
+ if not keep_other_sheets:
412
+ for sname in list(wb.sheetnames):
413
+ if sname != new_sheet_name:
414
+ del wb[sname]
415
+
416
+ # Save workbook
417
+ os.makedirs(os.path.dirname(os.path.abspath(output_path)), exist_ok=True)
418
+ wb.save(output_path)
419
+ return output_path
420
+
421
+
422
+ def main():
423
+ import argparse
424
+ parser = argparse.ArgumentParser(description="Template-driven Excel test case exporter for Synapse Hub.")
425
+ parser.add_argument("input_file", nargs="?", help="Path to markdown test cases file")
426
+ parser.add_argument("-o", "--output", help="Output .xlsx file path")
427
+ parser.add_argument("-t", "--template", help="Path to corporate template Excel workbook")
428
+ parser.add_argument("-s", "--sample-sheet", default=None, help="Sample sheet name to clone (defaults to .synapse.json or first sheet)")
429
+ parser.add_argument("--sheet-name", help="Target worksheet title")
430
+ parser.add_argument("--module-code", default="MODULE", help="Module Code identifier")
431
+ parser.add_argument("--module-name", default="Test Module", help="Module Name in Vietnamese/English")
432
+ parser.add_argument("--author", default="QA Engineer", help="Author name")
433
+ parser.add_argument("--tester", default="QA Engineer", help="Tester name")
434
+ parser.add_argument("--standalone", action="store_true", help="Keep only the newly exported sheet, removing others")
435
+
436
+ args = parser.parse_args()
437
+
438
+ # Auto-load from .synapse.json if available
439
+ cfg = find_project_config()
440
+ template_path = args.template
441
+ sample_sheet = args.sample_sheet
442
+ author = args.author
443
+ default_out = "test_cases_exported.xlsx"
444
+
445
+ if cfg:
446
+ tc_cfg = cfg.get("testcase_export", {})
447
+ cfg_dir = cfg.get("_config_dir", "")
448
+ if not template_path and tc_cfg.get("template_path"):
449
+ template_path = os.path.normpath(os.path.join(cfg_dir, tc_cfg["template_path"]))
450
+ if "sample_sheet" in tc_cfg:
451
+ sample_sheet = tc_cfg["sample_sheet"]
452
+ project_cfg = cfg.get("project")
453
+ if isinstance(project_cfg, dict) and "author" in project_cfg:
454
+ author = project_cfg["author"]
455
+ if "default_output_dir" in tc_cfg:
456
+ default_out = os.path.join(cfg_dir, tc_cfg["default_output_dir"], "test_cases_output.xlsx")
457
+
458
+ output_path = args.output or default_out
459
+
460
+ if not args.input_file or not args.input_file.strip():
461
+ print("\n❌ Lỗi: Bạn chưa cung cấp đường dẫn file Markdown test cases.")
462
+ print("\n💡 Hướng Dẫn Sử Dụng (Friendly Fix Hints):")
463
+ print(" 👉 Cú pháp cơ bản:")
464
+ print(" agent-qa export-excel <duong_dan_file.md> [-o output.xlsx]")
465
+ print(" python tools/template_excel_exporter.py <duong_dan_file.md> [tùy_chọn]")
466
+ print("\n 👉 Ví dụ thực tế:")
467
+ print(" agent-qa export-excel docs/TEST_CASES.md -o reports/test_cases.xlsx")
468
+ print(" agent-qa export-excel docs/TEST_CASES.md -t templates/template.xlsx --sheet-name \"DangNhap\"")
469
+ print("\n 👉 Khởi tạo file cấu hình .synapse.json cho dự án:")
470
+ print(" agent-qa init-config\n")
471
+ sys.exit(1)
472
+
473
+ if not os.path.exists(args.input_file):
474
+ print(f"\n❌ Lỗi: Không tìm thấy file Markdown: '{args.input_file}'")
475
+ print("💡 Hãy kiểm tra lại đường dẫn file hoặc tạo file Markdown test cases trước khi xuất Excel.")
476
+ print(" Ví dụ: agent-qa export-excel docs/TEST_CASES.md -o output.xlsx\n")
477
+ sys.exit(1)
478
+
479
+ with open(args.input_file, "r", encoding="utf-8") as f:
480
+ content = f.read()
481
+
482
+ rows = parse_testcases_from_markdown(content)
483
+ if not template_path or not os.path.isfile(template_path):
484
+ if template_path:
485
+ print(f"Notice: Template file '{template_path}' not found or is not a valid file. Falling back to Hub default 12-column exporter.")
486
+ else:
487
+ print("Notice: No template file specified. Falling back to Hub default 12-column exporter.")
488
+ import md_to_xlsx
489
+ try:
490
+ total = md_to_xlsx.convert_markdown_to_xlsx(args.input_file, output_path, sheet_name=args.sheet_name or "Test Cases")
491
+ print(f"Successfully exported {total} test case(s) to '{output_path}' (Default Hub 12-Column Layout)")
492
+ return 0
493
+ except Exception as e:
494
+ print(f"Error: Failed to export test cases: {e}", file=sys.stderr)
495
+ return 1
496
+
497
+ out = clone_and_export_template(
498
+ rows=rows,
499
+ output_path=output_path,
500
+ template_path=template_path,
501
+ sample_sheet_name=sample_sheet,
502
+ target_sheet_name=args.sheet_name or sample_sheet,
503
+ module_code=args.module_code,
504
+ module_name=args.module_name,
505
+ author=author,
506
+ tester=args.tester,
507
+ keep_other_sheets=not args.standalone
508
+ )
509
+ print(f"Successfully exported {len([r for r in rows if r.get('type') == 'case'])} test cases to '{out}' using template '{sample_sheet}'.")
510
+ return 0
511
+
512
+
513
+ if __name__ == "__main__":
514
+ main()
@@ -0,0 +1,54 @@
1
+ # Enterprise Apache JMeter Distributed Load Testing Architecture
2
+
3
+ This directory provides a 1-click Dockerized distributed JMeter cluster for injecting high-concurrency loads (> 5,000–50,000 VUs) across multiple injection nodes.
4
+
5
+ ---
6
+
7
+ ## Architecture Overview
8
+
9
+ ```
10
+ +-------------------+
11
+ | jmeter-master | (Controller)
12
+ +---------+---------+
13
+ | RMI (Non-SSL)
14
+ +-----------------------+-----------------------+
15
+ | | |
16
+ +-------v-------+ +-------v-------+ +-------v-------+
17
+ | jmeter-slave-1| | jmeter-slave-2| | jmeter-slave-3|
18
+ | (1,000 VUs) | | (1,000 VUs) | | (1,000 VUs) |
19
+ +-------+-------+ +-------+-------+ +-------+-------+
20
+ | | |
21
+ +-----------------------+-----------------------+
22
+ |
23
+ [Target System]
24
+ ```
25
+
26
+ ---
27
+
28
+ ## Quick Start (3 Steps)
29
+
30
+ ### 1. Start the Cluster
31
+ ```bash
32
+ docker-compose up -d
33
+ ```
34
+
35
+ ### 2. Run Distributed Headless Execution from Master
36
+ Copy your test plan (generated by Synapse-Hub `agent-qa generate-jmx`) into `./plans/perf_plan.jmx`, then trigger:
37
+ ```bash
38
+ docker exec -it jmeter-master jmeter -n \
39
+ -t /jmeter/plans/perf_plan.jmx \
40
+ -R jmeter-slave-1,jmeter-slave-2,jmeter-slave-3 \
41
+ -Dserver.rmi.ssl.disable=true \
42
+ -l /jmeter/reports/distributed_results.jtl \
43
+ -e -o /jmeter/reports/dashboard
44
+ ```
45
+
46
+ ### 3. Evaluate SLA with Synapse-Hub Quality Gate
47
+ ```bash
48
+ agent-qa analyze-jtl ./reports/distributed_results.jtl --sla-p95 500 --max-error-rate 1.0
49
+ ```
50
+
51
+ ### 4. Teardown
52
+ ```bash
53
+ docker-compose down -v
54
+ ```
@@ -0,0 +1,83 @@
1
+ version: '3.8'
2
+
3
+ # ==============================================================================
4
+ # Apache JMeter 5.x Distributed Load Testing Cluster (Master + 3 Slaves)
5
+ # Auto-provisioned by Synapse-Hub Performance Suite
6
+ # ==============================================================================
7
+
8
+ services:
9
+ # ----------------------------------------------------------------------------
10
+ # Slave Injector Node 1
11
+ # ----------------------------------------------------------------------------
12
+ jmeter-slave-1:
13
+ image: justb4/jmeter:5.5
14
+ container_name: jmeter-slave-1
15
+ command: >
16
+ -n -s
17
+ -Dserver.rmi.ssl.disable=true
18
+ -Dserver_port=1099
19
+ -Dserver.rmi.localport=50000
20
+ expose:
21
+ - "1099"
22
+ - "50000"
23
+ networks:
24
+ - jmeter-cluster
25
+
26
+ # ----------------------------------------------------------------------------
27
+ # Slave Injector Node 2
28
+ # ----------------------------------------------------------------------------
29
+ jmeter-slave-2:
30
+ image: justb4/jmeter:5.5
31
+ container_name: jmeter-slave-2
32
+ command: >
33
+ -n -s
34
+ -Dserver.rmi.ssl.disable=true
35
+ -Dserver_port=1099
36
+ -Dserver.rmi.localport=50000
37
+ expose:
38
+ - "1099"
39
+ - "50000"
40
+ networks:
41
+ - jmeter-cluster
42
+
43
+ # ----------------------------------------------------------------------------
44
+ # Slave Injector Node 3
45
+ # ----------------------------------------------------------------------------
46
+ jmeter-slave-3:
47
+ image: justb4/jmeter:5.5
48
+ container_name: jmeter-slave-3
49
+ command: >
50
+ -n -s
51
+ -Dserver.rmi.ssl.disable=true
52
+ -Dserver_port=1099
53
+ -Dserver.rmi.localport=50000
54
+ expose:
55
+ - "1099"
56
+ - "50000"
57
+ networks:
58
+ - jmeter-cluster
59
+
60
+ # ----------------------------------------------------------------------------
61
+ # Master Controller Node
62
+ # ----------------------------------------------------------------------------
63
+ jmeter-master:
64
+ image: justb4/jmeter:5.5
65
+ container_name: jmeter-master
66
+ depends_on:
67
+ - jmeter-slave-1
68
+ - jmeter-slave-2
69
+ - jmeter-slave-3
70
+ volumes:
71
+ - ./plans:/jmeter/plans
72
+ - ./reports:/jmeter/reports
73
+ environment:
74
+ - JVM_ARGS="-Xms1g -Xmx2g"
75
+ entrypoint: ["/bin/sh", "-c"]
76
+ command: >
77
+ "tail -f /dev/null"
78
+ networks:
79
+ - jmeter-cluster
80
+
81
+ networks:
82
+ jmeter-cluster:
83
+ driver: bridge