lux-hammer 0.2.5 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb668fabef5892decb2ee58add685f52dad7fe742ae0cd8597ba62da576c3d13
-  data.tar.gz: f74beef4ccb0af5aaa546c7c4a2dec29bc08fffdb929edfa5f3dcdf261627b69
+  metadata.gz: 173d405adff150c31284b295fbcc13b56d73a70d6752509f4954f5a89d5f4df7
+  data.tar.gz: 1439b6d6e44bec16a5571ffaec390d98ea945360862fb4514f55fedf89a575df
 SHA512:
-  metadata.gz: 9fddfa7b7f657cb1baa30793e46fe331cd3f65704ac31ce582bcfc851b154a15eb72e5610e0a0b8af29ed99a763823f7c7bbdd1ef7ad33f40b95fcd803a6216f
-  data.tar.gz: 6b176bb61def54c305a28f0c9b9419074ed16c14c1b8412ccc084cd2ed5f1a0bfa93d947aac9fcce704cde00c2307bb897e0255e200f1bf1bb077f2795f40330
+  metadata.gz: 537c36703b561535f96fc6dd5454a2f6e01df6cac7059b8115b9c6ed176875edab529fbe0d530695d4bbc233fadb67964f2485baa8497de324e4a76b33de353b
+  data.tar.gz: 3abb187bb1fe58b03571fdbad1aac1e5a22a2023aeda4b8289ac0508813a85916bbc50a6b07b1988d9d888d3aff50b09658d77b5427704c1061a2c475c9bf151

data/.version

@@ -1 +1 @@
-0.2.5
+0.2.6

data/README.md

@@ -1,16 +1,17 @@
 # hammer
 
-The bastard Frankenstein child of Rake, Thor, and Joshua. Sewn
-together from three good ideas, with the rest of each parent left on
+The bastard Frankenstein child of Rake](https://github.com/ruby/rake),
+[Thor](https://github.com/rails/thor), and [Joshua](https://github.com/dux/joshua).
+Sewn together from three good ideas, with the rest of each parent left on
 the cutting room floor.
 
 Drop a `Hammerfile`, run `hammer`, ship. AI LLM-s love `hammer`.
 
 ```ruby
-namespace :db do                          # Rake-style colon paths
-  task :migrate do                      # Joshua-style task block
+namespace :db do                            # Rake-style colon paths
+  task :migrate do                          # Joshua-style task block
     desc 'Run pending migrations'
-    opt :pretend, type: :boolean, alias: :p   # Thor-style typed opts
+    opt :pretend, type: :boolean, alias: :p # Thor-style typed opts
     proc do |o|
       say.green "migrating pretend=#{o[:pretend].inspect}"
     end

data/lib/lux-hammer.rb

@@ -467,6 +467,7 @@ class Hammer
         Shell.say ''
         print_command_list(self)
       end
+      print_global_flags
       print_footer
     end
 
@@ -478,6 +479,7 @@ class Hammer
         Shell.say ''
         print_command_list(ns, prefix)
       end
+      print_global_flags
       print_footer
     end
 
@@ -490,6 +492,16 @@ class Hammer
 
     HOMEPAGE ||= 'https://github.com/dux/hammer'.freeze
 
+    # Global flags only exist when invoked via the `hammer` binary
+    # (see `Hammer.cli`), not for user-built CLIs that call `start`
+    # on their own subclass.
+    def print_global_flags
+      return unless root.instance_variable_get(:@hammer_binary)
+      Shell.say ''
+      Shell.say 'Global:', :yellow
+      Shell.say '  --ai  # Print AGENTS.md (AI-friendly Hammerfile authoring docs)'
+    end
+
     def print_footer
       Shell.say ''
       Shell.say "powered by hammer - #{HOMEPAGE}", :gray
@@ -505,13 +517,13 @@ class Hammer
 
       # group by "section" = everything between the view prefix and the
       # leaf name. Bare leaves go in :root.
-      groups = rows.group_by { |full, _| section_for(full, prefix) }
-      width  = rows.map { |full, c| label_for(full, c).length }.max
+      groups = rows.group_by { |full, _| section_for(full, prefix, klass) }
+      width  = rows.map { |full, _| full.length }.max
       first  = true
 
       if (rooted = groups.delete(:root))
         Shell.say 'Commands:', :yellow
-        emit_rows(rooted.sort_by { |full, _| full }, width)
+        emit_rows(rooted.sort_by { |full, _| [full.count(':'), full] }, width)
         first = false
       end
 
@@ -519,14 +531,14 @@ class Hammer
         Shell.say unless first
         first = false
         Shell.say "#{section}:", :yellow
-        emit_rows(items.sort_by { |full, _| full }, width)
+        emit_rows(items.sort_by { |full, _| [full.count(':'), full] }, width)
       end
     end
 
     def emit_rows(rows, width)
       rows.each do |full, c|
-        label = label_for(full, c)
-        Shell.say "  #{program_name} #{label.ljust(width)}  # #{c.brief}"
+        brief = c.alts.empty? ? c.brief : "#{c.brief} (alt: #{c.alts.join(', ')})"
+        Shell.say "  #{program_name} #{full.ljust(width)}  # #{brief}"
       end
     end
 
@@ -534,17 +546,18 @@ class Hammer
     # for 'db:users:list' viewed from 'db'; :root if the command sits at
     # the view's top level. Only the first segment under the view groups,
     # so deeper paths fold into their top-level section.
-    def section_for(full, prefix)
-      segs = full.split(':')[0..-2]
-      if prefix && !prefix.empty?
-        segs = segs[prefix.split(':').size..] || []
+    #
+    # Exception: a bare command that shares its name with a sibling
+    # namespace (e.g. `mount` alongside a `mount:` namespace) groups
+    # under that namespace's section, not :root.
+    def section_for(full, prefix, klass = nil)
+      segs = full.split(':')
+      segs = segs[prefix.split(':').size..] || [] if prefix && !prefix.empty?
+      if segs.size == 1 && klass && klass.namespaces.key?(segs.first)
+        return segs.first
       end
-      segs.empty? ? :root : segs.first
-    end
-
-    # "db:migrate" or "db:migrate (alt: m)"
-    def label_for(full, cmd)
-      cmd.alts.empty? ? full : "#{full} (alt: #{cmd.alts.join(', ')})"
+      parent = segs[0..-2]
+      parent.empty? ? :root : parent.first
     end
 
     # " URL [ENV] [OPTIONS]" - shows the positional-fill names for
@@ -676,6 +689,9 @@ class Hammer
     end
 
     klass = Class.new(Hammer)
+    # Mark this class as the `hammer` binary's root so help output can
+    # surface binary-only globals like `--ai`.
+    klass.instance_variable_set(:@hammer_binary, true)
     # Resolve before chdir so paths like `bin/foo` stay relative to the
     # cwd the user actually invoked from. `program_name` memoizes.
     klass.program_name

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lux-hammer
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.6
 platform: ruby
 authors:
 - Dino Reic