forgedev 1.3.0 → 1.4.1

package/src/utils.js

@@ -1,116 +1,245 @@
-import chalk from 'chalk';
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-export const ROOT_DIR = path.resolve(__dirname, '..');
-
-export const log = {
-  info: (msg) => console.log(chalk.cyan(msg)),
-  success: (msg) => console.log(chalk.green(msg)),
-  warn: (msg) => console.error(chalk.yellow(msg)),
-  error: (msg) => console.error(chalk.red(msg)),
-  step: (n, total, msg) => console.log(chalk.blue(`[${n}/${total}] ${msg}`)),
-  dim: (msg) => console.log(chalk.dim(msg)),
-};
-
-export function ensureDir(dirPath) {
-  fs.mkdirSync(dirPath, { recursive: true });
-}
-
-export function writeFile(dest, content) {
-  ensureDir(path.dirname(dest));
-  fs.writeFileSync(dest, content, 'utf-8');
-}
-
-export function readTemplate(templatePath) {
-  return fs.readFileSync(templatePath, 'utf-8');
-}
-
-export function replaceVars(content, vars) {
-  return content.replace(/\{\{(\w+)\}\}/g, (match, key) => {
-    return key in vars ? vars[key] : match;
-  });
-}
-
-export function toPascalCase(str) {
-  return str
-    .split(/[-_\s]+/)
-    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-    .join('');
-}
-
-export function copyEnvCmd() {
-  return process.platform === 'win32'
-    ? 'copy .env.example .env'
-    : 'cp .env.example .env';
-}
-
-export function toSnakeCase(str) {
-  return str.replace(/[-\s]+/g, '_').toLowerCase();
-}
-
-export function toKebabCase(str) {
-  return str.replace(/[\s_]+/g, '-').toLowerCase();
-}
-
-export function getStackCommands(stackId) {
-  if (stackId === 'nextjs-fullstack') {
-    return {
-      LINT_COMMAND: 'npx eslint .',
-      TYPE_CHECK_COMMAND: 'npx tsc --noEmit',
-      TEST_COMMAND: 'npx vitest run',
-      BUILD_COMMAND: 'npm run build',
-      DEV_COMMAND: 'npm run dev',
-    };
-  }
-  if (stackId === 'fastapi-backend') {
-    return {
-      LINT_COMMAND: 'ruff check .',
-      TYPE_CHECK_COMMAND: 'pyright',
-      TEST_COMMAND: 'pytest',
-      BUILD_COMMAND: 'docker build -t app .',
-      DEV_COMMAND: 'uvicorn app.main:app --reload',
-    };
-  }
-  if (stackId === 'polyglot-fullstack') {
-    return {
-      LINT_COMMAND: 'cd frontend && npx eslint . && cd ../backend && ruff check .',
-      TYPE_CHECK_COMMAND: 'cd frontend && npx tsc --noEmit',
-      TEST_COMMAND: 'cd frontend && npx vitest run && cd ../backend && pytest',
-      BUILD_COMMAND: 'docker compose build',
-      DEV_COMMAND: 'docker compose up',
-    };
-  }
-  if (stackId === 'react-express') {
-    return {
-      LINT_COMMAND: 'cd frontend && npx eslint . && cd ../backend && npx eslint .',
-      TYPE_CHECK_COMMAND: 'cd frontend && npx tsc --noEmit && cd ../backend && npx tsc --noEmit',
-      TEST_COMMAND: 'cd frontend && npx vitest run && cd ../backend && npx vitest run',
-      BUILD_COMMAND: 'cd frontend && npm run build && cd ../backend && npm run build',
-      DEV_COMMAND: 'npx concurrently "cd frontend && npm run dev" "cd backend && npm run dev"',
-    };
-  }
-  if (stackId === 'remix-fullstack') {
-    return {
-      LINT_COMMAND: 'npx eslint .',
-      TYPE_CHECK_COMMAND: 'npx tsc --noEmit',
-      TEST_COMMAND: 'npx vitest run',
-      BUILD_COMMAND: 'npm run build',
-      DEV_COMMAND: 'npm run dev',
-    };
-  }
-  if (stackId === 'hono-api') {
-    return {
-      LINT_COMMAND: 'npx eslint .',
-      TYPE_CHECK_COMMAND: 'npx tsc --noEmit',
-      TEST_COMMAND: 'npx vitest run',
-      BUILD_COMMAND: 'npm run build',
-      DEV_COMMAND: 'npm run dev',
-    };
-  }
-  return {};
-}
+import chalk from 'chalk';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const ROOT_DIR = path.resolve(__dirname, '..');
+
+export const log = {
+  info: (msg) => console.log(chalk.cyan(msg)),
+  success: (msg) => console.log(chalk.green(msg)),
+  warn: (msg) => console.error(chalk.yellow(msg)),
+  error: (msg) => console.error(chalk.red(msg)),
+  step: (n, total, msg) => console.log(chalk.blue(`[${n}/${total}] ${msg}`)),
+  dim: (msg) => console.log(chalk.dim(msg)),
+};
+
+export function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+export function writeFile(dest, content) {
+  ensureDir(path.dirname(dest));
+  fs.writeFileSync(dest, content, 'utf-8');
+}
+
+export function readTemplate(templatePath) {
+  return fs.readFileSync(templatePath, 'utf-8');
+}
+
+export function replaceVars(content, vars) {
+  return content.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+    return key in vars ? vars[key] : match;
+  });
+}
+
+export function toPascalCase(str) {
+  return str
+    .split(/[-_\s]+/)
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join('');
+}
+
+export function copyEnvCmd() {
+  return process.platform === 'win32'
+    ? 'copy .env.example .env'
+    : 'cp .env.example .env';
+}
+
+export function toSnakeCase(str) {
+  return str.replace(/[-\s]+/g, '_').toLowerCase();
+}
+
+export function toKebabCase(str) {
+  return str.replace(/[\s_]+/g, '-').toLowerCase();
+}
+
+// ─── Shared directory walker ─────────────────────────────────────────
+
+export const DEFAULT_SKIP_DIRS = ['node_modules', '.next', '__pycache__', '.git', 'venv', '.venv', 'dist', 'build'];
+
+export function walkDir(dir, { ext, skipDirs = [], maxDepth = 20 } = {}, _depth = 0) {
+  if (_depth > maxDepth) return [];
+  const results = [];
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch (err) {
+    if (err?.code !== 'ENOENT') {
+      log.warn(`walkDir: skipping ${dir} (${err?.code || err?.message})`);
+    }
+    return results;
+  }
+  for (const entry of entries) {
+    if (entry.isSymbolicLink()) continue;
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (skipDirs.includes(entry.name)) continue;
+      results.push(...walkDir(fullPath, { ext, skipDirs, maxDepth }, _depth + 1));
+    } else {
+      if (!ext || entry.name.endsWith(ext)) {
+        results.push(fullPath);
+      }
+    }
+  }
+  return results;
+}
+
+// ─── Single source of truth for all per-stack metadata ──────────────
+// Adding a new stack? Add one entry here. Nothing else to touch in utils.js.
+
+const STACK_METADATA = {
+  'nextjs-fullstack': {
+    description: 'Next.js full-stack application with TypeScript, Tailwind CSS, Prisma, and PostgreSQL',
+    extraIgnores: '',
+    port: '3000',
+    commands: {
+      LINT_COMMAND: 'npx eslint .',
+      TYPE_CHECK_COMMAND: 'npx tsc --noEmit',
+      TEST_COMMAND: 'npx vitest run',
+      BUILD_COMMAND: 'npm run build',
+      DEV_COMMAND: 'npm run dev',
+    },
+    setupCommands: () => `npm install
+${copyEnvCmd()}
+npx prisma db push
+npm run dev`,
+    availableScripts: `- \`npm run dev\`: Start development server
+- \`npm run build\`: Production build
+- \`npm run lint\`: Run ESLint
+- \`npx prisma studio\`: Database GUI
+- \`npx vitest\`: Run unit tests
+- \`npx playwright test\`: Run E2E tests`,
+  },
+
+  'fastapi-backend': {
+    description: 'FastAPI backend service with SQLAlchemy, PostgreSQL, and Alembic',
+    extraIgnores: '\n# Python\n__pycache__/\n*.pyc\nvenv/\n.venv/\n*.egg-info/',
+    port: '8000',
+    commands: {
+      LINT_COMMAND: 'ruff check .',
+      TYPE_CHECK_COMMAND: 'pyright',
+      TEST_COMMAND: 'pytest',
+      BUILD_COMMAND: 'docker build -t app .',
+      DEV_COMMAND: 'uvicorn app.main:app --reload',
+    },
+    setupCommands: () => `cd backend
+python -m venv venv
+source venv/bin/activate  # Windows: venv\\Scripts\\activate
+pip install -r requirements.txt
+${copyEnvCmd()}
+uvicorn app.main:app --reload`,
+    availableScripts: `- \`uvicorn app.main:app --reload\`: Start dev server
+- \`pytest\`: Run tests
+- \`ruff check .\`: Run linter
+- \`alembic upgrade head\`: Run migrations`,
+  },
+
+  'polyglot-fullstack': {
+    description: 'Full-stack application with Next.js frontend and FastAPI backend',
+    extraIgnores: '\n# Python\n__pycache__/\n*.pyc\nvenv/\n.venv/\n*.egg-info/',
+    port: '3000',
+    commands: {
+      LINT_COMMAND: 'cd frontend && npx eslint . && cd ../backend && ruff check .',
+      TYPE_CHECK_COMMAND: 'cd frontend && npx tsc --noEmit',
+      TEST_COMMAND: 'cd frontend && npx vitest run && cd ../backend && pytest',
+      BUILD_COMMAND: 'docker compose build',
+      DEV_COMMAND: 'docker compose up',
+    },
+    setupCommands: () => `docker compose up -d postgres
+# Frontend
+cd frontend && npm install && npm run dev
+# Backend
+cd backend && pip install -r requirements.txt && uvicorn app.main:app --reload`,
+    availableScripts: `- \`docker compose up\`: Start all services
+- \`docker compose up -d postgres\`: Start database only
+- Frontend: \`cd frontend && npm run dev\`
+- Backend: \`cd backend && uvicorn app.main:app --reload\``,
+  },
+
+  'react-express': {
+    description: 'Full-stack application with React (Vite) frontend and Express backend',
+    extraIgnores: '\ndist/',
+    port: '3001', // Express backend port (frontend runs on Vite :5173)
+    commands: {
+      LINT_COMMAND: 'cd frontend && npx eslint . && cd ../backend && npx eslint .',
+      TYPE_CHECK_COMMAND: 'cd frontend && npx tsc --noEmit && cd ../backend && npx tsc --noEmit',
+      TEST_COMMAND: 'cd frontend && npx vitest run && cd ../backend && npx vitest run',
+      BUILD_COMMAND: 'cd frontend && npm run build && cd ../backend && npm run build',
+      DEV_COMMAND: 'npx concurrently "cd frontend && npm run dev" "cd backend && npm run dev"',
+    },
+    setupCommands: () => `# Frontend
+cd frontend && npm install && npm run dev
+# Backend (in a separate terminal)
+cd backend && npm install && ${copyEnvCmd()} && npx prisma db push && npm run dev`,
+    availableScripts: `- Frontend: \`cd frontend && npm run dev\` (Vite dev server)
+- Backend: \`cd backend && npm run dev\` (Express with tsx watch)
+- \`cd backend && npm run build\`: Build backend for production
+- \`cd frontend && npm run build\`: Build frontend for production
+- \`cd backend && npx prisma studio\`: Database GUI
+- \`cd frontend && npx vitest\`: Run frontend tests`,
+  },
+
+  'remix-fullstack': {
+    description: 'Full-stack Remix application with Vite, Tailwind CSS, and PostgreSQL',
+    extraIgnores: '\nbuild/',
+    port: '3000',
+    commands: {
+      LINT_COMMAND: 'npx eslint .',
+      TYPE_CHECK_COMMAND: 'npx tsc --noEmit',
+      TEST_COMMAND: 'npx vitest run',
+      BUILD_COMMAND: 'npm run build',
+      DEV_COMMAND: 'npm run dev',
+    },
+    setupCommands: () => `npm install
+${copyEnvCmd()}
+npx prisma db push
+npm run dev`,
+    availableScripts: `- \`npm run dev\`: Start Remix dev server
+- \`npm run build\`: Production build
+- \`npm run start\`: Start production server
+- \`npm run lint\`: Run ESLint
+- \`npx prisma studio\`: Database GUI
+- \`npx vitest\`: Run unit tests`,
+  },
+
+  'hono-api': {
+    description: 'Hono API service with TypeScript, Prisma, and PostgreSQL',
+    extraIgnores: '\ndist/',
+    port: '3000',
+    commands: {
+      LINT_COMMAND: 'npx eslint .',
+      TYPE_CHECK_COMMAND: 'npx tsc --noEmit',
+      TEST_COMMAND: 'npx vitest run',
+      BUILD_COMMAND: 'npm run build',
+      DEV_COMMAND: 'npm run dev',
+    },
+    setupCommands: () => `npm install
+${copyEnvCmd()}
+npx prisma db push
+npm run dev`,
+    availableScripts: `- \`npm run dev\`: Start Hono dev server (tsx watch)
+- \`npm run build\`: Compile TypeScript
+- \`npm run start\`: Start production server
+- \`npm run lint\`: Run ESLint
+- \`npx prisma studio\`: Database GUI
+- \`npx vitest\`: Run unit tests`,
+  },
+};
+
+export function getStackMetadata(stackId) {
+  const meta = STACK_METADATA[stackId];
+  if (!meta) {
+    log.warn(`No stack metadata for "${stackId}" — using empty defaults`);
+    return null;
+  }
+  return meta;
+}
+
+export function getStackCommands(stackId) {
+  const meta = STACK_METADATA[stackId];
+  return meta ? { ...meta.commands } : {};
+}

package/templates/auth/jwt-custom/backend/app/api/auth.py.template

@@ -1,45 +1,39 @@
-from fastapi import APIRouter, HTTPException
-from pydantic import BaseModel, EmailStr
-
-from app.core.security import create_access_token, hash_password, verify_password
-
-router = APIRouter(prefix="/auth", tags=["auth"])
-
-
-class LoginRequest(BaseModel):
-    email: EmailStr
-    password: str
-
-
-class RegisterRequest(BaseModel):
-    email: EmailStr
-    password: str
-    name: str
-
-
-class TokenResponse(BaseModel):
-    access_token: str
-    token_type: str = "bearer"
-
-
-@router.post("/login", response_model=TokenResponse)
-async def login(request: LoginRequest):
-    # TODO: Replace with actual database lookup
-    # user = await get_user_by_email(request.email)
-    # if not user or not verify_password(request.password, user.hashed_password):
-    #     raise HTTPException(status_code=401, detail="Invalid credentials")
-    raise HTTPException(status_code=501, detail="Implement user lookup")
-
-    token = create_access_token(data={"sub": request.email})
-    return TokenResponse(access_token=token)
-
-
-@router.post("/register", response_model=TokenResponse)
-async def register(request: RegisterRequest):
-    # TODO: Replace with actual database operations
-    # hashed = hash_password(request.password)
-    # user = await create_user(email=request.email, name=request.name, hashed_password=hashed)
-    raise HTTPException(status_code=501, detail="Implement user creation")
-
-    token = create_access_token(data={"sub": request.email})
-    return TokenResponse(access_token=token)
+from fastapi import APIRouter, HTTPException
+from pydantic import BaseModel, EmailStr
+
+from app.core.security import create_access_token, hash_password, verify_password  # noqa: F401 — used when implementing TODOs below
+
+router = APIRouter(prefix="/auth", tags=["auth"])
+
+
+class LoginRequest(BaseModel):
+    email: EmailStr
+    password: str
+
+
+class RegisterRequest(BaseModel):
+    email: EmailStr
+    password: str
+    name: str
+
+
+class TokenResponse(BaseModel):
+    access_token: str
+    token_type: str = "bearer"
+
+
+@router.post("/login")
+async def login(request: LoginRequest) -> TokenResponse:
+    # TODO: Replace with actual database lookup
+    # user = await get_user_by_email(request.email)
+    # if not user or not verify_password(request.password, user.hashed_password):
+    #     raise HTTPException(status_code=401, detail="Invalid credentials")
+    raise HTTPException(status_code=501, detail="Implement user lookup")
+
+
+@router.post("/register")
+async def register(request: RegisterRequest) -> TokenResponse:
+    # TODO: Replace with actual database operations
+    # hashed = hash_password(request.password)
+    # user = await create_user(email=request.email, name=request.name, hashed_password=hashed)
+    raise HTTPException(status_code=501, detail="Implement user creation")

package/templates/auth/jwt-custom/backend/app/core/security.py.template

@@ -1,37 +1,44 @@
-import os
-from datetime import datetime, timedelta, timezone
-
-from jose import JWTError, jwt
-from passlib.context import CryptContext
-
-from app.core.config import settings
-
-pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
-
-SECRET_KEY = os.environ.get("JWT_SECRET_KEY")
-if not SECRET_KEY:
-    raise RuntimeError("JWT_SECRET_KEY environment variable is required. Set it in your .env file.")
-ALGORITHM = "HS256"
-ACCESS_TOKEN_EXPIRE_MINUTES = 30
-
-
-def verify_password(plain_password: str, hashed_password: str) -> bool:
-    return pwd_context.verify(plain_password, hashed_password)
-
-
-def hash_password(password: str) -> str:
-    return pwd_context.hash(password)
-
-
-def create_access_token(data: dict, expires_delta: timedelta | None = None) -> str:
-    to_encode = data.copy()
-    expire = datetime.now(timezone.utc) + (expires_delta or timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES))
-    to_encode.update({"exp": expire})
-    return jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)
-
-
-def decode_access_token(token: str) -> dict | None:
-    try:
-        return jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
-    except JWTError:
-        return None
+import os
+from datetime import datetime, timedelta, timezone
+
+from jose import JWTError, jwt
+from passlib.context import CryptContext
+
+from app.core.config import settings
+
+pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+
+ALGORITHM = "HS256"
+ACCESS_TOKEN_EXPIRE_MINUTES = 30
+
+
+def _get_secret_key() -> str:
+    key = os.environ.get("JWT_SECRET_KEY", "")
+    if not key or len(key) < 32:
+        raise RuntimeError(
+            "JWT_SECRET_KEY must be set and at least 32 characters. "
+            'Generate one with: python -c "import secrets; print(secrets.token_urlsafe(32))"'
+        )
+    return key
+
+
+def verify_password(plain_password: str, hashed_password: str) -> bool:
+    return pwd_context.verify(plain_password, hashed_password)
+
+
+def hash_password(password: str) -> str:
+    return pwd_context.hash(password)
+
+
+def create_access_token(data: dict, expires_delta: timedelta | None = None) -> str:
+    to_encode = data.copy()
+    expire = datetime.now(timezone.utc) + (expires_delta or timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES))
+    to_encode.update({"exp": expire})
+    return jwt.encode(to_encode, _get_secret_key(), algorithm=ALGORITHM)
+
+
+def decode_access_token(token: str) -> dict | None:
+    try:
+        return jwt.decode(token, _get_secret_key(), algorithms=[ALGORITHM])
+    except JWTError:
+        return None

package/templates/backend/express/package.json.template

@@ -1,33 +1,35 @@
-{
-  "name": "{{PROJECT_NAME}}-server",
-  "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": {
-    "express": "^5.1.0",
-    "cors": "^2.8.5",
-    "@prisma/client": "^6.6.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.8.3",
-    "@types/node": "^22.14.0",
-    "@types/express": "^5.0.0",
-    "@types/cors": "^2.8.17",
-    "tsx": "^4.19.0",
-    "eslint": "^9.25.0",
-    "prisma": "^6.6.0",
-    "vitest": "^3.1.1"
-  }
-}
+{
+  "name": "{{PROJECT_NAME}}-server",
+  "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": {
+    "express": "^5.1.0",
+    "cors": "^2.8.5",
+    "@prisma/client": "^6.6.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "@types/node": "^22.14.0",
+    "@types/express": "^5.0.0",
+    "@types/cors": "^2.8.17",
+    "tsx": "^4.19.0",
+    "eslint": "^9.25.0",
+    "prisma": "^6.6.0",
+    "vitest": "^3.1.1"
+  }
+}

package/templates/backend/express/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 };