ollama_chat 0.0.93 → 0.0.95

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62fe4c92342045e9f11d60bd00e7772b8fee264c5c6736e967ce9fc8f09307c5
-  data.tar.gz: 07761b8ba1abdb1af75a9611e1191d9456e986d2af36304e7bf3b3c3a1840c58
+  metadata.gz: a5ae8b473c0dfaba1476f7890f8d1e04244db7f19c9dd9d563a845d9a5798a5f
+  data.tar.gz: 6e0f053ce8c5f9bbe97d5e04d3819fbee2ef9857f6b4c9d6bc4d76fe7e12dffa
 SHA512:
-  metadata.gz: 88cf61861b63250453b049b33fc3d0db341f73512be7a7f12d054259f9f530d7752850141a2a89d9050199cf78b4e4b531bf01f5cc072e53a790efbdf0d187cf
-  data.tar.gz: ad0a856f65ce7696bf2479ef544e3e7ceac757087e4b139152a8c3d13f5ece9b44ee503fa689005976cdc0f12a76ea2d3cf6aa43dbfd3a9e39f5830ec18f0d07
+  metadata.gz: 9e514fe65a9e3ccddef894cfe92fdff0e17a1c9ca639994ab54edcd573b219cca6c50774640cd966e8adc4d3232071abacc193c8dd795f9ed6be6460109b62df
+  data.tar.gz: 681c439ba46ee38cce5201696e40dda4dc6f6d2291c505e420c7fa2d63899ffd0e82068e94c6f8509f170e6843480924c969730c328a3c6a92b00702115de994

data/CHANGES.md

@@ -1,5 +1,80 @@
 # Changes
 
+## 2026-06-29 v0.0.95
+
+### New Features & Enhancements
+
+- **PNG Metadata Extraction**:
+    - Implemented `OllamaChat::Utils::PNGMetadataExtractor` to support
+      extraction of characters, prompts, and workflows from `tEXt` chunks.
+    - Added support for Automatic1111 Stable Diffusion WebUI parameters via
+      `parse_a1111_parameters`.
+    - Consolidated metadata extraction logic into a new `parse_png` method
+      within `OllamaChat::Parsing`.
+    - Introduced `OllamaChat::Utils::UTF8Converter` to ensure safe UTF-8
+      encoding across the system.
+- **Tool Improvements**:
+    - Enhanced the `roll_dice` tool by adding a human-readable `message` field
+      to its JSON output and increasing the `result_display_timeout` in
+      `default_config.yml`.
+- **Command Interface**:
+    - Overhauled help texts for numerous commands (including `/model`,
+      `/system`, `/tools`, `/session`, `/prompt`, and `/persona`) using
+      squiggly heredocs for better formatting and clarity.
+    - Added comprehensive YARD documentation to the `OllamaChat::Commands`
+      module.
+
+### Bug Fixes & Refactoring
+
+- **Stability & Logic**:
+    - Updated `OllamaChat::InputContent#all_file_set` to filter out directories
+      using `.select(&:file?)` and return a `Set`.
+    - Improved session name validation in
+      `lib/ollama_chat/session_management.rb` by replacing `.nil?` with
+      `.blank?`.
+    - Added `io.rewind` within an `ensure` block in the PNG extraction logic to
+      prevent read errors.
+- **Cleanup**:
+    - Removed the unused `json` dependency from `compute_bmi`.
+    - Removed the `PATCH_TOOL` definition and its corresponding documentation
+      in `README.md`.
+    - Pruned redundant convenience methods `extract_prompt` and
+      `extract_workflow` from `OllamaChat::Utils::PNGMetadataExtractor`.
+
+### Documentation & CI
+
+- **README Updates**:
+    - Expanded the available tools table to include `delete_file`, `move_file`,
+      `eval_ruby`, `get_ghr`, and `get_jira_issue`.
+    - Refined descriptions for the **Knowledge** category, specifically
+      distinguishing between `retrieve_document_snippets` and `file_context`.
+- **CI/CD**:
+    - Optimized dependency installation in `.all_images.yml` by replacing
+      `getconf _NPROCESSORS_ONLN` with `nproc` for better parallel job
+      compatibility.
+
+## 2026-06-22 v0.0.94
+
+### Added
+
+- Created a `LICENSE` file and updated the `README.md` to include a link to the
+  MIT license.
+- Added comprehensive test coverage for tool calling in
+  `spec/ollama_chat/tool_calling_spec.rb`.
+
+### Changed
+
+- Improved tool calling logic by utilizing the `tools_support` reader and
+  ensuring allowed paths are indexed by string keys via `.to_s`.
+- Synchronized search feedback prompts across
+  `lib/ollama_chat/web_searching.rb`, `lib/ollama_chat/rag_handling.rb`, and
+  `lib/ollama_chat/state_selectors.rb` using the `%s` format specifier.
+- Updated usage examples in `lib/ollama_chat/utils/chooser.rb` to include the
+  `%s` specifier.
+- Updated prompt expectations in `spec/ollama_chat/state_selectors_spec.rb`.
+- Added `LICENSE` and `spec/ollama_chat/tool_calling_spec.rb` to the gem
+  specification files.
+
 ## 2026-06-21 v0.0.93
 
 ### Added
@@ -88,7 +163,7 @@
 
 - **Model Option Profiles**: Added support for model option profiles, including
   a new `profile` column in the database with a composite unique index on
-  `[:model_name, :profile]`. 
+  `[:model_name, :profile]`.
     - Enhanced `OllamaChat::ModelHandling` methods (`get_stored_model_options`,
       `store_model_options`) to support a `profile` parameter.
     - Implemented `choose_profile_for_model` for interactive profile selection.
@@ -104,20 +179,20 @@
 
 ### Enhancements & Refactoring
 
-- **Command Standardization**: 
+- **Command Standardization**:
     - Standardized the use of the `-e` flag for editing across multiple
       commands: `/input`, `/regenerate`, `/pipe`, `/output`, `/copy`, and
       `/paste`.
     - Replaced "Flags:" with "Options:" in help text for several chat commands.
     - Added a specific editor hook using `edit_text` for the `/input` command
       to allow editing imported content.
-- **Code Architecture**: 
+- **Code Architecture**:
     - Extracted all chat command definitions into a new separate module
       `OllamaChat::Commands` located in `lib/ollama_chat/commands.rb`.
     - Updated `OllamaChat::Chat` and the main library entry point to utilize
       this new module instead of inline definitions or
       `OllamaChat::CommandConcern`.
-- **Message Output**: 
+- **Message Output**:
     - Enhanced `OllamaChat::MessageOutput#pipe` and `#output` to accept an
       `edit` parameter.
     - Refactored `OllamaChat::MessageOutput#attempt_to_write_file` to receive
@@ -260,42 +335,42 @@
 ## 2026-04-02 v0.0.86
 
 - Updated `play_persona_prompt` in `lib/ollama_chat/personae_management.rb` to
-  include “(no need to read the file)” in the roleplay prompt template string.  
-- Added `optional: true` to the `/links` command in `lib/ollama_chat/chat.rb`.  
+  include “(no need to read the file)” in the roleplay prompt template string.
+- Added `optional: true` to the `/links` command in `lib/ollama_chat/chat.rb`.
 - Made the `edit` subcommand of `/revise` optional by adding `optional: true`
-  to its command definition in `lib/ollama_chat/chat.rb`.  
-- Added a `backup` subcommand for persona management:  
+  to its command definition in `lib/ollama_chat/chat.rb`.
+- Added a `backup` subcommand for persona management:
   - Updated the `:persona` command regex and completion options in
-    `lib/ollama_chat/chat.rb`.  
-  - Added a case handler to invoke the new `backup_persona` method.  
+    `lib/ollama_chat/chat.rb`.
+  - Added a case handler to invoke the new `backup_persona` method.
   - Implemented `backup_persona` in `lib/ollama_chat/personae_management.rb`
-    with YARD documentation.  
-  - Removed the redundant assignment `persona = persona` in `edit_persona`.  
+    with YARD documentation.
+  - Removed the redundant assignment `persona = persona` in `edit_persona`.
 - Fixed the rescue exception class name in the `use_model` block of
   `lib/ollama_chat/chat.rb`, changing from `OllamaChatError::UnknownModelError`
-  to `OllamaChat::UnknownModelError`.  
+  to `OllamaChat::UnknownModelError`.
 - Ensured float division for duration calculations in `FollowChat` by
   converting operands to float in the `eval_stats` method of
-  `lib/ollama_chat/follow_chat.rb`.  
+  `lib/ollama_chat/follow_chat.rb`.
 - Used `Pathname.new(file).expand_path.directory?` for tilde expansion in
-  directory checks in `lib/ollama_chat/parsing.rb`.  
-- Refactored command registration formatting in `lib/ollama_chat/chat.rb`.  
+  directory checks in `lib/ollama_chat/parsing.rb`.
+- Refactored command registration formatting in `lib/ollama_chat/chat.rb`.
 - Added YARD documentation to the `OllamaChat::CommandConcern::Command` class
-  in `lib/ollama_chat/command_concern.rb`.  
+  in `lib/ollama_chat/command_concern.rb`.
 - Removed the deprecated `-d` flag from the `/input` command in
-  `lib/ollama_chat/chat.rb`.  
-- Removed tag support from `parse_content`:  
+  `lib/ollama_chat/chat.rb`.
+- Removed tag support from `parse_content`:
   - Updated `OllamaChat::Chat` to call `parse_content` without expecting a
-    `tags` array.  
-  - Simplified handling of `@parse_content`.  
-  - Removed tag recognition logic from `OllamaChat::Parsing`.  
-  - Changed `parse_content` to return a single `String`.  
-  - Deleted tag‑specific example from the spec.  
-- Updated the `file_context` tool description for accuracy.  
-- Added an interactive loop to enable/disable tools:  
+    `tags` array.
+  - Simplified handling of `@parse_content`.
+  - Removed tag recognition logic from `OllamaChat::Parsing`.
+  - Changed `parse_content` to return a single `String`.
+  - Deleted tag‑specific example from the spec.
+- Updated the `file_context` tool description for accuracy.
+- Added an interactive loop to enable/disable tools:
   - Wrapped `enable_tool` and `disable_tool` in a `loop do` in
-    `lib/ollama_chat/tool_calling.rb`.  
-  - Modified `select_tools` to place `[EXIT]` at the start.  
+    `lib/ollama_chat/tool_calling.rb`.
+  - Modified `select_tools` to place `[EXIT]` at the start.
   - Handled user choice with `choose(select_tools)`
     and exited on `[EXIT]` or `nil`.
 
@@ -326,24 +401,24 @@
 ## 2026-03-26 v0.0.84
 
 - Added `OllamaChat::Utils::ValueFormatter` with helper `format_bytes` in
-  `lib/ollama_chat/utils/value_formatter.rb`.  
-    - Added `require 'ollama_chat/utils/value_formatter'` where needed.  
+  `lib/ollama_chat/utils/value_formatter.rb`.
+    - Added `require 'ollama_chat/utils/value_formatter'` where needed.
     - Updated `write_file`, `patch_file`, `paste_from_clipboard` to use
-      `format_bytes` for byte‑size messages.  
+      `format_bytes` for byte‑size messages.
 - Implemented new tool `RetrieveDocumentSnippets` in
   `lib/ollama_chat/tools/retrieve_document_snippets.rb` and its spec
-  `spec/ollama_chat/tools/retrieve_document_snippets_spec.rb`.  
+  `spec/ollama_chat/tools/retrieve_document_snippets_spec.rb`.
     - Updated `default_config.yml` to enable `retrieve_document_snippets` by
-      default.  
+      default.
 - Rewrote tool payloads to include a `message` key for `browse`, `search_web`,
-  `paste_from_clipboard`, `resolve_tag`, and others.  
-- `browse` now returns `"Opened \"<url>\" in browser."` or a failure message.  
+  `paste_from_clipboard`, `resolve_tag`, and others.
+- `browse` now returns `"Opened \"<url>\" in browser."` or a failure message.
 - Refactored `confirm?` in `lib/ollama_chat/dialog.rb` to accept keyword `yes:`
   for a confirmation regex and display a coloured emoji matching the response
-  or timeout/default.  
-    - Updated all calls to `confirm?` to use `yes: /\Ay/i` syntax.  
+  or timeout/default.
+    - Updated all calls to `confirm?` to use `yes: /\Ay/i` syntax.
     - Updated `lib/ollama_chat/message_output.rb` to add `yes:` keyword to
-      `confirm?` calls and refine the emoji shown when a file already exists.  
+      `confirm?` calls and refine the emoji shown when a file already exists.
 
 ## 2026-03-24 v0.0.83
 
@@ -365,13 +440,13 @@
 ## 2026-03-21 v0.0.82
 
 - Add a `before` block setting `OC::OLLAMA::CHAT::TOOLS::CTAGS_TOOL` to `ctags`
-  in the `resolve_tag` spec.  
+  in the `resolve_tag` spec.
 - Updated `OllamaChat::Tools::PasteIntoEditor` description to use `text`
   instead of `string` and clarified that no file or line is required when
-  pasting into the editor.  
+  pasting into the editor.
 - Added bell and question mark emojis to various `confirm?` and `ask?` prompts
-  across multiple modules for clearer UX.  
-- Updated prompt string to `⏎  Press …` for better display.  
+  across multiple modules for clearer UX.
+- Updated prompt string to `⏎  Press …` for better display.
 - Enhanced `OllamaChat::Tools::ResolveTag` and `OllamaChat::Utils::TagResolver`
   with a new `kinds` method, updated `kind` parameter description, refactored
   `kind_of`, and fixed tag‑parsing regex to capture all columns.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Florian Frank
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -42,7 +42,6 @@ The following environment variables can be used to configure behavior:
 - `OLLAMA_CHAT_TOOLS_TEST_RUNNER` - Configured test runner for `run_tests` (default: `rspec`)
 - `OLLAMA_CHAT_TOOLS_CTAGS_TOOL` - Path to the ctags tool
 - `OLLAMA_CHAT_TOOLS_TAGS_FILE` - Location of the tags file
-- `OLLAMA_CHAT_TOOLS_PATCH_TOOL` - Patch tool to use
 - `OLLAMA_CHAT_TOOLS_JIRA_URL` - Base URL for Jira instance
 - `OLLAMA_CHAT_TOOLS_JIRA_USER` - Username for Jira authentication
 - `OLLAMA_CHAT_TOOLS_JIRA_API_TOKEN` - API token for Jira authentication
@@ -253,14 +252,19 @@ context, manipulate files, and retrieve external information.
 
 | Category | Tools | Description |
 | :--- | :--- | :--- |
-| **Filesystem** | `read_file`, `write_file`, `patch_file`, `directory_structure`, `execute_grep` | Read, write, and search files within allowed directories. |
-| **Ruby/Dev** | `resolve_tag`, `execute_ri`, `gem_path_lookup`, `run_tests` | Introspect Ruby code, check documentation, and run test suites. |
-| **Web/External** | `search_web`, `get_url`, `browse`, `get_rfc`, `get_cve`, `get_endoflife` | Access the internet, fetch specific URLs, and look up technical standards. |
+| **Filesystem** | `read_file`, `write_file`, `patch_file`, `delete_file`, `move_file`, `directory_structure`, `execute_grep` | Read, write, and search files within allowed directories. |
+| **Ruby/Dev** | `resolve_tag`, `execute_ri`, `gem_path_lookup`, `run_tests`, `eval_ruby` | Introspect Ruby code, check documentation, and run test suites. |
+| **Web/External** | `search_web`, `get_url`, `browse`, `get_rfc`, `get_cve`, `get_endoflife`, `get_ghr`, `get_jira_issue` | Access the internet, fetch specific URLs, and look up technical standards. |
 | **System/Util** | `get_time`, `get_location`, `get_current_weather`, `generate_password`, `compute_bmi`, `roll_dice` | General utility functions for time, location, and simple calculations. |
 | **Editor/Clip** | `copy_to_clipboard`, `paste_from_clipboard`, `paste_into_editor`, `open_file_in_editor` | Bridge the gap between the chat and the system clipboard or editor. |
-| **Knowledge** | `retrieve_document_snippets` | Search through project-specific documentation collections. |
+| **Knowledge** | `retrieve_document_snippets`, `file_context` | Semantic search for specific snippets vs. broad retrieval of structured project context. |
 | **Multimodal** | `generate_image` | Generate images via a local ComfyUI server. |
 
+***Note on Knowledge Tools**: Use `retrieve_document_snippets` for precise,
+low-token semantic discovery and `file_context` for a comprehensive view of
+modules or patterns. Be cautious with broad patterns in `file_context`, as
+importing too many files can exceed the LLM's context window.*
+
 ## Download
 
 The homepage of this app is located at
@@ -273,4 +277,4 @@ The homepage of this app is located at
 
 ## License
 
-This software is licensed under the <i>MIT</i> license.
+This software is licensed under the [MIT License](./LICENSE).

data/lib/ollama_chat/chat.rb

@@ -69,6 +69,7 @@ class OllamaChat::Chat
   include OllamaChat::PromptManagement
   include OllamaChat::Utils::Chooser
   include OllamaChat::Utils::ValueFormatter
+  include OllamaChat::Utils::UTF8Converter
 
   # Initializes a new OllamaChat::Chat instance with the given command-line
   # arguments.

data/lib/ollama_chat/commands.rb

@@ -1,5 +1,24 @@
 require 'ollama_chat/command_concern'
 
+# Namespace for all available slash commands within the Ollama Chat
+# application.
+#
+# This module acts as a central repository where various functional commands
+# are declared using the DSL provided by {OllamaChat::CommandConcern}. Each
+# command definition includes a unique name, a triggering regular expression,
+# and a help string for documentation.
+#
+# The commands are categorized into several areas:
+# - Clipboard management (/copy, /paste)
+# - Application settings (/config, /document policy, /toggle)
+# - Model & System Prompt configuration (/model, /system, /think)
+# - Tooling support (/tools)
+# - Session management (/session)
+# - Conversation history and manipulation (/list, /last, /drop, /clear, /regenerate)
+# - RAG collection management (/collection)
+# - Persona & Character roleplay (/persona, /character)
+# - Input/Output operations (/compose, /web, /input, /pipe, /vim, /output)
+# - System actions and info (/reconnect, /quit, /info, /help)
 module OllamaChat::Commands
   include OllamaChat::CommandConcern
 
@@ -65,7 +84,11 @@ module OllamaChat::Commands
     name: :toggle,
     regexp: %r(^/toggle(?:\s+(markdown|stream|location|runtime_info|voice|think_loud|think_strip))?$),
     complete: [ 'toggle', %w[ markdown stream location runtime_info voice think_loud think_strip embedding ] ],
-    help: 'Toggle feature switches (markdown, stream, location, runtime_info, voice, think_loud, think_strip, embedding)'
+    help: <<~EOT
+      Toggle feature switches
+      (markdown, stream, location, runtime_info,
+      voice, think_loud, think_strip, embedding)
+    EOT
   ) do |toggle_name|
     if toggle_name
       send(toggle_name).toggle
@@ -90,7 +113,10 @@ module OllamaChat::Commands
     name: :favourite,
     regexp: %r(^/favourite(?:\s+(add|delete))?(?:\s+(model|prompt|system_prompt|persona))$),
     complete: [ 'favourite', %w[ add delete ], %w[ model prompt system_prompt persona ] ],
-    help: 'Manage favorites for models, prompts, and personas (add, delete)'
+    help: <<~EOT
+      Manage favorites for models, prompts,
+      and personae (add, delete)
+    EOT
   ) do |subcommand, type|
     case subcommand
     when 'add'
@@ -106,8 +132,18 @@ module OllamaChat::Commands
     regexp: %r(^/model(?:\s+(change|options|options from session|options to session))(?:\s+(-p\s*\w+))?$),
     complete: [ 'model', %w[ change options options\ from\ session options\ to\ session ] ],
     help: <<~EOT
-      Change the model or manage model options (change, options, options from
-      session, options to session)
+      Manage AI models and configurations:
+        - change: Switch the active model
+                  (-p [profile] for specific
+                   settings)
+        - options: Edit the configuration
+                   of a saved profile
+        - options from session: Save current
+                  live settings into a profile
+                  (Live → Saved)
+        - options to session: Apply a saved
+                  profile's settings to this
+                  session (Saved → Live)
     EOT
   ) do |subcommand, opts|
     case subcommand
@@ -138,8 +174,18 @@ module OllamaChat::Commands
     complete: [ 'system', %w[ change info edit add delete list duplicate export import reset ] ],
     optional: true,
     help: <<~EOT
-      Manage the system prompt (change, info, edit, add, delete, list, duplicate,
-      export, import, reset)
+      Manage the system prompt and its
+       configurations.
+       Subcommands: add, change, delete,
+         duplicate, edit, export, import,
+         info, list, reset.
+       Note: 'duplicate' allows you to clone
+         an existing system prompt as a
+         template for further modification,
+         while 'export' and 'import' handle
+         portability via external files. Use
+         'reset' to restore the default
+         system prompt settings.
     EOT
   ) do |subcommand, filename|
     case subcommand
@@ -193,7 +239,14 @@ module OllamaChat::Commands
     regexp: %r(^/tools(?:\s+(on|off|enable|disable))?),
     complete: [ 'tools', %w[ on off enable disable ] ],
     optional: true,
-    help: 'Manage tool support and enabled tools (on, off, enable, disable)'
+    help: <<~EOT
+      Manage tool support:
+        - (no subcommand): List all available tools
+        - on: Activate tool support globally
+        - off: Deactivate tool support globally
+        - enable: Interactively enable a specific tool
+        - disable: Interactively disable a specific tool
+    EOT
   ) do |subcommand|
     case subcommand
     when nil
@@ -226,11 +279,26 @@ module OllamaChat::Commands
     regexp: %r(^/session(?:\s+(change|previous|list|new|duplicate|rename|summarize|delete|model options change|model options))?((?:\s+-(?:[sf]|p\s*\w+))*)(?:\s+(.+))?$),
     complete: [ 'session', %w[ change previous list new duplicate rename summarize delete model\ options\ change model\ options ] ],
     optional: true,
-    options: '[-s|-f|-p profile] [name]',
+    options: "[-s|-f|-p profile]\n[name]",
     help: <<~EOT
-      Manage chat sessions (change, previous, list, new, duplicate, rename, summarize,
-      delete, model options).
-      For summarize: -s (single sentence), -f (output to markdown file)
+      Manage chat sessions:
+        - list: List all available sessions
+        - new: Create a new session
+        - delete: Delete a session
+        - rename: Rename a session
+        - duplicate: Duplicate a session
+        - change [name]: Switch to a specific
+          session
+        - previous: Return to the previous
+          session
+        - summarize: Create a conversation
+          summary with
+          - -s: Output as single sentence
+          - -f: Save output to markdown file
+        - model options: Edit AI settings
+          for the current session
+        - model options change: Update session
+          settings from a profile
     EOT
   ) do |subcommand, opts, name|
     case subcommand
@@ -309,7 +377,9 @@ module OllamaChat::Commands
     options: '[-t|-s|n=1]',
     help: <<~EOT
       List the last n or all conversation exchanges.
-      Options: -t (force show thinking), -s (suppress thinking).
+      Options:
+        -t (force show thinking),
+        -s (suppress thinking).
     EOT
   ) do |opts,number|
     opts = go_command('ts', opts.to_s)
@@ -330,9 +400,11 @@ module OllamaChat::Commands
     regexp:  %r(^/last((?:\s+(?:-[pts]))*)(?:\s+(\d*))?$),
     options: '[-p|-t|-s|n=1]',
     help:    <<~EOT
-      Show the last n or the most recent system/assistant message.
-      Options: -p (plain output, no pager), -t (force show thinking),
-      -s (suppress thinking).
+      Show the last n or the most recent
+        system/assistant message.
+      Options: -p (plain output, no pager),
+        -t (force show thinking),
+        -s (suppress thinking).
     EOT
   ) do |opts,number|
     opts = go_command('pts', opts.to_s)
@@ -390,7 +462,8 @@ module OllamaChat::Commands
     regexp: %r(^/regenerate(\s+-e)?\s*$),
     help: <<~EOT
       Regenerate the last response.
-      Options: -e to edit the user message before regenerating.
+      Options: -e to edit the user message
+        before regenerating.
     EOT
   ) do |opts|
     opts = go_command('e', opts)
@@ -412,9 +485,15 @@ module OllamaChat::Commands
     complete: [ 'prompt', %w[ edit info add delete list duplicate import export reset suggest ] ],
     optional: true,
     help: <<~EOT,
-      Manage preset prompt templates or prefill the prompt (edit, info, add,
-      delete, list, duplicate, import, export, reset, suggest)
-      Options: -e to edit the next prompt instead of prefilling
+      Manage preset prompt templates or prefill the prompt.
+      Subcommands: edit, info, add, delete, list, duplicate,
+        import, export, reset.
+      Special: 'suggest' uses session history and a strategy
+        to AI-generate tailored prompts for you to refine, see
+        prompts `suggest_coding` or `suggest_roleplaying` for
+        predefined examples.
+      Options: -e to edit the next prompt
+        instead of prefilling
     EOT
   ) do |opts, subcommand, filename|
     case subcommand
@@ -477,7 +556,10 @@ module OllamaChat::Commands
     regexp: %r(^/conversation\s+(save|load)((?:\s+-(?:[c]))*)\s+(.+)$),
     complete: [ 'conversation', %w[ save load ] ],
     options: '[-c]',
-    help: 'Load conversations or save conversations (-c to clean first)'
+    help: <<~EOT
+      Load conversations or
+      save conversations (-c to clean first)
+    EOT
   ) do |subcommand,opts,path|
     opts = go_command('c', opts.to_s)
     case subcommand
@@ -497,8 +579,10 @@ module OllamaChat::Commands
     complete: [ 'collection', %w[ change clear list rename update ] ],
     optional: true,
     help: <<~EOT
-      Manage the current RAG document collection: change, clear, list,
-      rename, update and show
+      Manage the current RAG document collection:
+      - change, clear, list, rename: Basic management
+      - update: Re-index only modified documents
+      - (no subcommand): Show current collection stats
     EOT
   ) do |subcommand|
     case subcommand
@@ -526,8 +610,23 @@ module OllamaChat::Commands
     complete: [ 'persona', %w[ play load edit info list add delete backup import export duplicate ] ],
     optional: true,
     help: <<~EOT,
-      Manage and activate personas for roleplay (play, load, edit, info, list,
-      add, delete, backup, import, export, duplicate)
+      Manage and activate personae for roleplay:
+        - Activation:
+          - play: Set the default persona
+                  and start roleplaying
+          - load: Load a specific persona
+                  into session
+        - Management:
+          - add: Create a new persona
+          - edit: Modify an existing persona
+          - delete: Remove a persona
+          - duplicate: Create a copy of a persona
+          - list: Browse all available personae
+          - info: View details of a specific persona
+        - Portability:
+          - backup: Save current personae to disk
+          - export: Export a specific persona to file
+          - import: Load a persona from a markdown file
     EOT
   ) do |subcommand|
     disable_content_parsing
@@ -581,7 +680,10 @@ module OllamaChat::Commands
     name: :character,
     regexp: %r(^/character(?:\s+(info|load|import))(?:\s+(\S+))?$),
     complete: [ 'character', %w[ info load import ] ],
-    help: 'Display character info, load or import a character from JSON/PNG as persona'
+    help: <<~EOT
+      Display character info, load or import a character
+      from JSON/PNG as persona
+    EOT
   ) do |subcommand, path|
     path = if path
              Pathname.new(path)
@@ -601,7 +703,7 @@ module OllamaChat::Commands
              path.read
            when '.png'
              path.open do |io|
-               OllamaChat::Utils::PNGCharacterExtractor.extract_character_json(io)
+               OllamaChat::Utils::PNGMetadataExtractor.extract_character(io)
              end
            else
              STDERR.puts "Only json and png characters are supported!"
@@ -659,17 +761,24 @@ module OllamaChat::Commands
     complete: [ 'input', %w[ path context embedding summary ] ],
     options: "[\n  -w|-a|-p|-e|\n  -c <collection>|\n  -t <tags>\n]\n[arg…]",
     help: <<~EOT
-      Import content from files, URLs, or globs into the context
-      Use subcommands: path, context, embedding, summary,
-        import (the default).
+      Import content from files, URLs,
+        or globs into the context
+      Use subcommands: path, context, embedding,
+        summary, import (the default).
       Options:
-        -p enable pattern mode to allow using globs/wildcards)
-        -w <words> summary subcommand only (default 100)
-        -a pattern mode only, include all files for patterns
-        -c <collection> use this collection (embedding subcommand only)
-        -t <tag1,tag2,…> the custom tags to appy (embedding subcommand only)
-        -e edit content before importing, only standard command and path with
-           single source are supported.
+        -p enable pattern mode to allow
+           using globs/wildcards
+        -w <words> summary subcommand only
+           (default 100)
+        -a pattern mode only,
+           include all files for patterns
+        -c <collection> use this collection
+           (embedding subcommand only)
+        -t <tag1,tag2,…> the custom tags
+           to apply (embedding subcommand only)
+        -e edit content before importing,
+           only standard command and path
+           with single source are supported.
     EOT
   ) do |input_mode,opts,arg|
     disable_content_parsing
@@ -834,7 +943,13 @@ module OllamaChat::Commands
     regexp: %r(^/info(?:\s+(session|model|runtime|rag))?$),
     complete: [ 'info', %w[ session model runtime rag ] ],
     optional: true,
-    help: 'Show info about the session, model, runtime, or RAG',
+    help: <<~EOT,
+      Show info:
+        - session: Details of the current chat session
+        - model: Information about the active AI model
+        - runtime: System and environmental data
+        - rag: Status of the RAG document system
+    EOT
   ) do |subcommand|
     use_pager do |output|
       case subcommand
@@ -858,7 +973,10 @@ module OllamaChat::Commands
     regexp: %r(^/help(?:\s+(\S+))?$),
     optional: true,
     complete: [ 'help', %w[ me ] ],
-    help: 'View the help menu (use \'me\' for AI help or a pattern to filter)'
+    help: <<~EOT
+      View the help menu
+      (use 'me' for AI help or a pattern to filter)
+    EOT
   ) do |subcommand|
     case subcommand
     when 'me'

data/lib/ollama_chat/information.rb

@@ -180,8 +180,6 @@ module OllamaChat::Information
   # ollama_chat instance.
   #
   # @param output [IO] the output stream to write the information to, defaults to STDOUT
-  # @return [ nil ] This method does not return a value; it outputs information
-  #   directly to standard output.
   def info(output: STDOUT)
     output.puts "💎 Running ollama_chat version: #{bold{OllamaChat::VERSION}}"
     output.puts "🔌 Connected to ollama server version: #{bold{server_version}} on: #{bold{server_url}}"
@@ -205,8 +203,6 @@ module OllamaChat::Information
   #
   # @param pattern [String, Regexp, nil] An optional pattern to filter
   #   the commands displayed in the help message.
-  # @return [ nil ] This method always returns nil after printing the help
-  #   message.
   def display_chat_help(pattern = nil)
     use_pager do |output|
       output.puts help_message(pattern)

data/lib/ollama_chat/input_content.rb

@@ -127,7 +127,7 @@ module OllamaChat::InputContent
       end
       files.merge(Pathname.glob(pattern))
     end
-    files.map(&:expand_path)
+    files.map(&:expand_path).select(&:file?).to_set
   end
 
   # The provide_file_set_content method collects content from a set of files