kaze 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e59ed35aebe912f3109e4cf1937daa83a61d11235e2052d4d148c4d67f29fd52
-  data.tar.gz: 0c5844feaa1dd744199e50af4aecbb0f53ca8f5ea2a6060b6362b124f16a8762
+  metadata.gz: 701db9d43e1fa6af035b37096755ff20cad5d574ed2cf042d4ee9dad2b2513d0
+  data.tar.gz: e52ef54c1289863cac8afc289b569d5cf991e1dd1c43faea861593ee6116151e
 SHA512:
-  metadata.gz: a02c56cd8f4e53405776b9d1240b54b5fe6b6a71f01339a90fe83a04f0864ebef3f68a8d5a6f41e2a80ae9b3d4d70ce376c4a165ec4c38d9354bfe874b969d66
-  data.tar.gz: 512b952e164d688a07204f3d3137b39215b5753bdeab6a01543562d3a9156960d0e383ffdd0798270aa75440187fcaa939d756bab7c6316637ac8d00d71cfa52
+  metadata.gz: 67c562979bb3627648c660bd1c3ce6b85f132ee54e2bc71477651ec8969ee731da08910f957b77cfaa61defe24d998c94172f292ebc67c87559f01b867ca0d2f
+  data.tar.gz: 98f645b2b95a8141b2440ea180eae7092bf8d5b4b4f070f94fa420a03c790090eeee92b062a1b8fe53514e631593494a59d7ca341d530e5f26e06d38773f33ca

data/CHANGELOG.md

@@ -6,6 +6,16 @@ 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
@@ -185,7 +195,8 @@ 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.1...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

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,8 +7,33 @@ 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

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

@@ -1,4 +1,22 @@
 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' ])

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

@@ -1,4 +1,27 @@
 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' ])

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

@@ -1,4 +1,28 @@
 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' ])

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.1'
+  VERSION = '2.1.0'
 end

metadata

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