GitBucket
2026-02-27: 設定永続化・Issue同期・保存バグ修正
1. 作業実施の理由と指示
- 背景: デバッグ起動時に「OSにログインしたときに自動で起動する」チェックが永続化しない報告、サーバーコンソールに操作時の受信メッセージを出したい要望があった。また、GitBucket の Issue を API で改訂（Issue 9 を Issue 4 の後に対応する旨を追記）したいが PATCH が 404 になる事象、および設定保存ボタンがファイル保存の成否を無視して成功表示するバグの指摘があった。
- 意図: 設定の読み書きを Tauri invoke 優先にし永続化を確実にする。サーバー側で GET/POST /settings と MCP 受信時にログを出す。GitBucket の Issue 編集 API を調査し、未実装ならコメント投稿で代替する。設定保存ハンドラで
saveSettingsToFileの戻り値を確認し、失敗時は成功表示・localStorage 更新を行わないようにする。
2. 指摘事項とその対応
- 指摘: チェックが永続化しない。
- 対応: フロントの
loadSettingsFromFile/saveSettingsToFileで、Tauri 内では先にinvoke('get_app_settings')/invoke('set_app_settings', { settings })を呼ぶように変更。MCP サーバー起動前でもアプリデータの settings.json を直接読み書きできるため永続化が確実になった。
- 対応: フロントの
- 指摘: サーバーコンソールに操作時の受信メッセージを出したい。
- 対応:
handlers.rsで GET /settings に[server] GET /settings 受信、POST /settings に payload 付きでログを追加。mcp/mod.rsで MCP 受信時に[server] MCP 受信: <body>を出力。
- 対応:
- 指摘: GitBucket の Issue を API で改訂したいが PATCH で 404。
- 対応: 外部調査の結果、公式 GitBucket の
ApiIssueControllerBase.scalaには「Edit an issue」の PATCH ルートが存在せず、全バージョンで未実装と判断。sync_issues.mjsで PATCH が 404 のときに Create an issue comment API で本文をコメントとして投稿するフォールバックを実装。Issue 9 に「Issue 4 の後に対応」をコメントで反映できるようにした。
- 対応: 外部調査の結果、公式 GitBucket の
- 指摘: 「多くのバージョンが未対応」は不正確では。
- 対応: 公式ソースで PATCH が未実装であることを確認し、
sync_issues.mjsと.agent/rules/issue_management.mdの記述を「公式 GitBucket では全バージョンで未実装」に修正。
- 対応: 公式ソースで PATCH が未実装であることを確認し、
- 指摘: 設定保存ボタンが
saveSettingsToFileの戻り値を無視し、失敗時も成功表示・localStorage 更新をしている。- 対応: 保存ハンドラで
const saved = await saveSettingsToFile(payload)の戻り値を確認。saved === trueのときのみ localStorage 更新・フォーム反映・「保存しました」表示。saved === falseのときは「保存に失敗しました（ファイルへの書き込みに失敗しました）」を表示し、localStorage とフォームは変更しないようにした。
- 対応: 保存ハンドラで
3. 作業詳細
- main-panel.js:
loadSettingsFromFileで Tauri 時はinvoke('get_app_settings')を優先、失敗時のみ fetch。saveSettingsToFileで Tauri 時はinvoke('set_app_settings', { settings: payload })を優先。保存ボタン内でsavedを判定し、成功時のみ localStorage・フォーム・成功メッセージを更新。 - handlers.rs:
settings_get_handler冒頭に[server] GET /settings 受信、settings_post_handler冒頭に payload のログを追加。 - mcp/mod.rs: MCP 受信ログを
[server] MCP 受信: ...に統一。 - sync_issues.mjs:
postIssueComment(issueNumber, commentBody)を追加。updateRemoteIssueで PATCH が 404 の場合に本文をコメントとして投稿。コメント投稿時は_commentFallbackを返し、ローカル上書きは行わない。コメント・ドキュメントを「公式 GitBucket では全バージョンで未実装」に修正。 - issue_management.md: Issue 編集と 404 の説明を「全バージョンで未実装」に変更（日英両方）。
4. AI視点での結果
設定は Tauri 起動直後から invoke で読み書きされるため、デバッグ時もチェックが永続化する。サーバーコンソールで設定・MCP の受信内容を確認しやすくなった。GitBucket では Issue 本体の編集 API が使えないため、同期時に本文をコメントとして投稿する運用で情報を残せる。設定保存でファイル書き込みに失敗した場合は、誤って「保存しました」と表示されず、ユーザーに失敗が伝わるようになった。