@teevee98/synapse-hub 0.0.0-stage → 3.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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 +171 -0
  190. package/README.md +170 -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 +198 -0
  196. package/docs/ARCHITECTURE.md +199 -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 +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -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 +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -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 +31 -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 +2074 -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 +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -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 +2403 -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 +306 -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 +725 -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 +1271 -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,12 @@
1
+ # 1. Record architecture decisions
2
+
3
+ Date: 2026-10-30
4
+
5
+ ## Status
6
+ Accepted
7
+
8
+ ## Context
9
+ We need to record technical architecture decisions in ADR format.
10
+
11
+ ## Decision
12
+ We will use Markdown ADR files stored in docs/adr/.
@@ -0,0 +1,75 @@
1
+ ---
2
+ name: auth-session-and-cookie-manager
3
+ description: "Manage browser authentication sessions, storageState, JWT tokens, and multi-role state. Use when managing login sessions, storage state, or cookie reuse across tests."
4
+ ---
5
+
6
+ # Auth Session & Cookie Manager Skill
7
+
8
+ > **Target:** Eliminate repetitive, slow UI login forms by saving, refreshing, and injecting browser storage states, cookies, and JWT bearer tokens directly into execution contexts.
9
+
10
+ ---
11
+
12
+ ## 1. Core Principles
13
+
14
+ 1. **Zero-Second Auth Protocol:**
15
+ - Execute UI authentication once to produce a verified `session.json` / `storageState.json`.
16
+ - All subsequent test cases inject this saved state directly at context initialization.
17
+ 2. **Multi-Role Context Isolation:**
18
+ - Maintain distinct session fixtures for different privilege tiers (e.g. `admin_state.json`, `reviewer_state.json`, `viewer_state.json`).
19
+ 3. **Session Freshness & Auto-Refresh:**
20
+ - Inspect token expiry timestamp (`exp` in JWT payload); auto-refresh via API endpoint if token lifetime has elapsed.
21
+ 4. **Security & Credential Hygiene:**
22
+ - Saved browser states contain live cookies, session tokens, and local storage values.
23
+ - **Mandatory:** Always add `.auth/` and `*storageState*.json` to your project's `.gitignore` to prevent committing live credentials to version control.
24
+
25
+ ---
26
+
27
+ ## 2. Standard Playwright Implementation Patterns
28
+
29
+ ### Pattern A: Generating and Reusing Storage State
30
+ ```typescript
31
+ // 1. One-time Setup fixture (e.g. auth.setup.ts)
32
+ import { test as setup, expect } from '@playwright/test';
33
+
34
+ const adminFile = '.auth/admin_state.json';
35
+
36
+ setup('authenticate as admin', async ({ page }) => {
37
+ await page.goto('/login');
38
+ await page.fill('#username', process.env.ADMIN_USER!);
39
+ await page.fill('#password', process.env.ADMIN_PASS!);
40
+ await page.click('button[type="submit"]');
41
+ await page.waitForURL('**/dashboard');
42
+
43
+ await page.context().storageState({ path: adminFile });
44
+ });
45
+ ```
46
+
47
+ ### Pattern B: Injecting Session Directly (Zero-Second Login)
48
+ ```typescript
49
+ // Reusing authenticated session without loading login form
50
+ import { test } from '@playwright/test';
51
+
52
+ test.use({ storageState: '.auth/admin_state.json' });
53
+
54
+ test('access protected admin table directly', async ({ page }) => {
55
+ await page.goto('/admin/users'); // Opens already logged in
56
+ // Continue immediately with business actions
57
+ });
58
+ ```
59
+
60
+ ### Pattern C: Multi-Context Dual Role Testing (Maker vs Checker)
61
+ ```typescript
62
+ test('dual-role transaction approval', async ({ browser }) => {
63
+ // Context 1: Staff creates proposal
64
+ const staffContext = await browser.newContext({ storageState: '.auth/staff_state.json' });
65
+ const staffPage = await staffContext.newPage();
66
+ await staffPage.goto('/proposals/new');
67
+ // ... submit proposal ...
68
+
69
+ // Context 2: Manager reviews and approves
70
+ const managerContext = await browser.newContext({ storageState: '.auth/manager_state.json' });
71
+ const managerPage = await managerContext.newPage();
72
+ await managerPage.goto('/proposals/pending');
73
+ // ... approve proposal ...
74
+ });
75
+ ```
@@ -0,0 +1,70 @@
1
+ # Multi-Role Authentication Matrix & Zero-Second Session Management
2
+
3
+ > **Principle:** Never log in via UI forms repeatedly. Seed authenticated storageState once per role and reuse across test suites for 0-second test startup.
4
+
5
+ ---
6
+
7
+ ## 1. Role State Matrix
8
+
9
+ | Role | Permissions | Storage State File | Seeding Endpoint |
10
+ | :--- | :--- | :--- | :--- |
11
+ | **System Admin** | Full write, user management, billing, audits | `.auth/admin.json` | `POST /api/v1/auth/seed-admin` |
12
+ | **Branch Manager** | Order approval, invoice reconcile, read reports | `.auth/manager.json` | `POST /api/v1/auth/seed-manager` |
13
+ | **Cashier / Viewer** | View catalog, draft cart items, no billing | `.auth/cashier.json` | `POST /api/v1/auth/seed-cashier` |
14
+
15
+ ---
16
+
17
+ ## 2. Playwright Multi-Role Setup (`playwright.config.ts`)
18
+
19
+ ```typescript
20
+ import { defineConfig, devices } from '@playwright/test';
21
+
22
+ export default defineConfig({
23
+ projects: [
24
+ // Setup project: runs once before all tests
25
+ {
26
+ name: 'auth-setup',
27
+ testMatch: /.*\.setup\.ts/,
28
+ },
29
+ // Admin Tests
30
+ {
31
+ name: 'admin-tests',
32
+ use: {
33
+ ...devices['Desktop Chrome'],
34
+ storageState: '.auth/admin.json',
35
+ },
36
+ dependencies: ['auth-setup'],
37
+ },
38
+ // Manager Tests
39
+ {
40
+ name: 'manager-tests',
41
+ use: {
42
+ ...devices['Desktop Chrome'],
43
+ storageState: '.auth/manager.json',
44
+ },
45
+ dependencies: ['auth-setup'],
46
+ },
47
+ ],
48
+ });
49
+ ```
50
+
51
+ ---
52
+
53
+ ## 3. Silent Token Refresh Middleware
54
+
55
+ When API returns HTTP 401 mid-test, invoke direct refresh without re-entering login forms:
56
+ ```typescript
57
+ export async function refreshSessionToken(page: Page, refreshToken: string): Promise<string> {
58
+ const response = await page.request.post('/api/auth/token/refresh', {
59
+ data: { refresh_token: refreshToken },
60
+ });
61
+ const body = await response.json();
62
+ await page.context().addCookies([{
63
+ name: 'session_jwt',
64
+ value: body.access_token,
65
+ domain: 'localhost',
66
+ path: '/',
67
+ }]);
68
+ return body.access_token;
69
+ }
70
+ ```
@@ -0,0 +1,11 @@
1
+ {
2
+ "cookies": [
3
+ {
4
+ "name": "session_id",
5
+ "value": "sess_auto_998",
6
+ "domain": "example.com",
7
+ "path": "/"
8
+ }
9
+ ],
10
+ "origins": []
11
+ }
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: backend-load-and-stress-patterns
3
+ description: "Orchestrate k6, Locust, and JMeter backend load, stress, and SLA endurance test suites. Use when designing load, stress, or spike test patterns for backend systems."
4
+ ---
5
+
6
+ # Backend Load & Performance Testing Skill
7
+
8
+ > **Target:** Model concurrent Virtual User (VU) and arrival-rate traffic, execute stress/soak test profiles, and enforce automated SLA gates (P95/P99 latency, error rate < 1.0%) to detect bottlenecks before production.
9
+ > **Mandatory Rule:** Adhere strictly to [performance_testing_rules.md](../../rules/performance_testing_rules.md) for safety approvals, hard caps, and truth-anchor reporting.
10
+
11
+ ---
12
+
13
+ ## 1. Test Archetypes & SLA Targets
14
+
15
+ | Archetype | VUs / Rate | Duration | Objective | SLA Assertion |
16
+ | :--- | :--- | :--- | :--- | :--- |
17
+ | **Smoke Test** | 1 - 5 VUs | 1 - 2 min | Health sanity check | Error rate = 0%, P95 < 300ms |
18
+ | **Average Load** | 50 - 200 VUs | 10 - 30 min | Standard peak capacity | Error rate < 0.5%, P95 < 500ms |
19
+ | **Stress Test** | 200 -> 2,000 VUs | 20 - 45 min | Find degradation cliff | Graceful 429/503 (no JVM OOM) |
20
+ | **Spike Test** | 10 -> 1,000 VUs | 5 - 10 min | Autoscaling & rate limiters | Gateway recovery < 30s |
21
+ | **Soak Test** | 50 - 100 VUs | 2 - 12 hr | Memory leaks & connection leaks | Stable heap & steady latency |
22
+
23
+ ---
24
+
25
+ ## 2. Tooling Unified Runbook
26
+
27
+ ### Option A: Apache JMeter (Headless CLI + JTL Analyzer)
28
+ ```bash
29
+ # 1. Generate XML test plan from OpenAPI / Postman
30
+ synapse generate-jmx --spec api.json -o load_plan.jmx --vus 50 --duration 180 --sla-p95 500
31
+
32
+ # 2. Run headless benchmark
33
+ jmeter -n -t load_plan.jmx -l results.jtl -e -o ./html_report
34
+
35
+ # 3. Automated CI/CD Quality Gatekeeper
36
+ synapse analyze-jtl results.jtl --sla-p95 500 --max-error-rate 1.0
37
+ ```
38
+
39
+ ### Option B: k6 Production Load Testing (with Kill-Switch & Arrival Rate)
40
+ Execute high-concurrency production load tests with arrival-rate executors, user pooling, and automatic kill-switches.
41
+
42
+ ```bash
43
+ # Execute k6 test suite with environment variables
44
+ k6 run -e BASE_URL=https://api.staging.enterprise.local tests/perf/load_test.js
45
+ ```
46
+
47
+ 👉 **Full Implementation Script:** Refer to [**k6 Load Testing Template (`references/k6_load_template.js`)**](references/k6_load_template.js) for arrival-rate scenarios, SLA thresholds (`P95 < 500ms`, `P99 < 1000ms`), and per-VU session isolation.
48
+
49
+ ---
50
+
51
+ ## 3. Best Practices & Safety Invariants
52
+
53
+ - **Isolated Test Data:** Always use dynamic runtime identifiers (`PERF_AUTO_${Date.now()}`) to eliminate primary key collisions.
54
+ - **TearDown Hygiene:** Complement POST/creation load tests with automated teardown or ephemeral DB snapshots (`tools/db_sandbox.py`).
55
+ - **Telemetry Correlation:** Pair JTL/k6 metrics with server CPU/Memory traces via `tools/telemetry_correlator.py`.
56
+ - **Truth Anchor:** Never loosen thresholds to manufacture a false pass. A failing threshold indicates a system capacity limit to be investigated.
57
+
58
+ ---
59
+
60
+ ## 4. Code-as-Code Load Model (Locust)
61
+
62
+ > *Borrowed and adapted from the Locust load-testing model (MIT license, locustio/locust).*
63
+
64
+ When version-controlled, reviewable load tests matter more than XML tooling,
65
+ generate a runnable locustfile from the same API ingestion used for JMeter:
66
+
67
+ ```bash
68
+ synapse generate-jmx --spec swagger.json --emit-locust locustfile.py \
69
+ --weighted-mix "70,20,10" --think-time-min 500 --think-time-max 1500
70
+ locust -f locustfile.py --host=https://api.staging.enterprise.local
71
+ ```
72
+
73
+ The generated file follows the Locust shape — one `HttpUser` class, one
74
+ `@task(weight)` method per endpoint, `wait_time` from think-time — so QA
75
+ engineers can hand-tune scenarios in pure Python and commit them next to the
76
+ test suite.
77
+
78
+ 1. **Weights are the traffic mix** — the same `--weighted-mix` percentages that
79
+ drive JMeter `ThroughputController`s drive `@task` weights; keep both exports
80
+ in sync from one spec.
81
+ 2. **Prefer code-as-code for logic-heavy journeys** — conditional flows
82
+ (login → create → assert → delete) are Python, not XML; use the JMX export
83
+ for protocol breadth (JDBC/Kafka/gRPC/WS) and Locust for flow logic.
84
+ 3. **Same SLA gates** — run `agent-qa analyze-jtl` semantics on Locust stats:
85
+ fail CI when P95 breaches the SLA budget.
@@ -0,0 +1,13 @@
1
+ import http from 'k6/http';
2
+ import { check, sleep } from 'k6';
3
+
4
+ export const options = {
5
+ vus: 10,
6
+ duration: '30s',
7
+ };
8
+
9
+ export default function () {
10
+ const res = http.get('https://test.k6.io');
11
+ check(res, { 'status was 200': (r) => r.status == 200 });
12
+ sleep(1);
13
+ }
@@ -0,0 +1,82 @@
1
+ /**
2
+ * Production-Ready k6 Load Testing Template
3
+ * Features ramping arrival rate, kill-switch thresholds, user pooling, and per-VU session isolation.
4
+ */
5
+
6
+ import http from 'k6/http';
7
+ import { check, sleep } from 'k6';
8
+ import { SharedArray } from 'k6/data';
9
+
10
+ // 1. Parameterized Test Data: Load pre-seeded user pool to avoid single-token bottleneck
11
+ const userPool = new SharedArray('perf_users', function () {
12
+ // In production: JSON.parse(open('./users.json')) or dynamic credential matrix
13
+ return Array.from({ length: 200 }, (_, i) => ({
14
+ username: `perf_user_${i + 1}@staging.enterprise.local`,
15
+ password: `P@ssw0rd2026_${i + 1}`,
16
+ }));
17
+ });
18
+
19
+ export const options = {
20
+ discardResponseBodies: true,
21
+ scenarios: {
22
+ steady_load: {
23
+ executor: 'ramping-arrival-rate',
24
+ startRate: 10,
25
+ timeUnit: '1s',
26
+ preAllocatedVUs: 50,
27
+ maxVUs: 200,
28
+ stages: [
29
+ { duration: '2m', target: 50 }, // Ramp-up
30
+ { duration: '10m', target: 50 }, // Steady state (SLA measured here)
31
+ { duration: '2m', target: 0 }, // Ramp-down
32
+ ],
33
+ },
34
+ },
35
+ thresholds: {
36
+ // 1. Steady state SLA thresholds
37
+ 'http_req_failed{scenario:steady_load}': ['rate<0.01'],
38
+ 'http_req_duration{scenario:steady_load,expected_response:true}': ['p(95)<500', 'p(99)<1000'],
39
+ 'checks{scenario:steady_load}': ['rate>0.99'],
40
+ 'dropped_iterations{scenario:steady_load}': ['count==0'],
41
+ // 2. Kill-switch: abort test if system fails catastrophically
42
+ http_req_failed: [{ threshold: 'rate<0.10', abortOnFail: true, delayAbortEval: '30s' }],
43
+ },
44
+ };
45
+
46
+ // 2. Virtual User journey (Authentic Per-VU Session Isolation)
47
+ export default function () {
48
+ // Assign isolated user identity per virtual thread to avoid gateway concurrency lockups
49
+ const user = userPool[__VU % userPool.length];
50
+
51
+ // Per-VU authentic session acquisition
52
+ const loginRes = http.post(`${__ENV.BASE_URL}/api/v1/auth/login`, JSON.stringify(user), {
53
+ headers: { 'Content-Type': 'application/json' },
54
+ tags: { name: 'POST /api/v1/auth/login' },
55
+ });
56
+
57
+ check(loginRes, {
58
+ 'auth succeeded': (r) => r.status === 200 && r.json('token') !== undefined,
59
+ });
60
+
61
+ const authToken = loginRes.json('token');
62
+ const params = {
63
+ headers: {
64
+ 'Authorization': `Bearer ${authToken}`,
65
+ 'Content-Type': 'application/json',
66
+ },
67
+ tags: { name: 'GET /api/v1/items' },
68
+ };
69
+
70
+ const res = http.get(`${__ENV.BASE_URL}/api/v1/items?page=1&limit=20`, params);
71
+ check(res, {
72
+ 'status is 200': (r) => r.status === 200,
73
+ });
74
+
75
+ // Realistic think time between actions (uniform 1s to 3s)
76
+ sleep(Math.random() * 2 + 1);
77
+ }
78
+
79
+ // 3. Ephemeral teardown cleanup
80
+ export function teardown() {
81
+ // Execute teardown API calls for created PERF_ entities
82
+ }
@@ -0,0 +1,100 @@
1
+ ---
2
+ name: bats-testing-patterns
3
+ description: "Test bash/sh scripts, CLI tools, and CI/CD pipelines with Bats. Use when writing Bash automation tests with the BATS framework."
4
+ ---
5
+
6
+ # Bats Testing Patterns (Bash Automated Testing System)
7
+
8
+ Comprehensive test engineering standard for validating shell scripts, CI/CD scripts (`.sh`), CLI wrappers, and DevOps automation using Bats-core.
9
+
10
+ ---
11
+
12
+ ## 1. Core Principles
13
+
14
+ 1. **Deterministic Exit Codes:** Every script assertion must explicitly assert `$status` (0 for success, non-zero for explicit failure vectors).
15
+ 2. **Standard Output & Error Isolation:** Assert exact error strings in `${lines[@]}` or `$output`.
16
+ 3. **Sandbox Filesystem:** Never mutate user home or production directories. Use `$BATS_TEST_TMPDIR` for all temporary files and fixtures.
17
+ 4. **Mock External CLI Commands:** Intercept destructive CLI commands (`curl`, `docker`, `kubectl`, `git push`) by prepending a mock binary directory to `$PATH`.
18
+
19
+ ---
20
+
21
+ ## 2. Standard Test Architecture & Setup
22
+
23
+ ```bash
24
+ #!/usr/bin/env bats
25
+
26
+ setup() {
27
+ # Load bats helper libraries if available
28
+ load 'test_helper/bats-support/load' || true
29
+ load 'test_helper/bats-assert/load' || true
30
+
31
+ # Create an isolated sandbox directory per test
32
+ TEST_DIR="$(mktemp -d "${BATS_TMPDIR}/bats_test.XXXXXX")"
33
+ export TEST_DIR
34
+ cd "$TEST_DIR"
35
+ }
36
+
37
+ teardown() {
38
+ # Ensure clean sandbox teardown
39
+ rm -rf "$TEST_DIR"
40
+ }
41
+ ```
42
+
43
+ ---
44
+
45
+ ## 3. Production Test Patterns
46
+
47
+ ### Pattern A: Exit Code and Output Verification
48
+ ```bash
49
+ @test "script fails gracefully when required parameter is missing" {
50
+ run ./scripts/deploy.sh
51
+ [ "$status" -eq 1 ]
52
+ [[ "$output" =~ "ERROR: Missing --target environment" ]]
53
+ }
54
+
55
+ @test "script outputs version correctly on --version flag" {
56
+ run ./scripts/deploy.sh --version
57
+ [ "$status" -eq 0 ]
58
+ [ "${lines[0]}" = "deploy.sh version 2.4.0" ]
59
+ }
60
+ ```
61
+
62
+ ### Pattern B: Mocking Destructive CLI Tools
63
+ ```bash
64
+ @test "mock curl API failure triggers automatic retry loop" {
65
+ MOCK_DIR="${TEST_DIR}/bin"
66
+ mkdir -p "$MOCK_DIR"
67
+
68
+ # Create mock curl returning HTTP 503
69
+ cat << 'EOF' > "${MOCK_DIR}/curl"
70
+ #!/bin/bash
71
+ echo "HTTP/1.1 503 Service Unavailable" >&2
72
+ exit 22
73
+ EOF
74
+ chmod +x "${MOCK_DIR}/curl"
75
+
76
+ # Prepend mock path
77
+ PATH="${MOCK_DIR}:${PATH}" run ./scripts/sync_data.sh --retries 2
78
+ [ "$status" -ne 0 ]
79
+ [[ "$output" =~ "Retry attempt 2 failed" ]]
80
+ }
81
+ ```
82
+
83
+ ### Pattern C: File Creation & Mutation Verification
84
+ ```bash
85
+ @test "script generates valid JSON report on completion" {
86
+ run ./scripts/generate_report.sh --output "${TEST_DIR}/summary.json"
87
+ [ "$status" -eq 0 ]
88
+ [ -f "${TEST_DIR}/summary.json" ]
89
+ run jq '.status' "${TEST_DIR}/summary.json"
90
+ [ "$output" = '"SUCCESS"' ]
91
+ }
92
+ ```
93
+
94
+ ---
95
+
96
+ ## 4. CI/CD Pipeline Execution
97
+ ```bash
98
+ # Execute full Bats test suite with JUnit report output for CI
99
+ bats test/*.bats --formatter junit > test-results.xml
100
+ ```
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/env bats
2
+
3
+ @test 'verify CLI returns version' {
4
+ run python3 tools/cli.py --version
5
+ [ "$status" -eq 0 ]
6
+ }