qvm: trace final restore gate

docs/ASSET_PIPELINE_TODO.md

@@ -568,3 +568,6 @@ Research progress: RE-628 [report](research/QVM_TRACE_RELINK.md); remaining nati
 
 
 Research progress: RE-629 [report](research/QVM_TRACE_BOUNDS_RESTORE.md); remaining native/content/runtime/platform scope stays open.
+
+
+Research progress: RE-630 [report](research/QVM_TRACE_FINALIZE.md); remaining native/content/runtime/platform scope stays open.

docs/FINDINGS.md

@@ -920,3 +920,6 @@ Bounded qagame paths recover bomb-plant/inactivity correction requests, direct f
 
 
 **RE-629 — Candidate bound restoration and f32 round-trip limits:** The restoration suffix repeats eligibility gates, reverses bound arithmetic and writes fixed ±15 dimensions rather than restoring a saved record. [Evidence](research/QVM_TRACE_BOUNDS_RESTORE.md).
+
+
+**RE-630 — Shooter restoration gate final link and trace return:** The trace suffix requests144413 only for client shooters without424 bit8 and mode exactly1; otherwise it links the shooter and returns local96. [Evidence](research/QVM_TRACE_FINALIZE.md).

docs/PROVISIONAL_TODO.md

@@ -888,3 +888,6 @@ Research progress: RE-628 [report](research/QVM_TRACE_RELINK.md); remaining nati
 
 
 Research progress: RE-629 [report](research/QVM_TRACE_BOUNDS_RESTORE.md); remaining native/content/runtime/platform scope stays open.
+
+
+Research progress: RE-630 [report](research/QVM_TRACE_FINALIZE.md); remaining native/content/runtime/platform scope stays open.

docs/RESEARCH_LEDGER.md

@@ -822,3 +822,8 @@ The skipped-target cleanup issues native−31 in insertion order and preserves d
 ## 2026-10-20 — RE-629 Candidate bound restoration and f32 round-trip limits (separate task commit)
 
 The restoration suffix repeats eligibility gates, reverses bound arithmetic and writes fixed ±15 dimensions rather than restoring a saved record. Six canonical/arbitrary/large-magnitude fixtures independently compare all six candidate records and demonstrate exact and lossy round trips. Full suite: 1001 tests pass. Report regenerates byte-identically (647300 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.
+
+
+## 2026-10-20 — RE-630 Shooter restoration gate final link and trace return (separate task commit)
+
+The trace suffix requests144413 only for client shooters without424 bit8 and mode exactly1; otherwise it links the shooter and returns local96. 24 client/flag/mode/result combinations independently verify the exact gate, native link request and numeric return. Full suite: 1004 tests pass. Report regenerates byte-identically (28647 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.

docs/REVERSE_ENGINEERING_TODO.md

@@ -931,3 +931,6 @@ Purpose: turn the supplied installation into an evidence-backed specification of
 
 
 - [x] RE-629 Candidate bound restoration and f32 round-trip limits ([report](research/QVM_TRACE_BOUNDS_RESTORE.md)).
+
+
+- [x] RE-630 Shooter restoration gate final link and trace return ([report](research/QVM_TRACE_FINALIZE.md)).

docs/research/QVM_TRACE_FINALIZE.md

@@ -0,0 +1,7 @@
+# Shooter restoration gate final link and trace return
+
+RE-630. Reproduce with `python3 scripts/analyze_qvm_trace_finalize.py`; check with `python3 scripts/test_qvm_trace_finalize.py`. The [machine report](qvm-trace-finalize.json) retains source identity and bounded fixtures.
+
+Actual292504–292542 reads shooter client presence, record424 bit8 and argument mode176. Only non-null client, bit8 clear and mode==1 reaches144413; mode2 does not. The report suspends before that unknown helper. All other cases issue captured native−31 for the shooter and return the existing local96 without reinterpretation as successful hit/damage. Result fixtures0/1 test direct return propagation only. No engine relinking or rewind effect executes, and pending restore paths neither link nor fabricate a child return.
+
+No original executable/full QVM/native collision/physics/rendering executes. Native responses and legal input domains are supplied or unverified where stated; full runtime/macOS/Linux Rust/Bevy/Solari gameplay remains open.

docs/research/README.md

@@ -489,3 +489,6 @@ The extension collector adds five focused tests for native tail calls, command-r
 
 
 [RE-629: Candidate bound restoration and f32 round-trip limits](QVM_TRACE_BOUNDS_RESTORE.md). Reproduce with `python3 scripts/analyze_qvm_trace_bounds_restore.py`; check with `python3 scripts/test_qvm_trace_bounds_restore.py`.
+
+
+[RE-630: Shooter restoration gate final link and trace return](QVM_TRACE_FINALIZE.md). Reproduce with `python3 scripts/analyze_qvm_trace_finalize.py`; check with `python3 scripts/test_qvm_trace_finalize.py`.

docs/research/qvm-trace-finalize.json

@@ -0,0 +1,1261 @@
+{
+  "limits": "Actual292504\u2013292542, or stop before144413. Native\u221231 captured, numeric return is supplied prior local96 state, not hit validation. Rewind restoration remains unrecovered in this report.",
+  "probes": [
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 0,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 0,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 1,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 1,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 2,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 2,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 0,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 0,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 1,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 1,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 2,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 20,
+        "trace_sha256": "f9997b671d2cbd689018d9105697540d8932e370e5f283e2130878ba6d90c9ef"
+      },
+      "initial": {
+        "client": 0,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 2,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 33,
+        "trace_sha256": "862f50957f2b7792ff87fc8c171a0da11bb6af51bbb7ce189f1f4407c0b37474"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 0,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 33,
+        "trace_sha256": "862f50957f2b7792ff87fc8c171a0da11bb6af51bbb7ce189f1f4407c0b37474"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 0,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [],
+        "children": [],
+        "return": null,
+        "stop": 292528,
+        "trace": null,
+        "trace_length": 24,
+        "trace_sha256": "14137c822ce71fbcaebd4a3c084658ca90e0fcdf910df4f5981c9763d6124ff6"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 1,
+        "result96": 0
+      },
+      "pending_call": {
+        "arguments": {
+          "8": 34147688
+        },
+        "target": 144413
+      },
+      "requests": [],
+      "status": "rewind-restore-pending"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [],
+        "children": [],
+        "return": null,
+        "stop": 292528,
+        "trace": null,
+        "trace_length": 24,
+        "trace_sha256": "14137c822ce71fbcaebd4a3c084658ca90e0fcdf910df4f5981c9763d6124ff6"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 1,
+        "result96": 1
+      },
+      "pending_call": {
+        "arguments": {
+          "8": 34147688
+        },
+        "target": 144413
+      },
+      "requests": [],
+      "status": "rewind-restore-pending"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 33,
+        "trace_sha256": "862f50957f2b7792ff87fc8c171a0da11bb6af51bbb7ce189f1f4407c0b37474"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 2,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 33,
+        "trace_sha256": "862f50957f2b7792ff87fc8c171a0da11bb6af51bbb7ce189f1f4407c0b37474"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 0,
+        "mode": 2,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 29,
+        "trace_sha256": "b6fb47fc222679ae6e11f3066f034f59de6da0f6bfe8517af89ff809ac8d5865"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 0,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 29,
+        "trace_sha256": "b6fb47fc222679ae6e11f3066f034f59de6da0f6bfe8517af89ff809ac8d5865"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 0,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 29,
+        "trace_sha256": "b6fb47fc222679ae6e11f3066f034f59de6da0f6bfe8517af89ff809ac8d5865"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 1,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 29,
+        "trace_sha256": "b6fb47fc222679ae6e11f3066f034f59de6da0f6bfe8517af89ff809ac8d5865"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 1,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 0,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 29,
+        "trace_sha256": "b6fb47fc222679ae6e11f3066f034f59de6da0f6bfe8517af89ff809ac8d5865"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 2,
+        "result96": 0
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    },
+    {
+      "execution": {
+        "byte_writes": [],
+        "calls": [
+          {
+            "args": {
+              "8": 34147688
+            },
+            "instruction": 292538,
+            "target": -31
+          }
+        ],
+        "children": [
+          {
+            "call": {
+              "args": {
+                "8": 34147688
+              },
+              "instruction": 292538,
+              "target": -31
+            },
+            "effect": {
+              "arguments": {
+                "8": 34147688
+              },
+              "native_effect_not_executed": true
+            }
+          }
+        ],
+        "return": 1,
+        "stop": 292543,
+        "trace": null,
+        "trace_length": 29,
+        "trace_sha256": "b6fb47fc222679ae6e11f3066f034f59de6da0f6bfe8517af89ff809ac8d5865"
+      },
+      "initial": {
+        "client": 65536,
+        "entity": 34147688,
+        "flags424": 8,
+        "mode": 2,
+        "result96": 1
+      },
+      "pending_call": null,
+      "requests": [
+        {
+          "arguments": {
+            "8": 34147688
+          },
+          "native_effect_not_executed": true
+        }
+      ],
+      "status": "returned"
+    }
+  ],
+  "sha256": "a589351dfe517470a1b121dd2164714987d9e4577bf00c6486e1540035d7a79d",
+  "source": {
+    "archive": "zUrT43_qvm.pk3",
+    "archive_sha256": "b59bf0c5bedf11d50e0edd220da7eade96de40601e98ae14c54c819047df0796",
+    "member": {
+      "bytes": 983300,
+      "comment_hex": "",
+      "compressed_bytes": 246560,
+      "compression": 8,
+      "crc32": "98ea1768",
+      "create_system": 0,
+      "create_version": 63,
+      "date_time": [
+        2018,
+        6,
+        18,
+        22,
+        11,
+        50
+      ],
+      "directory": false,
+      "entry_index": 2,
+      "external_attr": 32,
+      "extra_hex": "0a0020000000000001001800d1e24e974007d40116dcbf962f1fd20116dcbf962f1fd201",
+      "extract_version": 20,
+      "flags": 0,
+      "header_offset": 221309,
+      "internal_attr": 0,
+      "occurrence": 0,
+      "output": "assets/extracted/zUrT43_qvm.pk3/members/000002/vm/qagame.qvm",
+      "path": "vm/qagame.qvm",
+      "sha256": "a589351dfe517470a1b121dd2164714987d9e4577bf00c6486e1540035d7a79d",
+      "type": "member",
+      "volume": 0
+    }
+  }
+}

scripts/analyze_qvm_trace_finalize.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+"""Shooter rewind-restore gate, final native link request and numeric return."""
+import itertools
+from pathlib import Path
+from qvm_research_support import source,execute
+from analyze_qvm_shot_trace_request import fixture,LOCAL
+from analyze_qvm import write_json
+
+def finalize(ins,m):
+    p=m[LOCAL+152];initial={'entity':p,'client':m[p+520],'flags424':m[p+424],'mode':m[LOCAL+176],'result96':m[LOCAL+96]};requests=[]
+    def link(i,m,a,c):e={'arguments':a,'native_effect_not_executed':True};requests.append(e);return m,c,0,e
+    m,_,e=execute(ins,292504,292543,m,(0,0,0),LOCAL,{-31:link},boundaries=[292528]);pending=e['stop']==292528
+    return m,{'initial':initial,'execution':e,'requests':requests,'status':'rewind-restore-pending' if pending else 'returned','pending_call':{'target':144413,'arguments':{8:p}} if pending else None}
+
+def main():
+    q,raw,h,ins=source();rows=[]
+    for client,flag,mode,result in itertools.product([False,True],[0,8],[0,1,2],[0,1]):
+        m,a=fixture(raw,h);p=a[8];m[p+520]=m[p+520] if client else 0;m[p+424]=flag;m.update({LOCAL+152:p,LOCAL+176:mode,LOCAL+96:result});rows.append(finalize(ins,m)[1])
+    write_json(Path('docs/research/qvm-trace-finalize.json'),{'source':q['source'],'sha256':q['sha256'],'probes':rows,'limits':'Actual292504–292542, or stop before144413. Native−31 captured, numeric return is supplied prior local96 state, not hit validation. Rewind restoration remains unrecovered in this report.'})
+if __name__=='__main__':main()

scripts/test_qvm_trace_finalize.py

@@ -0,0 +1,16 @@
+import json,unittest
+from pathlib import Path
+class TraceFinalizeTests(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):cls.r=json.loads(Path('docs/research/qvm-trace-finalize.json').read_text())
+    def test_independent_exact_mode_and_flags_gate(self):
+        self.assertEqual(len(self.r['probes']),24)
+        for p in self.r['probes']:
+            a=p['initial'];pending=bool(a['client'] and not(a['flags424']&8) and a['mode']==1);self.assertEqual(p['status'],'rewind-restore-pending' if pending else 'returned')
+    def test_numeric_result_and_single_shooter_link(self):
+        for p in self.r['probes']:
+            if p['status']=='returned':self.assertEqual(p['execution']['return'],p['initial']['result96']);self.assertEqual(p['requests'],[{'arguments':{'8':p['initial']['entity']},'native_effect_not_executed':True}]);self.assertEqual([c['target'] for c in p['execution']['calls']],[-31])
+    def test_pending_has_no_fabricated_child_return_or_link(self):
+        for p in self.r['probes']:
+            if p['status']=='rewind-restore-pending':self.assertIsNone(p['execution']['return']);self.assertEqual(p['requests'],[]);self.assertEqual(p['pending_call'],{'target':144413,'arguments':{'8':p['initial']['entity']}})
+if __name__=='__main__':unittest.main()