@teevee98/synapse-hub 0.0.0-stage → 3.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +172 -0
  190. package/README.md +171 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +197 -0
  196. package/docs/ARCHITECTURE.md +198 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +175 -0
  200. package/docs/CLI_REFERENCE.md +177 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +121 -0
  206. package/docs/QUALITY_GATES.md +121 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1359 -0
  212. package/docs/schemas/synapse.config.schema.json +87 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +32 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2079 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +258 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +184 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2419 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +307 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +724 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1259 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,239 @@
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
+ 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())