@polymorphism-tech/morph-spec 4.15.0 → 4.17.0

package/framework/templates/frontend/nextjs/gsap-scroll-section.tsx.hbs

@@ -0,0 +1,44 @@
+// features/{{kebabCase featureName}}/components/{{kebabCase sectionName}}-section.tsx
+'use client';
+
+import { useRef } from 'react';
+import gsap from 'gsap';
+import { ScrollTrigger } from 'gsap/ScrollTrigger';
+import { useGSAP } from '@gsap/react';
+import { durations } from '@/lib/design-tokens';
+
+gsap.registerPlugin(ScrollTrigger);
+
+export function {{pascalCase sectionName}}Section() {
+  const containerRef = useRef<HTMLDivElement>(null);
+
+  useGSAP(() => {
+    const prefersReducedMotion = window.matchMedia(
+      '(prefers-reduced-motion: reduce)'
+    ).matches;
+
+    if (prefersReducedMotion) return;
+
+    gsap.from('.{{kebabCase sectionName}}-item', {
+      y: 40,
+      opacity: 0,
+      stagger: 0.1,
+      duration: durations.base,
+      ease: 'power2.out',
+      scrollTrigger: {
+        trigger: containerRef.current,
+        start: 'top 80%',
+        toggleActions: 'play none none none',
+      },
+    });
+  }, { scope: containerRef });
+
+  return (
+    <section ref={containerRef} className="{{kebabCase sectionName}}-section">
+      {/* {{pascalCase sectionName}} content */}
+      <div className="{{kebabCase sectionName}}-item">
+        {/* Item content */}
+      </div>
+    </section>
+  );
+}

package/framework/templates/infrastructure/docker/docker-compose.template.yml

@@ -1,67 +1,50 @@
-# Docker Compose for Local Development
-# Next.js + Supabase Stack
-
-version: '3.8'
-
-services:
-  # Next.js Application
-  app:
-    build:
-      context: .
-      dockerfile: Dockerfile.dev
-    container_name: {{kebabCase FEATURE_NAME}}-app
-    ports:
-      - "3000:3000"
-    environment:
-      - NODE_ENV=development
-      - NEXT_PUBLIC_SUPABASE_URL=${NEXT_PUBLIC_SUPABASE_URL}
-      - NEXT_PUBLIC_SUPABASE_ANON_KEY=${NEXT_PUBLIC_SUPABASE_ANON_KEY}
-      - SUPABASE_SERVICE_ROLE_KEY=${SUPABASE_SERVICE_ROLE_KEY}
-    volumes:
-      - .:/app
-      - /app/node_modules
-      - /app/.next
-    depends_on:
-      - postgres
-    networks:
-      - app-network
-
-  # PostgreSQL Database (Local Supabase alternative)
-  postgres:
-    image: postgres:15-alpine
-    container_name: {{kebabCase FEATURE_NAME}}-postgres
-    restart: unless-stopped
-    ports:
-      - "5432:5432"
-    environment:
-      POSTGRES_USER: postgres
-      POSTGRES_PASSWORD: postgres
-      POSTGRES_DB: {{snakeCase FEATURE_NAME}}
-    volumes:
-      - postgres-data:/var/lib/postgresql/data
-      - ./supabase/migrations:/docker-entrypoint-initdb.d
-    networks:
-      - app-network
-
-  # Supabase Studio (Database UI - optional)
-  studio:
-    image: supabase/studio:latest
-    container_name: {{kebabCase FEATURE_NAME}}-studio
-    restart: unless-stopped
-    ports:
-      - "3001:3000"
-    environment:
-      SUPABASE_URL: http://kong:8000
-      STUDIO_PG_META_URL: http://meta:8080
-      SUPABASE_ANON_KEY: ${SUPABASE_ANON_KEY}
-      SUPABASE_SERVICE_KEY: ${SUPABASE_SERVICE_ROLE_KEY}
-    networks:
-      - app-network
-
-volumes:
-  postgres-data:
-    driver: local
-
-networks:
-  app-network:
-    driver: bridge
+# Docker Compose for Local Development
+# Next.js + Neon Stack
+
+version: '3.8'
+
+services:
+  # Next.js Application
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile.dev
+    container_name: {{kebabCase FEATURE_NAME}}-app
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=development
+      - DATABASE_URL=${DATABASE_URL}
+    volumes:
+      - .:/app
+      - /app/node_modules
+      - /app/.next
+    depends_on:
+      - postgres
+    networks:
+      - app-network
+
+  # PostgreSQL Database (Local development)
+  postgres:
+    image: postgres:15-alpine
+    container_name: {{kebabCase FEATURE_NAME}}-postgres
+    restart: unless-stopped
+    ports:
+      - "5432:5432"
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: {{snakeCase FEATURE_NAME}}
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+      - ./migrations:/docker-entrypoint-initdb.d
+    networks:
+      - app-network
+
+volumes:
+  postgres-data:
+    driver: local
+
+networks:
+  app-network:
+    driver: bridge

package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile

@@ -1,38 +1,38 @@
-# ============================================================
-# Dockerfile: .NET 10 API ({{titleCase FEATURE_NAME}})
-# Stack: Next.js + Supabase + .NET API
-# Generated by MORPH Framework
-# ============================================================
-
-# Stage 1: Build
-FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
-WORKDIR /src
-
-# Copy project file and restore dependencies
-COPY *.csproj .
-RUN dotnet restore
-
-# Copy source code and publish
-COPY . .
-RUN dotnet publish -c Release -o /app/publish --no-restore
-
-# Stage 2: Runtime
-FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS runtime
-WORKDIR /app
-
-# Copy published output
-COPY --from=build /app/publish .
-
-# Configuration
-ENV ASPNETCORE_URLS=http://+:8080
-ENV ASPNETCORE_ENVIRONMENT=Production
-
-# Expose port
-EXPOSE 8080
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
-  CMD curl -f http://localhost:8080/health || exit 1
-
-# Entrypoint
-ENTRYPOINT ["dotnet", "Api.dll"]
+# ============================================================
+# Dockerfile: .NET 10 API ({{titleCase FEATURE_NAME}})
+# Stack: Next.js + Neon + .NET API
+# Generated by MORPH Framework
+# ============================================================
+
+# Stage 1: Build
+FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
+WORKDIR /src
+
+# Copy project file and restore dependencies
+COPY *.csproj .
+RUN dotnet restore
+
+# Copy source code and publish
+COPY . .
+RUN dotnet publish -c Release -o /app/publish --no-restore
+
+# Stage 2: Runtime
+FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS runtime
+WORKDIR /app
+
+# Copy published output
+COPY --from=build /app/publish .
+
+# Configuration
+ENV ASPNETCORE_URLS=http://+:8080
+ENV ASPNETCORE_ENVIRONMENT=Production
+
+# Expose port
+EXPOSE 8080
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD curl -f http://localhost:8080/health || exit 1
+
+# Entrypoint
+ENTRYPOINT ["dotnet", "Api.dll"]

package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile

@@ -1,48 +1,48 @@
-# ============================================================
-# Dockerfile: Next.js Frontend ({{titleCase FEATURE_NAME}})
-# Stack: Next.js + Supabase
-# Generated by MORPH Framework
-# Requires: output: "standalone" in next.config.ts
-# ============================================================
-
-# Stage 1: Install dependencies
-FROM node:22-alpine AS deps
-WORKDIR /app
-COPY package.json package-lock.json ./
-RUN npm ci --omit=dev
-
-# Stage 2: Build application
-FROM node:22-alpine AS builder
-WORKDIR /app
-COPY --from=deps /app/node_modules ./node_modules
-COPY . .
-ENV NEXT_TELEMETRY_DISABLED=1
-RUN npm run build
-
-# Stage 3: Production runtime
-FROM node:22-alpine AS runner
-WORKDIR /app
-
-ENV NODE_ENV=production
-ENV NEXT_TELEMETRY_DISABLED=1
-
-# Create non-root user
-RUN addgroup --system --gid 1001 nodejs && \
-    adduser --system --uid 1001 nextjs
-
-# Copy build output
-COPY --from=builder /app/public ./public
-COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
-COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
-
-# Switch to non-root user
-USER nextjs
-
-# Expose port
-EXPOSE 3000
-
-ENV PORT=3000
-ENV HOSTNAME="0.0.0.0"
-
-# Start server
-CMD ["node", "server.js"]
+# ============================================================
+# Dockerfile: Next.js Frontend ({{titleCase FEATURE_NAME}})
+# Stack: Next.js + Neon
+# Generated by MORPH Framework
+# Requires: output: "standalone" in next.config.ts
+# ============================================================
+
+# Stage 1: Install dependencies
+FROM node:22-alpine AS deps
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci --omit=dev
+
+# Stage 2: Build application
+FROM node:22-alpine AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+ENV NEXT_TELEMETRY_DISABLED=1
+RUN npm run build
+
+# Stage 3: Production runtime
+FROM node:22-alpine AS runner
+WORKDIR /app
+
+ENV NODE_ENV=production
+ENV NEXT_TELEMETRY_DISABLED=1
+
+# Create non-root user
+RUN addgroup --system --gid 1001 nodejs && \
+    adduser --system --uid 1001 nextjs
+
+# Copy build output
+COPY --from=builder /app/public ./public
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+# Switch to non-root user
+USER nextjs
+
+# Expose port
+EXPOSE 3000
+
+ENV PORT=3000
+ENV HOSTNAME="0.0.0.0"
+
+# Start server
+CMD ["node", "server.js"]

package/framework/templates/infrastructure/docker/easypanel.template.json

@@ -1,54 +1,46 @@
-{
-  "name": "{{kebabCase FEATURE_NAME}}",
-  "services": [
-    {
-      "type": "app",
-      "data": {
-        "projectName": "{{kebabCase FEATURE_NAME}}",
-        "serviceName": "{{kebabCase FEATURE_NAME}}-app",
-        "source": {
-          "type": "github",
-          "owner": "{{GITHUB_OWNER}}",
-          "repo": "{{GITHUB_REPO}}",
-          "ref": "main",
-          "autoDeploy": true
-        },
-        "build": {
-          "type": "dockerfile",
-          "dockerfile": "Dockerfile"
-        },
-        "deploy": {
-          "replicas": 1,
-          "command": null,
-          "zeroDowntime": true
-        },
-        "env": [
-          {
-            "key": "NODE_ENV",
-            "value": "production"
-          },
-          {
-            "key": "NEXT_PUBLIC_SUPABASE_URL",
-            "value": "${NEXT_PUBLIC_SUPABASE_URL}"
-          },
-          {
-            "key": "NEXT_PUBLIC_SUPABASE_ANON_KEY",
-            "value": "${NEXT_PUBLIC_SUPABASE_ANON_KEY}"
-          },
-          {
-            "key": "SUPABASE_SERVICE_ROLE_KEY",
-            "value": "${SUPABASE_SERVICE_ROLE_KEY}"
-          }
-        ],
-        "domains": [
-          {
-            "host": "{{kebabCase FEATURE_NAME}}.easypanel.host",
-            "port": 3000,
-            "https": true
-          }
-        ],
-        "mounts": []
-      }
-    }
-  ]
-}
+{
+  "name": "{{kebabCase FEATURE_NAME}}",
+  "services": [
+    {
+      "type": "app",
+      "data": {
+        "projectName": "{{kebabCase FEATURE_NAME}}",
+        "serviceName": "{{kebabCase FEATURE_NAME}}-app",
+        "source": {
+          "type": "github",
+          "owner": "{{GITHUB_OWNER}}",
+          "repo": "{{GITHUB_REPO}}",
+          "ref": "main",
+          "autoDeploy": true
+        },
+        "build": {
+          "type": "dockerfile",
+          "dockerfile": "Dockerfile"
+        },
+        "deploy": {
+          "replicas": 1,
+          "command": null,
+          "zeroDowntime": true
+        },
+        "env": [
+          {
+            "key": "NODE_ENV",
+            "value": "production"
+          },
+          {
+            "key": "DATABASE_URL",
+            "value": "${DATABASE_URL}"
+          }
+        ],
+        "domains": [
+          {
+            "host": "{{kebabCase FEATURE_NAME}}.easypanel.host",
+            "port": 3000,
+            "https": true
+          }
+        ],
+        "mounts": []
+      }
+    }
+  ]
+}

package/framework/templates/infrastructure/github/README.md

@@ -1,56 +1,56 @@
-# GitHub Actions Templates for MORPH-SPEC
-
-> **Framework-Level CI/CD Templates for EasyPanel/Docker Deployments**
-
-## Overview
-
-Reusable GitHub Actions workflows and composite actions for the **nextjs-supabase** stack (EasyPanel/Docker deployment).
-
-**Key Features:**
-- Handlebars v2.0 templating with helpers
-- Composite actions for shared logic
-- Docker multi-stage builds (.NET API + Next.js Web)
-- EasyPanel webhook deployment
-
----
-
-## Structure
-
-```
-infrastructure/github/
-├── workflows/
-│   ├── dotnet-build.yml.hbs       # .NET restore, build, test, coverage
-│   ├── docker-build-push.yml.hbs  # Docker build & push to registry
-│   └── deploy-easypanel.yml.hbs   # EasyPanel deployment via webhook
-│
-└── actions/
-    ├── docker-build-push/action.yml.hbs   # Build & push Docker image
-    └── health-check/action.yml.hbs        # Poll health endpoint
-```
-
-## Workflows
-
-### .NET Build (`dotnet-build.yml.hbs`)
-- Restore, build, test with coverage
-- Uploads test results and coverage artifacts
-
-### Docker Build & Push (`docker-build-push.yml.hbs`)
-- Multi-stage Docker build
-- Push to container registry (GHCR or Docker Hub)
-
-### Deploy EasyPanel (`deploy-easypanel.yml.hbs`)
-- Triggers EasyPanel webhook after Docker push
-- Runs health check after deployment
-- Supports staging + production environments
-
-## Usage
-
-Templates are rendered during `morph-spec init` based on project stack configuration.
-
-```bash
-morph-spec init --stack nextjs-supabase
-```
-
----
-
-*MORPH-SPEC by Polymorphism Tech*
+# GitHub Actions Templates for MORPH-SPEC
+
+> **Framework-Level CI/CD Templates for EasyPanel/Docker Deployments**
+
+## Overview
+
+Reusable GitHub Actions workflows and composite actions for the **nextjs-neon** stack (EasyPanel/Docker deployment).
+
+**Key Features:**
+- Handlebars v2.0 templating with helpers
+- Composite actions for shared logic
+- Docker multi-stage builds (.NET API + Next.js Web)
+- EasyPanel webhook deployment
+
+---
+
+## Structure
+
+```
+infrastructure/github/
+├── workflows/
+│   ├── dotnet-build.yml.hbs       # .NET restore, build, test, coverage
+│   ├── docker-build-push.yml.hbs  # Docker build & push to registry
+│   └── deploy-easypanel.yml.hbs   # EasyPanel deployment via webhook
+│
+└── actions/
+    ├── docker-build-push/action.yml.hbs   # Build & push Docker image
+    └── health-check/action.yml.hbs        # Poll health endpoint
+```
+
+## Workflows
+
+### .NET Build (`dotnet-build.yml.hbs`)
+- Restore, build, test with coverage
+- Uploads test results and coverage artifacts
+
+### Docker Build & Push (`docker-build-push.yml.hbs`)
+- Multi-stage Docker build
+- Push to container registry (GHCR or Docker Hub)
+
+### Deploy EasyPanel (`deploy-easypanel.yml.hbs`)
+- Triggers EasyPanel webhook after Docker push
+- Runs health check after deployment
+- Supports staging + production environments
+
+## Usage
+
+Templates are rendered during `morph-spec init` based on project stack configuration.
+
+```bash
+morph-spec init --stack nextjs-neon
+```
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/framework/templates/integrations/semantic-kernel-neon.cs

@@ -0,0 +1,125 @@
+// ============================================================
+// SEMANTIC KERNEL + NEON PGVECTOR SETUP TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.VectorData;
+using Microsoft.SemanticKernel;
+using Microsoft.SemanticKernel.Connectors.PgVector;
+using Microsoft.SemanticKernel.Connectors.OpenAI;
+using Microsoft.SemanticKernel.Embeddings;
+using Npgsql;
+
+#nullable disable
+
+namespace {{NAMESPACE}}.Infrastructure.AI;
+
+// ============================================================
+// 1. DATA MODEL — annotated for Semantic Kernel vector store
+// ============================================================
+
+public class KnowledgeEntry
+{
+    [VectorStoreKey(StorageName = "id")]
+    public Guid Id { get; set; }
+
+    [VectorStoreData(StorageName = "title")]
+    public string Title { get; set; } = string.Empty;
+
+    [VectorStoreData(StorageName = "content", IsFullTextSearchable = true)]
+    public string Content { get; set; } = string.Empty;
+
+    [VectorStoreData(StorageName = "source")]
+    public string? Source { get; set; }
+
+    [VectorStoreVector(Dimensions: 1536, DistanceFunction.CosineSimilarity, StorageName = "embedding")]
+    public ReadOnlyMemory<float> Embedding { get; set; }
+
+    [VectorStoreData(StorageName = "created_at")]
+    public DateTimeOffset CreatedAt { get; set; } = DateTimeOffset.UtcNow;
+}
+
+// ============================================================
+// 2. SERVICE REGISTRATION — add to Program.cs
+// ============================================================
+
+public static class SemanticKernelExtensions
+{
+    public static IServiceCollection AddSemanticKernelWithNeon(
+        this IServiceCollection services,
+        string neonConnectionString,
+        string openAiApiKey,
+        string embeddingModel = "text-embedding-3-small")
+    {
+        // Neon PostgreSQL data source with pgvector
+        services.AddSingleton<NpgsqlDataSource>(sp =>
+        {
+            var builder = new NpgsqlDataSourceBuilder(neonConnectionString);
+            builder.UseVector();
+            return builder.Build();
+        });
+
+        // Semantic Kernel with OpenAI + Postgres vector store
+        services.AddKernel();
+
+        services.AddOpenAITextEmbeddingGeneration(embeddingModel, openAiApiKey);
+
+        services.AddPostgresVectorStore();
+
+        // VectorStoreTextSearch for natural language queries
+        services.AddSingleton<VectorStoreTextSearch<KnowledgeEntry>>(sp =>
+        {
+            var vectorStore = sp.GetRequiredService<IVectorStore>();
+            var collection = vectorStore.GetCollection<Guid, KnowledgeEntry>("knowledge_entries");
+            var embeddingGenerator = sp.GetRequiredService<ITextEmbeddingGenerationService>();
+
+            return new VectorStoreTextSearch<KnowledgeEntry>(
+                collection, embeddingGenerator);
+        });
+
+        return services;
+    }
+}
+
+// ============================================================
+// SETUP INSTRUCTIONS
+// ============================================================
+//
+// 1. Install NuGet packages:
+//
+//    dotnet add package Microsoft.SemanticKernel.Connectors.PgVector --prerelease
+//    dotnet add package Microsoft.SemanticKernel.Connectors.OpenAI
+//    dotnet add package Npgsql
+//
+// 2. Add to Program.cs:
+//
+//    builder.Services.AddSemanticKernelWithNeon(
+//        builder.Configuration.GetConnectionString("DefaultConnection")!,
+//        builder.Configuration["OpenAI:ApiKey"]!);
+//
+// 3. Create the database table (Neon SQL):
+//
+//    CREATE EXTENSION IF NOT EXISTS vector;
+//    CREATE TABLE knowledge_entries (
+//        id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+//        title TEXT NOT NULL,
+//        content TEXT NOT NULL,
+//        source TEXT,
+//        embedding vector(1536),
+//        created_at TIMESTAMPTZ DEFAULT now()
+//    );
+//    CREATE INDEX ON knowledge_entries USING hnsw (embedding vector_cosine_ops);
+//
+// 4. Use in a service or MAF agent:
+//
+//    public class SearchService(VectorStoreTextSearch<KnowledgeEntry> search)
+//    {
+//        public async Task<IReadOnlyList<KnowledgeEntry>> SearchAsync(string query)
+//        {
+//            var results = await search.SearchAsync(query, new() { Top = 5 });
+//            return await results.Results.Select(r => r.Record).ToListAsync();
+//        }
+//    }
+//
+// ============================================================