gempilot 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d85c949ecc31934a9f30013cf3216e6f5560f83f4847caf1ac7d54fad31556b
-  data.tar.gz: b27b62a0b5491c32152ef170b300fe2a1bebcce9b848936d6472688bacce545f
+  metadata.gz: b4b895f3da5d0d8866cd13f835dd3c1ca71d8d433571c2d7531735636eeb6ad0
+  data.tar.gz: 878dad31a22bdecdb9ff607ebecf2330432070219edfc3e08b66a5022c205d77
 SHA512:
-  metadata.gz: dcda741a835bb6c586adb888ec6e790edd7c7c72029034d161da046b15e187c7934fbe7bfad65481a056a981bf86bda3b4d910ea7181d67fee0968faa423a4dc
-  data.tar.gz: 4f7ac2bad5ab9f332eec6de811d705ea825587a3d4dfbc0dae860e6bdc9520da30fe89dcca3ae3c57d094c0eab2617b535b7d7f17aa7cb9f270ea37b5dbb7f29
+  metadata.gz: ccfc9410fe3ccd3cc8f49e3ca34f68ef334a50183eb95d0788f09c9a5e972fcb4b1244cdfeee188b9898e25ba1c4542d6c4cf24ee24e54edebd4e8b8e907f6a1
+  data.tar.gz: e7deb74172aa7bcd75d84f41ad2d80022d9befcd7f1b69990c6f8b9fe6002168d8b25581242dbded279bdd601986c24552b1431573ff0ed62bec8316734e50fe

data/.rubocop.yml

@@ -15,10 +15,11 @@ plugins:
   - rubocop-performance
   - rubocop-rake
   - rubocop-rspec
+  - rubocop-design
 
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 3.4
+  TargetRubyVersion: 4.0
   Exclude:
     - bin/*
     - vendor/**/*
@@ -279,3 +280,17 @@ RSpec/NamedSubject:
 # have_file_content matcher accepts a filename string in expect()
 RSpec/ExpectActual:
   Enabled: false
+
+Design/PositionalArguments:
+  Enabled: false
+
+Design/KeywordArguments:
+  Enabled: false
+
+Design/TotalArguments:
+  Enabled: false
+
+Design/AgentNounClassName:
+  Exclude:
+    - 'lib/gempilot/generator.rb'
+    - 'test/gempilot/cli/generator_test.rb'

data/CLAUDE.md

@@ -20,6 +20,7 @@ A CLI tool for creating and managing Ruby gems, built on CommandKit.
 - Uses CommandKit::Inflector for name inflection
 - Generator module (`lib/gempilot/cli/generator.rb`) provides template rendering via ERB
 - GemContext module (`lib/gempilot/cli/gem_context.rb`) shared by new, destroy, release, console
+- `GemConstant` value object (`lib/gempilot/gem_constant.rb`) owns constant→namespace/path resolution for `new`/`destroy`; constants are rooted at the gem module by construction
 - CommandKit::Commands::AutoLoad maps filenames in `commands/` to command names
 
 ### Testing
@@ -34,12 +35,4 @@ A CLI tool for creating and managing Ruby gems, built on CommandKit.
 - RuboCop with framework-specific plugins
 - GitHub Actions CI workflow (`.github/workflows/ci.yml`)
 - `git ls-files`-based gemspec with glob fallback for non-git repos
-- Version management rake tasks in `rakelib/version.rake` (current, bump, commit, revert, release:full)
-
-### Notes
-- AutoLoad uses block form in `cli.rb` with explicit `summary:` per command (lazy loading means descriptions aren't available at help time without this)
-
-
-## ISSUES
-
-1. RESOLVED — `exe/gempilot` had unconditional `ENV["BUNDLE_GEMFILE"]` and `require "bundler/setup"`, causing `Gemfile not found` after `gem install`. Removed both lines; RubyGems handles load paths for installed gems. (Ronin avoids this with a conditional `Gemfile.lock` check, but gempilot's `exe/`+`bin/` separation makes that unnecessary.)
+- Version lifecycle rake tasks installed via `Gempilot::VersionTask.new` (a `Rake::TaskLib`): `version:current/bump/commit/tag/untag/reset/revert`, composite `version:release`/`version:unrelease`, and `version:github:release/unrelease/list`

data/issues.rec

@@ -26,7 +26,7 @@ Id: F0833E66-A35C-4054-884B-F90C81F08838
 Updated: Mon, 02 Mar 2026 10:37:33 -0500
 Title: Error handling should be graceful
 Description: I did "gempilot create", and entered "A foo" as the title, and it crashed horrifically. This particular example should have validation at the minimum. Need to also use command kit's error bubbling/handling mechanism to swallow errors and print message to user. Can always use verbose or debug mode to see full trace.
-Status: open
+Status: closed
 
 Id: 741FFD05-9BD7-44EB-BB99-E7D705F12681
 Updated: Mon, 02 Mar 2026 11:25:24 -0500
@@ -68,7 +68,7 @@ Id: 74D0FD90-0421-4452-8591-2798EE6FD23E
 Updated: Sat, 28 Mar 2026 12:59:40 -0400
 Title: Publish gem
 Description: At some point the repo should be moved to public viz, and the gem should be published.
-Status: open
+Status: closed
 
 Id: 8C356024-3122-11F1-89F3-FE6CB9572C2F
 Updated: Mon, 06 Apr 2026 00:00:00 -0400
@@ -141,3 +141,30 @@ Description: "
 + ```
 + "
 Status: closed
+
+Id: 1C46F71C-70E9-11F1-B65B-FE6CB9572C2E
+Updated: Thu, 25 Jun 2026 18:56:32 -0400
+Title: Incorrectly creates test file
+Description: When doing `gempilot new Reversal::Server`, in a project called "reversal-store", I get:
++ 
++  gempilot new class Reversal::Server
++ 
++ Adding class Reversal::Server...
++ 
++         create  lib/reversal/server.rb
++         create  test/reversal/store_test.rb
++ 
++ The test file is incorrectly named. Should be server_test.rb
+Status: open
+
+Id: F5486B48-71DB-11F1-980F-FE6CB9572C2E
+Updated: Fri, 26 Jun 2026 23:54:55 -0400
+Title: Rubymine <=> Minitest usage causes "no reporters allowed error"
+Description: Has to do with how the ENV var RM_INFO is being interpreted
+Status: open
+
+Id: 8D847572-7273-11F1-B508-FE6CB9572C2E
+Updated: Sat, 27 Jun 2026 18:00:04 -0400
+Title: Gem extensions are broken
+Description: when using gempilot on a gem extension, like 'foo-support', using idiomatic ruby patterns for dir structure, gempilot Project class throws an error
+Status: open

data/lib/gempilot/cli/commands/console.rb

@@ -27,9 +27,8 @@ module Gempilot
         end
 
         def print_console_banner
-          puts colors.bright_white("Starting console for ") +
-               colors.bold(colors.cyan(@gem_name)) +
-               colors.bright_white("...")
+          styled_name = colors.bold(colors.cyan(@gem_name))
+          puts colors.bright_white("Starting console for ") + styled_name + colors.bright_white("...")
           puts
         end
       end

data/lib/gempilot/cli/commands/create.rb

@@ -156,7 +156,8 @@ module Gempilot
 
           puts
           puts colors.bright_black("An executable in exe/ lets users run your gem from the command line.")
-          options[:exe] = ask_yes_or_no(colors.green("Create an executable"), default: false)
+          prompt = colors.green("Create an executable")
+          options[:exe] = ask_yes_or_no(prompt, default: false)
         end
 
         def collect_git_options
@@ -169,7 +170,8 @@ module Gempilot
 
           puts
           puts colors.bright_black("Initialize a git repository with an initial commit.")
-          options[:git] = ask_yes_or_no(colors.green("Initialize git repo"), default: true)
+          prompt = colors.green("Initialize git repo")
+          options[:git] = ask_yes_or_no(prompt, default: true)
         end
 
         def collect_branch
@@ -181,8 +183,9 @@ module Gempilot
         end
 
         def print_header
+          styled_name = colors.bold(colors.cyan(@gem_name))
           puts
-          puts colors.bright_white("Creating gem '") + colors.bold(colors.cyan(@gem_name)) + colors.bright_white("'...")
+          puts colors.bright_white("Creating gem '") + styled_name + colors.bright_white("'...")
           puts
         end
 

data/lib/gempilot/cli/commands/destroy.rb

@@ -27,7 +27,7 @@ module Gempilot
         def run(type = nil, path = nil)
           type ||= prompt_for_type
           detect_gem_context
-          path ||= prompt_for_path
+          path ||= prompt_for_path(type)
           dispatch_destroy(type, path)
         end
 
@@ -38,16 +38,14 @@ module Gempilot
           ask_multiple_choice(colors.green("Type"), %w[class module command])
         end
 
-        def prompt_for_path
-          puts
-          puts colors.bright_black("Fully-qualified constant name (e.g., #{@gem_module}::Services::Authentication).")
-          ask(colors.green("Constant"), required: true)
+        def prompt_for_path(type)
+          ask(colors.green(type), required: true)
         end
 
         def dispatch_destroy(type, path)
           case type
-          when "class"   then destroy_class(path)
-          when "module"  then destroy_module(path)
+          when "class"   then destroy_class(gem_constant(path))
+          when "module"  then destroy_module(gem_constant(path))
           when "command" then destroy_command(path)
           else
             puts colors.red("Unknown type '#{type}'. Use class, module, or command.")
@@ -56,25 +54,14 @@ module Gempilot
         end
 
         def destroy_class(constant)
-          namespaces, _class_name, segments = parse_constant(constant)
-          validate_gem_root!(namespaces.first)
-
-          lib_path = "#{File.join("lib", *segments)}.rb"
-          test_path = test_path_for(segments)
+          lib_path = constant.lib_path
+          test_path = constant.test_path(@test_framework)
 
           remove_file(lib_path)
           remove_file(test_path)
           cleanup_empty_dirs(lib_path, test_path)
         end
 
-        def test_path_for(segments)
-          if @test_framework == :rspec
-            "#{File.join("spec", @require_path, *segments[1..])}_spec.rb"
-          else
-            "#{File.join("test", @require_path, *segments[1..])}_test.rb"
-          end
-        end
-
         def cleanup_empty_dirs(lib_path, test_path)
           remove_empty_parents(File.dirname(lib_path), File.join("lib", @require_path))
           test_root = @test_framework == :rspec ? File.join("spec", @require_path) : File.join("test", @require_path)
@@ -82,10 +69,8 @@ module Gempilot
         end
 
         def destroy_module(constant)
-          namespaces, _mod_name, segments = parse_constant(constant)
-          validate_gem_root!(namespaces.first)
+          lib_path = constant.lib_path
 
-          lib_path = "#{File.join("lib", *segments)}.rb"
           remove_file(lib_path)
           remove_empty_parents(File.dirname(lib_path), File.join("lib", @require_path))
         end

data/lib/gempilot/cli/commands/new.rb

@@ -29,7 +29,7 @@ module Gempilot
         def run(type = nil, path = nil)
           type ||= prompt_for_type
           detect_gem_context
-          path ||= prompt_for_path
+          path ||= prompt_for_path(type)
           dispatch_add(type, path)
         end
 
@@ -40,16 +40,14 @@ module Gempilot
           ask_multiple_choice(colors.green("Type"), %w[class module command])
         end
 
-        def prompt_for_path
-          puts
-          puts colors.bright_black("Fully-qualified constant name (e.g., #{@gem_module}::Services::Authentication).")
-          ask(colors.green("Constant"), required: true)
+        def prompt_for_path(type)
+          ask(colors.green(type), required: true)
         end
 
         def dispatch_add(type, path)
           case type
-          when "class"   then add_class(path)
-          when "module"  then add_module(path)
+          when "class"   then add_class(gem_constant(path))
+          when "module"  then add_module(gem_constant(path))
           when "command" then add_command(path)
           else
             puts colors.red("Unknown type '#{type}'. Use class, module, or command.")
@@ -79,38 +77,29 @@ module Gempilot
         end
 
         def print_adding_banner(kind, label)
+          styled_label = colors.bold(colors.cyan(label))
           puts
-          puts colors.bright_white("Adding #{kind} ") +
-               colors.bold(colors.cyan(label)) +
-               colors.bright_white("...")
+          puts colors.bright_white("Adding #{kind} ") + styled_label + colors.bright_white("...")
           puts
         end
 
-        def prepare_constant(constant)
-          namespaces, name, segments = parse_constant(constant)
-          validate_gem_root!(namespaces.first)
-          file_path = "#{File.join("lib", *segments)}.rb"
-          ensure_directory(File.dirname(file_path))
-          [namespaces, name, segments, file_path]
-        end
-
         def ensure_directory(dir)
           mkdir(dir) unless File.directory?(dir)
         end
 
         def add_class(constant)
-          namespaces, class_name, segments, file_path = prepare_constant(constant)
-          print_adding_banner("class", "#{namespaces.join("::")}::#{class_name}")
-          source = build_nested_source(namespaces, "class", class_name)
-          create_file(file_path, source)
-          add_test_file(namespaces, class_name, segments)
+          print_adding_banner("class", constant.qualified)
+          ensure_directory(File.dirname(constant.lib_path))
+          source = build_nested_source(constant.namespaces, "class", constant.name)
+          create_file(constant.lib_path, source)
+          add_test_file(constant)
         end
 
         def add_module(constant)
-          namespaces, mod_name, _segments, file_path = prepare_constant(constant)
-          print_adding_banner("module", "#{namespaces.join("::")}::#{mod_name}")
-          source = build_nested_source(namespaces, "module", mod_name)
-          create_file(file_path, source)
+          print_adding_banner("module", constant.qualified)
+          ensure_directory(File.dirname(constant.lib_path))
+          source = build_nested_source(constant.namespaces, "module", constant.name)
+          create_file(constant.lib_path, source)
         end
 
         def add_command(name)
@@ -179,14 +168,6 @@ module Gempilot
           create_file(test_path, content)
         end
 
-        def class_test_path(segments)
-          if @test_framework == :rspec
-            "#{File.join("spec", @require_path, *segments[1..])}_spec.rb"
-          else
-            "#{File.join("test", @require_path, *segments[1..])}_test.rb"
-          end
-        end
-
         def rspec_class_content(namespaces, class_name)
           <<~RUBY
             require "spec_helper"
@@ -211,13 +192,13 @@ module Gempilot
           RUBY
         end
 
-        def add_test_file(namespaces, class_name, segments)
-          test_path = class_test_path(segments)
+        def add_test_file(constant)
+          test_path = constant.test_path(@test_framework)
           ensure_directory(File.dirname(test_path))
           content = if @test_framework == :rspec
-                      rspec_class_content(namespaces, class_name)
+                      rspec_class_content(constant.namespaces, constant.name)
                     else
-                      minitest_class_content(namespaces, class_name)
+                      minitest_class_content(constant.namespaces, constant.name)
                     end
           create_file(test_path, content)
         end

data/lib/gempilot/cli/commands/release.rb

@@ -18,9 +18,8 @@ module Gempilot
         private
 
         def print_release_banner
-          puts colors.bright_white("Releasing ") +
-               colors.bold(colors.cyan(@gem_name)) +
-               colors.bright_white("...")
+          styled_name = colors.bold(colors.cyan(@gem_name))
+          puts colors.bright_white("Releasing ") + styled_name + colors.bright_white("...")
           puts
         end
 

data/lib/gempilot/cli/gem_context.rb

@@ -17,23 +17,19 @@ module Gempilot
         @gem_name = File.basename(gemspec, ".gemspec")
         @require_path = @gem_name.tr("-", "/")
         @gem_module = @require_path.camelize
-        @test_framework = File.directory?("spec") ? :rspec : :minitest
+        @test_framework = detect_test_framework
       end
 
-      def parse_constant(constant)
-        parts = constant.split("::")
-        namespaces = parts[0...-1]
-        name = parts.last
-        segments = parts.map(&:underscore)
-        [namespaces, name, segments]
-      end
+      # Detect rspec by its canonical config files rather than the mere
+      # presence of a spec/ directory, which a minitest project may also have.
+      def detect_test_framework
+        return :rspec if File.exist?(".rspec") || File.exist?(File.join("spec", "spec_helper.rb"))
 
-      def validate_gem_root!(root)
-        expected = @gem_module.split("::").first
-        return if root == expected
+        :minitest
+      end
 
-        puts colors.red("Expected constant to start with #{expected}, got #{root}")
-        exit 1
+      def gem_constant(input)
+        GemConstant.new(input: input, gem_module: @gem_module, require_path: @require_path)
       end
     end
   end

data/lib/gempilot/cli/generator.rb

@@ -37,8 +37,9 @@ module Gempilot
       end
 
       def print_action(command, dest, source: nil)
+        styled_command = colors.bold(colors.green(command))
         line = +""
-        line << "\t" << colors.bold(colors.green(command))
+        line << "\t" << styled_command
         line << "\t" << colors.green(source) if source
         line << "\t" << colors.green(dest) if dest
 

data/lib/gempilot/gem_constant.rb

@@ -0,0 +1,61 @@
+module Gempilot
+  ## A class or module constant resolved within a gem's namespace.
+  ##
+  ## Wraps raw user input (a bare suffix like +Services::Auth+ or a
+  ## fully-qualified +MyGem::Services::Auth+) together with the gem's module
+  ## and require path, and derives the qualified constant, file paths, and
+  ## namespace pieces from a single parse.
+  ##
+  ## Every constant is rooted at the gem's module: bare input is prefixed with
+  ## it, while input already starting with the gem's root segment is left as
+  ## is. Rooting is matched on the first segment only, so an extension gem
+  ## whose module is +My::Gem+ accepts any +My::...+ constant.
+  GemConstant = Data.define(:input, :gem_module, :require_path) do
+    using String::Inflectable
+
+    ## The fully-qualified constant, rooted at the gem module.
+    def qualified
+      input.start_with?("#{root_segment}::") ? input : "#{gem_module}::#{input}"
+    end
+
+    ## Namespace segments preceding the final constant name.
+    def namespaces
+      parts[0...-1]
+    end
+
+    ## The final class or module name.
+    def name
+      parts.last
+    end
+
+    ## Path to the constant's source file, e.g. +lib/my_gem/services/auth.rb+.
+    def lib_path
+      "#{File.join("lib", *path_segments)}.rb"
+    end
+
+    ## Path to the constant's test file for +framework+ (+:rspec+ or
+    ## +:minitest+); correct for multi-segment (hyphenated) gem modules.
+    def test_path(framework)
+      rest = path_segments.drop(require_path.split("/").length)
+      if framework == :rspec
+        "#{File.join("spec", require_path, *rest)}_spec.rb"
+      else
+        "#{File.join("test", require_path, *rest)}_test.rb"
+      end
+    end
+
+    private
+
+    def root_segment
+      gem_module.split("::").first
+    end
+
+    def parts
+      qualified.split("::")
+    end
+
+    def path_segments
+      parts.map(&:underscore)
+    end
+  end
+end

data/lib/gempilot/project.rb

@@ -1,8 +1,9 @@
-require "pathname"
 require "warning"
 
 module Gempilot
   ## Introspects a gem project to discover its name, module, and version.
+  ## Works for both regular gems (+lib/my_gem.rb+) and extension gems whose
+  ## entry point nests deeper (+lib/my_gem/extension.rb+ for +my_gem-extension+).
   class Project
     class ProjectIntrospectionError < StandardError; end
 
@@ -29,11 +30,11 @@ module Gempilot
     end
 
     def name
-      lib_project.basename.to_s
+      project_segments.join("-")
     end
 
     def klass
-      Object.const_get(name.camelize)
+      Object.const_get(project_segments.map(&:camelize).join("::"))
     end
 
     def version
@@ -67,6 +68,10 @@ module Gempilot
 
     private
 
+    def project_segments
+      lib_project.relative_path_from(lib).each_filename.to_a
+    end
+
     def with_version_file
       version.path.open(File::RDWR, 0o644) do |f|
         f.flock File::LOCK_EX
@@ -76,8 +81,7 @@ module Gempilot
     end
 
     def fetch_lib_project
-      files = lib.glob("*.rb")
-      dirs = files.map { it.sub_ext("") }.select(&:directory?)
+      dirs = shallowest_entry_dirs
       case dirs.count
       in 0 then raise ProjectIntrospectionError, "Could not identify project dir"
       in (2..)
@@ -87,6 +91,22 @@ module Gempilot
       end
     end
 
+    def shallowest_entry_dirs
+      entry_dirs.group_by { depth_below_lib(it) }
+                .min_by(&:first)
+                &.last || []
+    end
+
+    def entry_dirs
+      lib.glob("**/*.rb")
+         .map { it.sub_ext("") }
+         .select(&:directory?)
+    end
+
+    def depth_below_lib(path)
+      path.relative_path_from(lib).each_filename.count
+    end
+
     def fetch_version
       Warning.ignore(REDEFINITION_WARNING)
       Warning.ignore(REINITIALIZATION_WARNING)

data/lib/gempilot/version.rb

@@ -1,3 +1,3 @@
 module Gempilot
-  VERSION = "0.2.1".freeze
+  VERSION = "0.2.3".freeze
 end

data/lib/gempilot/version_tag.rb

@@ -5,6 +5,10 @@ module Gempilot
   class VersionTag
     include StrictShell
 
+    ## Commit-message prefix written for a version bump; the guard below
+    ## matches on it, so the two must stay in sync.
+    BUMP_MESSAGE_PREFIX = "Bump version to ".freeze
+
     attr_reader :version
 
     def initialize(version)
@@ -16,7 +20,7 @@ module Gempilot
       raise "Cannot proceed, staging area must be clean" unless status.success?
 
       sh "git", "add", version.path.to_s
-      sh "git", "commit", "-m", "Bump version to #{version.value}"
+      sh "git", "commit", "-m", "#{BUMP_MESSAGE_PREFIX}#{version.value}"
     end
 
     def tag
@@ -47,7 +51,7 @@ module Gempilot
       raise "Failed to read last commit message" unless status.success?
 
       message.strip!
-      abort "Last commit does not appear to be a version bump." unless message.start_with?("Bump version to ")
+      raise "Last commit does not appear to be a version bump." unless message.start_with?(BUMP_MESSAGE_PREFIX)
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gempilot
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: ruby
 authors:
 - David Gillis
@@ -106,15 +106,6 @@ files:
 - data/templates/gem/test/zeitwerk_test.rb.erb
 - data/templates/new/.keep
 - data/templates/new/command.rb.erb
-- docs/command_kit_comparison.md
-- docs/command_kit_reference.md
-- docs/plans/2026-02-18-gempilot-add-command.md
-- docs/superpowers/plans/2026-04-01-rubocop-new-config.md
-- docs/superpowers/plans/2026-04-06-dogfood-inflectable.md
-- docs/superpowers/plans/2026-04-06-inflection-tests-and-erb-rename.md
-- docs/superpowers/plans/2026-04-06-integrate-version-tools.md
-- docs/superpowers/plans/2026-04-06-new-readme.md
-- docs/version-management-redesign.md
 - exe/gempilot
 - issues.rec
 - lib/core_ext/string/inflection_methods.rb
@@ -131,6 +122,7 @@ files:
 - lib/gempilot/cli/gem_builder.rb
 - lib/gempilot/cli/gem_context.rb
 - lib/gempilot/cli/generator.rb
+- lib/gempilot/gem_constant.rb
 - lib/gempilot/github_release.rb
 - lib/gempilot/project.rb
 - lib/gempilot/project/version.rb
@@ -138,7 +130,7 @@ files:
 - lib/gempilot/version.rb
 - lib/gempilot/version_tag.rb
 - lib/gempilot/version_task.rb
-- notes.md
+- vendor/vendored.gemv
 homepage: https://github.com/gillisd/gempilot
 licenses:
 - MIT
@@ -152,14 +144,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.4'
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.13
+rubygems_version: 4.0.15
 specification_version: 4
 summary: A toolkit for creating, managing, and releasing your own rubygems
 test_files: []