@yadsh/dsh-qa-integrations 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/README.md +309 -288
  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 +97 -129
  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 +95 -127
  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 +2825 -785
  27. package/lib/client.js.map +1 -1
  28. package/lib/index.js +192 -51
  29. package/lib/index.js.map +1 -1
  30. package/lib/providers/bitrix24/catalog.js +138 -8
  31. package/lib/providers/bitrix24/catalog.js.map +1 -1
  32. package/lib/providers/bitrix24/config.js +85 -14
  33. package/lib/providers/bitrix24/config.js.map +1 -1
  34. package/lib/providers/bitrix24/index.js +113 -0
  35. package/lib/providers/bitrix24/index.js.map +1 -1
  36. package/lib/providers/confluence/catalog.js +51 -3
  37. package/lib/providers/confluence/catalog.js.map +1 -1
  38. package/lib/providers/confluence/index.js +293 -35
  39. package/lib/providers/confluence/index.js.map +1 -1
  40. package/lib/providers/confluence/operations.js +1 -1
  41. package/lib/providers/confluence/operations.js.map +1 -1
  42. package/lib/providers/jira/catalog.js +73 -3
  43. package/lib/providers/jira/catalog.js.map +1 -1
  44. package/lib/providers/jira/index.js +266 -12
  45. package/lib/providers/jira/index.js.map +1 -1
  46. package/lib/providers/testit/catalog.js +77 -0
  47. package/lib/providers/testit/catalog.js.map +1 -1
  48. package/lib/providers/testit/index.js +277 -3
  49. package/lib/providers/testit/index.js.map +1 -1
  50. package/lib/providers/weblate/catalog.js +103 -9
  51. package/lib/providers/weblate/catalog.js.map +1 -1
  52. package/lib/providers/weblate/index.js +243 -5
  53. package/lib/providers/weblate/index.js.map +1 -1
  54. package/lib/shared/settings.js +14 -0
  55. package/lib/shared/settings.js.map +1 -0
  56. package/lib/typert.host.js +148 -56
  57. package/lib/typert.remote-client.d.ts +13 -11
  58. package/lib/typert.remote-client.js +89 -50
  59. package/lib/types/broker.d.ts +11 -3
  60. package/lib/types/client/bitrix24.d.ts +24 -2
  61. package/lib/types/client/confluence.d.ts +19 -3
  62. package/lib/types/client/index.d.ts +7 -6
  63. package/lib/types/client/integrations.d.ts +2 -2
  64. package/lib/types/client/jira.d.ts +20 -3
  65. package/lib/types/client/operator-card.d.ts +22 -0
  66. package/lib/types/client/operator-controls.d.ts +135 -0
  67. package/lib/types/client/testit.d.ts +14 -1
  68. package/lib/types/client/weblate.d.ts +14 -1
  69. package/lib/types/index.d.ts +81 -13
  70. package/lib/types/providers/bitrix24/catalog.d.ts +8 -0
  71. package/lib/types/providers/bitrix24/config.d.ts +14 -23
  72. package/lib/types/providers/bitrix24/index.d.ts +36 -1
  73. package/lib/types/providers/confluence/catalog.d.ts +11 -3
  74. package/lib/types/providers/confluence/index.d.ts +61 -7
  75. package/lib/types/providers/confluence/operations.d.ts +2 -0
  76. package/lib/types/providers/jira/catalog.d.ts +13 -0
  77. package/lib/types/providers/jira/index.d.ts +48 -1
  78. package/lib/types/providers/testit/catalog.d.ts +12 -0
  79. package/lib/types/providers/testit/index.d.ts +61 -2
  80. package/lib/types/providers/weblate/catalog.d.ts +19 -2
  81. package/lib/types/providers/weblate/index.d.ts +43 -1
  82. package/lib/types/shared/settings.d.ts +14 -0
  83. package/package.json +4 -4
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,39 +121,38 @@ 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
 
@@ -152,18 +161,19 @@ CRM:
152
161
  Кастомные поля фильтруются **по id**, который вернул `jira_get_fields`, или **по алиасу**, который объявил оператор стенда: `customFields: [{ field: "product", value: "…" }]`, с `match: "contains"` для текстовых полей и `empty: true`/`false` для пустого/заполненного. Имя поля Jira не принимается намеренно — на одном сайте легко живут несколько полей с одинаковым именем, а какой из них «продукт», знает только развёртывание: соответствие «алиас → `customfield_…`» задаётся в конфиге оператора (`jira.fieldAliases`), поэтому в репозитории нет ни одного id конкретного инстанса, а каталог полей (`jira_get_fields`) отдаёт объявленные алиасы вместе со схемой. Неизвестное имя — отказ со списком алиасов, а не пустая страница. Люди принимаются как `me`, как accountId или как имя: имя провайдер разрешает через справочник сайта (`/rest/api/3/user/search`, не больше десяти совпадений) и подставляет accountId в запрос, потому что Jira Cloud фильтрует именно по нему. Имя, которое никого не нашло, и имя, которое нашли несколько человек, — это отказ с подсказкой, а не пустая страница: «нет задач» и «фильтр не понят» — разные ответы. Ответ справочника модели не показывается, он только определяет id, по которому построен запрос.
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,15 +217,15 @@ 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
 
@@ -225,24 +235,27 @@ Confluence, как и TeamCity, не сообщает через API, какие
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
 
@@ -321,21 +337,23 @@ TeamCity, в отличие от GitLab и Bitrix24, не сообщает че
321
337
 
322
338
  Подключение — API-токен Atlassian и e-mail аккаунта, которому он принадлежит: Jira Cloud аутентифицирует такой токен через HTTP Basic (`email:token`). Сайты задаёт оператор в конфигурации развёртывания (`jira.sites`) — пользователь выбирает сайт из списка и вводит e-mail с токеном, произвольный хост ввести нельзя. Возможность появляется у пользователя, если её включил оператор (`jira.*Read`).
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
+ | Возможность | Что открывает |
341
+ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
342
+ | `identity.read` | Подключённый пользователь Atlassian и сайт, на котором он работает |
343
+ | `issues.read` | Поиск задач со всем словарём фильтров (включая историю изменений задачи и разрешение имени в accountId) и карточка задачи с описанием, связями и кастомными полями |
344
+ | `comments.read` | Комментарии задачи, включая ограниченные (с пометкой видимости) |
345
+ | `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор |
346
+ | `transitions.read` | Доступные переходы статуса и их обязательные поля |
347
+ | `projects.read` | Карточка проекта |
348
+ | `fields.read` | Схема полей сайта, включая кастомные, — она же источник id для фильтра по кастомному полю |
333
349
 
334
350
  Jira, как и TeamCity, не сообщает через API, какие права выданы конкретному API-токену: токен действует от имени пользователя и наследует его права целиком, а «проверить» записью провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора, а права аккаунта применяет сама Jira — отказ приходит как `ProviderPermissionDenied` (задача, проект или поле закрыты схемой прав, issue security level или схемой ролей), и провайдер никогда не пробует другой credential. Единственная проверка, которую провайдер делает сам при подключении, — тип развёртывания: сайт, который отвечает `deploymentType`, отличным от `Cloud`, отклоняется, потому что Data Center — другой API, и молча считать его совместимым спецификация запрещает.
335
351
 
336
352
  Запись в surface отсутствует: создание, правка, назначение, комментарии и переходы ждут pending actions и карточки подтверждения; удаление, администрирование проектов и workflow, произвольный REST и скачивание содержимого вложений — тоже. Провайдер читает только объявленный allow-list эндпоинтов `/rest/api/3` (гейт пакета падает на любом пути вне него), а легаси-эндпоинт `/rest/api/3/search`, удалённый Atlassian, не используется: поиск идёт через `/rest/api/3/search/jql`.
337
353
 
338
- ## Как подключается TeamCity
354
+ ### Сервисный токен Jira
355
+
356
+ Подключение может работать от сервисного токена развёртывания: профиль называет сайт, секрет — обычный API-токен Atlassian в Basic-паре, а граница ресурсов — `projects` (ключи проектов, сравнение без учёта регистра; числовой id засчитывается, если Jira отдала его в выдаче). Сервисному токену недоступны чтения вложений — даже список метаданий помечен чувствительным, потому что следующий естественный шаг агента — скачать файл. Фильтры JQL по имени человека в сервисном режиме отказывают целиком — это чтение корпоративного справочника, у которого нет проекта в границе, — а фильтры по accountId и `me` остаются. Задача, названная по ключу, сначала раскрывается в свой проект, и чтение с уровнем безопасности, который сервисный токен не проходит, отвечает `ResourceNotFound`, как для чужой задачи.
339
357
 
340
358
  Адрес TeamCity задаёт оператор: сервер один на весь стенд, поэтому `teamcity.serverUrl` — обычная настройка развёртывания, а не поле формы. Пользователь вводит только токен, и токен тратится ровно по этому адресу. Рядом оператор задаёт **политику адресов**: какие адреса этот стенд готов набирать вообще (политика осталась от времён, когда адрес вводил пользователь, и закрывает переезд конфига на чужой хост).
341
359
 
@@ -344,12 +362,12 @@ teamcity:
344
362
  enabled: true
345
363
  serverUrl: https://teamcity.example.internal
346
364
  network:
347
- mode: allowlist # allowlist | trusted-private
365
+ mode: allowlist # allowlist | trusted-private
348
366
  allowedHosts:
349
367
  - teamcity.example.internal
350
368
  - "*.corp.example"
351
369
  allowedCidrs:
352
- - 10.20.0.0/16 # только для адресов, записанных цифрами
370
+ - 10.20.0.0/16 # только для адресов, записанных цифрами
353
371
  allowedPorts:
354
372
  - 443
355
373
  - 8111
@@ -373,7 +391,7 @@ teamcity:
373
391
  ```yaml
374
392
  teamcity:
375
393
  enabled: true
376
- serverUrl: https://teamcity.example.internal # один адрес на весь стенд
394
+ serverUrl: https://teamcity.example.internal # один адрес на весь стенд
377
395
  network:
378
396
  mode: allowlist
379
397
  allowedHosts: [teamcity.example.internal]
@@ -389,12 +407,12 @@ teamcity:
389
407
  investigationsRead: true
390
408
  agentsRead: true
391
409
  artifactsRead: true
392
- maxLogLines: 1000 # потолок строк в ответе по логу
393
- maxLogBytes: 262144 # сколько лога вообще скачиваем
394
- defaultArtifactBytes: 262144 # бюджет чтения артефакта по умолчанию
395
- maxArtifactBytes: 1048576 # жёсткий потолок чтения артефакта
396
- streamTimeoutMs: 30000 # таймаут для логов и артефактов
397
- retries: 2 # повторы для 429/5xx и сетевых сбоев
410
+ maxLogLines: 1000 # потолок строк в ответе по логу
411
+ maxLogBytes: 262144 # сколько лога вообще скачиваем
412
+ defaultArtifactBytes: 262144 # бюджет чтения артефакта по умолчанию
413
+ maxArtifactBytes: 1048576 # жёсткий потолок чтения артефакта
414
+ streamTimeoutMs: 30000 # таймаут для логов и артефактов
415
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
398
416
  ```
399
417
 
400
418
  Токен создаётся в TeamCity (Profile → Access Tokens), при желании с «Limit per project» и read-правами, вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты.
@@ -422,7 +440,7 @@ teamcity:
422
440
  ```yaml
423
441
  confluence:
424
442
  enabled: true
425
- allowInsecureHttp: false # только для dev-стенда
443
+ allowInsecureHttp: false # только для dev-стенда
426
444
  instances:
427
445
  - id: company
428
446
  label: Company
@@ -438,12 +456,12 @@ confluence:
438
456
  commentsRead: true
439
457
  attachmentsRead: true
440
458
  versionsRead: true
441
- allowedSpaces: [] # ключи пространств; пусто = все, что видит аккаунт
442
- defaultBodyChars: 20000 # бюджет тела страницы по умолчанию
443
- maxBodyChars: 60000 # потолок бюджета, который может попросить модель
444
- maxResults: 50 # строк в ответе любого списка (потолок для limit)
445
- maxReplyParents: 10 # сколько комментариев могут принести ответы
446
- retries: 2 # повторы для 429/5xx и сетевых сбоев
459
+ allowedSpaces: [] # ключи пространств; пусто = все, что видит аккаунт
460
+ defaultBodyChars: 20000 # бюджет тела страницы по умолчанию
461
+ maxBodyChars: 60000 # потолок бюджета, который может попросить модель
462
+ maxResults: 50 # строк в ответе любого списка (потолок для limit)
463
+ maxReplyParents: 10 # сколько комментариев могут принести ответы
464
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
447
465
  ```
448
466
 
449
467
  API token выпускается в профиле Atlassian (`Manage profile → Security → API tokens`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты. Если стенду нужен OAuth-аккаунт Atlassian общего вида, а не персональный токен, — это отдельная фаза.
@@ -463,7 +481,9 @@ API token выпускается в профиле Atlassian (`Manage profile
463
481
  - **Rate limiting** (раздел «Rate limiting»): лимиты по principal, ресурсу и глобальные не считаются; вместо них — ограниченные размеры ответов и повторы с backoff для 429/5xx.
464
482
  - **Семантический индекс** (раздел «Optional semantic index»), **webhooks** и **Confluence Data Center** (раздел «Compatibility») — не подключены: провайдер работает только с Confluence Cloud.
465
483
 
466
- ## Как подключается Weblate
484
+ ### Сервисный токен Weblate
485
+
486
+ Подключение может работать от сервисного токена развёртывания: профиль называет инстанс, секрет — обычный API-токен Weblate (префикс значения роли не играет), а граница ресурсов — `projects` (слаги проектов; компонент принадлежит проекту, поэтому чтение компонента сверяет его проект). Чувствительных чтений в каталоге нет: всё, что читает провайдер, — переводческие метаданные, а `changes.list` — собственный журнал изменений Weblate, а не сырой вывод VCS. Чтение, названное по id строки, сначала раскрывается в свой проект; скриншоты вне границы и с непроверяемым проектом из выдачи выпадают, а листинг проектов собирается из allowlist с `unavailableResources` для того, что токен не видит.
467
487
 
468
488
  Инстансы Weblate задаёт только оператор: пользователь выбирает инстанс из списка и вставляет API-токен, произвольный хост ввести нельзя. Если инстанс один, выбор не показывается; если инстансов нет, карточка честно сообщает, что подключать нечего, и формы не показывает.
469
489
 
@@ -476,7 +496,7 @@ API token выпускается в профиле Atlassian (`Manage profile
476
496
  ```yaml
477
497
  weblate:
478
498
  enabled: true
479
- allowInsecureHttp: false # только для dev-стенда
499
+ allowInsecureHttp: false # только для dev-стенда
480
500
  instances:
481
501
  - id: corp
482
502
  label: Corporate Weblate
@@ -496,9 +516,9 @@ weblate:
496
516
  changesRead: true
497
517
  statisticsRead: true
498
518
  screenshotsRead: true
499
- maxTextChars: 4000 # символов одной строки, которую видит модель
500
- maxPageSize: 100 # потолок страницы; по умолчанию провайдер просит 20
501
- retries: 2 # повторы для 429/5xx и сетевых сбоев
519
+ maxTextChars: 4000 # символов одной строки, которую видит модель
520
+ maxPageSize: 100 # потолок страницы; по умолчанию провайдер просит 20
521
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
502
522
  ```
503
523
 
504
524
  Список инстансов принимает не больше 16 записей; id — строчные латинские буквы, цифры и дефисы (до 32 символов), без повторов; подпись по умолчанию — имя хоста. Опечатка в инстансе роняет загрузку конфига, а не выбрасывает инстанс молча: пользователь иначе получил бы провайдер, к которому нельзя подключиться, и никакого объяснения. Пустой список — это состояние, а не падение: провайдер зарегистрирован и бездействует, а отказывает форма подключения.
@@ -531,7 +551,7 @@ weblate:
531
551
  ```yaml
532
552
  gitlab:
533
553
  enabled: true
534
- allowInsecureHttp: false # только для dev-стенда
554
+ allowInsecureHttp: false # только для dev-стенда
535
555
  instances:
536
556
  - id: gitlab-com
537
557
  label: GitLab.com
@@ -545,12 +565,12 @@ gitlab:
545
565
  searchRead: true
546
566
  issuesRead: true
547
567
  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 и сетевых сбоев
568
+ ciMetadataRead: true # пайплайны, джобы, их статусы; прежний ciRead задаёт обе половины
569
+ ciLogsRead: true # содержимое лога джоба: только личный аккаунт
570
+ maxFileBytes: 131072 # сколько тела файла отдаём модели
571
+ maxJobLogBytes: 262144 # сколько лога джобы отдаём модели
572
+ maxSearchResults: 50 # потолок per page у поиска
573
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
554
574
  ```
555
575
 
556
576
  OAuth-приложение для GitLab не нужно: подключение идёт персональным токеном. Токен создаётся в GitLab (`User settings → Access tokens`) с read-scope, вводится один раз в карточке, шифруется тем же конвертным хранилищем, что и вебхук Bitrix24, и после сохранения не показывается и не копируется.
@@ -576,7 +596,7 @@ OAuth-приложение для GitLab не нужно: подключение
576
596
  ```yaml
577
597
  jira:
578
598
  enabled: true
579
- allowInsecureHttp: false # только для dev-стенда
599
+ allowInsecureHttp: false # только для dev-стенда
580
600
  sites:
581
601
  - id: company
582
602
  label: company.atlassian.net
@@ -584,8 +604,8 @@ jira:
584
604
  - id: sandbox
585
605
  label: Sandbox
586
606
  baseUrl: https://sandbox.atlassian.net
587
- fieldAliases: # имена кастомных полей ЭТОГО сайта: алиас → customfield_ id
588
- product: customfield_10010 # id берётся из jira_get_fields; в репозитории их нет
607
+ fieldAliases: # имена кастомных полей ЭТОГО сайта: алиас → customfield_ id
608
+ product: customfield_10010 # id берётся из jira_get_fields; в репозитории их нет
589
609
  identityRead: true
590
610
  issuesRead: true
591
611
  commentsRead: true
@@ -593,11 +613,11 @@ jira:
593
613
  transitionsRead: true
594
614
  projectsRead: true
595
615
  fieldsRead: true
596
- defaultSearchLimit: 20 # строк в ответе поиска, если модель не просила
597
- maxSearchLimit: 100 # потолок страницы; больше Jira не отдаёт
598
- maxCommentLimit: 100 # потолок страницы комментариев
599
- maxTextChars: 20000 # бюджет одного описания, комментария или rich-поля
600
- retries: 2 # повторы для 429/5xx и сетевых сбоев
616
+ defaultSearchLimit: 20 # строк в ответе поиска, если модель не просила
617
+ maxSearchLimit: 100 # потолок страницы; больше Jira не отдаёт
618
+ maxCommentLimit: 100 # потолок страницы комментариев
619
+ maxTextChars: 20000 # бюджет одного описания, комментария или rich-поля
620
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
601
621
  ```
602
622
 
603
623
  OAuth-приложение для Jira не нужно: подключение идёт API-токеном. Токен создаётся в аккаунте Atlassian (`id.atlassian.com → Безопасность → API-токены`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты — вместе с e-mail аккаунта, потому что Jira аутентифицирует пару `email:token`, а не токен отдельно. После сохранения ни то, ни другое не показывается и не копируется.
@@ -624,46 +644,46 @@ Test IT — система управления тестированием: те
624
644
  и результаты. Все 22 инструмента только читают; каждый называет capability, и
625
645
  выключенную оператором возможность агент не получает вовсе.
626
646
 
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` | Конфигурации проекта, в разрезе которых считаются результаты |
647
+ | Tool | Что делает |
648
+ | -------------------------------- | ------------------------------------------------------------------- |
649
+ | `testit_connection_get` | К какой инсталляции подключено и видит ли токен проекты |
650
+ | `testit_projects` | Проекты с числом тест-кейсов, чек-листов и автотестов |
651
+ | `testit_project_get` | Карточка проекта: описание, счётчики, схема атрибутов |
652
+ | `testit_sections` | Разделы (папки) тест-библиотеки проекта |
653
+ | `testit_work_items` | Тест-кейсы, чек-листы и общие шаги проекта по фильтрам |
654
+ | `testit_work_item_get` | Тест-кейс целиком: шаги, предусловия, атрибуты, теги, вложения |
655
+ | `testit_work_item_history` | История изменений: кто что поменял, из чего в что |
656
+ | `testit_work_item_comments` | Комментарии к тест-кейсу |
657
+ | `testit_work_item_test_results` | История результатов тест-кейса по прогонам и конфигурациям |
658
+ | `testit_test_plans` | Тест-планы проекта со статусом и сроками |
659
+ | `testit_test_plan_get` | Карточка тест-плана |
660
+ | `testit_test_plan_summary` | Прогресс плана: тест-поинты, автоматизация, дефекты |
661
+ | `testit_test_runs` | Прогоны проекта по состояниям, датам и тест-плану |
662
+ | `testit_test_run_get` | Карточка прогона |
663
+ | `testit_test_run_results` | Что было в прогоне: тест-поинты с итогом и результатами |
664
+ | `testit_test_result_get` | Результат теста: шаги, длительность, сообщение, трейсы |
665
+ | `testit_test_result_attachments` | Метаданные вложений результата |
666
+ | `testit_attachment_metadata` | Метаданные вложения |
667
+ | `testit_attachment_text` | Текст небольшого текстового вложения (бинарные и архивы отбиваются) |
668
+ | `testit_auto_tests` | Автотесты проекта: класс, пространство имён, стабильность |
669
+ | `testit_auto_test_get` | Карточка автотеста: шаги, setup, teardown, последний результат |
670
+ | `testit_configurations` | Конфигурации проекта, в разрезе которых считаются результаты |
651
671
 
652
672
  ## Возможности и скопы Test IT
653
673
 
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` | Конфигурации проекта |
674
+ | Возможность | Что открывает |
675
+ | --------------------- | ------------------------------------------------------------ |
676
+ | `projects.read` | Проекты и карточка проекта, проба подключения |
677
+ | `sections.read` | Разделы тест-библиотеки |
678
+ | `workItems.read` | Тест-кейсы, чек-листы, общие шаги |
679
+ | `history.read` | История изменений тест-кейса |
680
+ | `comments.read` | Комментарии тест-кейса |
681
+ | `testPlans.read` | Тест-планы, карточка и сводка |
682
+ | `testRuns.read` | Прогоны и карточка прогона |
683
+ | `testResults.read` | Результаты прогона, отдельный результат, история результатов |
684
+ | `autoTests.read` | Автотесты |
685
+ | `attachments.read` | Метаданные вложений и текст текстовых файлов |
686
+ | `configurations.read` | Конфигурации проекта |
667
687
 
668
688
  Сужения по «выданным правам» здесь нет: API v2 не сообщает, какие права у
669
689
  токена (в отличие от вебхука Bitrix24 с его scope и GitLab с
@@ -678,7 +698,9 @@ Test IT — система управления тестированием: те
678
698
  по правилу «каждая операция каталога — GET». Что из-за этого недоступно и чем
679
699
  заменено — в [SPEC-providers-testit.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/docs/SPEC-providers-testit.md).
680
700
 
681
- ## Как подключается Test IT
701
+ ### Сервисный токен Test IT
702
+
703
+ Подключение может работать от сервисного токена развёртывания: профиль называет инсталляцию, секрет — обычный API-токен, а граница ресурсов — `projects` (id проектов, точное сравнение — иерархии проектов у Test IT нет). Сервисному токену недоступны вложения целиком: даже метаданные не несут проект, поэтому глобальный id нечем сверить с границей — каталог отвечает отказом, а не молча; тело вложения чувствительно и в личном режиме читается только у маленьких текстовых файлов. Чтение, адресованное id (тест-кейс, план, прогон, результат), сначала раскрывается в свой проект, и чтение вне границы отказывает до обращения к собственно объекту; листинг `projects.list` собирается из allowlist, а не из того, что видит токен.
682
704
 
683
705
  Test IT бывает облачный и self-hosted, поэтому адрес задаёт оператор стенда
684
706
  списком инсталляций (`testit.instances`) — пользователь выбирает инсталляцию из
@@ -710,12 +732,12 @@ query и фрагмента, а хвостовой слэш снимается.
710
732
  ```yaml
711
733
  testit:
712
734
  enabled: true
713
- allowInsecureHttp: false # лазейка для внутреннего стенда; в проде HTTPS
735
+ allowInsecureHttp: false # лазейка для внутреннего стенда; в проде HTTPS
714
736
  instances:
715
737
  - id: cloud
716
738
  label: Test IT Cloud
717
739
  baseUrl: https://team.example.testit.software
718
- projectsRead: true # флаги возможностей: выключенная не доходит до агента
740
+ projectsRead: true # флаги возможностей: выключенная не доходит до агента
719
741
  sectionsRead: true
720
742
  workItemsRead: true
721
743
  historyRead: true
@@ -726,12 +748,12 @@ testit:
726
748
  autoTestsRead: true
727
749
  attachmentsRead: true
728
750
  configurationsRead: true
729
- defaultResults: 20 # размер списка, когда модель не назвала лимит
730
- maxResults: 100 # жёсткий потолок одного ответа-списка
731
- defaultAttachmentBytes: 262144 # бюджет чтения вложения по умолчанию
732
- maxAttachmentBytes: 10485760 # жёсткий потолок чтения вложения (10 MiB)
733
- attachmentTimeoutMs: 30000 # таймаут скачивания вложения
734
- retries: 2 # повторы для 429/5xx и сетевых сбоев
751
+ defaultResults: 20 # размер списка, когда модель не назвала лимит
752
+ maxResults: 100 # жёсткий потолок одного ответа-списка
753
+ defaultAttachmentBytes: 262144 # бюджет чтения вложения по умолчанию
754
+ maxAttachmentBytes: 10485760 # жёсткий потолок чтения вложения (10 MiB)
755
+ attachmentTimeoutMs: 30000 # таймаут скачивания вложения
756
+ retries: 2 # повторы для 429/5xx и сетевых сбоев
735
757
  ```
736
758
 
737
759
  ## Чего в Test IT-провайдере ещё нет
@@ -765,7 +787,7 @@ testit:
765
787
 
766
788
  ## Сервисные токены (managed service credentials)
767
789
 
768
- Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у GitLab и TeamCity; остальные интеграции сервисного режима не предлагают, и в их карточках о нём ничего не появляется.
790
+ Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у всех семи интеграций; классификация service-safe операций у каждой своя, и чувствительные чтения каждого провайдера перечислены в его разделе.
769
791
 
770
792
  ```yaml
771
793
  managedServiceCredentials:
@@ -774,8 +796,8 @@ managedServiceCredentials:
774
796
  profiles:
775
797
  - id: gitlab-corp-readonly
776
798
  provider: gitlab
777
- instance: corp # id из gitlab.instances
778
- label: QA GitLab Read-only # псевдоним, который видит пользователь
799
+ instance: corp # id из gitlab.instances
800
+ label: QA GitLab Read-only # псевдоним, который видит пользователь
779
801
  credential:
780
802
  type: pat
781
803
  secretFile: /run/secrets/qa_gitlab_service_token
@@ -786,10 +808,10 @@ managedServiceCredentials:
786
808
  groups:
787
809
  - group/platform
788
810
  policy:
789
- gitlab.issues.read: deny # только сужение; "allow" отвергается при загрузке
811
+ gitlab.issues.read: deny # только сужение; "allow" отвергается при загрузке
790
812
  - id: teamcity-readonly
791
813
  provider: teamcity
792
- instance: teamcity # сервер TeamCity один, id фиксирован
814
+ instance: teamcity # сервер TeamCity один, id фиксирован
793
815
  label: QA TeamCity Read-only
794
816
  credential:
795
817
  type: personal_access_token
@@ -799,13 +821,13 @@ managedServiceCredentials:
799
821
  - PLATFORM
800
822
  ```
801
823
 
802
- `enabled` по умолчанию `false`: пока развёртывание не включило срез, о сервисном токене нет ни строчки — ни чекбокса в форме подключения, ни профилей, ни нового поведения. `defaultForNewConnections` решает, с какого режима начинается новое подключение. `resources` обязателен и проверяется при загрузке: профиль без границы — это общий аккаунт, который видит всё, что видит его владелец, и ровно этого возможность не допускает. Записи `resources` — те идентификаторы, которые принимает сам провайдер: id проекта GitLab или полный путь, путь группы, id проекта TeamCity. Секрет берётся из смонтированного файла (`secretFile`) или из переменной окружения (`secretEnv`) — ровно один из двух, в YAML он не лежит. Опечатка в профиле роняет загрузку конфига, а не выбрасывает профиль молча: сообщение называет профиль или инстанс и говорит, что именно не так, — неизвестный провайдер, неизвестный инстанс, инстанс, занятый двумя профилями, или `resources`, не назвавший ни одного вида ресурсов.
824
+ `enabled` по умолчанию `false`: пока развёртывание не включило срез, о сервисном токене нет ни строчки — ни чекбокса в форме подключения, ни профилей, ни нового поведения. `defaultForNewConnections` решает, с какого режима начинается новое подключение. `resources` обязателен и проверяется при загрузке: профиль без границы — это общий аккаунт, который видит всё, что видит его владелец, и ровно этого возможность не допускает. Записи `resources` — те идентификаторы, которые принимает сам провайдер, и словарь границы у каждого свой: `projects` (id проекта GitLab или полный путь, путь группы, id проекта TeamCity, Jira и Test IT, слаг проекта Weblate), `spaces` (ключи пространств Confluence) и `portals` (хост портала Bitrix24 — единственная граница, потому что Bitrix24 не дробит доступ по проектам). Секрет берётся из смонтированного файла (`secretFile`) или из переменной окружения (`secretEnv`) — ровно один из двух, в YAML он не лежит; у Bitrix24 секрет — полный URL сервисного входящего вебхука, портал брокер выводит из него сам. Опечатка в профиле роняет загрузку конфига, а не выбрасывает профиль молча: сообщение называет профиль или инстанс и говорит, что именно не так, — неизвестный провайдер, неизвестный инстанс, инстанс, занятый двумя профилями, или `resources`, не назвавший ни одного вида ресурсов.
803
825
 
804
826
  Новое подключение начинается на сервисном токене, когда профиль для выбранного инстанса есть и `defaultForNewConnections` включён (по умолчанию так): чекбокс «Использовать сервисный токен» в форме уже отмечен, поля токена нет вовсе, а кнопка называется «Подключить сервисный токен». Снятая галочка возвращает обычную форму с personal access token. У уже существующих подключений режим не меняется: он хранится в самом подключении, поэтому обновление стенда не переводит пользователя на общий аккаунт само. В подключённой карточке режим виден строкой «Сервисный аккаунт · управляется администратором», а рядом — «Изменить доступ» и «Использовать личный аккаунт».
805
827
 
806
- Сервисный режим — не «read-only вообще», а жёсткий потолок: только `read`, только обычная чувствительность и только операции, которые провайдер пометил service-safe намеренно. Запись, админ-действия, управление правами и токенами и произвольный REST недостижимы, даже если сервисный токен наверху это умеет: классификация операции — свойство каталога провайдера, а не прав токена. Чувствительные чтения остаются личными: через общий аккаунт не читаются лог CI-джоба GitLab (`ci.logs.read`), лог сборки TeamCity (`logs.read`) и текст артефакта (`artifacts.read`), а конфиденциальная задача GitLab не возвращается вовсе — прямое чтение отвечает `ResourceNotFound`, из выдачи и из поиска она выпадает, а поиск по комментариям (`scope: notes`) отказывается целиком: у комментария нет признака конфиденциальности, и проверить его родителя одним запросом нельзя. Операция, которую провайдер не классифицировал, отклоняется по умолчанию: инструмент, добавленный обновлением провайдера, недостижим через общий аккаунт, пока кто-то не классифицирует его намеренно. Администраторская `policy` может только выключить: `allow` в профиле отвергается при загрузке, потому что оператор, написавший `allow`, считает, что расширил потолок.
828
+ Сервисный режим — не «read-only вообще», а жёсткий потолок: только `read`, только обычная чувствительность и только операции, которые провайдер пометил service-safe намеренно. Запись, админ-действия, управление правами и токенами и произвольный REST недостижимы, даже если сервисный токен наверху это умеет: классификация операции — свойство каталога провайдера, а не прав токена. Чувствительные чтения остаются личными: через общий аккаунт не читаются лог CI-джоба GitLab (`ci.logs.read`), лог сборки TeamCity (`logs.read`) и текст артефакта (`artifacts.read`), тело вложения Test IT и Confluence, содержимое Диска Bitrix24, переписки и открытые линии Bitrix24, календарь занятости и справочник сотрудников с телефонами, а конфиденциальная задача GitLab не возвращается вовсе — прямое чтение отвечает `ResourceNotFound`, из выдачи и из поиска она выпадает, а поиск по комментариям (`scope: notes`) отказывается целиком: у комментария нет признака конфиденциальности, и проверить его родителя одним запросом нельзя. У Weblate, где нет операций уровня журналов, чувствительных чтений нет вовсе. Операция, которую провайдер не классифицировал, отклоняется по умолчанию: инструмент, добавленный обновлением провайдера, недостижим через общий аккаунт, пока кто-то не классифицирует его намеренно. Администраторская `policy` может только выключить: `allow` в профиле отвергается при загрузке, потому что оператор, написавший `allow`, считает, что расширил потолок.
807
829
 
808
- Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с allowlist каждый вызов: проект, названный по id или по пути, должен быть в списке или под перечисленной группой; сборка TeamCity, названная по id, сначала разрешается в свой проект; листинг, не называющий проект, отказывается, а не отвечает всей картиной, доступной общему аккаунту. Список проектов (`gitlab_projects_list`, `teamcity_projects`) собирается из allowlist, а не из того, что видит сервисный токен: проект, которого токен не видит, приходит в `unavailableResources`, а не исчезает молча, — это и есть ответ оператору, что граница и токен разошлись. Разворачивая группу GitLab, провайдер просит только её собственные проекты (`with_shared=false`) и дополнительно сверяет каждый вернувшийся проект с границей: чужой проект, расшаренный в группу, в выдачу не попадает. Пользователь может сузить список в карточке кнопкой «Изменить доступ», но не расширить: выбор вне администраторского списка отбрасывается и не сохраняется.
830
+ Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с allowlist каждый вызов: проект, названный по id или по пути, должен быть в списке или под перечисленной группой; сборка TeamCity, названная по id, сначала разрешается в свой проект; страница Confluence, названная по id, — в своё пространство; задача Jira и запись Test IT — в свой проект; компонент Weblate — в свой проект-слаг; вебхук Bitrix24 обязан отвечать на портале, названном в границе, — других идентификаторов у границы этого провайдера нет. Листинг, не называющий ресурс, отказывается, а не отвечает всей картиной, доступной общему аккаунту. Списки (`gitlab_projects_list`, `teamcity_projects`, `projects.list` Weblate, `projects.list` Test IT) собираются из allowlist, а не из того, что видит сервисный токен: ресурс, которого токен не видит, приходит в `unavailableResources`, а не исчезает молча, — это и есть ответ оператору, что граница и токен разошлись. Разворачивая группу GitLab, провайдер просит только её собственные проекты (`with_shared=false`) и дополнительно сверяет каждый вернувшийся проект с границей: чужой проект, расшаренный в группу, в выдачу не попадает. Пользователь может сузить список в карточке кнопкой «Изменить доступ», но не расширить: выбор вне администраторского списка отбрасывается и не сохраняется.
809
831
 
810
832
  Режим — одно из двух явных значений, `personal` или `service`; `auto` не существует. Отказ в личном режиме (`403` от GitLab или TeamCity) — это отказ: его не повторяют сервисным токеном, и наоборот тоже. Если личный токен был сохранён раньше, он остаётся зашифрованным в хранилище, но не тратится, пока подключение работает на сервисном; «Использовать личный аккаунт» возвращает его, а если личного токена не сохраняли, переключение отвечает `PersonalCredentialRequired` вместо подключения без личности. Переключение в любую сторону поднимает binding revision, поэтому всё, что было выведено из прежней личности, с этого момента недействительно.
811
833
 
@@ -852,7 +874,7 @@ credentialHelp:
852
874
  instructions: Откройте внутреннюю страницу токенов.
853
875
  selfHosted: true
854
876
  jira:
855
- enabled: false # спрятать подсказку; поле секрета остаётся
877
+ enabled: false # спрятать подсказку; поле секрета остаётся
856
878
  weblate:
857
879
  docsLabel: Наша вики
858
880
  ```
@@ -1027,4 +1049,3 @@ pnpm --filter @yadsh/dsh-qa-integrations check
1027
1049
  ```
1028
1050
 
1029
1051
  Unit/integration набор проверяет AEAD, неверный ключ, rewrap, SSRF-ограничение webhook URL, адресов инстансов, политики адресов TeamCity, списка сайтов Jira, инсталляций Test IT и инстансов Weblate, redaction (включая форму gitlab-токена и секреты, напечатанные в логе), escape locator-значений, нарезку и чистку логов, отказ по бинарным и архивным артефактам, отсутствие model-visible identity/secret selectors, отказ unowned/subagent-сессии, соответствие каждого tool операции каталога, read-only характер всех семи каталогов за исключением единственного флагуемого таймлайн-комментария Bitrix24, привязка любой write-методы к `crm.comment.write`, сужение возможностей по scopes вебхука и токена, потолок и границу сервисного токена (включая конфигурацию профилей, отсутствие неявного отката между режимами, ротацию секрета под работающим подключением и аудит реального пользователя), отображение ошибок провайдеров в доменные коды, обрезку больших ответов и параллельную изоляцию Alice/Bob. Для Jira отдельно проверяются экранирование JQL, отказ поиска без фильтров, allow-list читающих путей, рендер ADF и то, что токен не попадает ни в URL, ни в результат тула. Для Confluence — сборка CQL, разбор Atlassian Document Format, политика пространств и отказ токену, чей сайт убрали из конфига. Для Test IT — канонизация списка инсталляций, проба подключения документированным запросом, только-GET каталог, лимиты страниц и вложений, redaction текстовых вложений и отсутствие токена в URL и теле. Для Weblate — сборка `q` с экранированием значений, отказ неподдерживаемым фильтрам и операциям, проверка origin у `next`, нормализация состояний и форм множественного числа, untrusted-маркер и отказ credential, чей инстанс убрали из конфига. Отдельный гейт следит за границей провайдеров: `verify:package` падает, если в общем слое появится имя конкретной интеграции, а тест `provider boundary` — если брокер начнёт зависеть от конкретного провайдера. Собранный клиентский бандл проверяется отдельным тестом: он поднимается в песочнице как в браузере — через `window.__ModuleLoader__` с таблицей модулей, в которой есть только React, — регистрируется под полным именем пакета и монтирует карточку Confluence из секции, которую сам зарегистрировал.
1030
-