git-fit 0.26.4 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3cea1445cb1e525a1be8c8b814b7b3f69a27aac4e4e42411b5eb993227fef373
-  data.tar.gz: f672f8bfbded7feb9484dc8a214b945338c1a7c3136c1e80f539afe66bb1db0e
+  metadata.gz: af3a8dd685e760e4fa8d6ff50c7629efa91a10a2de35e660e5dd6aabd66d20e3
+  data.tar.gz: 4a84005c2ddc719c6af4b1da341f7c678c44201f58209a742a55a04678d725d1
 SHA512:
-  metadata.gz: e051bd7d24a99544a65b6f537bfb5483980cc399a1977310383f5f3a6ed8c4381bfe3a6811b0de3dc359571f9128b093379b4cc8d4ad923b8252190c7a738fce
-  data.tar.gz: 493fa21dffeb7d8aed1039e3aad0eaee0c3a4c4774129fbedf4293962923fcd456715b900b21dd64e1eee8e9167660bddffc968bb99aa0d8628c637215ed4a14
+  metadata.gz: 8578432f12067d085466bd1f5e754ff235f067ae258d604e1f6b69dc33ade3fe750f05564d34d53e355e474e0ae9499e9e26816ae526107c229808cdb81f2339
+  data.tar.gz: 88b50c6f1f98539540fadd1bdd26e61a54be0a0d54c7228d9881eb441176f2cbe97ceaa12144de08083086921057f864d0e65fabdf377cc576cd0c2b515051bf

data/lib/git_fit/cli/export.rb

@@ -91,7 +91,7 @@ module GitFit
                    :yellow
         return
       end
-      client = GitFit::LLM::Client.from_config(config)
+      client = GitFit::LLM.build(config)
       return if client.nil? # unreachable: disabled handled above
 
       conn = GitFit::DB::Connection.new(config.db_path)

data/lib/git_fit/config.rb

@@ -25,6 +25,7 @@ module GitFit
       },
       'ai' => {
         'enabled' => false,
+        'transport' => 'openai', # "openai" (HTTP, needs endpoint+key) | "opencode" (CLI, zero credentials)
         'endpoint' => nil, # OpenAI-compatible base URL, e.g. https://open.bigmodel.cn/api/paas/v4
         'model' => nil,
         'api_key_env' => 'AI_API_KEY',
@@ -127,6 +128,9 @@ module GitFit
       if ENV['GIT_FIT_AI_ENABLED'] && !ENV['GIT_FIT_AI_ENABLED'].empty?
         @data['ai']['enabled'] = typed_value(ENV['GIT_FIT_AI_ENABLED'])
       end
+      if ENV['GIT_FIT_AI_TRANSPORT'] && !ENV['GIT_FIT_AI_TRANSPORT'].empty?
+        @data['ai']['transport'] = ENV['GIT_FIT_AI_TRANSPORT']
+      end
       if ENV['GIT_FIT_AI_ENDPOINT'] && !ENV['GIT_FIT_AI_ENDPOINT'].empty?
         @data['ai']['endpoint'] = ENV['GIT_FIT_AI_ENDPOINT']
       end

data/lib/git_fit/config_template.rb

@@ -69,8 +69,18 @@ module GitFit
           # csv:
           #   path: site/workouts.csv
 
-          # gpx:
-          #   path: site/gpx_out
+        # gpx:
+        #   path: site/gpx_out
+
+        # ai:                                          # env: GIT_FIT_AI_ENABLED
+        #   enabled: false
+        #   transport: openai                          # env: GIT_FIT_AI_TRANSPORT
+        #                                              #   openai   = OpenAI-compatible HTTP (needs endpoint + api key)
+        #                                              #   opencode = shell out to `opencode run` CLI (zero credentials,
+        #                                              #              built-in anonymous token, free models like opencode/big-pickle)
+        #   endpoint: ""                               # env: GIT_FIT_AI_ENDPOINT (openai transport only)
+        #   model: ""                                  # env: GIT_FIT_AI_MODEL
+        #   api_key_env: AI_API_KEY                    # env: GIT_FIT_AI_API_KEY_ENV (openai transport only)
 
         privacy:
           start_end_range: 200

data/lib/git_fit/llm/opencode_client.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+require 'open3'
+require 'tmpdir'
+require 'json'
+
+module GitFit
+  module LLM
+    # opencode CLI transport: shells out to `opencode run`, which carries the
+    # built-in anonymous device token — zero-credential access to free models
+    # (opencode zen free tier rejects direct HTTP callers outside the CLI).
+    #
+    # Same interface as LLM::Client (chat(messages:) -> String). git-fit keeps
+    # all generation logic; opencode is a transport only.
+    class OpencodeClient
+      attr_reader :model, :timeout
+
+      # Returns nil when ai.enabled is false (caller decides to warn+skip).
+      # No endpoint/api_key validation — the CLI needs no credentials.
+      def self.from_config(config)
+        ai = config.ai_config
+        return nil unless ai['enabled']
+
+        if ai['model'].to_s.strip.empty?
+          raise ConfigError,
+                "LLM: ai.model not configured\n" \
+                '  Fix: set ai.model in config.yml ' \
+                '(e.g. opencode/big-pickle, opencode/mimo-v2.6-flash-free)'
+        end
+
+        new(model: ai['model'], timeout: ai['timeout'])
+      end
+
+      def initialize(model:, timeout: 60)
+        @model = model
+        @timeout = timeout.is_a?(Numeric) ? timeout : 60
+      end
+
+      # messages: [{ 'role' => 'system'|'user', 'content' => '...' }, ...]
+      # Merged into a single stdin prompt (system + blank line + user).
+      # temperature is ignored — opencode run has no such flag.
+      def chat(messages:, temperature: nil)
+        _temperature = temperature # deliberately ignored — opencode run has no such flag
+        prompt = build_prompt(messages)
+        status, stdout, stderr = run_opencode(prompt, args)
+        extract_text(status, stdout, stderr)
+      end
+
+      private
+
+      def build_prompt(messages)
+        messages.map { |m| m['content'].to_s }.reject(&:empty?).join("\n\n")
+      end
+
+      def args
+        ['run', '--format', 'json', '--pure', '-m', @model]
+      end
+
+      # Process seam — specs stub this method (zero process, zero network),
+      # mirroring the http_post stub convention of LLM::Client.
+      # Returns [status, stdout, stderr].
+      def run_opencode(stdin_data, cmd_args)
+        Dir.mktmpdir do |dir|
+          io = { out: nil, err: nil, status: nil }
+          Open3.popen3('opencode', *cmd_args, chdir: dir) do |stdin, stdout, stderr, wait_thr|
+            deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + @timeout
+            watchdog = Thread.new do
+              remaining = deadline - Process.clock_gettime(Process::CLOCK_MONOTONIC)
+              next sleep(remaining) if remaining.positive?
+              next if wait_thr.dead?
+              Process.kill('KILL', wait_thr.pid)
+            rescue StandardError
+              nil
+            end
+            begin
+              stdin.write(stdin_data)
+              stdin.close
+              io[:out] = stdout.read
+              io[:err] = stderr.read
+              status = wait_thr.value
+              raise Timeout::Error if status.signaled? && status.termsig == Signal.list['KILL']
+              io[:status] = status.exitstatus
+            ensure
+              watchdog.kill
+            end
+          end
+          [io[:status], io[:out] || '', io[:err] || '']
+        end
+      end
+
+      def extract_text(status, stdout, stderr)
+        tail = stderr.to_s[-200..] || stderr.to_s
+        if status.nil? || status != 0
+          raise ServerError,
+                "LLM: opencode run failed (exit #{status}) — #{tail}\n" \
+                '  Fix: verify opencode is installed and runnable: opencode --version'
+        end
+
+        lines = stdout.to_s.split("\n").filter_map do |line|
+          JSON.parse(line)
+        rescue JSON::ParserError, TypeError
+          nil
+        end
+        texts = lines.select { |ev| ev['type'] == 'text' }
+        text = texts.last&.dig('part', 'text')
+        return text unless text.to_s.strip.empty?
+
+        raise BadResponseError,
+              "LLM: opencode stdout has no text event (#{lines.size} JSON lines)" \
+              " — #{tail}\n" \
+              '  Fix: retry; if persistent, run the prompt manually: ' \
+              'printf <prompt> | opencode run --format json --pure -m ' + @model
+      end
+    end
+  end
+end

data/lib/git_fit/llm.rb

@@ -8,8 +8,19 @@ require_relative 'llm/errors'
 require_relative 'llm/template'
 require_relative 'llm/prompts'
 require_relative 'llm/client'
+require_relative 'llm/opencode_client'
 
 module GitFit
   module LLM
+    # Transport selection (ai.transport): "opencode" shells out to the opencode
+    # CLI (zero credentials, free models inside the opencode client identity);
+    # anything else (default "openai") uses the OpenAI-compatible HTTP client.
+    def self.build(config)
+      if config.ai_config['transport'].to_s.strip == 'opencode'
+        OpencodeClient.from_config(config)
+      else
+        Client.from_config(config)
+      end
+    end
   end
 end

data/lib/git_fit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GitFit
-  VERSION = '0.26.4'
+  VERSION = '0.27.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git-fit
 version: !ruby/object:Gem::Version
-  version: 0.26.4
+  version: 0.27.0
 platform: ruby
 authors:
 - Lax
@@ -350,6 +350,7 @@ files:
 - lib/git_fit/llm.rb
 - lib/git_fit/llm/client.rb
 - lib/git_fit/llm/errors.rb
+- lib/git_fit/llm/opencode_client.rb
 - lib/git_fit/llm/prompts.rb
 - lib/git_fit/llm/template.rb
 - lib/git_fit/mcp.rb