Add worker console messages (write/writeln) alongside ProgressBar

.github/workflows/ci-tests.yml

@@ -43,7 +43,7 @@ jobs:
       with:
         php-version: ${{ inputs.php }}
         extensions: ${{ env.extensions }}
-        ini-values: opcache.enable_cli=1, opcache.jit=tracing, opcache.jit_buffer_size=64M
+        ini-values: opcache.enable_cli=1, opcache.jit=off
         coverage: none
 
     - name: Install dependencies

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to **parallel-sdk** are documented in this file. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/).
 
+## Unreleased
+
+### Added
+- `ParallelWorker::write()` and `ParallelWorker::writeln()` methods to emit console messages from workers without them being overwritten by the ProgressBar.
+- `WriteOutputMessage` command to route `write()`/`writeln()` calls to the `Runner` coordinator.
+
+### Changed
+- ProgressBar and console-message handling is now owned directly by the `Runner` thread on a `stderr` `OutputInterface`, so `clear()`/`write()`/`display()` work correctly together without extra coordinator threads.
+
 ## `3.0.0` – 2025-07-04
 
 ### Added

README.md

@@ -321,6 +321,8 @@ Available methods are:
 - `setProgress(int $step)`
 - `display()`
 - `clear()`
+- `write(string $message, bool $newline = false)`
+- `writeln(string $message)`
 
 ```php
 use HDSSolutions\Console\Parallel\ParallelWorker;
@@ -332,6 +334,7 @@ final class ExampleWorker extends ParallelWorker {
         $microseconds = random_int(100, 500);
         $this->setMessage(sprintf("ExampleWorker >> Hello from task #%u, I'll wait %sms", $number, $microseconds));
         usleep($microseconds * 1000);
+        $this->writeln(sprintf("ExampleWorker >> Finished task #%u", $number));
         $this->advance();
         // end example process
 
@@ -349,6 +352,44 @@ final class ExampleWorker extends ParallelWorker {
  memory: 562 KiB, threads: 12x ~474 KiB, Σ 5,6 MiB ↑ 5,6 MiB
 ```
 
+#### Console messages
+
+Use `write()` or `writeln()` to emit ad-hoc console messages from a worker. When a ProgressBar is active, the bar is temporarily hidden, the message is printed, and the bar is redrawn below it so the message is not overwritten.
+
+These methods also work for workers that did not enable `withProgress()`; messages are then written directly to the console.
+
+```php
+use HDSSolutions\Console\Parallel\ParallelWorker;
+
+final class ExampleWorker extends ParallelWorker {
+
+    protected function process(int $number = 0): int {
+        $this->writeln(sprintf("Processing task #%u", $number));
+
+        // ... do work ...
+
+        $this->writeln(sprintf("Finished task #%u", $number));
+
+        return $number;
+    }
+
+}
+```
+
+#### Example output
+When used together with `withProgress()`, messages are printed between progress-bar redraws instead of being overwritten:
+
+```bash
+ 0 of 10: Starting...
+ [>------------------------------------------------------------------------]   0%
+ elapsed: < 1 sec, remaining: < 1 sec, ?? items/s,memory: ??
+ Processing task #5
+ Finished task #5
+ 1 of 10: Task #5
+ [=====>-------------------------------------------------------------------]  10%
+ elapsed: < 1 sec, remaining: < 1 sec, ~1.00 items/s,memory: ??
+```
+
 ### References
 1. [parallel\bootstrap()](https://www.php.net/manual/en/parallel.bootstrap.php)
 2. [parallel\Runtime](https://www.php.net/manual/en/class.parallel-runtime.php)