ysoftwareab

Extension of sane-bash with explicit style and flow-control conventions for consistency, readability, and strict-mode-friendly Bash.

sane.bash — the modern Bash strict-mode boilerplate, an evolution of `set -euo pipefail` that adds errtrace, functrace, inherit_errexit, a stack-trace-on-failure ERR trap, an `exe()` echo-and-run helper, and opt-in xtrace. Use when generating or hardening any 'safe bash' / 'sane bash' script, production shell script, CLI wrapper, or CI/CD bash step that should fail fast with a readable stack trace. Triggers: 'sane bash', 'sane.bash', 'safe bash script', 'bash strict mode', 'set -euo pipefail', 'set -eEuo pipefail', 'errtrace', 'functrace', 'inherit_errexit', 'stack trace on failure', 'bash boilerplate', 'robust bash script', 'defensive bash'. Do NOT use for POSIX sh or non-Bash shells (relies on Bash 4.4+ features).

Understands and extends the sane.mk GNU Make framework for shared deps, check, build, test, dist, debug, and system workflows. Detect a sane.mk repo by `include $(SANE_MK_ROOT)/...` in the Makefile or a generated `Makefile.lazy` with `SANE_*` variables. Use when: * editing this repo * adding Make targets/includes * wiring behavior through `SANE_*` variables * adopting sane.mk in another project * debugging why a target is not reachable * validating, linting, formatting, or testing in a sane.mk repo (the entrypoint is `make check` / `make test`, never direct tool calls) * editing any non-Make file in a sane.mk repo when you need to validate it