@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.
- 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 +171 -0
- package/README.md +170 -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 +198 -0
- package/docs/ARCHITECTURE.md +199 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +174 -0
- package/docs/CLI_REFERENCE.md +176 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +118 -0
- package/docs/QUALITY_GATES.md +118 -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 +1358 -0
- package/docs/schemas/synapse.config.schema.json +86 -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 +31 -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 +2074 -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 +262 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +190 -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 +2403 -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 +306 -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 +725 -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 +1271 -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,426 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
==============================================================================
|
|
4
|
+
Enterprise Automation - Environment & Onboarding Diagnostic Tool
|
|
5
|
+
==============================================================================
|
|
6
|
+
Comprehensive environment diagnostic tool for freshly cloned test repositories.
|
|
7
|
+
Supports Automation QA, SDETs, Developers, and CI/CD pipelines.
|
|
8
|
+
Zero external dependencies (Pure Python Standard Library).
|
|
9
|
+
Autonomously detects Target Project or QA Hub (CLI, CWD, ENV).
|
|
10
|
+
==============================================================================
|
|
11
|
+
"""
|
|
12
|
+
|
|
13
|
+
import os
|
|
14
|
+
import sys
|
|
15
|
+
import shlex
|
|
16
|
+
import platform
|
|
17
|
+
import subprocess
|
|
18
|
+
import argparse
|
|
19
|
+
import urllib.request
|
|
20
|
+
import ssl
|
|
21
|
+
from pathlib import Path
|
|
22
|
+
|
|
23
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
24
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
25
|
+
try:
|
|
26
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
27
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
28
|
+
except Exception:
|
|
29
|
+
pass
|
|
30
|
+
|
|
31
|
+
# Console colors
|
|
32
|
+
GREEN = "\033[92m"
|
|
33
|
+
RED = "\033[91m"
|
|
34
|
+
YELLOW = "\033[93m"
|
|
35
|
+
CYAN = "\033[96m"
|
|
36
|
+
BOLD = "\033[1m"
|
|
37
|
+
RESET = "\033[0m"
|
|
38
|
+
|
|
39
|
+
if platform.system() == "Windows" and not os.environ.get("WT_SESSION"):
|
|
40
|
+
GREEN = RED = YELLOW = CYAN = BOLD = RESET = ""
|
|
41
|
+
|
|
42
|
+
HUB_ROOT = Path(__file__).resolve().parent.parent
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
def resolve_target_repo(cli_target=None, cli_repo=None):
|
|
46
|
+
"""
|
|
47
|
+
Resolves the target repository path:
|
|
48
|
+
1. Explicit CLI flag: --repo / --path or positional target.
|
|
49
|
+
2. Environment variable: TARGET_PROJECT_DIR.
|
|
50
|
+
3. Current Working Directory (if different from Hub).
|
|
51
|
+
4. Default fallback: QA Hub root (parent of tools/).
|
|
52
|
+
"""
|
|
53
|
+
chosen = cli_repo or cli_target
|
|
54
|
+
if chosen:
|
|
55
|
+
resolved = Path(chosen).resolve()
|
|
56
|
+
if not resolved.exists():
|
|
57
|
+
raise FileNotFoundError(f"Target repository path not found: {resolved}")
|
|
58
|
+
return resolved
|
|
59
|
+
|
|
60
|
+
env_dir = os.environ.get("TARGET_PROJECT_DIR")
|
|
61
|
+
if env_dir and os.path.exists(env_dir):
|
|
62
|
+
return Path(env_dir).resolve()
|
|
63
|
+
|
|
64
|
+
cwd = Path.cwd().resolve()
|
|
65
|
+
if cwd != HUB_ROOT:
|
|
66
|
+
return cwd
|
|
67
|
+
|
|
68
|
+
return HUB_ROOT
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
class DiagnosticRunner:
|
|
72
|
+
def __init__(self, target_dir=None, insecure: bool = False):
|
|
73
|
+
self.target_dir = Path(target_dir or HUB_ROOT).resolve()
|
|
74
|
+
self.insecure = insecure
|
|
75
|
+
self.results = []
|
|
76
|
+
self.warnings = []
|
|
77
|
+
self.errors = []
|
|
78
|
+
self.is_standalone = False
|
|
79
|
+
|
|
80
|
+
def log_check(self, name, status, message, fix_hint=""):
|
|
81
|
+
badge = f"{GREEN}[PASS]{RESET}" if status == "PASS" else (f"{YELLOW}[WARN]{RESET}" if status == "WARN" else f"{RED}[FAIL]{RESET}")
|
|
82
|
+
print(f" {badge} {BOLD}{name:<32}{RESET} : {message}")
|
|
83
|
+
if fix_hint and status in ("WARN", "FAIL"):
|
|
84
|
+
print(f" 👉 {CYAN}Fix Hint:{RESET} {fix_hint}")
|
|
85
|
+
if status == "FAIL":
|
|
86
|
+
self.errors.append((name, fix_hint))
|
|
87
|
+
else:
|
|
88
|
+
self.warnings.append((name, fix_hint))
|
|
89
|
+
|
|
90
|
+
def run_command(self, cmd, timeout: float = 15.0):
|
|
91
|
+
try:
|
|
92
|
+
if isinstance(cmd, str):
|
|
93
|
+
cmd_args = shlex.split(cmd, posix=(platform.system() != "Windows"))
|
|
94
|
+
else:
|
|
95
|
+
cmd_args = list(cmd)
|
|
96
|
+
res = subprocess.run(cmd_args, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, shell=False, timeout=timeout)
|
|
97
|
+
out = res.stdout.strip() if res.stdout.strip() else res.stderr.strip()
|
|
98
|
+
return res.returncode == 0, out
|
|
99
|
+
except Exception as e:
|
|
100
|
+
return False, str(e)
|
|
101
|
+
|
|
102
|
+
def check_os(self):
|
|
103
|
+
"""Verifies operating system platform, kernel version, and architecture."""
|
|
104
|
+
os_name = platform.system()
|
|
105
|
+
os_ver = platform.release()
|
|
106
|
+
arch = platform.machine()
|
|
107
|
+
self.log_check("Operating System", "PASS", f"{os_name} {os_ver} ({arch})")
|
|
108
|
+
|
|
109
|
+
def check_git(self):
|
|
110
|
+
"""Verifies presence of Git in PATH for repository hooks and version control."""
|
|
111
|
+
found, out = self.run_command("git --version")
|
|
112
|
+
if found and out:
|
|
113
|
+
self.log_check("Git Version Control", "PASS", f"{out.splitlines()[0]}")
|
|
114
|
+
else:
|
|
115
|
+
self.log_check("Git Version Control", "FAIL", "Command 'git' not found in PATH",
|
|
116
|
+
"Install Git from https://git-scm.com/ to enable repository hooks and version control.")
|
|
117
|
+
|
|
118
|
+
def check_chrome(self):
|
|
119
|
+
"""Checks for Google Chrome, Chromium, Brave, or Playwright browser runtimes."""
|
|
120
|
+
# 1. Search via 'where' (Windows) or 'which' (Unix)
|
|
121
|
+
cmd = "where chrome" if platform.system() == "Windows" else "which google-chrome google-chrome-stable chromium chromium-browser"
|
|
122
|
+
found, out = self.run_command(cmd)
|
|
123
|
+
if found and out:
|
|
124
|
+
self.log_check("Google Chrome (Browser)", "PASS", f"Installed at {out.splitlines()[0]}")
|
|
125
|
+
return
|
|
126
|
+
|
|
127
|
+
# 2. Search macOS standard application bundles
|
|
128
|
+
if platform.system() == "Darwin":
|
|
129
|
+
mac_paths = [
|
|
130
|
+
Path("/Applications/Google Chrome.app"),
|
|
131
|
+
Path.home() / "Applications/Google Chrome.app",
|
|
132
|
+
Path("/Applications/Chromium.app"),
|
|
133
|
+
Path("/Applications/Brave Browser.app"),
|
|
134
|
+
Path("/Applications/Microsoft Edge.app")
|
|
135
|
+
]
|
|
136
|
+
for p in mac_paths:
|
|
137
|
+
if p.exists():
|
|
138
|
+
self.log_check("Google Chrome (Browser)", "PASS", f"Installed at {p}")
|
|
139
|
+
return
|
|
140
|
+
# Also check Playwright managed browser installations
|
|
141
|
+
pw_cache = Path.home() / "Library/Caches/ms-playwright"
|
|
142
|
+
if pw_cache.exists() and any(pw_cache.glob("chromium-*")):
|
|
143
|
+
self.log_check("Google Chrome (Browser)", "PASS", f"Playwright Chromium runtime verified at {pw_cache}")
|
|
144
|
+
return
|
|
145
|
+
|
|
146
|
+
# 3. Search Windows standard installation paths
|
|
147
|
+
if platform.system() == "Windows":
|
|
148
|
+
paths = [
|
|
149
|
+
os.path.expandvars(r"%ProgramFiles%\Google\Chrome\Application\chrome.exe"),
|
|
150
|
+
os.path.expandvars(r"%ProgramFiles(x86)%\Google\Chrome\Application\chrome.exe"),
|
|
151
|
+
os.path.expandvars(r"%LocalAppData%\Google\Chrome\Application\chrome.exe"),
|
|
152
|
+
]
|
|
153
|
+
for p in paths:
|
|
154
|
+
if os.path.exists(p):
|
|
155
|
+
self.log_check("Google Chrome (Browser)", "PASS", f"Installed at {p}")
|
|
156
|
+
return
|
|
157
|
+
|
|
158
|
+
self.log_check("Google Chrome (Browser)", "FAIL", "Google Chrome browser not found on system",
|
|
159
|
+
"Download and install Google Chrome from https://www.google.com/chrome/")
|
|
160
|
+
|
|
161
|
+
def check_java(self):
|
|
162
|
+
"""Verifies presence of Java JRE/JDK runtime via CLI or JAVA_HOME."""
|
|
163
|
+
found, out = self.run_command("java -version")
|
|
164
|
+
if found or "version" in out:
|
|
165
|
+
ver = out.splitlines()[0] if out else "Installed"
|
|
166
|
+
self.log_check("Java Runtime (JRE/JDK)", "PASS", f"Java runtime available ({ver})")
|
|
167
|
+
else:
|
|
168
|
+
jh = os.environ.get("JAVA_HOME")
|
|
169
|
+
if jh and os.path.exists(jh):
|
|
170
|
+
self.log_check("Java Runtime (JRE/JDK)", "PASS", f"JAVA_HOME = {jh}")
|
|
171
|
+
else:
|
|
172
|
+
self.log_check("Java Runtime (JRE/JDK)", "WARN", "Command 'java' not found in PATH or JAVA_HOME",
|
|
173
|
+
"Katalon includes embedded JRE, but for Gradle/Jenkins CLI, install OpenJDK 17.")
|
|
174
|
+
|
|
175
|
+
def check_katalon(self):
|
|
176
|
+
"""Verifies Katalon Studio / Katalon Runtime Engine installation if applicable."""
|
|
177
|
+
# Context-aware: check if current target is actually a Katalon project
|
|
178
|
+
is_katalon_project = (
|
|
179
|
+
any(self.target_dir.glob("*.prj"))
|
|
180
|
+
or (self.target_dir / "Keywords").exists()
|
|
181
|
+
or ((self.target_dir / "Scripts").exists() and any(self.target_dir.glob("Scripts/**/*.groovy")))
|
|
182
|
+
)
|
|
183
|
+
|
|
184
|
+
found, out = self.run_command("where katalonc" if platform.system() == "Windows" else "which katalonc")
|
|
185
|
+
if found and out:
|
|
186
|
+
self.log_check("Katalon Runtime Engine (KRE)", "PASS", f"Found katalonc at {out.splitlines()[0]}")
|
|
187
|
+
return
|
|
188
|
+
|
|
189
|
+
if platform.system() == "Windows":
|
|
190
|
+
user_home = os.path.expanduser("~")
|
|
191
|
+
katalon_candidates = [
|
|
192
|
+
r"C:\Katalon_Studio",
|
|
193
|
+
r"D:\Katalon_Studio",
|
|
194
|
+
os.path.join(user_home, "Downloads"),
|
|
195
|
+
os.path.expandvars(r"%ProgramFiles%\Katalon Studio"),
|
|
196
|
+
]
|
|
197
|
+
for c in katalon_candidates:
|
|
198
|
+
if os.path.exists(c):
|
|
199
|
+
for item in os.listdir(c):
|
|
200
|
+
if "katalon" in item.lower() and os.path.isdir(os.path.join(c, item)):
|
|
201
|
+
self.log_check("Katalon Studio IDE", "PASS", f"Installation directory located at {os.path.join(c, item)}")
|
|
202
|
+
return
|
|
203
|
+
|
|
204
|
+
if is_katalon_project:
|
|
205
|
+
self.log_check("Katalon Studio IDE", "WARN", "Katalon Studio installation not found in standard paths",
|
|
206
|
+
"Download and install Katalon Studio from https://katalon.com/download")
|
|
207
|
+
else:
|
|
208
|
+
self.log_check("Katalon Studio IDE", "PASS", "Not installed (Optional - not required for Playwright/Cypress/Pytest)")
|
|
209
|
+
|
|
210
|
+
def check_node_allure(self):
|
|
211
|
+
"""Verifies presence of Node.js runtime for test runners and Allure reports."""
|
|
212
|
+
found_node, node_ver = self.run_command("node -v")
|
|
213
|
+
if found_node:
|
|
214
|
+
self.log_check("Node.js Runtime", "PASS", f"Node.js {node_ver}")
|
|
215
|
+
else:
|
|
216
|
+
self.log_check("Allure Reporting Engine", "WARN", "Node.js not installed (required to serve Allure reports)",
|
|
217
|
+
"Install Node.js from https://nodejs.org/ to execute 'python tools/generate_allure_report.py serve'")
|
|
218
|
+
|
|
219
|
+
def check_python_runner(self):
|
|
220
|
+
"""Verifies active Python environment and optional virtual environment presence."""
|
|
221
|
+
py_ver = sys.version.split()[0]
|
|
222
|
+
venv_path = self.target_dir / ".venv"
|
|
223
|
+
|
|
224
|
+
if venv_path.exists():
|
|
225
|
+
self.log_check("Python Virtual Environment", "PASS", f"Python {py_ver} (Active .venv detected)")
|
|
226
|
+
else:
|
|
227
|
+
self.log_check("Python Virtual Environment", "PASS", f"Python {py_ver} (Optional: create .venv if using auxiliary runners)")
|
|
228
|
+
|
|
229
|
+
def check_openpyxl(self):
|
|
230
|
+
"""Checks if openpyxl is available for template-driven Excel export."""
|
|
231
|
+
try:
|
|
232
|
+
import openpyxl
|
|
233
|
+
ver = getattr(openpyxl, "__version__", "installed")
|
|
234
|
+
self.log_check("Excel Engine (openpyxl)", "PASS", f"openpyxl {ver} available")
|
|
235
|
+
except Exception:
|
|
236
|
+
self.log_check("Excel Engine (openpyxl)", "WARN", "openpyxl is not installed",
|
|
237
|
+
"Run: pip install openpyxl (needed for Excel export: agent-qa export-excel)")
|
|
238
|
+
|
|
239
|
+
def check_project_structure(self):
|
|
240
|
+
"""Audits folder layout and configuration integrity for Hub or Spoke projects."""
|
|
241
|
+
# 1. QA Hub Repository Check
|
|
242
|
+
is_hub = (self.target_dir / "skills_manifest.json").exists() or (self.target_dir / ".agents" / "skills").is_dir()
|
|
243
|
+
if is_hub:
|
|
244
|
+
required_dirs = [".agents/skills", ".agents/rules", "tools", "tests"]
|
|
245
|
+
missing = [rd for rd in required_dirs if not (self.target_dir / rd).exists()]
|
|
246
|
+
if not missing:
|
|
247
|
+
skills_dir = self.target_dir / ".agents" / "skills"
|
|
248
|
+
skill_count = len([d for d in skills_dir.iterdir() if d.is_dir() and not d.name.startswith(".")]) if skills_dir.exists() else 0
|
|
249
|
+
self.log_check("Project Structure (QA Hub)", "PASS", f"QA Hub integrity verified ({skill_count} Skills, Rules, Tools, Unit Tests)")
|
|
250
|
+
else:
|
|
251
|
+
self.log_check("Project Structure (QA Hub)", "FAIL", f"Missing directories: {', '.join(missing)}",
|
|
252
|
+
"Restore from official Synapse Hub Git repository.")
|
|
253
|
+
return
|
|
254
|
+
|
|
255
|
+
# 2. Standalone Host / User Home Detection
|
|
256
|
+
is_user_home = False
|
|
257
|
+
try:
|
|
258
|
+
is_user_home = self.target_dir.resolve() == Path.home().resolve()
|
|
259
|
+
except OSError:
|
|
260
|
+
is_user_home = False
|
|
261
|
+
|
|
262
|
+
has_project_marker = any([
|
|
263
|
+
(self.target_dir / marker).exists() for marker in [
|
|
264
|
+
".git", "package.json", "requirements.txt", "pom.xml", "build.gradle",
|
|
265
|
+
"pytest.ini", "cypress.config.ts", "cypress.config.js",
|
|
266
|
+
"playwright.config.ts", "playwright.config.js", "Keywords", "Scripts"
|
|
267
|
+
]
|
|
268
|
+
]) or bool(list(self.target_dir.glob("*.prj")))
|
|
269
|
+
|
|
270
|
+
if is_user_home or not has_project_marker:
|
|
271
|
+
self.is_standalone = True
|
|
272
|
+
self.log_check("Project Structure (Standalone)", "PASS",
|
|
273
|
+
"Host machine environment verified. (To diagnose a specific test project: agent-qa doctor <path>)")
|
|
274
|
+
return
|
|
275
|
+
|
|
276
|
+
# 3. Playwright Check
|
|
277
|
+
pkg_json = self.target_dir / "package.json"
|
|
278
|
+
has_playwright_pkg = pkg_json.exists() and "@playwright/test" in pkg_json.read_text(encoding="utf-8", errors="ignore")
|
|
279
|
+
is_playwright = (self.target_dir / "playwright.config.ts").exists() or (self.target_dir / "playwright.config.js").exists() or has_playwright_pkg
|
|
280
|
+
if is_playwright:
|
|
281
|
+
has_tests = (self.target_dir / "tests").is_dir() or (self.target_dir / "e2e").is_dir() or (self.target_dir / "src").is_dir()
|
|
282
|
+
if has_tests:
|
|
283
|
+
self.log_check("Project Structure (Playwright)", "PASS", "Playwright test project structure verified")
|
|
284
|
+
else:
|
|
285
|
+
self.log_check("Project Structure (Playwright)", "WARN", "Missing 'tests/' or 'e2e/' directory for Playwright specs",
|
|
286
|
+
"Create a 'tests/' directory or run 'npx playwright test --init'")
|
|
287
|
+
return
|
|
288
|
+
|
|
289
|
+
# 4. Cypress Check
|
|
290
|
+
is_cypress = (self.target_dir / "cypress.config.ts").exists() or (self.target_dir / "cypress.config.js").exists() or (self.target_dir / "cypress").is_dir()
|
|
291
|
+
if is_cypress:
|
|
292
|
+
if (self.target_dir / "cypress").is_dir():
|
|
293
|
+
self.log_check("Project Structure (Cypress)", "PASS", "Cypress test project structure verified")
|
|
294
|
+
else:
|
|
295
|
+
self.log_check("Project Structure (Cypress)", "WARN", "Missing 'cypress/' directory",
|
|
296
|
+
"Create a 'cypress/' directory for E2E specs")
|
|
297
|
+
return
|
|
298
|
+
|
|
299
|
+
# 5. Pytest / Python Selenium Check
|
|
300
|
+
is_pytest = (self.target_dir / "pytest.ini").exists() or (self.target_dir / "conftest.py").exists()
|
|
301
|
+
has_py_tests = (self.target_dir / "tests").is_dir() or bool(list(self.target_dir.glob("test_*.py")))
|
|
302
|
+
if is_pytest or (has_py_tests and (self.target_dir / "requirements.txt").exists()):
|
|
303
|
+
self.log_check("Project Structure (Pytest)", "PASS", "Python/Pytest test project structure verified")
|
|
304
|
+
return
|
|
305
|
+
|
|
306
|
+
# 6. Katalon Studio (Enterprise Web Clean POM)
|
|
307
|
+
is_katalon = bool(list(self.target_dir.glob("*.prj"))) or (self.target_dir / "Keywords").is_dir() or (self.target_dir / "Scripts").is_dir()
|
|
308
|
+
if is_katalon:
|
|
309
|
+
required_dirs = ["Scripts", "Keywords", "Profiles"]
|
|
310
|
+
missing = [rd for rd in required_dirs if not (self.target_dir / rd).exists()]
|
|
311
|
+
if not missing:
|
|
312
|
+
self.log_check("Project Structure (Clean POM)", "PASS", "Clean POM structure verified (Keywords, Profiles, Scripts)")
|
|
313
|
+
else:
|
|
314
|
+
self.log_check("Project Structure (POM)", "WARN" if len(missing) < len(required_dirs) else "FAIL",
|
|
315
|
+
f"Missing directories: {', '.join(missing)}",
|
|
316
|
+
"Verify git clone command or select target test project directory.")
|
|
317
|
+
return
|
|
318
|
+
|
|
319
|
+
# 7. Generic Test Project (any project with tests/ or test/)
|
|
320
|
+
if (self.target_dir / "tests").is_dir() or (self.target_dir / "test").is_dir() or (self.target_dir / "e2e").is_dir():
|
|
321
|
+
self.log_check("Project Structure (Automated Tests)", "PASS", "Standard automated test directory detected")
|
|
322
|
+
return
|
|
323
|
+
|
|
324
|
+
# Fallback: General project structure missing test suite
|
|
325
|
+
self.log_check("Project Structure", "WARN", "No automated test directories detected (tests/, Scripts/, cypress/)",
|
|
326
|
+
"Run 'agent-qa setup .' to initialize Clean POM / Playwright configuration for this project.")
|
|
327
|
+
|
|
328
|
+
def check_network(self):
|
|
329
|
+
"""Audits AUT network reachability via BASE_URL configured in environment."""
|
|
330
|
+
env_file = self.target_dir / ".env"
|
|
331
|
+
if env_file.exists():
|
|
332
|
+
try:
|
|
333
|
+
for line in env_file.read_text(encoding="utf-8").splitlines():
|
|
334
|
+
if "=" in line and not line.strip().startswith("#"):
|
|
335
|
+
k, v = line.strip().split("=", 1)
|
|
336
|
+
if k.strip() not in os.environ:
|
|
337
|
+
os.environ[k.strip()] = v.strip().strip("'\"")
|
|
338
|
+
except OSError as err:
|
|
339
|
+
sys.stderr.write(f"Notice: .env read failed: {err}\n")
|
|
340
|
+
|
|
341
|
+
if os.environ.get("AGENT_QA_OFFLINE") == "1":
|
|
342
|
+
self.log_check("Network / Server Base URL", "PASS", "Skipped in offline/air-gapped mode (AGENT_QA_OFFLINE=1)")
|
|
343
|
+
return
|
|
344
|
+
|
|
345
|
+
base = os.environ.get("BASE_URL", "").rstrip("/")
|
|
346
|
+
if not base:
|
|
347
|
+
if getattr(self, "is_standalone", False):
|
|
348
|
+
self.log_check("Network / Server Base URL", "PASS", "Host standalone check (configure BASE_URL in project .env when targeting an AUT)")
|
|
349
|
+
return
|
|
350
|
+
self.log_check("Network / Server Base URL", "WARN", "BASE_URL not configured in .env",
|
|
351
|
+
"Copy .env.example to .env and configure BASE_URL to verify connectivity.")
|
|
352
|
+
return
|
|
353
|
+
test_url = f"{base}/login"
|
|
354
|
+
try:
|
|
355
|
+
# Respect explicit insecure flag or environment variable; default to secure TLS
|
|
356
|
+
allow_insecure = bool(
|
|
357
|
+
getattr(self, "insecure", False)
|
|
358
|
+
or os.environ.get("SYNAPSE_INSECURE_SSL") == "1"
|
|
359
|
+
)
|
|
360
|
+
ctx = ssl.create_default_context()
|
|
361
|
+
if allow_insecure:
|
|
362
|
+
print(" ⚠️ [SECURITY NOTICE] TLS certificate verification is bypassed (--insecure / SYNAPSE_INSECURE_SSL).")
|
|
363
|
+
ctx.check_hostname = False
|
|
364
|
+
ctx.verify_mode = ssl.CERT_NONE
|
|
365
|
+
|
|
366
|
+
req = urllib.request.Request(test_url, headers={'User-Agent': 'Mozilla/5.0'})
|
|
367
|
+
with urllib.request.urlopen(req, timeout=8, context=ctx) as resp: # nosec B310
|
|
368
|
+
code = resp.getcode()
|
|
369
|
+
if code in (200, 301, 302):
|
|
370
|
+
self.log_check("Network / Server Base URL", "PASS", f"Connection successful to {test_url} (HTTP {code})")
|
|
371
|
+
else:
|
|
372
|
+
self.log_check("Network / Server Base URL", "WARN", f"HTTP response code {code}", "Check proxy configuration or corporate network access.")
|
|
373
|
+
except Exception as e:
|
|
374
|
+
self.log_check("Network / Server Base URL", "WARN", f"Direct connection failed ({e})",
|
|
375
|
+
"Check internet connection or enable VPN if corporate network required.")
|
|
376
|
+
|
|
377
|
+
def run_all(self):
|
|
378
|
+
"""Runs the complete diagnostic suite and returns 0 if all prerequisites pass."""
|
|
379
|
+
print(f"\n{BOLD}{'='*70}{RESET}")
|
|
380
|
+
print(f"{BOLD}{CYAN} ENTERPRISE AUTOMATION - ENVIRONMENT & ONBOARDING DIAGNOSTIC{RESET}")
|
|
381
|
+
print(f"{BOLD}{'='*70}{RESET}")
|
|
382
|
+
print(f"📁 Target Directory: {self.target_dir}\n")
|
|
383
|
+
|
|
384
|
+
self.check_os()
|
|
385
|
+
self.check_git()
|
|
386
|
+
self.check_chrome()
|
|
387
|
+
self.check_java()
|
|
388
|
+
self.check_katalon()
|
|
389
|
+
self.check_node_allure()
|
|
390
|
+
self.check_python_runner()
|
|
391
|
+
self.check_openpyxl()
|
|
392
|
+
self.check_project_structure()
|
|
393
|
+
self.check_network()
|
|
394
|
+
|
|
395
|
+
print(f"\n{BOLD}{'='*70}{RESET}")
|
|
396
|
+
if not self.errors:
|
|
397
|
+
print(f"{BOLD}{GREEN}🎉 SUMMARY: ENVIRONMENT IS READY!{RESET}")
|
|
398
|
+
if self.warnings:
|
|
399
|
+
print(f"{YELLOW}Note: {len(self.warnings)} optional warning(s) detected above; address as needed.{RESET}")
|
|
400
|
+
else:
|
|
401
|
+
print(f"{BOLD}{RED}❌ SUMMARY: {len(self.errors)} PREREQUISITE(S) REQUIRE REMEDIATION!{RESET}")
|
|
402
|
+
for name, hint in self.errors:
|
|
403
|
+
print(f" - {BOLD}{name}:{RESET} {hint}")
|
|
404
|
+
print(f"{BOLD}{'='*70}{RESET}\n")
|
|
405
|
+
return 0 if not self.errors else 1
|
|
406
|
+
|
|
407
|
+
|
|
408
|
+
def main():
|
|
409
|
+
parser = argparse.ArgumentParser(description="Enterprise Environment Diagnostic Tool")
|
|
410
|
+
parser.add_argument("target", nargs="?", default=None, help="Target repository path to diagnose")
|
|
411
|
+
parser.add_argument("--repo", "--path", dest="repo_path", default=None, help="Target repository path")
|
|
412
|
+
parser.add_argument("--insecure", action="store_true", help="Allow unverified SSL certificates during connectivity checks")
|
|
413
|
+
args = parser.parse_args()
|
|
414
|
+
|
|
415
|
+
try:
|
|
416
|
+
target_dir = resolve_target_repo(cli_target=args.target, cli_repo=args.repo_path)
|
|
417
|
+
except FileNotFoundError as e:
|
|
418
|
+
print(f"❌ Error: {e}")
|
|
419
|
+
return 1
|
|
420
|
+
|
|
421
|
+
runner = DiagnosticRunner(target_dir=target_dir, insecure=args.insecure)
|
|
422
|
+
return runner.run_all()
|
|
423
|
+
|
|
424
|
+
|
|
425
|
+
if __name__ == "__main__":
|
|
426
|
+
sys.exit(main())
|