@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,167 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Enterprise QA: Fast XPath / Selector Lookup (lookup_xpath.py)
4
+ -------------------------------------------------------------
5
+ Fast lookup tool for XPaths and selectors from Page Class JSON specifications.
6
+ Enables AI Agents to retrieve only the relevant selectors (<300 tokens)
7
+ instead of reading entire selector repositories or rescanning live DOM.
8
+
9
+ Multi-tier Resolution:
10
+ 1. CLI Flag: python tools/lookup_xpath.py <query> --file <path_to_json> (-f)
11
+ 2. Environment variable: XPATH_DATA_FILE, SELECTORS_JSON, or LOCATORS_JSON
12
+ 3. Automatic discovery: selectors.json, locators.json, scraped_xpaths.json...
13
+ 4. Internal Hub archive fallback: archive/legacy_references/Enterprise_scraped_xpaths.json
14
+ """
15
+
16
+ import sys
17
+ import json
18
+ import os
19
+ import argparse
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
+
30
+ def resolve_json_path(cli_file=None):
31
+ """Resolves Selector/XPath JSON file path via precedence order."""
32
+ # 1. CLI flag
33
+ if cli_file:
34
+ if os.path.exists(cli_file):
35
+ return os.path.abspath(cli_file)
36
+ else:
37
+ print(f"⚠️ Warning: File specified via --file '{cli_file}' does not exist.")
38
+
39
+ # 2. Environment variable
40
+ env_file = os.environ.get("XPATH_DATA_FILE") or os.environ.get("SELECTORS_JSON") or os.environ.get("LOCATORS_JSON")
41
+ if env_file and os.path.exists(env_file):
42
+ return os.path.abspath(env_file)
43
+
44
+ # 3. Automatic discovery in CWD and common directories
45
+ script_dir = os.path.dirname(os.path.abspath(__file__))
46
+ hub_root = os.path.abspath(os.path.join(script_dir, ".."))
47
+ cwd = os.getcwd()
48
+
49
+ search_dirs = [
50
+ cwd,
51
+ os.path.join(cwd, "references"),
52
+ os.path.join(cwd, "data"),
53
+ os.path.join(cwd, "tools"),
54
+ os.path.join(cwd, "docs"),
55
+ script_dir
56
+ ]
57
+
58
+ candidate_names = [
59
+ "selectors.json",
60
+ "scraped_xpaths.json",
61
+ "locators.json",
62
+ "Enterprise_scraped_xpaths.json",
63
+ "page_selectors.json",
64
+ "elements.json"
65
+ ]
66
+
67
+ for d in search_dirs:
68
+ for name in candidate_names:
69
+ candidate = os.path.join(d, name)
70
+ if os.path.isfile(candidate):
71
+ return os.path.abspath(candidate)
72
+
73
+ # 4. Hub Archive fallback
74
+ for legacy_name in ["Enterprise_scraped_xpaths.json", "dmit_scraped_xpaths.json", "batch01_scraped_xpaths.json"]:
75
+ legacy_file = os.path.join(hub_root, "archive", "legacy_references", legacy_name)
76
+ if os.path.isfile(legacy_file):
77
+ return os.path.abspath(legacy_file)
78
+
79
+ return None
80
+
81
+
82
+ def normalize_selector_data(raw_data):
83
+ """Normalizes Selector data across PageClass dictionary or flat list schemas."""
84
+ if isinstance(raw_data, dict):
85
+ return raw_data
86
+ elif isinstance(raw_data, list):
87
+ grouped = {}
88
+ for item in raw_data:
89
+ page = item.get("page") or item.get("page_class") or "GLOBAL"
90
+ if page not in grouped:
91
+ grouped[page] = []
92
+ grouped[page].append(item)
93
+ return grouped
94
+ return {}
95
+
96
+
97
+ def main():
98
+ parser = argparse.ArgumentParser(description="Fast Selector / XPath lookup from project JSON specifications")
99
+ parser.add_argument("query", help="PageClass name or selector identifier keyword (e.g., TargetPlanPage, TXT_CODE)")
100
+ parser.add_argument("-f", "--file", dest="file", help="Path to JSON file containing selector/xpaths")
101
+ args = parser.parse_args()
102
+
103
+ json_path = resolve_json_path(args.file)
104
+
105
+ if not json_path:
106
+ print("❌ Error: Selector / XPath JSON data file not found.")
107
+ print("\n👉 Guidance to configure selector data for target project:")
108
+ print(" 1. Use CLI flag: python tools/lookup_xpath.py <query> --file <path_to_selectors.json>")
109
+ print(" 2. Set environment variable: export XPATH_DATA_FILE='path/to/selectors.json' (or set XPATH_DATA_FILE=...)")
110
+ print(" 3. Place 'selectors.json' in project root or declare path in PROJECT_AI_GUIDE.md")
111
+ sys.exit(1)
112
+
113
+ try:
114
+ with open(json_path, "r", encoding="utf-8") as f:
115
+ raw_data = json.load(f)
116
+ except Exception as e:
117
+ print(f"❌ Error reading file '{json_path}': {e}")
118
+ sys.exit(1)
119
+
120
+ data = normalize_selector_data(raw_data)
121
+ query = args.query.strip()
122
+
123
+ # 1. Match by Page Class name
124
+ matched_page = None
125
+ for page_name in data.keys():
126
+ if query.lower() == page_name.lower():
127
+ matched_page = page_name
128
+ break
129
+
130
+ if matched_page:
131
+ selectors = data[matched_page]
132
+ source_label = os.path.relpath(json_path, os.getcwd()) if os.path.exists(json_path) else json_path
133
+ print(f"=== {matched_page} ({len(selectors)} selectors) [Source: {source_label}] ===")
134
+ for item in selectors:
135
+ c = item.get("constant") or item.get("name") or "SELECTOR"
136
+ tag = item.get("tag") or "element"
137
+ xp = item.get("xpath") or item.get("selector") or item.get("css") or ""
138
+ print(f"- {c} ({tag}): {xp}")
139
+ return
140
+
141
+ # 2. Match keyword across constant or xpath
142
+ found = []
143
+ for page_name, selectors in data.items():
144
+ if isinstance(selectors, list):
145
+ for item in selectors:
146
+ c = item.get("constant") or item.get("name") or ""
147
+ xp = item.get("xpath") or item.get("selector") or item.get("css") or ""
148
+ tag = item.get("tag") or "element"
149
+ if query.lower() in c.lower() or query.lower() in xp.lower():
150
+ found.append((page_name, c, tag, xp))
151
+ elif isinstance(selectors, dict):
152
+ for c, xp in selectors.items():
153
+ if query.lower() in c.lower() or query.lower() in str(xp).lower():
154
+ found.append((page_name, c, "element", str(xp)))
155
+
156
+ if not found:
157
+ print(f"No selectors found matching: '{query}' in file '{os.path.basename(json_path)}'")
158
+ return
159
+
160
+ source_label = os.path.relpath(json_path, os.getcwd()) if os.path.exists(json_path) else json_path
161
+ print(f"=== Found {len(found)} selector(s) for query '{query}' [Source: {source_label}] ===")
162
+ for page, c, tag, xp in found[:15]:
163
+ print(f"[{page}] {c} ({tag}): {xp}")
164
+
165
+
166
+ if __name__ == "__main__":
167
+ main()
@@ -0,0 +1,148 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Enterprise Duration-Balanced Test Matrix Sharder
4
+ ------------------------------------------------
5
+ Balances parallel CI/CD test execution across N containers using historical
6
+ runtimes and the Greedy LPT (Longest Processing Time First) Bin-Packing algorithm.
7
+ Eliminates CI runner bottlenecks where one worker runs for 15m while others finish in 2m.
8
+ """
9
+
10
+ import os
11
+ import sys
12
+ import json
13
+ import sqlite3
14
+ import argparse
15
+ from pathlib import Path
16
+ from typing import List, Dict, Any
17
+
18
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
19
+ if hasattr(sys.stdout, 'reconfigure'):
20
+ try:
21
+ sys.stdout.reconfigure(encoding='utf-8')
22
+ sys.stderr.reconfigure(encoding='utf-8')
23
+ except Exception:
24
+ pass
25
+
26
+ SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
27
+ HUB_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
28
+ CACHE_DB_PATH = os.path.expanduser("~/.agent_memory/global_cache.db")
29
+
30
+
31
+ def find_test_files(target_dir: str) -> List[str]:
32
+ """Discovers all executable test scripts across Katalon, Playwright, or Pytest suites."""
33
+ target_path = Path(target_dir)
34
+ test_files = []
35
+ valid_exts = {".groovy", ".ts", ".js", ".py"}
36
+
37
+ for root, _, files in os.walk(target_path):
38
+ for f in files:
39
+ # Match standard test naming patterns
40
+ lower = f.lower()
41
+ if any(lower.endswith(ext) for ext in valid_exts):
42
+ if "test" in lower or "spec" in lower or "tc_" in lower or "scripts" in root.lower():
43
+ rel_p = os.path.relpath(os.path.join(root, f), target_dir).replace("\\", "/")
44
+ test_files.append(rel_p)
45
+
46
+ return sorted(test_files)
47
+
48
+
49
+ def estimate_test_duration(file_path: str, full_path: str) -> float:
50
+ """Estimates test execution duration in seconds using historical cache or file heuristic."""
51
+ # Check SQLite historical runtime cache if available
52
+ if os.path.exists(CACHE_DB_PATH):
53
+ try:
54
+ conn = sqlite3.connect(CACHE_DB_PATH)
55
+ try:
56
+ cur = conn.cursor()
57
+ cur.execute("CREATE TABLE IF NOT EXISTS test_runtimes (test_path TEXT PRIMARY KEY, duration REAL)")
58
+ cur.execute("SELECT duration FROM test_runtimes WHERE test_path = ?", (file_path,))
59
+ row = cur.fetchone()
60
+ if row and row[0]:
61
+ return float(row[0])
62
+ finally:
63
+ conn.close()
64
+ except sqlite3.Error:
65
+ conn = None
66
+
67
+ # Heuristic fallback: ~0.5s per line of script
68
+ try:
69
+ if os.path.exists(full_path):
70
+ with open(full_path, "r", encoding="utf-8", errors="ignore") as fp:
71
+ lines = len(fp.readlines())
72
+ return max(5.0, round(lines * 0.25, 1))
73
+ except (OSError, UnicodeDecodeError):
74
+ lines = 0
75
+
76
+ return 10.0
77
+
78
+
79
+ def shard_tests_lpt(test_files: List[str], target_dir: str, num_shards: int) -> List[Dict[str, Any]]:
80
+ """
81
+ Applies Longest Processing Time First (LPT) bin-packing to distribute tests evenly.
82
+ """
83
+ num_shards = max(1, num_shards)
84
+ if not test_files:
85
+ return [{"shard_index": i + 1, "total_duration": 0.0, "tests": []} for i in range(num_shards)]
86
+
87
+ # 1. Calculate duration for each test
88
+ tests_with_cost = []
89
+ for tf in test_files:
90
+ fp = os.path.join(target_dir, tf)
91
+ dur = estimate_test_duration(tf, fp)
92
+ tests_with_cost.append((tf, dur))
93
+
94
+ # 2. Sort descending by duration
95
+ tests_with_cost.sort(key=lambda x: x[1], reverse=True)
96
+
97
+ # 3. Initialize shards
98
+ shards: List[Dict[str, Any]] = [{"shard_index": i + 1, "total_duration": 0.0, "tests": []} for i in range(num_shards)]
99
+
100
+ # 4. Greedily assign to the shard with the least current cumulative duration
101
+ for test_file, dur in tests_with_cost:
102
+ # Find shard with min duration
103
+ min_shard = min(shards, key=lambda s: float(s["total_duration"]))
104
+ min_shard["tests"].append(test_file)
105
+ min_shard["total_duration"] = round(float(min_shard["total_duration"]) + dur, 2)
106
+
107
+ return shards
108
+
109
+
110
+ def main():
111
+ parser = argparse.ArgumentParser(description="Duration-Balanced Test Matrix Sharder")
112
+ parser.add_argument("target", nargs="?", default=os.getcwd(), help="Target repository root")
113
+ parser.add_argument("--shards", "-n", type=int, default=4, help="Number of parallel shards/workers (default: 4)")
114
+ parser.add_argument("--json", action="store_true", help="Output matrix in JSON format")
115
+ args = parser.parse_args()
116
+
117
+ target_dir = os.path.abspath(args.target)
118
+ test_files = find_test_files(target_dir)
119
+ shards = shard_tests_lpt(test_files, target_dir, args.shards)
120
+
121
+ if args.json:
122
+ print(json.dumps({"total_tests": len(test_files), "shards_count": args.shards, "shards": shards}, indent=2))
123
+ else:
124
+ print("\n======================================================================")
125
+ print(f" DURATION-BALANCED TEST MATRIX SHARDER ({args.shards} PARALLEL WORKERS) ")
126
+ print("======================================================================")
127
+ print(f" Target Scope : {target_dir}")
128
+ print(f" Total Tests : {len(test_files)} files\n")
129
+
130
+ for s in shards:
131
+ print(f"📦 Shard {s['shard_index']}: {len(s['tests'])} tests (~{s['total_duration']}s total)")
132
+ for t in s['tests'][:5]:
133
+ print(f" • {t}")
134
+ if len(s['tests']) > 5:
135
+ print(f" ... and {len(s['tests']) - 5} more")
136
+ print()
137
+
138
+ # Calculate imbalance delta
139
+ durations = [s["total_duration"] for s in shards]
140
+ delta = max(durations) - min(durations) if durations else 0
141
+ print(f"⚡ Shard Imbalance Delta: {delta:.1f}s (Optimal parallel distribution)")
142
+ print("======================================================================\n")
143
+
144
+ return 0
145
+
146
+
147
+ if __name__ == "__main__":
148
+ sys.exit(main())
@@ -0,0 +1,18 @@
1
+ """
2
+ Synapse Hub — Model Context Protocol (MCP) Servers (tools.mcp)
3
+ --------------------------------------------------------------
4
+ Domain package grouping all standard MCP services: core QA automation
5
+ MCP server and offline Excel spreadsheet manipulation server.
6
+ """
7
+
8
+ from tools import (
9
+ mcp_docx_server,
10
+ mcp_excel_server,
11
+ mcp_server,
12
+ )
13
+
14
+ __all__ = [
15
+ "mcp_docx_server",
16
+ "mcp_excel_server",
17
+ "mcp_server",
18
+ ]
@@ -0,0 +1,13 @@
1
+ # Enterprise MCP Docx Server Wrapper
2
+ $scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
3
+ $pythonCmd = Get-Command python -ErrorAction SilentlyContinue
4
+ if (-not $pythonCmd) { $pythonCmd = Get-Command py -ErrorAction SilentlyContinue }
5
+ if (-not $pythonCmd) { $pythonCmd = Get-Command python3 -ErrorAction SilentlyContinue }
6
+
7
+ if ($pythonCmd) {
8
+ & $pythonCmd.Source "$scriptDir\mcp_docx_server.py" $args
9
+ exit $LASTEXITCODE
10
+ } else {
11
+ Write-Error "Python 3 is required to run mcp_docx_server.py."
12
+ exit 1
13
+ }