Update docs for runtime environment checks

Author: coisa

docs/_static/mascot-banner.png

@@ -1,13 +1,14 @@
 Command Classes
 ===============
 
-All public CLI commands extend ``Composer\Command\BaseCommand``. Most command
-classes are resolved lazily through ``DevToolsCommandLoader`` and receive
-their collaborators from the shared ``DevToolsServiceProvider`` container,
-while orchestration commands such as ``standards`` dispatch other commands
-through the console application itself. The architecture also relies on
-``ProcessBuilder`` and ``ProcessQueue`` for fluent process management where
-subprocess execution is needed.
+All public CLI commands are Symfony Console commands resolved lazily through
+``DevToolsCommandLoader``. Command classes receive their collaborators from
+the shared ``DevToolsServiceProvider`` container, while orchestration commands
+such as ``standards`` dispatch other commands through the console application
+itself. Composer integration uses proxy commands to expose that same Symfony
+command set without forcing each command to extend Composer's ``BaseCommand``.
+The architecture also relies on ``ProcessBuilder`` and ``ProcessQueue`` for
+fluent process management where subprocess execution is needed.
 
 .. list-table::
    :header-rows: 1
@@ -95,3 +96,6 @@ subprocess execution is needed.
    * - ``FastForward\DevTools\Console\Command\UpdateComposerJsonCommand``
      - ``update-composer-json``
      - Updates the composer.json file to match the packaged schema.
+   * - ``FastForward\DevTools\Console\Command\SelfUpdateCommand``
+     - ``dev-tools:self-update``
+     - Updates the local or global DevTools installation through Composer.

docs/_static/mascot.png

@@ -31,7 +31,11 @@ Composer Plugin Classes
      - Registers the command provider and runs ``dev-tools:sync`` after
        Composer install and update.
    * - ``FastForward\DevTools\Composer\Capability\DevToolsCommandProvider``
-     - Instantiates and returns the available command classes.
+     - Exposes Symfony command instances to Composer through proxy commands
+       while filtering names and aliases already registered by Composer or the
+       root project's scripts.
+   * - ``FastForward\DevTools\Composer\Command\ProxyCommand``
+     - Adapts one Symfony command to Composer's command provider contract.
    * - ``FastForward\DevTools\Console\DevTools``
      - Console application used by the local binary.
 

docs/api/commands.rst

@@ -21,7 +21,7 @@ Documentation
 
    .. container:: col-lg-5 text-center
 
-      .. image:: _static/mascot.png
+      .. image:: _static/mascot-banner.png
          :alt: Fast Forward DevTools mascot
          :class: img-fluid w-100 rounded-4 shadow-sm border border-light-subtle bg-body-tertiary p-2
 

docs/api/composer-integration.rst

@@ -94,5 +94,8 @@ command list:
      - Git ignore, Git attributes, license, resource diffing, and coverage
        summary services support consumer sync and reporting workflows.
    * - ``Shared infrastructure``
-     - ``LoggerInterface``, ``ClockInterface``, and Twig's
-       ``LoaderInterface`` provide reusable runtime infrastructure.
+     - ``LoggerInterface``, ``ClockInterface``,
+       ``RuntimeEnvironmentInterface``, and Twig's ``LoaderInterface``
+       provide reusable runtime infrastructure, including centralized checks
+       for GitHub Actions, generic CI, Composer test runs, and truthy
+       environment flags.