@oorabona/release-it-preset 1.1.0 → 1.3.0

package/bin/cli.js

@@ -46,6 +46,7 @@ const RELEASE_CONFIGS = {
 const UTILITY_COMMANDS = {
   init: 'init-project',
   update: 'populate-unreleased-changelog',
+  annotate: 'annotate-changelog',
   validate: 'validate-release',
   check: 'check-config',
   doctor: 'doctor',
@@ -76,6 +77,7 @@ Release Commands:
 Utility Commands:
   init [--yes]           Initialize project (create CHANGELOG.md, .release-it.json, etc.)
   update                 Update [Unreleased] section from commits
+  annotate               Enrich [Unreleased] entries from merged PR changelog blocks
   validate [--allow-dirty]  Validate project is ready for release
   check                  Display configuration and project status
   doctor                 Run diagnostic checklist and show readiness score
@@ -160,21 +162,19 @@ function handleReleaseCommand(configName, args) {
       const extendsPreset = extendsMatch?.[1];
 
       if (extendsPreset && extendsPreset !== configName) {
-        console.error(`\n❌ Configuration mismatch error!`);
-        console.error(`   CLI preset:               ${configName}`);
-        console.error(`   .release-it.json extends: ${extendsPreset}`);
-        console.error(``);
-        console.error(`Either:`);
-        console.error(`  1. Run: release-it-preset ${extendsPreset}`);
-        console.error(`     → Use the preset specified in your config file`);
-        console.error(``);
-        console.error(`  2. Update .release-it.json extends to: "${expectedExtends}"`);
-        console.error(`     → Match your config file to the CLI command\n`);
-        process.exit(1);
+        console.warn(`⚠️  Note: your .release-it.json extends "${extendsPreset}"`);
+        console.warn(`   but you invoked the "${configName}" preset.`);
+        console.warn(`   Using "${configName}" config directly; .release-it.json customizations are ignored for this run.`);
+        console.warn(`   To use your customizations, run: release-it-preset ${extendsPreset}`);
+        console.warn(``);
+        // Force --config flag to use OUR preset, ignore user's .release-it.json
+        fullArgs = ['--config', configPath, ...args];
+      } else {
+        console.log(`✅ Config validated: preset "${configName}"`);
+        console.log(`📝 Using: ${userConfigPath}\n`);
+        // Let release-it discover .release-it.json and merge via extends
+        fullArgs = [...args];
       }
-
-      console.log(`✅ Config validated: preset "${configName}"`);
-      console.log(`📝 Using: ${userConfigPath}\n`);
     } catch (error) {
       if (error instanceof SyntaxError) {
         console.error(`❌ Failed to parse .release-it.json: ${error.message}`);
@@ -183,9 +183,6 @@ function handleReleaseCommand(configName, args) {
       }
       process.exit(1);
     }
-
-    // Let release-it discover .release-it.json and merge via extends
-    fullArgs = [...args];
   } else {
     // No user config - use preset directly
     console.log(`📝 Using preset config directly: ${configPath}`);

package/bin/validators.js

@@ -117,6 +117,40 @@ export function sanitizeArgs(args) {
  * @throws {Error} If validation fails (invalid extension, too deep, missing file, etc.)
  * @returns {string} Absolute path to validated config file
  */
+
+/**
+ * Validates a workflow filename for use with `init --workflow-name`.
+ *
+ * Allowed: simple filenames matching ^[A-Za-z0-9._-]+\.ya?ml$
+ * Rejected: path components (subdir/), traversal (../), wrong extension.
+ *
+ * @param {string} name - The workflow filename to validate
+ * @throws {Error} If the name contains path separators, traversal, or wrong extension
+ * @returns {string} The validated filename
+ */
+export function validateWorkflowName(name) {
+  if (!name || name.length === 0) {
+    throw new Error(
+      `Workflow name cannot be empty.\n` +
+      `Expected a simple filename like "release.yml" or "publish.yml".`
+    );
+  }
+
+  // Reject any path separators or traversal — name must be a single filename component
+  const WORKFLOW_NAME_RE = /^[A-Za-z0-9._-]+\.ya?ml$/;
+  if (!WORKFLOW_NAME_RE.test(name)) {
+    throw new Error(
+      `Invalid workflow name: "${name}"\n` +
+      `Workflow name must be a simple filename matching ^[A-Za-z0-9._-]+\\.ya?ml$\n` +
+      `Examples: release.yml, publish.yml, release_it.yml\n` +
+      `Path components (subdir/foo.yml) and traversal (../etc.yml) are not allowed.`
+    );
+  }
+
+  return name;
+}
+
+
 export function validateConfigPath(configPath) {
   // 1. Whitelist config file extensions (defense in depth)
   const allowedExtensions = ['.json', '.js', '.cjs', '.mjs', '.yaml', '.yml', '.toml'];

package/dist/scripts/annotate-changelog.js

@@ -0,0 +1,546 @@
+#!/usr/bin/env tsx
+/**
+ * Annotate [Unreleased] entries from typed pull request changelog blocks.
+ */
+import { execSync } from 'node:child_process';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { ChangelogError } from './lib/errors.js';
+import { getGitHubRepoUrl } from './lib/git-utils.js';
+import { runScript } from './lib/run-script.js';
+const STANDARD_SECTION_ORDER = [
+    '### Added',
+    '### Changed',
+    '### Deprecated',
+    '### Removed',
+    '### Fixed',
+    '### Security',
+    '### ⚠️ BREAKING CHANGES',
+];
+const DEFAULT_SECTION = '### Changed';
+const BREAKING_SECTION = '### ⚠️ BREAKING CHANGES';
+const CHANGELOG_TYPE_TO_SECTION = {
+    added: '### Added',
+    changed: '### Changed',
+    deprecated: '### Deprecated',
+    removed: '### Removed',
+    fixed: '### Fixed',
+    security: '### Security',
+};
+const GH_JSON_OPTIONS = { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] };
+export function extractUnreleasedBlock(changelog, changelogPath = 'CHANGELOG.md') {
+    const headerRegex = /^## \[Unreleased\][^\n]*(?:\r?\n|$)/m;
+    const headerMatch = headerRegex.exec(changelog);
+    if (!headerMatch) {
+        throw new ChangelogError(`No [Unreleased] section found in ${changelogPath}. Run release-it-preset update first.`);
+    }
+    const bodyStart = headerMatch.index + headerMatch[0].length;
+    const rest = changelog.slice(bodyStart);
+    const nextSectionMatch = /^## \[/m.exec(rest);
+    const bodyEnd = nextSectionMatch ? bodyStart + nextSectionMatch.index : changelog.length;
+    return {
+        prefix: changelog.slice(0, bodyStart),
+        body: changelog.slice(bodyStart, bodyEnd),
+        suffix: changelog.slice(bodyEnd),
+    };
+}
+export function normalizeSectionHeading(rawHeading) {
+    const stripped = rawHeading.replace(/^#+\s*/, '').trim();
+    if (/breaking[-\s]+changes?/i.test(stripped) || /breaking/i.test(stripped)) {
+        return BREAKING_SECTION;
+    }
+    const standard = STANDARD_SECTION_ORDER.find(heading => heading.replace(/^###\s*/, '').toLowerCase() === stripped.toLowerCase());
+    if (standard) {
+        return standard;
+    }
+    return stripped ? `### ${stripped}` : DEFAULT_SECTION;
+}
+export function extractCommitShas(value) {
+    // Only the generated TRAILING reference identifies the bullet's commit.
+    // Annotated bullets import author text verbatim, so a /commit/ URL or a
+    // hex word inside the prose must never re-key the bullet to another
+    // commit (and through it, another PR) on the next run.
+    const trailingLink = value.match(/\(\[([0-9a-f]{7,40})\]\([^)]*\/commit\/[0-9a-f]{7,40}\)\)\s*$/i);
+    if (trailingLink) {
+        return [trailingLink[1].toLowerCase()];
+    }
+    const bareReference = value.match(/\(([0-9a-f]{7,40})\)\s*$/i);
+    if (bareReference) {
+        return [bareReference[1].toLowerCase()];
+    }
+    return [];
+}
+export function extractPrNumber(value) {
+    // The generated trailing reference always wins: annotated bullets carry
+    // author text verbatim, and an embedded "PR #72" or /pull/72 in that prose
+    // must not out-rank the (#N) suffix appended by annotate itself.
+    const squashSuffix = value.match(/\(#(\d{1,10})\)(?:\s+\(\[[0-9a-f]{7,40}\]\([^)]*\)\))?\s*$/i);
+    if (squashSuffix) {
+        return Number.parseInt(squashSuffix[1], 10);
+    }
+    const explicitPr = value.match(/\bPR\s+#(\d{1,10})\b/i);
+    if (explicitPr) {
+        return Number.parseInt(explicitPr[1], 10);
+    }
+    const pullUrl = value.match(/\/pull\/(\d{1,10})\b/i);
+    if (pullUrl) {
+        return Number.parseInt(pullUrl[1], 10);
+    }
+    return null;
+}
+export function choosePrimarySha(values) {
+    for (const value of values) {
+        if (typeof value === 'string' && /^[0-9a-f]{7,40}$/i.test(value)) {
+            return value.toLowerCase();
+        }
+    }
+    return null;
+}
+export function parseUnreleasedEntries(body) {
+    const entries = [];
+    const sections = [{ heading: null, items: [] }];
+    let order = 0;
+    const currentSection = () => sections[sections.length - 1];
+    const sectionHeadingOf = (section) => section.heading ?? DEFAULT_SECTION;
+    for (const line of body.split(/\r?\n/)) {
+        const headingMatch = line.match(/^###\s+(.+?)\s*$/);
+        if (headingMatch) {
+            sections.push({ heading: normalizeSectionHeading(line), items: [] });
+            continue;
+        }
+        const bulletMatch = line.match(/^-\s+(.+?)\s*$/);
+        if (bulletMatch) {
+            const text = bulletMatch[1].trim();
+            const entry = {
+                section: sectionHeadingOf(currentSection()),
+                text,
+                rawLine: line.replace(/\s+$/, ''),
+                shaList: extractCommitShas(text),
+                prNumber: extractPrNumber(text),
+                order,
+            };
+            entries.push(entry);
+            currentSection().items.push({ kind: 'entry', entry });
+            order += 1;
+            continue;
+        }
+        // Indented continuation of a wrapped bullet: it belongs to that bullet
+        // and must travel with it (or stay with it) — never hoisted as a note.
+        const items = currentSection().items;
+        const lastItem = items[items.length - 1];
+        if (/^\s+\S/.test(line) && lastItem?.kind === 'entry') {
+            lastItem.entry.rawLine += `\n${line.replace(/\s+$/, '')}`;
+            lastItem.entry.text += ` ${line.trim()}`;
+            lastItem.entry.shaList = extractCommitShas(lastItem.entry.text);
+            lastItem.entry.prNumber = extractPrNumber(lastItem.entry.text);
+            continue;
+        }
+        if (line.trim() && line.trim() !== 'No changes yet.') {
+            currentSection().items.push({ kind: 'note', line: line.replace(/\s+$/, '') });
+        }
+    }
+    return { entries, sections };
+}
+export function groupEntriesForLookup(entries) {
+    const byKey = new Map();
+    const passthrough = [];
+    for (const entry of entries) {
+        if (entry.section === BREAKING_SECTION) {
+            passthrough.push(entry);
+            continue;
+        }
+        // The commit sha is the authoritative key: the commits/<sha>/pulls
+        // endpoint returns the true merged PR, while a textual (#N) may be an
+        // issue reference. Only sha-less entries fall back to the PR number.
+        if (entry.prNumber !== null && entry.shaList.length === 0) {
+            const key = `pr:${entry.prNumber}`;
+            const existing = byKey.get(key);
+            if (existing) {
+                existing.entries.push(entry);
+                existing.primarySha = choosePrimarySha([existing.primarySha, ...entry.shaList]);
+            }
+            else {
+                byKey.set(key, {
+                    key,
+                    kind: 'pr',
+                    ref: String(entry.prNumber),
+                    entries: [entry],
+                    primarySha: choosePrimarySha(entry.shaList),
+                });
+            }
+            continue;
+        }
+        const primarySha = choosePrimarySha(entry.shaList);
+        if (!primarySha) {
+            passthrough.push(entry);
+            continue;
+        }
+        const key = `sha:${primarySha}`;
+        const existing = byKey.get(key);
+        if (existing) {
+            existing.entries.push(entry);
+            existing.primarySha = choosePrimarySha([existing.primarySha, ...entry.shaList]);
+        }
+        else {
+            byKey.set(key, {
+                key,
+                kind: 'sha',
+                ref: primarySha,
+                entries: [entry],
+                primarySha,
+            });
+        }
+    }
+    return { groups: [...byKey.values()], passthrough };
+}
+function errorText(error) {
+    if (error instanceof Error) {
+        const stderr = error.stderr;
+        const stdout = error.stdout;
+        const pieces = [
+            error.message,
+            Buffer.isBuffer(stderr) ? stderr.toString('utf8') : stderr,
+            Buffer.isBuffer(stdout) ? stdout.toString('utf8') : stdout,
+        ].filter((piece) => typeof piece === 'string' && piece.trim().length > 0);
+        return pieces.join('\n');
+    }
+    return String(error);
+}
+function parseGhJson(command, output) {
+    try {
+        return JSON.parse(output);
+    }
+    catch (error) {
+        throw new ChangelogError(`GitHub CLI command returned invalid JSON: ${command}\n${errorText(error)}`);
+    }
+}
+function execGhJson(command, deps) {
+    try {
+        const output = deps.execSync(command, GH_JSON_OPTIONS);
+        return parseGhJson(command, output);
+    }
+    catch (error) {
+        if (error instanceof ChangelogError) {
+            throw error;
+        }
+        throw new ChangelogError(`GitHub CLI command failed: ${command}\n${errorText(error)}`);
+    }
+}
+function validatePrInfo(value, command) {
+    if (!value || typeof value !== 'object') {
+        throw new ChangelogError(`GitHub CLI command returned an invalid pull request response: ${command}`);
+    }
+    const maybe = value;
+    if (typeof maybe.number !== 'number' || !Number.isInteger(maybe.number)) {
+        throw new ChangelogError(`GitHub CLI command returned a pull request without a number: ${command}`);
+    }
+    return {
+        number: maybe.number,
+        body: typeof maybe.body === 'string' ? maybe.body : null,
+        merged_at: typeof maybe.merged_at === 'string' ? maybe.merged_at : null,
+    };
+}
+export function fetchPullRequestByNumber(prNumber, ownerRepo, deps) {
+    // --repo pins the lookup to the remote-derived repository: without it gh
+    // infers the repo from cwd/GH_REPO and forks or CI checkouts can answer
+    // for the wrong repository.
+    const command = `gh pr view ${prNumber} --repo ${ownerRepo} --json number,body,mergedAt`;
+    try {
+        const output = deps.execSync(command, GH_JSON_OPTIONS);
+        const parsed = parseGhJson(command, output);
+        // An open or closed-unmerged PR is not part of release history — its
+        // body must never regenerate changelog entries.
+        if (typeof parsed?.mergedAt !== 'string') {
+            return null;
+        }
+        return validatePrInfo(parsed, command);
+    }
+    catch (error) {
+        if (error instanceof ChangelogError) {
+            throw error;
+        }
+        // A (#NNN) reference in bullet text may point at an issue, not a PR —
+        // that is the author's text, not an annotation candidate. Only this
+        // not-a-PR shape is benign; auth/network/API failures stay fatal.
+        if (/could not resolve to a PullRequest|no pull requests? found|not found/i.test(errorText(error))) {
+            return null;
+        }
+        throw new ChangelogError(`GitHub CLI command failed: ${command}\n${errorText(error)}`);
+    }
+}
+export function fetchPullRequestBySha(sha, ownerRepo, deps) {
+    const command = `gh api repos/${ownerRepo}/commits/${sha}/pulls --jq '[.[] | {number: .number, body: .body, merged_at: .merged_at}]'`;
+    let parsed;
+    try {
+        parsed = execGhJson(command, deps);
+    }
+    catch (error) {
+        // A sha that GitHub does not know (rebased away, or a hex-looking word
+        // that slipped through extraction) is the author's text, not annotate's
+        // business — benign passthrough. Auth/network failures stay fatal.
+        if (/not found|HTTP 404/i.test(errorText(error))) {
+            return null;
+        }
+        throw error;
+    }
+    if (!Array.isArray(parsed)) {
+        throw new ChangelogError(`GitHub CLI command returned an invalid pulls response: ${command}`);
+    }
+    const merged = parsed.find(item => item && typeof item === 'object' && typeof item.merged_at === 'string');
+    return merged ? validatePrInfo(merged, command) : null;
+}
+function ownerRepoFromUrl(repoUrl) {
+    const match = repoUrl.trim().replace(/\/$/, '').match(/^https:\/\/github\.com\/([^/\s]+\/[^/\s]+)$/);
+    if (!match) {
+        return null;
+    }
+    const ownerRepo = match[1].replace(/\.git$/, '');
+    return /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(ownerRepo) ? ownerRepo : null;
+}
+function getRequiredGitHubContext(deps) {
+    const repoUrl = getGitHubRepoUrl({
+        execSync: deps.execSync,
+        getEnv: deps.getEnv,
+        warn: deps.warn,
+    }).replace(/\/$/, '');
+    const ownerRepo = ownerRepoFromUrl(repoUrl);
+    if (!repoUrl || !ownerRepo) {
+        throw new ChangelogError('Could not determine GitHub repository. Set GITHUB_REPOSITORY or configure a GitHub origin remote before running annotate.');
+    }
+    return { repoUrl, ownerRepo };
+}
+export function resolvePullRequestGroups(groups, ownerRepo, deps) {
+    const byPrNumber = new Map();
+    const unresolved = [];
+    for (const group of groups) {
+        const pr = group.kind === 'pr'
+            ? fetchPullRequestByNumber(Number.parseInt(group.ref, 10), ownerRepo, deps)
+            : fetchPullRequestBySha(group.ref, ownerRepo, deps);
+        if (!pr) {
+            unresolved.push(...group.entries);
+            continue;
+        }
+        const existing = byPrNumber.get(pr.number);
+        if (existing) {
+            existing.entries.push(...group.entries);
+            existing.primarySha = choosePrimarySha([
+                existing.primarySha,
+                group.primarySha,
+                ...group.entries.flatMap(entry => entry.shaList),
+            ]);
+        }
+        else {
+            byPrNumber.set(pr.number, {
+                pr,
+                entries: [...group.entries],
+                primarySha: choosePrimarySha([group.primarySha, ...group.entries.flatMap(entry => entry.shaList)]),
+            });
+        }
+    }
+    return {
+        resolved: [...byPrNumber.values()].sort((a, b) => {
+            const aOrder = Math.min(...a.entries.map(entry => entry.order));
+            const bOrder = Math.min(...b.entries.map(entry => entry.order));
+            return aOrder - bOrder;
+        }),
+        unresolved,
+    };
+}
+function warnForPr(prNumber, deps, message) {
+    deps.warn?.(`Ignoring changelog block in PR #${prNumber}: ${message}`);
+}
+function normalizeBlockText(value) {
+    return value
+        .replace(/\r\n/g, '\n')
+        .replace(/\r/g, '\n')
+        .trim()
+        .replace(/\s*\n\s*/g, ' ')
+        .replace(/[ \t]+/g, ' ')
+        .trim();
+}
+export function extractStructuredChangelogNotes(body, options = {}) {
+    if (!body) {
+        return [];
+    }
+    const notes = [];
+    const normalizedBody = body.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const openMarker = /<!--\s*changelog\s*:\s*([a-z]+)\s*-->/gi;
+    const closeMarker = /<!--\s*\/changelog\s*-->/i;
+    const prNumber = options.prNumber ?? 0;
+    for (const match of normalizedBody.matchAll(openMarker)) {
+        const type = match[1].toLowerCase();
+        const contentStart = match.index + match[0].length;
+        const rest = normalizedBody.slice(contentStart);
+        const closeMatch = closeMarker.exec(rest);
+        if (!closeMatch) {
+            warnForPr(prNumber, options, 'unclosed marker');
+            continue;
+        }
+        const section = CHANGELOG_TYPE_TO_SECTION[type];
+        if (!section) {
+            warnForPr(prNumber, options, `unknown changelog type "${type}"`);
+            continue;
+        }
+        const rawContent = rest.slice(0, closeMatch.index);
+        // A second open marker before the close means overlapping blocks: the
+        // outer region is malformed and must never leak a raw marker (or
+        // duplicated text) into the changelog. The inner block, if well-formed,
+        // is still picked up by its own matchAll iteration.
+        if (/<!--\s*changelog\s*:/i.test(rawContent)) {
+            warnForPr(prNumber, options, `nested changelog marker inside ${type} block`);
+            continue;
+        }
+        const text = normalizeBlockText(rawContent);
+        if (!text) {
+            warnForPr(prNumber, options, `empty ${type} block`);
+            continue;
+        }
+        notes.push({ section, text });
+    }
+    return notes;
+}
+// Only the CURRENT PR's own reference is stripped before re-appending it:
+// a foreign trailing reference like "fixes issue (#123)" is the author's
+// text and must survive verbatim.
+function stripAnnotationReferences(text, prNumber) {
+    const ownReference = new RegExp(`\\s+\\(#${prNumber}\\)(?:\\s+\\(\\[[0-9a-f]{7,40}\\]\\([^)]+/commit/[0-9a-f]{7,40}\\)\\))?$`, 'i');
+    return text
+        .replace(ownReference, '')
+        .replace(/\s+\(\[[0-9a-f]{7,40}\]\([^)]+\/commit\/[0-9a-f]{7,40}\)\)$/i, '')
+        .trim();
+}
+function formatCommitReference(primarySha, repoUrl) {
+    if (!primarySha) {
+        return '';
+    }
+    const shortSha = primarySha.substring(0, 7);
+    return ` ([${shortSha}](${repoUrl}/commit/${shortSha}))`;
+}
+function formatNote(note, primarySha, repoUrl, prNumber) {
+    const text = stripAnnotationReferences(note.text, prNumber);
+    const reference = ` (#${prNumber})${formatCommitReference(primarySha, repoUrl)}`;
+    return {
+        section: note.section,
+        text: `${text}${reference}`,
+        rawLine: `- ${text}${reference}`,
+        shaList: primarySha ? [primarySha] : [],
+        prNumber,
+        order: Number.MAX_SAFE_INTEGER,
+    };
+}
+function notesForResolvedGroup(group, deps) {
+    return extractStructuredChangelogNotes(group.pr.body, { prNumber: group.pr.number, warn: deps.warn });
+}
+export function renderAnnotatedBody(parsed, resolvedGroups, repoUrl, deps) {
+    const removedEntries = new Set();
+    const additionsBySection = new Map();
+    let annotatedGroups = 0;
+    for (const group of resolvedGroups) {
+        const notes = notesForResolvedGroup(group, deps);
+        if (notes.length === 0) {
+            continue;
+        }
+        annotatedGroups += 1;
+        // The PR body is mutable post-merge: name every source PR so the
+        // maintainer knows exactly what to review in the resulting diff.
+        deps.log(`- PR #${group.pr.number}: ${notes.length} changelog block(s) applied`);
+        for (const entry of group.entries) {
+            removedEntries.add(entry);
+        }
+        const primarySha = choosePrimarySha([group.primarySha, ...group.entries.flatMap(entry => entry.shaList)]);
+        for (const note of notes) {
+            const formatted = formatNote(note, primarySha, repoUrl, group.pr.number);
+            const list = additionsBySection.get(formatted.section) ?? [];
+            list.push(formatted);
+            additionsBySection.set(formatted.section, list);
+        }
+    }
+    // Nothing was annotated: re-rendering would only restructure the existing
+    // body without adding any information — the caller must leave the file
+    // untouched.
+    if (annotatedGroups === 0) {
+        return null;
+    }
+    // Everything that is not replaced is preserved in place: sections keep
+    // their original order and internal layout (notes, wrapped bullets);
+    // replacement bullets append at the end of their target section; sections
+    // that only exist in the additions are appended in canonical order.
+    const lines = [];
+    const emittedHeadings = new Set();
+    const emitSection = (heading, items, additions) => {
+        const keptItems = items.filter(item => item.kind === 'note' || !removedEntries.has(item.entry));
+        if (keptItems.length === 0 && additions.length === 0) {
+            return;
+        }
+        if (heading !== null) {
+            lines.push(heading);
+        }
+        for (const item of keptItems) {
+            lines.push(item.kind === 'note' ? item.line : item.entry.rawLine);
+        }
+        for (const added of additions) {
+            lines.push(added.rawLine);
+        }
+        lines.push('');
+    };
+    for (const section of parsed.sections) {
+        const additions = section.heading !== null ? (additionsBySection.get(section.heading) ?? []) : [];
+        if (section.heading !== null) {
+            emittedHeadings.add(section.heading);
+        }
+        emitSection(section.heading, section.items, additions);
+    }
+    const pendingHeadings = [...additionsBySection.keys()].filter(heading => !emittedHeadings.has(heading));
+    const orderedPending = [
+        ...STANDARD_SECTION_ORDER.filter(heading => pendingHeadings.includes(heading)),
+        ...pendingHeadings.filter(heading => !STANDARD_SECTION_ORDER.includes(heading)),
+    ];
+    for (const heading of orderedPending) {
+        emitSection(heading, [], additionsBySection.get(heading) ?? []);
+    }
+    return `\n${lines.join('\n').trim()}\n\n`;
+}
+function readChangelog(changelogPath, deps) {
+    try {
+        return deps.readFileSync(changelogPath, 'utf8');
+    }
+    catch (error) {
+        throw new ChangelogError(`Could not read ${changelogPath}. Run release-it-preset update first.\n${errorText(error)}`);
+    }
+}
+export function annotateChangelog(deps) {
+    const changelogPath = deps.getEnv('CHANGELOG_FILE') || 'CHANGELOG.md';
+    deps.log('Annotating [Unreleased] section...');
+    const changelog = readChangelog(changelogPath, deps);
+    const block = extractUnreleasedBlock(changelog, changelogPath);
+    const parsed = parseUnreleasedEntries(block.body);
+    if (parsed.entries.length === 0) {
+        deps.log('No changelog entries found in [Unreleased]');
+        return;
+    }
+    const { groups } = groupEntriesForLookup(parsed.entries);
+    if (groups.length === 0) {
+        deps.log('No PR or commit references found in [Unreleased]');
+        return;
+    }
+    const { repoUrl, ownerRepo } = getRequiredGitHubContext(deps);
+    const resolved = resolvePullRequestGroups(groups, ownerRepo, deps);
+    const nextBody = renderAnnotatedBody(parsed, resolved.resolved, repoUrl, deps);
+    if (nextBody === null) {
+        deps.log('No changelog blocks found in the resolved pull requests — nothing to annotate');
+        return;
+    }
+    deps.writeFileSync(changelogPath, `${block.prefix}${nextBody}${block.suffix}`);
+    deps.log(`Annotated ${resolved.resolved.length} pull request(s)`);
+}
+/* c8 ignore start */
+if (import.meta.url === `file://${process.argv[1]}`) {
+    void runScript({ error: console.error, exit: process.exit }, () => annotateChangelog({
+        execSync,
+        readFileSync,
+        writeFileSync,
+        getEnv: (key) => process.env[key],
+        log: console.log,
+        warn: console.warn,
+    }));
+}
+/* c8 ignore end */