learning_ai_common_plat/docs/ecosystem/adoption/learning_ai_flowmonk.md

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

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