ecosystem.config.js

/**
 * PM2 ecosystem config — local dev server pool for @webhouse/cms test sites.
 *
 * What PM2 manages: Next.js sites that need long-running dev servers with HMR.
 * What PM2 does NOT manage: static sites (examples/static/*, examples/landing,
 *   examples/blog, maurseth). Those are served on-demand by CMS admin via sirv
 *   from each site's dist/ directory — see api/preview-serve/route.ts.
 *
 * Usage:
 *   bash scripts/pm2-pool.sh up       # start pool (kills conflicting standalone servers first)
 *   bash scripts/pm2-pool.sh down     # stop + delete pool
 *   bash scripts/pm2-pool.sh status
 *   bash scripts/pm2-pool.sh logs [site]
 *
 * Or directly:
 *   pnpm dlx pm2 start ecosystem.config.js
 *   pnpm dlx pm2 list
 *   pnpm dlx pm2 logs cms-docs
 *
 * Port 3010 — the CMS admin dev server. PM2 manages it now (was manual
 * before so the user wouldn't lose their session to a Claude Code mistake).
 * Hard rule for Claude Code: NEVER kill/pkill/lsof+kill it on its own;
 * use `pm2 restart cms-admin` only when explicitly asked by the user.
 *
 * The cms-admin entry is the one exception to the "no pnpm wrapper"
 * note below: the user wants `pnpm dev` literally so it matches their
 * manual workflow muscle memory. If next crashes inside the wrapper PM2
 * may not auto-restart it — `pm2 restart cms-admin` to recover.
 *
 * Note: We invoke `next` directly (not via `pnpm dev`) for the test sites
 * so PM2 manages the actual Next.js process. With a pnpm wrapper, if Next
 * crashes the wrapper survives as a zombie and PM2 never restarts it.
 */

const nextSite = (name, cwd, port) => ({
  name,
  cwd,
  // Wrap in bash to raise open-file limit BEFORE next dev boots — same EMFILE
  // problem as cmsAdminDev. macOS gives PM2 children maxfiles=256 which
  // Turbopack/Watchpack exhausts.
  script: "/opt/homebrew/bin/bash",
  args: '-c "ulimit -n 8192 && node_modules/next/dist/bin/next dev"',
  interpreter: "none",
  env: { PORT: String(port), NODE_ENV: "development" },
  autorestart: true,
  watch: false,
  max_memory_restart: "1G",
  time: true,
  listen_timeout: 15000,
  kill_timeout: 5000,
});

// Static site served from a pre-built dist/ directory via sirv-cli on a fixed
// port. Use this for sites that have no Next.js dev server (CMS-built static
// sites: landing, examples/static/*, examples/blog, maurseth). The dist/
// must be pre-built — `pnpm build` or `npx cms build` in the site dir.
const staticSite = (name, cwd, port) => ({
  name,
  cwd,
  // sirv-cli is hoisted into the monorepo's pnpm store. We invoke its bin.js
  // directly via node so PM2 manages the actual process (no shell wrapper
  // zombie problem). --single makes 404s fall back to index.html, --quiet
  // suppresses per-request logging that would flood pm2 logs.
  script: "/Users/cb/Apps/webhouse/cms/node_modules/.pnpm/sirv-cli@3.0.1/node_modules/sirv-cli/bin.js",
  args: `dist --port ${port} --host 0.0.0.0 --single --quiet`,
  interpreter: "node",
  env: {},
  autorestart: true,
  watch: false,
  max_memory_restart: "256M",
  time: true,
  listen_timeout: 5000,
  kill_timeout: 5000,
});

// Live CMS admin dev server on port 3010. Runs `pnpm dev` from
// packages/cms-admin to match the user's manual workflow exactly.
// If the inner next process crashes the pnpm wrapper may survive as a
// zombie — `pm2 restart cms-admin` will recover it.
const cmsAdminDev = {
  name: "cms-admin",
  cwd: "/Users/cb/Apps/webhouse/cms/packages/cms-admin",
  // Wrap in bash to raise the open-file limit BEFORE Next.js boots.
  // macOS launchctl gives PM2 child processes maxfiles=256, which Turbopack/
  // Watchpack exhausts in a monorepo this size — symptom: EMFILE errors and
  // every route returning 404 because the compiler can't index files.
  script: "/opt/homebrew/bin/bash",
  // dev:https = `next dev --port 3010 --experimental-https --hostname 0.0.0.0`
  // Required for WebAuthn / Web Crypto / iOS Safari testing over the LAN.
  // macOS kern.maxfilesperproc is 61440 — ulimit will cap any higher request
  // to that. 65536 is requested explicitly to make the cap behavior obvious.
  // Using `;` instead of `&&` so the dev server still starts if ulimit fails
  // (permissions, non-macOS host). Failure is logged to stderr for visibility.
  args: '-c "ulimit -n 65536 || echo WARN: ulimit failed — dev server may hit EMFILE >&2; pnpm dev:https"',
  interpreter: "none",
  // PORT is also passed by `next dev --port 3010` inside the pnpm script,
  // but setting it here too lets `pm2 jlist` / scripts/pm2-ports.sh
  // surface the port in the listing.
  env: { NODE_ENV: "development", PORT: "3010" },
  autorestart: true,
  watch: false,
  max_memory_restart: "2G",
  time: true,
  listen_timeout: 30000, // Next dev server boot is slow
  kill_timeout: 5000,
};

// Production build of cms-admin — regular `next start` (NOT standalone).
// Full node_modules access so jiti can resolve cms.config.ts imports from
// any framework org (Django, .NET, PHP, etc.) without symlink hacks.
// Build: cd packages/cms-admin && pnpm build
// Standalone mode is only used in the Dockerfile for minimal image size.
const cmsAdminProd = {
  name: "cms-admin-prod",
  cwd: "/Users/cb/Apps/webhouse/cms/packages/cms-admin",
  // Source .env.local first so CMS_CONFIG_PATH and other secrets are
  // available at runtime. `next start` with output:"standalone" in
  // next.config.ts doesn't load .env.local itself.
  script: "/opt/homebrew/bin/bash",
  args: '-c "set -a && source .env.local && set +a && node_modules/next/dist/bin/next start --port 4010"',
  interpreter: "none",
  env: {
    PORT: "4010",
    NODE_ENV: "production",
  },
  autorestart: true,
  watch: false,
  max_memory_restart: "1G",
  time: true,
  listen_timeout: 15000,
  kill_timeout: 5000,
};

module.exports = {
  apps: [
    cmsAdminDev,
    nextSite("webhouse-site", "/Users/cb/Apps/webhouse/webhouse-site", 3009),
    nextSite("cms-docs",      "/Users/cb/Apps/webhouse/cms-docs",      3036),
    nextSite("sproutlake",    "/Users/cb/Apps/cbroberg/sproutlake",    3002),
    staticSite("landing",     "/Users/cb/Apps/webhouse/cms/examples/landing", 3011),
    cmsAdminProd,
  ],
};