@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.
- 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 +171 -0
- package/README.md +170 -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 +198 -0
- package/docs/ARCHITECTURE.md +199 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +174 -0
- package/docs/CLI_REFERENCE.md +176 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +118 -0
- package/docs/QUALITY_GATES.md +118 -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 +1358 -0
- package/docs/schemas/synapse.config.schema.json +86 -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 +31 -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 +2074 -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 +262 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +190 -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 +2403 -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 +306 -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 +725 -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 +1271 -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,532 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-FileCopyrightText: Copyright (c) 2026 Thįŗæ Vį» (@TeeVee98). All rights reserved.
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
# Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
|
|
5
|
+
|
|
6
|
+
"""
|
|
7
|
+
Multi-Trial Episodic Reflexion Loop for Autonomous Healing (Noah Shinn / Reflexion Pattern)
|
|
8
|
+
------------------------------------------------------------------------------------------
|
|
9
|
+
Replaces single-shot heuristic locator healing with an iterative, multi-trial reflection
|
|
10
|
+
loop (K=3). When a test fails:
|
|
11
|
+
1. Evaluator extracts failure stacktrace & symptom.
|
|
12
|
+
2. AOM Context Analyzer extracts and prunes a compact Accessibility Object Model
|
|
13
|
+
subtree (< 500 tokens) surrounding the failing locator.
|
|
14
|
+
3. Reflexion Generator creates a structured 2-line verbal diagnosis and prompt semantic
|
|
15
|
+
reasoning conditioned on live accessibility roles and states.
|
|
16
|
+
4. Memory Buffer accumulates trials across attempts.
|
|
17
|
+
5. Actor synthesizes adaptive Clean POM locator patches (getByRole, getByLabel, getByTestId).
|
|
18
|
+
6. Upon pass -> records to positive cache (healing_cache & lessons_learned).
|
|
19
|
+
7. Upon exhaustion of K=3 -> records to negative cache (failed_fixes) to block blind retries.
|
|
20
|
+
|
|
21
|
+
Reference:
|
|
22
|
+
- Noah Shinn et al. (Reflexion: Language Agents with Verbal Reinforcement Learning).
|
|
23
|
+
- Synapse-Hub Subsystem 2: Section 6.3 of agent_skill_training_analysis.md.
|
|
24
|
+
"""
|
|
25
|
+
|
|
26
|
+
import os
|
|
27
|
+
import sys
|
|
28
|
+
import re
|
|
29
|
+
import json
|
|
30
|
+
import argparse
|
|
31
|
+
from dataclasses import dataclass
|
|
32
|
+
from typing import List, Optional, Callable, Tuple, Dict, Any
|
|
33
|
+
|
|
34
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
35
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
36
|
+
try:
|
|
37
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
38
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
39
|
+
except Exception:
|
|
40
|
+
pass
|
|
41
|
+
|
|
42
|
+
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
|
|
43
|
+
if SCRIPT_DIR not in sys.path:
|
|
44
|
+
sys.path.insert(0, SCRIPT_DIR)
|
|
45
|
+
|
|
46
|
+
try:
|
|
47
|
+
import cache_resolver
|
|
48
|
+
except ImportError:
|
|
49
|
+
from tools import cache_resolver
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
@dataclass
|
|
53
|
+
class ReflexionTrial:
|
|
54
|
+
trial_number: int
|
|
55
|
+
patch_attempt: str
|
|
56
|
+
error_feedback: str
|
|
57
|
+
verbal_reflection: str
|
|
58
|
+
is_passing: bool
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def prune_aom_tree(aom_data: Any, target_selector: str = "", max_chars: int = 1800) -> Dict[str, Any]:
|
|
62
|
+
"""
|
|
63
|
+
Prunes an Accessibility Object Model (AOM) tree down to a compact, semantically dense
|
|
64
|
+
subtree surrounding the target element (< 500 tokens / ~1800 characters).
|
|
65
|
+
Preserves role, name, disabled, expanded, selected, checked, and testId.
|
|
66
|
+
"""
|
|
67
|
+
if isinstance(aom_data, str):
|
|
68
|
+
try:
|
|
69
|
+
aom_data = json.loads(aom_data)
|
|
70
|
+
except Exception:
|
|
71
|
+
# Fallback: clean string representation capped to budget
|
|
72
|
+
clean_str = aom_data.strip()[:max_chars]
|
|
73
|
+
return {"type": "raw_aom_text", "content": clean_str}
|
|
74
|
+
|
|
75
|
+
sel_tokens = [
|
|
76
|
+
tok.lower() for tok in re.split(r'[^a-zA-Z0-9_]', target_selector.lower())
|
|
77
|
+
if len(tok) >= 3 and tok.lower() not in {"button", "input", "div", "span", "select", "table", "form", "page", "locator"}
|
|
78
|
+
]
|
|
79
|
+
|
|
80
|
+
def _clean_node(node: Any, depth: int = 0) -> Optional[Dict[str, Any]]:
|
|
81
|
+
if depth > 4 or not isinstance(node, dict):
|
|
82
|
+
return None
|
|
83
|
+
|
|
84
|
+
# Extract only salient accessibility properties
|
|
85
|
+
cleaned: Dict[str, Any] = {}
|
|
86
|
+
for key in ["role", "name", "aria-label", "label", "text", "testId", "data-testid", "id"]:
|
|
87
|
+
if key in node and node[key]:
|
|
88
|
+
cleaned[key] = str(node[key])[:80]
|
|
89
|
+
|
|
90
|
+
for state_key in ["disabled", "expanded", "selected", "checked", "focused", "modal"]:
|
|
91
|
+
if state_key in node:
|
|
92
|
+
cleaned[state_key] = bool(node[state_key])
|
|
93
|
+
|
|
94
|
+
# Recurse children
|
|
95
|
+
children = node.get("children") or node.get("nodes") or []
|
|
96
|
+
if isinstance(children, list) and depth < 4:
|
|
97
|
+
clean_children = []
|
|
98
|
+
for child in children:
|
|
99
|
+
c_clean = _clean_node(child, depth + 1)
|
|
100
|
+
if c_clean:
|
|
101
|
+
clean_children.append(c_clean)
|
|
102
|
+
if len(clean_children) >= 12:
|
|
103
|
+
break
|
|
104
|
+
if clean_children:
|
|
105
|
+
cleaned["children"] = clean_children
|
|
106
|
+
|
|
107
|
+
return cleaned if cleaned else None
|
|
108
|
+
|
|
109
|
+
if isinstance(aom_data, list):
|
|
110
|
+
pruned_nodes = []
|
|
111
|
+
for n in aom_data:
|
|
112
|
+
cleaned = _clean_node(n, depth=0)
|
|
113
|
+
if cleaned:
|
|
114
|
+
pruned_nodes.append(cleaned)
|
|
115
|
+
if len(pruned_nodes) >= 8:
|
|
116
|
+
break
|
|
117
|
+
result: Dict[str, Any] = {"aom_nodes": pruned_nodes}
|
|
118
|
+
elif isinstance(aom_data, dict):
|
|
119
|
+
result = _clean_node(aom_data, depth=0) or {}
|
|
120
|
+
else:
|
|
121
|
+
result = {"aom_data": str(aom_data)[:max_chars]}
|
|
122
|
+
|
|
123
|
+
# Ensure token budget: truncate children safely without dropping the whole tree
|
|
124
|
+
serialized = json.dumps(result, ensure_ascii=False)
|
|
125
|
+
if len(serialized) > max_chars:
|
|
126
|
+
if "aom_nodes" in result and isinstance(result["aom_nodes"], list):
|
|
127
|
+
result["aom_nodes"] = result["aom_nodes"][:3]
|
|
128
|
+
elif "children" in result and isinstance(result["children"], list):
|
|
129
|
+
result["children"] = result["children"][:2]
|
|
130
|
+
for c in result["children"]:
|
|
131
|
+
if isinstance(c, dict) and "children" in c and isinstance(c["children"], list):
|
|
132
|
+
c["children"] = c["children"][:3]
|
|
133
|
+
result["notice"] = "Pruned to < 500 token budget"
|
|
134
|
+
serialized = json.dumps(result, ensure_ascii=False)
|
|
135
|
+
if len(serialized) > max_chars and "children" in result and isinstance(result["children"], list):
|
|
136
|
+
result["children"] = result["children"][:1]
|
|
137
|
+
for c in result["children"]:
|
|
138
|
+
if isinstance(c, dict) and "children" in c and isinstance(c["children"], list):
|
|
139
|
+
c["children"] = c["children"][:2]
|
|
140
|
+
|
|
141
|
+
return result
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
def analyze_aom_semantic_discrepancy(failing_selector: str, aom_data: Any) -> Dict[str, Any]:
|
|
145
|
+
"""
|
|
146
|
+
Analyzes live accessibility state to diagnose why failing_selector broke and synthesizes
|
|
147
|
+
robust Clean POM locator recommendations (getByRole, getByLabel, getByTestId).
|
|
148
|
+
"""
|
|
149
|
+
selector_clean = failing_selector.strip()
|
|
150
|
+
sel_lower = selector_clean.lower()
|
|
151
|
+
|
|
152
|
+
# Flatten nodes for fast inspection
|
|
153
|
+
nodes: List[Dict[str, Any]] = []
|
|
154
|
+
|
|
155
|
+
def _collect(n: Any):
|
|
156
|
+
if isinstance(n, dict):
|
|
157
|
+
nodes.append(n)
|
|
158
|
+
for child in n.get("children", []):
|
|
159
|
+
_collect(child)
|
|
160
|
+
elif isinstance(n, list):
|
|
161
|
+
for item in n:
|
|
162
|
+
_collect(item)
|
|
163
|
+
|
|
164
|
+
if isinstance(aom_data, dict) and "aom_nodes" in aom_data:
|
|
165
|
+
_collect(aom_data["aom_nodes"])
|
|
166
|
+
else:
|
|
167
|
+
_collect(aom_data)
|
|
168
|
+
|
|
169
|
+
# 1. Look for matching interactive nodes by priority (exact -> specific token -> fallback)
|
|
170
|
+
candidate_node = None
|
|
171
|
+
GENERIC_TAGS = {
|
|
172
|
+
"button", "input", "div", "span", "select", "table", "form", "page",
|
|
173
|
+
"locator", "click", "fill", "getbyrole", "getbylabel", "getbytestid", "a", "tr", "td"
|
|
174
|
+
}
|
|
175
|
+
raw_tokens = [tok for tok in re.split(r'[^a-zA-Z0-9_]', sel_lower) if len(tok) >= 2]
|
|
176
|
+
specific_tokens = [tok for tok in raw_tokens if tok not in GENERIC_TAGS and len(tok) >= 3]
|
|
177
|
+
target_tokens = specific_tokens if specific_tokens else raw_tokens
|
|
178
|
+
|
|
179
|
+
# Priority 1: Exact match on accessible name or testId
|
|
180
|
+
for node in nodes:
|
|
181
|
+
name = str(node.get("name", "")).lower()
|
|
182
|
+
test_id = str(node.get("testId") or node.get("data-testid") or "").lower()
|
|
183
|
+
if any(tok == name or tok == test_id for tok in target_tokens):
|
|
184
|
+
candidate_node = node
|
|
185
|
+
break
|
|
186
|
+
|
|
187
|
+
# Priority 2: Substring match on specific non-tag tokens
|
|
188
|
+
if not candidate_node and specific_tokens:
|
|
189
|
+
for node in nodes:
|
|
190
|
+
name = str(node.get("name", "")).lower()
|
|
191
|
+
test_id = str(node.get("testId") or node.get("data-testid") or "").lower()
|
|
192
|
+
if any(tok in name or tok in test_id for tok in specific_tokens):
|
|
193
|
+
candidate_node = node
|
|
194
|
+
break
|
|
195
|
+
|
|
196
|
+
# Priority 3: Fallback match on any token
|
|
197
|
+
if not candidate_node:
|
|
198
|
+
for node in nodes:
|
|
199
|
+
name = str(node.get("name", "")).lower()
|
|
200
|
+
test_id = str(node.get("testId") or node.get("data-testid") or "").lower()
|
|
201
|
+
if any(tok in name or tok in test_id for tok in target_tokens):
|
|
202
|
+
candidate_node = node
|
|
203
|
+
break
|
|
204
|
+
|
|
205
|
+
if candidate_node:
|
|
206
|
+
role = candidate_node.get("role", "button")
|
|
207
|
+
name = candidate_node.get("name", "")
|
|
208
|
+
test_id = candidate_node.get("testId") or candidate_node.get("data-testid")
|
|
209
|
+
is_disabled = candidate_node.get("disabled", False)
|
|
210
|
+
|
|
211
|
+
if is_disabled:
|
|
212
|
+
cause = "TARGET_ELEMENT_DISABLED"
|
|
213
|
+
detail = f"Element with accessible name '{name}' is currently disabled in live AOM."
|
|
214
|
+
recommendation = "Wait for element to be enabled or assert isEnabled() before interaction."
|
|
215
|
+
else:
|
|
216
|
+
cause = "ACCESSIBLE_NAME_OR_ROLE_RESOLVED"
|
|
217
|
+
detail = f"Resolved live AOM node: role='{role}', name='{name}'."
|
|
218
|
+
recommendation = "Replace brittle CSS/XPath with Clean POM semantic locator."
|
|
219
|
+
|
|
220
|
+
candidates = []
|
|
221
|
+
if name:
|
|
222
|
+
candidates.append(f"page.getByRole('{role}', {{ name: '{name}' }})")
|
|
223
|
+
if test_id:
|
|
224
|
+
candidates.append(f"page.getByTestId('{test_id}')")
|
|
225
|
+
if name and role in ("textbox", "combobox", "searchbox"):
|
|
226
|
+
candidates.append(f"page.getByLabel('{name}')")
|
|
227
|
+
if not candidates:
|
|
228
|
+
candidates.append(f"page.getByRole('{role}')")
|
|
229
|
+
|
|
230
|
+
return {
|
|
231
|
+
"discrepancy_cause": cause,
|
|
232
|
+
"detail": detail,
|
|
233
|
+
"target_node": candidate_node,
|
|
234
|
+
"recommended_patch": candidates[0],
|
|
235
|
+
"candidate_locators": candidates,
|
|
236
|
+
"recommendation": recommendation
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
# Fallback when exact node is not matched in AOM
|
|
240
|
+
# Guess role from selector
|
|
241
|
+
inferred_role = "button"
|
|
242
|
+
if any(k in sel_lower for k in ("input", "txt", "search", "field", "query")):
|
|
243
|
+
inferred_role = "textbox"
|
|
244
|
+
elif any(k in sel_lower for k in ("link", "nav", "a[", "href")):
|
|
245
|
+
inferred_role = "link"
|
|
246
|
+
elif any(k in sel_lower for k in ("select", "dropdown", "combo")):
|
|
247
|
+
inferred_role = "combobox"
|
|
248
|
+
|
|
249
|
+
inferred_name = target_tokens[0].capitalize() if target_tokens else "Target"
|
|
250
|
+
fallback_patch = f"page.getByRole('{inferred_role}', {{ name: '{inferred_name}' }})"
|
|
251
|
+
|
|
252
|
+
return {
|
|
253
|
+
"discrepancy_cause": "SELECTOR_NOT_FOUND_IN_ACCESSIBILITY_TREE",
|
|
254
|
+
"detail": f"Selector '{failing_selector}' does not match any current accessible nodes. Element may be unmounted or renamed.",
|
|
255
|
+
"target_node": None,
|
|
256
|
+
"recommended_patch": fallback_patch,
|
|
257
|
+
"candidate_locators": [fallback_patch, f"page.locator('{failing_selector}')"],
|
|
258
|
+
"recommendation": f"Verify element visibility and switch to semantic role: {fallback_patch}."
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
|
|
262
|
+
def generate_semantic_reflexion(
|
|
263
|
+
error_sig: str,
|
|
264
|
+
failing_selector: str = "",
|
|
265
|
+
aom_tree: Optional[Any] = None,
|
|
266
|
+
patch_attempt: str = "",
|
|
267
|
+
previous_error: str = ""
|
|
268
|
+
) -> Dict[str, Any]:
|
|
269
|
+
"""
|
|
270
|
+
Generates a structured LLM-guided semantic reflexion payload:
|
|
271
|
+
1. Prunes AOM tree to < 500 tokens.
|
|
272
|
+
2. Runs semantic diagnosis.
|
|
273
|
+
3. Produces a 2-line verbal reflection and formatted LLM reasoning prompt.
|
|
274
|
+
"""
|
|
275
|
+
compact_aom = prune_aom_tree(aom_tree, target_selector=failing_selector) if aom_tree else {}
|
|
276
|
+
diagnosis = analyze_aom_semantic_discrepancy(failing_selector, compact_aom) if (aom_tree and failing_selector) else None
|
|
277
|
+
|
|
278
|
+
if diagnosis:
|
|
279
|
+
rec_patch = diagnosis["recommended_patch"]
|
|
280
|
+
cause = diagnosis["discrepancy_cause"]
|
|
281
|
+
detail = diagnosis["detail"]
|
|
282
|
+
verbal_reflection = (
|
|
283
|
+
f"Reflection: Locator '{failing_selector}' failed with {error_sig[:60]}. Live AOM indicates: {detail}\n"
|
|
284
|
+
f"Adjustment: {diagnosis['recommendation']} Use semantic locator: {rec_patch}."
|
|
285
|
+
)
|
|
286
|
+
else:
|
|
287
|
+
# Fallback to standard heuristic reflection
|
|
288
|
+
err_lower = (previous_error or error_sig).lower()
|
|
289
|
+
if "staleelement" in err_lower or "stale" in err_lower:
|
|
290
|
+
verbal_reflection = "Reflection: DOM node re-rendered asynchronously after API call.\nAdjustment: Must wait for loader/backdrop detachment before re-querying element."
|
|
291
|
+
rec_patch = "page.waitForLoadState('networkidle')"
|
|
292
|
+
elif "intercepted" in err_lower or "click" in err_lower:
|
|
293
|
+
verbal_reflection = "Reflection: Click intercepted by fading overlay/spinner animation.\nAdjustment: Use smart wait for overlay detachment or bypass via safe JS click."
|
|
294
|
+
rec_patch = f"page.locator('{failing_selector}').click({{ force: true }})"
|
|
295
|
+
elif "hydration" in err_lower or "did not match" in err_lower:
|
|
296
|
+
verbal_reflection = "Reflection: React/Next.js hydration mismatch caused DOM element to re-render.\nAdjustment: Ensure DOM is interactive and wait for loadState('domcontentloaded') before query."
|
|
297
|
+
rec_patch = "page.waitForLoadState('domcontentloaded')"
|
|
298
|
+
elif "shadow" in err_lower or "shadowroot" in err_lower:
|
|
299
|
+
verbal_reflection = "Reflection: Target element encapsulated inside closed Shadow DOM boundary.\nAdjustment: Pierce Shadow DOM via locator piercing syntax or evaluate via CDP."
|
|
300
|
+
rec_patch = f"page.locator('{failing_selector}').locator(':scope')"
|
|
301
|
+
elif "iframe" in err_lower or "frame" in err_lower:
|
|
302
|
+
verbal_reflection = "Reflection: Target element resides inside cross-origin iframe container.\nAdjustment: Switch context to frameLocator('iframe#...') before clicking."
|
|
303
|
+
rec_patch = f"page.frameLocator('iframe').locator('{failing_selector}')"
|
|
304
|
+
elif any(auth_err in err_lower for auth_err in ("401", "403", "unauthorized", "forbidden", "token expired")):
|
|
305
|
+
verbal_reflection = "Reflection: Session auth token or cookie expired mid-test.\nAdjustment: Refresh storageState or trigger silent token re-authentication via API fixture."
|
|
306
|
+
rec_patch = "authManager.refreshStorageState()"
|
|
307
|
+
elif "timeout" in err_lower or "nosuchelement" in err_lower:
|
|
308
|
+
verbal_reflection = "Reflection: Static selector did not appear within timeout window.\nAdjustment: Fallback to Accessibility role/label or dynamic data-testid attribute."
|
|
309
|
+
rec_patch = "page.getByRole('button')"
|
|
310
|
+
elif "assert" in err_lower:
|
|
311
|
+
verbal_reflection = "Reflection: Assertion condition violated actual state.\nAdjustment: Check if state change was asynchronous or if expected data was corrupted."
|
|
312
|
+
rec_patch = "expect(element).toBeVisible()"
|
|
313
|
+
else:
|
|
314
|
+
verbal_reflection = f"Reflection: Patch attempt failed with '{error_sig[:80]}'.\nAdjustment: Re-examine live DOM tree and avoid static sleeps."
|
|
315
|
+
rec_patch = f"page.locator('{failing_selector}')"
|
|
316
|
+
|
|
317
|
+
cause = "HEURISTIC_ERROR_SIGNATURE"
|
|
318
|
+
detail = "Standard error pattern match."
|
|
319
|
+
|
|
320
|
+
# Synthesize LLM semantic reasoning prompt
|
|
321
|
+
aom_json_str = json.dumps(compact_aom, indent=2, ensure_ascii=False) if compact_aom else "None provided."
|
|
322
|
+
prompt = f"""### Autonomous QA Self-Healing Reflexion Prompt (Noah Shinn Pattern)
|
|
323
|
+
You are an expert QA Automation Engineer specialized in Clean POM and Playwright self-healing.
|
|
324
|
+
|
|
325
|
+
#### 1. Failure Symptom:
|
|
326
|
+
- Failing Selector : {failing_selector or 'N/A'}
|
|
327
|
+
- Error Signature : {error_sig}
|
|
328
|
+
- Previous Patch : {patch_attempt or 'Initial failure'}
|
|
329
|
+
- Previous Error : {previous_error or 'None'}
|
|
330
|
+
|
|
331
|
+
#### 2. Compact Accessibility Object Model (AOM) Subtree (< 500 tokens):
|
|
332
|
+
```json
|
|
333
|
+
{aom_json_str}
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
#### 3. Semantic Diagnosis:
|
|
337
|
+
- Root Cause : {cause}
|
|
338
|
+
- Structural Detail: {detail}
|
|
339
|
+
|
|
340
|
+
#### 4. Mandatory Instructions:
|
|
341
|
+
1. Synthesize a single Clean POM locator adhering strictly to Flat Architecture (zero raw XPaths/brittle CSS).
|
|
342
|
+
2. Prioritize user-facing accessibility semantics:
|
|
343
|
+
- Priority 1: page.getByRole('role', {{ name: 'accessible_name' }})
|
|
344
|
+
- Priority 2: page.getByTestId('test-id')
|
|
345
|
+
- Priority 3: page.getByLabel('label_text')
|
|
346
|
+
3. Proposed Patch: {rec_patch}
|
|
347
|
+
"""
|
|
348
|
+
|
|
349
|
+
return {
|
|
350
|
+
"verbal_reflection": verbal_reflection,
|
|
351
|
+
"recommended_patch": rec_patch,
|
|
352
|
+
"compact_aom": compact_aom,
|
|
353
|
+
"semantic_diagnosis": diagnosis,
|
|
354
|
+
"discrepancy_cause": cause,
|
|
355
|
+
"prompt": prompt
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
|
|
359
|
+
class ClosedLoopHealer:
|
|
360
|
+
"""Orchestrates multi-trial reflection loops for self-healing test automation."""
|
|
361
|
+
|
|
362
|
+
def __init__(self, max_trials: int = 3):
|
|
363
|
+
self.max_trials = max_trials
|
|
364
|
+
self.memory_buffer: List[ReflexionTrial] = []
|
|
365
|
+
|
|
366
|
+
def generate_reflection(
|
|
367
|
+
self,
|
|
368
|
+
error_sig: str,
|
|
369
|
+
patch_attempt: str,
|
|
370
|
+
previous_error: str,
|
|
371
|
+
aom_tree: Optional[Any] = None,
|
|
372
|
+
failing_selector: str = ""
|
|
373
|
+
) -> str:
|
|
374
|
+
"""
|
|
375
|
+
Synthesizes a structured 2-line verbal reflection explaining why the previous attempt failed
|
|
376
|
+
and prescribing the strategic adjustment for the next attempt.
|
|
377
|
+
When AOM context is available, grounds reflection in live semantic accessibility nodes.
|
|
378
|
+
"""
|
|
379
|
+
res = generate_semantic_reflexion(
|
|
380
|
+
error_sig=error_sig,
|
|
381
|
+
failing_selector=failing_selector,
|
|
382
|
+
aom_tree=aom_tree,
|
|
383
|
+
patch_attempt=patch_attempt,
|
|
384
|
+
previous_error=previous_error
|
|
385
|
+
)
|
|
386
|
+
return res["verbal_reflection"]
|
|
387
|
+
|
|
388
|
+
def execute_healing_loop(
|
|
389
|
+
self,
|
|
390
|
+
failing_test: str,
|
|
391
|
+
initial_error: str,
|
|
392
|
+
patch_synthesizer: Callable[[str, str, List[ReflexionTrial]], str],
|
|
393
|
+
verifier: Callable[[str, str], Tuple[bool, str]],
|
|
394
|
+
page_context: str = "GLOBAL",
|
|
395
|
+
aom_tree: Optional[Any] = None,
|
|
396
|
+
failing_selector: str = ""
|
|
397
|
+
) -> Tuple[bool, Optional[str], List[ReflexionTrial]]:
|
|
398
|
+
"""
|
|
399
|
+
Executes up to max_trials attempts.
|
|
400
|
+
Returns (is_success, winning_patch, trial_history).
|
|
401
|
+
"""
|
|
402
|
+
self.memory_buffer.clear()
|
|
403
|
+
current_error = initial_error
|
|
404
|
+
|
|
405
|
+
print(f"\nš [REFLEXION LOOP] Starting Multi-Trial Self-Healing (Max K={self.max_trials}) for '{failing_test}'...")
|
|
406
|
+
|
|
407
|
+
for t in range(1, self.max_trials + 1):
|
|
408
|
+
prev_attempt = self.memory_buffer[-1].patch_attempt if self.memory_buffer else ""
|
|
409
|
+
reflection = self.generate_reflection(
|
|
410
|
+
initial_error,
|
|
411
|
+
prev_attempt,
|
|
412
|
+
current_error,
|
|
413
|
+
aom_tree=aom_tree,
|
|
414
|
+
failing_selector=failing_selector
|
|
415
|
+
)
|
|
416
|
+
|
|
417
|
+
print(f"\n --- Trial {t}/{self.max_trials} ---")
|
|
418
|
+
print(f" š§ Verbal Reflection:\n{reflection}")
|
|
419
|
+
|
|
420
|
+
# Synthesize next patch conditioned on reflection memory
|
|
421
|
+
try:
|
|
422
|
+
if patch_synthesizer:
|
|
423
|
+
candidate_patch = patch_synthesizer(failing_test, reflection, self.memory_buffer)
|
|
424
|
+
else:
|
|
425
|
+
sem = generate_semantic_reflexion(initial_error, failing_selector, aom_tree=aom_tree)
|
|
426
|
+
candidate_patch = sem["recommended_patch"]
|
|
427
|
+
except Exception as e:
|
|
428
|
+
candidate_patch = f"// Error in patch_synthesizer: {e}"
|
|
429
|
+
|
|
430
|
+
print(f" š§ Candidate Patch : {candidate_patch[:100]}...")
|
|
431
|
+
|
|
432
|
+
# Verify patch in headless execution safely
|
|
433
|
+
try:
|
|
434
|
+
is_pass, new_error = verifier(failing_test, candidate_patch)
|
|
435
|
+
except Exception as err:
|
|
436
|
+
is_pass, new_error = False, f"Verifier execution error: {err}"
|
|
437
|
+
|
|
438
|
+
trial = ReflexionTrial(
|
|
439
|
+
trial_number=t,
|
|
440
|
+
patch_attempt=candidate_patch,
|
|
441
|
+
error_feedback=new_error if not is_pass else "PASS",
|
|
442
|
+
verbal_reflection=reflection,
|
|
443
|
+
is_passing=is_pass
|
|
444
|
+
)
|
|
445
|
+
self.memory_buffer.append(trial)
|
|
446
|
+
|
|
447
|
+
if is_pass:
|
|
448
|
+
print(f" ā
[TRIAL {t} SUCCESS] Patch verified passing!")
|
|
449
|
+
self._record_positive_memory(page_context, initial_error, candidate_patch, reflection)
|
|
450
|
+
return True, candidate_patch, self.memory_buffer
|
|
451
|
+
else:
|
|
452
|
+
print(f" ā [TRIAL {t} FAILED] Error: {new_error[:100]}")
|
|
453
|
+
current_error = new_error
|
|
454
|
+
|
|
455
|
+
print(f"\nā ļø [REFLEXION EXHAUSTED] Failed after {self.max_trials} trials. Persisting to negative memory blacklist.")
|
|
456
|
+
self._record_negative_memory(initial_error, self.memory_buffer[-1].patch_attempt, f"Failed across {self.max_trials} multi-trial attempts")
|
|
457
|
+
return False, None, self.memory_buffer
|
|
458
|
+
|
|
459
|
+
def _record_positive_memory(self, page_context: str, error_sig: str, patch: str, reflection: str):
|
|
460
|
+
try:
|
|
461
|
+
cache_resolver.record_lesson(
|
|
462
|
+
page_context=page_context,
|
|
463
|
+
error_signature=error_sig,
|
|
464
|
+
root_cause=reflection,
|
|
465
|
+
failed_attempt="Initial failing code",
|
|
466
|
+
successful_fix=patch,
|
|
467
|
+
lesson_summary=reflection
|
|
468
|
+
)
|
|
469
|
+
except Exception as e:
|
|
470
|
+
sys.stderr.write(f"Notice: Failed to record positive memory: {e}\n")
|
|
471
|
+
|
|
472
|
+
def _record_negative_memory(self, error_sig: str, failed_patch: str, reason: str):
|
|
473
|
+
try:
|
|
474
|
+
cache_resolver.record_failed_fix(
|
|
475
|
+
error_signature=error_sig,
|
|
476
|
+
patch=failed_patch,
|
|
477
|
+
reason=reason,
|
|
478
|
+
agent_role="failure-analyst"
|
|
479
|
+
)
|
|
480
|
+
except Exception as e:
|
|
481
|
+
sys.stderr.write(f"Notice: Failed to record negative memory: {e}\n")
|
|
482
|
+
|
|
483
|
+
|
|
484
|
+
def main():
|
|
485
|
+
parser = argparse.ArgumentParser(description="Multi-Trial Episodic Reflexion Self-Healer with AOM Semantic Analysis")
|
|
486
|
+
parser.add_argument("--test", default="SampleTest", help="Failing test identifier")
|
|
487
|
+
parser.add_argument("--error", default="ElementClickInterceptedException", help="Initial error signature")
|
|
488
|
+
parser.add_argument("--selector", default="", help="Failing selector (e.g. #login-btn)")
|
|
489
|
+
parser.add_argument("--aom", default="", help="Inline AOM JSON string or file path containing AOM data")
|
|
490
|
+
parser.add_argument("--max-trials", type=int, default=3, help="Max trials (default: 3)")
|
|
491
|
+
parser.add_argument("--semantic-prompt", action="store_true", help="Output full synthesized LLM reasoning prompt")
|
|
492
|
+
args = parser.parse_args()
|
|
493
|
+
|
|
494
|
+
aom_data = None
|
|
495
|
+
if args.aom:
|
|
496
|
+
if os.path.isfile(args.aom):
|
|
497
|
+
try:
|
|
498
|
+
with open(args.aom, "r", encoding="utf-8") as f:
|
|
499
|
+
aom_data = json.load(f)
|
|
500
|
+
except Exception as e:
|
|
501
|
+
aom_data = {"error": f"Failed to read AOM file: {e}"}
|
|
502
|
+
else:
|
|
503
|
+
try:
|
|
504
|
+
aom_data = json.loads(args.aom)
|
|
505
|
+
except Exception:
|
|
506
|
+
aom_data = args.aom
|
|
507
|
+
|
|
508
|
+
semantic_res = generate_semantic_reflexion(
|
|
509
|
+
error_sig=args.error,
|
|
510
|
+
failing_selector=args.selector,
|
|
511
|
+
aom_tree=aom_data
|
|
512
|
+
)
|
|
513
|
+
|
|
514
|
+
output = {
|
|
515
|
+
"test": args.test,
|
|
516
|
+
"error": args.error,
|
|
517
|
+
"selector": args.selector,
|
|
518
|
+
"max_trials": args.max_trials,
|
|
519
|
+
"verbal_reflection": semantic_res["verbal_reflection"],
|
|
520
|
+
"recommended_patch": semantic_res["recommended_patch"],
|
|
521
|
+
"discrepancy_cause": semantic_res["discrepancy_cause"]
|
|
522
|
+
}
|
|
523
|
+
|
|
524
|
+
if args.semantic_prompt:
|
|
525
|
+
output["semantic_prompt"] = semantic_res["prompt"]
|
|
526
|
+
|
|
527
|
+
print(json.dumps(output, indent=2, ensure_ascii=False))
|
|
528
|
+
return 0
|
|
529
|
+
|
|
530
|
+
|
|
531
|
+
if __name__ == "__main__":
|
|
532
|
+
sys.exit(main())
|