@teevee98/synapse-hub 0.0.0-stage → 3.8.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +171 -0
- package/README.md +170 -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 +198 -0
- package/docs/ARCHITECTURE.md +199 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +174 -0
- package/docs/CLI_REFERENCE.md +176 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +118 -0
- package/docs/QUALITY_GATES.md +118 -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 +1358 -0
- package/docs/schemas/synapse.config.schema.json +86 -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 +31 -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 +2074 -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 +262 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +190 -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 +2403 -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 +306 -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 +725 -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 +1271 -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,167 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Enterprise QA: Fast XPath / Selector Lookup (lookup_xpath.py)
|
|
4
|
+
-------------------------------------------------------------
|
|
5
|
+
Fast lookup tool for XPaths and selectors from Page Class JSON specifications.
|
|
6
|
+
Enables AI Agents to retrieve only the relevant selectors (<300 tokens)
|
|
7
|
+
instead of reading entire selector repositories or rescanning live DOM.
|
|
8
|
+
|
|
9
|
+
Multi-tier Resolution:
|
|
10
|
+
1. CLI Flag: python tools/lookup_xpath.py <query> --file <path_to_json> (-f)
|
|
11
|
+
2. Environment variable: XPATH_DATA_FILE, SELECTORS_JSON, or LOCATORS_JSON
|
|
12
|
+
3. Automatic discovery: selectors.json, locators.json, scraped_xpaths.json...
|
|
13
|
+
4. Internal Hub archive fallback: archive/legacy_references/Enterprise_scraped_xpaths.json
|
|
14
|
+
"""
|
|
15
|
+
|
|
16
|
+
import sys
|
|
17
|
+
import json
|
|
18
|
+
import os
|
|
19
|
+
import argparse
|
|
20
|
+
|
|
21
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
22
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
23
|
+
try:
|
|
24
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
25
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
26
|
+
except Exception:
|
|
27
|
+
pass
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def resolve_json_path(cli_file=None):
|
|
31
|
+
"""Resolves Selector/XPath JSON file path via precedence order."""
|
|
32
|
+
# 1. CLI flag
|
|
33
|
+
if cli_file:
|
|
34
|
+
if os.path.exists(cli_file):
|
|
35
|
+
return os.path.abspath(cli_file)
|
|
36
|
+
else:
|
|
37
|
+
print(f"⚠️ Warning: File specified via --file '{cli_file}' does not exist.")
|
|
38
|
+
|
|
39
|
+
# 2. Environment variable
|
|
40
|
+
env_file = os.environ.get("XPATH_DATA_FILE") or os.environ.get("SELECTORS_JSON") or os.environ.get("LOCATORS_JSON")
|
|
41
|
+
if env_file and os.path.exists(env_file):
|
|
42
|
+
return os.path.abspath(env_file)
|
|
43
|
+
|
|
44
|
+
# 3. Automatic discovery in CWD and common directories
|
|
45
|
+
script_dir = os.path.dirname(os.path.abspath(__file__))
|
|
46
|
+
hub_root = os.path.abspath(os.path.join(script_dir, ".."))
|
|
47
|
+
cwd = os.getcwd()
|
|
48
|
+
|
|
49
|
+
search_dirs = [
|
|
50
|
+
cwd,
|
|
51
|
+
os.path.join(cwd, "references"),
|
|
52
|
+
os.path.join(cwd, "data"),
|
|
53
|
+
os.path.join(cwd, "tools"),
|
|
54
|
+
os.path.join(cwd, "docs"),
|
|
55
|
+
script_dir
|
|
56
|
+
]
|
|
57
|
+
|
|
58
|
+
candidate_names = [
|
|
59
|
+
"selectors.json",
|
|
60
|
+
"scraped_xpaths.json",
|
|
61
|
+
"locators.json",
|
|
62
|
+
"Enterprise_scraped_xpaths.json",
|
|
63
|
+
"page_selectors.json",
|
|
64
|
+
"elements.json"
|
|
65
|
+
]
|
|
66
|
+
|
|
67
|
+
for d in search_dirs:
|
|
68
|
+
for name in candidate_names:
|
|
69
|
+
candidate = os.path.join(d, name)
|
|
70
|
+
if os.path.isfile(candidate):
|
|
71
|
+
return os.path.abspath(candidate)
|
|
72
|
+
|
|
73
|
+
# 4. Hub Archive fallback
|
|
74
|
+
for legacy_name in ["Enterprise_scraped_xpaths.json", "dmit_scraped_xpaths.json", "batch01_scraped_xpaths.json"]:
|
|
75
|
+
legacy_file = os.path.join(hub_root, "archive", "legacy_references", legacy_name)
|
|
76
|
+
if os.path.isfile(legacy_file):
|
|
77
|
+
return os.path.abspath(legacy_file)
|
|
78
|
+
|
|
79
|
+
return None
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
def normalize_selector_data(raw_data):
|
|
83
|
+
"""Normalizes Selector data across PageClass dictionary or flat list schemas."""
|
|
84
|
+
if isinstance(raw_data, dict):
|
|
85
|
+
return raw_data
|
|
86
|
+
elif isinstance(raw_data, list):
|
|
87
|
+
grouped = {}
|
|
88
|
+
for item in raw_data:
|
|
89
|
+
page = item.get("page") or item.get("page_class") or "GLOBAL"
|
|
90
|
+
if page not in grouped:
|
|
91
|
+
grouped[page] = []
|
|
92
|
+
grouped[page].append(item)
|
|
93
|
+
return grouped
|
|
94
|
+
return {}
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
def main():
|
|
98
|
+
parser = argparse.ArgumentParser(description="Fast Selector / XPath lookup from project JSON specifications")
|
|
99
|
+
parser.add_argument("query", help="PageClass name or selector identifier keyword (e.g., TargetPlanPage, TXT_CODE)")
|
|
100
|
+
parser.add_argument("-f", "--file", dest="file", help="Path to JSON file containing selector/xpaths")
|
|
101
|
+
args = parser.parse_args()
|
|
102
|
+
|
|
103
|
+
json_path = resolve_json_path(args.file)
|
|
104
|
+
|
|
105
|
+
if not json_path:
|
|
106
|
+
print("❌ Error: Selector / XPath JSON data file not found.")
|
|
107
|
+
print("\n👉 Guidance to configure selector data for target project:")
|
|
108
|
+
print(" 1. Use CLI flag: python tools/lookup_xpath.py <query> --file <path_to_selectors.json>")
|
|
109
|
+
print(" 2. Set environment variable: export XPATH_DATA_FILE='path/to/selectors.json' (or set XPATH_DATA_FILE=...)")
|
|
110
|
+
print(" 3. Place 'selectors.json' in project root or declare path in PROJECT_AI_GUIDE.md")
|
|
111
|
+
sys.exit(1)
|
|
112
|
+
|
|
113
|
+
try:
|
|
114
|
+
with open(json_path, "r", encoding="utf-8") as f:
|
|
115
|
+
raw_data = json.load(f)
|
|
116
|
+
except Exception as e:
|
|
117
|
+
print(f"❌ Error reading file '{json_path}': {e}")
|
|
118
|
+
sys.exit(1)
|
|
119
|
+
|
|
120
|
+
data = normalize_selector_data(raw_data)
|
|
121
|
+
query = args.query.strip()
|
|
122
|
+
|
|
123
|
+
# 1. Match by Page Class name
|
|
124
|
+
matched_page = None
|
|
125
|
+
for page_name in data.keys():
|
|
126
|
+
if query.lower() == page_name.lower():
|
|
127
|
+
matched_page = page_name
|
|
128
|
+
break
|
|
129
|
+
|
|
130
|
+
if matched_page:
|
|
131
|
+
selectors = data[matched_page]
|
|
132
|
+
source_label = os.path.relpath(json_path, os.getcwd()) if os.path.exists(json_path) else json_path
|
|
133
|
+
print(f"=== {matched_page} ({len(selectors)} selectors) [Source: {source_label}] ===")
|
|
134
|
+
for item in selectors:
|
|
135
|
+
c = item.get("constant") or item.get("name") or "SELECTOR"
|
|
136
|
+
tag = item.get("tag") or "element"
|
|
137
|
+
xp = item.get("xpath") or item.get("selector") or item.get("css") or ""
|
|
138
|
+
print(f"- {c} ({tag}): {xp}")
|
|
139
|
+
return
|
|
140
|
+
|
|
141
|
+
# 2. Match keyword across constant or xpath
|
|
142
|
+
found = []
|
|
143
|
+
for page_name, selectors in data.items():
|
|
144
|
+
if isinstance(selectors, list):
|
|
145
|
+
for item in selectors:
|
|
146
|
+
c = item.get("constant") or item.get("name") or ""
|
|
147
|
+
xp = item.get("xpath") or item.get("selector") or item.get("css") or ""
|
|
148
|
+
tag = item.get("tag") or "element"
|
|
149
|
+
if query.lower() in c.lower() or query.lower() in xp.lower():
|
|
150
|
+
found.append((page_name, c, tag, xp))
|
|
151
|
+
elif isinstance(selectors, dict):
|
|
152
|
+
for c, xp in selectors.items():
|
|
153
|
+
if query.lower() in c.lower() or query.lower() in str(xp).lower():
|
|
154
|
+
found.append((page_name, c, "element", str(xp)))
|
|
155
|
+
|
|
156
|
+
if not found:
|
|
157
|
+
print(f"No selectors found matching: '{query}' in file '{os.path.basename(json_path)}'")
|
|
158
|
+
return
|
|
159
|
+
|
|
160
|
+
source_label = os.path.relpath(json_path, os.getcwd()) if os.path.exists(json_path) else json_path
|
|
161
|
+
print(f"=== Found {len(found)} selector(s) for query '{query}' [Source: {source_label}] ===")
|
|
162
|
+
for page, c, tag, xp in found[:15]:
|
|
163
|
+
print(f"[{page}] {c} ({tag}): {xp}")
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
if __name__ == "__main__":
|
|
167
|
+
main()
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Enterprise Duration-Balanced Test Matrix Sharder
|
|
4
|
+
------------------------------------------------
|
|
5
|
+
Balances parallel CI/CD test execution across N containers using historical
|
|
6
|
+
runtimes and the Greedy LPT (Longest Processing Time First) Bin-Packing algorithm.
|
|
7
|
+
Eliminates CI runner bottlenecks where one worker runs for 15m while others finish in 2m.
|
|
8
|
+
"""
|
|
9
|
+
|
|
10
|
+
import os
|
|
11
|
+
import sys
|
|
12
|
+
import json
|
|
13
|
+
import sqlite3
|
|
14
|
+
import argparse
|
|
15
|
+
from pathlib import Path
|
|
16
|
+
from typing import List, Dict, Any
|
|
17
|
+
|
|
18
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
19
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
20
|
+
try:
|
|
21
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
22
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
23
|
+
except Exception:
|
|
24
|
+
pass
|
|
25
|
+
|
|
26
|
+
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
|
|
27
|
+
HUB_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
|
|
28
|
+
CACHE_DB_PATH = os.path.expanduser("~/.agent_memory/global_cache.db")
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def find_test_files(target_dir: str) -> List[str]:
|
|
32
|
+
"""Discovers all executable test scripts across Katalon, Playwright, or Pytest suites."""
|
|
33
|
+
target_path = Path(target_dir)
|
|
34
|
+
test_files = []
|
|
35
|
+
valid_exts = {".groovy", ".ts", ".js", ".py"}
|
|
36
|
+
|
|
37
|
+
for root, _, files in os.walk(target_path):
|
|
38
|
+
for f in files:
|
|
39
|
+
# Match standard test naming patterns
|
|
40
|
+
lower = f.lower()
|
|
41
|
+
if any(lower.endswith(ext) for ext in valid_exts):
|
|
42
|
+
if "test" in lower or "spec" in lower or "tc_" in lower or "scripts" in root.lower():
|
|
43
|
+
rel_p = os.path.relpath(os.path.join(root, f), target_dir).replace("\\", "/")
|
|
44
|
+
test_files.append(rel_p)
|
|
45
|
+
|
|
46
|
+
return sorted(test_files)
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def estimate_test_duration(file_path: str, full_path: str) -> float:
|
|
50
|
+
"""Estimates test execution duration in seconds using historical cache or file heuristic."""
|
|
51
|
+
# Check SQLite historical runtime cache if available
|
|
52
|
+
if os.path.exists(CACHE_DB_PATH):
|
|
53
|
+
try:
|
|
54
|
+
conn = sqlite3.connect(CACHE_DB_PATH)
|
|
55
|
+
try:
|
|
56
|
+
cur = conn.cursor()
|
|
57
|
+
cur.execute("CREATE TABLE IF NOT EXISTS test_runtimes (test_path TEXT PRIMARY KEY, duration REAL)")
|
|
58
|
+
cur.execute("SELECT duration FROM test_runtimes WHERE test_path = ?", (file_path,))
|
|
59
|
+
row = cur.fetchone()
|
|
60
|
+
if row and row[0]:
|
|
61
|
+
return float(row[0])
|
|
62
|
+
finally:
|
|
63
|
+
conn.close()
|
|
64
|
+
except sqlite3.Error:
|
|
65
|
+
conn = None
|
|
66
|
+
|
|
67
|
+
# Heuristic fallback: ~0.5s per line of script
|
|
68
|
+
try:
|
|
69
|
+
if os.path.exists(full_path):
|
|
70
|
+
with open(full_path, "r", encoding="utf-8", errors="ignore") as fp:
|
|
71
|
+
lines = len(fp.readlines())
|
|
72
|
+
return max(5.0, round(lines * 0.25, 1))
|
|
73
|
+
except (OSError, UnicodeDecodeError):
|
|
74
|
+
lines = 0
|
|
75
|
+
|
|
76
|
+
return 10.0
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
def shard_tests_lpt(test_files: List[str], target_dir: str, num_shards: int) -> List[Dict[str, Any]]:
|
|
80
|
+
"""
|
|
81
|
+
Applies Longest Processing Time First (LPT) bin-packing to distribute tests evenly.
|
|
82
|
+
"""
|
|
83
|
+
num_shards = max(1, num_shards)
|
|
84
|
+
if not test_files:
|
|
85
|
+
return [{"shard_index": i + 1, "total_duration": 0.0, "tests": []} for i in range(num_shards)]
|
|
86
|
+
|
|
87
|
+
# 1. Calculate duration for each test
|
|
88
|
+
tests_with_cost = []
|
|
89
|
+
for tf in test_files:
|
|
90
|
+
fp = os.path.join(target_dir, tf)
|
|
91
|
+
dur = estimate_test_duration(tf, fp)
|
|
92
|
+
tests_with_cost.append((tf, dur))
|
|
93
|
+
|
|
94
|
+
# 2. Sort descending by duration
|
|
95
|
+
tests_with_cost.sort(key=lambda x: x[1], reverse=True)
|
|
96
|
+
|
|
97
|
+
# 3. Initialize shards
|
|
98
|
+
shards: List[Dict[str, Any]] = [{"shard_index": i + 1, "total_duration": 0.0, "tests": []} for i in range(num_shards)]
|
|
99
|
+
|
|
100
|
+
# 4. Greedily assign to the shard with the least current cumulative duration
|
|
101
|
+
for test_file, dur in tests_with_cost:
|
|
102
|
+
# Find shard with min duration
|
|
103
|
+
min_shard = min(shards, key=lambda s: float(s["total_duration"]))
|
|
104
|
+
min_shard["tests"].append(test_file)
|
|
105
|
+
min_shard["total_duration"] = round(float(min_shard["total_duration"]) + dur, 2)
|
|
106
|
+
|
|
107
|
+
return shards
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
def main():
|
|
111
|
+
parser = argparse.ArgumentParser(description="Duration-Balanced Test Matrix Sharder")
|
|
112
|
+
parser.add_argument("target", nargs="?", default=os.getcwd(), help="Target repository root")
|
|
113
|
+
parser.add_argument("--shards", "-n", type=int, default=4, help="Number of parallel shards/workers (default: 4)")
|
|
114
|
+
parser.add_argument("--json", action="store_true", help="Output matrix in JSON format")
|
|
115
|
+
args = parser.parse_args()
|
|
116
|
+
|
|
117
|
+
target_dir = os.path.abspath(args.target)
|
|
118
|
+
test_files = find_test_files(target_dir)
|
|
119
|
+
shards = shard_tests_lpt(test_files, target_dir, args.shards)
|
|
120
|
+
|
|
121
|
+
if args.json:
|
|
122
|
+
print(json.dumps({"total_tests": len(test_files), "shards_count": args.shards, "shards": shards}, indent=2))
|
|
123
|
+
else:
|
|
124
|
+
print("\n======================================================================")
|
|
125
|
+
print(f" DURATION-BALANCED TEST MATRIX SHARDER ({args.shards} PARALLEL WORKERS) ")
|
|
126
|
+
print("======================================================================")
|
|
127
|
+
print(f" Target Scope : {target_dir}")
|
|
128
|
+
print(f" Total Tests : {len(test_files)} files\n")
|
|
129
|
+
|
|
130
|
+
for s in shards:
|
|
131
|
+
print(f"📦 Shard {s['shard_index']}: {len(s['tests'])} tests (~{s['total_duration']}s total)")
|
|
132
|
+
for t in s['tests'][:5]:
|
|
133
|
+
print(f" • {t}")
|
|
134
|
+
if len(s['tests']) > 5:
|
|
135
|
+
print(f" ... and {len(s['tests']) - 5} more")
|
|
136
|
+
print()
|
|
137
|
+
|
|
138
|
+
# Calculate imbalance delta
|
|
139
|
+
durations = [s["total_duration"] for s in shards]
|
|
140
|
+
delta = max(durations) - min(durations) if durations else 0
|
|
141
|
+
print(f"⚡ Shard Imbalance Delta: {delta:.1f}s (Optimal parallel distribution)")
|
|
142
|
+
print("======================================================================\n")
|
|
143
|
+
|
|
144
|
+
return 0
|
|
145
|
+
|
|
146
|
+
|
|
147
|
+
if __name__ == "__main__":
|
|
148
|
+
sys.exit(main())
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Synapse Hub — Model Context Protocol (MCP) Servers (tools.mcp)
|
|
3
|
+
--------------------------------------------------------------
|
|
4
|
+
Domain package grouping all standard MCP services: core QA automation
|
|
5
|
+
MCP server and offline Excel spreadsheet manipulation server.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
from tools import (
|
|
9
|
+
mcp_docx_server,
|
|
10
|
+
mcp_excel_server,
|
|
11
|
+
mcp_server,
|
|
12
|
+
)
|
|
13
|
+
|
|
14
|
+
__all__ = [
|
|
15
|
+
"mcp_docx_server",
|
|
16
|
+
"mcp_excel_server",
|
|
17
|
+
"mcp_server",
|
|
18
|
+
]
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Enterprise MCP Docx Server Wrapper
|
|
2
|
+
$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
|
|
3
|
+
$pythonCmd = Get-Command python -ErrorAction SilentlyContinue
|
|
4
|
+
if (-not $pythonCmd) { $pythonCmd = Get-Command py -ErrorAction SilentlyContinue }
|
|
5
|
+
if (-not $pythonCmd) { $pythonCmd = Get-Command python3 -ErrorAction SilentlyContinue }
|
|
6
|
+
|
|
7
|
+
if ($pythonCmd) {
|
|
8
|
+
& $pythonCmd.Source "$scriptDir\mcp_docx_server.py" $args
|
|
9
|
+
exit $LASTEXITCODE
|
|
10
|
+
} else {
|
|
11
|
+
Write-Error "Python 3 is required to run mcp_docx_server.py."
|
|
12
|
+
exit 1
|
|
13
|
+
}
|