mirror of
https://github.com/thedotmack/claude-mem
synced 2026-04-25 17:15:04 +02:00
docs: update CHANGELOG.md for v12.2.0 + make generator incremental
Script now reads existing CHANGELOG.md, skips releases already documented, only fetches bodies for new releases, and prepends them. Pass --full to force complete regeneration. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Alex Newman
@@ -1,13 +1,26 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
/**
|
||||
* Generate CHANGELOG.md from GitHub releases
|
||||
* Generate CHANGELOG.md from GitHub releases.
|
||||
*
|
||||
* Fetches all releases from GitHub and formats them into Keep a Changelog format.
|
||||
* Incremental by default: reads existing CHANGELOG.md, only fetches releases
|
||||
* newer than the newest version already documented, and prepends them.
|
||||
*
|
||||
* Pass --full to force a complete regeneration from every release.
|
||||
*/
|
||||
|
||||
import { execSync } from 'child_process';
|
||||
import { writeFileSync } from 'fs';
|
||||
import { writeFileSync, readFileSync, existsSync } from 'fs';
|
||||
|
||||
const CHANGELOG_PATH = 'CHANGELOG.md';
|
||||
const HEADER_LINES = [
|
||||
'# Changelog',
|
||||
'',
|
||||
'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/).',
|
||||
'',
|
||||
];
|
||||
|
||||
function exec(command) {
|
||||
try {
|
||||
@@ -19,28 +32,20 @@ function exec(command) {
|
||||
}
|
||||
}
|
||||
|
||||
function getReleases() {
|
||||
console.log('📋 Fetching releases from GitHub...');
|
||||
function listReleases() {
|
||||
const releasesJson = exec('gh release list --limit 1000 --json tagName,publishedAt,name');
|
||||
const releases = JSON.parse(releasesJson);
|
||||
return JSON.parse(releasesJson);
|
||||
}
|
||||
|
||||
// Fetch body for each release
|
||||
console.log(`📥 Fetching details for ${releases.length} releases...`);
|
||||
for (const release of releases) {
|
||||
const body = exec(`gh release view ${release.tagName} --json body --jq '.body'`).trim();
|
||||
release.body = body;
|
||||
}
|
||||
|
||||
return releases;
|
||||
function fetchReleaseBody(tagName) {
|
||||
return exec(`gh release view ${tagName} --json body --jq '.body'`).trim();
|
||||
}
|
||||
|
||||
function formatDate(isoDate) {
|
||||
const date = new Date(isoDate);
|
||||
return date.toISOString().split('T')[0]; // YYYY-MM-DD
|
||||
return new Date(isoDate).toISOString().split('T')[0];
|
||||
}
|
||||
|
||||
function cleanReleaseBody(body) {
|
||||
// Remove the "Generated with Claude Code" footer
|
||||
return body
|
||||
.replace(/🤖 Generated with \[Claude Code\].*$/s, '')
|
||||
.replace(/---\n*$/s, '')
|
||||
@@ -48,62 +53,92 @@ function cleanReleaseBody(body) {
|
||||
}
|
||||
|
||||
function extractVersion(tagName) {
|
||||
// Remove 'v' prefix from tag name
|
||||
return tagName.replace(/^v/, '');
|
||||
}
|
||||
|
||||
function generateChangelog(releases) {
|
||||
console.log(`📝 Generating CHANGELOG.md from ${releases.length} releases...`);
|
||||
|
||||
const lines = [
|
||||
'# Changelog',
|
||||
'',
|
||||
'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/).',
|
||||
'',
|
||||
];
|
||||
|
||||
// Sort releases by date (newest first)
|
||||
releases.sort((a, b) => new Date(b.publishedAt) - new Date(a.publishedAt));
|
||||
|
||||
for (const release of releases) {
|
||||
const version = extractVersion(release.tagName);
|
||||
const date = formatDate(release.publishedAt);
|
||||
const body = cleanReleaseBody(release.body);
|
||||
|
||||
// Add version header
|
||||
lines.push(`## [${version}] - ${date}`);
|
||||
function renderEntry(release) {
|
||||
const version = extractVersion(release.tagName);
|
||||
const date = formatDate(release.publishedAt);
|
||||
const body = cleanReleaseBody(release.body);
|
||||
const lines = [`## [${version}] - ${date}`, ''];
|
||||
if (body) {
|
||||
const bodyWithoutHeader = body.replace(/^##?\s+v?[\d.]+.*?\n\n?/m, '');
|
||||
lines.push(bodyWithoutHeader);
|
||||
lines.push('');
|
||||
|
||||
// Add release body
|
||||
if (body) {
|
||||
// Remove the initial markdown heading if it exists (e.g., "## v5.5.0 (2025-11-11)")
|
||||
const bodyWithoutHeader = body.replace(/^##?\s+v?[\d.]+.*?\n\n?/m, '');
|
||||
lines.push(bodyWithoutHeader);
|
||||
lines.push('');
|
||||
}
|
||||
}
|
||||
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
/**
|
||||
* Parse the existing CHANGELOG.md and return:
|
||||
* - knownVersions: Set of version strings already present
|
||||
* - body: the content following the standard header (entries only)
|
||||
*/
|
||||
function readExistingChangelog() {
|
||||
if (!existsSync(CHANGELOG_PATH)) {
|
||||
return { knownVersions: new Set(), body: '' };
|
||||
}
|
||||
const content = readFileSync(CHANGELOG_PATH, 'utf-8');
|
||||
const knownVersions = new Set();
|
||||
const versionHeaderRe = /^## \[([^\]]+)\]/gm;
|
||||
let match;
|
||||
while ((match = versionHeaderRe.exec(content)) !== null) {
|
||||
knownVersions.add(match[1]);
|
||||
}
|
||||
// Strip the standard header so we can re-emit it cleanly
|
||||
const firstEntryIndex = content.search(/^## \[/m);
|
||||
const body = firstEntryIndex === -1 ? '' : content.slice(firstEntryIndex);
|
||||
return { knownVersions, body };
|
||||
}
|
||||
|
||||
function main() {
|
||||
const fullRegen = process.argv.includes('--full');
|
||||
|
||||
console.log('🔧 Generating CHANGELOG.md from GitHub releases...\n');
|
||||
|
||||
const releases = getReleases();
|
||||
const { knownVersions, body: existingBody } = fullRegen
|
||||
? { knownVersions: new Set(), body: '' }
|
||||
: readExistingChangelog();
|
||||
|
||||
if (releases.length === 0) {
|
||||
console.log('📋 Fetching release list from GitHub...');
|
||||
const allReleases = listReleases();
|
||||
|
||||
if (allReleases.length === 0) {
|
||||
console.log('⚠️ No releases found');
|
||||
return;
|
||||
}
|
||||
|
||||
const changelog = generateChangelog(releases);
|
||||
const newReleases = allReleases.filter(
|
||||
(release) => !knownVersions.has(extractVersion(release.tagName)),
|
||||
);
|
||||
|
||||
writeFileSync('CHANGELOG.md', changelog, 'utf-8');
|
||||
if (newReleases.length === 0) {
|
||||
console.log('✅ CHANGELOG.md is already up to date.');
|
||||
return;
|
||||
}
|
||||
|
||||
console.log(
|
||||
`📥 Fetching bodies for ${newReleases.length} new release(s)` +
|
||||
(fullRegen ? '' : ` (${knownVersions.size} already in CHANGELOG)`) +
|
||||
'...',
|
||||
);
|
||||
for (const release of newReleases) {
|
||||
release.body = fetchReleaseBody(release.tagName);
|
||||
}
|
||||
|
||||
newReleases.sort((a, b) => new Date(b.publishedAt) - new Date(a.publishedAt));
|
||||
|
||||
const newEntriesBlock = newReleases.map(renderEntry).join('\n');
|
||||
|
||||
const finalBody = existingBody
|
||||
? `${newEntriesBlock}\n${existingBody}`.trimEnd() + '\n'
|
||||
: `${newEntriesBlock}`.trimEnd() + '\n';
|
||||
|
||||
const changelog = HEADER_LINES.join('\n') + '\n' + finalBody;
|
||||
writeFileSync(CHANGELOG_PATH, changelog, 'utf-8');
|
||||
|
||||
console.log('\n✅ CHANGELOG.md generated successfully!');
|
||||
console.log(` ${releases.length} releases processed`);
|
||||
console.log(` ${newReleases.length} new release(s) prepended`);
|
||||
}
|
||||
|
||||
main();
|
||||
|
||||
Reference in New Issue
Block a user