CHANGELOG で定義すべきこと
Keep a Changelog 形式の構成要素と Python による自動生成

# CHANGELOG

このプロジェクトのすべての変更を記録します。
形式は [Keep a Changelog](https://keepachangelog.com/ja/1.0.0/) に従い、
バージョン体系は [Semantic Versioning](https://semver.org/lang/ja/) に従います。

## [Unreleased]

### Added
- 注文キャンセル API（POST /orders/{id}/cancel）を追加

---

## [2.3.0] — 2026-06-10

### Added
- CSV エクスポート機能（GET /orders/export）を追加
- 注文検索に日付範囲フィルターを追加（`from` / `to` クエリパラメータ）

### Changed
- 注文一覧 API のデフォルトソート順を「作成日降順」に変更

### Fixed
- 同一 IP からの連続リクエスト時にレート制限が誤作動する問題を修正 (#241)

---

## [2.2.1] — 2026-05-28

### Security
- `orders` テーブルへの SQL インジェクション脆弱性を修正（CVE-2026-XXXX）

### Fixed
- 注文金額が 1,000,000 円を超える場合に 500 エラーが発生する問題を修正 (#229)

---

## [2.2.0] — 2026-05-15

### Added
- 請求書 PDF ダウンロード機能を追加

### Deprecated
- `/v1/orders` エンドポイント（2027-05 に削除予定。`/v2/orders` を使用してください）

### Removed
- `/legacy/orders` エンドポイントを削除（2.0.0 で Deprecated 済み）

---

[Unreleased]: https://github.com/example/my-app/compare/v2.3.0...HEAD
[2.3.0]: https://github.com/example/my-app/compare/v2.2.1...v2.3.0
[2.2.1]: https://github.com/example/my-app/compare/v2.2.0...v2.2.1
[2.2.0]: https://github.com/example/my-app/releases/tag/v2.2.0

# 形式: (): 
# type: feat / fix / docs / style / refactor / test / chore / perf / security

feat(orders): CSV エクスポート機能を追加
fix(orders): レート制限が誤作動する問題を修正 (#241)
security(db): SQL インジェクション脆弱性を修正 (#242)
feat(invoice)!: 請求書 PDF ダウンロードを追加   # ! = BREAKING CHANGE

"""
Conventional Commits 形式の git log を解析して
CHANGELOG.md の [Unreleased] セクションのドラフトを生成する。

使い方:
  python gen_changelog.py                  # 最新タグから HEAD まで
  python gen_changelog.py v2.2.0 v2.3.0   # タグ間を指定
"""
import re
import subprocess
import sys
from collections import defaultdict
from datetime import date

TYPE_TO_SECTION = {
    "feat":     "Added",
    "fix":      "Fixed",
    "security": "Security",
    "perf":     "Changed",
    "refactor": "Changed",
    "docs":     "Changed",
    "style":    "Changed",
    "chore":    "",          # CHANGELOG に含めない
    "test":     "",
}

COMMIT_PATTERN = re.compile(
    r"^(?P\w+)(?:\((?P[^)]+)\))?(?P!)?: (?P.+)$"
)

def get_commits(from_ref: str = "", to_ref: str = "HEAD") -> list[str]:
    """git log から コミットメッセージ一覧を返す。"""
    range_arg = f"{from_ref}..{to_ref}" if from_ref else to_ref
    out = subprocess.check_output(
        ["git", "log", "--pretty=format:%s", range_arg],
        text=True
    )
    return [line.strip() for line in out.splitlines() if line.strip()]

def get_latest_tag() -> str:
    """最新タグを返す（なければ空文字）。"""
    try:
        return subprocess.check_output(
            ["git", "describe", "--tags", "--abbrev=0"],
            text=True, stderr=subprocess.DEVNULL
        ).strip()
    except subprocess.CalledProcessError:
        return ""

def parse_commits(messages: list[str]) -> dict[str, list[str]]:
    sections = defaultdict(list)
    for msg in messages:
        m = COMMIT_PATTERN.match(msg)
        if not m:
            continue
        type_ = m.group("type").lower()
        scope = m.group("scope") or ""
        subject = m.group("subject")
        breaking = bool(m.group("breaking"))
        section = TYPE_TO_SECTION.get(type_, "")
        if not section:
            continue
        prefix = f"**[BREAKING]** " if breaking else ""
        scope_str = f"({scope}) " if scope else ""
        sections[section].append(f"- {prefix}{scope_str}{subject}")
    return sections

def render_changelog(sections: dict[str, list[str]]) -> str:
    lines = [f"## [Unreleased] — {date.today().isoformat()}", ""]
    order = ["Added", "Changed", "Deprecated", "Removed", "Fixed", "Security"]
    for section in order:
        if section in sections:
            lines.append(f"### {section}")
            lines.extend(sections[section])
            lines.append("")
    return "\n".join(lines)

if __name__ == "__main__":
    if len(sys.argv) == 3:
        from_ref, to_ref = sys.argv[1], sys.argv[2]
    elif len(sys.argv) == 2:
        from_ref, to_ref = sys.argv[1], "HEAD"
    else:
        from_ref = get_latest_tag()
        to_ref = "HEAD"

    print(f"# 範囲: {from_ref or '(全件)'}..{to_ref}\n")
    messages = get_commits(from_ref, to_ref)
    sections = parse_commits(messages)
    print(render_changelog(sections))

"""
CHANGELOG.md を解析してバージョン・日付・変更数を一覧表示する。
"""
import re
from pathlib import Path

CHANGELOG = Path("CHANGELOG.md")
VERSION_HEADER = re.compile(r"^##\s+\[([^\]]+)\](?:\s+[—–-]\s+(\d{4}-\d{2}-\d{2}))?", re.MULTILINE)
ENTRY = re.compile(r"^-\s+", re.MULTILINE)

def parse_changelog(text: str) -> list[dict]:
    versions = []
    matches = list(VERSION_HEADER.finditer(text))
    for i, m in enumerate(matches):
        version = m.group(1)
        release_date = m.group(2) or "未リリース"
        start = m.end()
        end = matches[i + 1].start() if i + 1 < len(matches) else len(text)
        section_text = text[start:end]
        count = len(ENTRY.findall(section_text))
        versions.append({"version": version, "date": release_date, "entries": count})
    return versions

if __name__ == "__main__":
    if not CHANGELOG.exists():
        print("CHANGELOG.md が見つかりません")
    else:
        text = CHANGELOG.read_text(encoding="utf-8")
        versions = parse_changelog(text)
        print(f"{'バージョン':<15} {'日付':<12} {'変更数':>5}")
        print("-" * 36)
        for v in versions:
            print(f"{v['version']:<15} {v['date']:<12} {v['entries']:>5} 件")