llm_cost_tracker 0.13.0 → 0.14.1

data/lib/llm_cost_tracker/railtie.rb

@@ -8,14 +8,10 @@ module LlmCostTracker
       app.config.eager_load_paths << models_path unless app.config.eager_load_paths.include?(models_path)
     end
 
+    GENERATOR_FILES = File.expand_path("generators/llm_cost_tracker/*_generator.rb", __dir__)
+
     generators do
-      require_relative "generators/llm_cost_tracker/install_generator"
-      require_relative "generators/llm_cost_tracker/prices_generator"
-      require_relative "generators/llm_cost_tracker/call_rollups_generator"
-      require_relative "generators/llm_cost_tracker/async_ingestion_generator"
-      require_relative "generators/llm_cost_tracker/upgrade_call_rollups_provider_generator"
-      require_relative "generators/llm_cost_tracker/upgrade_image_tokens_generator"
-      require_relative "generators/llm_cost_tracker/upgrade_call_tags_key_value_index_generator"
+      Dir[GENERATOR_FILES].each { |path| require path }
     end
   end
 end

data/lib/llm_cost_tracker/redaction.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module LlmCostTracker
+  module Redaction
+    REDACTED = "[REDACTED]"
+
+    TOKEN = Regexp.union(
+      /sk-(?:ant-|admin-|proj-|svcacct-|live-|test-)?[A-Za-z0-9_-]{16,}/,
+      /AKIA[0-9A-Z]{16}/,
+      /gh[opsur]_[A-Za-z0-9]{16,}/,
+      /github_pat_[A-Za-z0-9_]{20,}/,
+      /eyj[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/i,
+      /bearer\s+[A-Za-z0-9_.-]{20,}/i,
+      /xox[abprs]-[A-Za-z0-9-]{10,}/,
+      /(?:sk|rk|pk)_(?:live|test)_[A-Za-z0-9]{20,}/,
+      /AIza[0-9A-Za-z_-]{35}/
+    )
+    EMBEDDED_TOKEN = /(?<![A-Za-z0-9_-])(?:#{TOKEN})(?![A-Za-z0-9_-])/
+    PARAM = /(?<![A-Za-z0-9])((?:api)?key|token|secret|password|sig(?:nature)?)=[^&\s"']+/i
+    HEADER = /((?:authorization|api-key)["']?\s*(?:=>|:)\s*["']?)(?:[A-Za-z]+\s+)?[^\s"',;]+/i
+    USERINFO = %r{://[^/\s@?#]+@}
+    private_constant :TOKEN, :EMBEDDED_TOKEN, :PARAM, :HEADER, :USERINFO
+
+    def self.text(value)
+      value.to_s.scrub
+           .gsub(USERINFO, "://#{REDACTED}@")
+           .gsub(HEADER, "\\1#{REDACTED}")
+           .gsub(PARAM, "\\1=#{REDACTED}")
+           .gsub(EMBEDDED_TOKEN, REDACTED)
+    end
+  end
+end

data/lib/llm_cost_tracker/report/data.rb

@@ -34,7 +34,7 @@ module LlmCostTracker
         end
         from = now - days.days
         scope = LlmCostTracker::Call.where(tracked_at: from..now)
-        tag_breakdowns ||= LlmCostTracker.configuration.report_tag_breakdowns || []
+        tag_breakdowns ||= LlmCostTracker.configuration.tags.report_breakdown_keys || []
         aggregate = totals(scope)
 
         new(
@@ -55,7 +55,7 @@ module LlmCostTracker
       def self.totals(scope)
         scope
           .select(
-            "COALESCE(SUM(total_cost), 0) AS total_cost, " \
+            "COALESCE(SUM(#{LlmCostTracker::Call.qualified(:total_cost)}), 0) AS total_cost, " \
             "COUNT(*) AS requests_count, " \
             "AVG(latency_ms) AS average_latency_ms, " \
             "COALESCE(SUM(CASE WHEN #{Charges::CostStatus.unknown_pricing_sql} " \

data/lib/llm_cost_tracker/retention.rb

@@ -3,6 +3,8 @@
 module LlmCostTracker
   module Retention
     DEFAULT_BATCH_SIZE = 5_000
+    ROLLUP_COLUMNS = %i[tracked_at total_cost pricing_snapshot provider].freeze
+    private_constant :ROLLUP_COLUMNS
 
     class << self
       def prune(older_than:, batch_size: DEFAULT_BATCH_SIZE, now: Time.now.utc)
@@ -26,11 +28,23 @@ module LlmCostTracker
         require_relative "ingestion"
         return 0 unless LlmCostTracker::Ingestion::InboxEntry.table_exists?
 
-        LlmCostTracker::Ingestion::InboxEntry.where(tracked_at: ...cutoff).delete_all
+        scope = LlmCostTracker::Ingestion::InboxEntry.where(tracked_at: ...cutoff)
+        warn_undrained(scope.pending)
+        scope.delete_all
       end
 
       private
 
+      def warn_undrained(scope)
+        count, cost = scope.pick(Arel.sql("COUNT(*)"), Arel.sql("COALESCE(SUM(total_cost), 0)"))
+        return if count.to_i.zero?
+
+        Logging.warn(
+          "Retention.prune_inbox is deleting #{count} inbox row(s) worth #{cost} that were never drained " \
+          "into the ledger. Their spend is lost. Drain the inbox before pruning, or raise the retention window."
+        )
+      end
+
       def resolve_cutoff(older_than, now)
         cutoff = case older_than
                  when Time, DateTime then older_than.utc
@@ -58,22 +72,20 @@ module LlmCostTracker
 
       def prune_batch(cutoff, batch_size)
         LlmCostTracker::Call.transaction do
-          cache_rollups = LlmCostTracker.configuration.cache_rollups
-          rows = prunable_rows(cutoff, batch_size, with_rollup_columns: cache_rollups)
+          rows = prunable_rows(cutoff, batch_size)
           next 0 if rows.empty?
 
-          ids = cache_rollups ? rows.map(&:id) : rows
-          deleted = LlmCostTracker::Call.where(id: ids).delete_all
-          LlmCostTracker::Ledger::Rollups.decrement!(rows) if cache_rollups && deleted.positive?
+          deleted = LlmCostTracker::Call.where(id: rows.map(&:id)).delete_all
+          LlmCostTracker::Ledger::Rollups.decrement!(rows) if deleted.positive?
           deleted
         end
       end
 
-      def prunable_rows(cutoff, batch_size, with_rollup_columns:)
+      def prunable_rows(cutoff, batch_size)
         relation = LlmCostTracker::Call.where(tracked_at: ...cutoff).order(:id).limit(batch_size).lock
-        return relation.pluck(:id) unless with_rollup_columns
-
-        relation.select(:id, :tracked_at, :total_cost, :pricing_snapshot, :provider).to_a
+        columns = [:id]
+        columns += ROLLUP_COLUMNS if LlmCostTracker::Ledger::Rollups.cache_active?
+        relation.select(*columns).to_a
       end
     end
   end

data/lib/llm_cost_tracker/tags/context.rb

@@ -18,15 +18,15 @@ module LlmCostTracker
 
         def tags
           config = LlmCostTracker.configuration
-          base = config.static_sanitized_default_tags ||
-                 Sanitizer.call(call_default_tags(config.default_tags).to_h)
+          base = config.tags.static_sanitized_default ||
+                 Sanitizer.call(call_default_tags(config.tags.default).to_h)
           base.merge(*Array(ActiveSupport::IsolatedExecutionState[KEY]))
         end
 
         def call_default_tags(proc_or_lambda)
           proc_or_lambda.call
         rescue StandardError => e
-          Logging.warn("LlmCostTracker default_tags proc raised: #{e.class}: #{e.message}; using empty default tags")
+          Logging.warn("LlmCostTracker tags.default proc raised: #{e.class}: #{e.message}; using empty default tags")
           {}
         end
       end

data/lib/llm_cost_tracker/tags/sanitizer.rb

@@ -2,30 +2,20 @@
 
 require "active_support/core_ext/string/inflections"
 
+require_relative "../ledger/storable"
+require_relative "../redaction"
+
 module LlmCostTracker
   module Tags
     module Sanitizer
-      REDACTED_VALUE = "[REDACTED]"
-
-      SECRET_VALUE_PATTERNS = [
-        /\Ask-(?:ant-|admin-|proj-|svcacct-|live-|test-)?[A-Za-z0-9_-]{16,}\z/,
-        /\AAKIA[0-9A-Z]{16}\z/,
-        /\Agh[opsur]_[A-Za-z0-9]{16,}\z/,
-        /\Agithub_pat_[A-Za-z0-9_]{20,}\z/,
-        /\Aeyj[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\z/i,
-        /\Abearer\s+[A-Za-z0-9_.-]{20,}\z/i,
-        /\Axox[abprs]-[A-Za-z0-9-]{10,}\z/,
-        /\A(?:sk|rk|pk)_(?:live|test)_[A-Za-z0-9]{20,}\z/,
-        /\AAIza[0-9A-Za-z_-]{35}\z/
-      ].freeze
-      private_constant :SECRET_VALUE_PATTERNS
+      REDACTED_VALUE = Redaction::REDACTED
 
       class << self
         def call(tags, config: LlmCostTracker.configuration)
           tags = (tags || {}).to_h
-          redacted = config.normalized_redacted_tag_keys
-          limit = [config.max_tag_value_bytesize.to_i, 0].max
-          max_count = [config.max_tag_count.to_i, 0].max
+          redacted = config.tags.normalized_redacted_keys
+          limit = [config.tags.max_value_bytesize.to_i, 0].max
+          max_count = [config.tags.max_count.to_i, 0].max
           tags.to_a.last(max_count).each_with_object({}) do |(key, value), sanitized|
             next unless valid_key?(key)
 
@@ -43,7 +33,7 @@ module LlmCostTracker
 
         def cap(tags, config: LlmCostTracker.configuration)
           tags = (tags || {}).to_h
-          max_count = [config.max_tag_count.to_i, 0].max
+          max_count = [config.tags.max_count.to_i, 0].max
           return tags if tags.size <= max_count
 
           tags.to_a.last(max_count).to_h
@@ -58,15 +48,9 @@ module LlmCostTracker
         def sanitized_value(key, value, redacted, limit)
           return REDACTED_VALUE if redacted_key?(key, redacted)
 
-          scrubbed = scrub_secrets(value)
-          return REDACTED_VALUE if scrubbed.equal?(REDACTED_SENTINEL)
-
-          scalar_truncate(scrubbed, limit)
+          scalar_truncate(scrub_secrets(Ledger::Storable.clean(value)), limit)
         end
 
-        REDACTED_SENTINEL = Object.new.freeze
-        private_constant :REDACTED_SENTINEL
-
         def scalar_truncate(value, limit)
           case value
           when Hash
@@ -86,26 +70,16 @@ module LlmCostTracker
         def scrub_secrets(value)
           case value
           when Hash
-            value.each_with_object({}) do |(key, nested), out|
-              scrubbed = scrub_secrets(nested)
-              out[key] = scrubbed.equal?(REDACTED_SENTINEL) ? REDACTED_VALUE : scrubbed
-            end
+            value.transform_values { |nested| scrub_secrets(nested) }
           when Array
-            value.map do |nested|
-              scrubbed = scrub_secrets(nested)
-              scrubbed.equal?(REDACTED_SENTINEL) ? REDACTED_VALUE : scrubbed
-            end
+            value.map { |nested| scrub_secrets(nested) }
           else
-            secret_shaped?(value.to_s) ? REDACTED_SENTINEL : value
+            string = value.to_s
+            scrubbed = Redaction.text(string)
+            scrubbed == string ? value : scrubbed
           end
         end
 
-        def secret_shaped?(string)
-          return false if string.bytesize < 16
-
-          SECRET_VALUE_PATTERNS.any? { |pattern| pattern.match?(string) }
-        end
-
         def redacted_key?(key, redacted)
           return false if redacted.empty?
 

data/lib/llm_cost_tracker/tracker.rb

@@ -25,25 +25,12 @@ module LlmCostTracker
           usage_source: event.usage_source
         )
 
-        if enforce_budget
-          Budget.enforce!(provider: event.provider,
-                          model: event.model,
-                          estimate: calculation.cost&.total,
-                          force: true)
-        end
+        tags = build_tags(context_tags: context_tags, metadata: metadata)
 
-        if calculation.token_cost.nil? && event.token_usage.total_tokens.positive? &&
-           calculation.priced_line_items.none?(&:priced?)
-          Pricing::Unknown.process(event.model)
-        end
+        unpriced = calculation.token_cost.nil? && event.token_usage.total_tokens.positive? &&
+                   calculation.priced_line_items.none?(&:priced?)
 
-        event = build_event(
-          event: event,
-          calculation: calculation,
-          metadata: metadata,
-          latency_ms: latency_ms,
-          context_tags: context_tags
-        )
+        event = build_event(event: event, calculation: calculation, tags: tags, latency_ms: latency_ms)
 
         if Ingestion.async?
           Ingestion::Inbox.save(event)
@@ -54,11 +41,20 @@ module LlmCostTracker
 
         yield if block_given?
         notify_subscribers(event)
-        Budget.check!(event)
+        Pricing::Unknown.process(event.model, pricing_mode: calculation.mode) if unpriced
+        behavior_override = :raise if enforce_budget
+        Budget.check!(event, behavior_override: behavior_override)
+        Budget.check_persisted!([event], behavior_override: behavior_override) unless Ingestion.async?
 
         event
       end
 
+      def build_tags(context_tags:, metadata:)
+        resolved = (context_tags || LlmCostTracker::Tags::Context.tags).to_h
+        sanitized_metadata = LlmCostTracker::Tags::Sanitizer.call(metadata.to_h)
+        LlmCostTracker::Tags::Sanitizer.cap(resolved.merge(sanitized_metadata)).freeze
+      end
+
       private
 
       def notify_subscribers(event)
@@ -69,13 +65,12 @@ module LlmCostTracker
         Logging.warn("Subscriber raised on #{EVENT_NAME}: #{e.class}: #{e.message}")
       end
 
-      def build_event(event:, calculation:, metadata:, latency_ms:, context_tags:)
-        context_tags = (context_tags || LlmCostTracker::Tags::Context.tags).to_h
+      def build_event(event:, calculation:, tags:, latency_ms:)
         event.with(
           event_id: SecureRandom.uuid,
           pricing_mode: calculation.mode,
           cost: calculation.cost,
-          tags: build_tags(context_tags: context_tags, metadata: metadata),
+          tags: tags,
           latency_ms: finite_latency_ms(latency_ms),
           tracked_at: Time.now.utc,
           cost_status: calculation.cost_status,
@@ -84,11 +79,6 @@ module LlmCostTracker
         )
       end
 
-      def build_tags(context_tags:, metadata:)
-        sanitized_metadata = LlmCostTracker::Tags::Sanitizer.call(metadata.to_h)
-        LlmCostTracker::Tags::Sanitizer.cap(context_tags.merge(sanitized_metadata)).freeze
-      end
-
       def finite_latency_ms(latency_ms)
         return nil if latency_ms.nil?
 

data/lib/llm_cost_tracker/usage/catalog.rb

@@ -16,8 +16,7 @@ module LlmCostTracker
         "request" => "per_request",
         "session" => "per_session",
         "hour" => "per_hour",
-        "minute" => "per_minute",
-        "image" => "per_image"
+        "minute" => "per_minute"
       }.freeze
 
       class << self

data/lib/llm_cost_tracker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LlmCostTracker
-  VERSION = "0.13.0"
+  VERSION = "0.14.1"
 end

data/lib/llm_cost_tracker.rb

@@ -57,6 +57,7 @@ module LlmCostTracker
       yield(config)
       config.finalize!
       Pricing::Registry.reset!
+      Pricing::Registry.validate_file!(config.pricing.file)
       Integrations.install!
       config
     end
@@ -110,7 +111,12 @@ module LlmCostTracker
                      provider_workspace_id: nil,
                      pricing_mode: nil)
       require_relative "llm_cost_tracker/capture/stream_collector"
-      Budget.enforce!(provider: provider, model: model, force: true) if enforce_budget
+      if enforce_budget
+        Budget.enforce!(provider: provider,
+                        model: model,
+                        force: true,
+                        tags: Tracker.build_tags(context_tags: nil, metadata: tags))
+      end
       collector = Capture::StreamCollector.new(
         provider: provider.to_s,
         model: model,
@@ -123,10 +129,11 @@ module LlmCostTracker
         metadata: tags
       )
       yield collector
-      collector.finish!
-    rescue StandardError
+    rescue Exception # rubocop:disable Lint/RescueException -- record the spend and keep the caller's exception
       collector&.finish!(errored: true)
       raise
+    else
+      collector.finish!
     end
   end
 end

data/lib/tasks/llm_cost_tracker.rake

@@ -6,7 +6,15 @@ require "rails/generators"
 require_relative "../llm_cost_tracker/generators/llm_cost_tracker/install_generator"
 require_relative "../llm_cost_tracker/pricing/sync/change_printer"
 
-# rubocop:disable Metrics/BlockLength
+module LlmCostTrackerTasks
+  def self.price_refresh_output_path
+    path = LlmCostTracker::Pricing::Sync.configured_output_path
+    FileUtils.mkdir_p(File.dirname(path))
+    path
+  end
+end
+
+# rubocop:disable-next Metrics/BlockLength
 namespace :llm_cost_tracker do
   desc "Install LLM Cost Tracker with dashboard and prices, migrate, and run doctor"
   task :setup do
@@ -75,22 +83,36 @@ namespace :llm_cost_tracker do
     puts "llm_cost_tracker: rebuilt #{rows} rollup rows from the calls ledger"
   end
 
+  desc "Copy call cost and time onto existing llm_cost_tracker_call_tags rows so per-tag " \
+       "budgets count history recorded before the upgrade. Use BATCH_SIZE=N to tune."
+  task backfill_tag_costs: :environment do
+    unless LlmCostTracker::Budget::PerTag.columns?
+      abort("llm_cost_tracker: llm_cost_tracker_call_tags is missing the cost columns; " \
+            "run the upgrade_per_tag_budgets generator and migrate first")
+    end
+    batch_size = (ENV["BATCH_SIZE"] || LlmCostTracker::Budget::PerTag::DEFAULT_BACKFILL_BATCH).to_i
+    filled = LlmCostTracker::Budget::PerTag.backfill(batch_size: batch_size)
+    puts "llm_cost_tracker: filled cost and time on #{filled} tag rows"
+  end
+
   namespace :prices do
     desc(
       "Refresh the configured pricing file from the maintained LLM Cost Tracker price snapshot. " \
-      "Use PREVIEW=1 to preview, URL=... to override the source, or OUTPUT=path/to/file.json."
+      "Use PREVIEW=1 to preview, FORCE=1 to accept suspicious price changes, URL=... to override the source, " \
+      "or OUTPUT=path/to/file.json."
     )
     task :refresh do
       Rake::Task["environment"].invoke if Rake::Task.task_defined?("environment")
       require_relative "../llm_cost_tracker"
 
-      output_path = price_refresh_output_path
+      output_path = LlmCostTrackerTasks.price_refresh_output_path
       source_url = LlmCostTracker::Pricing::Sync.configured_remote_url
       preview = ENV["PREVIEW"] == "1"
       result = LlmCostTracker::Pricing::Sync.refresh(
         path: output_path,
         url: source_url,
-        preview: preview
+        preview: preview,
+        force: ENV["FORCE"] == "1"
       )
 
       action = if preview
@@ -104,7 +126,7 @@ namespace :llm_cost_tracker do
       puts "llm_cost_tracker: #{action} pricing file #{result.path}"
       puts "  source: #{result.source_url}"
       puts "  version: #{result.source_version.inspect}" if result.source_version
-      LlmCostTracker::Pricing::Sync::ChangePrinter.call(result.changes)
+      LlmCostTracker::Pricing::Sync::ChangePrinter.call(result.changes, suspicious: result.suspicious)
     end
 
     desc "Compare the current pricing file with the maintained LLM Cost Tracker price snapshot."
@@ -112,23 +134,16 @@ namespace :llm_cost_tracker do
       Rake::Task["environment"].invoke if Rake::Task.task_defined?("environment")
       require_relative "../llm_cost_tracker"
 
-      output_path = price_refresh_output_path
+      output_path = LlmCostTrackerTasks.price_refresh_output_path
       source_url = LlmCostTracker::Pricing::Sync.configured_remote_url
       result = LlmCostTracker::Pricing::Sync.check(path: output_path, url: source_url)
 
       puts "llm_cost_tracker: checked pricing file #{result.path}"
       puts "  source: #{result.source_url}"
       puts "  version: #{result.source_version.inspect}" if result.source_version
-      LlmCostTracker::Pricing::Sync::ChangePrinter.call(result.changes)
+      LlmCostTracker::Pricing::Sync::ChangePrinter.call(result.changes, suspicious: result.suspicious)
       puts "  pricing is up to date" if result.up_to_date
       abort("llm_cost_tracker: pricing check failed") unless result.up_to_date
     end
   end
 end
-# rubocop:enable Metrics/BlockLength
-
-def price_refresh_output_path
-  path = LlmCostTracker::Pricing::Sync.configured_output_path
-  FileUtils.mkdir_p(File.dirname(path))
-  path
-end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm_cost_tracker
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.1
 platform: ruby
 authors:
 - Sergii Khomenko
@@ -109,42 +109,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.42'
+        version: '1.61'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.42'
+        version: '1.61'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '1.19'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '1.19'
 - !ruby/object:Gem::Dependency
   name: openai
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.63'
+        version: '0.80'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.63'
+        version: '0.80'
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -205,16 +205,22 @@ dependencies:
   name: ruby_llm
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.16'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.16'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -339,9 +345,12 @@ files:
 - lib/llm_cost_tracker.rb
 - lib/llm_cost_tracker/assets.rb
 - lib/llm_cost_tracker/budget.rb
+- lib/llm_cost_tracker/budget/per_tag.rb
+- lib/llm_cost_tracker/capture/event_window.rb
 - lib/llm_cost_tracker/capture/sdk_payload.rb
 - lib/llm_cost_tracker/capture/sse.rb
 - lib/llm_cost_tracker/capture/stream_collector.rb
+- lib/llm_cost_tracker/capture/stream_tap.rb
 - lib/llm_cost_tracker/capture/stream_tracker.rb
 - lib/llm_cost_tracker/capture_verifier.rb
 - lib/llm_cost_tracker/charges/cost.rb
@@ -349,7 +358,15 @@ files:
 - lib/llm_cost_tracker/charges/line_item.rb
 - lib/llm_cost_tracker/check.rb
 - lib/llm_cost_tracker/configuration.rb
+- lib/llm_cost_tracker/configuration/budgets.rb
+- lib/llm_cost_tracker/configuration/capture.rb
+- lib/llm_cost_tracker/configuration/ingestion.rb
+- lib/llm_cost_tracker/configuration/mutability.rb
+- lib/llm_cost_tracker/configuration/pricing.rb
+- lib/llm_cost_tracker/configuration/section.rb
+- lib/llm_cost_tracker/configuration/tags.rb
 - lib/llm_cost_tracker/currency.rb
+- lib/llm_cost_tracker/deprecator.rb
 - lib/llm_cost_tracker/doctor.rb
 - lib/llm_cost_tracker/doctor/ingestion_check.rb
 - lib/llm_cost_tracker/doctor/price_check.rb
@@ -369,9 +386,13 @@ files:
 - lib/llm_cost_tracker/generators/llm_cost_tracker/templates/upgrade_call_rollups_provider.rb.erb
 - lib/llm_cost_tracker/generators/llm_cost_tracker/templates/upgrade_call_tags_key_value_index.rb.erb
 - lib/llm_cost_tracker/generators/llm_cost_tracker/templates/upgrade_image_tokens.rb.erb
+- lib/llm_cost_tracker/generators/llm_cost_tracker/templates/upgrade_indexes.rb.erb
+- lib/llm_cost_tracker/generators/llm_cost_tracker/templates/upgrade_per_tag_budgets.rb.erb
 - lib/llm_cost_tracker/generators/llm_cost_tracker/upgrade_call_rollups_provider_generator.rb
 - lib/llm_cost_tracker/generators/llm_cost_tracker/upgrade_call_tags_key_value_index_generator.rb
 - lib/llm_cost_tracker/generators/llm_cost_tracker/upgrade_image_tokens_generator.rb
+- lib/llm_cost_tracker/generators/llm_cost_tracker/upgrade_indexes_generator.rb
+- lib/llm_cost_tracker/generators/llm_cost_tracker/upgrade_per_tag_budgets_generator.rb
 - lib/llm_cost_tracker/ingestion.rb
 - lib/llm_cost_tracker/ingestion/batch.rb
 - lib/llm_cost_tracker/ingestion/inbox.rb
@@ -386,6 +407,7 @@ files:
 - lib/llm_cost_tracker/integrations/openai/patches.rb
 - lib/llm_cost_tracker/integrations/ruby_llm.rb
 - lib/llm_cost_tracker/ledger.rb
+- lib/llm_cost_tracker/ledger/isolation.rb
 - lib/llm_cost_tracker/ledger/period.rb
 - lib/llm_cost_tracker/ledger/period/totals.rb
 - lib/llm_cost_tracker/ledger/rollups.rb
@@ -398,6 +420,7 @@ files:
 - lib/llm_cost_tracker/ledger/schema/calls.rb
 - lib/llm_cost_tracker/ledger/schema/ingestion/inbox_entries.rb
 - lib/llm_cost_tracker/ledger/schema/ingestion/leases.rb
+- lib/llm_cost_tracker/ledger/storable.rb
 - lib/llm_cost_tracker/ledger/store.rb
 - lib/llm_cost_tracker/ledger/tags/breakdown.rb
 - lib/llm_cost_tracker/ledger/tags/encoding.rb
@@ -423,6 +446,7 @@ files:
 - lib/llm_cost_tracker/pricing/sync/fetcher.rb
 - lib/llm_cost_tracker/pricing/sync/registry_diff.rb
 - lib/llm_cost_tracker/pricing/sync/registry_writer.rb
+- lib/llm_cost_tracker/pricing/sync/snapshot_guard.rb
 - lib/llm_cost_tracker/pricing/unknown.rb
 - lib/llm_cost_tracker/providers.rb
 - lib/llm_cost_tracker/providers/anthropic/parser.rb
@@ -441,6 +465,7 @@ files:
 - lib/llm_cost_tracker/providers/openai/usage_extractor.rb
 - lib/llm_cost_tracker/providers/openai_compatible/parser.rb
 - lib/llm_cost_tracker/railtie.rb
+- lib/llm_cost_tracker/redaction.rb
 - lib/llm_cost_tracker/report.rb
 - lib/llm_cost_tracker/report/data.rb
 - lib/llm_cost_tracker/report/formatter.rb
@@ -473,7 +498,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.4.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="