@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,190 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
# Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
|
|
5
|
+
|
|
6
|
+
"""
|
|
7
|
+
tools/author_integrity.py — Author Attribution & MIT License Compliance Guard
|
|
8
|
+
-----------------------------------------------------------------------------
|
|
9
|
+
Verifies the author provenance and copyright attribution of Synapse Hub.
|
|
10
|
+
Enforces the mandatory Attribution condition of the MIT License:
|
|
11
|
+
"The above copyright notice and this permission notice shall be included
|
|
12
|
+
in all copies or substantial portions of the Software."
|
|
13
|
+
|
|
14
|
+
Checks:
|
|
15
|
+
1. LICENSE file exists with original copyright notice (Thế Vị @TeeVee998).
|
|
16
|
+
2. package.json maintains the original author attribution.
|
|
17
|
+
3. README.md retains the original creator and repository provenance.
|
|
18
|
+
4. pyproject.toml preserves the author declaration.
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
import os
|
|
22
|
+
import sys
|
|
23
|
+
import json
|
|
24
|
+
import hashlib
|
|
25
|
+
from typing import Tuple, List, Optional
|
|
26
|
+
|
|
27
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
28
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
29
|
+
try:
|
|
30
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
31
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
32
|
+
except Exception:
|
|
33
|
+
pass
|
|
34
|
+
|
|
35
|
+
ORIGINAL_AUTHOR_NAME = "Thế Vị"
|
|
36
|
+
ORIGINAL_AUTHOR_HANDLE = "@TeeVee98"
|
|
37
|
+
ORIGINAL_REPO_URL = "https://github.com/TeeVee98/Synapse-Hub"
|
|
38
|
+
|
|
39
|
+
# Pre-computed SHA-256 fingerprints of canonical author credentials (@TeeVee98 and legacy @TeeVee998)
|
|
40
|
+
CANONICAL_AUTHOR_SIGS = {
|
|
41
|
+
"6c56b5f2c2d6f4e4b82cf4d1fa6ccd4a5e8cf0cb0e15a4a60136965fe8ebb697", # Thế Vị (@TeeVee98) <https://github.com/TeeVee98/Synapse-Hub>
|
|
42
|
+
"ea09e6bd3428c00581a385ec13bb7d8cd7d9e800fbdd1094c6d5a7bfb4060475", # Thế Vị (@TeeVee998) <https://github.com/TeeVee998/Synapse-Hub> (legacy provenance)
|
|
43
|
+
}
|
|
44
|
+
CANONICAL_AUTHOR_SIG = "6c56b5f2c2d6f4e4b82cf4d1fa6ccd4a5e8cf0cb0e15a4a60136965fe8ebb697"
|
|
45
|
+
|
|
46
|
+
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
|
|
47
|
+
DEFAULT_REPO_ROOT = os.path.dirname(SCRIPT_DIR)
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
def get_canonical_watermark() -> str:
|
|
51
|
+
return f"{ORIGINAL_AUTHOR_NAME} ({ORIGINAL_AUTHOR_HANDLE}) <{ORIGINAL_REPO_URL}>"
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
def verify_author_fingerprint() -> bool:
|
|
55
|
+
"""Validates that the canonical author attribution metadata matches the reference integrity hash."""
|
|
56
|
+
watermark = get_canonical_watermark()
|
|
57
|
+
computed = hashlib.sha256(watermark.encode("utf-8")).hexdigest()
|
|
58
|
+
if CANONICAL_AUTHOR_SIG not in CANONICAL_AUTHOR_SIGS:
|
|
59
|
+
return False
|
|
60
|
+
return computed == CANONICAL_AUTHOR_SIG or computed in CANONICAL_AUTHOR_SIGS
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
def assert_integrity_or_raise(repo_root: Optional[str] = None) -> bool:
|
|
64
|
+
"""
|
|
65
|
+
Enforces author attribution and MIT License provenance in accordance with open-source licensing.
|
|
66
|
+
Under the MIT License, preserving the original copyright notice in LICENSE is mandatory.
|
|
67
|
+
If mandatory LICENSE copyright notice is missing, halts execution to protect author attribution.
|
|
68
|
+
"""
|
|
69
|
+
if not verify_author_fingerprint():
|
|
70
|
+
raise RuntimeError(
|
|
71
|
+
"🛑 CRITICAL INTEGRITY CORRUPTED: Canonical author fingerprint mismatch. "
|
|
72
|
+
"Synapse Hub requires original author attribution ('Thế Vị @TeeVee998') to execute."
|
|
73
|
+
)
|
|
74
|
+
valid, violations = verify_author_attribution(repo_root)
|
|
75
|
+
license_violations = [v for v in violations if "LICENSE" in v]
|
|
76
|
+
if license_violations:
|
|
77
|
+
err_msg = "🛑 CRITICAL INTEGRITY VIOLATION: Mandatory MIT copyright notice missing or altered.\n"
|
|
78
|
+
for v in license_violations:
|
|
79
|
+
err_msg += f" • {v}\n"
|
|
80
|
+
err_msg += "Under the MIT License, original author attribution to 'Thế Vị (@TeeVee998)' must be preserved in LICENSE."
|
|
81
|
+
raise RuntimeError(err_msg)
|
|
82
|
+
elif not valid:
|
|
83
|
+
# Non-fatal warning for peripheral files (README/package.json) to allow flexible downstream fork usage
|
|
84
|
+
for v in violations:
|
|
85
|
+
print(f"[WARN] Attribution Notice: {v}", file=sys.stderr)
|
|
86
|
+
return True
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
def verify_author_attribution(repo_root: Optional[str] = None) -> Tuple[bool, List[str]]:
|
|
90
|
+
"""
|
|
91
|
+
Validates that the repository preserves the author attribution required by MIT license.
|
|
92
|
+
Returns (is_valid, list_of_violations).
|
|
93
|
+
"""
|
|
94
|
+
root = repo_root or DEFAULT_REPO_ROOT
|
|
95
|
+
violations: List[str] = []
|
|
96
|
+
|
|
97
|
+
# 1. Check LICENSE file
|
|
98
|
+
license_path = os.path.join(root, "LICENSE")
|
|
99
|
+
if not os.path.exists(license_path):
|
|
100
|
+
violations.append("Missing LICENSE file. MIT License with author copyright notice is mandatory.")
|
|
101
|
+
else:
|
|
102
|
+
try:
|
|
103
|
+
with open(license_path, "r", encoding="utf-8", errors="ignore") as f:
|
|
104
|
+
lic_content = f.read()
|
|
105
|
+
if ORIGINAL_AUTHOR_NAME not in lic_content or ("@TeeVee98" not in lic_content and "@TeeVee998" not in lic_content):
|
|
106
|
+
violations.append("LICENSE file modified: original copyright notice for 'Thế Vị (@TeeVee98)' was removed or altered.")
|
|
107
|
+
if "Synapse-Hub" not in lic_content:
|
|
108
|
+
violations.append("LICENSE file modified: original repository URL was removed.")
|
|
109
|
+
except Exception as e:
|
|
110
|
+
violations.append(f"Could not read LICENSE file: {e}")
|
|
111
|
+
|
|
112
|
+
# 2. Check package.json
|
|
113
|
+
pkg_path = os.path.join(root, "package.json")
|
|
114
|
+
if os.path.exists(pkg_path):
|
|
115
|
+
try:
|
|
116
|
+
with open(pkg_path, "r", encoding="utf-8", errors="ignore") as f:
|
|
117
|
+
pkg_data = json.load(f)
|
|
118
|
+
author_val = str(pkg_data.get("author", ""))
|
|
119
|
+
if ORIGINAL_AUTHOR_NAME not in author_val or ("TeeVee98" not in author_val and "TeeVee998" not in author_val):
|
|
120
|
+
violations.append("package.json modified: 'author' field does not credit 'Thế Vị (@TeeVee98)'.")
|
|
121
|
+
except Exception as e:
|
|
122
|
+
violations.append(f"Could not read package.json: {e}")
|
|
123
|
+
|
|
124
|
+
# 3. Check README.md
|
|
125
|
+
readme_path = os.path.join(root, "README.md")
|
|
126
|
+
if os.path.exists(readme_path):
|
|
127
|
+
try:
|
|
128
|
+
with open(readme_path, "r", encoding="utf-8", errors="ignore") as f:
|
|
129
|
+
readme_content = f.read()
|
|
130
|
+
if ORIGINAL_AUTHOR_NAME not in readme_content or ("@TeeVee98" not in readme_content and "@TeeVee998" not in readme_content):
|
|
131
|
+
violations.append("README.md modified: author attribution for 'Thế Vị (@TeeVee98)' was removed.")
|
|
132
|
+
if "Synapse-Hub" not in readme_content:
|
|
133
|
+
violations.append("README.md modified: upstream repository provenance link was removed.")
|
|
134
|
+
except Exception as e:
|
|
135
|
+
violations.append(f"Could not read README.md: {e}")
|
|
136
|
+
|
|
137
|
+
# 4. Check pyproject.toml
|
|
138
|
+
pyproject_path = os.path.join(root, "pyproject.toml")
|
|
139
|
+
if os.path.exists(pyproject_path):
|
|
140
|
+
try:
|
|
141
|
+
with open(pyproject_path, "r", encoding="utf-8", errors="ignore") as f:
|
|
142
|
+
pyproj_content = f.read()
|
|
143
|
+
if ORIGINAL_AUTHOR_NAME not in pyproj_content:
|
|
144
|
+
violations.append("pyproject.toml modified: author declaration does not include 'Thế Vị'.")
|
|
145
|
+
except Exception as e:
|
|
146
|
+
violations.append(f"Could not read pyproject.toml: {e}")
|
|
147
|
+
|
|
148
|
+
is_valid = len(violations) == 0
|
|
149
|
+
return is_valid, violations
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
def enforce_author_attribution(repo_root: Optional[str] = None, strict: bool = True) -> bool:
|
|
153
|
+
"""
|
|
154
|
+
Enforces author attribution at runtime. If attribution is violated,
|
|
155
|
+
displays a transparent copyright notice and halts execution if strict=True.
|
|
156
|
+
"""
|
|
157
|
+
is_valid, violations = verify_author_attribution(repo_root)
|
|
158
|
+
if not is_valid:
|
|
159
|
+
CYAN = "\033[96m"
|
|
160
|
+
RED = "\033[91m"
|
|
161
|
+
BOLD = "\033[1m"
|
|
162
|
+
RESET = "\033[0m"
|
|
163
|
+
|
|
164
|
+
print(f"\n{BOLD}{RED}======================================================================{RESET}", file=sys.stderr)
|
|
165
|
+
print(f"{BOLD}{RED} 🛑 [AUTHOR ATTRIBUTION & INTEGRITY VIOLATION DETECTED] {RESET}", file=sys.stderr)
|
|
166
|
+
print(f"{BOLD}{RED}======================================================================{RESET}", file=sys.stderr)
|
|
167
|
+
print(f"{BOLD}Original Creator & Copyright Holder:{RESET} {ORIGINAL_AUTHOR_NAME} ({ORIGINAL_AUTHOR_HANDLE})", file=sys.stderr)
|
|
168
|
+
print(f"{BOLD}Original Project Repository :{RESET} {ORIGINAL_REPO_URL}", file=sys.stderr)
|
|
169
|
+
print(f"{BOLD}Legal Notice :{RESET} Under the MIT License, you are free to use,", file=sys.stderr)
|
|
170
|
+
print(" modify, and distribute this software, PROVIDED", file=sys.stderr)
|
|
171
|
+
print(" that the original copyright notice is preserved.", file=sys.stderr)
|
|
172
|
+
print("\nViolations detected:", file=sys.stderr)
|
|
173
|
+
for v in violations:
|
|
174
|
+
print(f" • {v}", file=sys.stderr)
|
|
175
|
+
print(f"\n{CYAN}👉 Please restore original author attribution to continue using Synapse Hub.{RESET}", file=sys.stderr)
|
|
176
|
+
print(f"{RED}======================================================================{RESET}\n", file=sys.stderr)
|
|
177
|
+
|
|
178
|
+
if strict:
|
|
179
|
+
sys.exit(1)
|
|
180
|
+
return False
|
|
181
|
+
return True
|
|
182
|
+
|
|
183
|
+
|
|
184
|
+
if __name__ == "__main__":
|
|
185
|
+
valid, viols = verify_author_attribution()
|
|
186
|
+
if valid:
|
|
187
|
+
print(f"✅ Author attribution is 100% verified intact: {get_canonical_watermark()}")
|
|
188
|
+
sys.exit(0)
|
|
189
|
+
else:
|
|
190
|
+
enforce_author_attribution(strict=True)
|
|
@@ -0,0 +1,271 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Enterprise Closed-Loop Autonomous Test Healer Engine
|
|
4
|
+
-----------------------------------------------------
|
|
5
|
+
Diagnoses test failures in 0.1s from JUnit XML and terminal logs, queries the
|
|
6
|
+
semantic memory cache for proven patches, and orchestrates targeted re-tests.
|
|
7
|
+
Dispatched automatically by AI Agents when test runs encounter failures.
|
|
8
|
+
"""
|
|
9
|
+
|
|
10
|
+
import os
|
|
11
|
+
import sys
|
|
12
|
+
import re
|
|
13
|
+
import json
|
|
14
|
+
import argparse
|
|
15
|
+
|
|
16
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
17
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
18
|
+
try:
|
|
19
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
20
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
21
|
+
except Exception:
|
|
22
|
+
pass
|
|
23
|
+
|
|
24
|
+
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
|
|
25
|
+
HUB_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
|
|
26
|
+
sys.path.insert(0, SCRIPT_DIR)
|
|
27
|
+
|
|
28
|
+
import pinpoint_failure
|
|
29
|
+
import cache_resolver
|
|
30
|
+
import project_state
|
|
31
|
+
import heuristic_locator_matcher
|
|
32
|
+
import auto_heal_reflexion
|
|
33
|
+
from typing import Optional, Dict, Any
|
|
34
|
+
|
|
35
|
+
GREEN = "\033[92m"
|
|
36
|
+
RED = "\033[91m"
|
|
37
|
+
YELLOW = "\033[93m"
|
|
38
|
+
CYAN = "\033[96m"
|
|
39
|
+
BOLD = "\033[1m"
|
|
40
|
+
RESET = "\033[0m"
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
def capture_live_aom_snapshot(url: str, timeout: float = 10.0) -> Optional[Dict[str, Any]]:
|
|
44
|
+
"""
|
|
45
|
+
Connects headless Playwright to live URL and extracts the Accessibility Object Model (AOM)
|
|
46
|
+
snapshot for semantic locator healing.
|
|
47
|
+
"""
|
|
48
|
+
try:
|
|
49
|
+
from playwright.sync_api import sync_playwright
|
|
50
|
+
with sync_playwright() as p:
|
|
51
|
+
browser = p.chromium.launch(headless=True)
|
|
52
|
+
page = browser.new_page()
|
|
53
|
+
page.goto(url, timeout=int(timeout * 1000), wait_until="domcontentloaded")
|
|
54
|
+
snapshot = page.accessibility.snapshot()
|
|
55
|
+
browser.close()
|
|
56
|
+
return snapshot
|
|
57
|
+
except Exception as _err:
|
|
58
|
+
_ = _err
|
|
59
|
+
return None
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
def diagnose_and_plan_heal(target_dir=HUB_ROOT, junit_xml_path=None, failure_info=None, live_url=None, aom_snapshot=None):
|
|
63
|
+
"""
|
|
64
|
+
Parses test failure, checks memory cache, updates project state watchpoints,
|
|
65
|
+
and returns a structured healing plan.
|
|
66
|
+
"""
|
|
67
|
+
print(f"\n{BOLD}{CYAN}======================================================================{RESET}")
|
|
68
|
+
print(f"{BOLD}{CYAN} AUTONOMOUS CLOSED-LOOP TEST HEALING SENTINEL {RESET}")
|
|
69
|
+
print(f"{BOLD}{CYAN}======================================================================{RESET}")
|
|
70
|
+
print(f"📁 Target Project : {target_dir}")
|
|
71
|
+
|
|
72
|
+
# 1. Live AOM snapshot extraction
|
|
73
|
+
aom_data = aom_snapshot
|
|
74
|
+
if not aom_data and live_url:
|
|
75
|
+
print(f" {CYAN}🌐 [PLAYWRIGHT CDP] Extracting live AOM snapshot from {live_url}...{RESET}")
|
|
76
|
+
aom_data = capture_live_aom_snapshot(live_url)
|
|
77
|
+
if aom_data:
|
|
78
|
+
print(f" {GREEN}[AOM EXTRACTED] Live accessibility tree captured successfully.{RESET}")
|
|
79
|
+
|
|
80
|
+
# 1b. Pinpoint failure from JUnit XML or logs if not directly provided
|
|
81
|
+
if not failure_info and junit_xml_path and os.path.exists(junit_xml_path):
|
|
82
|
+
failures = getattr(pinpoint_failure, "parse_failures", None) or getattr(pinpoint_failure, "parse_junit_xml", None)
|
|
83
|
+
if failures:
|
|
84
|
+
res = failures(junit_xml_path)
|
|
85
|
+
if res:
|
|
86
|
+
failure_info = res[0]
|
|
87
|
+
|
|
88
|
+
if not failure_info:
|
|
89
|
+
# Search for any recent report in Reports/
|
|
90
|
+
reports_dir = os.path.join(target_dir, "Reports")
|
|
91
|
+
if os.path.exists(reports_dir):
|
|
92
|
+
for root, _, files in os.walk(reports_dir):
|
|
93
|
+
for f in files:
|
|
94
|
+
if f.endswith(".xml"):
|
|
95
|
+
parsed = pinpoint_failure.parse_junit_xml(os.path.join(root, f))
|
|
96
|
+
if parsed:
|
|
97
|
+
failure_info = parsed[0]
|
|
98
|
+
break
|
|
99
|
+
if failure_info:
|
|
100
|
+
break
|
|
101
|
+
|
|
102
|
+
if not failure_info:
|
|
103
|
+
print(" [INFO] Zero active JUnit XML failures detected on disk.")
|
|
104
|
+
return {"status": "NO_FAILURE_DETECTED"}
|
|
105
|
+
|
|
106
|
+
err_sig = failure_info.get("reason", failure_info.get("message", failure_info.get("error", failure_info.get("type", "UnknownError"))))
|
|
107
|
+
test_name = failure_info.get("tc", failure_info.get("name", failure_info.get("test_name", "UnknownTest")))
|
|
108
|
+
failing_file = failure_info.get("file", "UnknownFile")
|
|
109
|
+
line_num = failure_info.get("line", "?")
|
|
110
|
+
|
|
111
|
+
if (failing_file == "UnknownFile" or line_num == "?") and failure_info.get("failed_at"):
|
|
112
|
+
first_loc = failure_info["failed_at"][0]
|
|
113
|
+
if ":" in str(first_loc) and not str(first_loc).startswith("See JUnit"):
|
|
114
|
+
parts = str(first_loc).rsplit(":", 1)
|
|
115
|
+
if failing_file == "UnknownFile":
|
|
116
|
+
failing_file = parts[0]
|
|
117
|
+
if line_num == "?":
|
|
118
|
+
line_num = parts[1]
|
|
119
|
+
|
|
120
|
+
print(f" ❌ Failing Test : {test_name}")
|
|
121
|
+
print(f" 📍 Source Location: {failing_file}:{line_num}")
|
|
122
|
+
print(f" ⚠️ Error Signature: {err_sig[:120]}...\n")
|
|
123
|
+
|
|
124
|
+
# 2. Query 0-token memory cache & 3-layer heuristic matcher
|
|
125
|
+
print(f"{BOLD}[1/2] Checking 3-Layer Heuristic Matcher & Memory Cache...{RESET}")
|
|
126
|
+
cache_solution = cache_resolver.query_solution(err_sig, threshold=0.35)
|
|
127
|
+
|
|
128
|
+
# 2b. Query Episodic Reflexion Memory (Top 2 historical lessons)
|
|
129
|
+
lessons = cache_resolver.query_lessons(f"{test_name} {err_sig}", limit=2)
|
|
130
|
+
|
|
131
|
+
plan = {
|
|
132
|
+
"status": "HEALING_PLAN_READY",
|
|
133
|
+
"test_name": test_name,
|
|
134
|
+
"failing_file": failing_file,
|
|
135
|
+
"line": line_num,
|
|
136
|
+
"error_signature": err_sig,
|
|
137
|
+
"cache_match": bool(cache_solution),
|
|
138
|
+
"heuristic_match": None,
|
|
139
|
+
"recommended_patch": None,
|
|
140
|
+
"verbal_reflection": None,
|
|
141
|
+
"episodic_lessons": [les["lesson_summary"] for les in lessons],
|
|
142
|
+
"aom_snapshot_captured": bool(aom_data)
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
if aom_data:
|
|
146
|
+
plan["pruned_aom"] = auto_heal_reflexion.prune_aom_tree(aom_data, target_selector=err_sig)
|
|
147
|
+
|
|
148
|
+
# 2b. Reflexion Verbal Diagnosis
|
|
149
|
+
healer = auto_heal_reflexion.ClosedLoopHealer(max_trials=3)
|
|
150
|
+
verbal_reflection = healer.generate_reflection(err_sig, "", "")
|
|
151
|
+
plan["verbal_reflection"] = verbal_reflection
|
|
152
|
+
|
|
153
|
+
if lessons:
|
|
154
|
+
print(f" {CYAN}🧠 [EPISODIC REFLEXION] Top Historical Lessons for Context:{RESET}")
|
|
155
|
+
for idx, les in enumerate(lessons, 1):
|
|
156
|
+
print(f" {idx}. [{les['page_context']}]: {les['lesson_summary']}")
|
|
157
|
+
print(f" {CYAN}💡 [REFLEXION DIAGNOSIS] {verbal_reflection}{RESET}")
|
|
158
|
+
|
|
159
|
+
if cache_solution:
|
|
160
|
+
score_val = cache_solution.get('score') or cache_solution.get('confidence', 1.0)
|
|
161
|
+
fix_val = cache_solution.get('solution') or cache_solution.get('code_patch') or cache_solution.get('recommended_fix', '')
|
|
162
|
+
print(f" {GREEN}[MATCH] Found cached resolution (Score: {score_val:.2f}):{RESET}")
|
|
163
|
+
print(f" 💡 Prescribed Fix : {fix_val}")
|
|
164
|
+
plan["recommended_patch"] = fix_val
|
|
165
|
+
else:
|
|
166
|
+
# Check if error message contains broken locator pattern
|
|
167
|
+
loc_candidate_m = re.search(r"locator\(['\"]([^'\"]+)['\"]\)|By\.[a-zA-Z]+\(['\"]([^'\"]+)['\"]\)", err_sig)
|
|
168
|
+
if loc_candidate_m:
|
|
169
|
+
broken_loc = loc_candidate_m.group(1) or loc_candidate_m.group(2)
|
|
170
|
+
heuristic_res = heuristic_locator_matcher.HeuristicLocatorMatcher.match(broken_loc, dom_snapshot=aom_data if isinstance(aom_data, list) else [])
|
|
171
|
+
plan["heuristic_match"] = heuristic_res
|
|
172
|
+
if heuristic_res.get("matched"):
|
|
173
|
+
print(f" {GREEN}[HEURISTIC L{heuristic_res['layer']}] 0-Token match ({heuristic_res['confidence']*100:.1f}%): {heuristic_res['healed_locator']}{RESET}")
|
|
174
|
+
plan["recommended_patch"] = f"Update locator to: {heuristic_res['healed_locator']}"
|
|
175
|
+
else:
|
|
176
|
+
print(" [MISS] Heuristic confidence < 85%. Fallback to Live DOM exploration.")
|
|
177
|
+
plan["recommended_patch"] = "Inspect element using Playwright Live Explorer and apply resilient locator / smart wait."
|
|
178
|
+
else:
|
|
179
|
+
print(" [MISS] No direct cache match. AI Agent will inspect live DOM/AOM via Playwright.")
|
|
180
|
+
plan["recommended_patch"] = "Inspect element using Playwright Live Explorer and apply resilient locator / smart wait."
|
|
181
|
+
|
|
182
|
+
# 3. Anchor watchpoint in PROJECT_STATE.md
|
|
183
|
+
print(f"\n{BOLD}[2/2] Anchoring Watchpoint in PROJECT_STATE.md...{RESET}")
|
|
184
|
+
try:
|
|
185
|
+
project_state.update_state(
|
|
186
|
+
target_dir=target_dir,
|
|
187
|
+
watchpoint=f"{test_name} -> {failing_file}:{line_num}",
|
|
188
|
+
gate_status="HEALING_IN_PROGRESS"
|
|
189
|
+
)
|
|
190
|
+
print(" [OK] Project state watchpoint updated.")
|
|
191
|
+
except Exception as e:
|
|
192
|
+
print(f" ⚠️ Could not update PROJECT_STATE.md: {e}")
|
|
193
|
+
|
|
194
|
+
print(f"{BOLD}{CYAN}======================================================================{RESET}\n")
|
|
195
|
+
return plan
|
|
196
|
+
|
|
197
|
+
|
|
198
|
+
def record_heal_lesson(page_context, error_signature, root_cause, failed_attempt, successful_fix, lesson_summary):
|
|
199
|
+
"""Saves a 2-line practical lesson learned into SQLite after successful healing."""
|
|
200
|
+
return cache_resolver.record_lesson(
|
|
201
|
+
page_context=page_context,
|
|
202
|
+
error_signature=error_signature,
|
|
203
|
+
root_cause=root_cause,
|
|
204
|
+
failed_attempt=failed_attempt,
|
|
205
|
+
successful_fix=successful_fix,
|
|
206
|
+
lesson_summary=lesson_summary
|
|
207
|
+
)
|
|
208
|
+
|
|
209
|
+
|
|
210
|
+
def main():
|
|
211
|
+
parser = argparse.ArgumentParser(description="Autonomous Closed-Loop Test Healer")
|
|
212
|
+
parser.add_argument("target", nargs="?", default=os.getcwd(), help="Target project root directory")
|
|
213
|
+
parser.add_argument("--xml", default=None, help="Path to JUnit XML test report")
|
|
214
|
+
parser.add_argument("--record-lesson", default=None, help="Record a 2-line lesson learned after healing")
|
|
215
|
+
parser.add_argument("--context", default="GLOBAL", help="Page context for the recorded lesson")
|
|
216
|
+
parser.add_argument("--error", default="UnknownError", help="Error signature for the recorded lesson")
|
|
217
|
+
parser.add_argument("--fix", default="", help="Successful fix for the recorded lesson")
|
|
218
|
+
parser.add_argument("--reflexion", action="store_true", help="Execute multi-trial reflection loop (K=3)")
|
|
219
|
+
parser.add_argument("--max-trials", type=int, default=3, help="Max trials for reflexion healing loop")
|
|
220
|
+
parser.add_argument("--live-url", default=None, help="Live AUT URL to capture AOM snapshot via headless Playwright")
|
|
221
|
+
parser.add_argument("--aom", default=None, help="Path to pre-captured AOM JSON file")
|
|
222
|
+
args = parser.parse_args()
|
|
223
|
+
|
|
224
|
+
aom_snap = None
|
|
225
|
+
if getattr(args, "aom", None) and os.path.exists(args.aom):
|
|
226
|
+
try:
|
|
227
|
+
with open(args.aom, "r", encoding="utf-8") as af:
|
|
228
|
+
aom_snap = json.load(af)
|
|
229
|
+
except Exception as _err:
|
|
230
|
+
_ = _err
|
|
231
|
+
|
|
232
|
+
if args.record_lesson:
|
|
233
|
+
ok = record_heal_lesson(
|
|
234
|
+
page_context=args.context,
|
|
235
|
+
error_signature=args.error,
|
|
236
|
+
root_cause="Autonomous Healer Diagnosis",
|
|
237
|
+
failed_attempt="",
|
|
238
|
+
successful_fix=args.fix,
|
|
239
|
+
lesson_summary=args.record_lesson
|
|
240
|
+
)
|
|
241
|
+
if ok:
|
|
242
|
+
print(f"✅ [EPISODIC REFLEXION] Lesson recorded for '{args.context}': {args.record_lesson}")
|
|
243
|
+
return 0
|
|
244
|
+
|
|
245
|
+
if args.reflexion:
|
|
246
|
+
healer = auto_heal_reflexion.ClosedLoopHealer(max_trials=args.max_trials)
|
|
247
|
+
reflection = healer.generate_reflection(args.error, "", "")
|
|
248
|
+
print(f"\n{BOLD}{CYAN}======================================================================{RESET}")
|
|
249
|
+
print(f"{BOLD}{CYAN} MULTI-TRIAL EPISODIC REFLEXION HEALER LOOP (K={args.max_trials}) {RESET}")
|
|
250
|
+
print(f"{BOLD}{CYAN}======================================================================{RESET}")
|
|
251
|
+
print(f" Target Context : {args.context}")
|
|
252
|
+
print(f" Error Signature: {args.error}")
|
|
253
|
+
print(f" Diagnosis (VRL): {reflection}")
|
|
254
|
+
target_dir = os.path.abspath(args.target)
|
|
255
|
+
plan = diagnose_and_plan_heal(target_dir, junit_xml_path=args.xml, live_url=args.live_url, aom_snapshot=aom_snap)
|
|
256
|
+
plan["reflexion"] = {
|
|
257
|
+
"max_trials": args.max_trials,
|
|
258
|
+
"verbal_reflection": reflection,
|
|
259
|
+
"status": "INITIAL_TRIAL_DISPATCHED"
|
|
260
|
+
}
|
|
261
|
+
print(json.dumps(plan, indent=2))
|
|
262
|
+
return 0
|
|
263
|
+
|
|
264
|
+
target_dir = os.path.abspath(args.target)
|
|
265
|
+
plan = diagnose_and_plan_heal(target_dir, junit_xml_path=args.xml, live_url=args.live_url, aom_snapshot=aom_snap)
|
|
266
|
+
print(json.dumps(plan, indent=2))
|
|
267
|
+
return 0
|
|
268
|
+
|
|
269
|
+
|
|
270
|
+
if __name__ == "__main__":
|
|
271
|
+
sys.exit(main())
|