@polymorphism-tech/morph-spec 4.6.0 → 4.7.1

package/.morph/framework/templates/feature/recap.md

@@ -1,146 +0,0 @@
-# Feature Recap: {{titleCase FEATURE_NAME}}
-
-## Summary
-
-| Field | Value |
-|-------|-------|
-| **Feature ID** | {{FEATURE_NAME}} |
-| **Completed** | {{DATE}} |
-| **Total Tasks** | {X} |
-| **Time Spent** | {X}h |
-| **Agents Used** | {list} |
-{{#if STACK}}| **Stack** | {{STACK}} |{{/if}}
-
----
-
-## Tasks Completed
-
-| ID | Title | Category | Duration |
-|----|-------|----------|----------|
-| T001 | {title} | {{#if (eq STACK "nextjs-supabase")}}Database{{else}}{category}{{/if}} | {X}min |
-| T002 | {title} | {{#if (eq STACK "nextjs-supabase")}}Backend{{else}}{category}{{/if}} | {X}min |
-| T003 | {title} | {{#if (eq STACK "nextjs-supabase")}}Frontend{{else}}{category}{{/if}} | {X}min |
-
----
-
-{{#if (eq STACK "nextjs-supabase")}}
-## Validation Results
-
-| Validator | Status | Details |
-|-----------|--------|---------|
-| contract-compliance | Pass/Fail | {details} |
-| architecture | Pass/Fail | {details} |
-| design-system | Pass/Fail | {details} |
-| coding-standards | Pass/Fail | {details} |
-
----
-
-{{/if}}
-## What Was Delivered
-
-### Functionality
-- {Functionality 1 delivered}
-- {Functionality 2 delivered}
-- {Functionality 3 delivered}
-
-{{#if (eq STACK "nextjs-supabase")}}
-### Database (Supabase)
-- Tables: {list}
-- RLS Policies: {count} policies
-- Migrations: {count} files
-
-### Backend API (.NET)
-- Endpoints: {count} endpoints
-- Services: {list}
-
-### Frontend (Next.js)
-- Pages: {list}
-- Components: {list}
-{{/if}}
-
----
-
-## Files Created
-
-```
-{{#if (eq STACK "nextjs-supabase")}}
-supabase/migrations/{files}
-backend/src/{files}
-frontend/src/{files}
-{{else}}
-{list of created files}
-{{/if}}
-```
-
-## Files Modified
-
-```
-{list of modified files}
-```
-
----
-
-## Architecture Decisions
-
-| Decision | Rationale |
-|----------|-----------|
-| {Decision 1} | {Reason} |
-| {Decision 2} | {Reason} |
-
-See full ADRs in `decisions.md`
-
----
-
-## Test Coverage
-
-| Type | Files | Coverage |
-|------|-------|----------|
-| {{#if (eq STACK "nextjs-supabase")}}Backend Unit{{else}}Unit Tests{{/if}} | {X} | {X}% |
-| {{#if (eq STACK "nextjs-supabase")}}Frontend Component{{else}}Integration Tests{{/if}} | {X} | {X}% |
-
----
-
-## Lessons Learned
-
-### What Went Well
-- {Positive point 1}
-- {Positive point 2}
-
-### What Could Be Improved
-- {Improvement point 1}
-- {Improvement point 2}
-
-### Recommendations for Future
-- {Recommendation 1}
-- {Recommendation 2}
-
----
-
-## Metrics
-
-| Metric | Value |
-|--------|-------|
-| Tasks Completed | {X}/{X} |
-| Checkpoints Passed | {X} |
-{{#if (eq STACK "nextjs-supabase")}}| Validation Passes | {X}/{X} |
-{{else}}| Code Reviews | {X} |
-{{/if}}| Bugs Found | {X} |
-| Bugs Fixed | {X} |
-
----
-
-## Related Resources
-
-- **Proposal:** `proposal.md`
-- **Spec:** `spec.md`
-{{#if (eq STACK "nextjs-supabase")}}- **Contracts (.NET):** `contracts.cs`
-- **Contracts (TS):** `contracts.ts`
-{{else}}- **Contracts:** `contracts.cs`
-{{/if}}- **Tasks:** `tasks.md`
-- **Decisions:** `decisions.md`
-{{#if (eq STACK "blazor-azure")}}- **Azure DevOps Epic:** {link}
-{{/if}}- **PR:** {link}
-
----
-
-*Generated by MORPH Framework on {{DATE}}*

package/.morph/framework/templates/feature/tasks.md

@@ -1,199 +0,0 @@
-# Tasks - {{titleCase FEATURE_NAME}}
-
-> Implementation checklist for the feature.
-> Update status as you progress.
-
-| Task ID | Type | Title | Status |
-|---------|------|-------|--------|
-| T001 | {type} | {title} | Pending |
-| T002 | {type} | {title} | Pending |
-| T003 | {type} | {title} | In Progress |
-| T004 | {type} | {title} | Blocked |
-| T005 | {type} | {title} | Done |
-
-**Status Values:** `Pending | In Progress | Blocked | Done`
-
----
-
-## Task Granularity
-
-### Ideal Task
-- 15-60 minutes of implementation
-- 1-5 files modified
-- Testable in isolation
-- Independent commit possible
-
-### Signs of Too Broad (Split)
-**Bad example:** "Implement feature"
-**Split into:**
-- T001: Define contracts and interfaces
-- T002: Implement data layer
-- T003: Implement business logic
-- T004: Create UI components
-- T005: Write tests
-
-### Signs of Too Granular (Merge)
-**Bad example:** "Create field A", "Create field B", "Create field C"
-**Merge into:** "Create data model with all fields"
-
----
-
-## Gates & Reviews
-
-| Task ID | Type | Description | Status |
-|---------|------|-------------|--------|
-| T003 | Review | Review contracts and data model | Pending |
-| T006 | Review | Review implementation | Pending |
-| T009 | Approval | Approve UI before testing | Pending |
-
----
-
-## Phase 1: Contracts & Data Model
-
-### T001: Define contracts and interfaces
-- **Type:** Contract
-- **Priority:** 1
-- **Estimate:** 30min
-- **Assigned:** {agent}
-- **Dependencies:** None
-
-**Description:**
-
-Define service interfaces and contracts.
-
-**Deliverables:**
-- [ ] Create: `{path-to-interface-file}`
-
----
-
-### T002: Create data model
-- **Type:** {{#if (eq STACK "nextjs-supabase")}}Database{{else}}Domain{{/if}}
-- **Priority:** 1
-- **Estimate:** 45min
-- **Assigned:** {agent}
-- **Dependencies:** None
-
-**Description:**
-
-Create data model {{#if (eq STACK "nextjs-supabase")}}with migrations{{else}}with entities{{/if}}.
-
-**Deliverables:**
-- [ ] Create: `{path-to-model-file}`
-
----
-
-## Phase 2: Implementation
-
-### T003: Implement data layer
-- **Type:** {{#if (eq STACK "nextjs-supabase")}}Repository{{else}}Infrastructure{{/if}}
-- **Priority:** 2
-- **Estimate:** 1h
-- **Assigned:** {agent}
-- **Dependencies:** T001, T002
-
-**Description:**
-
-Implement data access layer.
-
-**Deliverables:**
-- [ ] Create: `{path-to-repository-file}`
-
----
-
-### T004: Implement business logic
-- **Type:** Service
-- **Priority:** 2
-- **Estimate:** 1h
-- **Assigned:** {agent}
-- **Dependencies:** T001, T003
-
-**Description:**
-
-Implement service layer with business logic.
-
-**Deliverables:**
-- [ ] Create: `{path-to-service-file}`
-
----
-
-## Phase 3: UI Components
-
-### T005: Create list component
-- **Type:** UI
-- **Priority:** 2
-- **Estimate:** 45min
-- **Assigned:** {agent}
-- **Dependencies:** T004
-
-**Description:**
-
-Create component to list items.
-
-**Deliverables:**
-- [ ] Create: `{path-to-component-file}`
-
----
-
-### T006: Create form component
-- **Type:** UI
-- **Priority:** 2
-- **Estimate:** 1h
-- **Assigned:** {agent}
-- **Dependencies:** T005
-
-**Description:**
-
-Create component for create/edit.
-
-**Deliverables:**
-- [ ] Create: `{path-to-form-file}`
-
----
-
-## Phase 4: Testing
-
-### T007: Write unit tests
-- **Type:** Test
-- **Priority:** 2
-- **Estimate:** 1h
-- **Assigned:** {agent}
-- **Dependencies:** T004
-
-**Description:**
-
-Unit tests for service layer.
-
-**Deliverables:**
-- [ ] Create: `{path-to-test-file}`
-
----
-
-### T008: Write integration tests
-- **Type:** Test
-- **Priority:** 3
-- **Estimate:** 1h
-- **Assigned:** {agent}
-- **Dependencies:** T007
-
-**Description:**
-
-Integration tests for {{#if (eq STACK "nextjs-supabase")}}API and database{{else}}repository and API{{/if}}.
-
-**Deliverables:**
-- [ ] Create: `{path-to-integration-test-file}`
-
----
-
-## Summary
-
-| Phase | Tasks | Estimate |
-|-------|-------|----------|
-| Phase 1 | T001-T002 | {X}h |
-| Phase 2 | T003-T004 | {X}h |
-| Phase 3 | T005-T006 | {X}h |
-| Phase 4 | T007-T008 | {X}h |
-| **Total** | **8 tasks** | **{X}h** |
-
----
-
-*Generated by MORPH Framework*

package/.morph/framework/templates/infrastructure/azure/Dockerfile.example

@@ -1,82 +0,0 @@
-# ==============================================================================
-# MORPH-SPEC - .NET 8 Blazor Server Dockerfile
-# Multi-stage build for production-ready container
-# ==============================================================================
-
-# ==============================================================================
-# Stage 1: Base Runtime
-# ==============================================================================
-FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
-
-# Set working directory
-WORKDIR /app
-
-# Expose ports
-EXPOSE 8080
-EXPOSE 8081
-
-# Create non-root user for security
-RUN adduser --disabled-password --gecos '' appuser && chown -R appuser /app
-USER appuser
-
-# ==============================================================================
-# Stage 2: Build
-# ==============================================================================
-FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
-
-# Set working directory
-WORKDIR /src
-
-# Copy project files
-# Adjust paths according to your solution structure
-COPY ["src/YourApp/YourApp.csproj", "src/YourApp/"]
-COPY ["src/YourApp.Core/YourApp.Core.csproj", "src/YourApp.Core/"]
-COPY ["src/YourApp.Infrastructure/YourApp.Infrastructure.csproj", "src/YourApp.Infrastructure/"]
-
-# Restore dependencies
-RUN dotnet restore "src/YourApp/YourApp.csproj"
-
-# Copy all source code
-COPY . .
-
-# Build project
-WORKDIR "/src/src/YourApp"
-RUN dotnet build "YourApp.csproj" -c Release -o /app/build
-
-# ==============================================================================
-# Stage 3: Publish
-# ==============================================================================
-FROM build AS publish
-
-# Publish application
-RUN dotnet publish "YourApp.csproj" \
-    -c Release \
-    -o /app/publish \
-    /p:UseAppHost=false \
-    /p:PublishTrimmed=false \
-    /p:PublishSingleFile=false
-
-# ==============================================================================
-# Stage 4: Final
-# ==============================================================================
-FROM base AS final
-
-# Set working directory
-WORKDIR /app
-
-# Copy published files from publish stage
-COPY --from=publish /app/publish .
-
-# Set environment variables
-ENV ASPNETCORE_URLS=http://+:8080
-ENV ASPNETCORE_ENVIRONMENT=Production
-ENV DOTNET_RUNNING_IN_CONTAINER=true
-ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false
-
-# Health check endpoint
-# Adjust path to match your health check endpoint
-HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
-  CMD curl -f http://localhost:8080/health || exit 1
-
-# Set entry point
-ENTRYPOINT ["dotnet", "YourApp.dll"]

package/.morph/framework/templates/infrastructure/azure/README.md

@@ -1,286 +0,0 @@
-# MORPH-SPEC - Templates Bicep
-
-Templates de infraestrutura para Azure com suporte a App Service e Container Apps.
-
----
-
-## 🚀 Quick Start
-
-### 1. App Service Free (Desenvolvimento - $0/mês)
-
-```bash
-# Deploy infraestrutura com App Service Free
-az deployment group create \
-  --resource-group rg-myapp-dev \
-  --template-file main.bicep \
-  --parameters @parameters.dev.json \
-  --parameters appName=myapp
-```
-
-### 2. Container Apps (Produção - $5-15/mês)
-
-```bash
-# Build e push imagem para ACR
-az acr build \
-  --registry acrXXXX \
-  --image myapp:v1.0.0 \
-  --file Dockerfile \
-  .
-
-# Deploy infraestrutura com Container Apps
-az deployment group create \
-  --resource-group rg-myapp-prod \
-  --template-file main.bicep \
-  --parameters @parameters.prod.json \
-  --parameters appName=myapp
-```
-
----
-
-## 📁 Estrutura de Arquivos
-
-```
-infra/
-├── main.bicep                    # Entry point com lógica condicional
-├── parameters.dev.json           # Params dev (App Service Free)
-├── parameters.prod.json          # Params prod (Container Apps)
-├── app-service.bicep             # Template App Service
-├── container-app.bicep           # Template Container App
-├── container-app-env.bicep       # Container Apps Environment
-├── sql-database.bicep            # Azure SQL Database
-├── storage.bicep                 # Storage Account
-├── key-vault.bicep               # Key Vault
-└── app-insights.bicep            # Application Insights
-```
-
----
-
-## ⚙️ Parâmetros Principais
-
-### main.bicep
-
-| Parâmetro | Tipo | Default | Descrição |
-|-----------|------|---------|-----------|
-| `environment` | string | `dev` | Ambiente (dev, staging, prod) |
-| `appName` | string | **required** | Nome da aplicação (3-15 chars) |
-| `location` | string | `resourceGroup().location` | Região Azure |
-| `hostingType` | string | `appservice` | Tipo de hosting (`appservice` ou `containerapp`) |
-| `appServiceSku` | string | `F1` | SKU do App Service (F1, B1, S1, P1v2) |
-| `containerImage` | string | `mcr.microsoft.com/hello-world:latest` | Imagem Docker (apenas Container Apps) |
-| `sqlAdminPassword` | securestring | **required** | Senha do SQL Server |
-
----
-
-## 🌐 Escolhendo o Hosting Type
-
-### App Service (`hostingType: appservice`)
-
-**Usar quando:**
-- ✅ Orçamento zero (Free F1)
-- ✅ MVP ou protótipo
-- ✅ Tráfego baixo (<100 req/dia)
-- ✅ App tolerante a cold starts (20 min sleep)
-- ✅ Deploy simplificado (sem Docker)
-
-**SKUs disponíveis:**
-- `F1` (Free): $0/mês - 1GB RAM, 60 min CPU/dia, sleep após 20min
-- `B1` (Basic): $13/mês - 1.75GB RAM, always-on
-- `S1` (Standard): $70/mês - 1.75GB RAM, auto-scale, slots
-- `P1v2` (Premium): $85/mês - 3.5GB RAM, melhor performance
-
-### Container Apps (`hostingType: containerapp`)
-
-**Usar quando:**
-- ✅ Produção com SLA 24/7
-- ✅ Auto-scaling baseado em demanda
-- ✅ SSL customizado necessário
-- ✅ Background jobs (Hangfire)
-- ✅ Arquitetura microserviços
-
-**Custo:** $0-15/mês (scale-to-zero + consumo)
-
----
-
-## 📝 Configuração por Ambiente
-
-### Development (parameters.dev.json)
-
-```json
-{
-  "environment": { "value": "dev" },
-  "hostingType": { "value": "appservice" },
-  "appServiceSku": { "value": "F1" }
-}
-```
-
-**Infraestrutura:**
-- App Service Free F1
-- Azure SQL Free (32GB)
-- App Insights Free (5GB)
-
-**Custo total:** $0/mês
-
-### Staging (parameters.staging.json)
-
-```json
-{
-  "environment": { "value": "staging" },
-  "hostingType": { "value": "containerapp" },
-  "minReplicas": { "value": 0 }  // scale-to-zero
-}
-```
-
-**Infraestrutura:**
-- Container Apps (scale-to-zero)
-- Azure SQL Free (32GB)
-- ACR Basic
-- App Insights Free
-
-**Custo total:** $5-10/mês
-
-### Production (parameters.prod.json)
-
-```json
-{
-  "environment": { "value": "prod" },
-  "hostingType": { "value": "containerapp" },
-  "minReplicas": { "value": 1 }  // always-on
-}
-```
-
-**Infraestrutura:**
-- Container Apps (min 1 replica)
-- Azure SQL Free (ou pago se necessário)
-- ACR Basic
-- App Insights (pode ultrapassar free tier)
-
-**Custo total:** $10-20/mês
-
----
-
-## 🔧 Customização
-
-### Adicionar variáveis de ambiente
-
-**App Service:**
-```bicep
-module appService 'app-service.bicep' = {
-  params: {
-    envVars: {
-      MY_CUSTOM_VAR: 'value'
-      ANOTHER_VAR: 'another-value'
-    }
-  }
-}
-```
-
-**Container Apps:**
-```bicep
-module containerApp 'container-app.bicep' = {
-  params: {
-    envVars: [
-      {
-        name: 'MY_CUSTOM_VAR'
-        value: 'value'
-      }
-    ]
-  }
-}
-```
-
-### Usar secrets do Key Vault
-
-```bicep
-param sqlAdminPassword string {
-  reference: {
-    keyVault: {
-      id: '/subscriptions/.../providers/Microsoft.KeyVault/vaults/kv-myapp'
-    }
-    secretName: 'sql-admin-password'
-  }
-}
-```
-
----
-
-## 🔄 Migração App Service → Container Apps
-
-Ver guia completo em: `../../standards/migration-guide.md`
-
-**Resumo:**
-1. Criar Dockerfile
-2. Implementar health checks
-3. Build e push para ACR
-4. Atualizar `parameters.json` → `hostingType: containerapp`
-5. Redeploy
-6. Testar
-7. Cutover DNS
-
----
-
-## 📊 Outputs Gerados
-
-Após deploy, os seguintes outputs são gerados:
-
-```bash
-# Obter URL da aplicação
-az deployment group show \
-  -g rg-myapp-dev \
-  -n deployment-name \
-  --query properties.outputs.appUrl.value
-
-# Obter connection string SQL
-az deployment group show \
-  -g rg-myapp-dev \
-  -n deployment-name \
-  --query properties.outputs.sqlConnectionString.value
-
-# Obter App Insights connection string
-az deployment group show \
-  -g rg-myapp-dev \
-  -n deployment-name \
-  --query properties.outputs.appInsightsConnectionString.value
-```
-
----
-
-## 🆘 Troubleshooting
-
-### Erro: "The template deployment 'X' is not valid"
-
-Validar template:
-```bash
-az deployment group validate \
-  --resource-group rg-myapp-dev \
-  --template-file main.bicep \
-  --parameters @parameters.dev.json
-```
-
-### Erro: "SKU not available in this location"
-
-Verificar SKUs disponíveis:
-```bash
-az appservice list-locations --sku F1
-```
-
-### Deploy muito lento
-
-Container Apps pode levar 5-10 minutos no primeiro deploy. Use `--no-wait` para não bloquear:
-```bash
-az deployment group create \
-  ... \
-  --no-wait
-```
-
----
-
-## 📚 Referências
-
-- [Bicep Documentation](https://learn.microsoft.com/azure/azure-resource-manager/bicep/)
-- [App Service Bicep Reference](https://learn.microsoft.com/azure/templates/microsoft.web/sites)
-- [Container Apps Bicep Reference](https://learn.microsoft.com/azure/templates/microsoft.app/containerapps)
-- [Azure CLI Reference](https://learn.microsoft.com/cli/azure/)
-
----
-
-*MORPH-SPEC by Polymorphism Tech*