inquirex-tools 0.8.0 → 0.9.4

data/lib/inquirex/tools/commands/versions.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module Inquirex
-  module Tools
-    module Commands
-      # Reports and enforces version parity across the lockstep packages.
-      #
-      # Plural on purpose: `inquirex version` prints this tool's own version,
-      # `inquirex versions` manages the family's.
-      class Versions < Dry::CLI::Command
-        desc "Check, set, or preflight the family's lockstep version"
-
-        option :set, type: :string, desc: "Move every lockstep package to this version"
-        option :preflight, type: :boolean, default: false,
-                           desc: "Also check clean trees, main branch, and tags"
-
-        example [
-          "                      # report parity, exit 1 on drift",
-          "--set 0.8.0           # move all five packages",
-          "--preflight           # release readiness"
-        ]
-
-        # @param set [String, nil] target version
-        # @param preflight [Boolean]
-        # @return [void]
-        def call(set: nil, preflight: false, **)
-          versions = Inquirex::Tools::Versions.new
-          ok =
-            if set then versions.set(set)
-            elsif preflight then versions.preflight
-            else versions.check
-            end
-          exit(1) unless ok
-        rescue Inquirex::Tools::Error => e
-          warn "ERROR: #{e.message}"
-          exit 1
-        end
-      end
-    end
-  end
-end

data/lib/inquirex/tools/versions.rb

@@ -1,125 +0,0 @@
-# frozen_string_literal: true
-
-require "rubygems/version"
-require_relative "workspace"
-
-module Inquirex
-  module Tools
-    # Reports and enforces version parity across the lockstep packages.
-    #
-    # @example Check for drift
-    #   Inquirex::Tools::Versions.new.check   # => false when versions differ
-    class Versions
-      # @param workspace [Workspace]
-      # @param out [IO] where report output goes
-      def initialize(workspace: Workspace.new, out: $stdout)
-        @workspace = workspace
-        @out = out
-      end
-
-      # Prints the current state of every lockstep package.
-      #
-      # @return [Boolean] true when all packages agree on one version
-      def check
-        versions = @workspace.versions
-        print_table(versions)
-        verdict(versions)
-      end
-
-      # Moves every lockstep package to one version.
-      #
-      # Refuses to move backwards: a version already published cannot be
-      # reissued, so the target must exceed every current value.
-      #
-      # @param version [String] target, MAJOR.MINOR.PATCH
-      # @return [Boolean] true when written
-      def set(version)
-        unless /\A\d+\.\d+\.\d+\z/.match?(version.to_s)
-          @out.puts "ERROR: #{version.inspect} is not MAJOR.MINOR.PATCH"
-          return false
-        end
-
-        current = @workspace.versions.values.compact
-        highest = current.max_by { Gem::Version.new(_1) }
-        if highest && Gem::Version.new(highest) > Gem::Version.new(version)
-          @out.puts "ERROR: #{version} is below the highest existing version (#{highest}) — versions only go forward"
-          return false
-        end
-
-        @out.puts "Setting all lockstep packages to #{version}:"
-        @workspace.versions.each do |name, was|
-          @workspace.write_version(name, version)
-          @out.puts format("  %-16s %s -> %s", name, was || "?", version)
-        end
-        @out.puts
-        @out.puts "Unchanged (excluded): #{Workspace::EXCLUDED.join(", ")}"
-        true
-      end
-
-      # Parity plus git readiness: clean tree, on main, tagged at the version.
-      #
-      # @return [Boolean] true when every package could be published now
-      def preflight
-        ok = check
-        target = @workspace.versions.values.compact.uniq.first
-        @out.puts
-        @out.puts "Release readiness:"
-
-        Workspace::LOCKSTEP.each_key do |name|
-          problems = readiness_problems(name, target)
-          @out.puts format("  %<name>-16s %<state>s", name: name, state: problems.empty? ? "ready" : problems.join(", "))
-          ok &&= problems.empty?
-        end
-
-        @out.puts
-        @out.puts ok ? "ALL READY — publish with `gem push` / `npm publish`" : "NOT READY — resolve the above"
-        ok
-      end
-
-      private
-
-      # @param versions [Hash{String => String, nil}]
-      # @return [void]
-      def print_table(versions)
-        @out.puts "Lockstep packages (#{Workspace::EXCLUDED.join(", ")} excluded by design):"
-        versions.each do |name, version|
-          @out.puts format("  %<name>-16s %<kind>-4s %<version>s",
-                           name: name, kind: Workspace::LOCKSTEP[name], version: version || "MISSING")
-        end
-        @out.puts
-      end
-
-      # @param versions [Hash{String => String, nil}]
-      # @return [Boolean] true when every package agrees on one version
-      def verdict(versions)
-        distinct = versions.values.compact.uniq
-        if versions.value?(nil)
-          @out.puts "DRIFT: a version could not be read (MISSING above)"
-          false
-        elsif distinct.one?
-          @out.puts "OK: all #{versions.size} at #{distinct.first}"
-          true
-        else
-          @out.puts "DRIFT: #{distinct.sort.join(", ")} — run `inquirex versions --set <version>`"
-          false
-        end
-      end
-
-      # Why a package is not publishable right now.
-      #
-      # @param name [String] package name
-      # @param target [String, nil] the version its tag must match
-      # @return [Array<String>] empty when ready
-      def readiness_problems(name, target)
-        state = @workspace.git_state(name)
-        return [ "no git checkout" ] if state[:clean].nil?
-
-        problems = []
-        problems << "DIRTY" unless state[:clean]
-        problems << "on #{state[:branch]}" unless state[:branch] == "main"
-        problems << "untagged" unless state[:tags].any? { |tag| tag.delete_prefix("v") == target }
-        problems
-      end
-    end
-  end
-end