Enable Discovery debug logging for production troubleshooting

- Add DISCOVERY_LOG_LEVEL=debug
- Add DISCOVERY_SHOW_PROGRESS=true
- Temporary changes for debugging InitializerProcessor fixes on production

src/Framework/Exception/FrameworkException.php

@@ -8,14 +8,22 @@ class FrameworkException extends \RuntimeException
 {
     protected ExceptionContext $context;
 
+    protected ?ErrorCode $errorCode;
+
+    protected ?int $retryAfter;
+
     public function __construct(
         string $message,
+        ExceptionContext $context,
         int $code = 0,
         ?\Throwable $previous = null,
-        ?ExceptionContext $context = null
+        ?ErrorCode $errorCode = null,
+        ?int $retryAfter = null
     ) {
         parent::__construct($message, $code, $previous);
-        $this->context = $context ?? ExceptionContext::empty();
+        $this->context = $context;
+        $this->errorCode = $errorCode;
+        $this->retryAfter = $retryAfter ?? $errorCode?->getRetryAfterSeconds();
     }
 
     public function getContext(): ExceptionContext
@@ -27,6 +35,7 @@ class FrameworkException extends \RuntimeException
     {
         $new = clone $this;
         $new->context = $context;
+
         return $new;
     }
 
@@ -60,7 +69,7 @@ class FrameworkException extends \RuntimeException
 
     public function toArray(): array
     {
-        return [
+        $array = [
             'class' => static::class,
             'message' => $this->getMessage(),
             'code' => $this->getCode(),
@@ -69,5 +78,179 @@ class FrameworkException extends \RuntimeException
             'context' => $this->context->toArray(),
             'trace' => $this->getTraceAsString(),
         ];
+
+        // ErrorCode-spezifische Daten hinzufügen wenn vorhanden
+        if ($this->errorCode) {
+            $array['error_code'] = $this->errorCode->value;
+            $array['error_category'] = $this->errorCode->getCategory();
+            $array['description'] = $this->errorCode->getDescription();
+            $array['recovery_hint'] = $this->errorCode->getRecoveryHint();
+            $array['is_recoverable'] = $this->errorCode->isRecoverable();
+            $array['retry_after'] = $this->retryAfter;
+        }
+
+        return $array;
+    }
+
+    // === Factory Methods ===
+
+    /**
+     * Einfache Exception ohne ErrorCode - für schnelle Verwendung
+     */
+    public static function simple(
+        string $message,
+        ?\Throwable $previous = null,
+        int $code = 0
+    ): static {
+        return new static(
+            message: $message,
+            context: ExceptionContext::empty(),
+            code: $code,
+            previous: $previous
+        );
+    }
+
+    /**
+     * Exception mit ErrorCode und automatischer Beschreibung
+     */
+    public static function create(
+        ErrorCode $errorCode,
+        ?string $message = null,
+        ?ExceptionContext $context = null,
+        ?\Throwable $previous = null,
+        int $code = 0
+    ): static {
+        $finalMessage = $message ?? $errorCode->getDescription();
+        $finalContext = $context ?? ExceptionContext::empty();
+
+        return new static(
+            message: $finalMessage,
+            context: $finalContext,
+            code: $code,
+            previous: $previous,
+            errorCode: $errorCode
+        );
+    }
+
+    /**
+     * Exception mit Operation Context
+     */
+    public static function forOperation(
+        string $operation,
+        ?string $component = null,
+        ?string $message = null,
+        ?ErrorCode $errorCode = null,
+        ?\Throwable $previous = null,
+        int $code = 0
+    ): static {
+        $context = ExceptionContext::forOperation($operation, $component);
+        $finalMessage = $message ?? $errorCode?->getDescription() ?? "Operation failed: $operation";
+
+        return new static(
+            message: $finalMessage,
+            context: $context,
+            code: $code,
+            previous: $previous,
+            errorCode: $errorCode
+        );
+    }
+
+    /**
+     * Exception mit vollständigem Context und Daten
+     */
+    public static function fromContext(
+        string $message,
+        ExceptionContext $context,
+        ?ErrorCode $errorCode = null,
+        ?\Throwable $previous = null,
+        int $code = 0
+    ): static {
+        return new static(
+            message: $message,
+            context: $context,
+            code: $code,
+            previous: $previous,
+            errorCode: $errorCode
+        );
+    }
+
+    // === ErrorCode Getter Methods ===
+
+    public function getErrorCode(): ?ErrorCode
+    {
+        return $this->errorCode;
+    }
+
+    public function getRetryAfter(): ?int
+    {
+        return $this->retryAfter;
+    }
+
+    public function isRecoverable(): bool
+    {
+        return $this->errorCode?->isRecoverable() ?? false;
+    }
+
+    public function getRecoveryHint(): ?string
+    {
+        return $this->errorCode?->getRecoveryHint();
+    }
+
+    // === ErrorCode Utility Methods ===
+
+    /**
+     * Prüft ob Exception von bestimmtem Error Code Typ ist
+     */
+    public function isErrorCode(ErrorCode $errorCode): bool
+    {
+        return $this->errorCode === $errorCode;
+    }
+
+    /**
+     * Prüft ob Exception zu bestimmter Kategorie gehört
+     */
+    public function isCategory(string $category): bool
+    {
+        return $this->errorCode?->getCategory() === strtoupper($category);
+    }
+
+    /**
+     * Setzt ErrorCode nachträglich
+     */
+    public function withErrorCode(ErrorCode $errorCode): self
+    {
+        $new = clone $this;
+        $new->errorCode = $errorCode;
+        $new->retryAfter = $errorCode->getRetryAfterSeconds();
+
+        return $new;
+    }
+
+    /**
+     * Setzt Custom Retry-Zeit
+     */
+    public function withRetryAfter(int $seconds): self
+    {
+        $new = clone $this;
+        $new->retryAfter = $seconds;
+
+        return $new;
+    }
+
+    /**
+     * String-Representation für Logging
+     */
+    public function __toString(): string
+    {
+        $errorCodePart = $this->errorCode ? '[' . $this->errorCode->value . ']' : '';
+
+        return sprintf(
+            '%s %s: %s in %s:%d',
+            static::class,
+            $errorCodePart,
+            $this->getMessage(),
+            $this->getFile(),
+            $this->getLine()
+        );
     }
 }