equilibrium 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5420df18928550fa411f853968f4b5ac331fbcd3bcc682dce61370c330dd69bc
-  data.tar.gz: 062322ae383ea3aba97d0d60980f8530808e7877e5bb5a6ce311435ec6a86814
+  metadata.gz: d710d1c2fea441e38c5b328c036506115b7b80ade1aae20ffda4badbf9c72b76
+  data.tar.gz: c99ba87639818a92306c31c2764a604238a98607d4d655b63e6536c32b64af67
 SHA512:
-  metadata.gz: 3900bcb75092a001f250dbe206d4085419435e7d2b370c3a68e57e82619e1a7b014dd32a71510f887e060244c122336f70f946bd836e1c2ef956d5500416d93c
-  data.tar.gz: 2678994b5a362aa3e282618dd49f401aa63d50905f13b0fc74323d0747dc73d076aa872c915843e8d4002a9f1042992e33b5251a5f10cbeb9405d8bb2d29454d
+  metadata.gz: d5ccfd2ac6a95cf83efeed1dc59b27e1c474f9211e6155da8ae35938bc9a4316c002509e9fb60757403c3130359b1f854a0aaf84bfd9c470caacdaa5cb8c9f14
+  data.tar.gz: 76445a5a0e8e0f2e0a1f347394b44700a9e65fd2b3d23eaad0d8c1f387d54619aad184d9aa2fa50b6286660e140221cfef8e03def80768cbf5b5421e7aa61e2e

data/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.1] - 2025-08-06
+
+### Added
+- GitHub Packages publishing support in release workflow
+- Draft mode for GitHub releases requiring manual review
+- Enhanced release automation with artifact attachment
+
+### Fixed
+- Preserve descending tag order in summary format output
+- Consistent descending ordering for expected and actual outputs
+
+### Changed
+- Reorganized spec files to mirror lib directory structure
+- Extracted TagSorter utility with comprehensive unit tests
+- Enhanced RegistryClient with pagination analysis capabilities
+
 ## [0.1.0] - 2025-08-05
 
 ### Added
@@ -37,4 +53,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Detailed architecture overview and data flow diagrams
 - Complete command reference and examples
 
+[0.1.1]: https://github.com/DataDog/equilibrium/releases/tag/v0.1.1
 [0.1.0]: https://github.com/DataDog/equilibrium/releases/tag/v0.1.0

data/lib/equilibrium/cli.rb

@@ -51,11 +51,15 @@ module Equilibrium
       # Extract repository name from URL
       repository_name = extract_repository_name(full_repository_url)
 
+      # Sort both digests and canonical_versions in descending order right before output
+      sorted_digests = TagSorter.sort_descending(virtual_tags_result["digests"])
+      sorted_canonical_versions = TagSorter.sort_descending(virtual_tags_result["canonical_versions"])
+
       output = {
         "repository_url" => full_repository_url,
         "repository_name" => repository_name,
-        "digests" => virtual_tags_result["digests"],
-        "canonical_versions" => virtual_tags_result["canonical_versions"]
+        "digests" => sorted_digests,
+        "canonical_versions" => sorted_canonical_versions
       }
 
       # Validate output against schema before writing
@@ -100,11 +104,15 @@ module Equilibrium
       # Extract repository name from URL
       repository_name = extract_repository_name(full_repository_url)
 
+      # Sort both digests and canonical_versions in descending order right before output
+      sorted_digests = TagSorter.sort_descending(mutable_tags)
+      sorted_canonical_versions = TagSorter.sort_descending(canonical_versions)
+
       output = {
         "repository_url" => full_repository_url,
         "repository_name" => repository_name,
-        "digests" => mutable_tags,
-        "canonical_versions" => canonical_versions
+        "digests" => sorted_digests,
+        "canonical_versions" => sorted_canonical_versions
       }
 
       # Validate output against schema before writing

data/lib/equilibrium/registry_client.rb

@@ -26,6 +26,29 @@ module Equilibrium
   # by some registries (like GCR). Most registries follow the Docker Registry v2 spec
   # which only returns 'name' and 'tags' fields. To get digest information, separate
   # calls to /v2/<name>/manifests/<tag> are required per the official specification.
+  #
+  # PAGINATION ANALYSIS (August 2025):
+  # Current implementation fetches ALL tags in single API call. Analysis of production registries:
+  # - apm-inject: 29 tags
+  # - dd-lib-dotnet-init: 31 tags
+  # - dd-lib-java-init: 18 tags
+  # - dd-lib-js-init: 56 tags (largest)
+  # - dd-lib-php-init: 10 tags
+  # - dd-lib-python-init: 27 tags
+  # - dd-lib-ruby-init: 19 tags
+  # Total: 190 tags across all registries
+  #
+  # GCR PAGINATION RESEARCH FINDINGS:
+  # - DOCUMENTED LIMIT: 10,000 items for format-specific API requests
+  #   Source: https://cloud.google.com/artifact-registry/quotas
+  # - NO PAGINATION SUPPORT: GCR ignores Docker Registry v2 pagination parameters ('n', 'last')
+  #   Source: https://stackoverflow.com/questions/38307259 (unresolved since 2016)
+  # - ALL-OR-NOTHING: Returns complete tag lists up to 10k limit, then truncates unpredictably
+  # - NO PER-PAGE LIMIT: Not documented, not applicable due to lack of pagination support
+  #
+  # RECOMMENDATION: Current single-request approach is sufficient.
+  # Implementation complexity for pagination: 3-4 hours with minimal benefit.
+  # Consider only if individual repositories approach thousands of tags.
   class RegistryClient
     class Error < StandardError; end
 

data/lib/equilibrium/summary_formatter.rb

@@ -104,7 +104,7 @@ module Equilibrium
 
       # Create table data: [["Tag", "Version", "Digest"]]
       table_data = [["Tag", "Version", "Digest"]]
-      mutable_tags.keys.sort.each do |tag|
+      mutable_tags.keys.each do |tag|
         canonical_version = canonical_versions[tag]
         digest = mutable_tags[tag]
         table_data << [tag, canonical_version, digest]

data/lib/equilibrium/tag_processor.rb

@@ -57,16 +57,12 @@ module Equilibrium
 
     def filter_semantic_tags(all_tags)
       # Filter semantic tags (canonical_tags.json): exact major.minor.patch format
-      filtered = all_tags.select { |tag, _| semantic_version?(tag) }
-      # Sort by key in reverse order (matching original jq: sort_by(.key) | reverse)
-      filtered.sort_by { |tag, _| tag }.reverse.to_h
+      all_tags.select { |tag, _| semantic_version?(tag) }
     end
 
     def filter_mutable_tags(all_tags)
       # Filter mutable tags (actual_tags.json): latest, digits, or major.minor format
-      filtered = all_tags.select { |tag, _| mutable_tag?(tag) }
-      # Sort by key in reverse order (matching original jq: sort_by(.key) | reverse)
-      filtered.sort_by { |tag, _| tag }.reverse.to_h
+      all_tags.select { |tag, _| mutable_tag?(tag) }
     end
 
     private

data/lib/equilibrium/tag_sorter.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Equilibrium
+  class TagSorter
+    # Sort tags in descending version order: latest first, then major versions (descending), then minor versions (descending)
+    def self.sort_descending(tags_hash)
+      new.sort_descending(tags_hash)
+    end
+
+    def sort_descending(tags_hash)
+      return {} if tags_hash.nil? || tags_hash.empty?
+
+      sorted = {}
+
+      # Add latest first if present
+      if tags_hash.key?("latest")
+        sorted["latest"] = tags_hash["latest"]
+      end
+
+      # Sort other tags by version (descending)
+      other_tags = tags_hash.keys.reject { |k| k == "latest" }
+      sorted_tags = other_tags.sort_by do |tag|
+        if major_version?(tag)
+          # Major version: sort by numeric value (descending)
+          [-tag.to_i]
+        elsif minor_version?(tag)
+          # Minor version: sort by version (descending)
+          parts = tag.split(".").map(&:to_i)
+          [-parts[0], -parts[1]]
+        else
+          # Fallback for any unexpected formats - sort alphabetically
+          [1, tag]
+        end
+      end
+
+      sorted_tags.each do |tag|
+        sorted[tag] = tags_hash[tag]
+      end
+
+      sorted
+    end
+
+    private
+
+    def major_version?(tag)
+      tag.match?(/^[0-9]+$/)
+    end
+
+    def minor_version?(tag)
+      tag.match?(/^[0-9]+\.[0-9]+$/)
+    end
+  end
+end

data/lib/equilibrium/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Equilibrium
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/equilibrium.rb

@@ -4,6 +4,7 @@ require_relative "equilibrium/version"
 require_relative "equilibrium/semantic_version"
 require_relative "equilibrium/registry_client"
 require_relative "equilibrium/tag_processor"
+require_relative "equilibrium/tag_sorter"
 require_relative "equilibrium/catalog_builder"
 require_relative "equilibrium/analyzer"
 require_relative "equilibrium/schemas/expected_actual"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: equilibrium
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Tony Hsu
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-05 00:00:00.000000000 Z
+date: 2025-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -82,6 +82,7 @@ files:
 - lib/equilibrium/semantic_version.rb
 - lib/equilibrium/summary_formatter.rb
 - lib/equilibrium/tag_processor.rb
+- lib/equilibrium/tag_sorter.rb
 - lib/equilibrium/version.rb
 - tmp/.gitkeep
 homepage: https://github.com/TonyCTHsu/equilibrium
@@ -91,6 +92,7 @@ metadata:
   homepage_uri: https://github.com/TonyCTHsu/equilibrium
   source_code_uri: https://github.com/TonyCTHsu/equilibrium
   changelog_uri: https://github.com/TonyCTHsu/equilibrium/blob/master/CHANGELOG.md
+  github_repo: ssh://github.com/TonyCTHsu/tobee
 post_install_message:
 rdoc_options: []
 require_paths: