MOffice

Протокол работы сессий MOffice

Действует с 15.10.2026 (план v2, plan/report-20261015/), с 18.10.2026 — с фазой П0 «Разметка» (plan/parallel-20261018/, раздел 6): машинная карта владения, журналы дорожек, очередь слияния, CI по затронутому, контракты по интерфейсам. Ведёт дорожка S5 «Качество и процесс». Это единственный действующий документ о том, как сессии делят работу; прежние планы — в docs/archive/.

Дорожки и файлы

Два писателя никогда не правят одни файлы. Хозяин каждого пути — в машинной карте docs/sessions/OWNERS.toml (побеждает последнее совпавшее правило, как в CODEOWNERS; just owners <путь> — чей путь). Проверка scripts/check_owners.py идёт в just ci-fast и красит ветку: у каждого файла есть хозяин (0 «ничьих»), а ветка claude/<префикс>-… дорожки правит только свои пути, совместные (also) и открытые (open: квитанции, Cargo.lock). Чужой файл — только по согласованию: коммит с пометкой [касание S<n>] (или [касание K], несколько — [касание S2, S4]) в заголовке и строкой в описании, зачем; владелец дорожки ребейзится и решает конфликт. Ветки с именем не по дорожке (пул рабочих копий) проверка пропускает с предупреждением; сводные claude/integ-… и ветки робота queue/… не проверяются. Новая дорожка — just lane-new <id> "<имя>" "<globs>" (строка в карте, журнал и бриф сессии), а не ручная правка.

Дорожка Префиксы веток Свои файлы (кратко; точно — OWNERS.toml)
S1 Выпуск s1, release packaging/, scripts/package_*, deploy/ (кроме deploy/ci-runner/, deploy/status-center/, deploy/api-backup/), meridian-net, до S7 — meridian-license, services/
S2 Hub s2, hub ui/meridian-hub, ui/meridian-ui, ui/meridian-broker (передача meridian-ui дорожке S0 — решение владельца № 2)
S3 Write s3, write ui/meridian-write, codec-ooxml, codec-odf, codec-mwx, meridian-layout, meridian-edit, spec/formats/, shell/
S4 Sheets s4, sheets ui/meridian-sheets, meridian-calc, meridian-calc-xlsx, meridian-spell (словари), qa/sheets-*
S5 Качество и очередь s5, quality, qa .forgejo/, justfile, qa/, scripts/ (кроме скриптов дорожек), tools/, content/, mockups/, kernel/fuzz/ (с K), deploy/ci-runner/, deploy/status-center/, deploy/api-backup/, docs/ (кроме документов дорожек), OWNERS.toml, генерируемые файлы, серверная обвязка sagr и GX10
K Ядро k, kernel остальное kernel/ (core, render, raster, shape, font, unicode, text*, xml, archive, image, crypto, cipher, …), tests/; до решения № 2 — meridian-ffi, meridian-platform, meridian-menubar (proposed = S0), до S6 — meridian-pdf
D Проектирование 1.x d, design docs/adr/, docs/apps/, docs/research/, docs/NN-*.md, plan/, spikes/

Генерируемые файлы THIRD_PARTY.md, NOTICE, sbom.cdx.json и раздел «Сессии» docs/STATUS.md пересобирает только робот очереди слияния: ветки их не правят (check_owners это ловит), на ветках идёт только политика лицензий (third_party.py --policy), свежесть — в полном just ci пачки. Cargo.lock правит дорожка, добавившая или поднявшая зависимость; конфликт — just relock (сторона с origin/main + cargo update --workspace), руками lock не сливают.

Контракты между дорожками — по файлу на интерфейс в docs/contracts/ (шапка: владелец · версия · потребители · как менять). Межкрейтовый интерфейс новой дорожки описывается там до того, как дорожка начнёт им пользоваться.

Ветки, CI и main

  1. Каждая сессия работает в ветке claude/<префикс дорожки>-<тема> (префиксы — в таблице выше); ветку, которую выдал пул рабочих копий, лучше переименовать по дорожке — иначе проверка владения её пропускает.
  2. Пуш — минимум раз в день. CI (.forgejo/workflows/ci.yml, раннеры sagr и два слота GX10) на каждый пуш ветки claude/** прогоняет just ci-fast (fmt, владение, clippy Linux и Windows, Python-тесты, реестры), затем just ci-affected — тесты только затронутых веткой крейтов и их потребителей (scripts/affected.py; тайминг-тесты Hub и Sheets — только если затронуты окна или их зависимости). Полный just ci — в очереди слияния, на main и ночью (01:37 МСК). Итог — строка в /data/ci-logs/results.txt раннера: время, ветка, SHA, итог, длительность, рецепты, повторы очереди таймеров, слот.
  3. В main ветки попадают через очередь слияния: шаг готов и CI ветки зелёный — just queue (вершина ветки уходит в queue/<дорожка>; just queue-list — что стоит). Робот scripts/merge_queue.py на раннере GX10 раз в ≈ 45 минут сливает пачку поверх main (--no-ff, по порядку постановки), пересобирает генерируемые файлы, гоняет один полный just ci и перематывает main без --force. Красная пачка — бисекция: зелёный префикс уходит в main, виновная ветка и ветки с конфликтом возвращаются дорожке записью в блок «Возвраты очереди» её журнала docs/sessions/lanes/<id>.md, сама ветка снимается из очереди; робот конфликты не разрешает. Коммит возвратов (только журналы дорожек и раздел «Сессии») идёт поверх проверенного SHA — единственное исключение из «в main — только проверенное». Журнал робота — /data/ci-logs/queue-*.log и queue.txt на GX10. Ручная перемотка git push origin <sha>:main — только S5 и только для SHA с зелёной строкой полного CI; сводные ветки integ-* больше не нужны. Rebase ради перемотки не нужен: робот сливает ветку как есть. Пуш в ветку отменяет её незаконченное задание CI (cancel-in-progress): пока идёт CI, копите коммиты локально.
  4. Слияние — ежедневно, а не в конце задачи: маленькими зелёными шагами. Конфликт решает сессия-владелец файлов (rebase на origin/main, just relock для Cargo.lock, снова just queue).
  5. Незакоммиченное в рабочей копии — не дольше суток. Незаконченное коммитится в свою ветку как WIP и пушится: рабочую копию может забрать пул, и правки пропадут. docs/STATUS.md показывает ветки без слияния и копии с правками старше 24 часов.
  6. git stash общий для всех рабочих копий — не использовать голый stash/stash pop; вместо него WIP-коммит.

Публикация

  1. Публикуем только SHA из main. Установщики, пакеты, каталог загрузок, сайт и страницы на sagr собираются из коммита, который уже есть в origin/main (git merge-base --is-ancestor <sha> origin/main). Демо и превью ветки — только на отдельном поддомене <имя>-<версия>.24oros.ru, не на основном адресе продукта.
  2. Каждая выкладка и её проверка — строка в /opt/CHANGELOG.md на sagr (на GX10 — ~/ai/CHANGELOG.md): что, SHA, как проверено, как откатить. Секреты не печатать и не коммитить.
  3. На серверах нельзя: sudo, sshd/ufw/Tailscale, сам Traefik, перезапуск Docker-демона, чужие контейнеры.

Решения и отчётность

  1. Решение владельца — правка qa/gates.json или docs/STATUS.md, а не новый документ.
  2. Каждый вечер (минимум по пятницам) дорожка обновляет свой журнал docs/sessions/lanes/<id>.md: блок «Сейчас» — пять–восемь строк: сделано / мешает / нужно от владельца / последний зелёный SHA. Новый день заменяет прежний блок (история — в git). Раздел «Сессии» в docs/STATUS.md собирает из журналов status_center.py (его пересобирает робот очереди и just status); руками STATUS в этом разделе не правят, и конфликтов в нём нет. status_center.py --check (в ci-fast) проверяет, что у каждой дорожки карты есть журнал по шаблону.
  3. Квитанции (*.json с итогом) кладутся рядом с кодом проверки и попадают в индекс just evidence-index.

Передача дел

  1. Сессия может закончиться в любой момент, поэтому дела передаются каждый вечер, а не в конце задачи: раздел «Следующей сессии» журнала дорожки — с чего начать, что открыто (ветки, незаконченные шаги, ждущие ответа запросы к другим дорожкам), где лежат данные и стенды, какие команды проверки. Пишите так, чтобы новая сессия начала работу, прочитав только журнал, бриф (docs/sessions/briefs/<id>.md, если дорожка заведена just lane-new) и контракты из docs/contracts/.
  2. Новая сессия дорожки начинает день с журнала: «Сейчас», «Следующей сессии» и «Возвраты очереди» — возврат разбирается первым (rebase, починка, снова just queue), запись удаляется своим коммитом.
  3. Незаконченное — WIP-коммитом в свою ветку и пушем (правило 5), а не в рабочей копии: пул может забрать копию.

Session protocol (EN summary)

Lanes own disjoint files, recorded in the machine-readable map docs/sessions/OWNERS.toml and checked by scripts/check_owners.py in ci-fast; touching another lane's file needs a commit tagged [касание S<n>]. Work on claude/<lane prefix>-<topic>, push daily; branch CI runs ci-fast plus the tests of the affected crates only. Ready branches go to the merge queue with just queue; the robot on GX10 merges a batch on top of main every ~45 minutes, regenerates the generated files, runs one full just ci and fast-forwards main without --force; red batches are bisected and culprits or conflicts are returned to their lane's journal. Generated licence files are robot-only; Cargo.lock conflicts go through just relock. Contracts live in docs/contracts/, one file per interface. Each lane keeps its journal docs/sessions/lanes/<id>.md (now block and a hand-over section); STATUS assembles the sessions section from them. Only SHAs already in main are published; every deploy is logged in the server CHANGELOG.