@polymorphism-tech/morph-spec 7.9.4 → 8.1.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/docker-compose.template.yml

@@ -1,50 +1,50 @@
-# 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
+# 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 + 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*