@polymorphism-tech/morph-spec 1.0.4 → 2.1.0

package/content/.claude/skills/stacks/dotnet-blazor.md

@@ -6,12 +6,12 @@ Stack principal para desenvolvimento de aplicações web com .NET e Blazor Serve
 
 | Aspecto | Tecnologia |
 |---------|------------|
-| **Backend** | .NET 9+ / C# 13+ |
+| **Backend** | .NET 10 / C# 14 |
 | **Frontend** | Blazor Server |
-| **Database** | Entity Framework Core 9 + Azure SQL |
+| **Database** | Entity Framework Core 10 + Azure SQL |
 | **Hosting** | Azure Container Apps |
 | **Background** | Hangfire |
-| **AI** | Microsoft Agent Framework |
+| **AI** | Microsoft Agent Framework (exclusivo) |
 
 ## Triggers
 
@@ -63,7 +63,7 @@ src/
 <!-- {App}.Web.csproj -->
 <Project Sdk="Microsoft.NET.Sdk.Web">
   <PropertyGroup>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>
@@ -329,12 +329,248 @@ public class OrderService : IOrderService
 }
 ```
 
-## Documentação de Referência
+---
+
+## 🎨 UI Component Libraries
+
+### Recomendação para Projetos AI-First
+
+| Biblioteca | Quando Usar | Vantagens | Desvantagens |
+|------------|-------------|-----------|--------------|
+| **Fluent UI** ⭐ | Projetos AI-first, Micro-SaaS | Componentes AI nativos, Microsoft integration, Performance (~200KB) | Menos componentes prontos |
+| **MudBlazor** | SaaS tradicional, Analytics pesados | 140+ componentes, Charts nativos, Templates prontos | Mais pesado (~500KB), Sem componentes AI |
+| **Híbrido** | SaaS complexo com AI | Melhor dos dois mundos | Maior bundle size (~350KB) |
+
+### Fluent UI Blazor (Recomendado)
+
+**Para:**
+- Projetos com AI agents/chat
+- Integração com Microsoft Agent Framework
+- Produtos com UX Copilot-like
+- Micro-SaaS que priorizam performance
+
+**Setup rápido:**
+```bash
+dotnet add package Microsoft.FluentUI.AspNetCore.Components
+```
+
+```csharp
+// Program.cs
+builder.Services.AddFluentUIComponents();
+```
+
+**Exemplo de Chat AI:**
+```razor
+<FluentMessageBar Intent="MessageIntent.Success">
+    <FluentLabel Weight="FontWeight.Bold">AI Assistant</FluentLabel>
+    <FluentLabel>@_aiResponse</FluentLabel>
+</FluentMessageBar>
+```
+
+**Guia completo:** [Fluent UI Setup](../../.morph/standards/fluent-ui-setup.md)
+
+### MudBlazor (Complemento)
+
+**Para:**
+- Grids complexos com filtros avançados
+- Charts e dashboards analytics
+- Componentes que Fluent UI não tem
+
+**Setup:**
+```bash
+dotnet add package MudBlazor
+```
+
+**Exemplo de Grid Avançado:**
+```razor
+<MudDataGrid T="Order" Items="@_orders"
+             Filterable="true"
+             Groupable="true"
+             Dense="true">
+    <Columns>
+        <PropertyColumn Property="x => x.OrderNumber" />
+        <PropertyColumn Property="x => x.Total" Format="C2" />
+    </Columns>
+</MudDataGrid>
+```
+
+### Abordagem Híbrida
+
+**Quando usar:**
+- SaaS com AI + analytics complexos
+- Dashboards com charts + chat AI
+- Aplicações enterprise completas
+
+**Pattern:**
+- **Base:** Fluent UI (layout, navegação, AI)
+- **Complemento:** MudBlazor (grids, charts)
+
+```razor
+<FluentLayout>
+    <FluentHeader>...</FluentHeader>
+    <FluentMain>
+        @* Grid complexo *@
+        <MudDataGrid ... />
+
+        @* Chat AI *@
+        <FluentMessageBar>AI response</FluentMessageBar>
+    </FluentMain>
+</FluentLayout>
+```
+
+---
+
+## 🎯 Novas Features .NET 10
+
+### State Persistence
+
+**Novo:** Propriedades com `[PersistentState]` são persist idas automaticamente.
+
+```razor
+@page "/counter"
+
+<button @onclick="Increment">Count: @Count</button>
+
+@code {
+    // Persiste automaticamente em pre-rendering e circuit disconnections
+    [PersistentState]
+    private int Count { get; set; } = 0;
+
+    private void Increment() => Count++;
+}
+```
+
+**Quando usar:**
+- Componentes com estado que precisam sobreviver a pre-rendering
+- Aplicações com circuit disconnections frequentes
+- Formulários multi-step
+
+**Não usar para:**
+- Dados sensíveis (passwords, tokens)
+- Estado que deve ser recalculado (derived state)
+
+### Circuit Pause/Resume
+
+**Novo:** APIs JavaScript para pausar/resumir circuits.
+
+```razor
+@inject IJSRuntime JS
+
+@code {
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        if (firstRender)
+        {
+            await JS.InvokeVoidAsync("setupCircuitManagement");
+        }
+    }
+}
+```
+
+```javascript
+// wwwroot/app.js
+function setupCircuitManagement() {
+    // Pausar quando usuário minimiza/troca de aba
+    document.addEventListener('visibilitychange', () => {
+        if (document.hidden) {
+            Blazor.pauseCircuit();  // Libera recursos do servidor
+        } else {
+            Blazor.resumeCircuit(); // Restaura estado
+        }
+    });
+}
+```
+
+**Benefícios:**
+- Reduz uso de memória do servidor
+- Melhora escalabilidade
+- Estado mantido durante pausa
+
+### Blazor Metrics & Observability
+
+**Novo:** Métricas específicas de Blazor Server.
+
+```csharp
+// Program.cs
+builder.Services.AddOpenTelemetry()
+    .WithTracing(tracing =>
+    {
+        tracing.AddSource("Microsoft.AspNetCore.Components.Server");
+        tracing.AddAspireTracing();
+    })
+    .WithMetrics(metrics =>
+    {
+        metrics.AddMeter("Microsoft.AspNetCore.Components.Server");
+        metrics.AddAspireMetrics();
+    });
+```
+
+**Métricas disponíveis:**
+- Page navigations (por rota/componente)
+- UI events (eventos e duração)
+- Component lifecycle (render diff sizes)
+- Active circuits (usuários simultâneos)
+- Circuit state (connected/disconnected)
+
+**Visualização:** Aspire Dashboard integrado.
+
+### Hot Reload Aprimorado
+
+**Automático:** 10x mais rápido no Visual Studio 2026.
+
+**Nada a fazer:** Apenas use VS 2026 Preview ou `dotnet watch`.
+
+### Formulários com Validação Aninhada
+
+**Novo:** Validação automática de modelos aninhados.
+
+```csharp
+public class Order
+{
+    [Required]
+    public string OrderNumber { get; set; } = null!;
+
+    // Modelo aninhado - validado automaticamente
+    public Customer Customer { get; set; } = new();
+    public List<OrderItem> Items { get; set; } = new();
+}
+
+public class Customer
+{
+    [Required]
+    public string Name { get; set; } = null!;
+
+    [EmailAddress]
+    public string Email { get; set; } = null!;
+
+    // Aninhamento profundo - também validado
+    public Address ShippingAddress { get; set; } = new();
+}
+```
+
+```razor
+<EditForm Model="@_order" OnValidSubmit="HandleSubmit">
+    <DataAnnotationsValidator />
+    <ValidationSummary />
+    <!-- Campos... -->
+</EditForm>
+```
+
+**Configuração (Program.cs):**
+```csharp
+builder.Services.AddValidation(); // Habilita validação aninhada
+```
+
+---
+
+## 📚 Documentação de Referência
 
-- [Blazor Documentation](https://learn.microsoft.com/en-us/aspnet/core/blazor/)
-- [Entity Framework Core](https://learn.microsoft.com/en-us/ef/core/)
-- [ASP.NET Core](https://learn.microsoft.com/en-us/aspnet/core/)
+- [Blazor Documentation](https://learn.microsoft.com/aspnet/core/blazor/)
+- [Entity Framework Core 10](https://learn.microsoft.com/ef/core/)
+- [ASP.NET Core 10](https://learn.microsoft.com/aspnet/core/)
 - [Hangfire](https://docs.hangfire.io/)
+- **[Passkeys/WebAuthn](../../.morph/standards/passkeys-auth.md)**
+- **[Agent Framework](../../.morph/standards/agent-framework-setup.md)**
 
 ## Checklist de Projeto
 

package/content/.claude/skills/stacks/dotnet-nextjs.md

@@ -6,9 +6,9 @@ Stack full-stack com .NET Web API no backend e Next.js no frontend.
 
 | Aspecto | Tecnologia |
 |---------|------------|
-| **Backend** | .NET 9+ Web API |
+| **Backend** | .NET 10 Web API / C# 14 |
 | **Frontend** | Next.js 15+ / React 19 |
-| **Database** | Entity Framework Core + Azure SQL |
+| **Database** | Entity Framework Core 10 + Azure SQL |
 | **API** | REST + OpenAPI |
 | **Hosting** | Azure Container Apps |
 

package/content/.morph/.morphversion

@@ -0,0 +1,5 @@
+{
+  "morphVersion": "1.0.4",
+  "installedAt": "2025-11-28T00:00:00.000Z",
+  "cliVersion": "1.0.4"
+}

package/content/.morph/config/agents.json

@@ -7,6 +7,7 @@
         "name": "Standards Architect",
         "emoji": "📐",
         "type": "core",
+        "skillPath": ".claude/skills/specialists/standards-architect.md",
         "description": "Guardião dos padrões de código e arquitetura",
         "responsibilities": [
           "Validar aderência aos padrões em .morph/standards/",
@@ -21,6 +22,7 @@
         "name": "Azure Architect",
         "emoji": "☁️",
         "type": "core",
+        "skillPath": ".claude/skills/specialists/azure-architect.md",
         "description": "Especialista em infraestrutura Azure",
         "responsibilities": [
           "Desenhar infraestrutura cost-effective",
@@ -35,6 +37,7 @@
         "name": "Blazor Builder",
         "emoji": "🔥",
         "type": "core",
+        "skillPath": ".claude/skills/stacks/dotnet-blazor.md",
         "description": "Especialista em componentes Blazor Server",
         "responsibilities": [
           "Criar componentes reutilizáveis",
@@ -49,6 +52,7 @@
         "name": "EF Modeler",
         "emoji": "🗄️",
         "type": "core",
+        "skillPath": ".claude/skills/specialists/ef-modeler.md",
         "description": "Especialista em Entity Framework e modelagem de dados",
         "responsibilities": [
           "Modelar entidades e relacionamentos",
@@ -63,6 +67,7 @@
         "name": "Cost Guardian",
         "emoji": "💰",
         "type": "core",
+        "skillPath": ".claude/skills/specialists/cost-guardian.md",
         "description": "Guardião dos custos e otimização financeira",
         "responsibilities": [
           "Validar custos de cada recurso proposto",
@@ -81,6 +86,7 @@
         "name": "MS Agent Expert",
         "emoji": "🤖",
         "type": "core",
+        "skillPath": ".claude/skills/specialists/ms-agent-expert.md",
         "description": "Especialista em Microsoft Agent Framework e AI",
         "responsibilities": [
           "Integrar Semantic Kernel",
@@ -98,6 +104,7 @@
         "name": "Hangfire Orchestrator",
         "emoji": "⏰",
         "type": "specialist",
+        "skillPath": ".claude/skills/specialists/hangfire-orchestrator.md",
         "description": "Especialista em background jobs",
         "autoActivation": {
           "keywords": ["scheduled", "job", "background", "recurring", "batch", "cron", "queue"]
@@ -115,26 +122,63 @@
         "name": "UI/UX Designer",
         "emoji": "🎨",
         "type": "specialist",
-        "description": "Especialista em interfaces complexas",
+        "skillPath": ".claude/skills/specialists/ui-ux-designer.md",
+        "description": "Especialista em UI/UX, Fluent UI Blazor e MudBlazor. FASE 1.5 obrigatória para features com front-end.",
         "autoActivation": {
-          "keywords": ["wizard", "dashboard", "complex", "drag", "drop", "multi-step", "chart"]
+          "keywords": [
+            "blazor", "component", "page", "razor", "ui", "ux", "design", "layout", "responsive",
+            "wizard", "dashboard", "form", "chart", "table", "dialog", "modal", "button",
+            "input", "select", "dropdown", "menu", "navigation", "sidebar", "header", "footer",
+            "tela", "telas", "interface", "formulario", "visualizacao", "exibicao",
+            "screen", "screens", "view", "views", "display",
+            "mostrar", "exibir", "apresentar", "renderizar", "show", "render", "present",
+            "card", "cards", "list", "lists", "grid", "panel", "panels", "stepper", "tabs", "tab",
+            "login", "signup", "cadastro", "report", "reports", "detail", "details", "edit", "create",
+            "frontend", "front-end", "web", "app", "application", "client-side", "clientside"
+          ]
         },
+        "validatesPhases": ["uiux-design"],
         "responsibilities": [
-          "Desenhar fluxos de usuário",
-          "Definir componentes complexos",
-          "Garantir responsividade",
-          "Acessibilidade WCAG 2.1"
+          "Coletar input do usuário sobre preferências de UI/UX",
+          "Analisar screenshots/mockups de referência",
+          "Gerar wireframes ASCII e mockups",
+          "Especificar componentes Fluent UI ou MudBlazor",
+          "Desenhar fluxos de usuário completos",
+          "Documentar edge cases e estados (loading, error, empty)",
+          "Garantir acessibilidade WCAG 2.1",
+          "Validar responsividade (desktop, tablet, mobile)"
         ],
-        "deliverables": ["Wireframes ASCII", "User flows", "Component specs"]
+        "deliverables": [
+          "ui-design-system.md (cores, tipografia, spacing)",
+          "ui-mockups.md (wireframes ASCII + descrições)",
+          "ui-components.md (specs Fluent UI/MudBlazor)",
+          "ui-flows.md (fluxos + diagramas + edge cases)"
+        ],
+        "expertise": [
+          "Fluent UI Blazor (AI-first components)",
+          "MudBlazor (complex components)",
+          "WCAG 2.1 Accessibility",
+          "Responsive Design",
+          "ASCII wireframing",
+          "User flow diagrams"
+        ],
+        "workflow": [
+          "1. Perguntar ao usuário sobre preferências de layout/referências",
+          "2. Analisar imagens de exemplo (se fornecidas)",
+          "3. Decidir Fluent UI vs MudBlazor (justificar)",
+          "4. Gerar ui-mockups.md, ui-components.md, ui-flows.md",
+          "5. Pausar para aprovação do usuário"
+        ]
       },
       {
         "id": "popm-advisor",
         "name": "PO/PM Advisor",
         "emoji": "📋",
         "type": "specialist",
+        "skillPath": ".claude/skills/specialists/po-pm-advisor.md",
         "description": "Consultor de produto e requisitos",
         "autoActivation": {
-          "keywords": ["unclear", "requirements", "priority", "ROI", "business", "value", "scope"]
+          "keywords": ["unclear", "requirements", "priority", "roi", "business", "value", "scope"]
         },
         "responsibilities": [
           "Clarificar requisitos vagos",
@@ -143,6 +187,55 @@
           "Questionar valor de negócio"
         ],
         "techniques": ["5 Whys", "MoSCoW", "User story mapping"]
+      },
+      {
+        "id": "ai-system-architect",
+        "name": "AI System Architect",
+        "emoji": "🏗️",
+        "type": "specialist",
+        "skillPath": ".claude/skills/specialists/ai-system-architect.md",
+        "description": "Especialista em arquitetura de sistemas agênticos e orquestração multi-agente",
+        "autoActivation": {
+          "keywords": [
+            "orchestration", "multi-agent", "workflow", "agent-to-agent", "a2a",
+            "system-design", "reflection", "planning", "memory", "rag",
+            "vector-search", "chunking", "embedding", "retrieval", "agentic",
+            "reasoning", "chain-of-thought", "tree-of-thought", "prompt-chaining",
+            "routing", "parallelization", "collaboration", "evaluation",
+            "guardrails", "prioritization", "exploration", "discovery"
+          ]
+        },
+        "validatesPhases": ["design"],
+        "responsibilities": [
+          "Desenhar arquiteturas agênticas complexas e escaláveis",
+          "Definir padrões de orquestração (workflows, comunicação inter-agentes)",
+          "Implementar pipelines RAG (Retrieval-Augmented Generation)",
+          "Avaliar estratégias de chunking, embedding e retrieval",
+          "Selecionar padrões adequados dos 20 padrões de design agêntico",
+          "Definir estrutura de memória e estado de agentes",
+          "Implementar monitoramento e avaliação de sistemas agênticos"
+        ],
+        "expertise": [
+          "20 Padrões de Design Agêntico",
+          "Framework TACO (Taskers, Automators, Collaborators, Orchestrators)",
+          "Microsoft Agent Framework Workflows",
+          "Azure AI Search + RAG Pipeline",
+          "Semantic Kernel Memory Connectors",
+          "A2A (Agent-to-Agent) Protocol",
+          "Reasoning Techniques (Chain of Thought, Tree of Thought)",
+          "Multi-Agent Collaboration Patterns"
+        ],
+        "patterns": [
+          "Prompt Chaining",
+          "Routing",
+          "Parallelization",
+          "Reflection",
+          "Multi-Agent Collaboration",
+          "Memory Management",
+          "RAG Pipeline",
+          "Resource-Aware Optimization",
+          "Evaluation and Monitoring"
+        ]
       }
     ]
   }

package/content/.morph/config/azure-pricing.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "./azure-pricing.schema.json",
+  "version": "1.0.0",
+  "region": "eastus2",
+  "currency": "USD",
+  "lastUpdated": "2025-01-10T00:00:00Z",
+  "resources": {
+    "Microsoft.Sql/servers/databases": {
+      "Free": 0,
+      "Basic": 4.99,
+      "S0": 14.72,
+      "S1": 29.44,
+      "S2": 73.61,
+      "S3": 147.22,
+      "S4": 294.44,
+      "P1": 465.00,
+      "P2": 930.00,
+      "GP_Gen5_2": 328.00,
+      "GP_Gen5_4": 656.00,
+      "BC_Gen5_2": 1092.00
+    },
+    "Microsoft.App/containerApps": {
+      "Consumption": 0,
+      "Consumption_Active": 5.00,
+      "Dedicated_D2": 55.00,
+      "Dedicated_D4": 110.00
+    },
+    "Microsoft.Storage/storageAccounts": {
+      "Standard_LRS": 0.02,
+      "Standard_GRS": 0.05,
+      "Premium_LRS": 0.15
+    },
+    "Microsoft.Insights/components": {
+      "Free": 0,
+      "Basic": 2.30
+    },
+    "Microsoft.KeyVault/vaults": {
+      "Standard": 0.03,
+      "Premium": 1.00
+    },
+    "Microsoft.DocumentDB/databaseAccounts": {
+      "Serverless": 0,
+      "Provisioned_400RU": 23.36,
+      "Provisioned_1000RU": 58.40
+    },
+    "Microsoft.Web/serverfarms": {
+      "F1": 0,
+      "D1": 9.67,
+      "B1": 13.14,
+      "B2": 26.28,
+      "S1": 69.35,
+      "P1v2": 146.00
+    },
+    "Microsoft.ServiceBus/namespaces": {
+      "Basic": 0.05,
+      "Standard": 10.00,
+      "Premium": 677.00
+    },
+    "Microsoft.Cache/redis": {
+      "C0": 16.06,
+      "C1": 61.32,
+      "C2": 122.63,
+      "P1": 486.00
+    },
+    "Microsoft.Web/sites": {
+      "Consumption": 0,
+      "Premium_EP1": 146.00
+    }
+  }
+}

package/content/.morph/config/azure-pricing.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://polymorphism.com.br/schemas/azure-pricing.json",
+  "title": "Azure Pricing Table",
+  "description": "Monthly pricing for Azure resources by SKU (East US 2 / Brazil South)",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "description": "Schema version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "region": {
+      "type": "string",
+      "description": "Azure region for pricing",
+      "enum": ["eastus2", "brazilsouth", "westus2", "northeurope"]
+    },
+    "currency": {
+      "type": "string",
+      "description": "Currency code",
+      "enum": ["USD", "BRL", "EUR"]
+    },
+    "lastUpdated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Last time pricing was updated"
+    },
+    "resources": {
+      "type": "object",
+      "description": "Resource types and their SKU pricing",
+      "patternProperties": {
+        "^Microsoft\\.[A-Za-z]+/[A-Za-z]+$": {
+          "type": "object",
+          "description": "SKU pricing for a resource type",
+          "additionalProperties": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Monthly cost in specified currency"
+          }
+        }
+      }
+    }
+  },
+  "required": ["version", "region", "currency", "lastUpdated", "resources"],
+  "additionalProperties": false
+}

package/content/.morph/config/config.template.json

@@ -1,5 +1,4 @@
 {
-  "version": "1.0.0",
   "project": {
     "name": "MyProject",
     "description": "Descrição do projeto",
@@ -90,7 +89,20 @@
   },
   "costs": {
     "monthlyBudget": 15,
-    "alertThreshold": 10,
-    "requireApprovalAbove": 10
+    "currency": "USD",
+    "limits": {
+      "freeTierOnly": 0,
+      "withApproval": 10,
+      "requiresADR": 10
+    },
+    "enforcement": {
+      "blockCommitsAboveLimit": true,
+      "requireADRInDecisionsMd": true,
+      "alertOnApproach": 0.8
+    },
+    "pricing": {
+      "region": "eastus2",
+      "lastUpdated": "2024-01-01"
+    }
   }
 }