@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.
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 +171 -0
  190. package/README.md +170 -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 +198 -0
  196. package/docs/ARCHITECTURE.md +199 -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 +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -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 +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -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 +31 -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 +2074 -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 +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -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 +2403 -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 +306 -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 +725 -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 +1271 -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,253 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Environment & Secret Decoupling Engine
4
+ ---------------------------------------
5
+ Scans automation test suites (Playwright, Katalon, Selenium, Cypress) for hardcoded
6
+ environment values (URLs, credentials, bearer tokens, DB connection strings).
7
+ Decouples them into standardized environment configurations:
8
+ 1. config/profiles/env.default.json
9
+ 2. .env.example
10
+ 3. Replaces hardcoded literals in AST/sources with process.env / os.getenv references.
11
+ """
12
+
13
+ import os
14
+ import re
15
+ import sys
16
+ import json
17
+ import argparse
18
+ from typing import Dict, List, Any, Tuple, Optional
19
+
20
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
21
+ if hasattr(sys.stdout, 'reconfigure'):
22
+ try:
23
+ sys.stdout.reconfigure(encoding='utf-8')
24
+ sys.stderr.reconfigure(encoding='utf-8')
25
+ except Exception:
26
+ pass
27
+
28
+ # Regex patterns for sensitive literals
29
+ URL_PATTERN = re.compile(r'https?://(?!www\.w3\.org|json-schema\.org|schemas\.xmlsoap\.org)[a-zA-Z0-9.\-]+(?::\d+)?(?:/[a-zA-Z0-9_\.\-~%!$&\'()*+,;=:@]*)*')
30
+ PASSWORD_PATTERN = re.compile(r'(?i)(?:password|secret|pwd|pass|client_secret)\s*[:=]\s*["\']([^"\']{4,})["\']')
31
+ TOKEN_PATTERN = re.compile(r'(?i)\b(?:Bearer\s+([A-Za-z0-9_\-\.]{16,})|api[_\-]?key\s*[:=]\s*["\']([A-Za-z0-9_\-]{16,})["\'])')
32
+ DB_URL_PATTERN = re.compile(r'(?:mongodb|mysql|postgres|postgresql|jdbc:[a-z0-9]+)://[^\s"\'<>]+')
33
+
34
+
35
+ class ConfigDecoupler:
36
+ """Automated configuration and credentials decoupling engine."""
37
+
38
+ def __init__(self, target_dir: str):
39
+ self.target_dir = os.path.abspath(target_dir)
40
+ self.decoupled_configs: Dict[str, Any] = {
41
+ "APP_BASE_URL": "http://localhost:3000",
42
+ "TEST_USER_USERNAME": "test_user@example.com",
43
+ "TEST_USER_PASSWORD": "TestPassword123!",
44
+ "API_AUTH_TOKEN": "mock_auth_token_secret"
45
+ }
46
+ self.findings: List[Dict[str, Any]] = []
47
+
48
+ def scan(self) -> List[Dict[str, Any]]:
49
+ """Scans the target directory for hardcoded URLs, credentials, and secrets."""
50
+ extensions = {".ts", ".js", ".groovy", ".java", ".py", ".json"}
51
+ exclude_dirs = {"node_modules", ".git", ".gradle", "build", "dist", "__pycache__", "config"}
52
+
53
+ for root, dirs, files in os.walk(self.target_dir):
54
+ dirs[:] = [d for d in dirs if d not in exclude_dirs]
55
+ for file_name in files:
56
+ ext = os.path.splitext(file_name)[1].lower()
57
+ if ext in extensions:
58
+ file_path = os.path.join(root, file_name)
59
+ self._scan_file(file_path)
60
+
61
+ return self.findings
62
+
63
+ def _scan_file(self, file_path: str):
64
+ try:
65
+ with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
66
+ content = f.read()
67
+ except OSError as err:
68
+ sys.stderr.write(f"[CONFIG-DECOUPLER] Warning reading {file_path}: {err}\n")
69
+ return
70
+
71
+ rel_path = os.path.relpath(file_path, self.target_dir).replace("\\", "/")
72
+ lines = content.splitlines()
73
+
74
+ for idx, line in enumerate(lines, 1):
75
+ if line.strip().startswith("//") or line.strip().startswith("#"):
76
+ continue
77
+
78
+ # 1. URLs
79
+ for url in URL_PATTERN.findall(line):
80
+ key = "APP_BASE_URL"
81
+ self.decoupled_configs[key] = url
82
+ self.findings.append({
83
+ "file": rel_path,
84
+ "line": idx,
85
+ "type": "URL",
86
+ "key": key,
87
+ "literal": url,
88
+ "replacement": f"process.env.{key} || '{url}'"
89
+ })
90
+
91
+ # 2. Passwords
92
+ for pwd in PASSWORD_PATTERN.findall(line):
93
+ key = "TEST_USER_PASSWORD"
94
+ self.decoupled_configs[key] = pwd
95
+ self.findings.append({
96
+ "file": rel_path,
97
+ "line": idx,
98
+ "type": "PASSWORD",
99
+ "key": key,
100
+ "literal": pwd,
101
+ "replacement": f"process.env.{key}"
102
+ })
103
+
104
+ # 3. Tokens
105
+ for t_match in TOKEN_PATTERN.findall(line):
106
+ token = t_match[0] or t_match[1]
107
+ if token:
108
+ key = "API_AUTH_TOKEN"
109
+ self.decoupled_configs[key] = token
110
+ self.findings.append({
111
+ "file": rel_path,
112
+ "line": idx,
113
+ "type": "TOKEN",
114
+ "key": key,
115
+ "literal": token,
116
+ "replacement": f"process.env.{key}"
117
+ })
118
+
119
+ # 4. DB URLs
120
+ for db_url in DB_URL_PATTERN.findall(line):
121
+ key = "DATABASE_URL"
122
+ self.decoupled_configs[key] = db_url
123
+ self.findings.append({
124
+ "file": rel_path,
125
+ "line": idx,
126
+ "type": "DATABASE_URL",
127
+ "key": key,
128
+ "literal": db_url,
129
+ "replacement": f"process.env.{key}"
130
+ })
131
+
132
+ def export_configs(self, output_dir: Optional[str] = None) -> Tuple[str, str]:
133
+ """Generates env.default.json and .env.example configuration files."""
134
+ out_base = output_dir or os.path.join(self.target_dir, "config", "profiles")
135
+ os.makedirs(out_base, exist_ok=True)
136
+
137
+ json_path = os.path.join(out_base, "env.default.json")
138
+ with open(json_path, "w", encoding="utf-8") as f:
139
+ json.dump(self.decoupled_configs, f, indent=2)
140
+
141
+ env_example_path = os.path.join(self.target_dir, ".env.example")
142
+ env_lines = [
143
+ "# ===================================================================",
144
+ "# AUTO-GENERATED ENVIRONMENT CONFIGURATION TEMPLATE",
145
+ "# Decoupled via tools/config_decoupler.py",
146
+ "# ===================================================================",
147
+ ""
148
+ ]
149
+ for k, v in self.decoupled_configs.items():
150
+ env_lines.append(f"{k}={v}")
151
+
152
+ with open(env_example_path, "w", encoding="utf-8") as f:
153
+ f.write("\n".join(env_lines) + "\n")
154
+
155
+ return json_path, env_example_path
156
+
157
+ def apply_decoupling(self) -> int:
158
+ """Replaces detected hardcoded literals with decoupled environment references in-place."""
159
+ modified_count = 0
160
+ grouped_by_file: Dict[str, List[Dict[str, Any]]] = {}
161
+ for f in self.findings:
162
+ grouped_by_file.setdefault(f["file"], []).append(f)
163
+
164
+ for rel_file, items in grouped_by_file.items():
165
+ full_path = os.path.join(self.target_dir, rel_file)
166
+ if not os.path.exists(full_path):
167
+ continue
168
+
169
+ try:
170
+ with open(full_path, "r", encoding="utf-8") as fp:
171
+ content = fp.read()
172
+ except Exception:
173
+ continue
174
+
175
+ new_content = content
176
+ ext = os.path.splitext(full_path)[1].lower()
177
+
178
+ for it in items:
179
+ lit = it["literal"]
180
+ key = it["key"]
181
+
182
+ if ext in {".ts", ".js"}:
183
+ replacement = f"process.env.{key} || '{lit}'" if it["type"] == "URL" else f"process.env.{key}"
184
+ elif ext == ".py":
185
+ replacement = f"os.getenv('{key}', '{lit}')" if it["type"] == "URL" else f"os.getenv('{key}')"
186
+ elif ext in {".groovy", ".java"}:
187
+ replacement = f"(System.getenv('{key}') ?: '{lit}')" if it["type"] == "URL" else f"System.getenv('{key}')"
188
+ else:
189
+ replacement = f"${{{key}}}"
190
+
191
+ # Only replace quotes wrapped around literal
192
+ new_content = new_content.replace(f"'{lit}'", replacement)
193
+ new_content = new_content.replace(f'"{lit}"', replacement)
194
+
195
+ if new_content != content:
196
+ with open(full_path, "w", encoding="utf-8") as fp:
197
+ fp.write(new_content)
198
+ modified_count += 1
199
+
200
+ return modified_count
201
+
202
+
203
+ def main():
204
+ parser = argparse.ArgumentParser(description="Automated Environment & Secret Decoupling Engine")
205
+ parser.add_argument("target", nargs="?", default=os.getcwd(), help="Target project root directory")
206
+ parser.add_argument("--fix", action="store_true", help="Apply decoupling modifications in-place to files")
207
+ parser.add_argument("--out-dir", default=None, help="Output directory for config profiles")
208
+ parser.add_argument("--json", action="store_true", help="Output results in JSON format")
209
+ args = parser.parse_args()
210
+
211
+ decoupler = ConfigDecoupler(args.target)
212
+ findings = decoupler.scan()
213
+ json_path, env_path = decoupler.export_configs(args.out_dir)
214
+
215
+ if args.fix:
216
+ modified = decoupler.apply_decoupling()
217
+
218
+ if args.json:
219
+ print(json.dumps({
220
+ "target": decoupler.target_dir,
221
+ "total_findings": len(findings),
222
+ "findings": findings,
223
+ "config_json": json_path,
224
+ "env_example": env_path
225
+ }, indent=2))
226
+ else:
227
+ print("\n======================================================================")
228
+ print(" ENVIRONMENT & SECRET DECOUPLING ENGINE (HERMETIC CONFIG) ")
229
+ print("======================================================================")
230
+ print(f"📁 Target Scope : {decoupler.target_dir}")
231
+ print(f"🔍 Hardcoded Findings : {len(findings)} literals detected")
232
+ print(f"📄 Decoupled Config : {json_path}")
233
+ print(f"📄 Environment Template: {env_path}")
234
+ print("======================================================================\n")
235
+
236
+ for f in findings[:8]:
237
+ print(f" • [{f['type']}] {f['file']}:{f['line']} -> {f['key']}")
238
+ print(f" Literal : {f['literal']}")
239
+ print(f" Replacement: {f['replacement']}\n")
240
+
241
+ if len(findings) > 8:
242
+ print(f" ... and {len(findings) - 8} more literals decoupled.\n")
243
+
244
+ if args.fix:
245
+ print(f"✅ [IN-PLACE REFACTOR COMPLETED] {modified} files updated with environment variables.")
246
+ else:
247
+ print("💡 Run with '--fix' to apply environment variable replacements automatically in-place.")
248
+
249
+ return 0
250
+
251
+
252
+ if __name__ == "__main__":
253
+ sys.exit(main())
@@ -0,0 +1,141 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
3
+ # SPDX-License-Identifier: MIT
4
+ # Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
5
+
6
+ """
7
+ Swarm Data Contract Validator (Single Front-Door Integrity Guard)
8
+ -----------------------------------------------------------------
9
+ Validates the JSON Data Contract emitted by `live-explorer` before
10
+ `pom-crafter` consumes it for Clean POM code synthesis.
11
+ Ensures zero locator guessing, validates semantic ARIA roles, and enforces
12
+ latency measurement (< 200ms) for durable selectors.
13
+ """
14
+
15
+ import os
16
+ import sys
17
+ import json
18
+ import argparse
19
+ from typing import Dict, Any, List, Tuple
20
+
21
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
22
+ if hasattr(sys.stdout, 'reconfigure'):
23
+ try:
24
+ sys.stdout.reconfigure(encoding='utf-8')
25
+ sys.stderr.reconfigure(encoding='utf-8')
26
+ except Exception:
27
+ pass
28
+
29
+ CONTRACT_SCHEMA = {
30
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
31
+ "title": "SelectorContract",
32
+ "type": "object",
33
+ "required": ["url", "screen_name", "elements"],
34
+ "properties": {
35
+ "url": {"type": "string"},
36
+ "screen_name": {"type": "string"},
37
+ "viewport": {
38
+ "type": "object",
39
+ "properties": {
40
+ "width": {"type": "integer"},
41
+ "height": {"type": "integer"}
42
+ }
43
+ },
44
+ "elements": {
45
+ "type": "array",
46
+ "minItems": 1,
47
+ "items": {
48
+ "type": "object",
49
+ "required": ["name", "role"],
50
+ "properties": {
51
+ "name": {"type": "string"},
52
+ "role": {"type": "string"},
53
+ "selector": {"type": "string"},
54
+ "target": {"type": "string"},
55
+ "latency_ms": {"type": "number"},
56
+ "action_type": {"type": "string"}
57
+ }
58
+ }
59
+ }
60
+ }
61
+ }
62
+
63
+
64
+ def validate_contract_dict(data: Dict[str, Any]) -> Tuple[bool, List[str]]:
65
+ """Validates contract structure without external dependencies."""
66
+ errors = []
67
+ if not isinstance(data, dict):
68
+ return False, ["Root contract must be a JSON object."]
69
+
70
+ # Required top-level fields
71
+ for field in ("url", "screen_name", "elements"):
72
+ if field not in data:
73
+ errors.append(f"Missing required top-level field: '{field}'")
74
+
75
+ if "elements" in data:
76
+ elements = data["elements"]
77
+ if not isinstance(elements, list) or len(elements) == 0:
78
+ errors.append("'elements' must be a non-empty list of interactive components.")
79
+ else:
80
+ for idx, el in enumerate(elements):
81
+ if not isinstance(el, dict):
82
+ errors.append(f"Element at index {idx} must be a dictionary object.")
83
+ continue
84
+ if "name" not in el or not el["name"]:
85
+ errors.append(f"Element at index {idx} missing 'name' identifier.")
86
+ if "role" not in el or not el["role"]:
87
+ errors.append(f"Element at index {idx} missing ARIA 'role' classification.")
88
+ if "selector" not in el and "target" not in el:
89
+ errors.append(f"Element '{el.get('name', f'index_{idx}')}' must provide 'selector' or 'target'.")
90
+
91
+ latency = el.get("latency_ms")
92
+ if latency is not None and isinstance(latency, (int, float)):
93
+ if latency > 200:
94
+ errors.append(
95
+ f"Element '{el.get('name')}' latency ({latency}ms) exceeds the 200ms latency budget."
96
+ )
97
+
98
+ return len(errors) == 0, errors
99
+
100
+
101
+ def validate_contract_file(file_path: str) -> Tuple[bool, List[str]]:
102
+ """Loads and validates a contract file from disk."""
103
+ if not os.path.exists(file_path):
104
+ return False, [f"Contract file does not exist: {file_path}"]
105
+ try:
106
+ with open(file_path, "r", encoding="utf-8") as f:
107
+ data = json.load(f)
108
+ return validate_contract_dict(data)
109
+ except json.JSONDecodeError as err:
110
+ return False, [f"Malformed JSON syntax: {err}"]
111
+ except OSError as err:
112
+ return False, [f"File read error: {err}"]
113
+
114
+
115
+ def main():
116
+ parser = argparse.ArgumentParser(description="Swarm Data Contract Validator")
117
+ parser.add_argument("contract_path", nargs="?", default=None, help="Path to JSON Data Contract file")
118
+ parser.add_argument("--schema", action="store_true", help="Print standard JSON schema and exit")
119
+ args = parser.parse_args()
120
+
121
+ if args.schema:
122
+ print(json.dumps(CONTRACT_SCHEMA, indent=2))
123
+ return 0
124
+
125
+ if not args.contract_path:
126
+ parser.print_help()
127
+ return 1
128
+
129
+ valid, errors = validate_contract_file(args.contract_path)
130
+ if valid:
131
+ print(f"✅ [VALID CONTRACT] '{args.contract_path}' is ready for Clean POM synthesis.")
132
+ return 0
133
+ else:
134
+ print(f"❌ [INVALID CONTRACT] '{args.contract_path}' contains {len(errors)} violation(s):")
135
+ for err in errors:
136
+ print(f" • {err}")
137
+ return 1
138
+
139
+
140
+ if __name__ == "__main__":
141
+ sys.exit(main())
@@ -0,0 +1,70 @@
1
+ """
2
+ Synapse Hub — Core Execution Engines & Verification Sentinels (tools.core)
3
+ --------------------------------------------------------------------------
4
+ Domain package grouping all CLI routers, Definition-of-Done Quality Gate
5
+ orchestrators, AST scanners, and autonomous subagent execution bridges.
6
+ """
7
+
8
+ from tools import (
9
+ analyze_project,
10
+ bump_version,
11
+ check_env,
12
+ cli,
13
+ count_tokens,
14
+ debt_harvester,
15
+ distill_log,
16
+ micro_mutator,
17
+ project_state,
18
+ repo_map,
19
+ safety_firewall,
20
+ senior_code_review,
21
+ setup_project,
22
+ skill_vault,
23
+ sync_agent_rules,
24
+ test_impact,
25
+ test_memory_os,
26
+ universal_ir,
27
+ update_sentinel,
28
+ verify_all,
29
+ )
30
+
31
+ __all__ = [
32
+ "analyze_project",
33
+ "bump_version",
34
+ "check_env",
35
+ "cli",
36
+ "count_tokens",
37
+ "debt_harvester",
38
+ "distill_log",
39
+ "micro_mutator",
40
+ "project_state",
41
+ "repo_map",
42
+ "safety_firewall",
43
+ "senior_code_review",
44
+ "setup_project",
45
+ "skill_vault",
46
+ "sync_agent_rules",
47
+ "test_impact",
48
+ "test_memory_os",
49
+ "universal_ir",
50
+ "update_sentinel",
51
+ "verify_all",
52
+ "cli_runtime",
53
+ "process_supervisor",
54
+ "file_lock",
55
+ "telemetry",
56
+ "circuit_breaker",
57
+ "memory_bus",
58
+ "adapters",
59
+ "i18n",
60
+ ]
61
+
62
+ from tools.core import cli_runtime
63
+ from tools.core import process_supervisor
64
+ from tools.core import file_lock
65
+ from tools.core import telemetry
66
+ from tools.core import circuit_breaker
67
+ from tools.core import memory_bus
68
+ from tools.core import adapters
69
+ from tools.core import i18n
70
+