@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.
- package/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +172 -0
- package/README.md +171 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +197 -0
- package/docs/ARCHITECTURE.md +198 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +175 -0
- package/docs/CLI_REFERENCE.md +177 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +121 -0
- package/docs/QUALITY_GATES.md +121 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1359 -0
- package/docs/schemas/synapse.config.schema.json +87 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +32 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2079 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +258 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +184 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2419 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +307 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +724 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1259 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- package/tools/welcome_page.py +290 -0
|
@@ -0,0 +1,566 @@
|
|
|
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
|
+
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()
|