@yadsh/dsh-qa-integrations 0.6.0 → 0.8.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 (183) hide show
  1. package/README.md +341 -303
  2. package/lib/broker.js +12 -0
  3. package/lib/broker.js.map +1 -1
  4. package/lib/client/bitrix24.js +66 -5
  5. package/lib/client/bitrix24.js.map +1 -1
  6. package/lib/client/confluence.js +117 -128
  7. package/lib/client/confluence.js.map +1 -1
  8. package/lib/client/gitlab.js +1 -1
  9. package/lib/client/gitlab.js.map +1 -1
  10. package/lib/client/index.js +25 -5
  11. package/lib/client/index.js.map +1 -1
  12. package/lib/client/integrations.js +1 -1
  13. package/lib/client/integrations.js.map +1 -1
  14. package/lib/client/jira.js +115 -126
  15. package/lib/client/jira.js.map +1 -1
  16. package/lib/client/operator-card.js +537 -0
  17. package/lib/client/operator-card.js.map +1 -0
  18. package/lib/client/operator-controls.js +232 -0
  19. package/lib/client/operator-controls.js.map +1 -0
  20. package/lib/client/styles.js +60 -0
  21. package/lib/client/styles.js.map +1 -1
  22. package/lib/client/testit.js +39 -3
  23. package/lib/client/testit.js.map +1 -1
  24. package/lib/client/weblate.js +38 -3
  25. package/lib/client/weblate.js.map +1 -1
  26. package/lib/client.js +2966 -871
  27. package/lib/client.js.map +1 -1
  28. package/lib/coerce.js +17 -1
  29. package/lib/coerce.js.map +1 -1
  30. package/lib/config.js.map +1 -1
  31. package/lib/errors.js +22 -0
  32. package/lib/errors.js.map +1 -1
  33. package/lib/index.js +211 -52
  34. package/lib/index.js.map +1 -1
  35. package/lib/providers/bitrix24/catalog.js +138 -8
  36. package/lib/providers/bitrix24/catalog.js.map +1 -1
  37. package/lib/providers/bitrix24/config.js +84 -14
  38. package/lib/providers/bitrix24/config.js.map +1 -1
  39. package/lib/providers/bitrix24/index.js +100 -0
  40. package/lib/providers/bitrix24/index.js.map +1 -1
  41. package/lib/providers/bitrix24/operations.js +5 -9
  42. package/lib/providers/bitrix24/operations.js.map +1 -1
  43. package/lib/providers/bitrix24/transport.js +11 -31
  44. package/lib/providers/bitrix24/transport.js.map +1 -1
  45. package/lib/providers/confluence/adf.js +28 -23
  46. package/lib/providers/confluence/adf.js.map +1 -1
  47. package/lib/providers/confluence/catalog.js +91 -7
  48. package/lib/providers/confluence/catalog.js.map +1 -1
  49. package/lib/providers/confluence/config.js +27 -2
  50. package/lib/providers/confluence/config.js.map +1 -1
  51. package/lib/providers/confluence/credential-help.js +14 -8
  52. package/lib/providers/confluence/credential-help.js.map +1 -1
  53. package/lib/providers/confluence/dialect.js +215 -0
  54. package/lib/providers/confluence/dialect.js.map +1 -0
  55. package/lib/providers/confluence/index.js +393 -79
  56. package/lib/providers/confluence/index.js.map +1 -1
  57. package/lib/providers/confluence/operations.js +208 -153
  58. package/lib/providers/confluence/operations.js.map +1 -1
  59. package/lib/providers/confluence/storage.js +690 -0
  60. package/lib/providers/confluence/storage.js.map +1 -0
  61. package/lib/providers/confluence/transport.js +26 -89
  62. package/lib/providers/confluence/transport.js.map +1 -1
  63. package/lib/providers/gitlab/config.js +2 -3
  64. package/lib/providers/gitlab/config.js.map +1 -1
  65. package/lib/providers/gitlab/index.js +2 -20
  66. package/lib/providers/gitlab/index.js.map +1 -1
  67. package/lib/providers/gitlab/operations.js +7 -45
  68. package/lib/providers/gitlab/operations.js.map +1 -1
  69. package/lib/providers/gitlab/transport.js +2 -18
  70. package/lib/providers/gitlab/transport.js.map +1 -1
  71. package/lib/providers/jira/adf.js +19 -14
  72. package/lib/providers/jira/adf.js.map +1 -1
  73. package/lib/providers/jira/catalog.js +125 -4
  74. package/lib/providers/jira/catalog.js.map +1 -1
  75. package/lib/providers/jira/config.js +27 -2
  76. package/lib/providers/jira/config.js.map +1 -1
  77. package/lib/providers/jira/credential-help.js +16 -7
  78. package/lib/providers/jira/credential-help.js.map +1 -1
  79. package/lib/providers/jira/dialect.js +94 -0
  80. package/lib/providers/jira/dialect.js.map +1 -0
  81. package/lib/providers/jira/index.js +327 -67
  82. package/lib/providers/jira/index.js.map +1 -1
  83. package/lib/providers/jira/jql.js +54 -21
  84. package/lib/providers/jira/jql.js.map +1 -1
  85. package/lib/providers/jira/operations.js +77 -55
  86. package/lib/providers/jira/operations.js.map +1 -1
  87. package/lib/providers/jira/tools.js +1 -1
  88. package/lib/providers/jira/tools.js.map +1 -1
  89. package/lib/providers/jira/transport.js +12 -83
  90. package/lib/providers/jira/transport.js.map +1 -1
  91. package/lib/providers/shared/health.js +31 -0
  92. package/lib/providers/shared/health.js.map +1 -0
  93. package/lib/providers/shared/http.js +20 -0
  94. package/lib/providers/shared/http.js.map +1 -1
  95. package/lib/providers/shared/paths.js +14 -0
  96. package/lib/providers/shared/paths.js.map +1 -0
  97. package/lib/providers/shared/payload.js +46 -0
  98. package/lib/providers/shared/payload.js.map +1 -0
  99. package/lib/providers/teamcity/artifacts.js +0 -8
  100. package/lib/providers/teamcity/artifacts.js.map +1 -1
  101. package/lib/providers/teamcity/config.js +2 -3
  102. package/lib/providers/teamcity/config.js.map +1 -1
  103. package/lib/providers/teamcity/index.js +2 -20
  104. package/lib/providers/teamcity/index.js.map +1 -1
  105. package/lib/providers/teamcity/operations.js +5 -39
  106. package/lib/providers/teamcity/operations.js.map +1 -1
  107. package/lib/providers/teamcity/transport.js +2 -11
  108. package/lib/providers/teamcity/transport.js.map +1 -1
  109. package/lib/providers/testit/catalog.js +77 -0
  110. package/lib/providers/testit/catalog.js.map +1 -1
  111. package/lib/providers/testit/config.js +2 -3
  112. package/lib/providers/testit/config.js.map +1 -1
  113. package/lib/providers/testit/index.js +260 -4
  114. package/lib/providers/testit/index.js.map +1 -1
  115. package/lib/providers/testit/operations.js +34 -63
  116. package/lib/providers/testit/operations.js.map +1 -1
  117. package/lib/providers/testit/transport.js +2 -18
  118. package/lib/providers/testit/transport.js.map +1 -1
  119. package/lib/providers/weblate/catalog.js +103 -9
  120. package/lib/providers/weblate/catalog.js.map +1 -1
  121. package/lib/providers/weblate/config.js +2 -3
  122. package/lib/providers/weblate/config.js.map +1 -1
  123. package/lib/providers/weblate/index.js +227 -6
  124. package/lib/providers/weblate/index.js.map +1 -1
  125. package/lib/providers/weblate/operations.js +3 -33
  126. package/lib/providers/weblate/operations.js.map +1 -1
  127. package/lib/providers/weblate/query.js +3 -6
  128. package/lib/providers/weblate/query.js.map +1 -1
  129. package/lib/providers/weblate/transport.js +2 -12
  130. package/lib/providers/weblate/transport.js.map +1 -1
  131. package/lib/service-credentials/config.js +2 -3
  132. package/lib/service-credentials/config.js.map +1 -1
  133. package/lib/shared/settings.js +14 -0
  134. package/lib/shared/settings.js.map +1 -0
  135. package/lib/typert.host.js +159 -60
  136. package/lib/typert.remote-client.d.ts +13 -11
  137. package/lib/typert.remote-client.js +98 -52
  138. package/lib/types/broker.d.ts +11 -3
  139. package/lib/types/client/bitrix24.d.ts +24 -2
  140. package/lib/types/client/confluence.d.ts +24 -4
  141. package/lib/types/client/index.d.ts +7 -6
  142. package/lib/types/client/integrations.d.ts +2 -2
  143. package/lib/types/client/jira.d.ts +25 -4
  144. package/lib/types/client/operator-card.d.ts +22 -0
  145. package/lib/types/client/operator-controls.d.ts +135 -0
  146. package/lib/types/client/testit.d.ts +14 -1
  147. package/lib/types/client/weblate.d.ts +14 -1
  148. package/lib/types/coerce.d.ts +14 -0
  149. package/lib/types/config.d.ts +4 -4
  150. package/lib/types/errors.d.ts +16 -0
  151. package/lib/types/index.d.ts +91 -15
  152. package/lib/types/providers/bitrix24/catalog.d.ts +8 -0
  153. package/lib/types/providers/bitrix24/config.d.ts +14 -23
  154. package/lib/types/providers/bitrix24/index.d.ts +37 -1
  155. package/lib/types/providers/confluence/catalog.d.ts +44 -8
  156. package/lib/types/providers/confluence/config.d.ts +39 -7
  157. package/lib/types/providers/confluence/credential-help.d.ts +9 -4
  158. package/lib/types/providers/confluence/dialect.d.ts +113 -0
  159. package/lib/types/providers/confluence/index.d.ts +82 -8
  160. package/lib/types/providers/confluence/operations.d.ts +14 -4
  161. package/lib/types/providers/confluence/storage.d.ts +28 -0
  162. package/lib/types/providers/confluence/transport.d.ts +10 -21
  163. package/lib/types/providers/jira/catalog.d.ts +49 -2
  164. package/lib/types/providers/jira/config.d.ts +37 -6
  165. package/lib/types/providers/jira/credential-help.d.ts +11 -3
  166. package/lib/types/providers/jira/dialect.d.ts +79 -0
  167. package/lib/types/providers/jira/index.d.ts +76 -19
  168. package/lib/types/providers/jira/jql.d.ts +14 -4
  169. package/lib/types/providers/jira/operations.d.ts +3 -0
  170. package/lib/types/providers/jira/transport.d.ts +6 -13
  171. package/lib/types/providers/shared/health.d.ts +18 -0
  172. package/lib/types/providers/shared/http.d.ts +9 -0
  173. package/lib/types/providers/shared/paths.d.ts +10 -0
  174. package/lib/types/providers/shared/payload.d.ts +26 -0
  175. package/lib/types/providers/teamcity/artifacts.d.ts +0 -2
  176. package/lib/types/providers/teamcity/index.d.ts +2 -0
  177. package/lib/types/providers/testit/catalog.d.ts +12 -0
  178. package/lib/types/providers/testit/index.d.ts +63 -2
  179. package/lib/types/providers/weblate/catalog.d.ts +19 -2
  180. package/lib/types/providers/weblate/index.d.ts +43 -1
  181. package/lib/types/shared/settings.d.ts +14 -0
  182. package/lib/types/types.d.ts +8 -0
  183. package/package.json +3 -3
package/README.md CHANGED
@@ -1,9 +1,19 @@
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, Test IT — через API-токен системы управления тестированием, а Weblate — через API-токен платформы локализации, после чего даёт агенту набор read-only инструментов, ограниченный и правами подключения, и персональной политикой пользователя; единственное исключение — комментарий в таймлайн Bitrix24, который монтируется только явным флагом оператора. У GitLab и TeamCity подключение может работать не только от личного токена, но и от сервисного токена развёртывания — общего 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
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
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-провайдера плагин ведёт себя как раньше и грузится от композиционной строки.
16
+
7
17
  ## Структура
8
18
 
9
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).
@@ -12,98 +22,98 @@
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` | Содержимое папки Диска |
71
81
 
72
82
  Запись (по умолчанию выключена оператором `bitrix24.crmCommentWrite`):
73
83
 
74
- | Tool | Что делает |
75
- | --- | --- |
84
+ | Tool | Что делает |
85
+ | --------------------------------- | ------------------------------------------------------------------------------------------------------------- |
76
86
  | `bitrix_add_crm_timeline_comment` | Один комментарий в таймлайн лида, сделки, контакта или компании; единственная операция записи во всём плагине |
77
87
 
78
88
  Списочные инструменты отвечают единым конвертом `{ items, pagination }`: у модели одна форма ответа вместо шести разных у REST, а курсор следующей страницы не теряется. Методы, возвращающие словари по id (история открытой линии, занятость), спроецированы в упорядоченные массивы.
79
89
 
80
90
  ## Инструменты GitLab
81
91
 
82
- | Tool | Что делает |
83
- | --- | --- |
84
- | `gitlab_connection_get` | К какому инстансу и каким пользователем подключён аккаунт |
85
- | `gitlab_projects_list` | Поиск проектов: путь, ветка по умолчанию, видимость |
86
- | `gitlab_project_get` | Карточка проекта: описание, namespace, даты |
87
- | `gitlab_repository_tree` | Содержимое каталогов на выбранном ref, постранично |
88
- | `gitlab_repository_file_get` | Текст файла с метаданными; бинарное и слишком большое — только метаданные |
89
- | `gitlab_commits_list` | Коммиты проекта, ветки или одного файла |
90
- | `gitlab_commit_get` | Один коммит: сообщение, автор, родители, объём изменений |
91
- | `gitlab_compare` | Сравнение двух refs: коммиты и изменённые файлы |
92
- | `gitlab_search` | Поиск по проектам, задачам, MR, коммитам, коду и комментариям |
93
- | `gitlab_issues_list` | Задачи по проекту, состоянию, автору, исполнителю, меткам, датам |
94
- | `gitlab_issue_get` | Карточка задачи: описание, веха, срок |
95
- | `gitlab_issue_notes_list` | Комментарии задачи, системные помечены |
96
- | `gitlab_merge_requests_list` | Merge requests по проекту, веткам, автору, ревьюеру, черновику |
97
- | `gitlab_merge_request_get` | Карточка MR: описание, ветки, статус слияния, конфликты |
98
- | `gitlab_merge_request_changes_get` | Изменённые файлы MR с диффами |
99
- | `gitlab_merge_request_discussions_list` | Обсуждения ревью и их разрешение |
100
- | `gitlab_merge_request_approvals_get` | Сколько одобрений нужно, сколько есть, кто одобрил |
101
- | `gitlab_merge_request_pipelines_list` | Пайплайны, привязанные к MR |
102
- | `gitlab_pipelines_list` | Пайплайны проекта по ветке, статусу, источнику, автору |
103
- | `gitlab_pipeline_get` | Один пайплайн: статус, длительности, покрытие |
104
- | `gitlab_pipeline_jobs_list` | Джобы пайплайна: стадия, статус, длительность |
105
- | `gitlab_job_get` | Одна джоба: причина падения, теги, список артефактов |
106
- | `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` | Лог джобы: ограничен по размеру и очищен от токенов |
107
117
 
108
118
  Списочные инструменты GitLab отвечают тем же конвертом `{ items, pagination }`; `pagination.nextPage` — это номер следующей страницы, а не подписанный курсор: состояние между вызовами не хранится, principal и права перепроверяются на каждом вызове.
109
119
 
@@ -111,59 +121,59 @@ CRM:
111
121
 
112
122
  ## Инструменты TeamCity
113
123
 
114
- | Tool | Что делает |
115
- | --- | --- |
124
+ | Tool | Что делает |
125
+ | ------------------------- | --------------------------------------------------------------------------------- |
116
126
  | `teamcity_connection_get` | К какому серверу TeamCity и каким пользователем подключён аккаунт, версия сервера |
117
- | `teamcity_projects` | Проекты: поиск по id и названию, дочерние проекты, архивные |
118
- | `teamcity_build_configs` | Конфигурации сборки: id, название, проект, пауза |
119
- | `teamcity_builds` | Поиск сборок по проекту, конфигурации, ветке, статусу, состоянию и датам |
120
- | `teamcity_build` | Одна сборка: состояние, статус и его текст, агент, кто запустил, времена |
121
- | `teamcity_build_changes` | Изменения в VCS, попавшие в сборку: ревизия, автор, дата, комментарий |
122
- | `teamcity_build_failures` | Почему упало: упавшие тесты и проблемы сборки одним ответом |
123
- | `teamcity_build_log` | Фрагмент лога сборки: конец, начало или строки по поиску |
124
- | `teamcity_queue` | Очередь сборки: что ждёт агента и на какой ветке |
125
- | `teamcity_investigations` | Расследования падений: состояние, ответственный, разрешение |
126
- | `teamcity_agents` | Агенты сборки: подключён, включён, авторизован |
127
- | `teamcity_artifacts` | Артефакты сборки: имя, путь, размер, время изменения |
128
- | `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` | Текст небольшого артефакта: отчёты тестов, лог-файлы |
129
139
 
130
140
  Списочные инструменты TeamCity отвечают конвертом `{ items, pagination }`, где `pagination.returned` — сколько строк вернулось, а `pagination.hasMore` — что сервер отдал не всё: инструмент никогда не ходит по `nextHref` сам, поэтому продолжение получается сужением фильтра, а не вторым запросом за спиной у модели. Лимит каждого списка задан спецификацией (сборки и очередь — 50, проекты, конфигурации, изменения, тесты, проблемы, расследования и агенты — 100, артефакты — 200) и не поднимается выше, сколько бы модель ни попросила.
131
141
 
132
142
  Лог сборки скачивается не больше, чем разрешает стенд (`maxLogBytes`, по умолчанию 256 КиБ), чистится от управляющих последовательностей терминала, проходит через редакцию секретов и режется до запрошенного числа строк (`maxLines`, максимум 1000). Ответ различает два случая: `truncated` — окно не покрыло запрошенные строки, `logTruncated` — сам лог длиннее скачанного куска, и тогда в режиме `tail` это конец скачанного, а не конец сборки. Артефакты читаются только текстовые: архивы, образы, бинарники, документы и ключи (`zip`, `jar`, `png`, `pdf`, `pem`, …) отказываются по имени до запроса, а бинарное тело отвечает метаданными с `binary: true` вместо содержимого. Логи и артефакты описаны модели как недоверенные данные: это текст из внешней системы, а не инструкция.
133
143
 
134
-
135
144
  ## Инструменты Jira
136
145
 
137
- | Tool | Что делает |
138
- | --- | --- |
139
- | `jira_get_current_user` | К какому сайту Jira и каким пользователем Atlassian подключён аккаунт |
140
- | `jira_search_issues` | Поиск задач: текст, проекты, типы, статусы и их категория, приоритеты, резолюции, компоненты, метки, версии (fix и affected), люди, даты, кастомные поля |
141
- | `jira_get_issue` | Карточка задачи: ключ, ссылка, проект, тип, статус, приоритет, люди, метки, компоненты, версии, резолюция, даты и описание |
142
- | `jira_get_issue_comments` | Комментарии задачи, от новых к старым; ограниченный комментарий помечен видимостью |
143
- | `jira_get_issue_attachments` | Метаданные вложений: имя файла, тип, размер, автор; файлы не скачиваются |
144
- | `jira_get_available_transitions` | Доступные переходы статуса и их обязательные поля; переход не выполняется |
145
- | `jira_get_project` | Карточка проекта: ключ, название, тип, руководитель, описание, ссылка |
146
- | `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-имена |
147
156
 
148
157
  Модель не получает JQL: фильтры в `jira_search_issues` типизированные, а строку запроса собирает и экранирует провайдер — значение с кавычкой или обратным слэшем остаётся значением и не может добавить условие. Поиск без единого фильтра отказывается: «все задачи сайта» — не вопрос, на который этот инструмент отвечает. Ответы идут по последнему обновлению (сначала свежие) и несут `pagination.nextCursor` — это continuation-токен самого Jira, состояние между вызовами не хранится, а страница не выходит за потолок стенда (`defaultSearchLimit`, `maxSearchLimit`) и за 100 строк, которые Jira отдаёт с полями. Комментарии Jira по-прежнему листаются позицией, поэтому их `pagination` — `{ startAt, returned, total, hasMore }`.
149
158
 
150
159
  Словарь фильтров покрывает то, что спрашивают у корпоративной Jira, и каждый фильтр — это клауза, которую собирает `jql.ts`: проект, тип задачи, статус и **категория статуса** (`To Do` / `In Progress` / `Done` — «закрытые» одним фильтром, чем бы ни называл их workflow), приоритет, резолюция, компонент, метки (все перечисленные, а не «любая из»), версии — `fixVersions` и `affectedVersions`, включая «не проставлена» (`fixVersionEmpty: true`) и «проставлена» (`false`), исполнитель и автор, даты создания и обновления в обе стороны, и кастомные поля. Даты принимают и абсолютное значение (`2026-08-01`, ISO-таймстемп), и родной относительный токен Jira (`-3w`, `-2d`, `-4h`, `-30m`), а пара «с/по» — это `createdAfter`/`createdBefore` (границы включительные). Текст ищется двумя способами: `match: "all"` (по умолчанию) требует все слова, `match: "phrase"` — точную фразу; оба варианта бьются на отдельные клаузы `text ~ "…"`, поэтому `OR` из фразы остаётся словом, а не оператором.
151
160
 
152
- Кастомные поля фильтруются **по 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, по которому построен запрос.
161
+ Кастомные поля фильтруются **по id**, который вернул `jira_get_fields`, или **по алиасу**, который объявил оператор стенда: `customFields: [{ field: "product", value: "…" }]`, с `match: "contains"` для текстовых полей и `empty: true`/`false` для пустого/заполненного. Имя поля Jira не принимается намеренно — на одном сайте легко живут несколько полей с одинаковым именем, а какой из них «продукт», знает только развёртывание: соответствие «алиас → `customfield_…`» задаётся в конфиге оператора (`jira.fieldAliases`), поэтому в репозитории нет ни одного id конкретного инстанса, а каталог полей (`jira_get_fields`) отдаёт объявленные алиасы вместе со схемой. Неизвестное имя — отказ со списком алиасов, а не пустая страница. Люди принимаются как `me`, как идентификатор, по которому фильтрует эта Jira (accountId у Cloud, логин у Server / Data Center), или как имя: имя провайдер разрешает через справочник сайта (`/rest/api/3/user/search` или `/rest/api/2/user/search`, не больше десяти совпадений) и подставляет этот идентификатор в запрос. Имя, которое никого не нашло, и имя, которое нашли несколько человек, — это отказ с подсказкой, а не пустая страница: «нет задач» и «фильтр не понят» — разные ответы. Ответ справочника модели не показывается, он только определяет id, по которому построен запрос.
153
162
 
154
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
+
155
165
  ## Инструменты Confluence
156
166
 
157
- | Tool | Что делает |
158
- | --- | --- |
159
- | `confluence_connection_get` | К какому сайту Confluence и каким аккаунтом Atlassian подключён пользователь |
160
- | `confluence_search` | Поиск страниц по тексту, пространствам, меткам, автору и дате изменения |
161
- | `confluence_get_page` | Страница целиком: заголовок, пространство, родитель, версия, метки и текст |
162
- | `confluence_get_page_comments` | Комментарии страницы: подвал, inline или оба, с ответами и статусом резолва |
163
- | `confluence_get_page_attachments` | Метаданные вложений: имя, тип, размер, версия, автор, ссылки |
164
- | `confluence_get_page_versions` | История версий: номер, автор, дата и комментарий к версии |
165
- | `confluence_get_space` | Пространство: ключ, имя, тип, статус, описание |
166
- | `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` | Пространства, доступные аккаунту, с ключами для поиска и чтения |
167
177
 
168
178
  Списочные инструменты Confluence отвечают конвертом `{ items, nextCursor }`: `nextCursor` — это значение, которое нужно вернуть в аргументе `cursor`, а не URL и не подписанный токен. У поиска это смещение строк (эндпоинт считает строки), у остальных чтений — курсор самого Confluence, из которого провайдер берёт только сам токен: путь и параметры следующего запроса он собирает сам, поэтому курсор не может увести запрос на чужой адрес. Комментарии с `kind: "all"` отвечают двумя курсорами (`cursors.footer` и `cursors.inline`), потому что продолжать их придётся по отдельности. `totalSize` у поиска говорит, сколько всего совпадений нашлось, — по нему модель понимает, стоит ли листать дальше.
169
179
 
@@ -173,27 +183,27 @@ CRM:
173
183
 
174
184
  ## Инструменты Weblate
175
185
 
176
- | Tool | Что делает |
177
- | --- | --- |
178
- | `weblate_connection_get` | К какому инстансу Weblate и каким аккаунтом подключён токен и личный он или проектный; сам токен не возвращается |
179
- | `weblate_projects_list` | Проекты, видимые аккаунту, постранично |
180
- | `weblate_project_get` | Один проект: слаг, имя, ссылка |
181
- | `weblate_project_statistics_get` | Готовность проекта: строки и слова переведены, требуют правки, не проходят проверки |
182
- | `weblate_components_list` | Компоненты проекта постранично |
183
- | `weblate_component_get` | Один компонент: слаг, имя, система контроля версий, ветка, формат файлов, исходный язык |
184
- | `weblate_component_statistics_get` | Готовность компонента по языкам |
185
- | `weblate_translations_list` | Языки компонента с их состоянием перевода |
186
- | `weblate_translation_get` | Один язык одного компонента целиком: переведено, требует правки, проверки, комментарии, предложения, автор последней правки |
187
- | `weblate_translation_statistics_get` | Статистика одного языка одного компонента |
188
- | `weblate_units_search` | Строки одного языка одного компонента с типизированными фильтрами |
189
- | `weblate_units_find` | Строка по всему, что видит аккаунт, с сужением по проекту, компоненту и языку |
190
- | `weblate_unit_get` | Одна строка целиком: все формы множественного числа исходника и перевода, состояние, контекст, заметка, метки, флаги, проверки |
191
- | `weblate_unit_comments_list` | Комментарии к строке: автор, время, текст |
192
- | `weblate_unit_suggestions_list` | Предложенные переводы строки: автор, голоса, время |
193
- | `weblate_failing_units_list` | Строки, у которых не проходит хотя бы одна проверка, с сужением по проекту, компоненту, языку, тексту и состоянию |
194
- | `weblate_changes_list` | Последние изменения проекта: какая строка, какой язык, что сделано, кем и когда |
195
- | `weblate_screenshots_list` | Скриншоты Weblate и строки, к которым они привязаны |
196
- | `weblate_screenshot_get` | Метаданные одного скриншота: имя, файл в репозитории, язык, id связанных строк |
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 связанных строк |
197
207
 
198
208
  Списочные инструменты Weblate отвечают конвертом `{ items, pagination }`: `pagination.nextPage` — номер следующей страницы, а не подписанный курсор. По ссылке `next` провайдер не ходит сам: Weblate кладёт в тело абсолютный адрес, из которого читается только номер страницы, и только когда он ведёт на настроенный инстанс — ссылка с чужого адреса отбрасывается, а список честно считается законченным. Страница — 20 строк по умолчанию, а `perPage` сверх потолка стенда (`maxPageSize`, по умолчанию 100) обрезается, а не отвергается: «дай больше строк» — это запрос, на который стенд отвечает своим потолком, а не ошибка, которую модель выясняет перебором. Состояние между вызовами не хранится, principal и права перепроверяются на каждом вызове.
199
209
 
@@ -207,42 +217,45 @@ CRM:
207
217
 
208
218
  Подключение — Atlassian API token вместе с почтой аккаунта Atlassian (Basic-пара). Возможность появляется у пользователя, если её включил оператор (`confluence.*Read`).
209
219
 
210
- | Возможность | Что открывает |
211
- | --- | --- |
212
- | `identity.read` | Сайт Confluence и подключённый аккаунт Atlassian |
213
- | `spaces.read` | Список пространств и карточка пространства |
214
- | `search.read` | Поиск страниц по тексту, пространствам, меткам, автору и дате |
215
- | `content.read` | Страница целиком с текстом, метками и версией |
216
- | `comments.read` | Комментарии страницы: подвал, inline и ответы |
217
- | `attachments.read` | Метаданные вложений страницы |
218
- | `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` | История версий страницы |
219
229
 
220
230
  Confluence, как и TeamCity, не сообщает через API, какие права выданы конкретному токену: у OAuth-приложений для этого есть `/oauth/token/accessible-resources`, а у API token аналога нет. Поэтому сужение идёт только по деплой-флагам оператора, а права аккаунта применяет сам Confluence — отказ приходит как `ProviderPermissionDenied`, и провайдер никогда не пробует другой credential.
221
231
 
222
232
  Оператор дополнительно может сузить **пространства**: `confluence.allowedSpaces` — это список ключей, и он применяется одинаково к поиску, к списку пространств и к прямому чтению страницы, комментариев, вложений и версий. Страница в пространстве вне списка отвечает отказом `OperationDeniedByPolicy`, а не тихо исчезает из выдачи; в поиск добавляется `space in (…)`, и строки, пространство которых по ответу не подтверждается, отбрасываются. Страница не несёт ключ пространства, только `spaceId`, поэтому каждое чтение страницы делает дополнительный запрос самого пространства — он же и наполняет ответ ключом и именем, и по нему принимается решение политики; чтения комментариев, вложений и версий с включённой политикой стоят ещё одного чтения страницы, чтобы узнать её пространство.
223
233
 
224
- Скопы, которые нужны токену: классические `read:confluence-content.all`, `read:confluence-space.summary`, `search:confluence`, `read:confluence-user` (или гранулярные `read:page:confluence`, `read:comment:confluence`, `read:attachment:confluence`, `read:space:confluence`, `read:content.metadata:confluence`, `read:user:confluence`). Классический токен работает по адресу сайта (`https://company.atlassian.net`); токен со скоупами Atlassian принимает только через шлюз `https://api.atlassian.com/ex/confluence/{cloudId}` — такой адрес оператор может задать как `instances[].baseUrl`, и провайдер будет ходить по тому же относительному пути `/wiki/...`. Сам cloudId провайдер не ищет.
234
+ Скопы, которые нужны токену: классические `read:confluence-content.all`, `read:confluence-space.summary`, `search:confluence`, `read:confluence-user` (или гранулярные `read:page:confluence`, `read:comment:confluence`, `read:attachment:confluence`, `read:space:confluence`, `read:content.metadata:confluence`, `read:user:confluence`). Классический токен работает по адресу сайта (`https://company.atlassian.net`); токен со скоупами Atlassian принимает только через шлюз `https://api.atlassian.com/ex/confluence/{cloudId}` — такой адрес оператор может задать как `instances[].baseUrl`, и провайдер будет ходить по тому же относительному пути `/wiki/...`. Сам cloudId провайдер не ищет. Для Server / Data Center скоупов и почты нет: там нужен личный токен доступа, а адрес инстанса задаётся вместе с его контекстным путём (`https://wiki.example.corp/confluence`).
225
235
 
226
236
  Запись в surface отсутствует: создание и правка страниц, комментарии, резолв inline-комментариев, вложения, перемещение и администрирование пространств ждут confirmation-фреймворка. Произвольного REST (`confluence_rest_call`), произвольного CQL и скачивания вложений тоже нет — только метаданные и ссылки, которые отдал сам Confluence.
227
237
 
238
+ ### Сервисный токен Confluence
239
+
240
+ Подключение может работать от сервисного токена развёртывания: профиль называет сайт, секрет — та же Basic-пара `email:token`, а граница ресурсов — `spaces` (ключи пространств). Чувствительных чтений в каталоге нет: поиск, пространства, страницы, комментарии, метаданные вложений и версии остаются сервисно-безопасными, но каталог не умеет отдавать байты вложений, и такая операция, когда появится, обязана прийти с классификацией не ниже чувствительной. Страница, названная по id, сначала раскрывается в своё пространство, поиск сужается до `space in (…)` по границе ещё на входе, а строки, пространство которых по ответу не подтверждается, отбрасываются вторым замком. Граница сервиса и операторский `confluence.allowedSpaces` — два независимых сужения: сервисный вызов живёт в их пересечении.
228
241
 
229
242
  ## Возможности и скопы Weblate
230
243
 
231
244
  Подключение — API-токен Weblate вместе с выбором инстанса: адреса задаёт только оператор (`weblate.instances`), пользователь выбирает инстанс из списка и вставляет токен. Возможность появляется у пользователя, если её включил оператор (`weblate.*Read`).
232
245
 
233
- | Возможность | Что открывает |
234
- | --- | --- |
235
- | `identity.read` | Инстанс Weblate, подключённый аккаунт и вид токена |
236
- | `projects.read` | Список проектов и карточка проекта |
237
- | `components.read` | Компоненты проекта и карточка компонента |
238
- | `translations.read` | Языки компонента и один язык целиком |
239
- | `units.read` | Поиск строк по тексту, контексту и состоянию, чтение одной строки |
240
- | `checks.read` | Строки, у которых не проходит хотя бы одна проверка |
241
- | `comments.read` | Комментарии к строке |
242
- | `suggestions.read` | Предложенные переводы строки |
243
- | `changes.read` | История изменений проекта |
244
- | `statistics.read` | Готовность проекта, компонента и языка |
245
- | `screenshots.read` | Метаданные скриншотов |
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` | Метаданные скриншотов |
246
259
 
247
260
  Weblate, как и TeamCity с Confluence, не сообщает через API, какие права выданы конкретному токену: токен действует от имени своего пользователя или своего проекта, а «проверить» чтением чужой области провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора (`weblate.*Read`), а права применяет сам Weblate — отказ приходит как `ProviderPermissionDenied`, и провайдер никогда не пробует другой credential. Каждая возможность при этом достижима хотя бы одной операцией, поэтому карточка не может показать переключатель, который ничего не делает.
248
261
 
@@ -252,41 +265,44 @@ Weblate, как и TeamCity с Confluence, не сообщает через API,
252
265
 
253
266
  Запись в surface отсутствует: предложения перевода, комментарии, правка и утверждение перевода, файлы перевода, autotranslate и операции с репозиторием ждут confirmation-фреймворка. Инструмента с произвольным `q` и произвольным REST тоже нет: поиск принимает только типизированные фильтры.
254
267
 
255
-
256
268
  ## Возможности и скопы
257
269
 
258
270
  Одна возможность = один scope Bitrix24. Возможность появляется у пользователя только если её включил оператор (`bitrix24.*Read`, у записи — `bitrix24.crmCommentWrite`) **и** подключённый вебхук реально получил соответствующий scope — плагин спрашивает это у портала методом `scope` при подключении и при нажатии «Проверить».
259
271
 
260
- | Возможность | Scope вебхука | Что открывает |
261
- | --- | --- | --- |
262
- | `crm.read` | `crm` | CRM, дела, таймлайн, товарные строки, дубли |
263
- | `crm.comment.write` | `crm` | Единственная операция записи: комментарий в таймлайн лида, сделки, контакта или компании |
264
- | `chat.read` | `im` | Чаты, сообщения, поиск по переписке |
265
- | `openlines.read` | `imopenlines` | Диалоги открытых линий и их история |
266
- | `user.read` | `user_brief` / `user_basic` / `user` | Свой профиль и поиск сотрудников |
267
- | `department.read` | `department` | Структура компании |
268
- | `tasks.read` | `task` | Задачи |
269
- | `calendar.read` | `calendar` | Календарь и занятость |
270
- | `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` | Файлы Диска |
271
283
 
272
284
  У Bitrix24 нет read-only scope вебхука: `crm` покрывает и чтение, и запись, поэтому гранулярность «запись отдельно» даёт только конфиг-флаг. `crm.comment.write` выключен по умолчанию; даже после включения флага операция стартует с политикой `deny`, пока пользователь (или оператор) явно её не разрешит, — проба scope сама по себе запись не открывает. Остальная запись (`*.add`, `*.update`, `*.delete`), бизнес-процессы, управление пользователями и generic REST/MCP в surface отсутствуют.
273
285
 
274
286
  Выданные в Bitrix24 права не отменяются: портал всё равно применяет права того пользователя, чей вебхук используется. Возможность, обнаруженная после выдачи нового scope, появляется в карточке выключенной — пользователь включает её сам.
275
287
 
288
+ ## Сервисный токен Bitrix24
289
+
290
+ Подключение может работать от сервисного вебхука развёртывания: профиль `managedServiceCredentials` называет портал (хост, в любом регистре — он сравнивается с хостом, который брокер выводит из URL вебхука), секретом служит полный URL сервисного входящего вебхука, а граница ресурсов — единственный вид `portals`: сервисный вызов обязан отвечать на портале из списка, других идентификаторов у границы нет. Проба (`validateServiceCredential`) читает только `profile` и `scope`; подтвердить read-only она не может — scope `crm` и читает, и пишет одним битом, — поэтому вердикт всегда «здоров» с предупреждением, а потолок режима обеспечивают классификация операций и граница. Сервисному токену недоступны по классификации: запись в таймлайн, справочник сотрудников (телефоны и почта), дубликаты по телефону и почте, расшифровки звонков, все чтения чатов и открытых линий, календарь занятости и Диск — это чтения, ответы которых принадлежат конкретным людям, а не порталу; CRM-записи, задачи и структура отделов остаются сервисно-безопасными.
291
+
276
292
  ## Возможности и скопы GitLab
277
293
 
278
294
  Подключение — personal access token. Возможность появляется у пользователя только если её включил оператор (`gitlab.*Read`) **и** токен при подключении реально предъявил соответствующий scope: плагин спрашивает scopes у самого токена (`GET /api/v4/personal_access_tokens/self`) при сохранении и при нажатии «Проверить». Токен, который не может прочитать себя (старый GitLab, group/project access token), только снижает точность — срез остаётся на деплой-флагах оператора.
279
295
 
280
- | Возможность | Scope токена | Что открывает |
281
- | --- | --- | --- |
282
- | `identity.read` | `read_user` / `read_api` / `api` | Свой профиль: логин, имя, инстанс |
283
- | `projects.read` | `read_api` / `api` | Проекты, видимость, ветка по умолчанию |
284
- | `repository.read` | `read_repository` / `read_api` / `api` | Дерево, файлы, коммиты, сравнение веток |
285
- | `search.read` | `read_api` / `api` | Поиск по проектам, задачам, MR, коммитам, коду |
286
- | `issues.read` | `read_api` / `api` | Задачи и комментарии к ним |
287
- | `merge_requests.read` | `read_api` / `api` | MR, диффы, обсуждения, одобрения, пайплайны MR |
288
- | `ci.metadata.read` | `read_api` / `api` | Пайплайны, джобы, их статусы и метаданные |
289
- | `ci.logs.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` | Содержимое лога джоба |
290
306
 
291
307
  CI разделён надвое намеренно: лог джоба — это другая утечка, чем список джоб, а раньше обе половины закрывала одна возможность `ci.read`. Оператор стенда задаёт половины отдельно (`ciMetadataRead` и `ciLogsRead`), а старый флаг `ciRead` продолжает работать и теперь управляет обеими; сохранённая политика `ci.read` при первом запуске переносится на оба новых id, поэтому выключенный CI не включается сам. Под сервисным токеном доступна только первая половина: `ci.metadata.read` отвечает, какие джобы были и чем кончились, а `ci.logs.read` показывает, что они напечатали, и остаётся личным чтением. Любая операция, читающая проект, в сервисном режиме обязана назвать проект или группу внутри границы профиля, а листинг без проекта (`gitlab_issues_list`, `gitlab_merge_requests_list`) отказывается — вместо ответа всей картиной, доступной общему аккаунту.
292
308
 
@@ -298,18 +314,18 @@ CI разделён надвое намеренно: лог джоба — эт
298
314
 
299
315
  Подключение — персональный access token TeamCity. Адрес сервера задаёт оператор в конфигурации развёртывания (`teamcity.serverUrl`) — он один на всех, поэтому форма подключения спрашивает только токен, а карточка показывает адрес как справочную строку. Если адрес не задан, карточка говорит об этом вместо формы, которая всё равно не сохранится. Возможность появляется у пользователя, если её включил оператор (`teamcity.*Read`).
300
316
 
301
- | Возможность | Что открывает |
302
- | --- | --- |
303
- | `identity.read` | Сервер TeamCity, его версия и подключённый пользователь |
304
- | `projects.read` | Проекты |
305
- | `buildConfigs.read` | Конфигурации сборки |
306
- | `builds.read` | Сборки, карточка сборки, изменения в VCS |
307
- | `failures.read` | Упавшие тесты и проблемы сборки |
308
- | `logs.read` | Фрагмент лога сборки |
309
- | `queue.read` | Очередь сборки |
310
- | `investigations.read` | Расследования падений |
311
- | `agents.read` | Агенты сборки |
312
- | `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` | Список артефактов и текст небольших текстовых файлов |
313
329
 
314
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`) остаются сервисными: инструмент отвечает упавшими тестами и проблемами сборки, а не логом.
315
331
 
@@ -319,23 +335,27 @@ TeamCity, в отличие от GitLab и Bitrix24, не сообщает че
319
335
 
320
336
  ## Возможности и скопы Jira
321
337
 
322
- Подключение — API-токен Atlassian и e-mail аккаунта, которому он принадлежит: Jira Cloud аутентифицирует такой токен через HTTP Basic (`email:token`). Сайты задаёт оператор в конфигурации развёртывания (`jira.sites`) — пользователь выбирает сайт из списка и вводит e-mail с токеном, произвольный хост ввести нельзя. Возможность появляется у пользователя, если её включил оператор (`jira.*Read`).
338
+ Подключение зависит от того, где живёт Jira, и это объявляет оператор в конфигурации развёртывания (`jira.sites[].deploymentType`). Atlassian Cloud аутентифицирует **API-токен Atlassian** вместе с e-mail аккаунта через HTTP Basic (`email:token`); Jira Server / Data Center — **личный токен доступа** (Personal Access Token) через `Bearer`, без почты. Провайдер ходит по API того продукта, который объявлен: `/rest/api/3` у Cloud, `/rest/api/2` у Server / Data Center. Сайт, который отвечает `serverInfo.deploymentType` другого продукта, отклоняется на подключении с подсказкой, какое значение поставить.
323
339
 
324
- | Возможность | Что открывает |
325
- | --- | --- |
326
- | `identity.read` | Подключённый пользователь Atlassian и сайт, на котором он работает |
327
- | `issues.read` | Поиск задач со всем словарём фильтров (включая историю изменений задачи и разрешение имени в accountId) и карточка задачи с описанием, связями и кастомными полями |
328
- | `comments.read` | Комментарии задачи, включая ограниченные (с пометкой видимости) |
329
- | `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор |
330
- | `transitions.read` | Доступные переходы статуса и их обязательные поля |
331
- | `projects.read` | Карточка проекта |
332
- | `fields.read` | Схема полей сайта, включая кастомные, — она же источник id для фильтра по кастомному полю |
340
+ Список сайтов задаёт только оператор — пользователь выбирает сайт из списка и вставляет токен (и почту, если сайт облачный); произвольный хост ввести нельзя. Возможность появляется у пользователя, если её включил оператор (`jira.*Read`).
333
341
 
334
- Jira, как и TeamCity, не сообщает через API, какие права выданы конкретному API-токену: токен действует от имени пользователя и наследует его права целиком, а «проверить» записью провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора, а права аккаунта применяет сама Jira — отказ приходит как `ProviderPermissionDenied` (задача, проект или поле закрыты схемой прав, issue security level или схемой ролей), и провайдер никогда не пробует другой credential. Единственная проверка, которую провайдер делает сам при подключении, — тип развёртывания: сайт, который отвечает `deploymentType`, отличным от `Cloud`, отклоняется, потому что Data Center — другой API, и молча считать его совместимым спецификация запрещает.
342
+ | Возможность | Что открывает |
343
+ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
344
+ | `identity.read` | Подключённый пользователь Atlassian и сайт, на котором он работает |
345
+ | `issues.read` | Поиск задач со всем словарём фильтров (включая историю изменений задачи и разрешение имени в идентификатор пользователя) и карточка задачи с описанием, связями и кастомными полями |
346
+ | `comments.read` | Комментарии задачи, включая ограниченные (с пометкой видимости) |
347
+ | `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор |
348
+ | `transitions.read` | Доступные переходы статуса и их обязательные поля |
349
+ | `projects.read` | Карточка проекта |
350
+ | `fields.read` | Схема полей сайта, включая кастомные, — она же источник id для фильтра по кастомному полю |
351
+
352
+ Jira, как и TeamCity, не сообщает через API, какие права выданы конкретному API-токену: токен действует от имени пользователя и наследует его права целиком, а «проверить» записью провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора, а права аккаунта применяет сама Jira — отказ приходит как `ProviderPermissionDenied` (задача, проект или поле закрыты схемой прав, issue security level или схемой ролей), и провайдер никогда не пробует другой credential. Единственная проверка, которую провайдер делает сам при подключении, — тип развёртывания: сайт, который отвечает `deploymentType` не тем продуктом, который объявил оператор, отклоняется с подсказкой, какое значение поставить, потому что Cloud и Server / Data Center — разные API, и молча считать их совместимыми спецификация запрещает.
335
353
 
336
354
  Запись в surface отсутствует: создание, правка, назначение, комментарии и переходы ждут pending actions и карточки подтверждения; удаление, администрирование проектов и workflow, произвольный REST и скачивание содержимого вложений — тоже. Провайдер читает только объявленный allow-list эндпоинтов `/rest/api/3` (гейт пакета падает на любом пути вне него), а легаси-эндпоинт `/rest/api/3/search`, удалённый Atlassian, не используется: поиск идёт через `/rest/api/3/search/jql`.
337
355
 
338
- ## Как подключается TeamCity
356
+ ### Сервисный токен Jira
357
+
358
+ Подключение может работать от сервисного токена развёртывания: профиль называет сайт, секрет — обычный API-токен Atlassian в Basic-паре, а граница ресурсов — `projects` (ключи проектов, сравнение без учёта регистра; числовой id засчитывается, если Jira отдала его в выдаче). Сервисному токену недоступны чтения вложений — даже список метаданий помечен чувствительным, потому что следующий естественный шаг агента — скачать файл. Фильтры JQL по имени человека в сервисном режиме отказывают целиком — это чтение корпоративного справочника, у которого нет проекта в границе, — а фильтры по accountId и `me` остаются. Задача, названная по ключу, сначала раскрывается в свой проект, и чтение с уровнем безопасности, который сервисный токен не проходит, отвечает `ResourceNotFound`, как для чужой задачи.
339
359
 
340
360
  Адрес TeamCity задаёт оператор: сервер один на весь стенд, поэтому `teamcity.serverUrl` — обычная настройка развёртывания, а не поле формы. Пользователь вводит только токен, и токен тратится ровно по этому адресу. Рядом оператор задаёт **политику адресов**: какие адреса этот стенд готов набирать вообще (политика осталась от времён, когда адрес вводил пользователь, и закрывает переезд конфига на чужой хост).
341
361
 
@@ -344,12 +364,12 @@ teamcity:
344
364
  enabled: true
345
365
  serverUrl: https://teamcity.example.internal
346
366
  network:
347
- mode: allowlist # allowlist | trusted-private
367
+ mode: allowlist # allowlist | trusted-private
348
368
  allowedHosts:
349
369
  - teamcity.example.internal
350
370
  - "*.corp.example"
351
371
  allowedCidrs:
352
- - 10.20.0.0/16 # только для адресов, записанных цифрами
372
+ - 10.20.0.0/16 # только для адресов, записанных цифрами
353
373
  allowedPorts:
354
374
  - 443
355
375
  - 8111
@@ -373,7 +393,7 @@ teamcity:
373
393
  ```yaml
374
394
  teamcity:
375
395
  enabled: true
376
- serverUrl: https://teamcity.example.internal # один адрес на весь стенд
396
+ serverUrl: https://teamcity.example.internal # один адрес на весь стенд
377
397
  network:
378
398
  mode: allowlist
379
399
  allowedHosts: [teamcity.example.internal]
@@ -389,19 +409,19 @@ teamcity:
389
409
  investigationsRead: true
390
410
  agentsRead: true
391
411
  artifactsRead: true
392
- maxLogLines: 1000 # потолок строк в ответе по логу
393
- maxLogBytes: 262144 # сколько лога вообще скачиваем
394
- defaultArtifactBytes: 262144 # бюджет чтения артефакта по умолчанию
395
- maxArtifactBytes: 1048576 # жёсткий потолок чтения артефакта
396
- streamTimeoutMs: 30000 # таймаут для логов и артефактов
397
- retries: 2 # повторы для 429/5xx и сетевых сбоев
412
+ maxLogLines: 1000 # потолок строк в ответе по логу
413
+ maxLogBytes: 262144 # сколько лога вообще скачиваем
414
+ defaultArtifactBytes: 262144 # бюджет чтения артефакта по умолчанию
415
+ maxArtifactBytes: 1048576 # жёсткий потолок чтения артефакта
416
+ streamTimeoutMs: 30000 # таймаут для логов и артефактов
417
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
398
418
  ```
399
419
 
400
420
  Токен создаётся в TeamCity (Profile → Access Tokens), при желании с «Limit per project» и read-правами, вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты.
401
421
 
402
422
  ## Чего в TeamCity-провайдере ещё нет
403
423
 
404
- Спецификация `docs/SPEC-providers-teamcity.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у Bitrix24 с GitLab:
424
+ Спецификация `docs/specs/providers-teamcity.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у Bitrix24 с GitLab:
405
425
 
406
426
  - **Запись** (§12.2): запуск, перезапуск, отмена сборки, комментарий и теги — вместе с ними отложены pending actions и карточка подтверждения (§24). Пока в каталоге нет ни одной операции, которая может изменить TeamCity.
407
427
  - **Автоматический постраничный обход** (§18): сейчас один вызов — один ограниченный запрос, а `pagination.hasMore` сообщает модели, что страница обрезана. Пятистраничная агрегация потребовала бы ходить по `nextHref`, чего провайдер не делает.
@@ -422,15 +442,21 @@ teamcity:
422
442
  ```yaml
423
443
  confluence:
424
444
  enabled: true
425
- allowInsecureHttp: false # только для dev-стенда
445
+ allowInsecureHttp: false # только для dev-стенда
426
446
  instances:
427
447
  - id: company
428
448
  label: Company
429
449
  baseUrl: https://company.atlassian.net
450
+ deploymentType: cloud # cloud (по умолчанию) | server | data-center
430
451
  # токен со скоупами требует шлюза Atlassian:
431
452
  # - id: company-scoped
432
453
  # label: Company (scoped token)
433
454
  # baseUrl: https://api.atlassian.com/ex/confluence/<cloudId>
455
+ # самохостящаяся Confluence Server / Data Center (контекст — в baseUrl):
456
+ # - id: corp
457
+ # label: Corporate Wiki
458
+ # baseUrl: https://wiki.example.corp/confluence
459
+ # deploymentType: server # личный токен доступа, /rest/api
434
460
  identityRead: true
435
461
  spacesRead: true
436
462
  searchRead: true
@@ -438,19 +464,19 @@ confluence:
438
464
  commentsRead: true
439
465
  attachmentsRead: true
440
466
  versionsRead: true
441
- allowedSpaces: [] # ключи пространств; пусто = все, что видит аккаунт
442
- defaultBodyChars: 20000 # бюджет тела страницы по умолчанию
443
- maxBodyChars: 60000 # потолок бюджета, который может попросить модель
444
- maxResults: 50 # строк в ответе любого списка (потолок для limit)
445
- maxReplyParents: 10 # сколько комментариев могут принести ответы
446
- retries: 2 # повторы для 429/5xx и сетевых сбоев
467
+ allowedSpaces: [] # ключи пространств; пусто = все, что видит аккаунт
468
+ defaultBodyChars: 20000 # бюджет тела страницы по умолчанию
469
+ maxBodyChars: 60000 # потолок бюджета, который может попросить модель
470
+ maxResults: 50 # строк в ответе любого списка (потолок для limit)
471
+ maxReplyParents: 10 # сколько комментариев могут принести ответы
472
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
447
473
  ```
448
474
 
449
475
  API token выпускается в профиле Atlassian (`Manage profile → Security → API tokens`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты. Если стенду нужен OAuth-аккаунт Atlassian общего вида, а не персональный токен, — это отдельная фаза.
450
476
 
451
477
  ## Чего в Confluence-провайдере ещё нет
452
478
 
453
- Спецификация `docs/SPEC-providers-confluence.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у остальных провайдеров:
479
+ Спецификация `docs/specs/providers-confluence.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у остальных провайдеров:
454
480
 
455
481
  - **OAuth 2.0 3LO** (раздел «Authentication»): подключение идёт API token плюс почта аккаунта, поэтому нет ни общего OAuth-приложения, ни refresh-цикла, ни общего слоя `providers/atlassian` с `accessible-resources`. Выбор ресурса сводится к выбору сайта из конфига оператора.
456
482
  - **Запись** (раздел «Write operations»): создание и правка страниц, комментарии, резолв inline-комментариев — вместе с ними отложены pending actions, карточка подтверждения и оптимистичная блокировка по версии страницы. Пока в каталоге нет ни одной операции, которая может изменить Confluence.
@@ -461,9 +487,13 @@ API token выпускается в профиле Atlassian (`Manage profile
461
487
  - **Продолжение большого тела** (раздел «Response size controls»): тело режется бюджетом и помечается `truncated`, но сегментного чтения (`confluence_get_page_segment`) нет; страница, чей JSON на стороне Confluence больше `maxResponseBytes`, отвечает `ResultTooLarge`.
462
488
  - **Кэш** (раздел «Caching») отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может; пагинация stateless, подписанных continuation-токенов нет.
463
489
  - **Rate limiting** (раздел «Rate limiting»): лимиты по principal, ресурсу и глобальные не считаются; вместо них — ограниченные размеры ответов и повторы с backoff для 429/5xx.
464
- - **Семантический индекс** (раздел «Optional semantic index»), **webhooks** и **Confluence Data Center** (раздел «Compatibility») — не подключены: провайдер работает только с Confluence Cloud.
490
+ - **Семантический индекс** (раздел «Optional semantic index») и **webhooks** (раздел «Compatibility») — не подключены.
465
491
 
466
- ## Как подключается Weblate
492
+ Confluence Server / Data Center подключён: объявите инстанс с `deploymentType: server`, и чтения пойдут по v1 API (`/rest/api`) с личным токеном доступа, а тела страниц — в storage-разметке.
493
+
494
+ ### Сервисный токен Weblate
495
+
496
+ Подключение может работать от сервисного токена развёртывания: профиль называет инстанс, секрет — обычный API-токен Weblate (префикс значения роли не играет), а граница ресурсов — `projects` (слаги проектов; компонент принадлежит проекту, поэтому чтение компонента сверяет его проект). Чувствительных чтений в каталоге нет: всё, что читает провайдер, — переводческие метаданные, а `changes.list` — собственный журнал изменений Weblate, а не сырой вывод VCS. Чтение, названное по id строки, сначала раскрывается в свой проект; скриншоты вне границы и с непроверяемым проектом из выдачи выпадают, а листинг проектов собирается из allowlist с `unavailableResources` для того, что токен не видит.
467
497
 
468
498
  Инстансы Weblate задаёт только оператор: пользователь выбирает инстанс из списка и вставляет API-токен, произвольный хост ввести нельзя. Если инстанс один, выбор не показывается; если инстансов нет, карточка честно сообщает, что подключать нечего, и формы не показывает.
469
499
 
@@ -476,7 +506,7 @@ API token выпускается в профиле Atlassian (`Manage profile
476
506
  ```yaml
477
507
  weblate:
478
508
  enabled: true
479
- allowInsecureHttp: false # только для dev-стенда
509
+ allowInsecureHttp: false # только для dev-стенда
480
510
  instances:
481
511
  - id: corp
482
512
  label: Corporate Weblate
@@ -496,16 +526,16 @@ weblate:
496
526
  changesRead: true
497
527
  statisticsRead: true
498
528
  screenshotsRead: true
499
- maxTextChars: 4000 # символов одной строки, которую видит модель
500
- maxPageSize: 100 # потолок страницы; по умолчанию провайдер просит 20
501
- retries: 2 # повторы для 429/5xx и сетевых сбоев
529
+ maxTextChars: 4000 # символов одной строки, которую видит модель
530
+ maxPageSize: 100 # потолок страницы; по умолчанию провайдер просит 20
531
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
502
532
  ```
503
533
 
504
534
  Список инстансов принимает не больше 16 записей; id — строчные латинские буквы, цифры и дефисы (до 32 символов), без повторов; подпись по умолчанию — имя хоста. Опечатка в инстансе роняет загрузку конфига, а не выбрасывает инстанс молча: пользователь иначе получил бы провайдер, к которому нельзя подключиться, и никакого объяснения. Пустой список — это состояние, а не падение: провайдер зарегистрирован и бездействует, а отказывает форма подключения.
505
535
 
506
536
  ## Чего в Weblate-провайдере ещё нет
507
537
 
508
- Спецификация `docs/SPEC-providers-weblate.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у остальных провайдеров:
538
+ Спецификация `docs/specs/providers-weblate.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у остальных провайдеров:
509
539
 
510
540
  - **Запись** (раздел «Write operations»): предложения перевода, комментарии, правка и утверждение перевода, файлы перевода, autotranslate и операции с репозиторием — вместе с ними отложены pending actions и карточка подтверждения. Пока в каталоге нет ни одной операции, которая может изменить Weblate.
511
541
  - **Скачивание скриншотов** (раздел «Screenshots and binary data»): сейчас только метаданные, id связанных строк и адрес картинки на настроенном инстансе; ни байты, ни лимит размера, ни проверка MIME, ни временное хранилище на пользователя не реализованы.
@@ -531,7 +561,7 @@ weblate:
531
561
  ```yaml
532
562
  gitlab:
533
563
  enabled: true
534
- allowInsecureHttp: false # только для dev-стенда
564
+ allowInsecureHttp: false # только для dev-стенда
535
565
  instances:
536
566
  - id: gitlab-com
537
567
  label: GitLab.com
@@ -545,19 +575,19 @@ gitlab:
545
575
  searchRead: true
546
576
  issuesRead: true
547
577
  mergeRequestsRead: true
548
- ciMetadataRead: true # пайплайны, джобы, их статусы; прежний ciRead задаёт обе половины
549
- ciLogsRead: true # содержимое лога джоба: только личный аккаунт
550
- maxFileBytes: 131072 # сколько тела файла отдаём модели
551
- maxJobLogBytes: 262144 # сколько лога джобы отдаём модели
552
- maxSearchResults: 50 # потолок per page у поиска
553
- retries: 2 # повторы для 429/5xx и сетевых сбоев
578
+ ciMetadataRead: true # пайплайны, джобы, их статусы; прежний ciRead задаёт обе половины
579
+ ciLogsRead: true # содержимое лога джоба: только личный аккаунт
580
+ maxFileBytes: 131072 # сколько тела файла отдаём модели
581
+ maxJobLogBytes: 262144 # сколько лога джобы отдаём модели
582
+ maxSearchResults: 50 # потолок per page у поиска
583
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
554
584
  ```
555
585
 
556
586
  OAuth-приложение для GitLab не нужно: подключение идёт персональным токеном. Токен создаётся в GitLab (`User settings → Access tokens`) с read-scope, вводится один раз в карточке, шифруется тем же конвертным хранилищем, что и вебхук Bitrix24, и после сохранения не показывается и не копируется.
557
587
 
558
588
  ## Чего в GitLab-провайдере ещё нет
559
589
 
560
- Спецификация `docs/SPEC-providers-gitlab.md` описывает целевую архитектуру; в этой версии сознательно реализована только read-only фаза, как и у Bitrix24:
590
+ Спецификация `docs/specs/providers-gitlab.md` описывает целевую архитектуру; в этой версии сознательно реализована только read-only фаза, как и у Bitrix24:
561
591
 
562
592
  - **OAuth Authorization Code + PKCE** (§8.1) — вместо него PAT (§8.2). Для OAuth нужны callback-маршрут на хосте, одноразовый state и refresh-цикл; это отдельная фаза.
563
593
  - **Пользовательская граница ресурсов** (§12): в личном режиме доступ ограничен правами токена и персональной политикой возможностей, но не выбранным набором проектов/групп. Выбранный набор есть только в сервисном режиме: там границу задаёт администратор в профиле, а пользователь может её сузить, но не расширить.
@@ -576,16 +606,22 @@ OAuth-приложение для GitLab не нужно: подключение
576
606
  ```yaml
577
607
  jira:
578
608
  enabled: true
579
- allowInsecureHttp: false # только для dev-стенда
609
+ allowInsecureHttp: false # только для dev-стенда
580
610
  sites:
581
611
  - id: company
582
612
  label: company.atlassian.net
583
613
  baseUrl: https://company.atlassian.net
614
+ deploymentType: cloud # cloud (по умолчанию) | server | data-center
584
615
  - id: sandbox
585
616
  label: Sandbox
586
617
  baseUrl: https://sandbox.atlassian.net
587
- fieldAliases: # имена кастомных полей ЭТОГО сайта: алиас → customfield_ id
588
- product: customfield_10010 # id берётся из jira_get_fields; в репозитории их нет
618
+ # самохостящаяся Jira Server / Data Center:
619
+ # - id: corp
620
+ # label: Jira Server
621
+ # baseUrl: https://jira.example.corp
622
+ # deploymentType: server # личный токен доступа, /rest/api/2
623
+ fieldAliases: # имена кастомных полей ЭТОГО сайта: алиас → customfield_ id
624
+ product: customfield_10010 # id берётся из jira_get_fields; в репозитории их нет
589
625
  identityRead: true
590
626
  issuesRead: true
591
627
  commentsRead: true
@@ -593,25 +629,26 @@ jira:
593
629
  transitionsRead: true
594
630
  projectsRead: true
595
631
  fieldsRead: true
596
- defaultSearchLimit: 20 # строк в ответе поиска, если модель не просила
597
- maxSearchLimit: 100 # потолок страницы; больше Jira не отдаёт
598
- maxCommentLimit: 100 # потолок страницы комментариев
599
- maxTextChars: 20000 # бюджет одного описания, комментария или rich-поля
600
- retries: 2 # повторы для 429/5xx и сетевых сбоев
632
+ defaultSearchLimit: 20 # строк в ответе поиска, если модель не просила
633
+ maxSearchLimit: 100 # потолок страницы; больше Jira не отдаёт
634
+ maxCommentLimit: 100 # потолок страницы комментариев
635
+ maxTextChars: 20000 # бюджет одного описания, комментария или rich-поля
636
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
601
637
  ```
602
638
 
603
- OAuth-приложение для Jira не нужно: подключение идёт API-токеном. Токен создаётся в аккаунте Atlassian (`id.atlassian.com → Безопасность → API-токены`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты — вместе с e-mail аккаунта, потому что Jira аутентифицирует пару `email:token`, а не токен отдельно. После сохранения ни то, ни другое не показывается и не копируется.
639
+ OAuth-приложение для Jira не нужно: подключение идёт токеном. Для Cloud токен создаётся в аккаунте Atlassian (`id.atlassian.com → Безопасность → API-токены`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты — вместе с e-mail аккаунта, потому что Jira Cloud аутентифицирует пару `email:token`, а не токен отдельно. Для Server / Data Center токен создаётся в профиле самой Jira (`Профиль → Личные токены доступа`) и хранится один, без почты: он аутентифицируется как `Bearer`. После сохранения секрет не показывается и не копируется.
604
640
 
605
641
  `fieldAliases` — тоже настройка развёртывания, а не знание провайдера: какие кастомные поля инстанса отвечают на «продукт», «команду» или «окружение» — это свойство конкретного сайта, поэтому в пакете нет ни одного такого id, а оператор объявляет свои имена алиасами и видит их в ответе `jira_get_fields`. Опечатка в алиасе роняет загрузку конфига, как и опечатка в списке сайтов: алиас, который молча никуда не указывает, отвечал бы «задач нет» вместо «нет такого поля». Значения алиасных полей также известны только инстансу — их читают из реальных задач (`jira_get_issue` с `include: ["custom_fields"]`), а не угадывают.
606
642
 
607
643
  ## Чего в Jira-провайдере ещё нет
608
644
 
609
- Спецификация `docs/SPEC-providers-jira.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у Bitrix24, GitLab и TeamCity:
645
+ Спецификация `docs/specs/providers-jira.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у Bitrix24, GitLab и TeamCity:
610
646
 
611
647
  - **OAuth 2.0 3LO с ротацией refresh-токенов** (§Authentication): вместо него API-токен с Basic-аутентификацией. Для OAuth нужны callback-маршрут на хосте, одноразовый state с PKCE, per-credential lock на ротацию refresh-токена и `reauth_required` при `invalid_grant` — это отдельная фаза. Токен, отклонённый Jira (401), сейчас отвечает `CredentialRevoked`, а карточка предлагает заменить токен.
612
648
  - **Общий слой Atlassian** (§Shared Atlassian account model): `providers/atlassian/` — общий аккаунт и ресурсы для Jira и Confluence, несколько сайтов на один аккаунт. Пока Jira самостоятельный каталог, как и остальные три провайдера, а сайт выбирается при подключении.
613
649
  - **Привязка workspace → проект** (§Workspace binding): allowlist проектов на уровне рабочего пространства — дополнительное сужение, которого сейчас нет; доступ ограничен правами аккаунта и персональной политикой возможностей.
614
650
  - **Raw JQL** (§JQL policy, advanced mode): модели доступны только типизированные фильтры. Отдельный JQL-инструмент потребовал бы валидации через parse-API Jira, лимитов на ширину запроса и аудита исходной и нормализованной строки.
651
+ - **Jira Server / Data Center**: подключён как второй продукт (см. `deploymentType` выше) — чтения идут по `/rest/api/2` с личным токеном доступа. Не подключено то, чего у v2 API нет вовсе: enhanced search с continuation-токеном (у Server / Data Center пагинация по offset, и это то, что отдаёт провайдер) и Cloud-специфичные поля ответа вроде `accountType`.
615
652
  - **Запись** (§Write operations): `jira_prepare_*` вместе с pending actions, payload hash, сроком годности и перепроверкой прав на подтверждении. Пока в каталоге нет ни одной операции, которая может изменить Jira, и ни одного инструмента со словом `prepare`.
616
653
  - **Скачивание вложений** (§Attachments): сейчас только метаданные. Будущий `jira_get_attachment` обязан заново проверять видимость задачи, иметь лимит байт и allowlist типов.
617
654
  - **Поиск по истории изменений**: историю одной задачи прочитать можно (`include: ["changelog_summary"]`), а вот отфильтровать задачи «где в истории встречается 3.8» — нет. Типизированный фильтр по истории потребовал бы JQL-операторов `WAS`/`CHANGED` с их отдельной валидацией; пока такой запрос сводится к чтению истории конкретных задач. Чтение кастомных полей идёт селектором `*all`, поэтому на сайте с очень большим числом полей такой ответ может упереться в `ResultTooLarge`.
@@ -624,46 +661,46 @@ Test IT — система управления тестированием: те
624
661
  и результаты. Все 22 инструмента только читают; каждый называет capability, и
625
662
  выключенную оператором возможность агент не получает вовсе.
626
663
 
627
- | Tool | Что делает |
628
- |---|---|
629
- | `testit_connection_get` | К какой инсталляции подключено и видит ли токен проекты |
630
- | `testit_projects` | Проекты с числом тест-кейсов, чек-листов и автотестов |
631
- | `testit_project_get` | Карточка проекта: описание, счётчики, схема атрибутов |
632
- | `testit_sections` | Разделы (папки) тест-библиотеки проекта |
633
- | `testit_work_items` | Тест-кейсы, чек-листы и общие шаги проекта по фильтрам |
634
- | `testit_work_item_get` | Тест-кейс целиком: шаги, предусловия, атрибуты, теги, вложения |
635
- | `testit_work_item_history` | История изменений: кто что поменял, из чего в что |
636
- | `testit_work_item_comments` | Комментарии к тест-кейсу |
637
- | `testit_work_item_test_results` | История результатов тест-кейса по прогонам и конфигурациям |
638
- | `testit_test_plans` | Тест-планы проекта со статусом и сроками |
639
- | `testit_test_plan_get` | Карточка тест-плана |
640
- | `testit_test_plan_summary` | Прогресс плана: тест-поинты, автоматизация, дефекты |
641
- | `testit_test_runs` | Прогоны проекта по состояниям, датам и тест-плану |
642
- | `testit_test_run_get` | Карточка прогона |
643
- | `testit_test_run_results` | Что было в прогоне: тест-поинты с итогом и результатами |
644
- | `testit_test_result_get` | Результат теста: шаги, длительность, сообщение, трейсы |
645
- | `testit_test_result_attachments` | Метаданные вложений результата |
646
- | `testit_attachment_metadata` | Метаданные вложения |
647
- | `testit_attachment_text` | Текст небольшого текстового вложения (бинарные и архивы отбиваются) |
648
- | `testit_auto_tests` | Автотесты проекта: класс, пространство имён, стабильность |
649
- | `testit_auto_test_get` | Карточка автотеста: шаги, setup, teardown, последний результат |
650
- | `testit_configurations` | Конфигурации проекта, в разрезе которых считаются результаты |
664
+ | Tool | Что делает |
665
+ | -------------------------------- | ------------------------------------------------------------------- |
666
+ | `testit_connection_get` | К какой инсталляции подключено и видит ли токен проекты |
667
+ | `testit_projects` | Проекты с числом тест-кейсов, чек-листов и автотестов |
668
+ | `testit_project_get` | Карточка проекта: описание, счётчики, схема атрибутов |
669
+ | `testit_sections` | Разделы (папки) тест-библиотеки проекта |
670
+ | `testit_work_items` | Тест-кейсы, чек-листы и общие шаги проекта по фильтрам |
671
+ | `testit_work_item_get` | Тест-кейс целиком: шаги, предусловия, атрибуты, теги, вложения |
672
+ | `testit_work_item_history` | История изменений: кто что поменял, из чего в что |
673
+ | `testit_work_item_comments` | Комментарии к тест-кейсу |
674
+ | `testit_work_item_test_results` | История результатов тест-кейса по прогонам и конфигурациям |
675
+ | `testit_test_plans` | Тест-планы проекта со статусом и сроками |
676
+ | `testit_test_plan_get` | Карточка тест-плана |
677
+ | `testit_test_plan_summary` | Прогресс плана: тест-поинты, автоматизация, дефекты |
678
+ | `testit_test_runs` | Прогоны проекта по состояниям, датам и тест-плану |
679
+ | `testit_test_run_get` | Карточка прогона |
680
+ | `testit_test_run_results` | Что было в прогоне: тест-поинты с итогом и результатами |
681
+ | `testit_test_result_get` | Результат теста: шаги, длительность, сообщение, трейсы |
682
+ | `testit_test_result_attachments` | Метаданные вложений результата |
683
+ | `testit_attachment_metadata` | Метаданные вложения |
684
+ | `testit_attachment_text` | Текст небольшого текстового вложения (бинарные и архивы отбиваются) |
685
+ | `testit_auto_tests` | Автотесты проекта: класс, пространство имён, стабильность |
686
+ | `testit_auto_test_get` | Карточка автотеста: шаги, setup, teardown, последний результат |
687
+ | `testit_configurations` | Конфигурации проекта, в разрезе которых считаются результаты |
651
688
 
652
689
  ## Возможности и скопы Test IT
653
690
 
654
- | Возможность | Что открывает |
655
- |---|---|
656
- | `projects.read` | Проекты и карточка проекта, проба подключения |
657
- | `sections.read` | Разделы тест-библиотеки |
658
- | `workItems.read` | Тест-кейсы, чек-листы, общие шаги |
659
- | `history.read` | История изменений тест-кейса |
660
- | `comments.read` | Комментарии тест-кейса |
661
- | `testPlans.read` | Тест-планы, карточка и сводка |
662
- | `testRuns.read` | Прогоны и карточка прогона |
663
- | `testResults.read` | Результаты прогона, отдельный результат, история результатов |
664
- | `autoTests.read` | Автотесты |
665
- | `attachments.read` | Метаданные вложений и текст текстовых файлов |
666
- | `configurations.read` | Конфигурации проекта |
691
+ | Возможность | Что открывает |
692
+ | --------------------- | ------------------------------------------------------------ |
693
+ | `projects.read` | Проекты и карточка проекта, проба подключения |
694
+ | `sections.read` | Разделы тест-библиотеки |
695
+ | `workItems.read` | Тест-кейсы, чек-листы, общие шаги |
696
+ | `history.read` | История изменений тест-кейса |
697
+ | `comments.read` | Комментарии тест-кейса |
698
+ | `testPlans.read` | Тест-планы, карточка и сводка |
699
+ | `testRuns.read` | Прогоны и карточка прогона |
700
+ | `testResults.read` | Результаты прогона, отдельный результат, история результатов |
701
+ | `autoTests.read` | Автотесты |
702
+ | `attachments.read` | Метаданные вложений и текст текстовых файлов |
703
+ | `configurations.read` | Конфигурации проекта |
667
704
 
668
705
  Сужения по «выданным правам» здесь нет: API v2 не сообщает, какие права у
669
706
  токена (в отличие от вебхука Bitrix24 с его scope и GitLab с
@@ -676,9 +713,11 @@ Test IT — система управления тестированием: те
676
713
  единственные GET-чтения этих коллекций, а поиск (`POST /workItems/search`),
677
714
  статистика прогона и глобальный поиск — POST-эндпоинты, которых в каталоге нет
678
715
  по правилу «каждая операция каталога — GET». Что из-за этого недоступно и чем
679
- заменено — в [SPEC-providers-testit.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/docs/SPEC-providers-testit.md).
716
+ заменено — в [providers-testit.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/docs/specs/providers-testit.md).
680
717
 
681
- ## Как подключается Test IT
718
+ ### Сервисный токен Test IT
719
+
720
+ Подключение может работать от сервисного токена развёртывания: профиль называет инсталляцию, секрет — обычный API-токен, а граница ресурсов — `projects` (id проектов, точное сравнение — иерархии проектов у Test IT нет). Сервисному токену недоступны вложения целиком: даже метаданные не несут проект, поэтому глобальный id нечем сверить с границей — каталог отвечает отказом, а не молча; тело вложения чувствительно и в личном режиме читается только у маленьких текстовых файлов. Чтение, адресованное id (тест-кейс, план, прогон, результат), сначала раскрывается в свой проект, и чтение вне границы отказывает до обращения к собственно объекту; листинг `projects.list` собирается из allowlist, а не из того, что видит токен.
682
721
 
683
722
  Test IT бывает облачный и self-hosted, поэтому адрес задаёт оператор стенда
684
723
  списком инсталляций (`testit.instances`) — пользователь выбирает инсталляцию из
@@ -710,12 +749,12 @@ query и фрагмента, а хвостовой слэш снимается.
710
749
  ```yaml
711
750
  testit:
712
751
  enabled: true
713
- allowInsecureHttp: false # лазейка для внутреннего стенда; в проде HTTPS
752
+ allowInsecureHttp: false # лазейка для внутреннего стенда; в проде HTTPS
714
753
  instances:
715
754
  - id: cloud
716
755
  label: Test IT Cloud
717
756
  baseUrl: https://team.example.testit.software
718
- projectsRead: true # флаги возможностей: выключенная не доходит до агента
757
+ projectsRead: true # флаги возможностей: выключенная не доходит до агента
719
758
  sectionsRead: true
720
759
  workItemsRead: true
721
760
  historyRead: true
@@ -726,17 +765,17 @@ testit:
726
765
  autoTestsRead: true
727
766
  attachmentsRead: true
728
767
  configurationsRead: true
729
- defaultResults: 20 # размер списка, когда модель не назвала лимит
730
- maxResults: 100 # жёсткий потолок одного ответа-списка
731
- defaultAttachmentBytes: 262144 # бюджет чтения вложения по умолчанию
732
- maxAttachmentBytes: 10485760 # жёсткий потолок чтения вложения (10 MiB)
733
- attachmentTimeoutMs: 30000 # таймаут скачивания вложения
734
- retries: 2 # повторы для 429/5xx и сетевых сбоев
768
+ defaultResults: 20 # размер списка, когда модель не назвала лимит
769
+ maxResults: 100 # жёсткий потолок одного ответа-списка
770
+ defaultAttachmentBytes: 262144 # бюджет чтения вложения по умолчанию
771
+ maxAttachmentBytes: 10485760 # жёсткий потолок чтения вложения (10 MiB)
772
+ attachmentTimeoutMs: 30000 # таймаут скачивания вложения
773
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
735
774
  ```
736
775
 
737
776
  ## Чего в Test IT-провайдере ещё нет
738
777
 
739
- Спецификация `docs/SPEC-providers-testit.md` описывает целевую архитектуру; в
778
+ Спецификация `docs/specs/providers-testit.md` описывает целевую архитектуру; в
740
779
  этой версии реализована read-only фаза, как и у остальных пяти провайдеров:
741
780
 
742
781
  - **Поиск и статистика через POST**: `POST /workItems/search`,
@@ -765,7 +804,7 @@ testit:
765
804
 
766
805
  ## Сервисные токены (managed service credentials)
767
806
 
768
- Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у GitLab и TeamCity; остальные интеграции сервисного режима не предлагают, и в их карточках о нём ничего не появляется.
807
+ Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у всех семи интеграций; классификация service-safe операций у каждой своя, и чувствительные чтения каждого провайдера перечислены в его разделе.
769
808
 
770
809
  ```yaml
771
810
  managedServiceCredentials:
@@ -774,8 +813,8 @@ managedServiceCredentials:
774
813
  profiles:
775
814
  - id: gitlab-corp-readonly
776
815
  provider: gitlab
777
- instance: corp # id из gitlab.instances
778
- label: QA GitLab Read-only # псевдоним, который видит пользователь
816
+ instance: corp # id из gitlab.instances
817
+ label: QA GitLab Read-only # псевдоним, который видит пользователь
779
818
  credential:
780
819
  type: pat
781
820
  secretFile: /run/secrets/qa_gitlab_service_token
@@ -786,10 +825,10 @@ managedServiceCredentials:
786
825
  groups:
787
826
  - group/platform
788
827
  policy:
789
- gitlab.issues.read: deny # только сужение; "allow" отвергается при загрузке
828
+ gitlab.issues.read: deny # только сужение; "allow" отвергается при загрузке
790
829
  - id: teamcity-readonly
791
830
  provider: teamcity
792
- instance: teamcity # сервер TeamCity один, id фиксирован
831
+ instance: teamcity # сервер TeamCity один, id фиксирован
793
832
  label: QA TeamCity Read-only
794
833
  credential:
795
834
  type: personal_access_token
@@ -799,13 +838,13 @@ managedServiceCredentials:
799
838
  - PLATFORM
800
839
  ```
801
840
 
802
- `enabled` по умолчанию `false`: пока развёртывание не включило срез, о сервисном токене нет ни строчки — ни чекбокса в форме подключения, ни профилей, ни нового поведения. `defaultForNewConnections` решает, с какого режима начинается новое подключение. `resources` обязателен и проверяется при загрузке: профиль без границы — это общий аккаунт, который видит всё, что видит его владелец, и ровно этого возможность не допускает. Записи `resources` — те идентификаторы, которые принимает сам провайдер: id проекта GitLab или полный путь, путь группы, id проекта TeamCity. Секрет берётся из смонтированного файла (`secretFile`) или из переменной окружения (`secretEnv`) — ровно один из двух, в YAML он не лежит. Опечатка в профиле роняет загрузку конфига, а не выбрасывает профиль молча: сообщение называет профиль или инстанс и говорит, что именно не так, — неизвестный провайдер, неизвестный инстанс, инстанс, занятый двумя профилями, или `resources`, не назвавший ни одного вида ресурсов.
841
+ `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`, не назвавший ни одного вида ресурсов.
803
842
 
804
843
  Новое подключение начинается на сервисном токене, когда профиль для выбранного инстанса есть и `defaultForNewConnections` включён (по умолчанию так): чекбокс «Использовать сервисный токен» в форме уже отмечен, поля токена нет вовсе, а кнопка называется «Подключить сервисный токен». Снятая галочка возвращает обычную форму с personal access token. У уже существующих подключений режим не меняется: он хранится в самом подключении, поэтому обновление стенда не переводит пользователя на общий аккаунт само. В подключённой карточке режим виден строкой «Сервисный аккаунт · управляется администратором», а рядом — «Изменить доступ» и «Использовать личный аккаунт».
805
844
 
806
- Сервисный режим — не «read-only вообще», а жёсткий потолок: только `read`, только обычная чувствительность и только операции, которые провайдер пометил service-safe намеренно. Запись, админ-действия, управление правами и токенами и произвольный REST недостижимы, даже если сервисный токен наверху это умеет: классификация операции — свойство каталога провайдера, а не прав токена. Чувствительные чтения остаются личными: через общий аккаунт не читаются лог CI-джоба GitLab (`ci.logs.read`), лог сборки TeamCity (`logs.read`) и текст артефакта (`artifacts.read`), а конфиденциальная задача GitLab не возвращается вовсе — прямое чтение отвечает `ResourceNotFound`, из выдачи и из поиска она выпадает, а поиск по комментариям (`scope: notes`) отказывается целиком: у комментария нет признака конфиденциальности, и проверить его родителя одним запросом нельзя. Операция, которую провайдер не классифицировал, отклоняется по умолчанию: инструмент, добавленный обновлением провайдера, недостижим через общий аккаунт, пока кто-то не классифицирует его намеренно. Администраторская `policy` может только выключить: `allow` в профиле отвергается при загрузке, потому что оператор, написавший `allow`, считает, что расширил потолок.
845
+ Сервисный режим — не «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`, считает, что расширил потолок.
807
846
 
808
- Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с allowlist каждый вызов: проект, названный по id или по пути, должен быть в списке или под перечисленной группой; сборка TeamCity, названная по id, сначала разрешается в свой проект; листинг, не называющий проект, отказывается, а не отвечает всей картиной, доступной общему аккаунту. Список проектов (`gitlab_projects_list`, `teamcity_projects`) собирается из allowlist, а не из того, что видит сервисный токен: проект, которого токен не видит, приходит в `unavailableResources`, а не исчезает молча, — это и есть ответ оператору, что граница и токен разошлись. Разворачивая группу GitLab, провайдер просит только её собственные проекты (`with_shared=false`) и дополнительно сверяет каждый вернувшийся проект с границей: чужой проект, расшаренный в группу, в выдачу не попадает. Пользователь может сузить список в карточке кнопкой «Изменить доступ», но не расширить: выбор вне администраторского списка отбрасывается и не сохраняется.
847
+ Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с 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`) и дополнительно сверяет каждый вернувшийся проект с границей: чужой проект, расшаренный в группу, в выдачу не попадает. Пользователь может сузить список в карточке кнопкой «Изменить доступ», но не расширить: выбор вне администраторского списка отбрасывается и не сохраняется.
809
848
 
810
849
  Режим — одно из двух явных значений, `personal` или `service`; `auto` не существует. Отказ в личном режиме (`403` от GitLab или TeamCity) — это отказ: его не повторяют сервисным токеном, и наоборот тоже. Если личный токен был сохранён раньше, он остаётся зашифрованным в хранилище, но не тратится, пока подключение работает на сервисном; «Использовать личный аккаунт» возвращает его, а если личного токена не сохраняли, переключение отвечает `PersonalCredentialRequired` вместо подключения без личности. Переключение в любую сторону поднимает binding revision, поэтому всё, что было выведено из прежней личности, с этого момента недействительно.
811
850
 
@@ -852,7 +891,7 @@ credentialHelp:
852
891
  instructions: Откройте внутреннюю страницу токенов.
853
892
  selfHosted: true
854
893
  jira:
855
- enabled: false # спрятать подсказку; поле секрета остаётся
894
+ enabled: false # спрятать подсказку; поле секрета остаётся
856
895
  weblate:
857
896
  docsLabel: Наша вики
858
897
  ```
@@ -1010,9 +1049,9 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
1010
1049
 
1011
1050
  Для TeamCity: оператор задаёт адрес сервера (`teamcity.serverUrl`) и политику адресов, пользователь создаёт в профиле access token (по возможности с «Limit per project» и read-правами) и вставляет только его. Если адрес не задан, карточка говорит об этом и формы не показывает; если адрес не проходит политику — конфигурация стенда падает при загрузке, а не отвечает отказом пользователю. Плагин прочитает `/app/rest/server` и `/app/rest/users/current`, покажет версию сервера и подключённого пользователя, а список возможностей останется в границах, которые разрешил оператор: сам TeamCity не сообщает, какие права выданы токену.
1012
1051
 
1013
- Для Jira: оператор перечисляет сайты (`jira.sites`), пользователь создаёт API-токен в аккаунте Atlassian, выбирает сайт (если их несколько) и вводит e-mail аккаунта вместе с токеном. Плагин вызывает `/rest/api/3/myself`, показывает подключённого пользователя и сайт, а также проверяет, что сайт действительно Cloud: Data Center отвечает отказом на подключении, а не молчаливой несовместимостью. Кастомные поля задач приходят с именами из схемы сайта, а если прав на схему нет — с идентификаторами `customfield_*`.
1052
+ Для Jira: оператор перечисляет сайты (`jira.sites`) и объявляет тип каждого (`deploymentType`). Пользователь выбирает сайт (если их несколько) и вставляет то, что этот сайт принимает: API-токен Atlassian вместе с e-mail для Cloud, личный токен доступа без почты для Server / Data Center. Плагин читает `myself` по API объявленного продукта (`/rest/api/3` или `/rest/api/2`), показывает подключённого пользователя и сайт, а также проверяет, что сайт отвечает именно этим продуктом — расхождение это отказ с подсказкой, какое значение поставить, а не молчаливая несовместимость. Кастомные поля задач приходят с именами из схемы сайта, а если прав на схему нет — с идентификаторами `customfield_*`.
1014
1053
 
1015
- Для Confluence: оператор задаёт сайты (`confluence.instances`) и, если нужно, список разрешённых пространств, пользователь выпускает API token в своём профиле Atlassian и вводит его вместе с почтой аккаунта. Если сайт один, выбор не показывается; если сайтов нет, карточка говорит об этом и формы не показывает. Плагин прочитает `/wiki/rest/api/user/current`, покажет подключённый аккаунт, а список возможностей останется в границах, которые разрешил оператор: сам Confluence не сообщает, какие права выданы API token.
1054
+ Для Confluence: оператор задаёт сайты (`confluence.instances`) с типом каждого (`deploymentType`) и, если нужно, список разрешённых пространств. Пользователь вводит то, что принимает его сайт: API token вместе с почтой аккаунта для Cloud, личный токен доступа без почты для Server / Data Center. Если сайт один, выбор не показывается; если сайтов нет, карточка говорит об этом и формы не показывает. Плагин прочитает текущего пользователя по API объявленного продукта (`/wiki/rest/api/user/current` или `/rest/api/user/current`), покажет подключённый аккаунт, а список возможностей останется в границах, которые разрешил оператор: сам Confluence не сообщает, какие права выданы токену.
1016
1055
 
1017
1056
  Для Test IT: оператор перечисляет инсталляции (`testit.instances`), пользователь создаёт API-токен в своём профиле Test IT, выбирает инсталляцию (если их несколько) и вставляет токен. Плагин читает `GET /api/v2/projects` — документированный первый проверочный запрос: успешный ответ доказывает и адрес, и токен, а пустой список проектов остаётся валидным результатом. Имени аккаунта карточка не показывает: API v2 не сообщает владельца токена, поэтому подключение подписано инсталляцией и числом видимых проектов, а список возможностей остаётся в границах, которые разрешил оператор.
1018
1057
 
@@ -1027,4 +1066,3 @@ pnpm --filter @yadsh/dsh-qa-integrations check
1027
1066
  ```
1028
1067
 
1029
1068
  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 из секции, которую сам зарегистрировал.
1030
-