kward 0.71.0 → 0.73.0

data/lib/kward/prompt_interface/editor/modes/vibe_insert_readline.rb

@@ -0,0 +1,166 @@
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Interactive terminal UI used by the CLI frontend.
+  class PromptInterface
+    # Readline-style insert-mode bindings for the Vibe editor mode.
+    module VibeInsertReadline
+      private
+
+      def handle_vibe_insert_readline_key(key)
+        csi_result = handle_vibe_insert_readline_csi_u_key(key)
+        return csi_result unless csi_result == false
+
+        handle_vibe_insert_readline_ansi_key(key)
+      end
+
+      def handle_vibe_insert_readline_csi_u_key(key)
+        sequence = parse_csi_u_key(key)
+        return false unless sequence
+
+        queue_pending_keys(sequence[:remaining]) if sequence[:remaining] && !sequence[:remaining].empty?
+        modifier = sequence[:modifier]
+        normalized_code = sequence[:code].to_i.chr.downcase.ord rescue sequence[:code]
+        if ctrl_modifier?(modifier)
+          return handle_vibe_insert_readline_ctrl_key(normalized_code)
+        elsif alt_modifier?(modifier)
+          return handle_vibe_insert_readline_alt_key(normalized_code)
+        end
+
+        false
+      end
+
+      def handle_vibe_insert_readline_ansi_key(key)
+        case key
+        when TerminalKeys::CTRL_A
+          @editor_state.move_line_start
+        when TerminalKeys::CTRL_B
+          @editor_state.move_left
+        when TerminalKeys::CTRL_D
+          vibe_record_undo { @editor_state.delete_at_cursor }
+        when TerminalKeys::CTRL_E
+          @editor_state.move_line_end
+        when TerminalKeys::CTRL_F
+          @editor_state.move_right
+        when TerminalKeys::CTRL_K
+          vibe_record_undo { @editor_state.kill_line_after_cursor }
+        when TerminalKeys::CTRL_U
+          vibe_record_undo { @editor_state.kill_line_before_cursor }
+        when TerminalKeys::CTRL_W
+          vibe_record_undo { @editor_state.delete_word_before_cursor }
+        when TerminalKeys::CTRL_Y
+          vibe_record_undo { @editor_state.yank_kill_buffer }
+        when *TerminalKeys::LEFT
+          @editor_state.move_left
+        when *TerminalKeys::RIGHT
+          @editor_state.move_right
+        when *TerminalKeys::HOME
+          @editor_state.move_line_start
+        when *TerminalKeys::END_KEY
+          @editor_state.move_line_end
+        when *TerminalKeys::DELETE
+          vibe_record_undo { @editor_state.delete_at_cursor }
+        when "\eb", "\eB"
+          @editor_state.move_to_previous_word
+        when "\ef", "\eF"
+          @editor_state.move_to_next_word
+        when "\ed", "\eD"
+          vibe_record_undo { @editor_state.delete_word_after_cursor }
+        when "\e\b", "\e\x7F"
+          vibe_record_undo { @editor_state.delete_word_before_cursor }
+        else
+          handle_vibe_insert_modified_ansi_key(key)
+        end
+      end
+
+      def handle_vibe_insert_readline_ctrl_key(normalized_code)
+        case normalized_code
+        when 97
+          @editor_state.move_line_start
+        when 98
+          @editor_state.move_left
+        when 100
+          vibe_record_undo { @editor_state.delete_at_cursor }
+        when 101
+          @editor_state.move_line_end
+        when 102
+          @editor_state.move_right
+        when 107
+          vibe_record_undo { @editor_state.kill_line_after_cursor }
+        when 117
+          vibe_record_undo { @editor_state.kill_line_before_cursor }
+        when 119
+          vibe_record_undo { @editor_state.delete_word_before_cursor }
+        when 121
+          vibe_record_undo { @editor_state.yank_kill_buffer }
+        else
+          false
+        end
+      end
+
+      def handle_vibe_insert_readline_alt_key(normalized_code)
+        case normalized_code
+        when 98
+          @editor_state.move_to_previous_word
+        when 100
+          vibe_record_undo { @editor_state.delete_word_after_cursor }
+        when 102
+          @editor_state.move_to_next_word
+        else
+          false
+        end
+      end
+
+      def handle_vibe_insert_modified_ansi_key(key)
+        sequence = parse_modified_ansi_key(key)
+        return false unless sequence
+
+        case sequence[:type]
+        when :cursor
+          return false unless alt_modifier?(sequence[:modifier])
+
+          case sequence[:final]
+          when "C"
+            @editor_state.move_to_next_word
+          when "D"
+            @editor_state.move_to_previous_word
+          when "F"
+            @editor_state.move_line_end
+          when "H"
+            @editor_state.move_line_start
+          else
+            false
+          end
+        when :delete
+          return false unless alt_modifier?(sequence[:modifier])
+
+          vibe_record_undo { @editor_state.delete_word_after_cursor }
+        else
+          false
+        end
+      end
+
+      def handle_vibe_insert_named_key(key_name)
+        case key_name
+        when :escape
+          vibe_return_to_normal
+        when :return, :enter
+          vibe_record_undo { editor_insert_newline }
+        when :backspace
+          vibe_record_undo { editor_delete_before_cursor }
+        when :delete
+          vibe_record_undo { @editor_state.delete_at_cursor }
+        when :left
+          @editor_state.move_left
+        when :right
+          @editor_state.move_right
+        when :up
+          editor_move_up
+        when :down
+          editor_move_down
+        else
+          false
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,244 @@
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Interactive terminal UI used by the CLI frontend.
+  class PromptInterface
+    # Renderer for the built-in composer file editor.
+    module EditorRenderer
+      private
+
+      def editor_layout(width, height = screen_height)
+        content_width = [width - 4, 1].max
+        visible_count = editor_visible_line_count(height: height, width: width)
+        line_index, column = @editor_state.cursor_line_and_column
+        gutter_width = editor_line_number_gutter_width
+        text_width = editor_text_width(content_width, gutter_width)
+        sync_editor_wrap_state(text_width)
+
+        if current_editor_soft_wrap?
+          editor_wrapped_layout(width, content_width, visible_count, line_index, column, text_width)
+        else
+          editor_unwrapped_layout(width, content_width, visible_count, line_index, column, text_width)
+        end
+      end
+
+      def editor_unwrapped_layout(width, content_width, visible_count, line_index, column, text_width)
+        @editor_state.viewport_row = [[@editor_state.viewport_row, line_index - visible_count + 1].max, line_index].min
+        @editor_state.viewport_row = [@editor_state.viewport_row, 0].max
+        @editor_state.viewport_column = [[@editor_state.viewport_column.to_i, column - text_width + 1].max, column].min
+        @editor_state.viewport_column = [@editor_state.viewport_column, 0].max
+        editor_lines = @editor_state.lines
+        visible_lines = editor_lines[@editor_state.viewport_row, visible_count] || []
+        actual_visible_count = visible_lines.length
+        visible_lines << "" while visible_lines.length < visible_count
+        gutter_width = editor_line_number_gutter_width
+        rows = [editor_top_border(width)]
+        rows.concat(visible_lines.each_with_index.map do |line, index|
+          gutter = if index < actual_visible_count
+                     editor_line_number_gutter(@editor_state.viewport_row + index)
+                   else
+                     editor_blank_line_number_gutter
+                   end
+          rendered_line = editor_render_line(line, @editor_state.viewport_row + index, text_width, column_offset: @editor_state.viewport_column)
+          row = gutter + rendered_line
+          box_content_row(row, content_width)
+        end)
+        rows << footer_row(content_width, editor_status_text)
+        rows.concat(editor_bottom_rows(width))
+        cursor_row = 1 + line_index - @editor_state.viewport_row
+        cursor_col = 2 + gutter_width + [[column - @editor_state.viewport_column, 0].max, text_width - 1].min
+        [rows, cursor_row, cursor_col]
+      end
+
+      def editor_wrapped_layout(width, content_width, visible_count, line_index, column, text_width)
+        visual_rows = editor_visual_rows(text_width)
+        cursor_visual_row = editor_visual_row_for(line_index, column, text_width)
+        @editor_state.viewport_row = [[@editor_state.viewport_row, cursor_visual_row - visible_count + 1].max, cursor_visual_row].min
+        @editor_state.viewport_row = [@editor_state.viewport_row, 0].max
+        visible_rows = visual_rows[@editor_state.viewport_row, visible_count] || []
+        visible_rows << nil while visible_rows.length < visible_count
+        rows = [editor_top_border(width)]
+        rows.concat(visible_rows.map do |visual_row|
+          if visual_row
+            gutter = visual_row[:continuation] ? editor_blank_line_number_gutter : editor_line_number_gutter(visual_row[:line_index])
+            rendered_line = editor_render_line(visual_row[:line], visual_row[:line_index], text_width, column_offset: visual_row[:column_offset])
+            box_content_row(gutter + rendered_line, content_width)
+          else
+            box_content_row(editor_blank_line_number_gutter, content_width)
+          end
+        end)
+        rows << footer_row(content_width, editor_status_text)
+        rows.concat(editor_bottom_rows(width))
+        line_start = editor_visual_row_start_column(line_index, column, text_width)
+        cursor_row = 1 + cursor_visual_row - @editor_state.viewport_row
+        cursor_col = 2 + editor_line_number_gutter_width + [[column - line_start, 0].max, text_width - 1].min
+        [rows, cursor_row, cursor_col]
+      end
+
+      def editor_visible_line_count(height: screen_height, width: screen_width)
+        visible_count = [[height - 3 - editor_bottom_rows(width).length, 1].max, 1].max
+        visible_count = [visible_count, height - 4].min if height > 4
+        [visible_count, 1].max
+      end
+
+      def editor_bottom_rows(width)
+        @tabs.empty? ? [bottom_border(width)] : tab_border_rows(width)
+      end
+
+      def editor_render_line(line, line_index, text_width, column_offset: 0)
+        visible = line.to_s[column_offset.to_i, text_width].to_s
+        rendered = editor_render_visible_line(visible, line_index)
+        line_start = @editor_state.line_start_offset(line_index)
+        rendered = editor_overlay_line_selections(rendered, line_start, column_offset, visible.length)
+        editor_overlay_secondary_cursors(rendered, line_start, column_offset, visible.length, text_width)
+      end
+
+      def editor_overlay_line_selections(rendered, line_start, column_offset, visible_length)
+        ranges = @editor_state.selection_ranges
+        return rendered if ranges.empty?
+
+        selection_ranges = ranges.filter_map do |range|
+          selection_start = [range[0] - line_start - column_offset.to_i, 0].max
+          selection_end = [range[1] - line_start - column_offset.to_i, visible_length].min
+          [selection_start, selection_end] if selection_start < selection_end
+        end
+        return rendered if selection_ranges.empty?
+
+        editor_overlay_selection(rendered, selection_ranges)
+      end
+
+      def editor_overlay_secondary_cursors(rendered, line_start, column_offset, visible_length, text_width)
+        return rendered unless @color_enabled
+
+        cursor_columns = @editor_state.secondary_cursor_offsets.filter_map do |offset|
+          column = offset - line_start - column_offset.to_i
+          column if column >= 0 && column <= visible_length
+        end
+        return rendered if cursor_columns.empty?
+
+        if cursor_columns.include?(visible_length) && visible_length < text_width
+          rendered += " "
+        end
+
+        editor_overlay_selection(rendered, cursor_columns.map { |column| [column, column + 1] })
+      end
+
+      def editor_overlay_selection(rendered, selection_ranges)
+        return rendered unless @color_enabled
+
+        output = +""
+        selected = false
+        visible_index = 0
+        index = 0
+        while index < rendered.length
+          if rendered[index] == "\e" && (match = rendered[index..].match(/\A\e\[[0-9;:]*m/))
+            output << match[0]
+            output << TerminalSequences::SGR_INVERSE if selected && match[0] == "\e[0m"
+            index += match[0].length
+            next
+          end
+
+          should_select = selection_ranges.any? { |range| visible_index >= range[0] && visible_index < range[1] }
+          if should_select != selected
+            output << (should_select ? TerminalSequences::SGR_INVERSE : TerminalSequences::SGR_INVERSE_OFF)
+            selected = should_select
+          end
+          output << rendered[index]
+          visible_index += 1
+          index += 1
+        end
+        output << TerminalSequences::SGR_INVERSE_OFF if selected
+        output
+      end
+
+      def editor_render_visible_line(line, line_index)
+        return editor_render_diff_line(line) if @editor_state.diff_view?
+
+        editor_highlight_line(line, line_index)
+      end
+
+      def editor_render_diff_line(line)
+        text = line.to_s
+        return colored(text, :green) if text.start_with?("+") && !text.start_with?("+++")
+        return colored(text, :red) if text.start_with?("-") && !text.start_with?("---")
+        return colored(text, :cyan) if text.start_with?("@@")
+
+        text
+      end
+
+      def editor_line_number_gutter_width
+        [[@editor_state.lines.length.to_s.length, 4].max + 3, 1].max
+      end
+
+      def editor_text_width(content_width, gutter_width = editor_line_number_gutter_width)
+        [content_width - gutter_width, 1].max
+      end
+
+      def editor_visual_rows(text_width)
+        @editor_state.lines.each_with_index.flat_map do |line, line_index|
+          count = editor_visual_row_count(line, text_width)
+          count.times.map do |index|
+            column_offset = index * text_width
+            { line_index: line_index, column_offset: column_offset, line: line, continuation: index.positive? }
+          end
+        end
+      end
+
+      def editor_visual_row_count(line, text_width)
+        length = line.to_s.length
+        return 1 if length.zero?
+
+        ((length - 1) / text_width) + 1
+      end
+
+      def editor_visual_row_for(line_index, column, text_width)
+        before = @editor_state.lines.first(line_index).sum { |line| editor_visual_row_count(line, text_width) }
+        before + (editor_visual_row_start_column(line_index, column, text_width) / text_width)
+      end
+
+      def editor_visual_row_start_column(line_index, column, text_width)
+        line = @editor_state.lines[line_index].to_s
+        return 0 if column.to_i.zero?
+        return column.to_i - text_width if column.to_i == line.length && (column.to_i % text_width).zero?
+
+        (column.to_i / text_width) * text_width
+      end
+
+      def editor_line_number_gutter(line_index)
+        number = editor_display_line_number(line_index).to_s.rjust(editor_line_number_gutter_width - 3)
+        colored("#{number} │ ", :dark_forest_green)
+      end
+
+      def editor_display_line_number(line_index)
+        return line_index + 1 unless current_editor_line_numbers == "relative"
+        return line_index + 1 if @editor_state.readonly?
+
+        cursor_line, = @editor_state.cursor_line_and_column
+        line_index == cursor_line ? line_index + 1 : (line_index - cursor_line).abs
+      end
+
+      def editor_blank_line_number_gutter
+        colored(" " * editor_line_number_gutter_width, :dark_forest_green)
+      end
+
+      def editor_top_border(width)
+        title_prefix = @editor_state.diff_view? ? "Diff" : "Edit"
+        dirty_marker = @editor_state.dirty? && !@editor_state.readonly? ? " *" : ""
+        title = visible_truncate("#{title_prefix} #{editor_display_path}#{dirty_marker}", [width - 4, 1].max)
+        plain_title = ANSI.strip(title)
+        "#{colored("╭", :primary_green)} #{title} #{colored("─" * [width - plain_title.length - 4, 0].max, :primary_green)}#{colored("╮", :primary_green)}"
+      end
+
+      def editor_display_path
+        path = @editor_state.path || @editor_state.display_path
+        Pathname.new(path).relative_path_from(Pathname.new(Dir.pwd)).to_s
+      rescue StandardError
+        @editor_state.display_path || @editor_state.path
+      end
+
+      def editor_status_text
+        text = @editor_state.search_active ? "#{@editor_state.search_direction == :backward ? "Search backward" : "Search"}: #{@editor_state.search_query}" : @editor_state.status
+        visible_truncate(text, [screen_width - 4, 1].max)
+      end
+    end
+  end
+end

data/lib/kward/prompt_interface/editor/search.rb

@@ -0,0 +1,76 @@
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Interactive terminal UI used by the CLI frontend.
+  class PromptInterface
+    # Incremental search state and operations for editor buffers.
+    class EditorSearch
+      attr_reader :query, :direction
+
+      def initialize(direction: :forward)
+        @active = false
+        @query = +""
+        @direction = direction
+      end
+
+      def active?
+        @active == true
+      end
+
+      def begin(direction = :forward)
+        @active = true
+        @direction = direction
+        @query = +""
+        status_prefix
+      end
+
+      def cancel
+        @active = false
+        "Search cancelled"
+      end
+
+      def append(text)
+        @query << text.to_s
+        "#{status_prefix} #{@query}"
+      end
+
+      def delete_character
+        @query = @query[0...-1].to_s
+        "#{status_prefix} #{@query}"
+      end
+
+      def confirm(buffer:, cursor:)
+        confirmed_query = @query.to_s
+        @active = false
+        return { status: "Search cancelled", found: false } if confirmed_query.empty?
+
+        repeat(buffer: buffer, cursor: cursor, direction: @direction, query: confirmed_query)
+      end
+
+      def repeat(buffer:, cursor:, direction: @direction, query: @query)
+        query = query.to_s
+        return { status: "No previous search", found: false } if query.empty?
+
+        @query = query
+        @direction = direction
+        index = if direction == :backward
+          search_from = cursor.positive? ? cursor - 1 : buffer.length
+          buffer.rindex(query, search_from) || buffer.rindex(query)
+        else
+          buffer.index(query, cursor + 1) || buffer.index(query)
+        end
+
+        if index
+          { cursor: index, status: "Found: #{query}", found: true }
+        else
+          { status: "No match: #{query}", found: false }
+        end
+      end
+
+      private
+
+      def status_prefix
+        @direction == :backward ? "Search backward:" : "Search:"
+      end
+    end
+  end
+end

data/lib/kward/prompt_interface/editor/selections.rb

@@ -0,0 +1,120 @@
+# Namespace for the Kward CLI agent runtime.
+module Kward
+  # Interactive terminal UI used by the CLI frontend.
+  class PromptInterface
+    # Primary and secondary selection/cursor storage for editor buffers.
+    class EditorSelections
+      attr_reader :anchor, :secondary
+
+      def initialize(cursor:, buffer_length:, anchor: nil, secondary: [])
+        @cursor = cursor
+        @buffer_length = buffer_length
+        @anchor = anchor.nil? ? nil : clamp_offset(anchor)
+        @secondary = secondary.map { |selection| normalized_selection(selection) }
+        normalize
+      end
+
+      def cursor=(value)
+        @cursor = value
+        normalize
+      end
+
+      def buffer_length=(value)
+        @buffer_length = value.to_i
+        @anchor = clamp_offset(@anchor) unless @anchor.nil?
+        @secondary = @secondary.map { |selection| normalized_selection(selection) }
+        normalize
+      end
+
+      def anchor=(value)
+        @anchor = value.nil? ? nil : clamp_offset(value)
+        normalize
+      end
+
+      def all
+        normalize
+        [primary] + @secondary.map(&:dup)
+      end
+
+      def multi_cursor?
+        normalize
+        @secondary.any?
+      end
+
+      def set(values)
+        first, *rest = values.to_a
+        if first
+          @anchor = first[:anchor]
+          @cursor = first[:cursor]
+        else
+          @anchor = nil
+          @cursor = 0
+        end
+        @secondary = rest.map { |selection| normalized_selection(selection) }
+        normalize
+      end
+
+      def add(anchor, cursor = anchor)
+        @secondary << normalized_selection(anchor: anchor, cursor: cursor)
+        normalize
+      end
+
+      def clear
+        @anchor = nil
+        @secondary = []
+      end
+
+      def collapse_to_primary
+        @secondary = []
+        @anchor = nil
+      end
+
+      def secondary_cursor_offsets
+        normalize
+        @secondary.filter_map do |selection|
+          selection[:cursor] if selection[:anchor] == selection[:cursor]
+        end
+      end
+
+      def primary
+        { anchor: @anchor || @cursor, cursor: @cursor }
+      end
+
+      def primary_active?(vibe_visual: false)
+        return false if @anchor.nil?
+        return true if vibe_visual
+
+        @anchor != @cursor
+      end
+
+      def range_for(selection)
+        [selection[:anchor], selection[:cursor]].minmax
+      end
+
+      private
+
+      def normalize
+        seen = { [primary[:anchor], primary[:cursor]] => true }
+        @secondary = @secondary.filter_map do |selection|
+          normalized = normalized_selection(selection)
+          key = [normalized[:anchor], normalized[:cursor]]
+          next if seen[key]
+
+          seen[key] = true
+          normalized
+        end
+      end
+
+      def normalized_selection(selection)
+        {
+          anchor: clamp_offset(selection[:anchor]),
+          cursor: clamp_offset(selection[:cursor])
+        }
+      end
+
+      def clamp_offset(value)
+        [[value.to_i, 0].max, @buffer_length].min
+      end
+    end
+  end
+end