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