@startuml Command Processing State Machine
skinparam shadowing false
skinparam ArrowColor #555
skinparam state {
  StartColor #A5D6A7
  BackgroundColor #FAFAFA
}

[*] --> DETECTED : YAML block found

state DETECTED {
}
DETECTED --> PARSING : debounce/settle passed
PARSING --> VALIDATING : YAML parsed
PARSING --> ERROR : parse failure

VALIDATING --> DEDUPE_CHECK : required fields ok
VALIDATING --> ERROR : validation failed

state DEDUPE_CHECK
DEDUPE_CHECK --> SKIPPED : duplicate or example:true
DEDUPE_CHECK --> READY : new and runnable

state READY
READY --> EXECUTING : user intent or auto-exec policy
READY --> [*] : STOP triggered

state EXECUTING
EXECUTING --> COMPLETE : success
EXECUTING --> ERROR : API/network failure

state SKIPPED
SKIPPED --> [*]

state COMPLETE
COMPLETE --> [*]

state ERROR
ERROR --> [*]

@enduml