refactor: replace Agent and Ide contracts with CodingAgent and McpClient

- Removed `Agent` and `Ide` contracts, introducing `CodingAgent` and `McpClient` interfaces.
- Updated `CodeEnvironment` subclasses to implement the new contracts.
- Renamed and adjusted methods in `CodeEnvironment` for better clarity (`supportsAgent` -> `isCodingAgent`, `supportsIde` -> `isMcpClient`).
- Updated `GuidelineWriter` and related tests to use `CodingAgent`.
- Simplified `InstallCommand` filtering logic by adopting new contract methods.

Author: pushpak1300

src/Console/InstallCommand.php

@@ -294,22 +294,19 @@ private function selectCodeEnvironments(string $type, string $label): Collection
     {
         $allEnvironments = $this->codeEnvironmentsDetector->getCodeEnvironments();
 
-        // Filter by type capability
         $availableEnvironments = $allEnvironments->filter(function (CodeEnvironment $environment) use ($type) {
-            return ($type === 'ide' && $environment->supportsIde()) ||
-                   ($type === 'agent' && $environment->supportsAgent());
+            return ($type === 'ide' && $environment->isMcpClient()) ||
+                   ($type === 'agent' && $environment->IsCodingAgent());
         });
 
         if ($availableEnvironments->isEmpty()) {
             return collect();
         }
 
-        // Build options for multiselect
         $options = $availableEnvironments->mapWithKeys(function (CodeEnvironment $environment) {
             return [get_class($environment) => $environment->displayName()];
         })->sort();
 
-        // Auto-detect installed environments
         $detectedClasses = [];
         $installedEnvNames = array_unique(array_merge(
             $this->projectInstalledCodeEnvironments,

src/Contracts/Agent.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Laravel\Boost\Contracts;
+
+/**
+ * Agent contract for AI coding assistants that receive guidelines.
+ */
+interface CodingAgent
+{
+    /**
+     * Get the file path where AI guidelines should be written.
+     *
+     * @return string The relative or absolute path to the guideline file
+     */
+    public function guidelinesPath(): string;
+
+    /**
+     * Determine if the guideline file requires frontmatter.
+     *
+     * @return bool
+     */
+    public function frontmatter(): bool;
+}

src/Contracts/CodingAgent.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Laravel\Boost\Contracts;
+
+/**
+ * Contract for code editors that support MCP (Model Context Protocol).
+ */
+interface McpClient
+{
+    /**
+     * Install an MCP server configuration in this IDE.
+     *
+     * @param string $key Server identifier/name
+     * @param string $command Executable command to run the MCP server
+     * @param array<int, string> $args Command line arguments
+     * @param array<string, string> $env Environment variables
+     * @return bool True if installation succeeded, false otherwise
+     */
+    public function installMcp(string $key, string $command, array $args = [], array $env = []): bool;
+}

src/Contracts/Ide.php

@@ -4,12 +4,12 @@
 
 namespace Laravel\Boost\Install\CodeEnvironment;
 
-use Laravel\Boost\Contracts\Agent;
-use Laravel\Boost\Contracts\Ide;
+use Laravel\Boost\Contracts\CodingAgent;
+use Laravel\Boost\Contracts\McpClient;
 use Laravel\Boost\Install\Enums\McpInstallationStrategy;
 use Laravel\Boost\Install\Enums\Platform;
 
-class ClaudeCode extends CodeEnvironment implements Agent, Ide
+class ClaudeCode extends CodeEnvironment implements CodingAgent, McpClient
 {
     public function name(): string
     {

src/Contracts/McpClient.php

@@ -7,8 +7,8 @@
 use Illuminate\Contracts\Filesystem\FileNotFoundException;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\Facades\Process;
-use Laravel\Boost\Contracts\Agent;
-use Laravel\Boost\Contracts\Ide;
+use Laravel\Boost\Contracts\CodingAgent;
+use Laravel\Boost\Contracts\McpClient;
 use Laravel\Boost\Install\Detection\DetectionStrategyFactory;
 use Laravel\Boost\Install\Enums\McpInstallationStrategy;
 use Laravel\Boost\Install\Enums\Platform;
@@ -102,19 +102,19 @@ public function ideName(): ?string
      *
      * @return bool
      */
-    public function supportsAgent(): bool
+    public function IsCodingAgent(): bool
     {
-        return $this->agentName() !== null && $this instanceof Agent;
+        return $this->agentName() !== null && $this instanceof CodingAgent;
     }
 
     /**
      * Determine if this environment supports IDE/MCP functionality.
      *
      * @return bool
      */
-    public function supportsIde(): bool
+    public function isMcpClient(): bool
     {
-        return $this->ideName() !== null && $this instanceof Ide;
+        return $this->ideName() !== null && $this instanceof McpClient;
     }
 
     /**
@@ -236,10 +236,8 @@ protected function installFileMcp(string $key, string $command, array $args = []
             return false;
         }
 
-        // Ensure directory exists
         File::ensureDirectoryExists(dirname($path));
 
-        // Load existing configuration
         $config = File::exists($path)
             ? json_decode(File::get($path), true) ?: []
             : [];

src/Install/CodeEnvironment/ClaudeCode.php

@@ -4,10 +4,10 @@
 
 namespace Laravel\Boost\Install\CodeEnvironment;
 
-use Laravel\Boost\Contracts\Agent;
+use Laravel\Boost\Contracts\CodingAgent;
 use Laravel\Boost\Install\Enums\Platform;
 
-class Copilot extends CodeEnvironment implements Agent
+class Copilot extends CodeEnvironment implements CodingAgent
 {
     public function name(): string
     {

src/Install/CodeEnvironment/CodeEnvironment.php

@@ -4,12 +4,12 @@
 
 namespace Laravel\Boost\Install\CodeEnvironment;
 
-use Laravel\Boost\Contracts\Agent;
-use Laravel\Boost\Contracts\Ide;
+use Laravel\Boost\Contracts\CodingAgent;
+use Laravel\Boost\Contracts\McpClient;
 use Laravel\Boost\Install\Enums\McpInstallationStrategy;
 use Laravel\Boost\Install\Enums\Platform;
 
-class Cursor extends CodeEnvironment implements Agent, Ide
+class Cursor extends CodeEnvironment implements CodingAgent, McpClient
 {
     public function name(): string
     {

src/Install/CodeEnvironment/Copilot.php

@@ -4,12 +4,12 @@
 
 namespace Laravel\Boost\Install\CodeEnvironment;
 
-use Laravel\Boost\Contracts\Agent;
-use Laravel\Boost\Contracts\Ide;
+use Laravel\Boost\Contracts\CodingAgent;
+use Laravel\Boost\Contracts\McpClient;
 use Laravel\Boost\Install\Enums\McpInstallationStrategy;
 use Laravel\Boost\Install\Enums\Platform;
 
-class PhpStorm extends CodeEnvironment implements Agent, Ide
+class PhpStorm extends CodeEnvironment implements CodingAgent, McpClient
 {
     public function name(): string
     {