d327a0488d
Дельты commands, hub-api, mcp, data-model, agent: issue_type bug с настройкой
issue_types.bug, хранилище файлов хаба (POST /files, GET /agent/files/{sha256}),
команда ensure_attachment, path в MCP batch_create, агент v11; заодно R-1
(#46) и M-1/M-2 из aep/jira-agent#30.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
62 lines
6.0 KiB
Markdown
62 lines
6.0 KiB
Markdown
## Why
|
||
|
||
15.10.2026 при заведении AURORA-1639 (замечания тестирования и файл ОСВ, не прошедший распознавание) мост не справился
|
||
с двумя вещами, и владелец доделывал руками в Jira: задачу нельзя завести типом «Ошибка» (`ensure_issue` принимает только
|
||
`task`/`epic`), и к задаче нельзя приложить файл — такой команды нет. Баги из тестирования в AURORA заводятся типом
|
||
«Ошибка», и к ним почти всегда прикладываются файлы (ОСВ, скриншоты). Issues: aep/jira-hub#43, aep/jira-agent#31.
|
||
|
||
Решения владельца 15.10.2026 (brainstorming): файл приходит только из MCP (локальный путь в чате), веб-морда загрузку
|
||
пока не умеет; обязательные поля у «Ошибки» те же, что у «Задачи»; файл хранится в хабе, агент забирает его отдельным
|
||
запросом (вариант A), а не через общую папку напрямую и не base64 в параметрах команды.
|
||
|
||
## What Changes
|
||
|
||
- **Тип `bug`** в `ensure_issue`: настройка `issue_types.bug = {name, id}` (`id` необязателен — агент шлёт `{name}`),
|
||
ключи конфига `issue_type_bug`/`issue_type_bug_id` в `init`; без настройки хаб отвергает пакет 422, агент — ошибкой
|
||
конфигурации вместо `{"name": null}`.
|
||
- **Хранилище файлов** в хабе: `POST /files {content: base64}` → `{file: sha256, size}`, каталог `files/` (0700), предел
|
||
10 МБ (413), атомарная запись, одна копия на содержимое, уборка файлов старше 30 дней без ссылок активных команд.
|
||
`GET /agent/files/{sha256}` — файл агенту (base64 в JSON: проходит и через реле папки, и по HTTP).
|
||
- **Команда `ensure_attachment {key, file, filename}`**: `key` — ключ или `new:<n>`; хаб проверяет, что файл загружен,
|
||
при выдаче дописывает `size`; агент ищет вложение с тем же именем и размером, иначе скачивает файл у хаба, сверяет sha256
|
||
и загружает `multipart/form-data`. Пауза 30 с; по состоянию зеркала не подтверждается.
|
||
- **MCP `batch_create`**: у `ensure_attachment` вместо `file` можно `path` — MCP сам загружает файл и подставляет `file`
|
||
и `filename`. Одним пакетом: создать «Ошибку» → поставить в спринт → приложить файл.
|
||
- **Описание параметров и ошибки 422** (R-1 из aep/jira-hub#46): закрепить в спеке поведение, сделанное в #44 —
|
||
описание `batch_create` из описания параметров в коде, «ожидаются …» в ошибках валидации.
|
||
- **Агент v11** (`AGENT_VERSION = 11`, самообновлением): тип из настроек с ошибкой конфигурации, `do_ensure_attachment`,
|
||
multipart на stdlib; заодно из aep/jira-agent#30 — комментарий без `id` отбрасывается с логом (M-1), 403/404 при
|
||
дочитывании комментариев не роняет `refresh` (M-2).
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
<!-- нет -->
|
||
|
||
### Modified Capabilities
|
||
- `commands`: тип `bug`; команда `ensure_attachment` (таблица, темп, подтверждение); проверки постановки; описание
|
||
параметров и текст ошибок валидации.
|
||
- `hub-api`: `POST /files`, `GET /agent/files/{sha256}`, хранилище файлов и его уборка, 422 у `POST /batches`.
|
||
- `mcp`: описание `batch_create` из кода; `path` у `ensure_attachment`.
|
||
- `data-model`: `issue_types.bug` и ключи конфига.
|
||
- `agent`: тип из настроек, выполнение `ensure_attachment`, устойчивость дочитывания комментариев, v11.
|
||
|
||
## Non-Goals
|
||
|
||
- загрузка файла из веб-морды и список вложений в зеркале/карточке — отдельно, когда понадобится;
|
||
- удаление и замена вложений в Jira (команда только добавляет недостающее);
|
||
- поля по умолчанию для типа «Ошибка» (обязательные поля как у задачи);
|
||
- привязка выдачи команд к версии агента: старый агент отвечает `failed` «неизвестный тип команды», хватает
|
||
`min_agent_version = 11` (предупреждение);
|
||
- вложения больше 10 МБ.
|
||
|
||
## Impact
|
||
|
||
- jira-hub: `commands.py` (SPEC, проверки), `queue.py` (дописывание `size` при выдаче), `api.py` (два маршрута, уборка
|
||
в `tick`), новый модуль хранилища файлов, `settings.py` (`init`), `mcp_server.py` (`path`), тесты, спеки, README,
|
||
ARCHITECTURE.md. Схема БД не меняется.
|
||
- jira-agent (aep/jira-agent#31): `src/agent.py` v11, тесты и фейки (вложения в `fake_jira`, файлы в `fake_hub`),
|
||
README, ARCHITECTURE.md. `run.py` не меняется.
|
||
- Выкатка: merge хаба → перезапуск хаба и MCP → `settings_set issue_types` с `bug` → `jira-hub agent publish` v11 →
|
||
`min_agent_version = 11` → живая проверка на тестовой задаче (удаляет владелец).
|