HF_RUNTIME_FIX_RECEIPT_3.md

# HF Runtime Fix Receipt 3

## Packet
HF_Substrate_Video_Atomization_Runtime_v0_1_PATCHED5

## Error addressed
The Hugging Face Space started, then crashed while Gradio generated API metadata:

- `TypeError: argument of type 'bool' is not iterable`
- `ValueError: When localhost is not accessible, a shareable link must be created.`

## Cause
The primary fault was a Gradio / gradio_client API-schema generation mismatch. Gradio attempted to convert a JSON schema fragment where `additionalProperties` was boolean. The gradio_client converter expected a dict-like schema and crashed.

The localhost/share error was downstream: because the root route failed during startup/API-info generation, Gradio concluded localhost was inaccessible.

## Fix applied
1. Added a narrow compatibility guard in `app.py` that maps boolean JSON-schema fragments to `Any` during Gradio API metadata conversion.
2. Changed launch call to bind explicitly for Hugging Face Spaces:
   - `server_name="0.0.0.0"`
   - `server_port=int(os.environ.get("PORT", "7860"))`
   - `show_error=True`
3. Updated Gradio pin from `4.44.0` to `4.44.1` while preserving `huggingface_hub==0.25.2` to keep the previous `HfFolder` fix settled.
4. Removed transient `__pycache__` from the release packet.

## Boundary
No atomization logic, HIR/OAM receipt logic, frame sampling, hashing, OpenCV processing, trace-stack construction, or packet generation logic was changed.