harnex 0.7.8 → 0.7.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64a1ddf83ef070cc2b418c1a70ae3e1fc2c8b5fd671e8fa3e5a30536184728ca
-  data.tar.gz: 6a076faed04db3eddbaf4bf2fefbee95426cd8ee8008499e3474fbfa1b5c62ed
+  metadata.gz: 56d9111b2ab4f12716444ecef721331d9878a4485a4b305ecd4a1ad7546d4b77
+  data.tar.gz: 3f727b473455245ba916cabe1202a6abc2d6c5a07f4ae257b04898a296d9149c
 SHA512:
-  metadata.gz: 3508afcbddc0e9afaf17372ca98cb3146d5edc128fb54c6217f8b80be7f81baae0ab7f50feba4b513a9ba46165323f8fb95ddd243df5bd19921b198beb89bbc6
-  data.tar.gz: 25419186825ac14d2f6cd844497d6dc356e88785f23784f30492284b80c384781ab834011f394d27c93078821fc394fed3ac97b8bff818f7b60fc280be83a560
+  metadata.gz: a2a87ae57e9ddc34bb85805ea9e07f3523691cf979361f687f4c3c68534c0b9f7c9e276b83d8d28a91a15bc52913ef41e1e36b1993127c97c68c87aa75af5766
+  data.tar.gz: 92084ab180df22e16316226adaaa8170b0ab71ceeda1e4de3f097873ed6ecb8e22f8bca7b06b3c78b0a1a0c36d8b18c4b13dcebb7126aecd4523034fead38399

data/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 ## [Unreleased]
 
+## [0.7.9] - 2026-07-10 | 10:33 PM | IST
+
+### Added
+
+- `harnex run` now accepts wrapper-level `--cwd DIR` and `--root DIR` options.
+  `--cwd` starts the wrapped agent in `DIR` and makes that directory the
+  harnex session root for registry/session metadata and default dispatch
+  summaries. `--root` changes harnex root attribution without changing the
+  child process cwd.
+
+### Changed
+
+- `harnex run --help`, README, and the dispatch guide now document
+  public-bundle / temporary-workdir dispatches with `--cwd`.
+- Refreshed pinned Codex app-server schema fixtures against
+  `codex-cli 0.144.1` so the release suite is green with the current local
+  Codex CLI.
+
+### Fixed
+
+- Non-git temporary work directories no longer leak raw `git rev-parse` fatal
+  messages during harnex root probing.
+
 ## [0.7.8] - 2026-06-13 | 08:45 PM | IST
 
 ### Added

data/README.md

@@ -57,6 +57,24 @@ harnex stop --id planner
 That's the core loop. Start a fresh agent for each step, hand it one
 job, watch it work, stop it when done.
 
+### Run from a temporary/public bundle
+
+Use `--cwd DIR` when the worker should see a specific directory rather than
+the orchestrator's current repo. Harnex starts the wrapped agent in `DIR`, sets
+that directory as the session root, and resolves default telemetry such as
+`.harnex/dispatch.jsonl` there:
+
+```bash
+harnex run codex --cwd /tmp/leximaze_eval_run_001 \
+  --id lm-run-001 \
+  --context "Read README.md and write RESPONSES.jsonl and OUTPUT.md" \
+  --auto-stop
+```
+
+Use `--root DIR` only when you need to override harnex's root attribution
+without changing the child process cwd. `--cwd` is not a security sandbox; it is
+an explicit working-directory/root selector for automation.
+
 ## Why use this
 
 - **You want agents to plan, implement, review, and fix — in sequence.**
@@ -228,9 +246,11 @@ Schema details and compatibility policy are documented in
 
 ## Dispatch history
 
-Every finished `harnex run` writes dispatch records. In a git repo, the
-default path is `<repo>/.harnex/dispatch.jsonl`; outside a git repo, the
-compact history record falls back to `~/.local/state/harnex/dispatch.jsonl`.
+Every finished `harnex run` writes dispatch records. By default, the terminal
+summary JSONL path is `<session-root>/.harnex/dispatch.jsonl`; `--cwd DIR` makes
+`DIR` the session root, including for non-git temporary bundles. The compact
+history record is repo-local in a git tree and falls back to
+`~/.local/state/harnex/dispatch.jsonl` outside git.
 `harnex history` reads the compact records from that location, and
 `harnex status --id ID --json` / `harnex wait` can use the same durable
 terminal summaries when the live session registry is already gone.

data/guides/01_dispatch.md

@@ -81,6 +81,20 @@ Rule: when you use `--tmux`, pass the same name as `--id`. If you pass only
 `--tmux NAME`, harnex creates a random session ID and the pane name no longer
 matches `harnex status` or `harnex pane --id`.
 
+For public-bundle or benchmark runs, use `--cwd DIR` to make harnex launch the
+wrapped agent from that directory and associate session metadata/default
+telemetry with it:
+
+```bash
+harnex run codex --cwd /tmp/leximaze_eval_run_001 \
+  --id lm-run-001 \
+  --context "Read README.md and write RESPONSES.jsonl and OUTPUT.md" \
+  --auto-stop
+```
+
+`--root DIR` only overrides harnex's root attribution; it does not change the
+child process cwd. Neither flag is a sandbox.
+
 Pi runs use structured RPC (`pi --mode rpc`). Pass Pi child flags after `--`
 (e.g. `harnex run pi --context "..." -- --model anthropic/claude-sonnet-4-5 --thinking high`).
 

data/lib/harnex/commands/run.rb

@@ -8,11 +8,11 @@ module Harnex
     KNOWN_FLAGS = %w[
       --id --description --detach --tmux --host --port --watch --watch-file
       --stall-after --max-resumes --preset --context --meta --summary-out
-      --timeout --inbox-ttl --auto-stop --fast --legacy-pty --help
+      --cwd --root --timeout --inbox-ttl --auto-stop --fast --legacy-pty --help
     ].freeze
     VALUE_FLAGS = %w[
       --id --description --host --port --watch --watch-file --stall-after
-      --max-resumes --preset --context --meta --summary-out --timeout --inbox-ttl
+      --max-resumes --preset --context --meta --summary-out --cwd --root --timeout --inbox-ttl
     ].freeze
 
     def self.usage(program_name = "harnex run")
@@ -37,6 +37,8 @@ module Harnex
                              Default Codex runs force service_tier="flex".
           --meta JSON        Attach parsed JSON metadata to the started event
           --summary-out PATH Append dispatch telemetry summary JSONL to PATH
+          --cwd DIR          Run the wrapped agent from DIR and use DIR as the session root
+          --root DIR         Override harnex session/root attribution without changing child cwd
           --timeout SECS     Max seconds to wait for detached registration (default: #{DEFAULT_TIMEOUT})
           --inbox-ttl SECS   Expire queued inbox messages after SECS (default: #{Inbox::DEFAULT_TTL})
           --legacy-pty       (codex only) Use the legacy PTY adapter instead of
@@ -58,6 +60,7 @@ module Harnex
           #{program_name} pi --id pi-i-42 --tmux pi-i-42 --context "Read /tmp/task-impl-42.md"
           #{program_name} pi --id pi-i-42 --tmux pi-i-42 --context "Read /tmp/task-impl-42.md" --auto-stop
           #{program_name} pi --id pi-i-42 --watch --preset impl --context "Read /tmp/task-impl-42.md"
+          #{program_name} codex --cwd /tmp/public-bundle --id eval-001 --context "Read README.md and write OUTPUT.md" --auto-stop
           #{program_name} claude --id cl-r-42 --tmux cl-r-42 --description "Review task 42"
 
         Gotchas:
@@ -88,6 +91,8 @@ module Harnex
         context: nil,
         meta: nil,
         summary_out: nil,
+        cwd: nil,
+        root: nil,
         auto_stop: false,
         detach: false,
         tmux: false,
@@ -110,7 +115,7 @@ module Harnex
       raise OptionParser::MissingArgument, "cli" if cli_name.nil?
       validate_auto_stop_context!
 
-      repo_root = Harnex.resolve_repo_root(adapter_repo_path(cli_name, child_args))
+      repo_root = resolve_run_root(cli_name, child_args)
       @options[:summary_out] = resolve_summary_out(repo_root)
       @options[:id] ||= Harnex.generate_id(repo_root)
       validate_unique_id!(repo_root)
@@ -173,6 +178,8 @@ module Harnex
       tmux_cmd << "--auto-stop" if @options[:auto_stop]
       tmux_cmd += ["--meta", JSON.generate(@options[:meta])] if @options[:meta]
       tmux_cmd += ["--summary-out", @options[:summary_out]] if @options[:summary_out]
+      tmux_cmd += ["--cwd", @options[:cwd]] if @options[:cwd]
+      tmux_cmd += ["--root", @options[:root]] if @options[:root]
       tmux_cmd += ["--inbox-ttl", @options[:inbox_ttl].to_s]
       tmux_cmd << "--fast" if @options[:fast]
       tmux_cmd += ["--legacy-pty"] if @options[:legacy_pty]
@@ -181,11 +188,12 @@ module Harnex
       window_name = @options[:tmux_name] || @options[:id]
       shell_cmd = tmux_cmd.map { |arg| Shellwords.shellescape(arg) }.join(" ")
 
+      tmux_start_cwd = @options[:cwd] || @launch_cwd
       started =
         if ENV["TMUX"]
-          system("tmux", "new-window", "-c", @launch_cwd, "-n", window_name, "-d", shell_cmd)
+          system("tmux", "new-window", "-c", tmux_start_cwd, "-n", window_name, "-d", shell_cmd)
         else
-          system("tmux", "new-session", "-c", @launch_cwd, "-d", "-s", "harnex", "-n", window_name, shell_cmd)
+          system("tmux", "new-session", "-c", tmux_start_cwd, "-d", "-s", "harnex", "-n", window_name, shell_cmd)
         end
 
       raise "tmux failed to start #{cli_name.inspect}" unless started
@@ -281,7 +289,8 @@ module Harnex
         summary_out: @options[:summary_out],
         inbox_ttl: @options[:inbox_ttl],
         auto_stop: @options[:auto_stop],
-        launch_cwd: @launch_cwd
+        launch_cwd: history_cwd,
+        child_cwd: session_child_cwd
       )
     end
 
@@ -289,6 +298,24 @@ module Harnex
       Harnex.build_adapter(cli_name, child_args, legacy_pty: @options[:legacy_pty]).infer_repo_path(child_args)
     end
 
+    def resolve_run_root(cli_name, child_args)
+      return @options[:root] if @options[:root]
+      return @options[:cwd] if @options[:cwd]
+
+      Harnex.resolve_repo_root(adapter_repo_path(cli_name, child_args))
+    end
+
+    def history_cwd
+      @options[:root] || @options[:cwd] || @launch_cwd
+    end
+
+    def session_child_cwd
+      return @options[:cwd] if @options[:cwd]
+      return @launch_cwd if @options[:root]
+
+      nil
+    end
+
     def apply_context(child_args)
       return child_args unless @options[:context]
 
@@ -441,6 +468,16 @@ module Harnex
           @options[:summary_out] = required_option_value(arg, argv[index])
         when /\A--summary-out=(.+)\z/
           @options[:summary_out] = required_option_value("--summary-out", Regexp.last_match(1))
+        when "--cwd"
+          index += 1
+          @options[:cwd] = expand_existing_directory(required_option_value(arg, argv[index]), option_name: arg)
+        when /\A--cwd=(.+)\z/
+          @options[:cwd] = expand_existing_directory(required_option_value("--cwd", Regexp.last_match(1)), option_name: "--cwd")
+        when "--root"
+          index += 1
+          @options[:root] = expand_existing_directory(required_option_value(arg, argv[index]), option_name: arg)
+        when /\A--root=(.+)\z/
+          @options[:root] = expand_existing_directory(required_option_value("--root", Regexp.last_match(1)), option_name: "--root")
         when "--timeout"
           index += 1
           @options[:timeout] = Float(required_option_value(arg, argv[index]))
@@ -509,7 +546,7 @@ module Harnex
           nil
         when *VALUE_FLAGS
           index += 1
-        when /\A--(?:id|description|host|port|watch|watch-file|stall-after|max-resumes|context|meta|summary-out|timeout|inbox-ttl)=/
+        when /\A--(?:id|description|host|port|watch|watch-file|stall-after|max-resumes|context|meta|summary-out|cwd|root|timeout|inbox-ttl)=/
           nil
         when /\A--preset=/
           nil
@@ -528,7 +565,7 @@ module Harnex
         arg.start_with?(
           "--id=", "--description=", "--tmux=", "--host=", "--port=", "--watch=", "--watch-file=",
           "--stall-after=", "--max-resumes=", "--preset=", "--context=", "--meta=", "--summary-out=",
-          "--timeout=", "--inbox-ttl="
+          "--cwd=", "--root=", "--timeout=", "--inbox-ttl="
         )
     end
 
@@ -585,6 +622,13 @@ module Harnex
       raise OptionParser::InvalidArgument, "#{option_name} must be an integer"
     end
 
+    def expand_existing_directory(value, option_name:)
+      path = File.expand_path(value.to_s, @launch_cwd)
+      return path if File.directory?(path)
+
+      raise OptionParser::InvalidArgument, "#{option_name} must be an existing directory: #{value}"
+    end
+
     def parse_meta(value)
       parsed = JSON.parse(value)
       return parsed if parsed.is_a?(Hash)

data/lib/harnex/core.rb

@@ -32,7 +32,7 @@ module Harnex
   ].freeze
 
   def resolve_repo_root(path = Dir.pwd)
-    output, status = Open3.capture2("git", "rev-parse", "--show-toplevel", chdir: path)
+    output, status = Open3.capture2("git", "rev-parse", "--show-toplevel", chdir: path, err: File::NULL)
     status.success? ? output.strip : File.expand_path(path)
   rescue StandardError
     File.expand_path(path)

data/lib/harnex/runtime/session.rb

@@ -58,15 +58,16 @@ module Harnex
       end
     end
 
-    attr_reader :repo_root, :launch_cwd, :host, :port, :session_id, :token, :command, :pid, :id, :adapter, :watch,
+    attr_reader :repo_root, :launch_cwd, :child_cwd, :host, :port, :session_id, :token, :command, :pid, :id, :adapter, :watch,
                 :inbox, :description, :meta, :summary_out, :output_log_path, :events_log_path,
                 :started_at, :ended_at, :exit_code, :term_signal
 
-    def initialize(adapter:, command:, repo_root:, host:, port: nil, id: DEFAULT_ID, watch: nil, description: nil, meta: nil, summary_out: nil, inbox_ttl: Inbox::DEFAULT_TTL, auto_stop: false, launch_cwd: nil)
+    def initialize(adapter:, command:, repo_root:, host:, port: nil, id: DEFAULT_ID, watch: nil, description: nil, meta: nil, summary_out: nil, inbox_ttl: Inbox::DEFAULT_TTL, auto_stop: false, launch_cwd: nil, child_cwd: nil)
       @adapter = adapter
       @command = command
       @repo_root = repo_root
       @launch_cwd = File.expand_path(launch_cwd.to_s.empty? ? repo_root : launch_cwd)
+      @child_cwd = child_cwd.to_s.empty? ? nil : File.expand_path(child_cwd)
       @host = host
       @id = Harnex.normalize_id(id)
       @watch = watch
@@ -153,7 +154,9 @@ module Harnex
     end
 
     def run_pty
-      @reader, @writer, @pid = PTY.spawn(child_env, *command)
+      spawn_args = [child_env, *command]
+      spawn_args << { chdir: child_cwd } if child_cwd
+      @reader, @writer, @pid = PTY.spawn(*spawn_args)
       @writer.sync = true
       arm_auto_stop_after_initial_context
       emit_started_event
@@ -402,7 +405,7 @@ module Harnex
       adapter.on_notification { |msg| handle_structured_notification(msg) }
       adapter.on_disconnect { |err| handle_structured_disconnect(err) }
 
-      adapter.start_rpc(env: child_env, cwd: repo_root)
+      adapter.start_rpc(env: child_env, cwd: child_cwd || repo_root)
       @pid = adapter.pid
       @state_machine.force_prompt!
       emit_started_event
@@ -821,7 +824,7 @@ module Harnex
     def registry_payload
       status_payload(include_input_state: false).merge(
         token: token,
-        cwd: Dir.pwd
+        cwd: child_cwd || Dir.pwd
       )
     end
 

data/lib/harnex/version.rb

@@ -1,4 +1,4 @@
 module Harnex
-  VERSION = "0.7.8"
-  RELEASE_DATE = "2026-06-13"
+  VERSION = "0.7.9"
+  RELEASE_DATE = "2026-07-10"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: harnex
 version: !ruby/object:Gem::Version
-  version: 0.7.8
+  version: 0.7.9
 platform: ruby
 authors:
 - Jikku Jose
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-13 00:00:00.000000000 Z
+date: 2026-07-10 00:00:00.000000000 Z
 dependencies: []
 description: A local PTY harness that wraps terminal AI agents (Claude, Codex, Pi)
   and adds a control plane for discovery, messaging, and coordination.