Hub H7b1: обзор папок вне UI
H7b1 продолжает H1–H7a в изолированной ветке
codex/hub-content-worker, задачу H фазы 2 полного плана
0–8. Чтение каталога и metadata больше не выполняются при рисовании,
поиске, выборе строки или открытии контекстного меню. Hub получает
ограниченный снимок из отдельного процесса и остаётся доступным при
медленном диске.
Поведение страницы
При входе в «Папку» начинается загрузка выбранного каталога. Сначала
показываются подпапки, затем поддерживаемые офисные файлы; скрытые имена
. и ~$ исключаются. Поиск фильтрует готовый
снимок в памяти. Enter, двойной щелчок и меню используют сохранённый вид
строки: каталог Материалы.csv открывается как каталог без
дополнительного stat в UI. Метаданные на экране относятся
ко времени получения снимка.
«Обновить» запускает новое чтение. При ошибке обновления того же каталога Hub сохраняет последний успешный список и показывает ошибку с «Повторить». Переход в другой каталог убирает строки прежнего каталога. Недоступный каталог не выдаётся за пустой; превышение лимита не публикует частичный список. Ответ предыдущей загрузки не заменяет более новый выбор.
Путь и длинные имена сокращаются посередине в пределах строки, сохраняя конец пути и расширение. Accessibility labels содержат полный путь и имя. Статусы загрузки, ошибки и кнопки доступны для screen reader. Прежний нижний счётчик относится к Recents даже на странице Folder; уточнение этого общего статуса оставлено следующему срезу.
Автоматического filesystem watcher или TTL обновления здесь нет. Обновление выполняется при входе, повторном входе и явной команде. Изменения каталога после снимка могут сделать выбранный файл недоступным к моменту открытия; результат операции сообщает существующий Launcher.
Worker и ограничения
--folder-worker dispatch выполняется до GUI и
подключения брокера. folder_io читает каталог только в
worker или у явно синхронного legacy caller. Публичный
read_folder сохранён для совместимости; production Folder
UI его не вызывает. Constructor и выбор пути не выполняют filesystem I/O
или поиск исполняемого файла.
MOHF v1 передаёт id, outcome и строки с native path, видом, временем и размером. Unix сохраняет raw bytes, Windows — UTF-16. Decoder проверяет magic/version, id, длины, trailing bytes, outcome, допустимый вид строки, дубли, непосредственного родителя и нулевой размер каталога. Повреждённый ответ остаётся видимой ошибкой без синхронного fallback.
Лимиты: 4096 строк, 50 000 просмотренных directory entries, 64 КиБ на native path, 2 МиБ на frame. Сортировка directory-first, затем lower-case имя и native path как стабильный tie-break для lossy имён. Metadata следует обычным symlink; исчезнувшая во время обхода строка пропускается, другие ошибки доступа прерывают весь снимок. Special files не включаются. Bounded read ограничивает объём, а process deadline ограничивает время зависшего syscall.
Supervisor использует каналы 1/1, одну flight и последнее намерение выбора каталога. Общий guarded process exchange применяет прежние ограничения child CPU/RSS и process group/job; обычный deadline — 3 секунды. Навигация, refresh, уход со страницы и Drop запрашивают отмену. UI не ждёт поток через join; owned child завершается и reap выполняется вне кадра. Старый reply потребляется, но его generation не публикуется; после этого ставится последнее намерение.
Reply и завершение supervisor будят native event loop. Ошибка чтения или child допускает явный retry. Остановленный supervisor даёт отдельный статус с требованием перезапуска Hub. Этот read-only срез не меняет содержимое файлов, broker protocol, core, C ABI или зависимости. Комментарии реализации и QA — RU/EN.
Проверки и источники
Окончательный frozen кандидат — 2412 файлов,
manifest
999ba75c417885f8559dd6c2cd8cce50d4fa74a6284a7f3dc7b89b1ec18796cb,
база
13887ea342242879f3be228ed41f51404a6194dd.
Оба product gate должны проверять эти bytes, а последующие правки
документации проверяются отдельно. Точные команды, hashes, counts и
сохранённые отказы находятся в квитанции H7b1.
Native Mac: 153 Rust PASS / 0 FAIL, fmt, strict Clippy всех Hub targets и fresh normal Hub build; все 23 Cargo targets, doc tests, 27 команд. Linux: 176 Rust PASS / 0 FAIL, те же fmt/strict Clippy/normal build и полный Hub cargo test. QA orchestration — 8 Python PASS. Counts разных платформ перекрываются и включают helper targets; это не число уникальных пользовательских сценариев.
Integration cases проверяют реальный snapshot, сортировку и фильтр после удаления файлов без повторного чтения; captured kind меню; persistent error/retry; сохранение прежнего снимка при failed refresh; превышение 4096 строк без частичной публикации; waker/private Debug; rapid navigation и stale reply; уход/возврат; быстрый Drop и actual owned PID cleanup; Unicode paths и directory symlinks; corrupt reply. Linux дополнительно проверяет настоящий non-UTF8 filename и сохранность native path при запуске. Unix codec unit проверяет raw bytes request/reply независимо от способности конкретной файловой системы создать такое имя.
Linux preload задерживает настоящий opendir или
metadata syscall только для указанного synthetic
каталога/файла. В UI-only режиме задержка 800 мс
действует на UI PID, а worker наследует fixture env без задержки. Старый
H7a и compatible helper сохраняют тот же input, C shim, measurement
boundary и порог 300 мс:
- Folder /
opendir: старый 1609,570214 мс FAIL → окончательный H7b1 25,630686 мс PASS. В старом кадре было два чтения по 800 мс. - Folder / metadata: старый 1614,880092 мс FAIL → окончательный H7b1 13,568459 мс PASS при том же пороге.
В отдельном all-process режиме первый qualifying syscall child
задержан на 4 секунды, injected deadline — 1200
мс. Проверяются timeout, отсутствие живого owned PID,
неизменные исходные bytes и успешный явный retry. Кадр в этих сценариях
занял 9,997921 / 9,5368 мс (opendir /
metadata). Это отдельный сценарий, его время кадра не заменяет UI-only
comparison. Замеры единичные, headless с bundled fonts: они не принимают
p95, native input/compositor latency, сетевые диски или cold packaged
startup.
Private headless visual probe с реальным normal Mac worker проверяет четыре состояния в 900×600@2: loading/light, готовые три строки/light, failed refresh с сохранёнными тремя строками/light, восстановление после retry с новым списком/dark. Все четыре PNG просмотрены, path/name elision и accessibility labels проверены, исходные bytes файлов сохранены. Это raster/AX проверка того же UI, без повышения physical GUI rows и без открытия пользовательского профиля.
Сохранённые отказы и следующий срез
Ранний Mac focused запуск дал 9 PASS / 1 FAIL: APFS отклонила создание non-UTF8 имени с OS92 до запуска worker. Проверки разделены на Unix raw-byte IPC и Linux filesystem case; Unicode/symlink case остаётся на обеих Unix платформах. Waker assertion теперь ждёт фактическое уведомление в bounded интервале: доступность reply и вызов callback не являются одной атомарной операцией. Полные gates повторены после этих правок.
Две ранние native сборки остановились в linker с ENOSPC; тесты в них не выполнялись. Сохранены logs и relevant ранний source/test executable; перед удалением только собственных завершённых derived artifacts проверены backups SHA и отсутствие использования. Пользовательское приложение, preview, соседние caches и исходники не менялись. Первый visual probe прошёл assertions, но ручная проверка выявила выход пути за правую границу; он сохранён как visual FAIL. После elision создан новый frozen кандидат и повторены gates/visual probe.
Sagar compilation/CI используют shared resource queue без activation lock. Publication отдельной source branch не означает main integration, desktop deployment или packaged acceptance. Композиция с актуальной общей базой требует affected checks.
Дальше H7b2 — Recovery scan/delete, с сохранением window lease и координации удаления; H7b3 — dictionaries load/save, общий lock/merge с writers Sheets. Общие file dialogs и platform fonts требуют handoff владельцу B. Durable offline journal, broker ACK/idempotency/subscription recovery, bounded startup, Mac/Windows packages, большие/сетевые входы и input/compositor measurements остаются открытыми. H7b1 не закрывает всю H и остальные направления фаз 0–8.