Enum Action

atomic-agent/src/turn/phase.rs:241–282

/// appropriate subsystem.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum Action {
    /// Record the turn's file changes as an Atomic change.
    ///
    /// Replaces Entire CLI's `ActionCondense`. The orchestrator should:
    /// 1. Call `watcher.end_turn()` to get `TurnChanges`
    /// 2. Call `record_turn()` to create an Atomic change
    /// 3. Apply the change to the agent's view
    RecordTurn,

    /// Record only if files were actually modified during the turn.
    ///
    /// Replaces Entire CLI's `ActionCondenseIfFilesTouched`. Used in the
    /// `Ended` phase when a record event occurs — only creates a change
    /// if there are actual file modifications to capture.
    RecordIfChanged,

    /// Discard the session if no files were touched.
    ///
    /// Same as Entire CLI's `ActionDiscardIfNoFiles`. If the session ended
    /// and a record event occurs with no file changes, the session state
    /// can be cleaned up.
    DiscardIfNoFiles,

    /// Update the session's `last_interaction` timestamp.
    ///
    /// Applied directly to the session state by `apply_common_actions()`.
    /// This is used for stale session detection in `atomic agent status`.
    UpdateInteraction,

    /// Clear the `ended_at` timestamp (session is re-entering).
    ///
    /// Applied directly to the session state by `apply_common_actions()`.
    /// This happens when a SessionStart event arrives for an ended session.
    ClearEndedAt,

    /// Warn the user about stale concurrent sessions.
    ///
    /// This is emitted when a SessionStart or TurnStart event arrives
    /// while another session is already active. The orchestrator should
    /// log a warning but continue processing.
    WarnStaleSession,
}

impl Action {
    /// Returns `true` if this action requires strategy-specific handling.