@teevee98/synapse-hub 0.0.0-stage → 3.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +171 -0
  190. package/README.md +170 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +198 -0
  196. package/docs/ARCHITECTURE.md +199 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +31 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2074 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2403 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +306 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +725 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1271 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,28 @@
1
+ """
2
+ Synapse Hub — Self-Healing & Autonomous Repair Engines (tools.heal)
3
+ -------------------------------------------------------------------
4
+ Domain package grouping all locator repair, AOM semantic diffing,
5
+ episodic Reflexion memory, and agentless patching tools.
6
+ """
7
+
8
+ from tools import (
9
+ agentless_patcher,
10
+ auto_heal,
11
+ auto_heal_reflexion,
12
+ cache_resolver,
13
+ ci_healing_hook,
14
+ heal_pr_automator,
15
+ heuristic_locator_matcher,
16
+ reversible_sandbox,
17
+ )
18
+
19
+ __all__ = [
20
+ "agentless_patcher",
21
+ "auto_heal",
22
+ "auto_heal_reflexion",
23
+ "cache_resolver",
24
+ "ci_healing_hook",
25
+ "heal_pr_automator",
26
+ "heuristic_locator_matcher",
27
+ "reversible_sandbox",
28
+ ]
@@ -0,0 +1,220 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Enterprise Self-Healing Confidence Scorer & PR Automator
4
+ ---------------------------------------------------------
5
+ Calculates composite multi-modal confidence scores for self-healed locators:
6
+ Score = 0.4 * AOM + 0.3 * Spatial + 0.3 * Visual
7
+ When Confidence >= 90%, automates Git branch creation and generates a verifiable
8
+ Pull Request description with visual diff metrics, before/after evidence, and
9
+ Playwright trace artifacts to allow Tech Leads to review and merge in < 5 seconds.
10
+ """
11
+
12
+ import os
13
+ import sys
14
+ import json
15
+ import argparse
16
+ from datetime import datetime
17
+ from typing import Dict, Any, Optional
18
+
19
+ SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
20
+ if SCRIPT_DIR not in sys.path:
21
+ sys.path.insert(0, SCRIPT_DIR)
22
+ import ci_healing_hook
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
+
33
+ def calculate_healing_confidence(aom_score: float, spatial_score: float, visual_score: float) -> Dict[str, Any]:
34
+ """
35
+ Computes composite confidence rating from 3 orthogonal verification vectors.
36
+ """
37
+ aom = max(0.0, min(1.0, float(aom_score)))
38
+ spatial = max(0.0, min(1.0, float(spatial_score)))
39
+ visual = max(0.0, min(1.0, float(visual_score)))
40
+
41
+ # Composite weighted formula
42
+ composite = round((0.40 * aom) + (0.30 * spatial) + (0.30 * visual), 4)
43
+ percentage = round(composite * 100.0, 1)
44
+
45
+ qualified_for_pr = percentage >= 90.0
46
+
47
+ return {
48
+ "composite_score": composite,
49
+ "confidence_percentage": percentage,
50
+ "qualified_for_pr": qualified_for_pr,
51
+ "vectors": {
52
+ "aom_semantic": aom,
53
+ "spatial_geometry": spatial,
54
+ "visual_similarity": visual
55
+ },
56
+ "risk_tier": "LOW_RISK" if percentage >= 90.0 else ("MEDIUM_RISK" if percentage >= 75.0 else "HIGH_RISK")
57
+ }
58
+
59
+
60
+ def generate_pr_draft(
61
+ page_file: str,
62
+ old_locator: str,
63
+ new_locator: str,
64
+ confidence_info: Dict[str, Any],
65
+ trace_zip: Optional[str] = None,
66
+ before_img: Optional[str] = None,
67
+ after_img: Optional[str] = None,
68
+ diff_img: Optional[str] = None
69
+ ) -> Dict[str, str]:
70
+ """
71
+ Generates structured PR branch name, commit title, and markdown description
72
+ including Playwright Trace links and visual Before/After diff evidence.
73
+ """
74
+ timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
75
+ clean_name = os.path.splitext(os.path.basename(page_file))[0].lower().replace(" ", "_")
76
+ branch_name = f"heal/{clean_name}_{timestamp}"
77
+
78
+ pr_title = f"fix(locator): heal stale selector in {os.path.basename(page_file)} [{confidence_info['confidence_percentage']}% Match]"
79
+
80
+ # Optional Visual Evidence Block
81
+ evidence_sections = []
82
+ if trace_zip or before_img or after_img or diff_img:
83
+ evidence_sections.append("---")
84
+ evidence_sections.append("#### 4. 🔍 Playwright Trace & Visual Inspection Evidence")
85
+ evidence_sections.append("> **Tech Lead 5-Second Review:** High-fidelity visual and timeline proof for confident zero-hesitation merging.\n")
86
+
87
+ if trace_zip:
88
+ evidence_sections.append(f"- **Playwright Trace Archive:** `{trace_zip}`")
89
+ evidence_sections.append(" - Replay full DOM snapshots, console logs, and network timeline locally:")
90
+ evidence_sections.append(" ```bash")
91
+ evidence_sections.append(f" npx playwright show-trace \"{trace_zip}\"")
92
+ evidence_sections.append(" ```\n")
93
+
94
+ if before_img or after_img:
95
+ b_src = before_img if before_img else "N/A (Broken state captured in logs)"
96
+ a_src = after_img if after_img else "N/A (Healed state verified via runner)"
97
+ b_display = f"![{clean_name}_before]({b_src})" if before_img else b_src
98
+ a_display = f"![{clean_name}_after]({a_src})" if after_img else a_src
99
+
100
+ evidence_sections.append("- **Visual Element State (Before vs After):**\n")
101
+ evidence_sections.append("| Before (Broken / Stale Locator) | After (Healed & Verified Locator) |")
102
+ evidence_sections.append("| :---: | :---: |")
103
+ evidence_sections.append(f"| {b_display} | {a_display} |\n")
104
+
105
+ if diff_img:
106
+ evidence_sections.append("- **Visual Diff Heatmap / SSIM Overlay:**")
107
+ evidence_sections.append(f" ![{clean_name}_diff]({diff_img})\n")
108
+
109
+ evidence_markdown = "\n".join(evidence_sections)
110
+ if evidence_markdown:
111
+ evidence_markdown = "\n" + evidence_markdown
112
+
113
+ checklist_trace = "- [x] Playwright Trace / Visual Diff evidence attached for instant review" if (trace_zip or before_img or after_img) else "- [ ] Playwright Trace artifact (Optional)"
114
+
115
+ pr_body = fr"""### 🛡️ Automated Self-Healing Verification PR
116
+
117
+ > **Origin:** Enterprise Autonomous QA Sentinel
118
+ > **Confidence Rating:** `{confidence_info['confidence_percentage']}%` ({confidence_info['risk_tier']})
119
+ > **Zero Silent Drift Guarantee:** This change was isolated to prevent undocumented modifications on `main`.
120
+
121
+ ---
122
+
123
+ #### 1. Locator Mutation Summary
124
+ - **Target Page Class:** `{page_file}`
125
+ - **Broken / Stale Locator:**
126
+ ```xpath
127
+ {old_locator}
128
+ ```
129
+ - **Healed / Resilient Locator:**
130
+ ```xpath
131
+ {new_locator}
132
+ ```
133
+
134
+ ---
135
+
136
+ #### 2. Multi-Modal Confidence Breakdown
137
+ | Verification Vector | Weight | Score | Evaluation Criteria |
138
+ | :--- | :---: | :---: | :--- |
139
+ | **Accessibility Tree (AOM)** | 40% | `{confidence_info['vectors']['aom_semantic'] * 100:.1f}%` | Role, accessible name, and ARIA attributes matched |
140
+ | **Spatial Relationship** | 30% | `{confidence_info['vectors']['spatial_geometry'] * 100:.1f}%` | Bounding box coordinates & neighboring anchor alignment |
141
+ | **Visual Similarity** | 30% | `{confidence_info['vectors']['visual_similarity'] * 100:.1f}%` | Pixel histogram & SSIM rendering invariant |
142
+
143
+ ---
144
+
145
+ #### 3. Verification Checklist
146
+ - [x] Confidence score meets threshold ($\ge 90\%$)
147
+ - [x] Tested with `python tools/test_impact.py` on impacted test cases
148
+ - [x] 10 Quality Gates DoD satisfied
149
+ {checklist_trace}{evidence_markdown}
150
+ """
151
+ return {
152
+ "branch_name": branch_name,
153
+ "pr_title": pr_title,
154
+ "pr_body": pr_body
155
+ }
156
+
157
+
158
+ def main():
159
+ parser = argparse.ArgumentParser(description="Self-Healing Confidence Scorer & PR Automator")
160
+ parser.add_argument("--page", required=True, help="Target Page Class file path")
161
+ parser.add_argument("--old", required=True, help="Original/stale locator string")
162
+ parser.add_argument("--new", required=True, help="Healed replacement locator string")
163
+ parser.add_argument("--aom", type=float, default=0.95, help="AOM semantic score (0.0 - 1.0)")
164
+ parser.add_argument("--spatial", type=float, default=0.90, help="Spatial geometry score (0.0 - 1.0)")
165
+ parser.add_argument("--visual", type=float, default=0.92, help="Visual similarity score (0.0 - 1.0)")
166
+ parser.add_argument("--trace-zip", default=None, help="Path to Playwright trace zip file")
167
+ parser.add_argument("--before-img", default=None, help="Path to screenshot before healing (broken/stale)")
168
+ parser.add_argument("--after-img", default=None, help="Path to screenshot after healing (verified)")
169
+ parser.add_argument("--diff-img", default=None, help="Path to visual diff / overlay screenshot")
170
+ parser.add_argument("--ci-hook", action="store_true", help="Execute CI/CD silent in-place healing and draft generation")
171
+ parser.add_argument("--json", action="store_true", help="Output raw JSON plan")
172
+ args = parser.parse_args()
173
+
174
+ conf = calculate_healing_confidence(args.aom, args.spatial, args.visual)
175
+
176
+ if args.ci_hook:
177
+ res = ci_healing_hook.CIHealingHook.evaluate_and_heal(
178
+ file_path=args.page,
179
+ failed_locator=args.old,
180
+ healed_locator=args.new,
181
+ confidence=conf["composite_score"]
182
+ )
183
+ if args.json:
184
+ print(json.dumps(res, indent=2))
185
+ else:
186
+ print("\n======================================================================")
187
+ print(f" CI/CD SILENT SELF-HEALING HOOK EXECUTED ({conf['risk_tier']})")
188
+ print("======================================================================")
189
+ print(f" Branch Name : {res['branch']}")
190
+ print(f" PR Title : {res['pr_title']}")
191
+ print(f" Confidence : {conf['confidence_percentage']}%")
192
+ print(f" Target File : {res['file']}")
193
+ return 0
194
+ pr = generate_pr_draft(
195
+ page_file=args.page,
196
+ old_locator=args.old,
197
+ new_locator=args.new,
198
+ confidence_info=conf,
199
+ trace_zip=args.trace_zip,
200
+ before_img=args.before_img,
201
+ after_img=args.after_img,
202
+ diff_img=args.diff_img
203
+ )
204
+
205
+ if args.json:
206
+ print(json.dumps({"confidence": conf, "pr": pr}, indent=2))
207
+ else:
208
+ print("\n======================================================================")
209
+ print(f" SELF-HEALING CONFIDENCE SCORE: {conf['confidence_percentage']}% ({conf['risk_tier']})")
210
+ print("======================================================================")
211
+ print(f" Branch Name : {pr['branch_name']}")
212
+ print(f" PR Title : {pr['pr_title']}")
213
+ print(f" Qualified : {'✅ YES (Auto-PR Recommended)' if conf['qualified_for_pr'] else '⚠️ NO (Manual QA Review Needed)'}\n")
214
+ print("PR Description Preview:\n" + pr["pr_body"])
215
+
216
+ return 0 if conf["qualified_for_pr"] else 1
217
+
218
+
219
+ if __name__ == "__main__":
220
+ sys.exit(main())
@@ -0,0 +1,351 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ 3-Layer Heuristic Locator Matcher (0-Token Autonomous Recovery)
4
+ --------------------------------------------------------------
5
+ Resolves broken locators in under 15ms with 0 API tokens using a 3-layer
6
+ deterministic static fallback cascade:
7
+ Layer 1: Exact Attribute & Snapshot Cache Matching (1ms, ~98% conf)
8
+ Layer 2: Levenshtein Distance & AOM Text Semantic Matching (5ms, ~90% conf)
9
+ Layer 3: Geometric Relative Matching + Spatial Anchor Proximity (10ms, ~86% conf)
10
+ Layer 4: Fallback to LLM agent only if confidence < 85%.
11
+
12
+ Layer 3 geometric semantics (concept borrowed from Selenium's relative
13
+ locators, Apache-2.0 - re-implemented stdlib-only): pass
14
+ `relative={"relation": "above"|"below"|"near"|"left-of"|"right-of",
15
+ "anchor": "#id-or-selector"}` and the matcher picks the interactive element
16
+ satisfying the geometric relation to the anchor's bounding box. Snapshots
17
+ without bounding boxes fall back to the order-based anchor heuristic.
18
+ """
19
+
20
+ import math
21
+ import re
22
+ import time
23
+ from typing import Dict, List, Any, Optional, Tuple
24
+
25
+ INTERACTIVE_TAGS = {"button", "a", "input", "select", "textarea"}
26
+ GEOMETRY_TOLERANCE_PX = 8.0
27
+ NEAR_DISTANCE_PX = 250.0
28
+
29
+
30
+ def levenshtein_distance(s1: str, s2: str) -> int:
31
+ """Computes Levenshtein edit distance between two strings."""
32
+ if s1 == s2:
33
+ return 0
34
+ if not s1:
35
+ return len(s2)
36
+ if not s2:
37
+ return len(s1)
38
+
39
+ v0 = list(range(len(s2) + 1))
40
+ v1 = [0] * (len(s2) + 1)
41
+
42
+ for i in range(len(s1)):
43
+ v1[0] = i + 1
44
+ for j in range(len(s2)):
45
+ cost = 0 if s1[i] == s2[j] else 1
46
+ v1[j + 1] = min(v1[j] + 1, v0[j + 1] + 1, v0[j] + cost)
47
+ v0 = list(v1)
48
+
49
+ return v1[len(s2)]
50
+
51
+
52
+ def levenshtein_ratio(s1: str, s2: str) -> float:
53
+ """Computes similarity ratio between 0.0 and 1.0."""
54
+ s1_norm = s1.lower().strip()
55
+ s2_norm = s2.lower().strip()
56
+ if s1_norm == s2_norm:
57
+ return 1.0
58
+ max_len = max(len(s1_norm), len(s2_norm))
59
+ if max_len == 0:
60
+ return 1.0
61
+ dist = levenshtein_distance(s1_norm, s2_norm)
62
+ return max(0.0, 1.0 - (dist / max_len))
63
+
64
+
65
+ class HeuristicLocatorMatcher:
66
+ """Cascade matcher resolving broken locators before LLM invocation."""
67
+
68
+ CONFIDENCE_THRESHOLD = 0.85
69
+
70
+ @staticmethod
71
+ def _get_bbox(el: Dict[str, Any]) -> Optional[Tuple[float, float, float, float]]:
72
+ """Extracts (x, y, width, height) from a snapshot element, or None."""
73
+ for keys in (
74
+ ("x", "y", "width", "height"),
75
+ ("left", "top", "width", "height"),
76
+ ):
77
+ if all(k in el for k in keys):
78
+ return (float(el[keys[0]]), float(el[keys[1]]), float(el[keys[2]]), float(el[keys[3]]))
79
+ bbox = el.get("bbox")
80
+ if isinstance(bbox, dict) and all(k in bbox for k in ("x", "y", "width", "height")):
81
+ return (float(bbox["x"]), float(bbox["y"]),
82
+ float(bbox["width"]), float(bbox["height"]))
83
+ return None
84
+
85
+ @staticmethod
86
+ def _center_distance(bbox_a: Tuple[float, float, float, float],
87
+ bbox_b: Tuple[float, float, float, float]) -> float:
88
+ """Euclidean distance between the centers of two bounding boxes."""
89
+ ax = bbox_a[0] + bbox_a[2] / 2.0
90
+ ay = bbox_a[1] + bbox_a[3] / 2.0
91
+ bx = bbox_b[0] + bbox_b[2] / 2.0
92
+ by = bbox_b[1] + bbox_b[3] / 2.0
93
+ return math.hypot(ax - bx, ay - by)
94
+
95
+ @staticmethod
96
+ def _satisfies_relation(el_bbox: Tuple[float, float, float, float],
97
+ anchor_bbox: Tuple[float, float, float, float],
98
+ relation: str) -> bool:
99
+ """True when el_bbox stands in the requested relation to anchor_bbox."""
100
+ tol = GEOMETRY_TOLERANCE_PX
101
+ ex, ey, ew, eh = el_bbox
102
+ ax, ay, aw, ah = anchor_bbox
103
+ if relation == "above":
104
+ return ey + eh <= ay + tol
105
+ if relation == "below":
106
+ return ey >= ay + ah - tol
107
+ if relation == "left-of":
108
+ return ex + ew <= ax + tol
109
+ if relation == "right-of":
110
+ return ex >= ax + aw - tol
111
+ if relation == "near":
112
+ return HeuristicLocatorMatcher._center_distance(el_bbox, anchor_bbox) <= NEAR_DISTANCE_PX
113
+ return False
114
+
115
+ @staticmethod
116
+ def _find_anchor_element(dom_snapshot: List[Dict[str, Any]],
117
+ anchor_selector: str) -> Optional[Dict[str, Any]]:
118
+ """Finds the anchor element by id / selector / data-testid."""
119
+ bare = anchor_selector.lstrip("#")
120
+ for el in dom_snapshot:
121
+ if (el.get("id") == bare
122
+ or el.get("selector") == anchor_selector
123
+ or (el.get("data-testid") or el.get("test-id")) == bare):
124
+ return el
125
+ return None
126
+
127
+ @staticmethod
128
+ def _parse_relative_request(
129
+ relative: Optional[Dict[str, Any]],
130
+ spatial_anchor: Optional[str]
131
+ ) -> Tuple[Optional[str], Optional[str]]:
132
+ """Normalizes legacy spatial_anchor and the relative dict into
133
+ (relation, anchor_selector). Legacy anchors behave as 'below'."""
134
+ if isinstance(relative, dict) and relative.get("relation") and relative.get("anchor"):
135
+ return str(relative["relation"]).lower(), str(relative["anchor"])
136
+ if spatial_anchor:
137
+ return "below", spatial_anchor
138
+ return None, None
139
+
140
+ @classmethod
141
+ def match(
142
+ cls,
143
+ broken_locator: str,
144
+ dom_snapshot: List[Dict[str, Any]],
145
+ cache_entry: Optional[Dict[str, Any]] = None,
146
+ spatial_anchor: Optional[str] = None,
147
+ relative: Optional[Dict[str, Any]] = None
148
+ ) -> Dict[str, Any]:
149
+ """
150
+ Executes the 3-Layer 0-token matching cascade.
151
+ Returns a dictionary with match result, confidence, layer, and execution time.
152
+ """
153
+ start_time = time.perf_counter()
154
+
155
+ # Extract keyword cues from broken locator
156
+ quoted_m = re.findall(r"['\"]([^'\"]+)['\"]", broken_locator)
157
+ if quoted_m:
158
+ primary_keyword = quoted_m[0].lower().strip()
159
+ else:
160
+ tokens = [
161
+ t.lower() for t in re.split(r"[-_#.\s//\[\]@'\"=()]+", broken_locator)
162
+ if len(t) > 2 and t.lower() not in [
163
+ "button", "input", "div", "span", "old", "new", "text", "contains",
164
+ "normalize-space", "has-text", "xpath", "btn", "txt"
165
+ ]
166
+ ]
167
+ primary_keyword = tokens[0] if tokens else broken_locator.lower().strip()
168
+
169
+ # ---------------------------------------------------------------------
170
+ # Layer 1: Exact Match on Snapshot Cache / Stable Attributes (1ms)
171
+ # ---------------------------------------------------------------------
172
+ if cache_entry and cache_entry.get("healed_locator"):
173
+ elapsed_ms = (time.perf_counter() - start_time) * 1000
174
+ return {
175
+ "matched": True,
176
+ "layer": 1,
177
+ "strategy": "EXACT_CACHE_MATCH",
178
+ "healed_locator": cache_entry["healed_locator"],
179
+ "confidence": 0.98,
180
+ "needs_llm": False,
181
+ "execution_time_ms": round(elapsed_ms, 2)
182
+ }
183
+
184
+ for el in dom_snapshot:
185
+ # Check test-id (exact or semantic substring match)
186
+ testid = el.get("data-testid") or el.get("test-id")
187
+ if testid:
188
+ clean_broken = re.sub(r'[^a-zA-Z0-9]', '', broken_locator.lower())
189
+ clean_testid = re.sub(r'[^a-zA-Z0-9]', '', testid.lower())
190
+ if clean_broken in clean_testid or clean_testid in clean_broken or primary_keyword in testid.lower():
191
+ elapsed_ms = (time.perf_counter() - start_time) * 1000
192
+ return {
193
+ "matched": True,
194
+ "layer": 1,
195
+ "strategy": "EXACT_TESTID_ATTRIBUTE",
196
+ "healed_locator": f"[data-testid='{testid}']",
197
+ "confidence": 0.98,
198
+ "needs_llm": False,
199
+ "execution_time_ms": round(elapsed_ms, 2)
200
+ }
201
+ # Check aria-label or data-action match
202
+ aria = el.get("aria-label") or el.get("data-action")
203
+ if aria and (aria.lower() == primary_keyword or primary_keyword in aria.lower()):
204
+ elapsed_ms = (time.perf_counter() - start_time) * 1000
205
+ tag_prefix = el.get("tag", "button")
206
+ return {
207
+ "matched": True,
208
+ "layer": 1,
209
+ "strategy": "EXACT_ARIA_LABEL",
210
+ "healed_locator": f"{tag_prefix}[aria-label='{el.get('aria-label', aria)}']",
211
+ "confidence": 0.96,
212
+ "needs_llm": False,
213
+ "execution_time_ms": round(elapsed_ms, 2)
214
+ }
215
+
216
+ # ---------------------------------------------------------------------
217
+ # Layer 2: Levenshtein Distance & Text Semantic Matching (5ms)
218
+ # ---------------------------------------------------------------------
219
+ best_l2_elem = None
220
+ best_l2_ratio = 0.0
221
+
222
+ for el in dom_snapshot:
223
+ text = (el.get("text") or el.get("aria-label") or el.get("placeholder") or "").strip()
224
+ if not text:
225
+ continue
226
+
227
+ # Substring match (e.g. 'Submit Order' contains 'Submit')
228
+ if primary_keyword in text.lower():
229
+ ratio = 0.92
230
+ else:
231
+ ratio = levenshtein_ratio(primary_keyword, text)
232
+
233
+ if ratio > best_l2_ratio:
234
+ best_l2_ratio = ratio
235
+ best_l2_elem = el
236
+
237
+ if best_l2_elem and best_l2_ratio >= 0.70:
238
+ target_text = best_l2_elem.get("text") or best_l2_elem.get("aria-label")
239
+ tag = best_l2_elem.get("tag", "button")
240
+ healed = f"{tag}:has-text('{target_text}')"
241
+ confidence = min(0.95, 0.85 + (best_l2_ratio * 0.10))
242
+
243
+ if confidence >= cls.CONFIDENCE_THRESHOLD:
244
+ elapsed_ms = (time.perf_counter() - start_time) * 1000
245
+ return {
246
+ "matched": True,
247
+ "layer": 2,
248
+ "strategy": "TEXT_SEMANTIC_LEVENSHTEIN",
249
+ "healed_locator": healed,
250
+ "confidence": round(confidence, 2),
251
+ "needs_llm": False,
252
+ "execution_time_ms": round(elapsed_ms, 2)
253
+ }
254
+
255
+ # ---------------------------------------------------------------------
256
+ # Layer 3: Spatial Anchor Proximity & Unique Semantic Tag Fallback
257
+ # 3a. Geometric relative matching (bbox-aware, Selenium-style)
258
+ # 3b. Order-based anchor heuristic (bbox-free fallback)
259
+ # ---------------------------------------------------------------------
260
+ relation, anchor_selector = cls._parse_relative_request(relative, spatial_anchor)
261
+ if relation and anchor_selector:
262
+ anchor_el = cls._find_anchor_element(dom_snapshot, anchor_selector)
263
+ anchor_bbox = cls._get_bbox(anchor_el) if anchor_el is not None else None
264
+ if anchor_bbox is not None:
265
+ candidates = [
266
+ el for el in dom_snapshot
267
+ if el is not anchor_el
268
+ and (el.get("tag") or "").lower() in INTERACTIVE_TAGS
269
+ and cls._satisfies_relation(cls._get_bbox(el) or (0, 0, 0, 0), anchor_bbox, relation)
270
+ ]
271
+ candidates = [el for el in candidates if cls._get_bbox(el) is not None]
272
+ if candidates:
273
+ target = min(candidates, key=lambda el: cls._center_distance(cls._get_bbox(el) or (0.0, 0.0, 0.0, 0.0), anchor_bbox))
274
+ if target.get("id"):
275
+ healed = f"#{target['id']}"
276
+ elif target.get("data-testid") or target.get("test-id"):
277
+ healed = f"[data-testid='{target.get('data-testid') or target.get('test-id')}']"
278
+ else:
279
+ text = (target.get("text") or "").strip()
280
+ healed = f"{target.get('tag', 'button')}:has-text('{text[:40]}')" if text else target.get("tag", "button")
281
+ elapsed_ms = (time.perf_counter() - start_time) * 1000
282
+ return {
283
+ "matched": True,
284
+ "layer": 3,
285
+ "strategy": "GEOMETRIC_RELATIVE_MATCH",
286
+ "healed_locator": healed,
287
+ "confidence": 0.88,
288
+ "needs_llm": False,
289
+ "execution_time_ms": round(elapsed_ms, 2)
290
+ }
291
+ # bbox-free snapshots fall through to the order-based heuristic
292
+
293
+ if anchor_selector:
294
+ # Find element immediately adjacent/inside the anchor container
295
+ anchor_found = False
296
+ for idx, el in enumerate(dom_snapshot):
297
+ if anchor_found:
298
+ # Next interactive element after anchor
299
+ if el.get("tag") in ["button", "a", "input"]:
300
+ elapsed_ms = (time.perf_counter() - start_time) * 1000
301
+ target_loc = el.get("id") and f"#{el['id']}" or f"{el.get('tag')}:below('{anchor_selector}')"
302
+ return {
303
+ "matched": True,
304
+ "layer": 3,
305
+ "strategy": "SPATIAL_ANCHOR_PROXIMITY",
306
+ "healed_locator": target_loc,
307
+ "confidence": 0.86,
308
+ "needs_llm": False,
309
+ "execution_time_ms": round(elapsed_ms, 2)
310
+ }
311
+ if el.get("id") == anchor_selector.replace("#", "") or el.get("selector") == anchor_selector:
312
+ anchor_found = True
313
+
314
+ # Unique interactive element fallback (e.g. single CTA button or input in snapshot)
315
+ if len(dom_snapshot) == 1:
316
+ el = dom_snapshot[0]
317
+ tag = el.get("tag", "").lower()
318
+ text = (el.get("text") or "").lower()
319
+ is_interactive = tag in ["button", "input", "select", "a", "textarea"] or bool(el.get("type"))
320
+ has_keyword_match = bool(primary_keyword and (primary_keyword in text or primary_keyword in el.get("id", "").lower()))
321
+ if is_interactive or has_keyword_match:
322
+ if el.get("id"):
323
+ target_loc = f"#{el['id']}"
324
+ elif el.get("type"):
325
+ target_loc = f"{el.get('tag', 'button')}[type='{el['type']}']"
326
+ else:
327
+ target_loc = el.get("tag", "button")
328
+ elapsed_ms = (time.perf_counter() - start_time) * 1000
329
+ return {
330
+ "matched": True,
331
+ "layer": 3,
332
+ "strategy": "UNIQUE_DOM_ELEMENT",
333
+ "healed_locator": target_loc,
334
+ "confidence": 0.90,
335
+ "needs_llm": False,
336
+ "execution_time_ms": round(elapsed_ms, 2)
337
+ }
338
+
339
+ # ---------------------------------------------------------------------
340
+ # Layer 4: Fallback to LLM (< 85% confidence)
341
+ # ---------------------------------------------------------------------
342
+ elapsed_ms = (time.perf_counter() - start_time) * 1000
343
+ return {
344
+ "matched": False,
345
+ "layer": 4,
346
+ "strategy": "FALLBACK_LLM_REQUIRED",
347
+ "healed_locator": None,
348
+ "confidence": round(best_l2_ratio, 2) if best_l2_ratio else 0.0,
349
+ "needs_llm": True,
350
+ "execution_time_ms": round(elapsed_ms, 2)
351
+ }