From 0e8ece64c31830885e2131015e66b9f719b8e6ba Mon Sep 17 00:00:00 2001
From: Doar Mihai <mihai@invata-progremare.ro>
Date: Sun, 28 Jun 2026 16:18:06 +0300
Subject: [PATCH] fix: add PHPDoc blocks and remove unused import in nerve
 service/commands

---
 app/Console/Commands/Game/NerveMidnightRefill.php | 3 +++
 app/Services/Game/NerveService.php                | 9 +++++++++
 2 files changed, 12 insertions(+)

diff --git a/app/Console/Commands/Game/NerveMidnightRefill.php b/app/Console/Commands/Game/NerveMidnightRefill.php
index 6814e85..4da9307 100644
--- a/app/Console/Commands/Game/NerveMidnightRefill.php
+++ b/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...');
diff --git a/app/Services/Game/NerveService.php b/app/Services/Game/NerveService.php
index 8e5bbaa..071f901 100644
--- a/app/Services/Game/NerveService.php
+++ b/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'))