devex 0.3.5 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84ad9665940ea65a5cc4a61faae1f7bbd9bd2ef3a0f4285266c0b52e8e4dca59
-  data.tar.gz: 14490de8537dffb0ff12c0885468fd20dc7e2f1f358cae4be1029514090e3ccf
+  metadata.gz: bc08d4252d01321b4ff62342728ebd41f7537c491dd67138a9df088957cc0ca7
+  data.tar.gz: ade9646e3cae9285a6d0a1963de71781cfeb07d22f8a4dd5468184090a26d033
 SHA512:
-  metadata.gz: a8f2026afeef91196bfc941c8f7ac22ff6622e3873aeb8d6b8f349b799a4a76d98f2c87e2c0384dbc77029d2f5f15f8b1643d464457c43641e6f4487f0152f50
-  data.tar.gz: 3d2e26b6df93ed0171ed9982e287e331588f47f81d3e25b07016f35c5e86860d6a3d5af3368d91d9c3ca8365a0ec7e3b4ffc18a32f17fb72400c1ab3309a2027
+  metadata.gz: 1e3e6e616f114b45a2b57d515cf2c5865a489024e3d2ee9ca1fc42120980dd338ad0ed3291e7df842854a9208c9e1856f831f2c314d61bd4445db3a43fb78012
+  data.tar.gz: 7a666b9aa04a22b3666c060f566dac967a9ed44e45725c87856bf1c5cdd80a5e3e739bb813e4e7be0efcbba616208712a476ca8d3858abb5d3954e33aab092e9

data/.rubocop.yml

@@ -1,40 +1,24 @@
-# Archema RuboCop Configuration
+# Devex RuboCop Configuration
 #
-# Layout/alignment settings come from tablecop.
-# This file contains archema-specific settings.
+# Inherits from the shared rubocop-dx.yml base config.
+# This file contains devex-specific overrides only.
 
-plugins:
-  - rubocop-minitest
-  - rubocop-tablecop
+inherit_from: config/rubocop-dx.yml
 
 AllCops:
   TargetRubyVersion: 3.3
-  NewCops: enable
-  SuggestExtensions: false
   Exclude:
     - "tmp/**/*"
     - "vendor/**/*"
     - "coverage/**/*"
     - "examples/**/*"
-    - "docs/msc/**/*"  # Experimental analysis scripts, not production code
+    - "config/**/*"     # YAML config files, not Ruby
+    - "docs/msc/**/*"   # Experimental analysis scripts, not production code
 
 # ─────────────────────────────────────────────────────────────────────────────
-# Style
+# Project-specific overrides
 # ─────────────────────────────────────────────────────────────────────────────
 
-# Allow both single and double quotes - use double by convention,
-# single when semantically meaningful (e.g., JSON-style string keys)
-Style/StringLiterals:
-  Enabled: false
-
-# Prefer explicit bracket syntax for symbol arrays
-Style/SymbolArray:
-  EnforcedStyle: brackets
-
-# Prefer %w[] for word arrays
-Style/WordArray:
-  EnforcedStyle: percent
-
 # Require class/module documentation (except for internal modules)
 Style/Documentation:
   Enabled: true
@@ -42,190 +26,4 @@ Style/Documentation:
     - ClassMethods  # Internal mixin modules don't need separate docs
     - DSL           # DSL namespace modules documented at parent level
   Exclude:
-    - "lib/archema/schema/differ.rb"    # Operation classes are internal data structures
-    - "lib/archema/shared_types.rb"     # Module reopening, documented in main file
-    - "lib/archema/stores.rb"           # Module reopening, documented in main file
-    - "test/**/*"                       # Test classes don't need documentation
-
-# Allow multi-line block chains when readable
-Style/MultilineBlockChain:
-  Enabled: false
-
-# DANGEROUS: Autocorrect converts !!value to !value.nil? which has
-# different semantics for boolean values (!!false → false, !false.nil? → true)
-Style/DoubleNegation:
-  Enabled: false
-
-# DANGEROUS: Changes semantics with mixed key types.
-# reject { |k, _| keys.include?(k) } handles symbol/string keys correctly,
-# but hash.except(*keys) treats :key and "key" as different.
-Style/HashExcept:
-  Enabled: false
-
-# DANGEROUS: Converts `Module % [args]` to `format(Module, args)` which breaks
-# custom % methods (like ANSI % ["text", :style] for nested color spans).
-Style/FormatString:
-  Enabled: false
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Layout
-# ─────────────────────────────────────────────────────────────────────────────
-
-Layout/LineLength:
-  Max: 140
-
-# Allow RBS inline type comments like #: Type
-Layout/LeadingCommentSpace:
-  AllowRBSInlineAnnotation: true
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Naming
-# ─────────────────────────────────────────────────────────────────────────────
-
-# DISABLED: Renames @data_layer_instance to @data_layer, but tests
-# use instance_variable_set(:@data_layer_instance, nil) to reset state.
-Naming/MemoizedInstanceVariableName:
-  Enabled: false
-
-# DISABLED: Too pedantic about underscores in numbers (last_5, chain_from_11, 1_0_0)
-Naming/VariableNumber:
-  Enabled: false
-
-# Allow common short parameter names
-Naming/MethodParameterName:
-  AllowedNames:
-    - a
-    - b
-    - c
-    - e   # exception, element, entry
-    - i   # index
-    - j   # secondary index
-    - k   # key
-    - v   # value
-    - h   # hash
-    - n   # number, count
-    - x   # coordinate, generic
-    - y   # coordinate
-    - id  # identifier
-    - io  # IO object
-    - op  # operation
-    - db  # database
-    - fn  # function
-    - s1  # string comparison (levenshtein)
-    - s2  # string comparison (levenshtein)
-    - sc  # sub_constraint in composition constraints
-    - ds  # dataset (Sequel)
-    - to  # destination (from:, to:)
-    - of  # element type (array of:)
-    - _   # explicitly unused
-
-# Allow has_* prefix for methods that genuinely "have" something (not just predicates)
-# has_default?, has_role?, etc. are clearer than default?, role? in context
-Naming/PredicatePrefix:
-  AllowedMethods:
-    - has_default?
-    - has_role?
-    - has_managed_data?
-    - has_cardinality_constraints?
-    - has_temporal_defaults?
-    - has_irreversible_operations?
-    - has_one       # DSL method: has_one :profile, Profile
-    - has_many      # DSL method: has_many :posts, Post
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Lint
-# ─────────────────────────────────────────────────────────────────────────────
-
-Lint/UselessAssignment:
-  Enabled: true
-
-# DISABLED: Forces combining case branches that happen to have the same result,
-# but often they represent distinct semantic intents. With tablecop alignment,
-# separate branches read as visual lookup tables which is clearer.
-Lint/DuplicateBranch:
-  Enabled: false
-
-Lint/UnusedMethodArgument:
-  AllowUnusedKeywordArguments: true
-  IgnoreEmptyMethods: true
-
-Lint/MissingSuper:
-  Enabled: false
-
-# DANGEROUS: Removes `require "set"` as "redundant" in Ruby 3.2+, but code
-# using Set.new will fail if Set isn't explicitly required.
-Lint/RedundantRequireStatement:
-  Enabled: false
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Metrics - Lenient thresholds for real-world code
-# ─────────────────────────────────────────────────────────────────────────────
-
-Metrics/MethodLength:
-  Max: 40
-  CountAsOne:
-    - array
-    - hash
-    - heredoc
-  Exclude:
-    - "lib/chiridion/engine/inline_rbs_loader.rb"
-
-Metrics/AbcSize:
-  Max: 50
-  Exclude:
-    - "lib/chiridion/engine/inline_rbs_loader.rb"
-
-Metrics/CyclomaticComplexity:
-  Max: 20
-
-Metrics/PerceivedComplexity:
-  Max: 15
-  Exclude:
-    - "lib/chiridion/engine/inline_rbs_loader.rb"
-
-Metrics/ClassLength:
-  Max: 300
-  CountAsOne:
-    - array
-    - hash
-    - heredoc
-
-Metrics/BlockLength:
-  Max: 40
-  CountAsOne:
-    - array
-    - hash
-    - heredoc
-  Exclude:
-    - "test/**/*"
-    - "spec/**/*"
-    - "features/**/*"
-    - "lib/chiridion/engine/inline_rbs_loader.rb"
-  AllowedMethods:
-    - describe
-    - context
-    - define
-    - configure
-    - namespace
-
-Metrics/ParameterLists:
-  Max: 15
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Minitest
-# ─────────────────────────────────────────────────────────────────────────────
-
-Minitest/EmptyLineBeforeAssertionMethods:
-  Enabled: false
-
-Minitest/MultipleAssertions:
-  Max: 8
-
-# DANGEROUS: Converts `assert obj.foo?` to `assert_predicate obj, :foo?`
-# which breaks refinements since assert_predicate uses send() internally
-# and refinements are lexically scoped (don't work with send).
-Minitest/AssertPredicate:
-  Enabled: false
-
-Minitest/RefutePredicate:
-  Enabled: false
+    - "test/**/*"   # Test classes don't need documentation

data/config/rubocop-dx.yml

@@ -0,0 +1,202 @@
+# rubocop-dx.yml - Devex shared RuboCop configuration
+#
+# Use this as a base for your project's .rubocop.yml:
+#
+#   inherit_gem:
+#     devex: config/rubocop-dx.yml
+#
+#   AllCops:
+#     TargetRubyVersion: 3.3  # Your project's Ruby version
+#
+#   # Project-specific overrides below...
+#
+# Or let `dx lint` use this automatically when no .rubocop.yml exists.
+#
+# Layout/alignment conventions come from rubocop-tablecop.
+# This file contains the rest of the house style.
+
+plugins:
+  - rubocop-minitest
+  - rubocop-tablecop
+
+AllCops:
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - "tmp/**/*"
+    - "vendor/**/*"
+    - "coverage/**/*"
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Style
+# ─────────────────────────────────────────────────────────────────────────────
+
+# Allow both single and double quotes - use double by convention,
+# single when semantically meaningful (e.g., JSON-style string keys)
+Style/StringLiterals:
+  Enabled: false
+
+# Prefer explicit bracket syntax for symbol arrays
+Style/SymbolArray:
+  EnforcedStyle: brackets
+
+# Prefer %w[] for word arrays
+Style/WordArray:
+  EnforcedStyle: percent
+
+# Allow multi-line block chains when readable
+Style/MultilineBlockChain:
+  Enabled: false
+
+# DANGEROUS: Autocorrect converts !!value to !value.nil? which has
+# different semantics for boolean values (!!false -> false, !false.nil? -> true)
+Style/DoubleNegation:
+  Enabled: false
+
+# DANGEROUS: Changes semantics with mixed key types.
+# reject { |k, _| keys.include?(k) } handles symbol/string keys correctly,
+# but hash.except(*keys) treats :key and "key" as different.
+Style/HashExcept:
+  Enabled: false
+
+# DANGEROUS: Converts `Module % [args]` to `format(Module, args)` which breaks
+# custom % methods (like ANSI % ["text", :style] for nested color spans).
+Style/FormatString:
+  Enabled: false
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Layout
+# ─────────────────────────────────────────────────────────────────────────────
+
+Layout/LineLength:
+  Max: 140
+
+# Allow RBS inline type comments like #: Type
+Layout/LeadingCommentSpace:
+  AllowRBSInlineAnnotation: true
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Naming
+# ─────────────────────────────────────────────────────────────────────────────
+
+# DISABLED: Renames @foo_instance to @foo, but tests often use
+# instance_variable_set(:@foo_instance, nil) to reset memoized state.
+Naming/MemoizedInstanceVariableName:
+  Enabled: false
+
+# DISABLED: Too pedantic about underscores in numbers (last_5, chain_from_11)
+Naming/VariableNumber:
+  Enabled: false
+
+# Allow common short parameter names
+Naming/MethodParameterName:
+  AllowedNames:
+    - a
+    - b
+    - c
+    - e   # exception, element, entry
+    - i   # index
+    - j   # secondary index
+    - k   # key
+    - v   # value
+    - h   # hash
+    - n   # number, count
+    - x   # coordinate, generic
+    - y   # coordinate
+    - id  # identifier
+    - io  # IO object
+    - op  # operation
+    - db  # database
+    - fn  # function
+    - to  # destination (from:, to:)
+    - of  # element type (array of:)
+    - _   # explicitly unused
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Lint
+# ─────────────────────────────────────────────────────────────────────────────
+
+# DISABLED: Forces combining case branches that happen to have the same result,
+# but often they represent distinct semantic intents. With tablecop alignment,
+# separate branches read as visual lookup tables which is clearer.
+Lint/DuplicateBranch:
+  Enabled: false
+
+Lint/UnusedMethodArgument:
+  AllowUnusedKeywordArguments: true
+  IgnoreEmptyMethods: true
+
+# DISABLED: Too strict for mixins and decorators
+Lint/MissingSuper:
+  Enabled: false
+
+# DANGEROUS: Removes `require "set"` as "redundant" in Ruby 3.2+, but code
+# using Set.new will fail if Set isn't explicitly required in some contexts.
+Lint/RedundantRequireStatement:
+  Enabled: false
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Metrics - Lenient thresholds for real-world code
+# ─────────────────────────────────────────────────────────────────────────────
+
+Metrics/MethodLength:
+  Max: 40
+  CountAsOne:
+    - array
+    - hash
+    - heredoc
+
+Metrics/AbcSize:
+  Max: 50
+
+Metrics/CyclomaticComplexity:
+  Max: 20
+
+Metrics/PerceivedComplexity:
+  Max: 15
+
+Metrics/ClassLength:
+  Max: 300
+  CountAsOne:
+    - array
+    - hash
+    - heredoc
+
+Metrics/BlockLength:
+  Max: 40
+  CountAsOne:
+    - array
+    - hash
+    - heredoc
+  Exclude:
+    - "test/**/*"
+    - "spec/**/*"
+    - "features/**/*"
+  AllowedMethods:
+    - describe
+    - context
+    - define
+    - configure
+    - namespace
+
+Metrics/ParameterLists:
+  Max: 15
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Minitest
+# ─────────────────────────────────────────────────────────────────────────────
+
+Minitest/EmptyLineBeforeAssertionMethods:
+  Enabled: false
+
+Minitest/MultipleAssertions:
+  Max: 8
+
+# DANGEROUS: Converts `assert obj.foo?` to `assert_predicate obj, :foo?`
+# which breaks refinements since assert_predicate uses send() internally
+# and refinements are lexically scoped (don't work with send).
+Minitest/AssertPredicate:
+  Enabled: false
+
+Minitest/RefutePredicate:
+  Enabled: false

data/lib/devex/builtins/lint.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Uses prj.linter - fails fast with helpful message if not found.
+# Uses prj.linter if present, falls back to bundled rubocop-dx.yml config.
 
 desc "Run linter"
 
@@ -11,6 +11,14 @@ long_desc <<~DESC
     - RuboCop (.rubocop.yml)
     - StandardRB (.standard.yml)
 
+  If no linter config is found, uses the bundled rubocop-dx.yml conventions.
+  Create a .rubocop.yml to customize:
+
+    inherit_gem:
+      devex: config/rubocop-dx.yml
+
+    # Project-specific overrides...
+
   Pass additional arguments after -- to forward to the linter:
     dx lint -- --only=Style/StringLiterals
 DESC
@@ -21,17 +29,31 @@ flag :diff, "-d", "--diff", desc: "Only lint changed files (git diff)"
 remaining_args :files, desc: "Specific files or patterns to lint"
 
 def run
-  # prj.linter fails fast if no .rubocop.yml or .standard.yml found
-  linter_config = prj.linter
+  linter_config = detect_linter
 
-  case linter_config.basename.to_s
-  when ".standard.yml" then run_standardrb
-  when ".rubocop.yml"  then run_rubocop
+  case linter_config
+  when :bundled  then run_rubocop_bundled
+  when :standard then run_standardrb
+  else                run_rubocop
   end
 end
 
 def prj = @prj ||= Devex::ProjectPaths.new
 
+# Detect which linter to use without failing if none found
+def detect_linter
+  standard_yml = prj.root / ".standard.yml"
+  rubocop_yml  = prj.root / ".rubocop.yml"
+
+  if standard_yml.exist?
+    :standard
+  elsif rubocop_yml.exist?
+    :rubocop
+  else
+    :bundled
+  end
+end
+
 def run_rubocop
   args = ["rubocop"]
   args << "-a" if fix && !unsafe
@@ -42,6 +64,22 @@ def run_rubocop
   cmd(*args, chdir: prj.root).exit_on_failure!
 end
 
+def run_rubocop_bundled
+  bundled_config = File.join(Devex.gem_root, "config", "rubocop-dx.yml")
+
+  warn "Using bundled rubocop-dx.yml (no .rubocop.yml found)"
+  warn "  Create .rubocop.yml to customize conventions."
+  warn ""
+
+  args = ["rubocop", "--config", bundled_config.to_s]
+  args << "-a" if fix && !unsafe
+  args << "-A" if unsafe
+  args += changed_files if diff && files.empty?
+  args += files unless files.empty?
+
+  cmd(*args, chdir: prj.root).exit_on_failure!
+end
+
 def run_standardrb
   args = ["standardrb"]
   args << "--fix" if fix || unsafe

data/lib/devex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Devex
-  VERSION = "0.3.5"
+  VERSION = "0.3.6"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: devex
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.3.6
 platform: ruby
 authors:
 - Joseph A Wecker
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-29 00:00:00.000000000 Z
+date: 2026-01-07 00:00:00.000000000 Z
 dependencies: []
 description: |
   Devex provides a unified `dx` command for common development tasks. Features include:
@@ -48,6 +48,7 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- config/rubocop-dx.yml
 - devex-logo.jpg
 - docs/developing-tools.md
 - docs/ref/agent-mode.md