@polymorphism-tech/morph-spec 4.7.2 → 4.8.1

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

@@ -1,163 +0,0 @@
-// ============================================================
-// 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

@@ -1,171 +0,0 @@
-// ============================================================
-// 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

@@ -1,239 +0,0 @@
-// ============================================================
-// 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

@@ -1,57 +0,0 @@
--- ============================================================
--- 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)
--- ============================================================