@polymorphism-tech/morph-spec 3.2.0 → 4.2.0

package/stacks/blazor-azure/.morph/docs/workflows/fast-track.md

@@ -1,29 +0,0 @@
-# Workflow: FAST TRACK (Trivial)
-
-> **Layer:** 1 | **Load:** on-keyword | **Keywords:** bug, fix, corrigir, ajustar, hotfix, edge case, cor, css
-
-## Critérios
-
-- ≤ 3 arquivos modificados, ≤ 50 linhas, 0 novos componentes
-- Sem infraestrutura, sem decisões arquiteturais
-
-## Fases
-
-### 1. Quick Analysis (FASE 0+1+2 combinadas)
-- Identifica problema em 2-3 parágrafos
-- Propõe solução direta
-- **PAUSA:** Aprovar ou ajustar?
-
-### 2. Implement & Test
-- Implementa diretamente
-- Testa
-- Cria commit descritivo
-
-## Outputs
-Nenhum (ou apenas commit message detalhado)
-
-## Exemplos
-- "Corrigir validação de CPF no formulário"
-- "Ajustar cor do botão primário"
-- "Hotfix: null pointer na home"
-- "Edge case: validação quando campo vazio"

package/stacks/blazor-azure/.morph/docs/workflows/full-morph.md

@@ -1,76 +0,0 @@
-# Workflow: FULL MORPH (Alta Complexidade)
-
-> **Layer:** 1 | **Load:** on-keyword | **Keywords:** sistema, autenticação, integração, pattern, cqrs, subsistema
-
-## Critérios
-
-- > 10 arquivos, > 500 linhas, múltiplos componentes novos
-- Infraestrutura Azure (Bicep), decisões arquiteturais estratégicas
-
-## Fases (TODAS obrigatórias)
-
-### FASE 0.5: CONTEXT (automática)
-1. Detectar framework MORPH (`@polymorphism-tech/morph-spec`)
-2. Detectar/criar estrutura `.morph/project/`
-3. Análise automática: stack (glob patterns), arquitetura (pastas), configs, UI library
-4. Analisar histórico: decisions.md passados, preferências do usuário
-5. Gerar/atualizar `.morph/project/standards/inferred.md`
-6. Ativar agentes baseado em stack + keywords
-
-### FASE 0: PROPOSAL
-1. `npx morph-spec detect "{user-request}"`
-2. Analisar solicitação, identificar stack, estimar complexidade
-3. Gerar proposal.md, registrar agentes no state.json
-- **⛔ PAUSA:** 3 itens (1 ação + 1 pergunta + 1 sugestão)
-
-### FASE 1: SETUP
-1. Ler `.morph/config.json`
-2. Confirmar stack, ativar agentes, criar pasta outputs
-3. Carregar padrões (framework/standards/ > project/standards/)
-
-### FASE 1.5: UI/UX (condicional - se keywords UI detectadas)
-1. **Perguntar ao usuário:** layout, referências visuais, fluxo, imagens
-2. Analisar referências fornecidas
-3. Gerar deliverables AGNÓSTICOS de biblioteca (ui-mockups, ui-components, ui-flows)
-4. Validar acessibilidade (WCAG 2.1) e responsividade
-- **⛔ PAUSA:** Aprovar / Ajustar wireframes / Adicionar fluxos
-
-### FASE 2: DESIGN
-1. Gerar spec.md com requisitos completos
-2. **DECISION POINTS** (cada um requer aprovação):
-   - Biblioteca UI (Fluent UI vs MudBlazor)
-   - Padrões Arquiteturais (CQRS vs simples, Repository vs EF direto)
-   - Estrutura de Dados (entidades, relacionamentos)
-   - Infraestrutura Azure (recursos, SKUs, custos)
-   - Bibliotecas/SDKs (NuGet packages)
-3. Gerar contracts.cs, documentar decisões em decisions.md
-- **⛔ PAUSA:** Aprovar / Ajustar escopo / Modificar contracts
-
-### FASE 3: CLARIFY
-1. Identificar ambiguidades, fazer perguntas, documentar em spec.md, validar edge cases
-
-### FASE 4: TASKS
-1. Quebrar spec em tasks T001-TXXX, definir ordem, checkpoints, dependências
-- **⛔ PAUSA:** Aprovar / Repriorizar / Adicionar-remover tasks
-
-### FASE 5: IMPLEMENT
-1. Implementar task por task
-2. `npx morph-spec task done {feature} {task-id}` após cada task
-3. Framework gerencia checkpoints automaticamente (a cada 3 tasks)
-4. Gerar recap.md ao final
-
-### FASE 6: SYNC (condicional - se complexidade média/alta)
-1. Revisar decisions.md, categorizar (coding, architecture, azure, integrations, ui-ux)
-2. Promover para `.morph/project/standards/{category}.md`
-3. Gerar commit dedicado de sync
-- **⛔ PAUSA:** Aprovar promoção de decisões para standards
-
-## Outputs Completos
-proposal.md, ui-design-system.md, ui-mockups.md, ui-components.md, ui-flows.md, spec.md, contracts.cs, tasks.json, decisions.md, recap.md
-
-## Exemplos
-- "Sistema de relatórios com jobs agendados Hangfire"
-- "Autenticação completa com Clerk (login, signup, OAuth)"
-- "Dashboard com gráficos, tabelas e filtros complexos"
-- "RAG pipeline com Azure AI Search e embeddings"
-- "Infraestrutura Azure completa com Bicep"

package/stacks/blazor-azure/.morph/docs/workflows/standard.md

@@ -1,44 +0,0 @@
-# Workflow: STANDARD (Média Complexidade)
-
-> **Layer:** 1 | **Load:** on-keyword | **Keywords:** paginação, filtro, refatorar, performance, exportar
-
-## Critérios
-
-- 3-10 arquivos, 50-500 linhas, 1-2 componentes simples
-- Sem infraestrutura complexa, decisões táticas (não estratégicas)
-
-## Fases
-
-### 1. FASE 0: PROPOSAL (simplificada)
-- Análise inicial em 1 parágrafo
-- Detecta agentes relevantes
-- **PAUSA:** Aprovar?
-
-### 2. FASE 2: DESIGN (apenas spec.md)
-- Spec técnico conciso (1-2 páginas)
-- Sem contracts.cs se trivial
-- Decisões táticas em decisions.md
-- **PAUSA:** Aprovar?
-
-### 3. FASE 4: TASKS (se > 5 tasks)
-- Breakdown em tasks
-- **PAUSA:** Aprovar?
-
-### 4. FASE 5: IMPLEMENT
-- Implementa task por task
-- Gera recap.md ao final
-
-## Outputs
-proposal.md, spec.md, recap.md (mínimo necessário)
-
-## Fases Puladas
-- FASE 1 (SETUP) - contexto já carregado
-- FASE 1.5 (UI/UX) - se não tiver front-end significativo
-- FASE 3 (CLARIFY) - se spec for claro
-- FASE 6 (SYNC) - decisões não são estratégicas
-
-## Exemplos
-- "Adicionar paginação na tabela de usuários"
-- "Criar filtro por data no relatório"
-- "Refatorar serviço de email para async"
-- "Adicionar botão de exportar CSV"

package/stacks/blazor-azure/.morph/docs/workflows/ui-refresh.md

@@ -1,39 +0,0 @@
-# Workflow: UI REFRESH (Redesign Visual)
-
-> **Layer:** 1 | **Load:** on-keyword | **Keywords:** redesign, redesenhar, bonito, visual, estetica, modernizar
-
-## Critérios
-
-- Páginas existentes com código funcional
-- Apenas mudanças visuais (CSS, HTML, layout)
-- Sem mudanças em lógica de negócio, sem infraestrutura
-
-## Fases
-
-### 1. ANÁLISE VISUAL (FASE 0+1 combinadas)
-- Listar páginas a redesenhar
-- Identificar componentes compartilhados e design system existente
-- Se protótipo existir: ler e extrair padrões
-- **PAUSA:** Escolher direção estética
-
-### 2. DESIGN SYSTEM (FASE 1.5 simplificada)
-- Definir variáveis CSS novas
-- Listar componentes CSS a criar (checklist)
-- Gerar/atualizar design-system.css
-- **PAUSA:** Aprovar componentes
-
-### 3. IMPLEMENT (por página)
-- Atualizar CSS primeiro, depois cada página .razor
-- Build incremental a cada 2-3 páginas
-- Validar com `morph-spec validate-css`
-
-## Outputs
-design-refresh-checklist.md, CSS atualizado, páginas .razor, recap.md
-
-## Fases Puladas
-Setup completo, Contracts, Tasks detalhadas, Infra, Clarify, Sync
-
-## Exemplos
-- "Redesenhar as páginas do checkout para ficar mais bonito"
-- "Modernizar visual do dashboard"
-- "Aplicar novo design system nas telas existentes"

package/stacks/blazor-azure/.morph/examples/api-nextjs/README.md

@@ -1,241 +0,0 @@
-# API .NET + Next.js Example
-
-Exemplo de arquitetura full-stack com .NET API backend e Next.js frontend.
-
-## Stack
-
-| Camada | Tecnologia |
-|--------|------------|
-| **Frontend** | Next.js 14 (App Router) |
-| **Backend** | .NET 8 Minimal APIs |
-| **Database** | SQL Server / PostgreSQL |
-| **Auth** | Clerk (SSO) |
-| **API Communication** | REST + React Query |
-| **Infra** | Azure Container Apps |
-
-## Arquitetura
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    Next.js Frontend                          │
-│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
-│  │   Pages     │  │ Components  │  │    Hooks            │  │
-│  │  /dashboard │  │ DataTable   │  │ useProducts()       │  │
-│  │  /products  │  │ Forms       │  │ useOrders()         │  │
-│  │  /orders    │  │ Charts      │  │ useAuth()           │  │
-│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              │ REST API
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│                      .NET API                                │
-│  ┌─────────────────────────────────────────────────────┐    │
-│  │  Endpoints: /api/products, /api/orders, /api/users  │    │
-│  └─────────────────────────────────────────────────────┘    │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │
-│  │  Services    │  │  Validators  │  │  Middlewares     │  │
-│  └──────────────┘  └──────────────┘  └──────────────────┘  │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│                     Infrastructure                           │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │
-│  │  EF Core     │  │  Redis       │  │  Blob Storage    │  │
-│  │  Repository  │  │  Cache       │  │  (files)         │  │
-│  └──────────────┘  └──────────────┘  └──────────────────┘  │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## Estrutura de Pastas
-
-```
-project/
-├── src/
-│   ├── api/                          # .NET Backend
-│   │   ├── Api/
-│   │   │   ├── Endpoints/
-│   │   │   │   ├── ProductEndpoints.cs
-│   │   │   │   ├── OrderEndpoints.cs
-│   │   │   │   └── UserEndpoints.cs
-│   │   │   ├── Middleware/
-│   │   │   └── Program.cs
-│   │   ├── Application/
-│   │   │   ├── Services/
-│   │   │   └── Validators/
-│   │   ├── Domain/
-│   │   │   ├── Entities/
-│   │   │   └── Interfaces/
-│   │   └── Infrastructure/
-│   │       ├── Data/
-│   │       └── Repositories/
-│   │
-│   └── web/                          # Next.js Frontend
-│       ├── app/
-│       │   ├── (auth)/
-│       │   │   ├── sign-in/
-│       │   │   └── sign-up/
-│       │   ├── (dashboard)/
-│       │   │   ├── dashboard/
-│       │   │   ├── products/
-│       │   │   └── orders/
-│       │   ├── layout.tsx
-│       │   └── page.tsx
-│       ├── components/
-│       │   ├── ui/
-│       │   └── shared/
-│       ├── hooks/
-│       │   ├── use-products.ts
-│       │   └── use-orders.ts
-│       ├── lib/
-│       │   ├── api-client.ts
-│       │   └── utils.ts
-│       └── types/
-│
-├── infra/                            # Infrastructure as Code
-│   ├── main.bicep
-│   └── modules/
-│
-└── docker-compose.yml
-```
-
-## Quick Start
-
-### Backend (.NET)
-
-```bash
-cd src/api
-dotnet restore
-dotnet ef database update
-dotnet run
-```
-
-### Frontend (Next.js)
-
-```bash
-cd src/web
-npm install
-npm run dev
-```
-
-### Docker Compose
-
-```bash
-docker-compose up -d
-```
-
-## Features
-
-### Backend
-- Minimal APIs com OpenAPI
-- FluentValidation para validação
-- EF Core com Repository Pattern
-- JWT Bearer Authentication
-- Health Checks
-- Structured Logging
-
-### Frontend
-- App Router (Next.js 14)
-- Server Components + Client Components
-- React Query para data fetching
-- Tailwind CSS + shadcn/ui
-- Form handling com React Hook Form
-- TypeScript estrito
-
-## Autenticação
-
-### Fluxo
-
-```mermaid
-sequenceDiagram
-    participant User
-    participant NextJS
-    participant Clerk
-    participant API
-
-    User->>NextJS: Acessa /sign-in
-    NextJS->>Clerk: Redirect para Clerk
-    User->>Clerk: Login
-    Clerk-->>NextJS: JWT Token
-    NextJS->>API: Request com Bearer Token
-    API->>Clerk: Valida token (JWKS)
-    API-->>NextJS: Response
-    NextJS-->>User: Renderiza página
-```
-
-### Configuração Clerk (Next.js)
-
-```typescript
-// middleware.ts
-import { clerkMiddleware } from "@clerk/nextjs/server";
-
-export default clerkMiddleware();
-
-export const config = {
-  matcher: ["/((?!.*\\..*|_next).*)", "/", "/(api|trpc)(.*)"],
-};
-```
-
-### Configuração JWT (API)
-
-```csharp
-// Program.cs
-builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
-    .AddJwtBearer(options =>
-    {
-        options.Authority = builder.Configuration["Clerk:Authority"];
-        options.TokenValidationParameters = new TokenValidationParameters
-        {
-            ValidateAudience = false,
-            NameClaimType = "sub"
-        };
-    });
-```
-
-## API Client (Frontend)
-
-```typescript
-// lib/api-client.ts
-import { auth } from "@clerk/nextjs/server";
-
-const API_BASE_URL = process.env.NEXT_PUBLIC_API_URL;
-
-export async function apiClient<T>(
-  endpoint: string,
-  options: RequestInit = {}
-): Promise<T> {
-  const { getToken } = auth();
-  const token = await getToken();
-
-  const response = await fetch(`${API_BASE_URL}${endpoint}`, {
-    ...options,
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${token}`,
-      ...options.headers,
-    },
-  });
-
-  if (!response.ok) {
-    throw new Error(`API Error: ${response.statusText}`);
-  }
-
-  return response.json();
-}
-```
-
-## Custos Estimados
-
-| Recurso | Tier | Custo/mês |
-|---------|------|-----------|
-| Container App (API) | Consumption | ~$0-5 |
-| Container App (Web) | Consumption | ~$0-5 |
-| SQL Database | Free 32GB | $0 |
-| Clerk | Free 10k MAU | $0 |
-
-**Total**: < $10/mês para MVPs
-
----
-
-*MORPH-SPEC by Polymorphism Tech*