spectrum-cli 5.0.0 → 5.0.2

package/CHANGELOG.md

@@ -9,6 +9,28 @@ 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
+
+- Команды `spectrum chart` читают токен для Helm-registry из переменной окружения `SC_OWNER_PAT` вместо `GITLAB_PRIVATE_TOKEN`.
+- Команда `spectrum token rotate` запрашивает и записывает в CI/CD variables `SC_BOT_PAT` вместо `GITLAB_PRIVATE_TOKEN`.
+- `spectrum chart deploy` выводит строки изменений helmrelease-файлов с отступом.
+
+### 🪲 Fixed
+
+- Запрос к Helm-registry GitLab авторизуется через HTTP Basic auth; заголовок `PRIVATE-TOKEN` приводил к HTTP 401.
+- Проверка публикации чарта находит версию в `index.yaml` GitLab, где элементы списка записаны без дополнительного отступа; `chart start` больше не ждёт бесконечно уже опубликованную версию.
+- Версия чарта читается из заголовка changelog со ссылкой вида `## [X.Y.Z](url) - YYYY-MM-DD`.
+
 ## 🚀 [5.0.0] - 2026-10-01
 
 ### 💥 Breaking change

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
 
@@ -66,7 +66,7 @@ spectrum changelog check               # Проверить CHANGELOG.md и вс
 spectrum changelog write               # Выравнять заголовки CHANGELOG.md и запустить Prettier
 
 # 🔑 GitLab токены
-spectrum token rotate  # Пролить GITLAB_PRIVATE_TOKEN в CI variables
+spectrum token rotate  # Пролить SC_BOT_PAT в CI variables
 ```
 
 Все команды с действием показывают, какая предпроверка успешно пройдена;
@@ -163,7 +163,7 @@ spectrum-cli/
 | `spectrum chart start`      | Создать и запушить chart тег        |
 | `spectrum chart deploy`     | Обновить chart версию в helmrelease |
 | `spectrum chart verify`     | Проверить ingress paths chart       |
-| `spectrum token rotate`     | Пролить GITLAB_PRIVATE_TOKEN в CI   |
+| `spectrum token rotate`     | Пролить SC_BOT_PAT в CI             |
 
 ### 🛡️ Preflight-проверки по командам
 
@@ -172,10 +172,17 @@ 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 нужен `GITLAB_PRIVATE_TOKEN`; ошибка доступа блокирует команду. `-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 и `GITLAB_PRIVATE_TOKEN` только в памяти), `check-access` (все группы и проекты доступны owner PAT).
+- `spectrum token rotate`: `load-config` (есть валидный `~/.config/spectrum-cli/config.yaml`), `ask-tokens` (owner PAT и `SC_BOT_PAT` только в памяти), `check-access` (все группы и проекты доступны owner PAT).
 
 ## 🔄 Workflow релиза
 
@@ -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 уже формируют следующий релиз. Изменение
 опубликованной истории и конфликтующие открытые версии блокируют команду.
@@ -324,7 +344,7 @@ CI-часть реализует подключенный release component, а
 
 ### `spectrum token rotate`
 
-Пролив уже созданного PAT `GITLAB_PRIVATE_TOKEN` в CI/CD variables групп и проектов. Команда токен не выпускает.
+Пролив уже созданного PAT `SC_BOT_PAT` в CI/CD variables групп и проектов. Команда токен не выпускает.
 
 **Конфиг:** `~/.config/spectrum-cli/config.yaml`
 
@@ -340,13 +360,13 @@ projects: []
 - `bot` и `token_ttl_months` читаются только из конфига.
 - Скрытым вводом запрашиваются два токена. Оба живут только в памяти.
 - Owner PAT: ходит в API, проверяет доступ, читает/удаляет/создает CI variables. Для групп нужен Owner, для проектов — Maintainer+.
-- `GITLAB_PRIVATE_TOKEN`: только значение, которое пишется в CI variable.
-- Для каждой группы и проекта CI variable `GITLAB_PRIVATE_TOKEN` удаляется (если есть) и создается заново как masked and hidden.
+- `SC_BOT_PAT`: только значение, которое пишется в CI variable.
+- Для каждой группы и проекта CI variable `SC_BOT_PAT` удаляется (если есть) и создается заново как masked and hidden.
 - Description переменной: `PAT от бота <bot>, владелец Колосов. Истекает YYYY-MM-DD.` Дата = сегодня + `token_ttl_months`.
 
 1. Загружает или создает конфиг
 2. Запрашивает owner PAT
-3. Запрашивает `GITLAB_PRIVATE_TOKEN`
+3. Запрашивает `SC_BOT_PAT`
 4. Проверяет доступ ко всем группам и проектам owner PAT
 5. Обновляет CI variables во всех целях
 
@@ -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.0",
+  "version": "5.0.2",
   "description": "🚀 Modern CLI for development workflow automation - release management, versioning, and changelog generation",
   "main": "index.js",
   "bin": {

package/src/chart/helmrelease.js

@@ -72,7 +72,7 @@ function printDeployChanges(changes) {
         const icon = item.changed ? '●' : '○';
         const color = item.changed ? colors.green : '\x1b[90m';
         console.log(
-            `${color}${icon} ${item.filePath}: ${item.oldVersion} -> ${item.newVersion}${colors.reset}`
+            `  ${color}${icon} ${item.filePath}: ${item.oldVersion} -> ${item.newVersion}${colors.reset}`
         );
     });
 }

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));
@@ -60,7 +61,8 @@ function helmIndexHasChartVersion(indexYamlContent, chartName, version) {
             continue;
         }
 
-        if (inChart && indent <= chartIndent) {
+        const isChartSequenceItem = indent === chartIndent && trimmed.startsWith('-');
+        if (inChart && indent <= chartIndent && !isChartSequenceItem) {
             inChart = false;
         }
 
@@ -77,24 +79,32 @@ function helmIndexHasChartVersion(indexYamlContent, chartName, version) {
     return false;
 }
 
+function buildBasicAuthHeader(accessToken) {
+    return `Basic ${Buffer.from(`token:${accessToken}`).toString('base64')}`;
+}
+
 async function fetchChartVersionFromRegistry(chartName, version) {
     const project = getGitlabProject();
     if (!project) {
         return { ok: false, reason: 'Не удалось определить GitLab-проект из remote "origin".' };
     }
 
-    const accessToken = process.env.GITLAB_PRIVATE_TOKEN;
+    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: 'Не задана переменная окружения GITLAB_PRIVATE_TOKEN. Она нужна для проверки публикации чарта в Helm-registry.'
+            reason: 'Не задана переменная окружения SC_DEVELOPER_PAT. Она нужна для проверки публикации чарта в Helm-registry.'
         };
     }
 
     const indexUrl = `${project.origin}/api/v4/projects/${project.encodedPath}/packages/helm/${HELM_REGISTRY_CHANNEL}/index.yaml`;
     let response;
     try {
-        response = await fetch(indexUrl, { headers: { 'PRIVATE-TOKEN': accessToken } });
+        response = await fetch(indexUrl, { headers: { Authorization: buildBasicAuthHeader(accessToken) } });
     } catch (error) {
         return { ok: false, reason: `Не удалось запросить Helm-registry (${indexUrl}): ${error.message}.` };
     }

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));
@@ -127,7 +128,7 @@ const tokenCmd = program
 
 tokenCmd
   .command("rotate")
-  .description("Пролить GITLAB_PRIVATE_TOKEN в CI variables через owner PAT")
+  .description("Пролить SC_BOT_PAT в CI variables через owner PAT")
   .option("-d, --dry", "Запустить только предпроверки")
   .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
   .action((command) => runAction(token.tokenRotate, command));

package/src/preflight/chart.js

@@ -15,7 +15,7 @@ function requireChartChangelogVersion(chartDir) {
     }
 
     const firstHeading = changelog.match(/^##(?!#)[^\r\n]*$/m)?.[0];
-    const version = firstHeading?.match(/^##\s+(?:\S+\s+)?\[([^\]]+)\](?:\s|$)/)?.[1];
+    const version = firstHeading?.match(/^##\s+(?:\S+\s+)?\[([^\]]+)\](?:\([^)\s]*\))?(?:\s|$)/)?.[1];
     if (!version || !SEMVER_PATTERN.test(version)) {
         return fail(`Верхний раздел "${changelogPath}" должен содержать версию SemVer в заголовке "## [X.Y.Z]".`);
     }

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 };

package/src/token/config.js

@@ -4,7 +4,7 @@ const path = require('path');
 const { logSuccess } = require('../common/utils');
 const { isDryRun } = require('../cli/command-executor');
 const { parseGitlabUrl } = require('../integrations/gitlab-url');
-const TOKEN_NAME = 'GITLAB_PRIVATE_TOKEN';
+const TOKEN_NAME = 'SC_BOT_PAT';
 
 function getConfigPath() {
     return path.join(os.homedir(), '.config', 'spectrum-cli', 'config.yaml');