Newer
Older
ops-toolkit / packs / ops-scripts / README.md

ops-scripts -- shared operational scripts

Why the team uses it: one blessed copy of the small scripts everyone needs, linked into ~/.local/bin so git pull in the toolkit updates them for everyone at once.

What this pack installs:

  • install-010-bin.sh -- symlinks bin/* into ~/.local/bin

Provided scripts:

  • validate-paste.sh <file> -- pre-flight a bash script or paste block: parse check, CR-byte detection (python byte count -- grep on CR literals false-positives), ASCII-only check, bare-exit and destructive-command warnings. Run it on every block BEFORE pasting into a live shell. Remember its own caveat: bash -n is parse-only; behavior-test too.

Scope note: project-specific tooling (ledger-scan, cloud-assert, run-logged, preflight) stays in its project repo, where it versions with the project. This pack is for scripts that are useful on ANY box the team touches. Additions go through PR with a header contract (purpose, mutates-statement, usage, exit codes) -- see validate-paste.sh as the template.