@teevee98/synapse-hub 4.3.1 → 4.4.1
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/.cursor/rules/agents.mdc +11 -11
- package/.cursor/rules/katalon.mdc +11 -0
- package/.cursor/rules/perf.mdc +10 -0
- package/.cursor/rules/playwright.mdc +10 -0
- package/.cursor/rules/pytest.mdc +10 -0
- package/.cursor/rules/synapse-qa.mdc +4 -2
- package/.cursorrules +3 -10
- package/.windsurfrules +3 -10
- package/AGENTS.md +4 -3
- package/CLAUDE.md +4 -5
- package/README.en.md +3 -3
- package/README.md +3 -3
- package/agentskills.json +15 -15
- package/{.agents/agents → ai-agents/personas}/api-engineer.md +9 -1
- package/{.agents/agents → ai-agents/personas}/failure-analyst.md +1 -1
- package/{.agents/agents → ai-agents/personas}/live-explorer.md +1 -1
- package/{.agents/agents → ai-agents/personas}/orchestrator.md +8 -15
- package/{.agents/agents → ai-agents/personas}/perf-engineer.md +11 -5
- package/{.agents/agents → ai-agents/personas}/pom-crafter.md +3 -9
- package/{.agents/agents → ai-agents/personas}/quality-gatekeeper.md +1 -1
- package/{.agents/agents → ai-agents/personas}/test-designer.md +2 -1
- package/{.agents/agents → ai-agents/personas}/test-runner.md +3 -4
- package/{.agents/rules → automation/playwright}/mandatory-playwright-live.md +5 -13
- package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/SKILL.md +2 -0
- package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/SKILL.md +14 -3
- package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/SKILL.md +12 -1
- package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/SKILL.md +2 -0
- package/docs/ARCHITECTURE.en.md +96 -3
- package/docs/ARCHITECTURE.md +87 -3
- package/docs/TOOL_CATALOG.md +17 -5
- package/docs/reports/AUDIT_REPORT.md +1038 -0
- package/docs/reports/PROJECT_HEALTH_REPORT.md +49 -0
- package/docs/reports/TECHNICAL_DEBT_LEDGER.md +22 -0
- package/package.json +8 -1
- package/plugin.json +1 -1
- package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/SKILL.md +8 -0
- package/scripts/install_global_plugin.ps1 +1 -1
- package/scripts/install_global_plugin.sh +1 -1
- package/skills_index.json +61 -0
- package/skills_manifest.json +88 -62
- package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/SKILL.md +8 -1
- package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/SKILL.md +2 -0
- package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/SKILL.md +8 -0
- package/synapse.config.json +1 -1
- package/templates/ai_bridges/CLAUDE.md +4 -5
- package/templates/ai_bridges/copilot-instructions.md +1 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +4 -2
- package/templates/ai_bridges/windsurfrules +3 -10
- package/templates/test-plan/performance-test-plan-template.md +106 -0
- package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/SKILL.md +11 -5
- package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/SKILL.md +8 -1
- package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/SKILL.md +4 -1
- package/testing/api-contracts/api_testing_rules.md +74 -0
- package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/SKILL.md +2 -0
- package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/SKILL.md +5 -11
- package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/SKILL.md +2 -0
- package/testing/manual/manual-qa-and-rtm-bridge/SKILL.md +92 -0
- package/testing/manual/manual-qa-and-rtm-bridge/examples/sample_bug_and_rtm.json +38 -0
- package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/SKILL.md +5 -2
- package/testing/performance/backend-load-and-stress-patterns/references/performance_test_plan_29119.md +106 -0
- package/{.agents/rules → testing/performance}/performance_testing_rules.md +27 -3
- package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/SKILL.md +75 -14
- package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/SKILL.md +13 -2
- package/{.agents/rules → testing/security-a11y}/security_testing_rules.md +19 -0
- package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/SKILL.md +4 -1
- package/tools/.infer_baseline.json +44 -3
- package/tools/TOOLS_RUNBOOK.md +246 -4
- package/tools/TOOL_CATALOG.json +199 -19
- package/tools/TOOL_INDEX.json +160 -0
- package/tools/__init__.py +1 -1
- package/tools/ai_eval_sentinel.py +403 -0
- package/tools/assertion_optimizer.py +188 -0
- package/tools/asvs_auditor.py +410 -0
- package/tools/author_integrity.py +12 -1
- package/tools/benchmark_swarm_context.py +1 -1
- package/tools/browser_helpers.js +2 -2
- package/tools/catalogs/api_contract_testing.json +107 -0
- package/tools/catalogs/auxiliary_utilities.json +1536 -0
- package/tools/catalogs/benchmarking.json +23 -0
- package/tools/catalogs/ci_cd_packaging.json +46 -0
- package/tools/catalogs/code_generation_ast.json +70 -0
- package/tools/catalogs/failure_autopsy_healing.json +41 -0
- package/tools/catalogs/manual_testing_design.json +80 -0
- package/tools/catalogs/orchestration.json +25 -0
- package/tools/catalogs/performance_testing.json +71 -0
- package/tools/catalogs/quality_gates.json +65 -0
- package/tools/catalogs/sandboxing_isolation.json +42 -0
- package/tools/catalogs/security.json +72 -0
- package/tools/catalogs/setup_onboarding.json +26 -0
- package/tools/catalogs/testing_utilities.json +111 -0
- package/tools/chaos_resilience_probe.py +362 -0
- package/tools/check_env.py +16 -3
- package/tools/check_version_sync.py +114 -63
- package/tools/cldr_l10n_verifier.py +309 -0
- package/tools/cli.py +971 -3
- package/tools/core/circuit_breaker.py +106 -0
- package/tools/core/token_estimator.py +56 -7
- package/tools/cvss_calculator.py +412 -0
- package/tools/dashboard_generator.py +12 -12
- package/tools/etl_data_reconciler.py +460 -0
- package/tools/generate_jmx_plan.py +12 -4
- package/tools/generate_tool_catalog.py +60 -2
- package/tools/jtl_analyzer.py +23 -1
- package/tools/mcp_docx_server.py +1 -1
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +5 -1
- package/tools/mobile_resilience_sentinel.py +273 -0
- package/tools/observability_tester.py +235 -0
- package/tools/payment_interop_simulator.py +337 -0
- package/tools/pre_push_guard.py +306 -0
- package/tools/project_state.py +17 -10
- package/tools/regulatory_compliance.py +336 -0
- package/tools/reversible_sandbox.py +7 -2
- package/tools/rules_router.py +6 -4
- package/tools/runaway_stopper.py +19 -111
- package/tools/setup_project.py +1 -1
- package/tools/skill_canonical_digest.py +2 -2
- package/tools/skillspector.py +78 -10
- package/tools/sync_agent_rules.py +15 -27
- package/tools/sync_skills_manifest.py +38 -4
- package/tools/tmmi_auditor.py +179 -0
- package/tools/ui_server.py +1 -1
- package/tools/update_sentinel.py +4 -4
- package/tools/validate_host_interop.py +3 -1
- package/tools/validate_skills_schema.py +49 -2
- package/tools/vpat_exporter.py +428 -0
- package/tools/welcome_page.py +4 -4
- package/.agents/rules/stack-auto-router.md +0 -30
- package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +0 -114
- package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +0 -9
- package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/SKILL.md +0 -123
- package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/examples/sample_gitlab_ci.yml +0 -17
- package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/SKILL.md +0 -133
- package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/examples/Jenkinsfile.example +0 -21
- package/.cursor/rules/language.mdc +0 -7
- package/templates/ci/github-actions-synapse.yml +0 -95
- package/templates/ci/gitlab-ci-synapse.yml +0 -16
- package/tools/build_consolidated_report.py +0 -1643
- package/tools/create_mock_docx.py +0 -107
- /package/{.agents → ai-agents/hooks}/hooks.json +0 -0
- /package/{.agents → ai-agents}/hooks/session_start.py +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/examples/broker_sharding_sample.json +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/examples/task_plan_example.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/SKILL.md +0 -0
- /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/examples/archival_memory_sample.json +0 -0
- /package/{.agents → ai-agents}/workflows/graphify.md +0 -0
- /package/{.agents → ai-agents}/workflows/test-impact.md +0 -0
- /package/{.agents → ai-agents}/workflows/verify.md +0 -0
- /package/{.agents/rules → automation/cypress}/cypress_rules.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/examples/headless_kre_exec.sh +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/groovy-patterns.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/katalon-api.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/runner_commands.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/BaseScreen.java +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/LoginScreen.java +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/TC_MobileLogin.java +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/examples/sample_flow.yaml +0 -0
- /package/{.agents/rules → automation/mobile}/mobile_appium_rules.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/examples/live_probe_script.js +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/advanced_superpowers.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/compact_accessibility_snapshots.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/recipes.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/swarm_orchestration.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/examples/server_lifecycle_playwright.py +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/storage_state_sample.json +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/examples/cli_runner_test.bats +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/resources/implementation-playbook.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/examples/standard_test_case.groovy +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/references/pom_patterns.groovy +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/examples/playwright_sharded_config.ts +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/resources/implementation-playbook.md +0 -0
- /package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/examples/user_story_sample.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/SKILL.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/examples/sample_openapi.json +0 -0
- /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/SKILL.md +0 -0
- /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/examples/0001-record-architecture-decisions.md +0 -0
- /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/pocock_grilling_decision_rubric.md +0 -0
- /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/sample_spec_review.md +0 -0
- /package/{.agents → requirement}/workflows/analyze_requirement_document.md +0 -0
- /package/{.agents → requirement}/workflows/generate_requirements_from_website.md +0 -0
- /package/{.agents/rules → standards/coding-standards}/author-integrity-guard.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/resources/implementation-playbook.md +0 -0
- /package/{.agents/rules → standards/coding-standards}/communication-style.md +0 -0
- /package/{.agents/rules → standards/coding-standards}/git-push-protocol.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/examples/dependency_blast_radius.json +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/examples/ladder_walkthrough.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_audit_walkthrough.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_repo_audit.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/examples/sample_review_walkthrough.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/examples/surgical_vs_scope_creep.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/SKILL.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_debt_ledger.md +0 -0
- /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_ledger_output.md +0 -0
- /package/{.agents/rules → standards/context-ai}/context-engineering.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/SKILL.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/examples/qa_prompt_template.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/compiled_module_sample.json +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/SKILL.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_code_window_walkthrough.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_edit_sample.json +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/SKILL.md +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/examples/distilled_log_sample.txt +0 -0
- /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/references/context_engineering_guide.md +0 -0
- /package/{.agents/rules → standards/qa-process}/graphify.md +0 -0
- /package/{.agents/rules → standards/qa-process}/lessons-learned.md +0 -0
- /package/{.agents/rules → standards/qa-process}/skill-precedence.md +0 -0
- /package/{.agents/rules → standards/quality-gates}/systematic-debugging.md +0 -0
- /package/{.agents/templates → templates/test-report}/completion_report.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/SKILL.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/checkout.feature +0 -0
- /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/suite_report_sample.json +0 -0
- /package/{.agents → test-design/bdd-gherkin}/workflows/generate_cross_module_test_plan.md +0 -0
- /package/{.agents → test-design/bdd-gherkin}/workflows/generate_testcases_from_requirements.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/SKILL.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +0 -0
- /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/tot_graph_sample.json +0 -0
- /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +0 -0
- /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/references/field_validation_checklist.md +0 -0
- /package/{.agents → test-design/manual-rbt}/workflows/export_testcases_excel.md +0 -0
- /package/{.agents → test-design/manual-rbt}/workflows/generate_manual_testcases_rbt.md +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/SKILL.md +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/examples/db_fixture_seed.json +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/examples/sample_export_schema.json +0 -0
- /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/examples/idempotent_data_recipe.json +0 -0
- /package/{.agents → test-design/test-data}/workflows/generate_combinatorial_test_data.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/SKILL.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/examples/network_route_stub.json +0 -0
- /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/SKILL.md +0 -0
- /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/examples/order_service_pact.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/healing_report_sample.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/three_phase_repair_workflow.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/dod_gate_policy.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/sample_junit_failure.xml +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/healing_matrix.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/qa_investigation_protocol.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/scripts/triage_failures.sh +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/examples/aom_diff_sample.json +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/examples/four_phase_case.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/examples/red_green_refactor_qa.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/examples/evidence_log_example.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/SKILL.md +0 -0
- /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/examples/visual_mask_rules.json +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/k6_load_template.js +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/SKILL.md +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_benchmark_gain.md +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_scoreboard.md +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +0 -0
- /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/examples/dast_scan_config.json +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/AI-AND-LLM.md +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/ATTACK-CLASSES.md +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/dast_recipes.ts +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/SKILL.md +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/audit_threat_vectors_report.json +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/safe_mcp_config.json +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/examples/wcag_compliance_checklist.json +0 -0
- /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/resources/implementation-playbook.md +0 -0
- /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/SKILL.md +0 -0
- /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +0 -0
- /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +0 -0
|
@@ -0,0 +1,428 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
# Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
|
|
5
|
+
|
|
6
|
+
"""
|
|
7
|
+
tools/vpat_exporter.py — Enterprise Section 508 & EN 301 549 VPAT Report Generator
|
|
8
|
+
---------------------------------------------------------------------------------
|
|
9
|
+
Translates WCAG 2.1 & 2.2 accessibility scan findings (from tools/wcag_audit.py
|
|
10
|
+
or axe-core) into standardized Voluntary Product Accessibility Template (VPAT 2.5)
|
|
11
|
+
compliance reports covering:
|
|
12
|
+
- Revised Section 508 (US Public Sector / Federal Standard)
|
|
13
|
+
- EN 301 549 (European Union Accessibility Standard for ICT)
|
|
14
|
+
- W3C WCAG 2.1 / 2.2 (Levels A and AA)
|
|
15
|
+
|
|
16
|
+
Outputs:
|
|
17
|
+
- Markdown (.md)
|
|
18
|
+
- HTML (.html)
|
|
19
|
+
- JSON (.json)
|
|
20
|
+
|
|
21
|
+
Usage:
|
|
22
|
+
python tools/vpat_exporter.py --url https://staging.example.com --out-md VPAT_REPORT.md
|
|
23
|
+
python tools/vpat_exporter.py --input wcag_results.json --format html --out VPAT.html
|
|
24
|
+
python tools/vpat_exporter.py --html-file path/to/index.html --out-md VPAT.md
|
|
25
|
+
"""
|
|
26
|
+
|
|
27
|
+
import sys
|
|
28
|
+
import json
|
|
29
|
+
import argparse
|
|
30
|
+
from datetime import datetime, timezone
|
|
31
|
+
from typing import Dict, List, Any
|
|
32
|
+
|
|
33
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
34
|
+
if hasattr(sys.stdout, "reconfigure"):
|
|
35
|
+
try:
|
|
36
|
+
sys.stdout.reconfigure(encoding="utf-8")
|
|
37
|
+
sys.stderr.reconfigure(encoding="utf-8")
|
|
38
|
+
except Exception:
|
|
39
|
+
pass
|
|
40
|
+
|
|
41
|
+
# Import wcag_audit dynamically if present
|
|
42
|
+
try:
|
|
43
|
+
from tools.wcag_audit import WCAGAuditor
|
|
44
|
+
except ImportError:
|
|
45
|
+
try:
|
|
46
|
+
from wcag_audit import WCAGAuditor
|
|
47
|
+
except ImportError:
|
|
48
|
+
WCAGAuditor = None
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
# ==============================================================================
|
|
52
|
+
# VPAT 2.5 CRITERIA MAPPING TABLE
|
|
53
|
+
# ==============================================================================
|
|
54
|
+
|
|
55
|
+
VPAT_CRITERIA_CATALOG = [
|
|
56
|
+
{
|
|
57
|
+
"wcag_id": "1.1.1",
|
|
58
|
+
"name": "Non-text Content",
|
|
59
|
+
"level": "A",
|
|
60
|
+
"section_508": "501.1 (Web), 504.2 (Authoring Tools)",
|
|
61
|
+
"en_301_549": "9.1.1.1 (Web), 10.1.1.1 (Non-web docs), 11.1.1.1 (Software)",
|
|
62
|
+
"desc": "All non-text content that is presented to the user has a text alternative that serves the equivalent purpose.",
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
"wcag_id": "1.3.1",
|
|
66
|
+
"name": "Info and Relationships",
|
|
67
|
+
"level": "A",
|
|
68
|
+
"section_508": "501.1 (Web), 504.2",
|
|
69
|
+
"en_301_549": "9.1.3.1 (Web), 11.1.3.1 (Software)",
|
|
70
|
+
"desc": "Information, structure, and relationships conveyed through presentation can be programmatically determined or are available in text.",
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
"wcag_id": "1.4.3",
|
|
74
|
+
"name": "Contrast (Minimum)",
|
|
75
|
+
"level": "AA",
|
|
76
|
+
"section_508": "501.1 (Web), 504.2",
|
|
77
|
+
"en_301_549": "9.1.4.3 (Web), 11.1.4.3 (Software)",
|
|
78
|
+
"desc": "The visual presentation of text and images of text has a contrast ratio of at least 4.5:1 (3:1 for large text).",
|
|
79
|
+
},
|
|
80
|
+
{
|
|
81
|
+
"wcag_id": "2.1.1",
|
|
82
|
+
"name": "Keyboard",
|
|
83
|
+
"level": "A",
|
|
84
|
+
"section_508": "501.1 (Web), 504.2",
|
|
85
|
+
"en_301_549": "9.2.1.1 (Web), 11.2.1.1 (Software)",
|
|
86
|
+
"desc": "All functionality of the content is operable through a keyboard interface without requiring specific timings for individual keystrokes.",
|
|
87
|
+
},
|
|
88
|
+
{
|
|
89
|
+
"wcag_id": "2.1.2",
|
|
90
|
+
"name": "No Keyboard Trap",
|
|
91
|
+
"level": "A",
|
|
92
|
+
"section_508": "501.1 (Web), 504.2",
|
|
93
|
+
"en_301_549": "9.2.1.2 (Web), 11.2.1.2 (Software)",
|
|
94
|
+
"desc": "If keyboard focus can be moved to a component using a keyboard interface, focus can be moved away without trapping the user.",
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"wcag_id": "2.4.4",
|
|
98
|
+
"name": "Link Purpose (In Context)",
|
|
99
|
+
"level": "A",
|
|
100
|
+
"section_508": "501.1 (Web), 504.2",
|
|
101
|
+
"en_301_549": "9.2.4.4 (Web), 11.2.4.4 (Software)",
|
|
102
|
+
"desc": "The purpose of each link can be determined from the link text alone or from the link text together with programmatic context.",
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"wcag_id": "2.4.11",
|
|
106
|
+
"name": "Focus Not Obscured (Minimum)",
|
|
107
|
+
"level": "AA",
|
|
108
|
+
"section_508": "Revised 508 (Aligned with WCAG 2.2)",
|
|
109
|
+
"en_301_549": "9.2.4.11 (Web, WCAG 2.2 Draft)",
|
|
110
|
+
"desc": "When an item gets keyboard focus, it is not entirely obscured by author-created content (sticky headers, banners).",
|
|
111
|
+
},
|
|
112
|
+
{
|
|
113
|
+
"wcag_id": "2.5.8",
|
|
114
|
+
"name": "Target Size (Minimum)",
|
|
115
|
+
"level": "AA",
|
|
116
|
+
"section_508": "Revised 508 (Aligned with WCAG 2.2)",
|
|
117
|
+
"en_301_549": "9.2.5.8 (Web, WCAG 2.2 Draft)",
|
|
118
|
+
"desc": "The target size for pointer inputs is at least 24 by 24 CSS pixels, or has sufficient offset/spacing.",
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
"wcag_id": "3.2.6",
|
|
122
|
+
"name": "Consistent Help",
|
|
123
|
+
"level": "A",
|
|
124
|
+
"section_508": "Revised 508 (Aligned with WCAG 2.2)",
|
|
125
|
+
"en_301_549": "9.3.2.6 (Web, WCAG 2.2)",
|
|
126
|
+
"desc": "If help mechanism is available, it appears in the same relative order across multiple web pages.",
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"wcag_id": "3.3.7",
|
|
130
|
+
"name": "Redundant Entry",
|
|
131
|
+
"level": "A",
|
|
132
|
+
"section_508": "Revised 508 (Aligned with WCAG 2.2)",
|
|
133
|
+
"en_301_549": "9.3.3.7 (Web, WCAG 2.2)",
|
|
134
|
+
"desc": "Information previously entered or provided is auto-populated or available for selection in multi-step processes.",
|
|
135
|
+
},
|
|
136
|
+
{
|
|
137
|
+
"wcag_id": "3.3.8",
|
|
138
|
+
"name": "Accessible Authentication (Minimum)",
|
|
139
|
+
"level": "AA",
|
|
140
|
+
"section_508": "Revised 508 (Aligned with WCAG 2.2)",
|
|
141
|
+
"en_301_549": "9.3.3.8 (Web, WCAG 2.2)",
|
|
142
|
+
"desc": "A cognitive function test (such as solving a puzzle or remembering a password) is not required for authentication without an alternative.",
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
"wcag_id": "4.1.2",
|
|
146
|
+
"name": "Name, Role, Value",
|
|
147
|
+
"level": "A",
|
|
148
|
+
"section_508": "501.1 (Web), 504.2",
|
|
149
|
+
"en_301_549": "9.4.1.2 (Web), 11.4.1.2 (Software)",
|
|
150
|
+
"desc": "For all UI components, the name and role can be programmatically determined; states and properties can be set programmatically.",
|
|
151
|
+
},
|
|
152
|
+
]
|
|
153
|
+
|
|
154
|
+
|
|
155
|
+
def audit_html_source(html_content: str) -> List[Dict[str, Any]]:
|
|
156
|
+
"""Runs WCAGAuditor parser on HTML content to extract violations."""
|
|
157
|
+
if WCAGAuditor is None:
|
|
158
|
+
return []
|
|
159
|
+
auditor = WCAGAuditor()
|
|
160
|
+
try:
|
|
161
|
+
auditor.feed(html_content)
|
|
162
|
+
except Exception:
|
|
163
|
+
pass
|
|
164
|
+
return auditor.violations
|
|
165
|
+
|
|
166
|
+
|
|
167
|
+
def compile_vpat_assessment(
|
|
168
|
+
violations: List[Dict[str, Any]],
|
|
169
|
+
product_name: str = "Enterprise Web Application",
|
|
170
|
+
product_version: str = "1.0.0",
|
|
171
|
+
vendor: str = "Quality Engineering Team",
|
|
172
|
+
) -> Dict[str, Any]:
|
|
173
|
+
"""Compiles audit violations into standard VPAT conformance criteria."""
|
|
174
|
+
assessed_table = []
|
|
175
|
+
supports_count = 0
|
|
176
|
+
partially_count = 0
|
|
177
|
+
not_support_count = 0
|
|
178
|
+
|
|
179
|
+
# Group violations by WCAG criterion ID
|
|
180
|
+
violation_map: Dict[str, List[Dict[str, Any]]] = {}
|
|
181
|
+
for v in violations:
|
|
182
|
+
crit_str = v.get("criterion", "")
|
|
183
|
+
for c in VPAT_CRITERIA_CATALOG:
|
|
184
|
+
if c["wcag_id"] in crit_str or c["name"].lower() in crit_str.lower():
|
|
185
|
+
violation_map.setdefault(c["wcag_id"], []).append(v)
|
|
186
|
+
break
|
|
187
|
+
|
|
188
|
+
for c in VPAT_CRITERIA_CATALOG:
|
|
189
|
+
cid = c["wcag_id"]
|
|
190
|
+
viols = violation_map.get(cid, [])
|
|
191
|
+
|
|
192
|
+
if not viols:
|
|
193
|
+
conformance = "Supports"
|
|
194
|
+
remarks = "The web application satisfies the criterion with zero automated defects detected."
|
|
195
|
+
supports_count += 1
|
|
196
|
+
elif len(viols) <= 2 and not any(v.get("severity") == "CRITICAL" for v in viols):
|
|
197
|
+
conformance = "Partially Supports"
|
|
198
|
+
remarks = f"{len(viols)} minor defect(s) detected: " + "; ".join(v.get("message", "") for v in viols[:2])
|
|
199
|
+
partially_count += 1
|
|
200
|
+
else:
|
|
201
|
+
conformance = "Does Not Support"
|
|
202
|
+
remarks = f"{len(viols)} violation(s) identified. Sample: " + "; ".join(v.get("message", "") for v in viols[:3])
|
|
203
|
+
not_support_count += 1
|
|
204
|
+
|
|
205
|
+
assessed_table.append({
|
|
206
|
+
"wcag_id": cid,
|
|
207
|
+
"name": c["name"],
|
|
208
|
+
"level": c["level"],
|
|
209
|
+
"section_508": c["section_508"],
|
|
210
|
+
"en_301_549": c["en_301_549"],
|
|
211
|
+
"conformance": conformance,
|
|
212
|
+
"remarks": remarks,
|
|
213
|
+
"violations_count": len(viols),
|
|
214
|
+
"samples": viols[:3],
|
|
215
|
+
})
|
|
216
|
+
|
|
217
|
+
total = len(assessed_table)
|
|
218
|
+
conformance_rate = round((supports_count + (0.5 * partially_count)) / total * 100, 1)
|
|
219
|
+
|
|
220
|
+
return {
|
|
221
|
+
"vpat_version": "2.5 (Revised Section 508 & EN 301 549 Edition)",
|
|
222
|
+
"report_date": datetime.now(timezone.utc).strftime("%Y-%m-%d"),
|
|
223
|
+
"product_name": product_name,
|
|
224
|
+
"product_version": product_version,
|
|
225
|
+
"vendor": vendor,
|
|
226
|
+
"evaluation_methods": "Automated AST inspection, W3C WCAG 2.2 Linter (tools/wcag_audit.py), and DOM traversal.",
|
|
227
|
+
"conformance_summary": {
|
|
228
|
+
"total_criteria": total,
|
|
229
|
+
"supports": supports_count,
|
|
230
|
+
"partially_supports": partially_count,
|
|
231
|
+
"does_not_support": not_support_count,
|
|
232
|
+
"conformance_rate_pct": conformance_rate,
|
|
233
|
+
},
|
|
234
|
+
"criteria": assessed_table,
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
# ==============================================================================
|
|
239
|
+
# EXPORTERS (MARKDOWN & HTML)
|
|
240
|
+
# ==============================================================================
|
|
241
|
+
|
|
242
|
+
def export_vpat_markdown(vpat_data: Dict[str, Any]) -> str:
|
|
243
|
+
"""Renders VPAT report in official Markdown format."""
|
|
244
|
+
lines = [
|
|
245
|
+
"# Accessibility Conformance Report (VPAT® Version 2.5)",
|
|
246
|
+
"",
|
|
247
|
+
f"**Product Name:** {vpat_data['product_name']} ",
|
|
248
|
+
f"**Product Version:** {vpat_data['product_version']} ",
|
|
249
|
+
f"**Vendor / Organization:** {vpat_data['vendor']} ",
|
|
250
|
+
f"**Report Date:** {vpat_data['report_date']} ",
|
|
251
|
+
f"**Evaluation Methods:** {vpat_data['evaluation_methods']} ",
|
|
252
|
+
"",
|
|
253
|
+
"## Applicable Standards & Guidelines",
|
|
254
|
+
"- **Web Content Accessibility Guidelines (WCAG) 2.2** (Levels A and AA)",
|
|
255
|
+
"- **Revised Section 508 Standards** (US Access Board)",
|
|
256
|
+
"- **EN 301 549 Accessibility Requirements for ICT Products and Services** (European Standard)",
|
|
257
|
+
"",
|
|
258
|
+
"## Conformance Terms",
|
|
259
|
+
"- **Supports:** The functionality has at least one method that addresses the criterion without known defects.",
|
|
260
|
+
"- **Partially Supports:** Some functionality does not meet the criterion.",
|
|
261
|
+
"- **Does Not Support:** The majority of functionality does not meet the criterion.",
|
|
262
|
+
"- **Not Applicable:** The criterion is not relevant to the product.",
|
|
263
|
+
"",
|
|
264
|
+
f"### Executive Summary Conformance Rate: **{vpat_data['conformance_summary']['conformance_rate_pct']}%**",
|
|
265
|
+
f"- Fully Supports: `{vpat_data['conformance_summary']['supports']}` criteria",
|
|
266
|
+
f"- Partially Supports: `{vpat_data['conformance_summary']['partially_supports']}` criteria",
|
|
267
|
+
f"- Does Not Support: `{vpat_data['conformance_summary']['does_not_support']}` criteria",
|
|
268
|
+
"",
|
|
269
|
+
"---",
|
|
270
|
+
"",
|
|
271
|
+
"## Table 1: Success Criteria, Level A & AA (WCAG 2.2 / Section 508 / EN 301 549)",
|
|
272
|
+
"",
|
|
273
|
+
"| Criteria | Level | Section 508 Chapter 5 | EN 301 549 Clause 9 | Conformance Level | Remarks and Explanations |",
|
|
274
|
+
"| :--- | :---: | :--- | :--- | :---: | :--- |",
|
|
275
|
+
]
|
|
276
|
+
|
|
277
|
+
for c in vpat_data["criteria"]:
|
|
278
|
+
crit_title = f"**{c['wcag_id']} {c['name']}**"
|
|
279
|
+
lines.append(
|
|
280
|
+
f"| {crit_title} | Level {c['level']} | {c['section_508']} | {c['en_301_549']} | **{c['conformance']}** | {c['remarks']} |"
|
|
281
|
+
)
|
|
282
|
+
|
|
283
|
+
lines.append("")
|
|
284
|
+
lines.append("---")
|
|
285
|
+
lines.append("*Report generated automatically via Synapse Hub Enterprise Accessibility Sentinel (`tools/vpat_exporter.py`).*")
|
|
286
|
+
return "\n".join(lines)
|
|
287
|
+
|
|
288
|
+
|
|
289
|
+
def export_vpat_html(vpat_data: Dict[str, Any]) -> str:
|
|
290
|
+
"""Renders VPAT report in standalone styled HTML format."""
|
|
291
|
+
rate = vpat_data["conformance_summary"]["conformance_rate_pct"]
|
|
292
|
+
rate_color = "#10b981" if rate >= 85 else ("#f59e0b" if rate >= 65 else "#ef4444")
|
|
293
|
+
|
|
294
|
+
rows_html = []
|
|
295
|
+
for c in vpat_data["criteria"]:
|
|
296
|
+
bg_col = "#ecfdf5" if c["conformance"] == "Supports" else ("#fffbeb" if c["conformance"] == "Partially Supports" else "#fef2f2")
|
|
297
|
+
badge_col = "#047857" if c["conformance"] == "Supports" else ("#b45309" if c["conformance"] == "Partially Supports" else "#b91c1c")
|
|
298
|
+
|
|
299
|
+
rows_html.append(f"""
|
|
300
|
+
<tr style="background-color: {bg_col};">
|
|
301
|
+
<td style="padding: 10px; border: 1px solid #e5e7eb;"><strong>{c['wcag_id']} {c['name']}</strong></td>
|
|
302
|
+
<td style="padding: 10px; border: 1px solid #e5e7eb; text-align: center;">Level {c['level']}</td>
|
|
303
|
+
<td style="padding: 10px; border: 1px solid #e5e7eb; font-size: 13px;">{c['section_508']}</td>
|
|
304
|
+
<td style="padding: 10px; border: 1px solid #e5e7eb; font-size: 13px;">{c['en_301_549']}</td>
|
|
305
|
+
<td style="padding: 10px; border: 1px solid #e5e7eb; text-align: center;">
|
|
306
|
+
<span style="display: inline-block; padding: 4px 8px; border-radius: 4px; font-weight: bold; font-size: 12px; color: white; background-color: {badge_col};">
|
|
307
|
+
{c['conformance']}
|
|
308
|
+
</span>
|
|
309
|
+
</td>
|
|
310
|
+
<td style="padding: 10px; border: 1px solid #e5e7eb; font-size: 13px;">{c['remarks']}</td>
|
|
311
|
+
</tr>
|
|
312
|
+
""")
|
|
313
|
+
|
|
314
|
+
return f"""<!DOCTYPE html>
|
|
315
|
+
<html lang="en">
|
|
316
|
+
<head>
|
|
317
|
+
<meta charset="UTF-8">
|
|
318
|
+
<title>VPAT® 2.5 - {vpat_data['product_name']}</title>
|
|
319
|
+
<style>
|
|
320
|
+
body {{ font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; line-height: 1.5; margin: 30px; color: #1f2937; }}
|
|
321
|
+
h1 {{ color: #111827; }}
|
|
322
|
+
.meta-box {{ background: #f3f4f6; border-radius: 8px; padding: 15px 20px; margin-bottom: 25px; }}
|
|
323
|
+
.scorecard {{ display: inline-block; font-size: 28px; font-weight: bold; color: {rate_color}; }}
|
|
324
|
+
table {{ width: 100%; border-collapse: collapse; margin-top: 20px; }}
|
|
325
|
+
th {{ background: #1f2937; color: white; padding: 12px; text-align: left; font-size: 14px; border: 1px solid #1f2937; }}
|
|
326
|
+
</style>
|
|
327
|
+
</head>
|
|
328
|
+
<body>
|
|
329
|
+
<h1>Accessibility Conformance Report (VPAT® 2.5)</h1>
|
|
330
|
+
<div class="meta-box">
|
|
331
|
+
<p><strong>Product:</strong> {vpat_data['product_name']} (v{vpat_data['product_version']}) | <strong>Date:</strong> {vpat_data['report_date']}</p>
|
|
332
|
+
<p><strong>Evaluation Standards:</strong> WCAG 2.2 (A/AA), Revised Section 508, EN 301 549</p>
|
|
333
|
+
<p><strong>Conformance Rating:</strong> <span class="scorecard">{rate}%</span> ({vpat_data['conformance_summary']['supports']} Supports / {vpat_data['conformance_summary']['partially_supports']} Partial / {vpat_data['conformance_summary']['does_not_support']} Does Not Support)</p>
|
|
334
|
+
</div>
|
|
335
|
+
<table>
|
|
336
|
+
<thead>
|
|
337
|
+
<tr>
|
|
338
|
+
<th>Success Criteria</th>
|
|
339
|
+
<th>Level</th>
|
|
340
|
+
<th>Section 508</th>
|
|
341
|
+
<th>EN 301 549</th>
|
|
342
|
+
<th>Conformance Level</th>
|
|
343
|
+
<th>Remarks and Explanations</th>
|
|
344
|
+
</tr>
|
|
345
|
+
</thead>
|
|
346
|
+
<tbody>
|
|
347
|
+
{"".join(rows_html)}
|
|
348
|
+
</tbody>
|
|
349
|
+
</table>
|
|
350
|
+
</body>
|
|
351
|
+
</html>"""
|
|
352
|
+
|
|
353
|
+
|
|
354
|
+
# ==============================================================================
|
|
355
|
+
# CLI HANDLER
|
|
356
|
+
# ==============================================================================
|
|
357
|
+
|
|
358
|
+
def main():
|
|
359
|
+
parser = argparse.ArgumentParser(
|
|
360
|
+
description="Synapse Hub Section 508 & EN 301 549 VPAT Exporter",
|
|
361
|
+
formatter_class=argparse.RawDescriptionHelpFormatter,
|
|
362
|
+
)
|
|
363
|
+
parser.add_argument("--url", help="Target URL to fetch HTML and audit")
|
|
364
|
+
parser.add_argument("--html-file", help="Path to local HTML file to inspect")
|
|
365
|
+
parser.add_argument("--input", help="Path to pre-existing wcag_audit JSON results file")
|
|
366
|
+
parser.add_argument("--format", choices=["md", "html", "json"], default="md", help="Export format (md, html, json)")
|
|
367
|
+
parser.add_argument("--out", help="Output file path (defaults to stdout)")
|
|
368
|
+
parser.add_argument("--out-md", help="Shortcut to write markdown directly to specified file")
|
|
369
|
+
parser.add_argument("--product-name", default="Enterprise Web Application", help="Product name for the VPAT report")
|
|
370
|
+
parser.add_argument("--product-version", default="1.0.0", help="Product version for the VPAT report")
|
|
371
|
+
parser.add_argument("--gate", action="store_true", help="Exit code 1 if any Level A/AA criteria is 'Does Not Support'")
|
|
372
|
+
|
|
373
|
+
args = parser.parse_args()
|
|
374
|
+
|
|
375
|
+
violations = []
|
|
376
|
+
|
|
377
|
+
if args.input:
|
|
378
|
+
with open(args.input, "r", encoding="utf-8") as f:
|
|
379
|
+
data = json.load(f)
|
|
380
|
+
violations = data if isinstance(data, list) else data.get("violations", [])
|
|
381
|
+
elif args.html_file:
|
|
382
|
+
with open(args.html_file, "r", encoding="utf-8") as f:
|
|
383
|
+
html = f.read()
|
|
384
|
+
violations = audit_html_source(html)
|
|
385
|
+
elif args.url:
|
|
386
|
+
import urllib.request
|
|
387
|
+
req = urllib.request.Request(args.url, headers={"User-Agent": "Synapse-Hub-VPAT/4.3.1"})
|
|
388
|
+
with urllib.request.urlopen(req, timeout=10) as resp:
|
|
389
|
+
html = resp.read().decode("utf-8", errors="ignore")
|
|
390
|
+
violations = audit_html_source(html)
|
|
391
|
+
|
|
392
|
+
vpat_data = compile_vpat_assessment(
|
|
393
|
+
violations,
|
|
394
|
+
product_name=args.product_name,
|
|
395
|
+
product_version=args.product_version,
|
|
396
|
+
)
|
|
397
|
+
|
|
398
|
+
fmt = "md"
|
|
399
|
+
if args.out_md:
|
|
400
|
+
fmt = "md"
|
|
401
|
+
out_path = args.out_md
|
|
402
|
+
else:
|
|
403
|
+
fmt = args.format
|
|
404
|
+
out_path = args.out
|
|
405
|
+
|
|
406
|
+
if fmt == "md":
|
|
407
|
+
rendered = export_vpat_markdown(vpat_data)
|
|
408
|
+
elif fmt == "html":
|
|
409
|
+
rendered = export_vpat_html(vpat_data)
|
|
410
|
+
else:
|
|
411
|
+
rendered = json.dumps(vpat_data, indent=2, ensure_ascii=False)
|
|
412
|
+
|
|
413
|
+
if out_path:
|
|
414
|
+
with open(out_path, "w", encoding="utf-8") as f:
|
|
415
|
+
f.write(rendered)
|
|
416
|
+
print(f"✅ Exported VPAT 2.5 ({fmt.upper()}) report to {out_path}")
|
|
417
|
+
else:
|
|
418
|
+
print(rendered)
|
|
419
|
+
|
|
420
|
+
if args.gate and vpat_data["conformance_summary"]["does_not_support"] > 0:
|
|
421
|
+
print(f"🚨 Quality Gate Failed: {vpat_data['conformance_summary']['does_not_support']} criteria 'Does Not Support'!", file=sys.stderr)
|
|
422
|
+
return 1
|
|
423
|
+
|
|
424
|
+
return 0
|
|
425
|
+
|
|
426
|
+
|
|
427
|
+
if __name__ == "__main__":
|
|
428
|
+
sys.exit(main())
|
package/tools/welcome_page.py
CHANGED
|
@@ -47,8 +47,8 @@ def get_hub_metadata() -> Dict[str, Any]:
|
|
|
47
47
|
"""Retrieves version and catalog count from skills_manifest.json."""
|
|
48
48
|
manifest_path = os.path.join(HUB_ROOT, "skills_manifest.json")
|
|
49
49
|
meta = {
|
|
50
|
-
"version": "4.
|
|
51
|
-
"totalSkills":
|
|
50
|
+
"version": "4.4.1",
|
|
51
|
+
"totalSkills": 57,
|
|
52
52
|
"author": "Thế Vị (@TeeVee98)",
|
|
53
53
|
"repo": "https://github.com/TeeVee98/Synapse-Hub"
|
|
54
54
|
}
|
|
@@ -115,7 +115,7 @@ def generate_welcome_html(target_repo: Optional[str] = None, stack_info: Optiona
|
|
|
115
115
|
<body style="font-family:sans-serif;background:#0f172a;color:#f8fafc;padding:40px;text-align:center;">
|
|
116
116
|
<h1>🛡️ Synapse Hub Enterprise QA v{meta.get('version', '2.4.0')}</h1>
|
|
117
117
|
<p>{hero_pill_content}</p>
|
|
118
|
-
<p>Total Standardized Skills: {meta.get('totalSkills',
|
|
118
|
+
<p>Total Standardized Skills: {meta.get('totalSkills', 57)}</p>
|
|
119
119
|
<p>Author: {meta.get('author', 'Thế Vị (@TeeVee98)')}</p>
|
|
120
120
|
</body></html>"""
|
|
121
121
|
|
|
@@ -125,7 +125,7 @@ def generate_welcome_html(target_repo: Optional[str] = None, stack_info: Optiona
|
|
|
125
125
|
.replace("__NOW_STR__", now_str)
|
|
126
126
|
.replace("__VERSION__", str(meta.get("version", "2.4.0")))
|
|
127
127
|
.replace("__AUTHOR__", str(meta.get("author", "Thế Vị (@TeeVee98)")))
|
|
128
|
-
.replace("__TOTAL_SKILLS__", str(meta.get("totalSkills",
|
|
128
|
+
.replace("__TOTAL_SKILLS__", str(meta.get("totalSkills", 57)))
|
|
129
129
|
.replace("__REPO__", str(meta.get("repo", "https://github.com/TeeVee98/Synapse-Hub")))
|
|
130
130
|
)
|
|
131
131
|
return rendered_html
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
trigger: always_on
|
|
3
|
-
description: Context-aware progressive stack router and token-minimal rule/skill loader.
|
|
4
|
-
profiles: [core, full]
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Context-Aware Stack Router & Token-Minimal Loader (Boost B2)
|
|
8
|
-
|
|
9
|
-
> Added to Synapse-Hub `.agents/rules/` to minimize token consumption (~4,000 tokens/turn) and provide universal cross-project applicability.
|
|
10
|
-
|
|
11
|
-
## 1. Lazy-Loading Rules & Skills (Load Only What the Project Needs)
|
|
12
|
-
At session initialization, AI agents **scan the workspace root to a maximum depth of 2 levels** (or execute automated routing via `python tools/rules_router.py` / `agent-qa rules-router`) and load exclusively the rule and skill subset matching the active project stack (do NOT load all 56 skills or irrelevant platform rules):
|
|
13
|
-
|
|
14
|
-
* **Web / API (`playwright.config.*`, `cypress.config.*`, `openapi.*`, `pytest`, `jest`):** Load only `mandatory-playwright-live.md` (if using Playwright) + `clean-pom-crafter` + `api-network-mocking-interception`.
|
|
15
|
-
* **Mobile (`appium`, `*.xcodeproj`, `build.gradle`):** Load only `mobile_appium_rules.md` + `clean-pom-crafter` (following SOM standard). Omit `mandatory-playwright-live.md`.
|
|
16
|
-
* **Performance (`k6`, `*.jmx`, `locustfile.py`):** Load only `performance_testing_rules.md` + `backend-load-and-stress-patterns`.
|
|
17
|
-
* **Security (`burp`, `zap`, `nuclei`, pentest/DAST):** Load only `security_testing_rules.md` + `security-dast-sentinel` + `skillspector-security-guard`.
|
|
18
|
-
|
|
19
|
-
## 2. Token-Minimal Progressive Router (`tools/rules_router.py`)
|
|
20
|
-
AI agents can trigger the automated router to inspect and obtain the minimal configuration:
|
|
21
|
-
```bash
|
|
22
|
-
python tools/rules_router.py --summary
|
|
23
|
-
# Output: [RULES-ROUTER] Stacks: playwright,git | Rules: 5 | Saved: 2,635 tokens/turn (40.5%)
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## 3. Adaptive Verification (Fast Mode vs Full Gate)
|
|
27
|
-
* **Fast Mode (Quick fixes / authoring 1–2 test cases):** Perform static validation (0 hard sleeps, 0 secrets, verified `assert` statements) and execute the native test runner for **strictly the modified file**, achieving `Exit Code 0`.
|
|
28
|
-
* **Full Gate (PR Finalization / Release Acceptance):**
|
|
29
|
-
* If the project contains `tools/verify_all.py` (full Synapse-Hub environment): execute `python3 tools/verify_all.py`.
|
|
30
|
-
* If the target is an external repository without `tools/verify_all.py`: execute the complete test suite using the project's native command defined in `package.json` / `pyproject.toml` / `Makefile`, followed by credential leak scanning.
|
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: github-actions-templates
|
|
3
|
-
description: "Create production-ready GitHub Actions workflows for automated test suites and CI/CD. Use when wiring test pipelines, matrix shards, or quality gates into GitHub Actions."
|
|
4
|
-
category: architecture_and_analysis
|
|
5
|
-
version: "2.0.0"
|
|
6
|
-
policies:
|
|
7
|
-
network: none
|
|
8
|
-
shell: none
|
|
9
|
-
filesystem: workspace-sandbox
|
|
10
|
-
---
|
|
11
|
-
# GitHub Actions CI/CD Patterns for Test Automation
|
|
12
|
-
|
|
13
|
-
> **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## 1. Trigger & Activation
|
|
18
|
-
|
|
19
|
-
- **Trigger Clause:** Use when configuring continuous integration pipelines, setting up multi-OS and multi-version test execution matrices, wiring quality gates into GitHub Actions, or generating automated test report artifacts.
|
|
20
|
-
- **Activation Scope:**
|
|
21
|
-
- Automated test suites (Playwright, Pytest, Katalon, Newman).
|
|
22
|
-
- Parallel matrix sharding across runners and execution stages.
|
|
23
|
-
- Quality Gate Definition of Done (DoD) verification.
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## 2. Non-Goals & Boundary Constraints
|
|
28
|
-
|
|
29
|
-
- **What NOT to do:**
|
|
30
|
-
- Do NOT use unpinned mutable tags (`@v4`, `@main`) for third-party actions; always pin to immutable 40-character commit SHAs.
|
|
31
|
-
- Do NOT hardcode credentials or tokens in workflow files; inject secrets exclusively through repository secrets (`${{ secrets.TEST_TOKEN }}`).
|
|
32
|
-
- Do NOT retain video and trace artifacts indefinitely; cap retention between 7 and 14 days.
|
|
33
|
-
- **Sibling Skill Boundaries:**
|
|
34
|
-
- `verification-before-completion`: Enforces DoD evidence collection prior to declaring task completion.
|
|
35
|
-
- `github-actions-templates` (this skill): Provides workflow blueprints, matrix sharding, and supply-chain-secure pipeline definitions.
|
|
36
|
-
|
|
37
|
-
---
|
|
38
|
-
|
|
39
|
-
## 3. Ordered Execution Workflow
|
|
40
|
-
|
|
41
|
-
### Phase 1: Workflow Configuration & Matrix Architecture
|
|
42
|
-
|
|
43
|
-
Author or update the CI/CD pipeline template (see reference `examples/matrix_test_pipeline.yml`).
|
|
44
|
-
|
|
45
|
-
<!-- classification: illustrative -->
|
|
46
|
-
```yaml
|
|
47
|
-
# Supply chain security: Pin actions to immutable full 40-character commit SHAs to mitigate tag hijacking and malicious upstream mutation risks.
|
|
48
|
-
name: Enterprise Automated E2E Test Suite
|
|
49
|
-
|
|
50
|
-
on:
|
|
51
|
-
push:
|
|
52
|
-
branches: [ main, develop ]
|
|
53
|
-
pull_request:
|
|
54
|
-
branches: [ main ]
|
|
55
|
-
|
|
56
|
-
jobs:
|
|
57
|
-
test-matrix:
|
|
58
|
-
runs-on: ubuntu-latest
|
|
59
|
-
strategy:
|
|
60
|
-
fail-fast: false
|
|
61
|
-
matrix:
|
|
62
|
-
shard: [1/4, 2/4, 3/4, 4/4]
|
|
63
|
-
|
|
64
|
-
steps:
|
|
65
|
-
- name: Checkout Code
|
|
66
|
-
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
|
67
|
-
|
|
68
|
-
- name: Setup Node.js
|
|
69
|
-
uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a # v4.2.0
|
|
70
|
-
with:
|
|
71
|
-
node-version: 20
|
|
72
|
-
cache: 'npm'
|
|
73
|
-
|
|
74
|
-
- name: Install Dependencies
|
|
75
|
-
run: npm ci
|
|
76
|
-
|
|
77
|
-
- name: Install Playwright Browsers
|
|
78
|
-
run: npx playwright install --with-deps chromium
|
|
79
|
-
|
|
80
|
-
- name: Run Sharded Playwright Tests
|
|
81
|
-
run: npx playwright test --shard=${{ matrix.shard }}
|
|
82
|
-
|
|
83
|
-
- name: Upload Test Report & Screenshots
|
|
84
|
-
if: always()
|
|
85
|
-
uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
|
|
86
|
-
with:
|
|
87
|
-
name: playwright-report-shard-${{ strategy.job-index }}
|
|
88
|
-
path: playwright-report/
|
|
89
|
-
retention-days: 14
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
### Phase 2: Security & Supply Chain Invariants
|
|
93
|
-
|
|
94
|
-
1. **Dependency Pinning:** Pin all third-party GitHub Actions to 40-character commit SHAs with version comments to protect against compromised release tags.
|
|
95
|
-
2. **Secret Masking:** Never echo secrets into workflow steps; pass them as environment variables mapped from GitHub Secrets.
|
|
96
|
-
3. **Concurrency Governance:** Cancel stale runs on pull request updates:
|
|
97
|
-
`concurrency: { group: ${{ github.workflow }}-${{ github.ref }}, cancel-in-progress: true }`.
|
|
98
|
-
|
|
99
|
-
---
|
|
100
|
-
|
|
101
|
-
## 4. Verification Points & DoD
|
|
102
|
-
|
|
103
|
-
1. **Syntax Validation:** Workflow passes YAML linting and GitHub Actions schema checks.
|
|
104
|
-
2. **Commit SHA Pinning:** All `uses:` directives reference 40-character commit hashes with supply chain risk disclosures.
|
|
105
|
-
3. **Secret Protection:** 0 exposed secrets in step definitions, run scripts, or job logs.
|
|
106
|
-
4. **Execution Verification:** Pipeline successfully executes test matrix and uploads artifacts upon completion.
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
## 5. Handoff Protocol
|
|
111
|
-
|
|
112
|
-
- **Deliverables:** Production-ready `.github/workflows/*.yml` workflow definitions and example templates in `examples/`.
|
|
113
|
-
- **Next Subagent:** Pass to `test-runner` for local execution or `quality-gatekeeper` for CI/CD integration acceptance.
|
|
114
|
-
- **Output Format:** Valid GitHub Actions YAML syntax adhering to enterprise security baselines.
|
package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml
DELETED
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
# Supply chain security: Pin actions to immutable full 40-character commit SHAs to mitigate tag hijacking and malicious upstream mutation risks.
|
|
2
|
-
name: Automated E2E Matrix
|
|
3
|
-
on: [push, pull_request]
|
|
4
|
-
jobs:
|
|
5
|
-
test:
|
|
6
|
-
runs-on: ubuntu-latest
|
|
7
|
-
steps:
|
|
8
|
-
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
|
9
|
-
- run: npx playwright test
|