@teevee98/synapse-hub 0.0.0-stage → 3.8.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +171 -0
- package/README.md +170 -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 +198 -0
- package/docs/ARCHITECTURE.md +199 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +174 -0
- package/docs/CLI_REFERENCE.md +176 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +118 -0
- package/docs/QUALITY_GATES.md +118 -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 +1358 -0
- package/docs/schemas/synapse.config.schema.json +86 -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 +31 -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 +2074 -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 +262 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +190 -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 +2403 -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 +306 -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 +725 -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 +1271 -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,239 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
# Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
|
|
5
|
+
|
|
6
|
+
"""
|
|
7
|
+
Tree/Graph-of-Thoughts Exploratory Testing Engine (Princeton ToT & ETH GoT Pattern)
|
|
8
|
+
----------------------------------------------------------------------------------
|
|
9
|
+
Expands linear user stories into deliberative non-linear exploration trees:
|
|
10
|
+
1. Multi-Branch Deliberation: Generates Happy Path, Boundary/Race, and Negative/Chaos branches.
|
|
11
|
+
2. Risk-Scored Beam Search: Evaluates thought states and prunes low-risk tautological paths.
|
|
12
|
+
3. Clean POM Synthesis: Produces structured test scenarios ready for Clean POM Page Classes.
|
|
13
|
+
4. Multi-Hypothesis RCA: Diagnoses test failures across competing failure hypotheses (DOM_TIMEOUT, ASYNC_RACE, DB_LOCK, BACKEND_500).
|
|
14
|
+
|
|
15
|
+
Usage:
|
|
16
|
+
python tools/tot_exploratory_tester.py expand-story --story-file docs/stories/US_PAYMENT.md --max-depth 3 --beam-width 3
|
|
17
|
+
python tools/tot_exploratory_tester.py rca-hypotheses --error-log reports/failed.log
|
|
18
|
+
"""
|
|
19
|
+
|
|
20
|
+
import os
|
|
21
|
+
import sys
|
|
22
|
+
import re
|
|
23
|
+
import json
|
|
24
|
+
import argparse
|
|
25
|
+
from typing import Dict, Any, List, Optional, cast
|
|
26
|
+
|
|
27
|
+
# Enforce UTF-8 stdout encoding
|
|
28
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
29
|
+
try:
|
|
30
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
31
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
32
|
+
except Exception:
|
|
33
|
+
pass
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
class TotExploratoryTester:
|
|
37
|
+
"""Tree-of-Thoughts Engine for Exploratory QA and Root Cause Analysis."""
|
|
38
|
+
|
|
39
|
+
def __init__(self, repo_root: Optional[str] = None):
|
|
40
|
+
self.repo_root = repo_root or os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
|
|
41
|
+
|
|
42
|
+
def expand_story(self, story_content: str, max_depth: int = 3, beam_width: int = 3) -> Dict[str, Any]:
|
|
43
|
+
"""Decomposes story into a 3-branch Tree of Thoughts with risk scores."""
|
|
44
|
+
# Extract title and criteria
|
|
45
|
+
lines = [line.strip() for line in story_content.splitlines() if line.strip()]
|
|
46
|
+
title = lines[0] if lines else "Untitled User Story"
|
|
47
|
+
if title.startswith("#"):
|
|
48
|
+
title = title.lstrip("#").strip()
|
|
49
|
+
|
|
50
|
+
# Extract keywords
|
|
51
|
+
keywords = re.findall(r'\b[a-zA-Z]{4,}\b', story_content.lower())
|
|
52
|
+
is_checkout = any(k in keywords for k in ["cart", "checkout", "pay", "order", "price"])
|
|
53
|
+
is_auth = any(k in keywords for k in ["login", "auth", "token", "password", "sso"])
|
|
54
|
+
|
|
55
|
+
context_domain = "FINANCIAL_CHECKOUT" if is_checkout else ("AUTH_SESSION" if is_auth else "GENERAL_CRUD")
|
|
56
|
+
|
|
57
|
+
# 3 Branches:
|
|
58
|
+
# 1. Happy Path
|
|
59
|
+
# 2. Boundary / Session Interruption / Race Condition
|
|
60
|
+
# 3. Negative / Chaos / Backend Fault
|
|
61
|
+
branches = [
|
|
62
|
+
{
|
|
63
|
+
"branch_id": "BRANCH_HAPPY_PATH",
|
|
64
|
+
"name": "Standard Happy Business Path",
|
|
65
|
+
"risk_score": 0.25,
|
|
66
|
+
"thoughts": [
|
|
67
|
+
{"step": 1, "thought": "Navigate to initial entity view and ensure clean pre-conditions."},
|
|
68
|
+
{"step": 2, "thought": "Populate valid payload attributes and trigger submit action."},
|
|
69
|
+
{"step": 3, "thought": "Verify success confirmation modal and assert database record creation."}
|
|
70
|
+
]
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
"branch_id": "BRANCH_BOUNDARY_RACE",
|
|
74
|
+
"name": "Boundary, Session Interruption & Concurrency Path",
|
|
75
|
+
"risk_score": 0.88,
|
|
76
|
+
"thoughts": [
|
|
77
|
+
{"step": 1, "thought": "Simulate session expiration or token invalidation mid-flow."},
|
|
78
|
+
{"step": 2, "thought": "Perform rapid double-click on submission action to probe race condition."},
|
|
79
|
+
{"step": 3, "thought": "Assert idempotency: strictly 1 transaction created, duplicate blocked gracefully."}
|
|
80
|
+
]
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"branch_id": "BRANCH_NEGATIVE_CHAOS",
|
|
84
|
+
"name": "Negative Error Handling & Chaos Fault Path",
|
|
85
|
+
"risk_score": 0.72,
|
|
86
|
+
"thoughts": [
|
|
87
|
+
{"step": 1, "thought": "Inject malformed/boundary input payload exceeding maximum character limits."},
|
|
88
|
+
{"step": 2, "thought": "Simulate backend 500 error or database connection timeout via route stub."},
|
|
89
|
+
{"step": 3, "thought": "Assert user-friendly error toast, zero data corruption, and retry availability."}
|
|
90
|
+
]
|
|
91
|
+
}
|
|
92
|
+
]
|
|
93
|
+
|
|
94
|
+
# Beam search selection: sort by risk score descending and take beam_width
|
|
95
|
+
sorted_branches = sorted(branches, key=lambda b: cast(float, b["risk_score"]), reverse=True)
|
|
96
|
+
selected_branches = sorted_branches[:beam_width]
|
|
97
|
+
|
|
98
|
+
return {
|
|
99
|
+
"status": "PASS",
|
|
100
|
+
"story_title": title,
|
|
101
|
+
"domain": context_domain,
|
|
102
|
+
"max_depth": max_depth,
|
|
103
|
+
"beam_width": beam_width,
|
|
104
|
+
"total_branches_explored": len(branches),
|
|
105
|
+
"highest_risk_branch": selected_branches[0]["branch_id"],
|
|
106
|
+
"branches": selected_branches,
|
|
107
|
+
"clean_pom_recommendations": [
|
|
108
|
+
f"Implement {context_domain}Page extending BasePage",
|
|
109
|
+
"Encapsulate double-click debounce in clickSubmitSafe()",
|
|
110
|
+
"Assert boundary toast in verifyErrorMessageDisplayed()"
|
|
111
|
+
]
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
def rca_hypotheses(self, error_log: str, hypotheses: Optional[List[str]] = None) -> Dict[str, Any]:
|
|
115
|
+
"""Performs multi-hypothesis Root Cause Analysis on test failures."""
|
|
116
|
+
if not hypotheses:
|
|
117
|
+
hypotheses = ["DOM_TIMEOUT", "ASYNC_RACE", "DB_LOCK", "BACKEND_500", "STALE_SELECTOR"]
|
|
118
|
+
|
|
119
|
+
log_lower = error_log.lower()
|
|
120
|
+
scored_hypotheses = []
|
|
121
|
+
|
|
122
|
+
for hyp in hypotheses:
|
|
123
|
+
score = 0.0
|
|
124
|
+
evidence = []
|
|
125
|
+
|
|
126
|
+
if hyp == "DOM_TIMEOUT":
|
|
127
|
+
if "timed out" in log_lower or "waitfortimeout" in log_lower or "5000ms" in log_lower:
|
|
128
|
+
score += 0.85
|
|
129
|
+
evidence.append("Found timeout or waiting duration signature in log")
|
|
130
|
+
if "element is not visible" in log_lower or "tobevisible" in log_lower:
|
|
131
|
+
score += 0.10
|
|
132
|
+
evidence.append("Element visibility expectation failed")
|
|
133
|
+
|
|
134
|
+
elif hyp == "ASYNC_RACE":
|
|
135
|
+
if "click intercepted" in log_lower or "animation" in log_lower or "detached" in log_lower:
|
|
136
|
+
score += 0.90
|
|
137
|
+
evidence.append("Overlay or detachment signature points to async race condition")
|
|
138
|
+
if "networkidle" in log_lower or "pending" in log_lower:
|
|
139
|
+
score += 0.15
|
|
140
|
+
evidence.append("Pending network requests active during action")
|
|
141
|
+
|
|
142
|
+
elif hyp == "DB_LOCK":
|
|
143
|
+
if "deadlock" in log_lower or "lock" in log_lower or "sql" in log_lower or "unique constraint" in log_lower:
|
|
144
|
+
score += 0.88
|
|
145
|
+
evidence.append("Database lock or constraint collision detected in trace")
|
|
146
|
+
|
|
147
|
+
elif hyp == "BACKEND_500":
|
|
148
|
+
if re.search(r'\b500\b', log_lower) and not re.search(r'\b500\d+ms\b', log_lower) and ("http" in log_lower or "status" in log_lower or "server error" in log_lower or "internal" in log_lower):
|
|
149
|
+
score += 0.95
|
|
150
|
+
evidence.append("HTTP 500 status code explicitly logged")
|
|
151
|
+
elif "internal server error" in log_lower:
|
|
152
|
+
score += 0.95
|
|
153
|
+
evidence.append("Internal Server Error explicitly logged")
|
|
154
|
+
|
|
155
|
+
elif hyp == "STALE_SELECTOR":
|
|
156
|
+
if "locator" in log_lower or "selector" in log_lower or "xpath" in log_lower:
|
|
157
|
+
score += 0.70
|
|
158
|
+
evidence.append("Locator or selector syntax mentioned in failure message")
|
|
159
|
+
|
|
160
|
+
# Baseline confidence
|
|
161
|
+
if not evidence:
|
|
162
|
+
score = 0.10
|
|
163
|
+
evidence.append("No direct signature found; baseline background likelihood")
|
|
164
|
+
|
|
165
|
+
scored_hypotheses.append({
|
|
166
|
+
"hypothesis": hyp,
|
|
167
|
+
"confidence_score": round(min(1.0, score), 3),
|
|
168
|
+
"evidence": evidence
|
|
169
|
+
})
|
|
170
|
+
|
|
171
|
+
scored_hypotheses.sort(key=lambda h: cast(float, h["confidence_score"]), reverse=True)
|
|
172
|
+
winner = scored_hypotheses[0]
|
|
173
|
+
|
|
174
|
+
recommendations = {
|
|
175
|
+
"DOM_TIMEOUT": "Replace hardcoded delay with page.waitForLoadState('networkidle') or element.waitFor({state: 'visible'})",
|
|
176
|
+
"ASYNC_RACE": "Use clickSafe() helper with overlay detachment waiting or dispatchEvent('click')",
|
|
177
|
+
"DB_LOCK": "Randomize entity code prefix via DataGenerator.uniqueCode('AUTO_') and enforce teardown cleanup",
|
|
178
|
+
"BACKEND_500": "Inspect backend server logs for uncaught 500 NullPointerException or DB connection pool exhaustion",
|
|
179
|
+
"STALE_SELECTOR": "Run tools/agentless_patcher.py heal-failure to update stale attribute to ARIA role"
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
return {
|
|
183
|
+
"status": "PASS",
|
|
184
|
+
"primary_root_cause": winner["hypothesis"],
|
|
185
|
+
"confidence": winner["confidence_score"],
|
|
186
|
+
"recommended_fix": recommendations.get(str(winner["hypothesis"]), "Review stacktrace with team"),
|
|
187
|
+
"ranked_hypotheses": scored_hypotheses
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
|
|
191
|
+
def main():
|
|
192
|
+
parser = argparse.ArgumentParser(description="Tree-of-Thoughts Exploratory Testing Engine")
|
|
193
|
+
subparsers = parser.add_subparsers(dest="subcommand", help="Subcommand to execute")
|
|
194
|
+
|
|
195
|
+
# expand-story
|
|
196
|
+
exp_p = subparsers.add_parser("expand-story", help="Expand User Story into Tree of Thoughts")
|
|
197
|
+
exp_p.add_argument("--story-file", required=True, help="Path to story markdown file or text string")
|
|
198
|
+
exp_p.add_argument("--max-depth", type=int, default=3, help="Max thought tree depth")
|
|
199
|
+
exp_p.add_argument("--beam-width", type=int, default=3, help="Beam search width")
|
|
200
|
+
exp_p.add_argument("--out-graph", help="Optional path to output graph JSON")
|
|
201
|
+
|
|
202
|
+
# rca-hypotheses
|
|
203
|
+
rca_p = subparsers.add_parser("rca-hypotheses", help="Diagnose failure via multi-hypothesis RCA")
|
|
204
|
+
rca_p.add_argument("--error-log", required=True, help="Path to error log or log string")
|
|
205
|
+
rca_p.add_argument("--hypotheses", help="Comma-separated hypotheses list")
|
|
206
|
+
|
|
207
|
+
args = parser.parse_args()
|
|
208
|
+
tester = TotExploratoryTester()
|
|
209
|
+
|
|
210
|
+
if args.subcommand == "expand-story":
|
|
211
|
+
content = args.story_file
|
|
212
|
+
if os.path.exists(args.story_file):
|
|
213
|
+
with open(args.story_file, "r", encoding="utf-8", errors="replace") as f:
|
|
214
|
+
content = f.read()
|
|
215
|
+
res = tester.expand_story(content, max_depth=args.max_depth, beam_width=args.beam_width)
|
|
216
|
+
if args.out_graph:
|
|
217
|
+
os.makedirs(os.path.dirname(os.path.abspath(args.out_graph)), exist_ok=True)
|
|
218
|
+
with open(args.out_graph, "w", encoding="utf-8") as f:
|
|
219
|
+
json.dump(res, f, indent=2)
|
|
220
|
+
print(json.dumps(res, indent=2))
|
|
221
|
+
sys.exit(0)
|
|
222
|
+
|
|
223
|
+
elif args.subcommand == "rca-hypotheses":
|
|
224
|
+
log_content = args.error_log
|
|
225
|
+
if os.path.exists(args.error_log):
|
|
226
|
+
with open(args.error_log, "r", encoding="utf-8", errors="replace") as f:
|
|
227
|
+
log_content = f.read()
|
|
228
|
+
hyp_list = [h.strip() for h in args.hypotheses.split(",")] if args.hypotheses else None
|
|
229
|
+
res = tester.rca_hypotheses(error_log=log_content, hypotheses=hyp_list)
|
|
230
|
+
print(json.dumps(res, indent=2))
|
|
231
|
+
sys.exit(0)
|
|
232
|
+
|
|
233
|
+
else:
|
|
234
|
+
parser.print_help()
|
|
235
|
+
sys.exit(1)
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
if __name__ == "__main__":
|
|
239
|
+
main()
|
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Universal Data Flow & Teardown Tracer (Taint Analysis)
|
|
4
|
+
----------------------------------------------------
|
|
5
|
+
Performs AST-level Taint Analysis tracking test data lifecycle across test scripts:
|
|
6
|
+
1. SOURCE: Generation of dynamic unique identifiers (uniqueCode, DataGenerator).
|
|
7
|
+
2. PROPAGATE: Insertion / persistence into database or UI state.
|
|
8
|
+
3. SINK: Automated Teardown / Deletion / Cleanup.
|
|
9
|
+
|
|
10
|
+
Detects orphan test junk that pollutes test environments.
|
|
11
|
+
Supports dynamic target repository resolution (CLI flag, CWD auto-detect, ENV var).
|
|
12
|
+
"""
|
|
13
|
+
|
|
14
|
+
import os
|
|
15
|
+
import sys
|
|
16
|
+
import re
|
|
17
|
+
import json
|
|
18
|
+
import glob
|
|
19
|
+
import argparse
|
|
20
|
+
from datetime import datetime
|
|
21
|
+
|
|
22
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
23
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
24
|
+
try:
|
|
25
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
26
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
27
|
+
except Exception:
|
|
28
|
+
pass
|
|
29
|
+
|
|
30
|
+
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
|
|
31
|
+
HUB_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
|
|
32
|
+
REPORTS_DIR = os.path.join(HUB_ROOT, "reports")
|
|
33
|
+
OUTPUT_JSON = os.path.join(REPORTS_DIR, "data_flow_trace_report.json")
|
|
34
|
+
|
|
35
|
+
# ANSI Color codes
|
|
36
|
+
GREEN = "\033[92m"
|
|
37
|
+
RED = "\033[91m"
|
|
38
|
+
YELLOW = "\033[93m"
|
|
39
|
+
CYAN = "\033[96m"
|
|
40
|
+
BOLD = "\033[1m"
|
|
41
|
+
RESET = "\033[0m"
|
|
42
|
+
|
|
43
|
+
# Taint patterns
|
|
44
|
+
SOURCE_PATTERNS = [
|
|
45
|
+
re.compile(r'uniqueCode', re.IGNORECASE),
|
|
46
|
+
re.compile(r'DataGenerator\.', re.IGNORECASE),
|
|
47
|
+
re.compile(r'System\.currentTimeMillis', re.IGNORECASE),
|
|
48
|
+
re.compile(r'random[A-Z]\w+', re.IGNORECASE),
|
|
49
|
+
re.compile(r'ensure\w+Exists', re.IGNORECASE),
|
|
50
|
+
]
|
|
51
|
+
|
|
52
|
+
PROPAGATE_PATTERNS = [
|
|
53
|
+
re.compile(r'\.save\w*\(', re.IGNORECASE),
|
|
54
|
+
re.compile(r'\.themMoi\w*\(', re.IGNORECASE),
|
|
55
|
+
re.compile(r'\.fill\w*\(', re.IGNORECASE),
|
|
56
|
+
re.compile(r'\.create\w*\(', re.IGNORECASE),
|
|
57
|
+
re.compile(r'\.insert\w*\(', re.IGNORECASE),
|
|
58
|
+
re.compile(r'\b(?:save|persist|insert|themMoi)[A-Z]\w*\(', re.IGNORECASE),
|
|
59
|
+
]
|
|
60
|
+
|
|
61
|
+
SINK_PATTERNS = [
|
|
62
|
+
re.compile(r'\.delete\w*\(', re.IGNORECASE),
|
|
63
|
+
re.compile(r'\.xoa\w*\(', re.IGNORECASE),
|
|
64
|
+
re.compile(r'\.teardown\w*\(', re.IGNORECASE),
|
|
65
|
+
re.compile(r'\.cleanUp\w*\(', re.IGNORECASE),
|
|
66
|
+
re.compile(r'confirmDialog', re.IGNORECASE),
|
|
67
|
+
re.compile(r'ICON_DELETE', re.IGNORECASE),
|
|
68
|
+
re.compile(r'Xoá|Xoa|delete', re.IGNORECASE),
|
|
69
|
+
]
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
def resolve_target_repo(cli_target=None, cli_repo=None):
|
|
73
|
+
"""
|
|
74
|
+
Resolves the target repository path:
|
|
75
|
+
1. Explicit CLI flag: --repo / --path or positional target.
|
|
76
|
+
2. Environment variable: TARGET_PROJECT_DIR.
|
|
77
|
+
3. Current Working Directory (if different from Hub and has Scripts/ or tests/).
|
|
78
|
+
4. Default fallback: QA Hub root (parent of tools/).
|
|
79
|
+
"""
|
|
80
|
+
chosen = cli_repo or cli_target
|
|
81
|
+
if chosen:
|
|
82
|
+
resolved = os.path.abspath(chosen)
|
|
83
|
+
if not os.path.exists(resolved):
|
|
84
|
+
raise FileNotFoundError(f"Target repository path not found: {resolved}")
|
|
85
|
+
return resolved
|
|
86
|
+
|
|
87
|
+
env_dir = os.environ.get("TARGET_PROJECT_DIR")
|
|
88
|
+
if env_dir and os.path.exists(env_dir):
|
|
89
|
+
return os.path.abspath(env_dir)
|
|
90
|
+
|
|
91
|
+
cwd = os.path.abspath(os.getcwd())
|
|
92
|
+
if cwd.lower() != HUB_ROOT.lower():
|
|
93
|
+
if os.path.exists(os.path.join(cwd, "Scripts")) or os.path.exists(os.path.join(cwd, "tests")):
|
|
94
|
+
return cwd
|
|
95
|
+
|
|
96
|
+
return HUB_ROOT
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
def trace_script_dataflow(file_path, repo_root=None):
|
|
100
|
+
"""Traces source, propagation, and sink in a test script."""
|
|
101
|
+
with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
|
|
102
|
+
content = f.read()
|
|
103
|
+
|
|
104
|
+
base_root = repo_root or HUB_ROOT
|
|
105
|
+
try:
|
|
106
|
+
rel_path = os.path.relpath(file_path, base_root)
|
|
107
|
+
except ValueError:
|
|
108
|
+
rel_path = os.path.abspath(file_path)
|
|
109
|
+
|
|
110
|
+
tc_name = os.path.basename(os.path.dirname(file_path))
|
|
111
|
+
|
|
112
|
+
has_source = any(p.search(content) for p in SOURCE_PATTERNS)
|
|
113
|
+
has_propagate = any(p.search(content) for p in PROPAGATE_PATTERNS)
|
|
114
|
+
has_sink = any(p.search(content) for p in SINK_PATTERNS)
|
|
115
|
+
|
|
116
|
+
# Classification
|
|
117
|
+
tc_lower = tc_name.lower()
|
|
118
|
+
is_delete = any(k in tc_lower for k in ["xoa", "xóa", "xoá", "delete", "cleanup", "remove"])
|
|
119
|
+
is_edit = any(k in tc_lower for k in ["sua", "sửa", "chỉnh sửa", "chinh sua", "edit", "update", "modify"])
|
|
120
|
+
|
|
121
|
+
if is_delete or (has_sink and not has_propagate):
|
|
122
|
+
lifecycle = "CLEANUP_SUITE"
|
|
123
|
+
description = "Dedicated deletion / teardown test suite."
|
|
124
|
+
elif has_propagate and has_sink:
|
|
125
|
+
lifecycle = "IDEMPOTENT_CLEAN"
|
|
126
|
+
description = "Complete lifecycle: Dynamic creation + verified teardown."
|
|
127
|
+
elif has_propagate and not has_sink:
|
|
128
|
+
if is_edit:
|
|
129
|
+
lifecycle = "MUTATION_UPDATE"
|
|
130
|
+
description = "Modifies existing record in-place without creating new entities."
|
|
131
|
+
else:
|
|
132
|
+
lifecycle = "ORPHAN_DATA_RISK"
|
|
133
|
+
description = "Creates persistent entity on AUT without local teardown."
|
|
134
|
+
else:
|
|
135
|
+
lifecycle = "READ_ONLY"
|
|
136
|
+
description = "Read-only interaction flow."
|
|
137
|
+
|
|
138
|
+
return {
|
|
139
|
+
"file": rel_path,
|
|
140
|
+
"tc_name": tc_name,
|
|
141
|
+
"has_source": has_source,
|
|
142
|
+
"has_propagate": has_propagate,
|
|
143
|
+
"has_sink": has_sink,
|
|
144
|
+
"lifecycle": lifecycle,
|
|
145
|
+
"description": description
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
|
|
149
|
+
def run_data_flow_tracer(target_dir=None, repo_root=None):
|
|
150
|
+
"""Scans all test cases in target directory and traces data flow."""
|
|
151
|
+
root = repo_root or HUB_ROOT
|
|
152
|
+
scan_dir = target_dir or os.path.join(root, "Scripts")
|
|
153
|
+
script_files = []
|
|
154
|
+
if os.path.isdir(scan_dir):
|
|
155
|
+
for ext in ("*.groovy", "*.ts", "*.js", "*.py"):
|
|
156
|
+
script_files.extend(glob.glob(os.path.join(scan_dir, "**", ext), recursive=True))
|
|
157
|
+
|
|
158
|
+
results = []
|
|
159
|
+
counts = {
|
|
160
|
+
"IDEMPOTENT_CLEAN": 0,
|
|
161
|
+
"READ_ONLY": 0,
|
|
162
|
+
"CLEANUP_SUITE": 0,
|
|
163
|
+
"MUTATION_UPDATE": 0,
|
|
164
|
+
"ORPHAN_DATA_RISK": 0
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
for s in sorted(script_files):
|
|
168
|
+
res = trace_script_dataflow(s, repo_root=root)
|
|
169
|
+
results.append(res)
|
|
170
|
+
counts[res["lifecycle"]] = counts.get(res["lifecycle"], 0) + 1
|
|
171
|
+
|
|
172
|
+
total = len(script_files)
|
|
173
|
+
safe_count = counts["IDEMPOTENT_CLEAN"] + counts["READ_ONLY"] + counts["CLEANUP_SUITE"] + counts["MUTATION_UPDATE"]
|
|
174
|
+
purity_rate = (safe_count / max(1, total)) * 100 if total > 0 else 100.0
|
|
175
|
+
|
|
176
|
+
print(f"\n{BOLD}{CYAN}======================================================================{RESET}")
|
|
177
|
+
print(f"{BOLD}{CYAN} Universal Data Flow & TEARDOWN TRACER (Taint Audit) {RESET}")
|
|
178
|
+
print(f"{BOLD}{CYAN}======================================================================{RESET}")
|
|
179
|
+
print(f" Target Scope : {scan_dir}")
|
|
180
|
+
print(f" Total Audited Scripts : {total} Test Cases")
|
|
181
|
+
print(f" Idempotent Clean : {GREEN}{counts['IDEMPOTENT_CLEAN']}{RESET} (Dynamic data + verified teardown)")
|
|
182
|
+
print(f" Read-Only Invariant : {CYAN}{counts['READ_ONLY']}{RESET} (Search, filter, navigation, export)")
|
|
183
|
+
print(f" Dedicated Cleanup Suites: {GREEN}{counts['CLEANUP_SUITE']}{RESET} (Explicit deletion test cases)")
|
|
184
|
+
print(f" In-Place Mutations : {YELLOW}{counts['MUTATION_UPDATE']}{RESET} (Edit/update existing records)")
|
|
185
|
+
print(f" Orphan Data Risk : {RED if counts['ORPHAN_DATA_RISK'] > 0 else GREEN}{counts['ORPHAN_DATA_RISK']}{RESET} (Persistent creation without teardown)")
|
|
186
|
+
print(f" Database Hygiene Purity : {GREEN if purity_rate >= 90 else YELLOW}{purity_rate:.1f}%{RESET}")
|
|
187
|
+
print(f"{BOLD}{CYAN}======================================================================{RESET}\n")
|
|
188
|
+
|
|
189
|
+
# Save artifact
|
|
190
|
+
target_reports = os.path.join(root, "reports")
|
|
191
|
+
os.makedirs(target_reports, exist_ok=True)
|
|
192
|
+
report_file = os.path.join(target_reports, "data_flow_trace_report.json")
|
|
193
|
+
|
|
194
|
+
report_data = {
|
|
195
|
+
"timestamp": datetime.now().isoformat(),
|
|
196
|
+
"scan_dir": scan_dir,
|
|
197
|
+
"total_scripts": total,
|
|
198
|
+
"hygiene_purity_pct": round(purity_rate, 2),
|
|
199
|
+
"lifecycle_counts": counts,
|
|
200
|
+
"details": results
|
|
201
|
+
}
|
|
202
|
+
with open(report_file, "w", encoding="utf-8") as f:
|
|
203
|
+
json.dump(report_data, f, indent=2, ensure_ascii=False)
|
|
204
|
+
print(f"Detailed data-flow artifact saved to: {report_file}\n")
|
|
205
|
+
|
|
206
|
+
if root != HUB_ROOT:
|
|
207
|
+
# Also mirror to HUB_ROOT reports for central auditing
|
|
208
|
+
os.makedirs(REPORTS_DIR, exist_ok=True)
|
|
209
|
+
with open(OUTPUT_JSON, "w", encoding="utf-8") as f:
|
|
210
|
+
json.dump(report_data, f, indent=2, ensure_ascii=False)
|
|
211
|
+
|
|
212
|
+
return 0
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
def main():
|
|
216
|
+
parser = argparse.ArgumentParser(description="Universal Data Flow & Teardown Tracer")
|
|
217
|
+
parser.add_argument("target", nargs="?", default=None, help="Target repository or directory containing test scripts")
|
|
218
|
+
parser.add_argument("--repo", default=None, help="Target repository root")
|
|
219
|
+
parser.add_argument("--dir", "-d", default=None, help="Directory containing test scripts to trace")
|
|
220
|
+
args = parser.parse_args()
|
|
221
|
+
|
|
222
|
+
try:
|
|
223
|
+
repo_root = resolve_target_repo(cli_target=args.target, cli_repo=args.repo)
|
|
224
|
+
except FileNotFoundError as e:
|
|
225
|
+
print(f"❌ Error: {e}")
|
|
226
|
+
return 1
|
|
227
|
+
|
|
228
|
+
target_dir = args.dir
|
|
229
|
+
if not target_dir:
|
|
230
|
+
# Check if target is explicitly a directory with scripts
|
|
231
|
+
if args.target and os.path.isdir(args.target) and not os.path.exists(os.path.join(args.target, "Scripts")):
|
|
232
|
+
target_dir = args.target
|
|
233
|
+
else:
|
|
234
|
+
target_dir = os.path.join(repo_root, "Scripts")
|
|
235
|
+
|
|
236
|
+
return run_data_flow_tracer(target_dir=target_dir, repo_root=repo_root)
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
if __name__ == "__main__":
|
|
240
|
+
sys.exit(main())
|