gempilot 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48657265841f0000324b7cfca38d98ed1a45a59e7906810660a8e9e047042286
-  data.tar.gz: 9a084c85bfeec3ea094da9e7b7b245a0e30a050631db84acf8d434e88470b948
+  metadata.gz: b4b895f3da5d0d8866cd13f835dd3c1ca71d8d433571c2d7531735636eeb6ad0
+  data.tar.gz: 878dad31a22bdecdb9ff607ebecf2330432070219edfc3e08b66a5022c205d77
 SHA512:
-  metadata.gz: 677fa36cce5bf93834debebf366296289b5fe69baf1ecb325d2169aa03140e928373a36052d4e4accfff37aebdfdb5562bbdda09244c5e6e15b1f51b982397c9
-  data.tar.gz: 8afb56703f50f6f42c56b7049167c498656576c8c4e5061cdd11883b9d32efe0ea7906203391dc809d4197c222f654010439fd38ead128ce9783446dafa50e54
+  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

@@ -36,11 +36,3 @@ A CLI tool for creating and managing Ruby gems, built on CommandKit.
 - GitHub Actions CI workflow (`.github/workflows/ci.yml`)
 - `git ls-files`-based gemspec with glob fallback for non-git repos
 - 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`
-
-### 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` previously had an unconditional `ENV["BUNDLE_GEMFILE"]` + `require "bundler/setup"`, breaking `gem install` usage. It now guards both behind `if File.exist?(gemfile)` (the Ronin pattern), so installed gems skip Bundler while in-repo runs still use it.

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/new.rb

@@ -77,10 +77,9 @@ 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
 

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/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/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.2".freeze
+  VERSION = "0.2.3".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gempilot
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - David Gillis
@@ -106,16 +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/superpowers/plans/2026-06-09-address-review-critiques.md
-- docs/version-management-redesign.md
 - exe/gempilot
 - issues.rec
 - lib/core_ext/string/inflection_methods.rb
@@ -140,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
@@ -154,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.14
+rubygems_version: 4.0.15
 specification_version: 4
 summary: A toolkit for creating, managing, and releasing your own rubygems
 test_files: []

data/docs/command_kit_comparison.md

@@ -1,249 +0,0 @@
-# Gempilot vs Ronin: CommandKit Usage Comparison
-
-## How Gempilot Uses CommandKit
-
-### Current Usage (after restructuring)
-
-| CommandKit Module | Used? | Where |
-|---|---|---|
-| `CommandKit::Commands` | Yes | `Gempilot::CLI` - top-level command dispatcher |
-| `CommandKit::Commands::AutoLoad` | Yes | `Gempilot::CLI` - auto-discovers commands from `cli/commands/` |
-| `CommandKit::Options::Version` | Yes | `Gempilot::CLI` - `--version` flag |
-| `CommandKit::Command` | Yes | `Gempilot::CLI::Command` - base class for all commands |
-| `CommandKit::Colors` | Yes | `Gempilot::CLI::Command` and `Gempilot::CLI::Generator` |
-| `CommandKit::FileUtils` | Yes | `Gempilot::CLI::Generator` - `erb()` method |
-| `CommandKit::Options` | Yes | `Commands::New` - all option definitions (implicit via Command) |
-| `CommandKit::Arguments` | Yes | `Commands::New` - `gem_name` argument (implicit via Command) |
-| `CommandKit::Inflector` | **No** | Hand-rolled `inflect_module` in `Commands::New` instead |
-| `CommandKit::Interactive` | **No** | Not included in base Command |
-| `CommandKit::Description` | Yes | `Commands::New` - `description "Create a new gem"` |
-| `CommandKit::Usage` | Yes | `Commands::New` - `usage "[options] GEM_NAME"` |
-| `CommandKit::Printing` | Yes | Implicit via Command |
-| `CommandKit::Printing::Indent` | **No** | |
-| `CommandKit::Printing::Fields` | **No** | |
-| `CommandKit::Printing::Lists` | **No** | |
-| `CommandKit::Printing::Tables` | **No** | |
-| `CommandKit::Terminal` | **No** | |
-| `CommandKit::Pager` | **No** | |
-| `CommandKit::OS` | **No** | |
-| `CommandKit::XDG` | **No** | |
-| `CommandKit::BugReport` | **No** | |
-| `CommandKit::Help::Man` | **No** | |
-| `CommandKit::Edit` | **No** | |
-| `CommandKit::Examples` | **No** | No examples defined on any command |
-| `CommandKit::ExceptionHandler` | Yes | Implicit via Command |
-
-### What Gempilot Hand-Rolls Instead of Using CommandKit
-
-1. **Inflector** - `Commands::New#inflect_module` (line 113-115) does:
-   ```ruby
-   def inflect_module(name)
-     name.split(/[-_]/).map(&:capitalize).join
-   end
-   ```
-   Should use `CommandKit::Inflector.camelize(name)` which handles the same transformation plus edge cases (e.g., `/` to `::` for nested modules).
-
-2. **Generator module** - `Gempilot::CLI::Generator` reimplements ronin-core's Generator pattern. This is intentional (own implementation, no ronin-core dependency), but it duplicates logic that `CommandKit::FileUtils` already partly provides (`erb` method). The Generator adds `print_action`, `mkdir`, `cp`, `sh`, `touch`, `chmod` wrappers with colored output.
-
-3. **Shell execution** - `Gempilot::Commands#sh` uses a custom `Runner` class with PTY/Open3 pipeline for command execution. The Generator module has its own simpler `sh` that calls `system()`. Two different shell execution paths exist.
-
----
-
-## How Ronin Uses CommandKit (Reference Implementation)
-
-### Module Usage
-
-| CommandKit Module | Used? | Where |
-|---|---|---|
-| `CommandKit::Commands` | Yes | `Ronin::CLI` |
-| `CommandKit::Commands::AutoLoad` | Yes | `Ronin::CLI`, `Commands::New`, and many others |
-| `CommandKit::Options::Version` | Yes | `Ronin::CLI` |
-| `CommandKit::Command` | Yes (via ronin-core) | `Core::CLI::Command` base class |
-| `CommandKit::Colors` | Yes | `Core::CLI::Generator`, syntax highlighting |
-| `CommandKit::FileUtils` | Yes | `Core::CLI::Generator` |
-| `CommandKit::Options` | Yes | Every command |
-| `CommandKit::Arguments` | Yes | Every command |
-| `CommandKit::Interactive` | **No** | Not used in ronin itself |
-| `CommandKit::Description` | Yes | Every command |
-| `CommandKit::Usage` | Yes | Every command |
-| `CommandKit::Examples` | Yes | Most commands have examples |
-| `CommandKit::Printing` | Yes | Implicit via Command |
-| `CommandKit::Printing::Indent` | Yes | Output formatting |
-| `CommandKit::Printing::Tables` | Yes | Database query output |
-| `CommandKit::Terminal` | Yes | Width-aware output |
-| `CommandKit::Pager` | Yes | Long output paging |
-| `CommandKit::OS` | Yes | OS-specific behavior |
-| `CommandKit::BugReport` | Yes | `Core::CLI::Command` base class |
-| `CommandKit::Help::Man` | Yes | Every command has `man_page` |
-| `CommandKit::Inflector` | Yes | Used internally for command name derivation |
-
-### Ronin Patterns Worth Adopting
-
-1. **Every command has `examples`** - Ronin defines usage examples on almost every command:
-   ```ruby
-   examples [
-     'project foo',
-     'script foo.rb'
-   ]
-   ```
-
-2. **`bug_report_url` on base command** - Set once, inherited everywhere:
-   ```ruby
-   class Command < Core::CLI::Command
-     bug_report_url 'https://github.com/ronin-rb/ronin/issues/new'
-   end
-   ```
-
-3. **Man pages** - Every command declares `man_page 'ronin-command.1'` for full documentation.
-
-4. **Nested AutoLoad** - The `new` command is itself a Commands container with AutoLoad:
-   ```ruby
-   class New < Command
-     include CommandKit::Commands::AutoLoad.new(
-       dir:       "#{__dir__}/new",
-       namespace: "#{self}"
-     )
-   end
-   ```
-   This allows `ronin new project`, `ronin new script`, etc. Each subcommand is a separate file in `commands/new/`.
-
-5. **Core::CLI::Generator** builds on CommandKit::FileUtils - It adds `template_dir`, `print_action`, and wrappers for `mkdir`, `cp`, `erb`, `chmod`, `sh`. Gempilot's Generator follows this pattern.
-
-6. **Consistent use of Inflector** - Ronin never hand-rolls string case conversion.
-
----
-
-## Side-by-Side: CLI Entry Points
-
-### Gempilot
-```ruby
-# lib/gempilot/cli.rb
-class Gempilot::CLI
-  include CommandKit::Commands
-  include CommandKit::Commands::AutoLoad.new(
-    dir:       "#{__dir__}/cli/commands",
-    namespace: "#{self}::Commands"
-  )
-  include CommandKit::Options::Version
-
-  command_name "gempilot"
-  version Gempilot::VERSION
-end
-```
-
-### Ronin
-```ruby
-# lib/ronin/cli.rb
-class Ronin::CLI
-  include CommandKit::Commands
-  include CommandKit::Commands::AutoLoad.new(
-    dir:       "#{__dir__}/cli/commands",
-    namespace: "#{self}::Commands"
-  )
-  include CommandKit::Options::Version
-  include Core::CLI::Help::Banner
-
-  command_name 'ronin'
-  version Ronin::VERSION
-
-  command_aliases['enc'] = 'encode'
-  command_aliases['dec'] = 'decode'
-end
-```
-
-**Verdict:** Nearly identical. Gempilot follows the pattern correctly. Ronin adds `command_aliases` and a help banner, both nice touches.
-
----
-
-## Side-by-Side: Generator Commands
-
-### Gempilot - `Commands::New`
-```ruby
-class New < Command
-  include Generator
-
-  template_dir File.join(Gempilot::ROOT, "data", "templates", "gem")
-
-  option :summary, value: { type: String }, desc: "Gem summary"
-  option :test, value: { type: { "minitest" => :minitest, "rspec" => :rspec }, default: :minitest }, desc: "Test framework"
-  argument :gem_name, required: true, desc: "Name of the gem"
-
-  def run(gem_name)
-    @gem_name = gem_name
-    @module_name = inflect_module(gem_name)
-    mkdir gem_name
-    erb "gemspec.erb", "#{gem_name}/#{gem_name}.gemspec"
-    # ...
-  end
-end
-```
-
-### Ronin - `Commands::New::Project`
-```ruby
-class Project < Command
-  include Core::CLI::Generator
-
-  template_dir File.join(ROOT, 'data', 'templates', 'project')
-
-  option :git, desc: 'Initializes a git repo'
-  option :ruby_version, value: { type: String, usage: 'VERSION', default: RUBY_VERSION }, desc: '...'
-  argument :path, required: true, desc: 'The directory to create'
-
-  description 'Creates a new Ruby project directory'
-  man_page 'ronin-new-project.1'
-
-  def run(path)
-    @project_name = File.basename(path)
-    @ruby_version = options[:ruby_version]
-    mkdir path
-    erb 'Gemfile.erb', File.join(path, 'Gemfile')
-    # ...
-  end
-end
-```
-
-**Verdict:** Same pattern. Gempilot's version is correct. Ronin adds `man_page` declaration and uses `usage:` on option values for better help output.
-
----
-
-## Grading: Gempilot's Idiomatic Use of CommandKit
-
-### Grade: **B+**
-
-Gempilot's restructured codebase follows the command_kit patterns well. The CLI entry, base command, AutoLoad, option/argument definitions, and Generator module all match the Ronin reference closely.
-
-### What Earns the Grade
-
-**Done right:**
-- CLI with `Commands` + `AutoLoad` - textbook implementation
-- Base `Command` class with `Colors` - follows the pattern
-- Generator module following ronin-core's design
-- Option definitions with `value:` Hash, proper types
-- Argument definitions with `required: true`
-- `template_dir` class method pattern
-- `description` and `usage` on commands
-- ERB templates with instance variable binding
-- Executable entry point: thin `CLI.start`
-
-**Holding it back from A:**
-
-1. **`CommandKit::Inflector` not used** - Hand-rolled `inflect_module` instead of `Inflector.camelize`. This is specifically called out in CLAUDE.md issue #2.
-
-2. **No `CommandKit::Interactive`** - CLAUDE.md issue #1 asks for interactive prompting when arguments are missing. `CommandKit::Interactive` provides `ask`, `ask_yes_or_no`, `ask_multiple_choice` - exactly what's needed.
-
-3. **No `examples` on any command** - Ronin defines examples on every command. Gempilot defines none. Easy win for help output.
-
-4. **No `bug_report_url`** - Low effort, high value for user experience.
-
-5. **Two shell execution paths** - `Generator#sh` (uses `system`) and `Commands#sh` / `Runner` (uses Open3 pipeline with PTY). Should converge.
-
-6. **`CommandMapper` integration unclear** - `CommandMappers::Bundle` is a 1091-line DSL that's not wired into any command yet. The `Commands::New#run` calls `sh 'bundle', 'install'` directly instead of using the typed DSL.
-
-### What Would Make It an A
-
-1. Replace `inflect_module` with `CommandKit::Inflector.camelize`
-2. Include `CommandKit::Interactive` in base Command, use it for missing-argument prompting
-3. Add `examples` to `Commands::New`
-4. Add `bug_report_url` to base Command
-5. Wire `CommandMappers::Bundle` into the `new` command for `bundle install` / `bundle config` operations
-6. Add `CommandKit::Printing::Indent` for structured output during generation