Merge branch 'trunk' into feature/unit-tests

Author: JasonTheAdams

.gitignore

@@ -19,9 +19,11 @@ vendor/
 
 .claude/
 CLAUDE.md
+.cursor/
+GEMINI.md
 
 ############
 ## PHPUnit
 ############
 
-.phpunit.cache/
+.phpunit.cache/

src/Common/AbstractEnum.php

@@ -9,7 +9,7 @@
 use ReflectionClass;
 
 /**
- * Abstract base class for enum-like behavior in PHP 7.4
+ * Abstract base class for enum-like behavior in PHP 7.4.
  *
  * This class provides enum-like functionality for PHP versions that don't support native enums.
  * Child classes should define uppercase snake_case constants for enum values.
@@ -35,22 +35,22 @@
 abstract class AbstractEnum
 {
     /**
-     * @var string The value of the enum instance
+     * @var string The value of the enum instance.
      */
     private string $value;
 
     /**
-     * @var string The name of the enum constant
+     * @var string The name of the enum constant.
      */
     private string $name;
 
     /**
-     * @var array<string, array<string, string>> Cache for reflection data
+     * @var array<string, array<string, string>> Cache for reflection data.
      */
     private static array $cache = [];
 
     /**
-     * @var array<string, array<string, self>> Cache for enum instances
+     * @var array<string, array<string, self>> Cache for enum instances.
      */
     private static array $instances = [];
 

src/Providers/Enums/ProviderTypeEnum.php

@@ -21,17 +21,17 @@
 class ProviderTypeEnum extends AbstractEnum
 {
     /**
-     * Cloud-based AI provider (e.g., OpenAI, Google, Anthropic).
+     * Cloud-based AI provider (e.g. models available via external REST APIs).
      */
     public const CLOUD = 'cloud';
 
     /**
-     * Server-side AI provider (e.g., self-hosted models).
+     * Server-side AI provider (e.g. self-hosted models).
      */
     public const SERVER = 'server';
 
     /**
-     * Client-side AI provider (e.g., browser-based models).
+     * Client-side AI provider (e.g. browser-based models).
      */
     public const CLIENT = 'client';
 }