learning_ai_common_plat/docs/ecosystem/adoption/learning_ai_flowmonk.md

2.6 KiB

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