@polymorphism-tech/morph-spec 8.37.1 → 8.40.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/context/design-system.md

@@ -2,7 +2,7 @@
 
 > **Template** — copy to `.morph/context/design-system.md` and fill in sections marked `/* CUSTOMIZE */`.
 
-Living document. All agents read this before any UI work. All design decisions land here.
+Living document. All agents read this before any UI work. All design decisions land here — **rewritten in place, never stacked**: a decision that changes rewrites the section that described the old one (a value that still holds somewhere says where), so an agent reading only the body gets today's answer.
 
 ---
 
@@ -332,8 +332,8 @@ Choose patterns based on the project domain:
 
 ## Changelog
 
-> Living record — every agent that adds tokens or design decisions registers here.
-> Format: `- YYYY-MM-DD [agent-id] Description of addition/change`
+> When and why the body changed — never the new value itself: that lives in the section it rewrote.
+> Format: `- YYYY-MM-DD [agent-id] reason (section rewritten)`
 
 <!-- Entries below this line, newest first -->
 

package/framework/templates/docs/proposal.md

@@ -136,6 +136,17 @@ How will we know this feature is successful?
 
 ---
 
+## Conflitos com o acervo
+
+UCs (`.morph/specs/usecases/`), ADRs ativos (`.morph/specs/adrs/`) and `.morph/context/*.md` that
+this request contradicts. `Nenhum conflito encontrado.` when there is none — the section is always present.
+
+| Fonte | O que diz hoje | O que o pedido muda | Decisão |
+|-------|----------------|---------------------|---------|
+| {UC-133} | {Public Sans + Lora em toda a interface} | {admin passa a Geist} | {vale o novo no admin; a vitrine mantém o antigo — decisions.md ADR-001} |
+
+---
+
 ## Dependencies
 
 - [ ] {Dependency 1} - {status}

package/framework/templates/docs/spec.md

@@ -204,6 +204,21 @@ public interface I{{pascalCase FEATURE_NAME}}Service
 
 ---
 
+## UCs e ADRs que esta feature altera ou revoga
+
+> Read by `morph-spec finish`: in the archive commit, each row marks the project acervo — a UC turns
+> `status: superseded` + `superseded_by` (+ `scope` when partial); an ADR leaves `.morph/specs/adrs/`
+> (total) or keeps its file with the scope where it still holds (partial). Columns are positional.
+> `morph-spec usecase check {feature}` reports a bad row while this file can still change (it freezes at Gate 2).
+> Nothing revoked → replace the table with `Nenhum.`
+
+| Id | Mudança | Substituto | Escopo em que o antigo ainda vale |
+|----|---------|------------|-----------------------------------|
+| UC-{nn} | parcial | UC-{nn} | {where the old one still holds} |
+| {feature}/ADR-{nnn} | total | — | — |
+
+---
+
 ## Security
 
 | Action | Required Policy |