Add bash-to-rc syntax converter and comprehensive rc syntax guide for AI tools

[Copilot]

Implements the "next steps" from IMPLEMENTATION_SUMMARY.md: expand rc command generation support and add comprehensive syntax examples for AI tool developers.

New: bash-to-rc converter

examples/bash_to_rc_converter.py — importable Python module + CLI that translates common bash/sh patterns to rc equivalents:

$ echo 'for f in *.txt; do echo $f; done' | python3 examples/bash_to_rc_converter.py
for(f in *.txt) {
  echo $f
}

$ python3 examples/bash_to_rc_converter.py 'result=$(hostname)'
result = `{hostname}

Handles: command substitution, variable assignments/braces/length, for/while/if/elif/else control flow, function definitions, stderr redirection, shebang, and arithmetic expansion (flagged with awk alternative + TODO).

convert-to-rc.sh — thin shell wrapper for the converter.

New: RC syntax reference

RC_SYNTAX_GUIDE.md — dense bash↔rc side-by-side reference covering variables, control flow, functions, redirection, lists, error handling, and common AI-generated command patterns. Intended as a quick reference for AI tools generating rc commands.

Tests

Three new tests added to test-integration.sh (Tests 6–8): converter correctness for each major syntax pattern, wrapper sanity check, and guide presence/content validation.

---

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.