spectrum-cli 5.0.1 → 5.0.2

package/CHANGELOG.md

@@ -9,6 +9,14 @@ This is the changelog of the `spectrum-cli` npm package. Its version comes from
 `package.json`; the release commands use Git tags and `CHANGELOG.md` in the
 **target project** and do not update that project's `package.json`.
 
+## 🚀 [5.0.2] - 2026-10-23
+
+### Changed
+
+- При baseline `0.x` обычные релизы с breaking/removed повышают minor, сохраняя тип записей; исправления повышают patch. Первый `1.0.0` требует явного `release start --stable`; другой открытый релиз блокирует переход. После `1.0.0` действует прежний SemVer.
+
+- Команды `spectrum chart` используют `SC_DEVELOPER_PAT` вместо `SC_OWNER_PAT` для Helm-registry. Новое имя имеет приоритет. `SC_OWNER_PAT` сохранена как deprecated fallback с предупреждением при использовании; поддержка старого имени будет удалена в следующей версии. Owner для проверки registry не требуется. Запрос owner PAT в `token rotate` для управления групповыми CI/CD variables не изменён.
+
 ## 🚀 [5.0.1] - 2026-10-02
 
 ### 🛠 Changed

package/README.md

@@ -43,7 +43,7 @@ spectrum --help
 spectrum -v  # или spectrum --version
 
 # 🚀 Управление релизами
-spectrum release start               # Схлопнуть fragments и атомарно отправить release commit в dev и main/master
+spectrum release start [--stable]    # Схлопнуть fragments и атомарно отправить release commit в dev и main/master
 spectrum release deploy              # Создать стабильный тег release/X.Y.Z из заголовка CHANGELOG
 spectrum release close               # Свести stable main/master в dev
 
@@ -172,7 +172,14 @@ spectrum-cli/
 - `spectrum release close`: чистая и актуальная main/master, версия из верхнего заголовка `CHANGELOG.md` и remote stable-тег поддерживаемой формы, указывающий на текущий commit.
 - `spectrum changelog append <message>`: `git-repo`, `changelog-exists`, валидные ID задачи, git identity и тип fragment. Команда не изменяет общий `CHANGELOG.md`.
 - `spectrum changelog check`: `git-repo`, `changelog-exists`, `changelog-prettier-check`, наличие и формат всех changelog fragments.
-- `spectrum chart start`: `git-repo`, `clean-working-tree`, `on-main-branch`, `single-chart` (ровно один `charts/<chart-name>/Chart.yaml`), валидный верхний SemVer-заголовок в `charts/<chart-name>/CHANGELOG.md`, отсутствие тега `chart-<name>-<version>` локально и на `origin`, отсутствие этой версии чарта в Helm-registry. Для запроса registry нужен `SC_OWNER_PAT`; ошибка доступа блокирует команду. `-f, --force` обходит только проверку повышения версии относительно последнего remote-тега. После push команда по умолчанию ждёт версию в registry; `-n, --no-wait` отключает ожидание.
+- `spectrum chart start`: `git-repo`, `clean-working-tree`, `on-main-branch`, `single-chart` (ровно один `charts/<chart-name>/Chart.yaml`), валидный верхний SemVer-заголовок в `charts/<chart-name>/CHANGELOG.md`, отсутствие тега `chart-<name>-<version>` локально и на `origin`, отсутствие этой версии чарта в Helm-registry. Для запроса registry нужен `SC_DEVELOPER_PAT` (PAT со scope `api` и доступом к проекту; роль Owner не требуется); ошибка доступа блокирует команду. Право отправки chart-тега определяется отдельно правилами protected tags. `-f, --force` обходит только проверку повышения версии относительно последнего remote-тега. После push команда по умолчанию ждёт версию в registry; `-n, --no-wait` отключает ожидание.
+
+Для обратной совместимости chart-команды принимают `SC_OWNER_PAT`, если
+`SC_DEVELOPER_PAT` не задана или пуста. `SC_OWNER_PAT` deprecated: поддержка
+будет удалена в следующей версии. При её использовании CLI один раз за процесс
+выводит предупреждение с просьбой перейти на `SC_DEVELOPER_PAT`. Если заданы обе
+переменные, используется `SC_DEVELOPER_PAT` без предупреждения.
+
 - `spectrum chart deploy`: `git-repo`, `clean-working-tree`, `on-main-branch` (текущая ветка `main`), `remote-origin` (настроен `origin`), `remote-reachable` (доступен `origin`), `single-chart`, `helmrelease-files` (найдены `helmrelease.yaml`).
 - `spectrum chart verify <source_path>`: `git-repo`, `single-values-yaml` (ровно один `charts/**/values.yaml`), `values-ingress-sections` (есть `ingress.paths.api/pages/assets`), `source-path-directory`, `next-project`, `build-command-support`.
 - `spectrum token rotate`: `load-config` (есть валидный `~/.config/spectrum-cli/config.yaml`), `ask-tokens` (owner PAT и `SC_BOT_PAT` только в памяти), `check-access` (все группы и проекты доступны owner PAT).
@@ -185,10 +192,23 @@ spectrum-cli/
 
 1. Проверяет чистую актуальную dev-ветку, включающую `origin/main` или `origin/master`, changelog и fragments.
 2. После `git fetch origin --prune --tags` находит максимальный stable-тег среди `release/X.Y.Z`, `hotfix/X.Y.Z` и `vX.Y.Z`, достижимый из production-ветки.
-3. Если открытого релиза нет, вычисляет версию по fragments: `breaking` и `removed` → major, `added` → minor, остальные → patch. Если раздел уже открыт в main/master, сохраняет его версию и дату, объединяет прежние записи с новыми по разделам без дублей. Тип новых fragments не повышает уже выбранную версию.
+3. Если открытого релиза нет, вычисляет версию по fragments. До `1.0.0`: `breaking`, `removed` и `added` → minor, остальные → patch. Начиная с `1.0.0`: `breaking` и `removed` → major, `added` → minor, остальные → patch. Если раздел уже открыт в main/master, сохраняет его версию и дату, объединяет прежние записи с новыми по разделам без дублей. Тип новых fragments не повышает уже выбранную версию.
 4. Форматирует и проверяет `CHANGELOG.md`, затем удаляет использованные fragments.
 5. Коммитит изменения и атомарно пушит dev в `origin/dev` и `origin/main` или `origin/master`, без Merge Request. Если новых записей нет, пустой коммит не создаётся; можно повторить отправку после её сбоя.
 
+Первый стабильный выпуск создаётся явно: `spectrum release start --stable`
+вычисляет ровно `1.0.0` от опубликованного `0.x`. Другой открытый релиз блокирует
+переход; повтор подготовки открытого `1.0.0` допустим. Флаг запрещён после
+перехода на `1.x`. Он выполняет обычный workflow `release start`, включая commit
+и push; `--dry` запускает только предпроверки. Обычный запуск от `0.3.7` с
+breaking/removed даёт `0.4.0`, с исправлением — `0.3.8`; исходные типы записей
+сохраняются. Alpha CI должен применять ту же политику к своей базовой версии.
+
+Сброс прежней высокой нумерации на `0.x` не выполняется этой командой: это
+отдельная миграция с архивом changelog и ссылок тегов, согласованием dev/master и
+исключением старых тегов из расчёта версии. Нельзя запускать `release start`,
+пока опубликованная история в dev и production различается.
+
 Например, повторный `release start` дополняет открытый `1.4.0`; после публикации
 `release/1.4.0` новые fragments уже формируют следующий релиз. Изменение
 опубликованной истории и конфликтующие открытые версии блокируют команду.
@@ -378,13 +398,13 @@ projects: []
 
 **📋 Типы fragment и SemVer:**
 
-| Суффикс | Раздел | Повышение версии |
-| --- | --- | --- |
-| `breaking` | Breaking change | major |
-| `removed` | Removed | major |
-| `added` | Added | minor |
-| `changed`, `deprecated` | Соответствующий раздел | patch |
-| `fixed`, `security`, `support` | Соответствующий раздел | patch |
+| Суффикс | Раздел | До `1.0.0` | С `1.0.0` |
+| --- | --- | --- | --- |
+| `breaking` | Breaking change | minor | major |
+| `removed` | Removed | minor | major |
+| `added` | Added | minor | minor |
+| `changed`, `deprecated` | Соответствующий раздел | patch | patch |
+| `fixed`, `security`, `support` | Соответствующий раздел | patch | patch |
 
 **📌 Пример использования:**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-cli",
-  "version": "5.0.1",
+  "version": "5.0.2",
   "description": "🚀 Modern CLI for development workflow automation - release management, versioning, and changelog generation",
   "main": "index.js",
   "bin": {

package/src/chart/registry.js

@@ -3,6 +3,7 @@ const { parseGitlabUrl } = require('../integrations/gitlab-url');
 const HELM_REGISTRY_CHANNEL = 'stable';
 const REGISTRY_WAIT_TIMEOUT_MS = 10 * 60 * 1000;
 const REGISTRY_WAIT_INTERVAL_MS = 15 * 1000;
+let legacyTokenWarningShown = false;
 
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
@@ -88,11 +89,15 @@ async function fetchChartVersionFromRegistry(chartName, version) {
         return { ok: false, reason: 'Не удалось определить GitLab-проект из remote "origin".' };
     }
 
-    const accessToken = process.env.SC_OWNER_PAT;
+    const accessToken = process.env.SC_DEVELOPER_PAT || process.env.SC_OWNER_PAT;
+    if (!process.env.SC_DEVELOPER_PAT && accessToken && !legacyTokenWarningShown) {
+        logError('⚠️', 'SC_OWNER_PAT устарела (deprecated) и будет удалена в следующей версии spectrum-cli. Замените её на SC_DEVELOPER_PAT.');
+        legacyTokenWarningShown = true;
+    }
     if (!accessToken) {
         return {
             ok: false,
-            reason: 'Не задана переменная окружения SC_OWNER_PAT. Она нужна для проверки публикации чарта в Helm-registry.'
+            reason: 'Не задана переменная окружения SC_DEVELOPER_PAT. Она нужна для проверки публикации чарта в Helm-registry.'
         };
     }
 

package/src/cli/commands.js

@@ -29,6 +29,7 @@ const releaseCmd = program
 releaseCmd
   .command("start")
   .description("Схлопнуть fragments и атомарно отправить release commit в dev и main/master")
+  .option("--stable", "Явно перейти с 0.x на первый стабильный релиз 1.0.0")
   .option("-d, --dry", "Запустить только предпроверки")
   .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
   .action((command) => runAction(release.releaseStart, command));

package/src/release/start.js

@@ -5,7 +5,7 @@ const { requireGitRepo, requireCleanWorkingTree, requireCurrentBranchUpToDateWit
 const { CHANGELOG_FILE } = require('../changelog/config');
 const { detectBumpType, resolveReleaseVersion } = require('./version');
 const { releaseFormatChangelog, releaseCheckChangelogLint, releaseCommit, releasePush } = require('./steps');
-function releaseStart() {
+function releaseStart(options = {}) {
     return runCommand({
         name: 'release start',
         checks: [
@@ -24,9 +24,13 @@ function releaseStart() {
                 name: 'detect-bump-type',
                 requires: ['changelogFragments', 'stableVersion'],
                 run: (ctx) => {
+                    if (options.stable && (!ctx.stableVersion.startsWith('0.') ||
+                        (ctx.openReleaseVersion && ctx.openReleaseVersion !== '1.0.0'))) {
+                        return { ok: false, reason: '--stable разрешён только для перехода с 0.x на 1.0.0 без другого открытого релиза.' };
+                    }
                     const resolved = ctx.openReleaseVersion
                         ? { bumpType: detectBumpType(ctx.changelogFragments), newVersion: ctx.openReleaseVersion }
-                        : resolveReleaseVersion(ctx.stableVersion, ctx.changelogFragments);
+                        : resolveReleaseVersion(ctx.stableVersion, ctx.changelogFragments, options);
                     if (!resolved) {
                         return { ok: false, reason: 'Не удалось вычислить release-версию от последнего стабильного тега.' };
                     }

package/src/release/version.js

@@ -1,4 +1,4 @@
-const { upVersion } = require('../common/version');
+const { upVersion, parseStableVersion } = require('../common/version');
 function detectBumpType(fragments) {
     const bumpTypes = new Set((fragments || []).map((fragment) => fragment.bump));
     if (bumpTypes.has('major')) {
@@ -10,8 +10,12 @@ function detectBumpType(fragments) {
     return 'patch';
 }
 
-function resolveReleaseVersion(stableVersion, fragments) {
-    const bumpType = detectBumpType(fragments);
+function resolveReleaseVersion(stableVersion, fragments, { stable = false } = {}) {
+    const baseline = parseStableVersion(stableVersion);
+    if (!baseline || (stable && baseline[0] !== 0)) return null;
+    const impact = detectBumpType(fragments);
+    // Initial development stays in 0.x until explicitly promoted to 1.0.0.
+    const bumpType = stable ? 'major' : baseline[0] === 0 && impact === 'major' ? 'minor' : impact;
     const newVersion = upVersion(stableVersion, bumpType);
     if (!newVersion) return null;
     return { bumpType, newVersion };