brunch 0.9.0 → 0.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4701eb90f48c72479c1c5018c76b0d8dc8c3c93accf4cd696f28fd75829321c5
-  data.tar.gz: 4b8116a2365dbc41672702a9be4180a6c93f7f21e3a7098df1d1e3ca1cad8576
+  metadata.gz: 5f7a05f3aae716ba9e82f616156c85380fad4437a5d0d440056a834999830fc6
+  data.tar.gz: dccd1027c1fb0a185807427cfe0ffbe06bc94362f656de08a064f52786c39ee2
 SHA512:
-  metadata.gz: 7ea73a21990f517294eb5255bce523ac49e3bc5ca7f71f2c2e55c9e57cf8c0d5d3125819a8db5563cc15904a02ee62f18e0b73449d13309adcd8e99d79246884
-  data.tar.gz: c61a44ca01705759b66512972a87e75040c3f9d3445731bf4b73e506a72259c8022b3617e12c20fdfc045e43869a19c0565702df9a18ce655774fa56dcf1c83e
+  metadata.gz: 550ae4c541eabe5196634628561c094e28039a578ccbb795c97ee41bb67b20fd48a58d4742bd685b877da57654784daa6a57004697422ad5b15f633199e9dc33
+  data.tar.gz: b6e4d92569d518d6ba19a8eb2b326996d0351a00cae53a03e4eecd23f0653a3cf5a6247a0db199b34050a47c49d8434e3ff6148860136dc99856fe8616f97ddc

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Changelog
 
-## Unreleased
+## 0.9.2 - 2026-10-05
+
+- Settle branch deletions automatically after the Git process exits, preserving
+  environments across `git branch -m` without requiring another Brunch command.
+  Handle `git branch -M` when the destination already has an environment, and
+  keep pending state if the background worker cannot start.
+
+## 0.9.1 - 2026-10-03
+
+- Replace `brunch ports` with `brunch list` and add `brunch watch` for a
+  continuously refreshed interactive view of branch environments.
 
 ## 0.9.0 - 2026-10-02
 

data/README.md

@@ -176,15 +176,22 @@ Then:
 cd ../feature-a
 
 brunch port
-brunch ports
+brunch list
 ```
 
 `brunch port` prints the current worktree's port.
 
-`brunch ports` groups the current and previously activated branches under each
+`brunch list` groups the current and previously activated branches under each
 worktree. Stopped branches appear in gray and retain their worktree's port for
 the next activation.
 
+```bash
+brunch watch
+```
+
+`brunch watch` shows the same view and refreshes it every second. Press
+`Ctrl-C` to stop watching.
+
 Switching branches inside one worktree does not affect environments running in other worktrees.
 
 If you create a worktree with plain Git:
@@ -294,15 +301,20 @@ If a custom `remove` command depends on project files, those files must be commi
 `brunch cleanup` removes environments belonging to worktrees that no longer exist.
 
 With `git-hooks-ext` 0.6.0+, deleting a local branch queues its Brunch
-environments for removal. On the next regular Brunch command, such as
-`brunch status` or `brunch cleanup`, Brunch checks the current refs and removes
-the branch's managed resources, including Compose containers and volumes.
-It also checks for missing branches when Git emits no deletion event. This
-delay protects environments when `git branch -m` reports a deletion before
-creating the renamed branch. A renamed branch keeps its environment under the
-new name. If Git reflogs are unavailable and Brunch cannot distinguish a
-rename from a deletion, it keeps the environment. A later `brunch restart`
-recreates the container in the same Compose project, preserving named volumes.
+environments for removal. A detached worker waits for the Git process that
+triggered the hook to exit, then checks the final refs and reflogs. A rename
+keeps its environment under the new name; a deletion removes the managed
+resources, including Compose containers and volumes. A Brunch command run
+while the identified Git process is still working leaves the queued environment
+alone. If the process cannot be identified or the worker cannot start, the next
+regular Brunch command after Git exits, such as `brunch status` or
+`brunch cleanup`, performs the check. Brunch also checks for
+missing branches when Git emits no deletion event, on the next regular command.
+If Git reflogs are unavailable and Brunch cannot distinguish a rename from a
+deletion, it keeps the environment. A later `brunch restart` recreates the
+container in the same Compose project, preserving named volumes.
+For `git branch -M old target`, when `target` already has a Brunch environment,
+Brunch removes that overwritten environment and moves `old` to `target`.
 
 ## Commands
 
@@ -331,11 +343,17 @@ brunch port
 Print the current worktree's port.
 
 ```bash
-brunch ports
+brunch list
 ```
 
 List current and stopped branch environments grouped by worktree.
 
+```bash
+brunch watch
+```
+
+Continuously refresh the branch-environment list in an interactive terminal.
+
 ```bash
 brunch stop
 ```

data/lib/brunch/branch_settlement.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "open3"
+require "securerandom"
+
+module Brunch
+  module BranchSettlement
+    module_function
+
+    def git_ancestor(pid = Process.ppid)
+      32.times do
+        process = process_info(pid)
+        break unless process
+
+        return { "pid" => pid, "started" => process.fetch(:started) } if File.basename(process.fetch(:command)) == "git"
+
+        pid = process.fetch(:parent)
+        break if pid <= 1
+      end
+      nil
+    end
+
+    def running?(identity)
+      return false unless identity.is_a?(Hash) && identity["pid"].is_a?(Integer) && identity["started"].is_a?(String)
+
+      process = process_info(identity.fetch("pid"))
+      return process_exists?(identity.fetch("pid")) unless process
+
+      process.fetch(:started) == identity.fetch("started") && !process.fetch(:state).start_with?("Z")
+    end
+
+    def process_exists?(pid)
+      Process.kill(0, pid)
+      true
+    rescue Errno::ESRCH
+      false
+    rescue Errno::EPERM
+      true
+    end
+
+    def token = SecureRandom.hex(16)
+
+    def spawn_worker(root, ref, token)
+      executable = File.expand_path("../../exe/brunch", __dir__)
+      pid = Process.spawn(Gem.ruby, executable, "branch-settled", ref, token,
+                          chdir: root, in: File::NULL, out: File::NULL, err: File::NULL,
+                          pgroup: true, close_others: true)
+      Process.detach(pid)
+    end
+
+    def wait_for(identity)
+      sleep 0.1 while running?(identity)
+    end
+
+    def process_info(pid)
+      output, status = Open3.capture2("ps", "-p", pid.to_s, "-o", "ppid=,lstart=,stat=,comm=", err: File::NULL)
+      return unless status.success?
+
+      fields = output.strip.split(/\s+/, 8)
+      return unless fields.length == 8 && fields[0].match?(/\A\d+\z/)
+
+      { parent: fields[0].to_i, started: fields[1, 5].join(" "), state: fields[6], command: fields[7] }
+    rescue Errno::ENOENT
+      nil
+    end
+  end
+end

data/lib/brunch/cli.rb

@@ -24,7 +24,7 @@ module Brunch
       in ["install"] then Hooks.install
       in ["version"] | ["--version"] | ["-v"] then puts Brunch::VERSION
       else
-        unless arguments.first == "branch-deleted"
+        unless %w[branch-deleted branch-settled].include?(arguments.first)
           reconcile_deleted_branches
           reconcile_missing_branches
         end

data/lib/brunch/hooks.rb

@@ -27,7 +27,9 @@ module Brunch
       when "branch-created", "remote-branch-created", "remote-branch-updated"
         CLI.start(["register", arguments.fetch(0)])
       when "branch-deleted"
-        CLI.start(["branch-deleted", arguments.fetch(0), arguments.fetch(2)])
+        with_branch_deletion_hook do
+          CLI.start(["branch-deleted", arguments.fetch(0), arguments.fetch(2)])
+        end
       when "worktree-created", "worktree-removed", "worktree-moved", "worktree-pruned", "worktree-repaired"
         CLI.start(["worktree-event", event, *arguments])
       else
@@ -43,6 +45,15 @@ module Brunch
     end
     private_class_method :git_output
 
+    def with_branch_deletion_hook
+      previous = ENV.fetch("BRUNCH_BRANCH_DELETION_HOOK", nil)
+      ENV["BRUNCH_BRANCH_DELETION_HOOK"] = "1"
+      yield
+    ensure
+      previous ? ENV["BRUNCH_BRANCH_DELETION_HOOK"] = previous : ENV.delete("BRUNCH_BRANCH_DELETION_HOOK")
+    end
+    private_class_method :with_branch_deletion_hook
+
     def install_hook(path, event)
       contents = hook_contents(event)
       abort "Refusing to replace existing hook: #{path}" if File.exist?(path) && File.read(path) != contents && !brunch_hook?(path)

data/lib/brunch/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Brunch
-  VERSION = "0.9.0"
+  VERSION = "0.9.2"
 end

data/lib/brunch/worktree_mode.rb

@@ -21,15 +21,17 @@ module Brunch
         worktree_activate(repo_root)
       in ["stop"] then worktree_stop(repo_root)
       in ["branch-deleted", ref, oid] then record_deleted_branch(ref, oid)
+      in ["branch-settled", ref, token] then settle_deleted_branch(ref, token)
       in ["cleanup"] | ["register", _] then worktree_cleanup
       in ["status"] then worktree_status
-      in ["ports"] then worktree_ports
+      in ["list"] then worktree_ports
+      in ["watch"] then worktree_watch
       in ["port"] then worktree_port
       in ["logs", *arguments] then worktree_logs(arguments)
       in ["run", "--", *command] if !command.empty? then worktree_run(command)
       in ["doctor"] then worktree_doctor
       else
-        warn "Usage: brunch {activate|start <current-ref>|stop|restart|status|ports|port|logs [args]|run -- <cmd>|doctor|cleanup}"
+        warn "Usage: brunch {activate|start <current-ref>|stop|restart|status|list|watch|port|logs [args]|run -- <cmd>|doctor|cleanup}"
         return 64
       end
       0
@@ -260,27 +262,58 @@ module Brunch
     end
 
     def record_deleted_branch(ref, oid)
+      git = BranchSettlement.git_ancestor if ENV["BRUNCH_BRANCH_DELETION_HOOK"] == "1"
+      token = BranchSettlement.token if git
+      recorded = false
       with_state_lock do |data|
         records = data.fetch("worktrees", {}).values
         next unless records.any? { |record| record.fetch("environments", {}).key?(ref) }
 
-        (data["deleted_branches"] ||= {})[ref] = oid
+        (data["deleted_branches"] ||= {})[ref] = git ? { "oid" => oid, "git" => git, "token" => token } : oid
+        recorded = true
       end
+      BranchSettlement.spawn_worker(repo_root, ref, token) if recorded && git
+    rescue SystemCallError => e
+      warn "Could not start branch cleanup worker: #{e.message}; cleanup will run on the next Brunch command."
     end
 
     def reconcile_deleted_branches
       pending = state.fetch("deleted_branches", {})
       return if pending.empty?
 
-      refs = local_branch_refs
-      pending.each do |ref, oid|
+      pending.each_key { |ref| settle_deleted_branch(ref) }
+    end
+
+    def settle_deleted_branch(ref, expected_token = nil)
+      if expected_token
+        queued = state.fetch("deleted_branches", {})[ref]
+        return unless queued.is_a?(Hash) && queued["token"] == expected_token
+
+        BranchSettlement.wait_for(queued.fetch("git"))
+      end
+      directory = File.join(state_root, "branch-locks")
+      FileUtils.mkdir_p(directory)
+      File.open(File.join(directory, Digest::SHA256.hexdigest(ref)), "w") do |lock|
+        lock.flock(File::LOCK_EX)
+        pending = state.fetch("deleted_branches", {})[ref]
+        next unless pending
+        next if expected_token && (!pending.is_a?(Hash) || pending["token"] != expected_token)
+
+        identity = pending["git"] if pending.is_a?(Hash)
+        next if identity && BranchSettlement.running?(identity)
+
+        oid = pending.is_a?(Hash) ? pending.fetch("oid") : pending
+        refs = local_branch_refs
         unless refs.include?("refs/heads/#{ref}")
           renamed = renamed_branch(ref, oid, refs)
           next if renamed == :unknown
 
-          renamed ? rename_branch_environments(ref, renamed) : remove_branch_environments(ref)
+          renamed ? rename_branch_environments(ref, renamed, replace_existing: pending.is_a?(Hash)) : remove_branch_environments(ref)
+        end
+        with_state_lock do |data|
+          current = data.fetch("deleted_branches", {})[ref]
+          data.fetch("deleted_branches").delete(ref) if current == pending
         end
-        with_state_lock { |data| data.fetch("deleted_branches").delete(ref) }
       end
     end
 
@@ -324,7 +357,11 @@ module Brunch
       :unknown if missing_reflog
     end
 
-    def rename_branch_environments(old_ref, new_ref)
+    def rename_branch_environments(old_ref, new_ref, replace_existing: false)
+      records = state.fetch("worktrees", {}).values
+      return unless records.any? { |record| record.fetch("environments", {}).key?(old_ref) }
+
+      remove_branch_environments(new_ref) if replace_existing
       state.fetch("worktrees", {}).each_key do |id|
         with_worktree_lock(id) do
           with_state_lock do |data|
@@ -394,6 +431,20 @@ module Brunch
       end
     end
 
+    def worktree_watch
+      raise CLI::OperationError, "brunch watch requires an interactive terminal." unless $stdout.tty?
+
+      loop do
+        print "\e[2J\e[H"
+        worktree_ports
+        puts "\nRefreshing every second. Press Ctrl-C to stop."
+        $stdout.flush
+        sleep 1
+      end
+    rescue Interrupt
+      puts "\nStopped watching."
+    end
+
     def worktree_port
       record, = current_worktree_entry(state)
       raise CLI::OperationError, "No Brunch environment in this worktree." unless record

data/lib/brunch.rb

@@ -2,6 +2,7 @@
 
 require_relative "brunch/version"
 require_relative "brunch/managers"
+require_relative "brunch/branch_settlement"
 require_relative "brunch/worktree_mode"
 require_relative "brunch/cli"
 require_relative "brunch/hooks"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brunch
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.2
 platform: ruby
 authors:
 - Maciej Ciemborowicz
@@ -92,6 +92,7 @@ files:
 - brunch.webp
 - exe/brunch
 - lib/brunch.rb
+- lib/brunch/branch_settlement.rb
 - lib/brunch/cli.rb
 - lib/brunch/hooks.rb
 - lib/brunch/managers.rb