переезд на Solid 2.0 и жалобы по интерфейсу #2

Open
svuvich wants to merge 6 commits from solid into master
Owner

Что это

Веб-клиент переехал с React 19 на Solid 2.0 — и в том же заходе закрыты
накопившиеся жалобы по интерфейсу. Десктоп-оболочка отдаёт тот же бандл, так
что переезд касается и её.

Почему Solid

Лента чата — это десятки узлов, которые обновляются на каждый чанк стрима.
В React цена такого обновления пропорциональна размеру поддерева компонента,
а не числу реально изменившихся данных: во время хода ререндерится вся лента,
и это видно как рывки на длинных сессиях. В Solid обновляется ровно та привязка,
которая прочитала изменившийся сигнал — единица работы не компонент, а узел.
Побочный выигрыш: нет правил хуков, нет зависимостей в useEffect, меньше
обвязки на каждый компонент.

Инструменты для агентской работы тоже лучше: в пакете лежат скиллы
(node_modules/solid-js/skills/) с описанием 2.0 и картой диагностических
кодов, а eslint-plugin-solid пресетом v2 ловит именно те ошибки, которые
в fine-grained реактивности молчат в рантайме — деструктурированный проп,
аксессор вместо значения, одноаргументный createEffect.

Переезд

  • solid-js@2.0.3, рендерер @solidjs/web, плагин @solidjs/vite-plugin.
    React и @vitejs/plugin-react удалены.
  • Слой данных (api.ts, lenta.ts, lib/*) и CSS от фреймворка не зависели
    и переехали как есть — миграция не полезла в логику.
  • Перенесены все .tsx: каркас, лента, рельса, док, композер, настройки,
    дашборд, пейринг, markdown.
  • Правила переноса — docs/solid-rules.md: пропсы не деструктурировать,
    <Show>/<For>, двухаргументный createEffect, уборка через
    return () => … (в 2.0 onCleanup внутри эффекта не работает и молча
    останавливает реактивность — это была причина вечного «Загрузка…»).

Жалобы, закрытые в этом же PR

  • Лента в стриме и в истории выглядит одинаково. Шаги рисует один и тот же
    Fold/Step; открытая посреди хода сессия больше не теряет начало
    рассуждения — бэкенд отдаёт события текущего хода.
  • Фон приветствия остаётся под сессией (прозрачность 0.06) и в десять раз
    медленнее: эффект живёт, но не отвлекает.
  • Файлы и картинки принимаются перетаскиванием в любую точку окна (слой
    DropZone с контуром по краю экрана) и вставкой из буфера в композер;
    картинки видны превью, а не именем файла.
  • Черновики живут на бэкенде поверхности: начатое на ноутбуке
    продолжается в десктопе. Черновик новой сессии виден строкой в списке.
  • У реплики человека есть «копировать» и «править» (правка режет журнал и
    возвращает текст в композер), у ошибки отправки — кнопка повтора.
  • Работающие сессии пульсируют в списке.
  • Док «Контекст» показывает итоги сессии: ходы, шаги, вызовы, токены,
    цену, кеш-хит-рейт и активное время, посчитанные на бэкенде.
  • Тикеты — стена карточек с попапом и мультивыбором; «Разобрать
    выбранные» кладёт список в черновик новой сессии.
  • Два языка: src/lib/strings.ts (409 ключей, ru/en) + i18n.ts,
    переключатель в настройках, тест падает на непереведённой строке. По-русски
    осознанно остались только тексты, которые уходят модели или разбирают формат
    журнала ядра.

Отзывчивость во время хода (правка по итогам обкатки)

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

  • tools собирался из live(), поэтому мемо раскладки зависело от каждой
    дельты, и вся история пересобиралась по десять раз в секунду;
  • msgs() при каждом чтении возвращал новый массив, а <For> сравнивает
    элементы по ссылке — значит пересоздавались все узлы ленты.

Теперь msgs — стабильное мемо, раскладка зависит от running() (дважды за
ход), а stableBlocks сохраняет объекты блоков по ключу. Замер на мок-стенде
(240 записей журнала, стрим 80 мс/кадр):

было стало
худшая блокировка главного потока 19 600 мс 144 мс
медиана задержки отклика — 4 мс
пересоздано узлов истории 4 171 0

Заодно: один рендерер на стрим и историю (Blocks; Live.tsx удалён), фикс
дублирования хода (журнал во время хода + live с начала), правка сообщения —
на месте, без выброса в композер и без обрезки журнала до подтверждения,
кнопки реплики вынесены из облака (пропал пустой «подбородок»).

Проверять всё это можно без модели: SNENS_MOCK=1 npm run dev поднимает мок
бэкенда поверхности с фикстурой одного хода (?msgs=N — длина истории,
?speed=N — период кадра). Тест посреди хода журнал и стрим не показывают один шаг дважды — регресс на дублирование.

Проверки

  • npx tsc -b — чисто, npx eslint src — 0, npm test — 122 теста,
    npm run build — ок.
  • Живой стенд (ядро :7462, клиент :5176): черновики PUT/GET/DELETE, статистика
    на живой сессии, history посреди хода отдаёт live с дельтами, после хода
    live пуст, truncate обрезал журнал и сессия продолжилась новым ходом.
  • Headless-хром: приветствие с дизером, сессия с лентой, док «Контекст»,
    стена тикетов, слой перетаскивания, превью вставленной картинки, кнопка
    повтора при 500 от ядра, ru↔en на живой странице.

Нужен бэкенд

требует ядра с live/run_started в history и маршрутами /v1/drafts,
/v1/sessions/{id}/stats, /v1/sessions/{id}/truncate — PR
svuvich/snens#8 (surface-web). На старом ядре клиент работает: черновики
падают в localStorage, блок «Итоги сессии» и правка сообщения отключаются.

## Что это Веб-клиент переехал с React 19 на **Solid 2.0** — и в том же заходе закрыты накопившиеся жалобы по интерфейсу. Десктоп-оболочка отдаёт тот же бандл, так что переезд касается и её. ## Почему Solid Лента чата — это десятки узлов, которые обновляются на каждый чанк стрима. В React цена такого обновления пропорциональна размеру поддерева компонента, а не числу реально изменившихся данных: во время хода ререндерится вся лента, и это видно как рывки на длинных сессиях. В Solid обновляется ровно та привязка, которая прочитала изменившийся сигнал — единица работы не компонент, а узел. Побочный выигрыш: нет правил хуков, нет зависимостей в `useEffect`, меньше обвязки на каждый компонент. Инструменты для агентской работы тоже лучше: в пакете лежат скиллы (`node_modules/solid-js/skills/`) с описанием 2.0 и картой диагностических кодов, а `eslint-plugin-solid` пресетом `v2` ловит именно те ошибки, которые в fine-grained реактивности молчат в рантайме — деструктурированный проп, аксессор вместо значения, одноаргументный `createEffect`. ## Переезд - `solid-js@2.0.3`, рендерер `@solidjs/web`, плагин `@solidjs/vite-plugin`. React и `@vitejs/plugin-react` удалены. - Слой данных (`api.ts`, `lenta.ts`, `lib/*`) и CSS от фреймворка не зависели и переехали как есть — миграция не полезла в логику. - Перенесены все `.tsx`: каркас, лента, рельса, док, композер, настройки, дашборд, пейринг, markdown. - Правила переноса — `docs/solid-rules.md`: пропсы не деструктурировать, `<Show>`/`<For>`, двухаргументный `createEffect`, уборка через `return () => …` (в 2.0 `onCleanup` внутри эффекта не работает и молча останавливает реактивность — это была причина вечного «Загрузка…»). ## Жалобы, закрытые в этом же PR - **Лента в стриме и в истории выглядит одинаково.** Шаги рисует один и тот же `Fold`/`Step`; открытая посреди хода сессия больше не теряет начало рассуждения — бэкенд отдаёт события текущего хода. - **Фон приветствия остаётся под сессией** (прозрачность 0.06) и в десять раз медленнее: эффект живёт, но не отвлекает. - **Файлы и картинки** принимаются перетаскиванием в любую точку окна (слой `DropZone` с контуром по краю экрана) и вставкой из буфера в композер; картинки видны превью, а не именем файла. - **Черновики живут на бэкенде поверхности**: начатое на ноутбуке продолжается в десктопе. Черновик новой сессии виден строкой в списке. - **У реплики человека** есть «копировать» и «править» (правка режет журнал и возвращает текст в композер), **у ошибки отправки** — кнопка повтора. - **Работающие сессии пульсируют** в списке. - **Док «Контекст»** показывает итоги сессии: ходы, шаги, вызовы, токены, цену, кеш-хит-рейт и активное время, посчитанные на бэкенде. - **Тикеты — стена карточек** с попапом и мультивыбором; «Разобрать выбранные» кладёт список в черновик новой сессии. - **Два языка**: `src/lib/strings.ts` (409 ключей, ru/en) + `i18n.ts`, переключатель в настройках, тест падает на непереведённой строке. По-русски осознанно остались только тексты, которые уходят модели или разбирают формат журнала ядра. ## Отзывчивость во время хода (правка по итогам обкатки) Стрим перестал блокировать интерфейс. Причин было две, обе из переезда: - `tools` собирался из `live()`, поэтому мемо раскладки зависело от каждой дельты, и вся история пересобиралась по десять раз в секунду; - `msgs()` при каждом чтении возвращал новый массив, а `<For>` сравнивает элементы по ссылке — значит пересоздавались все узлы ленты. Теперь `msgs` — стабильное мемо, раскладка зависит от `running()` (дважды за ход), а `stableBlocks` сохраняет объекты блоков по ключу. Замер на мок-стенде (240 записей журнала, стрим 80 мс/кадр): | | было | стало | |---|---|---| | худшая блокировка главного потока | 19 600 мс | 144 мс | | медиана задержки отклика | — | 4 мс | | пересоздано узлов истории | 4 171 | 0 | Заодно: один рендерер на стрим и историю (`Blocks`; `Live.tsx` удалён), фикс дублирования хода (журнал во время хода + `live` с начала), правка сообщения — на месте, без выброса в композер и без обрезки журнала до подтверждения, кнопки реплики вынесены из облака (пропал пустой «подбородок»). Проверять всё это можно без модели: `SNENS_MOCK=1 npm run dev` поднимает мок бэкенда поверхности с фикстурой одного хода (`?msgs=N` — длина истории, `?speed=N` — период кадра). Тест `посреди хода журнал и стрим не показывают один шаг дважды` — регресс на дублирование. ## Проверки - `npx tsc -b` — чисто, `npx eslint src` — 0, `npm test` — 122 теста, `npm run build` — ок. - Живой стенд (ядро :7462, клиент :5176): черновики PUT/GET/DELETE, статистика на живой сессии, `history` посреди хода отдаёт `live` с дельтами, после хода `live` пуст, `truncate` обрезал журнал и сессия продолжилась новым ходом. - Headless-хром: приветствие с дизером, сессия с лентой, док «Контекст», стена тикетов, слой перетаскивания, превью вставленной картинки, кнопка повтора при 500 от ядра, ru↔en на живой странице. ## Нужен бэкенд требует ядра с `live`/`run_started` в `history` и маршрутами `/v1/drafts`, `/v1/sessions/{id}/stats`, `/v1/sessions/{id}/truncate` — PR svuvich/snens#8 (`surface-web`). На старом ядре клиент работает: черновики падают в localStorage, блок «Итоги сессии» и правка сообщения отключаются.
Клиент переехал с React 19 на Solid 2.0 (solid-js 2.0.3, рендерер
@solidjs/web, плагин @solidjs/vite-plugin). Слой данных (api.ts, lenta.ts,
lib/*) от фреймворка не зависел и переехал как есть. Правила, на которых
ломается механический перенос, — docs/solid-rules.md.

Идиома переезда: хуки-сервисы возвращают аксессоры, подписки через
двухаргументный createEffect, уборка — `return () => …` (в 2.0 onCleanup
внутри эффекта не работает и молча останавливает реактивность).

Вместе с миграцией закрыты накопленные жалобы:

- лента: шаги в стриме и в истории рисуются одним Fold/Step, поэтому
  середина хода, открытая посреди хода, не теряется;
- фон приветствия остаётся под сессией (opacity 0.13) и в десять раз
  медленнее — CALM_SPEED;
- файлы и картинки принимаются перетаскиванием в любую точку окна (слой
  DropZone) и вставкой из буфера в композер, картинки видно превью;
- черновики живут на бэкенде поверхности: сессия продолжается с другого
  устройства, черновик новой сессии виден строкой в рельсе;
- у реплики человека есть «копировать» и «править» (правка режет журнал и
  возвращает текст в композер), у ошибки — кнопка повтора;
- работающие сессии пульсируют в списке;
- док «Контекст» показывает итоги сессии: ходы, шаги, вызовы, токены,
  стоимость, кеш-хит-рейт, активное время;
- тикеты — стена карточек с попапом и мультивыбором, «разобрать
  выбранные» кладёт список в черновик новой сессии;
- интерфейс двуязычный: src/lib/strings.ts (ru/en) + i18n.ts, переключатель
  в настройках, тест ловит непереведённые строки.
- слой перетаскивания: подпись на плотной подложке в волосяной рамке,
  контур по краю экрана один (пунктир и двойная рамка читались как чужой
  элемент);
- фон под сессией: прозрачность 0.06 вместо 0.13 — дизер остаётся, но
  текст ленты больше не спорит с ним;
- «Копировать/Ветвь» переехали в словарь (пара ключей feed.fork*);
- длительность пачки («за 3 мс») больше не приходит из CSS-контента:
  разделитель в разметке, иначе в английском интерфейсе оставалось «за».
Словарь дорос до 409 ключей: переведены настройки (панели конфига,
провайдеры, инстанс), стена тикетов и ревью, пейринг, артефакты, медиа,
схемы mermaid, док подагентов.

Язык в слое `lib/*` и `pair/claim.ts` идёт параметром с дефолтом из
`lib/lang.ts`, а не читается из модуля: эти строки живут в мемо и обязаны
пересчитаться на смену языка, а `lib/lang` — не сигнал Solid. Компоненты
передают `lang()`.

Что осталось по-русски осознанно: текст реплики, который уходит модели
(«Разбери тикеты snens:»), регулярки по формату журнала ядра («Справка из
долгой памяти», «[ответ на артефакт]»), образцы глифов для замера шрифта и
текст ошибки Tauri — он внешний.

Таймер хода перестал держать «с»/«мин» литералами: он в `elapsed()` из
`lib/time.ts`.
Ядро отдаёт виртуальный профиль top-level ключей с именем `(конфиг)` —
на английском интерфейсе это единственная кириллица на панели моделей.
Имя подменяется только для показа (`providerLabel`), запросы идут по
настоящему: `PUT`/`DELETE`/`activate` по имени.

Тест: подпись переводится, а `p.name` остаётся `(конфиг)`.
Три жалобы, у которых одна причина — разные представления одного хода.

**Скорость.** Во время хода интерфейс переставал отвечать: одна задача
главного потока на 19.6 с на истории в сотню записей. Причин было две, обе
свои:

- `tools` собирался из `live()`, поэтому мемо `blocks` зависело от каждой
  дельты стрима — вся история пересобиралась по десять раз в секунду;
- `msgs()` при каждом чтении возвращал НОВЫЙ массив (`[...msgs, ...queued]`),
  а `<For>` в Solid сравнивает элементы по идентичности — значит
  пересоздавались все узлы ленты (4171 мутации DOM за ход).

Теперь `msgs` — стабильное мемо, `blocks` зависит от `running()` (меняется
дважды за ход, а не на каждую дельту), а `stableBlocks` сохраняет объекты
блоков по ключу: `<For>` переиспользует узлы, поэтому живут раскрытая пачка,
прокрутка кода и выделение. Худшая блокировка — 144 мс вместо 19 600.

**Стрим и история выглядели по-разному.** Разметка была своя в `Live.tsx` и
своя в `Feed.tsx`. Теперь живой ход переводится в записи журнала
(`liveMessages`) и раскладывается тем же `buildBlocks` и тем же компонентом
(`Blocks`): расхождение невозможно по построению. `Live.tsx` и мёртвый
`liveSteps` удалены.

**Ход показывался дважды.** Во время хода журнал уже содержит завершённые шаги
этого хода, а `live` присылает его с начала — рисовалось и то, и другое. Пока
идёт ход, из журнала берём только до последней реплики человека
(`trimToLastUser`); после конца хода `live` пуст и журнал показывается целиком.

**Правка сообщения.** Раньше клик по карандашу сразу резал журнал и
выбрасывал текст в композер: передумав, человек оставался в сессии,
отброшенной назад по времени. Теперь правка идёт на месте — облако
превращается в поле, «Отправить заново» режет журнал и отправляет, «Отмена»
(или Esc) не трогает ничего.

**Подбородок.** Кнопки реплики стояли внутри её облака и занимали место даже
скрытыми. Теперь они вне облака и абсолютной плашкой: места в ленте не
занимают, зазор 2 px, наведение на `.turn`.
Живая сессия для проверки интерфейса не годится: она каждый раз разная, а
стрим надо поймать в нужный момент. Поэтому мок: весь `/v1` отдаётся
фикстурой, где ОДИН ход описан один раз и собирается в два представления —
события стрима (`events`) и записи журнала (`messages`).

Включается переменной окружения, не влияет на сборку бандла:
  SNENS_MOCK=1 npm run dev

Параметры адреса:
- `?msgs=N` — повторить ход N раз, чтобы мерить на истории в сотню записей;
- `?speed=N` — период кадра SSE, мс (0 — как можно быстрее);
- `?nostream` — клиентский, статичный снимок без SSE.

Что проверяется без модели: отличие стрима от готового хода, дублирование
лога, правка сообщения (журнал действительно режется), черновики, статистика
сессии. Тесты: совместимость фикстуры с настоящими типами плюс регресс
«посреди хода журнал и стрим не показывают один шаг дважды».
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin solid:solid
git switch solid

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch master
git merge --no-ff solid
git switch solid
git rebase master
git switch master
git merge --ff-only solid
git switch solid
git rebase master
git switch master
git merge --no-ff solid
git switch master
git merge --squash solid
git switch master
git merge --ff-only solid
git switch master
git merge solid
git push origin master
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
svuvich/snens-web!2
No description provided.