# История изменений CLI HubSpot (/ru/docs/hubspot/changelog)

Заметные изменения в `@wirecat/hubspot-cli`. По одному разделу на версию, новые сверху.

## 0.4.0 — 19.11.2026 [#040--19112026]

### Изменено — может сломать вызовы [#изменено--может-сломать-вызовы]

- **Ключей `deals.write`, `people.write` и `organizations.write` больше нет.** Они останавливали только путь через
  `api`, поэтому `deals.write: deny` все равно пропускал `deals update`. Запись через `api` в сделки, контакты или
  компании теперь проверяет ключ команды, которая делает то же самое (`deals.update`, `people.create`), как в amoCRM
  и b24, а слияние проверяет `<group>.update`. Так прямая запись в сделку, контакт или компанию идет так же, как ее
  команда, а удаления по-прежнему спрашивают. Обратите внимание: настройка с одним из трех старых ключей больше ни с
  чем не совпадает. Задайте вместо нее `deals.update`, `deals.create` или ключ группы `deals`.

### Исправлено [#исправлено]

- **Чтение, запрещенное для команды CRM, запрещено и через `api`.** `config set permissions.people deny` останавливал
  `people list`, но не `api contacts-list`, который читал те же контакты. Теперь каждое прямое чтение проверяет ключ
  команды, которая читает те же записи: `people`, `organizations`, `deals`, `leads`, `activities`, `users`,
  `pipelines`, `stages` и `fields`. См. [разрешения](/llms.mdx/docs/ru/hubspot/permissions/content.md).

## 0.3.2 — 19.11.2026 [#032--19112026]

## 0.3.1 — 19.11.2026 [#031--19112026]

### Исправлено [#исправлено-1]

- **Заметки, встречи и задачи читаются как чистый текст.** HTML-коды вроде `&#8217;` и `&mdash;` превращаются в
  символы, которые они обозначают, а блоки стилей отбрасываются, так что поиск находит слова. Раньше расшифровывались
  только шесть кодов.
- **Дневной лимит HubSpot на всех путях говорит «не повторять».** Команды CRM считали его ошибкой, которую можно
  повторить, а `api` нет, и агент мог повторять запрос часами.
- **`session start --help` больше не говорит, что hubspot ничего не меняет.** Запись появилась в 0.2.0.

## 0.3.0 — 18.11.2026 [#030--18112026]

### Изменено — может сломать вызовы [#изменено--может-сломать-вызовы-1]

- **Запись в MCP Registry спрашивает, какие профили обслуживать.** Раньше она запускала `mcp serve --profiles all`,
  и клиент, установивший сервер из реестра, получал доступ ко всем аккаунтам на компьютере, хотя владелец их не
  выбирал. Теперь `--profiles` обязателен, с примером `personal`: клиент спрашивает один профиль, список через запятую
  или `all`. Почему: CLI никогда не выбирает аккаунт за владельца
  ([WC-MCP-9](https://github.com/WireCatLabs/cli-base/blob/main/docs/standards/mcp.md#wc-mcp-9--a-server-serves-the-profiles-it-is-told-with-one-connection-for-each)). Что учесть: клиент, настроенный по старой записи, сохраняет `--profiles all`, пока его не настроят заново. Сервер,
  добавленный вручную или через `mcp config`, не меняется.

### Исправлено [#исправлено-2]

- **`mcp serve` запускается на компьютере, где еще нет профиля.** Он показывает свои инструменты, а каждый вызов
  отвечает командой, которая настраивает профиль. Раньше сервер останавливался при запуске, и каталог, который
  проверяет серверы, не мог их перечислить. Из cli-core 0.699.0.

## 0.2.0 — 17.11.2026 [#020--17112026]

### Добавлено [#добавлено]

- **`deals create`, `update`, `move`, `close` и `delete` меняют сделки в HubSpot, а копия принимает каждый ответ.**
  `close` переносит сделку на стадию выигрыша или проигрыша ее воронки и сохраняет `--reason` как причину закрытия в
  HubSpot. `delete` архивирует сделку и сначала спрашивает. См. [как пользоваться](/llms.mdx/docs/ru/hubspot/usage/content.md).
- **`people create|update` и `organizations create|update` меняют контакты и компании.** У контакта одна почта и два
  номера, у компании один номер и нет почты. Более длинный список отклоняется до того, как что-то отправлено.
- **`api` предлагает и записи и удаления HubSpot: 66 записей и 33 удаления CRM API версии 2026-03.** Каждая запись
  проверяет `api.<command>` и `<group>.write` своей группы, каждое удаление `<group>.delete`, и оба по умолчанию
  спрашивают. Запись, которая делает то же, что команда, проверяет и ключ этой команды (`deals.update`), тело, которое
  задает стадию сделки, проверяет `deals.move` и `deals.close`, а тело, которое задает ответственного,
  `crm.assign-others`, который по умолчанию стоит на `deny`. `api contacts-gdpr-delete` проверяет еще `people.erase`,
  чтобы можно было запретить только стирание. `--dry-run` называет каждый ключ.
  См. [настройки](/llms.mdx/docs/ru/hubspot/configuration/content.md#permissions).
- **Scope на запись необязательны.** Настройка и [установка](/llms.mdx/docs/ru/hubspot/installation/content.md#make-a-key) перечисляют
  `crm.objects.{deals,contacts,companies}.write`. Без них ключ только читает.

### Исправлено [#исправлено-3]

- **`api` отправляет ключ с каждой операцией.** Спецификации объектов HubSpot помечают 115 операций как не требующие
  входа, поэтому в 0.1.0 `api deals-get`, `api contacts-list` и другие операции с записями уходили без ключа, и HubSpot
  отвечал 401. Операции с воронками, свойствами, ответственными и аккаунтом это не затронуло.

## 0.1.0 — 17.11.2026 [#010--17112026]

### Добавлено [#добавлено-1]

- Начало от `@wirecat/cli-template` 0.25.0.
- **`session start` входит в профиль с сервисным ключом HubSpot или токеном приватного приложения.** Ключ читается
  скрытно или из stdin, но никогда не как аргумент, проверяется в аккаунте и хранится в связке ключей вместе с id
  аккаунта. Второй профиль на тот же аккаунт отклоняется. `WCHUBSPOT_TOKEN` работает в CI вместе с
  `WCHUBSPOT_ACCOUNT`, id аккаунта. См. [установку](/llms.mdx/docs/ru/hubspot/installation/content.md).
- **`sync` копирует CRM аккаунта в общее хранилище WireCat.** Сделки, контакты, компании, лиды (Sales Hub
  Professional или Enterprise), ответственные, воронки и свойства, а когда включена настройка активностей, еще
  заметки, звонки, письма, встречи и задачи. После этого `deals list`, `pipelines`, `changes list` и `search all`
  отвечают без интернета. Ключ не называет пользователя, поэтому каждый профиль читает всю копию: фильтруйте по
  `owner:<owner id>`, а не по `owner:me`.
- **`people`, `organizations` и `users` читают контакты, компании и ответственных из аккаунта напрямую.**
- **`api` предлагает каждую операцию чтения CRM API HubSpot версии 2026-03 из его 15 спецификаций.** Одна команда на
  операцию, у каждой свой ключ разрешения. Этот выпуск только читает: записи API не предлагаются, и `api show` для
  такой операции об этом говорит.
- **Исчерпанный дневной лимит сразу завершает запрос и говорит, когда лимит вернется.** HubSpot делит один дневной
  лимит между всеми приложениями аккаунта. `hubspot` сообщает `hubspot.daily-limit` с временем ожидания до полуночи
  аккаунта и до тех пор не дает ни одному процессу на этом аккаунте спрашивать снова. Десятисекундный лимит
  выжидается.
- **`WCHUBSPOT_ACCOUNT` сверяется с `WCHUBSPOT_TOKEN` до того, как что-то записано.** `sync` с id другого аккаунта
  останавливается с `account.mismatch` и называет оба id, поэтому CRM одного аккаунта никогда не попадет под другой.
  `session status --check` с одним токеном печатает id, который нужно задать. См.
  [решение проблем](/llms.mdx/docs/ru/hubspot/troubleshooting/content.md).
