💻 開発ガイド (Development Guide)

本ドキュメントでは、本プロジェクトの開発環境構築、コードの変更、新しいツールの追加、およびテストの手順について解説します。

🛠️ 開発環境のセットアップ

プログラミング言語・ランタイム

• Rust: rustup を通じて最新の安定版をインストールしてください。
• Bun: フロントエンドの管理と外部テストの実行に使用します。

依存関係のインストール

bun install

Sidecar とモデルの準備

開発実行には llama-server と学習済みモデルが必要です。scripts/ 内のスクリプトを使用してください。

📁 主要なディレクトリ構成と責務

• bin/: サイドカーバイナリ (llama-server) の格納場所。
• data/: データベースファイル (vector.db) の永続化レイヤー。
• logs/: 開発・診断用のログ出力。
• resources/: バンドルされる静的リソース（アイコン等）。
• src/backend/src/mcp.rs: MCP の全ツールロジック。
• src/backend/src/db.rs: スキーマ管理。
• test/: 統合テスト一式。

➕ 新しい MCP ツールの追加手順

新しい機能を MCP ツールとして公開する場合、以下の手順を踏みます。

1. ツール名の定義

src/backend/src/mcp.rs 内で、JSON-RPC でやり取りするメソッド名（例: tools/list）を確認し、新しいツール用の定義を追加します。

2. ハンドラーの実装

handle_search_vector などの既存の関数を参考に、新しい非同期関数を実装します。

3. リクエストのディスパッチ

message_handler 関数の match 文にツール名を追加し、実装したハンドラーを呼び出すように設定します。

4. 単体テストの追加

src/backend/src/mcp.rs の末尾にある mod tests に、新しいツールの入出力を検証するテストを追加してください。

🧪 テストの実行方法

Rust 単体テスト (推奨)

コアロジック（DB・MCP・LLM連係）のテストです。

cd src/backend
cargo test

Bun E2E テスト

実際の HTTP/SSE 通信を介したテスト（開発環境が整っている場合）。

bun test

🚀 リリース手順

1. バージョンアップ

package.json および src/backend/Cargo.toml のバージョンを更新します。

2. ビルドの実行

bun tauri build

src/backend/target/release/bundle/ 内に MSI インストーラーや EXE ファイルが生成されます。

📝 コーディング規約

• Rust: cargo fmt および cargo clippy を遵守してください。
• Commit: 分かりやすいメッセージを心がけ、必要に応じてジャーナルファイルを更新してください。
• Documentation: ユーザーに影響する変更を加えた場合は、README.md や document/ 内の該当ドキュメントを必ず更新してください。