gods-eye-view/docs/KNOWN-ISSUES.md

KNOWN ISSUES

Updated: July 8, 2026

This file tracks active runtime issues only.

For the roadmap and open backlog, see the repository issue tracker.

---

Open

Street traffic can be slow/uneven when panning across dense city blocks

Status: Open (partially mitigated)

Context:

• Current traffic loader fetches one clamped viewport tile at a time (major pass, then full pass).
• In dense cores, some visible roads can appear late after city jumps or fast pans.
• Zooming into adjacent streets does not always immediately trigger higher-detail coverage for all visible roads.

Current mitigation in runtime:

• Fair per-road dot budget allocation (reduces hard starvation under global MAX_DOTS cap).
• Center-shift threshold (reduces stale overlap lock while panning).

Next iteration candidates:

• Prioritize currently visible road segments inside the active viewport before off-center segments.
• Add neighbor prefetch ring for nearby tiles after jump-to-city actions.
• Add adaptive dot cap by frame time (coverage first, density second).
• Promote sync chip from loading indicator to true multi-phase progress.

---

CCTV panel can appear "missing" after layout refactors

Status: Open (workaround available)

Context:

• Panel positions are persisted in local storage and can restore off-screen after UI changes.

Workaround:

• In browser console:
  • localStorage.removeItem('godsEyeView.v6.panelPos.cctv-panel');
  • localStorage.removeItem('godsEyeView.v6.panelCollapsed.cctv-panel');
  • location.reload();

Related keys (current versions):

• Panel positions: godsEyeView.v7.panelPos.<panel-id> (re-versioned 2026-06-10)
• Panel collapsed state: godsEyeView.v6.panelCollapsed.<panel-id>
• CCTV calibration: godsEyeView.cctv.calibration.v2

---

Height-datum residuals (branch feat/height-datum, pending merge)

Status: Open (owner-accepted 2026-07-08, documented)

• Cold-start floor latency: at a freshly-visited airport, grounded/low aircraft float low for ~1–2 poll cycles (30–60 s) and rise as terrain floors resolve; a few stragglers take one more poll.
• Born-grounded first poll: a contact first seen on the ground with no altitude data renders at the geoid for ≤1 poll until its floor cell warms.
• Full context, improvement ideas, and the verification oracle (scripts/qa-floor-verify.mjs): docs/superpowers/reports/2026-07-08-height-datum-handover.md.

---

Closed / Intentional (for clarity)

Proxy SSRF and error-surface hardening gaps

Status: Closed as fixed on main

Context:

• Proxy middleware previously allowed broader error/internal surface area and looser upstream handling.
• Current main includes hardened proxy behavior in vite.config.js:
  • CCTV upstream URL no longer accepted from client query params.
  • Error payloads are sanitized.
  • OpenSky cache stores successful responses only.
  • OpenSky token refresh is coalesced.
  • GBFS/CCTV memory growth is bounded.

Validation target:

• vite.config.js

---

NVG vignette edge color bleed

Status: Closed as fixed in current shader composite

Context:

• Earlier builds leaked original scene colors near the NVG tube edge.
• Current composite now masks NVG output with tube falloff before final blend, removing the color edge bleed.

Validation target:

• src/styles/surveillance.js

---

Wildfires layer unavailable / static bundled snapshot

Status: Closed — live FIRMS integration shipped (2026-07-16)

Context:

• Wildfires (NASA FIRMS) were removed from runtime in v0.5.3, returned June 2026 as a bundled-snapshot layer (local-firms, 2026-05-25 data, ~58 MB in-repo), and were converted to live NASA FIRMS data on 2026-07-16: the /api/firms proxy merges three VIIRS NRT sources (trailing 24 h, 30 min cache, serve-stale-on-failure) and the bundled snapshot was deleted. Requires a free server-side FIRMS_MAP_KEY; without it the layer shows a KEY REQUIRED state.
• Weather radar is still held out of OSS v1 after QA found the previous overlay did not provide reliable visible value.