@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,127 @@
|
|
|
1
|
+
# 3rd-Party Plugin Development Guide — Synapse Hub
|
|
2
|
+
|
|
3
|
+
> **Specification Version:** 2.2.4
|
|
4
|
+
> **Hub Core Provenance:** Thế Vị (@TeeVee98) — [Synapse Hub](https://github.com/TeeVee98/Synapse-Hub)
|
|
5
|
+
> **Reference Example:** [examples/plugins/sample-custom-plugin](../examples/plugins/sample-custom-plugin)
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. Overview
|
|
10
|
+
|
|
11
|
+
Synapse Hub provides a decoupled, modular architecture enabling 3rd-party teams and community contributors to extend the Hub with specialized QA skills, runner adapters, or domain-specific security linters.
|
|
12
|
+
|
|
13
|
+
Every 3rd-party plugin is an independent package registered via `plugin.json` and vetted by the built-in **SkillSpector Security Sentinel** (`tools/skillspector.py`).
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 2. Plugin Structure & File Conventions
|
|
18
|
+
|
|
19
|
+
A standard Synapse Hub plugin adheres to the following directory layout:
|
|
20
|
+
|
|
21
|
+
```text
|
|
22
|
+
my-custom-plugin/
|
|
23
|
+
├── plugin.json # Mandatory plugin manifest
|
|
24
|
+
├── README.md # Plugin documentation & quickstart
|
|
25
|
+
├── skills/ # Packaged AI skills (one folder per skill)
|
|
26
|
+
│ └── custom-security-audit/
|
|
27
|
+
│ ├── SKILL.md # Standardized YAML frontmatter + prompt
|
|
28
|
+
│ └── examples/
|
|
29
|
+
│ └── audit_sample.json # Demonstrable example fixture
|
|
30
|
+
└── tools/ # Executable CLI tools (Python 3.9+)
|
|
31
|
+
└── custom_auditor.py # Deterministic, standalone tool
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 3. Plugin Manifest Specification (`plugin.json`)
|
|
37
|
+
|
|
38
|
+
The root `plugin.json` declares identity, capabilities, and dependencies:
|
|
39
|
+
|
|
40
|
+
```json
|
|
41
|
+
{
|
|
42
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
43
|
+
"name": "sample-custom-plugin",
|
|
44
|
+
"version": "1.0.0",
|
|
45
|
+
"description": "3rd-party plugin extending Synapse Hub with custom HTTP security header auditing.",
|
|
46
|
+
"author": "Community Contributor",
|
|
47
|
+
"license": "MIT",
|
|
48
|
+
"repository": "https://github.com/example/sample-custom-plugin",
|
|
49
|
+
"skills": [
|
|
50
|
+
"custom-security-headers-audit"
|
|
51
|
+
],
|
|
52
|
+
"tools": [
|
|
53
|
+
"tools/custom_security_headers.py"
|
|
54
|
+
],
|
|
55
|
+
"minHubVersion": "2.2.0"
|
|
56
|
+
}
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### Manifest Fields:
|
|
60
|
+
- `name` *(string, required)*: Unique kebab-case identifier.
|
|
61
|
+
- `version` *(string, required)*: Semantic versioning (`x.y.z`).
|
|
62
|
+
- `description` *(string, required)*: Concise summary of provided capabilities.
|
|
63
|
+
- `skills` *(array of strings)*: List of skill folder names inside `skills/`.
|
|
64
|
+
- `tools` *(array of strings)*: Relative file paths to executable scripts in `tools/`.
|
|
65
|
+
- `minHubVersion` *(string)*: Minimum compatible Synapse Hub core version.
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 4. Skill Authoring Standard (`SKILL.md`)
|
|
70
|
+
|
|
71
|
+
Each skill must contain valid YAML frontmatter followed by clear, token-optimized instructions:
|
|
72
|
+
|
|
73
|
+
```markdown
|
|
74
|
+
---
|
|
75
|
+
name: custom-security-headers-audit
|
|
76
|
+
description: Audits web applications for missing or misconfigured HTTP security headers (CSP, HSTS, X-Frame-Options).
|
|
77
|
+
version: 1.0.0
|
|
78
|
+
category: security_and_compliance
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
# Custom Security Headers Audit Skill
|
|
82
|
+
|
|
83
|
+
## Purpose
|
|
84
|
+
Inspects target endpoint response headers and reports compliance against OWASP ASVS Section 14.
|
|
85
|
+
|
|
86
|
+
## Quick CLI Execution
|
|
87
|
+
```bash
|
|
88
|
+
python tools/custom_security_headers.py https://staging.example.com --json report.json
|
|
89
|
+
```
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Skill Invariants:
|
|
93
|
+
1. **Token Ceiling:** Every `SKILL.md` must be $\le 1.500$ tokens (enforced by `scripts/lint_skills.ps1`).
|
|
94
|
+
2. **100% UTF-8 No BOM:** Zero BOM bytes (`0xEF, 0xBB, 0xBF`).
|
|
95
|
+
3. **Evidence-First:** Must reference deterministic tools rather than guessing.
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## 5. Security & Safety Invariants (DoD Compliance)
|
|
100
|
+
|
|
101
|
+
All 3rd-party tools and scripts must adhere to Synapse Hub's safety rules:
|
|
102
|
+
|
|
103
|
+
1. **Zero `shell=True` Policy:** Never invoke `subprocess.Popen` or `subprocess.run` with `shell=True`. Always pass structured lists:
|
|
104
|
+
```python
|
|
105
|
+
# Correct:
|
|
106
|
+
subprocess.run(["curl", "-I", url], capture_output=True, check=True)
|
|
107
|
+
# FORBIDDEN (will be rejected by Gatekeeper):
|
|
108
|
+
subprocess.run(f"curl -I {url}", shell=True)
|
|
109
|
+
```
|
|
110
|
+
2. **Environment Allowlist Guard:** Any tool performing destructive modifications or fuzzing must verify staging allowlists (`SYNAPSE_ALLOW_PROD_FUZZ=1`).
|
|
111
|
+
3. **No Hardcoded Credentials:** Never store plaintext secrets or passwords.
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## 6. Vetting & Verification Pipeline
|
|
116
|
+
|
|
117
|
+
Before distributing or publishing a plugin, run the Hub's verification sentinels:
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
# 1. Run SkillSpector Security Scan (Must report 0 High/Critical warnings)
|
|
121
|
+
python tools/skillspector.py --target path/to/my-custom-plugin
|
|
122
|
+
|
|
123
|
+
# 2. Run Quality Gates Linting
|
|
124
|
+
python tools/verify_all.py --target path/to/my-custom-plugin
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
Once passed, the plugin can be mounted directly into the Antigravity Plugin directory (`~/.gemini/config/plugins/`) or integrated via `skills_manifest.json`.
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
# 🛡️ 10 Quality Gates Definition of Done (DoD) Standard
|
|
2
|
+
|
|
3
|
+
[🇻🇳 Tiếng Việt](QUALITY_GATES.md) | [🇬🇧 English Edition](QUALITY_GATES.en.md)
|
|
4
|
+
|
|
5
|
+
> **Scope:** Enterprise automated verification sentinel enforcing 10 non-negotiable Quality Gates across Synapse Hub and target client projects.
|
|
6
|
+
> **Command:** `python3 tools/verify_all.py` or `npx synapse-hub verify`
|
|
7
|
+
> **Integrity Guard:** Synapse Hub created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under MIT License.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
> [!NOTE]
|
|
12
|
+
> **Pre-flight Engine Integrity Guard:** Synapse Hub automatically runs a silent pre-flight engine verification check (`tools/author_integrity.py`) to safeguard original author attribution for **Thế Vị (@TeeVee98)** and MIT license compliance before evaluating the 10 Quality Gates.
|
|
13
|
+
|
|
14
|
+
## 📋 Quality Gates Matrix Overview
|
|
15
|
+
|
|
16
|
+
| Gate | Name | Target Scope | Engine / Tool | Exit Code | Passing Criteria (DoD) |
|
|
17
|
+
| :---: | :--- | :--- | :--- | :---: | :--- |
|
|
18
|
+
| **Gate 1** | **UTF-8 No BOM Encoding** | All source & config files | `tools/verify_all.py` | 0 | Zero Byte Order Mark (`0xEF, 0xBB, 0xBF`) bytes across any file. |
|
|
19
|
+
| **Gate 2** | **Path Portability** | All source & test files | `tools/verify_all.py` | 0 | Zero hardcoded personal/machine absolute paths (`/Users/...`, `C:\...`). |
|
|
20
|
+
| **Gate 3** | **Clean POM & Flat Architecture** | Test scripts (`tests/`, `Scripts/`) | `tools/verify_all.py` | 0 | Zero raw XPaths or CSS selectors in test scripts; 100% locators encapsulated in Page Classes. |
|
|
21
|
+
| **Gate 4** | **AI Documentation & Anti-Drift** | `PROJECT_AI_GUIDE.md` & AST | `tools/lint_ai_docs.py` | 0 | 0 hallucinated PageClasses; 100% documented methods exist in codebase AST. |
|
|
22
|
+
| **Gate 5** | **Temporary Files Blacklist** | Repository tree | `tools/verify_all.py` | 0 | Zero scratch files, heap dumps, or temporary artifacts (`*.tmp`, `.ruff_cache`, memory dumps). |
|
|
23
|
+
| **Gate 6** | **Credential & Secret Security** | All files & git index | `tools/verify_all.py` | 0 | Zero plaintext passwords, API keys, private tokens, or AWS/JWT credentials committed. |
|
|
24
|
+
| **Gate 7** | **Static Defect & Fake-Pass Sentinel** | Test scripts & tools | `tools/infer_linter.py` | 0 | Zero empty assertions (0 assert), zero swallowed exceptions (`pass`), zero hardcoded sleeps (>= 3000ms). |
|
|
25
|
+
| **Gate 8** | **Assertion Sensitivity (Mutation Score)** | Test assertions | `tools/micro_mutator.py` | 0 | Mutation kill score >= 80% (heuristic static mutant detection catches >= 80% syntactic modifications). |
|
|
26
|
+
| **Gate 9** | **Skill Routing & Collision Guard** | Skill descriptions | `tools/skill_collision_guard.py` | 0 | Zero overlapping trigger collisions (semantic cosine similarity < 0.75 across all skill pairs). |
|
|
27
|
+
| **Gate 10** | **Performance & SLA Sentinel** | `Reports/perf/` (`.jtl`, `.csv`, `summary.json`) | `tools/verify_all.py` | 0 | Meets SLA budgets (P95 $\le$ 500ms, P99 $\le$ 1000ms, Error Rate $\le$ 1.0%); automatically SKIPPED/PASS when no perf tests exist. |
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 🔍 Detailed Gate Specifications
|
|
32
|
+
|
|
33
|
+
### Gate 1: UTF-8 No BOM Encoding Integrity
|
|
34
|
+
- **Objective:** Eliminates cross-platform file encoding corruption between Windows, macOS, and Linux CI/CD runners.
|
|
35
|
+
- **Verification Rule:** Inspects raw bytes of all text files. Any occurrence of BOM bytes (`0xEF, 0xBB, 0xBF`) causes immediate failure.
|
|
36
|
+
- **Remediation:** Run `python3 tools/verify_all.py --fix-bom` to strip BOM bytes automatically.
|
|
37
|
+
|
|
38
|
+
### Gate 2: Path Portability
|
|
39
|
+
- **Objective:** Guarantees test scripts and tooling execute seamlessly across team developer workstations, Docker containers, and CI pipelines.
|
|
40
|
+
- **Verification Rule:** Regex scans for machine-specific path roots (`/Users/`, `/home/`, `C:\`, `D:\`).
|
|
41
|
+
- **Remediation:** Replace absolute paths with dynamic workspace resolution (`Path(__file__).resolve().parent.parent` or `resolve_target_repo()`).
|
|
42
|
+
|
|
43
|
+
### Gate 3: Clean POM & Flat Architecture
|
|
44
|
+
- **Objective:** Enforces clean separation of concerns. Test scripts must contain solely business workflow actions, never DOM traversal.
|
|
45
|
+
- **Verification Rule:** Prohibits raw CSS selectors, XPaths, or `findTestObject` inside `tests/` or `Scripts/`. All UI operations must be delegated to methods on Page Classes extending `BasePage`.
|
|
46
|
+
- **Remediation:** Encapsulate locators and interaction logic inside dedicated Page Classes.
|
|
47
|
+
|
|
48
|
+
### Gate 4: AI Documentation & Anti-Drift Linter
|
|
49
|
+
- **Objective:** Prevents AI context drift where documentation refers to non-existent Page Classes or obsolete method signatures.
|
|
50
|
+
- **Verification Rule:** Extracts all documented Page Classes and methods from `PROJECT_AI_GUIDE.md` and verifies their physical AST existence in the codebase.
|
|
51
|
+
- **Remediation:** Run `python3 tools/lint_ai_docs.py` to identify drifts, then re-index via `python3 tools/repo_map.py`.
|
|
52
|
+
|
|
53
|
+
### Gate 5: Temporary Files Blacklist
|
|
54
|
+
- **Objective:** Maintains git hygiene and prevents polluting repositories with binary dumps or local IDE caches.
|
|
55
|
+
- **Verification Rule:** Scans for prohibited extensions: `*.tmp`, `*.dump`, `*.log`, `*.orig`, `*.bak`, `.ruff_cache/`, `.mypy_cache/`.
|
|
56
|
+
- **Remediation:** Add unignored patterns to `.gitignore` and delete temporary files.
|
|
57
|
+
|
|
58
|
+
### Gate 6: Credential Security Sentinel
|
|
59
|
+
- **Objective:** Prevents enterprise credential leaks (API tokens, database connection strings, private keys).
|
|
60
|
+
- **Verification Rule:** High-entropy regex scanner detecting AWS secret keys, Bearer tokens, private RSA keys, and hardcoded passwords.
|
|
61
|
+
- **Remediation:** Move credentials to environment variables or `.env` (ensuring `.env` is listed in `.gitignore`).
|
|
62
|
+
|
|
63
|
+
### Gate 7: Static Defect & Fake-Pass Sentinel
|
|
64
|
+
- **Objective:** Eliminates "fake passes" created by AI code generation (tests that pass trivially without asserting anything).
|
|
65
|
+
- **Verification Rule:**
|
|
66
|
+
- Flags tests containing 0 assertions.
|
|
67
|
+
- Flags empty catch blocks (`except Exception: pass`) swallowing failure exceptions.
|
|
68
|
+
- Flags hardcoded sleeps (`sleep(5000)`, `Thread.sleep(5000)`).
|
|
69
|
+
- Flags unawaited Playwright assertions (`expect(el).toBeVisible()` without `await`).
|
|
70
|
+
- **Remediation:** Add meaningful assertions; replace sleeps with smart waits (`waitForLoadState('networkidle')`, element visibility checks).
|
|
71
|
+
|
|
72
|
+
### Gate 8: Assertion Sensitivity & Syntactic Mutation Sentinel
|
|
73
|
+
- **Objective:** Guarantees assertions are sensitive enough to catch real defects, not tautological (always-true) expressions.
|
|
74
|
+
- **Verification Rule:** Injects syntactic mutations (reversing comparison operators `==` to `!=`, swapping boolean constants, altering return values). Requires Mutation Score >= 80%.
|
|
75
|
+
- **Remediation:** Run `python3 tools/micro_mutator.py --strict` to inspect surviving mutants and tighten test assertions.
|
|
76
|
+
|
|
77
|
+
### Gate 9: Tier-2 Skill Routing & Collision Guard
|
|
78
|
+
- **Objective:** Prevents AI agent prompt confusion caused by overlapping skill trigger descriptions.
|
|
79
|
+
- **Verification Rule:** Computes pairwise cosine similarity between all skill `SKILL.md` description fields. Similarity must remain strictly < 0.75.
|
|
80
|
+
- **Remediation:** Differentiate skill descriptions using the standardized formula `[Function] + Use when [context]` (<= 350 characters).
|
|
81
|
+
|
|
82
|
+
### Gate 10: Performance & SLA Sentinel
|
|
83
|
+
- **Objective:** Prevents latency regressions, unbounded response degradation, or uncontained error bursts from merging or deploying to target environments.
|
|
84
|
+
- **Verification Rule:** Detects and parses load testing artifacts in `Reports/perf/` (`.jtl`, `.csv`, `summary.json`). Enforces SLA thresholds (P95 $\le$ 500ms, P99 $\le$ 1000ms, Error Rate $\le$ 1.0%), returning Exit Code 1 on failure. Automatically yields `PASS (SKIPPED)` within < 1ms if no performance test artifacts exist in the project.
|
|
85
|
+
- **Remediation:** Optimize slow endpoints or DB queries, review thread pool / connection pooling, or adjust custom SLA thresholds in `synapse.config.json` to reflect project-specific capacity budgets.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 🚀 Execution & CI/CD Integration
|
|
90
|
+
|
|
91
|
+
### Run Locally:
|
|
92
|
+
```bash
|
|
93
|
+
# Verify all 10 Gates on current repository
|
|
94
|
+
python3 tools/verify_all.py
|
|
95
|
+
|
|
96
|
+
# Verify target project from Hub
|
|
97
|
+
python3 tools/verify_all.py --target /path/to/project
|
|
98
|
+
|
|
99
|
+
# Output as JUnit XML for CI/CD reporting
|
|
100
|
+
python3 tools/verify_all.py --format junit --output reports/dod_gates.xml
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### GitHub Actions Pipeline (`.github/workflows/verify.yml`):
|
|
104
|
+
```yaml
|
|
105
|
+
name: Synapse Hub 10 DoD Quality Gates
|
|
106
|
+
on: [push, pull_request]
|
|
107
|
+
|
|
108
|
+
jobs:
|
|
109
|
+
quality-gates:
|
|
110
|
+
runs-on: ubuntu-latest
|
|
111
|
+
steps:
|
|
112
|
+
- uses: actions/checkout@v4
|
|
113
|
+
- uses: actions/setup-python@v5
|
|
114
|
+
with:
|
|
115
|
+
python-version: '3.11'
|
|
116
|
+
- name: Run 10 Quality Gates
|
|
117
|
+
run: python tools/verify_all.py --mode target
|
|
118
|
+
```
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
# 🛡️ Tiêu Chuẩn 10 Cổng Chất Lượng DoD (Definition of Done)
|
|
2
|
+
|
|
3
|
+
[🇻🇳 Tiếng Việt](QUALITY_GATES.md) | [🇬🇧 English Edition](QUALITY_GATES.en.md)
|
|
4
|
+
|
|
5
|
+
> **Phạm vi:** Hệ thống chốt chặn tự động kiểm tra 10 Cổng Chất Lượng bắt buộc trên Synapse Hub và các dự án kiểm thử con.
|
|
6
|
+
> **Lệnh thực thi:** `python3 tools/verify_all.py` hoặc `npx synapse-hub verify`
|
|
7
|
+
> **Bảo toàn tác quyền:** Synapse Hub được sáng lập bởi **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) theo giấy phép MIT.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
> [!NOTE]
|
|
12
|
+
> **Pre-flight Engine Integrity Guard:** Động cơ Synapse Hub tự động kích hoạt bộ kiểm tra tiền trạm ngầm (`tools/author_integrity.py`) để bảo toàn giấy phép MIT và tác quyền gốc của **Thế Vị (@TeeVee98)** trước khi chạy 10 Cổng Chất Lượng.
|
|
13
|
+
|
|
14
|
+
## 📋 Bảng Tổng Quan 10 Cổng Kiểm Định Chất Lượng
|
|
15
|
+
|
|
16
|
+
| Cổng | Tên Cổng | Phạm Vi Quét | Công Cụ Kiểm Tra | Mã Thoát | Tiêu Chuẩn Đạt (DoD) |
|
|
17
|
+
| :---: | :--- | :--- | :--- | :---: | :--- |
|
|
18
|
+
| **Gate 1** | **Chuẩn Mã Hóa UTF-8 No BOM** | Toàn bộ file code & config | `tools/verify_all.py` | 0 | 100% file không chứa ký tự BOM rác (`0xEF, 0xBB, 0xBF`). |
|
|
19
|
+
| **Gate 2** | **Đường Dẫn Linh Hoạt (Path Portability)** | Code test & script công cụ | `tools/verify_all.py` | 0 | Không hardcode đường dẫn tuyệt đối của máy cá nhân (`/Users/...`, `C:\...`). |
|
|
20
|
+
| **Gate 3** | **Kiến Trúc Clean POM (Flat Architecture)** | Thư mục test (`tests/`, `Scripts/`) | `tools/verify_all.py` | 0 | 100% locator nằm trong Page Class; không để XPath/CSS selector trong file test. |
|
|
21
|
+
| **Gate 4** | **Chống Bịa Đặt Tài Liệu AI (Anti-Drift)** | `PROJECT_AI_GUIDE.md` & AST code | `tools/lint_ai_docs.py` | 0 | 0 PageClass ảo; 100% hàm tài liệu hóa phải tồn tại thật trong AST codebase. |
|
|
22
|
+
| **Gate 5** | **Chặn File Rác Lọt Vào Git** | Toàn bộ cây thư mục | `tools/verify_all.py` | 0 | Không để file rác, file tạm lọt vào git (`*.tmp`, `.ruff_cache`, heap dump, log). |
|
|
23
|
+
| **Gate 6** | **Quét Mật Khẩu & Token Bí Mật** | Toàn bộ file & git index | `tools/verify_all.py` | 0 | Không commit mật khẩu dạng plaintext, API key, token JWT hoặc private key. |
|
|
24
|
+
| **Gate 7** | **Bắt Lỗi Tĩnh & Test Pass Ảo** | File test & công cụ | `tools/infer_linter.py` | 0 | Chặn đứng test 0 assert, try-catch nuốt lỗi (`pass`), dùng sleep cứng (>= 3000ms). |
|
|
25
|
+
| **Gate 8** | **Đo Độ Nhạy Của Assert (Mutation Score)** | Toàn bộ câu lệnh assert | `tools/micro_mutator.py` | 0 | Tỷ lệ diệt đột biến $\ge 80\%$ (bắt được ít nhất 80% đột biến cú pháp cố ý). |
|
|
26
|
+
| **Gate 9** | **Điều Phối Kỹ Năng Tránh Trùng Lặp** | File `SKILL.md` của các skill | `tools/skill_collision_guard.py` | 0 | Mô tả kích hoạt kỹ năng không được đè phạm vi của nhau (cosine similarity < 0.75). |
|
|
27
|
+
| **Gate 10** | **Kiểm Soát Hiệu Năng & Tiêu Chuẩn SLA** | `Reports/perf/` (`.jtl`, `.csv`, `summary.json`) | `tools/verify_all.py` | 0 | Đạt chuẩn SLA (P95 $\le$ 500ms, P99 $\le$ 1000ms, Error Rate $\le$ 1.0%); tự động SKIPPED/PASS khi dự án không chạy test tải. |
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 🔍 Chi Tiết Tiêu Chuẩn Từng Cổng & Cách Khắc Phục
|
|
32
|
+
|
|
33
|
+
### Gate 1: Chuẩn Mã Hóa UTF-8 No BOM
|
|
34
|
+
- **Mục tiêu:** Tránh lỗi vỡ font hoặc xung đột đọc file giữa Windows, macOS và môi trường Linux CI/CD.
|
|
35
|
+
- **Quy tắc kiểm tra:** Quét raw bytes của tất cả file văn bản. Báo lỗi ngay nếu xuất hiện ký tự BOM (`0xEF, 0xBB, 0xBF`).
|
|
36
|
+
- **Cách khắc phục:** Chạy `python3 tools/verify_all.py --fix-bom` để công cụ tự động dọn sạch byte BOM.
|
|
37
|
+
|
|
38
|
+
### Gate 2: Đường Dẫn Linh Hoạt (Path Portability)
|
|
39
|
+
- **Mục tiêu:** Đảm bảo code test và script công cụ chạy được trên mọi máy dev, Docker container và CI runner.
|
|
40
|
+
- **Quy tắc kiểm tra:** Dùng regex quét tìm các path gắn cứng theo máy cục bộ (`/Users/`, `/home/`, `C:\`, `D:\`).
|
|
41
|
+
- **Cách khắc phục:** Dùng đường dẫn tương đối phân giải từ thư mục gốc (`Path(__file__).resolve().parent.parent` hoặc `resolve_target_repo()`).
|
|
42
|
+
|
|
43
|
+
### Gate 3: Kiến Trúc Clean POM (Flat Architecture)
|
|
44
|
+
- **Mục tiêu:** Phân định ranh giới rõ ràng: file test chỉ chứa các bước nghiệp vụ, tuyệt đối không chọc thẳng vào DOM.
|
|
45
|
+
- **Quy tắc kiểm tra:** Cấm selector thô (CSS selector, XPath, `findTestObject`) trong thư mục `tests/` hoặc `Scripts/`. Thao tác UI phải thông qua hàm của Page Class kế thừa `BasePage`.
|
|
46
|
+
- **Cách khắc phục:** Đưa locator và thao tác click/nhập liệu vào đúng Page Class tương ứng.
|
|
47
|
+
|
|
48
|
+
### Gate 4: Chống Bịa Đặt Tài Liệu AI (Anti-Drift Linter)
|
|
49
|
+
- **Mục tiêu:** Tránh hiện tượng AI bị "ảo giác" (hallucination), đọc tài liệu cũ rồi gọi các Page Class hoặc hàm không hề tồn tại trong code.
|
|
50
|
+
- **Quy tắc kiểm tra:** Quét toàn bộ Page Class và method được ghi trong `PROJECT_AI_GUIDE.md`, kiểm tra xem chúng có tồn tại thật trong AST codebase hay không.
|
|
51
|
+
- **Cách khắc phục:** Chạy `python3 tools/lint_ai_docs.py` để tìm dòng sai lệch, sau đó chạy `python3 tools/repo_map.py` để đồng bộ lại bản đồ code.
|
|
52
|
+
|
|
53
|
+
### Gate 5: Chặn File Rác Lọt Vào Git
|
|
54
|
+
- **Mục tiêu:** Giữ git index luôn sạch sẽ, không bị phình dung lượng bởi rác build hoặc cache IDE.
|
|
55
|
+
- **Quy tắc kiểm tra:** Quét các đuôi file cấm: `*.tmp`, `*.dump`, `*.log`, `*.orig`, `*.bak`, `.ruff_cache/`, `.mypy_cache/`.
|
|
56
|
+
- **Cách khắc phục:** Khai báo các mẫu file này vào `.gitignore` và xóa bỏ các file tạm hiện có trong repo.
|
|
57
|
+
|
|
58
|
+
### Gate 6: Quét Mật Khẩu & Token Bí Mật (Secret Sentinel)
|
|
59
|
+
- **Mục tiêu:** Chống rò rỉ thông tin nhạy cảm của dự án (API token, chuỗi kết nối DB, private key, mật khẩu).
|
|
60
|
+
- **Quy tắc kiểm tra:** Quét regex entropy cao để phát hiện chuỗi khóa bí mật AWS, Bearer token, RSA key và mật khẩu bị gán cứng.
|
|
61
|
+
- **Cách khắc phục:** Chuyển sang dùng biến môi trường hoặc file `.env` (nhớ thêm `.env` vào `.gitignore`).
|
|
62
|
+
|
|
63
|
+
### Gate 7: Bắt Lỗi Tĩnh & Test Pass Ảo
|
|
64
|
+
- **Mục tiêu:** Loại bỏ triệt để các bài test do AI viết chạy xanh nhưng thực chất là vô dụng:
|
|
65
|
+
- **Quy tắc kiểm tra:**
|
|
66
|
+
- Bắt các bài test có **0 câu lệnh assert**.
|
|
67
|
+
- Bắt các khối try-catch rỗng (`except Exception: pass`) nuốt mất lỗi khi test fail.
|
|
68
|
+
- Bắt các lệnh sleep cứng (`sleep(5000)`, `Thread.sleep(5000)`).
|
|
69
|
+
- Bắt assertion của Playwright bị quên `await` (`expect(el).toBeVisible()` thiếu `await`).
|
|
70
|
+
- **Cách khắc phục:** Bổ sung assert thực tế; thay toàn bộ `sleep` cố định bằng smart wait (`waitForLoadState('networkidle')`, kiểm tra element hiển thị).
|
|
71
|
+
|
|
72
|
+
### Gate 8: Đo Độ Nhạy Của Assert (Micro-Mutation Testing)
|
|
73
|
+
- **Mục tiêu:** Đảm bảo các câu lệnh assert có giá trị kiểm thử thật sự, không phải là biểu thức "luôn luôn đúng" (tautology).
|
|
74
|
+
- **Quy tắc kiểm tra:** Tự động tiêm các đột biến cú pháp (đổi `==` thành `!=`, đảo boolean `True` sang `False`, thay giá trị return). Yêu cầu test phải bắt trượt và diệt được ít nhất 80% đột biến (Mutation Score $\ge 80\%$).
|
|
75
|
+
- **Cách khắc phục:** Chạy `python3 tools/micro_mutator.py --strict` để xem mutant nào còn sống sót và siết chặt lại assertion.
|
|
76
|
+
|
|
77
|
+
### Gate 9: Điều Phối Kỹ Năng Tránh Trùng Lặp
|
|
78
|
+
- **Mục tiêu:** Tránh việc AI kích hoạt nhầm kỹ năng do mô tả trong các file `SKILL.md` bị chồng chéo nhau.
|
|
79
|
+
- **Quy tắc kiểm tra:** Tính độ tương đồng cosine giữa phần mô tả của từng cặp kỹ năng. Yêu cầu chỉ số tương đồng phải $< 0.75$.
|
|
80
|
+
- **Cách khắc phục:** Viết lại mô tả kỹ năng theo công thức chuẩn: `[Tính năng] + Dùng khi [ngữ cảnh cụ thể]` (tối đa 350 ký tự).
|
|
81
|
+
|
|
82
|
+
### Gate 10: Kiểm Soát Hiệu Năng & SLA (Performance & SLA Sentinel)
|
|
83
|
+
- **Mục tiêu:** Chặn đứng các bản build hoặc mã gây suy thoái độ trễ nghiêm trọng (latency regressions hoặc lỗi quá ngưỡng) trước khi merge hoặc deploy.
|
|
84
|
+
- **Quy tắc kiểm tra:** Tự động phát hiện và phân tích kết quả chạy tải trong `Reports/perf/` (`.jtl`, `.csv`, `k6_summary.json`). Báo lỗi (Exit Code 1) nếu P95 > 500ms, P99 > 1000ms hoặc Error Rate > 1.0%. Tự động ghi nhận `PASS (SKIPPED)` trong < 1ms nếu dự án không phát sinh file kết quả chạy tải.
|
|
85
|
+
- **Cách khắc phục:** Tối ưu hóa API/DB query, kiểm tra tài nguyên hệ thống, hoặc tùy chỉnh lại ngưỡng SLA trong `synapse.config.json` theo yêu cầu dự án.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 🚀 Cách Chạy & Tích Hợp Vào CI/CD
|
|
90
|
+
|
|
91
|
+
### Chạy Cục Bộ Trên Máy:
|
|
92
|
+
```bash
|
|
93
|
+
# Kiểm định toàn bộ 10 Cổng trên repo hiện tại
|
|
94
|
+
python3 tools/verify_all.py
|
|
95
|
+
|
|
96
|
+
# Kiểm định dự án test mục tiêu từ Hub
|
|
97
|
+
python3 tools/verify_all.py --target /duong-dan/toi/du-an-test
|
|
98
|
+
|
|
99
|
+
# Xuất kết quả ra file JUnit XML để CI/CD đọc
|
|
100
|
+
python3 tools/verify_all.py --format junit --output reports/dod_gates.xml
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Đường Ống GitHub Actions (`.github/workflows/verify.yml`):
|
|
104
|
+
```yaml
|
|
105
|
+
name: Synapse Hub 10 DoD Quality Gates
|
|
106
|
+
on: [push, pull_request]
|
|
107
|
+
|
|
108
|
+
jobs:
|
|
109
|
+
quality-gates:
|
|
110
|
+
runs-on: ubuntu-latest
|
|
111
|
+
steps:
|
|
112
|
+
- uses: actions/checkout@v4
|
|
113
|
+
- uses: actions/setup-python@v5
|
|
114
|
+
with:
|
|
115
|
+
python-version: '3.11'
|
|
116
|
+
- name: Run 10 Quality Gates
|
|
117
|
+
run: python tools/verify_all.py --mode target
|
|
118
|
+
```
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Enterprise Token & Context Engineering Playbook (AI QA Hub)
|
|
2
|
+
|
|
3
|
+
> **Objective:** Maximize AI Agent performance, eliminate context rot, and optimize token quota across the automated test engineering lifecycle.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. AI Model Allocation Matrix
|
|
8
|
+
|
|
9
|
+
Avoid depleting high-tier model quotas by applying the **"Right Task - Right Model"** strategy:
|
|
10
|
+
|
|
11
|
+
| AI Model Tier | Capability & Relative Cost | Recommended QA Workloads | Token Consumption |
|
|
12
|
+
| :--- | :--- | :--- | :--- |
|
|
13
|
+
| **Claude Sonnet / Opus / GPT-4o** | ⭐⭐⭐ High | • Complex logic, nested Shadow DOM / iFrames<br>• Race conditions & complex async synchronization<br>• Flaky test root-cause autopsy & Clean POM refactoring | 🔴 Expensive (Use selectively) |
|
|
14
|
+
| **Gemini Pro / Claude 3.5 Sonnet** | ⭐⭐ Balanced | • Everyday POM code generation, assertions, locator updates<br>• User Story to automated test transpilation<br>• Unit tests, REST API stubs & mock routes | 🟡 Moderate |
|
|
15
|
+
| **Gemini Flash / Claude Haiku** | ⭐ High-Speed & Low-Cost | • Parsing multi-thousand-line CI/CD logs (`distill_log.py`)<br>• Generating synthetic test data (JSON/CSV rows)<br>• Compact AOM extraction & DOM structure filtering<br>• Summaries, documentation, commit messages | 🟢 Ultra-economical |
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## 2. Operational Mode Strategy
|
|
20
|
+
|
|
21
|
+
- **Planning Mode:**
|
|
22
|
+
- Bootstrap new test automation frameworks from scratch.
|
|
23
|
+
- Architect multi-tier Page Object Model hierarchies for large modules.
|
|
24
|
+
- Analyze complex End-to-End user journeys traversing multiple microservices.
|
|
25
|
+
- **Fast / Chat Mode:**
|
|
26
|
+
- Add individual test cases to existing Page Classes.
|
|
27
|
+
- Heal single selectors after UI builds.
|
|
28
|
+
- Debug and re-run isolated test scripts.
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## 3. Context Window Invariants (Zero Context Rot)
|
|
33
|
+
|
|
34
|
+
1. **Progressive Disclosure (Never Load Large Files Whole):**
|
|
35
|
+
- Never load classes over 500 lines into the active conversation prompt.
|
|
36
|
+
- Query `tools/repo_map.txt` for method signatures first (~500 tokens). Micro-read targeted 20-50 line slices (`StartLine`, `EndLine`).
|
|
37
|
+
2. **Log Distillation (`distill_log.py`):**
|
|
38
|
+
- Never dump thousands of lines of raw build/runner output.
|
|
39
|
+
- Run `python3 tools/distill_log.py <path_to_log>` to filter out 95% noise, extracting only the exact failure line and last 3 HTTP requests.
|
|
40
|
+
3. **Compaction State Anchoring (`project_state.py`):**
|
|
41
|
+
- Antigravity automatically triggers Context Compaction near the ~135k token threshold. Ensure active test run statuses and defect IDs are persisted to `PROJECT_STATE.md` on disk to avoid lossy state compression.
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
# Synapse Hub — Tooling Ecosystem Catalog & Runbook
|
|
2
|
+
|
|
3
|
+
> **Audience:** QA Engineers, Autonomous AI Agents (Lead Orchestrator, POM-Crafter, Test-Runner, Failure-Analyst, Quality-Gatekeeper).
|
|
4
|
+
> **Total Tools Cataloged:** `111` | **Stable:** `111` | **Experimental:** `0`
|
|
5
|
+
|
|
6
|
+
## 1. Primary Enterprise CLI Tools
|
|
7
|
+
|
|
8
|
+
| Command | Category | Owner Role | Status | Risk Level | Description |
|
|
9
|
+
|---|---|:---:|:---:|:---:|---|
|
|
10
|
+
| `python tools/_openapi_parser.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/_openapi_parser.py — Shared OpenAPI & Swagger Specification Parser |
|
|
11
|
+
| `python tools/agent_canary.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | ENTERPRISE AUTONOMOUS AGENT Canary & Mutation Testing Arena |
|
|
12
|
+
| `python tools/agentless_patcher.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Agentless 3-Stage Deterministic Patcher (OpenAutoCoder Agentless Pattern) |
|
|
13
|
+
| `python tools/analyze_project.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Comprehensive health audit analyzing environment, POM structure, and Quality Gates. |
|
|
14
|
+
| `python tools/api_drift_sentinel.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Detects contract drift and breaking schema mutations against OpenAPI specifications. |
|
|
15
|
+
| `python tools/api_fuzzer.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Autonomous API Fuzzing & Chaos Breaker |
|
|
16
|
+
| `python tools/author_integrity.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/author_integrity.py — Author Attribution & MIT License Compliance Guard |
|
|
17
|
+
| `python tools/auto_heal.py` | **Failure Autopsy & Healing** | `failure-analyst` | 🟢 Stable | `modifying` | Closed-loop locator self-healing engine matching broken selectors against DOM/AOM. |
|
|
18
|
+
| `python tools/auto_heal_reflexion.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Multi-Trial Episodic Reflexion Loop for Autonomous Healing (Noah Shinn / Reflexion Pattern) |
|
|
19
|
+
| `python tools/autogen_qa_broker.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Asynchronous Actor QA Message Broker (Microsoft AutoGen v0.4+ Pattern) |
|
|
20
|
+
| `python tools/benchmark_swarm_context.py` | **Benchmarking** | `orchestrator` | 🟢 Stable | `read_only` | Empirical context token reduction benchmark harness proving >= 40% savings. |
|
|
21
|
+
| `python tools/browsergym_eval.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | BrowserGym Web Agent Benchmark Harness (BrowserGym / WebArena Pattern) |
|
|
22
|
+
| `python tools/bug_reporter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Auto-Bug Reporter & Root Cause Analysis (RCA) Ticket Generator |
|
|
23
|
+
| `python tools/bump_version.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/bump_version.py — Atomic Universal Version Bumper for Synapse Hub |
|
|
24
|
+
| `python tools/cache_resolver.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Local Semantic Memory Cache & Self-Healing Resolver |
|
|
25
|
+
| `python tools/check_env.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | ============================================================================== |
|
|
26
|
+
| `python tools/check_version_sync.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/check_version_sync.py — Version Synchronization Sentinel for Synapse Hub |
|
|
27
|
+
| `python tools/ci_healing_hook.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | CI/CD Silent Self-Healing Pipeline Hook |
|
|
28
|
+
| `python tools/cli.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Agent-QA CLI Entrypoint |
|
|
29
|
+
| `python tools/config_decoupler.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Environment & Secret Decoupling Engine |
|
|
30
|
+
| `python tools/contract_validator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Swarm Data Contract Validator (Single Front-Door Integrity Guard) |
|
|
31
|
+
| `python tools/count_tokens.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Cross-Platform Token & Cost Auditor (Synapse-Hub) |
|
|
32
|
+
| `python tools/create_mock_docx.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Generates a lightweight valid mock DOCX fixture (< 20 KB) for OpenXML Guard / Word reader tests. |
|
|
33
|
+
| `python tools/dashboard_generator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/dashboard_generator.py — Standalone One-Page Enterprise QA HTML Dashboard |
|
|
34
|
+
| `python tools/db_sandbox.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Zero-Pollution Database Sandbox & Ephemeral Teardown Engine |
|
|
35
|
+
| `python tools/debt_harvester.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/debt_harvester.py — Technical Debt & Shortcut Harvester |
|
|
36
|
+
| `python tools/distill_log.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/distill_log.py — Cross-Platform Log Distiller for Katalon KRE, Gradle, and Playwright |
|
|
37
|
+
| `python tools/dspy_qa_signatures.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Declarative QA Signature Compilation Engine (Stanford DSPy Pattern) |
|
|
38
|
+
| `python tools/e2e_flow_prober.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise E2E Flow Prober & XPath Crawler Dispatcher (Cross-Platform) |
|
|
39
|
+
| `python tools/export_postman_collection.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Exports API test matrices into runnable Postman Collections with pre-request scripts. |
|
|
40
|
+
| `python tools/flaky_detector.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Flaky Test Detector & Quarantine Sentinel |
|
|
41
|
+
| `python tools/fsm_enforcer.py` | **Orchestration** | `orchestrator` | 🟢 Stable | `modifying` | 5-Stage QA Multi-Agent Finite State Machine enforcer with cryptographic proof tokens. |
|
|
42
|
+
| `python tools/fsm_middleware.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Runtime FSM Interceptor & Tool Proxy Middleware |
|
|
43
|
+
| `python tools/fuzz_payloads.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Edge-Case Fuzzing & Input Sanitization Payload Catalog |
|
|
44
|
+
| `python tools/generate_allure_report.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Allure HTML Report Generator (Cross-Platform) |
|
|
45
|
+
| `python tools/generate_api_matrix.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Converts OpenAPI/Swagger specs into automated positive, boundary, and negative test matrices. |
|
|
46
|
+
| `python tools/generate_jmx_plan.py` | **Performance Testing** | `perf-engineer` | 🟢 Stable | `read_only` | Enterprise Apache JMeter 5.x & Locust test plan generator from OpenAPI/Postman/HAR specs. |
|
|
47
|
+
| `python tools/generate_sbom.py` | **Security** | `orchestrator` | 🟢 Stable | `read_only` | Standard SPDX 2.3 JSON Software Bill of Materials (SBOM) generator for software supply chain security. |
|
|
48
|
+
| `python tools/generate_tc_from_story.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/generate_tc_from_story.py — Large Action Model (LAM) Script Generator |
|
|
49
|
+
| `python tools/generate_test_reports.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Test Report Aggregator & summaryTemp Generator (Cross-Platform) |
|
|
50
|
+
| `python tools/generate_tool_catalog.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/generate_tool_catalog.py — Enterprise Tooling Ecosystem Catalog Generator |
|
|
51
|
+
| `python tools/gherkin_suite.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `read_only` | Compiles Gherkin .feature specs into expanded test matrices and coverage reports. |
|
|
52
|
+
| `python tools/git_pre_commit_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Git Pre-Commit Architecture & Discipline Guard |
|
|
53
|
+
| `python tools/goldfish_review.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/goldfish_review.py — Zero-Context Test Specification Reviewer |
|
|
54
|
+
| `python tools/heal_pr_automator.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Self-Healing Confidence Scorer & PR Automator |
|
|
55
|
+
| `python tools/heuristic_locator_matcher.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | 3-Layer Heuristic Locator Matcher (0-Token Autonomous Recovery) |
|
|
56
|
+
| `python tools/hub_publisher.py` | **CI/CD & Packaging** | `orchestrator` | 🟢 Stable | `modifying` | Autonomous 1-click 5-step release pipeline for Synapse Hub. |
|
|
57
|
+
| `python tools/humanize_linter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Humanize & Anti-AI Slop Linter (Enterprise QA Hub) |
|
|
58
|
+
| `python tools/infer_linter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal QA Static Defect & Assertion Sentinel (Inspired by facebook/infer) |
|
|
59
|
+
| `python tools/init_config.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/init_config.py — Standardized Project Configuration Bootstrapper |
|
|
60
|
+
| `python tools/interview_story.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `read_only` | Interactive requirement interrogation engine surfacing hidden assumptions and ambiguous acceptance criteria. |
|
|
61
|
+
| `python tools/jira_sync.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/jira_sync.py — Jira / Xray / Zephyr Enterprise 2-Way Synchronization Engine |
|
|
62
|
+
| `python tools/jtl_analyzer.py` | **Performance Testing** | `perf-engineer` | 🟢 Stable | `read_only` | Sub-0.1s Apache JMeter JTL results analyzer enforcing automated CI/CD SLA quality gates. |
|
|
63
|
+
| `python tools/lint_ai_docs.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise AI Documentation & Artifact Linter (Anti-Drift Guard v2.0) |
|
|
64
|
+
| `python tools/lookup_tc.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise QA: Fast Test Case Metadata Lookup (lookup_tc.py) |
|
|
65
|
+
| `python tools/lookup_xpath.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise QA: Fast XPath / Selector Lookup (lookup_xpath.py) |
|
|
66
|
+
| `python tools/matrix_sharder.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Duration-Balanced Test Matrix Sharder |
|
|
67
|
+
| `python tools/mcp_docx_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Cross-Platform MCP Docx Server (Zero-Dependency) |
|
|
68
|
+
| `python tools/mcp_excel_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Cross-Platform MCP Excel Server (Zero-Dependency) |
|
|
69
|
+
| `python tools/mcp_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Model Context Protocol (MCP) Standard Server |
|
|
70
|
+
| `python tools/md_to_xlsx.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Markdown to Excel (.xlsx) Enterprise Converter |
|
|
71
|
+
| `python tools/micro_mutator.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Syntactic micro-mutation sentinel eliminating tautological tests and measuring assertion sensitivity. |
|
|
72
|
+
| `python tools/mipro_assertion_tuner.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | MIPROv2 Prompt Assertion Tuner (Stanford DSPy v2 & Optuna TPE Pattern) |
|
|
73
|
+
| `python tools/network_mock_shield.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `modifying` | Network interception shield stubbing external routes and injecting chaos network faults. |
|
|
74
|
+
| `python tools/newman_analyzer.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Sub-0.1s Postman/Newman JSON test report analyzer enforcing CI/CD quality gates. |
|
|
75
|
+
| `python tools/omni_emitter.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `read_only` | Universal polyglot code generator emitting Clean POM Flat Architecture scripts. |
|
|
76
|
+
| `python tools/omni_parser.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `read_only` | Deterministic 0-token polyglot AST parser extracting Page Classes and test workflows. |
|
|
77
|
+
| `python tools/omni_transpiler.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `modifying` | Instant 0-token transpiler between Playwright, Selenium, and Katalon. |
|
|
78
|
+
| `python tools/openxml_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | OpenXML Security & Protocol Defense Guard |
|
|
79
|
+
| `python tools/output_formatter.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Standardized Output Formatter & Exit Code Specification |
|
|
80
|
+
| `python tools/package_release.py` | **CI/CD & Packaging** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise release packager preserving .github/workflows and generating SHA-256 provenance. |
|
|
81
|
+
| `python tools/pinpoint_failure.py` | **Failure Autopsy & Healing** | `failure-analyst` | 🟢 Stable | `read_only` | Sub-0.1s JUnit XML autopsy parser diagnosing test crashes without LLM token waste. |
|
|
82
|
+
| `python tools/project_state.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Project State Machine & Token-Capped Memory Anchor |
|
|
83
|
+
| `python tools/qa_event_stream.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Immutable QA Event Stream Engine (OpenHands EventStream Pattern) |
|
|
84
|
+
| `python tools/repo_map.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Repository Map Compressor (Inspired by Aider-AI/aider) |
|
|
85
|
+
| `python tools/reversible_sandbox.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Reversible Execution Sandbox & Automated Teardown Engine (GoEx Pattern) |
|
|
86
|
+
| `python tools/safety_firewall.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Non-bypassable safety firewall blocking destructive operations (drop database, git push force, rm -rf). |
|
|
87
|
+
| `python tools/security_coverage_ledger.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Mathematical Security Coverage Ledger & Audit Tracker |
|
|
88
|
+
| `python tools/security_scanner.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Comprehensive enterprise security sentinel auditing Python & NPM dependencies and threat-model defense. |
|
|
89
|
+
| `python tools/senior_code_review.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/senior_code_review.py — Senior Developer Quality & Lean Diff Reviewer |
|
|
90
|
+
| `python tools/setup_project.py` | **Setup & Onboarding** | `orchestrator` | 🟢 Stable | `modifying` | Zero-command automated project bootstrap tailoring AI agent rules to the target stack. |
|
|
91
|
+
| `python tools/skill_collision_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Tier-2 Skill Routing & Collision Guard (Addy Osmani Pattern) |
|
|
92
|
+
| `python tools/skill_profiles.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/skill_profiles.py — Skill Catalog Capability Profile Manager |
|
|
93
|
+
| `python tools/skill_vault.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | SkillVault Lifelong Page Object Model & Interaction Library (MineDojo / Voyager Pattern) |
|
|
94
|
+
| `python tools/skillspector.py` | **Security** | `quality-gatekeeper` | 🟢 Stable | `read_only` | Security scanner detecting prompt injection, Unicode obfuscation, and dangerous CLI tools. |
|
|
95
|
+
| `python tools/smart_visual_masker.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Smart Visual Masker & Anti-Flake Visual Engine |
|
|
96
|
+
| `python tools/spec_drift_sentinel.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/spec_drift_sentinel.py — Spec-to-Code Drift Sentinel |
|
|
97
|
+
| `python tools/swe_qa_aci.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | QA Agent-Computer Interface (SWE-agent ACI Pattern) |
|
|
98
|
+
| `python tools/synapse_observer.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Synapse Cognitive Observer & Tradeoff Sentinel |
|
|
99
|
+
| `python tools/synapse_qa_bench.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Synapse-QA-Bench: Tool Function Calling Benchmark (Gorilla BFCL Pattern) |
|
|
100
|
+
| `python tools/sync_agent_rules.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/sync_agent_rules.py — Synchronizes AGENTS.md single-source rules to all AI bridges |
|
|
101
|
+
| `python tools/telemetry_correlator.py` | **Performance Testing** | `perf-engineer` | 🟢 Stable | `read_only` | Full-stack APM & server telemetry performance correlator linking client latencies with server hardware. |
|
|
102
|
+
| `python tools/template_excel_exporter.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `modifying` | Enterprise template-driven Excel test case exporter with dropdown Data Validation. |
|
|
103
|
+
| `python tools/test_impact.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Test Impact Analyzer (Graphify AST-Powered) |
|
|
104
|
+
| `python tools/test_memory_os.py` | **Testing & Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Hierarchical QA Test Memory OS (Letta / MemGPT Pattern) |
|
|
105
|
+
| `python tools/textgrad_mutation_optimizer.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Mutant-Directed Textual Loss Optimizer (Deterministic TextGrad-Style Heuristic) |
|
|
106
|
+
| `python tools/tms_sync_bridge.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise ALM & TMS Sync Bridge (Jira / Xray / Zephyr / TestRail) |
|
|
107
|
+
| `python tools/tot_exploratory_tester.py` | **Manual Testing & Design** | `test-designer` | 🟢 Stable | `read_only` | Tree-of-Thoughts exploratory scenario generator with risk scoring and boundary decomposition. |
|
|
108
|
+
| `python tools/trace_data_flow.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Universal Data Flow & Teardown Tracer (Taint Analysis) |
|
|
109
|
+
| `python tools/traffic_session_converter.py` | **API & Contract Testing** | `api-engineer` | 🟢 Stable | `read_only` | Converts recorded HAR traffic sessions into executable API automation test cases. |
|
|
110
|
+
| `python tools/trend_analytics.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/trend_analytics.py — Historical Quality Trend & Flakiness Analytics Engine |
|
|
111
|
+
| `python tools/ui_server.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/ui_server.py — Synapse Hub Interactive QA Mission Control Web Server |
|
|
112
|
+
| `python tools/universal_ir.py` | **Code Generation & AST** | `pom-crafter` | 🟢 Stable | `read_only` | Language-agnostic and framework-agnostic AST data model for automated test suites. |
|
|
113
|
+
| `python tools/update_sentinel.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Synapse-Hub Auto-Update & Version Drift Sentinel |
|
|
114
|
+
| `python tools/validate_groovy_scripts.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Pre-check validator for Groovy scripts and POM keywords in enterprise test suites. |
|
|
115
|
+
| `python tools/verify_all.py` | **Quality Gates** | `quality-gatekeeper` | 🟢 Stable | `read_only` | One-command 10 Quality Gates Definition of Done (DoD) verification sentinel. |
|
|
116
|
+
| `python tools/visual_diff_canvas.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Canvas Visual Diff & Regression Checker |
|
|
117
|
+
| `python tools/visual_som_helper.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Vision-Grounded Fallback & Set-of-Marks (SoM) Engine |
|
|
118
|
+
| `python tools/watch_mode.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/watch_mode.py — Incremental Watch Mode & Real-Time Test Engineering HUD |
|
|
119
|
+
| `python tools/wcag_audit.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/wcag_audit.py - Automated Accessibility (WCAG 2.2) Linter & Auditor |
|
|
120
|
+
| `python tools/welcome_page.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/welcome_page.py — Interactive Visual Landing Page for Synapse Hub |
|
|
121
|
+
|
|
122
|
+
## 2. Risk & Operational Classification
|
|
123
|
+
|
|
124
|
+
- `read_only`: Diagnostic, linting, AST inspection, reporting (zero side effects on workspace or git).
|
|
125
|
+
- `modifying`: Generates files, updates Page Classes, or writes test suites.
|
|
126
|
+
- `network`: Queries external APIs, monitors npm registry, or checks live URLs.
|
|
127
|
+
- `destructive`: High-impact actions guarded by `safety_firewall.py` (e.g. drop database, hard resets).
|
|
128
|
+
|
|
129
|
+
*Catalog generated: `2026-11-12T08:56:38.327652+00:00` by `tools/generate_tool_catalog.py`*
|