@polymorphism-tech/morph-spec 8.29.0 → 8.31.0

package/framework/templates/frontend/nextjs/use-feature.ts.hbs

@@ -1,54 +1,54 @@
-// features/{{kebabCase featureName}}/hooks/use-{{kebabCase featureName}}s.ts
-import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
-import { z } from 'zod';
-import { {{camelCase featureName}}Schema } from '@/features/{{kebabCase featureName}}/types/{{kebabCase featureName}}.schemas';
-import type { Create{{pascalCase featureName}}Input } from '@/features/{{kebabCase featureName}}/types/{{kebabCase featureName}}.types';
-
-// ============================================
-// Query Key Factory
-// ============================================
-
-export const {{camelCase featureName}}Keys = {
-  all: ['{{kebabCase featureName}}'] as const,
-  lists: () => [...{{camelCase featureName}}Keys.all, 'list'] as const,
-  detail: (id: string) => [...{{camelCase featureName}}Keys.all, 'detail', id] as const,
-};
-
-// ============================================
-// List Hook (TanStack Query v5 syntax)
-// ============================================
-
-const {{camelCase featureName}}ListSchema = z.array({{camelCase featureName}}Schema);
-
-export function use{{pascalCase featureName}}s() {
-  return useQuery({
-    queryKey: {{camelCase featureName}}Keys.lists(),
-    queryFn: async () => {
-      const res = await fetch('/api/{{kebabCase featureName}}');
-      if (!res.ok) throw new Error('Failed to fetch {{featureName}}');
-      return {{camelCase featureName}}ListSchema.parse(await res.json());
-    },
-  });
-}
-
-// ============================================
-// Create Mutation
-// ============================================
-
-export function useCreate{{pascalCase featureName}}() {
-  const queryClient = useQueryClient();
-  return useMutation({
-    mutationFn: async (input: Create{{pascalCase featureName}}Input) => {
-      const res = await fetch('/api/{{kebabCase featureName}}', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify(input),
-      });
-      if (!res.ok) throw new Error('Failed to create {{featureName}}');
-      return res.json();
-    },
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: {{camelCase featureName}}Keys.lists() });
-    },
-  });
-}
+// features/{{kebabCase featureName}}/hooks/use-{{kebabCase featureName}}s.ts
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { z } from 'zod';
+import { {{camelCase featureName}}Schema } from '@/features/{{kebabCase featureName}}/types/{{kebabCase featureName}}.schemas';
+import type { Create{{pascalCase featureName}}Input } from '@/features/{{kebabCase featureName}}/types/{{kebabCase featureName}}.types';
+
+// ============================================
+// Query Key Factory
+// ============================================
+
+export const {{camelCase featureName}}Keys = {
+  all: ['{{kebabCase featureName}}'] as const,
+  lists: () => [...{{camelCase featureName}}Keys.all, 'list'] as const,
+  detail: (id: string) => [...{{camelCase featureName}}Keys.all, 'detail', id] as const,
+};
+
+// ============================================
+// List Hook (TanStack Query v5 syntax)
+// ============================================
+
+const {{camelCase featureName}}ListSchema = z.array({{camelCase featureName}}Schema);
+
+export function use{{pascalCase featureName}}s() {
+  return useQuery({
+    queryKey: {{camelCase featureName}}Keys.lists(),
+    queryFn: async () => {
+      const res = await fetch('/api/{{kebabCase featureName}}');
+      if (!res.ok) throw new Error('Failed to fetch {{featureName}}');
+      return {{camelCase featureName}}ListSchema.parse(await res.json());
+    },
+  });
+}
+
+// ============================================
+// Create Mutation
+// ============================================
+
+export function useCreate{{pascalCase featureName}}() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async (input: Create{{pascalCase featureName}}Input) => {
+      const res = await fetch('/api/{{kebabCase featureName}}', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(input),
+      });
+      if (!res.ok) throw new Error('Failed to create {{featureName}}');
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: {{camelCase featureName}}Keys.lists() });
+    },
+  });
+}

package/framework/templates/infrastructure/docker/Dockerfile.template

@@ -1,58 +1,58 @@
-# Multi-stage Dockerfile for Next.js Production Build
-# Optimized for Next.js 15 with App Router
-
-FROM node:20-alpine AS base
-
-# Install dependencies only when needed
-FROM base AS deps
-RUN apk add --no-cache libc6-compat
-WORKDIR /app
-
-# Copy package files
-COPY package.json package-lock.json* ./
-RUN npm ci
-
-# Rebuild the source code only when needed
-FROM base AS builder
-WORKDIR /app
-COPY --from=deps /app/node_modules ./node_modules
-COPY . .
-
-# Set build-time environment variables
-ENV NEXT_TELEMETRY_DISABLED 1
-
-# Build Next.js application
-RUN npm run build
-
-# Production image, copy all the files and run next
-FROM base AS runner
-WORKDIR /app
-
-ENV NODE_ENV production
-ENV NEXT_TELEMETRY_DISABLED 1
-
-# Create nextjs user
-RUN addgroup --system --gid 1001 nodejs
-RUN adduser --system --uid 1001 nextjs
-
-# Copy built application
-COPY --from=builder /app/public ./public
-
-# Set the correct permission for prerender cache
-RUN mkdir .next
-RUN chown nextjs:nodejs .next
-
-# Automatically leverage output traces to reduce image size
-# https://nextjs.org/docs/advanced-features/output-file-tracing
-COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
-COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
-
-USER nextjs
-
-EXPOSE 3000
-
-ENV PORT 3000
-ENV HOSTNAME "0.0.0.0"
-
-# Run Next.js server
-CMD ["node", "server.js"]
+# Multi-stage Dockerfile for Next.js Production Build
+# Optimized for Next.js 15 with App Router
+
+FROM node:20-alpine AS base
+
+# Install dependencies only when needed
+FROM base AS deps
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
+
+# Copy package files
+COPY package.json package-lock.json* ./
+RUN npm ci
+
+# Rebuild the source code only when needed
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+
+# Set build-time environment variables
+ENV NEXT_TELEMETRY_DISABLED 1
+
+# Build Next.js application
+RUN npm run build
+
+# Production image, copy all the files and run next
+FROM base AS runner
+WORKDIR /app
+
+ENV NODE_ENV production
+ENV NEXT_TELEMETRY_DISABLED 1
+
+# Create nextjs user
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 nextjs
+
+# Copy built application
+COPY --from=builder /app/public ./public
+
+# Set the correct permission for prerender cache
+RUN mkdir .next
+RUN chown nextjs:nodejs .next
+
+# Automatically leverage output traces to reduce image size
+# https://nextjs.org/docs/advanced-features/output-file-tracing
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+USER nextjs
+
+EXPOSE 3000
+
+ENV PORT 3000
+ENV HOSTNAME "0.0.0.0"
+
+# Run Next.js server
+CMD ["node", "server.js"]

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

@@ -1,38 +1,38 @@
-# ============================================================
-# 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"]
+# ============================================================
+# 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 + 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"]
+# ============================================================
+# 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/github/README.md

@@ -1,56 +1,56 @@
-# GitHub Actions Templates for MORPH-SPEC
-
-> **Framework-Level CI/CD Templates for Coolify/Docker Deployments**
-
-## Overview
-
-Reusable GitHub Actions workflows and composite actions for the **nextjs-neon** stack (Coolify/Docker deployment).
-
-**Key Features:**
-- Handlebars v2.0 templating with helpers
-- Composite actions for shared logic
-- Docker multi-stage builds (.NET API + Next.js Web)
-- Coolify deployment via SSH (no MCP/CLI exists — the Coolify API is not publicly exposed, so the runner SSHes into the VPS to trigger it)
-
----
-
-## Structure
-
-```
-infrastructure/github/
-├── workflows/
-│   ├── dotnet-build.yml.hbs       # .NET restore, build, test, coverage
-│   ├── docker-build-push.yml.hbs  # Docker build & push to registry
-│   └── deploy-coolify.yml.hbs     # Coolify deployment via SSH
-│
-└── 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 Coolify (`deploy-coolify.yml.hbs`)
-- SSHes into the VPS and calls the local Coolify API (`localhost:8000/api/v1/deploy?uuid=...`) 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*
+# GitHub Actions Templates for MORPH-SPEC
+
+> **Framework-Level CI/CD Templates for Coolify/Docker Deployments**
+
+## Overview
+
+Reusable GitHub Actions workflows and composite actions for the **nextjs-neon** stack (Coolify/Docker deployment).
+
+**Key Features:**
+- Handlebars v2.0 templating with helpers
+- Composite actions for shared logic
+- Docker multi-stage builds (.NET API + Next.js Web)
+- Coolify deployment via SSH (no MCP/CLI exists — the Coolify API is not publicly exposed, so the runner SSHes into the VPS to trigger it)
+
+---
+
+## Structure
+
+```
+infrastructure/github/
+├── workflows/
+│   ├── dotnet-build.yml.hbs       # .NET restore, build, test, coverage
+│   ├── docker-build-push.yml.hbs  # Docker build & push to registry
+│   └── deploy-coolify.yml.hbs     # Coolify deployment via SSH
+│
+└── 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 Coolify (`deploy-coolify.yml.hbs`)
+- SSHes into the VPS and calls the local Coolify API (`localhost:8000/api/v1/deploy?uuid=...`) 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/infrastructure/github/actions/docker-build-push/action.yml.hbs

@@ -1,45 +1,45 @@
-name: 'Build & Push Docker Image'
-description: 'Build multi-stage Docker image and push to registry'
-inputs:
-  registry:
-    description: 'Docker registry URL'
-    required: true
-  image-name:
-    description: 'Docker image name'
-    required: true
-  dockerfile-path:
-    description: 'Path to Dockerfile'
-    required: false
-    default: 'Dockerfile'
-  build-context:
-    description: 'Docker build context'
-    required: false
-    default: '.'
-outputs:
-  image-tag:
-    description: 'Full image tag with registry'
-    value: ${{{{ steps.build.outputs.tags }}}}
-
-runs:
-  using: 'composite'
-  steps:
-    - name: Set up Docker Buildx
-      uses: docker/setup-buildx-action@v3
-
-    - name: Login to Registry
-      uses: docker/login-action@v3
-      with:
-        registry: ${{{{ inputs.registry }}}}
-        username: ${{{{ secrets.REGISTRY_USERNAME }}}}
-        password: ${{{{ secrets.REGISTRY_PASSWORD }}}}
-
-    - name: Build and push
-      id: build
-      uses: docker/build-push-action@v5
-      with:
-        context: ${{{{ inputs.build-context }}}}
-        file: ${{{{ inputs.dockerfile-path }}}}
-        push: true
-        tags: ${{{{ inputs.registry }}}}/${{{{ inputs.image-name }}}}:${{{{ github.sha }}}}
-        cache-from: type=gha
-        cache-to: type=gha,mode=max
+name: 'Build & Push Docker Image'
+description: 'Build multi-stage Docker image and push to registry'
+inputs:
+  registry:
+    description: 'Docker registry URL'
+    required: true
+  image-name:
+    description: 'Docker image name'
+    required: true
+  dockerfile-path:
+    description: 'Path to Dockerfile'
+    required: false
+    default: 'Dockerfile'
+  build-context:
+    description: 'Docker build context'
+    required: false
+    default: '.'
+outputs:
+  image-tag:
+    description: 'Full image tag with registry'
+    value: ${{{{ steps.build.outputs.tags }}}}
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Login to Registry
+      uses: docker/login-action@v3
+      with:
+        registry: ${{{{ inputs.registry }}}}
+        username: ${{{{ secrets.REGISTRY_USERNAME }}}}
+        password: ${{{{ secrets.REGISTRY_PASSWORD }}}}
+
+    - name: Build and push
+      id: build
+      uses: docker/build-push-action@v5
+      with:
+        context: ${{{{ inputs.build-context }}}}
+        file: ${{{{ inputs.dockerfile-path }}}}
+        push: true
+        tags: ${{{{ inputs.registry }}}}/${{{{ inputs.image-name }}}}:${{{{ github.sha }}}}
+        cache-from: type=gha
+        cache-to: type=gha,mode=max

package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs

@@ -1,27 +1,27 @@
-name: 'Health Check'
-description: 'Poll health endpoint until ready'
-inputs:
-  url:
-    description: 'Health check URL'
-    required: true
-  timeout:
-    description: 'Timeout in seconds'
-    required: false
-    default: '300'
-  interval:
-    description: 'Polling interval in seconds'
-    required: false
-    default: '5'
-
-runs:
-  using: 'composite'
-  steps:
-    - name: Wait for health
-      shell: bash
-      run: |
-        RETRIES=$(($${{{{ inputs.timeout }}}} / ${{{{ inputs.interval }}}}))
-        curl --retry $RETRIES \
-             --retry-delay ${{{{ inputs.interval }}}} \
-             --retry-connrefused \
-             --fail \
-             ${{{{ inputs.url }}}}
+name: 'Health Check'
+description: 'Poll health endpoint until ready'
+inputs:
+  url:
+    description: 'Health check URL'
+    required: true
+  timeout:
+    description: 'Timeout in seconds'
+    required: false
+    default: '300'
+  interval:
+    description: 'Polling interval in seconds'
+    required: false
+    default: '5'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Wait for health
+      shell: bash
+      run: |
+        RETRIES=$(($${{{{ inputs.timeout }}}} / ${{{{ inputs.interval }}}}))
+        curl --retry $RETRIES \
+             --retry-delay ${{{{ inputs.interval }}}} \
+             --retry-connrefused \
+             --fail \
+             ${{{{ inputs.url }}}}