@polymorphism-tech/morph-spec 1.0.0

package/content/.morph/templates/integrations/clerk-config.cs

@@ -0,0 +1,258 @@
+// ==============================================================================
+// MORPH-SPEC - Clerk Authentication Configuration Template
+// Configuração de autenticação com Clerk para .NET
+// ==============================================================================
+
+using Microsoft.AspNetCore.Authentication;
+using Microsoft.AspNetCore.Components.Authorization;
+using System.Security.Claims;
+
+namespace {{Namespace}}.Infrastructure.Auth;
+
+// ==============================================================================
+// OPTIONS
+// ==============================================================================
+
+public class ClerkOptions
+{
+    public const string SectionName = "Clerk";
+
+    /// <summary>
+    /// Clerk Secret Key (starts with sk_)
+    /// </summary>
+    public string SecretKey { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Clerk Publishable Key (starts with pk_)
+    /// </summary>
+    public string PublishableKey { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Clerk Frontend API URL
+    /// </summary>
+    public string FrontendApi { get; set; } = string.Empty;
+}
+
+// ==============================================================================
+// SERVICE EXTENSIONS
+// ==============================================================================
+
+public static class ClerkServiceExtensions
+{
+    /// <summary>
+    /// Adiciona autenticação Clerk ao projeto
+    /// Requer: Clerk.Net.AspNetCore.Security
+    /// </summary>
+    public static IServiceCollection AddClerkAuthentication(
+        this IServiceCollection services,
+        IConfiguration configuration)
+    {
+        services.Configure<ClerkOptions>(configuration.GetSection(ClerkOptions.SectionName));
+
+        // Opção 1: Usando Clerk.Net SDK oficial
+        // services.AddClerk(configuration);
+
+        // Opção 2: Configuração manual com JWT
+        services.AddAuthentication("Clerk")
+            .AddJwtBearer("Clerk", options =>
+            {
+                var clerkOptions = configuration.GetSection(ClerkOptions.SectionName).Get<ClerkOptions>()!;
+
+                options.Authority = clerkOptions.FrontendApi;
+                options.TokenValidationParameters = new()
+                {
+                    ValidateIssuer = true,
+                    ValidateAudience = false,
+                    ValidateLifetime = true,
+                    ValidateIssuerSigningKey = true,
+                    NameClaimType = ClaimTypes.NameIdentifier
+                };
+            });
+
+        services.AddAuthorization();
+
+        return services;
+    }
+
+    /// <summary>
+    /// Adiciona Clerk para Blazor Server
+    /// </summary>
+    public static IServiceCollection AddClerkBlazor(
+        this IServiceCollection services,
+        IConfiguration configuration)
+    {
+        services.AddClerkAuthentication(configuration);
+        services.AddScoped<AuthenticationStateProvider, ClerkAuthenticationStateProvider>();
+        services.AddCascadingAuthenticationState();
+
+        return services;
+    }
+}
+
+// ==============================================================================
+// AUTHENTICATION STATE PROVIDER (Blazor)
+// ==============================================================================
+
+public class ClerkAuthenticationStateProvider : AuthenticationStateProvider
+{
+    private readonly IHttpContextAccessor _httpContextAccessor;
+
+    public ClerkAuthenticationStateProvider(IHttpContextAccessor httpContextAccessor)
+    {
+        _httpContextAccessor = httpContextAccessor;
+    }
+
+    public override Task<AuthenticationState> GetAuthenticationStateAsync()
+    {
+        var user = _httpContextAccessor.HttpContext?.User ?? new ClaimsPrincipal();
+        return Task.FromResult(new AuthenticationState(user));
+    }
+
+    public void NotifyAuthenticationStateChanged()
+    {
+        NotifyAuthenticationStateChanged(GetAuthenticationStateAsync());
+    }
+}
+
+// ==============================================================================
+// CLERK USER SERVICE
+// ==============================================================================
+
+public interface IClerkUserService
+{
+    Task<ClerkUser?> GetCurrentUserAsync(CancellationToken ct = default);
+    Task<ClerkUser?> GetUserByIdAsync(string userId, CancellationToken ct = default);
+    Task UpdateUserMetadataAsync(string userId, Dictionary<string, object> metadata, CancellationToken ct = default);
+}
+
+public class ClerkUserService : IClerkUserService
+{
+    private readonly HttpClient _httpClient;
+    private readonly IHttpContextAccessor _httpContextAccessor;
+    private readonly ILogger<ClerkUserService> _logger;
+
+    public ClerkUserService(
+        HttpClient httpClient,
+        IHttpContextAccessor httpContextAccessor,
+        ILogger<ClerkUserService> logger)
+    {
+        _httpClient = httpClient;
+        _httpContextAccessor = httpContextAccessor;
+        _logger = logger;
+    }
+
+    public async Task<ClerkUser?> GetCurrentUserAsync(CancellationToken ct = default)
+    {
+        var userId = _httpContextAccessor.HttpContext?.User.FindFirstValue(ClaimTypes.NameIdentifier);
+        if (string.IsNullOrEmpty(userId)) return null;
+
+        return await GetUserByIdAsync(userId, ct);
+    }
+
+    public async Task<ClerkUser?> GetUserByIdAsync(string userId, CancellationToken ct = default)
+    {
+        try
+        {
+            var response = await _httpClient.GetAsync($"users/{userId}", ct);
+
+            if (!response.IsSuccessStatusCode)
+            {
+                _logger.LogWarning("Failed to get Clerk user {UserId}: {Status}", userId, response.StatusCode);
+                return null;
+            }
+
+            return await response.Content.ReadFromJsonAsync<ClerkUser>(ct);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error getting Clerk user {UserId}", userId);
+            return null;
+        }
+    }
+
+    public async Task UpdateUserMetadataAsync(string userId, Dictionary<string, object> metadata, CancellationToken ct = default)
+    {
+        var request = new { public_metadata = metadata };
+        var response = await _httpClient.PatchAsJsonAsync($"users/{userId}", request, ct);
+        response.EnsureSuccessStatusCode();
+    }
+}
+
+// ==============================================================================
+// CLERK USER MODEL
+// ==============================================================================
+
+public record ClerkUser
+{
+    public string Id { get; init; } = string.Empty;
+    public string? FirstName { get; init; }
+    public string? LastName { get; init; }
+    public string? ImageUrl { get; init; }
+    public List<ClerkEmailAddress>? EmailAddresses { get; init; }
+    public string? PrimaryEmailAddressId { get; init; }
+    public Dictionary<string, object>? PublicMetadata { get; init; }
+    public long CreatedAt { get; init; }
+    public long UpdatedAt { get; init; }
+
+    public string? PrimaryEmail => EmailAddresses?
+        .FirstOrDefault(e => e.Id == PrimaryEmailAddressId)?.EmailAddress;
+
+    public string FullName => $"{FirstName} {LastName}".Trim();
+}
+
+public record ClerkEmailAddress
+{
+    public string Id { get; init; } = string.Empty;
+    public string EmailAddress { get; init; } = string.Empty;
+    public bool Verified { get; init; }
+}
+
+// ==============================================================================
+// MIDDLEWARE PIPELINE
+// ==============================================================================
+
+public static class ClerkMiddlewareExtensions
+{
+    public static IApplicationBuilder UseClerkAuthentication(this IApplicationBuilder app)
+    {
+        app.UseAuthentication();
+        app.UseAuthorization();
+        return app;
+    }
+}
+
+// ==============================================================================
+// APPSETTINGS EXAMPLE
+// ==============================================================================
+
+/*
+{
+  "Clerk": {
+    "SecretKey": "sk_test_xxxxx",
+    "PublishableKey": "pk_test_xxxxx",
+    "FrontendApi": "https://your-app.clerk.accounts.dev"
+  }
+}
+*/
+
+// ==============================================================================
+// PROGRAM.CS EXAMPLE
+// ==============================================================================
+
+/*
+// Program.cs
+var builder = WebApplication.CreateBuilder(args);
+
+// Add Clerk authentication
+builder.Services.AddClerkAuthentication(builder.Configuration);
+// Or for Blazor:
+// builder.Services.AddClerkBlazor(builder.Configuration);
+
+var app = builder.Build();
+
+app.UseClerkAuthentication();
+
+app.MapControllers().RequireAuthorization();
+
+app.Run();
+*/

package/content/.morph/templates/job.cs

@@ -0,0 +1,171 @@
+// ============================================================
+// HANGFIRE JOB TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using Hangfire;
+using Microsoft.Extensions.Logging;
+
+namespace MyProject.Application.Features.{Feature}.Jobs;
+
+/// <summary>
+/// Background job for processing {Feature}.
+/// Uses Hangfire for scheduling and retry handling.
+/// </summary>
+public class {Feature}ProcessorJob(
+    I{Feature}Service service,
+    I{Feature}AnalyzerAgent analyzer,
+    ILogger<{Feature}ProcessorJob> logger) : I{Feature}ProcessorJob
+{
+    /// <summary>
+    /// Executes the {Feature} processing job.
+    /// </summary>
+    /// <param name="id">The {Feature} ID to process</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]
+    [Queue("default")]
+    [JobDisplayName("{Feature} Processing - ID: {0}")]
+    public async Task ExecuteAsync(int id, CancellationToken cancellationToken)
+    {
+        logger.LogInformation("Starting {Feature} processing for ID {Id}", id);
+
+        try
+        {
+            // Get the entity
+            var item = await service.GetByIdAsync(id, cancellationToken);
+            if (item is null)
+            {
+                logger.LogWarning("{Feature} with ID {Id} not found, skipping", id);
+                return;
+            }
+
+            // Check if already processed
+            if (item.Status == {Feature}Status.Completed)
+            {
+                logger.LogInformation("{Feature} {Id} already completed, skipping", id);
+                return;
+            }
+
+            // Perform analysis (if applicable)
+            var analysisData = new {Feature}Data(item.Name);
+            var analysis = await analyzer.AnalyzeAsync(analysisData, cancellationToken);
+
+            logger.LogInformation(
+                "{Feature} {Id} analyzed. Confidence: {Confidence:P0}",
+                id, analysis.ConfidenceScore);
+
+            // Update status
+            // Note: You might need to add a method to update with analysis results
+            // await service.CompleteWithAnalysisAsync(id, analysis, cancellationToken);
+
+            logger.LogInformation("Completed {Feature} processing for ID {Id}", id);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "Failed to process {Feature} {Id}", id);
+            throw; // Re-throw to trigger Hangfire retry
+        }
+    }
+}
+
+// ============================================================
+// RECURRING JOB CONFIGURATION
+// ============================================================
+//
+// For scheduled/recurring jobs, configure in Program.cs:
+//
+// // Run every hour
+// RecurringJob.AddOrUpdate<I{Feature}ProcessorJob>(
+//     "{feature}-processor",
+//     job => job.ExecuteAsync(0, CancellationToken.None),
+//     Cron.Hourly);
+//
+// // Run daily at midnight
+// RecurringJob.AddOrUpdate<I{Feature}ProcessorJob>(
+//     "{feature}-daily-processor",
+//     job => job.ExecuteAsync(0, CancellationToken.None),
+//     Cron.Daily);
+//
+// // Custom cron expression (every 15 minutes)
+// RecurringJob.AddOrUpdate<I{Feature}ProcessorJob>(
+//     "{feature}-frequent-processor",
+//     job => job.ExecuteAsync(0, CancellationToken.None),
+//     "*/15 * * * *");
+//
+// ============================================================
+
+// ============================================================
+// BATCH JOB TEMPLATE
+// ============================================================
+
+/// <summary>
+/// Batch job for processing multiple {Feature}s.
+/// </summary>
+public class {Feature}BatchProcessorJob(
+    I{Feature}Service service,
+    I{Feature}ProcessorJob itemProcessor,
+    ILogger<{Feature}BatchProcessorJob> logger)
+{
+    /// <summary>
+    /// Processes all pending {Feature}s.
+    /// </summary>
+    [AutomaticRetry(Attempts = 1)]
+    [Queue("batch")]
+    [JobDisplayName("{Feature} Batch Processing")]
+    public async Task ProcessAllPendingAsync(CancellationToken cancellationToken)
+    {
+        logger.LogInformation("Starting batch processing for pending {Feature}s");
+
+        var items = await service.GetAllAsync(cancellationToken);
+        var pending = items.Where(x => x.Status == {Feature}Status.Pending).ToList();
+
+        logger.LogInformation("Found {Count} pending {Feature}s to process", pending.Count);
+
+        foreach (var item in pending)
+        {
+            // Enqueue individual processing jobs
+            BackgroundJob.Enqueue<I{Feature}ProcessorJob>(
+                job => job.ExecuteAsync(item.Id, CancellationToken.None));
+        }
+
+        logger.LogInformation("Enqueued {Count} processing jobs", pending.Count);
+    }
+}
+
+// ============================================================
+// HANGFIRE CONFIGURATION
+// ============================================================
+//
+// In Program.cs:
+//
+// // Add Hangfire services
+// builder.Services.AddHangfire(config => config
+//     .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
+//     .UseSimpleAssemblyNameTypeSerializer()
+//     .UseRecommendedSerializerSettings()
+//     .UseSqlServerStorage(connectionString, new SqlServerStorageOptions
+//     {
+//         CommandBatchMaxTimeout = TimeSpan.FromMinutes(5),
+//         SlidingInvisibilityTimeout = TimeSpan.FromMinutes(5),
+//         QueuePollInterval = TimeSpan.Zero,
+//         UseRecommendedIsolationLevel = true,
+//         DisableGlobalLocks = true
+//     }));
+//
+// builder.Services.AddHangfireServer(options =>
+// {
+//     options.Queues = new[] { "default", "batch" };
+//     options.WorkerCount = Environment.ProcessorCount * 2;
+// });
+//
+// // Register jobs
+// builder.Services.AddScoped<I{Feature}ProcessorJob, {Feature}ProcessorJob>();
+// builder.Services.AddScoped<{Feature}BatchProcessorJob>();
+//
+// // In app pipeline
+// app.UseHangfireDashboard("/hangfire", new DashboardOptions
+// {
+//     Authorization = new[] { new HangfireAuthorizationFilter() }
+// });
+//
+// ============================================================

package/content/.morph/templates/migration.cs

@@ -0,0 +1,83 @@
+// ============================================================
+// EF CORE MIGRATION TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace MyProject.Infrastructure.Data.Migrations;
+
+/// <inheritdoc />
+public partial class Add{Feature} : Migration
+{
+    /// <inheritdoc />
+    protected override void Up(MigrationBuilder migrationBuilder)
+    {
+        migrationBuilder.CreateTable(
+            name: "{Feature}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_{Feature}s", x => x.Id);
+            });
+
+        // Indexes
+        migrationBuilder.CreateIndex(
+            name: "IX_{Feature}s_Name",
+            table: "{Feature}s",
+            column: "Name");
+
+        migrationBuilder.CreateIndex(
+            name: "IX_{Feature}s_Status",
+            table: "{Feature}s",
+            column: "Status");
+
+        migrationBuilder.CreateIndex(
+            name: "IX_{Feature}s_CreatedAt",
+            table: "{Feature}s",
+            column: "CreatedAt");
+    }
+
+    /// <inheritdoc />
+    protected override void Down(MigrationBuilder migrationBuilder)
+    {
+        migrationBuilder.DropTable(
+            name: "{Feature}s");
+    }
+}
+
+// ============================================================
+// HOW TO CREATE A MIGRATION
+// ============================================================
+//
+// 1. Add your entity to AppDbContext:
+//
+//    public DbSet<{Feature}> {Feature}s => Set<{Feature}>();
+//
+// 2. Add your configuration:
+//
+//    protected override void OnModelCreating(ModelBuilder modelBuilder)
+//    {
+//        modelBuilder.ApplyConfiguration(new {Feature}Configuration());
+//    }
+//
+// 3. Run migration command:
+//
+//    dotnet ef migrations add Add{Feature} -p src/MyProject.Infrastructure -s src/MyProject.Web
+//
+// 4. Apply migration:
+//
+//    dotnet ef database update -p src/MyProject.Infrastructure -s src/MyProject.Web
+//
+// ============================================================

package/content/.morph/templates/proposal.md

@@ -0,0 +1,155 @@
+# Feature Proposal: {FEATURE_NAME}
+
+> Proposta para nova feature. Este documento descreve O QUE e POR QUÊ.
+> Para detalhes técnicos, veja `spec.md`.
+
+## Metadata
+
+| Field | Value |
+|-------|-------|
+| **Proposed** | {date} |
+| **Author** | {name} |
+| **Status** | Draft / Under Review / Approved / Rejected |
+| **Priority** | High / Medium / Low |
+
+---
+
+## Problem Statement
+
+### What is the problem?
+
+{Descreva o problema que esta feature resolve. Seja específico.}
+
+### Who is affected?
+
+{Quem sofre com este problema? Usuários finais? Desenvolvedores? Operações?}
+
+### What is the impact?
+
+{Qual o impacto de NÃO resolver este problema?}
+- Perda de produtividade: {X}
+- Custo: {X}
+- Satisfação do usuário: {X}
+
+---
+
+## Proposed Solution
+
+### Overview
+
+{Descreva a solução proposta em 2-3 parágrafos}
+
+### Key Features
+
+1. **{Feature 1}** - {breve descrição}
+2. **{Feature 2}** - {breve descrição}
+3. **{Feature 3}** - {breve descrição}
+
+### User Journey
+
+```
+1. Usuário {ação inicial}
+2. Sistema {resposta}
+3. Usuário {próxima ação}
+4. Sistema {resultado final}
+```
+
+---
+
+## Success Metrics
+
+Como saberemos que esta feature foi um sucesso?
+
+| Metric | Current | Target |
+|--------|---------|--------|
+| {Metric 1} | {X} | {Y} |
+| {Metric 2} | {X} | {Y} |
+
+---
+
+## Scope
+
+### In Scope
+
+- {Item 1 que está incluído}
+- {Item 2 que está incluído}
+- {Item 3 que está incluído}
+
+### Out of Scope
+
+- {Item 1 que NÃO está incluído}
+- {Item 2 que NÃO está incluído}
+
+### Future Considerations
+
+- {Item que pode ser adicionado depois}
+
+---
+
+## Risks & Concerns
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|------------|--------|------------|
+| {Risk 1} | High/Med/Low | High/Med/Low | {Como mitigar} |
+| {Risk 2} | High/Med/Low | High/Med/Low | {Como mitigar} |
+
+---
+
+## Dependencies
+
+- [ ] {Dependency 1} - {status}
+- [ ] {Dependency 2} - {status}
+
+---
+
+## Estimated Effort
+
+| Phase | Estimate |
+|-------|----------|
+| Design & Spec | {X}h |
+| Implementation | {X}h |
+| Testing | {X}h |
+| **Total** | **{X}h** |
+
+---
+
+## Cost Impact
+
+| Resource | Monthly Cost |
+|----------|--------------|
+| Compute | ${X} |
+| Storage | ${X} |
+| AI/API | ${X} |
+| **Total** | **${X}/month** |
+
+⚠️ **Requires Approval:** {Yes/No}
+
+---
+
+## Questions & Clarifications
+
+1. {Pergunta 1 que precisa de resposta}
+2. {Pergunta 2 que precisa de resposta}
+
+---
+
+## Approval
+
+| Role | Name | Decision | Date |
+|------|------|----------|------|
+| Product Owner | | Pending | |
+| Tech Lead | | Pending | |
+| Cost Guardian | | Pending | |
+
+---
+
+## Next Steps
+
+Once approved:
+1. Create detailed `spec.md` with technical design
+2. Break down into `tasks.md`
+3. Begin implementation
+
+---
+
+*Created with MORPH Framework*