git-fit 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3c36d045a4ed37a0eaad4f219367f1d514af31c26bcae72e76cbeec7bb5dbb0
-  data.tar.gz: ab845ce910206dae48a131315427bf06604bd02988b097eb462ae5805727ab97
+  metadata.gz: 565aea6097483469ad19f905c14526df7fc9acdf8490c36f5b6edc3664395778
+  data.tar.gz: fdaf45ded02748b399694745b49abc206044c6504a3ecb6767abc4269f15e07d
 SHA512:
-  metadata.gz: 9822b621a741ce52c68c6510f6f73a1da52ae544c4371d05ffe430cacd1d882a914f4bd6959b98add49a13595b0ffc703b4258fd5dd5a6535ad887117d5e8be0
-  data.tar.gz: 139da861fd411de27553e13e03ec0b3c7d94e5019c64e3e6ba820415e49f87f43ed58490565c408801554f30c3b0a2fa03133e48c4d783ffa7276b54e9f67e22
+  metadata.gz: 2c7213a9ef0e3c1151601d70cac666c91e32b545cfbf18c81882eccfc6f68b54ada354fec65f1eba1ce05ddada2e54ca7f9e23f5cef75ebbf59dc16e1c99e3b7
+  data.tar.gz: 2c2df21e495f16a25ff000992325012f8ff80acdb1c255d416749648e102dbb64d1ccd041cbc05bc68ba927a6cecd34fbac0b1b511d238e36f445169fcfd7998

data/lib/git-fit.rb

@@ -54,11 +54,16 @@ require_relative "git_fit/parser"
 require_relative "git_fit/source"
 require_relative "git_fit/timezone/resolver"
 require_relative "git_fit/privacy/polyline_filter"
+require_relative "git_fit/import"
 require_relative "git_fit/sync/base"
 require_relative "git_fit/sync/strava"
+require_relative "git_fit/db/rebuild"
 require_relative "git_fit/db/connection"
 require_relative "git_fit/db/activity"
 require_relative "git_fit/export"
 require_relative "git_fit/db/cli"
+require_relative "git_fit/install/actions"
+require_relative "git_fit/cli/install_cli"
 require_relative "git_fit/cli/export"
+require_relative "git_fit/cli/import_cli"
 require_relative "git_fit/cli"

data/lib/git_fit/cli/import_cli.rb

@@ -0,0 +1,169 @@
+require "thor"
+
+module GitFit
+  class ImportCLI < Thor
+    FILE_SOURCES = %w[gpx fit tcx].freeze
+
+    desc "all", "Import from all sources (gpx, fit, tcx)"
+    option :source, type: :string, aliases: "-s",
+           desc: "Import source(s) — comma-separated (default: gpx,fit,tcx)"
+    option :activity, type: :array, desc: "Filter by sport type", aliases: "--act"
+    option :sport, type: :string, desc: "Override sport_category for GPX files"
+    def all
+      sources = (options[:source] || "gpx,fit,tcx").split(",").map(&:strip).map(&:downcase)
+      unknown = sources.reject { |s| FILE_SOURCES.include?(s) }
+      unless unknown.empty?
+        say_status :error, "Unknown source(s): #{unknown.join(', ')}. Supported: gpx, fit, tcx", :red
+        return
+      end
+
+      config = GitFit::Config.new
+      db = GitFit::DB::Connection.new(config.db_path).db
+      filter = options[:activity]&.map(&:strip)&.map(&:downcase)
+      time_budget = config.dig("sync", "time_budget")
+      sport_override = options[:sport]
+
+      total = 0
+      sources.each do |source|
+        say_status :import, source, :green
+        adapter = GitFit::Import::LocalFile.new(
+          config: {}, db:, activity_filter: filter,
+          time_budget: time_budget,
+          sources: [source],
+          sport_override: sport_override
+        )
+        count = adapter.call
+        say_status :done, "#{source}: #{count} activities", :green
+        total += count
+      rescue => e
+        say_status :error, "#{source}: #{e.message}", :red
+      end
+
+      if total.zero?
+        say_status :warn, "0 activities imported", :yellow
+      else
+        say_status :done, "Total: #{total} activities", :green
+      end
+    end
+
+    default_command :all
+
+    desc "gpx", "Import GPX files from data/import/gpx/"
+    option :activity, type: :array, desc: "Filter by sport type", aliases: "--act"
+    option :sport, type: :string, desc: "Override sport_category for GPX files"
+    def gpx
+      config = GitFit::Config.new
+      db = GitFit::DB::Connection.new(config.db_path).db
+      filter = options[:activity]&.map(&:strip)&.map(&:downcase)
+      time_budget = config.dig("sync", "time_budget")
+      sport_override = options[:sport]
+
+      say_status :import, "gpx", :green
+      adapter = GitFit::Import::LocalFile.new(
+        config: {}, db:, activity_filter: filter,
+        time_budget: time_budget,
+        sources: ["gpx"],
+        sport_override: sport_override
+      )
+
+      begin
+        count = adapter.call
+        if count == 0
+          say_status :warn, "gpx: 0 activities (already imported or none found)", :yellow
+        else
+          say_status :done, "gpx: #{count} activities", :green
+        end
+        count
+      rescue => e
+        say_status :error, "gpx: #{e.message}", :red
+        0
+      end
+    end
+
+    desc "tcx", "Import TCX files from data/import/tcx/"
+    option :activity, type: :array, desc: "Filter by sport type", aliases: "--act"
+    def tcx
+      config = GitFit::Config.new
+      db = GitFit::DB::Connection.new(config.db_path).db
+      filter = options[:activity]&.map(&:strip)&.map(&:downcase)
+      time_budget = config.dig("sync", "time_budget")
+
+      say_status :import, "tcx", :green
+      adapter = GitFit::Import::LocalFile.new(
+        config: {}, db:, activity_filter: filter,
+        time_budget: time_budget,
+        sources: ["tcx"]
+      )
+
+      begin
+        count = adapter.call
+        if count == 0
+          say_status :warn, "tcx: 0 activities (already imported or none found)", :yellow
+        else
+          say_status :done, "tcx: #{count} activities", :green
+        end
+        count
+      rescue => e
+        say_status :error, "tcx: #{e.message}", :red
+        0
+      end
+    end
+
+    desc "fit", "Import FIT files from data/import/fit/"
+    option :activity, type: :array, desc: "Filter by sport type", aliases: "--act"
+    def fit
+      config = GitFit::Config.new
+      db = GitFit::DB::Connection.new(config.db_path).db
+      filter = options[:activity]&.map(&:strip)&.map(&:downcase)
+      time_budget = config.dig("sync", "time_budget")
+
+      say_status :import, "fit", :green
+      adapter = GitFit::Import::LocalFile.new(
+        config: {}, db:, activity_filter: filter,
+        time_budget: time_budget,
+        sources: ["fit"]
+      )
+
+      begin
+        count = adapter.call
+        if count == 0
+          say_status :warn, "fit: 0 activities (already imported or none found)", :yellow
+        else
+          say_status :done, "fit: #{count} activities", :green
+        end
+        count
+      rescue => e
+        say_status :error, "fit: #{e.message}", :red
+        0
+      end
+    end
+
+    desc "apple_health", "Import from Apple Health export.zip"
+    option :activity, type: :array, desc: "Filter by sport type", aliases: "--act"
+    def apple_health
+      config = GitFit::Config.new
+      db = GitFit::DB::Connection.new(config.db_path).db
+      filter = options[:activity]&.map(&:strip)&.map(&:downcase)
+      time_budget = config.dig("sync", "time_budget")
+
+      say_status :import, "apple_health", :green
+      adapter = GitFit::Import::AppleHealth.new(
+        config: {}, db:, activity_filter: filter,
+        time_budget: time_budget
+      )
+
+      begin
+        count = adapter.call
+        if count == 0
+          say_status :warn, "apple_health: 0 activities (already imported or none found)", :yellow
+        else
+          say_status :done, "apple_health: #{count} activities", :green
+        end
+        count
+      rescue => e
+        say_status :error, "apple_health: #{e.message}", :red
+        0
+      end
+    end
+  end
+end

data/lib/git_fit/cli/install_cli.rb

@@ -0,0 +1,22 @@
+require "thor"
+require "fileutils"
+
+module GitFit
+  class InstallCLI < Thor
+      desc "actions", "Install GitHub Actions (db-cache restore/save)"
+      def actions
+        base = ".github/actions/db-cache"
+        restore_path = File.join(base, "restore", "action.yml")
+        save_path = File.join(base, "save", "action.yml")
+
+        FileUtils.mkdir_p(File.dirname(restore_path))
+        FileUtils.mkdir_p(File.dirname(save_path))
+
+        File.write(restore_path, GitFit::Install::Actions::RESTORE_ACTION)
+        File.write(save_path, GitFit::Install::Actions::SAVE_ACTION)
+
+        say_status :created, restore_path, :green
+        say_status :created, save_path, :green
+      end
+  end
+end

data/lib/git_fit/cli.rb

@@ -13,6 +13,9 @@ module GitFit
     desc "db SUBCOMMAND", "Database operations"
     subcommand "db", DB::CLI
 
+    desc "import SUBCOMMAND", "Import activities from local files"
+    subcommand "import", ImportCLI
+
     desc "export SUBCOMMAND", "Export activities to various formats"
     subcommand "export", ExportCLI
 
@@ -58,6 +61,9 @@ module GitFit
       say_status :error, "Parse failed: #{e.message}", :red
     end
 
+    desc "install SUBCOMMAND", "Install project assets (actions)"
+    subcommand "install", InstallCLI
+
     desc "init", "Generate config.yml"
     option :output, type: :string, desc: "Output path", aliases: "-o"
     def init

data/lib/git_fit/db/connection.rb

@@ -20,7 +20,11 @@ module GitFit
 
       def run_migrations
         Sequel.extension :migration
-        Sequel::Migrator.run(@db, File.expand_path("../../../db/migrations", __dir__))
+        path = File.expand_path("../../../db/migrations", __dir__)
+        Sequel::Migrator.run(@db, path)
+      rescue Sequel::Migrator::Error
+        GitFit::DB::Rebuild.call(@db, @db.opts[:database], path)
+        Sequel::Migrator.run(@db, path)
       end
     end
   end

data/lib/git_fit/db/rebuild.rb

@@ -0,0 +1,48 @@
+require "fileutils"
+
+module GitFit
+  module DB
+    class RebuildError < StandardError; end
+
+    module Rebuild
+      def self.call(db, db_path, migrations_path)
+        backup = "#{db_path}.rebuild_bak"
+        FileUtils.cp(db_path, backup)
+
+        tables = db.tables - [:schema_migrations]
+        data = {}
+        tables.each { |t| data[t] = export_table(db, t) }
+
+        db.run("PRAGMA foreign_keys = OFF")
+        tables.each { |t| db.drop_table(t) }
+
+        Sequel.extension :migration
+        Sequel::Migrator.run(db, migrations_path)
+
+        new_tables = db.tables.to_set
+        data.each do |table, rows|
+          next unless new_tables.include?(table)
+          import_table(db, table, rows) if rows.any?
+        end
+
+        warn "Rebuilt #{db_path}: #{data.values.sum(&:size)} rows from #{data.size} tables"
+      rescue => e
+        if backup && File.exist?(backup)
+          FileUtils.cp(backup, db_path)
+        end
+        raise RebuildError, "Rebuild failed: #{e.message}"
+      end
+
+      def self.export_table(db, table)
+        db[table].all.map { |r| r.except(:id) }
+      end
+
+      def self.import_table(db, table, rows)
+        return if rows.empty?
+        target = db[table].columns - [:id]
+        filtered = rows.map { |r| r.select { |k, _| target.include?(k) } }
+        db[table].multi_insert(filtered)
+      end
+    end
+  end
+end

data/lib/git_fit/import/apple_health.rb

@@ -0,0 +1,582 @@
+require "digest"
+require "fileutils"
+require "json"
+require "nokogiri"
+require "time"
+require "tzinfo"
+require "zip"
+
+module GitFit
+  module Import
+    class AppleHealth < Source::Base
+      SKIPPED_SOURCE_PATTERNS = [
+        /\bStrava\b/i, /\bKeep\b/i, /\biGPSPORT\b/i,
+        /\bXOSS\b/i, /\bXingZhe\b/i, /\bConnect\b/i
+      ].freeze
+
+      APPLE_WATCH_PATTERN = /Apple Watch/
+
+      DEFAULT_ZIP_PATH = "data/import/apple_health/export.zip"
+
+      HeartRateRecord = Struct.new(:time, :value, keyword_init: true)
+
+      MIN_GPX_SPEED = 0.1
+
+      def initialize(config:, db:, activity_filter: nil, privacy: nil, time_budget: nil)
+        super
+        @zip_path = @config["zip_path"] || DEFAULT_ZIP_PATH
+        @heart_rate_index = nil
+        @heart_rate_by_date = nil
+        @skip_patterns = load_skip_sources
+        @timezone_resolver = GitFit::Timezone::Resolver.new(config)
+      end
+
+      def before_call
+        return false unless File.exist?(@zip_path)
+        super
+      end
+
+      def authenticate
+        true
+      end
+
+      def call
+        return 0 unless before_call
+        return 0 unless authenticate
+        ids = pending_ids
+        return 0 if ids.nil? || ids.empty?
+
+        total = ids.size
+        processed = 0
+        ids.each do |p|
+          break if time_expired? && processed.positive?
+          r = process_one(p)
+          processed += 1 if r
+          report_progress(processed, total, build_progress_info(r)) if r
+        end
+
+        processed
+      end
+
+      def pending_ids
+        existing = existing_run_ids_set
+        results = []
+        hr_records = []
+        @route_index = []
+        zip = Zip::File.new(@zip_path)
+        xml_entry = zip.find_entry("apple_health_export/export.xml")
+        return results unless xml_entry
+
+        io = xml_entry.get_input_stream
+        buffer = ""
+        in_workout = false
+        route_buf = nil
+
+        io.each_line do |line|
+          if line.include?("HKQuantityTypeIdentifierHeartRate") && APPLE_WATCH_PATTERN.match?(line)
+            hr = parse_hr_line(line)
+            hr_records << hr if hr
+          end
+
+          if line.include?("<WorkoutRoute ")
+            route_buf = line
+          elsif route_buf
+            route_buf << line
+            if line.include?("</WorkoutRoute>")
+              process_route_entry(route_buf)
+              route_buf = nil
+            end
+          end
+
+          if !in_workout
+            if line.include?("<Workout ")
+              in_workout = true
+              buffer = line
+            end
+          else
+            buffer << line
+            if line.include?("</Workout>")
+              process_workout_chunk(buffer, existing, results)
+              buffer = ""
+              in_workout = false
+            end
+          end
+        end
+
+        @heart_rate_index = hr_records.sort_by(&:time)
+
+        @heart_rate_by_date = {}
+        @heart_rate_index.each do |hr|
+          date_key = hr.time.strftime("%Y-%m-%d")
+          @heart_rate_by_date[date_key] ||= []
+          @heart_rate_by_date[date_key] << hr
+        end
+
+        results
+      ensure
+        zip&.close
+        io&.close rescue nil
+      end
+
+      def process_one(pending)
+        raw_xml = pending[:raw_xml]
+        run_id = pending[:run_id]
+        source_name = pending[:source_name]
+        stats = pending[:stats]
+        meta = pending[:meta]
+        route_paths = pending[:route_paths]
+        start_date = pending[:start_date]
+        end_date = pending[:end_date]
+        duration = pending[:duration]
+        duration_unit = pending[:duration_unit]
+        workout_type = pending[:workout_type]
+
+        FileUtils.mkdir_p(raw_dir)
+        tmp = File.join(raw_dir, ".#{run_id}.xml.tmp")
+        final = File.join(raw_dir, "#{run_id}.xml")
+        File.write(tmp, raw_xml)
+        File.rename(tmp, final)
+
+        hr_avg = nil
+        hr_max = nil
+        if @heart_rate_index&.any?
+          hr_avg, hr_max = correlate_heart_rate(start_date, end_date)
+        end
+
+        l2_points = nil
+        polyline = nil
+        elevation_gain = nil
+
+        if route_paths&.any?
+          gpx_l1_path = File.join(raw_dir, "#{run_id}.gpx")
+          unless File.exist?(gpx_l1_path)
+            begin
+              zip = Zip::File.new(@zip_path)
+              route_paths.each do |gpx_path|
+                normalized = gpx_path.sub(%r{^/?}, "apple_health_export/")
+                entry = zip.find_entry(normalized)
+                next unless entry
+                data = entry.get_input_stream.read
+                tmpp = File.join(raw_dir, ".#{run_id}.gpx.tmp")
+                File.write(tmpp, data)
+                File.rename(tmpp, gpx_l1_path)
+                break
+              end
+            rescue => e
+              $stderr.puts "AppleHealth: GPX extract error for #{run_id}: #{e.message}"
+            ensure
+              zip&.close
+            end
+          end
+
+          l2_points = File.exist?(gpx_l1_path) ? parse_gpx_file(gpx_l1_path) : nil
+
+          if l2_points&.any?
+            FileUtils.mkdir_p(std_dir)
+            std_data = l2_points.map { |pt|
+              h = { latitude: pt[:lat], longitude: pt[:lng] }
+              h[:altitude] = pt[:ele] if pt[:ele]
+              h[:timestamp] = pt[:time] if pt[:time]
+              h[:speed] = pt[:speed] if pt[:speed]
+              h
+            }
+            tmp2 = File.join(std_dir, ".#{run_id}.json.tmp")
+            final2 = File.join(std_dir, "#{run_id}.json")
+            File.write(tmp2, JSON.generate(std_data))
+            File.rename(tmp2, final2)
+
+            coords = l2_points.map { |pt| [pt[:lat], pt[:lng]] }
+            polyline = GitFit::Geo::Polyline.encode(coords)
+            elevation_gain = elevation_gain_from_points(l2_points)
+          end
+        end
+
+        title = build_title(workout_type, start_date)
+        attrs = build_attrs(source_name, run_id, stats, meta, polyline, elevation_gain,
+                            workout_type, start_date, end_date, duration, duration_unit,
+                            hr_avg, hr_max)
+        attrs[:title] = title
+
+        if attrs[:start_date_local].nil? && l2_points&.any?
+          first_pt = l2_points.first
+          tz = @timezone_resolver.resolve(first_pt[:lat], first_pt[:lng])
+          if tz && attrs[:start_date]
+            attrs[:start_date_local] = apple_utc_to_local(attrs[:start_date], tz)
+          end
+        end
+
+        upsert_activity(attrs)
+        attrs
+      end
+
+      def source_label
+        "AppleHealth"
+      end
+
+      def raw_dir
+        File.join("data", "raw", "apple_health")
+      end
+
+      def std_dir
+        File.join("data", "std", "apple_health")
+      end
+
+      def raw_path(platform_id)
+        File.join(raw_dir, "#{platform_id}.xml")
+      end
+
+      private
+
+      def known_source?(source_name)
+        return false unless source_name
+        @skip_patterns.any? { |pattern| pattern.match?(source_name) }
+      end
+
+      def load_skip_sources
+        configured = @config["skip_sources"]
+        return [] unless configured
+
+        list = configured.is_a?(String) ? configured.split(",").map(&:strip) : configured
+        validated = list.select do |name|
+          SKIPPED_SOURCE_PATTERNS.any? { |p| p.match?(name) }
+        end
+
+        SKIPPED_SOURCE_PATTERNS.select { |p|
+          validated.any? { |v| p.match?(v) }
+        }
+      end
+
+      def existing_run_ids_set
+        @db[:activities].where(source: "apple_health").select_map(:run_id).map(&:to_s).to_set
+      end
+
+      def parse_hr_line(line)
+        m = line.match(/startDate="([^"]+)".*?value="(\d+)"/)
+        return nil unless m
+        time = Time.parse(m[1]) rescue nil
+        return nil unless time
+        HeartRateRecord.new(time: time, value: m[2].to_i)
+      end
+
+      def correlate_heart_rate(start_date_str, end_date_str)
+        start_t = Time.parse(start_date_str) rescue nil
+        end_t = Time.parse(end_date_str) rescue nil
+        return [nil, nil] unless start_t && end_t
+
+        padding = 30
+        records = collect_hr_in_window(start_t - padding, end_t + padding)
+        return [nil, nil] if records.empty?
+
+        vals = records.map(&:value)
+        avg = (vals.sum.to_f / vals.size).round(1)
+        max = vals.max
+        [avg, max]
+      end
+
+      def collect_hr_in_window(start_t, end_t)
+        if @heart_rate_by_date
+          results = []
+          (start_t.to_date..end_t.to_date).each do |date|
+            date_key = date.strftime("%Y-%m-%d")
+            bucket = @heart_rate_by_date[date_key]
+            if bucket&.any?
+              lo = bucket.bsearch_index { |hr| hr.time >= start_t }
+              hi = bucket.bsearch_index { |hr| hr.time > end_t }
+              if lo
+                slice = hi ? bucket[lo...hi] : bucket[lo..]
+                results.concat(slice) if slice&.any?
+              end
+            end
+          end
+          results
+        else
+          return [] unless @heart_rate_index&.any?
+          lo = @heart_rate_index.bsearch_index { |hr| hr.time >= start_t }
+          hi = @heart_rate_index.bsearch_index { |hr| hr.time > end_t }
+          return [] unless lo
+          slice = hi ? @heart_rate_index[lo...hi] : @heart_rate_index[lo..]
+          slice || []
+        end
+      end
+
+      def process_workout_chunk(raw_xml, existing_ids, results)
+        doc = Nokogiri::XML("<root>#{raw_xml}</root>")
+        workout = doc.at_xpath("//Workout")
+        return unless workout
+
+        source_name = workout["sourceName"]
+        return if known_source?(source_name)
+
+        workout_type = workout["workoutActivityType"]
+        return unless workout_type
+
+        start_date = workout["startDate"]
+        end_date = workout["endDate"]
+        return if start_date.nil? || end_date.nil?
+
+        duration = workout["duration"]
+        duration_unit = workout["durationUnit"] || "min"
+        return if duration.nil?
+
+        creation_date = workout["creationDate"] || start_date
+        run_id = generate_run_id(source_name, creation_date, start_date, end_date)
+        return if existing_ids.include?("apple_health_#{run_id}")
+
+        category = map_sport_type(workout_type)
+        return if skip_type?(category)
+
+        stats = extract_statistics(workout)
+        meta = extract_metadata(workout)
+        route_paths = extract_route_paths(workout)
+        route_paths = match_routes_by_time(start_date, end_date) if route_paths.empty?
+        source_version = workout["sourceVersion"]
+
+        results << {
+          id: run_id,
+          type: category,
+          raw_xml: raw_xml,
+          run_id: run_id,
+          source_name: source_name,
+          source_version: source_version,
+          workout_type: workout_type,
+          duration: duration,
+          duration_unit: duration_unit,
+          start_date: start_date,
+          end_date: end_date,
+          stats: stats,
+          meta: meta,
+          route_paths: route_paths,
+          creation_date: creation_date
+        }
+      end
+
+      def process_route_entry(xml)
+        doc = Nokogiri::XML("<root>#{xml}</root>")
+        route = doc.at_xpath("//WorkoutRoute")
+        return unless route
+
+        start_date = route["startDate"]
+        end_date = route["endDate"]
+        return unless start_date && end_date
+
+        paths = route.xpath("FileReference").filter_map { |ref| ref["path"] }
+        return if paths.empty?
+
+        @route_index << {
+          route_start: (Time.parse(start_date) rescue nil),
+          route_end: (Time.parse(end_date) rescue nil),
+          route_paths: paths
+        }
+      end
+
+      def match_routes_by_time(workout_start, workout_end)
+        return [] unless @route_index&.any? && workout_start && workout_end
+        ws = Time.parse(workout_start) rescue nil
+        we = Time.parse(workout_end) rescue nil
+        return [] unless ws && we
+
+        window_start = ws - 300
+        window_end = we + 300
+
+        @route_index.select { |r|
+          r[:route_start] && r[:route_end] &&
+            r[:route_start] < window_end && r[:route_end] > window_start
+        }.flat_map { |r| r[:route_paths] }.uniq
+      end
+
+      def extract_statistics(workout)
+        stats = {}
+        workout.xpath("WorkoutStatistics").each do |stat|
+          type = stat["type"]
+          sum = stat["sum"]
+          unit = stat["unit"]
+          next unless type && sum
+          stats[type] = { "sum" => sum, "unit" => unit }
+        end
+        stats
+      end
+
+      def extract_metadata(workout)
+        meta = {}
+        workout.xpath("MetadataEntry").each do |entry|
+          key = entry["key"]
+          value = entry["value"]
+          meta[key] = value if key && value
+        end
+        meta
+      end
+
+      def extract_route_paths(workout)
+        workout.xpath("WorkoutRoute/FileReference").filter_map do |ref|
+          ref["path"]
+        end
+      end
+
+      def parse_gpx_file(file_path)
+        doc = Nokogiri::XML(File.read(file_path))
+        doc.remove_namespaces!
+        doc.xpath("//trkpt").filter_map do |pt|
+          lat = pt["lat"]&.to_f
+          lng = pt["lon"]&.to_f
+          next unless lat && lng
+          ele = pt.at_xpath("ele")&.text&.to_f
+          time_str = pt.at_xpath("time")&.text
+          ext = pt.at_xpath("extensions")
+          speed = ext&.at_xpath("speed")&.text&.to_f
+          speed = nil if speed && speed < MIN_GPX_SPEED
+          { lat: lat, lng: lng, ele: ele, time: time_str, speed: speed }
+        end
+      rescue => e
+        $stderr.puts "AppleHealth: GPX parse error for #{file_path}: #{e.message}"
+        nil
+      end
+
+      def build_attrs(_source_name, run_id, stats, meta, polyline, elevation_gain,
+                      workout_type, start_date, end_date, duration, duration_unit,
+                      hr_avg = nil, hr_max = nil)
+        distance = nil
+        calories = nil
+
+        cals_sum = 0.0
+        stats.each do |type_str, data|
+          if type_str.include?("Distance")
+            distance = parse_distance(data["sum"], data["unit"])
+          elsif type_str.include?("ActiveEnergyBurned") || type_str.include?("BasalEnergyBurned")
+            cals_sum += data["sum"].to_f
+          end
+        end
+        calories = cals_sum > 0 ? cals_sum.round : nil
+
+        moving_time = parse_duration(duration, duration_unit)
+        elapsed_time = compute_elapsed(start_date, end_date) || moving_time
+        avg_speed = if distance && moving_time&.positive?
+                      (distance.to_f / moving_time).round(2)
+                    end
+
+        {
+          run_id: "apple_health_#{run_id}",
+          name: display_name(workout_type, start_date),
+          distance: distance,
+          moving_time: moving_time,
+          elapsed_time: elapsed_time,
+          sport_category: map_sport_type(workout_type),
+          sport_type: workout_type,
+          start_date: format_datetime(start_date),
+          start_date_local: meta["HKTimeZone"] ? format_datetime(start_date, utc: false) : nil,
+          summary_polyline: polyline,
+          average_heartrate: hr_avg,
+          max_heartrate: hr_max,
+          average_speed: avg_speed,
+          calories: calories,
+          elevation_gain: elevation_gain&.round(1),
+          average_temperature: parse_temperature(meta["HKWeatherTemperature"]),
+          source: "apple_health",
+          external_id: meta["HKExternalUUID"]
+        }
+      end
+
+      def format_datetime(str, utc: true)
+        return nil unless str
+        t = Time.parse(str) rescue nil
+        return str unless t
+        utc ? t.utc.iso8601 : t.iso8601
+      end
+
+      def compute_elapsed(start_str, end_str)
+        return nil unless start_str && end_str
+        s = Time.parse(start_str).utc rescue nil
+        e = Time.parse(end_str).utc rescue nil
+        return nil unless s && e
+        (e - s).round
+      end
+
+      def parse_duration(value, unit)
+        v = value.to_f
+        case unit.to_s.downcase
+        when "min" then (v * 60).round
+        when "sec" then v.round
+        when "hour" then (v * 3600).round
+        else (v * 60).round
+        end
+      end
+
+      def parse_distance(value, unit)
+        v = value.to_f
+        case unit.to_s.downcase
+        when "km" then (v * 1000).round(2)
+        when "mi" then (v * 1609.344).round(2)
+        when "m" then v.round(2)
+        when "ft" then (v * 0.3048).round(2)
+        else v.round(2)
+        end
+      end
+
+      def parse_temperature(value)
+        return nil unless value && !value.empty?
+        m = value.match(/([\d.]+)\s*(deg[FC]|°[FC]|℃)/i)
+        return nil unless m
+        num = m[1].to_f
+        unit = m[2].downcase
+        if unit.start_with?("degf") || unit.start_with?("°f")
+          ((num - 32) * 5.0 / 9.0).round(1)
+        else
+          num.round(1)
+        end
+      end
+
+      def generate_run_id(source_name, creation_date, start_date, end_date)
+        s = normalize_date(start_date)
+        e = normalize_date(end_date)
+        c = normalize_date(creation_date)
+        base = Digest::MD5.hexdigest("#{source_name}|#{s}|#{e}")[0, 7]
+        disc = Digest::MD5.hexdigest("#{source_name}|#{c}|#{s}|#{e}")[0, 4]
+        "#{base}#{disc}"
+      end
+
+      def normalize_date(date_str)
+        t = Time.parse(date_str) rescue nil
+        return date_str unless t
+        t.utc.strftime("%Y-%m-%dT%H:%M:%SZ")
+      end
+
+      def map_sport_type(workout_type)
+        return "other" unless workout_type
+        key = workout_type.sub(/\AHKWorkoutActivityType/, "")
+        return "workout" if key.downcase.include?("strength")
+        GitFit::SportMapper.canonicalize(key)
+      end
+
+      def display_name(workout_type, _start_date)
+        workout_type.sub(/\AHKWorkoutActivityType/, "")
+      end
+
+      def build_title(workout_type, start_date)
+        label = workout_type.sub(/\AHKWorkoutActivityType/, "")
+        date = start_date ? start_date[0..9] : nil
+        date ? "#{date} · #{label}" : label
+      end
+
+      def elevation_gain_from_points(points)
+        total = 0.0
+        (1...points.length).each do |i|
+          elev1 = points[i - 1][:ele] || 0.0
+          elev2 = points[i][:ele] || 0.0
+          gain = elev2 - elev1
+          total += gain if gain > 0
+        end
+        total
+      end
+
+      def apple_utc_to_local(utc_iso8601, tz_name)
+        return utc_iso8601 unless utc_iso8601 && tz_name
+        t = Time.parse(utc_iso8601)
+        return utc_iso8601 unless t.utc?
+        tz = TZInfo::Timezone.get(tz_name)
+        local = tz.utc_to_local(t)
+        local.iso8601
+      rescue TZInfo::InvalidTimezoneIdentifier, ArgumentError
+        utc_iso8601
+      end
+    end
+  end
+end

data/lib/git_fit/import/local_file.rb

@@ -0,0 +1,250 @@
+require "digest"
+require "fileutils"
+require "json"
+require "nokogiri"
+require "tzinfo"
+
+module GitFit
+  module Import
+    class LocalFile < Source::Base
+      IMPORT_DIRS = {
+        "gpx" => "data/import/gpx",
+        "tcx" => "data/import/tcx",
+        "fit" => "data/import/fit"
+      }.freeze
+
+      SUPPORTED_EXTENSIONS = %w[.gpx .tcx .fit].freeze
+
+      NS_TCX = { tcx: "http://www.garmin.com/xmlschemas/TrainingCenterDatabase/v2" }.freeze
+
+      def initialize(config:, db:, activity_filter: nil, privacy: nil, time_budget: nil, sources: nil, sport_override: nil)
+        super(config:, db:, activity_filter:, privacy:, time_budget:)
+        @sources = sources
+        @sport_override = sport_override
+        @timezone_resolver = GitFit::Timezone::Resolver.new(config)
+      end
+
+      def call
+        return 0 unless authenticate
+
+        total_imported = 0
+        @sources.each do |source|
+          dir = IMPORT_DIRS[source]
+          next unless dir && File.directory?(dir)
+
+          files = Dir.glob(File.join(dir, "*"), File::FNM_CASEFOLD)
+                     .select { |f| SUPPORTED_EXTENSIONS.include?(File.extname(f).downcase) && File.file?(f) }
+
+          total_imported += process_files(files, source)
+        end
+
+        total_imported
+      end
+
+      def authenticate
+        true
+      end
+
+      def pending_ids
+        []
+      end
+
+      def source_label
+        "LocalFile"
+      end
+
+      def raw_dir_for(source)
+        File.join("data", "raw", source)
+      end
+
+      def std_dir_for(source)
+        File.join("data", "std", source)
+      end
+
+      private
+
+      def process_files(files, source)
+        total_activities = 0
+        total = files.size
+
+        files.each_with_index do |file_path, idx|
+          break if time_expired? && total_activities.positive?
+
+          result = process_single_file(file_path, source)
+          if result
+            activity_count = result[:activity_count] || 1
+            total_activities += activity_count
+            report_progress(idx + 1, total, "#{activity_count} act from #{File.basename(file_path)}")
+          end
+        end
+
+        total_activities
+      end
+
+      def process_single_file(file_path, source)
+        content = File.binread(file_path)
+        sha = Digest::SHA256.hexdigest(content)
+        platform_id = "#{source}_#{sha[0, 12]}"
+
+        return nil if existing_run_id?(platform_id)
+
+        ext = File.extname(file_path).downcase
+        raw_source_dir = raw_dir_for(source)
+
+        raw_path = File.join(raw_source_dir, "#{platform_id}#{ext}")
+        FileUtils.mkdir_p(raw_source_dir)
+        tmp = "#{raw_path}.tmp"
+        File.binwrite(tmp, content)
+        File.rename(tmp, raw_path)
+
+        activities = parse_file(ext, content, file_path)
+        return nil if activities.empty?
+
+        l2_points = extract_l2_points(ext, content, file_path)
+
+        imported = 0
+        activities.each do |activity|
+          activity[:source] = source
+          activity[:run_id] = imported.zero? ? platform_id : "#{platform_id}_#{imported}"
+
+          if source == "gpx" && @sport_override
+            activity[:sport_category] = SportMapper.canonicalize(@sport_override)
+          end
+
+          if l2_points&.any?
+            std_source_dir = std_dir_for(source)
+            FileUtils.mkdir_p(std_source_dir)
+            std_data = l2_points.map { |pt|
+              h = { latitude: pt[0], longitude: pt[1] }
+              h[:altitude] = pt[2] if pt[2]
+              h[:timestamp] = pt[3]&.iso8601 if pt[3]
+              h[:heart_rate] = pt[4] if pt[4]
+              h
+            }
+            std_tmp = File.join(std_source_dir, ".#{activity[:run_id]}.json.tmp")
+            std_final = File.join(std_source_dir, "#{activity[:run_id]}.json")
+            File.write(std_tmp, JSON.generate(std_data))
+            File.rename(std_tmp, std_final)
+
+            coords = l2_points.map { |p| [p[0], p[1]] }
+            activity[:summary_polyline] = GitFit::Geo::Polyline.encode(coords)
+
+            first_pt = l2_points.first
+            tz = @timezone_resolver.resolve(first_pt[0], first_pt[1])
+            if tz && activity[:start_date]
+              activity[:start_date_local] = utc_to_local(activity[:start_date], tz)
+            end
+          end
+
+          upsert_activity(activity)
+          imported += 1
+        end
+
+        { activity_count: imported }
+      rescue => e
+        $stderr.puts "LocalFile: error importing #{file_path}: #{e.message}"
+        nil
+      end
+
+      def parse_file(ext, content, file_path)
+        case ext
+        when ".gpx"
+          GitFit::Parser::GPX.new.call(content)
+        when ".tcx"
+          GitFit::Parser::TCX.new.call(content)
+        when ".fit"
+          GitFit::Parser::FIT.new.call(file_path)
+        else
+          []
+        end
+      end
+
+      def extract_l2_points(ext, content, file_path)
+        case ext
+        when ".gpx"
+          extract_gpx_points(content)
+        when ".tcx"
+          extract_tcx_points(content)
+        when ".fit"
+          extract_fit_points(file_path)
+        else
+          nil
+        end
+      end
+
+      def extract_gpx_points(xml)
+        doc = Nokogiri::XML(xml)
+        doc.remove_namespaces!
+        doc.xpath("//trkpt").filter_map do |pt|
+          lat = pt["lat"]&.to_f
+          lon = pt["lon"]&.to_f
+          next unless lat && lon
+          ele = pt.at_xpath("ele")&.text&.to_f
+          time_str = pt.at_xpath("time")&.text
+          time = parse_timestamp(time_str)
+          hr = pt.at_xpath("extensions//hr")&.text&.to_f
+          [lat, lon, ele, time, hr]
+        end
+      rescue => e
+        $stderr.puts "LocalFile: GPX parse error: #{e.message}"
+        nil
+      end
+
+      def extract_tcx_points(xml)
+        doc = Nokogiri::XML(xml)
+        doc.xpath("//tcx:Trackpoint", NS_TCX).filter_map do |tp|
+          pos = tp.at_xpath("tcx:Position", NS_TCX)
+          next unless pos
+          lat = pos.at_xpath("tcx:LatitudeDegrees", NS_TCX)&.text&.to_f
+          lon = pos.at_xpath("tcx:LongitudeDegrees", NS_TCX)&.text&.to_f
+          next unless lat && lon
+          ele = tp.at_xpath("tcx:AltitudeMeters", NS_TCX)&.text&.to_f
+          time_str = tp.at_xpath("tcx:Time", NS_TCX)&.text
+          time = parse_timestamp(time_str)
+          hr = tp.at_xpath("tcx:HeartRateBpm/tcx:Value", NS_TCX)&.text&.to_f
+          [lat, lon, ele, time, hr]
+        end
+      rescue => e
+        $stderr.puts "LocalFile: TCX parse error: #{e.message}"
+        nil
+      end
+
+      def extract_fit_points(file_path)
+        records = GitFit::FIT::Decoder.decode(file_path)
+        records.filter_map do |r|
+          lat = r["positionLat"]
+          lon = r["positionLong"]
+          next unless lat && lon
+          ts = r["timestamp"]
+          time = ts.is_a?(Numeric) ? (Time.utc(1989, 12, 31) + ts) : (Time.parse(ts.to_s) rescue nil)
+          [lat, lon, r["altitude"], time, r["heartRate"]]
+        end
+      rescue => e
+        $stderr.puts "LocalFile: FIT decode error: #{e.message}"
+        nil
+      end
+
+      def parse_timestamp(str)
+        return nil unless str
+        Time.parse(str)
+      rescue ArgumentError
+        nil
+      end
+
+      def existing_run_id?(platform_id)
+        !@db[:activities].where(run_id: platform_id).empty?
+      end
+
+      def utc_to_local(utc_iso8601, tz_name)
+        return utc_iso8601 unless utc_iso8601 && tz_name
+        t = Time.parse(utc_iso8601)
+        return utc_iso8601 unless t.utc?
+        tz = TZInfo::Timezone.get(tz_name)
+        local = tz.utc_to_local(t)
+        local.iso8601
+      rescue TZInfo::InvalidTimezoneIdentifier, ArgumentError
+        utc_iso8601
+      end
+    end
+  end
+end

data/lib/git_fit/import.rb

@@ -0,0 +1,2 @@
+require_relative "import/local_file"
+require_relative "import/apple_health"

data/lib/git_fit/install/actions.rb

@@ -0,0 +1,90 @@
+module GitFit
+  module Install
+    module Actions
+      RESTORE_ACTION = <<~RESTORE_ACTION_YAML
+        name: DB Cache Restore
+        description: Restore SQLite DB with checksum verification
+        inputs:
+          path:
+            required: false
+            default: db/fit.sqlite3
+          key-prefix:
+            required: false
+            default: git-fit-db
+        runs:
+          using: composite
+          steps:
+            - uses: actions/cache/restore@v4
+              id: restore-db
+              with:
+                path: |-
+                  ${{ inputs.path }}
+                  ${{ inputs.path }}.checksum
+                key: ${{ inputs.key-prefix }}-v1-${{ github.run_id }}
+                restore-keys: ${{ inputs.key-prefix }}-v1-
+
+            - name: Verify checksum
+              shell: bash
+              run: |
+                db="${{ inputs.path }}"
+                ck="${db}.checksum"
+                if [ ! -f "$ck" ]; then
+                  echo "No checksum file — first run or cache miss, skipping verify"
+                  exit 0
+                fi
+                if ! sha256sum --check "$ck" --quiet 2>/dev/null; then
+                  echo "::warning::Checksum mismatch — $db may be corrupted"
+                  echo "Removing stale files"
+                  rm -f "$db" "$ck"
+                else
+                  echo "Checksum OK — $db is intact"
+                fi
+      RESTORE_ACTION_YAML
+
+      SAVE_ACTION = <<~SAVE_ACTION_YAML
+        name: DB Cache Save
+        description: Save SQLite DB with checksum, skip if unchanged
+        inputs:
+          path:
+            required: false
+            default: db/fit.sqlite3
+          key-prefix:
+            required: false
+            default: git-fit-db
+        outputs:
+          saved:
+            description: "true if cache was updated, false if unchanged"
+            value: ${{ steps.detect.outputs.saved }}
+        runs:
+          using: composite
+          steps:
+            - name: Detect changes
+              id: detect
+              shell: bash
+              run: |
+                db="${{ inputs.path }}"
+                ck="${db}.checksum"
+                new_sum=$(sha256sum "$db" 2>/dev/null || echo "")
+                if [ -z "$new_sum" ]; then
+                  echo "saved=false" >> "$GITHUB_OUTPUT"
+                  exit 0
+                fi
+                if [ -f "$ck" ] && sha256sum --check "$ck" --quiet 2>/dev/null; then
+                  echo "DB unchanged — skip save"
+                  echo "saved=false" >> "$GITHUB_OUTPUT"
+                  exit 0
+                fi
+                echo "$new_sum" > "$ck"
+                echo "saved=true" >> "$GITHUB_OUTPUT"
+
+            - uses: actions/cache/save@v4
+              if: steps.detect.outputs.saved == 'true'
+              with:
+                path: |-
+                  ${{ inputs.path }}
+                  ${{ inputs.path }}.checksum
+                key: ${{ inputs.key-prefix }}-v1-${{ github.run_id }}
+      SAVE_ACTION_YAML
+    end
+  end
+end

data/lib/git_fit/version.rb

@@ -1,3 +1,3 @@
 module GitFit
-  VERSION = "0.4.1"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git-fit
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Lax
@@ -93,6 +93,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: A git extension CLI for aggregating, managing, and exporting fitness
   activity data from multiple sources (Garmin, Strava, Keep, etc.)
 email:
@@ -106,11 +134,14 @@ files:
 - lib/git-fit.rb
 - lib/git_fit/cli.rb
 - lib/git_fit/cli/export.rb
+- lib/git_fit/cli/import_cli.rb
+- lib/git_fit/cli/install_cli.rb
 - lib/git_fit/config.rb
 - lib/git_fit/config_template.rb
 - lib/git_fit/db/activity.rb
 - lib/git_fit/db/cli.rb
 - lib/git_fit/db/connection.rb
+- lib/git_fit/db/rebuild.rb
 - lib/git_fit/export.rb
 - lib/git_fit/export/defaults.rb
 - lib/git_fit/export/json.rb
@@ -119,6 +150,10 @@ files:
 - lib/git_fit/geo.rb
 - lib/git_fit/geo/coord_transform.rb
 - lib/git_fit/geo/polyline.rb
+- lib/git_fit/import.rb
+- lib/git_fit/import/apple_health.rb
+- lib/git_fit/import/local_file.rb
+- lib/git_fit/install/actions.rb
 - lib/git_fit/parser.rb
 - lib/git_fit/parser/base.rb
 - lib/git_fit/parser/fit.rb