llm_cost_tracker 0.1.4 → 0.2.0.alpha2

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: llm_cost_tracker
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0.alpha2
 platform: ruby
 authors:
 - Sergii Khomenko
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-18 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
     - - "<"
       - !ruby/object:Gem::Version
         version: '9.0'
@@ -26,17 +26,31 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
     - - "<"
       - !ruby/object:Gem::Version
         version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
@@ -46,7 +60,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
@@ -56,7 +70,27 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
     - - "<"
       - !ruby/object:Gem::Version
         version: '9.0'
@@ -66,7 +100,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.1'
     - - "<"
       - !ruby/object:Gem::Version
         version: '9.0'
@@ -116,16 +150,22 @@ dependencies:
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '1.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '1.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -142,7 +182,7 @@ dependencies:
         version: '3.0'
 description: Tracks token usage and estimated costs for OpenAI, Anthropic, Google
   Gemini, OpenRouter, DeepSeek, and OpenAI-compatible calls. Works as Faraday middleware
-  for Ruby clients, with ActiveRecord storage, per-user/per-feature attribution, and
+  for Ruby clients, with ActiveRecord storage, arbitrary tag-based attribution, and
   budget guardrails.
 email:
 - sergey@mm.st
@@ -151,15 +191,47 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
-- ".rubocop.yml"
 - CHANGELOG.md
 - LICENSE.txt
+- PLAN_0.2.md
 - README.md
 - Rakefile
+- app/controllers/llm_cost_tracker/application_controller.rb
+- app/controllers/llm_cost_tracker/calls_controller.rb
+- app/controllers/llm_cost_tracker/dashboard_controller.rb
+- app/controllers/llm_cost_tracker/data_quality_controller.rb
+- app/controllers/llm_cost_tracker/models_controller.rb
+- app/controllers/llm_cost_tracker/tags_controller.rb
+- app/helpers/llm_cost_tracker/application_helper.rb
+- app/services/llm_cost_tracker/dashboard/data_quality.rb
+- app/services/llm_cost_tracker/dashboard/filter.rb
+- app/services/llm_cost_tracker/dashboard/overview_stats.rb
+- app/services/llm_cost_tracker/dashboard/provider_breakdown.rb
+- app/services/llm_cost_tracker/dashboard/tag_breakdown.rb
+- app/services/llm_cost_tracker/dashboard/tag_key_explorer.rb
+- app/services/llm_cost_tracker/dashboard/time_series.rb
+- app/services/llm_cost_tracker/dashboard/top_models.rb
+- app/services/llm_cost_tracker/pagination.rb
+- app/views/layouts/llm_cost_tracker/application.html.erb
+- app/views/llm_cost_tracker/calls/index.html.erb
+- app/views/llm_cost_tracker/calls/show.html.erb
+- app/views/llm_cost_tracker/dashboard/index.html.erb
+- app/views/llm_cost_tracker/data_quality/index.html.erb
+- app/views/llm_cost_tracker/errors/database.html.erb
+- app/views/llm_cost_tracker/errors/invalid_filter.html.erb
+- app/views/llm_cost_tracker/errors/not_found.html.erb
+- app/views/llm_cost_tracker/models/index.html.erb
+- app/views/llm_cost_tracker/shared/_bar.html.erb
+- app/views/llm_cost_tracker/shared/setup_required.html.erb
+- app/views/llm_cost_tracker/tags/index.html.erb
+- app/views/llm_cost_tracker/tags/show.html.erb
+- config/routes.rb
 - lib/llm_cost_tracker.rb
 - lib/llm_cost_tracker/budget.rb
 - lib/llm_cost_tracker/configuration.rb
 - lib/llm_cost_tracker/cost.rb
+- lib/llm_cost_tracker/engine.rb
+- lib/llm_cost_tracker/engine_compatibility.rb
 - lib/llm_cost_tracker/errors.rb
 - lib/llm_cost_tracker/event.rb
 - lib/llm_cost_tracker/event_metadata.rb
@@ -185,6 +257,7 @@ files:
 - lib/llm_cost_tracker/parsers/openai_compatible.rb
 - lib/llm_cost_tracker/parsers/openai_usage.rb
 - lib/llm_cost_tracker/parsers/registry.rb
+- lib/llm_cost_tracker/period_grouping.rb
 - lib/llm_cost_tracker/price_registry.rb
 - lib/llm_cost_tracker/prices.json
 - lib/llm_cost_tracker/pricing.rb
@@ -192,17 +265,13 @@ files:
 - lib/llm_cost_tracker/report.rb
 - lib/llm_cost_tracker/report_data.rb
 - lib/llm_cost_tracker/report_formatter.rb
-- lib/llm_cost_tracker/storage/active_record_backend.rb
 - lib/llm_cost_tracker/storage/active_record_store.rb
-- lib/llm_cost_tracker/storage/backends.rb
-- lib/llm_cost_tracker/storage/custom_backend.rb
-- lib/llm_cost_tracker/storage/log_backend.rb
 - lib/llm_cost_tracker/tag_accessors.rb
+- lib/llm_cost_tracker/tag_key.rb
 - lib/llm_cost_tracker/tag_query.rb
 - lib/llm_cost_tracker/tags_column.rb
 - lib/llm_cost_tracker/tracker.rb
 - lib/llm_cost_tracker/unknown_pricing.rb
-- lib/llm_cost_tracker/value_object.rb
 - lib/llm_cost_tracker/version.rb
 - lib/tasks/llm_cost_tracker.rake
 - llm_cost_tracker.gemspec
@@ -211,6 +280,8 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/sergey-homenko/llm_cost_tracker
+  source_code_uri: https://github.com/sergey-homenko/llm_cost_tracker
+  bug_tracker_uri: https://github.com/sergey-homenko/llm_cost_tracker/issues
   changelog_uri: https://github.com/sergey-homenko/llm_cost_tracker/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 post_install_message:
@@ -221,7 +292,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/.rubocop.yml

@@ -1,44 +0,0 @@
-AllCops:
-  NewCops: enable
-  TargetRubyVersion: 3.1
-  SuggestExtensions: false
-  UseCache: false
-  Exclude:
-    - "tmp/**/*"
-    - "vendor/**/*"
-    - "pkg/**/*"
-
-Style/Documentation:
-  Enabled: false
-
-Style/StringLiterals:
-  EnforcedStyle: double_quotes
-
-Metrics/BlockLength:
-  Exclude:
-    - "*.gemspec"
-    - "spec/**/*.rb"
-
-Metrics/MethodLength:
-  Max: 25
-
-Metrics/AbcSize:
-  Max: 45
-
-Metrics/ClassLength:
-  Max: 130
-
-Metrics/CyclomaticComplexity:
-  Max: 10
-
-Metrics/ParameterLists:
-  Max: 6
-
-Metrics/PerceivedComplexity:
-  Max: 10
-
-Gemspec/DevelopmentDependencies:
-  Enabled: false
-
-Layout/HashAlignment:
-  Enabled: false

data/lib/llm_cost_tracker/storage/active_record_backend.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module LlmCostTracker
-  module Storage
-    module ActiveRecordBackend
-      class << self
-        def save(event, **_options)
-          require_relative "../llm_api_call" unless defined?(LlmCostTracker::LlmApiCall)
-          require_relative "active_record_store" unless defined?(LlmCostTracker::Storage::ActiveRecordStore)
-
-          ActiveRecordStore.save(event)
-          event
-        rescue LoadError => e
-          raise Error, "ActiveRecord storage requires the active_record gem: #{e.message}"
-        end
-      end
-    end
-  end
-end

data/lib/llm_cost_tracker/storage/backends.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../errors"
-require_relative "log_backend"
-require_relative "active_record_backend"
-require_relative "custom_backend"
-
-module LlmCostTracker
-  module Storage
-    module Backends
-      MAP = {
-        log: LogBackend,
-        active_record: ActiveRecordBackend,
-        custom: CustomBackend
-      }.freeze
-
-      class << self
-        def fetch(name)
-          MAP.fetch(name.to_sym)
-        rescue KeyError
-          raise Error, "Unknown storage_backend: #{name.inspect}. Use one of: #{MAP.keys.join(', ')}"
-        end
-      end
-    end
-  end
-end

data/lib/llm_cost_tracker/storage/custom_backend.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-module LlmCostTracker
-  module Storage
-    module CustomBackend
-      class << self
-        def save(event, config:)
-          result = config.custom_storage&.call(event)
-          return false if result == false
-
-          event
-        end
-      end
-    end
-  end
-end

data/lib/llm_cost_tracker/storage/log_backend.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../logging"
-
-module LlmCostTracker
-  module Storage
-    module LogBackend
-      class << self
-        def save(event, config:)
-          message = "#{event.provider}/#{event.model} " \
-                    "tokens=#{event.input_tokens}+#{event.output_tokens} " \
-                    "cost=#{cost_label(event)}"
-          message += " latency=#{event.latency_ms}ms" if event.latency_ms
-          message += " tags=#{event.tags}" unless event.tags.empty?
-
-          Logging.log(config.log_level, message)
-          event
-        end
-
-        private
-
-        def cost_label(event)
-          event.cost ? "$#{format('%.6f', event.cost.total_cost)}" : "unknown"
-        end
-      end
-    end
-  end
-end

data/lib/llm_cost_tracker/value_object.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-module LlmCostTracker
-  module ValueObject
-    class << self
-      def define(*members, &block)
-        klass = data_class(*members)
-        add_hash_like_readers(klass)
-        klass.class_eval(&block) if block
-        klass
-      end
-
-      private
-
-      def data_class(*members)
-        return Data.define(*members) if defined?(Data)
-
-        Struct.new(*members, keyword_init: true) do
-          def initialize(**kwargs)
-            super
-            freeze
-          end
-        end
-      end
-
-      def add_hash_like_readers(klass)
-        klass.class_eval do
-          def [](key)
-            public_send(key.to_sym)
-          end
-
-          def dig(key, *rest)
-            value = self[key]
-            rest.empty? ? value : value&.dig(*rest)
-          end
-
-          def except(*keys)
-            excluded = keys.map(&:to_sym)
-            to_h.reject { |key, _value| excluded.include?(key.to_sym) }
-          end
-        end
-      end
-    end
-  end
-end