@polymorphism-tech/morph-spec 4.7.1 → 4.7.2

package/.morph/framework/templates/code/dotnet/jobs/agent.cs

@@ -0,0 +1,163 @@
+// ============================================================
+// MICROSOFT AGENT FRAMEWORK TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using System.ComponentModel;
+using System.Text.Json;
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using Microsoft.Extensions.Logging;
+
+namespace {{NAMESPACE}}.Agents.{{pascalCase FEATURE_NAME}};
+
+/// <summary>
+/// AI Agent for analyzing {{pascalCase FEATURE_NAME}} data.
+/// Uses Microsoft Agent Framework with IChatClient (gpt-4o-mini by default).
+/// </summary>
+public class {{pascalCase FEATURE_NAME}}AnalyzerAgent(
+    IChatClient chatClient,
+    ILogger<{{pascalCase FEATURE_NAME}}AnalyzerAgent> logger) : I{{pascalCase FEATURE_NAME}}AnalyzerAgent
+{
+    /// <inheritdoc />
+    public async Task<{{pascalCase FEATURE_NAME}}AnalysisResult> AnalyzeAsync(
+        {{pascalCase FEATURE_NAME}}Data data,
+        CancellationToken cancellationToken = default)
+    {
+        logger.LogInformation("Starting {{pascalCase FEATURE_NAME}} analysis for: {Content}",
+            data.Content.Length > 100 ? data.Content[..100] + "..." : data.Content);
+
+        var agent = new ChatClientAgent(
+            chatClient,
+            new ChatClientAgentOptions
+            {
+                Name = "{{pascalCase FEATURE_NAME}}Analyzer",
+                Instructions = """
+                    You are an expert analyst for {{pascalCase FEATURE_NAME}} data.
+
+                    Analyze the provided data and return a JSON object with:
+                    - summary: Brief summary (1-2 sentences)
+                    - insights: Array of at least 2 insights
+                    - recommendations: Array of at least 1 recommendation
+                    - confidenceScore: Number between 0 and 1
+
+                    Respond ONLY with valid JSON, no additional text.
+                    """,
+                ChatOptions = new ChatOptions
+                {
+                    Tools =
+                    [
+                        AIFunctionFactory.Create(GetContextAsync),
+                        AIFunctionFactory.Create(GetMetricsAsync)
+                    ]
+                }
+            });
+
+        var response = await agent.RunAsync(
+            $"Analyze this data:\n{data.Content}",
+            cancellationToken: cancellationToken);
+
+        var result = ParseResponse(response.Text);
+
+        logger.LogInformation(
+            "Analysis completed. Confidence: {Confidence:P0}",
+            result.ConfidenceScore);
+
+        return result;
+    }
+
+    #region Tools
+
+    [Description("Gets additional context for the analysis")]
+    private async Task<string> GetContextAsync(
+        [Description("What context is needed")] string query,
+        CancellationToken ct = default)
+    {
+        // TODO: Implement context retrieval (e.g., from database or search)
+        await Task.CompletedTask;
+        return $"Context for: {query}";
+    }
+
+    [Description("Gets relevant metrics for the analysis")]
+    private async Task<string> GetMetricsAsync(
+        [Description("Metric type to retrieve")] string metricType,
+        CancellationToken ct = default)
+    {
+        // TODO: Implement metrics retrieval
+        await Task.CompletedTask;
+        return $"Metrics for: {metricType}";
+    }
+
+    #endregion
+
+    #region Response Parsing
+
+    private {{pascalCase FEATURE_NAME}}AnalysisResult ParseResponse(string response)
+    {
+        try
+        {
+            var json = response
+                .Replace("```json", "")
+                .Replace("```", "")
+                .Trim();
+
+            var parsed = JsonSerializer.Deserialize<AnalysisResponse>(json,
+                new JsonSerializerOptions { PropertyNameCaseInsensitive = true });
+
+            if (parsed is null)
+                throw new {{pascalCase FEATURE_NAME}}ProcessingException("Failed to parse analysis response");
+
+            return new {{pascalCase FEATURE_NAME}}AnalysisResult(
+                parsed.Summary ?? "Analysis completed",
+                parsed.Insights ?? [],
+                parsed.Recommendations ?? [],
+                parsed.ConfidenceScore);
+        }
+        catch (JsonException ex)
+        {
+            logger.LogError(ex, "Failed to parse AI response: {Response}", response);
+            throw new {{pascalCase FEATURE_NAME}}ProcessingException("Failed to parse analysis response", ex);
+        }
+    }
+
+    private class AnalysisResponse
+    {
+        public string? Summary { get; set; }
+        public List<string>? Insights { get; set; }
+        public List<string>? Recommendations { get; set; }
+        public double ConfidenceScore { get; set; }
+    }
+
+    #endregion
+}
+
+// ============================================================
+// DEPENDENCY INJECTION SETUP
+// ============================================================
+//
+// In Program.cs:
+//
+// // Register IChatClient (Azure OpenAI with Managed Identity)
+// builder.Services.AddSingleton<IChatClient>(sp =>
+// {
+//     var cfg = sp.GetRequiredService<IConfiguration>();
+//     return new AzureOpenAIClient(
+//             new Uri(cfg["AzureOpenAI:Endpoint"]!),
+//             new DefaultAzureCredential())
+//         .GetChatClient(cfg["AzureOpenAI:DeploymentName"] ?? "gpt-4o-mini")
+//         .AsIChatClient();
+// });
+//
+// // Option A: Register as scoped service
+// builder.Services.AddScoped<I{{pascalCase FEATURE_NAME}}AnalyzerAgent, {{pascalCase FEATURE_NAME}}AnalyzerAgent>();
+//
+// // Option B: Register as keyed agent (recommended for multiple agents)
+// builder.AddAIAgent("{{pascalCase FEATURE_NAME}}Analyzer", (sp, key) =>
+// {
+//     var chatClient = sp.GetRequiredService<IChatClient>();
+//     return new ChatClientAgent(chatClient,
+//         name: key,
+//         instructions: "You are an expert {{pascalCase FEATURE_NAME}} analyst.");
+// });
+//
+// ============================================================

package/.morph/framework/templates/code/dotnet/jobs/job.cs

@@ -0,0 +1,171 @@
+// ============================================================
+// HANGFIRE JOB TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using Hangfire;
+using Microsoft.Extensions.Logging;
+
+namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Jobs;
+
+/// <summary>
+/// Background job for processing {{pascalCase FEATURE_NAME}}.
+/// Uses Hangfire for scheduling and retry handling.
+/// </summary>
+public class {{pascalCase FEATURE_NAME}}ProcessorJob(
+    I{{pascalCase FEATURE_NAME}}Service service,
+    I{{pascalCase FEATURE_NAME}}AnalyzerAgent analyzer,
+    ILogger<{{pascalCase FEATURE_NAME}}ProcessorJob> logger) : I{{pascalCase FEATURE_NAME}}ProcessorJob
+{
+    /// <summary>
+    /// Executes the {{pascalCase FEATURE_NAME}} processing job.
+    /// </summary>
+    /// <param name="id">The {{pascalCase FEATURE_NAME}} ID to process</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]
+    [Queue("default")]
+    [JobDisplayName("{{pascalCase FEATURE_NAME}} Processing - ID: {0}")]
+    public async Task ExecuteAsync(int id, CancellationToken cancellationToken)
+    {
+        logger.LogInformation("Starting {{pascalCase FEATURE_NAME}} processing for ID {Id}", id);
+
+        try
+        {
+            // Get the entity
+            var item = await service.GetByIdAsync(id, cancellationToken);
+            if (item is null)
+            {
+                logger.LogWarning("{{pascalCase FEATURE_NAME}} with ID {Id} not found, skipping", id);
+                return;
+            }
+
+            // Check if already processed
+            if (item.Status == {{pascalCase FEATURE_NAME}}Status.Completed)
+            {
+                logger.LogInformation("{{pascalCase FEATURE_NAME}} {Id} already completed, skipping", id);
+                return;
+            }
+
+            // Perform analysis (if applicable)
+            var analysisData = new {{pascalCase FEATURE_NAME}}Data(item.Name);
+            var analysis = await analyzer.AnalyzeAsync(analysisData, cancellationToken);
+
+            logger.LogInformation(
+                "{{pascalCase FEATURE_NAME}} {Id} analyzed. Confidence: {Confidence:P0}",
+                id, analysis.ConfidenceScore);
+
+            // Update status
+            // Note: You might need to add a method to update with analysis results
+            // await service.CompleteWithAnalysisAsync(id, analysis, cancellationToken);
+
+            logger.LogInformation("Completed {{pascalCase FEATURE_NAME}} processing for ID {Id}", id);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "Failed to process {{pascalCase FEATURE_NAME}} {Id}", id);
+            throw; // Re-throw to trigger Hangfire retry
+        }
+    }
+}
+
+// ============================================================
+// RECURRING JOB CONFIGURATION
+// ============================================================
+//
+// For scheduled/recurring jobs, configure in Program.cs:
+//
+// // Run every hour
+// RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
+//     "{{kebabCase FEATURE_NAME}}-processor",
+//     job => job.ExecuteAsync(0, CancellationToken.None),
+//     Cron.Hourly);
+//
+// // Run daily at midnight
+// RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
+//     "{{kebabCase FEATURE_NAME}}-daily-processor",
+//     job => job.ExecuteAsync(0, CancellationToken.None),
+//     Cron.Daily);
+//
+// // Custom cron expression (every 15 minutes)
+// RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
+//     "{{kebabCase FEATURE_NAME}}-frequent-processor",
+//     job => job.ExecuteAsync(0, CancellationToken.None),
+//     "*/15 * * * *");
+//
+// ============================================================
+
+// ============================================================
+// BATCH JOB TEMPLATE
+// ============================================================
+
+/// <summary>
+/// Batch job for processing multiple {{pascalCase FEATURE_NAME}}s.
+/// </summary>
+public class {{pascalCase FEATURE_NAME}}BatchProcessorJob(
+    I{{pascalCase FEATURE_NAME}}Service service,
+    I{{pascalCase FEATURE_NAME}}ProcessorJob itemProcessor,
+    ILogger<{{pascalCase FEATURE_NAME}}BatchProcessorJob> logger)
+{
+    /// <summary>
+    /// Processes all pending {{pascalCase FEATURE_NAME}}s.
+    /// </summary>
+    [AutomaticRetry(Attempts = 1)]
+    [Queue("batch")]
+    [JobDisplayName("{{pascalCase FEATURE_NAME}} Batch Processing")]
+    public async Task ProcessAllPendingAsync(CancellationToken cancellationToken)
+    {
+        logger.LogInformation("Starting batch processing for pending {{pascalCase FEATURE_NAME}}s");
+
+        var items = await service.GetAllAsync(cancellationToken);
+        var pending = items.Where(x => x.Status == {{pascalCase FEATURE_NAME}}Status.Pending).ToList();
+
+        logger.LogInformation("Found {Count} pending {{pascalCase FEATURE_NAME}}s to process", pending.Count);
+
+        foreach (var item in pending)
+        {
+            // Enqueue individual processing jobs
+            BackgroundJob.Enqueue<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
+                job => job.ExecuteAsync(item.Id, CancellationToken.None));
+        }
+
+        logger.LogInformation("Enqueued {Count} processing jobs", pending.Count);
+    }
+}
+
+// ============================================================
+// HANGFIRE CONFIGURATION
+// ============================================================
+//
+// In Program.cs:
+//
+// // Add Hangfire services
+// builder.Services.AddHangfire(config => config
+//     .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
+//     .UseSimpleAssemblyNameTypeSerializer()
+//     .UseRecommendedSerializerSettings()
+//     .UseSqlServerStorage(connectionString, new SqlServerStorageOptions
+//     {
+//         CommandBatchMaxTimeout = TimeSpan.FromMinutes(5),
+//         SlidingInvisibilityTimeout = TimeSpan.FromMinutes(5),
+//         QueuePollInterval = TimeSpan.Zero,
+//         UseRecommendedIsolationLevel = true,
+//         DisableGlobalLocks = true
+//     }));
+//
+// builder.Services.AddHangfireServer(options =>
+// {
+//     options.Queues = new[] { "default", "batch" };
+//     options.WorkerCount = Environment.ProcessorCount * 2;
+// });
+//
+// // Register jobs
+// builder.Services.AddScoped<I{{pascalCase FEATURE_NAME}}ProcessorJob, {{pascalCase FEATURE_NAME}}ProcessorJob>();
+// builder.Services.AddScoped<{{pascalCase FEATURE_NAME}}BatchProcessorJob>();
+//
+// // In app pipeline
+// app.UseHangfireDashboard("/hangfire", new DashboardOptions
+// {
+//     Authorization = new[] { new HangfireAuthorizationFilter() }
+// });
+//
+// ============================================================

package/.morph/framework/templates/code/dotnet/test.cs

@@ -0,0 +1,239 @@
+// ============================================================
+// TEST TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using FluentAssertions;
+using Microsoft.Extensions.Logging;
+using NSubstitute;
+using Xunit;
+
+namespace {{NAMESPACE}}.Tests.Unit.Features.{{pascalCase FEATURE_NAME}};
+
+/// <summary>
+/// Unit tests for {{pascalCase FEATURE_NAME}}Service.
+/// </summary>
+public class {{pascalCase FEATURE_NAME}}ServiceTests
+{
+    private readonly I{{pascalCase FEATURE_NAME}}Repository _repository;
+    private readonly ILogger<{{pascalCase FEATURE_NAME}}Service> _logger;
+    private readonly {{pascalCase FEATURE_NAME}}Service _sut;
+
+    public {{pascalCase FEATURE_NAME}}ServiceTests()
+    {
+        _repository = Substitute.For<I{{pascalCase FEATURE_NAME}}Repository>();
+        _logger = Substitute.For<ILogger<{{pascalCase FEATURE_NAME}}Service>>();
+        _sut = new {{pascalCase FEATURE_NAME}}Service(_repository, _logger);
+    }
+
+    #region GetByIdAsync Tests
+
+    [Fact]
+    public async Task GetByIdAsync_WithValidId_ReturnsDto()
+    {
+        // Arrange
+        var id = 1;
+        var entity = CreateTestEntity(id, "Test {{pascalCase FEATURE_NAME}}");
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns(entity);
+
+        // Act
+        var result = await _sut.GetByIdAsync(id);
+
+        // Assert
+        result.Should().NotBeNull();
+        result!.Id.Should().Be(id);
+        result.Name.Should().Be("Test {{pascalCase FEATURE_NAME}}");
+    }
+
+    [Fact]
+    public async Task GetByIdAsync_WithInvalidId_ReturnsNull()
+    {
+        // Arrange
+        var id = 999;
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns((Domain.Entities.{{pascalCase FEATURE_NAME}}?)null);
+
+        // Act
+        var result = await _sut.GetByIdAsync(id);
+
+        // Assert
+        result.Should().BeNull();
+    }
+
+    #endregion
+
+    #region GetAllAsync Tests
+
+    [Fact]
+    public async Task GetAllAsync_ReturnsAllItems()
+    {
+        // Arrange
+        var entities = new List<Domain.Entities.{{pascalCase FEATURE_NAME}}>
+        {
+            CreateTestEntity(1, "First"),
+            CreateTestEntity(2, "Second"),
+            CreateTestEntity(3, "Third")
+        };
+        _repository.GetAllAsync(Arg.Any<CancellationToken>())
+            .Returns(entities);
+
+        // Act
+        var result = await _sut.GetAllAsync();
+
+        // Assert
+        result.Should().HaveCount(3);
+        result[0].Name.Should().Be("First");
+    }
+
+    [Fact]
+    public async Task GetAllAsync_WithNoItems_ReturnsEmptyList()
+    {
+        // Arrange
+        _repository.GetAllAsync(Arg.Any<CancellationToken>())
+            .Returns(new List<Domain.Entities.{{pascalCase FEATURE_NAME}}>());
+
+        // Act
+        var result = await _sut.GetAllAsync();
+
+        // Assert
+        result.Should().BeEmpty();
+    }
+
+    #endregion
+
+    #region CreateAsync Tests
+
+    [Fact]
+    public async Task CreateAsync_WithValidRequest_CreatesAndReturnsDto()
+    {
+        // Arrange
+        var request = new Create{{pascalCase FEATURE_NAME}}Request("New {{pascalCase FEATURE_NAME}}");
+
+        _repository
+            .When(x => x.AddAsync(Arg.Any<Domain.Entities.{{pascalCase FEATURE_NAME}}>(), Arg.Any<CancellationToken>()))
+            .Do(x =>
+            {
+                // Simulate ID assignment
+                var entity = x.Arg<Domain.Entities.{{pascalCase FEATURE_NAME}}>();
+                // entity.Id would be set by EF Core
+            });
+
+        // Act
+        var result = await _sut.CreateAsync(request);
+
+        // Assert
+        result.Should().NotBeNull();
+        result.Name.Should().Be("New {{pascalCase FEATURE_NAME}}");
+
+        await _repository.Received(1).AddAsync(Arg.Any<Domain.Entities.{{pascalCase FEATURE_NAME}}>(), Arg.Any<CancellationToken>());
+        await _repository.Received(1).SaveChangesAsync(Arg.Any<CancellationToken>());
+    }
+
+    [Theory]
+    [InlineData("")]
+    [InlineData(" ")]
+    [InlineData(null)]
+    public async Task CreateAsync_WithInvalidName_ThrowsValidationException(string? name)
+    {
+        // Arrange
+        var request = new Create{{pascalCase FEATURE_NAME}}Request(name!);
+
+        // Act
+        var act = async () => await _sut.CreateAsync(request);
+
+        // Assert
+        await act.Should().ThrowAsync<ValidationException>();
+    }
+
+    #endregion
+
+    #region UpdateAsync Tests
+
+    [Fact]
+    public async Task UpdateAsync_WithValidRequest_UpdatesEntity()
+    {
+        // Arrange
+        var id = 1;
+        var entity = CreateTestEntity(id, "Original");
+        var request = new Update{{pascalCase FEATURE_NAME}}Request("Updated");
+
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns(entity);
+
+        // Act
+        await _sut.UpdateAsync(id, request);
+
+        // Assert
+        _repository.Received(1).Update(Arg.Any<Domain.Entities.{{pascalCase FEATURE_NAME}}>());
+        await _repository.Received(1).SaveChangesAsync(Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task UpdateAsync_WithNonExistentId_ThrowsNotFoundException()
+    {
+        // Arrange
+        var id = 999;
+        var request = new Update{{pascalCase FEATURE_NAME}}Request("Updated");
+
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns((Domain.Entities.{{pascalCase FEATURE_NAME}}?)null);
+
+        // Act
+        var act = async () => await _sut.UpdateAsync(id, request);
+
+        // Assert
+        await act.Should().ThrowAsync<{{pascalCase FEATURE_NAME}}NotFoundException>();
+    }
+
+    #endregion
+
+    #region DeleteAsync Tests
+
+    [Fact]
+    public async Task DeleteAsync_WithValidId_DeletesEntity()
+    {
+        // Arrange
+        var id = 1;
+        var entity = CreateTestEntity(id, "To Delete");
+
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns(entity);
+
+        // Act
+        await _sut.DeleteAsync(id);
+
+        // Assert
+        _repository.Received(1).Remove(entity);
+        await _repository.Received(1).SaveChangesAsync(Arg.Any<CancellationToken>());
+    }
+
+    [Fact]
+    public async Task DeleteAsync_WithNonExistentId_ThrowsNotFoundException()
+    {
+        // Arrange
+        var id = 999;
+
+        _repository.GetByIdAsync(id, Arg.Any<CancellationToken>())
+            .Returns((Domain.Entities.{{pascalCase FEATURE_NAME}}?)null);
+
+        // Act
+        var act = async () => await _sut.DeleteAsync(id);
+
+        // Assert
+        await act.Should().ThrowAsync<{{pascalCase FEATURE_NAME}}NotFoundException>();
+    }
+
+    #endregion
+
+    #region Helper Methods
+
+    private static Domain.Entities.{{pascalCase FEATURE_NAME}} CreateTestEntity(int id, string name)
+    {
+        return Domain.Entities.{{pascalCase FEATURE_NAME}}.Create(name);
+        // Note: In real tests, you might need reflection to set the Id
+        // or use a factory method that accepts an id for testing
+    }
+
+    #endregion
+}

package/.morph/framework/templates/code/sql/rls-policy.sql

@@ -0,0 +1,57 @@
+-- ============================================================
+-- RLS Policy: {{titleCase FEATURE_NAME}}
+-- Stack: Next.js + Supabase
+-- Generated by MORPH Framework
+-- Date: {{DATE}}
+-- ============================================================
+
+-- Enable RLS on table
+alter table public.{{TABLE_NAME}} enable row level security;
+
+-- Force RLS for table owner (prevents bypassing)
+alter table public.{{TABLE_NAME}} force row level security;
+
+-- Policy: {{POLICY_NAME}}
+-- Operation: {{OPERATION}} (SELECT | INSERT | UPDATE | DELETE | ALL)
+
+-- SELECT policy: users can read their own rows
+create policy "{{POLICY_NAME}}_select"
+  on public.{{TABLE_NAME}}
+  for select
+  using ({{USING_EXPRESSION}});
+
+-- INSERT policy: users can insert rows for themselves
+create policy "{{POLICY_NAME}}_insert"
+  on public.{{TABLE_NAME}}
+  for insert
+  with check ({{WITH_CHECK_EXPRESSION}});
+
+-- UPDATE policy: users can update their own rows
+create policy "{{POLICY_NAME}}_update"
+  on public.{{TABLE_NAME}}
+  for update
+  using ({{USING_EXPRESSION}})
+  with check ({{WITH_CHECK_EXPRESSION}});
+
+-- DELETE policy: users can delete their own rows
+create policy "{{POLICY_NAME}}_delete"
+  on public.{{TABLE_NAME}}
+  for delete
+  using ({{USING_EXPRESSION}});
+
+-- ============================================================
+-- Common USING / WITH CHECK expressions:
+--
+-- Owner-based:
+--   auth.uid() = user_id
+--
+-- Role-based:
+--   auth.jwt() ->> 'role' = 'admin'
+--
+-- Organization-based:
+--   org_id in (select org_id from public.org_members where user_id = auth.uid())
+--
+-- Public read, owner write:
+--   SELECT using (true)
+--   INSERT/UPDATE/DELETE using (auth.uid() = user_id)
+-- ============================================================