Skip to content

fix(fp): report the blocking model-load fallback once per path - #120

Merged
KunalSiyag merged 2 commits into
mainfrom
droid/popin-budget
Oct 28, 2026
Merged

KunalSiyag merged 2 commits into
mainfrom
droid/popin-budget

Conversation

@KunalSiyag

Copy link
Copy Markdown
Owner

Why

The threaded warm-up lane (Web export with Thread Support) fixed the street-level pop-in: on a day-skip probe the new build logged zero blocking model loads (idle street 59.9 fps, p95 19.3 ms, 0 frames >50 ms). But when the thread pool is unavailable — headless runs, or a web build without thread support — _warm_one silently falls back to a synchronous _scene() load on the main thread (65-100 ms per realistic GLB). This guard makes that fallback visible so a future regression (threads off, loader failure) shows up in the console instead of shipping silently.

What

  • city_view.gd: _report_sync_load() pushes a warning once per path when the warm-up falls back to a blocking load. Headless runs take the fallback by design and stay quiet.
  • tools/tests/fp_warm_guard_test.gd: 7/7.

Verified

  • Probe on threaded web export (iGPU Chrome headless=new): zero guard warnings, zero >50 ms frames at idle; the only hitch left is the day-end rebuild lane (tracked separately).
  • Pre-PR battery: gate quick + full, pytest, run_all, pre-commit — all green.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

When the threaded warm-up is unavailable (headless, or a web build
without thread support), _warm_one silently loads 2 MB GLBs on the main
thread — 65-100 ms for the realistic models, the street-level pop-in
spike. Push a warning once per path so the fallback is visible in the
console instead of shipping silently. Headless runs take the fallback by
design and stay quiet.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown

Automated review

No new findings on the 3 changed files (gdlint, complexity, TODO policy, dead code).

Run python3 tools/checks/run_all.py locally for the full set of checks.

The gate classifies a test run by its <NAME>: PASS token; the new test
only printed per-check lines, so CI read FAIL(no-token). Also gdformat.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@KunalSiyag
KunalSiyag merged commit b72668b into main Oct 28, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant