@7n/rules 1.0.0

package/rules/release/lib/aggregate.mjs

@@ -0,0 +1,82 @@
+/**
+ * Агрегація change-файлів одного workspace у version-bump + секцію CHANGELOG
+ * (Keep a Changelog 1.1.0, новіше зверху). Без побічних ефектів — лише обчислення/рендер;
+ * запис на диск і git — у release.mjs.
+ */
+import { VALID_BUMPS, VALID_SECTIONS } from './change-file.mjs'
+
+const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)$/
+const CHANGELOG_HEADER = '# Changelog'
+
+/**
+ * @param {string} version `x.y.z`
+ * @param {string} bump `major|minor|patch`
+ * @returns {string} нова версія
+ */
+export function bumpVersion(version, bump) {
+  const m = SEMVER_RE.exec(version)
+  if (!m) throw new Error(`aggregate: невалідний semver «${version}»`)
+  const [major, minor, patch] = [Number(m[1]), Number(m[2]), Number(m[3])]
+  if (bump === 'major') return `${major + 1}.0.0`
+  if (bump === 'minor') return `${major}.${minor + 1}.0`
+  return `${major}.${minor}.${patch + 1}`
+}
+
+/**
+ * @param {string[]} bumps непорожній список
+ * @returns {string} найвищий bump (major > minor > patch)
+ */
+export function maxBump(bumps) {
+  return VALID_BUMPS.find(level => bumps.includes(level)) ?? 'patch'
+}
+
+/**
+ * @param {string} version нова версія
+ * @param {string} date `YYYY-MM-DD`
+ * @param {Array<{ section: string, description: string }>} entries записи change-файлів
+ * @returns {string} markdown-блок секції
+ */
+export function renderChangelogSection(version, date, entries) {
+  let out = `## [${version}] - ${date}\n`
+  for (const section of VALID_SECTIONS) {
+    const bullets = entries.filter(e => e.section === section)
+    if (bullets.length === 0) continue
+    const bulletLines = bullets.map(b => '- ' + b.description).join('\n')
+    out += `\n### ${section}\n\n${bulletLines}\n`
+  }
+  return out
+}
+
+/**
+ * @param {string} existingText наявний CHANGELOG.md (може бути порожнім)
+ * @param {string} sectionBlock новий блок версії
+ * @returns {string} CHANGELOG із секцією зверху
+ */
+export function prependChangelogSection(existingText, sectionBlock) {
+  const text = existingText.trimStart()
+  if (!text.startsWith(CHANGELOG_HEADER)) {
+    return `${CHANGELOG_HEADER}\n\n${sectionBlock}`
+  }
+  const nl = text.indexOf('\n')
+  const head = text.slice(0, nl === -1 ? text.length : nl)
+  const rest = nl === -1 ? '' : text.slice(nl + 1).trimStart()
+  return `${head}\n\n${sectionBlock}\n${rest}`
+}
+
+/**
+ * @param {object} params параметри
+ * @param {string} params.currentVersion поточна version маніфесту
+ * @param {Array<{ file: string, entry: { bump: string, section: string, description: string } }>} params.changeFiles change-файли workspace
+ * @param {string} params.date `YYYY-MM-DD`
+ * @returns {{ newVersion: string, sectionBlock: string, consumedFiles: string[] } | null} результат або null, якщо змін нема
+ */
+export function aggregateWorkspace({ currentVersion, changeFiles, date }) {
+  if (changeFiles.length === 0) return null
+  const newVersion = bumpVersion(currentVersion, maxBump(changeFiles.map(c => c.entry.bump)))
+  const sectionBlock = renderChangelogSection(
+    newVersion,
+    date,
+    changeFiles.map(c => c.entry)
+  )
+  return { newVersion, sectionBlock, consumedFiles: changeFiles.map(c => c.file) }
+}

package/rules/release/lib/change-file.mjs

@@ -0,0 +1,116 @@
+/**
+ * Один change-файл `<ws>/.changes/YYMMDD-HHMM.md`: YAML-подібний frontmatter
+ * із двома ключами (`bump`, `section`) + текст опису. Парсер мінімальний — лише ці два
+ * ключі, без зовнішніх залежностей. Якщо файл за ту саму хвилину вже існує, writer додає
+ * числовий suffix (`-2`, `-3`) атомарним create-only записом.
+ */
+
+import { existsSync } from 'node:fs'
+import { readdir, readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/** Дозволені semver-бампи, від найбільшого до найменшого (порядок використовується для max). */
+export const VALID_BUMPS = Object.freeze(['major', 'minor', 'patch'])
+
+/** Дозволені Keep a Changelog секції (заголовок `### {section}`). */
+export const VALID_SECTIONS = Object.freeze(['Added', 'Changed', 'Fixed', 'Removed'])
+
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/
+
+/**
+ * @param {string} block тіло frontmatter (між `---`)
+ * @returns {Record<string, string>} пари ключ→значення
+ */
+function parseFrontmatterBlock(block) {
+  /** @type {Record<string, string>} */
+  const out = {}
+  for (const line of block.split('\n')) {
+    const idx = line.indexOf(':')
+    if (idx === -1) continue
+    out[line.slice(0, idx).trim()] = line.slice(idx + 1).trim()
+  }
+  return out
+}
+
+/**
+ * @param {string} text вміст change-файлу
+ * @returns {{ bump: string, section: string, description: string }} розпарсений запис
+ */
+export function parseChangeFile(text) {
+  const m = FRONTMATTER_RE.exec(text)
+  if (!m) throw new Error('change-файл: відсутній frontmatter `---`')
+  const fm = parseFrontmatterBlock(m[1])
+  if (!VALID_BUMPS.includes(fm.bump)) {
+    throw new Error(`change-файл: bump має бути одним із ${VALID_BUMPS.join('|')} (отримано «${fm.bump ?? ''}»)`)
+  }
+  if (!VALID_SECTIONS.includes(fm.section)) {
+    throw new Error(
+      `change-файл: section має бути одним із ${VALID_SECTIONS.join('|')} (отримано «${fm.section ?? ''}»)`
+    )
+  }
+  const description = m[2].trim()
+  if (!description) throw new Error('change-файл: порожній опис')
+  return { bump: fm.bump, section: fm.section, description }
+}
+
+/**
+ * @param {{ bump: string, section: string, description: string }} entry запис
+ * @returns {string} вміст change-файлу
+ */
+export function serializeChangeFile(entry) {
+  return `---\nbump: ${entry.bump}\nsection: ${entry.section}\n---\n${entry.description}\n`
+}
+
+/** Підкаталог зі change-файлами всередині workspace. */
+export const CHANGES_DIR = '.changes'
+
+/**
+ * @param {number} timestamp epoch milliseconds
+ * @returns {string} local timestamp prefix `YYMMDD-HHMM`
+ */
+function formatChangeTimestamp(timestamp) {
+  const d = new Date(timestamp)
+  const yy = String(d.getFullYear()).slice(-2)
+  const month = String(d.getMonth() + 1).padStart(2, '0')
+  const day = String(d.getDate()).padStart(2, '0')
+  const hour = String(d.getHours()).padStart(2, '0')
+  const minute = String(d.getMinutes()).padStart(2, '0')
+  return `${yy}${month}${day}-${hour}${minute}`
+}
+
+/**
+ * @param {number} timestamp epoch milliseconds
+ * @param {number} [sequence] collision sequence; `1`/omitted has no suffix
+ * @returns {string} `YYMMDD-HHMM.md` or `YYMMDD-HHMM-<n>.md`
+ */
+export function changeFileName(timestamp, sequence = 1) {
+  const base = formatChangeTimestamp(timestamp)
+  return sequence > 1 ? `${base}-${sequence}.md` : `${base}.md`
+}
+
+/**
+ * Базове ім'я для нового change-файлу. Унікальність забезпечує writer: він спершу
+ * пробує `YYMMDD-HHMM.md`, а suffix додає лише при локальному `EEXIST`.
+ * @returns {string} результат
+ */
+export function newChangeFileName() {
+  return changeFileName(Date.now())
+}
+
+/**
+ * @param {string} ws шлях workspace (відносно `cwd`)
+ * @param {string} [cwd] корінь репозиторію
+ * @returns {Promise<Array<{ file: string, entry: { bump: string, section: string, description: string } }>>} розпарсені change-файли
+ */
+export async function readChangeFiles(ws, cwd = process.cwd()) {
+  const dir = join(cwd, ws, CHANGES_DIR)
+  if (!existsSync(dir)) return []
+  const entries = await readdir(dir)
+  const names = entries.filter(n => n.endsWith('.md')).toSorted()
+  const result = []
+  for (const file of names) {
+    const text = await readFile(join(dir, file), 'utf8')
+    result.push({ file, entry: parseChangeFile(text) })
+  }
+  return result
+}

package/rules/release/lib/docs/aggregate.md

@@ -0,0 +1,250 @@
+---
+type: JS Module
+title: aggregate.mjs
+resource: npm/rules/release/lib/aggregate.mjs
+docgen:
+  crc: 1f78a0fe
+---
+
+Модуль `aggregate.mjs` забезпечує **агрегацію change-файлів одного workspace** у дві основні сутності:
+
+1. Новий рядок версії згідно semver-правил (`x.y.z` → бамп `major|minor|patch`).
+2. Markdown-секцію для файлу `CHANGELOG.md`, побудовану у форматі [Keep a Changelog 1.1.0](https://keepachangelog.com/uk/1.1.0/), де новіша версія додається зверху.
+
+Модуль є **чистим обчислювальним шаром** — він **не має побічних ефектів**: не читає й не пише файли, не викликає `git`, не звертається до мережі чи процесів. Усі операції зводяться до парсингу/рендерингу рядків та арифметики на номерах версії. Відповідальність за читання `CHANGELOG.md` з диску, виконання `git`-команд, видалення спожитих change-файлів та оновлення `package.json` (чи аналогічного маніфесту) лежить на викликачі — за конвенцією проєкту це `release.mjs`.
+
+Через відсутність побічних ефектів модуль легко тестується юніт-тестами без mock’ів файлової системи й використовується як деталізована «бібліотечна» частина CLI `n-rules release` для монорепо.
+
+## Експорти / API
+
+| Експорт                                                     | Тип     | Призначення                                                                      |
+| ----------------------------------------------------------- | ------- | -------------------------------------------------------------------------------- |
+| `bumpVersion(version, bump)`                                | функція | Інкремент semver-рядка згідно з рівнем бампа                                     |
+| `maxBump(bumps)`                                            | функція | Найвищий пріоритет бампа у списку (`major` > `minor` > `patch`)                  |
+| `renderChangelogSection(version, date, entries)`            | функція | Рендер однієї версійної секції у markdown                                        |
+| `prependChangelogSection(existingText, sectionBlock)`       | функція | Вставка нової секції зверху наявного `CHANGELOG.md`                              |
+| `aggregateWorkspace({ currentVersion, changeFiles, date })` | функція | Високорівневе об’єднання change-файлів workspace у `newVersion` + `sectionBlock` |
+
+Усі експорти — **іменовані** (`export function …`). Default-export відсутній.
+
+## Функції
+
+### `bumpVersion(version, bump)`
+
+**Сигнатура:** `bumpVersion(version: string, bump: 'major'|'minor'|'patch'): string`
+
+**Параметри:**
+
+- `version` — поточна версія у форматі `x.y.z`, де `x`, `y`, `z` — невід’ємні цілі (валідується регулярним виразом `^(\d+)\.(\d+)\.(\d+)$`).
+- `bump` — рівень бампа: `'major'`, `'minor'` або `'patch'`. Будь-яке інше значення (включно з `undefined`, помилковим написанням) поведеться як `'patch'` (через гілку `return` без явної перевірки).
+
+**Повертає:** новий рядок версії згідно з правилами semver:
+
+- `major` → `(major + 1).0.0`
+- `minor` → `major.(minor + 1).0`
+- `patch` (за замовчуванням у `else`-гілці) → `major.minor.(patch + 1)`
+
+**Помилки:** `Error('aggregate: невалідний semver «<version>»')`, якщо вхідний рядок не відповідає формату `x.y.z`.
+
+**Side effects:** немає.
+
+**Приклади:**
+
+- `bumpVersion('1.2.3', 'major')` → `'2.0.0'`
+- `bumpVersion('1.2.3', 'minor')` → `'1.3.0'`
+- `bumpVersion('1.2.3', 'patch')` → `'1.2.4'`
+- `bumpVersion('0.0.1', 'major')` → `'1.0.0'`
+
+### `maxBump(bumps)`
+
+**Сигнатура:** `maxBump(bumps: string[]): string`
+
+**Параметри:**
+
+- `bumps` — непорожній (за контрактом виклику) список рядків-рівнів бампа. Допускаються лише значення зі `VALID_BUMPS` (`['major', 'minor', 'patch']`), але функція не валідує їх явно.
+
+**Повертає:** найвищий рівень бампа з масиву за пріоритетом `major > minor > patch`. Якщо у `bumps` немає жодного з `VALID_BUMPS`, повертається `'patch'` (через оператор `??`).
+
+**Реалізація:** використовує `VALID_BUMPS.find(level => bumps.includes(level))`. Оскільки `VALID_BUMPS` упорядкований як `['major', 'minor', 'patch']`, `find` поверне **перший** наявний у `bumps` рівень — тобто максимальний.
+
+**Side effects:** немає.
+
+**Приклади:**
+
+- `maxBump(['patch', 'minor'])` → `'minor'`
+- `maxBump(['patch', 'major', 'minor'])` → `'major'`
+- `maxBump(['patch'])` → `'patch'`
+- `maxBump([])` → `'patch'` (через fallback `?? 'patch'`)
+
+### `renderChangelogSection(version, date, entries)`
+
+**Сигнатура:** `renderChangelogSection(version: string, date: string, entries: Array<{ section: string, description: string }>): string`
+
+**Параметри:**
+
+- `version` — нова версія (рядок `x.y.z`).
+- `date` — дата релізу у форматі `YYYY-MM-DD` (не валідується функцією).
+- `entries` — масив записів change-файлів, де кожен запис має ключі `section` (один із `VALID_SECTIONS`) та `description`. Поле `bump` тут уже не використовується.
+
+**Повертає:** markdown-рядок, який починається з заголовка `## [<version>] - <date>\n`. Далі для кожного значення з `VALID_SECTIONS` (`Added`, `Changed`, `Fixed`, `Removed`) — за наявності записів — додається блок:
+
+```
+\n### <section>\n\n- <description1>\n- <description2>\n
+```
+
+Порядок секцій у виводі **фіксований** і відповідає порядку у `VALID_SECTIONS`, незалежно від порядку записів на вході. Усередині секції рядки додаються у тому ж порядку, у якому йшли у `entries` (стабільність забезпечується `Array.prototype.filter`).
+
+Секції без записів пропускаються (`continue`).
+
+**Side effects:** немає.
+
+**Приклад:**
+
+Вхід:
+
+- `version = '1.3.0'`
+- `date = '2026-06-03'`
+- `entries = [{ section: 'Added', description: 'нова опція X' }, { section: 'Fixed', description: 'падіння на Y' }]`
+
+Вихід:
+
+```
+## [1.3.0] - 2026-06-03
+
+### Added
+
+- нова опція X
+
+### Fixed
+
+- падіння на Y
+```
+
+### `prependChangelogSection(existingText, sectionBlock)`
+
+**Сигнатура:** `prependChangelogSection(existingText: string, sectionBlock: string): string`
+
+**Параметри:**
+
+- `existingText` — наявний вміст `CHANGELOG.md` (може бути порожнім рядком, або починатися з пробільних символів).
+- `sectionBlock` — попередньо зрендерений markdown-блок (зазвичай результат `renderChangelogSection`).
+
+**Повертає:** оновлений текст `CHANGELOG.md` у форматі Keep a Changelog (новіше зверху).
+
+**Логіка:**
+
+1. `existingText.trimStart()` — обрізаються провідні пробільні символи.
+2. Якщо отриманий текст **не** починається з заголовка `# Changelog`, повертається свіжий документ: `# Changelog\n\n<sectionBlock>` (тобто все попереднє вмонтоване як «без заголовка» відкидається — викликач має самостійно дбати про коректний вхідний файл).
+3. Інакше:
+   - `head` — перший рядок до `\n` (зазвичай `# Changelog`, може містити додаткові символи у тому ж рядку).
+   - `rest` — решта тексту після першого `\n`, із обрізаним початком (`trimStart`).
+   - Повертається конкатенація `head + '\n\n' + sectionBlock + '\n' + rest`.
+4. Якщо у тексті немає жодного `\n` (тобто текст складається тільки із заголовка-рядка), `rest = ''`, що дає коректний результат із порожньою «рештою».
+
+**Side effects:** немає.
+
+**Приклади:**
+
+- Порожній `existingText`:
+  - вихід: `# Changelog\n\n<sectionBlock>`.
+- `existingText = '# Changelog\n\n## [1.0.0] - 2026-01-01\n…'`:
+  - вихід: `# Changelog\n\n<sectionBlock>\n## [1.0.0] - 2026-01-01\n…`.
+- `existingText = 'тут нічого корисного'`:
+  - вихід: `# Changelog\n\n<sectionBlock>` (попередній вміст відкидається).
+
+### `aggregateWorkspace({ currentVersion, changeFiles, date })`
+
+**Сигнатура:**
+
+```
+aggregateWorkspace({
+  currentVersion: string,
+  changeFiles: Array<{ file: string, entry: { bump: string, section: string, description: string } }>,
+  date: string,
+}): { newVersion: string, sectionBlock: string, consumedFiles: string[] } | null
+```
+
+**Параметри (іменований об’єкт):**
+
+- `currentVersion` — поточна версія маніфесту workspace (`x.y.z`).
+- `changeFiles` — масив об’єктів, що відповідає виходу `readChangeFiles` з `change-file.mjs`. Кожен елемент має `file` (ім’я файлу `.md`) та `entry` (розпарсений frontmatter + опис).
+- `date` — рядок дати `YYYY-MM-DD` для секції CHANGELOG.
+
+**Повертає:**
+
+- `null`, якщо `changeFiles.length === 0` (явна ознака «нема чого релізити»).
+- Інакше — об’єкт:
+  - `newVersion` — результат `bumpVersion(currentVersion, maxBump(<усі bumps>))`.
+  - `sectionBlock` — результат `renderChangelogSection(newVersion, date, <усі entries>)`.
+  - `consumedFiles` — імена change-файлів (`c.file`), які мають бути видалені викликачем після успішного запису маніфесту й `CHANGELOG.md`.
+
+**Side effects:** немає. Функція суто комбінує попередньо описані `bumpVersion`, `maxBump`, `renderChangelogSection`.
+
+**Контракт із викликачем:** саме виклик `release.mjs` (або тести) відповідає за:
+
+- запис `CHANGELOG.md` (зазвичай через `prependChangelogSection(readFileSync('CHANGELOG.md'), sectionBlock)`);
+- оновлення поля `version` у `package.json`;
+- видалення файлів зі списку `consumedFiles` із `<ws>/.changes/`;
+- git-операції (commit / tag / push).
+
+## Залежності
+
+### Внутрішні (цей модуль імпортує)
+
+- `./change-file.mjs`:
+  - `VALID_BUMPS` — `Object.freeze(['major', 'minor', 'patch'])` — порядок використовується у `maxBump` для пріоритету «найвищого».
+  - `VALID_SECTIONS` — `Object.freeze(['Added', 'Changed', 'Fixed', 'Removed'])` — порядок секцій у markdown-виводі `renderChangelogSection`.
+
+### Зовнішні
+
+Немає. Жодних імпортів зі стандартної бібліотеки Node.js (`node:fs`, `node:path`, `node:crypto` тощо) або сторонніх пакетів. Це підкреслює статус модуля як «pure compute».
+
+### Внутрішні константи (не експортуються)
+
+- `SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)$/` — валідація формату `x.y.z`. Розрізняє лише три цілі числа, **не** підтримує pre-release / build-metadata.
+- `CHANGELOG_HEADER = '# Changelog'` — очікуваний заголовок `CHANGELOG.md` (Keep a Changelog convention).
+
+## Потік виконання / Використання
+
+Типовий потік релізу одного workspace (з боку викликача `release.mjs`):
+
+1. **Збір change-файлів.** Викликач звертається до `readChangeFiles(ws, cwd)` з `change-file.mjs`, отримуючи `Array<{ file, entry }>` — усі `.md` із `<ws>/.changes/`, відсортовані за іменем (тобто де-факто за `timestamp`).
+2. **Отримання поточної версії.** Викликач читає `package.json` (або інший маніфест) і дістає `currentVersion`.
+3. **Дата.** Викликач формує `date = new Date().toISOString().slice(0, 10)` або еквівалент.
+4. **Агрегація.** Виклик `aggregateWorkspace({ currentVersion, changeFiles, date })`:
+   - Якщо повертає `null` — викликач пропускає workspace (нема `change-файлів`).
+   - Якщо повертає об’єкт — отримуємо `newVersion`, `sectionBlock`, `consumedFiles`.
+5. **Оновлення `CHANGELOG.md`.** Викликач читає поточний `CHANGELOG.md` (або порожній рядок, якщо файлу нема), застосовує `prependChangelogSection(existingText, sectionBlock)` і записує результат на диск.
+6. **Оновлення маніфесту.** Викликач замінює `"version"` у `package.json` на `newVersion`.
+7. **Видалення change-файлів.** Викликач видаляє файли зі списку `consumedFiles` з `<ws>/.changes/`.
+8. **Git-операції.** Викликач виконує `git add`, `git commit`, опційно `git tag` згідно з політикою релізу.
+
+### Чому split: `aggregate.mjs` без I/O, `release.mjs` з I/O
+
+- **Тестованість.** Юніт-тести викликають експорти `aggregate.mjs` із чистих вхідних даних — без файлових моків, без часу.
+- **Чітка межа відповідальності.** Помилки парсингу / валідації лежать у `change-file.mjs`, помилки I/O / git — у `release.mjs`, а помилки «бізнес-логіки» semver/CHANGELOG — тут.
+- **Передбачуваність.** Жоден виклик функцій модуля не може зіпсувати ФС чи git-стан, навіть за хибних даних — упаде лише `throw` із описом проблеми.
+
+### Особливості / гарантії
+
+- **Стабільний порядок секцій** у виводі CHANGELOG: завжди `Added` → `Changed` → `Fixed` → `Removed` (порядок із `VALID_SECTIONS`), навіть якщо у вхідному масиві records записи перемішані.
+- **Пріоритет бампа** `major > minor > patch` гарантується порядком елементів у `VALID_SECTIONS`/`VALID_BUMPS`, а не явним порівнянням рядків.
+- **Fallback `maxBump`** — якщо у `bumps` немає жодного з відомих значень, повертається `'patch'`. Однак на практиці `change-file.mjs::parseChangeFile` уже валідує `bump`, тому до `maxBump` доходять лише валідні значення.
+- **Idempotency `prependChangelogSection`** не гарантується — функція не перевіряє, чи така версія вже існує у файлі. Викликач має сам слідкувати, щоб не дублювати реліз.
+- **Формат semver** обмежений `x.y.z` без префіксів (`v1.2.3` спричинить `Error`) та без pre-release/build (`1.2.3-rc.1` теж спричинить `Error`).
+
+## Rebuild Test
+
+За цією документацією має бути можливо переписати `aggregate.mjs` з нуля, отримавши функціонально-еквівалентний модуль, який:
+
+1. Імпортує `VALID_BUMPS` і `VALID_SECTIONS` з `./change-file.mjs`.
+2. Експортує функцію `bumpVersion(version, bump)`, що валідує semver через регулярний вираз `^(\d+)\.(\d+)\.(\d+)$`, кидає `Error('aggregate: невалідний semver «…»')` за невалідним входом і повертає інкрементовану версію за правилами `major/minor/patch`, з default-гілкою `patch` для будь-якого іншого значення `bump`.
+3. Експортує функцію `maxBump(bumps)`, яка шукає у масиві `bumps` перший елемент із `VALID_BUMPS` (тобто за пріоритетом `major > minor > patch`) і повертає `'patch'`, якщо нічого не знайдено.
+4. Експортує функцію `renderChangelogSection(version, date, entries)`, що повертає рядок із заголовком `## [<version>] - <date>\n`, далі — секції у порядку `VALID_SECTIONS`, кожна з заголовком `### <section>` та bullet-списком `- <description>`, із порожніми рядками-роздільниками згідно з форматом Keep a Changelog. Секції без записів пропускаються.
+5. Експортує функцію `prependChangelogSection(existingText, sectionBlock)`, яка:
+   - Якщо `existingText.trimStart()` не починається з `# Changelog`, повертає `# Changelog\n\n<sectionBlock>`.
+   - Інакше відокремлює перший рядок (`head`) і решту (`rest`, із `trimStart`) і повертає `head + '\n\n' + sectionBlock + '\n' + rest`.
+6. Експортує функцію `aggregateWorkspace({ currentVersion, changeFiles, date })`, яка:
+   - Повертає `null`, якщо `changeFiles` порожній.
+   - Інакше повертає `{ newVersion, sectionBlock, consumedFiles }`, де `newVersion = bumpVersion(currentVersion, maxBump(<усі c.entry.bump>))`, `sectionBlock = renderChangelogSection(newVersion, date, <усі c.entry>)`, `consumedFiles = <усі c.file>`.
+7. Не виконує жодного I/O й не залежить від `node:*`.