@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,419 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Universal Test Impact Analyzer (Graphify AST-Powered)
4
+ ---------------------------------------------------
5
+ Analyzes which Test Cases are directly or transitively impacted
6
+ when Page Classes or Helper classes are modified, saving CI/CD execution time.
7
+ Supports dynamic target repository resolution (CLI flag, CWD auto-detect, ENV var).
8
+
9
+ Usage:
10
+ python3 tools/test_impact.py --file Keywords/pages/CommonCategoryPage.groovy
11
+ python3 tools/test_impact.py --git-diff
12
+ python3 tools/test_impact.py "D:/target-project" --git-diff
13
+ """
14
+
15
+ import os
16
+ import sys
17
+ import json
18
+ import glob
19
+ import re
20
+ import argparse
21
+ import subprocess
22
+ from typing import List, Optional
23
+
24
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
25
+ if hasattr(sys.stdout, 'reconfigure'):
26
+ try:
27
+ sys.stdout.reconfigure(encoding='utf-8')
28
+ sys.stderr.reconfigure(encoding='utf-8')
29
+ except Exception:
30
+ pass
31
+
32
+ SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
33
+ HUB_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
34
+
35
+
36
+ def resolve_target_repo(cli_target=None, cli_repo=None):
37
+ """
38
+ Resolves the target repository path for test impact analysis:
39
+ 1. Explicit CLI flag: --repo / --path or positional target.
40
+ 2. Environment variable: TARGET_PROJECT_DIR.
41
+ 3. Current Working Directory (if different from Hub).
42
+ 4. Default fallback: QA Hub root (parent of tools/).
43
+ """
44
+ chosen = cli_repo or cli_target
45
+ if chosen:
46
+ resolved = os.path.abspath(chosen)
47
+ if not os.path.exists(resolved):
48
+ raise FileNotFoundError(f"Target repository path not found: {resolved}")
49
+ return resolved
50
+
51
+ env_dir = os.environ.get("TARGET_PROJECT_DIR")
52
+ if env_dir and os.path.exists(env_dir):
53
+ return os.path.abspath(env_dir)
54
+
55
+ cwd = os.path.abspath(os.getcwd())
56
+ if cwd.lower() != HUB_ROOT.lower():
57
+ return cwd
58
+
59
+ return HUB_ROOT
60
+
61
+
62
+ def build_fallback_graph(repo_root):
63
+ """
64
+ Builds a lightweight in-memory AST/token dependency graph when graphify-out/graph.json is absent.
65
+ Scans Keywords/ (or src/) for classes and Scripts/ (or tests/) for references.
66
+ """
67
+ nodes = []
68
+ edges = []
69
+ class_map = {}
70
+
71
+ # 1. Scan Keywords / src classes
72
+ class_files = []
73
+ for ext in ("*.groovy", "*.java", "*.ts", "*.py"):
74
+ for sub in ("Keywords", "src", "pages", "helpers"):
75
+ for f in glob.glob(os.path.join(repo_root, sub, "**", ext), recursive=True):
76
+ class_files.append(f)
77
+ cls_name = os.path.splitext(os.path.basename(f))[0]
78
+ rel_path = os.path.relpath(f, repo_root).replace("\\", "/")
79
+ class_map[cls_name] = rel_path
80
+ nodes.append({"id": cls_name, "label": cls_name, "file": rel_path})
81
+
82
+ # Inter-class dependencies (e.g. PlanningPage extends BasePage)
83
+ for f in class_files:
84
+ cls_name = os.path.splitext(os.path.basename(f))[0]
85
+ try:
86
+ with open(f, "r", encoding="utf-8", errors="ignore") as fp:
87
+ content = fp.read()
88
+ for other_cls in class_map:
89
+ if other_cls != cls_name and re.search(r"\b" + re.escape(other_cls) + r"\b", content):
90
+ edges.append({"source": cls_name, "target": other_cls})
91
+ except (OSError, UnicodeDecodeError):
92
+ content = ""
93
+
94
+ # 2. Scan Scripts / tests
95
+ script_patterns = [
96
+ os.path.join(repo_root, "Scripts", "**", "*.groovy"),
97
+ os.path.join(repo_root, "tests", "**", "*.spec.ts"),
98
+ os.path.join(repo_root, "tests", "**", "*.test.ts"),
99
+ os.path.join(repo_root, "tests", "**", "test_*.py"),
100
+ ]
101
+ for pat in script_patterns:
102
+ for f in glob.glob(pat, recursive=True):
103
+ rel_path = os.path.relpath(f, repo_root).replace("\\", "/")
104
+ parent_dir = os.path.basename(os.path.dirname(f))
105
+ file_base = os.path.splitext(os.path.basename(f))[0]
106
+ if file_base.startswith("Script") and parent_dir and parent_dir != "Scripts":
107
+ script_label = parent_dir
108
+ else:
109
+ script_label = file_base
110
+
111
+ nodes.append({"id": rel_path, "label": script_label, "file": rel_path})
112
+
113
+ try:
114
+ with open(f, "r", encoding="utf-8", errors="ignore") as fp:
115
+ content = fp.read()
116
+ for cls_name in class_map:
117
+ # Word-boundary match: "BorrowPage" must not hit inside
118
+ # "ApprovalBorrowPage" (substring match over-counted).
119
+ if re.search(r"\b" + re.escape(cls_name) + r"\b", content):
120
+ edges.append({"source": rel_path, "target": cls_name})
121
+ except (OSError, UnicodeDecodeError):
122
+ content = ""
123
+
124
+ return {"nodes": nodes, "edges": edges}
125
+
126
+
127
+ def merge_graphs(primary, fallback):
128
+ """Unions two graph dicts (nodes by id, edges by (source, target)).
129
+
130
+ The Graphify graph can silently miss edges (its Groovy extractor fails on
131
+ GString/closure-heavy files), so the grep-based fallback graph is always
132
+ merged in. Over-inclusion is the safe direction for impact analysis.
133
+ """
134
+ merged = {"nodes": [], "edges": []}
135
+ seen_nodes, seen_edges = set(), set()
136
+ for node in list(primary.get("nodes", [])) + list(fallback.get("nodes", [])):
137
+ node_id = node.get("id")
138
+ if node_id and node_id not in seen_nodes:
139
+ seen_nodes.add(node_id)
140
+ merged["nodes"].append(node)
141
+ for edge in list(primary.get("edges", [])) + list(fallback.get("edges", [])):
142
+ key = (edge.get("source"), edge.get("target"))
143
+ if key not in seen_edges:
144
+ seen_edges.add(key)
145
+ merged["edges"].append(edge)
146
+ return merged
147
+
148
+
149
+ def load_graph(repo_root=None):
150
+ root = repo_root or HUB_ROOT
151
+ graph_data = None
152
+ graph_path = os.path.join(root, "graphify-out", "graph.json")
153
+ if os.path.exists(graph_path):
154
+ with open(graph_path, "r", encoding="utf-8") as fp:
155
+ graph_data = json.load(fp)
156
+ else:
157
+ hub_graph = os.path.join(HUB_ROOT, "graphify-out", "graph.json")
158
+ if os.path.exists(hub_graph):
159
+ with open(hub_graph, "r", encoding="utf-8") as fp:
160
+ graph_data = json.load(fp)
161
+
162
+ # Always union the ground-truth fallback graph: when the target repo has a
163
+ # (possibly incomplete) graphify-out/graph.json the grep scan below is the
164
+ # only thing guaranteeing script->class edges actually exist.
165
+ fallback = build_fallback_graph(root)
166
+ if graph_data is None:
167
+ return fallback
168
+ return merge_graphs(graph_data, fallback)
169
+
170
+
171
+ def get_git_modified_files(repo_root=None):
172
+ root = repo_root or HUB_ROOT
173
+ try:
174
+ res = subprocess.run(
175
+ ["git", "-C", root, "diff", "--name-only", "HEAD"],
176
+ stdout=subprocess.PIPE,
177
+ stderr=subprocess.PIPE,
178
+ text=True,
179
+ check=True,
180
+ timeout=30.0
181
+ )
182
+ files = [line.strip() for line in res.stdout.splitlines() if line.strip()]
183
+ return files
184
+ except Exception as e:
185
+ print(f"⚠️ Failed to retrieve git diff from {root}: {e}")
186
+ return []
187
+
188
+
189
+ def get_total_test_cases(workspace_dir=None, graph_data=None, override_total=None):
190
+ """Dynamically counts test cases in repository or knowledge graph."""
191
+ if override_total is not None and override_total > 0:
192
+ return override_total
193
+
194
+ root = workspace_dir or HUB_ROOT
195
+
196
+ # 1. Scan filesystem for test scripts
197
+ test_patterns = [
198
+ os.path.join(root, "Scripts", "**", "*.groovy"),
199
+ os.path.join(root, "Test Cases", "**", "*.tc"),
200
+ os.path.join(root, "tests", "**", "*.spec.ts"),
201
+ os.path.join(root, "tests", "**", "*.test.ts"),
202
+ os.path.join(root, "tests", "**", "*.spec.js"),
203
+ os.path.join(root, "tests", "**", "*.test.js"),
204
+ os.path.join(root, "tests", "**", "test_*.py"),
205
+ os.path.join(root, "tests", "**", "*_test.py"),
206
+ ]
207
+ files = set()
208
+ for pat in test_patterns:
209
+ files.update(glob.glob(pat, recursive=True))
210
+ if files:
211
+ # Katalon-style repos list one TC twice (Scripts/<TC_x>/ScriptN.groovy
212
+ # AND Test Cases/.../TC_x.tc) — dedupe by the TC identifier so the
213
+ # denominator counts logical test cases, not file copies.
214
+ identities = set()
215
+ for f in files:
216
+ rel = os.path.relpath(f, root).replace("\\", "/")
217
+ match = re.search(r"TC[_-]\d+", rel)
218
+ identities.add(("tc", match.group(0)) if match else ("file", rel))
219
+ return len(identities)
220
+
221
+ # 2. Count test case nodes in graph if available
222
+ if graph_data and "nodes" in graph_data:
223
+ tc_nodes = [
224
+ n for n in graph_data["nodes"]
225
+ if any(k in str(n.get("label", "")).lower() or k in str(n.get("name", "")).lower()
226
+ for k in ["tc-", "testcase", "test_case", "spec"])
227
+ ]
228
+ if tc_nodes:
229
+ return len(tc_nodes)
230
+
231
+ return 0
232
+
233
+
234
+ def analyze_impact(graph_data, target_files):
235
+ nodes = {n["id"]: n for n in graph_data.get("nodes", [])}
236
+ edges = graph_data.get("edges", [])
237
+
238
+ # Map target files to node IDs
239
+ target_node_ids = set()
240
+ for tf in target_files:
241
+ norm_tf = tf.replace("\\", "/")
242
+ base_name = os.path.basename(norm_tf)
243
+ class_name = os.path.splitext(base_name)[0]
244
+
245
+ for n_id, n in nodes.items():
246
+ n_file = (n.get("file") or "").replace("\\", "/")
247
+ if norm_tf in n_file or n_id == class_name or n.get("label") == class_name:
248
+ target_node_ids.add(n_id)
249
+
250
+ if not target_node_ids:
251
+ return []
252
+
253
+ # Build reverse dependency graph (who calls target)
254
+ callers = {}
255
+ for edge in edges:
256
+ src = edge.get("source")
257
+ tgt = edge.get("target")
258
+ if tgt not in callers:
259
+ callers[tgt] = set()
260
+ callers[tgt].add(src)
261
+
262
+ # BFS to find all upstream impacted nodes
263
+ visited = set()
264
+ queue = list(target_node_ids)
265
+ while queue:
266
+ curr = queue.pop(0)
267
+ if curr in visited:
268
+ continue
269
+ visited.add(curr)
270
+ for parent in callers.get(curr, []):
271
+ if parent not in visited:
272
+ queue.append(parent)
273
+
274
+ # Filter for Test Case nodes
275
+ impacted_test_cases = set()
276
+ for node_id in visited:
277
+ node = nodes.get(node_id, {})
278
+ file_path = node.get("file", "")
279
+ label = node.get("label", node_id)
280
+
281
+ if "Scripts/" in file_path or "tests/" in file_path or "Test Cases/" in file_path or "TC-" in label or "TC_" in label or "TC" in label:
282
+ impacted_test_cases.add(label)
283
+
284
+ return sorted(list(impacted_test_cases))
285
+
286
+
287
+ def get_impacted_test_files(target_files: List[str], repo_root: Optional[str] = None) -> List[str]:
288
+ """
289
+ Returns relative file paths of all test scripts directly or transitively
290
+ impacted by modifications to the given target files.
291
+ """
292
+ root = repo_root or HUB_ROOT
293
+ graph_data = load_graph(root)
294
+ nodes = {n["id"]: n for n in graph_data.get("nodes", [])}
295
+ edges = graph_data.get("edges", [])
296
+
297
+ target_node_ids = set()
298
+ impacted_files = set()
299
+
300
+ for tf in target_files:
301
+ norm_tf = tf.replace("\\", "/")
302
+ if "tests/" in norm_tf or "Scripts/" in norm_tf or "Test Cases/" in norm_tf or norm_tf.endswith(("_test.py", ".spec.ts", ".test.ts", ".groovy")):
303
+ impacted_files.add(norm_tf)
304
+
305
+ base_name = os.path.basename(norm_tf)
306
+ class_name = os.path.splitext(base_name)[0]
307
+ for n_id, n in nodes.items():
308
+ n_file = (n.get("file") or "").replace("\\", "/")
309
+ if norm_tf in n_file or n_id == class_name or n.get("label") == class_name:
310
+ target_node_ids.add(n_id)
311
+
312
+ if not target_node_ids and not impacted_files:
313
+ return []
314
+
315
+ callers = {}
316
+ for edge in edges:
317
+ src = edge.get("source")
318
+ tgt = edge.get("target")
319
+ if tgt not in callers:
320
+ callers[tgt] = set()
321
+ callers[tgt].add(src)
322
+
323
+ visited = set()
324
+ queue = list(target_node_ids)
325
+ while queue:
326
+ curr = queue.pop(0)
327
+ if curr in visited:
328
+ continue
329
+ visited.add(curr)
330
+ for parent in callers.get(curr, []):
331
+ if parent not in visited:
332
+ queue.append(parent)
333
+
334
+ for node_id in visited:
335
+ node = nodes.get(node_id, {})
336
+ file_path = (node.get("file") or "").replace("\\", "/")
337
+ if "Scripts/" in file_path or "tests/" in file_path or "Test Cases/" in file_path:
338
+ impacted_files.add(file_path)
339
+
340
+ return sorted(list(impacted_files))
341
+
342
+
343
+
344
+ def main():
345
+ parser = argparse.ArgumentParser(description="Universal Test Impact Analyzer")
346
+ parser.add_argument("target", nargs="?", default=None, help="Target repository path to analyze")
347
+ parser.add_argument("--repo", "--path", dest="repo_path", default=None, help="Target repository path")
348
+ parser.add_argument("--file", "-f", nargs="+", help="Target modified files (e.g. Keywords/pages/CommonCategoryPage.groovy)")
349
+ parser.add_argument("--git-diff", action="store_true", help="Analyze git modified files automatically")
350
+ parser.add_argument("--json", action="store_true", help="Output results in JSON format")
351
+ parser.add_argument("--total", "-t", type=int, default=None, help="Explicit total test case count override")
352
+ args = parser.parse_args()
353
+
354
+ try:
355
+ target_repo = resolve_target_repo(cli_target=args.target, cli_repo=args.repo_path)
356
+ except FileNotFoundError as e:
357
+ print(f"❌ Error: {e}")
358
+ return 1
359
+
360
+ target_files = []
361
+ if args.file:
362
+ target_files.extend(args.file)
363
+ if args.git_diff or not target_files:
364
+ git_files = get_git_modified_files(target_repo)
365
+ target_files.extend([f for f in git_files if "Keywords/" in f or "pages/" in f or "src/" in f])
366
+
367
+ if not target_files:
368
+ print("ℹ️ No Page Class / Keywords files specified or modified in git.")
369
+ return 0
370
+
371
+ graph_data = load_graph(target_repo)
372
+ impacted_tcs = analyze_impact(graph_data, target_files)
373
+
374
+ total_tcs = get_total_test_cases(target_repo, graph_data, args.total)
375
+ if total_tcs == 0:
376
+ total_tcs = max(len(impacted_tcs), 1)
377
+
378
+ impacted_count = len(impacted_tcs)
379
+ saved_count = max(0, total_tcs - impacted_count)
380
+ reduction_pct = (saved_count / total_tcs * 100) if total_tcs else 0
381
+
382
+ if args.json:
383
+ result = {
384
+ "target_repository": target_repo,
385
+ "target_files": target_files,
386
+ "impacted_count": impacted_count,
387
+ "total_test_cases": total_tcs,
388
+ "time_saved_percent": round(reduction_pct, 1),
389
+ "impacted_test_cases": impacted_tcs
390
+ }
391
+ print(json.dumps(result, ensure_ascii=False, indent=2))
392
+ return 0
393
+
394
+ print("\n" + "=" * 70)
395
+ print(" UNIVERSAL TEST IMPACT ANALYZER (GRAPHIFY AST KNOWLEDGE GRAPH)")
396
+ print("=" * 70)
397
+ print(f"📁 Target Repository : {target_repo}")
398
+ print("🔍 Modified / inspected target files:")
399
+ for tf in target_files:
400
+ print(f" • {tf}")
401
+
402
+ print("\n📊 Test Impact Assessment:")
403
+ print(f" - Directly impacted Test Cases : {impacted_count} / {total_tcs} TCs")
404
+ print(f" - Test Cases unaffected (Skipped) : {saved_count} TCs")
405
+ print(f" - CI/CD execution time reduction : {reduction_pct:.1f}%")
406
+
407
+ if impacted_tcs:
408
+ print("\n📋 Candidate Test Cases for re-test:")
409
+ for idx, tc in enumerate(impacted_tcs[:20], 1):
410
+ print(f" {idx:2d}. {tc}")
411
+ if len(impacted_tcs) > 20:
412
+ print(f" ... and {len(impacted_tcs) - 20} additional Test Cases.")
413
+
414
+ print("\n" + "=" * 70)
415
+ return 0
416
+
417
+
418
+ if __name__ == "__main__":
419
+ sys.exit(main())