fix(parser): redirect and heredoc combos; function redirects stop streaming

[chaliy]

Requested by Михайло · project thread

What changed

• A function call with output redirects now suspends streaming output while its body runs, as compound commands already did. Before, f > out wrote to out and also printed to the caller (the CLI and exec_streaming).
• &>> file is lexed and parsed as >> file 2>&1. It was a parse error.
• Here documents:
  • The rest of the line after a heredoc now parses like any other command line. Several heredocs per line work (cat <<A <<B, the last is stdin), and so do words after one (cat <<A file).
  • Compound commands take more redirects after a heredoc (done <<A 3<<B >out).
  • N<<EOF targets fd N (new Token::HereDocFd) and does not feed stdin. It was a 3 word plus a stdin heredoc.
• paste - - hands stdin lines to its - operands in turn, like GNU. With -s, the first one takes everything.

Why

These are roadmap step 1 fidelity gaps from the Debian-oracle shell cases redirect-stdout-stderr-combos and heredoc-multiple-same-line. Both cases now match bash. The function leak was the worst: any agent running log() {...}; log > file through the CLI or a streaming host saw the output twice.

Before / After

Script	Before	After (= bash)
f() { echo out; }; f > o.txt (CLI)	prints out	prints nothing
echo a &>> x.txt	parse error	appends
cat <<A <<B …	body of A	body of B
paste - - <<A 3<<B …	3: command not found	a1 a2
printf '1\n2\n3\n' | paste - -	1 1 / 2 2 / 3 3	1 2 / 3

Proof: new spec redirect-heredoc-combos.test.sh (7 cases, bash-verified), new integration test redirected_function_output_is_not_streamed, and bash_comparison passes.

Risk

Low-medium. This is a parser change: the lexer now always re-injects the line break after a heredoc delimiter, and the simple-command loop keeps parsing after a heredoc instead of stopping. Full lib, integration and comparison suites pass.

Checklist

• Failing tests first
• cargo test -p bashkit --lib / --test integration / bash_comparison
• clippy -D warnings, fmt, check-okf
• knowledge: parser.md, log

https://claude.ai/code/session_019aFikmptPc91Fj4N2iDXQA

---

Generated by Claude Code

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	bashkit	72b78b4	Commit Preview URL Branch Preview URL	Oct 07 2026, 07:45 PM