@polymorphism-tech/morph-spec 8.38.0 → 8.41.0

package/framework/templates/code/dotnet/test.cs

@@ -1,8 +1,3 @@
-// ============================================================
-// TEST TEMPLATE (VSA Pattern — Handler + Validator)
-// Generated by MORPH Framework
-// ============================================================
-
 using FluentAssertions;
 using FluentValidation;
 using FluentValidation.Results;
@@ -14,15 +9,6 @@ using Xunit;
 
 namespace {{pascalCase PROJECT_NAME}}.Tests.Unit.Features.{{pascalCase FEATURE_NAME}};
 
-// ============================================================
-// Handler Tests
-// ============================================================
-
-/// <summary>
-/// Unit tests for {{pascalCase FEATURE_NAME}} handlers.
-/// Tests handlers directly against a real ApplicationDbContext backed by
-/// in-memory SQLite (no mocks — DbSet is the repository, DbContext is the unit of work).
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
 {
     private readonly SqliteConnection _connection;
@@ -30,6 +16,7 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
 
     public {{pascalCase FEATURE_NAME}}HandlerTests()
     {
+        // o banco :memory: some quando a conexão fecha, então ela vive o teste inteiro
         _connection = new SqliteConnection("DataSource=:memory:");
         _connection.Open();
 
@@ -47,19 +34,14 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         _connection.Dispose();
     }
 
-    #region Create Handler Tests
-
     [Fact]
     public async Task Create_HandleAsync_WithValidCommand_ReturnsSuccessResult()
     {
-        // Arrange
         var command = new Create{{pascalCase FEATURE_NAME}}Request("Test {{pascalCase FEATURE_NAME}}");
         var handler = new Create{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeTrue();
         result.Value.Should().NotBeNull();
 
@@ -67,14 +49,9 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         persisted.Name.Should().Be("Test {{pascalCase FEATURE_NAME}}");
     }
 
-    #endregion
-
-    #region GetById Handler Tests
-
     [Fact]
     public async Task GetById_HandleAsync_WithValidId_ReturnsSuccessResult()
     {
-        // Arrange
         var entity = CreateTestEntity("Test {{pascalCase FEATURE_NAME}}");
         _db.Set<{{pascalCase FEATURE_NAME}}>().Add(entity);
         await _db.SaveChangesAsync();
@@ -82,10 +59,8 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         var query = new Get{{pascalCase FEATURE_NAME}}ByIdRequest(entity.Id);
         var handler = new Get{{pascalCase FEATURE_NAME}}ByIdHandler(_db);
 
-        // Act
         var result = await handler.HandleAsync(query, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeTrue();
         result.Value.Should().NotBeNull();
         result.Value!.Name.Should().Be("Test {{pascalCase FEATURE_NAME}}");
@@ -94,25 +69,17 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
     [Fact]
     public async Task GetById_HandleAsync_WithInvalidId_ReturnsFailureResult()
     {
-        // Arrange
         var query = new Get{{pascalCase FEATURE_NAME}}ByIdRequest(Guid.CreateVersion7());
         var handler = new Get{{pascalCase FEATURE_NAME}}ByIdHandler(_db);
 
-        // Act
         var result = await handler.HandleAsync(query, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeFalse();
     }
 
-    #endregion
-
-    #region Update Handler Tests
-
     [Fact]
     public async Task Update_HandleAsync_WithValidCommand_ReturnsSuccessResult()
     {
-        // Arrange
         var entity = CreateTestEntity("Original Name");
         _db.Set<{{pascalCase FEATURE_NAME}}>().Add(entity);
         await _db.SaveChangesAsync();
@@ -120,10 +87,8 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         var command = new Update{{pascalCase FEATURE_NAME}}Request(entity.Id, "Updated Name");
         var handler = new Update{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeTrue();
 
         var persisted = await _db.Set<{{pascalCase FEATURE_NAME}}>().SingleAsync(x => x.Id == entity.Id);
@@ -133,25 +98,17 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
     [Fact]
     public async Task Update_HandleAsync_WithNonExistentId_ReturnsFailureResult()
     {
-        // Arrange
         var command = new Update{{pascalCase FEATURE_NAME}}Request(Guid.CreateVersion7(), "Updated");
         var handler = new Update{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeFalse();
     }
 
-    #endregion
-
-    #region Delete Handler Tests
-
     [Fact]
     public async Task Delete_HandleAsync_WithValidId_ReturnsSuccessResult()
     {
-        // Arrange
         var entity = CreateTestEntity("To Delete");
         _db.Set<{{pascalCase FEATURE_NAME}}>().Add(entity);
         await _db.SaveChangesAsync();
@@ -159,10 +116,8 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
         var command = new Delete{{pascalCase FEATURE_NAME}}Request(entity.Id);
         var handler = new Delete{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeTrue();
 
         (await _db.Set<{{pascalCase FEATURE_NAME}}>().AnyAsync(x => x.Id == entity.Id)).Should().BeFalse();
@@ -171,57 +126,35 @@ public class {{pascalCase FEATURE_NAME}}HandlerTests : IDisposable
     [Fact]
     public async Task Delete_HandleAsync_WithNonExistentId_ReturnsFailureResult()
     {
-        // Arrange
         var command = new Delete{{pascalCase FEATURE_NAME}}Request(Guid.CreateVersion7());
         var handler = new Delete{{pascalCase FEATURE_NAME}}Handler(_db);
 
-        // Act
         var result = await handler.HandleAsync(command, CancellationToken.None);
 
-        // Assert
         result.IsSuccess.Should().BeFalse();
     }
 
-    #endregion
-
-    #region Helper Methods
-
     private static {{pascalCase FEATURE_NAME}} CreateTestEntity(string name)
     {
         return new {{pascalCase FEATURE_NAME}}
         {
             Id = Guid.CreateVersion7(),
             Name = name,
-            // TODO: preencher demais campos obrigatórios da entidade
+            // TODO: demais campos obrigatórios da entidade
         };
     }
-
-    #endregion
 }
 
-// ============================================================
-// Validator Tests
-// ============================================================
-
-/// <summary>
-/// Unit tests for {{pascalCase FEATURE_NAME}} validators.
-/// Tests FluentValidation rules using ValidateAsync.
-/// </summary>
 public class {{pascalCase FEATURE_NAME}}ValidatorTests
 {
-    #region Create Validator Tests
-
     [Fact]
     public async Task CreateValidator_WithValidCommand_PassesValidation()
     {
-        // Arrange
         var validator = new Create{{pascalCase FEATURE_NAME}}Validator();
         var command = new Create{{pascalCase FEATURE_NAME}}Request("Valid Name");
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeTrue();
         result.Errors.Should().BeEmpty();
     }
@@ -232,14 +165,11 @@ public class {{pascalCase FEATURE_NAME}}ValidatorTests
     [InlineData(null)]
     public async Task CreateValidator_WithInvalidName_FailsValidation(string? name)
     {
-        // Arrange
         var validator = new Create{{pascalCase FEATURE_NAME}}Validator();
         var command = new Create{{pascalCase FEATURE_NAME}}Request(name!);
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeFalse();
         result.Errors.Should().Contain(e => e.PropertyName == nameof(Create{{pascalCase FEATURE_NAME}}Request.Name));
     }
@@ -247,50 +177,35 @@ public class {{pascalCase FEATURE_NAME}}ValidatorTests
     [Fact]
     public async Task CreateValidator_WithNameExceedingMaxLength_FailsValidation()
     {
-        // Arrange
         var validator = new Create{{pascalCase FEATURE_NAME}}Validator();
         var command = new Create{{pascalCase FEATURE_NAME}}Request(new string('A', 201));
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeFalse();
         result.Errors.Should().Contain(e => e.PropertyName == nameof(Create{{pascalCase FEATURE_NAME}}Request.Name));
     }
 
-    #endregion
-
-    #region Update Validator Tests
-
     [Fact]
     public async Task UpdateValidator_WithValidCommand_PassesValidation()
     {
-        // Arrange
         var validator = new Update{{pascalCase FEATURE_NAME}}Validator();
         var command = new Update{{pascalCase FEATURE_NAME}}Request(Guid.CreateVersion7(), "Updated Name");
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeTrue();
     }
 
     [Fact]
     public async Task UpdateValidator_WithInvalidId_FailsValidation()
     {
-        // Arrange
         var validator = new Update{{pascalCase FEATURE_NAME}}Validator();
         var command = new Update{{pascalCase FEATURE_NAME}}Request(Guid.Empty, "Updated Name");
 
-        // Act
         ValidationResult result = await validator.ValidateAsync(command);
 
-        // Assert
         result.IsValid.Should().BeFalse();
         result.Errors.Should().Contain(e => e.PropertyName == nameof(Update{{pascalCase FEATURE_NAME}}Request.Id));
     }
-
-    #endregion
 }

package/framework/templates/code/typescript/contracts.ts

@@ -1,167 +1,140 @@
-// ============================================================
-// CONTRACTS: {{titleCase FEATURE_NAME}}
-// Stack: Next.js + Neon
-// Generated by MORPH Framework
-// Date: {{DATE}}
-// ============================================================
-
-// ----- Neon Config -----
-
-export interface NeonConfig {
-  connectionString: string;
-}
-
-// ----- API Client Types -----
-
-export interface ApiClientConfig {
-  baseUrl: string;
-  getAccessToken: () => Promise<string | null>;
-}
-
-export interface ApiError {
-  message: string;
-  code: string;
-  statusCode: number;
-  details?: Record<string, string[]>;
-}
-
-export type ApiResult<T> =
-  | { success: true; data: T }
-  | { success: false; error: ApiError };
-
-// ----- Pagination -----
-
-export interface PaginationQuery {
-  page?: number;
-  pageSize?: number;
-}
-
-export interface PagedResult<T> {
-  items: T[];
-  totalCount: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasNext: boolean;
-  hasPrevious: boolean;
-}
-
-// ----- Database Client Type Aliases -----
-// Generated by your ORM (Drizzle or Prisma) from your Neon PostgreSQL schema
-
-export type Tables<T extends keyof Database["public"]["Tables"]> =
-  Database["public"]["Tables"][T]["Row"];
-
-export type Insertable<T extends keyof Database["public"]["Tables"]> =
-  Database["public"]["Tables"][T]["Insert"];
-
-export type Updatable<T extends keyof Database["public"]["Tables"]> =
-  Database["public"]["Tables"][T]["Update"];
-
-// ----- Database Schema (placeholder - replace with generated types) -----
-
-export interface Database {
-  public: {
-    Tables: {
-      {{FEATURE_NAME}}: {
-        Row: {
-          id: string;
-          name: string;
-          user_id: string;
-          status: {{pascalCase FEATURE_NAME}}Status;
-          created_at: string;
-          updated_at: string | null;
-        };
-        Insert: {
-          id?: string;
-          name: string;
-          user_id?: string;
-          status?: {{pascalCase FEATURE_NAME}}Status;
-          created_at?: string;
-          updated_at?: string | null;
-        };
-        Update: {
-          id?: string;
-          name?: string;
-          user_id?: string;
-          status?: {{pascalCase FEATURE_NAME}}Status;
-          created_at?: string;
-          updated_at?: string | null;
-        };
-      };
-    };
-    Views: Record<string, never>;
-    Functions: Record<string, never>;
-    Enums: {
-      {{FEATURE_NAME}}_status: {{pascalCase FEATURE_NAME}}Status;
-    };
-  };
-}
-
-// ----- Feature Types -----
-
-export type {{pascalCase FEATURE_NAME}}Status =
-  | "draft"
-  | "active"
-  | "completed"
-  | "archived"
-  | "failed"
-  | "cancelled";
-
-export interface {{pascalCase FEATURE_NAME}} {
-  id: string;
-  name: string;
-  userId: string;
-  status: {{pascalCase FEATURE_NAME}}Status;
-  createdAt: string;
-  updatedAt: string | null;
-}
-
-export interface Create{{pascalCase FEATURE_NAME}}Input {
-  name: string;
-  // Add other required fields
-}
-
-export interface Update{{pascalCase FEATURE_NAME}}Input {
-  name?: string;
-  // Add other updatable fields
-}
-
-// ----- Storage Types -----
-
-export interface StorageUpload {
-  bucket: string;
-  path: string;
-  file: File;
-  contentType?: string;
-}
-
-export interface StorageFile {
-  id: string;
-  name: string;
-  bucket: string;
-  path: string;
-  publicUrl: string;
-  size: number;
-  contentType: string;
-  createdAt: string;
-}
-
-// ----- Auth Types -----
-
-export interface AuthUser {
-  id: string;
-  email: string;
-  displayName: string | null;
-  avatarUrl: string | null;
-}
-
-export interface AuthSession {
-  user: AuthUser;
-  accessToken: string;
-  expiresAt: number;
-}
-
-// ----- Form Schemas (use with zod) -----
-// Define zod schemas in component files, not here.
-// This file is for type definitions only.
+// {{titleCase FEATURE_NAME}} contracts, generated {{DATE}}
+
+export interface NeonConfig {
+  connectionString: string;
+}
+
+export interface ApiClientConfig {
+  baseUrl: string;
+  getAccessToken: () => Promise<string | null>;
+}
+
+export interface ApiError {
+  message: string;
+  code: string;
+  statusCode: number;
+  details?: Record<string, string[]>;
+}
+
+export type ApiResult<T> =
+  | { success: true; data: T }
+  | { success: false; error: ApiError };
+
+export interface PaginationQuery {
+  page?: number;
+  pageSize?: number;
+}
+
+export interface PagedResult<T> {
+  items: T[];
+  totalCount: number;
+  page: number;
+  pageSize: number;
+  totalPages: number;
+  hasNext: boolean;
+  hasPrevious: boolean;
+}
+
+export type Tables<T extends keyof Database["public"]["Tables"]> =
+  Database["public"]["Tables"][T]["Row"];
+
+export type Insertable<T extends keyof Database["public"]["Tables"]> =
+  Database["public"]["Tables"][T]["Insert"];
+
+export type Updatable<T extends keyof Database["public"]["Tables"]> =
+  Database["public"]["Tables"][T]["Update"];
+
+// Placeholder: replace with the types your ORM (Drizzle or Prisma) generates from the Neon schema.
+export interface Database {
+  public: {
+    Tables: {
+      {{FEATURE_NAME}}: {
+        Row: {
+          id: string;
+          name: string;
+          user_id: string;
+          status: {{pascalCase FEATURE_NAME}}Status;
+          created_at: string;
+          updated_at: string | null;
+        };
+        Insert: {
+          id?: string;
+          name: string;
+          user_id?: string;
+          status?: {{pascalCase FEATURE_NAME}}Status;
+          created_at?: string;
+          updated_at?: string | null;
+        };
+        Update: {
+          id?: string;
+          name?: string;
+          user_id?: string;
+          status?: {{pascalCase FEATURE_NAME}}Status;
+          created_at?: string;
+          updated_at?: string | null;
+        };
+      };
+    };
+    Views: Record<string, never>;
+    Functions: Record<string, never>;
+    Enums: {
+      {{FEATURE_NAME}}_status: {{pascalCase FEATURE_NAME}}Status;
+    };
+  };
+}
+
+export type {{pascalCase FEATURE_NAME}}Status =
+  | "draft"
+  | "active"
+  | "completed"
+  | "archived"
+  | "failed"
+  | "cancelled";
+
+export interface {{pascalCase FEATURE_NAME}} {
+  id: string;
+  name: string;
+  userId: string;
+  status: {{pascalCase FEATURE_NAME}}Status;
+  createdAt: string;
+  updatedAt: string | null;
+}
+
+export interface Create{{pascalCase FEATURE_NAME}}Input {
+  name: string;
+}
+
+export interface Update{{pascalCase FEATURE_NAME}}Input {
+  name?: string;
+}
+
+export interface StorageUpload {
+  bucket: string;
+  path: string;
+  file: File;
+  contentType?: string;
+}
+
+export interface StorageFile {
+  id: string;
+  name: string;
+  bucket: string;
+  path: string;
+  publicUrl: string;
+  size: number;
+  contentType: string;
+  createdAt: string;
+}
+
+export interface AuthUser {
+  id: string;
+  email: string;
+  displayName: string | null;
+  avatarUrl: string | null;
+}
+
+export interface AuthSession {
+  user: AuthUser;
+  accessToken: string;
+  expiresAt: number;
+}

package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentApi.cs

@@ -1,65 +1,18 @@
 namespace Morph.AiKit.Agents;
 
-/// <summary>
-/// Protocolo pelo qual um modelo e alcancado. E o campo <c>api:</c> por alias que a
-/// issue #92 exige: a MESMA familia de modelos e atendida por dois protocolos
-/// diferentes, e qual deles vale e decisao de configuracao — nunca folclore espalhado
-/// por condicional no meio do codigo.
-/// </summary>
-/// <remarks>
-/// <para>
-/// <see cref="Responses"/> e <b>0 de proposito</b>: <c>default(AgentApi)</c> e a Responses
-/// API porque essa e a decisao da casa (Responses por padrao, Chat Completions como
-/// opt-in explicito por alias). Um alias que omite <c>api:</c> no
-/// <c>model-registry.v2.json</c> cai em Responses; usar Chat Completions exige escrever
-/// <c>"api": "chat"</c> — ou seja, exige alguem assumir a escolha por escrito.
-/// </para>
-/// <para>
-/// O enum descreve a escolha ENTRE OS DOIS PROTOCOLOS DA OpenAI. Provider que expoe um
-/// unico protocolo (Google, Ollama) ignora o campo, e por isso declara — ou omite,
-/// caindo em — <see cref="Responses"/>: escrever <c>chat</c> ali sugeriria uma escolha
-/// que naquele provider nao existe.
-/// </para>
-/// </remarks>
 public enum AgentApi
 {
-    /// <summary>Responses API — o padrao da casa. Valor 0, logo <c>default(AgentApi)</c>.</summary>
+    // 0 de proposito: default(AgentApi) e alias sem 'api:' caem em Responses; Chat e opt-in escrito.
     Responses = 0,
 
-    /// <summary>
-    /// Chat Completions — opt-in explicito por alias. Carrega limites que a Responses API
-    /// nao tem; ver <c>Morph.AiKit.Providers.ModelAliasConstraints</c>.
-    /// </summary>
     Chat = 1,
 
-    /// <summary>
-    /// Images — geracao/edicao de imagem. <b>Nao e um protocolo de conversa</b>: um alias
-    /// com este <c>api</c> e recusado pela <c>AgentFactory</c>, com erro nomeado.
-    /// </summary>
-    /// <remarks>
-    /// Um registry so, um vocabulario so de alias: quem procura "qual modelo este projeto
-    /// usa" encontra o de imagem no mesmo lugar que o de chat. A alternativa era um
-    /// <c>media-registry.json</c> separado — duas verdades sobre o mesmo fato.
-    /// </remarks>
     Images = 2,
 
-    /// <summary>
-    /// Videos — geracao de video. Mesma regra de <see cref="Images"/>: alias de midia nao
-    /// vira agente.
-    /// </summary>
     Videos = 3,
 }
 
-/// <summary>Predicados sobre <see cref="AgentApi"/>.</summary>
 public static class AgentApiExtensions
 {
-    /// <summary>
-    /// Se o protocolo e de MIDIA (imagem ou video) e portanto nao fala conversa.
-    /// </summary>
-    /// <remarks>
-    /// Escrito uma vez, aqui, porque duas copias deste predicado sao como a
-    /// <c>AgentFactory</c> e o <c>ModelRegistry</c> passariam a discordar sobre o mesmo
-    /// alias.
-    /// </remarks>
     public static bool IsMedia(this AgentApi api) => api is AgentApi.Images or AgentApi.Videos;
 }