bitrix24-mcp-bridge 1.0.0 → 1.1.0

package/docs/api-notes.md

@@ -59,7 +59,7 @@ Ajax-контроллеры (`/bitrix/services/main/ajax.php`) отвечают
 | Инструмент | Что делает | Ключевые аргументы | params / пагинация |
 |---|---|---|---|
 | `bitrix_help` | эта справка | — | — |
-| `bitrix_status` | какие порталы сконфигурированы и подключены, версии моста и расширения | — | — |
+| `bitrix_status` | какие порталы сконфигурированы и подключены, версии моста и расширения; `warning` — устаревшее расширение или разросшаяся папка загрузок (§5.5) | — | — |
 | *Задачи* | | | |
 | `bitrix_tasks_list` | список задач | + `params` | верхний уровень: `filter{RESPONSIBLE_ID,REAL_STATUS,GROUP_ID,…}`, `select[]`, `order{}`; **`PAGEN_1`** — номер страницы (1, 2, 3…), страница = 20 задач; `start` **не работает** (вернёт ту же первую страницу) |
 | `bitrix_task_get` | карточка задачи (в т.ч. `CHAT_ID`) | `taskId` + `params` | верхний уровень: `select[]` |
@@ -93,12 +93,12 @@ Ajax-контроллеры (`/bitrix/services/main/ajax.php`) отвечают
 | *Связи задач* | | | |
 | `bitrix_task_related_edit` ⚠ | добавить / убрать **связанные** задачи (блок «Связанные задачи») | `taskId`, `add[]?`, `remove[]?` — id задач | без `params`; ответ `{ taskId, related, changed }`; задачи со 100 и более связанными не правятся |
 | `bitrix_task_parent` ⚠ | сделать **подзадачей** задачи `parentId`; `null` — отвязать от родителя | `taskId`, `parentId` | без `params`; ответ `{ taskId, parentId, previousParentId, changed }` |
-| `bitrix_task_gantt_link` ⚠ | связь Ганта «окончание → начало»: `dependentId` начинается после завершения `taskId` | `taskId`, `dependentId`, `remove?`, `type?` (только `"finish_start"`, только при добавлении) | без `params`; отдельную связь прочитать нельзя — проверка по признаку «у `dependentId` есть связи Ганта»: `confirmed: true` — подтверждено, `confirmed: false` + `note` — подтвердить нельзя (у задачи были / остались другие связи); нет связей после добавления — ошибка; ответ `{ taskId, dependentId, linked, confirmed, note? }` |
+| `bitrix_task_gantt_link` ⚠ | связь Ганта «окончание → начало»: `dependentId` начинается после завершения `taskId` | `taskId`, `dependentId`, `remove?` | без `params`; отдельную связь прочитать нельзя — проверка по признаку «у `dependentId` есть связи Ганта»: `confirmed: true` — подтверждено, `confirmed: false` + `note` — подтвердить нельзя (у задачи были / остались другие связи); нет связей после добавления — ошибка; повтор существующей связи Bitrix отвергает как «циклическую зависимость» — если у `dependentId` уже были связи, ошибка скажет, что эта связь, скорее всего, уже есть (ничего не записано, не повторяй); ответ `{ taskId, dependentId, linked, confirmed, note? }` |
 | *Scrum* | | | |
 | `bitrix_sprint_columns` | колонки доски **активного** спринта `[{ id, name, type }]` | `groupId` (= `GROUP_ID` задачи) | без `params`; `type` — `NEW`/`WORK`/`FINISH`, у своих колонок пустой; в колонку `FINISH` операции задачи не ставят |
 | `bitrix_task_move` ⚠ | перенести задачи в колонку спринта | `taskIds[]` (1–50), `column` (id или название, без учёта регистра) | без `params`; колонку типа `FINISH` указать нельзя — закрывай через `bitrix_task_close`; пакетный ответ (ниже), поля `stageId`, `column`, `status` — перенос может переоткрыть закрытую задачу |
 | `bitrix_task_to_sprint` ⚠ | поставить задачи на доску **активного** спринта: из бэклога — в спринт и в колонку, уже стоящие в нём — в колонку | `taskIds[]` (1–50), `column?` (без него — колонка типа `NEW`) | без `params`; колонку типа `FINISH` указать нельзя — закрывай через `bitrix_task_close`; пакетный ответ, поля `sprintId`, `stageId`, `column`, `status`, `fromBacklog`; задачи других спринтов — ошибка |
-| `bitrix_task_to_backlog` ⚠ | вернуть задачи в **бэклог** проекта | `taskIds[]` (1–50) | без `params`; пакетный ответ, поля `backlogId`, `changed` |
+| `bitrix_task_to_backlog` ⚠ | вернуть задачи в **бэклог** проекта и убрать из колонки спринта (стартовая стадия канбана проекта, как в UI); задачу, которая уже в бэклоге, но числится в колонке спринта, только переставляет | `taskIds[]` (1–50) | без `params`; пакетный ответ, поля `backlogId`, `stageId`, `changed` |
 | `bitrix_task_create` ⚠ | **создать** задачу сразу на доске активного спринта, как «+» на доске | `groupId`, `title` (≤ 255, простой текст), `column?` (без него — колонка типа `NEW`) | без `params`; колонку типа `FINISH` указать нельзя; ответ `{ taskId, sprintId, stageId, column }`; остальные поля — потом отдельными операциями |
 | *Проекты* | | | |
 | `bitrix_projects_list` | рабочие группы / проекты | + `params` | верхний уровень: `select[]`, `order{}`, `filter{}`; `start` (шаг 50; `start=(N-1)*50`, `-1` — ответ без `total`) 📖 |
@@ -176,7 +176,8 @@ Ajax-контроллеры (`/bitrix/services/main/ajax.php`) отвечают
   проверки создаст дубль (а `bitrix_task_description_append` допишет текст второй раз).
 - «Bitrix ответил успехом, но …», «Bitrix не применил: …» — перечитанное состояние не то, что просили; в
   ошибке — как сейчас. Не повторяй тот же вызов вслепую — скажи пользователю.
-- Многошаговые правки называют, что уже сделано: `bitrix_task_checklist_edit` — «до этого сделано: …»,
+- Многошаговые правки называют, что уже сделано: `bitrix_task_checklist_edit` — «до этого сделано: …»
+  (на исходе времени вызова — ещё и «истекло время вызова, не выполнено: …»: перечитай чек-лист и повтори только это),
   `bitrix_task_parent` — прежнего родителя и вызов, которым его вернуть, `bitrix_task_to_sprint` — «верни
   её в бэклог (`bitrix_task_to_backlog`) и повтори».
 
@@ -502,6 +503,12 @@ bitrix_file_download { "url": "…", "savePath": "/tmp/photo.png", "overwrite":
 контекст). По умолчанию файл ложится в `~/.bitrix24-mcp-bridge/downloads/`; `savePath` без ведущего `/`
 трактуется как имя внутри этой папки. Потолок — 512 МБ.
 
+Мост ничего из `downloads/` не удаляет. Когда файлы папки в сумме больше 500 МБ, ответы операций,
+записавших файл в эту папку (`bitrix_file_download`, `bitrix_call_recording`, `bitrix_call_detail` и
+`bitrix_task_comments` — последние две, когда сохранили файл; с `savePath` вне папки — нет), и
+`bitrix_status` несут `warning` «папка загрузок моста … занимает N МБ —
+предложи пользователю удалить ненужные файлы…» — передай это пользователю.
+
 Тонкости:
 - **Только ссылки на файлы** сконфигурированного портала: `/bitrix/services/main/ajax.php` с `action`
   `disk.api.file.download` / `disk.attachedObject.download` / `call.Track.download` или

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "bitrix24-mcp-bridge",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP bridge server for Bitrix24 — exposes tasks, projects, chats and calls from your live browser session to MCP clients like Claude Code.",
   "license": "MIT",
   "repository": {