@polymorphism-tech/morph-spec 3.2.0 → 4.2.0

package/stacks/blazor-azure/.azure/pipelines/templates/deploy-app-service.yml

@@ -1,94 +0,0 @@
-# ==============================================================================
-# MORPH-SPEC - Deploy App Service Template
-# Reusable template for deploying to Azure App Service
-# ==============================================================================
-
-parameters:
-  - name: azureSubscription
-    type: string
-  - name: appServiceName
-    type: string
-  - name: resourceGroupName
-    type: string
-  - name: slotName
-    type: string
-    default: ''
-  - name: package
-    type: string
-    default: '$(Pipeline.Workspace)/drop/**/*.zip'
-  - name: healthCheckUrl
-    type: string
-    default: '/health'
-  - name: healthCheckTimeout
-    type: number
-    default: 300
-
-steps:
-  - task: AzureWebApp@1
-    displayName: 'Deploy to App Service'
-    inputs:
-      azureSubscription: '${{ parameters.azureSubscription }}'
-      appType: 'webAppLinux'
-      appName: '${{ parameters.appServiceName }}'
-      ${{ if ne(parameters.slotName, '') }}:
-        deployToSlotOrASE: true
-        resourceGroupName: '${{ parameters.resourceGroupName }}'
-        slotName: '${{ parameters.slotName }}'
-      package: '${{ parameters.package }}'
-      runtimeStack: 'DOTNETCORE|8.0'
-
-  - task: AzureAppServiceSettings@1
-    displayName: 'Configure App Settings'
-    inputs:
-      azureSubscription: '${{ parameters.azureSubscription }}'
-      appName: '${{ parameters.appServiceName }}'
-      ${{ if ne(parameters.slotName, '') }}:
-        resourceGroupName: '${{ parameters.resourceGroupName }}'
-        slotName: '${{ parameters.slotName }}'
-      appSettings: |
-        [
-          {
-            "name": "ASPNETCORE_ENVIRONMENT",
-            "value": "Production",
-            "slotSetting": false
-          },
-          {
-            "name": "WEBSITE_TIME_ZONE",
-            "value": "E. South America Standard Time",
-            "slotSetting": false
-          }
-        ]
-
-  - task: PowerShell@2
-    displayName: 'Health check'
-    inputs:
-      targetType: 'inline'
-      script: |
-        $appUrl = "https://${{ parameters.appServiceName }}.azurewebsites.net"
-        $healthUrl = "$appUrl${{ parameters.healthCheckUrl }}"
-        $timeout = ${{ parameters.healthCheckTimeout }}
-        $elapsed = 0
-        $interval = 10
-
-        Write-Host "Waiting for app to be healthy at: $healthUrl"
-        Write-Host "Timeout: $timeout seconds"
-
-        while ($elapsed -lt $timeout) {
-          try {
-            $response = Invoke-WebRequest -Uri $healthUrl -UseBasicParsing -TimeoutSec 5
-            if ($response.StatusCode -eq 200) {
-              Write-Host "✅ App is healthy!"
-              Write-Host "Response: $($response.Content)"
-              exit 0
-            }
-          }
-          catch {
-            Write-Host "⏳ Waiting... ($elapsed/$timeout seconds)"
-          }
-
-          Start-Sleep -Seconds $interval
-          $elapsed += $interval
-        }
-
-        Write-Error "❌ Health check failed after $timeout seconds"
-        exit 1

package/stacks/blazor-azure/.azure/pipelines/templates/deploy-container-app.yml

@@ -1,120 +0,0 @@
-# ==============================================================================
-# MORPH-SPEC - Deploy Container App Template
-# Reusable template for deploying to Azure Container Apps
-# ==============================================================================
-
-parameters:
-  - name: azureSubscription
-    type: string
-  - name: containerAppName
-    type: string
-  - name: resourceGroupName
-    type: string
-  - name: containerRegistry
-    type: string
-  - name: imageName
-    type: string
-  - name: imageTag
-    type: string
-  - name: acrServiceConnection
-    type: string
-  - name: healthCheckUrl
-    type: string
-    default: '/health'
-  - name: healthCheckTimeout
-    type: number
-    default: 300
-
-steps:
-  - task: Docker@2
-    displayName: 'Build and push container image'
-    inputs:
-      containerRegistry: '${{ parameters.acrServiceConnection }}'
-      repository: '${{ parameters.imageName }}'
-      command: 'buildAndPush'
-      Dockerfile: '$(dockerfilePath)'
-      tags: |
-        ${{ parameters.imageTag }}
-        latest
-
-  - task: AzureCLI@2
-    displayName: 'Update Container App'
-    inputs:
-      azureSubscription: '${{ parameters.azureSubscription }}'
-      scriptType: 'bash'
-      scriptLocation: 'inlineScript'
-      inlineScript: |
-        echo "Updating Container App: ${{ parameters.containerAppName }}"
-        echo "Image: ${{ parameters.containerRegistry }}/${{ parameters.imageName }}:${{ parameters.imageTag }}"
-
-        az containerapp update \
-          --name ${{ parameters.containerAppName }} \
-          --resource-group ${{ parameters.resourceGroupName }} \
-          --image ${{ parameters.containerRegistry }}/${{ parameters.imageName }}:${{ parameters.imageTag }} \
-          --output table
-
-        echo "✅ Container App updated successfully"
-
-  - task: AzureCLI@2
-    displayName: 'Get Container App FQDN'
-    name: getUrl
-    inputs:
-      azureSubscription: '${{ parameters.azureSubscription }}'
-      scriptType: 'bash'
-      scriptLocation: 'inlineScript'
-      inlineScript: |
-        FQDN=$(az containerapp show \
-          --name ${{ parameters.containerAppName }} \
-          --resource-group ${{ parameters.resourceGroupName }} \
-          --query properties.configuration.ingress.fqdn -o tsv)
-
-        echo "Container App URL: https://$FQDN"
-        echo "##vso[task.setvariable variable=containerAppUrl;isOutput=true]https://$FQDN"
-
-  - task: PowerShell@2
-    displayName: 'Health check'
-    inputs:
-      targetType: 'inline'
-      script: |
-        $appUrl = "$(getUrl.containerAppUrl)"
-        $healthUrl = "$appUrl${{ parameters.healthCheckUrl }}"
-        $timeout = ${{ parameters.healthCheckTimeout }}
-        $elapsed = 0
-        $interval = 10
-
-        Write-Host "Waiting for Container App to be healthy at: $healthUrl"
-        Write-Host "Timeout: $timeout seconds"
-
-        while ($elapsed -lt $timeout) {
-          try {
-            $response = Invoke-WebRequest -Uri $healthUrl -UseBasicParsing -TimeoutSec 5
-            if ($response.StatusCode -eq 200) {
-              Write-Host "✅ Container App is healthy!"
-              Write-Host "Response: $($response.Content)"
-              exit 0
-            }
-          }
-          catch {
-            Write-Host "⏳ Waiting... ($elapsed/$timeout seconds)"
-          }
-
-          Start-Sleep -Seconds $interval
-          $elapsed += $interval
-        }
-
-        Write-Error "❌ Health check failed after $timeout seconds"
-        exit 1
-
-  - task: AzureCLI@2
-    displayName: 'Show Container App revision'
-    inputs:
-      azureSubscription: '${{ parameters.azureSubscription }}'
-      scriptType: 'bash'
-      scriptLocation: 'inlineScript'
-      inlineScript: |
-        echo "📊 Active revisions:"
-        az containerapp revision list \
-          --name ${{ parameters.containerAppName }} \
-          --resource-group ${{ parameters.resourceGroupName }} \
-          --query "[?properties.active].{Name:name, Created:properties.createdTime, Replicas:properties.replicas, Traffic:properties.trafficWeight}" \
-          --output table

package/stacks/blazor-azure/.azure/pipelines/templates/infra-deploy.yml

@@ -1,90 +0,0 @@
-# ==============================================================================
-# MORPH-SPEC - Infrastructure Deploy Template
-# Reusable template for deploying Azure infrastructure via Bicep
-# ==============================================================================
-
-parameters:
-  - name: azureSubscription
-    type: string
-  - name: resourceGroupName
-    type: string
-  - name: location
-    type: string
-  - name: environment
-    type: string
-  - name: appName
-    type: string
-  - name: hostingType
-    type: string
-  - name: bicepTemplateFile
-    type: string
-  - name: parametersFile
-    type: string
-
-steps:
-  - task: AzureCLI@2
-    displayName: 'Create resource group if not exists'
-    inputs:
-      azureSubscription: '${{ parameters.azureSubscription }}'
-      scriptType: 'bash'
-      scriptLocation: 'inlineScript'
-      inlineScript: |
-        az group create \
-          --name ${{ parameters.resourceGroupName }} \
-          --location ${{ parameters.location }} \
-          --tags \
-            environment=${{ parameters.environment }} \
-            application=${{ parameters.appName }} \
-            managedBy=bicep \
-            framework=morph-spec
-
-  - task: AzureResourceManagerTemplateDeployment@3
-    displayName: 'Deploy Bicep template'
-    name: infraDeploy
-    inputs:
-      deploymentScope: 'Resource Group'
-      azureResourceManagerConnection: '${{ parameters.azureSubscription }}'
-      subscriptionId: '$(SUBSCRIPTION_ID)'
-      action: 'Create Or Update Resource Group'
-      resourceGroupName: '${{ parameters.resourceGroupName }}'
-      location: '${{ parameters.location }}'
-      templateLocation: 'Linked artifact'
-      csmFile: '${{ parameters.bicepTemplateFile }}'
-      csmParametersFile: '${{ parameters.parametersFile }}'
-      overrideParameters: |
-        -appName ${{ parameters.appName }}
-        -environment ${{ parameters.environment }}
-        -location ${{ parameters.location }}
-        -hostingType ${{ parameters.hostingType }}
-      deploymentMode: 'Incremental'
-      deploymentOutputs: 'infraOutputs'
-
-  - task: PowerShell@2
-    displayName: 'Parse deployment outputs'
-    inputs:
-      targetType: 'inline'
-      script: |
-        $outputs = '$(infraOutputs)' | ConvertFrom-Json
-
-        Write-Host "📊 Deployment Outputs:"
-        $outputs.PSObject.Properties | ForEach-Object {
-          $name = $_.Name
-          $value = $_.Value.value
-          Write-Host "  $name = $value"
-
-          # Set as pipeline variables
-          Write-Host "##vso[task.setvariable variable=$name;isOutput=true]$value"
-        }
-
-  - task: AzureCLI@2
-    displayName: 'Show deployed resources'
-    inputs:
-      azureSubscription: '${{ parameters.azureSubscription }}'
-      scriptType: 'bash'
-      scriptLocation: 'inlineScript'
-      inlineScript: |
-        echo "📦 Resources in ${{ parameters.resourceGroupName }}:"
-        az resource list \
-          --resource-group ${{ parameters.resourceGroupName }} \
-          --query "[].{Name:name, Type:type, Location:location}" \
-          --output table

package/stacks/blazor-azure/.claude/settings.local.json

@@ -1,15 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(dotnet:*)",
-      "Bash(git:*)",
-      "Read",
-      "Write",
-      "Edit",
-      "Glob",
-      "Grep"
-    ],
-    "deny": []
-  },
-  "model": "claude-sonnet-4-20250514"
-}

package/stacks/blazor-azure/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md

@@ -1,392 +0,0 @@
-# Story-Driven Development - Guia do Usuário
-
-> **O que você faz quando implementa uma feature usando MORPH-SPEC**
-
----
-
-## 📋 Você Está Aqui
-
-Você acabou de terminar as fases 0-4 do MORPH:
-- ✅ Criou `spec.md` (especificação técnica)
-- ✅ Criou `contracts.cs` (interfaces/DTOs)
-- ✅ Criou `tasks.json` (lista de tasks)
-- ✅ Aprovou tudo
-
-**Agora você vai implementar. Este guia mostra como.**
-
----
-
-## 🚀 Passo a Passo Completo
-
-### Cenário: Feature "scheduled-reports" com 10 tasks
-
-```bash
-# ============================================================================
-# ETAPA 1: PREPARAÇÃO (1x por feature)
-# ============================================================================
-
-# 1.1 - Dividir spec.md em partes menores (opcional, mas recomendado)
-morph-spec story shard scheduled-reports
-
-# Isso cria:
-# .morph/project/outputs/scheduled-reports/spec/
-# ├── index.md
-# ├── entity-design.md
-# ├── service-layer.md
-# └── ui-components.md
-
-# 1.2 - Criar primeira story
-morph-spec story create scheduled-reports SR-001 \
-  --title "Create ScheduledReport entity" \
-  --tasks "Create entity,Configure EF mapping,Create migration,Write tests"
-
-# Isso cria:
-# .morph/project/outputs/scheduled-reports/stories/SR-001.md
-# (arquivo com TODO o contexto que você precisa)
-
-# 1.3 - Criar demais stories
-morph-spec story create scheduled-reports SR-002 \
-  --title "Implement ReportService" \
-  --tasks "Create interface,Implement service,Add DI,Write tests"
-
-morph-spec story create scheduled-reports SR-003 \
-  --title "Create report UI component" \
-  --tasks "Create razor component,Add to router,Style with Fluent UI"
-
-# ... criar SR-004, SR-005, etc.
-
-# 1.4 - Ver todas as stories criadas
-morph-spec story status scheduled-reports show
-
-# Output:
-# 📊 Sprint Status: scheduled-reports
-# Progress: 0% (0/10 stories done)
-# Stories:
-#   ✅ SR-001: Create ScheduledReport entity (ready)
-#   ✅ SR-002: Implement ReportService (ready)
-#   ✅ SR-003: Create report UI component (ready)
-#   ...
-
-
-# ============================================================================
-# ETAPA 2: IMPLEMENTAR STORY SR-001 (repetir para cada story)
-# ============================================================================
-
-# 2.1 - Marcar que você vai começar a trabalhar nela
-morph-spec story status scheduled-reports start SR-001
-
-# 2.2 - Abrir a story
-cat .morph/project/outputs/scheduled-reports/stories/SR-001.md
-
-# Você vai ver:
-# - Context (resumo do que fazer)
-# - Dev Notes (dicas automáticas tipo "use Primary Constructor")
-# - Tasks (lista de tarefas)
-# - Acceptance Criteria (como validar se tá certo)
-
-# 2.3 - Ler SÓ a parte relevante do spec (não o spec inteiro)
-cat .morph/project/outputs/scheduled-reports/spec/entity-design.md
-
-# 2.4 - Implementar o código
-# (você vai escrever o código da entity, testes, etc.)
-
-# 2.5 - Editar a story para adicionar suas notas
-nano .morph/project/outputs/scheduled-reports/stories/SR-001.md
-
-# Procurar a seção "### Dev Notes (Added by Dev Agent)"
-# Adicionar algo tipo:
-### Dev Notes (Added by Dev Agent)
-```
-✅ Implementado ScheduledReport.cs (linha 12)
-✅ EF mapping em ReportDbContext.cs (linha 45)
-✅ Migration: 20251209_AddScheduledReports.cs
-✅ Testes: ScheduledReportTests.cs (12 tests)
-⚠️  RecurrencePattern usa regex complexo
-```
-
-# 2.6 - Marcar que terminou e está pronto para revisar
-morph-spec story status scheduled-reports qa SR-001
-
-# 2.7 - Commitar código
-git add .
-git commit -m "feat(SR-001): create ScheduledReport entity"
-
-
-# ============================================================================
-# ETAPA 3: REVISAR STORY SR-001 (QA)
-# ============================================================================
-
-# 3.1 - Ver status
-morph-spec story status scheduled-reports show
-
-# Output:
-# 👀 SR-001: Create ScheduledReport entity (ready_for_qa)
-
-# 3.2 - Abrir a story (agora com as notas do Dev)
-cat .morph/project/outputs/scheduled-reports/stories/SR-001.md
-
-# Você vai ver as Dev Notes que foram adicionadas:
-# "✅ Implementado ScheduledReport.cs (linha 12)"
-# "⚠️ RecurrencePattern usa regex complexo"
-
-# 3.3 - Revisar o código
-cat src/Domain/Entities/ScheduledReport.cs
-cat tests/Unit/ScheduledReportTests.cs
-
-# 3.4 - Se precisar refatorar, refatore
-
-# 3.5 - Editar a story para adicionar notas de revisão
-nano .morph/project/outputs/scheduled-reports/stories/SR-001.md
-
-# Procurar a seção "### QA Notes (Added by QA Agent)"
-# Adicionar algo tipo:
-### QA Notes (Added by QA Agent)
-```
-✅ Código OK, segue padrões
-✅ Refatorei ValidateRecurrence() (linha 89)
-✅ Adicionei 3 testes de edge cases
-✅ Todos os acceptance criteria validados
-```
-
-# 3.6 - Marcar como concluída
-morph-spec story status scheduled-reports done SR-001
-
-# Output:
-# ✅ Story SR-001 marked as DONE
-# 📋 Next Story: SR-002
-
-# 3.7 - Commitar mudanças (se fez refactoring)
-git add .
-git commit -m "refactor(SR-001): extract ValidateRecurrence method"
-
-
-# ============================================================================
-# ETAPA 4: PRÓXIMA STORY (SR-002)
-# ============================================================================
-
-# Repetir ETAPA 2 e 3 para SR-002:
-morph-spec story status scheduled-reports start SR-002
-cat .morph/project/outputs/scheduled-reports/stories/SR-002.md
-cat .morph/project/outputs/scheduled-reports/spec/service-layer.md
-# ... implementar ...
-# ... adicionar Dev Notes ...
-morph-spec story status scheduled-reports qa SR-002
-# ... revisar ...
-# ... adicionar QA Notes ...
-morph-spec story status scheduled-reports done SR-002
-
-# Repetir para SR-003, SR-004, ..., SR-010
-
-
-# ============================================================================
-# ETAPA 5: FINALIZAÇÃO
-# ============================================================================
-
-# Ver progresso geral
-morph-spec story status scheduled-reports show
-
-# Output:
-# 📊 Sprint Status: scheduled-reports
-# Progress: 100% (10/10 stories done)
-# 🎉 All stories completed!
-
-# Pronto! Feature implementada.
-```
-
----
-
-## 📝 Comandos que Você Usa
-
-### Criar stories (início da feature)
-```bash
-morph-spec story shard <feature-name>
-morph-spec story create <feature-name> <story-id> --title "..." --tasks "..."
-```
-
-### Ver status
-```bash
-morph-spec story status <feature-name> show
-```
-
-### Marcar que vai começar
-```bash
-morph-spec story status <feature-name> start <story-id>
-```
-
-### Marcar que terminou (vai para QA)
-```bash
-morph-spec story status <feature-name> qa <story-id>
-```
-
-### Marcar como concluída
-```bash
-morph-spec story status <feature-name> done <story-id>
-```
-
-### Ver próxima story
-```bash
-morph-spec story status <feature-name> next
-```
-
----
-
-## 🔄 Seu Dia a Dia
-
-### Segunda-feira: Criar as stories
-```bash
-morph-spec story shard my-feature
-morph-spec story create my-feature MF-001 --title "..." --tasks "..."
-morph-spec story create my-feature MF-002 --title "..." --tasks "..."
-morph-spec story create my-feature MF-003 --title "..." --tasks "..."
-```
-
-### Terça-feira: Implementar MF-001
-```bash
-morph-spec story status my-feature start MF-001
-cat .morph/project/outputs/my-feature/stories/MF-001.md
-cat .morph/project/outputs/my-feature/spec/entity-design.md
-# [implementar código]
-# [adicionar Dev Notes na story]
-morph-spec story status my-feature qa MF-001
-git commit ...
-```
-
-### Terça à tarde: Revisar MF-001
-```bash
-cat .morph/project/outputs/my-feature/stories/MF-001.md  # ver Dev Notes
-# [revisar código]
-# [adicionar QA Notes na story]
-morph-spec story status my-feature done MF-001
-git commit ...
-```
-
-### Quarta-feira: Implementar MF-002
-```bash
-morph-spec story status my-feature start MF-002
-# ... repetir workflow
-```
-
----
-
-## ❓ Perguntas Comuns
-
-### "Preciso shardar o spec?"
-**Não é obrigatório.** Só recomendado se seu `spec.md` for grande (5+ seções).
-
-Se for pequeno, pule o `shard-spec.js` e vá direto para `create-story.js`.
-
----
-
-### "Quantas tasks por story?"
-**4-8 tasks** é ideal. Se tiver mais, quebre em sub-stories.
-
-Exemplo:
-- ❌ Ruim: Story com 20 tasks (muito grande)
-- ✅ Bom: Story com 5 tasks (1 dia de trabalho)
-
----
-
-### "O que são Dev Notes e QA Notes?"
-**Dev Notes:** Você (Dev) escreve o que implementou, para o QA saber.
-
-**QA Notes:** Você (QA) escreve o que revisou/refatorou.
-
-**Exemplo:**
-```markdown
-### Dev Notes (Added by Dev Agent)
-```
-✅ Implementei X.cs na pasta Domain/
-⚠️  Cuidado: usa regex complexo na linha 67
-```
-
-### QA Notes (Added by QA Agent)
-```
-✅ Revisei e está OK
-✅ Refatorei método ValidateX() para ficar mais claro
-```
-```
-
----
-
-### "Onde adiciono Dev/QA Notes?"
-**No arquivo da story.**
-
-1. Abra: `.morph/project/outputs/my-feature/stories/MF-001.md`
-2. Procure a seção `### Dev Notes (Added by Dev Agent)`
-3. Substitua `[VOCÊ VAI PREENCHER AQUI APÓS IMPLEMENTAR]` pelas suas notas
-4. Salve
-
----
-
-### "E se eu esquecer de adicionar Dev Notes?"
-Sem problema. Edite a story manualmente:
-
-```bash
-nano .morph/project/outputs/my-feature/stories/MF-001.md
-# Adicione as notas na seção correta
-# Salve
-```
-
----
-
-### "Posso implementar várias stories na mesma sessão?"
-**Não recomendado.**
-
-Cada story = nova sessão do Claude (se usar Claude Code).
-
-Por quê? Evita confusão e economiza tokens.
-
----
-
-## ✅ Checklist Rápido
-
-**No início da feature:**
-- [ ] Roda `shard-spec.js` (opcional)
-- [ ] Roda `create-story.js` para cada story
-- [ ] Roda `show` para ver todas criadas
-
-**Para cada story:**
-- [ ] `start` → Marcar que vai começar
-- [ ] Ler story file (`.morph/project/outputs/.../stories/XX.md`)
-- [ ] Ler spec shard (`.morph/project/outputs/.../spec/xxx.md`)
-- [ ] Implementar código
-- [ ] Adicionar Dev Notes na story
-- [ ] `qa` → Marcar que terminou
-- [ ] Commit código
-- [ ] Revisar código
-- [ ] Adicionar QA Notes na story
-- [ ] `done` → Marcar como concluída
-- [ ] Commit mudanças
-
-**No final:**
-- [ ] `show` → Ver que 100% completo
-- [ ] Todas stories têm Dev Notes e QA Notes preenchidas
-
----
-
-## 📚 Referência Rápida
-
-```bash
-# Ver ajuda de qualquer comando
-morph-spec story --help
-morph-spec story shard --help
-morph-spec story create --help
-morph-spec story status --help
-
-# Estrutura de pastas (após criar stories)
-.morph/project/outputs/my-feature/
-├── spec/               # Spec dividido em partes
-│   ├── index.md
-│   ├── entity-design.md
-│   └── service-layer.md
-├── stories/            # Stories auto-contidas
-│   ├── MF-001.md
-│   ├── MF-002.md
-│   └── MF-003.md
-└── sprint-status.yaml  # Progresso automático
-```
-
----
-
-*MORPH-SPEC Framework - Guia do Usuário*
-*Use este guia como referência rápida durante o desenvolvimento*