CyberdyneDevelopment.Mc3Po.ProjectManagement.Abstractions 0.1.0-preview.6

Mc3Po.ProjectManagement.Abstractions

Interfaces and models for project management operations.

Core Interfaces

IProjectManagementService

public interface IProjectManagementService
{
    // Projects
    Task<IGenericResult<IReadOnlyList<ProjectInfo>>> ListProjectsAsync(CancellationToken ct = default);
    Task<IGenericResult<ProjectInfo>> GetProjectAsync(string projectId, CancellationToken ct = default);

    // Issues
    Task<IGenericResult<IssueInfo>> CreateIssueAsync(CreateIssueRequest request, CancellationToken ct = default);
    Task<IGenericResult<IssueInfo>> GetIssueAsync(string projectId, string issueId, CancellationToken ct = default);
    Task<IGenericResult<IssueInfo>> UpdateIssueAsync(string projectId, string issueId, UpdateIssueRequest request, CancellationToken ct = default);
    Task<IGenericResult<IReadOnlyList<IssueInfo>>> ListIssuesAsync(ListIssuesRequest request, CancellationToken ct = default);

    // Comments
    Task<IGenericResult> AddCommentAsync(string projectId, string issueId, string comment, CancellationToken ct = default);

    // Cycles/Sprints
    Task<IGenericResult<IReadOnlyList<CycleInfo>>> ListCyclesAsync(string projectId, CancellationToken ct = default);
    Task<IGenericResult<CycleInfo>> CreateCycleAsync(string projectId, CycleInfo cycle, CancellationToken ct = default);

    // Labels
    Task<IGenericResult<IReadOnlyList<LabelInfo>>> ListLabelsAsync(string projectId, CancellationToken ct = default);

    // States
    Task<IGenericResult<IReadOnlyList<StateInfo>>> ListStatesAsync(string projectId, CancellationToken ct = default);
}

Models

ProjectInfo

public class ProjectInfo
{
    public string Id { get; set; }
    public string Name { get; set; }
    public string? Identifier { get; set; }
    public string? Description { get; set; }
}

IssueInfo

public class IssueInfo
{
    public string Id { get; set; }
    public string? Identifier { get; set; }  // e.g., "PROJ-123"
    public string Name { get; set; }
    public string? Description { get; set; }
    public string? State { get; set; }
    public string? Priority { get; set; }
    public string? AssigneeId { get; set; }
    public IReadOnlyList<string>? Labels { get; set; }
    public DateTimeOffset? CreatedAt { get; set; }
    public DateTimeOffset? UpdatedAt { get; set; }
}

StateInfo

public class StateInfo
{
    public string Id { get; set; }
    public string Name { get; set; }
    public string? Color { get; set; }
    public string? Group { get; set; }  // e.g., "backlog", "started", "completed"
}

CycleInfo

public class CycleInfo
{
    public string Id { get; set; }
    public string Name { get; set; }
    public DateTimeOffset? StartDate { get; set; }
    public DateTimeOffset? EndDate { get; set; }
}

LabelInfo

public class LabelInfo
{
    public string Id { get; set; }
    public string Name { get; set; }
    public string? Color { get; set; }
}

Request Models

CreateIssueRequest

public class CreateIssueRequest
{
    public string? ProjectId { get; set; }
    public string Name { get; set; }
    public string? Description { get; set; }
    public string? StateId { get; set; }
    public string? Priority { get; set; }
    public string? AssigneeId { get; set; }
    public IReadOnlyList<string>? LabelIds { get; set; }
}

UpdateIssueRequest

public class UpdateIssueRequest
{
    public string? Name { get; set; }
    public string? Description { get; set; }
    public string? StateId { get; set; }
    public string? Priority { get; set; }
    public string? AssigneeId { get; set; }
    public IReadOnlyList<string>? LabelIds { get; set; }
}

Dependencies

• FractalDataWorks.Results
• Microsoft.Extensions.Logging.Abstractions

Usage

This package is referenced by:

• Protocol implementations (Plane, GitLab, GitHub, Azure DevOps)
• Tools that need PM capabilities