Fix: Abort and Show Error Message when Release Notes could not be placed

app/Actions/PasteReleaseNotesAtTheTop.php

@@ -5,6 +5,7 @@
 namespace App\Actions;
 
 use App\CreateNewReleaseHeading;
+use App\Exceptions\ReleaseNotesCanNotBeplacedException;
 use App\Exceptions\ReleaseNotesNotProvidedException;
 use App\MarkdownParser;
 use App\Queries\FindFirstSecondLevelHeading;
@@ -43,8 +44,10 @@ public function execute(string $latestVersion, ?string $releaseNotes, string $re
         if ($previousVersionHeading !== null) {
             // Insert the newest Release Notes before the previous Release Heading
             $previousVersionHeading->insertBefore($parsedReleaseNotes);
+        } elseif ($changelog->lastChild() !== null) {
+            $changelog->lastChild()->insertAfter($parsedReleaseNotes);
         } else {
-            $changelog->lastChild()?->insertAfter($parsedReleaseNotes);
+            throw new ReleaseNotesCanNotBeplacedException();
         }
 
         return $changelog;

app/Commands/UpdateCommand.php

@@ -6,6 +6,7 @@
 
 use App\Actions\AddReleaseNotesToChangelog;
 use App\Exceptions\ReleaseAlreadyExistsInChangelogException;
+use App\Exceptions\ReleaseNotesCanNotBeplacedException;
 use App\Exceptions\ReleaseNotesNotProvidedException;
 use App\Support\GitHubActionsOutput;
 use LaravelZero\Framework\Commands\Command;
@@ -55,14 +56,15 @@ public function handle(AddReleaseNotesToChangelog $addReleaseNotesToChangelog, G
                 compareUrlTargetRevision: $compareUrlTargetRevision
             );
             $this->info($updatedChangelog->getContent());
+
             $this->writeChangelogToFile($pathToChangelog, $updatedChangelog);
 
             return self::SUCCESS;
         } catch (ReleaseAlreadyExistsInChangelogException $exception) {
             $this->warn($exception->getMessage());
 
             return self::SUCCESS;
-        } catch (ReleaseNotesNotProvidedException $exception) {
+        } catch (ReleaseNotesNotProvidedException|ReleaseNotesCanNotBeplacedException $exception) {
             $this->error($exception->getMessage());
 
             return self::FAILURE;

app/Exceptions/ReleaseNotesCanNotBeplacedException.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Exceptions;
+
+use Exception;
+
+class ReleaseNotesCanNotBeplacedException extends Exception
+{
+    public function __construct()
+    {
+        parent::__construct("Release notes could not be placed. Is the CHANGELOG empty? Does it contain at least one heading?");
+    }
+}

tests/Feature/UpdateCommandTest.php

@@ -241,3 +241,24 @@
          ->expectsOutput('Release Notes were not provided. Pass them through the `--release-notes`-option.')
          ->assertFailed();
 });
+
+test('it shows warning if changelog is empty and content can not be placed', function () {
+    $this->artisan('update', [
+        '--release-notes' => <<<MD
+        ### Added
+        - New Feature A
+        - New Feature B
+
+        ### Changed
+        - Update Feature C
+
+        ### Removes
+        - Remove Feature D
+        MD,
+        '--latest-version' => 'v1.0.0',
+        '--path-to-changelog' => __DIR__ . '/../Stubs/empty-changelog.md',
+        '--compare-url-target-revision' => 'HEAD',
+    ])
+         ->expectsOutput('Release notes could not be placed. Is the CHANGELOG empty? Does it contain at least one heading?')
+         ->assertFailed();
+});