@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,462 @@
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
+ Hierarchical QA Test Memory OS (Letta / MemGPT Pattern)
8
+ -------------------------------------------------------
9
+ Provides a 3-tier persistent memory operating system for test automation:
10
+ 1. Core Memory: Fast key-value blocks for active environment context (AUT URL, auth token expiry, flags).
11
+ 2. Recall Memory: Sequential event log of recent test execution steps and subagent actions.
12
+ 3. Archival Memory: Long-term searchable knowledge base of locator mutations and flaky patterns,
13
+ version-scoped by AUT release (e.g. v2.1 vs v2.2) to eliminate memory rot.
14
+ 4. Memory Hygiene: Garbage collection and secret scrubbing (zero plaintext tokens/passwords).
15
+
16
+ Usage:
17
+ python tools/test_memory_os.py init --db-path .agent_memory/qa_memory.db
18
+ python tools/test_memory_os.py update-core --block auth_state --data '{"token_expiry": "..."}'
19
+ python tools/test_memory_os.py archival-insert --key LOCATOR_MUTATION --payload '{"page": "LoginPage", ...}' --aut-version "v2.1"
20
+ python tools/test_memory_os.py archival-search --query "Login submit button" --aut-version "v2.1" --json
21
+ python tools/test_memory_os.py gc --scrub-secrets --max-age-days 30
22
+ """
23
+
24
+ import os
25
+ import sys
26
+ import re
27
+ import json
28
+ import sqlite3
29
+ import time
30
+ import uuid
31
+ import difflib
32
+ import argparse
33
+ from datetime import datetime, timezone, timedelta
34
+ from typing import Dict, Any, List, Optional, Tuple
35
+
36
+ # Enforce UTF-8 stdout encoding
37
+ if hasattr(sys.stdout, 'reconfigure'):
38
+ try:
39
+ sys.stdout.reconfigure(encoding='utf-8')
40
+ sys.stderr.reconfigure(encoding='utf-8')
41
+ except Exception:
42
+ pass
43
+
44
+
45
+ SECRET_PATTERNS = [
46
+ re.compile(r'["\']?(?:password|passwd|pwd|secret|apiKey|api_key|token|bearer)["\']?\s*[:=]\s*["\']?([^"\'\s,;]{8,})["\']?', re.IGNORECASE),
47
+ re.compile(r'Bearer\s+([a-zA-Z0-9_\-\.]{15,})', re.IGNORECASE),
48
+ re.compile(r'-----BEGIN (?:RSA )?PRIVATE KEY-----[\s\S]*?-----END (?:RSA )?PRIVATE KEY-----'),
49
+ ]
50
+
51
+
52
+ class ManagedConnection(sqlite3.Connection):
53
+ """SQLite connection that automatically commits/rollbacks and closes on context exit."""
54
+ def __exit__(self, exc_type, exc_val, exc_tb):
55
+ try:
56
+ super().__exit__(exc_type, exc_val, exc_tb)
57
+ finally:
58
+ self.close()
59
+
60
+
61
+ class TestMemoryOS:
62
+ """3-Tier Hierarchical QA Memory OS."""
63
+ __test__ = False
64
+
65
+ def __init__(self, db_path: Optional[str] = None, memory_bus: Optional[Any] = None, use_memory_bus: bool = False):
66
+ self._bus_adapter = None
67
+ if use_memory_bus or memory_bus is not None:
68
+ try:
69
+ from core.adapters import TestMemoryOSAdapter
70
+ except ImportError:
71
+ from tools.core.adapters import TestMemoryOSAdapter
72
+ self._bus_adapter = TestMemoryOSAdapter(bus=memory_bus)
73
+
74
+ if db_path:
75
+ self.db_path = db_path
76
+ else:
77
+ repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
78
+ self.db_path = os.path.join(repo_root, ".agent_memory", "qa_memory.db")
79
+
80
+ if not self._bus_adapter:
81
+ os.makedirs(os.path.dirname(os.path.abspath(self.db_path)), exist_ok=True)
82
+ self._init_db()
83
+
84
+
85
+ def _get_connection(self) -> ManagedConnection:
86
+ conn = sqlite3.connect(self.db_path, factory=ManagedConnection)
87
+ conn.row_factory = sqlite3.Row
88
+ return conn
89
+
90
+ def _init_db(self):
91
+ with self._get_connection() as conn:
92
+ # 1. Core Memory Table
93
+ conn.execute("""
94
+ CREATE TABLE IF NOT EXISTS core_memory (
95
+ block_key TEXT PRIMARY KEY,
96
+ data_json TEXT NOT NULL,
97
+ updated_at TEXT NOT NULL
98
+ )
99
+ """)
100
+ # 2. Recall Memory Table
101
+ conn.execute("""
102
+ CREATE TABLE IF NOT EXISTS recall_memory (
103
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
104
+ session_id TEXT NOT NULL,
105
+ event_type TEXT NOT NULL,
106
+ actor TEXT NOT NULL,
107
+ payload_json TEXT NOT NULL,
108
+ timestamp TEXT NOT NULL
109
+ )
110
+ """)
111
+ conn.execute("CREATE INDEX IF NOT EXISTS idx_recall_session ON recall_memory(session_id, timestamp)")
112
+
113
+ # 3. Archival Memory Table
114
+ conn.execute("""
115
+ CREATE TABLE IF NOT EXISTS archival_memory (
116
+ id TEXT PRIMARY KEY,
117
+ key TEXT NOT NULL,
118
+ aut_version TEXT DEFAULT 'latest',
119
+ payload_json TEXT NOT NULL,
120
+ tags TEXT DEFAULT '',
121
+ text_content TEXT NOT NULL,
122
+ created_at TEXT NOT NULL
123
+ )
124
+ """)
125
+ conn.execute("CREATE INDEX IF NOT EXISTS idx_archival_key_ver ON archival_memory(key, aut_version)")
126
+
127
+ # ----------------- Tier 1: Core Memory -----------------
128
+
129
+ def update_core(self, block_key: str, data: Any) -> Dict[str, Any]:
130
+ """Updates or inserts a core memory block."""
131
+ if self._bus_adapter:
132
+ return self._bus_adapter.update_core(block_key, data)
133
+
134
+ data_str = json.dumps(data) if not isinstance(data, str) else data
135
+ now = datetime.now(timezone.utc).isoformat()
136
+ with self._get_connection() as conn:
137
+ conn.execute("""
138
+ INSERT INTO core_memory (block_key, data_json, updated_at)
139
+ VALUES (?, ?, ?)
140
+ ON CONFLICT(block_key) DO UPDATE SET
141
+ data_json=excluded.data_json,
142
+ updated_at=excluded.updated_at
143
+ """, (block_key, data_str, now))
144
+
145
+ return {
146
+ "status": "PASS",
147
+ "block_key": block_key,
148
+ "updated_at": now
149
+ }
150
+
151
+ def get_core(self, block_key: str) -> Optional[Dict[str, Any]]:
152
+ """Retrieves a core memory block."""
153
+ if self._bus_adapter:
154
+ return self._bus_adapter.get_core(block_key)
155
+
156
+ with self._get_connection() as conn:
157
+
158
+ row = conn.execute("SELECT data_json, updated_at FROM core_memory WHERE block_key = ?", (block_key,)).fetchone()
159
+ if row:
160
+ try:
161
+ parsed = json.loads(row["data_json"])
162
+ except Exception:
163
+ parsed = row["data_json"]
164
+ return {
165
+ "block_key": block_key,
166
+ "data": parsed,
167
+ "updated_at": row["updated_at"]
168
+ }
169
+ return None
170
+
171
+ def list_core(self) -> List[Dict[str, Any]]:
172
+ """Lists all core memory blocks."""
173
+ if self._bus_adapter and hasattr(self._bus_adapter, "list_core"):
174
+ return self._bus_adapter.list_core()
175
+
176
+ with self._get_connection() as conn:
177
+ rows = conn.execute("SELECT block_key, data_json, updated_at FROM core_memory ORDER BY block_key").fetchall()
178
+ results = []
179
+ for r in rows:
180
+ try:
181
+ parsed = json.loads(r["data_json"])
182
+ except Exception:
183
+ parsed = r["data_json"]
184
+ results.append({"block_key": r["block_key"], "data": parsed, "updated_at": r["updated_at"]})
185
+ return results
186
+
187
+ # ----------------- Tier 2: Recall Memory -----------------
188
+
189
+ def recall_insert(self, session_id: str, event_type: str, actor: str, payload: Any) -> int:
190
+ """Inserts an event into recall memory log."""
191
+ if self._bus_adapter:
192
+ rec = self._bus_adapter.record_recall_step(session_id, event_type, actor, payload)
193
+ return rec.get("sequence", 1)
194
+
195
+ payload_str = json.dumps(payload) if not isinstance(payload, str) else payload
196
+ now = datetime.now(timezone.utc).isoformat()
197
+ with self._get_connection() as conn:
198
+ cursor = conn.execute("""
199
+ INSERT INTO recall_memory (session_id, event_type, actor, payload_json, timestamp)
200
+ VALUES (?, ?, ?, ?, ?)
201
+ """, (session_id, event_type, actor, payload_str, now))
202
+ return cursor.lastrowid or 0
203
+
204
+ def recall_log(self, session_id: str, limit: int = 50) -> List[Dict[str, Any]]:
205
+ """Retrieves recent sequential steps for a session."""
206
+ if self._bus_adapter:
207
+ return self._bus_adapter.get_recall_history(session_id, limit=limit)
208
+
209
+ with self._get_connection() as conn:
210
+ rows = conn.execute("""
211
+ SELECT id, session_id, event_type, actor, payload_json, timestamp
212
+ FROM recall_memory
213
+ WHERE session_id = ?
214
+ ORDER BY id ASC
215
+ LIMIT ?
216
+ """, (session_id, limit)).fetchall()
217
+ events = []
218
+ for r in rows:
219
+ try:
220
+ payload = json.loads(r["payload_json"])
221
+ except Exception:
222
+ payload = r["payload_json"]
223
+ events.append({
224
+ "id": r["id"],
225
+ "session_id": r["session_id"],
226
+ "event_type": r["event_type"],
227
+ "actor": r["actor"],
228
+ "payload": payload,
229
+ "timestamp": r["timestamp"]
230
+ })
231
+ return events
232
+
233
+ # ----------------- Tier 3: Archival Memory -----------------
234
+
235
+ def archival_insert(self, key: str, payload: Any, aut_version: str = "latest", tags: str = "") -> str:
236
+ """Inserts long-term searchable knowledge into archival memory."""
237
+ if self._bus_adapter:
238
+ rec = self._bus_adapter.archival_insert(key, payload, aut_version=aut_version)
239
+ return rec.get("label", "")
240
+
241
+ payload_str = json.dumps(payload) if not isinstance(payload, str) else payload
242
+ now = datetime.now(timezone.utc).isoformat()
243
+ mem_id = f"mem_arch_{int(time.time() * 1000) % 10000000}_{uuid.uuid4().hex[:6]}"
244
+
245
+ # Flatten text content for semantic/fuzzy search
246
+ text_content = f"{key} {aut_version} {tags} {payload_str}".lower()
247
+
248
+ with self._get_connection() as conn:
249
+ conn.execute("""
250
+ INSERT INTO archival_memory (id, key, aut_version, payload_json, tags, text_content, created_at)
251
+ VALUES (?, ?, ?, ?, ?, ?, ?)
252
+ """, (mem_id, key, aut_version, payload_str, tags, text_content, now))
253
+
254
+ return mem_id
255
+
256
+ def archival_search(self, query: str, aut_version: Optional[str] = None, top_k: int = 3) -> Dict[str, Any]:
257
+ """Searches archival memory with semantic token matching and fuzzy ratio."""
258
+ if self._bus_adapter:
259
+ matches = self._bus_adapter.archival_search(query, aut_version=aut_version, limit=top_k)
260
+ return {
261
+ "query": query,
262
+ "matches": matches,
263
+ "total_matches": len(matches)
264
+ }
265
+
266
+ query_lower = query.lower()
267
+
268
+ tokens = set(re.findall(r'\b[a-z0-9_]{3,}\b', query_lower))
269
+
270
+ with self._get_connection() as conn:
271
+ if aut_version:
272
+ rows = conn.execute(
273
+ "SELECT id, key, aut_version, payload_json, tags, text_content, created_at FROM archival_memory WHERE aut_version = ?",
274
+ (aut_version,)
275
+ ).fetchall()
276
+ else:
277
+ rows = conn.execute(
278
+ "SELECT id, key, aut_version, payload_json, tags, text_content, created_at FROM archival_memory"
279
+ ).fetchall()
280
+
281
+ scored = []
282
+ for r in rows:
283
+ text = r["text_content"]
284
+ # 1. Token overlap score
285
+ text_tokens = set(re.findall(r'\b[a-z0-9_]{3,}\b', text))
286
+ if tokens:
287
+ token_score = len(tokens.intersection(text_tokens)) / len(tokens)
288
+ else:
289
+ token_score = 0.0
290
+
291
+ # 2. Fuzzy sequence similarity
292
+ fuzzy_ratio = difflib.SequenceMatcher(None, query_lower, text[:200]).ratio()
293
+
294
+ # Combined score: 60% token overlap + 40% fuzzy match
295
+ score = round((0.6 * token_score) + (0.4 * fuzzy_ratio), 3)
296
+
297
+ if score > 0.15 or (tokens and tokens.intersection(text_tokens)):
298
+ try:
299
+ payload = json.loads(r["payload_json"])
300
+ except Exception:
301
+ payload = r["payload_json"]
302
+
303
+ scored.append({
304
+ "id": r["id"],
305
+ "similarity_score": score,
306
+ "key": r["key"],
307
+ "aut_version": r["aut_version"],
308
+ "timestamp": r["created_at"],
309
+ "payload": payload
310
+ })
311
+
312
+ scored.sort(key=lambda x: x["similarity_score"], reverse=True)
313
+ results = scored[:top_k]
314
+
315
+ return {
316
+ "status": "PASS",
317
+ "query": query,
318
+ "aut_version": aut_version or "all",
319
+ "matches_found": len(results),
320
+ "results": results
321
+ }
322
+
323
+ # ----------------- Hygiene & Secret Scrubbing -----------------
324
+
325
+ def scrub_string(self, text: str) -> Tuple[str, int]:
326
+ """Masks detected secrets in text."""
327
+ scrubbed = text
328
+ count = 0
329
+ for pat in SECRET_PATTERNS:
330
+ matches = list(pat.finditer(scrubbed))
331
+ if matches:
332
+ count += len(matches)
333
+ for m in matches:
334
+ val = m.group(0)
335
+ scrubbed = scrubbed.replace(val, "[MASKED_SECRET]")
336
+ return scrubbed, count
337
+
338
+ def gc(self, scrub_secrets: bool = True, max_age_days: int = 30) -> Dict[str, Any]:
339
+ """Performs garbage collection and secret scrubbing."""
340
+ if self._bus_adapter and hasattr(self._bus_adapter, "gc"):
341
+ return self._bus_adapter.gc(scrub_secrets=scrub_secrets, max_age_days=max_age_days)
342
+
343
+ scrub_count = 0
344
+ deleted_recall = 0
345
+
346
+ with self._get_connection() as conn:
347
+ # 1. Clean old recall logs
348
+ cutoff = (datetime.now(timezone.utc) - timedelta(days=max_age_days)).isoformat()
349
+ cur = conn.execute("DELETE FROM recall_memory WHERE timestamp < ?", (cutoff,))
350
+ deleted_recall = cur.rowcount
351
+
352
+ # 2. Scrub secrets in core memory
353
+ if scrub_secrets:
354
+ rows = conn.execute("SELECT block_key, data_json FROM core_memory").fetchall()
355
+ for r in rows:
356
+ new_val, c = self.scrub_string(r["data_json"])
357
+ if c > 0:
358
+ scrub_count += c
359
+ conn.execute("UPDATE core_memory SET data_json = ? WHERE block_key = ?", (new_val, r["block_key"]))
360
+
361
+ # Scrub archival memory
362
+ a_rows = conn.execute("SELECT id, payload_json, text_content FROM archival_memory").fetchall()
363
+ for ar in a_rows:
364
+ new_p, cp = self.scrub_string(ar["payload_json"])
365
+ new_t, ct = self.scrub_string(ar["text_content"])
366
+ if cp > 0 or ct > 0:
367
+ scrub_count += (cp + ct)
368
+ conn.execute("UPDATE archival_memory SET payload_json = ?, text_content = ? WHERE id = ?", (new_p, new_t, ar["id"]))
369
+
370
+ # Database file size check
371
+ db_size_mb = 0.0
372
+ if os.path.exists(self.db_path):
373
+ db_size_mb = round(os.path.getsize(self.db_path) / (1024 * 1024), 2)
374
+
375
+ return {
376
+ "status": "PASS",
377
+ "db_path": self.db_path,
378
+ "db_size_mb": db_size_mb,
379
+ "max_size_limit_mb": 50.0,
380
+ "size_status": "PASS" if db_size_mb <= 50.0 else "WARNING_OVERSIZED",
381
+ "secrets_scrubbed": scrub_count,
382
+ "expired_recall_records_deleted": deleted_recall
383
+ }
384
+
385
+
386
+ def main():
387
+ parser = argparse.ArgumentParser(description="Hierarchical QA Test Memory OS (Letta Pattern)")
388
+ parser.add_argument("--db-path", help="Path to SQLite database file")
389
+ subparsers = parser.add_subparsers(dest="subcommand", help="Subcommand to execute")
390
+
391
+ # init
392
+ subparsers.add_parser("init", help="Initialize memory OS database")
393
+
394
+ # update-core
395
+ uc_parser = subparsers.add_parser("update-core", help="Update core memory block")
396
+ uc_parser.add_argument("--block", required=True, help="Core memory block key")
397
+ uc_parser.add_argument("--data", required=True, help="JSON or text payload")
398
+
399
+ # get-core
400
+ gc_parser = subparsers.add_parser("get-core", help="Retrieve core memory block")
401
+ gc_parser.add_argument("--block", required=True, help="Core memory block key")
402
+
403
+ # archival-insert
404
+ ai_parser = subparsers.add_parser("archival-insert", help="Insert long-term knowledge into Archival Memory")
405
+ ai_parser.add_argument("--key", required=True, help="Knowledge key (e.g. LOCATOR_MUTATION)")
406
+ ai_parser.add_argument("--payload", required=True, help="JSON data payload")
407
+ ai_parser.add_argument("--aut-version", default="latest", help="AUT release version (e.g. v2.1)")
408
+ ai_parser.add_argument("--tags", default="", help="Comma-separated search tags")
409
+
410
+ # archival-search
411
+ as_parser = subparsers.add_parser("archival-search", help="Search archival memory by query")
412
+ as_parser.add_argument("--query", required=True, help="Search query string")
413
+ as_parser.add_argument("--aut-version", help="Filter by AUT release version")
414
+ as_parser.add_argument("--top-k", type=int, default=3, help="Max results to return")
415
+ as_parser.add_argument("--json", action="store_true", help="Print JSON output")
416
+
417
+ # gc
418
+ clean_parser = subparsers.add_parser("gc", help="Garbage collection and secret scrubbing")
419
+ clean_parser.add_argument("--scrub-secrets", action="store_true", default=True, help="Scrub sensitive credentials")
420
+ clean_parser.add_argument("--max-age-days", type=int, default=30, help="Max age for recall logs")
421
+
422
+ args = parser.parse_args()
423
+ mem = TestMemoryOS(db_path=args.db_path)
424
+
425
+ if args.subcommand == "init":
426
+ print(json.dumps({"status": "PASS", "db_path": mem.db_path, "initialized": True}, indent=2))
427
+
428
+ elif args.subcommand == "update-core":
429
+ try:
430
+ parsed_data = json.loads(args.data)
431
+ except Exception:
432
+ parsed_data = args.data
433
+ res = mem.update_core(args.block, parsed_data)
434
+ print(json.dumps(res, indent=2))
435
+
436
+ elif args.subcommand == "get-core":
437
+ res = mem.get_core(args.block)
438
+ print(json.dumps(res or {"status": "NOT_FOUND", "block": args.block}, indent=2))
439
+
440
+ elif args.subcommand == "archival-insert":
441
+ try:
442
+ parsed_payload = json.loads(args.payload)
443
+ except Exception:
444
+ parsed_payload = args.payload
445
+ mid = mem.archival_insert(args.key, parsed_payload, aut_version=args.aut_version, tags=args.tags)
446
+ print(json.dumps({"status": "PASS", "id": mid, "key": args.key, "aut_version": args.aut_version}, indent=2))
447
+
448
+ elif args.subcommand == "archival-search":
449
+ res = mem.archival_search(args.query, aut_version=args.aut_version, top_k=args.top_k)
450
+ print(json.dumps(res, indent=2))
451
+
452
+ elif args.subcommand == "gc":
453
+ res = mem.gc(scrub_secrets=args.scrub_secrets, max_age_days=args.max_age_days)
454
+ print(json.dumps(res, indent=2))
455
+
456
+ else:
457
+ parser.print_help()
458
+ sys.exit(1)
459
+
460
+
461
+ if __name__ == "__main__":
462
+ main()