@yadsh/dsh-qa-integrations 0.5.0 → 0.7.0

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 (206) hide show
  1. package/README.md +636 -202
  2. package/compatibility.json +1 -1
  3. package/lib/broker.js +468 -9
  4. package/lib/broker.js.map +1 -1
  5. package/lib/client/bitrix24.js +67 -5
  6. package/lib/client/bitrix24.js.map +1 -1
  7. package/lib/client/card.js +8 -1
  8. package/lib/client/card.js.map +1 -1
  9. package/lib/client/confluence.js +98 -129
  10. package/lib/client/confluence.js.map +1 -1
  11. package/lib/client/gitlab.js +41 -5
  12. package/lib/client/gitlab.js.map +1 -1
  13. package/lib/client/index.js +33 -11
  14. package/lib/client/index.js.map +1 -1
  15. package/lib/client/integrations.js +40 -3
  16. package/lib/client/integrations.js.map +1 -1
  17. package/lib/client/jira.js +96 -127
  18. package/lib/client/jira.js.map +1 -1
  19. package/lib/client/operator-card.js +537 -0
  20. package/lib/client/operator-card.js.map +1 -0
  21. package/lib/client/operator-controls.js +232 -0
  22. package/lib/client/operator-controls.js.map +1 -0
  23. package/lib/client/provider-card.js +138 -4
  24. package/lib/client/provider-card.js.map +1 -1
  25. package/lib/client/styles.js +68 -5
  26. package/lib/client/styles.js.map +1 -1
  27. package/lib/client/teamcity.js +31 -4
  28. package/lib/client/teamcity.js.map +1 -1
  29. package/lib/client/testit.js +101 -0
  30. package/lib/client/testit.js.map +1 -0
  31. package/lib/client/weblate.js +105 -0
  32. package/lib/client/weblate.js.map +1 -0
  33. package/lib/client.js +5214 -1054
  34. package/lib/client.js.map +1 -1
  35. package/lib/coerce.js +16 -7
  36. package/lib/coerce.js.map +1 -1
  37. package/lib/config.js +12 -0
  38. package/lib/config.js.map +1 -1
  39. package/lib/errors.js.map +1 -1
  40. package/lib/index.js +444 -57
  41. package/lib/index.js.map +1 -1
  42. package/lib/providers/bitrix24/catalog.js +151 -8
  43. package/lib/providers/bitrix24/catalog.js.map +1 -1
  44. package/lib/providers/bitrix24/config.js +87 -13
  45. package/lib/providers/bitrix24/config.js.map +1 -1
  46. package/lib/providers/bitrix24/credential-help.js +24 -0
  47. package/lib/providers/bitrix24/credential-help.js.map +1 -0
  48. package/lib/providers/bitrix24/index.js +122 -0
  49. package/lib/providers/bitrix24/index.js.map +1 -1
  50. package/lib/providers/bitrix24/operations.js +60 -1
  51. package/lib/providers/bitrix24/operations.js.map +1 -1
  52. package/lib/providers/bitrix24/tools.js +95 -3
  53. package/lib/providers/bitrix24/tools.js.map +1 -1
  54. package/lib/providers/confluence/catalog.js +51 -3
  55. package/lib/providers/confluence/catalog.js.map +1 -1
  56. package/lib/providers/confluence/credential-help.js +29 -0
  57. package/lib/providers/confluence/credential-help.js.map +1 -0
  58. package/lib/providers/confluence/index.js +302 -35
  59. package/lib/providers/confluence/index.js.map +1 -1
  60. package/lib/providers/confluence/operations.js +1 -1
  61. package/lib/providers/confluence/operations.js.map +1 -1
  62. package/lib/providers/gitlab/catalog.js +108 -15
  63. package/lib/providers/gitlab/catalog.js.map +1 -1
  64. package/lib/providers/gitlab/config.js +11 -3
  65. package/lib/providers/gitlab/config.js.map +1 -1
  66. package/lib/providers/gitlab/credential-help.js +33 -0
  67. package/lib/providers/gitlab/credential-help.js.map +1 -0
  68. package/lib/providers/gitlab/index.js +337 -6
  69. package/lib/providers/gitlab/index.js.map +1 -1
  70. package/lib/providers/jira/catalog.js +73 -3
  71. package/lib/providers/jira/catalog.js.map +1 -1
  72. package/lib/providers/jira/credential-help.js +31 -0
  73. package/lib/providers/jira/credential-help.js.map +1 -0
  74. package/lib/providers/jira/index.js +275 -12
  75. package/lib/providers/jira/index.js.map +1 -1
  76. package/lib/providers/registry.js +4 -0
  77. package/lib/providers/registry.js.map +1 -1
  78. package/lib/providers/shared/credential-help.js +29 -0
  79. package/lib/providers/shared/credential-help.js.map +1 -0
  80. package/lib/providers/shared/service-boundary.js +44 -0
  81. package/lib/providers/shared/service-boundary.js.map +1 -0
  82. package/lib/providers/teamcity/catalog.js +56 -2
  83. package/lib/providers/teamcity/catalog.js.map +1 -1
  84. package/lib/providers/teamcity/credential-help.js +25 -0
  85. package/lib/providers/teamcity/credential-help.js.map +1 -0
  86. package/lib/providers/teamcity/index.js +254 -2
  87. package/lib/providers/teamcity/index.js.map +1 -1
  88. package/lib/providers/testit/attachments.js +131 -0
  89. package/lib/providers/testit/attachments.js.map +1 -0
  90. package/lib/providers/testit/catalog.js +302 -0
  91. package/lib/providers/testit/catalog.js.map +1 -0
  92. package/lib/providers/testit/config.js +175 -0
  93. package/lib/providers/testit/config.js.map +1 -0
  94. package/lib/providers/testit/credential-help.js +29 -0
  95. package/lib/providers/testit/credential-help.js.map +1 -0
  96. package/lib/providers/testit/index.js +458 -0
  97. package/lib/providers/testit/index.js.map +1 -0
  98. package/lib/providers/testit/operations.js +1070 -0
  99. package/lib/providers/testit/operations.js.map +1 -0
  100. package/lib/providers/testit/tools.js +717 -0
  101. package/lib/providers/testit/tools.js.map +1 -0
  102. package/lib/providers/testit/transport.js +158 -0
  103. package/lib/providers/testit/transport.js.map +1 -0
  104. package/lib/providers/weblate/catalog.js +279 -0
  105. package/lib/providers/weblate/catalog.js.map +1 -0
  106. package/lib/providers/weblate/config.js +147 -0
  107. package/lib/providers/weblate/config.js.map +1 -0
  108. package/lib/providers/weblate/credential-help.js +26 -0
  109. package/lib/providers/weblate/credential-help.js.map +1 -0
  110. package/lib/providers/weblate/index.js +419 -0
  111. package/lib/providers/weblate/index.js.map +1 -0
  112. package/lib/providers/weblate/operations.js +703 -0
  113. package/lib/providers/weblate/operations.js.map +1 -0
  114. package/lib/providers/weblate/query.js +80 -0
  115. package/lib/providers/weblate/query.js.map +1 -0
  116. package/lib/providers/weblate/tools.js +408 -0
  117. package/lib/providers/weblate/tools.js.map +1 -0
  118. package/lib/providers/weblate/transport.js +179 -0
  119. package/lib/providers/weblate/transport.js.map +1 -0
  120. package/lib/repository.js +197 -13
  121. package/lib/repository.js.map +1 -1
  122. package/lib/service-credentials/config.js +179 -0
  123. package/lib/service-credentials/config.js.map +1 -0
  124. package/lib/service-credentials/policy.js +92 -0
  125. package/lib/service-credentials/policy.js.map +1 -0
  126. package/lib/service-credentials/registry.js +142 -0
  127. package/lib/service-credentials/registry.js.map +1 -0
  128. package/lib/service-credentials/state.js +30 -0
  129. package/lib/service-credentials/state.js.map +1 -0
  130. package/lib/service-credentials/types.js +20 -0
  131. package/lib/service-credentials/types.js.map +1 -0
  132. package/lib/shared/settings.js +8 -13
  133. package/lib/shared/settings.js.map +1 -1
  134. package/lib/tools.js +27 -2
  135. package/lib/tools.js.map +1 -1
  136. package/lib/typert.host.js +1340 -100
  137. package/lib/typert.remote-client.d.ts +45 -11
  138. package/lib/typert.remote-client.js +1101 -38
  139. package/lib/types/broker.d.ts +79 -5
  140. package/lib/types/client/bitrix24.d.ts +24 -2
  141. package/lib/types/client/card.d.ts +3 -1
  142. package/lib/types/client/confluence.d.ts +19 -3
  143. package/lib/types/client/gitlab.d.ts +15 -2
  144. package/lib/types/client/index.d.ts +7 -5
  145. package/lib/types/client/integrations.d.ts +12 -3
  146. package/lib/types/client/jira.d.ts +20 -3
  147. package/lib/types/client/operator-card.d.ts +22 -0
  148. package/lib/types/client/operator-controls.d.ts +135 -0
  149. package/lib/types/client/provider-card.d.ts +50 -8
  150. package/lib/types/client/styles.d.ts +4 -3
  151. package/lib/types/client/teamcity.d.ts +15 -2
  152. package/lib/types/client/testit.d.ts +28 -0
  153. package/lib/types/client/weblate.d.ts +28 -0
  154. package/lib/types/coerce.d.ts +2 -2
  155. package/lib/types/config.d.ts +21 -0
  156. package/lib/types/errors.d.ts +9 -1
  157. package/lib/types/index.d.ts +183 -18
  158. package/lib/types/providers/bitrix24/catalog.d.ts +9 -1
  159. package/lib/types/providers/bitrix24/config.d.ts +23 -22
  160. package/lib/types/providers/bitrix24/credential-help.d.ts +8 -0
  161. package/lib/types/providers/bitrix24/index.d.ts +41 -1
  162. package/lib/types/providers/bitrix24/tools.d.ts +4 -0
  163. package/lib/types/providers/confluence/catalog.d.ts +11 -3
  164. package/lib/types/providers/confluence/credential-help.d.ts +9 -0
  165. package/lib/types/providers/confluence/index.d.ts +66 -7
  166. package/lib/types/providers/confluence/operations.d.ts +2 -0
  167. package/lib/types/providers/contract.d.ts +62 -1
  168. package/lib/types/providers/gitlab/catalog.d.ts +20 -5
  169. package/lib/types/providers/gitlab/config.d.ts +14 -3
  170. package/lib/types/providers/gitlab/credential-help.d.ts +9 -0
  171. package/lib/types/providers/gitlab/index.d.ts +51 -1
  172. package/lib/types/providers/jira/catalog.d.ts +13 -0
  173. package/lib/types/providers/jira/credential-help.d.ts +8 -0
  174. package/lib/types/providers/jira/index.d.ts +53 -1
  175. package/lib/types/providers/registry.d.ts +2 -0
  176. package/lib/types/providers/shared/credential-help.d.ts +17 -0
  177. package/lib/types/providers/shared/service-boundary.d.ts +25 -0
  178. package/lib/types/providers/teamcity/catalog.d.ts +18 -2
  179. package/lib/types/providers/teamcity/credential-help.d.ts +8 -0
  180. package/lib/types/providers/teamcity/index.d.ts +53 -2
  181. package/lib/types/providers/testit/attachments.d.ts +20 -0
  182. package/lib/types/providers/testit/catalog.d.ts +87 -0
  183. package/lib/types/providers/testit/config.d.ts +61 -0
  184. package/lib/types/providers/testit/credential-help.d.ts +8 -0
  185. package/lib/types/providers/testit/index.d.ts +119 -0
  186. package/lib/types/providers/testit/operations.d.ts +95 -0
  187. package/lib/types/providers/testit/tools.d.ts +15 -0
  188. package/lib/types/providers/testit/transport.d.ts +67 -0
  189. package/lib/types/providers/weblate/catalog.d.ts +60 -0
  190. package/lib/types/providers/weblate/config.d.ts +57 -0
  191. package/lib/types/providers/weblate/credential-help.d.ts +9 -0
  192. package/lib/types/providers/weblate/index.d.ts +92 -0
  193. package/lib/types/providers/weblate/operations.d.ts +77 -0
  194. package/lib/types/providers/weblate/query.d.ts +37 -0
  195. package/lib/types/providers/weblate/tools.d.ts +15 -0
  196. package/lib/types/providers/weblate/transport.d.ts +60 -0
  197. package/lib/types/repository.d.ts +38 -3
  198. package/lib/types/service-credentials/config.d.ts +73 -0
  199. package/lib/types/service-credentials/policy.d.ts +44 -0
  200. package/lib/types/service-credentials/registry.d.ts +43 -0
  201. package/lib/types/service-credentials/state.d.ts +14 -0
  202. package/lib/types/service-credentials/types.d.ts +97 -0
  203. package/lib/types/shared/settings.d.ts +8 -13
  204. package/lib/types/tools.d.ts +10 -1
  205. package/lib/types/types.d.ts +114 -10
  206. package/package.json +7 -7
package/README.md CHANGED
@@ -1,103 +1,119 @@
1
1
  # dsh-qa-integrations
2
2
 
3
- Персональные интеграции для `@yadsh/dsh-qa-surface`. Плагин подключает Bitrix24 через URL входящего вебхука, GitLab через personal access token, TeamCity через access token, а Jira и Confluence — через API-токен Atlassian, после чего даёт агенту набор read-only инструментов, ограниченный и правами подключения, и персональной политикой пользователя.
3
+ Персональные интеграции для `@yadsh/dsh-qa-surface`. Плагин подключает Bitrix24 через URL входящего вебхука, GitLab через personal access token, TeamCity через access token, Jira и Confluence — через API-токен Atlassian, Test IT — через API-токен системы управления тестированием, а Weblate — через API-токен платформы локализации, после чего даёт агенту набор read-only инструментов, ограниченный и правами подключения, и персональной политикой пользователя; единственное исключение — комментарий в таймлайн Bitrix24, который монтируется только явным флагом оператора. У всех семи интеграций подключение может работать не только от личного токена, но и от сервисного токена развёртывания — общего read-only аккаунта с жёстким потолком режима (раздел «Сервисные токены»).
4
4
 
5
- Плагин показывает подключения двумя монтированиями одного и того же набора карточек: отдельным разделом **«Интеграции»** в пользовательских настройках QA и карточкой плагина в разделе **«Настройки → Плагины → Конфигурация плагинов»** хоста — там же, где настройки остальных внешних плагинов. Карточка хоста читает аккаунт через клиентский сервис `qaUserSession` плагина `@yadsh/dsh-qa-surface`: без входа в QA она ничего не показывает и не делает запросов, пока её не раскрыли. Токен вводится один раз, шифруется на Host и никогда не возвращается браузеру. Выбор пользователя, integration id, secret id или токена отсутствует в model-visible схемах: principal берётся из DSH-сессии, а Bitrix user id — из сохранённой записи интеграции.
5
+ Плагин показывает подключения двумя монтированиями одного и того же набора карточек: отдельным разделом **«Интеграции»** в пользовательских настройках QA и отдельной вкладкой **«Настройки → Плагины → Интеграции»** оригинального DSH. Вкладка регистрируется напрямую как `settings.plugins.tab`, поэтому доступна и в LAN-браузере, где loopback-only каталог Host settings намеренно отключён. Она читает аккаунт через клиентский сервис `qaUserSession` плагина `@yadsh/dsh-qa-surface`: без входа в QA ничего не показывает и не делает запросов, пока карточку не раскрыли. Токен вводится один раз, шифруется на Host и никогда не возвращается браузеру. Выбор пользователя, integration id, secret id или токена отсутствует в model-visible схемах: principal берётся из DSH-сессии, а Bitrix user id — из сохранённой записи интеграции.
6
+
7
+ ## Операторская карточка настроек
8
+
9
+ Кроме двух пользовательских монтирований, плагин ставит свою конфигурацию как настоящий settings namespace (`qa-integrations`) и рисует по нему операторскую карточку в **«Настройки → Плагины → Конфигурация плагинов»** — по тому же контракту `settings.plugin.item`, что и карточки первых плагинов. Это третья поверхность того же бандла, и она не требует ни входа в QA, ни Remote-описания развёртывания: оператор включается и настраивает плагин из этой карточки, даже когда плагин ещё выключен.
10
+
11
+ Карточка читается сверху вниз: у каждой секции в свёрнутом виде строка состояния (включён ли провайдер, сколько подключений настроено, сколько возможностей открыто), а внутри — четыре подписанных блока: «Провайдер» (выключатели провайдера), «Подключение» (инстансы, сайты, адреса и сетевые политики во всю ширину), «Что доступно агенту» (чек-лист возможностей, флажок перед подписью) и свёрнутые «Ограничения и повторы» (потолки, таймауты, повторы при ошибках). Подпись поля связана с самим полем: клик по названию ставит курсор в него.
12
+
13
+ Карточка покрывает всю разрешённую резолверами конфигурацию: общие ручки (`enabled`, таймаут, потолки ответа и аудита, пути хранилища и мастер-ключа, суффиксы порталов Bitrix24), у каждого провайдера — выключатель, возможности, инстансы/сайты (строки id/название/адрес) и лимиты, у TeamCity — адрес сервера и сетевую политику, у Jira — псевдонимы полей, плюс сервисные доступы (профили с ресурсными границами и deny-политикой) и замены встроенных подсказок получения токена (`credentialHelp`). Каждое поле помечает, что пользовательский слой namespace переопределяет композиционную строку профиля, одна кнопка очищает слой целиком, а отклонённое резолверами значение показывается ошибкой на карточке, а не сохраняется.
14
+
15
+ Правка применяется к запущенному сервису сразу: брокер перепривязывается к свежему набору провайдеров, монтирование инструментов следует за выключателем плагина и единственным флагом записи. Хранилище подключений и мастер-ключ — сознательное исключение: подключения и зашифрованные секреты живут по путям загрузки, поэтому их правка предупреждает в логе и вступает в силу при следующем рестарте Host. Без settings-провайдера плагин ведёт себя как раньше и грузится от композиционной строки.
6
16
 
7
17
  ## Структура
8
18
 
9
- Один каталог — одна интеграция. Всё, что знает про Bitrix24, GitLab, TeamCity, Jira и Confluence, лежит в своём каталоге `src/providers/<id>/`: каталог возможностей и операций, построение запросов, HTTP-граница, срез конфига и тулы. У TeamCity отдельно лежат locator-синтаксис, обработка логов, политика артефактов и сеть; у Jira — JQL и ADF; у Confluence — CQL и ADF. Общий слой — брокер, репозиторий, секреты, обвязка тулов — не знает ни одной интеграции по имени: capability это свободная строка, а `providers/contract.ts` описывает, что должен уметь провайдер. Порядок добавления следующей интеграции и правила гейта пакета — в [src/providers/README.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/src/providers/README.md).
19
+ Один каталог — одна интеграция. Всё, что знает про Bitrix24, GitLab, TeamCity, Jira, Confluence, Test IT и Weblate, лежит в своём каталоге `src/providers/<id>/`: каталог возможностей и операций, построение запросов, HTTP-граница, срез конфига и тулы. У TeamCity отдельно лежат locator-синтаксис, обработка логов, политика артефактов и сеть; у Jira — JQL и ADF; у Confluence — CQL и ADF; у Test IT — политика видов вложений и бюджет их чтения; у Weblate — сборка поискового синтаксиса `q`. Общий слой — брокер, репозиторий, секреты, реестр сервисных токенов (`src/service-credentials/`), обвязка тулов — не знает ни одной интеграции по имени: capability это свободная строка, а `providers/contract.ts` описывает, что должен уметь провайдер. Порядок добавления следующей интеграции и правила гейта пакета — в [src/providers/README.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/src/providers/README.md).
10
20
 
11
21
  ## Инструменты
12
22
 
13
23
  CRM:
14
24
 
15
- | Tool | Что делает |
16
- | --- | --- |
17
- | `bitrix_search_crm` | Поиск лидов, сделок, контактов, компаний, счетов и смарт-процессов по названию и ответственному |
18
- | `bitrix_get_crm_item` | Полная карточка элемента CRM, включая пользовательские поля и коммуникации |
19
- | `bitrix_get_crm_fields` | Схема полей типа сущности, включая `UF_CRM_*` портала |
20
- | `bitrix_get_crm_funnels` | Воронки (категории) типа сущности |
21
- | `bitrix_get_crm_statuses` | Расшифровка стадий и справочников (`STATUS`, `DEAL_STAGE`, `DEAL_STAGE_<id>`, `SOURCE`, …) |
22
- | `bitrix_get_crm_activities` | Дела CRM: звонки, встречи, письма, задачи; просрочки и незавершённые |
23
- | `bitrix_get_crm_activity` | Одно дело целиком, включая описание |
24
- | `bitrix_get_crm_timeline` | Комментарии таймлайна лида, сделки, контакта, компании |
25
- | `bitrix_get_crm_stage_history` | История движения по стадиям: сколько висело, куда возвращали |
26
- | `bitrix_get_crm_product_rows` | Товарные позиции: что продаём, количество, цена, скидки |
27
- | `bitrix_find_crm_duplicates` | Поиск дублей клиента по телефону или e-mail |
28
- | `bitrix_get_crm_requisites` | Реквизиты контакта или компании: ИНН, КПП, адрес, банк |
29
- | `bitrix_get_call_transcript` | Готовая AI-расшифровка звонка по делу CRM |
25
+ | Tool | Что делает |
26
+ | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
27
+ | `bitrix_search_crm` | Поиск лидов, сделок, контактов, компаний, счетов и смарт-процессов: по названию, стадии, воронке, свежести, открытости (только сделки), ответственный; порядок сортировки зафиксирован, чтобы страницы не дублировались |
28
+ | `bitrix_get_crm_item` | Полная карточка элемента CRM, включая пользовательские поля и коммуникации |
29
+ | `bitrix_get_crm_fields` | Схема полей типа сущности, включая `UF_CRM_*` портала |
30
+ | `bitrix_get_crm_funnels` | Воронки (категории) типа сущности |
31
+ | `bitrix_get_crm_statuses` | Расшифровка стадий и справочников (`STATUS`, `DEAL_STAGE`, `DEAL_STAGE_<id>`, `SOURCE`, …) |
32
+ | `bitrix_get_crm_activities` | Дела CRM: звонки, встречи, письма, задачи; просрочки и незавершённые |
33
+ | `bitrix_get_crm_activity` | Одно дело целиком, включая описание |
34
+ | `bitrix_get_crm_timeline` | Комментарии таймлайна лида, сделки, контакта, компании |
35
+ | `bitrix_get_crm_stage_history` | История движения по стадиям: сколько висело, куда возвращали |
36
+ | `bitrix_get_crm_product_rows` | Товарные позиции: что продаём, количество, цена, скидки |
37
+ | `bitrix_find_crm_duplicates` | Поиск дублей клиента по телефону или e-mail |
38
+ | `bitrix_get_crm_requisites` | Реквизиты контакта или компании: ИНН, КПП, адрес, банк |
39
+ | `bitrix_get_call_transcript` | Готовая AI-расшифровка звонка по делу CRM |
30
40
 
31
41
  Сотрудники и структура:
32
42
 
33
- | Tool | Что делает |
34
- | --- | --- |
35
- | `bitrix_get_current_user` | Чей вебхук подключён |
36
- | `bitrix_search_users` | Поиск сотрудников по имени, e-mail, подразделению |
37
- | `bitrix_get_departments` | Подразделения, родительский отдел, руководитель |
38
- | `bitrix_get_user_fields` | Какие поля сотрудника доступны с этим вебхуком |
43
+ | Tool | Что делает |
44
+ | ------------------------- | ------------------------------------------------- |
45
+ | `bitrix_get_current_user` | Чей вебхук подключён |
46
+ | `bitrix_search_users` | Поиск сотрудников по имени, e-mail, подразделению |
47
+ | `bitrix_get_departments` | Подразделения, родительский отдел, руководитель |
48
+ | `bitrix_get_user_fields` | Какие поля сотрудника доступны с этим вебхуком |
39
49
 
40
50
  Чаты и открытые линии:
41
51
 
42
- | Tool | Что делает |
43
- | --- | --- |
44
- | `bitrix_search_chats` | Поиск чатов по названию и участникам |
45
- | `bitrix_get_chat_messages` | Последние сообщения чата |
46
- | `bitrix_search_chat_messages` | Поиск по тексту и датам внутри одного чата |
47
- | `bitrix_get_recent_chats` | Последние диалоги пользователя, счётчики непрочитанного |
48
- | `bitrix_search_chat_users` | Поиск сотрудника как контакта чата: статус, телефоны |
49
- | `bitrix_find_chat` | Чат, привязанный к объекту: обсуждение сделки, чат задачи, событие календаря, чат группы |
50
- | `bitrix_get_chat_participants` | Кто участвует в чате |
51
- | `bitrix_get_chat_user_data` | Профили участников: имя, должность, телефоны, присутствие |
52
- | `bitrix_get_openline_dialog` | Диалог открытой линии: участники, связь с CRM |
53
- | `bitrix_get_openline_history` | История переписки с клиентом в открытой линии |
52
+ | Tool | Что делает |
53
+ | ------------------------------ | ---------------------------------------------------------------------------------------- |
54
+ | `bitrix_search_chats` | Поиск чатов по названию и участникам |
55
+ | `bitrix_get_chat_messages` | Последние сообщения чата |
56
+ | `bitrix_search_chat_messages` | Поиск по тексту и датам внутри одного чата |
57
+ | `bitrix_get_recent_chats` | Последние диалоги пользователя, счётчики непрочитанного |
58
+ | `bitrix_search_chat_users` | Поиск сотрудника как контакта чата: статус, телефоны |
59
+ | `bitrix_find_chat` | Чат, привязанный к объекту: обсуждение сделки, чат задачи, событие календаря, чат группы |
60
+ | `bitrix_get_chat_participants` | Кто участвует в чате |
61
+ | `bitrix_get_chat_user_data` | Профили участников: имя, должность, телефоны, присутствие |
62
+ | `bitrix_get_openline_dialog` | Диалог открытой линии: участники, связь с CRM |
63
+ | `bitrix_get_openline_history` | История переписки с клиентом в открытой линии |
54
64
 
55
65
  Задачи, календарь, Диск:
56
66
 
57
- | Tool | Что делает |
58
- | --- | --- |
59
- | `bitrix_search_tasks` | Задачи по названию, ответственному, группе, дедлайну |
60
- | `bitrix_get_task` | Карточка задачи целиком, включая `ufCrmTask` |
61
- | `bitrix_get_task_history` | История изменений задачи: что, когда и кем |
62
- | `bitrix_get_task_results` | Результаты работы по задаче |
63
- | `bitrix_get_task_elapsed_time` | Затраченное время: кто сколько залогировал |
64
- | `bitrix_get_calendar_events` | События календаря сотрудника, группы или компании |
67
+ | Tool | Что делает |
68
+ | ----------------------------------- | ----------------------------------------------------- |
69
+ | `bitrix_search_tasks` | Задачи по названию, ответственному, группе, дедлайну |
70
+ | `bitrix_get_task` | Карточка задачи целиком, включая `ufCrmTask` |
71
+ | `bitrix_get_task_history` | История изменений задачи: что, когда и кем |
72
+ | `bitrix_get_task_results` | Результаты работы по задаче |
73
+ | `bitrix_get_task_elapsed_time` | Затраченное время: кто сколько залогировал |
74
+ | `bitrix_get_calendar_events` | События календаря сотрудника, группы или компании |
65
75
  | `bitrix_get_calendar_accessibility` | Занятость сотрудников, чтобы предложить время встречи |
66
- | `bitrix_search_files` | Поиск по Диску, включая текст внутри документов |
67
- | `bitrix_get_file` | Метаданные и ссылка на файл Диска |
68
- | `bitrix_get_drives` | Доступные диски и их id |
69
- | `bitrix_get_storage_items` | Содержимое корня диска |
70
- | `bitrix_get_folder_items` | Содержимое папки Диска |
76
+ | `bitrix_search_files` | Поиск по Диску, включая текст внутри документов |
77
+ | `bitrix_get_file` | Метаданные и ссылка на файл Диска |
78
+ | `bitrix_get_drives` | Доступные диски и их id |
79
+ | `bitrix_get_storage_items` | Содержимое корня диска |
80
+ | `bitrix_get_folder_items` | Содержимое папки Диска |
81
+
82
+ Запись (по умолчанию выключена оператором `bitrix24.crmCommentWrite`):
83
+
84
+ | Tool | Что делает |
85
+ | --------------------------------- | ------------------------------------------------------------------------------------------------------------- |
86
+ | `bitrix_add_crm_timeline_comment` | Один комментарий в таймлайн лида, сделки, контакта или компании; единственная операция записи во всём плагине |
71
87
 
72
88
  Списочные инструменты отвечают единым конвертом `{ items, pagination }`: у модели одна форма ответа вместо шести разных у REST, а курсор следующей страницы не теряется. Методы, возвращающие словари по id (история открытой линии, занятость), спроецированы в упорядоченные массивы.
73
89
 
74
90
  ## Инструменты GitLab
75
91
 
76
- | Tool | Что делает |
77
- | --- | --- |
78
- | `gitlab_connection_get` | К какому инстансу и каким пользователем подключён аккаунт |
79
- | `gitlab_projects_list` | Поиск проектов: путь, ветка по умолчанию, видимость |
80
- | `gitlab_project_get` | Карточка проекта: описание, namespace, даты |
81
- | `gitlab_repository_tree` | Содержимое каталогов на выбранном ref, постранично |
82
- | `gitlab_repository_file_get` | Текст файла с метаданными; бинарное и слишком большое — только метаданные |
83
- | `gitlab_commits_list` | Коммиты проекта, ветки или одного файла |
84
- | `gitlab_commit_get` | Один коммит: сообщение, автор, родители, объём изменений |
85
- | `gitlab_compare` | Сравнение двух refs: коммиты и изменённые файлы |
86
- | `gitlab_search` | Поиск по проектам, задачам, MR, коммитам, коду и комментариям |
87
- | `gitlab_issues_list` | Задачи по проекту, состоянию, автору, исполнителю, меткам, датам |
88
- | `gitlab_issue_get` | Карточка задачи: описание, веха, срок |
89
- | `gitlab_issue_notes_list` | Комментарии задачи, системные помечены |
90
- | `gitlab_merge_requests_list` | Merge requests по проекту, веткам, автору, ревьюеру, черновику |
91
- | `gitlab_merge_request_get` | Карточка MR: описание, ветки, статус слияния, конфликты |
92
- | `gitlab_merge_request_changes_get` | Изменённые файлы MR с диффами |
93
- | `gitlab_merge_request_discussions_list` | Обсуждения ревью и их разрешение |
94
- | `gitlab_merge_request_approvals_get` | Сколько одобрений нужно, сколько есть, кто одобрил |
95
- | `gitlab_merge_request_pipelines_list` | Пайплайны, привязанные к MR |
96
- | `gitlab_pipelines_list` | Пайплайны проекта по ветке, статусу, источнику, автору |
97
- | `gitlab_pipeline_get` | Один пайплайн: статус, длительности, покрытие |
98
- | `gitlab_pipeline_jobs_list` | Джобы пайплайна: стадия, статус, длительность |
99
- | `gitlab_job_get` | Одна джоба: причина падения, теги, список артефактов |
100
- | `gitlab_job_log_get` | Лог джобы: ограничен по размеру и очищен от токенов |
92
+ | Tool | Что делает |
93
+ | --------------------------------------- | ------------------------------------------------------------------------- |
94
+ | `gitlab_connection_get` | К какому инстансу и каким пользователем подключён аккаунт |
95
+ | `gitlab_projects_list` | Поиск проектов: путь, ветка по умолчанию, видимость |
96
+ | `gitlab_project_get` | Карточка проекта: описание, namespace, даты |
97
+ | `gitlab_repository_tree` | Содержимое каталогов на выбранном ref, постранично |
98
+ | `gitlab_repository_file_get` | Текст файла с метаданными; бинарное и слишком большое — только метаданные |
99
+ | `gitlab_commits_list` | Коммиты проекта, ветки или одного файла |
100
+ | `gitlab_commit_get` | Один коммит: сообщение, автор, родители, объём изменений |
101
+ | `gitlab_compare` | Сравнение двух refs: коммиты и изменённые файлы |
102
+ | `gitlab_search` | Поиск по проектам, задачам, MR, коммитам, коду и комментариям |
103
+ | `gitlab_issues_list` | Задачи по проекту, состоянию, автору, исполнителю, меткам, датам |
104
+ | `gitlab_issue_get` | Карточка задачи: описание, веха, срок |
105
+ | `gitlab_issue_notes_list` | Комментарии задачи, системные помечены |
106
+ | `gitlab_merge_requests_list` | Merge requests по проекту, веткам, автору, ревьюеру, черновику |
107
+ | `gitlab_merge_request_get` | Карточка MR: описание, ветки, статус слияния, конфликты |
108
+ | `gitlab_merge_request_changes_get` | Изменённые файлы MR с диффами |
109
+ | `gitlab_merge_request_discussions_list` | Обсуждения ревью и их разрешение |
110
+ | `gitlab_merge_request_approvals_get` | Сколько одобрений нужно, сколько есть, кто одобрил |
111
+ | `gitlab_merge_request_pipelines_list` | Пайплайны, привязанные к MR |
112
+ | `gitlab_pipelines_list` | Пайплайны проекта по ветке, статусу, источнику, автору |
113
+ | `gitlab_pipeline_get` | Один пайплайн: статус, длительности, покрытие |
114
+ | `gitlab_pipeline_jobs_list` | Джобы пайплайна: стадия, статус, длительность |
115
+ | `gitlab_job_get` | Одна джоба: причина падения, теги, список артефактов |
116
+ | `gitlab_job_log_get` | Лог джобы: ограничен по размеру и очищен от токенов |
101
117
 
102
118
  Списочные инструменты GitLab отвечают тем же конвертом `{ items, pagination }`; `pagination.nextPage` — это номер следующей страницы, а не подписанный курсор: состояние между вызовами не хранится, principal и права перепроверяются на каждом вызове.
103
119
 
@@ -105,39 +121,38 @@ CRM:
105
121
 
106
122
  ## Инструменты TeamCity
107
123
 
108
- | Tool | Что делает |
109
- | --- | --- |
124
+ | Tool | Что делает |
125
+ | ------------------------- | --------------------------------------------------------------------------------- |
110
126
  | `teamcity_connection_get` | К какому серверу TeamCity и каким пользователем подключён аккаунт, версия сервера |
111
- | `teamcity_projects` | Проекты: поиск по id и названию, дочерние проекты, архивные |
112
- | `teamcity_build_configs` | Конфигурации сборки: id, название, проект, пауза |
113
- | `teamcity_builds` | Поиск сборок по проекту, конфигурации, ветке, статусу, состоянию и датам |
114
- | `teamcity_build` | Одна сборка: состояние, статус и его текст, агент, кто запустил, времена |
115
- | `teamcity_build_changes` | Изменения в VCS, попавшие в сборку: ревизия, автор, дата, комментарий |
116
- | `teamcity_build_failures` | Почему упало: упавшие тесты и проблемы сборки одним ответом |
117
- | `teamcity_build_log` | Фрагмент лога сборки: конец, начало или строки по поиску |
118
- | `teamcity_queue` | Очередь сборки: что ждёт агента и на какой ветке |
119
- | `teamcity_investigations` | Расследования падений: состояние, ответственный, разрешение |
120
- | `teamcity_agents` | Агенты сборки: подключён, включён, авторизован |
121
- | `teamcity_artifacts` | Артефакты сборки: имя, путь, размер, время изменения |
122
- | `teamcity_artifact_text` | Текст небольшого артефакта: отчёты тестов, лог-файлы |
127
+ | `teamcity_projects` | Проекты: поиск по id и названию, дочерние проекты, архивные |
128
+ | `teamcity_build_configs` | Конфигурации сборки: id, название, проект, пауза |
129
+ | `teamcity_builds` | Поиск сборок по проекту, конфигурации, ветке, статусу, состоянию и датам |
130
+ | `teamcity_build` | Одна сборка: состояние, статус и его текст, агент, кто запустил, времена |
131
+ | `teamcity_build_changes` | Изменения в VCS, попавшие в сборку: ревизия, автор, дата, комментарий |
132
+ | `teamcity_build_failures` | Почему упало: упавшие тесты и проблемы сборки одним ответом |
133
+ | `teamcity_build_log` | Фрагмент лога сборки: конец, начало или строки по поиску |
134
+ | `teamcity_queue` | Очередь сборки: что ждёт агента и на какой ветке |
135
+ | `teamcity_investigations` | Расследования падений: состояние, ответственный, разрешение |
136
+ | `teamcity_agents` | Агенты сборки: подключён, включён, авторизован |
137
+ | `teamcity_artifacts` | Артефакты сборки: имя, путь, размер, время изменения |
138
+ | `teamcity_artifact_text` | Текст небольшого артефакта: отчёты тестов, лог-файлы |
123
139
 
124
140
  Списочные инструменты TeamCity отвечают конвертом `{ items, pagination }`, где `pagination.returned` — сколько строк вернулось, а `pagination.hasMore` — что сервер отдал не всё: инструмент никогда не ходит по `nextHref` сам, поэтому продолжение получается сужением фильтра, а не вторым запросом за спиной у модели. Лимит каждого списка задан спецификацией (сборки и очередь — 50, проекты, конфигурации, изменения, тесты, проблемы, расследования и агенты — 100, артефакты — 200) и не поднимается выше, сколько бы модель ни попросила.
125
141
 
126
142
  Лог сборки скачивается не больше, чем разрешает стенд (`maxLogBytes`, по умолчанию 256 КиБ), чистится от управляющих последовательностей терминала, проходит через редакцию секретов и режется до запрошенного числа строк (`maxLines`, максимум 1000). Ответ различает два случая: `truncated` — окно не покрыло запрошенные строки, `logTruncated` — сам лог длиннее скачанного куска, и тогда в режиме `tail` это конец скачанного, а не конец сборки. Артефакты читаются только текстовые: архивы, образы, бинарники, документы и ключи (`zip`, `jar`, `png`, `pdf`, `pem`, …) отказываются по имени до запроса, а бинарное тело отвечает метаданными с `binary: true` вместо содержимого. Логи и артефакты описаны модели как недоверенные данные: это текст из внешней системы, а не инструкция.
127
143
 
128
-
129
144
  ## Инструменты Jira
130
145
 
131
- | Tool | Что делает |
132
- | --- | --- |
133
- | `jira_get_current_user` | К какому сайту Jira и каким пользователем Atlassian подключён аккаунт |
134
- | `jira_search_issues` | Поиск задач: текст, проекты, типы, статусы и их категория, приоритеты, резолюции, компоненты, метки, версии (fix и affected), люди, даты, кастомные поля |
135
- | `jira_get_issue` | Карточка задачи: ключ, ссылка, проект, тип, статус, приоритет, люди, метки, компоненты, версии, резолюция, даты и описание |
136
- | `jira_get_issue_comments` | Комментарии задачи, от новых к старым; ограниченный комментарий помечен видимостью |
137
- | `jira_get_issue_attachments` | Метаданные вложений: имя файла, тип, размер, автор; файлы не скачиваются |
138
- | `jira_get_available_transitions` | Доступные переходы статуса и их обязательные поля; переход не выполняется |
139
- | `jira_get_project` | Карточка проекта: ключ, название, тип, руководитель, описание, ссылка |
140
- | `jira_get_fields` | Поля сайта: id, имя, признак кастомного поля, тип и JQL-имена |
146
+ | Tool | Что делает |
147
+ | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
148
+ | `jira_get_current_user` | К какому сайту Jira и каким пользователем Atlassian подключён аккаунт |
149
+ | `jira_search_issues` | Поиск задач: текст, проекты, типы, статусы и их категория, приоритеты, резолюции, компоненты, метки, версии (fix и affected), люди, даты, кастомные поля |
150
+ | `jira_get_issue` | Карточка задачи: ключ, ссылка, проект, тип, статус, приоритет, люди, метки, компоненты, версии, резолюция, даты и описание |
151
+ | `jira_get_issue_comments` | Комментарии задачи, от новых к старым; ограниченный комментарий помечен видимостью |
152
+ | `jira_get_issue_attachments` | Метаданные вложений: имя файла, тип, размер, автор; файлы не скачиваются |
153
+ | `jira_get_available_transitions` | Доступные переходы статуса и их обязательные поля; переход не выполняется |
154
+ | `jira_get_project` | Карточка проекта: ключ, название, тип, руководитель, описание, ссылка |
155
+ | `jira_get_fields` | Поля сайта: id, имя, признак кастомного поля, тип и JQL-имена |
141
156
 
142
157
  Модель не получает JQL: фильтры в `jira_search_issues` типизированные, а строку запроса собирает и экранирует провайдер — значение с кавычкой или обратным слэшем остаётся значением и не может добавить условие. Поиск без единого фильтра отказывается: «все задачи сайта» — не вопрос, на который этот инструмент отвечает. Ответы идут по последнему обновлению (сначала свежие) и несут `pagination.nextCursor` — это continuation-токен самого Jira, состояние между вызовами не хранится, а страница не выходит за потолок стенда (`defaultSearchLimit`, `maxSearchLimit`) и за 100 строк, которые Jira отдаёт с полями. Комментарии Jira по-прежнему листаются позицией, поэтому их `pagination` — `{ startAt, returned, total, hasMore }`.
143
158
 
@@ -146,18 +161,19 @@ CRM:
146
161
  Кастомные поля фильтруются **по id**, который вернул `jira_get_fields`, или **по алиасу**, который объявил оператор стенда: `customFields: [{ field: "product", value: "…" }]`, с `match: "contains"` для текстовых полей и `empty: true`/`false` для пустого/заполненного. Имя поля Jira не принимается намеренно — на одном сайте легко живут несколько полей с одинаковым именем, а какой из них «продукт», знает только развёртывание: соответствие «алиас → `customfield_…`» задаётся в конфиге оператора (`jira.fieldAliases`), поэтому в репозитории нет ни одного id конкретного инстанса, а каталог полей (`jira_get_fields`) отдаёт объявленные алиасы вместе со схемой. Неизвестное имя — отказ со списком алиасов, а не пустая страница. Люди принимаются как `me`, как accountId или как имя: имя провайдер разрешает через справочник сайта (`/rest/api/3/user/search`, не больше десяти совпадений) и подставляет accountId в запрос, потому что Jira Cloud фильтрует именно по нему. Имя, которое никого не нашло, и имя, которое нашли несколько человек, — это отказ с подсказкой, а не пустая страница: «нет задач» и «фильтр не понят» — разные ответы. Ответ справочника модели не показывается, он только определяет id, по которому построен запрос.
147
162
 
148
163
  Описания и комментарии приходят в Atlassian Document Format и рендерятся в текст с сохранением структуры: заголовки, списки, код, ссылки, упоминания, таблицы и вложения-маркеры. Сырой JSON документа модели не отдаётся, а встроенные ссылки и медиа-узлы не загружаются. История изменений задачи читается отдельной группой `include: ["changelog_summary"]` (Jira отдаёт её только через `expand=changelog`): ответ несёт до 20 изменённых полей с автором и значениями «было/стало» и честно различает две обрезки — свою (`truncated`, упёрлись в 20 записей) и джировскую (`groupsTruncated`, Jira посчитала групп изменений больше, чем прислала). Кастомные поля называются по схеме сайта (`jira_get_fields` показывает её модель целиком): схема читается только после того, как задача ответила, и **не кэшируется** — один и тот же сайт отдаёт разный список полей двум пользователям с разными правами, а кэш на двоих был бы утечкой ради одного запроса. Тело задачи, комментария или кастомного поля ограничено `maxTextChars` (по умолчанию 20 000 символов); при обрезке ответ помечается `descriptionTruncated` или `bodyTruncated`. Текст из Jira — данные, а не инструкция.
164
+
149
165
  ## Инструменты Confluence
150
166
 
151
- | Tool | Что делает |
152
- | --- | --- |
153
- | `confluence_connection_get` | К какому сайту Confluence и каким аккаунтом Atlassian подключён пользователь |
154
- | `confluence_search` | Поиск страниц по тексту, пространствам, меткам, автору и дате изменения |
155
- | `confluence_get_page` | Страница целиком: заголовок, пространство, родитель, версия, метки и текст |
156
- | `confluence_get_page_comments` | Комментарии страницы: подвал, inline или оба, с ответами и статусом резолва |
157
- | `confluence_get_page_attachments` | Метаданные вложений: имя, тип, размер, версия, автор, ссылки |
158
- | `confluence_get_page_versions` | История версий: номер, автор, дата и комментарий к версии |
159
- | `confluence_get_space` | Пространство: ключ, имя, тип, статус, описание |
160
- | `confluence_list_spaces` | Пространства, доступные аккаунту, с ключами для поиска и чтения |
167
+ | Tool | Что делает |
168
+ | --------------------------------- | ---------------------------------------------------------------------------- |
169
+ | `confluence_connection_get` | К какому сайту Confluence и каким аккаунтом Atlassian подключён пользователь |
170
+ | `confluence_search` | Поиск страниц по тексту, пространствам, меткам, автору и дате изменения |
171
+ | `confluence_get_page` | Страница целиком: заголовок, пространство, родитель, версия, метки и текст |
172
+ | `confluence_get_page_comments` | Комментарии страницы: подвал, inline или оба, с ответами и статусом резолва |
173
+ | `confluence_get_page_attachments` | Метаданные вложений: имя, тип, размер, версия, автор, ссылки |
174
+ | `confluence_get_page_versions` | История версий: номер, автор, дата и комментарий к версии |
175
+ | `confluence_get_space` | Пространство: ключ, имя, тип, статус, описание |
176
+ | `confluence_list_spaces` | Пространства, доступные аккаунту, с ключами для поиска и чтения |
161
177
 
162
178
  Списочные инструменты Confluence отвечают конвертом `{ items, nextCursor }`: `nextCursor` — это значение, которое нужно вернуть в аргументе `cursor`, а не URL и не подписанный токен. У поиска это смещение строк (эндпоинт считает строки), у остальных чтений — курсор самого Confluence, из которого провайдер берёт только сам токен: путь и параметры следующего запроса он собирает сам, поэтому курсор не может увести запрос на чужой адрес. Комментарии с `kind: "all"` отвечают двумя курсорами (`cursors.footer` и `cursors.inline`), потому что продолжать их придётся по отдельности. `totalSize` у поиска говорит, сколько всего совпадений нашлось, — по нему модель понимает, стоит ли листать дальше.
163
179
 
@@ -165,19 +181,51 @@ CRM:
165
181
 
166
182
  Поиск идёт через CQL, но CQL собирает провайдер: модель передаёт типизированные фильтры (текст, пространства, типы, метки, автор, дата), а `cql.ts` экранирует литералы и подставляет `space in (…)`, `currentUser()` и `ORDER BY`. Инструмента с произвольным CQL в surface нет. Текст страницы и комментариев приходит не сырым payload, а markdown-подобной разметкой в поле `untrustedContent`: `adf.ts` разбирает Atlassian Document Format в заголовки, списки, таблицы, блоки кода, ссылки, упоминания, панели и статусы, а макросы, медиа и встроенные представления заменяет плейсхолдерами (`[Confluence macro: jira]`, `[media: chart]`) — провайдер ничего не отрисовывает и никуда не ходит по ссылкам из страницы. Тело режется бюджетом (`maxChars` в аргументе, потолок — `maxBodyChars` стенда) и при обрезке отвечает `truncated: true` и `totalChars`. Подсветка совпадений в выдержках поиска снимается вместе с разметкой.
167
183
 
184
+ ## Инструменты Weblate
185
+
186
+ | Tool | Что делает |
187
+ | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
188
+ | `weblate_connection_get` | К какому инстансу Weblate и каким аккаунтом подключён токен и личный он или проектный; сам токен не возвращается |
189
+ | `weblate_projects_list` | Проекты, видимые аккаунту, постранично |
190
+ | `weblate_project_get` | Один проект: слаг, имя, ссылка |
191
+ | `weblate_project_statistics_get` | Готовность проекта: строки и слова переведены, требуют правки, не проходят проверки |
192
+ | `weblate_components_list` | Компоненты проекта постранично |
193
+ | `weblate_component_get` | Один компонент: слаг, имя, система контроля версий, ветка, формат файлов, исходный язык |
194
+ | `weblate_component_statistics_get` | Готовность компонента по языкам |
195
+ | `weblate_translations_list` | Языки компонента с их состоянием перевода |
196
+ | `weblate_translation_get` | Один язык одного компонента целиком: переведено, требует правки, проверки, комментарии, предложения, автор последней правки |
197
+ | `weblate_translation_statistics_get` | Статистика одного языка одного компонента |
198
+ | `weblate_units_search` | Строки одного языка одного компонента с типизированными фильтрами |
199
+ | `weblate_units_find` | Строка по всему, что видит аккаунт, с сужением по проекту, компоненту и языку |
200
+ | `weblate_unit_get` | Одна строка целиком: все формы множественного числа исходника и перевода, состояние, контекст, заметка, метки, флаги, проверки |
201
+ | `weblate_unit_comments_list` | Комментарии к строке: автор, время, текст |
202
+ | `weblate_unit_suggestions_list` | Предложенные переводы строки: автор, голоса, время |
203
+ | `weblate_failing_units_list` | Строки, у которых не проходит хотя бы одна проверка, с сужением по проекту, компоненту, языку, тексту и состоянию |
204
+ | `weblate_changes_list` | Последние изменения проекта: какая строка, какой язык, что сделано, кем и когда |
205
+ | `weblate_screenshots_list` | Скриншоты Weblate и строки, к которым они привязаны |
206
+ | `weblate_screenshot_get` | Метаданные одного скриншота: имя, файл в репозитории, язык, id связанных строк |
207
+
208
+ Списочные инструменты Weblate отвечают конвертом `{ items, pagination }`: `pagination.nextPage` — номер следующей страницы, а не подписанный курсор. По ссылке `next` провайдер не ходит сам: Weblate кладёт в тело абсолютный адрес, из которого читается только номер страницы, и только когда он ведёт на настроенный инстанс — ссылка с чужого адреса отбрасывается, а список честно считается законченным. Страница — 20 строк по умолчанию, а `perPage` сверх потолка стенда (`maxPageSize`, по умолчанию 100) обрезается, а не отвергается: «дай больше строк» — это запрос, на который стенд отвечает своим потолком, а не ошибка, которую модель выясняет перебором. Состояние между вызовами не хранится, principal и права перепроверяются на каждом вызове.
209
+
210
+ Модель не получает `q`: фильтры типизированные (`source`, `target`, `context`, `state`, `failingChecks`, `suggestions`, `comments`, а у поиска по всему инстансу ещё `project`, `component` и `language`), а строку запроса собирает `query.ts` — значения всегда в двойных кавычках с экранированием `\` и `"`, поэтому кавычка или обратный слэш внутри запроса остаются значением и не становятся условием. Словарь состояний — собственный словарь Weblate `is:`: `untranslated` (по определению самого Weblate — всё, что ниже translated, то есть вместе со строками, помеченными needs-editing), `needs-editing`, `translated`, `approved`, `read-only`. Поиск без единого фильтра уходит без параметра `q`, а не с пустым. `weblate_failing_units_list` — тот же `/units/`, что и `weblate_units_find`, с жёсткой клаузой `has:check`; Weblate сообщает, что строка не проходит проверку, но не то, какая именно проверка упала, поэтому ответ несёт `hasFailingCheck`, а не список имён проверок.
211
+
212
+ Строки нормализованы: числовые состояния Weblate (0/10/20/30/100) отображаются в `untranslated`/`needs-editing`/`translated`/`approved`/`read-only`, формы множественного числа остаются массивом (перевод, молча короче настоящего, был бы прочитан как правда), текст режется — 200 символов в списке, `maxChars` у отдельной строки, потолок — `maxTextChars` стенда — и помечается `textTruncated`, метки приходят именами, а проект, компонент и язык читаются из вложенной ссылки `translation`, и только когда она ведёт на настроенный инстанс. Каждый ответ с текстом, написанным на стороне Weblate, помечен `untrustedExternalContent: true`: это данные, а не инструкция. Скриншоты — только метаданные (имя, файл в репозитории, язык, id строк, адрес картинки на настроенном инстансе): байты провайдер не скачивает. История изменений у Weblate есть у проекта, компонента и перевода, но не у строки, поэтому инструмент проектный, а строка в каждой записи ищется по её id.
213
+
214
+ `weblate_connection_get` называет инстанс, аккаунт и вид токена: у Weblate нет эндпоинта «кто я», и подключённый аккаунт определяется по `GET /api/users/`, который непривилегированный токен видит одной своей строкой. Токен, который умеет перечислять пользователей, отвечает полным списком — тогда аккаунт честно не определяется (пустой внешний id, в карточке адрес инстанса и вид токена), а не угадывается по первой строке.
215
+
168
216
  ## Возможности и скопы Confluence
169
217
 
170
218
  Подключение — Atlassian API token вместе с почтой аккаунта Atlassian (Basic-пара). Возможность появляется у пользователя, если её включил оператор (`confluence.*Read`).
171
219
 
172
- | Возможность | Что открывает |
173
- | --- | --- |
174
- | `identity.read` | Сайт Confluence и подключённый аккаунт Atlassian |
175
- | `spaces.read` | Список пространств и карточка пространства |
176
- | `search.read` | Поиск страниц по тексту, пространствам, меткам, автору и дате |
177
- | `content.read` | Страница целиком с текстом, метками и версией |
178
- | `comments.read` | Комментарии страницы: подвал, inline и ответы |
179
- | `attachments.read` | Метаданные вложений страницы |
180
- | `versions.read` | История версий страницы |
220
+ | Возможность | Что открывает |
221
+ | ------------------ | ------------------------------------------------------------- |
222
+ | `identity.read` | Сайт Confluence и подключённый аккаунт Atlassian |
223
+ | `spaces.read` | Список пространств и карточка пространства |
224
+ | `search.read` | Поиск страниц по тексту, пространствам, меткам, автору и дате |
225
+ | `content.read` | Страница целиком с текстом, метками и версией |
226
+ | `comments.read` | Комментарии страницы: подвал, inline и ответы |
227
+ | `attachments.read` | Метаданные вложений страницы |
228
+ | `versions.read` | История версий страницы |
181
229
 
182
230
  Confluence, как и TeamCity, не сообщает через API, какие права выданы конкретному токену: у OAuth-приложений для этого есть `/oauth/token/accessible-resources`, а у API token аналога нет. Поэтому сужение идёт только по деплой-флагам оператора, а права аккаунта применяет сам Confluence — отказ приходит как `ProviderPermissionDenied`, и провайдер никогда не пробует другой credential.
183
231
 
@@ -187,39 +235,78 @@ Confluence, как и TeamCity, не сообщает через API, какие
187
235
 
188
236
  Запись в surface отсутствует: создание и правка страниц, комментарии, резолв inline-комментариев, вложения, перемещение и администрирование пространств ждут confirmation-фреймворка. Произвольного REST (`confluence_rest_call`), произвольного CQL и скачивания вложений тоже нет — только метаданные и ссылки, которые отдал сам Confluence.
189
237
 
238
+ ### Сервисный токен Confluence
239
+
240
+ Подключение может работать от сервисного токена развёртывания: профиль называет сайт, секрет — та же Basic-пара `email:token`, а граница ресурсов — `spaces` (ключи пространств). Чувствительных чтений в каталоге нет: поиск, пространства, страницы, комментарии, метаданные вложений и версии остаются сервисно-безопасными, но каталог не умеет отдавать байты вложений, и такая операция, когда появится, обязана прийти с классификацией не ниже чувствительной. Страница, названная по id, сначала раскрывается в своё пространство, поиск сужается до `space in (…)` по границе ещё на входе, а строки, пространство которых по ответу не подтверждается, отбрасываются вторым замком. Граница сервиса и операторский `confluence.allowedSpaces` — два независимых сужения: сервисный вызов живёт в их пересечении.
241
+
242
+ ## Возможности и скопы Weblate
243
+
244
+ Подключение — API-токен Weblate вместе с выбором инстанса: адреса задаёт только оператор (`weblate.instances`), пользователь выбирает инстанс из списка и вставляет токен. Возможность появляется у пользователя, если её включил оператор (`weblate.*Read`).
245
+
246
+ | Возможность | Что открывает |
247
+ | ------------------- | ----------------------------------------------------------------- |
248
+ | `identity.read` | Инстанс Weblate, подключённый аккаунт и вид токена |
249
+ | `projects.read` | Список проектов и карточка проекта |
250
+ | `components.read` | Компоненты проекта и карточка компонента |
251
+ | `translations.read` | Языки компонента и один язык целиком |
252
+ | `units.read` | Поиск строк по тексту, контексту и состоянию, чтение одной строки |
253
+ | `checks.read` | Строки, у которых не проходит хотя бы одна проверка |
254
+ | `comments.read` | Комментарии к строке |
255
+ | `suggestions.read` | Предложенные переводы строки |
256
+ | `changes.read` | История изменений проекта |
257
+ | `statistics.read` | Готовность проекта, компонента и языка |
258
+ | `screenshots.read` | Метаданные скриншотов |
259
+
260
+ Weblate, как и TeamCity с Confluence, не сообщает через API, какие права выданы конкретному токену: токен действует от имени своего пользователя или своего проекта, а «проверить» чтением чужой области провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора (`weblate.*Read`), а права применяет сам Weblate — отказ приходит как `ProviderPermissionDenied`, и провайдер никогда не пробует другой credential. Каждая возможность при этом достижима хотя бы одной операцией, поэтому карточка не может показать переключатель, который ничего не делает.
261
+
262
+ Префиксы токенов Weblate (`wlu_` — личный, `wlp_` — проектный) доходят до пользователя подписью в карточке (`· личный токен`, `· токен проекта`, `· токен`) и никогда не являются проверкой прав: токен с незнакомым префиксом принимается наравне с остальными, а его права определяет сам Weblate. Проектный токен карточка рекомендует как меньший радиус поражения — это подсказка, а не запрет.
263
+
264
+ Оператор стенда дополнительно решает, какие из инструментов видит модель: имена `weblate_*` нужно добавить в tool allow-list пресета QA. Инструменты не принимают ни пользователя, ни credential, ни инстанс, поэтому допуск к ним — решение оператора, а не модели.
265
+
266
+ Запись в surface отсутствует: предложения перевода, комментарии, правка и утверждение перевода, файлы перевода, autotranslate и операции с репозиторием ждут confirmation-фреймворка. Инструмента с произвольным `q` и произвольным REST тоже нет: поиск принимает только типизированные фильтры.
190
267
 
191
268
  ## Возможности и скопы
192
269
 
193
- Одна возможность = один scope Bitrix24. Возможность появляется у пользователя только если её включил оператор (`bitrix24.*Read`) **и** подключённый вебхук реально получил соответствующий scope — плагин спрашивает это у портала методом `scope` при подключении и при нажатии «Проверить».
270
+ Одна возможность = один scope Bitrix24. Возможность появляется у пользователя только если её включил оператор (`bitrix24.*Read`, у записи — `bitrix24.crmCommentWrite`) **и** подключённый вебхук реально получил соответствующий scope — плагин спрашивает это у портала методом `scope` при подключении и при нажатии «Проверить».
194
271
 
195
- | Возможность | Scope вебхука | Что открывает |
196
- | --- | --- | --- |
197
- | `crm.read` | `crm` | CRM, дела, таймлайн, товарные строки, дубли |
198
- | `chat.read` | `im` | Чаты, сообщения, поиск по переписке |
199
- | `openlines.read` | `imopenlines` | Диалоги открытых линий и их история |
200
- | `user.read` | `user_brief` / `user_basic` / `user` | Свой профиль и поиск сотрудников |
201
- | `department.read` | `department` | Структура компании |
202
- | `tasks.read` | `task` | Задачи |
203
- | `calendar.read` | `calendar` | Календарь и занятость |
204
- | `disk.read` | `disk` | Файлы Диска |
272
+ | Возможность | Scope вебхука | Что открывает |
273
+ | ------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------- |
274
+ | `crm.read` | `crm` | CRM, дела, таймлайн, товарные строки, дубли |
275
+ | `crm.comment.write` | `crm` | Единственная операция записи: комментарий в таймлайн лида, сделки, контакта или компании |
276
+ | `chat.read` | `im` | Чаты, сообщения, поиск по переписке |
277
+ | `openlines.read` | `imopenlines` | Диалоги открытых линий и их история |
278
+ | `user.read` | `user_brief` / `user_basic` / `user` | Свой профиль и поиск сотрудников |
279
+ | `department.read` | `department` | Структура компании |
280
+ | `tasks.read` | `task` | Задачи |
281
+ | `calendar.read` | `calendar` | Календарь и занятость |
282
+ | `disk.read` | `disk` | Файлы Диска |
205
283
 
206
- Выданные в Bitrix24 права не отменяются: портал всё равно применяет права того пользователя, чей вебхук используется. Возможность, обнаруженная после выдачи нового scope, появляется в карточке выключенной — пользователь включает её сам. Запись (`*.add`, `*.update`, `*.delete`), бизнес-процессы, управление пользователями и generic REST/MCP в surface отсутствуют.
284
+ У Bitrix24 нет read-only scope вебхука: `crm` покрывает и чтение, и запись, поэтому гранулярность «запись отдельно» даёт только конфиг-флаг. `crm.comment.write` выключен по умолчанию; даже после включения флага операция стартует с политикой `deny`, пока пользователь (или оператор) явно её не разрешит, — проба scope сама по себе запись не открывает. Остальная запись (`*.add`, `*.update`, `*.delete`), бизнес-процессы, управление пользователями и generic REST/MCP в surface отсутствуют.
285
+
286
+ Выданные в Bitrix24 права не отменяются: портал всё равно применяет права того пользователя, чей вебхук используется. Возможность, обнаруженная после выдачи нового scope, появляется в карточке выключенной — пользователь включает её сам.
287
+
288
+ ## Сервисный токен Bitrix24
289
+
290
+ Подключение может работать от сервисного вебхука развёртывания: профиль `managedServiceCredentials` называет портал (хост, в любом регистре — он сравнивается с хостом, который брокер выводит из URL вебхука), секретом служит полный URL сервисного входящего вебхука, а граница ресурсов — единственный вид `portals`: сервисный вызов обязан отвечать на портале из списка, других идентификаторов у границы нет. Проба (`validateServiceCredential`) читает только `profile` и `scope`; подтвердить read-only она не может — scope `crm` и читает, и пишет одним битом, — поэтому вердикт всегда «здоров» с предупреждением, а потолок режима обеспечивают классификация операций и граница. Сервисному токену недоступны по классификации: запись в таймлайн, справочник сотрудников (телефоны и почта), дубликаты по телефону и почте, расшифровки звонков, все чтения чатов и открытых линий, календарь занятости и Диск — это чтения, ответы которых принадлежат конкретным людям, а не порталу; CRM-записи, задачи и структура отделов остаются сервисно-безопасными.
207
291
 
208
292
  ## Возможности и скопы GitLab
209
293
 
210
294
  Подключение — personal access token. Возможность появляется у пользователя только если её включил оператор (`gitlab.*Read`) **и** токен при подключении реально предъявил соответствующий scope: плагин спрашивает scopes у самого токена (`GET /api/v4/personal_access_tokens/self`) при сохранении и при нажатии «Проверить». Токен, который не может прочитать себя (старый GitLab, group/project access token), только снижает точность — срез остаётся на деплой-флагах оператора.
211
295
 
212
- | Возможность | Scope токена | Что открывает |
213
- | --- | --- | --- |
214
- | `identity.read` | `read_user` / `read_api` / `api` | Свой профиль: логин, имя, инстанс |
215
- | `projects.read` | `read_api` / `api` | Проекты, видимость, ветка по умолчанию |
216
- | `repository.read` | `read_repository` / `read_api` / `api` | Дерево, файлы, коммиты, сравнение веток |
217
- | `search.read` | `read_api` / `api` | Поиск по проектам, задачам, MR, коммитам, коду |
218
- | `issues.read` | `read_api` / `api` | Задачи и комментарии к ним |
219
- | `merge_requests.read` | `read_api` / `api` | MR, диффы, обсуждения, одобрения, пайплайны MR |
220
- | `ci.read` | `read_api` / `api` | Пайплайны, джобы, логи джоб |
296
+ | Возможность | Scope токена | Что открывает |
297
+ | --------------------- | -------------------------------------- | ---------------------------------------------- |
298
+ | `identity.read` | `read_user` / `read_api` / `api` | Свой профиль: логин, имя, инстанс |
299
+ | `projects.read` | `read_api` / `api` | Проекты, видимость, ветка по умолчанию |
300
+ | `repository.read` | `read_repository` / `read_api` / `api` | Дерево, файлы, коммиты, сравнение веток |
301
+ | `search.read` | `read_api` / `api` | Поиск по проектам, задачам, MR, коммитам, коду |
302
+ | `issues.read` | `read_api` / `api` | Задачи и комментарии к ним |
303
+ | `merge_requests.read` | `read_api` / `api` | MR, диффы, обсуждения, одобрения, пайплайны MR |
304
+ | `ci.metadata.read` | `read_api` / `api` | Пайплайны, джобы, их статусы и метаданные |
305
+ | `ci.logs.read` | `read_api` / `api` | Содержимое лога джоба |
221
306
 
222
- У GitLab нет отдельного read-scope на каждую область, поэтому `read_api` покрывает почти всё, а `read_repository` и `read_user` дают узкие наборы. Права токена не отменяются: GitLab всё равно применяет права своего пользователя. Возможность, появившаяся после выдачи нового scope, приходит в карточку выключенной. Запись (`POST`/`PUT`/`DELETE`), GraphQL, произвольный REST, admin-API, управление токенами, участниками и CI-переменными в surface отсутствуют; merge и запись в репозиторий — тоже.
307
+ CI разделён надвое намеренно: лог джоба — это другая утечка, чем список джоб, а раньше обе половины закрывала одна возможность `ci.read`. Оператор стенда задаёт половины отдельно (`ciMetadataRead` и `ciLogsRead`), а старый флаг `ciRead` продолжает работать и теперь управляет обеими; сохранённая политика `ci.read` при первом запуске переносится на оба новых id, поэтому выключенный CI не включается сам. Под сервисным токеном доступна только первая половина: `ci.metadata.read` отвечает, какие джобы были и чем кончились, а `ci.logs.read` показывает, что они напечатали, и остаётся личным чтением. Любая операция, читающая проект, в сервисном режиме обязана назвать проект или группу внутри границы профиля, а листинг без проекта (`gitlab_issues_list`, `gitlab_merge_requests_list`) отказывается — вместо ответа всей картиной, доступной общему аккаунту.
308
+
309
+ У GitLab нет отдельного read-scope на каждую область, поэтому `read_api` покрывает почти всё, а `read_repository` и `read_user` дают узкие наборы. Права токена не отменяются: GitLab всё равно применяет права своего пользователя. Возможность, появившаяся после выдачи нового scope, приходит в карточку выключенной. Запись (`POST`/`PUT`/`DELETE`), GraphQL, произвольный REST, admin-API, управление токенами, участниками и CI-переменными в surface отсутствуют; merge и запись в репозиторий — тоже. Сервисный токен не превращает эти запреты в разрешения: он только сужает — и дополнительно прячет от общего аккаунта лог джоба.
223
310
 
224
311
  Оператор стенда дополнительно решает, какие из инструментов видит модель: имена нужно добавить в tool allow-list пресета QA. Инструменты не принимают ни пользователя, ни credential, поэтому допуск к ним — решение оператора, а не модели.
225
312
 
@@ -227,18 +314,20 @@ Confluence, как и TeamCity, не сообщает через API, какие
227
314
 
228
315
  Подключение — персональный access token TeamCity. Адрес сервера задаёт оператор в конфигурации развёртывания (`teamcity.serverUrl`) — он один на всех, поэтому форма подключения спрашивает только токен, а карточка показывает адрес как справочную строку. Если адрес не задан, карточка говорит об этом вместо формы, которая всё равно не сохранится. Возможность появляется у пользователя, если её включил оператор (`teamcity.*Read`).
229
316
 
230
- | Возможность | Что открывает |
231
- | --- | --- |
232
- | `identity.read` | Сервер TeamCity, его версия и подключённый пользователь |
233
- | `projects.read` | Проекты |
234
- | `buildConfigs.read` | Конфигурации сборки |
235
- | `builds.read` | Сборки, карточка сборки, изменения в VCS |
236
- | `failures.read` | Упавшие тесты и проблемы сборки |
237
- | `logs.read` | Фрагмент лога сборки |
238
- | `queue.read` | Очередь сборки |
239
- | `investigations.read` | Расследования падений |
240
- | `agents.read` | Агенты сборки |
241
- | `artifacts.read` | Список артефактов и текст небольших текстовых файлов |
317
+ | Возможность | Что открывает |
318
+ | --------------------- | ------------------------------------------------------- |
319
+ | `identity.read` | Сервер TeamCity, его версия и подключённый пользователь |
320
+ | `projects.read` | Проекты |
321
+ | `buildConfigs.read` | Конфигурации сборки |
322
+ | `builds.read` | Сборки, карточка сборки, изменения в VCS |
323
+ | `failures.read` | Упавшие тесты и проблемы сборки |
324
+ | `logs.read` | Фрагмент лога сборки |
325
+ | `queue.read` | Очередь сборки |
326
+ | `investigations.read` | Расследования падений |
327
+ | `agents.read` | Агенты сборки |
328
+ | `artifacts.read` | Список артефактов и текст небольших текстовых файлов |
329
+
330
+ Лог сборки и текст артефакта остаются личными под сервисным токеном: это текст, который напечатала сборка, и общий read-only аккаунт его не читает. Список артефактов — обычное чтение метаданных, но возможность у него одна с текстом, поэтому в сервисном режиме `artifacts.read` целиком помечена «Требуется личный аккаунт», как и `logs.read`. В сервисном режиме листинг обязан назвать проект или конфигурацию: `teamcity_builds`, `teamcity_build_configs`, `teamcity_queue` и `teamcity_investigations` без `projectId` или `buildTypeId` отказываются, потому что иначе ответили бы всей картиной сервера, а `teamcity_projects` собирается из allowlist профиля. Сборка, названная по id, сначала разрешается в свой проект, поэтому прямой `teamcity_build` проходит ту же проверку, что и листинг. Причины падений (`teamcity_build_failures`) остаются сервисными: инструмент отвечает упавшими тестами и проблемами сборки, а не логом.
242
331
 
243
332
  TeamCity, в отличие от GitLab и Bitrix24, не сообщает через API, какие именно права выданы конкретному токену: админ-скоупы невидимы снаружи, а «проверить» записью провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора, а права токена применяет сам TeamCity — отказ приходит как `ProviderPermissionDenied`, и провайдер никогда не пробует другой credential. Рекомендация пользователю в карточке прямая: создать токен с «Limit per project» и только теми правами чтения, которые нужны.
244
333
 
@@ -248,21 +337,23 @@ TeamCity, в отличие от GitLab и Bitrix24, не сообщает че
248
337
 
249
338
  Подключение — API-токен Atlassian и e-mail аккаунта, которому он принадлежит: Jira Cloud аутентифицирует такой токен через HTTP Basic (`email:token`). Сайты задаёт оператор в конфигурации развёртывания (`jira.sites`) — пользователь выбирает сайт из списка и вводит e-mail с токеном, произвольный хост ввести нельзя. Возможность появляется у пользователя, если её включил оператор (`jira.*Read`).
250
339
 
251
- | Возможность | Что открывает |
252
- | --- | --- |
253
- | `identity.read` | Подключённый пользователь Atlassian и сайт, на котором он работает |
254
- | `issues.read` | Поиск задач со всем словарём фильтров (включая историю изменений задачи и разрешение имени в accountId) и карточка задачи с описанием, связями и кастомными полями |
255
- | `comments.read` | Комментарии задачи, включая ограниченные (с пометкой видимости) |
256
- | `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор |
257
- | `transitions.read` | Доступные переходы статуса и их обязательные поля |
258
- | `projects.read` | Карточка проекта |
259
- | `fields.read` | Схема полей сайта, включая кастомные, — она же источник id для фильтра по кастомному полю |
340
+ | Возможность | Что открывает |
341
+ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
342
+ | `identity.read` | Подключённый пользователь Atlassian и сайт, на котором он работает |
343
+ | `issues.read` | Поиск задач со всем словарём фильтров (включая историю изменений задачи и разрешение имени в accountId) и карточка задачи с описанием, связями и кастомными полями |
344
+ | `comments.read` | Комментарии задачи, включая ограниченные (с пометкой видимости) |
345
+ | `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор |
346
+ | `transitions.read` | Доступные переходы статуса и их обязательные поля |
347
+ | `projects.read` | Карточка проекта |
348
+ | `fields.read` | Схема полей сайта, включая кастомные, — она же источник id для фильтра по кастомному полю |
260
349
 
261
350
  Jira, как и TeamCity, не сообщает через API, какие права выданы конкретному API-токену: токен действует от имени пользователя и наследует его права целиком, а «проверить» записью провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора, а права аккаунта применяет сама Jira — отказ приходит как `ProviderPermissionDenied` (задача, проект или поле закрыты схемой прав, issue security level или схемой ролей), и провайдер никогда не пробует другой credential. Единственная проверка, которую провайдер делает сам при подключении, — тип развёртывания: сайт, который отвечает `deploymentType`, отличным от `Cloud`, отклоняется, потому что Data Center — другой API, и молча считать его совместимым спецификация запрещает.
262
351
 
263
352
  Запись в surface отсутствует: создание, правка, назначение, комментарии и переходы ждут pending actions и карточки подтверждения; удаление, администрирование проектов и workflow, произвольный REST и скачивание содержимого вложений — тоже. Провайдер читает только объявленный allow-list эндпоинтов `/rest/api/3` (гейт пакета падает на любом пути вне него), а легаси-эндпоинт `/rest/api/3/search`, удалённый Atlassian, не используется: поиск идёт через `/rest/api/3/search/jql`.
264
353
 
265
- ## Как подключается TeamCity
354
+ ### Сервисный токен Jira
355
+
356
+ Подключение может работать от сервисного токена развёртывания: профиль называет сайт, секрет — обычный API-токен Atlassian в Basic-паре, а граница ресурсов — `projects` (ключи проектов, сравнение без учёта регистра; числовой id засчитывается, если Jira отдала его в выдаче). Сервисному токену недоступны чтения вложений — даже список метаданий помечен чувствительным, потому что следующий естественный шаг агента — скачать файл. Фильтры JQL по имени человека в сервисном режиме отказывают целиком — это чтение корпоративного справочника, у которого нет проекта в границе, — а фильтры по accountId и `me` остаются. Задача, названная по ключу, сначала раскрывается в свой проект, и чтение с уровнем безопасности, который сервисный токен не проходит, отвечает `ResourceNotFound`, как для чужой задачи.
266
357
 
267
358
  Адрес TeamCity задаёт оператор: сервер один на весь стенд, поэтому `teamcity.serverUrl` — обычная настройка развёртывания, а не поле формы. Пользователь вводит только токен, и токен тратится ровно по этому адресу. Рядом оператор задаёт **политику адресов**: какие адреса этот стенд готов набирать вообще (политика осталась от времён, когда адрес вводил пользователь, и закрывает переезд конфига на чужой хост).
268
359
 
@@ -271,12 +362,12 @@ teamcity:
271
362
  enabled: true
272
363
  serverUrl: https://teamcity.example.internal
273
364
  network:
274
- mode: allowlist # allowlist | trusted-private
365
+ mode: allowlist # allowlist | trusted-private
275
366
  allowedHosts:
276
367
  - teamcity.example.internal
277
368
  - "*.corp.example"
278
369
  allowedCidrs:
279
- - 10.20.0.0/16 # только для адресов, записанных цифрами
370
+ - 10.20.0.0/16 # только для адресов, записанных цифрами
280
371
  allowedPorts:
281
372
  - 443
282
373
  - 8111
@@ -293,12 +384,14 @@ teamcity:
293
384
 
294
385
  Пустая политика (`allowedHosts` и `allowedCidrs` пусты) — это не ошибка загрузки, а «ничего не подключить»: плагин пишет об этом предупреждение в лог при старте, а карточка отвечает пользователю отказом. Опечатки в самой политике — наоборот, падение на старте: молча выброшенный шаблон хоста оставил бы стенд без объяснения.
295
386
 
387
+ Если для этого сервера заведён сервисный токен, форма вместо поля с токеном показывает чекбокс «Использовать сервисный токен»: при `defaultForNewConnections: true` он отмечен, кнопка называется «Подключить сервисный токен», а адрес сервера остаётся той же справочной строкой — его по-прежнему задаёт оператор. Подключённая карточка называет псевдоним сервисного профиля вместо аккаунта, кнопками «Использовать личный аккаунт» и «Использовать сервисный токен» переключает режимы, а «Изменить доступ» сужает список проектов, с которыми работает подключение.
388
+
296
389
  ## Конфигурация TeamCity
297
390
 
298
391
  ```yaml
299
392
  teamcity:
300
393
  enabled: true
301
- serverUrl: https://teamcity.example.internal # один адрес на весь стенд
394
+ serverUrl: https://teamcity.example.internal # один адрес на весь стенд
302
395
  network:
303
396
  mode: allowlist
304
397
  allowedHosts: [teamcity.example.internal]
@@ -314,12 +407,12 @@ teamcity:
314
407
  investigationsRead: true
315
408
  agentsRead: true
316
409
  artifactsRead: true
317
- maxLogLines: 1000 # потолок строк в ответе по логу
318
- maxLogBytes: 262144 # сколько лога вообще скачиваем
319
- defaultArtifactBytes: 262144 # бюджет чтения артефакта по умолчанию
320
- maxArtifactBytes: 1048576 # жёсткий потолок чтения артефакта
321
- streamTimeoutMs: 30000 # таймаут для логов и артефактов
322
- retries: 2 # повторы для 429/5xx и сетевых сбоев
410
+ maxLogLines: 1000 # потолок строк в ответе по логу
411
+ maxLogBytes: 262144 # сколько лога вообще скачиваем
412
+ defaultArtifactBytes: 262144 # бюджет чтения артефакта по умолчанию
413
+ maxArtifactBytes: 1048576 # жёсткий потолок чтения артефакта
414
+ streamTimeoutMs: 30000 # таймаут для логов и артефактов
415
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
323
416
  ```
324
417
 
325
418
  Токен создаётся в TeamCity (Profile → Access Tokens), при желании с «Limit per project» и read-правами, вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты.
@@ -347,7 +440,7 @@ teamcity:
347
440
  ```yaml
348
441
  confluence:
349
442
  enabled: true
350
- allowInsecureHttp: false # только для dev-стенда
443
+ allowInsecureHttp: false # только для dev-стенда
351
444
  instances:
352
445
  - id: company
353
446
  label: Company
@@ -363,12 +456,12 @@ confluence:
363
456
  commentsRead: true
364
457
  attachmentsRead: true
365
458
  versionsRead: true
366
- allowedSpaces: [] # ключи пространств; пусто = все, что видит аккаунт
367
- defaultBodyChars: 20000 # бюджет тела страницы по умолчанию
368
- maxBodyChars: 60000 # потолок бюджета, который может попросить модель
369
- maxResults: 50 # строк в ответе любого списка (потолок для limit)
370
- maxReplyParents: 10 # сколько комментариев могут принести ответы
371
- retries: 2 # повторы для 429/5xx и сетевых сбоев
459
+ allowedSpaces: [] # ключи пространств; пусто = все, что видит аккаунт
460
+ defaultBodyChars: 20000 # бюджет тела страницы по умолчанию
461
+ maxBodyChars: 60000 # потолок бюджета, который может попросить модель
462
+ maxResults: 50 # строк в ответе любого списка (потолок для limit)
463
+ maxReplyParents: 10 # сколько комментариев могут принести ответы
464
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
372
465
  ```
373
466
 
374
467
  API token выпускается в профиле Atlassian (`Manage profile → Security → API tokens`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты. Если стенду нужен OAuth-аккаунт Atlassian общего вида, а не персональный токен, — это отдельная фаза.
@@ -388,18 +481,77 @@ API token выпускается в профиле Atlassian (`Manage profile
388
481
  - **Rate limiting** (раздел «Rate limiting»): лимиты по principal, ресурсу и глобальные не считаются; вместо них — ограниченные размеры ответов и повторы с backoff для 429/5xx.
389
482
  - **Семантический индекс** (раздел «Optional semantic index»), **webhooks** и **Confluence Data Center** (раздел «Compatibility») — не подключены: провайдер работает только с Confluence Cloud.
390
483
 
484
+ ### Сервисный токен Weblate
485
+
486
+ Подключение может работать от сервисного токена развёртывания: профиль называет инстанс, секрет — обычный API-токен Weblate (префикс значения роли не играет), а граница ресурсов — `projects` (слаги проектов; компонент принадлежит проекту, поэтому чтение компонента сверяет его проект). Чувствительных чтений в каталоге нет: всё, что читает провайдер, — переводческие метаданные, а `changes.list` — собственный журнал изменений Weblate, а не сырой вывод VCS. Чтение, названное по id строки, сначала раскрывается в свой проект; скриншоты вне границы и с непроверяемым проектом из выдачи выпадают, а листинг проектов собирается из allowlist с `unavailableResources` для того, что токен не видит.
487
+
488
+ Инстансы Weblate задаёт только оператор: пользователь выбирает инстанс из списка и вставляет API-токен, произвольный хост ввести нельзя. Если инстанс один, выбор не показывается; если инстансов нет, карточка честно сообщает, что подключать нечего, и формы не показывает.
489
+
490
+ Правила адреса инстанса — те же, что у GitLab (то, что защищает брокер от SSRF): только `http`/`https`, HTTPS обязателен вне явного `allowInsecureHttp` для стенда; без credentials и query в URL; путь допустим (Weblate за обратным прокси в подкаталоге), хвостовой слэш срезается; id инстанса — стабильный ключ, который и хранит секрет. Адрес не сохраняется в credential: он перечитывается из конфига на каждом вызове, поэтому удаление или переезд инстанса немедленно закрывает доступ к сохранённому токену (`CredentialRevoked`), и подмены на другой инстанс не происходит. Redirect не отслеживается (`redirect: "error"`), а токен уходит только в заголовке `Authorization: Token …` — в URL и теле его нет.
491
+
492
+ Токен выпускается в профиле Weblate (настройки профиля → API tokens), вводится один раз в карточке, шифруется тем же конвертным хранилищем, что и остальные секреты, и после сохранения не показывается и не копируется. Рядом карточка подсказывает, что для минимума прав лучше подходит токен проекта (`wlp_…`), ограниченный одним проектом.
493
+
494
+ ## Конфигурация Weblate
495
+
496
+ ```yaml
497
+ weblate:
498
+ enabled: true
499
+ allowInsecureHttp: false # только для dev-стенда
500
+ instances:
501
+ - id: corp
502
+ label: Corporate Weblate
503
+ baseUrl: https://weblate.example.com
504
+ # Weblate в подкаталоге сохраняет путь:
505
+ # - id: corp-weblate
506
+ # label: Corp Weblate
507
+ # baseUrl: https://example.com/weblate
508
+ identityRead: true
509
+ projectsRead: true
510
+ componentsRead: true
511
+ translationsRead: true
512
+ unitsRead: true
513
+ checksRead: true
514
+ commentsRead: true
515
+ suggestionsRead: true
516
+ changesRead: true
517
+ statisticsRead: true
518
+ screenshotsRead: true
519
+ maxTextChars: 4000 # символов одной строки, которую видит модель
520
+ maxPageSize: 100 # потолок страницы; по умолчанию провайдер просит 20
521
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
522
+ ```
523
+
524
+ Список инстансов принимает не больше 16 записей; id — строчные латинские буквы, цифры и дефисы (до 32 символов), без повторов; подпись по умолчанию — имя хоста. Опечатка в инстансе роняет загрузку конфига, а не выбрасывает инстанс молча: пользователь иначе получил бы провайдер, к которому нельзя подключиться, и никакого объяснения. Пустой список — это состояние, а не падение: провайдер зарегистрирован и бездействует, а отказывает форма подключения.
525
+
526
+ ## Чего в Weblate-провайдере ещё нет
527
+
528
+ Спецификация `docs/SPEC-providers-weblate.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у остальных провайдеров:
529
+
530
+ - **Запись** (раздел «Write operations»): предложения перевода, комментарии, правка и утверждение перевода, файлы перевода, autotranslate и операции с репозиторием — вместе с ними отложены pending actions и карточка подтверждения. Пока в каталоге нет ни одной операции, которая может изменить Weblate.
531
+ - **Скачивание скриншотов** (раздел «Screenshots and binary data»): сейчас только метаданные, id связанных строк и адрес картинки на настроенном инстансе; ни байты, ни лимит размера, ни проверка MIME, ни временное хранилище на пользователя не реализованы.
532
+ - **История изменений по строке** (раздел «Change history»): Weblate отдаёт историю по проекту, компоненту и переводу, но не по строке, поэтому инструмент проектный, а нужная строка ищется по id в каждой записи; отдельного чтения истории одной строки нет и появиться не может, пока такого эндпоинта нет у самого Weblate.
533
+ - **Произвольный `q`** (раздел «Search and filters»): поиск принимает только типизированные фильтры. Грамматика объявляет четыре текстовых поля строки (`source`, `target`, `context`, `note`), но `note` ни один инструмент не передаёт, так что для модели он недостижим.
534
+ - **Определение возможностей и код `CAPABILITY_UNAVAILABLE`** (разделы «Permissions», «Compatibility»): Weblate не сообщает, что разрешено конкретному токену, а выводить права из одного удачного чтения провайдер отказывается, поэтому никакого discovery нет; чтение, которого нет в этой версии Weblate, отвечает `405` и приходит как `ResourceNotFound` с пояснением, что операцию не поддерживает сама версия.
535
+ - **Кэш** (раздел «Caching») отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может; пагинация stateless, подписанных continuation-токенов нет.
536
+ - **Rate limiting** (раздел «Rate limiting»): лимитов на аккаунт и на инстанс нет; вместо них ограниченные страницы и текст, повторы с backoff (включая `Retry-After`, если он числовой) и полный отказ от повторов на 4xx.
537
+ - **Продолжение большого ответа** (раздел «Response size controls»): тело больше `maxResponseBytes` отвечает `ResultTooLarge`, а сегментного чтения нет.
538
+ - **SSRF-политика по CIDR и DNS** (раздел «API base»): правило провайдера — список инстансов оператора и HTTPS по умолчанию, потому что Weblate обычно self-hosted; «адрес объявлен оператором» заменяет «адрес публичный».
539
+ - **Аудит и OTel-инструменты** (раздел «Observability»): провайдер не публикует ни метрик, ни спанов, а слой интеграций пишет в audit только provider, operation, result и source session id — текст локализации в журнал не попадает.
540
+
391
541
  ## Как подключается GitLab
392
542
 
393
543
  Инстансы GitLab задаёт только оператор: пользователь выбирает из списка и вставляет токен, произвольный хост ввести нельзя. Если инстанс один, выбор не показывается; если инстансов нет, карточка честно сообщает, что подключать нечего.
394
544
 
395
545
  Правила адреса инстанса (то, что защищает брокер от SSRF): только `http`/`https`, HTTPS обязателен вне явного `allowInsecureHttp` для стенда; без credentials, query и fragment в URL; путь допустим (GitLab, смонтированный в подкаталог), хвостовой слэш срезается; id инстанса — стабильный ключ, который и хранит секрет. Адрес не сохраняется в credential: он перечитывается из конфига на каждом вызове, поэтому удаление или переезд инстанса немедленно закрывает доступ к сохранённому токену (`CredentialRevoked`), и подмены на другой инстанс не происходит. Redirect не отслеживается (`redirect: "error"`), токен уходит только в заголовке `PRIVATE-TOKEN`, в URL и теле его нет.
396
546
 
547
+ Если для выбранного инстанса развёртывание завело сервисный токен, форма подключения получает чекбокс «Использовать сервисный токен». При `defaultForNewConnections: true` он уже отмечен, и поле токена не показывается: подключается общий read-only аккаунт, а кнопка называется «Подключить сервисный токен»; снятая галочка возвращает форму с personal access token. Подключённая карточка говорит, на каком аккаунте работает подключение, переключает режимы кнопками «Использовать личный аккаунт» и «Использовать сервисный токен», а сузить границу доступа предлагает кнопкой «Изменить доступ».
548
+
397
549
  ## Конфигурация GitLab
398
550
 
399
551
  ```yaml
400
552
  gitlab:
401
553
  enabled: true
402
- allowInsecureHttp: false # только для dev-стенда
554
+ allowInsecureHttp: false # только для dev-стенда
403
555
  instances:
404
556
  - id: gitlab-com
405
557
  label: GitLab.com
@@ -413,11 +565,12 @@ gitlab:
413
565
  searchRead: true
414
566
  issuesRead: true
415
567
  mergeRequestsRead: true
416
- ciRead: true
417
- maxFileBytes: 131072 # сколько тела файла отдаём модели
418
- maxJobLogBytes: 262144 # сколько лога джобы отдаём модели
419
- maxSearchResults: 50 # потолок per page у поиска
420
- retries: 2 # повторы для 429/5xx и сетевых сбоев
568
+ ciMetadataRead: true # пайплайны, джобы, их статусы; прежний ciRead задаёт обе половины
569
+ ciLogsRead: true # содержимое лога джоба: только личный аккаунт
570
+ maxFileBytes: 131072 # сколько тела файла отдаём модели
571
+ maxJobLogBytes: 262144 # сколько лога джобы отдаём модели
572
+ maxSearchResults: 50 # потолок per page у поиска
573
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
421
574
  ```
422
575
 
423
576
  OAuth-приложение для GitLab не нужно: подключение идёт персональным токеном. Токен создаётся в GitLab (`User settings → Access tokens`) с read-scope, вводится один раз в карточке, шифруется тем же конвертным хранилищем, что и вебхук Bitrix24, и после сохранения не показывается и не копируется.
@@ -427,7 +580,7 @@ OAuth-приложение для GitLab не нужно: подключение
427
580
  Спецификация `docs/SPEC-providers-gitlab.md` описывает целевую архитектуру; в этой версии сознательно реализована только read-only фаза, как и у Bitrix24:
428
581
 
429
582
  - **OAuth Authorization Code + PKCE** (§8.1) — вместо него PAT (§8.2). Для OAuth нужны callback-маршрут на хосте, одноразовый state и refresh-цикл; это отдельная фаза.
430
- - **Пользовательская граница ресурсов** (§12): сейчас доступ ограничен правами токена и персональной политикой возможностей, но не выбранным набором проектов/групп.
583
+ - **Пользовательская граница ресурсов** (§12): в личном режиме доступ ограничен правами токена и персональной политикой возможностей, но не выбранным набором проектов/групп. Выбранный набор есть только в сервисном режиме: там границу задаёт администратор в профиле, а пользователь может её сузить, но не расширить.
431
584
  - **Pending actions и подтверждения** (§15) — вместе с ними отложены все записи: комментарии, создание задач и MR, запуск и отмена пайплайнов.
432
585
  - **Кэш** (§21) отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может; пагинация stateless, подписанных continuation-токенов нет.
433
586
  - **Webhooks** (§23) и **официальный GitLab MCP** (§24) — не подключены; REST API v4 остаётся единственным бэкендом.
@@ -443,7 +596,7 @@ OAuth-приложение для GitLab не нужно: подключение
443
596
  ```yaml
444
597
  jira:
445
598
  enabled: true
446
- allowInsecureHttp: false # только для dev-стенда
599
+ allowInsecureHttp: false # только для dev-стенда
447
600
  sites:
448
601
  - id: company
449
602
  label: company.atlassian.net
@@ -451,8 +604,8 @@ jira:
451
604
  - id: sandbox
452
605
  label: Sandbox
453
606
  baseUrl: https://sandbox.atlassian.net
454
- fieldAliases: # имена кастомных полей ЭТОГО сайта: алиас → customfield_ id
455
- product: customfield_10010 # id берётся из jira_get_fields; в репозитории их нет
607
+ fieldAliases: # имена кастомных полей ЭТОГО сайта: алиас → customfield_ id
608
+ product: customfield_10010 # id берётся из jira_get_fields; в репозитории их нет
456
609
  identityRead: true
457
610
  issuesRead: true
458
611
  commentsRead: true
@@ -460,11 +613,11 @@ jira:
460
613
  transitionsRead: true
461
614
  projectsRead: true
462
615
  fieldsRead: true
463
- defaultSearchLimit: 20 # строк в ответе поиска, если модель не просила
464
- maxSearchLimit: 100 # потолок страницы; больше Jira не отдаёт
465
- maxCommentLimit: 100 # потолок страницы комментариев
466
- maxTextChars: 20000 # бюджет одного описания, комментария или rich-поля
467
- retries: 2 # повторы для 429/5xx и сетевых сбоев
616
+ defaultSearchLimit: 20 # строк в ответе поиска, если модель не просила
617
+ maxSearchLimit: 100 # потолок страницы; больше Jira не отдаёт
618
+ maxCommentLimit: 100 # потолок страницы комментариев
619
+ maxTextChars: 20000 # бюджет одного описания, комментария или rich-поля
620
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
468
621
  ```
469
622
 
470
623
  OAuth-приложение для Jira не нужно: подключение идёт API-токеном. Токен создаётся в аккаунте Atlassian (`id.atlassian.com → Безопасность → API-токены`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты — вместе с e-mail аккаунта, потому что Jira аутентифицирует пару `email:token`, а не токен отдельно. После сохранения ни то, ни другое не показывается и не копируется.
@@ -485,6 +638,205 @@ OAuth-приложение для Jira не нужно: подключение
485
638
  - **Кэш** (§Caching) отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может: схема полей перечитывается на каждый такой вызов, а курсор поиска — это continuation-токен Jira, а не наше состояние.
486
639
  - **Rate limiting** (§Rate limiting): лимитов на пользователя и на сайт нет; вместо них — ограниченные страницы, таймаут стенда (`timeoutMs`) и повторы с `Retry-After` для 429/5xx. Инвалидация по webhooks (§Future work) — тоже не подключена.
487
640
 
641
+ ## Инструменты Test IT
642
+
643
+ Test IT — система управления тестированием: тест-библиотека, тест-планы, прогоны
644
+ и результаты. Все 22 инструмента только читают; каждый называет capability, и
645
+ выключенную оператором возможность агент не получает вовсе.
646
+
647
+ | Tool | Что делает |
648
+ | -------------------------------- | ------------------------------------------------------------------- |
649
+ | `testit_connection_get` | К какой инсталляции подключено и видит ли токен проекты |
650
+ | `testit_projects` | Проекты с числом тест-кейсов, чек-листов и автотестов |
651
+ | `testit_project_get` | Карточка проекта: описание, счётчики, схема атрибутов |
652
+ | `testit_sections` | Разделы (папки) тест-библиотеки проекта |
653
+ | `testit_work_items` | Тест-кейсы, чек-листы и общие шаги проекта по фильтрам |
654
+ | `testit_work_item_get` | Тест-кейс целиком: шаги, предусловия, атрибуты, теги, вложения |
655
+ | `testit_work_item_history` | История изменений: кто что поменял, из чего в что |
656
+ | `testit_work_item_comments` | Комментарии к тест-кейсу |
657
+ | `testit_work_item_test_results` | История результатов тест-кейса по прогонам и конфигурациям |
658
+ | `testit_test_plans` | Тест-планы проекта со статусом и сроками |
659
+ | `testit_test_plan_get` | Карточка тест-плана |
660
+ | `testit_test_plan_summary` | Прогресс плана: тест-поинты, автоматизация, дефекты |
661
+ | `testit_test_runs` | Прогоны проекта по состояниям, датам и тест-плану |
662
+ | `testit_test_run_get` | Карточка прогона |
663
+ | `testit_test_run_results` | Что было в прогоне: тест-поинты с итогом и результатами |
664
+ | `testit_test_result_get` | Результат теста: шаги, длительность, сообщение, трейсы |
665
+ | `testit_test_result_attachments` | Метаданные вложений результата |
666
+ | `testit_attachment_metadata` | Метаданные вложения |
667
+ | `testit_attachment_text` | Текст небольшого текстового вложения (бинарные и архивы отбиваются) |
668
+ | `testit_auto_tests` | Автотесты проекта: класс, пространство имён, стабильность |
669
+ | `testit_auto_test_get` | Карточка автотеста: шаги, setup, teardown, последний результат |
670
+ | `testit_configurations` | Конфигурации проекта, в разрезе которых считаются результаты |
671
+
672
+ ## Возможности и скопы Test IT
673
+
674
+ | Возможность | Что открывает |
675
+ | --------------------- | ------------------------------------------------------------ |
676
+ | `projects.read` | Проекты и карточка проекта, проба подключения |
677
+ | `sections.read` | Разделы тест-библиотеки |
678
+ | `workItems.read` | Тест-кейсы, чек-листы, общие шаги |
679
+ | `history.read` | История изменений тест-кейса |
680
+ | `comments.read` | Комментарии тест-кейса |
681
+ | `testPlans.read` | Тест-планы, карточка и сводка |
682
+ | `testRuns.read` | Прогоны и карточка прогона |
683
+ | `testResults.read` | Результаты прогона, отдельный результат, история результатов |
684
+ | `autoTests.read` | Автотесты |
685
+ | `attachments.read` | Метаданные вложений и текст текстовых файлов |
686
+ | `configurations.read` | Конфигурации проекта |
687
+
688
+ Сужения по «выданным правам» здесь нет: API v2 не сообщает, какие права у
689
+ токена (в отличие от вебхука Bitrix24 с его scope и GitLab с
690
+ `personal_access_tokens/self`). Поэтому список возможностей — ровно то, что
691
+ разрешил оператор стенда, а дальше отказывает сам Test IT: `403` приходит
692
+ модели как `ProviderPermissionDenied`, а не превращается в пустой ответ.
693
+
694
+ Три читающих списка Test IT помечает устаревшими (`GET /projects`,
695
+ `GET /projects/{projectId}/workItems`, `GET /autoTests`). Они оставлены: это
696
+ единственные GET-чтения этих коллекций, а поиск (`POST /workItems/search`),
697
+ статистика прогона и глобальный поиск — POST-эндпоинты, которых в каталоге нет
698
+ по правилу «каждая операция каталога — GET». Что из-за этого недоступно и чем
699
+ заменено — в [SPEC-providers-testit.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/docs/SPEC-providers-testit.md).
700
+
701
+ ### Сервисный токен Test IT
702
+
703
+ Подключение может работать от сервисного токена развёртывания: профиль называет инсталляцию, секрет — обычный API-токен, а граница ресурсов — `projects` (id проектов, точное сравнение — иерархии проектов у Test IT нет). Сервисному токену недоступны вложения целиком: даже метаданные не несут проект, поэтому глобальный id нечем сверить с границей — каталог отвечает отказом, а не молча; тело вложения чувствительно и в личном режиме читается только у маленьких текстовых файлов. Чтение, адресованное id (тест-кейс, план, прогон, результат), сначала раскрывается в свой проект, и чтение вне границы отказывает до обращения к собственно объекту; листинг `projects.list` собирается из allowlist, а не из того, что видит токен.
704
+
705
+ Test IT бывает облачный и self-hosted, поэтому адрес задаёт оператор стенда
706
+ списком инсталляций (`testit.instances`) — пользователь выбирает инсталляцию из
707
+ списка и вводит только свой API-токен:
708
+
709
+ ```yaml
710
+ testit:
711
+ instances:
712
+ - id: cloud
713
+ label: Test IT Cloud
714
+ baseUrl: https://team.example.testit.software
715
+ ```
716
+
717
+ Правила те же, что у GitLab и Jira: только `https://` (кроме осознанной
718
+ лазейки `allowInsecureHttp` для внутреннего стенда), никаких credentials в URL,
719
+ query и фрагмента, а хвостовой слэш снимается. Опечатка оператора падает при
720
+ загрузке конфига. Адрес не хранится в подключении: он перечитывается из
721
+ конфига на каждом вызове, поэтому удаление или переадресация инсталляции
722
+ закрывает и уже созданные подключения. Если инсталляций нет, карточка говорит
723
+ об этом и формы не показывает.
724
+
725
+ Токен Test IT едет только заголовком `Authorization: PrivateToken …`. Владельца
726
+ токена API v2 не сообщает (эндпоинта вида `/me` в спецификации нет), поэтому
727
+ после проверки карточка показывает инсталляцию и число видимых проектов, а не
728
+ имя аккаунта.
729
+
730
+ ## Конфигурация Test IT
731
+
732
+ ```yaml
733
+ testit:
734
+ enabled: true
735
+ allowInsecureHttp: false # лазейка для внутреннего стенда; в проде HTTPS
736
+ instances:
737
+ - id: cloud
738
+ label: Test IT Cloud
739
+ baseUrl: https://team.example.testit.software
740
+ projectsRead: true # флаги возможностей: выключенная не доходит до агента
741
+ sectionsRead: true
742
+ workItemsRead: true
743
+ historyRead: true
744
+ commentsRead: true
745
+ testPlansRead: true
746
+ testRunsRead: true
747
+ testResultsRead: true
748
+ autoTestsRead: true
749
+ attachmentsRead: true
750
+ configurationsRead: true
751
+ defaultResults: 20 # размер списка, когда модель не назвала лимит
752
+ maxResults: 100 # жёсткий потолок одного ответа-списка
753
+ defaultAttachmentBytes: 262144 # бюджет чтения вложения по умолчанию
754
+ maxAttachmentBytes: 10485760 # жёсткий потолок чтения вложения (10 MiB)
755
+ attachmentTimeoutMs: 30000 # таймаут скачивания вложения
756
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
757
+ ```
758
+
759
+ ## Чего в Test IT-провайдере ещё нет
760
+
761
+ Спецификация `docs/SPEC-providers-testit.md` описывает целевую архитектуру; в
762
+ этой версии реализована read-only фаза, как и у остальных пяти провайдеров:
763
+
764
+ - **Поиск и статистика через POST**: `POST /workItems/search`,
765
+ `POST /testRuns/{id}/statistics/filter`, `POST /testResults/statistics/filter`
766
+ и глобальный поиск не используются — в каталоге нет ни одной не-GET операции.
767
+ Фильтр по имени применяется к возвращённой странице, статистика прогона
768
+ заменена чтением тест-поинтов прогона и сводкой тест-плана.
769
+ - **Скачивание вложений**: доступен только текст небольших текстовых файлов;
770
+ архивы, изображения и документы отбиваются по имени из метаданных, а не
771
+ инлайнятся.
772
+ - **Запись** (комментарии, правка тест-кейсов, создание и жизненный цикл
773
+ прогона, загрузка вложений): требует confirmation-фреймворка
774
+ (`prepare → confirm → execute`), которого пока нет ни у одного провайдера.
775
+ В каталоге нет ни одной операции со словом `prepare`.
776
+ - **Проверка CIDR для приватных адресов**: границей исходящих направлений
777
+ служит список инсталляций оператора, а не проверка диапазонов RFC1918 — у
778
+ on-prem TMS внутренний адрес штатный, а ограничение egress остаётся задачей
779
+ сетевой политики стенда.
780
+ - **Контрактные тесты**: утверждения о поведении устаревших GET-списков, о
781
+ содержимом ответа списка прогонов и о регистре query-параметров — выводы из
782
+ OpenAPI-спеки официального клиента, а не измерения живой инсталляции
783
+ (Cloud и on-prem). Список вопросов — в спецификации.
784
+ - **Кэш, circuit breaker, семантический индекс и webhooks**: не реализованы;
785
+ кэша нет вовсе, поэтому и межпользовательской утечки через него быть не
786
+ может.
787
+
788
+ ## Сервисные токены (managed service credentials)
789
+
790
+ Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у всех семи интеграций; классификация service-safe операций у каждой своя, и чувствительные чтения каждого провайдера перечислены в его разделе.
791
+
792
+ ```yaml
793
+ managedServiceCredentials:
794
+ enabled: true
795
+ defaultForNewConnections: true
796
+ profiles:
797
+ - id: gitlab-corp-readonly
798
+ provider: gitlab
799
+ instance: corp # id из gitlab.instances
800
+ label: QA GitLab Read-only # псевдоним, который видит пользователь
801
+ credential:
802
+ type: pat
803
+ secretFile: /run/secrets/qa_gitlab_service_token
804
+ resources:
805
+ projects:
806
+ - "1208"
807
+ - group/product
808
+ groups:
809
+ - group/platform
810
+ policy:
811
+ gitlab.issues.read: deny # только сужение; "allow" отвергается при загрузке
812
+ - id: teamcity-readonly
813
+ provider: teamcity
814
+ instance: teamcity # сервер TeamCity один, id фиксирован
815
+ label: QA TeamCity Read-only
816
+ credential:
817
+ type: personal_access_token
818
+ secretEnv: QA_TEAMCITY_SERVICE_TOKEN
819
+ resources:
820
+ projects:
821
+ - PLATFORM
822
+ ```
823
+
824
+ `enabled` по умолчанию `false`: пока развёртывание не включило срез, о сервисном токене нет ни строчки — ни чекбокса в форме подключения, ни профилей, ни нового поведения. `defaultForNewConnections` решает, с какого режима начинается новое подключение. `resources` обязателен и проверяется при загрузке: профиль без границы — это общий аккаунт, который видит всё, что видит его владелец, и ровно этого возможность не допускает. Записи `resources` — те идентификаторы, которые принимает сам провайдер, и словарь границы у каждого свой: `projects` (id проекта GitLab или полный путь, путь группы, id проекта TeamCity, Jira и Test IT, слаг проекта Weblate), `spaces` (ключи пространств Confluence) и `portals` (хост портала Bitrix24 — единственная граница, потому что Bitrix24 не дробит доступ по проектам). Секрет берётся из смонтированного файла (`secretFile`) или из переменной окружения (`secretEnv`) — ровно один из двух, в YAML он не лежит; у Bitrix24 секрет — полный URL сервисного входящего вебхука, портал брокер выводит из него сам. Опечатка в профиле роняет загрузку конфига, а не выбрасывает профиль молча: сообщение называет профиль или инстанс и говорит, что именно не так, — неизвестный провайдер, неизвестный инстанс, инстанс, занятый двумя профилями, или `resources`, не назвавший ни одного вида ресурсов.
825
+
826
+ Новое подключение начинается на сервисном токене, когда профиль для выбранного инстанса есть и `defaultForNewConnections` включён (по умолчанию так): чекбокс «Использовать сервисный токен» в форме уже отмечен, поля токена нет вовсе, а кнопка называется «Подключить сервисный токен». Снятая галочка возвращает обычную форму с personal access token. У уже существующих подключений режим не меняется: он хранится в самом подключении, поэтому обновление стенда не переводит пользователя на общий аккаунт само. В подключённой карточке режим виден строкой «Сервисный аккаунт · управляется администратором», а рядом — «Изменить доступ» и «Использовать личный аккаунт».
827
+
828
+ Сервисный режим — не «read-only вообще», а жёсткий потолок: только `read`, только обычная чувствительность и только операции, которые провайдер пометил service-safe намеренно. Запись, админ-действия, управление правами и токенами и произвольный REST недостижимы, даже если сервисный токен наверху это умеет: классификация операции — свойство каталога провайдера, а не прав токена. Чувствительные чтения остаются личными: через общий аккаунт не читаются лог CI-джоба GitLab (`ci.logs.read`), лог сборки TeamCity (`logs.read`) и текст артефакта (`artifacts.read`), тело вложения Test IT и Confluence, содержимое Диска Bitrix24, переписки и открытые линии Bitrix24, календарь занятости и справочник сотрудников с телефонами, а конфиденциальная задача GitLab не возвращается вовсе — прямое чтение отвечает `ResourceNotFound`, из выдачи и из поиска она выпадает, а поиск по комментариям (`scope: notes`) отказывается целиком: у комментария нет признака конфиденциальности, и проверить его родителя одним запросом нельзя. У Weblate, где нет операций уровня журналов, чувствительных чтений нет вовсе. Операция, которую провайдер не классифицировал, отклоняется по умолчанию: инструмент, добавленный обновлением провайдера, недостижим через общий аккаунт, пока кто-то не классифицирует его намеренно. Администраторская `policy` может только выключить: `allow` в профиле отвергается при загрузке, потому что оператор, написавший `allow`, считает, что расширил потолок.
829
+
830
+ Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с allowlist каждый вызов: проект, названный по id или по пути, должен быть в списке или под перечисленной группой; сборка TeamCity, названная по id, сначала разрешается в свой проект; страница Confluence, названная по id, — в своё пространство; задача Jira и запись Test IT — в свой проект; компонент Weblate — в свой проект-слаг; вебхук Bitrix24 обязан отвечать на портале, названном в границе, — других идентификаторов у границы этого провайдера нет. Листинг, не называющий ресурс, отказывается, а не отвечает всей картиной, доступной общему аккаунту. Списки (`gitlab_projects_list`, `teamcity_projects`, `projects.list` Weblate, `projects.list` Test IT) собираются из allowlist, а не из того, что видит сервисный токен: ресурс, которого токен не видит, приходит в `unavailableResources`, а не исчезает молча, — это и есть ответ оператору, что граница и токен разошлись. Разворачивая группу GitLab, провайдер просит только её собственные проекты (`with_shared=false`) и дополнительно сверяет каждый вернувшийся проект с границей: чужой проект, расшаренный в группу, в выдачу не попадает. Пользователь может сузить список в карточке кнопкой «Изменить доступ», но не расширить: выбор вне администраторского списка отбрасывается и не сохраняется.
831
+
832
+ Режим — одно из двух явных значений, `personal` или `service`; `auto` не существует. Отказ в личном режиме (`403` от GitLab или TeamCity) — это отказ: его не повторяют сервисным токеном, и наоборот тоже. Если личный токен был сохранён раньше, он остаётся зашифрованным в хранилище, но не тратится, пока подключение работает на сервисном; «Использовать личный аккаунт» возвращает его, а если личного токена не сохраняли, переключение отвечает `PersonalCredentialRequired` вместо подключения без личности. Переключение в любую сторону поднимает binding revision, поэтому всё, что было выведено из прежней личности, с этого момента недействительно.
833
+
834
+ Секрет читается лениво, из файла или из переменной окружения, и кэшируется по отпечатку: ротация смонтированного секрета действует со следующего вызова — никому не нужно переподключаться и хост не нужно перезапускать, а содержимое секрета хешируется в ревизию credential. Сам секрет не пишется в лог, не возвращается в браузер и не рендерится: карточка показывает администраторский псевдоним профиля. Пропавший или пустой секрет — `ServiceCredentialUnavailable` (профиль не обслуживает ничего, пока файл не появится), не подходящий провайдеру — `ServiceCredentialInvalid`, выключенный профиль — `ServiceCredentialDisabled`. Проверка подключения читает вердикт пробы: истёкший или отозванный токен переводит подключение в «нужна проверка» и отвечает отказом, а слишком широкий токен (`ServiceCredentialUnsafeScope`) подключение не ломает — потолок режима уже ограничивает доступ, — но карточка о нём говорит, потому что сузить токен может только оператор. Остальные отказы карточка переводит на человеческий: `ServiceResourceNotAllowed` — «сузьте доступ в списке или подключите личный аккаунт», `SensitiveReadRequiresPersonalCredential` — «нужен личный аккаунт», `OperationNotAllowedWithServiceCredential` — «сервисный режим только для безопасного чтения».
835
+
836
+ Аудит в сервисном режиме — единственная запись о том, кто на самом деле спросил: наверху виден только сервисный аккаунт, поэтому каждая строка журнала хранит аутентифицированного пользователя QA, провайдера, операцию, `credential_source` и id профиля. Пишутся и отказы — по потолку и по границе, — иначе запрос, который upstream не может отличить от чужого, не оставил бы следа. Секрет не попадает ни в журнал, ни в результат инструмента.
837
+
838
+ Rate limiting по principal и по credential не реализован; межвызовных кэшей результатов в плагине нет ни у одного провайдера, поэтому переключение режимов не может отдать устаревшие данные.
839
+
488
840
  ## Граница доверия
489
841
 
490
842
  Интеграционный principal получается только из QA Surface:
@@ -494,11 +846,40 @@ OAuth-приложение для Jira не нужно: подключение
494
846
  3. интеграционный principal закрепляется только если текущий пользователь и владелец совпадают;
495
847
  4. администраторский просмотр чужого чата, неаттестованная сессия и subagent не получают principal;
496
848
  5. broker находит подключение по паре `ownerUserId + provider` и только внутри себя расшифровывает credential;
497
- 6. адрес внешнего сервиса приходит только из конфига оператора: у GitLab, Jira и Confluence это выбранный сайт из списка инстансов, у Bitrix24 — проверенный по доменному allowlist URL вебхука, у TeamCity — адрес, проверенный по политике стенда (и при сохранении, и на каждом вызове);
498
- 7. у Jira модели не достаётся и язык запросов: JQL собирается из типизированных аргументов внутри провайдера, а значения экранируются как строковые литералы;
499
- 8. справочник пользователей Jira читается только для того, чтобы превратить имя из фильтра в accountId: ответ справочника не попадает ни в результат тула, ни в лог, а неоднозначное имя — отказ, а не выбор человека за пользователя.
849
+ 6. адрес внешнего сервиса приходит только из конфига оператора: у GitLab, Jira, Confluence, Test IT и Weblate это выбранная инсталляция из списка оператора, у Bitrix24 — проверенный по доменному allowlist URL вебхука, у TeamCity — адрес, проверенный по политике стенда (и при сохранении, и на каждом вызове);
850
+ 7. у Jira модели не достаётся и язык запросов: JQL собирается из типизированных аргументов внутри провайдера, а значения экранируются как строковые литералы; у Weblate так же собирается `q`, и `next`-ссылка разбирается на номер страницы, а не берётся как адрес следующего запроса;
851
+ 8. справочник пользователей Jira читается только для того, чтобы превратить имя из фильтра в accountId: ответ справочника не попадает ни в результат тула, ни в лог, а неоднозначное имя — отказ, а не выбор человека за пользователя;
852
+ 9. в сервисном режиме личность на стороне провайдера принадлежит развёртыванию, а не пользователю: подключение тратит один общий read-only аккаунт, и ни один запрос не уходит от имени вошедшего;
853
+ 10. локальный audit — единственная запись о том, кто спросил на самом деле: upstream видит только сервисный аккаунт, поэтому строка журнала хранит владельца подключения, provider, operation, `credential_source` и id сервисного профиля;
854
+ 11. неявного отката нет ни в одну сторону: сервисный режим не подменяет личный после отказа и наоборот, а переключение режима поднимает binding revision и обесценивает всё, что было выведено из прежней личности.
855
+
856
+ В логах и audit сохраняются provider, operation, result и source session id; в audit к этому добавлены владелец подключения, `credential_source` и id сервисного профиля — у личного подключения это `personal` и `null`. Тела CRM/чатов, HTTP-заголовки и секреты не журналируются. Постоянный cache данных провайдера отсутствует, поэтому и смена режима не может отдать данные, прочитанные под прежней личностью.
500
857
 
501
- В логах и audit сохраняются только provider, operation, result и source session id. Тела CRM/чатов, HTTP-заголовки и секреты не журналируются. Постоянный cache данных провайдера отсутствует.
858
+ ## Подсказки к credential
859
+
860
+ Рядом с полем секрета карточка показывает, откуда этот секрет берётся: где его выпускают, какая документация описывает авторизацию, какие права нужны и что именно вставлять в поле. Текст раскрывается по клику в панель, а не занимает карточку целиком; формулировка зависит от механизма — «Создать API-ключ», «Создать токен», «Войти и авторизовать», «Как это настроить» для подключения без страницы выдачи (вебхук Bitrix24).
861
+
862
+ Подсказка — это метаданные, а не секрет. В ней нет ни значения credential, ни его снимка, ни результата авторизации; браузер получает её тем же RPC `qaIntegrations/providers`, что и список провайдеров, уже после входа в QA-аккаунт. Она не является зависимостью подключения: если метаданных нет, карточка показывает обычное поле секрета, а сломавшаяся ссылка не мешает ни сохранить, ни проверить credential.
863
+
864
+ Метаданные объявлены рядом с провайдером — `src/providers/<id>/credential-help.ts` — и не хранятся центральным списком, поэтому новая интеграция приносит свою подсказку вместе с собой. Ссылки проверяются по форме, без обращения к сети: допускаются только `https:` и — для локальных, приватных и self-hosted адресов — `http:`; `javascript:`, `data:`, `file:` и адрес с credential внутри отклоняются, а внешние ссылки открываются с `noopener noreferrer`.
865
+
866
+ Развёртывание может заменить подсказку целиком или по полям: корпоративный GitLab, Jira Data Center, внутренняя вики и прокси-шлюзы попадают в тот же UI, что и облачные сервисы.
867
+
868
+ ```yaml
869
+ credentialHelp:
870
+ gitlab:
871
+ obtainUrl: https://gitlab.example.internal/-/user_settings/personal_access_tokens
872
+ obtainLabel: Выпустить токен
873
+ docsUrl: https://wiki.example.internal/dsh/gitlab
874
+ instructions: Откройте внутреннюю страницу токенов.
875
+ selfHosted: true
876
+ jira:
877
+ enabled: false # спрятать подсказку; поле секрета остаётся
878
+ weblate:
879
+ docsLabel: Наша вики
880
+ ```
881
+
882
+ Оверрайд действует на всю инсталляцию и не меняет сам механизм подключения: невалидный адрес скрывает только свою ссылку, а в лог при старте попадает предупреждение `credential-help.override` с именем провайдера и поля. Неизвестный `kind` деградирует до `custom`, а не ломает провайдера. Значения по умолчанию для каждого провайдера и порядок добавления новой подсказки — в [src/providers/README.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/src/providers/README.md).
502
883
 
503
884
  ## Подготовка master key
504
885
 
@@ -543,6 +924,40 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
543
924
  - .bitrix24.ru
544
925
  - .bitrix24.com
545
926
  - .bitrix24.eu
927
+ credentialHelp:
928
+ gitlab:
929
+ obtainUrl: https://gitlab.example.internal/-/user_settings/personal_access_tokens
930
+ docsUrl: https://wiki.example.internal/dsh/gitlab
931
+ selfHosted: true
932
+ managedServiceCredentials:
933
+ enabled: true
934
+ defaultForNewConnections: true
935
+ profiles:
936
+ - id: gitlab-corp-readonly
937
+ provider: gitlab
938
+ instance: corp
939
+ label: QA GitLab Read-only
940
+ credential:
941
+ type: pat
942
+ secretFile: /run/secrets/qa_gitlab_service_token
943
+ resources:
944
+ projects:
945
+ - "1208"
946
+ - group/product
947
+ groups:
948
+ - group/platform
949
+ policy:
950
+ gitlab.issues.read: deny
951
+ - id: teamcity-readonly
952
+ provider: teamcity
953
+ instance: teamcity
954
+ label: QA TeamCity Read-only
955
+ credential:
956
+ type: personal_access_token
957
+ secretEnv: QA_TEAMCITY_SERVICE_TOKEN
958
+ resources:
959
+ projects:
960
+ - PLATFORM
546
961
  bitrix24:
547
962
  enabled: true
548
963
  crmRead: true
@@ -559,6 +974,9 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
559
974
  - id: gitlab-com
560
975
  label: GitLab.com
561
976
  baseUrl: https://gitlab.com
977
+ - id: corp
978
+ label: Corporate GitLab
979
+ baseUrl: https://gitlab.example.internal
562
980
  confluence:
563
981
  enabled: true
564
982
  instances:
@@ -583,9 +1001,23 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
583
1001
  - id: company
584
1002
  label: company.atlassian.net
585
1003
  baseUrl: https://company.atlassian.net
1004
+ testit:
1005
+ enabled: true
1006
+ instances:
1007
+ - id: cloud
1008
+ label: Test IT Cloud
1009
+ baseUrl: https://team.example.testit.software
1010
+ weblate:
1011
+ enabled: true
1012
+ instances:
1013
+ - id: corp
1014
+ label: Corporate Weblate
1015
+ baseUrl: https://weblate.example.com
586
1016
  ```
587
1017
 
588
- `dataPath` по умолчанию — `$DSH_HOME/qa-integrations.db` (база SQLite). Прежний файл `qa-integrations.json`, оставшийся от релиза до 0.5.0, переносится при первом запуске и переименовывается в `qa-integrations.json.migrated-<ISO>`. На Unix новый файл создаётся с mode `0600`. Журнал обращений к сервисам хранится `auditRetentionDays` дней (по умолчанию 90; `0` — не ограничивать по возрасту) и в любом случае не длиннее 5000 записей. Разрешён только HTTPS URL вида `https://company.bitrix24.ru/rest/<user>/<secret>` без query, fragment, custom port или credentials в authority. Список доменных суффиксов задаётся оператором, а не пользователем.
1018
+ `dataPath` по умолчанию — `$DSH_HOME/qa-integrations.db` (база SQLite). Прежний файл `qa-integrations.json`, оставшийся от релиза до 0.5.0, переносится при первом запуске и переименовывается в `qa-integrations.json.migrated-<ISO>`. На Unix новый файл создаётся с mode `0600`. Журнал обращений к сервисам хранится `auditRetentionDays` дней (по умолчанию 90; `0` — не ограничивать по возрасту) и в любом случае не длиннее 5000 записей. Разрешён только HTTPS URL вида `https://company.bitrix24.ru/rest/<user>/<secret>` без query, fragment, custom port или credentials в authority. Список доменных суффиксов задаётся оператором, а не пользователем. `credentialHelp.<provider>` заменяет подсказки к полю секрета — адреса выдачи, ссылки на документацию, инструкции и список прав; на хранение, шифрование и проверку credential он не влияет.
1019
+
1020
+ `managedServiceCredentials` — срез, которого нет, пока `enabled: false` (значение по умолчанию): `defaultForNewConnections` решает, начинается ли новое подключение на сервисном токене, а каждый профиль связывает провайдера и его инстанс с секретом общего аккаунта (`secretFile` или `secretEnv`, ровно один из двух) и обязательной границей `resources`, внутри которой `policy` может только выключать операции. Провайдер и инстанс в профиле должны существовать в этом же конфиге, иначе загрузка падает, а сообщение называет профиль или инстанс. Правила и границы режима — в разделе «Сервисные токены (managed service credentials)».
589
1021
 
590
1022
  ## Пользовательский сценарий
591
1023
 
@@ -604,7 +1036,11 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
604
1036
 
605
1037
  Для Confluence: оператор задаёт сайты (`confluence.instances`) и, если нужно, список разрешённых пространств, пользователь выпускает API token в своём профиле Atlassian и вводит его вместе с почтой аккаунта. Если сайт один, выбор не показывается; если сайтов нет, карточка говорит об этом и формы не показывает. Плагин прочитает `/wiki/rest/api/user/current`, покажет подключённый аккаунт, а список возможностей останется в границах, которые разрешил оператор: сам Confluence не сообщает, какие права выданы API token.
606
1038
 
607
- Отключение атомарно удаляет локальный encrypted secret; дальнейшие tool calls получают `IntegrationNotConnected`. Запись и generic REST/MCP вызовы отсутствуют. OAuth и confirmation-based writes намеренно остаются следующими фазами спецификации для всех провайдеров.
1039
+ Для Test IT: оператор перечисляет инсталляции (`testit.instances`), пользователь создаёт API-токен в своём профиле Test IT, выбирает инсталляцию (если их несколько) и вставляет токен. Плагин читает `GET /api/v2/projects` — документированный первый проверочный запрос: успешный ответ доказывает и адрес, и токен, а пустой список проектов остаётся валидным результатом. Имени аккаунта карточка не показывает: API v2 не сообщает владельца токена, поэтому подключение подписано инсталляцией и числом видимых проектов, а список возможностей остаётся в границах, которые разрешил оператор.
1040
+
1041
+ Для Weblate: оператор задаёт инстансы (`weblate.instances`), пользователь выпускает API-токен в своём профиле Weblate и выбирает инстанс, если их несколько. Если инстансов нет, карточка говорит об этом и формы не показывает. Аккаунт и вид токена плагин покажет по `GET /api/users/`: личный токен виден там одной своей строкой, а токен, который умеет перечислять пользователей, приносит полный список — тогда карточка называет инстанс и вид токена вместо угаданного имени. Список возможностей останется в границах, которые разрешил оператор: сам Weblate не сообщает, какие права выданы токену.
1042
+
1043
+ Отключение атомарно удаляет локальный encrypted secret; дальнейшие tool calls получают `IntegrationNotConnected`. Generic REST/MCP вызовы отсутствуют; запись — только единственный таймлайн-комментарий Bitrix24 за явным флагом, возможностью и политикой. OAuth и confirmation-based writes намеренно остаются следующими фазами спецификации для всех провайдеров.
608
1044
 
609
1045
  ## Проверка пакета
610
1046
 
@@ -612,6 +1048,4 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
612
1048
  pnpm --filter @yadsh/dsh-qa-integrations check
613
1049
  ```
614
1050
 
615
- Unit/integration набор проверяет AEAD, неверный ключ, rewrap, SSRF-ограничение webhook URL, адресов инстансов, политики адресов TeamCity и списка сайтов Jira, redaction (включая форму gitlab-токена и секреты, напечатанные в логе), escape locator-значений, нарезку и чистку логов, отказ по бинарным и архивным артефактам, отсутствие model-visible identity/secret selectors, отказ unowned/subagent-сессии, соответствие каждого tool операции каталога, read-only характер всех четырёх каталогов, сужение возможностей по scopes вебхука и токена, отображение ошибок GitLab, TeamCity и Jira в доменные коды, обрезку больших ответов и параллельную изоляцию Alice/Bob. Для Jira отдельно проверяются экранирование JQL (значение с кавычкой и `OR` остаётся значением), отказ поиска без фильтров, отказ имени там, где нужен accountId, allow-list читающих путей, рендер ADF в текст с сохранением структуры, отказ custom fields при выключенной схеме полей, потоковая отмена на не-Cloud сайт и то, что токен не попадает ни в URL, ни в результат тула. Отдельный гейт следит за границей провайдеров: `verify:package` падает, если в общем слое появится имя конкретной интеграции, а тест `provider boundary` — если брокер начнёт зависеть от Bitrix24.
616
-
617
- Unit/integration набор проверяет AEAD, неверный ключ, rewrap, SSRF-ограничение webhook URL, адресов инстансов и политики адресов TeamCity, redaction (включая форму gitlab-токена и секреты, напечатанные в логе), escape locator-значений, нарезку и чистку логов, отказ по бинарным и архивным артефактам, отсутствие model-visible identity/secret selectors, отказ unowned/subagent-сессии, соответствие каждого tool операции каталога, read-only характер всех четырёх каталогов, сужение возможностей по scopes вебхука и токена, отображение ошибок GitLab, TeamCity и Confluence в доменные коды, обрезку больших ответов и параллельную изоляцию Alice/Bob. Для Confluence отдельно проверяются сборка CQL с экранированием литералов, разбор Atlassian Document Format с плейсхолдерами для макросов и медиа, отказ в пространстве вне allowlist и на поиске, и на прямом чтении, вложение `untrustedContent` в ответы со страницами и комментариями, а также отказ токену, чей сайт убрали из конфига. Отдельный гейт следит за границей провайдеров: `verify:package` падает, если в общем слое появится имя конкретной интеграции, а тест `provider boundary` — если брокер начнёт зависеть от Bitrix24. Собранный клиентский бандл проверяется отдельным тестом: он поднимается в песочнице как в браузере — через `window.__ModuleLoader__` с таблицей модулей, в которой есть только React, — регистрируется под полным именем пакета и монтирует карточку Confluence из секции, которую сам зарегистрировал.
1051
+ Unit/integration набор проверяет AEAD, неверный ключ, rewrap, SSRF-ограничение webhook URL, адресов инстансов, политики адресов TeamCity, списка сайтов Jira, инсталляций Test IT и инстансов Weblate, redaction (включая форму gitlab-токена и секреты, напечатанные в логе), escape locator-значений, нарезку и чистку логов, отказ по бинарным и архивным артефактам, отсутствие model-visible identity/secret selectors, отказ unowned/subagent-сессии, соответствие каждого tool операции каталога, read-only характер всех семи каталогов за исключением единственного флагуемого таймлайн-комментария Bitrix24, привязка любой write-методы к `crm.comment.write`, сужение возможностей по scopes вебхука и токена, потолок и границу сервисного токена (включая конфигурацию профилей, отсутствие неявного отката между режимами, ротацию секрета под работающим подключением и аудит реального пользователя), отображение ошибок провайдеров в доменные коды, обрезку больших ответов и параллельную изоляцию Alice/Bob. Для Jira отдельно проверяются экранирование JQL, отказ поиска без фильтров, allow-list читающих путей, рендер ADF и то, что токен не попадает ни в URL, ни в результат тула. Для Confluence — сборка CQL, разбор Atlassian Document Format, политика пространств и отказ токену, чей сайт убрали из конфига. Для Test IT — канонизация списка инсталляций, проба подключения документированным запросом, только-GET каталог, лимиты страниц и вложений, redaction текстовых вложений и отсутствие токена в URL и теле. Для Weblate — сборка `q` с экранированием значений, отказ неподдерживаемым фильтрам и операциям, проверка origin у `next`, нормализация состояний и форм множественного числа, untrusted-маркер и отказ credential, чей инстанс убрали из конфига. Отдельный гейт следит за границей провайдеров: `verify:package` падает, если в общем слое появится имя конкретной интеграции, а тест `provider boundary` — если брокер начнёт зависеть от конкретного провайдера. Собранный клиентский бандл проверяется отдельным тестом: он поднимается в песочнице как в браузере — через `window.__ModuleLoader__` с таблицей модулей, в которой есть только React, — регистрируется под полным именем пакета и монтирует карточку Confluence из секции, которую сам зарегистрировал.