Протокол работы сессий 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
- Каждая сессия работает в ветке
claude/<префикс дорожки>-<тема>(префиксы — в таблице выше); ветку, которую выдал пул рабочих копий, лучше переименовать по дорожке — иначе проверка владения её пропускает. - Пуш — минимум раз в день. 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, итог, длительность, рецепты, повторы очереди таймеров, слот. - В
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, копите коммиты локально. - Слияние — ежедневно, а не в конце задачи: маленькими зелёными
шагами. Конфликт решает сессия-владелец файлов (rebase на
origin/main,just relockдляCargo.lock, сноваjust queue). - Незакоммиченное в рабочей копии — не дольше суток. Незаконченное
коммитится в свою ветку как WIP и пушится: рабочую копию может забрать
пул, и правки пропадут.
docs/STATUS.mdпоказывает ветки без слияния и копии с правками старше 24 часов. git stashобщий для всех рабочих копий — не использовать голыйstash/stash pop; вместо него WIP-коммит.
Публикация
- Публикуем только SHA из
main. Установщики, пакеты, каталог загрузок, сайт и страницы на sagr собираются из коммита, который уже есть вorigin/main(git merge-base --is-ancestor <sha> origin/main). Демо и превью ветки — только на отдельном поддомене<имя>-<версия>.24oros.ru, не на основном адресе продукта. - Каждая выкладка и её проверка — строка в
/opt/CHANGELOG.mdна sagr (на GX10 —~/ai/CHANGELOG.md): что, SHA, как проверено, как откатить. Секреты не печатать и не коммитить. - На серверах нельзя: sudo, sshd/ufw/Tailscale, сам Traefik, перезапуск Docker-демона, чужие контейнеры.
Решения и отчётность
- Решение владельца — правка
qa/gates.jsonилиdocs/STATUS.md, а не новый документ. - Каждый вечер (минимум по пятницам) дорожка обновляет свой
журнал
docs/sessions/lanes/<id>.md: блок «Сейчас» — пять–восемь строк: сделано / мешает / нужно от владельца / последний зелёный SHA. Новый день заменяет прежний блок (история — в git). Раздел «Сессии» вdocs/STATUS.mdсобирает из журналовstatus_center.py(его пересобирает робот очереди иjust status); руками STATUS в этом разделе не правят, и конфликтов в нём нет.status_center.py --check(вci-fast) проверяет, что у каждой дорожки карты есть журнал по шаблону. - Квитанции (
*.jsonс итогом) кладутся рядом с кодом проверки и попадают в индексjust evidence-index.
Передача дел
- Сессия может закончиться в любой момент, поэтому дела передаются
каждый вечер, а не в конце задачи: раздел «Следующей
сессии» журнала дорожки — с чего начать, что открыто (ветки,
незаконченные шаги, ждущие ответа запросы к другим дорожкам), где лежат
данные и стенды, какие команды проверки. Пишите так, чтобы новая сессия
начала работу, прочитав только журнал, бриф
(
docs/sessions/briefs/<id>.md, если дорожка заведенаjust lane-new) и контракты изdocs/contracts/. - Новая сессия дорожки начинает день с журнала: «Сейчас», «Следующей
сессии» и «Возвраты очереди» — возврат разбирается первым (rebase,
починка, снова
just queue), запись удаляется своим коммитом. - Незаконченное — 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.