learning_ai_common_plat/docs/ecosystem/adoption/learning_ai_trails.md

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