@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,325 @@
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/package_release.py — Enterprise Release Packaging & Integrity Sentinel
8
+ -----------------------------------------------------------------------------
9
+ Builds clean, deterministic distribution archives (ZIP & tar.gz) for Synapse Hub.
10
+ Guarantees that essential dot-directories (.github/workflows, .agents) are preserved
11
+ and explicitly included, preventing false-missing workflow findings during external audits.
12
+
13
+ Features:
14
+ 1. Mandatory inclusion of .github/workflows/ (including publish_npm.yml) and .agents/.
15
+ 2. Strict blacklist filtering of build artifacts, temp files, caches, and test dumps.
16
+ 3. Pre-flight and post-archive integrity verification (asserts key manifests exist).
17
+ 4. Cryptographic SHA-256 checksum generation for software supply-chain provenance.
18
+
19
+ Usage:
20
+ python tools/package_release.py
21
+ python tools/package_release.py --output-dir dist --format zip
22
+ python tools/package_release.py --verify-archive dist/synapse-hub-3.1.2.zip
23
+ """
24
+
25
+ import os
26
+ import sys
27
+ import json
28
+ import zipfile
29
+ import tarfile
30
+ import hashlib
31
+ import argparse
32
+ from typing import List, Tuple, Optional
33
+
34
+ # Enforce UTF-8 console encoding
35
+ if hasattr(sys.stdout, "reconfigure"):
36
+ try:
37
+ sys.stdout.reconfigure(encoding="utf-8")
38
+ sys.stderr.reconfigure(encoding="utf-8")
39
+ except Exception:
40
+ pass
41
+
42
+ REPO_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
43
+
44
+ # Directories that must ALWAYS be included even though they start with a dot
45
+ MANDATORY_DOT_DIRS = {
46
+ ".github",
47
+ ".agents",
48
+ }
49
+
50
+ # Directories and patterns that must NEVER be included in distribution archives
51
+ EXCLUDE_DIRS = {
52
+ ".git",
53
+ ".idea",
54
+ ".vscode",
55
+ ".agent_memory",
56
+ "__pycache__",
57
+ ".pytest_cache",
58
+ ".mypy_cache",
59
+ "node_modules",
60
+ "dist",
61
+ "build",
62
+ "teamwork",
63
+ "reports",
64
+ "Reports",
65
+ "Screenshots",
66
+ "screenshots",
67
+ "claude-ecosystem-repos",
68
+ "graphify-out",
69
+ }
70
+
71
+ EXCLUDE_EXTENSIONS = {
72
+ ".pyc",
73
+ ".pyo",
74
+ ".tmp",
75
+ ".log",
76
+ ".bak",
77
+ ".DS_Store",
78
+ }
79
+
80
+ # Critical files that MUST exist inside the created archive for integrity validation
81
+ MANDATORY_ARCHIVE_ENTRIES = [
82
+ "package.json",
83
+ "LICENSE",
84
+ "AGENTS.md",
85
+ "tools/verify_all.py",
86
+ "tools/hub_publisher.py",
87
+ "tools/security_scanner.py",
88
+ "tools/generate_sbom.py",
89
+ ".github/workflows/publish_npm.yml",
90
+ ".github/workflows/security_audit.yml",
91
+ ]
92
+
93
+
94
+ def get_version(repo_root: str) -> str:
95
+ """Reads version from package.json."""
96
+ pkg_path = os.path.join(repo_root, "package.json")
97
+ if os.path.exists(pkg_path):
98
+ try:
99
+ with open(pkg_path, "r", encoding="utf-8") as f:
100
+ data = json.load(f)
101
+ return data.get("version", "1.0.0").strip()
102
+ except (OSError, json.JSONDecodeError, KeyError) as err:
103
+ sys.stderr.write(f"Warning: Could not read version from package.json: {err}\n")
104
+ return "1.0.0"
105
+
106
+
107
+ def collect_package_files(repo_root: str) -> List[Tuple[str, str]]:
108
+ """
109
+ Collects all pristine source files to be packaged into the release archive.
110
+ Returns list of (absolute_path, relative_archive_path).
111
+ """
112
+ packaged_files: List[Tuple[str, str]] = []
113
+
114
+ for root, dirs, files in os.walk(repo_root):
115
+ rel_root = os.path.relpath(root, repo_root).replace("\\", "/")
116
+
117
+ # Top-level dot-directory filtering
118
+ if rel_root != ".":
119
+ top_level = rel_root.split("/")[0]
120
+ if top_level.startswith(".") and top_level not in MANDATORY_DOT_DIRS:
121
+ dirs[:] = []
122
+ continue
123
+
124
+ # Prune excluded directories
125
+ dirs[:] = [
126
+ d for d in dirs
127
+ if d not in EXCLUDE_DIRS
128
+ and not (d.startswith(".") and d not in MANDATORY_DOT_DIRS)
129
+ ]
130
+
131
+ for f in files:
132
+ ext = os.path.splitext(f)[1].lower()
133
+ if ext in EXCLUDE_EXTENSIONS:
134
+ continue
135
+ if f.endswith(".tmp") or f.endswith(".bak"):
136
+ continue
137
+
138
+ full_path = os.path.join(root, f)
139
+ rel_path = os.path.relpath(full_path, repo_root).replace("\\", "/")
140
+ packaged_files.append((full_path, rel_path))
141
+
142
+ return sorted(packaged_files, key=lambda x: x[1])
143
+
144
+
145
+ def calculate_sha256(file_path: str) -> str:
146
+ """Calculates SHA-256 digest of a local file."""
147
+ hasher = hashlib.sha256()
148
+ with open(file_path, "rb") as f:
149
+ while chunk := f.read(65536):
150
+ hasher.update(chunk)
151
+ return hasher.hexdigest()
152
+
153
+
154
+ def create_zip_archive(files: List[Tuple[str, str]], output_path: str) -> str:
155
+ """Creates a deterministic ZIP archive from collected files."""
156
+ os.makedirs(os.path.dirname(os.path.abspath(output_path)), exist_ok=True)
157
+ with zipfile.ZipFile(output_path, "w", compression=zipfile.ZIP_DEFLATED) as zf:
158
+ for abs_path, rel_path in files:
159
+ zf.write(abs_path, arcname=rel_path)
160
+ return output_path
161
+
162
+
163
+ def create_tar_archive(files: List[Tuple[str, str]], output_path: str) -> str:
164
+ """Creates a deterministic tar.gz archive from collected files."""
165
+ os.makedirs(os.path.dirname(os.path.abspath(output_path)), exist_ok=True)
166
+ with tarfile.open(output_path, "w:gz") as tf:
167
+ for abs_path, rel_path in files:
168
+ tf.add(abs_path, arcname=rel_path)
169
+ return output_path
170
+
171
+
172
+ def normalize_arcname(n: str) -> str:
173
+ """Normalizes archive entry path, safely stripping leading ./ without stripping leading dots from hidden dirs."""
174
+ clean = n.replace("\\", "/")
175
+ if clean.startswith("./"):
176
+ clean = clean[2:]
177
+ return clean
178
+
179
+
180
+ def verify_archive_integrity(archive_path: str) -> Tuple[bool, List[str]]:
181
+ """
182
+ Verifies that the archive contains all mandatory entries (.github/workflows/publish_npm.yml, etc.).
183
+ """
184
+ missing: List[str] = []
185
+ if not os.path.exists(archive_path):
186
+ return False, [f"Archive does not exist: {archive_path}"]
187
+
188
+ if archive_path.endswith(".zip"):
189
+ with zipfile.ZipFile(archive_path, "r") as zf:
190
+ namelist = set(zf.namelist())
191
+ elif archive_path.endswith((".tar.gz", ".tgz")):
192
+ with tarfile.open(archive_path, "r:gz") as tf:
193
+ namelist = set(tf.getnames())
194
+ else:
195
+ return False, [f"Unsupported archive format: {archive_path}"]
196
+
197
+ # Normalize archive paths safely
198
+ normalized_names = {normalize_arcname(n) for n in namelist}
199
+
200
+ for req in MANDATORY_ARCHIVE_ENTRIES:
201
+ if req not in normalized_names:
202
+ missing.append(req)
203
+
204
+ return (len(missing) == 0), missing
205
+
206
+
207
+ def package_synapse_hub(
208
+ repo_root: str = REPO_ROOT,
209
+ output_dir: str = "dist",
210
+ archive_format: str = "zip",
211
+ generate_checksum: bool = False
212
+ ) -> Tuple[List[str], Optional[str]]:
213
+ """
214
+ Main packaging entrypoint: cleans stale archives, builds single target archive, and verifies integrity.
215
+ """
216
+ version = get_version(repo_root)
217
+ out_dir = os.path.join(repo_root, output_dir)
218
+ os.makedirs(out_dir, exist_ok=True)
219
+
220
+ # 1. Clean up old archives in dist and repo_root
221
+ for f in os.listdir(out_dir):
222
+ if f.endswith((".zip", ".tar.gz", ".sha256")):
223
+ try:
224
+ os.remove(os.path.join(out_dir, f))
225
+ except OSError as err:
226
+ _ = err
227
+ for f in os.listdir(repo_root):
228
+ if f.lower().startswith("synapse-hub") and f.endswith(".zip"):
229
+ try:
230
+ os.remove(os.path.join(repo_root, f))
231
+ except OSError as err:
232
+ _ = err
233
+
234
+ files = collect_package_files(repo_root)
235
+ base_name = f"synapse-hub-v{version}"
236
+ created_archives: List[str] = []
237
+
238
+ if archive_format in ("zip", "both"):
239
+ zip_path = os.path.join(out_dir, f"{base_name}.zip")
240
+ create_zip_archive(files, zip_path)
241
+ created_archives.append(zip_path)
242
+
243
+ if archive_format in ("tar.gz", "both"):
244
+ tar_path = os.path.join(out_dir, f"{base_name}.tar.gz")
245
+ create_tar_archive(files, tar_path)
246
+ created_archives.append(tar_path)
247
+
248
+ # Verification pass on all created archives
249
+ for arch in created_archives:
250
+ valid, missing = verify_archive_integrity(arch)
251
+ if not valid:
252
+ raise RuntimeError(f"Archive {arch} failed integrity check! Missing mandatory files: {missing}")
253
+
254
+ checksum_path = None
255
+ if generate_checksum:
256
+ checksum_lines = []
257
+ for arch in created_archives:
258
+ sha = calculate_sha256(arch)
259
+ fname = os.path.basename(arch)
260
+ checksum_lines.append(f"{sha} {fname}")
261
+
262
+ checksum_path = os.path.join(out_dir, f"{base_name}-checksums.sha256")
263
+ with open(checksum_path, "w", encoding="utf-8") as f:
264
+ f.write("\n".join(checksum_lines) + "\n")
265
+
266
+ return created_archives, checksum_path
267
+
268
+
269
+ def main() -> int:
270
+ parser = argparse.ArgumentParser(description="Enterprise Release Packaging & Integrity Sentinel for Synapse Hub")
271
+ parser.add_argument("--repo-root", default=REPO_ROOT, help="Target repository root")
272
+ parser.add_argument("--output-dir", default="dist", help="Output directory for generated archives")
273
+ parser.add_argument("--format", choices=["zip", "tar.gz", "both"], default="zip", help="Archive format (default: zip)")
274
+ parser.add_argument("--with-checksum", action="store_true", default=False, help="Generate .sha256 checksum file alongside the archive")
275
+ parser.add_argument("--verify-archive", help="Verify integrity of an existing archive without building")
276
+ args = parser.parse_args()
277
+
278
+ print("=" * 68)
279
+ print(" SYNAPSE HUB — ENTERPRISE RELEASE PACKAGING & INTEGRITY SENTINEL ")
280
+ print("=" * 68)
281
+
282
+ if args.verify_archive:
283
+ valid, missing = verify_archive_integrity(args.verify_archive)
284
+ if valid:
285
+ print(f"[PASS] Archive {args.verify_archive} verified 100% intact.")
286
+ print(" All mandatory entries (.github/workflows, manifests) present.")
287
+ return 0
288
+ else:
289
+ print(f"[FAIL] Archive {args.verify_archive} is MISSING mandatory files:")
290
+ for m in missing:
291
+ print(f" - {m}")
292
+ return 1
293
+
294
+ print(f" Target Repository : {args.repo_root}")
295
+ print(f" Output Directory : {args.output_dir}")
296
+ print(f" Packaging Format : {args.format}")
297
+ print("-" * 68)
298
+
299
+ try:
300
+ archives, checksum_path = package_synapse_hub(
301
+ repo_root=args.repo_root,
302
+ output_dir=args.output_dir,
303
+ archive_format=args.format,
304
+ generate_checksum=args.with_checksum
305
+ )
306
+ for arch in archives:
307
+ size_mb = os.path.getsize(arch) / (1024 * 1024)
308
+ sha = calculate_sha256(arch)
309
+ print(f" [ARCHIVE] {os.path.basename(arch)} ({size_mb:.2f} MB)")
310
+ print(f" SHA-256: {sha}")
311
+ print(" Integrity: [PASS] All mandatory workflows & rules confirmed.")
312
+
313
+ if checksum_path:
314
+ print(f"\n [PROVENANCE] Checksums written to: {checksum_path}")
315
+ print("=" * 68)
316
+ print("🎉 RELEASE PACKAGING COMPLETED WITH 100% PROVENANCE INTEGRITY")
317
+ print("=" * 68)
318
+ return 0
319
+ except Exception as e:
320
+ print(f"[FAIL] Packaging failed: {e}")
321
+ return 1
322
+
323
+
324
+ if __name__ == "__main__":
325
+ sys.exit(main())
@@ -0,0 +1,24 @@
1
+ """
2
+ Synapse Hub — Performance, Stress & Flakiness Profilers (tools.perf)
3
+ ---------------------------------------------------------------------
4
+ Domain package grouping all JMeter test plan generators, flakiness
5
+ sentinels, BFCL agent gym benchmarks, and test matrix sharders.
6
+ """
7
+
8
+ from tools import (
9
+ browsergym_eval,
10
+ db_sandbox,
11
+ flaky_detector,
12
+ generate_jmx_plan,
13
+ matrix_sharder,
14
+ synapse_qa_bench,
15
+ )
16
+
17
+ __all__ = [
18
+ "browsergym_eval",
19
+ "db_sandbox",
20
+ "flaky_detector",
21
+ "generate_jmx_plan",
22
+ "matrix_sharder",
23
+ "synapse_qa_bench",
24
+ ]
@@ -0,0 +1,190 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Fast Zero-Token Failure Pinpointer for Katalon & Jenkins Reports.
4
+ Scans the latest Reports/**/JUnit_Report.xml, extracts failed Test Cases,
5
+ exact failed lines in Groovy/Script, and the root-cause exception.
6
+ Outputs < 100 tokens.
7
+
8
+ Usage:
9
+ python3 tools/pinpoint_failure.py
10
+ python3 tools/pinpoint_failure.py path/to/JUnit_Report.xml
11
+ """
12
+ import os
13
+ import sys
14
+ import glob
15
+ import xml.etree.ElementTree as ET
16
+ import re
17
+
18
+ if hasattr(sys.stdout, 'reconfigure'):
19
+ try:
20
+ sys.stdout.reconfigure(encoding='utf-8')
21
+ sys.stderr.reconfigure(encoding='utf-8')
22
+ except Exception:
23
+ pass
24
+
25
+ def find_latest_report(search_dir="."):
26
+ """Finds the latest JUnit XML report across Reports/, test-results/, and standard report directories."""
27
+ candidate_patterns = [
28
+ os.path.join(search_dir, "Reports", "**", "*.xml"),
29
+ os.path.join(search_dir, "reports", "**", "*.xml"),
30
+ os.path.join(search_dir, "test-results", "**", "*.xml"),
31
+ os.path.join(search_dir, "build", "test-results", "**", "*.xml"),
32
+ os.path.join(search_dir, "**", "*junit*.xml"),
33
+ os.path.join(search_dir, "**", "results.xml"),
34
+ ]
35
+ matched = []
36
+ for pat in candidate_patterns:
37
+ matched.extend(glob.glob(pat, recursive=True))
38
+
39
+ if not matched:
40
+ return None
41
+
42
+ valid_reports = []
43
+ for r in set(matched):
44
+ base = os.path.basename(r).lower()
45
+ if base in ("pom.xml", "testng.xml", "web.xml", "manifest.xml"):
46
+ continue
47
+ valid_reports.append(r)
48
+
49
+ if not valid_reports:
50
+ return None
51
+
52
+ valid_reports.sort(key=lambda x: os.path.getmtime(x), reverse=True)
53
+ return valid_reports[0]
54
+
55
+ def extract_failed_locations(text):
56
+ """Extracts failing file locations (file:line) across Groovy, Python, TypeScript, JavaScript, and Java."""
57
+ locations = []
58
+ # 1. Groovy Enterprise & Katalon script format: Enterprise.pages.LoginPage.groovy:48 or Script123.groovy:10 or TC-...:10
59
+ groovy_lines = re.findall(r"(?:Enterprise\.pages\.[\w]+|TC-[\w\s\u00C0-\u1EF9]+|Script\d+)\.groovy:\d+|(?:TC-[\w\s\u00C0-\u1EF9]+:\d+)", text)
60
+ locations.extend(groovy_lines)
61
+
62
+ # 2. Playwright / Jest / TS / JS / Java / Groovy stack frames: at [method] (path:line:col) or at path:line:col
63
+ # Supports paths with spaces and Windows drive letters (C:\...)
64
+ for m in re.finditer(r'at (?:[a-zA-Z0-9_$.<>]+\s+\()?([a-zA-Z]:[/\\][^:()\r\n\t]+|[^:()\r\n\t]+?\.(?:ts|tsx|js|jsx|mjs|cjs|py|groovy|java)):(\d+)', text):
65
+ f_p, l_n = m.group(1).strip(), m.group(2)
66
+ locations.append(f"{f_p}:{l_n}")
67
+
68
+ # 3. Python traceback format: File "path/to/file.py", line 42
69
+ for m in re.finditer(r'File ["\']([^"\']+\.(?:py|groovy|ts|tsx|js|jsx|mjs|cjs|java))["\'], line (\d+)', text):
70
+ locations.append(f"{m.group(1).strip()}:{m.group(2)}")
71
+
72
+ # 4. Generic file:line pattern: path/to/file.(ts|js|py|groovy):line
73
+ for m in re.finditer(r'(?:([a-zA-Z]:[/\\][^:()\r\n\t]+|[^:()\r\n\t\s]+?\.(?:ts|tsx|js|jsx|mjs|cjs|py|groovy|java))):(\d+):?', text):
74
+ loc_str = f"{m.group(1).strip()}:{m.group(2)}"
75
+ if loc_str not in locations:
76
+ locations.append(loc_str)
77
+
78
+ seen = set()
79
+ deduped = []
80
+ for loc in locations:
81
+ if loc not in seen:
82
+ seen.add(loc)
83
+ deduped.append(loc)
84
+ return deduped
85
+
86
+
87
+ def _is_framework_frame(path_str: str) -> bool:
88
+ normalized = path_str.replace("\\", "/").lower()
89
+ return any(p in normalized for p in ("node_modules/", "site-packages/", "/_pytest/", "internal/modules/", "virtual_documents/"))
90
+
91
+
92
+ def parse_failures(xml_path):
93
+ if not os.path.exists(xml_path):
94
+ print(f"Error: {xml_path} does not exist.")
95
+ return []
96
+
97
+ try:
98
+ tree = ET.parse(xml_path) # nosec B314
99
+ root = tree.getroot()
100
+ except (ET.ParseError, OSError) as e:
101
+ print(f"Error parsing JUnit XML '{xml_path}': {e}")
102
+ return []
103
+
104
+ failures = []
105
+ suites = [root] if root.tag == "testsuite" else root.findall("testsuite")
106
+
107
+ for suite in suites:
108
+ for tc in suite.findall("testcase"):
109
+ tc_name = tc.get("name", "Unknown")
110
+ tc_time = tc.get("time", "0")
111
+ fail = tc.find("failure")
112
+ err = tc.find("error")
113
+ target = fail if fail is not None else err
114
+
115
+ if target is not None:
116
+ msg = target.get("message", "")
117
+ text = target.text or ""
118
+ combined = (msg + "\n" + text).replace("&#xa;", "\n")
119
+
120
+ # Extract Root Cause Reason
121
+ reason_match = re.search(r"Reason:\s*(.+?)(?=\n\s*at|\Z)", combined, re.DOTALL)
122
+ if reason_match:
123
+ reason = reason_match.group(1).strip()
124
+ else:
125
+ lines = [line.strip() for line in combined.split("\n") if line.strip()]
126
+ reason = lines[0] if lines else "Unknown Error"
127
+
128
+ # Multi-language stack trace extraction (Python, TS/JS, Groovy)
129
+ failed_locs = extract_failed_locations(combined)
130
+ f_file = "UnknownFile"
131
+ f_line = "?"
132
+ if failed_locs:
133
+ # Prefer project/test code frame over external runtime/framework frame
134
+ chosen_loc = next((loc for loc in failed_locs if not _is_framework_frame(loc)), failed_locs[0])
135
+ if ":" in chosen_loc:
136
+ p_file, p_line = chosen_loc.rsplit(":", 1)
137
+ f_file = p_file
138
+ f_line = p_line
139
+
140
+ # Resilient time parsing
141
+ clean_time = re.sub(r"[^\d.]", "", str(tc_time or "0"))
142
+ try:
143
+ formatted_time = f"{float(clean_time):.1f}s" if clean_time else "0.0s"
144
+ except (ValueError, TypeError):
145
+ formatted_time = "0.0s"
146
+
147
+ failures.append({
148
+ "tc": tc_name.split("/")[-1],
149
+ "time": formatted_time,
150
+ "reason": reason.split("\n")[0][:180],
151
+ "failed_at": failed_locs[:2] if failed_locs else ["See JUnit report"],
152
+ "file": f_file,
153
+ "line": f_line
154
+ })
155
+
156
+ return failures
157
+
158
+
159
+ parse_junit_xml = parse_failures
160
+
161
+ def main():
162
+ if len(sys.argv) > 1 and sys.argv[1] in ("-h", "--help"):
163
+ print("Usage: python3 tools/pinpoint_failure.py [path/to/JUnit_Report.xml]")
164
+ print("Scans JUnit XML reports and pinpoints failed test cases and code lines in under 100 tokens.")
165
+ sys.exit(0)
166
+
167
+ if len(sys.argv) > 1 and not os.path.exists(sys.argv[1]):
168
+ print(f"Error: Specified report file does not exist: {sys.argv[1]}")
169
+ sys.exit(1)
170
+
171
+ xml_path = sys.argv[1] if len(sys.argv) > 1 else find_latest_report()
172
+ if not xml_path:
173
+ print("No JUnit XML report found in Reports/, test-results/, or reports/.")
174
+ sys.exit(0)
175
+
176
+ print(f"=== Report: {xml_path} ===")
177
+ failures = parse_failures(xml_path)
178
+ if not failures:
179
+ print("✅ 100% PASSED: Zero failures found in report.")
180
+ sys.exit(0)
181
+
182
+ print(f"❌ Found {len(failures)} Failed Test Case(s):")
183
+ for i, f in enumerate(failures, 1):
184
+ print(f"[{i}] {f['tc']} ({f['time']})")
185
+ print(f" Cause: {f['reason']}")
186
+ print(f" Line: {', '.join(f['failed_at'])}")
187
+ sys.exit(1)
188
+
189
+ if __name__ == "__main__":
190
+ main()