kward 0.76.0 → 0.77.0

data/lib/kward/compactor.rb

@@ -37,7 +37,7 @@ module Kward
 
     Cut = Struct.new(:first_kept_index, :messages_to_summarize, :turn_prefix_messages, :split_turn, :preserved_messages, :preserved_start_index, keyword_init: true)
 
-    # Interactive settings menu actions mixed into the CLI frontend.
+    # Configuration for manual and automatic conversation compaction.
     class Settings
       DEFAULT_ENABLED = true
       DEFAULT_RESERVE_TOKENS = 16_384
@@ -731,7 +731,7 @@ module Kward
     SummarizationFailed = Compaction::SummarizationFailed
 
     AUTO_COMPACTION_GUARD_RATIO = 0.10
-    AUTO_COMPACTION_EXTRA_GUARD_CAP = 12_000
+    AUTO_COMPACTION_EXTRA_GUARD_FLOOR = 12_000
 
     # Creates an object for conversation compaction.
     def initialize(conversation:, client:, tool_result_summarizer: nil, settings: nil, summarizer: nil)
@@ -805,7 +805,7 @@ module Kward
     def self.auto_compaction_reserve_tokens(context_window:, configured_reserve_tokens:)
       context_window_i = context_window.to_i
       dynamic_guard = (context_window_i * AUTO_COMPACTION_GUARD_RATIO).to_i
-      [configured_reserve_tokens.to_i, dynamic_guard, AUTO_COMPACTION_EXTRA_GUARD_CAP].max
+      [configured_reserve_tokens.to_i, dynamic_guard, AUTO_COMPACTION_EXTRA_GUARD_FLOOR].max
     end
 
     def compaction_messages(custom_instructions = nil)

data/lib/kward/config_files.rb

@@ -24,7 +24,9 @@ module Kward
   # Keep path decisions here. Higher-level code should ask `ConfigFiles` for
   # config, prompt, skill, plugin, cache, memory, and session locations instead of
   # reconstructing `~/.kward` paths independently.
+  # @api public
   module ConfigFiles
+    # Raised when a user configuration file cannot be parsed.
     class ConfigError < StandardError
       attr_reader :path, :format, :detail
 
@@ -39,6 +41,7 @@ module Kward
     MAX_SKILL_FILE_BYTES = 100_000
     MAX_PROMPT_FILE_BYTES = 32 * 1024
     DEFAULT_OVERLAY_SETTINGS = { "alignment" => "center", "width" => "maximum" }.freeze
+    PROJECT_BROWSER_ICON_THEMES = %w[off nerd-font].freeze
     DEFAULT_PERSONAS = {
       "characters" => [
         {
@@ -87,10 +90,12 @@ module Kward
       File.expand_path(ENV["KWARD_CONFIG_PATH"] || File.join(config_dir, "config.json"))
     end
 
+    # @return [String] directory containing reusable local caches
     def cache_dir
       File.join(config_dir, "cache")
     end
 
+    # @return [String] embedded-shell YAML config path
     def ekwsh_config_path
       File.join(config_dir, "ekwsh.yml")
     end
@@ -103,6 +108,9 @@ module Kward
       File.join(config_dir, "trusted_workspace_hooks.json")
     end
 
+    # Returns a fresh default config suitable for first-run persistence.
+    #
+    # @return [Hash] deep-mutable config defaults
     def default_config
       {
         "personas" => JSON.parse(JSON.generate(DEFAULT_PERSONAS)),
@@ -124,6 +132,9 @@ module Kward
           "diff_view" => "auto"
         },
         "overlay" => DEFAULT_OVERLAY_SETTINGS.dup,
+        "project_browser" => {
+          "icons" => "off"
+        },
         "web_search" => {
           "enabled" => true,
           "provider" => "auto",
@@ -409,6 +420,13 @@ module Kward
       settings
     end
 
+    # Returns the project browser icon theme, or off when unset or invalid.
+    def project_browser_icon_theme(config = read_config)
+      browser = config["project_browser"].is_a?(Hash) ? config["project_browser"] : {}
+      theme = browser["icons"].to_s
+      PROJECT_BROWSER_ICON_THEMES.include?(theme) ? theme : "off"
+    end
+
     # Returns whether the composer should show busy-state keyboard help.
     def composer_busy_help?(config = read_config)
       composer = config["composer"].is_a?(Hash) ? config["composer"] : {}

data/lib/kward/ekwsh.rb

@@ -551,9 +551,5 @@ module Kward
       ANSI.sanitize_transcript(text)
     end
 
-    def clean_output(value)
-      text = clean_chunk(value)
-      text.end_with?("\n") || text.empty? ? text : "#{text}\n"
-    end
   end
 end

data/lib/kward/hooks/catalog.rb

@@ -45,11 +45,6 @@ module Kward
         EventDefinition.new(name: "git_stage_after", failure_policy: "warn"),
         EventDefinition.new(name: "git_commit_before", failure_policy: "deny"),
         EventDefinition.new(name: "git_commit_after", failure_policy: "warn"),
-        EventDefinition.new(name: "worker_job_create", failure_policy: "warn"),
-        EventDefinition.new(name: "worker_job_start_before", failure_policy: "warn"),
-        EventDefinition.new(name: "worker_job_start_after", failure_policy: "warn"),
-        EventDefinition.new(name: "worker_job_ready_for_review", failure_policy: "warn"),
-        EventDefinition.new(name: "worker_job_failed", failure_policy: "warn")
       ].each_with_object({}) { |definition, result| result[definition.name] = definition }.freeze
 
       module_function

data/lib/kward/image_attachments.rb

@@ -1,5 +1,5 @@
 require "base64"
-require "cgi"
+require "cgi/escape"
 require "shellwords"
 require "tmpdir"
 require "uri"