Hub: обнаружение и метаданные внешних шаблонов
На dd78d7be принят отдельный CatalogView и
native worker --template-catalog-worker. Это следующий срез
после фоновой основы Hub079. Карточки существующей галереи ещё
используют встроенный список; новый snapshot API пока не подключён к
реальному экрану, предпросмотру и запуску Write.
Контракт
Вызывающая сторона передаёт до восьми абсолютных непересекающихся
Root: packaged, user или organization.
Root::user(profile) только вычисляет
profile/templates; constructor не читает профиль и не
создаёт каталог. Отсутствующая пользовательская библиотека даёт пустой
snapshot. Недоступная корпоративная папка имеет именованный
Issue, а не исчезает из результатов. Рекурсивное чтение
вложенных папок имеет явные границы.
Identity записи — native path вместе с источником. Название, автор, язык, категория, описание и исходная строка даты читаются из metadata; при отсутствии названия используется имя файла, категория — «Общие». Неизвестные даты, популярность и количество применений не выдумываются. Фильтры приложения, источника, категории, языка, поиск и сортировка по имени/времени работают только с готовым snapshot, без disk IO.
Формат определяется содержимым ZIP: 14 MIME вариантов DOCX/DOTX,
ODT/OTT, XLSX/XLTX, ODS/OTS, PPTX/POTX, ODP/OTP и MWX/MWT. Изменение
расширения не меняет результат. XML читается собственным strict parser:
namespace aliases, UTF-16/BOM и Unicode сохраняются; повреждённый XML и
DTD отвергаются. Проверяются duplicate ZIP names, заявленный main part
OOXML, наличие content part и ODF manifest. Metadata scanner не
выполняет полный document decoder, проверку всех content parts или SHA
manifests MOP. Native MWT MIME здесь не означает приёмку Normal.mwt,
AutoText, scripts или полной семантики шаблонов. Native Sheets/Slides
MIME ещё даёт Unsupported; их constructor остаётся
отдельной задачей.
Ограничения и отказ
- 256 записей, 256 issues, 8192 просмотренных directory entries, глубина 8;
- file input до 32 МиБ, каждая metadata XML part до 256 КиБ;
- поле до 2048 UTF-8 bytes, native path до 64 КиБ, IPC frame до 2 МиБ;
- штатный worker имеет deadline 3 секунды и общие process/CPU/memory guards.
Превышение общего row/scan/frame bound не публикует молча усечённый
список: оно сохраняет прежний snapshot и явную ошибку до
пользовательского retry. Локальный file/metadata/depth отказ
записывается в именованный Issue. Шифрованные ZIP entries,
ODF encryption-data и native encrypted MIME дают отдельный
Encrypted; парольный UX этим срезом не добавлен.
На macOS/Linux child file открывается через fd проверенного каталога,
openat(O_NOFOLLOW|O_NONBLOCK|O_CLOEXEC). Замена пути
каталога не перенаправляет чтение. Символические ссылки не перечисляются
как шаблоны; изменения identity, размера и mtime до/после чтения
отвергаются. Это metadata snapshot, не immutable content handle для
будущего запуска: повторная проверка выбранного источника при создании
документа ещё нужна. Windows anchored-open пока fail-closed; нативная
Windows реализация и её приёмка остаются открытыми.
Supervisor использует существующий bounded process exchange. Смена
источников, выход и Drop отменяют старый flight без join в вызывающем
потоке. Устаревший ответ не заменяет новый snapshot; child group
завершается и reap выполняется в supervisor. Неисправный ответ не
включает синхронное чтение как fallback. Debug CatalogView
показывает только счётчики и состояние, без private paths. Критические
решения отмечены комментариями в коде.
Фактическая приёмка
217 PASS / 0 FAIL / 0 ignored, native macOS/aarch64,
exact source dd78d7be653eff409b9b371e48af449a5950379d:
- все 211 Hub tests, включая 11 новых actual subprocess tests и 4 unit controls;
- 6 Write external-template regressions;
- normal Hub build, all-targets check, строгий Clippy
-D warnings, fmt PASS.
Новые controls проверяют реальные ZIP bytes и normal worker, UTF-16 metadata, MIME при неверном расширении, combined snapshot filters после удаления источников, именованные corrupt/encrypted/unsupported/limit issues, отсутствие неявного mkdir, row-limit с сохранением предыдущего snapshot и явным retry, symlink refusal, wake/debug, timeout, corrupt reply, latest-intent cancellation и actual child death после выхода/Drop. Отдельный fd control подменяет каталог ссылкой на foreign fixture и всё равно читает только исходный owned file. IPC controls отвергают truncation/tail, overlapping/relative/parent roots, foreign/duplicate rows и oversized/control-character fields; raw Unix identity проверена без создания несовместимого с APFS имени.
Независимый audit перепроверил все 2674 source files, шесть логов, 29 реально запущенных test executables и normal Hub, отсутствие worker/gate PIDs и own compiled children. Все 2666 прежних файлов вне четырёх изменённых существующих путей сохранены. Cargo.lock только добавляет две уже существующие внутренние зависимости Hub; остальные package entries неизменны. Предыдущие 567/188/104 не прибавляются к этому результату.
Audit:
target/odt-field-context-v1/template-catalog-native-dd78d7be/independent-audit.json.
SHA256:
ca1661b21d2381e4ee508ab1e52df4870477d2ff897049790ee51016f0f246a2.
Машинная
квитанция.
Следующая композиция
Подключить snapshot к real App/main с явным profile/org configuration, сохранить код durable-словаря соседнего владельца, добавить карточки/фильтры, metadata/preview и создание новой Write копии с повторной проверкой источника. Favorites/popularity, full Normal/native templates, внешний Sheets constructor, Linux/Windows/package/physical UI и common-core candidate имеют отдельные открытые gates. Full A–I ACTIVE; product release этим срезом не заявлен.