feat: update Inspector command to use 'theme' namespace

Author: dermatz

.github/workflows/magento-compatibility.yml

@@ -171,10 +171,10 @@ jobs:
           bin/magento mageforge:hyva:tokens Magent/lum --help || echo "Expected failure - TokensCommand"
 
           echo "Test MageForge Inspector commands:"
-          bin/magento mageforge:dev:inspector --help
+          bin/magento mageforge:theme:inspector --help
 
           echo "Test Inspector status command:"
-          bin/magento mageforge:dev:inspector status
+          bin/magento mageforge:theme:inspector status
 
       - name: Test Summary
         run: |
@@ -331,10 +331,10 @@ jobs:
           bin/magento mageforge:hyva:tokens Magent/lum --help || echo "Expected failure - TokensCommand"
 
           echo "Test MageForge Inspector commands:"
-          bin/magento mageforge:dev:inspector --help
+          bin/magento mageforge:theme:inspector --help
 
           echo "Test Inspector status command:"
-          bin/magento mageforge:dev:inspector status
+          bin/magento mageforge:theme:inspector status
 
       - name: Test Summary
         run: |

README.md

@@ -37,11 +37,11 @@ Please ensure that your Magento installation meets this requirement before insta
 | `mageforge:theme:build`             | Builds selected themes (CSS/TailwindCSS)                  | `frontend:build`          |
 | `mageforge:theme:watch`             | Starts watch mode for theme development                   | `frontend:watch`          |
 | `mageforge:theme:clean`             | Clean theme static files and cache directories            | `frontend:clean`          |
+| `mageforge:theme:inspector`         | Enable, disable or check status of Frontend Inspector     | -                         |
 | `mageforge:hyva:compatibility:check`| Check modules for Hyvä theme compatibility issues         | `hyva:check`              |
 | `mageforge:hyva:tokens`             | Generate Hyvä design tokens (Hyvä themes only)            | `hyva:tokens`             |
 | `mageforge:system:version`          | Shows current and latest version of the module            | `system:version`          |
 | `mageforge:system:check`            | Get system information (OS, PHP, Database, Node.js, etc.) | `system:check`            |
-| `mageforge:dev:inspector`           | Enable, disable or check status of Frontend Inspector     | -                         |
 
 ---
 

docs/commands.md

@@ -385,7 +385,7 @@ bin/magento mageforge:hyva:tokens Hyva/default
 
 ---
 
-### 8. InspectorCommand (`mageforge:dev:inspector`)
+### 8. InspectorCommand (`mageforge:theme:inspector`)
 
 **Purpose**: Enable, disable, or check status of the MageForge Frontend Inspector - an interactive element inspector for debugging templates, blocks, and modules in the frontend.
 
@@ -401,13 +401,13 @@ bin/magento mageforge:hyva:tokens Hyva/default
 
 ```bash
 # Enable inspector
-bin/magento mageforge:dev:inspector enable
+bin/magento mageforge:theme:inspector enable
 
 # Disable inspector
-bin/magento mageforge:dev:inspector disable
+bin/magento mageforge:theme:inspector disable
 
 # Check status
-bin/magento mageforge:dev:inspector status
+bin/magento mageforge:theme:inspector status
 ```
 
 **Implementation Details**:

src/Console/Command/Dev/InspectorCommand.php

@@ -52,12 +52,29 @@ public function __construct(
      */
     protected function configure(): void
     {
-        $this->setName($this->getCommandName('dev', 'inspector'))
-            ->setDescription('Enable, disable or check status of MageForge Frontend Inspector')
+        $this->setName($this->getCommandName('theme', 'inspector'))
+            ->setDescription('Manage MageForge Frontend Inspector (Actions: enable|disable|status)')
             ->addArgument(
                 self::ARGUMENT_ACTION,
                 InputArgument::REQUIRED,
                 'Action to perform: enable, disable, or status'
+            )
+            ->setHelp(
+                <<<HELP
+The <info>%command.name%</info> command manages the MageForge Frontend Inspector:
+
+  <info>php %command.full_name%</info> <comment>enable</comment>
+  Enable the inspector (requires developer mode)
+
+  <info>php %command.full_name%</info> <comment>disable</comment>
+  Disable the inspector
+
+  <info>php %command.full_name%</info> <comment>status</comment>
+  Show current inspector status
+
+The inspector allows you to hover over frontend elements to see template paths,
+block classes, modules, and other metadata. Activate with Ctrl+Shift+I.
+HELP
             );
 
         parent::configure();
@@ -168,7 +185,7 @@ private function showStatus(): int
             ]);
         } elseif (!$isEnabled) {
             $this->io->newLine();
-            $this->io->note('Run "bin/magento mageforge:dev:inspector enable" to activate the inspector.');
+            $this->io->note('Run "bin/magento mageforge:theme:inspector enable" to activate the inspector.');
         } else {
             $this->io->newLine();
             $this->io->writeln('<info>✓</info> Inspector is active and ready to use!');