Known Issues
Platform
- Linux-first. Unit tests run anywhere, but live engine integration, the FSI MCP flow, and every container recipe target Linux. The Hub GUI has not been tested on Windows or macOS.
- SkiaSharp GPU backend segfaults in the dev-container environment.
FSBar.Vizuses a rasterSKSurface+ GL texture upload instead — seesrc/FSBar.Viz/Viewer.fs. - Graphical engine runs windowed only.
EngineLauncherforcesFullscreen=0in per-sessionspringsettings.cfg.
Hub
- Pause state can drift if the user types
/pausein BAR's native UI — the Hub'sIsPausedflag won't reconcile. Click the Viewer-tab pause button twice to recover. (Tracked in feature 038 notes.) - Admin channel requires a fresh launch. The UDP autohost socket binds at
SessionManager.Launch, not at Hub startup. Controls render dimmed and show an inline reason wheneverSessionManager.AdminStatus <> Some Attached. - Headless renderer is raster-only (same GPU caveat as above). Suitable for preview and streaming, but not high-FPS.
Trainer / tests
- *
GrpcLogStreamtests are order-sensitive.*TruncatedContentcan corrupt server-side buffer state; runLogStreamTestsindividually rather than as a suite. - Live tests need a real BAR install.
./tests/check-prerequisites.shdiagnoses missing pieces. Missing engines cause the whole live suite to skip, not fail. - Map-cache
codeVersionmismatch is a hard abort in the trainer warmup — by design. Regenerate viabots/trainer/map-cache/refresh-all.shafter bumping the version.
FSI REPL
- DLL references are locked once loaded. After a rebuild, restart FSI (
restart_fsiMCP tool) or the MCP server. - Native libraries must be
dlopen'd before first SkiaSharp/GLFW use — see the preamble inscripts/examples/Repl.fsx.
Proto regeneration
- No prebuilt
protoc-gen-fsgrpc. Generated files are committed, sodotnet buildworks out of the box. Regeneration requires installing the patched plugin via the helper in the siblingfsGRPCSkillsrepo.
Scope gaps
- No Windows or macOS CI matrix.
- Hub settings schema bumps are one-way (additive fields only); downgrading to an older Hub after a schema bump is not supported.
buf breakingis run manually rather than on every push — wire contract parity relies on reviewer discipline.
FSBarV1_Archived