@teevee98/synapse-hub 0.0.0-stage → 3.8.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +172 -0
- package/README.md +171 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +197 -0
- package/docs/ARCHITECTURE.md +198 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +175 -0
- package/docs/CLI_REFERENCE.md +177 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +121 -0
- package/docs/QUALITY_GATES.md +121 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1359 -0
- package/docs/schemas/synapse.config.schema.json +87 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +32 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2079 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +258 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +184 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2419 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +307 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +724 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1259 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- package/tools/welcome_page.py +290 -0
|
@@ -0,0 +1,344 @@
|
|
|
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
|
+
Reversible Execution Sandbox & Automated Teardown Engine (GoEx Pattern)
|
|
8
|
+
------------------------------------------------------------------------
|
|
9
|
+
Maintains a LIFO undo-stack of stateful mutations (DB inserts, file modifications,
|
|
10
|
+
auth session cookies). Guarantees 100% idempotent teardown and zero database leakage
|
|
11
|
+
even when test execution crashes or is cancelled.
|
|
12
|
+
|
|
13
|
+
Enterprise Features:
|
|
14
|
+
1. Write-Ahead Logging (WAL) Journaling:
|
|
15
|
+
- Persists pending undo actions immediately to disk (.synapse/undo_wal.jsonl).
|
|
16
|
+
- Survives SIGKILL / sudden power cut / runner crashes with `recover_from_wal()`.
|
|
17
|
+
2. Signal & Teardown Handlers:
|
|
18
|
+
- Automatically traps SIGINT, SIGTERM, and atexit to unwind stateful mutations.
|
|
19
|
+
3. LIFO Execution Order:
|
|
20
|
+
- Strictly executes teardown in reverse chronological sequence.
|
|
21
|
+
|
|
22
|
+
Reference:
|
|
23
|
+
- Shishir Patil et al. (Gorilla / GoEx): Runtime Reversible Sandboxed Execution.
|
|
24
|
+
- Synapse-Hub Subsystem 5: Section 6.6 of agent_skill_training_analysis.md.
|
|
25
|
+
"""
|
|
26
|
+
|
|
27
|
+
import os
|
|
28
|
+
import sys
|
|
29
|
+
import time
|
|
30
|
+
import json
|
|
31
|
+
import shlex
|
|
32
|
+
import atexit
|
|
33
|
+
import signal
|
|
34
|
+
import weakref
|
|
35
|
+
import threading
|
|
36
|
+
import subprocess
|
|
37
|
+
from dataclasses import dataclass, field
|
|
38
|
+
from typing import List, Optional, Dict, Any
|
|
39
|
+
|
|
40
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
41
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
42
|
+
try:
|
|
43
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
44
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
45
|
+
except Exception:
|
|
46
|
+
pass
|
|
47
|
+
|
|
48
|
+
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
|
|
49
|
+
QA_HUB_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
def _resolve_wal_path() -> str:
|
|
53
|
+
cwd = os.path.abspath(os.getcwd())
|
|
54
|
+
try:
|
|
55
|
+
is_hub = os.path.samefile(cwd, QA_HUB_ROOT)
|
|
56
|
+
except (FileNotFoundError, OSError, ValueError):
|
|
57
|
+
is_hub = os.path.realpath(cwd).lower() == os.path.realpath(QA_HUB_ROOT).lower()
|
|
58
|
+
if not is_hub:
|
|
59
|
+
return os.path.join(cwd, ".synapse", "undo_wal.jsonl")
|
|
60
|
+
return os.path.join(QA_HUB_ROOT, ".synapse", "undo_wal.jsonl")
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
DEFAULT_WAL_PATH = _resolve_wal_path()
|
|
64
|
+
|
|
65
|
+
_ACTIVE_SANDBOXES: "weakref.WeakSet[ExecutionSandbox]" = weakref.WeakSet()
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
@dataclass
|
|
69
|
+
class ReversibleAction:
|
|
70
|
+
action_type: str # e.g., "DB_INSERT", "FS_WRITE", "AUTH_SESSION", "STATE_MUTATION"
|
|
71
|
+
target_resource: str # e.g., "users table", "tmp/test_export.csv", "Bearer token"
|
|
72
|
+
undo_command: str # Exact SQL DELETE, shell command, or callback instruction
|
|
73
|
+
metadata: Dict[str, Any] = field(default_factory=dict)
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
class ExecutionSandbox:
|
|
77
|
+
"""Manages an undo stack of stateful mutations with WAL persistence for guaranteed cleanup."""
|
|
78
|
+
|
|
79
|
+
def __init__(self, auto_rollback_on_exit: bool = True, wal_path: Optional[str] = None):
|
|
80
|
+
self.undo_stack: List[ReversibleAction] = []
|
|
81
|
+
self.auto_rollback_on_exit = auto_rollback_on_exit
|
|
82
|
+
self.wal_path = wal_path if wal_path is not None else _resolve_wal_path()
|
|
83
|
+
if self.wal_path:
|
|
84
|
+
try:
|
|
85
|
+
os.makedirs(os.path.dirname(os.path.abspath(self.wal_path)), exist_ok=True)
|
|
86
|
+
except OSError as err:
|
|
87
|
+
sys.stderr.write(f"Notice: WAL path creation skipped (read-only environment): {err}\n")
|
|
88
|
+
self.wal_path = None
|
|
89
|
+
_ACTIVE_SANDBOXES.add(self)
|
|
90
|
+
|
|
91
|
+
def _append_wal(self, action: ReversibleAction):
|
|
92
|
+
"""Persists a pending undo action to disk before side-effects complete."""
|
|
93
|
+
if not self.wal_path:
|
|
94
|
+
return
|
|
95
|
+
entry = {
|
|
96
|
+
"action_type": action.action_type,
|
|
97
|
+
"target_resource": action.target_resource,
|
|
98
|
+
"undo_command": action.undo_command,
|
|
99
|
+
"metadata": action.metadata,
|
|
100
|
+
"timestamp": time.time()
|
|
101
|
+
}
|
|
102
|
+
line = json.dumps(entry, ensure_ascii=False) + "\n"
|
|
103
|
+
try:
|
|
104
|
+
try:
|
|
105
|
+
from tools.core.file_lock import file_lock
|
|
106
|
+
with file_lock(self.wal_path + ".lock", timeout=5.0):
|
|
107
|
+
with open(self.wal_path, "a", encoding="utf-8") as f:
|
|
108
|
+
f.write(line)
|
|
109
|
+
f.flush()
|
|
110
|
+
except ImportError:
|
|
111
|
+
with open(self.wal_path, "a", encoding="utf-8") as f:
|
|
112
|
+
f.write(line)
|
|
113
|
+
f.flush()
|
|
114
|
+
except Exception as e:
|
|
115
|
+
sys.stderr.write(f"Warning: Failed to write undo WAL journal: {e}\n")
|
|
116
|
+
|
|
117
|
+
def _clear_wal(self):
|
|
118
|
+
"""Clears or resets WAL journal when stack has been completely unwound."""
|
|
119
|
+
if not self.wal_path or not os.path.exists(self.wal_path):
|
|
120
|
+
return
|
|
121
|
+
try:
|
|
122
|
+
try:
|
|
123
|
+
from tools.core.file_lock import file_lock
|
|
124
|
+
with file_lock(self.wal_path + ".lock", timeout=5.0):
|
|
125
|
+
with open(self.wal_path, "w", encoding="utf-8") as f:
|
|
126
|
+
pass
|
|
127
|
+
except ImportError:
|
|
128
|
+
with open(self.wal_path, "w", encoding="utf-8") as f:
|
|
129
|
+
pass
|
|
130
|
+
except Exception as clear_err:
|
|
131
|
+
sys.stderr.write(f"Notice: Failed to clear WAL: {clear_err}\n")
|
|
132
|
+
|
|
133
|
+
def record_mutation(
|
|
134
|
+
self,
|
|
135
|
+
action_type: str,
|
|
136
|
+
target_resource: str,
|
|
137
|
+
undo_command: str,
|
|
138
|
+
metadata: Optional[Dict[str, Any]] = None
|
|
139
|
+
):
|
|
140
|
+
"""Pushes a rollback action onto the LIFO undo stack and appends to WAL journal."""
|
|
141
|
+
action = ReversibleAction(
|
|
142
|
+
action_type=action_type,
|
|
143
|
+
target_resource=target_resource,
|
|
144
|
+
undo_command=undo_command,
|
|
145
|
+
metadata=metadata or {}
|
|
146
|
+
)
|
|
147
|
+
self.undo_stack.append(action)
|
|
148
|
+
self._append_wal(action)
|
|
149
|
+
|
|
150
|
+
def execute_stateful_action(
|
|
151
|
+
self,
|
|
152
|
+
action_type: str,
|
|
153
|
+
target_resource: str,
|
|
154
|
+
forward_cmd: str,
|
|
155
|
+
undo_cmd: str
|
|
156
|
+
) -> bool:
|
|
157
|
+
"""Executes a forward shell command and immediately records its reversible undo counterpart."""
|
|
158
|
+
try:
|
|
159
|
+
args = shlex.split(forward_cmd) if isinstance(forward_cmd, str) else forward_cmd
|
|
160
|
+
res = subprocess.run(args, text=True, capture_output=True, timeout=60.0)
|
|
161
|
+
if res.returncode == 0:
|
|
162
|
+
self.record_mutation(action_type, target_resource, undo_cmd, {"forward_cmd": forward_cmd})
|
|
163
|
+
return True
|
|
164
|
+
return False
|
|
165
|
+
except Exception:
|
|
166
|
+
return False
|
|
167
|
+
|
|
168
|
+
def rollback_all(self, silent: bool = False) -> List[Dict[str, Any]]:
|
|
169
|
+
"""Unwinds the undo stack in strictly reverse (LIFO) order and cleans WAL."""
|
|
170
|
+
results = []
|
|
171
|
+
while self.undo_stack:
|
|
172
|
+
action = self.undo_stack.pop()
|
|
173
|
+
success = True
|
|
174
|
+
err_msg = ""
|
|
175
|
+
cmd = action.undo_command.strip()
|
|
176
|
+
|
|
177
|
+
if cmd.startswith("FILE_DELETE:"):
|
|
178
|
+
fpath = cmd.split(":", 1)[1].strip()
|
|
179
|
+
if os.path.exists(fpath):
|
|
180
|
+
try:
|
|
181
|
+
os.remove(fpath)
|
|
182
|
+
except OSError as e:
|
|
183
|
+
success = False
|
|
184
|
+
err_msg = str(e)
|
|
185
|
+
elif cmd.startswith("DIR_DELETE:"):
|
|
186
|
+
dpath = cmd.split(":", 1)[1].strip()
|
|
187
|
+
if os.path.isdir(dpath):
|
|
188
|
+
try:
|
|
189
|
+
import shutil
|
|
190
|
+
shutil.rmtree(dpath, ignore_errors=True)
|
|
191
|
+
except Exception as e:
|
|
192
|
+
success = False
|
|
193
|
+
err_msg = str(e)
|
|
194
|
+
elif cmd:
|
|
195
|
+
try:
|
|
196
|
+
args = shlex.split(cmd) if isinstance(cmd, str) else cmd
|
|
197
|
+
res = subprocess.run(args, text=True, capture_output=True, timeout=60.0)
|
|
198
|
+
success = (res.returncode == 0)
|
|
199
|
+
if not success:
|
|
200
|
+
err_msg = res.stderr.strip()
|
|
201
|
+
except Exception as e:
|
|
202
|
+
success = False
|
|
203
|
+
err_msg = str(e)
|
|
204
|
+
|
|
205
|
+
result_entry = {
|
|
206
|
+
"action_type": action.action_type,
|
|
207
|
+
"target_resource": action.target_resource,
|
|
208
|
+
"undo_command": action.undo_command,
|
|
209
|
+
"success": success,
|
|
210
|
+
"error": err_msg
|
|
211
|
+
}
|
|
212
|
+
results.append(result_entry)
|
|
213
|
+
if not silent:
|
|
214
|
+
status_icon = "✅" if success else "⚠️"
|
|
215
|
+
print(f" {status_icon} [ROLLBACK] {action.action_type} on '{action.target_resource}': {action.undo_command}")
|
|
216
|
+
|
|
217
|
+
if not self.undo_stack:
|
|
218
|
+
self._clear_wal()
|
|
219
|
+
|
|
220
|
+
return results
|
|
221
|
+
|
|
222
|
+
@classmethod
|
|
223
|
+
def recover_from_wal(cls, wal_path: Optional[str] = None, silent: bool = False) -> List[Dict[str, Any]]:
|
|
224
|
+
"""
|
|
225
|
+
Recovers and unwinds uncommitted actions from a previous crashed run's WAL journal.
|
|
226
|
+
"""
|
|
227
|
+
target_wal = wal_path or DEFAULT_WAL_PATH
|
|
228
|
+
if not os.path.exists(target_wal) or os.path.getsize(target_wal) == 0:
|
|
229
|
+
return []
|
|
230
|
+
|
|
231
|
+
actions: List[ReversibleAction] = []
|
|
232
|
+
try:
|
|
233
|
+
lines = []
|
|
234
|
+
try:
|
|
235
|
+
from tools.core.file_lock import file_lock
|
|
236
|
+
with file_lock(target_wal + ".lock", timeout=5.0):
|
|
237
|
+
with open(target_wal, "r", encoding="utf-8") as f:
|
|
238
|
+
lines = [l.strip() for l in f if l.strip()]
|
|
239
|
+
except ImportError:
|
|
240
|
+
with open(target_wal, "r", encoding="utf-8") as f:
|
|
241
|
+
lines = [l.strip() for l in f if l.strip()]
|
|
242
|
+
|
|
243
|
+
for line in lines:
|
|
244
|
+
try:
|
|
245
|
+
data = json.loads(line)
|
|
246
|
+
actions.append(ReversibleAction(
|
|
247
|
+
action_type=data.get("action_type", "WAL_RECOVERED"),
|
|
248
|
+
target_resource=data.get("target_resource", ""),
|
|
249
|
+
undo_command=data.get("undo_command", ""),
|
|
250
|
+
metadata=data.get("metadata", {})
|
|
251
|
+
))
|
|
252
|
+
except (json.JSONDecodeError, KeyError, TypeError) as parse_err:
|
|
253
|
+
sys.stderr.write(f"Notice: Failed to parse WAL line: {parse_err}\n")
|
|
254
|
+
continue
|
|
255
|
+
except (OSError, IOError) as read_err:
|
|
256
|
+
sys.stderr.write(f"Notice: Failed to read WAL journal: {read_err}\n")
|
|
257
|
+
return []
|
|
258
|
+
|
|
259
|
+
if not actions:
|
|
260
|
+
return []
|
|
261
|
+
|
|
262
|
+
temp_sandbox = cls(auto_rollback_on_exit=False, wal_path=target_wal)
|
|
263
|
+
temp_sandbox.undo_stack = actions
|
|
264
|
+
results = temp_sandbox.rollback_all(silent=silent)
|
|
265
|
+
return results
|
|
266
|
+
|
|
267
|
+
def stack_size(self) -> int:
|
|
268
|
+
"""Returns the number of pending undo actions in the stack."""
|
|
269
|
+
return len(self.undo_stack)
|
|
270
|
+
|
|
271
|
+
def __enter__(self):
|
|
272
|
+
return self
|
|
273
|
+
|
|
274
|
+
def __exit__(self, exc_type, exc_val, exc_tb):
|
|
275
|
+
if exc_type is not None or self.auto_rollback_on_exit:
|
|
276
|
+
self.rollback_all(silent=True)
|
|
277
|
+
|
|
278
|
+
|
|
279
|
+
GLOBAL_SANDBOX = ExecutionSandbox(auto_rollback_on_exit=False)
|
|
280
|
+
|
|
281
|
+
|
|
282
|
+
def record_mutation(action_type: str, target: str, undo_cmd: str):
|
|
283
|
+
GLOBAL_SANDBOX.record_mutation(action_type, target, undo_cmd)
|
|
284
|
+
|
|
285
|
+
|
|
286
|
+
def rollback_all():
|
|
287
|
+
return GLOBAL_SANDBOX.rollback_all()
|
|
288
|
+
|
|
289
|
+
|
|
290
|
+
def rollback_all_active_sandboxes(silent: bool = True):
|
|
291
|
+
"""Rolls back all active sandboxes and the global singleton sandbox."""
|
|
292
|
+
for sb in list(_ACTIVE_SANDBOXES):
|
|
293
|
+
try:
|
|
294
|
+
if sb.stack_size() > 0:
|
|
295
|
+
sb.rollback_all(silent=silent)
|
|
296
|
+
except Exception as e:
|
|
297
|
+
sys.stderr.write(f"Notice: Active sandbox rollback error: {e}\n")
|
|
298
|
+
if GLOBAL_SANDBOX.stack_size() > 0:
|
|
299
|
+
GLOBAL_SANDBOX.rollback_all(silent=silent)
|
|
300
|
+
|
|
301
|
+
|
|
302
|
+
def _register_teardown_handlers():
|
|
303
|
+
"""Registers OS signal and atexit handlers for graceful recovery & rollback across all active sandboxes."""
|
|
304
|
+
# Register atexit auto-cleanup
|
|
305
|
+
atexit.register(lambda: rollback_all_active_sandboxes(silent=True))
|
|
306
|
+
|
|
307
|
+
# Register OS signals only in the main thread
|
|
308
|
+
if threading.current_thread() is threading.main_thread():
|
|
309
|
+
def _sig_handler(signum, frame):
|
|
310
|
+
try:
|
|
311
|
+
rollback_all_active_sandboxes(silent=True)
|
|
312
|
+
finally:
|
|
313
|
+
sys.exit(128 + signum)
|
|
314
|
+
|
|
315
|
+
for sig in (signal.SIGTERM, signal.SIGINT):
|
|
316
|
+
try:
|
|
317
|
+
signal.signal(sig, _sig_handler)
|
|
318
|
+
except (ValueError, AttributeError, RuntimeError) as sig_err:
|
|
319
|
+
sys.stderr.write(f"Notice: Signal registration skipped: {sig_err}\n")
|
|
320
|
+
|
|
321
|
+
|
|
322
|
+
_register_teardown_handlers()
|
|
323
|
+
|
|
324
|
+
|
|
325
|
+
if __name__ == "__main__":
|
|
326
|
+
import argparse
|
|
327
|
+
parser = argparse.ArgumentParser(description="GoEx Reversible Teardown Sandbox Stack")
|
|
328
|
+
parser.add_argument("--demo", action="store_true", help="Run reversible stack demonstration")
|
|
329
|
+
parser.add_argument("--status", action="store_true", help="Display active undo stack count")
|
|
330
|
+
parser.add_argument("--recover", action="store_true", help="Recover and roll back uncommitted WAL journal")
|
|
331
|
+
args = parser.parse_args()
|
|
332
|
+
|
|
333
|
+
if args.recover:
|
|
334
|
+
print("Recovering uncommitted mutations from WAL journal...")
|
|
335
|
+
recovers = ExecutionSandbox.recover_from_wal(silent=False)
|
|
336
|
+
print(f"Recovered and rolled back {len(recovers)} orphaned actions.")
|
|
337
|
+
elif args.demo:
|
|
338
|
+
print("Running GoEx Reversible Sandbox demo...")
|
|
339
|
+
with ExecutionSandbox(auto_rollback_on_exit=True) as sb:
|
|
340
|
+
sb.record_mutation("fs_create", "test_demo.tmp", "echo rolled back")
|
|
341
|
+
print(f"Stack size inside sandbox: {sb.stack_size()}")
|
|
342
|
+
print("Exited sandbox context, stack rolled back cleanly.")
|
|
343
|
+
else:
|
|
344
|
+
print(f"Active global undo stack size: {GLOBAL_SANDBOX.stack_size()}")
|