equilibrium 0.1.0

data/lib/equilibrium/summary_formatter.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+require "thor"
+
+module Equilibrium
+  class SummaryFormatter
+    include Thor::Shell
+
+    def initialize
+      # Initialize Thor::Shell methods with empty arguments
+      self.shell = Thor::Shell::Basic.new
+    end
+
+    def print_analysis_summary(analysis)
+      say "Repository URL: #{analysis[:repository_url]}"
+      say ""
+
+      # Status overview table
+      status_color = (analysis[:status] == "perfect") ? :green : :yellow
+      status_symbol = (analysis[:status] == "perfect") ? "✓" : "⚠"
+
+      overview_data = [
+        ["Metric", "Count"],
+        ["Expected tags", analysis[:expected_count].to_s],
+        ["Actual tags", analysis[:actual_count].to_s],
+        ["Missing tags", analysis[:missing_tags].size.to_s],
+        ["Mismatched tags", analysis[:mismatched_tags].size.to_s],
+        ["Unexpected tags", analysis[:unexpected_tags].size.to_s]
+      ]
+
+      say "Analysis Overview:"
+      print_table(overview_data, borders: true)
+      say ""
+
+      say "#{status_symbol} Status: #{analysis[:status].upcase.tr("_", " ")}", status_color
+      say ""
+
+      # Show specific issue sections
+      has_issues = false
+
+      # Missing tags section
+      if analysis[:missing_tags].any?
+        has_issues = true
+        say "Missing Tags (should be created):"
+        missing_table = [["Tag", "Should Point To"]]
+        analysis[:missing_tags].each do |tag, digest|
+          short_digest = digest ? digest.split(":").last[0..11] : "unknown"
+          missing_table << [tag, short_digest]
+        end
+        print_table(missing_table, borders: true)
+        say ""
+      end
+
+      # Mismatched tags section
+      if analysis[:mismatched_tags].any?
+        has_issues = true
+        say "Mismatched Tags (pointing to wrong version):"
+        mismatched_table = [["Tag", "Expected", "Actual"]]
+        analysis[:mismatched_tags].each do |tag, details|
+          if details.is_a?(Hash)
+            expected = details[:expected] ? details[:expected].split(":").last[0..11] : "unknown"
+            actual = details[:actual] ? details[:actual].split(":").last[0..11] : "unknown"
+          else
+            expected = details ? details.split(":").last[0..11] : "unknown"
+            actual = "unknown"
+          end
+          mismatched_table << [tag, expected, actual]
+        end
+        print_table(mismatched_table, borders: true)
+        say ""
+      end
+
+      # Unexpected tags section
+      if analysis[:unexpected_tags].any?
+        has_issues = true
+        say "Unexpected Tags (should be removed):"
+        unexpected_table = [["Tag", "Currently Points To"]]
+        analysis[:unexpected_tags].each do |tag, digest|
+          short_digest = digest ? digest.split(":").last[0..11] : "unknown"
+          unexpected_table << [tag, short_digest]
+        end
+        print_table(unexpected_table, borders: true)
+        say ""
+      end
+
+      if has_issues
+        say "To see detailed remediation commands, use:"
+        say "  equilibrium analyze --expected expected.json --actual actual.json --format=json | jq '.remediation_plan'"
+      else
+        say "✓ Registry is in perfect equilibrium!", :green
+      end
+    end
+
+    def print_tags_summary(output, type)
+      say "Repository: #{output["repository_name"]}"
+      say "URL: #{output["repository_url"]}"
+      say ""
+
+      mutable_tags = output["digests"]
+      canonical_versions = output["canonical_versions"]
+
+      say "#{type.capitalize} mutable tags (#{mutable_tags.size}):"
+      say ""
+
+      # Create table data: [["Tag", "Version", "Digest"]]
+      table_data = [["Tag", "Version", "Digest"]]
+      mutable_tags.keys.sort.each do |tag|
+        canonical_version = canonical_versions[tag]
+        digest = mutable_tags[tag]
+        table_data << [tag, canonical_version, digest]
+      end
+
+      print_table(table_data, borders: true)
+    end
+  end
+end

data/lib/equilibrium/tag_processor.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Equilibrium
+  class TagProcessor
+    def self.compute_virtual_tags(semantic_tags)
+      new.compute_virtual_tags(semantic_tags)
+    end
+
+    def compute_virtual_tags(semantic_tags)
+      return {"digests" => {}, "canonical_versions" => {}} if semantic_tags.empty?
+
+      latest_version = nil
+      major_versions = {}
+      minor_versions = {}
+
+      # Single pass to find all maximums
+      semantic_tags.keys.each do |version_str|
+        version = Gem::Version.new(version_str)
+
+        # Track overall latest
+        latest_version = version if !latest_version || version > latest_version
+
+        # Track latest for each major
+        major = version.segments[0]
+        major_versions[major] = version if !major_versions[major] || version > major_versions[major]
+
+        # Track latest for each minor
+        major_minor = "#{version.segments[0]}.#{version.segments[1]}"
+        minor_versions[major_minor] = version if !minor_versions[major_minor] || version > minor_versions[major_minor]
+      end
+
+      # Build result with both digest and canonical mappings
+      digests = {}
+      canonical_versions = {}
+
+      if latest_version
+        digests["latest"] = semantic_tags[latest_version.to_s]
+        canonical_versions["latest"] = latest_version.to_s
+      end
+
+      major_versions.each do |_, v|
+        tag = v.segments[0].to_s
+        digests[tag] = semantic_tags[v.to_s]
+        canonical_versions[tag] = v.to_s
+      end
+
+      minor_versions.each do |_, v|
+        tag = "#{v.segments[0]}.#{v.segments[1]}"
+        digests[tag] = semantic_tags[v.to_s]
+        canonical_versions[tag] = v.to_s
+      end
+
+      {"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
+    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
+    end
+
+    private
+
+    def semantic_version?(tag)
+      SemanticVersion.valid?(tag)
+    end
+
+    def mutable_tag?(tag)
+      tag.match?(/^latest$/) ||
+        tag.match?(/^[0-9]+$/) ||
+        tag.match?(/^[0-9]+\.[0-9]+$/)
+    end
+  end
+end

data/lib/equilibrium/version.rb

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

data/lib/equilibrium.rb

@@ -0,0 +1,13 @@
+# 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/catalog_builder"
+require_relative "equilibrium/analyzer"
+require_relative "equilibrium/schemas/expected_actual"
+
+module Equilibrium
+  class Error < StandardError; end
+end

data/tmp/.gitkeep

@@ -0,0 +1,2 @@
+# This file ensures the tmp/ directory is tracked by git
+# while keeping all other contents ignored via .gitignore

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification
+name: equilibrium
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tony Hsu
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-08-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Validates equilibrium between mutable tags and semantic version tags
+  in container registries
+email:
+- tonyc.t.hsu@gmail.com
+executables:
+- equilibrium
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".ruby-version"
+- CHANGELOG.md
+- LICENSE
+- README.md
+- Rakefile
+- equilibrium
+- exe/equilibrium
+- lib/equilibrium.rb
+- lib/equilibrium/analyzer.rb
+- lib/equilibrium/catalog_builder.rb
+- lib/equilibrium/cli.rb
+- lib/equilibrium/registry_client.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_processor.rb
+- lib/equilibrium/version.rb
+- tmp/.gitkeep
+homepage: https://github.com/TonyCTHsu/equilibrium
+licenses:
+- MIT
+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
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Container image tag validation tool
+test_files: []