spectrum-cli 4.0.0 → 5.0.1

package/CHANGELOG.md

@@ -9,6 +9,26 @@ 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.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
+
+- Fragment `.changelog/*.removed.md` теперь повышает версию приложения до следующего major-релиза вместо patch. Такой fragment нельзя включить в hotfix; для него нужен обычный релиз.
+
 ## 🚀 [4.0.0] - 2026-10-01
 
 ### 💥 Breaking change

package/README.md

@@ -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,10 @@ 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_OWNER_PAT`; ошибка доступа блокирует команду. `-f, --force` обходит только проверку повышения версии относительно последнего remote-тега. После push команда по умолчанию ждёт версию в registry; `-n, --no-wait` отключает ожидание.
 - `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,7 +185,7 @@ 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` → major, `added` → minor, остальные → patch. Если раздел уже открыт в main/master, сохраняет его версию и дату, объединяет прежние записи с новыми по разделам без дублей. Тип новых fragments не повышает уже выбранную версию.
+3. Если открытого релиза нет, вычисляет версию по fragments: `breaking` и `removed` → major, `added` → minor, остальные → patch. Если раздел уже открыт в main/master, сохраняет его версию и дату, объединяет прежние записи с новыми по разделам без дублей. Тип новых fragments не повышает уже выбранную версию.
 4. Форматирует и проверяет `CHANGELOG.md`, затем удаляет использованные fragments.
 5. Коммитит изменения и атомарно пушит dev в `origin/dev` и `origin/main` или `origin/master`, без Merge Request. Если новых записей нет, пустой коммит не создаётся; можно повторить отправку после её сбоя.
 
@@ -229,14 +229,14 @@ spectrum-cli/
 или `origin/master`, либо работайте прямо в актуальной production-ветке
 `main/master`. Включайте только срочное исправление и его patch fragments
 (`fixed`, `security`, `support` либо другой совместимый patch-тип).
-`added` и `breaking` требуют обычного релиза. Все команды запускаются из корня
+`added`, `breaking` и `removed` требуют обычного релиза. Все команды запускаются из корня
 репозитория; для `start` нужен Prettier, как для обычной сборки changelog.
 
 1. **`spectrum hotfix start`** обновляет сведения об origin и выбирает опубликованный
    stable-тег, достижимый из production. Цель — этот stable плюс один patch.
    Как и `release start`, команда читает все файлы текущей `.changelog/` независимо
    от того, когда они попали в Git. Проверяет их общими правилами changelog и
-   допускает только patch-типы; файлы `added` и `breaking` требуют обычного релиза.
+   допускает только patch-типы; файлы `added`, `breaking` и `removed` требуют обычного релиза.
    Формат CHANGELOG.md проверяется только в текущей ветке. История может отличаться
    от stable-тега: её исправления не блокируют хотфикс. Снимок production используется
    для сохранения записей уже подготовленного хотфикса, без строгой проверки старых заголовков.
@@ -324,7 +324,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 +340,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 во всех целях
 
@@ -381,8 +381,9 @@ projects: []
 | Суффикс | Раздел | Повышение версии |
 | --- | --- | --- |
 | `breaking` | Breaking change | major |
+| `removed` | Removed | major |
 | `added` | Added | minor |
-| `changed`, `deprecated`, `removed` | Соответствующий раздел | patch |
+| `changed`, `deprecated` | Соответствующий раздел | patch |
 | `fixed`, `security`, `support` | Соответствующий раздел | patch |
 
 **📌 Пример использования:**

package/package.json

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

package/src/changelog/config.js

@@ -8,7 +8,7 @@ const FRAGMENT_TYPES = Object.freeze({
     added: Object.freeze({ section: '### 🆕 Added', bump: 'minor' }),
     changed: Object.freeze({ section: '### 🛠 Changed', bump: 'patch' }),
     deprecated: Object.freeze({ section: '### 📜 Deprecated', bump: 'patch' }),
-    removed: Object.freeze({ section: '### 🗑 Removed', bump: 'patch' }),
+    removed: Object.freeze({ section: '### 🗑 Removed', bump: 'major' }),
     fixed: Object.freeze({ section: '### 🪲 Fixed', bump: 'patch' }),
     security: Object.freeze({ section: '### 🔐 Security', bump: 'patch' }),
     support: Object.freeze({ section: '### 📦 Support', bump: 'patch' })

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

@@ -60,7 +60,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 +78,28 @@ 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_OWNER_PAT;
     if (!accessToken) {
         return {
             ok: false,
-            reason: 'Не задана переменная окружения GITLAB_PRIVATE_TOKEN. Она нужна для проверки публикации чарта в Helm-registry.'
+            reason: 'Не задана переменная окружения SC_OWNER_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

@@ -127,7 +127,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/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');