Merge remote-tracking branch 'origin/1.x' into 1.x

ashleyhindle · ashleyhindle · commit 688830de7874 · 2025-07-17T13:07:25.000+01:00
diff --git a/src/BoostServiceProvider.php b/src/BoostServiceProvider.php
@@ -12,7 +12,7 @@ class BoostServiceProvider extends ServiceProvider
     public function register(): void
     {
         $this->mergeConfigFrom(
-            __DIR__ . '/../config/boost.php', 'boost'
+            __DIR__.'/../config/boost.php', 'boost'
         );
 
         $this->app->singleton(Roster::class, function () {
@@ -53,7 +53,7 @@ protected function registerPublishing(): void
     {
         if ($this->app->runningInConsole()) {
             $this->publishes([
-                __DIR__ . '/../config/boost.php' => config_path('boost.php'),
+                __DIR__.'/../config/boost.php' => config_path('boost.php'),
             ], 'boost-config');
         }
     }
@@ -63,7 +63,7 @@ protected function registerCommands(): void
         if ($this->app->runningInConsole()) {
             $this->commands([
                 Console\StartCommand::class,
-                Console\InstallCommand::class
+                Console\InstallCommand::class,
             ]);
         }
     }
diff --git a/src/Mcp/Tools/GetInertiaDoc.php b/src/Mcp/Tools/GetInertiaDoc.php
@@ -3,7 +3,6 @@
 namespace Laravel\Boost\Mcp\Tools;
 
 use Illuminate\Support\Facades\Cache;
-use Illuminate\Support\Facades\Log;
 use Illuminate\Support\Str;
 use Laravel\Boost\Concerns\MakesHttpRequests;
 use Laravel\Mcp\Server\Tool;
@@ -19,13 +18,11 @@ class GetInertiaDoc extends Tool
 {
     use MakesHttpRequests;
 
-    public function __construct(protected Roster $roster)
-    {
-    }
+    public function __construct(protected Roster $roster) {}
 
     public function description(): string
     {
-        return 'Fetch the contents of a single Inertia documentation file matching the installed major Inertia version.' . PHP_EOL .
+        return 'Fetch the contents of a single Inertia documentation file matching the installed major Inertia version.'.PHP_EOL.
             'It\'s critical you use this and the list-inertia-docs tool to get the correct documentation for this application.';
     }
 
@@ -39,7 +36,7 @@ public function schema(ToolInputSchema $schema): ToolInputSchema
     }
 
     /**
-     * @param array<string> $arguments
+     * @param  array<string>  $arguments
      */
     public function handle(array $arguments): ToolResult
     {
@@ -48,16 +45,16 @@ public function handle(array $arguments): ToolResult
             return ToolResult::error('The "filename" argument is required.');
         }
 
-        if (!Str::endsWith($filename, '.jsx')) {
+        if (! Str::endsWith($filename, '.jsx')) {
             return ToolResult::error('The "filename" argument must end with ".jsx".');
         }
 
-        if (!preg_match('/^[a-z0-9-]+\.jsx$/', $filename)) {
+        if (! preg_match('/^[a-z0-9-]+\.jsx$/', $filename)) {
             return ToolResult::error('The "filename" argument must be a valid filename (e.g. "installation.jsx").');
         }
 
         [$ref, $shouldProceed] = $this->determineVersionRef();
-        if (!$shouldProceed) {
+        if (! $shouldProceed) {
             return ToolResult::error('Inertia is not installed in this project.');
         }
 
@@ -70,14 +67,14 @@ public function handle(array $arguments): ToolResult
             /** @var \Illuminate\Http\Client\Response $response */
             $response = $this->client()->get($url);
 
-            if (!$response->successful()) {
-                return ToolResult::error('Failed to fetch Inertia doc: ' . $response->body());
+            if (! $response->successful()) {
+                return ToolResult::error('Failed to fetch Inertia doc: '.$response->body());
             }
 
             /** @var array<string,mixed> $data */
             $data = json_decode($response->body(), true, 512, JSON_THROW_ON_ERROR);
 
-            if (($data['type'] ?? '') !== 'file' || !isset($data['content'])) {
+            if (($data['type'] ?? '') !== 'file' || ! isset($data['content'])) {
                 return ToolResult::error('Unexpected response structure when fetching Inertia doc.');
             }
 
@@ -118,7 +115,7 @@ private function determineVersionRef(): array
             return ['v1', false];
         }
 
-        return ['v' . $package->majorVersion(), true];
+        return ['v'.$package->majorVersion(), true];
     }
 
     public function shouldRegister(): bool
diff --git a/src/Mcp/Tools/GetLaravelDoc.php b/src/Mcp/Tools/GetLaravelDoc.php
@@ -19,7 +19,7 @@ class GetLaravelDoc extends Tool
 
     public function description(): string
     {
-        return 'Fetch the contents of a single Laravel documentation file matching the currently installed major framework version.' . PHP_EOL .
+        return 'Fetch the contents of a single Laravel documentation file matching the currently installed major framework version.'.PHP_EOL.
             'It\'s critical you use this and the list-laravel-docs tool to get the correct documentation for this application.';
     }
 
@@ -33,7 +33,7 @@ public function schema(ToolInputSchema $schema): ToolInputSchema
     }
 
     /**
-     * @param array<string> $arguments
+     * @param  array<string>  $arguments
      */
     public function handle(array $arguments): ToolResult
     {
@@ -42,18 +42,18 @@ public function handle(array $arguments): ToolResult
             return ToolResult::error('The "filename" argument is required.');
         }
 
-        if (!Str::endsWith($filename, '.md')) {
+        if (! Str::endsWith($filename, '.md')) {
             return ToolResult::error('The "filename" argument must end with ".md".');
         }
 
-        if (!preg_match('/^[a-z0-9-]+\.md$/', $filename)) {
+        if (! preg_match('/^[a-z0-9-]+\.md$/', $filename)) {
             return ToolResult::error('The "filename" argument must be a valid filename (e.g. "installation.md").');
         }
 
         // Determine the major version (e.g. 12.x)
         $version = Application::VERSION; // e.g. "12.6.0" or "12.x-dev"
         $major = Str::before($version, '.');
-        $ref = $major . '.x';
+        $ref = $major.'.x';
 
         $cacheKey = "boost:mcp:laravel-doc:{$ref}:{$filename}";
 
@@ -64,14 +64,14 @@ public function handle(array $arguments): ToolResult
             /** @var \Illuminate\Http\Client\Response $response */
             $response = $this->client()->get($url);
 
-            if (!$response->successful()) {
-                return ToolResult::error('Failed to fetch Laravel doc: ' . $response->body());
+            if (! $response->successful()) {
+                return ToolResult::error('Failed to fetch Laravel doc: '.$response->body());
             }
 
             /** @var array<string,mixed> $data */
             $data = json_decode($response->body(), true, 512, JSON_THROW_ON_ERROR);
 
-            if (($data['type'] ?? '') !== 'file' || !isset($data['content'])) {
+            if (($data['type'] ?? '') !== 'file' || ! isset($data['content'])) {
                 return ToolResult::error('Unexpected response structure when fetching Laravel doc.');
             }
 
diff --git a/src/Mcp/Tools/ListInertiaDocs.php b/src/Mcp/Tools/ListInertiaDocs.php
@@ -17,13 +17,11 @@ class ListInertiaDocs extends Tool
 {
     use MakesHttpRequests;
 
-    public function __construct(protected Roster $roster)
-    {
-    }
+    public function __construct(protected Roster $roster) {}
 
     public function description(): string
     {
-        return 'List all Inertia documentation files available for the installed major Inertia version.' . PHP_EOL .
+        return 'List all Inertia documentation files available for the installed major Inertia version.'.PHP_EOL.
             'It\'s critical you use this and the get-inertia-doc tool to get the correct documentation for this application.';
     }
 
@@ -34,12 +32,12 @@ public function schema(ToolInputSchema $schema): ToolInputSchema
     }
 
     /**
-     * @param array<string> $arguments
+     * @param  array<string>  $arguments
      */
     public function handle(array $arguments): ToolResult
     {
         [$ref, $shouldProceed] = $this->determineVersionRef();
-        if (!$shouldProceed) {
+        if (! $shouldProceed) {
             return ToolResult::error('Inertia is not installed in this project.');
         }
 
@@ -52,15 +50,15 @@ public function handle(array $arguments): ToolResult
             /** @var \Illuminate\Http\Client\Response $response */
             $response = $this->client()->get($url);
 
-            if (!$response->successful()) {
-                return ToolResult::error('Failed to fetch Inertia docs list: ' . $response->body());
+            if (! $response->successful()) {
+                return ToolResult::error('Failed to fetch Inertia docs list: '.$response->body());
             }
 
             /** @var array<int,array<string,mixed>> $data */
             $data = json_decode($response->body(), true, 512, JSON_THROW_ON_ERROR);
 
             return collect($data)
-                ->filter(fn($item) => ($item['type'] ?? '') === 'file')
+                ->filter(fn ($item) => ($item['type'] ?? '') === 'file')
                 ->pluck('name')
                 ->values()
                 ->all();
@@ -93,7 +91,7 @@ private function determineVersionRef(): array
             return ['v1', false];
         }
 
-        return ['v' . $package->majorVersion(), true];
+        return ['v'.$package->majorVersion(), true];
     }
 
     public function shouldRegister(): bool
diff --git a/src/Mcp/Tools/ListLaravelDocs.php b/src/Mcp/Tools/ListLaravelDocs.php
@@ -19,7 +19,7 @@ class ListLaravelDocs extends Tool
 
     public function description(): string
     {
-        return 'List all documentation files available for the currently installed major Laravel framework version.' . PHP_EOL .
+        return 'List all documentation files available for the currently installed major Laravel framework version.'.PHP_EOL.
             'It\'s critical you use this and the get-laravel-doc tool to get the correct documentation for this application.';
     }
 
@@ -30,14 +30,14 @@ public function schema(ToolInputSchema $schema): ToolInputSchema
     }
 
     /**
-     * @param array<string> $arguments
+     * @param  array<string>  $arguments
      */
     public function handle(array $arguments): ToolResult
     {
         // Determine the major version (e.g. 12.x)
         $version = Application::VERSION; // e.g. "12.6.0" or "12.x-dev"
         $major = Str::before($version, '.');
-        $ref = $major . '.x';
+        $ref = $major.'.x';
 
         $cacheKey = "boost:mcp:laravel-docs-list:{$ref}";
 
@@ -47,16 +47,16 @@ public function handle(array $arguments): ToolResult
             /** @var \Illuminate\Http\Client\Response $response */
             $response = $this->client()->get($url);
 
-            if (!$response->successful()) {
-                return ToolResult::error('Failed to fetch Laravel docs list: ' . $response->body());
+            if (! $response->successful()) {
+                return ToolResult::error('Failed to fetch Laravel docs list: '.$response->body());
             }
 
             /** @var array<int,array<string,mixed>> $data */
             $data = json_decode($response->body(), true, 512, JSON_THROW_ON_ERROR);
 
             // Extract only file names (exclude directories)
             return collect($data)
-                ->filter(fn($item) => ($item['type'] ?? '') === 'file')
+                ->filter(fn ($item) => ($item['type'] ?? '') === 'file')
                 ->pluck('name')
                 ->values()
                 ->all();

Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@ class BoostServiceProvider extends ServiceProvider`
`12`	`12`	`public function register(): void`
`13`	`13`	`{`
`14`	`14`	`$this->mergeConfigFrom(`
`15`		`- __DIR__ . '/../config/boost.php', 'boost'`
	`15`	`+ __DIR__.'/../config/boost.php', 'boost'`
`16`	`16`	`);`
`17`	`17`
`18`	`18`	`$this->app->singleton(Roster::class, function () {`
`@@ -53,7 +53,7 @@ protected function registerPublishing(): void`
`53`	`53`	`{`
`54`	`54`	`if ($this->app->runningInConsole()) {`
`55`	`55`	`$this->publishes([`
`56`		`- __DIR__ . '/../config/boost.php' => config_path('boost.php'),`
	`56`	`+ __DIR__.'/../config/boost.php' => config_path('boost.php'),`
`57`	`57`	`], 'boost-config');`
`58`	`58`	`}`
`59`	`59`	`}`
`@@ -63,7 +63,7 @@ protected function registerCommands(): void`
`63`	`63`	`if ($this->app->runningInConsole()) {`
`64`	`64`	`$this->commands([`
`65`	`65`	`Console\StartCommand::class,`
`66`		`- Console\InstallCommand::class`
	`66`	`+ Console\InstallCommand::class,`
`67`	`67`	`]);`
`68`	`68`	`}`
`69`	`69`	`}`
Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,6 @@`
`3`	`3`	`namespace Laravel\Boost\Mcp\Tools;`
`4`	`4`
`5`	`5`	`use Illuminate\Support\Facades\Cache;`
`6`		`-use Illuminate\Support\Facades\Log;`
`7`	`6`	`use Illuminate\Support\Str;`
`8`	`7`	`use Laravel\Boost\Concerns\MakesHttpRequests;`
`9`	`8`	`use Laravel\Mcp\Server\Tool;`
`@@ -19,13 +18,11 @@ class GetInertiaDoc extends Tool`
`19`	`18`	`{`
`20`	`19`	`use MakesHttpRequests;`
`21`	`20`
`22`		`- public function __construct(protected Roster $roster)`
`23`		`- {`
`24`		`- }`
	`21`	`+ public function __construct(protected Roster $roster) {}`
`25`	`22`
`26`	`23`	`public function description(): string`
`27`	`24`	`{`
`28`		`- return 'Fetch the contents of a single Inertia documentation file matching the installed major Inertia version.' . PHP_EOL .`
	`25`	`+ return 'Fetch the contents of a single Inertia documentation file matching the installed major Inertia version.'.PHP_EOL.`
`29`	`26`	`'It\'s critical you use this and the list-inertia-docs tool to get the correct documentation for this application.';`
`30`	`27`	`}`
`31`	`28`
`@@ -39,7 +36,7 @@ public function schema(ToolInputSchema $schema): ToolInputSchema`
`39`	`36`	`}`
`40`	`37`
`41`	`38`	`/**`
`42`		`- * @param array<string> $arguments`
	`39`	`+ * @param array<string> $arguments`
`43`	`40`	`*/`
`44`	`41`	`public function handle(array $arguments): ToolResult`
`45`	`42`	`{`
`@@ -48,16 +45,16 @@ public function handle(array $arguments): ToolResult`
`48`	`45`	`return ToolResult::error('The "filename" argument is required.');`
`49`	`46`	`}`
`50`	`47`
`51`		`- if (!Str::endsWith($filename, '.jsx')) {`
	`48`	`+ if (! Str::endsWith($filename, '.jsx')) {`
`52`	`49`	`return ToolResult::error('The "filename" argument must end with ".jsx".');`
`53`	`50`	`}`
`54`	`51`
`55`		`- if (!preg_match('/^[a-z0-9-]+\.jsx$/', $filename)) {`
	`52`	`+ if (! preg_match('/^[a-z0-9-]+\.jsx$/', $filename)) {`
`56`	`53`	`return ToolResult::error('The "filename" argument must be a valid filename (e.g. "installation.jsx").');`
`57`	`54`	`}`
`58`	`55`
`59`	`56`	`[$ref, $shouldProceed] = $this->determineVersionRef();`
`60`		`- if (!$shouldProceed) {`
	`57`	`+ if (! $shouldProceed) {`
`61`	`58`	`return ToolResult::error('Inertia is not installed in this project.');`
`62`	`59`	`}`
`63`	`60`
`@@ -70,14 +67,14 @@ public function handle(array $arguments): ToolResult`
`70`	`67`	`/** @var \Illuminate\Http\Client\Response $response */`
`71`	`68`	`$response = $this->client()->get($url);`
`72`	`69`
`73`		`- if (!$response->successful()) {`
`74`		`- return ToolResult::error('Failed to fetch Inertia doc: ' . $response->body());`
	`70`	`+ if (! $response->successful()) {`
	`71`	`+ return ToolResult::error('Failed to fetch Inertia doc: '.$response->body());`
`75`	`72`	`}`
`76`	`73`
`77`	`74`	`/** @var array<string,mixed> $data */`
`78`	`75`	`$data = json_decode($response->body(), true, 512, JSON_THROW_ON_ERROR);`
`79`	`76`
`80`		`- if (($data['type'] ?? '') !== 'file' \|\| !isset($data['content'])) {`
	`77`	`+ if (($data['type'] ?? '') !== 'file' \|\| ! isset($data['content'])) {`
`81`	`78`	`return ToolResult::error('Unexpected response structure when fetching Inertia doc.');`
`82`	`79`	`}`
`83`	`80`
`@@ -118,7 +115,7 @@ private function determineVersionRef(): array`
`118`	`115`	`return ['v1', false];`
`119`	`116`	`}`
`120`	`117`
`121`		`- return ['v' . $package->majorVersion(), true];`
	`118`	`+ return ['v'.$package->majorVersion(), true];`
`122`	`119`	`}`
`123`	`120`
`124`	`121`	`public function shouldRegister(): bool`
Original file line number	Diff line number	Diff line change
`@@ -19,7 +19,7 @@ class GetLaravelDoc extends Tool`
`19`	`19`
`20`	`20`	`public function description(): string`
`21`	`21`	`{`
`22`		`- return 'Fetch the contents of a single Laravel documentation file matching the currently installed major framework version.' . PHP_EOL .`
	`22`	`+ return 'Fetch the contents of a single Laravel documentation file matching the currently installed major framework version.'.PHP_EOL.`
`23`	`23`	`'It\'s critical you use this and the list-laravel-docs tool to get the correct documentation for this application.';`
`24`	`24`	`}`
`25`	`25`
`@@ -33,7 +33,7 @@ public function schema(ToolInputSchema $schema): ToolInputSchema`
`33`	`33`	`}`
`34`	`34`
`35`	`35`	`/**`
`36`		`- * @param array<string> $arguments`
	`36`	`+ * @param array<string> $arguments`
`37`	`37`	`*/`
`38`	`38`	`public function handle(array $arguments): ToolResult`
`39`	`39`	`{`
`@@ -42,18 +42,18 @@ public function handle(array $arguments): ToolResult`
`42`	`42`	`return ToolResult::error('The "filename" argument is required.');`
`43`	`43`	`}`
`44`	`44`
`45`		`- if (!Str::endsWith($filename, '.md')) {`
	`45`	`+ if (! Str::endsWith($filename, '.md')) {`
`46`	`46`	`return ToolResult::error('The "filename" argument must end with ".md".');`
`47`	`47`	`}`
`48`	`48`
`49`		`- if (!preg_match('/^[a-z0-9-]+\.md$/', $filename)) {`
	`49`	`+ if (! preg_match('/^[a-z0-9-]+\.md$/', $filename)) {`
`50`	`50`	`return ToolResult::error('The "filename" argument must be a valid filename (e.g. "installation.md").');`
`51`	`51`	`}`
`52`	`52`
`53`	`53`	`// Determine the major version (e.g. 12.x)`
`54`	`54`	`$version = Application::VERSION; // e.g. "12.6.0" or "12.x-dev"`
`55`	`55`	`$major = Str::before($version, '.');`
`56`		`- $ref = $major . '.x';`
	`56`	`+ $ref = $major.'.x';`
`57`	`57`
`58`	`58`	`$cacheKey = "boost:mcp:laravel-doc:{$ref}:{$filename}";`
`59`	`59`
`@@ -64,14 +64,14 @@ public function handle(array $arguments): ToolResult`
`64`	`64`	`/** @var \Illuminate\Http\Client\Response $response */`
`65`	`65`	`$response = $this->client()->get($url);`
`66`	`66`
`67`		`- if (!$response->successful()) {`
`68`		`- return ToolResult::error('Failed to fetch Laravel doc: ' . $response->body());`
	`67`	`+ if (! $response->successful()) {`
	`68`	`+ return ToolResult::error('Failed to fetch Laravel doc: '.$response->body());`
`69`	`69`	`}`
`70`	`70`
`71`	`71`	`/** @var array<string,mixed> $data */`
`72`	`72`	`$data = json_decode($response->body(), true, 512, JSON_THROW_ON_ERROR);`
`73`	`73`
`74`		`- if (($data['type'] ?? '') !== 'file' \|\| !isset($data['content'])) {`
	`74`	`+ if (($data['type'] ?? '') !== 'file' \|\| ! isset($data['content'])) {`
`75`	`75`	`return ToolResult::error('Unexpected response structure when fetching Laravel doc.');`
`76`	`76`	`}`
`77`	`77`
Original file line number	Diff line number	Diff line change
`@@ -17,13 +17,11 @@ class ListInertiaDocs extends Tool`
`17`	`17`	`{`
`18`	`18`	`use MakesHttpRequests;`
`19`	`19`
`20`		`- public function __construct(protected Roster $roster)`
`21`		`- {`
`22`		`- }`
	`20`	`+ public function __construct(protected Roster $roster) {}`
`23`	`21`
`24`	`22`	`public function description(): string`
`25`	`23`	`{`
`26`		`- return 'List all Inertia documentation files available for the installed major Inertia version.' . PHP_EOL .`
	`24`	`+ return 'List all Inertia documentation files available for the installed major Inertia version.'.PHP_EOL.`
`27`	`25`	`'It\'s critical you use this and the get-inertia-doc tool to get the correct documentation for this application.';`
`28`	`26`	`}`
`29`	`27`
`@@ -34,12 +32,12 @@ public function schema(ToolInputSchema $schema): ToolInputSchema`
`34`	`32`	`}`
`35`	`33`
`36`	`34`	`/**`
`37`		`- * @param array<string> $arguments`
	`35`	`+ * @param array<string> $arguments`
`38`	`36`	`*/`
`39`	`37`	`public function handle(array $arguments): ToolResult`
`40`	`38`	`{`
`41`	`39`	`[$ref, $shouldProceed] = $this->determineVersionRef();`
`42`		`- if (!$shouldProceed) {`
	`40`	`+ if (! $shouldProceed) {`
`43`	`41`	`return ToolResult::error('Inertia is not installed in this project.');`
`44`	`42`	`}`
`45`	`43`
`@@ -52,15 +50,15 @@ public function handle(array $arguments): ToolResult`
`52`	`50`	`/** @var \Illuminate\Http\Client\Response $response */`
`53`	`51`	`$response = $this->client()->get($url);`
`54`	`52`
`55`		`- if (!$response->successful()) {`
`56`		`- return ToolResult::error('Failed to fetch Inertia docs list: ' . $response->body());`
	`53`	`+ if (! $response->successful()) {`
	`54`	`+ return ToolResult::error('Failed to fetch Inertia docs list: '.$response->body());`
`57`	`55`	`}`
`58`	`56`
`59`	`57`	`/** @var array<int,array<string,mixed>> $data */`
`60`	`58`	`$data = json_decode($response->body(), true, 512, JSON_THROW_ON_ERROR);`
`61`	`59`
`62`	`60`	`return collect($data)`
`63`		`- ->filter(fn($item) => ($item['type'] ?? '') === 'file')`
	`61`	`+ ->filter(fn ($item) => ($item['type'] ?? '') === 'file')`
`64`	`62`	`->pluck('name')`
`65`	`63`	`->values()`
`66`	`64`	`->all();`
`@@ -93,7 +91,7 @@ private function determineVersionRef(): array`
`93`	`91`	`return ['v1', false];`
`94`	`92`	`}`
`95`	`93`
`96`		`- return ['v' . $package->majorVersion(), true];`
	`94`	`+ return ['v'.$package->majorVersion(), true];`
`97`	`95`	`}`
`98`	`96`
`99`	`97`	`public function shouldRegister(): bool`