メインコンテンツまでスキップ

コーディング実行のリネージを読む

リネージは3つの問いに答えます。何が実行されたか、何が失敗したか、どのファイルが変わったかです。以下の JSON コマンドには jq を使います。実行ディレクトリにはサマリー、イベントログ、トランスクリプト、そしてイベントストリームを畳み込める場合はリネージファイルが2つ含まれます。リネージファイルは実行を整理します。イベントログとトランスクリプトは、各ステップの背後にある詳細を提供します。

実行を見つける​

raider run コマンドが出力したディレクトリ、またはその --out オプションで指定したディレクトリから始めます。完了した呼び出しごとに、独自の work-<id> ディレクトリができます。下のプレースホルダを、実行が出力した実際のパスに置き換えてください。新しい実行ではディレクトリ名が異なります。

RUN_DIR='<path-to-the-printed-work-directory>'
cat "$RUN_DIR/summary.md"
cat "$RUN_DIR/run.json"
ファイル用途
summary.md人が読める実行ステータスと終了コードを得ます。
run.json構造化された結果、チェック、会計を調べます。
events.jsonl順序付きイベントと、プロセスおよびツールの詳細な結果をたどります。
transcript.json実行の会話とツールトレースを読みます。
lineage.scala記録されたグラフの Scala 射影を見ます。
lineage-data.jsondataRef キーを使ってノードの詳細を調べます。

Raider を実行せずに読める例は、保存済みの CI 結果 を開いてください。

何が実行されたか​

lineage-data.json を開きます。nodes の各項目には連番(seq)、種別、通常は dataRef があります。parentId は包含関係を示します。たとえば、モデル呼び出しの下にあるツール呼び出しです。inputs は、そのステップへ結果を渡した先行ノードを識別します。data オブジェクトは、各 dataRef を記録されたモデルまたはツールの詳細へ対応付けます。

たとえば、固定のノード ID を仮定せずに、新しい実行を調べます。

jq '.nodes[] | {seq, id, kind, parentId, inputs, dataRef}' \
"$RUN_DIR/lineage-data.json"
jq '.data | to_entries[] | {ref: .key, detail: .value}' \
"$RUN_DIR/lineage-data.json"

複数ステージの CI キャプチャでは、successful-run.json にアプリケーションのインデックスと、6つの別々のネイティブ実行が含まれます。ステージ一覧とネイティブのサマリーは、次で調べます。

jq '.pipelineIndex.stages' docs/examples/ci-pipeline/successful-run.json
jq '.nativeRuns[] | {stage, runId, nativeStatus, nativeExitCode, nodes}' \
docs/examples/ci-pipeline/successful-run.json

この6つのルートはアプリケーションのインデックスで結ばれており、1つのネイティブグラフではありません。キャプチャの nativeWorkDir の値は、元の成果物の場所を識別します。一方、チェックインされた JSON にはサニタイズされた抜粋が含まれます。パイプラインガイド が、ステージとその結果を説明します。

何が失敗したか​

該当する dataRef をたどって操作を見つけ、events.jsonl または transcript.json でそのプロセス結果を調べます。結果が Succeeded のツール呼び出しは、ツールが結果を返したことを意味します。ツールが起動したコマンドが成功したという意味ではありません。課金の例では、厳しい割引の境界がまだ残っているため、編集前のテストプロセスは終了コード 1 になります。その後の編集と、通過するチェックは別のステップです。全体のステータスは1つのノードから推測せず、summary.md と run.json を読んでください。

どのファイルが変わったか​

実行に使ったワークスペースを調べます。CI の例 では、コピーされたソースを元のフィクスチャと比較します。出力パスは、起動時に選んだものに置き換えてください。

PIPELINE_DIR='artifacts/user-ci/run-<your-timestamp>'
diff -u examples/user-guide/fixture/src/main/scala/billing/Discount.scala \
"$PIPELINE_DIR/workspace/src/main/scala/billing/Discount.scala"

成功した修復は > を >= に変えます。diff は変更を見つけると終了コード 1 になります。ここではそれが想定です。Git プロジェクト内のタスクでは、そのプロジェクトの作業コピーで git diff を実行します。エージェントが変えた内容を受け入れる前に、実際の diff とテスト出力を確認してください。

Scala の射影​

現在のレンダラは、LineageStep と Task の合成を使って、型付きの Scala 3 Program を生成します。現在の統合成果物からの短い抜粋です。

val phase_baseline_check: Program[Unit, Vector[StepReport]] =
Program.fromFunction("phase_baseline_check") { _ =>
LineageStep.phase("camp-billing:n1", "baseline-check", None, Vector.empty, nesting = 1)
.flatMap { n_camp_billing_n1 =>
delegation_ci_baseline(())
.map { n_camp_billing_n2 =>
n_camp_billing_n1 ++ n_camp_billing_n2
}
}
}

フェーズと子ステップは構造レポートを返します。ノードの種別と ID、dataRef、入力、ネストです。ペイロードは lineage-data.json に残ります。射影はドライランの記述です。そのプログラムを実行すると、記録された呼び出しグラフの構造が報告されます。モデル呼び出し、ツール呼び出し、I/O は行いません。リプレイでも、ライブの再実行でもありません。

完全な統合リネージの Scala 成果物 と、その この例の生成方法 を読んでください。別の6ルート CI キャプチャについては、過去にキャプチャしたネイティブ射影 を参照してください。保存されているコメントだけの射影は、現在のレンダラより前のものです。

リプレイの制限​

リプレイが対応するのは、記録された応答と読み取り専用の操作に限られます。ここに示す保存済みの課金修復をリプレイすることはできません。生成された Scala 射影を実行してもグラフを記述するだけで、エージェントを再実行したり、その変更を繰り返したりはしません。対応する入力は リプレイのリファレンス を参照してください。