[Workspace]: migrate managed tmp artifacts into .dev-tools (#151) (#161)

* [workspace] Consolidate managed artifacts under .dev-tools (#151)

* Update wiki submodule pointer for PR #161

* [workspace] Update ignored paths in phpdocumentor.xml

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

* [workspace] Normalize path resolvers and reusable config defaults (#151)

* Update wiki submodule pointer for PR #161

* [path] Rename project root resolver for working project context (#151)

* Update wiki submodule pointer for PR #161

* [ecs] Keep default set application explicitly named (#151)

* [tests] Use managed workspace baseDir in Rector config expectations (#151)

* [path] Clarify package and working-project path resolvers (#151)

* Update wiki submodule pointer for PR #161

---------

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>

Author: coisa

.github/wiki

@@ -86,6 +86,9 @@ jobs:
             - name: Add .nojekyll
               run: touch "${REPORTS_TARGET}/.nojekyll"
 
+            - name: Remove repository-local caches from published output
+              run: rm -rf "${REPORTS_TARGET}/cache"
+
             - name: Restore previews from gh-pages
               if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
               uses: actions/checkout@v6

.github/workflows/reports.yml

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- Consolidate repository-local DevTools caches under `.dev-tools/cache`, keep published reports free of cache directories, and audit managed artifact path defaults across commands, workflows, and documentation (#151)
+
 ## [1.17.1] - 2026-04-22
 
 ### Fixed

CHANGELOG.md

@@ -40,7 +40,7 @@ Options
 
 ``--cache-dir`` (optional)
    Path to the cache directory for phpDocumentor.
-   Default: ``tmp/cache/phpdoc``.
+   Default: ``.dev-tools/cache/phpdoc``.
 
 ``--progress``
    Enable progress output from phpDocumentor.

docs/commands/docs.rst

@@ -36,7 +36,7 @@ Options
    Automatically fix PHPDoc issues. Without this option, runs in dry-run mode.
 
 ``--cache-dir`` (optional)
-   Path to the cache directory for PHP-CS-Fixer. Default: ``tmp/cache/php-cs-fixer``.
+   Path to the cache directory for PHP-CS-Fixer. Default: ``.dev-tools/cache/php-cs-fixer``.
 
 ``--progress``
    Enable progress output from PHP-CS-Fixer and the Rector phase.

docs/commands/phpdoc.rst

@@ -39,7 +39,7 @@ Options
    Path to the bootstrap file. Default: ``./vendor/autoload.php``.
 
 ``--cache-dir`` (optional)
-   Path to the PHPUnit cache directory. Default: ``./tmp/cache/phpunit``.
+   Path to the PHPUnit cache directory. Default: ``.dev-tools/cache/phpunit``.
 
 ``--no-cache``
    Disable PHPUnit caching.

docs/commands/tests.rst

@@ -27,7 +27,7 @@ Options
 
 ``--cache-dir`` (optional)
    Path to the cache directory for phpDocumentor.
-   Default: ``tmp/cache/phpdoc``.
+   Default: ``.dev-tools/cache/phpdoc``.
 
 ``--init``
    Initialize the configured wiki target as a Git submodule.

docs/commands/wiki.rst

@@ -51,8 +51,10 @@ Generated and Cache Directories
   directories kept in place by the ``skills`` command.
 - ``.agents/agents/`` contains symlinked packaged project agents or
   consumer-owned directories kept in place by the ``agents`` command.
-- ``tmp/cache/phpdoc``, ``tmp/cache/phpunit``, ``tmp/cache/rector``, and
-  ``tmp/cache/.php-cs-fixer.cache`` store tool caches.
+- ``.dev-tools/cache/phpdoc``, ``.dev-tools/cache/phpunit``,
+  ``.dev-tools/cache/rector``, and
+  ``.dev-tools/cache/php-cs-fixer/.php-cs-fixer.cache`` store repository-local
+  tool caches.
 
 Local Versus Packaged Files
 ---------------------------

docs/configuration/tooling-defaults.rst

@@ -59,7 +59,7 @@ Important details:
 - ``--progress`` re-enables PHPUnit progress output in text mode;
 - ``--json`` and ``--pretty-json`` still suppress PHPUnit progress output
   automatically;
-- ``--no-cache`` disables ``tmp/cache/phpunit``;
+- ``--no-cache`` disables ``.dev-tools/cache/phpunit``;
 - the packaged configuration registers the DevTools PHPUnit extension.
 
 ``dependencies``

docs/running/specialized-commands.rst

@@ -65,6 +65,7 @@ The ``reports.yml`` workflow is responsible for generating technical documentati
 *   **Main Branch**: Runs all checks and deploys the final reports to the root of the ``gh-pages`` branch.
     *   Runs a post-deploy health check against the published reports index and coverage URLs with retry/backoff to account for Pages propagation.
     *   Resolves the workflow PHP version from ``composer.lock`` or ``composer.json`` before installing dependencies.
+    *   Removes ``.dev-tools/cache`` from the publish directory before deployment so repository-local tool caches never leak into GitHub Pages output.
 *   **Pull Requests**:
     *   Generates a **Preview** of the documentation, coverage, and metrics.
     *   Deploys the preview to ``gh-pages`` under ``previews/pr-{number}/``.