portfolio/infra-run/scripts/README.md

# infra-run/scripts

This directory groups executable tooling used across the `infra-run` project. It separates shell-first operational scripts from Python-based analysis utilities while keeping both under one automation entry point.

## Diagram

```mermaid
flowchart TD
  A["scripts"] --> B["bash"]
  A --> C["python"]
  B --> D["Operational toolkits"]
  C --> E["Analysis helper utilities"]
```

## Scope

- [bash](./bash/) - operational toolkits for host health checks, disk-full triage, Veritas examples, and GPFS examples.
- [python](./python/) - read-only tools for local log parsing, reporting, and structured operational analysis.

## Notes

- Bash remains the right default for direct host checks and operational wrappers.
- Python is used where parsing, report generation, comparison, or JSON output is clearer than shell.
- Bash tooling should remain safe by default, readable, and validated with `../../scripts/check-bash.sh` from the repository root.
- Python tooling should remain read-only by default, standard-library based, and validated with `../../scripts/check-python.sh` from the repository root.