@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,437 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Enterprise Action Safety Firewall & Blast Radius Containment Engine
|
|
4
|
+
--------------------------------------------------------------------
|
|
5
|
+
Prevents AI agents and test runners from executing catastrophic or irreversible
|
|
6
|
+
actions on Live/Staging/UAT environments (e.g. Delete All, Purge, Wipe, Pay, Drop).
|
|
7
|
+
|
|
8
|
+
Supports:
|
|
9
|
+
- Direct action checking (--action, --text, --selector)
|
|
10
|
+
- Code snippet and script inspection (--code, --file)
|
|
11
|
+
- Pipeline stdin stream inspection (e.g. echo 'page.click(...)' | python safety_firewall.py --dry-run)
|
|
12
|
+
- Pre-execution validation hooks before Playwright/CDP browser dispatch
|
|
13
|
+
"""
|
|
14
|
+
|
|
15
|
+
import os
|
|
16
|
+
import re
|
|
17
|
+
import sys
|
|
18
|
+
import json
|
|
19
|
+
import argparse
|
|
20
|
+
from typing import List, Dict, Any, Tuple
|
|
21
|
+
|
|
22
|
+
try:
|
|
23
|
+
import reversible_sandbox
|
|
24
|
+
except ImportError:
|
|
25
|
+
reversible_sandbox = None
|
|
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
|
+
DANGEROUS_ACTION_KEYWORDS = [
|
|
36
|
+
r"\bdelete\b",
|
|
37
|
+
r"\bpurge\b",
|
|
38
|
+
r"\bwipe\b",
|
|
39
|
+
r"\bdrop\b",
|
|
40
|
+
r"\bpay\b",
|
|
41
|
+
r"\bpurchase\b",
|
|
42
|
+
r"\bplace\s+order\b",
|
|
43
|
+
r"\bconfirm\s+(?:payment|order|delete|deletion|purge|wipe|destroy)\b",
|
|
44
|
+
r"\bsubmit\s+order\b",
|
|
45
|
+
r"\barchive\s+(?:all|data|system|database|account)\b",
|
|
46
|
+
r"\brevoke\s+access\b",
|
|
47
|
+
r"\bcancel\s+subscription\b",
|
|
48
|
+
r"\berase\s+all\s+data\b",
|
|
49
|
+
r"\bterminate(?:\s+account)?\b",
|
|
50
|
+
r"\bdestroy\b",
|
|
51
|
+
r"\bformat\s+(?:disk|drive|system|database|table|partition)\b",
|
|
52
|
+
# Multilingual & Vietnamese destructive keywords with strict word boundaries
|
|
53
|
+
r"(?<!\w)x[oóòỏõọ][aáàảãạ](?!\w)",
|
|
54
|
+
r"(?<!\w)x[oóòỏõọ]a\s+t[aáàảãạ]t\s+c[aảáàãạ](?!\w)",
|
|
55
|
+
r"(?<!\w)h[uủúùũụ]y\s+b[oỏóòõọ](?!\w)",
|
|
56
|
+
r"(?<!\w)h[uủúùũụ]y\s+t[aàáảãạ]i\s+kho[aảáàãạ]n(?!\w)",
|
|
57
|
+
r"(?<!\w)thanh\s+to[aáàảãạ]n(?!\w)",
|
|
58
|
+
r"(?<!\w)r[uúùủũụ]t\s+ti[eềéèẻẽẹ]n(?!\w)",
|
|
59
|
+
r"(?<!\w)n[aạáàảã]p\s+ti[eềéèẻẽẹ]n(?!\w)",
|
|
60
|
+
]
|
|
61
|
+
|
|
62
|
+
# Explicit whitelist of benign user-flow patterns that require exact fullmatch to authorize
|
|
63
|
+
BENIGN_ACTIONS_WHITELIST = [
|
|
64
|
+
re.compile(r"(?i)^\s*(?:checkout|proceed\s+to\s+checkout)\s*$"),
|
|
65
|
+
re.compile(r"(?i)^\s*(?:reset\s+password)\s*$"),
|
|
66
|
+
re.compile(r"(?i)^\s*(?:remove\s+from\s+cart)\s*$"),
|
|
67
|
+
re.compile(r"(?i)^\s*(?:xoay\s+[aảáàãạ]nh)\s*$"),
|
|
68
|
+
]
|
|
69
|
+
|
|
70
|
+
def _split_words_and_camel(s: str) -> str:
|
|
71
|
+
"""Expands camelCase and PascalCase into separated words for keyword inspection."""
|
|
72
|
+
return re.sub(r'([a-z0-9])([A-Z])', r'\1 \2', s)
|
|
73
|
+
|
|
74
|
+
DANGEROUS_SELECTOR_PATTERNS = [
|
|
75
|
+
r"\[data-action\*=['\"]?(?:delete|pay|confirm)['\"]?\]",
|
|
76
|
+
r"\.btn-danger\b",
|
|
77
|
+
r"\.p-button-danger\b",
|
|
78
|
+
r"#(?:btn-confirm|btn-delete|btn-purge)\b",
|
|
79
|
+
r"\[aria-label\*=['\"]?(?:delete|pay|confirm)['\"]?\]",
|
|
80
|
+
r"button[#\.\-_a-zA-Z0-9]*[_\-]*(?:del|delete|purge|wipe|drop|confirm|archive)",
|
|
81
|
+
r":(?:has-text|text)\s*\(\s*(['\"])[^'\"]*(?:delete|wipe|purge|pay|confirm|archive|x[oóòỏõọ][aáàảãạ]|h[uủúùũụ]y\s+b[oỏóòõọ]|thanh\s*to[aáàảãạ]n)[^'\"]*\1\s*\)",
|
|
82
|
+
r"text=(['\"])[^'\"]*(?:delete|wipe|purge|pay|confirm|archive|x[oóòỏõọ][aáàảãạ]|h[uủúùũụ]y\s+b[oỏóòõọ]|thanh\s*to[aáàảãạ]n)\1",
|
|
83
|
+
]
|
|
84
|
+
|
|
85
|
+
COMPILED_TEXT_REGEX = re.compile("|".join(DANGEROUS_ACTION_KEYWORDS), re.IGNORECASE)
|
|
86
|
+
COMPILED_SEL_REGEX = re.compile("|".join(DANGEROUS_SELECTOR_PATTERNS), re.IGNORECASE)
|
|
87
|
+
|
|
88
|
+
# Pattern to extract interaction statements from Playwright / Selenium / Groovy
|
|
89
|
+
INTERACTION_CODE_PATTERNS = [
|
|
90
|
+
# page.click('selector'), page.fill('selector', 'val') - supports nested quotes
|
|
91
|
+
re.compile(r"""(?:page|frame)\.(?P<act>click|dblclick|fill|type|press|check)\s*\(\s*(?P<q>['"])(?P<sel>(?:(?!(?P=q)|\\).|\\.)*)(?P=q)(?:\s*,\s*['"](?P<text>[^'"]*)['"])?""", re.IGNORECASE),
|
|
92
|
+
# page.locator('selector').click() or page.locator(VAR).click()
|
|
93
|
+
re.compile(r"""(?:page|frame)\.locator\s*\(\s*(?:(?P<q>['"])(?P<sel>(?:(?!(?P=q)|\\).|\\.)*)(?P=q)|(?P<var_arg>[a-zA-Z0-9_]+))\s*\)\.(?P<act>click|fill|press)""", re.IGNORECASE),
|
|
94
|
+
# page.getByText('text').click()
|
|
95
|
+
re.compile(r"""(?:page|frame)\.getByText\s*\(\s*(?P<q>['"])(?P<text>(?:(?!(?P=q)|\\).|\\.)*)(?P=q)\s*\)\.(?P<act>click)""", re.IGNORECASE),
|
|
96
|
+
# page.getByRole('button', { name: 'Delete' }).click()
|
|
97
|
+
re.compile(r"""(?:page|frame)\.getByRole\s*\(\s*['"](?P<role>[^'"]+)['"]\s*,\s*\{[^}]*name:\s*['"](?P<text>[^'"]+)['"]""", re.IGNORECASE),
|
|
98
|
+
# WebUI.click(findTestObject(...)) or WebUI.clickOffset
|
|
99
|
+
re.compile(r"""WebUI\.(?P<act>click|setText)\s*\([^)]*['"](?P<sel>[^'"]*)['"]""", re.IGNORECASE),
|
|
100
|
+
# Variable locator call: e.g. deleteBtn.click(), btn.click()
|
|
101
|
+
re.compile(r"""\b(?!(?:page|frame|WebUI)\b)(?P<var>[a-zA-Z0-9_]+)\.(?P<act>click|dblclick|fill|press|tap)\s*\(""", re.IGNORECASE),
|
|
102
|
+
# Clean POM method invocation: e.g. customerPage.deleteAllCustomers(), accountPO.purgeAccount(userId)
|
|
103
|
+
re.compile(r"""\b(?!(?:page|frame|WebUI)\b)(?P<page>[a-zA-Z0-9_]*(?:Page|PO|View|Service|Component|[a-z]))\.(?P<act>[a-zA-Z0-9_]+)\s*\((?P<args>[^)]*)\)""", re.IGNORECASE),
|
|
104
|
+
]
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
def is_action_dangerous(action_type: str, text: str = "", selector: str = "") -> Tuple[bool, str]:
|
|
108
|
+
"""
|
|
109
|
+
Evaluates whether an intended action touches a dangerous or irreversible UI element.
|
|
110
|
+
Returns (is_dangerous: bool, reason: str).
|
|
111
|
+
"""
|
|
112
|
+
text_clean = text.strip() if text else ""
|
|
113
|
+
sel_clean = selector.strip() if selector else ""
|
|
114
|
+
act_clean = action_type.strip() if action_type else "click"
|
|
115
|
+
|
|
116
|
+
# 1. Action type verification
|
|
117
|
+
act_expanded = _split_words_and_camel(act_clean)
|
|
118
|
+
if act_clean.lower() in ("drop_database", "wipe_environment", "execute_payment"):
|
|
119
|
+
return True, f"Action type '{action_type}' is classified as irreversible"
|
|
120
|
+
match_act = COMPILED_TEXT_REGEX.search(act_clean) or COMPILED_TEXT_REGEX.search(act_expanded)
|
|
121
|
+
if match_act:
|
|
122
|
+
return True, f"Action method contains dangerous verb: '{match_act.group(0)}'"
|
|
123
|
+
|
|
124
|
+
# 2. Check text (Dangerous check runs FIRST; benign whitelist requires strict fullmatch)
|
|
125
|
+
if text_clean:
|
|
126
|
+
text_expanded = _split_words_and_camel(text_clean)
|
|
127
|
+
match = COMPILED_TEXT_REGEX.search(text_clean) or COMPILED_TEXT_REGEX.search(text_expanded)
|
|
128
|
+
if match:
|
|
129
|
+
# Check strict benign whitelist fullmatch before flagging
|
|
130
|
+
if any(p.fullmatch(text_clean) for p in BENIGN_ACTIONS_WHITELIST):
|
|
131
|
+
pass
|
|
132
|
+
else:
|
|
133
|
+
return True, f"Element text contains dangerous keyword: '{match.group(0)}'"
|
|
134
|
+
|
|
135
|
+
# 3. Check selector
|
|
136
|
+
if sel_clean:
|
|
137
|
+
if not any(p.fullmatch(sel_clean) for p in BENIGN_ACTIONS_WHITELIST):
|
|
138
|
+
if COMPILED_SEL_REGEX.search(sel_clean):
|
|
139
|
+
return True, f"Element selector matches destructive pattern: '{sel_clean}'"
|
|
140
|
+
sel_expanded = _split_words_and_camel(sel_clean)
|
|
141
|
+
match = COMPILED_TEXT_REGEX.search(sel_clean) or COMPILED_TEXT_REGEX.search(sel_expanded)
|
|
142
|
+
if match:
|
|
143
|
+
return True, f"Element selector contains dangerous keyword: '{match.group(0)}' in '{sel_clean}'"
|
|
144
|
+
|
|
145
|
+
return False, "Action passed safety firewall inspection"
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def inspect_and_authorize(action_type: str, text: str = "", selector: str = "", force: bool = False) -> Dict[str, Any]:
|
|
149
|
+
"""
|
|
150
|
+
Evaluates action and checks authorization policy.
|
|
151
|
+
Bypass is permitted only if force=True or ALLOW_DESTRUCTIVE=1 environment variable is set.
|
|
152
|
+
"""
|
|
153
|
+
dangerous, reason = is_action_dangerous(action_type, text, selector)
|
|
154
|
+
bypass = force or os.environ.get("ALLOW_DESTRUCTIVE", "").lower() in ("true", "1", "yes")
|
|
155
|
+
|
|
156
|
+
result = {
|
|
157
|
+
"action": action_type,
|
|
158
|
+
"text": text,
|
|
159
|
+
"selector": selector,
|
|
160
|
+
"dangerous": dangerous,
|
|
161
|
+
"reason": reason,
|
|
162
|
+
"authorized": (not dangerous) or bypass,
|
|
163
|
+
"bypass_granted": bypass if dangerous else False
|
|
164
|
+
}
|
|
165
|
+
return result
|
|
166
|
+
|
|
167
|
+
|
|
168
|
+
def inspect_code_snippet(code: str, force: bool = False) -> List[Dict[str, Any]]:
|
|
169
|
+
"""
|
|
170
|
+
Parses a code snippet or script and checks all discovered UI interaction statements.
|
|
171
|
+
Tracks variable locator assignments across lines to detect chained and indirect invocations.
|
|
172
|
+
"""
|
|
173
|
+
inspections = []
|
|
174
|
+
lines = code.splitlines()
|
|
175
|
+
tracked_vars: Dict[str, str] = {}
|
|
176
|
+
|
|
177
|
+
var_assign_re = re.compile(
|
|
178
|
+
r"""(?:const|let|var|def|\$)?\s*(?P<var>[a-zA-Z0-9_]+)\s*=\s*(?:(?:page|frame)\.(?:locator|getByTestId|getByText)\s*\(\s*(?:(?P<q1>['"])(?P<val1>(?:(?!(?P=q1)|\\).|\\.)*)(?P=q1)|(?P<arg_var>[a-zA-Z0-9_]+))\s*\)|(?:page|frame)\.getByRole\s*\(\s*['"][^'"]+['"]\s*,\s*\{[^}]*name:\s*(?P<q_role>['"])(?P<val_role>(?:(?!(?P=q_role)|\\).|\\.)*)(?P=q_role)|(?P<q2>['"])(?P<val2>(?:(?!(?P=q2)|\\).|\\.)*)(?P=q2))""",
|
|
179
|
+
re.IGNORECASE
|
|
180
|
+
)
|
|
181
|
+
|
|
182
|
+
for line_idx, line in enumerate(lines, start=1):
|
|
183
|
+
stripped = line.strip()
|
|
184
|
+
if not stripped or stripped.startswith(("//", "#", "/*", "*")):
|
|
185
|
+
continue
|
|
186
|
+
|
|
187
|
+
# Track variable definitions
|
|
188
|
+
m_assign = var_assign_re.search(stripped)
|
|
189
|
+
if m_assign:
|
|
190
|
+
var_name = m_assign.group("var")
|
|
191
|
+
val = m_assign.group("val1") or m_assign.group("val2") or m_assign.group("val_role") or ""
|
|
192
|
+
if not val and m_assign.group("arg_var"):
|
|
193
|
+
arg_v = m_assign.group("arg_var")
|
|
194
|
+
val = tracked_vars.get(arg_v, arg_v)
|
|
195
|
+
# Recursively unwrap aliases
|
|
196
|
+
while val in tracked_vars:
|
|
197
|
+
val = tracked_vars[val]
|
|
198
|
+
if var_name and val:
|
|
199
|
+
tracked_vars[var_name] = val
|
|
200
|
+
|
|
201
|
+
matched = False
|
|
202
|
+
for pattern in INTERACTION_CODE_PATTERNS:
|
|
203
|
+
found_any = False
|
|
204
|
+
for match in pattern.finditer(line):
|
|
205
|
+
groups = match.groupdict()
|
|
206
|
+
act = groups.get("act") or "click"
|
|
207
|
+
sel = groups.get("sel") or ""
|
|
208
|
+
text = groups.get("text") or ""
|
|
209
|
+
var_arg = groups.get("var_arg")
|
|
210
|
+
var_name = groups.get("var")
|
|
211
|
+
|
|
212
|
+
if var_arg:
|
|
213
|
+
sel = tracked_vars.get(var_arg, var_arg)
|
|
214
|
+
elif not sel and groups.get("page"):
|
|
215
|
+
sel = f"{groups.get('page')}.{act}"
|
|
216
|
+
elif not sel and var_name:
|
|
217
|
+
sel = tracked_vars.get(var_name, var_name)
|
|
218
|
+
|
|
219
|
+
# Recursively unwrap selector if it matches an alias
|
|
220
|
+
while sel in tracked_vars:
|
|
221
|
+
sel = tracked_vars[sel]
|
|
222
|
+
|
|
223
|
+
auth = inspect_and_authorize(act, text=text, selector=sel, force=force)
|
|
224
|
+
auth["line"] = line_idx
|
|
225
|
+
auth["code"] = stripped
|
|
226
|
+
inspections.append(auth)
|
|
227
|
+
found_any = True
|
|
228
|
+
if found_any:
|
|
229
|
+
matched = True
|
|
230
|
+
break
|
|
231
|
+
|
|
232
|
+
# Fallback: line itself contains dangerous keyword and an action verb (ignore pure assignments)
|
|
233
|
+
if not matched and not m_assign:
|
|
234
|
+
line_expanded = _split_words_and_camel(stripped)
|
|
235
|
+
if (COMPILED_TEXT_REGEX.search(stripped) or COMPILED_TEXT_REGEX.search(line_expanded)) and any(w in stripped.lower() for w in ("click", "press", "submit", "post", "delete", "purge", "wipe", "drop", "pay")):
|
|
236
|
+
auth = inspect_and_authorize("dispatch", text=stripped, selector="", force=force)
|
|
237
|
+
auth["line"] = line_idx
|
|
238
|
+
auth["code"] = stripped
|
|
239
|
+
inspections.append(auth)
|
|
240
|
+
|
|
241
|
+
return inspections
|
|
242
|
+
|
|
243
|
+
|
|
244
|
+
def detect_action_loop(action_history: List[str], repeat_threshold: int = 4) -> Dict[str, Any]:
|
|
245
|
+
"""
|
|
246
|
+
Detects infinite action loops and repeating cycle patterns among agent tool calls.
|
|
247
|
+
Inspired by agentblazo/blazo deterministic detection rules.
|
|
248
|
+
|
|
249
|
+
Checks:
|
|
250
|
+
1. Consecutive identical actions (>= repeat_threshold)
|
|
251
|
+
2. 2-action repeating cycle: [A, B, A, B]
|
|
252
|
+
3. 3-action repeating cycle: [A, B, C, A, B, C]
|
|
253
|
+
"""
|
|
254
|
+
if not action_history or len(action_history) < 2:
|
|
255
|
+
return {"loop_detected": False, "reason": "History too short", "severity": "none", "pattern": []}
|
|
256
|
+
|
|
257
|
+
names = [a.strip() for a in action_history if a.strip()]
|
|
258
|
+
|
|
259
|
+
# 1. Check consecutive identical repeats
|
|
260
|
+
i = 0
|
|
261
|
+
while i < len(names):
|
|
262
|
+
name = names[i]
|
|
263
|
+
end = i + 1
|
|
264
|
+
while end < len(names) and names[end] == name:
|
|
265
|
+
end += 1
|
|
266
|
+
length = end - i
|
|
267
|
+
if length >= repeat_threshold:
|
|
268
|
+
return {
|
|
269
|
+
"loop_detected": True,
|
|
270
|
+
"type": "consecutive_repeat",
|
|
271
|
+
"severity": "critical",
|
|
272
|
+
"message": f"Possible loop: action '{name}' repeated {length} times in a row",
|
|
273
|
+
"pattern": [name] * length
|
|
274
|
+
}
|
|
275
|
+
i = end
|
|
276
|
+
|
|
277
|
+
# 2. Check 2-action and 3-action trailing cycles
|
|
278
|
+
for block in (2, 3):
|
|
279
|
+
if len(names) < block * 2:
|
|
280
|
+
continue
|
|
281
|
+
start = len(names) - block * 2
|
|
282
|
+
left_block = names[start : start + block]
|
|
283
|
+
right_block = names[start + block : start + block * 2]
|
|
284
|
+
if left_block == right_block and len(set(left_block)) >= 2:
|
|
285
|
+
pattern_str = " -> ".join(left_block)
|
|
286
|
+
return {
|
|
287
|
+
"loop_detected": True,
|
|
288
|
+
"type": f"cycle_{block}",
|
|
289
|
+
"severity": "critical",
|
|
290
|
+
"message": f"Possible loop: cycle pattern [{pattern_str}] repeated",
|
|
291
|
+
"pattern": left_block
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
return {"loop_detected": False, "reason": "No loop patterns detected", "severity": "none", "pattern": []}
|
|
295
|
+
|
|
296
|
+
|
|
297
|
+
def main():
|
|
298
|
+
parser = argparse.ArgumentParser(description="Action Safety Firewall & Blast Radius Containment Engine")
|
|
299
|
+
parser.add_argument("--action", default="click", help="Action type (click, fill, submit)")
|
|
300
|
+
parser.add_argument("--text", default="", help="Text content of target element")
|
|
301
|
+
parser.add_argument("--selector", default="", help="CSS/XPath selector of target element")
|
|
302
|
+
parser.add_argument("--code", default="", help="Direct code snippet or command line to evaluate (use '-' for stdin)")
|
|
303
|
+
parser.add_argument("--file", default="", help="Path to script file to evaluate")
|
|
304
|
+
parser.add_argument("--stdin", action="store_true", help="Read code or action from standard input")
|
|
305
|
+
parser.add_argument("--dry-run", action="store_true", help="Execute in pre-execution dry-run mode (outputs validation report)")
|
|
306
|
+
parser.add_argument("--force", action="store_true", help="Force bypass safety firewall")
|
|
307
|
+
parser.add_argument("--json", action="store_true", help="Output results in JSON format")
|
|
308
|
+
parser.add_argument("--history", default="", help="Comma-separated or JSON list of historical action names to check for infinite loops")
|
|
309
|
+
parser.add_argument("--check-loop", action="store_true", help="Explicitly audit action history for cycle/infinite loops")
|
|
310
|
+
parser.add_argument("--rollback-all", action="store_true", help="Unwind all recorded reversible actions via GoEx teardown stack")
|
|
311
|
+
parser.add_argument("--record-undo", default="", help="Undo command to push onto reversible sandbox stack")
|
|
312
|
+
parser.add_argument("--undo-target", default="STATE_MUTATION", help="Target resource or type for recorded undo action")
|
|
313
|
+
args = parser.parse_args()
|
|
314
|
+
|
|
315
|
+
# Reversible Execution Sandbox teardown (GoEx pattern)
|
|
316
|
+
if args.rollback_all:
|
|
317
|
+
if reversible_sandbox:
|
|
318
|
+
res = reversible_sandbox.rollback_all()
|
|
319
|
+
if args.json:
|
|
320
|
+
print(json.dumps(res, indent=2))
|
|
321
|
+
return 0
|
|
322
|
+
else:
|
|
323
|
+
print("❌ reversible_sandbox module not available.")
|
|
324
|
+
return 1
|
|
325
|
+
|
|
326
|
+
if args.record_undo:
|
|
327
|
+
if reversible_sandbox:
|
|
328
|
+
reversible_sandbox.record_mutation("STATE_MUTATION", args.undo_target, args.record_undo)
|
|
329
|
+
print(f"✅ [GOEX SANDBOX] Reversible action registered for '{args.undo_target}': {args.record_undo}")
|
|
330
|
+
return 0
|
|
331
|
+
else:
|
|
332
|
+
print("❌ reversible_sandbox module not available.")
|
|
333
|
+
return 1
|
|
334
|
+
|
|
335
|
+
# Loop check mode (Blazo-inspired)
|
|
336
|
+
if args.history or args.check_loop:
|
|
337
|
+
hist_items = []
|
|
338
|
+
if args.history:
|
|
339
|
+
if args.history.strip().startswith("[") and args.history.strip().endswith("]"):
|
|
340
|
+
try:
|
|
341
|
+
hist_items = json.loads(args.history)
|
|
342
|
+
except Exception:
|
|
343
|
+
hist_items = [h.strip() for h in args.history.split(",") if h.strip()]
|
|
344
|
+
else:
|
|
345
|
+
hist_items = [h.strip() for h in args.history.split(",") if h.strip()]
|
|
346
|
+
|
|
347
|
+
loop_res = detect_action_loop(hist_items)
|
|
348
|
+
if args.json:
|
|
349
|
+
print(json.dumps(loop_res, indent=2))
|
|
350
|
+
else:
|
|
351
|
+
if loop_res["loop_detected"]:
|
|
352
|
+
print(f"❌ [LOOP_DETECTED] {loop_res['message']} (Severity: {loop_res['severity'].upper()})")
|
|
353
|
+
else:
|
|
354
|
+
print("✅ [LOOP_CLEAR] No infinite loop or cycle pattern detected in action history.")
|
|
355
|
+
return 1 if loop_res["loop_detected"] else 0
|
|
356
|
+
|
|
357
|
+
# Determine input source: explicit stdin flag/arg, --file, --code, or parameters
|
|
358
|
+
code_content = ""
|
|
359
|
+
if args.code and args.code != "-":
|
|
360
|
+
code_content = args.code
|
|
361
|
+
elif args.file and os.path.exists(args.file):
|
|
362
|
+
with open(args.file, "r", encoding="utf-8", errors="ignore") as f:
|
|
363
|
+
code_content = f.read()
|
|
364
|
+
elif args.stdin or args.code == "-":
|
|
365
|
+
try:
|
|
366
|
+
stdin_data = sys.stdin.read().strip()
|
|
367
|
+
if stdin_data:
|
|
368
|
+
# Check if stdin is JSON
|
|
369
|
+
if stdin_data.startswith("{") and stdin_data.endswith("}"):
|
|
370
|
+
try:
|
|
371
|
+
parsed = json.loads(stdin_data)
|
|
372
|
+
if "action" in parsed or "selector" in parsed:
|
|
373
|
+
args.action = parsed.get("action", args.action)
|
|
374
|
+
args.text = parsed.get("text", args.text)
|
|
375
|
+
args.selector = parsed.get("selector", args.selector)
|
|
376
|
+
else:
|
|
377
|
+
code_content = stdin_data
|
|
378
|
+
except Exception:
|
|
379
|
+
code_content = stdin_data
|
|
380
|
+
else:
|
|
381
|
+
code_content = stdin_data
|
|
382
|
+
except OSError:
|
|
383
|
+
code_content = ""
|
|
384
|
+
|
|
385
|
+
# Evaluation
|
|
386
|
+
if code_content:
|
|
387
|
+
inspections = inspect_code_snippet(code_content, force=args.force)
|
|
388
|
+
has_blocked = any(not item["authorized"] for item in inspections)
|
|
389
|
+
all_authorized = not has_blocked
|
|
390
|
+
|
|
391
|
+
report = {
|
|
392
|
+
"mode": "dry-run" if args.dry_run else "enforce",
|
|
393
|
+
"total_inspected": len(inspections),
|
|
394
|
+
"authorized": all_authorized,
|
|
395
|
+
"blocked_count": sum(1 for item in inspections if not item["authorized"]),
|
|
396
|
+
"inspections": inspections
|
|
397
|
+
}
|
|
398
|
+
|
|
399
|
+
if args.json:
|
|
400
|
+
print(json.dumps(report, indent=2))
|
|
401
|
+
else:
|
|
402
|
+
tag = "DRY-RUN INSPECTION" if args.dry_run else "FIREWALL SENTINEL"
|
|
403
|
+
print(f"\n🛡️ [{tag}] Inspected {len(inspections)} interaction statements:")
|
|
404
|
+
for item in inspections:
|
|
405
|
+
status = "[PASS]" if item["authorized"] else "[BLOCKED]"
|
|
406
|
+
line_info = f"Line {item.get('line', '?')}: " if 'line' in item else ""
|
|
407
|
+
print(f" {status} {line_info}{item['action']} -> {item['reason']}")
|
|
408
|
+
if not item["authorized"]:
|
|
409
|
+
print(f" Code: {item.get('code', '')}")
|
|
410
|
+
|
|
411
|
+
if all_authorized:
|
|
412
|
+
print(f"\n✅ All actions cleared by Safety Firewall{' (Dry-Run)' if args.dry_run else ''}.\n")
|
|
413
|
+
else:
|
|
414
|
+
print("\n❌ Pre-execution Blocked: Destructive actions intercepted without --force or ALLOW_DESTRUCTIVE=1.\n")
|
|
415
|
+
|
|
416
|
+
return 0 if all_authorized else 1
|
|
417
|
+
|
|
418
|
+
# Single-action check (legacy / parameter mode)
|
|
419
|
+
auth = inspect_and_authorize(args.action, args.text, args.selector, args.force)
|
|
420
|
+
auth["mode"] = "dry-run" if args.dry_run else "enforce"
|
|
421
|
+
|
|
422
|
+
if args.json:
|
|
423
|
+
print(json.dumps(auth, indent=2))
|
|
424
|
+
else:
|
|
425
|
+
prefix = "[DRY-RUN] " if args.dry_run else ""
|
|
426
|
+
if auth["authorized"]:
|
|
427
|
+
status_tag = f"{prefix}[PASS] Action Authorized" if not auth["dangerous"] else f"{prefix}[BYPASS] Destructive Action Force-Authorized"
|
|
428
|
+
print(f"🛡️ {status_tag}: {auth['reason']}")
|
|
429
|
+
else:
|
|
430
|
+
print(f"❌ {prefix}[BLOCKED] Action Safety Firewall Intercepted: {auth['reason']}")
|
|
431
|
+
print(" 👉 To authorize, pass --force or set ALLOW_DESTRUCTIVE=1.")
|
|
432
|
+
|
|
433
|
+
return 0 if auth["authorized"] else 1
|
|
434
|
+
|
|
435
|
+
|
|
436
|
+
if __name__ == "__main__":
|
|
437
|
+
sys.exit(main())
|