equilibrium 0.1.0 → 0.2.0

data/lib/equilibrium/tag_processor.rb

@@ -8,6 +8,14 @@ module Equilibrium
       new.compute_virtual_tags(semantic_tags)
     end
 
+    def self.filter_semantic_tags(tagged_digests)
+      new.filter_semantic_tags(tagged_digests)
+    end
+
+    def self.filter_mutable_tags(tagged_digests)
+      new.filter_mutable_tags(tagged_digests)
+    end
+
     def compute_virtual_tags(semantic_tags)
       return {"digests" => {}, "canonical_versions" => {}} if semantic_tags.empty?
 
@@ -55,30 +63,32 @@ module Equilibrium
       {"digests" => digests, "canonical_versions" => canonical_versions}
     end
 
-    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
+    def filter_semantic_tags(tagged_digests)
+      tagged_digests.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
+    def filter_mutable_tags(tagged_digests)
+      tagged_digests.select { |tag, _| mutable_tag?(tag) }
     end
 
     private
 
     def semantic_version?(tag)
-      SemanticVersion.valid?(tag)
+      # Strictly validate MAJOR.MINOR.PATCH format where:
+      # - MAJOR, MINOR, PATCH are non-negative integers
+      # - No leading zeros (except for '0' itself)
+      # - No prefixes (like 'v1.2.3', 'release-1.2.3')
+      # - No suffixes (like '1.2.3-alpha', '1.2.3+build')
+      # - No prereleases (like '1.2.3-rc.1', '1.2.3-beta.2')
+      tag.match?(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/)
     end
 
     def mutable_tag?(tag)
-      tag.match?(/^latest$/) ||
-        tag.match?(/^[0-9]+$/) ||
-        tag.match?(/^[0-9]+\.[0-9]+$/)
+      # Validate mutable tags: latest, major versions (digits only), or major.minor format
+      # - 'latest' is the special case for the highest overall version
+      # - Major versions: non-negative integers without leading zeros (e.g., '1', '0', '42')
+      # - Minor versions: MAJOR.MINOR format with same zero-leading rules (e.g., '1.2', '0.9')
+      tag.match?(/^(latest|(0|[1-9]\d*)(\.(0|[1-9]\d*))?)$/)
     end
   end
 end

data/lib/equilibrium/tag_sorter.rb

@@ -0,0 +1,39 @@
+# 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)
+      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 tag.match?(/^[0-9]+$/)
+          # Major version: sort by numeric value (descending)
+          [-tag.to_i]
+        elsif tag.match?(/^[0-9]+\.[0-9]+$/)
+          # 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
+  end
+end

data/lib/equilibrium/tags_operation_service.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative "repository_tags_service"
+require_relative "tag_data_builder"
+
+module Equilibrium
+  class TagsOperationService
+    def self.generate_expected_output(repository_url)
+      tag_data = RepositoryTagsService.generate_expected_tags(repository_url)
+      repository_name = repository_url.split("/").last
+
+      TagDataBuilder.build_output(
+        repository_url,
+        repository_name,
+        tag_data["digests"],
+        tag_data["canonical_versions"]
+      )
+    end
+
+    def self.generate_actual_output(repository_url)
+      tag_data = RepositoryTagsService.generate_actual_tags(repository_url)
+      repository_name = repository_url.split("/").last
+
+      TagDataBuilder.build_output(
+        repository_url,
+        repository_name,
+        tag_data["digests"],
+        tag_data["canonical_versions"]
+      )
+    end
+  end
+end

data/lib/equilibrium/version.rb

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

data/lib/equilibrium.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 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.2.0
 platform: ruby
 authors:
 - Tony Hsu
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-05 00:00:00.000000000 Z
+date: 2025-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -71,17 +71,30 @@ files:
 - exe/equilibrium
 - lib/equilibrium.rb
 - lib/equilibrium/analyzer.rb
+- lib/equilibrium/canonical_version_mapper.rb
 - lib/equilibrium/catalog_builder.rb
 - lib/equilibrium/cli.rb
+- lib/equilibrium/commands/actual_command.rb
+- lib/equilibrium/commands/analyze_command.rb
+- lib/equilibrium/commands/catalog_command.rb
+- lib/equilibrium/commands/expected_command.rb
+- lib/equilibrium/commands/uncatalog_command.rb
+- lib/equilibrium/commands/version_command.rb
+- lib/equilibrium/mixins/error_handling.rb
+- lib/equilibrium/mixins/input_output.rb
 - lib/equilibrium/registry_client.rb
+- lib/equilibrium/repository_tags_service.rb
+- lib/equilibrium/repository_url_validator.rb
 - lib/equilibrium/schema_validator.rb
 - lib/equilibrium/schemas/analyzer_output.rb
 - lib/equilibrium/schemas/catalog.rb
 - lib/equilibrium/schemas/expected_actual.rb
 - lib/equilibrium/schemas/registry_api.rb
-- lib/equilibrium/semantic_version.rb
 - lib/equilibrium/summary_formatter.rb
+- lib/equilibrium/tag_data_builder.rb
 - lib/equilibrium/tag_processor.rb
+- lib/equilibrium/tag_sorter.rb
+- lib/equilibrium/tags_operation_service.rb
 - lib/equilibrium/version.rb
 - tmp/.gitkeep
 homepage: https://github.com/TonyCTHsu/equilibrium
@@ -90,7 +103,8 @@ licenses:
 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
+  changelog_uri: https://github.com/TonyCTHsu/equilibrium/blob/v0.2.0/CHANGELOG.md
+  github_repo: ssh://github.com/TonyCTHsu/equilibrium
 post_install_message:
 rdoc_options: []
 require_paths:

data/lib/equilibrium/semantic_version.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module Equilibrium
-  module SemanticVersion
-    # Strictly validate MAJOR.MINOR.PATCH format where:
-    # - MAJOR, MINOR, PATCH are non-negative integers
-    # - No leading zeros (except for '0' itself)
-    # - No prefixes (like 'v1.2.3', 'release-1.2.3')
-    # - No suffixes (like '1.2.3-alpha', '1.2.3+build')
-    # - No prereleases (like '1.2.3-rc.1', '1.2.3-beta.2')
-    def self.valid?(tag)
-      # Strict regex: each component must be either '0' or a number without leading zeros
-      return false unless tag.match?(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/)
-
-      # Additional validation: ensure it's a valid Gem::Version
-      begin
-        Gem::Version.new(tag)
-        true
-      rescue ArgumentError
-        false
-      end
-    end
-  end
-end