@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,369 @@
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
+ QA Agent-Computer Interface (SWE-agent ACI Pattern)
8
+ ---------------------------------------------------
9
+ Provides a safe, constrained interface for AI agents interacting with repository files:
10
+ 1. view-window: Read files in constrained windows (40-50 lines) with explicit line numbering,
11
+ preventing context window blowout.
12
+ 2. surgical-edit: Safe contiguous chunk replacement with pre-commit AST syntax validation,
13
+ Clean POM checks (zero raw selectors in test scripts), and 100% UTF-8 No BOM enforcement.
14
+ 3. run-distilled: Execute shell commands and distill stdout/stderr to head + tail lines,
15
+ preventing runner log flooding.
16
+
17
+ Usage:
18
+ python tools/swe_qa_aci.py view-window --file src/pages/LoginPage.ts --start-line 20 --window-size 40
19
+ python tools/swe_qa_aci.py surgical-edit --file src/pages/LoginPage.ts --target-chunk "..." --replacement-chunk "..."
20
+ python tools/swe_qa_aci.py run-distilled --command "pytest" --max-lines 50
21
+ """
22
+
23
+ import os
24
+ import sys
25
+ import re
26
+ import json
27
+ import ast
28
+ import subprocess
29
+ import argparse
30
+ from typing import Dict, Any, Optional, Tuple
31
+
32
+ # Enforce UTF-8 stdout encoding
33
+ if hasattr(sys.stdout, 'reconfigure'):
34
+ try:
35
+ sys.stdout.reconfigure(encoding='utf-8')
36
+ sys.stderr.reconfigure(encoding='utf-8')
37
+ except Exception:
38
+ pass
39
+
40
+
41
+ class SweQaAci:
42
+ """Agent-Computer Interface for Safe QA Operations."""
43
+
44
+ def __init__(self, repo_root: Optional[str] = None):
45
+ self.repo_root = repo_root or os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
46
+
47
+ def resolve_path(self, file_path: str) -> str:
48
+ """Resolves file path safely relative to repo root."""
49
+ if os.path.isabs(file_path):
50
+ return file_path
51
+ return os.path.join(self.repo_root, file_path)
52
+
53
+ def view_window(self, file_path: str, start_line: int = 1, window_size: int = 40,
54
+ as_json: bool = False) -> Dict[str, Any]:
55
+ """Reads file within a bounded window with line numbers to avoid context bloat."""
56
+ resolved = self.resolve_path(file_path)
57
+ if not os.path.exists(resolved):
58
+ return {
59
+ "status": "FAIL",
60
+ "error": f"File not found: {file_path}",
61
+ "lines": []
62
+ }
63
+
64
+ try:
65
+ with open(resolved, "r", encoding="utf-8", errors="replace") as f:
66
+ all_lines = f.readlines()
67
+ except Exception as e:
68
+ return {"status": "FAIL", "error": str(e), "lines": []}
69
+
70
+ total_lines = len(all_lines)
71
+ start_idx = max(1, start_line)
72
+ end_idx = min(total_lines, start_idx + window_size - 1)
73
+
74
+ window_lines = []
75
+ for i in range(start_idx, end_idx + 1):
76
+ line_str = all_lines[i - 1].rstrip("\r\n")
77
+ window_lines.append(f"{i:4d} | {line_str}")
78
+
79
+ result = {
80
+ "status": "PASS",
81
+ "file": file_path.replace("\\", "/"),
82
+ "start_line": start_idx,
83
+ "end_line": end_idx,
84
+ "total_lines": total_lines,
85
+ "window_size": len(window_lines),
86
+ "content": "\n".join(window_lines)
87
+ }
88
+ return result
89
+
90
+ def validate_syntax(self, content: str, file_path: str) -> Tuple[bool, str]:
91
+ """Validates AST syntax based on file extension."""
92
+ ext = file_path.rsplit(".", 1)[-1].lower() if "." in file_path else ""
93
+ if ext == "py":
94
+ try:
95
+ ast.parse(content)
96
+ return True, "SYNTAX_VALID"
97
+ except SyntaxError as e:
98
+ return False, f"Python SyntaxError at line {e.lineno}: {e.msg}"
99
+
100
+ # Lightweight balance check for JS/TS/Groovy
101
+ brackets = {'(': ')', '{': '}', '[': ']'}
102
+ stack = []
103
+ in_string = False
104
+ quote_char = ''
105
+ escape = False
106
+
107
+ for char in content:
108
+ if escape:
109
+ escape = False
110
+ continue
111
+ if char == '\\':
112
+ escape = True
113
+ continue
114
+ if char in ("'", '"', '`'):
115
+ if not in_string:
116
+ in_string = True
117
+ quote_char = char
118
+ elif quote_char == char:
119
+ in_string = False
120
+ elif not in_string:
121
+ if char in brackets:
122
+ stack.append(brackets[char])
123
+ elif char in brackets.values():
124
+ if not stack or stack.pop() != char:
125
+ return False, f"Unbalanced bracket '{char}' detected"
126
+
127
+ if stack:
128
+ return False, f"Unclosed bracket: expected '{stack[-1]}'"
129
+
130
+ return True, "SYNTAX_VALID"
131
+
132
+ def check_clean_pom(self, file_path: str, replacement_chunk: str) -> Tuple[bool, str]:
133
+ """Verifies Clean POM invariants: no raw selectors in test script files."""
134
+ is_test_script = any(part in file_path.lower() for part in ["tests/", "scripts/", ".spec.", ".test."])
135
+ if is_test_script:
136
+ forbidden = [
137
+ (r'//[\w*@\[\]]+', "Raw XPath (//...)"),
138
+ (r'xpath=', "Explicit xpath= locator"),
139
+ (r'css=', "Explicit css= locator"),
140
+ (r'findTestObject\(', "Katalon findTestObject in script"),
141
+ ]
142
+ for pat, desc in forbidden:
143
+ if re.search(pat, replacement_chunk):
144
+ return False, f"Clean POM violation: {desc} strictly forbidden in test scripts ({file_path})"
145
+ return True, "CLEAN_POM_VERIFIED"
146
+
147
+ def surgical_edit(self, file_path: str, target_chunk: str, replacement_chunk: str,
148
+ validate_syntax: bool = True, enforce_clean_pom: bool = True) -> Dict[str, Any]:
149
+ """Performs precise chunk replacement with safety checks and UTF-8 No BOM guarantee."""
150
+ resolved = self.resolve_path(file_path)
151
+ if not os.path.exists(resolved):
152
+ return {
153
+ "status": "FAIL",
154
+ "file": file_path,
155
+ "error": f"File not found: {file_path}"
156
+ }
157
+
158
+ # Check Clean POM constraint first
159
+ if enforce_clean_pom:
160
+ pom_ok, pom_msg = self.check_clean_pom(file_path, replacement_chunk)
161
+ if not pom_ok:
162
+ return {
163
+ "status": "FAIL",
164
+ "file": file_path,
165
+ "error": pom_msg,
166
+ "clean_pom_verified": False
167
+ }
168
+
169
+ try:
170
+ with open(resolved, "r", encoding="utf-8") as f:
171
+ original_content = f.read()
172
+ except UnicodeDecodeError:
173
+ with open(resolved, "r", encoding="utf-8", errors="replace") as f:
174
+ original_content = f.read()
175
+
176
+ # Normalize line endings for target match
177
+ norm_orig = original_content.replace("\r\n", "\n")
178
+ norm_target = target_chunk.replace("\r\n", "\n")
179
+ norm_replacement = replacement_chunk.replace("\r\n", "\n")
180
+
181
+ if norm_target not in norm_orig:
182
+ return {
183
+ "status": "FAIL",
184
+ "file": file_path,
185
+ "error": "Target chunk was not found in file. Ensure exact whitespace and newline match."
186
+ }
187
+
188
+ occurrences = norm_orig.count(norm_target)
189
+ if occurrences > 1:
190
+ return {
191
+ "status": "FAIL",
192
+ "file": file_path,
193
+ "error": f"Ambiguous target: found {occurrences} occurrences in file. Include more surrounding context."
194
+ }
195
+
196
+ # Calculate line replacement range
197
+ before_match = norm_orig[:norm_orig.find(norm_target)]
198
+ start_line = before_match.count("\n") + 1
199
+ end_line = start_line + norm_target.count("\n")
200
+
201
+ new_content = norm_orig.replace(norm_target, norm_replacement, 1)
202
+
203
+ # Pre-commit syntax validation
204
+ if validate_syntax:
205
+ syn_ok, syn_msg = self.validate_syntax(new_content, file_path)
206
+ if not syn_ok:
207
+ return {
208
+ "status": "FAIL",
209
+ "file": file_path,
210
+ "error": f"Pre-commit AST syntax check failed: {syn_msg}",
211
+ "ast_validation": "SYNTAX_INVALID"
212
+ }
213
+
214
+ # Write back cleanly with 100% UTF-8 No BOM
215
+ with open(resolved, "w", encoding="utf-8", newline="\n") as f:
216
+ f.write(new_content)
217
+
218
+ # Diff summary formatting
219
+ target_lines = [f"- {line}" for line in norm_target.splitlines()]
220
+ replacement_lines = [f"+ {line}" for line in norm_replacement.splitlines()]
221
+ diff_summary = "\n".join(target_lines + replacement_lines)
222
+
223
+ return {
224
+ "status": "PASS",
225
+ "file": file_path.replace("\\", "/"),
226
+ "lines_replaced": {
227
+ "start": start_line,
228
+ "end": end_line
229
+ },
230
+ "ast_validation": "SYNTAX_VALID",
231
+ "utf8_nobom_verified": True,
232
+ "clean_pom_verified": True,
233
+ "diff_summary": diff_summary
234
+ }
235
+
236
+ def run_distilled(self, command: str, max_lines: int = 50, timeout_sec: float = 60.0) -> Dict[str, Any]:
237
+ """Runs command and distills output to head + tail lines, preventing context flood."""
238
+ try:
239
+ import shlex
240
+ if isinstance(command, str):
241
+ if sys.platform == "win32":
242
+ raw_args = shlex.split(command, posix=False)
243
+ cmd_args = []
244
+ for a in raw_args:
245
+ if (a.startswith('"') and a.endswith('"')) or (a.startswith("'") and a.endswith("'")):
246
+ cmd_args.append(a[1:-1])
247
+ else:
248
+ cmd_args.append(a)
249
+ else:
250
+ cmd_args = shlex.split(command)
251
+ else:
252
+ cmd_args = list(command)
253
+
254
+ res = subprocess.run(
255
+ cmd_args,
256
+ cwd=self.repo_root,
257
+ stdout=subprocess.PIPE,
258
+ stderr=subprocess.PIPE,
259
+ text=True,
260
+ encoding="utf-8",
261
+ errors="replace",
262
+ timeout=timeout_sec
263
+ )
264
+ raw_stdout = res.stdout or ""
265
+ raw_stderr = res.stderr or ""
266
+ combined = raw_stdout + ("\n--- STDERR ---\n" + raw_stderr if raw_stderr.strip() else "")
267
+ except subprocess.TimeoutExpired:
268
+ return {
269
+ "status": "TIMEOUT",
270
+ "command": command,
271
+ "exit_code": -1,
272
+ "distilled_output": f"Command timed out after {timeout_sec}s"
273
+ }
274
+ except Exception as e:
275
+ return {
276
+ "status": "ERROR",
277
+ "command": command,
278
+ "exit_code": -1,
279
+ "distilled_output": str(e)
280
+ }
281
+
282
+ lines = combined.splitlines()
283
+ total = len(lines)
284
+ if total <= max_lines:
285
+ distilled = "\n".join(lines)
286
+ else:
287
+ head_count = max_lines // 2
288
+ tail_count = max_lines - head_count
289
+ distilled_lines = (
290
+ lines[:head_count]
291
+ + [f"\n... [TRUNCATED {total - max_lines} NOISE LINES] ...\n"]
292
+ + lines[-tail_count:]
293
+ )
294
+ distilled = "\n".join(distilled_lines)
295
+
296
+ return {
297
+ "status": "PASS" if res.returncode == 0 else "FAIL",
298
+ "command": command,
299
+ "exit_code": res.returncode,
300
+ "total_lines": total,
301
+ "distilled_lines": min(total, max_lines),
302
+ "distilled_output": distilled
303
+ }
304
+
305
+
306
+ def main():
307
+ parser = argparse.ArgumentParser(description="QA Agent-Computer Interface (SWE-agent ACI)")
308
+ subparsers = parser.add_subparsers(dest="subcommand", help="Subcommand to execute")
309
+
310
+ # view-window
311
+ vw_parser = subparsers.add_parser("view-window", help="View a file in bounded window")
312
+ vw_parser.add_argument("--file", required=True, help="Target file path")
313
+ vw_parser.add_argument("--start-line", type=int, default=1, help="Start line number (1-indexed)")
314
+ vw_parser.add_argument("--window-size", type=int, default=40, help="Window line size (default 40)")
315
+ vw_parser.add_argument("--json", action="store_true", help="Output as JSON")
316
+
317
+ # surgical-edit
318
+ se_parser = subparsers.add_parser("surgical-edit", help="Surgically edit file with pre-commit checks")
319
+ se_parser.add_argument("--file", required=True, help="Target file path")
320
+ se_parser.add_argument("--target-chunk", required=True, help="Exact code chunk to replace")
321
+ se_parser.add_argument("--replacement-chunk", required=True, help="New code chunk")
322
+ se_parser.add_argument("--validate-syntax", action="store_true", default=True, help="Check AST syntax before writing")
323
+ se_parser.add_argument("--no-validate-syntax", dest="validate_syntax", action="store_false")
324
+ se_parser.add_argument("--enforce-clean-pom", action="store_true", default=True, help="Enforce Clean POM rules")
325
+
326
+ # run-distilled
327
+ rd_parser = subparsers.add_parser("run-distilled", help="Run shell command with distilled output")
328
+ rd_parser.add_argument("--command", required=True, help="Shell command string")
329
+ rd_parser.add_argument("--max-lines", type=int, default=50, help="Max lines to retain")
330
+ rd_parser.add_argument("--timeout-sec", type=float, default=60.0, help="Timeout in seconds")
331
+
332
+ args = parser.parse_args()
333
+ aci = SweQaAci()
334
+
335
+ if args.subcommand == "view-window":
336
+ res = aci.view_window(args.file, start_line=args.start_line, window_size=args.window_size)
337
+ if args.json:
338
+ print(json.dumps(res, indent=2))
339
+ else:
340
+ if res["status"] == "PASS":
341
+ print(f"--- Viewing {res['file']} (Lines {res['start_line']} - {res['end_line']} of {res['total_lines']}) ---")
342
+ print(res["content"])
343
+ else:
344
+ print(f"[ERROR] {res.get('error')}")
345
+ sys.exit(1)
346
+
347
+ elif args.subcommand == "surgical-edit":
348
+ res = aci.surgical_edit(
349
+ file_path=args.file,
350
+ target_chunk=args.target_chunk,
351
+ replacement_chunk=args.replacement_chunk,
352
+ validate_syntax=args.validate_syntax,
353
+ enforce_clean_pom=args.enforce_clean_pom
354
+ )
355
+ print(json.dumps(res, indent=2))
356
+ sys.exit(0 if res["status"] == "PASS" else 1)
357
+
358
+ elif args.subcommand == "run-distilled":
359
+ res = aci.run_distilled(command=args.command, max_lines=args.max_lines, timeout_sec=args.timeout_sec)
360
+ print(json.dumps(res, indent=2))
361
+ sys.exit(0 if res["status"] == "PASS" else 1)
362
+
363
+ else:
364
+ parser.print_help()
365
+ sys.exit(1)
366
+
367
+
368
+ if __name__ == "__main__":
369
+ main()