# リリース / 互換性ポリシー

このドキュメントは、本番運用に向けた最低限のリリース契約を定義します。

## バージョニング（SemVer）

安定版では Semantic Versioning を採用します:

- **MAJOR**: 非互換変更
- **MINOR**: 後方互換のある機能追加
- **PATCH**: 後方互換のあるバグ修正/セキュリティ修正

`1.0` 以降、破壊的変更はメジャーリリースでのみ行います。マイナー・パッチは後方互換です。

## ランタイム互換性マトリクス

| ランタイム | サポート | 補足 |
| --- | --- | --- |
| Bun `1.3.x` | 対応（主対象） | CI / Release は Bun `1.3.1` で検証 |
| Node.js `20.x` | ツール用途のみ | ドキュメント/ビルド補助など |
| Node.js `22.x` | ツール用途のみ | ドキュメント/ビルド補助など |

マトリクスを変更する場合は、このガイドと `CHANGELOG.md` を同一PRで更新します。

## 後方互換ルール

- `@guren/*` の公開 export は API 面として扱います。
- 公開型/挙動の削除・変更には次が必須です:
  - リリースノートでの移行セクション
  - 可能なら段階的な非推奨化
  - 旧挙動/新挙動境界をカバーするテスト

## リリースノート方針

- すべてのリリースに changelog / release notes を付与します。
- 最低限、以下を含めます:
  - Added / Changed / Fixed
  - Breaking changes（ある場合）
  - Migration 手順
  - ランタイム互換性変更

## アップグレード文書の必須化

各 minor リリースごとに `docs/en/guides/upgrading.md` と `docs/ja/guides/upgrading.md` へ追記します。