@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,13 @@
1
+ # Enterprise MCP Excel 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_excel_server.py" $args
9
+ exit $LASTEXITCODE
10
+ } else {
11
+ Write-Error "Python 3 is required to run mcp_excel_server.py."
12
+ exit 1
13
+ }
@@ -0,0 +1,441 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Enterprise Cross-Platform MCP Excel Server (Zero-Dependency)
4
+ -----------------------------------------------------------
5
+ Implements Model Context Protocol (MCP) JSON-RPC 2.0 stdio server
6
+ for reading and inspecting Microsoft Excel (.xlsx) workbooks.
7
+ Works 100% offline with Python Standard Library (zipfile + xml.etree.ElementTree),
8
+ with transparent fallback to openpyxl if installed.
9
+ """
10
+
11
+ import os
12
+ import sys
13
+ import json
14
+ import zipfile
15
+ from pathlib import Path
16
+ from typing import Dict, Any, List, Optional, Union
17
+
18
+ try:
19
+ from openxml_guard import (
20
+ validate_openxml_path,
21
+ validate_output_path,
22
+ safe_open_zip,
23
+ safe_parse_xml,
24
+ jsonrpc_error_response,
25
+ PARSE_ERROR,
26
+ INVALID_REQUEST,
27
+ METHOD_NOT_FOUND,
28
+ INVALID_PARAMS,
29
+ INTERNAL_ERROR,
30
+ MAX_ZIP_ENTRIES
31
+ )
32
+ except ImportError:
33
+ from tools.openxml_guard import (
34
+ validate_openxml_path,
35
+ validate_output_path,
36
+ safe_open_zip,
37
+ safe_parse_xml,
38
+ jsonrpc_error_response,
39
+ PARSE_ERROR,
40
+ INVALID_REQUEST,
41
+ METHOD_NOT_FOUND,
42
+ INVALID_PARAMS,
43
+ INTERNAL_ERROR,
44
+ MAX_ZIP_ENTRIES
45
+ )
46
+
47
+ # Enforce UTF-8 stdio
48
+ if hasattr(sys.stdout, 'reconfigure'):
49
+ try:
50
+ sys.stdout.reconfigure(encoding='utf-8')
51
+ sys.stderr.reconfigure(encoding='utf-8')
52
+ except Exception:
53
+ pass
54
+
55
+ SERVER_VERSION = "3.8.3"
56
+ MAX_XLSX_SIZE = 50 * 1024 * 1024 # 50 MB
57
+ MAX_UNCOMPRESSED_SIZE = 200 * 1024 * 1024 # 200 MB
58
+ MAX_RATIO = 100 # 100:1 compression ratio limit
59
+
60
+ NS_MAIN = "{http://schemas.openxmlformats.org/spreadsheetml/2006/main}"
61
+ NS_REL = "{http://schemas.openxmlformats.org/officeDocument/2006/relationships}"
62
+
63
+
64
+ def validate_excel_path(path: str, workspace_root: Optional[Union[str, Path]] = None) -> str:
65
+ """Validates that path is safe, does not resolve to sensitive system directories, and is a valid .xlsx file."""
66
+ target = validate_openxml_path(
67
+ path,
68
+ workspace_root=workspace_root,
69
+ allowed_extensions=('.xlsx',),
70
+ max_file_size=MAX_XLSX_SIZE
71
+ )
72
+ return str(target)
73
+
74
+
75
+ def get_shared_strings(z: zipfile.ZipFile) -> List[str]:
76
+ """Reads shared strings table from xl/sharedStrings.xml."""
77
+ if "xl/sharedStrings.xml" not in z.namelist():
78
+ return []
79
+ try:
80
+ with z.open("xl/sharedStrings.xml") as f:
81
+ root = safe_parse_xml(f)
82
+ strings = []
83
+ for si in root.iter(f"{NS_MAIN}si"):
84
+ # Concatenate all text inside <t> elements
85
+ text = "".join(t.text or "" for t in si.iter(f"{NS_MAIN}t"))
86
+ strings.append(text)
87
+ return strings
88
+ except (KeyError, ValueError):
89
+ return []
90
+
91
+
92
+ def get_sheet_names(z: zipfile.ZipFile) -> List[str]:
93
+ """Retrieves sheet names from xl/workbook.xml."""
94
+ if "xl/workbook.xml" not in z.namelist():
95
+ return ["Sheet1"]
96
+ try:
97
+ with z.open("xl/workbook.xml") as f:
98
+ root = safe_parse_xml(f)
99
+ sheets = []
100
+ for sheet in root.iter(f"{NS_MAIN}sheet"):
101
+ name = sheet.attrib.get("name")
102
+ if name:
103
+ sheets.append(name)
104
+ return sheets or ["Sheet1"]
105
+ except (KeyError, ValueError):
106
+ return ["Sheet1"]
107
+
108
+
109
+ def read_sheet_rows(xlsx_path: str, sheet_name: Optional[str] = None, max_rows: int = 100) -> List[List[str]]:
110
+ """Reads rows from an Excel .xlsx file using Python standard library."""
111
+ valid_path = validate_excel_path(xlsx_path)
112
+
113
+ with safe_open_zip(valid_path, max_entries=MAX_ZIP_ENTRIES, max_uncompressed_size=MAX_UNCOMPRESSED_SIZE, max_ratio=MAX_RATIO) as z:
114
+ shared_strings = get_shared_strings(z)
115
+ sheet_names = get_sheet_names(z)
116
+
117
+ sheet_idx = 1
118
+ if sheet_name and sheet_name in sheet_names:
119
+ sheet_idx = sheet_names.index(sheet_name) + 1
120
+
121
+ sheet_entry = f"xl/worksheets/sheet{sheet_idx}.xml"
122
+ if sheet_entry not in z.namelist():
123
+ candidates = [n for n in z.namelist() if n.startswith("xl/worksheets/sheet") and n.endswith(".xml")]
124
+ if candidates:
125
+ sheet_entry = candidates[0]
126
+ else:
127
+ return []
128
+
129
+ try:
130
+ with z.open(sheet_entry) as f:
131
+ root = safe_parse_xml(f)
132
+ except ValueError as err:
133
+ raise ValueError(f"Corrupt worksheet '{sheet_entry}': {err}")
134
+
135
+ rows_data = []
136
+ for row in root.iter(f"{NS_MAIN}row"):
137
+ cells = []
138
+ for c in row.iter(f"{NS_MAIN}c"):
139
+ cell_type = c.attrib.get("t")
140
+ val_elem = c.find(f"{NS_MAIN}v")
141
+ raw_val = (val_elem.text or "") if val_elem is not None else ""
142
+
143
+ if cell_type == "s" and raw_val.isdigit():
144
+ idx = int(raw_val)
145
+ val = shared_strings[idx] if idx < len(shared_strings) else raw_val
146
+ elif cell_type == "b":
147
+ val = "TRUE" if raw_val == "1" else "FALSE"
148
+ else:
149
+ val = raw_val
150
+
151
+ cells.append(str(val))
152
+ if any(cells):
153
+ rows_data.append(cells)
154
+ if len(rows_data) >= max_rows:
155
+ break
156
+
157
+ return rows_data
158
+
159
+
160
+ def handle_tool_call(name: str, arguments: Dict[str, Any]) -> str:
161
+ """Executes Excel MCP tool functions."""
162
+ if name not in MCP_EXCEL_TOOL_NAMES:
163
+ raise ValueError(f"Unknown MCP Excel tool: {name}")
164
+
165
+ if name == "list_excel_sheets":
166
+ file_path = arguments.get("file_path")
167
+ if not file_path or not isinstance(file_path, str):
168
+ raise ValueError("Tool argument 'file_path' is required and must be a string.")
169
+ valid_path = validate_excel_path(file_path)
170
+ with safe_open_zip(valid_path, max_entries=MAX_ZIP_ENTRIES, max_uncompressed_size=MAX_UNCOMPRESSED_SIZE, max_ratio=MAX_RATIO) as z:
171
+ sheets = get_sheet_names(z)
172
+ return json.dumps({"file": valid_path, "sheets": sheets}, indent=2)
173
+
174
+ elif name == "read_excel_sheet":
175
+ file_path = arguments.get("file_path")
176
+ if not file_path or not isinstance(file_path, str):
177
+ raise ValueError("Tool argument 'file_path' is required and must be a string.")
178
+ valid_path = validate_excel_path(file_path)
179
+ sheet_name = arguments.get("sheet_name")
180
+ max_rows = int(arguments.get("max_rows", 50))
181
+ rows = read_sheet_rows(valid_path, sheet_name=sheet_name, max_rows=max_rows)
182
+ if not rows:
183
+ return f"Sheet '{sheet_name or 'Sheet1'}' is empty."
184
+
185
+ # Format as Markdown table
186
+ header = rows[0]
187
+ md_lines = [
188
+ "| " + " | ".join(header) + " |",
189
+ "| " + " | ".join(["---"] * len(header)) + " |"
190
+ ]
191
+ for row in rows[1:]:
192
+ padded = row + [""] * (len(header) - len(row))
193
+ md_lines.append("| " + " | ".join(padded[:len(header)]) + " |")
194
+
195
+ return "\n".join(md_lines)
196
+
197
+ elif name == "export_testcases_to_excel":
198
+ markdown_content = arguments.get("markdown_content", "")
199
+ output_path = arguments.get("output_path", "")
200
+ if not markdown_content or not output_path:
201
+ raise ValueError("Both 'markdown_content' and 'output_path' are required.")
202
+
203
+ valid_output = validate_output_path(output_path, allowed_extensions=('.xlsx',), create_parent=True)
204
+
205
+ template_path = arguments.get("template_path")
206
+ if template_path:
207
+ template_path = str(validate_openxml_path(template_path, allowed_extensions=('.xlsx',)))
208
+
209
+ sample_sheet = arguments.get("sample_sheet")
210
+ sheet_name = arguments.get("sheet_name")
211
+ module_code = arguments.get("module_code", "MODULE")
212
+ module_name = arguments.get("module_name", "Test Cases")
213
+ author = arguments.get("author", "QA Engineer")
214
+
215
+ try:
216
+ import template_excel_exporter as tee
217
+ except ImportError:
218
+ from tools import template_excel_exporter as tee
219
+
220
+ cfg = tee.find_project_config(os.path.dirname(os.path.abspath(str(valid_output))))
221
+ if cfg and not template_path:
222
+ tc_cfg = cfg.get("testcase_export", {})
223
+ cfg_dir = cfg.get("_config_dir", "")
224
+ if "template_path" in tc_cfg:
225
+ raw_tp = os.path.normpath(os.path.join(cfg_dir, tc_cfg["template_path"]))
226
+ if os.path.exists(raw_tp):
227
+ template_path = str(validate_openxml_path(raw_tp, allowed_extensions=('.xlsx',)))
228
+ if "sample_sheet" in tc_cfg:
229
+ sample_sheet = tc_cfg["sample_sheet"]
230
+ if "author" in cfg.get("project", {}):
231
+ author = cfg["project"]["author"]
232
+
233
+ rows = tee.parse_testcases_from_markdown(markdown_content)
234
+ if template_path and os.path.exists(template_path):
235
+ res_path = tee.clone_and_export_template(
236
+ rows=rows,
237
+ output_path=str(valid_output),
238
+ template_path=template_path,
239
+ sample_sheet_name=sample_sheet,
240
+ target_sheet_name=sheet_name,
241
+ module_code=module_code,
242
+ module_name=module_name,
243
+ author=author
244
+ )
245
+ case_count = len([r for r in rows if r.get('type') == 'case'])
246
+ return f"Successfully exported {case_count} test cases into '{res_path}' using template '{sample_sheet}'."
247
+ else:
248
+ # Fallback to standard 12-column layout
249
+ import tempfile
250
+ with tempfile.NamedTemporaryFile("w", encoding="utf-8", suffix=".md", delete=False) as tf:
251
+ tf.write(markdown_content)
252
+ tf_path = tf.name
253
+ try:
254
+ try:
255
+ import md_to_xlsx
256
+ except ImportError:
257
+ from tools import md_to_xlsx
258
+ md_to_xlsx.convert_markdown_to_xlsx(tf_path, str(valid_output), sheet_name=sheet_name or "Test Cases")
259
+ finally:
260
+ if os.path.exists(tf_path):
261
+ os.unlink(tf_path)
262
+ return f"Successfully exported to '{valid_output}' using Hub default 12-column layout."
263
+
264
+ raise ValueError(f"Unknown MCP Excel tool: {name}")
265
+
266
+
267
+ MCP_MANIFEST = {
268
+ "tools": [
269
+ {
270
+ "name": "list_excel_sheets",
271
+ "description": "Lists all worksheet names present in a Microsoft Excel (.xlsx) file.",
272
+ "inputSchema": {
273
+ "type": "object",
274
+ "properties": {
275
+ "file_path": {"type": "string", "description": "Absolute or relative path to the .xlsx file"}
276
+ },
277
+ "required": ["file_path"]
278
+ }
279
+ },
280
+ {
281
+ "name": "read_excel_sheet",
282
+ "description": "Reads and displays tabular rows from an Excel worksheet formatted as a Markdown table.",
283
+ "inputSchema": {
284
+ "type": "object",
285
+ "properties": {
286
+ "file_path": {"type": "string", "description": "Path to the .xlsx file"},
287
+ "sheet_name": {"type": "string", "description": "Optional name of the worksheet to read"},
288
+ "max_rows": {"type": "integer", "description": "Maximum number of rows to retrieve (default: 50)"}
289
+ },
290
+ "required": ["file_path"]
291
+ }
292
+ },
293
+ {
294
+ "name": "export_testcases_to_excel",
295
+ "description": "Exports test cases into an Excel workbook (.xlsx). If a project template (.synapse.json or template_path) is configured, it clones the corporate template preserving headers, styling, and formulas. Otherwise, it generates the Hub 12-column standard layout.",
296
+ "inputSchema": {
297
+ "type": "object",
298
+ "properties": {
299
+ "markdown_content": {"type": "string", "description": "Markdown test case content or table"},
300
+ "output_path": {"type": "string", "description": "Output path for the generated .xlsx file"},
301
+ "sheet_name": {"type": "string", "description": "Name for the worksheet (e.g. feature name)"},
302
+ "template_path": {"type": "string", "description": "Optional path to template .xlsx file (overrides .synapse.json)"},
303
+ "sample_sheet": {"type": "string", "description": "Optional sheet in template to clone (defaults to .synapse.json or first sheet)"},
304
+ "module_code": {"type": "string", "description": "Module code (e.g. TC_MOD)"},
305
+ "module_name": {"type": "string", "description": "Module title in Vietnamese or English"},
306
+ "author": {"type": "string", "description": "Author name"}
307
+ },
308
+ "required": ["markdown_content", "output_path"]
309
+ }
310
+ }
311
+ ]
312
+ }
313
+
314
+
315
+ MCP_EXCEL_TOOL_NAMES = {t["name"] for t in MCP_MANIFEST["tools"]}
316
+
317
+
318
+ def process_message(msg: Any) -> Optional[Dict[str, Any]]:
319
+ """JSON-RPC 2.0 message handler for Excel MCP."""
320
+ if not isinstance(msg, dict):
321
+ return jsonrpc_error_response(INVALID_REQUEST, "Invalid Request: message must be a JSON object", req_id=None)
322
+
323
+ msg_id = msg.get("id")
324
+
325
+ if msg.get("jsonrpc") != "2.0":
326
+ return jsonrpc_error_response(INVALID_REQUEST, "Invalid Request: 'jsonrpc' must be exactly '2.0'", req_id=msg_id)
327
+
328
+ method = msg.get("method")
329
+ if not isinstance(method, str) or not method:
330
+ return jsonrpc_error_response(INVALID_REQUEST, "Invalid Request: 'method' must be a non-empty string", req_id=msg_id)
331
+
332
+ # Notifications handling (no response per JSON-RPC 2.0 spec)
333
+ if method in ("notifications/initialized", "initialized") or method.startswith("notifications/"):
334
+ return None
335
+ if msg_id is None:
336
+ return None
337
+
338
+ if method == "initialize":
339
+ return {
340
+ "jsonrpc": "2.0",
341
+ "id": msg_id,
342
+ "result": {
343
+ "protocolVersion": "2024-11-05",
344
+ "capabilities": {"tools": {}},
345
+ "serverInfo": {"name": "synapse-mcp-excel", "version": SERVER_VERSION}
346
+ }
347
+ }
348
+ elif method == "ping":
349
+ return {"jsonrpc": "2.0", "id": msg_id, "result": {}}
350
+ elif method == "tools/list":
351
+ return {
352
+ "jsonrpc": "2.0",
353
+ "id": msg_id,
354
+ "result": MCP_MANIFEST
355
+ }
356
+ elif method == "tools/call":
357
+ params = msg.get("params")
358
+ if not isinstance(params, dict):
359
+ return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'params' must be a dictionary", req_id=msg_id)
360
+
361
+ tool_name = params.get("name")
362
+ if not isinstance(tool_name, str) or not tool_name:
363
+ return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: tool 'name' must be a non-empty string", req_id=msg_id)
364
+
365
+ if tool_name not in MCP_EXCEL_TOOL_NAMES:
366
+ return jsonrpc_error_response(METHOD_NOT_FOUND, f"Method not found: Unknown tool '{tool_name}'", req_id=msg_id)
367
+
368
+ args = params.get("arguments")
369
+ if args is None:
370
+ args = {}
371
+ if not isinstance(args, dict):
372
+ return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'arguments' must be a dictionary", req_id=msg_id)
373
+
374
+ # Validate mandatory tool arguments
375
+ if tool_name in ("list_excel_sheets", "read_excel_sheet"):
376
+ file_path = args.get("file_path")
377
+ if not file_path or not isinstance(file_path, str):
378
+ return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'file_path' is required and must be a non-empty string", req_id=msg_id)
379
+ elif tool_name == "export_testcases_to_excel":
380
+ if "markdown_content" not in args or not isinstance(args["markdown_content"], str):
381
+ return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'markdown_content' is required and must be a string", req_id=msg_id)
382
+ if "output_path" not in args or not isinstance(args["output_path"], str) or not args["output_path"].strip():
383
+ return jsonrpc_error_response(INVALID_PARAMS, "Invalid params: 'output_path' is required and must be a non-empty string", req_id=msg_id)
384
+
385
+ try:
386
+ content = handle_tool_call(tool_name, args)
387
+ return {
388
+ "jsonrpc": "2.0",
389
+ "id": msg_id,
390
+ "result": {"content": [{"type": "text", "text": content}], "isError": False}
391
+ }
392
+ except PermissionError as e:
393
+ return jsonrpc_error_response(INVALID_PARAMS, f"Invalid params (traversal or permission denied): {e}", req_id=msg_id)
394
+ except (ValueError, FileNotFoundError) as e:
395
+ return {
396
+ "jsonrpc": "2.0",
397
+ "id": msg_id,
398
+ "result": {"content": [{"type": "text", "text": f"Error: {e}"}], "isError": True}
399
+ }
400
+ except Exception as e:
401
+ return jsonrpc_error_response(INTERNAL_ERROR, f"Internal error: {e}", req_id=msg_id)
402
+
403
+ return jsonrpc_error_response(METHOD_NOT_FOUND, f"Method not found: '{method}'", req_id=msg_id)
404
+
405
+
406
+ def main():
407
+ """Main stdio loop for JSON-RPC 2.0 communication."""
408
+ if len(sys.argv) > 1 and any(arg in sys.argv for arg in ("-h", "--help")):
409
+ print("Usage: python3 tools/mcp_excel_server.py")
410
+ print("Model Context Protocol (MCP) server providing Excel automation tools over stdio.")
411
+ print("Supported operations: read_sheet, write_sheet, get_metadata, run_audit")
412
+ sys.exit(0)
413
+
414
+ for line in sys.stdin:
415
+ line = line.strip()
416
+ if not line:
417
+ continue
418
+ req_id = None
419
+ try:
420
+ try:
421
+ req = json.loads(line)
422
+ if isinstance(req, dict):
423
+ req_id = req.get("id")
424
+ except Exception as e:
425
+ err_resp = jsonrpc_error_response(PARSE_ERROR, f"Parse error: {e}", req_id=None)
426
+ sys.stdout.write(json.dumps(err_resp) + "\n")
427
+ sys.stdout.flush()
428
+ continue
429
+
430
+ resp = process_message(req)
431
+ if resp is not None:
432
+ sys.stdout.write(json.dumps(resp) + "\n")
433
+ sys.stdout.flush()
434
+ except Exception as e:
435
+ err_resp = jsonrpc_error_response(INTERNAL_ERROR, f"Internal error: {e}", req_id=req_id)
436
+ sys.stdout.write(json.dumps(err_resp) + "\n")
437
+ sys.stdout.flush()
438
+
439
+
440
+ if __name__ == "__main__":
441
+ main()