C9S/mono

Fork 0

Files

T

coopops 44e45dfb00

Typecheck / desktop (pull_request) Failing after 8m19s

Details

Typecheck / controller (pull_request) Successful in 12m30s

Details

[@dark-sun] ci(release): FF-промоушн dev→testnet→main вместо merge -X theirs

Релизный флоу переведён на линейную fast-forward модель — устраняет
регулярные конфликты на 20 package.json при релизе.

Корень проблемы: publish-alpha.sh/publish-prod.sh бампали версию НА КАЖДОЙ
ветке (alpha-N на testnet, чистую на main) через `git merge -X theirs` +
back-merge. Два независимых bump-коммита за цикл + merge'и плодили
расхождение веток → конфликты (особенно при гонке push/pull).

Новая модель:
- Версию бампает lerna ОДИН раз на dev (scripts/cut-release.sh).
- Тот же коммит едет вверх по FF: scripts/promote.sh testnet|main
(server-side fast-forward push, рабочее дерево не трогается).
- testnet/main не несут своих коммитов → ветки не диверджатся → конфликты
структурно невозможны.

release.yaml:
- Триггер: push в testnet/main с изменением lerna.json (вместо тега v*).
Окружение определяет ВЕТКА (main→prod, testnet→staging), не суффикс -alpha.
- Версия читается из закоммиченного lerna.json (едет с коммитом по FF).
- Гейты npm-publish/доки: branch == main (вместо !contains '-alpha').
- Образы/webhook по-прежнему версия-тегированы → playbooks/приёмник деплоя
не затрагиваются.

Удалены publish-alpha.sh/publish-prod.sh и мёртвые дубли тех же merge-X-theirs
скриптов (root sync:main, components/contracts production/testnet/docs-publish).
Документация — scripts/RELEASE.md + CLAUDE.md PR-flow.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-09 18:29:09 +00:00

4.0 KiB

Raw Blame History

Релизный флоу: FF-промоушн dev → testnet → main

Линейная модель без merge и без конфликтов. Версию бампает lerna один раз на dev, и тот же коммит едет вверх по fast-forward. testnet и main не несут собственных коммитов — это указатели на протестированный коммит dev, поэтому ветки никогда не диверджатся и merge-конфликтов не бывает.

Как релизить

# 1. Нарезать релиз на dev (бамп версии lerna, БЕЗ деплоя)
scripts/cut-release.sh

# 2. Промоут на staging (деплой в testnet)
scripts/promote.sh testnet

# 3. Промоут в production (деплой main + npm publish + доки)
scripts/promote.sh main

cut-release.sh — строго на dev. Считает версию vYYYY.M.D (повторный релиз того же дня → суффикс -N), вызывает lerna version (бамп всех package.json + lerna.json, коммит chore(release): publish, тег, push dev). Деплой не запускает — CI не слушает dev.
promote.sh testnet|main — server-side fast-forward push origin/<source> → origin/<target>, рабочее дерево не трогается.

Что триггерит деплой

.github/workflows/release.yaml слушает push в testnet/main с изменением lerna.json. lerna.json меняется только при релизном бампе (на dev), и этот коммит входит в диапазон FF-промоушна — поэтому деплоятся именно релизы, а не обычные feature-пуши.

Окружение определяет ветка, не суффикс версии:

Ветка	Окружение	Деплой-webhook	npm publish / доки
`testnet`	staging	`TESTNET_WEBHOOK_URL`	нет
`main`	production	`PRODUCTION_WEBHOOK_URL`	да (`main`)

Версия для образов (dicoop/*:vX), webhook-payload и lerna publish from-package читается из закоммиченного lerna.json — едет с коммитом по FF. Для приёмника деплоя (playbooks) ничего не меняется: webhook по-прежнему получает версию-строку, образы тегаются версией.

Инварианты (не нарушать)

В testnet/main — только FF-промоушн, никаких прямых коммитов. Прямой коммит сделает ветку не-FF; promote.sh тогда отвергнется push'ем (это гард, а не баг — выровняй ветку).
Версия бампается только на dev (cut-release.sh). Никаких повторных бампов на testnet/main — иначе вернутся расхождение и конфликты.
Тег (vX), который вешает lerna version, — маркер версии и основа для GitHub Release (scripts/publish-release.sh); триггером деплоя он не является.

Откуда ушли (история)

Старые publish-alpha.sh/publish-prod.sh бампали версию на каждой ветке (-alpha-N на testnet, чистую на main) через git merge -X theirs + back-merge. Два независимых бампа за цикл + merge'и плодили расхождение → 20 package.json регулярно конфликтовали (особенно при гонке push/pull). FF-модель это устраняет конструктивно.

4.0 KiB Raw Blame History Unescape Escape