@polymorphism-tech/morph-spec 2.2.0 → 2.4.0

package/content/.claude/commands/morph-infra.md

@@ -1,209 +1,209 @@
-# /morph-infra - Infrastructure Management
-
-Gerencia infraestrutura Azure usando Bicep templates.
-
-## Uso
-
-```
-/morph-infra [action] [options]
-```
-
-### Actions
-
-| Action | Descrição |
-|--------|-----------|
-| `init` | Inicializa estrutura IaC no projeto |
-| `validate` | Valida templates Bicep |
-| `plan` | Mostra what-if de mudanças |
-| `deploy` | Executa deploy dos recursos |
-| `destroy` | Remove todos os recursos |
-
----
-
-## Workflow
-
-### 1. INIT - Inicializar IaC
-
-Quando o usuário solicitar `/morph-infra init`:
-
-1. Criar estrutura `infra/` no projeto:
-   ```
-   infra/
-   ├── main.bicep
-   ├── parameters.dev.json
-   ├── parameters.prod.json
-   └── modules/
-       ├── container-app.bicep
-       ├── container-app-env.bicep
-       ├── sql-database.bicep
-       ├── storage.bicep
-       ├── key-vault.bicep
-       └── app-insights.bicep
-   ```
-
-2. Copiar templates de `.morph/templates/infra/`
-
-3. Substituir placeholders:
-   - `{{APP_NAME}}` → nome do projeto
-   - `{{SUBSCRIPTION_ID}}` → solicitar ao usuário
-   - `{{RESOURCE_GROUP}}` → sugerir padrão `rg-{app}-{env}`
-
-4. Documentar no `decisions.md` a estrutura criada
-
----
-
-### 2. VALIDATE - Validar Templates
-
-Quando o usuário solicitar `/morph-infra validate`:
-
-1. Executar validação Bicep:
-   ```bash
-   az bicep build --file infra/main.bicep
-   ```
-
-2. Verificar parâmetros necessários
-
-3. Reportar erros ou sucesso
-
----
-
-### 3. PLAN - Preview de Mudanças
-
-Quando o usuário solicitar `/morph-infra plan [env]`:
-
-1. Verificar se Azure CLI está autenticado:
-   ```bash
-   az account show
-   ```
-
-2. Executar what-if:
-   ```bash
-   az deployment group what-if \
-     --resource-group rg-{app}-{env} \
-     --template-file infra/main.bicep \
-     --parameters @infra/parameters.{env}.json
-   ```
-
-3. Apresentar resumo de mudanças:
-   - Recursos a criar
-   - Recursos a modificar
-   - Recursos a deletar
-   - Custos estimados
-
-4. ⛔ **PARE e aguarde aprovação** para deploy
-
----
-
-### 4. DEPLOY - Executar Deploy
-
-Quando o usuário solicitar `/morph-infra deploy [env]`:
-
-1. Verificar aprovação do plan
-
-2. Criar resource group se não existir:
-   ```bash
-   az group create --name rg-{app}-{env} --location brazilsouth
-   ```
-
-3. Executar deploy:
-   ```bash
-   az deployment group create \
-     --resource-group rg-{app}-{env} \
-     --template-file infra/main.bicep \
-     --parameters @infra/parameters.{env}.json
-   ```
-
-4. Capturar outputs:
-   - Container App URL
-   - SQL Connection String
-   - Key Vault URI
-
-5. Atualizar documentação com informações do deploy
-
----
-
-### 5. DESTROY - Remover Recursos
-
-Quando o usuário solicitar `/morph-infra destroy [env]`:
-
-1. ⚠️ **ALERTAR** que esta ação é irreversível
-
-2. Listar recursos que serão deletados
-
-3. ⛔ **PARE e aguarde confirmação explícita** ("sim, deletar")
-
-4. Executar:
-   ```bash
-   az group delete --name rg-{app}-{env} --yes --no-wait
-   ```
-
----
-
-## Regras de Segurança
-
-### NUNCA:
-- Expor secrets em logs
-- Commitar arquivos com secrets
-- Deletar recursos de produção sem confirmação explícita
-- Criar recursos fora do Bicep (zero portal)
-
-### SEMPRE:
-- Usar Key Vault para secrets
-- Validar Bicep antes de deploy
-- Executar what-if antes de deploy
-- Documentar custos estimados
-- Manter parameters.json separados por ambiente
-
----
-
-## Cost Guardian Integration
-
-Antes de qualquer deploy, verificar com Cost Guardian:
-
-1. Estimar custos mensais dos recursos
-2. Verificar se está dentro dos limites aprovados:
-   - Free tier: sem aprovação
-   - Até $10/mês: requer confirmação
-   - Acima de $10: requer ADR
-
----
-
-## Exemplo de Uso
-
-```
-Usuário: /morph-infra init
-Claude: Criando estrutura IaC...
-        - infra/main.bicep
-        - infra/parameters.dev.json
-        - infra/modules/*.bicep
-        Pronto! Execute /morph-infra validate para verificar.
-
-Usuário: /morph-infra plan dev
-Claude: Analisando mudanças para ambiente dev...
-
-        CRIAR:
-        + Container App Environment
-        + Container App
-        + SQL Server (Free)
-        + Storage Account (LRS)
-        + Key Vault
-        + Application Insights
-
-        CUSTO ESTIMADO: ~$0/mês (Free tier)
-
-        Aprovar deploy? (sim/não)
-
-Usuário: sim
-Claude: Executando deploy...
-        ✓ Resource Group criado
-        ✓ Deploy concluído em 3m 45s
-
-        OUTPUTS:
-        - URL: https://myapp-dev.azurecontainerapps.io
-        - SQL: tcp:myapp-dev-sql.database.windows.net
-        - Key Vault: https://myapp-dev-kv.vault.azure.net
-```
-
----
-
-*MORPH-SPEC by Polymorphism Tech*
+# /morph-infra - Infrastructure Management
+
+Gerencia infraestrutura Azure usando Bicep templates.
+
+## Uso
+
+```
+/morph-infra [action] [options]
+```
+
+### Actions
+
+| Action | Descrição |
+|--------|-----------|
+| `init` | Inicializa estrutura IaC no projeto |
+| `validate` | Valida templates Bicep |
+| `plan` | Mostra what-if de mudanças |
+| `deploy` | Executa deploy dos recursos |
+| `destroy` | Remove todos os recursos |
+
+---
+
+## Workflow
+
+### 1. INIT - Inicializar IaC
+
+Quando o usuário solicitar `/morph-infra init`:
+
+1. Criar estrutura `infra/` no projeto:
+   ```
+   infra/
+   ├── main.bicep
+   ├── parameters.dev.json
+   ├── parameters.prod.json
+   └── modules/
+       ├── container-app.bicep
+       ├── container-app-env.bicep
+       ├── sql-database.bicep
+       ├── storage.bicep
+       ├── key-vault.bicep
+       └── app-insights.bicep
+   ```
+
+2. Copiar templates de `.morph/templates/infra/`
+
+3. Substituir placeholders:
+   - `{{APP_NAME}}` → nome do projeto
+   - `{{SUBSCRIPTION_ID}}` → solicitar ao usuário
+   - `{{RESOURCE_GROUP}}` → sugerir padrão `rg-{app}-{env}`
+
+4. Documentar no `decisions.md` a estrutura criada
+
+---
+
+### 2. VALIDATE - Validar Templates
+
+Quando o usuário solicitar `/morph-infra validate`:
+
+1. Executar validação Bicep:
+   ```bash
+   az bicep build --file infra/main.bicep
+   ```
+
+2. Verificar parâmetros necessários
+
+3. Reportar erros ou sucesso
+
+---
+
+### 3. PLAN - Preview de Mudanças
+
+Quando o usuário solicitar `/morph-infra plan [env]`:
+
+1. Verificar se Azure CLI está autenticado:
+   ```bash
+   az account show
+   ```
+
+2. Executar what-if:
+   ```bash
+   az deployment group what-if \
+     --resource-group rg-{app}-{env} \
+     --template-file infra/main.bicep \
+     --parameters @infra/parameters.{env}.json
+   ```
+
+3. Apresentar resumo de mudanças:
+   - Recursos a criar
+   - Recursos a modificar
+   - Recursos a deletar
+   - Custos estimados
+
+4. ⛔ **PARE e aguarde aprovação** para deploy
+
+---
+
+### 4. DEPLOY - Executar Deploy
+
+Quando o usuário solicitar `/morph-infra deploy [env]`:
+
+1. Verificar aprovação do plan
+
+2. Criar resource group se não existir:
+   ```bash
+   az group create --name rg-{app}-{env} --location brazilsouth
+   ```
+
+3. Executar deploy:
+   ```bash
+   az deployment group create \
+     --resource-group rg-{app}-{env} \
+     --template-file infra/main.bicep \
+     --parameters @infra/parameters.{env}.json
+   ```
+
+4. Capturar outputs:
+   - Container App URL
+   - SQL Connection String
+   - Key Vault URI
+
+5. Atualizar documentação com informações do deploy
+
+---
+
+### 5. DESTROY - Remover Recursos
+
+Quando o usuário solicitar `/morph-infra destroy [env]`:
+
+1. ⚠️ **ALERTAR** que esta ação é irreversível
+
+2. Listar recursos que serão deletados
+
+3. ⛔ **PARE e aguarde confirmação explícita** ("sim, deletar")
+
+4. Executar:
+   ```bash
+   az group delete --name rg-{app}-{env} --yes --no-wait
+   ```
+
+---
+
+## Regras de Segurança
+
+### NUNCA:
+- Expor secrets em logs
+- Commitar arquivos com secrets
+- Deletar recursos de produção sem confirmação explícita
+- Criar recursos fora do Bicep (zero portal)
+
+### SEMPRE:
+- Usar Key Vault para secrets
+- Validar Bicep antes de deploy
+- Executar what-if antes de deploy
+- Documentar custos estimados
+- Manter parameters.json separados por ambiente
+
+---
+
+## Cost Guardian Integration
+
+Antes de qualquer deploy, verificar com Cost Guardian:
+
+1. Estimar custos mensais dos recursos
+2. Verificar se está dentro dos limites aprovados:
+   - Free tier: sem aprovação
+   - Até $10/mês: requer confirmação
+   - Acima de $10: requer ADR
+
+---
+
+## Exemplo de Uso
+
+```
+Usuário: /morph-infra init
+Claude: Criando estrutura IaC...
+        - infra/main.bicep
+        - infra/parameters.dev.json
+        - infra/modules/*.bicep
+        Pronto! Execute /morph-infra validate para verificar.
+
+Usuário: /morph-infra plan dev
+Claude: Analisando mudanças para ambiente dev...
+
+        CRIAR:
+        + Container App Environment
+        + Container App
+        + SQL Server (Free)
+        + Storage Account (LRS)
+        + Key Vault
+        + Application Insights
+
+        CUSTO ESTIMADO: ~$0/mês (Free tier)
+
+        Aprovar deploy? (sim/não)
+
+Usuário: sim
+Claude: Executando deploy...
+        ✓ Resource Group criado
+        ✓ Deploy concluído em 3m 45s
+
+        OUTPUTS:
+        - URL: https://myapp-dev.azurecontainerapps.io
+        - SQL: tcp:myapp-dev-sql.database.windows.net
+        - Key Vault: https://myapp-dev-kv.vault.azure.net
+```
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/content/.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*