Add docs/SAFETY.md from Claro v1.17.26 zip

2026-06-01 00:54:19 +02:00
parent ab13d388bd
commit 488e25930b
1 changed files with 27 additions and 0 deletions
@@ -0,0 +1,27 @@
 # Safety & Hardening (Beta24)
 ## 1) Execution step limit
 Claro can optionally stop runaway programs (infinite loops) using a step limit.
 Set an environment variable:
 - `CLARO_STEP_LIMIT=200000`
 If the program exceeds that many executed lines/steps, Claro stops with an error.
 To disable the limit:
 - unset the variable, or set it to `0`.
 ## 2) Safer container access
 LIST bounds errors now report the index and list size:
 - `Index out of range: 10 (LIST size 3)`
 MAP lookups return NONE when the key is not found.
 ## 3) Why this exists
 Claro is designed for:
 - learners
 - classroom environments
 - scripts that should fail safely
 Safety limits help prevent “hangs forever” and provide clearer error messages.