spectrum-cli 1.0.6 → 1.1.0

package/CHANGELOG.md

@@ -35,6 +35,34 @@ _Список правок для обеспечения безопасност
 
 _Список правок для обеспечения технической поддержки._
 
+## 🚀 [1.1.0] - 2025-09-30
+
+### 🆕 Added
+
+- Добавлена команда `spectrum changelog append <message>` для умного добавления записей в CHANGELOG.md
+- Автоматическое извлечение номера задачи из названия ветки (формат: [a-zA-Z]+-[0-9]+)
+- Интерактивный запрос номера задачи при отсутствии в названии ветки
+- Проверка Git config с предупреждениями и подсказками по настройке
+- Умное определение раздела changelog по типу ветки (feature/bugfix/support)
+- Интерактивный выбор раздела при неопределенности или множественных вариантах
+- Автоматическое форматирование сообщений (добавление точки в конце)
+- Контекстный вывод результата с цветовым выделением новой записи
+- Автоматическое удаление дефолтного текста "_Список..._" при добавлении первой записи
+- Установлен Jest для тестирования с полным покрытием utils функций
+- Добавлены интеграционные тесты для проверки основной функциональности
+
+### 🛠 Changed
+
+- Обновлена документация README.md с подробным описанием команды `changelog append`
+- Улучшена структура экспорта функций в модуле `src/changelog.js`
+
+### 📦 Support
+
+- Настроен Jest для модульного и интеграционного тестирования
+- Добавлены npm scripts для запуска тестов (`test`, `test:watch`, `test:coverage`)
+- Конфигурация Jest для Node.js окружения с покрытием кода
+- Созданы базовые тесты для проверки стабильности функций
+
 ## 🚀 [1.0.1] - 2024-09-19
 
 ### 🆕 Added
@@ -64,9 +92,9 @@ _Список правок для обеспечения технической
 - Создан CLI интерфейс `spectrum` с командой `commander`
 - Добавлены основные команды:
   - `spectrum release start` - полный цикл релиза
-  - `spectrum release close` - закрытие релиза  
+  - `spectrum release close` - закрытие релиза
   - `spectrum release deploy` - деплой релиза
-  - `spectrum up version major/minor/patch` - управление версиями
+  - `spectrum version up major/minor/patch` - управление версиями
 - Цветной вывод с эмодзи для лучшего UX
 - Автоматическое определение пакетного менеджера (npm/yarn/bun)
 - Обработка ошибок и fallback'ы

package/README.md

@@ -35,14 +35,17 @@ npm install
 spectrum --help
 
 # 📦 Управление версиями
-spectrum up version major    # Поднять major версию (1.0.0 → 2.0.0)
-spectrum up version minor    # Поднять minor версию (1.0.0 → 1.1.0)
-spectrum up version patch    # Поднять patch версию (1.0.0 → 1.0.1)
+spectrum version up major    # Поднять major версию (1.0.0 → 2.0.0)
+spectrum version up minor    # Поднять minor версию (1.0.0 → 1.1.0)
+spectrum version up patch    # Поднять patch версию (1.0.0 → 1.0.1)
 
 # 🚀 Управление релизами
 spectrum release start       # Полный цикл релиза
 spectrum release close       # Закрыть релиз и смержить в dev
 spectrum release deploy      # Деплой релиза (создать тег)
+
+# 📝 Управление changelog
+spectrum changelog append "Сообщение"  # Добавить запись в CHANGELOG.md
 ```
 
 ### Справка по командам:
@@ -52,7 +55,10 @@ spectrum release deploy      # Деплой релиза (создать тег)
 spectrum release --help
 
 # Справка по версиям
-spectrum up version --help
+spectrum version up --help
+
+# Справка по changelog
+spectrum changelog --help
 ```
 
 ## ✨ Особенности
@@ -89,14 +95,15 @@ spectrum-cli/
 
 ### Команды:
 
-| Команда                     | Описание                     |
-| --------------------------- | ---------------------------- |
-| `spectrum up version major` | Увеличить major версию       |
-| `spectrum up version minor` | Увеличить minor версию       |
-| `spectrum up version patch` | Увеличить patch версию       |
-| `spectrum release start`    | Запустить полный цикл релиза |
-| `spectrum release close`    | Закрыть релиз                |
-| `spectrum release deploy`   | Деплой релиза                |
+| Команда                       | Описание                     |
+| ----------------------------- | ---------------------------- |
+| `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  |
 
 ## 🔄 Workflow релиза
 
@@ -124,6 +131,35 @@ spectrum-cli/
 2. Создает тег с текущей версией
 3. Пушит тег в remote
 
+## 📝 Работа с Changelog
+
+### `spectrum changelog append "Сообщение"`
+
+Умная команда для добавления записей в CHANGELOG.md с автоматическим определением контекста:
+
+**✨ Основные возможности:**
+- 🔍 **Автоматическое извлечение** номера задачи из названия ветки
+- 🤔 **Интерактивный запрос** номера задачи если не найден
+- 👤 **Проверка Git config** с подсказками по настройке
+- 🎯 **Умное определение раздела** по типу ветки
+- 🎨 **Контекстный вывод** с цветовым выделением
+- 🧹 **Автоматическая очистка** дефолтного текста
+
+**📋 Поддерживаемые типы веток:**
+- `feature/` → выбор между Added, Changed, Deprecated, Removed
+- `bugfix/`, `fix/` → автоматически Fixed
+- `support/` → выбор между Support, Security
+- другие → показ всех разделов
+
+**📌 Пример использования:**
+```bash
+# На ветке feature/ABC-123-new-component
+spectrum changelog append "Добавлен новый компонент кнопки"
+
+# Результат в CHANGELOG.md:
+# - ABC-123 Добавлен новый компонент кнопки. [Ваше Имя](ваш@email.com)
+```
+
 ## 🎯 Философия
 
 - **Простота** - минимум команд, максимум функциональности
@@ -135,7 +171,6 @@ spectrum-cli/
 
 - 📋 **[Установка](./INSTALL.md)** - подробные инструкции по установке
 - 🚀 **[Релизы](./RELEASE.md)** - инструкции по выпуску новых версий
-- 📦 **[Дистрибьюция](./DISTRIBUTION.md)** - варианты распространения
 
 ## 🤝 Участие в разработке
 

package/index.js

@@ -1,114 +1,132 @@
 #!/usr/bin/env node
-const { Command } = require('commander');
+const { Command } = require("commander");
 const program = new Command();
 
-const git = require('./src/git');
-const version = require('./src/version');
-const release = require('./src/release');
+const git = require("./src/git");
+const version = require("./src/version");
+const release = require("./src/release");
+const changelog = require("./src/changelog");
 
 program
-    .name('spectrum')
-    .description('🚀 Spectrum CLI for development workflow')
-    .version('1.0.6');
+  .name("spectrum")
+  .description("🚀 Spectrum CLI for development workflow")
+  .version("1.0.7");
 
 // Release commands
 const releaseCmd = program
-    .command('release')
-    .description('Release management commands');
+  .command("release")
+  .description("Release management commands");
 
 releaseCmd
-    .command('start')
-    .description('Start full release process')
-    .action(() => release.releaseStart());
+  .command("start")
+  .description("Start full release process")
+  .action(() => release.releaseStart());
 
 releaseCmd
-    .command('close')
-    .description('Close release and merge to dev')
-    .action(() => release.releaseClose());
+  .command("close")
+  .description("Close release and merge to dev")
+  .action(() => release.releaseClose());
 
 releaseCmd
-    .command('deploy')
-    .description('Deploy release (create and push tag)')
-    .action(() => git.gitCreateTagAndPush());
-
-// Up version commands
-const upCmd = program
-    .command('up')
-    .description('Version management commands');
-
-const versionCmd = upCmd
-    .command('version')
-    .description('Update version using semantic versioning');
-
-versionCmd
-    .command('major')
-    .description('Bump major version (x.0.0)')
-    .action(() => version.setVersionTypescript('major'));
-
-versionCmd
-    .command('minor')
-    .description('Bump minor version (x.y.0)')
-    .action(() => version.setVersionTypescript('minor'));
-
-versionCmd
-    .command('patch')
-    .description('Bump patch version (x.y.z)')
-    .action(() => version.setVersionTypescript('patch'));
+  .command("deploy")
+  .description("Deploy release (create and push tag)")
+  .action(() => git.gitCreateTagAndPush());
+
+// Version up commands
+const versionCmd = program
+  .command("version")
+  .description("Update version using semantic versioning");
+
+const upCmd = versionCmd
+  .command("up")
+  .description("Update version using semantic versioning");
+
+upCmd
+  .command("major")
+  .description("Bump major version (x.0.0)")
+  .action(() => version.setVersionTypescript("major"));
+
+upCmd
+  .command("minor")
+  .description("Bump minor version (x.y.0)")
+  .action(() => version.setVersionTypescript("minor"));
+
+upCmd
+  .command("patch")
+  .description("Bump patch version (x.y.z)")
+  .action(() => version.setVersionTypescript("patch"));
+
+// Changelog commands
+const changelogCmd = program
+  .command("changelog")
+  .description("Changelog management commands");
+
+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);
+    }
+  });
 
 // Override help to show custom format with aliases
 program.configureHelp({
-    formatHelp: (cmd, helper) => {
-        const termWidth = helper.padWidth(cmd, helper);
-        const helpWidth = helper.helpWidth || 80;
-        const itemIndentWidth = 2;
-        const itemSeparatorWidth = 2;
-        const cmdUsage = helper.commandUsage(cmd);
-        const cmdDescription = helper.commandDescription(cmd);
-        const options = helper.visibleOptions(cmd);
-        const commands = helper.visibleCommands(cmd);
-        
-        let output = '';
-        
-        // Usage
-        if (cmdUsage) {
-            output += `Usage: ${cmdUsage}\n\n`;
-        }
-        
-        // Description
-        if (cmdDescription) {
-            output += `${cmdDescription}\n\n`;
-        }
-        
-        // Commands with aliases
-        if (commands.length > 0) {
-            output += 'Commands:\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';
-        }
-        
-        // Options
-        if (options.length > 0) {
-            output += 'Options:\n';
-            options.forEach(option => {
-                const flags = helper.optionTerm(option);
-                const description = helper.optionDescription(option);
-                output += `  ${flags.padEnd(25)} ${description}\n`;
-            });
+  formatHelp: (cmd, helper) => {
+    const termWidth = helper.padWidth(cmd, helper);
+    const helpWidth = helper.helpWidth || 80;
+    const itemIndentWidth = 2;
+    const itemSeparatorWidth = 2;
+    const cmdUsage = helper.commandUsage(cmd);
+    const cmdDescription = helper.commandDescription(cmd);
+    const options = helper.visibleOptions(cmd);
+    const commands = helper.visibleCommands(cmd);
+
+    let output = "";
+
+    // Usage
+    if (cmdUsage) {
+      output += `Usage: ${cmdUsage}\n\n`;
+    }
+
+    // Description
+    if (cmdDescription) {
+      output += `${cmdDescription}\n\n`;
+    }
+
+    // Commands with aliases
+    if (commands.length > 0) {
+      output += "Commands:\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(", ")}]`;
         }
-        
-        return output;
+        cmdLine = cmdLine.padEnd(40) + description;
+        output += cmdLine + "\n";
+      });
+      output += "\n";
     }
+
+    // Options
+    if (options.length > 0) {
+      output += "Options:\n";
+      options.forEach((option) => {
+        const flags = helper.optionTerm(option);
+        const description = helper.optionDescription(option);
+        output += `  ${flags.padEnd(25)} ${description}\n`;
+      });
+    }
+
+    return output;
+  },
 });
 
-program.parse();
+program.parse();

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "spectrum-cli",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "🚀 Modern CLI for development workflow automation - release management, versioning, and changelog generation",
   "main": "index.js",
   "bin": {
     "spectrum": "./index.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
     "prepublishOnly": "echo \"Publishing spectrum-cli v$(node -p 'require(\"./package.json\").version')\"",
     "postpack": "echo \"Packed successfully\""
   },
@@ -61,5 +63,19 @@
   "preferGlobal": true,
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
+  },
+  "jest": {
+    "testEnvironment": "node",
+    "collectCoverageFrom": [
+      "src/**/*.js",
+      "index.js"
+    ],
+    "testMatch": [
+      "**/__tests__/**/*.js",
+      "**/*.test.js"
+    ]
   }
 }

package/src/UNRELEASED.md

@@ -27,4 +27,3 @@ _Список правок для обеспечения безопасност
 ### 📦 Support
 
 _Список правок для обеспечения технической поддержки._
-

package/src/changelog.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 const fs = require('fs');
 const path = require('path');
-const { logSuccess, execCommand, getVersion, colors } = require('./utils');
+const readline = require('readline');
+const { logSuccess, logError, execCommand, execSilent, getVersion, getCurrentBranch, colors } = require('./utils');
 
 function changelogChangeHeader() {
     try {
@@ -71,10 +72,234 @@ function changelogCommit() {
     return false;
 }
 
+function createReadlineInterface() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+}
+
+function askQuestion(question) {
+    return new Promise((resolve) => {
+        const rl = createReadlineInterface();
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+
+async function extractTaskFromBranch() {
+    const currentBranch = getCurrentBranch();
+    if (!currentBranch) {
+        logError('❌', 'Cannot get current branch name.');
+        return null;
+    }
+    
+    const taskMatch = currentBranch.match(/([a-zA-Z]+-[0-9]+)/);
+    if (!taskMatch) {
+        console.log(`⚠️  ${colors.yellow}Branch name "${currentBranch}" does not contain task number in format [a-zA-Z]+-[0-9]+.${colors.reset}`);
+        const task = await askQuestion('📝 Please enter task number (e.g. SPEC-123): ');
+        if (!task || !task.match(/^[a-zA-Z]+-[0-9]+$/)) {
+            logError('❌', 'Invalid task format. Expected format: [a-zA-Z]+-[0-9]+');
+            return null;
+        }
+        return task;
+    }
+    
+    return taskMatch[1];
+}
+
+async function getGitUser() {
+    let name = execSilent('git config user.name');
+    let email = execSilent('git config user.email');
+    
+    if (!name || !email) {
+        console.log(`⚠️  ${colors.yellow}Git user name and email are not configured.${colors.reset}`);
+        console.log(`💡 You can configure them using:`);
+        console.log(`   git config user.name "Your Name"`);
+        console.log(`   git config user.email "your.email@domain.com"`);
+        console.log('');
+        
+        if (!name) {
+            name = await askQuestion('👤 Please enter your name: ');
+            if (!name) {
+                logError('❌', 'Name is required.');
+                return null;
+            }
+        }
+        
+        if (!email) {
+            email = await askQuestion('📧 Please enter your email: ');
+            if (!email || !email.includes('@')) {
+                logError('❌', 'Valid email is required.');
+                return null;
+            }
+        }
+    }
+    
+    return `[${name}](${email})`;
+}
+
+function formatMessage(message) {
+    if (!message.endsWith('.')) {
+        return message + '.';
+    }
+    return message;
+}
+
+function detectSectionFromBranch() {
+    const currentBranch = getCurrentBranch();
+    if (!currentBranch) return [];
+    
+    const branchLower = currentBranch.toLowerCase();
+    const sections = {
+        support: ['### 📦 Support', '### 🔐 Security'],
+        bugfix: ['### 🪲 Fixed'],
+        feature: ['### 🆕 Added', '### 🛠 Changed', '### 📜 Deprecated', '### 🗑 Removed']
+    };
+    
+    if (branchLower.includes('support')) {
+        return sections.support;
+    } else if (branchLower.includes('bugfix') || branchLower.includes('fix')) {
+        return sections.bugfix;
+    } else if (branchLower.includes('feature') || branchLower.includes('feat')) {
+        return sections.feature;
+    }
+    
+    return [];
+}
+
+async function selectSection(availableSections) {
+    if (availableSections.length === 0) {
+        availableSections = [
+            '### 🆕 Added',
+            '### 🛠 Changed', 
+            '### 📜 Deprecated',
+            '### 🗑 Removed',
+            '### 🪲 Fixed',
+            '### 🔐 Security',
+            '### 📦 Support'
+        ];
+    }
+    
+    if (availableSections.length === 1) {
+        return availableSections[0];
+    }
+    
+    console.log(`\n📋 Please select a section:`);
+    availableSections.forEach((section, index) => {
+        console.log(`   ${index + 1}. ${section}`);
+    });
+    
+    const choice = await askQuestion('\n🔢 Enter section number: ');
+    const choiceNum = parseInt(choice);
+    
+    if (isNaN(choiceNum) || choiceNum < 1 || choiceNum > availableSections.length) {
+        logError('❌', 'Invalid choice.');
+        return null;
+    }
+    
+    return availableSections[choiceNum - 1];
+}
+
+function displayContext(lines, insertIndex, entry) {
+    console.log('\n📝 Changelog updated:');
+    
+    if (insertIndex > 0) {
+        console.log(`   ${colors.reset}${lines[insertIndex - 1]}${colors.reset}`);
+    }
+    
+    console.log(`   ${colors.green}${entry}${colors.reset}`);
+    
+    if (insertIndex < lines.length - 1) {
+        console.log(`   ${colors.reset}${lines[insertIndex]}${colors.reset}`);
+    }
+    console.log('');
+}
+
+async function changelogAppend(message) {
+    try {
+        const task = await extractTaskFromBranch();
+        if (!task) return false;
+        
+        const user = await getGitUser();
+        if (!user) return false;
+        
+        const formattedMessage = formatMessage(message);
+        const entry = `- ${task} ${formattedMessage} ${user}`;
+        
+        const availableSections = detectSectionFromBranch();
+        const selectedSection = await selectSection(availableSections);
+        if (!selectedSection) return false;
+        
+        const changelog = fs.readFileSync('CHANGELOG.md', 'utf8');
+        const lines = changelog.split('\n');
+        
+        let sectionIndex = -1;
+        for (let i = 0; i < lines.length; i++) {
+            if (lines[i] === selectedSection) {
+                sectionIndex = i;
+                break;
+            }
+        }
+        
+        if (sectionIndex === -1) {
+            logError('❌', `Cannot find "${selectedSection}" section in CHANGELOG.md.`);
+            return false;
+        }
+        
+        let insertIndex = sectionIndex + 2;
+        let defaultTextLines = 0;
+        
+        // Count and remember default text lines to remove them
+        while (insertIndex + defaultTextLines < lines.length && 
+               lines[insertIndex + defaultTextLines].startsWith('_')) {
+            defaultTextLines++;
+        }
+        
+        // Insert the new entry
+        lines.splice(insertIndex, 0, entry);
+        
+        // Remove default text lines if this is the first real entry in the section
+        if (defaultTextLines > 0) {
+            // Check if there are any non-default entries after our insertion
+            let hasOtherEntries = false;
+            for (let i = insertIndex + 1; i < insertIndex + 1 + defaultTextLines; i++) {
+                if (lines[i] && lines[i].startsWith('- ')) {
+                    hasOtherEntries = true;
+                    break;
+                }
+            }
+            
+            // If no other entries, remove default text
+            if (!hasOtherEntries) {
+                lines.splice(insertIndex + 1, defaultTextLines);
+            }
+        }
+        
+        const updatedChangelog = lines.join('\n');
+        fs.writeFileSync('CHANGELOG.md', updatedChangelog);
+        
+        displayContext(lines, insertIndex, entry);
+        logSuccess('✅', `Entry added to ${selectedSection}`);
+        return true;
+    } catch (error) {
+        logError('❌', `Error adding changelog entry: ${error.message}`);
+        return false;
+    }
+}
+
 
 module.exports = {
     changelogChangeHeader,
     changelogRemoveEmptyChapters,
     changelogAddUnreleasedBlock,
-    changelogCommit
+    changelogCommit,
+    changelogAppend,
+    extractTaskFromBranch,
+    getGitUser,
+    formatMessage,
+    detectSectionFromBranch,
+    selectSection
 };

package/src/git.js

@@ -87,7 +87,7 @@ function gitCreateTagAndPush() {
     }
     
     if (execCommand(`git tag v${currentVersion}`, null, null)) {
-        logSuccess('🏷️', `Create tag v${currentVersion}.`);
+        logSuccess('🔖', `Create tag v${currentVersion}.`);
         
         if (execCommand(`git push origin v${currentVersion}`, null, null)) {
             logSuccess('🚀', `Push tag v${currentVersion}.`);

package/src/utils.js

@@ -47,7 +47,11 @@ function getCurrentBranch() {
 }
 
 function getMainBranch() {
-    return execSilent('git symbolic-ref refs/remotes/origin/HEAD | sed "s@^refs/remotes/origin/@@"') || 'main';
+    const branches = execSilent('git branch -r');
+    if (branches && branches.includes('origin/master')) {
+        return 'master';
+    }
+    return 'main';
 }
 
 function getDevelopBranch() {

package/src/version.js

@@ -34,7 +34,7 @@ function setVersionTypescript(versionType) {
         packageJson.version = newVersion;
         fs.writeFileSync('package.json', JSON.stringify(packageJson, null, 2) + '\n');
         
-        logSuccess('🏷️', `Current version ${oldVersion} up to ${colors.green}${newVersion}${colors.reset}.`);
+        logSuccess('🔖', `Current version ${oldVersion} up to ${colors.green}${newVersion}${colors.reset}.`);
         return true;
     } catch (error) {
         logError('❌', 'Error updating version in package.json');