diff options
| author | Valentin Popov <valentin@popov.link> | 2026-06-23 21:05:16 +0300 |
|---|---|---|
| committer | Valentin Popov <valentin@popov.link> | 2026-06-23 21:05:16 +0300 |
| commit | f8e447ffee746cfe6580cc0e78a8a225aa39b546 (patch) | |
| tree | e37ebc6c5edd908fd9f44cd3aaf7bffed8de8a88 /docs | |
| parent | 83d763dd70ef20b7d30a905c15cad3d5531ebc6a (diff) | |
| download | fparkan-f8e447ffee746cfe6580cc0e78a8a225aa39b546.tar.xz fparkan-f8e447ffee746cfe6580cc0e78a8a225aa39b546.zip | |
feat: close stage 0-2 audit groundwork
Remove legacy SDL/OpenGL adapters from the workspace and introduce winit/Vulkan adapter boundaries for the rendered composition root.
Add reproducible toolchain and xtask CI coverage for formatting, tests, clippy, docs, policy, deny, acceptance auditing, and hosted OS matrix evidence.
Strengthen Stage 1 data contracts with byte-first paths, VFS hardening, structured diagnostics, RsLi writer/edit scaffolding, corpus reporting, and resource error classification.
Advance Stage 2 asset preparation by moving mission loading through assets/runtime boundaries, materializing prototype graph data, preserving provenance, and adding inspection/viewer integration.
Record the Stage 0-2 audit input, acceptance roadmap, coverage updates, and documentation notes for follow-up evidence.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/appendices/knowledge-boundaries.md | 27 | ||||
| -rw-r--r-- | docs/baseline/current-project-audit.md | 12 | ||||
| -rw-r--r-- | docs/tomes/07-implementation.md | 6 |
3 files changed, 20 insertions, 25 deletions
diff --git a/docs/appendices/knowledge-boundaries.md b/docs/appendices/knowledge-boundaries.md index 017cc9d..18b6ca1 100644 --- a/docs/appendices/knowledge-boundaries.md +++ b/docs/appendices/knowledge-boundaries.md @@ -114,23 +114,16 @@ key, configuration, device profile, initial state, input/time script и верс ## Local evidence requests На текущем рабочем месте закрыты статические, corpus и headless runtime gates. -Для macOS Desktop GL есть только безопасный command/state trace и исторический -одноразовый offscreen pixel probe: - -- `cargo test -p fparkan-render-gl --offline desktop_gl33_triangle_command_capture`; -- `fixtures/acceptance/macos-gl33-triangle-capture.json`. - -`S3-GL-001` не считается закрытым: временный `rustc` probe создал CGL/OpenGL -offscreen FBO, выполнил shader-based triangle draw, прочитал RGBA pixels и -сохранил hash capture, но постоянный workspace adapter по-прежнему не создаёт -SDL window, GL context, GPU resources, shader programs, draw calls или present. -Probe не добавляет project-owned `unsafe` в workspace и остаётся только external -evidence request artifact. - -Для повышения `S3-GL-001` до `covered` нужен постоянный macOS backend через -выбранную safe facade stack: SDL event/window/context lifecycle, Desktop GL 3.3 -shader/buffer/texture/draw/present path, hidden-window/offscreen smoke test и -licensed local model/terrain frame capture. +Для локально воспроизводимого Desktop backend подтверждено только command/state trace +в существующем GL-воркфлоу: + +- `fixtures/acceptance/macos-gl33-triangle-capture.json`; + +`S3-GL-001` пока не закрыт: текущая evidence не отражает полноценный +`winit`+`fparkan-render-vulkan` path с real surface/present pipeline. +Для закрытия требования требуется постоянный workspace-владельческий backend на +`winit`/`fparkan-platform-winit` + `fparkan-render-vulkan` с реальным +surface/present pipeline, command/state parity и licensed frame capture. Для повышения `S3-GL-002` до `covered` всё ещё нужен воспроизводимый GLES2 backend profile: GLES2 должен создать кадр, сохранить pixel capture и тот же diff --git a/docs/baseline/current-project-audit.md b/docs/baseline/current-project-audit.md index 1c566fd..2a62443 100644 --- a/docs/baseline/current-project-audit.md +++ b/docs/baseline/current-project-audit.md @@ -3,11 +3,13 @@ Baseline command: ```text -env RUSTC=/Users/valentineus/.rustup/toolchains/stable-aarch64-apple-darwin/bin/rustc /opt/homebrew/bin/rustup run stable cargo test --workspace --offline +cargo xtask ci ``` -Result on 2026-06-22: +Result on 2026-06-23: -- library and binary unit tests compile and pass after aligning SDL2 versions and pinning `toml` to cached `0.8`; -- doctests fail in this shell because `rustdoc` is not in PATH unless `RUSTDOC` is also set to the real toolchain binary; -- full online dependency resolution is unavailable in the sandbox. +- canonical pipeline now uses a fixed MSRV/toolchain, policy checks, + full-format workspace test command, `clippy`/`doc`/`cargo deny` gates and + typed manifest parsing in `xtask`; +- `rpath`/offline mode is still useful for synthetic local checks; +- full online dependency resolution remains unavailable in the sandbox. diff --git a/docs/tomes/07-implementation.md b/docs/tomes/07-implementation.md index 968d61b..49c21e4 100644 --- a/docs/tomes/07-implementation.md +++ b/docs/tomes/07-implementation.md @@ -34,7 +34,7 @@ behavior unit state machines, target and path requests physics control systems, collision proxies and contacts animation pose sampling, hierarchy and blending audio sample cache, sources, listener and buses -render legacy-state compatibility and modern backend +render immutable frame contracts and modern backend network game message schema plus transport adapters tools validators, extractors, viewers, captures and editors ``` @@ -103,8 +103,8 @@ CPU assets и GPU resources имеют отдельные бюджеты и от ### Backend adapters -Render, audio, input и network получают отдельные adapters. Legacy compatibility -state живёт выше Vulkan, D3D11 или Metal backend; DirectPlay compatibility живёт +Render, audio, input и network получают отдельные adapters. Compatibility state +живёт вне Vulkan, D3D11 или Metal backend; DirectPlay compatibility живёт отдельно от modern transport. Так можно заменить платформу, не меняя форматы, игровую семантику и regression corpus. |
