# 記録リファレンス

プロジェクト内の操作の記録（記録 (証跡)）と、実行記録のエクスポートについて、**マーケットプレイス版で SaaS 版と違う点**をまとめます。記録の見方は[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md#%E8%A8%98%E9%8C%B2-%E8%A8%BC%E8%B7%A1)、SaaS 版と共通の出来事の一覧は[SaaS 版の記録リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/events-ref.md)にあります。

## 加わる出来事

| 出来事               | 残るとき                                          |
| ----------------- | --------------------------------------------- |
| **案件設定の変更**       | 案件の設定を新しいバージョンにしたとき                           |
| **外部条件の成立で進行**    | 外部条件待ちの確認で、条件が成立して基盤が次の工程へ進めたとき（人の承認とは区別されます） |
| 条件分岐の判定／条件分岐で人に確認 | SaaS 版と同じに残ります                                |

## 共通の出来事（記録に残るもの）

SaaS 版と同じ名前で、マーケットプレイス版でも記録に残る出来事です（記録を書く処理から確認できたもの）。

| 種別                                       | CSV の `event_type`                                                                                                                                                                                             |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 確認の依頼・確認結果・期限の催促・期限超過・期限延長・担当の付け替え       | `gate.requested`・`gate.resolved`・`gate.due_soon`・`gate.overdue`・`gate.extended`・`gate.reassigned`                                                                                                              |
| 案件の担当の付け替え（案件ごと）                         | `run.approvers_reassigned`                                                                                                                                                                                     |
| 案件の開始・開始できなかった・締め切りの設定・締め切り超過・停滞         | `run.started`・`run.start_failed`・`run.deadline_set`・`run.deadline_overdue`・`run.stalled`                                                                                                                       |
| 通知の送信（送信待ち・送信完了・送信できなかった・送信できたか不明）       | `delivery.accepted`・`delivery.acked`・`delivery.failed`・`delivery.unconfirmed`                                                                                                                                  |
| 本文の閲覧・実行記録のエクスポート                        | `forensic.viewed`・`forensic.exported`                                                                                                                                                                          |
| 定義の変更・承認の提出・承認・差し戻し・取り下げ                 | `project.definition_changed`・`project.definition_submitted`・`project.definition_approved`・`project.definition_rejected`・`project.definition_withdrawn`                                                         |
| 実行ルール・メンバー・役割の変更                         | `policy.changed`                                                                                                                                                                                               |
| 条件分岐の判定・条件分岐で人に確認                        | `branch.decided`・`branch.asked_human`                                                                                                                                                                          |
| 完了の報告が、すでに閉じた案件や古い試行へのものだったため、受け付けずに無視した | `completion.stale`                                                                                                                                                                                             |
| 定義の書き出し・取り込み・ひな形・外部公開・持ち主の変更・削除          | `project.exported`・`project.imported`・`project.template_published`・`project.template_unpublished`・`project.created_from_template`・`project.exposure_changed`・`project.ownership_transferred`・`project.deleted` |

マーケットプレイス版にだけある出来事は次のとおりです。**登録 Agent が SDK で報告する操作**（`tool.invoked`・`tool.effect`・`tool.denied`）も、記録に残ります。`context.manifest` は保存されますが、記録の画面と記録の CSV には出ません。基盤が 1 つずつ止める操作の記録ではなく、Agent が自分で報告した内容です。

| `event_type`             | 何が起きたとき                        |
| ------------------------ | ------------------------------ |
| `case.config.changed`    | 案件の設定を新しいバージョンにした（**案件設定の変更**） |
| `artifact.created`       | 成果物が作られた（Agent の出力、または人の編集版）   |
| `gate.observed_external` | 外部条件待ちの確認で、連携先の状態を読んだ          |

## 記録 (証跡) の CSV

「CSV出力」で、いま選んでいる種別の記録を、5000 件まで出力します。理由の入力が必要で、本文の閲覧と同じく記録に残ります。列は次のとおりです。

| 列                   | 内容                               |
| ------------------- | -------------------------------- |
| `occurred_at`       | 時刻（UTC）                          |
| `event_type`        | 出来事の種類                           |
| `actor`             | 利用者なら名前。それ以外は、記録した仕組みの名前か、実行者の区分 |
| `decision`          | 決定や判定の値                          |
| `reason`            | 理由                               |
| `step`              | 工程名                              |
| `workitem`          | 確認依頼の題名                          |
| `run_id`            | 案件（実行）の ID                       |
| `root_execution_id` | 実行の ID                           |
| `metadata`          | 記録に付いた参照の情報（JSON）                |

## ない出来事

次の出来事は、記録に出ません。

- 接続の確認の失効（`gate.cancelled`）
- 実行の再開（`run.resumed`）と、並列のレーンの合流（`run.lane_joined`）
- メールでの起動の拒否（`mail.rejected`）
- 外部の自動化の呼び出し（`automation.called`）
- 巡回再実行要求（`sweep.rerun_requested`）
- 改善案の相談と実施（`consult.*`・`improvement.applied`）
- ライブラリのファイルの登録・新しいバージョンの追加（`library.*`）

## 実行記録とエクスポートに出る項目

実行記録には「**実行環境のイメージ**」が出ます。実行記録のエクスポートにも、動いたイメージのタグが出ます。ワークフローでは管理者が認定した image digest（`sha256:…`）が、サイクルではレジストリ・イメージ名・タグが出ます。
