add changelog

Author: paulbalandan

user_guide_src/source/changelogs/v4.8.0.rst

@@ -43,6 +43,7 @@ Interface Changes
 Method Signature Changes
 ========================
 
+- **CLI:** The ``Console::run()`` method now accepts an optional ``array $tokens`` parameter. This allows you to pass an array of command tokens directly to the console runner, which is useful for testing or programmatically running commands. If not provided, it will default to using the global ``$argv``.
 - **CodeIgniter:** The deprecated parameters in methods have been removed:
     - ``CodeIgniter\CodeIgniter::handleRequest()`` no longer accepts the deprecated ``$cacheConfig`` and ``$returnResponse`` parameters.
        - ``$cacheConfig`` is no longer used and is now hard deprecated. A deprecation notice will be triggered if this is passed to the method.
@@ -147,6 +148,7 @@ Commands
     For example: ``spark my:command -- --myarg`` will pass ``--myarg`` as an argument instead of an option.
 - ``CLI`` now supports options with values specified using an equals sign (e.g., ``--option=value``) in addition to the existing space-separated syntax (e.g., ``--option value``).
     This provides more flexibility in how you can pass options to commands.
+- Likewise, the ``command()`` function now also supports the above enhancements for command-line option parsing when using the function to run commands from code.
 
 Testing
 =======
@@ -231,7 +233,9 @@ Changes
 Deprecations
 ************
 
+- The ``Boot::initializeConsole()`` method is now deprecated and will be removed in a future release.
 - **CLI:** The ``CLI::parseCommandLine()`` method is now deprecated and will be removed in a future release. The ``CLI`` class now uses the new ``CommandLineParser`` class to handle command-line argument parsing.
+- **CLI:** Returning a non-integer exit code from a command is now deprecated and will trigger a deprecation notice. Command methods should return an integer exit code (e.g., ``0`` for success, non-zero for errors) to ensure proper behavior across all platforms.
 - **HTTP:** The ``CLIRequest::parseCommand()`` method is now deprecated and will be removed in a future release. The ``CLIRequest`` class now uses the new ``CommandLineParser`` class to handle command-line argument parsing.
 
 **********

user_guide_src/source/installation/upgrade_480.rst

@@ -20,6 +20,13 @@ Mandatory File Changes
 Breaking Changes
 ****************
 
+Console Exit Codes
+==================
+
+Previously, returning a non-integer value from a command run through ``spark`` would be treated as a successful execution (exit code ``0``).
+Starting with v4.8.0, this behavior is still supported but will trigger a deprecation notice. Commands should now return an integer exit code
+to ensure proper behavior across all platforms.
+
 *********************
 Breaking Enhancements
 *********************