Hub H4: фоновый список недавних и запись профиля
H4 продолжает H1–H3 в codex/hub-content-worker и
относится к модулю H фазы 2 полного плана 0–8. FileRecents
раньше синхронно читал профиль при создании, выполнял
read_dir/metadata при каждом
list() и записывал профиль при закреплении, удалении и
открытии файла. Один кадр вызывал несколько таких списков.
Подтверждённый отрицательный контроль на H3: три задержанных чтения
папки по 800 мс дали 2421,941547 мс до первого headless-кадра против
границы 300 мс.
Реализация
Режим --recents-worker запускается до GUI/broker,
использует общий worker_process.rs с process deadline 3
секунды и прежними CPU/memory/kill/reap guards. UI хранит готовый
снимок, очередь действий и один job in flight. Конструктор,
list, pin, remove,
add, poll, retry и установка Waker не читают и
не записывают файлы. usual_dirs строит пути без
is_dir; наличие и доступность папки проверяет worker.
Отдельный supervisor не делает join в UI, результат будит обычный Waker;
refresh через 30 секунд одноразовый и разоружается после ошибки.
MOHR v1 передаёт ID, native paths, профиль, папки и упорядоченные Add/Pin/Remove с фиксированным временем пользовательского действия. Request/reply ограничены 2 МиБ, путь 64 КиБ, папок 16, действий в очереди 256, записей результата 200. До постановки нового действия UI проверяет, помещается ли весь запрос; превышение не оставляет очередь с несериализуемым job. Неверные версии, ID, counts, flags, paths, trailing bytes и failure с непустым результатом отклоняются. Scanning ограничен 10 000 directory entries, профиль — 2 МиБ, tombstones — 4096. Размер растущего списка удерживается в пределах 200 при сканировании, а не только после обхода.
Worker перечитывает текущий профиль перед каждым commit и применяет действия по порядку. Initial read и более старый ответ не стирают новые намерения: UI накладывает ещё не подтверждённые действия поверх принятого снимка. Повтор Add/Pin/Remove идемпотентен; timestamp Add не меняется при повторе. Профиль без файла сохраняет отдельный ограниченный journal в памяти; для него также действует общий предел 256 действий и byte cap.
Запись защищена отдельным OS lock именно этого профиля: Unix
flock, Windows exclusive sharing с ожиданием sharing
violation внутри child. Lock держится при read/merge/commit и
отпускается перед обходом папок. Temp принадлежит профилю под lock;
retry удаляет остаток прерванного writer, затем create_new,
запись, sync_all, rename и Unix directory sync. Новый
Unix-файл имеет mode 600. Ошибка чтения или повреждённый/слишком большой
профиль не превращаются в пустой профиль и не разрешают его перезапись.
TSV сохраняет прежний формат; пути с разделителями строки/поля или без
корректного UTF-8 отклоняются вместо lossy-записи.
UI показывает сохранение и постоянную ошибку с доступной кнопкой «Повторить». Ошибка записи не скрывается временным сообщением «Открывается», полный статус доступен screen reader, видимая строка сокращается по ширине. Подтверждение старого job не стирает ошибку более позднего отклонённого действия. Ошибки не запускают бесконечный автоматический retry; следующее действие или кнопка повторяют сохранённые намерения.
Timeout после rename может означать, что commit уже состоялся, но
подтверждение не получено. UI сохраняет pending и прямо сообщает об
отсутствии подтверждения; retry повторяет идемпотентные действия.
Закрытие приложения до подтверждения не обещает, что pending сохранены:
атомарная запись защищает прежний или новый профиль, а не принудительное
завершение ещё не начатых действий. Документы пользователя
FileRecents не изменяет.
Проверки
Полный affected gate: cargo fmt --all --check,
cargo clippy --locked --offline -p meridian-hub --all-targets -- -D warnings,
cargo test --locked --offline -p meridian-hub -- --nocapture.
Mac и Linux выполняются независимо; sources/logs/worker binary связаны с
manifest. Проверки поиска и preview H1–H3 повторены из-за нового пути
обновления списка.
Новые реальные worker tests проверяют действия до initial reply, порядок add/pin/remove, durable reopen и tombstones, два одновременно пишущих источника, Unix mode 600, отказ настоящего atomic commit с сохранением прежнего профиля, исправление причины и retry той же очереди. Проверены oversized/повреждённый профиль без перезаписи, invalid TSV path, byte-limit rejection без застрявшей очереди, memory-only source, missing executable без синхронного fallback, постоянная accessibility-ошибка и нажатие кнопки retry в headless-окне.
На Unix настоящий FIFO блокирует чтение профиля: постановка <100
мс, deadline, wake и отсутствие повторных idle wakes, замена FIFO
здоровым профилем и успешный retry. Linux preload блокирует настоящий
opendir: первый кадр <300 мс, 4-секундный stall
ограничен 500-мс deadline, PID завершён, следующий explicit retry
возвращает настоящий CSV. UI fixture повторяет задержку так же, как
baseline; once-marker используется только для lifecycle recovery. Два
drivers проверяют helper под preload; третья строка helper без fixture
возвращается без проверки.
Existing UI tests теперь явно ждут snapshot/commit только в QA;
нативное окно не вызывает wait_for_recents. Recovery test
проверяет освобождение abandoned lease в пределах секунды, запрещая
показ live copy при каждой проверке: параллельный fork до exec может
временно унаследовать descriptor. Модель recovery и её production-код не
изменены. Все тестовые отказы сохранены в квитанции, после исправлений
выполнен полный gate нового источника.
Принято и открыто
Окончательный Mac gate — 87 Rust tests, fmt/Clippy PASS; Linux — 96 Rust tests, fmt/Clippy PASS. Наборы перекрываются и не складываются в 183 уникальные проверки. Три Python orchestration tests PASS. Квитанция H4 содержит exact source/log hashes, отдельные failed/superseded runs и пределы доказательства.
Sagar использовал существующую shared compute queue и policy: 5
slots, 2 CPU, 8g memory, 2 jobs, shares 512. Compilation/tests не
держали activation lock. Терминальные собственные caches
переиспользовались последовательно; рабочее приложение пользователя и
его local-preview-build не менялись. Новые зависимости,
core/platform changes и C ABI отсутствуют.
На срезе H4 закрыт FileRecents/profile/scan slice; весь H и остальные
фазы оставались открытыми. Собственные recent RPC/mutations/metadata
BrokerRecents на этом источнике ещё синхронны. Они вынесены
отдельно в H5, с новой
source-scoped квитанцией; результат H5 не переписывает исторический H4
gate. Startup, Launcher/current-documents RPC,
recovery/folder/dictionaries и остальные пути полного окна H4 не
принимались.
Windows sharing-lock/Job runtime и packaged/native GUI не проверены здесь. macOS cargo/headless не повышает physical GUI acceptance. Large/network corpora и реальные кадры/input latency требуют отдельного gate. При scan/profile limits или I/O failure UI сохраняет последний принятый снимок; initial failure может оставить список пустым с явной ошибкой, полнота частично просмотренной папки не обещается. Ни desktop product release, ни физические QA-строки этим срезом не объявляются.