WIP: fix(macos): the Mac halves of indirect quads and mesh count draws #851

Draft

mooki wants to merge 82 commits from mooki/Longshot:mac/topic-draw-path-quads-mesh into main

pull from: mooki/Longshot:mac/topic-draw-path-quads-mesh

merge into: MagicBeanDev:main

MagicBeanDev:main

Conversation 1 Commits 82 Files changed 342 +62423 -1109

mooki commented 2026-11-15 17:40:13 +00:00

Member

• Copy link
• Copy Markdown

Type: fix · Risk: medium · Tested on: macOS 26.7.1, Apple M4 Max (arm64; x86_64 under Rosetta) · Needs: Windows and Linux, any GPU

Why

Two every-platform fixes draw what LS left out: indirect quad draws (#705) and the mesh fallback's count draws (#707). On a Mac
each needs one more step, because there the first vertex of a triangle provokes (MoltenVK 1.4.2 offers the last vertex only with
Metal's private API), and draw-path (the PR before this one) draws the Mac's triangles with their last vertex first. Without this
PR a quad's two triangles both take their flat values from the quad's first corner on the Mac, where every other device takes the
third and fourth; and the mesh fallback's rotation list, made for single draws in its first records area, would be read from the
wrong place by a count draw and fall short of a grown area. This PR rotates each quad triangle on Apple so the same corners provoke
as everywhere else, and makes the fallback's rotation follow the count draws and the growing area. It needs #705 and #707, separate
every-platform PRs, which it carries at its base. It is part of the macOS port. See #420.

How to reproduce

Seen on: macOS 26.7.1, Apple M4 Max, MoltenVK 1.4.2
Settings and switches: defaults
Steps: the members' standalone MoltenVK probes: QD-01's prov_unrotated step (quads coloured flat by the provoking vertex's id; reports/2026-11-14-indirect-quads.md §6) and MP-01's RAW arms (the mesh fallback's single and count draws of a program with a flat input, areas grown past the first; reports/2026-11-14-mesh-provoking.md §4)
Expected: the quad halves show corners 2 and 3, as on every other device; every fallback pixel takes its triangle's last corner (NVN's vertex), as a rotated single draw in the first area does
Actual: both quad halves show corner 0; the fallback's count draws and grown areas take the first corner

What changed

On Apple, where the device provokes the first vertex, each quad triangle's corners are rotated with its winding and edges kept,
for direct quads and #705's indirect ones; and the mesh fallback's rotation list covers the count draws' commands and the area as
it grows. Elsewhere nothing changes. Its base merges #705 and #707 (restacked on draw-path), with their hand resolutions. One
commit per original PR, in order:

• fix(macos): quads provoke the same corners where the first vertex provokes (gpu/vk/quad_draws.h kFirstVertex and
  rotated(), quad_rotated() in vk_draw.cpp, the quad report's triangles field). Was:
  #706
• fix(macos): the mesh fallback's rotation follows the count draws and the growing records area (gpu/vk/provoking.h
fallback_corners, FallbackRotation and provoking_fallback in vk_draw.cpp). Was:
  #708
• Merges of the base's updates (draw-path's test fix c2cfee0f and brace 67fd90bc, shader-backend's 70cc5ba1, #705's
  a27f8f47: the indirect quads' count with the provoking-vertex and fan censuses, its checks to draw-path's shape, and #707's
  19d6d2d4: test_drawid_direct pins #707's DrawIndex condition); one conflict, in test_provoking_first's comment, resolved to
  the base's six sites.
• fix(macos): log_frame_stats' MeshCountDraws report block closed again (d99221c4): the base merge of #707 had dropped the
  block's closing brace in vk_replay.cpp, which stopped compiling from there; #707's restack and Integration 41 have it.

Measurements

Verdict: both fixed where measured: in QD-01 the rotated quads took corners 2 and 3 on LS's indirect path and the direct path
alike (unrotated: 0 and 0), and in MP-01 every step's image equalled the reference byte for byte, the cut steps cutting exactly the
predicted corners, with no per-draw cost at that size.

Baseline: main does not start on macOS. Each probe compares, in one standalone MoltenVK 1.4.2 process, what the PRs this one
needs draw without it (#705's unrotated quads, #707's and draw-path's unrotated fallback draws) with this PR's code at the
member's head (fc8dd951 for #706, 3f872b0c for #708).

Hardware: macOS 26.7.1, Apple M4 Max (40-core GPU), MoltenVK 1.4.2, 16-core CPU, 64 GB
Scene: QD-01's prov_rotated and prov_unrotated steps; MP-01's 22 steps (task + mesh and mesh-only, counts 0, 1, 16 and past, 1 and 3 commands a call, grown areas, the allowance cutting, single draws)
Method: QD-01 reports/IndirectQuads-files/qd01/runs-qd01-arm64/result.json (271fb491…); MP-01 reports/MeshProvoking-files/mp01/runs-mp01-arm64/result.json (3d518854…); each released once on arm64
How to reproduce: QD-01's run command (reports/2026-11-14-indirect-quads.md §6); MP-01's (reports/2026-11-14-mesh-provoking.md §4)

	Before: main @ aa95d35f (with #705 and #707: unrotated; main does not start on macOS)	After: this PR @ 90ab8ea1 (each member's code, measured at its head)
quad provoking corners, LS's indirect path / the direct path (#706, QD-01)	0,0 / 2,3 (images unequal)	2,3 / 2,3
mesh fallback images against the reference (#708, MP-01)	differ wherever drawn (equal only at count 0)	equal byte for byte, every step
lit cells, task + mesh (#708, MP-01)	(as drawn unrotated)	0/1/49/97/97/97, cut 56, single 80 (= the reference)
corners not fitting, cut steps (#708, MP-01)	not counted	task + mesh 246, mesh-only 330, as predicted; 0 elsewhere

QD-01 result.json: all_as_predicted 1 (41 of 41); VK_EXT_provoking_vertex=0 on MoltenVK 1.4.2
MP-01 result.json: complete 1, all_as_predicted 1, fix_exact_on_moltenvk 1 (22 of 22)

Start #32 (I38, with #708 at 3f872b0c, before its area fix): 53,047 rotated fallback draws logged as cut (69 error lines, each
10-16 words off the 16,777,216-word area) while the census of corners past the area stayed 0: false cuts, 0 corners lost; #708's
head stops counting and logging them, and what is drawn is unchanged.

Flags and settings

None: no switch. On Apple, on a device without the last provoking vertex, only.

Testing

Tested: on macOS 26.7.1, Apple M4 Max, game-free, at this PR's head 90ab8ea1:

• The members' own tests and #705's and #707's (theirs, run here too since #706 and #708 build on them), at 90ab8ea1: 19 test files, 35 runs, all exit 0. 16 ran on arm64 and on x86_64 under Rosetta separately; test_mesh_census, test_mesh_fallback and the crash-record source contract once (no x86_64 form). #705's: test_quad_draws (#706's too), test_draw_binds, test_seg_gathers; #707's: test_mesh_area, test_mesh_census, test_count_draws, test_mesh_count_fallback, test_mesh_drawid, test_mesh_fallback, test_seg_xfer (area, count fallback and xfer #708's too); #708's: test_mesh_provoking, test_provoking_first, test_fan_key, the crash-record contract; and the base's test_index8_bind, test_fan_indirect, test_drawid_direct, test_vendor_fixes, test_subgroup_vertex.
• The whole game-free suite (python -I -B tests/run_all.py --jobs 6) on this Mac against main's (543 passed, 33 failed, 17 skipped): 617 passed, 15 failed, 17 skipped; no check that passes on main fails here. Against the draw-path topic's suite (611, 15, 17) the only differences are six new tests passing: test_quad_draws (#705), test_mesh_area, test_mesh_census, test_mesh_count_fallback, test_mesh_drawid (#707) and test_mesh_provoking (#708). The 15 failures are main's own on this Mac, the same 15 as draw-path's.
• The renderer's link check (every mkwvk:: name one gpu/vk file declares and another defines; each defining file compiled with the tree's own flags, arm64 and x86_64, and every symbol an object leaves undefined defined by one of them): 0 of 639 declared names without a definition, 66 of 66 objects compiled, 1,254 name/arch checks with 0 failures, and on each arch 583 cross-file symbols all defined. vk_draw.cpp and vk_replay.cpp also compiled whole with nx2/build.py's own macOS commands: 4 of 4 exit 0.
• What Windows and Linux compile (unifdef -U__APPLE__ of every changed C/C++ file against the base): quad_draws.h (kFirstVertex and rotated(apple, provokes_last), false off Apple), provoking.h (fallback_corners), vk_draw.cpp (quad_rotated() returns false off Apple; FallbackRotation and provoking_fallback reached only where provoking_first() holds, never off Apple; the fallback's header carries the area's own words as #707's does) and vk_replay.cpp (the one closing brace that makes it compile again). What Windows and Linux see run differently: the quad report line ends with its triangles' corners ({0,1,2, 0,2,3} there), a log field.
• In the game, integration builds that hold this topic's members and the two it needs (earlier revisions of some): E9a on I41 78ec1c47 (arm64, MoltenVK main + argbuf-slots): 1,197 s held in play, 12 of 12 must-shows, a clean end, 0 skipped draws; run #34 on I38 3f872b0c (x86_64 under Rosetta): 16 m 52 s, every draw drawn, 19 of 19 checks, a clean exit.

Not tested: Windows and Linux (no PC here): off Apple both members leave what is drawn as #705 and #707 draw it, but nobody
has built or started this stack there.

Must be tested:

• Windows and Linux, a GPU on the compute fallback if one is at hand (any GPU otherwise): build this PR (head 90ab8ea1) and main (aa95d35f) the same way and run python -I -B tests/run_all.py on each, then start each to the title, expecting this PR's tests to pass, no other check to change status against main, and the vk: lines in longshot_log.txt as main's except #705's and #707's new quad and mesh lines (the quad line ending in triangles {0,1,2, 0,2,3}), with no vk: provoking vertex line (Test Farm: @Beanstalk windows and linux: build unchanged, run_all, start to the title)

Risks

What could break: on Apple only: the order of each quad triangle's corners (edges, winding and split unchanged); the mesh
fallback's rotated count draws take one fill each, and a CPU-filled rotation list grows with the area (4 bytes a corner; a 128 MB
area at 31 words is a 16 MB list), made once a growth and kept; where the allowance holds the list back, the corners past it are
cut (logged and counted), not drawn unrotated. Elsewhere: the quad report's new field only.

Turning it off: revert the PR (no switch).

Compatibility: Nothing changes: no save, options key, cache or vk ABI change.

Issues

See #420. The macOS topic PRs, merged in this order; "topic N" in each description means these: 1 #845 (macos-host), 2 #846 (vulkan-on-metal, on 1), 3 #847 (mvk-descriptor-limits), 4 #848 (shader-backend, on 2, 3 and #431), 5 #849 (precompile-metal, on 4), 6 #850 (draw-path, on 4), 7 #851 (draw-path-quads-mesh, on 6, #705 and #707), 8 #852 (mac-perf, on 7).

Checklist

Everyone

• One topic.
• The title is a Conventional Commit (type(scope): description) of the status line's type.
• Why gives the reason plainly and links the issues that fit (the tracker searched).
• Measurements has a verdict, or one line saying why there is nothing to measure.
• Testing names what was tested, what wasn't, and what must still be tested, where and how.
• Rebased on current main.
• python -I -B tests/run_all.py passes (any failure that also fails on main is named).
• No game files, dumps, build output or generated files.
• third_party/ untouched (a new folder with a PROVENANCE.md instead).
• The license is OK: GPL-3.0-or-later, nothing incompatible and nothing decompiled.

When it applies

• AI assistance recorded with Assisted-by: / Co-Authored-By: trailers.
• A game-free test added for the fix, failing on main and passing here.
• A check under tests/ that reads changed source updated in this PR, not weakened.
• Host code builds on both Windows (llvm-mingw) and Linux, with UTF-8 paths.

**Type:** fix · **Risk:** medium · **Tested on:** macOS 26.7.1, Apple M4 Max (arm64; x86_64 under Rosetta) · **Needs:** Windows and Linux, any GPU ## Why Two every-platform fixes draw what LS left out: indirect quad draws (#705) and the mesh fallback's count draws (#707). On a Mac each needs one more step, because there the first vertex of a triangle provokes (MoltenVK 1.4.2 offers the last vertex only with Metal's private API), and draw-path (the PR before this one) draws the Mac's triangles with their last vertex first. Without this PR a quad's two triangles both take their flat values from the quad's first corner on the Mac, where every other device takes the third and fourth; and the mesh fallback's rotation list, made for single draws in its first records area, would be read from the wrong place by a count draw and fall short of a grown area. This PR rotates each quad triangle on Apple so the same corners provoke as everywhere else, and makes the fallback's rotation follow the count draws and the growing area. It needs #705 and #707, separate every-platform PRs, which it carries at its base. It is part of the macOS port. See #420. ## How to reproduce **Seen on:** macOS 26.7.1, Apple M4 Max, MoltenVK 1.4.2 **Settings and switches:** defaults **Steps:** the members' standalone MoltenVK probes: QD-01's `prov_unrotated` step (quads coloured flat by the provoking vertex's id; `reports/2026-11-14-indirect-quads.md` §6) and MP-01's `RAW` arms (the mesh fallback's single and count draws of a program with a flat input, areas grown past the first; `reports/2026-11-14-mesh-provoking.md` §4) **Expected:** the quad halves show corners 2 and 3, as on every other device; every fallback pixel takes its triangle's last corner (NVN's vertex), as a rotated single draw in the first area does **Actual:** both quad halves show corner 0; the fallback's count draws and grown areas take the first corner ## What changed On Apple, where the device provokes the first vertex, each quad triangle's corners are rotated with its winding and edges kept, for direct quads and #705's indirect ones; and the mesh fallback's rotation list covers the count draws' commands and the area as it grows. Elsewhere nothing changes. Its base merges #705 and #707 (restacked on draw-path), with their hand resolutions. One commit per original PR, in order: - `fix(macos)`: quads provoke the same corners where the first vertex provokes (`gpu/vk/quad_draws.h` `kFirstVertex` and `rotated()`, `quad_rotated()` in `vk_draw.cpp`, the quad report's triangles field). Was: [#706](https://git.magicbean.dev/MagicBeanDev/Longshot/pulls/706) - `fix(macos)`: the mesh fallback's rotation follows the count draws and the growing records area (`gpu/vk/provoking.h` `fallback_corners`, `FallbackRotation` and `provoking_fallback` in `vk_draw.cpp`). Was: [#708](https://git.magicbean.dev/MagicBeanDev/Longshot/pulls/708) - Merges of the base's updates (draw-path's test fix `c2cfee0f` and brace `67fd90bc`, shader-backend's `70cc5ba1`, #705's `a27f8f47`: the indirect quads' count with the provoking-vertex and fan censuses, its checks to draw-path's shape, and #707's `19d6d2d4`: test_drawid_direct pins #707's DrawIndex condition); one conflict, in `test_provoking_first`'s comment, resolved to the base's six sites. - `fix(macos)`: log_frame_stats' MeshCountDraws report block closed again (`d99221c4`): the base merge of #707 had dropped the block's closing brace in `vk_replay.cpp`, which stopped compiling from there; #707's restack and Integration 41 have it. ## Measurements **Verdict:** both fixed where measured: in QD-01 the rotated quads took corners 2 and 3 on LS's indirect path and the direct path alike (unrotated: 0 and 0), and in MP-01 every step's image equalled the reference byte for byte, the cut steps cutting exactly the predicted corners, with no per-draw cost at that size. Baseline: main does not start on macOS. Each probe compares, in one standalone MoltenVK 1.4.2 process, what the PRs this one needs draw without it (#705's unrotated quads, #707's and draw-path's unrotated fallback draws) with this PR's code at the member's head (`fc8dd951` for #706, `3f872b0c` for #708). Hardware: macOS 26.7.1, Apple M4 Max (40-core GPU), MoltenVK 1.4.2, 16-core CPU, 64 GB Scene: QD-01's `prov_rotated` and `prov_unrotated` steps; MP-01's 22 steps (task + mesh and mesh-only, counts 0, 1, 16 and past, 1 and 3 commands a call, grown areas, the allowance cutting, single draws) Method: QD-01 `reports/IndirectQuads-files/qd01/runs-qd01-arm64/result.json` (`271fb491…`); MP-01 `reports/MeshProvoking-files/mp01/runs-mp01-arm64/result.json` (`3d518854…`); each released once on arm64 How to reproduce: QD-01's `run` command (`reports/2026-11-14-indirect-quads.md` §6); MP-01's (`reports/2026-11-14-mesh-provoking.md` §4) | | Before: main @ aa95d35f (with #705 and #707: unrotated; main does not start on macOS) | After: this PR @ 90ab8ea1 (each member's code, measured at its head) | |---|---|---| | quad provoking corners, LS's indirect path / the direct path (#706, QD-01) | 0,0 / 2,3 (images unequal) | 2,3 / 2,3 | | mesh fallback images against the reference (#708, MP-01) | differ wherever drawn (equal only at count 0) | equal byte for byte, every step | | lit cells, task + mesh (#708, MP-01) | (as drawn unrotated) | 0/1/49/97/97/97, cut 56, single 80 (= the reference) | | corners not fitting, cut steps (#708, MP-01) | not counted | task + mesh 246, mesh-only 330, as predicted; 0 elsewhere | ``` QD-01 result.json: all_as_predicted 1 (41 of 41); VK_EXT_provoking_vertex=0 on MoltenVK 1.4.2 MP-01 result.json: complete 1, all_as_predicted 1, fix_exact_on_moltenvk 1 (22 of 22) ``` Start #32 (I38, with #708 at `3f872b0c`, before its area fix): 53,047 rotated fallback draws logged as cut (69 error lines, each 10-16 words off the 16,777,216-word area) while the census of corners past the area stayed 0: false cuts, 0 corners lost; #708's head stops counting and logging them, and what is drawn is unchanged. ### Flags and settings None: no switch. On Apple, on a device without the last provoking vertex, only. ## Testing **Tested:** on macOS 26.7.1, Apple M4 Max, game-free, at this PR's head `90ab8ea1`: - The members' own tests and #705's and #707's (theirs, run here too since #706 and #708 build on them), at `90ab8ea1`: 19 test files, 35 runs, all exit 0. 16 ran on arm64 and on x86_64 under Rosetta separately; `test_mesh_census`, `test_mesh_fallback` and the crash-record source contract once (no x86_64 form). #705's: `test_quad_draws` (#706's too), `test_draw_binds`, `test_seg_gathers`; #707's: `test_mesh_area`, `test_mesh_census`, `test_count_draws`, `test_mesh_count_fallback`, `test_mesh_drawid`, `test_mesh_fallback`, `test_seg_xfer` (area, count fallback and xfer #708's too); #708's: `test_mesh_provoking`, `test_provoking_first`, `test_fan_key`, the crash-record contract; and the base's `test_index8_bind`, `test_fan_indirect`, `test_drawid_direct`, `test_vendor_fixes`, `test_subgroup_vertex`. - The whole game-free suite (`python -I -B tests/run_all.py --jobs 6`) on this Mac against main's (543 passed, 33 failed, 17 skipped): 617 passed, 15 failed, 17 skipped; no check that passes on main fails here. Against the draw-path topic's suite (611, 15, 17) the only differences are six new tests passing: `test_quad_draws` (#705), `test_mesh_area`, `test_mesh_census`, `test_mesh_count_fallback`, `test_mesh_drawid` (#707) and `test_mesh_provoking` (#708). The 15 failures are main's own on this Mac, the same 15 as draw-path's. - The renderer's link check (every `mkwvk::` name one `gpu/vk` file declares and another defines; each defining file compiled with the tree's own flags, arm64 and x86_64, and every symbol an object leaves undefined defined by one of them): 0 of 639 declared names without a definition, 66 of 66 objects compiled, 1,254 name/arch checks with 0 failures, and on each arch 583 cross-file symbols all defined. `vk_draw.cpp` and `vk_replay.cpp` also compiled whole with nx2/build.py's own macOS commands: 4 of 4 exit 0. - What Windows and Linux compile (`unifdef -U__APPLE__` of every changed C/C++ file against the base): `quad_draws.h` (`kFirstVertex` and `rotated(apple, provokes_last)`, false off Apple), `provoking.h` (`fallback_corners`), `vk_draw.cpp` (`quad_rotated()` returns false off Apple; `FallbackRotation` and `provoking_fallback` reached only where `provoking_first()` holds, never off Apple; the fallback's header carries the area's own words as #707's does) and `vk_replay.cpp` (the one closing brace that makes it compile again). What Windows and Linux see run differently: the quad report line ends with its triangles' corners (`{0,1,2, 0,2,3}` there), a log field. - In the game, integration builds that hold this topic's members and the two it needs (earlier revisions of some): **E9a on I41 `78ec1c47`** (arm64, MoltenVK main + argbuf-slots): 1,197 s held in play, 12 of 12 must-shows, a clean end, 0 skipped draws; **run #34 on I38 `3f872b0c`** (x86_64 under Rosetta): 16 m 52 s, every draw drawn, 19 of 19 checks, a clean exit. **Not tested:** Windows and Linux (no PC here): off Apple both members leave what is drawn as #705 and #707 draw it, but nobody has built or started this stack there. **Must be tested:** - Windows and Linux, a GPU on the compute fallback if one is at hand (any GPU otherwise): build this PR (head `90ab8ea1`) and main (`aa95d35f`) the same way and run `python -I -B tests/run_all.py` on each, then start each to the title, expecting this PR's tests to pass, no other check to change status against main, and the `vk:` lines in longshot_log.txt as main's except #705's and #707's new quad and mesh lines (the quad line ending in triangles `{0,1,2, 0,2,3}`), with no `vk: provoking vertex` line (Test Farm: @Beanstalk windows and linux: build unchanged, run_all, start to the title) ## Risks **What could break:** on Apple only: the order of each quad triangle's corners (edges, winding and split unchanged); the mesh fallback's rotated count draws take one fill each, and a CPU-filled rotation list grows with the area (4 bytes a corner; a 128 MB area at 31 words is a 16 MB list), made once a growth and kept; where the allowance holds the list back, the corners past it are cut (logged and counted), not drawn unrotated. Elsewhere: the quad report's new field only. **Turning it off:** revert the PR (no switch). **Compatibility:** Nothing changes: no save, options key, cache or vk ABI change. ## Issues See #420. The macOS topic PRs, merged in this order; "topic N" in each description means these: 1 #845 (macos-host), 2 #846 (vulkan-on-metal, on 1), 3 #847 (mvk-descriptor-limits), 4 #848 (shader-backend, on 2, 3 and #431), 5 #849 (precompile-metal, on 4), 6 #850 (draw-path, on 4), 7 #851 (draw-path-quads-mesh, on 6, #705 and #707), 8 #852 (mac-perf, on 7). ## Checklist ### Everyone - [x] One topic. - [x] The title is a Conventional Commit (`type(scope): description`) of the status line's type. - [x] Why gives the reason plainly and links the issues that fit (the tracker searched). - [x] Measurements has a verdict, or one line saying why there is nothing to measure. - [x] Testing names what was tested, what wasn't, and what must still be tested, where and how. - [x] Rebased on current `main`. - [ ] `python -I -B tests/run_all.py` passes (any failure that also fails on `main` is named). - [x] No game files, dumps, build output or generated files. - [x] `third_party/` untouched (a new folder with a `PROVENANCE.md` instead). - [x] The license is OK: GPL-3.0-or-later, nothing incompatible and nothing decompiled. ### When it applies - [x] AI assistance recorded with `Assisted-by:` / `Co-Authored-By:` trailers. - [x] A game-free test added for the fix, failing on `main` and passing here. - [x] A check under `tests/` that reads changed source updated in this PR, not weakened. - [ ] Host code builds on both Windows (llvm-mingw) and Linux, with UTF-8 paths.

mooki added 82 commits 2026-11-15 17:40:16 +00:00

fix(vk): scan the import table as far back as its largest live import ... e968b6d5c0

Every scan down vk_memory.cpp's import table by start (pool_lookup's
covering import and merge plan, bg_drain, prefetch_chunks,
import_in_background, memory_note_gpu_write and memory_guest_imported)
stopped once an import ended more than 1 GiB below its address, on the
belief that no import is larger than that. pool_lookup's own merge escape
leaves an import above 1 GiB over the smaller ones inside it ("left
overlapping"), and the device allows imports up to max_import_size: a scan
stopped at a small import inside a large one, missed the large one, and
the same bytes were imported again, two memories over the same bytes.

import_reach.h counts the live imports by span class; its bound is above
every live span, within twice the largest. imported_add and imported_take,
now the table's only ways in and out, keep the count. A scan stops only
where no import further down can reach its address, so it also stops
sooner than before when the imports are small. The covering-import checks
in pool_lookup and import_in_background look past the last import at or
below the range for the same reason.

Tests: test_import_reach.py runs the actual scans with a 4 GiB import over
a 16 MiB chunk, left by the merge escape (imports are recorded ranges: no
payload, no Vulkan, no game). Its lookup, query, note, drain, background
and prefetch cases fail on main 5e072fc8 and pass here, and a source check
keeps every change to the table in the two helpers. test_import_windows
runs pool_lookup with the helpers; test_mirror_gpu_only names the new
publication point.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

test(vk): the readback refresh fixture runs memory_note_gpu_write with the import table's helpers ... 497be2d480

test_parallel_rb_refresh cuts memory_note_gpu_write out of vk_memory.cpp,
whose scan now stops at the live imports' reach: the fixture includes
import_reach.h, cuts live_reach, imported_add and imported_take beside it,
and puts its pool in the table through imported_add. It failed to build
at 11e9ee44 ("use of undeclared identifier 'import_reach'").

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

test: teach the game-free runner about macOS ... e81d4af47a

Was: #454 (#454), branch mac/run-all at 264f826a7c (Sweep3, on main aa95d35f).

Its own commits, squashed:
- test: teach the game-free runner about macOS (45c54bc6f)
- test: skip main's new Windows-only guard check on macOS, and undo the SDK's vsnprintf macro in a fixture (264f826a7)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(runtime): compile host jumps and pause hints on macOS arm64 ... 441182e2c2

Was: #477 (#477), branch mac/arm64-host at 0f021f29c1 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(runtime): compile host jumps and pause hints on macOS arm64 (0f021f29c)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(runtime): preserve guest pages when discarding on macOS ... 10e52402b7

Was: #478 (#478), branch mac/guest-memory at dfb71ec850 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(runtime): preserve guest pages when discarding on macOS (b668404c8)
- fix(runtime): retain guest-page rounding in Darwin memory wrappers (e9c77d9f3)
- test(runtime): cut main's int hos_commit in the Darwin guest-memory test (7e737ce0f)
- test(runtime): follow main's HLE call counts in the Darwin guest-memory fixture (dfb71ec85)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(runtime): translate macOS fault contexts on both CPU routes ... 9784b1b5a6

Was: #436 (#436), branch mac/fault-contexts at bccfd1c2e9 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(runtime): translate macOS fault contexts on both CPU routes (08940fb3d)
- test(runtime): keep Darwin fault checks native by default (7d7f99dcb)
- test(runtime): classify the fault bridge's fatal _exit in main's exit inventory (bccfd1c2e)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(runtime): add macOS waits and deadlines, shared by host and renderer ... a492f0ac52

Was: #437 (#437), branch mac/waits at beb8a2881a (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(runtime): port Win32 waits and deadlines to macOS (2f05d007f)
- test(runtime): link Darwin waits into the pointer fixture (ef081688d)
- fix(macos): share address wait state through the executable (186a461c5)
- docs(runtime): describe the executable-owned macOS address-wait state (beb8a2881)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(vk): add macOS Vulkan loader and device admission ... 58bdbdc027

Was: #438 (#438), branch mac/vk-admission at 681e37081d (Sweep3, on main aa95d35f).

Its own commits, squashed:
- feat(vk): add macOS Vulkan loader and device admission (6f34d00bc)
- test(vk): use semantic admission contracts (fdd161190)
- test(vk): follow main's LoadLibraryA and float-add choice in the admission fixture (3e088644f)
- test(vk): pin the admission ABI at main's version 23 and macOS 24 (4f4ca3c73)
- fix(macos): a window without Vulkan extensions ends as a clean exit, as main's exit inventory asks (681e37081)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(macos): native Darwin threads, fibers, restart, process I/O and profiler ... 6e36141173

Was: #490 (#490), branch mac/darwin-host at 162a39dcd3 (Sweep3, on main aa95d35f).

It was stacked on #436, #437, #438, #454, #477, #478; their changes are the earlier commits here.

Its own commits, squashed:
- feat(macos): complete Darwin host lifecycle and diagnostics (71a9ed0bb)
- fix(macos): integrate profile consumers and joined-thread shutdown (f420761ab)
- docs(macos): describe Darwin profile symbol loading (04e40191a)
- test(macos): integration fix: cut the tagged HThread in the waits fixture (9c18e64c4)
- test(macos): integration fix: stub the kept startup in the display fixture (5f8d511e6)
- test(macos): integration fix: prof symbols run on macOS, not a skip (a1e73d31e)
- test(macos): the memory-notice fixture runs the Darwin query (f4d7aaf76)
- fix(macos): a failed swap query still shows the low-RAM notice (28ed288a2)
- test(macos): the Darwin LoadLibraryA keeps dlerror()'s text for hos_load_error (52faf1d3d)
- fix(macos): integration fix: main's process affinity for new threads is Linux-only (61ec2411b)
- fix(macos): the POSIX main's end after the game's thread marks the clean end, as main's exit inventory asks (162a39dcd)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

build(macos): discover dual-architecture toolchains and form Mach-O commands ... f68637f873

Was: #453 (#453), branch mac/build-flags at 8ca4bff7a4 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- build(macos): discover dual-architecture toolchains and form Mach-O commands (499e3853a)
- test(macos): default real link fixtures to the process architecture (f6f6f042c)
- test(macos): isolate synthetic command paths from the test host (7c846ae91)
- build(macos): keep third_party/a64-kit as it is; nx2/darwin_toolchain.py makes its commands Mach-O (88054c966)
- build(macos): follow main's one-way renderer build and CPU target in the moved build code (a5b02633d)
- test(macos): the frozen Windows/Linux build arrays are main e090cc48's (c3009e01c)
- test: main's third-party objects test reads build.py with this PR's macOS names (8ca4bff7a)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

build(macos): classify Darwin helpers and package a relocatable macOS 14.4 dylib set ... 9a1094dac0

Was: #479 (#479), branch mac/build-complete at 1bd269c7e2 (Sweep3, on main aa95d35f).

It was stacked on #437, #453; their changes are the earlier commits here.

Its own commits, squashed:
- build(macos): complete strict standalone dependency packaging (9424b4886)
- fix(macos): bind SDL3, imports and archive members to their real formats (8ad0e3265)
- fix(macos): keep the lazy-bind library ordinal across DONE (48f6ec02b)
- build(macos): take the architecture and SDK from darwin_toolchain when packaging (5ce85548c)
- build(macos): no prebuilt renderer on macOS either, as main has none (1bd269c7e)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(builder): account for available memory and compiler children on macOS ... 2540028349

Was: #455 (#455), branch mac/mem-gate at 82c2e10341 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(builder): account for available memory and compiler children on macOS (8f8e03b7f)
- fix(builder): avoid stale Darwin available-memory snapshots (5240e431a)
- fix(builder): keep Darwin RSS behind the shared tree backend (82c2e1034)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(runtime): support control bridge Unix sockets on macOS ... 1b3354a0e7

Was: #456 (#456), branch mac/control-sockets at fc2f104050 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(runtime): support control bridge Unix sockets on macOS (5fc3fe390)
- test(control): link the bridge's macOS socket helpers into test_oot_state_tap's fixture (fc2f10405)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

test(control): wait until the bridge listens, and reap it when a quit check fails ... 68d940cae0

Was: #457 (#457), branch mac/control-quit at fe3e8c9178 (Sweep3, on main aa95d35f).

It was stacked on #456; their changes are the earlier commits here.

Its own commits, squashed:
- test(control): quit's parent waits for its bridge to listen, and a failed check ends the bridge it forked (fe3e8c917)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): preserve cache file reservations on macOS ... eb8d5573f6

Was: #476 (#476), branch mac/cache-files at 7e561fbb53 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(vk): preserve cache file reservations on macOS (7e561fbb5)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): serialize guest memory ownership on 16 KiB pages and pin imported backing ... 570a527793

Was: #480 (#480), branch mac/guest-16k at 657b780359 (Sweep3, on main aa95d35f).

It was stacked on #436, #478; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- fix(macos): serialize guest backing and native-page watch lifetimes (d7d999b92)
- fix(macos): retain pending watch faults across protection changes (a6a3e9e98)
- fix(macos): make the guest-memory changes Apple-only; Windows and Linux keep main's code (126d7bd67)
- docs(macos): describe the guest window's one owner, import pins and native-page watches (657b78035)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): build vk_programs, vk_shader and the debug tools on Darwin ... 98c070dcfd

Was: #492 (#492), branch mac/renderer-compile at 59f750aa38 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(macos): the renderer's last two files compile on Darwin (7ee5fd584)
- fix(macos): the debug tools are compiled on Darwin too (82b2d6606)
- test(macos): the debug tools check reads hos_oot_player_seen's body too (59f750aa3)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(runtime): build and keep crash records on macOS ... e5a1034360

Was: #511 (#511), branch mac/crash-records at c4d95017aa (Sweep3, on main aa95d35f).

It was stacked on #436; their changes are the earlier commits here.

Its own commits, squashed:
- fix(runtime): take the macOS report run id from getentropy (d3e86ddd7)
- fix(runtime): read crash-record memory and modules without /proc on macOS (aa039e142)
- test(runtime): build the crash-record fixture on macOS (adebf9dbb)
- test(runtime): link the macOS fault bridge into the crash-record fixture (c4d95017a)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(control): keep command-line sessions alive on macOS ... 40c1c5f5f8

Was: #516 (#516), branch mac/longshot-ctl-darwin at 3b9d3cfa2a (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(control): tell macOS processes apart by their sysctl start time (56f4ca876)
- test(control): compare launch's data folder with the resolved run folder (3b9d3cfa2)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): pin Vulkan host imports until their last owner, and unwind failed startups ... c1fa25a4b2

Was: #491 (#491), branch mac/renderer-correctness at 695f6859dc (Sweep3, on main aa95d35f).

It was stacked on #438, #480; their changes are the earlier commits here.

Its own commits, squashed:
- fix(macos): pin renderer imports through final resource ownership (db82a0f23)
- test(macos): cut the non-Apple Pool and import route in three more fixtures (6cee76eb1)
- fix(vk): drain the recorder before startup rollback destroys the allocator (18c05be52)
- test(macos): follow main's #324 and #250 in the Darwin renderer fixture (c099f5da6)
- test(vk): follow the moved Pool in test_mirror_gpu_only's cut (165bf7e61)
- fix(macos): the import pin callbacks are macOS host API version 25 (fa691b55b)
- fix(macos): vk_memory.cpp compiles on macOS: #324's evicted_pools declaration is not Apple's (695f6859d)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): on unified memory the GPU's allowance is what the Mac's RAM leaves, not Metal's working set ... 45e1d66607

Was: #642 (#642), branch mac/gpu-budget at 09978824a0 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- feat(vk): read the Mac's system memory for the renderer (gpu/vk/system_memory.h) (ba1952096)
- fix(macos): on unified memory the GPU's allowance is what the Mac's RAM leaves, not Metal's working set (632636ee0)
- fix(macos): vk_work.h stays vk_vma.cpp's last include (0e63a1dc1)
- fix(macos): the unified budget reads the system's memory at its first ask (5240eade7)
- docs(macos): RX_VK_UNIFIED_BUDGET in the switch table (09978824a)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(macos): RX_VK_METAL_CACHE_DIR keeps Metal's shader cache in a chosen folder ... 01630d4b6e

Was: #653 (#653), branch mac/metal-cache at db50cf3d26 (Sweep3, on main aa95d35f).

It was stacked on #438; their changes are the earlier commits here.

Its own commits, squashed:
- feat(macos): Metal's shader cache in a folder the caller names (db50cf3d2)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): give storage buffer tables descriptor sets instead of pushes on MoltenVK ... 063d87c431

Was: #643 (#643), branch mac/mvk-push at ca17df3be6 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- fix(macos): storage buffer tables get descriptor sets on MoltenVK (ca17df3be)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(macos): ship the Vulkan loader with KosmicKrisp and MoltenVK, MoltenVK the default ... 7df74b124d

Was: #654 (#654), branch mac/kosmickrisp at 9d34f9a1c8 (Sweep3, on main aa95d35f).

It was stacked on #438, #479; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- feat(macos): ship the Vulkan loader with KosmicKrisp and MoltenVK, chosen at startup (fbd562421)
- test(macos): the driver package fixture takes the architecture and SDK from darwin_toolchain (3472d670c)
- fix(macos): type the driver manifest's ICD record for Pyright (296b5347b)
- fix(macos): MoltenVK is the default Vulkan driver on every macOS (86c017e42)
- test(macos): the display fixture counts longshot_env.txt's loads on Apple only (9d34f9a1c)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): give programs that read storage buffer lengths descriptor sets on MoltenVK ... 02ad928d81

Was: #644 (#644), branch mac/mvk-sizes at f08eb70206 (Sweep3, on main aa95d35f).

It was stacked on #643; their changes are the earlier commits here.

Its own commits, squashed:
- fix(macos): programs reading storage buffer lengths get descriptor sets on MoltenVK (f08eb7020)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): use descriptor sets for stages with more than 8 read_write textures on MoltenVK ... 5b523fef19

Was: #645 (#645), branch mac/mvk-rwtex at b8b1ba998a (Sweep3, on main aa95d35f).

It was stacked on #644; their changes are the earlier commits here.

Its own commits, squashed:
- fix(macos): stages with more than 8 read_write textures get descriptor sets on MoltenVK (b8b1ba998)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): use update-after-bind sets past Metal's per-stage limits on MoltenVK ... 792a7d8a32

Was: #646 (#646), branch mac/mvk-pushlimits at 374c55a031 (Sweep3, on main aa95d35f).

It was stacked on #645; their changes are the earlier commits here.

Its own commits, squashed:
- fix(macos): stages past a Metal function's buffer, texture or sampler table get descriptor sets on MoltenVK (6c9e3c9fa)
- fix(macos): MoltenVK's descriptor sets are update-after-bind layouts, within Vulkan's limits for them (3e7d8d3d3)
- test(vk): recording_admission's device stub has the fixes make_pool now reads (374c55a03)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge topic/mvk-descriptor-limits into topic/shader-backend ... c8f7f435b1

The topic needs it (as the stacks merged it before).

Merge #431 fix/import-lookback into topic/shader-backend ... c1229ac20f

The topic needs it (as the stacks merged it before).

feat(vk): add a segment planner for guest spans larger than one device allocation ... a0afe1219a

Was: #647 (#647), branch mac/seg-plan at 52def6832c (Sweep3, on main aa95d35f).

Its own commits, squashed:
- feat(vk): plan where an oversize guest span is cut into import segments (601c00ccd)
- feat(vk): let the segment planner add segments that pay for themselves (52def6832)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(vk): bind storage and texel descriptors as piece arrays in the SPIR-V back end ... ad8133a32f

Was: #648 (#648), branch mac/seg-shader at 9b73e82942 (Sweep3, on main aa95d35f).

Its own commits, squashed:
- feat(vk): descriptors bound as pieces in the SPIR-V back end and program variants (1f9183c2a)
- fix(vk): MslArrayPtr: no pointer into a storage buffer array is passed to a function (9b73e8294)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(vk): read texel formats MoltenVK cannot view through R8/R16/R32 carrier codecs ... ff007b3ddd

Was: #649 (#649), branch mac/texel-codec at c5cbd39d26 (Sweep3, on main aa95d35f).

It was stacked on #648; their changes are the earlier commits here.

Its own commits, squashed:
- feat(vk): texel codecs in the SPIR-V back end and program variants (c5cbd39d2)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(vk): admit guest buffers per operation and import over-cap spans as segments on macOS ... cfb6702019

Was: #658 (#658), branch mac/renderer-core at f8d4e51ad5 (Sweep3, on main aa95d35f).

It was stacked on #431, #491, #647; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- fix(vk): join #431's import table helpers with #491's macOS Pool (a1d08d92a)
- fix(macos): import NOACCESS guest pages and name a missing audio service (e6e92a90d)
- feat(vk): admit an operation's guest buffers before it binds them (alias isolation, macOS) (a27bee681)
- feat(vk): import a span past one device allocation as segments (SegMem, alias isolation) (dd4f13047)
- test(vk): follow the renderer-core merge's moved code in three extractions (6e77a383f)
- fix(vk, macos): admit a parallel batch's uniform updates in order, and keep its own updates out of its handoff (3fbfca08d)
- fix(vk, macos): keep every byte the page table reached mapped when an admission retires imports (616eacb83)
- fix(vk, macos): one view per byte of an Apple spare backing, and no endless retry of a failed view (04e00832b)
- fix(vk, macos): bg_drain publishes no background import over this epoch's retired memory or across a domain (a3913a646)
- fix(vk, macos): admission merges no import past 1 GiB again, so mirror_make can still mirror it (b8d16a20b)
- fix(vk, macos): a segment keeps a crossing import's bytes as leftovers clipped at the cuts, not as whole segments (aab3fd8a6)
- fix(vk, macos): each new import over a retired import's bytes inherits its share of that import's VRAM mirror (73bbb89ad)
- test(vk): the admission fixtures follow main's #250 sparse mirrors (6fa302cce)
- fix(vk, macos): the actor motion's resolver follows #59: a pose read at its draw is not copied (e0941ccc0)
- test(vk): test_split_ub_flush follows flush_ub_updates' end parameter (f8d4e51ad)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(vk): add the inert contract for segmented binding consumers ... 39a916d6e3

Was: #662 (#662), branch mac/seg-contract at 0401eeb237 (Sweep3, on main aa95d35f).

It was stacked on #649, #658; their changes are the earlier commits here.

Its own commits, squashed:
- feat(vk): the segmented consumers' frozen contract (C0) (0401eeb23)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(vk): bind segment-straddling buffers and texel views as piece arrays, and split transfers at segment cuts, on macOS ... 7eb53a2db8

Was: #663 (#663), branch mac/seg-consumers at 5400f1a0b6 (Sweep3, on main aa95d35f).

It was stacked on #645, #662; their changes are the earlier commits here.

Its own commits, squashed:
- feat(vk): texel codecs' views, texel piece views, null-descriptor stand-ins and presence words (TexelDesc, L3) (da741bdb2)
- test(vk): the texel ownership fixture names the case that failed (39d6490dd)
- feat(vk): SegBind's descriptor core, gathers and arena (L1) (7d5d51276)
- fix(vk): a draw reusing its descriptors drops an earlier build's refusal (SegBind) (7104d8324)
- test(vk): SegBind's gathers and notes fixtures, its parts of three checks, and its docs section (31d52778f)
- test(vk): test_set_for_tables reads its cut from --source (4462202ff)
- test(vk): test_mesh_fallback's topology anchor follows draw()'s `plain` (0f743f0b9)
- test(vk): test_set_for_lengths' layout fixture takes SegBind's seg_layout_count and presence_words (3b5f3b477)
- feat(vk): SegXfer, the transfer consumers of a range across a segment's cut (L2) (3200ff464)
- fix(vk): dispatch()'s compute-variant path (#252) names SegBind's pre-seam `plain` (c13540fc5)
- test(vk): the seg_gathers fixture stubs #162's rec::OwnSlot (8089dc409)
- test(vk): SegXfer's fixture and resolver sites follow #59's actor motion (1ab6beb2b)
- test(vk): SegXfer's gpu_write checks follow #329's ordered inline writes (5400f1a0b)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(vk): emulate null descriptors in the SPIR-V back end on MoltenVK ... 3ccdc8afe5

Was: #674 (#674), branch mac/null-shader at b7683077e6 (Sweep3, on main aa95d35f).

It was stacked on #663; their changes are the earlier commits here.

Its own commits, squashed:
- feat(vk): null-descriptor emulation in the SPIR-V back end (NullShader, L4) (71003696f)
- docs(vk): NullShader: image and image buffer arrays share a known gap (17667bea3)
- fix(vk): NullShader: two source-cutting checks the wip commit broke (f53eda6cd)
- fix(vk): MslArrayPtr's NullShader half: a descriptor bound whole calls its loop function, and the loops' CPU runs (b7683077e)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): keep storage image reads in program order on MoltenVK ... 2843f77e9e

Was: #675 (#675), branch mac/tex-read-order at c5c6a853a8 (Sweep3, on main aa95d35f).

It was stacked on #674; their changes are the earlier commits here.

Its own commits, squashed:
- fix(vk): TexOrder: store each image read in place on MoltenVK (fb51f7807)
- test: test_amd_subgroup_profiles: the MoltenVK driver id in make_profile's stand-in (8d5fc5373)
- fix(vk): TexOrder: an image memory barrier before each image write and atomic on MoltenVK (c5c6a853a)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): bound SPIRV-Cross expression nesting on MoltenVK ... 85b977e302

Was: #676 (#676), branch mac/msl-depth at f8e18c953b (Sweep3, on main aa95d35f).

It was stacked on #675; their changes are the earlier commits here.

Its own commits, squashed:
- fix(macos): MoltenVK's Metal source nests no deeper than 32 forwarded instructions (71d2498c4)
- test(vk): the subgroup profile fixture knows MoltenVK's driver id (f8e18c953)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): Rosetta host imports at whole hardware pages, and a refused import asked again only when its backing changes ... 48af6a5453

Was: #686 (#686), branch mac/rosetta-import at 6ec9629e59 (Sweep3, on main aa95d35f).

It was stacked on #658; their changes are the earlier commits here.

Its own commits, squashed:
- fix(macos): Rosetta host imports: whole hardware pages, refused imports asked again only when their backing changes (ae91338ae)
- fix(macos): the backing generation is Apple host API version 26, after #491's import pins at 25 (6ec9629e5)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): the MoltenVK nesting bound counts only the reads SPIRV-Cross certainly makes ... 6ada36089b

Was: #692 (#692), branch mac/msl-depth2 at a67e1934ec (Sweep3, on main aa95d35f).

It was stacked on #676; their changes are the earlier commits here.

Its own commits, squashed:
- fix(macos): the nesting bound counts only the reads SPIRV-Cross certainly makes (a67e1934e)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): bound the control-flow nesting of SPIRV-Cross's Metal source on MoltenVK ... 4c8dcc77d2

Was: #693 (#693), branch mac/compile-gaps at 5ceed495b2 (Sweep3, on main aa95d35f).

It was stacked on #692; their changes are the earlier commits here.

Its own commits, squashed:
- fix(vk): bound the control-flow nesting of SPIRV-Cross's Metal source on MoltenVK (46b5810a9)
- perf(vk): parse the module in place when the scope bound has nothing to move (5ceed495b)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): MoltenVK's vertex stages run the guest's warp operations as one-lane warps ... 1e976d5faf

Was: #694 (#694), branch mac/subgroup-vertex at a3e8a51faf (Sweep3, on main aa95d35f).

It was stacked on #676; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- fix(vk): MoltenVK's vertex stages run the guest's warp operations as one-lane warps (a2b3b0578)
- test(vk): test_subgroup_vertex: the base tree's own checks unprinted, and one failure message per cause (e20482fa9)
- test(vk): test_subgroup_vertex: SPIRV-Cross drops a subgroup barrier in a vertex function (a3e8a51fa)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(vk): RX_VK_SPV_PROFILE, what the big SPIR-V modules are made of ... d87bcd25fe

Was: #695 (#695), branch mac/spv-size at 43d1a23420 (Sweep3, on main aa95d35f).

It was stacked on #676; their changes are the earlier commits here.

Its own commits, squashed:
- feat(vk): RX_VK_SPV_PROFILE, what the big SPIR-V modules are made of (3d7b1f5f6)
- docs(vk): spirv_profile.h's store names where the line is printed (ebf1854b4)
- docs(vk): RX_VK_SPV_PROFILE's text names the slow compile line as the precompile hand-off's (43d1a2342)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

perf(vk): search storage buffer tables in loops in every global memory fallback on MoltenVK and KosmicKrisp ... d58c00e2b2

Was: #696 (#696), branch mac/gm-loop at 231115f14c (Sweep3, on main aa95d35f).

It was stacked on #694, #695; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- feat(vk): MoltenVK and KosmicKrisp search storage buffer tables in loops in every global memory fallback (39a40fed6)
- test(vk): gm_loop_ir --gpu: the loop forms first, then the written-out ones, smaller first (99616b7ab)
- test(vk): stub table_loops_on where make_profile is compiled cut out (231115f14)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

perf(vk): zero local memory at computed offsets by a loop on MoltenVK, not a written-out initializer ... 51da27ed65

Was: #697 (#697), branch mac/local-mem-buffer at a526c34c9f (Sweep3, on main aa95d35f).

It was stacked on #696; their changes are the earlier commits here.

Its own commits, squashed:
- feat(vk): MoltenVK zeroes local memory at computed offsets by a loop, not a written-out initializer (a526c34c9)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): keep storage image reads in program order on KosmicKrisp too ... 234bb376db

Was: #698 (#698), branch mac/kk-tex-order at 8a3d7db0ce (Sweep3, on main aa95d35f).

It was stacked on #654, #675; their changes are the earlier commits here.

Its own commits, squashed:
- fix(macos): TexOrder's stored image reads on KosmicKrisp too (27d566b45)
- test(macos): the Apple drivers' check names the fixes this tree makes (8a3d7db0c)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

test: giant mesh fallbacks' shape through the real SPIR-V back end (tests/giant_shape_ir.cpp) ... 1bf322f4ac

Was: #787 (#787), branch mac/giant-shape at 96b51b55b5 (Sweep3, on main aa95d35f).

It was stacked on #697; their changes are the earlier commits here.

Its own commits, squashed:
- test: giant mesh fallbacks' shape through the real SPIR-V back end (tests/giant_shape_ir.cpp) (96b51b55b)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): the null descriptors' stand-in clear not done in 5 s is waited for before its fence and pool go ... 55cfa8870d

The Mac-only part of fix/async-safe-frees-i40 (c151fcea, MvkAsyncFix's F5) that #788 does not carry, because
null_dummies_make (#663, macOS: MoltenVK has no nullDescriptor) exists only on the macOS stack. The stand-in images' clear
waits 5 s for its fence; when that wait ran out, the fence and the command pool were destroyed while the GPU might still be
clearing (a destroyed pool under a pending command buffer). Now a clear submitted and not seen done in 5 s is waited for
without a limit first, as #788 does for the read-back. The clear is still reported as not done in time (the "may read
garbage" line), as before.

tests/test_null_dummies.py: case make-slow-clear (the fixture's fence wait runs out once): one unbounded wait after the 5 s
one, before the fence and the pool are destroyed. Fails before this commit (one wait, none unbounded), passes after, on arm64
and x86_64 under Rosetta.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

feat(macos): count NVN's polygon modes and restart-off strip draws on Apple, log-only ... 4df9d9cf6f

Was: #677 (#677), branch mac/mode-census at d2fd7a90ff (Sweep3, on main aa95d35f).

It was stacked on #663; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- feat(vk): count polygon modes and restart-off strip draws on Apple, log-only (d2fd7a90f)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): bind a direct draw's 8-bit indices with their size on MoltenVK ... 86f89bafd1

Was: #678 (#678), branch mac/mvk-temp at 989a6423d9 (Sweep3, on main aa95d35f).

It was stacked on #677; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- fix(macos): bind a direct draw's 8-bit indices with their size on MoltenVK (ca6b27fdd)
- docs(macos): RX_VK_INDEX8_SIZE in the switch table (989a6423d)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): count draws rewritten where MoltenVK has no drawIndirectCount, and buffer updates copied from the stream ... 46709358c6

Was: #679 (#679), branch mac/count-draws at 2028d598e6 (Sweep3, on main aa95d35f).

It was stacked on #677; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- fix(macos): draw count draws through a record rewrite where the device has no drawIndirectCount (4d9de1004)
- fix(macos): the count draw report in its own block; SegBind's fixture cuts the rewrite (ce7388bf0)
- fix(macos): buffer updates copied from the recording's stream on MoltenVK (574597e08)
- fix(macos): the count-draw rewrite on macOS only; Windows and Linux give count draws to the driver as before (791fe3a75)
- docs(macos): RX_VK_COUNT_REWRITE in the switch table (e4a7ab285)
- test(vk): test_inline_write_order (main's, #329) has gpu_write's cmd_update_buffer (2028d598e)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): direct draws that read the draw index drawn as one indirect record on MoltenVK ... be50bf0d9b

Was: #680 (#680), branch mac/drawid-direct at 6c0204eb98 (Sweep3, on main aa95d35f).

It was stacked on #679; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- fix(macos): direct draws that read the draw index drawn as one indirect record on MoltenVK (4876f2615)
- fix(macos): tessellated direct draws reading the draw index counted, not logged as errors (32a83be13)
- test(macos): the three recording fixtures stand in stream_usage (6c0204eb9)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

docs(macos): MoltenVK main 5189f8de with the argbuf-slots patch as the recommended MoltenVK input, and how to build it ... ea86daafae

Was: #691 (#691), branch mac/moltenvk-main at ebd6b127e2 (Sweep3, on main aa95d35f).

It was stacked on #654, #679; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- docs(macos): a MoltenVK built from main as the MoltenVK input (546102abe)
- docs(macos): MoltenVK main 5189f8de with the argbuf-slots patch as the recommended MoltenVK input, and how to build it (ebd6b127e)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): fans keyed apart from the other triangle topologies on MoltenVK ... 21e6ec798f

Was: #701 (#701), branch mac/fan-key at cd1ce0b214 (Sweep3, on main aa95d35f).

It was stacked on #680; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- feat(macos): count fans against their pipelines' static topology on MoltenVK, log-only (773588160)
- fix(macos): fans keyed apart from the other triangle topologies on MoltenVK (cd1ce0b21)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): an indirect fan of more than one record drawn a call a record on MoltenVK ... 00b7deaf44

Was: #702 (#702), branch mac/fan-indirect at d7878c9d1a (Sweep3, on main aa95d35f).

It was stacked on #701; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- feat(macos): count indirect fans and their records on MoltenVK, log-only (927ed3de1)
- fix(macos): an indirect fan of more than one record drawn a call a record on MoltenVK (3a743b80f)
- test(macos): the indirect fans' census checked right after FanKey's, not as draw()'s last statement (62a089ad7)
- test(macos): the segment gathers' fixture stands in FanIndirect's way and split (d7878c9d1)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): take flat values from each primitive's last vertex on MoltenVK, as NVN does, for direct triangle draws and the mesh fallback ... 5efbe9d888

Was: #703 (#703), branch mac/provoking-first at 73d4bc9bd4 (Sweep3, on main aa95d35f).

It was stacked on #701; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- feat(macos): count the draws that depend on the provoking vertex where the device has no provokingVertexLast (8276aa94d)
- fix(macos): direct draws that depend on the provoking vertex drawn with each primitive's last vertex first, without provokingVertexLast (ac8416c59)
- fix(macos): adjacency draws that depend on the provoking vertex drawn as plain lists with each primitive's last vertex first (1977f19f5)
- fix(macos): the mesh fallback's draws that depend on the provoking vertex drawn with each primitive's last corner first (6493717b6)
- fix(macos): lines that depend on the provoking vertex counted only, not reversed (e702fd96e)
- fix(macos): a converted draw's list written into the stream of the recording it is drawn in (4f9891106)
- test(macos): draw()'s fixtures stand in ProvokingFirst's list and count its index binds (e42bf6e87)
- test(macos): test_fan_key reads draw()'s count lines with ProvokingFirst's count on them (531fd13ec)
- test(macos): a converted fan is drawn with a pipeline built as a list under FanKey's key (523d0696e)
- fix(macos): the provoking-vertex count and lists on macOS only; Windows and Linux record as before (73d4bc9bd)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): draw indirect quad draws, with and without a count, on every driver ... 98947b98a3

#705 restacked on topic/draw-path (the topic that carries #679, which it was stacked on): its commits at 5fa122654c (Sweep3, on main aa95d35f), squashed into one because the topic's later commits meet them. Every platform. Its own commits:
- feat(vk): count quad draws, and the indirect ones left out (log-only) (08878e8c7)
- fix(vk): draw indirect quad draws, with and without a count, on every driver (30c4461d3)
- fix(vk): an indexed quad expansion's workgroup bound saturates (5fa122654)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): draw mesh count draws on the compute fallback, grow its records area on demand, and count what it cuts ... 418a9fc478

#707 restacked on topic/draw-path (the topic that carries #679, which it was stacked on): its commits at b41a03a9ac (Sweep3, on main aa95d35f), squashed into one because the topic's later commits meet them. Every platform. Its own commits:
- feat(vk): count mesh draws by kind and what the mesh fallback cuts (log-only) (435c47d47)
- feat(vk): draw mesh count draws on the compute fallback (092afd495)
- fix(vk): the mesh fallback's records area grows on demand (17cace138)
- test(vk): six fixtures follow the mesh counters, count draws and growing area (02db49808)
- fix(vk): the mesh count draws bind their stages without RX_VK_LMEM_LOG's hook, which this base lacks (b41a03a9a)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge #705 fix/indirect-quads into topic/draw-path-quads-mesh ... f339237149

The topic needs it (as the stacks merged it before).

Merge #707 fix/mesh-count into topic/draw-path-quads-mesh ... 3d3939ada8

The topic needs it (as the stacks merged it before).

fix(macos): quads provoke the same corners where the first vertex provokes ... c7a41dcdd7

Was: #706 (#706), branch mac/indirect-quads at 6e6bc8d921 (Sweep3, on main aa95d35f).

It was stacked on #705; their changes are the earlier commits here.

Its own commits, squashed:
- fix(macos): quads provoke the same corners where the first vertex provokes (6e6bc8d92)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): the mesh fallback's rotation follows the count draws and the growing records area ... bf6088306d

Was: #708 (#708), branch mac/mesh-provoking at d24ecc70ec (Sweep3, on main aa95d35f).

It was stacked on #703, #707; their changes are the earlier commits here.

Merged with the topic's earlier commits by hand where they met (Consolidate-files/hand-resolutions.md).

Its own commits, squashed:
- fix(vk): the mesh fallback's rotation kept to what its list covers; the indirect quads counted for the provoking vertex; five checks follow (3a7b258ec)
- test: test_seg_xfer's fixture stands in fallback_draw_area (87f575c40)
- fix(macos): the mesh fallback's rotation follows the count draws and the growing records area (70686bc10)
- fix(macos): the mesh fallback's rotation decided and counted on macOS only, as ProvokingFirst's other gates (4800449a5)
- fix(macos): a rotated mesh fallback draw's area is cut only when its rotation list covers fewer corners than it holds (d24ecc70e)

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

test(macos): test_fan_indirect's cut of the indirect block ends at draw()'s next branch, ProvokingFirst's list (#702 with #703) ... c2cfee0fe4

Hand resolution on topic/draw-path, where #702 (FanIndirect) met #703 (ProvokingFirst), siblings on #701 that only this topic
combines. test_fan_indirect (#702) cuts draw()'s indirect block up to "} else if (d.indexed) {"; #703 puts its own branch,
"} else if (pv.made) {" (the list written into the stream and drawn as an indexed draw), between the two, so the cut took it in and
the fixture no longer built (pv, ProvokingWrite, game_topo, drawid_direct undeclared). The cut now ends at draw()'s next branch,
whichever it is, as Integration 37's eb4d02046 has it (its tests/test_fan_indirect.py line only). The check keeps what it requires;
no source changes.

test_fan_indirect: failing at 5efbe9d8 on arm64 and x86_64, passing with this commit; passing at #702's Sweep3 head d7878c9d.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge topic/draw-path into restack/fix/indirect-quads ... bd038ba93c

The base's hand resolution c2cfee0f (test_fan_indirect's cut, #702 with #703).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(vk): the indirect quads' draw counted for the provoking vertex and by FanKey's census; four checks follow topic/draw-path (#705 with topic/draw-path) ... a27f8f47ff

Hand resolution on restack/fix/indirect-quads, where #705 (IndirectQuads) meets topic/draw-path (#678, #680, #701, #703), as
Integration 36's 74da414a and Integration 37's eb4d02046 resolved it (only their hunks at this level: no PerfInstr hook, no mesh
fallback part).

- gpu/vk/vk_draw.cpp: #705's indirect quad draw is a sixth draw site in draw(). Its count gains ProvokingFirst's provoking_note
  (#703) and FanKey's census_fan_draw (#701), as the other sites and the direct quads' have them. Both return at once off Apple and
  off MoltenVK (provoking_first() is false off __APPLE__; census_fan_draw checks VK_DRIVER_ID_MOLTENVK): log-only counts, nothing
  recorded or drawn changes on any driver. Off Apple the two calls are the token change.
- tests/test_quad_draws.py (#705's): the direct quad draw as topic/draw-path has it, DrawIdDirect's record (rq) drawn from its
  words, then the count with provoking_note, then quad_drawn.
- tests/test_provoking_first.py (#703's): six census_draw sites, each with provoking_note (was five).
- tests/test_fan_key.py (#701's): three non-mesh sites of six counts (was two of five).
- tests/test_index8_bind.py (#678's): draw()'s indirect and direct branches found at a line's start (#705's rewrite gate holds a
  deeper "if (d.indirect) {" line first).
Each check keeps what it requires; none is dropped.

test_quad_draws, test_provoking_first and test_index8_bind failed at the merge before this commit; with it they pass, with
test_fan_key and test_fan_indirect, on arm64 and x86_64.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge topic/draw-path into restack/fix/mesh-count ... 231e68e90c

The base's hand resolution c2cfee0f (test_fan_indirect's cut, #702 with #703).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

test: make_profile's cut-out fixtures know KosmicKrisp, SubgroupVertex, GmLoop and LocalMemBuffer ... 70cc5ba1cb

In this topic #698 (KosmicKrisp's TexOrder, its Apple drivers' fixture in test_vendor_fixes) meets #694/#696
(SubgroupVertex: make_profile reads dev.subgroup_stages and Shader::Stage) and #697's two switches (GmLoop's
table_loops_on, LocalMemBuffer's local_zero_loop_on), and test_subgroup_vertex's stub meets KosmicKrisp's
VK_DRIVER_ID_MESA_KOSMICKRISP in make_profile. Each member passes at its own Sweep3 head; at the topic's tip the
fixtures did not build. This takes I41's fixes 02b10861 and 560923891's stub line:
- test_subgroup_vertex: the KosmicKrisp driver constant (28, the Vulkan headers' value);
- test_vendor_fixes' Apple drivers' fixture: subgroup_stages (all stages), stage.h, and table_loops_on and
  local_zero_loop_on stubs; its columns are unchanged.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>
(cherry picked from commit 02b108611 and the local_zero_loop_on line of 560923891)

Merge restack/fix/indirect-quads into topic/draw-path-quads-mesh ... 174d020966

The base's update: topic/draw-path's hand resolution c2cfee0f and #705's a27f8f47 (the indirect quads' count with provoking_note and FanKey's census; four checks).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

# Conflicts:
#	tests/test_provoking_first.py

Merge restack/fix/mesh-count into topic/draw-path-quads-mesh ... a8525549fd

The base's update: topic/draw-path's hand resolution c2cfee0f (#707's restack takes it, nothing else).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge topic/shader-backend into topic/draw-path ... d495b383bf

The base's fixture fix 70cc5ba1 (test_vendor_fixes' Apple-drivers fixture and test_subgroup_vertex's stub, #698 with #694/#696/#697). Merged after c2cfee0f, which was in before the fix was named: the tree is the same in either order (the two touch different tests).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge topic/draw-path into restack/fix/indirect-quads ... afdd265d93

The base's fixture fix 70cc5ba1 (topic/shader-backend), by topic/draw-path.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge restack/fix/indirect-quads into topic/draw-path-quads-mesh ... e218ae136d

The base's update: the fixture fix 70cc5ba1 (topic/shader-backend), by topic/draw-path.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge topic/draw-path into restack/fix/mesh-count ... cb5008447b

The base's fixture fix 70cc5ba1 (topic/shader-backend), by topic/draw-path.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge restack/fix/mesh-count into topic/draw-path-quads-mesh ... b8ba5986cb

The base's update: the fixture fix 70cc5ba1 (topic/shader-backend), by topic/draw-path.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): draw_index8_report's closing brace, lost where #701's fan census report met #678's 8-bit report (#678 with #701) ... 67fd90bc88

Hand resolution on topic/draw-path. #701's resolution (chain commit 21e6ec79) placed draw_fan_census_report after #678's
draw_index8_report and dropped the closing } of draw_index8_report, so gpu/vk/vk_draw.cpp stopped compiling from there ("function
definition is not allowed here" at draw_fan_census_report, then every later definition), on arm64 and x86_64, at every commit from
21e6ec79 to this one. The } goes back after the report's logf, as Integration 41 (78ec1c47, vk_draw.cpp 5087) has it, without
#782's widen8_report line (topic mac-perf). No other change.

Found by the whole-file compile of vk_draw.cpp at this topic's tip and at the topics on it.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge topic/draw-path into restack/fix/indirect-quads ... d88e2f1d9b

The base's hand resolution 67fd90bc (draw_index8_report's closing brace, #678 with #701).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge topic/draw-path into restack/fix/mesh-count ... 05425c7dcc

The base's hand resolution 67fd90bc (draw_index8_report's closing brace, #678 with #701).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge restack/fix/indirect-quads into topic/draw-path-quads-mesh ... 79fb73feb9

The base's update: topic/draw-path's 67fd90bc (draw_index8_report's closing brace).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge restack/fix/mesh-count into topic/draw-path-quads-mesh ... 54578e2910

The base's update: topic/draw-path's 67fd90bc (draw_index8_report's closing brace).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(macos): log_frame_stats' MeshCountDraws report block closed again, lost where #707's report met FanIndirect's (#707 with topic/draw-path) ... d99221c42f

Hand resolution on topic/draw-path-quads-mesh. The base merge of #707 (3d3939ad) put #707's MeshCountDraws report block in
gpu/vk/vk_replay.cpp's log_frame_stats ({ char when[48]; snprintf(...); draw_mesh_report(when, 120.0); }) before #702's FanIndirect
block and dropped the block's closing }, so vk_replay.cpp stopped compiling from there ("function definition is not allowed here"
at status_tick, then every later definition), on arm64 and x86_64, at every commit of this topic from 3d3939ad on. restack/fix/
mesh-count (cb500844) and Integration 41 (78ec1c47, vk_replay.cpp 3962) have the }; it goes back. No other change.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

test(vk): test_drawid_direct pins MeshCountDraws' DrawIndex condition (#707 with topic/draw-path's #680) ... 19d6d2d433

Hand resolution on restack/fix/mesh-count, where #707 (MeshCountDraws) meets #680 (DrawIdDirect), a pair this restack first
combines. #707 declares BuiltIn DrawIndex for a stage loading DrawID except a mesh fallback's task or mesh stage (a GLCompute stage,
its draw index pushed); test_drawid_direct (#680's) pinned the old condition and failed ("spirv_emit_context.cpp declares
DrawIndex other than for a stage loading DrawID and the mesh-first task stage") at this restack and at topic draw-path-quads-mesh,
on arm64 and x86_64. It now pins the new one (DrawIdDirect's direct draws never come from those stages), and
program_reads_draw_index's comment says so: Integration 36's b4732392, its test_drawid_direct hunk and that comment only (its
perf_lines parts belong to topic mac-perf). No code change: the comment is the only vk_draw.cpp change.

test_drawid_direct: failing before this commit, passing with it, on arm64 and x86_64.

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

Merge restack/fix/mesh-count into topic/draw-path-quads-mesh ... 90ab8ea110

The base's update: #707's 19d6d2d4 (test_drawid_direct pins MeshCountDraws' DrawIndex condition, #707 with #680).

Assisted-by: Claude Opus 5.5
Co-Authored-By: Claude Opus 5.5 <[email protected]>

BeanIssues added the

area/renderer

kind

bug

platform/macos

labels 2026-11-15 17:40:30 +00:00

mooki referenced this pull request 2026-11-15 17:41:20 +00:00

WIP: feat(macos): run the host on macOS: build, runtime, control, crash records and the Vulkan loader #845

mooki referenced this pull request 2026-11-15 17:41:24 +00:00

WIP: feat(macos): Vulkan on Metal: pinned host imports, the unified-memory budget, Metal's cache folder and KosmicKrisp #846

mooki referenced this pull request 2026-11-15 17:41:28 +00:00

WIP: fix(vk): MoltenVK's descriptor limits in descriptor sets #847

mooki referenced this pull request 2026-11-15 17:41:31 +00:00

WIP: feat(vk): the SPIR-V back end on MoltenVK and guest spans past one device allocation #848

mooki referenced this pull request 2026-11-15 17:41:35 +00:00

WIP: fix(macos): MoltenVK's precompile and pipelines on Metal #849

mooki referenced this pull request 2026-11-15 17:41:40 +00:00

WIP: fix(macos): draw-path emulation on MoltenVK #850

mooki referenced this pull request 2026-11-15 17:41:48 +00:00

WIP: perf(macos): Mac performance on MoltenVK #852

mooki referenced this pull request 2026-11-15 18:09:16 +00:00

WIP: fix(macos): quads provoke the same corners where the first vertex provokes #706

mooki referenced this pull request 2026-11-15 18:09:18 +00:00

WIP: fix(macos): the mesh fallback's rotation follows the count draws and the growing records area #708

mooki referenced this pull request 2026-11-15 18:14:44 +00:00

Idea: a native macOS build (Apple silicon, x86-64 under Rosetta) with Vulkan on Metal through MoltenVK #420

HumanBean commented 2026-11-15 18:49:17 +00:00

Owner

• Copy link
• Copy Markdown

This conflicts with main and is built on top of the macOS series (it carries the commits of #845 and others below it). nx2/build.py, nx2/make_game.py and docs/development.md conflict with #577 (the WebGPU renderer removed from the Windows build). Please rebase onto current main once its base PR #845 lands or is rebased; I didn't touch it because a rebase here would have to be redone after that.

This conflicts with `main` and is built on top of the macOS series (it carries the commits of https://git.magicbean.dev/MagicBeanDev/Longshot/pulls/845 and others below it). `nx2/build.py`, `nx2/make_game.py` and `docs/development.md` conflict with https://git.magicbean.dev/MagicBeanDev/Longshot/pulls/577 (the WebGPU renderer removed from the Windows build). Please rebase onto current `main` once its base PR https://git.magicbean.dev/MagicBeanDev/Longshot/pulls/845 lands or is rebased; I didn't touch it because a rebase here would have to be redone after that.

Some checks failed

Hide checks

CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped

Details

CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped

Details

CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped

Details

Third-party parts / The same as upstream (pull_request) Has been skipped

Details

Website / Website on Cloudflare (pull_request_target) Has been skipped

Details

CI / Conventional Commit title (pull_request) Successful in 6s

Details

CI / Workflow lint (actionlint) (pull_request) Successful in 12s

Details

Guide screenshots / Guide images and local UI source review (pull_request) Failing after 13s

Details

Third-party parts / As their notes say (pull_request) Successful in 24s

Details

PR description / Description follows the template (pull_request_target) Successful in 17s

Details

This pull request has changes conflicting with the target branch.

• docs/development.md
• gpu/vk/vk_draw.cpp
• gpu/vk/vk_memory.cpp
• gpu/vk/vk_shader.h
• gpu/vk/vk_texture.cpp
• nx2/build.py
• nx2/make_game.py

View command line instructions

Manual merge helper

Use this merge commit message when completing the merge manually.

Merge commit title WIP: fix(macos): the Mac halves of indirect quads and mesh count draws (#851)

Merge commit body Reviewed-on: https://git.magicbean.dev/MagicBeanDev/Longshot/pulls/851

WIP: fix(macos): the Mac halves of indirect quads and mesh count draws (#851) Reviewed-on: https://git.magicbean.dev/MagicBeanDev/Longshot/pulls/851 Copy merge commit message

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u 'mac/topic-draw-path-quads-mesh:mooki-mac/topic-draw-path-quads-mesh'

git switch 'mooki-mac/topic-draw-path-quads-mesh'

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

area/accessibility

Barriers for people with disabilities

  

area/audio

Sound and music

  

area/input

Controllers, keyboard, mouse

  

area/install

Installing, updating, building from your game

  

area/menu

In-game menu and settings

  

area/renderer

Vulkan renderer, shaders, effects

  

area/saves

Save files

  

area/upscaling

DLSS, FSR, frame generation

  

beanstalk: approved @ 1697603

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ 2c5a62e

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ 4fd82b7

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ 64d6d09

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ 6f91fae

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ 70a78f9

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ 8d361dc

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ 9d8356e

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ abf2227

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ d82f202

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ e5f1e40

Set by Beanstalk for show; the farm's database is what counts

  

beanstalk: approved @ ee8ab5f

Set by Beanstalk for show; the farm's database is what counts

  

ci: approved

A maintainer approved CircleCI for this fork PR (sticky; removed after 14 quiet days)

  

good first issue

A good start for a new contributor

  

gpu/amd

AMD GPUs

  

gpu/igpu

Integrated GPUs

  

gpu/intel

Intel GPUs

  

gpu/nvidia

NVIDIA GPUs

  

help wanted

Extra hands or knowledge wanted

  

kind

bug

Something doesn't work as it should

  

kind

chore

Build, CI, dependencies, tidying

  

kind

docs

Documentation

  

kind

feature

A new feature or an improvement

  

kind

performance

Frame rate, frame time, loading, memory

  

kind

question

A question rather than a change

  

needs measurements

Waiting for before/after measurements

  

platform/linux

Affects Linux (a change for every system carries both Windows and Linux)

  

platform/macos

macOS (Apple silicon or Intel Macs)

  

platform/steam-deck

Steam Deck

  

platform/windows

Affects Windows (a change for every system carries both Windows and Linux)

  

preview

Maintainers: deploy a preview of this PR's website (read its changes first). Removed after the run.

  

priority

critical

Crashes, data loss, or blocks most players

  

priority

high

Important: next in line

  

priority

low

Nice to have

  

regression

Worked in an earlier build, broken in a newer one: highest priority, above other bugs

  

status

blocked

Waits on something else first

  

status

confirmed

Reproduced or agreed on

  

status

duplicate

Already reported or proposed

  

status

invalid

Not a problem in this project

  

status

needs-info

Waiting for more information from the reporter

  

status

wontfix

Will not be worked on

  

testing wanted

Wanted: a test on other hardware (posts a test request in #test-requests)

  

ci: approved

No labels

area/accessibility

area/audio

area/input

area/install

area/menu

area/renderer

area/saves

area/upscaling

beanstalk: approved @ 1697603

beanstalk: approved @ 2c5a62e

beanstalk: approved @ 4fd82b7

beanstalk: approved @ 64d6d09

beanstalk: approved @ 6f91fae

beanstalk: approved @ 70a78f9

beanstalk: approved @ 8d361dc

beanstalk: approved @ 9d8356e

beanstalk: approved @ abf2227

beanstalk: approved @ d82f202

beanstalk: approved @ e5f1e40

beanstalk: approved @ ee8ab5f

ci: approved

good first issue

gpu/amd

gpu/igpu

gpu/intel

gpu/nvidia

help wanted

kind

bug

kind

chore

kind

docs

kind

feature

kind

performance

kind

question

needs measurements

platform/linux

platform/macos

platform/steam-deck

platform/windows

preview

priority

critical

priority

high

priority

low

regression

status

blocked

status

confirmed

status

duplicate

status

invalid

status

needs-info

status

wontfix

testing wanted

ci: approved

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

MagicBeanDev/Longshot!851

No description provided.