@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,346 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Enterprise Repository Map Compressor (Inspired by Aider-AI/aider)
4
+ -----------------------------------------------------------
5
+ Extracts an ultra-compact, token-budgeted AST map of all Page Classes and Helpers.
6
+ Compresses hundreds of kilobytes of Groovy source code into a clean ~150-line summary.
7
+ Enables AI Agents to discover all available methods and signatures with < 600 tokens.
8
+ Supports dynamic target repository resolution (CLI flag, CWD auto-detect, ENV var).
9
+ Saves a persistent in-place copy (repo_map.txt) inside the target project directory.
10
+ """
11
+
12
+ import os
13
+ import sys
14
+ import re
15
+ import json
16
+ import argparse
17
+ from datetime import datetime
18
+
19
+ SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
20
+ HUB_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
21
+ OUTPUT_TXT = os.path.join(SCRIPT_DIR, "repo_map.txt")
22
+ OUTPUT_JSON = os.path.join(SCRIPT_DIR, "repo_map.json")
23
+
24
+ # Regex patterns for Groovy/Java classes and methods
25
+ CLASS_PATTERN = re.compile(r'^\s*(?:public\s+|export\s+)?class\s+(\w+)(?:\s+extends\s+(\w+))?', re.MULTILINE)
26
+ PY_CLASS_PATTERN = re.compile(r'^\s*class\s+(\w+)(?:\(([^)]*)\))?\s*:', re.MULTILINE)
27
+ METHOD_PATTERN = re.compile(
28
+ r'^\s*(?:@\w+\s+)*(?:public\s+|protected\s+|private\s+)?(?:static\s+)?(?:async\s+)?(?:def\s+|void\s+|[\w<>\[\],]+\s+)?(\w+)\s*\(([^)]*)\)\s*(?:throws\s+[\w,\s]+)?\s*\{',
29
+ re.MULTILINE
30
+ )
31
+ DOC_PATTERN = re.compile(r'/\*\*(.*?)\*/', re.DOTALL)
32
+
33
+
34
+ def resolve_target_repo(cli_target=None, cli_repo=None):
35
+ """
36
+ Resolves the target repository path for repo mapping:
37
+ 1. Explicit CLI flag: --repo / --path or positional target.
38
+ 2. Environment variable: TARGET_PROJECT_DIR.
39
+ 3. Current Working Directory (if different from Hub and has Keywords/, pages/, or tests/).
40
+ 4. Default fallback: QA Hub root (parent of tools/).
41
+ """
42
+ chosen = cli_repo or cli_target
43
+ if chosen:
44
+ resolved = os.path.abspath(chosen)
45
+ if not os.path.exists(resolved):
46
+ raise FileNotFoundError(f"Target repository path not found: {resolved}")
47
+ return resolved
48
+
49
+ env_dir = os.environ.get("TARGET_PROJECT_DIR")
50
+ if env_dir and os.path.exists(env_dir):
51
+ return os.path.abspath(env_dir)
52
+
53
+ cwd = os.path.abspath(os.getcwd())
54
+ if cwd.lower() != HUB_ROOT.lower():
55
+ markers = ("Keywords", "Scripts", "pages", "tests", "src/pages", "e2e")
56
+ if any(os.path.exists(os.path.join(cwd, m)) for m in markers):
57
+ return cwd
58
+
59
+ return HUB_ROOT
60
+
61
+
62
+ def extract_class_info(file_path, repo_root=None):
63
+ """Parses a Groovy, TypeScript, JavaScript, or Python file and extracts class name and methods."""
64
+ with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
65
+ content = f.read()
66
+
67
+ base_root = repo_root or HUB_ROOT
68
+ try:
69
+ rel_path = os.path.relpath(file_path, base_root)
70
+ except ValueError:
71
+ rel_path = os.path.abspath(file_path)
72
+
73
+ ext = os.path.splitext(file_path)[1].lower()
74
+ methods = []
75
+ control_keywords = {"if", "for", "while", "switch", "catch", "synchronized", "constructor"}
76
+
77
+ if ext in (".groovy", ".java", ".ts", ".js"):
78
+ class_match = CLASS_PATTERN.search(content)
79
+ if not class_match:
80
+ return None
81
+ class_name = class_match.group(1)
82
+ extends_name = class_match.group(2) or ""
83
+
84
+ lines = content.splitlines()
85
+ for idx, line in enumerate(lines):
86
+ line_clean = line.strip()
87
+ if not line_clean or line_clean.startswith(("//", "/*", "*")):
88
+ continue
89
+
90
+ if "=" in line_clean:
91
+ eq_pos = line_clean.find("=")
92
+ paren_pos = line_clean.find("(")
93
+ if paren_pos != -1 and eq_pos < paren_pos:
94
+ continue
95
+
96
+ if "(" in line_clean and ")" in line_clean:
97
+ has_brace = "{" in line_clean or (idx + 1 < len(lines) and lines[idx + 1].strip().startswith("{"))
98
+ if has_brace:
99
+ m = re.search(r'(?:public\s+|protected\s+|private\s+|static\s+|async\s+|def\s+|void\s+|[\w<>\[\],]+\s+)*([a-zA-Z_]\w*)\s*\(([^)]*)\)', line_clean)
100
+ if m:
101
+ name = m.group(1)
102
+ params = m.group(2).strip()
103
+ if name not in control_keywords and name != class_name:
104
+ comment = ""
105
+ if idx > 0 and lines[idx - 1].strip().startswith("//"):
106
+ comment = lines[idx - 1].strip().lstrip("/ ").strip()
107
+ methods.append({
108
+ "name": name,
109
+ "params": re.sub(r'\s+', ' ', params),
110
+ "comment": comment
111
+ })
112
+
113
+ elif ext == ".py":
114
+ class_match = PY_CLASS_PATTERN.search(content)
115
+ if not class_match:
116
+ return None
117
+ class_name = class_match.group(1)
118
+ extends_name = class_match.group(2) or ""
119
+
120
+ lines = content.splitlines()
121
+ for idx, line in enumerate(lines):
122
+ line_clean = line.strip()
123
+ if line_clean.startswith("def "):
124
+ m = re.search(r'def\s+([a-zA-Z_]\w*)\s*\(([^)]*)\):', line_clean)
125
+ if m:
126
+ name = m.group(1)
127
+ params = m.group(2).replace("self,", "").replace("self", "").strip()
128
+ if not name.startswith("__") and name not in control_keywords:
129
+ comment = ""
130
+ if idx + 1 < len(lines) and '"""' in lines[idx + 1]:
131
+ comment = lines[idx + 1].replace('"""', '').strip()
132
+ methods.append({
133
+ "name": name,
134
+ "params": re.sub(r'\s+', ' ', params),
135
+ "comment": comment
136
+ })
137
+ else:
138
+ return None
139
+
140
+ # Deduplicate methods preserving order
141
+ seen = set()
142
+ unique_methods = []
143
+ for meth in methods:
144
+ sig = f"{meth['name']}({meth['params']})"
145
+ if sig not in seen:
146
+ seen.add(sig)
147
+ unique_methods.append(meth)
148
+
149
+ lines = content.splitlines()
150
+ return {
151
+ "rel_path": rel_path,
152
+ "class_name": class_name,
153
+ "extends": extends_name,
154
+ "raw_size_bytes": len(content.encode("utf-8")),
155
+ "line_count": len(lines),
156
+ "methods": unique_methods
157
+ }
158
+
159
+
160
+ def build_repo_map(target_repo=None, output_txt=None, output_json=None):
161
+ """Scans Page Classes across polyglot targets (Groovy, TypeScript, Python) and builds map."""
162
+ repo = target_repo or resolve_target_repo()
163
+ txt_dest = output_txt or OUTPUT_TXT
164
+ json_dest = output_json or OUTPUT_JSON
165
+
166
+ classes = []
167
+ total_raw_bytes = 0
168
+ total_raw_lines = 0
169
+
170
+ candidate_dirs = [
171
+ os.path.join(repo, "Keywords"),
172
+ os.path.join(repo, "pages"),
173
+ os.path.join(repo, "page-objects"),
174
+ os.path.join(repo, "page_objects"),
175
+ os.path.join(repo, "src", "pages"),
176
+ os.path.join(repo, "tests", "pages"),
177
+ ]
178
+
179
+ # If target repo is Hub mode or no root page dirs found, scan polyglot suites in examples/
180
+ if not any(os.path.isdir(d) for d in candidate_dirs):
181
+ examples_dir = os.path.join(repo, "examples")
182
+ if os.path.isdir(examples_dir):
183
+ for root, dirs, _ in os.walk(examples_dir):
184
+ if any(ignored in root for ignored in (".git", "node_modules", "__pycache__", ".venv")):
185
+ continue
186
+ for dname in ("pages", "Keywords", "page-objects", "page_objects"):
187
+ if dname in dirs:
188
+ candidate_dirs.append(os.path.join(root, dname))
189
+
190
+ scanned_files = set()
191
+ for d in candidate_dirs:
192
+ if os.path.isdir(d):
193
+ for root, _, files in os.walk(d):
194
+ if any(ignored in root for ignored in (".git", "node_modules", "__pycache__", ".venv")):
195
+ continue
196
+ for fname in sorted(files):
197
+ if fname.endswith((".groovy", ".ts", ".js", ".py", ".java")):
198
+ full_path = os.path.join(root, fname)
199
+ if full_path not in scanned_files:
200
+ scanned_files.add(full_path)
201
+ info = extract_class_info(full_path, repo_root=repo)
202
+ if info and info.get("methods"):
203
+ classes.append(info)
204
+ total_raw_bytes += info["raw_size_bytes"]
205
+ total_raw_lines += info["line_count"]
206
+
207
+ # Sort classes: BasePage first, then alphabetical
208
+ classes.sort(key=lambda c: (0 if c["class_name"] == "BasePage" else 1, c["class_name"]))
209
+
210
+ # Render text map
211
+ timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
212
+ out_lines = [
213
+ "# ==============================================================================",
214
+ "# ENTERPRISE AUTOMATION REPOSITORY MAP (Aider-Style AST Compression)",
215
+ f"# Generated : {timestamp}",
216
+ f"# Target : {repo}",
217
+ f"# Scope : {len(classes)} Classes ({total_raw_lines} source lines, {total_raw_bytes / 1024:.1f} KB)",
218
+ "# Purpose : Token-budgeted index (< 600 tokens) for instant method lookup",
219
+ "# ==============================================================================\n"
220
+ ]
221
+
222
+ total_methods = 0
223
+ for cls in classes:
224
+ ext_str = f" extends {cls['extends']}" if cls['extends'] else ""
225
+ out_lines.append(f"{cls['rel_path']} ({cls['line_count']} lines)")
226
+ out_lines.append(f" class {cls['class_name']}{ext_str}:")
227
+ for m in cls["methods"]:
228
+ total_methods += 1
229
+ cmt = f" # {m['comment']}" if m['comment'] else ""
230
+ out_lines.append(f" def {m['name']}({m['params']}){cmt}")
231
+ out_lines.append("")
232
+
233
+ rendered_text = "\n".join(out_lines)
234
+ compressed_bytes = len(rendered_text.encode("utf-8"))
235
+ ratio = (1.0 - (compressed_bytes / total_raw_bytes)) * 100 if total_raw_bytes > 0 else 0.0
236
+ est_tokens = len(rendered_text) // 4
237
+
238
+ json_payload = {
239
+ "generated_at": timestamp,
240
+ "target_repository": repo,
241
+ "classes_count": len(classes),
242
+ "methods_count": total_methods,
243
+ "source_lines": total_raw_lines,
244
+ "raw_bytes": total_raw_bytes,
245
+ "compressed_bytes": compressed_bytes,
246
+ "compression_ratio_pct": round(ratio, 2),
247
+ "estimated_tokens": est_tokens,
248
+ "classes": classes
249
+ }
250
+
251
+ # 1. Save to primary destination (tools/repo_map.txt in Hub) with cross-platform advisory locking
252
+ try:
253
+ from tools.core.file_lock import locked_write, locked_json_write
254
+ except ImportError:
255
+ try:
256
+ from core.file_lock import locked_write, locked_json_write
257
+ except ImportError:
258
+ def locked_write(p, c, **kw):
259
+ with open(p, "w", encoding="utf-8") as f:
260
+ f.write(c)
261
+ def locked_json_write(p, d, **kw):
262
+ with open(p, "w", encoding="utf-8") as f:
263
+ json.dump(d, f, indent=2, ensure_ascii=False)
264
+
265
+ try:
266
+ is_hub_target = os.path.samefile(repo, HUB_ROOT)
267
+ except (FileNotFoundError, OSError, ValueError):
268
+ is_hub_target = os.path.realpath(repo).lower() == os.path.realpath(HUB_ROOT).lower()
269
+
270
+ if is_hub_target:
271
+ try:
272
+ locked_write(txt_dest, rendered_text)
273
+ locked_json_write(json_dest, json_payload)
274
+ except OSError as err:
275
+ sys.stderr.write(f"Notice: Hub repo_map write skipped (read-only environment): {err}\n")
276
+ else:
277
+ # Spoke project target: strictly isolate from Hub directory
278
+ if output_txt:
279
+ try:
280
+ locked_write(output_txt, rendered_text)
281
+ except OSError as err:
282
+ sys.stderr.write(f"Notice: Could not write custom repo_map txt: {err}\n")
283
+ if output_json:
284
+ try:
285
+ locked_json_write(output_json, json_payload)
286
+ except OSError as err:
287
+ sys.stderr.write(f"Notice: Could not write custom repo_map json: {err}\n")
288
+ if not output_txt and not output_json:
289
+ try:
290
+ target_txt = os.path.join(repo, "repo_map.txt")
291
+ locked_write(target_txt, rendered_text)
292
+ target_json = os.path.join(repo, "repo_map.json")
293
+ locked_json_write(target_json, json_payload)
294
+ except OSError as err:
295
+ sys.stderr.write(f"Notice: Could not write target repo_map: {err}\n")
296
+
297
+ output_dest = output_txt if output_txt else (txt_dest if is_hub_target else os.path.join(repo, "repo_map.txt"))
298
+
299
+ return {
300
+ "target_repo": repo,
301
+ "classes_count": len(classes),
302
+ "methods_count": total_methods,
303
+ "source_lines": total_raw_lines,
304
+ "raw_bytes": total_raw_bytes,
305
+ "compressed_bytes": compressed_bytes,
306
+ "compression_ratio_pct": ratio,
307
+ "estimated_tokens": est_tokens,
308
+ "output_file": output_dest
309
+ }
310
+
311
+
312
+ def main():
313
+ parser = argparse.ArgumentParser(description="Enterprise Repository Map Compressor")
314
+ parser.add_argument("target", nargs="?", default=None, help="Target repository containing Keywords/")
315
+ parser.add_argument("--target", "--repo", "--path", dest="repo_path", default=None, help="Target repository path")
316
+ parser.add_argument("--print", action="store_true", help="Print repository map to console")
317
+ args = parser.parse_args()
318
+
319
+ try:
320
+ target_repo = resolve_target_repo(cli_target=args.target, cli_repo=args.repo_path)
321
+ except FileNotFoundError as e:
322
+ print(f"❌ Error: {e}")
323
+ return 1
324
+
325
+ stats = build_repo_map(target_repo=target_repo)
326
+ print("\n======================================================================")
327
+ print(" Enterprise Repository Map Compressor (Aider-Style AST Map) ")
328
+ print("======================================================================")
329
+ print(f" Target Repository : {stats['target_repo']}")
330
+ print(f" Indexed Classes : {stats['classes_count']} Page Classes & Helpers")
331
+ print(f" Extracted Methods : {stats['methods_count']} API signatures")
332
+ print(f" Source Lines Processed : {stats['source_lines']:,} lines ({stats['raw_bytes'] / 1024:.1f} KB)")
333
+ print(f" Compressed Map Size : {stats['compressed_bytes'] / 1024:.1f} KB (~{stats['estimated_tokens']} tokens)")
334
+ print(f" Compression Ratio : {stats['compression_ratio_pct']:.1f}% reduction")
335
+ print(f" Artifact Generated : {stats['output_file']}")
336
+ print("======================================================================\n")
337
+
338
+ if args.print:
339
+ with open(stats['output_file'], "r", encoding="utf-8") as f:
340
+ print(f.read())
341
+
342
+ return 0
343
+
344
+
345
+ if __name__ == "__main__":
346
+ sys.exit(main())
@@ -0,0 +1,32 @@
1
+ """
2
+ Synapse Hub — Reporting & Telemetry Engines (tools.report)
3
+ ----------------------------------------------------------
4
+ Domain package grouping all HTML dashboard, spreadsheet, JTL/Newman
5
+ metric parser, and visual reporting tools.
6
+ """
7
+
8
+ from tools import (
9
+ bug_reporter,
10
+ dashboard_generator,
11
+ generate_allure_report,
12
+ generate_test_reports,
13
+ jtl_analyzer,
14
+ md_to_xlsx,
15
+ newman_analyzer,
16
+ output_formatter,
17
+ telemetry_correlator,
18
+ welcome_page,
19
+ )
20
+
21
+ __all__ = [
22
+ "bug_reporter",
23
+ "dashboard_generator",
24
+ "generate_allure_report",
25
+ "generate_test_reports",
26
+ "jtl_analyzer",
27
+ "md_to_xlsx",
28
+ "newman_analyzer",
29
+ "output_formatter",
30
+ "telemetry_correlator",
31
+ "welcome_page",
32
+ ]