ollama_chat 0.0.117 → 0.0.118

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbe0a034dee8079ea14e573b0e98624ebaa3311baaf60e1bd666d7f7b0d61dda
-  data.tar.gz: 2a2b0c1b00ce5db2fa4b20660d8cda86669f1bac50e62352a07953e0c327d863
+  metadata.gz: f5db2a60d43d3a57a30e3c33a16b9ba26e60807afd9ff6b74c0781af25fe2516
+  data.tar.gz: e670d0cfcbbcfa815e4b9a7f6e0ccb6093dc4986b736035aea3dc38b4bc646ab
 SHA512:
-  metadata.gz: f187ae33f48c198b1aa15d680b5d7dd45e96c8ba7bcb71bf80adf5d0cb049a766d79d57d8bad32175363c490cfe94a94908b1eba4a1ba28a8b0e9896065079ed
-  data.tar.gz: 0d61b926d6e7018d5f21d52ed06d36e81ea859dc5f288a0247834def14245813f1306bf444baaf715c8ec37df20ea64d97f03279045e34eb669a29c9facadb23
+  metadata.gz: 8f7cb31ed0e38db5baca42a29076b3a01e3bae64d5a80d55584bd0ecdaaa41fd15eb814fc8b34ac55d2e73e4d767c52f305167cd8d2a7b32af4e9668f7d43706
+  data.tar.gz: a54ebe900c8b8a2c9e31ce3a4aded809f1b6e179679b2f2b4e3174f9e4ba5f6c976c8e7f1aaf3ae7efb8b8c8417f605b8c2522676eb0952f6d4b38165ac087af

data/CHANGES.md

@@ -1,5 +1,44 @@
 # 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

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/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

@@ -444,7 +444,15 @@ module OllamaChat::SessionManagement
                end
     template or return
 
-    generate(prompt: template.to_s % { content: })
+    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.
@@ -485,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.117'
+  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.117 ruby lib
+# stub: ollama_chat 0.0.118 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "ollama_chat".freeze
-  s.version = "0.0.117".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

@@ -366,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.117
+  version: 0.0.118
 platform: ruby
 authors:
 - Florian Frank