@polymorphism-tech/morph-spec 4.5.0 → 4.7.0

package/.morph/framework/templates/code/dotnet/contracts/api-contracts.cs

@@ -1,173 +0,0 @@
-// ============================================================
-// CONTRACTS: {{titleCase FEATURE_NAME}}
-// Stack: Next.js + Supabase + .NET API
-// Generated by MORPH Framework
-// Date: {{DATE}}
-// ============================================================
-
-#region Usings
-
-using System;
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
-
-#endregion
-
-namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}};
-
-#region Configuration
-
-/// <summary>
-/// Supabase configuration options.
-/// Bind from appsettings.json "Supabase" section.
-/// </summary>
-public sealed record SupabaseConfig
-{
-    public required string Url { get; init; }
-    public required string AnonKey { get; init; }
-    public required string ServiceRoleKey { get; init; }
-    public required string JwtSecret { get; init; }
-}
-
-#endregion
-
-#region Pagination
-
-/// <summary>
-/// Pagination query parameters. Use with [AsParameters] in Minimal API.
-/// </summary>
-public sealed record PaginationQuery(
-    int Page = 1,
-    int PageSize = 20)
-{
-    public int Offset => (Page - 1) * PageSize;
-}
-
-/// <summary>
-/// Paginated result wrapper.
-/// </summary>
-public sealed record PagedResult<T>(
-    List<T> Items,
-    int TotalCount,
-    int Page,
-    int PageSize)
-{
-    public int TotalPages => (int)Math.Ceiling(TotalCount / (double)PageSize);
-    public bool HasNext => Page < TotalPages;
-    public bool HasPrevious => Page > 1;
-}
-
-#endregion
-
-#region Repository Interfaces
-
-/// <summary>
-/// Generic repository interface for Supabase/PostgreSQL data access via Dapper.
-/// </summary>
-public interface IRepository<T, TId>
-{
-    Task<T?> GetByIdAsync(TId id, CancellationToken cancellationToken = default);
-    Task<List<T>> GetAllAsync(CancellationToken cancellationToken = default);
-    Task<PagedResult<T>> GetPagedAsync(PaginationQuery query, CancellationToken cancellationToken = default);
-    Task<TId> CreateAsync(T entity, CancellationToken cancellationToken = default);
-    Task UpdateAsync(T entity, CancellationToken cancellationToken = default);
-    Task DeleteAsync(TId id, CancellationToken cancellationToken = default);
-}
-
-#endregion
-
-#region Service Interfaces
-
-/// <summary>
-/// Service for managing {{pascalCase FEATURE_NAME}} operations.
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}Service
-{
-    /// <summary>
-    /// Gets a {{pascalCase FEATURE_NAME}} by its identifier.
-    /// </summary>
-    Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(Guid id, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Gets paginated list of {{pascalCase FEATURE_NAME}} items.
-    /// </summary>
-    Task<PagedResult<{{pascalCase FEATURE_NAME}}Dto>> GetPagedAsync(PaginationQuery query, Guid userId, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Creates a new {{pascalCase FEATURE_NAME}}.
-    /// </summary>
-    Task<{{pascalCase FEATURE_NAME}}Dto> CreateAsync(Create{{pascalCase FEATURE_NAME}}Request request, Guid userId, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Updates an existing {{pascalCase FEATURE_NAME}}.
-    /// </summary>
-    Task UpdateAsync(Guid id, Update{{pascalCase FEATURE_NAME}}Request request, Guid userId, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Deletes a {{pascalCase FEATURE_NAME}}.
-    /// </summary>
-    Task DeleteAsync(Guid id, Guid userId, CancellationToken cancellationToken = default);
-}
-
-#endregion
-
-#region DTOs
-
-/// <summary>
-/// Data transfer object for {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public sealed record {{pascalCase FEATURE_NAME}}Dto(
-    Guid Id,
-    string Name,
-    Guid UserId,
-    {{pascalCase FEATURE_NAME}}Status Status,
-    DateTime CreatedAt,
-    DateTime? UpdatedAt
-);
-
-/// <summary>
-/// Request to create a new {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public sealed record Create{{pascalCase FEATURE_NAME}}Request(
-    string Name
-    // Add other required fields
-);
-
-/// <summary>
-/// Request to update an existing {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public sealed record Update{{pascalCase FEATURE_NAME}}Request(
-    string Name
-    // Add other updatable fields
-);
-
-#endregion
-
-#region Enums
-
-/// <summary>
-/// Status of a {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public enum {{pascalCase FEATURE_NAME}}Status
-{
-    Draft = 0,
-    Active = 1,
-    Completed = 2,
-    Archived = 3,
-    // Error states
-    Failed = 100,
-    Cancelled = 101
-}
-
-#endregion
-
-#region Exceptions
-
-public sealed class {{pascalCase FEATURE_NAME}}NotFoundException(Guid id)
-    : Exception($"{{pascalCase FEATURE_NAME}} with ID {id} was not found.");
-
-public sealed class {{pascalCase FEATURE_NAME}}AccessDeniedException(Guid id, Guid userId)
-    : Exception($"User {userId} does not have access to {{pascalCase FEATURE_NAME}} {id}.");
-
-#endregion

package/.morph/framework/templates/code/dotnet/contracts/contracts.cs

@@ -1,217 +0,0 @@
-// ============================================================
-// CONTRACTS: {{titleCase FEATURE_NAME}}
-// Generated by MORPH Framework
-// Date: {{DATE}}
-// ============================================================
-
-#region Usings
-
-using System;
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
-
-#endregion
-
-namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}};
-
-#region Service Interfaces
-
-/// <summary>
-/// Service for managing {{pascalCase FEATURE_NAME}} operations.
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}Service
-{
-    /// <summary>
-    /// Gets a {{FEATURE_NAME_LOWER_SNAKE}} by its identifier.
-    /// </summary>
-    Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Gets all {{FEATURE_NAME_LOWER_SNAKE}}s.
-    /// </summary>
-    Task<List<{{pascalCase FEATURE_NAME}}Dto>> GetAllAsync(CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Creates a new {{FEATURE_NAME_LOWER_SNAKE}}.
-    /// </summary>
-    Task<{{pascalCase FEATURE_NAME}}Dto> CreateAsync(Create{{pascalCase FEATURE_NAME}}Request request, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Updates an existing {{FEATURE_NAME_LOWER_SNAKE}}.
-    /// </summary>
-    Task UpdateAsync(int id, Update{{pascalCase FEATURE_NAME}}Request request, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Deletes a {{FEATURE_NAME_LOWER_SNAKE}}.
-    /// </summary>
-    Task DeleteAsync(int id, CancellationToken cancellationToken = default);
-}
-
-#endregion
-
-#region DTOs
-
-/// <summary>
-/// Data transfer object for {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public record {{pascalCase FEATURE_NAME}}Dto(
-    int Id,
-    string Name,
-    {{pascalCase FEATURE_NAME}}Status Status,
-    DateTime CreatedAt,
-    DateTime? UpdatedAt
-);
-
-/// <summary>
-/// Request to create a new {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public record Create{{pascalCase FEATURE_NAME}}Request(
-    string Name
-    // Add other required fields
-);
-
-/// <summary>
-/// Request to update an existing {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public record Update{{pascalCase FEATURE_NAME}}Request(
-    string Name
-    // Add other updatable fields
-);
-
-#endregion
-
-#region Enums
-
-/// <summary>
-/// Status of a {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public enum {{pascalCase FEATURE_NAME}}Status
-{
-    Pending = 0,
-    Active = 1,
-    Completed = 2,
-    Failed = 3
-}
-
-#endregion
-
-#region Repository Interfaces
-
-/// <summary>
-/// Repository for {{pascalCase FEATURE_NAME}} data access.
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}Repository
-{
-    Task<{{pascalCase FEATURE_NAME}}?> GetByIdAsync(int id, CancellationToken cancellationToken = default);
-    Task<List<{{pascalCase FEATURE_NAME}}>> GetAllAsync(CancellationToken cancellationToken = default);
-    Task AddAsync({{pascalCase FEATURE_NAME}} entity, CancellationToken cancellationToken = default);
-    void Update({{pascalCase FEATURE_NAME}} entity);
-    void Remove({{pascalCase FEATURE_NAME}} entity);
-    Task SaveChangesAsync(CancellationToken cancellationToken = default);
-}
-
-#endregion
-
-#region Domain Entity Reference
-
-/*
-/// <summary>
-/// {{pascalCase FEATURE_NAME}} domain entity.
-/// Implement in Domain/Entities/{{pascalCase FEATURE_NAME}}.cs
-/// </summary>
-public class {{pascalCase FEATURE_NAME}}
-{
-    public int Id { get; private set; }
-    public string Name { get; private set; } = string.Empty;
-    public {{pascalCase FEATURE_NAME}}Status Status { get; private set; }
-    public DateTime CreatedAt { get; private set; }
-    public DateTime? UpdatedAt { get; private set; }
-
-    private {{pascalCase FEATURE_NAME}}() { } // EF Constructor
-
-    public static {{pascalCase FEATURE_NAME}} Create(string name)
-    {
-        return new {{pascalCase FEATURE_NAME}}
-        {
-            Name = name,
-            Status = {{pascalCase FEATURE_NAME}}Status.Pending,
-            CreatedAt = DateTime.UtcNow
-        };
-    }
-
-    public void Activate()
-    {
-        Status = {{pascalCase FEATURE_NAME}}Status.Active;
-        UpdatedAt = DateTime.UtcNow;
-    }
-
-    public void Complete()
-    {
-        Status = {{pascalCase FEATURE_NAME}}Status.Completed;
-        UpdatedAt = DateTime.UtcNow;
-    }
-}
-*/
-
-#endregion
-
-#region AI Agent Interfaces (if applicable)
-
-/// <summary>
-/// AI Agent for {{pascalCase FEATURE_NAME}} analysis.
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}AnalyzerAgent
-{
-    /// <summary>
-    /// Analyzes {{FEATURE_NAME_LOWER_SNAKE}} data using AI.
-    /// </summary>
-    Task<{{pascalCase FEATURE_NAME}}AnalysisResult> AnalyzeAsync(
-        {{pascalCase FEATURE_NAME}}Data data,
-        CancellationToken cancellationToken = default);
-}
-
-public record {{pascalCase FEATURE_NAME}}Data(
-    // Input data for analysis
-    string Content
-);
-
-public record {{pascalCase FEATURE_NAME}}AnalysisResult(
-    string Summary,
-    List<string> Insights,
-    List<string> Recommendations,
-    double ConfidenceScore
-);
-
-#endregion
-
-#region Hangfire Job Interfaces (if applicable)
-
-/// <summary>
-/// Background job for processing {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}ProcessorJob
-{
-    /// <summary>
-    /// Executes the {{FEATURE_NAME_LOWER_SNAKE}} processing job.
-    /// </summary>
-    Task ExecuteAsync(int id, CancellationToken cancellationToken = default);
-}
-
-#endregion
-
-#region Exceptions
-
-public class {{pascalCase FEATURE_NAME}}NotFoundException : Exception
-{
-    public {{pascalCase FEATURE_NAME}}NotFoundException(int id)
-        : base($"{{pascalCase FEATURE_NAME}} with ID {id} was not found.") { }
-}
-
-public class {{pascalCase FEATURE_NAME}}ProcessingException : Exception
-{
-    public {{pascalCase FEATURE_NAME}}ProcessingException(string message, Exception? innerException = null)
-        : base(message, innerException) { }
-}
-
-#endregion

package/.morph/framework/templates/code/dotnet/contracts/contracts.cs.hbs

@@ -1,172 +0,0 @@
-// ====================================================================
-// Feature: {{FEATURE_NAME_TITLE}}
-// Contracts: DTOs, Interfaces, Enums, Value Objects
-// Generated: {{DATE}}
-// Author: {{AUTHOR}}
-// ====================================================================
-//
-// IMPORTANT: This file was generated from schema-analysis.md
-// All field names, types, and relationships are based on REAL database schema
-// DO NOT modify without checking schema-analysis.md first!
-//
-// ====================================================================
-
-namespace {{NAMESPACE}}.Features.{{FEATURE_NAME_PASCAL}};
-
-// ====================================================================
-// DTOs (Data Transfer Objects)
-// ====================================================================
-// Pattern: Use records for immutability
-// Pattern: All DTOs must have XML documentation
-// Pattern: Use nullable reference types appropriately
-// ====================================================================
-
-{{#each dtos}}
-/// <summary>
-/// {{this.description}}
-/// </summary>
-{{#if this.isCreateDto}}
-public record {{this.name}}(
-{{#each this.fields}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}{{#if this.comment}} // {{this.comment}}{{/if}}
-{{/each}}
-);
-{{else if this.isUpdateDto}}
-public record {{this.name}}(
-{{#each this.fields}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}{{#if this.comment}} // {{this.comment}}{{/if}}
-{{/each}}
-);
-{{else}}
-/// <summary>
-/// Response DTO for {{this.entityName}}
-/// </summary>
-public record {{this.name}}(
-{{#each this.fields}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}{{#if this.comment}} // {{this.comment}}{{/if}}
-{{/each}}
-);
-{{/if}}
-
-{{/each}}
-
-// ====================================================================
-// Service Interfaces
-// ====================================================================
-// Pattern: All async methods must accept CancellationToken
-// Pattern: Use Task<TResult?> for operations that may return null
-// Pattern: Document exceptions in XML comments
-// ====================================================================
-
-{{#each interfaces}}
-/// <summary>
-/// {{this.description}}
-/// </summary>
-public interface {{this.name}}
-{
-{{#each this.methods}}
-    /// <summary>
-    /// {{this.description}}
-    /// </summary>
-{{#if this.exceptions}}
-{{#each this.exceptions}}
-    /// <exception cref="{{this.type}}">{{this.condition}}</exception>
-{{/each}}
-{{/if}}
-    Task<{{this.returnType}}{{#if this.nullable}}?{{/if}}> {{this.name}}({{#each this.parameters}}{{this.type}} {{this.name}}{{#unless @last}}, {{/unless}}{{/each}}, CancellationToken ct);
-
-{{/each}}
-}
-
-{{/each}}
-
-// ====================================================================
-// Enums
-// ====================================================================
-
-{{#each enums}}
-/// <summary>
-/// {{this.description}}
-/// </summary>
-public enum {{this.name}}
-{
-{{#each this.values}}
-    /// <summary>
-    /// {{this.description}}
-    /// </summary>
-    {{this.name}}{{#if this.value}} = {{this.value}}{{/if}}{{#unless @last}},{{/unless}}
-{{/each}}
-}
-
-{{/each}}
-
-// ====================================================================
-// Value Objects (if applicable)
-// ====================================================================
-
-{{#each valueObjects}}
-/// <summary>
-/// {{this.description}}
-/// </summary>
-public record {{this.name}}
-{
-{{#each this.properties}}
-    /// <summary>
-    /// {{this.description}}
-    /// </summary>
-    public {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}} { get; init; }{{#if this.default}} = {{this.default}};{{/if}}
-{{/each}}
-
-{{#if this.validation}}
-    /// <summary>
-    /// Validates the value object
-    /// </summary>
-    public bool IsValid()
-    {
-        {{this.validation}}
-    }
-{{/if}}
-}
-
-{{/each}}
-
-// ====================================================================
-// Request/Response Wrappers (if using CQRS)
-// ====================================================================
-
-{{#if useCQRS}}
-{{#each commands}}
-/// <summary>
-/// Command: {{this.description}}
-/// </summary>
-public record {{this.name}}(
-{{#each this.parameters}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}
-{{/each}}
-);
-
-{{/each}}
-
-{{#each queries}}
-/// <summary>
-/// Query: {{this.description}}
-/// </summary>
-public record {{this.name}}(
-{{#each this.parameters}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}
-{{/each}}
-);
-
-{{/each}}
-{{/if}}
-
-// ====================================================================
-// Notes
-// ====================================================================
-// - All field names match database schema (see schema-analysis.md)
-// - Nullability matches database constraints
-// - Complex types (JSONB → JsonObject) correctly mapped
-// - Relationships preserved in navigation properties
-// - Immutable records used for DTOs (recommended pattern)
-// - CancellationToken required for all async operations
-// ====================================================================

package/.morph/framework/templates/code/dotnet/database/migration.cs

@@ -1,83 +0,0 @@
-// ============================================================
-// EF CORE MIGRATION TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
-using Microsoft.EntityFrameworkCore.Migrations;
-
-#nullable disable
-
-namespace {{NAMESPACE}}.Infrastructure.Data.Migrations;
-
-/// <inheritdoc />
-public partial class Add{{pascalCase FEATURE_NAME}} : Migration
-{
-    /// <inheritdoc />
-    protected override void Up(MigrationBuilder migrationBuilder)
-    {
-        migrationBuilder.CreateTable(
-            name: "{{pascalCase FEATURE_NAME}}s",
-            columns: table => new
-            {
-                Id = table.Column<int>(type: "int", nullable: false)
-                    .Annotation("SqlServer:Identity", "1, 1"),
-                Name = table.Column<string>(type: "nvarchar(200)", maxLength: 200, nullable: false),
-                Status = table.Column<string>(type: "nvarchar(50)", maxLength: 50, nullable: false),
-                CreatedAt = table.Column<DateTime>(type: "datetime2", nullable: false,
-                    defaultValueSql: "GETUTCDATE()"),
-                UpdatedAt = table.Column<DateTime>(type: "datetime2", nullable: true)
-            },
-            constraints: table =>
-            {
-                table.PrimaryKey("PK_{{pascalCase FEATURE_NAME}}s", x => x.Id);
-            });
-
-        // Indexes
-        migrationBuilder.CreateIndex(
-            name: "IX_{{pascalCase FEATURE_NAME}}s_Name",
-            table: "{{pascalCase FEATURE_NAME}}s",
-            column: "Name");
-
-        migrationBuilder.CreateIndex(
-            name: "IX_{{pascalCase FEATURE_NAME}}s_Status",
-            table: "{{pascalCase FEATURE_NAME}}s",
-            column: "Status");
-
-        migrationBuilder.CreateIndex(
-            name: "IX_{{pascalCase FEATURE_NAME}}s_CreatedAt",
-            table: "{{pascalCase FEATURE_NAME}}s",
-            column: "CreatedAt");
-    }
-
-    /// <inheritdoc />
-    protected override void Down(MigrationBuilder migrationBuilder)
-    {
-        migrationBuilder.DropTable(
-            name: "{{pascalCase FEATURE_NAME}}s");
-    }
-}
-
-// ============================================================
-// HOW TO CREATE A MIGRATION
-// ============================================================
-//
-// 1. Add your entity to AppDbContext:
-//
-//    public DbSet<{{pascalCase FEATURE_NAME}}> {{pascalCase FEATURE_NAME}}s => Set<{{pascalCase FEATURE_NAME}}>();
-//
-// 2. Add your configuration:
-//
-//    protected override void OnModelCreating(ModelBuilder modelBuilder)
-//    {
-//        modelBuilder.ApplyConfiguration(new {{pascalCase FEATURE_NAME}}Configuration());
-//    }
-//
-// 3. Run migration command:
-//
-//    dotnet ef migrations add Add{{pascalCase FEATURE_NAME}} -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
-//
-// 4. Apply migration:
-//
-//    dotnet ef database update -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
-//
-// ============================================================