Struct GoalTracker 

pub struct GoalTracker { /* private fields */ }

Pure state machine for goal tracking.

Implementations

impl GoalTracker

pub fn new(session_dir: PathBuf) -> Self

Create a new tracker with no active goal.

pub fn from_snapshot(session_dir: PathBuf, snapshot: GoalOrchestration) -> Self

Restore tracker state from a persisted snapshot.

pub fn snapshot(&self) -> Option<&GoalOrchestration>

Return an immutable reference to the current orchestration snapshot.

pub fn snapshot_mut(&mut self) -> Option<&mut GoalOrchestration>

Return a mutable reference to the current orchestration snapshot.

pub fn is_active(&self) -> bool

true if a goal is currently active.

pub fn phase(&self) -> Option<GoalPhase>

Current execution phase, if a goal is active.

pub fn status(&self) -> Option<GoalStatus>

Current lifecycle status, if a goal is active.

pub fn current_subagent_id(&self) -> Option<&str>

ID of the currently executing subagent, if any.

pub fn objective(&self) -> Option<&str>

Human-readable objective, if a goal is active.

pub fn token_budget(&self) -> Option<i64>

Token budget cap, if set.

pub fn create_goal( &mut self, goal_id: String, objective: String, token_budget: Option<i64>, token_baseline: i64, created_at: String, baseline_commit: Option<String>, )

Create a new goal. Replaces any existing orchestration.

pub fn set_phase(&mut self, phase: GoalPhase)

Update the execution phase of the active goal.

pub fn set_current_subagent(&mut self, id: Option<String>, role: Option<String>)

Update the current subagent ID and role.

pub fn pause(&mut self, reason: GoalPauseReason) -> bool

Pause the goal with a specific reason. Only transitions from Active.

pub fn pause_with_message( &mut self, reason: GoalPauseReason, message: String, ) -> bool

Like Self::pause but also stores a human-readable message.

pub fn resume(&mut self) -> bool

Resume a paused goal (any paused variant). Returns true if applied.

pub fn complete(&mut self) -> bool

Mark the goal as complete. Accepts Active or any paused variant.

pub fn budget_limit(&mut self) -> bool

Mark the goal as budget-limited. Accepts Active or any paused variant.

pub fn clear(&mut self)

Clear the goal entirely.

pub fn account_elapsed(&mut self)

Flush elapsed wall-clock time into elapsed_ms.

pub fn record_classifier_stall(&mut self, fingerprint: &str) -> bool

Record a NotAchieved rejection’s gap fingerprint and report whether the goal has stalled.

pub fn rollback_classifier_attempt(&mut self)

Undo the most recent attempt-slot reservation.

pub fn reset_classifier_stall(&mut self)

Clear the stall streak.

pub fn record_not_achieved_streak(&mut self) -> u32

Increment the consecutive-NotAchieved streak and return the new value.

pub fn claim_strategist_fire( &mut self, should_fire: impl Fn(u32, u32) -> bool, ) -> Option<u32>

Atomically evaluate the strategist trigger and claim a fire.

pub fn revoke_strategist_cap_bonus(&mut self)

Revoke the cap bonus granted by Self::claim_strategist_fire.

pub fn reset_strategist_state(&mut self)

Reset ALL strategist state.

pub fn record_strategy_recommendation( &mut self, path: String, recommendation: String, )

Persist the strategist’s latest output path + short recommendation.

pub fn append_history(&mut self, entry: GoalHistoryEntry)

Append a history entry to the active goal, if any.

Trait Implementations

impl Debug for GoalTracker

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.