Agent CI

プッシュ前にローカルで完全な CI パイプラインを実行します。CI は開始前は成功していたため、失敗はあなたの変更によって引き起こされています。

実行

npx @redwoodjs/agent-ci run --quiet --all --pause-on-failure

パイプは安全です — pause-on-failure は | tee log、> log.txt などを通じて機能します。stdout が TTY でない場合、ランチャーはこの実行をデタッチし、ステップが一時停止した瞬間にフォアグラウンドプロセスは 77 で終了し、パイプを解放します。コンテナは retry のために一時停止したまま残ります。

再試行

ステップが失敗すると、実行は自動的に一時停止します。問題を修正してから再試行してください:

npx @redwoodjs/agent-ci retry --name <runner-name>

より前のステップからやり直すには:

npx @redwoodjs/agent-ci retry --name <runner-name> --from-step <N>

すべてのジョブが成功するまで繰り返してください。agent-ci でローカル実行できるときは、リモート CI を実行するためにプッシュしないでください。

マシン可読出力 (--json)

プログラマティックな監視のために、--json を追加する (または AGENT_CI_JSON=1 を設定する) と、stdout で NDJSON イベントストリームを発行します — 1 行につき 1 つの JSON オブジェクト。イベント:

• run.start (schemaVersion: 1、runId 付き)
• job.start、job.finish (status: passed|failed)
• step.start、step.finish (status: passed|failed|skipped)
• run.paused (runner + retry_cmd を含む)
• run.finish (status: passed|failed)
• diagnostic

--json は --quiet から独立しており、--json ではストリームと ANSI シーケンスが競合しないようにディフレンダラーは自動的に抑制されます。上記の exit-77 一時停止シグナルと組み合わせることで、エージェントに堅牢なコントラクトを提供します: run.paused イベントを解析し、対応し、retry を呼び出す — プレインテキスト grep は不要です。