Repository navigation
feat(engine,docs): Milestone 2 Phase 5 (60 Hz f64 free camera & 3D scene) & Phase 6 Gate G3 preparation - #14
Merged
Merged
Conversation
…te G3 verification
… Windows/color hygiene, and honest Gate G3 status
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Implements Milestone 2 Phase 5 (
spawn-engine60 Hzf64free-fly camera,alphapresentation interpolation, deterministicProceduralScene, explicitRenderSurface/RuntimeBackendcontracts, and verification testsF3D-T05,F3D-T10,F3D-T13) and Phase 6 documentation synchronization (keeping Gate G3 explicitly open asIN PROGRESS — PENDING OWNER VERIFICATION & SIGN-OFF).Requirements & Invariants Covered
F3D-FR-03, 09, 10, 11, 12,F3D-NFR-01..07F3D-INV-01..16,SPN-INV-001..006, 009, 011, 023, 030, 034, 040..044, 050..054, 083, 084, 090..092, 100, 101src/camera.rs:FreeCamera,FreeCameraConfig,FreeCameraPose,CameraTickInput,CameraPresentation,CameraInputBindings,interpolation_alphastepped onFixedStepClock60 Hz ticks viaspawn_math::detwith±(π/2 - ε)pitch clamp, shortest-arcslerp, andf64camera-relativef32extraction.src/scene.rs: deterministicProceduralScene(unit_cube,unit_octahedron,ground_gridat-2 m,-5 m,-25 m,-200 m).src/runtime.rs,src/native.rs,src/options.rs,src/error.rs:ENGN-0008..0010, strict reverse-order teardown, and required explicit implementations on allRenderSurfaceandRuntimeBackendmethods (no silent mock default fallbacks, verified withcompile_faildoctests).tests/f3d_t05_free_camera.rs,tests/f3d_t10_scene_session.rs,tests/f3d_t13_engine_hygiene.rs,tests/foundation_verification.rs: Windows/Linux portable path &CARGO_TERM_COLOR=alwayshygiene, handle validation, and doc sync assertions.crates/spawn-render/tests/shader_validation.rs: addedf3d_t07_deterministic_fuzz_corpus_and_mutator_10k_iterations(10,000 iterations).docs/first-3d/*,docs/README.md,AGENTS.md: Phases 0–5 markedEXISTS; Phase 6 / Gate G3 explicitly markedIN PROGRESS — PENDING OWNER VERIFICATION & SIGN-OFFwith a 7-step interactive owner verification protocol indocs/first-3d/VERIFICATION.md.Verification Run
CARGO_TERM_COLOR=always ./scripts/check.sh: passed (exit0—fmt,clippy --workspace --all-targets -D warnings,cargo test --workspace,cargo doc -D warnings,wayland/vulkanfeature checks,cargo deny check).PATH="$HOME/.local/bin:$PATH" cargo run -p spawn-cli -- shaders build && PATH="$HOME/.local/bin:$PATH" VK_INSTANCE_LAYERS=VK_LAYER_KHRONOS_validation VK_KHRONOS_VALIDATION_VALIDATE_SYNC=true cargo test -p spawn-render --features vulkan -- --ignored: 9/9 GPU tests passed (0validation/sync errors on AMD Radeon RX 460 / RADV).crates/spawn-render/fuzz(decode_cooked_shader): compiled and ran50,000seededlibFuzzeriterations (0crashes, without ASan/SanitizerCoverage due to absentrustupnightly/cargo-fuzz).Platforms Tested & Known Limitations
slangc 2026.22; plus GitHub Actions Linux & Windows CI.docs/first-3d/VERIFICATION.md#owner-interactive-verification-protocol-pending-execution-for-gate-g3).cargo fuzz run decode_cooked_shaderexecution (or explicit owner sign-off accepting stable corpus/property + uninstrumentedlibFuzzercoverage).PLAT-0001/REND-0002), Windows (ENGN-0002), compositors other than Hyprland, GPUs other than RX 460, DPI scale > 1, physical device loss.