Mission State Machine Builder

Overview

Convert a fragile sequence of actions into a state machine that is easier to debug, resume, and adapt when a mission does not go exactly as planned.

Workflow

1. Break the run into explicit states.
   • launch or leave base
   • align or detect
   • act on mission model
   • verify outcome if needed
   • return or transition
2. Define transition logic for every state.
   • success next state
   • failure next state
   • timeout behavior
   • retry count if allowed
3. If the user gives a structured state list, run scripts/scaffold_state_machine.py to create a python skeleton.
4. Keep mission code inside state handlers, not in the dispatcher.
5. Return the result in this order.
   • state table.
   • generated or revised code skeleton.
   • failure handling notes.
   • minimal bench tests per state.

Rules