# ActionTrail Ecosystem Adoption

> **Repo:** `learning_ai_trails`
> **Ecosystem focus:** Cowork audit -> trail-report artifact golden flow
> **Status:** Phase 3 baseline implemented

---

## 1. Role In The Ecosystem

ActionTrail is the canonical audit-normalization layer for Phase 3.

It should:

- accept structured Cowork audit exports
- convert them into durable ecosystem `trail-report` artifacts
- preserve causation and correlation for downstream consumers
- make the audit flow readable without requiring Cowork runtime knowledge in every consumer

---

## 2. Current Adoption

- `backend/src/lib/ecosystem-phase3.ts` creates and persists a canonical `trail-report`
- latest indexes now include:
  - `latest-trail-report.json`
  - `latest-trail-report-created-event.json`
- the Phase 3 payload captures:
  - action counts
  - tool call counts
  - approval counts
  - failure counts
  - safety signal counts
  - task list
  - action breakdown
  - normalized entry list

---

## 3. Remaining Follow-Up

- add optional route/service wiring for importing Cowork exports through the live backend
- map ActionTrail-native actions and approvals into the same artifact view
- connect `audit.action.logged` taxonomy work when runtime event forwarding is added

---

## 4. Commits

- `e294cf5`
