Перейти к содержанию

Релиз 0.13.8

Дата выхода: 11 ноября 2026.

Релиз 0.13.8 завершает волну 0.13.x и приносит две вещи, которых не было в 0.13.4: инстанс теперь можно поставить «на автозапуск» одной командой, а обновление версии выполняется из самой платформы — с выбором канала.

Заметки кумулятивные: версии 0.13.5–0.13.7 в npm не публиковались (выходили только беты во внутреннем реестре), поэтому документ описывает всю волну целиком.

Что входит в релиз

Заметки кумулятивные: 0.13.5–0.13.7 отдельными пакетами не выходили, и публикуется только 0.13.8. Полный список коммитов и исправлений — в релизах репозитория (зеркало GitVerse: gitverse.ru/itphx/synth/releases).

Сервис инстанса: работает всегда

Раньше «инстанс всегда поднят» означало systemd-юнит, написанный руками. Теперь это штатная процедура: synth service install создаёт userspace-сервис (systemd --user), включает автозапуск и поднимает инстанс.

synth service install          # поставить сервис и запустить
synth service status           # состояние: unit, автозапуск, PID, health
synth service logs -f          # журнал сервиса
synth service restart          # перезапуск
synth service uninstall        # снять unit (данные остаются)
  • Автозапуск и «живучесть». Unit ставится в ~/.config/systemd/user/ (или $XDG_CONFIG_HOME/systemd/user/), включается в автозапуск, а loginctl enable-linger позволяет сервису жить без активной сессии пользователя — после перезагрузки машины инстанс поднимается сам.
  • Перезапуск без супервизора. Unit настроен на graceful restart: процесс завершается с кодом 75, systemd поднимает его заново. Ручной «наблюдатель» процесса больше не нужен.
  • Без секретов в unit. Ключи и токены в unit и env-файл не попадают: env-файл создаётся с правами 0600 и содержит только параметры запуска. Ключ доступа создаёт сам сервер в каталоге данных, команда печатает путь к нему, а не значение.
  • Аккуратно с чужим unit. Если unit создан не этой командой, он не перезаписывается — нужен явный --force. Посмотреть, что будет записано, можно без установки: synth service install --print-unit или --dry-run. Unit, созданный установщиком офлайн-поставки, тоже считается «чужим».
  • Только Linux + systemd. На других платформах команда сообщает о неподдерживаемости, а не изображает сервис.

Пример: поставьте сервис на рабочей машине — после перезагрузки инстанс поднимется сам, а перезапуск из интерфейса («Настройки → Обслуживание») будет подхвачен systemd.

Обновления и каналы

Теперь платформа умеет обновлять себя: synth update показывает текущую и целевую версию, --check — только проверяет, --apply — устанавливает.

synth update --check                  # что доступно (ничего не ставится)
synth update --channel stable         # проверка по стабильному каналу
synth update --apply                  # установить найденную версию
synth update --to 0.13.8 --apply      # конкретная версия
synth update --channel beta --check   # что доступно в бета-канале
  • Каналы. stable — обычные релизы, beta — предрелизные сборки из внутреннего реестра, auto (по умолчанию) — канал выводится из установленной версии: беты остаются на бета-канале, стабильные сборки — на стабильном.
  • Возврат на стабильный канал. Переход beta → stable — это понижение версии, поэтому он требует подтверждения. Данные при этом не откатываются: откат пакета и откат данных — разные операции.
  • Автопроверка выключена по умолчанию. Инстанс не ходит в реестры без явного согласия владельца — это важно для закрытого контура. Включить её можно в интерфейсе (Настройки → Панель управления → Обновления) или в конфигурации; результат проверки кэшируется на сутки, ошибка — на час. Явная проверка (--check) кэш игнорирует всегда.
  • Своё хранилище пакетов. --registry <url> переопределяет реестр канала — так обновляются инстансы за прокси или в закрытом контуре. Токен для чтения внутреннего реестра не нужен.
  • После обновления — перезапуск. Если инстанс работает как сервис, обновлённый пакет подхватится после synth service restart.

Пример: переведите стенд на беты — synth update --channel beta --check, затем synth update --channel beta --apply; вернуться на стабильную линию можно командой synth update --channel stable --apply с подтверждением.

Инстанс из чата: команда /instance

Агент теперь может сам разобраться в инстансе, в котором работает: что это за установка, где её данные, какие MCP-серверы подключены, какие проекты и сессии доступны.

  • Команда /instance. Встроенный сценарий самопомощи: агент отвечает на вопросы об инстансе, MCP-реестре, проектах и сессиях прямо в чате.
  • Инструменты synth_*. Чтение — synth_info, synth_mcp_list, synth_mcp_test; изменение реестра — synth_mcp_add, synth_mcp_update, synth_mcp_remove, synth_mcp_enable, synth_mcp_reconnect. В режиме плана изменяющие инструменты заблокированы.
  • Проекты и сессии. Агент видит список проектов и сессий (в том числе удалённых в гибридном режиме — с пометкой источника), может открыть проект и присоединиться к нему.
  • Без секретов. Ответы содержат адреса и статусы, но не ключи, заголовки авторизации и содержимое переменных окружения: ссылка на сервер с учётными данными в ответе редактируется.

Пример: спросите агента «покажи, какие MCP-серверы подключены и почему второй не активен» — ответ придёт в чате, без обращения к API вручную.

Реестр MCP — источник истины

Реестр MCP-серверов переехал в ядро, поэтому он одинаково работает в standalone и в серверном режиме, а настройки из config.yaml больше не теряются.

  • Реестр доступен в standalone. Управление серверами (добавление, проверка, включение, удаление) работает без серверного бэкенда.
  • Сидирование из конфигурации. Серверы, описанные в config.yaml, переносятся в реестр при старте (один раз на имя) и остаются в нём: правка реестра больше не стирает конфигурацию.
  • Единый источник для менеджера. Список активных серверов берётся из реестра — тем же кодом, что и в серверном режиме.
  • CLI для реестра. synth mcp list | add | test | remove | reconnect — тонкий клиент к реестру локального инстанса. Ключ доступа читается внутри процесса и не печатается.

Пример: synth mcp add --name playwright --type http --url http://127.0.0.1:8931/mcp — сервер появится в реестре и станет доступен для включения в проекте.

Подтверждения прав: понятно и устойчиво

Полоса подтверждения переработана: теперь в ней видно, что именно вызвало вопрос, и её не теряет перезапуск инстанса.

  • Человеческая причина. Вместо технического текста для модели полоса показывает, какой участок команды или пути вызвал вопрос, и подсвечивает его. Команда показана отдельным блоком, остальные параметры — списком; прежний технический текст спрятан в свёрнутые «Технические детали».
  • Индикатор в дереве. Сессия, ждущая подтверждения, помечается в дереве сессий — цветом и подписью, а не только цветом.
  • Грант каталогом. Когда вопрос вызван динамикой в пути, разрешение можно выдать «каталогом»: агент получает доступ к этому каталогу на сессию, а не разовое разрешение на один вызов. Такой грант не снимает запреты: правила deny, защищённые пути и опасные операции остаются в силе.
  • Переживает перезапуск. Ожидание подтверждения хранится на диске. После перезапуска инстанса полоса восстанавливается с пометкой «Инстанс был перезапущен…», а ответ «разрешить» действует в рамках одобренного: для доступа к каталогу вне рабочего каталога это грант каталогом, а для изменения или удаления данных, защищённого пути и смены рабочего каталога постоянное правило не выдаётся и вопрос повторится.

Пример: агент выполняет cd "$HOME/work" — раньше это приводило к повторным вопросам, теперь переменные среды разрешаются, а вопрос задаётся только когда цель действительно неразрешима.

Поиск и чтение: контекст больше не заливает

Был случай, когда один поиск по проекту принёс в модель 243 КБ текста: подошёл минимизированный source map, где вся строка — 236 тысяч символов. Теперь инструменты поиска и чтения ограничены так, чтобы контекст оставался рабочим.

  • Предел длины строки. Строка совпадения (и строка файла при чтении) обрезается до 2000 символов; в выводе видно, что строка усечена.
  • Общий предел вывода. Результат любого инструмента ограничен общим бюджетом (по умолчанию 2000 строк или 51 200 байт). Инструмент не может этот предел отменить — раньше мог.
  • Исключения для поиска. Поиск по совпадениям не заходит в зависимости и артефакты сборки (node_modules, dist, build, out, coverage, .venv, __pycache__, .next, .turbo, .cache, файлы *.map, *.min.js и lock-файлы). Явный путь важнее исключения — если вы ищете внутри такой папки, поиск идёт как обычно.
  • Ничего не теряется молча. Исключённые совпадения считаются и показываются отдельной пометкой: «в результат не попало N совпадений».

Пример: тот же поиск по проекту теперь возвращает около двух тысяч символов вместо двухсот сорока килобайт — контекст сессии не вырастает в разы.

Также в волне 0.13.5–0.13.7

Коротко о крупном, что вошло в ту же волну:

  • SSH-доступ к удалённым хостам. Per-agent ключи хранятся в зашифрованном виде; два режима — инструменты (ssh, rsync в рабочем окружении) и агентный режим с пробросом ключа в вызов.
  • Параллельные вызовы инструментов в одном шаге. Независимые вызовы выполняются одновременно, порядок в истории остаётся прежним.
  • Сжатие контекста на границе шага. Длинный ход сжимается не в конце, а между шагами — окно не переполняется в середине работы.
  • Список задач у саб-агента. У дочерней сессии свой список дел, он не смешивается со списком родителя.
  • Рабочая панель. План, задачи, журнал и инварианты собраны в одном месте с компактными списками и редакторами.
  • Гибридный режим. Локальные сессии могут использовать MCP-серверы сервера; публикация проекта показывает прогрест в процентах; списки при недоступном сервере деградируют явно, а не «висят».

Исправления

  • Профиль в локальном режиме. Сохранение и чтение профиля владельца в standalone больше не теряются.
  • Серверный сбой провайдера больше не «съедает» ход. Сбой на стороне провайдера, пришедший в обёртке «400 — некорректный запрос», распознаётся как серверная ошибка и повторяется (3 попытки, паузы 5/15/30 секунд). Настоящие ошибки запроса — по-прежнему без повторов.
  • Одна перезагрузка вместо двух. После обновления или перезапуска страница перезагружается один раз: раньше обновление и обработчик обновления перезагружали её по очереди.
  • Мобильная полоса подтверждений. На телефоне запрос подтверждения показывается корректно и не перекрывает поле ввода.
  • Одобрения команд. cd с переменными окружения больше не даёт бесконечных ложных вопросов; «разрешить в сессии» работает для команды, а не только для пути; тела heredoc не попадают в список сохранённых правил.
  • Навыки. Скилл больше не помечается недоступным из-за того, что у агента нет лишних возможностей; в интерфейсе видно, каких именно не хватает.
  • Мелочи. Локализован подзаголовок пустого экрана, исправлена причина вопроса из стандартного ввода, добавлена подсказка в опроснике.

Безопасность

  • Грант не расширяет запреты. Разрешение «на сессию» снимает только динамический вопрос; deny, защищённые пути и опасные операции остаются запрещёнными. Если из команды нельзя надёжно вывести правило, выдаётся только разовое разрешение. Каждый выданный грант попадает в аудит.
  • Единая граница доступа. Все API под единой проверкой с закрытым списком публичных путей: маршрут, смонтированный без проверки, анонимным не становится. Регрессии ловят автоматические проверки.
  • Роли API-ключа. Роли ключа задаются настройкой; по умолчанию — обычный пользователь, а не администратор. Сравнение ключа — постоянное по времени.
  • Секреты MCP. Ответы о реестре не содержат заголовков авторизации и переменных окружения, а ссылки с учётными данными редактируются.
  • Замечания аудита закрыты. В этой волне закрыты P0-замечания внутреннего аудита 0.13.4 — среди них единая граница доступа, роль API-ключа по умолчанию и проверка реестра маршрутов. Критичных уязвимостей в продакшн-зависимостях нет.
  • Аудит перед релизом 0.13.8. Внутренний аудит нашёл два дефекта волны, и оба закрыты до выпуска: ответ «Разрешить» на восстановленное после перезапуска подтверждение мог выдать слишком широкое постоянное правило (для команды удаления — правило на все rm), а общий предел вывода инструмента можно было отменить служебным флагом самого инструмента. Теперь грант считается по той же схеме, что и в обычном ходе, а предел вывода считается по фактическому размеру результата, и отменить его из инструмента нельзя. Для пользователя это значит, что перезапуск инстанса не расширяет выданные права, а один инструмент не может вывести в контекст больше положенного. Запись аудита приложена к релизу; финальный статус аудита фиксирует релизный гейт при тегировании.

Как обновиться

Перед обновлением

  • PostgreSQL. Если инстанс работает на базе, выполните synth migrate до запуска новой версии. Повторный прогон безопасен.
  • Бэкап. Снимите резервную копию каталога данных, а для PostgreSQL — ещё и дамп базы.
  • Схема данных. Добавлены миграции 031–034: политика SSH-ключей, режим удалённого MCP, источник сессии и ожидания подтверждений. Для базы PostgreSQL переход с 0.13.4 требует прогона synth migrate.
  • Конфигурация. Новых обязательных полей нет; секция updates и параметры сервиса имеют значения по умолчанию — существующие конфиги остаются валидными.
# посмотреть, что доступно
synth update --check

# установить и перезапустить сервис
synth update --apply
synth service restart
synth --version

На бета-канале добавьте --channel beta; вернуться на стабильный — synth update --channel stable --apply (понижение версии требует подтверждения).

npm install -g @itphx/synth@latest
synth migrate --yes
synth --version
docker pull gitverse.ru/itphx/synth:0.13.8
docker rm -f synth
# затем запустите контейнер заново

Тома с данными не затрагиваются — история и настройки сохраняются.

helm upgrade synth synth/synth -f my-values.yaml --namespace synth

Данные хранятся на PVC и переживают обновление. В split-режиме образ исполнителя обновляется тем же релизом.

Известные ограничения

  • Доступ к проекту для участников и групп (участники, группы, общая видимость) пока предложение, а не реализованная возможность: модель доступа обсуждается, и в 0.13.8 её нет.
  • Перезапуск инстанса прерывает активный ход. После старта ход переигрывается, поэтому инструменты могут выполниться повторно.
  • Новая версия сама не ставится. Автопроверка лишь сообщает о наличии обновления; установка всегда требует явной команды.

Что дальше