git-fit 0.22.0 → 0.23.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f9fda747ee0bdc1b1d6588bce636576cb8e371ea0ae36b2bcfedd377a516891
-  data.tar.gz: e19094889528196ead4715706a46fe035516d219ba2c69264cf32e4fc0820da6
+  metadata.gz: 6d74822bf3f31986abcfc5c12266b5563a2f52b62b2f3495c4fc4a13c351540c
+  data.tar.gz: 423954310f4f01049fa29b24d40ca8e6b9bce856429446d22a84b91817bd0024
 SHA512:
-  metadata.gz: a3fec0c7cfe0f51d7087698900585e480b9ce52d73aa6a8238cfa2493d5500e9d20e93087dda785da91844b3099ea1c4d36b4e642dbd867187d94843ae63b466
-  data.tar.gz: b98ec2e23dc34c3c5694d4627c6ae12a153a2b185d76f0f9567903c2e39a4ff6bb7995ff928e4b17ef4978cdd0a03485e38ae41ef17d9f95bf63f16870d2324b
+  metadata.gz: 1c01b5a2fe18991ad86bddb9c2d52f529b69d4c047e168e63fa38cd184baedbbd72539b6be210cf2b21bc11bf0d4c4e27c996d7eb0437e2319a60bda60660999
+  data.tar.gz: ebcbb62b7e5ff968c6e814affb9fc733c441e850205ba99ec063df96c36e72b2418892229490d8a6d528e3f4d44f49284cd5f0be0659b21e930415069e336cfb

data/lib/git-fit.rb

@@ -90,7 +90,9 @@ require_relative 'git_fit/install/actions'
 require_relative 'git_fit/cli/install_cli'
 require_relative 'git_fit/cli/purge_cli'
 require_relative 'git_fit/cli/gh_cli'
+require_relative 'git_fit/mcp'
 require_relative 'git_fit/cli/export'
+require_relative 'git_fit/cli/mcp'
 require_relative 'git_fit/cli/import_cli'
 require_relative 'git_fit/cli/geo_cli'
 require_relative 'git_fit/strava_web/file_check'

data/lib/git_fit/cli/mcp.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'mcp'
+
+module GitFit
+  class McpCLI < Thor
+    desc 'serve', 'Start the MCP stdio server (read-only workouts data for AI clients)'
+
+    no_commands do
+      def git_fit_config
+        @git_fit_config ||= GitFit::Config.new(options[:config])
+      end
+    end
+
+    def serve
+      config = git_fit_config
+      server = GitFit::MCP.build_server(config)
+      ::MCP::Server::Transports::StdioTransport.new(server).open
+    rescue StandardError => e
+      say_status :error, "MCP server failed: #{e.message}", :red
+      exit 1
+    end
+  end
+end

data/lib/git_fit/cli.rb

@@ -23,6 +23,9 @@ module GitFit
     desc 'export SUBCOMMAND', 'Export activities to various formats'
     subcommand 'export', ExportCLI
 
+    desc 'mcp serve', 'Start the MCP stdio server (read-only workouts data for AI clients)'
+    subcommand 'mcp', McpCLI
+
     desc 'version', 'Show version'
     def version
       puts "git-fit v#{GitFit::VERSION}"

data/lib/git_fit/export/ai.rb

@@ -90,10 +90,34 @@ module GitFit
         end
       end
 
+      # 报告周期取「最近完整期」：当最新数据落在进行中的当期，报告主体回退到
+      # 上一完整期（当期在上一期无数据时保留当期，如新用户/空库场景）。
+      # 当月的部分数据仍会出现在活动摘要中，模板要求模型仅作『最新动态』提及。
       def period_label
         latest = activity_rows.find { |r| r[:start_date_local] }
-        base = latest ? latest[:start_date_local].to_s : Time.now.utc.iso8601
-        @period == 'yearly' ? base[0, 4] : base[0, 7]
+        base = latest ? latest[:start_date_local].to_s[0, period_width] : Time.now.utc.iso8601[0, period_width]
+        current = Time.now.strftime(period_format)
+        return base if base < current
+
+        previous = previous_period(current)
+        activity_rows.any? { |r| r[:start_date_local].to_s.start_with?(previous) } ? previous : base
+      end
+
+      def period_width
+        @period == 'yearly' ? 4 : 7
+      end
+
+      def period_format
+        @period == 'yearly' ? '%Y' : '%Y-%m'
+      end
+
+      def previous_period(period)
+        if @period == 'yearly'
+          (period.to_i - 1).to_s
+        else
+          require 'date'
+          (Date.parse("#{period}-01") << 1).strftime('%Y-%m')
+        end
       end
 
       # Digest covers everything that changes the output: data, prompt mode,
@@ -104,6 +128,7 @@ module GitFit
           'model' => @client.model,
           'language' => @language,
           'period_mode' => @period,
+          'period' => period_label,
           'stats' => stats,
           'activities' => lines,
         )
@@ -185,6 +210,7 @@ module GitFit
       def slots(stats, _rows)
         {
           'period' => period_label,
+          'today' => Time.now.strftime('%Y-%m-%d'),
           'stats' => ::JSON.generate(stats),
           'activities_summary' => activity_lines.join("\n"),
           'language' => @language,

data/lib/git_fit/llm/prompts.rb

@@ -25,6 +25,7 @@ module GitFit
 
           ## 写作要求
           - 汇总统计中的 summary 是全历史累计，不是 {{period}} 当期数据；当期数据以 monthly/yearly 中 {{period}} 对应行为准，活动摘要可用作补充
+          - 今天是 {{today}}。若活动摘要中出现 {{period}} 之后的当月数据，那是不完整的当月数据：仅在结尾以『最新动态』一句带过并明确标注，不纳入总结主体，禁止据此得出训练量骤降/中断等跨周期结论
           - 用 {{language}} 撰写，Markdown 格式，正文 800 字以内
           - 结构：先总后分 —— 总体负荷印象 → 亮点 → 隐忧
           - 所有数字必须来自输入数据，禁止编造或外推
@@ -43,6 +44,7 @@ module GitFit
 
           ## 分析要求
           - 汇总统计中的 summary 是全历史累计，不是 {{period}} 当期数据；对比当期与历史时以 monthly/yearly 分组行为准
+          - 今天是 {{today}}。当月不完整的数据（如月内仅数天）只可作为『最新动态』级别观察并明确标注，禁止据此输出骤降/中断等趋势性 anomaly
           - 关注维度：趋势变化、个人纪录（PB）、疲劳信号、季节性规律、运动项目占比变化
           - 输出 3-6 条，按重要性排序
           - 数据不足以支撑的结论不要输出；无异常时给少量 info 条目即可，禁止强行制造发现
@@ -62,6 +64,7 @@ module GitFit
 
           ## 建议要求
           - 汇总统计中的 summary 是全历史累计，不是 {{period}} 当期数据；当期负荷以 monthly/yearly 中 {{period}} 对应行为准
+          - 今天是 {{today}}。不完整的当月数据不足以支撑训练量调整类建议；如有，仅作观察性提示并标注
           - 输出 2-4 条可执行建议，每条说明数据依据
           - 除非数据明确支持（如连续多周稳定负荷且无疲劳信号），不建议提高训练量
           - 关注一致性、恢复与渐进，而非单次表现

data/lib/git_fit/mcp/tools.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'sequel'
+require 'mcp'
+
+module GitFit
+  module MCP
+    # 只读 MCP tools —— expose 本地 workouts DB 给 AI 客户端（Claude/Code/opencode 等）。
+    # 数据已公开（Pages 站点），无隐私增量；SQLite readonly 打开。
+    #
+    # 输出格式约定：query_activities 使用与 insights 摘要一致的紧凑行
+    # （run_id | 日期 类型 距离 时长 HR 爬升），供 get_activity 下钻。
+    module Tools
+      ACTIVITY_COLUMNS = %i[
+        run_id name distance moving_time elapsed_time sport_category sport_type
+        start_date start_date_local location_country summary_polyline
+        average_heartrate max_heartrate average_cadence max_cadence
+        average_power max_power average_temperature calories average_speed
+        elevation_gain elevation_loss elevation_min elevation_max steps source
+      ].freeze
+
+      module_function
+
+      def db(config)
+        Sequel.sqlite(config.db_path, readonly: true)
+      end
+
+      def activity_line(row)
+        parts = [row[:run_id].to_s, row[:start_date_local].to_s[0, 10], row[:sport_category].to_s]
+        parts << format('%.1fkm', row[:distance] / 1000.0) if row[:distance]
+        parts << "#{(row[:moving_time] / 60).round}min" if row[:moving_time]
+        parts << "HR#{row[:average_heartrate].round}" if row[:average_heartrate]
+        parts << "asc#{row[:elevation_gain].round}m" if row[:elevation_gain]
+        parts.join(' | ')
+      end
+    end
+
+    class QueryActivitiesTool < ::MCP::Tool
+      tool_name 'query_activities'
+      description '查询运动活动列表（按日期范围/运动类型过滤，返回最近的紧凑摘要行）。' \
+                  '行格式：run_id | 日期 | 类型 | 距离 | 时长 | HR | 爬升。'
+
+      input_schema(
+        properties: {
+          from_date: { type: 'string', description: '起始日期 YYYY-MM-DD（含）', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+          to_date: { type: 'string', description: '结束日期 YYYY-MM-DD（含）', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+          sport: { type: 'string', description: '运动类型（ride/run/hike/walk/swim/workout/other）' },
+          limit: { type: 'integer', description: '返回条数上限（1-500）', default: 50 },
+        },
+      )
+
+      class << self
+        def call(server_context:, from_date: nil, to_date: nil, sport: nil, limit: 50)
+          db = GitFit::MCP::Tools.db(server_context[:config])
+          rows = db[:activities].order(Sequel.desc(:start_date_local)).limit(2000).all
+          rows = rows.select { |r| r[:start_date_local].to_s[0, 10] >= from_date } if from_date
+          rows = rows.select { |r| r[:start_date_local].to_s[0, 10] <= to_date } if to_date
+          rows = rows.select { |r| r[:sport_category] == sport } if sport && sport != 'all'
+          rows = rows.first(limit.to_i.clamp(1, 500))
+          lines = rows.map { |r| GitFit::MCP::Tools.activity_line(r) }
+          body = lines.empty? ? '无匹配活动' : "#{rows.size} 条匹配：\n#{lines.join("\n")}"
+          ::MCP::Tool::Response.new([{ type: 'text', text: body }])
+        ensure
+          db&.disconnect
+        end
+      end
+    end
+
+    class GetActivityTool < ::MCP::Tool
+      tool_name 'get_activity'
+      description '按 run_id 获取单个活动的全字段详情。run_id 来自 query_activities。'
+
+      input_schema(
+        properties: {
+          run_id: { type: 'string', description: '活动 ID（如 garmin_cn_12345678）' },
+        },
+        required: ['run_id'],
+      )
+
+      class << self
+        def call(run_id:, server_context:)
+          db = GitFit::MCP::Tools.db(server_context[:config])
+          row = db[:activities].first(run_id: run_id)
+          unless row
+            return ::MCP::Tool::Response.new(
+              [{ type: 'text', text: "活动不存在：#{run_id}\n  Fix: 先用 query_activities 查询可用 run_id" }],
+              error: true,
+            )
+          end
+          ::MCP::Tool::Response.new([{ type: 'text', text: JSON.pretty_generate(
+            GitFit::MCP::Tools::ACTIVITY_COLUMNS.to_h { |k| [k, row[k]] },
+          ) }])
+        ensure
+          db&.disconnect
+        end
+      end
+    end
+
+    class GetStatsTool < ::MCP::Tool
+      tool_name 'get_stats'
+      description '获取全量统计摘要：summary（全历史累计）/ monthly（按月）/ yearly（按年）/ streaks（连续天数）/ activity_types。' \
+                  '注意 summary 是全历史累计，当期对比请看 monthly/yearly 分组行。'
+
+      input_schema(properties: {})
+
+      class << self
+        def call(server_context:)
+          db = GitFit::MCP::Tools.db(server_context[:config])
+          stats = GitFit::Export::Calculator.new(db: db).call
+          ::MCP::Tool::Response.new([{ type: 'text', text: JSON.pretty_generate(stats) }])
+        ensure
+          db&.disconnect
+        end
+      end
+    end
+  end
+end

data/lib/git_fit/mcp.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative 'mcp/tools'
+
+module GitFit
+  module MCP
+    module_function
+
+    # 构建 MCP server（stdio transport 由 CLI 层启动）。
+    def build_server(config)
+      ::MCP::Server.new(
+        name: 'git-fit-workouts',
+        version: GitFit::VERSION,
+        tools: [QueryActivitiesTool, GetActivityTool, GetStatsTool],
+        server_context: { config: config },
+      )
+    end
+  end
+end

data/lib/git_fit/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git-fit
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.23.1
 platform: ruby
 authors:
 - Lax
@@ -247,6 +247,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
 description: A git extension CLI for aggregating, managing, and exporting fitness
   activity data from multiple sources (Garmin, Strava, Keep, etc.)
 email:
@@ -275,6 +289,7 @@ files:
 - lib/git_fit/cli/gh_cli.rb
 - lib/git_fit/cli/import_cli.rb
 - lib/git_fit/cli/install_cli.rb
+- lib/git_fit/cli/mcp.rb
 - lib/git_fit/cli/purge_cli.rb
 - lib/git_fit/cli/strava.rb
 - lib/git_fit/cli/sync.rb
@@ -332,6 +347,8 @@ files:
 - lib/git_fit/llm/errors.rb
 - lib/git_fit/llm/prompts.rb
 - lib/git_fit/llm/template.rb
+- lib/git_fit/mcp.rb
+- lib/git_fit/mcp/tools.rb
 - lib/git_fit/parser.rb
 - lib/git_fit/parser/base.rb
 - lib/git_fit/parser/fit.rb