@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
package/README.en.md
ADDED
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
# 🧠 Synapse Hub — AI Test Quality Linter & Guardrails
|
|
2
|
+
|
|
3
|
+
### *The Test Quality Linter & Guardrails for the Era of AI-Generated Code*
|
|
4
|
+
|
|
5
|
+
[🇻🇳 Tiếng Việt](README.md) | [🇬🇧 English Edition](README.en.md)
|
|
6
|
+
|
|
7
|
+
> **Core Mission:** A standalone linter and guardrail engine (zero external dependencies for core engine & DoD gates) safeguarding automated test suites when AI writes code — Automatically catching "fake-pass" tests (0 assertions, tautologies), eliminating fixed sleeps, compressing 95% of CI/CD log noise, and enforcing Clean POM architecture.
|
|
8
|
+
> **Author:** Thế Vị ([@TeeVee998](https://github.com/TeeVee998)) | **License:** MIT License
|
|
9
|
+
> **Version:** `v3.8.2` | **Scale:** 53 Standardized QA Skills, 9 Specialized AI Agents, 11 DoD Quality Gates.
|
|
10
|
+
|
|
11
|
+
[](https://www.npmjs.com/package/synapse-hub)
|
|
12
|
+
[](https://nodejs.org)
|
|
13
|
+
[](https://python.org)
|
|
14
|
+
[](docs/QUALITY_GATES.en.md)
|
|
15
|
+
[](#)
|
|
16
|
+
[](https://github.com/TeeVee998/Synapse-Hub/blob/main/LICENSE)
|
|
17
|
+
[](#)
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## 💡 What Problem Does Synapse Hub Solve?
|
|
22
|
+
|
|
23
|
+
When software engineers and QA teams use AI coding assistants (Cursor, Copilot, Claude Code, Antigravity) to write automated tests, AI often produces fragile code patterns:
|
|
24
|
+
|
|
25
|
+
| When AI Writes Tests Without Guardrails | When Protected by Synapse Hub 🛡️ |
|
|
26
|
+
| :--- | :--- |
|
|
27
|
+
| ❌ **"Fake-Pass" Tests:** Green checkmark, but contains **0 assertions** — verifies nothing. | ✅ **Detected in 0.1s:** Flags empty tests and requires concrete assertions. |
|
|
28
|
+
| ❌ **Hardcoded Sleeps:** Spams `sleep(5000)` indiscriminately, causing flaky CI builds. | ✅ **Smart Waits Enforced:** Flags hardcoded delays and guides dynamic wait adoption. |
|
|
29
|
+
| ❌ **AI Context Overflow:** 20,000-line CI logs overwhelm LLM context windows. | ✅ **95% Log Noise Distilled:** Isolates exact failing stacktraces in ~30 lines. |
|
|
30
|
+
| ❌ **Security Leaks:** Accidental commits containing plaintext tokens or passwords. | ✅ **Gate 6 Sentinel:** Detects and blocks hardcoded secrets before commit. |
|
|
31
|
+
|
|
32
|
+
```mermaid
|
|
33
|
+
flowchart LR
|
|
34
|
+
subgraph Inputs["1. Initial Test Generation"]
|
|
35
|
+
AI["👨💻 <b>Developers / QA using AI</b><br/><i>(Cursor, Claude Code, Antigravity, Copilot)</i>"]
|
|
36
|
+
-->|Generates unverified tests| Raw["📄 <b>Raw Automated Test Scripts</b><br/><i>(Playwright, Pytest, Cypress, Katalon)</i>"]
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
subgraph Hub["🛡️ Synapse Hub — AST Linter & 11 DoD Quality Gates"]
|
|
40
|
+
direction LR
|
|
41
|
+
Linter["🔍 <b>Static AST Sentinel</b><br/>• Catches 0-assert fake passes<br/>• Eliminates flaky static sleeps<br/>• Blocks swallowed exceptions"]
|
|
42
|
+
--> CleanPOM["🏛️ <b>Clean POM Guard</b><br/>• Forbids raw XPath/CSS in scripts<br/>• 100% encapsulated in BasePage<br/>• Enforces Flat Architecture"]
|
|
43
|
+
--> Mutator["🧬 <b>Micro-Mutation</b><br/>• Injects syntactic logic faults<br/>• Enforces Kill Score >= 80%<br/>• Eliminates weak assertions"]
|
|
44
|
+
--> Security["🔒 <b>Security & License</b><br/>• Blocks plaintext secrets/tokens<br/>• Prevents credential leakage<br/>• Preserves MIT @TeeVee998"]
|
|
45
|
+
end
|
|
46
|
+
|
|
47
|
+
subgraph Outputs["3. Verified Deliverables"]
|
|
48
|
+
direction TB
|
|
49
|
+
Pass["✅ <b>Production-Ready Test Suite</b><br/><i>(Approved for PR Merge & Green CI/CD)</i>"]
|
|
50
|
+
Distill["⚡ <b>95% Log Noise Distillation</b><br/><i>(distill_log: pinpoints root cause in ~30 lines)</i>"]
|
|
51
|
+
Reject["❌ <b>Hard Block Unreliable Tests</b><br/><i>(Triggers autonomous Reflexion K=3 self-healing)</i>"]
|
|
52
|
+
end
|
|
53
|
+
|
|
54
|
+
Raw ==>|Ingest for verification| Linter
|
|
55
|
+
Security ==>|Passed 11/11 DoD Gates| Pass
|
|
56
|
+
Security -.->|On CI Test Failure| Distill
|
|
57
|
+
Security -.->|Quality Violation| Reject
|
|
58
|
+
|
|
59
|
+
classDef passClass fill:#1b4725,stroke:#2ea043,stroke-width:2px;
|
|
60
|
+
classDef rejectClass fill:#4c1d1d,stroke:#da3633,stroke-width:2px;
|
|
61
|
+
classDef distillClass fill:#3b2d12,stroke:#d29922,stroke-width:2px;
|
|
62
|
+
class Pass passClass;
|
|
63
|
+
class Reject rejectClass;
|
|
64
|
+
class Distill distillClass;
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## ⚡ Quickstart in 60 Seconds (One-Command Onboarding 🚀)
|
|
70
|
+
|
|
71
|
+
You **never need to memorize** 53 skills or 90 internal tools. Synapse Hub activates autonomously when needed:
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# 1. Diagnose system prerequisites (Node, Python, Chrome, Git):
|
|
76
|
+
npx synapse-hub doctor
|
|
77
|
+
|
|
78
|
+
# 2. Activate protection for your test project (Playwright, Pytest, Cypress, Katalon):
|
|
79
|
+
npx synapse-hub setup --target /path/to/test-repo
|
|
80
|
+
|
|
81
|
+
# 3. Scan for fake-passes and hardcoded sleeps instantly:
|
|
82
|
+
npx synapse-hub lint ./tests
|
|
83
|
+
|
|
84
|
+
# 4. Verify the 11 DoD Quality Gates before pushing code:
|
|
85
|
+
npx synapse-hub verify
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
> 💡 **Tip:** Install globally to invoke `synapse-hub <command>` directly without `npx`:
|
|
89
|
+
> `npm install -g synapse-hub` (or via Python: `pip install agent-qa`)
|
|
90
|
+
|
|
91
|
+
> 📦 **Enterprise Reference Test Suites:** Inspect working sample projects adhering to Clean POM & Guardrails in [`examples/`](examples/):
|
|
92
|
+
> [🎭 Playwright TS](examples/playwright-crm-suite) • [🌲 Cypress E2E](examples/cypress-ecommerce-suite) • [🐍 Pytest API](examples/pytest-api-suite) • [☕ Katalon Studio](examples/katalon-suite) • [🌐 Selenium Java](examples/selenium-suite)
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 🛠️ Daily Core CLI Commands
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
# Catch fake-passes, hard sleeps, and swallowed exceptions (Polyglot TS/JS, Python, Groovy):
|
|
100
|
+
synapse-hub lint ./tests
|
|
101
|
+
|
|
102
|
+
# Run the comprehensive 11 Quality Gates Definition of Done (DoD) suite:
|
|
103
|
+
synapse-hub verify
|
|
104
|
+
|
|
105
|
+
# Generate an actionable executive project health report (PROJECT_HEALTH_REPORT.md):
|
|
106
|
+
synapse-hub analyze
|
|
107
|
+
|
|
108
|
+
# Distill 95% of CI log noise down to the true root cause and stacktrace:
|
|
109
|
+
synapse-hub distill path/to/ci.log
|
|
110
|
+
|
|
111
|
+
# Export User Stories into standard 12-column Excel sheets with P x I risk matrices:
|
|
112
|
+
synapse-hub export-excel
|
|
113
|
+
|
|
114
|
+
# Measure test assertion sensitivity via micro-mutation testing (~0.1s):
|
|
115
|
+
synapse-hub mutate ./tests
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## 🛡️ The 11 Definition-of-Done (DoD) Quality Gates
|
|
121
|
+
|
|
122
|
+
Every test code change must satisfy all 11 Quality Gates before pull request merge:
|
|
123
|
+
|
|
124
|
+
- **Gate 0:** Author Attribution & MIT License Provenance
|
|
125
|
+
- **Gate 1:** UTF-8 No BOM Clean Encoding (Zero corrupting BOM bytes)
|
|
126
|
+
- **Gate 2:** Path Portability (Zero hardcoded machine-specific absolute paths)
|
|
127
|
+
- **Gate 3:** Clean POM Flat Architecture (Zero locators inside test scripts)
|
|
128
|
+
- **Gate 4:** AI Docs Anti-Drift (Zero hallucinated PageClasses in AI guides)
|
|
129
|
+
- **Gate 5:** Temporary File Blacklist (Zero scratch files or binary dumps)
|
|
130
|
+
- **Gate 6:** Credential Security Sentinel (Zero plaintext secrets or API keys)
|
|
131
|
+
- **Gate 7:** Static Defect & Fake-Pass Sentinel (Zero 0-assert tests, zero sleeps)
|
|
132
|
+
- **Gate 8:** Assertion Sensitivity Sentinel (Syntactic Mutation Score $\ge 80\%$)
|
|
133
|
+
- **Gate 9:** Skill Routing & Collision Guard (Trigger similarity $< 0.75$)
|
|
134
|
+
- **Gate 10:** Performance & SLA Sentinel (P95 $\le$ 500ms, Error Rate $\le$ 1.0%)
|
|
135
|
+
|
|
136
|
+
*(For detailed gate specifications and remediation guides, see [docs/QUALITY_GATES.en.md](docs/QUALITY_GATES.en.md)).*
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 🔄 CI/CD & Pre-commit Integration
|
|
141
|
+
|
|
142
|
+
```yaml
|
|
143
|
+
# GitHub Actions (.github/workflows/verify.yml):
|
|
144
|
+
- name: Run Synapse Hub Quality Gates
|
|
145
|
+
uses: TeeVee998/Synapse-Hub@v2
|
|
146
|
+
with:
|
|
147
|
+
mode: 'target'
|
|
148
|
+
|
|
149
|
+
# Or run directly on any CI provider (GitLab CI, Bitbucket, Jenkins):
|
|
150
|
+
- name: Run Synapse Hub Quality Gates
|
|
151
|
+
run: npx synapse-hub verify
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
```yaml
|
|
155
|
+
# Pre-commit hook (.pre-commit-config.yaml):
|
|
156
|
+
repos:
|
|
157
|
+
- repo: https://github.com/TeeVee998/Synapse-Hub
|
|
158
|
+
rev: v3.8.2
|
|
159
|
+
hooks:
|
|
160
|
+
- id: synapse-lint
|
|
161
|
+
- id: synapse-verify
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## 📚 Deep Technical Documentation
|
|
167
|
+
|
|
168
|
+
- 🏛️ **Architecture & Industry Comparison Matrix:** [docs/ARCHITECTURE.en.md](docs/ARCHITECTURE.en.md)
|
|
169
|
+
- 🛡️ **11 Quality Gates Definition of Done (DoD):** [docs/QUALITY_GATES.en.md](docs/QUALITY_GATES.en.md)
|
|
170
|
+
- 📖 **Comprehensive CLI Command Reference:** [docs/CLI_REFERENCE.en.md](docs/CLI_REFERENCE.en.md)
|
|
171
|
+
- 🚀 **CI/CD Pipeline Integration Playbook:** [docs/CI_CD_INTEGRATION.en.md](docs/CI_CD_INTEGRATION.en.md)
|
|
172
|
+
- 🤝 **Open-Source Contributing Guidelines:** [docs/CONTRIBUTING.en.md](docs/CONTRIBUTING.en.md)
|
package/README.md
CHANGED
|
@@ -1,3 +1,172 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 🧠 Synapse Hub — AI Test Quality Linter & Guardrails
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
### *Bộ Linter & Chốt Chặn Chất Lượng Test Dành Cho Thời Đại AI Viết Code*
|
|
4
|
+
|
|
5
|
+
[🇻🇳 Tiếng Việt](README.md) | [🇬🇧 English Edition](README.en.md)
|
|
6
|
+
|
|
7
|
+
> **Định vị cốt lõi:** Bộ Linter & Guardrails độc lập (zero external dependencies cho core engine & DoD gates) bảo vệ độ tin cậy của test suite khi AI viết code — Tự động bắt test "pass ảo" (0 assert, tautology), loại bỏ hoàn toàn sleep cố định, nén 95% log CI/CD, và chuẩn hóa cấu trúc Clean POM.
|
|
8
|
+
> **Tác giả:** Thế Vị ([@TeeVee998](https://github.com/TeeVee998)) | **Giấy phép:** MIT License
|
|
9
|
+
> **Phiên bản:** `v3.8.2` | **Quy mô:** 53 Kỹ năng QA, 9 Vai trò AI Agent, 11 Cổng kiểm định DoD.
|
|
10
|
+
|
|
11
|
+
[](https://www.npmjs.com/package/synapse-hub)
|
|
12
|
+
[](https://nodejs.org)
|
|
13
|
+
[](https://python.org)
|
|
14
|
+
[](docs/QUALITY_GATES.md)
|
|
15
|
+
[](#)
|
|
16
|
+
[](https://github.com/TeeVee998/Synapse-Hub/blob/main/LICENSE)
|
|
17
|
+
[](#)
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## 💡 Synapse Hub Giải Quyết Vấn Đề Gì?
|
|
22
|
+
|
|
23
|
+
Khi lập trình viên và QA dùng AI (Cursor, Copilot, Claude Code, Antigravity) để viết test tự động, AI thường sinh ra mã kiểm thử có vấn đề:
|
|
24
|
+
|
|
25
|
+
| Khi để AI tự viết test (Chưa có Synapse) | Khi có Synapse Hub gác cổng 🛡️ |
|
|
26
|
+
| :--- | :--- |
|
|
27
|
+
| ❌ **Test "pass ảo":** Chạy xanh nhưng có **0 câu lệnh assert**, không kiểm tra gì cả. | ✅ **Phát hiện trong 0.1s:** Báo lỗi test rỗng, bắt buộc assertion có ý nghĩa. |
|
|
28
|
+
| ❌ **Dùng sleep cứng:** Chèn `sleep(5000)` bừa bãi làm test chậm và flaky trên CI. | ✅ **Ép dùng Smart Wait:** Tự động phát hiện và hướng dẫn thay thế smart wait. |
|
|
29
|
+
| ❌ **Tràn context AI:** Log CI dài 20.000 dòng làm AI quá tải, tốn token vô ích. | ✅ **Nén sạch 95% log:** Cô đọng còn ~30 dòng stacktrace nguyên nhân gốc. |
|
|
30
|
+
| ❌ **Thủng bảo mật:** AI vô tình commit mật khẩu hoặc API token dạng plaintext. | ✅ **Chốt chặn Gate 6:** Quét và chặn đứng chuỗi nhạy cảm trước khi commit. |
|
|
31
|
+
|
|
32
|
+
```mermaid
|
|
33
|
+
flowchart LR
|
|
34
|
+
subgraph Inputs["1. Mã Kiểm Thử Ban Đầu"]
|
|
35
|
+
AI["👨💻 <b>Lập trình viên / QA dùng AI</b><br/><i>(Cursor, Claude Code, Antigravity, Copilot)</i>"]
|
|
36
|
+
-->|Sinh mã thô| Raw["📄 <b>Mã test tự động chưa kiểm định</b><br/><i>(Playwright, Pytest, Cypress, Katalon)</i>"]
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
subgraph Hub["🛡️ Synapse Hub — Bộ Linter & 11 Cổng Chất Lượng DoD"]
|
|
40
|
+
direction LR
|
|
41
|
+
Linter["🔍 <b>Cú Pháp Tĩnh AST</b><br/>• Bắt test 0-assert & pass ảo<br/>• Loại bỏ hoàn toàn sleep cố định<br/>• Ngăn nuốt ngoại lệ try-catch"]
|
|
42
|
+
--> CleanPOM["🏛️ <b>Chuẩn Clean POM</b><br/>• Cấm raw XPath/CSS trong script<br/>• Đóng gói 100% vào BasePage<br/>• Chuẩn hóa Flat Architecture"]
|
|
43
|
+
--> Mutator["🧬 <b>Micro-Mutation</b><br/>• Bơm đột biến vào câu assert<br/>• Bắt buộc Kill Score >= 80%<br/>• Diệt sạch test assertion yếu"]
|
|
44
|
+
--> Security["🔒 <b>Bảo Mật & Bản Quyền</b><br/>• Quét sạch token/mật khẩu<br/>• Chặn leak biến môi trường<br/>• Giữ bản quyền Thế Vị @TeeVee998"]
|
|
45
|
+
end
|
|
46
|
+
|
|
47
|
+
subgraph Outputs["3. Đầu Ra Đã Kiểm Định"]
|
|
48
|
+
direction TB
|
|
49
|
+
Pass["✅ <b>Test Suite Chuẩn Doanh Nghiệp</b><br/><i>(Đủ điều kiện Merge PR / Xanh CI/CD)</i>"]
|
|
50
|
+
Distill["⚡ <b>Cô Đọng 95% Log Lỗi (distill_log)</b><br/><i>(Chỉ giữ ~30 dòng stacktrace gốc)</i>"]
|
|
51
|
+
Reject["❌ <b>Hard Block Test Rác</b><br/><i>(Chặn đứng lỗi, tự sửa Reflexion K=3)</i>"]
|
|
52
|
+
end
|
|
53
|
+
|
|
54
|
+
Raw ==>|Nạp vào kiểm định| Linter
|
|
55
|
+
Security ==>|Đạt 11/11 Cổng DoD| Pass
|
|
56
|
+
Security -.->|Phát hiện lỗi CI| Distill
|
|
57
|
+
Security -.->|Vi phạm chất lượng| Reject
|
|
58
|
+
|
|
59
|
+
classDef passClass fill:#1b4725,stroke:#2ea043,stroke-width:2px;
|
|
60
|
+
classDef rejectClass fill:#4c1d1d,stroke:#da3633,stroke-width:2px;
|
|
61
|
+
classDef distillClass fill:#3b2d12,stroke:#d29922,stroke-width:2px;
|
|
62
|
+
class Pass passClass;
|
|
63
|
+
class Reject rejectClass;
|
|
64
|
+
class Distill distillClass;
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## ⚡ Bắt Đầu Nhanh Trong 60 Giây (1 Lệnh Khởi Chạy 🚀)
|
|
70
|
+
|
|
71
|
+
Bạn **không cần học hay ghi nhớ** 53 kỹ năng hay các công cụ bên trong. Synapse Hub hoạt động tự động khi cần:
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# 1. Chẩn đoán môi trường hệ thống (Node, Python, Chrome, Git):
|
|
76
|
+
npx synapse-hub doctor
|
|
77
|
+
|
|
78
|
+
# 2. Kích hoạt bảo vệ dự án kiểm thử của bạn (Playwright, Pytest, Cypress, Katalon):
|
|
79
|
+
npx synapse-hub setup --target /duong-dan/toi/du-an-test
|
|
80
|
+
|
|
81
|
+
# 3. Quét lỗi test pass ảo & sleep cứng ngay lập tức:
|
|
82
|
+
npx synapse-hub lint ./tests
|
|
83
|
+
|
|
84
|
+
# 4. Kiểm định 11 Cổng Chất Lượng DoD trước khi đẩy code:
|
|
85
|
+
npx synapse-hub verify
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
> 💡 **Mẹo:** Cài đặt toàn cục để gõ trực tiếp `synapse-hub <lệnh>` không cần tiền tố `npx`:
|
|
89
|
+
> `npm install -g synapse-hub` (hoặc qua Python: `pip install agent-qa`)
|
|
90
|
+
|
|
91
|
+
> 📦 **Kho Dự Án Mẫu Doanh Nghiệp (Reference Suites):** Xem các dự án mẫu đã chuẩn hóa Clean POM & Guardrails tại [`examples/`](examples/):
|
|
92
|
+
> [🎭 Playwright TS](examples/playwright-crm-suite) • [🌲 Cypress E2E](examples/cypress-ecommerce-suite) • [🐍 Pytest API](examples/pytest-api-suite) • [☕ Katalon Studio](examples/katalon-suite) • [🌐 Selenium Java](examples/selenium-suite)
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 🛠️ Các Lệnh CLI Cốt Lõi Hàng Ngày
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
# Bắt test pass ảo, sleep cố định, try-catch nuốt lỗi (đa ngôn ngữ TS/JS, Python, Groovy):
|
|
100
|
+
synapse-hub lint ./tests
|
|
101
|
+
|
|
102
|
+
# Chạy toàn diện 11 Cổng Kiểm Định DoD (Definition of Done):
|
|
103
|
+
synapse-hub verify
|
|
104
|
+
|
|
105
|
+
# Chẩn đoán và xuất báo cáo sức khỏe dự án (PROJECT_HEALTH_REPORT.md):
|
|
106
|
+
synapse-hub analyze
|
|
107
|
+
|
|
108
|
+
# Nén 95% log CI thừa — lọc đúng nguyên nhân gốc rễ và stacktrace:
|
|
109
|
+
synapse-hub distill path/to/ci.log
|
|
110
|
+
|
|
111
|
+
# Xuất User Story thành file Excel chuẩn 12 cột kèm ma trận rủi ro:
|
|
112
|
+
synapse-hub export-excel
|
|
113
|
+
|
|
114
|
+
# Đo độ nhạy của các câu lệnh assert (Micro-Mutation testing ~0.1s):
|
|
115
|
+
synapse-hub mutate ./tests
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## 🛡️ 11 Cổng Kiểm Định Chất Lượng (DoD Gates)
|
|
121
|
+
|
|
122
|
+
Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 11 Cổng Chất Lượng trước khi merge PR:
|
|
123
|
+
|
|
124
|
+
- **Gate 0:** Bảo Toàn Tác Quyền & MIT License Provenance
|
|
125
|
+
- **Gate 1:** Mã Hóa Chuẩn 100% UTF-8 No BOM (Zero byte rác)
|
|
126
|
+
- **Gate 2:** Đường Dẫn Linh Hoạt (Zero hardcoded absolute paths)
|
|
127
|
+
- **Gate 3:** Kiến Trúc Clean POM (Flat Architecture) (Zero locator trong test script)
|
|
128
|
+
- **Gate 4:** Chống Lệch Tài Liệu AI (Zero hallucinated PageClasses)
|
|
129
|
+
- **Gate 5:** Danh Sách Đen File Tạm (Zero `.tmp`, heap dump làm bẩn git)
|
|
130
|
+
- **Gate 6:** Bảo Vệ Bí Mật & Mật Khẩu (Zero hardcoded credentials)
|
|
131
|
+
- **Gate 7:** Quét Lỗi Tĩnh & Bắt Test Pass Ảo (Zero 0-assert, zero sleep)
|
|
132
|
+
- **Gate 8:** Đo Độ Nhạy Assert Micro-Mutation (Mutation Score $\ge 80\%$)
|
|
133
|
+
- **Gate 9:** Điều Phối Kỹ Năng & Ngăn Xung Đột (Similarity $< 0.75$)
|
|
134
|
+
- **Gate 10:** Kiểm Soát Hiệu Năng & SLA Sentinel (P95 $\le$ 500ms, Error Rate $\le$ 1.0%)
|
|
135
|
+
|
|
136
|
+
*(Xem chi tiết tiêu chuẩn, mã lỗi và cách khắc phục tại [docs/QUALITY_GATES.md](docs/QUALITY_GATES.md)).*
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 🔄 Tích Hợp CI/CD & Pre-commit Hook
|
|
141
|
+
|
|
142
|
+
```yaml
|
|
143
|
+
# GitHub Actions (.github/workflows/verify.yml):
|
|
144
|
+
- name: Run Synapse Hub Quality Gates
|
|
145
|
+
uses: TeeVee998/Synapse-Hub@v2
|
|
146
|
+
with:
|
|
147
|
+
mode: 'target'
|
|
148
|
+
|
|
149
|
+
# Hoặc chạy trực tiếp trên bất kỳ CI nào (GitLab, Bitbucket, Jenkins):
|
|
150
|
+
- name: Run Synapse Hub Quality Gates
|
|
151
|
+
run: npx synapse-hub verify
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
```yaml
|
|
155
|
+
# Pre-commit hook (.pre-commit-config.yaml):
|
|
156
|
+
repos:
|
|
157
|
+
- repo: https://github.com/TeeVee998/Synapse-Hub
|
|
158
|
+
rev: v3.8.2
|
|
159
|
+
hooks:
|
|
160
|
+
- id: synapse-lint
|
|
161
|
+
- id: synapse-verify
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## 📚 Tài Liệu Kỹ Thuật Chuyên Sâu
|
|
167
|
+
|
|
168
|
+
- 🏛️ **Kiến Trúc & Bảng So Sánh Chi Tiết:** [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
|
|
169
|
+
- 🛡️ **Đặc Tả 11 Cổng Chất Lượng (DoD):** [docs/QUALITY_GATES.md](docs/QUALITY_GATES.md)
|
|
170
|
+
- 📖 **Cẩm Nang Tra Cứu Lệnh CLI:** [docs/CLI_REFERENCE.md](docs/CLI_REFERENCE.md)
|
|
171
|
+
- 🚀 **Hướng Dẫn Tích Hợp CI/CD:** [docs/CI_CD_INTEGRATION.md](docs/CI_CD_INTEGRATION.md)
|
|
172
|
+
- 🤝 **Hướng Dẫn Đóng Góp:** [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)
|
package/action.yml
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
name: "Synapse Hub Quality Sentinel"
|
|
2
|
+
description: "Zero-dependency enterprise AI QA gatekeeper: verifies 11 DoD Quality Gates, detects fake-passes, and blocks flakiness in CI."
|
|
3
|
+
author: "Thế Vị (@TeeVee998)"
|
|
4
|
+
|
|
5
|
+
inputs:
|
|
6
|
+
mode:
|
|
7
|
+
description: "Verification mode: 'target' (for testing projects) or 'hub' (for skills hub)"
|
|
8
|
+
required: false
|
|
9
|
+
default: "target"
|
|
10
|
+
format:
|
|
11
|
+
description: "Report output format: 'text', 'json', or 'junit'"
|
|
12
|
+
required: false
|
|
13
|
+
default: "text"
|
|
14
|
+
test-cmd:
|
|
15
|
+
description: "Optional test execution command for Gate 8 dynamic mutation testing (e.g. 'pytest' or 'npx playwright test')"
|
|
16
|
+
required: false
|
|
17
|
+
default: ""
|
|
18
|
+
config:
|
|
19
|
+
description: "Path to optional synapse.config.json"
|
|
20
|
+
required: false
|
|
21
|
+
default: ""
|
|
22
|
+
|
|
23
|
+
branding:
|
|
24
|
+
icon: "shield"
|
|
25
|
+
color: "blue"
|
|
26
|
+
|
|
27
|
+
runs:
|
|
28
|
+
using: "composite"
|
|
29
|
+
steps:
|
|
30
|
+
- name: Set up Python
|
|
31
|
+
uses: actions/setup-python@v7
|
|
32
|
+
with:
|
|
33
|
+
python-version: "3.10"
|
|
34
|
+
|
|
35
|
+
- name: Run Synapse Hub Quality Gates
|
|
36
|
+
shell: bash
|
|
37
|
+
env:
|
|
38
|
+
INPUT_MODE: ${{ inputs.mode }}
|
|
39
|
+
INPUT_FORMAT: ${{ inputs.format }}
|
|
40
|
+
INPUT_TEST_CMD: ${{ inputs.test-cmd }}
|
|
41
|
+
INPUT_CONFIG: ${{ inputs.config }}
|
|
42
|
+
ACTION_PATH: ${{ github.action_path }}
|
|
43
|
+
run: |
|
|
44
|
+
ARGS=("--mode" "$INPUT_MODE" "--format" "$INPUT_FORMAT")
|
|
45
|
+
if [ -n "$INPUT_TEST_CMD" ]; then
|
|
46
|
+
ARGS+=("--test-cmd" "$INPUT_TEST_CMD")
|
|
47
|
+
fi
|
|
48
|
+
if [ -n "$INPUT_CONFIG" ]; then
|
|
49
|
+
ARGS+=("--config" "$INPUT_CONFIG")
|
|
50
|
+
fi
|
|
51
|
+
python3 "$ACTION_PATH/tools/verify_all.py" "${ARGS[@]}"
|
package/agentskills.json
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://agentskills.io/schema/v1.json",
|
|
3
|
+
"name": "Synapse-Hub",
|
|
4
|
+
"version": "3.8.2",
|
|
5
|
+
"description": "Enterprise QA & Test Automation AI Skills Ecosystem adhering to Clean POM Flat Architecture.",
|
|
6
|
+
"author": "Thế Vị (@TeeVee998)",
|
|
7
|
+
"repository": "https://github.com/TeeVee998/Synapse-Hub",
|
|
8
|
+
"license": "MIT",
|
|
9
|
+
"skillsRoot": ".agents/skills",
|
|
10
|
+
"standards": [
|
|
11
|
+
"Clean-POM-Flat-Architecture",
|
|
12
|
+
"100%-UTF8-No-BOM",
|
|
13
|
+
"Truth-Anchor-No-Fake-Pass",
|
|
14
|
+
"11-Quality-Gates-DoD"
|
|
15
|
+
]
|
|
16
|
+
}
|
package/bin/agent-qa.js
ADDED
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
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
|
+
* Enterprise Synapse-Hub NPM Launcher
|
|
8
|
+
* ====================================
|
|
9
|
+
* Dispatches CLI subcommands to the underlying Python Standard Library engine (tools/cli.py).
|
|
10
|
+
* Provides cross-platform zero-install execution via `npx synapse-hub <command>`.
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
const { spawn, execFileSync } = require('child_process');
|
|
14
|
+
const path = require('path');
|
|
15
|
+
const fs = require('fs');
|
|
16
|
+
|
|
17
|
+
const REPO_ROOT = path.resolve(__dirname, '..');
|
|
18
|
+
const CLI_PATH = path.join(REPO_ROOT, 'tools', 'cli.py');
|
|
19
|
+
|
|
20
|
+
// ANSI Color Helpers
|
|
21
|
+
const hasNoColor = 'NO_COLOR' in process.env;
|
|
22
|
+
const isDumbTerm = process.env.TERM === 'dumb';
|
|
23
|
+
const forceColor = ['1', 'true', 'TRUE'].includes(process.env.FORCE_COLOR);
|
|
24
|
+
const useColor = (Boolean(process.stdout.isTTY) || forceColor) && !hasNoColor && !isDumbTerm;
|
|
25
|
+
const RED = useColor ? '\x1b[91m' : '';
|
|
26
|
+
const GREEN = useColor ? '\x1b[92m' : '';
|
|
27
|
+
const YELLOW = useColor ? '\x1b[93m' : '';
|
|
28
|
+
const CYAN = useColor ? '\x1b[96m' : '';
|
|
29
|
+
const BOLD = useColor ? '\x1b[1m' : '';
|
|
30
|
+
const RESET = useColor ? '\x1b[0m' : '';
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Resolves the available Python 3 executable across Windows, macOS, and Linux.
|
|
34
|
+
*/
|
|
35
|
+
function resolvePython() {
|
|
36
|
+
const candidates = process.platform === 'win32'
|
|
37
|
+
? ['python', 'py', 'python3']
|
|
38
|
+
: ['python3', 'python'];
|
|
39
|
+
|
|
40
|
+
for (const cmd of candidates) {
|
|
41
|
+
try {
|
|
42
|
+
const output = execFileSync(cmd, ['--version'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
|
|
43
|
+
const match = output.match(/Python\s+(\d+)\.(\d+)/i);
|
|
44
|
+
if (match) {
|
|
45
|
+
const major = parseInt(match[1], 10);
|
|
46
|
+
const minor = parseInt(match[2], 10);
|
|
47
|
+
if (major > 3 || (major === 3 && minor >= 10)) {
|
|
48
|
+
return { command: cmd, version: output };
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
} catch {
|
|
52
|
+
// Continue checking next candidate in path
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
return null;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
const PASSTHROUGH_CMDS = ['sh', 'bash', '/bin/sh', '/bin/bash', 'cat'];
|
|
60
|
+
|
|
61
|
+
function main() {
|
|
62
|
+
const firstArg = process.argv[2];
|
|
63
|
+
if (firstArg && (PASSTHROUGH_CMDS.includes(firstArg) || (path.isAbsolute(firstArg) && fs.existsSync(firstArg)))) {
|
|
64
|
+
const child = spawn(firstArg, process.argv.slice(3), {
|
|
65
|
+
stdio: 'inherit',
|
|
66
|
+
env: process.env
|
|
67
|
+
});
|
|
68
|
+
child.on('error', (err) => {
|
|
69
|
+
console.error(`\n${BOLD}${RED}[ERROR] Failed to execute ${firstArg}:${RESET}`, err.message);
|
|
70
|
+
process.exit(1);
|
|
71
|
+
});
|
|
72
|
+
child.on('exit', (code, signal) => {
|
|
73
|
+
if (signal) {
|
|
74
|
+
process.kill(process.pid, signal);
|
|
75
|
+
} else {
|
|
76
|
+
process.exit(code ?? 0);
|
|
77
|
+
}
|
|
78
|
+
});
|
|
79
|
+
process.on('SIGINT', () => child.kill('SIGINT'));
|
|
80
|
+
process.on('SIGTERM', () => child.kill('SIGTERM'));
|
|
81
|
+
return;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
const python = resolvePython();
|
|
85
|
+
|
|
86
|
+
if (!python) {
|
|
87
|
+
if (process.argv.includes('--first-run')) {
|
|
88
|
+
process.exit(0);
|
|
89
|
+
}
|
|
90
|
+
console.error(`\n${BOLD}${RED}[ERROR] Python 3.10+ is required to execute synapse-hub tools.${RESET}`);
|
|
91
|
+
console.error(`[LỖI] Cần cài đặt Python 3.10+ để thực thi các công cụ Synapse Hub.`);
|
|
92
|
+
console.error(`Neither ${CYAN}python3${RESET} nor ${CYAN}python${RESET} (>= 3.10) was found on your PATH.`);
|
|
93
|
+
console.error(`Không tìm thấy ${CYAN}python3${RESET} hoặc ${CYAN}python${RESET} (>= 3.10) trong biến môi trường PATH.`);
|
|
94
|
+
console.error(`👉 Please install Python from: ${BOLD}https://www.python.org/downloads/${RESET}`);
|
|
95
|
+
console.error(`👉 Tải và cài đặt Python tại: ${BOLD}https://www.python.org/downloads/${RESET}\n`);
|
|
96
|
+
process.exit(1);
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
if (!fs.existsSync(CLI_PATH)) {
|
|
100
|
+
console.error(`\n${BOLD}${RED}[ERROR] Core CLI engine not found at: ${CLI_PATH}${RESET}\n`);
|
|
101
|
+
process.exit(1);
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
let args;
|
|
105
|
+
if (process.argv[2] === '--py') {
|
|
106
|
+
args = process.argv.slice(3);
|
|
107
|
+
} else {
|
|
108
|
+
args = [CLI_PATH, ...process.argv.slice(2)];
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
// Spawn child Python process inheriting standard IO
|
|
112
|
+
const child = spawn(python.command, args, {
|
|
113
|
+
stdio: 'inherit',
|
|
114
|
+
env: { ...process.env, AGENT_QA_INVOKER: 'npm' }
|
|
115
|
+
});
|
|
116
|
+
|
|
117
|
+
child.on('error', (err) => {
|
|
118
|
+
console.error(`\n${BOLD}${RED}[ERROR] Failed to start synapse-hub CLI:${RESET}`, err.message);
|
|
119
|
+
process.exit(1);
|
|
120
|
+
});
|
|
121
|
+
|
|
122
|
+
child.on('exit', (code, signal) => {
|
|
123
|
+
if (signal) {
|
|
124
|
+
process.kill(process.pid, signal);
|
|
125
|
+
} else {
|
|
126
|
+
process.exit(code ?? 0);
|
|
127
|
+
}
|
|
128
|
+
});
|
|
129
|
+
|
|
130
|
+
process.on('SIGINT', () => child.kill('SIGINT'));
|
|
131
|
+
process.on('SIGTERM', () => child.kill('SIGTERM'));
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
if (require.main === module) {
|
|
135
|
+
main();
|
|
136
|
+
} else {
|
|
137
|
+
module.exports = { resolvePython, PASSTHROUGH_CMDS };
|
|
138
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: MIT
|
|
3
|
+
# Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
|
|
4
|
+
|
|
5
|
+
# Enterprise Synapse-Hub Developer Compose Environment
|
|
6
|
+
# Enables running quality gates, linting, and health audits against local target test suites
|
|
7
|
+
# with zero host tool installation.
|
|
8
|
+
|
|
9
|
+
services:
|
|
10
|
+
# 1. Primary Quality Gate: 11 Quality Gates DoD Verification
|
|
11
|
+
# Usage: docker compose run --rm verify
|
|
12
|
+
verify:
|
|
13
|
+
build:
|
|
14
|
+
context: .
|
|
15
|
+
dockerfile: Dockerfile
|
|
16
|
+
image: ghcr.io/teevee998/synapse-hub:latest
|
|
17
|
+
container_name: synapse-qa-verify
|
|
18
|
+
volumes:
|
|
19
|
+
- ./target:/workspace/target
|
|
20
|
+
- ./reports:/workspace/reports
|
|
21
|
+
working_dir: /workspace/target
|
|
22
|
+
command: ["verify"]
|
|
23
|
+
environment:
|
|
24
|
+
- PYTHONUNBUFFERED=1
|
|
25
|
+
- LANG=C.UTF-8
|
|
26
|
+
|
|
27
|
+
# 2. Meta Infer-style AST Defect & Fake-Pass Linter
|
|
28
|
+
# Usage: docker compose run --rm lint
|
|
29
|
+
lint:
|
|
30
|
+
image: ghcr.io/teevee998/synapse-hub:latest
|
|
31
|
+
container_name: synapse-qa-lint
|
|
32
|
+
volumes:
|
|
33
|
+
- ./target:/workspace/target
|
|
34
|
+
working_dir: /workspace/target
|
|
35
|
+
command: ["lint"]
|
|
36
|
+
|
|
37
|
+
# 3. Comprehensive 5-in-1 Repository Health Audit
|
|
38
|
+
# Usage: docker compose run --rm analyze
|
|
39
|
+
analyze:
|
|
40
|
+
image: ghcr.io/teevee998/synapse-hub:latest
|
|
41
|
+
container_name: synapse-qa-analyze
|
|
42
|
+
volumes:
|
|
43
|
+
- ./target:/workspace/target
|
|
44
|
+
- ./reports:/workspace/reports
|
|
45
|
+
working_dir: /workspace/target
|
|
46
|
+
command: ["analyze"]
|
|
47
|
+
|
|
48
|
+
# 4. Syntactic Micro-Mutation Verification (Kill Score >= 80%)
|
|
49
|
+
# Usage: docker compose run --rm mutate
|
|
50
|
+
mutate:
|
|
51
|
+
image: ghcr.io/teevee998/synapse-hub:latest
|
|
52
|
+
container_name: synapse-qa-mutate
|
|
53
|
+
volumes:
|
|
54
|
+
- ./target:/workspace/target
|
|
55
|
+
- ./reports:/workspace/reports
|
|
56
|
+
working_dir: /workspace/target
|
|
57
|
+
command: ["mutate", "--min-score", "80"]
|
|
58
|
+
|
|
59
|
+
# 5. Interactive Developer Shell
|
|
60
|
+
# Usage: docker compose run --rm shell
|
|
61
|
+
shell:
|
|
62
|
+
build:
|
|
63
|
+
context: .
|
|
64
|
+
dockerfile: Dockerfile
|
|
65
|
+
image: ghcr.io/teevee998/synapse-hub:latest
|
|
66
|
+
container_name: synapse-qa-shell
|
|
67
|
+
entrypoint: ["/bin/bash"]
|
|
68
|
+
command: []
|
|
69
|
+
stdin_open: true
|
|
70
|
+
tty: true
|
|
71
|
+
volumes:
|
|
72
|
+
- ./target:/workspace/target
|
|
73
|
+
- ./reports:/workspace/reports
|
|
74
|
+
working_dir: /workspace/target
|