@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,307 @@
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/init_config.py — Standardized Project Configuration Bootstrapper
8
+ ----------------------------------------------------------------------
9
+ Generates a canonical .synapse.json configuration file for Spoke target projects.
10
+ Enables instant project setup with zero manual JSON authoring.
11
+
12
+ Supports:
13
+ - Interactive questionnaire mode (project name, author, template, sample sheet)
14
+ - Autonomous non-interactive flags (--template, --author, --sheet-name, --force, --dry-run)
15
+ - Direct integration with template_excel_exporter and Definition-of-Done quality gates
16
+ """
17
+
18
+ import os
19
+ import sys
20
+ import json
21
+ import argparse
22
+ import subprocess
23
+ from pathlib import Path
24
+ from typing import Dict, Any, Optional
25
+
26
+ # Enforce UTF-8 stdio for Windows console compatibility
27
+ if hasattr(sys.stdout, 'reconfigure'):
28
+ try:
29
+ sys.stdout.reconfigure(encoding='utf-8')
30
+ sys.stderr.reconfigure(encoding='utf-8')
31
+ except (OSError, ValueError) as _err:
32
+ _ = _err
33
+
34
+ # ANSI Color formatting
35
+ CYAN = "\033[96m"
36
+ GREEN = "\033[92m"
37
+ YELLOW = "\033[93m"
38
+ RED = "\033[91m"
39
+ BOLD = "\033[1m"
40
+ RESET = "\033[0m"
41
+
42
+ HUB_ROOT = Path(__file__).resolve().parent.parent
43
+
44
+
45
+ def is_hub_directory(target_path: Path) -> bool:
46
+ """Checks whether the given target path is the Synapse-Hub core repository itself."""
47
+ try:
48
+ resolved = target_path.resolve()
49
+ if resolved == HUB_ROOT:
50
+ return True
51
+ if (resolved / "skills_manifest.json").is_file() and (resolved / "AGENTS.md").is_file():
52
+ return True
53
+ except (OSError, ValueError) as _err:
54
+ _ = _err
55
+ return False
56
+
57
+
58
+ def get_hub_version() -> str:
59
+ """Resolves Hub release version dynamically from package.json with fallback."""
60
+ try:
61
+ pkg_file = HUB_ROOT / "package.json"
62
+ if pkg_file.is_file():
63
+ with open(pkg_file, "r", encoding="utf-8") as f:
64
+ return json.load(f).get("version", "3.2.1")
65
+ except (OSError, json.JSONDecodeError) as _err:
66
+ _ = _err
67
+ return "3.2.1"
68
+
69
+
70
+ def detect_git_user_name() -> Optional[str]:
71
+ """Attempts to auto-detect git user.name for convenient author defaulting."""
72
+ try:
73
+ res = subprocess.run(
74
+ ["git", "config", "user.name"],
75
+ capture_output=True,
76
+ text=True,
77
+ timeout=3
78
+ )
79
+ if res.returncode == 0 and res.stdout.strip():
80
+ return res.stdout.strip()
81
+ except (subprocess.SubprocessError, OSError) as _err:
82
+ _ = _err
83
+ return None
84
+
85
+
86
+ def build_default_config(
87
+ project_name: str = "Enterprise-QA-Project",
88
+ author: str = "QA Engineer",
89
+ tester: str = "QA Engineer",
90
+ template_path: str = "",
91
+ sample_sheet: str = "Test Cases",
92
+ module_code: str = "MOD",
93
+ module_name: str = "General Module",
94
+ default_output_dir: str = "reports",
95
+ version: Optional[str] = None
96
+ ) -> Dict[str, Any]:
97
+ """Constructs the canonical .synapse.json dictionary schema."""
98
+ hub_ver = version or get_hub_version()
99
+ return {
100
+ "$schema": "https://raw.githubusercontent.com/TeeVee998/Synapse-Hub/main/docs/schemas/synapse.config.schema.json",
101
+ "version": hub_ver,
102
+ "project": {
103
+ "name": project_name,
104
+ "author": author,
105
+ "tester": tester,
106
+ "description": f"Automated & Manual QA Workspace for {project_name}"
107
+ },
108
+ "testcase_export": {
109
+ "template_path": template_path,
110
+ "sample_sheet": sample_sheet,
111
+ "default_output_dir": default_output_dir,
112
+ "module_code": module_code,
113
+ "module_name": module_name
114
+ },
115
+ "quality_gates": {
116
+ "mutation_min_score": 80,
117
+ "gates": {
118
+ "gate_0_author_integrity": True,
119
+ "gate_1_bom_check": True,
120
+ "gate_2_path_portability": True,
121
+ "gate_3_clean_pom": True,
122
+ "gate_4_ai_docs_lint": True,
123
+ "gate_5_cleanup_blacklist": True,
124
+ "gate_6_credential_security": True,
125
+ "gate_7_infer_linter": True,
126
+ "gate_8_micro_mutator": True,
127
+ "gate_9_skill_collision": True,
128
+ "gate_10_performance_sla": True
129
+ }
130
+ },
131
+ "infer_linter": {
132
+ "enabled": True,
133
+ "strict": True,
134
+ "format": "text",
135
+ "exclude_paths": [
136
+ ".git",
137
+ ".synapse",
138
+ "node_modules",
139
+ "templates",
140
+ "reports"
141
+ ],
142
+ "disabled_rules": []
143
+ }
144
+ }
145
+
146
+
147
+ def init_config(
148
+ target_dir: str = ".",
149
+ project_name: Optional[str] = None,
150
+ author: Optional[str] = None,
151
+ tester: Optional[str] = None,
152
+ template_path: Optional[str] = None,
153
+ sample_sheet: Optional[str] = None,
154
+ module_code: Optional[str] = None,
155
+ module_name: Optional[str] = None,
156
+ default_output_dir: Optional[str] = None,
157
+ force: bool = False,
158
+ dry_run: bool = False,
159
+ interactive: bool = False
160
+ ) -> int:
161
+ """
162
+ Initializes or updates the .synapse.json file in the given target directory.
163
+ Returns 0 on success, non-zero on failure.
164
+ """
165
+ target_path = Path(target_dir).resolve()
166
+ target_file = target_path / ".synapse.json"
167
+
168
+ # Hub CWD Confusion Guard (Anti-Pattern Rule 7 & 8)
169
+ if not dry_run and is_hub_directory(target_path):
170
+ print(f"\n{YELLOW}⚠️ [CWD CONFUSION GUARD] Thư mục mục tiêu là Synapse-Hub (Skill Hub trung tâm), không phải dự án Spoke.{RESET}")
171
+ print(" Synapse-Hub đã sử dụng synapse.config.json và không nên khởi tạo file .synapse.json tại đây.")
172
+ print(f"👉 Vui lòng chỉ định đường dẫn dự án mục tiêu: {BOLD}agent-qa init-config <duong_dan_du_an>{RESET}\n")
173
+ return 1
174
+
175
+ # Default project name from directory name if not provided
176
+ inferred_project_name = project_name or target_path.name
177
+ inferred_author = author or detect_git_user_name() or "QA Engineer"
178
+ inferred_tester = tester or inferred_author
179
+ inferred_template = template_path or ""
180
+ inferred_sheet = sample_sheet or "Test Cases"
181
+ inferred_mod_code = module_code or "MOD"
182
+ inferred_mod_name = module_name or "General Module"
183
+ inferred_out_dir = default_output_dir or "reports"
184
+
185
+ # Check interactive terminal condition
186
+ is_interactive_terminal = hasattr(sys.stdin, "isatty") and sys.stdin.isatty() and not os.environ.get("CI") and not os.environ.get("SYNAPSE_NON_INTERACTIVE")
187
+ should_prompt = interactive or (is_interactive_terminal and not any([project_name, author, template_path, sample_sheet]))
188
+
189
+ if should_prompt:
190
+ print(f"\n{BOLD}{CYAN}======================================================================{RESET}")
191
+ print(f"{BOLD}{CYAN} 🧠 SYNAPSE HUB — KHỞI TẠO CẤU HÌNH DỰ ÁN (.synapse.json) {RESET}")
192
+ print(f"{BOLD}{CYAN}======================================================================{RESET}")
193
+ print("Hãy trả lời các câu hỏi ngắn dưới đây để thiết lập dự án Spoke chuẩn hóa:")
194
+ print(f"(Nhấn {BOLD}Enter{RESET} để chấp nhận giá trị gợi ý mặc định trong ngoặc)\n")
195
+
196
+ try:
197
+ val_p = input(f"1. Tên dự án [{BOLD}{inferred_project_name}{RESET}]: ").strip()
198
+ if val_p:
199
+ inferred_project_name = val_p
200
+
201
+ val_a = input(f"2. Tác giả / QA Lead [{BOLD}{inferred_author}{RESET}]: ").strip()
202
+ if val_a:
203
+ inferred_author = val_a
204
+ inferred_tester = val_a
205
+
206
+ val_t = input("3. Đường dẫn file template Excel (để trống nếu dùng layout chuẩn Hub): ").strip()
207
+ if val_t:
208
+ inferred_template = val_t
209
+
210
+ val_s = input(f"4. Tên worksheet mẫu trong template [{BOLD}{inferred_sheet}{RESET}]: ").strip()
211
+ if val_s:
212
+ inferred_sheet = val_s
213
+ except (EOFError, KeyboardInterrupt):
214
+ print(f"\n{YELLOW}Đã hủy khởi tạo cấu hình.{RESET}")
215
+ return 1
216
+
217
+ config_data = build_default_config(
218
+ project_name=inferred_project_name,
219
+ author=inferred_author,
220
+ tester=inferred_tester,
221
+ template_path=inferred_template,
222
+ sample_sheet=inferred_sheet,
223
+ module_code=inferred_mod_code,
224
+ module_name=inferred_mod_name,
225
+ default_output_dir=inferred_out_dir
226
+ )
227
+
228
+ formatted_json = json.dumps(config_data, indent=2, ensure_ascii=False) + "\n"
229
+
230
+ if dry_run:
231
+ print(f"\n{YELLOW}🔍 [DRY-RUN] Xem trước nội dung cấu hình cho '{target_file}':{RESET}\n")
232
+ print(formatted_json)
233
+ print(f"{GREEN}✅ Chạy thử nghiệm thành công (không ghi file thực tế).{RESET}\n")
234
+ return 0
235
+
236
+ if target_file.exists() and not force:
237
+ print(f"\n{YELLOW}⚠️ File cấu hình đã tồn tại tại:{RESET} {target_file}")
238
+ print(f"👉 Để ghi đè cấu hình mới, vui lòng thêm cờ {BOLD}--force{RESET} (hoặc {BOLD}-f{RESET}).\n")
239
+ print(f"Ví dụ: {BOLD}agent-qa init-config --force{RESET}\n")
240
+ return 1
241
+
242
+ try:
243
+ os.makedirs(target_path, exist_ok=True)
244
+ with open(target_file, "w", encoding="utf-8") as f:
245
+ f.write(formatted_json)
246
+ except OSError as err:
247
+ print(f"\n{RED}❌ Không thể ghi file cấu hình tại {target_file}: {err}{RESET}")
248
+ return 2
249
+
250
+ print(f"\n{GREEN}✅ Khởi tạo thành công file cấu hình chuẩn hóa:{RESET}")
251
+ print(f" 📂 Đường dẫn: {BOLD}{target_file}{RESET}")
252
+ print(f" 🏷️ Dự án : {BOLD}{inferred_project_name}{RESET}")
253
+ print(f" 👤 Tác giả : {BOLD}{inferred_author}{RESET}")
254
+ if inferred_template:
255
+ print(f" 📊 Template : {BOLD}{inferred_template}{RESET} (Sheet: {inferred_sheet})")
256
+ else:
257
+ print(" 📊 Template : (Mặc định Hub 12 cột — bạn có thể thêm đường dẫn template sau)")
258
+ print(f"\n{CYAN}💡 Bước Tiếp Theo:{RESET}")
259
+ print(" 1. Chạy xuất test cases Markdown sang Excel tự động áp dụng template:")
260
+ print(f" 👉 {BOLD}agent-qa export-excel docs/TEST_CASES.md{RESET}")
261
+ print(" 2. Chạy kiểm tra 11 Quality Gates cho dự án:")
262
+ print(f" 👉 {BOLD}agent-qa verify{RESET}\n")
263
+ return 0
264
+
265
+
266
+ initialize_config = init_config
267
+
268
+
269
+ def main():
270
+ parser = argparse.ArgumentParser(
271
+ prog="agent-qa init-config",
272
+ description="Khởi tạo file cấu hình .synapse.json chuẩn hóa cho dự án mục tiêu (Spoke)."
273
+ )
274
+ parser.add_argument("target_dir", nargs="?", default=".", help="Thư mục đích khởi tạo file cấu hình (mặc định: .)")
275
+ parser.add_argument("-t", "--template", dest="template_path", default=None, help="Đường dẫn file template Excel (.xlsx)")
276
+ parser.add_argument("-a", "--author", default=None, help="Tên tác giả / QA Lead phụ trách dự án")
277
+ parser.add_argument("--tester", default=None, help="Tên kiểm thử viên phụ trách")
278
+ parser.add_argument("-s", "--sheet-name", dest="sample_sheet", default=None, help="Tên worksheet mẫu cần clone (mặc định: Test Cases)")
279
+ parser.add_argument("-p", "--project-name", default=None, help="Tên định danh của dự án (mặc định: tên thư mục)")
280
+ parser.add_argument("--module-code", default="MOD", help="Mã module viết tắt (mặc định: MOD)")
281
+ parser.add_argument("--module-name", default="General Module", help="Tên phân hệ kiểm thử (mặc định: General Module)")
282
+ parser.add_argument("--out-dir", dest="default_output_dir", default="reports", help="Thư mục xuất báo cáo mặc định (mặc định: reports)")
283
+ parser.add_argument("-f", "--force", action="store_true", help="Ghi đè file .synapse.json nếu đã tồn tại")
284
+ parser.add_argument("--dry-run", action="store_true", help="In nội dung file JSON ra màn hình mà không ghi xuống ổ đĩa")
285
+ parser.add_argument("-i", "--interactive", action="store_true", help="Kích hoạt chế độ hỏi đáp tương tác trực tiếp")
286
+
287
+ args = parser.parse_args()
288
+
289
+ ret = init_config(
290
+ target_dir=args.target_dir,
291
+ project_name=args.project_name,
292
+ author=args.author,
293
+ tester=args.tester,
294
+ template_path=args.template_path,
295
+ sample_sheet=args.sample_sheet,
296
+ module_code=args.module_code,
297
+ module_name=args.module_name,
298
+ default_output_dir=args.default_output_dir,
299
+ force=args.force,
300
+ dry_run=args.dry_run,
301
+ interactive=args.interactive
302
+ )
303
+ sys.exit(ret)
304
+
305
+
306
+ if __name__ == "__main__":
307
+ main()
@@ -0,0 +1,116 @@
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
+ Pocock Grilling Primitive & Requirements Interrogation Engine (Matt Pocock Pattern)
8
+ -----------------------------------------------------------------------------------
9
+ Calculates the prerequisite decision frontier for ambiguous user stories.
10
+ Batches structured multiple-choice questions with explicit (Recommended) defaults,
11
+ strictly adhering to the Fact/Decision boundary (never asking for facts ascertainable
12
+ directly from the codebase).
13
+
14
+ Reference:
15
+ - Matt Pocock (The Grilling Primitive: Frontier Decision Interrogation).
16
+ - Synapse-Hub Subsystem 6: Section 6.7 of agent_skill_training_analysis.md.
17
+ """
18
+
19
+ import sys
20
+ import re
21
+ import json
22
+ import argparse
23
+ from typing import List, Dict, Any
24
+
25
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
26
+ if hasattr(sys.stdout, 'reconfigure'):
27
+ try:
28
+ sys.stdout.reconfigure(encoding='utf-8')
29
+ sys.stderr.reconfigure(encoding='utf-8')
30
+ except Exception:
31
+ pass
32
+
33
+
34
+ class PocockGriller:
35
+ """Interrogates user stories along the prerequisite decision frontier."""
36
+
37
+ def __init__(self, target_framework: str = "Playwright_TS"):
38
+ self.target_framework = target_framework
39
+
40
+ def generate_frontier_questions(self, story_text: str) -> List[Dict[str, Any]]:
41
+ """
42
+ Analyzes requirements text and returns batched questions for ask_question.
43
+ Only generates questions for true decision forks, never for discoverable codebase facts.
44
+ """
45
+ questions = []
46
+
47
+ # 1. Scope & Execution Boundary
48
+ questions.append({
49
+ "question": "Phạm vi kiểm thử tự động (Execution Scope): Cấp độ kiểm thử mong muốn cho user story này là gì?",
50
+ "is_multi_select": False,
51
+ "options": [
52
+ "(Recommended) End-to-End (E2E) UI Automation kết hợp Clean POM và xác thực API payload",
53
+ "API Functional Testing độc lập (không tương tác giao diện browser)",
54
+ "Smoke Test kiểm tra luồng chính (Happy Path) tối giản"
55
+ ]
56
+ })
57
+
58
+ # 2. Test Data Lifecycle & Idempotency
59
+ if not re.search(r"\b(?:mock|stub|seed)\b", story_text, re.IGNORECASE):
60
+ questions.append({
61
+ "question": "Quản lý dữ liệu kiểm thử (Test Data Strategy): Chiến lược sinh và dọn dẹp dữ liệu nào được áp dụng?",
62
+ "is_multi_select": False,
63
+ "options": [
64
+ "(Recommended) Tự động sinh mã duy nhất (BasePage.uniqueCode('AUTO_')) kèm Teardown Cleanup tự động",
65
+ "Dùng tài khoản / dữ liệu tĩnh cấu hình sẵn trong Profile / .env",
66
+ "Network Mocking: Giả lập API response (không tạo dữ liệu thật trên DB)"
67
+ ]
68
+ })
69
+
70
+ # 3. Assertion Boundary & Negative Scenarios
71
+ questions.append({
72
+ "question": "Bao phủ kịch bản biên & bất biến (Assertion Frontier): Cần kiểm thử các trường hợp nào ngoài Happy Path?",
73
+ "is_multi_select": True,
74
+ "options": [
75
+ "(Recommended) Kiểm tra validation form khi bỏ trống các trường bắt buộc",
76
+ "(Recommended) Kiểm tra trạng thái nút Submit / Save khi form chưa hợp lệ (Disabled State)",
77
+ "Kiểm tra timeout hoặc mạng chập chờn (Chaos network fault injection)",
78
+ "Kiểm tra quyền truy cập trái phép (Unauthorized / Forbidden 403)"
79
+ ]
80
+ })
81
+
82
+ return questions
83
+
84
+
85
+ def main():
86
+ parser = argparse.ArgumentParser(description="Pocock Grilling Primitive Engine")
87
+ parser.add_argument("story", nargs="?", default="", help="User story or requirement text")
88
+ parser.add_argument("--json", action="store_true", help="Output questions in JSON format")
89
+ args = parser.parse_args()
90
+
91
+ story_text = args.story or "User Story: As a registered user, I want to approve invoices with attached receipts."
92
+
93
+ griller = PocockGriller()
94
+ questions = griller.generate_frontier_questions(story_text)
95
+
96
+ if args.json:
97
+ print(json.dumps({"story": story_text, "questions": questions}, indent=2))
98
+ return 0
99
+
100
+ print("\n" + "=" * 70)
101
+ print(" POCOCK GRILLING PRIMITIVE (PREREQUISITE DECISION FRONTIER)")
102
+ print("=" * 70)
103
+ print(f"Target Requirement: {story_text}\n")
104
+ print(f"Generated {len(questions)} batched decision questions with recommended defaults:\n")
105
+
106
+ for idx, q in enumerate(questions, 1):
107
+ print(f"Q{idx}: {q['question']}")
108
+ for opt in q["options"]:
109
+ print(f" • {opt}")
110
+ print()
111
+ print("=" * 70 + "\n")
112
+ return 0
113
+
114
+
115
+ if __name__ == "__main__":
116
+ sys.exit(main())