Documentation
¶
Overview ¶
Package sigutil hosts the small signal-forwarding loop every harness adapter runs while its child process is alive. Phase 3-d (PR1) extracted it so the claude / codex / opencode / shell adapters do not all carry their own copy of the same select-loop boilerplate.
The loop owns three concerns:
- SIGUSR1 (the daemon's "stop this agent" out-of-band signal) → forward SIGTERM to the child process. Marks the run as stoppedByDaemon=true so the caller can normalise the resulting exit code into 0.
- SIGWINCH (terminal resize) → forward verbatim so PTY-backed children redraw at the new width.
- cmd.Wait() completion → exit code extraction with stop-signal normalisation.
Run() exposes a single entry point that drives the loop until the child exits. Callers fork the child themselves (each adapter has its own argv / env / Setsid handling) and just hand the *exec.Cmd to ForwardAndWait.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ForwardAndWait ¶
ForwardAndWait runs the signal-forwarding select loop for a started *exec.Cmd. The returned exitCode is the normalised child exit (143 → 0 when the daemon sent the stop signal). stoppedByDaemon is true when SIGUSR1 was observed during the run. label is used only to format any "wait" error so the upstream caller sees `wait claude: ...` etc.
ForwardAndWait does NOT start the child — the caller has already done `cmd.Start()` and is responsible for closing whatever stdio plumbing surrounds the run (e.g. shell adapter's StdoutCaptureFile). This split keeps each adapter's setup distinct while sharing the wait/signal core.
Types ¶
This section is empty.
Source Files