@teevee98/synapse-hub 0.0.0-stage → 3.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +171 -0
  190. package/README.md +170 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +198 -0
  196. package/docs/ARCHITECTURE.md +199 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +31 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2074 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2403 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +306 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +725 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1271 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,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())