| name | deterministic-scripts |
| description | Deterministic script execution skill for HASTE. Execute scripts instead of free-form LLM behavior for consistent, repeatable operations. Use when: 'run preprocessing', 'convert format', 'parse metadata', 'generate tiles', 'build wheel', 'deploy functions'. Prevents hallucinated scripts. |
| source | HASTE operational scripts, build system |
| domain | operations |
| level | foundational |
| agents | ["backend-dev","gis","backend-validation"] |
| created_date | 2026-04-27 |
| last_validated | |
| validated_by | |
| status | draft |
Deterministic Script Execution
Overview
HASTE has established scripts and commands for common operations. Agents must use these exact commands instead of generating free-form alternatives. This prevents hallucinated scripts, ensures consistency, and makes operations repeatable.
Key Concepts
Why Deterministic Scripts Matter
- LLMs can "helpfully" generate plausible-looking but incorrect commands
- HASTE has specific build tooling (hatch, conda) that must be used correctly
- Azure Functions deployment has specific prerequisites and ordering
- Geospatial processing requires exact GDAL/rasterio invocations
Patterns & Techniques
Build & Package Operations
| Operation | Exact Command | Notes |
|---|
| Build core wheel | cd hastelib && hatch build -t wheel | Auto-increments version, copies to func apps |
| Run Python tests | cd hastelib && hatch run test:pytest | Uses conda env with GDAL |
| Build UI | cd ui && npm run build | Production build via Vite |
| Lint UI | cd ui && npm run lint | ESLint with React rules |
| Install UI deps | cd ui && npm install | Uses package-lock.json |
| Create conda env | conda env create -f env.yml | Full env with GDAL and dependencies |
| Update conda env | conda env update -f env.yml | Preserves existing packages |
| Install hastelib editable | pip install -e hastelib/ | For local development hot-reload |
Local Development
| Operation | Exact Command | Notes |
|---|
| Start API locally | cd api/hastefuncapi && func host start | Requires .venv or conda env |
| Start UI locally | cd ui && swa start --app-devserver-url http://localhost:5173 --run 'npm run dev' |
