Class: Goal

Inherits:
ApplicationRecord show all
Defined in:
app/models/goal.rb

Overview

A persistent objective tracked by the analytical brain during a session. Goals form a two-level hierarchy: root goals represent high-level objectives (semantic episodes), while sub-goals are TODO-style steps rendered as checklist items in the agent’s system prompt.

The analytical brain creates and completes goals; the main agent sees them in its context window but never manages them directly.

Constant Summary collapse

STATUSES = 
%w[active completed].freeze

Instance Method Summary collapse

Instance Method Details

#active? ⇒ Boolean

Returns true if this goal is still active.

Returns:

  • (Boolean) —

    true if this goal is still active



35
 
# File 'app/models/goal.rb', line 35

def active? = status == "active"

#as_summary ⇒ Hash{String => Object}

Serializes this goal for ActionCable broadcast and TUI display. Includes nested sub-goals for root goals.

Returns:

  • (Hash{String => Object}) —

    with keys “id”, “description”, “status”, and “sub_goals” (Array of Hash with “id”, “description”, “status”)



71
72
73
74
75
76
77
78
79
80
 
# File 'app/models/goal.rb', line 71

def as_summary
  {
    "id" => id,
    "description" => description,
    "status" => status,
    "sub_goals" => sub_goals.map { |sub|
      {"id" => sub.id, "description" => sub.description, "status" => sub.status}
    }
  }
end

#cascade_completion! ⇒ void

This method returns an undefined value.

Cascades completion to all active sub-goals. Called when a root goal is finished — remaining sub-items are implicitly resolved because the semantic episode that spawned them has ended.

Uses update_all to avoid N per-record after_commit broadcasts; the caller (AnalyticalBrain::Tools::FinishGoal) wraps the whole operation in a transaction so the root goal’s single broadcast includes the cascaded state.



50
51
52
53
 
# File 'app/models/goal.rb', line 50

def cascade_completion!
  now = Time.current
  sub_goals.active.update_all(status: "completed", completed_at: now, updated_at: now)
end

#completed? ⇒ Boolean

Returns true if this goal has been completed.

Returns:

  • (Boolean) —

    true if this goal has been completed



32
 
# File 'app/models/goal.rb', line 32

def completed? = status == "completed"

#release_orphaned_pins! ⇒ Integer

Releases pinned messages that have no remaining active Goal references anywhere in the session. Called after goal (and cascade) completion —the orphaned scope checks all Goals, so pins shared with other active Goals survive automatically via reference counting.

Returns:

  • (Integer) —

    number of released pins



61
62
63
64
 
# File 'app/models/goal.rb', line 61

def release_orphaned_pins!
  orphaned = session.pinned_messages.orphaned
  orphaned.destroy_all.size
end

#root? ⇒ Boolean

Returns true if this is a root goal (no parent).

Returns:

  • (Boolean) —

    true if this is a root goal (no parent)



38
 
# File 'app/models/goal.rb', line 38

def root? = !parent_goal_id