ollama_chat 0.0.123 → 0.0.124

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2d0c5676e03433f245a21795872a9d7bd64357306ec691de3012195b5403bef
-  data.tar.gz: 933dca2b53647c523b9849d958cc1625106c97500caf2814bc731458a0e683f4
+  metadata.gz: 0d2664dce7c6742ff5c950e64330b84325bcbb573467edde9aceddc3fa209641
+  data.tar.gz: 87baa515acb398c9da1b7cf6c7fce173d946e4bd4d79ad0f1eb9dfbd2526235a
 SHA512:
-  metadata.gz: 4589b5f1cf689bb35bdf26c288e59f40b87ef926eaf7f91e187c3fa729958c9d042f784eb3bf9a4b6e64966c201312713c2e20607291c6aabc10d306cf4cf272
-  data.tar.gz: 19102c3d01a2ebb4bb14b8ea617b09a7e168d0175225024a490dc85e23b41ce3c7eba249d82cc671f5530da0090e945f8f6358d17ca7f6b7587a413002e27dc2
+  metadata.gz: a091addc87c893f700f405147386dc8fe8fcc5c3134ad12bb1ffda570ec8a0f64ac4acbaeaed70116a6c61d0765e14e2f085fa8d2c0b98496fb0881a56fdb0f8
+  data.tar.gz: 6d078a9c69b50719dda02e9c81a32d51929627ab6e50c7cae023630543e717dd2c1a86166495f339875178108e0ded60f9f451ebbec1275f16f06771c9b1b215

data/CHANGES.md

@@ -1,5 +1,73 @@
 # Changes
 
+## 2026-10-02 v0.0.124
+
+### Added
+
+*   `OllamaChat::Feedback` module to replace raw `STDOUT.puts` and
+    `STDERR.puts` calls with typed, testable system notifications.
+    *   Supports types: `:success`, `:cancel`, `:denied`, `:warn`, `:info`,
+        `:alarm`.
+    *   Integrates with `use_pager` and handles newline formatting via
+        `output.print`.
+*   `memorize` tool to embed timestamped entries into per-persona
+    `memory-<persona_name>` Documentrix collections.
+*   `forget` tool to clear a single memory record by its ISO-8601 timestamp
+    tag.
+*   `/collection query` subcommand to debug collections, supporting optional
+    `-e` (edit) and `-r` (rerank) flags.
+*   `/config env` subcommand to display the Ollama Chat environment variable
+    tree using `OC.view`.
+*   `/last -v` flag to voice previous assistant messages via
+    `MessageList#speak_last`.
+*   `OllamaChat::CollectionSearch` module extracted from `SearchKnowledge`
+    tool, providing `find_document_records` and `rerank_records` methods mixed
+    into `Chat`.
+*   `refresh_system_prompt` method in `SystemPromptManagement` to
+    re-interpolate the active system prompt with fresh `persona` and
+    `runtime_info` values after collection mutations.
+*   Voice announcement in the compaction report, including
+    `context_filled_before`, `context_filled_after`, and `duration` in
+    `Compaction::Result`.
+*   `Speaker#wait_for_speaker` method to join the speaker thread and block
+    until completion.
+*   `spec/ollama_chat/speaker_spec.rb` with tests for `OllamaChat::Speaker`.
+
+### Changed
+
+*   Replaced `str % {…}` with `named_placeholders_interpolate({…})` for
+    DB-prompt call sites to handle unknown placeholders gracefully.
+*   Updated `directory_structure` tool description from "Tree viewer" to "File
+    locator" and added guidance to prefer it over shell `find` or `ls -R`.
+*   Routed prompt change feedback through the `chat` instance in `app_state.rb`
+    to ensure messages target the active chat session.
+*   Switched spec stubs from `allow` to `expect` in `http_handling_spec.rb`,
+    `message_list_spec.rb`, `execute_shell_spec.rb`, `tts_spec.rb`,
+    `compaction_spec.rb`, `audio_player_spec.rb`, and `asr_spec.rb` to enforce
+    required calls.
+*   Bumped `const_conf` dependency from `~> **0.3**` to `~> **0.9**`.
+*   Updated `rerank_records` to accept an optional `prompt_name:` keyword
+    argument.
+*   Improved new session name generation by extracting
+    `new_random_session_name` into `SessionManagement` and handling `nil`
+    cancellation in `determine_valid_new_name_for_session`.
+*   Allowed naming new sessions via `choose_session` by threading an optional
+    `name:` keyword through `new_session` and `Session.with_defaults`.
+*   Logged stored memory text in the `memorize` tool by adding `text:` to the
+    `chat.log` data hash.
+*   Extracted context usage helpers `context_usage_colored` and
+    `context_percentage` to eliminate duplicated format logic.
+*   Updated `output_eval_stats` in `follow_chat.rb` to print colored context
+    usage.
+
+### Fixed
+
+*   Fixed indentation bug in `model_handling.rb` import/export by changing
+    `sub` to `gsub`.
+*   Guarded source link rendering in `search_knowledge` against `nil` or empty
+    `source` values.
+*   Suppressed `report_on_exception` on `AudioPlayer` background thread.
+
 ## 2026-09-25 v0.0.123
 
 ### Added

data/Rakefile

@@ -55,7 +55,7 @@ GemHadar do
   dependency             'pdf-reader',            '~> 2.0'
   dependency             'bigdecimal',            '~> 3.1'
   dependency             'csv',                   '~> 3.0'
-  dependency             'const_conf',            '~> 0.3'
+  dependency             'const_conf',            '~> 0.9'
   dependency             'context_spook',         '~> 1.6'
   dependency             'infobar',               '>= 0.13.1'
   dependency             'rubyzip',               '~> 3.0'

data/lib/ollama_chat/asr.rb

@@ -38,11 +38,11 @@ module OllamaChat
           executable = Shellwords.split(cmd).first
           result     = system(cmd, out: File::NULL, err: File::NULL)
           if result.nil?
-            STDERR.puts "ASR: #{executable} not found in PATH."
+            chat.feedback("ASR: #{executable} not found in PATH.", type: :warn)
             return
           end
           unless File.size(wav.path) > 0
-            STDERR.puts "ASR: #{executable} produced no output."
+            chat.feedback("ASR: #{executable} produced no output.", type: :warn)
             return
           end
 
@@ -61,7 +61,7 @@ module OllamaChat
           result = JSON.parse(response.body) rescue nil
         end
         chat.log(:error, e, data: { status:, result: })
-        STDERR.puts "ASR transcription failed: #{e.message}"
+        chat.feedback("ASR transcription failed: #{e.message}", type: :warn)
         nil
       end
 

data/lib/ollama_chat/chat.rb

@@ -34,6 +34,7 @@ require 'zlib'
 class OllamaChat::Chat
   include Tins::GO
   include Term::ANSIColor
+  include OllamaChat::Feedback
   include OllamaChat::TokenEstimator
   include OllamaChat::HTTPHandling
   include OllamaChat::Commands
@@ -64,6 +65,7 @@ class OllamaChat::Chat
   include OllamaChat::ConfigHandling
   include OllamaChat::PersonaeManagement
   include OllamaChat::SessionManagement
+  include OllamaChat::CollectionSearch
   include OllamaChat::RAGHandling
   include OllamaChat::FavouritesManagement
   include OllamaChat::PromptHandling
@@ -195,7 +197,7 @@ class OllamaChat::Chat
       abort "Failed to use to model: #{e}"
     end
 
-    STDOUT.puts
+    feedback ?\n
 
     setup_persona_from_session
     setup_system_prompt
@@ -203,7 +205,7 @@ class OllamaChat::Chat
     print_welcome
     info_session
 
-    STDOUT.puts "\nType /help to display the chat help."
+    feedback("\nType /help to display the chat help.")
 
     interact_with_user
   end
@@ -434,19 +436,19 @@ class OllamaChat::Chat
     case what
     when 'messages', nil
       messages.clear
-      STDOUT.puts "Cleared messages."
+      feedback("Cleared messages.", type: :info)
     when 'links'
       links.clear
-      STDOUT.puts "Cleared links."
+      feedback("Cleared links.", type: :info)
     when 'history'
       clear_history
-      STDOUT.puts "Cleared history."
+      feedback("Cleared history.", type: :info)
     when 'tags'
       @documents.clear
-      STDOUT.puts "Cleared all tags."
+      feedback("Cleared all tags.", type: :info)
     when 'images'
       messages.clear_images
-      STDOUT.puts "Cleared all images."
+      feedback("Cleared all images.", type: :info)
     when 'all'
       if confirm?(
           prompt: '🔔 Are you sure to clear messages and collection? (y/n) ',
@@ -457,9 +459,9 @@ class OllamaChat::Chat
         @documents.clear
         links.clear
         clear_history
-        STDOUT.puts "Cleared messages and collection #{bold{collection}}."
+        feedback("Cleared messages and collection #{bold{collection}}.", type: :info)
       else
-        STDOUT.puts 'Cancelled.'
+        feedback("Denied.", type: :denied)
       end
     end
     persona_profile
@@ -517,7 +519,7 @@ class OllamaChat::Chat
           type           = message.type.full?(:to_sym) || :socket_input
           content        = message.content
           @parse_content = message.parse
-          STDOUT.puts color(112) { "Received a server socket message. Processing now…" }
+          feedback color(112) { "Received a server socket message. Processing now…" }, type: :info
         else
           raise
         end
@@ -619,13 +621,13 @@ class OllamaChat::Chat
       msg = "Currently lost connection to ollama server and cannot send command."
       log(:warn, msg, warn: true)
     rescue Interrupt
-      STDOUT.puts "Type /quit to quit."
+      feedback("Type /quit to quit.")
     ensure
       self.server_socket_message = nil
     end
     0
   rescue OllamaChat::OllamaChatQuitError
-    STDOUT.puts "Goodbye."
+    feedback("Goodbye.")
   rescue ComplexConfig::AttributeMissing, ComplexConfig::ConfigurationSyntaxError => e
     log(:error, e)
     fix_config(e)
@@ -718,7 +720,7 @@ class OllamaChat::Chat
   # @note Progress is reported to STDOUT during processing
   def add_documents_from_argv(document_list)
     if document_list.any?(&:empty?)
-      STDOUT.puts "Clearing collection #{bold{documents.collection}}."
+      feedback("Clearing collection #{bold{documents.collection}}.", type: :info)
       documents.clear
       document_list.reject!(&:empty?)
     end
@@ -730,7 +732,7 @@ class OllamaChat::Chat
           File.expand_path(doc)
         end
       end
-      STDOUT.puts "Collection #{bold{documents.collection}}: Adding #{document_list.size} documents…"
+      feedback("Collection #{bold{documents.collection}}: Adding #{document_list.size} documents…", type: :info)
       count = 1
       document_list.each_slice(25) do |docs|
         docs.each do |doc|

data/lib/ollama_chat/clipboard.rb

@@ -116,11 +116,11 @@ module OllamaChat::Clipboard
     text = last_message_content(content: false)
     perform_copy_to_clipboard(text:, edit:)
     log(:info, "Copied to clipboard", data: { bytes: format_bytes(text.bytesize) }) if text
-    STDOUT.puts "The last response has been successfully copied to the system clipboard."
+    feedback("The last response has been successfully copied to the system clipboard.", type: :info)
     true
   rescue OllamaChat::OllamaChatError => e
     log(:error, e, data: { method: __method__ })
-    STDERR.puts e.message
+    feedback(e.message, type: :warn)
   end
 
   # Pastes content from the system clipboard into the chat.
@@ -137,11 +137,11 @@ module OllamaChat::Clipboard
   def paste_from_clipboard(edit: false)
     result = perform_paste_from_clipboard(edit:)
     log(:info, "Pasted from clipboard", data: { bytes: format_bytes(result.bytesize) }) if result
-    STDOUT.puts "The clipboard content has been successfully copied to the chat."
+    feedback("The clipboard content has been successfully copied to the chat.", type: :info)
     result
   rescue OllamaChat::OllamaChatError => e
     log(:error, e, data: { method: __method__ })
-    STDERR.puts e.message
+    feedback(e.message, type: :warn)
   end
 
   # Read the full text from STDIN and return it.

data/lib/ollama_chat/collection_search.rb

@@ -0,0 +1,66 @@
+# Shared collection search primitives for document retrieval and LLM
+# reranking.
+#
+# Extracted from {OllamaChat::Tools::SearchKnowledge} so that the
+# `/collection query` command and the trigger mechanism can reuse
+# the same search + rerank pipeline without duplicating logic.
+module OllamaChat::CollectionSearch
+  include Kramdown::ANSI::Width
+
+  # Searches the active document collection for records matching
+  # the given query.
+  #
+  # @param query [String] the search query
+  # @param tags [Array<String>, nil] tag filter
+  # @param text_size [Integer, nil] max snippet size
+  # @param text_count [Integer, nil] max number of snippets
+  # @param min_similarity [Float, nil] minimum similarity threshold
+  #
+  # @return [Array<Documentrix::Utils::TagResult>] matching records
+  def find_document_records(
+    query,
+    tags: nil, text_size: nil, text_count: nil, min_similarity: nil
+  )
+    tags = Documentrix::Utils::Tags.new(
+      tags, valid_tag: /\A#*([-\w.\]\[]+)/
+    )
+    @documents.find_where(
+      query.first(config.embedding.model.context_length),
+      tags:,
+      prompt:         config.embedding.model.prompt?,
+      text_size:,
+      text_count:,
+      min_similarity:
+    )
+  end
+
+  # Reranks a set of records using the LLM with the `rerank` prompt.
+  #
+  # @param query [String] the original search query
+  # @param records [Array<Documentrix::Utils::TagResult>] candidate records
+  # @param prompt_name [String, nil] the prompt template to use for
+  #   reranking; defaults to `'rerank'`
+  # @return [Array<Documentrix::Utils::TagResult>] filtered records
+  def rerank_records(query, records, prompt_name: nil)
+    candidates = records.each_with_index.map { |r, i|
+      "[#{i}] #{truncate(r.text.strip, length: 300)}"
+    }.join("\n")
+
+    prompt_name ||= 'rerank'
+    rerank_prompt = prompt(prompt_name) or
+      raise 'missing prompt %s' % prompt_name.inspect
+    rerank_prompt = rerank_prompt.to_s
+      .named_placeholders_interpolate({ query:, candidates: })
+
+    begin
+      if response = generate(prompt: rerank_prompt).full?
+        indices = response.scan(/\d+/).map(&:to_i)
+          .select { |i| (0...records.size).include?(i) }
+        records = records.values_at(*indices) if indices.any?
+      end
+    rescue => e
+      log(:error, e, data: { context: 'rerank' })
+    end
+    records
+  end
+end