Add mageforge:static:clean command for comprehensive cache and generated files cleanup (#56)

* Initial plan

* Add mageforge:static:clean command implementation

Co-authored-by: dermatz <[email protected]>

* Update documentation for static:clean command

Co-authored-by: dermatz <[email protected]>

* Refactor: Extract theme name parsing logic to reduce duplication

Co-authored-by: dermatz <[email protected]>

* Remove invalid shortcode from README for static:clean command

Co-authored-by: dermatz <[email protected]>

* Add cleaning of var/page_cache, var/tmp and generated directories

Co-authored-by: dermatz <[email protected]>

* Fix cleanGenerated to track successful deletions properly

Co-authored-by: dermatz <[email protected]>

* ✨ feat: enhance CleanCommand with multi-theme support and dry-run option

* ✨ feat: add dry-run option and aliases for static clean command

* ✨ feat: add mageforge:static:clean command and multi-theme support

* Update docs/commands.md

Co-authored-by: Copilot <[email protected]>

* Update CHANGELOG.md

Co-authored-by: Copilot <[email protected]>

* Update src/Console/Command/Static/CleanCommand.php

Co-authored-by: Copilot <[email protected]>

* Update README.md

Co-authored-by: Copilot <[email protected]>

* Update .github/workflows/magento-compatibility.yml

Co-authored-by: Copilot <[email protected]>

* Update .github/workflows/magento-compatibility.yml

Co-authored-by: Copilot <[email protected]>

* Update src/Console/Command/Static/CleanCommand.php

Co-authored-by: Copilot <[email protected]>

* Update src/Console/Command/Static/CleanCommand.php

Co-authored-by: Copilot <[email protected]>

* Update docs/commands.md

Co-authored-by: Copilot <[email protected]>

* Update src/Console/Command/Static/CleanCommand.php

Co-authored-by: Copilot <[email protected]>

* Fix getCachedEnvironmentVariables to use class-level static variable

Co-authored-by: dermatz <[email protected]>

* 🔧 fix: correct alias for MageForge Static Clean command

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: dermatz <[email protected]>
Co-authored-by: Mathias Elle <[email protected]>
Co-authored-by: Mathias Elle <[email protected]>
Co-authored-by: Copilot <[email protected]>

Author: 3 people

.github/workflows/magento-compatibility.yml

@@ -134,6 +134,15 @@ jobs:
           echo "Test MageForge Theme List command:"
           bin/magento mageforge:theme:list
 
+          echo "Test MageForge Static Clean command with dry-run:"
+          bin/magento mageforge:static:clean --all --dry-run
+
+          echo "Test MageForge Static Clean aliases:"
+          bin/magento mageforge:static:clean --all --dry-run
+          echo "Test MageForge Static Clean aliases:"
+          bin/magento m:st:c --help
+          bin/magento frontend:clean --help
+
       - name: Test Summary
         run: |
           echo "MageForge module compatibility test with Magento ${{ matrix.magento-version }} completed"
@@ -255,6 +264,13 @@ jobs:
           echo "Test MageForge Theme List command:"
           bin/magento mageforge:theme:list
 
+          echo "Test MageForge Static Clean command with dry-run:"
+          bin/magento mageforge:static:clean --all --dry-run
+
+          echo "Test MageForge Static Clean alias:"
+          bin/magento m:st:c --help
+          bin/magento frontend:clean --help
+
       - name: Test Summary
         run: |
           echo "MageForge module compatibility test with Magento 2.4.8 completed"

CHANGELOG.md

@@ -6,6 +6,20 @@ All notable changes to this project will be documented in this file.
 
 ## UNRELEASED
 
+### Added
+
+- feat: add `mageforge:static:clean` command for comprehensive cache and generated files cleanup
+- feat: add interactive multi-theme selection for static:clean command using Laravel Prompts
+- feat: add `--all` option to clean all themes at once
+- feat: add `--dry-run` option to preview what would be cleaned without deleting
+- feat: add command alias `frontend:clean` for quick access
+- feat: add CI/CD tests for static:clean command in compatibility workflow
+
+### Changed
+
+- refactor: split complex executeCommand method into smaller, focused methods to reduce cyclomatic complexity
+- docs: update copilot-instructions.md with CI/CD integration guidelines for new commands
+
 ## Latest Release
 
 ### [0.2.2] - 2025-06-05

README.md

@@ -37,6 +37,7 @@ Please ensure that your Magento installation meets this requirement before insta
 | `mageforge:theme:list`     | Lists all available themes                                | `m:t:l`                   |
 | `mageforge:theme:build`    | Builds selected themes (CSS/TailwindCSS)                  | `m:t:b`, `frontend:build` |
 | `mageforge:theme:watch`    | Starts watch mode for theme development                   | `m:t:w`, `frontend:watch` |
+| `mageforge:static:clean`   | Clean static files, cache and generated files for a theme | `frontend:clean`          |
 
 ---
 

docs/commands.md

@@ -85,7 +85,41 @@ bin/magento mageforge:theme:watch [--theme=THEME]
 
 ---
 
-### 4. SystemCheckCommand (`mageforge:system:check`)
+### 4. CleanCommand (`mageforge:static:clean`)
+
+**Purpose**: Cleans var/view_preprocessed, pub/static, var/page_cache, var/tmp and generated directories for specific theme.
+
+**File**: `/src/Console/Command/Static/CleanCommand.php`
+
+**Dependencies**:
+- `Filesystem` - Magento filesystem component for file operations
+- `ThemeList` - Service to retrieve theme information
+- `ThemePath` - Service to resolve theme paths
+
+**Usage**:
+```bash
+bin/magento mageforge:static:clean [<themename>]
+```
+
+**Implementation Details**:
+- If no theme name is provided:
+  - In interactive terminals, displays an interactive prompt to select the theme to clean
+  - In non-interactive environments, prints the list of available themes and exits, requiring an explicit theme name
+- Validates that the specified theme exists
+- Cleans the following directories for the theme:
+  - `var/view_preprocessed/css/frontend/Vendor/theme`
+  - `var/view_preprocessed/source/frontend/Vendor/theme`
+  - `pub/static/frontend/Vendor/theme`
+- Additionally cleans these global directories:
+  - `var/page_cache/*`
+  - `var/tmp/*`
+  - `generated/*`
+- Displays a summary of cleaned directories
+- Returns success status code
+
+---
+
+### 5. SystemCheckCommand (`mageforge:system:check`)
 
 **Purpose**: Displays system information relevant to Magento development.
 
@@ -111,7 +145,7 @@ bin/magento mageforge:system:check
 
 ---
 
-### 5. VersionCommand (`mageforge:version`)
+### 6. VersionCommand (`mageforge:version`)
 
 **Purpose**: Displays the current and latest version of the MageForge module.