ollama_chat 0.0.115 → 0.0.116

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18297e3bbf39619c1721b30fdf4f691a2a71b1e15994c2ae28ced14eb7f76c57
-  data.tar.gz: 1481131a053ef2d9390456c84e9d58bf0890d1ded23eafb5d15c4b1b70babb99
+  metadata.gz: beebfc1a29093b596fe008ba59b2f377922e2f7beeeb529ebed899fc374c6e02
+  data.tar.gz: e704bce9b15101283e802a6010ee08c347cf94d8fcdc2ee785da3880debde736
 SHA512:
-  metadata.gz: 6ec5d58d329bb3b8a25ccdb0ce55cb04be29f5e8b22e2b3f7aa8ce77bfe49cf56d33c6c198c63431b4ccca9e78029887fe221be1effa5306d4aef464fe530fd9
-  data.tar.gz: ec410eb4d78a5688cb4b67bec44a3600a8e295578bb9375142957577b92d03c5ae0ada7f0e4f7841b70ed40c9dea8e6f1acc688d76abc6ba4d156c550cbf3324
+  metadata.gz: 7cab4e5d47d97dd215e058ab9960ad8801252a2ab950d3b30ce1e514fad30b22e87f917e3b1764592070f385fcfec748cc3b59398cadf8e3553f41e6ec48e9bb
+  data.tar.gz: 0fb71bb0ab178cb1fed41ea2b257360fd19d3d180a2fc2f497d1372874d4665c3b82676ad8c056ab80a22e21e95deebb8afee8ef5f2809a07671e6cfb53ba5d7

data/CHANGES.md

@@ -1,5 +1,72 @@
 # Changes
 
+## 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/commands.rb

@@ -291,15 +291,14 @@ module OllamaChat::Commands
 
   command(
     name: :session,
-    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 ] ],
+    regexp: %r(^/session(?:\s+(change|previous|list|new|duplicate|rename|delete|model options change|model options))?((?:\s+-(?:p\s*\w+))*)(?:\s+([^-].*))?$),
+    complete: [ 'session', %w[ change previous list new duplicate rename delete model\ options\ change model\ options ] ],
     optional: true,
-    options: "[-s|-f|-p profile]\n[name]",
+    options: "[-p profile]\n[name]",
     help: <<~EOT
       💬 Manage sessions:
          - list/new/delete/rename/duplicate
          - change [name]/previous
-         - summarize (-s sentence, -f save to file)
          - model options/change
     EOT
   ) do |subcommand, opts, name|
@@ -316,44 +315,6 @@ module OllamaChat::Commands
       delete_session
     when 'rename'
       rename_session
-    when 'summarize'
-      opts = go_command('fs', opts)
-      if opts[?f] and
-        filename = switch_history(:filename) {
-          ask?(prompt: "❓ Enter filename: ")
-        }.full? { Pathname.new(_1) }
-      then
-        if filename.exist? && !confirm?(
-            prompt: "🔔 File #{filename.to_s.inspect} already exists, overwrite? (y/n) ",
-            yes: /\Ay/i
-          )
-        then
-          STDERR.puts "File not written!"
-          next :next
-        end
-        summary = summarize_session(pretty: true, sentence: opts[?s]) do |content|
-          infobar.puts kramdown_ansi_parse(content)
-        end
-        if summary.full?
-          filename.write(summary)
-          STDOUT.puts "File successfully written."
-          next :next
-        else
-          STDERR.puts "Nothing to summarize!"
-          next :next
-        end
-      end
-      summary = summarize_session(pretty: true, sentence: opts[?s]) do |content|
-        infobar.puts kramdown_ansi_parse(content) << ?\n
-      end
-      if summary.full?
-        use_pager do |output|
-          output.puts kramdown_ansi_parse(summary)
-        end
-      else
-        STDERR.puts "Nothing to summarize!"
-        next :next
-      end
     when 'change'
       change_session(name)
     when 'model options'
@@ -598,15 +559,16 @@ module OllamaChat::Commands
 
   command(
     name: :conversation,
-    regexp: %r(^/conversation\s+(clean|compact|save|load)(\s+-c)?(?:\s+([^-].*\.jsonl?))?$),
-    complete: [ 'conversation', %w[ save load clean compact ] ],
-    options: '[-c] [FILENAME]',
+    regexp: %r(^/conversation\s+(clean|compact|save|load|summarize|report)((?:\s+-(?:[sf]|c))*)(?:\s+([^-].*\.jsonl?))?$),
+    complete: [ 'conversation', %w[ save load clean compact summarize report ] ],
+    options: '[-s|-f|-c] [FILENAME]',
     help: <<~EOT
-      💾 Save/Load conversation state
-         (-c to clean before saving)
-         FILENAME ends with .json or .jsonl
-         Or clean inplace (removes tool content, images, and thinking)
-         Or compact (summarize old messages, keep recent)
+      💾 Manage conversation content:
+         - save/load: Export/import as .json or .jsonl
+         - clean: Remove tool content, images, thinking
+         - compact: Summarize old messages, keep recent
+         - summarize: Per-message narrative (-s sentence, -f save)
+         - report: Generate a session report document
     EOT
   ) do |subcommand,opts,path|
     if %w[ save load ].include?(subcommand) && path.blank?
@@ -642,6 +604,12 @@ module OllamaChat::Commands
       else
         STDOUT.puts 'Cancelled.'
       end
+    when 'summarize'
+      opts = go_command('sf', opts)
+      summarize_conversation(save: opts[?f], sentence: opts[?s])
+    when 'report'
+      opts = go_command('f', opts)
+      report_conversation(save: opts[?f])
     end
     :next
   end

data/lib/ollama_chat/conversation.rb

@@ -26,12 +26,8 @@ module OllamaChat::Conversation
   # @example Save conversation with explicit filename
   #   chat.save_conversation('conversations/2023-10-15_my_session.json')
   def save_conversation(filename, clean: false)
-    if File.exist?(filename)
-      confirm?(
-        prompt: "🔔 File #{filename.to_s.inspect} already exists, overwrite? (y/n) ",
-        yes: /\Ay/i
-      ) or return
-    end
+    filename = Pathname.new(filename)
+    should_overwrite?(filename) or return
     if messages.save_conversation(filename, messages: clean ? messages.clean_messages : messages.messages)
       STDOUT.puts "Saved conversation to #{filename.to_s.inspect}."
     else

data/lib/ollama_chat/dialog.rb

@@ -149,4 +149,38 @@ module OllamaChat::Dialog
   def go_command(s, opt, defaults: {})
     Tins::GO.go(s, opt.to_s.strip.split(/\s+/), defaults:)
   end
+
+  # Prompts the user for a filename with history support.
+  #
+  # @param action [String, nil] an optional action descriptor appended to the
+  #   prompt, e.g. "for summarization" ("❓ Enter filename for summarization…")
+  #
+  # @return [Pathname, nil] the user-supplied filename as a Pathname, or nil
+  #   if the user cancels (C-c) or provides empty input
+  def ask_for_filename?(action: nil)
+    action and action = " #{action}"
+    switch_history(:filename) {
+      ask?(prompt: "❓ Enter filename#{action}, C-c ⇒ cancel: ")
+    }.full? { Pathname.new(_1) }
+  end
+
+  # Checks whether a file can be written, prompting for overwrite
+  # confirmation if the file already exists.
+  #
+  # @param filename [Pathname] the target file to check
+  #
+  # @return [Boolean] `true` if the file does not exist or the user confirms
+  #   overwriting; `false` if the file exists and the user declines
+  def should_overwrite?(filename)
+    if filename.exist? && !confirm?(
+        prompt: "🔔 File #{filename.to_s.inspect} already exists, overwrite? (y/n) ",
+        yes: /\Ay/i
+      )
+    then
+      STDERR.puts "File not written!"
+      false
+    else
+      true
+    end
+  end
 end

data/lib/ollama_chat/file_editing.rb

@@ -113,15 +113,12 @@ module OllamaChat::FileEditing
   def determine_valid_output_filename(action)
     switch_history(:filename) do
       loop do
-        filename_str = ask?(
-          prompt: "❓ Enter filename #{action}, C-c ⇒ cancel: "
-        )
-        if filename_str.nil?
+        filename = ask_for_filename?(action:)
+        unless filename
           STDOUT.puts "Cancelled."
           return nil
         end
 
-        filename = Pathname.new(filename_str)
         if filename.exist?
           STDERR.puts "File #{filename.to_path.inspect} already exists!"
         else

data/lib/ollama_chat/information.rb

@@ -80,6 +80,7 @@ module OllamaChat::Information
     output.puts <<~EOT
       Current Collection
         Name: #{bold{collection}}
+        Status: #{col&.enabled ? '✅' : '⛔'}
         Patterns: #{italic{col&.patterns&.join(' ')}}
         #Embeddings: #{@documents.size}
         #Tags: #{@documents.tags.size}

data/lib/ollama_chat/message_output.rb

@@ -89,17 +89,9 @@ module OllamaChat::MessageOutput
   #   error occurred
   def attempt_to_write_file(filename, content)
     path = Pathname.new(filename.to_s).expand_path
-    if !path.exist? ||
-        confirm?(
-          prompt: "🔔 File #{path.to_s.inspect} already exists, overwrite? (y/n) ",
-          yes: /\Ay/i
-        )
-    then
-      File.open(path, ?w) do |output|
-        output.write(content)
-      end
-    else
-      return
+    should_overwrite?(path) or return
+    File.open(path, ?w) do |output|
+      output.write(content)
     end
     true
   end

data/lib/ollama_chat/ollama_chat_config/default_config.yml

@@ -151,21 +151,22 @@ prompts:
       - **Format**: [Markdown, plain text, code blocks, etc.]
       - **Vocabulary**: [Technical terms, slang, formal language]
       - **Structure**: [How you organize your responses]
+    context_template_suggest: |
+      Conversation History:
+      %{history}
+
+      Create and output text following this instruction:
+      %{instruction}
     session_summarize: |
-      Context is
+      Narrative so far:
 
       %{context}
 
-      Summarize the %{sender_name} message below in one %{unit}.
-
-      NEVER add any information to this message summary that already was included
-      in the context above.
-
-      Message
-
-      Thinking content was
-
-      %{message_thinking}
+      Extend the narrative above with the key contribution of the
+      %{sender_name} message below in one %{unit}. Skip tool-call
+      plumbing; focus on decisions, findings, and state changes. Do
+      not repeat information already present in the narrative.
+      Output only the summary text, without any sender name or prefix.
 
       Response content was
 
@@ -175,12 +176,26 @@ prompts:
 
       Create a title with a length of **less than %{length}** characters for
       the conversation above. Output only the title and nothing else.
-    context_template_suggest: |
-      Conversation History:
-      %{history}
+  session:
+    coding_brief: |
+      %{content}
 
-      Create and output text following this instruction:
-      %{instruction}
+      Write a brief of the session above. Your brief MUST:
+      - Describe the goal and how it evolved.
+      - Name key decisions, files, and architectural choices.
+      - State the current state: what works, what is pending.
+      - Be factual. Be concise.
+    roleplay_story: |
+      %{content}
+
+      Write a narrative retelling of the roleplay session
+      above. Your story MUST:
+      - Capture the emotional arc and key plot beats.
+      - Stay in the established setting and character voices.
+      - Use vivid, evocative prose; show, don't tell.
+      - Highlight turning points, revelations, and character
+        growth.
+      - Read it like a short story chapter, not a log.
   suggest:
     coding: |
       ## Context
@@ -318,25 +333,33 @@ prompts:
       
       ## Few-Shot Examples
       
-      Input: [Scene where a party is arguing in a rainy forest while being hunted]
-      Output:
-      Demand that everyone stop shouting and listen for the sound of footsteps in the brush.
+      Input: [Scene where a party is arguing in a rainy forest while being
+      hunted] Output: Demand that everyone stop shouting and listen for the
+      sound of footsteps in the brush.
       
-      Quietly admit to the party leader that you are terrified, leaning into their shoulder for support.
+      Quietly admit to the party leader that you are terrified, leaning into
+      their shoulder for support.
       
-      Examine the muddy tracks near the campfire to see if the hunters are human or something else. Roll 1d20.
+      Examine the muddy tracks near the campfire to see if the hunters are
+      human or something else. Roll 1d20.
       
-      Secretly slip the map out of the leader's pocket while they are distracted by the argument. Roll 1d20.
+      Secretly slip the map out of the leader's pocket while they are
+      distracted by the argument. Roll 1d20.
       
-      Raise your voice and challenge every single person present to state their true loyalty right now.
+      Raise your voice and challenge every single person present to state their
+      true loyalty right now.
       
-      Attempt to leap across the ravine to flank the hunters, risking a fall into the rapids. Roll 1d20.
+      Attempt to leap across the ravine to flank the hunters, risking a fall
+      into the rapids. Roll 1d20.
       
-      Obsessively polish your sword with a rag, ignoring the argument entirely until it is perfectly mirrored.
+      Obsessively polish your sword with a rag, ignoring the argument entirely
+      until it is perfectly mirrored.
       
-      Suddenly reveal that you were actually sent here by the enemy as a double agent.
+      Suddenly reveal that you were actually sent here by the enemy as a double
+      agent.
       
-      A sudden lightning strike hits a nearby tree, knocking everyone off balance and creating a deafening blast.
+      A sudden lightning strike hits a nearby tree, knocking everyone off
+      balance and creating a deafening blast.
       
       ## Output Format
       
@@ -356,7 +379,10 @@ prompts:
       conversation:
       %{groups}
 
-      Summarize the conversation above. Your narrative MUST:
+      The previous summary (if present) is a draft. Rewrite it
+      to incorporate the new conversation above. The result must
+      read as one continuous account of the entire session, not a
+      concatenation of two separate summaries. Your narrative MUST:
       - Name every file created or significantly modified (with
         path), and the key methods or classes they define.
       - State the architectural or design decisions made (e.g.
@@ -366,8 +392,8 @@ prompts:
       - Do NOT merely report test counts or coverage percentages;
         those are outcomes, not accomplishments.
       - Be factual; do not invent details not present in the groups
-        above. Keep it to 6–12 sentences.
-    assemble: |-
+        or previous summary above. Be concise; skip filler and repetition.
+    assemble: |
       %{narrative}
 
       tool_calls:

data/lib/ollama_chat/prompt_management.rb

@@ -333,7 +333,7 @@ module OllamaChat::PromptManagement
       # Let the user write a suggestion instruction on the fly
       instruction = edit_text('').full? or return
     else
-      # Let the user pick a prompt template (e.g., suggest_coding, suggest_roleplaying)
+      # Let the user pick a prompt template (e.g., suggest.coding, suggest.roleplaying)
       instruction = choose_prompt(
         prompt: 'Which suggestion strategy shall we employ? %s',
         context: 'suggest'

data/lib/ollama_chat/rag_handling.rb

@@ -163,10 +163,11 @@ module OllamaChat::RAGHandling
     collections = all_collections.select(:name, :description, :enabled)
     use_pager do |output|
       collections.each { |c|
-        collection_name = current_collection == c.name ? bold { c.name } : c.name
+        enabled                = c.enabled ? '✅' : '⛔'
+        collection_name        = current_collection == c.name ? bold { c.name } : c.name
         collection_description = c.description
-        suffix = c.enabled ? '' : ' [DISABLED]'
-        output.puts '%s: %s%s' % [ collection_name, collection_description, suffix ]
+
+        output.puts '%s %s: %s' % [ enabled, collection_name, collection_description ]
       }
     end
   end

data/lib/ollama_chat/session_management.rb

@@ -348,11 +348,10 @@ module OllamaChat::SessionManagement
 
   # Generates a summary of the current session's conversation.
   #
-  # @param pretty [Boolean] whether to format the summary in markdown (default: false)
   # @param sentence [Boolean] whether to summarize each message in one sentence (default: false)
   # @param block [Proc] a block to handle each summary fragment
   # @return [String, nil] the session summary or nil if empty
-  def summarize_session(pretty: false, sentence: false, &block)
+  def summarize_session(sentence: false, &block)
     unit                  = sentence ? 'sentence' : 'paragraph'
     contents              = []
     messages_to_summarize = messages.each_message
@@ -362,9 +361,8 @@ module OllamaChat::SessionManagement
       message: infobar_message,
     )
     messages_to_summarize.each do |message|
-      message_content  = message.content.full?
-      message_thinking = message.thinking.full?
-      unless message_content || message_thinking
+      message_content = message.content.full?
+      unless message_content
         -infobar
         next
       end
@@ -373,25 +371,113 @@ module OllamaChat::SessionManagement
       context            = contents * "\n\n"
       summary            = generate(
         prompt:  prompt(:session_summarize).to_s % {
-          sender_name:, unit:, message_content:, message_thinking:, context:
+          sender_name:, unit:, message_content:, context:
         }
       )
-      content = if pretty
-                  '**%s**: %s' % [ sender_name_output, summary ]
-                else
-                  '%s: %s' % [ sender_name_output, summary ]
-                end
+      content = '**%s**: %s' % [ sender_name_output, summary ]
       block&.(content)
       contents << content
       +infobar
     end
     contents.empty? and return
 
-    if pretty
-      contents.unshift(%{# Summary of session "#{session.name}"})
-      contents * "\n\n"
+    contents.unshift(%{# Summary of session "#{session.name}"})
+    contents * "\n\n"
+  end
+
+  # Summarizes the conversation and displays or saves the result.
+  #
+  # @param sentence [Boolean] summarize each message in one sentence (default: false)
+  # @param save [Boolean] save to file instead of pager (default: false)
+  def summarize_conversation(sentence: false, save: false)
+    if save
+      filename = ask_for_filename?(action: 'for summarization') or return
+      should_overwrite?(filename) or return
+      summary = summarize_session(sentence:) do |content|
+        infobar.puts kramdown_ansi_parse(content)
+      end
+      if summary.full?
+        filename.write(summary)
+        STDOUT.puts "File successfully written."
+      else
+        STDERR.puts "Nothing to summarize!"
+      end
+    else
+      summary = summarize_session(sentence:) do |content|
+        infobar.puts kramdown_ansi_parse(content) << ?\n
+      end
+      if summary.full?
+        use_pager do |output|
+          output.puts kramdown_ansi_parse(summary)
+        end
+      else
+        STDERR.puts "Nothing to summarize!"
+      end
+    end
+  end
+
+  # Generates a report document for the current session's conversation.
+  #
+  # Uses a user-selected prompt template from the 'session' context
+  # (e.g. coding_brief, roleplay_story) to produce a single cohesive
+  # document describing the session. Uses `compacted_messages` (summary +
+  # recent tail) rather than `each_message` so the interpolated content
+  # stays bounded even after multiple compaction rounds.
+  #
+  # @param name [String, nil] specific template name (skips chooser)
+  # @param block [Proc] a block to handle the report content
+  # @return [String, nil] the report or nil if empty
+  def report_session(name: nil, &block)
+    content = messages.compacted_messages.inject('') do |c, message|
+      message.content.present? or next c
+      sender = sender_name_displayed(message)
+      c << "%s: %s\n\n" % [ sender, message.content ]
+    end
+    content.empty? and return
+
+    template = if name
+                 prompt(name, context: 'session')
+               else
+                 choose_prompt(
+                   context: 'session',
+                   prompt: 'Which report template? %s'
+                 )
+               end
+    template or return
+
+    result = generate(prompt: template.to_s % { content: })
+    block&.(result)
+    result
+  end
+
+  # Generates a report and displays or saves the result.
+  #
+  # @param name [String, nil] specific report template name (skips chooser)
+  # @param save [Boolean] save to file instead of pager (default: false)
+  def report_conversation(name: nil, save: false)
+    if save
+      filename = ask_for_filename?(action: 'for report') or return
+      should_overwrite?(filename) or return
+      result = report_session(name:) do |content|
+        infobar.puts kramdown_ansi_parse(content)
+      end
+      if result.full?
+        filename.write(result)
+        STDOUT.puts "File successfully written."
+      else
+        STDERR.puts "Nothing to report!"
+      end
     else
-      contents * ?\n
+      result = report_session(name:) do |content|
+        infobar.puts kramdown_ansi_parse(content) << ?\n
+      end
+      if result.full?
+        use_pager do |output|
+          output.puts kramdown_ansi_parse(result)
+        end
+      else
+        STDERR.puts "Nothing to report!"
+      end
     end
   end
 
@@ -575,6 +661,21 @@ module OllamaChat::SessionManagement
     end
   end
 
+  # Repairs `group_uuid` assignments in the current message list.
+  #
+  # Walks the message array backwards looking for user messages (that are not
+  # tool calls) lacking a `group_uuid`. For each such anchor it:
+  #
+  # 1. Swaps a preceding `runtime_information` tool message so the user
+  #    message comes first (structural invariant).
+  # 2. Propagates the anchor's UUID forward to all subsequent messages until
+  #    the next user message or the end of the list.
+  #
+  # After the backward pass, any remaining orphaned messages (e.g. system
+  # messages not part of a user-led exchange) are assigned fresh UUIDs via
+  # `initialize_group_uuid`.
+  #
+  # Persists the repaired message list via `store_messages_in_session`.
   def repair_group_uuids
     msgs = messages.messages # Direct reference to the internal array
     msgs.empty? and return

data/lib/ollama_chat/tool_calling.rb

@@ -103,17 +103,20 @@ module OllamaChat::ToolCalling
   # This method outputs to standard output the alphabetically sorted list of
   # tool names that are currently enabled in the chat session.
   def list_tools
-    STDOUT.puts "Registered tools:"
-    configured_tools.each do |tool|
-      enabled = tool_enabled?(tool) ? ?✓ : ?☐
-      require_confirmation = tool_function(tool).require_confirmation? ? ?? : ?☐
-      printf(
-        "%s %s %s\n",
-        enabled, require_confirmation, (enabled ? bold { tool } : tool)
-      )
+    use_pager do |output|
+      output.puts "Registered tools:"
+      configured_tools.each do |tool|
+        enabled = tool_enabled?(tool) ? '✅' : '⛔'
+        require_confirmation = tool_function(tool).require_confirmation? ? '❔' : '⭕'
+
+        output.printf(
+          "%s %s %s\n",
+          enabled, require_confirmation, (enabled ? bold { tool } : tool)
+        )
+      end
+      output.puts ?┉ * Tins::Terminal.columns
+      tools_support.show(output:)
     end
-    STDOUT.puts ?┉ * Tins::Terminal.columns
-    tools_support.show
   end
 
   # The enable_tool method allows the user to select and enable a tool from a

data/lib/ollama_chat/version.rb

@@ -1,6 +1,6 @@
 module OllamaChat
   # OllamaChat version
-  VERSION         = '0.0.115'
+  VERSION         = '0.0.116'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/ollama_chat.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: ollama_chat 0.0.115 ruby lib
+# stub: ollama_chat 0.0.116 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "ollama_chat".freeze
-  s.version = "0.0.115".freeze
+  s.version = "0.0.116".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]

data/spec/ollama_chat/chat_spec.rb

@@ -52,7 +52,7 @@ describe OllamaChat::Chat, protect_env: true do
     it 'can display collection_stats' do
       chat
       expect(STDOUT).to receive(:puts).with(
-        /Current Collection\n  Name: \e\[1mdefault\e\[0m\n  Patterns: \e\[3m\e\[0m\n  #Embeddings: 0\n  #Tags: 0\n  Tags:/
+        /Current Collection\n  Name: \e\[1mdefault\e\[0m\n  Status: ✅\n  Patterns: \e\[3m\e\[0m\n  #Embeddings: 0\n  #Tags: 0\n  Tags:/
       )
       expect(chat.collection_stats).to be_nil
     end

data/spec/ollama_chat/commands_spec.rb

@@ -557,6 +557,36 @@ describe OllamaChat::Commands, protect_env: true do
       expect(chat).to receive(:confirm?).and_return false
       expect(chat.handle_input("/conversation compact")).to eq :next
     end
+
+    it 'returns :next when input is "/conversation summarize"' do
+      expect(chat).to receive(:summarize_conversation)
+        .with(save: false, sentence: false)
+      expect(chat.handle_input("/conversation summarize")).to eq :next
+    end
+
+    it 'returns :next when input is "/conversation summarize -s"' do
+      expect(chat).to receive(:summarize_conversation)
+        .with(save: false, sentence: 1)
+      expect(chat.handle_input("/conversation summarize -s")).to eq :next
+    end
+
+    it 'returns :next when input is "/conversation summarize -f"' do
+      expect(chat).to receive(:summarize_conversation)
+        .with(save: 1, sentence: false)
+      expect(chat.handle_input("/conversation summarize -f")).to eq :next
+    end
+
+    it 'returns :next when input is "/conversation report"' do
+      expect(chat).to receive(:report_conversation)
+        .with(save: false)
+      expect(chat.handle_input("/conversation report")).to eq :next
+    end
+
+    it 'returns :next when input is "/conversation report -f"' do
+      expect(chat).to receive(:report_conversation).
+        with(save: 1)
+      expect(chat.handle_input("/conversation report -f")).to eq :next
+    end
   end
 
   describe 'tools' do

data/spec/ollama_chat/compaction_spec.rb

@@ -226,9 +226,10 @@ describe OllamaChat::Compaction do
       )
       # last line is the directive's final sentence
       expect(captured)
-        .to match(/details\s+not\s+present\s+in\s+the\s+groups\s+above./m)
+        .to match(/details\s+not\s+present\s+in\s+the\s+groups\s+or\s+previous\s+summary\s+above./m)
       # directive comes after content
-      expect(captured.index('Summarize the conversation'))
+      expect(captured).to match(/is\s+a\s+draft/)
+      expect(captured.index(/is\s+a\s+draft/))
         .to be > captured.index('[user]')
     end
 
@@ -253,7 +254,7 @@ describe OllamaChat::Compaction do
       expect(content).to include 'tool_calls:'
       expect(content).to include '"uuid":"aaaa"'
       expect(content).to include '"uuid":"bbbb"'
-      expect(content).to end_with 'with the group UUID in parentheses.'
+      expect(content).to end_with "with the group UUID in parentheses.\n"
       expect(tools).to eq entries
     end
 
@@ -261,7 +262,7 @@ describe OllamaChat::Compaction do
       content, tools = chat.assemble_summary('Just narrative.', [])
       expect(content).to start_with 'Just narrative.'
       expect(content).to include 'tool_calls:'
-      expect(content).to end_with 'with the group UUID in parentheses.'
+      expect(content).to end_with "with the group UUID in parentheses.\n"
       expect(tools).to eq []
     end
 

data/spec/ollama_chat/conversation_spec.rb

@@ -8,7 +8,7 @@ describe OllamaChat::Conversation do
   describe '#save_conversation' do
     it 'saves a new conversation (clean: false) and confirms' do
       expect(chat.messages).to receive(:save_conversation)
-        .with('./new_chat.jsonl', messages: chat.messages.messages)
+        .with(Pathname.new('./new_chat.jsonl'), messages: chat.messages.messages)
         .and_return(true)
       expect(STDOUT).to receive(:puts)
         .with('Saved conversation to "./new_chat.jsonl".')
@@ -17,7 +17,7 @@ describe OllamaChat::Conversation do
 
     it 'saves a new conversation (clean: true) using cleaned messages' do
       expect(chat.messages).to receive(:save_conversation)
-        .with('./new_chat.jsonl', messages: chat.messages.clean_messages)
+        .with(Pathname.new('./new_chat.jsonl'), messages: chat.messages.clean_messages)
         .and_return(true)
       expect(STDOUT).to receive(:puts)
         .with('Saved conversation to "./new_chat.jsonl".')
@@ -56,7 +56,7 @@ describe OllamaChat::Conversation do
         .and_return(false)
       expect(chat.messages).not_to receive(:save_conversation)
       expect(STDOUT).not_to receive(:puts)
-      expect(STDERR).not_to receive(:puts)
+      expect(STDERR).to receive(:puts).with('File not written!')
       chat.save_conversation(tmpfile, clean: false)
     ensure
       FileUtils.rm_f(tmpfile)

data/spec/ollama_chat/session_management_spec.rb

@@ -316,6 +316,92 @@ describe OllamaChat::SessionManagement do
     end
   end
 
+  describe '#summarize_conversation' do
+    it 'displays summary in pager when not saving' do
+      chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello')
+      expect(chat).to receive(:summarize_session).and_return('# Summary content')
+      expect(chat).to receive(:use_pager)
+      chat.summarize_conversation
+    end
+
+    it 'reports nothing when no messages' do
+      expect(chat).to receive(:summarize_session).and_return(nil)
+      expect(STDERR).to receive(:puts).with('Nothing to summarize!')
+      chat.summarize_conversation
+    end
+
+    it 'saves summary to file when save: true' do
+      chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello')
+      tmpfile = Pathname.new(File.join(Dir.tmpdir, "summ_#{$$}_test.md"))
+      expect(chat).to receive(:ask_for_filename?).and_return(tmpfile)
+      expect(chat).to receive(:should_overwrite?).and_return(true)
+      expect(chat).to receive(:summarize_session).and_return('# Summary content')
+      expect(STDOUT).to receive(:puts).with('File successfully written.')
+      chat.summarize_conversation(save: true)
+      expect(tmpfile.exist?).to be_truthy
+      expect(tmpfile.read).to include('Summary content')
+    ensure
+      FileUtils.rm_f(tmpfile)
+    end
+  end
+
+  describe '#report_session' do
+    it 'generates a report from compacted messages' do
+      chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello world')
+      expect(chat).to receive(:sender_name_displayed).and_return('User')
+      expect(chat).to receive(:choose_prompt).and_return(double(to_s: '%{content}'))
+      expect(chat).to receive(:generate).and_return('Generated report')
+
+      results = []
+      result = chat.report_session { |c| results << c }
+      expect(result).to eq('Generated report')
+      expect(results).to eq(['Generated report'])
+    end
+
+    it 'returns nil when no messages have content' do
+      expect(chat.messages).to receive(:compacted_messages).and_return([])
+      expect(chat.report_session).to be_nil
+    end
+
+    it 'uses named prompt when name is provided' do
+      chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello')
+      expect(chat).to receive(:sender_name_displayed).and_return('User')
+      expect(chat).to receive(:prompt).with('coding_brief', context: 'session')
+        .and_return(double(to_s: '%{content}'))
+      expect(chat).to receive(:generate).and_return('Brief')
+      expect(chat.report_session(name: 'coding_brief')).to eq('Brief')
+    end
+  end
+
+  describe '#report_conversation' do
+    it 'displays report in pager when not saving' do
+      chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello')
+      expect(chat).to receive(:report_session).and_return('# Report content')
+      expect(chat).to receive(:use_pager)
+      chat.report_conversation
+    end
+
+    it 'reports nothing when no content' do
+      expect(chat).to receive(:report_session).and_return(nil)
+      expect(STDERR).to receive(:puts).with('Nothing to report!')
+      chat.report_conversation
+    end
+
+    it 'saves report to file when save: true' do
+      chat.messages << OllamaChat::Message.new(role: 'user', content: 'hello')
+      tmpfile = Pathname.new(File.join(Dir.tmpdir, "report_#{$$}_test.md"))
+      expect(chat).to receive(:ask_for_filename?).and_return(tmpfile)
+      expect(chat).to receive(:should_overwrite?).and_return(true)
+      expect(chat).to receive(:report_session).and_return('# Report content')
+      expect(STDOUT).to receive(:puts).with('File successfully written.')
+      chat.report_conversation(save: true)
+      expect(tmpfile.exist?).to be_truthy
+      expect(tmpfile.read).to include('Report content')
+    ensure
+      FileUtils.rm_f(tmpfile)
+    end
+  end
+
   describe '#change_session' do
     it 'switches to a different session and updates state' do
       new_s = chat.new_session.tap { |s| s.name = 'change_to_me'; s.save }

data/spec/ollama_chat/tool_calling_spec.rb

@@ -97,10 +97,19 @@ describe OllamaChat::ToolCalling do
 
   describe '#list_tools' do
     it 'prints a formatted list of tools with their status' do
-      chat.session.tools_default_enabled = { 'read_file' => true, 'write_file' => false }
+      chat.session.tools_default_enabled = {
+        'read_file' => true, 'write_file' => false
+      }
+
+      output_io = StringIO.new
+      expect(chat).to receive(:use_pager).and_yield(output_io)
+      expect(chat).to receive(:tools_support).
+        and_return(double(show: true))
+
+      chat.list_tools
 
-      # We expect to see ✓ for read_file and ☐ for write_file
-      expect { chat.list_tools }.to output(/✓ .*read_file.*☐ .*write_file/m).to_stdout
+      # We expect to see ✅ for read_file and ⛔ for write_file
+      expect(output_io.string).to match(/✅ .*read_file.*⛔ .*write_file/m)
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ollama_chat
 version: !ruby/object:Gem::Version
-  version: 0.0.115
+  version: 0.0.116
 platform: ruby
 authors:
 - Florian Frank