[1.2.0] Add configurable tag sorting and simplify CLI update strategies (#12)

Author: unurgunite

.github/workflows/ci.yml

@@ -33,7 +33,7 @@ jobs:
           cd test_project
           bundle install
           FILES="$(cd .. && git ls-files 'lib/**/*.rb' | sed 's|^|../|')"
-          bundle exec docscribe --dry $FILES -C ../docscribe.yml
+          bundle exec docscribe $FILES -C ../docscribe.yml
 
       - name: RuboCop (self‑check)
         run: bundle exec rubocop

.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-03-17 21:48:54 UTC using RuboCop version 1.84.0.
+# on 2026-03-20 20:43:43 UTC using RuboCop version 1.84.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -13,12 +13,12 @@ Gemspec/DevelopmentDependencies:
   Exclude:
     - 'docscribe.gemspec'
 
-# Offense count: 29
+# Offense count: 34
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 99
+  Max: 113
 
-# Offense count: 5
+# Offense count: 4
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
 # AllowedMethods: refine
 Metrics/BlockLength:
@@ -29,35 +29,35 @@ Metrics/BlockLength:
 Metrics/BlockNesting:
   Max: 4
 
-# Offense count: 2
+# Offense count: 3
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
   Max: 307
 
-# Offense count: 28
+# Offense count: 29
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
   Max: 41
 
-# Offense count: 41
+# Offense count: 55
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 99
+  Max: 122
 
-# Offense count: 3
+# Offense count: 6
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ModuleLength:
-  Max: 309
+  Max: 393
 
-# Offense count: 2
+# Offense count: 8
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
-  Max: 7
+  Max: 9
 
-# Offense count: 22
+# Offense count: 23
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/PerceivedComplexity:
-  Max: 36
+  Max: 45
 
 # Offense count: 9
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
@@ -82,12 +82,12 @@ Naming/PredicateMethod:
 RSpec/DescribeClass:
   Enabled: false
 
-# Offense count: 103
+# Offense count: 113
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 32
 
-# Offense count: 91
+# Offense count: 98
 RSpec/MultipleExpectations:
   Max: 6
 
@@ -98,7 +98,7 @@ SortedMethodsByCall/Waterfall:
   Exclude:
     - 'lib/docscribe/parsing.rb'
 
-# Offense count: 12
+# Offense count: 13
 # Configuration parameters: AllowedConstants.
 Style/Documentation:
   Exclude:
@@ -114,14 +114,16 @@ Style/Documentation:
     - 'lib/docscribe/config/filtering.rb'
     - 'lib/docscribe/config/loader.rb'
     - 'lib/docscribe/config/rbs.rb'
+    - 'lib/docscribe/config/sorting.rb'
     - 'lib/docscribe/config/template.rb'
     - 'lib/docscribe/config/utils.rb'
 
-# Offense count: 2
+# Offense count: 3
 # This cop supports safe autocorrection (--autocorrect).
 Style/IfUnlessModifier:
   Exclude:
     - 'lib/docscribe/config/filtering.rb'
+    - 'lib/docscribe/inline_rewriter.rb'
     - 'lib/docscribe/inline_rewriter/doc_builder.rb'
 
 # Offense count: 6
@@ -130,9 +132,9 @@ Style/SafeNavigationChainLength:
   Exclude:
     - 'lib/docscribe/inline_rewriter/doc_builder.rb'
 
-# Offense count: 6
+# Offense count: 9
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
-  Max: 130
+  Max: 147