localvault 1.12.1 → 1.12.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c37fd43d64105bf78e7501e458c98159958c4a6eca101d6716a3781b6bbb61f
-  data.tar.gz: 9f869cee27f7c118f91acf009d85cb0cef9204d9a99ada99b59939c63f7c2b22
+  metadata.gz: 02acc26385f42007abd7ba033716d5755f8a7c147a2f81a022ac839508cc4909
+  data.tar.gz: 84b8ac3eda467e9df18a8befa60eff2879b2ff838a23d45cee3b65cf72134e96
 SHA512:
-  metadata.gz: e503618d966e392d38a84969dae01d5355fcbccef921bad3f738a33b17139c71782e880f375756d865f1457b2c3fe23faf1175d65700caab1e5a3c1a5220e52d
-  data.tar.gz: 12bbf4acd6091c45afda3489035977e88169cce34e0313f51c8f75d8d35df71379fa6799af4e1d8e6ad252dc69971f3c41d09ee65c8aaf72ec83b9b748b54cc1
+  metadata.gz: 162ac0715abff981feeb7b8f2209c98e50d73c2e7061270fbc399075405ab8aed4fc4cd987d9a9286275e5b0c667b0e0793b8bddf74e969bbc069d5ce9fe7e94
+  data.tar.gz: 1ea2253c3bf76d5f272583a8f86107b0c15c6dd1f39c68f2f44530749da2f659ae642e4294b23ff25f89fcb12204968e6e5b5736afbeb170e45390b1055363f5

data/lib/localvault/cli/help_shell.rb

@@ -0,0 +1,84 @@
+require "thor"
+
+module LocalVault
+  class CLI
+    # Colors every help surface — the main screen, `help COMMAND`, and
+    # subcommand namespaces — by hooking the shell Thor already routes all
+    # help output through, rather than colorizing at each call site.
+    #
+    # Thor disables color itself when stdout is not a TTY, so piped output
+    # stays plain.
+    class HelpShell < Thor::Shell::Color
+      # "Usage:", "Options:", "Description:", "Runtime options:"
+      LABEL = /\A([A-Z][A-Za-z ]*:)\s*\z/
+      # A leading run of caps: "GETTING STARTED", "NESTED KEY (dot-notation)"
+      HEADING = /\A(\s*)([A-Z][A-Z0-9'\/\-]*(?: [A-Z0-9'\/\-]+)*)(?=\z|[\s(:])/
+
+      def say(message = "", color = nil, force_new_line = (message.to_s !~ /( |\t)\Z/))
+        if color.nil? && message.is_a?(String)
+          message = message.lines.map { |line| decorate(line.chomp) }.join("\n")
+        end
+        super
+      end
+
+      # Thor word-wraps long descriptions, which collapses the alignment of
+      # example blocks (`localvault set K V     # comment` loses its spacing).
+      # Lines flagged with \x05 — Thor's no-wrap marker, which every example in
+      # our long_desc blocks already carries — are printed verbatim instead, so
+      # examples stay aligned while prose still wraps to the terminal.
+      def print_wrapped(message, options = {})
+        indent = options[:indent] || 0
+        prose  = []
+
+        message.to_s.lines.each do |line|
+          line = line.chomp
+          if line.lstrip.start_with?("\x05")
+            wrap_prose(prose, options)
+            stdout.puts("#{" " * indent}#{decorate(line.sub("\x05", ''))}")
+          elsif line.strip.empty?
+            wrap_prose(prose, options)
+            stdout.puts
+          else
+            prose << line
+          end
+        end
+
+        wrap_prose(prose, options)
+      end
+
+      # Option tables: green the flag column ("-v, [--vault=VAULT]").
+      def print_table(array, options = {})
+        array = array.map do |row|
+          first, *rest = row
+          first.is_a?(String) && first.strip.start_with?("-") ? [set_color(first, :green), *rest] : row
+        end
+        super
+      end
+
+      private
+
+      # Hand a run of prose lines back to Thor's wrapper, then reset the buffer.
+      def wrap_prose(lines, options)
+        return if lines.empty?
+        text = lines.join("\n")
+        lines.clear
+        return if text.strip.empty?
+        Thor::Shell::Basic.instance_method(:print_wrapped)
+          .bind_call(self, text.lines.map { |l| decorate(l.chomp) }.join("\n"), options)
+      end
+
+      def decorate(line)
+        return line unless can_display_colors?
+
+        if (match = LABEL.match(line))
+          return line.sub(match[1], set_color(match[1], :cyan, true))
+        end
+
+        match = HEADING.match(line)
+        return line unless match && match[2].length >= 4
+
+        "#{match[1]}#{set_color(match[2], :cyan, true)}#{line[(match[1].length + match[2].length)..]}"
+      end
+    end
+  end
+end

data/lib/localvault/cli.rb

@@ -66,7 +66,9 @@ module LocalVault
 
     def self.start(given_args = ARGV, config = {})
       require_relative "cli/error_presenter"
-      config[:shell] ||= Thor::Base.shell.new
+      require_relative "cli/help_shell"
+      Thor::Base.shell = HelpShell   # subcommand namespaces build their own shells
+      config[:shell] ||= HelpShell.new
       result = dispatch(nil, normalize_legacy_group_option(given_args.dup), nil, config)
       result.is_a?(CommandStatus) ? result.code : 0
     rescue Thor::Error => error
@@ -150,8 +152,6 @@ module LocalVault
       rendered = sections.map { |title, names| [title, names.flat_map { |n| help_rows_for(n) }] }
       width = rendered.flat_map { |_, rows| rows.map { |usage, _| usage.length } }.max + 4
 
-      say_header = ->(text) { shell.say shell.set_color(text, :cyan, true) }
-
       shell.say ""
       shell.say shell.set_color("LocalVault", :cyan, true) + " — encrypted local secrets vault with MCP support for AI agents"
       shell.say "  https://inventlist.com/tools/localvault"
@@ -159,22 +159,22 @@ module LocalVault
       rendered.each do |title, rows|
         next if rows.empty?
         shell.say ""
-        say_header.call(title)
+        shell.say title
         rows.each do |usage, desc|
           shell.say "  localvault #{shell.set_color(usage.ljust(width), :green)}#{desc}"
         end
       end
 
       shell.say ""
-      say_header.call("SAFE SECRET INPUT  (preferred over passing values as arguments)")
+      shell.say("SAFE SECRET INPUT  (preferred over passing values as arguments)")
       shell.say "  printf '%s' \"$SECRET\" | localvault set KEY --stdin"
       shell.say ""
-      say_header.call("PROJECTS  (dot-notation groups inside one vault)")
+      shell.say("PROJECTS  (dot-notation groups inside one vault)")
       shell.say "  localvault set platepose.API_KEY v    Store a key in the 'platepose' group"
       shell.say "  Filter any command with -p:  show -p platepose, exec -p platepose -- CMD"
       shell.say "  Delete a whole group:        localvault delete 'platepose.*'"
       shell.say ""
-      say_header.call("USING SECRETS WITH ANY CLI")
+      shell.say("USING SECRETS WITH ANY CLI")
       shell.say "  localvault exec -- inventlist ships list"
       shell.say "  localvault exec -- curl -H \"Authorization: Bearer $API_KEY\" ..."
       shell.say ""
@@ -785,6 +785,14 @@ module LocalVault
     require_relative "cli/guard"
     require_relative "cli/identity_cmd"
 
+    # Thor 1.5 injects a `tree` command into every class. Inside a namespace it
+    # lists under a name that isn't even callable (`identity_command tree`), and
+    # at top level it prints a raw class path as the root. Our grouped help
+    # covers the same ground properly, so drop it everywhere.
+    [self, Guard, Keys, Team, Sync, IdentityCommand].each do |namespace|
+      namespace.remove_command(:tree) if namespace.all_commands.key?("tree")
+    end
+
     register(Guard, "guard", "guard SUBCOMMAND", "Block plaintext secrets in agent tool traffic (Claude Code hooks)")
     register(IdentityCommand, "identity", "identity SUBCOMMAND", "Show or set your local identity (alias, handle, public key)")
     register(Keys, "keys", "keys SUBCOMMAND", "Manage your X25519 keypair for vault sharing")

data/lib/localvault/version.rb

@@ -1,3 +1,3 @@
 module LocalVault
-  VERSION = "1.12.1"
+  VERSION = "1.12.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: localvault
 version: !ruby/object:Gem::Version
-  version: 1.12.1
+  version: 1.12.2
 platform: ruby
 authors:
 - Nauman Tariq
@@ -112,6 +112,7 @@ files:
 - lib/localvault/cli.rb
 - lib/localvault/cli/error_presenter.rb
 - lib/localvault/cli/guard.rb
+- lib/localvault/cli/help_shell.rb
 - lib/localvault/cli/identity_cmd.rb
 - lib/localvault/cli/keys.rb
 - lib/localvault/cli/sync.rb