Udon Log Triage
Overview
Reduce runtime failures by classifying logs, mapping errors to assets, and controlling fixes.
Workflow
- •Collect runtime logs with
validate runtimeorrun_clientsim. - •Classify errors with
classify_errorsand assert withassert_no_critical_errors. - •Map error locations to assets/components using
inspect where-used. - •Propose fixes: use
safe_fixonly for deterministic, unique candidates; otherwisedecision_required. - •Re-run runtime validation and save the report.
Commands
bash
prefab-sentinel validate runtime --scene "Assets/Scenes/Smoke.unity" prefab-sentinel inspect where-used --asset-or-guid "Assets/SomeAsset.prefab" --scope "Assets"
Guardrails
- •If Unity runtime is unavailable, mark the task as pending and stop after classification steps.
- •Do not apply changes without audit logs (
--confirm --out-report --change-reason).