onreza-release 1.0.0

package/README.md

@@ -0,0 +1,881 @@
+# ONREZA Release
+
+[![npm version](https://img.shields.io/npm/v/onreza-release.svg)](https://www.npmjs.com/package/onreza-release)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Test Coverage](https://img.shields.io/badge/coverage-99.85%25-brightgreen.svg)](https://gitverse.ru/onreza/release-tool)
+
+Инструмент автоматизации релизов с поддержкой Conventional Commits, семантического версионирования и интеграцией с GitVerse.
+
+## Возможности
+
+- ✅ **Автоматическое версионирование** на основе Conventional Commits
+- 📝 **Генерация CHANGELOG** с группировкой по типам коммитов
+- 🌐 **Интеграция с GitVerse API** для создания релизов
+- 📦 **Поддержка монорепозиториев** с независимым версионированием
+- 🏷️ **Автоматические git теги и коммиты**
+- 🔍 **Режим dry-run** для безопасного тестирования
+- ⚙️ **Гибкая конфигурация** через `.gitversereleaserc.json`
+- 🔧 **Автогенерация commitlint конфига** из release конфигурации
+- 🪝 **Хуки beforeCommit** для автоматической подготовки файлов перед релизом
+- 📤 **Бинарная дистрибуция** — публикация платформенных npm-пакетов (по паттерну esbuild/biome)
+
+## Установка
+
+```bash
+# npm
+npm install -D onreza-release
+
+# bun
+bun add -d onreza-release
+
+# yarn
+yarn add -D onreza-release
+
+# pnpm
+pnpm add -D onreza-release
+```
+
+## Быстрый старт
+
+> ⚠️ **Важно:** Для создания релизов в GitVerse необходимо настроить `GVR_TOKEN`. Без токена инструмент работает в урезанном режиме (только локальные теги и CHANGELOG). См. [Настройка GVR_TOKEN](#️-настройка-gitverse_token)
+
+### 1. Базовое использование
+
+```bash
+# Создать релиз (dry-run для тестирования)
+npx onreza-release --dry-run
+
+# Создать и опубликовать релиз
+npx onreza-release
+```
+
+### 2. Конфигурация
+
+Создайте `.gitversereleaserc.json` в корне проекта:
+
+```json
+{
+  "git": {
+    "commitMessage": "chore(release): v{version} [skip ci]",
+    "tagMessage": "Release {version}",
+    "push": true,
+    "commitChanges": true
+  },
+  "changelog": {
+    "types": {
+      "feat": "✨ Новые возможности",
+      "fix": "🐛 Исправления",
+      "perf": "⚡ Производительность",
+      "docs": "📝 Документация"
+    },
+    "showHash": true,
+    "showAuthor": true
+  },
+  "gitverse": {
+    "createRelease": true
+  }
+}
+```
+
+### 3. Добавьте в package.json
+
+```json
+{
+  "scripts": {
+    "release": "onreza-release",
+    "release:dry": "onreza-release --dry-run"
+  }
+}
+```
+
+## Использование
+
+### Conventional Commits
+
+Инструмент автоматически определяет тип версии на основе коммитов:
+
+```bash
+# Patch (1.0.0 → 1.0.1)
+git commit -m "fix: исправлена ошибка валидации"
+
+# Minor (1.0.0 → 1.1.0)
+git commit -m "feat: добавлен новый API эндпоинт"
+
+# Major (1.0.0 → 2.0.0)
+git commit -m "feat!: изменен формат ответа API"
+# или
+git commit -m "feat: новая функция
+
+BREAKING CHANGE: изменен формат конфигурации"
+```
+
+### Pre-Major режим (0.x.x проекты)
+
+Для проектов в стадии разработки (версии `0.x.x`) доступен режим `preMajorMode`, который контролирует поведение BREAKING CHANGES:
+
+```json
+{
+  "versioning": {
+    "preMajorMode": "auto"  // Режим по умолчанию
+  }
+}
+```
+
+**Режимы работы:**
+
+- `"auto"` (default) - версии `< 1.0.0` → **minor bump**, `>= 1.0.0` → **major bump**
+- `"enabled"` - BREAKING CHANGE всегда делает **minor bump** (для experimental проектов)
+- `"disabled"` - стандартное semver поведение (BREAKING → major bump)
+- `"2.0.0"` - порог версии (minor bump пока версия < порога)
+
+**Примеры:**
+
+```bash
+# Режим "auto" (рекомендуется)
+# 0.5.0 + "feat!: breaking change" → 0.6.0
+# 1.5.0 + "feat!: breaking change" → 2.0.0
+
+# Режим "enabled" (experimental проект)
+# 1.5.0 + "feat!: breaking change" → 1.6.0
+
+# Режим с порогом "2.0.0"
+# 1.5.0 + "feat!: breaking change" → 1.6.0
+# 2.0.0 + "feat!: breaking change" → 3.0.0
+```
+
+> **Зачем это нужно?** По спецификации semver версии `0.x.x` находятся в pre-release фазе, где minor bump уже означает breaking change. Режим `auto` автоматически применяет правильную семантику.
+
+### Программное использование
+
+```typescript
+import { release } from "onreza-release";
+
+// Простой релиз
+const result = await release();
+
+console.log(result.success); // true
+console.log(result.newVersion); // "1.1.0"
+console.log(result.tag); // "v1.1.0"
+
+// С опциями
+const result = await release(undefined, {
+  dryRun: true,
+  version: "2.0.0",
+  skipGitStatusCheck: false,
+});
+
+// Для монорепозитория
+const result = await release("my-package", {
+  dryRun: false,
+});
+```
+
+> **Примечание для GitVerse Actions:**
+> В GitVerse Actions автоматически доступны переменные окружения:
+> - `GVR_TOKEN` - должен быть настроен в Secrets (см. [Настройка](#️-настройка-gitverse_token))
+> - `GITVERSE_PUBLIC_API_URL` - автоматически доступен (`https://api.gitverse.ru/`)
+> - `GITHUB_REPOSITORY` - имя репозитория в формате `owner/repo`
+
+## Поддержка монорепозиториев
+
+### Конфигурация
+
+```json
+{
+  "monorepo": {
+    "enabled": true,
+    "packages": [
+      {
+        "name": "core",
+        "packageName": "@myorg/core",
+        "path": "./packages/core",
+        "tagPrefix": "core@",
+        "changelog": "CHANGELOG.md"
+      },
+      {
+        "name": "ui",
+        "packageName": "@myorg/ui",
+        "path": "./packages/ui",
+        "tagPrefix": "ui@",
+        "changelog": "CHANGELOG.md"
+      }
+    ]
+  }
+}
+```
+
+### Использование
+
+```bash
+# Релиз конкретного пакета
+npx onreza-release core
+
+# Dry-run для пакета
+npx onreza-release ui --dry-run
+```
+
+### Фильтрация коммитов по scope
+
+```bash
+# Коммиты для пакета "core"
+git commit -m "feat(core): добавлена новая функция"
+
+# Коммиты для пакета "ui"
+git commit -m "fix(ui): исправлена ошибка компонента"
+
+# Общие коммиты (влияют на все пакеты)
+git commit -m "chore: обновлены зависимости"
+```
+
+## Генерация Commitlint конфига
+
+Инструмент может автоматически генерировать `commitlint.config.ts` из вашей release конфигурации, обеспечивая синхронизацию между форматом коммитов и генерацией релизов.
+
+### Быстрый старт
+
+```bash
+# Генерировать commitlint конфиг
+npx onreza-release generate-commitlint
+
+# Preview без записи файла
+npx onreza-release generate-commitlint --dry-run
+
+# С кастомными параметрами
+npx onreza-release generate-commitlint --format js --output .commitlintrc.js
+```
+
+### Что генерируется?
+
+Команда автоматически извлекает:
+- **Типы коммитов** из `changelog.types` (feat, fix, docs, etc.)
+- **Scopes** из названий пакетов в монорепо + дополнительные scopes
+- **Правила валидации** (max length, case, required fields)
+
+### Конфигурация defaults
+
+Добавьте секцию `commitlint` в `.gitversereleaserc.json`:
+
+```json
+{
+  "commitlint": {
+    "output": "commitlint.config.ts",
+    "format": "ts",
+    "scopes": ["deps", "ci", "docs"],
+    "scopeRequired": false,
+    "headerMaxLength": 100,
+    "comments": true
+  }
+}
+```
+
+Теперь можно просто запускать `npx onreza-release generate-commitlint` без параметров!
+
+### CLI опции
+
+```bash
+--output <path>          Путь для вывода (default: из конфига)
+--format <ts|js|json>    Формат файла (default: из конфига)
+--scopes <list>          Дополнительные scopes через запятую
+--scope-required         Требовать обязательный scope
+--header-max-length <n>  Максимальная длина header
+--no-comments            Отключить комментарии в файле
+--dry-run                Preview без записи
+--verbose                Подробный вывод
+```
+
+### Примеры использования
+
+```bash
+# Использовать настройки из конфига
+npx onreza-release generate-commitlint
+
+# Preview сгенерированного файла
+npx onreza-release generate-commitlint --dry-run --verbose
+
+# Генерировать JS вместо TS
+npx onreza-release generate-commitlint --format js --output .commitlintrc.js
+
+# Добавить дополнительные scopes
+npx onreza-release generate-commitlint --scopes api,cli,tests
+
+# Требовать обязательный scope
+npx onreza-release generate-commitlint --scope-required
+```
+
+### Преимущества
+
+✅ **Единый источник истины** - типы и scopes определяются в одном месте
+✅ **Автоматическая синхронизация** - изменения в release конфиге автоматически отражаются в commitlint
+✅ **Меньше ошибок** - нет риска рассинхронизации конфигов
+✅ **CI-friendly** - легко интегрируется в pipelines для проверки актуальности конфига
+
+## Бинарная дистрибуция
+
+Инструмент поддерживает создание и публикацию платформенных npm-пакетов по паттерну, используемому esbuild, biome, bun и другими инструментами.
+
+### Как это работает
+
+1. **Платформенные пакеты** (`@scope/name-linux-x64`, `@scope/name-darwin-arm64`, ...) содержат только бинарник для конкретной платформы с фильтрами `os`/`cpu` в package.json
+2. **Основной пакет** объявляет их в `optionalDependencies` и содержит JS wrapper, который находит и запускает нужный бинарник
+3. npm автоматически устанавливает только подходящий платформенный пакет
+
+### Быстрый старт
+
+```bash
+# Preview без публикации
+npx onreza-release publish-binaries --dry-run
+
+# Только генерация пакетов (без публикации)
+npx onreza-release generate-binary-packages
+
+# Генерация и публикация
+npx onreza-release publish-binaries
+```
+
+### Конфигурация
+
+Добавьте секцию `binaries` в `.gitversereleaserc.jsonc`:
+
+```jsonc
+{
+  "binaries": {
+    "enabled": true,
+    "scope": "@rainypixel",           // npm scope (опционально)
+    "name": "yougile",                 // базовое имя пакетов
+    "binName": "yougile",              // имя бинарника в $PATH (опционально)
+    "distDir": "./dist",               // директория с бинарниками
+    "outDir": "./npm",                 // куда генерировать пакеты
+    "platforms": [
+      "linux-x64",
+      "linux-arm64",
+      "darwin-x64",
+      "darwin-arm64",
+      "win32-x64"
+    ],
+    "publishCommand": "npm publish --access public",
+    "mainPackage": "./package.json",   // основной package.json
+    "continueOnError": false,          // продолжать при ошибке
+    "retryAttempts": 3                 // retry для публикации
+  }
+}
+```
+
+### Пакеты без scope
+
+`scope` опционален. Без него пакеты публикуются как `myapp-linux-x64` вместо `@org/myapp-linux-x64`:
+
+```jsonc
+{
+  "binaries": {
+    "enabled": true,
+    "name": "myapp",                   // без scope!
+    "distDir": "./dist",
+    "platforms": ["linux-x64", "darwin-arm64"]
+  }
+}
+// Результат: myapp-linux-x64, myapp-darwin-arm64
+```
+
+### Кастомный шаблон имени пакета
+
+Используйте `packageNameTemplate` для гибкой настройки имён:
+
+```jsonc
+{
+  "binaries": {
+    "name": "myapp",
+    "packageNameTemplate": "{{name}}-bin-{{platform}}"
+  }
+}
+// Результат: myapp-bin-linux-x64
+```
+
+```jsonc
+{
+  "binaries": {
+    "name": "myapp",
+    "scope": "@org",
+    "packageNameTemplate": "@{{scope}}/{{name}}-cli-{{platform}}"
+  }
+}
+// Результат: @org/myapp-cli-linux-x64
+```
+
+**Плейсхолдеры:** `{{scope}}`, `{{name}}`, `{{platform}}`
+
+**Дефолтные шаблоны:**
+- Без scope: `{{name}}-{{platform}}`
+- Со scope: `@{{scope}}/{{name}}-{{platform}}`
+
+### Структура бинарников
+
+#### Формат "directory" (по умолчанию)
+
+Бинарники в директориях:
+
+```
+dist/
+  yougile-linux-x64/
+    yougile            # бинарник для linux x64
+  yougile-darwin-arm64/
+    yougile            # бинарник для macOS ARM
+  yougile-win32-x64/
+    yougile.exe        # бинарник для Windows
+```
+
+#### Формат "tar.gz"
+
+Бинарники в tar.gz архивах (удобно для CI артефактов):
+
+```jsonc
+{
+  "binaries": {
+    "inputFormat": "tar.gz",
+    "sourceBinName": "cli",            // имя бинарника внутри архива
+    "platformMap": {                    // маппинг имён архивов на платформы
+      "linux-amd64": "linux-x64",
+      "darwin-arm64": "darwin-arm64",
+      "windows-x64": "win32-x64"
+    }
+  }
+}
+```
+
+Структура архивов:
+```
+dist/
+  myapp-linux-amd64.tar.gz    # содержит cli (или cli внутри поддиректории)
+  myapp-darwin-arm64.tar.gz
+  myapp-windows-x64.tar.gz
+```
+
+**Опции для tar.gz:**
+- `inputFormat: "tar.gz"` — включает режим архивов
+- `sourceBinName` — имя бинарника внутри архива (если отличается от `name`)
+- `platformMap` — маппинг ключей в именах архивов на npm платформы
+
+### Генерируемая структура
+
+```
+npm/
+  @rainypixel/
+    yougile-linux-x64/
+      package.json     # { "os": ["linux"], "cpu": ["x64"], "bin": {...} }
+      bin/yougile      # скопированный бинарник
+      README.md
+    yougile-darwin-arm64/
+      ...
+```
+
+### CLI опции
+
+```bash
+# Publish binaries
+npx onreza-release publish-binaries [options]
+
+# Generate only (без публикации)
+npx onreza-release generate-binary-packages [options]
+
+Опции:
+  --dry-run              Preview без изменений
+  --version <ver>        Override версии
+  --platforms <list>     Конкретные платформы (comma-separated)
+  --generate-only        Только генерация (для publish-binaries)
+  --skip-main-package    Не обновлять основной package.json
+  --verbose              Подробный вывод
+```
+
+### Кастомная команда публикации
+
+Команда публикации поддерживает плейсхолдеры:
+
+```jsonc
+{
+  "binaries": {
+    "publishCommand": "npm publish --access public --registry https://registry.npmjs.org"
+    // Доступные плейсхолдеры:
+    // {{packageDir}} - путь к пакету
+    // {{version}} - версия
+    // {{platform}} - платформа (linux-x64, etc.)
+    // {{scope}} - npm scope
+    // {{name}} - имя пакета
+  }
+}
+```
+
+### Пример dry-run вывода
+
+```
+🔍 DRY RUN MODE
+
+📦 Binary Distribution:
+  Scope: @rainypixel
+  Name: yougile
+  Version: 1.2.3
+  Platforms: linux-x64, darwin-arm64
+
+📁 Packages to generate:
+  npm/@rainypixel/yougile-linux-x64/
+  npm/@rainypixel/yougile-darwin-arm64/
+
+📝 Main package updates:
+  optionalDependencies:
+    "@rainypixel/yougile-linux-x64": "1.2.3"
+    "@rainypixel/yougile-darwin-arm64": "1.2.3"
+  bin:
+    "yougile": "bin/yougile.js"
+
+🚀 Publish command: npm publish --access public
+```
+
+### Интеграция с CI/CD
+
+```yaml
+jobs:
+  publish-binaries:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      # Скачать бинарники из других jobs или артефактов
+      - name: Download binaries
+        uses: actions/download-artifact@v4
+        with:
+          name: binaries
+          path: dist/
+
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install
+
+      - name: Publish platform packages
+        run: npx onreza-release publish-binaries
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+## Конфигурация
+
+### Полный пример
+
+```json
+{
+  "git": {
+    "beforeCommit": "bun run lint:fix",
+    "commitMessage": "chore(release): v{version} [skip ci]",
+    "tagMessage": "Release {version}",
+    "push": true,
+    "commitChanges": true
+  },
+  "changelog": {
+    "types": {
+      "feat": "✨ Новые возможности",
+      "fix": "🐛 Исправления",
+      "perf": "⚡ Улучшения производительности",
+      "refactor": "♻️ Рефакторинг",
+      "docs": "📝 Документация",
+      "style": "💄 Стили",
+      "test": "✅ Тесты",
+      "build": "🔧 Сборка",
+      "ci": "👷 CI/CD",
+      "chore": "🧹 Прочее"
+    },
+    "showHash": true,
+    "showAuthor": true
+  },
+  "versioning": {
+    "tagPrefix": "v",
+    "prereleasePrefix": "beta",
+    "allowPrerelease": false,
+    "preMajorMode": "auto"
+  },
+  "gitverse": {
+    "createRelease": true,
+    "token": "${GVR_TOKEN}"
+  },
+  "monorepo": {
+    "enabled": false,
+    "packages": []
+  },
+  "commitlint": {
+    "output": "commitlint.config.ts",
+    "format": "ts",
+    "scopes": ["deps", "ci", "docs"],
+    "scopeRequired": false,
+    "headerMaxLength": 100,
+    "comments": true
+  },
+  "binaries": {
+    "enabled": false,
+    "scope": "@myorg",
+    "name": "myapp",
+    "distDir": "./dist",
+    "outDir": "./npm",
+    "platforms": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64"],
+    "publishCommand": "npm publish --access public",
+    "continueOnError": false,
+    "retryAttempts": 3
+  }
+}
+```
+
+### beforeCommit хук
+
+Хук `beforeCommit` запускается **перед проверкой чистоты working tree** и позволяет автоматически подготовить файлы перед созданием релиза:
+
+```json
+{
+  "git": {
+    "beforeCommit": "bun run lint:fix"
+  }
+}
+```
+
+**Как это работает:**
+1. Запускается команда `beforeCommit` (например, линтер)
+2. Если команда выполнилась успешно (exit code 0):
+   - Все измененные файлы добавляются в staging area (`git add -A`)
+   - Эти изменения войдут в коммит релиза вместе с version/changelog
+3. Проверяется чистота working tree (только unstaged изменения)
+
+**Примеры использования:**
+```json
+// Форматирование кода
+"beforeCommit": "bun run format"
+
+// Линтинг и автофикс
+"beforeCommit": "bun run lint:fix"
+
+// Обновление lock файлов
+"beforeCommit": "bun install --frozen-lockfile=false"
+
+// Несколько команд
+"beforeCommit": "bun run lint:fix && bun run format"
+```
+
+**Важно:** Если хук завершается с ошибкой (exit code ≠ 0), изменения НЕ добавляются в staging area и релиз продолжается как обычно.
+
+### Переменные окружения
+
+```bash
+# Токен GitVerse для создания релизов
+export GVR_TOKEN="your-token-here"
+
+# Или через .env файл
+echo "GVR_TOKEN=your-token" >> .env
+```
+
+### ⚠️ Настройка GVR_TOKEN
+
+**КРИТИЧЕСКИ ВАЖНО:** Без настройки `GVR_TOKEN` инструмент работает в **урезанном режиме**:
+
+✅ **С токеном (полный режим):**
+- Автоматическое создание релизов в GitVerse
+- Публикация changelog в релиз
+- Загрузка ассетов релиза
+- Push тегов и коммитов в удаленный репозиторий
+
+⚠️ **Без токена (урезанный режим):**
+- ❌ НЕТ создания релизов в GitVerse
+- ✅ Генерация CHANGELOG локально
+- ✅ Создание git тегов локально
+- ✅ Коммиты изменений локально
+
+#### Настройка токена для GitVerse Actions
+
+**Важно:** `GVR_TOKEN` **НЕ предоставляется автоматически** в GitVerse Actions!
+
+**Шаг 1: Создайте Personal Access Token**
+1. Перейдите в GitVerse: **Settings** → **Applications** → **Generate New Token**
+2. Выберите необходимые права:
+   - `repo` - полный доступ к репозиториям (обязательно для релизов)
+3. Скопируйте токен (показывается только один раз!)
+
+**Шаг 2: Добавьте токен в Secrets репозитория**
+1. В репозитории: **Settings** → **Secrets and Variables** → **Actions**
+2. Нажмите **New repository secret**
+3. **Name:** `GVR_TOKEN`
+4. **Value:** ваш Personal Access Token
+5. Сохраните
+
+**Шаг 3: Используйте в workflow**
+```yaml
+env:
+  GVR_TOKEN: ${{ secrets.GVR_TOKEN }}
+```
+
+**Шаг 4: Проверка (рекомендуется)**
+```yaml
+- name: Validate GVR_TOKEN
+  run: |
+    if [ -z "$GVR_TOKEN" ]; then
+      echo "❌ ERROR: GVR_TOKEN is not set!"
+      echo "Please add GVR_TOKEN to repository secrets."
+      exit 1
+    fi
+    echo "✅ GVR_TOKEN is configured"
+```
+
+## CLI опции
+
+### Основные команды
+
+```bash
+# Создать релиз
+npx onreza-release [package] [options]
+
+# Инициализировать конфигурацию
+npx onreza-release init [options]
+
+# Генерировать commitlint конфиг
+npx onreza-release generate-commitlint [options]
+
+# Создать только GitVerse Release для существующего тега (recovery mode)
+npx onreza-release create-only --tag <tag> [--package <name>]
+
+# Публикация бинарных пакетов
+npx onreza-release publish-binaries [options]
+
+# Генерация бинарных пакетов (без публикации)
+npx onreza-release generate-binary-packages [options]
+```
+
+### Опции для релиза
+
+```
+Аргументы:
+  package              Имя пакета для релиза (для монорепозиториев)
+
+Опции:
+  --dry-run            Запуск без внесения изменений
+  --config <path>      Путь к конфиг файлу (default: .gitversereleaserc.json)
+  --package <name>     Имя пакета для релиза (для монорепо)
+  --version <version>  Указать конкретную версию
+  --prerelease [tag]   Создать prerelease версию (beta, alpha, rc)
+  --no-commit          Не создавать git коммит
+  --no-tag             Не создавать git тег
+  --no-push            Не пушить в remote
+  --no-release         Не создавать GitVerse Release
+  --verbose            Подробный вывод
+  --help               Показать справку
+```
+
+### Опции для generate-commitlint
+
+```
+Опции:
+  --output <path>            Путь для вывода (default: commitlint.config.ts)
+  --format <ts|js|json>      Формат файла (default: ts)
+  --scopes <scopes>          Дополнительные scopes (comma-separated)
+  --scope-required           Требовать обязательный scope
+  --header-max-length <n>    Максимальная длина header (default: 100)
+  --no-comments              Отключить комментарии в файле
+  --dry-run                  Preview без записи
+  --verbose                  Подробный вывод
+```
+
+### Опции для publish-binaries / generate-binary-packages
+
+```
+Опции:
+  --dry-run                  Preview без изменений
+  --version <ver>            Override версии (default: из package.json)
+  --platforms <list>         Конкретные платформы (comma-separated)
+  --generate-only            Только генерация, без публикации
+  --skip-main-package        Не обновлять основной package.json
+  --verbose                  Подробный вывод
+```
+
+## CI/CD интеграция
+
+### GitVerse Actions
+
+⚠️ **Перед использованием:** Убедитесь, что `GVR_TOKEN` добавлен в Secrets репозитория (см. [Настройка GVR_TOKEN](#️-настройка-gitverse_token))
+
+```yaml
+name: Release
+
+on:
+  workflow_dispatch:
+
+env:
+  # ОБЯЗАТЕЛЬНО: Добавьте GVR_TOKEN в Secrets репозитория!
+  GVR_TOKEN: ${{ secrets.GVR_TOKEN }}
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: oven-sh/setup-bun@v2
+
+      - run: bun install
+
+      # ВАЖНО: Проверка наличия токена перед релизом
+      - name: Validate GVR_TOKEN
+        run: |
+          if [ -z "$GVR_TOKEN" ]; then
+            echo "❌ ERROR: GVR_TOKEN is not set!"
+            echo "Please add GVR_TOKEN to repository secrets."
+            echo "See: Settings → Secrets and Variables → Actions"
+            exit 1
+          fi
+          echo "✅ GVR_TOKEN is configured"
+
+      - name: Configure Git
+        run: |
+          git config user.name "GitVerse CI"
+          git config user.email "ci@gitverse.ru"
+
+      - name: Create Release
+        run: bun run release
+```
+
+**Что происходит в этом workflow:**
+1. ✅ Проверяет наличие `GVR_TOKEN` (workflow упадет с ошибкой, если токен не настроен)
+2. ✅ Устанавливает зависимости
+3. ✅ Настраивает git для создания коммитов
+4. ✅ Создает релиз с полным функционалом (CHANGELOG, теги, GitVerse release)
+5. ✅ Автоматически публикует в GitVerse
+
+## Разработка
+
+```bash
+# Установка зависимостей
+bun install
+
+# Запуск тестов
+bun test
+
+# Проверка покрытия
+bun test:coverage
+
+# Сборка проекта
+bun run build
+
+# Линтинг
+bun run lint
+bun run lint:fix
+```
+
+## Лицензия
+
+MIT © [ONREZA](https://onreza.ru)
+
+## Полезные ссылки
+
+- [GitVerse SDK](https://gitverse.ru/onreza/release-tool) - Основной репозиторий
+- [Conventional Commits](https://www.conventionalcommits.org/ru/) - Спецификация
+- [Keep a Changelog](https://keepachangelog.com/ru/) - Руководство по CHANGELOG
+- [Semantic Versioning](https://semver.org/lang/ru/) - Семантическое версионирование
+- [npm пакет](https://www.npmjs.com/package/onreza-release)
+
+## Сообщить об ошибке
+
+Создайте issue на [GitVerse](https://gitverse.ru/onreza/release-tool/tasktracker)
+
+---
+
+Сделано с ❤️ для GitVerse