@polymorphism-tech/morph-spec 3.2.0 → 4.2.0

package/stacks/blazor-azure/.morph/templates/simulation.md

@@ -1,353 +0,0 @@
-# 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*

package/stacks/blazor-azure/.morph/templates/spec.md

@@ -1,149 +0,0 @@
-# Feature Specification: {{FEATURE_NAME_TITLE}}
-
-| Field | Value |
-|-------|-------|
-| **ID** | {{FEATURE_NAME}} |
-| **Status** | Draft / In Review / Approved / In Progress / Done |
-| **Created** | {{DATE}} |
-| **Stack** | {{STACK}} |
-| **Complexity** | Low / Medium / High |
-| **Estimated Cost** | $X/month |
-| **Agents** | Core: All / Specialists: {list} |
-
----
-
-## Overview
-
-**Problem:** {What problem this feature solves}
-
-**Solution:** {High-level solution}
-
-**Success Criteria:**
-- [ ] {Criterion 1}
-- [ ] {Criterion 2}
-
----
-
-## Requirements
-
-**Functional:** FR1: {desc} | FR2: {desc} | FR3: {desc}
-
-**Non-Functional:** NFR1: Performance - {target} | NFR2: Reliability - {target}
-
----
-
-## User Stories
-
-### US001: {Title}
-**As** {user type} **I want** {feature} **so that** {benefit}
-
-**Acceptance Criteria:** 1. {criterion} 2. {criterion}
-
-**Edge Cases:** {edge case}: {handling}
-
----
-
-## Technical Design
-
-### Stack
-| Component | Technology |
-|-----------|------------|
-| Frontend | {Blazor Server / Next.js} |
-| Backend | .NET 10 / C# 14 |
-| Database | {Azure SQL / Cosmos DB} |
-
-### Data Model
-
-#### {EntityName}
-| Column | Type | Constraints |
-|--------|------|-------------|
-| Id | Guid | PK |
-| {Property} | {Type} | {Constraints} |
-| CreatedAt | datetime2 | Default: GETUTCDATE() |
-
-### Contracts
-
-> **Ref:** `framework/standards/blazor-efcore.md` for background operations
-
-```csharp
-public interface I{{FEATURE_NAME_PASCAL}}Service
-{
-    Task<{{FEATURE_NAME_PASCAL}}Dto> GetByIdAsync(int id);
-    Task<{{FEATURE_NAME_PASCAL}}Dto> CreateAsync(Create{{FEATURE_NAME_PASCAL}}Request request);
-}
-```
-
-**Contracts Workflow:** Generate `contracts.cs` FIRST → validate names → reference in spec → approve with user.
-
-**Validation Checklist:**
-- [ ] Property names are descriptive (not generic "Data", "Value")
-- [ ] Records use correct types (Stream vs byte[], Guid vs string)
-- [ ] Response DTOs have all properties needed for UI
-- [ ] Request DTOs have implicit validations (required, nullable)
-
----
-
-## UI/UX Design (if front-end)
-
-### Wireframes
-```
-{ASCII wireframe per screen - include states: loading, error, empty}
-```
-
-### User Flow
-1. {Step} → {System response}
-
----
-
-## Flows
-
-### {Flow Name}
-**Trigger:** {what starts this flow}
-1. {Actor} {action} → {system response}
-2. If {condition}: Path A / Else: Path B
-**End State:** {final state}
-
----
-
-## Cost Estimate
-
-| Resource | SKU | Monthly Cost | Justification |
-|----------|-----|--------------|---------------|
-| {Resource} | {SKU} | ${X} | {Why} |
-| **Total** | | **${X}/month** | |
-
----
-
-## ADRs (Architectural Decision Records)
-
-### ADR-001: {Decision Title}
-**Status:** Proposed / Accepted
-**Context:** {Why decide now}
-**Decision:** {What we chose}
-**Alternatives:** 1. {Alt} (pros/cons) 2. {Alt} (pros/cons)
-**Trade-offs:** {key trade-offs}
-
----
-
-## Security
-
-| Action | Required Policy |
-|--------|-----------------|
-| View | CanView{Feature} |
-| Create | CanManage{Feature} |
-
-## Risks
-
-| Risk | Impact | Mitigation |
-|------|--------|------------|
-| {Risk} | {H/M/L} | {Mitigation} |
-
-## Out of Scope
-- {Item}
-
-## Definition of Done
-- [ ] Code implemented
-- [ ] Tests >80% coverage
-- [ ] Code review approved
-- [ ] Deploy to staging
-- [ ] Recap.md generated

package/stacks/blazor-azure/.morph/templates/sprint-status.yaml

@@ -1,68 +0,0 @@
-# MORPH-SPEC Sprint Status
-# Auto-updated by create-story.js and update-sprint-status.js
-# Tracks story-level progress within a feature/epic
-
-feature: {{FEATURE_NAME}}
-epic: {{EPIC_NAME}}
-sprint: {{SPRINT_NUMBER}}
-created: {{DATE}}
-updated: {{DATE}}
-
-# Story progression
-stories:
-  - id: {{STORY_ID_1}}
-    title: {{STORY_TITLE_1}}
-    file: .morph/project/outputs/{{FEATURE_NAME}}/stories/{{STORY_ID_1}}.md
-    status: ready           # ready | in_progress | ready_for_qa | done
-    assigned: {{AGENT}}     # sm | dev | qa
-    created: {{DATE}}
-    started: null
-    completed: null
-
-  - id: {{STORY_ID_2}}
-    title: {{STORY_TITLE_2}}
-    file: .morph/project/outputs/{{FEATURE_NAME}}/stories/{{STORY_ID_2}}.md
-    status: pending
-    assigned: sm
-    created: {{DATE}}
-    started: null
-    completed: null
-
-# Progress metrics
-metrics:
-  total_stories: {{TOTAL_STORIES}}
-  ready: {{READY_COUNT}}
-  in_progress: {{IN_PROGRESS_COUNT}}
-  ready_for_qa: {{QA_COUNT}}
-  done: {{DONE_COUNT}}
-  completion_percent: {{COMPLETION_PERCENT}}
-
-# Current focus
-current:
-  story_id: {{CURRENT_STORY_ID}}
-  agent: {{CURRENT_AGENT}}
-  phase: implementation  # planning | implementation | review
-
-# Next story to work on
-next:
-  story_id: {{NEXT_STORY_ID}}
-  recommendation: "Story {{NEXT_STORY_ID}} is ready for development"
-
----
-# Usage Notes:
-#
-# Status Transitions:
-# pending → ready (SM creates story with full context)
-# ready → in_progress (Dev starts implementation)
-# in_progress → ready_for_qa (Dev completes, adds Dev Notes)
-# ready_for_qa → done (QA approves, adds QA Notes)
-#
-# Fresh Chat Pattern (BMAD-inspired):
-# Each story should run in a FRESH Claude session to avoid context pollution
-#
-# Example workflow:
-# 1. SM: node bin/create-story.js scheduled-reports SR-001
-# 2. Dev: Open NEW chat → /dev → Implement SR-001
-# 3. QA: Open NEW chat → /qa → Review SR-001
-#
-# This prevents token bloat and reduces hallucinations