Publish Chimera GFX source

2026-09-03 03:27:14 +02:00
commit a6037502d7
828 changed files with 100454 additions and 0 deletions
@@ -0,0 +1,24 @@
+# ADR-0005: Versioned resource lifecycle and host present model
+
+- Status: accepted
+- Date: 2026-07-17
+
+## Decision
+
+API version 2 includes opaque contexts, surfaces, and textures, plus sized
+descriptors for texture upload and present. Context destruction returns
+`RESOURCE_BUSY` while child handles exist. The version-1 `chimera_gfx_destroy`
+symbol remains as a void compatibility wrapper for childless contexts. The
+mock backend implements the complete ownership model in host memory and records
+deterministic present serials and content hashes.
+
+The mock present is a state transition, not a graphical operation. It creates
+no window, accesses no display, and advertises both `NON_RENDERING` and
+`HOST_TEST_ONLY`. The PS5 backend is a separate compiled unit that refuses
+context creation with `SAFETY_POLICY`.
+
+## Consequences
+
+Adapter work can compile and test lifecycle assumptions before a hardware ABI
+exists. Future backends must preserve validation and cleanup semantics, but
+must not inherit mock capabilities without evidence.