@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

package/content/.morph/templates/recap.md

@@ -1,105 +1,94 @@
-# Feature Recap: {{FEATURE_NAME_TITLE}}
-
-## 📋 Summary
-
-| Field | Value |
-|-------|-------|
-| **Feature ID** | {feature-id} |
-| **Completed** | {{DATE}} |
-| **Total Tasks** | {X} |
-| **Time Spent** | {X}h |
-| **Agents Used** | {list} |
-
----
-
-## ✅ What Was Delivered
-
-### Functionality
-- {Funcionalidade 1 entregue}
-- {Funcionalidade 2 entregue}
-- {Funcionalidade 3 entregue}
-
-### Files Created
-```
-{lista de arquivos criados}
-```
-
-### Files Modified
-```
-{lista de arquivos modificados}
-```
-
----
-
-## 🏗️ Architecture Decisions
-
-| Decision | Rationale |
-|----------|-----------|
-| {Decisão 1} | {Motivo} |
-| {Decisão 2} | {Motivo} |
-
-See full ADRs in `decisions.md`
-
----
-
-## 🧪 Test Coverage
-
-| Type | Files | Coverage |
-|------|-------|----------|
-| Unit Tests | {X} | {X}% |
-| Integration Tests | {X} | {X}% |
-
----
-
-## 💰 Cost Impact
-
-| Resource | Before | After | Delta |
-|----------|--------|-------|-------|
-| Azure SQL | $0 | $0 | $0 |
-| Container Apps | $X | $X | +$X |
-| Azure OpenAI | $X | $X | +$X |
-| **Total** | | | **+$X/month** |
-
----
-
-## 📝 Lessons Learned
-
-### What Went Well
-- {Ponto positivo 1}
-- {Ponto positivo 2}
-
-### What Could Be Improved
-- {Ponto de melhoria 1}
-- {Ponto de melhoria 2}
-
-### Recommendations for Future
-- {Recomendação 1}
-- {Recomendação 2}
-
----
-
-## 🔗 Related Resources
-
-- **Proposal:** `proposal.md`
-- **Spec:** `spec.md`
-- **Contracts:** `contracts.cs`
-- **Tasks:** `tasks.md`
-- **Decisions:** `decisions.md`
-- **Azure DevOps Epic:** {link}
-- **PR:** {link}
-
----
-
-## 📊 Metrics
-
-| Metric | Value |
-|--------|-------|
-| Tasks Completed | {X}/{X} |
-| Checkpoints Passed | {X} |
-| Code Reviews | {X} |
-| Bugs Found | {X} |
-| Bugs Fixed | {X} |
-
----
-
-*Generated by MORPH Framework on {{DATE}}*
+# Feature Recap: {{FEATURE_NAME_TITLE}}
+
+## 📋 Summary
+
+| Field | Value |
+|-------|-------|
+| **Feature ID** | {feature-id} |
+| **Completed** | {{DATE}} |
+| **Total Tasks** | {X} |
+| **Time Spent** | {X}h |
+| **Agents Used** | {list} |
+
+---
+
+## ✅ What Was Delivered
+
+### Functionality
+- {Funcionalidade 1 entregue}
+- {Funcionalidade 2 entregue}
+- {Funcionalidade 3 entregue}
+
+### Files Created
+```
+{lista de arquivos criados}
+```
+
+### Files Modified
+```
+{lista de arquivos modificados}
+```
+
+---
+
+## 🏗️ Architecture Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| {Decisão 1} | {Motivo} |
+| {Decisão 2} | {Motivo} |
+
+See full ADRs in `decisions.md`
+
+---
+
+## 🧪 Test Coverage
+
+| Type | Files | Coverage |
+|------|-------|----------|
+| Unit Tests | {X} | {X}% |
+| Integration Tests | {X} | {X}% |
+
+---
+
+## 📝 Lessons Learned
+
+### What Went Well
+- {Ponto positivo 1}
+- {Ponto positivo 2}
+
+### What Could Be Improved
+- {Ponto de melhoria 1}
+- {Ponto de melhoria 2}
+
+### Recommendations for Future
+- {Recomendação 1}
+- {Recomendação 2}
+
+---
+
+## 🔗 Related Resources
+
+- **Proposal:** `proposal.md`
+- **Spec:** `spec.md`
+- **Contracts:** `contracts.cs`
+- **Tasks:** `tasks.md`
+- **Decisions:** `decisions.md`
+- **Azure DevOps Epic:** {link}
+- **PR:** {link}
+
+---
+
+## 📊 Metrics
+
+| Metric | Value |
+|--------|-------|
+| Tasks Completed | {X}/{X} |
+| Checkpoints Passed | {X} |
+| Code Reviews | {X} |
+| Bugs Found | {X} |
+| Bugs Fixed | {X} |
+
+---
+
+*Generated by MORPH Framework on {{DATE}}*

package/content/.morph/templates/simulation.md

@@ -0,0 +1,353 @@
+# Template: Simulacao de Servicos Externos
+
+> Template para configurar modo de simulacao em projetos .NET
+
+## Configuracao
+
+### appsettings.Development.json
+
+```json
+{
+  "Simulation": {
+    "Enabled": true,
+    "ImageDelayMs": 500,
+    "EmailDelayMs": 100,
+    "PaymentDelayMs": 200,
+    "PlaceholderImageUrl": "https://picsum.photos/1024/1024"
+  }
+}
+```
+
+### SimulationOptions.cs
+
+```csharp
+namespace {Namespace}.Infrastructure.Options;
+
+public class SimulationOptions
+{
+    public bool Enabled { get; set; }
+    public int ImageDelayMs { get; set; } = 500;
+    public int EmailDelayMs { get; set; } = 100;
+    public int PaymentDelayMs { get; set; } = 200;
+    public string PlaceholderImageUrl { get; set; } = "https://picsum.photos/1024/1024";
+}
+```
+
+---
+
+## DI Condicional
+
+### Program.cs
+
+```csharp
+// Configurar options
+builder.Services.Configure<SimulationOptions>(
+    builder.Configuration.GetSection("Simulation"));
+
+// Registrar clientes baseado em modo
+var simulationEnabled = builder.Configuration.GetValue<bool>("Simulation:Enabled");
+
+if (simulationEnabled)
+{
+    builder.Services.AddSimulationClients();
+    builder.Services.AddSingleton<IStartupFilter, SimulationWarningStartupFilter>();
+}
+else
+{
+    builder.Services.AddProductionClients(builder.Configuration);
+}
+```
+
+### ServiceCollectionExtensions.cs
+
+```csharp
+namespace {Namespace}.Infrastructure.Extensions;
+
+public static class ServiceCollectionExtensions
+{
+    public static IServiceCollection AddSimulationClients(this IServiceCollection services)
+    {
+        // ========================================
+        // STATEFUL (mantem dados) → SINGLETON
+        // ========================================
+        services.AddSingleton<IReplicateClient, FakeReplicateClient>();
+        services.AddSingleton<IPaymentClient, FakePaymentClient>();
+
+        // ========================================
+        // STATELESS → SCOPED
+        // ========================================
+        services.AddScoped<IEmailClient, FakeEmailClient>();
+
+        // ========================================
+        // DEPENDENCIAS TRANSITIVAS - NAO ESQUECER!
+        // ========================================
+        services.AddHttpClient("FakeImageDownloader");
+        services.AddScoped<IImageDownloader>(sp =>
+        {
+            var httpClientFactory = sp.GetRequiredService<IHttpClientFactory>();
+            var httpClient = httpClientFactory.CreateClient("FakeImageDownloader");
+            var logger = sp.GetRequiredService<ILogger<FakeImageDownloader>>();
+            var options = sp.GetRequiredService<IOptions<SimulationOptions>>();
+            return new FakeImageDownloader(httpClient, logger, options);
+        });
+
+        return services;
+    }
+
+    public static IServiceCollection AddProductionClients(
+        this IServiceCollection services,
+        IConfiguration configuration)
+    {
+        // Clientes reais com HttpClient tipado
+        services.AddHttpClient<IReplicateClient, ReplicateClient>();
+        services.AddHttpClient<IPaymentClient, AsaasClient>();
+        services.AddHttpClient<IEmailClient, ResendClient>();
+        services.AddHttpClient<IImageDownloader, HttpImageDownloader>();
+
+        return services;
+    }
+}
+```
+
+---
+
+## Exemplos de Fake Clients
+
+### FakeReplicateClient (Stateful → Singleton)
+
+```csharp
+public class FakeReplicateClient : IReplicateClient
+{
+    // Stateful - REQUER Singleton
+    private readonly Dictionary<string, FakePrediction> _predictions = new();
+    private readonly ILogger<FakeReplicateClient> _logger;
+    private readonly SimulationOptions _options;
+
+    public FakeReplicateClient(
+        ILogger<FakeReplicateClient> logger,
+        IOptions<SimulationOptions> options)
+    {
+        _logger = logger;
+        _options = options.Value;
+    }
+
+    public Task<string> CreatePredictionAsync(CreatePredictionRequest request, CancellationToken ct)
+    {
+        var id = Guid.NewGuid().ToString();
+        _predictions[id] = new FakePrediction
+        {
+            Id = id,
+            Status = "processing",
+            Prompt = request.Input.Prompt,
+            CreatedAt = DateTime.UtcNow
+        };
+
+        _logger.LogInformation(
+            "[SIMULATED] Created prediction {Id} with prompt: {Prompt}",
+            id, request.Input.Prompt?.Substring(0, Math.Min(50, request.Input.Prompt.Length)));
+
+        return Task.FromResult(id);
+    }
+
+    public async Task<PredictionResult> WaitForPredictionAsync(string id, CancellationToken ct)
+    {
+        if (!_predictions.TryGetValue(id, out var prediction))
+            throw new InvalidOperationException($"Prediction {id} not found");
+
+        // Simular delay de processamento
+        await Task.Delay(_options.ImageDelayMs, ct);
+
+        var style = ExtractStyleFromPrompt(prediction.Prompt);
+
+        _logger.LogInformation(
+            "[SIMULATED] Prediction {Id} completed. Style: {Style}",
+            id, style);
+
+        return new PredictionResult
+        {
+            Id = id,
+            Status = "succeeded",
+            Output = _options.PlaceholderImageUrl
+        };
+    }
+
+    private static string ExtractStyleFromPrompt(string? prompt)
+    {
+        if (string.IsNullOrEmpty(prompt)) return "Default";
+
+        var lowerPrompt = prompt.ToLowerInvariant();
+
+        // IMPORTANTE: Atualizar conforme prompts REAIS do projeto
+        if (lowerPrompt.Contains("movie poster")) return "MoviePoster";
+        if (lowerPrompt.Contains("impressionist")) return "Impressionist";
+        if (lowerPrompt.Contains("baroque")) return "Baroque";
+        if (lowerPrompt.Contains("watercolor")) return "Watercolor";
+
+        return "Default";
+    }
+
+    private class FakePrediction
+    {
+        public string Id { get; init; } = "";
+        public string Status { get; set; } = "";
+        public string? Prompt { get; init; }
+        public DateTime CreatedAt { get; init; }
+    }
+}
+```
+
+### FakeEmailClient (Stateless → Scoped)
+
+```csharp
+public class FakeEmailClient : IEmailClient
+{
+    private readonly ILogger<FakeEmailClient> _logger;
+    private readonly SimulationOptions _options;
+
+    public FakeEmailClient(
+        ILogger<FakeEmailClient> logger,
+        IOptions<SimulationOptions> options)
+    {
+        _logger = logger;
+        _options = options.Value;
+    }
+
+    public async Task<string?> SendEmailAsync(
+        string to,
+        string subject,
+        string htmlBody,
+        IReadOnlyList<EmailAttachment>? attachments = null,
+        CancellationToken ct = default)
+    {
+        await Task.Delay(_options.EmailDelayMs, ct);
+
+        var attachmentCount = attachments?.Count ?? 0;
+
+        _logger.LogInformation(
+            "[SIMULATED] Email sent to {To}. Subject: {Subject}. Attachments: {Count}",
+            to, subject, attachmentCount);
+
+        return $"fake-message-{Guid.NewGuid():N}";
+    }
+}
+```
+
+### FakeImageDownloader (Stateless → Scoped)
+
+```csharp
+public class FakeImageDownloader : IImageDownloader
+{
+    private readonly HttpClient _httpClient;
+    private readonly ILogger<FakeImageDownloader> _logger;
+    private readonly SimulationOptions _options;
+
+    public FakeImageDownloader(
+        HttpClient httpClient,
+        ILogger<FakeImageDownloader> logger,
+        IOptions<SimulationOptions> options)
+    {
+        _httpClient = httpClient;
+        _logger = logger;
+        _options = options.Value;
+    }
+
+    public async Task<byte[]> DownloadAsync(string url, CancellationToken ct)
+    {
+        _logger.LogInformation(
+            "[SIMULATED] Downloading image from placeholder instead of {Url}",
+            url);
+
+        // Baixa imagem real do placeholder
+        var response = await _httpClient.GetAsync(_options.PlaceholderImageUrl, ct);
+        response.EnsureSuccessStatusCode();
+
+        return await response.Content.ReadAsByteArrayAsync(ct);
+    }
+}
+```
+
+---
+
+## Startup Warning
+
+```csharp
+public class SimulationWarningStartupFilter : IStartupFilter
+{
+    private readonly ILogger<SimulationWarningStartupFilter> _logger;
+
+    public SimulationWarningStartupFilter(ILogger<SimulationWarningStartupFilter> logger)
+    {
+        _logger = logger;
+    }
+
+    public Action<IApplicationBuilder> Configure(Action<IApplicationBuilder> next)
+    {
+        _logger.LogWarning(
+            "⚠️ SIMULATION MODE ENABLED - External services are being simulated!");
+
+        return next;
+    }
+}
+```
+
+---
+
+## Dependency Trace Template
+
+Antes de implementar, preencher este trace:
+
+```markdown
+## Dependency Trace para Simulacao
+
+### Feature: {Nome da Feature}
+
+### Fluxo Principal:
+1. Controller/Page chama {ServiceA}
+2. {ServiceA} chama {IExternalClient}
+3. {IExternalClient} retorna dados
+4. {ServiceA} chama {IDependenciaTransitiva} ← NAO ESQUECER!
+
+### Servicos a Mockar:
+| Interface | Fake | Lifetime | Motivo |
+|-----------|------|----------|--------|
+| IReplicateClient | FakeReplicateClient | Singleton | Stateful (Dictionary) |
+| IEmailClient | FakeEmailClient | Scoped | Stateless |
+| IImageDownloader | FakeImageDownloader | Scoped | Stateless |
+
+### Checklist:
+- [ ] Todas as interfaces mapeadas
+- [ ] Lifetimes definidos corretamente
+- [ ] Dependencias transitivas identificadas
+- [ ] Assinaturas de metodos verificadas
+- [ ] Prompts/payloads atuais lidos (se IA)
+```
+
+---
+
+## Checklist Rapido
+
+```markdown
+### Pre-Implementacao:
+- [ ] Listar TODAS as interfaces envolvidas no fluxo
+- [ ] Verificar dependencias transitivas (DI graph)
+- [ ] Ler assinaturas COMPLETAS das interfaces
+- [ ] Verificar lifetimes necessarios (Singleton vs Scoped)
+
+### Para mocks de IA:
+- [ ] Ler prompts/payloads ATUAIS do codigo
+- [ ] Verificar formato de response da API real
+- [ ] Testar com dados reais primeiro (1 chamada) antes de mockar
+
+### Para mocks de Email:
+- [ ] Verificar se ha attachments/inline images
+- [ ] Testar renderizacao do template separadamente
+
+### Pos-Implementacao:
+- [ ] Build passa: `dotnet build`
+- [ ] DI valido: `dotnet run` sem erros
+- [ ] Fluxo funciona em modo simulacao
+```
+
+---
+
+*MORPH-SPEC Simulation Template*