@polymorphism-tech/morph-spec 4.5.0 → 4.7.0

package/framework/skills/level-2-domains/frontend/nextjs-expert.md

@@ -1,161 +0,0 @@
----
-name: nextjs-expert
-description: >
-  Next.js Expert specialist for React, App Router, Pages Router, and Next.js ecosystem patterns. Activates for keywords: nextjs, react, frontend, app router, pages, ssr, ssg.
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep
----
-
-# .NET + Next.js Stack
-
-> **Layer:** 2 | **Load:** on-keyword | **Keywords:** nextjs, next.js, react, api, frontend, spa, typescript
-
-| Aspect | Technology |
-|--------|------------|
-| **Backend** | .NET 10 Web API / C# 14 |
-| **Frontend** | Next.js 15+ / React 19 |
-| **Database** | EF Core 10 + Azure SQL |
-| **API** | REST + OpenAPI |
-| **Hosting** | Azure Container Apps |
-
-## Project Structure
-
-```
-/
-├── backend/
-│   ├── src/{Api,Application,Domain,Infrastructure}/
-│   ├── tests/
-│   └── Backend.sln
-├── frontend/
-│   ├── src/{app,components,lib,hooks}/
-│   ├── package.json
-│   └── next.config.js
-├── docker-compose.yml
-└── infra/main.bicep
-```
-
----
-
-## Backend (.NET Minimal API)
-
-```csharp
-// Program.cs
-var builder = WebApplication.CreateBuilder(args);
-builder.Services.AddEndpointsApiExplorer();
-builder.Services.AddSwaggerGen();
-builder.Services.AddCors(o => o.AddPolicy("Frontend", p =>
-    p.WithOrigins(builder.Configuration["Frontend:Url"]!)
-     .AllowAnyHeader().AllowAnyMethod().AllowCredentials()));
-builder.Services.AddDbContext<AppDbContext>(o => o.UseSqlServer(connString));
-
-var app = builder.Build();
-if (app.Environment.IsDevelopment()) { app.UseSwagger(); app.UseSwaggerUI(); }
-app.UseCors("Frontend");
-app.UseAuthentication();
-app.UseAuthorization();
-app.MapOrderEndpoints();
-app.Run();
-```
-
-### Minimal API Endpoints
-
-```csharp
-public static class OrderEndpoints
-{
-    public static void MapOrderEndpoints(this WebApplication app)
-    {
-        var group = app.MapGroup("/api/orders").WithTags("Orders").RequireAuthorization();
-        group.MapGet("/", GetAll);
-        group.MapGet("/{id:int}", GetById);
-        group.MapPost("/", Create);
-        group.MapPut("/{id:int}", Update);
-        group.MapDelete("/{id:int}", Delete);
-    }
-    // Each handler: inject IService + params → return Results.Ok/NotFound/Created/NoContent
-}
-```
-
----
-
-## Frontend (Next.js)
-
-### API Client
-
-```typescript
-const API_URL = process.env.NEXT_PUBLIC_API_URL!;
-
-async function fetchApi<T>(endpoint: string, options?: RequestInit): Promise<T> {
-  const res = await fetch(`${API_URL}${endpoint}`, {
-    ...options,
-    headers: { 'Content-Type': 'application/json', ...options?.headers },
-    credentials: 'include',
-  });
-  if (!res.ok) throw new Error(`API error: ${res.status}`);
-  return res.json();
-}
-
-export const api = {
-  orders: {
-    getAll: (params?) => fetchApi<PaginatedResult<Order>>(`/api/orders?${new URLSearchParams(params)}`),
-    getById: (id: number) => fetchApi<Order>(`/api/orders/${id}`),
-    create: (data) => fetchApi<Order>('/api/orders', { method: 'POST', body: JSON.stringify(data) }),
-  },
-};
-```
-
-### Types (generated from OpenAPI)
-
-```typescript
-export interface Order { id: number; orderNumber: string; total: number; status: OrderStatus; }
-export type OrderStatus = 'Pending' | 'Processing' | 'Completed' | 'Cancelled';
-export interface PaginatedResult<T> { items: T[]; totalCount: number; page: number; totalPages: number; }
-```
-
-### Server Component (App Router)
-```tsx
-export default async function OrdersPage() {
-  const orders = await api.orders.getAll();
-  return <OrderList initialOrders={orders} />;
-}
-```
-
-### Client Component
-```tsx
-'use client';
-// Use useState + api calls for client-side pagination/interaction
-```
-
----
-
-## Docker Compose
-
-```yaml
-services:
-  backend:
-    build: { context: ./backend }
-    ports: ["5000:8080"]
-    environment:
-      - ConnectionStrings__Default=Server=db;Database=App;User=sa;Password=Pass!;TrustServerCertificate=true
-      - Frontend__Url=http://localhost:3000
-  frontend:
-    build: { context: ./frontend }
-    ports: ["3000:3000"]
-    environment: [NEXT_PUBLIC_API_URL=http://localhost:5000]
-  db:
-    image: mcr.microsoft.com/mssql/server:2022-latest
-    environment: [ACCEPT_EULA=Y, SA_PASSWORD=YourStrong!Passw0rd]
-    ports: ["1433:1433"]
-```
-
-## Checklist
-- [ ] Backend with Minimal APIs
-- [ ] OpenAPI/Swagger configured
-- [ ] CORS configured for frontend
-- [ ] Frontend with App Router (Next.js 15+)
-- [ ] API client typed
-- [ ] Types generated from OpenAPI
-- [ ] Docker Compose for dev
-- [ ] Environment variables configured
-
----
-
-*MORPH-SPEC by Polymorphism Tech*

package/framework/skills/level-3-technologies/README.md

@@ -1,7 +0,0 @@
-# Level 3: Technologies
-
-Technology-specific implementation patterns.
-
-**Purpose:** Skills for specific technologies (EF Core, Blazor, Hangfire, SignalR, etc.).
-
-**To be populated in Phase 8/9.**

package/framework/skills/level-4-patterns/README.md

@@ -1,7 +0,0 @@
-# Level 4: Patterns
-
-Architectural and design patterns.
-
-**Purpose:** Skills for specific patterns (CQRS, Event Sourcing, DDD, Repository, etc.).
-
-**To be populated later.**

package/framework/templates/code/dotnet/contracts/contracts.cs

@@ -1,217 +0,0 @@
-// ============================================================
-// CONTRACTS: {{titleCase FEATURE_NAME}}
-// Generated by MORPH Framework
-// Date: {{DATE}}
-// ============================================================
-
-#region Usings
-
-using System;
-using System.Collections.Generic;
-using System.Threading;
-using System.Threading.Tasks;
-
-#endregion
-
-namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}};
-
-#region Service Interfaces
-
-/// <summary>
-/// Service for managing {{pascalCase FEATURE_NAME}} operations.
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}Service
-{
-    /// <summary>
-    /// Gets a {{FEATURE_NAME_LOWER_SNAKE}} by its identifier.
-    /// </summary>
-    Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Gets all {{FEATURE_NAME_LOWER_SNAKE}}s.
-    /// </summary>
-    Task<List<{{pascalCase FEATURE_NAME}}Dto>> GetAllAsync(CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Creates a new {{FEATURE_NAME_LOWER_SNAKE}}.
-    /// </summary>
-    Task<{{pascalCase FEATURE_NAME}}Dto> CreateAsync(Create{{pascalCase FEATURE_NAME}}Request request, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Updates an existing {{FEATURE_NAME_LOWER_SNAKE}}.
-    /// </summary>
-    Task UpdateAsync(int id, Update{{pascalCase FEATURE_NAME}}Request request, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Deletes a {{FEATURE_NAME_LOWER_SNAKE}}.
-    /// </summary>
-    Task DeleteAsync(int id, CancellationToken cancellationToken = default);
-}
-
-#endregion
-
-#region DTOs
-
-/// <summary>
-/// Data transfer object for {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public record {{pascalCase FEATURE_NAME}}Dto(
-    int Id,
-    string Name,
-    {{pascalCase FEATURE_NAME}}Status Status,
-    DateTime CreatedAt,
-    DateTime? UpdatedAt
-);
-
-/// <summary>
-/// Request to create a new {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public record Create{{pascalCase FEATURE_NAME}}Request(
-    string Name
-    // Add other required fields
-);
-
-/// <summary>
-/// Request to update an existing {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public record Update{{pascalCase FEATURE_NAME}}Request(
-    string Name
-    // Add other updatable fields
-);
-
-#endregion
-
-#region Enums
-
-/// <summary>
-/// Status of a {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public enum {{pascalCase FEATURE_NAME}}Status
-{
-    Pending = 0,
-    Active = 1,
-    Completed = 2,
-    Failed = 3
-}
-
-#endregion
-
-#region Repository Interfaces
-
-/// <summary>
-/// Repository for {{pascalCase FEATURE_NAME}} data access.
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}Repository
-{
-    Task<{{pascalCase FEATURE_NAME}}?> GetByIdAsync(int id, CancellationToken cancellationToken = default);
-    Task<List<{{pascalCase FEATURE_NAME}}>> GetAllAsync(CancellationToken cancellationToken = default);
-    Task AddAsync({{pascalCase FEATURE_NAME}} entity, CancellationToken cancellationToken = default);
-    void Update({{pascalCase FEATURE_NAME}} entity);
-    void Remove({{pascalCase FEATURE_NAME}} entity);
-    Task SaveChangesAsync(CancellationToken cancellationToken = default);
-}
-
-#endregion
-
-#region Domain Entity Reference
-
-/*
-/// <summary>
-/// {{pascalCase FEATURE_NAME}} domain entity.
-/// Implement in Domain/Entities/{{pascalCase FEATURE_NAME}}.cs
-/// </summary>
-public class {{pascalCase FEATURE_NAME}}
-{
-    public int Id { get; private set; }
-    public string Name { get; private set; } = string.Empty;
-    public {{pascalCase FEATURE_NAME}}Status Status { get; private set; }
-    public DateTime CreatedAt { get; private set; }
-    public DateTime? UpdatedAt { get; private set; }
-
-    private {{pascalCase FEATURE_NAME}}() { } // EF Constructor
-
-    public static {{pascalCase FEATURE_NAME}} Create(string name)
-    {
-        return new {{pascalCase FEATURE_NAME}}
-        {
-            Name = name,
-            Status = {{pascalCase FEATURE_NAME}}Status.Pending,
-            CreatedAt = DateTime.UtcNow
-        };
-    }
-
-    public void Activate()
-    {
-        Status = {{pascalCase FEATURE_NAME}}Status.Active;
-        UpdatedAt = DateTime.UtcNow;
-    }
-
-    public void Complete()
-    {
-        Status = {{pascalCase FEATURE_NAME}}Status.Completed;
-        UpdatedAt = DateTime.UtcNow;
-    }
-}
-*/
-
-#endregion
-
-#region AI Agent Interfaces (if applicable)
-
-/// <summary>
-/// AI Agent for {{pascalCase FEATURE_NAME}} analysis.
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}AnalyzerAgent
-{
-    /// <summary>
-    /// Analyzes {{FEATURE_NAME_LOWER_SNAKE}} data using AI.
-    /// </summary>
-    Task<{{pascalCase FEATURE_NAME}}AnalysisResult> AnalyzeAsync(
-        {{pascalCase FEATURE_NAME}}Data data,
-        CancellationToken cancellationToken = default);
-}
-
-public record {{pascalCase FEATURE_NAME}}Data(
-    // Input data for analysis
-    string Content
-);
-
-public record {{pascalCase FEATURE_NAME}}AnalysisResult(
-    string Summary,
-    List<string> Insights,
-    List<string> Recommendations,
-    double ConfidenceScore
-);
-
-#endregion
-
-#region Hangfire Job Interfaces (if applicable)
-
-/// <summary>
-/// Background job for processing {{pascalCase FEATURE_NAME}}.
-/// </summary>
-public interface I{{pascalCase FEATURE_NAME}}ProcessorJob
-{
-    /// <summary>
-    /// Executes the {{FEATURE_NAME_LOWER_SNAKE}} processing job.
-    /// </summary>
-    Task ExecuteAsync(int id, CancellationToken cancellationToken = default);
-}
-
-#endregion
-
-#region Exceptions
-
-public class {{pascalCase FEATURE_NAME}}NotFoundException : Exception
-{
-    public {{pascalCase FEATURE_NAME}}NotFoundException(int id)
-        : base($"{{pascalCase FEATURE_NAME}} with ID {id} was not found.") { }
-}
-
-public class {{pascalCase FEATURE_NAME}}ProcessingException : Exception
-{
-    public {{pascalCase FEATURE_NAME}}ProcessingException(string message, Exception? innerException = null)
-        : base(message, innerException) { }
-}
-
-#endregion

package/framework/templates/code/dotnet/contracts/contracts.cs.hbs

@@ -1,172 +0,0 @@
-// ====================================================================
-// Feature: {{FEATURE_NAME_TITLE}}
-// Contracts: DTOs, Interfaces, Enums, Value Objects
-// Generated: {{DATE}}
-// Author: {{AUTHOR}}
-// ====================================================================
-//
-// IMPORTANT: This file was generated from schema-analysis.md
-// All field names, types, and relationships are based on REAL database schema
-// DO NOT modify without checking schema-analysis.md first!
-//
-// ====================================================================
-
-namespace {{NAMESPACE}}.Features.{{FEATURE_NAME_PASCAL}};
-
-// ====================================================================
-// DTOs (Data Transfer Objects)
-// ====================================================================
-// Pattern: Use records for immutability
-// Pattern: All DTOs must have XML documentation
-// Pattern: Use nullable reference types appropriately
-// ====================================================================
-
-{{#each dtos}}
-/// <summary>
-/// {{this.description}}
-/// </summary>
-{{#if this.isCreateDto}}
-public record {{this.name}}(
-{{#each this.fields}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}{{#if this.comment}} // {{this.comment}}{{/if}}
-{{/each}}
-);
-{{else if this.isUpdateDto}}
-public record {{this.name}}(
-{{#each this.fields}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}{{#if this.comment}} // {{this.comment}}{{/if}}
-{{/each}}
-);
-{{else}}
-/// <summary>
-/// Response DTO for {{this.entityName}}
-/// </summary>
-public record {{this.name}}(
-{{#each this.fields}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}{{#if this.comment}} // {{this.comment}}{{/if}}
-{{/each}}
-);
-{{/if}}
-
-{{/each}}
-
-// ====================================================================
-// Service Interfaces
-// ====================================================================
-// Pattern: All async methods must accept CancellationToken
-// Pattern: Use Task<TResult?> for operations that may return null
-// Pattern: Document exceptions in XML comments
-// ====================================================================
-
-{{#each interfaces}}
-/// <summary>
-/// {{this.description}}
-/// </summary>
-public interface {{this.name}}
-{
-{{#each this.methods}}
-    /// <summary>
-    /// {{this.description}}
-    /// </summary>
-{{#if this.exceptions}}
-{{#each this.exceptions}}
-    /// <exception cref="{{this.type}}">{{this.condition}}</exception>
-{{/each}}
-{{/if}}
-    Task<{{this.returnType}}{{#if this.nullable}}?{{/if}}> {{this.name}}({{#each this.parameters}}{{this.type}} {{this.name}}{{#unless @last}}, {{/unless}}{{/each}}, CancellationToken ct);
-
-{{/each}}
-}
-
-{{/each}}
-
-// ====================================================================
-// Enums
-// ====================================================================
-
-{{#each enums}}
-/// <summary>
-/// {{this.description}}
-/// </summary>
-public enum {{this.name}}
-{
-{{#each this.values}}
-    /// <summary>
-    /// {{this.description}}
-    /// </summary>
-    {{this.name}}{{#if this.value}} = {{this.value}}{{/if}}{{#unless @last}},{{/unless}}
-{{/each}}
-}
-
-{{/each}}
-
-// ====================================================================
-// Value Objects (if applicable)
-// ====================================================================
-
-{{#each valueObjects}}
-/// <summary>
-/// {{this.description}}
-/// </summary>
-public record {{this.name}}
-{
-{{#each this.properties}}
-    /// <summary>
-    /// {{this.description}}
-    /// </summary>
-    public {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}} { get; init; }{{#if this.default}} = {{this.default}};{{/if}}
-{{/each}}
-
-{{#if this.validation}}
-    /// <summary>
-    /// Validates the value object
-    /// </summary>
-    public bool IsValid()
-    {
-        {{this.validation}}
-    }
-{{/if}}
-}
-
-{{/each}}
-
-// ====================================================================
-// Request/Response Wrappers (if using CQRS)
-// ====================================================================
-
-{{#if useCQRS}}
-{{#each commands}}
-/// <summary>
-/// Command: {{this.description}}
-/// </summary>
-public record {{this.name}}(
-{{#each this.parameters}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}
-{{/each}}
-);
-
-{{/each}}
-
-{{#each queries}}
-/// <summary>
-/// Query: {{this.description}}
-/// </summary>
-public record {{this.name}}(
-{{#each this.parameters}}
-    {{this.type}}{{#if this.nullable}}?{{/if}} {{this.name}}{{#unless @last}},{{/unless}}
-{{/each}}
-);
-
-{{/each}}
-{{/if}}
-
-// ====================================================================
-// Notes
-// ====================================================================
-// - All field names match database schema (see schema-analysis.md)
-// - Nullability matches database constraints
-// - Complex types (JSONB → JsonObject) correctly mapped
-// - Relationships preserved in navigation properties
-// - Immutable records used for DTOs (recommended pattern)
-// - CancellationToken required for all async operations
-// ====================================================================