StartOptions.cs

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.

using System.IO.Abstractions;
using Azure.DataApiBuilder.Config;
using Azure.DataApiBuilder.Product;
using Cli.Constants;
using CommandLine;
using Microsoft.Extensions.Logging;
using static Cli.Utils;

namespace Cli.Commands
{
    /// <summary>
    /// Start command options
    /// </summary>
    [Verb("start", isDefault: false, HelpText = "Start Data Api Builder Engine", Hidden = false)]
    public class StartOptions : Options
    {
        private const string LOGLEVEL_HELPTEXT = "Specifies logging level as provided value. For possible values, see: https://go.microsoft.com/fwlink/?linkid=2263106";

        public LogBuffer CliBuffer { get; }

        public StartOptions(bool verbose, LogLevel? logLevel, bool isHttpsRedirectionDisabled, bool mcpStdio, string? mcpRole, string config)
            : base(config)
        {
            // When verbose is true we set LogLevel to information.
            LogLevel = verbose is true ? Microsoft.Extensions.Logging.LogLevel.Information : logLevel;
            IsHttpsRedirectionDisabled = isHttpsRedirectionDisabled;
            McpStdio = mcpStdio;
            McpRole = mcpRole;
            CliBuffer = new LogBuffer();
        }

        // SetName defines mutually exclusive sets, ie: can not have
        // both verbose and LogLevel.
        [Option("verbose", SetName = "verbose", Required = false, HelpText = "Specifies logging level as informational.")]
        public bool Verbose { get; }

        [Option("LogLevel", SetName = "LogLevel", Required = false, HelpText = LOGLEVEL_HELPTEXT)]
        public LogLevel? LogLevel { get; }

        [Option("no-https-redirect", Required = false, HelpText = "Disables automatic https redirects.")]
        public bool IsHttpsRedirectionDisabled { get; }

        [Option("mcp-stdio", Required = false, HelpText = "Run Data API Builder in MCP stdio mode while starting the engine.")]
        public bool McpStdio { get; }

        [Value(0, MetaName = "role", Required = false, HelpText = "Optional MCP permissions role, e.g. role:anonymous. If omitted, defaults to anonymous.")]
        public string? McpRole { get; }

        public int Handler(ILogger logger, FileSystemRuntimeConfigLoader loader, IFileSystem fileSystem)
        {
            CliBuffer.BufferLog(Microsoft.Extensions.Logging.LogLevel.Information, $"{PRODUCT_NAME} {ProductInfo.GetProductVersion()}");
            bool isSuccess = ConfigGenerator.TryStartEngineWithOptions(this, loader, fileSystem);

            if (!isSuccess)
            {
                // Update loggers and flush buffers to ensure that all the logs are printed if the TryStartEngineWithOptions fails.
                logger = Utils.LoggerFactoryForCli.CreateLogger<Program>();
                loader.SetLogger(Utils.LoggerFactoryForCli.CreateLogger<FileSystemRuntimeConfigLoader>());

                CliBuffer.FlushToLogger(logger);
                loader.FlushLogBuffer();

                logger.LogError("Failed to start the engine{mode}.",
                    McpStdio ? " in MCP stdio mode" : string.Empty);
            }

            return isSuccess ? CliReturnCode.SUCCESS : CliReturnCode.GENERAL_ERROR;
        }
    }
}