ollama_chat 0.0.116 → 0.0.118

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: beebfc1a29093b596fe008ba59b2f377922e2f7beeeb529ebed899fc374c6e02
-  data.tar.gz: e704bce9b15101283e802a6010ee08c347cf94d8fcdc2ee785da3880debde736
+  metadata.gz: f5db2a60d43d3a57a30e3c33a16b9ba26e60807afd9ff6b74c0781af25fe2516
+  data.tar.gz: e670d0cfcbbcfa815e4b9a7f6e0ccb6093dc4986b736035aea3dc38b4bc646ab
 SHA512:
-  metadata.gz: 7cab4e5d47d97dd215e058ab9960ad8801252a2ab950d3b30ce1e514fad30b22e87f917e3b1764592070f385fcfec748cc3b59398cadf8e3553f41e6ec48e9bb
-  data.tar.gz: 0fb71bb0ab178cb1fed41ea2b257360fd19d3d180a2fc2f497d1372874d4665c3b82676ad8c056ab80a22e21e95deebb8afee8ef5f2809a07671e6cfb53ba5d7
+  metadata.gz: 8f7cb31ed0e38db5baca42a29076b3a01e3bae64d5a80d55584bd0ecdaaa41fd15eb814fc8b34ac55d2e73e4d767c52f305167cd8d2a7b32af4e9668f7d43706
+  data.tar.gz: a54ebe900c8b8a2c9e31ce3a4aded809f1b6e179679b2f2b4e3174f9e4ba5f6c976c8e7f1aaf3ae7efb8b8c8417f605b8c2522676eb0952f6d4b38165ac087af

data/CHANGES.md

@@ -1,5 +1,79 @@
 # Changes
 
+## 2026-09-05 v0.0.118
+
+*   Documented the upgrade workflow in the README, adding an "Upgrading"
+    section that covers the post-`gem update` flow: `/config diff` with
+    `:diffget`, reload, and `/prompt sync` for per-prompt drift resolution.
+*   Clarified that the local `config.yml` is a partial override requiring no
+    migration script.
+*   Improved the prompt drift nagging message in `app_state.rb#seed` by
+    replacing the previous prompt with a two-part message featuring a bold
+    `Tip:` line suggesting `/prompt sync` and a "Seen these changes?"
+    confirmation.
+*   Replaced literal `⚠️` emoji with `\u26A0\uFE0F` escapes for consistent
+    rendering and introduced `Term::ANSIColor` locally for the bold tip prefix.
+*   Added a `session.standup` template to `default_config.yml` defining a
+    six-section end-of-day document.
+*   Moved the compaction system prompt from `prompts.compaction.system` to
+    `prompts.system.compaction` and updated `compaction.rb` to call
+    `prompt(:compaction, context: 'system')`.
+*   Added `prompts.system.report`, a genre-neutral writer system prompt, and
+    updated `session_management.rb#report_session` to pass `system:` and
+    `think: true` to `generate` for report generation.
+*   Simplified `compaction_spec.rb` to resolve templates from
+    `chat.config.prompts.system.compaction` and added a `prompt(:report,
+    context: 'system')` expectation to `session_management_spec.rb`.
+*   Fixed the `get_url` summarizing policy by wrapping it in `Infobar.busy` and
+    `chat.generate` to ensure the LLM produces the summary.
+*   Added a `words` (integer) parameter to the `get_url` tool schema, forwarded
+    to `summarize_source` to control summary length.
+*   Changed `STDOUT.puts` to `infobar.puts` in `summarize_source` to prevent
+    garbling spinner output.
+*   Updated `get_url_spec.rb` to include `words: nil` in argument doubles,
+    reworked the summarizing test to expect `chat.generate`, and added a
+    `words: 50` forwarding test.
+*   Added `Infobar.busy` spinners with descriptive labels to LLM `generate`
+    calls in `personae_management.rb`, `prompt_management.rb`, and
+    `session_management.rb`.
+*   Modified `prompt_management.rb` to only call `edit_text(suggestions)` if
+    `suggestions.present?`.
+
+## 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

data/README.md

@@ -19,6 +19,39 @@ gem install ollama_chat
 
 in your terminal.
 
+## Upgrading
+
+After `gem update ollama_chat`, the next launch will either
+start cleanly or prompt you to fix the config:
+
+1. **Open the config diff.** Run `/config diff`, or wait for
+   the automatic `fix_config` prompt if the new version
+   introduced required keys. Either way, your `$DIFF_TOOL`
+   (default: `vimdiff`) opens with your local `config.yml`
+   on one side and the shipped `default_config.yml` on the
+   other.
+2. **Pull in the changes.** In vimdiff, use `:diffget` to
+   copy new or updated keys from the default into your local
+   file. Ignore keys you've intentionally overridden.
+3. **Reload.** Close the diff tool and answer `y` to the
+   "restart?" prompt.
+4. **Prompt drift.** If the new version changed any shipped
+   prompts, a fingerprint notice lists modified, added, and
+   removed prompts. To reconcile your stored prompts with
+   the new defaults, run `/prompt sync`. It diffs each
+   prompt against the shipped version and lets you decide
+   per prompt: adopt the new default, keep your local edit,
+   or review the change. After syncing, the fingerprint is
+   updated and the nagging stops.
+
+   If you simply want to dismiss the notice without
+   syncing, answer `y` to the boot prompt. The fingerprint
+   is stored and you won't be asked again.
+
+Your local config is a partial override. Keys you don't
+have fall through to the shipped defaults. No migration
+script needed.
+
 ## Configuration
 
 ### Environment Variables

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
 

data/lib/ollama_chat/commands.rb

@@ -22,7 +22,7 @@ require 'ollama_chat/command_concern'
 module OllamaChat::Commands
   include OllamaChat::CommandConcern
 
-  ## Clipboard
+  category :Clipboard
 
   command(
     name: :copy,
@@ -58,7 +58,7 @@ module OllamaChat::Commands
     end
   end
 
-  ## Settings
+  category :Settings
 
   command(
     name: :config,
@@ -85,14 +85,67 @@ module OllamaChat::Commands
   end
 
   command(
-    name: :document_policy,
-    regexp: %r(^/document policy$),
-    complete: %w[ document policy ],
+    name: :favourite,
+    regexp: %r(^/favourite(?:\s+(add|delete))?(?:\s+(model|prompt|system|persona|suggest))$),
+    complete: [ 'favourite', %w[ add delete ].product(%w[ model prompt system persona suggest ]) ],
     help: <<~EOT
-      📜 Select a scanning policy for documents
+      \u2B50\uFE0F Manage favorites (add/delete models,
+         prompts, personae)
     EOT
-  ) do
-    document_policy.choose
+  ) do |subcommand, type|
+    case subcommand
+    when 'add'
+      add_favourite(type)
+    when 'delete'
+      delete_favourite(type)
+    end
+    :next
+  end
+
+  category :Session
+
+  command(
+    name: :session,
+    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: "[-p profile]\n[name]",
+    help: <<~EOT
+      💬 Manage sessions:
+         - list/new/delete/rename/duplicate
+         - change [name]/previous
+         - model options/change
+    EOT
+  ) do |subcommand, opts, name|
+    case subcommand
+    when nil
+      info_session
+    when 'list'
+      list_sessions
+    when 'new'
+      set_new_session
+    when 'duplicate'
+      duplicate_session
+    when 'delete'
+      delete_session
+    when 'rename'
+      rename_session
+    when 'change'
+      change_session(name)
+    when 'model options'
+      edit_session_model_options
+    when 'model options change'
+      opts = go_command('p:', opts)
+      if profile = opts[?p] || choose_profile_for_model(@model)
+        copy_model_options_to_session(profile:)
+      end
+    when 'previous'
+      if prev = previous_session
+        change_session(prev.id)
+      else
+        STDOUT.puts "No previous session defined."
+      end
+    end
     :next
   end
 
@@ -132,123 +185,6 @@ module OllamaChat::Commands
     :next
   end
 
-  command(
-    name: :favourite,
-    regexp: %r(^/favourite(?:\s+(add|delete))?(?:\s+(model|prompt|system|persona|suggest))$),
-    complete: [ 'favourite', %w[ add delete ], %w[ model prompt system persona suggest ] ],
-    help: <<~EOT
-      \u2B50\uFE0F Manage favorites (add/delete models,
-         prompts, personae)
-    EOT
-  ) do |subcommand, type|
-    case subcommand
-    when 'add'
-      add_favourite(type)
-    when 'delete'
-      delete_favourite(type)
-    end
-    :next
-  end
-
-  command(
-    name: :model,
-    regexp: %r(^/model(?:\s+(change|options(?: copy| delete| export| import)?|options from session|options to session))?((?:\s+(?:-m|-p\s+[\S]+))*)$),
-    complete: [ 'model', %w[ change options options\ copy options\ delete options\ export options\ import options\ from\ session options\ to\ session ] ],
-    options: '[-m|-p pattern]',
-    help: <<~EOT
-      🤖 Manage AI models & profiles:
-         - change: Switch active model
-         - options: Edit saved profile config
-         - options copy: Copy profile from another model
-         - options delete: Delete a saved profile
-         - options export: Export ALL model profiles to JSON
-         - options import: Selectively import profiles from JSON
-         - options from session: Save live → Saved
-         - options to session: Apply Saved → Live
-         -m interactively choose a model
-         -p PATTERN narrow file search for import
-    EOT
-  ) do |subcommand, opts|
-    if subcommand == 'change'
-      begin
-        model   = choose_model('', @model)
-        profile = choose_profile_for_model(model) || 'default'
-        use_model(model, profile:)
-      rescue OllamaChat::UnknownModelError => e
-        msg = "Caught #{e.class}: #{e}"
-        log(:error, msg, data: { command: 'model', profile: }, warn: true)
-      end
-      next :next
-    end
-    opts    = go_command('mp:', opts)
-    model   = opts[?m] ? choose_model('', @model) : @model
-    case subcommand
-    when 'options'
-      profile = choose_profile_for_model(model, allow_new: true) or next :next
-      edit_model_options(model, profile:)
-    when 'options copy'
-      copy_model_options_profile(model)
-    when 'options delete'
-      delete_model_options_profile(model)
-    when 'options from session'
-      profile = choose_profile_for_model(model) || 'default'
-      copy_model_options_from_session(model, profile:)
-    when 'options to session'
-      profile = choose_profile_for_model(model) || 'default'
-      copy_model_options_to_session(model, profile:)
-    when 'options export'
-      export_model_options
-    when 'options import'
-      pattern  = opts[?p] || '**/*.json'
-      filename = choose_filename(pattern) or next :next
-      import_model_options(filename)
-    end
-    :next
-  end
-
-  command(
-    name: :system,
-    regexp: %r(^/system(?:\s+(change))?$),
-    complete: [ 'system', %w[ change ] ],
-    optional: true,
-    help: <<~EOT,
-      🧬 Manage active system prompt (change)
-         Note: Use '/prompt -c system' for managing
-         (add, delete, edit, list, etc.) system templates.
-    EOT
-  ) do |subcommand, filename|
-    case subcommand
-    when 'change'
-      change_system_prompt(@messages.system_name)
-      @messages.show_system_prompt
-    when nil
-      @messages.show_system_prompt
-    end
-    :next
-  end
-
-  command(
-    name: :think,
-    regexp: %r(^/think$),
-    help: <<~EOT
-      🧠 Configure model thinking mode
-    EOT
-  ) do
-    think_mode.choose
-    :next
-  end
-
-  command(
-    name: :context_format,
-    regexp: %r(^/context_format$),
-    help: <<~EOT,
-      📐 Set context format (JSON|TOON)
-    EOT
-  ) do
-    context_format.choose
-    :next
-  end
-
   command(
     name: :tools,
     regexp: %r(^/tools(?:\s+(on|off|enable|disable))?),
@@ -287,54 +223,31 @@ module OllamaChat::Commands
     :next
   end
 
-  ## Session
-
   command(
-    name: :session,
-    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: "[-p profile]\n[name]",
+    name: :document_policy,
+    regexp: %r(^/document policy$),
+    complete: %w[ document policy ],
     help: <<~EOT
-      💬 Manage sessions:
-         - list/new/delete/rename/duplicate
-         - change [name]/previous
-         - model options/change
+      📜 Select a scanning policy for documents
     EOT
-  ) do |subcommand, opts, name|
-    case subcommand
-    when nil
-      info_session
-    when 'list'
-      list_sessions
-    when 'new'
-      set_new_session
-    when 'duplicate'
-      duplicate_session
-    when 'delete'
-      delete_session
-    when 'rename'
-      rename_session
-    when 'change'
-      change_session(name)
-    when 'model options'
-      edit_session_model_options
-    when 'model options change'
-      opts = go_command('p:', opts)
-      if profile = opts[?p] || choose_profile_for_model(@model)
-        copy_model_options_to_session(profile:)
-      end
-    when 'previous'
-      if prev = previous_session
-        change_session(prev.id)
-      else
-        STDOUT.puts "No previous session defined."
-      end
-    end
+  ) do
+    document_policy.choose
+    :next
+  end
+
+  command(
+    name: :context_format,
+    regexp: %r(^/context_format$),
+    help: <<~EOT,
+      📐 Set context format (JSON|TOON)
+    EOT
+  ) do
+    context_format.choose
     :next
   end
 
-  ## Conversation
+
+  category :Conversation
 
   command(
     name: :list,
@@ -447,6 +360,77 @@ module OllamaChat::Commands
     content
   end
 
+  command(
+    name: :change_response,
+    regexp: %r(^/change response$),
+    complete: %w[ change response ],
+    help: <<~EOT,
+      ✏️ Edit last AI response in editor
+    EOT
+  ) do
+    change_response
+    :next
+  end
+
+  command(
+    name: :conversation,
+    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
+      💾 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?
+      STDERR.puts "Require a path as argument to save/load!"
+      next :next
+    end
+    case subcommand
+    when 'save'
+      opts = go_command('c', opts.to_s)
+      save_conversation(path, clean: opts[?c])
+    when 'load'
+      load_conversation(path)
+      repair_group_uuids
+    when 'clean'
+      if confirm?(
+          prompt: '🔔 Clean tool content, images, and thinking from conversation? (y/n) ',
+          yes: /\Ay/i
+        )
+      then
+        messages.clean_messages!
+        session_sync
+        STDOUT.puts "Conversation cleaned."
+      else
+        STDOUT.puts 'Cancelled.'
+      end
+    when 'compact'
+      if confirm?(
+          prompt: '🔔 Compact conversation? Old messages will be summarized. (y/n) ',
+          yes: /\Ay/i
+        )
+      then
+        compact_with_retry
+      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
+
+  category :Prompts
+
   command(
     name: :prompt,
     regexp: %r(^/prompt(?:\s+(edit|info|add|delete|list|duplicate|import|export|reset|rename|sync|-e))?(\s+(?:-[ef]|-c\s+(?:\w+|\?)))?(?:\s+([^-].*))?$),
@@ -528,6 +512,27 @@ module OllamaChat::Commands
     :next
   end
 
+  command(
+    name: :system,
+    regexp: %r(^/system(?:\s+(change))?$),
+    complete: [ 'system', %w[ change ] ],
+    optional: true,
+    help: <<~EOT,
+      🧬 Manage active system prompt (change)
+         Note: Use '/prompt -c system' for managing
+         (add, delete, edit, list, etc.) system templates.
+    EOT
+  ) do |subcommand, filename|
+    case subcommand
+    when 'change'
+      change_system_prompt(@messages.system_name)
+      @messages.show_system_prompt
+    when nil
+      @messages.show_system_prompt
+    end
+    :next
+  end
+
   command(
     name: :suggest,
     regexp: %r(^/suggest(\s+(?:-e))?$),
@@ -545,76 +550,76 @@ module OllamaChat::Commands
     :next
   end
 
-  command(
-    name: :change_response,
-    regexp: %r(^/change response$),
-    complete: %w[ change response ],
-    help: <<~EOT,
-      ✏️ Edit last AI response in editor
-    EOT
-  ) do
-    change_response
-    :next
-  end
+  category :Models
 
   command(
-    name: :conversation,
-    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]',
+    name: :model,
+    regexp: %r(^/model(?:\s+(change|options(?: copy| delete| export| import)?|options from session|options to session))?((?:\s+(?:-m|-p\s+[\S]+))*)$),
+    complete: [ 'model', %w[ change options options\ copy options\ delete options\ export options\ import options\ from\ session options\ to\ session ] ],
+    options: '[-m|-p pattern]',
     help: <<~EOT
-      💾 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
+      🤖 Manage AI models & profiles:
+         - change: Switch active model
+         - options: Edit saved profile config
+         - options copy: Copy profile from another model
+         - options delete: Delete a saved profile
+         - options export: Export ALL model profiles to JSON
+         - options import: Selectively import profiles from JSON
+         - options from session: Save live → Saved
+         - options to session: Apply Saved → Live
+         -m interactively choose a model
+         -p PATTERN narrow file search for import
     EOT
-  ) do |subcommand,opts,path|
-    if %w[ save load ].include?(subcommand) && path.blank?
-      STDERR.puts "Require a path as argument to save/load!"
+  ) do |subcommand, opts|
+    if subcommand == 'change'
+      begin
+        model   = choose_model('', @model)
+        profile = choose_profile_for_model(model) || 'default'
+        use_model(model, profile:)
+      rescue OllamaChat::UnknownModelError => e
+        msg = "Caught #{e.class}: #{e}"
+        log(:error, msg, data: { command: 'model', profile: }, warn: true)
+      end
       next :next
     end
+    opts    = go_command('mp:', opts)
+    model   = opts[?m] ? choose_model('', @model) : @model
     case subcommand
-    when 'save'
-      opts = go_command('c', opts.to_s)
-      save_conversation(path, clean: opts[?c])
-    when 'load'
-      load_conversation(path)
-      repair_group_uuids
-    when 'clean'
-      if confirm?(
-          prompt: '🔔 Clean tool content, images, and thinking from conversation? (y/n) ',
-          yes: /\Ay/i
-        )
-      then
-        messages.clean_messages!
-        session_sync
-        STDOUT.puts "Conversation cleaned."
-      else
-        STDOUT.puts 'Cancelled.'
-      end
-    when 'compact'
-      if confirm?(
-          prompt: '🔔 Compact conversation? Old messages will be summarized. (y/n) ',
-          yes: /\Ay/i
-        )
-      then
-        compact_with_retry
-      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])
+    when 'options'
+      profile = choose_profile_for_model(model, allow_new: true) or next :next
+      edit_model_options(model, profile:)
+    when 'options copy'
+      copy_model_options_profile(model)
+    when 'options delete'
+      delete_model_options_profile(model)
+    when 'options from session'
+      profile = choose_profile_for_model(model) || 'default'
+      copy_model_options_from_session(model, profile:)
+    when 'options to session'
+      profile = choose_profile_for_model(model) || 'default'
+      copy_model_options_to_session(model, profile:)
+    when 'options export'
+      export_model_options
+    when 'options import'
+      pattern  = opts[?p] || '**/*.json'
+      filename = choose_filename(pattern) or next :next
+      import_model_options(filename)
     end
     :next
   end
 
-  ## Collection
+  command(
+    name: :think,
+    regexp: %r(^/think$),
+    help: <<~EOT
+      🧠 Configure model thinking mode
+    EOT
+  ) do
+    think_mode.choose
+    :next
+  end
+
+  category :Collection
 
   command(
     name: :collection,
@@ -666,7 +671,7 @@ module OllamaChat::Commands
     :next
   end
 
-  ## Persona
+  category :Persona
 
   command(
     name: :persona,
@@ -788,7 +793,7 @@ module OllamaChat::Commands
     end
   end
 
-  ## Input
+  category :Input
 
   command(
     name: :compose,
@@ -930,7 +935,7 @@ module OllamaChat::Commands
     end
   end
 
-  ## Output
+  category :Output
 
   command(
     name: :pipe,
@@ -977,7 +982,7 @@ module OllamaChat::Commands
     :next
   end
 
-  ## Actions
+  category :Actions
 
   command(
     name: :reconnect,
@@ -1003,7 +1008,7 @@ module OllamaChat::Commands
     quit_app
   end
 
-  ## Information
+  category :Information
 
   command(
     name: :info,
@@ -1072,5 +1077,4 @@ module OllamaChat::Commands
     STDOUT.puts "Type /quit to quit."
     :next
   end
-
 end

data/lib/ollama_chat/compaction.rb

@@ -191,7 +191,7 @@ module OllamaChat::Compaction
     prompt = prompt(:summarize, context: 'compaction').to_s % {
       previous:, groups:
     }
-    system = prompt(:system, context: 'compaction').to_s
+    system = prompt(:compaction, context: 'system').to_s
 
     es = OllamaChat::TokenEstimator.estimate(prompt)
     log(:info, "Compaction: sending prompt " \

data/lib/ollama_chat/database/models/app_state.rb

@@ -73,19 +73,20 @@ class OllamaChat::Database::Models::AppState < Sequel::Model(OllamaChat::DB)
       removed = old.keys - hashes.keys
       changed = hashes.select { |k, v| old[k] && old[k] != v }.keys
 
-      STDERR.puts "⚠️  Shipped prompts changed since last boot:"
+      STDERR.puts "\u26A0\uFE0F Shipped prompts changed since last boot:"
       changed.each { |k| STDERR.puts "  ~ #{k} (modified)" }
       added.each   { |k| STDERR.puts "  + #{k} (new)" }
       removed.each { |k| STDERR.puts "  - #{k} (removed)" }
     elsif !OllamaChat.test_mode?
-      STDERR.puts '⚠️  First run — storing prompt fingerprints.'
+      STDERR.puts "\u26A0\uFE0F First run — storing prompt fingerprints."
       store_fingerprint(fingerprint, hashes)
       return true
     end
 
+    c = Term::ANSIColor
     prompt = <<~EOT.chomp << ' '
-      Keep local prompts (stop nagging)?
-      Consider adopting via /prompt sync or just ignore? (y/n) %s
+      #{c.bold{'Tip'}}: /prompt sync adopts shipped defaults into local config.
+      Seen these changes? (y = stop nagging, n = ask again next boot) %s
     EOT
     if OllamaChat.test_mode? || chat.confirm?(prompt:, yes: /\Ay/i, timeout: 5)
       store_fingerprint(fingerprint, hashes)

data/lib/ollama_chat/ollama_chat_config/default_config.yml

@@ -190,12 +190,40 @@ prompts:
 
       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.
+    standup: |
+      %{content}
+
+      Write a document for an end-of-session snapshot. It captures what was
+      accomplished, which decisions were made and why, and what happens next —
+      the same alignment a Scrum standup provides, but written down so no
+      context is lost between sessions.
+
+      Your document MUST contain these exact sections:
+
+      1. ## Progress Log — bulleted list of completed tasks with relative file
+      paths. 2. ## External References — all URLs, API docs, or GitHub links
+      discussed during the session. 3. ## Current Mental Model — current focus,
+      existing blockers, and the immediate next step. 4. ## Technical Decision
+      Log — rationale for chosen implementations vs. rejected alternatives
+      (table). 5. ## Pending Roadmap — Critical → Important → Future Polish. 6.
+      ## Quick-Start Pointers — 2–3 files or links the next session must read
+      #first.
+
+      Constraints:
+      - Use relative Markdown paths for file references.
+      - Document *why* decisions were made, not just *what*.
+      - Do not restate what the conversation records verbatim.
+      - Professional, precise, technical tone.
+
+      Output only the standup document. No preamble, no
+      postamble, no meta-commentary.
   suggest:
     coding: |
       ## Context
@@ -366,12 +394,6 @@ prompts:
       Output only the 9 suggestions as plain text, each separated by one empty line.
       No other text.
   compaction:
-    system: |
-      You are a context summarizer for a chat application.
-      Your sole task is to produce a concise, factual narrative
-      summary of the conversation provided. Be precise, omit
-      speculation, and follow the formatting instructions in the
-      user prompt exactly. Output only the summary text.
     summarize: |
       previous_summary:
       %{previous}
@@ -408,6 +430,20 @@ prompts:
 
       %{runtime_info}
     assistant: You are a helpful assistant.
+    compaction: |
+      You are a context summarizer for a chat application.
+      Your sole task is to produce a concise, factual narrative
+      summary of the conversation provided. Be precise, omit
+      speculation, and follow the formatting instructions in the
+      user prompt exactly. Output only the summary text.
+    report: |
+      You are a writer. The user prompt below
+      specifies the document to produce: its
+      structure, tone, and constraints. Follow
+      it exactly. Output only the final document
+      — no preamble, no postamble, no commentary,
+      no reference to yourself or the act of
+      writing.
 voice:
   handler: OllamaChat::Say
   enabled: false

data/lib/ollama_chat/personae_management.rb

@@ -597,12 +597,18 @@ module OllamaChat::PersonaeManagement
   # @param persona_name [String] the name of the character to replace {{char}} with
   # @return [String] the resulting structured Markdown persona profile
   def convert_json_character_to_markdown(character, persona_name)
-    generate(
-      prompt:  prompt(:persona_architect).to_s % {
-        character:,
-        persona_template: prompt(:persona).to_s
-      }
-    ).gsub(/{{user}}/i, '%{user}').gsub(/{{char}}/i, persona_name)
+    Infobar.busy(
+      label: 'Converting character…',
+      frames: :braille7,
+      output: STDOUT,
+    ) do
+      generate(
+        prompt:  prompt(:persona_architect).to_s % {
+          character:,
+          persona_template: prompt(:persona).to_s
+        }
+      ).gsub(/{{user}}/i, '%{user}').gsub(/{{char}}/i, persona_name)
+    end
   end
 
   # Interactively exports a persona profile to a specified file.

data/lib/ollama_chat/prompt_management.rb

@@ -346,10 +346,16 @@ module OllamaChat::PromptManagement
     full_prompt = template % { history:, instruction: }
 
     # Execute a silent chat oneshot call (doesn't add to history)
-    suggestions = generate(prompt: full_prompt).full? or return
+    suggestions = Infobar.busy(
+      label: 'Creating suggestions…',
+      frames: :braille7,
+      output: STDOUT,
+    ) do
+      generate(prompt: full_prompt)
+    end
 
     # Pass the AI's suggestions through the editor for final refinement
-    edit_text(suggestions)
+    edit_text(suggestions) if suggestions.present?
   end
 
   # Lists all prompt templates in the database, indicating which are defaults

data/lib/ollama_chat/session_management.rb

@@ -425,9 +425,8 @@ module OllamaChat::SessionManagement
   # 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)
+  def report_session(name: nil)
     content = messages.compacted_messages.inject('') do |c, message|
       message.content.present? or next c
       sender = sender_name_displayed(message)
@@ -445,9 +444,15 @@ module OllamaChat::SessionManagement
                end
     template or return
 
-    result = generate(prompt: template.to_s % { content: })
-    block&.(result)
-    result
+    system = prompt(:report, context: 'system').to_s
+
+    Infobar.busy(
+      label: 'Generating session report…',
+      frames: :braille7,
+      output: STDOUT,
+    ) do
+      generate(system:, prompt: template.to_s % { content: }, think: true)
+    end
   end
 
   # Generates a report and displays or saves the result.
@@ -458,9 +463,7 @@ module OllamaChat::SessionManagement
     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
+      result = report_session(name:)
       if result.full?
         filename.write(result)
         STDOUT.puts "File successfully written."
@@ -468,9 +471,7 @@ module OllamaChat::SessionManagement
         STDERR.puts "Nothing to report!"
       end
     else
-      result = report_session(name:) do |content|
-        infobar.puts kramdown_ansi_parse(content) << ?\n
-      end
+      result = report_session(name:)
       if result.full?
         use_pager do |output|
           output.puts kramdown_ansi_parse(result)
@@ -492,11 +493,17 @@ module OllamaChat::SessionManagement
       c << "%s: %s\n\n" % [ sender_name, message.content ]
     end
     prompt = prompt(:session_title).to_s % { length:, content: }
-    generate(prompt:).full? do |name|
-      name = name.
-        gsub(/(\A(\s|[^A-Za-z])+|(\s|[^A-Za-z])+\z)/m, '').
-        gsub(/\s+/, ' ')
-      Kramdown::ANSI::Width.truncate(name, length:)
+    Infobar.busy(
+      label: 'Naming session…',
+      frames: :braille7,
+      output: STDOUT,
+    ) do
+      generate(prompt:).full? do |name|
+        name = name.
+          gsub(/(\A(\s|[^A-Za-z])+|(\s|[^A-Za-z])+\z)/m, '').
+          gsub(/\s+/, ' ')
+        Kramdown::ANSI::Width.truncate(name, length:)
+      end
     end
   end
 

data/lib/ollama_chat/source_fetching.rb

@@ -144,7 +144,7 @@ module OllamaChat::SourceFetching
   # @param words [Integer, nil] The target number of words for the summary (defaults to 100)
   # @return [String, nil] The formatted summary message or nil if content is empty or cannot be processed
   def summarize_source(source_io, source, words: nil)
-    STDOUT.puts "Summarizing #{italic { source_io&.content_type }} document #{source.to_s.inspect} now."
+    infobar.puts "Summarizing #{italic { source_io&.content_type }} document #{source.to_s.inspect} now."
     log(:info, "Source summarized", data: { source: source.to_s, content_type: source_io&.content_type, words: })
     words = words.to_i
     words < 1 and words = 100

data/lib/ollama_chat/tools/get_url.rb

@@ -52,6 +52,13 @@ class OllamaChat::Tools::GetURL
                 - 'summarizing': Returns a condensed summary of the content.
               EOT
             ),
+            words: Tool::Function::Parameters::Property.new(
+              type: 'integer',
+              description: <<~EOT,
+                Target word count for the summary (only applies when
+                document_policy is 'summarizing'). Defaults to 100.
+              EOT
+            ),
           },
           required: %w[url]
         )
@@ -75,6 +82,7 @@ class OllamaChat::Tools::GetURL
     args            = tool_call.function.arguments
     url             = args.url.to_s
     document_policy = args.document_policy.full? || 'ignoring'
+    words           = args.words.to_i
 
     allowed_schemes = Array(config.tools.functions.get_url.schemes?).map(&:to_s)
 
@@ -99,7 +107,13 @@ class OllamaChat::Tools::GetURL
         when 'embedding'
           content = chat.embed_source(source_io, source)
         when 'summarizing'
-          content = chat.summarize_source(source_io, source)
+          content = Infobar.busy(
+            label: 'Summarizing…',
+            frames: :braille7,
+            output: STDOUT,
+          ) do
+            chat.generate(prompt: chat.summarize_source(source_io, source, words:))
+          end
         else
           message = "Invalid document policy #{document_policy.inspect} used."
         end

data/lib/ollama_chat/version.rb

@@ -1,6 +1,6 @@
 module OllamaChat
   # OllamaChat version
-  VERSION         = '0.0.116'
+  VERSION         = '0.0.118'
   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.116 ruby lib
+# stub: ollama_chat 0.0.118 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "ollama_chat".freeze
-  s.version = "0.0.116".freeze
+  s.version = "0.0.118".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/compaction_spec.rb

@@ -9,31 +9,11 @@ describe OllamaChat::Compaction do
 
   connect_to_ollama_server
 
-  let :summarize_template do
-    chat.config.prompts.compaction.summarize
-  end
-
   let :system_template do
-    chat.config.prompts.compaction.system
-  end
-
-  let :assemble_template do
-    chat.config.prompts.compaction.assemble
+    chat.config.prompts.system.compaction
   end
 
   before do
-    allow(chat).to receive(:prompt)
-      .with(:summarize, context: 'compaction')
-      .and_return(summarize_template)
-
-    allow(chat).to receive(:prompt)
-      .with(:system, context: 'compaction')
-      .and_return(system_template)
-
-    allow(chat).to receive(:prompt)
-      .with(:assemble, context: 'compaction')
-      .and_return(assemble_template)
-
     allow(chat).to receive(:log)
   end
 

data/spec/ollama_chat/session_management_spec.rb

@@ -352,10 +352,8 @@ describe OllamaChat::SessionManagement do
       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 }
+      result = chat.report_session
       expect(result).to eq('Generated report')
-      expect(results).to eq(['Generated report'])
     end
 
     it 'returns nil when no messages have content' do
@@ -368,6 +366,8 @@ describe OllamaChat::SessionManagement do
       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(:prompt).with(:report, context: 'system')
+        .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

data/spec/ollama_chat/tools/get_url_spec.rb

@@ -26,7 +26,8 @@ describe OllamaChat::Tools::GetURL do
           name: 'get_url',
           arguments: double(
             url: 'https://www.example.com/foo',
-            document_policy: nil
+            document_policy: nil,
+            words: nil
           )
         )
       )
@@ -55,7 +56,8 @@ describe OllamaChat::Tools::GetURL do
           name: 'get_url',
           arguments: double(
             url:,
-            document_policy: nil
+            document_policy: nil,
+            words: nil
           )
         )
       )
@@ -81,10 +83,11 @@ describe OllamaChat::Tools::GetURL do
       'ToolCall',
       function: double(
         name: 'get_url',
-        arguments: double(
-          url: 'https://www.example.com/foo',
-          document_policy: nil,
-        )
+          arguments: double(
+            url: 'https://www.example.com/foo',
+            document_policy: nil,
+            words: nil,
+          )
       )
     )
 
@@ -111,7 +114,7 @@ describe OllamaChat::Tools::GetURL do
     end
 
     it 'handles the "ignoring" policy' do
-      args = double(url:, document_policy: 'ignoring')
+      args = double(url:, document_policy: 'ignoring', words: nil)
       tool_call = double(function: double(arguments: args))
 
       result = described_class.new.execute(tool_call, chat:)
@@ -120,7 +123,7 @@ describe OllamaChat::Tools::GetURL do
     end
 
     it 'handles the "importing" policy' do
-      args = double(url:, document_policy: 'importing')
+      args = double(url:, document_policy: 'importing', words: nil)
       tool_call = double(function: double(arguments: args))
       expect(chat).to receive(:import_source).with(source_io, URI.parse(url)).and_return('imported content')
 
@@ -130,7 +133,7 @@ describe OllamaChat::Tools::GetURL do
     end
 
     it 'handles the "embedding" policy' do
-      args = double(url:, document_policy: 'embedding')
+      args = double(url:, document_policy: 'embedding', words: nil)
       tool_call = double(function: double(arguments: args))
       expect(chat).to receive(:embed_source).with(source_io, URI.parse(url)).and_return('embedded content')
 
@@ -140,17 +143,29 @@ describe OllamaChat::Tools::GetURL do
     end
 
     it 'handles the "summarizing" policy' do
-      args = double(url:, document_policy: 'summarizing')
+      args = double(url:, document_policy: 'summarizing', words: nil)
       tool_call = double(function: double(arguments: args))
-      expect(chat).to receive(:summarize_source).with(source_io, URI.parse(url)).and_return('summarized content')
+      expect(chat).to receive(:summarize_source).with(source_io, URI.parse(url), words: 0).and_return('summarize prompt')
+      expect(chat).to receive(:generate).with(prompt: 'summarize prompt').and_return('summarized content')
 
       result = described_class.new.execute(tool_call, chat:)
       json = json_object(result)
       expect(json.content).to eq('summarized content')
     end
 
+    it 'handles the "summarizing" policy with custom words' do
+      args = double(url:, document_policy: 'summarizing', words: 50)
+      tool_call = double(function: double(arguments: args))
+      expect(chat).to receive(:summarize_source).with(source_io, URI.parse(url), words: 50).and_return('summarize prompt 50')
+      expect(chat).to receive(:generate).with(prompt: 'summarize prompt 50').and_return('short summary')
+
+      result = described_class.new.execute(tool_call, chat:)
+      json = json_object(result)
+      expect(json.content).to eq('short summary')
+    end
+
     it 'handles an invalid policy' do
-      args = double(url:, document_policy: 'chaos_mode')
+      args = double(url:, document_policy: 'chaos_mode', words: nil)
       tool_call = double(function: double(arguments: args))
 
       result = described_class.new.execute(tool_call, chat:)
@@ -167,7 +182,7 @@ describe OllamaChat::Tools::GetURL do
       expect(chat).to receive(:fetch_source).and_yield(source_io)
       expect(chat).to receive(:add_image).with(chat.images, source_io, URI.parse(url))
 
-      args = double(url:, document_policy: 'ignoring')
+      args = double(url:, document_policy: 'ignoring', words: nil)
       tool_call = double(function: double(arguments: args))
 
       result = described_class.new.execute(tool_call, chat:)
@@ -179,7 +194,7 @@ describe OllamaChat::Tools::GetURL do
       source_io = double('SourceIO', content_type: double(media_type: 'video'))
       expect(chat).to receive(:fetch_source).and_yield(source_io)
 
-      args = double(url:, document_policy: 'ignoring')
+      args = double(url:, document_policy: 'ignoring', words: nil)
       tool_call = double(function: double(arguments: args))
 
       result = described_class.new.execute(tool_call, chat:)

metadata

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