Sourcesage



変更点

- **Changelog生成処理の改善** (31, 27)
- changelog開始タグと終了タグをパラメータとして受け取るように変更しました。
- 指定されたタグが存在しない場合はエラーメッセージを表示するように修正しました。
- タグが2つ未満の場合は警告メッセージを表示するように修正しました。
- changelog生成範囲を指定できるように変更しました。
- "Merge"で始まるコミットメッセージをスキップするように修正しました。
- 処理の可読性を向上しました。

- **処理の改善** (30)
- YAMLファイルの読み込みで、キーと値を適切に処理するように修正しました。

- **YAML設定ファイルの追加**
- リリースノート生成に必要な情報をYAMLファイルから読み込めるようにしました。
- `docs/.sourcesage_releasenotes.yml` を参照してください。

- **パッケージバージョンの更新**
- パッケージバージョンを 5.0.2 から 5.1.0 に更新しました。

修正されたissue

- 31: ChangelogGeneratorの改善
- 27: Changelog開始タグと終了タグの指定
- 30: YAMLファイルの読み込みエラー

その他

- ログ出力の改善

使用方法

SourceSage CLI を使用してリリースノートを生成するには、以下のコマンドを実行してください。

bash
sourcesage -f docs/.sourcesage_releasenotes.yml


`docs/.sourcesage_releasenotes.yml` ファイルには、リリースノート生成に必要な情報が記述されています。

謝辞

SourceSageの開発にご協力いただきありがとうございます！


更新内容

- ドキュメント生成機能の改善

- SourceSage が生成するファイルやフォルダが `.SourceSageignore` で正しく除外されるように修正しました。（28）

- リリースプロセス改善

- チェンジログ統合機能の堅牢性向上（28）
- Unicodeデコードエラーを処理する例外処理を追加
- チェンジログファイルの読み込みをより堅牢にするためのロギングを改善

- DocuMindクラスにファイル存在チェックと警告ログ機能を追加（25）
- リリースレポートおよび変更履歴ファイルが存在しない場合に警告をログに記録
- `tprint`関数の重複呼び出しを削除し、初期化時の表示を改善
- ファイルが見つからない場合の処理を追加し、エラーハンドリングを強化してユーザーへの通知を明確化

- DocuMindデータベースファイルのデフォルトパスを修正（25）
- DocuMindデータベースファイルのデフォルトパスを`.SourceSageAssets/DocuMind.md`から`.SourceSageAssets/DOCUMIND/Repository_summary.md`に変更

その他

- SourceSage v5.0.3 をご利用いただきありがとうございます！


このリリースでは、パフォーマンスの改善と安定性の向上に重点を置いています。

**主な変更点:**

- **.SourceSageignore の更新:** `.Gaiah.md` と `.env` ファイルを無視リストに追加しました。これにより、これらのファイルは SourceSage の処理対象から除外されます。

**バグ修正:**

- **DocuMind と CommitCraft のメッセージ:** `DocuMind` と `CommitCraft` の初期化時に処理の開始を明確に示すメッセージを追加しました。

**その他:**

- **依存関係の更新:** `google-generativeai` と `litellm` を依存関係に追加しました。これらのライブラリは、コード生成機能をサポートします。
- **README の更新:** 新しい機能である `Sage` モードの使用手順を追加しました。


**今後の計画:**

- AI によるコード生成機能の強化
- 新機能の追加

このリリースにより、SourceSage はより安定し、使いやすいものになっています。ご意見やご要望がございましたら、お気軽にご連絡ください。


新機能

- **AIRA と Harmon.AI の設定を追加:** プロジェクトの自動化とコード生成を強化するために、AIRA と Harmon.AI の設定ファイルを追加しました。これにより、リポジトリ情報、コミットメッセージ、ブランチ名、LLM モデル、README 生成の設定、そして Harmon.AI の環境変数、製品情報、開発設定などを指定できるようになりました。

リファクタリング

- **`source_sage` モジュールのリファクタリング:** 出力ファイルのディレクトリが存在しない場合に作成する処理を追加し、ログ出力を改善しました。
- **`ReleaseDiffReportGenerator` クラスのリファクタリング:** subprocess を使用して Git コマンドを実行するように変更しました。これにより、GitPython の依存関係が不要になり、より軽量な実装になりました。また、ログ出力を改善し、エラー処理を追加しました(22)。
- **`GitCommander` モジュールの追加:** Git コマンドを実行するための GitCommander モジュールを追加しました。このモジュールは、subprocess を使用して Git コマンドを実行し、ログ出力とエラー処理を提供します。
- **`DocuMind` クラスの追加:** リリースノートを生成する DocuMind クラスを追加しました。このクラスは、指定された LLM モデルを使用して、DocuMind ファイル、リリースレポート、変更履歴に基づいたリリースノートを生成します(24)。
- **`DiffChangelogGenerator` クラスのリファクタリング:** GitPython の代わりに subprocess を使用して Git コマンドを実行するように変更しました。これにより、GitPython の依存関係が不要になり、より軽量な実装になりました。また、ログ出力を改善し、より詳細な情報を表示するように変更しました。さらに、日本語の出力に対応しました。
- **`CommitCraft` クラスの追加:** ステージ情報からコミットメッセージを生成する CommitCraft クラスを追加しました。このクラスは、指定された LLM モデルを使用して、ステージ情報に基づいたコミットメッセージを生成します(23)。

その他

- `config/STAGE_INFO/STAGE_INFO_TEMPLATE_GAIAH_B.md` のフォーマットを更新し、`commit messages title` の項目を追加しました。これにより、より詳細なコミットメッセージを生成できるようになります。
- `config/constants.py` の定数を整理し、DocuMind に関する定数と SourceSage markdown ファイルのパスに関する定数を追加しました。
- `config/language_map.json` に `.h` を追加し、C++ ファイルとして認識するように修正しました。これにより、C++ プロジェクトの解析精度が向上します。
- `core.py` の `run` メソッドをリファクタリングし、各機能の実行処理を分離しました。また、不要なログ出力を削除しました。


詳細

AIRA と Harmon.AI の設定

このリリースでは、AIRA と Harmon.AI の設定ファイルを追加しました。これらのファイルは、`aira/config.dev.yml` にあります。これらの設定を使用することで、SourceSage をより効率的に使用できます。

`source_sage` モジュールのリファクタリング

`source_sage` モジュールは、プロジェクトのソースコードとファイル構成を単一のマークダウンファイルに統合する機能を提供します。このリリースでは、出力ファイルのディレクトリが存在しない場合に作成する処理を追加し、ログ出力を改善しました。

`ReleaseDiffReportGenerator` クラスのリファクタリング

`ReleaseDiffReportGenerator` クラスは、リリース間の差分をマークダウン形式のレポートとして生成します。このリリースでは、subprocess を使用して Git コマンドを実行するように変更しました。これにより、GitPython の依存関係が不要になり、より軽量な実装になりました。また、ログ出力を改善し、エラー処理を追加しました。

`GitCommander` モジュールの追加

`GitCommander` モジュールは、Git コマンドを実行するためのユーティリティを提供します。このモジュールは、subprocess を使用して Git コマンドを実行し、ログ出力とエラー処理を提供します。

`DocuMind` クラスの追加

`DocuMind` クラスは、リリースノートを生成します。このクラスは、指定された LLM モデルを使用して、DocuMind ファイル、リリースレポート、変更履歴に基づいたリリースノートを生成します。

`DiffChangelogGenerator` クラスのリファクタリング

`DiffChangelogGenerator` クラスは、変更履歴を生成します。このリリースでは、GitPython の代わりに subprocess を使用して Git コマンドを実行するように変更しました。これにより、GitPython の依存関係が不要になり、より軽量な実装になりました。また、ログ出力を改善し、より詳細な情報を表示するように変更しました。さらに、日本語の出力に対応しました。

`CommitCraft` クラスの追加

`CommitCraft` クラスは、ステージ情報からコミットメッセージを生成します。このクラスは、指定された LLM モデルを使用して、ステージ情報に基づいたコミットメッセージを生成します。

その他の変更

`config/STAGE_INFO/STAGE_INFO_TEMPLATE_GAIAH_B.md` のフォーマットが更新され、`commit messages title` の項目が追加されました。これにより、より詳細なコミットメッセージを生成できるようになります。

`config/constants.py` の定数が整理され、DocuMind に関する定数と SourceSage markdown ファイルのパスに関する定数が追加されました。

`config/language_map.json` に `.h` が追加され、C++ ファイルとして認識するように修正されました。これにより、C++ プロジェクトの解析精度が向上します。

`core.py` の `run` メソッドがリファクタリングされ、各機能の実行処理が分離されました。また、不要なログ出力が削除されました。



🎉 新機能

🤖 Gaiahに対応したコミットメッセージ生成

- ソースコードの変更差分からGaiahフォーマットのコミットメッセージ生成をサポート
- 効果的で意味のあるコミットメッセージを作成するためのベストプラクティスに従ったガイドラインを提供
- 主要な変更とその目的に焦点を当て、コミットで行われた変更を明確かつ簡潔に説明

🛠️ 改善

🌐 READMEの更新

- 更新内容セクションに最新のリリース情報を追加
- クイックスタートセクションを改善し、より詳細な手順を記載

🐛 バグ修正

- なし

📦 その他の変更

🔧 設定ファイルの更新

- `config/constants.py`に定数`STAGE_INFO_SIMPLE_OUTPUT_MD_GAIAH_B`と`STAGE_INFO_SIMPLE_TEMPLATE_MD_GAIAH_B`を追加

📝 ドキュメントの更新

- README.mdの更新内容セクションとクイックスタートセクションを更新
- Gaiahに対応したコミットメッセージ生成のサンプルを追加

🚀 今後の予定

- より多様なフォーマットのコミットメッセージ生成への対応
- ユーザビリティの向上とパフォーマンスの最適化
- AIとの連携強化によるさらなる自動化の推進

SourceSage v4.4.0では、Gaiahフォーマットのコミットメッセージ生成をサポートし、より効果的で意味のあるコミットメッセージの作成を可能にしました。今後も、SourceSageは開発者の生産性向上のため、AIとの連携を深めながら継続的に進化していきます。

まとめ

SourceSage v4.3.0では、Git Diff レポート機能の追加により、リリース間の変更点を簡単に把握できるようになりました。また、プロジェクト構成の整理とコードの改善により、開発効率とメンテナンス性が向上しました。

今後も SourceSage の機能拡充と改善を続けていきますので、ご期待ください。ご意見やご要望がありましたら、Issue や Pull Request でお知らせください。