feat(batch): add batch command for ordered input-and-wait sequences

[ThomasK33]

Summary

Adds the batch command (closes #123): run an ordered JSON array of Batch Steps — type | paste | sendKeys | run | wait — against one Command Target in a single invocation, instead of coordinating separate run/type/paste/send-keys/wait calls.

Each wait step is anchored to a Wait Baseline (ADR-0007): it only considers screen state produced after the preceding input step, so a batch cannot race ahead and match a stale screen the way a hand-written shell loop can. Fail-fast by default; --keep-going attempts every step; --json emits a per-step envelope.

agent-tty batch <session-id> '[{"run":"nvim --clean","noWait":true},{"wait":{"screenStableMs":1000}},{"type":"hello"},{"sendKeys":["Escape"]},{"type":":wq"},{"sendKeys":["Enter"]},{"wait":{"text":"written"}}]' --json

What's included (5 vertical slices)

1. Wait Baseline primitive — optional afterSeq on the WaitForRender params, gated in both the live host poll (including a stability-clock reset so a stale pre-step screen is never certified "stable") and the offline matcher; the standalone wait --after-seq; and type/paste results now return their Event Log seq so they can anchor a following wait.
2. Batch Plan parser (pure) — JSON → validated tagged-union steps; rejects malformed JSON, non-array/empty plans, and zero-verb / multi-verb / unknown-verb / unknown-key steps. A shared key-name validator means a bad sendKeys chord fails the whole plan before any input is sent (a batch is not atomic).
3. Executor + StepDriver + CLI — a pure executor over an injected StepDriver (ordering, baseline threading, accumulation); parsing precedes Command Target resolution so bad input fails without a live session.
4. Failure semantics — new WAIT_TIMEOUT error + exit code 11 (a timed-out render wait is a failed step, unlike standalone wait which exits 0); fail-fast vs --keep-going; per-step completed / failed / not-run status; and the per-step envelope is always emitted, even on failure (doctor-style exit handling).
5. Interrupt + e2e + docs — synchronous SIGINT/SIGTERM handler that flushes a partial envelope; fixture-driven e2e; and USAGE/SKILL/README/CHANGELOG updates.

Testing

• ✅ Locally green: format:check, lint, typecheck, build, and unit tests (1306, +94).
• ✅ Dist smoke (no live session): --help lists the flags; empty array → INVALID_INPUT (exit 2); a valid step → SESSION_NOT_FOUND (exit 3, proving parse precedes target resolution); a two-verb step → the precise "exactly one of…" error; a bad key name → INVALID_KEYS at parse time.
• ⏳ Integration (test/integration/batch.test.ts) and e2e (test/e2e/batch-fixture.test.ts) require a real PTY/renderer and run here in CI (they could not execute in the dev sandbox; they were type-checked + statically reviewed).

Notes

• Out of scope per the PRD: capture steps inside a batch, a stdin source, fixing echo-match (the Wait Baseline fixes stale-match only), a host-side batch RPC, inline waits / control flow, and atomic rollback.
• The Wait Baseline change is backward compatible: with no afterSeq, render-wait behaves exactly as before.

🤖 Generated with Claude Code