13 KiB
P5f fm — Magma 跨角色读写退役
分支
p5f/fm；Windows worktreeMobileGL-p5f-fm；WSL gate tree~/w7/p5f-fm。 代码 checkpoint：b394a09f。实现与范围结论已核对；§5 的最后一轮数字由门禁执行者补齐。 本报告只裁定 fm；不宣布 P5f 总出口完成。
1. 真实可达性修正
f0 的“带 buffer 的 draw 最终到 buffer-legacy-arm”不能推出整个 draw 子树不可达。
ClipDistanceScenario.AnEnabledClipDistanceRemovesTheNegativeHalf 使用 gl_VertexID，没有 VBO；在 f1 基线
~/w7/p5f-f1 的真实 Magma/inproc、role-split=0、strict=0 下像素测试通过（/tmp/p5f-fm-baseline-clip.log）。
因此本包保留无 buffer draw/dispatch，新增 server program source、descriptor 和 render-pass 路径；没有把所有 draw 拒绝。
迁移后同一 case 在 role-split=1、strict=1 下通过（fm-clip.log；集成者独立复核 int-wire-clip.log）。
记录能被消费也必须能被发射。client 的 P4a family gate 和 server 的 NoP4aConsumer
原来都绑在 buffer resource-ops 上，而 Magma 没有该 ops。本包改为 client 查询该 family
的已发布 consumer bit、server 接受其 object records；残余 fill memo 加 caps generation。
Magma 仍不发布 buffer resources bit 7；发布 indexed-binding bit 13，用记录辨别未绑定与 P7 buffer 债。
texture staged bytes 原本也只由 GLES 的 resource-ops hook 采纳，本包补无 hook 时的 server-owned
adoption、respecify/defined-ness、destroy/release，保留有 hook 的 Espryt 路径避免双采纳。
2. 九字段与邻接字段
| 字段 | Magma transport 的现在来源 / 边界 |
|---|---|
| GetBoundVertexArray | SetupWireDraw 读 BoundVertexElements / VertexElementsCsos；无数组与 current generic attribute 正常画；实际读取 enabled array 时在 client 读前具名 buffer-legacy-arm（P7）。 |
| GetBufferBindingPoint | UniformManager 读 BoundShaderBuffers 判断绑定；已存在的无绑定 native buffer placeholder 保留，有真实 SSBO/UBO buffer 时具名 buffer-legacy-arm。XFB capture 同样在读取前端绑定前拒绝。 |
| GetFramebufferBindingSlot | WireFramebuffer.inc 的 clear/blit/read/copy 与 WireDraw.inc / pipeline builder 全读 framebuffer record / MGPSurface。 |
| GetImageTextureBinding | UniformManager 读 BoundShaderImages；native image view 与 sampler 使用 server resource record。 |
| GetTextureUnitObject | sampler 读 BoundSamplerViews / BoundSamplerStates；mipmap 与 framebuffer-copy 读各 verb handle。 |
| GetProgramForDraw | MagmaProgramSource(handle, ShaderCsoRecord)；SPIR-V / reflection 来自 Archive，可变绑定和 global UBO 来自记录尾部。 |
| GetProgramForDispatch | 同一 source，以 DispatchProgram 句柄选择 compute program。 |
| GetTransformFeedbackProgram | 无 XFB draw 不进该读点；active XFB capture 在 wire setup 的 P7 buffer 边界具名拒绝。本包没有宣称 Magma 的 XFB capture 已可用。 |
| GetTextureObject | handle-keyed VkTextureManager 完成 sync，无 GL-name / client weak_ptr 查询。 |
邻接项：GetBufferBindingPointCount 不再被 wire uniform 路径读取；HasOpenTransformFeedbackSpan
只留在 class-C query / P7 capture 子树。GetBufferBindingSlot 的 indirect wrappers 在第一处前端读取前
保持具名 P7 拒绝；server 生成的 LINE_LOOP indices 用 transient server bytes，普通无 buffer draw 不受影响。
ShaderStorageBlockBinding 用 VerbStorageBlockProgram 更新 server StorageOverrides，不再经
TryGetDirectVulkanProgram / ValidateProgramName / GetProgramObject 探 client 名表。
独立 fm 的全局 FieldOwnership 分类仍保留 15 个 BARRIER_PULLED 字段；fe 集成后两个 scalar sticky
改为 APPLIER_DERIVED，仍余 13 个字段。其余对象行需在收口时与 residual-fill /
generator 的静态不变量一起归零，不是本包门绿后自动翻成 RECORD_SUPPLIED。
这里没有把“没有调用旧对象 getter”冒充“旧 SharedPtr 字段已由记录填充”。FieldOwnership.def 已加该说明。
RecordError 的反向通道归 fv；PipeInputs::IsLive() 仍 forward 到 LiveContext()，也是
未退役的 client liveness 读取，留给 fv / 阶段收口核对；均未在本包领取完成。
Program source、descriptor 与发射约束
MagmaProgramSource 是仅在 disaggregated 构建存在的只读视图：monolith/internal-program
构造接 const ProgramObject&，wire 构造接 handle 和 server MGPipeShaderCsoRecord。
非 disaggregated 构建是原 ProgramObject 的类型别名，保持 pull 代码形态。
SPIR-V、linked stages、uniform/block/XFB reflection 来自 ProgramArchive；BlockBindings、
SamplerUnits、StorageOverrides、GlobalConstants 来自当前记录，后者覆盖 archive 的旧值。
全局 UBO 字节与版本不再问 client，SSBO 索引沿用旧 SPIR-V reflection 的排序规则。
server 视图不使用或写回 ProgramObject 的 hash memo：每次按当前 archive/绑定尾部算 hash，
编译产物仍由 ProgramFactory 的 server cache 复用。按内容进一步缓存 hash 属性能工作，
本包没有以共享 client memo 换取“快”。draw 和 dispatch 各自从记录选 program；普通
无 buffer draw 支持 current generic attributes，gl_InstanceID 的既有 SPIR-V rebase 保留。
sampler/image descriptor 消费 BoundSamplerViews / BoundSamplerStates / BoundShaderImages，
以 server texture record 创建原生 image view、按 record sampler 参数创建 sampler；view 的
mip/layer window、format alias、swizzle 与隐式 alpha 按记录恢复。真实 buffer/texel-buffer
消费者仍在前端解引用前具名拒绝。无绑定 image 所需的 frontend placeholder 则明确报
Fatal{UnmigratedVerb, "Magma:unbound-image-placeholder@P7"}，不是构造 client 对象来兜底。
vertex-input 的发射不受 Magma 缺 bit 7 的牵连：NewVertexElements 属 bit 8，P4a 的
consumer/dependency gate 只管该阶段的四个 object families。server 因而能区分 enabled array
与 current attributes；wire 缺少 vertex-elements record 会具名拒绝，不能静默当空 VAO。
CapsMirrorTest.ObjectFamilyEmissionTracksIndependentConsumerCapsWithoutBufferOps 在同一
子进程中采用 Texture-only → Framebuffer-only → Texture-only 三个
snapshot；buffer bit 始终为 0，逐次断言真实 MGPipeP4aFamilyEmits 的正反变化。
当前对象行仍被 BARRIER_PULLED 分类支配，测试没有假造 SuppliedFieldMask 的值变化；
caps generation 是该环境缓存的失效键，也是后续归属表收口必须保留的条件。
3. T5 与三类结构耦合
- T5：mipmap 使用
VerbMipRes/BaseLevel/LevelCount，只改 server image / staged shadow；upload-target 集合由 resource descriptor 推导，view window 从ViewOf/ sampler-view record 解析。无 client texture unit、upload-target vector 或 mip-level storage 写入。 - texture twin / memo：独立
std::unordered_map以{slot, gen}为键；dead-generation prune、shutdown 清理；shape 重建保留旧 GPU 内容。pending-upload 只上传指定 regions，避免 CPU 旧影子覆盖 GPU clear/blit/mipmap 后未改区域。失败上传不推进 synced serial。 - program twin：
MagmaProgramSource在非 disaggregated 编译下是ProgramObject别名，在 split 下按值引用 server archive/record；GetBackendHashMemo/SetBackendHashMemo不再写 client 对象。 - server 构造 client 类型：wire clear/blit/mipmap/draw 使用 native image/view/framebuffer/render-pass，sampler 从
SamplerParameters构造；不走隐藏 ShaderObject/ProgramObject/SamplerObject 或前端 texture placeholder 构造。原 frontend placeholder 的 allocator 边界显式改写为上节的具名 P7 拒绝，未装成新可用功能。 - buffer twin / 直写：真实前端 BufferObject 的 backing resource、mapped bytes、EnsureGpuResident 等仅留 monolith 或既有 P7 拒绝之后；
ResourceTracker.h的 GPU-written fallback 归 fv，没有改。
CopyImageEndpoint.TextureHandle / VerbStorageBlockProgram 与 fe 采用相同 seam。
为独立 fm 门可运行，同时带入 fe 的 GLES CopyImage endpoint 接线和 shared readback helper 的 server reply-scratch
分支；集成保留同一份，不重复计算为两份迁移。
新 draw render-pass 仍沿用既有正确性规则：sRGB attachment 随 GL_FRAMEBUFFER_SRGB
选择 sRGB/UNORM 写 view；1D/1D-array storage 保留相应 view 类型；各 attachment 使用
GENERAL layout 与 descriptor 一致。旧 pass/framebuffer/view 退休前等待已提交 GPU 工作完成。
每次 command buffer 重开均经 FrameContext observer 重置 dynamic-state shadow，viewport、
scissor、blend/stencil 等不会因连续 draw 的相同值而漏发。此处选择正确性优先的提交/等待，
不声称完成 P7 的批处理性能设计。
staged store 的 hookless 路径与 GLES hook 二选一，绝不双 Adopt。named respecify 定义对应 mip（包含 null-data），whole immutable respecify 重定义完整链，destroy 删除 handle key， object-record release 清空；make-current reset 保留仍活对象的数据。
4. 出口门 4 的回答
Magma 不发布 kCapRunAheadApply。 无 buffer draw / compute、framebuffer、texture 诸实际可达路径
以与 Espryt 相同的 role-split + strict 机制验证；分块时旧 client pointers 根本不在 server 块里，lockstep 不能
掩盖这些读取。真实 buffer consumers、host-texel placeholders 和少量 native format/function shapes 仍是 P7 功能债。
新 wire render-pass 为保证对象退休正确，提交后等待 queue 完成才销毁，尚未建立 run-ahead 的资源版本和性能契约。
此外 IsLive forward、fv 剩余反向写入与完整字段归属收口仍未完成，不能把当前已测工作集
扩大成“全 server apply 路径已满足 run-ahead”的能力承诺。保留 lockstep 是能力声明；
不把它当跨角色读写的豁免。MagmaPipeIdentityTest.AMagmaServerNeverPublishesTheRunAheadCapBit
分别对 ready=false/true 固定 Magma 的回答为不发布，避免随 Espryt readiness 翻转而误开启。
R11F_G11F_B10F 的 mip blit 是已实测的原有功能债：f1 基线真实 inproc 下
F1WireScenario.GenerateMipmapPackedFloatPixels 像素失败，RGB 都为 0（fm-base-packed.log）。
本包对应失败为 Fatal{UnmigratedVerb, "Magma:mipmap-native-format@P7"}；新增 Magma 同名测试留在
integration-magma-p7-known-red，CI 强制恰一条实际执行、failure 非 skip、私有日志精确含该 marker。
它不加入双块 field-fatal 棘轮；原 Espryt case 与所有既有测试名保留。
5. 门与 red-once
验证数字将在最后一轮运行后补齐。已完成的独立证据：
- 无 buffer ClipDistance：baseline 共享块绿 / fm 双块 strict 绿。
- Program source 单测 3/3；临时退回 archive 旧 binding 值，
MagmaProgramSourceTest.ServerBindingTailsReplaceLinkTimeDefaults真红（旧值 9 分别不等于记录值 3/6）；健康源码 3/3 绿（fm-program-source-tests.log/fm-program-source-red-once.log）。这份证据为独立临时 object/executable 执行；最终集成 unit 门仍单列核对。 StagedTextureProductionTest.HooklessTextureConsumerOwnsBytesAndScopedStorageLifetime：旧 metadata-only 条件吞 named null-data mip，level-1 extent 为 0 导致真红；修复后 1/1 绿（集成者int-fm-staging-red-once.log/int-fm-staging-green.log）。- G1 pull 已测 checkpoint：
.text10806051 → 10806051；defined symbols 27815 → 27815；0 added / 0 removed / 0 resized / 0 renamed（fm-g1-final.log）。最后新增代码后的确认由下表更新。 - flavours 已测 checkpoint：pull / push 生效宏与构建通过；独立 unit 首轮 2266/2266、0 failed（10 个宏/平台基线 skip；该次尚不含后来加入的 caps case）。
- generator check/self-test、include closure 已绿；doc citations 只有与 f1 相同的两处既有 basename 歧义。
最终门记录（门禁执行者填入最终头与对应日志，不从上述 checkpoint 推算）：
| 门 | 最终结果 |
|---|---|
| 最终代码头 / build | 待最后一轮结果 |
| unit / integration-split | 待最后一轮结果 |
| Magma 双块 + strict | 待最后一轮结果；新 sampler/uniform、compute image-store 场景也必须实际执行 |
| 双块 Fatal 棘轮 | 待集成复测：fm 要退役 GetFramebufferBindingSlot@Clear；独立 fm 的其它 Espryt 首阻塞仍归 fe，不追加新预期对 |
| integration-gpu | 待集成门结果 |
| pull / push / G1 / G2 / G14 | 待最后一轮确认 |
| packed-format known-red | 待最后一轮精确 marker 核对；不是 skip，也不是双块字段 Fatal |
strict、双块与 gpu 会覆盖同一测试的私有日志，串行运行并保存各自摘要；后跑车道的日志 不能拿来替前一车道补证。新增 scenario 名集合保留既有测试，known-red 专门车道也必须实际 执行并验证自己的失败原因，避免通过移标签隐藏回归。
设备门未执行：当前没有 Redmi 2f7cbe2e；该项由阶段收口记录，不能由 host lavapipe 结果代替。