@polymorphism-tech/morph-spec 4.3.3 → 4.3.4

package/framework/templates/code/dotnet/frontend/component.razor

@@ -0,0 +1,239 @@
+@* ============================================================
+   BLAZOR COMPONENT TEMPLATE
+   Generated by MORPH Framework
+   ============================================================ *@
+
+@page "/{{kebabCase FEATURE_NAME}}/{{kebabCase FEATURE_NAME}}s"
+@attribute [Authorize(Policy = "CanView{{pascalCase FEATURE_NAME}}")]
+@inject I{{pascalCase FEATURE_NAME}}Service {{pascalCase FEATURE_NAME}}Service
+@inject ILogger<{{pascalCase FEATURE_NAME}}List> Logger
+@inject NavigationManager Navigation
+
+<PageTitle>{{pascalCase FEATURE_NAME}}s</PageTitle>
+
+<div class="container-fluid">
+    <div class="row mb-4">
+        <div class="col">
+            <h1>{{pascalCase FEATURE_NAME}}s</h1>
+        </div>
+        <div class="col-auto">
+            <AuthorizeView Policy="CanManage{{pascalCase FEATURE_NAME}}">
+                <button class="btn btn-primary" @onclick="ShowCreateModal">
+                    <i class="bi bi-plus-lg"></i> New {{pascalCase FEATURE_NAME}}
+                </button>
+            </AuthorizeView>
+        </div>
+    </div>
+
+    @if (_isLoading)
+    {
+        <div class="d-flex justify-content-center py-5">
+            <div class="spinner-border text-primary" role="status">
+                <span class="visually-hidden">Loading...</span>
+            </div>
+        </div>
+    }
+    else if (_error is not null)
+    {
+        <div class="alert alert-danger" role="alert">
+            <i class="bi bi-exclamation-triangle"></i>
+            @_error
+            <button class="btn btn-link" @onclick="LoadDataAsync">Retry</button>
+        </div>
+    }
+    else if (_items is null || !_items.Any())
+    {
+        <div class="text-center py-5">
+            <i class="bi bi-inbox display-1 text-muted"></i>
+            <p class="lead mt-3">No {{kebabCase FEATURE_NAME}}s found</p>
+            <AuthorizeView Policy="CanManage{{pascalCase FEATURE_NAME}}">
+                <button class="btn btn-primary" @onclick="ShowCreateModal">
+                    Create your first {{kebabCase FEATURE_NAME}}
+                </button>
+            </AuthorizeView>
+        </div>
+    }
+    else
+    {
+        <div class="row row-cols-1 row-cols-md-2 row-cols-lg-3 g-4">
+            @foreach (var item in _items)
+            {
+                <div class="col">
+                    <div class="card h-100">
+                        <div class="card-body">
+                            <h5 class="card-title">@item.Name</h5>
+                            <p class="card-text">
+                                <span class="badge @GetStatusBadgeClass(item.Status)">
+                                    @item.Status
+                                </span>
+                            </p>
+                        </div>
+                        <div class="card-footer bg-transparent">
+                            <small class="text-muted">
+                                Created @item.CreatedAt.ToString("d")
+                            </small>
+                            <AuthorizeView Policy="CanManage{{pascalCase FEATURE_NAME}}">
+                                <div class="float-end">
+                                    <button class="btn btn-sm btn-outline-primary"
+                                            @onclick="() => ShowEditModal(item)">
+                                        Edit
+                                    </button>
+                                </div>
+                            </AuthorizeView>
+                        </div>
+                    </div>
+                </div>
+            }
+        </div>
+    }
+</div>
+
+@* Modal for Create/Edit *@
+@if (_showModal)
+{
+    <div class="modal fade show d-block" tabindex="-1" style="background: rgba(0,0,0,0.5)">
+        <div class="modal-dialog">
+            <div class="modal-content">
+                <div class="modal-header">
+                    <h5 class="modal-title">
+                        @(_editingItem is null ? "New {{pascalCase FEATURE_NAME}}" : "Edit {{pascalCase FEATURE_NAME}}")
+                    </h5>
+                    <button type="button" class="btn-close" @onclick="CloseModal"></button>
+                </div>
+                <EditForm Model="_formModel" OnValidSubmit="HandleSubmitAsync">
+                    <DataAnnotationsValidator />
+                    <div class="modal-body">
+                        <div class="mb-3">
+                            <label class="form-label">Name</label>
+                            <InputText class="form-control" @bind-Value="_formModel.Name" />
+                            <ValidationMessage For="() => _formModel.Name" />
+                        </div>
+                        @* Add more fields as needed *@
+                    </div>
+                    <div class="modal-footer">
+                        <button type="button" class="btn btn-secondary" @onclick="CloseModal">
+                            Cancel
+                        </button>
+                        <button type="submit" class="btn btn-primary" disabled="@_isSaving">
+                            @if (_isSaving)
+                            {
+                                <span class="spinner-border spinner-border-sm"></span>
+                            }
+                            Save
+                        </button>
+                    </div>
+                </EditForm>
+            </div>
+        </div>
+    </div>
+}
+
+@code {
+    private List<{{pascalCase FEATURE_NAME}}Dto>? _items;
+    private bool _isLoading = true;
+    private bool _showModal;
+    private bool _isSaving;
+    private string? _error;
+    private {{pascalCase FEATURE_NAME}}Dto? _editingItem;
+    private {{pascalCase FEATURE_NAME}}FormModel _formModel = new();
+
+    protected override async Task OnInitializedAsync()
+    {
+        await LoadDataAsync();
+    }
+
+    private async Task LoadDataAsync()
+    {
+        _isLoading = true;
+        _error = null;
+
+        try
+        {
+            _items = await {{pascalCase FEATURE_NAME}}Service.GetAllAsync();
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Failed to load {{kebabCase FEATURE_NAME}}s");
+            _error = "Failed to load data. Please try again.";
+        }
+        finally
+        {
+            _isLoading = false;
+        }
+    }
+
+    private void ShowCreateModal()
+    {
+        _editingItem = null;
+        _formModel = new {{pascalCase FEATURE_NAME}}FormModel();
+        _showModal = true;
+    }
+
+    private void ShowEditModal({{pascalCase FEATURE_NAME}}Dto item)
+    {
+        _editingItem = item;
+        _formModel = new {{pascalCase FEATURE_NAME}}FormModel
+        {
+            Name = item.Name
+            // Map other fields
+        };
+        _showModal = true;
+    }
+
+    private void CloseModal()
+    {
+        _showModal = false;
+        _formModel = new();
+    }
+
+    private async Task HandleSubmitAsync()
+    {
+        _isSaving = true;
+
+        try
+        {
+            if (_editingItem is null)
+            {
+                // Create
+                var request = new Create{{pascalCase FEATURE_NAME}}Request(_formModel.Name);
+                await {{pascalCase FEATURE_NAME}}Service.CreateAsync(request);
+            }
+            else
+            {
+                // Update
+                var request = new Update{{pascalCase FEATURE_NAME}}Request(_formModel.Name);
+                await {{pascalCase FEATURE_NAME}}Service.UpdateAsync(_editingItem.Id, request);
+            }
+
+            CloseModal();
+            await LoadDataAsync();
+        }
+        catch (Exception ex)
+        {
+            Logger.LogError(ex, "Failed to save {{kebabCase FEATURE_NAME}}");
+            // Show error to user
+        }
+        finally
+        {
+            _isSaving = false;
+        }
+    }
+
+    private static string GetStatusBadgeClass({{pascalCase FEATURE_NAME}}Status status) => status switch
+    {
+        {{pascalCase FEATURE_NAME}}Status.Active => "bg-success",
+        {{pascalCase FEATURE_NAME}}Status.Pending => "bg-warning text-dark",
+        {{pascalCase FEATURE_NAME}}Status.Completed => "bg-info",
+        {{pascalCase FEATURE_NAME}}Status.Failed => "bg-danger",
+        _ => "bg-secondary"
+    };
+
+    private class {{pascalCase FEATURE_NAME}}FormModel
+    {
+        [Required]
+        [StringLength(200, MinimumLength = 3)]
+        public string Name { get; set; } = string.Empty;
+
+        // Add more fields as needed
+    }
+}

package/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/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() }
+// });
+//
+// ============================================================