@teevee98/synapse-hub 0.0.0-stage → 3.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +172 -0
  190. package/README.md +171 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +197 -0
  196. package/docs/ARCHITECTURE.md +198 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +175 -0
  200. package/docs/CLI_REFERENCE.md +177 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +121 -0
  206. package/docs/QUALITY_GATES.md +121 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1359 -0
  212. package/docs/schemas/synapse.config.schema.json +87 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +32 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2079 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +258 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +184 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2419 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +307 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +724 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1259 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,388 @@
1
+ # Enterprise Playwright Code Recipes (20 Recipes)
2
+
3
+ All code recipes below execute directly via `browser_run_code_unsafe` with parameter `code: "async (page) => { ... }"`.
4
+
5
+ ---
6
+
7
+ ## Recipe 1: Authentication & Session Verification
8
+ ```javascript
9
+ async (page) => {
10
+ if (page.url().includes('/auth') || page.url().includes('/login')) {
11
+ const user = process.env.APP_USERNAME || 'your_username';
12
+ const pass = process.env.APP_PASSWORD || 'your_password';
13
+ await page.locator('input[formcontrolname="username"]').fill(user);
14
+ await page.locator('input[formcontrolname="password"]').fill(pass);
15
+ await page.locator('button[type="submit"]').click();
16
+ await page.waitForNavigation({ waitUntil: 'networkidle' });
17
+ }
18
+ return { currentUrl: page.url(), title: await page.title() };
19
+ }
20
+ ```
21
+
22
+ ## Recipe 2: Search, Filter & PrimeNG Table Verification (`p-table`)
23
+ ```javascript
24
+ async (page) => {
25
+ const searchInput = page.locator('input.p-inputtext[placeholder*="Tìm kiếm"], input[placeholder*="tên"], input[placeholder*="mã"]').first();
26
+ await searchInput.fill('Hà Nội');
27
+ await searchInput.press('Enter');
28
+ await page.waitForTimeout(1000);
29
+
30
+ const rowCount = await page.locator('p-table table tbody tr').count();
31
+ const firstRowText = rowCount > 0 ? await page.locator('p-table table tbody tr').first().innerText() : '';
32
+ return { rowCount, firstRowText };
33
+ }
34
+ ```
35
+
36
+ ## Recipe 3: PrimeNG Dropdown & MultiSelect (`p-dropdown`, `p-multiselect`)
37
+ ```javascript
38
+ async (page) => {
39
+ const dropdown = page.locator('p-dropdown[formcontrolname="status"], p-dropdown[name="status"]').first();
40
+ await dropdown.click();
41
+ await page.waitForTimeout(400);
42
+
43
+ const option = page.locator('.p-dropdown-panel .p-dropdown-item').filter({ hasText: 'Đang hoạt động' }).first();
44
+ await option.click();
45
+ await page.waitForTimeout(300);
46
+
47
+ return { selectedLabel: await dropdown.locator('.p-dropdown-label').innerText() };
48
+ }
49
+ ```
50
+
51
+ ## Recipe 4: Modal Dialogs & Popup Forms (`p-dialog`, `.card.popup-data`)
52
+ ```javascript
53
+ async (page) => {
54
+ await page.evaluate(() => {
55
+ function setAngularInput(selector, val) {
56
+ const el = document.querySelector(selector);
57
+ if (el) {
58
+ el.value = val;
59
+ el.dispatchEvent(new Event('input', { bubbles: true }));
60
+ el.dispatchEvent(new Event('change', { bubbles: true }));
61
+ }
62
+ }
63
+ const testCode = 'CCN_' + Math.floor(Date.now() / 1000);
64
+ setAngularInput('input[formcontrolname="code"]', testCode);
65
+ setAngularInput('input[formcontrolname="name"]', 'Cụm Công Nghiệp ' + testCode);
66
+ setAngularInput('textarea[formcontrolname="address"]', 'Địa chỉ kiểm thử tự động');
67
+ });
68
+
69
+ const saveBtn = page.locator('button:has-text("Lưu"), button:has-text("Xác nhận"), button[title="Xác nhận"]').first();
70
+ const isEnabled = !(await saveBtn.isDisabled());
71
+ if (isEnabled) {
72
+ await saveBtn.click();
73
+ await page.waitForTimeout(1500);
74
+ }
75
+ return { isSaveButtonEnabled: isEnabled };
76
+ }
77
+ ```
78
+
79
+ ## Recipe 5: Confirm Dialog & Deletion (`p-confirmdialog`)
80
+ ```javascript
81
+ async (page) => {
82
+ await page.locator('p-table tbody tr button.p-button-danger, p-table tbody tr button[icon*="trash"]').first().click();
83
+ await page.waitForTimeout(500);
84
+
85
+ const confirmBtn = page.locator('.p-confirm-dialog-accept, button:has-text("Đồng ý"), button:has-text("Xóa")').first();
86
+ await confirmBtn.click();
87
+ await page.waitForTimeout(1000);
88
+
89
+ const toastText = await page.locator('.p-toast-message-content').innerText().catch(() => 'No toast');
90
+ return { toastText };
91
+ }
92
+ ```
93
+
94
+ ## Recipe 6: File Upload & Excel Import (`input[type="file"]`)
95
+ ```javascript
96
+ async (page, customPath = 'Data Files/sample_import.xlsx') => {
97
+ const fs = require('fs');
98
+ const filePath = fs.existsSync(customPath) ? customPath : 'Data Files/sample_import.xlsx';
99
+ await page.locator('input[type="file"]').setInputFiles(filePath);
100
+ await page.waitForTimeout(1000);
101
+
102
+ await page.locator('button:has-text("Tải lên"), button:has-text("Xác nhận")').first().click();
103
+ await page.waitForTimeout(2000);
104
+ return { status: "Uploaded", fileUsed: filePath };
105
+ }
106
+ ```
107
+
108
+ ## Recipe 7: OpenLayers GIS Canvas Interaction (`div.ol-viewport`)
109
+ ```javascript
110
+ async (page) => {
111
+ const canvas = page.locator('div.ol-viewport canvas').first();
112
+ const box = await canvas.boundingBox();
113
+ const cx = box.x + box.width / 2;
114
+ const cy = box.y + box.height / 2;
115
+
116
+ // Click polygon at non-overlapping offset (-180, -80)
117
+ await page.mouse.click(cx - 180, cy - 80);
118
+ await page.waitForTimeout(400);
119
+ await page.mouse.click(cx - 150, cy - 80);
120
+ await page.waitForTimeout(400);
121
+ await page.mouse.click(cx - 150, cy - 50);
122
+ await page.waitForTimeout(400);
123
+ await page.mouse.dblclick(cx - 180, cy - 80);
124
+ await page.waitForTimeout(1000);
125
+
126
+ const result = await page.evaluate(() => {
127
+ const error = document.querySelector('.text-danger, .invalid-feedback, editor-widget');
128
+ return {
129
+ hasError: !!error,
130
+ errorText: error ? error.innerText : ''
131
+ };
132
+ });
133
+ return result;
134
+ }
135
+ ```
136
+
137
+ ## Recipe 8: Advanced OpenLayers Map Inspection & VN2000 Coordinates
138
+ ```javascript
139
+ async (page) => {
140
+ return await page.evaluate(() => {
141
+ const viewport = document.querySelector('div.ol-viewport');
142
+ if (!viewport) return { error: "div.ol-viewport not found" };
143
+
144
+ const map = viewport['__ol_map__'] || (window.map instanceof Object ? window.map : null);
145
+ let mapInfo = {};
146
+ if (map && map.getView) {
147
+ const view = map.getView();
148
+ mapInfo = {
149
+ zoom: view.getZoom(),
150
+ center: view.getCenter(),
151
+ projection: view.getProjection() ? view.getProjection().getCode() : 'Unknown'
152
+ };
153
+ }
154
+ const toolbarButtons = Array.from(document.querySelectorAll('.ol-control button, .map-toolbar button, .gis-tools button'))
155
+ .map(b => ({ title: b.getAttribute('title') || b.innerText.trim(), className: b.className }));
156
+ return { mapInfo, toolbarButtons };
157
+ });
158
+ }
159
+ ```
160
+
161
+ ## Recipe 9: Two-Phase Search Workflow
162
+ ```javascript
163
+ async (page) => {
164
+ const searchToggleBtn = page.locator('button.p-button-icon-only[icon*="search"], button[title*="Tìm kiếm"], button:has-text("Tìm kiếm")').first();
165
+ const searchInput = page.locator('input.p-inputtext[placeholder*="Tìm kiếm"], input[placeholder*="tên"], input[placeholder*="mã"]').first();
166
+
167
+ if (!(await searchInput.isVisible())) {
168
+ await searchToggleBtn.click();
169
+ await page.waitForTimeout(300);
170
+ }
171
+
172
+ const keyword = 'CCN_TEST_2026';
173
+ await searchInput.fill(keyword);
174
+ await searchInput.press('Enter');
175
+ await page.waitForTimeout(1000);
176
+
177
+ const rowCount = await page.locator('p-table table tbody tr').count();
178
+ const matched = rowCount > 0 && (await page.locator('p-table table tbody tr').first().innerText()).includes(keyword);
179
+ return { rowCount, matched };
180
+ }
181
+ ```
182
+
183
+ ## Recipe 10: Intercepting PrimeNG Toasts (`p-toast`)
184
+ ```javascript
185
+ async (page) => {
186
+ const toastSelector = '.p-toast-message, .p-toast-message-content';
187
+ try {
188
+ const toast = await page.waitForSelector(toastSelector, { timeout: 4000 });
189
+ const text = await toast.innerText();
190
+ const isSuccess = (await toast.getAttribute('class') || '').includes('p-toast-message-success');
191
+ return { success: true, text, isSuccess };
192
+ } catch (e) {
193
+ return { success: false, message: 'Toast did not appear or expired too quickly' };
194
+ }
195
+ }
196
+ ```
197
+
198
+ ## Recipe 11: Record Deletion & Confirmation Dialog (`p-confirmdialog`)
199
+ ```javascript
200
+ async (page, targetKeyword) => {
201
+ const searchInput = page.locator('input.p-inputtext[placeholder*="Tìm kiếm"], input[placeholder*="tên"], input[placeholder*="mã"]').first();
202
+ await searchInput.fill(targetKeyword);
203
+ await searchInput.press('Enter');
204
+ await page.waitForTimeout(1000);
205
+
206
+ const deleteBtn = page.locator('p-table tbody tr:first-child button.p-button-danger, p-table tbody tr:first-child button[icon*="trash"]').first();
207
+ await deleteBtn.click();
208
+ await page.waitForTimeout(500);
209
+
210
+ const confirmBtn = page.locator('.p-confirm-dialog-accept, .p-dialog-footer button:has-text("Xóa"), .p-dialog-footer button:has-text("Đồng ý"), button.p-button-danger:has-text("Xóa")').first();
211
+ await confirmBtn.waitFor({ state: 'visible', timeout: 3000 });
212
+ await confirmBtn.click();
213
+ await page.waitForTimeout(1500);
214
+
215
+ await searchInput.fill(targetKeyword);
216
+ await searchInput.press('Enter');
217
+ await page.waitForTimeout(1000);
218
+ const remainingRows = await page.locator('p-table table tbody tr').count();
219
+ const firstRowText = remainingRows > 0 ? await page.locator('p-table table tbody tr').first().innerText() : '';
220
+ const isDeleted = remainingRows === 0 || !firstRowText.includes(targetKeyword) || firstRowText.includes('Không có dữ liệu');
221
+
222
+ return { isDeleted, remainingRows, firstRowText };
223
+ }
224
+ ```
225
+
226
+ ## Recipe 12: PrimeNG Calendar Date Input (`p-calendar`)
227
+ ```javascript
228
+ async (page) => {
229
+ const dateValue = '25/10/2026';
230
+ await page.evaluate(({ selector, val }) => {
231
+ const calInput = document.querySelector(selector);
232
+ if (calInput) {
233
+ calInput.value = val;
234
+ calInput.dispatchEvent(new Event('input', { bubbles: true }));
235
+ calInput.dispatchEvent(new Event('change', { bubbles: true }));
236
+ calInput.dispatchEvent(new Event('blur', { bubbles: true }));
237
+ }
238
+ }, { selector: 'p-calendar input, input[formcontrolname*="date"], input[formcontrolname*="Date"]', val: dateValue });
239
+
240
+ await page.waitForTimeout(300);
241
+ return { status: 'Date filled', value: dateValue };
242
+ }
243
+ ```
244
+
245
+ ## Recipe 13: PrimeNG MultiSelect Dropdown (`p-multiselect`)
246
+ ```javascript
247
+ async (page, optionsToSelect = ['Công nghiệp chế biến', 'Điện lực']) => {
248
+ const multiSelect = page.locator('p-multiselect').first();
249
+ await multiSelect.click();
250
+ await page.waitForSelector('.p-multiselect-panel', { state: 'visible', timeout: 3000 });
251
+ await page.waitForTimeout(300);
252
+
253
+ for (const optText of optionsToSelect) {
254
+ const item = page.locator('.p-multiselect-item').filter({ hasText: optText }).first();
255
+ if (await item.isVisible()) {
256
+ await item.click();
257
+ await page.waitForTimeout(200);
258
+ }
259
+ }
260
+
261
+ const closeBtn = page.locator('.p-multiselect-close').first();
262
+ if (await closeBtn.isVisible()) {
263
+ await closeBtn.click();
264
+ } else {
265
+ await page.keyboard.press('Escape');
266
+ }
267
+ await page.waitForTimeout(300);
268
+ return { selected: optionsToSelect };
269
+ }
270
+ ```
271
+
272
+ ## Recipe 14: Handling Stale Elements & Angular DOM Re-render Retries
273
+ ```javascript
274
+ async (page, actionFn) => {
275
+ const maxRetries = 3;
276
+ for (let attempt = 1; attempt <= maxRetries; attempt++) {
277
+ try {
278
+ return await actionFn(page);
279
+ } catch (err) {
280
+ if (err.message.includes('Element is not attached to the DOM') || err.message.includes('stale') || attempt === maxRetries) {
281
+ if (attempt === maxRetries) throw err;
282
+ await page.waitForTimeout(500 * attempt);
283
+ } else {
284
+ throw err;
285
+ }
286
+ }
287
+ }
288
+ }
289
+ ```
290
+
291
+
292
+ ## Recipe 15: Instant Angular Form Audit (Diagnose Disabled Save Button)
293
+ ```javascript
294
+ async (page) => {
295
+ return await page.evaluate(() => {
296
+ const invalidInputs = Array.from(document.querySelectorAll('form .ng-invalid, input.ng-invalid, p-dropdown.ng-invalid, textarea.ng-invalid'));
297
+ return invalidInputs.map(el => ({
298
+ tag: el.tagName.toLowerCase(),
299
+ control: el.getAttribute('formcontrolname') || el.getAttribute('name') || el.id || 'unnamed',
300
+ placeholder: el.getAttribute('placeholder') || '',
301
+ currentValue: el.value || el.innerText.trim()
302
+ }));
303
+ });
304
+ }
305
+ ```
306
+
307
+ ## Recipe 16: Smart Action Batching (Atomic Execution with Pause-on-Failure)
308
+ ```javascript
309
+ async (page) => {
310
+ return await page.evaluate(() => {
311
+ const steps = [
312
+ { name: 'fill_code', fn: () => { const el = document.querySelector("input[formcontrolname='code']"); el.value = 'CCN_TEST'; el.dispatchEvent(new Event('input', {bubbles: true})); } },
313
+ { name: 'fill_name', fn: () => { const el = document.querySelector("input[formcontrolname='name']"); el.value = 'Cụm CN Test'; el.dispatchEvent(new Event('input', {bubbles: true})); } },
314
+ { name: 'submit', fn: () => { document.querySelector("button[type='submit']").click(); } }
315
+ ];
316
+
317
+ for (let i = 0; i < steps.length; i++) {
318
+ try {
319
+ steps[i].fn();
320
+ } catch (err) {
321
+ return { status: 'FAILED', failedStep: i + 1, name: steps[i].name, error: err.message, url: location.href };
322
+ }
323
+ }
324
+ return { status: 'SUCCESS', totalSteps: steps.length };
325
+ });
326
+ }
327
+ ```
328
+
329
+ ## Recipe 17: Runtime Helper Injection (`window.__qa`)
330
+ ```javascript
331
+ async (page) => {
332
+ // Injects the centralized browser helper tools/browser_helpers.js
333
+ const fs = require('fs');
334
+ const helperCode = fs.readFileSync('tools/browser_helpers.js', 'utf8');
335
+ await page.evaluate(helperCode);
336
+ return await page.evaluate(() => ({
337
+ version: window.__qa.__version,
338
+ auditResults: window.__qa.audit()
339
+ }));
340
+ }
341
+ ```
342
+
343
+ ## Recipe 18: Self-Healing Locator Fallback (`window.__qa.heal`)
344
+ ```javascript
345
+ async (page, brokenXPath, expectedText) => {
346
+ return await page.evaluate(({ xpath, text }) => {
347
+ if (window.__qa) {
348
+ return window.__qa.heal(xpath, text);
349
+ }
350
+ // Fallback search
351
+ const buttons = Array.from(document.querySelectorAll('button')).filter(b => b.innerText.includes(text));
352
+ return {
353
+ candidates: buttons.map(b => `//button[contains(normalize-space(.), '${b.innerText.trim()}')]`)
354
+ };
355
+ }, { xpath: brokenXPath, text: expectedText });
356
+ }
357
+ ```
358
+
359
+ ## Recipe 19: Overlay-Proof Safe Click (`window.__qa.clickSafe`)
360
+ ```javascript
361
+ async (page, selector) => {
362
+ return await page.evaluate((sel) => {
363
+ if (window.__qa) {
364
+ return window.__qa.clickSafe(sel);
365
+ }
366
+ const el = document.querySelector(sel);
367
+ if (!el) return false;
368
+ document.querySelectorAll('.p-component-overlay').forEach(o => o.style.pointerEvents = 'none');
369
+ el.click();
370
+ return true;
371
+ }, selector);
372
+ }
373
+ ```
374
+
375
+ ## Recipe 20: OpenLayers GIS Canvas Coordinate Inspector (`window.__qa.gisHUD`)
376
+ ```javascript
377
+ async (page) => {
378
+ return await page.evaluate(() => {
379
+ if (window.__qa) {
380
+ return window.__qa.gisHUD();
381
+ }
382
+ const vp = document.querySelector('.ol-viewport');
383
+ if (!vp) return { status: 'NO_MAP' };
384
+ const r = vp.getBoundingClientRect();
385
+ return { width: r.width, height: r.height, safeCenter: { x: r.width / 2, y: r.height / 2 } };
386
+ });
387
+ }
388
+ ```
@@ -0,0 +1,134 @@
1
+ # Enterprise Multi-Agent Swarm Orchestration Guide (Enterprise Automation)
2
+
3
+ Standard operating procedure, role taxonomy, and collaboration protocol for the **Enterprise Test Engineering Swarm** covering all 259 Test Cases.
4
+
5
+ ---
6
+
7
+ ## 1. Organizational Hierarchy & Role Taxonomy
8
+
9
+ ```mermaid
10
+ flowchart TD
11
+ Boss["👑 PROJECT LEAD (Test Manager / QA Director)<br/>(Strategic direction & final sign-off)"] --> Head["👔 LEAD QA ORCHESTRATOR<br/>(Overall coordination & quality governance)"]
12
+
13
+ subgraph SpecializedSwarm["SPECIALIZED AUTOMATION SWARM"]
14
+ Scout["🔍 LIVE INTERACTION EXPLORER<br/>(DOM/AOM live probing via Playwright MCP)"]
15
+ Crafter["⚒️ AUTOMATION CODE CRAFTER<br/>(Page Classes & Clean POM Groovy scripts)"]
16
+ Runner["⚡ TEST EXECUTION RUNNER<br/>(Headless Katalon CLI execution)"]
17
+ Judge["🛡️ QUALITY GATEKEEPER & ANALYST<br/>(100% UTF-8 No BOM, anti-bypass & RCA)"]
18
+ Scribe["📖 TECHNICAL DOCUMENTATION SPECIALIST<br/>(Business workflows & visual charting)"]
19
+ end
20
+
21
+ Head --> Scout & Crafter & Runner & Judge & Scribe
22
+ ```
23
+
24
+ ---
25
+
26
+ ## 2. Enterprise Collaboration Protocol
27
+
28
+ 1. **User Communication (Project Lead):**
29
+ * Demeanor: Results-oriented, data-driven, concise, transparent.
30
+ * Language with user: Vietnamese (clear engineering terms).
31
+ 2. **Internal Agent-to-Agent Protocol:**
32
+ * **Lead QA Orchestrator:** Decomposes Acceptance Criteria, manages timeline, monitors SLAs.
33
+ * **Live Interaction Explorer:** Delivers validated JSON Data Contracts based on live DOM inspection.
34
+ * **Automation Code Crafter:** Implements Page Object Model code under test scrutiny from Runner and gatekeeping from Gatekeeper.
35
+ * **Quality Gatekeeper & Analyst:** Enforces quality standards independently; rejects fake passes; provides RCA evidence.
36
+ * **Technical Documentation Specialist:** Systematizes documentation, translates code into visual Mermaid workflows.
37
+
38
+ ---
39
+
40
+ ## 3. Specialized Role Responsibilities
41
+
42
+ ### 👑 1. Lead QA Orchestrator
43
+ * Receives objectives from Project Lead (e.g. *"Complete Industrial Clusters TC-66 to TC-80"*).
44
+ * Queries `tools/lookup_tc.py` to break down tasks into subagent batches.
45
+ * Invokes specialized subagents and synthesizes completion reports.
46
+
47
+ ### 🔍 2. Live Interaction Explorer
48
+ * **Tools:** Playwright MCP (`browser_run_code_unsafe`, `browser_navigate`).
49
+ * **Tasks:**
50
+ - Loads `.agents/session.json` (Zero-Second Auth).
51
+ - Inspects live routes: URL, Title, interactive buttons, inputs, dropdown overlays.
52
+ - Verifies 100% selector hit rate on live browser.
53
+ - Returns compact JSON Data Contract to Code Crafter.
54
+
55
+ ### ⚒️ 3. Automation Code Crafter
56
+ * **Tools:** File editing tools.
57
+ * **Tasks:**
58
+ - Consumes Data Contract from Explorer.
59
+ - Implements `public static` methods in `Keywords/pages/<PageClass>.groovy` inheriting `BasePage`.
60
+ - Generates corresponding test scripts (`Scripts/TC-xxx .../Script*.groovy`).
61
+ - Strict compliance with Flat Architecture and Clean POM (zero raw XPaths in test scripts).
62
+
63
+ ### ⚡ 4. Test Execution Runner
64
+ * **Tools:** Run command tools (`katalonc`, shell/PowerShell runners).
65
+ * **Tasks:**
66
+ - Executes targeted suites or batches in pure Headless Mode.
67
+ - Captures `Screenshots/FAILED_*.png` on failure; compiles Allure reports.
68
+ - Hands over results to Quality Gatekeeper.
69
+
70
+ ### 🛡️ 5. Quality Gatekeeper & Failure Analyst
71
+ * **Tools:** Static checkers, test assertion validators.
72
+ * **Tasks:**
73
+ - Enforces 100% UTF-8 No BOM (`0xEF, 0xBB, 0xBF`).
74
+ - Rejects fake passes (verifies real toast notifications and table data).
75
+ - Conducts visual RCA via `triage_failures.sh` and `Screenshots/FAILED_*.png`.
76
+
77
+ ### 📖 6. Technical Documentation Specialist
78
+ * **Tasks:**
79
+ - Translates `.groovy` scripts into plain business requirements.
80
+ - Generates Mermaid sequence and flowchart diagrams.
81
+ - Documents technical rationale (why specific coordinates or synthetic events are required).
82
+
83
+ ---
84
+
85
+ ## 4. Launching Swarm in Antigravity
86
+
87
+ - **Method 1 (UI Slash Command):** Type `/teamwork-preview` to visualize parallel subagents.
88
+ - **Method 2 (Autonomous Prompt):** Prompt: *"Act as Lead QA Orchestrator, dispatch Swarm to complete TC-123 through TC-127."*
89
+ * Orchestrator invokes `Live Explorer` for DOM probing.
90
+ * Next invokes `Code Crafter` to write Groovy code.
91
+ * Finally invokes `Quality Gatekeeper` for verification.
92
+
93
+ ---
94
+
95
+ ## 5. Multi-Agent Adversarial Debate
96
+
97
+ ```mermaid
98
+ sequenceDiagram
99
+ participant Crafter as ⚒️ Automation Code Crafter
100
+ participant Explorer as 🔍 Live Interaction Explorer
101
+ participant Gatekeeper as 🛡️ Quality Gatekeeper
102
+ participant Judge as 👑 Lead QA Orchestrator
103
+
104
+ Crafter->>Explorer: "Created Supermarket method drawing Polygon at (-180, -80)."
105
+ Explorer-->>Crafter: "CHALLENGE: Live DOM shows Supermarket is POINT, not POLYGON! Will fail like TC-135."
106
+ Crafter->>Crafter: Refactors to clickPointOnCanvas().
107
+ Crafter->>Gatekeeper: "Submitted updated Point implementation."
108
+ Gatekeeper-->>Crafter: "CHALLENGE: Only delay(3) without verifying real success Toast. Fake pass detected!"
109
+ Crafter->>Crafter: Adds verifyMiningSuccess('thành công').
110
+ Crafter->>Gatekeeper: "Added real Toast assertion + verified UTF-8 No BOM."
111
+ Gatekeeper->>Judge: "REPORT: Code 100% compliant."
112
+ Judge->>Judge: Consensus reached -> Commit code!
113
+ ```
114
+
115
+ ---
116
+
117
+ ## 6. Model Routing Strategy (Quota Optimization)
118
+
119
+ | Subagent Role | Recommended Model | Rationale & Tasks |
120
+ |---|:---:|---|
121
+ | **Quality Gatekeeper & Failure Analyst** | `flash` / `flash_lite` | Parses long KRE console logs, checks JUnit XML & BOM, ultra-fast (<0.5s), saves 70% quota. |
122
+ | **Test Execution Runner** | `flash` | Executes CLI runners, checks exit codes. |
123
+ | **Live Interaction Explorer** | `pro` / `inherit` | Complex DOM inspection, OpenLayers GIS navigation, AOM snapshots. |
124
+ | **Automation Code Crafter** | `pro` / `inherit` | Clean POM Groovy refactoring, Angular synthetic event handling. |
125
+ | **Lead QA Orchestrator** | `pro` / `inherit` | Acceptance Criteria decomposition and architectural decision-making. |
126
+
127
+ ---
128
+
129
+ ## 7. Auto Cleanup Blacklist
130
+
131
+ All Subagents **MUST** clean up temporary files before returning control to Orchestrator:
132
+ - Dumps: `*_debug.txt`, `debug_output.txt`, `dom_dump.txt`, `html_dump.html`, `network_requests.txt`, `console_log.txt`
133
+ - Snapshots: `page_snapshot.md`, `snapshot_*.md`, `.agents/screenshots/gis_canvas_live.png`
134
+ - Scratch files: `scratch_*.*`, `*.tmp`, `*.temp`
@@ -0,0 +1,93 @@
1
+ ---
2
+ name: playwright-webapp-testing
3
+ description: "Drive Playwright test runs against a local web application with a managed server lifecycle: start, wait for readiness, run automation, and guarantee teardown. Use when verifying frontend functionality or debugging UI behavior of a dynamic webapp that must be started before testing."
4
+ ---
5
+
6
+ # Playwright Webapp Testing — Enterprise Server-Lifecycle Standard
7
+
8
+ Specialized skill for testing local dynamic web applications with Playwright under Synapse Hub rules: managed server lifecycle, smart waits instead of static sleeps, and the 3-Stage Live Protocol for selector discovery.
9
+
10
+ ---
11
+
12
+ ## 1. Server Lifecycle Contract
13
+
14
+ ```mermaid
15
+ flowchart LR
16
+ A["1. Spawn server<br/>(command + port)"] --> B["2. Poll readiness<br/>(port/health endpoint)"]
17
+ B --> C["3. Run automation<br/>(Playwright headless)"]
18
+ C --> D["4. Teardown<br/>(always, even on failure)"]
19
+ ```
20
+
21
+ - **Rule:** the automation script contains ONLY Playwright logic. Server spawn, readiness polling, and teardown are handled by the lifecycle wrapper so the browser never races the server.
22
+ - Single server: launch the app command, poll its port until ready, then run the suite.
23
+ - Multiple servers (backend + frontend): every server gets its own readiness poll; the suite starts only after ALL are ready.
24
+ - Teardown is unconditional — a failed test run must still shut down spawned processes (driver/process cleanup mirrors `katalon-cli-runner` discipline).
25
+
26
+ ## 2. Standard Configuration (Hub Baseline)
27
+
28
+ - **Headless mode, 1920x1080 Full HD viewport** — mandatory per `AGENTS.md` Section 2.
29
+ - Chromium first; multi-browser coverage is governed by `e2e-testing-patterns`.
30
+ - Launch pattern:
31
+
32
+ ```python
33
+ from playwright.sync_api import sync_playwright
34
+
35
+ with sync_playwright() as p:
36
+ browser = p.chromium.launch(headless=True) # always headless
37
+ page = browser.new_page(viewport={"width": 1920, "height": 1080})
38
+ page.goto("http://localhost:5173")
39
+ page.wait_for_load_state("networkidle") # CRITICAL: wait for JS to execute
40
+ # automation logic using discovered selectors
41
+ browser.close()
42
+ ```
43
+
44
+ ## 3. Decision Tree: Static vs Dynamic
45
+
46
+ ```
47
+ Task -> Is the page static HTML?
48
+ |- Yes -> Read the HTML directly to identify selectors, then script.
49
+ |- No (dynamic webapp) -> Is the server already running?
50
+ |- No -> Apply the full lifecycle contract (section 1), then script.
51
+ |- Yes -> Reconnaissance-then-action (section 4) on the live app.
52
+ ```
53
+
54
+ ## 4. Reconnaissance-Then-Action Pattern
55
+
56
+ For a dynamic app, never guess selectors:
57
+
58
+ 1. Navigate and wait for `networkidle`.
59
+ 2. Inspect the rendered state: screenshot or DOM snapshot (`browser_helpers.js` in-browser validation engine for form audits and safe clicks).
60
+ 3. Identify selectors from the rendered state using the 6-Tier locator priority from `clean-pom-crafter` (ARIA/test-id first).
61
+ 4. Execute actions with discovered, verified selectors.
62
+
63
+ **Common pitfall:** inspecting the DOM before `networkidle` on dynamic apps. The wait comes first, inspection second — always.
64
+
65
+ ## 5. Smart Wait Rules (Zero Static Sleeps)
66
+
67
+ - FORBIDDEN: `time.sleep()`, `Thread.sleep()`, fixed `wait_for_timeout` as a synchronization strategy (per `AGENTS.md` Section 1).
68
+ - Required: `wait_for_load_state("networkidle")`, `wait_for_selector`, `expect` web-first assertions with auto-retry, or explicit condition polling.
69
+ - `wait_for_timeout` is tolerated only inside after-step settle windows where no condition is observable, and must carry a comment explaining why.
70
+
71
+ ## 6. Evidence & Debugging Rules
72
+
73
+ - Capture console logs and failed-request events during runs; attach the distilled failure block to reports, not full logs (distill via `tools/distill_log.py`).
74
+ - On failure: apply `systematic-debugging` — reproduce, isolate, root-cause — before touching selectors; broken locators heal via `self-healing-locator` with a live re-probe through Stage 1 of the Live Protocol.
75
+ - Claims of "suite passes" follow `verification-before-completion`: quote the fresh run output.
76
+
77
+ ## 7. Boundary vs Sibling Skills (Do Not Confuse)
78
+
79
+ | Sibling | Owns | Hand-off |
80
+ |---|---|---|
81
+ | `playwright-live-interaction` | Stage 1 DOM/AOM probing and 200ms selector verification | This skill consumes verified selector contracts for full app test runs |
82
+ | `e2e-testing-patterns` | Multi-browser architecture, sharding, retry governance | This skill owns the single-run server lifecycle; suite topology stays with e2e patterns |
83
+ | `auth-session-and-cookie-manager` | Login states, storageState, multi-role sessions | Complex auth flows inject their storageState before this skill's run starts |
84
+
85
+ ## 8. Reference Documentation
86
+
87
+ - [Server lifecycle example (`server_lifecycle_playwright.py`)](examples/server_lifecycle_playwright.py): readiness-polling wrapper + minimal automation script.
88
+ - `tools/browser_helpers.js` — in-browser validation engine (safe clicks, form audits, batch verification).
89
+ - `tools/distill_log.py` — distill verbose run logs by ~95% before attaching to reports.
90
+
91
+ ## 9. Attribution
92
+
93
+ Adapted from **webapp-testing** in anthropics/skills (https://github.com/anthropics/skills) — Apache License 2.0, Copyright 2026 Anthropic, PBC. The server-lifecycle contract, decision tree, and reconnaissance-then-action pattern are re-scoped to Synapse Hub standards (headless 1920x1080, smart waits, hub tool wiring); this is a rewritten derivative, not a verbatim copy.
@@ -0,0 +1,63 @@
1
+ """Example: managed server lifecycle + minimal Playwright automation.
2
+
3
+ Hub baseline: headless chromium, 1920x1080 viewport, networkidle wait,
4
+ unconditional teardown. The automation script contains only Playwright
5
+ logic; the lifecycle wrapper owns spawn/ready/teardown.
6
+ """
7
+ import socket
8
+ import subprocess
9
+ import time
10
+ from contextlib import contextmanager
11
+
12
+ from playwright.sync_api import sync_playwright
13
+
14
+ APP_DIR = "apps/web" # relative to the target project root
15
+ START_CMD = ["npm", "run", "dev"] # argv list: never spawn with shell=True
16
+ PORT = 5173
17
+ READY_TIMEOUT_S = 30
18
+
19
+
20
+ def _port_ready(port: int) -> bool:
21
+ with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sock:
22
+ sock.settimeout(1)
23
+ return sock.connect_ex(("127.0.0.1", port)) == 0
24
+
25
+
26
+ @contextmanager
27
+ def managed_server(start_cmd: list, port: int):
28
+ """Spawn the app server, poll readiness, guarantee teardown."""
29
+ proc = subprocess.Popen(start_cmd, shell=False, cwd=APP_DIR)
30
+ try:
31
+ deadline = time.monotonic() + READY_TIMEOUT_S
32
+ while not _port_ready(port):
33
+ if time.monotonic() > deadline:
34
+ raise RuntimeError(f"server not ready on port {port} within {READY_TIMEOUT_S}s")
35
+ time.sleep(0.5) # poll interval, not a synchronization sleep
36
+ yield
37
+ finally:
38
+ proc.terminate()
39
+ try:
40
+ proc.wait(timeout=10)
41
+ except subprocess.TimeoutExpired:
42
+ proc.kill()
43
+
44
+
45
+ def run_automation() -> None:
46
+ with sync_playwright() as p:
47
+ browser = p.chromium.launch(headless=True) # always headless
48
+ page = browser.new_page(viewport={"width": 1920, "height": 1080})
49
+ try:
50
+ page.goto("http://localhost:5173")
51
+ page.wait_for_load_state("networkidle") # CRITICAL before inspection
52
+ # Reconnaissance-then-action: verify selectors via the live DOM
53
+ # contract from playwright-live-interaction before acting on them.
54
+ page.get_by_role("button", name="Create invoice").click()
55
+ page.get_by_role("dialog").wait_for(state="visible")
56
+ assert "Invoice" in page.get_by_role("heading").inner_text()
57
+ finally:
58
+ browser.close() # unconditional teardown
59
+
60
+
61
+ if __name__ == "__main__":
62
+ with managed_server(START_CMD, PORT):
63
+ run_automation()