Address review: align assertion naming and clarify docblocks

- Rename assertSymfonyVersion -> seeSymfonyVersion and
  assertEnvFileIsSynchronized -> seeEnvFileIsSynchronized to match the
  module's uniform see*/dontSee*/grab* convention
- seeDoctrineDatabaseIsUp: document the entity-manager-name fallback
- seeAppEnvAndDebugMatchKernel: document when APP_ENV/APP_DEBUG can
  legitimately diverge from the Kernel
- Update unit test for the rename

Author: TavoNiievez

src/Codeception/Module/Symfony/DoctrineAssertionsTrait.php

@@ -120,7 +120,8 @@ public function seeNumRecords(int $expectedNum, string $className, array $criter
      * $I->seeDoctrineDatabaseIsUp('custom');
      * ```
      *
-     * @param non-empty-string $connectionName The name of the Doctrine connection to check.
+     * @param non-empty-string $connectionName A Doctrine connection name; if no connection matches,
+     *                                          it is resolved as an entity manager name (whose connection is used).
      */
     public function seeDoctrineDatabaseIsUp(string $connectionName = 'default'): void
     {

src/Codeception/Module/Symfony/EnvironmentAssertionsTrait.php

@@ -82,10 +82,10 @@ public function dontSeeDebugModeEnabled(): void
      *
      * ```php
      * <?php
-     * $I->assertSymfonyVersion('>=', '6.4');
+     * $I->seeSymfonyVersion('>=', '6.4');
      * ```
      */
-    public function assertSymfonyVersion(string $operator, string $version, string $message = ''): void
+    public function seeSymfonyVersion(string $operator, string $version, string $message = ''): void
     {
         $this->assertTrue(
             version_compare(Kernel::VERSION, $version, $operator),
@@ -99,6 +99,10 @@ public function assertSymfonyVersion(string $operator, string $version, string $
      * Values are resolved in this order: `$_SERVER`, then `$_ENV`, then `getenv()`.
      * This helps validate both real OS variables and values resolved from `.env` files.
      *
+     * The variables can legitimately diverge from the Kernel - for example when a shell
+     * or CI job exports `APP_ENV=dev` while the test Kernel is booted in `test` - and this
+     * assertion guards against that drift. Only variables that are actually present are checked.
+     *
      * ```php
      * <?php
      * $I->seeAppEnvAndDebugMatchKernel();
@@ -212,14 +216,14 @@ public function seeProjectStructureIsSane(): void
      *
      * ```php
      * <?php
-     * $I->assertEnvFileIsSynchronized();
+     * $I->seeEnvFileIsSynchronized();
      * ```
      *
      * @param non-empty-string $envPath
      * @param non-empty-string $examplePath
      * @param list<non-empty-string> $additionalEnvPaths
      */
-    public function assertEnvFileIsSynchronized(string $envPath = '.env', string $examplePath = '.env.example', array $additionalEnvPaths = []): void
+    public function seeEnvFileIsSynchronized(string $envPath = '.env', string $examplePath = '.env.example', array $additionalEnvPaths = []): void
     {
         $projectDir = $this->getProjectDir();
 

tests/EnvironmentAssertionsTest.php

@@ -61,11 +61,11 @@ protected function tearDown(): void
         parent::tearDown();
     }
 
-    public function testAssertSymfonyVersionAcceptsOneTwoAndThreeSegments(): void
+    public function testSeeSymfonyVersionAcceptsOneTwoAndThreeSegments(): void
     {
-        $this->assertSymfonyVersion('>=', (string) Kernel::MAJOR_VERSION);
-        $this->assertSymfonyVersion('>=', sprintf('%d.%d', Kernel::MAJOR_VERSION, Kernel::MINOR_VERSION));
-        $this->assertSymfonyVersion('>=', sprintf('%d.%d.0', Kernel::MAJOR_VERSION, Kernel::MINOR_VERSION));
+        $this->seeSymfonyVersion('>=', (string) Kernel::MAJOR_VERSION);
+        $this->seeSymfonyVersion('>=', sprintf('%d.%d', Kernel::MAJOR_VERSION, Kernel::MINOR_VERSION));
+        $this->seeSymfonyVersion('>=', sprintf('%d.%d.0', Kernel::MAJOR_VERSION, Kernel::MINOR_VERSION));
     }
 
     public function testSeeAppEnvAndDebugMatchKernelUsesServerValues(): void