@polymorphism-tech/morph-spec 8.32.0 → 8.34.2

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,17 +1,29 @@
 # Docker Compose for Local Development
 # Next.js + Neon Stack
 #
-# Ports come from variables with sane defaults so `morph-spec e2e up` can hand
-# each feature worktree its own port block (see env-allocator.js). Hardcode
-# "3000:3000" here and two features running side by side collide on the host,
-# no matter what the harness injects — the container names would be distinct
-# and the ports would not.
+# One compose project per worktree. The harness sets
+# COMPOSE_PROJECT_NAME=morph-{feature}, which prefixes every container, network
+# and volume — so two features running side by side never share a resource.
+# Explicit `container_name:` entries are NOT prefixed, which is why this file
+# declares none: a named container is a collision waiting for the second
+# worktree.
 #
-# Healthchecks are what make `up --wait` meaningful: without them Compose
-# reports "started" the moment the process launches, and the e2e node would
-# navigate an application that is not serving yet.
+# Host ports come from the feature's port block (see env-allocator.js):
+#   PORT          block + 0   (web)
+#   API_PORT      block + 1   (api)
+#   POSTGRES_PORT block + 2   (postgres)
+#   REDIS_PORT    block + 3   (redis)
+# Every published port reads one of those variables with a single-stack
+# default. A fixed host port here would defeat the block no matter what the
+# harness injects — `morph-spec e2e up` and the verify e2e node refuse such a
+# compose inside a worktree (`compose-not-isolable`).
 #
-# The harness also exports PLAYWRIGHT_BASE_URL for the same allocated port, so
+# Named volumes are reclaimed by `morph-spec finish` when the feature closes
+# (`--keep-volumes` opts out). Healthchecks are what make `up --wait`
+# meaningful: without them Compose reports "started" the moment the process
+# launches, and the e2e node would navigate an application not serving yet.
+#
+# The harness also exports PLAYWRIGHT_BASE_URL for the allocated port, so
 # `playwright.config.ts` must read it instead of hardcoding a URL:
 #   baseURL: process.env.PLAYWRIGHT_BASE_URL ?? `http://localhost:${process.env.PORT ?? 3000}`
 
@@ -21,12 +33,11 @@ services:
     build:
       context: .
       dockerfile: Dockerfile.dev
-    container_name: {{kebabCase FEATURE_NAME}}-app
     ports:
       - "${PORT:-3000}:3000"
     environment:
       - NODE_ENV=development
-      - DATABASE_URL=${DATABASE_URL}
+      - DATABASE_URL=${DATABASE_URL:-postgresql://postgres:postgres@postgres:5432/${POSTGRES_DB:-app}}
     volumes:
       - .:/app
       - /app/node_modules
@@ -46,19 +57,18 @@ services:
   # PostgreSQL Database (Local development)
   postgres:
     image: postgres:15-alpine
-    container_name: {{kebabCase FEATURE_NAME}}-postgres
     restart: unless-stopped
     ports:
       - "${POSTGRES_PORT:-5432}:5432"
     environment:
       POSTGRES_USER: postgres
       POSTGRES_PASSWORD: postgres
-      POSTGRES_DB: {{snakeCase FEATURE_NAME}}
+      POSTGRES_DB: ${POSTGRES_DB:-app}
     volumes:
       - postgres-data:/var/lib/postgresql/data
       - ./migrations:/docker-entrypoint-initdb.d
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U postgres -d {{snakeCase FEATURE_NAME}}"]
+      test: ["CMD-SHELL", "pg_isready -U postgres -d ${POSTGRES_DB:-app}"]
       interval: 5s
       timeout: 5s
       retries: 10

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*