sds/overcommit · error · Overcommit::Exceptions::ConfigurationError

One or more hooks had invalid `processor` value configured

Error message

One or more hooks had invalid `processor` value configured

What it means

Error "One or more hooks had invalid `processor` value configured" thrown in sds/overcommit.

Source

Thrown at lib/overcommit/configuration_validator.rb:167

      errors = []
      Overcommit::Utils.supported_hook_type_classes.each do |hook_type|
        hash.fetch(hook_type) { {} }.each do |hook_name, hook_config|
          processors = hook_config.fetch('processors') { 1 }
          if processors > concurrency
            errors << "#{hook_type}::#{hook_name} `processors` value " \
                      "(#{processors}) is larger than the global `concurrency` " \
                      "option (#{concurrency})"
          end
        end
      end

      if errors.any?
        if @log
          @log.error errors.join("\n")
          @log.newline
        end
        raise Overcommit::Exceptions::ConfigurationError,
              'One or more hooks had invalid `processor` value configured'
      end
    end

    # Prints a warning if the `verify_plugin_signatures` option is used instead
    # of the new `verify_signatures` option.
    def check_for_verify_plugin_signatures_option(hash)
      return unless @log

      if hash.key?('verify_plugin_signatures')
        @log.warning '`verify_plugin_signatures` has been renamed to ' \
                     '`verify_signatures`. Defaulting to verifying signatures.'
        @log.warning "See change log at #{REPO_URL}/blob/v0.29.0/CHANGELOG.md for details."
        @log.newline
      end
    end
  end
end

View on GitHub (pinned to fee0cd74b2)

Solutions

1. Lower the hook's `processors` value in .overcommit.yml so it does not exceed the global `concurrency` setting, or raise `concurrency`.
2. Check the error lines printed above the message; they name each hook whose `processors` value is too large.
3. Remove the `processors` option to use the default of 1.

When it happens

Trigger: Thrown at lib/overcommit/configuration_validator.rb:167 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of sds/overcommit@fee0cd74b2 (2026-08-23). Data as JSON: /api/errors/0f067d1771295eda. Report an issue: GitHub.