@naparnik/mcp 0.1.0 → 0.10.9

package/CHANGELOG.md

@@ -0,0 +1,1344 @@
+# Изменения @naparnik/mcp
+
+## 0.10.9 — 2026-09-20. Движок доезжает до рабочего сам
+
+Скачанная начинка доводится до рабочего состояния тем же путём, которым её
+доводит `setup`: ставится Python, собирается окружение, проходит проверка, и
+только потом версия становится текущей. До этого автоустановка оставляла
+скачанное кандидатом, и после перезапуска человек слышал «движок не установлен».
+
+## 0.10.8 — 2026-09-20. Одна установка вместо двух, и ключ больше не пропадает
+
+Движок монтажа качается той же командой, что ставит расширение: у Codex — прямо
+в терминале, у Claude Desktop — фоном на первом запуске. Раньше человек ставил
+расширение, перезапускал программу и только потом узнавал, что теперь качается
+движок; перезапуск нужен один, и после него всё готово к работе.
+
+Повторная установка больше не стирает ключ. Если новый ключ не задан, берётся
+тот, что уже стоит в настройках: обновление на свежую версию перестало
+превращаться в «ключ не задан» у того, у кого ключ никуда не девался.
+
+## 0.10.7 — 2026-09-19. Один проект собирает несколько видео, звук и свои эффекты
+
+`plan_edit` теперь принимает общий проект `naparnik-project/1`: несколько
+исходников, точные фрагменты, параллельные видеодорожки, отдельный звук,
+геометрию и эффекты из `mine`. `plan` показывает сохранённую редакцию,
+`render` собирает её тем же Runner и теми же заданиями, а `wait` и `preview`
+работают как раньше. Новых MCP-инструментов нет — их по-прежнему восемь.
+
+Вместе с движком приехал скилл `composer` и четыре проверяемых примера:
+последовательный монтаж, split-screen, picture-in-picture и пользовательский
+эффект. Согласие связано с точным отпечатком проекта, исходников и кода шага;
+изменение любого из них требует показать редакцию человеку снова.
+
+## 0.10.6 — 2026-09-19. Обновление сначала проверяет ваши доработки
+
+Новая версия теперь ставится рядом с рабочей и проверяется своим Python до
+переключения. Папка `mine` проходит отдельную проверку совместимости. Если
+проверка не знает ответа или находит поломку, прежняя версия остаётся рабочей,
+а кандидат сохраняется для разбора. Старые версии пока не удаляются: место на
+диске дешевле, чем потерянный откат.
+
+Два экземпляра одного пользовательского шага получили разные рабочие папки, а
+правка объявленного helper или библиотеки сбрасывает его кэш. Добавлен чистый
+компилятор общей композиции с точным временем кадров и звука; он пока не
+включён в обычный монтаж, пока Runner не научится исполнять его связи целиком.
+
+## 0.10.5 — 2026-09-18. Запись экрана возвращается в кадр столько раз, сколько нужно
+
+Раньше Напарник показывал запись экрана один раз за ролик — даже если вы
+просили её дважды. Теперь окон столько, сколько их в плане: показали себя,
+ушли на скринкаст, вернулись лицом на пару секунд, снова на скринкаст.
+
+Второй показ идёт ДАЛЬШЕ, а не сначала: запись продолжается с того места, где
+остановилась. Нужно с другого — скажите, с какой она секунды, и он возьмёт
+оттуда. Если записи на все окна не хватает, он скажет об этом до сборки и
+числами, а не отдаст ролик без половины показанного.
+
+## 0.10.4 — 2026-09-18. Напарник говорит, что у него есть кроме монтажа
+
+Вместе с монтажом на ваш компьютер приехали чужие наработки по визуалу,
+движению и вкусу — и Напарник до сих пор молчал о том, что они у него есть.
+Теперь при первой же проверке он их перечисляет: что это, про что и с чего
+начинать читать.
+
+Пользоваться ими можно не только в ролике. Попросите презентацию, картинку
+или страницу — он возьмёт оттуда приёмы и наши замеры так же, как берёт их
+для монтажа. Видео для этого не нужно вовсе.
+
+## 0.10.3 — 2026-09-18. В ролике будет то, на что вы сказали «да»
+
+Напарник больше ничего не собирает, пока вы не согласились. Он пересказывает
+план построчно — хук, крупности, подписи, счётчики, звук, — и ждёт вашего
+«да». Сказали «поменяй тут» — согласие снимается само, и он пересказывает
+заново. Лишнего в готовом ролике не появится: хука во весь экран, которого вы
+не просили, счётчиков поверх записи экрана, подписей из ниоткуда.
+
+Просьба узкая — работа узкая. «Просто ускорь», «убери паузы» — и он ускорит и
+уберёт, а придумывать к этому ролик не станет.
+
+А если наш план вообще не про то — скажите своими словами, каким должен быть
+ролик. Напарник напишет план целиком по вашей просьбе и покажет его; монтаж
+сверит написанное со своими мерками и, если что-то выходит за них, объяснит
+словами, что именно и почему. Передумали — «забудь, предложи своё», и он
+вернётся к обычному плану.
+
+Ещё теперь можно вычеркнуть целую строку плана: «без субтитров», «без звуковых
+ударов».
+
+## 0.10.2 — 2026-09-18. Напарник знает, где написано, как дописать его самого
+
+Попросили то, чего монтаж пока не делает, — Напарник больше не отвечает
+«так не умею». Он открывает на вашем компьютере описание того, как устроен шаг
+монтажа, и пишет недостающий шаг сам: наезд, замедление, стоп-кадр, картинку в
+картинке, свою графику, свой звук на слово. Написанное ложится в вашу папку,
+работает вместе с нашим монтажом и переживает обновления.
+
+Раньше он посылал сам себя за этим описанием туда, куда войти не может, и
+поэтому отказывал.
+
+## 0.10.1 — 2026-09-18. Карточка в начале ролика
+
+Теперь можно попросить: «сделай в начале карточку на семь секунд, напиши там,
+о чём видео». Напарник поставит её перед роликом — фирменный фон, заголовок и
+вторая строка помельче, текст на ней появляется, а не стоит с первого кадра.
+Сам ролик при этом остаётся прежним кадр в кадр: карточка добавляется, а не
+заменяет начало.
+
+Длительность своя — скажите словами. Убрать карточку тоже словами. Работает и
+там, где вы просили «просто убери паузы»: карточка не про речь.
+
+## 0.10.0 — 2026-09-17. Сначала план словами, потом сборка. Шесть инструментов вместо четырнадцати
+
+Напарник больше не бросается монтировать по первой просьбе. Сначала он
+собирает план словами: что за чем идёт, какие слова на экране, где вставки,
+что куда въезжает. План читается как текст, и его правят разговором — «это
+слово не то», «здесь крупнее», «пусть заезжает слева». Сборка запускается
+после вашего «да», а не до него.
+
+Рядом с движком теперь лежат скиллы дизайна и анимации — те самые, по которым
+работают люди. Напарник читает их сам и пишет план уже по ним, поэтому кадр
+получается собранным, а не случайным. Скиллы стоят целиком, со своими
+лицензиями; чужой код мы не запускаем.
+
+Инструментов стало шесть вместо четырнадцати: проверка и установка, план,
+правка плана, сборка, просмотр и форма выбора. Меньше названий — меньше
+шансов, что Напарник возьмётся не за то. Знания переехали к движку на ваш
+компьютер: за ними больше не ходят к нам.
+
+Правки плана теперь доходят до кадра все до одной. Раньше часть просьб
+принималась молча, а в готовом ролике ничего не менялось — двенадцать таких
+мест закрыты, и там, где сделать нельзя, приходит отказ словами.
+
+## 0.9.51 — 2026-09-18. Свой шаг из чата, ключ не в командной строке
+
+Свой шаг теперь ставится словами. «Проверить свой шаг» разбирает папку, которую
+вы написали сами, и говорит по пунктам, что в ней чинить. «Порядок шагов
+монтажа» показывает, чем идёт монтаж и чей он — наш или ваш, — и правит ваш
+порядок: поставить свой шаг до или после этапа, подменить шаг у этапа, убрать
+этап. Пишется только ваша копия в папке mine: наш порядок не трогается, и
+обновление движка вашу копию не заменяет.
+
+Проверка окружения называет действующий порядок шагов и говорит вслух, если в
+монтаже работает ваш код: чужой шаг исполняется вместе с монтажом, и знать об
+этом надо до работы, а не после.
+
+Ключ подписки больше не принимается аргументом командной строки: он виден в
+списке процессов, остаётся в истории оболочки и попадает на запись экрана.
+Ключ задаётся переменной среды — так его и присылает бот — или вводится по
+вопросу установщика, ввод при этом не показывается.
+
+## 0.9.50 — 2026-09-17. «Хочу иначе»: три двери
+
+Попросили то, чего монтаж пока не делает, — Напарник знает, куда идти: цвет,
+шрифт и кегль правятся в стиле; тот же приём другой раскладкой — это вариант;
+а своё, чего нет вовсе, кладётся своим шагом в папку mine в доме Напарника,
+и обновления её не трогают. Подробности он берёт из знания «Хочу иначе».
+Проверка окружения теперь пишет рядом с каждым шагом его имя: этим именем
+шаг зовут в redo и так называют папку своего шага.
+
+## 0.9.49 — 2026-09-18. Монтажёр спрашивает сам
+
+На первом ролике Напарник сам спрашивает, что нужно: субтитры, цвет картинки,
+паузы, свой фирменный стиль. Ответили — форма показывает карточки только по
+выбранному, на кадре вашего ролика; «Готово» запоминает. Второй ролик идёт без
+вопросов. Ничего не выбрали — это тоже запоминается, и вопрос не повторится.
+Раньше форму приходилось звать словами «покажи варианты», о которых никто не
+знал.
+
+Проверка окружения перечисляет вопросы по разделам. Совет о том, как будет
+выглядеть ролик, Напарник даёт по своему знанию о вкусе, а не наугад.
+
+## 0.9.48 — 2026-09-18. Мир, крупности и графика по плану
+
+Лестница хода работы называет новые этапы движка: фон за героем, крупности
+по плану, графику по плану. Раньше оболочка молча пропускала их, и человек
+не видел, чем занят монтаж.
+
+Начинка того же дня. Мир за героем: движок сам рисует тёмную плоскость с
+сеткой ровно в длину ролика или берёт картинку человека; вырез и свет
+включаются планом, а не ключом. Крупности по плану: весь кадр, окно снизу с
+головой над кромкой, крупный план с глазами на трети высоты; движение даёт
+только рез. Графика по плану: хук, накопительный ряд чипов, счётчик, цитата,
+бейдж шага, финальная плашка; приёмка меряет их движение по готовому файлу.
+Вопрос формы «Свой стиль: три варианта»: палитра, пара шрифтов и раскладка
+считаются по кадру человека, контраст меряется, выбор ложится в стиль
+набором. Приёмка «текст на лице». Знания под подпиской сжаты до 3 КБ.
+
+## 0.9.47 — 2026-09-17. Один чат вместо семи помощников, план ролика, папка на ролик
+
+Помощники монтажа больше не кладутся файлами в папки Клода и Codex. Монтаж
+ведёт один разговор: что делать, Напарник говорит сам, коротко и по порядку.
+Инструменты «Поставить помощников» и «Запомнить правило» убраны; правила
+(«паузы держи подлиннее») запоминаются в стиле через форму выбора. Инструкция
+модели ужалась с четырнадцати килобайт до трёх и называет только живые
+инструменты.
+
+Проверка окружения сразу говорит, что монтаж умеет: шаги, вопросы, наборы и
+чей стиль приходят тем же ответом. Отдельная справка «Что умеет монтаж» больше
+не нужна — на старте один вызов вместо двух.
+
+Движок сам составляет план ролика: ритм, крупности, накопительный ряд на
+перечислении, счётчик на числительном, окно записи экрана, акценты субтитров и
+звуковые события — по речи, брифу и таблицам замеров. Ответ о задании содержит
+план словами, рядом с версией ложится `plan-vN.md`. Правка готового ролика —
+одна операция `plan_edit`, с пересборкой из кеша за секунды; «в субтитре не то
+слово» правится без распознавания заново. Под подпиской.
+
+Папка на ролик: движок сам держит порядок в папке человека. `reels` — что в
+папке: ролики с заголовками, версиями и состоянием задания плюс файлы, роликом
+ещё не ставшие. `reel_open` — завести ролик: папка `reels/<дата>-<имя>/`, роли
+файлов по замеру (а не по имени), бриф `reel.json`, исходники переезжают в
+`source/`. Два дубля с речью разом движок не выбирает сам — спрашивает. Файл,
+у которого уже есть проект, в новый ролик не переезжает; два файла с одинаковым
+именем не затирают друг друга; папка, документ или ссылка за пределы папки —
+отказ словами, ни один файл не двигается. Оба инструмента работают и без
+подписки: ролик собирает `montage`, он и спрашивает.
+
+Счётчик вызовов: строка на каждый вызов инструмента в `calls.jsonl` дома, ровно
+четыре поля и потолок в мегабайт — наш замер скорости, аргументов в нём нет.
+
+## 0.9.46 — 2026-09-15. Сорок цветов вместо двухсот сорока
+
+В наборе осталось сорок фильтров: отобраны самые сильные и попарно
+непохожие. Ближайшая пара теперь отличается в сто раз заметнее, чем на
+полном наборе, — листать одинаковые карточки больше не надо.
+
+Вопрос называется «Цвет видео», а не «Фильтр на картинку»: мы делаем ролики.
+Ползунки рядом — «Настроить цвет вручную», чтобы два вопроса не звались
+одинаково.
+
+Холст цвета повторяет углы кадра: выбор фильтра больше не съедает рамку и
+скругление.
+
+## 0.9.45 — 2026-09-15. Лесенка не наезжает, тени мягче
+
+Строки лесенки перекрывали друг друга: шаг считался по капители, а слово
+занимает весь кегль — «У» и «Д» уходят ниже. Теперь шаг берётся от кегля.
+
+Тени под буквами стали прозрачнее втрое: плотные слои читались как обводка,
+которой в ролике нет.
+
+## 0.9.44 — 2026-09-14. Шрифт заводится двоичным, минуя CSP
+
+Песочница хоста приходит с «default-src 'none'», а «font-src» в ней не
+объявлен вовсе: правило @font-face с адресом — включая «data:» — отбивается
+до загрузки, и в консоли виджета остаётся отказ, которого никто не видит.
+
+Теперь гарнитура заводится через FontFace с двоичными данными: сетевого
+запроса нет, запрещать нечего, и выбранный шрифт виден в кадре.
+
+## 0.9.43 — 2026-09-14. Шрифт в превью наконец виден
+
+Правило @font-face уезжало в браузер без format(), и в песочнице хоста он
+молча его пропускал: файл приезжал, а буквы оставались системными. Теперь
+формат назван явно, и выбранная гарнитура видна в кадре.
+
+Заодно убран лишний поход к движку: за файлом шрифта идёт обычная перепечка,
+а не отдельный вызов следом за ней.
+
+## 0.9.42 — 2026-09-14. Акцент в строке, место сверху, смена шрифта
+
+Главное слово выделяется цветом и в раскладке «Строкой» — прежде цветным оно
+было только в лесенке, и выбор цвета в строке ничего не менял.
+
+У места строки появился третий вариант — «Сверху»: строка над лицом, в
+верхней трети кадра.
+
+Смена шрифта наконец видна в превью. Правило @font-face заводилось один раз
+под одним именем, и браузер считал все следующие гарнитуры повтором первой.
+
+## 0.9.41 — 2026-09-14. Восемь правок по форме
+
+Основные субтитры снова белые: цвет красит ГЛАВНОЕ слово, а старый ключ
+«colors.text» — наследие версий, где красилась вся строка, — вопрос теперь
+снимает сам. Квадрат «Белый» показывает белое, а не то, что выбрано сейчас.
+
+Шрифты: «Системного» варианта больше нет — только названия начертаний. Смена
+шрифта перерисовывает превью: файл гарнитуры приезжает от движка.
+
+Сетка: порция кратна двенадцати, и последний ряд всегда полон — вторая
+строка больше не обрывается на середине. «Показать ещё» без чисел и
+показывает набор ЦЕЛИКОМ, а не следующую горсть.
+
+Значок «во весь экран» переехал в угол виджета: разворачивается форма, а не
+картинка.
+
+Договор вопросов формы поднят на naparnik-choices/6.
+
+## 0.9.40 — 2026-09-14. Превью рисует браузер, а не движок
+
+Картинку в форме складывает сама форма: движок отдаёт сырьё — чистый кадр
+ролика, числа вида, умолчания, таблицы цвета и файл шрифта, — а субтитры,
+фильтр и ползунки браузер кладёт на кадр сам.
+
+Отсюда три починки разом. «Белый» после жёлтого даёт белый, «Внизу» после
+«По центру» ставит строку вниз: пустой вариант означает «вернуть в
+умолчание», и умолчания теперь у формы есть. Вспышка цвета в рамке ушла
+вместе со вторым путём картинки — он был единственной причиной.
+
+Фильтры считает шейдер: та же таблица 17³, какой ffmpeg красит ролик.
+Ползунок двигают — кадр меняется в тот же миг, без похода к движку.
+
+Договор вопросов формы поднят на naparnik-choices/5.
+
+## 0.9.39 — 2026-09-14. «Какие есть шрифты» — теперь можно спросить
+
+Набор из 61 начертания уехал покупателю ещё 10 сентября, а назвать шрифт он
+мог только точным именем из описи — и взять его было неоткуда: папку с
+двоичными файлами человек не читает, а имя файла и настоящее имя начертания
+расходятся (`gnyrwn977.otf` внутри зовётся «Gunny Rewritten»).
+
+Новый инструмент `fonts` спрашивает набор у движка и отвечает строкой на
+шрифт: имя для стиля, семейство с начертанием, покрытые алфавиты, лицензия.
+Алфавит стоит рядом с именем не для полноты — половина набора разрезана по
+алфавитам, и латинский шрифт под русскую речь даёт отказ на замере; увидеть
+это надо ДО того, как человек назовёт шрифт.
+
+Суммы файлов, их вес и строки копирайта модели не отдаются: движок печатает
+на весь набор 22 КБ, две трети из них не отвечают ни на один вопрос человека.
+
+Подписки инструмент не требует: посмотреть, что лежит в наборе, — витрина.
+
+## 0.9.38 — 2026-09-14. Цвет — квадратом, шрифт — словом
+
+Цвет и шрифт показывались кадром ролика: каждый показ формы гонял рендер
+ради того, что видно и без ролика, а человек ждал. Теперь цвет — квадрат
+этого цвета, шрифт — слово, набранное этим шрифтом. Рисуются мгновенно,
+приходят все сразу, «Показать ещё» им не нужна.
+
+Договор вопросов формы поднят на naparnik-choices/5: у вопроса появилось
+поле «card» — чем показывать варианты.
+
+## 0.9.37 — 2026-09-13. Кадр крупнее, лесенка слушается места
+
+Кадр слева занимал 220 точек в ширину — рядом с колонкой в семь вопросов
+он выглядел значком. Теперь ему отдано 320, то есть 569 в высоту, и
+отступы сверху и снизу.
+
+Лесенка слушается выбора места: «по центру» ставит блок серединой в
+середину кадра, «внизу» — нижней кромкой там же, где обычную строку.
+Раньше она стояла по своему числу, и человек выбирал место, а картинка не
+менялась. За кромку кадра блок при этом не выпускается.
+
+Раздел «Картинка» переименован в «Фильтры».
+
+## 0.9.36 — 2026-09-13. Лесенка субтитров и разделы в форме
+
+**Раскладок стало две.** «Строкой» — фраза целиком, как было. «Лесенкой» —
+слова разного кегля ступенями: главное слово втрое крупнее и цветное,
+остальные мелкие. Формула снята с разбора живых роликов покадрово, а не
+придумана. Места считаются на всю фразу сразу, а слова проявляются по одному
+в такт речи — потому порядок появления и выходит разным.
+
+**Вопросы разложены по разделам.** «Субтитры», «Картинка», «Монтаж» — полоса
+вкладок, на экране один раздел. Семь вопросов в ленту уже не помещались.
+«Готово» по-прежнему ждёт ответов по всей форме, а не по открытой вкладке.
+
+Договор вопросов формы поднят на naparnik-choices/4: у вопроса появился
+раздел (`group`).
+
+## 0.9.35 — 2026-09-13. Форма больше не мигает на каждый тык
+
+Человек выбирал строку — и вся форма вспыхивала заново. Две причины, обе
+убраны. Появление карточек играло на КАЖДОЙ отрисовке, а форма рисуется
+заново после каждого ответа: теперь движение показывается один раз, при
+первом показе. И кадр слева мерцал, пока пекутся образцы, даже когда они
+приходили из кэша за десятую долю секунды: теперь мерцание включается
+только если печётся дольше четверти секунды.
+
+**Список больше не пересобирается.** Раскладка та же — меняются только
+картинки и кадр слева, разметка живёт. Заодно ушёл баг: «Показать ещё»
+появлялась под вопросом, где всё давно показано.
+
+## 0.9.34 — 2026-09-13. Цвет крутится не вслепую
+
+Форма, в которой спросили ТОЛЬКО цвет картинки, показывала девять ползунков и
+пустое место слева: образец у такого вопроса один на весь вопрос, движок его
+печёт, а форма читала только образцы карточек — и выбрасывала. Теперь кадр
+слева показывает, что вышло из накрученных чисел.
+
+## 0.9.33 — 2026-09-13. Цвет картинки: 244 фильтра и девять ползунков
+
+**Фильтры.** В паке лежит набор из 244 цветовых таблиц: человек листает их
+сеткой — на СВОЁМ кадре, а не на чужой модели, — и выбирает тыком. Качать
+ничего не нужно, всё уже на диске: таблица весит семь килобайт.
+
+**Ползунки, как в монтажных программах.** Температура, оттенок, насыщенность,
+экспозиция, контраст, света, тени, белое, чёрное и цветовые секторы. Кадр слева
+показывает результат: подкрутил — увидел. Фильтр и ползунки складываются, как
+человек и ждёт: сначала фильтр, потом его правки.
+
+**Шрифты.** Все 46 шрифтов набора, которые умеют писать по-русски, теперь в
+форме — порциями по восемь, с кнопкой «Показать ещё».
+
+**⚠ Образцы показывали кадр БЕЗ цвета.** Карточки фильтров выходили побайтово
+одинаковыми, а движок отчитывался «испёк»: человек выбирал бы цвет вслепую.
+Теперь цвет ложится на образец тем же порядком, что в монтаже, — фильтр на
+картинку, буквы поверх.
+
+Выбранное запоминается как и раньше: фильтр и числа ложатся в пак стиля
+человека, и следующий монтаж берёт их сам.
+
+## 0.9.32 — 2026-09-13. Замок версий считает дату по UTC, а не по местному календарю
+
+Вчерашняя сборка отвергла сама себя: младшая начинка была записана как
+«2026.09.13-1» по московскому календарю, а выкладка в тот же час собрала
+«2026.09.12-230» — по UTC было ещё двенадцатое. Прогон покупателя на стенде
+честно встал на установке движка со словами «раздача ещё не обновилась». Номер
+теперь берётся из уже собранного артефакта, а не сочиняется по календарю.
+
+## 0.9.31 — 2026-09-13. Монтаж знает, что умеет, спрашивает только нужное и помнит выбор
+
+**Каталог.** Инструмент `capabilities` называет модели, что умеет движок: шаги
+монтажа, вопросы формы с вариантами, рецепты, чей стиль сейчас. Что тяжёлое ещё
+не стоит — модель распознавания речи, вырезание фона — каталог не прячет за
+«нельзя»: оно докачается перед первым монтажом, по согласию.
+
+**Только нужные вопросы.** `choose_variant` получил `questions`: модель
+показывает те вопросы, о которых просил человек, а не все подряд.
+
+**Вопросы без картинки.** Форма умеет строки без кадра — «Резать паузы?» первый.
+Все вопросы без картинки — кадра нет, колонка на всю ширину.
+
+**Память.** «Готово» записывает выбор в стиль человека и в настройки хода
+(`variant_chosen` → движок `choose-apply`); следующий монтаж берёт это сам, а
+форма в следующий раз показывает уже выбранное помеченным. Обучаемый монтажёр,
+только простой.
+
+**«Есть обновление».** Ответ о подписке несёт последние версии расширения и
+движка; вышла новая — модель один раз за разговор скажет, что обновить и как
+(`update_shell` / `update_engine`).
+
+⚠ Договор вопросов поднят на `naparnik-choices/2`, замок версий поднят с обеих
+сторон: этой оболочке нужна начинка не старше 2026.09.12-230, а начинка не
+отдаётся оболочкам старше 0.9.31.
+
+## 0.9.30 — 2026-09-12. Образцы пекутся поверх уже выбранного
+
+**⚠ Форма врала о результате.** Владелец: «когда я выбираю цвет, субтитры опять
+идут наверх, хотя я их внизу выбрал». Каждый образец пёкся от исходного стиля, и
+вопрос про цвет показывал строку на прежнем месте. Теперь после каждого ответа
+форма просит движок испечь остальные вопросы поверх выбранного; пока печётся,
+кадр мерцает, а щёлкать можно дальше. Прогон покупателя проверяет это на
+настоящем движке.
+
+Заголовок формы — имя ролика, над ним метка «Монтаж»; подписи под вопросами
+убраны — очевидные фразы не пишут.
+
+## 0.9.29 — 2026-09-12. Все вопросы сразу: место, цвет и что движок пришлёт дальше
+
+Форма показывала первый вопрос, а остальные называла шагами «позже». Теперь она
+спрашивает обо всём разом: над заголовком имя ролика, ниже разделы по вопросам,
+в каждом свои строки. «Готово» появляется, когда отвечены ВСЕ: иначе модель
+узнала бы про место строки и не узнала про цвет, а человек был бы уверен, что
+выбрал оба.
+
+Выбор уходит списком — по строке на вопрос, с именами вариантов латиницей, как
+их знает движок. Полоска шагов убрана: разделы сами и есть шаги.
+
+## 0.9.28 — 2026-09-12. Отступ между кадром и выбором 81 на широком экране
+
+Мера владельца. Включается с 760 точек: колонка 408 и кадр 220 с таким отступом
+дают пару в 709, и во врезку шириной 640 она не влезает. Ниже порога отступ
+прежний, 20 — иначе кадр и варианты читались бы не одной вещью, а двумя через
+провал.
+
+## 0.9.27 — 2026-09-12. Между кадром и выбором всегда один отступ
+
+Колонка выбора стояла посреди своего столбца, и на широком экране между кадром
+и вариантами зияла пустая полоса. Теперь ширина пары считается из меры колонки
+(408 при доле 65%), пара стоит по центру, а отступ между кадром и выбором один и
+тот же на любой ширине.
+
+## 0.9.26 — 2026-09-12. Скелет не пропадает: у столбцов задана ширина
+
+Форма во время ожидания показывала пустоту. Причина: кадр и колонку выбора
+поставили посреди своих столбцов полями «auto», а элемент сетки с таким полем
+перестаёт растягиваться и берёт ширину по содержимому. Пока образцы пекутся,
+содержимого нет — одни серые плашки, — и ширина выходила ноль.
+
+## 0.9.25 — 2026-09-12. Пока образцы пекутся — серые кости вместо слов
+
+Раньше в это время висели заглушки: чёрный прямоугольник вместо кадра, вопрос
+«Какие субтитры?» и подсказка, которые через секунду менялись на настоящие.
+Теперь на их местах серые скруглённые плашки с бегущим по ним светом, а кадр
+серый, а не чёрный. Читается как работа, а не как поломка, и ничего не прыгает:
+кости ростом с будущие строки. Кадр в скелете темнее остальных плашек: ровный
+серый читается одним пятном, а с разницей в тоне видно, где будет главное.
+
+Колонка выбора — 408 точек, и на широком экране кадр с колонкой больше не
+липнут к левому краю: пустые поля остаются с обеих сторон.
+
+## 0.9.24 — 2026-09-12. Колонка выбора 460, и форма не пропадает в свёрнутом блоке
+
+Строки вариантов растягивались во всю ширину, и подпись уезжала от названия.
+Теперь колонка выбора — 460 точек. Во весь экран кадр и форма прижаты к левому
+краю, а не плывут посреди пустого окна.
+
+**⚠ Форма могла прийти пустой, и это видел бы каждый.** Если блок в ленте
+свёрнут или прокручен мимо в тот момент, когда пришли варианты, строки
+оставались невидимыми навсегда: появление задано анимацией, а она в скрытом
+окне не стартует. Развернул блок — а там вопрос без единого варианта, и ни
+одной ошибки нигде. То же грозило знаку «готово» у полосы работы. Нашёл стенд
+виджетов.
+
+## 0.9.23 — 2026-09-12. «Во весь экран» переехала на кадр
+
+Кнопка стояла рядом с вопросом и отнимала у него треть строки. Теперь это
+значок в углу кадра — как в плеере, и вопрос занимает всю ширину колонки.
+
+## 0.9.22 — 2026-09-12. Форма выбора: результат слева, выбор справа
+
+Слева треть блока занимает кадр 9:16 — ваш кадр с тем, что выбрано, со
+скруглением как у экрана iPhone. Справа вопрос, описание и простые строки
+вариантов: название и подпись, метка выбора кружком. Картинки из строк ушли —
+восемь вертикальных кадров в столбик в блок не помещались, а образец и так
+виден слева крупно. Кадр раньше показывался только во весь экран.
+
+На узком окне кадр ложится сверху и остаётся небольшим, чтобы не выталкивать
+варианты за нижний край.
+
+## 0.9.21 — 2026-09-12. Форма и полоса одеты по образцу apple.com
+
+Подложка стала плитой с мягким градиентом книзу: в светлой теме из белого в
+светло-серый, в тёмной из серого в чёрный. Текст темнее и ровнее, заголовок и
+описание под вопросом набраны SF Pro Display — на Маке это системный шрифт.
+Раньше фон был прозрачным и сливался с лентой.
+
+## 0.9.20 — 2026-09-10. Видно, что происходит; монтаж на чистой машине снова запускается
+
+**Полоса хода работы.** Установка и монтаж больше не идут в тишине: в ленте
+видно этапы (сделан, идёт, ждёт), что делается сейчас, сколько осталось и
+сколько прошло. В конце — путь к готовому файлу или отказ словами. Полоса сама
+спрашивает движок раз в две с половиной секунды и замолкает, когда работа
+кончилась или окно закрыли.
+
+**⚠ Монтаж не запускался у покупателя ВООБЩЕ.** Задача заводится командой
+движка, которая с 2026-09-09 стоит под подпиской, а ключ до неё не доезжал:
+человек с живой оплатой получал «монтаж идёт по подписке, а ключа на этой
+машине нет». Руками это не видно, пока в доме лежит движок от прошлых опытов, —
+нашёл новый прогон покупателя на пустом доме.
+
+**Прогон покупателя** (`make smoke-buyer`, 3,5 секунды, без сети) проходит
+весь путь за человека: пустая машина, отказы без движка, образцы на кадре,
+монтаж до файла на диске, заслон подписки. Он же ловит беды, которые раньше
+находились только руками: форма не поняла ответ хоста, старая форма из кэша,
+трассировка вместо слов, инструмент выпал из списка.
+
+## 0.9.19 — 2026-09-10. Отказ виден в форме, а движок ставится ДО показа
+
+**Пустая рамка со значком беды больше не появится.** Движка на машине нет —
+инструмент честно отвечал «позови install_engine», но форма про отказ не знала
+и не рисовала ничего. Человек видел сломанный продукт там, где система
+отработала верно и объяснила, что делать. Теперь причина написана прямо в форме.
+
+**Порядок стал правилом, а не пожеланием.** Модель звала витрину, не проверив,
+есть ли движок, — и человек получал отказ вместо карточек. Теперь и описание
+инструмента, и инструкция говорят прямо: нет движка — сперва install_engine с
+согласия человека, и только потом карточки.
+
+## 0.9.18 — 2026-09-10. Свод двух дорог одного дня
+
+**Для вас ничего нового.** В этой версии встретились две работы, шедшие рядом:
+установка по требованию с видимым ходом (0.9.17) и образцы на вашем кадре в
+форме выбора (0.9.15, 0.9.16). Номер поднят потому, что состав кода после
+свода другой, а файл расширения в раздаче под старым номером неприкосновенен.
+
+## 0.9.16 — 2026-09-10. Образцы теперь на ВАШЕМ кадре: форму наполняет движок
+
+**Карточки показывают кадр вашего ролика, а не наши рисунки.** Движок берёт
+кадр, накладывает вариант тем же кодом, что рисует монтаж, и отдаёт форме
+картинку. Пять образцов за 0,6 секунды, повторно из кэша за 0,09.
+
+**Вопросы и варианты называет движок, а не оболочка.** Заглушка с тремя
+нарисованными раскладками снята: она уже расходилась с монтажом — обещала
+«лесенку» и «караоке», которых он не умеет. Теперь в форме то, что движок
+правда нарисует: положение строки и цвет. Новый вариант — хоть наш, хоть
+заведённый покупателем — появляется в форме без правки расширения.
+
+Договор с номером (`naparnik-choices/1`): разошлись версии — отказ словами
+«обнови то, что старее», а не пустая форма.
+
+⚠ Что поймало ревью перед выкладкой: форма не получила бы данные ВООБЩЕ —
+ворота разбора ждали поле снятой заглушки, и человек видел бы вечное
+«Загружаю образцы…» без единой ошибки. Тесты этого не видели, потому что
+подделка хоста слала данные не так, как шлёт живой хост.
+
+## 0.9.15 — 2026-09-10. Монтажная панель: понятный финал и полный экран
+
+**После «Готово» больше не гадаешь, случилось ли что-то.** Появляется зелёный
+круг с галочкой, крупно — что выбрано, и подсказка, что делать дальше. Раньше
+кнопка просто серела, и человек оставался перед формой без ответа.
+
+**Форма умеет разворачиваться на весь экран.** Кнопка «Во весь экран» приходит
+только если хост это умеет, а вид меняет ЕГО ответ, а не наш щелчок: отказ
+форма переживает молча. В полном экране слева кадр с образцом, справа шаги
+и карточки; в ленте всё как было.
+
+Кнопка пока называется «Готово», а не «Монтировать»: выбор в монтаж ещё не
+идёт, и обещать обратное нельзя.
+
+## 0.9.17 — 2026-09-10. Ставим только то, что нужно, и видно, что происходит
+
+**Первая установка стала короче.** Раньше она тянула распознавание речи —
+полтора гигабайта — даже тому, кто просил просто убрать паузы. Теперь сразу
+ставится только то, без чего не идёт ничто: ffmpeg, питон и окружение монтажа.
+Распознавание речи, вырез героя и чистка голоса ставятся, когда вы попросите то,
+для чего они нужны, и только после вашего «да» — с названным весом и временем.
+
+**Видно, что идёт и сколько осталось.** Установка и монтаж рассказывают ход по
+шагам: что делаем сейчас, что дальше, сколько примерно осталось. Время
+называется там, где его есть из чего посчитать, — и не называется, когда
+считать нечем.
+
+## 0.9.14 — 2026-09-10. Картинки идут форме, а не в контекст модели
+
+Ответ инструмента уезжал одним куском и модели, и форме, а в нём — картинки
+образцов. Модель их читает каждый ход и всё равно не видит: base64 в тексте
+она посмотреть не может. Теперь по спеке разведено: `content` — названия
+словами (254 знака), `structuredContent` — варианты с картинками для формы.
+
+Замер на нарисованных образцах: модели уходило 3703 знака, стало 254. С
+настоящими кадрами ролика разрыв стократный: кадр 320 точек в base64 весит
+восемь килобайт, три — двадцать четыре.
+
+## 0.9.13 — 2026-09-10. Поддержка видит, какая у вас сборка
+
+**Для вас ничего не меняется.** Расширение теперь сообщает нашему серверу номер
+сборки движка монтажа — тот же, что вы видите в «данных для поддержки».
+
+**Зачем.** Когда вы пишете «не работает», мы до сих пор не знали, какая у вас
+сборка движка: номер расширения сервер видел, номер движка — нет. Теперь видим
+и отвечаем по делу, а не «пришлите ещё раз».
+
+## 0.9.12 — 2026-09-10. Форма выбора одета по-фирменному
+
+Была сырая заготовка: системный шрифт, серые плитки, содержимое прилипало к
+краям. Теперь наши цвета и манера с лендинга — жёлтый ведёт действие, голубой
+помечает, кадр внутри карточки со своим скруглением, выбранное берётся жёлтым
+кольцом с галочкой. Кнопка «Готово» — как на сайте, с уезжающей стрелкой.
+Вёрстка от телефона: до 560 карточка горизонтальная, выше — сеткой.
+
+По дороге нашлись две молчаливые поломки:
+
+- `color-scheme: light dark` делало окно НЕПРОЗРАЧНЫМ: браузер заливал iframe
+  своим холстом по настройке системы, а не по теме Клода, и при светлом Клоде
+  на тёмной macOS заголовок пропадал целиком. В консоли при этом пусто;
+- три карточки вставали 2+1 сиротой около 640: мера не влезала втроём. Порог и
+  ширина теперь связаны арифметикой, и это записано рядом.
+
+Ещё образец «Караоке» был обрезан по краям — строка идёт целиком, без
+переноса, и на прежнем кегле не влезала в кадр.
+
+## 0.9.11 — 2026-09-10. Модель наконец знает выбор: разобрано по официальным примерам
+
+Выбор трижды не доходил до модели, и причина в том, что мы били не в тот
+канал. Разобрано по репозиторию ext-apps и спеке:
+
+- `tools/call` из формы записывает выбор НА НАШЕЙ стороне, но его результат
+  уходит виджету и в разговор не попадает — модель о нём не узнаёт вовсе;
+- `ui/update-model-context` — единственный канал до модели: «context will be
+  used in future turns». Его мы и не слали, отсюда честное «выбор ко мне не
+  пришёл» на прямой вопрос человека;
+- `ui/message` кладёт текст в поле ввода; Claude Desktop его не отправляет.
+
+Теперь по кнопке уходят все три, каждый за своё, и форма говорит человеку
+правду: выбор запомнен, текст в поле ввода, нажмите Enter — Клод ответит.
+Мгновенного ответа протокол в этом хосте не даёт, и обещать его нельзя.
+
+## 0.9.10 — 2026-09-10. Монтаж снова идёт у тех, кто платит
+
+**Если монтаж вдруг отказывал словами «ключа на этой машине нет» — это чинится
+этой версией.** Движок монтажа с недавних пор проверяет подписку сам, а
+расширение не передавало ему ваш ключ: получалось, что заплативший человек
+слышал «нет ключа» на собственном компьютере, где ключ вписан.
+
+**Ключ по-прежнему не гуляет где попало.** Он передаётся ровно тем двум
+работам, которым нужен, — монтажу и установке, — и не попадает ни в один
+соседний процесс.
+
+## 0.9.9 — 2026-09-10. Выбор доходит сам: форма зовёт инструмент, а не пишет в поле ввода
+
+Реплику от имени человека Claude Desktop кладёт в поле ввода и НЕ отправляет:
+человек выбрал, форма сказала «передал», а разговор стоит, пока он сам не
+нажмёт Enter. Теперь кнопка «Готово» зовёт инструмент `variant_chosen` —
+хост выполняет его сам, и модель отвечает на результат. Реплика осталась
+запасным путём: если вызов не принят, текст всё равно окажется в поле ввода,
+и форма прямо скажет «нажмите Enter», а не оставит человека гадать.
+
+## 0.9.8 — 2026-09-10. Выбор уходит в разговор: содержимое реплики — массивом
+
+Форма ожила: карточки рисуются, рукопожатие проходит, кнопка работает. Хост
+отказывал уже на самой реплике — «expected array, received object» по пути
+params.content. Спека 2026-01-26 рисует здесь объект, живой Claude Desktop
+требует массив; это второе расхождение подряд после appInfo в рукопожатии.
+Правило простое: верим хосту, спеку перепроверяем его ответами.
+
+## 0.9.7 — 2026-09-10. Адрес формы считает машина: ручной номер забыли в первый же раз
+
+Правило «поменял форму — подними номер в адресе руками» не пережило одной
+версии: `appInfo` вернули, номер не подняли, хост отдал сохранённую форму — и
+человек снова увидел отказ, которого в коде уже нет. Теперь в адресе восемь
+знаков от самого HTML: меняется разметка или скрипт — меняется адрес, и забыть
+нечего. Вид адреса прежний, короткий: `ui://naparnik/choose-<отпечаток>`.
+
+## 0.9.6 — 2026-09-10. Рукопожатие формы: хост требует appInfo, спека называет clientInfo
+
+**Форма не работала из-за нашей же «починки по спеке».** В 0.8.3 поле
+`appInfo` переименовали в `clientInfo`, как написано в спеке 2026-01-26, — и
+живой Claude Desktop стал отказывать в рукопожатии: «expected object, received
+undefined» по пути `params.appInfo`. Карточки при этом рисовались, а выбор
+никуда не уходил: рукопожатия не было вовсе.
+
+Спека здесь в движении: ext-apps ещё на старом SEP-1724, `clientInfo` — из
+нового SEP-2133. Поэтому шлём ОБА поля с одинаковым содержимым: лишнее хост
+игнорирует, недостающее — отвергает. Сторож проверяет оба.
+
+Ошибку показала подпись под карточками, добавленная версией раньше: до неё
+отказ хоста выглядел точно так же, как молчание, — пустотой.
+
+## 0.9.5 — 2026-09-10. Адрес формы снова короткий: на длинном хост её не рисовал
+
+Версию оболочки вписали в адрес виджета, чтобы обойти кэш хоста, — и Claude
+Desktop перестал рисовать форму вовсе: в ленте пустой блок, ошибки нигде.
+Связывает инструмент с формой только короткий адрес вида `ui://<имя>/<путь>`.
+
+Адрес снова короткий, `ui://naparnik/choose2`, а кэш обходится номером формы
+в конце: поменял разметку или скрипт — поднял число руками. Сторож в тестах
+не даёт вернуть точки и лишние сегменты в адрес.
+
+## 0.9.4 — 2026-09-10. Карточки вернулись: форма снова слышит хоста
+
+**Форма показывалась пустым блоком.** Данные приходили правильные, HTML
+отдавался — а в ленте была пустота, без единой ошибки. Две причины, обе наши:
+
+1. Виджет принимал сообщения строго от `window.parent`. Хост по спеке ставит
+   между собой и нами песочницу — первый iframe заводит второй, наш, — и
+   сообщения от неё мы молча выбрасывали. Теперь принимаем от любого предка;
+   соседний iframe по-прежнему отсечён: он ровня, а не предок.
+2. Высота сообщалась хосту только при отрисовке карточек. Нет данных — нулевая
+   высота, и человек не видит даже заголовка. Теперь высота уходит сразу, а
+   пока образцы не пришли, в форме написано «Загружаю образцы…».
+
+## 0.9.3 — 2026-09-10. Пустое поле настроек больше не выглядит как кривой ключ
+
+**Незаполненные поля в окне расширения приезжали к нам ШАБЛОНОМ, а не пустотой.**
+Claude Desktop подставлял в переменную саму строку `${user_config.api_key}` —
+и человеку, который ключа не вписывал вовсе, отвечали «неверный формат ключа,
+скопируйте целиком»: совет, который выполнить нельзя. Тем же способом ломался
+дом: движок искали в папке с именем `${user_config.engine_home}`, а лежал он в
+`~/.naparnik` — и на любую просьбу приходило «движок не установлен».
+Теперь такое значение считается незаполненным полем, как и было задумано.
+
+**«Покажи варианты субтитров» вело не туда.** Модель звала `style_check` —
+разбор уже выбранного стиля, который без движка отвечает отказом. Теперь оба
+инструмента говорят, чем они друг от друга отличаются, и то же правило стоит в
+инструкции: просят ПОКАЗАТЬ, из чего выбирать, — это форма.
+
+## 0.9.2 — 2026-09-10. Форма обновляется вместе с расширением
+
+**Обновление расширения не меняло форму, и это выглядело как поломка.**
+Названия инструментов приезжали новые, а карточки оставались старыми: без
+кнопки «Готово», с прежним рукопожатием, из-за которого выбор не доходил до
+модели. Ошибки при этом не было нигде — просто старая форма.
+
+Причина: спека MCP Apps разрешает хосту кэшировать содержимое `ui://`-ресурса
+и ничего не говорит про сброс кэша. Адрес формы был постоянным, и Claude
+Desktop честно отдавал сохранённое. Теперь версия оболочки стоит в самом
+адресе — новая версия, новый адрес, попадать в кэш нечему. Сторож в тестах
+не даёт вернуть постоянный адрес.
+
+## 0.9.1 — 2026-09-10. Помощники и человеческие названия в одном расширении
+
+Сборка двух дорог, которые шли рядом: помощники монтажа с их знаниями (0.9.0) и
+человеческие названия инструментов в настройках (0.8.3, 0.8.4). По отдельности
+ни та, ни другая до вас не доезжала — доезжает эта.
+
+**Для вас ничего нового сверх того, что уже описано ниже.** Номер поднят потому,
+что состав кода после сборки другой, а файл расширения в раздаче под старым
+номером неприкосновенен.
+
+## 0.9.0 — 2026-09-09. Помощники монтажа появляются сами
+
+**Их больше не надо ставить руками.** Сценарист, паузы, субтитры, звук, вставки,
+обложки, приёмка — скажите «поставь помощников», и они появятся в вашем Клоде
+или Codex. Дальше нейросеть зовёт их сама, когда они нужны.
+
+**Скажите «запомни» — запомнит.** «Паузы держи подлиннее», «хук короче», «музыку
+потише» — так и скажите. Помощник запишет это себе, и повторять больше не
+придётся. Новые версии ваши правила не трогают: они ваши.
+
+**Правили файл сами — ничего не пропадёт.** Напарник соберёт файл заново, а вашу
+правку отложит рядом и скажет, где она лежит.
+
+**Чужое не трогаем.** Если в папке лежит помощник не наш, Напарник его не тронет
+и скажет об этом.
+
+**Разборы и приёмы приходят по подписке.** Помощник берёт их у нас, когда они
+нужны, — на диск они не ложатся.
+
+**Кончилась подписка — файлы Напарника уходят с диска.** Ваши правила остаются:
+они ваши. Продлили — всё встаёт на место одной просьбой.
+
+
+## 0.8.4 — 2026-09-09. Компьютер не бухгалтер: «считает машина» убрано отовсюду
+
+Расширение говорило человеку словами, которых люди не говорят: «всё считает
+машина пользователя», «считать нечем», «на этой машине». Компьютер ничего не
+«считает» — работа идёт у человека на компьютере, и так это и написано теперь:
+в инструкции модели, в описаниях всех инструментов и в текстах отказов.
+
+Владелец браковал эту формулу трижды, поэтому поставлен сторож: тест ходит по
+названиям, описаниям и инструкции и краснеет на «считает», «вычисляет»,
+«режет», «резать» — со списком исключений, чтобы «прежний» и «режим» были целы.
+
+## 0.8.3 — 2026-09-09. Инструменты называются по-человечески, выбор в форме доходит до модели
+
+**В настройках расширения теперь понятные названия.** Было «Choose variant» и
+«Montage job» — латиницей, машинным переводом из имени в коде; стало «Выбрать
+вид субтитров» и «Что с монтажом». Заодно каждый инструмент говорит хосту, что
+он делает: те, что только смотрят (проверка, осмотр видео, кадр, состояние
+задачи), объявлены безопасными — Claude Desktop даёт разрешить их одной
+кнопкой вместо семи. Переписывающим объявлен один `style_grade`: он кладёт
+фильтр в пак стиля поверх одноимённого.
+
+**Выбор в форме не доходил до модели, и теперь понятно почему.** В рукопожатии
+`ui/initialize` мы слали `appInfo` вместо `clientInfo` и без `capabilities` —
+карточки рисовались (их хост шлёт независимо от рукопожатия), а реплика
+человека в разговор не попадала, без единой ошибки на экране. Поля исправлены
+по спеке, а виджет теперь показывает, что ответил хост, — молчание больше не
+выглядит как успех. Ответ хоста при этом отличается от его запроса: нумерация
+у той стороны своя и тоже с единицы, и без проверки её запрос сказал бы
+человеку «передал», когда ничего не передано.
+
+**Выбор отправляет кнопка «Готово», а не клик по карточке.** Человек вправе
+передумать до того, как ответ уйдёт в разговор; и когда вопросов станет
+несколько (субтитры, паузы, цвет), он ответит на все и нажмёт один раз.
+
+Версия протокола в рукопожатии поднята с `2024-11-05` до `2025-06-18`: поле
+`annotations` появилось позже той ревизии, и слать его, называясь старой,
+значило врать.
+
+## 0.8.2 — 2026-09-09. Ход монтажа виден в чек-листе задач
+
+Там, где у Клода есть инструменты задач (Cowork), он заводит чек-лист этапов
+монтажа по первому ответу `montage_job` и отмечает сделанные после каждого
+опроса — человек видит, что идёт, не спрашивая. Готовый файл кладётся в
+выходную папку сессии, если она есть. Это абзац в инструкции модели; в
+обычном Claude Desktop таких инструментов нет, и абзац ничего не меняет.
+
+## 0.8.1 — 2026-09-09. Расширение обновляется само
+
+**Это последний раз, когда файл расширения берётся у бота.** Дальше Напарник сам
+скажет, что вышло новое, и поставит после вашего «да». Ходить за файлом,
+перетаскивать его и удалять старое больше не нужно.
+
+**Как это выглядит.** Открыли Клода, заговорили о монтаже — Напарник одной
+фразой говорит: вышла такая-то версия, вот что в ней нового. Сказали «давай» — он
+её ставит. Работать она начнёт после перезапуска Клода или Codex, и об этом он
+тоже скажет.
+
+**Ключ остаётся в файле от бота.** Обновляется само расширение, а ключ подписки
+лежит там же, где лежал, и никуда не переезжает.
+
+**Не завелось — останется прежнее.** Новая версия сначала проверяется запуском и
+только потом становится рабочей. Не запустилась — Напарник оставляет ту, что
+работала, и говорит об этом словами; вернуться на шаг назад можно и самому.
+
+## 0.7.1 — 2026-09-09. Комментарии называют живые имена
+
+**Для покупателя ничего не меняется** — ни один инструмент, ни одна ветка кода
+не тронута. Номер поднят потому, что исходники оболочки изменились, а файл
+расширения в раздаче под старым номером неприкосновенен.
+
+**Что изменилось внутри.** Тридцать комментариев ссылались на функции, константы
+и файлы по кириллическим именам, которых в коде нет с переезда на латиницу:
+`бедаСПитоном`, `собратьВсе`, `ЖУРНАЛОВ_ХРАНИМ`, `движок.ts`, `АРХИТЕКТУРА.md`.
+Каждая ссылка сверена с кодом и переписана тем именем, которое есть:
+`pythonTrouble`, `buildAll`, `KEEP_LOGS`, `engine.ts`, `docs/architecture.md`.
+Смысл комментариев не менялся, русский текст не переводился. Возврат ловит
+сторож `tools/repo/comment-references.test.ts` — он смотрит и на `server/src`.
+
+## 0.7.0 — 2026-09-09. Всё внутри переименовано на латиницу
+
+**Старое расширение само не обновится — напишите боту.** Расширение и движок
+монтажа договариваются между собой маленьким файлом на раздаче, и в этом файле
+переименованы все поля. Версия 0.6.x таких имён не знает: она откажется ставить
+новую начинку и скажет об этом словами, а не промолчит. Лечится одной кнопкой —
+напишите боту t.me/ai_montazh_bot, он пришлёт свежее расширение. Ставится оно
+поверх, ничего удалять не надо.
+
+**Первый монтаж после обновления посчитается дольше обычного.** У движка память
+на уже посчитанное, и хранится она по именам шагов и файлов — а они теперь
+другие. Значит первый ролик пройдёт весь путь заново, вместе с распознаванием
+речи: это минуты, а не секунды. Дальше всё вернётся к обычной скорости, и
+повторные сборки того же ролика снова пойдут почти мгновенно.
+
+**Пак стиля, заведённый раньше, придётся завести заново.** Расширение скажет об
+этом прямо, когда увидит старый файл. Прежний никуда не денется и лежит там же —
+цифры из него можно перенести руками. Папки, которые движок делал рядом с вашим
+видео, тоже останутся: новые он заведёт сам, старые можно удалить когда угодно.
+
+**Что изменилось для тех, кто набирает команды руками.** Ключи установщика
+теперь `--install`, `--remove` и `--rollback` вместо прежних русских. Бот
+присылает их готовой строкой, помнить наизусть ничего не нужно.
+
+## 0.6.5 — 2026-09-09. Обновление начинки больше не откатывается само
+
+**Новая начинка теперь доезжает до человека.** Расширение качало её,
+раскладывало, запускало на пробу — и всегда решало, что это не та версия:
+дымовой прогон читал из ответа движка ключ `версия`, а `console.py версия`
+печатает `version`. Сравнивалось `undefined` с номером, не сходилось никогда, и
+КАЖДОЕ обновление откатывалось: свежая сборка ложилась на диск как
+`битая-<версия>`, человек навсегда оставался на старой начинке. Ни одна правка
+движка не могла до него доехать.
+
+**Молчало это потому, что тест проверял сам себя.** Подставной дымовой прогон в
+`update.test.ts` писал тот же неверный ключ, что и разбор, — TypeScript сверялся
+с собственной заготовкой. Теперь ключ на проводе называет сам движок: тест
+кладёт в папку версии настоящий `client/engine`, запускает настоящий
+`console.py версия` настоящим питоном и тем же `probe`, который поедет к
+покупателю. Разойдись имена ещё раз — покраснеет здесь, а не у человека.
+
+**Улика не запустившейся сборки перестала пропадать.** Ревью нашло дыру, которую
+починка выше и открыла: сборка сохранялась под именем `битая-<версия>`, а уборка
+старых версий щадила только `broken-`. То есть единственное объяснение, почему
+начинка не встала, сносилось первой же удачной уборкой. Пока дымовой прогон не
+пропускал ничего, до уборки дело не доходило вовсе; пошли обновления — ожила и
+она. Теперь имя латиницей и одной константой на запись и на фильтр, а папки
+`битая-*` с уже стоящих оболочек уборка бережёт отдельной строкой: у тех, кто
+обновлялся раньше, они лежат на диске прямо сейчас.
+
+**Пять кросс-языковых сторожей перестали молчать.** `engine.test.ts` искал
+исходники движка в `ai-editor-lab/engine` — папке, которой нет с переезда дерева
+2026-09-08, — и `describe.skipIf` гасил их разом, показывая «5 skipped» в конце
+прогона. Среди них единственная проверка, что список шагов установки в оболочке
+совпадает с `install.py`: шов, который уже расходился и уже загонял клиента в
+тупик. Пропуск снят совсем, а не поправлен: тесты в опубликованный пакет не
+уезжают, значит движок рядом с ними есть всегда. Заодно починены два регекспа,
+искавшие питоновские имена `_ВНУТРИ_ПИТОНА` и `ШАГИ`, — в движке они давно
+`_INSIDE_PYTHON` и `STEPS`. Пропусков в `engine.test.ts` теперь ноль, и на
+пропавшие исходники набор падает словами.
+
+## 0.6.4 — 2026-09-09. Мёртвый ключ перестал выглядеть нашей аварией
+
+**Замена ключа больше не читается как «у них сломалось».** Каждый новый ключ
+отключает прежний, поэтому в этот отказ упирается всякий, кто перевыпустил ключ
+и забыл поправить настройку, — случай обычный. Текст сервера был хороший
+(«ключ заменён новым, напишите боту»), портила рамка: заслон подписки 401 не
+ловил, его подхватывал протокол и печатал «Внутренняя ошибка выполнения: …».
+Человек шёл ждать вместо того, чтобы взять свежий ключ. Теперь отказом словами
+отвечает короткий список: ненастроенный ключ, 401 и наш же 429 — ровно те коды,
+которые ручка статуса подписки и отдаёт. Всё прочее остаётся ГРОМКИМ, и это
+разобрано двумя ревью: на этом пути 403 и 402 приходят от чужого (прокси), текст
+им `http.ts` сочиняет из кода состояния, и вежливое «у ключа нет прав, ключ выдаёт
+бот» уговорило бы платящего перевыпустить ключ и погасить свою же работающую
+машину. С 404 счёт тот же: он здесь уже был и ломал монтаж всем, включая
+платящих, — вежливое «подписка не активна» спрятало бы это от нас.
+Наверх по-прежнему летит и то, что словами не является (`TypeError` и подобное).
+Заодно закрылся 429 нашего же
+заслона частоты — он приезжал `NaparnikClientError` и получал ту же рамку на
+пути, который клиент проходит перед каждым монтажом; теперь человек читает,
+сколько ждать и что повторить. Работу при этом заслон НЕ пускает: сервер отвечает
+429, а не 500, именно потому, что пятисотый расширение считает нашей аварией и
+монтаж запускает, — то есть пропуск по 429 обходился бы тем самым перебором,
+ради которого заслон и поставлен.
+
+**Ключ больше не ищут в панели, которой нет.** Тексты про ключ уводили человека
+в настройки компании — остаток монолита; у этого продукта ключ выдаёт
+телеграм-бот после оплаты. Копий было четыре: `config.ts` (ключа нет, ключ битый)
+и `http.ts` (запасные тексты 401 и 403), — верной ни одной, а сторож стоял на
+пятом файле, инструкциях модели, где текст как раз был верный. Шестая копия
+нашлась ревью в `README.md`, а он уезжает на страницу пакета в npm. Теперь адрес
+бота живёт в одном файле `src/key-source.ts`, остальные его зовут, а
+`tools/repo/key-source.test.ts` запрещает слова той панели во всём, что уезжает
+покупателю, и второй экземпляр адреса. Инструкции модели при этом бота
+НАЗЫВАЮТ: раньше там стояло «открыть бота» без адреса, и модель не могла
+договорить имя чата за нас.
+
+## 0.6.3 — 2026-09-09. Форма аргументов написана один раз, на zod
+
+**Схема аргументов каждого инструмента стала одной записью.** Раньше их было
+две: JSON Schema рядом с инструментом (её читает модель) и разбор той же схемы
+руками в `arg-check.ts`. Обе были верны по отдельности и разойтись могли только
+молча — схема обещает модели одно, проверка требует другого, а узнаёт об этом
+человек: отказом на то, что ему разрешили, или опиской, уехавшей внутрь платной
+операции. Теперь схема пишется на zod, а объявление для модели ВЫВОДИТСЯ из неё
+(`src/tool-args.ts`, `defineTool`). Расхождение стало невозможным по построению;
+`tool-declaration.test.ts` утверждает это для каждого инструмента поставки, а
+`tool-args.test.ts` — что новое поле схемы само появляется в объявлении и само
+начинает проверяться. Класс-чтец из `engine-tools.ts` и файл `arg-check.ts`
+убраны.
+
+**Форма выбора из 0.6.2 прошла через ту же дверь.** `choose_variant` был объявлен
+руками — аргументов у него нет, и так было короче. Теперь он объявлен тем же
+`defineTool` с пустой схемой: иначе он остался бы единственной полкой поставки
+мимо заслона аргументов, а заслон появился ровно после того, как «мимо» однажды
+оказалось платной операцией. Виджет проходит `defineTool` полем `ui`.
+
+**Одно поведение при этом изменилось, и в сторону строгости.** Внутренний чтец
+превращал `at: "12"` в число молча, а внешняя сверка такой вызов отвергала.
+Клиент ходит через внешнюю — значит человек и раньше видел отказ, и теперь его
+видят оба пути. Терпимость к `null` и пустой строке в необязательном аргументе
+сохранена: модель регулярно присылает их вместо «не указано».
+
+**Библиотека одна, но четвёртой версии.** Вывод JSON Schema из схемы умеет сама
+zod (`z.toJSONSchema`), и только в четвёртой версии; пакет `zod@3.25` отдаёт её
+подпутём `zod/v4`, ставить ничего не пришлось. На него переведены ВСЕ места
+пакета — две копии библиотеки в бандле стоили бы 726 КБ вместо 398 КБ. Бандл
+вырос с 374 КБ до 648 КБ при потолке 2 МБ (`bundle-purity.test.ts`): это цена
+того, что схему выводит библиотека, а не наша функция по её приватным
+внутренностям. Заодно убрана мёртвая `ToolSchema` из `src/protocol/tool.ts` —
+схема «для динамической загрузки плагинов», которых у нас нет.
+
+**Заодно закрыты три дыры, которые нашли ревьюеры.** Вызов, в котором вместо
+объекта аргументов приехала строка или число, раньше превращался в пустой объект
+и проходил у инструментов без обязательных полей — теперь это отказ словами. Пак
+с возможностью по имени `video` снимал обязательность нашего `video` (`.extend` в
+zod перекрывает, а не дополняет), и `montage` пускал вызов без пути к файлу, а
+тело падало наружу `TypeError`; занятое имя теперь пропускается. Виджет формы
+выбора рисует только вшитые `data:`-картинки — когда в карточки поедут настоящие
+кадры, за внешний адрес он не полезет по построению.
+
+**Мелкие расхождения кода с самим собой закрыты.** Версия портативного питона
+читалась из `python-sources.json` по несуществующему ключу — человеку в согласии
+на скачивание предлагали «портативный Python  (24 МБ)» с дырой вместо номера.
+Справка установщика обещала `--версия`, а понимал он `--version`: теперь оба
+берутся из одного списка (`src/installer-args.ts`), и разойтись им нечем. Из
+текста запроса ключа убраны лента рилсов, распаковка бренда и генерация — этих
+инструментов нет с 2026-09-02.
+
+**Ложное обещание в описании расширения теперь сторожится.** В окне «установить
+расширение» стояли рилсы, распаковка бренда и генерация; человек ставил
+расширение за то, чего в нём нет, и первым вопросом было «где рилсы». Сам текст
+владелец переписал в 0.6.2, а здесь появился сторож
+`tools/repo/mcpb-description.test.ts`: он привязан к живому списку инструментов,
+а не к списку слов, и замолчит сам, если полка данных однажды вернётся.
+
+## 0.6.2 — 2026-09-09. Пробная форма выбора в ленте: карточки вместо вопроса словами
+
+Инструмент `choose_variant` показывает три карточки с образцами раскладок
+субтитров (по центру, лесенка, караоке), и человек выбирает тыком прямо в
+ленте Claude Desktop. Это MCP Apps: протокол оболочки научился ресурсам
+(`resources/list`, `resources/read`, `resources` в возможностях — только когда
+ресурсы есть), а инструмент несёт `_meta.ui.resourceUri`. Виджет — HTML строкой
+внутри бандла, без зависимостей; картинки вшиты `data:`-адресом.
+
+⚠ Пробный шаг: примеры нарисованы, а не сняты с ролика человека, и выбор в
+монтаж ещё не передаётся — описание инструмента говорит модели об этом
+прямо. Цель — проверить руками, что Claude Desktop рисует форму нашего
+расширения и клик доходит до модели, до того как строить в движке выпечку
+образцов на кадре клиента.
+
+## 0.6.1 — 2026-09-09. Адрес сервера по умолчанию — naparnik.ai; указатель начинки — с того же хоста
+
+Умолчание `https://company.naparnik.ai` было остатком монолита: хост не отвечает,
+проверка подписки падала сетевой ошибкой, а оболочка в этом случае пускает
+монтаж «с предупреждением» — то есть подписка у покупателя не проверялась. Теперь
+умолчание `https://naparnik.ai` (сторож сверяет с `PRODUCT_HOST` сервера), адрес
+указателя начинки выводится из адреса сервера (`manifestUrlFor`), `baseUrl`
+обязателен у сборщиков инструментов — решение об адресе принимает только
+`cli.ts`. На Windows `reg.exe` зовётся полным путём. Версия поднята с 0.6.0,
+который в раздачу не выкладывался: правило «правишь исходники — поднимай
+версию» сторожит `tools/repo/shell-version.test.ts`.
+
+## 0.6.0 — 2026-09-08. Оболочка называет серверу машину
+
+**Появился заголовок `x-machine-fingerprint`.** Вопрос о подписке уходит с
+отпечатком той машины, на которой работает оболочка. Сервер ждал его с самого
+начала и по нему привязывает ключ к первому компьютеру, а оболочка не слала —
+привязка не работала ни у кого и молча: заголовка нет, значит сервер пускает.
+Ключ монтажа — строка, и её можно переслать другу; теперь пересылка видна.
+
+Машину опознать удаётся не всегда — на урезанном компьютере команду не
+запустить и в домашнюю папку не записать. Тогда запрос уходит без заголовка,
+как раньше: наша беда не должна выглядеть как «вы не оплатили».
+
+**Рецепт отпечатка переехал с сервера.** `src/machine/` — счёт (`machine.ts`,
+`signals.ts`, `node-probe.ts`) и вид (`fingerprint.ts`). Считать отпечаток может
+только та сторона, у которой есть машина; серверу остались вид и хеш.
+`fingerprint.ts` лежит копией по обе стороны и обязан совпадать побайтово — за
+этим смотрит `tools/repo/mcp-contract.test.ts`, он же сверяет имя заголовка.
+
+**Почему 0.6.0, а не 0.5.2.** Ровно столько требует начинка:
+`client/engine/version.json`, поле `минимальная_оболочка`. Расхождение стояло с
+2026-09-07 — обновление, собранное из этих исходников, оболочка `0.5.1` ставить
+отказалась бы.
+
+⚠ **Покупателям это приедет только с новым `.mcpb`.** Оболочка сама себя не
+обновляет: она ставится один раз руками. Пока в раздаче лежит файл, собранный
+2026-09-07, у людей остаётся `0.5.1` — без заголовка и с несовпадающим замком.
+Файл собирается руками (целей `make` и задачи CI на сборку `.mcpb` нет).
+
+**Попутно починена заглушка без ключа.** Она отвечала на `post`, а инструменты
+зовут `postMontage`: без ключа человек получал сырой TypeError вместо «впишите
+ключ». Сборка клиента вынесена в `src/api-client.ts`, имя метода держит тип
+`Pick`, проводка отпечатка и текст заглушки проверяются `api-client.test.ts`.
+Нашёл ревьюер архитектуры 2026-09-08. Ревьюер безопасности: на Windows `reg`
+зовётся полным путём `%SystemRoot%\System32\reg.exe` — короткое имя без
+оболочки ищется сначала в текущем каталоге, который задаём не мы.
+
+## Не выпущено — переезд в репозиторий «Монтаж через Claude или ChatGPT»
+
+Пакет уехал из монолита AiNaparnik (`new-version/shared/mcp`) в свой
+репозиторий (`mcp/`). Версия не поднята намеренно: у клиентов не изменилось
+ничего — ни одного публичного имени, ни одного адреса, ни одного поля в сети.
+
+**Отрезаны обе приватные зависимости.** `@naparnik/super-agent-core/mcp` и
+`@naparnik/api-contracts` в npm не публиковались и вшивались в бандл хаком
+`noExternal` — иначе установка у клиента падала бы на 404 при первом же `npx`.
+Теперь:
+
+- `src/protocol/` — протокол MCP: разбор JSON-RPC, серверный транспорт поверх
+  stdin/stdout, контракт инструмента. 1771 строка из ядра. Клиентская сторона
+  MCP (клиент, менеджер пула, OAuth, транспорты http/sse — 2339 строк) НЕ
+  переехала: наш процесс сам является сервером и ни к кому не подключается;
+- `src/contracts/` — копия контрактов границы. Почему копия, а не общий модуль
+  с сервером, разобрано в шапке `src/contracts/index.ts`; за расхождением
+  следит `tests/repo/mcp-contract.test.ts` в корне репозитория;
+- единственная чужая зависимость пакета — `zod`, и она ВШИВАЕТСЯ в бандл, а не
+  остаётся внешней. Расширение для Claude Desktop собирается из одних
+  `dist/*.js`: `node_modules` внутри `.mcpb` нет и подтянуть их неоткуда, так
+  что внешний импорт упал бы у клиента с «Cannot find module 'zod'» — при
+  зелёных сборке, тестах и `npx` у нас. Держат его в бандле две вещи сразу:
+  `zod` лежит в `devDependencies` и `noExternal: ['zod']` в `tsup.config.ts`;
+  снятие любой одной ничего не ломает, снятие обеих ломает всех. Сторожит
+  результат `src/bundle-purity.test.ts`.
+
+**Имена в коде переписаны на латиницу.** Правило №0 репозитория. Русскими
+остались комментарии, тексты для людей и ключи чужих форматов — манифест
+обновления (`версия`, `url`, `sha256`, `байт`, `минимальная_оболочка`), паспорт
+пака (`имя`, `вход`, `этапы`, `модели`, `возможности`…), таблица питона
+(`база`, `платформы`, `хвост`, `мб`), пак фирменного стиля и аргументы движка.
+Их читают уже установленные расширения и питон движка; в коде они записаны
+строками: `manifest['версия']`, а не полем. Файлы тоже переименованы:
+`src/движок.ts` → `src/engine.ts`, `src/обновление.ts` → `src/update.ts` и так
+далее.
+
+**Сборка и выкладка приехали 2026-09-09.** `.mcpb` и архив движка собираются из
+репозитория (`make delivery` → `tools/delivery/`), сторож поставки читает готовые
+архивы, а на серверы их кладёт выкат (`server/docker/publish-delivery.sh`,
+задача CI `build:delivery`). Что из этого следует:
+
+- список маркеров `src/bundle-purity.test.ts` больше не лежит копией в тесте: он
+  читается из свода поставки `client/engine/delivery.json` — одного на всех трёх
+  сторожей;
+- проверка по запрещённым отпечаткам вернулась, но живёт в
+  `tools/delivery/guard.ts`: она смотрит на СОБРАННЫЙ архив, а не на `dist`;
+- умолчание адреса сервера в `src/config.ts` теперь `https://naparnik.ai` вместо
+  остатка монолита `https://company.naparnik.ai` (тот хост не отвечает вовсе), и
+  указатель начинки спрашивается на том же хосте, что и API.
+
+**Чего по-прежнему нет.** `src/version.ts` правится руками, а не собирается;
+свежесть сторожит `src/version.test.ts`. Проверки «приватные пакеты вшиты» в
+`src/bundle-purity.test.ts` нет и не будет: вшивать из монолита нечего. `npm
+publish` из конвейера тоже нет — публикация пакета ручная, и это решение.
+
+## 0.5.0 — видео в канале: одна модель, Seedance через OpenRouter
+
+Требование владельца дословно: «через mcp оставь только seedance и чтоб он
+работал только через openrouter». Сузился ТОЛЬКО внешний канал — Видео-студия в
+вебе продолжает снимать всеми моделями, ядро генерации осталось мультимодельным.
+
+**Что изменилось в объявлении `generate_video`.** Из описания ушли
+`gemini-omni-flash-preview` и `kling-o1`; осталась одна модель —
+`seedance-2.0-openrouter`. Вместе с ними пропали два параметра:
+
+- `input_video` — правки готового клипа во внешнем канале больше нет. Это делал
+  Gemini; переносить её некуда, и подменять правку генерацией похожего с нуля
+  запрещено прямым текстом отказа: это другая работа, о ней надо сказать
+  человеку, а не сделать молча;
+- `keep_original_sound` — он имел смысл только при входном клипе.
+
+**Что НЕ потерялось.** Переход между первым и последним кадром (за него держали
+Kling O1) Seedance 2.0 делает сама: приложите те же две картинки в `image_refs`.
+Три и больше картинок — пересборка сцены из деталей. Потолок картинок 9.
+
+**Старым сборкам ничего не сломает молча.** Сервер отвечает на снятую модель
+персональным объяснением, что стало с ОПЕРАЦИЕЙ, а не «недоступна, возьмите
+другую»: иначе на том конце решат, что ошиблись в имени, и начнут перебирать
+варианты. `seedance-2.0` (тот же ByteDance, но через fal и по другой цене)
+объясняется отдельно — он остался Видео-студии, а в канале передавать надо
+`seedance-2.0-openrouter`.
+
+**Деньги.** Ставка у OpenRouter своя (за токены кадра, а не за секунду),
+поэтому у канала отдельная тарифная строка. Списывается ФАКТ, который называет
+провайдер, а табличная ставка работает верхней оценкой до генерации: сверх
+показанной суммы не спишется, даже если провайдер выставил больше.
+
+
+## 0.4.0 — поставка: бандл, установщик, обновления, сторож
+
+### Разбор находок ревью (после первой сборки 0.4.0)
+
+**Первая установка на чистой машине.** Стоял тупик из двух витков: движок ставил
+установщик, которому нужен установленный движок, а портативный питон — шаг,
+которому нужен питон. На Windows, где питона из коробки нет ни у кого, это
+означало, что продукт не запускается вовсе, при том что манифест расширения
+обещает «движок расширение доставит само». Оболочка теперь умеет первую
+доставку сама (`src/доставка.ts`, `src/первая-установка.ts`): свой разбор
+`tar.gz` на `node:zlib` + `node:crypto`, сверка sha256, отказ на выход за
+пределы папки. Таблица источников питона стала общей на два языка —
+`engine/источники-python.json`.
+
+**Кириллица в адресах раздачи.** `urllib` в питоне не кодирует путь в
+percent-encoding сам и падает `UnicodeEncodeError` ДО сети, а это `ValueError` —
+мимо всех наших `except`. Манифест при этом приезжал (его качает Node, который
+путь кодирует), а архив не скачивался никогда. Адреса и имена файлов раздачи
+теперь только латиница (`/download/engine/engine-<версия>.tar.gz`,
+`manifest.json`), плюс заслон у самой сети в питоне.
+
+**Манифест обновления проверяется по значениям, а не только по типам.** Пустая
+`sha256` и нулевой `байт` проезжали как годные и молча выключали обе гарантии
+целостности. Имя версии подставлялось в путь распаковки без проверки — а питон
+перед распаковкой сносит целевую папку. Адрес архива не был ограничен ни
+схемой, ни хостом. Всё это закрыто в `годенМанифест`.
+
+**Уборка и улика больше не роняют то, ради чего заведены.** `прибратьСтарые`
+после удавшегося обновления и сохранение не запустившейся сборки стояли голыми:
+первый же занятый файл превращал успех в «Внутренняя ошибка выполнения», и
+человек логично откатывал исправную версию.
+
+**Фоновая работа переживает уход программы.** stderr фоновой задачи уходит в
+файл, а не в трубу к нам: с трубой первая же запись распознавания после закрытия
+Claude Desktop убивала монтаж `BrokenPipeError`.
+
+**Лицензии.** Сборщик вкладывает `zod` (MIT) прямо в `dist/`, то есть мы его
+распространяем. Рядом с `LICENSE.md` теперь едет `THIRD-PARTY.md`, а полнота
+списка сверяется с собранным артефактом тестом.
+
+**Прочее:** сверка аргументов одна на обе полки (описка `image_paths: "кот.png"`
+больше не уходит внутрь платной операции); чужие `PYTHONHOME`/`PYTHONPATH` и
+ключ Напарника не передаются питону; установщик Codex понимает BOM и вторую
+форму записи `[mcp_servers]`, чистит старые копии конфига и отказывается писать
+путь из кэша `npx`; сервер представляется своим именем; служебные двойники
+macOS `._имя` не едут в архив, а сторож смотрит на архив своим разбором — тем
+же, каким его прочтёт клиент.
+
+### Расширение для Claude Desktop (.mcpb)
+
+Ставится перетаскиванием файла, без консоли и конфигов. Внутри только оболочка:
+манифест, значок и собранный сервер — 120 КБ, шесть файлов, ноль зависимостей.
+Ключ вводится в поле настроек расширения и уходит в хранилище системы.
+
+Поле ключа **необязательное**: с `required: true` человек без подписки не смог
+бы завершить установку, то есть мы отрезали бы бесплатный монтаж. Запуск —
+`node …/server/cli.js`, а не `npx`: на Windows `npx.cmd` не запускается из Node
+после CVE-2024-27980.
+
+Сборка: `make mcpb-build`.
+
+### Установщик для Codex
+
+`naparnik-mcp --установить codex` (после `npm i -g @naparnik/mcp`) правит
+`~/.codex/config.toml` сам.
+Файл общий для приложения ChatGPT, консоли и расширения в редакторе, поэтому
+установщик не разбирает TOML целиком: заменяется ровно наш блок, остальное
+остаётся побайтово тем же. Чужой блок с нашим именем не трогается. Перед
+записью — копия, запись атомарна, повторный прогон даёт тот же файл побайтово.
+
+Появился разбор аргументов: `--установить`, `--удалить`, `--версия`, `--откат`.
+Без аргументов это по-прежнему сервер, который **не пишет в stdout ни байта** до
+первого JSON-RPC.
+
+### Обновление начинки
+
+Оболочка ставится один раз, движок монтажа обновляется сам: версионные папки
+`~/.naparnik/движок/<версия>`, указатель — текстовый файл (не симлинк: на
+Windows он требует прав). На старте только запрос манифеста с потолком 2 секунды
+и не чаще раза в 6 часов, параллельно с чтением паспорта пака. Скачивание —
+`update_engine` с согласия человека, через уже написанную докачку питона.
+Переключение — только после дымового прогона новой сборки; не запустилась —
+остаётся прежняя, а сборка сохраняется уликой. Откат — `engine_rollback` или
+`--откат`. Живой процесс остаётся на своей версии до перезапуска.
+
+Новые инструменты: `update_engine`, `engine_rollback` (всего 31).
+
+### Лицензионный сторож сборки
+
+`scripts/сторож-поставки.ts` проверяет **внутренность собранного архива** —
+`.mcpb`, npm-тарбола и архива начинки — и падает с ненулевым кодом. Белый список
+расширений, отпечатки sha256 (ловят переименованный шрифт и `brand/style.json`
+под разрешённым `.json`) и маркеры внутри текста. Списки — в
+`ai-editor-lab/engine/поставка.json`, тот же файл читает питоновский тест
+поставки; отпечатки — в `ai-editor-lab/запрещённые-отпечатки.json`.
+
+### Исправлено
+
+* версия жила в двух местах и разошлась: `package.json` 0.3.0 против
+  `User-Agent: naparnik-mcp/0.1`. Теперь `src/версия.ts` собирается из
+  `package.json`, свежесть сторожит тест;
+* пустой `NAPARNIK_HOME` (так Claude Desktop подставляет незаполненное поле)
+  уводил питон и оболочку в разные дома;
+* отсутствующая папка пака роняла любую команду в `spawn python3 ENOENT` —
+  диагноз «нет питона» про машину, где питон есть;
+* `update_engine` при заданном вручную `NAPARNIK_ENGINE` отчитался бы об успехе,
+  не изменив ничего: обновление работает только с версионной раскладкой. Теперь
+  отказывает словами.
+
+### Про зеркало тяжёлых зависимостей
+
+Движок умеет качать с нашего зеркала, а первоисточник оставлен запасным. Два
+правила зашиты в код: зеркало не используется, если оно менее проверяемо, чем
+первоисточник; **GPL-сборки ffmpeg с зеркала не раздаются**, пока рядом не
+выложены исходники — ссылка на апстрим распространением не является, наш сервер
+является. Адреса — заглушки, публикует владелец.
+
+## 0.3.0 — монтаж переехал сюда
+
+### ⚠ Ломающее
+
+- **`check_local_setup` удалён.** Он был ВТОРОЙ копией проверки окружения:
+  запускал `--version` и на этом основании отвечал «всё хорошо». Настоящая
+  проверка — `check_setup`: умеет ли ffmpeg нужные фильтры (`overlay`,
+  `silencedetect`, `atempo`, `concat`, `libx264`), поднимаются ли библиотеки
+  пака, какой движок распознавания выберется именно на этой машине, скачаны ли
+  веса модели. Две копии уже расходились: на Mac с процессором Apple ставился
+  `mlx-whisper`, а меньшая копия искала `faster_whisper` и говорила «✗» на
+  полностью исправной машине.
+
+  Замена: `check_local_setup` → `check_setup`.
+
+- Из публичного API пакета убраны `checkLocalSetup`, `formatSetupReport`,
+  `REQUIREMENTS`. Список нужного знают движок (`engine/окружение.py`) и паспорт
+  пака, а не TypeScript.
+
+### Добавлено
+
+- **Одиннадцать инструментов монтажа** на той же связи: `check_setup`,
+  `install_engine`, `montage`, `cut_pauses`, `montage_job`, `montage_jobs`,
+  `inspect_video`, `preview`, `style_new`, `style_use`, `style_check`.
+  Считает машина пользователя, к нам не уходит ничего, **ключ им не нужен**.
+- Третье состояние инструкции для модели: ключа нет, но монтаж доступен
+  полностью. Раньше модель говорила «интеграция не настроена, инструменты не
+  работают» — теперь это сказано только про первую полку.
+- Переменные `NAPARNIK_HOME`, `NAPARNIK_ENGINE`, `NAPARNIK_PACK`.
+
+### Исправлено
+
+- Пустая `NAPARNIK_HOME` больше не означает «текущая папка процесса». Поле
+  настроек расширения, оставленное незаполненным, приезжает пустой строкой, и
+  прочитанная как путь она развела бы оболочку и движок по разным домам:
+  задача заведена в одном, а ищется в другом. Та же правка сделана в
+  `engine/дом.py`.