From f69c893a401730339ad72610c573e20282573045 Mon Sep 17 00:00:00 2001 From: Valentin Popov Date: Mon, 22 Jun 2026 16:12:57 +0400 Subject: fix: harden path lookup and mark gl backend gap --- adr/ADR-0007-safe-sdl-opengl.md | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) (limited to 'adr/ADR-0007-safe-sdl-opengl.md') diff --git a/adr/ADR-0007-safe-sdl-opengl.md b/adr/ADR-0007-safe-sdl-opengl.md index f82c424..01e35e4 100644 --- a/adr/ADR-0007-safe-sdl-opengl.md +++ b/adr/ADR-0007-safe-sdl-opengl.md @@ -2,4 +2,25 @@ Status: provisional -Workspace-owned code forbids `unsafe`. SDL/OpenGL adapters must use maintained external crates behind a safe project API. The current repository still contains legacy demo code scheduled for replacement; new adapter crates are placeholders until a fully audited safe facade is selected and proven on all target profiles. +Workspace-owned code forbids `unsafe`. SDL/OpenGL adapters must use maintained +external crates behind a safe project API; local Objective-C/CGL/SDL/OpenGL FFI +inside FParkan is not an acceptable implementation strategy. + +The current adapter crates are safe boundary stubs. They compile the intended +ports and deterministic command contracts, but they do not create SDL windows, +GL contexts, GPU resources, shaders, draw calls, swapchains, or presents. They +must not be treated as backend readiness evidence. + +To close the macOS backend requirement, choose and vendor/lock a maintained +safe facade stack, then implement: + +- SDL event source, window creation, GL context lifecycle, drawable size and + present; +- GL shader compile/link, buffer/texture upload, render state, draw calls and + diagnostics; +- game/viewer composition roots using those adapters; +- hidden-window/offscreen macOS smoke tests and licensed local model/terrain + frame captures. + +Until those are implemented, Desktop GL evidence may document external probes +only; it does not satisfy the permanent adapter requirement. -- cgit v1.2.3