spectrum-cli 3.1.1 → 4.0.0

package/src/chart/verify.js

@@ -0,0 +1,166 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const { logSuccess, logError, colors } = require('../common/utils');
+const { runCommand } = require('../cli/command-executor');
+const { requireGitRepo, requireCurrentBranchUpToDateWithRemote, requireSingleValuesYaml, requireIngressPathSections, requireSourcePathDirectory, requireNextProject, requireBuildCommandSupport } = require('../preflight');
+const { normalizeList, normalizeToBeList, collectRoutesFromFilesystem, collectRoutesFromBuildArtifacts } = require('./routes');
+const FIXED_ASSET_PATHS = [
+    '/_next/image$',
+    '/_next/static/media/[a-z0-9_\\.\\-]+\\.(woff|woff2|ttf|otf|eot)$',
+    '/_next/static/chunks/[a-z0-9_\\.\\-]+\\.(css|js)$',
+    '/_next/static/[a-zA-Z0-9_-]+/_ssgManifest.js$',
+    '/_next/static/[a-zA-Z0-9_-]+/_buildManifest.js$',
+    '/_next/static/[a-zA-Z0-9_-]+/_clientMiddlewareManifest.json$',
+    '/[^?]+\\.(?:ico|svg|png|jpg|jpeg|gif|webp|txt|map)$'
+];
+
+function runBuildInSourcePath(sourcePath, packageManager) {
+    const manager = packageManager || 'npm';
+    const hasNodeModules = fs.existsSync(path.join(sourcePath, 'node_modules'));
+    const hasPackageLock = fs.existsSync(path.join(sourcePath, 'package-lock.json'));
+    const hasYarnLock = fs.existsSync(path.join(sourcePath, 'yarn.lock'));
+    const hasBunLock = fs.existsSync(path.join(sourcePath, 'bun.lockb'));
+    const installCommand = manager === 'yarn'
+        ? (hasYarnLock ? 'yarn install --frozen-lockfile' : 'yarn install')
+        : manager === 'bun'
+            ? 'bun install'
+            : (hasPackageLock ? 'npm ci' : 'npm install');
+    const buildCommand = manager === 'yarn' ? 'yarn build' : manager === 'bun' ? 'bun run build' : 'npm run build';
+
+    try {
+        if (!hasNodeModules) {
+            execSync(installCommand, { cwd: sourcePath, stdio: 'pipe', timeout: 600000 });
+        } else if (!hasPackageLock && !hasYarnLock && !hasBunLock) {
+            execSync(installCommand, { cwd: sourcePath, stdio: 'pipe', timeout: 600000 });
+        }
+
+        execSync(buildCommand, { cwd: sourcePath, stdio: 'pipe', timeout: 900000 });
+        return true;
+    } catch (error) {
+        return false;
+    }
+}
+
+function buildGitLikeDiff(asIsList, toBeList, title) {
+    const asIs = normalizeList(asIsList);
+    const toBe = normalizeList(toBeList);
+    const asIsSet = new Set(asIs);
+    const toBeSet = new Set(toBe);
+    const removed = asIs.filter((item) => !toBeSet.has(item));
+    const added = toBe.filter((item) => !asIsSet.has(item));
+    const unchanged = asIs.filter((item) => toBeSet.has(item));
+
+    const lines = [
+        `--- AS_IS/${title}`,
+        `+++ TO_BE/${title}`,
+        `@@ ${title} @@`
+    ];
+    removed.forEach((item) => lines.push(`-${item}`));
+    added.forEach((item) => lines.push(`+${item}`));
+    if (removed.length === 0 && added.length === 0) {
+        lines.push('  (no changes)');
+    }
+
+    return {
+        removed,
+        added,
+        unchanged,
+        text: lines.join('\n')
+    };
+}
+
+function printSection(title, asIsList, toBeList) {
+    const asIs = normalizeList(asIsList);
+    const toBe = normalizeList(toBeList);
+    const diff = buildGitLikeDiff(asIs, toBe, title);
+
+    console.log(`\nСравнение путей ${title} (КАК ЕСТЬ -> КАК ДОЛЖНО БЫТЬ):`);
+    console.log(`--- AS_IS/${title}`);
+    console.log(`+++ TO_BE/${title}`);
+    console.log(`@@ ${title} @@`);
+    if (diff.removed.length === 0 && diff.added.length === 0) {
+        console.log('  (без изменений)');
+    } else {
+        diff.removed.forEach((item) => console.log(`${colors.yellow}-${item}${colors.reset}`));
+        diff.added.forEach((item) => console.log(`${colors.red}+${item}${colors.reset}`));
+    }
+    console.log(`${title} сводка: добавлено=${diff.added.length}, удалено=${diff.removed.length}, без изменений=${diff.unchanged.length}`);
+
+    return diff;
+}
+
+function chartVerify(sourcePath) {
+    return runCommand({
+        name: 'chart verify',
+        checks: [
+            { name: 'git-repo', run: requireGitRepo },
+            { name: 'branch-up-to-date', run: requireCurrentBranchUpToDateWithRemote },
+            { name: 'single-values-yaml', run: requireSingleValuesYaml },
+            { name: 'values-ingress-sections', requires: ['valuesYamlPath'], run: (ctx) => requireIngressPathSections(ctx.valuesYamlPath) },
+            { name: 'source-path-directory', run: () => requireSourcePathDirectory(sourcePath) },
+            { name: 'next-project', requires: ['sourcePath'], run: (ctx) => requireNextProject(ctx.sourcePath) },
+            { name: 'build-command-support', requires: ['sourcePath'], run: (ctx) => requireBuildCommandSupport(ctx.sourcePath) }
+        ],
+        steps: [
+            {
+                name: 'collect-routes',
+                run: (ctx) => {
+                    const fromBuild = collectRoutesFromBuildArtifacts(ctx.sourcePath);
+                    let api = normalizeList(fromBuild.api);
+                    let pages = normalizeList(fromBuild.pages);
+
+                    if (api.length === 0 || pages.length === 0) {
+                        const didBuild = runBuildInSourcePath(ctx.sourcePath, ctx.sourcePackageManager);
+                        if (didBuild) {
+                            logSuccess('🛠️', 'Сборка успешно завершена в %s.', ctx.sourcePath);
+                            const rebuilt = collectRoutesFromBuildArtifacts(ctx.sourcePath);
+                            api = normalizeList(api.concat(rebuilt.api));
+                            pages = normalizeList(pages.concat(rebuilt.pages));
+                        } else {
+                            logError('⚠️', 'Сборка в %s не удалась. Переходим к маршрутам из файловой системы.', ctx.sourcePath);
+                        }
+                    }
+
+                    const fromFs = collectRoutesFromFilesystem(ctx.sourcePath);
+                    api = normalizeList(api.concat(fromFs.api));
+                    pages = normalizeList(pages.concat(fromFs.pages));
+
+                    ctx.toBeIngressPaths = {
+                        api: normalizeToBeList(api),
+                        pages: normalizeToBeList(pages),
+                        assets: normalizeToBeList(FIXED_ASSET_PATHS)
+                    };
+                    return true;
+                }
+            },
+            {
+                name: 'compare-and-report',
+                run: (ctx) => {
+                    const asIs = ctx.valuesIngressPaths || { api: [], pages: [], assets: [] };
+                    const toBe = ctx.toBeIngressPaths || { api: [], pages: [], assets: [] };
+
+                    const apiDiff = printSection('api', asIs.api, toBe.api);
+                    const pagesDiff = printSection('pages', asIs.pages, toBe.pages);
+                    const assetsDiff = printSection('assets', asIs.assets, toBe.assets);
+
+                    const hasChanges = (
+                        apiDiff.added.length + apiDiff.removed.length +
+                        pagesDiff.added.length + pagesDiff.removed.length +
+                        assetsDiff.added.length + assetsDiff.removed.length
+                    ) > 0;
+
+                    if (hasChanges) {
+                        logError('❌', 'Обнаружены различия.');
+                        return false;
+                    }
+
+                    logSuccess('✅', 'КАК ЕСТЬ совпадает с КАК ДОЛЖНО БЫТЬ.');
+                    return true;
+                }
+            }
+        ]
+    });
+}
+
+module.exports = { chartVerify, buildGitLikeDiff };

package/src/cli/command-executor.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+const { logError, logSuccess } = require('../common/utils');
+const { AsyncLocalStorage } = require('async_hooks');
+
+const commandContext = new AsyncLocalStorage();
+
+const PREFLIGHT_DESCRIPTIONS = Object.freeze({
+    'git-repo': 'текущий каталог находится в Git-репозитории',
+    'clean-working-tree': 'рабочее дерево Git чистое',
+    'branch-up-to-date': 'текущая ветка не отстаёт от upstream',
+    'main-and-dev-branches': 'найдены production- и integration-ветки',
+    'on-main-branch': 'выбрана production-ветка main/master',
+    'on-dev-branch': 'выбрана integration-ветка dev/develop',
+    'dev-contains-main': 'integration-ветка содержит актуальную production-ветку',
+    'stable-version': 'найден последний стабильный тег production',
+    'changelog-exists': 'найден CHANGELOG.md',
+    'release-state': 'состояние опубликованных и открытых релизов согласовано',
+    'changelog-prettier-check': 'CHANGELOG.md проходит проверку Prettier',
+    'changelog-fragments': 'проверены changelog fragments и их формат',
+    'detect-bump-type': 'определена целевая версия и проверена её доступность',
+    'changelog-release-version': 'прочитана стабильная версия из CHANGELOG.md',
+    'stable-tag-at-head': 'стабильный тег указывает на текущий commit',
+    'prettier-available': 'Prettier доступен',
+    'prepare-fragment': 'проверены ветка, ID задачи, Git identity и раздел fragment',
+    'single-chart': 'найден ровно один Chart.yaml с именем чарта',
+    'chart-changelog-version': 'версия прочитана из верхнего заголовка changelog чарта',
+    'tag-missing': 'целевой тег отсутствует локально и на origin',
+    'version-not-downgrade': 'версия сопоставлена с последним chart-тегом на origin',
+    'registry-version-missing': 'целевая версия чарта отсутствует в Helm-registry',
+    'remote-origin': 'настроен remote origin',
+    'remote-reachable': 'remote origin доступен',
+    'helmrelease-files': 'найдены файлы helmrelease.yaml',
+    'filter-instances': 'параметр --instances проверен (или не задан)',
+    'single-values-yaml': 'найден единственный values.yaml чарта',
+    'values-ingress-sections': 'найдены секции ingress paths',
+    'source-path-directory': 'исходный каталог существует',
+    'next-project': 'исходники принадлежат Next.js-проекту',
+    'build-command-support': 'доступна команда сборки проекта',
+    'load-config': 'конфигурация ротации токена загружена и проверена',
+    'ask-tokens': 'необходимые токены получены без вывода их значений',
+    'check-access': 'проверен доступ к целевым группам и проектам GitLab'
+});
+
+function describePreflight(checkName, context) {
+    const description = PREFLIGHT_DESCRIPTIONS[checkName] || checkName;
+    const details = {
+        'branch-up-to-date': context.currentBranch,
+        'stable-version': context.stableVersion,
+        'changelog-release-version': context.version,
+        'detect-bump-type': context.newVersion,
+        'single-chart': context.chartName,
+        'chart-changelog-version': context.version,
+        'changelog-fragments': Array.isArray(context.changelogFragments)
+            ? `${context.changelogFragments.length} файл(ов)` : null,
+        'helmrelease-files': Array.isArray(context.helmReleaseFiles)
+            ? `${context.helmReleaseFiles.length} файл(ов)` : null
+    }[checkName];
+    return details ? `${description}: ${details}` : description;
+}
+
+function withCommandOptions(options, action) {
+    return commandContext.run({ dry: Boolean(options?.dry), silence: Boolean(options?.silence) }, action);
+}
+
+function withDryRun(dry, action) {
+    return withCommandOptions({ dry }, action);
+}
+
+function isDryRun() {
+    return Boolean(commandContext.getStore()?.dry);
+}
+
+function reportDryRun(_name) {
+    logSuccess('✅', 'Все предпроверки пройдены, проблем нет. Действия не выполнялись.');
+}
+
+function reportPreflight(_commandName, checkName, description = PREFLIGHT_DESCRIPTIONS[checkName] || checkName) {
+    if (!commandContext.getStore()?.silence) {
+        logSuccess('🔎', 'Проверено (%s): %s.', checkName, description);
+    }
+}
+
+function reportNoPreflights(_name) {
+    logSuccess('🔎', 'Предпроверок нет.');
+}
+
+function normalizeCheckResult(result, fallbackReason) {
+    if (typeof result === 'boolean') {
+        return { ok: result, reason: result ? null : fallbackReason };
+    }
+
+    if (typeof result === 'string') {
+        return { ok: false, reason: result };
+    }
+
+    if (result && typeof result === 'object') {
+        return {
+            ok: Boolean(result.ok),
+            reason: result.reason || fallbackReason,
+            data: result.data
+        };
+    }
+
+    return { ok: false, reason: fallbackReason };
+}
+
+async function runCommand(spec) {
+    const {
+        name,
+        checks = [],
+        steps = [],
+        context = {}
+    } = spec || {};
+
+    if (!name) {
+        logError('❌', 'Требуется имя команды.');
+        return false;
+    }
+
+    let failedPreflights = 0;
+    const results = new Map();
+    for (const check of checks) {
+        const checkName = check.name || 'unknown-check';
+        const failedDependencies = (check.dependsOn || []).filter((dependency) => results.get(dependency) !== true);
+        const missingInputs = (check.requires || []).filter((key) => context[key] === undefined || context[key] === null);
+        if (failedDependencies.length || missingInputs.length) {
+            const reason = [
+                failedDependencies.length ? `не пройдены проверки: ${failedDependencies.join(', ')}` : null,
+                missingInputs.length ? `отсутствуют данные: ${missingInputs.join(', ')}` : null
+            ].filter(Boolean).join('; ');
+            logError('❌', 'Предпроверка не выполнена (%s): %s', checkName, reason);
+            results.set(checkName, false);
+            failedPreflights += 1;
+            continue;
+        }
+
+        let checkResult;
+        try {
+            checkResult = normalizeCheckResult(
+                await check.run(context),
+                `Проверка не пройдена: ${checkName}`
+            );
+        } catch (error) {
+            checkResult = { ok: false, reason: error?.message || String(error) };
+        }
+
+        if (!checkResult.ok) {
+            logError('❌', 'Предпроверка не пройдена (%s): %s', checkName, checkResult.reason || 'неизвестная причина');
+            results.set(checkName, false);
+            failedPreflights += 1;
+            continue;
+        }
+
+        results.set(checkName, true);
+        if (checkResult.data && typeof checkResult.data === 'object') {
+            Object.assign(context, checkResult.data);
+        }
+        reportPreflight(name, checkName, check.description || describePreflight(checkName, context));
+    }
+
+    if (failedPreflights > 0) return false;
+
+    if (isDryRun()) {
+        reportDryRun(name);
+        return true;
+    }
+
+    for (const step of steps) {
+        const stepName = step.name || 'unknown-step';
+        const ok = await step.run(context);
+        if (!ok) {
+            logError('❌', 'Шаг не выполнен: %s', stepName);
+            return false;
+        }
+    }
+
+    logSuccess('✅', 'Выполнено.');
+    return true;
+}
+
+module.exports = { runCommand, withCommandOptions, withDryRun, isDryRun, reportDryRun, reportPreflight, reportNoPreflights };

package/src/cli/commands.js

@@ -0,0 +1,136 @@
+const git = require('../git');
+const release = require('../release');
+const hotfix = require('../hotfix');
+const changelog = require('../changelog');
+const chart = require('../chart');
+const token = require('../token');
+const { upgrade } = require('./update-check');
+const { version: pkgVersion } = require('../../package.json');
+const { runAction } = require('./run-action');
+
+function registerCommands(program) {
+program
+  .name("spectrum")
+  .description("🚀 Spectrum CLI для процесса разработки")
+  .version(pkgVersion, "-v, --version");
+
+program
+  .command("upgrade")
+  .description("Обновить Spectrum CLI через npm install -g spectrum-cli")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(upgrade, command));
+
+// Команды релиза
+const releaseCmd = program
+  .command("release")
+  .description("Команды управления релизом");
+
+releaseCmd
+  .command("start")
+  .description("Схлопнуть fragments и атомарно отправить release commit в dev и main/master")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(release.releaseStart, command));
+
+releaseCmd
+  .command("close")
+  .description("Свести стабильный релиз из main/master в dev")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(release.releaseClose, command));
+
+releaseCmd
+  .command("deploy")
+  .description("Создать и отправить только стабильный тег release/X.Y.Z")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(git.gitCreateTagAndPush, command));
+
+const hotfixCmd = program.command("hotfix").description("Изолированный цикл срочного patch-релиза");
+
+hotfixCmd.command("start")
+  .description("Подготовить 🩹 CHANGELOG на hotfix/* или main/master, без commit, push и merge")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(hotfix.hotfixStart, command));
+hotfixCmd.command("deploy")
+  .description("После merge хотфикса отправить stable-тег с main/master")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(hotfix.hotfixDeploy, command));
+hotfixCmd.command("close")
+  .description("После stable pipeline свести production в dev")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(hotfix.hotfixClose, command));
+
+// Команды changelog
+const changelogCmd = program
+  .command("changelog")
+  .description("Команды управления changelog fragments");
+
+changelogCmd
+  .command("append <message>")
+  .description("Создать changelog fragment с номером задачи из ветки")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((message, command) => runAction(() => changelog.changelogAppend(message), command));
+
+changelogCmd
+  .command("check")
+  .description("Проверить CHANGELOG.md и changelog fragments")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(changelog.changelogCheck, command));
+
+changelogCmd
+  .command("write")
+  .description("Привести заголовки CHANGELOG.md к формату релиза и запустить Prettier")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(changelog.changelogWrite, command));
+
+// Команды chart
+const chartCmd = program
+  .command("chart")
+  .description("Команды управления тегами chart");
+
+chartCmd
+  .command("start")
+  .description("Создать и отправить chart-тег по верхней версии CHANGELOG.md чарта")
+  .allowExcessArguments(false)
+  .option("-f, --force", "Разрешить версию не больше последней версии тега на origin")
+  .option("-n, --no-wait", "Не ждать публикации версии чарта в Helm-registry")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(chart.chartStart, command));
+
+chartCmd
+  .command("verify <source_path>")
+  .description("Проверить пути ingress chart относительно исходников Next.js")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((sourcePath, command) => runAction(() => chart.chartVerify(sourcePath), command));
+
+chartCmd
+  .command("deploy")
+  .description("Задеплоить последнюю версию chart в файлы helmrelease")
+  .option("-i, --instances <names>", "Список инстансов через запятую (по умолчанию все)")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(chart.chartDeploy, command));
+
+const tokenCmd = program
+  .command("token")
+  .description("Команды управления GitLab токенами");
+
+tokenCmd
+  .command("rotate")
+  .description("Пролить GITLAB_PRIVATE_TOKEN в CI variables через owner PAT")
+  .option("-d, --dry", "Запустить только предпроверки")
+  .option("-s, --silence", "Скрыть сообщения об успешно пройденных предпроверках")
+  .action((command) => runAction(token.tokenRotate, command));
+}
+
+module.exports = { registerCommands };

package/src/{development.js → cli/development.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const { getPackageManager, execCommand, logError } = require('./utils');
+const { getPackageManager, execCommand, logError } = require('../common/utils');
 
 function dev() {
     const pm = getPackageManager();

package/src/cli/help.js

@@ -0,0 +1,55 @@
+function configureHelp(program) {
+// Переопределяем help, чтобы показать кастомный формат с алиасами
+program.configureHelp({
+  formatHelp: (cmd, helper) => {
+    const cmdUsage = helper.commandUsage(cmd);
+    const cmdDescription = helper.commandDescription(cmd);
+    const options = helper.visibleOptions(cmd);
+    const commands = helper.visibleCommands(cmd);
+
+    let output = "";
+
+    // Использование
+    if (cmdUsage) {
+      output += `Использование: ${cmdUsage}\n\n`;
+    }
+
+    // Описание
+    if (cmdDescription) {
+      output += `${cmdDescription}\n\n`;
+    }
+
+    // Команды с алиасами
+    if (commands.length > 0) {
+      output += "Команды:\n";
+      commands.forEach((cmd) => {
+        const nameAndArgs = cmd.name() + cmd.usage().replace(/^[^\s]+\s*/, " ");
+        const aliases = cmd.aliases();
+        const description = cmd.description();
+
+        let cmdLine = `  ${nameAndArgs}`;
+        if (aliases.length > 0) {
+          cmdLine = cmdLine.padEnd(25) + `[${aliases.join(", ")}]`;
+        }
+        cmdLine = cmdLine.padEnd(40) + description;
+        output += cmdLine + "\n";
+      });
+      output += "\n";
+    }
+
+    // Опции
+    if (options.length > 0) {
+      output += "Опции:\n";
+      options.forEach((option) => {
+        const flags = helper.optionTerm(option);
+        const description = helper.optionDescription(option);
+        output += `  ${flags.padEnd(25)} ${description}\n`;
+      });
+    }
+
+    return output;
+  },
+});
+}
+
+module.exports = { configureHelp };

package/src/cli/run-action.js

@@ -0,0 +1,28 @@
+const { checkForUpdates } = require('./update-check');
+const { withCommandOptions } = require('./command-executor');
+
+function commandOptions(command) {
+  return command && typeof command.opts === "function" ? command.opts() : command || {};
+}
+
+async function runAction(action, command) {
+  const options = commandOptions(command);
+  if (!options.dry) {
+    try {
+      await checkForUpdates();
+    } catch {
+      // A failed update check must not affect the command.
+    }
+  }
+  try {
+    const result = await withCommandOptions(options, () => action(options));
+    if (!result) {
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(`❌ Ошибка: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = { runAction };

package/src/cli/update-check.js

@@ -0,0 +1,51 @@
+const childProcess = require('child_process');
+const { name, version: currentVersion } = require('../../package.json');
+const { compareVersions } = require('../common/version');
+const { isDryRun, reportDryRun, reportNoPreflights } = require('./command-executor');
+
+const UPDATE_CHECK_TIMEOUT_MS = 200;
+
+async function checkForUpdates() {
+    const controller = new AbortController();
+    let timer;
+    try {
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => {
+                controller.abort();
+                resolve(null);
+            }, UPDATE_CHECK_TIMEOUT_MS);
+        });
+        const request = (async () => {
+            const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(name)}/latest`, {
+                signal: controller.signal,
+                headers: { accept: 'application/json' }
+            });
+            if (!response.ok) return null;
+            return (await response.json()).version;
+        })();
+        const latestVersion = await Promise.race([request, timeout]);
+        if (compareVersions(latestVersion, currentVersion) > 0) {
+            console.log(`⚠️ Доступна новая версия Spectrum CLI: сейчас ${currentVersion}, доступна ${latestVersion}.\nОбновить: spectrum upgrade`);
+        }
+    } catch {
+        // Network and registry errors must never block a command.
+    } finally {
+        clearTimeout(timer);
+    }
+}
+
+function upgrade() {
+    reportNoPreflights('upgrade');
+    if (isDryRun()) {
+        reportDryRun('upgrade');
+        return true;
+    }
+    const result = childProcess.spawnSync('npm', ['install', '-g', name], {
+        stdio: 'inherit',
+        shell: process.platform === 'win32'
+    });
+    if (result.error) throw result.error;
+    return result.status === 0;
+}
+
+module.exports = { checkForUpdates, upgrade, UPDATE_CHECK_TIMEOUT_MS };

package/src/{git.js → git/index.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-const { logSuccess, execCommand, getCurrentBranch, getMainBranch, getDevelopBranch } = require('./utils');
-const { runCommand } = require('./command-executor');
+const { logSuccess, execCommand, getCurrentBranch, getMainBranch, getDevelopBranch } = require('../common/utils');
+const { runCommand } = require('../cli/command-executor');
 const {
     requireGitRepo,
     requireCleanWorkingTree,
@@ -8,7 +8,7 @@ const {
     requireCurrentBranchUpToDateWithRemote,
     requireChangelogReleaseVersion,
     requireTagMissing
-} = require('./preflight');
+} = require('../preflight');
 
 function goToMainBranch() {
     const mainBranch = getMainBranch();
@@ -89,6 +89,7 @@ function gitCreateTagAndPush() {
             { name: 'changelog-release-version', run: requireChangelogReleaseVersion },
             {
                 name: 'tag-missing',
+                requires: ['version'],
                 run: (ctx) => requireTagMissing(`release/${ctx.version}`)
             }
         ],