Add DevTools self-update workflow (#273)

* Add DevTools self-update command

* Update wiki submodule pointer for PR #273

* Add DevTools self-update command

* Update wiki submodule pointer for PR #273

* Add DevTools self-update command

* Update wiki submodule pointer for PR #273

* Skip DevTools version checks in CI

* Update wiki submodule pointer for PR #273

* Centralize runtime environment checks

* Update wiki submodule pointer for PR #273

* Update docs for runtime environment checks

* Fix self-update command coverage metadata

* Infer self-update scope from installation

* Update wiki submodule pointer for PR #273

---------

Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>

Author: coisa

.github/wiki

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add a standalone DevTools `self-update` command plus global `--working-dir` and `--auto-update` binary options for local or global installations (#272)
+
 ## [1.23.0] - 2026-04-26
 
 ### Added

CHANGELOG.md

@@ -55,6 +55,12 @@ composer dev-tools
 
 # Automatically fix code standards issues where applicable
 composer dev-tools:fix
+
+# Run the standalone binary from another project directory
+vendor/bin/dev-tools --working-dir=/path/to/project tests
+
+# Update the installed DevTools package
+vendor/bin/dev-tools self-update
 ```
 
 You can also run individual commands for specific development tasks:
@@ -288,6 +294,7 @@ skills they depend on.
 | `composer codeowners` | Generates managed `.github/CODEOWNERS` content from local repository metadata. |
 | `composer gitattributes` | Manages export-ignore rules in `.gitattributes`. |
 | `composer dev-tools:sync` | Updates scripts, CODEOWNERS, funding metadata, workflow stubs, `.editorconfig`, `.gitignore`, `.gitattributes`, wiki setup, packaged skills, and packaged agents. |
+| `vendor/bin/dev-tools self-update` / `composer dev-tools:self-update` | Updates the local DevTools package, or the Composer global installation when the active binary is globally installed. |
 
 ## 🔌 Integration
 

README.md

@@ -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-banner.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/_static/mascot.png

@@ -20,6 +20,7 @@ Detailed documentation for each dev-tools command.
    agents
    skills
    sync
+   self-update
    funding
    codeowners
    gitignore

docs/api/commands.rst

@@ -0,0 +1,53 @@
+self-update
+===========
+
+``self-update`` updates the installed ``fast-forward/dev-tools`` package
+through Composer.
+
+Usage
+-----
+
+.. code-block:: bash
+
+   vendor/bin/dev-tools self-update
+   composer dev-tools:self-update
+
+When the standalone ``dev-tools`` binary is itself loaded from Composer's
+global installation, ``self-update`` automatically targets
+``composer global update fast-forward/dev-tools``. Local project
+installations update the current project by default.
+
+Global runtime options
+----------------------
+
+The standalone DevTools binary also accepts Composer-like global runtime
+options before the command name:
+
+.. code-block:: bash
+
+   vendor/bin/dev-tools --working-dir=/path/to/project tests
+   vendor/bin/dev-tools --auto-update tests
+
+``--working-dir`` (or ``-d``) switches the process directory before resolving
+paths, managed files, or command defaults. This lets a globally installed
+binary operate on another project without first changing shell directories.
+Composer executions can use Composer's own ``--working-dir``/``-d`` option.
+
+``--auto-update`` runs the self-update flow before the requested command. The
+same behavior MAY be enabled with ``FAST_FORWARD_AUTO_UPDATE=1``. When the
+active ``dev-tools`` binary is already installed globally, auto-update also
+targets the global installation by default. Auto-update failures are reported
+as warnings and do not block the requested command.
+
+Version freshness check
+-----------------------
+
+When DevTools runs from an installed package, the binary checks Composer
+metadata for the latest stable ``fast-forward/dev-tools`` release. If a newer
+stable version is available, DevTools prints a warning recommending
+``dev-tools self-update``. This check is best-effort: network, Composer, or
+metadata failures are ignored so the requested command can continue normally.
+The check is skipped automatically in CI environments, including GitHub
+Actions, so freshly installed consumer workflows do not spend time querying
+release metadata. Set ``FAST_FORWARD_SKIP_VERSION_CHECK=1`` to disable the
+warning in other non-interactive contexts.

docs/api/composer-integration.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