# Ecosystem Verification Matrix

> **Status:** Draft
> **Owner:** `learning_ai_common_plat`
> **Purpose:** Define how ecosystem work is verified before it is considered complete.

---

## 1. Principle

A cross-product feature is not done when one repo compiles.

It is done when:

1. the shared contract is updated
2. the producing repo emits the expected behavior
3. the consuming repo handles it correctly
4. the tracker reflects the implementing commit(s)

---

## 2. Verification Layers

### Layer 1: Doc verification

- contract doc updated
- checklist updated
- tracker updated
- open decisions called out if unresolved

### Layer 2: Contract verification

- schema/type examples compile or validate
- sample payloads are present
- event names and field names are stable

### Layer 3: Producer verification

- source repo emits or stores the expected contract shape
- unit/integration tests added where appropriate

### Layer 4: Consumer verification

- downstream repo accepts and uses the contract correctly
- no translation hacks or undocumented fallback behavior

### Layer 5: End-to-end flow verification

- the actual user journey works across repo boundaries

---

## 3. Phase-1 Golden Flow Checks

### Transcript -> Note -> Memory

- [ ] transcript artifact created
- [ ] note artifact created or linked
- [ ] memory artifact created or proposed
- [ ] canonical events emitted
- [ ] provenance preserved across all steps
- [ ] tracker updated with commit links

### Plan -> Routine -> Habit

- [ ] plan artifact exists
- [ ] routine generated from plan
- [ ] habit generated from plan
- [ ] canonical events emitted
- [ ] user-visible flow validated
- [ ] tracker updated with commit links

### Cowork -> Trail -> Notes -> Memory

- [ ] agent run logged
- [ ] output artifact generated
- [ ] ActionTrail can replay or inspect the run
- [ ] downstream note or memory artifacts linked
- [ ] approval trail preserved where required
- [ ] tracker updated with commit links

---

## 4. Required Completion Evidence

For every major implementation item, attach:

1. commit hash(es)
2. affected repos
3. verification commands or tests
4. residual risks
5. tracker update

---

## 5. Repo-Level Verification Owners

- `learning_ai_common_plat`
  - shared schema validation in `packages/events`
  - platform-service route tests
  - cowork-service route tests
  - admin-web proxy and dashboard route tests
- `learning_voice_ai_agent`
  - transcript producer tests and artifact persistence checks
- `learning_ai_notes`
  - transcript and trail import route/library tests
- `learning_multimodal_memory_agents`
  - memory import route/library tests
- `learning_ai_flowmonk`
  - runtime route tests and Phase 2 artifact flow tests
- `learning_ai_clock`
  - routine import tests for Phase 2
- `learning_ai_efforise`
  - habit import tests for Phase 2
- `learning_ai_trails`
  - trail artifact import and causation tests for Phase 3
- `oss/learning_ai_claw-cowork`
  - native audit/runtime emission verification where local Rust tooling is available

---

## 6. Implementation Checklist

- [ ] finalize phase-1 golden flow checks
- [x] define repo-level verification owners
- [ ] define minimum evidence for “done”
- [ ] add links from tracker rows to verification evidence

Commits:

- `41fa2cd` drafted the initial version
