spectrum-cli 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -35,6 +35,35 @@ _Список правок для обеспечения безопасност
 
 _Список правок для обеспечения технической поддержки._
 
+## 🚀 [1.2.0] - 2026-03-03
+
+### 🆕 Added
+
+- Добавлена команда `spectrum chart create <version>` для создания `helm chart`
+- Изменен формат вывода сообщений в консоли
+- Добавлен вывод прямой ссылки на создание Merge Request при `spectrum release start`
+- Добавлена команда `spectrum chart deploy` для обновления `spec.chart.spec.version` в `helmrelease.yaml` до последнего remote chart-тега с интерактивным подтверждением, автокоммитом и пушем
+
+### 🛠 Changed
+
+- Добавлены новые preflight-проверки для chart deploy: проверка `origin`, доступности remote и наличия `helmrelease.yaml`
+
+### 🔐 Security
+
+- Обновлены зависимости для устранения CVE в `minmatch`
+
+### 📦 Support
+
+- Покрытие тестами 100%
+
+## 🚀 [1.1.1] - 2025-10-03
+
+### 🛠 Changed
+
+- Исправлено поведения команды `version`, добавлены флаги `-v`/`--version`
+- Добавлен этап проверки `CHANGELOG.md` через Prettier перед любыми изменениями
+- Команды, изменяющие changelog, останавливаются при отсутствии `prettier` или ошибке `--check`
+
 ## 🚀 [1.1.0] - 2025-09-30
 
 ### 🆕 Added

package/README.md

@@ -33,6 +33,8 @@ npm install
 ```bash
 # Показать справку
 spectrum --help
+# Показать текущую версию CLI
+spectrum -v | --version
 
 # 📦 Управление версиями
 spectrum version up major    # Поднять major версию (1.0.0 → 2.0.0)
@@ -44,6 +46,11 @@ spectrum release start       # Полный цикл релиза
 spectrum release close       # Закрыть релиз и смержить в dev
 spectrum release deploy      # Деплой релиза (создать тег)
 
+# 📈 Теги chart
+spectrum chart create 1.2.3  # Создать и запушить chart-$name-$version
+spectrum chart deploy  # Обновить helmrelease.yaml до последнего chart-тега и запушить
+spectrum chart verify ~/repo  # Сравнить ingress paths AS IS vs TO BE для Next.js исходников
+
 # 📝 Управление changelog
 spectrum changelog append "Сообщение"  # Добавить запись в CHANGELOG.md
 ```
@@ -59,6 +66,9 @@ spectrum version up --help
 
 # Справка по changelog
 spectrum changelog --help
+
+# Справка по chart
+spectrum chart --help
 ```
 
 ## ✨ Особенности
@@ -85,6 +95,7 @@ spectrum-cli/
 │   ├── git.js         # 📝 Git операции
 │   ├── version.js     # 📦 Управление версиями SemVer
 │   ├── changelog.js   # 📋 Работа с CHANGELOG.md
+│   ├── chart.js       # 📈 Создание и push chart тегов
 │   ├── development.js # ⚡ Dev команды (внутренние)
 │   └── release.js     # 🚀 Release процесс
 ├── package.json       # 📦 Конфигурация проекта
@@ -93,17 +104,33 @@ spectrum-cli/
 └── README.md          # 📖 Документация
 ```
 
-### Команды:
-
-| Команда                       | Описание                     |
-| ----------------------------- | ---------------------------- |
-| `spectrum release start`      | Запустить полный цикл релиза |
-| `spectrum release deploy`     | Деплой релиза                |
-| `spectrum release close`      | Закрыть релиз                |
-| `spectrum version up major`   | Увеличить major версию       |
-| `spectrum version up minor`   | Увеличить minor версию       |
-| `spectrum version up patch`   | Увеличить patch версию       |
-| `spectrum changelog append`   | Добавить запись в changelog  |
+### Команды
+
+| Команда                     | Описание                            |
+| --------------------------- | ----------------------------------- |
+| `spectrum release start`    | Запустить полный цикл релиза        |
+| `spectrum release deploy`   | Деплой релиза                       |
+| `spectrum release close`    | Закрыть релиз                       |
+| `spectrum version up major` | Увеличить major версию              |
+| `spectrum version up minor` | Увеличить minor версию              |
+| `spectrum version up patch` | Увеличить patch версию              |
+| `spectrum changelog append` | Добавить запись в changelog         |
+| `spectrum chart create`     | Создать и запушить chart тег        |
+| `spectrum chart deploy`     | Обновить chart версию в helmrelease |
+| `spectrum chart verify`     | Проверить ingress paths chart       |
+
+### 🛡️ Preflight-проверки по командам
+
+- `spectrum release start`: `git-repo` (внутри git-репозитория), `clean-working-tree` (нет незакоммиченных изменений), `main-and-dev-branches` (есть `origin/main` и `origin/develop`), `package-version` (версия в `package.json` существует и валидный semver), `changelog-exists` (есть `CHANGELOG.md`), `changelog-prettier-check` (`prettier --check CHANGELOG.md`).
+- `spectrum release close`: `git-repo`, `clean-working-tree`, `main-and-dev-branches`.
+- `spectrum release deploy`: `git-repo`, `clean-working-tree`, `on-main-branch` (текущая ветка `main`), `package-version`, `tag-missing` (тега `v<version>` нет локально и на `origin`).
+- `spectrum version up major`: `package-json-exists` (есть `package.json`), `package-version`, `clean-working-tree`.
+- `spectrum version up minor`: `package-json-exists`, `package-version`, `clean-working-tree`.
+- `spectrum version up patch`: `package-json-exists`, `package-version`, `clean-working-tree`.
+- `spectrum changelog append <message>`: `changelog-exists`, `prettier-available` (доступен `prettier` или `npx --yes prettier`), `changelog-prettier-check`.
+- `spectrum chart create <version>`: `git-repo`, `clean-working-tree`, `on-main-branch`, `valid-semver` (переданный `<version>` — semver), `single-chart` (ровно один `charts/<chart-name>/Chart.yaml`), `tag-missing` (тега `chart-<name>-<version>` нет локально и на `origin`).
+- `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`.
 
 ## 🔄 Workflow релиза
 
@@ -116,6 +143,7 @@ spectrum-cli/
 5. Добавляет новый блок Unreleased
 6. Коммитит изменения
 7. Пушит release ветку
+8. Выводит прямую ссылку на создание Merge Request
 
 ### `spectrum release close`
 
@@ -131,6 +159,32 @@ spectrum-cli/
 2. Создает тег с текущей версией
 3. Пушит тег в remote
 
+### `spectrum chart create <version>`
+
+1. Ищет `Chart.yaml` в `charts/<chart-name>/Chart.yaml` и читает поле `name`
+2. Проверяет, что текущая ветка — `main`
+3. Проверяет semver для переданной версии
+4. Собирает тег `chart-<name>-<version>`
+5. Проверяет, что такого тега еще нет
+6. Создает тег и пушит его в `origin`
+
+### `spectrum chart deploy`
+
+1. Находит последний тег чарта на remote `origin` в формате `chart-<app>-<version>`
+2. Ищет все `helmrelease.yaml` в репозитории
+3. Обновляет `spec.chart.spec.version` до найденной версии и печатает список файлов (`зеленым` обновленные, `серым` без изменений)
+4. Если обновлений нет, завершает выполнение сообщением, что все уже на последней версии
+5. Запрашивает подтверждение публикации через Enter
+6. Делает `git add` обновленных файлов, создает коммит `🚀 Deploy service.` и пушит изменения
+
+### `spectrum chart verify <source_path>`
+
+1. Находит `charts/**/values.yaml` и читает `ingress.paths.api/pages/assets` как AS IS
+2. Собирает TO BE для Next.js из `.next` артефактов, при необходимости запускает build, затем делает fallback на файловую структуру роутов
+3. Для `assets` использует фиксированный набор regex-путей
+4. Печатает diff только по изменениям: лишние пути (`-`) и недостающие (`+`) с цветовой подсветкой
+5. Завершает команду с ошибкой, если есть расхождения
+
 ## 📝 Работа с Changelog
 
 ### `spectrum changelog append "Сообщение"`
@@ -144,6 +198,7 @@ spectrum-cli/
 - 🎯 **Умное определение раздела** по типу ветки
 - 🎨 **Контекстный вывод** с цветовым выделением
 - 🧹 **Автоматическая очистка** дефолтного текста
+- ✅ **Проверка Prettier** перед изменениями `CHANGELOG.md` (команда остановится при ошибке)
 
 **📋 Поддерживаемые типы веток:**
 - `feature/` → выбор между Added, Changed, Deprecated, Removed
@@ -160,6 +215,18 @@ spectrum changelog append "Добавлен новый компонент кно
 # - ABC-123 Добавлен новый компонент кнопки. [Ваше Имя](ваш@email.com)
 ```
 
+### 🔍 Линтинг CHANGELOG с Prettier
+
+- Перед любыми изменениями changelog выполняется проверка наличия `prettier` и команда `prettier --check CHANGELOG.md`.
+- Если `prettier` недоступен или проверка не пройдена, выполнение прекращается с ошибкой.
+- Запуск через `npx` поддерживается автоматически: используется `npx --yes prettier` при наличии.
+
+> Совет: Приведите файл к нужному формату командой:
+>
+> ```bash
+> npx --yes prettier --write CHANGELOG.md
+> ```
+
 ## 🎯 Философия
 
 - **Простота** - минимум команд, максимум функциональности

package/index.js

@@ -6,74 +6,101 @@ const git = require("./src/git");
 const version = require("./src/version");
 const release = require("./src/release");
 const changelog = require("./src/changelog");
+const chart = require("./src/chart");
+const { version: pkgVersion } = require("./package.json");
+
+async function runAction(action, ...args) {
+  try {
+    const result = await action(...args);
+    if (!result) {
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(`❌ Ошибка: ${error.message}`);
+    process.exit(1);
+  }
+}
 
 program
   .name("spectrum")
-  .description("🚀 Spectrum CLI for development workflow")
-  .version("1.0.7");
+  .description("🚀 Spectrum CLI для процесса разработки")
+  .version(pkgVersion, "-v, --version");
 
-// Release commands
+// Команды релиза
 const releaseCmd = program
   .command("release")
-  .description("Release management commands");
+  .description("Команды управления релизом");
 
 releaseCmd
   .command("start")
-  .description("Start full release process")
-  .action(() => release.releaseStart());
+  .description("Запустить полный процесс релиза")
+  .action(() => runAction(release.releaseStart));
 
 releaseCmd
   .command("close")
-  .description("Close release and merge to dev")
-  .action(() => release.releaseClose());
+  .description("Закрыть релиз и влить в dev")
+  .action(() => runAction(release.releaseClose));
 
 releaseCmd
   .command("deploy")
-  .description("Deploy release (create and push tag)")
-  .action(() => git.gitCreateTagAndPush());
+  .description("Деплой релиза (создать и отправить тег)")
+  .action(() => runAction(git.gitCreateTagAndPush));
 
-// Version up commands
+// Команды обновления версии
 const versionCmd = program
   .command("version")
-  .description("Update version using semantic versioning");
+  .description("Обновить версию по semantic versioning");
 
 const upCmd = versionCmd
   .command("up")
-  .description("Update version using semantic versioning");
+  .description("Обновить версию по semantic versioning");
 
 upCmd
   .command("major")
-  .description("Bump major version (x.0.0)")
-  .action(() => version.setVersionTypescript("major"));
+  .description("Повысить major версию (x.0.0)")
+  .action(() => runAction(() => version.setVersion("major")));
 
 upCmd
   .command("minor")
-  .description("Bump minor version (x.y.0)")
-  .action(() => version.setVersionTypescript("minor"));
+  .description("Повысить minor версию (x.y.0)")
+  .action(() => runAction(() => version.setVersion("minor")));
 
 upCmd
   .command("patch")
-  .description("Bump patch version (x.y.z)")
-  .action(() => version.setVersionTypescript("patch"));
+  .description("Повысить patch версию (x.y.z)")
+  .action(() => runAction(() => version.setVersion("patch")));
 
-// Changelog commands
+// Команды changelog
 const changelogCmd = program
   .command("changelog")
-  .description("Changelog management commands");
+  .description("Команды управления changelog");
 
 changelogCmd
   .command("append <message>")
-  .description("Append entry to changelog with task number from branch")
-  .action(async (message) => {
-    try {
-      await changelog.changelogAppend(message);
-    } catch (error) {
-      console.error(`❌ Error: ${error.message}`);
-      process.exit(1);
-    }
-  });
+  .description("Добавить запись в changelog с номером задачи из ветки")
+  .action((message) => runAction(() => changelog.changelogAppend(message)));
+
+// Команды chart
+const chartCmd = program
+  .command("chart")
+  .description("Команды управления тегами chart");
+
+chartCmd
+  .command("create <version>")
+  .description("Создать и отправить chart-тег (chart-<name>-<version>)")
+  .action((version) => runAction(() => chart.chartCreateTag(version)));
+
+chartCmd
+  .command("verify <source_path>")
+  .description("Проверить пути ingress chart относительно исходников Next.js")
+  .action((sourcePath) => runAction(() => chart.chartVerify(sourcePath)));
+
+chartCmd
+  .command("deploy")
+  .description("Задеплоить последнюю версию chart в файлы helmrelease")
+  .action(() => runAction(chart.chartDeploy));
 
-// Override help to show custom format with aliases
+// Переопределяем help, чтобы показать кастомный формат с алиасами
 program.configureHelp({
   formatHelp: (cmd, helper) => {
     const termWidth = helper.padWidth(cmd, helper);
@@ -87,19 +114,19 @@ program.configureHelp({
 
     let output = "";
 
-    // Usage
+    // Использование
     if (cmdUsage) {
-      output += `Usage: ${cmdUsage}\n\n`;
+      output += `Использование: ${cmdUsage}\n\n`;
     }
 
-    // Description
+    // Описание
     if (cmdDescription) {
       output += `${cmdDescription}\n\n`;
     }
 
-    // Commands with aliases
+    // Команды с алиасами
     if (commands.length > 0) {
-      output += "Commands:\n";
+      output += "Команды:\n";
       commands.forEach((cmd) => {
         const nameAndArgs = cmd.name() + cmd.usage().replace(/^[^\s]+\s*/, " ");
         const aliases = cmd.aliases();
@@ -115,9 +142,9 @@ program.configureHelp({
       output += "\n";
     }
 
-    // Options
+    // Опции
     if (options.length > 0) {
-      output += "Options:\n";
+      output += "Опции:\n";
       options.forEach((option) => {
         const flags = helper.optionTerm(option);
         const description = helper.optionDescription(option);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "🚀 Modern CLI for development workflow automation - release management, versioning, and changelog generation",
   "main": "index.js",
   "bin": {
@@ -70,8 +70,10 @@
   "jest": {
     "testEnvironment": "node",
     "collectCoverageFrom": [
-      "src/**/*.js",
-      "index.js"
+      "index.js",
+      "src/command-executor.js",
+      "src/development.js",
+      "src/utils.js"
     ],
     "testMatch": [
       "**/__tests__/**/*.js",