lux-hammer 0.3.25 → 0.3.26

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 273ffb060fd16cb52423002e5e8e041481a37b0487395d966a8f9ba90cfa53fa
-  data.tar.gz: 9dc14e358bfafc0050379d671711ca28d6d6eb3aa1935f7440c93ea897267431
+  metadata.gz: acc942b0818d0cc60a8cbe9a55fbf092665d6efcb46df209b2a8e9721aa1e190
+  data.tar.gz: 94baed7a0025611360d0315d084fd7432a1eb68d84302bfeaf0960ee0326aee7
 SHA512:
-  metadata.gz: 8c9e26f85ded5283505130548bcd1b64718d1a405013149d086881e166c59239cb1a4db3fbefcb2a990ed2a06b82d90ae54769e6650be6d1d6032a9fe48328d5
-  data.tar.gz: 700f84954436b3e606d2b5234ff682f19c27d651083037e0faaa0f9ca796b1df604704d6908d58f7fa6a133dc9fa314df71084a805c6219b1d46d963557fe22b
+  metadata.gz: 486bb304e25a56faada26757651998d75e589fabca7402f499dc9cdd3228a90b30cc3fc7cda765d2cd34fc90eecc906208681c031e38628e0087f59eb5250af7
+  data.tar.gz: 87115686cf4bbdd6a47ed9a25e048cf811fe1c8071966e5ee3143b7fcafc286ff1480d00c5ba494e407fa9032b8e1b6dda43e8623c011ae9ffdbdf70e8a33612

data/.version

@@ -1 +1 @@
-0.3.25
+0.3.26

data/lib/hammer/parser.rb

@@ -50,6 +50,17 @@ class Hammer
           next
         end
 
+        # Bundled boolean short flags: `-cf` is `-c -f`. Only when every letter
+        # is a boolean switch, so `-pVALUE` below keeps its meaning.
+        if token =~ /\A-[^-]{2,}\z/
+          bundle = token[1..-1].chars.map { |ch| @by_switch["-#{ch}"] }
+          if bundle.all? { |o| o&.boolean? }
+            bundle.each { |o| values[o.name] = true }
+            i += 1
+            next
+          end
+        end
+
         # Glued short flag with value: `-pVALUE` (non-boolean short opts only).
         if token.start_with?('-') && !token.start_with?('--') && token.length > 2
           if (opt = @by_switch[token[0, 2]]) && !opt.boolean?

data/recipes/lib/llm/launch.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'pathname'
+
+# Builds the command `llm wrap:run` hands to LlmWrap: picks the agent CLI by
+# prefix and maps the generic -c / -f / -a switches to what that CLI takes.
+module LlmLaunch
+  Launch = Struct.new(:argv, :env, :files)
+
+  # :agents gets the combined AGENTS.md text and the file paths, and answers
+  # with the argv to add and/or env to set - opencode has no flag for
+  # instructions, only inline config, and that one takes paths.
+  TOOLS ||= {
+    'claude'   => { continue: %w[-c],            full: %w[--dangerously-skip-permissions],
+                    agents: ->(text, _files) { { args: ['--append-system-prompt', text] } } },
+    'codex'    => { continue: %w[resume --last], full: %w[--dangerously-bypass-approvals-and-sandbox],
+                    agents: ->(text, _files) { { args: ['-c', "developer_instructions=#{text}"] } } },
+    'grok'     => { continue: %w[-c],            full: %w[--always-approve],
+                    agents: ->(text, _files) { { args: ['--rules', text] } } },
+    'opencode' => { continue: %w[-c],            full: %w[--auto],
+                    agents: ->(_text, files) { { env: { 'OPENCODE_CONFIG_CONTENT' => { instructions: files }.to_json } } } },
+  }.freeze
+
+  # Read AGENTS.md from the git root down on their own; -a only adds the
+  # files above it for these. Claude reads CLAUDE.md, so it gets the chain.
+  NATIVE_AGENTS ||= %w[codex grok opencode].freeze
+
+  # First tool whose name starts with the prefix, in TOOLS order: `c` is
+  # claude, `co` codex. No prefix means claude.
+  def self.tool(prefix)
+    return 'claude' if prefix.nil? || prefix.empty?
+    TOOLS.keys.find { |name| name.start_with?(prefix) }
+  end
+
+  def self.build(tool, extra = [], continue: false, full: false, agents: false, cwd: Dir.pwd, home: Dir.home)
+    spec = TOOLS.fetch(tool)
+    argv = [tool]
+    argv.concat(spec[:continue]) if continue
+    argv.concat(spec[:full]) if full
+
+    files = agents ? agents_files(tool, cwd: cwd, home: home) : []
+    env = {}
+    if files.any?
+      added = spec[:agents].call(agents_text(files), files.map(&:to_s))
+      argv.concat(added[:args] || [])
+      env.update(added[:env] || {})
+    end
+
+    argv.concat(extra)
+    Launch.new(argv, env, files)
+  end
+
+  # AGENTS.md from home down to cwd, outermost first. For NATIVE_AGENTS tools
+  # the walk stops above the git root - or above cwd outside git, since that is
+  # what they take as the project then.
+  def self.agents_files(tool, cwd: Dir.pwd, home: Dir.home)
+    stop = nil
+    if NATIVE_AGENTS.include?(tool)
+      stop = IO.popen(['git', '-C', cwd, 'rev-parse', '--show-toplevel'], err: File::NULL, &:read).to_s.strip
+      stop = cwd if stop.empty?
+    end
+
+    Pathname(cwd).ascend
+      .select { |dir| dir.to_s.start_with?(home) }
+      .reject { |dir| stop && dir.to_s.start_with?(stop) }
+      .reverse
+      .map { |dir| dir + 'AGENTS.md' }
+      .select(&:file?)
+  end
+
+  def self.agents_text(files)
+    body = files.map { |f| "## #{f}\n\n#{f.read.strip}\n" }.join("\n")
+    "Project instructions (AGENTS.md), broad to specific:\n\n#{body}"
+  end
+end

data/recipes/llm.rb

@@ -13,6 +13,7 @@ desc <<~TXT
   Commands:
     usage    subscription limits and per-model token usage
     wrap     run a command with your last two prompts pinned to the screen
+    wrap:run start claude / codex / grok / opencode in wrap, same -c -f -a switches for all
 TXT
 
 require 'fileutils'
@@ -185,6 +186,58 @@ task :wrap do
   end
 end
 
+namespace :wrap do
+  task :run do
+    desc <<~D
+      Start an agent CLI inside `llm wrap`, with the same switches whichever one it is.
+
+      TOOL is a prefix of claude, codex, grok or opencode - first match wins, so `c` is
+      claude and `co` is codex. No tool means claude. The switches map to what each
+      CLI actually takes:
+
+        -c  continue the last session here    claude/grok/opencode -c, codex resume --last
+        -f  full permissions, no prompts      --dangerously-skip-permissions, --dangerously-bypass-
+                                              approvals-and-sandbox, --always-approve, --auto
+        -a  AGENTS.md from ~ down to cwd      claude --append-system-prompt, codex -c
+                                              developer_instructions, grok --rules, opencode
+                                              inline config
+
+      codex, grok and opencode read AGENTS.md from the git root down by themselves, so
+      -a only adds the files above the repo for them; claude gets the whole chain.
+      Anything after `--` is handed to the tool untouched. `~/bin/ai` is this command.
+    D
+    example 'wrap:run'
+    example 'wrap:run g -cf'
+    example 'wrap:run cod -ca'
+    example 'wrap:run c -- --model opus'
+
+    opt :continue, type: :boolean, desc: 'continue the last session in this folder'
+    opt :full,     type: :boolean, desc: 'full permissions, no approval prompts'
+    opt :agents,   type: :boolean, desc: 'inject AGENTS.md found from ~ down to cwd'
+
+    proc do |opts|
+      require File.join(_llm_root, 'lib/llm/wrap')
+      require File.join(_llm_root, 'lib/llm/launch')
+
+      args = Array(opts[:args])
+      prefix = args.first unless args.first.nil? || args.first.start_with?('-')
+      tool = LlmLaunch.tool(prefix) ||
+             error("unknown tool #{prefix.inspect} - one of #{LlmLaunch::TOOLS.keys.join(', ')}")
+      extra = prefix ? args.drop(1) : args
+
+      launch = LlmLaunch.build(tool, extra, continue: opts[:continue], full: opts[:full], agents: opts[:agents])
+      ENV.update(launch.env)
+      say.gray "agents: #{launch.files.map { |f| f.to_s.sub(Dir.home, '~') }.join(', ')}" if launch.files.any?
+
+      flags = %i[continue full agents].select { |k| opts[k] }.map { |k| "--#{k}" }
+      origin = ['llm', 'wrap:run', tool, *flags, '--', *extra]
+      # Piped stdout is block-buffered and exec drops the buffer with the banner in it.
+      $stdout.flush
+      exit LlmWrap.run(launch.argv, origin: origin)
+    end
+  end
+end
+
 namespace :memory do
   # Helpers are defined inside the namespace block (class_eval'd on the
   # namespace's anonymous Hammer subclass) so the task procs reach them.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lux-hammer
 version: !ruby/object:Gem::Version
-  version: 0.3.25
+  version: 0.3.26
 platform: ruby
 authors:
 - Dino Reic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-24 00:00:00.000000000 Z
+date: 2026-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -55,6 +55,7 @@ files:
 - "./lib/lux-hammer.rb"
 - "./recipes/deploy.rb"
 - "./recipes/git-helper.rb"
+- "./recipes/lib/llm/launch.rb"
 - "./recipes/lib/llm/plan.rb"
 - "./recipes/lib/llm/usage.rb"
 - "./recipes/lib/llm/wrap.rb"