@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.
- package/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +172 -0
- package/README.md +171 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +197 -0
- package/docs/ARCHITECTURE.md +198 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +175 -0
- package/docs/CLI_REFERENCE.md +177 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +121 -0
- package/docs/QUALITY_GATES.md +121 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1359 -0
- package/docs/schemas/synapse.config.schema.json +87 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +32 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2079 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +258 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +184 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2419 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +307 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +724 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1259 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- package/tools/welcome_page.py +290 -0
|
@@ -0,0 +1,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())
|