# Adoption: learning_ai_flowmonk

> **Status:** Phase 2 baseline implemented, Phase 5 runtime implementation verified end to end, optional replay controls implemented
> **Owner:** `learning_ai_flowmonk`
> **Ecosystem focus:** plan -> routine -> habit golden flow and scheduled runtime projection

---

## Goals

- emit canonical `plan` artifacts from planning-export data
- emit canonical `artifact.created` events for plans
- provide enough lineage for ChronoMind and EffoRise consumers
- expose FlowMonk planning/runtime state through the shared runtime contract

## Checklist

- [x] map planning export output into the shared plan artifact schema
- [x] emit `artifact.created` for the plan artifact
- [x] include correlation/session IDs for downstream linking
- [x] persist latest plan indexes for downstream consumers
- [x] expose direct runtime sessions, tasks, todos, runs, approvals, and actions
- [x] persist native runtime todos, approvals, and checkpoints
- [x] expose product-facing checkpoint summaries for planning-session resume
- [x] document the rule for when a scheduled entry becomes a new run under an existing session
- [x] add runtime approvals and todos direct user-managed editing surfaces
- [x] add a dedicated runtime review UI for approvals, todos, and checkpoints
- [x] add runtime run and action drill-in inside the review UI
- [x] add checkpoint resume guidance and linked ref review inside the runtime UI
- [x] add replay-oriented run filtering and action payload drill-in
- [x] emit replayable runtime events when todos and approvals mutate source planning data
- [x] verify runtime review end to end against the live local backend
- [x] add replay preview and guarded replay execution controls for deterministic runtime actions

Commits:

- `59ab8b1` implemented the Phase 2 producer path
- `1ccafa7` implemented direct runtime sessions, tasks, runs, actions, and dispatch validation
- `faf93ec` implemented direct runtime approvals and todos
- `86470b2` persisted native runtime todo, approval, and checkpoint records
- `6b1e52c` added direct user-managed runtime todo and approval editing surfaces
- `da2db8e` added the FlowMonk runtime review web UI
- `19fd4e1` added FlowMonk runtime run and action drill-in
- `94420a8` added checkpoint resume guidance and linked ref review
- `51cf948` added replay-oriented run filtering and action payload drill-in
- `71038bb` emits replayable runtime domain events from todo and approval mutations
- `5fc778b` verifies the runtime review flow end to end with Playwright and hardens the local test harness and sidebar behavior
- `8176395` adds safe replay preview and execution controls with backend, UI, and e2e coverage
