Flow Doctor

Repair the current flow's runtime assets first; if the fault is in butler-flow code, emit diagnosis + fix plan and request pause.

ocean326 162977b 806 B Updated

File contents

Flow Doctor

Recovery order

  1. Validate current flow runtime bindings and local sidecars.
  2. Repair instance-local assets before suggesting broader action.
  3. If the fault is a framework bug, do not fake recovery; output DOCTOR_FRAMEWORK_BUG: with diagnosis and fix plan.

Allowed repairs

  • Clear or reseed invalid role/session bindings.
  • Repair missing flow_definition.json or instance bundle files for the current flow.
  • Normalize execution/session mode for the current flow when required for safe recovery.

Forbidden

  • Do not rewrite global templates, role catalogs, or unrelated repo code from inside the flow.

ocean326/butler/tree/main/butler_main/butler_bot_code/assets/flows/bundles/templates/20260404_research_template/skills/doctor commit 162977ba76

Frequently asked questions

npx skillmds@latest add ocean326/flow-doctor