v2/rails: Terminalwire::V2::Rails::Thor mixin + browser/file/dir/env helpers

v2/ruby/lib/terminalwire/v2/rails.rb

@@ -131,6 +131,25 @@ def file_exist?
         end
       end
 
+      # Drop-in Rails terminal mixin — the v2 equivalent of v1's `Terminalwire::Thor`.
+      # `include Terminalwire::V2::Rails::Thor` in your Thor CLI and it:
+      #   * streams I/O over the v2 wire (Terminalwire::V2::Server::Thor),
+      #   * exposes the client `session` (the shell delegator), and
+      #   * mixes in Rails route URL helpers (root_url, *_url, *_path) so commands like
+      #     login/browser-open can build links. The per-connection host is set by the
+      #     handler, so the *_url helpers resolve to the host the client connected on.
+      # The url_helpers go in `no_commands` so Thor doesn't register them as commands.
+      module Thor
+        def self.included(base)
+          base.include Terminalwire::V2::Server::Thor
+          base.class_eval do
+            no_commands do
+              include ::Rails.application.routes.url_helpers
+            end
+          end
+        end
+      end
+
       # Returns a Rack endpoint that serves `cli` over both protocols. Pass `v1:`/`v2:`
       # to override the handlers (tests, custom adapters); by default it builds the
       # stock v1 `Terminalwire::Rails::Thor` and v2 `Terminalwire::V2::Server::Rack`.

v2/ruby/lib/terminalwire/v2/server/thor.rb

@@ -23,6 +23,13 @@ def warn(*args) = args.each { |arg| shell.context.warn(arg.to_s) }
         def gets = shell.context.gets
         def getpass = shell.context.getpass
         def context = shell.context
+        # The client-side resources, exposed on the CLI instance like v1 (so a Thor
+        # command can call `browser.launch(url)`, `file.read(path)`, `env("HOME")`).
+        def browser = shell.context.browser
+        def file = shell.context.file
+        def directory = shell.context.directory
+        def env(name) = shell.context.env(name)
+        def client = shell.context
       end
 
       class Shell < ::Thor::Shell::Basic