gempilot 0.2.0

data/lib/gempilot/project.rb

@@ -0,0 +1,111 @@
+require "pathname"
+require "warning"
+
+module Gempilot
+  ## Introspects a gem project to discover its name, module, and version.
+  class Project
+    class ProjectIntrospectionError < StandardError; end
+
+    REDEFINITION_WARNING = /previous definition of VERSION was here/
+    REINITIALIZATION_WARNING = /already initialized constant [^\s]+::VERSION/
+    private_constant :REDEFINITION_WARNING, :REINITIALIZATION_WARNING
+
+    using String::Inflectable
+
+    attr_reader :root
+
+    def initialize(root = Dir.pwd)
+      @root = Pathname(root)
+      @verifications = Set.new
+    end
+
+    def lib
+      root.join("lib")
+          .tap { verify_existence! it }
+    end
+
+    def lib_project
+      @lib_project ||= fetch_lib_project
+    end
+
+    def name
+      lib_project.basename.to_s
+    end
+
+    def klass
+      Object.const_get(name.camelize)
+    end
+
+    def version
+      @version ||= fetch_version
+    end
+
+    def refresh_version!
+      @version = fetch_version
+    end
+
+    def increment_version
+      version.next_version
+    end
+
+    def version_tag = version.tag
+
+    def version_value = version.value
+
+    def write_version!(old_version, new_version)
+      with_version_file do |f|
+        source = f.read
+
+        unless source.match?(Regexp.escape(old_version.value))
+          abort "Expected to find #{old_version.value} in #{f.path} but did not"
+        end
+
+        f.rewind
+        f.write source.gsub(old_version.value, new_version.value)
+      end
+    end
+
+    private
+
+    def with_version_file
+      version.path.open(File::RDWR, 0o644) do |f|
+        f.flock File::LOCK_EX
+        yield f
+        f.truncate(f.pos)
+      end
+    end
+
+    def fetch_lib_project
+      files = lib.glob("*.rb")
+      dirs = files.map { it.sub_ext("") }.select(&:directory?)
+      case dirs.count
+      in 0 then raise ProjectIntrospectionError, "Could not identify project dir"
+      in (2..)
+        msg = "Found more than one possible project name:\n  - #{dirs.join("\n  - ")}"
+        raise ProjectIntrospectionError, msg
+      in 1 then dirs.first
+      end
+    end
+
+    def fetch_version
+      Warning.ignore(REDEFINITION_WARNING)
+      Warning.ignore(REINITIALIZATION_WARNING)
+      path = lib_project
+             .join("version.rb")
+             .tap { verify_existence! it }
+             .tap { load it }
+
+      value = klass.const_get(:VERSION)
+
+      Version.new(path:, value:)
+    end
+
+    def verify_existence!(path)
+      return true if @verifications.member? path
+
+      raise ProjectIntrospectionError, "Expected #{path} to exist but does not" unless path.exist?
+
+      @verifications.add path
+    end
+  end
+end

data/lib/gempilot/strict_shell.rb

@@ -0,0 +1,18 @@
+require "rake"
+
+module Gempilot
+  ## Wraps Rake's sh to raise on non-zero exit status.
+  module StrictShell
+    include Rake::FileUtilsExt
+
+    private
+
+    def sh(*args, **kwargs)
+      super do |ok, res|
+        raise "Command #{args.join(" ").inspect} failed (exit #{res.exitstatus})" unless ok
+
+        [ok, res]
+      end
+    end
+  end
+end

data/lib/gempilot/version.rb

@@ -0,0 +1,3 @@
+module Gempilot
+  VERSION = "0.2.0".freeze
+end

data/lib/gempilot/version_tag.rb

@@ -0,0 +1,53 @@
+require "open3"
+
+module Gempilot
+  ## Manages git operations for version releases.
+  class VersionTag
+    include StrictShell
+
+    attr_reader :version
+
+    def initialize(version)
+      @version = version
+    end
+
+    def create
+      _, _, status = Open3.capture3("git", "diff", "--staged", "--quiet")
+      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}"
+    end
+
+    def tag
+      assert_last_commit_is_bump!
+      sh "git", "tag", version.tag
+    end
+
+    def untag
+      assert_last_commit_is_bump!
+      sh "git", "tag", "--delete", version.tag
+    end
+
+    def reset
+      assert_last_commit_is_bump!
+      sh "git", "reset", "--quiet", "--mixed", "HEAD~1"
+      sh "git", "restore", version.path.to_s
+    end
+
+    def revert
+      assert_last_commit_is_bump!
+      sh "git", "revert", "HEAD", "--no-edit"
+    end
+
+    private
+
+    def assert_last_commit_is_bump!
+      message, status = Open3.capture2("git", "log", "-1", "--pretty=%B")
+      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 ")
+    end
+  end
+end

data/lib/gempilot/version_task.rb

@@ -0,0 +1,108 @@
+require "rake/tasklib"
+require_relative "../gempilot"
+
+module Gempilot
+  ## Rake tasks for version lifecycle management.
+  class VersionTask < Rake::TaskLib
+    attr_reader :project
+
+    def initialize(root: Dir.pwd)
+      super()
+      @project = Project.new(root)
+      define_tasks
+    end
+
+    private
+
+    def define_tasks
+      define_version_tasks
+      define_version_composite_tasks
+      define_github_tasks
+    end
+
+    def define_version_tasks
+      project = @project
+
+      namespace :version do
+        define_current_task(project)
+        define_bump_task(project)
+        define_commit_task(project)
+        define_tag_task(project)
+        define_untag_task(project)
+        define_reset_task(project)
+        define_revert_task(project)
+      end
+    end
+
+    def define_version_composite_tasks
+      desc "Bump version, commit, and tag (rake version:release[minor])"
+      task "version:release", [:segment] => ["version:bump", "version:commit", "version:tag"]
+
+      desc "Untag and reset version"
+      task "version:unrelease" => ["version:untag", "version:reset"]
+    end
+
+    def define_current_task(project)
+      desc "Display the current version"
+      task(:current) { puts "Current version: #{project.version_value}" }
+    end
+
+    def define_bump_task(project)
+      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
+    end
+
+    def define_commit_task(project)
+      desc "Commit the version change"
+      task(:commit) { VersionTag.new(project.version).create }
+    end
+
+    def define_tag_task(project)
+      desc "Tag the current version"
+      task(:tag) { VersionTag.new(project.version).tag }
+    end
+
+    def define_untag_task(project)
+      desc "Untag the current version"
+      task(:untag) { VersionTag.new(project.version).untag }
+    end
+
+    def define_reset_task(project)
+      desc "Reset the last version bump commit"
+      task :reset do
+        VersionTag.new(project.version).reset
+        project.refresh_version!
+      end
+    end
+
+    def define_revert_task(project)
+      desc "Revert the last version bump commit"
+      task :revert do
+        VersionTag.new(project.version).revert
+        project.refresh_version!
+      end
+    end
+
+    def define_github_tasks
+      project = @project
+
+      namespace "version:github" do
+        desc "Create a GitHub release for the current version"
+        task(:release) { GithubRelease.new(project.version_tag).create }
+
+        desc "Delete the GitHub release for the current version"
+        task(:unrelease) { GithubRelease.new(project.version_tag).destroy }
+
+        desc "List GitHub releases"
+        task(:list) { GithubRelease.new(project.version_tag).list }
+      end
+    end
+  end
+end

data/lib/gempilot.rb

@@ -0,0 +1,17 @@
+require "zeitwerk"
+
+autoload :Open3, "open3"
+
+# CLI toolkit for creating and managing Ruby gems.
+module Gempilot
+  ROOT = Pathname(__dir__).parent.expand_path.freeze
+  LOADER = Zeitwerk::Loader.for_gem.tap do |l|
+    l.inflector.inflect("cli" => "CLI")
+    l.push_dir ROOT.join("lib/core_ext")
+    l.collapse ROOT.join("lib/core_ext/*/refinements")
+    l.setup
+  end
+
+  class Error < StandardError; end
+  class CommandError < Error; end
+end

data/notes.md

@@ -0,0 +1,31 @@
+# Setup todos
+* Remove .bak.spec file
+* Add files to gitignore
+  * /.idea
+  * Gemfile.lock
+* Set rubocop.yml ruby value
+* Use omakase rubocop settings
+* Run rubocop on all files
+* Add ENV['MT_NO_PLUGINS'] = '1' to Rakefile (and test helper?)
+* Add better test reporter to test helper
+* Add rake task for releasing
+* Set gem version to start version value
+* Set up git, perform initial commit
+* Set up zeitwerk
+* Set up bundle path and possibly use packaging
+* Remove dead test
+* Run rake to ensure everything works
+* Release?
+
+
+
+
+test helper plugin ignore:
+
+```ruby
+unless ENV["RM_INFO"]
+  ENV["MT_NO_PLUGINS"] = "1"
+  Minitest::Reporters.use! [Minitest::Reporters::DefaultReporter.new(color: true)]
+end
+```
+

metadata

@@ -0,0 +1,165 @@
+--- !ruby/object:Gem::Specification
+name: gempilot
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- David Gillis
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: command_kit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: warning
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+email:
+- david@flipmine.com
+executables:
+- gempilot
+extensions: []
+extra_rdoc_files: []
+files:
+- ".claude/skills/using-command-kit/SKILL.md"
+- ".claude/skills/using-command-kit/cli-example.rb"
+- ".claude/skills/using-command-kit/generator-pattern.rb"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- CLAUDE.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- data/templates/gem/Gemfile.erb
+- data/templates/gem/LICENSE.txt.erb
+- data/templates/gem/README.md.erb
+- data/templates/gem/Rakefile.erb
+- data/templates/gem/bin/console.erb
+- data/templates/gem/bin/setup.erb
+- data/templates/gem/dotfiles/github/workflows/ci.yml.erb
+- data/templates/gem/dotfiles/gitignore
+- data/templates/gem/dotfiles/rubocop.yml.erb
+- data/templates/gem/dotfiles/ruby-version.erb
+- data/templates/gem/exe/gem_name.erb
+- data/templates/gem/gemspec.erb
+- data/templates/gem/lib/gem_name.rb.erb
+- data/templates/gem/lib/gem_name/version.rb.erb
+- data/templates/gem/lib/gem_name_extension.rb.erb
+- data/templates/gem/rspec.erb
+- data/templates/gem/spec/gem_name_spec.rb.erb
+- data/templates/gem/spec/spec_helper.rb.erb
+- data/templates/gem/spec/zeitwerk_spec.rb.erb
+- data/templates/gem/test/gem_name_test.rb.erb
+- data/templates/gem/test/test_helper.rb.erb
+- 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
+- lib/core_ext/string/refinements/inflectable.rb
+- lib/gempilot.rb
+- lib/gempilot/cli.rb
+- lib/gempilot/cli/command.rb
+- lib/gempilot/cli/commands/bump.rb
+- lib/gempilot/cli/commands/console.rb
+- lib/gempilot/cli/commands/create.rb
+- lib/gempilot/cli/commands/destroy.rb
+- lib/gempilot/cli/commands/new.rb
+- lib/gempilot/cli/commands/release.rb
+- lib/gempilot/cli/gem_builder.rb
+- lib/gempilot/cli/gem_context.rb
+- lib/gempilot/cli/generator.rb
+- lib/gempilot/github_release.rb
+- lib/gempilot/project.rb
+- lib/gempilot/project/version.rb
+- lib/gempilot/strict_shell.rb
+- lib/gempilot/version.rb
+- lib/gempilot/version_tag.rb
+- lib/gempilot/version_task.rb
+- notes.md
+homepage: https://github.com/gillisd/gempilot
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/gillisd/gempilot
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.9
+specification_version: 4
+summary: A toolkit for creating, managing, and releasing your own rubygems
+test_files: []