kward 0.79.0 → 0.80.1

data/lib/kward/prompt_interface/interactive/renderer.rb

@@ -55,6 +55,9 @@ module Kward
         controller = @interactive_state[:controller]
         return false if controller.exited?
 
+        return true if controller.dirty?
+        return false unless controller.tickable?
+
         now = monotonic_now
         interval = 1.0 / controller.fps
         elapsed = now - @last_interactive_tick
@@ -64,7 +67,7 @@ module Kward
         @last_interactive_tick += steps * interval
         result = controller.invoke_tick
         controller.exit if result == :exit
-        true
+        controller.dirty?
       end
     end
   end

data/lib/kward/prompt_interface/interactive/state.rb

@@ -7,8 +7,8 @@ module Kward
     module InteractiveState
       private
 
-      def interactive_canvas_width
-        [screen_width - 6, 1].max
+      def interactive_canvas_width(width = screen_width)
+        [width - 6, 1].max
       end
 
       def route_interactive_key(key)

data/lib/kward/prompt_interface/project_browser.rb

@@ -125,6 +125,14 @@ module Kward
             insert_selected_project_browser_mention
           elsif text == "/" && !project_browser_search_active?
             activate_project_browser_search
+          elsif text == "j" && !project_browser_search_active?
+            select_next_project_browser_row
+          elsif text == "k" && !project_browser_search_active?
+            select_previous_project_browser_row
+          elsif text == "h" && !project_browser_search_active?
+            collapse_selected_project_browser_row
+          elsif text == "l" && !project_browser_search_active?
+            expand_selected_project_browser_row
           elsif project_browser_search_active?
             project_browser_append_search(text)
           else
@@ -148,6 +156,14 @@ module Kward
           toggle_project_browser_search
         when "/"
           activate_project_browser_search
+        when "j"
+          project_browser_search_active? ? project_browser_append_search(key) : select_next_project_browser_row
+        when "k"
+          project_browser_search_active? ? project_browser_append_search(key) : select_previous_project_browser_row
+        when "h"
+          project_browser_search_active? ? project_browser_append_search(key) : collapse_selected_project_browser_row
+        when "l"
+          project_browser_search_active? ? project_browser_append_search(key) : expand_selected_project_browser_row
         else
           project_browser_append_search(key) if project_browser_search_active? && printable_key?(key)
         end
@@ -319,7 +335,7 @@ module Kward
         if rows.empty?
           lines << overlay_text_line(project_browser_empty_message, :muted)
         else
-          visible = visible_project_browser_rows(rows, height: height)
+          visible = visible_project_browser_rows(rows, height: height, width: width)
           visible[:rows].each_with_index do |row, offset|
             index = visible[:start] + offset
             lines << overlay_choice_line(project_browser_row_text(row), selected: index == @project_browser_state[:selection_index])
@@ -476,7 +492,7 @@ module Kward
       end
 
       def project_browser_workspace_root
-        ConfigFiles.canonical_workspace_root(Dir.pwd)
+        ConfigFiles.canonical_workspace_root(prompt_workspace_root)
       end
 
       def restored_project_browser_expanded_paths(paths, saved_state)
@@ -536,14 +552,17 @@ module Kward
         @project_browser_state[:selection_index] = [[@project_browser_state[:selection_index], 0].max, rows.length - 1].min unless rows.empty?
       end
 
-      def visible_project_browser_rows(rows, height: screen_height)
-        max_rows = max_project_browser_rows(height)
+      def visible_project_browser_rows(rows, height: screen_height, width: screen_width)
+        max_rows = max_project_browser_rows(height, width: width)
         start = centered_list_window_start(@project_browser_state[:selection_index], rows.length, max_rows)
         { start: start, rows: rows[start, max_rows] || [] }
       end
 
-      def max_project_browser_rows(height)
-        [[height - 8, 4].max, 20].min
+      def max_project_browser_rows(height, width: screen_width)
+        composer_bottom_rows = @tabs.empty? ? 1 : tab_border_rows(width).length
+        footer_rows = footer_text.empty? ? 0 : 1
+        attachment_rows = attachment_badge_texts.length
+        [height - 7 - composer_bottom_rows - footer_rows - attachment_rows, 4].max
       end
 
       def default_project_browser_expanded_paths(paths)

data/lib/kward/prompt_interface/runtime_state.rb

@@ -40,14 +40,30 @@ module Kward
 
       def tick_footer_locked
         return false unless @footer && @started && @asking
+        return false unless footer_refresh_due?
 
-        now = monotonic_now
-        elapsed = now - @last_footer_refresh
-        return false if elapsed < FOOTER_REFRESH_INTERVAL
+        previous_text = @cached_footer_text
+        refresh_footer_text_locked
+        previous_text != @cached_footer_text
+      end
 
-        steps = (elapsed / FOOTER_REFRESH_INTERVAL).floor
-        @last_footer_refresh += steps * FOOTER_REFRESH_INTERVAL
-        true
+      def cached_footer_text
+        return "" unless @footer
+
+        refresh_footer_text_locked if footer_refresh_due?
+        @cached_footer_text.to_s
+      end
+
+      def footer_refresh_due?
+        @last_footer_refresh.nil? || monotonic_now - @last_footer_refresh >= FOOTER_REFRESH_INTERVAL
+      end
+
+      def refresh_footer_text_locked
+        @cached_footer_text = @footer.call.to_s.gsub(/\s+/, " ").strip
+      rescue StandardError
+        @cached_footer_text = ""
+      ensure
+        @last_footer_refresh = monotonic_now
       end
 
       def cached_composer_status_text

data/lib/kward/prompt_interface/screen.rb

@@ -114,6 +114,9 @@ module Kward
         @reserved_rows = 0
         @last_width = current_width
         @last_height = current_height
+        if interactive_active_locked?
+          @interactive_state[:controller].resize(width: interactive_canvas_width(current_width))
+        end
         redraw_screen_locked(width: current_width, height: current_height)
         true
       end

data/lib/kward/prompt_interface/selection_prompt.rb

@@ -626,7 +626,13 @@ module Kward
 
       def selection_matches
         choices = @select_state ? @select_state[:choices] : []
-        filter = (select_search_active? || !composer_input.strip.empty?) ? composer_input.downcase.strip : ""
+        filter = if select_input_active?
+                   ""
+                 elsif select_search_active? || !composer_input.strip.empty?
+                   composer_input.downcase.strip
+                 else
+                   ""
+                 end
         matches = filter.empty? ? choices : choices.select { |choice| choice.downcase.include?(filter) }
         clamp_selection_index(matches.length)
         matches

data/lib/kward/prompt_interface/transcript_buffer.rb

@@ -4,10 +4,14 @@ module Kward
   class PromptInterface
     # Bounded in-memory transcript buffer used by the prompt interface.
     class TranscriptBuffer
+      TRIM_RATIO = 0.9
+      TRIM_BOUNDARY_SEARCH = 1_024
+
       attr_reader :text
 
       def initialize(limit:)
-        @limit = limit
+        @limit = [limit.to_i, 1].max
+        @trim_target = [(@limit * TRIM_RATIO).floor, 1].max
         @text = +""
         @display_rows_cache_width = nil
         @display_rows_cache = nil
@@ -42,7 +46,7 @@ module Kward
 
       def append(text)
         @text << ANSI.sanitize_transcript(text)
-        @text = @text[-@limit, @limit] if @text.length > @limit
+        trim_to_limit if @text.length > @limit
         invalidate_display_rows_cache
         @text
       end
@@ -77,6 +81,24 @@ module Kward
         @display_rows_cache_width = nil
         @display_rows_cache = nil
       end
+
+      private
+
+      def trim_to_limit
+        cutoff = @text.length - @trim_target
+        newline = @text.index("\n", cutoff)
+        cutoff = newline + 1 if newline && newline - cutoff <= TRIM_BOUNDARY_SEARCH
+        cutoff = safe_escape_boundary(cutoff)
+        @text = @text[cutoff..].to_s
+      end
+
+      def safe_escape_boundary(cutoff)
+        escape_start = @text.rindex("\e", cutoff)
+        return cutoff unless escape_start
+
+        escape = ANSI.escape_sequence_at(@text, escape_start)
+        escape && escape_start + escape.length > cutoff ? escape_start + escape.length : cutoff
+      end
     end
   end
 end

data/lib/kward/prompt_interface.rb

@@ -128,12 +128,13 @@ module Kward
       end
     end
 
-    def initialize(input: $stdin, output: $stdout, slash_commands: [], overlay_settings: nil, project_browser_icon_theme: "off", footer: nil, composer_status: nil, busy_help: true, attachment_badges: nil, attachment_parser: nil, banner_message: nil, tab_keybindings: nil, prompt_history: nil, editor_mode: nil, editor_mode_source: nil, editor_auto_indent: true, editor_auto_indent_source: nil, editor_auto_close_pairs: true, editor_auto_close_pairs_source: nil, editor_soft_wrap: true, editor_soft_wrap_source: nil, editor_bar_cursor: true, editor_bar_cursor_source: nil, editor_line_numbers: "absolute", editor_line_numbers_source: nil, diff_view: "auto", diff_view_source: nil)
+    def initialize(input: $stdin, output: $stdout, slash_commands: [], overlay_settings: nil, project_browser_icon_theme: "off", footer: nil, composer_status: nil, busy_help: true, attachment_badges: nil, attachment_parser: nil, banner_message: nil, tab_keybindings: nil, prompt_history: nil, workspace_root: Dir.pwd, editor_mode: nil, editor_mode_source: nil, editor_auto_indent: true, editor_auto_indent_source: nil, editor_auto_close_pairs: true, editor_auto_close_pairs_source: nil, editor_soft_wrap: true, editor_soft_wrap_source: nil, editor_bar_cursor: true, editor_bar_cursor_source: nil, editor_line_numbers: "absolute", editor_line_numbers_source: nil, diff_view: "auto", diff_view_source: nil)
       @input_io = input
       @output_io = output
       @reader = TTY::Reader.new(input: input, output: output, interrupt: :error)
       @mutex = Mutex.new
       @prompt_history = prompt_history
+      @workspace_root = File.expand_path(workspace_root.to_s.empty? ? Dir.pwd : workspace_root)
       @composer = ComposerState.new
       load_history(@prompt_history.values) if @prompt_history
       self.composer_input = @composer.input
@@ -146,7 +147,8 @@ module Kward
       @steered_count = 0
       @spinner_frame_index = 0
       @last_spinner_tick = monotonic_now
-      @last_footer_refresh = monotonic_now
+      @last_footer_refresh = nil
+      @cached_footer_text = nil
       @last_composer_status_refresh = 0.0
       @cached_composer_status_text = nil
       @prompt_label = "You>"
@@ -340,10 +342,23 @@ module Kward
       @mutex.synchronize { editor_active? }
     end
 
-    def edit_file(path, base_dir: Dir.pwd, allow_new: true)
+    def update_workspace_root(root, prompt_history: nil)
+      @mutex.synchronize do
+        expanded_root = File.expand_path(root.to_s.empty? ? Dir.pwd : root)
+        return false if expanded_root == @workspace_root
+
+        @workspace_root = expanded_root
+        @prompt_history = prompt_history if prompt_history
+        load_history(@prompt_history.values) if @prompt_history
+        reset_workspace_file_state_locked
+        true
+      end
+    end
+
+    def edit_file(path, base_dir: nil, allow_new: true)
       start(render: false)
       opened = @mutex.synchronize do
-        open_editor(path, allow_new: allow_new, base_dir: base_dir, restrict_to_workspace: false).tap do
+        open_editor(path, allow_new: allow_new, base_dir: base_dir || prompt_workspace_root, restrict_to_workspace: false).tap do
           render_prompt_locked
         end
       end
@@ -610,9 +625,14 @@ module Kward
 
     def update_tabs(labels:, active_index: 0)
       @mutex.synchronize do
-        @tabs = Array(labels).map { |label| normalize_tab_label(label) }
-        @active_tab_index = active_index.to_i
+        normalized_labels = Array(labels).map { |label| normalize_tab_label(label) }
+        normalized_index = active_index.to_i
+        return false if @tabs == normalized_labels && @active_tab_index == normalized_index
+
+        @tabs = normalized_labels
+        @active_tab_index = normalized_index
         render_prompt_locked if @started && @asking
+        true
       end
     end
 
@@ -625,16 +645,19 @@ module Kward
       end
     end
 
-    def tab_view_snapshot
+    def tab_view_snapshot(include_transcript: true)
       @mutex.synchronize do
-        {
+        snapshot = {
           composer: @composer.dup,
           prompt_label: @prompt_label.dup,
-          editor_state: @editor_state&.dup,
-          transcript_buffer: @transcript_buffer.dup,
-          transcript_viewport_rows: @transcript_viewport_rows,
-          stream_state: @stream_state.dup
+          editor_state: @editor_state&.dup
         }
+        if include_transcript
+          snapshot[:transcript_buffer] = @transcript_buffer.dup
+          snapshot[:transcript_viewport_rows] = @transcript_viewport_rows
+          snapshot[:stream_state] = @stream_state.dup
+        end
+        snapshot
       end
     end
 
@@ -859,6 +882,8 @@ module Kward
 
     def refresh_composer_status
       @mutex.synchronize do
+        @cached_footer_text = nil
+        @last_footer_refresh = nil
         @cached_composer_status_text = nil
         @last_composer_status_refresh = 0.0
         render_prompt_locked if @started && @asking
@@ -879,6 +904,22 @@ module Kward
 
     private
 
+    def prompt_workspace_root
+      @workspace_root
+    end
+
+    def reset_workspace_file_state_locked
+      @file_mention_paths = nil
+      @file_mention_path_entries_paths = nil
+      @file_mention_path_entries = nil
+      @project_browser_state = nil
+      @project_browser_tree_paths = nil
+      @project_browser_tree = nil
+      @file_overlay_dismissed_token = nil
+      @file_open_dismissed_token = nil
+      @file_editor_open_status = nil
+    end
+
     def modal_active_locked?
       @question_prompt_active || !@question_state.nil? || !@select_state.nil? || !@git_state.nil?
     end

data/lib/kward/prompts/commands.rb

@@ -30,7 +30,7 @@ module Kward
       { name: "shell", description: "Open the embedded Kward shell.", argument_hint: "" },
       { name: "scratchpad", description: "Open an unsaved editor buffer.", argument_hint: "[text|markdown|ruby]" },
       { name: "pty", description: "Run a command in an interactive PTY passthrough session.", argument_hint: "<command>" },
-      { name: "tab", description: "Manage tabs.", argument_hint: "[1-n|move|close|new|name]" },
+      { name: "tab", description: "Manage tabs.", argument_hint: "[1-n|move|close|new|name|worktree]" },
       { name: "status", description: "Show the current status message.", argument_hint: "" },
       { name: "stats", description: "Show telemetry logging stats.", argument_hint: "[range]" },
       { name: "sandbox", description: "Inspect or configure model command sandboxing.", argument_hint: "[status|off|read_only|workspace_write|network allow|network deny]" },

data/lib/kward/prompts/templates.rb

@@ -4,10 +4,11 @@ module Kward
   module Prompts
     # Parsed prompt template loaded from disk.
     class Templates
-      def initialize(config_dir:, template_class:, markdown_parser:)
+      def initialize(config_dir:, template_class:, markdown_parser:, warning_sink: nil)
         @config_dir = config_dir
         @template_class = template_class
         @markdown_parser = markdown_parser
+        @warning_sink = warning_sink
       end
 
       def prompt_templates(reserved_commands: [])
@@ -21,11 +22,11 @@ module Kward
           next unless template
 
           if reserved.include?(template.command)
-            warn "Warning: skipping Kward prompt command /#{template.command}: reserved command"
+            emit_warning "Warning: skipping Kward prompt command /#{template.command}: reserved command"
             next
           end
           if seen[template.command]
-            warn "Warning: skipping duplicate Kward prompt command /#{template.command}: #{path}"
+            emit_warning "Warning: skipping duplicate Kward prompt command /#{template.command}: #{path}"
             next
           end
 
@@ -33,7 +34,7 @@ module Kward
           template
         end
       rescue StandardError => e
-        warn "Warning: skipping Kward prompt templates in #{prompts_root}: #{e.message}"
+        emit_warning "Warning: skipping Kward prompt templates in #{prompts_root}: #{e.message}"
         []
       end
 
@@ -42,7 +43,7 @@ module Kward
       def parse_prompt_template(path)
         command = File.basename(path, ".md")
         unless command.match?(/\A[A-Za-z0-9][A-Za-z0-9_-]*\z/)
-          warn "Warning: skipping Kward prompt template #{path}: invalid command name"
+          emit_warning "Warning: skipping Kward prompt template #{path}: invalid command name"
           return nil
         end
 
@@ -55,9 +56,13 @@ module Kward
           path: path
         )
       rescue StandardError => e
-        warn "Warning: skipping Kward prompt template #{path}: #{e.message}"
+        emit_warning "Warning: skipping Kward prompt template #{path}: #{e.message}"
         nil
       end
+
+      def emit_warning(message)
+        @warning_sink ? @warning_sink.call(message) : warn(message)
+      end
     end
   end
 end

data/lib/kward/prompts.rb

@@ -22,25 +22,26 @@ module Kward
     # @param plugin_context [String, nil] trusted plugin-provided instructions
     # @return [Hash] role/content system message
     # @api public
-    def system_message(workspace_root: Dir.pwd, include_workspace_personality: true, model: nil, reasoning_effort: nil, now: Time.now, memory_context: nil, plugin_context: nil)
+    def system_message(workspace_root: Dir.pwd, include_workspace_personality: true, model: nil, reasoning_effort: nil, now: Time.now, memory_context: nil, plugin_context: nil, execution_profile_context: nil)
       {
         role: "system",
-        content: prompt_parts(workspace_root: workspace_root, include_workspace_personality: include_workspace_personality, model: model, reasoning_effort: reasoning_effort, now: now, memory_context: memory_context, plugin_context: plugin_context).compact.join("\n\n")
+        content: prompt_parts(workspace_root: workspace_root, include_workspace_personality: include_workspace_personality, model: model, reasoning_effort: reasoning_effort, now: now, memory_context: memory_context, plugin_context: plugin_context, execution_profile_context: execution_profile_context).compact.join("\n\n")
       }
     end
 
-    def prompt_parts(workspace_root: Dir.pwd, include_workspace_personality: true, model: nil, reasoning_effort: nil, now: Time.now, memory_context: nil, plugin_context: nil)
-      prompt_sections(workspace_root: workspace_root, include_workspace_personality: include_workspace_personality, model: model, reasoning_effort: reasoning_effort, now: now, memory_context: memory_context, plugin_context: plugin_context).map { |section| section[:content] }
+    def prompt_parts(workspace_root: Dir.pwd, include_workspace_personality: true, model: nil, reasoning_effort: nil, now: Time.now, memory_context: nil, plugin_context: nil, execution_profile_context: nil)
+      prompt_sections(workspace_root: workspace_root, include_workspace_personality: include_workspace_personality, model: model, reasoning_effort: reasoning_effort, now: now, memory_context: memory_context, plugin_context: plugin_context, execution_profile_context: execution_profile_context).map { |section| section[:content] }
     end
 
     # Returns labeled prompt sections for inspection by CLI and RPC frontends.
     #
     # @return [Array<Hash>] section hashes with label, content, and optional source
     # @api public
-    def prompt_sections(workspace_root: Dir.pwd, include_workspace_personality: true, model: nil, reasoning_effort: nil, now: Time.now, memory_context: nil, plugin_context: nil)
+    def prompt_sections(workspace_root: Dir.pwd, include_workspace_personality: true, model: nil, reasoning_effort: nil, now: Time.now, memory_context: nil, plugin_context: nil, execution_profile_context: nil)
       return replacement_prompt_sections if ConfigFiles.replacement_system_prompt?
 
       sections = [prompt_section("Built-in system prompt", base_prompt)]
+      sections << prompt_section("Execution profile", execution_profile_context) unless execution_profile_context.to_s.empty?
       sections << prompt_section(config_agents_prompt_label, config_agents_prompt, source: config_agents_prompt_source)
       sections << prompt_section("Memory context", memory_context) unless memory_context.to_s.empty?
       if include_workspace_personality