@polymorphism-tech/morph-spec 1.0.2 → 2.0.0

package/content/.azure/pipelines/templates/deploy-app-service.yml

@@ -0,0 +1,94 @@
+# ==============================================================================
+# 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/content/.azure/pipelines/templates/deploy-container-app.yml

@@ -0,0 +1,120 @@
+# ==============================================================================
+# 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/content/.azure/pipelines/templates/infra-deploy.yml

@@ -0,0 +1,90 @@
+# ==============================================================================
+# 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/content/.claude/commands/morph-apply.md

@@ -1,49 +1,134 @@
-# Apply MORPH Feature Implementation
+# Apply MORPH Feature Implementation - FASE 5
 
 Implemente a feature especificada seguindo as tasks definidas.
 
+## Uso
+
+```
+/morph-apply {feature-name}
+```
+
 ## Pré-requisitos
 
-Verifique antes de implementar:
-- [ ] Feature existe em `.morph/features/{feature}/`
-- [ ] `spec.md` está aprovado (Status: Approved)
-- [ ] `tasks.md` tem tasks definidas
+### CRÍTICO: Validar Fases Anteriores
+
+**SEMPRE verifique que fases anteriores foram concluídas:**
+
+```bash
+# Obter estado da feature
+node bin/state-manager.js get {feature-name}
+```
+
+**Validações obrigatórias:**
+
+1. **FASE 0 (Proposal):**
+   - [ ] Output `proposal` criado
+   - [ ] Agentes detectados e registrados
+
+2. **FASE 1 (Setup):**
+   - [ ] Phase passou por "setup"
+   - [ ] Contexto carregado
+
+3. **FASE 1.5 (UI/UX) - SE APLICÁVEL:**
+   - [ ] Se `uiux-designer` está nos activeAgents → outputs ui-* devem existir
+   - [ ] Se NÃO tem uiux-designer → pode pular
+
+4. **FASE 2 (Design):**
+   - [ ] Output `spec` criado
+   - [ ] Output `contracts` criado
+   - [ ] Output `decisions` criado
+
+5. **FASE 3 (Clarify):**
+   - [ ] Phase passou por "clarify"
+   - [ ] Spec atualizado com clarificações
+
+6. **FASE 4 (Tasks):**
+   - [ ] Output `tasks` criado
+   - [ ] `tasks.json` tem array de tasks
+   - [ ] `tasks.total` > 0 no state
+
+**Se QUALQUER validação falhar:**
+```
+❌ ERRO: Fase {X} não foi concluída!
+
+Para continuar, execute primeiro:
+- /morph-proposal (FASE 0)
+- /morph-setup (FASE 1)
+- /morph-uiux (FASE 1.5 - se necessário)
+- /morph-design (FASE 2)
+- /morph-clarify (FASE 3)
+- /morph-tasks (FASE 4)
+
+Fase atual: {current_phase}
+```
+
+**NÃO prossiga com implementação até todas as fases estarem completas!**
+
+### Arquivos Necessários
+
+- [ ] Feature existe em `.morph/project/outputs/{feature}/`
+- [ ] `spec.md` está aprovado
+- [ ] `tasks.json` tem tasks definidas
 - [ ] `contracts.cs` define as interfaces
 
 ## Workflow
 
 1. **Carregue o contexto**:
-   - Leia `.morph/features/{feature}/spec.md`
-   - Leia `.morph/features/{feature}/tasks.md`
-   - Leia `.morph/features/{feature}/contracts.cs`
-   - Leia `.morph/standards/` para padrões
-
-2. **Execute tasks em ordem**:
+   - Leia `.morph/project/outputs/{feature}/spec.md`
+   - Leia `.morph/project/outputs/{feature}/tasks.json`
+   - Leia `.morph/project/outputs/{feature}/contracts.cs`
+   - Leia framework/standards/ e .morph/project/standards/ para padrões
+
+2. **Inicialize state tracking**:
+   ```bash
+   # Atualizar fase para implement
+   node bin/state-manager.js set {feature} phase implement
+   node bin/state-manager.js set {feature} status in_progress
+
+   # Definir total de tasks (baseado em tasks.json)
+   node bin/state-manager.js set {feature} tasks.total {N}
+   ```
+
+3. **Execute tasks em ordem**:
    - Marque task como `[~] In Progress`
+   - Atualize state: `node bin/state-manager.js set {feature} tasks.inProgress 1`
    - Implemente seguindo os padrões
    - Marque task como `[x] Completed`
-
-3. **Checkpoints**:
-   - Pause nos checkpoints definidos
-   - Apresente o que foi feito
+   - Atualize state: `node bin/state-manager.js set {feature} tasks.completed {X}`
+   - Atualize state: `node bin/state-manager.js set {feature} tasks.inProgress 0`
+
+4. **Checkpoints a cada 3 tasks**:
+   ```bash
+   # Registrar checkpoint
+   node bin/state-manager.js checkpoint {feature} "Completadas tasks T001-T003"
+   ```
+   - Pause e apresente o que foi feito
+   - Mostre progresso: `node bin/state-manager.js list`
    - Aguarde aprovação para continuar
 
-4. **A cada 3 tasks**:
-   - Faça um checkpoint automático
-   - Mostre progresso
-   - Valide com o usuário
-
-5. **Ao finalizar**:
+5. **Marcar outputs criados**:
+   Sempre que gerar um arquivo de output:
+   ```bash
+   node bin/state-manager.js mark-output {feature} spec
+   node bin/state-manager.js mark-output {feature} contracts
+   node bin/state-manager.js mark-output {feature} tasks
+   # etc.
+   ```
+
+6. **Ao finalizar**:
+   - Atualize state: `node bin/state-manager.js set {feature} status done`
+   - Marque recap: `node bin/state-manager.js mark-output {feature} recap`
    - Atualize `recap.md` com resultados
    - Liste arquivos criados/modificados
    - Calcule custo real vs estimado
 
 ## Padrões Obrigatórios
 
-Siga sempre:
-- `.morph/standards/coding.md` - Nomenclatura e estilo
-- `.morph/standards/architecture.md` - Estrutura de projeto
-- `.morph/standards/azure.md` - Recursos e custos
+Siga sempre (priorize project/standards/ se houver):
+- `framework/standards/coding.md` - Padrões base do MORPH
+- `.morph/project/standards/coding.md` - Padrões específicos do projeto
+- `.morph/project/standards/architecture.md` - Estrutura de projeto
+- `.morph/project/standards/azure.md` - Recursos e custos
 
 ## Validações
 
@@ -59,7 +144,14 @@ Ao final de cada task, mostre:
 1. Task completada
 2. Arquivos criados/modificados
 3. Próxima task
-4. Progresso geral (X/Y tasks)
+4. Progresso geral (X/Y tasks) - usar `node bin/state-manager.js get {feature}`
+
+Ao final de cada checkpoint:
+```bash
+node bin/state-manager.js list
+```
+
+Isso mostra o progresso atualizado automaticamente.
 
 ---
 

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

@@ -1,11 +1,11 @@
 # Archive MORPH Feature
 
-Arquive uma feature concluída, movendo-a de `features/` para `archive/`.
+Arquive uma feature concluída, movendo-a de `project/outputs/` para `project/archive/`.
 
 ## Pré-requisitos
 
 Verifique antes de arquivar:
-- [ ] Feature existe em `.morph/features/{feature}/`
+- [ ] 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)
@@ -13,23 +13,23 @@ Verifique antes de arquivar:
 ## Workflow
 
 1. **Valide a conclusão**:
-   - Leia `.morph/features/{feature}/tasks.md`
-   - Verifique que todas tasks estão `[x]`
+   - 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/features/{feature}/recap.md`
+   - 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/specs/`
+   - Copie spec relevante para `.morph/project/specs/`
    - Isso vira a "verdade atual" do sistema
 
 4. **Mova para archive**:
    ```
-   .morph/features/{feature}/  →  .morph/archive/{feature}/
+   .morph/project/outputs/{feature}/  →  .morph/project/archive/{feature}/
    ```
 
 5. **Atualize métricas do projeto**:
@@ -62,7 +62,7 @@ Apresente resumo do arquivamento:
 ╠════════════════════════════════════════════╣
 ║ ARCHIVED TO                                ║
 ╠════════════════════════════════════════════╣
-║ .morph/archive/{feature}/                  ║
+║ .morph/project/archive/{feature}/          ║
 ╚════════════════════════════════════════════╝
 ```
 
@@ -70,7 +70,7 @@ Apresente resumo do arquivamento:
 
 Se houver specs extraídas:
 ```
-Specs extracted to .morph/specs/:
+Specs extracted to .morph/project/specs/:
 - {domain}/spec.md - {description}
 ```