@teevee98/synapse-hub 0.0.0-stage → 3.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +172 -0
  190. package/README.md +171 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +197 -0
  196. package/docs/ARCHITECTURE.md +198 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +175 -0
  200. package/docs/CLI_REFERENCE.md +177 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +121 -0
  206. package/docs/QUALITY_GATES.md +121 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1359 -0
  212. package/docs/schemas/synapse.config.schema.json +87 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +32 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2079 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +258 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +184 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2419 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +307 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +724 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1259 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,252 @@
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/generate_sbom.py — Enterprise Software Bill of Materials (SBOM) Generator
8
+ --------------------------------------------------------------------------------
9
+ Generates standard SPDX 2.3 JSON compliant Software Bill of Materials for Synapse Hub.
10
+ Covers:
11
+ - Primary Hub package metadata & MIT license provenance
12
+ - Python dependencies (requirements-dev.txt, pyproject.toml)
13
+ - NPM dependencies (package.json)
14
+ - Cryptographic SHA-256 checksums and supplier attribution
15
+
16
+ Usage:
17
+ python tools/generate_sbom.py
18
+ python tools/generate_sbom.py --output reports/synapse_hub_sbom.spdx.json
19
+ """
20
+
21
+ import os
22
+ import sys
23
+ import json
24
+ import uuid
25
+ import hashlib
26
+ import argparse
27
+ from datetime import datetime, timezone
28
+ from typing import Dict, List, Any, Optional
29
+
30
+ # Enforce UTF-8 console output
31
+ if hasattr(sys.stdout, "reconfigure"):
32
+ try:
33
+ sys.stdout.reconfigure(encoding="utf-8")
34
+ sys.stderr.reconfigure(encoding="utf-8")
35
+ except Exception:
36
+ pass
37
+
38
+ REPO_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
39
+
40
+
41
+ def get_version(repo_root: str) -> str:
42
+ pkg_path = os.path.join(repo_root, "package.json")
43
+ if os.path.exists(pkg_path):
44
+ try:
45
+ with open(pkg_path, "r", encoding="utf-8") as f:
46
+ data = json.load(f)
47
+ return data.get("version", "1.0.0").strip()
48
+ except (OSError, json.JSONDecodeError, KeyError) as err:
49
+ sys.stderr.write(f"Warning: Failed to parse package.json: {err}\n")
50
+ return "1.0.0"
51
+
52
+
53
+ def calculate_sha256(file_path: str) -> Optional[str]:
54
+ if not os.path.isfile(file_path):
55
+ return None
56
+ hasher = hashlib.sha256()
57
+ with open(file_path, "rb") as f:
58
+ while chunk := f.read(65536):
59
+ hasher.update(chunk)
60
+ return hasher.hexdigest()
61
+
62
+
63
+ def parse_requirements_txt(file_path: str) -> List[Dict[str, str]]:
64
+ packages = []
65
+ if not os.path.exists(file_path):
66
+ return packages
67
+
68
+ with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
69
+ for line in f:
70
+ line = line.strip()
71
+ if not line or line.startswith(("#", "-", "@")):
72
+ continue
73
+ # Parse package==version or package>=version
74
+ parts = line.split("==") if "==" in line else line.split(">=")
75
+ pkg_name = parts[0].strip()
76
+ pkg_ver = parts[1].split(";")[0].strip() if len(parts) > 1 else "NOASSERTION"
77
+ packages.append({
78
+ "name": pkg_name,
79
+ "version": pkg_ver,
80
+ "type": "pypi"
81
+ })
82
+ return packages
83
+
84
+
85
+ def parse_package_json(file_path: str) -> List[Dict[str, str]]:
86
+ packages = []
87
+ if not os.path.exists(file_path):
88
+ return packages
89
+
90
+ try:
91
+ with open(file_path, "r", encoding="utf-8") as f:
92
+ data = json.load(f)
93
+ deps = data.get("dependencies", {})
94
+ dev_deps = data.get("devDependencies", {})
95
+ all_deps = {**deps, **dev_deps}
96
+ for name, ver in all_deps.items():
97
+ clean_ver = ver.lstrip("^~>=< ")
98
+ packages.append({
99
+ "name": name,
100
+ "version": clean_ver,
101
+ "type": "npm"
102
+ })
103
+ except (OSError, json.JSONDecodeError, KeyError) as err:
104
+ sys.stderr.write(f"Warning: Failed to parse package.json for deps: {err}\n")
105
+ return packages
106
+
107
+
108
+ def build_spdx_sbom(repo_root: str = REPO_ROOT) -> Dict[str, Any]:
109
+ """Generates standard SPDX 2.3 JSON document."""
110
+ version = get_version(repo_root)
111
+ doc_id = f"SPDXRef-DOCUMENT-{uuid.uuid4().hex[:8]}"
112
+ created_time = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
113
+
114
+ root_sha = calculate_sha256(os.path.join(repo_root, "package.json")) or ""
115
+
116
+ packages = []
117
+ relationships = []
118
+
119
+ # 1. Primary Root Package (Synapse-Hub)
120
+ root_pkg_id = "SPDXRef-Package-synapse-hub"
121
+ root_pkg = {
122
+ "SPDXID": root_pkg_id,
123
+ "name": "synapse-hub",
124
+ "versionInfo": version,
125
+ "downloadLocation": "https://github.com/TeeVee998/Synapse-Hub",
126
+ "filesAnalyzed": False,
127
+ "homepage": "https://github.com/TeeVee998/Synapse-Hub",
128
+ "originator": "Person: Thế Vị (@TeeVee998)",
129
+ "supplier": "Person: Thế Vị (@TeeVee998)",
130
+ "licenseConcluded": "MIT",
131
+ "licenseDeclared": "MIT",
132
+ "copyrightText": "Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.",
133
+ "description": "Enterprise QA & Automation Multi-Agent Hub enforcing Clean POM Flat Architecture.",
134
+ "checksums": [
135
+ {
136
+ "algorithm": "SHA256",
137
+ "checksumValue": root_sha
138
+ }
139
+ ]
140
+ }
141
+ packages.append(root_pkg)
142
+ relationships.append({
143
+ "spdxElementId": "SPDXRef-DOCUMENT",
144
+ "relationshipType": "DESCRIBES",
145
+ "relatedSpdxElement": root_pkg_id
146
+ })
147
+
148
+ # 2. Python Dependencies
149
+ req_file = os.path.join(repo_root, "requirements-dev.txt")
150
+ py_pkgs = parse_requirements_txt(req_file)
151
+ for p in py_pkgs:
152
+ clean_name = p["name"].replace("_", "-").lower()
153
+ pkg_id = f"SPDXRef-Package-pypi-{clean_name}"
154
+ packages.append({
155
+ "SPDXID": pkg_id,
156
+ "name": p["name"],
157
+ "versionInfo": p["version"],
158
+ "downloadLocation": f"https://pypi.org/project/{p['name']}/",
159
+ "filesAnalyzed": False,
160
+ "supplier": "Organization: PyPI Community",
161
+ "licenseConcluded": "NOASSERTION",
162
+ "externalRefs": [
163
+ {
164
+ "referenceCategory": "PACKAGE_MANAGER",
165
+ "referenceType": "purl",
166
+ "referenceLocator": f"pkg:pypi/{p['name']}@{p['version']}"
167
+ }
168
+ ]
169
+ })
170
+ relationships.append({
171
+ "spdxElementId": root_pkg_id,
172
+ "relationshipType": "DEPENDS_ON",
173
+ "relatedSpdxElement": pkg_id
174
+ })
175
+
176
+ # 3. NPM Dependencies
177
+ pkg_json_file = os.path.join(repo_root, "package.json")
178
+ npm_pkgs = parse_package_json(pkg_json_file)
179
+ for p in npm_pkgs:
180
+ clean_name = p["name"].replace("@", "").replace("/", "-")
181
+ pkg_id = f"SPDXRef-Package-npm-{clean_name}"
182
+ packages.append({
183
+ "SPDXID": pkg_id,
184
+ "name": p["name"],
185
+ "versionInfo": p["version"],
186
+ "downloadLocation": f"https://registry.npmjs.org/{p['name']}",
187
+ "filesAnalyzed": False,
188
+ "supplier": "Organization: NPM Community",
189
+ "licenseConcluded": "NOASSERTION",
190
+ "externalRefs": [
191
+ {
192
+ "referenceCategory": "PACKAGE_MANAGER",
193
+ "referenceType": "purl",
194
+ "referenceLocator": f"pkg:npm/{p['name']}@{p['version']}"
195
+ }
196
+ ]
197
+ })
198
+ relationships.append({
199
+ "spdxElementId": root_pkg_id,
200
+ "relationshipType": "DEPENDS_ON",
201
+ "relatedSpdxElement": pkg_id
202
+ })
203
+
204
+ sbom = {
205
+ "spdxVersion": "SPDX-2.3",
206
+ "dataLicense": "CC0-1.0",
207
+ "SPDXID": "SPDXRef-DOCUMENT",
208
+ "name": f"Synapse-Hub-SBOM-v{version}",
209
+ "documentNamespace": f"https://github.com/TeeVee998/Synapse-Hub/spdx/{version}-{uuid.uuid4().hex[:12]}",
210
+ "creationInfo": {
211
+ "created": created_time,
212
+ "creators": [
213
+ "Tool: synapse-sbom-generator-1.0.0",
214
+ "Person: Thế Vị (@TeeVee998)"
215
+ ]
216
+ },
217
+ "packages": packages,
218
+ "relationships": relationships
219
+ }
220
+
221
+ return sbom
222
+
223
+
224
+ def main() -> int:
225
+ parser = argparse.ArgumentParser(description="SPDX 2.3 JSON SBOM Generator for Synapse Hub")
226
+ parser.add_argument("--repo-root", default=REPO_ROOT, help="Target repository root")
227
+ parser.add_argument("--output", default="reports/synapse_hub_sbom.spdx.json", help="Path to write generated SBOM")
228
+ args = parser.parse_args()
229
+
230
+ sbom = build_spdx_sbom(args.repo_root)
231
+
232
+ out_path = os.path.join(args.repo_root, args.output) if not os.path.isabs(args.output) else args.output
233
+ os.makedirs(os.path.dirname(os.path.abspath(out_path)), exist_ok=True)
234
+
235
+ with open(out_path, "w", encoding="utf-8") as f:
236
+ json.dump(sbom, f, indent=2, ensure_ascii=False)
237
+
238
+ print("=" * 68)
239
+ print(" SYNAPSE HUB — ENTERPRISE SOFTWARE BILL OF MATERIALS (SBOM) ")
240
+ print("=" * 68)
241
+ print(" SPDX Standard : SPDX-2.3 (JSON)")
242
+ print(f" Package Name : {sbom['name']}")
243
+ print(f" Total Packages : {len(sbom['packages'])} packages cataloged")
244
+ print(f" Relationships : {len(sbom['relationships'])} dependencies mapped")
245
+ print(f" Output Artifact : {out_path}")
246
+ print("=" * 68)
247
+ print("✅ SPDX 2.3 SBOM generated successfully.")
248
+ return 0
249
+
250
+
251
+ if __name__ == "__main__":
252
+ sys.exit(main())
@@ -0,0 +1,203 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ tools/generate_tc_from_story.py — Large Action Model (LAM) Script Generator
5
+ Inspired by LaVague: Converts natural language user stories into Clean POM test scripts.
6
+ Supports configurable packages, dynamic Page Class discovery, and cross-platform execution.
7
+ """
8
+
9
+ import sys
10
+ import os
11
+ import re
12
+ import glob
13
+ import argparse
14
+
15
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
16
+ if hasattr(sys.stdout, 'reconfigure'):
17
+ try:
18
+ sys.stdout.reconfigure(encoding='utf-8')
19
+ sys.stderr.reconfigure(encoding='utf-8')
20
+ except Exception:
21
+ pass
22
+
23
+ DEFAULT_PAGE_MAP = {
24
+ "login": "LoginPage",
25
+ "auth": "LoginPage",
26
+ "user": "UserAdminPage",
27
+ "common": "CommonCategoryPage",
28
+ "category": "CategoryPage",
29
+ "planning": "PlanningPage",
30
+ "report": "ReportPage",
31
+ "search": "SearchPage",
32
+ }
33
+
34
+
35
+ def detect_project_package(repo_root="."):
36
+ """Detects the standard package prefix from existing project structure or guide."""
37
+ # 1. Check PROJECT_AI_GUIDE.md for explicit package hints
38
+ guide_path = os.path.join(repo_root, "PROJECT_AI_GUIDE.md")
39
+ if os.path.isfile(guide_path):
40
+ try:
41
+ with open(guide_path, "r", encoding="utf-8", errors="ignore") as f:
42
+ content = f.read()
43
+ m = re.search(r'import\s+([\w\.]+)\.pages\.', content)
44
+ if m:
45
+ return f"{m.group(1)}.pages"
46
+ except (OSError, UnicodeDecodeError):
47
+ content = ""
48
+
49
+ # 2. Check existing Keywords/ directory
50
+ keywords_dir = os.path.join(repo_root, "Keywords")
51
+ if os.path.isdir(keywords_dir):
52
+ for root, _, files in os.walk(keywords_dir):
53
+ for file in files:
54
+ if file.endswith(".groovy"):
55
+ rel = os.path.relpath(root, keywords_dir)
56
+ parts = [p for p in rel.replace("\\", "/").split("/") if p and p != "."]
57
+ if parts:
58
+ return ".".join(parts)
59
+
60
+ return "pages"
61
+
62
+
63
+ def discover_page_classes(repo_root="."):
64
+ """Discovers available Page classes dynamically from workspace files."""
65
+ pages = dict(DEFAULT_PAGE_MAP)
66
+ search_dirs = [
67
+ os.path.join(repo_root, "Keywords"),
68
+ os.path.join(repo_root, "pages"),
69
+ os.path.join(repo_root, "src", "pages"),
70
+ os.path.join(repo_root, "tests", "pages")
71
+ ]
72
+ for d in search_dirs:
73
+ if os.path.isdir(d):
74
+ for f in glob.glob(os.path.join(d, "**", "*Page*.*"), recursive=True):
75
+ base = os.path.basename(f)
76
+ name, _ = os.path.splitext(base)
77
+ clean_key = name.lower().replace("page", "").replace("_", "")
78
+ if clean_key:
79
+ pages[clean_key] = name
80
+ return pages
81
+
82
+
83
+ def generate_script(story, module_name="CategoryPage", tc_name="TC_AutoGenerated", package_name=None, repo_root="."):
84
+ if isinstance(package_name, dict):
85
+ mock_pages = package_name
86
+ package_name = repo_root if isinstance(repo_root, str) and repo_root != "." else None
87
+ else:
88
+ mock_pages = None
89
+
90
+ detected_package = package_name or detect_project_package(repo_root if isinstance(repo_root, str) else ".")
91
+ discovered_pages = discover_page_classes(repo_root if isinstance(repo_root, str) else ".")
92
+ if mock_pages:
93
+ discovered_pages.update(mock_pages)
94
+
95
+ # Normalize module name
96
+ mod_clean = module_name.lower().replace("page", "").replace("_", "").replace(" ", "")
97
+ target_page = discovered_pages.get(mod_clean, f"{module_name[:1].upper()}{module_name[1:]}")
98
+ if not target_page.endswith("Page"):
99
+ target_page += "Page"
100
+
101
+ # Detect action intent from story keywords
102
+ combined_text = f"{story} {module_name} {tc_name}".lower()
103
+ is_login = target_page.lower().startswith("login") or any(k in combined_text for k in ["đăng nhập", "dang nhap", "login", "sign in", "signin", "authenticate", "xác thực"])
104
+ is_delete = not is_login and any(k in combined_text for k in ["xóa", "xoa", "delete", "remove"])
105
+ is_edit = not is_login and any(k in combined_text for k in ["sửa", "sua", "chỉnh sửa", "chinh sua", "edit", "update"])
106
+ is_search = not is_login and any(k in combined_text for k in ["tìm", "tim", "tìm kiếm", "tim kiem", "search", "filter"])
107
+ is_add = not is_login and (not (is_delete or is_edit or is_search) or any(k in combined_text for k in ["thêm", "them", "tạo mới", "tao moi", "add", "create"]))
108
+
109
+ lines = []
110
+ lines.append("// ===========================================================================")
111
+ lines.append(f"// Test Case: {tc_name}")
112
+ lines.append(f"// Requirement: {story}")
113
+ lines.append("// Architecture: Clean POM & Flat Architecture (Generated by LaVague LAM Engine)")
114
+ lines.append("// ===========================================================================")
115
+ lines.append("")
116
+ if is_login or target_page == "LoginPage":
117
+ lines.append(f"import {detected_package}.LoginPage")
118
+ else:
119
+ lines.append(f"import {detected_package}.LoginPage")
120
+ lines.append(f"import {detected_package}.{target_page}")
121
+ lines.append("")
122
+
123
+ if is_login:
124
+ lines.append("// 1. Execute authentication workflow")
125
+ lines.append("LoginPage.navigate()")
126
+ lines.append('LoginPage.enterCredentials("qa_automation_user", "SecurePass123!")')
127
+ lines.append("LoginPage.submitLogin()")
128
+ lines.append("LoginPage.verifyLoginSuccess()")
129
+ else:
130
+ lines.append("// 1. Ensure system authentication session")
131
+ lines.append("LoginPage.ensureLoggedIn()")
132
+ lines.append("")
133
+ lines.append("// 2. Initialize dynamic idempotent test data")
134
+ lines.append('String uniqueCode = "AUTO_" + System.currentTimeMillis()')
135
+ lines.append('String testName = "Test Entity " + uniqueCode')
136
+ lines.append("")
137
+
138
+ if is_add:
139
+ lines.append("// 3. Execute entity creation workflow")
140
+ lines.append(f"{target_page}.openCreateModal()")
141
+ lines.append(f"{target_page}.fillCreateForm(uniqueCode, testName)")
142
+ lines.append(f"{target_page}.confirmCreate()")
143
+ lines.append(f"{target_page}.verifyCreateSuccess(uniqueCode)")
144
+
145
+ elif is_edit:
146
+ lines.append("// 3. Execute entity update workflow")
147
+ lines.append('String updatedName = testName + " [Updated]"')
148
+ lines.append(f"{target_page}.searchKeyword(uniqueCode)")
149
+ lines.append(f"{target_page}.openEditFirstRow()")
150
+ lines.append(f"{target_page}.updateName(updatedName)")
151
+ lines.append(f"{target_page}.confirmEdit()")
152
+ lines.append(f"{target_page}.verifyEditSuccess(updatedName)")
153
+
154
+ elif is_delete:
155
+ lines.append("// 3. Execute entity deletion workflow")
156
+ lines.append(f"{target_page}.searchKeyword(uniqueCode)")
157
+ lines.append(f"{target_page}.clickDeleteFirstRow()")
158
+ lines.append(f"{target_page}.confirmDelete()")
159
+ lines.append(f"{target_page}.verifyDeleted(uniqueCode)")
160
+
161
+ elif is_search:
162
+ lines.append("// 3. Execute entity search/filter workflow")
163
+ lines.append(f"{target_page}.searchKeyword(uniqueCode)")
164
+ lines.append(f"{target_page}.verifySearchResults(uniqueCode)")
165
+
166
+ if not is_login:
167
+ lines.append("")
168
+ lines.append("// 4. Automated idempotent teardown cleanup")
169
+ lines.append(f"// {target_page}.teardown(uniqueCode)")
170
+ lines.append("")
171
+
172
+ return "\n".join(lines)
173
+
174
+
175
+ def main():
176
+ parser = argparse.ArgumentParser(description="LaVague-style LAM Script Generator for Clean POM Automation")
177
+ parser.add_argument("--story", "-s", required=True, help="User story or Acceptance Criteria (natural language)")
178
+ parser.add_argument("--module", "-m", default="CategoryPage", help="Target Page Class or Module name")
179
+ parser.add_argument("--name", "-n", default="TC_AutoGenerated", help="Test Case name")
180
+ parser.add_argument("--package", "-p", default=None, help="Base package name for imports (e.g. 'com.company.pages')")
181
+ parser.add_argument("--out", "-o", default=None, help="Output file path (optional)")
182
+ args = parser.parse_args()
183
+
184
+ script_content = generate_script(
185
+ story=args.story,
186
+ module_name=args.module,
187
+ tc_name=args.name,
188
+ package_name=args.package
189
+ )
190
+
191
+ if args.out:
192
+ out_dir = os.path.dirname(args.out)
193
+ if out_dir:
194
+ os.makedirs(out_dir, exist_ok=True)
195
+ with open(args.out, "w", encoding="utf-8") as f:
196
+ f.write(script_content)
197
+ print(f"Generated Clean POM script successfully saved to: {args.out}")
198
+ else:
199
+ print(script_content)
200
+
201
+
202
+ if __name__ == "__main__":
203
+ main()
@@ -0,0 +1,133 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Enterprise Test Report Aggregator & summaryTemp Generator (Cross-Platform)
4
+ -------------------------------------------------------------------------
5
+ Parses JUnit XML and Allure test reports across target directories
6
+ and exports standardized summaryTemp.txt for CI/CD dashboards.
7
+ Replaces PowerShell-only script with a zero-dependency, cross-platform engine.
8
+ """
9
+
10
+ import os
11
+ import sys
12
+ import glob
13
+ import argparse
14
+ import xml.etree.ElementTree as ET
15
+
16
+ SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
17
+ PROJECT_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
18
+
19
+
20
+ def find_latest_junit_report(search_dirs):
21
+ """Finds the most recent JUnit XML file across the given search directories."""
22
+ candidates = []
23
+ for d in search_dirs:
24
+ if os.path.exists(d):
25
+ for pattern in ["**/*junit*.xml", "**/*test*.xml", "**/TEST-*.xml", "**/*.xml"]:
26
+ for p in glob.glob(os.path.join(d, pattern), recursive=True):
27
+ try:
28
+ mtime = os.path.getmtime(p)
29
+ candidates.append((mtime, p))
30
+ except OSError as err:
31
+ sys.stderr.write(f"Notice: getmtime skipped: {err}\n")
32
+ if not candidates:
33
+ return None
34
+ candidates.sort(key=lambda x: x[0], reverse=True)
35
+ return candidates[0][1]
36
+
37
+
38
+ def parse_junit_xml(xml_path):
39
+ """Parses a JUnit XML file and returns (passed, failures, errors, skipped)."""
40
+ try:
41
+ tree = ET.parse(xml_path)
42
+ root = tree.getroot()
43
+ except Exception as e:
44
+ print(f"[WARN] Failed to parse XML file {xml_path}: {e}")
45
+ return 0, 0, 0, 0
46
+
47
+ total_tests = 0
48
+ failures = 0
49
+ errors = 0
50
+ skipped = 0
51
+
52
+ if root.tag == "testsuites":
53
+ total_tests = int(root.attrib.get("tests", 0))
54
+ failures = int(root.attrib.get("failures", 0))
55
+ errors = int(root.attrib.get("errors", 0))
56
+ skipped = int(root.attrib.get("skipped", 0))
57
+ passed_attr = root.attrib.get("passed")
58
+ if passed_attr is not None:
59
+ return int(passed_attr), failures, errors, skipped
60
+ elif root.tag == "testsuite":
61
+ total_tests = int(root.attrib.get("tests", 0))
62
+ failures = int(root.attrib.get("failures", 0))
63
+ errors = int(root.attrib.get("errors", 0))
64
+ skipped = int(root.attrib.get("skipped", 0))
65
+ else:
66
+ # Count testcase elements
67
+ for tc in root.iter("testcase"):
68
+ total_tests += 1
69
+ if tc.find("failure") is not None:
70
+ failures += 1
71
+ elif tc.find("error") is not None:
72
+ errors += 1
73
+ elif tc.find("skipped") is not None:
74
+ skipped += 1
75
+
76
+ passed = max(0, total_tests - (failures + errors + skipped))
77
+ return passed, failures, errors, skipped
78
+
79
+
80
+ def generate_reports(target_dir=None, project_name="Enterprise-Automation"):
81
+ """Aggregates reports and outputs summaryTemp.txt."""
82
+ root_dir = target_dir or PROJECT_ROOT
83
+ reports_dir = os.path.join(root_dir, "Reports")
84
+ test_reports_dir = os.path.join(root_dir, "TestReports")
85
+
86
+ os.makedirs(test_reports_dir, exist_ok=True)
87
+ summary_file = os.path.join(test_reports_dir, "summaryTemp.txt")
88
+
89
+ # Check if summary already exists
90
+ for check_dir in [reports_dir, test_reports_dir]:
91
+ existing = os.path.join(check_dir, "summaryTemp.txt")
92
+ if os.path.exists(existing):
93
+ try:
94
+ with open(existing, "r", encoding="utf-8") as f:
95
+ content = f.read().strip()
96
+ if "Passed" in content:
97
+ print(f"[+] Found existing summary file: {existing}")
98
+ return 0
99
+ except OSError as err:
100
+ sys.stderr.write(f"Notice: Read summaryTemp skipped: {err}\n")
101
+
102
+ latest_xml = find_latest_junit_report([reports_dir, test_reports_dir, root_dir])
103
+ if latest_xml:
104
+ print(f"[+] Parsing latest JUnit XML report: {latest_xml}")
105
+ passed, failures, errors, skipped = parse_junit_xml(latest_xml)
106
+ else:
107
+ print("[!] No JUnit XML report found on disk. Initializing zero-baseline.")
108
+ passed, failures, errors, skipped = 0, 0, 0, 0
109
+
110
+ summary_text = (
111
+ f"Summary: {passed} Passed - {failures} Failures - {errors} Errors - {skipped} Skipped\n"
112
+ f"Project: {project_name}\n"
113
+ )
114
+
115
+ with open(summary_file, "w", encoding="utf-8") as f:
116
+ f.write(summary_text)
117
+
118
+ print(f"[+] Summary report saved to: {summary_file}")
119
+ print(f" {summary_text.strip()}")
120
+ return 0
121
+
122
+
123
+ def main():
124
+ parser = argparse.ArgumentParser(description="Aggregate test reports and generate summaryTemp.txt")
125
+ parser.add_argument("target", nargs="?", default=None, help="Target project root directory")
126
+ parser.add_argument("--project-name", default="Enterprise-Automation", help="Project label for summary")
127
+ args = parser.parse_args()
128
+
129
+ sys.exit(generate_reports(args.target, project_name=args.project_name))
130
+
131
+
132
+ if __name__ == "__main__":
133
+ main()