Function validateMCPServerConfiguration

pkg/cli/mcp_validation.go:173–225

validateMCPServerConfiguration validates that the CLI is properly configured by running the status command as a test. Diagnostics are emitted through the debug logger only.

(ctx context.Context, cmdPath string, env []string)

// by running the status command as a test.
// Diagnostics are emitted through the debug logger only.
func validateMCPServerConfiguration(ctx context.Context, cmdPath string, env []string) error {
	mcpValidationLog.Printf("Validating MCP server configuration: cmdPath=%s", cmdPath)

	// Determine, log, and validate the binary path only if --cmd flag is not provided
	// When --cmd is provided, the user explicitly specified the binary path to use
	if cmdPath == "" {
		// Attempt to detect the binary path and assign it to cmdPath
		// This ensures the validation uses the actual binary path instead of falling back to "gh aw"
		detectedPath, err := logAndValidateBinaryPath()
		if err == nil && detectedPath != "" {
			cmdPath = detectedPath
		}
	}

	// Try to run the status command to verify CLI is working
	ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
	defer cancel()

	var cmd *exec.Cmd
	if cmdPath != "" {
		mcpValidationLog.Printf("Using custom command path: %s", cmdPath)
		// Use custom command path
		cmd = exec.CommandContext(ctx, cmdPath, "status")
	} else {
		mcpValidationLog.Print("Using default gh aw command with proper token handling")
		// Use default gh aw command with proper token handling
		cmd = workflow.ExecGHContext(ctx, "aw", "status")
	}
	if env != nil {
		cmd.Env = append([]string(nil), env...)
	}
	output, err := runMCPSubprocessCombinedOutput(ctx, cmd)

	if err != nil {
		// Check for common error cases
		if errors.Is(ctx.Err(), context.DeadlineExceeded) {
			mcpValidationLog.Print("Status command timed out")
			return errors.New("status command timed out - this may indicate a configuration issue")
		}

		mcpValidationLog.Printf("Status command failed: %v", err)

		// If the command failed, provide helpful error message
		if cmdPath != "" {
			return fmt.Errorf("failed to run status command with custom command '%s': %w\nOutput: %s\n\nPlease ensure:\n  - The command path is correct and executable\n  - You are in a git repository with .github/workflows directory", cmdPath, err, string(output))
		}
		return fmt.Errorf("failed to run status command: %w\nOutput: %s\n\nPlease ensure:\n  - gh CLI is installed and in PATH\n  - gh aw extension is installed (run: gh extension install github/gh-aw)\n  - You are in a git repository with .github/workflows directory", err, string(output))
	}

	// Status command succeeded - configuration is valid
	mcpValidationLog.Print("MCP server configuration validated successfully")
	return nil
}

// validateMCPWorkflowName validates that a workflow name exists in the repository.
// Returns nil if the workflow exists, or an error with suggestions if not.