Hub H6a: очередь команд запуска вне UI
H6a продолжает H1–H5 в codex/hub-content-worker, задачу
H фазы 2 общего плана 0–8. В H5 история обновлялась в фоне, но Launcher
выполнял Open, New, DocumentList и FocusDocument синхронно. Контроль на
прежней реализации с задержкой настоящего RPC на 800 мс дал 808–810 мс
на команду и следующий headless-кадр. H6a переносит эти команды в
последовательную фоновую очередь. Startup-подключение до первого кадра
относится к H6b и пока остаётся синхронным.
Реализация
AsyncLauncher создаёт backend в собственном потоке.
Поэтому Rc<Client> и другие backend без требования
Send не передаются между потоками. UI передаёт только ограниченные
задания, читает готовые ответы и хранит последний принятый список
текущих документов. Конструктор очереди, enqueue, poll, установка Waker
и закрытие не выполняют RPC, поиск бинарника или запуск процесса в
UI.
Открытие, создание из шаблона, reveal и переход к текущему документу
идут последовательно. Прямой ProcessLauncher сохраняет
прежнее разрешение приложения только внутри пакета; поиск и
Command::spawn выполняются в actor. Backend
BrokerLauncher::for_profile лениво подключается к явно
переданному профилю. После RPC-ошибки он сбрасывает соединение;
следующая команда или явный повтор могут подключиться заново. Само
переподключение не повторяет неизвестную команду. Общий broker protocol
v2, C ABI, зависимости и код зоны B не изменены.
Пределы принятых данных: 32 неподтверждённых или неуспешных пользовательских действия, канал заданий/ответов 32, не более одного запроса DocumentList, путь 64 КиБ, ID и template 4 КиБ, snapshot 1000 документов и 2 МиБ текста. Ошибка backend обрезается до 4 КиБ с многоточием. Предел snapshot применяется после ответа обычного broker client; это не лимит всего процесса или пиковой памяти декодирования. Debug очереди выводит только счётчики, Debug события — имя варианта.
Обновление «Текущих» объединяет повторные запросы и возвращает прежний snapshot, пока идёт чтение. После ответа одноразовый таймер через 500 мс будит окно, только пока страница активна. Ошибка сохраняет принятый список, блокирует автоматическое повторение RPC и отображает постоянный статус. Явный retry снимает блокировку. Поколение пользовательского намерения не позволяет ответу старого DocumentList заменить более новый UI intent.
Подтверждения и ошибки
Успешный enqueue означает принятие в очередь.
LauncherEvent::Opened появляется после успешного ответа
backend. Только тогда App добавляет файл в историю и показывает
«Открывается». Для брокера это подтверждение Forwarded/Spawned, для
прямого запуска — успех Command::spawn; H6a не утверждает,
что окно уже показано или документ успешно загружен. Новый документ без
пути не добавляется в историю файлов.
Успех более позднего задания не скрывает отказ предыдущего. Неподтверждённые действия остаются в ограниченном списке, постоянная ошибка доступна screen reader, кнопка называется «Повторить неподтверждённые команды». При одновременной ошибке истории и Launcher статус содержит обе ошибки; существующий retry обращается к обоим источникам. Повторяется только список неуспешных действий, в прежнем порядке.
Разрыв после применения Open/New/Focus не доказывает, что команда не выполнена. Реальный IPC-тест подтверждает один применённый запрос до потери ответа и второй после явного повтора. Автоматического replay нет; exactly-once и отсутствие дубликата окна после ручного retry не обещаются. Проблема durable broker ACK/idempotency из H5 остаётся отдельным запросом владельцу B.
При завершении или panic actor UI получает постоянную ошибку, снимает busy и сохраняет неподтверждённые действия. Такой поток не восстанавливается прежним FnOnce factory: статус требует перезапуска Hub. При закрытии UI устанавливает stop без join; поток проверяет его перед следующим заданием. Уже начатый RPC может примениться после закрытия окна.
Почему используется поток
Codec workers H1–H5 имеют CPU/memory guards и уничтожаемую process group или Windows Job. Запуск долгоживущего приложения внутри такого worker передал бы ему ограничения и риск завершения вместе с worker. H6a выполняет прямой запуск в обычном потоке и сохраняет независимую жизнь приложения. Unix-тест использует настоящий production resolver и исполняемый файл своего временного пакета: получает PID, закрывает очередь и проверяет, что процесс ещё работает, затем завершает только свой тестовый процесс.
Фоновая очередь не имеет forced deadline 3 секунды. Обычный broker client ждёт ответ до 10 секунд; connect, write и filesystem/spawn могут задержать единственный actor дольше. UI продолжает работать, но следующие команды ждут. Закрытие не ждёт actor и не отменяет уже отправленную операцию. Это отдельная граница H6a, а не доказательство bounded recovery для всех системных вызовов.
Проверки
Окончательный Linux affected gate: fmt, strict Clippy для всех Hub targets и полный locked/offline Hub test suite — 128 Rust PASS. Native macOS: те же fmt/Clippy и 116 Rust PASS. Числа включают общие/helper сценарии и Linux-only targets с нулём тестов на Mac; они не складываются в уникальные проверки. Python-проверки QA-инструментов — 8 PASS. Квитанция H6a содержит manifest, source/log/image/helper/binary hashes и исходные отказы.
Сравнение одного управляемого command + headless frame, после создания окна:
- Open: Linux 809,79 → 6,65 мс; новый Mac 6,85 мс.
- New: Linux 810,07 → 24,22 мс; новый Mac 6,72 мс.
- «Текущие»: Linux 809,17 → 10,77 мс; новый Mac 8,21 мс.
- Focus: Linux 808,17 → 8,38 мс; новый Mac 6,72 мс.
Задержка actual RPC во всех четырёх контролях — 800 мс, граница — 300 мс. Отрицательная реализация использует H5 и тот же QA-сценарий с синхронным backend. Это не cold startup, p95 input/compositor или физическая GUI-приёмка.
11 actor/IPC сценариев проверяют порядок и фактический ACK, запись истории только после ответа, сохранение ранней ошибки после позднего успеха и доступный retry, объединение DocumentList, сохранение snapshot при отказе, одноразовый Wake и его отключение, stale reply, oversized snapshot, переполнение очереди без потери принятых действий, потерю ответа/reconnect, закрытие во время factory, panic и жизнь настоящего дочернего процесса. Четыре отдельные responsiveness проверки создают реальные delayed RPC. Существующий тест настоящего broker server подтверждает forwarding Open/New через новую очередь. Поиск, preview, profile persistence, UI и остальные Hub сценарии повторены в полном gate.
Полный Mac gate при малом свободном месте
Первые два полных Mac-прогона остановились на ENOSPC до выполнения полного набора тестов. Попытка удалять rmeta после Clippy заставляла Cargo пересобирать зависимости; этот шаг удалён. Проверенный H5-бинарник сохранён на Sagar, квитанции оставлены. Прерванный полный архив старого кэша не считается резервной копией.
Пересоздан только собственный производный кэш через APFS clone
пользовательского preview-cache: разные inode, отсутствие symlink,
исходный cache только читался. Существующие приложение, пакет и данные
пользователя не менялись. Флаг
run_native_product.py --sequential-tests перечисляет все 17
targets из Cargo metadata, строит свежий self-hosted Hub, выполняет
каждую цель и doc tests, затем удаляет только уже исполненный test
binary своего cache. rmeta/rlib и production worker сохраняются.
Неизвестный target kind завершает gate ошибкой. Python-тесты отдельно
проверяют полноту и отказ от удаления peer path, symlink, библиотеки и
production worker. Итоговый Mac gate выполнил 21 команду; исходник не
изменился.
Готовность и следующие шаги
Все 2392 файла frozen Linux-источника совпали до/после gate и с native manifest. После добавления описания отдельно сверены все 1984 файла вне docs/Markdown. Sagar использовал прежние shared compute queue/policy, без activation lock; negative/fixed sources и caches раздельны. Старый cache fixed использован после terminal receipt H5. Оба systemd jobs завершены.
H6a — проверенный срез Launcher, готовый к публикации в своей исходной ветке. Это не desktop deployment и не повышение физических QA-строк. H6b должен убрать connect/spawn до первого кадра, сохранить намерения при переходе от loading/fallback к брокеру и проверить задержанный или недоступный startup. Затем остаются остальные filesystem paths UI, полный packaged/native Mac/Windows, большие и сетевые файлы, input/compositor latency и остальные задачи фаз 0–8. H и весь план не объявляются завершёнными.