開発者ガイド (Development Guide)

1. 開発の基本コンセプト

TelosDB の開発においては、「確信の持てるコード」と「自動化された環境」を重視します。Windows 環境特有の DLL 競合やビルドエラーを避けるため、環境構築手順を簡略化しています。

2. 環境構築の手順

2.1 必要なツール

• Rust: 最新の Stable ツールチェーン。
• Node.js: フロントエンド資材の管理用。
• VS Code: 推奨エディタ（Tauri / Rust 拡張機能）。

2.2 初回セットアップ

1. リポジトリをクローン。
2. npm install を実行（sqlite-vec などのバイナリ等が含まれます）。
3. src-tauri/resources/ に指定の推論モデル（Gemma-3 GGUF）を配置。

3. ビルドと実行

# 開発モード（ホットリロード有効）
npm run tauri dev

[!NOTE] 開発時に DLL のエラーが出る場合は、一度 cargo clean を行い、build.rs による DLL 再生成を促してください。

4. 拡張手順 (MCP ツールの追加)

新しい機能を MCP 経由で公開する場合は、以下のファイルを修正します。

1. mcp.rs: JSON-RPC ハンドラーに新しいメソッドを追加。
2. document/mcp.json: ツールのスキーマ（引数定義）を記述。エージェントがこの定義を読み取ります。
3. 04_mcp_api_specification.md: 仕様書を更新。

5. コーディング規約とテスト

• 非同期処理: SQLite 操作や通信はすべて tokio ランタイム上で行い、UI をブロックしないようにします。
• ログ: log::info! / log::error! を使用してください。ログは src-tauri/logs/ に自動出力されます。
• テスト: ロジックの変更後は必ず scripts/test_mcp_client.mjs を実行し、既存ツールが壊れていないか確認してください。