git-lint 9.7.0 → 10.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cab224e2fd996c6b443392e3aa1b2eff4f138aa64b33ff47ee02c3bbf3f8f3b
-  data.tar.gz: 17b6e916f8bd625cfcdd8050512ae84d25aaefca086590d54b8a8c53c09bb0c7
+  metadata.gz: 98f3bcf679d8dac3f4ff32b0d9f569857088fbdcb60d8dd86162fd6ced3e8ffa
+  data.tar.gz: 3a553b6561394d438076fee08c548d45534137c23d1b51e2ae9b4a459b4629a9
 SHA512:
-  metadata.gz: 1e15c14df6fa4d8c5019126f5ee2949309938a8b5955647952f45bef624efaa60c80bec17d71edf8ce28827bbb96942c9e8d80665bcb4a35f86c3a1ba464c22d
-  data.tar.gz: e6ddd1ad8b09dda9235dede2fb61ded29fa9a06a7d9ed14b26aa5261924975525d16589e3efcb7ff9b6d026dbadb5e6d31e498863223e619844041648971df5e
+  metadata.gz: d522e26a6818717389e52cca02201862cf358175acaad9c2e52f90a5449cb3a9dda4caffdd5f3f5eaca696dd7259ea9536c8543078acc78d2784876c4bfba8a4
+  data.tar.gz: a0103d3d4d1c9ba81b3ab6e79cbdf69318e5e51d9bf224b02dde570d224308937d799a1aa869728dbe532cf3aefcea29768f538e8b32f7c2c68862ed73ee67f6

data/README.adoc

@@ -194,6 +194,9 @@ commits:
     includes:
       - Good
   subject:
+    duplicate:
+      enabled: true
+      severity: error
     length:
       enabled: true
       severity: error
@@ -624,6 +627,27 @@ Ensures all commit signatures are properly signed for improved security and vali
 
 All of the above obtained when using the pretty formats as provided by link:https://git-scm.com/docs/git-log#Documentation/git-log.txt-emGem[Git Log].
 
+==== Commit Subject Duplicate
+
+[options="header"]
+|===
+| Enabled | Severity
+| true    | error
+|===
+
+Ensures commit subjects are not duplicated so you can rebase and clean up accordingly. Example:
+
+....
+# Disallowed
+Added documentation
+Added documentation
+
+# Allowed
+Added documentation
+....
+
+Automatically ignores _amend!_, _fixup!_, or _squash!_ commit prefixes.
+
 ==== Commit Subject Length
 
 [options="header"]

data/git-lint.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "git-lint"
-  spec.version = "9.7.0"
+  spec.version = "10.0.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/git-lint"
@@ -22,20 +22,21 @@ Gem::Specification.new do |spec|
   spec.signing_key = Gem.default_key_path
   spec.cert_chain = [Gem.default_cert_path]
 
-  spec.required_ruby_version = ">= 3.4"
-  spec.add_dependency "cogger", "~> 1.0"
-  spec.add_dependency "containable", "~> 1.1"
-  spec.add_dependency "core", "~> 2.5"
+  spec.required_ruby_version = ">= 4.0"
+
+  spec.add_dependency "cogger", "~> 2.0"
+  spec.add_dependency "containable", "~> 2.0"
+  spec.add_dependency "core", "~> 3.0"
   spec.add_dependency "dry-monads", "~> 1.9"
-  spec.add_dependency "dry-schema", "~> 1.13"
-  spec.add_dependency "etcher", "~> 3.0"
-  spec.add_dependency "gitt", "~> 4.1"
-  spec.add_dependency "infusible", "~> 4.0"
-  spec.add_dependency "refinements", "~> 13.6"
-  spec.add_dependency "runcom", "~> 12.0"
-  spec.add_dependency "sod", "~> 1.5"
-  spec.add_dependency "spek", "~> 4.0"
-  spec.add_dependency "tone", "~> 2.0"
+  spec.add_dependency "dry-schema", "~> 1.14"
+  spec.add_dependency "etcher", "~> 4.0"
+  spec.add_dependency "gitt", "~> 5.0"
+  spec.add_dependency "infusible", "~> 5.0"
+  spec.add_dependency "refinements", "~> 14.0"
+  spec.add_dependency "runcom", "~> 13.0"
+  spec.add_dependency "sod", "~> 2.0"
+  spec.add_dependency "spek", "~> 5.0"
+  spec.add_dependency "tone", "~> 3.0"
   spec.add_dependency "zeitwerk", "~> 2.7"
 
   spec.bindir = "exe"

data/lib/git/lint/analyzer.rb

@@ -1,94 +1,33 @@
 # frozen_string_literal: true
 
+require "core"
+
 module Git
   module Lint
     # Runs all analyzers.
     class Analyzer
-      include Dependencies[:settings]
+      include Dependencies[:collector]
 
-      ANALYZERS = [
-        Analyzers::CommitAuthorCapitalization,
-        Analyzers::CommitAuthorEmail,
-        Analyzers::CommitAuthorName,
-        Analyzers::CommitBodyBulletCapitalization,
-        Analyzers::CommitBodyBulletDelimiter,
-        Analyzers::CommitBodyBulletOnly,
-        Analyzers::CommitBodyLeadingLine,
-        Analyzers::CommitBodyLineLength,
-        Analyzers::CommitBodyParagraphCapitalization,
-        Analyzers::CommitBodyPhrase,
-        Analyzers::CommitBodyPresence,
-        Analyzers::CommitBodyTrackerShorthand,
-        Analyzers::CommitBodyWordRepeat,
-        Analyzers::CommitSignature,
-        Analyzers::CommitSubjectLength,
-        Analyzers::CommitSubjectPrefix,
-        Analyzers::CommitSubjectSuffix,
-        Analyzers::CommitSubjectWordRepeat,
-        Analyzers::CommitTrailerCollaboratorCapitalization,
-        Analyzers::CommitTrailerCollaboratorEmail,
-        Analyzers::CommitTrailerCollaboratorKey,
-        Analyzers::CommitTrailerCollaboratorName,
-        Analyzers::CommitTrailerDuplicate,
-        Analyzers::CommitTrailerFormatKey,
-        Analyzers::CommitTrailerFormatValue,
-        Analyzers::CommitTrailerIssueKey,
-        Analyzers::CommitTrailerIssueValue,
-        Analyzers::CommitTrailerMilestoneKey,
-        Analyzers::CommitTrailerMilestoneValue,
-        Analyzers::CommitTrailerOrder,
-        Analyzers::CommitTrailerReviewerKey,
-        Analyzers::CommitTrailerReviewerValue,
-        Analyzers::CommitTrailerSignerCapitalization,
-        Analyzers::CommitTrailerSignerEmail,
-        Analyzers::CommitTrailerSignerKey,
-        Analyzers::CommitTrailerSignerName,
-        Analyzers::CommitTrailerTrackerKey,
-        Analyzers::CommitTrailerTrackerValue
-      ].freeze
+      DELEGATES = [Analyzers::Commits::Sole, Analyzers::Commits::Many].freeze
 
-      # rubocop:disable Metrics/ParameterLists
-      def initialize(
-        analyzers: ANALYZERS,
-        collector: Collector.new,
-        reporter: Reporters::Branch,
-        **
-      )
+      def initialize(reporter: Reporters::Branch, delegates: DELEGATES, **)
         super(**)
-        @analyzers = analyzers
-        @collector = collector
         @reporter = reporter
+        @delegates = delegates
       end
-      # rubocop:enable Metrics/ParameterLists
 
-      def call commits: Commits::Loader.new.call
+      def call commits = Core::EMPTY_ARRAY
         process commits
-        a_reporter = reporter.new(collector:)
-        block_given? ? yield(collector, a_reporter) : [collector, a_reporter]
+        reporter.new total: collector.total
       end
 
       private
 
-      attr_reader :analyzers, :collector, :reporter
+      attr_reader :reporter, :delegates
 
       def process commits
         collector.clear
-        commits.value_or([]).map { |commit| analyze commit }
-      end
-
-      def analyze(commit) = enabled.map { |id| collector.add load_analyzer(commit, id) }
-
-      # :reek:FeatureEnvy
-      def enabled
-        settings.to_h
-                .select { |key, value| key.end_with?("enabled") && value == true }
-                .keys
-                .map { |key| key.to_s.sub("commits_", "commit_").delete_suffix! "_enabled" }
-      end
-
-      def load_analyzer commit, id
-        analyzers.find { |analyzer| analyzer.id == id }
-                 .then { |analyzer| analyzer.new commit }
+        delegates.each { |delegate| delegate.new.call commits }
       end
     end
   end

data/lib/git/lint/analyzers/commit_body_bullet_delimiter.rb

@@ -22,7 +22,9 @@ module Git
           Kit::FilterList.new settings.commits_body_bullet_delimiter_includes
         end
 
-        def invalid_line?(line) = line.match?(/\A\s*#{pattern}(?!(#{pattern}|\s)).+\Z/)
+        def invalid_line? line
+          line.match?(/\A\s*#{pattern}(?!(#{pattern}|\s))(?!.+#{pattern}$).+\Z/)
+        end
 
         def pattern = Regexp.union filter_list
       end

data/lib/git/lint/analyzers/commits/many.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require "core"
+
+module Git
+  module Lint
+    module Analyzers
+      module Commits
+        # Runs all analyzers for a single commit only.
+        class Many
+          include Dependencies[:settings, :collector]
+
+          ANALYZERS = [Analyzers::Commits::Subjects::Duplicate].freeze
+
+          def initialize(analyzers: ANALYZERS, **)
+            super(**)
+            @analyzers = analyzers
+          end
+
+          def call commits = Core::EMPTY_ARRAY
+            analyzers.select { |analyzer| settings.public_send :"#{analyzer.id}_enabled" }
+                     .each { |analyzer| collector.add analyzer.new(commits) }
+
+            collector
+          end
+
+          private
+
+          attr_reader :analyzers
+        end
+      end
+    end
+  end
+end

data/lib/git/lint/analyzers/commits/sole.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require "core"
+
+module Git
+  module Lint
+    module Analyzers
+      module Commits
+        # Runs all analyzers for a single commit only.
+        class Sole
+          include Dependencies[:settings, :collector]
+
+          ANALYZERS = [
+            Analyzers::CommitAuthorCapitalization,
+            Analyzers::CommitAuthorEmail,
+            Analyzers::CommitAuthorName,
+            Analyzers::CommitBodyBulletCapitalization,
+            Analyzers::CommitBodyBulletDelimiter,
+            Analyzers::CommitBodyBulletOnly,
+            Analyzers::CommitBodyLeadingLine,
+            Analyzers::CommitBodyLineLength,
+            Analyzers::CommitBodyParagraphCapitalization,
+            Analyzers::CommitBodyPhrase,
+            Analyzers::CommitBodyPresence,
+            Analyzers::CommitBodyTrackerShorthand,
+            Analyzers::CommitBodyWordRepeat,
+            Analyzers::CommitSignature,
+            Analyzers::CommitSubjectLength,
+            Analyzers::CommitSubjectPrefix,
+            Analyzers::CommitSubjectSuffix,
+            Analyzers::CommitSubjectWordRepeat,
+            Analyzers::CommitTrailerCollaboratorCapitalization,
+            Analyzers::CommitTrailerCollaboratorEmail,
+            Analyzers::CommitTrailerCollaboratorKey,
+            Analyzers::CommitTrailerCollaboratorName,
+            Analyzers::CommitTrailerDuplicate,
+            Analyzers::CommitTrailerFormatKey,
+            Analyzers::CommitTrailerFormatValue,
+            Analyzers::CommitTrailerIssueKey,
+            Analyzers::CommitTrailerIssueValue,
+            Analyzers::CommitTrailerMilestoneKey,
+            Analyzers::CommitTrailerMilestoneValue,
+            Analyzers::CommitTrailerOrder,
+            Analyzers::CommitTrailerReviewerKey,
+            Analyzers::CommitTrailerReviewerValue,
+            Analyzers::CommitTrailerSignerCapitalization,
+            Analyzers::CommitTrailerSignerEmail,
+            Analyzers::CommitTrailerSignerKey,
+            Analyzers::CommitTrailerSignerName,
+            Analyzers::CommitTrailerTrackerKey,
+            Analyzers::CommitTrailerTrackerValue
+          ].freeze
+
+          def initialize(analyzers: ANALYZERS, **)
+            super(**)
+            @analyzers = analyzers
+          end
+
+          def call commits = Core::EMPTY_ARRAY
+            commits.each { |commit| select commit }
+            collector
+          end
+
+          private
+
+          attr_reader :analyzers
+
+          def select commit
+            settings.to_h
+                    .select { |key, value| key.end_with?("enabled") && value == true }
+                    .each_key do |key|
+                      id = key.to_s.sub("commits_", "commit_").delete_suffix! "_enabled"
+                      add commit, id
+                    end
+          end
+
+          def add commit, id
+            analyzers.find { |analyzer| analyzer.id == id }
+                     .then { |analyzer| collector.add analyzer.new(commit) if analyzer }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/git/lint/analyzers/commits/subjects/duplicate.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "refinements/array"
+
+module Git
+  module Lint
+    module Analyzers
+      module Commits
+        module Subjects
+          # Analyzes and detects duplicate subjects.
+          class Duplicate < Abstract
+            using Refinements::Array
+
+            def self.id = "commits_subject_duplicate"
+
+            def self.label = "Commit Subject Duplicate"
+
+            def initialize(commits, **)
+              super(nil, **)
+              @commits = commits
+            end
+
+            def valid? = normals.map(&:subject).tally.all? { |_subject, total| total == 1 }
+
+            def issue
+              return {} if valid?
+
+              {
+                hint: "Use unique subjects.",
+                references: normals.map { |commit| "#{commit.sha} #{commit.subject}" }
+              }
+            end
+
+            private
+
+            attr_reader :commits
+
+            def normals = commits.reject(&:directive?)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/git/lint/cli/actions/analyze/branch.rb

@@ -15,26 +15,27 @@ module Git
 
             on %w[-b --branch]
 
-            def initialize(analyzer: Analyzer.new, **)
+            def initialize(analyzer: Analyzer.new, loader: Git::Lint::Commits::Loader.new, **)
               super(**)
               @analyzer = analyzer
+              @loader = loader
             end
 
             def call(*)
-              parse
+              report
             rescue Errors::Base => error
-              logger.error { error.message }
-              kernel.abort
+              logger.abort error.message
             end
 
             private
 
-            attr_reader :analyzer
+            attr_reader :analyzer, :loader
 
-            def parse
-              analyzer.call do |collector, reporter|
+            def report
+              loader.call.bind do |commits|
+                reporter = analyzer.call commits
                 io.puts reporter
-                kernel.abort if collector.errors?
+                kernel.abort if reporter.errors?
               end
             end
           end

data/lib/git/lint/cli/actions/analyze/commit.rb

@@ -21,21 +21,25 @@ module Git
             end
 
             def call *arguments
-              process arguments.unshift "-1"
+              collect arguments.unshift("-1")
             rescue Errors::Base => error
-              logger.error { error.message }
-              kernel.abort
+              logger.abort error.message
             end
 
             private
 
             attr_reader :analyzer
 
-            def process arguments
-              analyzer.call commits: git.commits(*arguments) do |collector, reporter|
-                io.puts reporter
-                kernel.abort if collector.errors?
-              end
+            def collect arguments
+              git.commits(*arguments).either -> commits { report commits },
+                                             -> message { logger.abort message.chomp }
+            end
+
+            def report commits
+              reporter = analyzer.call commits
+
+              io.puts reporter
+              kernel.abort if reporter.errors?
             end
           end
         end

data/lib/git/lint/cli/actions/hook.rb

@@ -21,17 +21,17 @@ module Git
           end
 
           def call path
-            analyzer.call commits: commits(path) do |collector, reporter|
-              io.puts reporter
-              kernel.abort if collector.errors?
-            end
+            reporter = analyzer.call read(path)
+
+            io.puts reporter
+            kernel.abort if reporter.errors?
           end
 
           private
 
           attr_reader :analyzer
 
-          def commits(path) = git.uncommitted(path).fmap { |commit| [commit] }
+          def read(path) = git.uncommitted(path).bind { |commit| [commit] }
         end
       end
     end

data/lib/git/lint/collector.rb

@@ -4,7 +4,8 @@ module Git
   module Lint
     # Collects and categorizes, by severity, all issues (if any).
     class Collector
-      def initialize
+      def initialize model: Models::Total
+        @model = model
         @collection = Hash.new { |default, missing_id| default[missing_id] = [] }
       end
 
@@ -13,31 +14,28 @@ module Git
         analyzer
       end
 
+      def total
+        values = collection.values.flatten
+
+        model[
+          items: collection.keys.compact.size,
+          issues: values.count(&:invalid?),
+          warnings: values.count(&:warning?),
+          errors: values.count(&:error?)
+        ]
+      end
+
       def retrieve(id) = collection[id]
 
       def clear = collection.clear && self
 
       def empty? = collection.empty?
 
-      def warnings? = collection.values.flatten.any?(&:warning?)
-
-      def errors? = collection.values.flatten.any?(&:error?)
-
-      def issues? = collection.values.flatten.any?(&:invalid?)
-
-      def total_warnings = collection.values.flatten.count(&:warning?)
-
-      def total_errors = collection.values.flatten.count(&:error?)
-
-      def total_issues = collection.values.flatten.count(&:invalid?)
-
-      def total_commits = collection.keys.size
-
       def to_h = collection
 
       private
 
-      attr_reader :collection
+      attr_reader :model, :collection
     end
   end
 end

data/lib/git/lint/configuration/contract.rb

@@ -46,6 +46,8 @@ module Git
         required(:commits_signature_enabled).filled :bool
         required(:commits_signature_severity).filled :string
         required(:commits_signature_includes).array :string
+        required(:commits_subject_duplicate_enabled).filled :bool
+        required(:commits_subject_duplicate_severity).filled :string
         required(:commits_subject_length_enabled).filled :bool
         required(:commits_subject_length_severity).filled :string
         required(:commits_subject_length_maximum).filled :integer

data/lib/git/lint/configuration/defaults.yml

@@ -91,6 +91,9 @@ commits:
     includes:
       - Good
   subject:
+    duplicate:
+      enabled: true
+      severity: error
     length:
       enabled: true
       severity: error

data/lib/git/lint/configuration/model.rb

@@ -41,6 +41,8 @@ module Git
                          :commits_signature_enabled,
                          :commits_signature_severity,
                          :commits_signature_includes,
+                         :commits_subject_duplicate_enabled,
+                         :commits_subject_duplicate_severity,
                          :commits_subject_length_enabled,
                          :commits_subject_length_severity,
                          :commits_subject_length_maximum,

data/lib/git/lint/container.rb

@@ -75,6 +75,7 @@ module Git
       register(:settings) { Etcher.call(self[:registry]).dup }
       register(:defaults_path) { Pathname(__dir__).join("configuration/defaults.yml") }
       register(:specification) { Spek::Loader.call "#{__dir__}/../../../git-lint.gemspec" }
+      register(:collector) { Collector.new }
       register(:color) { Tone.new }
       register :environment, ENV
       register(:git) { Gitt::Repository.new }

data/lib/git/lint/models/total.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Git
+  module Lint
+    module Models
+      # Models totals for reporting purposes.
+      Total = Data.define :items, :issues, :warnings, :errors do
+        def initialize items: 0, issues: 0, warnings: 0, errors: 0
+          super
+        end
+
+        def empty? = items.zero?
+
+        def issues? = issues.positive?
+
+        def warnings? = warnings.positive?
+
+        def errors? = errors.positive?
+      end
+    end
+  end
+end

data/lib/git/lint/reporters/branch.rb

@@ -1,17 +1,26 @@
 # frozen_string_literal: true
 
+require "forwardable"
+
 module Git
   module Lint
     module Reporters
       # Reports issues related to a single branch.
       class Branch
-        include Dependencies[:color]
+        extend Forwardable
+
+        include Dependencies[:collector, :color]
 
         using Refinements::String
 
-        def initialize(collector: Collector.new, **)
+        DELEGATES = {individual: Individual, group: Group}.freeze
+
+        delegate %i[empty? issues? warnings? errors?] => :total
+
+        def initialize(total: Models::Total.new, delegates: DELEGATES, **)
           super(**)
-          @collector = collector
+          @total = total
+          @delegates = delegates
         end
 
         def to_s
@@ -23,27 +32,35 @@ module Git
 
         private
 
-        attr_reader :collector
+        attr_reader :total, :delegates
 
         def branch_report
-          return "" unless collector.issues?
+          return "" unless total.issues?
 
           "\n\n#{commit_report}".chomp
         end
 
         def commit_report
-          collector.to_h.reduce "" do |details, (commit, analyzers)|
-            details + Commit.new(commit:, analyzers:)
+          collector.to_h.reduce "" do |details, (reference, analyzers)|
+            if reference
+              details + individual.new(reference, analyzers:)
+            else
+              details + group_by(analyzers)
+            end
           end
         end
 
+        def group_by analyzers
+          analyzers.reduce(+"") { |text, analyzer| text << group.new(analyzer) }
+        end
+
         def commit_total
-          total = collector.total_commits
-          %(#{total} #{"commit".pluralize "s", total} inspected)
+          commits = total.items
+          %(#{commits} #{"commit".pluralize "s", commits} inspected)
         end
 
         def issue_totals
-          if collector.issues?
+          if total.issues?
             "#{issue_total} detected (#{warning_total}, #{error_total})"
           else
             color["0 issues", :green] + " detected"
@@ -51,22 +68,26 @@ module Git
         end
 
         def issue_total
-          style = collector.errors? ? :red : :yellow
-          total = collector.total_issues
-          color["#{total} issue".pluralize("s", total), style]
+          style = total.errors? ? :red : :yellow
+          issues = total.issues
+          color["#{issues} issue".pluralize("s", issues), style]
         end
 
         def warning_total
-          style = collector.warnings? ? :yellow : :green
-          total = collector.total_warnings
-          color["#{total} warning".pluralize("s", total), style]
+          style = total.warnings? ? :yellow : :green
+          warnings = total.warnings
+          color["#{warnings} warning".pluralize("s", warnings), style]
         end
 
         def error_total
-          style = collector.errors? ? :red : :green
-          total = collector.total_errors
-          color["#{total} error".pluralize("s", total), style]
+          style = total.errors? ? :red : :green
+          errors = total.errors
+          color["#{errors} error".pluralize("s", errors), style]
         end
+
+        def individual = delegates.fetch __method__
+
+        def group = delegates.fetch __method__
       end
     end
   end

data/lib/git/lint/reporters/group.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "core"
+
+module Git
+  module Lint
+    module Reporters
+      # Reports issue for a group of references.
+      class Group
+        include Dependencies[:color]
+
+        def initialize(analyzer, **)
+          super(**)
+          @analyzer = analyzer
+          @issue = analyzer.issue
+        end
+
+        def to_s
+          return Core::EMPTY_STRING if issue.empty?
+
+          color[message, style]
+        end
+
+        alias to_str to_s
+
+        private
+
+        attr_reader :analyzer, :issue
+
+        def message
+          "#{analyzer.class.label}#{severity_suffix}. #{issue.fetch :hint}\n" \
+          "#{affected_references}"
+        end
+
+        def severity_suffix
+          case analyzer.severity
+            when "warn" then " Warning"
+            when "error" then " Error"
+            else ""
+          end
+        end
+
+        def style
+          case analyzer.severity
+            when "warn" then :yellow
+            when "error" then :red
+            else :white
+          end
+        end
+
+        def affected_references
+          issue.fetch(:references, Core::EMPTY_ARRAY)
+               .map { |sha| "  #{sha}" }
+               .join "\n"
+        end
+      end
+    end
+  end
+end

data/lib/git/lint/reporters/{commit.rb → individual.rb}

@@ -3,25 +3,25 @@
 module Git
   module Lint
     module Reporters
-      # Reports issues related to a single commit.
-      class Commit
-        def initialize commit:, analyzers: []
-          @commit = commit
+      # Reports issues related to a single reference.
+      class Individual
+        def initialize reference, analyzers: []
+          @reference = reference
           @analyzers = analyzers.select(&:invalid?)
         end
 
         def to_s
           return "" if analyzers.empty?
 
-          "#{commit.sha} (#{commit.author_name}, #{commit.authored_relative_at}): " \
-          "#{commit.subject}\n#{report}\n"
+          "#{reference.sha} (#{reference.author_name}, #{reference.authored_relative_at}): " \
+          "#{reference.subject}\n#{report}\n"
         end
 
         alias to_str to_s
 
         private
 
-        attr_reader :commit, :analyzers
+        attr_reader :reference, :analyzers
 
         def report = analyzers.reduce("") { |report, analyzer| report + Style.new(analyzer) }
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git-lint
 version: !ruby/object:Gem::Version
-  version: 9.7.0
+  version: 10.0.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -41,42 +41,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: containable
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: dry-monads
   requirement: !ruby/object:Gem::Requirement
@@ -97,126 +97,126 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
+        version: '1.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
+        version: '1.14'
 - !ruby/object:Gem::Dependency
   name: etcher
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: gitt
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.1'
+        version: '5.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.1'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: infusible
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: refinements
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.6'
+        version: '14.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.6'
+        version: '14.0'
 - !ruby/object:Gem::Dependency
   name: runcom
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: sod
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: spek
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: tone
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -285,6 +285,9 @@ files:
 - lib/git/lint/analyzers/commit_trailer_signer_name.rb
 - lib/git/lint/analyzers/commit_trailer_tracker_key.rb
 - lib/git/lint/analyzers/commit_trailer_tracker_value.rb
+- lib/git/lint/analyzers/commits/many.rb
+- lib/git/lint/analyzers/commits/sole.rb
+- lib/git/lint/analyzers/commits/subjects/duplicate.rb
 - lib/git/lint/cli/actions/analyze/branch.rb
 - lib/git/lint/cli/actions/analyze/commit.rb
 - lib/git/lint/cli/actions/hook.rb
@@ -305,9 +308,11 @@ files:
 - lib/git/lint/errors/severity.rb
 - lib/git/lint/errors/sha.rb
 - lib/git/lint/kit/filter_list.rb
+- lib/git/lint/models/total.rb
 - lib/git/lint/rake/register.rb
 - lib/git/lint/reporters/branch.rb
-- lib/git/lint/reporters/commit.rb
+- lib/git/lint/reporters/group.rb
+- lib/git/lint/reporters/individual.rb
 - lib/git/lint/reporters/line.rb
 - lib/git/lint/reporters/lines/paragraph.rb
 - lib/git/lint/reporters/lines/sentence.rb
@@ -334,14 +339,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.4'
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: A command line interface for linting Git commits.
 test_files: []