@teevee98/synapse-hub 0.0.0-stage โ†’ 3.8.2

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 +172 -0
  190. package/README.md +171 -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 +197 -0
  196. package/docs/ARCHITECTURE.md +198 -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 +175 -0
  200. package/docs/CLI_REFERENCE.md +177 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +121 -0
  206. package/docs/QUALITY_GATES.md +121 -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 +1359 -0
  212. package/docs/schemas/synapse.config.schema.json +87 -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 +32 -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 +2079 -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 +258 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +184 -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 +2419 -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 +307 -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 +724 -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 +1259 -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,401 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-FileCopyrightText: Copyright (c) 2026 Thแบฟ Vแป‹ (@TeeVee998). All rights reserved.
3
+ # SPDX-License-Identifier: MIT
4
+ # Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
5
+
6
+ """
7
+ Runtime FSM Interceptor & Tool Proxy Middleware
8
+ ------------------------------------------------
9
+ Provides dynamic precondition enforcement and runtime tool proxying connected
10
+ to the Enterprise 5-Stage Multi-Agent FSM (tools/fsm_enforcer.py):
11
+
12
+ Precondition Invariants:
13
+ 1. Before executing CODE_SYNTHESIS or mutating source/test code (write_to_file,
14
+ replace_file_content), Stage 1 (DISCOVERY) MUST be completed with valid
15
+ live DOM/AOM proof (selectors, locators, target_url, or aom_nodes).
16
+ 2. Before executing HEADLESS_EXEC or running tests, Stage 2 (CODE_SYNTHESIS)
17
+ MUST be completed with registered Page Classes or test scripts.
18
+ 3. Before executing AUTOPSY_HEAL, Stage 3 (HEADLESS_EXEC) MUST have executed.
19
+ 4. Before declaring task completion or DoD signoff (finish_task, verify_all),
20
+ Stages 1-4 MUST be completed and Stage 5 (ACCEPTANCE_DOD) verified.
21
+ 5. Read-only inspection tools (view_file, list_dir, grep_search) pass transparently.
22
+
23
+ Usage:
24
+ python tools/fsm_middleware.py check-precondition --action write_to_file
25
+ python tools/fsm_middleware.py intercept --tool write_to_file --params '{"TargetFile": "LoginPage.ts"}'
26
+ python tools/fsm_middleware.py status
27
+ """
28
+
29
+ import os
30
+ import sys
31
+ import json
32
+ import argparse
33
+ from datetime import datetime, timezone
34
+ from typing import Dict, Any, Optional, Tuple, Callable
35
+
36
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
37
+ if hasattr(sys.stdout, 'reconfigure'):
38
+ try:
39
+ sys.stdout.reconfigure(encoding='utf-8')
40
+ sys.stderr.reconfigure(encoding='utf-8')
41
+ except Exception:
42
+ pass
43
+
44
+ SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
45
+ if SCRIPT_DIR not in sys.path:
46
+ sys.path.insert(0, SCRIPT_DIR)
47
+
48
+ from fsm_enforcer import FsmEnforcer, STAGES_ORDER
49
+
50
+
51
+ # Safe, read-only tools that never require stage prerequisites
52
+ READ_ONLY_TOOLS = {
53
+ "view_file",
54
+ "list_dir",
55
+ "grep_search",
56
+ "find_by_name",
57
+ "read_url_content",
58
+ "ask_question",
59
+ "manage_task",
60
+ "schedule",
61
+ "search_web"
62
+ }
63
+
64
+ # Code modification tools subject to DISCOVERY gate
65
+ CODE_MUTATION_TOOLS = {
66
+ "write_to_file",
67
+ "replace_file_content",
68
+ "create_file",
69
+ "edit_file",
70
+ "synthesize_code"
71
+ }
72
+
73
+ # Test execution tools subject to CODE_SYNTHESIS gate
74
+ TEST_EXECUTION_TOOLS = {
75
+ "run_test",
76
+ "execute_test",
77
+ "test_runner",
78
+ "run_pytest",
79
+ "run_playwright",
80
+ "run_katalon"
81
+ }
82
+
83
+ # Final completion actions subject to DoD gate
84
+ COMPLETION_ACTIONS = {
85
+ "complete_task",
86
+ "finish_task",
87
+ "close_task",
88
+ "verify_dod",
89
+ "verify_compliance"
90
+ }
91
+
92
+
93
+ class FsmMiddleware:
94
+ """Runtime Interceptor and Tool Proxy enforcing 5-Stage FSM Preconditions."""
95
+
96
+ def __init__(self, enforcer: Optional[FsmEnforcer] = None, state_file: Optional[str] = None):
97
+ if enforcer is not None:
98
+ self.enforcer = enforcer
99
+ else:
100
+ self.enforcer = FsmEnforcer(state_file=state_file)
101
+
102
+ self._custom_guards: Dict[str, Tuple[str, Optional[Callable[[Dict[str, Any]], Tuple[bool, Optional[str]]]]]] = {}
103
+
104
+ def register_guard(
105
+ self,
106
+ tool_or_action: str,
107
+ required_stage: str,
108
+ custom_validator: Optional[Callable[[Dict[str, Any]], Tuple[bool, Optional[str]]]] = None
109
+ ):
110
+ """Registers a custom precondition guard for a specific tool or action name."""
111
+ self._custom_guards[tool_or_action.lower()] = (required_stage.upper(), custom_validator)
112
+
113
+ def is_read_only(self, tool_or_action: str) -> bool:
114
+ """Determines whether a tool is pure read-only inspection."""
115
+ return tool_or_action.lower() in READ_ONLY_TOOLS
116
+
117
+ def is_circuit_breaker_active(self, ctx: Optional[Dict[str, Any]] = None) -> Tuple[bool, Optional[str]]:
118
+ """
119
+ Checks whether an emergency circuit breaker is active to bypass DISCOVERY gate
120
+ when the live explorer or browser CDP process hangs or times out.
121
+ """
122
+ env_token = os.environ.get("SYNAPSE_CIRCUIT_BREAKER_OVERRIDE")
123
+ if env_token:
124
+ return True, f"Environment variable SYNAPSE_CIRCUIT_BREAKER_OVERRIDE is set ({env_token})"
125
+
126
+ if ctx:
127
+ ctx_token = ctx.get("circuit_breaker_override") or ctx.get("emergency_override_token")
128
+ if ctx_token:
129
+ return True, f"Context override token provided: {ctx_token}"
130
+
131
+ self.enforcer._load_state()
132
+ cb_state = self.enforcer.state.get("circuit_breaker", {})
133
+ if cb_state.get("tripped", False):
134
+ return True, cb_state.get("reason", "Live Explorer CDP timeout")
135
+
136
+ return False, None
137
+
138
+ def trip_circuit_breaker(self, reason: str = "Live Explorer CDP hung") -> Dict[str, Any]:
139
+ """Trips the emergency circuit breaker, recording audit reason and timestamp."""
140
+ self.enforcer._load_state()
141
+ self.enforcer.state["circuit_breaker"] = {
142
+ "tripped": True,
143
+ "reason": reason,
144
+ "timestamp": datetime.now(timezone.utc).isoformat()
145
+ }
146
+ self.enforcer._save_state()
147
+ return self.enforcer.state["circuit_breaker"]
148
+
149
+ def reset_circuit_breaker(self) -> Dict[str, Any]:
150
+ """Resets the circuit breaker back to normal FSM enforcement mode."""
151
+ self.enforcer._load_state()
152
+ self.enforcer.state["circuit_breaker"] = {
153
+ "tripped": False,
154
+ "reason": None,
155
+ "timestamp": datetime.now(timezone.utc).isoformat()
156
+ }
157
+ self.enforcer._save_state()
158
+ return self.enforcer.state["circuit_breaker"]
159
+
160
+ def check_precondition(
161
+ self,
162
+ action_or_tool: str,
163
+ context: Optional[Dict[str, Any]] = None,
164
+ session_id: Optional[str] = None
165
+ ) -> Tuple[bool, Optional[str]]:
166
+ """
167
+ Evaluates whether an action or tool invocation satisfies FSM prerequisites.
168
+ Returns (is_allowed, rejection_reason).
169
+ """
170
+ tool_clean = action_or_tool.strip().lower()
171
+ ctx = context or {}
172
+
173
+ # 1. Read-only inspection tools are always permitted
174
+ if self.is_read_only(tool_clean):
175
+ return True, None
176
+
177
+ state = self.enforcer.get_status()
178
+ completed = state.get("completed_stages", [])
179
+
180
+ # 2. Check custom registered guards first
181
+ if tool_clean in self._custom_guards:
182
+ req_stage, custom_fn = self._custom_guards[tool_clean]
183
+ if req_stage not in completed:
184
+ return False, (
185
+ f"FSM Interceptor BLOCKED '{action_or_tool}': Requires Stage '{req_stage}' "
186
+ f"to be completed first. Current completed stages: {completed}."
187
+ )
188
+ if custom_fn:
189
+ valid, err = custom_fn(ctx)
190
+ if not valid:
191
+ return False, f"FSM Interceptor custom validation failed for '{action_or_tool}': {err}"
192
+ return True, None
193
+
194
+ # 3. Rule: Code Synthesis / Code Mutation requires DISCOVERY stage completed with DOM/AOM proof
195
+ if tool_clean in CODE_MUTATION_TOOLS or tool_clean == "code_synthesis":
196
+ # If target file is scratch or planning, allow pass-through
197
+ target_file = ctx.get("TargetFile") or ctx.get("target_file") or ctx.get("file") or ""
198
+ if any(target_file.endswith(ext) for ext in (".tmp", ".log", "task_plan.md", "findings.md", "progress.md")):
199
+ return True, None
200
+
201
+ # Emergency Circuit Breaker check
202
+ cb_active, cb_reason = self.is_circuit_breaker_active(ctx)
203
+ if cb_active:
204
+ sys.stderr.write(
205
+ f"[CIRCUIT_BREAKER] Emergency override active: Stage 1 DISCOVERY gate bypassed for '{action_or_tool}' ({cb_reason}).\n"
206
+ )
207
+ return True, None
208
+
209
+ if "DISCOVERY" not in completed:
210
+ return False, (
211
+ f"FSM Interceptor BLOCKED '{action_or_tool}': Modifying code or synthesizing PageClasses/tests "
212
+ f"requires Stage 1 (DISCOVERY) to be signed off by actor 'live-explorer' with valid "
213
+ f"live DOM/AOM proof before touching code. Current completed stages: {completed}."
214
+ )
215
+
216
+ # Check that DISCOVERY evidence contained actual DOM/AOM evidence
217
+ self.enforcer._load_state()
218
+ disc_record = self.enforcer.state.get("completed_stages", {}).get("DISCOVERY", {})
219
+ disc_evidence = disc_record.get("evidence", {})
220
+ dom_keys = {"selectors", "locators", "target_url", "url", "target", "element", "elements", "dom_hash", "aom_nodes"}
221
+ if not any(k in disc_evidence for k in dom_keys):
222
+ return False, (
223
+ f"FSM Interceptor BLOCKED '{action_or_tool}': Stage 1 (DISCOVERY) evidence does not contain "
224
+ f"valid DOM/AOM contract data. Evidence recorded: {list(disc_evidence.keys())}."
225
+ )
226
+
227
+ return True, None
228
+
229
+ # 4. Rule: Headless Execution / Test Running requires CODE_SYNTHESIS stage completed
230
+ cmd_str = str(ctx.get("CommandLine") or ctx.get("command") or ctx.get("cmd") or "").strip().lower()
231
+ is_cmd_test_runner = any(cmd_str.startswith(r) or f" {r} " in f" {cmd_str} " for r in (
232
+ "pytest", "playwright", "npx playwright", "katalon", "npm test", "npm run test", "gradle test"
233
+ ))
234
+
235
+ if tool_clean in TEST_EXECUTION_TOOLS or tool_clean == "headless_exec" or is_cmd_test_runner:
236
+ if "CODE_SYNTHESIS" not in completed:
237
+ return False, (
238
+ f"FSM Interceptor BLOCKED '{action_or_tool}': Headless test execution requires Stage 2 (CODE_SYNTHESIS) "
239
+ f"to be signed off by actor 'pom-crafter' with synthesized Page Classes/scripts first. "
240
+ f"Current completed stages: {completed}."
241
+ )
242
+ return True, None
243
+
244
+ # 5. Rule: Autopsy & Self-Healing requires HEADLESS_EXEC executed
245
+ if tool_clean in {"autopsy_heal", "heal", "auto_heal", "diagnose_failure"}:
246
+ if "HEADLESS_EXEC" not in completed:
247
+ return False, (
248
+ f"FSM Interceptor BLOCKED '{action_or_tool}': Failure autopsy & healing requires Stage 3 (HEADLESS_EXEC) "
249
+ f"to have run first. Current completed stages: {completed}."
250
+ )
251
+ return True, None
252
+
253
+ # 6. Rule: Stage 5 (ACCEPTANCE_DOD) execution requires Stages 1-4 completed
254
+ if tool_clean == "acceptance_dod":
255
+ missing_prior = [s for s in STAGES_ORDER[:4] if s not in completed]
256
+ if missing_prior:
257
+ return False, (
258
+ f"FSM Interceptor BLOCKED '{action_or_tool}': Entering Stage 5 (ACCEPTANCE_DOD) requires "
259
+ f"preceding stages {missing_prior} to be completed first. Current: {completed}."
260
+ )
261
+ return True, None
262
+
263
+ # 7. Rule: Task Completion / DoD Gatekeeper requires stages 1-5 completed and full cryptographic compliance
264
+ if tool_clean in COMPLETION_ACTIONS:
265
+ missing_prior = [s for s in STAGES_ORDER if s not in completed]
266
+ if missing_prior:
267
+ return False, (
268
+ f"FSM Interceptor BLOCKED task completion '{action_or_tool}': Preceding stages {missing_prior} "
269
+ f"must be completed before final DoD signoff."
270
+ )
271
+
272
+ # Audit full compliance token integrity
273
+ comp = self.enforcer.verify_compliance()
274
+ if not comp.get("compliant", False):
275
+ return False, (
276
+ f"FSM Interceptor BLOCKED task completion: Full 5-stage FSM DoD verification failed: "
277
+ f"{comp.get('error', 'Incomplete compliance verification')}."
278
+ )
279
+ return True, None
280
+
281
+ # By default, unrecognized commands pass through with advisory notice
282
+ return True, None
283
+
284
+ def intercept(
285
+ self,
286
+ tool_name: str,
287
+ params: Optional[Dict[str, Any]] = None,
288
+ handler: Optional[Callable[[Dict[str, Any]], Any]] = None
289
+ ) -> Dict[str, Any]:
290
+ """
291
+ Intercepts a tool invocation. If preconditions pass, executes handler;
292
+ otherwise intercepts and rejects immediately.
293
+ """
294
+ payload = params or {}
295
+ allowed, reason = self.check_precondition(tool_name, payload)
296
+
297
+ if not allowed:
298
+ return {
299
+ "status": "REJECTED_BY_FSM_INTERCEPTOR",
300
+ "tool": tool_name,
301
+ "error": reason,
302
+ "precondition_passed": False
303
+ }
304
+
305
+ if handler is not None:
306
+ try:
307
+ result = handler(payload)
308
+ return {
309
+ "status": "PASS",
310
+ "tool": tool_name,
311
+ "precondition_passed": True,
312
+ "result": result
313
+ }
314
+ except Exception as e:
315
+ return {
316
+ "status": "EXECUTION_ERROR",
317
+ "tool": tool_name,
318
+ "precondition_passed": True,
319
+ "error": str(e)
320
+ }
321
+
322
+ return {
323
+ "status": "PASS",
324
+ "tool": tool_name,
325
+ "precondition_passed": True,
326
+ "message": f"Preconditions satisfied for '{tool_name}'."
327
+ }
328
+
329
+
330
+ def main():
331
+ parser = argparse.ArgumentParser(description="Runtime FSM Interceptor & Tool Proxy Middleware")
332
+ subparsers = parser.add_subparsers(dest="subcommand", help="Command to run")
333
+
334
+ # check-precondition
335
+ sp_chk = subparsers.add_parser("check-precondition", help="Check if an action satisfies FSM preconditions")
336
+ sp_chk.add_argument("--action", required=True, help="Tool or action name to evaluate")
337
+ sp_chk.add_argument("--params", default="{}", help="Optional JSON parameters for the tool call")
338
+
339
+ # intercept
340
+ sp_int = subparsers.add_parser("intercept", help="Intercept tool invocation")
341
+ sp_int.add_argument("--tool", required=True, help="Target tool name")
342
+ sp_int.add_argument("--params", default="{}", help="JSON parameters")
343
+
344
+ # status
345
+ subparsers.add_parser("status", help="Get current FSM session and middleware status")
346
+
347
+ # trip-circuit-breaker
348
+ sp_trip = subparsers.add_parser("trip-circuit-breaker", help="Trip emergency circuit breaker to bypass DISCOVERY gate")
349
+ sp_trip.add_argument("--reason", default="Live Explorer CDP hung", help="Reason for emergency bypass")
350
+
351
+ # reset-circuit-breaker
352
+ subparsers.add_parser("reset-circuit-breaker", help="Reset circuit breaker to normal FSM enforcement")
353
+
354
+ args = parser.parse_args()
355
+ middleware = FsmMiddleware()
356
+
357
+ if args.subcommand == "check-precondition":
358
+ try:
359
+ params = json.loads(args.params)
360
+ except Exception:
361
+ params = {}
362
+ allowed, reason = middleware.check_precondition(args.action, params)
363
+ res = {
364
+ "action": args.action,
365
+ "allowed": allowed,
366
+ "reason": reason
367
+ }
368
+ print(json.dumps(res, indent=2))
369
+ sys.exit(0 if allowed else 1)
370
+
371
+ elif args.subcommand == "intercept":
372
+ try:
373
+ params = json.loads(args.params)
374
+ except Exception:
375
+ params = {}
376
+ res = middleware.intercept(args.tool, params)
377
+ print(json.dumps(res, indent=2))
378
+ sys.exit(0 if res.get("precondition_passed") else 1)
379
+
380
+ elif args.subcommand == "status":
381
+ status = middleware.enforcer.get_status()
382
+ print(json.dumps(status, indent=2))
383
+ sys.exit(0)
384
+
385
+ elif args.subcommand == "trip-circuit-breaker":
386
+ res = middleware.trip_circuit_breaker(reason=args.reason)
387
+ print(json.dumps({"status": "CIRCUIT_BREAKER_TRIPPED", "details": res}, indent=2))
388
+ sys.exit(0)
389
+
390
+ elif args.subcommand == "reset-circuit-breaker":
391
+ res = middleware.reset_circuit_breaker()
392
+ print(json.dumps({"status": "CIRCUIT_BREAKER_RESET", "details": res}, indent=2))
393
+ sys.exit(0)
394
+
395
+ else:
396
+ parser.print_help()
397
+ sys.exit(1)
398
+
399
+
400
+ if __name__ == "__main__":
401
+ main()
@@ -0,0 +1,197 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Enterprise Edge-Case Fuzzing & Input Sanitization Payload Catalog
4
+ ------------------------------------------------------------------
5
+ Supplies standardized boundary, resilience, and sanitization payloads
6
+ for transforming functional automated test suites into robust input
7
+ sanitization and vulnerability boundary validators.
8
+
9
+ Categories Covered:
10
+ 1. SQLi Harmless Polyglots (no data destruction, tests parser escaping)
11
+ 2. XSS & Script Injection Polyglots
12
+ 3. Unicode BiDi / RTL Trojan Source & Zero-Width characters
13
+ 4. Multi-byte Emoji Surrogate Pairs & ZWJ Sequences
14
+ 5. Extreme Length Strings (10^4 buffer stress testing)
15
+ 6. Null Byte & Control Character Injections
16
+ 7. Numeric Precision & IEEE-754 Boundary Limits
17
+ """
18
+
19
+ import sys
20
+ import json
21
+ import argparse
22
+ from typing import Dict, Any, List, Optional
23
+
24
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
25
+ if hasattr(sys.stdout, 'reconfigure'):
26
+ try:
27
+ sys.stdout.reconfigure(encoding='utf-8')
28
+ sys.stderr.reconfigure(encoding='utf-8')
29
+ except Exception:
30
+ pass
31
+
32
+
33
+ FUZZ_PAYLOAD_CATALOG: Dict[str, List[Dict[str, Any]]] = {
34
+ "sqli_polyglots": [
35
+ {"name": "Standard Tautology", "payload": "' OR '1'='1' -- ", "expected_status": 400},
36
+ {"name": "Inline Polyglot Comment", "payload": "SLEEP(0)/*'/*\"/*--", "expected_status": 400},
37
+ {"name": "Union Select Null Probe", "payload": "1' UNION SELECT NULL, NULL, NULL -- ", "expected_status": 400},
38
+ {"name": "Batched Query Delay Probe", "payload": "'; WAITFOR DELAY '0:0:0'--", "expected_status": 400},
39
+ {"name": "Admin Comment Bypass", "payload": "admin' -- ", "expected_status": 400}
40
+ ],
41
+ "xss_polyglots": [
42
+ {"name": "Standard Script Tag", "payload": "<script>alert(1)</script>", "expected_status": 400},
43
+ {"name": "Image Tag OnError", "payload": "<img src=x onerror=console.warn('qa_xss')>", "expected_status": 400},
44
+ {"name": "Universal Polyglot Vector", "payload": "javascript:/*--></title></style></textarea></script></xmp><svg/onload='+/\"/+/onmouseover=1+(alert)(1)//'>", "expected_status": 400},
45
+ {"name": "SVG FromCharCode Injection", "payload": "\"><svg/onload=alert(String.fromCharCode(88,83,83))>", "expected_status": 400}
46
+ ],
47
+ "unicode_bidi_rtl": [
48
+ {"name": "Right-to-Left Override (Trojan Source)", "payload": "\u202E\u0041\u0042\u0043_AUTO_TX", "expected_status": 400},
49
+ {"name": "Zero-Width Space & Joiner Injection", "payload": "AUTO\u200B\u200C\u200D_DATA", "expected_status": 400},
50
+ {"name": "Byte Order Mark (BOM) In-String", "payload": "\uFEFFAUTO_USER", "expected_status": 400},
51
+ {"name": "Mixed BiDi Arabic/Latin", "payload": "USER_ู…ุฑุญุจุง_ุจุงู„ุนุงู„ู…_2026", "expected_status": 200}
52
+ ],
53
+ "emoji_surrogates": [
54
+ {"name": "Complex ZWJ Family Sequence", "payload": "๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ_QA_RECORD", "expected_status": 200},
55
+ {"name": "Rainbow Flag Multi-Code", "payload": "๐Ÿณ๏ธโ€๐ŸŒˆ_FLAG_TAG", "expected_status": 200},
56
+ {"name": "Unpaired Surrogate Pair Boundary", "payload": "\uD83D\uDE00\uD83D", "expected_status": 400},
57
+ {"name": "4-Byte High Plane UTF-8", "payload": "๐Ÿ”ฅ๐Ÿš€โšก๐Ÿงชโœจ", "expected_status": 200}
58
+ ],
59
+ "extreme_length": [
60
+ {"name": "10^4 (10,000 Chars) Buffer Stress", "payload": "A" * 10000, "expected_status": 400},
61
+ {"name": "1,024 Chars Text Block", "payload": "X" * 1024, "expected_status": 400},
62
+ {"name": "Repetitive Delimiter Stress", "payload": "{\"test\": [" + ",".join(["1"] * 500) + "]}", "expected_status": 400}
63
+ ],
64
+ "null_byte_control": [
65
+ {"name": "Null Byte Extension Truncation", "payload": "document\x00.pdf", "expected_status": 400},
66
+ {"name": "URL Encoded Null Byte", "payload": "test%00.png", "expected_status": 400},
67
+ {"name": "Carriage Return Linefeed Header Split", "payload": "test\r\nSet-Cookie: QA_LEAK=1", "expected_status": 400}
68
+ ],
69
+ "numeric_boundaries": [
70
+ {"name": "32-bit Integer Max Overflow", "payload": 2147483648, "expected_status": 400},
71
+ {"name": "32-bit Integer Min Underflow", "payload": -2147483649, "expected_status": 400},
72
+ {"name": "64-bit BigInt Max Boundary", "payload": 9223372036854775807, "expected_status": 200},
73
+ {"name": "JavaScript MAX_SAFE_INTEGER + 1", "payload": 9007199254740992, "expected_status": 400},
74
+ {"name": "IEEE-754 Extreme Float Overflow", "payload": 1e308, "expected_status": 400},
75
+ {"name": "Negative Zero Float", "payload": -0.0, "expected_status": 200}
76
+ ]
77
+ }
78
+
79
+
80
+ def get_fuzz_payloads(category: Optional[str] = None) -> Dict[str, List[Dict[str, Any]]]:
81
+ """Returns payloads filtered by category or the entire catalog."""
82
+ if category and category.lower() != "all":
83
+ cat_key = category.lower()
84
+ if cat_key in FUZZ_PAYLOAD_CATALOG:
85
+ return {cat_key: FUZZ_PAYLOAD_CATALOG[cat_key]}
86
+ # Fuzzy match
87
+ for k in FUZZ_PAYLOAD_CATALOG:
88
+ if cat_key in k:
89
+ return {k: FUZZ_PAYLOAD_CATALOG[k]}
90
+ return FUZZ_PAYLOAD_CATALOG
91
+
92
+
93
+ def get_field_fuzz_scenarios(field_name: str, field_type: str = "string") -> List[Dict[str, Any]]:
94
+ """
95
+ Generates actionable test scenarios for a given field name and data type.
96
+ """
97
+ scenarios = []
98
+ if field_type == "string":
99
+ # 1. SQLi Polyglot
100
+ scenarios.append({
101
+ "scenario": f"{field_name} SQLi Polyglot Sanitization",
102
+ "category": "SECURITY_SANITY",
103
+ "value": FUZZ_PAYLOAD_CATALOG["sqli_polyglots"][0]["payload"],
104
+ "expected": 400
105
+ })
106
+ # 2. XSS Probe
107
+ scenarios.append({
108
+ "scenario": f"{field_name} XSS Universal Polyglot",
109
+ "category": "SECURITY_SANITY",
110
+ "value": FUZZ_PAYLOAD_CATALOG["xss_polyglots"][1]["payload"],
111
+ "expected": 400
112
+ })
113
+ # 3. BiDi RTL Trojan Source
114
+ scenarios.append({
115
+ "scenario": f"{field_name} Unicode BiDi RTL Override",
116
+ "category": "RESILIENCE_UNICODE",
117
+ "value": FUZZ_PAYLOAD_CATALOG["unicode_bidi_rtl"][0]["payload"],
118
+ "expected": 400
119
+ })
120
+ # 4. Multi-byte Emoji Surrogate
121
+ scenarios.append({
122
+ "scenario": f"{field_name} Emoji Surrogate & ZWJ Sequence",
123
+ "category": "RESILIENCE_UNICODE",
124
+ "value": FUZZ_PAYLOAD_CATALOG["emoji_surrogates"][0]["payload"],
125
+ "expected": 200
126
+ })
127
+ # 5. Extreme Length 10^4
128
+ scenarios.append({
129
+ "scenario": f"{field_name} 10^4 Chars Buffer Stress",
130
+ "category": "RESILIENCE_OVERFLOW",
131
+ "value": "A" * 10000,
132
+ "expected": 400
133
+ })
134
+ # 6. Null Byte Injection
135
+ scenarios.append({
136
+ "scenario": f"{field_name} Null Byte Injection",
137
+ "category": "SECURITY_SANITY",
138
+ "value": "item\x00_test",
139
+ "expected": 400
140
+ })
141
+
142
+ elif field_type in ("integer", "number"):
143
+ for item in FUZZ_PAYLOAD_CATALOG["numeric_boundaries"]:
144
+ scenarios.append({
145
+ "scenario": f"{field_name} {item['name']}",
146
+ "category": "RESILIENCE_NUMERIC",
147
+ "value": item["payload"],
148
+ "expected": item["expected_status"]
149
+ })
150
+
151
+ return scenarios
152
+
153
+
154
+ def main():
155
+ parser = argparse.ArgumentParser(description="Edge-Case Fuzzing & Input Sanitization Payload Generator")
156
+ parser.add_argument("--category", default="all", help="Payload category (sqli, xss, bidi, emoji, length, null, numeric, or all)")
157
+ parser.add_argument("--field", default="", help="Optional field name to generate targeted boundary suite")
158
+ parser.add_argument("--type", default="string", choices=["string", "integer", "number"], help="Field data type")
159
+ parser.add_argument("--json", action="store_true", help="Output results in JSON format")
160
+ args = parser.parse_args()
161
+
162
+ if args.field:
163
+ scenarios = get_field_fuzz_scenarios(args.field, field_type=args.type)
164
+ if args.json:
165
+ print(json.dumps(scenarios, indent=2, ensure_ascii=False))
166
+ else:
167
+ print("\n======================================================================")
168
+ print(f" EDGE-CASE FUZZING SCENARIOS FOR FIELD: '{args.field}' ({args.type.upper()})")
169
+ print("======================================================================")
170
+ for idx, sc in enumerate(scenarios, start=1):
171
+ val_disp = repr(sc['value']) if len(str(sc['value'])) < 60 else repr(str(sc['value'])[:50] + "...")
172
+ print(f" [{idx:02d}] {sc['scenario']:<45} | Expected: HTTP {sc['expected']} | Value: {val_disp}")
173
+ print()
174
+ return 0
175
+
176
+ catalog = get_fuzz_payloads(args.category)
177
+ if args.json:
178
+ print(json.dumps(catalog, indent=2, ensure_ascii=False))
179
+ else:
180
+ print("\n======================================================================")
181
+ print(" ENTERPRISE EDGE-CASE FUZZING & SANITIZATION CATALOG ")
182
+ print("======================================================================")
183
+ total_payloads = sum(len(items) for items in catalog.values())
184
+ print(f"Categories: {len(catalog)} | Total Payloads: {total_payloads}\n")
185
+
186
+ for cat, items in catalog.items():
187
+ print(f"๐Ÿ“ [{cat.upper()}] ({len(items)} vectors):")
188
+ for it in items:
189
+ p_disp = repr(it['payload']) if len(str(it['payload'])) < 60 else repr(str(it['payload'])[:50] + "...")
190
+ print(f" โ€ข {it['name']:<35} -> HTTP {it['expected_status']} | {p_disp}")
191
+ print()
192
+
193
+ return 0
194
+
195
+
196
+ if __name__ == "__main__":
197
+ sys.exit(main())