@polymorphism-tech/morph-spec 4.3.1 → 4.3.2

package/stacks/nextjs-supabase/.claude/commands/morph-preflight.md

@@ -0,0 +1,227 @@
+# Pre-Flight Check for Azure Deployment
+
+Validates project readiness before deploying to Azure.
+
+## Uso
+
+```
+/morph-preflight azure
+```
+
+## Objetivo
+
+Detectar problemas **antes** do deploy que causariam falhas em produção. Economiza tempo e evita debugging em ambiente Azure.
+
+---
+
+## Validações Executadas
+
+### 1. Package Version Conflicts
+
+**O que verifica:**
+- `Azure.Identity` especificado explicitamente
+- Sem conflitos de versão (NU1605, NU1608)
+- Packages críticos com versões compatíveis
+
+**Como verificar:**
+```bash
+dotnet restore --verbosity normal 2>&1 | grep -E "(NU1605|NU1608|warning)"
+```
+
+**Fix comum:**
+```xml
+<PackageReference Include="Azure.Identity" Version="1.14.2" />
+```
+
+---
+
+### 2. EF Core Migrations
+
+**O que verifica:**
+- Sem pending model changes
+- Migrations aplicáveis existem
+- Migration scripts são válidos
+
+**Como verificar:**
+```bash
+dotnet ef migrations has-pending-model-changes \
+  --project src/Infrastructure \
+  --startup-project src/Web
+```
+
+**Fix comum:**
+```bash
+dotnet ef migrations add <MigrationName> \
+  --project src/Infrastructure \
+  --startup-project src/Web
+```
+
+---
+
+### 3. Dockerfile Validation (se Container Apps)
+
+**O que verifica:**
+- Dockerfile existe
+- Base image é válida
+- Multi-stage build configurado
+- EXPOSE ports corretos
+- ENTRYPOINT definido
+
+**Como verificar:**
+```bash
+docker build --check .
+# Ou validação manual do Dockerfile
+```
+
+---
+
+### 4. Blazor .NET 10 Assets
+
+**O que verifica:**
+- `RequiresAspNetWebAssets` está `true` (se Blazor + .NET 10)
+- Static web assets configurados corretamente
+
+**Como verificar:**
+```bash
+grep -r "RequiresAspNetWebAssets" *.csproj
+```
+
+**Fix:**
+```xml
+<PropertyGroup>
+  <RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>
+</PropertyGroup>
+```
+
+---
+
+### 5. Bicep Syntax Validation
+
+**O que verifica:**
+- Arquivos `.bicep` sem erros de sintaxe
+- Parâmetros obrigatórios definidos
+- Resources com nomes válidos
+
+**Como verificar:**
+```bash
+az bicep build --file infra/main.bicep --stdout > /dev/null
+```
+
+---
+
+### 6. Key Vault Configuration
+
+**O que verifica:**
+- Key Vault URI configurado em `appsettings.json` ou environment
+- Não condiciona Key Vault ao ambiente (bug comum)
+- Managed Identity habilitada
+
+**Como verificar:**
+```bash
+grep -r "KeyVaultUri\|AzureKeyVault" appsettings*.json
+grep -r "IsDevelopment()" Program.cs | grep -i keyvault
+```
+
+**Anti-pattern a detectar:**
+```csharp
+// ❌ ERRADO - Não carrega Key Vault em dev!
+if (!builder.Environment.IsDevelopment())
+{
+    builder.Configuration.AddAzureKeyVault(...);
+}
+```
+
+---
+
+### 7. Connection Strings Security
+
+**O que verifica:**
+- Connection strings não hardcoded em código
+- Secrets em Key Vault ou User Secrets
+- Sem credentials em `appsettings.json` (exceto Development)
+
+**Como verificar:**
+```bash
+# Detectar passwords em appsettings
+grep -rE "(Password=|Pwd=|Secret=)" appsettings*.json | grep -v Development
+```
+
+---
+
+## Output Exemplo
+
+```
+🔍 MORPH Pre-Flight Check: Azure Deployment
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+✅ Packages: No version conflicts detected
+✅ Migrations: No pending model changes
+✅ Dockerfile: Valid multi-stage build
+✅ Blazor Assets: RequiresAspNetWebAssets=true
+✅ Bicep: Syntax valid
+❌ Key Vault: URI not configured in appsettings.Production.json
+⚠️ Connection Strings: Found password in appsettings.Staging.json
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📋 Summary: 5 passed, 1 failed, 1 warning
+
+❌ BLOCKED: Fix Key Vault configuration before deploy!
+
+Recommended fixes:
+1. Add KeyVaultUri to appsettings.Production.json
+2. Move password from appsettings.Staging.json to Key Vault
+```
+
+---
+
+## Workflow de Uso
+
+### Antes de criar PR para produção
+
+```bash
+/morph-preflight azure
+```
+
+### No pipeline CI/CD
+
+```yaml
+- script: |
+    # Package check
+    dotnet restore 2>&1 | grep -E "NU1605|NU1608" && exit 1
+
+    # Migration check
+    dotnet ef migrations has-pending-model-changes \
+      --project src/Infrastructure \
+      --startup-project src/Web
+    if [ $? -ne 0 ]; then exit 1; fi
+
+    # Bicep check
+    az bicep build --file infra/main.bicep --stdout > /dev/null
+    if [ $? -ne 0 ]; then exit 1; fi
+
+    echo "Pre-flight checks passed!"
+  displayName: 'Pre-flight validation'
+```
+
+---
+
+## Validações Futuras (Roadmap)
+
+- [ ] Cost estimation validation (dentro do budget)
+- [ ] RBAC permissions check
+- [ ] Network security rules validation
+- [ ] Health probe endpoint exists
+- [ ] Application Insights configured
+
+---
+
+## Referências
+
+- [azure.md](../../standards/azure.md) - Padrões Azure
+- [dotnet10-migration.md](../../standards/dotnet10-migration.md) - Breaking changes .NET 10
+- [blazor-efcore.md](../../../../framework/standards/blazor-efcore.md) - EF Core patterns
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/stacks/nextjs-supabase/.claude/commands/morph-proposal.md

@@ -0,0 +1,122 @@
+# MORPH Spec Pipeline
+
+Crie ou retome o planejamento de uma feature, guiando automaticamente pelas fases 0→4 com pausas obrigatórias.
+
+---
+
+## 1. Resume Logic
+
+Primeiro, verifique se a feature já existe:
+
+```bash
+npx morph-spec state get {feature-name}
+```
+
+- **Se existe:** Identifique a fase atual e retome de onde parou (pular fases já concluídas)
+- **Se não existe:** Iniciar do zero (FASE 0)
+
+---
+
+## 2. FASE 0: PROPOSAL
+
+### Workflow
+
+1. **Detecte agentes automaticamente:**
+   ```bash
+   npx morph-spec detect-agents "$ARGUMENTS"
+   ```
+
+2. **Invoque skills dos agentes detectados:**
+   - Para agentes com `skillPath` em agents.json, consulte o Skill correspondente
+   - Use conhecimento dos skills para enriquecer a proposta
+
+3. **Analise a solicitação** e identifique: problema, usuários afetados, impacto
+
+4. **Crie a estrutura:**
+   ```
+   .morph/project/outputs/{feature-name}/
+   ├── proposal.md
+   ├── spec.md (iniciar)
+   └── tasks.json (iniciar)
+   ```
+
+5. **Preencha `proposal.md`** baseado em `framework/templates/proposal.md`
+
+6. **Registre no state:**
+   ```bash
+   npx morph-spec state set {feature-name} status draft
+   npx morph-spec state set {feature-name} phase proposal
+   npx morph-spec state mark-output {feature-name} proposal
+   # Adicionar cada agente detectado:
+   npx morph-spec state add-agent {feature-name} {agent-id}
+   ```
+
+### PAUSA OBRIGATORIA
+
+Apresente: resumo da proposta, agentes ativados, custo estimado, 3 itens de pausa.
+
+---
+
+## 3. Após Aprovação do Proposal → FASE 1: SETUP (auto, sem pausa)
+
+**Ler:** `.claude/skills/workflows/phase-setup.md` para instruções detalhadas.
+
+Resumo: carregar contexto do projeto, confirmar stack, listar agentes ativos, atualizar state.
+
+**Não pausa aqui.** Continuar automaticamente.
+
+---
+
+## 4. FASE 1.5: UI/UX (condicional)
+
+Verificar se `uiux-designer` está nos `activeAgents`:
+- **Se SIM:** Ler `.claude/skills/workflows/phase-uiux.md` e executar. **PAUSA OBRIGATORIA** após gerar deliverables UI.
+- **Se NÃO:** Pular para FASE 2.
+
+---
+
+## 5. FASE 2: DESIGN
+
+**Ler:** `.claude/skills/workflows/phase-design.md` para instruções detalhadas.
+
+Resumo: gerar spec.md, contracts.cs, decisions.md com ADRs, estimar custos.
+
+### PAUSA OBRIGATORIA
+
+Apresente: spec, contracts, decisions, custos. 3 itens de pausa (aprovar, ajustar escopo, modificar contracts).
+
+---
+
+## 6. Após Aprovação do Design → FASE 3: CLARIFY (interativo)
+
+**Ler:** `.claude/skills/workflows/phase-clarify.md` para instruções detalhadas.
+
+Resumo: identificar ambiguidades, gerar 3-7 perguntas, aguardar respostas, atualizar spec com clarificações e edge cases.
+
+**Aguardar respostas do usuário antes de continuar.**
+
+---
+
+## 7. FASE 4: TASKS
+
+**Ler:** `.claude/skills/workflows/phase-tasks.md` para instruções detalhadas.
+
+Resumo: quebrar spec em tasks T001-TXXX, definir dependências, checkpoints, estimativas.
+
+### PAUSA OBRIGATORIA
+
+Apresente: breakdown de tasks, ordem de execução, estimativa total. 3 itens de pausa (aprovar, repriorizar, adicionar/remover).
+
+---
+
+## 8. Planejamento Completo
+
+Após aprovação das tasks:
+
+```
+Planejamento completo! Execute /morph-apply {feature-name} para iniciar implementação.
+```
+
+---
+
+**Feature solicitada:** $ARGUMENTS

package/stacks/nextjs-supabase/.claude/commands/morph-status.md

@@ -0,0 +1,86 @@
+# MORPH Project Status
+
+Mostre o status atual do projeto MORPH e features em desenvolvimento.
+
+## Como Usar
+
+**SEMPRE** use o state-manager CLI para obter status:
+
+```bash
+npx morph-spec state list
+```
+
+Este comando automaticamente mostra:
+- Todas as features ativas
+- Fase atual de cada feature
+- Progresso de tasks (X/Y)
+- Agentes ativos
+- Custos estimados
+
+## Verificações Adicionais
+
+### 1. Configuração MORPH
+- [ ] `.morph/project.md` existe e está preenchido
+- [ ] `.morph/config/config.json` configurado
+- [ ] `.morph/standards/` presentes
+
+### 2. Detalhes de Feature Específica
+
+Para obter JSON detalhado de uma feature:
+
+```bash
+npx morph-spec state get {feature-name}
+```
+
+### 3. Features Arquivadas
+
+Verifique `.morph/project/archive/` manualmente se necessário:
+- Quantas features concluídas
+- Tempo total gasto
+- Custo acumulado
+
+### 4. Specs Ativas
+
+Verifique `.morph/project/specs/` para specs consolidadas.
+
+## Output
+
+O comando `npx morph-spec state list` automaticamente gera um dashboard formatado:
+
+```
+╔════════════════════════════════════════════════════════════════╗
+║                    MORPH-SPEC PROJECT STATUS                   ║
+╠════════════════════════════════════════════════════════════════╣
+║ Project: {PROJECT_NAME}                                        ║
+║ Type: blazor-server                                            ║
+╠════════════════════════════════════════════════════════════════╣
+║ FEATURES                                                       ║
+╠════════════════════════════════════════════════════════════════╣
+║ 📝 {feature-1}                                                 ║
+║    Phase: implement        │ Tasks: 5/12                       ║
+║    Agents: blazor-builder ef-modeler hangfire-orchestrator     ║
+╠════════════════════════════════════════════════════════════════╣
+║ 📝 {feature-2}                                                 ║
+║    Phase: design           │ Tasks: 0/0                        ║
+║    Agents: None                                                ║
+╠════════════════════════════════════════════════════════════════╣
+║ SUMMARY                                                        ║
+╠════════════════════════════════════════════════════════════════╣
+║ Total Features: 2                                              ║
+║ Completed: 0                                                   ║
+║ Estimated Cost: $5.50/month                                    ║
+╚════════════════════════════════════════════════════════════════╝
+```
+
+**Simplesmente execute o comando e mostre o resultado ao usuário.**
+
+## Ações Disponíveis
+
+Sugira próximas ações:
+- `/morph-proposal {feature}` - Criar nova feature
+- `/morph-apply {feature}` - Implementar feature
+- `/morph-archive {feature}` - Arquivar feature concluída
+
+---
+
+$ARGUMENTS

package/stacks/nextjs-supabase/.claude/commands/morph-troubleshoot.md

@@ -0,0 +1,122 @@
+# Troubleshoot - Buscar Soluções para Erros
+
+Busca soluções para erros e problemas comuns no desenvolvimento .NET/Blazor/Azure.
+
+## Uso
+
+```
+/morph-troubleshoot <descrição do erro ou keywords>
+```
+
+## Exemplos
+
+```bash
+/morph-troubleshoot blazor.web.js 404
+/morph-troubleshoot DbContext second operation
+/morph-troubleshoot Azure.Identity NU1605
+/morph-troubleshoot Include retorna vazio
+/morph-troubleshoot PendingModelChanges
+```
+
+## Workflow de 3 Níveis
+
+### Nível 1: Índice JSON (Primário)
+
+Primeiro, execute o comando CLI para buscar no índice de problemas conhecidos:
+
+```bash
+npx morph-spec troubleshoot {keywords}
+
+# Opções
+--category <cat>     # Filtrar por categoria (blazor, efcore, azure)
+--verbose            # Mostrar conteúdo completo da solução
+--list-categories    # Listar categorias disponíveis
+```
+
+### Nível 2: Grep nos Standards (Automático)
+
+Se o índice retornar poucos resultados, o CLI automaticamente busca nos arquivos:
+- `framework/standards/*.md`
+- `.morph/standards/*.md`
+
+### Nível 3: Web Search (Se necessário)
+
+**IMPORTANTE:** Se os níveis 1 e 2 não encontrarem solução, use o tool **WebSearch** nativo do Claude Code para buscar nas seguintes fontes:
+
+**Queries recomendadas:**
+
+```
+# GitHub Issues (.NET)
+site:github.com/dotnet/aspnetcore {erro}
+site:github.com/dotnet/efcore {erro}
+
+# Stack Overflow
+site:stackoverflow.com [blazor] {erro}
+site:stackoverflow.com [entity-framework-core] {erro}
+site:stackoverflow.com [azure] {erro}
+
+# Documentação Microsoft
+site:learn.microsoft.com {erro}
+site:learn.microsoft.com/azure {erro}
+```
+
+**Exemplo de uso do WebSearch:**
+
+Se o usuário perguntar sobre um erro de SignalR:
+1. Primeiro: `npx morph-spec troubleshoot SignalR connection`
+2. Se não encontrar: WebSearch com `site:github.com/dotnet/aspnetcore SignalR connection closed`
+3. Retornar links relevantes formatados
+
+## Categorias Disponíveis
+
+| Categoria | Descrição |
+|-----------|-----------|
+| `blazor` | Blazor Server/WASM, componentes, lifecycle, renderização |
+| `efcore` | Entity Framework Core, DbContext, migrations, queries |
+| `azure` | Azure services, deploy, identity, Key Vault |
+| `auth` | Authentication, authorization, tokens, claims |
+| `deploy` | Deployment, CI/CD, pipelines, containers |
+
+## Formato de Output
+
+Ao encontrar uma solução, apresente no seguinte formato:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔴 CRITICAL: {título do problema}
+
+📁 Arquivo: {caminho do arquivo com solução}
+📂 Seção: {seção específica}
+
+❌ Erro:
+   {padrão de erro que identifica o problema}
+
+💡 Causa:
+   {explicação da causa raiz}
+
+✅ Solução:
+   {código ou passos para resolver}
+
+📚 Ver completo: morph-spec read {arquivo}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Troubleshooting Rápido
+
+### Problemas Mais Comuns
+
+| Erro | Solução Rápida |
+|------|----------------|
+| `blazor.web.js 404` | `<RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>` |
+| `PendingModelChangesWarning` | `dotnet ef migrations add <Name>` antes de update |
+| `DbContext second operation` | Usar `IDbContextFactory` para background tasks |
+| `Include() vazio` | Usar `HasMany(x => x.Nav)` em vez de `HasMany<T>()` |
+| `Azure.Identity NU1605` | Especificar versão explícita no .csproj |
+| `Key Vault não carrega` | Não condicionar ao ambiente (IsDevelopment) |
+| `DefaultAzureCredential lento` | Desabilitar credenciais não usadas |
+
+---
+
+**Input:** $ARGUMENTS

package/stacks/nextjs-supabase/.morph/.morphversion

@@ -0,0 +1,5 @@
+{
+  "morphVersion": "4.3.1",
+  "installedAt": "2026-02-19T17:49:33.357Z",
+  "cliVersion": "4.3.1"
+}