終了コード¶

現在の実装挙動に基づく clinvk の終了コードリファレンスです。

概要¶

clinvk はスクリプトや自動化のためにプロセス終了コードを返します。

コード	名称	説明
0	成功	コマンドが正常に完了
1	一般エラー	バリデーション / 設定 / 実行時エラー、または集約サブコマンド失敗
6	タイムアウト	`unified_flags.command_timeout_secs` 超過でタイムアウトがトップレベルに伝播
2+	バックエンド終了コード	`prompt` / `resume` 経路でバックエンド CLI の終了コードを伝播

コード	意味
0	すべてのユニットが成功
1	1 つ以上のユニットが失敗（ユニット内タイムアウト含む）

コード	意味
0	成功
1	失敗

unified_flags.command_timeout_secs を正の値に設定すると:

バックエンドプロセスのタイムアウトが検出されます。
トップレベルまで伝播したタイムアウトは終了コード 6 に正規化されます。
集約コマンド（compare / chain / parallel）では、各ユニットのタイムアウトはユニット失敗として扱われ、最終的に終了コード 1 になります。

例:

# config.yaml
unified_flags:
  command_timeout_secs: 5

clinvk "long running task"
echo $?  # トップレベル prompt/resume 経路のタイムアウトなら 6

clinvk "task"
code=$?

case $code in
  0)
    echo "success"
    ;;
  6)
    echo "timeout"
    ;;
  *)
    echo "failed: $code"
    ;;
esac

set -e

clinvk "step 1"
clinvk "step 2"