debug_scripts/README.md

Debug Scripts

This folder contains diagnostic and testing scripts used during development and debugging.

Scripts

debug_score.py

Focused debugging script to trace the final_score transmission issue.

• Tests metadata propagation through the environment
• Verifies observation serialization
• Checks final_score in both metadata and direct field
• Usage: uv run python debug_scripts/debug_score.py

quick_test.py

Quick verification script for testing Docker builds and final_score fixes.

• Starts a fresh container from the latest image
• Runs a simple episode to completion
• Verifies final_score is properly transmitted
• Usage: uv run python debug_scripts/quick_test.py

Purpose

These scripts were created to:

1. Diagnose the bug where final_score was always 0.00
2. Trace the root cause (OpenEnv's serialization excluding metadata)
3. Verify the fix (adding final_score as a direct field on ProjectObservation)
4. Ensure the Docker build and deployment work correctly

Fix Summary

The final_score bug was fixed by:

• Adding final_score: Optional[float] to ProjectObservation in models.py
• Populating it in server/hustlers_env_environment.py
• Reading it in client.py and inference.py

This bypasses OpenEnv's metadata exclusion in serialization.