CyberdyneDevelopment.Mc3Po.Protocols 0.1.0-preview.6

Mc3Po.Protocols

Core protocol infrastructure including the ProtocolTypes TypeCollection, provider, and factory interfaces.

Key Components

ProtocolTypes

Source-generated TypeCollection for protocol type discovery:

// O(1) lookup by name
var planeType = ProtocolTypes.ByName("Plane");

// Check capabilities
if (planeType.SupportsProjectManagement)
{
    // ...
}

// Iterate all protocols
foreach (var protocolType in ProtocolTypes.All())
{
    Console.WriteLine($"{protocolType.DisplayName}: PM={protocolType.SupportsProjectManagement}, SC={protocolType.SupportsSourceControl}");
}

ProtocolTypeBase

Base class for protocol type descriptors:

public abstract class ProtocolTypeBase : TypeOptionBase<Guid, ProtocolTypeBase>, IProtocolType
{
    protected ProtocolTypeBase(
        Guid id,
        string name,
        string sectionName,
        string displayName,
        string description,
        bool supportsProjectManagement,
        bool supportsSourceControl);

    public abstract IServiceCollection RegisterRequiredServices(IServiceCollection services);
    public abstract void RegisterFactory(DefaultProtocolProvider provider, IServiceProvider services);
}

IProtocolFactory

Factory interface for creating protocol instances:

public interface IProtocolFactory<TProtocol, TConfiguration>
    where TProtocol : IProtocol
    where TConfiguration : IProtocolConfiguration
{
    Task<IGenericResult<TProtocol>> CreateAsync(
        TConfiguration configuration,
        IProtocolCreationContext context,
        CancellationToken cancellationToken = default);
}

IProtocolProvider

Provider for accessing configured protocols:

public interface IProtocolProvider
{
    IGenericResult<IProjectManagementProtocol> GetProjectManagement(string? name = null);
    IGenericResult<ISourceControlProtocol> GetSourceControl(string? name = null);
}

Three-Phase Registration

Phase 1: ConfigureServices

// Register all protocol services
builder.Services.AddProtocols();
// Or: ProtocolTypes.RegisterAll(builder.Services);

Phase 2: InitializeFactories

var app = builder.Build();

// Resolve factories and register with provider
ProtocolTypes.InitializeFactories(app.Services);

Phase 3: Runtime

// Get the configured protocol
var pmResult = protocolProvider.GetProjectManagement();
if (pmResult.IsSuccess)
{
    var pm = pmResult.Value;
    await pm.CreateIssueAsync(request, ct);
}

Extension Methods

public static class ServiceCollectionExtensions
{
    public static IServiceCollection AddProtocols(this IServiceCollection services)
    {
        return ProtocolTypes.RegisterAll(services);
    }
}

Dependencies

• Mc3Po.Protocols.Abstractions
• FractalDataWorks.Collections
• Microsoft.Extensions.DependencyInjection
• Microsoft.Extensions.Configuration

Protocol Implementations

This package is referenced by protocol implementations:

• Mc3Po.Protocols.Plane
• Mc3Po.Protocols.GitLab
• Mc3Po.Protocols.GitHub
• Mc3Po.Protocols.AzureDevOps

See Adding New Protocols for implementation guide.