openclacky 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e897a7568d8b457d317c56ff402a76c1907b4a158e0e7382586e2b66115ee0f7
-  data.tar.gz: 5fbeb452695441035d7f7d4f7ba1f0ef63dbb198daebb17600eb6e9f9fb72c46
+  metadata.gz: 22bdc5132636582b787ebc49b43157871d15cfc0519a8ba93bc69fcfa9b58a2b
+  data.tar.gz: 97c40c43d3ae3252f81b1d3b92c89812cf28bdb181094d1fca6f5fea8ea9daa9
 SHA512:
-  metadata.gz: 64d4764470f2f8bac52e7e8233afbf441336c8a81238def9800cf6735a90798435cc8d43e9056aa4c6e53f51760067e57b5b2670263339590b7f9fd744cc6920
-  data.tar.gz: c27a2313d3595adcb48a66e396c9eec8947550132a74bb5b8535b11d93e639b240bc1dafeab0a7bf9b4af665c2fa6a22630f8b23ab0061b2de4ebbfcae1f3299
+  metadata.gz: 1c195480e06945b0a09e031498e5f1f4df5d5bb661ef123cf139cd570b33522a47475b8d698e3999a44de8979884e7e8f4dcc3adc424896965ad69cbac83902d
+  data.tar.gz: a151a7178e6541880ddad41930adf0e652571bb732cd82ba6b6c2de8e9d880e587a1e680d2c76a3dcb8f9609152f092b23a38afb1c443f8082b1f081d34d81da

data/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1] - 2026-05-17
+
+### Added
+- **WeChat SendQueue with batching, throttling, and retry.** Messages sent to multiple WeChat official account users are now queued, batched (up to 100 recipients per call), throttled to 1 batch/second, and automatically retried on failure — preventing 45007 rate-limit errors during broadcasts. (#127)
+- **Session ID in TUI session bar.** The terminal UI session bar now displays the session ID alongside the session name, making it easy to identify sessions when cross-referencing with logs or Web UI.
+- **TUI todo clean-up on task completion.** Completed todos are now removed from the terminal display when a task finishes, keeping the TUI uncluttered. (#94)
+
+### Improved
+- **Brand skills persist across same-brand upgrades.** Brand skills are no longer removed and re-downloaded when the brand stays the same after an upgrade — eliminating unnecessary network calls and keeping skill state stable.
+- **Ruby 2.6 install reliability.** The installer now pre-installs rouge 3.30.0 before `gem install` and retries with a pinned version on Ruby 2.6, avoiding dependency resolution failures on older macOS system Ruby.
+
+### Fixed
+- **TUI progress bar flicker.** The progress bar in terminal mode no longer flashes when updating rapidly, providing a smoother visual experience.
+- **Xcode command auto-install loop.** The agent no longer gets stuck in a loop trying to auto-install missing Xcode command-line tools.
+- **Brand license warning after 3-day idle.** Fixed a spurious license warning that appeared on startup after the server had been idle for 3 days.
+
 ## [1.1.0] - 2026-05-15
 
 ### Added

data/lib/clacky/agent/skill_manager.rb

@@ -91,6 +91,20 @@ module Clacky
       # Keeps context tokens bounded regardless of how many skills are installed.
       MAX_CONTEXT_SKILLS = 30
 
+      # Process-wide deduper for the "skill context limit" warning so that
+      # every newly constructed Agent (sub-agents, retries, web turns…) doesn't
+      # re-emit the same line.
+      @skill_limit_warned_signatures = {}
+      @skill_limit_warn_mutex = Mutex.new
+
+      def self.warn_skill_limit_once(signature, &block)
+        @skill_limit_warn_mutex.synchronize do
+          return if @skill_limit_warned_signatures[signature]
+          @skill_limit_warned_signatures[signature] = true
+        end
+        block.call
+      end
+
       # Generate skill context - loads all auto-invocable skills allowed by the agent profile
       # @return [String] Skill context to add to system prompt
       def build_skill_context
@@ -103,17 +117,16 @@ module Clacky
         auto_invocable = all_skills.select(&:model_invocation_allowed?)
 
         # Enforce system prompt injection limit to control token usage.
-        # Warn only when the set of dropped skills *changes* — this message
-        # is otherwise emitted once per agent turn (build_skill_context is
-        # called during every system prompt assembly) and floods the log.
+        # Warn at most once per process per dropped-set signature — build_skill_context
+        # runs on every system-prompt assembly and is invoked from many short-lived
+        # Agent instances (sub-agents, web turns…), so per-instance dedup wasn't enough.
         if auto_invocable.size > MAX_CONTEXT_SKILLS
           kept    = auto_invocable.first(MAX_CONTEXT_SKILLS)
           dropped = auto_invocable.drop(MAX_CONTEXT_SKILLS)
           dropped_names = dropped.map(&:identifier)
           signature = dropped_names.sort.join(",")
 
-          if @skill_limit_warned_signature != signature
-            @skill_limit_warned_signature = signature
+          SkillManager.warn_skill_limit_once(signature) do
             Clacky::Logger.warn(
               "Skill context limit: #{auto_invocable.size} auto-invocable skills found, " \
               "only injecting first #{MAX_CONTEXT_SKILLS} " \

data/lib/clacky/brand_config.rb

@@ -44,7 +44,7 @@ module Clacky
                 :license_expires_at, :license_last_heartbeat, :device_id,
                 :logo_url, :support_contact, :license_user_id,
                 :support_qr_url, :theme_color, :homepage_url,
-                :distribution_last_refreshed_at
+                :distribution_last_refreshed_at, :license_last_heartbeat_failure
 
     def initialize(attrs = {})
       @product_name            = attrs["product_name"]
@@ -66,6 +66,11 @@ module Clacky
       # #refresh_distribution!). Persisted to brand.yml so 24h throttling
       # survives restarts.
       @distribution_last_refreshed_at = parse_time(attrs["distribution_last_refreshed_at"])
+      # Tracks when heartbeats started failing continuously. Set on a failed
+      # heartbeat (only if currently nil), cleared on a successful one.
+      # grace_period_exceeded? uses this — NOT last_heartbeat — so a user who
+      # simply hasn't run the app in days doesn't see a stale "offline" warning.
+      @license_last_heartbeat_failure = parse_time(attrs["license_last_heartbeat_failure"])
 
       # In-memory decryption key cache: "skill_id:skill_version_id" => { key:, expires_at: }
       # Never persisted to disk. Survives across multiple skill invocations within one session.
@@ -130,16 +135,19 @@ module Clacky
       due
     end
 
-    # Returns true when the grace period for missed heartbeats has expired.
+    # Returns true when heartbeats have been failing continuously for longer
+    # than the grace period. Only considers ACTUAL failure streaks — a user
+    # who hasn't launched the app in a week is NOT in violation, since no
+    # heartbeat attempt has actually failed.
     def grace_period_exceeded?
-      if @license_last_heartbeat.nil?
-        Clacky::Logger.debug("[Brand] grace_period_exceeded? => false (no heartbeat recorded)")
+      if @license_last_heartbeat_failure.nil?
+        Clacky::Logger.debug("[Brand] grace_period_exceeded? => false (no active failure streak)")
         return false
       end
 
-      elapsed = Time.now.utc - @license_last_heartbeat
+      elapsed = Time.now.utc - @license_last_heartbeat_failure
       exceeded = elapsed >= HEARTBEAT_GRACE_PERIOD
-      Clacky::Logger.debug("[Brand] grace_period_exceeded? elapsed=#{elapsed.to_i}s grace=#{HEARTBEAT_GRACE_PERIOD}s => #{exceeded}")
+      Clacky::Logger.debug("[Brand] grace_period_exceeded? failing_since=#{@license_last_heartbeat_failure.iso8601} elapsed=#{elapsed.to_i}s grace=#{HEARTBEAT_GRACE_PERIOD}s => #{exceeded}")
       exceeded
     end
 
@@ -178,6 +186,7 @@ module Clacky
       @license_user_id        = nil
       @device_id              = nil
       @distribution_last_refreshed_at = nil
+      @license_last_heartbeat_failure = nil
       { success: true }
     end
 
@@ -210,9 +219,20 @@ module Clacky
         data = response[:data]
         @license_activated_at   = Time.now.utc
         @license_last_heartbeat = Time.now.utc
+        @license_last_heartbeat_failure = nil
         @license_expires_at     = parse_time(data["expires_at"])
         server_device_id = data["device_id"].to_s.strip
         @device_id = server_device_id unless server_device_id.empty?
+
+        # Decide whether the new key belongs to the SAME brand as the previously
+        # activated one. If yes (e.g. trial → paid), keep the installed brand
+        # skills — they are still decryptable and the user shouldn't have to
+        # re-download. If no (switching brands), wipe them.
+        prev_package_name = @package_name
+        prev_product_name = @product_name
+        new_dist          = data["distribution"].is_a?(Hash) ? data["distribution"] : {}
+        same_brand        = brand_identity_match?(prev_package_name, prev_product_name, new_dist)
+
         # Clear ALL stale fields first, then apply fresh values from the new key.
         # Order matters: reset everything before re-assigning so no old value lingers.
         @product_name    = nil
@@ -229,10 +249,10 @@ module Clacky
         owner_uid = data["owner_user_id"]
         @license_user_id = owner_uid.to_s.strip if owner_uid && !owner_uid.to_s.strip.empty?
         apply_distribution(data["distribution"])
-        # Clear previously installed brand skills before saving the new license.
-        # Skills from the old brand are encrypted with that brand's keys — they
-        # cannot be decrypted with the new license and must be re-downloaded.
-        clear_brand_skills!
+        # Skills from a different brand are encrypted with that brand's keys —
+        # they cannot be decrypted with the new license and must be re-downloaded.
+        # Same-brand re-activation (trial→paid, key rotation) preserves them.
+        clear_brand_skills! unless same_brand
         save
         { success: true, message: "License activated successfully!", product_name: @product_name,
           user_id: @license_user_id, data: data }
@@ -258,14 +278,19 @@ module Clacky
 
       # Always derive product_name fresh from the key in mock mode,
       # so switching keys produces a different brand each time.
-      user_id       = parse_user_id_from_key(@license_key)
-      @product_name = "Brand#{user_id}"
+      user_id            = parse_user_id_from_key(@license_key)
+      new_product_name   = "Brand#{user_id}"
+      prev_product_name  = @product_name
+      same_brand         = brand_identity_match?(@package_name, prev_product_name,
+                                                 { "product_name" => new_product_name })
+      @product_name = new_product_name
 
       @license_activated_at   = Time.now.utc
       @license_last_heartbeat = Time.now.utc
+      @license_last_heartbeat_failure = nil
       @license_expires_at     = Time.now.utc + (365 * 86_400)  # 1 year from now
-      # Clear old brand skills so stale encrypted files from a previous brand don't linger
-      clear_brand_skills!
+      # Same-brand re-activation preserves installed skills; switching brands wipes them.
+      clear_brand_skills! unless same_brand
       save
 
       {
@@ -306,13 +331,16 @@ module Clacky
 
       if response[:success]
         @license_last_heartbeat = Time.now.utc
+        @license_last_heartbeat_failure = nil
         @license_expires_at = parse_time(response[:data]["expires_at"]) if response[:data]["expires_at"]
         apply_distribution(response[:data]["distribution"])
         save
         Clacky::Logger.info("[Brand] heartbeat! success — expires_at=#{@license_expires_at&.iso8601} last_heartbeat=#{@license_last_heartbeat.iso8601}")
         { success: true, message: "Heartbeat OK" }
       else
-        Clacky::Logger.warn("[Brand] heartbeat! failed — #{response[:error]}")
+        @license_last_heartbeat_failure ||= Time.now.utc
+        save
+        Clacky::Logger.warn("[Brand] heartbeat! failed — #{response[:error]} (failing_since=#{@license_last_heartbeat_failure.iso8601})")
         { success: false, message: response[:error] || "Heartbeat failed" }
       end
     end
@@ -1134,6 +1162,7 @@ module Clacky
       # Persist user_id so user-licensed features remain available across restarts
       data["license_user_id"]        = @license_user_id        if @license_user_id && !@license_user_id.strip.empty?
       data["distribution_last_refreshed_at"] = @distribution_last_refreshed_at.iso8601 if @distribution_last_refreshed_at
+      data["license_last_heartbeat_failure"] = @license_last_heartbeat_failure.iso8601 if @license_last_heartbeat_failure
       YAML.dump(data)
     end
 
@@ -1155,6 +1184,30 @@ module Clacky
       self.class.version_older?(installed, latest)
     end
 
+    # Decide whether a re-activation key targets the same brand as the
+    # currently-loaded one, so we know whether installed brand skills can stay.
+    #
+    # Identity preference, in order:
+    #   1. package_name — bundle identifier, the strongest brand signal
+    #   2. product_name — display name fallback when package_name is missing
+    #
+    # If neither is present on either side, treat as different brand (safe default:
+    # wipe skills) since we can't confirm continuity.
+    private def brand_identity_match?(prev_package_name, prev_product_name, new_dist)
+      new_dist  = {} unless new_dist.is_a?(Hash)
+      new_pkg   = new_dist["package_name"].to_s.strip
+      old_pkg   = prev_package_name.to_s.strip
+      if !new_pkg.empty? && !old_pkg.empty?
+        return new_pkg == old_pkg
+      end
+
+      new_prod  = new_dist["product_name"].to_s.strip
+      old_prod  = prev_product_name.to_s.strip
+      return new_prod == old_prod if !new_prod.empty? && !old_prod.empty?
+
+      false
+    end
+
     # Apply distribution fields from API response.
     # Updates product_name, package_name, logo_url, support_contact, support_qr_url,
     # theme_color, and homepage_url from the distribution hash.

data/lib/clacky/cli.rb

@@ -365,19 +365,12 @@ module Clacky
           return
         end
 
+        # Heartbeat is fire-and-forget — startup must never block on the
+        # license server. The grace_period_exceeded? check below now keys off
+        # license_last_heartbeat_failure (set on a failed heartbeat, cleared
+        # on success), so a user who simply hasn't run the app for >3 days
+        # no longer sees a false "offline" warning on first launch.
         if brand.heartbeat_due?
-          # Fire-and-forget heartbeat in a background thread.
-          #
-          # Rationale: a slow/unreachable license server would otherwise block
-          # CLI startup for up to ~92s (2 hosts × 2 attempts × 23s timeout)
-          # before the user sees the prompt. Heartbeat is "best-effort" by
-          # design — its only job is to refresh `last_heartbeat` / `expires_at`
-          # on disk for the next run's grace-period calculation. Missing a
-          # single heartbeat is harmless; the next launch will try again.
-          #
-          # Consequence: if this run was going to trigger the
-          # grace_period_exceeded warning, the user will see it on the *next*
-          # launch instead of this one. Acceptable trade-off.
           Clacky::Logger.info("[Brand] check_brand_license_cli: heartbeat due, dispatching async...")
           Thread.new do
             begin
@@ -395,10 +388,6 @@ module Clacky
           Clacky::Logger.debug("[Brand] check_brand_license_cli: heartbeat not due yet")
         end
 
-        # Surface the grace-period warning based on *already-persisted* state
-        # (computed from last_heartbeat on disk). This works whether the
-        # previous run's heartbeat succeeded, failed, or was interrupted —
-        # grace_period_exceeded? reads last_heartbeat, not this run's result.
         if brand.grace_period_exceeded?
           say ""
           say "WARNING: Could not reach the #{brand.product_name} license server.", :yellow
@@ -750,6 +739,9 @@ module Clacky
         # Inject UI into agent
         agent.instance_variable_set(:@ui, ui_controller)
 
+        # Inject current session id into UI session bar (parity with WebUI #sib-id)
+        ui_controller.update_sessionbar(session_id: agent.session_id)
+
         # Set skill loader for command suggestions, filtered by agent profile whitelist
         ui_controller.set_skill_loader(agent.skill_loader, agent.agent_profile)
 
@@ -859,7 +851,7 @@ module Clacky
             end
             ui_controller.show_info("Session cleared. Starting fresh.")
             # Update session bar with reset values
-            ui_controller.update_sessionbar(tasks: agent.total_tasks, cost: agent.total_cost)
+            ui_controller.update_sessionbar(tasks: agent.total_tasks, cost: agent.total_cost, session_id: agent.session_id)
             # Clear todo area display
             ui_controller.update_todos([])
             next

data/lib/clacky/server/channel/adapters/weixin/adapter.rb

@@ -8,6 +8,163 @@ module Clacky
   module Channel
     module Adapters
       module Weixin
+        # Per-user send queue with buffering, throttling, and retry for Weixin iLink.
+        #
+        # Design:
+        #   - Each chat_id has a pending buffer of text fragments.
+        #   - A background flusher thread periodically checks all buffers.
+        #   - Flush triggers: char threshold reached, time interval elapsed, or explicit flush.
+        #   - Actual send calls are spaced by MIN_SEND_INTERVAL to avoid rate-limiting.
+        #   - ret:-2 (rate-limited) triggers exponential backoff retry.
+        class SendQueue
+          FLUSH_CHAR_THRESHOLD = 400
+          FLUSH_INTERVAL       = 0.8
+          MIN_SEND_INTERVAL    = 1.0
+          RETRY_BACKOFFS       = [1.0, 2.0, 4.0]
+
+          Entry = Struct.new(:text, :context_token, :enqueued_at, keyword_init: true)
+
+          def initialize(api_client, logger: Clacky::Logger)
+            @api_client   = api_client
+            @logger       = logger
+            @buffers      = {}
+            @buffer_mutex = Mutex.new
+            @last_sent_at = {}
+            @last_mutex   = Mutex.new
+            @running      = true
+            @flusher      = Thread.new { flush_loop }
+          end
+
+          # Enqueue text for a chat_id. Non-blocking.
+          def enqueue(chat_id, text, context_token)
+            @buffer_mutex.synchronize do
+              @buffers[chat_id] ||= []
+              @buffers[chat_id] << Entry.new(text: text, context_token: context_token, enqueued_at: Time.now)
+            end
+          end
+
+          # Force-flush all pending text for a chat_id. Non-blocking.
+          def flush(chat_id)
+            entries = @buffer_mutex.synchronize { @buffers.delete(chat_id) || [] }
+            send_entries(chat_id, entries) unless entries.empty?
+          end
+
+          # Stop the flusher thread. Waits up to 30s for pending messages to drain.
+          def stop
+            @running = false
+            @flusher.join(30)
+            # Force-flush any remaining entries regardless of threshold.
+            drain_all_buffers
+          end
+
+          private def flush_loop
+            while @running
+              sleep 0.2
+              begin
+                drain_buffers
+              rescue => e
+                @logger.error("[WeixinSendQueue] drain_buffers error: #{e.message}")
+              end
+            end
+          end
+
+          private def drain_buffers
+            now = Time.now
+            ready = {}
+
+            @buffer_mutex.synchronize do
+              @buffers.each do |chat_id, entries|
+                next if entries.empty?
+                total_chars = entries.sum { |e| e.text.chars.length }
+                elapsed = now - entries.first.enqueued_at
+                if total_chars >= FLUSH_CHAR_THRESHOLD || elapsed >= FLUSH_INTERVAL
+                  ready[chat_id] = entries
+                end
+              end
+              ready.each_key { |chat_id| @buffers.delete(chat_id) }
+            end
+
+            ready.each do |chat_id, entries|
+              send_entries(chat_id, entries)
+            end
+          end
+
+          # Unconditionally drain every buffer. Used on stop to guarantee delivery.
+          private def drain_all_buffers
+            ready = @buffer_mutex.synchronize do
+              snapshot = @buffers.reject { |_, entries| entries.empty? }
+              @buffers.clear
+              snapshot
+            end
+
+            ready.each do |chat_id, entries|
+              begin
+                send_entries(chat_id, entries)
+              rescue => e
+                @logger.error("[WeixinSendQueue] final drain error for #{chat_id}: #{e.message}")
+              end
+            end
+          end
+
+          private def send_entries(chat_id, entries)
+            return if entries.empty?
+
+            combined = entries.map(&:text).join("\n")
+            ctoken   = entries.last.context_token
+
+            # Split into ≤2000 char chunks
+            chunks = split_message(combined)
+            chunks.each do |chunk|
+              throttle
+              send_with_retry(chat_id, chunk, ctoken)
+            end
+          end
+
+          private def throttle
+            @last_mutex.synchronize do
+              last = @last_sent_at[:global] || Time.at(0)
+              wait = MIN_SEND_INTERVAL - (Time.now - last)
+              sleep(wait) if wait > 0
+              @last_sent_at[:global] = Time.now
+            end
+          end
+
+          private def send_with_retry(chat_id, text, context_token)
+            RETRY_BACKOFFS.each_with_index do |delay, idx|
+              begin
+                @api_client.send_text(to_user_id: chat_id, text: text, context_token: context_token)
+                return
+              rescue ApiClient::ApiError => e
+                if e.code == -2 && idx < RETRY_BACKOFFS.length - 1
+                  @logger.warn("[WeixinSendQueue] ret=-2 for #{chat_id}, retry in #{delay}s (#{idx + 1}/#{RETRY_BACKOFFS.length})")
+                  sleep delay
+                  next
+                end
+                raise
+              end
+            end
+          rescue => e
+            @logger.error("[WeixinSendQueue] send_text failed for #{chat_id}: #{e.message}")
+          end
+
+          # Split text into ≤2000 Unicode character chunks.
+          private def split_message(text, limit: 2000)
+            return [text] if text.chars.length <= limit
+            chunks = []
+            while text.chars.length > limit
+              window = text.chars.first(limit).join
+              cut = window.rindex("\n\n")
+              cut = window.rindex("\n")   if cut.nil?
+              cut = window.rindex(" ")    if cut.nil?
+              cut = limit                 if cut.nil? || cut.zero?
+              chunks << text.chars.first(cut).join.rstrip
+              text = text.chars.drop(cut).join.lstrip
+            end
+            chunks << text unless text.empty?
+            chunks
+          end
+        end
+
         # Weixin (WeChat iLink) adapter.
         #
         # Protocol: HTTP long-poll via ilinkai.weixin.qq.com
@@ -76,6 +233,7 @@ module Clacky
             @context_tokens = {}
             @ctx_mutex      = Mutex.new
             @api_client     = ApiClient.new(base_url: @base_url, token: @token)
+            @send_queue     = SendQueue.new(@api_client)
             # Typing keepalive: user_id → { ticket:, thread:, cached_at: }
             @typing_tickets  = {}
             @typing_mutex    = Mutex.new
@@ -129,10 +287,12 @@ module Clacky
 
           def stop
             @running = false
+            @send_queue.stop
           end
 
           # Send a plain text reply to a user.
           # The context_token from the inbound message is required by the Weixin protocol.
+          # Text is enqueued and sent in batches by the background flusher to avoid rate-limiting.
           def send_text(chat_id, text, reply_to: nil)
             ctoken = lookup_context_token(chat_id)
             unless ctoken
@@ -141,14 +301,15 @@ module Clacky
             end
 
             plain = markdown_to_plain(text)
-            split_message(plain).each do |chunk|
-              @api_client.send_text(to_user_id: chat_id, text: chunk, context_token: ctoken)
-            end
+            return { message_id: nil } if plain.empty?
 
+            @send_queue.enqueue(chat_id, plain, ctoken)
             { message_id: nil }
-          rescue => e
-            Clacky::Logger.error("[WeixinAdapter] send_text failed for #{chat_id} (context_token=#{lookup_context_token(chat_id).to_s.slice(0, 20)}...): #{e.message}")
-            { message_id: nil }
+          end
+
+          # Force-flush pending text for a chat_id. Called before sending files or on task completion.
+          def flush_pending(chat_id)
+            @send_queue.flush(chat_id)
           end
 
           # Send a file to a user.
@@ -161,6 +322,8 @@ module Clacky
               return { message_id: nil }
             end
 
+            @send_queue.flush(chat_id)
+
             @api_client.send_file(
               to_user_id:    chat_id,
               file_path:     file_path,

data/lib/clacky/server/channel/channel_ui_controller.rb

@@ -62,6 +62,7 @@ module Clacky
         # raw markdown links would just be noise in the chat.
         text = content.to_s.gsub(/!?\[[^\]]*\]\(file:\/\/[^)]+\)/, "").strip
         send_text(text) unless text.empty?
+        flush_adapter_pending
         files.each do |f|
           Clacky::Logger.info("[ChannelUI] sending file path=#{f[:path].inspect} name=#{f[:name].inspect}")
           send_file(f[:path], f[:name])
@@ -120,6 +121,7 @@ module Clacky
         end
         parts << "#{duration.round(1)}s" if duration
         send_text(parts.join(" · "))
+        flush_adapter_pending
       end
 
       def append_output(content)
@@ -218,6 +220,10 @@ module Clacky
         send_text(@buffer.join("\n"))
         @buffer.clear
       end
+
+      def flush_adapter_pending
+        @adapter.flush_pending(@chat_id) if @adapter.respond_to?(:flush_pending)
+      end
     end
   end
 end

data/lib/clacky/server/http_server.rb

@@ -3156,6 +3156,7 @@ module Clacky
       # Export a session bundle as a .zip download containing:
       #   - session.json          (always)
       #   - chunk-*.md            (0..N archived conversation chunks)
+      #   - logs/clacky-YYYY-MM-DD.log  (today's logger file, if present)
       # Useful for debugging — user clicks "download" in the WebUI status bar
       # and we can ask them to attach the zip to a bug report.
       def api_export_session(session_id, res)
@@ -3177,6 +3178,12 @@ module Clacky
             zos.put_next_entry(File.basename(chunk_path))
             zos.write(File.binread(chunk_path))
           end
+
+          log_path = Clacky::Logger.current_log_file
+          if log_path && File.exist?(log_path)
+            zos.put_next_entry("logs/#{File.basename(log_path)}")
+            zos.write(File.binread(log_path))
+          end
         end
         buffer.rewind
         data = buffer.read

data/lib/clacky/tools/terminal.rb

@@ -494,6 +494,12 @@ module Clacky
           else
             cleanup_session(session)
           end
+          if xcode_tools_missing?(cleaned)
+            cleaned = "Xcode Command Line Tools are not installed.\n" \
+                      "Run: bash ~/.clacky/scripts/install_system_deps.sh\n" \
+                      "Then retry the original command."
+            exit_code = 1
+          end
           {
             output: cleaned,
             exit_code: exit_code,
@@ -521,6 +527,11 @@ module Clacky
         end
       end
 
+      private def xcode_tools_missing?(output)
+        return false if output.nil? || output.empty?
+        output.include?("xcode-select") && output.include?("No developer tools were found")
+      end
+
       private def session_healthy?(session)
         return false unless session
         return false if %w[exited killed].include?(session.status.to_s)

data/lib/clacky/ui2/components/input_area.rb

@@ -57,6 +57,7 @@ module Clacky
 
           # Session bar info
           @sessionbar_info = {
+            session_id: nil,   # Full session id; rendered as first 8 chars (parity with WebUI)
             working_dir: nil,
             mode: nil,
             model: nil,
@@ -138,6 +139,7 @@ module Clacky
         end
 
         # Update session bar info
+        # @param session_id [String] Full session id (rendered as first 8 chars)
         # @param working_dir [String] Working directory
         # @param mode [String] Permission mode
         # @param model [String] AI model name
@@ -145,7 +147,8 @@ module Clacky
         # @param cost [Float] Total cost
         # @param cost_source [Symbol, nil] :api / :price / :default — :default renders as N/A
         # @param status [String] Workspace status ('idle' or 'working')
-        def update_sessionbar(working_dir: nil, mode: nil, model: nil, tasks: nil, cost: nil, cost_source: nil, status: nil)
+        def update_sessionbar(session_id: nil, working_dir: nil, mode: nil, model: nil, tasks: nil, cost: nil, cost_source: nil, status: nil)
+          @sessionbar_info[:session_id] = session_id if session_id
           @sessionbar_info[:working_dir] = working_dir if working_dir
           @sessionbar_info[:mode] = mode if mode
           @sessionbar_info[:model] = model if model
@@ -1136,6 +1139,12 @@ module Clacky
             parts << "#{status_indicator} #{@pastel.public_send(status_color, @sessionbar_info[:status])}"
           end
 
+          # Session id — first 8 chars (parity with WebUI #sib-id)
+          if @sessionbar_info[:session_id]
+            sid_short = @sessionbar_info[:session_id].to_s[0, 8]
+            parts << theme.format_text(sid_short, :statusbar_secondary) unless sid_short.empty?
+          end
+
           # Working directory (shortened if too long)
           if @sessionbar_info[:working_dir]
             dir_display = shorten_path(@sessionbar_info[:working_dir])

data/lib/clacky/ui2/components/todo_area.rb

@@ -14,9 +14,13 @@ module Clacky
 
         def initialize
           @todos = []
+          @pending_todos = []
+          @completed_count = 0
+          @total_count = 0
           @pastel = Pastel.new
           @width = TTY::Screen.width
           @height = 0  # Dynamic height based on todos
+          @hidden = false
         end
 
         # Update todos list
@@ -27,8 +31,24 @@ module Clacky
           @completed_count = @todos.count { |t| t[:status] == "completed" }
           @total_count = @todos.size
 
-          # Calculate height: 0 if no pending, otherwise 1 line per task (up to MAX_DISPLAY_TASKS)
-          if @pending_todos.empty?
+          recalc_height
+        end
+
+        # Hide the area without discarding todos data; show again to restore.
+        def hide
+          return if @hidden
+          @hidden = true
+          @height = 0
+        end
+
+        def show
+          return unless @hidden
+          @hidden = false
+          recalc_height
+        end
+
+        private def recalc_height
+          if @hidden || @pending_todos.empty?
             @height = 0
           else
             @height = [@pending_todos.size, MAX_DISPLAY_TASKS].min

data/lib/clacky/ui2/layout_manager.rb

@@ -126,6 +126,10 @@ module Clacky
 
           old_lines = entry.lines.dup
           new_lines = wrap_content_to_lines(content)
+          if old_lines == new_lines
+            screen.flush
+            return
+          end
           @buffer.replace(id, new_lines)
 
           unless @fullscreen_mode
@@ -288,24 +292,28 @@ module Clacky
           end
         end
 
-        # Clear the rows the entry currently occupies
-        (start_row...@output_row).each do |row|
-          screen.move_cursor(row, 0)
-          screen.clear_line
-        end
-
-        # Paint the new content
+        # Clear only rows whose content actually changed, then repaint
+        # those. Lines that are byte-identical to the previous frame stay
+        # untouched — avoiding the clear-then-redraw flicker that an
+        # always-on ticker produces 2-10x per second on slower terminals.
         cur = start_row
-        new_lines.each do |line|
-          screen.move_cursor(cur, 0)
-          print line
+        new_lines.each_with_index do |line, i|
+          if i >= old_n || old_lines[i] != line
+            screen.move_cursor(cur, 0)
+            screen.clear_line
+            print line
+          end
           cur += 1
         end
+        # If content shrank, blank out the rows the old frame occupied
+        # below the new tail.
+        if new_n < old_n
+          (cur...(start_row + old_n)).each do |row|
+            screen.move_cursor(row, 0)
+            screen.clear_line
+          end
+        end
         @output_row = start_row + new_n
-
-        # If content shrank, extra rows below may still hold the old content
-        # if they were outside the cleared range — but since we cleared the
-        # full old span above, nothing extra is needed here.
       end
 
       # Clear the last N rows of the output area (used by remove_entry on tail).
@@ -502,6 +510,54 @@ module Clacky
         end
       end
 
+      # Hide todo area while preserving its data; pair with show_todos.
+      def hide_todos
+        return unless @todo_area
+
+        @render_mutex.synchronize do
+          old_height  = @todo_area.height
+          old_gap_row = @gap_row
+
+          @todo_area.hide
+          new_height = @todo_area.height
+
+          if old_height != new_height
+            calculate_layout
+            ([old_gap_row, 0].max...screen.height).each do |row|
+              screen.move_cursor(row, 0)
+              screen.clear_line
+            end
+          end
+
+          render_fixed_areas
+          screen.flush
+        end
+      end
+
+      # Show todo area again after a previous hide_todos.
+      def show_todos
+        return unless @todo_area
+
+        @render_mutex.synchronize do
+          old_height  = @todo_area.height
+          old_gap_row = @gap_row
+
+          @todo_area.show
+          new_height = @todo_area.height
+
+          if old_height != new_height
+            calculate_layout
+            ([old_gap_row, 0].max...screen.height).each do |row|
+              screen.move_cursor(row, 0)
+              screen.clear_line
+            end
+          end
+
+          render_fixed_areas
+          screen.flush
+        end
+      end
+
 
 
       # -----------------------------------------------------------------------

data/lib/clacky/ui2/progress_handle.rb

@@ -225,6 +225,15 @@ module Clacky
         render_now
       end
 
+      # Like __reattach_entry! but skips the render_now hop. Used by the
+      # owner when it has just painted a frame into the new entry itself
+      # (e.g. while rotating the handle to remain at the buffer tail) and
+      # is still inside its own synchronization — calling render_now there
+      # would re-enter the owner's mutex.
+      def __rebind_entry!(new_entry_id)
+        @monitor.synchronize { @entry_id = new_entry_id }
+      end
+
       # Test hook: force a synchronous render regardless of tick cadence.
       def __force_render!
         render_now

data/lib/clacky/ui2/ui_controller.rb

@@ -49,6 +49,7 @@ module Clacky
         @time_machine_callback = nil
         @tasks_count = 0
         @total_cost = 0.0
+        @session_id = nil
         @last_diff_lines = nil
 
         # ── Progress subsystem (v2: owned handles, stacked) ──────────────
@@ -73,6 +74,7 @@ module Clacky
 
         # Set session bar data before initializing screen
         @input_area.update_sessionbar(
+          session_id: @session_id,
           working_dir: @config[:working_dir],
           mode: @config[:mode],
           model: @config[:model],
@@ -109,10 +111,13 @@ module Clacky
       # @param cost_source [Symbol, nil] :api / :price / :default (optional)
       # @param status [String] Workspace status ('idle' or 'working') (optional)
       # @param latency [Hash, nil] Latency metrics; accepted but not displayed in the TUI.
-      def update_sessionbar(tasks: nil, cost: nil, cost_source: nil, status: nil, latency: nil)
+      # @param session_id [String, nil] Full session id; rendered as first 8 chars (parity with WebUI).
+      def update_sessionbar(tasks: nil, cost: nil, cost_source: nil, status: nil, latency: nil, session_id: nil)
         @tasks_count = tasks if tasks
         @total_cost = cost if cost
+        @session_id = session_id if session_id
         @input_area.update_sessionbar(
+          session_id: @session_id,
           working_dir: @config[:working_dir],
           mode: @config[:mode],
           model: @config[:model],
@@ -193,9 +198,35 @@ module Clacky
         @input_area.set_agent(agent, agent_profile)
       end
 
-      # Append output to the output area
-      # @param content [String] Content to append
+      # Append output to the output area.
+      #
+      # If a progress indicator is currently active (somewhere in the
+      # buffer), rotate it to the tail after the append: business content
+      # ends up above, the spinner stays at the bottom. Without this,
+      # every subsequent ticker tick on a non-tail progress entry would
+      # trigger a full output repaint (visible flicker) and the visual
+      # order would have business messages appearing below the spinner.
       def append_output(content)
+        @progress_mutex.synchronize do
+          top = @progress_stack.last
+          if top && top.entry_id
+            @layout.remove_entry(top.entry_id)
+            top.__detach_entry!
+            new_id = @layout.append_output(content)
+            progress_id = @layout.append_output(render_for(top))
+            top.__rebind_entry!(progress_id)
+            new_id
+          else
+            @layout.append_output(content)
+          end
+        end
+      end
+
+      # Internal append that bypasses the progress-rotation logic and the
+      # @progress_mutex. Used by register_progress / unregister_progress,
+      # which already hold the mutex and are themselves placing a fresh
+      # progress entry at the tail.
+      private def append_output_unlocked(content)
         @layout.append_output(content)
       end
 
@@ -481,6 +512,8 @@ module Clacky
 
         # Clear user tip when agent stops working
         @input_area.clear_user_tip
+        # Hide todo area while idle (data preserved, restored on next work)
+        @layout.hide_todos
         @layout.render_input
 
         # Don't show completion message if awaiting user feedback
@@ -597,7 +630,7 @@ module Clacky
           end
 
           @progress_stack.push(handle)
-          entry_id = append_output(render_for(handle))
+          entry_id = append_output_unlocked(render_for(handle))
           recompute_sessionbar_status
           entry_id
         end
@@ -623,7 +656,7 @@ module Clacky
           # Restore the new top, if any: allocate a fresh entry and let it
           # resume rendering from where it left off.
           if (restored = @progress_stack.last)
-            new_id = append_output(render_for(restored))
+            new_id = append_output_unlocked(render_for(restored))
             restored.__reattach_entry!(new_id)
           end
 
@@ -826,6 +859,8 @@ module Clacky
         @last_sessionbar_status = 'idle'
         # Clear user tip when agent stops working
         @input_area.clear_user_tip
+        # Hide todo area while idle (data preserved, restored on next work)
+        @layout.hide_todos
         @layout.render_input
       end
 
@@ -848,6 +883,8 @@ module Clacky
       # Set workspace status to working (called when agent starts working)
       def set_working_status
         update_sessionbar(status: 'working')
+        # Restore todo area if it was hidden during idle
+        @layout.show_todos
         # Show a random user tip with 40% probability when agent starts working
         @input_area.show_user_tip(probability: 0.4)
         @layout.render_input
@@ -1281,6 +1318,7 @@ module Clacky
 
           # Update session bar data (will be rendered by request_confirmation's render_all)
           @input_area.update_sessionbar(
+            session_id: @session_id,
             working_dir: @config[:working_dir],
             mode: @config[:mode],
             model: @config[:model],

data/lib/clacky/utils/logger.rb

@@ -35,6 +35,13 @@ module Clacky
         @console ||= false
       end
 
+      # Path of the log file currently being written to (today's file).
+      # File may not exist yet if no log has been emitted today — callers
+      # should check File.exist? before reading.
+      def current_log_file
+        log_file_path(Time.now)
+      end
+
       # Log at DEBUG level.
       def debug(message, **context)
         write_log(:debug, message, context)

data/lib/clacky/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Clacky
-  VERSION = "1.1.0"
+  VERSION = "1.1.1"
 end

data/lib/clacky/web/i18n.js

@@ -66,11 +66,15 @@ const I18n = (() => {
       "sessions.deleteTitle":   "Delete session",
       "sessions.createError":   "Error: ",
       "sessions.dirNotEmpty":   "Directory already exists and is not empty.",
-      "sessions.export.tooltip": "Download session files (session.json + chunks) for debugging",
+      "sessions.export.tooltip": "Download session files (session.json + chunks + today's log) for debugging",
       "sessions.export.failed":  "Failed to download session",
       "sessions.actions.tooltip":      "Click for session actions",
       "sessions.actions.download":     "Download session files",
       "sessions.actions.downloadHint": "for debugging",
+      "sib.dir.tooltip":         "Click to change directory",
+      "sib.dir.changePrompt":    "Change working directory:",
+      "sib.model.tooltip":       "Click to switch model",
+      "sib.signal.tooltip":      "Recent LLM latency",
       "sessions.thinking":      "Thinking…",
       "sessions.default_name":  "Session {{n}}",
       "sessions.badge.cron":    "Auto",
@@ -449,8 +453,8 @@ const I18n = (() => {
       "settings.brand.label.qrHint":       "Scan with your phone camera",
       "settings.brand.btn.change":         "Change Serial Number",
       "settings.brand.btn.unbind":         "Unbind License",
-      "settings.brand.confirmRebind":      "Warning: all previously installed brand skills will be deleted and cannot be used. Continue?",
-      "settings.brand.confirmUnbind":      "Are you sure you want to unbind this license? All brand skills will be deleted and this device will no longer have access to branded features.",
+      "settings.brand.confirmRebind":      "Enter a new serial number to rebind. If it belongs to the same brand, your installed brand skills are preserved; switching to a different brand will remove them. Continue?",
+      "settings.brand.confirmUnbind":      "Unbind this license? All installed brand skills will be removed, and this device will no longer have access to branded features.",
       "settings.brand.unbindSuccess":      "License unbound successfully.",
       "settings.brand.unbindFailed":       "Failed to unbind license. Please try again.",
       "settings.brand.badge.active":       "Active",
@@ -585,11 +589,15 @@ const I18n = (() => {
       "sessions.deleteTitle":   "删除对话",
       "sessions.createError":   "错误：",
       "sessions.dirNotEmpty":   "该目录已存在且不为空，请换一个目录名。",
-      "sessions.export.tooltip": "下载会话文件（session.json + 归档片段），用于调试",
+      "sessions.export.tooltip": "下载会话文件（session.json + 归档片段 + 当天日志），用于调试",
       "sessions.export.failed":  "下载会话文件失败",
       "sessions.actions.tooltip":      "点击查看会话操作",
       "sessions.actions.download":     "下载会话文件",
       "sessions.actions.downloadHint": "用于调试",
+      "sib.dir.tooltip":         "点击切换工作目录",
+      "sib.dir.changePrompt":    "切换工作目录：",
+      "sib.model.tooltip":       "点击切换模型",
+      "sib.signal.tooltip":      "最近一次 LLM 响应延迟",
       "sessions.thinking":      "思考中…",
       "sessions.default_name":  "对话 {{n}}",
       "sessions.badge.cron":    "定时",
@@ -612,6 +620,7 @@ const I18n = (() => {
       "sessions.search.typeCoding":  "Coding",
       "sessions.search.typeSetup":   "配置",
       "sessions.search.datePlaceholder": "日期",
+      "modal.yes": "确定",
       "modal.no":  "取消",
       "modal.ok": "确定",
       "modal.cancel": "取消",
@@ -964,8 +973,8 @@ const I18n = (() => {
       "settings.brand.label.qrHint":       "使用手机扫描二维码",
       "settings.brand.btn.change":         "更换序列号",
       "settings.brand.btn.unbind":         "解绑授权",
-      "settings.brand.confirmRebind":      "警告：所有已安装的历史品牌技能将被删除，无法继续使用。确认继续？",
-      "settings.brand.confirmUnbind":      "确定要解绑此授权吗？所有品牌技能将被删除，本设备将无法再访问品牌功能。",
+      "settings.brand.confirmRebind":      "请输入新序列号以重新绑定。若属于同一品牌，已安装的品牌技能将保留；切换为其他品牌时才会清理。是否继续？",
+      "settings.brand.confirmUnbind":      "确定要解绑此授权吗？所有已安装的品牌技能将被删除，本设备将无法再访问品牌功能。",
       "settings.brand.unbindSuccess":      "授权解绑成功。",
       "settings.brand.unbindFailed":       "解绑授权失败，请重试。",
       "settings.brand.badge.active":       "已激活",

data/lib/clacky/web/index.html

@@ -300,10 +300,10 @@
           <div id="sib-actions-dropdown" class="sib-actions-dropdown" style="display:none" role="menu"></div>
         </span>
         <span class="sib-sep sib-sep-after-id">│</span>
-        <span id="sib-dir" title="Click to change directory"></span>
+        <span id="sib-dir" data-i18n-title="sib.dir.tooltip" title="Click to change directory"></span>
         <span class="sib-sep sib-sep-after-dir">│</span>
         <span id="sib-model-wrap">
-          <span id="sib-model" class="sib-model-clickable" title="Click to switch model"></span>
+          <span id="sib-model" class="sib-model-clickable" data-i18n-title="sib.model.tooltip" title="Click to switch model"></span>
           <div id="sib-model-dropdown" class="sib-model-dropdown" style="display:none"></div>
         </span>
         <span class="sib-sep sib-sep-after-model">│</span>
@@ -311,7 +311,7 @@
              call completes (see updateInfoBar / Sessions.renderSignalBars). Click
              opens a mini benchmark panel (see Step 3/4 — not yet implemented). -->
         <span id="sib-signal-wrap" style="display:none">
-          <span id="sib-signal" class="sib-signal-clickable" title="Recent LLM latency">
+          <span id="sib-signal" class="sib-signal-clickable" data-i18n-title="sib.signal.tooltip" title="Recent LLM latency">
             <span class="sig-bars" aria-hidden="true"><i></i><i></i><i></i><i></i></span>
             <span class="sig-text"></span>
           </span>
@@ -945,8 +945,8 @@
       </div>
     </div>
     <div class="modal-footer">
-      <button id="new-session-create" class="btn-primary" data-i18n="sessions.modal.create">Create Session</button>
       <button id="new-session-cancel" class="btn-secondary" data-i18n="modal.cancel">Cancel</button>
+      <button id="new-session-create" class="btn-primary" data-i18n="sessions.modal.create">Create Session</button>
     </div>
   </div>
 </div>
@@ -968,8 +968,8 @@
     <div id="prompt-modal-message" style="font-size:14px;line-height:1.6;margin-bottom:12px"></div>
     <input type="text" id="prompt-modal-input" class="prompt-modal-input" autocomplete="off" spellcheck="false">
     <div class="modal-actions">
-      <button id="prompt-modal-ok" class="btn-primary" data-i18n="modal.ok">OK</button>
       <button id="prompt-modal-cancel" class="btn-secondary" data-i18n="modal.cancel">Cancel</button>
+      <button id="prompt-modal-ok" class="btn-primary" data-i18n="modal.ok">OK</button>
     </div>
   </div>
 </div>

data/lib/clacky/web/sessions.js

@@ -2065,6 +2065,7 @@ const Sessions = (() => {
 
     /** Update the session info bar below the chat header with current session metadata. */
     updateInfoBar(s) {
+      this._lastSession = s;
       if (!s) {
         // Hide all spans when no session
         ["sib-id", "sib-status", "sib-dir", "sib-mode", "sib-model", "sib-tasks", "sib-cost"].forEach(id => {
@@ -2103,8 +2104,8 @@ const Sessions = (() => {
       const sibDir = $("sib-dir");
       if (sibDir && s.working_dir) {
         sibDir.textContent = s.working_dir;
-        sibDir.title = s.working_dir + " (click to change)";
-        // Store session ID for later use
+        sibDir.title = `${s.working_dir} (${I18n.t("sib.dir.tooltip")})`;
+        sibDir.dataset.workingDir = s.working_dir;
         sibDir.dataset.sessionId = s.id;
       }
 
@@ -2138,7 +2139,7 @@ const Sessions = (() => {
 
       // Tasks
       const sibTasks = $("sib-tasks");
-      if (sibTasks) sibTasks.textContent = `${s.total_tasks || 0} tasks`;
+      if (sibTasks) sibTasks.textContent = I18n.t("sessions.metaTasks", { n: s.total_tasks || 0 });
 
       // Cost — show N/A when pricing is unknown (estimated)
       const sibCost = $("sib-cost");
@@ -3208,9 +3209,9 @@ const Sessions = (() => {
     if (dirEl) {
       e.stopPropagation();
       const sessionId = dirEl.dataset.sessionId;
-      const currentDir = dirEl.title.replace(" (click to change)", "");
-      
-      const newDir = await Modal.prompt("Change working directory:", currentDir);
+      const currentDir = dirEl.dataset.workingDir || dirEl.textContent;
+
+      const newDir = await Modal.prompt(I18n.t("sib.dir.changePrompt"), currentDir);
       if (newDir && newDir !== currentDir) {
         _changeWorkingDirectory(sessionId, newDir);
       }
@@ -3280,7 +3281,10 @@ const Sessions = (() => {
   }
 
   function _populateSessionActionsDropdown(dd, sessionId) {
-    const t = (key, fallback) => (window.I18n && I18n.t(key)) || fallback;
+    const t = (key, fallback) => {
+      const s = I18n.t(key);
+      return (s && s !== key) ? s : fallback;
+    };
     dd.innerHTML = "";
 
     // Download item
@@ -3320,7 +3324,7 @@ const Sessions = (() => {
       if (!res.ok) {
         let msg = `HTTP ${res.status}`;
         try { const data = await res.json(); if (data.error) msg = data.error; } catch (_) {}
-        alert((window.I18n && I18n.t("sessions.export.failed")) || "Failed to download session: " + msg);
+        alert(I18n.t("sessions.export.failed") + ": " + msg);
         return;
       }
       const blob = await res.blob();
@@ -3342,7 +3346,7 @@ const Sessions = (() => {
       setTimeout(() => URL.revokeObjectURL(url), 1000);
     } catch (err) {
       console.error("Session export failed:", err);
-      alert(((window.I18n && I18n.t("sessions.export.failed")) || "Failed to download session") + ": " + err.message);
+      alert(I18n.t("sessions.export.failed") + ": " + err.message);
     } finally {
       if (btnEl) {
         try { btnEl.disabled = wasDisabled; } catch (_) {}
@@ -3370,7 +3374,8 @@ const Sessions = (() => {
       const sibDir = $("sib-dir");
       if (sibDir) {
         sibDir.textContent = newDir;
-        sibDir.title = newDir + " (click to change)";
+        sibDir.title = `${newDir} (${I18n.t("sib.dir.tooltip")})`;
+        sibDir.dataset.workingDir = newDir;
       }
       
       console.log(`Changed session ${sessionId} directory to ${newDir}`);
@@ -3381,3 +3386,7 @@ const Sessions = (() => {
   }
 
 })();
+
+document.addEventListener("langchange", () => {
+  if (Sessions._lastSession) Sessions.updateInfoBar(Sessions._lastSession);
+});

data/scripts/build/src/install.sh.cc

@@ -49,6 +49,7 @@ install_via_gem() {
     configure_gem_source
     setup_gem_home
 
+    local target source_args=()
     if [ "$USE_CN_MIRRORS" = true ]; then
         print_info "Fetching latest version from OSS..."
         local cn_version; cn_version=$(curl -fsSL "$CN_GEM_LATEST_URL" | tr -d '[:space:]')
@@ -57,17 +58,26 @@ install_via_gem() {
         local gem_file="/tmp/openclacky-${cn_version}.gem"
         print_info "Downloading openclacky-${cn_version}.gem..."
         curl -fsSL "$gem_url" -o "$gem_file"
-        gem install "$gem_file" --no-document --source "$CN_RUBYGEMS_URL"
+        target="$gem_file"
+        source_args=(--source "$CN_RUBYGEMS_URL")
     else
-        gem install openclacky --no-document
+        target="openclacky"
     fi
 
-    if [ $? -eq 0 ]; then
+    # macOS system Ruby 2.6 has a buggy gem resolver that fails on rouge 4.x.
+    # Pre-install a 2.6-compatible rouge to avoid resolver failure.
+    local ruby_ver; ruby_ver=$(ruby -e 'puts RUBY_VERSION' 2>/dev/null)
+    if [[ "$ruby_ver" == 2.6.* ]]; then
+        print_warning "Ruby 2.6 detected — pinning rouge 3.30.0 first"
+        gem install rouge -v 3.30.0 --no-document "${source_args[@]}" || { print_error "gem install rouge failed"; return 1; }
+    fi
+
+    if gem install "$target" --no-document "${source_args[@]}"; then
         print_success "${DISPLAY_NAME} installed successfully!"
         return 0
-    else
-        print_error "gem install failed"; return 1
     fi
+
+    print_error "gem install failed"; return 1
 }
 
 # --------------------------------------------------------------------------

data/scripts/install.sh

@@ -421,6 +421,7 @@ install_via_gem() {
     configure_gem_source
     setup_gem_home
 
+    local target source_args=()
     if [ "$USE_CN_MIRRORS" = true ]; then
         print_info "Fetching latest version from OSS..."
         local cn_version; cn_version=$(curl -fsSL "$CN_GEM_LATEST_URL" | tr -d '[:space:]')
@@ -429,17 +430,26 @@ install_via_gem() {
         local gem_file="/tmp/openclacky-${cn_version}.gem"
         print_info "Downloading openclacky-${cn_version}.gem..."
         curl -fsSL "$gem_url" -o "$gem_file"
-        gem install "$gem_file" --no-document --source "$CN_RUBYGEMS_URL"
+        target="$gem_file"
+        source_args=(--source "$CN_RUBYGEMS_URL")
     else
-        gem install openclacky --no-document
+        target="openclacky"
     fi
 
-    if [ $? -eq 0 ]; then
+    # macOS system Ruby 2.6 has a buggy gem resolver that fails on rouge 4.x.
+    # Pre-install a 2.6-compatible rouge to avoid resolver failure.
+    local ruby_ver; ruby_ver=$(ruby -e 'puts RUBY_VERSION' 2>/dev/null)
+    if [[ "$ruby_ver" == 2.6.* ]]; then
+        print_warning "Ruby 2.6 detected — pinning rouge 3.30.0 first"
+        gem install rouge -v 3.30.0 --no-document "${source_args[@]}" || { print_error "gem install rouge failed"; return 1; }
+    fi
+
+    if gem install "$target" --no-document "${source_args[@]}"; then
         print_success "${DISPLAY_NAME} installed successfully!"
         return 0
-    else
-        print_error "gem install failed"; return 1
     fi
+
+    print_error "gem install failed"; return 1
 }
 
 # --------------------------------------------------------------------------

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openclacky
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - windy
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-15 00:00:00.000000000 Z
+date: 2026-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday