================================================================================
QUICKSTART: Test the PLC Startup Race Condition Fix
================================================================================

1. BUILD SCENARIO
   cd ~/projects/ics-simlab-config-gen_claude
   .venv/bin/python3 build_scenario.py --out outputs/scenario_run --overwrite

2. VALIDATE FIX
   .venv/bin/python3 validate_fix.py
   # Should show: ✅ SUCCESS: All PLC files have the callback retry fix

3. START ICS-SIMLAB
   cd ~/projects/ICS-SimLab-main/curtin-ics-simlab
   sudo ./start.sh ~/projects/ics-simlab-config-gen_claude/outputs/scenario_run

4. MONITOR PLC2 (in another terminal)
   # Find container name
   sudo docker ps | grep plc2
   
   # View logs - look for NO "Exception in thread" errors
   sudo docker logs <plc2_container_name> -f

5. STOP ICS-SIMLAB
   cd ~/projects/ICS-SimLab-main/curtin-ics-simlab
   sudo ./stop.sh

================================================================================
FILES CHANGED:
  - tools/compile_ir.py (CRITICAL FIX: added _safe_callback retry wrapper)

NEW FILES:
  - build_scenario.py (deterministic scenario builder)
  - validate_fix.py (validation script)
  - test_simlab.sh (interactive launcher)
  - diagnose_runtime.sh (diagnostics)
  - RUNTIME_FIX.md (complete documentation)
  - CHANGES.md (summary with diffs)
  - DELIVERABLES.md (this summary)

For full details, see DELIVERABLES.md
================================================================================