@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.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +171 -0
  190. package/README.md +170 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +198 -0
  196. package/docs/ARCHITECTURE.md +199 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +31 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2074 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2403 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +306 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +725 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1271 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. 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()