update comments for methods

Author: michalsn

system/CLI/SignalTrait.php

@@ -24,41 +24,41 @@
 trait SignalTrait
 {
     /**
-     * Whether the process should continue running (false = termination requested)
+     * Whether the process should continue running (false = termination requested).
      */
     private bool $running = true;
 
     /**
-     * Whether signals are currently blocked
+     * Whether signals are currently blocked.
      */
     private bool $signalsBlocked = false;
 
     /**
-     * Array of registered signals
+     * Array of registered signals.
      *
      * @var list<int>
      */
     private array $registeredSignals = [];
 
     /**
-     * Signal-to-method mapping
+     * Signal-to-method mapping.
      *
      * @var array<int, string>
      */
     private array $signalMethodMap = [];
 
     /**
-     * Cached result of PCNTL extension availability
+     * Cached result of PCNTL extension availability.
      */
     private static ?bool $isPcntlAvailable = null;
 
     /**
-     * Cached result of POSIX extension availability
+     * Cached result of POSIX extension availability.
      */
     private static ?bool $isPosixAvailable = null;
 
     /**
-     * Check if PCNTL extension is available (cached)
+     * Check if PCNTL extension is available (cached).
      */
     protected function isPcntlAvailable(): bool
     {
@@ -77,7 +77,7 @@ protected function isPcntlAvailable(): bool
     }
 
     /**
-     * Check if POSIX extension is available (cached)
+     * Check if POSIX extension is available (cached).
      */
     protected function isPosixAvailable(): bool
     {
@@ -89,7 +89,7 @@ protected function isPosixAvailable(): bool
     }
 
     /**
-     * Register signal handlers
+     * Register signal handlers.
      *
      * @param list<int>          $signals   List of signals to handle
      * @param array<int, string> $methodMap Optional signal-to-method mapping
@@ -129,7 +129,7 @@ protected function registerSignals(
     }
 
     /**
-     * Handle incoming signals
+     * Handle incoming signals.
      */
     protected function handleSignal(int $signal): void
     {
@@ -158,8 +158,8 @@ protected function handleSignal(int $signal): void
     }
 
     /**
-     * Call custom signal handler if one is mapped for this signal
-     * Falls back to generic onInterruption() method if no explicit mapping exists
+     * Call custom signal handler if one is mapped for this signal.
+     * Falls back to generic onInterruption() method if no explicit mapping exists.
      */
     private function callCustomHandler(int $signal): void
     {
@@ -179,31 +179,31 @@ private function callCustomHandler(int $signal): void
     }
 
     /**
-     * Check if command should terminate
+     * Check if command should terminate.
      */
     protected function shouldTerminate(): bool
     {
         return ! $this->running;
     }
 
     /**
-     * Check if the process is currently running (not terminated)
+     * Check if the process is currently running (not terminated).
      */
     protected function isRunning(): bool
     {
         return $this->running;
     }
 
     /**
-     * Request immediate termination
+     * Request immediate termination.
      */
     protected function requestTermination(): void
     {
         $this->running = false;
     }
 
     /**
-     * Reset all states (for testing or restart scenarios)
+     * Reset all states (for testing or restart scenarios).
      */
     protected function resetState(): void
     {
@@ -216,7 +216,7 @@ protected function resetState(): void
     }
 
     /**
-     * Execute a callable with ALL signals blocked to prevent ANY interruption during critical operations
+     * Execute a callable with ALL signals blocked to prevent ANY interruption during critical operations.
      *
      * This blocks ALL interruptible signals including:
      * - Termination signals (SIGTERM, SIGINT, etc.)
@@ -244,8 +244,8 @@ protected function withSignalsBlocked(Closure $operation)
     }
 
     /**
-     * Block ALL interruptible signals during critical sections
-     * Only SIGKILL (unblockable) can terminate the process
+     * Block ALL interruptible signals during critical sections.
+     * Only SIGKILL (unblockable) can terminate the process.
      */
     protected function blockSignals(): void
     {
@@ -262,7 +262,7 @@ protected function blockSignals(): void
     }
 
     /**
-     * Unblock previously blocked signals
+     * Unblock previously blocked signals.
      */
     protected function unblockSignals(): void
     {
@@ -279,23 +279,23 @@ protected function unblockSignals(): void
     }
 
     /**
-     * Check if signals are currently blocked
+     * Check if signals are currently blocked.
      */
     protected function signalsBlocked(): bool
     {
         return $this->signalsBlocked;
     }
 
     /**
-     * Add or update signal-to-method mapping at runtime
+     * Add or update signal-to-method mapping at runtime.
      */
     protected function mapSignal(int $signal, string $method): void
     {
         $this->signalMethodMap[$signal] = $method;
     }
 
     /**
-     * Get human-readable signal name
+     * Get human-readable signal name.
      */
     protected function getSignalName(int $signal): string
     {
@@ -315,7 +315,7 @@ protected function getSignalName(int $signal): string
     }
 
     /**
-     * Unregister all signals (cleanup)
+     * Unregister all signals (cleanup).
      */
     protected function unregisterSignals(): void
     {
@@ -332,15 +332,15 @@ protected function unregisterSignals(): void
     }
 
     /**
-     * Check if signals are registered
+     * Check if signals are registered.
      */
     protected function hasSignals(): bool
     {
         return $this->registeredSignals !== [];
     }
 
     /**
-     * Get list of registered signals
+     * Get list of registered signals.
      *
      * @return list<int>
      */
@@ -350,7 +350,7 @@ protected function getSignals(): array
     }
 
     /**
-     * Get comprehensive process state information
+     * Get comprehensive process state information.
      *
      * @return array<string, mixed>
      */