Group offenses together about packwerk

[exterm]

Should probably be implemented as an additional output formatter, so that we can switch between both formats and allow users to keep the old format if they depend on it.

[Epigene]

This would definitely be useful.
I'm only using packwerk for dependency enforcement, so here's my two cents - implement some packwerk check --concise flag that changes output from:

packs/awards/app/graphql/events/award/options/mutations/reorder.rb:20:14
Dependency violation: ::Order belongs to 'app/services', but 'packs/awards/app/graphql' does not specify a dependency on 'app/services'.
Are we missing an abstraction?
Is the code making the reference, and the referenced constant, in the right packages?

Inference details: this is a reference to ::Order which seems to be defined in app/services/order.rb.
To receive help interpreting or resolving this error message, see: https://github.com/Shopify/packwerk/blob/main/TROUBLESHOOT.md#Troubleshooting-violations


packs/awards/app/graphql/events/award/options/mutations/reorder.rb:21:14
Dependency violation: ::User belongs to 'app/models', but 'packs/awards/app/graphql' does not specify a dependency on 'app/models'.
Are we missing an abstraction?
Is the code making the reference, and the referenced constant, in the right packages?

Inference details: this is a reference to ::User which seems to be defined in app/models/user.rb.
To receive help interpreting or resolving this error message, see: https://github.com/Shopify/packwerk/blob/main/TROUBLESHOOT.md#Troubleshooting-violations


packs/awards/app/graphql/events/award/options_resolver.rb:27:10
Dependency violation: ::Filters::FilteredScope belongs to 'app/services', but 'packs/awards/app/graphql' does not specify a dependency on 'app/services'.
Are we missing an abstraction?
Is the code making the reference, and the referenced constant, in the right packages?

Inference details: this is a reference to ::Filters::FilteredScope which seems to be defined in app/services/filters/filtered_scope.rb.
To receive help interpreting or resolving this error message, see: https://github.com/Shopify/packwerk/blob/main/TROUBLESHOOT.md#Troubleshooting-violations

to:

'packs/awards/app/graphql' unspecified dependencies:
  - 'app/models'
  - 'app/services'  

This way it's straightforward to judge which pack(s) have dependency problems, especially after moving existing code to a new pack or when defining sub-packs.

[alexevanczuk]

@Epigene Something to consider if you want this new format sooner or you want it to say something very specific to your org is that you can create your own offenses formatter and pass that in. At Gusto, this is what we do to layer in more specific Gusto information like the team that owns the package in question. Let me know if you need any help with this!

Separately, out of curiosity, are you making your models and services separate packs? We have divided up our app by domain, including putting models for a domain in its domain pack, so would be interesting to chat more and share strategies. You're welcome to join the Ruby/Rails Modularity Slack Server if you want to chat more!