@polymorphism-tech/morph-spec 8.37.1 → 8.40.0

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

@@ -1,83 +1,49 @@
-// ============================================================
-// 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
-//
-// ============================================================
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace {{NAMESPACE}}.Infrastructure.Data.Migrations;
+
+public partial class Add{{pascalCase FEATURE_NAME}} : Migration
+{
+    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);
+            });
+
+        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");
+    }
+
+    protected override void Down(MigrationBuilder migrationBuilder)
+    {
+        migrationBuilder.DropTable(
+            name: "{{pascalCase FEATURE_NAME}}s");
+    }
+}

package/framework/templates/code/dotnet/database/vector-entity.cs

@@ -1,8 +1,3 @@
-// ============================================================
-// PGVECTOR ENTITY + CONFIGURATION TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
 using System.ComponentModel.DataAnnotations.Schema;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Metadata.Builders;
@@ -12,10 +7,6 @@ using Pgvector;
 
 namespace {{NAMESPACE}}.Domain.Entities;
 
-/// <summary>
-/// Entity with vector embedding for similarity search via pgvector.
-/// Dimensions: 1536 (text-embedding-3-small). Adjust if using a different model.
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}
 {
     public Guid Id { get; set; }
@@ -23,6 +14,7 @@ public class {{pascalCase FEATURE_NAME}}
     public string Content { get; set; } = string.Empty;
     public string? Metadata { get; set; }
 
+    // 1536 é a dimensão do text-embedding-3-small; troca junto com o modelo, aqui e na configuração
     [Column(TypeName = "vector(1536)")]
     public Vector? Embedding { get; set; }
 
@@ -30,12 +22,9 @@ public class {{pascalCase FEATURE_NAME}}
     public DateTimeOffset? UpdatedAt { get; set; }
 }
 
-// ============================================================
-// ENTITY TYPE CONFIGURATION
-// ============================================================
-
 namespace {{NAMESPACE}}.Infrastructure.Data.Configurations;
 
+// Exige UseVector() no AddNpgsql e HasPostgresExtension("vector") no OnModelCreating
 public class {{pascalCase FEATURE_NAME}}Configuration : IEntityTypeConfiguration<{{pascalCase FEATURE_NAME}}>
 {
     public void Configure(EntityTypeBuilder<{{pascalCase FEATURE_NAME}}> builder)
@@ -49,7 +38,6 @@ public class {{pascalCase FEATURE_NAME}}Configuration : IEntityTypeConfiguration
         builder.Property(e => e.Embedding).HasColumnType("vector(1536)");
         builder.Property(e => e.CreatedAt).HasDefaultValueSql("now()");
 
-        // HNSW index for cosine similarity search
         builder.HasIndex(e => e.Embedding)
             .HasMethod("hnsw")
             .HasOperators("vector_cosine_ops")
@@ -59,35 +47,3 @@ public class {{pascalCase FEATURE_NAME}}Configuration : IEntityTypeConfiguration
         builder.HasIndex(e => e.Title);
     }
 }
-
-// ============================================================
-// SETUP INSTRUCTIONS
-// ============================================================
-//
-// 1. Install NuGet packages:
-//
-//    dotnet add package Pgvector.EntityFrameworkCore
-//    dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL
-//
-// 2. Configure NpgsqlDataSource with vector support in Program.cs:
-//
-//    builder.Services.AddNpgsql<AppDbContext>(
-//        connectionString,
-//        npgsqlOptions => npgsqlOptions.UseVector());
-//
-// 3. Register in DbContext:
-//
-//    public DbSet<{{pascalCase FEATURE_NAME}}> {{pascalCase FEATURE_NAME}}s => Set<{{pascalCase FEATURE_NAME}}>();
-//
-//    protected override void OnModelCreating(ModelBuilder modelBuilder)
-//    {
-//        modelBuilder.HasPostgresExtension("vector");
-//        modelBuilder.ApplyConfiguration(new {{pascalCase FEATURE_NAME}}Configuration());
-//    }
-//
-// 4. Create and apply migration:
-//
-//    dotnet ef migrations add Add{{pascalCase FEATURE_NAME}}WithVector -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
-//    dotnet ef database update -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
-//
-// ============================================================

package/framework/templates/code/dotnet/extensions/result-extensions.cs

@@ -5,7 +5,6 @@ namespace {{pascalCase PROJECT_NAME}}.Extensions;
 
 public static class ResultExtensions
 {
-    // For non-generic Result
     public static TOut Match<TOut>(
         this Result result,
         Func<TOut> onSuccess,
@@ -16,7 +15,6 @@ public static class ResultExtensions
             : onFailure(result.Error);
     }
 
-    // 🔥 THIS is what your endpoint needs
     public static TOut Match<TIn, TOut>(
         this Result<TIn> result,
         Func<TIn, TOut> onSuccess,

package/framework/templates/code/dotnet/feature/validator.cs.hbs

@@ -1,15 +1,11 @@
-using FluentValidation;
-
-namespace {{pascalCase PROJECT_NAME}}.Features.{{pascalCase FEATURE_NAME}}Feature.{{pascalCase SLICE_NAME}};
-
-public class {{pascalCase SLICE_NAME}}Validator : AbstractValidator<{{pascalCase SLICE_NAME}}Request>
-{
-    public {{pascalCase SLICE_NAME}}Validator()
-    {
-        // TODO: Add validation rules for {{pascalCase SLICE_NAME}}Request properties
-        // Example:
-        // RuleFor(c => c.Name)
-        //     .NotEmpty().WithMessage("Name is required")
-        //     .MaximumLength(200).WithMessage("Name must not exceed 200 characters");
-    }
-}
+using FluentValidation;
+
+namespace {{pascalCase PROJECT_NAME}}.Features.{{pascalCase FEATURE_NAME}}Feature.{{pascalCase SLICE_NAME}};
+
+public class {{pascalCase SLICE_NAME}}Validator : AbstractValidator<{{pascalCase SLICE_NAME}}Request>
+{
+    public {{pascalCase SLICE_NAME}}Validator()
+    {
+        // TODO: Add validation rules for {{pascalCase SLICE_NAME}}Request properties
+    }
+}

package/framework/templates/code/dotnet/jobs/agent.cs

@@ -1,8 +1,3 @@
-// ============================================================
-// MICROSOFT AGENT FRAMEWORK TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
 using System.ComponentModel;
 using System.Text.Json;
 using Microsoft.Extensions.AI;
@@ -10,15 +5,10 @@ using Microsoft.Extensions.Logging;
 
 namespace {{NAMESPACE}}.Agents.{{pascalCase FEATURE_NAME}};
 
-/// <summary>
-/// AI Agent for analyzing {{pascalCase FEATURE_NAME}} data.
-/// Uses Microsoft Agent Framework with IChatClient (gpt-4o-mini by default).
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}AnalyzerAgent(
     IChatClient chatClient,
     ILogger<{{pascalCase FEATURE_NAME}}AnalyzerAgent> logger) : I{{pascalCase FEATURE_NAME}}AnalyzerAgent
 {
-    /// <inheritdoc />
     public async Task<{{pascalCase FEATURE_NAME}}AnalysisResult> AnalyzeAsync(
         {{pascalCase FEATURE_NAME}}Data data,
         CancellationToken cancellationToken = default)
@@ -65,14 +55,12 @@ public class {{pascalCase FEATURE_NAME}}AnalyzerAgent(
         return result;
     }
 
-    #region Tools
-
     [Description("Gets additional context for the analysis")]
     private async Task<string> GetContextAsync(
         [Description("What context is needed")] string query,
         CancellationToken ct = default)
     {
-        // TODO: Implement context retrieval (e.g., from database or search)
+        // TODO: buscar o contexto (banco ou busca)
         await Task.CompletedTask;
         return $"Context for: {query}";
     }
@@ -82,19 +70,16 @@ public class {{pascalCase FEATURE_NAME}}AnalyzerAgent(
         [Description("Metric type to retrieve")] string metricType,
         CancellationToken ct = default)
     {
-        // TODO: Implement metrics retrieval
+        // TODO: buscar as métricas
         await Task.CompletedTask;
         return $"Metrics for: {metricType}";
     }
 
-    #endregion
-
-    #region Response Parsing
-
     private {{pascalCase FEATURE_NAME}}AnalysisResult ParseResponse(string response)
     {
         try
         {
+            // o modelo às vezes cerca o JSON com ```json mesmo instruído a não fazer
             var json = response
                 .Replace("```json", "")
                 .Replace("```", "")
@@ -126,37 +111,4 @@ public class {{pascalCase FEATURE_NAME}}AnalyzerAgent(
         public List<string>? Recommendations { get; set; }
         public double ConfidenceScore { get; set; }
     }
-
-    #endregion
 }
-
-// ============================================================
-// DEPENDENCY INJECTION SETUP
-// ============================================================
-//
-// In Program.cs:
-//
-// // Register IChatClient (Azure OpenAI with Managed Identity)
-// builder.Services.AddSingleton<IChatClient>(sp =>
-// {
-//     var cfg = sp.GetRequiredService<IConfiguration>();
-//     return new AzureOpenAIClient(
-//             new Uri(cfg["AzureOpenAI:Endpoint"]!),
-//             new DefaultAzureCredential())
-//         .GetChatClient(cfg["AzureOpenAI:DeploymentName"] ?? "gpt-4o-mini")
-//         .AsIChatClient();
-// });
-//
-// // Option A: Register as scoped service
-// builder.Services.AddScoped<I{{pascalCase FEATURE_NAME}}AnalyzerAgent, {{pascalCase FEATURE_NAME}}AnalyzerAgent>();
-//
-// // Option B: Register as keyed agent (recommended for multiple agents)
-// builder.AddAIAgent("{{pascalCase FEATURE_NAME}}Analyzer", (sp, key) =>
-// {
-//     var chatClient = sp.GetRequiredService<IChatClient>();
-//     return new ChatClientAgent(chatClient,
-//         name: key,
-//         instructions: "You are an expert {{pascalCase FEATURE_NAME}} analyst.");
-// });
-//
-// ============================================================

package/framework/templates/code/dotnet/jobs/job.cs

@@ -1,8 +1,3 @@
-// ============================================================
-// HANGFIRE JOB TEMPLATE (VSA Pattern — ApplicationDbContext direto)
-// Generated by MORPH Framework
-// ============================================================
-
 using Hangfire;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Logging;
@@ -10,21 +5,11 @@ using {{pascalCase PROJECT_NAME}}.Database;
 
 namespace {{pascalCase PROJECT_NAME}}.Features.{{pascalCase FEATURE_NAME}}.Jobs;
 
-/// <summary>
-/// Background job for processing {{pascalCase FEATURE_NAME}}.
-/// Uses Hangfire for scheduling and retry handling.
-/// Injects ApplicationDbContext directly (no service layer, no generic repository).
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}ProcessorJob(
     ApplicationDbContext db,
     I{{pascalCase FEATURE_NAME}}AnalyzerAgent analyzer,
     ILogger<{{pascalCase FEATURE_NAME}}ProcessorJob> logger) : I{{pascalCase FEATURE_NAME}}ProcessorJob
 {
-    /// <summary>
-    /// Executes the {{pascalCase FEATURE_NAME}} processing job.
-    /// </summary>
-    /// <param name="id">The {{pascalCase FEATURE_NAME}} ID to process</param>
-    /// <param name="cancellationToken">Cancellation token</param>
     [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]
     [Queue("default")]
     [JobDisplayName("{{pascalCase FEATURE_NAME}} Processing - ID: {0}")]
@@ -34,7 +19,6 @@ public class {{pascalCase FEATURE_NAME}}ProcessorJob(
 
         try
         {
-            // Get the entity directly from the DbSet
             var entity = await db.Set<{{pascalCase FEATURE_NAME}}>().FindAsync(new object[] { id }, cancellationToken);
             if (entity is null)
             {
@@ -42,14 +26,12 @@ public class {{pascalCase FEATURE_NAME}}ProcessorJob(
                 return;
             }
 
-            // Check if already processed
             if (entity.Status == {{pascalCase FEATURE_NAME}}Status.Completed)
             {
                 logger.LogInformation("{{pascalCase FEATURE_NAME}} {Id} already completed, skipping", id);
                 return;
             }
 
-            // Perform MAF agent analysis (if applicable)
             var analysisData = new {{pascalCase FEATURE_NAME}}Data(entity.Name);
             var analysis = await analyzer.AnalyzeAsync(analysisData, cancellationToken);
 
@@ -57,7 +39,6 @@ public class {{pascalCase FEATURE_NAME}}ProcessorJob(
                 "{{pascalCase FEATURE_NAME}} {Id} analyzed. Confidence: {Confidence:P0}",
                 id, analysis.ConfidenceScore);
 
-            // Update the tracked entity and persist
             entity.MarkAsCompleted(analysis);
             await db.SaveChangesAsync(cancellationToken);
 
@@ -66,54 +47,17 @@ public class {{pascalCase FEATURE_NAME}}ProcessorJob(
         catch (Exception ex)
         {
             logger.LogError(ex, "Failed to process {{pascalCase FEATURE_NAME}} {Id}", id);
-            throw; // Re-throw to trigger Hangfire retry
+            throw; // sem a exceção o Hangfire não aplica o AutomaticRetry
         }
     }
 }
 
-// ============================================================
-// RECURRING JOB CONFIGURATION
-// ============================================================
-//
-// For scheduled/recurring jobs, configure in Program.cs:
-//
-// // Run every hour
-// RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
-//     "{{kebabCase FEATURE_NAME}}-processor",
-//     job => job.ExecuteAsync(0, CancellationToken.None),
-//     Cron.Hourly);
-//
-// // Run daily at midnight
-// RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
-//     "{{kebabCase FEATURE_NAME}}-daily-processor",
-//     job => job.ExecuteAsync(0, CancellationToken.None),
-//     Cron.Daily);
-//
-// // Custom cron expression (every 15 minutes)
-// RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
-//     "{{kebabCase FEATURE_NAME}}-frequent-processor",
-//     job => job.ExecuteAsync(0, CancellationToken.None),
-//     "*/15 * * * *");
-//
-// ============================================================
-
-// ============================================================
-// BATCH JOB TEMPLATE
-// ============================================================
-
-/// <summary>
-/// Batch job for processing multiple {{pascalCase FEATURE_NAME}}s.
-/// Queries pending items via LINQ on the DbSet and enqueues individual jobs.
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}BatchProcessorJob(
     ApplicationDbContext db,
     ILogger<{{pascalCase FEATURE_NAME}}BatchProcessorJob> logger)
 {
-    /// <summary>
-    /// Processes all pending {{pascalCase FEATURE_NAME}}s.
-    /// </summary>
     [AutomaticRetry(Attempts = 1)]
-    [Queue("batch")]
+    [Queue("batch")] // a fila precisa constar em AddHangfireServer(o => o.Queues), senão ninguém a consome
     [JobDisplayName("{{pascalCase FEATURE_NAME}} Batch Processing")]
     public async Task ProcessAllPendingAsync(CancellationToken cancellationToken)
     {
@@ -127,7 +71,6 @@ public class {{pascalCase FEATURE_NAME}}BatchProcessorJob(
 
         foreach (var item in pending)
         {
-            // Enqueue individual processing jobs
             BackgroundJob.Enqueue<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
                 job => job.ExecuteAsync(item.Id, CancellationToken.None));
         }
@@ -135,41 +78,3 @@ public class {{pascalCase FEATURE_NAME}}BatchProcessorJob(
         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 (ApplicationDbContext already registered via AddDbContext)
-// builder.Services.AddScoped<I{{pascalCase FEATURE_NAME}}ProcessorJob, {{pascalCase FEATURE_NAME}}ProcessorJob>();
-// builder.Services.AddScoped<{{pascalCase FEATURE_NAME}}BatchProcessorJob>();
-//
-// // In app pipeline
-// app.UseHangfireDashboard("/hangfire", new DashboardOptions
-// {
-//     Authorization = new[] { new HangfireAuthorizationFilter() }
-// });
-//
-// ============================================================