summarize-ruby 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9aa6126addfe563121bc5cfe65df2e82b3e85dfa7418b1cb4895879c07a7f6f9
-  data.tar.gz: 550c25f558569a2f4c27f52a2ae6ac4c968e2a86812ae3dcfb706ce4682bc4ce
+  metadata.gz: 689430b84d46027bb3dfe7d7ab30c6ffd6a8627fdce5ca1540f718d41a384c18
+  data.tar.gz: 6a27144a61b00a3581f7495f3662c714df05ead4bf280fc83b5c3edb6a0ff3f1
 SHA512:
-  metadata.gz: 3ebc8961118671953db2abb961a0c7568b001416fa533483135403fd6c7e9e470c27feb815f00d530c1419cdadf81fefc39e46e40a4e82231724592172691c5c
-  data.tar.gz: 1a039f756c61eab714f9ed3864acdea33a3479ee7167514daac0bb4b709af34fe610c22a8414776c6eade626d6956f19236a2a2555440e83ebd76547ee6d72b4
+  metadata.gz: 19e417b45e70c624c5103a767effe4359678e20053c162738ad27c5065cdd574f0a003f8c615badd82a953bb53288922aaba7df434f234f020b02a5d0c717423
+  data.tar.gz: 68bc215c350bb6ec0c6926936ac8bd57ce523e56de73be505da920c8f80026af6ae1e19aa376cc03fe2f23e67de1e33588bc6fb76aa37cfdf18fb253f4aa49e3

data/lib/summarize/client.rb

@@ -68,6 +68,8 @@ module Summarize
     end
 
     def stream(input, **opts, &block)
+      validate_binary!
+      validate_version!
       args = build_args(input, stream: true, json: false, **opts)
 
       full_output = +""
@@ -134,6 +136,7 @@ module Summarize
 
     def execute(args)
       validate_binary!
+      validate_version!
 
       Open3.capture3(command_env, *args)
     end
@@ -146,6 +149,18 @@ module Summarize
       raise BinaryNotFoundError, path
     end
 
+    def validate_version!
+      return if config.skip_version_check
+
+      installed = config.cli_version
+      return unless installed # can't detect — skip gracefully
+
+      required = Summarize::MINIMUM_CLI_VERSION
+      if Gem::Version.new(installed) < Gem::Version.new(required)
+        raise VersionMismatchError.new(installed, required)
+      end
+    end
+
     def handle_error!(status, stderr)
       case status.exitstatus
       when 130

data/lib/summarize/configuration.rb

@@ -3,7 +3,8 @@
 module Summarize
   class Configuration
     attr_accessor :default_model, :default_length, :default_language,
-                  :default_cli, :timeout, :retries, :env
+                  :default_cli, :timeout, :retries, :env,
+                  :skip_version_check
     attr_writer :binary_path
 
     def initialize
@@ -15,14 +16,32 @@ module Summarize
       @timeout = nil
       @retries = nil
       @env = {}
+      @skip_version_check = false
+      @cli_version = nil
     end
 
     def binary_path
       @binary_path ||= find_binary
     end
 
+    def cli_version
+      @cli_version ||= detect_cli_version
+    end
+
+    def reset_cli_version!
+      @cli_version = nil
+    end
+
     private
 
+    def detect_cli_version
+      output = `#{binary_path} --version 2>/dev/null`.strip
+      return nil if output.empty?
+
+      # Extract semver part — CLI may output "0.11.1 (ae52818b)"
+      output[/\d+\.\d+\.\d+/]
+    end
+
     def find_binary
       path = `which summarize 2>/dev/null`.strip
       return path unless path.empty?

data/lib/summarize/errors.rb

@@ -28,4 +28,17 @@ module Summarize
       super("summarize exited with code #{exit_code}: #{stderr}")
     end
   end
+
+  class VersionMismatchError < Error
+    attr_reader :installed_version, :required_version
+
+    def initialize(installed_version, required_version)
+      @installed_version = installed_version
+      @required_version = required_version
+      super(
+        "summarize CLI #{installed_version} is too old (requires >= #{required_version}). " \
+        "Update via: npm i -g @steipete/summarize"
+      )
+    end
+  end
 end

data/lib/summarize/version.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
 module Summarize
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
+  MINIMUM_CLI_VERSION = "0.11.1"
 end

data/lib/summarize.rb

@@ -46,5 +46,28 @@ module Summarize
     def extract(input, **opts)
       Client.new.extract(input, **opts)
     end
+
+    # Eagerly check CLI version. Returns the version string or raises
+    # VersionMismatchError / BinaryNotFoundError.
+    #
+    #   Summarize.check_version!  # => "0.10.0"
+    #
+    def check_version!
+      config = configuration
+      path = config.binary_path
+
+      unless path == "summarize" || File.executable?(path)
+        raise BinaryNotFoundError, path
+      end
+
+      installed = config.cli_version
+      required = MINIMUM_CLI_VERSION
+
+      if installed && Gem::Version.new(installed) < Gem::Version.new(required)
+        raise VersionMismatchError.new(installed, required)
+      end
+
+      installed
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: summarize-ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Martiano
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-19 00:00:00.000000000 Z
+date: 2026-02-21 00:00:00.000000000 Z
 dependencies: []
 description: A Ruby gem that wraps the summarize CLI tool, providing a clean Ruby
   API for summarizing URLs, files, and text using various LLM providers.