rbbb 0.1.0.pre.3

data/lib/rbbb/timestamp.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "time"
+
+module RBBB
+  # Strict parsing and canonical serialization for authoritative UTC times.
+  module Timestamp
+    # Normative precision is one millisecond. Finer input is rejected rather
+    # than truncated so that a millisecond-native implementation replays the
+    # same command stream to the same closing times.
+    PRECISION_DIGITS = 3
+    NANOSECONDS_PER_UNIT = 10**(9 - PRECISION_DIGITS)
+
+    # Date, "T", time, optional fraction of at most PRECISION_DIGITS digits,
+    # and a mandatory zone designator. Ruby's Time.iso8601 silently treats a
+    # zone-less string as host-local time, which would let the host's TZ
+    # setting change auction outcomes.
+    FORMAT = /\A\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,#{PRECISION_DIGITS}})?(?:Z|[+-]\d{2}:\d{2})\z/
+
+    module_function
+
+    def parse(value)
+      time = case value
+      when Time
+        value
+      when String
+        unless value.match?(FORMAT)
+          raise ArgumentError,
+            "timestamp must carry an explicit UTC offset and at most #{PRECISION_DIGITS} fractional digits"
+        end
+
+        Time.iso8601(value)
+      else
+        raise ArgumentError, "timestamp must be an ISO 8601 string or Time"
+      end
+
+      unless (time.nsec % NANOSECONDS_PER_UNIT).zero?
+        raise ArgumentError, "timestamp precision must not exceed #{PRECISION_DIGITS} fractional digits"
+      end
+
+      time.getutc.freeze
+    end
+
+    # Canonical form: UTC with "Z", the fraction omitted when zero and
+    # otherwise trimmed of trailing zeros, never more than PRECISION_DIGITS.
+    def dump(time)
+      return nil unless time
+
+      formatted = time.getutc.iso8601(PRECISION_DIGITS)
+      formatted.sub!(/0+Z\z/, "Z")
+      formatted.sub!(/\.Z\z/, "Z")
+      formatted
+    end
+  end
+end

data/lib/rbbb/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module RBBB
+  VERSION = "0.1.0.pre.3"
+  SPECIFICATION_VERSION = "0.1.0-draft"
+  RELEASE_STATUS = "experimental"
+end

data/lib/rbbb.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative "rbbb/version"
+
+# Namespace for the R Triple B Ruby reference implementation.
+module RBBB
+  # Largest integer any RFC 0001 field may carry: 2**53 - 1. It is the largest
+  # integer that is exact in all of JSON, IEEE 754 doubles, and 64-bit
+  # integers, so every conforming implementation can represent every value.
+  # Amounts, versions, priorities, and extension seconds all share it.
+  MAX_SAFE_INTEGER = (2**53) - 1
+
+  class Error < StandardError; end
+  class InvalidConfiguration < Error; end
+  class InvalidMoney < Error; end
+  class InvalidState < Error; end
+  class UnsupportedFeature < Error; end
+end
+
+require_relative "rbbb/money"
+require_relative "rbbb/increment_schedule"
+require_relative "rbbb/timestamp"
+require_relative "rbbb/configuration"
+require_relative "rbbb/event"
+require_relative "rbbb/decision"
+require_relative "rbbb/state"
+require_relative "rbbb/engine"

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: rbbb
+version: !ruby/object:Gem::Version
+  version: 0.1.0.pre.3
+platform: ruby
+authors:
+- R Triple B contributors
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: |-
+  An evaluation build of the pure-Ruby reference implementation for the
+  language-neutral RBBB bidding specification. It is not production ready.
+email:
+- will@mclemoreauction.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+- LICENSE
+files:
+- LICENSE
+- README.md
+- lib/rbbb.rb
+- lib/rbbb/configuration.rb
+- lib/rbbb/decision.rb
+- lib/rbbb/engine.rb
+- lib/rbbb/event.rb
+- lib/rbbb/increment_schedule.rb
+- lib/rbbb/money.rb
+- lib/rbbb/state.rb
+- lib/rbbb/timestamp.rb
+- lib/rbbb/version.rb
+homepage: https://github.com/willtmc/rbbb
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  bug_tracker_uri: https://github.com/willtmc/rbbb/issues
+  changelog_uri: https://github.com/willtmc/rbbb/blob/v0.1.0.pre.3/CHANGELOG.md
+  documentation_uri: https://github.com/willtmc/rbbb/blob/v0.1.0.pre.3/ruby/engine/README.md
+  homepage_uri: https://github.com/willtmc/rbbb
+  rbbb_release_status: experimental
+  rbbb_rfc: '0001'
+  rbbb_specification_version: 0.1.0-draft
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/willtmc/rbbb/tree/v0.1.0.pre.3/ruby/engine
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Experimental Ruby reference engine for deterministic auction bidding
+test_files: []