@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,290 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
# Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
|
|
5
|
+
|
|
6
|
+
"""
|
|
7
|
+
tools/welcome_page.py — Interactive Visual Landing Page for Synapse Hub
|
|
8
|
+
-------------------------------------------------------------------------
|
|
9
|
+
Generates and automatically launches a modern, responsive, 100% self-contained
|
|
10
|
+
HTML5 product landing page that introduces Synapse Hub's capabilities across
|
|
11
|
+
Manual, Automation, API, and Performance testing.
|
|
12
|
+
|
|
13
|
+
Features:
|
|
14
|
+
- Default Vietnamese interface with instant 1-click English toggle (bilingual i18n).
|
|
15
|
+
- 100% air-gapped & offline-ready (Zero external CDNs or remote dependencies).
|
|
16
|
+
- Dark glassmorphism interface with responsive layout.
|
|
17
|
+
- Interactive tabs covering the 4 Core Pillars of QA Intelligence.
|
|
18
|
+
- Interactive CLI Cheatsheet with 1-click clipboard copy.
|
|
19
|
+
- Comparison matrix vs existing industry tools (ESLint, Stryker, Allure, Healenium).
|
|
20
|
+
- 9 Subagent Swarm Profiles & 11 Quality Gates DoD showcase.
|
|
21
|
+
- Automatic browser launching on setup, pull, or CLI dispatch.
|
|
22
|
+
"""
|
|
23
|
+
|
|
24
|
+
import os
|
|
25
|
+
import sys
|
|
26
|
+
import json
|
|
27
|
+
import html as html_lib
|
|
28
|
+
import argparse
|
|
29
|
+
import webbrowser
|
|
30
|
+
from datetime import datetime
|
|
31
|
+
from typing import Dict, Any, Optional
|
|
32
|
+
|
|
33
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
34
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
35
|
+
try:
|
|
36
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
37
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
38
|
+
except Exception:
|
|
39
|
+
pass
|
|
40
|
+
|
|
41
|
+
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
|
|
42
|
+
HUB_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
|
|
43
|
+
FIRST_RUN_MARKER_FILENAME = ".welcome_shown"
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
def get_hub_metadata() -> Dict[str, Any]:
|
|
47
|
+
"""Retrieves version and catalog count from skills_manifest.json."""
|
|
48
|
+
manifest_path = os.path.join(HUB_ROOT, "skills_manifest.json")
|
|
49
|
+
meta = {
|
|
50
|
+
"version": "3.8.2",
|
|
51
|
+
"totalSkills": 42,
|
|
52
|
+
"author": "Thế Vị (@TeeVee998)",
|
|
53
|
+
"repo": "https://github.com/TeeVee998/Synapse-Hub"
|
|
54
|
+
}
|
|
55
|
+
if os.path.exists(manifest_path):
|
|
56
|
+
try:
|
|
57
|
+
with open(manifest_path, "r", encoding="utf-8") as f:
|
|
58
|
+
data = json.load(f)
|
|
59
|
+
meta["version"] = data.get("version", meta["version"])
|
|
60
|
+
meta["totalSkills"] = data.get("totalSkills", meta["totalSkills"])
|
|
61
|
+
except (OSError, json.JSONDecodeError):
|
|
62
|
+
return meta
|
|
63
|
+
return meta
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
def is_hub_repo(path_str: Optional[str]) -> bool:
|
|
67
|
+
"""Checks whether the given path corresponds to the Synapse-Hub core repository itself."""
|
|
68
|
+
if not path_str:
|
|
69
|
+
return True
|
|
70
|
+
resolved = os.path.abspath(path_str)
|
|
71
|
+
if resolved.lower() == HUB_ROOT.lower():
|
|
72
|
+
return True
|
|
73
|
+
if os.path.exists(os.path.join(resolved, "skills_manifest.json")) or os.path.isdir(os.path.join(resolved, ".agents", "skills")):
|
|
74
|
+
return True
|
|
75
|
+
return False
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
def generate_welcome_html(target_repo: Optional[str] = None, stack_info: Optional[Dict[str, str]] = None, default_lang: str = "vi") -> str:
|
|
79
|
+
"""Renders the standalone interactive HTML5 landing page with bilingual language switcher."""
|
|
80
|
+
meta = get_hub_metadata()
|
|
81
|
+
now_str = datetime.now().strftime("%Y-%m-%d %H:%M")
|
|
82
|
+
|
|
83
|
+
is_external_target = bool(target_repo and not is_hub_repo(target_repo) and stack_info)
|
|
84
|
+
if is_external_target:
|
|
85
|
+
raw_target_name = (stack_info.get("name") if stack_info else "") or os.path.basename(os.path.abspath(target_repo or ""))
|
|
86
|
+
raw_framework = (stack_info.get("framework") if stack_info else "") or "Automated QA"
|
|
87
|
+
target_name = html_lib.escape(str(raw_target_name))
|
|
88
|
+
framework_name = html_lib.escape(str(raw_framework))
|
|
89
|
+
hero_pill_content = f"""<span data-i18n="hero_pill_tag">🛡️ Trung Tâm Trí Tuệ Chất Lượng AI Doanh Nghiệp</span>
|
|
90
|
+
<span>•</span>
|
|
91
|
+
<span><span data-i18n="hero_target_label">Dự án mục tiêu</span>: <strong>{target_name}</strong> ({framework_name})</span>"""
|
|
92
|
+
else:
|
|
93
|
+
hero_pill_content = """<span data-i18n="hero_pill_tag">🛡️ Trung Tâm Trí Tuệ Chất Lượng AI Doanh Nghiệp</span>
|
|
94
|
+
<span>•</span>
|
|
95
|
+
<span data-i18n="hero_pill_status">Sẵn Sàng 100% Offline</span>"""
|
|
96
|
+
|
|
97
|
+
tmpl_candidates = [
|
|
98
|
+
os.path.join(HUB_ROOT, "templates", "welcome.html.tmpl"),
|
|
99
|
+
os.path.join(SCRIPT_DIR, "..", "templates", "welcome.html.tmpl"),
|
|
100
|
+
os.path.join(SCRIPT_DIR, "templates", "welcome.html.tmpl"),
|
|
101
|
+
]
|
|
102
|
+
template_str = None
|
|
103
|
+
for cand in tmpl_candidates:
|
|
104
|
+
if os.path.exists(cand):
|
|
105
|
+
try:
|
|
106
|
+
with open(cand, "r", encoding="utf-8") as tf:
|
|
107
|
+
template_str = tf.read()
|
|
108
|
+
break
|
|
109
|
+
except OSError:
|
|
110
|
+
continue
|
|
111
|
+
|
|
112
|
+
if not template_str:
|
|
113
|
+
return f"""<!DOCTYPE html>
|
|
114
|
+
<html><head><meta charset="UTF-8"><title>Synapse Hub</title></head>
|
|
115
|
+
<body style="font-family:sans-serif;background:#0f172a;color:#f8fafc;padding:40px;text-align:center;">
|
|
116
|
+
<h1>🛡️ Synapse Hub Enterprise QA v{meta.get('version', '2.4.0')}</h1>
|
|
117
|
+
<p>{hero_pill_content}</p>
|
|
118
|
+
<p>Total Standardized Skills: {meta.get('totalSkills', 42)}</p>
|
|
119
|
+
<p>Author: {meta.get('author', 'Thế Vị (@TeeVee998)')}</p>
|
|
120
|
+
</body></html>"""
|
|
121
|
+
|
|
122
|
+
rendered_html = (
|
|
123
|
+
template_str.replace("__DEFAULT_LANG__", default_lang)
|
|
124
|
+
.replace("__HERO_PILL_CONTENT__", hero_pill_content)
|
|
125
|
+
.replace("__NOW_STR__", now_str)
|
|
126
|
+
.replace("__VERSION__", str(meta.get("version", "2.4.0")))
|
|
127
|
+
.replace("__AUTHOR__", str(meta.get("author", "Thế Vị (@TeeVee998)")))
|
|
128
|
+
.replace("__TOTAL_SKILLS__", str(meta.get("totalSkills", 42)))
|
|
129
|
+
.replace("__REPO__", str(meta.get("repo", "https://github.com/TeeVee998/Synapse-Hub")))
|
|
130
|
+
)
|
|
131
|
+
return rendered_html
|
|
132
|
+
|
|
133
|
+
|
|
134
|
+
def write_welcome_page(output_path: Optional[str] = None, target_repo: Optional[str] = None, stack_info: Optional[Dict[str, str]] = None, default_lang: str = "vi") -> str:
|
|
135
|
+
"""Generates and writes the welcome landing page to disk."""
|
|
136
|
+
if not output_path:
|
|
137
|
+
base_dir = target_repo if target_repo else HUB_ROOT
|
|
138
|
+
reports_dir = os.path.join(base_dir, "reports")
|
|
139
|
+
os.makedirs(reports_dir, exist_ok=True)
|
|
140
|
+
output_path = os.path.join(reports_dir, "WELCOME.html")
|
|
141
|
+
else:
|
|
142
|
+
output_path = os.path.abspath(output_path)
|
|
143
|
+
os.makedirs(os.path.dirname(output_path), exist_ok=True)
|
|
144
|
+
|
|
145
|
+
html_content = generate_welcome_html(target_repo=target_repo, stack_info=stack_info, default_lang=default_lang)
|
|
146
|
+
with open(output_path, "w", encoding="utf-8") as f:
|
|
147
|
+
f.write(html_content)
|
|
148
|
+
|
|
149
|
+
return output_path
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
def get_marker_path(target_repo: Optional[str] = None) -> str:
|
|
153
|
+
"""Returns the path to the .welcome_shown marker file for the given repository."""
|
|
154
|
+
base = target_repo if target_repo else HUB_ROOT
|
|
155
|
+
return os.path.join(base, "reports", FIRST_RUN_MARKER_FILENAME)
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
def is_first_run(target_repo: Optional[str] = None) -> bool:
|
|
159
|
+
"""
|
|
160
|
+
Checks whether this is the first install / first pull for the hub.
|
|
161
|
+
Returns True if the welcome page has not been displayed yet.
|
|
162
|
+
"""
|
|
163
|
+
marker_path = get_marker_path(target_repo)
|
|
164
|
+
if os.path.exists(marker_path):
|
|
165
|
+
return False
|
|
166
|
+
|
|
167
|
+
global_dir = os.path.expanduser("~/.agent_memory")
|
|
168
|
+
global_marker = os.path.join(global_dir, "welcome_shown.json")
|
|
169
|
+
if os.path.exists(global_marker):
|
|
170
|
+
try:
|
|
171
|
+
with open(global_marker, "r", encoding="utf-8") as f:
|
|
172
|
+
data = json.load(f)
|
|
173
|
+
key = os.path.realpath(target_repo or HUB_ROOT)
|
|
174
|
+
if key in data:
|
|
175
|
+
return False
|
|
176
|
+
except (OSError, json.JSONDecodeError):
|
|
177
|
+
return True
|
|
178
|
+
|
|
179
|
+
return True
|
|
180
|
+
|
|
181
|
+
|
|
182
|
+
def mark_first_run_completed(target_repo: Optional[str] = None):
|
|
183
|
+
"""
|
|
184
|
+
Records that the landing page has been shown so it does not open again.
|
|
185
|
+
"""
|
|
186
|
+
marker_path = get_marker_path(target_repo)
|
|
187
|
+
try:
|
|
188
|
+
os.makedirs(os.path.dirname(marker_path), exist_ok=True)
|
|
189
|
+
with open(marker_path, "w", encoding="utf-8") as f:
|
|
190
|
+
json.dump({
|
|
191
|
+
"shown_at": datetime.now().isoformat(),
|
|
192
|
+
"repo": os.path.realpath(target_repo or HUB_ROOT)
|
|
193
|
+
}, f, indent=2)
|
|
194
|
+
except OSError as err:
|
|
195
|
+
sys.stderr.write(f"[WARN] Failed to write local marker: {err}\n")
|
|
196
|
+
|
|
197
|
+
try:
|
|
198
|
+
global_dir = os.path.expanduser("~/.agent_memory")
|
|
199
|
+
os.makedirs(global_dir, exist_ok=True)
|
|
200
|
+
global_marker = os.path.join(global_dir, "welcome_shown.json")
|
|
201
|
+
data = {}
|
|
202
|
+
if os.path.exists(global_marker):
|
|
203
|
+
try:
|
|
204
|
+
with open(global_marker, "r", encoding="utf-8") as f:
|
|
205
|
+
data = json.load(f)
|
|
206
|
+
except (OSError, json.JSONDecodeError):
|
|
207
|
+
data = {}
|
|
208
|
+
key = os.path.realpath(target_repo or HUB_ROOT)
|
|
209
|
+
data[key] = datetime.now().isoformat()
|
|
210
|
+
with open(global_marker, "w", encoding="utf-8") as f:
|
|
211
|
+
json.dump(data, f, indent=2)
|
|
212
|
+
except OSError as err:
|
|
213
|
+
sys.stderr.write(f"[WARN] Failed to write global marker: {err}\n")
|
|
214
|
+
|
|
215
|
+
|
|
216
|
+
def open_welcome_page(file_path: str) -> bool:
|
|
217
|
+
"""
|
|
218
|
+
Opens the welcome page in the user's default browser if not running in headless/CI mode or test runner.
|
|
219
|
+
Returns True if successfully launched, False otherwise.
|
|
220
|
+
"""
|
|
221
|
+
if (
|
|
222
|
+
os.environ.get("CI")
|
|
223
|
+
or os.environ.get("HEADLESS")
|
|
224
|
+
or os.environ.get("AGENT_QA_NO_BROWSER")
|
|
225
|
+
or "unittest" in sys.modules
|
|
226
|
+
or "pytest" in sys.modules
|
|
227
|
+
):
|
|
228
|
+
return False
|
|
229
|
+
|
|
230
|
+
abs_path = os.path.abspath(file_path)
|
|
231
|
+
if not os.path.exists(abs_path):
|
|
232
|
+
return False
|
|
233
|
+
|
|
234
|
+
file_url = f"file://{abs_path}"
|
|
235
|
+
try:
|
|
236
|
+
webbrowser.open(file_url)
|
|
237
|
+
return True
|
|
238
|
+
except Exception:
|
|
239
|
+
return False
|
|
240
|
+
|
|
241
|
+
|
|
242
|
+
def generate_welcome_page(target_repo: Optional[str] = None, output_path: Optional[str] = None, stack_info: Optional[Dict[str, str]] = None, open_browser: bool = True, default_lang: str = "vi") -> str:
|
|
243
|
+
"""
|
|
244
|
+
Full workflow helper: generates the landing page and opens it if requested.
|
|
245
|
+
"""
|
|
246
|
+
out_file = write_welcome_page(output_path=output_path, target_repo=target_repo, stack_info=stack_info, default_lang=default_lang)
|
|
247
|
+
if open_browser:
|
|
248
|
+
opened = open_welcome_page(out_file)
|
|
249
|
+
if opened:
|
|
250
|
+
print(" 🚀 Đã mở Visual Landing Page trong trình duyệt của bạn.")
|
|
251
|
+
return out_file
|
|
252
|
+
|
|
253
|
+
|
|
254
|
+
def main():
|
|
255
|
+
parser = argparse.ArgumentParser(description="Synapse Hub Visual Landing Page Generator (Bilingual VI/EN)")
|
|
256
|
+
parser.add_argument("target", nargs="?", default=None, help="Target repository directory (default: current directory)")
|
|
257
|
+
parser.add_argument("--output", "-o", default=None, help="Output HTML file path (default: reports/WELCOME.html)")
|
|
258
|
+
parser.add_argument("--lang", choices=["vi", "en"], default="vi", help="Default initial language (default: vi = Vietnamese)")
|
|
259
|
+
parser.add_argument("--no-browser", action="store_true", help="Do not open the browser after generating the page")
|
|
260
|
+
parser.add_argument("--open", action="store_true", help="Explicitly open the browser")
|
|
261
|
+
parser.add_argument("--first-run", action="store_true", help="Only generate and open if running for the first time (e.g. npm install or first pull)")
|
|
262
|
+
args = parser.parse_args()
|
|
263
|
+
|
|
264
|
+
target_dir = os.path.abspath(args.target) if args.target else HUB_ROOT
|
|
265
|
+
|
|
266
|
+
# If --first-run requested, check if it was already displayed
|
|
267
|
+
if args.first_run:
|
|
268
|
+
if not is_first_run(target_dir):
|
|
269
|
+
return
|
|
270
|
+
|
|
271
|
+
should_open = not args.no_browser if (not os.environ.get("CI")) else args.open
|
|
272
|
+
if args.first_run and (os.environ.get("CI") or os.environ.get("HEADLESS") or "unittest" in sys.modules or "pytest" in sys.modules):
|
|
273
|
+
should_open = False
|
|
274
|
+
|
|
275
|
+
print(f"🎨 Generating Synapse Hub Visual Landing Page (Language: {args.lang.upper()})...")
|
|
276
|
+
out_path = generate_welcome_page(
|
|
277
|
+
target_repo=target_dir,
|
|
278
|
+
output_path=args.output,
|
|
279
|
+
open_browser=should_open,
|
|
280
|
+
default_lang=args.lang
|
|
281
|
+
)
|
|
282
|
+
if args.first_run or should_open:
|
|
283
|
+
mark_first_run_completed(target_dir)
|
|
284
|
+
|
|
285
|
+
print(f"✅ Landing page generated successfully at:\n file://{out_path}")
|
|
286
|
+
print("👉 You can re-open it anytime with: npx synapse-hub welcome")
|
|
287
|
+
|
|
288
|
+
|
|
289
|
+
if __name__ == "__main__":
|
|
290
|
+
main()
|