fix: add PHPDoc blocks and remove unused import in nerve service/commands

app/Console/Commands/Game/NerveMidnightRefill.php

@@ -10,6 +10,9 @@ class NerveMidnightRefill extends Command
     protected $signature = 'game:nerve-midnight-refill';
     protected $description = 'Refill nerve to max for all active characters at midnight';
 
+    /**
+     * Refill nerve to max_nerve for all active characters
+     */
     public function handle(NerveService $nerveService): void
     {
         $this->info('Running midnight nerve refill...');

app/Services/Game/NerveService.php

@@ -6,6 +6,9 @@ use App\Models\Character;
 
 class NerveService
 {
+    /**
+     * Consume nerve if character can act
+     */
     public function consume(Character $character, int $amount): bool
     {
         if (!$character->canAct()) {
@@ -15,6 +18,9 @@ class NerveService
         return $character->consumeNerve($amount);
     }
 
+    /**
+     * Regenerate nerve for a character
+     */
     public function regenerate(Character $character): void
     {
         $regenRate = config('game.nerve.regen_rate', 1);
@@ -26,6 +32,9 @@ class NerveService
         $character->addNerve($regenRate);
     }
 
+    /**
+     * Refill nerve to max for all active characters
+     */
     public function refillAll(): int
     {
         return Character::where('nerve', '<', \DB::raw('max_nerve'))