agent foundation

lib/Service/Scheduler/SchedulerRunService.php

@@ -160,6 +160,7 @@ class SchedulerRunService
             return $run;
         }
 
+        // markRunning uses a conditional update — failure means another process already claimed this job.
         $markedRunning = $this->scheduledJobRepository->markRunning($jobId, $startedAtUtc);
         if (!$markedRunning) {
             $this->insertRunLog([
@@ -268,6 +269,7 @@ class SchedulerRunService
         return $run;
     }
 
+    // Fail-open: a logging failure must not kill the job run that already completed.
     private function insertRunLog(array $data): void
     {
         try {