@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,746 @@
1
+ /**
2
+ * Enterprise Browser Runtime Helper (window.__qa)
3
+ * -------------------------------------------------------------
4
+ * Provides advanced AI testing capabilities directly inside the live browser DOM:
5
+ * 1. Smart Action Batching (qa.batch) - Atomic execution with pause & state preservation.
6
+ * 2. Instant Form Audit (qa.audit) - Detects Angular/React/Vue invalid fields in 1-shot.
7
+ * 3. Self-Healing Locator Engine (qa.heal) - Suggests resilient selectors when locators break.
8
+ * 4. Safe Click & Overlay Bypass (qa.clickSafe) - Clears CDK/PrimeNG/Modal overlays before clicking.
9
+ * 5. Session State Exporter/Importer (qa.exportSession / qa.importSession).
10
+ * 6. Deterministic Sync Engine (qa.isStable / qa.waitForStable / qa.waitForNetworkIdle).
11
+ */
12
+
13
+ (function () {
14
+ 'use strict';
15
+
16
+ if (window.__qa && window.__qa.__version === '3.8.2') {
17
+ return window.__qa;
18
+ }
19
+
20
+ // Active in-flight network request tracker
21
+ let activeNetworkRequests = 0;
22
+ if (!window.__qa_net_hooked) {
23
+ window.__qa_net_hooked = true;
24
+ if (window.fetch) {
25
+ const origFetch = window.fetch;
26
+ window.fetch = function () {
27
+ activeNetworkRequests++;
28
+ return origFetch.apply(window, arguments).finally(() => {
29
+ activeNetworkRequests = Math.max(0, activeNetworkRequests - 1);
30
+ });
31
+ };
32
+ }
33
+ if (window.XMLHttpRequest) {
34
+ const origOpen = XMLHttpRequest.prototype.open;
35
+ const origSend = XMLHttpRequest.prototype.send;
36
+ XMLHttpRequest.prototype.open = function () {
37
+ this.addEventListener('loadend', () => {
38
+ activeNetworkRequests = Math.max(0, activeNetworkRequests - 1);
39
+ });
40
+ return origOpen.apply(this, arguments);
41
+ };
42
+ XMLHttpRequest.prototype.send = function () {
43
+ activeNetworkRequests++;
44
+ return origSend.apply(this, arguments);
45
+ };
46
+ }
47
+ }
48
+
49
+ const qa = {
50
+ __version: '3.8.2',
51
+
52
+ /**
53
+ * 1. Smart Action Batching
54
+ * Runs a sequence of step functions atomically.
55
+ * Halts immediately upon failure without resetting previously filled inputs.
56
+ * @param {Array<{name: string, fn: Function}>} steps
57
+ * @returns {Object} { status: 'SUCCESS' | 'FAILED', failedStep?: number, name?: string, error?: string }
58
+ */
59
+ batch: function (steps) {
60
+ if (!Array.isArray(steps)) {
61
+ return { status: 'FAILED', error: 'Steps must be an array of {name, fn}' };
62
+ }
63
+ for (let i = 0; i < steps.length; i++) {
64
+ const step = steps[i];
65
+ try {
66
+ if (typeof step.fn === 'function') {
67
+ step.fn();
68
+ } else if (typeof step.action === 'function') {
69
+ step.action();
70
+ } else {
71
+ throw new Error(`Step #${i + 1} (${step.name}) has no runnable function.`);
72
+ }
73
+ } catch (err) {
74
+ return {
75
+ status: 'FAILED',
76
+ failedStep: i + 1,
77
+ stepName: step.name || `Step #${i + 1}`,
78
+ error: err.message,
79
+ preservedStateUrl: window.location.href
80
+ };
81
+ }
82
+ }
83
+ return { status: 'SUCCESS', totalSteps: steps.length };
84
+ },
85
+
86
+ /**
87
+ * 2. Instant Form Audit
88
+ * Finds all invalid fields in active forms (diagnosing disabled Save buttons).
89
+ * Covers Angular Material, PrimeNG, Ant Design, Bootstrap, and HTML5 validation.
90
+ * @returns {Array<Object>} List of invalid controls with metadata
91
+ */
92
+ audit: function () {
93
+ const invalidNodes = Array.from(
94
+ document.querySelectorAll(
95
+ 'form .ng-invalid, input.ng-invalid, mat-form-field.ng-invalid, mat-select.ng-invalid, textarea.ng-invalid, p-dropdown.ng-invalid, :invalid'
96
+ )
97
+ );
98
+ return invalidNodes.map(el => ({
99
+ tag: el.tagName.toLowerCase(),
100
+ control: el.getAttribute('formcontrolname') || el.getAttribute('name') || el.id || 'unnamed',
101
+ placeholder: el.getAttribute('placeholder') || '',
102
+ classes: el.className,
103
+ value: el.value || el.innerText.trim()
104
+ }));
105
+ },
106
+
107
+ /**
108
+ * 3. Self-Healing Locator Engine
109
+ * When a selector returns 0 elements, scans DOM for matching text, label, or placeholder.
110
+ * @param {string} brokenSelector
111
+ * @param {string} [searchText]
112
+ * @returns {Object} Suggested robust selector
113
+ */
114
+ heal: function (brokenSelector, searchText) {
115
+ const query = (searchText || brokenSelector || '').replace(/['"\\\[\]]/g, '').trim().toLowerCase();
116
+ const candidates = [];
117
+
118
+ // Scan buttons
119
+ document.querySelectorAll('button, a.p-button, span.p-button-text, .mat-mdc-button, [role="button"]').forEach(btn => {
120
+ const txt = btn.innerText.trim().toLowerCase();
121
+ if (query && txt.includes(query)) {
122
+ candidates.push({
123
+ type: 'button',
124
+ text: btn.innerText.trim(),
125
+ suggestedXPath: `//button[contains(normalize-space(.), '${btn.innerText.trim()}')]`,
126
+ score: 0.95
127
+ });
128
+ }
129
+ });
130
+
131
+ // Scan inputs & form controls
132
+ document.querySelectorAll('input, textarea, mat-select, p-dropdown, select').forEach(inp => {
133
+ const fcn = inp.getAttribute('formcontrolname');
134
+ const ph = inp.getAttribute('placeholder') || '';
135
+ const name = inp.getAttribute('name');
136
+ const testid = inp.getAttribute('data-testid');
137
+ if (testid && testid.toLowerCase().includes(query)) {
138
+ candidates.push({
139
+ type: 'input',
140
+ dataTestId: testid,
141
+ suggestedCss: `[data-testid='${testid}']`,
142
+ score: 0.99
143
+ });
144
+ } else if ((fcn || name) && ((fcn || name).toLowerCase().includes(query) || (query && ph.toLowerCase().includes(query)))) {
145
+ const ctrl = fcn || name;
146
+ candidates.push({
147
+ type: 'input',
148
+ formControlName: fcn,
149
+ name: name,
150
+ placeholder: ph,
151
+ suggestedXPath: `//*[@formcontrolname='${ctrl}']`,
152
+ suggestedCss: `[formcontrolname='${ctrl}']`,
153
+ score: 0.98
154
+ });
155
+ }
156
+ });
157
+
158
+ return {
159
+ originalSelector: brokenSelector,
160
+ candidatesFound: candidates.length,
161
+ bestMatch: candidates[0] || null
162
+ };
163
+ },
164
+
165
+ /**
166
+ * 4. Safe Click & Overlay Bypass
167
+ * Dispatches click event directly, bypassing blocking overlays
168
+ * (.cdk-overlay-backdrop, .p-component-overlay, .modal-backdrop).
169
+ * @param {string | HTMLElement} target
170
+ * @returns {boolean}
171
+ */
172
+ clickSafe: function (target) {
173
+ const el = typeof target === 'string' ? document.querySelector(target) : target;
174
+ if (!el) return false;
175
+
176
+ // Temporarily neutralize blocking overlays if present
177
+ document.querySelectorAll('.cdk-overlay-backdrop, .p-component-overlay, .modal-backdrop').forEach(overlay => {
178
+ overlay.style.pointerEvents = 'none';
179
+ });
180
+
181
+ el.scrollIntoView({ behavior: 'auto', block: 'center' });
182
+ el.dispatchEvent(new MouseEvent('mouseover', { bubbles: true }));
183
+ el.dispatchEvent(new MouseEvent('mousedown', { bubbles: true }));
184
+ el.dispatchEvent(new MouseEvent('mouseup', { bubbles: true }));
185
+ el.click();
186
+ return true;
187
+ },
188
+
189
+ /**
190
+ * 5. Session State Exporter
191
+ * Exports tokens and localStorage to bypass UI login (Zero-Second Auth).
192
+ * @returns {Object}
193
+ */
194
+ exportSession: function () {
195
+ const storage = {};
196
+ try {
197
+ const ls = (typeof window !== "undefined" && window.localStorage) || (typeof localStorage !== "undefined" ? localStorage : null);
198
+ if (ls) {
199
+ for (let i = 0; i < ls.length; i++) {
200
+ const key = ls.key(i);
201
+ if (key) storage[key] = ls.getItem(key);
202
+ }
203
+ }
204
+ } catch (e) {
205
+ // Ignore cross-origin security errors on localStorage access
206
+ }
207
+ return {
208
+ url: (typeof window !== "undefined" && window.location && window.location.href) || "",
209
+ cookies: (typeof document !== "undefined" && document.cookie) || "",
210
+ localStorage: storage
211
+ };
212
+ },
213
+
214
+ /**
215
+ * Restore session state
216
+ * @param {Object} data
217
+ */
218
+ importSession: function (data) {
219
+ if (data && data.localStorage) {
220
+ for (const [k, v] of Object.entries(data.localStorage)) {
221
+ localStorage.setItem(k, v);
222
+ }
223
+ }
224
+ return { status: 'SESSION_IMPORTED' };
225
+ },
226
+
227
+ /**
228
+ * 6. Zone.js & Microtask Stability Sync Engine
229
+ * Checks if framework microtasks, promises, and animations are fully settled.
230
+ * @returns {boolean}
231
+ */
232
+ isStable: function () {
233
+ try {
234
+ if (window.getAllAngularTestabilities) {
235
+ const testabilities = window.getAllAngularTestabilities();
236
+ if (testabilities && testabilities.length > 0) {
237
+ return testabilities.every(t => t.isStable());
238
+ }
239
+ }
240
+ const hasBlocker = document.querySelector(
241
+ '.p-blockui, .p-progress-spinner, .mat-mdc-progress-bar, .spinner, .loading, .ng-animating'
242
+ );
243
+ return !hasBlocker;
244
+ } catch (e) {
245
+ return true;
246
+ }
247
+ },
248
+
249
+ /**
250
+ * Asynchronously wait for framework to become stable
251
+ * @param {number} [timeoutMs=10000]
252
+ * @returns {Promise<boolean>}
253
+ */
254
+ waitForStable: function (timeoutMs = 10000) {
255
+ const self = this;
256
+ const start = Date.now();
257
+ return new Promise((resolve) => {
258
+ const interval = setInterval(() => {
259
+ if (self.isStable()) {
260
+ clearInterval(interval);
261
+ resolve(true);
262
+ } else if (Date.now() - start > timeoutMs) {
263
+ clearInterval(interval);
264
+ resolve(false);
265
+ }
266
+ }, 100);
267
+ });
268
+ },
269
+
270
+ /**
271
+ * 7. CDP Network Drain & In-Flight Traffic Monitor (Network Idle 0)
272
+ */
273
+ getActiveRequests: function () {
274
+ return activeNetworkRequests;
275
+ },
276
+
277
+ waitForNetworkIdle: function (idleTimeMs = 500, timeoutMs = 10000) {
278
+ const start = Date.now();
279
+ let idleStart = null;
280
+ return new Promise((resolve) => {
281
+ const interval = setInterval(() => {
282
+ if (activeNetworkRequests === 0) {
283
+ if (!idleStart) idleStart = Date.now();
284
+ if (Date.now() - idleStart >= idleTimeMs) {
285
+ clearInterval(interval);
286
+ resolve(true);
287
+ }
288
+ } else {
289
+ idleStart = null;
290
+ }
291
+ if (Date.now() - start > timeoutMs) {
292
+ clearInterval(interval);
293
+ resolve(false);
294
+ }
295
+ }, 50);
296
+ });
297
+ },
298
+
299
+ /**
300
+ * 8. Action Safety Firewall (Blast Radius Containment)
301
+ */
302
+ firewall: {
303
+ DANGEROUS_PATTERNS: /\b(delete|remove|purge|wipe|drop|pay|purchase|checkout|terminate|destroy|transfer|reset)\b/i,
304
+ DANGEROUS_SELECTORS: ['[data-action*="delete"]', '[data-action*="pay"]', '.btn-danger', '.p-button-danger', '[aria-label*="delete" i]'],
305
+
306
+ isDangerous: function (element, actionName = 'click') {
307
+ if (!element) return false;
308
+ const text = (element.innerText || element.textContent || element.value || element.getAttribute('aria-label') || '').trim();
309
+ if (this.DANGEROUS_PATTERNS.test(text)) return true;
310
+ for (const sel of this.DANGEROUS_SELECTORS) {
311
+ if (element.matches && element.matches(sel)) return true;
312
+ if (element.closest && element.closest(sel)) return true;
313
+ }
314
+ return false;
315
+ },
316
+
317
+ checkSafeAction: function (element, actionName = 'click') {
318
+ const dangerous = this.isDangerous(element, actionName);
319
+ if (!dangerous) {
320
+ return { allowed: true, reason: 'ACTION_SAFE' };
321
+ }
322
+ if (window.__ALLOW_DESTRUCTIVE__ === true) {
323
+ return { allowed: true, reason: 'BYPASS_FLAG_ENABLED' };
324
+ }
325
+ return {
326
+ allowed: false,
327
+ reason: 'DANGEROUS_ACTION_BLOCKED',
328
+ message: `Action '${actionName}' on destructive element was blocked by Safety Firewall. Set window.__ALLOW_DESTRUCTIVE__ = true to override.`
329
+ };
330
+ }
331
+ },
332
+
333
+ /**
334
+ * 9. Multimodal Vision-Grounded Set-of-Marks (SoM) Engine
335
+ * Pierces Shadow DOM and inspects HTML5 Canvas elements for coordinate grounding.
336
+ */
337
+ som: {
338
+ getInteractiveMarks: function () {
339
+ const marks = [];
340
+ let idCounter = 1;
341
+
342
+ function traverse(root) {
343
+ if (!root || !root.querySelectorAll) return;
344
+ const candidates = root.querySelectorAll('button, a, input, select, textarea, [role="button"], canvas, svg');
345
+ candidates.forEach(el => {
346
+ const rect = el.getBoundingClientRect();
347
+ if (rect.width > 5 && rect.height > 5 && window.getComputedStyle(el).visibility !== 'hidden') {
348
+ const label = el.getAttribute('aria-label') || el.innerText || el.value || el.tagName.toLowerCase();
349
+ marks.push({
350
+ mark_id: idCounter++,
351
+ tag: el.tagName.toLowerCase(),
352
+ label: (label || '').trim().substring(0, 50),
353
+ x: Math.round(rect.left),
354
+ y: Math.round(rect.top),
355
+ width: Math.round(rect.width),
356
+ height: Math.round(rect.height),
357
+ center_x: Math.round(rect.left + rect.width / 2),
358
+ center_y: Math.round(rect.top + rect.height / 2)
359
+ });
360
+ }
361
+ // Pierce Shadow DOM
362
+ if (el.shadowRoot) {
363
+ traverse(el.shadowRoot);
364
+ }
365
+ });
366
+ }
367
+
368
+ traverse(document);
369
+ return marks;
370
+ },
371
+
372
+ overlayMarks: function () {
373
+ this.clearMarks();
374
+ const container = document.createElement('div');
375
+ container.id = '__qa_som_overlay';
376
+ container.style.position = 'fixed';
377
+ container.style.top = '0';
378
+ container.style.left = '0';
379
+ container.style.width = '100vw';
380
+ container.style.height = '100vh';
381
+ container.style.pointerEvents = 'none';
382
+ container.style.zIndex = '999999';
383
+
384
+ const marks = this.getInteractiveMarks();
385
+ marks.forEach(m => {
386
+ const badge = document.createElement('div');
387
+ badge.style.position = 'absolute';
388
+ badge.style.left = m.x + 'px';
389
+ badge.style.top = Math.max(0, m.y - 18) + 'px';
390
+ badge.style.background = '#FF0055';
391
+ badge.style.color = '#FFFFFF';
392
+ badge.style.fontSize = '12px';
393
+ badge.style.fontWeight = 'bold';
394
+ badge.style.padding = '1px 4px';
395
+ badge.style.borderRadius = '3px';
396
+ badge.innerText = m.mark_id;
397
+
398
+ const box = document.createElement('div');
399
+ box.style.position = 'absolute';
400
+ box.style.left = m.x + 'px';
401
+ box.style.top = m.y + 'px';
402
+ box.style.width = m.width + 'px';
403
+ box.style.height = m.height + 'px';
404
+ box.style.border = '2px solid #FF0055';
405
+
406
+ container.appendChild(box);
407
+ container.appendChild(badge);
408
+ });
409
+
410
+ document.body.appendChild(container);
411
+ return marks;
412
+ },
413
+
414
+ clearMarks: function () {
415
+ const existing = document.getElementById('__qa_som_overlay');
416
+ if (existing) existing.remove();
417
+ }
418
+ },
419
+
420
+ /**
421
+ * 7. Ultra-Compact Accessibility Object Model (AOM) Distillation
422
+ * Filters noise (wrapper divs, styling spans) and returns an ultra-sparse
423
+ * tree representation (Role, Name, State, TestId) capped at maxDepth (default: 3).
424
+ * Prevents context rot / token bloat by condensing thousands of DOM nodes into ~300 tokens.
425
+ * @param {Element|Document} [root=document]
426
+ * @param {number} [maxDepth=3]
427
+ * @returns {Array<{role: string, name: string, state?: Object, testId?: string, depth: number}>}
428
+ */
429
+ getCompactAOM: function (root = document, maxDepth = 3) {
430
+ const aomNodes = [];
431
+ const INTERACTIVE_ROLES = new Set([
432
+ 'button', 'link', 'textbox', 'checkbox', 'radio', 'combobox', 'menuitem',
433
+ 'tab', 'switch', 'dialog', 'alert', 'searchbox', 'spinbutton', 'option', 'treeitem'
434
+ ]);
435
+
436
+ function getRole(el) {
437
+ const explicitRole = el.getAttribute('role');
438
+ if (explicitRole) return explicitRole.toLowerCase();
439
+ const tag = el.tagName.toLowerCase();
440
+ if (tag === 'button') return 'button';
441
+ if (tag === 'a' && el.hasAttribute('href')) return 'link';
442
+ if (tag === 'input') {
443
+ const type = (el.getAttribute('type') || 'text').toLowerCase();
444
+ if (['checkbox', 'radio', 'button', 'submit'].includes(type)) return type;
445
+ return 'textbox';
446
+ }
447
+ if (tag === 'select') return 'combobox';
448
+ if (tag === 'textarea') return 'textbox';
449
+ return null;
450
+ }
451
+
452
+ function getAccessibleName(el) {
453
+ return (
454
+ el.getAttribute('aria-label') ||
455
+ el.getAttribute('aria-placeholder') ||
456
+ el.getAttribute('placeholder') ||
457
+ el.getAttribute('title') ||
458
+ (el.innerText ? el.innerText.trim().slice(0, 50).replace(/\s+/g, ' ') : '') ||
459
+ el.getAttribute('name') ||
460
+ el.getAttribute('value') ||
461
+ ''
462
+ );
463
+ }
464
+
465
+ function getState(el) {
466
+ const state = {};
467
+ if (el.disabled || el.getAttribute('aria-disabled') === 'true') state.disabled = true;
468
+ if (el.getAttribute('aria-expanded') !== null) state.expanded = el.getAttribute('aria-expanded') === 'true';
469
+ if (el.checked || el.getAttribute('aria-checked') === 'true') state.checked = true;
470
+ if (el.getAttribute('aria-invalid') === 'true') state.invalid = true;
471
+ if (el.getAttribute('aria-selected') === 'true') state.selected = true;
472
+ return Object.keys(state).length > 0 ? state : undefined;
473
+ }
474
+
475
+ function isVisible(el) {
476
+ if (!el || el.nodeType !== 1) return false;
477
+ const style = window.getComputedStyle(el);
478
+ if (style.display === 'none' || style.visibility === 'hidden' || style.opacity === '0') return false;
479
+ const rect = el.getBoundingClientRect();
480
+ return rect.width > 0 && rect.height > 0;
481
+ }
482
+
483
+ function walk(node, currentDepth) {
484
+ if (currentDepth > maxDepth || !node) return;
485
+ const children = node.children || [];
486
+ for (let i = 0; i < children.length; i++) {
487
+ const child = children[i];
488
+ if (!isVisible(child)) continue;
489
+
490
+ const role = getRole(child);
491
+ const testId = child.getAttribute('data-testid') || child.getAttribute('data-cy') || child.id || '';
492
+
493
+ if (role && (INTERACTIVE_ROLES.has(role) || testId)) {
494
+ aomNodes.push({
495
+ role: role,
496
+ name: getAccessibleName(child),
497
+ state: getState(child),
498
+ testId: testId || undefined,
499
+ depth: currentDepth
500
+ });
501
+ }
502
+
503
+ // Pierce Shadow DOM
504
+ if (child.shadowRoot) {
505
+ walk(child.shadowRoot, currentDepth + 1);
506
+ }
507
+ walk(child, currentDepth + 1);
508
+ }
509
+ }
510
+
511
+ walk(root === document ? document.body : root, 1);
512
+ return aomNodes;
513
+ },
514
+
515
+ /**
516
+ * 8. ARIA Snapshot (Playwright-MCP-style YAML serialization)
517
+ * Serializes the visible accessibility tree into the ARIA snapshot text
518
+ * format that MCP-style agents consume: `- role "name" [state] [ref=eN]`.
519
+ * (Format borrowed and adapted from microsoft/playwright-mcp, Apache-2.0.)
520
+ * @param {Element|Document} [root=document]
521
+ * @param {number} [maxDepth=6]
522
+ * @returns {string} YAML-style ARIA snapshot text (one node per line)
523
+ */
524
+ ariaSnapshot: function (root = document, maxDepth = 6) {
525
+ const lines = [];
526
+ let refCounter = 0;
527
+
528
+ function getRole(el) {
529
+ const explicitRole = el.getAttribute('role');
530
+ if (explicitRole) return explicitRole.toLowerCase();
531
+ const tag = el.tagName.toLowerCase();
532
+ if (tag === 'button') return 'button';
533
+ if (tag === 'a' && el.hasAttribute('href')) return 'link';
534
+ if (tag === 'input') {
535
+ const type = (el.getAttribute('type') || 'text').toLowerCase();
536
+ if (['checkbox', 'radio', 'button', 'submit'].includes(type)) return type;
537
+ return 'textbox';
538
+ }
539
+ if (tag === 'select') return 'combobox';
540
+ if (tag === 'textarea') return 'textbox';
541
+ if (tag === 'h1' || tag === 'h2' || tag === 'h3' || tag === 'h4' || tag === 'h5' || tag === 'h6') return 'heading';
542
+ if (tag === 'img') return 'img';
543
+ if (tag === 'ul' || tag === 'ol') return 'list';
544
+ if (tag === 'li') return 'listitem';
545
+ return null;
546
+ }
547
+
548
+ function getAccessibleName(el) {
549
+ return (
550
+ el.getAttribute('aria-label') ||
551
+ el.getAttribute('aria-placeholder') ||
552
+ el.getAttribute('placeholder') ||
553
+ el.getAttribute('title') ||
554
+ (el.innerText ? el.innerText.trim().slice(0, 80).replace(/\s+/g, ' ') : '') ||
555
+ el.getAttribute('alt') ||
556
+ ''
557
+ );
558
+ }
559
+
560
+ function isVisible(el) {
561
+ if (!el || el.nodeType !== 1) return false;
562
+ const style = window.getComputedStyle(el);
563
+ if (style.display === 'none' || style.visibility === 'hidden' || style.opacity === '0') return false;
564
+ const rect = el.getBoundingClientRect();
565
+ return rect.width > 0 && rect.height > 0;
566
+ }
567
+
568
+ function walk(node, depth) {
569
+ if (depth > maxDepth || !node) return;
570
+ const children = node.children || [];
571
+ for (let i = 0; i < children.length; i++) {
572
+ const child = children[i];
573
+ if (!isVisible(child)) continue;
574
+
575
+ const role = getRole(child);
576
+ if (role) {
577
+ refCounter += 1;
578
+ const rawName = getAccessibleName(child);
579
+ const namePart = rawName ? ' "' + rawName.replace(/"/g, "'") + '"' : '';
580
+ let states = '';
581
+ if (child.disabled || child.getAttribute('aria-disabled') === 'true') states += ' [disabled]';
582
+ if (child.getAttribute('aria-checked') === 'true') states += ' [checked]';
583
+ if (child.getAttribute('aria-expanded') !== null) {
584
+ states += child.getAttribute('aria-expanded') === 'true' ? ' [expanded]' : ' [collapsed]';
585
+ }
586
+ if (child.getAttribute('aria-selected') === 'true') states += ' [selected]';
587
+ const tagLower = child.tagName.toLowerCase();
588
+ const level = (role === 'heading' && /^h[1-6]$/.test(tagLower)) ? ' [level=' + tagLower[1] + ']' : '';
589
+ const testId = child.getAttribute('data-testid') || child.getAttribute('data-cy') || '';
590
+ const idPart = testId ? ' [testid=' + testId + ']' : '';
591
+ lines.push(' '.repeat(depth - 1) + '- ' + role + namePart + level + states + ' [ref=e' + refCounter + ']' + idPart);
592
+ }
593
+
594
+ // Pierce Shadow DOM
595
+ if (child.shadowRoot) {
596
+ walk(child.shadowRoot, depth + 1);
597
+ }
598
+ walk(child, depth + 1);
599
+ }
600
+ }
601
+
602
+ walk(root === document ? document.body : root, 1);
603
+ return lines.join('\n');
604
+ },
605
+
606
+ /**
607
+ * 8. Dynamic Stability Probe (Event-Driven Wait Weaver)
608
+ * Replaces flaky static sleeps (Thread.sleep / cy.wait) by dynamically probing:
609
+ * 1. Coordinate / Layout Stability: Bounding rect unchanged for 100ms consecutive duration.
610
+ * 2. Form Editable State: Ensures form inputs are editable (!disabled && !readOnly).
611
+ * 3. Network Quiescence: Ensures active in-flight network requests == 0.
612
+ * @param {string|Element} target
613
+ * @param {Object} [options]
614
+ * @returns {Promise<boolean>}
615
+ */
616
+ probeStability: function (target, options = {}) {
617
+ const opts = Object.assign({
618
+ checkPosition: true,
619
+ checkEditable: false,
620
+ stabilityDuration: 100,
621
+ timeout: 5000
622
+ }, options);
623
+
624
+ return new Promise((resolve) => {
625
+ const startTime = Date.now();
626
+ let el = null;
627
+ if (typeof target === 'string') {
628
+ el = document.querySelector(target);
629
+ } else if (target && target.nodeType === 1) {
630
+ el = target;
631
+ }
632
+
633
+ let lastRect = null;
634
+ let stableSince = null;
635
+
636
+ function check() {
637
+ const now = Date.now();
638
+ if (now - startTime > opts.timeout) {
639
+ return resolve(false);
640
+ }
641
+
642
+ if (!el && typeof target === 'string') {
643
+ el = document.querySelector(target);
644
+ }
645
+
646
+ if (el) {
647
+ if (opts.checkEditable) {
648
+ const tag = el.tagName.toLowerCase();
649
+ if (tag === 'input' || tag === 'textarea' || tag === 'select') {
650
+ if (el.disabled || el.readOnly) {
651
+ return setTimeout(check, 25);
652
+ }
653
+ }
654
+ }
655
+
656
+ if (opts.checkPosition) {
657
+ const rect = el.getBoundingClientRect();
658
+ if (
659
+ lastRect &&
660
+ Math.abs(rect.top - lastRect.top) < 1 &&
661
+ Math.abs(rect.left - lastRect.left) < 1 &&
662
+ Math.abs(rect.width - lastRect.width) < 1 &&
663
+ Math.abs(rect.height - lastRect.height) < 1
664
+ ) {
665
+ if (!stableSince) stableSince = now;
666
+ if (now - stableSince >= opts.stabilityDuration) {
667
+ return resolve(true);
668
+ }
669
+ } else {
670
+ lastRect = rect;
671
+ stableSince = null;
672
+ }
673
+ return setTimeout(check, 25);
674
+ }
675
+ }
676
+
677
+ if (activeNetworkRequests === 0) {
678
+ return resolve(true);
679
+ }
680
+ setTimeout(check, 25);
681
+ }
682
+
683
+ check();
684
+ });
685
+ },
686
+
687
+ /**
688
+ * 9. DFSDT Backtracking Locator Resolver (ToolBench / Master Locator Hierarchy Pattern)
689
+ * Executes Depth-First Search across 6 architectural locator tiers when a selector fails or goes stale.
690
+ * Evaluates DOM presence, visibility, and clickability before returning the resilient candidate.
691
+ * @param {Object|string} spec { testId, role, text, formControl, id, css } or broken selector string
692
+ * @returns {Object} { resolved: boolean, tier: number, selector: string, element: HTMLElement|null }
693
+ */
694
+ dfsdtResolve: function (spec) {
695
+ if (typeof document === 'undefined') {
696
+ return { resolved: false, tier: 0, selector: null, element: null };
697
+ }
698
+ const candidates = [];
699
+ if (typeof spec === 'string') {
700
+ const clean = spec.replace(/['"\\\[\]]/g, '').trim();
701
+ candidates.push({ tier: 1, sel: `[data-testid="${clean}"]` });
702
+ candidates.push({ tier: 2, sel: `[role="button"][name="${clean}"], [role="textbox"][name="${clean}"]` });
703
+ candidates.push({ tier: 2, sel: `button:has-text("${clean}"), a:has-text("${clean}")` });
704
+ candidates.push({ tier: 3, sel: `[formcontrolname="${clean}"]` });
705
+ candidates.push({ tier: 3, sel: `[name="${clean}"]` });
706
+ candidates.push({ tier: 4, sel: `#${clean}` });
707
+ } else if (spec && typeof spec === 'object') {
708
+ if (spec.testId) candidates.push({ tier: 1, sel: `[data-testid="${spec.testId}"]` });
709
+ if (spec.role && spec.name) candidates.push({ tier: 1, sel: `[role="${spec.role}"][name="${spec.name}"]` });
710
+ if (spec.text) candidates.push({ tier: 2, sel: `button:has-text("${spec.text}"), a:has-text("${spec.text}"), span:has-text("${spec.text}")` });
711
+ if (spec.formControl) candidates.push({ tier: 3, sel: `[formcontrolname="${spec.formControl}"]` });
712
+ if (spec.name) candidates.push({ tier: 3, sel: `[name="${spec.name}"]` });
713
+ if (spec.id) candidates.push({ tier: 4, sel: `#${spec.id}` });
714
+ if (spec.css) candidates.push({ tier: 5, sel: spec.css });
715
+ }
716
+
717
+ // DFSDT Backtracking evaluation
718
+ for (const cand of candidates) {
719
+ try {
720
+ const els = Array.from(document.querySelectorAll(cand.sel));
721
+ for (const el of els) {
722
+ const rect = el.getBoundingClientRect();
723
+ const isVisible = !!(rect.width > 0 && rect.height > 0 && window.getComputedStyle(el).display !== 'none' && window.getComputedStyle(el).visibility !== 'hidden');
724
+ if (isVisible) {
725
+ return {
726
+ resolved: true,
727
+ tier: cand.tier,
728
+ selector: cand.sel,
729
+ element: el
730
+ };
731
+ }
732
+ }
733
+ } catch (e) {
734
+ // Backtrack to next candidate tier
735
+ continue;
736
+ }
737
+ }
738
+
739
+ return { resolved: false, tier: 0, selector: null, element: null };
740
+ }
741
+ };
742
+
743
+ window.__qa = qa;
744
+ window.__helper = qa;
745
+ return qa;
746
+ })();