@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,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()}")