MOffice

Hub H5: recent RPC и проверки файлов вне UI

H5 продолжает H1–H4 в codex/hub-content-worker, модуль H фазы 2 полного плана 0–8. В H4 фоновым был FileRecents, но BrokerRecents синхронно запрашивал историю при создании/событиях/изменениях и выполнял metadata при каждом list(). Отрицательный контроль на H4 дал 832,802011 мс до первого headless-кадра при задержанном RecentList и 2419,266167 мс при трёх проверках файла по 800 мс. Граница обоих контролей — 300 мс.

Реализация и контракт

Новый self-hosted режим --broker-recents-worker запускается до GUI и startup-подключения. Supervisor использует общий process exchange с deadline 3 секунды, CPU/memory guards, kill/reap и приватными stdin/stdout pipes. RPC, чтение nonce, подключение к socket/pipe и metadata находятся в child; UI не ждёт RPC, не читает профиль и не делает stat при constructor/list/pin/remove/add/poll/retry. Startup и Launcher относятся к следующему срезу H6.

Worker подключается к существующему брокеру явно переданного профиля через обычную аутентификацию. Он не запускает сервис, не генерирует новый nonce, не меняет аккаунты. BrokerRecents::new получает профиль отдельным аргументом: внутренний Rust-конструктор изменён с трёх аргументов на четыре, все вызовы в репозитории обновлены. standard передаёт тот же профиль, который использует startup-клиент. Общий broker protocol v2, C ABI и зависимости не изменены; код зоны B не редактировался.

MOHB v1 передаёт job ID, native profile path, упорядоченные Add/Pin/Remove и готовые строки истории. Пределы: frame 2 МиБ, путь 64 КиБ, 256 действий, 200 строк, одна flight, очередь 1 и replies 2. UI проверяет полный размер запроса до принятия действия; невалидные UTF-8/TSV paths отклоняются, чтобы брокер не заменил разделители пробелами. Ответ проверяет ID, counts, flags, app identity, дубликаты, truncation/trailing bytes и размер. App identity передаётся явно: известное брокеру приложение сохраняется даже при неизвестном расширении файла. При oversized snapshot worker возвращает подтверждённый префикс действий с ошибкой Limit.

UI объединяет два независимых snapshot: брокерный и FileRecents для обычных папок. Отказ одного источника не скрывает результаты другого. Намерения накладываются после объединения, поэтому папка не возвращает строку с pending Remove. Закрепление нового файла сначала регистрирует его через touch внутри child; размер/exists известного файла берутся из принятого snapshot. Удаление принимается только если локальную отметку для сканируемого формата удалось поставить в ограниченную очередь.

События RecentChanged обрабатываются перед replies, до 256 событий за кадр, с одним invalidation на порцию. Более старый snapshot не заменяет cache после нового события; подтверждённые действия старого job остаются подтверждёнными и не теряют более поздние намерения. Успех вооружает одноразовый 30-секундный refresh. Ошибка сохраняет прежний snapshot, pending и доступный постоянный статус с кнопкой retry; не запускает бесконечные запросы. Новое действие после отказа не повторяет неизвестный RPC автоматически.

Подтверждения и граница сохранности

Ответ worker содержит только префикс действий, для которых брокер вернул успех. При ошибке следующего RPC подтверждённый префикс удаляется из очереди; оставшиеся намерения сохраняются. Если все mutations подтверждены, но snapshot не прочитан, retry повторяет только чтение. Timeout/разрыв после применения mutation не доказывает, что операция не применена: потерянный ответ может потребовать явного повтора.

Broker v2 не имеет idempotency key. Повтор неизвестного RecentTouch может повторно увеличить count и время открытия; реальный IPC-тест подтверждает count 2 после потери первого ответа. H5 обещает отсутствие автоматического replay в заблокированном состоянии и не обещает exactly-once.

Найдена отдельная проблема RecentStore: запись может завершиться ошибкой после изменения памяти. Реальный серверный тест блокирует .tsv.tmp директорией, получает ошибку pin, подтверждает различие memory/disk, сохранение pending/ошибки в Hub и успешный durable pin после исправления причины и явного retry. Standalone-диагностика Remove воспроизвела другой исход: после ошибочной записи строка исчезла из памяти, повтор вернул Ok(false) без сохранения, а reopen с диска вернул старую строку. Диагностика и hashes записаны в квитанции; запрос на исправление передан в «Входящие» B-log. H5 не сертифицирует durable broker ACK и не меняет владельца broker store.

Закрытие Hub до подтверждения не гарантирует отправку/сохранение pending. Upstream broker event receiver остаётся unbounded; H5 ограничивает работу UI за кадр, а не память чужого receiver. После разрыва старой подписки worker может переподключиться при retry/refresh; восстановление подписки startup-клиента проверяется отдельно.

Проверки и результат

Полный affected gate: cargo fmt --all --check, strict Clippy -p meridian-hub --all-targets, полный locked/offline Hub test suite. Последний источник: Linux 113 Rust PASS, native macOS 101 PASS, fmt/Clippy PASS, Python orchestration 3 PASS. Наборы перекрываются; числа Cargo включают helper-тесты, возвращающиеся без fixture, и не складываются в уникальные сценарии. Квитанция H5 связывает source/log/image/helper/binary hashes, исходные отказы и границы проверки.

Фактический первый headless-кадр в RPC-контроле: Linux 16,43634 мс вместо 832,802011 мс; macOS также прошёл 300-мс границу. Linux настоящий stat под preload прошёл тот же порог. Отдельные 4-секундные RPC/stat stalls ограничены injected deadline 1500 мс; проверен фактический authenticated worker PID, его завершение и здоровый retry. Это контролируемые first-frame measurements, а не p95 input/compositor или физическая GUI-приёмка.

Проверены порядок действий до initial reply, pin/remove/add, другое окно, неизвестное расширение с broker app identity, старый snapshot после нового события, partial ACK без повторения подтверждённого touch, потеря ответа, независимые broker/folder failures, private Debug, отказ nonce без его замены, queue overflow и event backlog, настоящий broker write failure и explicit recovery. Поиск, preview, H4 profile persistence и существующие UI сценарии повторены в полном gate; тесты теперь ждут async acknowledgment только в headless QA.

Первый Mac focused run не подтвердил старт fixture при 500-мс бюджете: PID был 0. Увеличен injected бюджет до 1500 мс при прежнем 4-секундном stall; проверка фактического PID обязательна. Первый full Mac gate остановился на unused QA helper, исправлен actual-read handshake. Первый Linux full gate поймал неверное ожидание пустого cache до завершения нового чтения; регрессия теперь начинает с пустого принятого cache, задерживает snapshot A, подтверждает доставку следующего события callback-ом actual reader и запрещает появление A в каждом кадре. Полные gates нового источника выполнены повторно, отказы сохранены.

Дальше

H5 закрывает recent RPC/mutations/metadata slice. H6 — startup connect/spawn и Launcher/new/open/current-documents RPC; затем остальные filesystem-пути полного окна, packaged/native Mac/Windows, large/network inputs и frame/input latency. Broker durability/idempotency переданы владельцу B и остаются отдельной обязательной проверкой.

Sagar использовал прежнюю shared compute policy без activation lock. Negative/fixed jobs имели отдельные собственные caches; cache fixed повторно использовался только после terminal receipt. Источники frozen, все 2386 файлов совпали до/после окончательного Linux gate и с native manifest. Рабочий Hub пользователя и его build cache сохранены. H и остальные задачи фаз 0–8 остаются открытыми; source publication не объявляется desktop deployment или принятием физических QA-строк.