harnex 0.6.0 → 0.6.3

data/lib/harnex/commands/run.rb

@@ -48,6 +48,17 @@ module Harnex
           CLIs with smart prompt detection: #{Adapters.known.join(', ')}
           Any other CLI name is launched with generic wrapping.
           Wrapper options may appear before or after <cli>.
+
+        Common patterns:
+          #{program_name} codex --id cx-i-42 --tmux cx-i-42 --context "Read /tmp/task-impl-42.md"
+          #{program_name} codex --id cx-i-42 --watch --preset impl --context "Read /tmp/task-impl-42.md"
+          #{program_name} claude --id cl-r-42 --tmux cl-r-42 --description "Review task 42"
+
+        Gotchas:
+          Always pair --id and --tmux with the same value for delegated work.
+          Passing --tmux without --id creates a random harnex session ID.
+          --watch is foreground-only; do not combine it with --tmux or --detach.
+          Use -- before child CLI flags when a flag could be parsed by harnex.
       TEXT
     end
 

data/lib/harnex/commands/send.rb

@@ -38,7 +38,19 @@ module Harnex
     end
 
     def self.usage(program_name = "harnex send")
-      build_parser({}, program_name).to_s
+      <<~TEXT
+        #{build_parser({}, program_name)}
+        Common patterns:
+          #{program_name} --id cx-i-42 --message "Read /tmp/task-impl-42.md" --wait-for-idle --timeout 900
+          #{program_name} --id cx-i-42 --message "Continue with the current task." --force
+          #{program_name} --id "$HARNEX_ID" --message "Worker finished; tests passed."
+
+        Gotchas:
+          --wait-for-idle is a turn fence, not proof that the whole task is done.
+          Use --no-wait for fire-and-forget delivery only when another monitor owns completion.
+          Long prompts are more reliable when written to a file and referenced by path.
+          Messages between harnex sessions get relay headers unless --no-relay is used.
+      TEXT
     end
 
     def initialize(argv)

data/lib/harnex/commands/status.rb

@@ -19,6 +19,16 @@ module Harnex
           --all        List sessions across all repos
           --json       Output JSON instead of a table
           -h, --help   Show this help
+
+        Common patterns:
+          #{program_name}
+          #{program_name} --all
+          #{program_name} --id cx-i-42 --json
+
+        Gotchas:
+          By default, status filters to the current repo root.
+          Use --all when supervising workers launched from sibling worktrees.
+          A prompt-like state is not a completion signal by itself.
       TEXT
     end
 

data/lib/harnex/commands/stop.rb

@@ -23,6 +23,16 @@ module Harnex
 
         Sends the adapter stop sequence to the session.
         Use `harnex wait --id ID` afterward to block until the session finishes.
+
+        Common patterns:
+          #{program_name} --id cx-i-42
+          #{program_name} --id cx-i-42 --repo /path/to/repo
+          #{program_name} --id cx-i-42 --timeout 15
+
+        Gotchas:
+          Stop only after verifying the worker's result landed.
+          For tmux sessions, stop targets the harnex session ID, not the tmux name.
+          If a session is in another repo/worktree, pass --repo or run status --all.
       TEXT
     end
 

data/lib/harnex/commands/wait.rb

@@ -24,6 +24,16 @@ module Harnex
           --repo PATH     Resolve session using PATH's repo root (default: current repo)
           --timeout SECS  Maximum time to wait in seconds (default: unlimited)
           -h, --help      Show this help
+
+        Common patterns:
+          #{program_name} --id cx-i-42 --until task_complete --timeout 900
+          #{program_name} --id cx-i-42 --until prompt --timeout 120
+          #{program_name} --id cx-i-42
+
+        Gotchas:
+          task_complete is an event predicate; prompt/busy are live state polls.
+          Prompt state alone does not prove work acceptance. Verify artifacts/tests.
+          Without --timeout, wait can block indefinitely.
       TEXT
     end
 

data/lib/harnex/runtime/session.rb

@@ -229,7 +229,7 @@ module Harnex
 
     def inject_via_adapter(text:, submit:, enter_only:, force: false)
       if adapter.transport == :stdio_jsonrpc
-        return inject_via_jsonrpc(text: text, force: force)
+        return inject_via_jsonrpc(text: text, submit: submit, enter_only: enter_only, force: force)
       end
 
       snapshot = adapter.wait_for_sendable(method(:screen_snapshot), submit: submit, enter_only: enter_only, force: force)
@@ -256,25 +256,36 @@ module Harnex
         .tap { emit_send_event(text, force: payload[:force]) }
     end
 
-    def inject_via_jsonrpc(text:, force: false)
+    def inject_via_jsonrpc(text:, submit:, enter_only:, force: false)
+      payload = adapter.build_send_payload(
+        text: text,
+        submit: submit,
+        enter_only: enter_only,
+        screen_text: nil,
+        force: force
+      )
+      dispatch = payload.fetch(:dispatch).dup
+      dispatch[:model] = meta_hash["model"] if meta_hash["model"] && !dispatch.key?(:model)
+      dispatch[:effort] = meta_hash["effort"] if meta_hash["effort"] && !dispatch.key?(:effort)
+
       turn_id = nil
       @inject_mutex.synchronize do
-        turn_id = adapter.dispatch(prompt: text)
+        turn_id = adapter.dispatch(**dispatch)
         @state_machine.force_busy!
         @injected_count += 1
         @last_injected_at = Time.now
         persist_registry
       end
 
-      emit_send_event(text, force: force)
+      emit_send_event(dispatch.fetch(:prompt, text), force: payload[:force])
       {
         ok: true,
         cli: adapter.key,
-        bytes_written: text.to_s.bytesize,
+        bytes_written: dispatch.fetch(:prompt, text).to_s.bytesize,
         injected_count: @injected_count,
         newline: false,
-        input_state: adapter.input_state(nil),
-        force: force,
+        input_state: payload[:input_state],
+        force: payload[:force],
         turn_id: turn_id
       }
     end
@@ -300,6 +311,7 @@ module Harnex
 
       adapter.start_rpc(env: child_env, cwd: repo_root)
       @pid = adapter.pid
+      @state_machine.force_prompt!
       emit_started_event
       emit_git_start_event
 
@@ -310,6 +322,7 @@ module Harnex
 
       watch_thread = start_watch_thread
       @inbox.start
+      dispatch_initial_prompt
 
       if @pid
         begin
@@ -364,9 +377,11 @@ module Harnex
       when "thread/started"
         @rpc_thread_id = params["threadId"] || params["thread_id"]
       when "turn/started"
+        @state_machine.force_busy!
         emit_event("turn_started", turnId: params["turnId"] || params["turn_id"])
       when "turn/completed"
         @last_completed_at = Time.now
+        @state_machine.force_prompt!
         payload = { turnId: params["turnId"] || params["turn_id"] }
         payload[:status] = params["status"] if params["status"]
         payload[:tokenUsage] = params["tokenUsage"] if params["tokenUsage"]
@@ -386,6 +401,7 @@ module Harnex
       when "account/rateLimits/updated"
         @rate_limits = params
       when "error"
+        @state_machine.force_busy!
         emit_event("disconnected", source: "error_notification", message: params["message"])
         signal_rpc_done!
       end
@@ -395,10 +411,20 @@ module Harnex
 
     def handle_rpc_disconnect(error)
       msg = error.is_a?(Hash) ? error["message"] : error&.message
+      @state_machine.force_busy!
       emit_event("disconnected", source: "transport", message: msg) rescue nil
       signal_rpc_done!
     end
 
+    def dispatch_initial_prompt
+      return unless adapter.respond_to?(:initial_prompt)
+
+      prompt = adapter.initial_prompt
+      return if prompt.to_s.empty?
+
+      inject_via_jsonrpc(text: prompt, submit: true, enter_only: false, force: false)
+    end
+
     def render_item_text(item)
       return nil unless item.is_a?(Hash)
 

data/lib/harnex/runtime/session_state.rb

@@ -36,6 +36,13 @@ module Harnex
       end
     end
 
+    def force_prompt!
+      @mutex.synchronize do
+        @state = :prompt
+        @condvar.broadcast
+      end
+    end
+
     def wait_for_prompt(timeout)
       deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + timeout
       @mutex.synchronize do

data/lib/harnex/version.rb

@@ -1,4 +1,4 @@
 module Harnex
-  VERSION = "0.6.0"
+  VERSION = "0.6.3"
   RELEASE_DATE = "2026-05-06"
 end

data/lib/harnex.rb

@@ -24,6 +24,6 @@ require_relative "harnex/commands/events"
 require_relative "harnex/commands/pane"
 require_relative "harnex/commands/recipes"
 require_relative "harnex/commands/guide"
-require_relative "harnex/commands/skills"
+require_relative "harnex/commands/agents_guide"
 require_relative "harnex/commands/doctor"
 require_relative "harnex/cli"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: harnex
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.3
 platform: ruby
 authors:
 - Jikku Jose
@@ -26,6 +26,11 @@ files:
 - TECHNICAL.md
 - bin/gem-push
 - bin/harnex
+- guides/01_dispatch.md
+- guides/02_chain.md
+- guides/03_buddy.md
+- guides/04_monitoring.md
+- guides/05_naming.md
 - lib/harnex.rb
 - lib/harnex/adapters.rb
 - lib/harnex/adapters/base.rb
@@ -34,6 +39,7 @@ files:
 - lib/harnex/adapters/codex_appserver.rb
 - lib/harnex/adapters/generic.rb
 - lib/harnex/cli.rb
+- lib/harnex/commands/agents_guide.rb
 - lib/harnex/commands/doctor.rb
 - lib/harnex/commands/events.rb
 - lib/harnex/commands/guide.rb
@@ -42,7 +48,6 @@ files:
 - lib/harnex/commands/recipes.rb
 - lib/harnex/commands/run.rb
 - lib/harnex/commands/send.rb
-- lib/harnex/commands/skills.rb
 - lib/harnex/commands/status.rb
 - lib/harnex/commands/stop.rb
 - lib/harnex/commands/wait.rb
@@ -62,12 +67,6 @@ files:
 - recipes/01_fire_and_watch.md
 - recipes/02_chain_implement.md
 - recipes/03_buddy.md
-- skills/close/SKILL.md
-- skills/harnex-buddy/SKILL.md
-- skills/harnex-chain/SKILL.md
-- skills/harnex-dispatch/SKILL.md
-- skills/harnex/SKILL.md
-- skills/open/SKILL.md
 homepage: https://github.com/jikkuatwork/harnex
 licenses:
 - MIT

data/lib/harnex/commands/skills.rb

@@ -1,226 +0,0 @@
-require "fileutils"
-
-module Harnex
-  class Skills
-    SKILLS_ROOT = File.expand_path("../../../../skills", __FILE__)
-    INSTALL_SKILLS = %w[harnex-dispatch harnex-chain harnex-buddy].freeze
-    DEPRECATED_SKILLS = %w[harnex dispatch chain-implement].freeze
-    SKILL_ALIASES = {
-      "harnex" => "harnex-dispatch",
-      "dispatch" => "harnex-dispatch",
-      "chain-implement" => "harnex-chain"
-    }.freeze
-
-    def self.usage
-      <<~TEXT
-        Usage: harnex skills <subcommand> [SKILL...] [--local]
-
-        Subcommands:
-          install     Install bundled skills (globally by default; optional skill names)
-          uninstall   Remove installed skills (globally by default)
-
-        Options:
-          --local     Target the current repo instead of global ~/.claude/
-
-        Installs: #{INSTALL_SKILLS.join(', ')}
-        Aliases: harnex|dispatch -> harnex-dispatch, chain-implement -> harnex-chain
-
-        By default, copies each skill to ~/.claude/skills/<skill>/
-        and symlinks ~/.codex/skills/<skill> to it.
-
-        With --local, copies each skill to .claude/skills/<skill>/
-        in the current repo and symlinks .codex/skills/<skill> to it.
-      TEXT
-    end
-
-    def initialize(argv)
-      @argv = argv.dup
-    end
-
-    def run
-      subcommand = @argv.shift
-      case subcommand
-      when "install"
-        local, help, requested_skills = parse_args(@argv, allow_positional: true)
-        return (puts self.class.usage; 0) if help
-
-        remove_deprecated(local)
-        install_skills = requested_skills.empty? ? INSTALL_SKILLS : canonical_skill_names(requested_skills)
-
-        install_skills.each do |skill_name|
-          skill_source = resolve_skill_source(skill_name)
-          unless skill_source
-            return missing_skill(skill_name)
-          end
-
-          result = local ? install_local(skill_name, skill_source) : install_global(skill_name, skill_source)
-          return result unless result == 0
-        end
-        0
-      when "uninstall"
-        local, help, = parse_args(@argv)
-        return (puts self.class.usage; 0) if help
-
-        (INSTALL_SKILLS + DEPRECATED_SKILLS).each do |skill_name|
-          local ? uninstall_local(skill_name) : uninstall_global(skill_name)
-        end
-        0
-      when "-h", "--help", nil
-        puts self.class.usage
-        0
-      else
-        warn("harnex skills: unknown subcommand #{subcommand.inspect}")
-        puts self.class.usage
-        1
-      end
-    end
-
-    private
-
-    def parse_args(args, allow_positional: false)
-      local = false
-      help = false
-      positional = []
-
-      args.each do |arg|
-        case arg
-        when "--local"
-          local = true
-        when "-h", "--help"
-          help = true
-        when /\A-/
-          raise "harnex skills: unknown option #{arg.inspect}"
-        else
-          if allow_positional
-            positional << arg
-          else
-            warn("harnex skills: unexpected argument #{arg.inspect}")
-            raise "harnex skills takes no positional arguments"
-          end
-        end
-      end
-
-      [local, help, positional]
-    end
-
-    def resolve_skill_source(skill_name)
-      path = File.join(SKILLS_ROOT, skill_name)
-      File.directory?(path) ? path : nil
-    end
-
-    def missing_skill(skill_name)
-      warn("harnex skills: bundled skill #{skill_name.inspect} not found at #{SKILLS_ROOT}")
-      1
-    end
-
-    def remove_deprecated(local)
-      DEPRECATED_SKILLS.each do |skill_name|
-        local ? uninstall_local(skill_name) : uninstall_global(skill_name)
-      end
-    end
-
-    def canonical_skill_names(skill_names)
-      skill_names.map { |name| canonical_skill_name(name) }.uniq
-    end
-
-    def canonical_skill_name(skill_name)
-      SKILL_ALIASES.fetch(skill_name, skill_name)
-    end
-
-    def install_local(skill_name, skill_source)
-      repo_root = Harnex.resolve_repo_root(Dir.pwd)
-      claude_dir = File.join(repo_root, ".claude", "skills", skill_name)
-      codex_dir = File.join(repo_root, ".codex", "skills", skill_name)
-
-      # Copy skill to .claude/skills/<skill>/
-      if Dir.exist?(claude_dir)
-        warn("harnex skills: #{claude_dir} already exists, overwriting")
-        FileUtils.rm_rf(claude_dir)
-      end
-      FileUtils.mkdir_p(File.dirname(claude_dir))
-      FileUtils.cp_r(skill_source, claude_dir)
-      puts "installed #{claude_dir}"
-
-      # Symlink .codex/skills/<skill> -> .claude/skills/<skill>
-      codex_parent = File.dirname(codex_dir)
-      FileUtils.mkdir_p(codex_parent)
-      FileUtils.rm_rf(codex_dir) if File.exist?(codex_dir) || File.symlink?(codex_dir)
-
-      # Relative symlink so it works if the repo moves
-      relative = relative_path(from: codex_parent, to: claude_dir)
-      File.symlink(relative, codex_dir)
-      puts "symlinked #{codex_dir} -> #{relative}"
-
-      0
-    end
-
-    def install_global(skill_name, skill_source)
-      claude_dir = File.expand_path("~/.claude/skills/#{skill_name}")
-      codex_dir = File.expand_path("~/.codex/skills/#{skill_name}")
-
-      # Copy skill to ~/.claude/skills/<skill>/
-      if Dir.exist?(claude_dir)
-        warn("harnex skills: #{claude_dir} already exists, overwriting")
-        FileUtils.rm_rf(claude_dir)
-      end
-      FileUtils.mkdir_p(File.dirname(claude_dir))
-      FileUtils.cp_r(skill_source, claude_dir)
-      puts "installed #{claude_dir}"
-
-      # Symlink ~/.codex/skills/<skill> -> ~/.claude/skills/<skill>
-      codex_parent = File.dirname(codex_dir)
-      FileUtils.mkdir_p(codex_parent)
-      FileUtils.rm_rf(codex_dir) if File.exist?(codex_dir) || File.symlink?(codex_dir)
-      File.symlink(claude_dir, codex_dir)
-      puts "symlinked #{codex_dir} -> #{claude_dir}"
-
-      0
-    end
-
-    def uninstall_local(skill_name)
-      repo_root = Harnex.resolve_repo_root(Dir.pwd)
-      claude_dir = File.join(repo_root, ".claude", "skills", skill_name)
-      codex_dir = File.join(repo_root, ".codex", "skills", skill_name)
-
-      removed = false
-      if File.exist?(codex_dir) || File.symlink?(codex_dir)
-        FileUtils.rm_rf(codex_dir)
-        removed = true
-      end
-      if File.exist?(claude_dir) || File.symlink?(claude_dir)
-        FileUtils.rm_rf(claude_dir)
-        removed = true
-      end
-      puts "removed #{skill_name}" if removed
-    end
-
-    def uninstall_global(skill_name)
-      claude_dir = File.expand_path("~/.claude/skills/#{skill_name}")
-      codex_dir = File.expand_path("~/.codex/skills/#{skill_name}")
-
-      removed = false
-      if File.exist?(codex_dir) || File.symlink?(codex_dir)
-        FileUtils.rm_rf(codex_dir)
-        removed = true
-      end
-      if File.exist?(claude_dir) || File.symlink?(claude_dir)
-        FileUtils.rm_rf(claude_dir)
-        removed = true
-      end
-      puts "removed #{skill_name}" if removed
-    end
-
-    def relative_path(from:, to:)
-      from_parts = File.expand_path(from).split("/")
-      to_parts = File.expand_path(to).split("/")
-
-      # Drop common prefix
-      while from_parts.first == to_parts.first && !from_parts.empty?
-        from_parts.shift
-        to_parts.shift
-      end
-
-      ([".."] * from_parts.length + to_parts).join("/")
-    end
-  end
-end

data/skills/close/SKILL.md

@@ -1,47 +0,0 @@
----
-name: close
-description: Close a work session in this repo — update koder/STATE.md with what changed and the next step, clean up accidental or temporary repo artifacts, and leave a clear handoff. Use when the user says "close session", "wrap up", "end session", "handoff", or invokes "/close".
----
-
-# Close Session Workflow
-
-When the user asks to wrap up or close the current session, run this sequence:
-
-## 1. Review the session changes
-
-- Check `git status --short` and `git diff --stat`
-- Separate the work from this session from unrelated user changes
-- Do not revert unrelated changes you did not make
-
-## 2. Update `koder/STATE.md`
-
-- Update the `Updated:` date
-- Add or adjust concise lines in `Current snapshot` for completed work
-- Update test count if it changed
-- Update issue or plan statuses only when work was actually completed or a new blocker was clearly discovered
-- Rewrite `Next step` so the next agent can resume without reconstructing context
-
-## 3. Clean up repo artifacts
-
-- Remove temporary files, scratch notes, or mistaken tracking docs created during the session
-- Keep durable artifacts that are part of the intended result
-- If cleanup would discard ambiguous work, ask the user instead of guessing
-
-## 4. Commit and clean the repo
-
-- Stage all session changes (code, docs, STATE.md updates) and commit with a clear message summarizing the session's work
-- Do NOT stage files that look like secrets, credentials, or large binaries — flag them to the user
-- After committing, run `git status --short` to confirm a clean working tree
-- If unrelated uncommitted changes remain, leave them alone — do not revert or commit work you did not produce
-
-## 5. Verify the handoff
-
-- Run the relevant tests or verification commands if code or docs changed
-- Give the user a concise summary of what changed, the commit, and any remaining follow-up
-- The goal: the next `/open` should see a clean repo and an accurate `koder/STATE.md`
-
-## Notes
-
-- Do NOT create or close issue docs unless the user explicitly asks
-- Do NOT build, install, or publish anything unless the user explicitly asks
-- If `koder/STATE.md` is already accurate, keep the update minimal rather than churning it

data/skills/harnex/SKILL.md

@@ -1,20 +0,0 @@
----
-name: harnex
-description: Deprecated alias for harnex-dispatch. Use harnex-dispatch for active harnex collaboration guidance.
----
-
-# Deprecated Skill Alias
-
-`harnex` is deprecated.
-
-Use `harnex-dispatch` as the canonical skill for harnex collaboration,
-Fire & Watch dispatching, relay handling, and return-channel discipline.
-
-If you are installing skills, use:
-
-```bash
-harnex skills install harnex-dispatch
-```
-
-Compatibility note: `harnex skills install harnex` remains supported and
-installs `harnex-dispatch`.

data/skills/harnex-buddy/SKILL.md

@@ -1,104 +0,0 @@
----
-name: harnex-buddy
-description: Spawn an accountability partner for long-running harnex sessions. Use when the user asks to run something overnight, unattended, or for any work expected to take more than 30 minutes without supervision.
----
-
-# Buddy — Accountability Partner for Long-Running Work
-
-For any long-running or unattended work, spawn a **buddy** — a second harnex
-agent that watches the worker and nudges it if it stalls.
-
-For plain stall recovery (force-resume on inactivity), prefer
-`harnex run --watch --preset impl`. Use a buddy when you need reasoning that
-policy checks cannot provide (doc drift, semantic checks, multi-session
-correlation).
-
-The buddy is an LLM, so it has intelligence for free. It reads the worker's
-screen, reasons about whether it's stuck, and composes a meaningful nudge.
-
-Dispatch workers via `harnex-dispatch` first. This skill owns only buddy
-behavior after the worker is already running.
-
-## When to activate
-
-- User says "do this overnight" or "run this while I'm away"
-- Task is expected to take more than 30 minutes unattended
-- User explicitly asks for a buddy, accountability partner, or monitoring
-- User asks to "keep an eye on" a dispatched worker
-
-## Spawn the buddy
-
-After dispatching the worker with `harnex-dispatch`, spawn a buddy alongside
-it. Keep ID/tmux naming consistent with `harnex-dispatch` (`--tmux` matches
-`--id`):
-
-```bash
-# Spawn its buddy
-harnex run claude --id buddy-42 --tmux buddy-42
-```
-
-## Write the buddy prompt
-
-Write a task file with the watching instructions, then send it:
-
-```bash
-cat > /tmp/buddy-42.md <<'EOF'
-You are an accountability partner for harnex session `cx-impl-42`.
-
-Your job:
-1. Every 5 minutes, check on the worker:
-   - `harnex pane --id cx-impl-42 --lines 20`
-   - `harnex status --id cx-impl-42 --json`
-2. If the worker appears stuck at a prompt for more than 10 minutes
-   with no progress, nudge it:
-   - `harnex send --id cx-impl-42 --message "You appear to have stalled. Continue with your current task."`
-3. If the worker has exited, report back to the invoker:
-   - `tmux send-keys -t "$HARNEX_SPAWNER_PANE" "cx-impl-42 has exited. Check results." Enter`
-4. Keep watching until the worker finishes or is stopped.
-
-Do not interfere with work in progress. Only nudge when clearly stalled.
-EOF
-
-harnex send --id buddy-42 --message "Read and execute /tmp/buddy-42.md"
-```
-
-Adjust the polling interval (5 min), stall threshold (10 min), and nudge
-message to match the workload.
-
-## Return channel
-
-The buddy can reach back to the invoker (your raw Claude session) via
-`$HARNEX_SPAWNER_PANE` — the stable tmux pane ID set automatically by
-harnex at spawn time:
-
-```bash
-# Read the invoker's screen
-tmux capture-pane -t "$HARNEX_SPAWNER_PANE" -p
-
-# Type into the invoker
-tmux send-keys -t "$HARNEX_SPAWNER_PANE" "worker-42 finished" Enter
-```
-
-The invoker does NOT need to be a harnex session. It just needs to be in tmux.
-
-## Naming convention
-
-Use naming from `harnex-dispatch`: set `--tmux <same-as-id>` for every
-session and keep the buddy ID paired with the worker step ID.
-
-## Cleanup
-
-Stop the buddy after the worker finishes:
-
-```bash
-harnex stop --id buddy-42
-```
-
-## Notes
-
-- For chain orchestration, phase gates, and the 5-concurrent parallel planning
-  cap, see `harnex-chain`.
-- One buddy per worker, or one buddy watching multiple sessions
-- The buddy is a regular harnex session — stop, inspect, log it like any other
-- Tune polling and thresholds in the buddy's prompt, not in harnex config
-- See `recipes/03_buddy.md` for the full recipe