perfgate 0.1.0

data/lib/perfgate/workloads/registry.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Perfgate
+  module Workloads
+    # Collects Workload instances discovered for a run and enforces the
+    # uniqueness rule from spec section 9.2: "a duplicate explicit ID is
+    # a configuration error".
+    class Registry
+      include Enumerable
+
+      class << self
+        def instance
+          @instance ||= new
+        end
+
+        def reset!
+          @instance = new
+        end
+      end
+
+      def initialize
+        @workloads = {}
+      end
+
+      def register(workload)
+        raise Perfgate::WorkloadError, "duplicate workload id: #{workload.id.inspect}" if @workloads.key?(workload.id)
+
+        @workloads[workload.id] = workload
+      end
+
+      def [](id)
+        @workloads[id]
+      end
+
+      def each(&block)
+        return enum_for(:each) unless block
+
+        @workloads.each_value(&block)
+      end
+
+      def ids
+        @workloads.keys
+      end
+
+      def clear
+        @workloads.clear
+      end
+    end
+  end
+end

data/lib/perfgate/workloads/workload.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Perfgate
+  module Workloads
+    # A deterministic executable path measured by Baseline (spec section
+    # 7). Normally backed by one RSpec example, but the callable is kept
+    # generic so the execution engine can be exercised without RSpec.
+    class Workload
+      attr_reader :id, :samples, :warmup, :metrics
+
+      def initialize(id:, samples:, warmup:, metrics: [:duration], &block)
+        raise ArgumentError, "workload #{id.inspect} requires a block to execute" unless block
+
+        @id = id
+        @samples = samples
+        @warmup = warmup
+        @metrics = metrics
+        @block = block
+      end
+
+      def call
+        @block.call
+      end
+    end
+  end
+end

data/lib/perfgate.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require_relative "perfgate/version"
+require_relative "perfgate/errors"
+require_relative "perfgate/config"
+require_relative "perfgate/workloads/registry"
+require_relative "perfgate/execution/sample_context"
+
+# Baseline is a CI-native performance assurance tool for Ruby on Rails
+# applications. It converts selected RSpec examples into repeatable
+# performance workloads and compares them against a compatible
+# default-branch baseline to produce a merge-gate decision.
+module Perfgate
+  class << self
+    # Explicitly marks the block whose execution should be measured by
+    # Baseline (spec section 9.1). Outside of a running workload sample
+    # (e.g. called directly in a plain unit test) this simply executes
+    # the block and returns its value without recording anything.
+    def measure(&block)
+      context = Execution::SampleContext.current
+      return block.call unless context
+
+      context.measure(&block)
+    end
+
+    # The active configuration, loaded via Config.load or Config.default.
+    # `baseline run` assigns this after loading baseline.yml.
+    def configuration
+      @configuration ||= Config.default
+    end
+
+    attr_writer :configuration
+
+    # Yields the active configuration for in-code customization, e.g.
+    # `Perfgate.configure { |config| config.dataset_fingerprint = -> { ... } }`
+    # (spec section 12.3).
+    def configure
+      yield configuration
+    end
+
+    # The process-wide workload registry that RSpec discovery populates.
+    def registry
+      Workloads::Registry.instance
+    end
+  end
+end

data/perfgate.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "lib/perfgate/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "perfgate"
+  spec.version = Perfgate::VERSION
+  spec.authors = ["Alexander Potrakhov"]
+  spec.email = ["bendthe@gmail.com"]
+
+  spec.summary = "CI-native performance regression assurance for Rails and RSpec."
+  spec.description = "Baseline converts selected RSpec examples into repeatable performance " \
+                     "workloads, measures application-level signals (duration, SQL activity, " \
+                     "allocations, GC), compares a pull request against a compatible " \
+                     "default-branch baseline, and produces a clear CI merge-gate decision."
+  spec.homepage = "https://github.com/a11ejandro/perfgate"
+  spec.license = "Apache-2.0"
+  spec.required_ruby_version = ">= 3.1.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ spikes/ .git .github appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "rspec-core", "~> 3.12"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/schemas/comparison-result-v1.schema.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://baseline.dev/schemas/comparison-result-v1.schema.json",
+  "title": "Baseline Comparison Result v1",
+  "description": "Placeholder schema. To be defined per section 14.2 of the technical specification.",
+  "type": "object"
+}

data/schemas/run-result-v1.schema.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://baseline.dev/schemas/run-result-v1.schema.json",
+  "title": "Baseline Run Result v1",
+  "description": "Placeholder schema. To be defined per section 14.1 of the technical specification.",
+  "type": "object"
+}

data/sig/perfgate.rbs

@@ -0,0 +1,4 @@
+module Perfgate
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: perfgate
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alexander Potrakhov
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-08-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+description: Baseline converts selected RSpec examples into repeatable performance
+  workloads, measures application-level signals (duration, SQL activity, allocations,
+  GC), compares a pull request against a compatible default-branch baseline, and produces
+  a clear CI merge-gate decision.
+email:
+- bendthe@gmail.com
+executables:
+- perfgate
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE
+- NOT_FINALIZED.md
+- README.md
+- ROADMAP.md
+- Rakefile
+- SECURITY.md
+- docs/README.md
+- docs/architecture.md
+- docs/compatibility.md
+- docs/launch-article.md
+- docs/onboarding.md
+- docs/telemetry.md
+- examples/rails-rspec-app/.github/workflows/baseline.yml
+- examples/rails-rspec-app/README.md
+- examples/rails-rspec-app/spec/jobs/invoice_job_spec.rb
+- examples/rails-rspec-app/spec/requests/checkout_spec.rb
+- exe/perfgate
+- lib/perfgate.rb
+- lib/perfgate/cli.rb
+- lib/perfgate/cli/compare_command.rb
+- lib/perfgate/cli/run_command.rb
+- lib/perfgate/cli/run_comparison_reporter.rb
+- lib/perfgate/comparison/deterministic_metric_decision.rb
+- lib/perfgate/comparison/diagnostics.rb
+- lib/perfgate/comparison/engine.rb
+- lib/perfgate/comparison/metric_change.rb
+- lib/perfgate/comparison/metric_decision.rb
+- lib/perfgate/comparison/statistical_metric_decision.rb
+- lib/perfgate/comparison/workload_comparison.rb
+- lib/perfgate/config.rb
+- lib/perfgate/config/defaults.rb
+- lib/perfgate/config/env_overrides.rb
+- lib/perfgate/config/schema.rb
+- lib/perfgate/config/validator.rb
+- lib/perfgate/errors.rb
+- lib/perfgate/execution/process_runner.rb
+- lib/perfgate/execution/runner.rb
+- lib/perfgate/execution/sample_context.rb
+- lib/perfgate/fingerprints/compatibility.rb
+- lib/perfgate/fingerprints/components.rb
+- lib/perfgate/fingerprints/workload_definition.rb
+- lib/perfgate/instrumentation.rb
+- lib/perfgate/instrumentation/allocations.rb
+- lib/perfgate/instrumentation/duration.rb
+- lib/perfgate/instrumentation/gc.rb
+- lib/perfgate/instrumentation/sql_activity.rb
+- lib/perfgate/metrics/.gitkeep
+- lib/perfgate/policy/engine.rb
+- lib/perfgate/rails/.gitkeep
+- lib/perfgate/report/console.rb
+- lib/perfgate/report/markdown.rb
+- lib/perfgate/reporting/.gitkeep
+- lib/perfgate/rspec.rb
+- lib/perfgate/rspec/discovery.rb
+- lib/perfgate/rspec/id_resolver.rb
+- lib/perfgate/rspec/workload_builder.rb
+- lib/perfgate/serialization/run_result.rb
+- lib/perfgate/statistics/mann_whitney_u.rb
+- lib/perfgate/statistics/summary.rb
+- lib/perfgate/storage/adapter.rb
+- lib/perfgate/storage/archive.rb
+- lib/perfgate/storage/filesystem.rb
+- lib/perfgate/telemetry/.gitkeep
+- lib/perfgate/version.rb
+- lib/perfgate/workloads/registry.rb
+- lib/perfgate/workloads/workload.rb
+- perfgate.gemspec
+- schemas/comparison-result-v1.schema.json
+- schemas/run-result-v1.schema.json
+- sig/perfgate.rbs
+homepage: https://github.com/a11ejandro/perfgate
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://github.com/a11ejandro/perfgate
+  source_code_uri: https://github.com/a11ejandro/perfgate
+  changelog_uri: https://github.com/a11ejandro/perfgate/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: CI-native performance regression assurance for Rails and RSpec.
+test_files: []