@yadsh/dsh-qa-integrations 0.9.0 → 0.10.1
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.
- package/README.md +32 -21
- package/compatibility.json +7 -3
- package/lib/broker.js +172 -17
- package/lib/broker.js.map +1 -1
- package/lib/client/bitrix24.js +8 -6
- package/lib/client/bitrix24.js.map +1 -1
- package/lib/client/card.js +14 -13
- package/lib/client/card.js.map +1 -1
- package/lib/client/confluence.js +11 -7
- package/lib/client/confluence.js.map +1 -1
- package/lib/client/credential-help-note.js +51 -0
- package/lib/client/credential-help-note.js.map +1 -0
- package/lib/client/gitlab.js +8 -6
- package/lib/client/gitlab.js.map +1 -1
- package/lib/client/index.js +38 -32
- package/lib/client/index.js.map +1 -1
- package/lib/client/integrations.js +31 -18
- package/lib/client/integrations.js.map +1 -1
- package/lib/client/jira.js +10 -8
- package/lib/client/jira.js.map +1 -1
- package/lib/client/operator-card.js +93 -534
- package/lib/client/operator-card.js.map +1 -1
- package/lib/client/operator-controls.js +72 -23
- package/lib/client/operator-controls.js.map +1 -1
- package/lib/client/operator-sections/bitrix24.js +22 -0
- package/lib/client/operator-sections/bitrix24.js.map +1 -0
- package/lib/client/operator-sections/confluence.js +27 -0
- package/lib/client/operator-sections/confluence.js.map +1 -0
- package/lib/client/operator-sections/credential-help.js +15 -0
- package/lib/client/operator-sections/credential-help.js.map +1 -0
- package/lib/client/operator-sections/general.js +8 -0
- package/lib/client/operator-sections/general.js.map +1 -0
- package/lib/client/operator-sections/gitlab.js +41 -0
- package/lib/client/operator-sections/gitlab.js.map +1 -0
- package/lib/client/operator-sections/jira.js +25 -0
- package/lib/client/operator-sections/jira.js.map +1 -0
- package/lib/client/operator-sections/provider-section.js +21 -0
- package/lib/client/operator-sections/provider-section.js.map +1 -0
- package/lib/client/operator-sections/service-profiles.js +178 -0
- package/lib/client/operator-sections/service-profiles.js.map +1 -0
- package/lib/client/operator-sections/shared.js +192 -0
- package/lib/client/operator-sections/shared.js.map +1 -0
- package/lib/client/operator-sections/teamcity.js +42 -0
- package/lib/client/operator-sections/teamcity.js.map +1 -0
- package/lib/client/operator-sections/testit.js +35 -0
- package/lib/client/operator-sections/testit.js.map +1 -0
- package/lib/client/operator-sections/weblate.js +32 -0
- package/lib/client/operator-sections/weblate.js.map +1 -0
- package/lib/client/operator-service-reach.js +98 -0
- package/lib/client/operator-service-reach.js.map +1 -0
- package/lib/client/provider-card.js +32 -19
- package/lib/client/provider-card.js.map +1 -1
- package/lib/client/styles.js +52 -15
- package/lib/client/styles.js.map +1 -1
- package/lib/client/teamcity.js +7 -5
- package/lib/client/teamcity.js.map +1 -1
- package/lib/client/testit.js +8 -6
- package/lib/client/testit.js.map +1 -1
- package/lib/client/weblate.js +8 -6
- package/lib/client/weblate.js.map +1 -1
- package/lib/client.js +2838 -1923
- package/lib/client.js.map +1 -1
- package/lib/config.js +64 -17
- package/lib/config.js.map +1 -1
- package/lib/errors.js +5 -0
- package/lib/errors.js.map +1 -1
- package/lib/index.js +176 -222
- package/lib/index.js.map +1 -1
- package/lib/providers/bitrix24/tools.js +7 -2
- package/lib/providers/bitrix24/tools.js.map +1 -1
- package/lib/providers/bitrix24/transport.js +28 -8
- package/lib/providers/bitrix24/transport.js.map +1 -1
- package/lib/providers/confluence/config.js +14 -55
- package/lib/providers/confluence/config.js.map +1 -1
- package/lib/providers/confluence/tools.js +7 -2
- package/lib/providers/confluence/tools.js.map +1 -1
- package/lib/providers/confluence/transport.js +42 -78
- package/lib/providers/confluence/transport.js.map +1 -1
- package/lib/providers/gitlab/config.js +11 -55
- package/lib/providers/gitlab/config.js.map +1 -1
- package/lib/providers/gitlab/operations.js +3 -3
- package/lib/providers/gitlab/operations.js.map +1 -1
- package/lib/providers/gitlab/tools.js +7 -2
- package/lib/providers/gitlab/tools.js.map +1 -1
- package/lib/providers/gitlab/transport.js +33 -65
- package/lib/providers/gitlab/transport.js.map +1 -1
- package/lib/providers/jira/config.js +18 -58
- package/lib/providers/jira/config.js.map +1 -1
- package/lib/providers/jira/jql.js +105 -1
- package/lib/providers/jira/jql.js.map +1 -1
- package/lib/providers/jira/tools.js +68 -2
- package/lib/providers/jira/tools.js.map +1 -1
- package/lib/providers/jira/transport.js +44 -110
- package/lib/providers/jira/transport.js.map +1 -1
- package/lib/providers/kernel/address.js +90 -0
- package/lib/providers/kernel/address.js.map +1 -0
- package/lib/providers/kernel/errors.js +42 -0
- package/lib/providers/kernel/errors.js.map +1 -0
- package/lib/providers/kernel/read-policy.js +276 -0
- package/lib/providers/kernel/read-policy.js.map +1 -0
- package/lib/providers/kernel/token.js +45 -0
- package/lib/providers/kernel/token.js.map +1 -0
- package/lib/providers/shared/service-boundary.js +31 -3
- package/lib/providers/shared/service-boundary.js.map +1 -1
- package/lib/providers/teamcity/tools.js +8 -3
- package/lib/providers/teamcity/tools.js.map +1 -1
- package/lib/providers/teamcity/transport.js +6 -8
- package/lib/providers/teamcity/transport.js.map +1 -1
- package/lib/providers/testit/config.js +12 -57
- package/lib/providers/testit/config.js.map +1 -1
- package/lib/providers/testit/tools.js +7 -2
- package/lib/providers/testit/tools.js.map +1 -1
- package/lib/providers/testit/transport.js +12 -12
- package/lib/providers/testit/transport.js.map +1 -1
- package/lib/providers/weblate/config.js +12 -55
- package/lib/providers/weblate/config.js.map +1 -1
- package/lib/providers/weblate/tools.js +7 -2
- package/lib/providers/weblate/tools.js.map +1 -1
- package/lib/providers/weblate/transport.js +21 -20
- package/lib/providers/weblate/transport.js.map +1 -1
- package/lib/public-api.js +79 -0
- package/lib/public-api.js.map +1 -0
- package/lib/repository.js +65 -16
- package/lib/repository.js.map +1 -1
- package/lib/service-credentials/policy.js +14 -1
- package/lib/service-credentials/policy.js.map +1 -1
- package/lib/tool-kit.js +34 -7
- package/lib/tool-kit.js.map +1 -1
- package/lib/tools.js +49 -24
- package/lib/tools.js.map +1 -1
- package/lib/typert.host.js +455 -351
- package/lib/typert.remote-client.js +450 -336
- package/lib/types/broker.d.ts +65 -1
- package/lib/types/client/card.d.ts +13 -4
- package/lib/types/client/credential-help-note.d.ts +26 -0
- package/lib/types/client/index.d.ts +15 -7
- package/lib/types/client/integrations.d.ts +5 -4
- package/lib/types/client/operator-card.d.ts +56 -4
- package/lib/types/client/operator-controls.d.ts +31 -0
- package/lib/types/client/operator-sections/bitrix24.d.ts +12 -0
- package/lib/types/client/operator-sections/confluence.d.ts +10 -0
- package/lib/types/client/operator-sections/credential-help.d.ts +17 -0
- package/lib/types/client/operator-sections/general.d.ts +11 -0
- package/lib/types/client/operator-sections/gitlab.d.ts +13 -0
- package/lib/types/client/operator-sections/jira.d.ts +11 -0
- package/lib/types/client/operator-sections/provider-section.d.ts +58 -0
- package/lib/types/client/operator-sections/service-profiles.d.ts +13 -0
- package/lib/types/client/operator-sections/shared.d.ts +123 -0
- package/lib/types/client/operator-sections/teamcity.d.ts +11 -0
- package/lib/types/client/operator-sections/testit.d.ts +10 -0
- package/lib/types/client/operator-sections/weblate.d.ts +10 -0
- package/lib/types/client/operator-service-reach.d.ts +76 -0
- package/lib/types/client/provider-card.d.ts +14 -3
- package/lib/types/client/styles.d.ts +28 -4
- package/lib/types/config.d.ts +49 -2
- package/lib/types/errors.d.ts +24 -0
- package/lib/types/index.d.ts +54 -117
- package/lib/types/providers/bitrix24/tools.d.ts +2 -5
- package/lib/types/providers/confluence/tools.d.ts +2 -6
- package/lib/types/providers/confluence/transport.d.ts +0 -6
- package/lib/types/providers/gitlab/config.d.ts +1 -1
- package/lib/types/providers/gitlab/tools.d.ts +2 -6
- package/lib/types/providers/gitlab/transport.d.ts +3 -5
- package/lib/types/providers/jira/tools.d.ts +2 -6
- package/lib/types/providers/jira/transport.d.ts +2 -11
- package/lib/types/providers/kernel/address.d.ts +57 -0
- package/lib/types/providers/kernel/errors.d.ts +34 -0
- package/lib/types/providers/kernel/read-policy.d.ts +118 -0
- package/lib/types/providers/kernel/token.d.ts +25 -0
- package/lib/types/providers/shared/service-boundary.d.ts +15 -0
- package/lib/types/providers/teamcity/tools.d.ts +2 -6
- package/lib/types/providers/teamcity/transport.d.ts +1 -1
- package/lib/types/providers/testit/tools.d.ts +2 -6
- package/lib/types/providers/testit/transport.d.ts +1 -1
- package/lib/types/providers/weblate/tools.d.ts +2 -6
- package/lib/types/public-api.d.ts +80 -0
- package/lib/types/repository.d.ts +62 -2
- package/lib/types/tool-kit.d.ts +27 -1
- package/lib/types/tools.d.ts +26 -9
- package/lib/types/types.d.ts +17 -3
- package/package.json +25 -23
- package/lib/providers/shared/http.js +0 -168
- package/lib/providers/shared/http.js.map +0 -1
- package/lib/types/providers/shared/http.d.ts +0 -60
package/README.md
CHANGED
|
@@ -2,17 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
Персональные интеграции для `@yadsh/dsh-qa-surface`. Плагин подключает Bitrix24 через URL входящего вебхука, GitLab через personal access token, TeamCity через access token, Jira и Confluence — через API-токен Atlassian, Test IT — через API-токен системы управления тестированием, а Weblate — через API-токен платформы локализации, после чего даёт агенту набор read-only инструментов, ограниченный и правами подключения, и персональной политикой пользователя; единственное исключение — комментарий в таймлайн Bitrix24, который монтируется только явным флагом оператора. У всех семи интеграций подключение может работать не только от личного токена, но и от сервисного токена развёртывания — общего read-only аккаунта с жёстким потолком режима (раздел «Сервисные токены»).
|
|
4
4
|
|
|
5
|
-
Плагин показывает подключения двумя монтированиями одного и того же набора карточек: отдельным разделом **«Интеграции»** в пользовательских настройках QA и
|
|
5
|
+
Плагин показывает подключения двумя монтированиями одного и того же набора карточек: отдельным разделом **«Интеграции»** в пользовательских настройках QA и секцией конфигурации самого плагина на панели **«Плагины»** оригинального DSH (слот `plugins.bundle.config`, ключ — имя пакета). Панель рисуется клиентом и не читает loopback-only каталог Host settings: в установленном `@deepseek-ai/dsh-client-ui-plugin-manager` 0.1.7-rc.2 ветки `isLoopback` нет вовсе, а единственный loopback-выбор на стороне настроек выбирает режим записи — `host` или `memory` — и не зависит от того, на каком слоте висит карточка. Поэтому секция доступна и в LAN-браузере, где тот каталог намеренно отключён. Слот выбран по `AGENTS.md` («Choosing the registration point»): карточка конфигурации плагина сидит на панели «Плагины», а не в диалоге настроек. Оболочку карточка не рисует: на ряду панели «Плагины» страницу, заголовок строки, id строки и описание выдаёт хост, а карточка монтирует только тело — own shell остаётся за `settings.section` и `settings.plugins.tab` (решение владельца от 01.10, влитое в контракт #684). Кольцо фокуса строится из хозяйских токенов `--dsw-focus-ring-width` / `--dsw-focus-ring-color` с fallback у каждой половины. Клик-обход живого не-loopback стенда — пункт приёмки переноса. Она читает аккаунт через клиентский сервис `qaUserSession` плагина `@yadsh/dsh-qa-surface`: без входа в QA ничего не показывает и не делает запросов. Токен вводится один раз, шифруется на Host и никогда не возвращается браузеру. Выбор пользователя, integration id, secret id или токена отсутствует в model-visible схемах: principal берётся из DSH-сессии, а Bitrix user id — из сохранённой записи интеграции.
|
|
6
6
|
|
|
7
7
|
## Операторская карточка настроек
|
|
8
8
|
|
|
9
|
-
Кроме двух пользовательских монтирований, плагин
|
|
9
|
+
Кроме двух пользовательских монтирований, плагин рисует операторскую карточку по своей конфигурации — секцией конфигурации своей строки профиля на панели **«Плагины»** (слот `plugins.row.config`, ключ `@yadsh/dsh-qa-integrations#qa-integrations`), под секцией аккаунта. На хосте 0.1.7 роль settings namespace играет id строки профиля (`qa-integrations`), а доступными для браузера становятся те поля, чей узел схемы помечен `.volatile()`; карточка берёт форму этого входа через `ctx.configForms` и появляется вместе с рядом, не дожидаясь Remote-описания развёртывания. Ключ нового места собран из того же id строки и имени пакета, поэтому переехало только место рендера: значение, сохранённое до переноса, читается после. Обе карточки живут на панели «Плагины», куда не нужен loopback-only каталог Host settings, и каждая монтирует только тело — рамку, заголовок и раскрытие рядом рисует сама страница плагина. Операторская карточка — третья поверхность того же бандла, и она не требует ни входа в QA, ни Remote-описания развёртывания: оператор включается и настраивает плагин из этой карточки, даже когда плагин ещё выключен.
|
|
10
10
|
|
|
11
|
-
Карточка читается сверху вниз: у каждой секции в свёрнутом виде строка состояния (включён ли провайдер, сколько подключений настроено, сколько возможностей открыто), а внутри — четыре подписанных блока: «Провайдер» (выключатели провайдера), «Подключение» (инстансы, сайты, адреса и сетевые политики во всю ширину), «Что доступно агенту» (чек-лист возможностей, флажок перед подписью) и свёрнутые «Ограничения и повторы» (потолки, таймауты, повторы при ошибках). Подпись поля связана с самим полем: клик по названию ставит курсор в него.
|
|
11
|
+
Карточка читается сверху вниз: у каждой секции в свёрнутом виде строка состояния (включён ли провайдер, сколько подключений настроено, сколько возможностей открыто), а внутри — четыре подписанных блока: «Провайдер» (выключатели провайдера), «Подключение» (инстансы, сайты, адреса и сетевые политики во всю ширину), «Что доступно агенту» (чек-лист возможностей, флажок перед подписью) и свёрнутые «Ограничения и повторы» (потолки, таймауты, повторы при ошибках). Подпись поля связана с самим полем: клик по названию ставит курсор в него. Переключатель, до которого сервисный токен развёртывания не дотягивается целиком или частично, говорит об этом прямо в чек-листе («с сервисным токеном недоступно: требуется личный аккаунт»): сам по себе включённый флажок ничего оператору не объясняет, а пользователь с отказом читает его как сломанную интеграцию. Заметка появляется только при включённых сервисных доступах и снимается самим переключателем по его пути в конфигурации: копии имени флага в карточке нет, опечатать в ней нечего. `tests/client/operator-service-reach.test.ts` сверяет таблицу заметок с классификацией каждого каталога, а `tests/client/operator-card.test.tsx` считает заметки в отрисованной карточке — карточка не сможет разойтись с тем, что провайдер на самом деле разрешает общему аккаунту.
|
|
12
12
|
|
|
13
|
-
Карточка покрывает всю разрешённую резолверами конфигурацию: общие ручки (`enabled`, таймаут, потолки ответа и аудита, пути хранилища и мастер-ключа, суффиксы порталов Bitrix24), у каждого провайдера — выключатель, возможности, инстансы/сайты (строки id/название/адрес) и лимиты, у TeamCity — адрес сервера и сетевую политику, у Jira — псевдонимы полей, плюс сервисные доступы (профили с ресурсными границами и deny-политикой) и замены встроенных подсказок получения токена (`credentialHelp`). Каждое поле помечает, что пользовательский слой namespace переопределяет композиционную строку профиля, одна кнопка очищает слой
|
|
13
|
+
Карточка покрывает всю разрешённую резолверами конфигурацию: общие ручки (`enabled`, таймаут, потолки ответа и аудита, пути хранилища и мастер-ключа, суффиксы порталов Bitrix24), у каждого провайдера — выключатель, возможности, инстансы/сайты (строки id/название/адрес) и лимиты, у TeamCity — адрес сервера и сетевую политику, у Jira — псевдонимы полей, плюс сервисные доступы (профили с ресурсными границами и deny-политикой) и замены встроенных подсказок получения токена (`credentialHelp`). Половины GitLab CI — `ciMetadataRead` и `ciLogsRead` — это в карточке два переключателя, а не один `ciRead`: резолвер отвечает половинами отдельно и складывает в них старое `ciRead`, только пока ни одна из них не названа явно. Единая ручка этого состояния выразить не могла: половина, выключенная отдельно от другой, читалась «включено», а правка по старому имени переставала действовать, как только вторая половина названа. Поэтому карточка читает каждую половину в том же порядке, что и резолвер, — `половина ?? ciRead ?? значение по умолчанию`. Каждое поле помечает, что пользовательский слой namespace переопределяет композиционную строку профиля, одна кнопка очищает слой целиком. Хост проверяет правку по схеме и отвергает то, что схема не позволяет; кросс-полевые ограничения (политика хостов TeamCity, дубликат id в списке инстансов) схема выразить не может, и их держат резолверы: значение, которое они не принимают, остаётся в документе профиля, а запущенный сервис сохраняет прежнее состояние и пишет `config.rejected` в лог.
|
|
14
14
|
|
|
15
|
-
Правка применяется к запущенному сервису сразу: брокер перепривязывается к свежему набору провайдеров, монтирование инструментов следует за выключателем плагина и единственным флагом записи. Хранилище подключений и мастер-ключ — сознательное исключение: подключения и зашифрованные секреты живут по путям загрузки, поэтому их правка предупреждает в логе и вступает в силу при следующем рестарте Host. Без
|
|
15
|
+
Правка применяется к запущенному сервису сразу: Loader коммитит её в volatile-ссылки самой строки и сообщает об этом её фибре (`loader/volatile-update`), брокер перепривязывается к свежему набору провайдеров, а монтирование инструментов следует за выключателем плагина и единственным флагом записи. Хранилище подключений и мастер-ключ — сознательное исключение: подключения и зашифрованные секреты живут по путям загрузки, поэтому их правка предупреждает в логе и вступает в силу при следующем рестарте Host. Без отдаваемого namespace карточка объясняет это одной строкой вместо пустой секции, а плагин грузится от своей композиционной строки — настройки профиля ему не нужны, чтобы работать.
|
|
16
16
|
|
|
17
17
|
## Структура
|
|
18
18
|
|
|
@@ -146,7 +146,7 @@ CRM:
|
|
|
146
146
|
| Tool | Что делает |
|
|
147
147
|
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
148
148
|
| `jira_get_current_user` | К какому сайту Jira и каким пользователем Atlassian подключён аккаунт |
|
|
149
|
-
| `jira_search_issues` | Поиск задач: текст, проекты, типы, статусы и их категория, приоритеты, резолюции, компоненты, метки, версии (fix и affected), люди, даты, кастомные поля |
|
|
149
|
+
| `jira_search_issues` | Поиск задач: текст, проекты, типы, статусы и их категория, приоритеты, резолюции, компоненты, метки, версии (fix и affected), люди, даты, история поля, кастомные поля |
|
|
150
150
|
| `jira_get_issue` | Карточка задачи: ключ, ссылка, проект, тип, статус, приоритет, люди, метки, компоненты, версии, резолюция, даты и описание |
|
|
151
151
|
| `jira_get_issue_comments` | Комментарии задачи, от новых к старым; ограниченный комментарий помечен видимостью |
|
|
152
152
|
| `jira_get_issue_attachments` | Метаданные вложений: имя файла, тип, размер, автор; файлы не скачиваются |
|
|
@@ -156,7 +156,11 @@ CRM:
|
|
|
156
156
|
|
|
157
157
|
Модель не получает JQL: фильтры в `jira_search_issues` типизированные, а строку запроса собирает и экранирует провайдер — значение с кавычкой или обратным слэшем остаётся значением и не может добавить условие. Поиск без единого фильтра отказывается: «все задачи сайта» — не вопрос, на который этот инструмент отвечает. Ответы идут по последнему обновлению (сначала свежие) и несут `pagination.nextCursor` — это continuation-токен самого Jira, состояние между вызовами не хранится, а страница не выходит за потолок стенда (`defaultSearchLimit`, `maxSearchLimit`) и за 100 строк, которые Jira отдаёт с полями. Комментарии Jira по-прежнему листаются позицией, поэтому их `pagination` — `{ startAt, returned, total, hasMore }`.
|
|
158
158
|
|
|
159
|
-
|
|
159
|
+
Точное число результатов ищет не провайдер, а продукт: Server / Data Center считает поиск по позиции и отдаёт размер ответа, поэтому его `pagination` несёт `total` (и `startAt`, и следующий offset в `nextCursor`), а Atlassian Cloud на `/search/jql` числа не сообщает вовсе — там остаётся только `nextCursor` и `isLast`, и «сколько всего» превращается в вопрос к самому Jira, а не к этому пакету. Провайдер не выдумывает оценку: счётчика нет в ответе — нет и в конверте.
|
|
160
|
+
|
|
161
|
+
Словарь фильтров покрывает то, что спрашивают у корпоративной Jira, и каждый фильтр — это клауза, которую собирает `jql.ts`: проект, тип задачи, статус и **категория статуса** (`To Do` / `In Progress` / `Done` — «закрытые» одним фильтром, чем бы ни называл их workflow), приоритет, резолюция, компонент, метки (все перечисленные, а не «любая из»), версии — `fixVersions` и `affectedVersions`, включая «не проставлена» (`fixVersionEmpty: true`) и «проставлена» (`false`), исполнитель и автор, даты создания и обновления в обе стороны, **история поля** (`history`, см. ниже) и кастомные поля. Даты принимают и абсолютное значение (`2026-08-01`, ISO-таймстемп), и родной относительный токен Jira (`-3w`, `-2d`, `-4h`, `-30m`), а пара «с/по» — это `createdAfter`/`createdBefore` (границы включительные). Текст ищется двумя способами: `match: "all"` (по умолчанию) требует все слова, `match: "phrase"` — точную фразу; оба варианта бьются на отдельные клаузы `text ~ "…"`, поэтому `OR` из фразы остаётся словом, а не оператором.
|
|
162
|
+
|
|
163
|
+
`history` — фильтр не по тому, что задача несёт сейчас, а по тому, что с ней делали: JQL-операторы `WAS` и `CHANGED` собираются из типизированной записи, `{ field: "status", op: "was", value: "In Progress" }` отвечает «побывали в In Progress», `{ field: "status", op: "changed", after: "-2w" }` — «двигали статус за две недели», `{ field: "assignee", op: "changed", value: "5b10…" }` — «переназначали на вот этого человека». Поле ограничено списком `status`, `assignee`, `reporter`, `priority`, `resolution`, `fixVersion` — тем, у чего Jira ищет историю; кастомное поле здесь отказывается, для него есть `customFields`. Ключевые слова читаются по строгому набору: `was` требует значение и не принимает `from`, `changed` принимает `from` (откуда ушло) и `value` (куда пришло), `by` — кто двигал, дата — один день (`on`) или край окна (`after`/`before`), а день вместе с окном — противоречие. Значения экранируются как любое другое, поэтому история не распахивает запрос: клауза `OR project = SECRET` из `value` остаётся текстом внутри кавычек. Человек здесь — `me` или идентификатор, по которому фильтрует этот продукт, но **не имя**: справочник пользователей за этим фильтром не читается (в отличие от `assignee`/`reporter`, где имя разрешается провайдером), потому что идентификатор уже лежит в истории самой задачи — в `changelog_summary`. Неразборчивая запись отказывается целиком, а не собирается «из того, что удалось распарсить»: молча потерянная граница отвечала бы на другой вопрос, а её ответ выглядел бы как факт о задачах. Клауз — не больше трёх, и они, как остальные фильтры, соединяются через `AND`.
|
|
160
164
|
|
|
161
165
|
Кастомные поля фильтруются **по id**, который вернул `jira_get_fields`, или **по алиасу**, который объявил оператор стенда: `customFields: [{ field: "product", value: "…" }]`, с `match: "contains"` для текстовых полей и `empty: true`/`false` для пустого/заполненного. Имя поля Jira не принимается намеренно — на одном сайте легко живут несколько полей с одинаковым именем, а какой из них «продукт», знает только развёртывание: соответствие «алиас → `customfield_…`» задаётся в конфиге оператора (`jira.fieldAliases`), поэтому в репозитории нет ни одного id конкретного инстанса, а каталог полей (`jira_get_fields`) отдаёт объявленные алиасы вместе со схемой. Неизвестное имя — отказ со списком алиасов, а не пустая страница. Люди принимаются как `me`, как идентификатор, по которому фильтрует эта Jira (accountId у Cloud, логин у Server / Data Center), или как имя: имя провайдер разрешает через справочник сайта (`/rest/api/3/user/search` или `/rest/api/2/user/search`, не больше десяти совпадений) и подставляет этот идентификатор в запрос. Имя, которое никого не нашло, и имя, которое нашли несколько человек, — это отказ с подсказкой, а не пустая страница: «нет задач» и «фильтр не понят» — разные ответы. Ответ справочника модели не показывается, он только определяет id, по которому построен запрос.
|
|
162
166
|
|
|
@@ -342,7 +346,7 @@ TeamCity, в отличие от GitLab и Bitrix24, не сообщает че
|
|
|
342
346
|
| Возможность | Что открывает |
|
|
343
347
|
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
344
348
|
| `identity.read` | Подключённый пользователь Atlassian и сайт, на котором он работает |
|
|
345
|
-
| `issues.read` | Поиск задач со всем словарём фильтров (включая
|
|
349
|
+
| `issues.read` | Поиск задач со всем словарём фильтров (включая фильтр по истории поля — `WAS`/`CHANGED` — и разрешение имени в идентификатор пользователя) и карточка задачи с описанием, связями и кастомными полями |
|
|
346
350
|
| `comments.read` | Комментарии задачи, включая ограниченные (с пометкой видимости) |
|
|
347
351
|
| `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор |
|
|
348
352
|
| `transitions.read` | Доступные переходы статуса и их обязательные поля |
|
|
@@ -414,7 +418,7 @@ teamcity:
|
|
|
414
418
|
defaultArtifactBytes: 262144 # бюджет чтения артефакта по умолчанию
|
|
415
419
|
maxArtifactBytes: 1048576 # жёсткий потолок чтения артефакта
|
|
416
420
|
streamTimeoutMs: 30000 # таймаут для логов и артефактов
|
|
417
|
-
retries: 2 # повторы для 429/5xx и сетевых
|
|
421
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев, включая таймаут: вызов стоит до retries × timeoutMs
|
|
418
422
|
```
|
|
419
423
|
|
|
420
424
|
Токен создаётся в TeamCity (Profile → Access Tokens), при желании с «Limit per project» и read-правами, вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты.
|
|
@@ -469,7 +473,7 @@ confluence:
|
|
|
469
473
|
maxBodyChars: 60000 # потолок бюджета, который может попросить модель
|
|
470
474
|
maxResults: 50 # строк в ответе любого списка (потолок для limit)
|
|
471
475
|
maxReplyParents: 10 # сколько комментариев могут принести ответы
|
|
472
|
-
retries: 2 # повторы для 429/5xx и сетевых
|
|
476
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев, включая таймаут: вызов стоит до retries × timeoutMs
|
|
473
477
|
```
|
|
474
478
|
|
|
475
479
|
API token выпускается в профиле Atlassian (`Manage profile → Security → API tokens`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты. Если стенду нужен OAuth-аккаунт Atlassian общего вида, а не персональный токен, — это отдельная фаза.
|
|
@@ -528,7 +532,7 @@ weblate:
|
|
|
528
532
|
screenshotsRead: true
|
|
529
533
|
maxTextChars: 4000 # символов одной строки, которую видит модель
|
|
530
534
|
maxPageSize: 100 # потолок страницы; по умолчанию провайдер просит 20
|
|
531
|
-
retries: 2 # повторы для 429/5xx и сетевых
|
|
535
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев, кроме таймаута: он завершает вызов
|
|
532
536
|
```
|
|
533
537
|
|
|
534
538
|
Список инстансов принимает не больше 16 записей; id — строчные латинские буквы, цифры и дефисы (до 32 символов), без повторов; подпись по умолчанию — имя хоста. Опечатка в инстансе роняет загрузку конфига, а не выбрасывает инстанс молча: пользователь иначе получил бы провайдер, к которому нельзя подключиться, и никакого объяснения. Пустой список — это состояние, а не падение: провайдер зарегистрирован и бездействует, а отказывает форма подключения.
|
|
@@ -548,6 +552,8 @@ weblate:
|
|
|
548
552
|
- **SSRF-политика по CIDR и DNS** (раздел «API base»): правило провайдера — список инстансов оператора и HTTPS по умолчанию, потому что Weblate обычно self-hosted; «адрес объявлен оператором» заменяет «адрес публичный».
|
|
549
553
|
- **Аудит и OTel-инструменты** (раздел «Observability»): провайдер не публикует ни метрик, ни спанов, а слой интеграций пишет в audit только provider, operation, result и source session id — текст локализации в журнал не попадает.
|
|
550
554
|
|
|
555
|
+
Отложенный объём — построчно, с тем, что код делает сегодня, с уже записанным дефолтом и с тем, что действительно мешает, — сведён в `docs/specs/providers-deferred.md`; там же разобран GitLab и там же лежат вопросы, которые рабочая полоса решать не вправе (OAuth против PAT, девять вопросов §37).
|
|
556
|
+
|
|
551
557
|
## Как подключается GitLab
|
|
552
558
|
|
|
553
559
|
Инстансы GitLab задаёт только оператор: пользователь выбирает из списка и вставляет токен, произвольный хост ввести нельзя. Если инстанс один, выбор не показывается; если инстансов нет, карточка честно сообщает, что подключать нечего.
|
|
@@ -580,7 +586,7 @@ gitlab:
|
|
|
580
586
|
maxFileBytes: 131072 # сколько тела файла отдаём модели
|
|
581
587
|
maxJobLogBytes: 262144 # сколько лога джобы отдаём модели
|
|
582
588
|
maxSearchResults: 50 # потолок per page у поиска
|
|
583
|
-
retries: 2 # повторы для 429/5xx и сетевых
|
|
589
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев, кроме таймаута: он завершает вызов
|
|
584
590
|
```
|
|
585
591
|
|
|
586
592
|
OAuth-приложение для GitLab не нужно: подключение идёт персональным токеном. Токен создаётся в GitLab (`User settings → Access tokens`) с read-scope, вводится один раз в карточке, шифруется тем же конвертным хранилищем, что и вебхук Bitrix24, и после сохранения не показывается и не копируется.
|
|
@@ -595,6 +601,8 @@ OAuth-приложение для GitLab не нужно: подключение
|
|
|
595
601
|
- **Кэш** (§21) отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может; пагинация stateless, подписанных continuation-токенов нет.
|
|
596
602
|
- **Webhooks** (§23) и **официальный GitLab MCP** (§24) — не подключены; REST API v4 остаётся единственным бэкендом.
|
|
597
603
|
|
|
604
|
+
Отдельно от этого списка: у GitLab нет ручек размера страницы и тела, которые обещает §18 спеки (`perPage` ограничен константой `LIST_MAX_PER_PAGE`, diff — `DIFF_BUDGET`), нет обещанных §7 и §28 `tls.caBundle` и `network.*`, а чек-лист §36 помечает как приёмку read-only MVP то, что лежит в отложенном. Построчная сводка — с тем, что код делает сегодня, с записанным дефолтом и с тем, что мешает, — в `docs/specs/providers-deferred.md`.
|
|
605
|
+
|
|
598
606
|
## Как подключается Jira
|
|
599
607
|
|
|
600
608
|
Сайты Jira задаёт только оператор: пользователь выбирает сайт из списка и вводит API-токен с e-mail, произвольный хост ввести нельзя. Если сайт один, выбор не показывается; если сайтов нет, карточка честно сообщает, что подключать нечего.
|
|
@@ -633,7 +641,7 @@ jira:
|
|
|
633
641
|
maxSearchLimit: 100 # потолок страницы; больше Jira не отдаёт
|
|
634
642
|
maxCommentLimit: 100 # потолок страницы комментариев
|
|
635
643
|
maxTextChars: 20000 # бюджет одного описания, комментария или rich-поля
|
|
636
|
-
retries: 2 # повторы для 429/5xx и сетевых
|
|
644
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев, включая таймаут: вызов стоит до retries × timeoutMs
|
|
637
645
|
```
|
|
638
646
|
|
|
639
647
|
OAuth-приложение для Jira не нужно: подключение идёт токеном. Для Cloud токен создаётся в аккаунте Atlassian (`id.atlassian.com → Безопасность → API-токены`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты — вместе с e-mail аккаунта, потому что Jira Cloud аутентифицирует пару `email:token`, а не токен отдельно. Для Server / Data Center токен создаётся в профиле самой Jira (`Профиль → Личные токены доступа`) и хранится один, без почты: он аутентифицируется как `Bearer`. После сохранения секрет не показывается и не копируется.
|
|
@@ -647,11 +655,11 @@ OAuth-приложение для Jira не нужно: подключение
|
|
|
647
655
|
- **OAuth 2.0 3LO с ротацией refresh-токенов** (§Authentication): вместо него API-токен с Basic-аутентификацией. Для OAuth нужны callback-маршрут на хосте, одноразовый state с PKCE, per-credential lock на ротацию refresh-токена и `reauth_required` при `invalid_grant` — это отдельная фаза. Токен, отклонённый Jira (401), сейчас отвечает `CredentialRevoked`, а карточка предлагает заменить токен.
|
|
648
656
|
- **Общий слой Atlassian** (§Shared Atlassian account model): `providers/atlassian/` — общий аккаунт и ресурсы для Jira и Confluence, несколько сайтов на один аккаунт. Пока Jira самостоятельный каталог, как и остальные три провайдера, а сайт выбирается при подключении.
|
|
649
657
|
- **Привязка workspace → проект** (§Workspace binding): allowlist проектов на уровне рабочего пространства — дополнительное сужение, которого сейчас нет; доступ ограничен правами аккаунта и персональной политикой возможностей.
|
|
650
|
-
- **Raw JQL** (§JQL policy, advanced mode): модели доступны только типизированные фильтры. Отдельный JQL-инструмент потребовал бы валидации через parse-API Jira, лимитов на ширину запроса и аудита исходной и нормализованной строки.
|
|
658
|
+
- **Raw JQL** (§JQL policy, advanced mode): модели доступны только типизированные фильтры. Отдельный JQL-инструмент потребовал бы валидации через parse-API Jira, лимитов на ширину запроса и аудита исходной и нормализованной строки. Решение зафиксировано: растёт словарь типизированных фильтров, а не доступа к строке запроса — так появился фильтр по истории, из-за которого raw JQL главным образом и просили. Произвольный запрос остаётся отдельным инструментом со всеми перечисленными границами, и без них он не подключается.
|
|
651
659
|
- **Jira Server / Data Center**: подключён как второй продукт (см. `deploymentType` выше) — чтения идут по `/rest/api/2` с личным токеном доступа. Не подключено то, чего у v2 API нет вовсе: enhanced search с continuation-токеном (у Server / Data Center пагинация по offset, и это то, что отдаёт провайдер) и Cloud-специфичные поля ответа вроде `accountType`.
|
|
652
660
|
- **Запись** (§Write operations): `jira_prepare_*` вместе с pending actions, payload hash, сроком годности и перепроверкой прав на подтверждении. Пока в каталоге нет ни одной операции, которая может изменить Jira, и ни одного инструмента со словом `prepare`.
|
|
653
661
|
- **Скачивание вложений** (§Attachments): сейчас только метаданные. Будущий `jira_get_attachment` обязан заново проверять видимость задачи, иметь лимит байт и allowlist типов.
|
|
654
|
-
-
|
|
662
|
+
- **История кастомных полей и остальные операторы истории**: `history` покрывает `WAS`/`CHANGED` над шестью полями, у которых Jira ищет историю, — «побывали в статусе», «двигали приоритет за две недели», «переназначали на вот кого». За границей остались `WAS IN`/`WAS NOT`, комбинированная форма `WAS … CHANGED BEFORE …` и ключевое слово `DURING` (окно выражается парой `after`/`before`), а история кастомного поля по-прежнему читается только внутри одной задачи (`include: ["changelog_summary"]`): какое значение держало поле инстанса и что это значит, знает только развёртывание, и фильтр по `customfield_…` в истории был бы угадыванием. Чтение кастомных полей идёт селектором `*all`, поэтому на сайте с очень большим числом полей такой ответ может упереться в `ResultTooLarge`.
|
|
655
663
|
- **Кэш** (§Caching) отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может: схема полей перечитывается на каждый такой вызов, а курсор поиска — это continuation-токен Jira, а не наше состояние.
|
|
656
664
|
- **Rate limiting** (§Rate limiting): в личном режиме лимитов на пользователя и на сайт нет; вместо них — ограниченные страницы, таймаут стенда (`timeoutMs`) и повторы с `Retry-After` для 429/5xx. Инвалидация по webhooks (§Future work) — тоже не подключена.
|
|
657
665
|
|
|
@@ -770,7 +778,7 @@ testit:
|
|
|
770
778
|
defaultAttachmentBytes: 262144 # бюджет чтения вложения по умолчанию
|
|
771
779
|
maxAttachmentBytes: 10485760 # жёсткий потолок чтения вложения (10 MiB)
|
|
772
780
|
attachmentTimeoutMs: 30000 # таймаут скачивания вложения
|
|
773
|
-
retries: 2 # повторы для 429/5xx и сетевых
|
|
781
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев, кроме таймаута: он завершает вызов
|
|
774
782
|
```
|
|
775
783
|
|
|
776
784
|
## Чего в Test IT-провайдере ещё нет
|
|
@@ -848,11 +856,11 @@ managedServiceCredentials:
|
|
|
848
856
|
|
|
849
857
|
Новое подключение начинается на сервисном токене, когда профиль для выбранного инстанса есть и `defaultForNewConnections` включён (по умолчанию так): чекбокс «Использовать сервисный токен» в форме уже отмечен, поля токена нет вовсе, а кнопка называется «Подключить сервисный токен». Снятая галочка возвращает обычную форму с personal access token. У уже существующих подключений режим не меняется: он хранится в самом подключении, поэтому обновление стенда не переводит пользователя на общий аккаунт само. В подключённой карточке режим виден строкой «Сервисный аккаунт · управляется администратором», а рядом — «Изменить доступ» и «Использовать личный аккаунт».
|
|
850
858
|
|
|
851
|
-
Сервисный режим — не «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`, считает, что расширил потолок.
|
|
859
|
+
Сервисный режим — не «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`, считает, что расширил потолок. Отказ называет сработавшее правило: чувствительное чтение отвечает строкой с именем возможности (`teamcity.logs.read`) и с тем, что нужен личный аккаунт, — модель передаёт эту строку пользователю дословно, и из неё видно, что ограничение на стороне потолка сервиса, а не интеграции стенда. То же условие стоит в описании каждого инструмента, которому потолок отказывает как чтению, — и только там, где развёртывание вообще выдаёт сервисные креденшалы: на стенде без общего токена предупреждение о чужом потолке удерживало бы модель от чтения, которое её личный аккаунт отвечает. Подпись складывается из классификации операции в каталоге провайдера, поэтому модель знает её до вызова, а не только в отказе, и условие не может застрять у одного провайдера: `tests/tools/service-ceiling.test.ts` сверяет описания со всеми семью каталогами, беря имена инструментов по фактическому префиксу провайдера (у Bitrix24 это `bitrix_`, а не `bitrix24_`) и проверяя, что ни один каталог не сверяется с пустым множеством, а стенд без общего токена не несёт ни одной подписи. Второй замок — отказ самого провайдера — различает запись, личное чтение и чтение, закрытое классификацией, и отвечает тем же кодом, что и брокер на той же классификации (`tests/shared/service-boundary.test.ts`).
|
|
852
860
|
|
|
853
861
|
Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с 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`) и дополнительно сверяет каждый вернувшийся проект с границей: чужой проект, расшаренный в группу, в выдачу не попадает. Пользователь может сузить список в карточке кнопкой «Изменить доступ», но не расширить: выбор вне администраторского списка отбрасывается и не сохраняется.
|
|
854
862
|
|
|
855
|
-
Режим — одно из двух явных значений, `personal` или `service`; `auto` не существует. Отказ в личном режиме (`403` от GitLab или TeamCity) — это отказ: его не повторяют сервисным токеном, и наоборот тоже. Если личный токен был сохранён раньше, он остаётся зашифрованным в хранилище, но не тратится, пока подключение работает на сервисном; «Использовать личный аккаунт» возвращает его, а если личного токена не сохраняли, переключение отвечает `PersonalCredentialRequired` вместо подключения без личности.
|
|
863
|
+
Режим — одно из двух явных значений, `personal` или `service`; `auto` не существует. Отказ в личном режиме (`403` от GitLab или TeamCity) — это отказ: его не повторяют сервисным токеном, и наоборот тоже. Если личный токен был сохранён раньше, он остаётся зашифрованным в хранилище, но не тратится, пока подключение работает на сервисном; «Использовать личный аккаунт» возвращает его, а если личного токена не сохраняли, переключение отвечает `PersonalCredentialRequired` вместо подключения без личности. Переподключение в любую сторону поднимает binding revision — и смена режима, и повторное сохранение того же самого профиля, — поэтому всё, что было выведено из прежней личности, с этого момента недействительно: кэш, курсоры, подготовленные действия и вердикт проверки, который не успел вернуться. Опоздавший вердикт сверяется с поколением связи, из которого начался проб (строка связи, её ревизия, ссылка на секрет и сервисный профиль вместе), и при несовпадении отбрасывается с логом `credential.validation-stale`, а не перезаписывает живое подключение: транзакция вокруг одного `UPDATE` этого не закрывает, потому что разрыв — это `await` перед записью, а не сама запись. Если к моменту записи связи нет вовсе (её отключили и не завели заново), тот же отказ пишется отдельным ключом `credential.validation-unbound`, чтобы человек, разбирающий потерянную гонку, читал из журнала два разных диагноза, а не один на два случая. Ревизии для этой сверки недостаточно: `disconnect` стирает строку, а следующее `connect` заводит новую с ревизией, отсчитывающейся заново от единицы, — и у сервисного подключения без личного токена в новый строке совпадают все остальные поля поколения (секрета нет, тот же профиль, та же ревизия), так что вердикт, начатый до отключения, приземлился бы на здоровое подключение и выставил бы ему `status=error` с чужим `last_error_code`. Поэтому сверяется и id строки: опоздавший ответ не имеет права коснуться связи, которой не застал. Тот же разрыв закрывается на пути переключения режима — личное направление сначала прощупывает сохранённый токен наверху, а потом пишет найденную личность и грант, и переподключение внутри этого ожидания приземлило бы на живую связь личность уже заменённого токена; такая запись тоже сверяется с поколением, при несовпадении отбрасывается с логом `credential.switch-stale` (или `credential.switch-unbound`, если связь к этому моменту удалена), а пользователю отвечает `IntegrationNotConnected` — связью, которая уже ушла, — и не записывает в журнал успешно совершённым переключением, которого не было.
|
|
856
864
|
|
|
857
865
|
Секрет читается лениво, из файла или из переменной окружения, и кэшируется по отпечатку: ротация смонтированного секрета действует со следующего вызова — никому не нужно переподключаться и хост не нужно перезапускать, а содержимое секрета хешируется в ревизию credential. Сам секрет не пишется в лог, не возвращается в браузер и не рендерится: карточка показывает администраторский псевдоним профиля. Пропавший или пустой секрет — `ServiceCredentialUnavailable` (профиль не обслуживает ничего, пока файл не появится), не подходящий провайдеру — `ServiceCredentialInvalid`, выключенный профиль — `ServiceCredentialDisabled`. Проверка подключения читает вердикт пробы: истёкший или отозванный токен переводит подключение в «нужна проверка» и отвечает отказом, а слишком широкий токен (`ServiceCredentialUnsafeScope`) подключение не ломает — потолок режима уже ограничивает доступ, — но карточка о нём говорит, потому что сузить токен может только оператор. Остальные отказы карточка переводит на человеческий: `ServiceResourceNotAllowed` — «сузьте доступ в списке или подключите личный аккаунт», `SensitiveReadRequiresPersonalCredential` — «нужен личный аккаунт», `OperationNotAllowedWithServiceCredential` — «сервисный режим только для безопасного чтения».
|
|
858
866
|
|
|
@@ -868,13 +876,14 @@ Rate limiting сервисного режима считается по обеи
|
|
|
868
876
|
2. `secureSession` проверяет владельца DSH-сессии;
|
|
869
877
|
3. интеграционный principal закрепляется только если текущий пользователь и владелец совпадают;
|
|
870
878
|
4. администраторский просмотр чужого чата, неаттестованная сессия и subagent не получают principal;
|
|
871
|
-
5. broker находит подключение по паре `ownerUserId + provider` и только внутри себя расшифровывает credential
|
|
879
|
+
5. broker находит подключение по паре `ownerUserId + provider` и только внутри себя расшифровывает credential — по ссылке того поколения связи, с которого операция началась, так что переподключение, случившееся во время чтения, не тратит чужой текущий токен; ссылка, которую живая строка уже не несёт, отвечает `IntegrationNotConnected`, а не `PersonalCredentialRequired`, и не становится отказом политики;
|
|
872
880
|
6. адрес внешнего сервиса приходит только из конфига оператора: у GitLab, Jira, Confluence, Test IT и Weblate это выбранная инсталляция из списка оператора, у Bitrix24 — проверенный по доменному allowlist URL вебхука, у TeamCity — адрес, проверенный по политике стенда (и при сохранении, и на каждом вызове);
|
|
873
881
|
7. у Jira модели не достаётся и язык запросов: JQL собирается из типизированных аргументов внутри провайдера, а значения экранируются как строковые литералы; у Weblate так же собирается `q`, и `next`-ссылка разбирается на номер страницы, а не берётся как адрес следующего запроса;
|
|
874
882
|
8. справочник пользователей Jira читается только для того, чтобы превратить имя из фильтра в accountId: ответ справочника не попадает ни в результат тула, ни в лог, а неоднозначное имя — отказ, а не выбор человека за пользователя;
|
|
875
883
|
9. в сервисном режиме личность на стороне провайдера принадлежит развёртыванию, а не пользователю: подключение тратит один общий read-only аккаунт, и ни один запрос не уходит от имени вошедшего;
|
|
876
884
|
10. локальный audit — единственная запись о том, кто спросил на самом деле: upstream видит только сервисный аккаунт, поэтому строка журнала хранит владельца подключения, provider, operation, `credential_source` и id сервисного профиля;
|
|
877
|
-
11. неявного отката нет ни в одну сторону: сервисный режим не подменяет личный после отказа и наоборот, а
|
|
885
|
+
11. неявного отката нет ни в одну сторону: сервисный режим не подменяет личный после отказа и наоборот, а любое переподключение — смена режима или повторное сохранение того же профиля — поднимает binding revision и обесценивает всё, что было выведено из прежней личности; опоздающая запись (вердикт проверки и переключение режима, чья проба успела сходить наверх) сверяется с этим поколением вместе с id строки — отключение стирает связь, а следующая за ним ревизия начинается заново с единицы, так что без id свежее подключение не отличить от того, которое отключили, — и при несовпадении отбрасывается (`credential.validation-stale` и `credential.switch-stale`, когда связь уже несёт другое поколение; `credential.validation-unbound` и `credential.switch-unbound`, когда её к этому моменту нет вовсе), а не перезаписывает живое подключение и не остаётся в журнале успешно совершённым;
|
|
886
|
+
12. reach подключения — это пересечение сохранённого гранта с тем, что провайдер предлагает этому развёртыванию сейчас: возможность, снятую конфигурацией провайдера или его каталогом операций, брокер отказывает до расшифровки секрета и до первого байта наверху; карточка в тот же момент перестаёт показывать её как доступную — строка возможности остаётся в списке «Доступ агента», потому что список строится по каталогу провайдера, а не по живому набору грантов, но чекбокс у неё выключен и в списке политик возможности нет, — а новая запись `allow` на неё не заводится: иначе строка, простоявшая в окне снятия, ожила бы сама, когда возможность вернут, вопреки правилу «новое начинается с deny».
|
|
878
887
|
|
|
879
888
|
В логах и audit сохраняются provider, operation, result и source session id; в audit к этому добавлены владелец подключения, `credential_source` и id сервисного профиля — у личного подключения это `personal` и `null`. Тела CRM/чатов, HTTP-заголовки и секреты не журналируются. Постоянный cache данных провайдера отсутствует, поэтому и смена режима не может отдать данные, прочитанные под прежней личностью.
|
|
880
889
|
|
|
@@ -1040,6 +1049,8 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
|
|
|
1040
1049
|
|
|
1041
1050
|
`dataPath` по умолчанию — `$DSH_HOME/qa-integrations.db` (база SQLite). Прежний файл `qa-integrations.json`, оставшийся от релиза до 0.5.0, переносится при первом запуске и переименовывается в `qa-integrations.json.migrated-<ISO>`. На Unix новый файл создаётся с mode `0600`. Журнал обращений к сервисам хранится `auditRetentionDays` дней (по умолчанию 90; `0` — не ограничивать по возрасту) и в любом случае не длиннее 5000 записей. Разрешён только HTTPS URL вида `https://company.bitrix24.ru/rest/<user>/<secret>` без query, fragment, custom port или credentials в authority. Список доменных суффиксов задаётся оператором, а не пользователем. `credentialHelp.<provider>` заменяет подсказки к полю секрета — адреса выдачи, ссылки на документацию, инструкции и список прав; на хранение, шифрование и проверку credential он не влияет.
|
|
1042
1051
|
|
|
1052
|
+
Что `retries` делает с истёкшим бюджетом, решает провайдер, и вариантов два: Jira, TeamCity и Confluence повторяют и таймаут, поэтому один вызов стоит до `retries × timeoutMs`; GitLab, Test IT и Weblate держат один `timeoutMs` как весь вызов — таймаут его завершает, а `retries` остаётся для 429/5xx и сбоев соединения. Оба правила объявлены в `providers/kernel/read-policy.ts` под именами `RESEND_AFTER_EVERY_FAULT` и `DEADLINE_IS_THE_BUDGET` (второе — дефолт), и ни одно из них не покупает второй попытки телу, которое перестали читать: такой запрос ответил.
|
|
1053
|
+
|
|
1043
1054
|
`managedServiceCredentials` — срез, которого нет, пока `enabled: false` (значение по умолчанию): `defaultForNewConnections` решает, начинается ли новое подключение на сервисном токене, `rateLimit` задаёт потолок частоты сервисного режима (`perPrincipal.requestsPerMinute`, `perCredential.requestsPerMinute` и `perCredential.maxConcurrent`; значения по умолчанию — 120, 1000 и 16, `0` отключает измерение, дробное или отрицательное число отвергается при загрузке), а каждый профиль связывает провайдера и его инстанс с секретом общего аккаунта (`secretFile` или `secretEnv`, ровно один из двух) и обязательной границей `resources`, внутри которой `policy` может только выключать операции. Провайдер и инстанс в профиле должны существовать в этом же конфиге, иначе загрузка падает, а сообщение называет профиль или инстанс. Правила и границы режима — в разделе «Сервисные токены (managed service credentials)».
|
|
1044
1055
|
|
|
1045
1056
|
## Пользовательский сценарий
|
|
@@ -1071,4 +1082,4 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
|
|
|
1071
1082
|
pnpm --filter @yadsh/dsh-qa-integrations check
|
|
1072
1083
|
```
|
|
1073
1084
|
|
|
1074
|
-
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 из секции, которую сам зарегистрировал.
|
|
1085
|
+
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 вебхука и токена и отказ возможности, снятой развёртыванием (сохранённый грант сверяется с живым набором провайдера: отказ наступает до расшифровки секрета и до запроса наверх, возможность перестаёт быть доступной в карточке — её строка остаётся в каталоге, но выключенной, — исчезает из списка политик, а `allow` на неё не записывается, в том числе когда провайдера в конфиге уже нет и отказ приходит из реестра), отброс вердикта проверки, который вернулся после переподключения (в обоих порядках завершения, после повторного сохранения того же самого профиля и после отключения с последующим заведением той же сервисной связи — там, где совпадают все поля поколения, кроме id строки, — и после отключения без нового подключения, где отказ уходит в журнал под ключом `credential.validation-unbound`, а не `credential.validation-stale`), отброс переключения режима, чья проба credential успела сходить наверх пока связь под ней заменилась (живое подключение сохраняет запись собственного переподключения, а не личность и грант уже заменённого токена, и отказ не записан в журнал совершённым), потолок и границу сервисного токена (включая конфигурацию профилей, отсутствие неявного отката между режимами, ротацию секрета под работающим подключением и аудит реального пользователя), отображение ошибок провайдеров в доменные коды, обрезку больших ответов и параллельную изоляцию 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 из секции, которую сам зарегистрировал.
|
package/compatibility.json
CHANGED
|
@@ -1,10 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"deepseekHarness": {
|
|
3
3
|
"channel": "next",
|
|
4
|
-
"range": ">=0.1.
|
|
5
|
-
"testedReleases": ["0.1.
|
|
4
|
+
"range": ">=0.1.7-rc.2 <0.2.0",
|
|
5
|
+
"testedReleases": ["0.1.7-rc.2"],
|
|
6
6
|
"requiredHostFeatures": ["tools", "qaSurface"],
|
|
7
|
-
"requiredClientFeatures": [
|
|
7
|
+
"requiredClientFeatures": [
|
|
8
|
+
"qaUserSettingsSections",
|
|
9
|
+
"plugins.row.config",
|
|
10
|
+
"plugins.bundle.config"
|
|
11
|
+
]
|
|
8
12
|
},
|
|
9
13
|
"node": ">=22"
|
|
10
14
|
}
|