Skip to content

feat(engine,docs): Milestone 2 Phase 5 (60 Hz f64 free camera & 3D scene) & Phase 6 Gate G3 preparation - #14

Merged
brasga-a merged 2 commits into
masterfrom
feat/m2-p5-engine-camera
Nov 18, 2026
Merged

brasga-a merged 2 commits into
masterfrom
feat/m2-p5-engine-camera

Conversation

@brasga-a

Copy link
Copy Markdown
Owner

Summary

Implements Milestone 2 Phase 5 (spawn-engine 60 Hz f64 free-fly camera, alpha presentation interpolation, deterministic ProceduralScene, explicit RenderSurface/RuntimeBackend contracts, and verification tests F3D-T05, F3D-T10, F3D-T13) and Phase 6 documentation synchronization (keeping Gate G3 explicitly open as IN PROGRESS — PENDING OWNER VERIFICATION & SIGN-OFF).

Requirements & Invariants Covered

  • Requirements: F3D-FR-03, 09, 10, 11, 12, F3D-NFR-01..07
  • Invariants: F3D-INV-01..16, SPN-INV-001..006, 009, 011, 023, 030, 034, 040..044, 050..054, 083, 084, 090..092, 100, 101
  • Highlights:
    • src/camera.rs: FreeCamera, FreeCameraConfig, FreeCameraPose, CameraTickInput, CameraPresentation, CameraInputBindings, interpolation_alpha stepped on FixedStepClock 60 Hz ticks via spawn_math::det with ±(π/2 - ε) pitch clamp, shortest-arc slerp, and f64 camera-relative f32 extraction.
    • src/scene.rs: deterministic ProceduralScene (unit_cube, unit_octahedron, ground_grid at -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 all RenderSurface and RuntimeBackend methods (no silent mock default fallbacks, verified with compile_fail doctests).
    • 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=always hygiene, handle validation, and doc sync assertions.
    • crates/spawn-render/tests/shader_validation.rs: added f3d_t07_deterministic_fuzz_corpus_and_mutator_10k_iterations (10,000 iterations).
    • docs/first-3d/*, docs/README.md, AGENTS.md: Phases 0–5 marked EXISTS; Phase 6 / Gate G3 explicitly marked IN PROGRESS — PENDING OWNER VERIFICATION & SIGN-OFF with a 7-step interactive owner verification protocol in docs/first-3d/VERIFICATION.md.

Verification Run

  • CARGO_TERM_COLOR=always ./scripts/check.sh: passed (exit 0 — fmt, clippy --workspace --all-targets -D warnings, cargo test --workspace, cargo doc -D warnings, wayland/vulkan feature 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 (0 validation/sync errors on AMD Radeon RX 460 / RADV).
  • crates/spawn-render/fuzz (decode_cooked_shader): compiled and ran 50,000 seeded libFuzzer iterations (0 crashes, without ASan/SanitizerCoverage due to absent rustup nightly/cargo-fuzz).

Platforms Tested & Known Limitations

  • Tested: Omarchy (Arch Linux), Hyprland 0.56.2 (Wayland native), AMD Ryzen 5 1600, AMD Radeon RX 460 (RADV Polaris, Mesa 26.2.5, Vulkan 1.4.354 / loader 1.4.363), Khronos validation + sync validation, slangc 2026.22; plus GitHub Actions Linux & Windows CI.
  • Open for Owner Sign-Off (Gate G3 NOT closed):
    1. Live human interactive 3D navigation & resize verification (docs/first-3d/VERIFICATION.md#owner-interactive-verification-protocol-pending-execution-for-gate-g3).
    2. Nightly coverage-guided ASan cargo fuzz run decode_cooked_shader execution (or explicit owner sign-off accepting stable corpus/property + uninstrumented libFuzzer coverage).
  • Untested / Planned: X11 (PLAT-0001/REND-0002), Windows (ENGN-0002), compositors other than Hyprland, GPUs other than RX 460, DPI scale > 1, physical device loss.

@brasga-a
brasga-a changed the base branch from feat/m2-p4-render-mesh to master November 18, 2026 19:40
@brasga-a
brasga-a merged commit e48cace into master Nov 18, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant