ollama_chat 0.0.115 → 0.0.117

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18297e3bbf39619c1721b30fdf4f691a2a71b1e15994c2ae28ced14eb7f76c57
-  data.tar.gz: 1481131a053ef2d9390456c84e9d58bf0890d1ded23eafb5d15c4b1b70babb99
+  metadata.gz: cbe0a034dee8079ea14e573b0e98624ebaa3311baaf60e1bd666d7f7b0d61dda
+  data.tar.gz: 2a2b0c1b00ce5db2fa4b20660d8cda86669f1bac50e62352a07953e0c327d863
 SHA512:
-  metadata.gz: 6ec5d58d329bb3b8a25ccdb0ce55cb04be29f5e8b22e2b3f7aa8ce77bfe49cf56d33c6c198c63431b4ccca9e78029887fe221be1effa5306d4aef464fe530fd9
-  data.tar.gz: ec410eb4d78a5688cb4b67bec44a3600a8e295578bb9375142957577b92d03c5ae0ada7f0e4f7841b70ed40c9dea8e6f1acc688d76abc6ba4d156c550cbf3324
+  metadata.gz: f187ae33f48c198b1aa15d680b5d7dd45e96c8ba7bcb71bf80adf5d0cb049a766d79d57d8bad32175363c490cfe94a94908b1eba4a1ba28a8b0e9896065079ed
+  data.tar.gz: 0d61b926d6e7018d5f21d52ed06d36e81ea859dc5f288a0247834def14245813f1306bf444baaf715c8ec37df20ea64d97f03279045e34eb669a29c9facadb23

data/CHANGES.md

@@ -1,5 +1,107 @@
 # Changes
 
+## 2026-09-03 v0.0.117
+
+*   Fixed `/favourite` subcommand completion rendering by replacing separate
+    `add`/`delete` and type arrays in `complete` with `.product`, ensuring each
+    subcommand renders as an explicit pair (e.g., `add model`, `delete
+    persona`) instead of being independently cross-multiplied by `arguments`.
+*   Added command categories to help output:
+    *   Added `category(name)` and `current_category` class methods to
+        `command_concern.rb` for tracking the active category during
+        registration.
+    *   Added `category:` keyword to `command` and `Command#initialize` with
+        `attr_reader :category`.
+    *   Reworked `help_message` to sort commands by `[category, name]` and
+        insert bold full-width category header rows via `colspan: 4`.
+    *   Added `extend Term::ANSIColor` to the `included` block for `bold{}`
+        access.
+    *   Replaced `## Section` comments in `commands.rb` with `category
+        :Section` calls.
+    *   Added two new categories: `Models` (`/model`, `/think`) and `Prompts`
+        (`/prompt`, `/system`, `/suggest`).
+    *   Moved session-persisted commands (`/toggle`, `/tools`, `/voice`,
+        `/document_policy`, `/context_format`) under `category :Session`.
+    *   Moved `/change_response` and `/conversation` under `category
+        :Conversation`.
+    *   Reduced `Settings` to app-level commands only (`/config`,
+        `/favourite`).
+*   Made `report_session` a pure generator:
+    *   Removed `&block` parameter and `block&.(result)` call from
+        `report_session`, eliminating the infobar side-effect that caused
+        double output.
+    *   Simplified `report_conversation` to call `report_session(name:)`
+        without a block; display logic (pager or file write) is the sole
+        consumer of the returned string.
+    *   Removed `@param block [Proc]` from `report_session` YARD docs.
+
+## 2026-09-03 v0.0.116
+
+### Added
+
+* `session.roleplay_story` prompt in `default_config.yml` for narrative
+  retelling of roleplay sessions via `/conversation report`.
+* `session.coding_brief` prompt in `default_config.yml`.
+* `summarize` and `report` subcommands to `/conversation`.
+* `summarize_conversation(sentence:, save:)` and `report_conversation(name:,
+  save:)` methods in `session_management.rb` to handle filename prompts,
+  overwrite checks, and I/O.
+* `report_session(name:, &block)` method using `messages.compacted_messages` to
+  keep interpolated content bounded after compaction.
+* `Status:` line with `✅`/`⛔` indicators to `collection_stats` in
+  `information.rb`.
+* `✅`/`⛔` prefixes to `list_collections` in `rag_handling.rb` to replace
+  `[DISABLED]` text suffixes.
+* `✅`/`⛔` indicators for enabled/disabled states and `❔`/`⭕` for
+  confirmation requirements in `list_tools` in `tool_calling.rb`.
+* `ask_for_filename?(action:)` and `should_overwrite?(filename)` helpers in
+  `dialog.rb` with YARD documentation.
+* Specs for `summarize_conversation`, `report_session`, and
+  `report_conversation` in `session_management_spec.rb`.
+* Routing specs for `/conversation summarize` and `/conversation report` in
+  `commands_spec.rb`.
+* YARD documentation for `repair_group_uuids`.
+
+### Changed
+
+* Moved `summarize` subcommand from `/session` to `/conversation`.
+* Reworked compaction prompt to a draft-rewrite model, treating previous
+  summaries as drafts to be rewritten rather than ambient context.
+* Replaced "6-12 sentences" constraint in compaction prompt with "Be concise;
+  skip filler and repetition".
+* Changed `assemble: |-` to `assemble: |` in compaction prompt to preserve
+  trailing newlines.
+* Widened factuality scope in compaction prompt to include "groups or previous
+  summary above".
+* Wrapped `list_tools` body in `use_pager`, redirecting writes through the
+  yielded `output` IO.
+* Passed `output:` keyword argument to `tools_support.show(output:)`.
+* Replaced inline `File.exist?` and `confirm?` blocks in
+  `conversation.rb#save_conversation`,
+  `message_output.rb#attempt_to_write_file`, `session_management.rb`, and
+  `file_editing.rb#determine_valid_output_filename` with the shared
+  `should_overwrite?` helper.
+* Updated `chat_spec.rb` `collection_stats` regex to include the new `Status:
+  ✅` line.
+* Updated `tool_calling_spec.rb` `list_tools` regex to use `✅`/`⛔` instead of
+  `✓`/`☐`.
+* Updated `tool_calling_spec.rb` `#list_tools` example to stub `use_pager` with
+  a `StringIO` yield.
+* Updated `conversation_spec.rb` expectations for `Pathname` type and
+  `should_overwrite?` STDERR output.
+* Updated comment in `lib/ollama_chat/prompt_management.rb` to reflect new
+  naming convention for prompt templates (e.g., `suggest.coding`).
+* Rewrapped `prompts.suggest.roleplaying` few-shot examples to stay within 80
+  columns in `default_config.yml`.
+* Fixed stale YARD example in `session_management.rb#report_session`
+  (`roleplay_report` to `roleplay_story`).
+
+### Removed
+
+* `pretty:` keyword argument from `summarize_session` and
+  `summarize_conversation`; markdown formatting is now the only path.
+* `%{message_thinking}` from the `session_summarize` prompt.
+
 ## 2026-09-01 v0.0.115
 
 *   Added `OllamaChat::Tools::ExecuteShell` in

data/lib/ollama_chat/command_concern.rb

@@ -11,6 +11,20 @@ module OllamaChat::CommandConcern
     #   `Command` instances.
     attr_accessor :commands
 
+    # @return [Symbol] the category currently in effect for new commands
+    def current_category
+      (@category || :Misc).to_sym
+    end
+
+    # Set the category that subsequent `command` registrations will be
+    # assigned to. Commands registered without an explicit `category:`
+    # keyword inherit the current category (defaults to `:Misc`).
+    #
+    # @param name [String, Symbol] the category name
+    def category(name)
+      @category = name.to_sym
+    end
+
     # Register a new command.
     #
     # @param name [String, Symbol] The primary name of the command.
@@ -24,17 +38,19 @@ module OllamaChat::CommandConcern
     # @param options [String, nil] A string describing command options
     #   for help output.
     # @param help [String, nil] Short help text for the command.
+    # @param category [Symbol] Category for grouping in help output
+    #   (defaults to `current_category`).
     # @yield [context] Block that receives a binding context for
     #   execution.  The block must be provided.
     #
     # @raise [ArgumentError] if a command with the same name already
     #   exists or if no block is given.
-    def command(name:, regexp:, complete: nil, optional: false, options: nil, help: nil, &block)
+    def command(name:, regexp:, complete: nil, optional: false, options: nil, help: nil, category: current_category, &block)
       name = name.to_sym
       commands.key?(name) and
         raise ArgumentError, "command #{name} already registered!"
-      commands[name] =Command.new(
-        name:, regexp:, complete:, optional:, options:, help:, &block
+      commands[name] = Command.new(
+        name:, regexp:, complete:, optional:, options:, help:, category:, &block
       )
     end
 
@@ -52,15 +68,18 @@ module OllamaChat::CommandConcern
     #
     # @param pattern [String, Regexp, nil] An optional pattern to filter
     #   commands by their names.
-    # @return [Terminal::Table] A table with columns CMD, SUBCMD, OPTS, HELP.
+    # @return [Terminal::Table] A table with columns CMD, SUBCMD, OPTS, HELP,
+    #   with bold category header rows inserted between groups.
     def help_message(pattern = nil)
       table = Terminal::Table.new
       table.style = {
         all_separators: true,
         border:         :unicode_round,
       }
-      table.headings = %w[ CMD SUBCMD OPTS HELP ]
-      commands.each_value do |command|
+      table.headings  = %w[ CMD SUBCMD OPTS HELP ]
+      sorted_commands = self.commands.sort_by { [ _2.category, _2.name ] }.map(&:last)
+      cat             = nil
+      sorted_commands.each do |command|
         command.help or next
         if pattern
           command.command_names.any? { _1 =~ pattern } or next
@@ -72,6 +91,10 @@ module OllamaChat::CommandConcern
               [ _1, (?﹡ unless command.optional?) ].compact.join
             }.sort.join(?\n)
         }
+        if cat != command.category
+          cat = command.category
+          table << [ { value: bold{cat}, colspan: 4 } ]
+        end
         table << [
           "%s" % command.command_names.map { ?/ + _1 }.join(?\n),
           '%s' % subcommands,
@@ -91,6 +114,8 @@ module OllamaChat::CommandConcern
     delegate :command_completions, to: self
 
     delegate :help_message, to: self
+
+    extend Term::ANSIColor
   end
 
   # Represents a registered command in the OllamaChat command DSL.
@@ -117,13 +142,14 @@ module OllamaChat::CommandConcern
     # @param optional [Boolean] Whether the command is optional.
     # @param options [String, nil] Options description.
     # @param help [String] Help text.
+    # @param category [Symbol] Category for grouping in help output.
     # @yield [context] Execution block.
     #
     # @raise [ArgumentError] if no block is given.
-    def initialize(name:, regexp:, complete: nil, optional: false, options: nil, help:, &block)
+    def initialize(name:, regexp:, complete: nil, optional: false, options: nil, help:, category:, &block)
       block or raise ArgumentError, 'require &block'
-      @name, @regexp, @optional, @options, @help, @block =
-        name, regexp, optional, options, help, block
+      @name, @regexp, @optional, @options, @help, @category, @block =
+        name, regexp, optional, options, help, category, block
       @complete = Array(complete || name.to_s).map { Array(_1) }
     end
 
@@ -133,6 +159,9 @@ module OllamaChat::CommandConcern
     # @return [String] Help text for the command.
     attr_reader :help
 
+    # @return [Symbol] Category for grouping in help output.
+    attr_reader :category
+
     # @return [String, nil] Options description.
     attr_reader :options