Release v1.2.4: restore 100% coverage for CI.

Author: HecFranco

docs/CHANGELOG.md

@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 ## Table of contents
 
 - [[Unreleased]](#unreleased)
+- [[1.2.4] - 2026-08-07](#124-2026-08-07)
 - [[1.2.3] - 2026-08-04](#123-2026-08-04)
 - [[1.2.2] - 2026-07-29](#122-2026-07-29)
 - [[1.2.1] - 2026-07-22](#121-2026-07-22)
@@ -18,6 +19,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.2.4] - 2026-08-07
+
+### Fixed
+- **CI:** restore **100%** line coverage for `LibreOfficeBinaryLocator` (empty candidate skip + empty-path guard).
+
+[1.2.4]: https://github.com/nowo-tech/WordToPdfBundle/releases/tag/v1.2.4
+
 ## [1.2.3] - 2026-08-04
 
 ### Fixed
@@ -129,7 +137,9 @@ First stable release.
 - System: **LibreOffice Writer** (`libreoffice-writer` / `soffice`) on the host or container
 - Demo image: FrankenPHP **PHP 8.4** (Symfony 8.1)
 
-[Unreleased]: https://github.com/nowo-tech/WordToPdfBundle/compare/v1.2.2...HEAD
+[Unreleased]: https://github.com/nowo-tech/WordToPdfBundle/compare/v1.2.4...HEAD
+[1.2.4]: https://github.com/nowo-tech/WordToPdfBundle/releases/tag/v1.2.4
+[1.2.3]: https://github.com/nowo-tech/WordToPdfBundle/releases/tag/v1.2.3
 [1.2.2]: https://github.com/nowo-tech/WordToPdfBundle/releases/tag/v1.2.2
 [1.2.1]: https://github.com/nowo-tech/WordToPdfBundle/releases/tag/v1.2.1
 [1.2.0]: https://github.com/nowo-tech/WordToPdfBundle/releases/tag/v1.2.0

docs/RELEASE.md

@@ -11,6 +11,8 @@ After creating the release commit and tag, run `make check-no-cursor-coauthor` a
 
 ## Table of contents
 
+- [Example for v1.2.4](#example-for-v124)
+- [Example for v1.2.3](#example-for-v123)
 - [Example for v1.2.2](#example-for-v122)
 - [Example for v1.2.1](#example-for-v121)
 - [Example for v1.2.0](#example-for-v120)
@@ -19,6 +21,40 @@ After creating the release commit and tag, run `make check-no-cursor-coauthor` a
 - [Example for v1.0.0](#example-for-v100)
 - [Sync missing releases](#sync-missing-releases)
 
+## Example for v1.2.4
+
+```bash
+git add -A
+git status   # review
+make release-check
+git -c core.hooksPath=.githooks commit -m "$(cat <<'EOF'
+Release v1.2.4: restore 100% coverage for CI.
+
+EOF
+)"
+git tag -a v1.2.4 -m "Release v1.2.4"
+make check-no-cursor-coauthor
+git push origin main
+git push origin v1.2.4
+```
+
+## Example for v1.2.3
+
+```bash
+git add -A
+git status   # review
+make release-check
+git -c core.hooksPath=.githooks commit -m "$(cat <<'EOF'
+Release v1.2.3: php-cs-fixer alignment in LibreOfficeBinaryLocator.
+
+EOF
+)"
+git tag -a v1.2.3 -m "Release v1.2.3"
+make check-no-cursor-coauthor
+git push origin main
+git push origin v1.2.3
+```
+
 ## Example for v1.2.2
 
 ```bash

docs/UPGRADING.md

@@ -3,6 +3,8 @@
 ## Table of contents
 
 - [Unreleased](#unreleased)
+- [To 1.2.4](#to-124)
+- [To 1.2.3](#to-123)
 - [To 1.2.2](#to-122)
 - [To 1.2.1](#to-121)
 - [To 1.2.0](#to-120)
@@ -15,6 +17,26 @@
 
 _Placeholder for the next release._
 
+## To 1.2.4
+
+No breaking public API changes. Safe to upgrade with:
+
+```bash
+composer update nowo-tech/word-to-pdf-bundle
+```
+
+### Behavioral notes (non-breaking)
+
+- **CI / tests:** additional unit coverage for empty LibreOffice candidate paths and the empty-path guard in `LibreOfficeBinaryLocator` (restores the 100% line coverage gate).
+
+### Breaking changes
+
+None.
+
+## To 1.2.3
+
+No breaking public API changes. Patch release for php-cs-fixer alignment only.
+
 ## To 1.2.2
 
 No breaking public API changes. Safe to upgrade with:

tests/Unit/Runtime/LibreOfficeBinaryLocatorTest.php

@@ -6,6 +6,7 @@
 
 use Nowo\WordToPdfBundle\Runtime\LibreOfficeBinaryLocator;
 use PHPUnit\Framework\TestCase;
+use ReflectionMethod;
 
 use const PATH_SEPARATOR;
 
@@ -66,4 +67,28 @@ public function testEmptyPathEnv(): void
         $locator = new LibreOfficeBinaryLocator([], '');
         self::assertNull($locator->locate());
     }
+
+    public function testLocateSkipsEmptyCandidatePaths(): void
+    {
+        $dir = sys_get_temp_dir() . '/wtp_cand_empty_' . uniqid('', true);
+        mkdir($dir);
+        $script = $dir . '/soffice';
+        file_put_contents($script, "#!/bin/sh\necho ok\n");
+        chmod($script, 0755);
+
+        try {
+            $locator = new LibreOfficeBinaryLocator(['', $script]);
+            self::assertSame($script, $locator->locate());
+        } finally {
+            @unlink($script);
+            @rmdir($dir);
+        }
+    }
+
+    public function testUsableNonEmptyPathRejectsEmptyString(): void
+    {
+        $locator = new LibreOfficeBinaryLocator([]);
+        $method  = new ReflectionMethod(LibreOfficeBinaryLocator::class, 'usableNonEmptyPath');
+        self::assertNull($method->invoke($locator, ''));
+    }
 }