feat(core/cli): add progress callback and wire to --verbose

- Bblslug::translate(): introduce optional `onFeedback(?callable)` and emit progress messages at key steps
  (start, pre/post validation, filters, length check, HTTP, parsing, restore, done).
- Console/Cli: add feedback handler (maps level -> Help::info/warning/error) and pass it when `--verbose` is set.
- README: include `onFeedback` in the translate() example and add a brief explanation.

Author: bionicman

README.md

@@ -274,6 +274,7 @@ $result = Bblslug::translate(
     // Additional context/prompt pass to model
     context:    'Translate as a professional technical translator',
     filters:    ['url','html_code'],           // List of placeholder filters
+    onFeedback: $verbose ? static function (string $message, string $level = 'info'): void { error_log("[$level] $message"); } : null, // Optional progress callback
     promptKey: 'translator',                   // which prompt template to use
     proxy:      getenv('BBLSLUG_PROXY'),       // Optional proxy URI (http://..., socks5h://...)
     sourceLang: 'DE',                          // Source language code (optional; autodetect if null)
@@ -285,6 +286,9 @@ $result = Bblslug::translate(
 echo $result['result'];
 ```
 
+`onFeedback` is an optional callback for the progress information, accepts (string $message, string $level),  
+where `$level` includes `'info' | 'warning' | 'error'`. Send null to swhitch off.
+
 Result structure:
 
 ```php

src/Bblslug/Bblslug.php

@@ -55,6 +55,8 @@ public static function listPrompts(): array
      * @param string|null           $context    Optional context prompt.
      * @param bool                  $dryRun     If true: prepare placeholders only.
      * @param string[]              $filters    Placeholder filters to apply.
+     * @param ?callable(string,string=):void $onFeedback Optional feedback callback that
+     *        receives (message, level).
      * @param string                $promptKey  Prompt template key
      * @param string|null           $proxy      Optional proxy URL (from env or CLI).
      * @param string|null           $sourceLang Optional source language code.
@@ -88,6 +90,7 @@ public static function translate(
         ?string $context = null,
         bool $dryRun = false,
         array $filters = [],
+        ?callable $onFeedback = null,
         string $promptKey = 'translator',
         ?string $proxy = null,
         ?string $sourceLang = null,
@@ -100,6 +103,25 @@ public static function translate(
         $valLogPre  = '';
         $valLogPost = '';
 
+        // Feedback helper.
+        $say = static function (?callable $cb, string $msg, string $level = 'info'): void {
+            if (is_callable($cb)) {
+                try {
+                    $cb($msg, $level);
+                } catch (\Throwable $e) {
+                    /* swallow on purpose */
+                }
+            }
+        };
+
+        $say(
+            $onFeedback,
+            "Starting translation (model='{$modelKey}', format='{$format}', dryRun="
+            . ($dryRun ? 'true' : 'false')
+            . ")",
+            'info'
+        );
+
         // Validate model
         $registry = new ModelRegistry();
         if (!$registry->has($modelKey)) {
@@ -125,9 +147,11 @@ public static function translate(
 
         // Measure original length
         $originalLength = mb_strlen($text);
+        $say($onFeedback, "Input received (length={$originalLength})", 'info');
 
         // Pre-validation (before filters)
         if ($validate && $format !== 'text') {
+            $say($onFeedback, "Pre-validation started ({$format})", 'info');
             switch ($format) {
                 case 'json':
                     $jsonValidator = new JsonValidator();
@@ -161,21 +185,26 @@ public static function translate(
                     // Other formats: no container validation
                     break;
             }
+            $say($onFeedback, "Pre-validation passed ({$format})", 'info');
         }
 
         // Apply placeholder filters
         $filterManager = new FilterManager($filters);
+        $say($onFeedback, "Applying filters: " . (empty($filters) ? '(none)' : implode(', ', $filters)), 'info');
         $prepared = $filterManager->apply($text);
         $preparedLength = mb_strlen($prepared);
+        $say($onFeedback, "Filters applied (preparedLength={$preparedLength})", 'info');
 
         // Length guard: make sure prepared text fits model constraints
+        $say($onFeedback, "Checking model length limits", 'info');
         $lengthValidator = TextLengthValidator::fromModelConfig($model);
         $lenResult = $lengthValidator->validate($prepared);
         if (! $lenResult->isValid()) {
             throw new \RuntimeException(
                 "Input length exceeds model limits: " . implode('; ', $lenResult->getErrors())
             );
         }
+        $say($onFeedback, "Length check passed", 'info');
 
         // Prepare options for driver, merging in any CLI-provided variables
         $options = array_merge(
@@ -193,6 +222,7 @@ public static function translate(
         }
 
         // Build request
+        $say($onFeedback, "Building request for endpoint: {$endpoint}", 'info');
         $req = $driver->buildRequest(
             $model,
             $prepared,
@@ -205,6 +235,7 @@ public static function translate(
             if (!$apiKey) {
                 throw new \InvalidArgumentException("API key is required for {$modelKey}");
             }
+            $say($onFeedback, "Injecting auth credentials", 'info');
             $keyName = $auth['key_name'];
             $prefix = isset($auth['prefix']) && $auth['prefix'] !== ''
                 ? $auth['prefix'] . ' '
@@ -226,6 +257,7 @@ public static function translate(
         }
 
         // Perform HTTP request
+        $say($onFeedback, $dryRun ? "Dry-run: skipping HTTP request" : "Sending HTTP request", 'info');
         $http = HttpClient::request(
             method: 'POST',
             url: $req['url'],
@@ -248,13 +280,16 @@ public static function translate(
         if ($dryRun) {
             $translated = $prepared;
             $rawUsage   = null;
+            $say($onFeedback, "Dry-run completed", 'info');
         } else {
+            $say($onFeedback, "HTTP response received (status={$httpStatus})", 'info');
             if ($httpStatus >= 400 && empty($model['http_error_handling'])) {
                 throw new \RuntimeException(
                     "HTTP {$httpStatus} error from {$req['url']}: {$raw}\n\n" .
                     $debugRequest . $debugResponse
                 );
             }
+            $say($onFeedback, "Parsing provider response", 'info');
             try {
                 $parsed     = $driver->parseResponse($model, $raw);
                 $translated = $parsed['text'];
@@ -264,19 +299,23 @@ public static function translate(
                     $e->getMessage() . "\n\n" . $debugRequest . $debugResponse
                 );
             }
+            $say($onFeedback, "Provider response parsed", 'info');
         }
 
         $consumed = UsageExtractor::extract($model, $rawUsage);
 
         // Restore placeholders
+        $say($onFeedback, "Restoring placeholders", 'info');
         $result = $filterManager->restore($translated);
         $finalLength = mb_strlen($result);
+        $say($onFeedback, "Placeholders restored (translatedLength={$finalLength})", 'info');
 
         // Collect stats
         $filterStats = $filterManager->getStats();
 
         // Post-validation (after translation)
         if ($validate && $format !== 'text') {
+            $say($onFeedback, "Post-validation started ({$format})", 'info');
             switch ($format) {
                 case 'json':
                     $postResult = (new JsonValidator())->validate($result);
@@ -317,13 +356,16 @@ public static function translate(
                     // Other formats: no container validation
                     break;
             }
+            $say($onFeedback, "Post-validation passed ({$format})", 'info');
         }
 
         // Append post-validation log into response debug
         if ($verbose) {
             $debugResponse .= $valLogPost;
         }
 
+        $say($onFeedback, "Done", 'info');
+
         return [
             'original' => $text,
             'prepared' => $prepared,

src/Bblslug/Console/Cli.php

@@ -202,6 +202,20 @@ public static function run(): void
         // Override by CLI
         $variables = array_merge($variables, $cliVars);
 
+        // Feedback handler for progress messages.
+        $feedback = function (string $message, string $level = 'info'): void {
+            switch ($level) {
+                case 'warning':
+                    Help::warning($message);
+                    break;
+                case 'error':
+                    Help::error($message);
+                    break;
+                default:
+                    Help::info($message);
+            }
+        };
+
         // Perform translation
         $res = [];
         try {
@@ -213,6 +227,7 @@ public static function run(): void
                 context: $context,
                 dryRun: $dryRun,
                 filters: $filters,
+                onFeedback: $verbose ? $feedback : null,
                 promptKey: $promptKey,
                 proxy: $proxy,
                 sourceLang: $sourceLang,