/changelog-automation

name: changelog-automation
description: Git history'den otomatik changelog, semantic versioning, release notes, conventional commits

Changelog Automation

Conventional Commits

Commit mesajlari bu formatta olmali:

<type>(<scope>): <description>

[optional body]

[optional footer(s)]

Type'lar

| Type | Aciklama | SemVer Etkisi | |------|---------|---------------| | feat | Yeni ozellik | MINOR | | fix | Bug fix | PATCH | | docs | Dokumantasyon | - | | style | Formatting (kod degisikligi yok) | - | | refactor | Kod degisikligi (feature/fix degil) | - | | perf | Performans iyilestirme | PATCH | | test | Test ekleme/duzeltme | - | | chore | Build, CI, tooling | - | | ci | CI/CD degisikligi | - | | build | Build sistemi degisikligi | - | | revert | Geri alma | PATCH |

Breaking Change

feat(api)!: remove deprecated endpoints

BREAKING CHANGE: /v1/users endpoint kaldirildi, /v2/users kullanin

`!` isareti veya `BREAKING CHANGE:` footer'i = MAJOR versiyon artisi.

Semantic Versioning (SemVer)

MAJOR.MINOR.PATCH

MAJOR: Breaking change (geriye uyumsuz)
MINOR: Yeni ozellik (geriye uyumlu)
PATCH: Bug fix (geriye uyumlu)

Versiyon Artirma Kurallari

Commit'lerde BREAKING CHANGE varsa → MAJOR++
Commit'lerde feat varsa → MINOR++
Sadece fix/perf/refactor varsa → PATCH++
Sadece docs/style/test/chore varsa → versiyon artmaz

CHANGELOG.md Formati (Keep a Changelog)

# Changelog

All notable changes to this project will be documented in this file.

## [Unreleased]

## [1.2.0] - 2026-03-25

### Added
- Yeni ozellik aciklamasi (#123)

### Changed
- Degisiklik aciklamasi (#124)

### Deprecated
- Kaldirilacak ozellik uyarisi

### Removed
- Kaldirilan ozellik

### Fixed
- Bug fix aciklamasi (#125)

### Security
- Guvenlik duzeltmesi

## [1.1.0] - 2026-03-20

### Added
- ...

[Unreleased]: https://github.com/user/repo/compare/v1.2.0...HEAD
[1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0
[1.1.0]: https://github.com/user/repo/releases/tag/v1.1.0

Type -> Section Mapping

| Commit Type | Changelog Section | |-------------|------------------| | feat | Added | | fix | Fixed | | perf | Changed | | refactor | Changed | | docs | - (changelog'a eklenmez) | | style | - | | test | - | | chore | - | | BREAKING CHANGE | Removed / Changed (breaking note ile) | | security fix | Security | | deprecation | Deprecated |

Changelog Olusturma

Git Log'dan Changelog

# Son tag'den bu yana commit'ler
git log $(git describe --tags --abbrev=0)..HEAD --pretty=format:"%s" --no-merges

# Tum tag'ler arasi
git log v1.0.0..v1.1.0 --pretty=format:"- %s (%h)" --no-merges

# Conventional commit parse
git log --pretty=format:"%s" | grep -E "^(feat|fix|refactor|perf|docs|test|chore|ci|build)"

Otomatik Changelog Script

# Son release'den bu yana degisiklikleri kategorize et
LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")

if [ -z "$LAST_TAG" ]; then
  RANGE="HEAD"
else
  RANGE="${LAST_TAG}..HEAD"
fi

echo "## [Unreleased]"
echo ""

echo "### Added"
git log $RANGE --pretty=format:"- %s" --no-merges | grep "^- feat" | sed 's/^- feat[^:]*: /- /'

echo ""
echo "### Fixed"
git log $RANGE --pretty=format:"- %s" --no-merges | grep "^- fix" | sed 's/^- fix[^:]*: /- /'

echo ""
echo "### Changed"
git log $RANGE --pretty=format:"- %s" --no-merges | grep -E "^- (refactor|perf)" | sed 's/^- [^:]*: /- /'

Release Notes

GitHub Release Olusturma

# Changelog'dan release notes
VERSION="v1.2.0"
NOTES=$(cat <<'EOF'
## What's New

### Features
- Feature 1 description
- Feature 2 description

### Bug Fixes
- Fix 1 description

### Breaking Changes
- Breaking change description

**Full Changelog**: https://github.com/user/repo/compare/v1.1.0...v1.2.0
EOF
)

gh release create "$VERSION" --title "$VERSION" --notes "$NOTES"

Pre-release

gh release create "v2.0.0-beta.1" --prerelease --title "v2.0.0 Beta 1" --notes "..."

CI/CD Entegrasyonu

GitHub Actions Changelog

name: Release
on:
  push:
    tags: ['v*']

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Generate changelog
        run: |
          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
          if [ -n "$PREV_TAG" ]; then
            git log ${PREV_TAG}..HEAD --pretty=format:"- %s" --no-merges > RELEASE_NOTES.md
          fi

      - name: Create Release
        uses: softprops/action-gh-release@v1
        with:
          body_path: RELEASE_NOTES.md

Breaking Change Tespiti

# Breaking change iceren commit'leri bul
git log --pretty=format:"%H %s" | grep -i "breaking\|BREAKING CHANGE\|!"

# feat! veya fix! formatinda
git log --pretty=format:"%s" | grep -E "^(feat|fix|refactor)!"

Changelog Validation

Changelog formatini dogrulama kurallari:

• Her version header'i tarih icermeli: `## [X.Y.Z] - YYYY-MM-DD`
• Section'lar dogru sirayla: Added, Changed, Deprecated, Removed, Fixed, Security
• Bos section olmamali
• Link referanslari dosya sonunda olmali
• Unreleased section en ustte olmali

Session Changelog Hook

`changelog-on-release.ts` Stop hook'u session sonunda:

• Session'da yapilan commit'leri otomatik toplar
• Conventional commit formatinda parse eder
• Ozet changelog gosterir