@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,237 @@
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
+ tools/debt_harvester.py — Technical Debt & Shortcut Harvester
8
+ -----------------------------------------------------------
9
+ Scans repositories for deliberate simplification markers ('shortcut:' or 'ponytail:').
10
+ Compiles them into a structured Technical Debt Ledger so pragmatic compromises
11
+ and deferred upgrades are tracked and do not rot into forgotten technical debt.
12
+
13
+ Usage:
14
+ python3 tools/debt_harvester.py [target_dir]
15
+ python3 tools/debt_harvester.py [target_dir] --output DEBT_LEDGER.md
16
+ python3 tools/debt_harvester.py [target_dir] --json
17
+ python3 tools/debt_harvester.py [target_dir] --keyword "custom-tag:"
18
+ """
19
+
20
+ import os
21
+ import sys
22
+ import re
23
+ import json
24
+ import argparse
25
+ from typing import Dict, List, Any, Optional
26
+
27
+ # UTF-8 stdout encoding enforcement
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
+ # Default directories to ignore during scan
36
+ IGNORED_DIRS = {
37
+ ".git", "node_modules", "dist", "build", ".next", "out",
38
+ "venv", ".venv", "env", ".env", "__pycache__", ".idea",
39
+ ".vscode", "coverage", ".mypy_cache", ".ruff_cache",
40
+ ".pytest_cache", ".sandbox_snapshots", "graphify-out",
41
+ "claude-ecosystem-repos", "Reports", "TestReports",
42
+ "allure-results", "results", "execution_results", "bin", "Libs", "Drivers"
43
+ }
44
+
45
+ # Supported comment markers across major languages
46
+ # Supports: # (Python, Bash, YAML), // (JS, TS, Java, Groovy, C, C++),
47
+ # /* ... */, -- (SQL, Lua), <!-- (HTML, XML, Markdown)
48
+ DEBT_REGEX = re.compile(
49
+ r'(?:#|//|/\*|--|<!--)\s*(?:shortcut|ponytail):\s*(.+?)(?:\*/|-->)?$',
50
+ re.IGNORECASE
51
+ )
52
+
53
+
54
+ class ShortcutEntry:
55
+ def __init__(self, file_path: str, line_no: int, raw_comment: str):
56
+ self.file_path = file_path
57
+ self.line_no = line_no
58
+ self.raw_comment = raw_comment.strip()
59
+ self.description = ""
60
+ self.ceiling = ""
61
+ self.upgrade_trigger = ""
62
+ self.has_trigger = False
63
+ self._parse()
64
+
65
+ def _parse(self):
66
+ text = self.raw_comment
67
+ # Format patterns:
68
+ # 1. shortcut: <desc>, ceiling: <limit>, upgrade: <trigger>
69
+ # 2. shortcut: <desc>, <limit>, <trigger>
70
+ # 3. shortcut: <limit>, <when to upgrade>
71
+
72
+ parts = [p.strip() for p in text.split(',') if p.strip()]
73
+
74
+ # Check explicit labels
75
+ ceiling_match = re.search(r'(?:ceiling|limit):\s*([^,]+)', text, re.IGNORECASE)
76
+ upgrade_match = re.search(r'(?:upgrade|when|trigger):\s*([^,]+)', text, re.IGNORECASE)
77
+
78
+ if ceiling_match or upgrade_match:
79
+ self.ceiling = ceiling_match.group(1).strip() if ceiling_match else ""
80
+ self.upgrade_trigger = upgrade_match.group(1).strip() if upgrade_match else ""
81
+ # Description is what's left before ceiling/upgrade
82
+ desc_part = re.split(r'(?:ceiling|limit|upgrade|when|trigger):', text, flags=re.IGNORECASE)[0]
83
+ self.description = desc_part.strip().rstrip(',')
84
+ elif len(parts) >= 2:
85
+ self.description = parts[0]
86
+ self.ceiling = parts[1]
87
+ if len(parts) >= 3:
88
+ self.upgrade_trigger = parts[2]
89
+ else:
90
+ self.upgrade_trigger = parts[1]
91
+ elif len(parts) == 1:
92
+ self.description = parts[0]
93
+ self.ceiling = "Not specified"
94
+ self.upgrade_trigger = ""
95
+
96
+ if self.upgrade_trigger:
97
+ self.has_trigger = True
98
+
99
+ def to_dict(self) -> Dict[str, Any]:
100
+ return {
101
+ "file": self.file_path,
102
+ "line": self.line_no,
103
+ "description": self.description or self.raw_comment,
104
+ "ceiling": self.ceiling or "Not specified",
105
+ "upgrade_trigger": self.upgrade_trigger or "No trigger specified",
106
+ "has_trigger": self.has_trigger,
107
+ "raw": self.raw_comment
108
+ }
109
+
110
+
111
+ def scan_directory(target_dir: str, keyword: Optional[str] = None) -> List[ShortcutEntry]:
112
+ """Scans all non-ignored source files in target_dir for shortcut/debt markers."""
113
+ target_dir = os.path.abspath(target_dir)
114
+ results: List[ShortcutEntry] = []
115
+
116
+ pattern = DEBT_REGEX
117
+ if keyword:
118
+ escaped = re.escape(keyword.rstrip(':'))
119
+ pattern = re.compile(
120
+ rf'(?:#|//|/\*|--|<!--)\s*{escaped}:\s*(.+?)(?:\*/|-->)?$',
121
+ re.IGNORECASE
122
+ )
123
+
124
+ for root, dirs, files in os.walk(target_dir):
125
+ # Exclude ignored directories in-place
126
+ dirs[:] = [d for d in dirs if d not in IGNORED_DIRS and not d.startswith('.')]
127
+
128
+ for f in sorted(files):
129
+ # Skip non-text or binary files
130
+ ext = os.path.splitext(f)[1].lower()
131
+ if ext in {".png", ".jpg", ".jpeg", ".svg", ".zip", ".tar", ".gz", ".lock", ".ico", ".pdf"}:
132
+ continue
133
+
134
+ file_path = os.path.join(root, f)
135
+ rel_path = os.path.relpath(file_path, target_dir)
136
+
137
+ try:
138
+ with open(file_path, "r", encoding="utf-8", errors="ignore") as fh:
139
+ for line_idx, line in enumerate(fh, start=1):
140
+ match = pattern.search(line)
141
+ if match:
142
+ comment_body = match.group(1).strip()
143
+ # Filter false positives like documentation describing the marker itself
144
+ if "shortcut: <" in comment_body or "shortcut: (" in comment_body:
145
+ continue
146
+ results.append(ShortcutEntry(rel_path, line_idx, comment_body))
147
+ except Exception:
148
+ continue
149
+
150
+ return results
151
+
152
+
153
+ def format_markdown(entries: List[ShortcutEntry], target_dir: str) -> str:
154
+ """Renders shortcut debt entries into a structured Markdown ledger."""
155
+ total = len(entries)
156
+ no_trigger = sum(1 for e in entries if not e.has_trigger)
157
+
158
+ lines = [
159
+ "# Technical Debt & Shortcut Ledger",
160
+ "",
161
+ "> **Ledger Policy:** Deliberate shortcuts prevent over-engineering. Track limits and upgrade triggers so they never rot silently into permanent defects.",
162
+ "",
163
+ f"- **Repository:** `{os.path.basename(target_dir)}`",
164
+ f"- **Total Shortcuts:** `{total}`",
165
+ f"- **Missing Upgrade Triggers:** `{no_trigger}` " + ("⚠️ *(Action Required)*" if no_trigger > 0 else "✅ *(All tracked)*"),
166
+ "",
167
+ "---",
168
+ "",
169
+ ]
170
+
171
+ if not entries:
172
+ lines.append("🎉 **No shortcut debt found. Clean ledger.**")
173
+ return "\n".join(lines)
174
+
175
+ lines.append("| Location | Description | Ceiling (Limit) | Upgrade Trigger | Status |")
176
+ lines.append("| :--- | :--- | :--- | :--- | :--- |")
177
+
178
+ for e in entries:
179
+ status = "✅ Tracked" if e.has_trigger else "⚠️ `no-trigger`"
180
+ loc = f"`{e.file_path}:{e.line_no}`"
181
+ lines.append(f"| {loc} | {e.description} | {e.ceiling} | {e.upgrade_trigger or 'None'} | {status} |")
182
+
183
+ lines.append("")
184
+ lines.append("### Recommended Action")
185
+ if no_trigger > 0:
186
+ lines.append(f"1. Review the `{no_trigger}` shortcut(s) tagged `no-trigger` above and define concrete upgrade conditions.")
187
+ else:
188
+ lines.append("1. All tracked shortcuts have defined upgrade boundaries. Review them during sprint refactoring cycles.")
189
+ lines.append("2. Run `agent-qa debt` in CI to monitor debt accumulation.")
190
+
191
+ return "\n".join(lines)
192
+
193
+
194
+ def run_debt_harvest(target_dir: str, keyword: Optional[str] = None, output_file: Optional[str] = None, as_json: bool = False) -> int:
195
+ """Executes the debt scan and prints/writes results."""
196
+ entries = scan_directory(target_dir, keyword)
197
+ total = len(entries)
198
+ no_trigger = sum(1 for e in entries if not e.has_trigger)
199
+
200
+ if as_json:
201
+ payload = {
202
+ "target": os.path.abspath(target_dir),
203
+ "total": total,
204
+ "no_trigger_count": no_trigger,
205
+ "items": [e.to_dict() for e in entries]
206
+ }
207
+ print(json.dumps(payload, indent=2, ensure_ascii=False))
208
+ return 0
209
+
210
+ md_report = format_markdown(entries, target_dir)
211
+
212
+ if output_file:
213
+ out_path = os.path.abspath(output_file)
214
+ with open(out_path, "w", encoding="utf-8") as f:
215
+ f.write(md_report)
216
+ print(f"\n✅ Technical Debt Ledger saved to: {out_path} ({total} entries)")
217
+ else:
218
+ print("\n" + md_report)
219
+
220
+ return 0
221
+
222
+
223
+ def main():
224
+ parser = argparse.ArgumentParser(
225
+ description="Harvest shortcut: and deliberate debt comments into a tracked technical debt ledger."
226
+ )
227
+ parser.add_argument("target", nargs="?", default=".", help="Directory to scan (default: current directory)")
228
+ parser.add_argument("--keyword", "-k", default=None, help="Custom marker keyword (default: shortcut or ponytail)")
229
+ parser.add_argument("--output", "-o", default=None, help="Save report to Markdown file")
230
+ parser.add_argument("--json", action="store_true", help="Output results in JSON format")
231
+
232
+ args = parser.parse_args()
233
+ sys.exit(run_debt_harvest(args.target, args.keyword, args.output, args.json))
234
+
235
+
236
+ if __name__ == "__main__":
237
+ main()
@@ -0,0 +1,161 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ tools/distill_log.py — Cross-Platform Log Distiller for Katalon KRE, Gradle, and Playwright
5
+ Filters out 90%+ passing step noise and outputs strictly actionable failure triage blocks.
6
+ Compatible with Windows, macOS, and Linux.
7
+ """
8
+
9
+ import sys
10
+ import os
11
+ import re
12
+ import argparse
13
+
14
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
15
+ if hasattr(sys.stdout, 'reconfigure'):
16
+ try:
17
+ sys.stdout.reconfigure(encoding='utf-8')
18
+ sys.stderr.reconfigure(encoding='utf-8')
19
+ except Exception:
20
+ pass
21
+
22
+ def distill(log_text, max_lines=40):
23
+ lines = log_text.splitlines()
24
+ total_raw_lines = len(lines)
25
+
26
+ # Noise filters
27
+ noise_patterns = [
28
+ re.compile(r'^\s*$'),
29
+ re.compile(r'\[INFO\b|\bINFO:|\bINFO\s+', re.IGNORECASE),
30
+ re.compile(r'\[DEBUG\b|\bDEBUG:|\bDEBUG\s+', re.IGNORECASE),
31
+ re.compile(r'\[TRACE\b|\bTRACE:|\bTRACE\s+', re.IGNORECASE),
32
+ re.compile(r'^\d{4}-\d{2}-\d{2}[ T]\d{2}:\d{2}:\d{2}.*\b(?:INFO|DEBUG|TRACE)\b', re.IGNORECASE),
33
+ re.compile(r'\bPASSED\b', re.IGNORECASE),
34
+ re.compile(r'> Task :'),
35
+ re.compile(r'SLF4J:'),
36
+ re.compile(r'Loading class `com\.mysql'),
37
+ re.compile(r'Starting ChromeDriver'),
38
+ re.compile(r'Only local connections are allowed'),
39
+ re.compile(r'DevTools listening on'),
40
+ re.compile(r'Fontconfig warning:'),
41
+ re.compile(r'Katalon Studio.*licensed to'),
42
+ ]
43
+
44
+ failure_indicators = [
45
+ re.compile(r'\bFAILED\b'),
46
+ re.compile(r'\bERROR\b'),
47
+ re.compile(r'Exception\b'),
48
+ re.compile(r'AssertionError'),
49
+ re.compile(r'Caused by:'),
50
+ re.compile(r'at (?:Enterprise\.|Script\d+|com\.kms)'),
51
+ re.compile(r'TC-\d+.*FAILED'),
52
+ re.compile(r'FAIL\s+.*(?:\.spec|\.test)'),
53
+ ]
54
+
55
+ tc_pattern = re.compile(r'(TC-\d+|test_[A-Za-z0-9_]+|[A-Za-z0-9_-]+\.(?:spec|test)\.[jt]sx?)')
56
+ line_num_pattern = re.compile(r'((?:Script\d+|\w+Page|\w+\.(?:groovy|ts|js|py)):(\d+))|File "([^"]+)", line (\d+)')
57
+ re.compile(r'([A-Za-z0-9_.]*(?:Exception|Error)):?\s*(.*)')
58
+
59
+ captured_failures = []
60
+ failing_tcs = set()
61
+ failing_locs = []
62
+
63
+ in_failure_block = False
64
+ failure_block = []
65
+
66
+ for line in lines:
67
+ # Check if line indicates failure
68
+ is_fail_line = any(p.search(line) for p in failure_indicators)
69
+ is_noise = any(p.search(line) for p in noise_patterns) and not is_fail_line
70
+
71
+ # Detect TC identifier
72
+ m_tc = tc_pattern.search(line)
73
+ if m_tc and ("FAILED" in line or "ERROR" in line):
74
+ failing_tcs.add(m_tc.group(1))
75
+
76
+ # Detect script line number
77
+ m_loc = line_num_pattern.search(line)
78
+ if m_loc:
79
+ failing_locs.append(m_loc.group(1) or f"{m_loc.group(3)}:{m_loc.group(4)}")
80
+
81
+ if is_fail_line:
82
+ in_failure_block = True
83
+ failure_block.append(line.strip())
84
+ elif in_failure_block:
85
+ if is_noise or line.startswith("---") or line.startswith("==="):
86
+ in_failure_block = False
87
+ if failure_block:
88
+ captured_failures.append("\n".join(failure_block[:10]))
89
+ failure_block = []
90
+ else:
91
+ failure_block.append(line.strip())
92
+
93
+ if failure_block:
94
+ captured_failures.append("\n".join(failure_block[:10]))
95
+
96
+ # Distillation Report
97
+ output = []
98
+ output.append("======================================================================")
99
+ output.append(" 🔍 LOG DISTILLER — AUTOMATED FAILURE TRIAGE SUMMARY ")
100
+ output.append("======================================================================")
101
+ output.append(f"Total Raw Lines: {total_raw_lines:,} lines analyzed.")
102
+
103
+ if not failing_tcs and not captured_failures:
104
+ output.append("✅ ALL TESTS PASSED: Zero errors or failed steps detected.")
105
+ output.append("======================================================================")
106
+ return "\n".join(output)
107
+
108
+ if failing_tcs:
109
+ output.append(f"❌ FAILURES DETECTED: {len(failing_tcs)} Test Case(s) marked FAILED.")
110
+ output.append(f" Targeted TCs: {', '.join(sorted(failing_tcs))}")
111
+ else:
112
+ output.append(f"❌ FAILURES / ERRORS DETECTED: {len(captured_failures)} failure block(s) isolated.")
113
+
114
+ if failing_locs:
115
+ unique_locs = sorted(set(failing_locs))
116
+ output.append(f" Failing Script Location(s): {', '.join(unique_locs[:5])}")
117
+
118
+ output.append("\n--- Distilled Failure Block(s) ---")
119
+ joined_blocks = "\n---\n".join(captured_failures[:3])
120
+ output.append(joined_blocks[:2000])
121
+
122
+ output.append("======================================================================")
123
+ return "\n".join(output)
124
+
125
+ # Public alias for MCP server compatibility
126
+ distill_log_content = distill
127
+
128
+ def main():
129
+ parser = argparse.ArgumentParser(description="Distill terminal execution logs into high-signal failure blocks.")
130
+ parser.add_argument("--file", "-f", help="Path to raw log file (reads from stdin if omitted).")
131
+ parser.add_argument("--save-raw", "-s", default=None, help="Path to preserve raw log (omitted by default to prevent hub pollution).")
132
+ args = parser.parse_args()
133
+
134
+ if args.file:
135
+ if not os.path.exists(args.file):
136
+ print(f"Error: Log file not found: {args.file}", file=sys.stderr)
137
+ sys.exit(1)
138
+ with open(args.file, "r", encoding="utf-8", errors="ignore") as fp:
139
+ log_text = fp.read()
140
+ else:
141
+ if sys.stdin.isatty():
142
+ print("Usage: python3 tools/distill_log.py --file <path> OR pipe stdout via stdin.")
143
+ sys.exit(0)
144
+ log_text = sys.stdin.read()
145
+
146
+ # Preserve raw log on disk if explicitly requested
147
+ if args.save_raw:
148
+ try:
149
+ os.makedirs(os.path.dirname(os.path.abspath(args.save_raw)), exist_ok=True)
150
+ with open(args.save_raw, "w", encoding="utf-8") as fp:
151
+ fp.write(log_text)
152
+ except OSError as err:
153
+ sys.stderr.write(f"Warning: Could not save raw log: {err}\n")
154
+
155
+ summary = distill(log_text)
156
+ print(summary)
157
+ if args.save_raw and os.path.exists(args.save_raw):
158
+ print(f"[Full raw log saved to file://{os.path.abspath(args.save_raw)}]")
159
+
160
+ if __name__ == "__main__":
161
+ main()