git:20260731.2dc88a7 to git:20260905.a30aa08
10 added, 0 removed. Audit A to A.
# infrastructure/core/runtime/ - Runtime Helper Documentation
## Purpose
The `infrastructure/core/runtime/` package contains runtime helpers for environment setup, dependency checks, checkpointing, profiling, health, and retry behavior.
## Files
- `_python_env.py` - Python environment helpers, confined analysis-script paths,
and fail-closed analysis subprocess environments
- `_packages.py` - package detection helpers
- `_directories.py` - directory helpers
- `checkpoint.py` - pipeline checkpointing
- `environment.py` - environment validation
- `env_deps.py` - dependency helpers
- `setup_checks.py` - Stage 0 orchestration and aggregate `run_environment_setup_checks` service (used by `scripts/pipeline/stage_00_setup.py`)
- `python_compatibility.py` - Python 3.10 syntax/API floor scanner with guarded 3.11+ compatibility handling
- `eta.py` - ETA helpers
- `function_profiler.py` - function profiling
- `health_check.py` - health checks
- `retry.py` - retry helpers
## See Also
- [`README.md`](README.md)
- [`../AGENTS.md`](../AGENTS.md)
+ ## Checkpoint recovery
+
+ Checkpoint loading validates integer stage counters, finite nonnegative runtime
+ measurements, stage result shapes, and optional output digests before resume.
+ Malformed persisted fields produce an unavailable checkpoint instead of crashing
+ the pipeline. Failed serialization, digest reads, or writes leave the previous
+ valid checkpoint intact. New checkpoint files use private `0600` permissions.
+ The executor passes the resolved project directory so lifecycle projects keep
+ checkpoints alongside their own outputs.
+