kaze 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 858087e59b76bb15ec6cc06701b2ba201c4aacb12cf592cdfbc37f1304b805c1
-  data.tar.gz: ed23682c9b61226b8201240b0b43e41a660f1745d986c2f4e1b6644aa4d26003
+  metadata.gz: 701db9d43e1fa6af035b37096755ff20cad5d574ed2cf042d4ee9dad2b2513d0
+  data.tar.gz: e52ef54c1289863cac8afc289b569d5cf991e1dd1c43faea861593ee6116151e
 SHA512:
-  metadata.gz: 888b37a89b65ee26046232a7f9dffcbe028500726c7082911ed74eea0dd4fe27f78d640661e6847d2ace7921544dfe8df67b4c28688ef6dfb00f3f7b140094a8
-  data.tar.gz: db51173dd6dc0e73686a13df9e4bc0af2afdb50fdde496c43c98860e818d64a0171b9d50142b1d824aa8a89bec4a77657642cc80edbfe072f0274a01436ec736
+  metadata.gz: 67c562979bb3627648c660bd1c3ce6b85f132ee54e2bc71477651ec8969ee731da08910f957b77cfaa61defe24d998c94172f292ebc67c87559f01b867ca0d2f
+  data.tar.gz: 98f645b2b95a8141b2440ea180eae7092bf8d5b4b4f070f94fa420a03c790090eeee92b062a1b8fe53514e631593494a59d7ca341d530e5f26e06d38773f33ca

data/CHANGELOG.md

@@ -6,6 +6,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [2.1.0] - 2026-10-22
+
+### Added
+
+- A `kaze upgrade [STACK]` command. Kaze copies files into an application and does not own them afterwards, so `kaze install` cannot tell a leftover from an older version apart from something you wrote, and has always left both alone. `upgrade` resolves that by asking instead of guessing: it lists the files an earlier Kaze installed that this version no longer ships, waits for you to agree, removes them, and then runs the normal install.
+
+  Only paths Kaze itself shipped are ever offered — the list per stack is fixed in the source, so nothing you added alongside them can be caught by it, and a directory is removed only once it is empty. `--dry-run` prints the list and stops; `--force` skips the prompt for scripts. Declining exits non-zero and changes nothing.
+
+  This replaces the manual file list in the 2.0.0 upgrade notes below. On the React stack it is the difference between an upgraded application building and not: `tsc` typechecks every file under `app/javascript`, so the old `Pages/Profile/Edit.tsx` fails the build until it is gone.
+
+## [2.0.1] - 2026-10-22
+
+### Fixed
+
+- `kaze install` run through `bundle exec` no longer fails to build gems with native extensions. Bundler exports `RUBYOPT` and `BUNDLE_*` so child processes join its bundle, which is wrong for a nested bundler call: the `bundle add` that kaze shells out to inherited them, and `extconf.rb` then loaded `bundler/setup` and tried to resolve a lockfile needing the very gem it was about to compile, failing with `Could not find bcrypt-… in locally installed gems`. The bundler shell-outs now run inside `Bundler.with_unbundled_env`.
+
+  The README's own instructions — `gem install kaze` then `kaze install` — were never affected, because that runs outside bundler. This reached `bundle exec kaze install`, which is how kaze's CI invokes it and how anyone who adds kaze to their Gemfile would.
+
 ## [2.0.0] - 2026-10-22
 
 ### Added
@@ -177,7 +195,9 @@ Together these take a freshly scaffolded Inertia application from seven npm advi
 
 Releases before 1.0.0 are not catalogued here. See the [tags](https://github.com/cuonggt/kaze/tags) for their history.
 
-[Unreleased]: https://github.com/cuonggt/kaze/compare/v2.0.0...HEAD
+[Unreleased]: https://github.com/cuonggt/kaze/compare/v2.1.0...HEAD
+[2.1.0]: https://github.com/cuonggt/kaze/compare/v2.0.1...v2.1.0
+[2.0.1]: https://github.com/cuonggt/kaze/compare/v2.0.0...v2.0.1
 [2.0.0]: https://github.com/cuonggt/kaze/compare/v1.4.0...v2.0.0
 [1.4.0]: https://github.com/cuonggt/kaze/compare/v1.3.1...v1.4.0
 [1.3.1]: https://github.com/cuonggt/kaze/compare/v1.3.0...v1.3.1

data/README.md

@@ -75,3 +75,15 @@ bin/dev
 ```
 
 Next, you may navigate to your application's `/login` or `/register` URLs in your web browser. All of Kaze's routes are defined within the `config/routes.rb` file.
+
+## Upgrading
+
+Kaze copies files into your application and does not own them afterwards, so re-running `kaze install` cannot know whether a file it no longer ships was left over from an older version or written by you. `kaze upgrade` resolves that by asking:
+
+```
+kaze upgrade react
+```
+
+It lists the files an earlier Kaze installed that this version no longer ships, waits for you to agree, removes them, and then runs the normal install. Only files Kaze itself shipped are ever listed — anything you added alongside them is untouched, and a directory is removed only once it is empty. Pass `--dry-run` to see the list and stop, or `--force` to skip the prompt in a script.
+
+Upgrading from 1.x to 2.x matters on the React stack in particular: `tsc` typechecks every file under `app/javascript`, so the old `Pages/Profile/Edit.tsx` fails the build until it is gone.

data/lib/kaze/commands/app/base_stack.rb

@@ -7,12 +7,47 @@ class Kaze::Commands::App::BaseStack
     raise NotImplementedError
   end
 
+  # Paths from this stack's REMOVED_PATHS that the application still has. Only
+  # ever a subset of that list: `kaze upgrade` never touches a path Kaze did not
+  # put there itself.
+  def removable_paths
+    self.class::REMOVED_PATHS.select { |path| File.exist?("#{Dir.pwd}/#{path}") }
+  end
+
+  def remove_paths(paths)
+    paths.each { |path| FileUtils.rm_f("#{Dir.pwd}/#{path}") }
+
+    prune_empty_directories(paths)
+  end
+
   private
 
+  # Deleting the last file in a directory leaves the directory behind. Walk back
+  # up from each one removing those that are now empty, and stop at the first
+  # that is not -- a directory with anything left in it is the application's.
+  def prune_empty_directories(paths)
+    paths.map { |path| File.dirname("#{Dir.pwd}/#{path}") }.uniq.sort_by(&:length).reverse.each do |dir|
+      while dir.start_with?("#{Dir.pwd}/app/") && Dir.exist?(dir) && Dir.empty?(dir)
+        Dir.rmdir(dir)
+        dir = File.dirname(dir)
+      end
+    end
+  end
+
   def bundle_command
     @bundle_command ||= File.exist?("#{Dir.pwd}/bin/bundle") ? "#{Dir.pwd}/bin/bundle" : 'bundle'
   end
 
+  # Bundler exports RUBYOPT and BUNDLE_* so that child processes join its
+  # bundle. That is wrong for a nested bundler call: when kaze itself is run
+  # through `bundle exec`, a `bundle add` it shells out to inherits them, and
+  # any gem with a native extension fails to build, because extconf.rb loads
+  # bundler/setup and tries to resolve a lockfile needing the very gem it is
+  # about to compile. Shell out to bundler with that environment removed.
+  def run_bundle_command(command)
+    Bundler.with_unbundled_env { run_command(command) }
+  end
+
   def install_gems(gems = [], group = nil)
     installed_gems = Bundler::Definition.build("#{Dir.pwd}/Gemfile", nil, {}).dependencies.map(&:name)
 
@@ -20,7 +55,7 @@ class Kaze::Commands::App::BaseStack
 
     return true if gem_being_installed.empty?
 
-    status = run_command("#{bundle_command} add #{gem_being_installed.join(" ")}#{group ? " --group \"#{group}\"" : ""}")
+    status = run_bundle_command("#{bundle_command} add #{gem_being_installed.join(" ")}#{group ? " --group \"#{group}\"" : ""}")
 
     status.success?
   end
@@ -32,7 +67,7 @@ class Kaze::Commands::App::BaseStack
 
     return true if gems_being_removed.empty?
 
-    status = run_command("#{bundle_command} remove #{gems_being_removed.join(" ")}")
+    status = run_bundle_command("#{bundle_command} remove #{gems_being_removed.join(" ")}")
 
     status.success?
   end

data/lib/kaze/commands/app/hotwire_stack.rb

@@ -1,9 +1,27 @@
 class Kaze::Commands::App::HotwireStack < Kaze::Commands::App::BaseStack
+  # Paths that earlier versions of Kaze installed here and this version no longer
+  # ships. `kaze upgrade` offers to delete whichever of them an application still
+  # has; anything removed in a future version belongs on this list too.
+  REMOVED_PATHS = [
+    'app/controllers/profile_controller.rb',
+    'app/controllers/password_controller.rb',
+    'app/components/nav_link_component.rb',
+    'app/components/responsive_nav_link_component.rb',
+    'app/views/layouts/_navigation.html.erb',
+    'app/views/profile/destroy.turbo_stream.erb',
+    'app/views/profile/edit.html.erb',
+    'app/views/profile/partials/_confirm_user_deletion_modal.html.erb',
+    'app/views/profile/partials/_delete_user_form.html.erb',
+    'app/views/profile/partials/_update_appearance_form.html.erb',
+    'app/views/profile/partials/_update_password_form.html.erb',
+    'app/views/profile/partials/_update_profile_information_form.html.erb'
+  ].freeze
+
   def install
     # Gems...
     return unless remove_gems([ 'sprockets-rails', 'stimulus-rails' ])
     return unless install_gems([ 'propshaft', 'view_component', 'turbo-rails', 'dotenv', 'bcrypt' ])
-    return unless run_command("#{bundle_command} add tailwindcss-rails --version=\"~> 4.0\"").success?
+    return unless run_bundle_command("#{bundle_command} add tailwindcss-rails --version=\"~> 4.0\"").success?
     return unless install_gems([ 'hotwire-livereload' ], 'development')
     return unless install_gems([ 'factory_bot_rails', 'faker' ], 'development, test')
 

data/lib/kaze/commands/app/inertia_react_stack.rb

@@ -1,9 +1,32 @@
 class Kaze::Commands::App::InertiaReactStack < Kaze::Commands::App::BaseStack
+  # Paths that earlier versions of Kaze installed here and this version no longer
+  # ships. `kaze upgrade` offers to delete whichever of them an application still
+  # has; anything removed in a future version belongs on this list too.
+  REMOVED_PATHS = [
+    'app/controllers/profile_controller.rb',
+    'app/controllers/password_controller.rb',
+    'app/javascript/Components/Checkbox.tsx',
+    'app/javascript/Components/DangerButton.tsx',
+    'app/javascript/Components/Dropdown.tsx',
+    'app/javascript/Components/InputLabel.tsx',
+    'app/javascript/Components/Modal.tsx',
+    'app/javascript/Components/NavLink.tsx',
+    'app/javascript/Components/PrimaryButton.tsx',
+    'app/javascript/Components/ResponsiveNavLink.tsx',
+    'app/javascript/Components/SecondaryButton.tsx',
+    'app/javascript/Components/TextInput.tsx',
+    'app/javascript/Pages/Profile/Edit.tsx',
+    'app/javascript/Pages/Profile/Partials/DeleteUserForm.tsx',
+    'app/javascript/Pages/Profile/Partials/UpdateAppearanceForm.tsx',
+    'app/javascript/Pages/Profile/Partials/UpdatePasswordForm.tsx',
+    'app/javascript/Pages/Profile/Partials/UpdateProfileInformationForm.tsx'
+  ].freeze
+
   def install
     # Gems...
     return unless remove_gems([ 'sprockets-rails', 'turbo-rails', 'stimulus-rails' ])
     return unless install_gems([ 'propshaft', 'inertia_rails', 'vite_rails', 'dotenv', 'bcrypt', 'js-routes' ])
-    return unless run_command("#{bundle_command} add tailwindcss-rails --version=\"~> 4.0\"").success?
+    return unless run_bundle_command("#{bundle_command} add tailwindcss-rails --version=\"~> 4.0\"").success?
     return unless install_gems([ 'factory_bot_rails', 'faker' ], 'development, test')
 
     # NPM Packages...

data/lib/kaze/commands/app/inertia_vue_stack.rb

@@ -1,9 +1,33 @@
 class Kaze::Commands::App::InertiaVueStack < Kaze::Commands::App::BaseStack
+  # Paths that earlier versions of Kaze installed here and this version no longer
+  # ships. `kaze upgrade` offers to delete whichever of them an application still
+  # has; anything removed in a future version belongs on this list too.
+  REMOVED_PATHS = [
+    'app/controllers/profile_controller.rb',
+    'app/controllers/password_controller.rb',
+    'app/javascript/Components/Checkbox.vue',
+    'app/javascript/Components/DangerButton.vue',
+    'app/javascript/Components/Dropdown.vue',
+    'app/javascript/Components/DropdownLink.vue',
+    'app/javascript/Components/InputLabel.vue',
+    'app/javascript/Components/Modal.vue',
+    'app/javascript/Components/NavLink.vue',
+    'app/javascript/Components/PrimaryButton.vue',
+    'app/javascript/Components/ResponsiveNavLink.vue',
+    'app/javascript/Components/SecondaryButton.vue',
+    'app/javascript/Components/TextInput.vue',
+    'app/javascript/Pages/Profile/Edit.vue',
+    'app/javascript/Pages/Profile/Partials/DeleteUserForm.vue',
+    'app/javascript/Pages/Profile/Partials/UpdateAppearanceForm.vue',
+    'app/javascript/Pages/Profile/Partials/UpdatePasswordForm.vue',
+    'app/javascript/Pages/Profile/Partials/UpdateProfileInformationForm.vue'
+  ].freeze
+
   def install
     # Gems...
     return unless remove_gems([ 'sprockets-rails', 'turbo-rails', 'stimulus-rails' ])
     return unless install_gems([ 'propshaft', 'inertia_rails', 'vite_rails', 'dotenv', 'bcrypt', 'js-routes' ])
-    return unless run_command("#{bundle_command} add tailwindcss-rails --version=\"~> 4.0\"").success?
+    return unless run_bundle_command("#{bundle_command} add tailwindcss-rails --version=\"~> 4.0\"").success?
     return unless install_gems([ 'factory_bot_rails', 'faker' ], 'development, test')
 
     # NPM Packages...

data/lib/kaze/commands/app.rb

@@ -7,10 +7,7 @@ class Kaze::Commands::App < Thor
 
   desc 'install [STACK]', 'Install the Kaze controllers and resources. Supported stacks: hotwire, react, vue.'
   def install(stack = 'hotwire')
-    unless File.exist?("#{Dir.pwd}/bin/rails")
-      say 'Kaze must be run in a new Rails application.', :red
-      exit 1
-    end
+    ensure_rails_application
 
     # The stack installers stop at the first step that fails, so a falsy return
     # means the application is half-installed. Exiting non-zero keeps that from
@@ -21,8 +18,56 @@ class Kaze::Commands::App < Thor
     exit 1
   end
 
+  desc 'upgrade [STACK]', 'Remove files an earlier Kaze installed that this version no longer ships, then install.'
+  method_option :force, type: :boolean, default: false, aliases: '-f', desc: 'Skip the confirmation prompt.'
+  method_option :'dry-run', type: :boolean, default: false, desc: 'List what would be removed and stop.'
+  def upgrade(stack = 'hotwire')
+    ensure_rails_application
+
+    stack = StackFactory.make(stack.to_sym)
+    paths = stack.removable_paths
+
+    if paths.empty?
+      say 'Nothing to remove. This application has none of the files earlier versions installed.', :green
+    else
+      say "Kaze no longer ships #{paths.length} #{paths.length == 1 ? 'file' : 'files'} this application still has:", :yellow
+      say ''
+      paths.each { |path| say "  #{path}" }
+      say ''
+      say 'They are yours now, so check for your own changes before agreeing.', :yellow
+
+      return if options[:'dry-run']
+
+      unless options[:force] || yes?('Remove them? [y/N]')
+        say 'Nothing was removed.', :red
+        exit 1
+      end
+
+      stack.remove_paths(paths)
+
+      say ''
+      say "Removed #{paths.length} #{paths.length == 1 ? 'file' : 'files'}.", :green
+      say ''
+    end
+
+    return if options[:'dry-run']
+
+    exit 1 unless stack.install
+  rescue => e
+    say e.message, :red
+    exit 1
+  end
+
   desc 'version', 'Show Kaze version'
   def version
     puts Kaze::VERSION
   end
+
+  private
+    def ensure_rails_application
+      return if File.exist?("#{Dir.pwd}/bin/rails")
+
+      say 'Kaze must be run in a new Rails application.', :red
+      exit 1
+    end
 end

data/lib/kaze/version.rb

@@ -1,3 +1,3 @@
 module Kaze
-  VERSION = '2.0.0'
+  VERSION = '2.1.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kaze
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Cuong Giang