MOffice

Контракты между сессиями (архив)

Устарело с 18.10.2026 (П0.6). Действующие контракты — по файлу на интерфейс в docs/contracts/: C ABI — ffi-abi.md, MOP и кодеки — formats.md, реестр и токены — app-registry.md, лицензии — net-transport.md. Ниже — файл в последней редакции (17.10.2026), для истории и ссылок из кода.

Каждая сессия правит только свой раздел. Ломающее изменение — новая версия + запись во «Входящие» другой сессии.

A → B: C ABI ядра (kernel/crates/meridian-ffi, include/meridian.h)

Версия: 0.5 (2026-10-05) — рендер документов и книги Sheets работают; ABI MERIDIAN_ABI_VERSION = 1 (добавления совместимы). v0.3 добавила оглавление, новый документ по локали и pub const MERIDIAN_EMU_PER_POINT в Rust-части. Имена совпадают с shell/src/kernel/meridian_render.h: без заглушки он просто подключает meridian.h.

Дополнение A → B от 2026-10-09: восстановление свойств DOCX

C ABI version1 и format4 (DocxParts) сохранены. У структурно исправного источника с неоднозначными или недопустимыми metadata values появляется envelope version='2' mode='opaque'. Typed values пусты, исходные parts сохраняются целиком. DocumentProperties::is_read_only() отличает recovery; точечная правка отвергается без изменения revision/history/redo. Очистка и валидная whole-source replacement остаются одной Undo-операцией. Обычный импорт и строгий version1 setter не меняют семантику.

MWX recovery использует binding-version='3' для привязки пустого structural m:meta; прежние bindings1/2 читаются по прежним правилам. DOCX/ODT carriers переносят точный version2 envelope. Старые читатели явно отвергают неизвестные версии. UI следует сохранять отказ точечной правки и показывать доступный текст документа, не подставляя выдуманные поля. Контракт, причины и проверки. Свежие Cargo/full14/FFI/C12/full383 кандидата ещё проходят отдельную приёмку.

Дополнение A → B от 2026-10-09: геометрия явных разрывов Write

PageItem::LineMark получает внутреннее Rust-поле flow_height. height остаётся положительной высотой каретки; только пустой курсорный хвост после page break имеет flow_height=0. Настоящие пустые строки и абзацы сохраняют положительную высоту потока. Layout, render и FFI собираются совместно; смешивать старую Rust-библиотеку и новый consumer нельзя.

Публичный C ABI1 и header неизменны. Click/Up/Down используют flow geometry, caret_rect возвращает прежнюю положительную высоту. Текст и настоящая пустая строка имеют приоритет перед виртуальным хвостом на той же координате. Selection не выделяет виртуальный хвост. Конечный обычный line break создаёт настоящую пустую строку с метриками знака абзаца; она владеет позицией EOF. Нижняя рамка остаётся у последней настоящей части абзаца. Горизонтальные линии соединяются с внешними краями имеющихся боковых рамок; ширина текста и прежняя геометрия рамок без боковых линий сохраняются. Алгоритм и проверки.

Дополнение A → B от 2026-10-17: орфография Write (v0.14, дорожка S3, Б6)

Добавления совместимы, MERIDIAN_ABI_VERSION = 1. Объявления — в include/meridian.h.

В Rust-части meridian_layout::TextLine получила поле stops (левые края глифов по байтам строки) и метод span. Проверка правописания — в окне (meridian-spell), ядро даёт только текст, язык и геометрию.

Дополнение A → B от 2026-10-17: оформление абзаца, списки, переносы, примечания (v0.15, S3)

Добавления совместимы, MERIDIAN_ABI_VERSION = 1. Каждая команда — один шаг отмены (meridian-edit).

В meridian-edit: Op::SetAbstractNumbering, Op::SetSettings, Editor::{set_list, change_list_level, restart_list, list_kind, list_level, set_auto_hyphenation, set_comment_text, map_paragraphs}, ListKind.

Дополнение A → B от 2026-10-17: колонтитулы, страница, сноски, регистр, знаки ¶ (v0.16, S3)

Добавления совместимы, MERIDIAN_ABI_VERSION = 1. Каждая команда — один шаг отмены (meridian-edit).

В meridian-edit: Op::{SetHeaderFooter, SetSection, SetFootnote}, Editor::{edit_header_footer, insert_page_field, set_section, set_even_odd, even_odd, insert_footnote, set_case, leave_story, caret_section}, CaseMode.

C → A: открытые запросы окна Sheets (2026-10-05)

C → B: открытые запросы (2026-10-05)

B → A: токены дизайна (spec/design-tokens.json)

Формат W3C DTCG; генерация в QML-синглтон и CSS — у B. A использует только для цветов отрисовки служебных элементов (выделение, курсор) через FFI-параметры.

B → A: API лицензий (kernel/crates/meridian-license)

Features::has(Feature::X) — единственная точка проверки редакции. Ядро (A) не проверяет лицензии само; оболочка (B) передаёт в ядро набор включённых функций при открытии документа (будущий параметр FFI). Файл .mlic v1 (2026-10-04, B5): meridian_license::SignedLicense::decode → verify(&verifier, &TrustedKeys) → LicenseDocument → to_license() для проверок сроков; формат — детерминированный CBOR, подпись Ed25519 над "MOFC-LIC-v1" ‖ payload, ключи подписи по строковому key_id (mo-lic-<8hex>). Выпускает license-service (moffice-api.24oros.ru — стенд с тестовыми ключами).

A → B: формат пакета MOP (docs/04-file-formats.md, spec/formats/)

Владелец формата — A; изменения схем отражаются в spec/formats/ через запрос B (владелец spec/).

B → A: шифрование пакетов 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.