@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,308 @@
|
|
|
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/watch_mode.py — Incremental Watch Mode & Real-Time Test Engineering HUD
|
|
8
|
+
----------------------------------------------------------------------------
|
|
9
|
+
Continuously monitors target repository files for code changes and triggers
|
|
10
|
+
near-instant (< 100ms) incremental verification:
|
|
11
|
+
1. UTF-8 No BOM validation
|
|
12
|
+
2. Forbidden machine absolute path scan
|
|
13
|
+
3. AST Static Defect / Fake-Pass Sentinel (Meta Infer-style)
|
|
14
|
+
4. POM & Test Impact Blast Radius Scoping
|
|
15
|
+
|
|
16
|
+
Usage:
|
|
17
|
+
python3 tools/watch_mode.py [target]
|
|
18
|
+
python3 tools/watch_mode.py [target] --debounce 0.8
|
|
19
|
+
python3 tools/watch_mode.py [target] --once
|
|
20
|
+
"""
|
|
21
|
+
|
|
22
|
+
import os
|
|
23
|
+
import sys
|
|
24
|
+
import time
|
|
25
|
+
import re
|
|
26
|
+
import argparse
|
|
27
|
+
from datetime import datetime
|
|
28
|
+
from typing import Dict, List, Optional, Tuple, Any
|
|
29
|
+
|
|
30
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
31
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
32
|
+
try:
|
|
33
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
34
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
35
|
+
except (OSError, AttributeError):
|
|
36
|
+
sys.stderr.flush()
|
|
37
|
+
|
|
38
|
+
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
|
|
39
|
+
HUB_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
|
|
40
|
+
|
|
41
|
+
WATCH_EXTENSIONS = (
|
|
42
|
+
".groovy", ".tc", ".ts", ".js", ".py", ".glbl", ".json", ".feature", ".md"
|
|
43
|
+
)
|
|
44
|
+
|
|
45
|
+
IGNORED_DIRS = {
|
|
46
|
+
".git", ".gradle", "node_modules", "allure-results", "Screenshots",
|
|
47
|
+
"Reports", "reports", "TestReports", "testreports", "bin", "Libs", ".settings",
|
|
48
|
+
"graphify-out", "__pycache__", "agent_qa.egg-info", "dist", "build", ".pytest_cache",
|
|
49
|
+
"claude-ecosystem-repos", "external_repos", "teamwork"
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
IGNORED_FILES = {
|
|
53
|
+
".project", ".classpath", ".DS_Store", "memory_cache.db",
|
|
54
|
+
"verify_all.py", "git_pre_commit_guard.py", "agent_canary.py", "watch_mode.py",
|
|
55
|
+
"repo_map.txt", "repo_map.json", "PROJECT_HEALTH_REPORT.md", "PROJECT_STATE.md"
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
FORBIDDEN_PATH_PATTERNS = [
|
|
59
|
+
(re.compile(r'file:///[a-zA-Z]:', re.IGNORECASE), "Machine file URI (file:///...)"),
|
|
60
|
+
(re.compile(r'\b[a-zA-Z]:\\Users\\[a-zA-Z0-9_\-]+\\', re.IGNORECASE), "Windows User directory path"),
|
|
61
|
+
(re.compile(r'\b/Users/[a-zA-Z0-9_\-]+/', re.IGNORECASE), "macOS/Unix User directory path"),
|
|
62
|
+
]
|
|
63
|
+
|
|
64
|
+
# ANSI colors
|
|
65
|
+
RESET = "\033[0m"
|
|
66
|
+
BOLD = "\033[1m"
|
|
67
|
+
GREEN = "\033[92m"
|
|
68
|
+
RED = "\033[91m"
|
|
69
|
+
YELLOW = "\033[93m"
|
|
70
|
+
CYAN = "\033[96m"
|
|
71
|
+
MAGENTA = "\033[95m"
|
|
72
|
+
DIM = "\033[2m"
|
|
73
|
+
BG_BLUE = "\033[44m"
|
|
74
|
+
BG_DARK = "\033[100m"
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
def check_inactivity(last_activity_time: float, threshold_sec: float) -> Tuple[bool, float]:
|
|
78
|
+
"""
|
|
79
|
+
Checks if a monitored process or run has been silent longer than the threshold.
|
|
80
|
+
Inspired by agentblazo/blazo 'no_activity' detection rule.
|
|
81
|
+
"""
|
|
82
|
+
if threshold_sec <= 0:
|
|
83
|
+
return False, 0.0
|
|
84
|
+
idle = time.time() - last_activity_time
|
|
85
|
+
return idle > threshold_sec, idle
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
def format_event_badge(badge_type: str, status: str = "INFO", duration_ms: Optional[float] = None) -> str:
|
|
89
|
+
"""
|
|
90
|
+
Formats compact, colorful event badges for the Live TUI HUD.
|
|
91
|
+
Inspired by agentblazo/blazo TUI event badges.
|
|
92
|
+
"""
|
|
93
|
+
dur_str = f" {duration_ms}ms" if duration_ms is not None else ""
|
|
94
|
+
if status == "PASS":
|
|
95
|
+
color = GREEN
|
|
96
|
+
elif status == "FAIL" or status == "ERR":
|
|
97
|
+
color = RED
|
|
98
|
+
elif status == "WARN":
|
|
99
|
+
color = YELLOW
|
|
100
|
+
else:
|
|
101
|
+
color = CYAN
|
|
102
|
+
|
|
103
|
+
return f"{color}[{badge_type.upper()}{dur_str}]{RESET}"
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
def check_file_bom(file_path: str) -> bool:
|
|
107
|
+
"""Returns True if file has UTF-8 BOM bytes."""
|
|
108
|
+
try:
|
|
109
|
+
with open(file_path, "rb") as fp:
|
|
110
|
+
return fp.read(3) == b"\xef\xbb\xbf"
|
|
111
|
+
except OSError as err:
|
|
112
|
+
sys.stderr.write(f"[WATCH-MODE] Warning checking BOM for {file_path}: {err}\n")
|
|
113
|
+
return False
|
|
114
|
+
|
|
115
|
+
|
|
116
|
+
def check_forbidden_paths(file_path: str) -> List[Tuple[int, str]]:
|
|
117
|
+
"""Returns list of (line_no, description) of forbidden absolute machine paths."""
|
|
118
|
+
fname = os.path.basename(file_path)
|
|
119
|
+
if fname in IGNORED_FILES:
|
|
120
|
+
return []
|
|
121
|
+
|
|
122
|
+
violations = []
|
|
123
|
+
try:
|
|
124
|
+
with open(file_path, "r", encoding="utf-8", errors="ignore") as fp:
|
|
125
|
+
for line_no, line in enumerate(fp, 1):
|
|
126
|
+
for pattern, desc in FORBIDDEN_PATH_PATTERNS:
|
|
127
|
+
if pattern.search(line):
|
|
128
|
+
violations.append((line_no, desc))
|
|
129
|
+
except (OSError, UnicodeDecodeError):
|
|
130
|
+
return []
|
|
131
|
+
return violations
|
|
132
|
+
|
|
133
|
+
|
|
134
|
+
def run_incremental_linter(file_path: str, timeout: float = 30.0) -> Tuple[bool, str]:
|
|
135
|
+
"""Runs fast AST check on modified script with explicit timeout."""
|
|
136
|
+
infer_script = os.path.join(SCRIPT_DIR, "infer_linter.py")
|
|
137
|
+
if not os.path.exists(infer_script):
|
|
138
|
+
return True, "infer_linter not found"
|
|
139
|
+
|
|
140
|
+
try:
|
|
141
|
+
import subprocess
|
|
142
|
+
res = subprocess.run(
|
|
143
|
+
[sys.executable, infer_script, file_path],
|
|
144
|
+
stdout=subprocess.PIPE,
|
|
145
|
+
stderr=subprocess.PIPE,
|
|
146
|
+
text=True,
|
|
147
|
+
timeout=timeout
|
|
148
|
+
)
|
|
149
|
+
if res.returncode == 0:
|
|
150
|
+
return True, "Clean (0 AST Defects / 0 Fake Passes)"
|
|
151
|
+
else:
|
|
152
|
+
return False, res.stdout.strip() or res.stderr.strip()
|
|
153
|
+
except subprocess.TimeoutExpired:
|
|
154
|
+
return False, f"infer_linter timed out after {timeout} seconds"
|
|
155
|
+
except Exception as e:
|
|
156
|
+
return False, str(e)
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
def run_incremental_audit(file_path: str, target_dir: str) -> Dict[str, Any]:
|
|
160
|
+
"""Performs fast sub-100ms audit on a single changed file."""
|
|
161
|
+
start_t = time.perf_counter()
|
|
162
|
+
rel_path = os.path.relpath(file_path, target_dir)
|
|
163
|
+
results: Dict[str, Any] = {
|
|
164
|
+
"file": rel_path,
|
|
165
|
+
"bom_pass": True,
|
|
166
|
+
"path_pass": True,
|
|
167
|
+
"lint_pass": True,
|
|
168
|
+
"details": [],
|
|
169
|
+
"duration_ms": 0.0
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
# 1. BOM Check
|
|
173
|
+
if check_file_bom(file_path):
|
|
174
|
+
results["bom_pass"] = False
|
|
175
|
+
results["details"].append("UTF-8 BOM detected (Must be 100% UTF-8 No BOM)")
|
|
176
|
+
|
|
177
|
+
# 2. Path Portability Check
|
|
178
|
+
path_issues = check_forbidden_paths(file_path)
|
|
179
|
+
if path_issues:
|
|
180
|
+
results["path_pass"] = False
|
|
181
|
+
for lno, desc in path_issues:
|
|
182
|
+
results["details"].append(f"Line {lno}: {desc}")
|
|
183
|
+
|
|
184
|
+
# 3. Incremental AST Linter for test automation scripts (e.g. Scripts/ in target projects)
|
|
185
|
+
# Skip python unittests in hub tests/ directory
|
|
186
|
+
norm_rel = rel_path.replace("\\", "/")
|
|
187
|
+
is_target_script = norm_rel.startswith("Scripts/") or ("/Scripts/" in norm_rel)
|
|
188
|
+
if is_target_script and file_path.endswith((".groovy", ".ts", ".js", ".py")):
|
|
189
|
+
lint_ok, lint_msg = run_incremental_linter(file_path)
|
|
190
|
+
if not lint_ok:
|
|
191
|
+
results["lint_pass"] = False
|
|
192
|
+
results["details"].append(f"AST Linter: {lint_msg}")
|
|
193
|
+
|
|
194
|
+
results["duration_ms"] = round((time.perf_counter() - start_t) * 1000, 2)
|
|
195
|
+
return results
|
|
196
|
+
|
|
197
|
+
|
|
198
|
+
def print_hud_banner(target_dir: str):
|
|
199
|
+
print(f"\n{BOLD}{CYAN}======================================================================{RESET}")
|
|
200
|
+
print(f"{BOLD}{CYAN} ⚡ SYNAPSE-HUB REAL-TIME WATCH MODE SENTINEL (INCREMENTAL HUD) {RESET}")
|
|
201
|
+
print(f"{BOLD}{CYAN}======================================================================{RESET}")
|
|
202
|
+
print(f"{DIM}Watching directory : {RESET}{BOLD}{target_dir}{RESET}")
|
|
203
|
+
print(f"{DIM}Monitored types : {RESET}{CYAN}{', '.join(WATCH_EXTENSIONS)}{RESET}")
|
|
204
|
+
print(f"{DIM}Trigger checks : {RESET}UTF-8 No BOM, Absolute Paths, AST Fake-Pass Sentinel")
|
|
205
|
+
print(f"{DIM}Press {RESET}{BOLD}Ctrl+C{RESET}{DIM} to pause or stop watching.\n{RESET}")
|
|
206
|
+
|
|
207
|
+
|
|
208
|
+
def print_audit_result(res: Dict[str, Any], change_type: str = "MOD"):
|
|
209
|
+
timestamp = datetime.now().strftime("%H:%M:%S")
|
|
210
|
+
rel_path = res["file"]
|
|
211
|
+
duration = res["duration_ms"]
|
|
212
|
+
all_clean = res["bom_pass"] and res["path_pass"] and res["lint_pass"]
|
|
213
|
+
|
|
214
|
+
badge = format_event_badge(change_type, "PASS" if all_clean else "FAIL", duration)
|
|
215
|
+
if all_clean:
|
|
216
|
+
print(f"[{timestamp}] {badge} {GREEN}✓ PASS{RESET} {BOLD}{rel_path}{RESET}")
|
|
217
|
+
else:
|
|
218
|
+
print(f"[{timestamp}] {badge} {RED}✗ FAIL{RESET} {BOLD}{rel_path}{RESET}")
|
|
219
|
+
for d in res["details"]:
|
|
220
|
+
print(f" {RED}↳ {d}{RESET}")
|
|
221
|
+
|
|
222
|
+
|
|
223
|
+
def scan_file_states(target_dir: str) -> Dict[str, float]:
|
|
224
|
+
"""Scans all eligible files and records their mtime."""
|
|
225
|
+
file_states = {}
|
|
226
|
+
for root, dirs, files in os.walk(target_dir):
|
|
227
|
+
dirs[:] = [d for d in dirs if d not in IGNORED_DIRS]
|
|
228
|
+
for f in files:
|
|
229
|
+
if f.endswith(WATCH_EXTENSIONS):
|
|
230
|
+
full_path = os.path.join(root, f)
|
|
231
|
+
try:
|
|
232
|
+
file_states[full_path] = os.path.getmtime(full_path)
|
|
233
|
+
except OSError:
|
|
234
|
+
continue
|
|
235
|
+
return file_states
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
def watch_directory(target_dir: str, debounce: float = 0.8, run_once: bool = False, inactivity_timeout: float = 0.0) -> int:
|
|
239
|
+
"""Main watch loop with debouncing, live TUI event badges, and inactivity watchdog."""
|
|
240
|
+
target_dir = os.path.abspath(target_dir)
|
|
241
|
+
print_hud_banner(target_dir)
|
|
242
|
+
|
|
243
|
+
known_states = scan_file_states(target_dir)
|
|
244
|
+
print(f"{GREEN}● Watchdog active:{RESET} Indexed {len(known_states)} files. Ready for file changes...\n")
|
|
245
|
+
|
|
246
|
+
if run_once:
|
|
247
|
+
print(f"{CYAN}[ONCE MODE]{RESET} Executing one-time scan across {len(known_states)} indexed files...")
|
|
248
|
+
failures = 0
|
|
249
|
+
for fpath in sorted(known_states.keys()):
|
|
250
|
+
res = run_incremental_audit(fpath, target_dir)
|
|
251
|
+
if not (res["bom_pass"] and res["path_pass"] and res["lint_pass"]):
|
|
252
|
+
print_audit_result(res, change_type="AUDIT")
|
|
253
|
+
failures += 1
|
|
254
|
+
if failures == 0:
|
|
255
|
+
print(f"\n{GREEN}✅ [ALL PASS]{RESET} 100% of {len(known_states)} files passed incremental sentinel checks.")
|
|
256
|
+
return 0
|
|
257
|
+
else:
|
|
258
|
+
print(f"\n{RED}❌ [FAIL]{RESET} {failures} files violated Quality Gates.")
|
|
259
|
+
return 1
|
|
260
|
+
|
|
261
|
+
last_activity_time = time.time()
|
|
262
|
+
inactivity_alerted = False
|
|
263
|
+
|
|
264
|
+
try:
|
|
265
|
+
while True:
|
|
266
|
+
time.sleep(debounce)
|
|
267
|
+
current_states = scan_file_states(target_dir)
|
|
268
|
+
changed_files = []
|
|
269
|
+
|
|
270
|
+
for fpath, mtime in current_states.items():
|
|
271
|
+
if fpath not in known_states:
|
|
272
|
+
changed_files.append((fpath, "CREATE"))
|
|
273
|
+
elif mtime > known_states[fpath]:
|
|
274
|
+
changed_files.append((fpath, "MODIFY"))
|
|
275
|
+
|
|
276
|
+
known_states = current_states
|
|
277
|
+
|
|
278
|
+
if changed_files:
|
|
279
|
+
last_activity_time = time.time()
|
|
280
|
+
inactivity_alerted = False
|
|
281
|
+
for fpath, change_type in changed_files:
|
|
282
|
+
res = run_incremental_audit(fpath, target_dir)
|
|
283
|
+
print_audit_result(res, change_type=change_type)
|
|
284
|
+
elif inactivity_timeout > 0:
|
|
285
|
+
is_stuck, idle_sec = check_inactivity(last_activity_time, inactivity_timeout)
|
|
286
|
+
if is_stuck and not inactivity_alerted:
|
|
287
|
+
inactivity_alerted = True
|
|
288
|
+
badge = format_event_badge("STUCK", "WARN")
|
|
289
|
+
print(f"\n{badge} {YELLOW}No activity for {round(idle_sec, 1)}s (Inactivity threshold: {inactivity_timeout}s){RESET}\n")
|
|
290
|
+
|
|
291
|
+
except KeyboardInterrupt:
|
|
292
|
+
print(f"\n\n{YELLOW}🛑 [WATCH STOPPED]{RESET} Exiting Watch Mode Sentinel.")
|
|
293
|
+
return 0
|
|
294
|
+
|
|
295
|
+
|
|
296
|
+
def main():
|
|
297
|
+
parser = argparse.ArgumentParser(description="Real-Time Incremental Watch Mode Sentinel")
|
|
298
|
+
parser.add_argument("target", nargs="?", default=".", help="Directory to monitor (default: current directory)")
|
|
299
|
+
parser.add_argument("--debounce", type=float, default=0.8, help="Debounce interval in seconds (default: 0.8)")
|
|
300
|
+
parser.add_argument("--inactivity-timeout", type=float, default=0.0, help="Inactivity timeout in seconds to trigger stuck warning (default: 0 = disabled)")
|
|
301
|
+
parser.add_argument("--once", action="store_true", help="Run incremental scan once on all files and exit")
|
|
302
|
+
args = parser.parse_args()
|
|
303
|
+
|
|
304
|
+
return watch_directory(target_dir=args.target, debounce=args.debounce, run_once=args.once, inactivity_timeout=args.inactivity_timeout)
|
|
305
|
+
|
|
306
|
+
|
|
307
|
+
if __name__ == "__main__":
|
|
308
|
+
sys.exit(main())
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
tools/wcag_audit.py - Automated Accessibility (WCAG 2.2) Linter & Auditor
|
|
4
|
+
Operationalizes the .agents/skills/wcag-audit-patterns skill for Web & Enterprise Applications.
|
|
5
|
+
|
|
6
|
+
Checks WCAG 2.2 Level A and AA criteria:
|
|
7
|
+
- WCAG 1.1.1: Images missing alt attributes
|
|
8
|
+
- WCAG 1.3.1: Form controls missing labels or aria-label/aria-labelledby
|
|
9
|
+
- WCAG 1.3.1: Table headers structure
|
|
10
|
+
- WCAG 2.4.4: Links with empty text / accessible name
|
|
11
|
+
- WCAG 4.1.2: Buttons with empty text / accessible name
|
|
12
|
+
- WCAG 1.3.1: Heading hierarchy gaps (e.g., h1 to h3)
|
|
13
|
+
"""
|
|
14
|
+
|
|
15
|
+
import argparse
|
|
16
|
+
import os
|
|
17
|
+
import sys
|
|
18
|
+
import urllib.request
|
|
19
|
+
import urllib.parse
|
|
20
|
+
from html.parser import HTMLParser
|
|
21
|
+
|
|
22
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
23
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
24
|
+
try:
|
|
25
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
26
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
27
|
+
except Exception:
|
|
28
|
+
pass
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
class WCAGAuditor(HTMLParser):
|
|
32
|
+
def __init__(self):
|
|
33
|
+
super().__init__()
|
|
34
|
+
self.violations = []
|
|
35
|
+
self.tag_stack = []
|
|
36
|
+
self.current_heading_level = 0
|
|
37
|
+
self.in_button = False
|
|
38
|
+
self.button_text = ""
|
|
39
|
+
self.button_attrs = {}
|
|
40
|
+
self.in_a = False
|
|
41
|
+
self.a_text = ""
|
|
42
|
+
self.a_attrs = {}
|
|
43
|
+
self.has_main = False
|
|
44
|
+
self.elements_scanned = 0
|
|
45
|
+
|
|
46
|
+
def handle_starttag(self, tag, attrs):
|
|
47
|
+
self.elements_scanned += 1
|
|
48
|
+
attr_dict = dict(attrs)
|
|
49
|
+
|
|
50
|
+
# WCAG 1.1.1 Non-text Content (Images)
|
|
51
|
+
if tag == "img":
|
|
52
|
+
if "alt" not in attr_dict:
|
|
53
|
+
self.violations.append({
|
|
54
|
+
"criterion": "1.1.1 Non-text Content (Level A)",
|
|
55
|
+
"severity": "CRITICAL",
|
|
56
|
+
"element": f"<img src='{attr_dict.get('src', '')}'>",
|
|
57
|
+
"message": "Missing 'alt' attribute on image."
|
|
58
|
+
})
|
|
59
|
+
|
|
60
|
+
# WCAG 1.3.1 Info and Relationships (Form Controls)
|
|
61
|
+
if tag in ["input", "select", "textarea"]:
|
|
62
|
+
input_type = attr_dict.get("type", "text")
|
|
63
|
+
if input_type not in ["hidden", "submit", "button", "reset"]:
|
|
64
|
+
has_label = "aria-label" in attr_dict or "aria-labelledby" in attr_dict or "id" in attr_dict
|
|
65
|
+
if not has_label:
|
|
66
|
+
self.violations.append({
|
|
67
|
+
"criterion": "1.3.1 Info and Relationships / 4.1.2 (Level A)",
|
|
68
|
+
"severity": "HIGH",
|
|
69
|
+
"element": f"<{tag} type='{input_type}' name='{attr_dict.get('name', '')}'>",
|
|
70
|
+
"message": "Form control missing accessible name (no aria-label, aria-labelledby, or matching <label> id)."
|
|
71
|
+
})
|
|
72
|
+
|
|
73
|
+
# Heading hierarchy
|
|
74
|
+
if tag in ["h1", "h2", "h3", "h4", "h5", "h6"]:
|
|
75
|
+
level = int(tag[1])
|
|
76
|
+
if self.current_heading_level > 0 and level > self.current_heading_level + 1:
|
|
77
|
+
self.violations.append({
|
|
78
|
+
"criterion": "1.3.1 Info and Relationships (Level A)",
|
|
79
|
+
"severity": "MEDIUM",
|
|
80
|
+
"element": f"<{tag}>",
|
|
81
|
+
"message": f"Heading level skipped from h{self.current_heading_level} to h{level}."
|
|
82
|
+
})
|
|
83
|
+
self.current_heading_level = level
|
|
84
|
+
|
|
85
|
+
# Track Buttons
|
|
86
|
+
if tag == "button":
|
|
87
|
+
self.in_button = True
|
|
88
|
+
self.button_text = ""
|
|
89
|
+
self.button_attrs = attr_dict
|
|
90
|
+
|
|
91
|
+
# Track Anchors
|
|
92
|
+
if tag == "a":
|
|
93
|
+
self.in_a = True
|
|
94
|
+
self.a_text = ""
|
|
95
|
+
self.a_attrs = attr_dict
|
|
96
|
+
|
|
97
|
+
def handle_data(self, data):
|
|
98
|
+
if self.in_button:
|
|
99
|
+
self.button_text += data.strip()
|
|
100
|
+
if self.in_a:
|
|
101
|
+
self.a_text += data.strip()
|
|
102
|
+
|
|
103
|
+
def handle_endtag(self, tag):
|
|
104
|
+
if tag == "button" and self.in_button:
|
|
105
|
+
has_name = bool(self.button_text) or "aria-label" in self.button_attrs or "title" in self.button_attrs
|
|
106
|
+
if not has_name:
|
|
107
|
+
self.violations.append({
|
|
108
|
+
"criterion": "4.1.2 Name, Role, Value (Level A)",
|
|
109
|
+
"severity": "CRITICAL",
|
|
110
|
+
"element": "<button> (empty)",
|
|
111
|
+
"message": "Button has no accessible name (empty text, no aria-label, no title)."
|
|
112
|
+
})
|
|
113
|
+
self.in_button = False
|
|
114
|
+
|
|
115
|
+
if tag == "a" and self.in_a:
|
|
116
|
+
has_name = bool(self.a_text) or "aria-label" in self.a_attrs or "title" in self.a_attrs
|
|
117
|
+
href = self.a_attrs.get("href", "")
|
|
118
|
+
if href and not has_name:
|
|
119
|
+
self.violations.append({
|
|
120
|
+
"criterion": "2.4.4 Link Purpose (In Context) (Level A)",
|
|
121
|
+
"severity": "HIGH",
|
|
122
|
+
"element": f"<a href='{href}'> (empty)",
|
|
123
|
+
"message": "Link has no accessible text or aria-label."
|
|
124
|
+
})
|
|
125
|
+
self.in_a = False
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
def run_audit(target, is_url=False):
|
|
129
|
+
"""Executes a WCAG 2.2 accessibility audit against an HTML file or live web URL.
|
|
130
|
+
|
|
131
|
+
Args:
|
|
132
|
+
target: Filepath or URL pointing to HTML content.
|
|
133
|
+
is_url: True if target should be fetched over HTTP/HTTPS.
|
|
134
|
+
|
|
135
|
+
Returns:
|
|
136
|
+
The populated WCAGAuditor instance containing violations and stats.
|
|
137
|
+
|
|
138
|
+
Raises:
|
|
139
|
+
ValueError: If an insecure or invalid URL scheme is passed.
|
|
140
|
+
"""
|
|
141
|
+
auditor = WCAGAuditor()
|
|
142
|
+
if is_url:
|
|
143
|
+
parsed = urllib.parse.urlparse(target)
|
|
144
|
+
if parsed.scheme.lower() not in ("http", "https"):
|
|
145
|
+
raise ValueError(f"Invalid URL scheme '{parsed.scheme}': only http and https protocols are supported.")
|
|
146
|
+
req = urllib.request.Request(target, headers={'User-Agent': 'Mozilla/5.0 (WCAG-Audit-Bot)'})
|
|
147
|
+
with urllib.request.urlopen(req, timeout=15.0) as resp: # nosec B310
|
|
148
|
+
html = resp.read().decode('utf-8', errors='ignore')
|
|
149
|
+
else:
|
|
150
|
+
with open(target, 'r', encoding='utf-8', errors='ignore') as f:
|
|
151
|
+
html = f.read()
|
|
152
|
+
|
|
153
|
+
auditor.feed(html)
|
|
154
|
+
return auditor
|
|
155
|
+
|
|
156
|
+
|
|
157
|
+
def format_markdown_report(target, auditor):
|
|
158
|
+
"""Generates an executive WCAG 2.2 audit markdown report.
|
|
159
|
+
|
|
160
|
+
Args:
|
|
161
|
+
target: Target URL or file audited.
|
|
162
|
+
auditor: Populated WCAGAuditor instance.
|
|
163
|
+
|
|
164
|
+
Returns:
|
|
165
|
+
Markdown string containing compliance score, grade, and violation details.
|
|
166
|
+
"""
|
|
167
|
+
violations = auditor.violations
|
|
168
|
+
stats = {
|
|
169
|
+
"elements_scanned": auditor.elements_scanned,
|
|
170
|
+
"violations_found": len(violations),
|
|
171
|
+
"critical": sum(1 for v in violations if v["severity"] == "CRITICAL"),
|
|
172
|
+
"high": sum(1 for v in violations if v["severity"] == "HIGH"),
|
|
173
|
+
"medium": sum(1 for v in violations if v["severity"] == "MEDIUM")
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
# Score calculation
|
|
177
|
+
penalty = (stats["critical"] * 25) + (stats["high"] * 10) + (stats["medium"] * 5)
|
|
178
|
+
score = max(0, 100 - penalty)
|
|
179
|
+
grade = "PASS" if score >= 80 else "NEEDS REMEDIATION"
|
|
180
|
+
|
|
181
|
+
out = [
|
|
182
|
+
"# WCAG 2.2 Accessibility Audit Report",
|
|
183
|
+
f"**Target:** `{target}`",
|
|
184
|
+
f"**Elements Scanned:** {stats['elements_scanned']}",
|
|
185
|
+
f"**Violations Found:** {stats['violations_found']}",
|
|
186
|
+
f"**Accessibility Score:** {score}/100 - **[{grade}]**",
|
|
187
|
+
"",
|
|
188
|
+
"---",
|
|
189
|
+
"",
|
|
190
|
+
"## Violations Detail",
|
|
191
|
+
"",
|
|
192
|
+
"| Severity | Criterion | Element Snippet | Issue Description |",
|
|
193
|
+
"|---|---|---|---|"
|
|
194
|
+
]
|
|
195
|
+
|
|
196
|
+
if not violations:
|
|
197
|
+
out.append("| PASS | - | - | Zero WCAG 2.2 violations detected! Element tree is fully compliant. |")
|
|
198
|
+
else:
|
|
199
|
+
for v in violations:
|
|
200
|
+
out.append(f"| **{v['severity']}** | {v['criterion']} | `{v['element']}` | {v['message']} |")
|
|
201
|
+
|
|
202
|
+
out.append("")
|
|
203
|
+
out.append("---")
|
|
204
|
+
out.append("### Recommended Remediation Actions:")
|
|
205
|
+
out.append("1. Add descriptive `alt=\"...\"` attributes to all images.")
|
|
206
|
+
out.append("2. Add `aria-label=\"...\"` or explicit `<label for=\"...\">` bindings to form controls and icon buttons.")
|
|
207
|
+
out.append("3. Maintain strict heading hierarchy (h1 -> h2 -> h3).")
|
|
208
|
+
return "\n".join(out)
|
|
209
|
+
|
|
210
|
+
|
|
211
|
+
def main():
|
|
212
|
+
parser = argparse.ArgumentParser(description="Automated WCAG 2.2 Accessibility Auditor for Web & Enterprise Applications.")
|
|
213
|
+
parser.add_argument("target", help="HTML file path or URL to audit.")
|
|
214
|
+
parser.add_argument("--url", action="store_true", help="Treat target as a live URL.")
|
|
215
|
+
parser.add_argument("--output", "-o", help="Path to save markdown report.")
|
|
216
|
+
args = parser.parse_args()
|
|
217
|
+
|
|
218
|
+
if not args.url and not os.path.exists(args.target):
|
|
219
|
+
print(f"Error: File '{args.target}' does not exist.")
|
|
220
|
+
sys.exit(1)
|
|
221
|
+
|
|
222
|
+
print(f"[AUDIT] Running WCAG 2.2 Accessibility Audit on: {args.target}...")
|
|
223
|
+
auditor = run_audit(args.target, is_url=args.url)
|
|
224
|
+
report = format_markdown_report(args.target, auditor)
|
|
225
|
+
|
|
226
|
+
if args.output:
|
|
227
|
+
with open(args.output, "w", encoding="utf-8") as f:
|
|
228
|
+
f.write(report)
|
|
229
|
+
print(f"[OK] Report saved to: {args.output}")
|
|
230
|
+
else:
|
|
231
|
+
print(report)
|
|
232
|
+
|
|
233
|
+
if len(auditor.violations) > 0:
|
|
234
|
+
sys.exit(2)
|
|
235
|
+
sys.exit(0)
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
if __name__ == "__main__":
|
|
239
|
+
main()
|