Контракт: форматы файлов и кодеки
| Владелец | K «Ядро» (кодеки ядра; реестр meridian-formats по плану
П1.6 — S0, решение № 2 не принято). Кодеки codec-odf,
codec-mwx, codec-ooxml — S3 Write |
| Версия | MOP-шифрование — формат 1; пакет MOP — по
docs/04-file-formats.md; реестр кодеков — 0
(черновик): крейта ещё нет |
| Потребители | S3 Write, S4 Sheets, S2 Hub/брокер (определение формата
ui/meridian-broker/src/detect.rs), S6 PDF и S9 PPTX
(будущие кодеки) |
| Как менять | совместимое добавление — новая версия 0.x в этой шапке и строка в
разделе «Изменения» коммитом владельца; ломающее — сначала запись в
журналы дорожек-потребителей
(docs/sessions/lanes/<id>.md, «Следующей сессии»), их
согласие, затем правка с [касание <владелец>], если
правит не владелец. Схемы — в spec/formats/ (S3), векторы —
spec/formats/vectors/. |
Перенесено из
docs/sessions/CONTRACTS.md(разделы «A → B: формат пакета MOP» и «B → A: шифрование пакетов MOP») 18.10.2026, П0.6.
Пакет MOP
Владелец формата — A; изменения схем отражаются в
spec/formats/ через запрос B (владелец
spec/).
Шифрование
пакетов MOP (kernel/crates/meridian-crypto)
Версия формата: 1 — spec/formats/mop-encryption.md
(нормативно), векторы
spec/formats/vectors/mop-encryption-v1.json. Крейт не знает
о ZIP и модели документа: кодек MOP (A) собирает контейнер из трёх
записей — mimetype =
meridian_crypto::ENCRYPTED_MIME (stored, первая),
package.bin (stored), encryption.xml.
- запись:
meridian_crypto::seal(plain_package: impl Read, package_bin: impl Write, password, &SealOptions::new(inner_mime)) -> Sealed { header, recovery_code };encryption.xml=header.to_xml()(готов после потока — писать послеpackage.bin); - чтение:
EncryptionHeader::from_xml(bytes)?→open(&header, package_bin, plain_out, Unlock::Password(pw))(илиUnlock::RecoveryCode); оболочка может держатьFileKeysизunlock()и читать повторноopen_with_keys(); - смена пароля без перешифровки:
change_password(&header, old, new, &kdf) -> EncryptionHeader; - ошибки —
CryptoError::code()(CRYPTO_WRONG_PASSWORD,CRYPTO_HEADER_TAMPERED,CRYPTO_CORRUPTED, …). Открытый текст пишется вplain_outтолько после проверки тега чанка; при ошибке результат не использовать.
Реестр форматов (план П1.6, черновик)
Сейчас определителей формата три, и каждый в своём месте:
ui/meridian-broker/src/detect.rs, выбор кодека в
kernel/crates/meridian-ffi/src/edit.rs и
render.rs, свойства в meridian-text-model.
План П1.6: трейт
Codec { id, extensions, sniff(&[u8]) -> Confidence, read, write }
и реестр в новом крейте meridian-formats; все три
определителя переходят на общий sniff, кодеки PDF и PPTX
регистрируются здесь же. До появления крейта этот раздел — намерение, а
не обязательство; первая версия контракта выйдет вместе с крейтом.
Изменения
- 18.10.2026 — файл выделен из
CONTRACTS.md, добавлен черновик реестра форматов (П0.6).