kward 0.78.0 → 0.80.0

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
@@ -364,6 +379,24 @@ module Kward
       run_editor
     end
 
+    # Opens an in-memory document editor. The callback receives edited content
+    # when the user saves; return an error message to keep the editor open.
+    def review_document(title:, content:, &on_save)
+      raise ArgumentError, "review_document requires a save callback" unless on_save
+
+      start(render: false)
+      opened = @mutex.synchronize do
+        @editor_save_callback = on_save
+        open_scratchpad(:markdown, content: content).tap do
+          @editor_state.status = "#{title} · Ctrl+S save · Ctrl+Q cancel"
+          render_prompt_locked
+        end
+      end
+      return false unless opened
+
+      run_editor
+    end
+
     def run_editor
       loop do
         key = read_key(nonblock: true)
@@ -592,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
 
@@ -607,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
 
@@ -841,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
@@ -861,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,10 +30,12 @@ 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]" },
       { name: "hooks", description: "Inspect lifecycle hooks.", argument_hint: "[list|events|logs|doctor|trust|untrust]" },
+      { name: "skill", description: "Activate a skill or capture one from a saved session.", argument_hint: "<name>|capture" },
       { name: "memory", description: "Inspect and manage Kward memory.", argument_hint: "[enable|disable|auto-summary|core|add|list|forget|promote|relax|inspect|why|summarize]" }
     ].freeze
     BUILTIN_RESERVED_COMMAND_NAMES = BUILTIN_COMMANDS.map { |command| command[:name] }.freeze

data/lib/kward/prompts.rb

@@ -22,23 +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
@@ -53,11 +56,11 @@ module Kward
 
     def base_prompt
       <<~PROMPT.strip
-        You are Kward, a concise practical CLI coding agent. Use tools to understand and modify software projects. Inspect files before changing them, make the smallest correct change, preserve existing style, and summarize what changed. Be honest about limitations.
+        You are Kward, a concise practical CLI coding agent. Use tools to understand and modify software projects. Only call tools advertised for the current turn. Inspect files before changing them, make the smallest correct change, preserve existing style, and summarize what changed. Be honest about limitations.
 
-        For web research, use web_search to discover sources, fetch_content for important human-readable pages, and fetch_raw for machine-readable resources such as JSON, YAML, XML, RSS, OpenAPI specs, and plain text. Prefer official or primary sources and cite or mention the URLs you relied on.
+        When web tools are available, use web_search to discover sources, fetch_content for important human-readable pages, and fetch_raw for machine-readable resources such as JSON, YAML, XML, RSS, OpenAPI specs, and plain text. Prefer official or primary sources and cite or mention the URLs you relied on. Use code_search for package, GitHub repository, and source-code research.
 
-        Manage code context deliberately. Prefer context_for_task, summarize_file_structure, and read_file mode="outline"/"preview" before broad reads. Escalate to read_file mode="range" for exact lines, and use mode="full" only when focused context is insufficient. Use context_budget_stats when asked about context savings.
+        Manage code context deliberately. Prefer context_for_task, summarize_file_structure, and read_file mode="outline"/"preview" before broad reads. Escalate to read_file mode="range" for exact lines, and use mode="full" only when focused context is insufficient. If output is compacted or replaced with a duplicate reference, use retrieve_tool_output to inspect the needed original detail. Use context_budget_stats when asked about context savings. When a material requirement is ambiguous, use ask_user_question when it is available; otherwise state the assumption.
       PROMPT
     end
 
@@ -73,6 +76,7 @@ module Kward
     end
 
     def config_agents_prompt_source
+      return nil unless ConfigFiles.include_config_principles?
       return ConfigFiles.config_principles_path if File.exist?(ConfigFiles.config_principles_path)
       return ConfigFiles.config_agents_path if File.exist?(ConfigFiles.config_agents_path)
 
@@ -112,6 +116,14 @@ module Kward
       "Workspace AGENTS.md hint"
     end
 
+    def replacement_prompt_sections
+      path = ConfigFiles.system_prompt_file_path
+      content = ConfigFiles.system_prompt_file
+      return [] if content.to_s.empty?
+
+      [prompt_section("Custom system prompt (replacement)", content, source: path)]
+    end
+
     def prompt_section(label, content, source: nil)
       return nil if content.to_s.empty?
 
@@ -123,8 +135,8 @@ module Kward
 
       lines = [
         "Agent Skills are available.",
-        "When a task matches a skill's description, use read_skill to load its instructions before proceeding.",
-        "Use read_skill with a relative path to read referenced files inside a skill directory.",
+        "When read_skill is available and a task matches a skill's description, use it to load the instructions before proceeding.",
+        "When using read_skill, use a relative path to read referenced files inside a skill directory.",
         "Available skills:"
       ]
       skills.each do |skill|