@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.
- package/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +172 -0
- package/README.md +171 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +197 -0
- package/docs/ARCHITECTURE.md +198 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +175 -0
- package/docs/CLI_REFERENCE.md +177 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +121 -0
- package/docs/QUALITY_GATES.md +121 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1359 -0
- package/docs/schemas/synapse.config.schema.json +87 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +32 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2079 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +258 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +184 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2419 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +307 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +724 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1259 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- 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.
|