@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.
- package/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +172 -0
- package/README.md +171 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +197 -0
- package/docs/ARCHITECTURE.md +198 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +175 -0
- package/docs/CLI_REFERENCE.md +177 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +121 -0
- package/docs/QUALITY_GATES.md +121 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1359 -0
- package/docs/schemas/synapse.config.schema.json +87 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +32 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2079 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +258 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +184 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2419 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +307 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +724 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1259 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- 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"" if before_img else b_src
|
|
98
|
+
a_display = f"" 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" \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] 11 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
|
+
}
|