# Claw Cowork Ecosystem Adoption

> **Repo:** `oss/learning_ai_claw-cowork`
> **Ecosystem focus:** audited artifact producer for Phase 3
> **Status:** runtime and checkpoint drill-in adopted

---

## 1. Role In The Ecosystem

Claw Cowork is the audit-producing source system for Phase 3.

It already provides:

- structured append-only audit logs
- filtered audit queries
- JSON export
- CSV export
- desktop audit inspection UI

Those existing surfaces make Cowork the right producer for the audited artifact flow without adding risky new desktop plumbing.

---

## 2. Current Adoption

Phase 3 baseline reuses the existing desktop export surface:

- `query_audit_log`
- `export_audit_json`
- `export_audit_csv`

ActionTrail now treats the exported JSON audit shape as the canonical import input for `trail-report` creation.

---

## 3. Runtime Conformance Follow-Up

For Phase 5, Cowork is also a first conforming runtime implementation.

Current runtime adoption state:

- shared runtime projections now exist through `cowork-service`
- audit/action surfaces preserve canonical Rust `event_id`
- approvals and action logs can participate in ActionTrail replay
- persisted checkpoint records now back runtime todo review and runtime checkpoint summaries
- checkpoint summaries now preserve artifact, memory, and approval refs when Cowork provides them
- hosted admin runtime review now supports Cowork-specific checkpoint drill-in
- checkpoint drill-in now separates direct persisted Cowork observations from projected runtime summary fields
- session and task IPC projections now expose canonical event IDs directly
- the shared runtime contract now explicitly documents which Cowork states are direct Rust observations versus `cowork-service` projections

Remaining follow-up:

- add an explicit product-local helper for exporting ecosystem-ready audit payloads
- optionally emit canonical runtime events alongside the current local audit logs
- add signed dispatch or upload flow from Cowork desktop into ActionTrail when runtime integration is prioritized

---

## 4. Commits

- existing producer surface predates Phase 3 baseline
- `34c9b78` added persisted checkpoint IPC summaries for runtime todo and resume review
- `4ff578e` added checkpoint runtime refs plus canonical session/task IPC event IDs
- `82a44c2` added `cowork-service` checkpoint drill-in and the hosted admin runtime console review surface
