2026-03-19 — Волна 2.40.6, UI-polish и пересборка roadmap

19 марта оказалось не узким днём документации, а полноценной релизно-документационной волной.

К концу дня проект прошёл через широкую волну 2.40.6: обновление demo и screenshot-stand, polishing темы и notice-блоков, прояснение семантики Home Assistant add-on, фиксы совместимости с Music Assistant beta, изменения в prerelease delivery и уже потом — финальную пересборку roadmap и README так, чтобы они описывали тот runtime, который реально уже есть в репозитории.

Что было сделано

День начался с большого обновления demo и docs

Первая волна была посвящена публичным demo- и docs-поверхностям:

• обновили screenshot stand и demo fixtures
• освежили документацию и наборы скриншотов на английском и русском
• поправили demo dashboard defaults
• сделали demo-режим более реалистичным для UI review и повторяемых capture-сценариев

Это важно, потому что demo-стек всё сильнее становится воспроизводимой средой для документации, UI-проверок и релизной презентации.

Theme controls и верхние notices были отполированы

Следующая волна касалась глобальной оболочки интерфейса:

• theme switcher получил полноценный режим Auto
• header, notices и layout warning-карточек были приведены к более цельному виду
• исправили рендеринг theme icon и spacing в правом верхнем углу
• demo header state и поведение notice-карточек выровняли с целевым production UX

Это заметно улучшило и реальный web UI, и demo-поверхности, которые используются в документации и релизных скриншотах.

Семантика Home Assistant add-on стала заметно яснее

Несколько изменений ужесточили и прояснили модель add-on mode:

• add-on сессии теперь могут автоматически пробовать подключить Music Assistant token при открытии UI
• долгие MA/update операции были переведены в сторону async job polling или optimistic completion вместо блокирующих Flask request path
• add-on mode теперь трактует installed track и ingress web port как фиксированные свойства установленного варианта
• вокруг этого были обновлены UI helper’ы, ссылки и предупреждения

Это одновременно и продуктовый polish, и эксплуатационное ужесточение: UI add-on режима теперь яснее показывает, что реально настраивается, а что определяется установленным HA-треком.

Совместимость с Music Assistant beta была восстановлена

В эту же волну вошли и реальные runtime-фиксы:

• починили queue и transport controls для нового поведения MA beta
• вернули совместимость solo-player shuffle и repeat через legacy queue fallback там, где это требуется
• скорректировали поведение next / previous для player-level и queue-level control
• расширили сопутствующие тесты в MA monitor, API endpoints и demo flows

Это одна из самых важных инженерных частей дня, потому что она восстанавливала поведение на реальных MA beta установках, а не только полировала презентационный слой.

Release engineering сместился к tag-based prerelease flow

19 марта также перестроило механику prerelease-доставки:

• prerelease update discovery перевели на Git tags плюс tagged changelog
• GitHub Releases фактически стали stable-only поверхностью
• sync HA add-on variants вынесли в отдельный workflow
• add-on changelog’и начали фильтроваться по channel
• staging LXC prerelease updater был исправлен, чтобы существующие установки снова могли корректно следовать новому flow

В итоге проект получил более явное разделение между stable release narrative и механикой prerelease-доставки.

Волна завершилась выпуском 2.40.6

История коммитов за день включает последовательную подготовку и синхронизацию add-on директорий от 2.40.6-rc.1 до 2.40.6-rc.7, а затем и стабильный 2.40.6.

В итоге стабильный релиз собрал день вокруг трёх ключевых результатов:

• более безопасное async-поведение MA/update запросов
• более ясная семантика HA add-on track и ingress
• восстановленная совместимость с MA beta transport controls и prerelease update flow в LXC

Roadmap теперь стартует от живой архитектуры

ROADMAP.md был полностью переписан так, чтобы уже реализованные части runtime больше не описывались как будущие идеи.

Обновлённая версия уже исходит из того, что в проекте существуют:

• BridgeOrchestrator
• startup progress и публикация runtime metadata
• snapshot/read-side модели статусов
• protocol-versioned IPC helpers
• onboarding assistant
• базовая config validation

Из-за этого изменилась и логика планирования. Следующие этапы теперь описаны как завершение текущего v2 foundation, усиление контрактов и диагностики, а уже потом — аккуратный переход к backend abstraction для v3.

README снова синхронизированы с реальным roadmap

Верхнеуровневые README.md и README.ru.md теперь говорят о тех же приоритетах, что и новый roadmap:

• довести до конца уже начатый runtime refactor
• уменьшить связность вокруг state.py
• формализовать контракты, диагностику и lifecycle конфигурации
• усилить onboarding и recovery UX
• рассматривать backend abstraction как более поздний шаг, а не как следующий rewrite

Это важно, потому что именно README чаще всего формирует первое представление о проекте у пользователей и контрибьюторов.

Появилась краткая русская версия roadmap

Добавлен ROADMAP.ru.md — короткое русское изложение актуального roadmap.

Полной source-of-truth остаётся англоязычный ROADMAP.md, но у русскоязычных поверхностей теперь есть более ясная связка между:

• полным roadmap
• русским README
• русской частью документации

README были упрощены и синхронизированы после релизной волны

Под конец дня верхнеуровневые README стали короче и яснее:

• landing pages стали компактнее и легче для сканирования
• quick start был подтянут по структуре
• блоки capabilities и prerequisites были обновлены
• roadmap messaging был синхронизирован с новым planning baseline

Это сделало точки входа в репозиторий ближе к тому, чем проект реально является сейчас: зрелым Bluetooth-first bridge с более сильной runtime-архитектурой, чем это предполагали старые docs.

Изменения roadmap/docs были доведены до main

Обновление документации было закоммичено, отправлено и смержено через уже существовавший PR-поток, так что переписанный roadmap и обновлённые README попали в main в тот же день.

Почему это важно

19 марта важен тем, что связал в одну волну release engineering, runtime compatibility, UX polish, demo/docs hygiene и проектное планирование:

• линия 2.40.6 теперь отражает реальные фиксы для HA add-on, MA beta и updater flow
• оболочка UI и demo-поверхность стали чище и репрезентативнее
• релизная механика стала понятнее для stable и prerelease каналов
• стало меньше путаницы в том, что уже реализовано, а что ещё только предстоит
• путь к v3 теперь выглядит как продолжение текущего runtime, а не как перезапуск проекта

Что дальше

Эта запись становится точкой передачи для следующей волны работы:

• продолжать привязывать release notes к tagged changelog и реальному delivery flow
• при необходимости перенести обновлённую framing-логику в другие разделы docs site
• и дальше привязывать архитектурные заметки к реально существующему коду
• использовать новый roadmap как базовую точку планирования для runtime, diagnostics, onboarding и подготовки v3