Added CC and BCC support to notify-email.

- Added VORTEX_NOTIFY_EMAIL_CC and VORTEX_NOTIFY_EMAIL_BCC environment variables
- Updated mail mock infrastructure to validate headers (both array and string formats)
- Parse CC/BCC recipients with same format as TO recipients (comma-separated with optional names)
- Added Cc and Bcc headers to mail() calls when CC/BCC recipients are specified
- Display CC/BCC in notification summary output
- Added 8 comprehensive tests covering single/multiple CC/BCC scenarios
- All 257 tests pass with 1,283 assertions and 100% code coverage maintained

Author: AlexSkrypnyk

.vortex/tooling/src/notify-email

@@ -42,6 +42,20 @@ $email_from = getenv_required('VORTEX_NOTIFY_EMAIL_FROM', 'DRUPAL_SITE_EMAIL');
 // Example: "[email protected]|Jane Doe, [email protected]|John Doe".
 $email_recipients = getenv_required('VORTEX_NOTIFY_EMAIL_RECIPIENTS');
 
+// Email notification CC recipients.
+//
+// Multiple names can be specified as a comma-separated list of email addresses
+// with optional names in the format "email|name".
+// Example: "[email protected]|Jane Doe, [email protected]|John Doe".
+$email_cc = getenv_default('VORTEX_NOTIFY_EMAIL_CC', '');
+
+// Email notification BCC recipients.
+//
+// Multiple names can be specified as a comma-separated list of email addresses
+// with optional names in the format "email|name".
+// Example: "[email protected]|Jane Doe, [email protected]|John Doe".
+$email_bcc = getenv_default('VORTEX_NOTIFY_EMAIL_BCC', '');
+
 // Email notification subject template.
 //
 // Available tokens:
@@ -62,7 +76,37 @@ $email_subject = getenv_default('VORTEX_NOTIFY_EMAIL_SUBJECT', '%project% deploy
 // - %login_url% - Login URL.
 $email_message = getenv_default('VORTEX_NOTIFY_EMAIL_MESSAGE', "## This is an automated message ##\nSite %project% %label% has been deployed at %timestamp% and is available at %environment_url%.\nLogin at: %login_url%");
 
-// ------------------------------------------------------------------------------
+// -----------------------------------------------------------------------------
+
+/**
+ * Parse email recipients from a comma-separated string.
+ *
+ * @param string $recipients
+ *   Comma-separated list of recipients. Format: "email1, email2|Name, email3".
+ *
+ * @return array<string>
+ *   Array of formatted email addresses.
+ */
+function parse_email_recipients(string $recipients): array {
+  if (empty($recipients)) {
+    return [];
+  }
+
+  $parsed = [];
+  $recipient_list = array_map(trim(...), explode(',', $recipients));
+
+  foreach ($recipient_list as $recipient) {
+    $parts = array_map(trim(...), explode('|', $recipient, 2));
+    $email = $parts[0];
+    $name = $parts[1] ?? '';
+
+    $parsed[] = empty($name) ? $email : sprintf('"%s" <%s>', $name, $email);
+  }
+
+  return $parsed;
+}
+
+// -----------------------------------------------------------------------------
 
 info('Started email notification.');
 
@@ -95,28 +139,42 @@ note('Environment URL: ' . $notify_env_url);
 note('Login URL      : ' . $notify_login_url);
 note('From           : ' . $email_from);
 note('Recipients     : ' . $email_recipients);
+if (!empty($email_cc)) {
+  note('CC             : ' . $email_cc);
+}
+if (!empty($email_bcc)) {
+  note('BCC            : ' . $email_bcc);
+}
 note('Subject        : ' . $email_subject);
 note('Content        : ' . $email_message);
 
 task('Sending email notification');
 
-$email_recipients = array_map(trim(...), explode(',', $email_recipients));
+// Parse recipients.
+$to_list = parse_email_recipients($email_recipients);
+$cc_list = parse_email_recipients($email_cc);
+$bcc_list = parse_email_recipients($email_bcc);
 
 $sent = [];
-foreach ($email_recipients as $email_recipient) {
-  $parts = array_map(trim(...), explode('|', $email_recipient, 2));
-  $email = $parts[0];
-  $name = $parts[1] ?? '';
-
-  $to = empty($name) ? $email : sprintf('"%s" <%s>', $name, $email);
-
+foreach ($to_list as $to) {
   $headers = [
     'From: ' . $email_from,
     'Content-Type: text/plain; charset=UTF-8',
   ];
 
+  // Add CC header if there are CC recipients.
+  if (!empty($cc_list)) {
+    $headers[] = 'Cc: ' . implode(', ', $cc_list);
+  }
+
+  // Add BCC header if there are BCC recipients.
+  if (!empty($bcc_list)) {
+    $headers[] = 'Bcc: ' . implode(', ', $bcc_list);
+  }
+
   if (mail($to, $email_subject, $email_message, $headers)) {
-    $sent[] = $email;
+    // Extract just the email address from formatted string for tracking.
+    $sent[] = preg_match('/<(.+?)>/', $to, $matches) ? $matches[1] : $to;
   }
 }
 

.vortex/tooling/tests/Traits/MockTrait.php

@@ -253,7 +253,7 @@ protected function mockQuit(int $code = 0, string $namespace = 'DrevOps\\VortexT
    *   - to: Expected recipient (required)
    *   - subject: Expected subject (required)
    *   - message: Expected message (required)
-   *   - result: Return value (TRUE for success, FALSE for failure, default: TRUE).
+   *   - result: Return value (defaults to TRUE).
    * @param string $namespace
    *   Namespace to mock the function in (defaults to DrevOps\VortexTooling).
    *
@@ -318,15 +318,38 @@ protected function mockMailMultiple(array $responses, string $namespace = 'DrevO
           throw new \RuntimeException(sprintf('mail() called with unexpected message. Expected "%s", got "%s".', $response['message'], $message));
         }
 
+        // Validate headers if specified in response.
+        // @phpstan-ignore-next-line isset.offset
+        if (isset($response['headers'])) {
+          $expected_headers = $response['headers'];
+          $actual_headers = $additional_headers;
+
+          // Normalize both to arrays for comparison.
+          if (is_string($expected_headers)) {
+            $expected_headers = array_filter(array_map(trim(...), explode("\r\n", $expected_headers)));
+          }
+          if (is_string($actual_headers)) {
+            $actual_headers = array_filter(array_map(trim(...), explode("\r\n", $actual_headers)));
+          }
+
+          // Sort both arrays for consistent comparison.
+          sort($expected_headers);
+          sort($actual_headers);
+
+          if ($expected_headers !== $actual_headers) {
+            throw new \RuntimeException(sprintf('mail() called with unexpected headers. Expected "%s", got "%s".', print_r($expected_headers, TRUE), print_r($actual_headers, TRUE)));
+          }
+        }
+
         return $response['result'];
       });
   }
 
   /**
    * Mock single mail call.
    *
-   * @param array{to: string, subject: string, message: string, result?: bool} $response
-   *   Response with recipient, subject, message, and result.
+   * @param array{to: string, subject: string, message: string, headers?: array<string>|string, result?: bool} $response
+   *   Response with recipient, subject, message, optional headers, and result.
    * @param string $namespace
    *   Namespace to mock the function in.
    */