spectrum-cli 2.0.0 → 2.1.1

package/CHANGELOG.md

@@ -39,6 +39,18 @@ _Список правок для обеспечения безопасност
 
 _Список правок для обеспечения технической поддержки._
 
+## 🚀 [2.1.1] - 2026-08-17
+
+### 🛠 Changed
+
+- Команда `spectrum token rotate` больше не создает PAT. Нужно передать готовый `GITLAB_PRIVATE_TOKEN`, команда только проливает его в CI/CD variables.
+
+## 🚀 [2.1.0] - 2026-08-17
+
+### 🆕 Added
+
+- Добавлена команда `spectrum token rotate` для ротации `GITLAB_PRIVATE_TOKEN` и пролива в CI/CD variables групп и проектов.
+
 ## 🚀 [1.2.2] - 2026-03-10
 
 ### 🛠 Changed

package/README.md

@@ -53,6 +53,9 @@ spectrum chart verify ~/repo  # Сравнить ingress paths AS IS vs TO BE д
 
 # 📝 Управление changelog
 spectrum changelog append "Сообщение"  # Добавить запись в CHANGELOG.md
+
+# 🔑 GitLab токены
+spectrum token rotate  # Пролить GITLAB_PRIVATE_TOKEN в CI variables
 ```
 
 ### Справка по командам:
@@ -69,6 +72,9 @@ spectrum changelog --help
 
 # Справка по chart
 spectrum chart --help
+
+# Справка по токенам
+spectrum token --help
 ```
 
 ## ✨ Особенности
@@ -96,6 +102,7 @@ spectrum-cli/
 │   ├── version.js     # 📦 Управление версиями SemVer
 │   ├── changelog.js   # 📋 Работа с CHANGELOG.md
 │   ├── chart.js       # 📈 Создание и push chart тегов
+│   ├── token.js       # 🔑 Ротация GitLab PAT и CI variables
 │   ├── development.js # ⚡ Dev команды (внутренние)
 │   └── release.js     # 🚀 Release процесс
 ├── package.json       # 📦 Конфигурация проекта
@@ -118,6 +125,7 @@ spectrum-cli/
 | `spectrum chart create`     | Создать и запушить chart тег        |
 | `spectrum chart deploy`     | Обновить chart версию в helmrelease |
 | `spectrum chart verify`     | Проверить ingress paths chart       |
+| `spectrum token rotate`     | Пролить GITLAB_PRIVATE_TOKEN в CI   |
 
 ### 🛡️ Preflight-проверки по командам
 
@@ -131,6 +139,7 @@ spectrum-cli/
 - `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`.
+- `spectrum token rotate`: `load-config` (есть валидный `~/.config/spectrum-cli/config.yaml`), `ask-private-token` (`GITLAB_PRIVATE_TOKEN` только в памяти), `check-access` (все группы и проекты из конфига доступны).
 
 ## 🔄 Workflow релиза
 
@@ -185,6 +194,31 @@ spectrum-cli/
 4. Печатает diff только по изменениям: лишние пути (`-`) и недостающие (`+`) с цветовой подсветкой
 5. Завершает команду с ошибкой, если есть расхождения
 
+### `spectrum token rotate`
+
+Пролив уже созданного PAT `GITLAB_PRIVATE_TOKEN` в CI/CD variables групп и проектов. Команда токен не выпускает.
+
+**Конфиг:** `~/.config/spectrum-cli/config.yaml`
+
+Если файла нет, команда создаст его:
+
+```yaml
+bot: bot
+token_ttl_months: 12
+groups: []
+projects: []
+```
+
+- `bot` и `token_ttl_months` читаются только из конфига.
+- `GITLAB_PRIVATE_TOKEN` запрашивается скрытым вводом и живет только в памяти на время команды. Им же ходим в API.
+- Для каждой группы и проекта CI variable `GITLAB_PRIVATE_TOKEN` удаляется (если есть) и создается заново как masked and hidden.
+- Description переменной: `PAT от бота <bot>, владелец Колосов. Истекает YYYY-MM-DD.` Дата = сегодня + `token_ttl_months`.
+
+1. Загружает или создает конфиг
+2. Запрашивает `GITLAB_PRIVATE_TOKEN`
+3. Проверяет доступ ко всем группам и проектам
+4. Обновляет CI variables во всех целях
+
 ## 📝 Работа с Changelog
 
 ### `spectrum changelog append "Сообщение"`

package/index.js

@@ -7,6 +7,7 @@ const version = require("./src/version");
 const release = require("./src/release");
 const changelog = require("./src/changelog");
 const chart = require("./src/chart");
+const token = require("./src/token");
 const { version: pkgVersion } = require("./package.json");
 
 async function runAction(action, ...args) {
@@ -100,6 +101,15 @@ chartCmd
   .description("Задеплоить последнюю версию chart в файлы helmrelease")
   .action(() => runAction(chart.chartDeploy));
 
+const tokenCmd = program
+  .command("token")
+  .description("Команды управления GitLab токенами");
+
+tokenCmd
+  .command("rotate")
+  .description("Пролить GITLAB_PRIVATE_TOKEN в CI variables групп и проектов")
+  .action(() => runAction(token.tokenRotate));
+
 // Переопределяем help, чтобы показать кастомный формат с алиасами
 program.configureHelp({
   formatHelp: (cmd, helper) => {

package/package.json

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

package/src/token.js

@@ -0,0 +1,391 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const readline = require('readline');
+const { logSuccess, logError } = require('./utils');
+const { runCommand } = require('./command-executor');
+
+const TOKEN_NAME = 'GITLAB_PRIVATE_TOKEN';
+
+function getConfigPath() {
+    return path.join(os.homedir(), '.config', 'spectrum-cli', 'config.yaml');
+}
+
+function defaultConfigContent() {
+    return [
+        'bot: bot',
+        'token_ttl_months: 12',
+        'groups: []',
+        'projects: []',
+        ''
+    ].join('\n');
+}
+
+function stripQuotes(value) {
+    const text = String(value || '').trim();
+    if ((text.startsWith('"') && text.endsWith('"')) || (text.startsWith("'") && text.endsWith("'"))) {
+        return text.slice(1, -1);
+    }
+    return text;
+}
+
+function parseConfig(content) {
+    const result = { bot: null, tokenTtlMonths: null, groups: [], projects: [] };
+    let section = null;
+
+    for (const rawLine of String(content || '').split('\n')) {
+        const line = rawLine.replace(/\r$/, '');
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+
+        const isTopLevel = !line.startsWith(' ') && !line.startsWith('\t');
+        const botMatch = trimmed.match(/^bot:\s*(.+)$/);
+        if (isTopLevel && botMatch) {
+            result.bot = stripQuotes(botMatch[1]);
+            section = null;
+            continue;
+        }
+
+        const ttlMatch = trimmed.match(/^token_ttl_months:\s*(.+)$/);
+        if (isTopLevel && ttlMatch) {
+            result.tokenTtlMonths = Number(stripQuotes(ttlMatch[1]));
+            section = null;
+            continue;
+        }
+
+        if (isTopLevel && /^groups:\s*(?:\[\s*\])?\s*$/.test(trimmed)) {
+            section = 'groups';
+            continue;
+        }
+
+        if (isTopLevel && /^projects:\s*(?:\[\s*\])?\s*$/.test(trimmed)) {
+            section = 'projects';
+            continue;
+        }
+
+        const itemMatch = line.match(/^\s*-\s+(.+)$/);
+        if (itemMatch && (section === 'groups' || section === 'projects')) {
+            result[section].push(stripQuotes(itemMatch[1]));
+        }
+    }
+
+    return result;
+}
+
+function parseGitlabUrl(raw) {
+    const url = new URL(String(raw || '').trim());
+    const pathname = url.pathname.replace(/^\//, '').replace(/\.git$/, '').replace(/\/$/, '');
+    if (!url.origin || !pathname) {
+        throw new Error('invalid gitlab url');
+    }
+    return {
+        origin: url.origin,
+        path: pathname,
+        encodedPath: encodeURIComponent(pathname),
+        url: String(raw).trim()
+    };
+}
+
+function addMonths(date, months) {
+    const result = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + Number(months), date.getUTCDate()));
+    return result.toISOString().slice(0, 10);
+}
+
+function buildDescription(bot, expiresAt) {
+    return `PAT от бота ${bot}, владелец Колосов. Истекает ${expiresAt}.`;
+}
+
+function validateConfig(config) {
+    if (!config.bot) {
+        return { ok: false, reason: 'В конфиге отсутствует поле bot.' };
+    }
+    if (!Number.isInteger(config.tokenTtlMonths) || config.tokenTtlMonths <= 0) {
+        return { ok: false, reason: 'В конфиге поле token_ttl_months должно быть положительным целым числом.' };
+    }
+    if (config.groups.length === 0 && config.projects.length === 0) {
+        return { ok: false, reason: 'В конфиге пустые списки groups и projects.' };
+    }
+    return { ok: true };
+}
+
+function parseTargets(urls, kind) {
+    const targets = [];
+    for (const raw of urls) {
+        try {
+            targets.push({ kind, ...parseGitlabUrl(raw) });
+        } catch (error) {
+            return { ok: false, reason: `Некорректный URL ${kind}: ${raw}` };
+        }
+    }
+    return { ok: true, targets };
+}
+
+async function promptPrivateToken() {
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        const stdout = process.stdout;
+        stdout.write('🔑 Введите GITLAB_PRIVATE_TOKEN: ');
+
+        if (!stdin.isTTY || typeof stdin.setRawMode !== 'function') {
+            const rl = readline.createInterface({ input: stdin, output: stdout });
+            rl.question('', (answer) => {
+                rl.close();
+                resolve(String(answer || '').trim());
+            });
+            return;
+        }
+
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        let value = '';
+        const onData = (char) => {
+            if (char === '\n' || char === '\r' || char === '\u0004') {
+                stdin.setRawMode(false);
+                stdin.pause();
+                stdin.removeListener('data', onData);
+                stdout.write('\n');
+                resolve(value.trim());
+                return;
+            }
+            if (char === '\u0003') {
+                stdin.setRawMode(false);
+                process.exit(1);
+            }
+            if (char === '\u007f' || char === '\b') {
+                value = value.slice(0, -1);
+                return;
+            }
+            value += char;
+        };
+        stdin.on('data', onData);
+    });
+}
+
+async function gitlabRequest(origin, privateToken, method, apiPath, body) {
+    const url = `${origin}/api/v4${apiPath}`;
+    const headers = { 'PRIVATE-TOKEN': privateToken };
+    const options = { method, headers };
+    if (body !== undefined) {
+        headers['Content-Type'] = 'application/json';
+        options.body = JSON.stringify(body);
+    }
+
+    const response = await fetch(url, options);
+    const text = await response.text();
+    let data = null;
+    if (text) {
+        try {
+            data = JSON.parse(text);
+        } catch (error) {
+            data = null;
+        }
+    }
+
+    return {
+        ok: response.ok,
+        status: response.status,
+        data,
+        headers: response.headers
+    };
+}
+
+async function gitlabGetAll(origin, privateToken, apiPath) {
+    const items = [];
+    let page = 1;
+
+    while (true) {
+        const separator = apiPath.includes('?') ? '&' : '?';
+        const result = await gitlabRequest(origin, privateToken, 'GET', `${apiPath}${separator}per_page=100&page=${page}`);
+        if (!result.ok) {
+            return result;
+        }
+
+        const batch = Array.isArray(result.data) ? result.data : [];
+        items.push(...batch);
+
+        const nextPage = result.headers && typeof result.headers.get === 'function'
+            ? result.headers.get('x-next-page')
+            : '';
+        if (!nextPage) {
+            break;
+        }
+        page = Number(nextPage);
+        if (!page) {
+            break;
+        }
+    }
+
+    return { ok: true, status: 200, data: items };
+}
+
+function loadOrCreateConfig() {
+    const configPath = getConfigPath();
+    const configDir = path.dirname(configPath);
+
+    if (!fs.existsSync(configPath)) {
+        logSuccess('📄', 'Конфиг не найден, создаю %s', configPath);
+        fs.mkdirSync(configDir, { recursive: true });
+        fs.writeFileSync(configPath, defaultConfigContent(), 'utf8');
+        logSuccess('📄', 'Конфиг создан. Проверьте groups и projects перед следующей ротацией.');
+    } else {
+        logSuccess('📄', 'Читаю конфиг %s', configPath);
+    }
+
+    let content = '';
+    try {
+        content = fs.readFileSync(configPath, 'utf8');
+    } catch (error) {
+        return { ok: false, reason: `Не удалось прочитать конфиг ${configPath}.` };
+    }
+
+    const parsed = parseConfig(content);
+    const valid = validateConfig(parsed);
+    if (!valid.ok) {
+        return valid;
+    }
+
+    const groups = parseTargets(parsed.groups, 'группы');
+    if (!groups.ok) {
+        return groups;
+    }
+    const projects = parseTargets(parsed.projects, 'проекта');
+    if (!projects.ok) {
+        return projects;
+    }
+
+    const targets = groups.targets.concat(projects.targets);
+    logSuccess('📄', 'Конфиг загружен: bot=%s, ttl=%s мес., групп=%s, проектов=%s', parsed.bot, String(parsed.tokenTtlMonths), String(parsed.groups.length), String(parsed.projects.length));
+
+    return {
+        ok: true,
+        data: {
+            configPath,
+            bot: parsed.bot,
+            tokenTtlMonths: parsed.tokenTtlMonths,
+            origin: targets[0].origin,
+            targets
+        }
+    };
+}
+
+async function askPrivateToken(ctx) {
+    logSuccess('🔑', 'Запрашиваю %s. Значение останется только в памяти.', TOKEN_NAME);
+    const privateToken = await module.exports.promptPrivateToken();
+    if (!privateToken) {
+        return { ok: false, reason: `${TOKEN_NAME} не указан.` };
+    }
+
+    const expiresAt = addMonths(new Date(), ctx.tokenTtlMonths);
+    logSuccess('🔑', '%s принят в память. Description будет с датой %s.', TOKEN_NAME, expiresAt);
+    return {
+        ok: true,
+        data: {
+            privateToken,
+            expiresAt,
+            variableDescription: buildDescription(ctx.bot, expiresAt)
+        }
+    };
+}
+
+async function checkTargetsAccess(ctx) {
+    const total = ctx.targets.length;
+    for (let index = 0; index < total; index += 1) {
+        const target = ctx.targets[index];
+        const endpoint = target.kind === 'группы' ? 'groups' : 'projects';
+        logSuccess('🔍', '[%s/%s] Проверяю доступ к %s %s', String(index + 1), String(total), target.kind, target.url);
+        const result = await gitlabRequest(ctx.origin, ctx.privateToken, 'GET', `/${endpoint}/${target.encodedPath}`);
+        if (!result.ok) {
+            return { ok: false, reason: `${target.kind === 'группы' ? 'Группа' : 'Проект'} недоступен: ${target.url} (HTTP ${result.status}).` };
+        }
+        logSuccess('✅', '[%s/%s] %s доступна: %s', String(index + 1), String(total), target.kind === 'группы' ? 'Группа' : 'Проект', target.path);
+    }
+    return { ok: true };
+}
+
+async function updateTargetVariable(ctx, target, index, total) {
+    const endpoint = target.kind === 'группы' ? 'groups' : 'projects';
+    const label = target.kind === 'группы' ? 'группе' : 'проекте';
+    logSuccess('📦', '[%s/%s] Обновляю CI variable %s в %s %s', String(index + 1), String(total), TOKEN_NAME, label, target.path);
+
+    const listed = await gitlabGetAll(ctx.origin, ctx.privateToken, `/${endpoint}/${target.encodedPath}/variables`);
+    if (!listed.ok) {
+        logError('❌', 'Не удалось получить CI variables для %s (HTTP %s).', target.path, String(listed.status));
+        return false;
+    }
+
+    const exists = (listed.data || []).some((variable) => variable.key === TOKEN_NAME);
+    if (exists) {
+        logSuccess('🗑', '[%s/%s] Удаляю старую CI variable %s в %s %s', String(index + 1), String(total), TOKEN_NAME, label, target.path);
+        const deleted = await gitlabRequest(ctx.origin, ctx.privateToken, 'DELETE', `/${endpoint}/${target.encodedPath}/variables/${TOKEN_NAME}`);
+        if (!deleted.ok && deleted.status !== 204) {
+            logError('❌', 'Не удалось удалить CI variable в %s (HTTP %s).', target.path, String(deleted.status));
+            return false;
+        }
+        logSuccess('🗑', '[%s/%s] Старая CI variable удалена в %s %s', String(index + 1), String(total), label, target.path);
+    } else {
+        logSuccess('🔎', '[%s/%s] CI variable %s в %s %s отсутствует, будет создана.', String(index + 1), String(total), TOKEN_NAME, label, target.path);
+    }
+
+    logSuccess('📝', '[%s/%s] Создаю CI variable %s в %s %s', String(index + 1), String(total), TOKEN_NAME, label, target.path);
+    const created = await gitlabRequest(ctx.origin, ctx.privateToken, 'POST', `/${endpoint}/${target.encodedPath}/variables`, {
+        key: TOKEN_NAME,
+        value: ctx.privateToken,
+        masked_and_hidden: true,
+        description: ctx.variableDescription
+    });
+    if (!created.ok) {
+        logError('❌', 'Не удалось создать CI variable в %s (HTTP %s).', target.path, String(created.status));
+        return false;
+    }
+
+    logSuccess('📝', '[%s/%s] CI variable обновлена в %s %s', String(index + 1), String(total), label, target.path);
+    return true;
+}
+
+async function updateCiVariables(ctx) {
+    const total = ctx.targets.length;
+    logSuccess('📦', 'Начинаю обновление CI variables: целей %s', String(total));
+    for (let index = 0; index < total; index += 1) {
+        const ok = await updateTargetVariable(ctx, ctx.targets[index], index, total);
+        if (!ok) {
+            return false;
+        }
+    }
+    logSuccess('📦', 'Все CI variables обновлены (%s).', String(total));
+    return true;
+}
+
+function tokenRotate() {
+    return runCommand({
+        name: 'token rotate',
+        checks: [
+            { name: 'load-config', run: loadOrCreateConfig },
+            { name: 'ask-private-token', run: askPrivateToken },
+            { name: 'check-access', run: checkTargetsAccess }
+        ],
+        steps: [
+            { name: 'update-ci-variables', run: updateCiVariables }
+        ]
+    });
+}
+
+module.exports = {
+    TOKEN_NAME,
+    getConfigPath,
+    defaultConfigContent,
+    parseConfig,
+    parseGitlabUrl,
+    addMonths,
+    buildDescription,
+    validateConfig,
+    promptPrivateToken,
+    loadOrCreateConfig,
+    askPrivateToken,
+    checkTargetsAccess,
+    updateCiVariables,
+    tokenRotate
+};