lux-hammer 0.3.8 → 0.3.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64f8d2c7864047c17b42187e610ac14e93982a5ff1bd8dc6187a35670f67e432
-  data.tar.gz: 07b7014dcdfe70c48c293e7e18ce05475dcd565ee2c66310afa0c3a16d371f02
+  metadata.gz: 60fa663d47e0d1d68790c40125c1594ae0152d99695cd57fe1d86294b1a5c348
+  data.tar.gz: 779a8291e200bff69a8c3b237662a88647a50071eb038f47fe695d547c805094
 SHA512:
-  metadata.gz: f1f4515e1340b132865081e4ff4118789540fd2c7c880d2ec42330d174e6f41f88b5355f40727207fa0320811bdba6f134d70a81604760221e2189be6cd73b7e
-  data.tar.gz: f43b40bd53e03f3c2a4ad04f5e8a886863c038b79f2cf18e39f96eb8e09bb3e8dfaa3c5a6610fc0acaee8f76c6a31860a0dc10f4a181c80fbc8ee64e5a45d32b
+  metadata.gz: 6b2114d72e01ee7aef8166a4881915d4c124e0cce67c6c9e5d680fb945750aa8b338fc7041332dcaf6d54fe15fac04cf3e85271e8cd75b5bc3126edacb30f827
+  data.tar.gz: 7f85fb830fae721e969e2d23e28a9c282c6655b8b9f29aa5c8dd15a9fa3e5f55eddcfa9a978d7605c37c1ca20c177b43c1475114f64f870e41e5993c56287854

data/.version

@@ -1 +1 @@
-0.3.8
+0.3.9

data/lib/hammer/parser.rb

@@ -63,7 +63,11 @@ class Hammer
       @options.each do |opt|
         break if positional.empty?
         next if opt.boolean? || values.key?(opt.name)
-        values[opt.name] = opt.cast(positional.shift)
+        if opt.type == :array
+          values[opt.name] = opt.cast(positional.shift(positional.size))
+        else
+          values[opt.name] = opt.cast(positional.shift)
+        end
       end
 
       @options.each do |opt|

data/lib/hammer/shell.rb

@@ -31,8 +31,8 @@ class Hammer
 
     # `say` with no args returns a proxy so you can write `say.cyan 'hi'`.
     # `say('')` still prints a blank line; `say('x', :cyan)` is unchanged.
-    def say(text = nil, color = nil)
-      return SayProxy.new if text.nil?
+    def say(text = :_say_no_arg, color = nil)
+      return SayProxy.new if text == :_say_no_arg
       puts paint(text, color)
     end
 
@@ -116,9 +116,9 @@ class Hammer
               $stdout.print "\e[#{items.size}A\r\e[J"
               $stdout.print "#{paint("> #{items[selected]}", :green)}\r\n"
               return selected
-            when "\x03", 'q' # Ctrl-C, q
+            when "\x03" # Ctrl-C
               $stdout.print "\e[#{items.size}A\r\e[J"
-              return nil
+              raise Interrupt
             when "\e"
               # ESC may stand alone or start an arrow sequence \e[A / \e[B.
               if IO.select([io], nil, nil, 0.01) && io.getch == '['

data/lib/lux-hammer.rb

@@ -414,6 +414,13 @@ class Hammer
       run_command(cmd, argv, full: name, quiet: true)
     end
 
+    # True when -h or --help appears in argv before a `--` stop-marker.
+    def help_requested?(argv)
+      stop = argv.index('--')
+      scan = stop ? argv[0...stop] : argv
+      scan.include?('-h') || scan.include?('--help')
+    end
+
     public
 
     # Find a command by canonical name or alt within this class. Falls
@@ -605,30 +612,26 @@ class Hammer
       end
     end
 
-    def help_requested?(argv)
-      stop = argv.index('--')
-      scan = stop ? argv[0...stop] : argv
-      scan.include?('-h') || scan.include?('--help')
-    end
+    public
 
     # `extended: true` is the verbose `help` / `-h` / `--help` form -
     # appends global flags, the GitHub footer, and (for the hammer binary)
     # a Hammerfile example. Bare invocation passes `extended: false` so
     # the no-args output stays a clean command listing.
-    def print_help(target = nil, full: false, extended: false)
+    def print_help(target = nil, expanded: false, extended: false)
       if target
         # `help ns:` is equivalent to `ns:` - namespace listing.
         if target.end_with?(':') && target != ':'
           bare = target.chomp(':')
           ns, canonical = resolve_namespace(bare)
-          return print_namespace_help(canonical, ns, extended: extended) if ns
+          return print_namespace_help(canonical, ns) if ns
           Shell.print_error("unknown: #{target}")
           return
         end
         cmd, _, canonical = resolve(target)
         return print_command_help(cmd, canonical) if cmd
         ns, canonical = resolve_namespace(target)
-        return print_namespace_help(canonical, ns, full: full, extended: extended) if ns
+        return print_namespace_help(canonical, ns, expanded: expanded) if ns
         Shell.print_error("unknown: #{target}")
         return
       end
@@ -639,7 +642,7 @@ class Hammer
         Shell.say ''
         @app_desc.each_line { |l| Shell.say "  #{l.chomp}" }
       end
-      if full
+      if expanded
         each_command { |path, c| print_full_block(path, c) unless c.desc.empty? }
       else
         Shell.say ''
@@ -670,10 +673,9 @@ class Hammer
 
     # `extended:` is accepted for parity with `print_help` but intentionally
     # not used here - the global-flags / Hammerfile-example / footer block
-    # is root-help-only. A namespace listing is just the commands under
-    # that prefix; tool-meta noise (Recipes: section) is reserved for
-    # `hammer --help` at the top level.
-    def print_namespace_help(prefix, ns, full: false, extended: false)
+    # is root-help-only. `expanded:` is also accepted for parity; a namespace
+    # listing is always the compact command list.
+    def print_namespace_help(prefix, ns, expanded: false, extended: false)
       Shell.say "Usage: #{program_name} #{prefix}:COMMAND [ARGS]", :cyan
       rows = []
       sibling = find_namespace_sibling(prefix)
@@ -989,6 +991,17 @@ class Hammer
     argv = argv.dup
     force_system = !!argv.delete('--system')
 
+    # Shebang invocation: `hammer /path/to/script ...args` (kernel passes
+    # the script path as argv[0] for `#!/usr/bin/env hammer` files).
+    # Treat the script as a self-contained CLI: no Hammerfile lookup, no
+    # chdir (commands run in the caller's cwd), no `hammer`-binary
+    # built-ins/banners. Detection requires a `#!`+`hammer` first line so
+    # task names that happen to be paths don't get hijacked.
+    if (script = shebang_script(argv.first))
+      argv.shift
+      return run_shebang(script, argv)
+    end
+
     path = force_system ? nil : find_hammerfile(Dir.pwd)
     unless path
       # No Hammerfile (or --system) - all built-ins are reachable. Bare
@@ -1058,6 +1071,33 @@ class Hammer
     klass.start(argv)
   end
 
+  # Returns the script path if `arg` looks like a shebang script that
+  # delegates to hammer (first line starts with `#!` and mentions
+  # `hammer`). Returns nil otherwise. Used by `cli` to detect
+  # `#!/usr/bin/env hammer` invocations where the kernel passes the
+  # script path as argv[0].
+  def self.shebang_script(arg)
+    return nil unless arg
+    return nil if arg.start_with?('-')
+    return nil unless File.file?(arg) && File.readable?(arg)
+    head = File.open(arg, &:gets).to_s
+    return nil unless head.start_with?('#!') && head.include?('hammer')
+    arg
+  end
+
+  # Evaluate a shebang script as a self-contained CLI. Mirrors `recipe`
+  # semantics: no chdir, no `@hammer_binary` flag, no `register_core`
+  # built-ins (so the script's `--help` shows only what it defines).
+  # `program_name` is the script's basename so help reads "myscript foo"
+  # rather than "hammer foo" - works even when invoked via a symlink in
+  # PATH, since argv[0] is the path the user typed.
+  def self.run_shebang(path, argv)
+    klass = Class.new(Hammer)
+    klass.instance_variable_set(:@program_name, File.basename(path))
+    Builder.new(klass).evaluate(File.read(path), path)
+    klass.start(argv)
+  end
+
   # True if argv goes through a built-in dispatch path (`:default` or
   # `:help`) - meaning bare `hammer`, leading-flag invocations like
   # `hammer -h`, or explicit help requests. These don't need a project

data/recipes/git-helper.rb

@@ -1,4 +1,6 @@
+#!/usr/bin/env hammer
 # desc: work with git (commit, push, pull, rebase, branch, redate, ...)
+# executable: chmod +x this file and run directly, or symlink into PATH
 
 desc <<~TXT
   Git helper. Short aliases over common `git` workflows.

data/recipes/llm.rb

@@ -1,4 +1,6 @@
+#!/usr/bin/env hammer
 # desc: personal LLM utility CLI (memory store, prompt-token expander, ...)
+# executable: chmod +x this file and run directly, or symlink into PATH
 
 desc <<~TXT
   llm - personal LLM utility CLI
@@ -54,6 +56,7 @@ namespace :memory do
     end
     [meta, body.to_s.sub(/\A\n+/, '')]
   end
+
   task :list do
     desc 'List stored memories with type and one-line description'
     example 'llm memory list'

data/recipes/srt.rb

@@ -1,4 +1,6 @@
+#!/usr/bin/env hammer
 # desc: Local SRT extraction via whisper.cpp
+# executable: chmod +x this file and run directly, or symlink into PATH
 
 desc <<~TXT
   Local subtitle extraction with whisper.cpp.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lux-hammer
 version: !ruby/object:Gem::Version
-  version: 0.3.8
+  version: 0.3.9
 platform: ruby
 authors:
 - Dino Reic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-25 00:00:00.000000000 Z
+date: 2026-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest