【リリースノート】Oasis Sync v0.3.2 – アーキテクチャ刷新とリリースノート生成の強化

はじめに

Oasis Sync v0.3.2をリリースしました。このバージョンでは、プロジェクトの構造を明確にするためのアーキテクチャ刷新と、開発ワークフローを効率化するためのリリースノート生成機能の強化が中心となります。本記事では、これらの変更点の技術的な詳細を解説します。

v0.3.2の主要なハイライトは以下の通りです。

アーキテクチャドキュメントの全面刷新: リポジトリの役割を「Gemini Actions Labs（コンテンツ生成）」と「Oasis Sync（コンテンツ配信）」の2大モジュールとして再定義し、ドキュメントを更新しました。
リリースノート生成機能の強化: コード差分を取得する際に、行数だけでなく文字数でも上限を設定可能にし、バイナリファイルを除外することで、より精度の高いリリースノートを生成します。
ワークフローの整理と有効化: これまで無効化されていたワークフローを整理し、QiitaとZennへの記事同期ワークフローを有効化しました。

リリースノート生成時に参照する git diff の取得ロジックを改善しました。

差分サイズの上限設定: 巨大な差分によって処理が失敗するのを防ぐため、取得するコード差分のサイズを最大行数と最大文字数で制限する機能を追加しました。
バイナリファイルの除外: 差分収集の際に、画像やPDFなどのバイナリファイルを自動的に除外するようになりました。これにより、テキストベースの変更点のみを抽出し、ノイズの少ないリリースノートを生成できます。

開発の効率性と透明性を高めるため、GitHub Actionsワークフローを見直しました。

無効なワークフローの整理: 従来 .github/no_workflows に配置されていたワークフローファイルを、役割に応じて .github/no_workflows/gemini-actions-labs/ へと再編成しました。
Qiita/Zenn同期の有効化: oasis-qiita-sync.yml と oasis-zenn-sync.yml のワークフローを有効化し、Oasisフォーマットの記事を各プラットフォームへ自動で配信するパイプラインを構築しました。
差分切り詰め処理のスクリプト化: リリースノート生成時の差分切り詰め処理を、再利用可能なPythonスクリプト (.github/scripts/clamp_diff.py) として分離し、メンテナンス性を向上させました。

プロジェクトの全体像を理解しやすくするため、ドキュメントを全面的に刷新しました。

アーキテクチャドキュメントの更新: architecture.md を全面的に書き直し、リポジトリの2つの主要モジュール（Gemini Actions Labs, Oasis Sync）の役割と連携について詳細に解説しました。
アーキテクチャ図の追加: 新しいアーキテクチャ図 (architecture.svg) を追加し、ワークフロー間の連携を視覚的に分かりやすくしました。
READMEの更新: README.md を更新し、新しいアーキテクチャの概要と関連ドキュメントへのリンクを記載しました。

本リリースでは、プロジェクトの基盤となるアーキテクチャを整理し、コンテンツ生成から配信までのパイプラインを強化しました。

変更カテゴリ	内容
🏛️ アーキテクチャ	「コンテンツ生成」と「コンテンツ配信」の2大モジュールとして再定義
📝 リリースノート	差分取得のロジックを改善し、生成精度を向上
🚀 ワークフロー	Qiita/Zennへの記事同期を有効化し、配信パイプラインを強化
📚 ドキュメント	アーキテクチャ図を含むドキュメントを全面的に刷新

これらの変更により、Oasis Syncはより堅牢でスケーラブルなコンテンツ管理ハブへと進化しました。