一覧に戻る

ブログ

Tactic Remote 1.14 の設計詳細:機能ゲート、非対話 Git 実行、分割プッシュ復旧

1.13 ホスト接続時に読み取り専用へフォールバックする理由、SSH 既存設定を壊さずハングを防ぐ仕組み、Commit & Push を2状態に分けて扱う設計を解説します。

公開日 タグ: リリースニュース / 1.14 / Git / architecture / Portal
Tactic Remote 1.14 の保護設計:git_write_v1 機能ゲート、リポジトリ単位ロックの非対話キュー、プッシュ失敗時の分離リカバリ。

PC のターミナル上で git commit や git push を打つときは、パスフレーズ入力や指紋確認が出てもそのまま応答できます。しかしモバイルアプリや Web からの操作では、バックグラウンドの Git プロセスが標準入力で止まると操作不能になります。

本稿は Tactic Remote 1.14 リリース発表 のエンジニアリング解説です。具体的な使い方は モバイル Git ワークフローガイド をご覧ください。

1. protocolVersion を上げずに git_write_v1 で共存する

iOS アプリとホスト(Mac・Windows・Linux CLI)は更新タイミングがずれやすいため、1.14 では protocolVersion を 2 のまま据え置き、git バイナリを検出した 1.14 ホストだけが git_write_v1 ケーパビリティを通知します。1.13.x ホストへ接続した場合は書き込み UI を表示せず、従来どおり安全な読み取り専用レビューを保ちます。

1.13.1 ホスト接続時に読み取り専用レビューを維持する iOS 1.14 の画面。

2026年11月16日のシミュレータ検証キャプチャ:1.13.1 Mac ホストの demo-repo 接続時は書き込み UI を出さずに差分を表示します。

2. 非対話ガード、SSH 設定の保持、リポジトリ単位の排他制御

ホストの Git サービスはすべての Git 子プロセスに GIT_TERMINAL_PROMPT=0、非対話の GCM_INTERACTIVE 設定、GIT_EDITOR=true、LC_MESSAGES=C を指定します。SSH については、ユーザーが設定した GIT_SSH_COMMAND、GIT_SSH、core.sshCommand(専用鍵や ProxyCommand)を上書きせず、いずれも未設定のときだけ ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new を補います。

書き込み RPC はリポジトリルートごとのミューテックスで直列化され、許可ベースパス境界と機密パス認証で保護されます。外部ターミナル等が .git/index.lock を保持している場合は、Diff 詳細ビュー上にも閉じられるエラーバナーを出します。

.git/index.lock 競合時に Diff 詳細画面の上部へエラーバナーを表示したキャプチャ。
シミュレータ検証キャプチャ:詳細画面でのステージ失敗を即座に通知します。

3. 5,000 件上限の一覧取得と書き込み時の完全検証

node_modules などの大きな未追跡ディレクトリでモバイル通信が詰まらないよう、git_review は 5,000 件を超える時点で大きな未追跡ディレクトリを1行へ集約し、さらに超過する場合は先頭 5,000 件と too_many_changes フラグを返します。一方で書き込み検証時は省略前の完全なインデックス/ステータス(最大 16 MiB)を確認し、正確なパス整合性を維持します。

4. なぜ Commit & Push を 2 状態として扱うのか

commit がローカルに 6f227e5 を作成したあとネットワークや認証で push が失敗した場合、入力欄のメッセージを残したまま「失敗」とだけ表示すると、ユーザーがもう一度タップして重複コミットを作る危険があります。1.14 では作成したハッシュと失敗理由をバナーに明示し、↑1 バッジを更新しつつ入力欄を空にします。

ローカルコミット 6f227e5 完了後にプッシュが失敗した際のリカバリ表示。

シミュレータ検証キャプチャ:生成済みハッシュの提示とドラフト消去により重複コミットを防ぎます。

5. ブランチ・作業ツリー・未追跡削除のガード

upstream 未設定ブランチの Pull 案内、ローカル変更を壊すブランチ切替のブロック、detached HEAD での Push 無効化、さらに未追跡ファイル/フォルダ削除時のディスク完全消去アラートにより、モバイルからの誤操作を防ぎます。

未コミットのローカル変更が上書きされるブランチ切替をブロックした画面。

シミュレータ検証キャプチャ:コンフリクトするローカル変更をコミット/stash するよう案内します。

未追跡ファイル notes/todo.md をディスクから完全削除する確認アラート。

シミュレータ検証キャプチャ:取り消しできないファイル削除であることを明示します。

6. Relay 上での既定 Portal と適用範囲

Tactic Relay 接続ホストではプライベートプレビュー用 Portal が既定でオンになりますが、外部共有リンクは引き続き有効期限と自動審査への同意が必須です。なお、対話的な rebase や複雑な3方向マージ解消は、Review ツールバーではなく会話内のエージェントやネイティブターミナルで行う設計としています。

Tactic Remote を試す

スマートフォンからコーディングエージェントを操作

Mac、Windows、Linux 上の Claude Code や Codex などに接続。iPhone や iPad で進捗を確認し、次の指示を送れます。