lux-hammer 0.3.23 → 0.3.24

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74dd44bca6cf689dcfe0396d90e05e51b0605821314fb6d5b742502662f4e8e8
-  data.tar.gz: a84eaa4fcce83f951905bab3419d18adfcce409cd0f9d2f23db910569443a2ce
+  metadata.gz: 68c2cd8d90138ab3eaf6a68a23aeabc273b31d26122224ba3966d235a9841657
+  data.tar.gz: ae13bf1ca96c396b51a1db3801ce4aa4179ad67f5bb8e4b04467715b9744164e
 SHA512:
-  metadata.gz: 044a31c525aba212012888f39d938fa37dc2e69e59097fa10f1dda53723b0a267dae2dad0e77887c19ad801a64fcb47e03b8aa95d916b04474d5239628a9b8f0
-  data.tar.gz: 3ec9940429c06e4bfb00669184fe3d4f78fff0ed693f857fcd37c682bf89b70a214f3a7e92e24826a1ab5889c62de26f05e0f9b78fe22c1c65b12227d4a18681
+  metadata.gz: 222754053a8ca203a8f0344fd0007174e1a333f92e69935fd908567e7e6a8a1d1c8675d5bd8a443a905fd9140ba54ed4afc2fdbd7abe817c8cc90d3643e97fa1
+  data.tar.gz: 345ebe94f0d5eb3383fb4a0df98a1cc95d611fa330d2174c2ed6b3b25de724ee0acc51100682cd93cce813c446298cd0e19d004998e3fe95e8f5b01434368faa

data/.version

@@ -1 +1 @@
-0.3.23
+0.3.24

data/README.md

@@ -506,9 +506,11 @@ end
 
 ## Stdin, JSON input, and global options
 
-Every command receives **`opts[:stdin]`** automatically when stdin is a
-pipe (non-TTY) and non-empty; otherwise it is `nil`. Interactive TTYs are
-never consumed.
+Every command can read **`opts[:stdin]`**: piped stdin (non-TTY, non-empty)
+as a string, otherwise `nil`. It is read on the first lookup and kept, so a
+command that never looks never waits on a pipe. Interactive TTYs are never
+consumed, and a socket with nothing pending (agent harnesses hand one to
+every command) reads as `nil` rather than blocking.
 
 ```ruby
 task :count do

data/lib/hammer/input.rb

@@ -3,18 +3,23 @@
 require 'json'
 
 class Hammer
-  # Stdin + JSON helpers for opts. Hammer always attaches piped stdin as
-  # `opts[:stdin]`; recipes opt into JSON body handling via
-  # `Hammer::Input.prepare_json!` (typically from a `before` hook) and/or
-  # `opt :json, type: :json` / `global_opt :json, type: :json`.
+  # Stdin + JSON helpers for opts. Hammer exposes piped stdin as
+  # `opts[:stdin]`, read lazily on first access; recipes opt into JSON body
+  # handling via `Hammer::Input.prepare_json!` (typically from a `before`
+  # hook) and/or `opt :json, type: :json` / `global_opt :json, type: :json`.
   module Input
     module_function
 
     # Read piped stdin once. Returns nil when stdin is a TTY or empty.
-    # Does not consume an interactive TTY.
+    # Does not consume an interactive TTY, and does not block on a socket
+    # that has nothing pending: agent harnesses (Claude Code's Bash tool)
+    # hand every command a unix socket as stdin that never reaches EOF, so
+    # a plain read would hang there for good. A shell pipe or a redirected
+    # file is a FIFO or a regular file and is still read in full.
     def read_stdin
       return nil if $stdin.closed?
       return nil if $stdin.tty?
+      return nil if idle_socket?($stdin)
 
       data = $stdin.read
       return nil if data.nil?
@@ -25,11 +30,26 @@ class Hammer
       nil
     end
 
-    # Idempotent: sets opts[:stdin] if not already present.
+    def idle_socket?(io)
+      return false unless io.respond_to?(:stat) && io.stat.socket?
+
+      IO.select([io], nil, nil, 0).nil?
+    rescue StandardError
+      false
+    end
+
+    # Reads stdin into the hash on the first `opts[:stdin]` lookup and keeps
+    # the result, so a command that never asks for stdin never waits on it.
+    LAZY_STDIN = lambda do |hash, key|
+      key == :stdin ? (hash[:stdin] = Input.read_stdin) : nil
+    end
+
+    # Idempotent: leaves an explicit opts[:stdin] alone, otherwise installs
+    # the lazy reader. Nothing is read until a recipe looks at opts[:stdin].
     def attach_stdin!(opts)
-      return opts[:stdin] if opts.key?(:stdin)
+      return if opts.key?(:stdin) || opts.default_proc.equal?(LAZY_STDIN)
 
-      opts[:stdin] = read_stdin
+      opts.default_proc = LAZY_STDIN
     end
 
     # Parse a JSON source string into a Hash/Array with symbol keys.

data/lib/lux-hammer.rb

@@ -690,8 +690,9 @@ class Hammer
       options = effective_options(cmd)
       positional, opts = Parser.new(options).parse(argv)
       opts[:args] = positional
-      # Always attach piped stdin (nil when TTY / empty). Recipes that want
-      # JSON body handling call Hammer::Input.prepare_json! in a before hook.
+      # opts[:stdin] reads piped stdin on first access (nil when TTY / empty).
+      # Recipes that want JSON body handling call Hammer::Input.prepare_json!
+      # in a before hook.
       Hammer::Input.attach_stdin!(opts)
       print_run_banner(cmd, full || cmd.name, positional, opts, options: options) unless quiet || ENV['HAMMER_QUIET']
       instance = new

data/recipes/llm.rb

@@ -337,7 +337,9 @@ TODO_GUIDE ||= <<~TXT
   Per-project task queue in ./LLM_TODO.local.md - workable by humans and any agent.
 
   Human usage:
-    llm todo:add "fix login redirect"   queue a task (pipe stdin for bulk / multi-line)
+    llm todo:add "fix login redirect"   queue a task; pipe stdin for bulk:
+                                        `* ` bullets delimit tasks (multi-line ok),
+                                        no bullets at all = one task per line
     llm todo:list                       tasks by id, counts, format warnings
     llm todo:pop + llm todo:done        take / finish a single task by hand
 
@@ -491,9 +493,10 @@ namespace :todo do
     desc <<~DESC
       Add task(s) to ./#{TODO_FILE} (created on first add).
 
-      Text comes from the argument (one task), or from stdin - there a `*` at
-      the start of a line begins a new task and following lines belong to it,
-      so multi-line tasks and whole lists can be piped in at once.
+      Text comes from the argument (one task), or from stdin. Piped input
+      that has `*` / `-` bullets is a list: a bullet begins a task and the
+      lines under it belong to it, so multi-line tasks and whole lists can be
+      piped in at once. Input with no bullets at all is one task per line.
     DESC
     example 'todo add "migrate the user model to Sequel"'
     example 'cat tasks.md | llm todo add'
@@ -503,17 +506,19 @@ namespace :todo do
       # unquoted multi-word input lands in :text + :args - join it back
       arg = [opts[:text], *opts[:args]].compact.join(' ').strip
       if arg.empty?
+        lines     = opts[:stdin].to_s.split("\n")
+        bulleted  = lines.any? { |l| l =~ /^[-*]\s+/ }
         new_tasks = []
-        opts[:stdin].to_s.split("\n").each do |line|
+        lines.each do |line|
           if line =~ /^[-*]\s+(.*)$/
             new_tasks << [$1.strip]
-          elsif new_tasks.any?
-            new_tasks.last << line.rstrip
+          elsif bulleted
+            new_tasks.last << line.rstrip if new_tasks.any?
           elsif line.strip != ''
             new_tasks << [line.rstrip]
           end
         end
-        new_tasks = new_tasks.map { |lines| lines.join("\n").rstrip }.reject(&:empty?)
+        new_tasks = new_tasks.map { |ls| ls.join("\n").rstrip }.reject(&:empty?)
       else
         new_tasks = [arg]
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lux-hammer
 version: !ruby/object:Gem::Version
-  version: 0.3.23
+  version: 0.3.24
 platform: ruby
 authors:
 - Dino Reic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-19 00:00:00.000000000 Z
+date: 2026-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest