samagotchi 0.152.0 → 0.154.0

data/lib/samagotchi/terminal_ui/one_shot_sink.rb

@@ -10,7 +10,7 @@ module Samagotchi
     # stderr. stdout is the answer's alone, printed after the turn: a
     # script or a parent agent reads it.
     #
-    # It prints the retry lines the REPL shows: the loop asking again after
+    # It prints the retry lines the attached terminal shows: the loop asking again after
     # an empty answer (:empty_answer_retry), and a generation retried after
     # a failed request (:generation_retrying). And the hooks' notices
     # (:hook_notice): one during the turn as it comes, one the after_turn
@@ -18,7 +18,7 @@ module Samagotchi
     # #flush, which the caller runs after it has printed the answer. And
     # the load warnings the first turn announces (:guardrail_warning: the
     # guardrails, the plugins, an orphaned project memory folder), as the
-    # REPL's "<label>> …" lines.
+    # attached terminal's "<label>> …" lines.
     class OneShotSink
       include Formatting
 

data/lib/samagotchi/terminal_ui/plain_surface.rb

@@ -12,7 +12,7 @@ module Samagotchi
     # print as lines. The activity slot is dropped, because redrawing it in
     # place needs cursor movement (the turn's lines still print as they end).
     # The prompt is Reline's own, so output may cross it; the editor slot
-    # prints the prompt of a plain read (the REPL's ? off a terminal).
+    # prints the prompt of a plain read (a question's ? off a terminal).
     class PlainSurface
       include Surface
 

data/lib/samagotchi/terminal_ui/question_prompt.rb

@@ -11,8 +11,7 @@ module Samagotchi
     # slot content (#slot), the line it leaves (#summary) and the parsing of
     # a typed answer ("2", "1,3", "1 3; text", option labels). No I/O:
     # callers draw the slot and print the messages, and
-    # record the answer (the REPL on its Engine, an attached UI over the
-    # Bridge). An approval (kind "approval") takes only a number, an exact
+    # record the answer (an attached UI over the Bridge). An approval (kind "approval") takes only a number, an exact
     # label, y (the first option, Allow once) or n (the last, Deny), plus
     # an optional "; reason"; a substring would pick the wrong one ("y" is
     # in "Deny"). The step-limit question (kind "continue") reads the
@@ -86,8 +85,8 @@ module Samagotchi
       end
 
       # The line a question dismissed in a --non-interactive run leaves (no
-      # one could answer it there): the REPL's own, and an attached UI's on
-      # its cancel (QuestionDesk::UNANSWERABLE_REASON).
+      # one could answer it there): the one-shot's own, and an attached UI's
+      # on its cancel (QuestionDesk::UNANSWERABLE_REASON).
       UNANSWERABLE_TEXT = "(dismissed: no one to answer in a non-interactive run)"
 
       # What a question closed with no answer here says: a relayed approval
@@ -220,7 +219,7 @@ module Samagotchi
       end
 
       # The continue words, or an option's number. Empty is Continue (Enter
-      # alone, as at the REPL's continue prompt).
+      # alone).
       def parse_continue(raw)
         text = raw.to_s.strip
         if text.match?(/\A\d+\z/)

data/lib/samagotchi/terminal_ui/reline_seam.rb

@@ -39,13 +39,13 @@ module Samagotchi
         attr_reader :screen
 
         # Asked first on Ctrl-C during a read, with or without a screen: a
-        # truthy answer means it handled the key (the REPL cancelled a running
-        # turn) and the read goes on with the typed text as it is.
+        # truthy answer means it handled the key (the attached loop cancelled a
+        # running turn) and the read goes on with the typed text as it is.
         # @return [#call, nil]
         attr_accessor :interrupt_handler
 
         # Called with no arguments for each key a read takes (typing is
-        # activity for the REPL's idle clock).
+        # activity for an idle clock; nobody sets it now).
         # @return [#call, nil]
         attr_accessor :key_handler
 

data/lib/samagotchi/terminal_ui/status_row.rb

@@ -6,8 +6,8 @@ module Samagotchi
   class TerminalUI
     # The status row under the prompt, the same for both TUIs:
     # `status> Title | model=… | ↳ parent | ⑂ 2 running · 1 waiting | 2 participants | ctx=12.3% (under20) | mem: … | muted: …`.
-    # A UI feeds it what it learns (attached mode from the Bridge's events,
-    # the REPL from its Engine's) through #update, and the row is redrawn in
+    # The attached TUI feeds it what it learns from the Bridge's events
+    # through #update, and the row is redrawn in
     # the surface's status slot only when its text changes.
     class StatusRow
       include Formatting
@@ -54,7 +54,7 @@ module Samagotchi
         @shown = nil
       end
 
-      # The surface it draws on (the REPL swaps in a live region): the row
+      # The surface it draws on (no caller since the REPL went): the row
       # is drawn there at the next change.
       def surface=(surface)
         @surface = surface
@@ -72,8 +72,8 @@ module Samagotchi
         refresh
       end
 
-      # Take a session's state: the REPL's Engine#session_state_snapshot, or
-      # the one a worker sends an attached TUI when it joins. A key the state
+      # Take a session's state: the one a worker sends an attached TUI when
+      # it joins (Engine#session_state_snapshot). A key the state
       # lacks (an older worker's) leaves its field as it was; the served pair
       # is cleared without one, and the model is kept without a name.
       # @param default_model [String, nil] the config's default, named beside
@@ -94,8 +94,7 @@ module Samagotchi
       STATE_LISTS = { used_memories: :used_memory_names, preloaded: :preloaded_memory_names,
                       muted: :muted_memory_names }.freeze
 
-      # Take what a turn event says about the row (the Engine's events in
-      # the REPL, the Bridge's in attached mode): ctx, the memories used,
+      # Take what a turn event says about the row (the Bridge's events): ctx, the memories used,
       # the model the server served, whether a turn runs (the steer
       # hint). Other events change nothing.
       def take_event(event)
@@ -178,7 +177,7 @@ module Samagotchi
       end
 
       # `⑂ 2 running · 1 waiting`, the counts there are; "" with neither (no
-      # children, or all ended). Not "not reported": a REPL parent is never
+      # children, or all ended). Not "not reported": a one-shot parent is never
       # given its children's replies (no wakes there), and a worker moves
       # the cursors only after the turn_completed a terminal refreshes on.
       def children_text(counts)