@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,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())