Skip to content

armgit / nota

Public Imported from GitHub
0

Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.

(docs) Remove docs folder

Egor Khindikaynen4839f0714dbe
diff --git a/docs/command-palette-requirements.md b/docs/command-palette-requirements.md
deleted file mode 100644
index 988675d5..00000000
--- a/docs/command-palette-requirements.md
+++ /dev/null
@@ -1,357 +0,0 @@
-# Command Palette — требования
-
-Цель: одна точка входа ко всему в Nota, как Command Palette в VS Code. По **⌘⇧P** (macOS) /
-**Ctrl+Shift+P** (Windows, Linux) из любого места программы открывается строка поиска, в которой
-доступны любое действие, трек, встроенное устройство, плагин и пресет. Выбранный элемент
-применяется **к тому месту, откуда палитру вызвали**: в панели устройств устройство встаёт в эту
-цепочку, в Modular — на трек, открытый в Modular. Поиск понимает и имена, и смысл
-(«тёплый пэд», «reverb for vocals», «компрессор на барабаны»).
-
-Документ построен так: что есть сейчас, требования по приоритетам (P0 → P2) с критериями
-приёмки, порядок работ, открытые вопросы.
-
----
-
-## 1. Что есть сейчас
-
-- **Реестра команд нет.** Меню описано в `MainWindow.axaml` (57 `NativeMenuItem` с жестами).
- Хоткеи разбросаны по `MainWindow.Input.cs` (`OnGlobalTransportKey` в фазе tunnel и
- `HandleKeyDown` в фазе bubble) и по самим вью: Session, Arrangement, Piano roll.
- Список в Preferences → Shortcuts ведётся вручную.
-- **⌘⇧P / Ctrl+Shift+P свободен**, конфликтов в коде нет.
-- **Поиск в браузере** (`BrowserView.cs`) — это подстрока без учёта регистра по `Name` и `Sub`,
- плюс имена папок пресетов и фильтр по тегам. Нечёткого поиска, синонимов, ранжирования
- и семантики нет.
-- **Метаданные, на которые можно опереться**: категории встроенных устройств (Instruments /
- Audio Effects / MIDI Effects), папки заводских пресетов (Pads / Bass / Leads …, Vocals /
- Drums / Mastering …), тип и вендор плагина, пользовательские теги и избранное,
- отпечаток тембра у сэмплов (Smart samples), офлайн-рендер превью пресетов (`PreviewPlayer`).
-- **Добавление устройства на трек** уже сведено к `DropBrowserItem(item, trackId)`
- (`MainWindow.Dnd.cs`). Через него работают и панель Devices, и Modular
- (`OnModularDrop` → `_modular.TrackId`). Там же учтены особые случаи: Instrument Rack
- получает новую цепочку, Drum Rack — следующий свободный пэд. Есть и вставка между карточками
- с замещением карточки под курсором (`DeviceChainView.Drop.cs`).
-- **Вью**: `MainView { Arrangement, Session, Modular }`, плюс Browser, панель Devices/Clip
- (может открываться отдельным окном), Mixer (отдельное окно), Device window, Piano roll.
-- **Modular** пока в фазе 1: это линейная цепочка трека в виде графа, CV-модуляция и
- глобальный вид ещё не работают. Каталога «устройств только для Modular» пока нет.
-
----
-
-## 2. Требования
-
-Обозначения: **[U]** UI, **[A]** прикладной слой (реестр, индекс, поиск), **[E]** движок,
-**[M]** MCP, **[D]** документация (FEATURES, CHANGELOG, nota-docs, Shortcuts).
-Каждое применение элемента из палитры — **один шаг undo**.
-
-### 2.1 Вызов и контекст — P0
-
-**CP-1. Глобальный хоткей.** ⌘⇧P / Ctrl+Shift+P открывает палитру из любого окна и фокуса:
-главное окно (Arrangement, Session, Modular, Browser, Devices, Piano roll), открепленная панель
-Devices/Clip, Mixer window, Device window. Хоткей перехватывается в фазе tunnel, так же как
-транспорт, поэтому сфокусированный контрол его не съест. Он срабатывает даже при фокусе в
-TextBox, потому что текст такая комбинация не вводит.
-Повторное нажатие при открытой палитре её закрывает.
-*Приёмка*: хоткей работает из каждого перечисленного места, включая фокус на ручке, слайдере,
-поле ввода и ComboBox.
-
-**CP-2. Снимок контекста.** В момент вызова фиксируется `PaletteContext`, и после этого он не
-меняется, пока палитра открыта:
-- `Origin` — откуда вызвали: Arrangement / Session / Modular / Devices / Browser / Mixer /
- PianoRoll / DeviceWindow;
-- `TrackId` — целевой трек (правила ниже);
-- `InsertPoint` — для Devices и Modular: после какого устройства вставлять, в какую секцию
- (MIDI FX / instrument / audio FX), внутрь какой цепочки рэка;
-- выделение: клипы, слот или сцена, временной диапазон, выбранное устройство, ноты;
-- окно, из которого вызвали: туда вернётся фокус после закрытия.
-
-**CP-3. Целевой трек и место вставки.**
-
-| Откуда вызвали | Куда идёт устройство или пресет | Примечание |
-|---|---|---|
-| Devices (панель или открепленное окно) | цепочка показанного трека, **сразу после выбранной карточки**; если ничего не выбрано — в конец своей секции | если выбрана карточка внутри рэка — в цепочку этого рэка |
-| Modular | трек `ModularView.TrackId`. **Устройство Modular** (модулятор, CV-утилита…) появляется **без связей** в центре видимой области (или под курсором, если он над канвасом), соединяет его пользователь. **Обычный эффект / MIDI-эффект / инструмент** встаёт в **конец цепочки** трека (инструмент — по правилам замены ниже) | в списке видны **устройства Modular** (CP-6a.5) |
-| Arrangement | выбранный трек; если выбрано несколько треков — первый | если трека нет — см. CP-4 |
-| Session | трек выбранного слота или колонки | |
-| Mixer | трек выбранного канала | эффекты можно класть и на return, и на master |
-| Piano roll | трек редактируемого клипа | |
-| Device window | цепочка, в которой стоит устройство, после него | |
-| Browser | выбранный трек в Arrangement/Session | Enter работает как двойной клик по элементу в браузере |
-
-Типы устройств ведут себя так же, как при drag & drop. MIDI-эффект идёт в секцию MIDI FX.
-Инструмент на треке с инструментом **заменяет** его; клипы, остальные устройства и громкость
-сохраняются. На Instrument Rack или Drum Rack инструмент добавляет цепочку или пэд. Аудиоэффект
-на MIDI-треке без инструмента не ставится, в строке результата объясняется почему.
-*Приёмка*: для каждой строки таблицы результат совпадает с тем, что дал бы drag & drop того же
-элемента в ту же точку. Реализация идёт через тот же код (`DropBrowserItem` и вставка по
-индексу из `DeviceChainView.Drop`), без копии логики.
-
-**CP-4. Нет целевого трека.** Инструмент или пресет инструмента создают новый трек. Эффект или
-MIDI-эффект без трека показываются, но неактивны, с пояснением «Select a track first».
-Палитра при этом не закрывается.
-
-**CP-5. Модификаторы применения.**
-- **Enter** — действие по умолчанию для контекста (CP-3).
-- **⌘Enter / Ctrl+Enter** — на **новый трек** (для инструментов и пресетов инструментов);
- для трека — открыть его в Devices.
-- **⌥Enter / Alt+Enter** — **заменить** выбранное устройство вместо вставки после него.
-- **⇧Enter** — применить и **оставить палитру открытой**, чтобы добавить подряд несколько
- устройств. Точка вставки сдвигается за только что добавленным устройством.
-Подсказка по модификаторам видна в футере палитры.
-
-**CP-6. Цель видна.** В шапке палитры показано, куда пойдёт выбранный элемент, например
-`→ Bass · after Nota Vintage` или `→ new track`. Строка меняется вместе с выделенной позицией
-и модификаторами. Пользователь не должен гадать, куда добавится устройство.
-
-### 2.2 Что ищется — P0
-
-**CP-6a. Типы элементов** (каждый со своей иконкой и тегом справа):
-
-1. **Actions** — все пункты меню, команды вью (Session: launch scene, stop all, + scene;
- Arrangement: duplicate, split, consolidate, freeze; Piano roll: quantize, legato…),
- переключение вью и панелей, транспорт (play, record, loop, metronome, tap tempo),
- Preferences и их страницы, Export, Undo History. У каждого действия видна клавиша
- (keycap), если она есть.
-2. **Tracks** — все треки, включая group, return и master. Enter выделяет трек и показывает
- его в текущей вью (скролл к нему). Подменю треков (CP-11) — P1.
-3. **Devices** — встроенные инструменты, аудио- и MIDI-эффекты, рэки, плагины VST3/AU
- (у плагина виден формат и вендор).
-4. **Presets** — заводские, пользовательские, наборы Drum Rack / Rhythm, пресеты плагинов
- (сохранённые в Nota **и найденные на диске**, CP-13a). Видно устройство и папку:
- `Warm Strings · Nota Volt · Pads`.
-5. **Modular devices** — узлы, которые есть только в Modular: модуляторы, CV-утилиты,
- сплиттеры, миксеры. Они видны **только при Origin = Modular** (в остальных местах их нельзя
- поставить) отдельной секцией сверху. Пока каталога нет (фаза 1), секция пустая. Провайдер
- нужно заложить сейчас, чтобы новые модули Modular появлялись в палитре без её доработки.
-
-**CP-7. Фильтр по типу.** Как в VS Code, работают префиксы:
-`>` — действия, `@` — треки, `+` — устройства и плагины, `#` — пресеты, `~` — устройства
-Modular. Без префикса ищется всё сразу. Над списком есть чипы All / Actions / Tracks / Devices /
-Presets (/ Modular); **Tab / ⇧Tab** переключают их, чип и префикс синхронизированы.
-*Приёмка*: `>quant` находит только действия, а `#warm` только пресеты.
-
-**CP-8. Контекстная релевантность.** Действия, которые в текущем контексте неприменимы
-(например, «Quantize» без выделенных нот), по умолчанию скрыты. Если запрос точно совпадает с
-именем такого действия, оно показывается неактивным с причиной. Действия текущей вью получают
-буст в ранжировании.
-
-### 2.3 Лексический поиск — P0
-
-**CP-9. Нечёткое совпадение** в духе VS Code:
-- подпоследовательность с бонусами за начало слова, camelCase и смежность символов
- (`afl` → **A**uto **F**i**l**ter, `nv` → **N**ota **V**intage);
-- префикс «Nota» игнорируется при скоринге, как в браузере: имя ищется по отличительному слову;
-- совпавшие символы подсвечиваются акцентом;
-- по каждому полю: имя > алиасы > устройство/вендор > папка/категория > теги.
-
-**CP-10. Опечатки и раскладка.**
-- допускается одна опечатка на слово от 4 символов (Дамерау–Левенштейн ≤ 1);
-- запрос, набранный в неправильной раскладке, распознаётся: `кумуки` → `reverb`
- (RU↔EN по физическим клавишам);
-- поиск нечувствителен к регистру и диакритике.
-
-### 2.4 Семантический поиск — P0 (словарь) / P2 (эмбеддинги)
-
-Принцип: у **каждого** устройства, плагина и пресета есть **семантический дескриптор**, и
-запрос сопоставляется с ним, а не только с именем.
-
-**CP-12. Схема дескриптора** (`SemanticDescriptor`, хранится рядом с метаданными устройства
-и пресета):
-
-| Поле | Пример | Для чего |
-|---|---|---|
-| `role` | `reverb`, `delay`, `compressor`, `eq`, `saturation`, `synth.subtractive`, `sampler`, `drum` | что это за устройство |
-| `aliases` | `verb`, `comp`, `eq`, `dist`, `ott` | сленг и сокращения |
-| `character` | `warm`, `bright`, `dark`, `gritty`, `clean`, `airy`, `punchy`, `wide`, `lo-fi`, `vintage` | характер звука |
-| `sound` (пресеты инструментов) | `pad`, `bass`, `lead`, `pluck`, `keys`, `bell`, `arp`, `fx`, `drone` | тип партии |
-| `source` (для эффектов) | `vocals`, `drums`, `bass`, `guitar`, `bus`, `master`, `synth` | на чём использовать |
-| `task` | `sidechain`, `glue`, `de-ess`, `widen`, `tape stop`, `mastering` | задача |
-| `genre` | `techno`, `lo-fi hip-hop`, `ambient`, `trap` | жанр |
-| `description` | 1–2 предложения на EN | для эмбеддингов (P2) и тултипа |
-
-Словарь значений `character` / `sound` / `source` / `task` закрытый и версионируется
-(`SemanticVocabulary`). У каждого термина есть синонимы на EN и RU: `warm ↔ тёплый, мягкий`,
-`pad ↔ пэд, подложка`, `vocals ↔ вокал, голос`. Русский нужен **только для поиска**: в UI
-палитры (строки, причины совпадения, тултипы) всё на английском, как в остальном приложении.
-
-**CP-13. Откуда берутся дескрипторы.**
-1. **Встроенные устройства** — пишутся вручную и лежат вместе с регистрацией устройства.
- Добавить их — шаг чеклиста `nota-instrument`. Без дескриптора новое устройство не проходит
- тест покрытия (CP-27).
-2. **Заводские пресеты** — `sound` и `source` выводятся из папки (Pads → `pad`, Vocals →
- `vocals`, Mastering → `mastering`), `role` наследуется от устройства, `character` и `genre`
- задаются в файле пресета. Пресет без `character` тоже не проходит тест покрытия.
-3. **Пользовательские пресеты** — наследуют дескриптор устройства, к нему добавляются токены
- из имени и папки и теги пользователя. При сохранении можно задать характер из того же
- словаря (P1, чипы в диалоге сохранения).
-4. **Плагины** — `role` выводится из подкатегорий VST3 (`Fx|Reverb`, `Instrument|Synth`) и
- типа или подтипа AU; к этому добавляется карта известных плагинов по вендору и имени
- (например, `FabFilter Pro-Q` → `eq`) и эвристики по имени (`*verb*`, `*comp*`, `*delay*`).
- Пользователь может поправить дескриптор из контекстного меню (P1).
-5. **Анализ звука (P1)** — для пресетов, у которых есть офлайн-превью (тот же рендер, что у
- `PreviewPlayer`), вычисляются `bright/dark` (спектральный центроид), `pluck/pad`
- (атака и затухание), `wide` (корреляция L/R), `distorted` (доля гармоник). Делается это в
- фоне один раз, результат кешируется так же, как Smart samples. Ручная разметка всегда
- важнее анализа.
-
-**CP-13a. Пресеты плагинов с диска (P1).** Индексируются файлы пресетов из стандартных папок
-ОС для каждого просканированного плагина:
-- VST3 `.vstpreset` — `~/Library/Audio/Presets/<Vendor>/<Plugin>/` (macOS),
- `%USERPROFILE%\Documents\VST3 Presets\<Vendor>\<Plugin>\` (Windows),
- `~/.vst3/presets/<Vendor>/<Plugin>/` (Linux), плюс заводские папки рядом с плагином;
-- AU `.aupreset` — `~/Library/Audio/Presets/<Manufacturer>/<Plugin>/` и `/Library/Audio/Presets/`.
-
-Пресет привязывается к плагину по class ID из файла (VST3) или по manufacturer/subtype (AU);
-пресеты не установленных плагинов не показываются. Дескриптор: `role` и `sound`/`source` — от
-плагина и подпапок (`Bass/`, `Pads/`, `Vocals/`), `character` — из токенов имени. Применение
-загружает плагин (если его нет на целевой позиции) и state из файла, одним шагом undo.
-Индекс обновляется после rescan плагинов и по изменению файлов в этих папках
-(watcher, без полного пересканирования). Эти же пресеты видны во вкладке Presets браузера.
-
-**CP-14. Разбор запроса (P0, без ML).** Запрос токенизируется, каждый токен ищется в словаре
-синонимов, получаются фасеты.
-`warm pad` → `{sound: pad, character: warm}`, тип = пресет инструмента.
-`reverb for vocals` → `{role: reverb, source: vocals}`.
-`компрессор на барабаны` → `{role: compressor, source: drums}`.
-Служебные слова (`for`, `on`, `на`, `для`) отбрасываются. Токены, которые не нашлись в
-словаре, идут в лексический поиск (CP-9).
-
-**CP-15. Ранжирование.** Итоговый скор складывается из:
-`lexical × 1.0 + facets × 0.8 + context × 0.3 + frecency × 0.3 + favorite × 0.2`.
-Веса настраиваются и проверяются тестами.
-- Точное совпадение имени всегда выше чисто семантического.
-- Семантические попадания выделены: под строкой показано, почему элемент нашёлся, например
- `warm · pad`. Пользователь должен понимать, почему ему показали `Velvet Choir` на запрос
- «тёплый пэд».
-- frecency — частота и давность использования из палитры и браузера; хранится в Settings.
-
-**CP-16. Эмбеддинги (P2).** Локальная мультиязычная sentence-embedding модель (ONNX, ≤ 100 MB)
-загружается через существующую инфраструктуру AI Models (Preferences → Downloads).
-Индексируется `description` + фасеты, поиск идёт по косинусной близости и добавляется в
-скор (CP-15) как ещё одно слагаемое. Без модели палитра полностью работает на словаре
-(CP-14). Сеть не нужна никогда.
-
-### 2.5 UI — P0
-
-**CP-17. Вид.** Оверлей по центру сверху (около 20 % высоты окна от верха), ширина 640 px,
-до 12 видимых строк. Стиль Ember (`nota-design`): поверхность `SurfaceCard`, бордер, тень,
-акцентная рамка поля. Окно под палитрой не затемняется, чтобы было видно цель. Палитра
-открывается в том окне, из которого её вызвали (главное, открепленные Devices, Mixer).
-
-**CP-18. Строка результата**: иконка типа → имя с подсветкой → вторичный текст
-(устройство · папка, или вендор · формат, или тип трека) → справа keycap действия или тег
-типа. Секции (Recent, Actions, Tracks, Devices, Presets, Modular) показываются, только когда
-запрос пустой или это режим All.
-
-**CP-19. Пустой запрос** показывает Recent (последние 5 элементов, применённых из палитры) и
-Suggested для контекста: в Devices — часто используемые эффекты, в Modular — модули, в
-Session — Launch Scene / Stop All, и так далее.
-
-**CP-20. Клавиатура**: ↑ ↓, PgUp / PgDn, Home / End, Enter и модификаторы (CP-5), Tab (CP-7),
-Esc закрывает и возвращает фокус туда, откуда палитру вызвали. Space внутри палитры вводит
-пробел; транспорт в этот момент не срабатывает. Мышь: наведение выделяет, клик применяет.
-Клик вне палитры её закрывает.
-
-**CP-21. Прослушивание (P1).** **→** (стрелка вправо) или **⌘P** на пресете или устройстве
-проигрывает превью через `PreviewPlayer`: тот же звук, что в браузере, и тот же кэш.
-**↑ ↓** при включённом Auto играют следующее. Рядом со строкой видна мини-волна.
-
-### 2.6 Производительность — P0
-
-**CP-22.** От нажатия хоткея до готовой к вводу палитры проходит **≤ 50 ms**. Пересчёт
-результатов на одно нажатие клавиши — **≤ 8 ms** на индексе в 20 000 элементов
-(1 000 плагинов, 15 000 пресетов, 300 действий, 200 треков). Поиск идёт синхронно в UI-потоке
-по готовому индексу, без аллокаций в горячем пути.
-
-**CP-23. Индекс** строится в фоне при старте и обновляется инкрементально: после rescan
-плагинов, сохранения или удаления пресета, добавления или переименования трека, смены
-библиотечных папок. Если палитру открыли раньше, чем индекс готов, она уже работает по готовой
-части, а в футере видно `indexing presets… 62 %`.
-
-### 2.7 Архитектура — P0
-
-**CP-24. Реестр команд** `ICommandRegistry` в `Nota.Application` (без зависимости от Avalonia):
-```
-PaletteCommand { Id, Title, Category, Aliases[], Gesture?, Descriptor?,
- Func<PaletteContext, Availability> CanExecute,
- Action<PaletteContext, ApplyMode> Execute }
-```
-- Пункты меню из `MainWindow.axaml` и команды вью **регистрируются в реестре**. Меню и хоткеи
- вызывают команды по `Id`, логика больше не дублируется.
-- Список в Preferences → Shortcuts и страница shortcuts в nota-docs генерируются из реестра,
- что заодно закрывает дрейф, с которым сейчас борется `nota-shortcuts`.
-- Провайдеры элементов: `ActionProvider`, `TrackProvider`, `DeviceProvider` (встроенные и
- плагины), `PresetProvider`, `ModularProvider`. Новый тип элемента — это новый провайдер.
-
-**CP-25. Применение** устройств и пресетов идёт через один сервис вставки, который
-используют и drag & drop, и палитра: `InsertDevice(item, target, mode)`. Он вынесен из
-`DropBrowserItem` и `DeviceChainView.Drop` (CP-3). Один вызов — одна undo-группа
-(`BeginUndoGroup` / `EndUndoGroup`).
-
-### 2.8 Треки — P1
-
-**CP-11. Действия над треком.** В результате-треке **→** открывает подменю: Select, Show in
-Devices, Open in Modular, Rename, Color, Mute, Solo, Arm, Freeze, Duplicate, Delete. Запросы
-вида `@bass mute` или `mute bass` сразу дают действие над треком.
-
-### 2.9 Прочее — P1 / P2
-
-- **CP-32 (P1). Поиск браузера на том же индексе.** Поле поиска в браузере использует тот
- же индекс и ранжирование (CP-9…CP-16) вместо подстроки по `Name`/`Sub`, в рамках
- активной вкладки и включённых тегов. Сохраняется текущее поведение: раскрытие папок вокруг
- совпадений, поиск по имени папки («Mastering»), счётчик совпадений. Под строкой с
- семантическим совпадением — та же причина (`warm · pad`). Golden-тесты (CP-27) гоняются и
- для браузера.
-- **CP-26 (P1). Параметры как цель.** `cutoff` в Devices находит параметры устройств
- выбранного трека; Enter фокусирует ручку, после этого можно вводить значение.
-- **CP-28 (P2). Сэмплы и проекты.** Типы `Samples` (с фасетами Smart samples: BPM, key,
- loop/one-shot, тембр) и `Projects`.
-- **CP-29 (P2). MCP.** Инструмент `palette_search(query, kinds?)` возвращает элементы со
- скором и фасетами, `palette_apply(id, target)` применяет их. Так ИИ получает тот же
- семантический поиск устройств и пресетов.
-- **CP-30 (P2). Remote.** Поиск и добавление пресета с телефона на выбранный трек.
-
-### 2.10 Качество — P0
-
-**CP-27. Тесты.**
-- Покрытие: у каждого встроенного устройства есть `role` и `aliases`, у каждого заводского
- пресета есть `sound` или `source` и хотя бы один `character`.
-- Golden-набор запросов → ожидаемые элементы в топ-3 (≥ 50 запросов на EN и RU):
- `warm pad`, `тёплый пэд`, `verb`, `кумуки`, `sidechain`, `de-esser`, `bass for techno`,
- `компрессор на барабаны`, `afl`…
-- Контекст: для каждой строки таблицы CP-3 результат применения совпадает с результатом
- drag & drop.
-- Производительность: бенчмарк на синтетическом индексе из 20 000 элементов (CP-22).
-- Undo: применение, затем ⌘Z, возвращает проект в исходное состояние.
-
-**CP-31. Документация.** Записи в FEATURES.md и CHANGELOG, страница в nota-docs (EN + RU),
-хоткей в Preferences → Shortcuts (через `nota-shortcuts` или генерацию из реестра).
-
----
-
-## 3. Порядок работ
-
-1. **Реестр команд** (CP-24) и перевод меню и хоткеев на него. Без этой основы действия
- в палитре не появятся.
-2. **Сервис вставки** (CP-25), вынесенный из drag & drop, с тестами на таблицу CP-3.
-3. **Оверлей палитры**: хоткей, снимок контекста, фильтры, клавиатура, строка цели
- (CP-1…CP-8, CP-17…CP-20).
-4. **Индекс и лексический поиск** (CP-9, CP-10, CP-22, CP-23).
-5. **Словарь и дескрипторы** для встроенных устройств и заводских пресетов, разбор запроса,
- ранжирование, golden-тесты (CP-12…CP-15, CP-27).
-6. **Плагины**: дескрипторы из VST3/AU и карты вендоров (CP-13.4).
-7. **P1**: перевод поиска браузера на общий индекс (CP-32), пресеты плагинов с диска
- (CP-13a), подменю треков, прослушивание, анализ звука, параметры, ручная правка
- дескрипторов.
-8. **Modular-провайдер** подключается вместе с каталогом модулей Modular (фаза 2 Modular).
-9. **P2**: эмбеддинги, сэмплы и проекты, MCP, Remote.
-
----
-
-## 4. Принятые решения
-
-1. **Modular**: устройство Modular появляется без связей; обычный эффект встаёт в конец
- цепочки (CP-3).
-2. **Пресеты плагинов** индексируются и с диска — `.vstpreset`, `.aupreset` (CP-13a).
-3. **Браузер** переходит на тот же индекс и поиск (CP-32).
-4. **Язык UI** — только EN; русский используется только для сопоставления запросов (CP-12).
diff --git a/docs/news/0.50.1.en.md b/docs/news/0.50.1.en.md
deleted file mode 100644
index 16828b16..00000000
--- a/docs/news/0.50.1.en.md
+++ /dev/null
@@ -1,32 +0,0 @@
-🎛 **Nota 0.50.1 is out**
-
-A big one: the Session View is rebuilt from the ground up, your phone becomes a controller, and clips now move freely between the Arrangement and the Session.
-
-**1. Session View, rebuilt for real work**
-Clips have a name, a colour, a note or waveform preview and a length in bars; an inspector on the right edits the selected clip, scene or empty slot. Launch modes (Trigger, Gate, Toggle, Repeat), per-clip quantize, legato, one-shot and follow actions with chances. Scenes carry their own tempo and time signature and can follow on to the next one after a number of bars. Session Rec records straight into a scene — cut to whole bars or a fixed 1–8 bar length. Audio slots are full audio clips with the same editor as the Arrangement, warp included. Groups, returns, the master, a mixer under the grid and full keyboard control are all there.
-
-**2. Nota Remote — your phone as a controller**
-The **Remote** button shows a QR code: scan it and five seconds later your phone plays Nota. Pads, keys in the project's scale with chords, an XY pad with tilt, the mixer, macros and the Session grid. Nothing to install; it runs over Wi-Fi or a USB cable. Several phones can play at once, each on its own track, and Nota shows who plays what. Knobs and XY axes map through the same MIDI Learn as hardware.
-
-**3. Clips between the Arrangement and Session**
-⌘C / ⌘V works both ways, or press **⌘⇧C** to send the selection straight across. Notes, envelopes, warp, pitch and gain travel with the clip, and every copy is one undo step.
-
-**4. Audio clips into instruments**
-Drag an audio clip from the Arrangement onto a track with a Sampler, Nota Grain, Drum Rack or Instrument Rack and its audio loads there (a Drum Rack takes it on the next free pad). Drop a clip anywhere a sample goes.
-
-**5. Nota Shutter · Pattern**
-A new tab turns the gate into a tempo-synced rhythmic gate: draw steps on an 8/16/32-step grid, roll new patterns with the dice, add Smooth and Swing. The pattern can also drive the Modular view as a CV source. 15 new presets.
-
-**6. Faster editing**
-• **⌘⇧D** duplicates a time range across the whole song, **⌘⇧I** inserts silence.
-• **Count-in** of 1, 2 or 4 bars before playback and recording (right-click the metronome).
-• Double-click the number next to any slider to type an exact value: "−6", "1.5k", "250 ms", "1/16".
-
-**Also**
-• A cleaner main window: the project name leads the transport bar, group nesting shows in the colour stripes, a calmer Overview, and bar-style waveforms (the solid look is one setting away).
-• AirPods and other Bluetooth headphones no longer go silent on macOS.
-• Very short notes no longer get stuck.
-
-Import audio no longer has a shortcut — find it in File ▸ Import audio; ⌘I inserts a scene in the Session.
-
-⬇️ Download: https://github.com/nota-daw/nota/releases/tag/v0.50.1
diff --git a/docs/news/0.50.1.ru.md b/docs/news/0.50.1.ru.md
deleted file mode 100644
index 14f693ff..00000000
--- a/docs/news/0.50.1.ru.md
+++ /dev/null
@@ -1,32 +0,0 @@
-🎛 **Nota 0.50.1 вышла**
-
-Большой релиз: Session View переписан с нуля, телефон стал контроллером, а клипы теперь свободно ходят между Arrangement и Session.
-
-**1. Session View — теперь для настоящей работы**
-У клипов есть имя, цвет, превью нот или волны и длина в тактах; справа — инспектор клипа, сцены или пустого слота. Режимы запуска (Trigger, Gate, Toggle, Repeat), свой квантайз, legato, one-shot и follow actions с вероятностями. Сцены задают свой темп и размер и умеют переходить к следующей через N тактов. Session Rec пишет прямо в сцену — до целых тактов или фиксированной длины 1–8 тактов. Аудио-слоты — полноценные аудиоклипы с тем же редактором, что в Arrangement, включая warp. Группы, возвраты, мастер, микшер под сеткой и управление с клавиатуры — всё на месте.
-
-**2. Nota Remote — телефон как контроллер**
-Кнопка **Remote** показывает QR-код: отсканировали — и через пять секунд телефон играет Nota. Пэды, клавиши в ладу проекта с аккордами, XY-пэд с наклоном, микшер, макросы и сетка Session. Ничего ставить не нужно, работает по Wi-Fi или по USB-кабелю. Несколько телефонов играют одновременно, каждый на своём треке, и Nota показывает, кто что играет. Ручки и XY назначаются через тот же MIDI Learn, что и железо.
-
-**3. Клипы между Arrangement и Session**
-⌘C / ⌘V в обе стороны или **⌘⇧C** — отправить выделение прямо в соседний вид. Ноты, огибающие, warp, высота и громкость переезжают вместе с клипом, каждая копия — один шаг отмены.
-
-**4. Аудиоклипы — прямо в инструменты**
-Перетащите аудиоклип из Arrangement на трек с Sampler, Nota Grain, Drum Rack или Instrument Rack — звук загрузится туда (в Drum Rack — на следующий свободный пэд). Клип можно бросить куда угодно, куда кладут сэмпл.
-
-**5. Nota Shutter · Pattern**
-Новая вкладка превращает гейт в ритмический, синхронный с темпом: рисуйте шаги на сетке 8/16/32, крутите кубик для новых паттернов, добавьте Smooth и Swing. Паттерн можно отдать как CV-источник в Modular. 15 новых пресетов.
-
-**6. Быстрее в работе**
-• **⌘⇧D** — дублировать выделенный отрезок времени во всей песне, **⌘⇧I** — вставить тишину.
-• **Count-in** на 1, 2 или 4 такта перед воспроизведением и записью (правый клик по метроному).
-• Двойной клик по числу у слайдера — и можно ввести точное значение: «−6», «1.5k», «250 ms», «1/16».
-
-**Ещё**
-• Главное окно стало чище: имя проекта в транспорт-баре, вложенность групп видна по цветовой полосе, спокойный Overview, волна в виде столбиков (сплошную можно вернуть в настройках).
-• AirPods и другие Bluetooth-наушники больше не замолкают на macOS.
-• Очень короткие ноты больше не залипают.
-
-Импорт аудио теперь без шортката — он в меню File ▸ Import audio; ⌘I в Session вставляет сцену.
-
-⬇️ Скачать: https://github.com/nota-daw/nota/releases/tag/v0.50.1
diff --git a/docs/session-view-requirements.md b/docs/session-view-requirements.md
deleted file mode 100644
index 75c438b9..00000000
--- a/docs/session-view-requirements.md
+++ /dev/null
@@ -1,212 +0,0 @@
-# Session View — требования
-
-Цель: довести Session View до уровня рабочего инструмента для джема, набросков и живых
-выступлений, ориентируясь на Ableton Live Session View. Документ: сначала что есть сейчас,
-затем требования по приоритетам (P0 → P2) с критериями приёмки, затем порядок работ.
-
----
-
-## 1. Что реализовано сейчас
-
-**Движок** (`Engine_Session.cpp`, `SessionPlayer.h`, `Engine_Render.cpp`)
-- Сетка «треки × сцены»; у каждого трека вектор `SessionSlot { hasClip, midi, audio, lengthBeats }`.
-- Один `SessionPlayer` на трек: `playing` / `pending`, квантованный запуск и стоп
- (глобальный `launchQuant`), при запуске клип всегда стартует с 0.
-- Запуск слота и сцены, стоп слота, сцены и всего; пустой слот в сцене останавливает трек.
-- «Session-only jam»: запуск клипа запускает часы, Arrangement при этом не играет;
- кнопка Back to Arrangement.
-- MIDI-слоты: цикл по `lengthBeats`, MIDI FX работают на часах слота.
-- Аудио-слоты: цикл по сэмплу с исходной скоростью, без варпа; `sourceOffsetFrames`
- и `lengthFrames` при рендере **не учитываются**.
-- Запись: MIDI — только овердаб в слот (пустой слот сначала превращается в клип на 4 доли);
- аудио — запись входа в слот.
-- Перенос: слот → Arrangement (только MIDI, вставка в позицию плейхеда);
- Arrangement → слот (MIDI и аудио; у аудио берётся весь сэмпл, обрезка клипа теряется).
-- Сцены: добавить в конец, удалить; минимум одна сцена.
-
-**UI** (`SessionView.cs`, `SessionAudioSlotEditor.cs`)
-- Рельс сцен с кнопками запуска и стопа, колонки треков, колонка Master, мини-микшер
- (pan / sends / volume / M-S-Arm / метр), кнопки Stop All и + Scene.
-- Состояния слота: пусто / заполнен / в очереди (мигает) / играет / запись; полоска прогресса.
-- Клик запускает клип; двойной клик открывает редактор (piano roll или аудио-редактор:
- длина и gain); клик по пустому слоту создаёт MIDI-клип на 4 доли; ПКМ — длина цикла
- 1–16 долей, копирование в Arrangement, удаление; drag & drop из браузера и Finder.
-- Follow actions — заглушка с бейджем N/A.
-
-**Сохранение, MCP, Remote**: слоты (ноты и аудио) и число сцен сохраняются в проекте.
-У MCP есть инструменты запуска, стопа, записи, нот и длины. Remote умеет запускать
-слот и сцену и делать Stop All.
-
-### Замеченные дефекты и пробелы
-1. В заголовке колонки написано `Inst 7` / `Audio 3` вместо имени трека; цвет назначается
- по счётчику колонок, а не берётся из цвета трека.
-2. На каждом клипе написано просто «Clip»: у клипов нет имён, цвета и превью нот или волны.
-3. Полоска прогресса считается как `globalPos % len`, а не от локальных часов слота. Если
- клип длиннее шага квантования, полоска расходится с реальной позицией.
-4. Аудио-слоты не варпаются: после смены темпа луп рассинхронизируется с сеткой (обрезается
- или оставляет тишину). Trim из Arrangement теряется.
-5. Слот → Arrangement работает только для MIDI.
-6. Групповые треки в сетке не отображаются, групповой запуск и стоп невозможны.
-7. Сцены нельзя назвать, вставить в середину, дублировать или переставить.
-8. Нет выделения, копирования, вставки, дублирования, перетаскивания слотов и навигации
- с клавиатуры.
-9. Запись в слот не задаёт длину по факту записи: всегда 4 доли плюс овердаб.
-
----
-
-## 2. Требования
-
-Обозначения: **[E]** движок (C++ и C ABI), **[I]** interop/`IAudioEngine`, **[P]** формат проекта,
-**[U]** UI, **[M]** MCP, **[R]** Remote. Каждое изменение слота или сцены — один шаг undo.
-
-### P0 — базовая полноценность (без этого Session бесполезен для работы)
-
-**S-01. Идентичность трека в колонке** [U]
-- В заголовке колонки — имя трека и его цвет (тот же, что в Arrangement и Mixer).
-- Клик по заголовку выбирает трек (девайсы внизу, синхронизация выбора с Arrangement);
- двойной клик — переименование.
-- Приёмка: после переименования или перекраски в Arrangement колонка показывает то же самое.
-
-**S-02. Свойства клипа: имя, цвет, превью** [E][I][P][U]
-- У слота есть `name` и `color` (по умолчанию — цвет трека); редактирование через ПКМ
- и через F2 / ⌘R.
-- В ячейке: имя, мини-превью нот (MIDI) или волны (аудио), длина в тактах (`2 bars`, а не `8b`).
-- Приёмка: имя и цвет переживают save/load и копирование в Arrangement и обратно.
-
-**S-03. Корректный прогресс и позиция клипа** [E][I][U]
-- Движок отдаёт локальную позицию играющего слота (`nota_session_slot_position`).
-- Прогресс в UI берётся из неё; в ячейке играющего клипа видно положение внутри цикла
- (прогресс-бар или «пирог» как в Live).
-- Приёмка: клип на 4 такта, запущенный с квантом 1 такт на 3-м такте, показывает 0% в момент старта.
-
-**S-04. Редактирование сетки** [E][I][U]
-- Выделение слота кликом по краю или с модификатором (выделение отделено от запуска);
- прямоугольное выделение; стрелки двигают выделение; Enter запускает выделенный слот.
-- ⌘C / ⌘V / ⌘D / Delete / ⌘X для слотов и диапазонов; drag слота в другой слот
- (Alt+drag — копия); перенос между треками совместимого типа.
-- Drag слота на Arrangement и клипа Arrangement на слот (в дополнение к пунктам меню).
-- Приёмка: всё это — один шаг undo; горячие клавиши добавлены в Preferences → Shortcuts.
-
-**S-05. Сцены как сущность** [E][I][P][U]
-- Имя сцены (двойной клик), вставка сцены ниже выбранной (⌘I), дублирование сцены (⌘D
- на сцене копирует все её слоты), перестановка drag-ом, удаление.
-- «Capture and Insert Scene»: создать новую сцену из играющих сейчас клипов.
-- Приёмка: удаление или вставка сцены не останавливает клипы на других сценах:
- `playing` и `pending` переиндексируются, а не сбрасываются.
-
-**S-06. Аудио-слоты с варпом** [E][P][U]
-- Аудио-слот использует ту же модель, что клип Arrangement: start offset, length, warp
- (тот же алгоритм и те же маркеры), transpose, gain.
-- При смене темпа луп остаётся синхронным с сеткой.
-- Arrangement → слот сохраняет обрезку и варп клипа; слот → Arrangement работает для аудио.
-- Редактор аудио-слота — тот же клип-редактор, что у Arrangement (а не отдельный урезанный).
-- Приёмка: луп на 120 BPM, проект переключён на 90 BPM — луп остаётся 1 такт и попадает в сетку.
-
-**S-07. Запись клипа «как в Live»** [E][I][U]
-- Запись в пустой слот длится, пока её не остановят. Длина при остановке округляется
- до ближайшего такта (по кванту запуска), затем клип зацикливается.
-- Опция *Fixed Length* (1, 2, 4, 8 тактов) в тулбаре Session: запись останавливается сама
- и клип продолжает играть.
-- Начало записи квантуется по launch quant; счёт-ин учитывается.
-- Овердаб — только для слота, который уже содержит клип (через Session Record).
- Record quantize для MIDI — опция.
-- Кнопка **Session Record** в тулбаре: записывает в выбранную сцену на всех armed-треках.
-- Приёмка: запись 3 тактов без Fixed Length даёт клип длиной 3 такта, который сразу играет.
-
-**S-08. Групповые треки** [U][E]
-- Колонка группы показывает в каждой сцене «групповой слот»: он подсвечивается, если в
- группе играет что-то из этой сцены, и по клику запускает все слоты детей в этой сцене.
-- Стоп-кнопка группы останавливает всех детей; групповую колонку можно свернуть, как в Arrangement.
-
-### P1 — производительность и live
-
-**S-10. Свойства запуска клипа** [E][I][P][U]
-- Launch mode: *Trigger* (по умолчанию), *Gate*, *Toggle*, *Repeat*.
-- Per-clip quantize (Global / None / 1/16 … 8 bars), переопределяет глобальный.
-- *Legato*: новый клип стартует с позиции предыдущего на этом треке, а не с 0.
-- Velocity amount: громкость запуска зависит от velocity MIDI-ноты, которой запустили клип.
-- Loop on/off: незацикленный клип играет один раз и останавливается.
-- Loop start/end и start marker отдельно от длины клипа.
-
-**S-11. Follow actions** [E][P][U]
-- Две действия A/B с вероятностями; время срабатывания (такты:доли); действия:
- Stop, Again, Previous, Next, First, Last, Any, Other, Jump (к слоту N).
-- Follow actions для сцен (scene follow action: «следующая сцена через N тактов»).
-- Глобальный тумблер включения follow actions (как в Live 11+).
-- Заглушка «Follow actions N/A» в тулбаре заменяется на этот тумблер.
-
-**S-12. Свойства сцены** [E][P][U]
-- Темп и размер в сцене: при запуске сцены они применяются по кванту.
-- Цвет сцены; кнопка запуска сцены показывает, что сцена играет.
-- Опция «Select next scene on launch» (в настройках), чтобы проходить сцены одной клавишей.
-
-**S-13. Запись Session-выступления в Arrangement** [E][U]
-- Arrangement Record во время джема записывает запуски клипов в таймлайн как клипы
- (как Live при Arrangement Record + Session).
-- Подсветка «Back to Arrangement» уже есть: нужно ещё помечать каждый трек, который
- перекрыт сессией (в Arrangement и в Session), и давать вернуть отдельный трек.
-
-**S-14. Управление с контроллеров и клавиатуры** [U][R]
-- MIDI Learn для слотов, сцен, стоп-кнопок трека, Stop All, Session Record и навигации по сценам.
-- Красная рамка («session ring») показывает, какой участок сетки сейчас видит
- подключённый контроллер.
-- Клавиатурные действия: запуск выбранной сцены, следующая/предыдущая сцена, стоп трека.
-- Remote: сетка с именами и цветами клипов, состояния и прогресс, стоп трека, имена сцен.
-
-**S-15. Мини-микшер и маршрутизация в Session** [U]
-- Show/hide секций (I/O, sends, mixer, crossfader) как в Live.
-- Секция I/O: вход трека, monitor (In/Auto/Off), выход.
-- Колонки return-треков (с микшером, без слотов) и master с громкостью и cue.
-- Crossfader с назначением треков A/B (P2, если кроссфейдера ещё нет в микшере).
-
-**S-16. Стоп-кнопки слотов** [E][P][U]
-- В пустом слоте можно убрать стоп-кнопку (Remove Stop Button): тогда запуск сцены
- не останавливает этот трек. Это нужно, чтобы держать бочку, пока сцены переключаются.
-
-### P2 — паритет и полировка
-
-- **S-20. Клип-огибающие и модуляция в слотах**: огибающие громкости, pan и параметров
- девайсов внутри клипа, зацикленные вместе с клипом (unlinked-длина — опционально).
-- **S-21. Capture MIDI**: кнопка, которая превращает сыгранное без записи в клип
- в выбранном слоте (буфер последних N тактов armed-трека).
-- **S-22. Consolidate / Crop / Duplicate loop** для слота (удвоение длины с копией нот).
-- **S-23. Freeze/Flatten в Session**: замороженный трек играет слоты как аудио.
-- **S-24. Отдельный Arrangement ↔ Session «Tab view»** (переключение одной клавишей, как Tab в Live)
- с сохранением выделения трека.
-- **S-25. Zoom сетки**: высота слотов и ширина колонок (компакт / норма), «сворачивание»
- треков до узкой колонки.
-- **S-26. Scale/Key у клипа** (связка с Project key): транспонирование клипа при запуске.
-- **S-27. MPE/CC в слотах**, если в piano roll есть CC-лейны.
-
----
-
-## 3. Нефункциональные требования
-
-- **Realtime**: все запуски и стопы — через атомики и lock-free очереди, как сейчас;
- в аудиопотоке нет аллокаций. Состояние «сколько играет и где» читается без блокировок.
-- **Точность**: запуск по кванту попадает в сэмпл; переход клипа внутри блока
- (а не на границе блока) — сэмплово точный, без щелчков: хвосты нот отпускаются
- через noteOff, аудио — через короткий фейд (≤ 5 мс).
-- **Масштаб**: 32 трека × 128 сцен без заметных лагов UI. Ячейки должны
- виртуализироваться или перерисовываться адресно, а не через `Refresh()` всей сетки.
-- **Undo**: каждое структурное изменение — один шаг; запуск и стоп клипа в undo не попадают.
-- **Формат проекта**: новые поля добавляются через версионирование DTO
- (`[JsonExtensionData]` уже есть); старые проекты открываются без потерь.
-- **Дизайн**: Ember (skill `nota-design`), состояния в цветах almanac (playing — success,
- queued — warning с миганием, recording — record red).
-- **MCP / Remote** получают те же возможности, что и UI (имена, цвета, свойства запуска,
- сцены, follow actions), иначе ИИ-сценарии отстанут.
-
----
-
-## 4. Предлагаемый порядок работ
-
-1. **Быстрые исправления** — S-01, прогресс из S-03, аудио слот → Arrangement из S-06.
-2. **Модель слота** — S-02 (имя, цвет), S-10 (свойства запуска) и переход аудио-слотов
- на модель клипа Arrangement (S-06). Это одна миграция формата и движка, поэтому её
- лучше делать одним этапом.
-3. **Редактирование сетки и сцены** — S-04, S-05, S-16.
-4. **Запись** — S-07, затем S-13.
-5. **Групповые треки** — S-08.
-6. **Live-слой** — S-11, S-12, S-14.
-7. **Микшер** — S-15, затем P2.