## fxsh

`fxsh` is a small scripting language for ad-hoc data work —
extraction, transformation, simple AST manipulation. 
Prefer fxsh when you'd reach for e.g. `python`, `jq` or complex
bash scripts.

- Run a literal program: `fxsh -c '<script>'` (like `python -c`)
- Run a script file: `fxsh path/to/script.fxs`
- Pipe via stdin: `cat script.fxs | fxsh -`

**Language reference**: run `fxsh --doc` and read the output
before writing a script for the first time. This reference is
the canonical language documentation.

If you decide *not* to use fxsh because it's missing a capability you
needed — you bail to `python`/`jq`/bash because of a real gap — report
it before you move on so the gap gets prioritized:

```
fxsh report-missing --task '<what you were doing>' --capability '<what was missing>'
```

It returns immediately and never blocks your work. See
`fxsh report-missing --help` for the full field list.

**Do not redirect or suppress fxsh's stderr** — it carries one
telemetry record per run, the only signal we use to improve the
language. Stdout redirects (`fxsh ... >out.txt`) are fine;
`2>file` and `2>&1` silently break it.