Add hooks for registering third party code environments

Signed-off-by: Pushpak Chhajed <[email protected]>

Author: pushpak1300

src/Boost.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Laravel\Boost;
+
+use Illuminate\Support\Facades\Facade;
+
+/**
+ * @method static void registerCodeEnvironment(string $key, string $className)
+ * @method static array getCodeEnvironments()
+ *
+ * @see \Laravel\Boost\BoostManager
+ */
+class Boost extends Facade
+{
+    protected static function getFacadeAccessor(): string
+    {
+        return BoostManager::class;
+    }
+}

src/BoostManager.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Laravel\Boost;
+
+use Laravel\Boost\Install\CodeEnvironment\ClaudeCode;
+use Laravel\Boost\Install\CodeEnvironment\CodeEnvironment;
+use Laravel\Boost\Install\CodeEnvironment\Codex;
+use Laravel\Boost\Install\CodeEnvironment\Copilot;
+use Laravel\Boost\Install\CodeEnvironment\Cursor;
+use Laravel\Boost\Install\CodeEnvironment\PhpStorm;
+use Laravel\Boost\Install\CodeEnvironment\VSCode;
+
+class BoostManager
+{
+    /** @var array<string, class-string<CodeEnvironment>> */
+    private array $codeEnvironments = [
+        'phpstorm' => PhpStorm::class,
+        'vscode' => VSCode::class,
+        'cursor' => Cursor::class,
+        'claudecode' => ClaudeCode::class,
+        'codex' => Codex::class,
+        'copilot' => Copilot::class,
+    ];
+
+    /**
+     * @param  class-string<CodeEnvironment>  $className
+     */
+    public function registerCodeEnvironment(string $key, string $className): void
+    {
+        if (array_key_exists($key, $this->codeEnvironments)) {
+            return;
+        }
+
+        $this->codeEnvironments[$key] = $className;
+    }
+
+    /**
+     * @return array<string, class-string<CodeEnvironment>>
+     */
+    public function getCodeEnvironments(): array
+    {
+        return $this->codeEnvironments;
+    }
+}

src/BoostServiceProvider.php

@@ -26,6 +26,8 @@ public function register(): void
             'boost'
         );
 
+        $this->app->singleton(BoostManager::class, fn (): BoostManager => new BoostManager);
+
         if (! $this->shouldRun()) {
             return;
         }

src/Install/CodeEnvironment/CodeEnvironment.php

@@ -4,7 +4,6 @@
 
 namespace Laravel\Boost\Install\CodeEnvironment;
 
-use Illuminate\Contracts\Filesystem\FileNotFoundException;
 use Illuminate\Support\Facades\Process;
 use Laravel\Boost\Contracts\Agent;
 use Laravel\Boost\Contracts\McpClient;
@@ -118,8 +117,6 @@ public function mcpConfigKey(): string
      *
      * @param  array<int, string>  $args
      * @param  array<string, string>  $env
-     *
-     * @throws FileNotFoundException
      */
     public function installMcp(string $key, string $command, array $args = [], array $env = []): bool
     {
@@ -176,8 +173,6 @@ protected function installShellMcp(string $key, string $command, array $args = [
      *
      * @param  array<int, string>  $args
      * @param  array<string, string>  $env
-     *
-     * @throws FileNotFoundException
      */
     protected function installFileMcp(string $key, string $command, array $args = [], array $env = []): bool
     {

src/Install/CodeEnvironmentsDetector.php

@@ -6,29 +6,15 @@
 
 use Illuminate\Container\Container;
 use Illuminate\Support\Collection;
-use Laravel\Boost\Install\CodeEnvironment\ClaudeCode;
+use Laravel\Boost\BoostManager;
 use Laravel\Boost\Install\CodeEnvironment\CodeEnvironment;
-use Laravel\Boost\Install\CodeEnvironment\Codex;
-use Laravel\Boost\Install\CodeEnvironment\Copilot;
-use Laravel\Boost\Install\CodeEnvironment\Cursor;
-use Laravel\Boost\Install\CodeEnvironment\PhpStorm;
-use Laravel\Boost\Install\CodeEnvironment\VSCode;
 use Laravel\Boost\Install\Enums\Platform;
 
 class CodeEnvironmentsDetector
 {
-    /** @var array<string, class-string<CodeEnvironment>> */
-    private array $programs = [
-        'phpstorm' => PhpStorm::class,
-        'vscode' => VSCode::class,
-        'cursor' => Cursor::class,
-        'claudecode' => ClaudeCode::class,
-        'codex' => Codex::class,
-        'copilot' => Copilot::class,
-    ];
-
     public function __construct(
-        private readonly Container $container
+        private readonly Container $container,
+        private readonly BoostManager $boostManager
     ) {}
 
     /**
@@ -68,6 +54,7 @@ public function discoverProjectInstalledCodeEnvironments(string $basePath): arra
      */
     public function getCodeEnvironments(): Collection
     {
-        return collect($this->programs)->map(fn (string $className) => $this->container->make($className));
+        return collect($this->boostManager->getCodeEnvironments())
+            ->map(fn (string $className) => $this->container->make($className));
     }
 }

tests/Feature/BoostFacadeTest.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+use Laravel\Boost\Boost;
+use Laravel\Boost\BoostManager;
+use Tests\Unit\Install\ExampleCodeEnvironment;
+
+it('Boost Facade resolves to BoostManager instance', function (): void {
+    $instance = Boost::getFacadeRoot();
+
+    expect($instance)->toBeInstanceOf(BoostManager::class);
+});
+
+it('Boost Facade registers code environments via facade', function (): void {
+    Boost::registerCodeEnvironment('example1', ExampleCodeEnvironment::class);
+    Boost::registerCodeEnvironment('example2', ExampleCodeEnvironment::class);
+    $registered = Boost::getFacadeRoot()->getCodeEnvironments();
+
+    expect($registered)->toHaveKey('example1')
+        ->and($registered['example1'])->toBe(ExampleCodeEnvironment::class)
+        ->and($registered)->toHaveKey('example2')
+        ->and($registered['example2'])->toBe(ExampleCodeEnvironment::class)
+        ->and($registered)->toHaveKey('phpstorm');
+});
+
+it('Boost Facade maintains registration state across facade calls', function (): void {
+    Boost::registerCodeEnvironment('persistent', 'Test\Persistent');
+
+    $registered = Boost::getFacadeRoot()->getCodeEnvironments();
+
+    expect($registered)->toHaveKey('persistent')
+        ->and($registered['persistent'])->toBe('Test\Persistent');
+});

tests/Feature/BoostServiceProviderTest.php

@@ -3,6 +3,8 @@
 declare(strict_types=1);
 
 use Illuminate\Support\Facades\Config;
+use Laravel\Boost\Boost;
+use Laravel\Boost\BoostManager;
 use Laravel\Boost\BoostServiceProvider;
 
 beforeEach(function (): void {
@@ -74,3 +76,24 @@
         });
     });
 });
+
+describe('BoostManager registration', function (): void {
+    it('registers BoostManager in the container', function (): void {
+        expect(app()->bound(BoostManager::class))->toBeTrue()
+            ->and(app(BoostManager::class))->toBeInstanceOf(BoostManager::class);
+    });
+
+    it('registers BoostManager as a singleton', function (): void {
+        $instance1 = app(BoostManager::class);
+        $instance2 = app(BoostManager::class);
+
+        expect($instance1)->toBe($instance2);
+    });
+
+    it('binds Boost facade to the same BoostManager instance', function (): void {
+        $containerInstance = app(BoostManager::class);
+        $facadeInstance = Boost::getFacadeRoot();
+
+        expect($facadeInstance)->toBe($containerInstance);
+    });
+});

tests/Unit/BoostManagerTest.php

@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+use Laravel\Boost\BoostManager;
+use Laravel\Boost\Install\CodeEnvironment\ClaudeCode;
+use Laravel\Boost\Install\CodeEnvironment\Codex;
+use Laravel\Boost\Install\CodeEnvironment\Copilot;
+use Laravel\Boost\Install\CodeEnvironment\Cursor;
+use Laravel\Boost\Install\CodeEnvironment\PhpStorm;
+use Laravel\Boost\Install\CodeEnvironment\VSCode;
+use Tests\Unit\Install\ExampleCodeEnvironment;
+
+it('return default code environments', function (): void {
+    $manager = new BoostManager;
+    $registered = $manager->getCodeEnvironments();
+
+    expect($registered)->toMatchArray([
+        'phpstorm' => PhpStorm::class,
+        'vscode' => VSCode::class,
+        'cursor' => Cursor::class,
+        'claudecode' => ClaudeCode::class,
+        'codex' => Codex::class,
+        'copilot' => Copilot::class,
+    ]);
+});
+
+it('can register a single code environment', function (): void {
+    $manager = new BoostManager;
+    $manager->registerCodeEnvironment('example', ExampleCodeEnvironment::class);
+
+    $registered = $manager->getCodeEnvironments();
+
+    expect($registered)->toHaveKey('example')
+        ->and($registered['example'])->toBe(ExampleCodeEnvironment::class)
+        ->and($registered)->toHaveKey('phpstorm');
+});
+
+it('can register multiple code environments', function (): void {
+    $manager = new BoostManager;
+    $manager->registerCodeEnvironment('example1', ExampleCodeEnvironment::class);
+    $manager->registerCodeEnvironment('example2', ExampleCodeEnvironment::class);
+
+    $registered = $manager->getCodeEnvironments();
+
+    expect($registered)->toHaveKey('example1')->toHaveKey('example2')
+        ->and($registered['example1'])->toBe(ExampleCodeEnvironment::class)
+        ->and($registered['example2'])->toBe(ExampleCodeEnvironment::class)
+        ->and($registered)->toHaveKey('phpstorm');
+});
+
+it('does not overwrite default code environments', function (): void {
+    $manager = new BoostManager;
+    $manager->registerCodeEnvironment('phpstorm', PHPStorm::class);
+    $manager->registerCodeEnvironment('phpstorm', ExampleCodeEnvironment::class);
+
+    $registered = $manager->getCodeEnvironments();
+
+    expect($registered)->toHaveKey('phpstorm')
+        ->and($registered['phpstorm'])->toBe(PHPStorm::class)
+        ->and($registered['phpstorm'])->not()->toBe(ExampleCodeEnvironment::class);
+});