refactor(vulkan): start phase a pass recorder extraction

Author: lmitchell137

docs/capability-contract-phaseA-pass-recorder-checklist.md

@@ -0,0 +1,24 @@
+# Capability Migration Phase A Checklist (Pass Recorder Extraction)
+
+Scope date: 2026-02-19  
+Scope target: structural extraction only, zero behavior change
+
+## 1. Orchestrator delegation
+
+- [x] Extract shadow/main recording behind feature-owned recorder facade.
+- [x] Extract post composite recording behind feature-owned recorder facade.
+- [x] Keep existing recorder logic and pass order unchanged.
+
+## 2. Behavior boundary
+
+- [x] No graph/runtime behavior changes.
+- [x] No shader/descriptor wiring changes.
+
+## 3. Validation
+
+- [x] Run targeted Vulkan test slice after extraction.
+
+## 4. Next
+
+- [ ] Decompose post composite wrapper into module-level recorder boundaries.
+- [ ] Decompose reflection/AA recorder boundaries for graph-ready ownership.

docs/capability-contract-phaseA-pass-recorder-extraction.md

@@ -0,0 +1,27 @@
+# Capability Migration Phase A: Pass Recorder Extraction
+
+Date: 2026-02-19  
+Status: Started (AA/post + shadow/main recorder facades extracted)
+
+## Goal
+
+Extract feature-owned pass recorders with zero rendering behavior change.
+
+## Delivered in this slice
+
+- Added `VulkanShadowMainPassRecorder` wrapper for shadow/main recording.
+- Added `VulkanPostCompositePassRecorder` wrapper for post composite recording.
+- Updated `VulkanFrameCommandOrchestrator` to delegate to these recorders.
+
+## Behavior boundary
+
+- Recording logic still executes through existing `VulkanRenderCommandRecorder`.
+- No pass ordering changes.
+- No shader/descriptor/runtime behavior changes.
+
+## Next in Phase A
+
+- Split wrappers into per-feature ownership boundaries aligned with capability catalog:
+  - post modules (tonemap/bloom/ssao/smaa/taa/fog)
+  - reflection module recorder boundary
+  - AA resolve recorder boundary

docs/capability-contract-v1-plan.md

@@ -49,3 +49,9 @@ Scope: post-reflections sequencing kickoff
 - Post modularization activation/planning artifacts are tracked in:
   - `docs/capability-contract-phase3-post-modularization.md`
   - `docs/capability-contract-phase3-post-modularization-checklist.md`
+
+## Phase A status
+
+- Pass-recorder extraction kickoff artifacts are tracked in:
+  - `docs/capability-contract-phaseA-pass-recorder-extraction.md`
+  - `docs/capability-contract-phaseA-pass-recorder-checklist.md`

engine-impl-vulkan/src/main/java/org/dynamislight/impl/vulkan/command/VulkanFrameCommandOrchestrator.java

@@ -11,6 +11,9 @@
 import java.util.function.IntUnaryOperator;
 
 public final class VulkanFrameCommandOrchestrator {
+    private static final VulkanShadowMainPassRecorder SHADOW_MAIN_RECORDER = new VulkanShadowMainPassRecorder();
+    private static final VulkanPostCompositePassRecorder POST_COMPOSITE_RECORDER = new VulkanPostCompositePassRecorder();
+
     private VulkanFrameCommandOrchestrator() {
     }
 
@@ -49,7 +52,7 @@ public static void record(
             ));
         }
 
-        VulkanRenderCommandRecorder.recordShadowAndMainPasses(
+        SHADOW_MAIN_RECORDER.record(
                 stack,
                 commandBuffer,
                 new VulkanRenderCommandRecorder.RenderPassInputs(
@@ -90,7 +93,7 @@ public static void record(
         );
 
         if (inputs.postOffscreenActive()) {
-            VulkanRenderCommandRecorder.PostCompositeState postInitialized = VulkanRenderCommandRecorder.executePostCompositePass(
+            VulkanRenderCommandRecorder.PostCompositeState postInitialized = POST_COMPOSITE_RECORDER.record(
                     stack,
                     commandBuffer,
                     new VulkanRenderCommandRecorder.PostCompositeInputs(

engine-impl-vulkan/src/main/java/org/dynamislight/impl/vulkan/command/VulkanPostCompositePassRecorder.java

@@ -0,0 +1,23 @@
+package org.dynamislight.impl.vulkan.command;
+
+import org.lwjgl.system.MemoryStack;
+import org.lwjgl.vulkan.VkCommandBuffer;
+
+/**
+ * Feature-owned recorder facade for post composite execution.
+ *
+ * This is a Phase A extraction wrapper with no behavior changes.
+ */
+final class VulkanPostCompositePassRecorder {
+    VulkanRenderCommandRecorder.PostCompositeState record(
+            MemoryStack stack,
+            VkCommandBuffer commandBuffer,
+            VulkanRenderCommandRecorder.PostCompositeInputs inputs
+    ) {
+        return VulkanRenderCommandRecorder.executePostCompositePass(
+                stack,
+                commandBuffer,
+                inputs
+        );
+    }
+}

engine-impl-vulkan/src/main/java/org/dynamislight/impl/vulkan/command/VulkanShadowMainPassRecorder.java

@@ -0,0 +1,29 @@
+package org.dynamislight.impl.vulkan.command;
+
+import java.util.List;
+import java.util.function.IntUnaryOperator;
+import org.lwjgl.system.MemoryStack;
+import org.lwjgl.vulkan.VkCommandBuffer;
+
+/**
+ * Feature-owned recorder facade for shadow + main geometry pass execution.
+ *
+ * This is a Phase A extraction wrapper with no behavior changes.
+ */
+final class VulkanShadowMainPassRecorder {
+    void record(
+            MemoryStack stack,
+            VkCommandBuffer commandBuffer,
+            VulkanRenderCommandRecorder.RenderPassInputs inputs,
+            List<VulkanRenderCommandRecorder.MeshDrawCmd> meshes,
+            IntUnaryOperator dynamicUniformOffset
+    ) {
+        VulkanRenderCommandRecorder.recordShadowAndMainPasses(
+                stack,
+                commandBuffer,
+                inputs,
+                meshes,
+                dynamicUniformOffset
+        );
+    }
+}