# Runbook — RST vault (Python)
This workspace hosts **`rst_engine/`** (single Python implementation of \(\mu(\eta,n)\), Resource Triangle helpers, and graph/axiom utilities) and **expanded theory** scripts. **Rust** discrete engine: see [`docs/engine_map.md`](docs/engine_map.md).
## Environment
- **Python:** 3.11 or newer (see [`pyproject.toml`](pyproject.toml) `requires-python`).
- **Working directory:** repository root (`about systems/`).
```bash
cd "path/to/about systems"
python -m venv .venv
# Windows:
.venv\Scripts\activate
# Unix:
# source .venv/bin/activate
pip install -U pip
pip install -r requirements.txt
```
Optional (plots, SPARC notebooks, pandas):
```bash
pip install -r "expanded theory/sparc evaluation/requirements.txt"
```
## Smoke tests
From repository root:
```bash
pytest
```
## Re-verify key scripts (manual)
See **[`expanded theory applied/Implementation status and problems.md`](expanded theory applied/Implementation status and problems.md)** — section *How to re-verify* — for one-liners per application.
Aggregates:
```bash
python "expanded theory applied/foundation/run_all_foundation_scripts.py"
python "expanded theory applied/further applications/run_all_further_scripts.py"
```
## Capstone / index
- **[`expanded theory/python calculations/VAULT_INDEX.md`](expanded theory/python calculations/VAULT_INDEX.md)** — Sovereign Chain and sector scripts.
- **[`VAULT_README.md`](VAULT_README.md)** — entry point and hubs.
## SPARC evaluation
Code: **`expanded theory/sparc evaluation/`**. Download data per **[`expanded theory/sparc evaluation/data/README.md`](expanded theory/sparc evaluation/data/README.md)**. Run notebooks from that folder after installing its `requirements.txt`.