Update、診断、shell completion を統合する

Check と install を分ける

grok update --check または --check --json は変更せず availability を確認します。--stable（既定 channel。help では weekly releases と説明）や --alpha への切り替え、specific --version の install は意図的な policy choice です。

Install 前に grok version --json を記録します。xAI は docs.x.ai に Grok Build の版ごとの changelog を公開していないため、update 後は TUI 内の /release-notes を読み、smoke test を再実行します。既知 repair 以外で --force-reinstall を使いません。

Automation では version を pin し、version 出力を記録。
CI や container では GROK_DISABLE_AUTOUPDATER または [cli] の auto_update = false で background update check を止める。
Channel や version を変えるたびに smoke test を再実行。

grok version --json
grok update --check --json

Fix 前に diagnose

grok doctor は Grok を起動せずに terminal、clipboard、color、input の対応を確認し、--json で machine-readable にします。grok inspect は discovered config/extensions を調べる別の evidence surface です。

ID なしの grok doctor fix で利用可能な automatic fixes を一覧し、review 後に named fix を一つ適用します。--yes は表示された変更を確認なしで適用するため、事前監査済みの手順だけに使います。

Debug file を共有前に review。
最初の failing layer を直す。
Repair 後に doctor 再実行。

grok doctor --json
grok doctor fix
grok doctor fix FIX_ID

Completion code を意図的に生成

grok completions SHELL（bash、elvish、fish、powershell、zsh）を temp file へ書き、inspect 後に shell conventions で install します。

TUI /doctor は captured ledger で source-preview、grok doctor shell command は runtime-confirmed、/terminal-setup は文書化された TUI 内 terminal check です。

grok completions zsh > /tmp/_grok
sed -n "1,40p" /tmp/_grok