npm - @polymorphism-tech/morph-spec - Versions diffs - 4.3.3 → 4.3.4 - Mend

@polymorphism-tech/morph-spec 4.3.3 → 4.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (401) hide show

package/stacks/nextjs-supabase/.claude/commands/morph-archive.md DELETED Viewed

@@ -1,79 +0,0 @@
-# Archive MORPH Feature
-Arquive uma feature concluída, movendo-a de `project/outputs/` para `project/archive/`.
-## Pré-requisitos
-Verifique antes de arquivar:
-- [ ] Feature existe em `.morph/project/outputs/{feature}/`
-- [ ] Todas as tasks estão completas
-- [ ] `recap.md` está preenchido
-- [ ] Código está em produção (ou staging)
-## Workflow
-1. **Valide a conclusão**:
-   - Leia `.morph/project/outputs/{feature}/tasks.json`
-   - Verifique que todas tasks estão completadas
-   - Confirme com o usuário se pode arquivar
-2. **Complete o recap**:
-   - Atualize `.morph/project/outputs/{feature}/recap.md`
-   - Preencha métricas finais
-   - Documente lições aprendidas
-3. **Extraia specs**:
-   - Se a feature define comportamento permanente
-   - Copie spec relevante para `.morph/project/specs/`
-   - Isso vira a "verdade atual" do sistema
-4. **Mova para archive**:
-   ```
-   .morph/project/outputs/{feature}/  →  .morph/project/archive/{feature}/
-   ```
-5. **Atualize métricas do projeto**:
-   - Incremente contador de features
-   - Atualize custo total
-   - Atualize tempo total
-## Output
-Apresente resumo do arquivamento:
-```
-╔════════════════════════════════════════════╗
-║         FEATURE ARCHIVED                   ║
-╠════════════════════════════════════════════╣
-║ Feature: {name}                            ║
-║ Completed: {date}                          ║
-╠════════════════════════════════════════════╣
-║ METRICS                                    ║
-╠════════════════════════════════════════════╣
-║ Tasks: {X}/{X} completed                   ║
-║ Time: {X}h (estimated: {Y}h)               ║
-║ Cost Impact: +${X}/month                   ║
-╠════════════════════════════════════════════╣
-║ FILES                                      ║
-╠════════════════════════════════════════════╣
-║ Created: {X} files                         ║
-║ Modified: {Y} files                        ║
-║ Tests: {Z} files ({W}% coverage)           ║
-╠════════════════════════════════════════════╣
-║ ARCHIVED TO                                ║
-╠════════════════════════════════════════════╣
-║ .morph/project/archive/{feature}/          ║
-╚════════════════════════════════════════════╝
-```
-## Specs Extraídas
-Se houver specs extraídas:
-```
-Specs extracted to .morph/project/specs/:
-- {domain}/spec.md - {description}
-```
----
-**Feature to archive:** $ARGUMENTS

package/stacks/nextjs-supabase/.claude/commands/morph-deploy.md DELETED Viewed

@@ -1,529 +0,0 @@
-# /morph-deploy - Azure Deployment Orchestrator
-Orquestra deploy completo para Azure Container Apps seguindo playbook rigoroso baseado em licoes aprendidas.
-## Uso
-```
-/morph-deploy [environment] [options]
-```
-### Environments
-| Environment | Descricao | Aprovacao |
-|-------------|-----------|-----------|
-| `dev` | Ambiente de desenvolvimento | Automatica se custo < $10/mes |
-| `staging` | Ambiente de homologacao | Requer revisao de custos |
-| `prod` | Ambiente de producao | Requer aprovacao explicita |
-### Options
-| Option | Descricao |
-|--------|-----------|
-| `--auto` | Modo automatico para CI/CD (sem pausas interativas) |
-| `--skip-build` | Pular build Docker (usar imagem existente) |
-| `--infra-only` | Apenas deploy de infra (Bicep) |
-| `--app-only` | Apenas deploy de app (requer infra existente) |
-| `--dry-run` | Validar sem executar deploy |
-| `--rollback` | Fazer rollback para revisao anterior |
----
-## Workflow Completo
-### FASE 0: ATIVAR AGENTE
-1. Detectar e ativar `azure-deploy-specialist`:
-   ```bash
-   npx morph-spec detect "deploy to {environment}"
-   ```
-2. Carregar skill de `.claude/skills/infra/azure-deploy-specialist.md`
-3. Confirmar ambiente de deploy:
-   ```markdown
-   Ambiente detectado: {environment}
-   Correto? (sim/nao)
-   ```
----
-### FASE 1: VALIDAR PRE-REQUISITOS
-Executar verificacoes silenciosamente:
-```bash
-# Azure CLI
-az --version
-# Login status
-az account show
-# Docker
-docker info
-# .NET
-dotnet --version
-# dotnet-ef
-dotnet tool list --global | findstr "dotnet-ef"
-# Projeto compila
-dotnet build
-```
-**Se algum check falhar:**
-```markdown
-## Pre-requisitos Faltando
-- Azure CLI: https://aka.ms/installazurecliwindows
-- Docker: Iniciar Docker Desktop
-- dotnet-ef: `dotnet tool install --global dotnet-ef`
-Resolver e tentar novamente.
-```
-**Confirmar subscription:**
-```markdown
-Subscription detectada: {name} ({id})
-Esta correto? (sim/nao)
-Se nao, executar: `az login --tenant <TENANT-ID>`
-```
----
-### FASE 2: DETECTAR CONFIGURACAO
-1. Localizar arquivos de configuracao:
-   ```bash
-   # Encontrar appsettings
-   Get-ChildItem -Recurse -Filter "appsettings*.json"
-   # Encontrar Program.cs
-   Get-ChildItem -Recurse -Filter "Program.cs"
-   ```
-2. Parsear e apresentar mapeamento:
-   ```markdown
-   ## Configuracao Detectada
-   ### Connection Strings
-   | Config Path | Env Var | Tipo |
-   |-------------|---------|------|
-   | ConnectionStrings:DefaultConnection | CONNECTIONSTRINGS__DEFAULTCONNECTION | Secret |
-   | ConnectionStrings:HangfireConnection | CONNECTIONSTRINGS__HANGFIRECONNECTION | Secret |
-   ### Azure Services
-   | Config Path | Env Var | Tipo |
-   |-------------|---------|------|
-   | Azure:Storage:ConnectionString | AZURE__STORAGE__CONNECTIONSTRING | Secret |
-   | ApplicationInsights:ConnectionString | APPLICATIONINSIGHTS__CONNECTIONSTRING | Secret |
-   ### Blazor Server Detectado
-   **SIM** - Sticky sessions OBRIGATORIAS
-   ### Autenticacao Detectada
-   Azure AD - Requer TenantId, ClientId, ClientSecret
-   ```
----
-### FASE 3: COLETAR INFORMACOES SENSIVEIS
-**PAUSA OBRIGATORIA:**
-```markdown
----
-## INFORMACOES SENSIVEIS NECESSARIAS
-Por favor, forneca os valores abaixo:
-### 1. SQL Admin Password (obrigatorio)
-**Recomendacao:** Alfanumerico, 16+ chars, SEM caracteres especiais (@!#$)
-**Exemplo valido:** `FishArt2025SecurePwd`
->
-### 2. Azure Tenant ID (se auth detectado)
-**Onde encontrar:** Azure Portal > Azure AD > Properties > Tenant ID
->
-### 3. Azure Client Secret (se auth detectado)
-**Onde encontrar:** Azure Portal > App Registrations > {App} > Certificates & secrets
->
-### 4. Storage Account Key (se storage detectado)
-**Onde encontrar:** Azure Portal > Storage Account > Access keys
->
----
-```
-**Validar senha:**
-- Se conter @, !, #, $, %, ^, &, * → ALERTAR:
-  ```markdown
-  ATENCAO: Senha contem caracteres especiais que podem causar problemas de escape.
-  Recomendamos usar apenas letras e numeros.
-  Continuar mesmo assim? (sim/nao)
-  ```
----
-### FASE 4: VALIDAR CUSTOS
-1. Verificar se existem templates Bicep:
-   ```bash
-   Test-Path "infra/main.bicep"
-   ```
-   **Se NAO existir:**
-   ```markdown
-   ## Templates Bicep nao encontrados
-   O projeto nao possui arquivos de infraestrutura em `infra/`.
-   Opcoes:
-   1. **Criar agora** - Gerar templates baseado no projeto detectado
-   2. **Usar /morph-infra init** - Rodar comando de setup de infra primeiro
-   3. **Cancelar** - Abortar deploy
-   Qual opcao voce prefere?
-   ```
-2. Calcular custos:
-   ```bash
-   npx morph-spec cost infra/main.bicep --verbose
-   ```
-3. Validar contra limites:
-   - Free tier ($0): Automatico
-   - Com aprovacao ($10): Requer confirmacao
-   - Requer ADR (>$10): Documentar em decisions.md
----
-### FASE 5: DEPLOY DE INFRAESTRUTURA
-1. Criar Resource Group:
-   ```bash
-   az group create --name rg-{project}-{env} --location brazilsouth
-   ```
-2. Executar what-if:
-   ```bash
-   az deployment group what-if \
-     --resource-group rg-{project}-{env} \
-     --template-file infra/main.bicep \
-     --parameters @infra/parameters.{env}.json
-   ```
-   **PAUSA OBRIGATORIA:**
-   ```markdown
-   ## Recursos a serem criados/modificados
-   [Output do what-if]
-   ### Resumo:
-   - Criar: X recursos
-   - Modificar: Y recursos
-   - Deletar: Z recursos
-   ### Custo estimado: $X.XX/mes
-   Deseja prosseguir com o deploy? (sim/nao)
-   ```
-3. Executar deploy:
-   ```bash
-   az deployment group create \
-     --resource-group rg-{project}-{env} \
-     --template-file infra/main.bicep \
-     --parameters @infra/parameters.{env}.json \
-     --name "deploy-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
-   ```
-4. Capturar outputs para proximas fases
----
-### FASE 6: DEPLOY DE APLICACAO
-1. Build Docker:
-   ```bash
-   docker build -t {acr}.azurecr.io/{project}:{tag} .
-   ```
-2. Push para ACR:
-   ```bash
-   az acr update --name {acr} --admin-enabled true
-   az acr login --name {acr}
-   docker push {acr}.azurecr.io/{project}:{tag}
-   ```
-3. Criar/Atualizar Container App:
-   ```bash
-   $acrPassword = az acr credential show --name {acr} --query "passwords[0].value" -o tsv
-   az containerapp create \
-     --name {project}-{env}-app \
-     --resource-group rg-{project}-{env} \
-     --environment {project}-{env}-app-env \
-     --image {acr}.azurecr.io/{project}:{tag} \
-     --registry-server {acr}.azurecr.io \
-     --registry-username {acr} \
-     --registry-password $acrPassword \
-     --target-port 8080 \
-     --ingress external \
-     --min-replicas 1 \
-     --max-replicas 3 \
-     --cpu 0.25 \
-     --memory 0.5Gi
-   ```
-4. Configurar Environment Variables:
-   ```bash
-   az containerapp update \
-     --name {project}-{env}-app \
-     --resource-group rg-{project}-{env} \
-     --set-env-vars \
-       "ConnectionStrings__DefaultConnection={sql-connection}" \
-       "Azure__Storage__ConnectionString={storage-connection}" \
-       "ASPNETCORE_ENVIRONMENT=Production"
-   ```
-5. **Se Blazor Server detectado**, habilitar sticky sessions:
-   ```bash
-   az containerapp ingress sticky-sessions set \
-     --name {project}-{env}-app \
-     --resource-group rg-{project}-{env} \
-     --affinity sticky
-   ```
-6. Configurar SQL Firewall:
-   ```bash
-   az sql server firewall-rule create \
-     --resource-group rg-{project}-{env} \
-     --server {sql-server} \
-     --name AllowAzureServices \
-     --start-ip-address 0.0.0.0 \
-     --end-ip-address 0.0.0.0
-   ```
-7. Executar Migrations:
-   ```bash
-   ~/.dotnet/tools/dotnet-ef database update \
-     --project src/{project}.Infrastructure \
-     --startup-project src/{project}.Web.Blazor \
-     --connection "{sql-connection-string}"
-   ```
----
-### FASE 7: VERIFICACAO
-1. Verificar health:
-   ```bash
-   az containerapp revision list \
-     --name {project}-{env}-app \
-     --resource-group rg-{project}-{env} \
-     --query "[0].properties.healthState" -o tsv
-   ```
-2. Obter URL:
-   ```bash
-   az containerapp show \
-     --name {project}-{env}-app \
-     --resource-group rg-{project}-{env} \
-     --query properties.configuration.ingress.fqdn -o tsv
-   ```
-3. Testar HTTPS
-4. **PAUSA OBRIGATORIA:**
-   ```markdown
-   ## Verificacao Final
-   URL: https://{app-url}
-   - [ ] Container App rodando (Healthy)
-   - [ ] Health check passando (HTTP 200)
-   - [ ] HTTPS acessivel
-   - [ ] Database conectado
-   - [ ] Blazor circuit estabelecido (se aplicavel)
-   Todos os checks passaram? (sim/nao)
-   ```
-5. **Se falhar**, executar rollback automatico:
-   ```bash
-   # Listar revisoes
-   $revisions = az containerapp revision list \
-     --name {project}-{env}-app \
-     --resource-group rg-{project}-{env} \
-     --query "[].name" -o tsv
-   # Ativar revisao anterior
-   az containerapp revision activate \
-     --name {project}-{env}-app \
-     --resource-group rg-{project}-{env} \
-     --revision $revisions[1]
-   ```
----
-## Modo --auto para CI/CD
-Para uso em pipelines Azure DevOps:
-```bash
-npx morph-spec deploy prod --auto \
-  --sql-password "$(SQL_PASSWORD)" \
-  --tenant-id "$(TENANT_ID)" \
-  --client-secret "$(CLIENT_SECRET)" \
-  --skip-confirmation
-```
-### Pipeline Template
-```yaml
-trigger:
-  - main
-variables:
-  - group: 'deploy-secrets'
-stages:
-  - stage: Deploy
-    jobs:
-      - deployment: DeployToAzure
-        environment: 'production'
-        strategy:
-          runOnce:
-            deploy:
-              steps:
-                - script: |
-                    npx morph-spec deploy prod --auto \
-                      --sql-password "$(SqlPassword)" \
-                      --skip-confirmation
-                  displayName: 'Deploy to Production'
-```
----
-## Rollback Manual
-```bash
-/morph-deploy --rollback
-# Ou via CLI:
-npx morph-spec deploy --rollback
-```
-Lista revisoes disponiveis e permite selecionar qual ativar.
----
-## Troubleshooting Rapido
-| Erro | Solucao |
-|------|---------|
-| `winget not recognized` | https://aka.ms/installazurecliwindows |
-| `MFA/tenant erro` | `az login --tenant <TENANT-ID>` |
-| `Login failed for user` | Usar senha alfanumerica simples |
-| `CircuitDisconnected` | Verificar sticky sessions |
-| `ContainerCreating` stuck | Verificar push da imagem |
-| `dotnet-ef not found` | `~/.dotnet/tools/dotnet-ef` |
----
-## Exemplo de Uso
-```
-Usuario: /morph-deploy staging
-Claude: Iniciando Azure Deploy workflow para STAGING...
-## Fase 1: Pre-requisitos
-- az version: 2.53.0
-- Logged in as: user@company.com
-- Subscription: MySubscription (abc-123-def)
-Correto? (sim/nao)
-Usuario: sim
-Claude: ## Fase 2: Configuracao Detectada
-### Connection Strings
-- DefaultConnection: SQL Server
-- HangfireConnection: Hangfire
-### Blazor Server Detectado
-**SIM** - Sticky sessions serao habilitadas automaticamente
-## Fase 3: Informacoes Sensiveis
-SQL Admin Password:
->
-Usuario: FishArt2025SecurePwd
-Claude: ## Fase 4: Validacao de Custos
-Custo estimado: $4.99/mes (Azure SQL Basic)
-Aprovar? (sim/nao)
-Usuario: sim
-Claude: ## Fase 5: Deploy de Infra
-Executando what-if...
-[Output do what-if]
-Confirmar deploy? (sim/nao)
-Usuario: sim
-Claude: Executando deploy...
-- Resource Group criado
-- SQL Server provisionado
-- Container App Environment criado
-- ACR criado
-## Fase 6: Deploy de App
-- Docker build concluido
-- Push para ACR concluido
-- Container App atualizado
-- Sticky sessions habilitadas
-- SQL Firewall configurado
-- Migrations executadas
-## Fase 7: Verificacao
-URL: https://myapp-staging.azurecontainerapps.io
-- Container App: Healthy
-- HTTPS: OK (200)
-- Database: Conectado
-- Blazor circuit: Estabelecido
-Deploy concluido com sucesso!
-```
----
-## State Management
-Apos deploy bem-sucedido:
-```bash
-npx morph-spec state set {feature} phase deployed
-npx morph-spec state checkpoint {feature} "Deployed to {env} at {timestamp}"
-```
----
-*MORPH-SPEC by Polymorphism Tech*