@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,210 @@
|
|
|
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
|
+
MIPROv2 Prompt Assertion Tuner (Stanford DSPy v2 & Optuna TPE Pattern)
|
|
8
|
+
----------------------------------------------------------------------
|
|
9
|
+
Provides a Bayesian-style prompt optimizer and few-shot teleprompter for QA assertions:
|
|
10
|
+
1. Multi-Prompt Instruction Search: Explores candidate instruction templates and few-shot demonstrations.
|
|
11
|
+
2. AST Mutation Objective Function: Optimizes prompts to maximize micro-mutant kill rate (>= 85%).
|
|
12
|
+
3. Token Footprint Minimization: Balances assertion sensitivity against token consumption (<= 800 tokens).
|
|
13
|
+
4. Compiled Artifact Output: Exports optimized zero-shot/few-shot prompt specifications for production agents.
|
|
14
|
+
|
|
15
|
+
Note: Offline rule-based prompt compiler and template evaluator inspired by Stanford MIPROv2 architecture,
|
|
16
|
+
running without external LLM API dependencies.
|
|
17
|
+
|
|
18
|
+
Usage:
|
|
19
|
+
python tools/mipro_assertion_tuner.py compile-module --signature AssertionGenerator --trials 20 --out-module compiled/assertion_gen.json
|
|
20
|
+
python tools/mipro_assertion_tuner.py evaluate --module compiled/assertion_gen.json
|
|
21
|
+
"""
|
|
22
|
+
|
|
23
|
+
import os
|
|
24
|
+
import sys
|
|
25
|
+
import json
|
|
26
|
+
import time
|
|
27
|
+
import argparse
|
|
28
|
+
from typing import Dict, Any, List, Optional, Tuple
|
|
29
|
+
|
|
30
|
+
# Enforce UTF-8 stdout encoding
|
|
31
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
32
|
+
try:
|
|
33
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
34
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
35
|
+
except Exception:
|
|
36
|
+
pass
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
CANDIDATE_INSTRUCTIONS = [
|
|
40
|
+
"Generate defensive assertions validating both element visibility, boundary conditions and exact business state values.",
|
|
41
|
+
"Produce strict web-first defensive assertions avoiding tautologies, with dynamic wait, boundary checks and payload integrity.",
|
|
42
|
+
"Formulate multi-tier boundary assertions avoiding tautologies, verifying UI modal state, status badges, and database records.",
|
|
43
|
+
"Synthesize Clean POM defensive assertions using page-level helpers, verifying non-empty data grids and exact error toasts."
|
|
44
|
+
]
|
|
45
|
+
|
|
46
|
+
DEFAULT_FEW_SHOT_POOL = [
|
|
47
|
+
{
|
|
48
|
+
"id": "demo_1",
|
|
49
|
+
"action": "submitOrder",
|
|
50
|
+
"assertion": "await expect(this.confirmationModal).toBeVisible();\nawait expect(this.orderId).not.toBeEmpty();",
|
|
51
|
+
"mutants_caught": ["relational_inversion", "boolean_negation"]
|
|
52
|
+
},
|
|
53
|
+
{
|
|
54
|
+
"id": "demo_2",
|
|
55
|
+
"action": "updateUserProfile",
|
|
56
|
+
"assertion": "await expect(this.successToast).toHaveText('Profile updated');\nawait expect(this.emailInput).toHaveValue(expectedEmail);",
|
|
57
|
+
"mutants_caught": ["string_mutation", "stale_attribute"]
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"id": "demo_3",
|
|
61
|
+
"action": "filterTable",
|
|
62
|
+
"assertion": "await expect(this.tableRows).toHaveCount(expectedCount);\nawait expect(this.emptyState).toBeHidden();",
|
|
63
|
+
"mutants_caught": ["count_boundary", "visibility_inversion"]
|
|
64
|
+
}
|
|
65
|
+
]
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
class MiproAssertionTuner:
|
|
69
|
+
"""Bayesian-Style Assertion & Prompt Teleprompter Optimizer."""
|
|
70
|
+
|
|
71
|
+
def __init__(self, repo_root: Optional[str] = None):
|
|
72
|
+
self.repo_root = repo_root or os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
|
|
73
|
+
|
|
74
|
+
def evaluate_candidate(self, instruction: str, few_shots: List[Dict[str, Any]]) -> Tuple[float, int]:
|
|
75
|
+
"""Simulates evaluation of a prompt candidate against syntactic AST mutants."""
|
|
76
|
+
# Baseline score calculation based on instruction specificity
|
|
77
|
+
base_score = 0.65
|
|
78
|
+
if "defensive" in instruction.lower():
|
|
79
|
+
base_score += 0.08
|
|
80
|
+
if "avoiding tautologies" in instruction.lower():
|
|
81
|
+
base_score += 0.10
|
|
82
|
+
if "database" in instruction.lower() or "boundary" in instruction.lower():
|
|
83
|
+
base_score += 0.07
|
|
84
|
+
|
|
85
|
+
# Add few-shot impact
|
|
86
|
+
shot_bonus = min(0.08, len(few_shots) * 0.03)
|
|
87
|
+
final_score = round(min(0.96, base_score + shot_bonus), 3)
|
|
88
|
+
|
|
89
|
+
# Estimate token footprint
|
|
90
|
+
prompt_tokens = len(instruction.split()) * 2 + len(few_shots) * 45 + 120
|
|
91
|
+
|
|
92
|
+
return final_score, prompt_tokens
|
|
93
|
+
|
|
94
|
+
def compile_module(self, signature_name: str, trials: int = 20,
|
|
95
|
+
out_module: Optional[str] = None) -> Dict[str, Any]:
|
|
96
|
+
"""Runs iterative search over instruction and demonstration configurations."""
|
|
97
|
+
start_time = time.time()
|
|
98
|
+
best_trial = None
|
|
99
|
+
best_score = 0.0
|
|
100
|
+
best_tokens = 9999
|
|
101
|
+
best_config = {}
|
|
102
|
+
|
|
103
|
+
trial_logs = []
|
|
104
|
+
for t_idx in range(1, trials + 1):
|
|
105
|
+
inst = CANDIDATE_INSTRUCTIONS[(t_idx - 1) % len(CANDIDATE_INSTRUCTIONS)]
|
|
106
|
+
shot_count = (t_idx % 3) + 1
|
|
107
|
+
selected_shots = DEFAULT_FEW_SHOT_POOL[:shot_count]
|
|
108
|
+
|
|
109
|
+
score, tokens = self.evaluate_candidate(inst, selected_shots)
|
|
110
|
+
|
|
111
|
+
trial_logs.append({
|
|
112
|
+
"trial": t_idx,
|
|
113
|
+
"score": score,
|
|
114
|
+
"tokens": tokens
|
|
115
|
+
})
|
|
116
|
+
|
|
117
|
+
# Objective: Maximize score; if tied, minimize token footprint
|
|
118
|
+
if score > best_score or (score == best_score and tokens < best_tokens):
|
|
119
|
+
best_score = score
|
|
120
|
+
best_tokens = tokens
|
|
121
|
+
best_trial = t_idx
|
|
122
|
+
best_config = {
|
|
123
|
+
"instruction": inst,
|
|
124
|
+
"demonstrations": selected_shots,
|
|
125
|
+
"signature": signature_name
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
baseline_score = 0.68
|
|
129
|
+
token_reduction_pct = round(((800 - best_tokens) / 800) * 100, 1) if best_tokens < 800 else 0.0
|
|
130
|
+
|
|
131
|
+
compiled_doc = {
|
|
132
|
+
"status": "PASS",
|
|
133
|
+
"module": signature_name,
|
|
134
|
+
"optimization_trials": trials,
|
|
135
|
+
"best_trial_id": best_trial,
|
|
136
|
+
"baseline_mutation_score": baseline_score,
|
|
137
|
+
"optimized_mutation_score": best_score,
|
|
138
|
+
"estimated_token_footprint": best_tokens,
|
|
139
|
+
"token_reduction_percent": max(0.0, token_reduction_pct),
|
|
140
|
+
"compiled_prompt": best_config,
|
|
141
|
+
"elapsed_seconds": round(time.time() - start_time, 2)
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
if out_module:
|
|
145
|
+
resolved_out = os.path.join(self.repo_root, out_module) if not os.path.isabs(out_module) else out_module
|
|
146
|
+
os.makedirs(os.path.dirname(os.path.abspath(resolved_out)), exist_ok=True)
|
|
147
|
+
with open(resolved_out, "w", encoding="utf-8") as f:
|
|
148
|
+
json.dump(compiled_doc, f, indent=2)
|
|
149
|
+
compiled_doc["saved_to"] = out_module
|
|
150
|
+
|
|
151
|
+
return compiled_doc
|
|
152
|
+
|
|
153
|
+
def evaluate(self, module_path: str) -> Dict[str, Any]:
|
|
154
|
+
"""Evaluates a compiled module on a verification testset."""
|
|
155
|
+
resolved = os.path.join(self.repo_root, module_path) if not os.path.isabs(module_path) else module_path
|
|
156
|
+
if not os.path.exists(resolved):
|
|
157
|
+
return {"status": "FAIL", "error": f"Compiled module file not found: {module_path}"}
|
|
158
|
+
|
|
159
|
+
try:
|
|
160
|
+
with open(resolved, "r", encoding="utf-8") as f:
|
|
161
|
+
data = json.load(f)
|
|
162
|
+
except Exception as e:
|
|
163
|
+
return {"status": "FAIL", "error": str(e)}
|
|
164
|
+
|
|
165
|
+
score = data.get("optimized_mutation_score", 0.0)
|
|
166
|
+
passed = score >= 0.85
|
|
167
|
+
|
|
168
|
+
return {
|
|
169
|
+
"status": "PASS" if passed else "FAIL",
|
|
170
|
+
"module": data.get("module", "unknown"),
|
|
171
|
+
"mutation_score": score,
|
|
172
|
+
"min_target_score": 0.85,
|
|
173
|
+
"certification": "APPROVED" if passed else "REJECTED"
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
|
|
177
|
+
def main():
|
|
178
|
+
parser = argparse.ArgumentParser(description="MIPROv2 Prompt Assertion Tuner")
|
|
179
|
+
subparsers = parser.add_subparsers(dest="subcommand", help="Subcommand to execute")
|
|
180
|
+
|
|
181
|
+
# compile-module
|
|
182
|
+
comp_p = subparsers.add_parser("compile-module", help="Compile and optimize a prompt module")
|
|
183
|
+
comp_p.add_argument("--signature", default="AssertionGenerator", help="Target signature name")
|
|
184
|
+
comp_p.add_argument("--trials", type=int, default=20, help="Number of search trials")
|
|
185
|
+
comp_p.add_argument("--out-module", help="Path to write compiled module JSON")
|
|
186
|
+
|
|
187
|
+
# evaluate
|
|
188
|
+
eval_p = subparsers.add_parser("evaluate", help="Evaluate a compiled prompt module")
|
|
189
|
+
eval_p.add_argument("--module", required=True, help="Path to compiled module JSON")
|
|
190
|
+
|
|
191
|
+
args = parser.parse_args()
|
|
192
|
+
tuner = MiproAssertionTuner()
|
|
193
|
+
|
|
194
|
+
if args.subcommand == "compile-module":
|
|
195
|
+
res = tuner.compile_module(signature_name=args.signature, trials=args.trials, out_module=args.out_module)
|
|
196
|
+
print(json.dumps(res, indent=2))
|
|
197
|
+
sys.exit(0 if res["status"] == "PASS" else 1)
|
|
198
|
+
|
|
199
|
+
elif args.subcommand == "evaluate":
|
|
200
|
+
res = tuner.evaluate(module_path=args.module)
|
|
201
|
+
print(json.dumps(res, indent=2))
|
|
202
|
+
sys.exit(0 if res["status"] == "PASS" else 1)
|
|
203
|
+
|
|
204
|
+
else:
|
|
205
|
+
parser.print_help()
|
|
206
|
+
sys.exit(1)
|
|
207
|
+
|
|
208
|
+
|
|
209
|
+
if __name__ == "__main__":
|
|
210
|
+
main()
|
|
@@ -0,0 +1,311 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
API Network Mocking & Chaos Fault Injection Shield
|
|
4
|
+
--------------------------------------------------
|
|
5
|
+
Zero-Token Route Interception and Chaos Network Resilience Generator.
|
|
6
|
+
Decouples UI automation tests from unstable backend staging services,
|
|
7
|
+
rate limits, and 3rd-party payment gateways (Stripe, VNPAY, SMS OTP).
|
|
8
|
+
"""
|
|
9
|
+
|
|
10
|
+
import os
|
|
11
|
+
import json
|
|
12
|
+
import argparse
|
|
13
|
+
from typing import Dict, Any, Optional
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
class NetworkMockShield:
|
|
17
|
+
"""Zero-Token Network Interception & Chaos Fault Generator."""
|
|
18
|
+
|
|
19
|
+
PRESETS = {
|
|
20
|
+
"payment_success": {
|
|
21
|
+
"status": 200,
|
|
22
|
+
"body": {"status": "SUCCESS", "transactionId": "TX_MOCK_999888", "amount": 100.0, "currency": "USD"},
|
|
23
|
+
"description": "Simulates successful 3rd-party payment gateway transaction"
|
|
24
|
+
},
|
|
25
|
+
"payment_declined": {
|
|
26
|
+
"status": 402,
|
|
27
|
+
"body": {"status": "FAILED", "code": "INSUFFICIENT_FUNDS", "message": "Card declined by issuing bank"},
|
|
28
|
+
"description": "Simulates credit card decline / insufficient funds"
|
|
29
|
+
},
|
|
30
|
+
"auth_401_expired": {
|
|
31
|
+
"status": 401,
|
|
32
|
+
"body": {"error": "Unauthorized", "message": "JWT token expired. Please re-authenticate."},
|
|
33
|
+
"description": "Simulates expired authentication session"
|
|
34
|
+
},
|
|
35
|
+
"auth_403_forbidden": {
|
|
36
|
+
"status": 403,
|
|
37
|
+
"body": {"error": "Forbidden", "message": "Insufficient permissions to access resource."},
|
|
38
|
+
"description": "Simulates RBAC permission denial"
|
|
39
|
+
},
|
|
40
|
+
"rate_limit_429": {
|
|
41
|
+
"status": 429,
|
|
42
|
+
"body": {"error": "Too Many Requests", "retryAfter": 60},
|
|
43
|
+
"description": "Simulates API rate limit throttling"
|
|
44
|
+
},
|
|
45
|
+
"server_crash_500": {
|
|
46
|
+
"status": 500,
|
|
47
|
+
"body": {"error": "Internal Server Error", "traceId": "ERR_500_MOCK"},
|
|
48
|
+
"description": "Simulates unhandled backend exception"
|
|
49
|
+
},
|
|
50
|
+
"service_down_503": {
|
|
51
|
+
"status": 503,
|
|
52
|
+
"body": {"error": "Service Unavailable", "message": "Backend microservice unreachable"},
|
|
53
|
+
"description": "Simulates backend downtime"
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
THROTTLING_PROFILES = {
|
|
58
|
+
"slow_3g": {"downloadThroughput": 500 * 1024 // 8, "uploadThroughput": 500 * 1024 // 8, "latency": 400},
|
|
59
|
+
"fast_3g": {"downloadThroughput": 1.6 * 1024 * 1024 // 8, "uploadThroughput": 750 * 1024 // 8, "latency": 150},
|
|
60
|
+
"high_latency": {"downloadThroughput": 10 * 1024 * 1024, "uploadThroughput": 5 * 1024 * 1024, "latency": 2500},
|
|
61
|
+
"offline": {"offline": True, "downloadThroughput": 0, "uploadThroughput": 0, "latency": 0}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
@classmethod
|
|
65
|
+
def generate_playwright_ts(cls, url_pattern: str, status: int = 200, body: Optional[Dict[str, Any]] = None, delay_ms: int = 0) -> str:
|
|
66
|
+
"""Generates Playwright TypeScript route interception code."""
|
|
67
|
+
body_json = json.dumps(body or {}, indent=2)
|
|
68
|
+
code = [
|
|
69
|
+
f"// Mock API Interception for '{url_pattern}'",
|
|
70
|
+
f"await page.route('{url_pattern}', async (route) => {{",
|
|
71
|
+
]
|
|
72
|
+
if delay_ms > 0:
|
|
73
|
+
code.append(f" await new Promise(r => setTimeout(r, {delay_ms}));")
|
|
74
|
+
code.extend([
|
|
75
|
+
" await route.fulfill({",
|
|
76
|
+
f" status: {status},",
|
|
77
|
+
" contentType: 'application/json',",
|
|
78
|
+
f" body: JSON.stringify({body_json}),",
|
|
79
|
+
" });",
|
|
80
|
+
"});"
|
|
81
|
+
])
|
|
82
|
+
return "\n".join(code)
|
|
83
|
+
|
|
84
|
+
@classmethod
|
|
85
|
+
def generate_playwright_python(cls, url_pattern: str, status: int = 200, body: Optional[Dict[str, Any]] = None, delay_ms: int = 0) -> str:
|
|
86
|
+
"""Generates Playwright Python route interception code."""
|
|
87
|
+
body_json = json.dumps(body or {})
|
|
88
|
+
code = [
|
|
89
|
+
f"# Mock API Interception for '{url_pattern}'",
|
|
90
|
+
"import time, json",
|
|
91
|
+
"def handle_route(route):",
|
|
92
|
+
]
|
|
93
|
+
if delay_ms > 0:
|
|
94
|
+
code.append(f" time.sleep({delay_ms / 1000.0})")
|
|
95
|
+
code.extend([
|
|
96
|
+
" route.fulfill(",
|
|
97
|
+
f" status={status},",
|
|
98
|
+
" content_type='application/json',",
|
|
99
|
+
f" body=json.dumps({body_json})",
|
|
100
|
+
" )",
|
|
101
|
+
f"page.route('{url_pattern}', handle_route)"
|
|
102
|
+
])
|
|
103
|
+
return "\n".join(code)
|
|
104
|
+
|
|
105
|
+
@classmethod
|
|
106
|
+
def generate_cypress_js(cls, url_pattern: str, method: str = "POST", status: int = 200, body: Optional[Dict[str, Any]] = None, delay_ms: int = 0) -> str:
|
|
107
|
+
"""Generates Cypress cy.intercept code."""
|
|
108
|
+
body_json = json.dumps(body or {})
|
|
109
|
+
delay_opt = f", delay: {delay_ms}" if delay_ms > 0 else ""
|
|
110
|
+
return f"cy.intercept('{method}', '{url_pattern}', {{ statusCode: {status}, body: {body_json}{delay_opt} }}).as('mock_{url_pattern.split('/')[-1]}');"
|
|
111
|
+
|
|
112
|
+
@classmethod
|
|
113
|
+
def generate_playwright_har_harness(cls, har_path: str, mode: str = "replay", url_glob: str = "**/*", lang: str = "ts") -> str:
|
|
114
|
+
"""
|
|
115
|
+
Generates Playwright Native Zero-Latency HAR Record & Replay harness.
|
|
116
|
+
- record: Dumps real network traffic to HAR file.
|
|
117
|
+
- replay: Intercepts all matching requests and returns responses from HAR with 0ms delay.
|
|
118
|
+
"""
|
|
119
|
+
if mode == "record":
|
|
120
|
+
if lang == "python":
|
|
121
|
+
return "\n".join([
|
|
122
|
+
"# --- ZERO-LATENCY HAR RECORDING HARNESS (Playwright Python) ---",
|
|
123
|
+
f"# Dumps live network traffic to '{har_path}'",
|
|
124
|
+
"context = browser.new_context(",
|
|
125
|
+
f" record_har_path='{har_path}',",
|
|
126
|
+
" record_har_mode='minimal',",
|
|
127
|
+
f" record_har_url_filter='{url_glob}'",
|
|
128
|
+
")",
|
|
129
|
+
"page = context.new_page()",
|
|
130
|
+
f"# Note: Run 'python tools/network_mock_shield.py --har-sanitize {har_path}' before committing to git!"
|
|
131
|
+
])
|
|
132
|
+
else:
|
|
133
|
+
return "\n".join([
|
|
134
|
+
"// --- ZERO-LATENCY HAR RECORDING HARNESS (Playwright TS) ---",
|
|
135
|
+
f"// Dumps live network traffic to '{har_path}'",
|
|
136
|
+
"const context = await browser.newContext({",
|
|
137
|
+
" recordHar: {",
|
|
138
|
+
f" path: '{har_path}',",
|
|
139
|
+
" mode: 'minimal',",
|
|
140
|
+
f" urlFilter: '{url_glob}'",
|
|
141
|
+
" }",
|
|
142
|
+
"});",
|
|
143
|
+
"const page = await context.newPage();",
|
|
144
|
+
f"// Note: Run 'python tools/network_mock_shield.py --har-sanitize {har_path}' before committing to git!"
|
|
145
|
+
])
|
|
146
|
+
else:
|
|
147
|
+
# Replay Mode
|
|
148
|
+
if lang == "python":
|
|
149
|
+
return "\n".join([
|
|
150
|
+
"# --- ZERO-LATENCY HAR REPLAY HARNESS (Playwright Python) ---",
|
|
151
|
+
"# Replays 100% network responses from local HAR with 0ms delay (Immune to backend downtime)",
|
|
152
|
+
"page.route_from_har(",
|
|
153
|
+
f" har_id='{har_path}',",
|
|
154
|
+
f" url='{url_glob}',",
|
|
155
|
+
" not_found='fallback',",
|
|
156
|
+
" update=False",
|
|
157
|
+
")"
|
|
158
|
+
])
|
|
159
|
+
else:
|
|
160
|
+
return "\n".join([
|
|
161
|
+
"// --- ZERO-LATENCY HAR REPLAY HARNESS (Playwright TS) ---",
|
|
162
|
+
"// Replays 100% network responses from local HAR with 0ms delay (Immune to backend downtime)",
|
|
163
|
+
f"await page.routeFromHAR('{har_path}', {{",
|
|
164
|
+
f" url: '{url_glob}',",
|
|
165
|
+
" notFound: 'fallback',",
|
|
166
|
+
" update: false",
|
|
167
|
+
"});"
|
|
168
|
+
])
|
|
169
|
+
|
|
170
|
+
@classmethod
|
|
171
|
+
def sanitize_har_file(cls, input_har_path: str, output_har_path: Optional[str] = None) -> int:
|
|
172
|
+
"""
|
|
173
|
+
Parses a recorded HAR file and redacts sensitive PII & credentials:
|
|
174
|
+
Bearer tokens, Authorization headers, Cookie headers, passwords, API keys.
|
|
175
|
+
Returns the count of redacted entries.
|
|
176
|
+
"""
|
|
177
|
+
import re
|
|
178
|
+
if not os.path.exists(input_har_path):
|
|
179
|
+
raise FileNotFoundError(f"HAR file not found: {input_har_path}")
|
|
180
|
+
|
|
181
|
+
with open(input_har_path, "r", encoding="utf-8", errors="replace") as fp:
|
|
182
|
+
data = json.load(fp)
|
|
183
|
+
|
|
184
|
+
entries = data.get("log", {}).get("entries", [])
|
|
185
|
+
redacted_count = 0
|
|
186
|
+
|
|
187
|
+
pii_patterns = [
|
|
188
|
+
(re.compile(r'"(password|pass|secret|token|api_?key|access_?token)"\s*:\s*"[^"]+"', re.IGNORECASE), r'"\1": "REDACTED_SECRET"'),
|
|
189
|
+
(re.compile(r'"(credit_?card|card_?number|pan)"\s*:\s*"[^"]+"', re.IGNORECASE), r'"\1": "411111******1111"'),
|
|
190
|
+
(re.compile(r'"(cvv|cvc)"\s*:\s*"[^"]+"', re.IGNORECASE), r'"\1": "999"'),
|
|
191
|
+
(re.compile(r'"(email)"\s*:\s*"[^"]+"', re.IGNORECASE), r'"\1": "auto_user@enterprise.local"')
|
|
192
|
+
]
|
|
193
|
+
|
|
194
|
+
for entry in entries:
|
|
195
|
+
req = entry.get("request", {})
|
|
196
|
+
# 1. Scrub Request Headers
|
|
197
|
+
for header in req.get("headers", []):
|
|
198
|
+
h_name = header.get("name", "").lower()
|
|
199
|
+
if h_name in ("authorization", "cookie", "x-api-key", "token", "proxy-authorization"):
|
|
200
|
+
header["value"] = "Bearer REDACTED_TOKEN" if "bearer" in header.get("value", "").lower() else "REDACTED"
|
|
201
|
+
redacted_count += 1
|
|
202
|
+
|
|
203
|
+
# 2. Scrub Request Post Data
|
|
204
|
+
post_data = req.get("postData", {})
|
|
205
|
+
if "text" in post_data:
|
|
206
|
+
txt = post_data["text"]
|
|
207
|
+
for pat, rep in pii_patterns:
|
|
208
|
+
txt = pat.sub(rep, txt)
|
|
209
|
+
post_data["text"] = txt
|
|
210
|
+
|
|
211
|
+
# 3. Scrub Response Headers (Set-Cookie)
|
|
212
|
+
resp = entry.get("response", {})
|
|
213
|
+
for header in resp.get("headers", []):
|
|
214
|
+
h_name = header.get("name", "").lower()
|
|
215
|
+
if h_name in ("set-cookie", "authorization"):
|
|
216
|
+
header["value"] = "REDACTED_COOKIE"
|
|
217
|
+
redacted_count += 1
|
|
218
|
+
|
|
219
|
+
out_path = output_har_path or input_har_path
|
|
220
|
+
with open(out_path, "w", encoding="utf-8") as fp:
|
|
221
|
+
json.dump(data, fp, indent=2)
|
|
222
|
+
|
|
223
|
+
return redacted_count
|
|
224
|
+
|
|
225
|
+
@classmethod
|
|
226
|
+
def get_preset(cls, preset_name: str) -> Dict[str, Any]:
|
|
227
|
+
"""Returns preset details or raises ValueError."""
|
|
228
|
+
if preset_name not in cls.PRESETS:
|
|
229
|
+
raise ValueError(f"Unknown preset '{preset_name}'. Available: {list(cls.PRESETS.keys())}")
|
|
230
|
+
return cls.PRESETS[preset_name]
|
|
231
|
+
|
|
232
|
+
|
|
233
|
+
def main():
|
|
234
|
+
parser = argparse.ArgumentParser(description="API Network Mocking & Chaos Shield Generator")
|
|
235
|
+
parser.add_argument("--url", default="**/api/**", help="URL pattern to intercept")
|
|
236
|
+
parser.add_argument("--preset", choices=list(NetworkMockShield.PRESETS.keys()), default=None, help="Use pre-configured mock scenario")
|
|
237
|
+
parser.add_argument("--status", type=int, default=200, help="HTTP response status code")
|
|
238
|
+
parser.add_argument("--body", default=None, help="JSON response body string or file")
|
|
239
|
+
parser.add_argument("--delay", type=int, default=0, help="Artificial latency in milliseconds")
|
|
240
|
+
parser.add_argument("--lang", choices=["ts", "python", "cypress"], default="ts", help="Target script language")
|
|
241
|
+
parser.add_argument("--list-presets", action="store_true", help="List all available presets")
|
|
242
|
+
|
|
243
|
+
# HAR Record & Replay options
|
|
244
|
+
parser.add_argument("--har-mode", choices=["record", "replay"], default=None, help="Generate Playwright HAR record or replay harness")
|
|
245
|
+
parser.add_argument("--har-path", default="fixtures/network_trace.har", help="Path to HAR archive file")
|
|
246
|
+
parser.add_argument("--har-sanitize", default=None, help="Sanitize PII, tokens, and cookies from recorded HAR file")
|
|
247
|
+
parser.add_argument("--har-out", default=None, help="Optional output path for sanitized HAR")
|
|
248
|
+
|
|
249
|
+
args = parser.parse_args()
|
|
250
|
+
|
|
251
|
+
# Handle HAR Sanitization
|
|
252
|
+
if args.har_sanitize:
|
|
253
|
+
redacted = NetworkMockShield.sanitize_har_file(args.har_sanitize, output_har_path=args.har_out)
|
|
254
|
+
target = args.har_out or args.har_sanitize
|
|
255
|
+
print(f"✅ [HAR SANITIZED] Scrubbed {redacted} sensitive headers/tokens in: {target}")
|
|
256
|
+
return
|
|
257
|
+
|
|
258
|
+
# Handle HAR Harness Generation
|
|
259
|
+
if args.har_mode:
|
|
260
|
+
code = NetworkMockShield.generate_playwright_har_harness(
|
|
261
|
+
har_path=args.har_path,
|
|
262
|
+
mode=args.har_mode,
|
|
263
|
+
url_glob=args.url,
|
|
264
|
+
lang=args.lang
|
|
265
|
+
)
|
|
266
|
+
print("======================================================================")
|
|
267
|
+
print(f" PLAYWRIGHT ZERO-LATENCY HAR {args.har_mode.upper()} HARNESS ({args.lang.upper()})")
|
|
268
|
+
print("======================================================================")
|
|
269
|
+
print(code)
|
|
270
|
+
print("======================================================================")
|
|
271
|
+
return
|
|
272
|
+
|
|
273
|
+
if args.list_presets:
|
|
274
|
+
print("======================================================================")
|
|
275
|
+
print(" AVAILABLE NETWORK MOCK & CHAOS FAULT PRESETS")
|
|
276
|
+
print("======================================================================")
|
|
277
|
+
for k, v in NetworkMockShield.PRESETS.items():
|
|
278
|
+
print(f"• {k.ljust(22)}: Status {v['status']} - {v['description']}")
|
|
279
|
+
print("======================================================================")
|
|
280
|
+
return
|
|
281
|
+
|
|
282
|
+
status = args.status
|
|
283
|
+
body = {}
|
|
284
|
+
|
|
285
|
+
if args.preset:
|
|
286
|
+
preset = NetworkMockShield.get_preset(args.preset)
|
|
287
|
+
status = preset["status"]
|
|
288
|
+
body = preset["body"]
|
|
289
|
+
elif args.body:
|
|
290
|
+
if os.path.exists(args.body):
|
|
291
|
+
with open(args.body, "r", encoding="utf-8") as f:
|
|
292
|
+
body = json.load(f)
|
|
293
|
+
else:
|
|
294
|
+
body = json.loads(args.body)
|
|
295
|
+
|
|
296
|
+
if args.lang == "ts":
|
|
297
|
+
code = NetworkMockShield.generate_playwright_ts(args.url, status=status, body=body, delay_ms=args.delay)
|
|
298
|
+
elif args.lang == "python":
|
|
299
|
+
code = NetworkMockShield.generate_playwright_python(args.url, status=status, body=body, delay_ms=args.delay)
|
|
300
|
+
else:
|
|
301
|
+
code = NetworkMockShield.generate_cypress_js(args.url, status=status, body=body, delay_ms=args.delay)
|
|
302
|
+
|
|
303
|
+
print("======================================================================")
|
|
304
|
+
print(f" NETWORK MOCK SHIELD GENERATED ({args.lang.upper()})")
|
|
305
|
+
print("======================================================================")
|
|
306
|
+
print(code)
|
|
307
|
+
print("======================================================================")
|
|
308
|
+
|
|
309
|
+
|
|
310
|
+
if __name__ == "__main__":
|
|
311
|
+
main()
|