danger-packwerk 0.8.0 → 0.9.0

data/sorbet/rbi/gems/{packwerk@2.2.1.rbi → packwerk@2.2.1-7e8e7a50705833b41fe40c201eadb85ff9a1a422.rbi}

@@ -4,19 +4,25 @@
 # This is an autogenerated file for types exported from the `packwerk` gem.
 # Please instead update this file by running `bin/tapioca gem packwerk`.
 
+# source://packwerk//lib/packwerk.rb#13
 module Packwerk
   extend ::ActiveSupport::Autoload
 end
 
 # Extracts the load paths from the analyzed application so that we can map constant names to paths.
+#
+# source://packwerk//lib/packwerk/application_load_paths.rb#8
 module Packwerk::ApplicationLoadPaths
   class << self
+    # source://packwerk//lib/packwerk/application_load_paths.rb#22
     sig { returns(T::Hash[::String, ::Module]) }
     def extract_application_autoload_paths; end
 
+    # source://packwerk//lib/packwerk/application_load_paths.rb#13
     sig { params(root: ::String, environment: ::String).returns(T::Hash[::String, ::Module]) }
     def extract_relevant_paths(root, environment); end
 
+    # source://packwerk//lib/packwerk/application_load_paths.rb#32
     sig do
       params(
         all_paths: T::Hash[::String, ::Module],
@@ -26,6 +32,7 @@ module Packwerk::ApplicationLoadPaths
     end
     def filter_relevant_paths(all_paths, bundle_path: T.unsafe(nil), rails_root: T.unsafe(nil)); end
 
+    # source://packwerk//lib/packwerk/application_load_paths.rb#43
     sig do
       params(
         load_paths: T::Hash[::Pathname, ::Module],
@@ -36,9 +43,11 @@ module Packwerk::ApplicationLoadPaths
 
     private
 
+    # source://packwerk//lib/packwerk/application_load_paths.rb#63
     sig { params(paths: T::Hash[T.untyped, ::Module]).void }
     def assert_load_paths_present(paths); end
 
+    # source://packwerk//lib/packwerk/application_load_paths.rb#50
     sig { params(root: ::String, environment: ::String).void }
     def require_application(root, environment); end
   end
@@ -46,113 +55,84 @@ end
 
 # Checks the structure of the application and its packwerk configuration to make sure we can run a check and deliver
 # correct results.
+#
+# source://packwerk//lib/packwerk/application_validator.rb#11
 class Packwerk::ApplicationValidator
-  sig { params(config_file_path: ::String, configuration: ::Packwerk::Configuration, environment: ::String).void }
-  def initialize(config_file_path:, configuration:, environment:); end
-
-  sig { returns(::Packwerk::ApplicationValidator::Result) }
-  def check_acyclic_graph; end
-
-  sig { returns(::Packwerk::ApplicationValidator::Result) }
-  def check_all; end
-
-  sig { returns(::Packwerk::ApplicationValidator::Result) }
-  def check_application_structure; end
-
-  sig { returns(::Packwerk::ApplicationValidator::Result) }
-  def check_package_manifest_paths; end
-
-  sig { returns(::Packwerk::ApplicationValidator::Result) }
-  def check_package_manifest_syntax; end
-
-  sig { returns(::Packwerk::ApplicationValidator::Result) }
-  def check_package_manifests_for_privacy; end
-
-  sig { returns(::Packwerk::ApplicationValidator::Result) }
-  def check_root_package_exists; end
-
-  sig { returns(::Packwerk::ApplicationValidator::Result) }
-  def check_valid_package_dependencies; end
-
-  private
+  include ::Packwerk::Validator
+  extend ::ActiveSupport::Autoload
 
+  # source://packwerk//lib/packwerk/application_validator.rb#22
   sig do
-    params(
-      constants: T.untyped,
-      config_file_path: ::String
-    ).returns(T::Array[::Packwerk::ApplicationValidator::Result])
+    override
+      .params(
+        package_set: Packwerk::PackageSet,
+        configuration: ::Packwerk::Configuration
+      ).returns(::Packwerk::ApplicationValidator::Result)
   end
-  def assert_constants_can_be_loaded(constants, config_file_path); end
-
-  # Convert the cycles:
-  #
-  #   [[a, b, c], [b, c]]
-  #
-  # to the string:
-  #
-  #   ["a -> b -> c -> a", "b -> c -> b"]
-  sig { params(cycles: T.untyped).returns(T::Array[::String]) }
-  def build_cycle_strings(cycles); end
+  def call(package_set, configuration); end
 
+  # source://packwerk//lib/packwerk/application_validator.rb#16
   sig do
     params(
-      name: T.untyped,
-      location: T.untyped,
-      config_file_path: T.untyped
+      package_set: Packwerk::PackageSet,
+      configuration: ::Packwerk::Configuration
     ).returns(::Packwerk::ApplicationValidator::Result)
   end
-  def check_private_constant_location(name, location, config_file_path); end
+  def check_all(package_set, configuration); end
 
-  sig { params(list: T.untyped).returns(T.untyped) }
-  def format_yaml_strings(list); end
+  # source://packwerk//lib/packwerk/application_validator.rb#69
+  sig { params(configuration: ::Packwerk::Configuration).returns(::Packwerk::ApplicationValidator::Result) }
+  def check_application_structure(configuration); end
 
-  sig { params(path: T.untyped).returns(T::Boolean) }
-  def invalid_package_path?(path); end
+  # source://packwerk//lib/packwerk/application_validator.rb#84
+  sig { params(configuration: ::Packwerk::Configuration).returns(::Packwerk::ApplicationValidator::Result) }
+  def check_package_manifest_paths(configuration); end
 
-  sig do
-    params(
-      results: T::Array[::Packwerk::ApplicationValidator::Result],
-      separator: ::String,
-      errors_headline: ::String
-    ).returns(::Packwerk::ApplicationValidator::Result)
-  end
-  def merge_results(results, separator: T.unsafe(nil), errors_headline: T.unsafe(nil)); end
-
-  sig { returns(T.any(::String, T::Array[::String])) }
-  def package_glob; end
+  # source://packwerk//lib/packwerk/application_validator.rb#41
+  sig { params(configuration: ::Packwerk::Configuration).returns(::Packwerk::ApplicationValidator::Result) }
+  def check_package_manifest_syntax(configuration); end
 
-  sig { params(glob_pattern: T.any(::String, T::Array[::String])).returns(T::Array[::String]) }
-  def package_manifests(glob_pattern = T.unsafe(nil)); end
+  # source://packwerk//lib/packwerk/application_validator.rb#105
+  sig { params(configuration: ::Packwerk::Configuration).returns(::Packwerk::ApplicationValidator::Result) }
+  def check_root_package_exists(configuration); end
 
-  sig { params(setting: T.untyped).returns(T.untyped) }
-  def package_manifests_settings_for(setting); end
+  # source://packwerk//lib/packwerk/application_validator.rb#34
+  sig { override.returns(T::Array[::String]) }
+  def permitted_keys; end
 
-  sig { params(name: T.untyped, config_file_path: T.untyped).returns(::Packwerk::ApplicationValidator::Result) }
-  def private_constant_unresolvable(name, config_file_path); end
+  private
 
-  sig { params(path: ::String).returns(::Pathname) }
-  def relative_path(path); end
+  # source://packwerk//lib/packwerk/application_validator.rb#124
+  sig { params(list: T.untyped).returns(T.untyped) }
+  def format_yaml_strings(list); end
 
-  sig { params(paths: T::Array[::String]).returns(T::Array[::Pathname]) }
-  def relative_paths(paths); end
+  # source://packwerk//lib/packwerk/application_validator.rb#129
+  sig { params(configuration: ::Packwerk::Configuration, paths: T::Array[::String]).returns(T::Array[::Pathname]) }
+  def relative_paths(configuration, paths); end
 end
 
+# source://packwerk//lib/packwerk/application_validator/result.rb#6
 class Packwerk::ApplicationValidator::Result < ::T::Struct
-  const :error_value, T.nilable(::String)
   const :ok, T::Boolean
+  const :error_value, T.nilable(::String)
 
+  # source://packwerk//lib/packwerk/application_validator/result.rb#13
   sig { returns(T::Boolean) }
   def ok?; end
 
   class << self
+    # source://sorbet-runtime/0.5.10588/lib/types/struct.rb#13
     def inherited(s); end
   end
 end
 
 # Extracts the implicit constant reference from an active record association
+#
+# source://packwerk//lib/packwerk/association_inspector.rb#6
 class Packwerk::AssociationInspector
   include ::Packwerk::ConstantNameInspector
 
+  # source://packwerk//lib/packwerk/association_inspector.rb#23
   sig do
     params(
       inflector: T.class_of(ActiveSupport::Inflector),
@@ -161,49 +141,66 @@ class Packwerk::AssociationInspector
   end
   def initialize(inflector:, custom_associations: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/association_inspector.rb#33
   sig { override.params(node: ::AST::Node, ancestors: T::Array[::AST::Node]).returns(T.nilable(::String)) }
   def constant_name_from_node(node, ancestors:); end
 
   private
 
+  # source://packwerk//lib/packwerk/association_inspector.rb#52
   sig { params(node: ::AST::Node).returns(T::Boolean) }
   def association?(node); end
 
+  # source://packwerk//lib/packwerk/association_inspector.rb#66
   sig { params(arguments: T::Array[::AST::Node]).returns(T.nilable(T.any(::String, ::Symbol))) }
   def association_name(arguments); end
 
+  # source://packwerk//lib/packwerk/association_inspector.rb#58
   sig { params(arguments: T::Array[::AST::Node]).returns(T.nilable(::AST::Node)) }
   def custom_class_name(arguments); end
 end
 
+# source://packwerk//lib/packwerk/association_inspector.rb#10
 Packwerk::AssociationInspector::CustomAssociations = T.type_alias { T.any(T::Array[::Symbol], T::Set[::Symbol]) }
+
+# source://packwerk//lib/packwerk/association_inspector.rb#12
 Packwerk::AssociationInspector::RAILS_ASSOCIATIONS = T.let(T.unsafe(nil), Set)
 
+# source://packwerk//lib/packwerk/cache.rb#7
 class Packwerk::Cache
+  # source://packwerk//lib/packwerk/cache.rb#52
   sig { params(enable_cache: T::Boolean, cache_directory: ::Pathname, config_path: T.nilable(::String)).void }
   def initialize(enable_cache:, cache_directory:, config_path:); end
 
+  # source://packwerk//lib/packwerk/cache.rb#67
   sig { void }
   def bust_cache!; end
 
+  # source://packwerk//lib/packwerk/cache.rb#133
   sig { params(contents: ::String, contents_key: ::Symbol).void }
   def bust_cache_if_contents_have_changed(contents, contents_key); end
 
+  # source://packwerk//lib/packwerk/cache.rb#128
   sig { void }
   def bust_cache_if_inflections_have_changed!; end
 
+  # source://packwerk//lib/packwerk/cache.rb#121
   sig { void }
   def bust_cache_if_packwerk_yml_has_changed!; end
 
+  # source://packwerk//lib/packwerk/cache.rb#157
   sig { void }
   def create_cache_directory!; end
 
+  # source://packwerk//lib/packwerk/cache.rb#109
   sig { params(file: ::String).returns(::String) }
   def digest_for_file(file); end
 
+  # source://packwerk//lib/packwerk/cache.rb#114
   sig { params(str: ::String).returns(::String) }
   def digest_for_string(str); end
 
+  # source://packwerk//lib/packwerk/cache.rb#77
   sig do
     params(
       file_path: ::String,
@@ -213,25 +210,84 @@ class Packwerk::Cache
   def with_cache(file_path, &block); end
 end
 
+# source://packwerk//lib/packwerk/cache.rb#10
 class Packwerk::Cache::CacheContents < ::T::Struct
   const :file_contents_digest, ::String
   const :unresolved_references, T::Array[::Packwerk::UnresolvedReference]
 
+  # source://packwerk//lib/packwerk/cache.rb#39
   sig { returns(::String) }
   def serialize; end
 
   class << self
+    # source://packwerk//lib/packwerk/cache.rb#20
     sig { params(serialized_cache_contents: ::String).returns(::Packwerk::Cache::CacheContents) }
     def deserialize(serialized_cache_contents); end
 
+    # source://sorbet-runtime/0.5.10588/lib/types/struct.rb#13
     def inherited(s); end
   end
 end
 
+# source://packwerk//lib/packwerk/cache.rb#44
 Packwerk::Cache::CacheShape = T.type_alias { T::Hash[::String, ::Packwerk::Cache::CacheContents] }
 
+# @abstract Subclasses must implement the `abstract` methods below.
+#
+# source://packwerk//lib/packwerk/checker.rb#5
+module Packwerk::Checker
+  abstract!
+
+  # @abstract
+  #
+  # source://packwerk//lib/packwerk/checker.rb#49
+  sig { abstract.params(reference: ::Packwerk::Reference).returns(T::Boolean) }
+  def invalid_reference?(reference); end
+
+  # @abstract
+  #
+  # source://packwerk//lib/packwerk/checker.rb#52
+  sig { abstract.params(reference: ::Packwerk::Reference).returns(::String) }
+  def message(reference); end
+
+  # @abstract
+  #
+  # source://packwerk//lib/packwerk/checker.rb#46
+  sig { abstract.params(listed_offense: ::Packwerk::ReferenceOffense).returns(T::Boolean) }
+  def strict_mode_violation?(listed_offense); end
+
+  # @abstract
+  #
+  # source://packwerk//lib/packwerk/checker.rb#43
+  sig { abstract.returns(::String) }
+  def violation_type; end
+
+  class << self
+    # source://packwerk//lib/packwerk/checker.rb#22
+    sig { returns(T::Array[::Packwerk::Checker]) }
+    def all; end
+
+    # source://packwerk//lib/packwerk/checker.rb#27
+    sig { params(violation_type: ::String).returns(::Packwerk::Checker) }
+    def find(violation_type); end
+
+    # source://packwerk//lib/packwerk/checker.rb#15
+    sig { params(base: ::Class).void }
+    def included(base); end
+
+    private
+
+    # source://packwerk//lib/packwerk/checker.rb#34
+    sig { params(name: ::String).returns(::Packwerk::Checker) }
+    def checker_by_violation_type(name); end
+  end
+end
+
 # A command-line interface to Packwerk.
+#
+# source://packwerk//lib/packwerk/cli.rb#8
 class Packwerk::Cli
+  # source://packwerk//lib/packwerk/cli.rb#21
   sig do
     params(
       configuration: T.nilable(::Packwerk::Configuration),
@@ -244,101 +300,164 @@ class Packwerk::Cli
   end
   def initialize(configuration: T.unsafe(nil), out: T.unsafe(nil), err_out: T.unsafe(nil), environment: T.unsafe(nil), style: T.unsafe(nil), offenses_formatter: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/cli.rb#48
   sig { params(args: T::Array[::String]).returns(T::Boolean) }
   def execute_command(args); end
 
+  # source://packwerk//lib/packwerk/cli.rb#42
   sig { params(args: T::Array[::String]).returns(T.noreturn) }
   def run(args); end
 
   private
 
-  sig { returns(::Packwerk::ApplicationValidator) }
-  def checker; end
-
-  sig { params(relative_file_paths: T::Array[::String], ignore_nested_packages: T::Boolean).returns(T::Set[::String]) }
+  # source://packwerk//lib/packwerk/cli.rb#135
+  sig do
+    params(
+      relative_file_paths: T::Array[::String],
+      ignore_nested_packages: T::Boolean
+    ).returns(::Packwerk::FilesForProcessing)
+  end
   def fetch_files_to_process(relative_file_paths, ignore_nested_packages); end
 
+  # source://packwerk//lib/packwerk/cli.rb#79
   sig { returns(T::Boolean) }
   def generate_configs; end
 
+  # source://packwerk//lib/packwerk/cli.rb#72
   sig { returns(T::Boolean) }
   def init; end
 
+  # source://packwerk//lib/packwerk/cli.rb#174
   sig { params(result: ::Packwerk::ApplicationValidator::Result).void }
   def list_validation_errors(result); end
 
+  # source://packwerk//lib/packwerk/cli.rb#123
   sig { params(result: ::Packwerk::Result).returns(T::Boolean) }
   def output_result(result); end
 
-  sig { params(params: T.untyped).returns(::Packwerk::ParseRun) }
-  def parse_run(params); end
+  # source://packwerk//lib/packwerk/cli.rb#166
+  sig { returns(Packwerk::PackageSet) }
+  def package_set; end
+
+  # source://packwerk//lib/packwerk/cli.rb#186
+  sig { params(args: T::Array[::String]).returns(::Packwerk::ParseRun) }
+  def parse_run(args); end
 
+  # source://packwerk//lib/packwerk/cli.rb#108
+  sig { returns(T::Boolean) }
+  def usage; end
+
+  # source://packwerk//lib/packwerk/cli.rb#150
   sig { params(_paths: T::Array[::String]).returns(T::Boolean) }
   def validate(_paths); end
+
+  # source://packwerk//lib/packwerk/cli.rb#161
+  sig { returns(::Packwerk::ApplicationValidator) }
+  def validator; end
 end
 
+# source://packwerk//lib/packwerk/configuration.rb#8
 class Packwerk::Configuration
   # @return [Configuration] a new instance of Configuration
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#42
   def initialize(configs = T.unsafe(nil), config_path: T.unsafe(nil)); end
 
   # Returns the value of attribute cache_directory.
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#38
   def cache_directory; end
 
   # @return [Boolean]
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#76
   def cache_enabled?; end
 
   # Returns the value of attribute config_path.
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#38
   def config_path; end
 
   # Returns the value of attribute custom_associations.
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#38
   def custom_associations; end
 
   # Returns the value of attribute exclude.
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#38
   def exclude; end
 
   # Returns the value of attribute include.
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#38
   def include; end
 
+  # source://packwerk//lib/packwerk/configuration.rb#63
   def load_paths; end
 
+  # source://packwerk//lib/packwerk/configuration.rb#72
+  sig { returns(::Packwerk::OffensesFormatter) }
+  def offenses_formatter; end
+
   # Returns the value of attribute package_paths.
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#38
   def package_paths; end
 
   # @return [Boolean]
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#67
   def parallel?; end
 
   # Returns the value of attribute root_path.
+  #
+  # source://packwerk//lib/packwerk/configuration.rb#38
   def root_path; end
 
   class << self
     # @raise [ArgumentError]
+    #
+    # source://packwerk//lib/packwerk/configuration.rb#12
     def from_path(path = T.unsafe(nil)); end
 
     private
 
+    # source://packwerk//lib/packwerk/configuration.rb#26
     def from_packwerk_config(path); end
   end
 end
 
+# source://packwerk//lib/packwerk/configuration.rb#34
 Packwerk::Configuration::DEFAULT_CONFIG_PATH = T.let(T.unsafe(nil), String)
+
+# source://packwerk//lib/packwerk/configuration.rb#36
 Packwerk::Configuration::DEFAULT_EXCLUDE_GLOBS = T.let(T.unsafe(nil), Array)
+
+# source://packwerk//lib/packwerk/configuration.rb#35
 Packwerk::Configuration::DEFAULT_INCLUDE_GLOBS = T.let(T.unsafe(nil), Array)
 
 # Extracts a constant name from an AST node of type :const
+#
+# source://packwerk//lib/packwerk/const_node_inspector.rb#6
 class Packwerk::ConstNodeInspector
   include ::Packwerk::ConstantNameInspector
 
+  # source://packwerk//lib/packwerk/const_node_inspector.rb#15
   sig { override.params(node: ::AST::Node, ancestors: T::Array[::AST::Node]).returns(T.nilable(::String)) }
   def constant_name_from_node(node, ancestors:); end
 
   private
 
+  # source://packwerk//lib/packwerk/const_node_inspector.rb#43
   sig { params(node: ::AST::Node, parent: ::AST::Node).returns(T.nilable(T::Boolean)) }
   def constant_in_module_or_class_definition?(node, parent:); end
 
+  # source://packwerk//lib/packwerk/const_node_inspector.rb#49
   sig { params(ancestors: T::Array[::AST::Node]).returns(::String) }
   def fully_qualify_constant(ancestors); end
 
+  # source://packwerk//lib/packwerk/const_node_inspector.rb#38
   sig { params(parent: T.nilable(::AST::Node)).returns(T::Boolean) }
   def root_constant?(parent); end
 end
@@ -353,12 +472,17 @@ end
 # - It is OK to not always infer the exact file defining the constant. For example, when a constant is inherited, we
 #   have no way of inferring the file it is defined in. You could argue though that inheritance means that another
 #   constant with the same name exists in the inheriting class, and this view is sufficient for all our use cases.
+#
+# source://packwerk//lib/packwerk/constant_discovery.rb#17
 class Packwerk::ConstantDiscovery
+  # source://packwerk//lib/packwerk/constant_discovery.rb#27
   sig { params(constant_resolver: ::ConstantResolver, packages: Packwerk::PackageSet).void }
   def initialize(constant_resolver:, packages:); end
 
   # Analyze a constant via its name.
   # If the constant is unresolved, we need the current namespace path to correctly infer its full name
+  #
+  # source://packwerk//lib/packwerk/constant_discovery.rb#60
   sig do
     params(
       const_name: ::String,
@@ -368,10 +492,13 @@ class Packwerk::ConstantDiscovery
   def context_for(const_name, current_namespace_path: T.unsafe(nil)); end
 
   # Get the package that owns a given file path.
+  #
+  # source://packwerk//lib/packwerk/constant_discovery.rb#43
   sig { params(path: ::String).returns(::Packwerk::Package) }
   def package_from_path(path); end
 end
 
+# source://packwerk//lib/packwerk/constant_discovery.rb#20
 class Packwerk::ConstantDiscovery::ConstantContext < ::Struct
   # Returns the value of attribute location
   #
@@ -382,6 +509,8 @@ class Packwerk::ConstantDiscovery::ConstantContext < ::Struct
   #
   # @param value [Object] the value to set the attribute location to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/constant_discovery.rb#20
   def location=(_); end
 
   # Returns the value of attribute name
@@ -393,6 +522,8 @@ class Packwerk::ConstantDiscovery::ConstantContext < ::Struct
   #
   # @param value [Object] the value to set the attribute name to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/constant_discovery.rb#20
   def name=(_); end
 
   # Returns the value of attribute package
@@ -404,12 +535,9 @@ class Packwerk::ConstantDiscovery::ConstantContext < ::Struct
   #
   # @param value [Object] the value to set the attribute package to.
   # @return [Object] the newly set value
-  def package=(_); end
-
-  # Returns the value of attribute public?
   #
-  # @return [Object] the current value of public?
-  def public?; end
+  # source://packwerk//lib/packwerk/constant_discovery.rb#20
+  def package=(_); end
 
   class << self
     def [](*_arg0); end
@@ -422,52 +550,42 @@ end
 # An interface describing an object that can extract a constant name from an AST node.
 #
 # @abstract Subclasses must implement the `abstract` methods below.
+#
+# source://packwerk//lib/packwerk/constant_name_inspector.rb#8
 module Packwerk::ConstantNameInspector
   interface!
 
   # @abstract
+  #
+  # source://packwerk//lib/packwerk/constant_name_inspector.rb#19
   sig { abstract.params(node: ::AST::Node, ancestors: T::Array[::AST::Node]).returns(T.nilable(::String)) }
   def constant_name_from_node(node, ancestors:); end
 end
 
+# source://packwerk//lib/packwerk/cache.rb#162
 class Packwerk::Debug
   class << self
+    # source://packwerk//lib/packwerk/cache.rb#167
     sig { params(out: ::String).void }
     def out(out); end
   end
 end
 
-class Packwerk::DeprecatedReferences
-  sig { params(package: ::Packwerk::Package, filepath: ::String).void }
-  def initialize(package, filepath); end
-
-  sig { params(reference: ::Packwerk::Reference, violation_type: ::Packwerk::ViolationType).returns(T::Boolean) }
-  def add_entries(reference, violation_type); end
-
-  sig { void }
-  def dump; end
-
-  sig { params(reference: ::Packwerk::Reference, violation_type: ::Packwerk::ViolationType).returns(T::Boolean) }
-  def listed?(reference, violation_type:); end
-
-  sig { params(for_files: T::Set[::String]).returns(T::Boolean) }
-  def stale_violations?(for_files); end
-
-  private
-
-  sig { returns(T::Hash[::String, T.untyped]) }
-  def deprecated_references; end
-
-  sig { params(filepath: ::String).returns(T::Hash[::String, T.untyped]) }
-  def load_yaml(filepath); end
-
-  sig { returns(T::Hash[::String, T.untyped]) }
-  def prepare_entries_for_dump; end
+# This class handles loading extensions to packwerk using the `require` directive
+# in the `packwerk.yml` configuration.
+#
+# source://packwerk//lib/packwerk/extension_loader.rb#7
+module Packwerk::ExtensionLoader
+  class << self
+    # source://packwerk//lib/packwerk/extension_loader.rb#11
+    sig { params(require_directive: ::String, config_dir_path: ::String).void }
+    def load(require_directive, config_dir_path); end
+  end
 end
 
-Packwerk::DeprecatedReferences::EntriesType = T.type_alias { T::Hash[::String, T.untyped] }
-
+# source://packwerk//lib/packwerk/file_processor.rb#7
 class Packwerk::FileProcessor
+  # source://packwerk//lib/packwerk/file_processor.rb#26
   sig do
     params(
       node_processor_factory: ::Packwerk::NodeProcessorFactory,
@@ -477,36 +595,46 @@ class Packwerk::FileProcessor
   end
   def initialize(node_processor_factory:, cache:, parser_factory: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/file_processor.rb#40
   sig { params(relative_file: ::String).returns(::Packwerk::FileProcessor::ProcessedFile) }
   def call(relative_file); end
 
   private
 
+  # source://packwerk//lib/packwerk/file_processor.rb#74
   sig { params(relative_file: ::String, parser: ::Packwerk::Parsers::ParserInterface).returns(T.untyped) }
   def parse_into_ast(relative_file, parser); end
 
+  # source://packwerk//lib/packwerk/file_processor.rb#81
   sig { params(file_path: ::String).returns(T.nilable(::Packwerk::Parsers::ParserInterface)) }
   def parser_for(file_path); end
 
+  # source://packwerk//lib/packwerk/file_processor.rb#63
   sig { params(node: ::Parser::AST::Node, relative_file: ::String).returns(T::Array[::Packwerk::UnresolvedReference]) }
   def references_from_ast(node, relative_file); end
 end
 
+# source://packwerk//lib/packwerk/file_processor.rb#32
 class Packwerk::FileProcessor::ProcessedFile < ::T::Struct
-  const :offenses, T::Array[::Packwerk::Offense], default: T.unsafe(nil)
   const :unresolved_references, T::Array[::Packwerk::UnresolvedReference], default: T.unsafe(nil)
+  const :offenses, T::Array[::Packwerk::Offense], default: T.unsafe(nil)
 
   class << self
+    # source://sorbet-runtime/0.5.10588/lib/types/struct.rb#13
     def inherited(s); end
   end
 end
 
+# source://packwerk//lib/packwerk/file_processor.rb#10
 class Packwerk::FileProcessor::UnknownFileTypeResult < ::Packwerk::Offense
+  # source://packwerk//lib/packwerk/file_processor.rb#14
   sig { params(file: ::String).void }
   def initialize(file:); end
 end
 
+# source://packwerk//lib/packwerk/files_for_processing.rb#5
 class Packwerk::FilesForProcessing
+  # source://packwerk//lib/packwerk/files_for_processing.rb#32
   sig do
     params(
       relative_file_paths: T::Array[::String],
@@ -516,53 +644,74 @@ class Packwerk::FilesForProcessing
   end
   def initialize(relative_file_paths, configuration, ignore_nested_packages); end
 
+  # source://packwerk//lib/packwerk/files_for_processing.rb#41
   sig { returns(T::Set[::String]) }
   def files; end
 
+  # source://packwerk//lib/packwerk/files_for_processing.rb#46
+  sig { returns(T::Boolean) }
+  def files_specified?; end
+
   private
 
+  # source://packwerk//lib/packwerk/files_for_processing.rb#105
   sig { returns(T::Set[::String]) }
   def configured_excluded_files; end
 
+  # source://packwerk//lib/packwerk/files_for_processing.rb#100
   sig { returns(T::Set[::String]) }
   def configured_included_files; end
 
+  # source://packwerk//lib/packwerk/files_for_processing.rb#53
   sig { returns(T::Set[::String]) }
-  def custom_files; end
-
-  sig { params(relative_file_path: ::String).returns(T::Set[::String]) }
-  def custom_included_files(relative_file_path); end
+  def files_for_processing; end
 
+  # source://packwerk//lib/packwerk/files_for_processing.rb#110
   sig { params(relative_globs: T::Array[::String]).returns(T::Set[::String]) }
   def relative_files_for_globs(relative_globs); end
 
+  # source://packwerk//lib/packwerk/files_for_processing.rb#64
+  sig { returns(T::Set[::String]) }
+  def specified_files; end
+
+  # source://packwerk//lib/packwerk/files_for_processing.rb#77
+  sig { params(relative_file_path: ::String).returns(T::Set[::String]) }
+  def specified_included_files(relative_file_path); end
+
   class << self
+    # source://packwerk//lib/packwerk/files_for_processing.rb#20
     sig do
       params(
         relative_file_paths: T::Array[::String],
         configuration: ::Packwerk::Configuration,
         ignore_nested_packages: T::Boolean
-      ).returns(T::Set[::String])
+      ).returns(::Packwerk::FilesForProcessing)
     end
     def fetch(relative_file_paths:, configuration:, ignore_nested_packages: T.unsafe(nil)); end
   end
 end
 
+# source://packwerk//lib/packwerk/files_for_processing.rb#8
 Packwerk::FilesForProcessing::RelativeFileSet = T.type_alias { T::Set[::String] }
 
+# source://packwerk//lib/packwerk.rb#66
 module Packwerk::Formatters
   extend ::ActiveSupport::Autoload
 end
 
+# source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#6
 class Packwerk::Formatters::OffensesFormatter
   include ::Packwerk::OffensesFormatter
 
-  sig { params(style: ::Packwerk::OutputStyle).void }
-  def initialize(style: T.unsafe(nil)); end
+  # source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#33
+  sig { override.returns(::String) }
+  def identifier; end
 
+  # source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#14
   sig { override.params(offenses: T::Array[T.nilable(::Packwerk::Offense)]).returns(::String) }
   def show_offenses(offenses); end
 
+  # source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#24
   sig do
     override
       .params(
@@ -572,84 +721,152 @@ class Packwerk::Formatters::OffensesFormatter
   end
   def show_stale_violations(offense_collection, fileset); end
 
+  # source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#38
+  sig { override.params(strict_mode_violations: T::Array[::Packwerk::ReferenceOffense]).returns(::String) }
+  def show_strict_mode_violations(strict_mode_violations); end
+
   private
 
+  # source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#54
+  sig { params(offense: ::Packwerk::ReferenceOffense).returns(::String) }
+  def format_strict_mode_violation(offense); end
+
+  # source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#62
   sig { params(offenses: T::Array[T.nilable(::Packwerk::Offense)]).returns(::String) }
   def offenses_list(offenses); end
 
+  # source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#70
   sig { params(offenses: T::Array[T.nilable(::Packwerk::Offense)]).returns(::String) }
   def offenses_summary(offenses); end
+
+  # source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#49
+  sig { returns(::Packwerk::OutputStyle) }
+  def style; end
 end
 
+# source://packwerk//lib/packwerk/formatters/offenses_formatter.rb#9
+Packwerk::Formatters::OffensesFormatter::IDENTIFIER = T.let(T.unsafe(nil), String)
+
+# source://packwerk//lib/packwerk/formatters/progress_formatter.rb#8
 class Packwerk::Formatters::ProgressFormatter
+  # source://packwerk//lib/packwerk/formatters/progress_formatter.rb#12
   sig { params(out: T.any(::IO, ::StringIO), style: ::Packwerk::OutputStyle).void }
   def initialize(out, style: T.unsafe(nil)); end
 
-  def finished(execution_time); end
+  # source://packwerk//lib/packwerk/formatters/progress_formatter.rb#39
   def interrupted; end
+
+  # source://packwerk//lib/packwerk/formatters/progress_formatter.rb#35
   def mark_as_failed; end
+
+  # source://packwerk//lib/packwerk/formatters/progress_formatter.rb#31
   def mark_as_inspected; end
-  def started(target_files); end
+
+  # source://packwerk//lib/packwerk/formatters/progress_formatter.rb#24
+  def started_inspection(target_files, &block); end
+
+  # source://packwerk//lib/packwerk/formatters/progress_formatter.rb#17
   def started_validation(&block); end
+
+  private
+
+  # source://packwerk//lib/packwerk/formatters/progress_formatter.rb#46
+  def finished(execution_time); end
+
+  # source://packwerk//lib/packwerk/formatters/progress_formatter.rb#55
+  def start_inspection(target_files); end
+
+  # source://packwerk//lib/packwerk/formatters/progress_formatter.rb#51
+  def start_validation; end
 end
 
+# source://packwerk//lib/packwerk.rb#72
 module Packwerk::Generators
   extend ::ActiveSupport::Autoload
 end
 
+# source://packwerk//lib/packwerk/generators/configuration_file.rb#8
 class Packwerk::Generators::ConfigurationFile
+  # source://packwerk//lib/packwerk/generators/configuration_file.rb#20
   sig { params(root: ::String, out: T.any(::IO, ::StringIO)).void }
   def initialize(root:, out: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/generators/configuration_file.rb#26
   sig { returns(T::Boolean) }
   def generate; end
 
   private
 
+  # source://packwerk//lib/packwerk/generators/configuration_file.rb#43
   def render; end
+
+  # source://packwerk//lib/packwerk/generators/configuration_file.rb#47
   def template; end
 
   class << self
+    # source://packwerk//lib/packwerk/generators/configuration_file.rb#14
     def generate(root:, out:); end
   end
 end
 
+# source://packwerk//lib/packwerk/generators/configuration_file.rb#11
 Packwerk::Generators::ConfigurationFile::CONFIGURATION_TEMPLATE_FILE_PATH = T.let(T.unsafe(nil), String)
 
+# source://packwerk//lib/packwerk/generators/root_package.rb#6
 class Packwerk::Generators::RootPackage
   # @return [RootPackage] a new instance of RootPackage
+  #
+  # source://packwerk//lib/packwerk/generators/root_package.rb#15
   def initialize(root:, out: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/generators/root_package.rb#21
   sig { returns(T::Boolean) }
   def generate; end
 
   class << self
+    # source://packwerk//lib/packwerk/generators/root_package.rb#10
     def generate(root:, out:); end
   end
 end
 
 # A general implementation of a graph data structure with the ability to check for - and list - cycles.
+#
+# source://packwerk//lib/packwerk/graph.rb#6
 class Packwerk::Graph
-  # @param edges [Array<Array>] The edges of the graph; An edge being represented as an Array of two nodes.
-  # @return [Graph] a new instance of Graph
-  def initialize(*edges); end
+  # source://packwerk//lib/packwerk/graph.rb#14
+  sig { params(edges: T::Array[T::Array[T.nilable(T.any(::Integer, ::String))]]).void }
+  def initialize(edges); end
 
   # @return [Boolean]
+  #
+  # source://packwerk//lib/packwerk/graph.rb#24
   def acyclic?; end
 
+  # source://packwerk//lib/packwerk/graph.rb#20
   def cycles; end
 
   private
 
+  # source://packwerk//lib/packwerk/graph.rb#74
   def add_cycle(cycle); end
+
+  # source://packwerk//lib/packwerk/graph.rb#67
   def neighbours(node); end
+
+  # source://packwerk//lib/packwerk/graph.rb#30
   def nodes; end
+
+  # source://packwerk//lib/packwerk/graph.rb#34
   def process; end
+
+  # source://packwerk//lib/packwerk/graph.rb#42
   def visit(node, visited_nodes: T.unsafe(nil), path: T.unsafe(nil)); end
 end
 
+# source://packwerk//lib/packwerk/node.rb#5
 class Packwerk::Node; end
 
+# source://packwerk//lib/packwerk/node.rb#6
 class Packwerk::Node::Location < ::Struct
   # Returns the value of attribute column
   #
@@ -660,6 +877,8 @@ class Packwerk::Node::Location < ::Struct
   #
   # @param value [Object] the value to set the attribute column to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/node.rb#6
   def column=(_); end
 
   # Returns the value of attribute line
@@ -671,6 +890,8 @@ class Packwerk::Node::Location < ::Struct
   #
   # @param value [Object] the value to set the attribute line to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/node.rb#6
   def line=(_); end
 
   class << self
@@ -682,117 +903,162 @@ class Packwerk::Node::Location < ::Struct
 end
 
 # Convenience methods for working with Parser::AST::Node nodes.
+#
+# source://packwerk//lib/packwerk/node_helpers.rb#9
 module Packwerk::NodeHelpers
   class << self
+    # source://packwerk//lib/packwerk/node_helpers.rb#117
     sig { params(node: ::AST::Node).returns(T::Boolean) }
     def class?(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#16
     sig { params(class_or_module_node: ::AST::Node).returns(::String) }
     def class_or_module_name(class_or_module_node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#107
     sig { params(node: ::AST::Node).returns(T::Boolean) }
     def constant?(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#112
     sig { params(node: ::AST::Node).returns(T::Boolean) }
     def constant_assignment?(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#31
     sig { params(constant_node: ::AST::Node).returns(::String) }
     def constant_name(constant_node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#63
     sig { params(node: ::AST::Node).returns(T.untyped) }
     def each_child(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#74
     sig { params(starting_node: ::AST::Node, ancestors: T::Array[::AST::Node]).returns(T::Array[::String]) }
     def enclosing_namespace_path(starting_node, ancestors:); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#127
     sig { params(node: ::AST::Node).returns(T::Boolean) }
     def hash?(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#87
     sig { params(string_or_symbol_node: ::AST::Node).returns(T.any(::String, ::Symbol)) }
     def literal_value(string_or_symbol_node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#101
     sig { params(node: ::Parser::AST::Node).returns(::Packwerk::Node::Location) }
     def location(node); end
 
     # @raise [TypeError]
+    #
+    # source://packwerk//lib/packwerk/node_helpers.rb#142
     sig { params(method_call_node: ::AST::Node).returns(T::Array[::AST::Node]) }
     def method_arguments(method_call_node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#122
     sig { params(node: ::AST::Node).returns(T::Boolean) }
     def method_call?(node); end
 
     # @raise [TypeError]
+    #
+    # source://packwerk//lib/packwerk/node_helpers.rb#151
     sig { params(method_call_node: ::AST::Node).returns(::Symbol) }
     def method_name(method_call_node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#160
     sig { params(node: ::AST::Node).returns(T.nilable(::String)) }
     def module_name_from_definition(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#185
     sig { params(node: ::Parser::AST::Node).returns(T.nilable(::Packwerk::Node::Location)) }
     def name_location(node); end
 
     # @raise [TypeError]
+    #
+    # source://packwerk//lib/packwerk/node_helpers.rb#195
     sig { params(class_node: ::AST::Node).returns(T.nilable(::AST::Node)) }
     def parent_class(class_node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#204
     sig { params(ancestors: T::Array[::AST::Node]).returns(::String) }
     def parent_module_name(ancestors:); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#132
     sig { params(node: ::AST::Node).returns(T::Boolean) }
     def string?(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#137
     sig { params(node: ::AST::Node).returns(T::Boolean) }
     def symbol?(node); end
 
     # @raise [TypeError]
+    #
+    # source://packwerk//lib/packwerk/node_helpers.rb#216
     sig { params(hash_node: ::AST::Node, key: ::Symbol).returns(T.untyped) }
     def value_from_hash(hash_node, key); end
 
     private
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#298
     sig { params(node: T.nilable(::AST::Node)).returns(T::Boolean) }
     def dynamic_class_creation?(node); end
 
     # @raise [TypeError]
+    #
+    # source://packwerk//lib/packwerk/node_helpers.rb#249
     sig { params(hash_pair_node: ::AST::Node).returns(T.untyped) }
     def hash_pair_key(hash_pair_node); end
 
     # @raise [TypeError]
+    #
+    # source://packwerk//lib/packwerk/node_helpers.rb#260
     sig { params(hash_pair_node: ::AST::Node).returns(T.untyped) }
     def hash_pair_value(hash_pair_node); end
 
     # @raise [TypeError]
+    #
+    # source://packwerk//lib/packwerk/node_helpers.rb#271
     sig { params(hash_node: ::AST::Node).returns(T::Array[::AST::Node]) }
     def hash_pairs(hash_node); end
 
     # @raise [TypeError]
+    #
+    # source://packwerk//lib/packwerk/node_helpers.rb#280
     sig { params(block_node: ::AST::Node).returns(::AST::Node) }
     def method_call_node(block_node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#289
     sig { params(node: ::AST::Node).returns(T::Boolean) }
     def module_creation?(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#305
     sig { params(node: ::AST::Node).returns(T.nilable(::String)) }
     def name_from_block_definition(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#313
     sig { params(node: ::AST::Node).returns(T.nilable(::String)) }
     def name_part_from_definition(node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#323
     sig { params(method_call_or_block_node: ::AST::Node).returns(T.nilable(::AST::Node)) }
     def receiver(method_call_or_block_node); end
 
+    # source://packwerk//lib/packwerk/node_helpers.rb#244
     sig { params(node: ::AST::Node).returns(::Symbol) }
     def type_of(node); end
   end
 end
 
+# source://packwerk//lib/packwerk/node_helpers.rb#10
 class Packwerk::NodeHelpers::TypeError < ::ArgumentError; end
 
 # Processes a single node in an abstract syntax tree (AST) using the provided checkers.
+#
+# source://packwerk//lib/packwerk/node_processor.rb#6
 class Packwerk::NodeProcessor
+  # source://packwerk//lib/packwerk/node_processor.rb#15
   sig { params(reference_extractor: ::Packwerk::ReferenceExtractor, relative_file: ::String).void }
   def initialize(reference_extractor:, relative_file:); end
 
+  # source://packwerk//lib/packwerk/node_processor.rb#26
   sig do
     params(
       node: ::Parser::AST::Node,
@@ -802,97 +1068,149 @@ class Packwerk::NodeProcessor
   def call(node, ancestors); end
 end
 
+# source://packwerk//lib/packwerk/node_processor_factory.rb#5
 class Packwerk::NodeProcessorFactory < ::T::Struct
-  const :constant_name_inspectors, T::Array[::Packwerk::ConstantNameInspector]
-  const :context_provider, ::Packwerk::ConstantDiscovery
   const :root_path, ::String
+  const :context_provider, ::Packwerk::ConstantDiscovery
+  const :constant_name_inspectors, T::Array[::Packwerk::ConstantNameInspector]
 
+  # source://packwerk//lib/packwerk/node_processor_factory.rb#13
   sig { params(relative_file: ::String, node: ::AST::Node).returns(::Packwerk::NodeProcessor) }
   def for(relative_file:, node:); end
 
   private
 
+  # source://packwerk//lib/packwerk/node_processor_factory.rb#23
   sig { params(node: ::AST::Node).returns(::Packwerk::ReferenceExtractor) }
   def reference_extractor(node:); end
 
   class << self
+    # source://sorbet-runtime/0.5.10588/lib/types/struct.rb#13
     def inherited(s); end
   end
 end
 
 # Visits all nodes of an AST, processing them using a given node processor.
+#
+# source://packwerk//lib/packwerk/node_visitor.rb#6
 class Packwerk::NodeVisitor
+  # source://packwerk//lib/packwerk/node_visitor.rb#10
   sig { params(node_processor: ::Packwerk::NodeProcessor).void }
   def initialize(node_processor:); end
 
+  # source://packwerk//lib/packwerk/node_visitor.rb#14
   def visit(node, ancestors:, result:); end
 end
 
+# source://packwerk//lib/packwerk/offense.rb#7
 class Packwerk::Offense
+  # source://packwerk//lib/packwerk/offense.rb#24
   sig { params(file: ::String, message: ::String, location: T.nilable(::Packwerk::Node::Location)).void }
   def initialize(file:, message:, location: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/offense.rb#15
   sig { returns(::String) }
   def file; end
 
+  # source://packwerk//lib/packwerk/offense.rb#12
   sig { returns(T.nilable(::Packwerk::Node::Location)) }
   def location; end
 
+  # source://packwerk//lib/packwerk/offense.rb#18
   sig { returns(::String) }
   def message; end
 
+  # source://packwerk//lib/packwerk/offense.rb#31
   sig { params(style: ::Packwerk::OutputStyle).returns(::String) }
   def to_s(style = T.unsafe(nil)); end
 end
 
+# source://packwerk//lib/packwerk/offense_collection.rb#7
 class Packwerk::OffenseCollection
-  sig do
-    params(
-      root_path: ::String,
-      deprecated_references: T::Hash[::Packwerk::Package, ::Packwerk::DeprecatedReferences]
-    ).void
-  end
-  def initialize(root_path, deprecated_references = T.unsafe(nil)); end
+  # source://packwerk//lib/packwerk/offense_collection.rb#17
+  sig { params(root_path: ::String, package_todo: T::Hash[::Packwerk::Package, ::Packwerk::PackageTodo]).void }
+  def initialize(root_path, package_todo = T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/offense_collection.rb#48
   sig { params(offense: ::Packwerk::Offense).void }
   def add_offense(offense); end
 
-  sig { void }
-  def dump_deprecated_references_files; end
-
+  # source://packwerk//lib/packwerk/offense_collection.rb#29
   sig { returns(T::Array[::Packwerk::Offense]) }
   def errors; end
 
+  # source://packwerk//lib/packwerk/offense_collection.rb#38
   sig { params(offense: ::Packwerk::Offense).returns(T::Boolean) }
   def listed?(offense); end
 
+  # source://packwerk//lib/packwerk/offense_collection.rb#26
   sig { returns(T::Array[::Packwerk::ReferenceOffense]) }
   def new_violations; end
 
+  # source://packwerk//lib/packwerk/offense_collection.rb#75
   sig { returns(T::Array[::Packwerk::Offense]) }
   def outstanding_offenses; end
 
+  # source://packwerk//lib/packwerk/offense_collection.rb#69
+  sig { params(package_set: Packwerk::PackageSet).void }
+  def persist_package_todo_files(package_set); end
+
+  # source://packwerk//lib/packwerk/offense_collection.rb#62
   sig { params(for_files: T::Set[::String]).returns(T::Boolean) }
   def stale_violations?(for_files); end
 
+  # source://packwerk//lib/packwerk/offense_collection.rb#32
+  sig { returns(T::Array[::Packwerk::ReferenceOffense]) }
+  def strict_mode_violations; end
+
   private
 
+  # source://packwerk//lib/packwerk/offense_collection.rb#82
+  sig { params(offense: ::Packwerk::ReferenceOffense).returns(T::Boolean) }
+  def already_listed?(offense); end
+
+  # source://packwerk//lib/packwerk/offense_collection.rb#94
+  sig { params(package_set: Packwerk::PackageSet).void }
+  def cleanup_extra_package_todo_files(package_set); end
+
+  # source://packwerk//lib/packwerk/offense_collection.rb#106
+  sig { void }
+  def dump_package_todo_files; end
+
+  # source://packwerk//lib/packwerk/offense_collection.rb#119
   sig { params(package: ::Packwerk::Package).returns(::String) }
-  def deprecated_references_file_for(package); end
+  def package_todo_file_for(package); end
 
-  sig { params(package: ::Packwerk::Package).returns(::Packwerk::DeprecatedReferences) }
-  def deprecated_references_for(package); end
+  # source://packwerk//lib/packwerk/offense_collection.rb#111
+  sig { params(package: ::Packwerk::Package).returns(::Packwerk::PackageTodo) }
+  def package_todo_for(package); end
+
+  # source://packwerk//lib/packwerk/offense_collection.rb#88
+  sig { params(offense: ::Packwerk::ReferenceOffense).returns(T::Boolean) }
+  def strict_mode_violation?(offense); end
 end
 
 # @abstract Subclasses must implement the `abstract` methods below.
+#
+# source://packwerk//lib/packwerk/offenses_formatter.rb#5
 module Packwerk::OffensesFormatter
-  interface!
+  abstract!
+
+  # @abstract
+  #
+  # source://packwerk//lib/packwerk/offenses_formatter.rb#69
+  sig { abstract.returns(::String) }
+  def identifier; end
 
   # @abstract
+  #
+  # source://packwerk//lib/packwerk/offenses_formatter.rb#61
   sig { abstract.params(offenses: T::Array[T.nilable(::Packwerk::Offense)]).returns(::String) }
   def show_offenses(offenses); end
 
   # @abstract
+  #
+  # source://packwerk//lib/packwerk/offenses_formatter.rb#65
   sig do
     abstract
       .params(
@@ -901,52 +1219,103 @@ module Packwerk::OffensesFormatter
       ).returns(::String)
   end
   def show_stale_violations(offense_collection, for_files); end
+
+  # @abstract
+  #
+  # source://packwerk//lib/packwerk/offenses_formatter.rb#73
+  sig { abstract.params(strict_mode_violations: T::Array[::Packwerk::ReferenceOffense]).returns(::String) }
+  def show_strict_mode_violations(strict_mode_violations); end
+
+  class << self
+    # source://packwerk//lib/packwerk/offenses_formatter.rb#31
+    sig { returns(T::Array[::Packwerk::OffensesFormatter]) }
+    def all; end
+
+    # source://packwerk//lib/packwerk/offenses_formatter.rb#36
+    sig { params(identifier: ::String).returns(::Packwerk::OffensesFormatter) }
+    def find(identifier); end
+
+    # source://packwerk//lib/packwerk/offenses_formatter.rb#24
+    sig { params(base: ::Class).void }
+    def included(base); end
+
+    private
+
+    # source://packwerk//lib/packwerk/offenses_formatter.rb#43
+    sig { params(name: ::String).returns(::Packwerk::OffensesFormatter) }
+    def formatter_by_identifier(name); end
+  end
+end
+
+# source://packwerk//lib/packwerk/offenses_formatter.rb#11
+class Packwerk::OffensesFormatter::DuplicateFormatterError < ::StandardError
+  # source://packwerk//lib/packwerk/offenses_formatter.rb#15
+  sig { params(identifier: ::String).void }
+  def initialize(identifier); end
 end
 
 # @abstract Subclasses must implement the `abstract` methods below.
+#
+# source://packwerk//lib/packwerk/output_style.rb#5
 module Packwerk::OutputStyle
   interface!
 
   # @abstract
+  #
+  # source://packwerk//lib/packwerk/output_style.rb#18
   sig { abstract.returns(::String) }
   def error; end
 
   # @abstract
+  #
+  # source://packwerk//lib/packwerk/output_style.rb#15
   sig { abstract.returns(::String) }
   def filename; end
 
   # @abstract
+  #
+  # source://packwerk//lib/packwerk/output_style.rb#12
   sig { abstract.returns(::String) }
   def reset; end
 end
 
+# source://packwerk//lib/packwerk.rb#55
 module Packwerk::OutputStyles
   extend ::ActiveSupport::Autoload
 end
 
 # See https://en.wikipedia.org/wiki/ANSI_escape_code#3/4_bit for ANSI escape colour codes
+#
+# source://packwerk//lib/packwerk/output_styles/coloured.rb#7
 class Packwerk::OutputStyles::Coloured
   include ::Packwerk::OutputStyle
 
+  # source://packwerk//lib/packwerk/output_styles/coloured.rb#23
   sig { override.returns(::String) }
   def error; end
 
+  # source://packwerk//lib/packwerk/output_styles/coloured.rb#17
   sig { override.returns(::String) }
   def filename; end
 
+  # source://packwerk//lib/packwerk/output_styles/coloured.rb#12
   sig { override.returns(::String) }
   def reset; end
 end
 
+# source://packwerk//lib/packwerk/output_styles/plain.rb#6
 class Packwerk::OutputStyles::Plain
   include ::Packwerk::OutputStyle
 
+  # source://packwerk//lib/packwerk/output_styles/plain.rb#21
   sig { override.returns(::String) }
   def error; end
 
+  # source://packwerk//lib/packwerk/output_styles/plain.rb#16
   sig { override.returns(::String) }
   def filename; end
 
+  # source://packwerk//lib/packwerk/output_styles/plain.rb#11
   sig { override.returns(::String) }
   def reset; end
 end
@@ -954,78 +1323,94 @@ end
 # The basic unit of modularity for packwerk; a folder that has been declared to define a package.
 # The package contains all constants defined in files in this folder and all subfolders that are not packages
 # themselves.
+#
+# source://packwerk//lib/packwerk/package.rb#8
 class Packwerk::Package
   include ::Comparable
 
+  # source://packwerk//lib/packwerk/package.rb#24
   sig { params(name: ::String, config: T.nilable(T.any(::FalseClass, T::Hash[T.untyped, T.untyped]))).void }
   def initialize(name:, config:); end
 
+  # source://packwerk//lib/packwerk/package.rb#49
   sig { params(other: T.untyped).returns(T.nilable(::Integer)) }
   def <=>(other); end
 
+  # source://packwerk//lib/packwerk/package.rb#21
+  sig { returns(T::Hash[T.untyped, T.untyped]) }
+  def config; end
+
+  # source://packwerk//lib/packwerk/package.rb#18
   sig { returns(T::Array[::String]) }
   def dependencies; end
 
+  # source://packwerk//lib/packwerk/package.rb#37
   sig { params(package: ::Packwerk::Package).returns(T::Boolean) }
   def dependency?(package); end
 
+  # source://packwerk//lib/packwerk/package.rb#32
   sig { returns(T::Boolean) }
   def enforce_dependencies?; end
 
-  sig { returns(T.nilable(T.any(T::Array[::String], T::Boolean))) }
-  def enforce_privacy; end
-
+  # source://packwerk//lib/packwerk/package.rb#56
   sig { params(other: T.untyped).returns(T::Boolean) }
   def eql?(other); end
 
+  # source://packwerk//lib/packwerk/package.rb#61
   sig { returns(::Integer) }
   def hash; end
 
+  # source://packwerk//lib/packwerk/package.rb#15
   sig { returns(::String) }
   def name; end
 
+  # source://packwerk//lib/packwerk/package.rb#42
   sig { params(path: ::String).returns(T::Boolean) }
   def package_path?(path); end
 
-  sig { returns(::String) }
-  def public_path; end
-
-  sig { params(path: ::String).returns(T::Boolean) }
-  def public_path?(path); end
-
+  # source://packwerk//lib/packwerk/package.rb#71
   sig { returns(T::Boolean) }
   def root?; end
 
+  # source://packwerk//lib/packwerk/package.rb#66
   sig { returns(::String) }
   def to_s; end
-
-  sig { returns(T.nilable(::String)) }
-  def user_defined_public_path; end
 end
 
+# source://packwerk//lib/packwerk/package.rb#12
 Packwerk::Package::ROOT_PACKAGE_NAME = T.let(T.unsafe(nil), String)
 
 # A set of {Packwerk::Package}s as well as methods to parse packages from the filesystem.
+#
+# source://packwerk//lib/packwerk/package_set.rb#11
 class Packwerk::PackageSet
   extend T::Generic
   include ::Enumerable
 
+  Elem = type_member { { fixed: Packwerk::Package } }
+
+  # source://packwerk//lib/packwerk/package_set.rb#79
   sig { params(packages: T::Array[::Packwerk::Package]).void }
   def initialize(packages); end
 
+  # source://packwerk//lib/packwerk/package_set.rb#88
   sig { override.params(blk: T.proc.params(arg0: ::Packwerk::Package).returns(T.untyped)).returns(T.untyped) }
   def each(&blk); end
 
+  # source://packwerk//lib/packwerk/package_set.rb#93
   sig { params(name: ::String).returns(T.nilable(::Packwerk::Package)) }
   def fetch(name); end
 
+  # source://packwerk//lib/packwerk/package_set.rb#98
   sig { params(file_path: T.any(::Pathname, ::String)).returns(::Packwerk::Package) }
   def package_from_path(file_path); end
 
+  # source://packwerk//lib/packwerk/package_set.rb#76
   sig { returns(T::Hash[::String, ::Packwerk::Package]) }
   def packages; end
 
   class << self
+    # source://packwerk//lib/packwerk/package_set.rb#24
     sig do
       params(
         root_path: ::String,
@@ -1034,6 +1419,7 @@ class Packwerk::PackageSet
     end
     def load_all_from(root_path, package_pathspec: T.unsafe(nil)); end
 
+    # source://packwerk//lib/packwerk/package_set.rb#44
     sig do
       params(
         root_path: ::String,
@@ -1045,41 +1431,92 @@ class Packwerk::PackageSet
 
     private
 
+    # source://packwerk//lib/packwerk/package_set.rb#61
     sig { params(packages: T::Array[::Packwerk::Package]).void }
     def create_root_package_if_none_in(packages); end
 
+    # source://packwerk//lib/packwerk/package_set.rb#68
     sig { params(globs: T::Array[::String], path: ::Pathname).returns(T::Boolean) }
     def exclude_path?(globs, path); end
   end
 end
 
+# source://packwerk//lib/packwerk/package_set.rb#18
 Packwerk::PackageSet::PACKAGE_CONFIG_FILENAME = T.let(T.unsafe(nil), String)
 
+# source://packwerk//lib/packwerk/package_todo.rb#7
+class Packwerk::PackageTodo
+  # source://packwerk//lib/packwerk/package_todo.rb#15
+  sig { params(package: ::Packwerk::Package, filepath: ::String).void }
+  def initialize(package, filepath); end
+
+  # source://packwerk//lib/packwerk/package_todo.rb#39
+  sig { params(reference: ::Packwerk::Reference, violation_type: ::String).returns(T::Boolean) }
+  def add_entries(reference, violation_type); end
+
+  # source://packwerk//lib/packwerk/package_todo.rb#114
+  sig { void }
+  def delete_if_exists; end
+
+  # source://packwerk//lib/packwerk/package_todo.rb#93
+  sig { void }
+  def dump; end
+
+  # source://packwerk//lib/packwerk/package_todo.rb#26
+  sig { params(reference: ::Packwerk::Reference, violation_type: ::String).returns(T::Boolean) }
+  def listed?(reference, violation_type:); end
+
+  # source://packwerk//lib/packwerk/package_todo.rb#54
+  sig { params(for_files: T::Set[::String]).returns(T::Boolean) }
+  def stale_violations?(for_files); end
+
+  private
+
+  # source://packwerk//lib/packwerk/package_todo.rb#143
+  sig { params(filepath: ::String).returns(T::Hash[::String, T.untyped]) }
+  def load_yaml(filepath); end
+
+  # source://packwerk//lib/packwerk/package_todo.rb#121
+  sig { returns(T::Hash[::String, T.untyped]) }
+  def prepare_entries_for_dump; end
+
+  # source://packwerk//lib/packwerk/package_todo.rb#134
+  sig { returns(T::Hash[::String, T.untyped]) }
+  def todo_list; end
+end
+
+# source://packwerk//lib/packwerk/package_todo.rb#10
+Packwerk::PackageTodo::EntriesType = T.type_alias { T::Hash[::String, T.untyped] }
+
+# source://packwerk//lib/packwerk/parse_run.rb#7
 class Packwerk::ParseRun
+  # source://packwerk//lib/packwerk/parse_run.rb#23
   sig do
     params(
       relative_file_set: T::Set[::String],
       configuration: ::Packwerk::Configuration,
-      progress_formatter: ::Packwerk::Formatters::ProgressFormatter,
-      offenses_formatter: ::Packwerk::OffensesFormatter
+      file_set_specified: T::Boolean,
+      offenses_formatter: T.nilable(::Packwerk::OffensesFormatter),
+      progress_formatter: ::Packwerk::Formatters::ProgressFormatter
     ).void
   end
-  def initialize(relative_file_set:, configuration:, progress_formatter: T.unsafe(nil), offenses_formatter: T.unsafe(nil)); end
+  def initialize(relative_file_set:, configuration:, file_set_specified: T.unsafe(nil), offenses_formatter: T.unsafe(nil), progress_formatter: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/parse_run.rb#61
   sig { returns(::Packwerk::Result) }
   def check; end
 
+  # source://packwerk//lib/packwerk/parse_run.rb#39
   sig { returns(::Packwerk::Result) }
-  def detect_stale_violations; end
-
-  sig { returns(::Packwerk::Result) }
-  def update_deprecations; end
+  def update_todo; end
 
   private
 
-  sig { params(show_errors: T::Boolean).returns(::Packwerk::OffenseCollection) }
-  def find_offenses(show_errors: T.unsafe(nil)); end
+  # source://packwerk//lib/packwerk/parse_run.rb#80
+  sig { params(run_context: ::Packwerk::RunContext, show_errors: T::Boolean).returns(::Packwerk::OffenseCollection) }
+  def find_offenses(run_context, show_errors: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/parse_run.rb#103
   sig do
     params(
       block: T.proc.params(path: ::String).returns(T::Array[::Packwerk::Offense])
@@ -1087,106 +1524,159 @@ class Packwerk::ParseRun
   end
   def serial_find_offenses(&block); end
 
+  # source://packwerk//lib/packwerk/parse_run.rb#118
   sig { params(failed: T::Boolean).void }
   def update_progress(failed: T.unsafe(nil)); end
 end
 
+# source://packwerk//lib/packwerk/parse_run.rb#10
 Packwerk::ParseRun::ProcessFileProc = T.type_alias { T.proc.params(path: ::String).returns(T::Array[::Packwerk::Offense]) }
 
 # A collection of constant definitions parsed from an Abstract Syntax Tree (AST).
+#
+# source://packwerk//lib/packwerk/parsed_constant_definitions.rb#8
 class Packwerk::ParsedConstantDefinitions
   # @return [ParsedConstantDefinitions] a new instance of ParsedConstantDefinitions
+  #
+  # source://packwerk//lib/packwerk/parsed_constant_definitions.rb#24
   def initialize(root_node:); end
 
   # @return [Boolean]
+  #
+  # source://packwerk//lib/packwerk/parsed_constant_definitions.rb#30
   def local_reference?(constant_name, location: T.unsafe(nil), namespace_path: T.unsafe(nil)); end
 
   private
 
+  # source://packwerk//lib/packwerk/parsed_constant_definitions.rb#58
   def add_definition(constant_name, current_namespace_path, location); end
+
+  # source://packwerk//lib/packwerk/parsed_constant_definitions.rb#41
   def collect_local_definitions_from_root(node, current_namespace_path = T.unsafe(nil)); end
 
   class << self
     # What fully qualified constants can this constant refer to in this context?
+    #
+    # source://packwerk//lib/packwerk/parsed_constant_definitions.rb#11
     def reference_qualifications(constant_name, namespace_path:); end
   end
 end
 
+# source://packwerk//lib/packwerk/parsers.rb#5
 module Packwerk::Parsers; end
 
+# source://packwerk//lib/packwerk/parsers/erb.rb#11
 class Packwerk::Parsers::Erb
   include ::Packwerk::Parsers::ParserInterface
 
   # @return [Erb] a new instance of Erb
+  #
+  # source://packwerk//lib/packwerk/parsers/erb.rb#14
   def initialize(parser_class: T.unsafe(nil), ruby_parser: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/parsers/erb.rb#19
   def call(io:, file_path: T.unsafe(nil)); end
+
+  # source://packwerk//lib/packwerk/parsers/erb.rb#25
   def parse_buffer(buffer, file_path:); end
 
   private
 
   # @yield [node]
+  #
+  # source://packwerk//lib/packwerk/parsers/erb.rb#52
   def code_nodes(node, &block); end
 
+  # source://packwerk//lib/packwerk/parsers/erb.rb#38
   def to_ruby_ast(erb_ast, file_path); end
 end
 
+# source://packwerk//lib/packwerk/parsers/factory.rb#8
 class Packwerk::Parsers::Factory
   include ::Singleton
   extend ::Singleton::SingletonClassMethods
 
+  # source://packwerk//lib/packwerk/parsers/factory.rb#33
   def erb_parser_class; end
+
+  # source://packwerk//lib/packwerk/parsers/factory.rb#37
   def erb_parser_class=(klass); end
 
+  # source://packwerk//lib/packwerk/parsers/factory.rb#24
   sig { params(path: ::String).returns(T.nilable(::Packwerk::Parsers::ParserInterface)) }
   def for_path(path); end
 end
 
+# source://packwerk//lib/packwerk/parsers/factory.rb#20
 Packwerk::Parsers::Factory::ERB_REGEX = T.let(T.unsafe(nil), Regexp)
+
+# source://packwerk//lib/packwerk/parsers/factory.rb#12
 Packwerk::Parsers::Factory::RUBY_REGEX = T.let(T.unsafe(nil), Regexp)
 
+# source://packwerk//lib/packwerk/parsers.rb#13
 class Packwerk::Parsers::ParseError < ::StandardError
   # @return [ParseError] a new instance of ParseError
+  #
+  # source://packwerk//lib/packwerk/parsers.rb#16
   def initialize(result); end
 
   # Returns the value of attribute result.
+  #
+  # source://packwerk//lib/packwerk/parsers.rb#14
   def result; end
 end
 
+# source://packwerk//lib/packwerk/parsers.rb#11
 class Packwerk::Parsers::ParseResult < ::Packwerk::Offense; end
 
 # @abstract Subclasses must implement the `abstract` methods below.
+#
+# source://packwerk//lib/packwerk/parsers/parser_interface.rb#6
 module Packwerk::Parsers::ParserInterface
   requires_ancestor { Kernel }
 
   interface!
 
   # @abstract
+  #
+  # source://packwerk//lib/packwerk/parsers/parser_interface.rb#15
   sig { abstract.params(io: ::File, file_path: ::String).returns(T.untyped) }
   def call(io:, file_path:); end
 end
 
+# source://packwerk//lib/packwerk/parsers/ruby.rb#9
 class Packwerk::Parsers::Ruby
   include ::Packwerk::Parsers::ParserInterface
 
   # @return [Ruby] a new instance of Ruby
+  #
+  # source://packwerk//lib/packwerk/parsers/ruby.rb#25
   def initialize(parser_class: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/parsers/ruby.rb#30
   def call(io:, file_path: T.unsafe(nil)); end
 end
 
+# source://packwerk//lib/packwerk/parsers/ruby.rb#12
 class Packwerk::Parsers::Ruby::RaiseExceptionsParser < ::Parser::Ruby27
   # @return [RaiseExceptionsParser] a new instance of RaiseExceptionsParser
+  #
+  # source://packwerk//lib/packwerk/parsers/ruby.rb#13
   def initialize(builder); end
 end
 
+# source://packwerk//lib/packwerk/parsers/ruby.rb#19
 class Packwerk::Parsers::Ruby::TolerateInvalidUtf8Builder < ::Parser::Builders::Default
+  # source://packwerk//lib/packwerk/parsers/ruby.rb#20
   def string_value(token); end
 end
 
+# source://packwerk//lib/packwerk/package_set.rb#8
 Packwerk::PathSpec = T.type_alias { T.any(::String, T::Array[::String]) }
 
 # A reference from a file in one package to a constant that may be defined in a different package.
+#
+# source://packwerk//lib/packwerk/reference.rb#6
 class Packwerk::Reference < ::Struct
   # Returns the value of attribute constant
   #
@@ -1197,8 +1687,23 @@ class Packwerk::Reference < ::Struct
   #
   # @param value [Object] the value to set the attribute constant to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/reference.rb#6
   def constant=(_); end
 
+  # Returns the value of attribute package
+  #
+  # @return [Object] the current value of package
+  def package; end
+
+  # Sets the attribute package
+  #
+  # @param value [Object] the value to set the attribute package to.
+  # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/reference.rb#6
+  def package=(_); end
+
   # Returns the value of attribute relative_path
   #
   # @return [Object] the current value of relative_path
@@ -1208,6 +1713,8 @@ class Packwerk::Reference < ::Struct
   #
   # @param value [Object] the value to set the attribute relative_path to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/reference.rb#6
   def relative_path=(_); end
 
   # Returns the value of attribute source_location
@@ -1219,18 +1726,9 @@ class Packwerk::Reference < ::Struct
   #
   # @param value [Object] the value to set the attribute source_location to.
   # @return [Object] the newly set value
-  def source_location=(_); end
-
-  # Returns the value of attribute source_package
   #
-  # @return [Object] the current value of source_package
-  def source_package; end
-
-  # Sets the attribute source_package
-  #
-  # @param value [Object] the value to set the attribute source_package to.
-  # @return [Object] the newly set value
-  def source_package=(_); end
+  # source://packwerk//lib/packwerk/reference.rb#6
+  def source_location=(_); end
 
   class << self
     def [](*_arg0); end
@@ -1240,85 +1738,64 @@ class Packwerk::Reference < ::Struct
   end
 end
 
+# source://packwerk//lib/packwerk.rb#79
 module Packwerk::ReferenceChecking
   extend ::ActiveSupport::Autoload
 end
 
+# source://packwerk//lib/packwerk.rb#84
 module Packwerk::ReferenceChecking::Checkers
   extend ::ActiveSupport::Autoload
 end
 
-# @abstract Subclasses must implement the `abstract` methods below.
-module Packwerk::ReferenceChecking::Checkers::Checker
-  abstract!
-
-  # @abstract
-  sig { abstract.params(reference: ::Packwerk::Reference).returns(T::Boolean) }
-  def invalid_reference?(reference); end
-
-  # @abstract
-  sig { abstract.params(reference: ::Packwerk::Reference).returns(::String) }
-  def message(reference); end
-
-  sig { params(reference: ::Packwerk::Reference).returns(::String) }
-  def standard_help_message(reference); end
-
-  # @abstract
-  sig { abstract.returns(::Packwerk::ViolationType) }
-  def violation_type; end
-end
-
 # Checks whether a given reference conforms to the configured graph of dependencies.
+#
+# source://packwerk//lib/packwerk/reference_checking/checkers/dependency_checker.rb#8
 class Packwerk::ReferenceChecking::Checkers::DependencyChecker
-  include ::Packwerk::ReferenceChecking::Checkers::Checker
+  include ::Packwerk::Checker
 
+  # source://packwerk//lib/packwerk/reference_checking/checkers/dependency_checker.rb#24
   sig { override.params(reference: ::Packwerk::Reference).returns(T::Boolean) }
   def invalid_reference?(reference); end
 
+  # source://packwerk//lib/packwerk/reference_checking/checkers/dependency_checker.rb#36
   sig { override.params(reference: ::Packwerk::Reference).returns(::String) }
   def message(reference); end
 
-  sig { override.returns(::Packwerk::ViolationType) }
-  def violation_type; end
-end
-
-# Checks whether a given reference references a private constant of another package.
-class Packwerk::ReferenceChecking::Checkers::PrivacyChecker
-  include ::Packwerk::ReferenceChecking::Checkers::Checker
-
-  sig { override.params(reference: ::Packwerk::Reference).returns(T::Boolean) }
-  def invalid_reference?(reference); end
-
-  sig { override.params(reference: ::Packwerk::Reference).returns(::String) }
-  def message(reference); end
+  # source://packwerk//lib/packwerk/reference_checking/checkers/dependency_checker.rb#51
+  sig { override.params(listed_offense: ::Packwerk::ReferenceOffense).returns(T::Boolean) }
+  def strict_mode_violation?(listed_offense); end
 
-  sig { override.returns(::Packwerk::ViolationType) }
+  # source://packwerk//lib/packwerk/reference_checking/checkers/dependency_checker.rb#15
+  sig { override.returns(::String) }
   def violation_type; end
 
   private
 
-  sig { params(privacy_option: T.nilable(T.any(T::Array[::String], T::Boolean))).returns(T::Boolean) }
-  def enforcement_disabled?(privacy_option); end
-
-  sig do
-    params(
-      constant: ::Packwerk::ConstantDiscovery::ConstantContext,
-      explicitly_private_constants: T::Array[::String]
-    ).returns(T::Boolean)
-  end
-  def explicitly_private_constant?(constant, explicitly_private_constants:); end
+  # source://packwerk//lib/packwerk/reference_checking/checkers/dependency_checker.rb#59
+  sig { params(reference: ::Packwerk::Reference).returns(::String) }
+  def standard_help_message(reference); end
 end
 
+# source://packwerk//lib/packwerk/reference_checking/checkers/dependency_checker.rb#12
+Packwerk::ReferenceChecking::Checkers::DependencyChecker::VIOLATION_TYPE = T.let(T.unsafe(nil), String)
+
+# source://packwerk//lib/packwerk/reference_checking/reference_checker.rb#6
 class Packwerk::ReferenceChecking::ReferenceChecker
-  sig { params(checkers: T::Array[::Packwerk::ReferenceChecking::Checkers::Checker]).void }
+  # source://packwerk//lib/packwerk/reference_checking/reference_checker.rb#10
+  sig { params(checkers: T::Array[::Packwerk::Checker]).void }
   def initialize(checkers); end
 
+  # source://packwerk//lib/packwerk/reference_checking/reference_checker.rb#19
   sig { params(reference: ::Packwerk::Reference).returns(T::Array[::Packwerk::Offense]) }
   def call(reference); end
 end
 
 # Extracts a possible constant reference from a given AST node.
+#
+# source://packwerk//lib/packwerk/reference_extractor.rb#6
 class Packwerk::ReferenceExtractor
+  # source://packwerk//lib/packwerk/reference_extractor.rb#59
   sig do
     params(
       constant_name_inspectors: T::Array[::Packwerk::ConstantNameInspector],
@@ -1328,6 +1805,7 @@ class Packwerk::ReferenceExtractor
   end
   def initialize(constant_name_inspectors:, root_node:, root_path:); end
 
+  # source://packwerk//lib/packwerk/reference_extractor.rb#76
   sig do
     params(
       node: ::Parser::AST::Node,
@@ -1340,8 +1818,11 @@ class Packwerk::ReferenceExtractor
   private
 
   # @return [Boolean]
+  #
+  # source://packwerk//lib/packwerk/reference_extractor.rb#120
   def local_reference?(constant_name, name_location, namespace_path); end
 
+  # source://packwerk//lib/packwerk/reference_extractor.rb#105
   sig do
     params(
       constant_name: ::String,
@@ -1353,6 +1834,7 @@ class Packwerk::ReferenceExtractor
   def reference_from_constant(constant_name, node:, ancestors:, relative_file:); end
 
   class << self
+    # source://packwerk//lib/packwerk/reference_extractor.rb#18
     sig do
       params(
         unresolved_references: T::Array[::Packwerk::UnresolvedReference],
@@ -1364,35 +1846,45 @@ class Packwerk::ReferenceExtractor
 end
 
 # An offense related to a {Packwerk::Reference}.
+#
+# source://packwerk//lib/packwerk/reference_offense.rb#6
 class Packwerk::ReferenceOffense < ::Packwerk::Offense
+  # source://packwerk//lib/packwerk/reference_offense.rb#25
   sig do
     params(
       reference: ::Packwerk::Reference,
-      violation_type: ::Packwerk::ViolationType,
+      violation_type: ::String,
       message: ::String,
       location: T.nilable(::Packwerk::Node::Location)
     ).void
   end
   def initialize(reference:, violation_type:, message:, location: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/reference_offense.rb#11
   sig { returns(::Packwerk::Reference) }
   def reference; end
 
-  sig { returns(::Packwerk::ViolationType) }
+  # source://packwerk//lib/packwerk/reference_offense.rb#14
+  sig { returns(::String) }
   def violation_type; end
 end
 
+# source://packwerk//lib/packwerk/result.rb#5
 class Packwerk::Result < ::T::Struct
   const :message, ::String
   const :status, T::Boolean
 
   class << self
+    # source://sorbet-runtime/0.5.10588/lib/types/struct.rb#13
     def inherited(s); end
   end
 end
 
 # Holds the context of a Packwerk run across multiple files.
+#
+# source://packwerk//lib/packwerk/run_context.rb#8
 class Packwerk::RunContext
+  # source://packwerk//lib/packwerk/run_context.rb#46
   sig do
     params(
       root_path: ::String,
@@ -1402,47 +1894,55 @@ class Packwerk::RunContext
       config_path: T.nilable(::String),
       package_paths: T.nilable(T.any(::String, T::Array[::String])),
       custom_associations: T.any(T::Array[::Symbol], T::Set[::Symbol]),
-      checkers: T::Array[::Packwerk::ReferenceChecking::Checkers::Checker],
+      checkers: T::Array[::Packwerk::Checker],
       cache_enabled: T::Boolean
     ).void
   end
   def initialize(root_path:, load_paths:, inflector:, cache_directory:, config_path: T.unsafe(nil), package_paths: T.unsafe(nil), custom_associations: T.unsafe(nil), checkers: T.unsafe(nil), cache_enabled: T.unsafe(nil)); end
 
+  # source://packwerk//lib/packwerk/run_context.rb#90
+  sig { returns(Packwerk::PackageSet) }
+  def package_set; end
+
+  # source://packwerk//lib/packwerk/run_context.rb#77
   sig { params(relative_file: ::String).returns(T::Array[::Packwerk::Offense]) }
   def process_file(relative_file:); end
 
   private
 
+  # source://packwerk//lib/packwerk/run_context.rb#128
   sig { returns(T::Array[::Packwerk::ConstantNameInspector]) }
   def constant_name_inspectors; end
 
+  # source://packwerk//lib/packwerk/run_context.rb#111
   sig { returns(::Packwerk::ConstantDiscovery) }
   def context_provider; end
 
+  # source://packwerk//lib/packwerk/run_context.rb#97
   sig { returns(::Packwerk::FileProcessor) }
   def file_processor; end
 
+  # source://packwerk//lib/packwerk/run_context.rb#102
   sig { returns(::Packwerk::NodeProcessorFactory) }
   def node_processor_factory; end
 
-  sig { returns(Packwerk::PackageSet) }
-  def package_set; end
-
+  # source://packwerk//lib/packwerk/run_context.rb#119
   sig { returns(::ConstantResolver) }
   def resolver; end
 
   class << self
+    # source://packwerk//lib/packwerk/run_context.rb#17
     sig { params(configuration: ::Packwerk::Configuration).returns(::Packwerk::RunContext) }
     def from_configuration(configuration); end
   end
 end
 
-Packwerk::RunContext::DEFAULT_CHECKERS = T.let(T.unsafe(nil), Array)
-
 # An unresolved reference from a file in one package to a constant that may be defined in a different package.
 # Unresolved means that we know how it's referred to in the file,
 # and we have enough context on that reference to figure out the fully qualified reference such that we
 # can produce a Reference in a separate pass. However, we have not yet resolved it to its fully qualified version.
+#
+# source://packwerk//lib/packwerk/unresolved_reference.rb#9
 class Packwerk::UnresolvedReference < ::Struct
   # Returns the value of attribute constant_name
   #
@@ -1453,6 +1953,8 @@ class Packwerk::UnresolvedReference < ::Struct
   #
   # @param value [Object] the value to set the attribute constant_name to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/unresolved_reference.rb#9
   def constant_name=(_); end
 
   # Returns the value of attribute namespace_path
@@ -1464,6 +1966,8 @@ class Packwerk::UnresolvedReference < ::Struct
   #
   # @param value [Object] the value to set the attribute namespace_path to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/unresolved_reference.rb#9
   def namespace_path=(_); end
 
   # Returns the value of attribute relative_path
@@ -1475,6 +1979,8 @@ class Packwerk::UnresolvedReference < ::Struct
   #
   # @param value [Object] the value to set the attribute relative_path to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/unresolved_reference.rb#9
   def relative_path=(_); end
 
   # Returns the value of attribute source_location
@@ -1486,6 +1992,8 @@ class Packwerk::UnresolvedReference < ::Struct
   #
   # @param value [Object] the value to set the attribute source_location to.
   # @return [Object] the newly set value
+  #
+  # source://packwerk//lib/packwerk/unresolved_reference.rb#9
   def source_location=(_); end
 
   class << self
@@ -1496,11 +2004,124 @@ class Packwerk::UnresolvedReference < ::Struct
   end
 end
 
+# source://packwerk//lib/packwerk/version.rb#5
 Packwerk::VERSION = T.let(T.unsafe(nil), String)
 
-class Packwerk::ViolationType < ::T::Enum
-  enums do
-    Privacy = new
-    Dependency = new
+# @abstract Subclasses must implement the `abstract` methods below.
+#
+# source://packwerk//lib/packwerk/validator.rb#9
+module Packwerk::Validator
+  abstract!
+
+  # @abstract
+  #
+  # source://packwerk//lib/packwerk/validator.rb#36
+  sig do
+    abstract
+      .params(
+        package_set: Packwerk::PackageSet,
+        configuration: ::Packwerk::Configuration
+      ).returns(::Packwerk::ApplicationValidator::Result)
+  end
+  def call(package_set, configuration); end
+
+  # source://packwerk//lib/packwerk/validator.rb#67
+  sig do
+    params(
+      results: T::Array[::Packwerk::ApplicationValidator::Result],
+      separator: ::String,
+      before_errors: ::String,
+      after_errors: ::String
+    ).returns(::Packwerk::ApplicationValidator::Result)
+  end
+  def merge_results(results, separator: T.unsafe(nil), before_errors: T.unsafe(nil), after_errors: T.unsafe(nil)); end
+
+  # source://packwerk//lib/packwerk/validator.rb#55
+  sig { params(configuration: ::Packwerk::Configuration).returns(T.any(::String, T::Array[::String])) }
+  def package_glob(configuration); end
+
+  # source://packwerk//lib/packwerk/validator.rb#48
+  sig do
+    params(
+      configuration: ::Packwerk::Configuration,
+      glob_pattern: T.nilable(T.any(::String, T::Array[::String]))
+    ).returns(T::Array[::String])
   end
+  def package_manifests(configuration, glob_pattern = T.unsafe(nil)); end
+
+  # source://packwerk//lib/packwerk/validator.rb#40
+  sig { params(configuration: ::Packwerk::Configuration, setting: T.untyped).returns(T.untyped) }
+  def package_manifests_settings_for(configuration, setting); end
+
+  # @abstract
+  #
+  # source://packwerk//lib/packwerk/validator.rb#32
+  sig { abstract.returns(T::Array[::String]) }
+  def permitted_keys; end
+
+  # source://packwerk//lib/packwerk/validator.rb#86
+  sig { params(configuration: ::Packwerk::Configuration, path: ::String).returns(::Pathname) }
+  def relative_path(configuration, path); end
+
+  class << self
+    # source://packwerk//lib/packwerk/validator.rb#26
+    sig { returns(T::Array[::Packwerk::Validator]) }
+    def all; end
+
+    # source://packwerk//lib/packwerk/validator.rb#19
+    sig { params(base: ::Class).void }
+    def included(base); end
+  end
+end
+
+# source://packwerk//lib/packwerk/validators/dependency_validator.rb#5
+module Packwerk::Validators; end
+
+# source://packwerk//lib/packwerk/validators/dependency_validator.rb#6
+class Packwerk::Validators::DependencyValidator
+  include ::Packwerk::Validator
+
+  # source://packwerk//lib/packwerk/validators/dependency_validator.rb#13
+  sig do
+    override
+      .params(
+        package_set: Packwerk::PackageSet,
+        configuration: ::Packwerk::Configuration
+      ).returns(::Packwerk::ApplicationValidator::Result)
+  end
+  def call(package_set, configuration); end
+
+  # source://packwerk//lib/packwerk/validators/dependency_validator.rb#24
+  sig { override.returns(T::Array[::String]) }
+  def permitted_keys; end
+
+  private
+
+  # Convert the cycles:
+  #
+  #   [[a, b, c], [b, c]]
+  #
+  # to the string:
+  #
+  #   ["a -> b -> c -> a", "b -> c -> b"]
+  #
+  # source://packwerk//lib/packwerk/validators/dependency_validator.rb#144
+  sig { params(cycles: T.untyped).returns(T::Array[::String]) }
+  def build_cycle_strings(cycles); end
+
+  # source://packwerk//lib/packwerk/validators/dependency_validator.rb#66
+  sig { params(package_set: Packwerk::PackageSet).returns(::Packwerk::ApplicationValidator::Result) }
+  def check_acyclic_graph(package_set); end
+
+  # source://packwerk//lib/packwerk/validators/dependency_validator.rb#34
+  sig { params(configuration: ::Packwerk::Configuration).returns(::Packwerk::ApplicationValidator::Result) }
+  def check_package_manifest_syntax(configuration); end
+
+  # source://packwerk//lib/packwerk/validators/dependency_validator.rb#92
+  sig { params(configuration: ::Packwerk::Configuration).returns(::Packwerk::ApplicationValidator::Result) }
+  def check_valid_package_dependencies(configuration); end
+
+  # source://packwerk//lib/packwerk/validators/dependency_validator.rb#128
+  sig { params(configuration: ::Packwerk::Configuration, path: T.untyped).returns(T::Boolean) }
+  def invalid_package_path?(configuration, path); end
 end