@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,450 @@
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
+ Enterprise 5-Stage QA Multi-Agent Finite State Machine (FSM) Enforcer
8
+ ---------------------------------------------------------------------
9
+ Converts the descriptive 5-stage markdown workflow into an executable,
10
+ tamper-evident state machine enforced by code:
11
+ Stage 1: DISCOVERY (Actor: live-explorer) -> Requires DOM/AOM discovery contract
12
+ Stage 2: CODE_SYNTHESIS (Actor: pom-crafter) -> Requires synthesized PageClass/script
13
+ Stage 3: HEADLESS_EXEC (Actor: test-runner) -> Requires test run evidence (JUnit/exitcode)
14
+ Stage 4: AUTOPSY_HEAL (Actor: failure-analyst) -> Requires autopsy triage (or PASSED waiver)
15
+ Stage 5: ACCEPTANCE_DOD (Actor: quality-gatekeeper) -> Requires 11 Quality Gates verification
16
+
17
+ Usage:
18
+ python tools/fsm_enforcer.py start --session-id "SESS_001"
19
+ python tools/fsm_enforcer.py advance --stage DISCOVERY --actor live-explorer --evidence '{"target": "login"}'
20
+ python tools/fsm_enforcer.py advance --stage CODE_SYNTHESIS --actor pom-crafter --evidence '{"files": ["LoginPage.ts"]}'
21
+ python tools/fsm_enforcer.py advance --stage HEADLESS_EXEC --actor test-runner --evidence '{"exit_code": 0}'
22
+ python tools/fsm_enforcer.py advance --stage AUTOPSY_HEAL --actor failure-analyst --evidence '{"status": "PASSED"}'
23
+ python tools/fsm_enforcer.py advance --stage ACCEPTANCE_DOD --actor quality-gatekeeper --evidence '{"gates": 11}'
24
+ python tools/fsm_enforcer.py verify-compliance
25
+ """
26
+
27
+ import os
28
+ import sys
29
+ import json
30
+ import uuid
31
+ import hmac
32
+ import hashlib
33
+ import argparse
34
+ from datetime import datetime, timezone
35
+ from typing import Dict, Any, Optional, Tuple, List
36
+
37
+ STAGES_ORDER = [
38
+ "DISCOVERY",
39
+ "CODE_SYNTHESIS",
40
+ "HEADLESS_EXEC",
41
+ "AUTOPSY_HEAL",
42
+ "ACCEPTANCE_DOD"
43
+ ]
44
+
45
+ STAGE_ACTORS = {
46
+ "DISCOVERY": ["live-explorer", "test-designer"],
47
+ "CODE_SYNTHESIS": ["pom-crafter", "api-engineer"],
48
+ "HEADLESS_EXEC": ["test-runner", "perf-engineer", "api-engineer"],
49
+ "AUTOPSY_HEAL": ["failure-analyst"],
50
+ "ACCEPTANCE_DOD": ["quality-gatekeeper"]
51
+ }
52
+
53
+ # Formal Stage Evidence Contract Schemas
54
+ STAGE_EVIDENCE_SCHEMAS = {
55
+ "DISCOVERY": {
56
+ "required_any": ["selectors", "locators", "target_url", "url", "target", "element", "elements", "dom_hash", "aom_nodes", "test_cases", "matrix", "story", "spec", "requirements"],
57
+ "description": "Requires DOM/AOM discovery contract (target URL, selectors, elements list, or requirement/test matrix specification)."
58
+ },
59
+ "CODE_SYNTHESIS": {
60
+ "required_any": ["pages", "files", "scripts", "page_classes", "file", "classes", "matrix", "api_matrix", "endpoints"],
61
+ "description": "Requires synthesized PageClass, API test matrix, or test script file list/signatures."
62
+ },
63
+ "HEADLESS_EXEC": {
64
+ "required_fields": ["exit_code"],
65
+ "field_types": {"exit_code": int},
66
+ "description": "Requires headless execution exit_code (int) and optional test summary/artifact."
67
+ },
68
+ "AUTOPSY_HEAL": {
69
+ "required_any": ["verdict", "status", "waiver", "root_cause", "patch", "triage", "action"],
70
+ "description": "Requires triage analysis, root_cause & patch, or waiver (e.g. PASSED_NO_HEAL_NEEDED)."
71
+ },
72
+ "ACCEPTANCE_DOD": {
73
+ "required_any": ["gates_passed", "gates", "verify_all_passed", "passed_gates", "summary"],
74
+ "description": "Requires 11 Quality Gates DoD verification evidence."
75
+ }
76
+ }
77
+
78
+
79
+ def validate_stage_evidence(stage: str, evidence: Dict[str, Any]) -> Tuple[bool, Optional[str]]:
80
+ """Validates that stage evidence adheres to its formal data contract schema."""
81
+ if not isinstance(evidence, dict) or not evidence:
82
+ return False, f"Stage '{stage}' requires a non-empty evidence dictionary."
83
+
84
+ schema = STAGE_EVIDENCE_SCHEMAS.get(stage)
85
+ if not schema:
86
+ return True, None
87
+
88
+ if "required_fields" in schema:
89
+ for rf in schema["required_fields"]:
90
+ if rf not in evidence:
91
+ return False, f"Stage '{stage}' evidence missing mandatory field '{rf}'. {schema['description']}"
92
+
93
+ if "field_types" in schema:
94
+ for f, expected_type in schema["field_types"].items():
95
+ if f in evidence and not isinstance(evidence[f], expected_type):
96
+ return False, f"Stage '{stage}' evidence field '{f}' must be of type {expected_type.__name__}, got {type(evidence[f]).__name__}."
97
+
98
+ if "required_any" in schema:
99
+ has_any = any(k in evidence for k in schema["required_any"])
100
+ if not has_any:
101
+ return False, f"Stage '{stage}' evidence missing required context. Must include at least one of: {schema['required_any']}. {schema['description']}"
102
+
103
+ return True, None
104
+
105
+
106
+ def compute_proof_token(session_id: str, stage: str, actor: str, evidence: Dict[str, Any], timestamp: str) -> Tuple[str, str]:
107
+ """
108
+ Computes a tamper-evident cryptographic HMAC-SHA256 proof token for stage signoff.
109
+ Returns (proof_token, evidence_hash).
110
+ """
111
+ canonical_ev = json.dumps(evidence, sort_keys=True, separators=(",", ":"))
112
+ ev_hash = hashlib.sha256(canonical_ev.encode("utf-8")).hexdigest()
113
+ payload = f"{session_id}:{stage}:{actor}:{ev_hash}:{timestamp}"
114
+ token_sig = hmac.new(session_id.encode("utf-8"), payload.encode("utf-8"), hashlib.sha256).hexdigest()[:24]
115
+ token = f"proof_v2_{stage.lower()}_{token_sig}"
116
+ return token, ev_hash
117
+
118
+
119
+ def verify_proof_token(session_id: str, stage: str, actor: str, evidence: Dict[str, Any], timestamp: str, token: str) -> bool:
120
+ """Verifies that a proof token matches the evidence payload and has not been forged or tampered with."""
121
+ expected_token, _ = compute_proof_token(session_id, stage, actor, evidence, timestamp)
122
+ return hmac.compare_digest(token, expected_token)
123
+
124
+
125
+ def compute_artifact_hashes(artifacts: List[str], base_dir: Optional[str] = None) -> Dict[str, str]:
126
+ """
127
+ Computes cryptographic SHA-256 digests for physical artifact files on disk.
128
+ Returns mapping of {artifact_path: sha256_hexdigest}.
129
+ """
130
+ hashes = {}
131
+ for item in artifacts:
132
+ target = os.path.join(base_dir, item) if base_dir and not os.path.isabs(item) else item
133
+ if os.path.isfile(target):
134
+ try:
135
+ with open(target, "rb") as f:
136
+ file_bytes = f.read()
137
+ hashes[item] = hashlib.sha256(file_bytes).hexdigest()
138
+ except OSError as err:
139
+ _ = err
140
+ return hashes
141
+
142
+
143
+ def verify_artifact_integrity(session_state: Dict[str, Any], base_dir: Optional[str] = None) -> Tuple[bool, List[str]]:
144
+ """
145
+ Verifies that all physical artifact files referenced in the session match their recorded SHA-256 hashes.
146
+ Returns (all_intact: bool, violations: List[str]).
147
+ """
148
+ violations = []
149
+ completed = session_state.get("completed_stages", {})
150
+ for stage_name, record in completed.items():
151
+ evidence = record.get("evidence", {})
152
+ recorded_hashes = evidence.get("artifact_hashes", {})
153
+ for item, recorded_hash in recorded_hashes.items():
154
+ target = os.path.join(base_dir, item) if base_dir and not os.path.isabs(item) else item
155
+ if not os.path.isfile(target):
156
+ violations.append(f"Stage '{stage_name}' artifact missing on disk: {item}")
157
+ continue
158
+ try:
159
+ with open(target, "rb") as f:
160
+ current_bytes = f.read()
161
+ current_hash = hashlib.sha256(current_bytes).hexdigest()
162
+ if current_hash != recorded_hash:
163
+ violations.append(f"Stage '{stage_name}' artifact tampered on disk: {item} (expected {recorded_hash[:12]}..., got {current_hash[:12]}...)")
164
+ except OSError as err:
165
+ violations.append(f"Stage '{stage_name}' failed to read artifact: {item} ({err})")
166
+ return len(violations) == 0, violations
167
+
168
+
169
+ class FsmEnforcer:
170
+ """Executable finite state machine enforcing strict multi-agent workflow compliance."""
171
+
172
+ def __init__(self, state_file: Optional[str] = None):
173
+ if state_file:
174
+ self.state_file = state_file
175
+ else:
176
+ repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
177
+ self.state_file = os.path.join(repo_root, ".agent_memory", "fsm_session.json")
178
+
179
+ os.makedirs(os.path.dirname(os.path.abspath(self.state_file)), exist_ok=True)
180
+ self._load_state()
181
+
182
+ def _load_state(self):
183
+ if os.path.exists(self.state_file):
184
+ try:
185
+ with open(self.state_file, "r", encoding="utf-8") as f:
186
+ self.state = json.load(f)
187
+ except Exception:
188
+ self.state = self._empty_state()
189
+ else:
190
+ self.state = self._empty_state()
191
+
192
+ def _save_state(self):
193
+ tmp_file = f"{self.state_file}.{uuid.uuid4().hex[:8]}.tmp"
194
+ with open(tmp_file, "w", encoding="utf-8") as f:
195
+ json.dump(self.state, f, indent=2, ensure_ascii=False)
196
+ os.replace(tmp_file, self.state_file)
197
+
198
+ def _empty_state(self) -> Dict[str, Any]:
199
+ return {
200
+ "session_id": f"sess_{uuid.uuid4().hex[:8]}",
201
+ "current_stage": None,
202
+ "stage_history": [],
203
+ "completed_stages": {},
204
+ "status": "INITIALIZED",
205
+ "created_at": datetime.now(timezone.utc).isoformat(),
206
+ "updated_at": datetime.now(timezone.utc).isoformat()
207
+ }
208
+
209
+ def start_session(self, session_id: Optional[str] = None) -> Dict[str, Any]:
210
+ """Initializes a new workflow session."""
211
+ self.state = self._empty_state()
212
+ if session_id:
213
+ self.state["session_id"] = session_id
214
+ self.state["status"] = "IN_PROGRESS"
215
+ self._save_state()
216
+ return {
217
+ "status": "PASS",
218
+ "session_id": self.state["session_id"],
219
+ "current_stage": None,
220
+ "next_required_stage": STAGES_ORDER[0]
221
+ }
222
+
223
+ def advance_stage(self, stage: str, actor: str, evidence: Dict[str, Any]) -> Dict[str, Any]:
224
+ """Advances workflow to the specified stage with evidence validation."""
225
+ self._load_state()
226
+ stage_upper = stage.upper().strip()
227
+ if stage_upper not in STAGES_ORDER:
228
+ return {
229
+ "status": "REJECTED",
230
+ "error": f"Invalid stage '{stage}'. Must be one of: {STAGES_ORDER}"
231
+ }
232
+
233
+ target_idx = STAGES_ORDER.index(stage_upper)
234
+ completed = self.state.get("completed_stages", {})
235
+
236
+ # 1. Enforce strict sequential order (cannot jump stages)
237
+ for prev_idx in range(target_idx):
238
+ prev_stage = STAGES_ORDER[prev_idx]
239
+ if prev_stage not in completed:
240
+ return {
241
+ "status": "REJECTED",
242
+ "error": f"Cannot transition to stage '{stage_upper}'. Preceding stage '{prev_stage}' has not been completed."
243
+ }
244
+
245
+ # 2. Validate actor authorization
246
+ allowed_actors = STAGE_ACTORS.get(stage_upper, [])
247
+ if actor not in allowed_actors:
248
+ return {
249
+ "status": "REJECTED",
250
+ "error": f"Actor '{actor}' is not authorized to sign off on stage '{stage_upper}'. Required: {allowed_actors}"
251
+ }
252
+
253
+ # 3. Evidence contract schema validation
254
+ valid, schema_err = validate_stage_evidence(stage_upper, evidence)
255
+ if not valid:
256
+ return {
257
+ "status": "REJECTED",
258
+ "error": schema_err
259
+ }
260
+
261
+ # 4. Automatic Physical Artifact SHA-256 Hashing
262
+ artifact_candidates = []
263
+ for key in ["files", "scripts", "pages", "page_classes", "artifacts"]:
264
+ val = evidence.get(key)
265
+ if isinstance(val, list):
266
+ artifact_candidates.extend([str(v) for v in val if isinstance(v, str)])
267
+ elif isinstance(val, str):
268
+ artifact_candidates.append(val)
269
+ if "file" in evidence and isinstance(evidence["file"], str):
270
+ artifact_candidates.append(evidence["file"])
271
+
272
+ if artifact_candidates:
273
+ repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
274
+ artifact_hashes = compute_artifact_hashes(artifact_candidates, base_dir=repo_root)
275
+ if artifact_hashes:
276
+ evidence["artifact_hashes"] = artifact_hashes
277
+
278
+ now_iso = datetime.now(timezone.utc).isoformat()
279
+ proof_token, ev_hash = compute_proof_token(
280
+ self.state["session_id"],
281
+ stage_upper,
282
+ actor,
283
+ evidence,
284
+ now_iso
285
+ )
286
+
287
+ record = {
288
+ "stage": stage_upper,
289
+ "actor": actor,
290
+ "sequence": len(self.state["stage_history"]) + 1,
291
+ "proof_token": proof_token,
292
+ "evidence_hash": ev_hash,
293
+ "evidence": evidence,
294
+ "timestamp": now_iso
295
+ }
296
+
297
+ self.state["completed_stages"][stage_upper] = record
298
+ self.state["stage_history"].append(record)
299
+ self.state["current_stage"] = stage_upper
300
+ self.state["updated_at"] = now_iso
301
+
302
+ if len(self.state["completed_stages"]) == len(STAGES_ORDER):
303
+ self.state["status"] = "COMPLETED"
304
+
305
+ self._save_state()
306
+
307
+ next_idx = target_idx + 1
308
+ next_stage = STAGES_ORDER[next_idx] if next_idx < len(STAGES_ORDER) else None
309
+
310
+ return {
311
+ "status": "PASS",
312
+ "session_id": self.state["session_id"],
313
+ "stage_advanced": stage_upper,
314
+ "proof_token": proof_token,
315
+ "next_required_stage": next_stage,
316
+ "workflow_completed": (self.state["status"] == "COMPLETED")
317
+ }
318
+
319
+ def verify_compliance(self) -> Dict[str, Any]:
320
+ """Audits workflow session to verify if task definition of done is legally satisfied."""
321
+ self._load_state()
322
+ completed = self.state.get("completed_stages", {})
323
+ missing = [s for s in STAGES_ORDER if s not in completed]
324
+
325
+ if missing:
326
+ return {
327
+ "status": "BLOCKED",
328
+ "compliant": False,
329
+ "session_id": self.state["session_id"],
330
+ "missing_stages": missing,
331
+ "completed_count": f"{len(completed)}/{len(STAGES_ORDER)}",
332
+ "error": f"Workflow is incomplete! Missing stages: {missing}"
333
+ }
334
+
335
+ # Cryptographic verification of all stage proof tokens
336
+ tampered_stages = []
337
+ for s in STAGES_ORDER:
338
+ rec = completed[s]
339
+ token = rec.get("proof_token", "")
340
+ if token.startswith("proof_v2_"):
341
+ is_valid = verify_proof_token(
342
+ self.state["session_id"],
343
+ s,
344
+ rec.get("actor", ""),
345
+ rec.get("evidence", {}),
346
+ rec.get("timestamp", ""),
347
+ token
348
+ )
349
+ if not is_valid:
350
+ tampered_stages.append(s)
351
+
352
+ if tampered_stages:
353
+ return {
354
+ "status": "BLOCKED",
355
+ "compliant": False,
356
+ "session_id": self.state["session_id"],
357
+ "error": f"Cryptographic integrity verification failed! Proof tokens for stages {tampered_stages} do not match evidence.",
358
+ "tampered_stages": tampered_stages
359
+ }
360
+
361
+ # Physical artifact integrity verification
362
+ repo_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
363
+ artifacts_ok, artifact_violations = verify_artifact_integrity(self.state, base_dir=repo_root)
364
+ if not artifacts_ok:
365
+ return {
366
+ "status": "BLOCKED",
367
+ "compliant": False,
368
+ "session_id": self.state["session_id"],
369
+ "error": f"Artifact integrity verification failed! {len(artifact_violations)} violation(s) detected.",
370
+ "artifact_violations": artifact_violations
371
+ }
372
+
373
+ return {
374
+ "status": "PASS",
375
+ "compliant": True,
376
+ "session_id": self.state["session_id"],
377
+ "total_stages": len(STAGES_ORDER),
378
+ "proof_tokens": {s: completed[s]["proof_token"] for s in STAGES_ORDER},
379
+ "summary": "100% 5-Stage FSM workflow verified with valid cryptographic proof tokens."
380
+ }
381
+
382
+ def get_status(self) -> Dict[str, Any]:
383
+ """Returns current FSM status."""
384
+ self._load_state()
385
+ completed = self.state.get("completed_stages", {})
386
+ return {
387
+ "session_id": self.state["session_id"],
388
+ "status": self.state["status"],
389
+ "current_stage": self.state.get("current_stage"),
390
+ "completed_stages": list(completed.keys()),
391
+ "progress_pct": round((len(completed) / len(STAGES_ORDER)) * 100.0, 1),
392
+ "history_count": len(self.state.get("stage_history", []))
393
+ }
394
+
395
+
396
+ def main():
397
+ parser = argparse.ArgumentParser(description="Enterprise 5-Stage QA Multi-Agent FSM Enforcer")
398
+ subparsers = parser.add_subparsers(dest="subcommand", help="FSM subcommand to run")
399
+
400
+ # start
401
+ sp_start = subparsers.add_parser("start", help="Start new FSM session")
402
+ sp_start.add_argument("--session-id", help="Optional custom session ID")
403
+
404
+ # advance
405
+ sp_adv = subparsers.add_parser("advance", help="Advance workflow stage")
406
+ sp_adv.add_argument("--stage", required=True, choices=STAGES_ORDER, help="Target stage")
407
+ sp_adv.add_argument("--actor", required=True, help="Actor role submitting evidence")
408
+ sp_adv.add_argument("--evidence", required=True, help="JSON string containing stage evidence")
409
+
410
+ # verify-compliance
411
+ subparsers.add_parser("verify-compliance", help="Verify full workflow compliance before DoD closure")
412
+
413
+ # status
414
+ subparsers.add_parser("status", help="Display current FSM status")
415
+
416
+ args = parser.parse_args()
417
+ enforcer = FsmEnforcer()
418
+
419
+ if args.subcommand == "start":
420
+ res = enforcer.start_session(args.session_id)
421
+ print(json.dumps(res, indent=2))
422
+ sys.exit(0)
423
+
424
+ elif args.subcommand == "advance":
425
+ try:
426
+ ev = json.loads(args.evidence)
427
+ except Exception as e:
428
+ print(json.dumps({"status": "REJECTED", "error": f"Invalid JSON in evidence: {e}"}, indent=2))
429
+ sys.exit(1)
430
+ res = enforcer.advance_stage(args.stage, args.actor, ev)
431
+ print(json.dumps(res, indent=2))
432
+ sys.exit(0 if res["status"] == "PASS" else 1)
433
+
434
+ elif args.subcommand == "verify-compliance":
435
+ res = enforcer.verify_compliance()
436
+ print(json.dumps(res, indent=2))
437
+ sys.exit(0 if res["status"] == "PASS" else 1)
438
+
439
+ elif args.subcommand == "status":
440
+ res = enforcer.get_status()
441
+ print(json.dumps(res, indent=2))
442
+ sys.exit(0)
443
+
444
+ else:
445
+ parser.print_help()
446
+ sys.exit(1)
447
+
448
+
449
+ if __name__ == "__main__":
450
+ main()