spectrum-cli 3.1.0 → 3.1.1

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 🚀 [3.1.1] - 2026-09-24
+
+### 🪲 Fixed
+
+- Хотфиксы создают раздел с 🩹 и поддерживают запуск подготовки из main/master.
+- Дата раздела changelog необязательна; опубликованная история в прежнем формате сохраняется.
+- Исправлены проверка корня репозитория и сравнение CRLF/LF в release/hotfix на Windows.
+
 ## 🚀 [3.1.0] - 2026-09-24
 
 ### 🆕 Added

package/README.md

@@ -42,7 +42,7 @@ spectrum release deploy              # Создать стабильный те
 spectrum release close               # Свести stable main/master в dev
 
 # Срочный patch без переноса незавершённого dev в production
-spectrum hotfix start                # Только локальная подготовка CHANGELOG на hotfix/*
+spectrum hotfix start                # Локальная подготовка 🩹 CHANGELOG на hotfix/* или main/master
 spectrum hotfix deploy               # После merge MR: stable-тег на актуальном main/master
 spectrum hotfix close                # После stable pipeline: main/master → dev
 
@@ -182,24 +182,28 @@ spectrum-cli/
 
 Все hotfix-команды сначала проверяют ветку: разрешены только `hotfix/*`, `main`
 или `master`. `dev`, `develop`, `feature/*` и detached HEAD отклоняются до fetch.
-Проверки этапов строже: `start` требует task-backed hotfix-ветку, `deploy` и
-`close` — актуальный production commit на `main/master` после merge MR.
+Для `start` подходят `hotfix/<TASK>[-slug]` и production-ветка `main/master`,
+содержащая актуальный origin. Локальные исправления и commits допустимы.
+`deploy` и `close` требуют чистый production commit, совпадающий с origin.
 
 ### Изолированный цикл хотфикса
 
 Создайте `hotfix/<TASK>` или `hotfix/<TASK>-<slug>` от актуального `origin/main`
-или `origin/master`. Включайте только срочное исправление и его patch fragments
+или `origin/master`, либо работайте прямо в актуальной production-ветке
+`main/master`. Включайте только срочное исправление и его patch fragments
 (`fixed`, `security`, `support` либо другой совместимый patch-тип).
 `added` и `breaking` требуют обычного релиза. Все команды запускаются из корня
 репозитория; для `start` нужен Prettier, как для обычной сборки changelog.
 
 1. **`spectrum hotfix start`** обновляет сведения об origin и выбирает опубликованный
    stable-тег, достижимый из production. Цель — этот stable плюс один patch.
-   Команда формирует верхний датированный раздел `CHANGELOG.md` и удаляет только
+   Команда формирует верхний раздел `## 🩹 [X.Y.Z] - YYYY-MM-DD` и удаляет только
    собранные fragments. Она не делает commit, staging, push, merge или tag,
    не меняет файлы версий и сохраняет посторонние локальные изменения.
 2. Повторный `start` дополняет тот же неопубликованный раздел, сохраняя дату и
-   существующие записи без дублей. Без новых fragments подготовленный раздел
+   существующие записи без дублей. Дата необязательна: раздел без даты останется
+   без даты. Старые заголовки с `🚀`, `🩹`, без значка и с датами через точки
+   читаются без переписывания опубликованной истории. Без новых fragments подготовленный раздел
    остаётся без изменений. Например, от `v6.35.0` первый и повторные запуски
    готовят `6.35.1`; только после публикации `hotfix/6.35.1` следующий хотфикс получит
    `6.35.2`. Унаследованные от production fragments не собираются и не меняются.
@@ -208,7 +212,8 @@ spectrum-cli/
    использованных fragments.** Merge выполняется отдельно после ревью. Если
    другой хотфикс уже в production, сначала перенесите его изменения в свою
    ветку и повторите подготовку: пока stable-тега нет, раздел и версия общие.
-4. После merge MR и проверки RC выполните **`spectrum hotfix deploy`** на чистом
+4. После доставки подготовленного исправления в production через MR или
+   разрешённый проектом push и проверки RC выполните **`spectrum hotfix deploy`** на чистом
    `main/master`, точно совпадающем с origin. Команда проверяет следующий patch,
    неизменность опубликованной истории и отсутствие несобранных hotfix fragments,
    создаёт `hotfix/X.Y.Z` на проверенном SHA и отправляет **только этот тег**.

package/index.js

@@ -50,7 +50,7 @@ releaseCmd
 const hotfixCmd = program.command("hotfix").description("Изолированный цикл срочного patch-релиза");
 
 hotfixCmd.command("start")
-  .description("Подготовить CHANGELOG на hotfix/* для MR, без commit, push и merge")
+  .description("Подготовить 🩹 CHANGELOG на hotfix/* или main/master, без commit, push и merge")
   .action(() => runAction(hotfix.hotfixStart));
 hotfixCmd.command("deploy")
   .description("После merge хотфикса отправить stable-тег с main/master")

package/package.json

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

package/src/changelog.js

@@ -270,7 +270,7 @@ function stripLegacyUnreleasedBlock(changelog) {
     return `${changelog.slice(0, unreleasedMatch.index).trimEnd()}\n\n${changelog.slice(end).trimStart()}`;
 }
 
-function renderReleaseBlock(version, fragments, date = new Date().toISOString().slice(0, 10)) {
+function renderReleaseBlock(version, fragments, date = new Date().toISOString().slice(0, 10), marker = '🚀') {
     const fragmentsByType = new Map();
     for (const fragment of fragments) {
         const entries = fragmentsByType.get(fragment.type) || [];
@@ -278,7 +278,7 @@ function renderReleaseBlock(version, fragments, date = new Date().toISOString().
         fragmentsByType.set(fragment.type, entries);
     }
 
-    const lines = [`## 🚀 [${version}] - ${date}`];
+    const lines = [`## ${marker ? `${marker} ` : ''}[${version}]${date ? ` - ${date}` : ''}`];
     for (const [type, config] of Object.entries(FRAGMENT_TYPES)) {
         const entries = fragmentsByType.get(type);
         if (!entries || entries.length === 0) continue;

package/src/hotfix-changelog.js

@@ -4,15 +4,14 @@ const { renderReleaseBlock } = require('./changelog');
 // Parse release boundaries without rewriting any published text.
 function parseChangelog(text) {
     const headings = [...text.matchAll(/^## .+$/gm)];
-    const seen = new Set();
     const releases = headings.map((heading, index) => {
-        const match = heading[0].match(/^## (?:🚀 )?\[(\d+\.\d+\.\d+)\] - (\d{4}-\d{2}-\d{2})$/);
-        if (!match || seen.has(match[1])) {
-            throw new Error('CHANGELOG.md содержит некорректный или повторный раздел релиза.');
+        const match = heading[0].match(/^##[ \t]+(?:(🚀|🩹)[ \t]*)?\[(\d+\.\d+\.\d+)\](?:[ \t]+-[ \t]+(\d{4}-\d{2}-\d{2}|\d{4}\.\d{2}\.\d{2}|\d{2}\.\d{2}\.\d{4}))?[ \t]*\r?$/);
+        if (!match) {
+            throw new Error(`Некорректный заголовок CHANGELOG.md: ${heading[0]}. Ожидается ## [X.Y.Z], дата необязательна.`);
         }
-        seen.add(match[1]);
+        // Historical duplicates are preserved; callers validate the pending version and immutable history.
         return {
-            version: match[1], date: match[2],
+            version: match[2], date: match[3] || null, marker: match[1] || '',
             text: text.slice(heading.index, headings[index + 1]?.index ?? text.length),
             body: text.slice(heading.index + heading[0].length, headings[index + 1]?.index ?? text.length),
         };
@@ -44,15 +43,22 @@ function releaseEntries(release, patchOnly = false) {
     return entries;
 }
 
+function normalizeLineEndings(text) {
+    return text.replace(/\r\n/g, '\n');
+}
+
 function history(document) {
-    return document.releases.map((release) => release.text.trim()).join('\n\n');
+    return document.releases.map((release) => normalizeLineEndings(release.text).trim()).join('\n\n');
 }
 
 function pendingDocument(text, stableText, target) {
     const document = parseChangelog(text);
     const stable = parseChangelog(stableText);
     const pending = document.releases[0]?.version === target ? document.releases.shift() : null;
-    if (history(document) !== history(stable) || document.intro.trim() !== stable.intro.trim()) {
+    if (document.releases.some((release) => release.version === target)) {
+        throw new Error('Новый patch-раздел должен быть единственным и находиться в начале CHANGELOG.md.');
+    }
+    if (history(document) !== history(stable) || normalizeLineEndings(document.intro).trim() !== normalizeLineEndings(stable.intro).trim()) {
         throw new Error('История CHANGELOG.md отличается от stable: допустим только верхний раздел следующего patch.');
     }
     return { document, pending, entries: pending ? releaseEntries(pending, true) : [] };
@@ -79,10 +85,10 @@ function prepareChangelog({ text, stableText, productionText, target, fragments,
             currentKeys.add(entryKey(entry));
         }
     }
-    const block = renderReleaseBlock(target, merged, current.pending?.date || date);
+    const block = renderReleaseBlock(target, merged, current.pending ? current.pending.date : date, '🩹');
     // Preserve the published tail byte-for-byte, including its spacing.
     const tail = current.document.releases.map((release) => release.text).join('');
     return `${current.document.intro.trimEnd()}\n\n${block.trim()}\n${tail ? `\n${tail}` : ''}`;
 }
 
-module.exports = { parseChangelog, releaseEntries, pendingDocument, prepareChangelog };
+module.exports = { parseChangelog, releaseEntries, pendingDocument, prepareChangelog, normalizeLineEndings };

package/src/hotfix.js

@@ -1,11 +1,12 @@
 const fs = require('fs');
+const path = require('path');
 const { execFileSync } = require('child_process');
 const preflight = require('./preflight');
 const { execCommand, logSuccess, logError } = require('./utils');
 const { upVersion, compareVersions } = require('./version');
 const { STABLE_TAG_PATTERNS, parseStableTag, stableTagNames } = require('./stable-tags');
 const { CHANGELOG_FILE, CHANGELOG_DIR, FRAGMENT_TYPES, getFragmentType } = require('./changelog-config');
-const { parseChangelog, pendingDocument, prepareChangelog } = require('./hotfix-changelog');
+const { parseChangelog, pendingDocument, prepareChangelog, normalizeLineEndings } = require('./hotfix-changelog');
 
 function git(...args) {
     try {
@@ -41,7 +42,7 @@ function readAt(ref, file = CHANGELOG_FILE) {
 
 function context(mode) {
     const root = git('rev-parse', '--show-toplevel').trim();
-    if (fs.realpathSync(root) !== fs.realpathSync(process.cwd())) {
+    if (path.relative(fs.realpathSync(root), fs.realpathSync(process.cwd())) !== '') {
         throw new Error('Запустите hotfix из корня репозитория.');
     }
     const branch = git('branch', '--show-current').trim();
@@ -51,8 +52,8 @@ function context(mode) {
     if (mode !== 'start' && !['main', 'master'].includes(branch)) {
         throw new Error('hotfix deploy/close выполняются на main/master после merge хотфикса.');
     }
-    if (mode === 'start' && !/^hotfix\/[A-Z]+-[0-9]+(?:-[A-Za-z0-9][A-Za-z0-9._-]*)?$/.test(branch)) {
-        throw new Error('hotfix start выполняется только на hotfix/<TASK>[-slug].');
+    if (mode === 'start' && !['main', 'master'].includes(branch) && !/^hotfix\/[A-Z]+-[0-9]+(?:-[A-Za-z0-9][A-Za-z0-9._-]*)?$/.test(branch)) {
+        throw new Error('hotfix start выполняется на hotfix/<TASK>[-slug], main или master.');
     }
     if (mode !== 'start' && git('status', '--porcelain').trim()) {
         throw new Error('Для deploy/close требуется чистое рабочее дерево.');
@@ -64,6 +65,9 @@ function context(mode) {
     const mainRef = `refs/remotes/origin/${mainBranch}`;
     const mainSha = git('rev-parse', mainRef).trim();
     const head = git('rev-parse', 'HEAD').trim();
+    if (['main', 'master'].includes(branch) && branch !== mainBranch) {
+        throw new Error(`Production-ветка origin — ${mainBranch}. Переключитесь на неё или на hotfix/<TASK>[-slug].`);
+    }
     if (mode === 'start') {
         if (!ancestor(mainSha, head)) throw new Error('Сначала обновите hotfix из актуальной production-ветки.');
     } else if (branch !== mainBranch || head !== mainSha) {
@@ -115,7 +119,7 @@ function newFragments(baseRef) {
     const inherited = git('ls-tree', '-r', '-z', '--name-only', baseRef, '--', `${CHANGELOG_DIR}/`)
         .split('\0').filter(Boolean);
     for (const file of inherited) {
-        if (!fs.existsSync(file) || fs.readFileSync(file, 'utf8') !== readAt(baseRef, file)) {
+        if (!fs.existsSync(file) || normalizeLineEndings(fs.readFileSync(file, 'utf8')) !== normalizeLineEndings(readAt(baseRef, file))) {
             throw new Error(`Нельзя изменять унаследованный fragment ${file} в хотфиксе.`);
         }
     }

package/src/open-release.js

@@ -2,7 +2,7 @@ const fs = require('fs');
 const { execSilent, logError, logSuccess } = require('./utils');
 const { compareVersions } = require('./version');
 const { CHANGELOG_FILE, CHANGELOG_DIR } = require('./changelog-config');
-const { parseChangelog, releaseEntries } = require('./hotfix-changelog');
+const { parseChangelog, releaseEntries, normalizeLineEndings } = require('./hotfix-changelog');
 const { renderReleaseBlock, stripLegacyUnreleasedBlock } = require('./changelog');
 const { requireChangelogFragments } = require('./preflight');
 
@@ -23,7 +23,7 @@ function resolveReleaseState(localText, productionText, stableVersion) {
     if (local.open && production.open && local.open.version !== production.open.version) {
         throw new Error('Открытые версии в dev и production различаются. Сначала согласуйте CHANGELOG.md.');
     }
-    const history = ({ document }) => document.releases.map((release) => release.text.trim()).join('\n\n');
+    const history = ({ document }) => document.releases.map((release) => normalizeLineEndings(release.text).trim()).join('\n\n');
     if (history(local) !== history(production)) {
         throw new Error('Опубликованная история CHANGELOG.md изменена относительно production.');
     }
@@ -65,7 +65,7 @@ function appendOpenRelease(context) {
                 keys.add(key);
             }
         }
-        const block = renderReleaseBlock(open.version, merged, open.date);
+        const block = renderReleaseBlock(open.version, merged, open.date, open.marker);
         const tail = local.document.releases.map((release) => release.text).join('');
         const updated = `${local.document.intro.trimEnd()}\n\n${block.trim()}\n${tail ? `\n${tail}` : ''}`;
         fs.writeFileSync(CHANGELOG_FILE, updated);