From c054511b3e8e3a36741b50d50b4e9bf6e363f289 Mon Sep 17 00:00:00 2001
From: Durable Workflow <support@durable-workflow.com>
Date: Wed, 9 Sep 2026 19:54:46 +0000
Subject: [PATCH] Test cold upload recovery after committed SQLite lock
 pressure

---
 .../RuntimePayloadCompletionProcessTest.php   | 40 +++++++++++++++++--
 .../RuntimePayloadCompletionProcess.php       | 16 ++++++++
 2 files changed, 52 insertions(+), 4 deletions(-)

diff --git a/tests/Feature/RuntimePayloadCompletionProcessTest.php b/tests/Feature/RuntimePayloadCompletionProcessTest.php
index ea7180b2..11809ce8 100644
--- a/tests/Feature/RuntimePayloadCompletionProcessTest.php
+++ b/tests/Feature/RuntimePayloadCompletionProcessTest.php
@@ -43,18 +43,20 @@ public function test_concurrent_uploads_and_cold_retries_preserve_one_bounded_le
             self::assertFileExists($this->directory.'/'.$name.'.ready', $process->getErrorOutput());
         }
         touch($this->directory.'/go');
-        $a = $this->completedResult($first);
-        $b = $this->completedResult($second);
-        foreach ([$a, $b] as $response) {
+        $responses = ['alpha' => $this->completedResult($first), 'bravo' => $this->completedResult($second)];
+        foreach ($responses as $variant => $response) {
             if ($response['status'] === 503) {
                 self::assertSame('sqlite', $driver);
                 self::assertSame('backend_lock_pressure', $response['body']['reason']);
                 self::assertTrue($response['body']['retryable']);
+                // A reservation may commit before a later write hits lock pressure.
+                $responses[$variant] = $this->runProbe('upload', $kind, $variant);
             }
         }
+        [$a, $b] = array_values($responses);
         $statuses = [$a['status'], $b['status']];
         sort($statuses);
-        self::assertContains($statuses, [[201, 409], [201, 503]], json_encode([$a, $b]));
+        self::assertSame([201, 409], $statuses, json_encode($responses));
         $winner = $a['status'] === 201 ? 'alpha' : 'bravo';
         $loser = $winner === 'alpha' ? 'bravo' : 'alpha';
         $accepted = $a['status'] === 201 ? $a : $b;
@@ -79,6 +81,36 @@ public static function nativeDatabases(): array
         return [['mysql'], ['pgsql']];
     }
 
+    public static function completionKinds(): array
+    {
+        return [['activity'], ['workflow']];
+    }
+
+    #[DataProvider('completionKinds')]
+    public function test_cold_retry_recovers_a_committed_reservation_after_sqlite_lock_pressure(string $kind): void
+    {
+        $this->initialize('sqlite');
+        $this->runProbe('init', $kind);
+        $locked = $this->runProbe('upload-locked', $kind);
+        self::assertSame(503, $locked['status'], json_encode($locked));
+        self::assertSame('backend_lock_pressure', $locked['body']['reason']);
+        self::assertTrue($locked['body']['retryable']);
+        $reserved = $this->runProbe('status', $kind);
+
+        // The 503 did not undo the first byte identity or release its allowance.
+        self::assertSame(409, $this->runProbe('upload', $kind, 'bravo')['status']);
+        $accepted = $this->runProbe('upload', $kind);
+        self::assertSame(201, $accepted['status'], json_encode($accepted));
+        self::assertSame($accepted, $this->runProbe('upload', $kind));
+        $status = ['budgets' => 1, 'slots' => 1, 'objects' => 1,
+            'bytes' => $accepted['body']['reference']['size_bytes'], 'rows' => 1];
+        self::assertSame($status, $reserved);
+        self::assertSame($status, $this->runProbe('status', $kind));
+        self::assertSame(200, $this->runProbe('complete', $kind)['status']);
+        self::assertSame($accepted, $this->runProbe('upload', $kind));
+        self::assertSame($status, $this->runProbe('status', $kind));
+    }
+
     #[DataProvider('nativeDatabases')]
     public function test_independent_activity_budgets_can_be_created_concurrently(string $driver): void
     {
diff --git a/tests/Support/RuntimePayloadCompletionProcess.php b/tests/Support/RuntimePayloadCompletionProcess.php
index f58997be..63813738 100644
--- a/tests/Support/RuntimePayloadCompletionProcess.php
+++ b/tests/Support/RuntimePayloadCompletionProcess.php
@@ -11,6 +11,7 @@
 use Illuminate\Contracts\Console\Kernel;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Artisan;
+use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Queue;
 use Workflow\Serializers\Serializer;
 
@@ -87,6 +88,21 @@
         $action = 'upload';
         $slot = '0';
     }
+    if ($action === 'upload-locked') {
+        DB::statement('PRAGMA busy_timeout = 1');
+        $lock = null;
+        // Interrupt the final acknowledgement after both reservation and object commit.
+        RuntimeExternalPayload::saved(function (RuntimeExternalPayload $payload) use ($directory, &$lock): void {
+            if ($payload->upload_status !== RuntimeExternalPayload::UPLOAD_READY) {
+                return;
+            }
+            DB::afterCommit(function () use ($directory, &$lock): void {
+                $lock = new PDO('sqlite:'.$directory.'/database.sqlite');
+                $lock->exec('BEGIN IMMEDIATE');
+            });
+        });
+        $action = 'upload';
+    }
     if ($action === 'upload') {
         if ($slot !== '0') {
             if ($kind === 'activity') {