アプリサーバーイベント同期
このスキルを使用して、インストールされているCodex CLIの進化に合わせてCodexMonitorのアプリサーバー統合を正確に保ちます。
正規ソース
以下から始めてください:
docs/app-server-events.md
そのファイルを正規のランブックとして扱い、動作が変わったときに更新します。
ワークフロー
-
上流ベースラインを確認:
codex --versionを記録し、新しい一時ディレクトリに実験的スキーマを生成します。選択した実行可能ファイルを互換性ターゲットとします。../Codexが存在する場合、フェッチやプルーニングを行わずにチェックアウトされたハッシュを記録します。サイドチェックアウトはオプションです。
-
通知メソッドを比較:
- Codex v2 通知メソッドのセットを、
src/utils/appServerEvents.tsおよびsrc/features/app/hooks/useAppServerEvents.tsのCodexMonitorルーティングと差分比較します。 docs/app-server-events.mdのサポートされているイベントと欠落しているイベントのセクションを更新します。
- Codex v2 通知メソッドのセットを、
-
リクエストメソッドを比較:
- Codex v2 クライアント/サーバーリクエストセットを、CodexMonitorの送信および受信ハンドリングと差分比較します。
サポートされているリクエスト、欠落しているクライアントリクエスト、サーバーリクエストのセクションを更新します。
-
リストが変わらない場合のスキーマドリフトを調査:
- 生成されたJSONスキーマを検査します。上流ソースを使用する場合は、
codex-rs/app-server-protocol/src/protocol/v2/を検査します。 src/utils/appServerEvents.ts、src/features/app/hooks/useAppServerEvents.ts、およびsrc/features/threads/utils/threadNormalize.tsのパーサーと正規化のエッジを比較します。
- 生成されたJSONスキーマを検査します。上流ソースを使用する場合は、
-
要求されたときのサポートを実装:
- 最初にパースエッジでメソッド/タイプのサポートを追加します。
- アプリイベントフックでルーティングします。
- 必要に応じてのみ、スレッド/アイテムリデューサーとレンダリングを更新します。
- アプリ/デーモンのパリティを維持し、重複ロジックを避けます。
-
検証:
python3 scripts/check-codex-protocol.py --schema-dir <生成ディレクトリ>を実行します(Python jsonschema が必要)。- 触れたファイルに対してターゲットテストを実行します。
npm run typecheckを実行します。- フロントエンドの動作変更に対して
npm run testを実行します。 - バックエンドの変更に対して
cd src-tauri && cargo checkを実行します。
主要ファイル
- ルーティング/タイプ:
src/utils/appServerEvents.ts - イベントルーター:
src/features/app/hooks/useAppServerEvents.ts - ハンドラー構成:
src/features/threads/hooks/useThreadEventHandlers.ts - アイテム/ターンハンドラー:
src/features/threads/hooks/useThreadItemEvents.ts、src/features/threads/hooks/useThreadTurnEvents.ts - 正規化:
src/features/threads/utils/threadNormalize.ts - 状態:
src/features/threads/hooks/useThreadsReducer.ts - 送信リクエスト:
src/services/tauri.ts、src-tauri/src/shared/codex_core.rs - デーモンRPC:
src-tauri/src/bin/codex_monitor_daemon/rpc.rsおよびrpc/*
参考文献
- クイックコマンドセット:
references/quick-commands.md - 正規ランブック:
docs/app-server-events.md
出力期待値
監査や更新が要求された場合:
- 具体的なサポート済みおよび欠落メソッドの差分を報告します。
- 編集が必要な正確なファイルを引用します。
- 動作が変わったときは、同じ変更で
docs/app-server-events.mdを更新します。 - 意図的な非サポート(例:非推奨のメソッド)を明示的に指摘します。