gempilot 0.2.2 → 0.2.3

data/docs/superpowers/plans/2026-04-06-inflection-tests-and-erb-rename.md

@@ -1,166 +0,0 @@
-# Inflection Tests and ERB Rename Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Add unit tests for `String::Inflectable` and rename `version.rake.erb` to `version.rake` since it no longer contains ERB tags.
-
-**Architecture:** Two independent tasks. Task 1 adds an RSpec spec for the inflection refinement covering `camelize`, `underscore`, and `dasherize` with edge cases. Task 2 renames the template file and switches `gem_builder.rb` from `erb` to `cp`.
-
-**Tech Stack:** Ruby, RSpec
-
----
-
-## File Structure
-
-| Action | Path | Responsibility |
-|--------|------|----------------|
-| Create | `spec/core_ext/string/inflectable_spec.rb` | Unit tests for inflection refinement |
-| Rename | `data/templates/gem/rakelib/version.rake.erb` → `data/templates/gem/rakelib/version.rake` | Remove misleading ERB extension |
-| Modify | `lib/gempilot/cli/gem_builder.rb:48` | Switch from `erb` to `cp` for version.rake |
-
----
-
-### Task 1: Add inflection unit tests
-
-**Files:**
-- Create: `spec/core_ext/string/inflectable_spec.rb`
-
-- [ ] **Step 1: Write the spec**
-
-```ruby
-require_relative "../../lib/core_ext/string/refinements/inflectable"
-
-using String::Inflectable
-
-RSpec.describe String::Inflectable do
-  describe "#camelize" do
-    it "camelizes a snake_case string" do
-      expect("my_gem".camelize).to eq("MyGem")
-    end
-
-    it "camelizes a path with slashes into namespaces" do
-      expect("my/gem".camelize).to eq("My::Gem")
-    end
-
-    it "handles a single word" do
-      expect("gem".camelize).to eq("Gem")
-    end
-
-    it "handles a hyphenated string" do
-      expect("my-gem".camelize).to eq("MyGem")
-    end
-
-    it "preserves numeric segments" do
-      expect("v_2".camelize).to eq("V_2")
-    end
-  end
-
-  describe "#underscore" do
-    it "underscores a CamelCase string" do
-      expect("MyGem".underscore).to eq("my_gem")
-    end
-
-    it "underscores consecutive capitals" do
-      expect("CLI".underscore).to eq("cli")
-    end
-
-    it "underscores mixed case with acronyms" do
-      expect("HTTPClient".underscore).to eq("http_client")
-    end
-
-    it "preserves existing underscores" do
-      expect("my_gem".underscore).to eq("my_gem")
-    end
-
-    it "converts hyphens to underscores" do
-      expect("my-gem".underscore).to eq("my_gem")
-    end
-  end
-
-  describe "#dasherize" do
-    it "converts underscores to hyphens" do
-      expect("my_gem".dasherize).to eq("my-gem")
-    end
-
-    it "leaves non-underscored strings alone" do
-      expect("mygem".dasherize).to eq("mygem")
-    end
-  end
-
-  describe "class method form" do
-    it "camelizes via String.camelize" do
-      expect(String.camelize("my_gem")).to eq("MyGem")
-    end
-
-    it "underscores via String.underscore" do
-      expect(String.underscore("MyGem")).to eq("my_gem")
-    end
-
-    it "dasherizes via String.dasherize" do
-      expect(String.dasherize("my_gem")).to eq("my-gem")
-    end
-  end
-end
-```
-
-- [ ] **Step 2: Run the spec**
-
-Run: `bundle exec rspec spec/core_ext/string/inflectable_spec.rb --format documentation`
-Expected: All examples pass
-
-- [ ] **Step 3: Run rubocop**
-
-Run: `bundle exec rubocop spec/core_ext/string/inflectable_spec.rb`
-Expected: No offenses
-
-- [ ] **Step 4: Commit**
-
-```bash
-git add spec/core_ext/string/inflectable_spec.rb
-git commit -m "Add unit tests for String::Inflectable refinement"
-```
-
----
-
-### Task 2: Rename version.rake.erb to version.rake
-
-**Files:**
-- Rename: `data/templates/gem/rakelib/version.rake.erb` → `data/templates/gem/rakelib/version.rake`
-- Modify: `lib/gempilot/cli/gem_builder.rb:48`
-
-- [ ] **Step 1: Rename the template file**
-
-```bash
-git mv data/templates/gem/rakelib/version.rake.erb data/templates/gem/rakelib/version.rake
-```
-
-- [ ] **Step 2: Update `gem_builder.rb`**
-
-In `lib/gempilot/cli/gem_builder.rb` line 48, change:
-
-```ruby
-        erb "rakelib/version.rake.erb", "#{@gem_name}/rakelib/version.rake"
-```
-
-To:
-
-```ruby
-        cp "rakelib/version.rake", "#{@gem_name}/rakelib/version.rake"
-```
-
-- [ ] **Step 3: Run tests**
-
-Run: `bundle exec rake test spec`
-Expected: All pass
-
-- [ ] **Step 4: Run rubocop**
-
-Run: `bundle exec rubocop`
-Expected: No offenses
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add data/templates/gem/rakelib/version.rake lib/gempilot/cli/gem_builder.rb
-git commit -m "Rename version.rake.erb to version.rake — no ERB tags remain"
-```

data/docs/superpowers/plans/2026-04-06-integrate-version-tools.md

@@ -1,162 +0,0 @@
-# Package Version Tools as Gem Dependency
-
-## Context
-
-Generated gems currently get 8 files copied into them (rakelib support classes + core_ext inflection files). This creates maintenance burden — files diverge, every gem carries duplicate code, updates require regenerating. The CLI `bump` command also reimplements version logic that `Project` already provides.
-
-Instead: the domain model (`Project`, `Project::Version`, `VersionTag`, `GithubRelease`) lives in `lib/gempilot/` as first-class autoloaded classes. A `VersionTasks` class provides the rake integration. Generated gems add `gem "gempilot"` and `require "gempilot/version_tasks"`. The CLI `bump` command delegates to `rake version:bump` like `release` already delegates to `rake release`.
-
-## Architecture
-
-```
-lib/gempilot/
-  project.rb              — Gempilot::Project (gem introspection)
-  project/
-    version.rb            — Gempilot::Project::Version (semver value object)
-  version_tag.rb          — Gempilot::VersionTag (git release ops)
-  github_release.rb       — Gempilot::GithubRelease (github release ops)
-  strict_shell.rb         — Gempilot::StrictShell (shared shell mixin)
-  version_tasks.rb        — Gempilot::VersionTasks < Rake::TaskLib (entry point)
-```
-
-Only `VersionTasks` depends on Rake. The rest are plain Ruby domain objects that Zeitwerk autoloads normally. `VersionTasks` is ignored by Zeitwerk (requires Rake as a side effect) and loaded via explicit `require "gempilot/version_tasks"`.
-
-## Files
-
-### Create
-| Path | Class |
-|------|-------|
-| `lib/gempilot/strict_shell.rb` | `Gempilot::StrictShell` |
-| `lib/gempilot/project.rb` | `Gempilot::Project` |
-| `lib/gempilot/project/version.rb` | `Gempilot::Project::Version` |
-| `lib/gempilot/version_tag.rb` | `Gempilot::VersionTag` |
-| `lib/gempilot/github_release.rb` | `Gempilot::GithubRelease` |
-| `lib/gempilot/version_tasks.rb` | `Gempilot::VersionTasks` |
-
-### Delete
-| Path | Reason |
-|------|--------|
-| `rakelib/project.rb` | Moved to lib/gempilot/ |
-| `rakelib/project_version.rb` | Moved to lib/gempilot/project/version.rb |
-| `rakelib/version_tag.rb` | Moved to lib/gempilot/ |
-| `rakelib/github_release.rb` | Moved to lib/gempilot/ |
-| `rakelib/strict_shell.rb` | Moved to lib/gempilot/ |
-| `rakelib/version.rake` | Replaced by VersionTasks |
-| `data/templates/gem/rakelib/` | Entire directory (6 symlinks) |
-| `data/templates/gem/lib/core_ext/` | Entire directory (2 symlinks) |
-
-### Modify
-| Path | Change |
-|------|--------|
-| `lib/gempilot.rb` | Add `LOADER.ignore` for `version_tasks.rb` |
-| `gempilot.gemspec` | Add `warning` runtime dep, fix fallback glob |
-| `Gemfile` | Remove `gem "warning"` |
-| `Rakefile` | Use `require "gempilot/version_tasks"` + `Gempilot::VersionTasks.new` |
-| `lib/gempilot/cli/commands/bump.rb` | Delegate to `rake version:bump[SEGMENT]` |
-| `lib/gempilot/cli/commands/release.rb` | Delegate to `rake version:release` (already similar) |
-| `data/templates/gem/Rakefile.erb` | Add require + VersionTasks.new |
-| `data/templates/gem/Gemfile.erb` | Add `gem "gempilot", require: false` |
-| `data/templates/gem/gemspec.erb` | Change fallback glob `{lib,exe,rakelib}` → `{lib,exe}` |
-| `data/templates/gem/lib/gem_name.rb.erb` | Remove `LOADER.ignore("#{__dir__}/core_ext")` |
-| `lib/gempilot/cli/gem_builder.rb` | Remove `render_version_rake`, `render_core_ext` + calls |
-| Specs | Update require paths + class references |
-| `test/gempilot/cli/create_command_test.rb` | Update assertions for new generated gem structure |
-
-## Domain Model Changes
-
-### `Project::Version#bump(segment)` — add segment support
-
-Currently `next_version` only increments the last segment. Add `bump(segment = :patch)`:
-
-```ruby
-def bump(segment = :patch)
-  major, minor, patch = value.split(".").map(&:to_i)
-  new_value = case segment.to_sym
-              when :major then "#{major + 1}.0.0"
-              when :minor then "#{major}.#{minor + 1}.0"
-              when :patch then "#{major}.#{minor}.#{patch + 1}"
-              end
-  with(value: new_value)
-end
-```
-
-`next_version` stays as an alias for `bump(:patch)` for backwards compatibility with the existing specs.
-
-### `version:bump` rake task — accept segment argument
-
-```ruby
-desc "Bump version (patch default, or rake version:bump[minor])"
-task :bump, [:segment] do |_t, args|
-  segment = (args[:segment] || :patch).to_sym
-  old_version = project.version
-  new_version = old_version.bump(segment)
-  project.write_version!(old_version, new_version)
-  project.refresh_version!
-  puts "Version bumped from #{old_version.value} to #{project.version_value}"
-end
-```
-
-### `Bump` CLI command — delegate to rake
-
-Replace the 104-line implementation with a thin rake delegation (same pattern as `Release`):
-
-```ruby
-def run(segment = "patch")
-  detect_gem_context
-  validate_segment(segment)
-  run_rake_bump(segment)
-end
-
-private
-
-def run_rake_bump(segment)
-  success = Bundler.with_unbundled_env do
-    system("bundle", "exec", "rake", "version:bump[#{segment}]")
-  end
-  exit 1 unless success
-end
-```
-
-## Tasks
-
-### Task 1: Create domain classes in lib/gempilot/
-
-Move and namespace the 5 domain classes + create `VersionTasks`. Each is a mechanical translation wrapping in `module Gempilot`. Add `Version#bump(segment)` method. Add `LOADER.ignore` for `version_tasks.rb` only (the rest autoload normally). Add `warning` to gemspec runtime deps.
-
-### Task 2: Dogfood — switch gempilot's Rakefile
-
-Add `require "gempilot/version_tasks"` + `Gempilot::VersionTasks.new`. Delete all 6 `rakelib/` files. Verify `rake -T version` and `rake version:current`.
-
-### Task 3: Update specs
-
-Change require paths and class references in all rakelib specs. Add spec for `Version#bump(:minor)` and `Version#bump(:major)`. Run specs.
-
-### Task 4: Simplify CLI Bump command
-
-Replace the 104-line implementation with rake delegation. Keep `validate_segment` for the CLI-side error message. Remove duplicate `VERSION_PATTERN`, `read_current_version`, `write_new_version`, `increment` methods.
-
-### Task 5: Update templates + generator
-
-- `Rakefile.erb`: add `require "gempilot/version_tasks"` + `Gempilot::VersionTasks.new`
-- `Gemfile.erb`: add `gem "gempilot", require: false`
-- `gemspec.erb`: change fallback glob to `{lib,exe}`
-- `gem_name.rb.erb`: remove `LOADER.ignore("#{__dir__}/core_ext")`
-- `gem_builder.rb`: remove `render_version_rake`, `render_core_ext` + calls
-- Delete `data/templates/gem/rakelib/` and `data/templates/gem/lib/core_ext/`
-
-### Task 6: Update create_command_test.rb
-
-Remove assertions about rakelib/core_ext files in generated gems. Add assertions for Gemfile containing `gempilot` and Rakefile containing `VersionTasks`.
-
-### Task 7: Integration test
-
-Generate a test gem. Verify: no `rakelib/` support files, no `lib/core_ext/`, `gem "gempilot"` in Gemfile, `rake -T version` lists 12 tasks, `rake version:current` works, `bundle exec rake` passes.
-
-## Verification
-
-1. `bundle exec rake test spec` — gempilot suite passes
-2. `bundle exec rubocop` — 0 offenses
-3. `bundle exec rake -T version` — 12 tasks via the new require
-4. `bundle exec rake version:bump[minor]` — segment argument works
-5. `gempilot bump minor` — CLI delegates to rake
-6. Generate a test gem — works end-to-end with gempilot as a Gemfile dependency

data/docs/superpowers/plans/2026-04-06-new-readme.md

@@ -1,185 +0,0 @@
-# New README Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Replace the default bundler scaffold README with a real project README documenting gempilot's commands, generated gem features, and version management tasks.
-
-**Architecture:** Single file rewrite. Content sourced from command implementations in `lib/gempilot/cli/commands/`, template files in `data/templates/gem/`, and the CLAUDE.md project notes.
-
-**Tech Stack:** Markdown
-
----
-
-## File Structure
-
-| Action | Path | Responsibility |
-|--------|------|----------------|
-| Rewrite | `README.md` | Project documentation |
-
----
-
-### Task 1: Write the README
-
-**Files:**
-- Rewrite: `README.md`
-
-- [ ] **Step 1: Write `README.md`**
-
-```markdown
-# Gempilot
-
-A CLI toolkit for creating and managing Ruby gems with modern conventions.
-
-Gempilot scaffolds production-ready gems with Zeitwerk autoloading, RuboCop,
-GitHub Actions CI, and integrated version management. It also generates
-classes, modules, and commands within existing gems.
-
-## Installation
-
-```bash
-gem install gempilot
-```
-
-Requires Ruby >= 3.4.
-
-## Quick Start
-
-```bash
-gempilot create my_gem
-cd my_gem
-bundle exec rake
-```
-
-This creates a fully configured gem with tests, linting, CI, and version
-management — ready to develop.
-
-## Commands
-
-### `gempilot create`
-
-Scaffold a new gem.
-
-```bash
-gempilot create my_gem
-gempilot create --test rspec --exe my_gem
-gempilot create --test minitest --no-git my_gem
-```
-
-Options:
-
-| Option | Description | Default |
-|--------|-------------|---------|
-| `--test {minitest\|rspec}` | Test framework | prompted |
-| `--[no-]exe` | Create executable in `exe/` | prompted |
-| `--[no-]git` | Initialize git repo | prompted |
-| `--branch NAME` | Git branch name | `master` |
-| `--summary TEXT` | One-line gem description | prompted |
-| `--author NAME` | Author name | `git config user.name` |
-| `--email EMAIL` | Author email | `git config user.email` |
-| `--ruby-version VER` | Minimum Ruby version | current Ruby |
-
-All options are prompted interactively if omitted.
-
-### `gempilot new`
-
-Generate a class, module, or command in an existing gem. Run from the gem root.
-
-```bash
-gempilot new class MyGem::Services::Authentication
-gempilot new module MyGem::Middleware
-gempilot new command deploy
-```
-
-Creates the source file under `lib/` and a corresponding test file. For
-commands, generates a CommandKit command class in `lib/<gem>/cli/commands/`.
-
-### `gempilot destroy`
-
-Remove a class, module, or command. Cleans up empty parent directories.
-
-```bash
-gempilot destroy class MyGem::Services::Authentication
-gempilot destroy command deploy
-```
-
-### `gempilot bump`
-
-Bump the version in `lib/<gem>/version.rb`.
-
-```bash
-gempilot bump          # patch (default)
-gempilot bump minor
-gempilot bump major
-```
-
-### `gempilot release`
-
-Delegates to `rake release` to build and push the gem.
-
-### `gempilot console`
-
-Delegates to `bin/console` for an interactive IRB session with the gem loaded.
-
-## Generated Gem Features
-
-Every gem scaffolded by `gempilot create` includes:
-
-- **Zeitwerk autoloading** with `LOADER` constant and `rake zeitwerk:validate`
-- **Test framework** — Minitest or RSpec, with a Zeitwerk eager-load test
-- **RuboCop** with `rubocop-claude`, `rubocop-performance`, `rubocop-rake`, and
-  framework-specific plugins (`rubocop-minitest` or `rubocop-rspec`)
-- **GitHub Actions CI** running tests and RuboCop
-- **Version management** rake tasks (see below)
-- **`bin/console`** and **`bin/setup`** scripts
-- **Gemspec** with `git ls-files` and glob fallback, MFA required for RubyGems
-
-### Version Management Tasks
-
-Generated gems include rake tasks for the full version lifecycle:
-
-| Task | Description |
-|------|-------------|
-| `rake version:current` | Display the current version |
-| `rake version:bump` | Increment the patch version |
-| `rake version:commit` | Commit the version file change |
-| `rake version:tag` | Create a git tag for the version |
-| `rake version:untag` | Delete the version git tag |
-| `rake version:reset` | Reset the version bump commit |
-| `rake version:revert` | Revert the version bump commit |
-| `rake version:release` | Bump, commit, and tag (combined) |
-| `rake version:unrelease` | Untag and reset (combined) |
-| `rake version:github:release` | Push and create a GitHub release |
-| `rake version:github:unrelease` | Delete the GitHub release |
-| `rake version:github:list` | List GitHub releases |
-
-## Development
-
-```bash
-git clone https://github.com/gillisd/gempilot.git
-cd gempilot
-bundle install
-bundle exec rake
-```
-
-`rake` runs the Minitest suite, RSpec suite, and RuboCop.
-
-## License
-
-MIT License. See [LICENSE.txt](LICENSE.txt).
-```
-
-- [ ] **Step 2: Review for accuracy**
-
-Cross-check against:
-- `lib/gempilot/cli/commands/create.rb` — verify all `--options` are listed
-- `lib/gempilot/cli/commands/new.rb` — verify types (class, module, command)
-- `lib/gempilot/cli/commands/bump.rb` — verify patch/minor/major
-- `rakelib/version.rake` — verify all 12 task names match
-- `gempilot.gemspec` — verify Ruby version requirement
-
-- [ ] **Step 3: Commit**
-
-```bash
-git add README.md
-git commit -m "Replace scaffold README with project documentation"
-```