@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,209 @@
1
+ # Groovy Patterns for Katalon Studio
2
+
3
+ This document provides common Groovy patterns and best practices for Katalon Studio custom keywords and test scripts.
4
+
5
+ ## Custom Keyword Structure
6
+
7
+ ### Basic Custom Keyword Class
8
+
9
+ ```groovy
10
+ package com.enterprise.keywords
11
+
12
+ import com.kms.katalon.core.annotation.Keyword
13
+ import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
14
+ import internal.GlobalVariable
15
+
16
+ class LoginKeywords {
17
+
18
+ @Keyword
19
+ def login(String username, String password) {
20
+ WebUI.setText(findTestObject('Page_Login/input_Username'), username)
21
+ WebUI.setEncryptedText(findTestObject('Page_Login/input_Password'), password)
22
+ WebUI.click(findTestObject('Page_Login/btn_Login'))
23
+ WebUI.waitForPageLoad(GlobalVariable.timeout)
24
+ }
25
+
26
+ @Keyword
27
+ def loginWithGlobalVariables() {
28
+ login(GlobalVariable.username, GlobalVariable.password)
29
+ }
30
+
31
+ @Keyword
32
+ def verifyLoginSuccess() {
33
+ WebUI.verifyElementPresent(findTestObject('Page_Dashboard/header_Welcome'),
34
+ GlobalVariable.timeout)
35
+ }
36
+ }
37
+ ```
38
+
39
+ ### Static Keywords
40
+
41
+ When keywords don't need instance state, make them static:
42
+
43
+ ```groovy
44
+ package com.enterprise.utils
45
+
46
+ import com.kms.katalon.core.annotation.Keyword
47
+ import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
48
+
49
+ class NavigationUtils {
50
+
51
+ @Keyword
52
+ static def navigateToPage(String pageName) {
53
+ String url = "${GlobalVariable.baseUrl}/${pageName}"
54
+ WebUI.navigateToUrl(url)
55
+ }
56
+
57
+ @Keyword
58
+ static def refreshUntilElementVisible(TestObject element, int maxAttempts = 5) {
59
+ int attempts = 0
60
+ while (attempts < maxAttempts) {
61
+ if (WebUI.verifyElementVisible(element, FailureHandling.OPTIONAL)) {
62
+ return true
63
+ }
64
+ WebUI.refresh()
65
+ attempts++
66
+ }
67
+ return false
68
+ }
69
+ }
70
+ ```
71
+
72
+ ## Common Patterns
73
+
74
+ ### Wait and Retry Pattern
75
+
76
+ ```groovy
77
+ @Keyword
78
+ def waitAndRetry(TestObject element, int maxAttempts = 3, int delaySeconds = 2) {
79
+ for (int i = 0; i < maxAttempts; i++) {
80
+ try {
81
+ WebUI.waitForElementPresent(element, delaySeconds)
82
+ return true
83
+ } catch (Exception e) {
84
+ if (i == maxAttempts - 1) {
85
+ throw e
86
+ }
87
+ WebUI.delay(delaySeconds)
88
+ }
89
+ }
90
+ return false
91
+ }
92
+ ```
93
+
94
+ ### Conditional Element Interaction
95
+
96
+ ```groovy
97
+ @Keyword
98
+ def clickIfPresent(TestObject element, int timeout = 5) {
99
+ if (WebUI.verifyElementPresent(element, timeout, FailureHandling.OPTIONAL)) {
100
+ WebUI.click(element)
101
+ return true
102
+ }
103
+ return false
104
+ }
105
+
106
+ @Keyword
107
+ def closePopupIfExists(TestObject closeButton) {
108
+ if (WebUI.verifyElementVisible(closeButton, FailureHandling.OPTIONAL)) {
109
+ WebUI.click(closeButton)
110
+ WebUI.delay(1)
111
+ }
112
+ }
113
+ ```
114
+
115
+ ### Dynamic Object Creation
116
+
117
+ ```groovy
118
+ @Keyword
119
+ def clickDynamicElement(String xpath) {
120
+ TestObject dynamicObject = new TestObject()
121
+ dynamicObject.addProperty('xpath', ConditionType.EQUALS, xpath)
122
+ WebUI.click(dynamicObject)
123
+ }
124
+
125
+ @Keyword
126
+ def findElementByText(String tagName, String text) {
127
+ String xpath = "//${tagName}[contains(text(), '${text}')]"
128
+ TestObject element = new TestObject()
129
+ element.addProperty('xpath', ConditionType.EQUALS, xpath)
130
+ return element
131
+ }
132
+ ```
133
+
134
+ ### Data-Driven Helpers
135
+
136
+ ```groovy
137
+ @Keyword
138
+ def executeWithTestData(String testDataName, Closure action) {
139
+ TestData data = findTestData(testDataName)
140
+ int rowCount = data.getRowNumbers()
141
+
142
+ for (int i = 1; i <= rowCount; i++) {
143
+ def row = [:]
144
+ data.getColumnNames().each { col ->
145
+ row[col] = data.getValue(col, i)
146
+ }
147
+ action(row)
148
+ }
149
+ }
150
+ ```
151
+
152
+ ### Page Object Pattern
153
+
154
+ ```groovy
155
+ package com.enterprise.pages
156
+
157
+ import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
158
+ import internal.GlobalVariable
159
+
160
+ class LoginPage {
161
+
162
+ def open() {
163
+ WebUI.navigateToUrl(GlobalVariable.loginUrl)
164
+ return this
165
+ }
166
+
167
+ def login(String username, String password) {
168
+ // Implementation
169
+ }
170
+ }
171
+ ```
172
+
173
+ ### Error Handling and Logging
174
+
175
+ ```groovy
176
+ import com.kms.katalon.core.util.KeywordUtil
177
+
178
+ @Keyword
179
+ def performActionWithErrorHandling(Closure action) {
180
+ try {
181
+ action()
182
+ KeywordUtil.markPassed("Action completed successfully")
183
+ } catch (Exception e) {
184
+ KeywordUtil.logInfo("Error occurred: ${e.message}")
185
+ WebUI.takeScreenshot()
186
+ KeywordUtil.markFailed("Action failed: ${e.message}")
187
+ throw e
188
+ }
189
+ }
190
+
191
+ @Keyword
192
+ def safeClick(TestObject element, String elementName = "Element") {
193
+ try {
194
+ WebUI.waitForElementClickable(element, 10)
195
+ WebUI.click(element)
196
+ KeywordUtil.logInfo("Clicked on ${elementName}")
197
+ } catch (Exception e) {
198
+ KeywordUtil.markWarning("Could not click ${elementName}: ${e.message}")
199
+ WebUI.takeScreenshot()
200
+ }
201
+ }
202
+ ```
203
+
204
+ ### Best Practices
205
+
206
+ 1. **Use Descriptive Names**: Use clear, readable keyword names.
207
+ 2. **Handle Timeouts Gracefully**: Always set explicit wait timeouts rather than hard sleeps.
208
+ 3. **Parameterize Magic Numbers**: Define constants for retries and timeouts.
209
+ 4. **Failure Handling**: Use `FailureHandling.STOP_ON_FAILURE` for critical steps, `OPTIONAL` for transient dialogs.
@@ -0,0 +1,155 @@
1
+ # Katalon Built-in Keywords API Reference
2
+
3
+ This document provides a reference for Katalon Studio's most commonly used built-in keywords.
4
+
5
+ ## WebUI Keywords
6
+
7
+ Katalon's WebUI keywords are accessed via `com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords` (commonly imported as `WebUI`).
8
+
9
+ ### Navigation Keywords
10
+
11
+ - `WebUI.openBrowser(url)` - Open a browser and navigate to URL
12
+ - `WebUI.navigateToUrl(url)` - Navigate to a URL in the current browser
13
+ - `WebUI.closeBrowser()` - Close the current browser
14
+ - `WebUI.back()` - Navigate back in browser history
15
+ - `WebUI.forward()` - Navigate forward in browser history
16
+ - `WebUI.refresh()` - Refresh the current page
17
+ - `WebUI.switchToWindowIndex(index)` - Switch to a browser window by index
18
+ - `WebUI.switchToWindowTitle(title)` - Switch to a browser window by title
19
+ - `WebUI.switchToWindowUrl(url)` - Switch to a browser window by URL
20
+
21
+ ### Element Interaction Keywords
22
+
23
+ - `WebUI.click(testObject)` - Click on an element
24
+ - `WebUI.doubleClick(testObject)` - Double-click on an element
25
+ - `WebUI.rightClick(testObject)` - Right-click on an element
26
+ - `WebUI.setText(testObject, text)` - Set text for an input field
27
+ - `WebUI.sendKeys(testObject, text)` - Send keyboard input to an element
28
+ - `WebUI.clearText(testObject)` - Clear text from an input field
29
+ - `WebUI.selectOptionByValue(testObject, value, isRegex)` - Select dropdown option by value
30
+ - `WebUI.selectOptionByLabel(testObject, label, isRegex)` - Select dropdown option by label
31
+ - `WebUI.selectOptionByIndex(testObject, index)` - Select dropdown option by index
32
+ - `WebUI.check(testObject)` - Check a checkbox
33
+ - `WebUI.uncheck(testObject)` - Uncheck a checkbox
34
+ - `WebUI.uploadFile(testObject, filePath)` - Upload a file to a file input
35
+
36
+ ### Wait Keywords
37
+
38
+ - `WebUI.waitForElementPresent(testObject, timeoutInSeconds)` - Wait for element to be present in DOM
39
+ - `WebUI.waitForElementVisible(testObject, timeoutInSeconds)` - Wait for element to be visible
40
+ - `WebUI.waitForElementClickable(testObject, timeoutInSeconds)` - Wait for element to be clickable
41
+ - `WebUI.waitForElementNotPresent(testObject, timeoutInSeconds)` - Wait for element to not be present
42
+ - `WebUI.waitForElementNotVisible(testObject, timeoutInSeconds)` - Wait for element to not be visible
43
+ - `WebUI.waitForPageLoad(timeoutInSeconds)` - Wait for page to fully load
44
+ - `WebUI.delay(timeInSeconds)` - Pause execution for specified seconds
45
+
46
+ ### Verification Keywords
47
+
48
+ - `WebUI.verifyElementPresent(testObject, timeoutInSeconds)` - Verify element is present
49
+ - `WebUI.verifyElementVisible(testObject)` - Verify element is visible
50
+ - `WebUI.verifyElementClickable(testObject)` - Verify element is clickable
51
+ - `WebUI.verifyElementNotPresent(testObject, timeoutInSeconds)` - Verify element is not present
52
+ - `WebUI.verifyElementText(testObject, expectedText)` - Verify element contains expected text
53
+ - `WebUI.verifyTextPresent(text, isRegex)` - Verify text is present on the page
54
+ - `WebUI.verifyElementAttributeValue(testObject, attribute, expectedValue, timeoutInSeconds)` - Verify element attribute value
55
+
56
+ ### Get Keywords
57
+
58
+ - `WebUI.getText(testObject)` - Get text content of an element
59
+ - `WebUI.getAttribute(testObject, attribute)` - Get attribute value of an element
60
+ - `WebUI.getCSSValue(testObject, propertyName)` - Get CSS property value
61
+ - `WebUI.getUrl()` - Get current page URL
62
+ - `WebUI.getWindowTitle()` - Get current window title
63
+
64
+ ### Screenshot Keywords
65
+
66
+ - `WebUI.takeScreenshot(filePath)` - Take a screenshot and save to file
67
+ - `WebUI.takeFullPageScreenshot(filePath)` - Take a full-page screenshot
68
+
69
+ ## Mobile Keywords
70
+
71
+ Katalon's Mobile keywords are accessed via `com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords` (commonly imported as `Mobile`).
72
+
73
+ ### Common Mobile Keywords
74
+
75
+ - `Mobile.startApplication(appPath)` - Start a mobile application
76
+ - `Mobile.closeApplication()` - Close the current application
77
+ - `Mobile.tap(testObject, timeout)` - Tap on a mobile element
78
+ - `Mobile.setText(testObject, text, timeout)` - Set text in a mobile input
79
+ - `Mobile.getText(testObject, timeout)` - Get text from a mobile element
80
+ - `Mobile.verifyElementExist(testObject, timeout)` - Verify mobile element exists
81
+ - `Mobile.scrollToText(text)` - Scroll until specified text is visible
82
+ - `Mobile.swipe(startX, startY, endX, endY)` - Perform a swipe gesture
83
+
84
+ ## Web Service (API) Keywords
85
+
86
+ Katalon's Web Service keywords are accessed via `com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords` (commonly imported as `WS`).
87
+
88
+ ### API Keywords
89
+
90
+ - `WS.sendRequest(requestObject)` - Send a web service request
91
+ - `WS.verifyResponseStatusCode(response, statusCode)` - Verify HTTP response status code
92
+ - `WS.verifyElementPropertyValue(response, locator, expectedValue)` - Verify JSON/XML element value
93
+ - `WS.getElementPropertyValue(response, locator)` - Get value from JSON/XML response
94
+ - `WS.verifyElementsCount(response, locator, expectedCount)` - Verify count of elements in response
95
+
96
+ ## Utility Keywords
97
+
98
+ ### Checkpoint Keywords
99
+
100
+ - `findCheckpoint(checkpointName)` - Find a checkpoint by name
101
+
102
+ ### Test Case Keywords
103
+
104
+ - `findTestCase(testCasePath)` - Find a test case by path
105
+ - `WebUI.callTestCase(testCase, variables)` - Call another test case
106
+
107
+ ### Test Data Keywords
108
+
109
+ - `findTestData(testDataName)` - Find test data by name
110
+
111
+ ### Object Repository Keywords
112
+
113
+ - `findTestObject(objectPath)` - Find a test object from Object Repository
114
+ - `findTestObject(objectPath, variables)` - Find a test object with variable bindings
115
+
116
+ ## Global Variables
117
+
118
+ Access global variables defined in profiles using `internal.GlobalVariable`:
119
+
120
+ ```groovy
121
+ import internal.GlobalVariable
122
+
123
+ // Access a global variable
124
+ String url = GlobalVariable.baseUrl
125
+ String username = GlobalVariable.username
126
+ int timeout = GlobalVariable.waitTimeout
127
+ ```
128
+
129
+ ## Failure Handling
130
+
131
+ Control how test execution handles failures using `com.kms.katalon.core.model.FailureHandling`:
132
+
133
+ - `FailureHandling.STOP_ON_FAILURE` - Stop test execution on failure (default)
134
+ - `FailureHandling.CONTINUE_ON_FAILURE` - Continue execution even if step fails
135
+ - `FailureHandling.OPTIONAL` - Mark step as optional, continue regardless of result
136
+
137
+ Example:
138
+ ```groovy
139
+ WebUI.verifyElementPresent(findTestObject('optionalElement'), 5, FailureHandling.OPTIONAL)
140
+ ```
141
+
142
+ ## Annotations for Custom Keywords
143
+
144
+ When creating custom keywords, use the `@Keyword` annotation:
145
+
146
+ ```groovy
147
+ import com.kms.katalon.core.annotation.Keyword
148
+
149
+ class MyKeywords {
150
+ @Keyword
151
+ def myCustomKeyword(String param) {
152
+ // Implementation
153
+ }
154
+ }
155
+ ```
@@ -0,0 +1,67 @@
1
+ # CLI Runner Commands & Enterprise Test Suites Registry
2
+
3
+ Reference documentation for the `katalon-cli-runner` skill.
4
+
5
+ ---
6
+
7
+ ## 1. Environment Variable Configuration (.env)
8
+ ```bash
9
+ KATALON_API_KEY="your_actual_api_key_here"
10
+ KATALON_PROJECT_PATH="/path/to/project"
11
+ TELEGRAM_BOT_TOKEN="your_bot_token"
12
+ TELEGRAM_CHAT_ID="your_chat_id"
13
+ ```
14
+
15
+ ---
16
+
17
+ ## 2. Platform-Specific Execution Commands (KRE CLI)
18
+
19
+ ### 2.1. Windows Environment (PowerShell Runner)
20
+ ```powershell
21
+ # Run Test Suite with API Key
22
+ powershell -ExecutionPolicy Bypass -File .\run_tests_windows.ps1 -Suite "Test Suites/07_QuanTriDuLieu" -ApiKey $env:KATALON_API_KEY
23
+
24
+ # Run single Test Suite for debugging:
25
+ powershell -ExecutionPolicy Bypass -File .\run_tests_windows.ps1 -Suite "Test Suites/Group_07_01_CumCongNghiep"
26
+ ```
27
+
28
+ ### 2.2. macOS / Linux CLI (Headless Full HD)
29
+ ```bash
30
+ # Run Test Suite
31
+ katalonc \
32
+ -noSplash \
33
+ -runMode=console \
34
+ -projectPath="$(pwd)/project.prj" \
35
+ -retry=0 \
36
+ -testSuitePath="Test Suites/07_QuanTriDuLieu" \
37
+ -browserType="Chrome (headless)" \
38
+ -executionProfile="default" \
39
+ -apiKey="$KATALON_API_KEY" \
40
+ --args="-headless --window-size=1920,1080 --disable-gpu --no-sandbox --disable-dev-shm-usage"
41
+
42
+ # Run single Test Case (Debug Mode):
43
+ katalonc \
44
+ -noSplash \
45
+ -runMode=console \
46
+ -projectPath="$(pwd)/project.prj" \
47
+ -testCasePath="Test Cases/TC-1 Kiểm tra tạo mới thành công" \
48
+ -browserType="Chrome (headless)" \
49
+ -apiKey="$KATALON_API_KEY"
50
+ ```
51
+
52
+ ---
53
+
54
+ ## 3. Standard Enterprise Test Suite Registry
55
+
56
+ | Test Suite Name | Scale | Target Functional Module |
57
+ | :--- | :---: | :--- |
58
+ | `Test Suites/All_Tests` | Full Suite | All functional modules |
59
+ | `Test Suites/01_QuanLyChiTieu` | 7 TCs | Target Planning |
60
+ | `Test Suites/02_XacThucNguoiDung` | 5 TCs | User Authentication & Profiles |
61
+ | `Test Suites/03_QuanTriHeThong` | 4 TCs | System Administration & Users |
62
+ | `Test Suites/04_DanhMucDungChung` | 12 TCs | Common Categories (Departments, Roles) |
63
+ | `Test Suites/05_DanhMucNganhCongThuong` | 64 TCs | 16 Industry Sub-Categories |
64
+ | `Test Suites/06_QuyHoachCongThuong` | 30 TCs | Sector Planning |
65
+ | `Test Suites/07_QuanTriDuLieu` | 125 TCs | Data Mining & GIS Maps |
66
+ | `Test Suites/08_BaoCaoThongKe` | 2 TCs | Statistical Reports (Data & Permits) |
67
+ | `Test Suites/09_ChiaSeDuLieu` | 10 TCs | Data Sharing & API Token Lifecycle |
@@ -0,0 +1,123 @@
1
+ ---
2
+ name: lam-script-generator
3
+ description: "Transform user stories and acceptance criteria into Clean POM automation scripts. Use when the user provides a user story, acceptance criteria, or requirement document that must become a runnable script."
4
+ ---
5
+
6
+ # LAM Script Generator — Large Action Model for Test Automation
7
+
8
+ Inspired by the **LaVague AI Web Agent & Large Action Model (LAM)** framework, this skill bridges the gap between natural language requirements (User Stories, Acceptance Criteria) and durable, deterministic automation code conforming to Clean POM Flat Architecture.
9
+
10
+ ---
11
+
12
+ ## 1. The Dual-Engine LAM Architecture
13
+
14
+ ```mermaid
15
+ flowchart TD
16
+ UserStory["<b>Natural Language User Story</b><br/>'Add new record with dynamic code and verify success'"] --> WorldModel["<b>1. World Model (Reasoning Engine)</b><br/>• Analyzes business goal<br/>• Decomposes into atomic user action sequence<br/>• Determines preconditions & expected assertions"]
17
+
18
+ WorldModel --> ActionEngine["<b>2. Action Engine (Code Generator)</b><br/>• Queries Page Classes via Knowledge Graph<br/>• Maps action to existing methods: LoginPage.login(), TablePage.openAddModal()<br/>• Injects dynamic uniqueCode timestamp"]
19
+
20
+ ActionEngine --> CodeGen["<b>3. Durable Clean POM Script (.groovy / .ts)</b><br/>• 100% Zero raw XPath in scripts<br/>• Infinite CI/CD replays with 0 LLM Tokens"]
21
+ ```
22
+
23
+ 1. **World Model (Reasoning Engine):**
24
+ - Parses natural language requirements or QA/BA Acceptance Criteria.
25
+ - Infers the step sequence: `Login` $\rightarrow$ `Navigate to Menu` $\rightarrow$ `Open Add Modal` $\rightarrow$ `Input Dynamic Data` $\rightarrow$ `Save & Assert Toast`.
26
+ 2. **Action Engine (Code Generator):**
27
+ - Instead of speculative coordinates, Action Engine queries the project Knowledge Graph to select existing Page Classes and standardized methods.
28
+ - Generates clean, robust test scripts adhering strictly to Clean POM.
29
+ 3. **Zero-Token Replayability:**
30
+ - Once verified, the generated script is committed to the test suite on disk.
31
+ - All subsequent CI/CD pipeline runs execute deterministically without consuming any LLM tokens.
32
+
33
+ ---
34
+
35
+ ## 2. Transformation Workflow: User Story to Clean POM
36
+
37
+ ### Input (User Story):
38
+ ```text
39
+ "Verify adding a new Industry record:
40
+ 1. Login as system administrator.
41
+ 2. Navigate to Industry Data menu.
42
+ 3. Click Add New button.
43
+ 4. Fill required fields with dynamic code 'IND_' and valid name.
44
+ 5. Save and assert green success notification.
45
+ 6. Verify the new record appears in the data table."
46
+ ```
47
+
48
+ ### Output (Clean POM Groovy Script):
49
+ ```groovy
50
+ import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
51
+ import internal.GlobalVariable as GlobalVariable
52
+ import pages.LoginPage
53
+ import pages.IndustryDataPage
54
+ import common.BasePage
55
+
56
+ // 1. Arrange & Preconditions
57
+ LoginPage.login(GlobalVariable.ADMIN_USER, GlobalVariable.ADMIN_PASS)
58
+ IndustryDataPage.navigate()
59
+
60
+ // 2. Dynamic Test Data Generation
61
+ String uniqueCode = BasePage.uniqueCode("IND_")
62
+ String entityName = "Automated Test Industry " + uniqueCode
63
+
64
+ // 3. Act
65
+ IndustryDataPage.clickAddNew()
66
+ IndustryDataPage.inputDetails(uniqueCode, entityName)
67
+ IndustryDataPage.clickSave()
68
+
69
+ // 4. Assert
70
+ IndustryDataPage.assertSuccessToast()
71
+ IndustryDataPage.searchAndVerifyRecord(uniqueCode, entityName)
72
+
73
+ // 5. Teardown Cleanup
74
+ IndustryDataPage.deleteRecordByCode(uniqueCode)
75
+ ```
76
+
77
+ ---
78
+
79
+ ## 3. Mandatory Generation Constraints
80
+ - Zero raw XPaths, CSS selectors, or `findTestObject` in the generated script.
81
+ - Always generate dynamic identifiers with prefixes via `BasePage.uniqueCode()`.
82
+ - Always generate mandatory teardown cleanup for created entities.
83
+
84
+ ## 4. Proven-vs-Owed Traceability Pipeline
85
+
86
+ > *Borrowed and adapted from the Kane CLI generate→execute→prove workflow (Apache-2.0, lambdatest/kane-cli).*
87
+
88
+ Generated scripts must be traceable to the acceptance criteria they prove.
89
+ For every user story, maintain the chain:
90
+
91
+ ```mermaid
92
+ flowchart LR
93
+ Story["<b>User Story</b>"] --> UC["<b>Use Cases</b><br/>(each cites its source line)"]
94
+ UC --> AC["<b>Acceptance Criteria</b><br/>(Given/When/Then, testable)"]
95
+ AC --> SC["<b>Scenarios</b><br/>(happy + negative + boundary)"]
96
+ SC --> TC["<b>Automation Scripts</b><br/>(Clean POM, 0 raw XPath)"]
97
+ TC --> EV["<b>Proven vs Owed</b><br/>coverage per criterion"]
98
+ ```
99
+
100
+ Rules:
101
+
102
+ 1. **Every generated script cites its criterion** — keep the AC id in the test
103
+ case name or a comment header; a script nobody can trace back is a liability.
104
+ 2. **Report coverage as proven vs owed, not test counts** — a criterion with no
105
+ passing automated script is *owed*; N scripts proving one criterion is waste.
106
+ 3. **Reconcile on requirement change** — when a story changes, re-run the chain
107
+ and mark stale scripts before trusting any green run.
108
+ 4. For BDD inputs, the `gherkin-to-suite` skill performs the AC→scenario
109
+ expansion deterministically (0-token); feed its Universal IR here for
110
+ codification.
111
+
112
+ ---
113
+
114
+ ## 5. Boundary vs `clean-pom-crafter` and `gherkin-to-suite`
115
+
116
+ - **This skill** = natural-language story → action-sequence script skeleton
117
+ (the "what steps, in what order" reasoning layer).
118
+ - **`clean-pom-crafter`** owns the Page Classes and locator discipline that the
119
+ skeleton's business-flow calls resolve against — never inline raw selectors
120
+ here.
121
+ - **`gherkin-to-suite`** is the deterministic (0-token) alternative when
122
+ requirements already exist as `.feature` files; use it first, and feed its
123
+ Universal IR here only when story-level reasoning must fill the gaps.
@@ -0,0 +1,8 @@
1
+ # User Story: User Password Reset Flow
2
+ As a registered customer,
3
+ I want to request a password reset email,
4
+ So that I can regain access if I forget my password.
5
+
6
+ ## Acceptance Criteria:
7
+ 1. Submitting registered email displays "Reset link dispatched".
8
+ 2. Submitting empty email highlights field in red with validation error.
@@ -0,0 +1,94 @@
1
+ ---
2
+ name: lean-code-ladder
3
+ description: "Apply a 7-rung reuse-first ladder so every new test-automation code path is the smallest complete change that fully solves the task. Use when adding helpers, Page Class methods, dependencies, or any new code where a shorter existing option might already exist."
4
+ ---
5
+
6
+ # Lean Code Ladder — Enterprise Reuse-First Standard
7
+
8
+ Specialized skill for minimizing newly written code in test automation projects: solve the whole problem with the least new code, then finish the change completely (callers, fixtures, and the small test that proves it).
9
+
10
+ ---
11
+
12
+ ## 1. The 7-Rung Ladder & Intensity Levels
13
+
14
+ ### Intensity Levels
15
+
16
+ | Level | Behavior |
17
+ |:---:|---|
18
+ | **lite** | Build what was asked. Name the smaller/lazier option in one line and let the user pick. |
19
+ | **full** | The standard 7-rung ladder rules below. (Default) |
20
+ | **ultra** | Deletion before addition: question the request and push back on any part the business need does not strictly justify. |
21
+ | **off** | Deactivate lean constraints; standard code synthesis. |
22
+
23
+ ### The 7-Rung Ladder
24
+
25
+ Before writing any new code, descend the ladder and take the **first rung that fully works**:
26
+
27
+ | Rung | Question | Action |
28
+ |:---:|---|---|
29
+ | 0 | Does it need to exist? | Skip features, options, and flexibility nobody asked for; name what you skipped in one line. A vague request gets the smallest version that does the core job. |
30
+ | 1 | Already in the codebase? | A helper, Page Class method, or fixture exists? Use it the way the surrounding code does. |
31
+ | 2 | Standard library? | Use the language stdlib unless the project has its own equivalent. |
32
+ | 3 | Platform / framework native? | A built-in of the test framework beats a hand-rolled widget (e.g. Playwright auto-waiting, `expect` web-first assertions). |
33
+ | 4 | Installed dependency? | Use it. Never add a new dependency for a few lines. |
34
+ | 5 | One line? | Can it be one line a reader gets at a glance? Then one line. |
35
+ | 6 | Minimum new code | Write the minimum that works, and no more. |
36
+
37
+ ## 2. Reading Order Before Writing
38
+
39
+ - Read the task and the code it touches. List every place the change must reach: callers, tests, fixtures, config, exports.
40
+ - Check what the change could break: data it would destroy or expose, callers that stop working. That is scope. Extra features are not.
41
+
42
+ ## 3. Completeness Rules (Be Lazy About the Solution, Never About the Change)
43
+
44
+ - Finish every part the task needs, including the callers, tests, and fixtures the change affects.
45
+ - No abstraction, wrapper, option, config, or "for later" code nobody asked for. Keep values in the form the platform already gives. Deletion beats addition; keep the structure the codebase already has.
46
+ - The shortest working diff wins, once everything it must touch is known. A one-liner that needs decoding is not short.
47
+ - Comment only the "why" the code cannot show, in one line.
48
+ - Bug fix: grep every caller of the touched function first, then fix the root cause once in the shared code (pair with `systematic-debugging`).
49
+ - Code that is moved or merged keeps its error handling and validation.
50
+ - Between options of equal size, take the one that is correct on edge cases.
51
+ - New non-trivial logic (a branch, loop, parser, money/security path, or a whole new script) leaves one small test or assert-based self-check before it counts as finished; trivial changes need none.
52
+ - A shortcut with a known limit gets a code comment: `shortcut: <the limit>, <when to upgrade>`.
53
+
54
+ ## 4. Never Cut (Hard Floor)
55
+
56
+ The ladder minimizes code, never safety. The following are never removed or skipped in the name of leanness:
57
+
58
+ - Validation at trust boundaries
59
+ - Error handling that prevents data loss
60
+ - Security checks (credential handling, authorization assertions)
61
+ - Accessibility behavior
62
+ - Anything the user explicitly asked for
63
+
64
+ ## 5. Evidence of Leanness
65
+
66
+ - Run `python3 tools/infer_linter.py` after the change: zero fake-pass findings confirms the lean diff did not trade rigor for brevity.
67
+ - Run the affected subset from `python3 tools/test_impact.py --git-diff` to prove the shortest diff still reaches everything it had to reach.
68
+ - Lean code without its check is unfinished: Gate 8 (`tools/micro_mutator.py`, Mutation Score >= 80%) remains the floor for any assertion logic written on this ladder.
69
+
70
+ ## 6. Worked Comparison
71
+
72
+ | Situation | Bloated answer | Lean answer |
73
+ |---|---|---|
74
+ | Need a date picker in a form test | 300-line custom calendar component | Native `<input type="date">` via the existing form helper (Rung 3) |
75
+ | Need retry around a flaky API call | New generic retry framework with policy classes | The installed HTTP client's retry option (Rung 4) + one test |
76
+ | Need a formatted timestamp in test data | New utility module | One line with the stdlib formatter (Rung 2) |
77
+
78
+ ## 7. Boundary vs Sibling Skills (Do Not Confuse)
79
+
80
+ | Sibling | Owns | Hand-off |
81
+ |---|---|---|
82
+ | `surgical-coding-principles` | Diff discipline (every line traces to the request) | The ladder chooses the solution shape; surgical principles keep the diff clean |
83
+ | `code-refactoring-refactor-clean` | Deliberate SOLID refactors of existing debt | Refactoring is not ladder work; only new/changed code descends the ladder |
84
+ | `clean-pom-crafter` | Page Class architecture and locator tiers | Ladder applies inside and around Page Classes, not to their architecture contract |
85
+
86
+ ## 8. Reference Documentation
87
+
88
+ - `python3 tools/infer_linter.py` — fake-pass scan for the new logic.
89
+ - `python3 tools/test_impact.py --git-diff` — confirm the lean diff still covers all impacted tests.
90
+ - `python3 tools/micro_mutator.py` — Gate 8 mutation floor (>= 80%) for non-trivial new logic.
91
+
92
+ ## 9. Attribution
93
+
94
+ Adapted from **ponytail** (https://github.com/DietrichGebert/ponytail) — MIT License, Copyright (c) 2026 DietrichGebert. The lazy-senior ladder, completeness rules, and never-cut floor are re-scoped for enterprise test automation in Synapse Hub; wording, structure, and examples modified.