@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,438 @@
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
+ Humanize & Anti-AI Slop Linter (Enterprise QA Hub)
8
+ -------------------------------------------------
9
+ Scans documentation, test docstrings, commit messages, and PR descriptions
10
+ to detect and eliminate robotic AI buzzwords, cliches, and formatting quirks.
11
+ Provides clear, natural, human-grade plain text replacements.
12
+
13
+ Inspired by fcakyon/claude-codex-settings and Wikipedia's Signs of AI Writing.
14
+ """
15
+
16
+ from __future__ import annotations
17
+
18
+ import argparse
19
+ import json
20
+ import re
21
+ import sys
22
+ from dataclasses import asdict, dataclass
23
+ from pathlib import Path
24
+ from typing import Dict, List, Tuple
25
+
26
+ # Enforce UTF-8 output encoding
27
+ if hasattr(sys.stdout, "reconfigure"):
28
+ try:
29
+ sys.stdout.reconfigure(encoding="utf-8")
30
+ sys.stderr.reconfigure(encoding="utf-8")
31
+ except Exception:
32
+ pass
33
+
34
+
35
+ def masked(text: str, keep: List[bool]) -> str:
36
+ """Mask excluded characters with spaces while preserving newlines."""
37
+ return "".join(char if char in "\r\n" or keep[i] else " " for i, char in enumerate(text))
38
+
39
+
40
+ def md_text(text: str) -> str:
41
+ """Mask fenced and inline Markdown code without changing source offsets."""
42
+ keep = [True] * len(text)
43
+ offset = 0
44
+ fence = None
45
+ for line in text.splitlines(keepends=True):
46
+ match = re.match(r" {0,3}(`{3,}|~{3,})(.*)$", line.rstrip("\r\n"))
47
+ if fence:
48
+ keep[offset : offset + len(line)] = [False] * len(line)
49
+ if (
50
+ match
51
+ and match.group(1)[0] == fence[0]
52
+ and len(match.group(1)) >= len(fence)
53
+ and not match.group(2).strip()
54
+ ):
55
+ fence = None
56
+ elif match:
57
+ fence = match.group(1)
58
+ keep[offset : offset + len(line)] = [False] * len(line)
59
+ offset += len(line)
60
+
61
+ i = 0
62
+ while i < len(text):
63
+ if text[i] != "`" or not keep[i]:
64
+ i += 1
65
+ continue
66
+ end = i
67
+ while end < len(text) and text[end] == "`":
68
+ end += 1
69
+ delimiter = text[i:end]
70
+ close = text.find(delimiter, end)
71
+ if close < 0:
72
+ i = end
73
+ continue
74
+ keep[i : close + len(delimiter)] = [False] * (close + len(delimiter) - i)
75
+ i = close + len(delimiter)
76
+ return masked(text, keep)
77
+
78
+
79
+ # Stock AI buzzwords with direct plain-word swaps
80
+ BUZZWORD_SWAPS: Dict[str, str] = {
81
+ "leverage": "use",
82
+ "utilize": "use",
83
+ "plethora": "many",
84
+ "myriad": "many",
85
+ "delve": "look at",
86
+ "paradigm": "model",
87
+ "tapestry": "mix",
88
+ "showcase": "show",
89
+ "prose": "text",
90
+ "realm": "area",
91
+ "landscape": "field",
92
+ "innovative": "new",
93
+ "transformative": "major",
94
+ "unprecedented": "new",
95
+ "consolidate": "merge",
96
+ "modernize": "update",
97
+ "streamline": "simplify",
98
+ "flexible": "adjustable",
99
+ "establish": "set up",
100
+ "enhance": "improve",
101
+ "enhanced": "better",
102
+ "comprehensive": "full",
103
+ "optimize": "improve",
104
+ "unequivocally": "clearly",
105
+ "symphony": "mix",
106
+ "delicate": "fragile",
107
+ "begrudgingly": "reluctantly",
108
+ "merit": "worth",
109
+ "albeit": "though",
110
+ "reverent": "respectful",
111
+ "revolutionize": "change",
112
+ "revolutionizing": "changing",
113
+ "crucially": "drop it",
114
+ "remarkably": "drop it",
115
+ "seamlessly": "drop it",
116
+ "manifestation": "sign",
117
+ "testament": "sign",
118
+ "prominent": "clear",
119
+ "underscoring": "showing",
120
+ "symbolizing": "showing",
121
+ "cultivate": "build",
122
+ "cultivating": "building",
123
+ "foster": "build",
124
+ "fostering": "building",
125
+ "encompass": "cover",
126
+ "encompassing": "covering",
127
+ "facilitate": "help",
128
+ "facilitating": "helping",
129
+ "emphasize": "show",
130
+ "emphasizing": "showing",
131
+ "embody": "show",
132
+ "embodying": "showing",
133
+ "underlies": "drives",
134
+ "evoke": "stir",
135
+ "enduring": "lasting",
136
+ "nestled": "in",
137
+ "fascinating": "notable",
138
+ "vibrant": "lively",
139
+ "game-changing": "big",
140
+ "cutting-edge": "latest",
141
+ "robust": "strong",
142
+ "pivotal": "key",
143
+ "deep dive": "detailed review",
144
+ "garner": "collect",
145
+ "intricate": "complex",
146
+ "meticulous": "careful",
147
+ "interplay": "interaction",
148
+ "bolster": "strengthen",
149
+ "bolstered": "strengthened",
150
+ "boast": "have",
151
+ "boasts": "has",
152
+ "valuable": "useful",
153
+ }
154
+
155
+ # Filler cliches and robotic openers
156
+ CLICHE_PHRASES: List[Tuple[str, str]] = [
157
+ (r"\bever[- ]evolving\b", "drop 'ever-evolving'"),
158
+ (r"\bfast[- ]paced world\b", "drop 'fast-paced world'"),
159
+ (r"\ba testament to\b", "say what it shows"),
160
+ (r"\bvibrant tapestry\b", "drop the cliche"),
161
+ (r"\baims to explore\b", "say 'covers'"),
162
+ (r"\baims to bridge\b", "say what it connects"),
163
+ (r"\bfoster innovation\b", "say what gets built"),
164
+ (r"\bmeasured steps\b", "drop the cliche"),
165
+ (r"\bpracticed efficiency\b", "drop the cliche"),
166
+ (r"\bstark reminder\b", "drop the cliche"),
167
+ (r"\bit is important to note\b", "state the point directly"),
168
+ (r"\bas an ai language model\b", "drop it completely"),
169
+ (r"\bin conclusion\b", "drop it"),
170
+ (r"\bin summary\b", "drop it"),
171
+ (r"\bto sum up\b", "drop it"),
172
+ (r"\bplays? a \w+ role in shaping\b", "say what it does directly"),
173
+ (r"\bstands as\b", "replace with 'is'"),
174
+ (r"\bserves as\b", "replace with 'is'"),
175
+ (r"\bplays a pivotal role\b", "replace with 'is key'"),
176
+ (r"\breflects a broader trend\b", "say 'shows a trend'"),
177
+ (r"\bmarks a significant shift\b", "say 'marks a shift'"),
178
+ (r"\bin today's ever-evolving landscape\b", "say 'today'"),
179
+ ]
180
+
181
+ # Words that are fine in isolation, but suspicious when piled up (>= 3 times)
182
+ PILEUP_LIMIT = 3
183
+ PILEUP_WORDS = [
184
+ "crucial",
185
+ "essential",
186
+ "vital",
187
+ "significant",
188
+ "moreover",
189
+ "furthermore",
190
+ "additionally",
191
+ "aligns",
192
+ "explore",
193
+ "prompted",
194
+ ]
195
+
196
+ # AI punctuation quirks
197
+ PUNCTUATION_MARKS: Dict[str, Tuple[str, str]] = {
198
+ "—": ("em-dash", "use commas, hyphens, or periods"),
199
+ "§": ("section sign", "use word 'Section' or remove"),
200
+ ";": ("semicolon in prose", "use comma, period, or separate sentence"),
201
+ }
202
+
203
+
204
+ def build_inflection_pattern(word: str) -> re.Pattern:
205
+ """Build regex pattern matching word and its common verb/noun inflections."""
206
+ w = word.lower()
207
+ prefix = r"(?<![a-zA-Z0-9])"
208
+ suffix = r"(?![a-zA-Z0-9])"
209
+
210
+ if " " in w or "-" in w:
211
+ return re.compile(rf"{prefix}{re.escape(w)}{suffix}", re.IGNORECASE)
212
+
213
+ # Verbs ending in 'e' (leverage, utilize, optimize, streamline, delve, enhance, etc.)
214
+ if w.endswith("e") and len(w) > 3:
215
+ stem = w[:-1]
216
+ return re.compile(rf"{prefix}{re.escape(stem)}(?:e|es|ed|ing){suffix}", re.IGNORECASE)
217
+
218
+ # Verbs ending in 'y' (embody)
219
+ if w.endswith("y") and len(w) > 3:
220
+ stem = w[:-1]
221
+ return re.compile(rf"{prefix}(?:{re.escape(w)}|{re.escape(stem)}ies|{re.escape(stem)}ied|{re.escape(w)}ing){suffix}", re.IGNORECASE)
222
+
223
+ # Verbs ending in consonants (bolster, boast, foster, garner)
224
+ if w in {"bolster", "boast", "foster", "garner", "showcase", "transform"}:
225
+ return re.compile(rf"{prefix}{re.escape(w)}(?:s|ed|ing)?{suffix}", re.IGNORECASE)
226
+
227
+ return re.compile(rf"{prefix}{re.escape(w)}{suffix}", re.IGNORECASE)
228
+
229
+
230
+ @dataclass
231
+ class LintIssue:
232
+ line_number: int
233
+ matched_text: str
234
+ issue_type: str # 'buzzword' | 'cliche' | 'pileup' | 'punctuation'
235
+ suggestion: str
236
+ context: str
237
+
238
+
239
+ class HumanizeLinter:
240
+ """Lints text for AI writing artifacts and robotic buzzwords."""
241
+
242
+ def __init__(self, check_pileup: bool = True):
243
+ self.check_pileup = check_pileup
244
+ # Compile word boundaries for buzzwords with inflections
245
+ self.buzzword_patterns = {
246
+ word: (build_inflection_pattern(word), swap)
247
+ for word, swap in BUZZWORD_SWAPS.items()
248
+ }
249
+ # Compile cliches
250
+ self.cliche_patterns = [
251
+ (re.compile(pattern, re.IGNORECASE), suggestion)
252
+ for pattern, suggestion in CLICHE_PHRASES
253
+ ]
254
+ # Compile pileup words
255
+ self.pileup_patterns = {
256
+ word: re.compile(rf"(?<![a-zA-Z0-9]){re.escape(word)}(?![a-zA-Z0-9])", re.IGNORECASE)
257
+ for word in PILEUP_WORDS
258
+ }
259
+
260
+ def lint_text(self, text: str, source_label: str = "<input>") -> List[LintIssue]:
261
+ """Lint text line-by-line while masking code fences and inline backticks."""
262
+ masked_content = md_text(text)
263
+ issues: List[LintIssue] = []
264
+ lines_orig = text.splitlines()
265
+ lines_masked = masked_content.splitlines()
266
+
267
+ for idx, line_masked in enumerate(lines_masked, start=1):
268
+ line_orig = lines_orig[idx - 1] if idx - 1 < len(lines_orig) else ""
269
+ stripped = line_masked.strip()
270
+ if not stripped:
271
+ continue
272
+ # Scan markdown headings for buzzwords by stripping leading '#' characters
273
+ if stripped.startswith("#"):
274
+ heading_masked = line_masked.lstrip("# \t")
275
+ heading_orig = line_orig.lstrip("# \t")
276
+ offset = len(line_orig) - len(heading_orig)
277
+ for word, (pattern, swap) in self.buzzword_patterns.items():
278
+ for match in pattern.finditer(heading_masked):
279
+ matched_text = line_orig[offset + match.start() : offset + match.end()]
280
+ issues.append(
281
+ LintIssue(
282
+ line_number=idx,
283
+ matched_text=matched_text,
284
+ issue_type="buzzword",
285
+ suggestion=f"replace with '{swap}'",
286
+ context=line_orig.strip()[:80],
287
+ )
288
+ )
289
+ continue
290
+
291
+ # Check buzzwords on masked line
292
+ for word, (pattern, swap) in self.buzzword_patterns.items():
293
+ for match in pattern.finditer(line_masked):
294
+ matched_text = line_orig[match.start() : match.end()]
295
+ issues.append(
296
+ LintIssue(
297
+ line_number=idx,
298
+ matched_text=matched_text,
299
+ issue_type="buzzword",
300
+ suggestion=f"replace with '{swap}'",
301
+ context=line_orig.strip()[:80],
302
+ )
303
+ )
304
+
305
+ # Check cliches on masked line
306
+ for pattern, suggestion in self.cliche_patterns:
307
+ for match in pattern.finditer(line_masked):
308
+ matched_text = line_orig[match.start() : match.end()]
309
+ issues.append(
310
+ LintIssue(
311
+ line_number=idx,
312
+ matched_text=matched_text,
313
+ issue_type="cliche",
314
+ suggestion=suggestion,
315
+ context=line_orig.strip()[:80],
316
+ )
317
+ )
318
+
319
+ # Check punctuation marks on masked line (pre-mask HTML entities with spaces)
320
+ punct_line = re.sub(r"&[a-zA-Z0-9#]+;", lambda m: " " * len(m.group(0)), line_masked)
321
+ for mark, (name, suggestion) in PUNCTUATION_MARKS.items():
322
+ if mark in punct_line:
323
+ issues.append(
324
+ LintIssue(
325
+ line_number=idx,
326
+ matched_text=mark,
327
+ issue_type="punctuation",
328
+ suggestion=f"{name} detected: {suggestion}",
329
+ context=line_orig.strip()[:80],
330
+ )
331
+ )
332
+
333
+ # Document-wide pileup check on masked text
334
+ if self.check_pileup:
335
+ for word, pattern in self.pileup_patterns.items():
336
+ matches = list(pattern.finditer(masked_content))
337
+ if len(matches) >= PILEUP_LIMIT:
338
+ first_match = matches[0]
339
+ line_no = masked_content[: first_match.start()].count("\n") + 1
340
+ issues.append(
341
+ LintIssue(
342
+ line_number=line_no,
343
+ matched_text=word,
344
+ issue_type="pileup",
345
+ suggestion=(
346
+ f"word '{word}' repeated {len(matches)} times (>= {PILEUP_LIMIT}). "
347
+ "Vary vocabulary or simplify sentence structure."
348
+ ),
349
+ context=f"Repeated {len(matches)} times across document",
350
+ )
351
+ )
352
+
353
+ return issues
354
+
355
+ def lint_file(self, file_path: Path | str) -> List[LintIssue]:
356
+ """Lint a single file (markdown, docstring, commit text)."""
357
+ path = Path(file_path)
358
+ if not path.is_file():
359
+ return []
360
+ try:
361
+ content = path.read_text(encoding="utf-8", errors="ignore")
362
+ except Exception:
363
+ return []
364
+ return self.lint_text(content, source_label=str(path))
365
+
366
+
367
+ def format_cli_report(issues: List[LintIssue], source_name: str) -> str:
368
+ """Format lint issues into human-friendly CLI string."""
369
+ if not issues:
370
+ return f"✨ {source_name}: Clean! No AI buzzwords or cliches detected."
371
+
372
+ out = [f"⚠️ {source_name}: Found {len(issues)} writing/tone issue(s):"]
373
+ for issue in issues:
374
+ out.append(
375
+ f" - L{issue.line_number} [{issue.issue_type.upper()}]: "
376
+ f"'{issue.matched_text}' -> {issue.suggestion}"
377
+ )
378
+ if issue.context:
379
+ out.append(f" Excerpt: \"{issue.context}\"")
380
+ return "\n".join(out)
381
+
382
+
383
+ def main():
384
+ parser = argparse.ArgumentParser(
385
+ description="Humanize & Anti-AI Slop Linter for Enterprise QA"
386
+ )
387
+ parser.add_argument("--text", "-t", type=str, help="Text string to lint")
388
+ parser.add_argument("--file", "-f", type=str, help="File path to lint")
389
+ parser.add_argument(
390
+ "--json", action="store_true", help="Output results as JSON"
391
+ )
392
+ parser.add_argument(
393
+ "--strict", action="store_true", help="Exit code 1 if issues found"
394
+ )
395
+ args = parser.parse_args()
396
+
397
+ linter = HumanizeLinter()
398
+ issues: List[LintIssue] = []
399
+ source = "<input>"
400
+
401
+ if args.text:
402
+ source = "string_input"
403
+ issues = linter.lint_text(args.text, source_label=source)
404
+ elif args.file:
405
+ target = Path(args.file)
406
+ if not target.is_file():
407
+ sys.stderr.write(f"Error: File not found or not a regular file: {args.file}\n")
408
+ sys.exit(2)
409
+ source = args.file
410
+ issues = linter.lint_file(target)
411
+ else:
412
+ # Read from stdin if piped
413
+ if not sys.stdin.isatty():
414
+ content = sys.stdin.read()
415
+ source = "stdin"
416
+ issues = linter.lint_text(content, source_label=source)
417
+ else:
418
+ parser.print_help()
419
+ sys.exit(0)
420
+
421
+ if args.json:
422
+ result = {
423
+ "source": source,
424
+ "issue_count": len(issues),
425
+ "clean": len(issues) == 0,
426
+ "issues": [asdict(i) for i in issues],
427
+ }
428
+ print(json.dumps(result, indent=2, ensure_ascii=False))
429
+ else:
430
+ print(format_cli_report(issues, source))
431
+
432
+ if args.strict and issues:
433
+ sys.exit(1)
434
+ sys.exit(0)
435
+
436
+
437
+ if __name__ == "__main__":
438
+ main()