forgedev 1.3.0 → 1.4.1

package/templates/backend/express/src/routes/health.ts.template

@@ -1,27 +1,35 @@
-import { Router } from 'express';
-
-export const healthRouter = Router();
-
-// Liveness probe — always returns ok if the process is running
-healthRouter.get('/health', (_req, res) => {
-  res.json({
-    status: 'ok',
-    timestamp: new Date().toISOString(),
-    uptime: process.uptime(),
-    service: '{{PROJECT_NAME}}',
-  });
-});
-
-// Readiness probe — add real dependency checks (database, cache, etc.)
-// before using this as a Kubernetes readiness probe
-healthRouter.get('/healthz', async (_req, res) => {
-  // TODO: Replace with actual checks, e.g.:
-  //   const db = await prisma.$queryRaw`SELECT 1`;
-  const checks: Record<string, string> = {};
-
-  res.json({
-    status: 'ok',
-    service: '{{PROJECT_NAME}}',
-    checks,
-  });
-});
+import { Router } from 'express';
+import { prisma } from '../lib/prisma';
+
+export const healthRouter = Router();
+
+// Liveness probe — always returns ok if the process is running
+healthRouter.get('/health', (_req, res) => {
+  res.json({
+    status: 'ok',
+    timestamp: new Date().toISOString(),
+    uptime: process.uptime(),
+    service: '{{PROJECT_NAME}}',
+  });
+});
+
+// Readiness probe — verifies database connectivity
+healthRouter.get('/healthz', async (_req, res) => {
+  let dbStatus = 'disconnected';
+
+  try {
+    await prisma.$queryRaw`SELECT 1`;
+    dbStatus = 'connected';
+  } catch {
+    dbStatus = 'disconnected';
+  }
+
+  const status = dbStatus === 'connected' ? 'ok' : 'degraded';
+  const statusCode = dbStatus === 'connected' ? 200 : 503;
+
+  res.status(statusCode).json({
+    status,
+    service: '{{PROJECT_NAME}}',
+    checks: { database: dbStatus },
+  });
+});

package/templates/backend/fastapi/backend/app/main.py.template

@@ -1,60 +1,67 @@
-from contextlib import asynccontextmanager
-from fastapi import FastAPI, Request
-from fastapi.middleware.cors import CORSMiddleware
-from fastapi.responses import JSONResponse
-
-from app.api.health import router as health_router
-from app.portal.router import router as portal_router
-from app.core.config import settings
-from app.core.errors import AppError
-
-
-@asynccontextmanager
-async def lifespan(app: FastAPI):
-    # Startup: connect to database with retry
-    from app.db.session import engine, connect_with_retry
-
-    await connect_with_retry(engine)
-    yield
-    # Shutdown: close database connections gracefully
-    await engine.dispose()
-
-
-app = FastAPI(
-    title="{{PROJECT_NAME_PASCAL}}",
-    version="0.1.0",
-    lifespan=lifespan,
-)
-
-# CORS
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=settings.cors_origins,
-    allow_credentials=True,
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
-
-# Routes
-app.include_router(health_router, tags=["health"])
-app.include_router(portal_router)
-
-
-# Global exception handler - never leak stack traces
-@app.exception_handler(AppError)
-async def app_error_handler(request: Request, exc: AppError):
-    return JSONResponse(
-        status_code=exc.status_code,
-        content={"error": {"code": exc.code, "message": exc.message}},
-    )
-
-
-@app.exception_handler(Exception)
-async def global_exception_handler(request: Request, exc: Exception):
-    import logging
-
-    logging.exception("Unhandled exception")
-    return JSONResponse(
-        status_code=500,
-        content={"error": {"code": "INTERNAL_ERROR", "message": "An unexpected error occurred"}},
-    )
+import logging
+import sys
+from contextlib import asynccontextmanager
+
+from fastapi import FastAPI, Request
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import JSONResponse
+from pythonjsonlogger.json import JsonFormatter
+
+from app.api.health import router as health_router
+from app.portal.router import router as portal_router
+from app.core.config import settings
+from app.core.errors import AppError
+
+# Structured JSON logging
+handler = logging.StreamHandler(sys.stdout)
+handler.setFormatter(JsonFormatter("%(asctime)s %(name)s %(levelname)s %(message)s"))
+logging.basicConfig(level=logging.INFO, handlers=[handler])
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # Startup: connect to database with retry
+    from app.db.session import engine, connect_with_retry
+
+    await connect_with_retry(engine)
+    yield
+    # Shutdown: close database connections gracefully
+    await engine.dispose()
+
+
+app = FastAPI(
+    title="{{PROJECT_NAME_PASCAL}}",
+    version="0.1.0",
+    lifespan=lifespan,
+)
+
+# CORS
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=settings.cors_origins,
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Routes
+app.include_router(health_router, tags=["health"])
+app.include_router(portal_router)
+
+
+# Global exception handler - never leak stack traces
+@app.exception_handler(AppError)
+async def app_error_handler(request: Request, exc: AppError):
+    return JSONResponse(
+        status_code=exc.status_code,
+        content={"error": {"code": exc.code, "message": exc.message}},
+    )
+
+
+@app.exception_handler(Exception)
+async def global_exception_handler(request: Request, exc: Exception):
+    logging.exception("Unhandled exception")
+    return JSONResponse(
+        status_code=500,
+        content={"error": {"code": "INTERNAL_ERROR", "message": "An unexpected error occurred"}},
+    )

package/templates/backend/fastapi/backend/requirements.txt.template

@@ -1,16 +1,18 @@
-fastapi>=0.115.0
-uvicorn[standard]>=0.34.0
-sqlalchemy[asyncio]>=2.0.38
-asyncpg>=0.30.0
-pydantic>=2.11.0
-pydantic-settings>=2.8.0
-alembic>=1.15.0
-python-jose[cryptography]>=3.4.0
-passlib[bcrypt]>=1.7.4
-httpx>=0.28.0
-pytest>=8.3.0
-pytest-asyncio>=0.25.0
-markdown>=3.7
-bleach>=6.2.0
-ruff>=0.11.0
-pyright>=1.1.400
+fastapi>=0.115.0
+uvicorn[standard]>=0.34.0
+sqlalchemy[asyncio]>=2.0.38
+asyncpg>=0.30.0
+pydantic>=2.11.0
+pydantic-settings>=2.8.0
+alembic>=1.15.0
+python-jose[cryptography]>=3.4.0
+passlib[bcrypt]>=1.7.4
+httpx>=0.28.0
+pytest>=8.3.0
+pytest-asyncio>=0.25.0
+markdown>=3.7
+bleach>=6.2.0
+# v3 uses: from pythonjsonlogger.json import JsonFormatter (v2 used pythonjsonlogger.jsonlogger)
+python-json-logger>=3.2.0
+ruff>=0.11.0
+pyright>=1.1.400

package/templates/backend/hono/package.json.template

@@ -1,31 +1,33 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "lint": "eslint .",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "db:push": "prisma db push",
-    "db:studio": "prisma studio",
-    "db:generate": "prisma generate"
-  },
-  "dependencies": {
-    "hono": "^4.7.0",
-    "@hono/node-server": "^1.14.0",
-    "@prisma/client": "^6.6.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.8.3",
-    "@types/node": "^22.14.0",
-    "tsx": "^4.19.0",
-    "eslint": "^9.25.0",
-    "prisma": "^6.6.0",
-    "vitest": "^3.1.1"
-  }
-}
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "db:push": "prisma db push",
+    "db:migrate": "prisma migrate dev",
+    "db:migrate:deploy": "prisma migrate deploy",
+    "db:studio": "prisma studio",
+    "db:generate": "prisma generate"
+  },
+  "dependencies": {
+    "hono": "^4.7.0",
+    "@hono/node-server": "^1.14.0",
+    "@prisma/client": "^6.6.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "@types/node": "^22.14.0",
+    "tsx": "^4.19.0",
+    "eslint": "^9.25.0",
+    "prisma": "^6.6.0",
+    "vitest": "^3.1.1"
+  }
+}

package/templates/backend/hono/src/lib/prisma.ts.template

@@ -0,0 +1,32 @@
+import { PrismaClient } from '@prisma/client';
+
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 1000;
+
+async function connectWithRetry(client: PrismaClient, retries = MAX_RETRIES): Promise<void> {
+  for (let attempt = 1; attempt <= retries; attempt++) {
+    try {
+      await client.$connect();
+      return;
+    } catch (error) {
+      if (attempt === retries) throw error;
+      const delay = RETRY_DELAY_MS * Math.pow(2, attempt - 1);
+      console.warn(`Database connection attempt ${attempt} failed. Retrying in ${delay}ms...`);
+      await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+  }
+}
+
+export const prisma = new PrismaClient({
+  log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
+});
+
+// Graceful shutdown
+const shutdownHandler = async () => {
+  await prisma.$disconnect();
+};
+
+process.on('SIGTERM', shutdownHandler);
+process.on('SIGINT', shutdownHandler);
+
+export { connectWithRetry };

package/templates/backend/hono/src/routes/health.ts.template

@@ -1,27 +1,38 @@
-import { Hono } from 'hono';
-
-export const healthRoutes = new Hono();
-
-// Liveness probe — always returns ok if the process is running
-healthRoutes.get('/health', (c) => {
-  return c.json({
-    status: 'ok',
-    timestamp: new Date().toISOString(),
-    uptime: process.uptime(),
-    service: '{{PROJECT_NAME}}',
-  });
-});
-
-// Readiness probe — add real dependency checks (database, cache, etc.)
-// before using this as a Kubernetes readiness probe
-healthRoutes.get('/healthz', async (c) => {
-  // TODO: Replace with actual checks, e.g.:
-  //   const db = await prisma.$queryRaw`SELECT 1`;
-  const checks: Record<string, string> = {};
-
-  return c.json({
-    status: 'ok',
-    service: '{{PROJECT_NAME}}',
-    checks,
-  });
-});
+import { Hono } from 'hono';
+import { prisma } from '../lib/prisma';
+
+export const healthRoutes = new Hono();
+
+// Liveness probe — always returns ok if the process is running
+healthRoutes.get('/health', (c) => {
+  return c.json({
+    status: 'ok',
+    timestamp: new Date().toISOString(),
+    uptime: process.uptime(),
+    service: '{{PROJECT_NAME}}',
+  });
+});
+
+// Readiness probe — verifies database connectivity
+healthRoutes.get('/healthz', async (c) => {
+  let dbStatus = 'disconnected';
+
+  try {
+    await prisma.$queryRaw`SELECT 1`;
+    dbStatus = 'connected';
+  } catch {
+    dbStatus = 'disconnected';
+  }
+
+  const status = dbStatus === 'connected' ? 'ok' : 'degraded';
+  const statusCode = dbStatus === 'connected' ? 200 : 503;
+
+  return c.json(
+    {
+      status,
+      service: '{{PROJECT_NAME}}',
+      checks: { database: dbStatus },
+    },
+    statusCode,
+  );
+});

package/templates/base/.gitignore.template

@@ -1,29 +1,32 @@
-# Dependencies
-node_modules/
-
-# Environment
-.env
-.env.local
-.env.*.local
-
-# Build output
-dist/
-.next/
-out/
-build/
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Testing
-coverage/
-test-results/
-playwright-report/
-{{EXTRA_IGNORES}}
+# Dependencies
+node_modules/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Build output
+dist/
+.next/
+out/
+build/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+coverage/
+test-results/
+playwright-report/
+
+# Kubernetes secrets (never commit real credentials)
+k8s/secrets.yml
+{{EXTRA_IGNORES}}

package/templates/claude-code/commands/workflows.md

@@ -1,52 +1,52 @@
-Show the developer what workflows are available.
-
-## Available Workflows
-
-### Development
-- `/plan` - Create an implementation plan before writing code
-- `/tdd` - Write failing tests first, then implement (test-driven development)
-- `/build-fix` - Fix build, lint, and type errors incrementally
-- `/fix-loop` - Automated fix-review-regression loop until green
-- `/build-ui` - Build frontend UI with AI-powered generation (Google Stitch + UI UX Pro Max)
-- `/code-review` - Review changes for security and quality (required before commit)
-- `/simplify` - Find duplicate code, long files, and extract shared utilities
-
-### Daily
-- `/help` - Not sure what to do? This guides you to the right workflow
-- `/status` - Run all checks and show a project dashboard
-- `/next` - Figure out what to work on next
-
-### Verification
-- `/verify-all` - Run lint, type check, tests, then launch all reviewers
-- `/full-audit` - Run every audit and review agent in a single pass
-- `/audit-spec` - Validate implementation against a spec/PRD
-- `/audit-wiring` - Find dead or unwired features
-- `/audit-security` - Run a security audit
-- `/verify-intent` - Verify all agents comply with Intent Verification Protocol
-
-### Strategy
-- Use `product-strategist` agent - Research competitors, evaluate project maturity, recommend improvements
-
-### Release
-- `/pre-pr` - Prepare and create a pull request
-- `/run-uat` - Execute UAT scenarios
-- `/live-uat` - Run live UAT by interacting with the running application
-
-### Generation
-- `/generate-prd` - Generate a PRD from the current codebase
-- `/generate-sdd` - Generate a Software Design Document from the codebase
-- `/generate-uat` - Generate UAT scenarios and checklists
-- `/optimize-claude-md` - Slim down an oversized CLAUDE.md
-
-### Session
-- `/save-session` - Save current work context for later resumption
-- `/resume-session` - Load a saved session and continue where you left off
-
-## Quality Gates (automatic)
-
-These run automatically, you don't need to remember them:
-- **On commit**: Pre-commit gate runs lint, tests, secrets check, and requires code review
-- **On stop**: Code hygiene check runs automatically
-
-## Quick Start
-Run `/status` to see where things stand, then `/next` to pick up work.
+Show the developer what workflows are available.
+
+## Available Workflows
+
+### Development
+- `/plan` - Create an implementation plan before writing code
+- `/tdd` - Write failing tests first, then implement (test-driven development)
+- `/build-fix` - Fix build, lint, and type errors incrementally
+- `/fix-loop` - Automated fix-review-regression loop until green
+- `/build-ui` - Build frontend UI with AI-powered generation (Google Stitch + UI UX Pro Max)
+- `/code-review` - Review changes for security and quality (required before commit)
+- `/simplify` - Find duplicate code, long files, and extract shared utilities
+
+### Daily
+- `/help` - Not sure what to do? This guides you to the right workflow
+- `/status` - Run all checks and show a project dashboard
+- `/next` - Figure out what to work on next
+
+### Verification
+- `/verify-all` - Run lint, type check, tests, then launch all reviewers
+- `/full-audit` - Run every audit and review agent in a single pass
+- `/audit-spec` - Validate implementation against a spec/PRD
+- `/audit-wiring` - Find dead or unwired features
+- `/audit-security` - Run a security audit
+- `/verify-intent` - Verify all agents comply with Intent Verification Protocol
+
+### Strategy
+- `/product-strategist` - Research competitors, evaluate project maturity, recommend improvements
+
+### Release
+- `/pre-pr` - Prepare and create a pull request
+- `/run-uat` - Execute UAT scenarios
+- `/live-uat` - Run live UAT by interacting with the running application
+
+### Generation
+- `/generate-prd` - Generate a PRD from the current codebase
+- `/generate-sdd` - Generate a Software Design Document from the codebase
+- `/generate-uat` - Generate UAT scenarios and checklists
+- `/optimize-claude-md` - Slim down an oversized CLAUDE.md
+
+### Session
+- `/save-session` - Save current work context for later resumption
+- `/resume-session` - Load a saved session and continue where you left off
+
+## Quality Gates (automatic)
+
+These run automatically, you don't need to remember them:
+- **On commit**: Pre-commit gate runs lint, tests, secrets check, and requires code review
+- **On stop**: Code hygiene check runs automatically
+
+## Quick Start
+Run `/status` to see where things stand, then `/next` to pick up work.

package/templates/database/prisma-postgres/prisma/schema.prisma.template

@@ -1,18 +1,19 @@
-generator client {
-  provider = "prisma-client-js"
-}
-
-datasource db {
-  provider = "postgresql"
-  url      = env("DATABASE_URL")
-}
-
-// Add your models below
-// Example:
-// model User {
-//   id        String   @id @default(cuid())
-//   email     String   @unique
-//   name      String?
-//   createdAt DateTime @default(now())
-//   updatedAt DateTime @updatedAt
-// }
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+// Starting point — modify or remove this model to match your project needs
+model User {
+  id        String   @id @default(cuid())
+  email     String   @unique
+  name      String?
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+
+// Add additional models below