ai_orchestrator/docs/architecture/05_state_machines.md

State Machines

TaskStatus

created
  -> planned
  -> running
  -> waiting_confirmation
  -> waiting_manual
  -> completed
  -> failed
  -> cancelled

Правила:

• created -> planned: planner graph создан;
• planned -> running: есть готовые к исполнению nodes;
• running -> waiting_confirmation: execution остановлен на pending approval;
• running -> waiting_manual: policy/manual gate остановил автостарт;
• running -> completed: finalizer сформировал итог;
• running -> failed: unrecoverable error;
• waiting_confirmation -> running: approval получен;
• waiting_manual -> running: пользователь вручную продолжил выполнение.

NodeStatus

pending
  -> ready
  -> running
  -> waiting_confirmation
  -> completed
  -> failed
  -> skipped
  -> cancelled

ConfirmationStatus

pending
  -> approved
  -> rejected
  -> expired
  -> cancelled

WorkerSessionStatus

connecting
  -> online
  -> busy
  -> stale
  -> disconnected

Retry Principles

• retry выполняется только для явно retryable failures;
• retry history фиксируется в node attempts и event log;
• confirmation-required state не считается failure;
• idempotency must be explicit for side-effecting nodes.