feat: add changelog generation integrated into release process

- Add conventional commit parsing to generate changelog
- Create/update CHANGELOG.md during release
- Add GitHub workflow to auto-create releases from tags
- Use softprops/action-gh-release@v2 instead of deprecated action
- Generate categorized changelog with commit links

Author: Priestch

.github/workflows/release.yml

@@ -0,0 +1,66 @@
+name: Create Release
+
+on:
+  push:
+    tags:
+      - '*-v[0-9]*.[0-9]*.[0-9]*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Extract package name and version from tag
+        id: tag
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          # Tag format: <package>-v<version>  (e.g. markopress-v0.1.0)
+          if [[ ! "$TAG" =~ ^(.+)-v([0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?)$ ]]; then
+            echo "Invalid tag format: $TAG" >&2
+            exit 1
+          fi
+          PKG_NAME="${BASH_REMATCH[1]}"
+          VERSION="${BASH_REMATCH[2]}"
+          IS_PRERELEASE=false
+          if [[ "$VERSION" == *-* ]]; then
+            IS_PRERELEASE=true
+          fi
+          echo "pkg_name=${PKG_NAME}" >> "$GITHUB_OUTPUT"
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "is_prerelease=${IS_PRERELEASE}" >> "$GITHUB_OUTPUT"
+
+      - name: Extract changelog entry for this version
+        id: changelog
+        run: |
+          CHANGELOG="packages/${{ steps.tag.outputs.pkg_name }}/CHANGELOG.md"
+          if [ ! -f "$CHANGELOG" ]; then
+            echo "body=No changelog found." >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          # Extract the section for the released version between ## headings
+          VERSION="${{ steps.tag.outputs.version }}"
+          BODY=$(awk "/^## \[${VERSION}\]/{found=1; next} found && /^## /{exit} found{print}" "$CHANGELOG")
+          if [ -z "$BODY" ]; then
+            BODY="_No changelog entry found for v${VERSION}._"
+          fi
+          # Use a delimiter to preserve multi-line content
+          {
+            echo "body<<CHANGELOG_EOF"
+            echo "$BODY"
+            echo "CHANGELOG_EOF"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: ${{ steps.tag.outputs.pkg_name }} v${{ steps.tag.outputs.version }}
+          body: ${{ steps.changelog.outputs.body }}
+          draft: false
+          prerelease: ${{ steps.tag.outputs.is_prerelease == 'true' }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

scripts/release.js

@@ -1,5 +1,5 @@
 import { readFileSync, writeFileSync, readdirSync, existsSync } from 'node:fs'
-import { resolve, join } from 'node:path'
+import { resolve, join, relative } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import c from 'picocolors'
 import prompts from 'prompts'
@@ -49,8 +49,113 @@ const run = (bin, args, opts = {}) => {
   return execa(bin, args, { stdio: 'inherit', ...opts })
 }
 
+// Always executes regardless of DRY_RUN (read-only git operations)
+const runRead = (bin, args, opts = {}) =>
+  execa(bin, args, { stdio: 'pipe', ...opts })
+
 const step = (msg) => console.log(c.cyan(msg))
 
+// Conventional commit type → changelog section title
+const COMMIT_TYPES = {
+  feat: '✨ Features',
+  fix: '🐛 Bug Fixes',
+  perf: '⚡ Performance Improvements',
+  refactor: '♻️ Refactoring',
+  docs: '📝 Documentation',
+  build: '🏗️ Build System',
+  ci: '👷 CI/CD',
+  test: '✅ Tests',
+  chore: '🔧 Chores'
+}
+
+async function getLastTag(pkgName) {
+  try {
+    const { stdout } = await runRead('git', [
+      'tag', '--sort=-creatordate', '--list', `${pkgName}-v*`
+    ], { cwd: rootDir })
+    const tags = stdout.trim().split('\n').filter(Boolean)
+    return tags[0] || null
+  } catch {
+    return null
+  }
+}
+
+async function getCommitsSince(tag, pkgDir) {
+  const range = tag ? `${tag}..HEAD` : 'HEAD'
+  const relPath = relative(rootDir, pkgDir)
+  try {
+    const { stdout } = await runRead('git', [
+      'log', range, '--format=%H|%s', '--', relPath
+    ], { cwd: rootDir })
+    return stdout.trim().split('\n').filter(Boolean)
+  } catch {
+    return []
+  }
+}
+
+function parseConventionalCommit(line) {
+  const [hash, ...rest] = line.split('|')
+  const subject = rest.join('|')
+  // Matches: type(scope)!: description  or  type!: description  or  type: description
+  const match = subject.match(/^(\w+)(\([^)]+\))?(!)?:\s+(.+)$/)
+  if (!match) return null
+  const [, type, scope, breaking, description] = match
+  return {
+    hash: hash.substring(0, 7),
+    type,
+    scope: scope ? scope.slice(1, -1) : null,
+    breaking: !!breaking,
+    description
+  }
+}
+
+function generateChangelogEntry(version, commits) {
+  const date = new Date().toISOString().split('T')[0]
+  const categories = { breaking: [], ...Object.fromEntries(Object.keys(COMMIT_TYPES).map(k => [k, []])) }
+
+  for (const line of commits) {
+    const commit = parseConventionalCommit(line)
+    if (!commit) continue
+    if (commit.breaking) categories.breaking.push(commit)
+    if (categories[commit.type]) categories[commit.type].push(commit)
+  }
+
+  const sections = [
+    { key: 'breaking', title: '⚠️ Breaking Changes' },
+    ...Object.entries(COMMIT_TYPES).map(([key, title]) => ({ key, title }))
+  ]
+
+  let content = `## [${version}] - ${date}\n\n`
+  let hasContent = false
+
+  for (const { key, title } of sections) {
+    if (!categories[key] || categories[key].length === 0) continue
+    hasContent = true
+    content += `### ${title}\n\n`
+    for (const commit of categories[key]) {
+      const scope = commit.scope ? `**${commit.scope}:** ` : ''
+      content += `- ${scope}${commit.description} ([${commit.hash}](https://github.com/Priestch/markopress/commit/${commit.hash}))\n`
+    }
+    content += '\n'
+  }
+
+  if (!hasContent) {
+    content += '_No significant changes_\n\n'
+  }
+
+  return content
+}
+
+function updateChangelog(changelogPath, entry) {
+  const header = '# Changelog\n\n'
+  let existing = ''
+  if (existsSync(changelogPath)) {
+    existing = readFileSync(changelogPath, 'utf-8').replace(/^# Changelog\n\n/, '')
+  }
+  // Ensure blank line between entries
+  writeFileSync(changelogPath, header + entry + '\n' + existing)
+}
+
 async function main() {
   if (DRY_RUN) {
     console.log(c.yellow('🧪 DRY RUN MODE - No actual changes will be made\n'))
@@ -157,6 +262,27 @@ async function main() {
   step('\nUpdating the package version...')
   updatePackage(pkgDir, targetVersion)
 
+  const pkgName = pkg.name.replace(/^@[^/]+\//, '') // Remove scope for tag/commit message and changelog lookup
+
+  // Generate changelog.
+  step('\nGenerating changelog...')
+  const lastTag = await getLastTag(pkgName)
+  const commits = await getCommitsSince(lastTag, pkgDir)
+  if (lastTag) {
+    console.log(c.gray(`  Commits since ${lastTag}: ${commits.length}`))
+  } else {
+    console.log(c.gray(`  No previous tag found, including all commits (${commits.length})`))
+  }
+  const changelogEntry = generateChangelogEntry(targetVersion, commits)
+  const changelogPath = join(pkgDir, 'CHANGELOG.md')
+  if (!DRY_RUN) {
+    updateChangelog(changelogPath, changelogEntry)
+    console.log(c.green('✓ CHANGELOG.md updated'))
+  } else {
+    console.log(c.gray('[dry-run] Would update CHANGELOG.md:'))
+    console.log(c.gray(changelogEntry))
+  }
+
   // Build the package.
   step('\nBuilding the package...')
   await run('pnpm', ['build'], { cwd: pkgDir })
@@ -172,7 +298,6 @@ async function main() {
 
   // Commit changes to the Git and create a tag.
   step('\nCommitting changes...')
-  const pkgName = pkg.name.replace(/^@[^/]+\//, '') // Remove scope for cleaner commit message
 
   // Stage all changes (root + package)
   await run('git', ['add', '-A'], { cwd: rootDir })