@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,566 @@
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/jira_sync.py — Jira / Xray / Zephyr Enterprise 2-Way Synchronization Engine
8
+ ---------------------------------------------------------------------------------
9
+ Zero external dependencies (pure Python standard library: urllib.request).
10
+ Bridges Synapse Hub with Atlassian Jira Cloud & Data Center:
11
+ 1. pull-story: Pulls user story & acceptance criteria into standardized Markdown.
12
+ 2. push-tests: Creates/updates Test Issues (Xray/Zephyr) linked to User Stories.
13
+ 3. import-exec: Pushes JUnit XML execution results into Jira/Xray Test Executions.
14
+ 4. create-bug: Autonomously files Jira Bug tickets with failure traces and screenshots.
15
+ 5. test-conn: Verifies API connectivity and credentials.
16
+ """
17
+
18
+ import os
19
+ import re
20
+ import sys
21
+ import time
22
+ import json
23
+ import base64
24
+ import argparse
25
+ import mimetypes
26
+ import xml.etree.ElementTree as ET
27
+ from typing import Dict, Any, List, Optional
28
+ import urllib.request
29
+ import urllib.error
30
+
31
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
32
+ if hasattr(sys.stdout, 'reconfigure'):
33
+ try:
34
+ sys.stdout.reconfigure(encoding='utf-8')
35
+ sys.stderr.reconfigure(encoding='utf-8')
36
+ except Exception:
37
+ pass
38
+
39
+ REPO_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
40
+
41
+
42
+ class JiraConfig:
43
+ """Resolves and encapsulates Jira configuration and authentication credentials."""
44
+
45
+ def __init__(
46
+ self,
47
+ base_url: Optional[str] = None,
48
+ email: Optional[str] = None,
49
+ api_token: Optional[str] = None,
50
+ pat: Optional[str] = None,
51
+ project_key: Optional[str] = None,
52
+ config_path: Optional[str] = None
53
+ ):
54
+ self.config_data = self._load_synapse_config(config_path)
55
+ jira_cfg = self.config_data.get("jira", {})
56
+
57
+ # Resolution Precedence: Explicit CLI -> Environment Variables -> .synapse.json
58
+ self.base_url = (
59
+ base_url
60
+ or os.environ.get("JIRA_BASE_URL")
61
+ or jira_cfg.get("baseUrl")
62
+ or "https://jira.example.com"
63
+ ).rstrip("/")
64
+
65
+ self.email = (
66
+ email
67
+ or os.environ.get("JIRA_EMAIL")
68
+ or os.environ.get("JIRA_USER")
69
+ or jira_cfg.get("email")
70
+ or ""
71
+ )
72
+
73
+ token_raw = (
74
+ api_token
75
+ or os.environ.get("JIRA_API_TOKEN")
76
+ or os.environ.get("JIRA_TOKEN")
77
+ or jira_cfg.get("apiToken")
78
+ or ""
79
+ )
80
+ if token_raw.startswith("env:"):
81
+ env_var = token_raw[4:]
82
+ self.api_token = os.environ.get(env_var, "")
83
+ else:
84
+ self.api_token = token_raw
85
+
86
+ pat_raw = pat or os.environ.get("JIRA_PAT") or jira_cfg.get("pat") or ""
87
+ if pat_raw.startswith("env:"):
88
+ self.pat = os.environ.get(pat_raw[4:], "")
89
+ else:
90
+ self.pat = pat_raw
91
+
92
+ self.project_key = (
93
+ project_key
94
+ or os.environ.get("JIRA_PROJECT_KEY")
95
+ or jira_cfg.get("projectKey")
96
+ or "QA"
97
+ )
98
+ self.issue_type_test = jira_cfg.get("issueTypeTest", "Test")
99
+ self.issue_type_bug = jira_cfg.get("issueTypeBug", "Bug")
100
+
101
+ def _load_synapse_config(self, custom_path: Optional[str] = None) -> Dict[str, Any]:
102
+ cfg_path = custom_path or os.path.join(REPO_ROOT, ".synapse.json")
103
+ if os.path.isfile(cfg_path):
104
+ try:
105
+ with open(cfg_path, "r", encoding="utf-8") as f:
106
+ return json.load(f)
107
+ except Exception:
108
+ return {}
109
+ return {}
110
+
111
+ def get_auth_headers(self) -> Dict[str, str]:
112
+ """Generates RFC 7617 Basic Auth or Bearer Authorization headers."""
113
+ headers = {
114
+ "Accept": "application/json",
115
+ "Content-Type": "application/json"
116
+ }
117
+ if self.pat:
118
+ headers["Authorization"] = f"Bearer {self.pat}"
119
+ elif self.email and self.api_token:
120
+ creds = f"{self.email}:{self.api_token}".encode("utf-8")
121
+ b64_creds = base64.b64encode(creds).decode("ascii")
122
+ headers["Authorization"] = f"Basic {b64_creds}"
123
+ return headers
124
+
125
+
126
+ class JiraClient:
127
+ """REST API Client for Jira Cloud and Jira Data Center (stdlib only)."""
128
+
129
+ def __init__(self, config: JiraConfig, dry_run: bool = False):
130
+ self.config = config
131
+ self.dry_run = dry_run
132
+
133
+ def request(
134
+ self,
135
+ endpoint: str,
136
+ method: str = "GET",
137
+ data: Optional[Dict[str, Any]] = None,
138
+ custom_headers: Optional[Dict[str, str]] = None
139
+ ) -> Dict[str, Any]:
140
+ """Performs HTTP request to Jira REST API."""
141
+ url = f"{self.config.base_url}{endpoint}"
142
+ headers = self.config.get_auth_headers()
143
+ if custom_headers:
144
+ headers.update(custom_headers)
145
+
146
+ if self.dry_run and method in ("POST", "PUT", "DELETE"):
147
+ print(f"[DRY-RUN] {method} -> {url}")
148
+ if data:
149
+ print(f"[DRY-RUN] Payload: {json.dumps(data, indent=2, ensure_ascii=False)}")
150
+ return {"key": f"{self.config.project_key}-DRYRUN", "id": "99999", "dry_run": True}
151
+
152
+ body_bytes = json.dumps(data, ensure_ascii=False).encode("utf-8") if data else None
153
+ req = urllib.request.Request(url, data=body_bytes, headers=headers, method=method)
154
+
155
+ try:
156
+ with urllib.request.urlopen(req, timeout=30.0) as resp:
157
+ resp_bytes = resp.read()
158
+ if not resp_bytes:
159
+ return {"status": resp.status}
160
+ return json.loads(resp_bytes.decode("utf-8"))
161
+ except urllib.error.HTTPError as err:
162
+ err_body = err.read().decode("utf-8", errors="replace")
163
+ raise RuntimeError(f"Jira API Error [{err.code}] {err.reason}: {err_body}")
164
+ except urllib.error.URLError as err:
165
+ raise RuntimeError(f"Failed to connect to Jira at {self.config.base_url}: {err.reason}")
166
+
167
+ def test_connection(self) -> Dict[str, Any]:
168
+ """Tests connectivity and returns authenticated user info."""
169
+ if self.dry_run:
170
+ print("[DRY-RUN] Connection test simulated successfully.")
171
+ return {"status": "OK", "user": "dry_run_user", "mode": "DRY-RUN"}
172
+ res = self.request("/rest/api/2/myself")
173
+ name = res.get("displayName") or res.get("name") or "Authenticated User"
174
+ print(f"✅ Connected to Jira successfully as: {name} ({res.get('emailAddress', 'N/A')})")
175
+ return res
176
+
177
+ def get_issue(self, issue_key: str) -> Dict[str, Any]:
178
+ """Fetches issue details by key."""
179
+ return self.request(f"/rest/api/2/issue/{issue_key}?expand=names,renderedFields")
180
+
181
+ def create_issue(
182
+ self,
183
+ summary: str,
184
+ description: str,
185
+ issue_type: str,
186
+ priority: str = "Medium",
187
+ labels: Optional[List[str]] = None,
188
+ parent_key: Optional[str] = None
189
+ ) -> Dict[str, Any]:
190
+ """Creates a Jira issue."""
191
+ fields: Dict[str, Any] = {
192
+ "project": {"key": self.config.project_key},
193
+ "summary": summary,
194
+ "description": description,
195
+ "issuetype": {"name": issue_type},
196
+ "priority": {"name": priority},
197
+ "labels": labels or ["synapse-hub", "automated"]
198
+ }
199
+ if parent_key and issue_type.lower() in ("sub-task", "subtask"):
200
+ fields["parent"] = {"key": parent_key}
201
+
202
+ payload = {"fields": fields}
203
+ return self.request("/rest/api/2/issue", method="POST", data=payload)
204
+
205
+ def attach_file(self, issue_key: str, file_path: str) -> Dict[str, Any]:
206
+ """Attaches a file to an issue using multipart/form-data."""
207
+ if not os.path.isfile(file_path):
208
+ raise FileNotFoundError(f"Attachment file not found: {file_path}")
209
+
210
+ if self.dry_run:
211
+ print(f"[DRY-RUN] Would attach '{file_path}' to issue {issue_key}")
212
+ return {"dry_run": True, "attached": file_path}
213
+
214
+ url = f"{self.config.base_url}/rest/api/2/issue/{issue_key}/attachments"
215
+ headers = self.config.get_auth_headers()
216
+ headers["X-Atlassian-Token"] = "no-check"
217
+ del headers["Content-Type"]
218
+
219
+ boundary = f"----SynapseHubBoundary{int(time.time() * 1000)}"
220
+ headers["Content-Type"] = f"multipart/form-data; boundary={boundary}"
221
+
222
+ filename = os.path.basename(file_path)
223
+ mime_type = mimetypes.guess_type(file_path)[0] or "application/octet-stream"
224
+
225
+ with open(file_path, "rb") as f:
226
+ file_bytes = f.read()
227
+
228
+ body = (
229
+ f"--{boundary}\r\n"
230
+ f'Content-Disposition: form-data; name="file"; filename="{filename}"\r\n'
231
+ f"Content-Type: {mime_type}\r\n\r\n"
232
+ ).encode("utf-8") + file_bytes + f"\r\n--{boundary}--\r\n".encode("utf-8")
233
+
234
+ req = urllib.request.Request(url, data=body, headers=headers, method="POST")
235
+ try:
236
+ with urllib.request.urlopen(req, timeout=30.0) as resp:
237
+ return json.loads(resp.read().decode("utf-8"))
238
+ except urllib.error.HTTPError as err:
239
+ err_body = err.read().decode("utf-8", errors="replace")
240
+ raise RuntimeError(f"Failed to attach file to {issue_key}: [{err.code}] {err_body}")
241
+
242
+
243
+ def parse_markdown_testcases(md_content: str) -> List[Dict[str, Any]]:
244
+ """Parses markdown test case tables or bulleted test scenarios into structured dicts."""
245
+ testcases = []
246
+ lines = md_content.splitlines()
247
+
248
+ # Look for table header with Test ID / Summary / Steps / Expected
249
+ table_mode = False
250
+ headers = []
251
+ for line in lines:
252
+ line_clean = line.strip()
253
+ if "|" in line_clean:
254
+ cols = [c.strip() for c in line_clean.split("|")[1:-1]]
255
+ if any("test" in c.lower() or "summary" in c.lower() or "tiêu chí" in c.lower() for c in cols):
256
+ table_mode = True
257
+ headers = [c.lower() for c in cols]
258
+ continue
259
+ if table_mode and re.match(r"^[\s\-|:]+$", line_clean):
260
+ continue
261
+ if table_mode and len(cols) >= 2:
262
+ tc = {
263
+ "id": cols[0],
264
+ "summary": cols[1],
265
+ "description": cols[2] if len(cols) > 2 else cols[1],
266
+ "expected": cols[3] if len(cols) > 3 else "Pass"
267
+ }
268
+ testcases.append(tc)
269
+ elif line_clean.startswith("### ") or line_clean.startswith("## "):
270
+ table_mode = False
271
+ title = line_clean.lstrip("#").strip()
272
+ if any(kw in title.lower() for kw in ("test", "tc_", "kịch bản", "scenario")):
273
+ testcases.append({
274
+ "id": f"TC_{len(testcases) + 1}",
275
+ "summary": title,
276
+ "description": title,
277
+ "expected": "Pass"
278
+ })
279
+
280
+ return testcases
281
+
282
+
283
+ def parse_junit_xml(xml_path: str) -> Dict[str, Any]:
284
+ """Parses a JUnit XML report file into execution metrics."""
285
+ if not os.path.isfile(xml_path):
286
+ raise FileNotFoundError(f"JUnit XML report not found: {xml_path}")
287
+
288
+ tree = ET.parse(xml_path)
289
+ root = tree.getroot()
290
+
291
+ total_tests = 0
292
+ total_failures = 0
293
+ total_errors = 0
294
+ total_time = 0.0
295
+ cases = []
296
+
297
+ # Handle both <testsuites> and single <testsuite> root
298
+ suites = root.findall(".//testsuite") if root.tag != "testsuite" else [root]
299
+ for suite in suites:
300
+ total_tests += int(suite.attrib.get("tests", 0))
301
+ total_failures += int(suite.attrib.get("failures", 0))
302
+ total_errors += int(suite.attrib.get("errors", 0))
303
+ total_time += float(suite.attrib.get("time", 0.0))
304
+
305
+ for tc in suite.findall("testcase"):
306
+ tc_name = tc.attrib.get("name", "Unnamed")
307
+ tc_class = tc.attrib.get("classname", "")
308
+ tc_time = float(tc.attrib.get("time", 0.0))
309
+
310
+ failure_el = tc.find("failure")
311
+ if failure_el is None:
312
+ failure_el = tc.find("error")
313
+
314
+ status = "FAILED" if failure_el is not None else "PASSED"
315
+ message = failure_el.attrib.get("message", "") if failure_el is not None else ""
316
+ trace = failure_el.text if failure_el is not None else ""
317
+
318
+ cases.append({
319
+ "name": tc_name,
320
+ "classname": tc_class,
321
+ "time": tc_time,
322
+ "status": status,
323
+ "message": message,
324
+ "trace": trace
325
+ })
326
+
327
+ return {
328
+ "tests": total_tests,
329
+ "failures": total_failures,
330
+ "errors": total_errors,
331
+ "time": round(total_time, 2),
332
+ "cases": cases
333
+ }
334
+
335
+
336
+ def pull_story(client: JiraClient, story_key: str, out_dir: str = "requirements/jira"):
337
+ """Pulls a Jira User Story and generates clean requirement Markdown and attachments."""
338
+ print(f"📥 Pulling Jira requirement for '{story_key}'...")
339
+ issue = client.get_issue(story_key)
340
+ fields = issue.get("fields", {})
341
+
342
+ summary = fields.get("summary", "No Summary")
343
+ description = fields.get("description", "No Description")
344
+ issue_type = fields.get("issuetype", {}).get("name", "Story")
345
+ status = fields.get("status", {}).get("name", "Open")
346
+ priority = fields.get("priority", {}).get("name", "Medium")
347
+
348
+ if os.path.isabs(out_dir):
349
+ dest_dir = os.path.join(out_dir, story_key)
350
+ else:
351
+ dest_dir = os.path.join(REPO_ROOT, out_dir, story_key)
352
+ os.makedirs(dest_dir, exist_ok=True)
353
+ md_path = os.path.join(dest_dir, f"{story_key}_requirement.md")
354
+
355
+ md_content = f"""# {story_key}: {summary}
356
+
357
+ | Thuộc tính | Giá trị |
358
+ |---|---|
359
+ | **Issue Key** | {story_key} |
360
+ | **Loại** | {issue_type} |
361
+ | **Trạng thái** | {status} |
362
+ | **Độ ưu tiên** | {priority} |
363
+ | **Ngày đồng bộ** | {time.strftime('%Y-%m-%d %H:%M:%S')} |
364
+
365
+ ## Mô tả & Tiêu chí chấp nhận (Description & AC)
366
+
367
+ {description or 'Không có mô tả chi tiết.'}
368
+
369
+ ---
370
+ *Bản đồng bộ tự động từ Jira REST API bởi Synapse Hub v3.2.2.*
371
+ """
372
+
373
+ with open(md_path, "w", encoding="utf-8") as f:
374
+ f.write(md_content)
375
+
376
+ try:
377
+ display_path = os.path.relpath(md_path, REPO_ROOT)
378
+ except ValueError:
379
+ display_path = md_path
380
+ print(f"✅ Saved requirement markdown: {display_path}")
381
+ return md_path
382
+
383
+
384
+ def push_tests_from_file(
385
+ client: JiraClient,
386
+ file_path: str,
387
+ story_key: Optional[str] = None
388
+ ) -> List[Dict[str, Any]]:
389
+ """Reads test cases from file and creates corresponding Test issues on Jira."""
390
+ if not os.path.isfile(file_path):
391
+ raise FileNotFoundError(f"Test case file not found: {file_path}")
392
+
393
+ with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
394
+ content = f.read()
395
+
396
+ testcases = parse_markdown_testcases(content)
397
+ if not testcases:
398
+ print(f"⚠️ No structured test cases found in {file_path}")
399
+ return []
400
+
401
+ print(f"📤 Pushing {len(testcases)} test case(s) from '{file_path}' to Jira project '{client.config.project_key}'...")
402
+ created_issues = []
403
+ for tc in testcases:
404
+ summary = f"[{tc['id']}] {tc['summary']}"
405
+ desc = (
406
+ f"h3. Synapse Hub Automated Test Specification\n\n"
407
+ f"*ID:* {tc['id']}\n"
408
+ f"*Summary:* {tc['summary']}\n"
409
+ f"*Description:* {tc.get('description', '')}\n"
410
+ f"*Expected Result:* {tc.get('expected', 'Pass')}\n\n"
411
+ )
412
+ if story_key:
413
+ desc += f"*Linked Story:* [{story_key}|{client.config.base_url}/browse/{story_key}]\n"
414
+
415
+ res = client.create_issue(
416
+ summary=summary,
417
+ description=desc,
418
+ issue_type=client.config.issue_type_test,
419
+ labels=["synapse-hub", "automated", tc['id']]
420
+ )
421
+ created_issues.append(res)
422
+ print(f" [PASS] Created Test Issue: {res.get('key', 'UNKNOWN')}")
423
+
424
+ return created_issues
425
+
426
+
427
+ def create_bug_report(
428
+ client: JiraClient,
429
+ summary: str,
430
+ trace: str,
431
+ screenshot_path: Optional[str] = None,
432
+ suite_name: Optional[str] = None
433
+ ) -> Dict[str, Any]:
434
+ """Creates an automated Bug issue on Jira with error details and screenshot."""
435
+ full_summary = f"[Auto-Bug][{suite_name or 'E2E'}] {summary}"
436
+ desc = f"""h3. 🛑 Automated Test Failure Detected by Synapse Hub
437
+
438
+ *Suite:* {suite_name or 'Automated QA Suite'}
439
+ *Environment:* OS: {sys.platform} | Python: {sys.version.split()[0]} | Hub Core: v3.2.2
440
+ *Timestamp:* {time.strftime('%Y-%m-%d %H:%M:%S')}
441
+
442
+ h4. Stack Trace & Root Cause
443
+ {{noformat}}
444
+ {trace}
445
+ {{noformat}}
446
+
447
+ *Reported autonomously by Synapse Hub DoD Gatekeeper.*
448
+ """
449
+ print(f"🐞 Filing Jira Bug: '{full_summary}'...")
450
+ res = client.create_issue(
451
+ summary=full_summary,
452
+ description=desc,
453
+ issue_type=client.config.issue_type_bug,
454
+ priority="High",
455
+ labels=["synapse-hub", "auto-bug", "ci-failure"]
456
+ )
457
+ bug_key = res.get("key", "UNKNOWN")
458
+ print(f"✅ Bug created successfully: {bug_key}")
459
+
460
+ if screenshot_path and os.path.isfile(screenshot_path):
461
+ print(f"📎 Attaching screenshot '{screenshot_path}' to {bug_key}...")
462
+ client.attach_file(bug_key, screenshot_path)
463
+ print(" [PASS] Screenshot attached.")
464
+
465
+ return res
466
+
467
+
468
+ def import_junit_execution(client: JiraClient, xml_path: str) -> Dict[str, Any]:
469
+ """Imports JUnit execution metrics to Jira / Xray Test Execution."""
470
+ metrics = parse_junit_xml(xml_path)
471
+ summary = f"[Test-Execution] Automated Test Run ({metrics['tests']} Tests, {metrics['failures']} Failures)"
472
+
473
+ case_lines = []
474
+ for c in metrics["cases"][:20]: # Cap first 20 in summary
475
+ status_icon = "(/)" if c["status"] == "PASSED" else "(x)"
476
+ case_lines.append(f"* {status_icon} *{c['name']}* ({c['time']}s)")
477
+
478
+ desc = f"""h3. 🚀 Synapse Hub Automated Test Execution Report
479
+
480
+ *Total Tests:* {metrics['tests']}
481
+ *Failures:* {metrics['failures']}
482
+ *Errors:* {metrics['errors']}
483
+ *Total Execution Time:* {metrics['time']}s
484
+
485
+ h4. Test Case Breakdown
486
+ {chr(10).join(case_lines)}
487
+
488
+ *Exported from JUnit XML: {os.path.basename(xml_path)}*
489
+ """
490
+ print(f"📊 Creating Test Execution issue on Jira ({metrics['tests']} tests)...")
491
+ res = client.create_issue(
492
+ summary=summary,
493
+ description=desc,
494
+ issue_type="Test Execution",
495
+ labels=["synapse-hub", "test-execution", "junit-import"]
496
+ )
497
+ print(f"✅ Test Execution issue created: {res.get('key', 'UNKNOWN')}")
498
+ return res
499
+
500
+
501
+ def main():
502
+ parent_parser = argparse.ArgumentParser(add_help=False)
503
+ parent_parser.add_argument("--url", default=None, help="Jira Base URL (or via JIRA_BASE_URL)")
504
+ parent_parser.add_argument("--email", default=None, help="Jira Email address (or via JIRA_EMAIL)")
505
+ parent_parser.add_argument("--token", default=None, help="Jira API Token (or via JIRA_API_TOKEN)")
506
+ parent_parser.add_argument("--pat", default=None, help="Jira Personal Access Token (or via JIRA_PAT)")
507
+ parent_parser.add_argument("--project", "-p", default=None, help="Jira Project Key (or via JIRA_PROJECT_KEY)")
508
+ parent_parser.add_argument("--dry-run", action="store_true", help="Simulate API calls without writing to Jira")
509
+
510
+ parser = argparse.ArgumentParser(
511
+ description="Synapse Hub — Jira / Xray / Zephyr 2-Way Sync Engine",
512
+ parents=[parent_parser]
513
+ )
514
+ subparsers = parser.add_subparsers(dest="action", help="Action to execute")
515
+
516
+ # test-conn
517
+ subparsers.add_parser("test-conn", parents=[parent_parser], help="Verify credentials and connectivity to Jira REST API")
518
+
519
+ # pull-story
520
+ p_pull = subparsers.add_parser("pull-story", parents=[parent_parser], help="Pull User Story requirement from Jira into Markdown")
521
+ p_pull.add_argument("story_key", help="Jira Issue Key (e.g. KAN-1, PROJ-102)")
522
+ p_pull.add_argument("--out-dir", default="requirements/jira", help="Output directory for requirement markdown")
523
+
524
+ # push-tests
525
+ p_push = subparsers.add_parser("push-tests", parents=[parent_parser], help="Push test cases from markdown file to Jira Test issues")
526
+ p_push.add_argument("--file", "-f", required=True, help="Path to markdown or text file with test cases")
527
+ p_push.add_argument("--story", "-s", default=None, help="Parent User Story Key to link test cases to")
528
+
529
+ # create-bug
530
+ p_bug = subparsers.add_parser("create-bug", parents=[parent_parser], help="File an automated Bug ticket on Jira from test failure")
531
+ p_bug.add_argument("--summary", required=True, help="Short summary of the bug")
532
+ p_bug.add_argument("--trace", default="No stack trace provided.", help="Failure stack trace or error log")
533
+ p_bug.add_argument("--screenshot", default=None, help="Path to error screenshot (e.g. Screenshots/FAILED_*.png)")
534
+ p_bug.add_argument("--suite", default="E2E", help="Test suite name")
535
+
536
+ # import-exec
537
+ p_import = subparsers.add_parser("import-exec", parents=[parent_parser], help="Import JUnit XML report as a Jira Test Execution")
538
+ p_import.add_argument("--junit", required=True, help="Path to JUnit XML report file")
539
+
540
+ args = parser.parse_args()
541
+
542
+ cfg = JiraConfig(
543
+ base_url=args.url,
544
+ email=args.email,
545
+ api_token=args.token,
546
+ pat=args.pat,
547
+ project_key=args.project
548
+ )
549
+ client = JiraClient(cfg, dry_run=args.dry_run)
550
+
551
+ if args.action == "test-conn":
552
+ client.test_connection()
553
+ elif args.action == "pull-story":
554
+ pull_story(client, args.story_key, args.out_dir)
555
+ elif args.action == "push-tests":
556
+ push_tests_from_file(client, args.file, args.story)
557
+ elif args.action == "create-bug":
558
+ create_bug_report(client, args.summary, args.trace, args.screenshot, args.suite)
559
+ elif args.action == "import-exec":
560
+ import_junit_execution(client, args.junit)
561
+ else:
562
+ parser.print_help()
563
+
564
+
565
+ if __name__ == "__main__":
566
+ main()