forgedev 1.3.0 → 1.4.1

package/src/recommender.js

@@ -1,310 +1,319 @@
-import chalk from 'chalk';
-
-export const SUPPORTED_STACKS = [
-  'nextjs-fullstack', 'fastapi-backend', 'polyglot-fullstack',
-  'react-express', 'remix-fullstack', 'hono-api',
-];
-
-export function recommend(serviceType, refinements) {
-  const config = {
-    projectName: null, // set by caller
-    serviceType,
-    frontend: null,
-    backend: null,
-    database: null,
-    auth: null,
-    testing: { unit: null, e2e: null, backend: null },
-    ai: refinements.ai || false,
-    realtime: refinements.realtime || false,
-    fileUploads: refinements.fileUploads || false,
-    deployment: refinements.deployment || 'docker',
-    claudeCode: refinements.claudeCode !== false,
-    templateModules: [],
-    stackId: null,
-  };
-
-  const lang = refinements.language || 'typescript';
-
-  switch (serviceType) {
-    case 'web_app':
-      if (refinements.framework === 'remix') {
-        return buildRemixFullstack(config, refinements);
-      }
-      return buildNextjsFullstack(config, refinements);
-
-    case 'full_stack':
-      if (lang === 'python') {
-        return buildPolyglotFullstack(config, refinements);
-      }
-      if (refinements.backend === 'express') {
-        return buildReactExpress(config, refinements);
-      }
-      return buildNextjsFullstack(config, refinements);
-
-    case 'api_service':
-      if (lang === 'python') {
-        return buildFastapiBackend(config, refinements);
-      }
-      return buildHonoApi(config, refinements);
-
-    case 'ai_service':
-      if (lang === 'python') {
-        return buildPolyglotFullstack(config, { ...refinements, ai: true });
-      }
-      return buildPolyglotFullstack(config, { ...refinements, ai: true, language: 'python' });
-
-    case 'mobile':
-    case 'cli_tool':
-    case 'desktop':
-    case 'extension':
-    case 'microservice':
-    case 'describe':
-      return unsupported(serviceType);
-
-    default:
-      return unsupported(serviceType);
-  }
-}
-
-function buildNextjsFullstack(config, refinements) {
-  config.stackId = 'nextjs-fullstack';
-  config.frontend = { framework: 'nextjs', language: 'typescript', styling: 'tailwind', ui: 'shadcn' };
-  config.backend = { framework: 'nextjs', language: 'typescript', orm: 'prisma' };
-  config.database = { type: 'postgresql', orm: 'prisma' };
-  config.testing = { unit: 'vitest', e2e: 'playwright', backend: null };
-
-  if (refinements.auth) {
-    config.auth = 'nextauth';
-  }
-
-  config.templateModules = [
-    { path: 'base', prefix: '' },
-    { path: 'frontend/nextjs', prefix: '' },
-    { path: 'docs-portal/nextjs', prefix: '' },
-    { path: 'database/prisma-postgres', prefix: '' },
-    { path: 'testing/vitest', prefix: '' },
-    { path: 'testing/playwright', prefix: '' },
-    { path: 'infra/docker-compose', prefix: '' },
-    { path: 'infra/github-actions', prefix: '' },
-  ];
-
-  if (refinements.auth) {
-    config.templateModules.push({ path: 'auth/nextauth', prefix: '' });
-  }
-
-  config.templateModules.push({ path: 'chainproof/base', prefix: '' });
-  config.templateModules.push({ path: 'chainproof/nextjs', prefix: '' });
-
-  if (refinements.ai) {
-    config.templateModules.push({ path: 'ai/guardrails-ts', prefix: '' });
-  }
-
-  return config;
-}
-
-function buildFastapiBackend(config, refinements) {
-  config.stackId = 'fastapi-backend';
-  config.frontend = null;
-  config.backend = { framework: 'fastapi', language: 'python', orm: 'sqlalchemy' };
-  config.database = { type: 'postgresql', orm: 'sqlalchemy' };
-  config.testing = { unit: null, e2e: null, backend: 'pytest' };
-
-  if (refinements.auth) {
-    config.auth = 'jwt-custom';
-  }
-
-  config.templateModules = [
-    { path: 'base', prefix: '' },
-    { path: 'backend/fastapi', prefix: '' },
-    { path: 'docs-portal/fastapi', prefix: '' },
-    { path: 'database/sqlalchemy-postgres', prefix: '' },
-    { path: 'testing/pytest', prefix: '' },
-    { path: 'infra/docker-compose', prefix: '' },
-    { path: 'infra/github-actions', prefix: '' },
-  ];
-
-  if (refinements.auth) {
-    config.templateModules.push({ path: 'auth/jwt-custom', prefix: '' });
-  }
-
-  config.templateModules.push({ path: 'chainproof/base', prefix: '' });
-  config.templateModules.push({ path: 'chainproof/fastapi', prefix: '' });
-
-  if (refinements.ai) {
-    config.templateModules.push({ path: 'ai/guardrails-py', prefix: '' });
-  }
-
-  return config;
-}
-
-function buildPolyglotFullstack(config, refinements) {
-  config.stackId = 'polyglot-fullstack';
-  config.frontend = { framework: 'nextjs', language: 'typescript', styling: 'tailwind', ui: 'shadcn' };
-  config.backend = { framework: 'fastapi', language: 'python', orm: 'sqlalchemy' };
-  config.database = { type: 'postgresql', orm: 'both' };
-  config.testing = { unit: 'vitest', e2e: 'playwright', backend: 'pytest' };
-  config.ai = refinements.ai || false;
-
-  if (refinements.auth) {
-    config.auth = 'both';
-  }
-
-  config.templateModules = [
-    { path: 'base', prefix: '' },
-    { path: 'frontend/nextjs', prefix: 'frontend' },
-    { path: 'docs-portal/nextjs', prefix: 'frontend' },
-    { path: 'backend/fastapi', prefix: '' },
-    { path: 'database/prisma-postgres', prefix: 'frontend' },
-    { path: 'database/sqlalchemy-postgres', prefix: '' },
-    { path: 'testing/vitest', prefix: 'frontend' },
-    { path: 'testing/playwright', prefix: '' },
-    { path: 'testing/pytest', prefix: '' },
-    { path: 'infra/docker-compose', prefix: '' },
-    { path: 'infra/github-actions', prefix: '' },
-  ];
-
-  if (refinements.auth) {
-    config.templateModules.push({ path: 'auth/nextauth', prefix: 'frontend' });
-    config.templateModules.push({ path: 'auth/jwt-custom', prefix: '' });
-  }
-
-  config.templateModules.push({ path: 'chainproof/base', prefix: '' });
-  config.templateModules.push({ path: 'chainproof/polyglot', prefix: '' });
-
-  if (refinements.ai) {
-    config.templateModules.push({ path: 'ai/guardrails-ts', prefix: 'frontend' });
-    config.templateModules.push({ path: 'ai/guardrails-py', prefix: '' });
-  }
-
-  return config;
-}
-
-function buildReactExpress(config, refinements) {
-  config.stackId = 'react-express';
-  config.frontend = { framework: 'react', language: 'typescript', styling: 'tailwind', ui: null };
-  config.backend = { framework: 'express', language: 'typescript', orm: 'prisma' };
-  config.database = { type: 'postgresql', orm: 'prisma' };
-  config.testing = { unit: 'vitest', e2e: null, backend: 'vitest' };
-
-  if (refinements.auth) {
-    config.auth = 'jwt-custom';
-  }
-
-  config.templateModules = [
-    { path: 'base', prefix: '' },
-    { path: 'frontend/react', prefix: 'frontend' },
-    { path: 'backend/express', prefix: 'backend' },
-    { path: 'database/prisma-postgres', prefix: 'backend' },
-    { path: 'testing/vitest', prefix: 'frontend' },
-    { path: 'testing/vitest', prefix: 'backend' },
-    { path: 'infra/docker-compose', prefix: '' },
-    { path: 'infra/github-actions', prefix: '' },
-  ];
-
-  config.templateModules.push({ path: 'chainproof/base', prefix: '' });
-
-  if (refinements.ai) {
-    config.templateModules.push({ path: 'ai/guardrails-ts', prefix: 'backend' });
-  }
-
-  return config;
-}
-
-function buildRemixFullstack(config, refinements) {
-  config.stackId = 'remix-fullstack';
-  config.frontend = { framework: 'remix', language: 'typescript', styling: 'tailwind', ui: null };
-  config.backend = { framework: 'remix', language: 'typescript', orm: 'prisma' };
-  config.database = { type: 'postgresql', orm: 'prisma' };
-  config.testing = { unit: 'vitest', e2e: null, backend: null };
-
-  if (refinements.auth) {
-    config.auth = 'nextauth';
-  }
-
-  config.templateModules = [
-    { path: 'base', prefix: '' },
-    { path: 'frontend/remix', prefix: '' },
-    { path: 'database/prisma-postgres', prefix: '' },
-    { path: 'testing/vitest', prefix: '' },
-    { path: 'infra/docker-compose', prefix: '' },
-    { path: 'infra/github-actions', prefix: '' },
-  ];
-
-  config.templateModules.push({ path: 'chainproof/base', prefix: '' });
-
-  if (refinements.ai) {
-    config.templateModules.push({ path: 'ai/guardrails-ts', prefix: '' });
-  }
-
-  return config;
-}
-
-function buildHonoApi(config, refinements) {
-  config.stackId = 'hono-api';
-  config.frontend = null;
-  config.backend = { framework: 'hono', language: 'typescript', orm: 'prisma' };
-  config.database = { type: 'postgresql', orm: 'prisma' };
-  config.testing = { unit: 'vitest', e2e: null, backend: 'vitest' };
-
-  if (refinements.auth) {
-    config.auth = 'jwt-custom';
-  }
-
-  config.templateModules = [
-    { path: 'base', prefix: '' },
-    { path: 'backend/hono', prefix: '' },
-    { path: 'database/prisma-postgres', prefix: '' },
-    { path: 'testing/vitest', prefix: '' },
-    { path: 'infra/docker-compose', prefix: '' },
-    { path: 'infra/github-actions', prefix: '' },
-  ];
-
-  config.templateModules.push({ path: 'chainproof/base', prefix: '' });
-
-  if (refinements.ai) {
-    config.templateModules.push({ path: 'ai/guardrails-ts', prefix: '' });
-  }
-
-  return config;
-}
-
-function unsupported(serviceType) {
-  return {
-    supported: false,
-    message: `"${serviceType}" is not yet supported in V1. Supported: web_app, full_stack, api_service, ai_service`,
-  };
-}
-
-export function formatStackSummary(config) {
-  if (config.supported === false) {
-    return chalk.yellow(config.message);
-  }
-
-  const lines = [];
-
-  if (config.frontend) {
-    const uiPart = config.frontend.ui ? ` + ${config.frontend.ui}` : '';
-    lines.push(`  ${chalk.bold('Frontend:')}  ${config.frontend.framework} + ${config.frontend.language} + ${config.frontend.styling}${uiPart}`);
-  }
-  if (config.backend) {
-    lines.push(`  ${chalk.bold('Backend:')}   ${config.backend.framework} + ${config.backend.language} + ${config.backend.orm}`);
-  }
-  if (config.database) {
-    lines.push(`  ${chalk.bold('Database:')}  ${config.database.type} (${config.database.orm})`);
-  }
-  if (config.auth) {
-    lines.push(`  ${chalk.bold('Auth:')}      ${config.auth}`);
-  }
-
-  const testParts = [config.testing.unit, config.testing.e2e, config.testing.backend].filter(Boolean);
-  if (testParts.length) {
-    lines.push(`  ${chalk.bold('Testing:')}   ${testParts.join(' + ')}`);
-  }
-
-  lines.push(`  ${chalk.bold('Deploy:')}    ${config.deployment}`);
-
-  if (config.ai) lines.push(`  ${chalk.bold('AI:')}        enabled`);
-  if (config.claudeCode) lines.push(`  ${chalk.bold('Claude:')}    CLAUDE.md + hooks + skills + agents + commands`);
-
-  return lines.join('\n');
-}
+import chalk from 'chalk';
+import { getStackMetadata } from './utils.js';
+
+export const SUPPORTED_STACKS = Object.keys(
+  // Import the metadata keys to keep SUPPORTED_STACKS in sync automatically.
+  // getStackMetadata returns null for unknown keys, so we call it to get the map.
+  (() => {
+    const stacks = {};
+    for (const id of ['nextjs-fullstack', 'fastapi-backend', 'polyglot-fullstack', 'react-express', 'remix-fullstack', 'hono-api']) {
+      if (getStackMetadata(id)) stacks[id] = true;
+    }
+    return stacks;
+  })()
+);
+
+// Modules included in every stack
+const UNIVERSAL_MODULES = [
+  { path: 'testing/load', prefix: '' },
+  { path: 'infra/docker-compose', prefix: '' },
+  { path: 'infra/github-actions', prefix: '' },
+  { path: 'infra/k8s', prefix: '' },
+];
+
+export function recommend(serviceType, refinements) {
+  const config = {
+    projectName: null, // set by caller
+    serviceType,
+    frontend: null,
+    backend: null,
+    database: null,
+    auth: null,
+    testing: { unit: null, e2e: null, backend: null },
+    ai: refinements.ai || false,
+    realtime: refinements.realtime || false,
+    fileUploads: refinements.fileUploads || false,
+    deployment: refinements.deployment || 'docker',
+    claudeCode: refinements.claudeCode !== false,
+    templateModules: [],
+    stackId: null,
+  };
+
+  const lang = refinements.language || 'typescript';
+
+  switch (serviceType) {
+    case 'web_app':
+      if (refinements.framework === 'remix') {
+        return buildRemixFullstack(config, refinements);
+      }
+      return buildNextjsFullstack(config, refinements);
+
+    case 'full_stack':
+      if (lang === 'python') {
+        return buildPolyglotFullstack(config, refinements);
+      }
+      if (refinements.backend === 'express') {
+        return buildReactExpress(config, refinements);
+      }
+      return buildNextjsFullstack(config, refinements);
+
+    case 'api_service':
+      if (lang === 'python') {
+        return buildFastapiBackend(config, refinements);
+      }
+      return buildHonoApi(config, refinements);
+
+    case 'ai_service':
+      if (lang === 'python') {
+        return buildPolyglotFullstack(config, { ...refinements, ai: true });
+      }
+      return buildPolyglotFullstack(config, { ...refinements, ai: true, language: 'python' });
+
+    case 'mobile':
+    case 'cli_tool':
+    case 'desktop':
+    case 'extension':
+    case 'microservice':
+    case 'describe':
+      return unsupported(serviceType);
+
+    default:
+      return unsupported(serviceType);
+  }
+}
+
+// ─── Shared tail logic for all builders ─────────────────────────────
+// Appends chainproof, auth, and AI modules so each builder only defines
+// its stack-specific modules.
+
+function finalizeConfig(config, refinements, { authModules = [], chainproofModules = ['chainproof/base'], aiModules = [] } = {}) {
+  // Auth
+  if (refinements.auth && authModules.length > 0) {
+    for (const mod of authModules) {
+      config.templateModules.push(typeof mod === 'string' ? { path: mod, prefix: '' } : mod);
+    }
+  }
+
+  // ChainProof (always)
+  for (const mod of chainproofModules) {
+    config.templateModules.push(typeof mod === 'string' ? { path: mod, prefix: '' } : mod);
+  }
+
+  // AI guardrails
+  if (refinements.ai && aiModules.length > 0) {
+    for (const mod of aiModules) {
+      config.templateModules.push(typeof mod === 'string' ? { path: mod, prefix: '' } : mod);
+    }
+  }
+
+  return config;
+}
+
+// ─── Stack builders ─────────────────────────────────────────────────
+
+function buildNextjsFullstack(config, refinements) {
+  config.stackId = 'nextjs-fullstack';
+  config.frontend = { framework: 'nextjs', language: 'typescript', styling: 'tailwind', ui: 'shadcn' };
+  config.backend = { framework: 'nextjs', language: 'typescript', orm: 'prisma' };
+  config.database = { type: 'postgresql', orm: 'prisma' };
+  config.testing = { unit: 'vitest', e2e: 'playwright', backend: null };
+
+  if (refinements.auth) {
+    config.auth = 'nextauth';
+  }
+
+  config.templateModules = [
+    { path: 'base', prefix: '' },
+    { path: 'frontend/nextjs', prefix: '' },
+    { path: 'docs-portal/nextjs', prefix: '' },
+    { path: 'database/prisma-postgres', prefix: '' },
+    { path: 'testing/vitest', prefix: '' },
+    { path: 'testing/playwright', prefix: '' },
+    ...UNIVERSAL_MODULES,
+  ];
+
+  return finalizeConfig(config, refinements, {
+    authModules: ['auth/nextauth'],
+    chainproofModules: ['chainproof/base', 'chainproof/nextjs'],
+    aiModules: ['ai/guardrails-ts'],
+  });
+}
+
+function buildFastapiBackend(config, refinements) {
+  config.stackId = 'fastapi-backend';
+  config.frontend = null;
+  config.backend = { framework: 'fastapi', language: 'python', orm: 'sqlalchemy' };
+  config.database = { type: 'postgresql', orm: 'sqlalchemy' };
+  config.testing = { unit: null, e2e: null, backend: 'pytest' };
+
+  if (refinements.auth) {
+    config.auth = 'jwt-custom';
+  }
+
+  config.templateModules = [
+    { path: 'base', prefix: '' },
+    { path: 'backend/fastapi', prefix: '' },
+    { path: 'docs-portal/fastapi', prefix: '' },
+    { path: 'database/sqlalchemy-postgres', prefix: '' },
+    { path: 'testing/pytest', prefix: '' },
+    ...UNIVERSAL_MODULES,
+  ];
+
+  return finalizeConfig(config, refinements, {
+    authModules: ['auth/jwt-custom'],
+    chainproofModules: ['chainproof/base', 'chainproof/fastapi'],
+    aiModules: ['ai/guardrails-py'],
+  });
+}
+
+function buildPolyglotFullstack(config, refinements) {
+  config.stackId = 'polyglot-fullstack';
+  config.frontend = { framework: 'nextjs', language: 'typescript', styling: 'tailwind', ui: 'shadcn' };
+  config.backend = { framework: 'fastapi', language: 'python', orm: 'sqlalchemy' };
+  config.database = { type: 'postgresql', orm: 'both' };
+  config.testing = { unit: 'vitest', e2e: 'playwright', backend: 'pytest' };
+  config.ai = refinements.ai || false;
+
+  if (refinements.auth) {
+    config.auth = 'both';
+  }
+
+  config.templateModules = [
+    { path: 'base', prefix: '' },
+    { path: 'frontend/nextjs', prefix: 'frontend' },
+    { path: 'docs-portal/nextjs', prefix: 'frontend' },
+    { path: 'backend/fastapi', prefix: '' },
+    { path: 'database/prisma-postgres', prefix: 'frontend' },
+    { path: 'database/sqlalchemy-postgres', prefix: '' },
+    { path: 'testing/vitest', prefix: 'frontend' },
+    { path: 'testing/playwright', prefix: '' },
+    { path: 'testing/pytest', prefix: '' },
+    ...UNIVERSAL_MODULES,
+  ];
+
+  return finalizeConfig(config, refinements, {
+    authModules: [{ path: 'auth/nextauth', prefix: 'frontend' }, 'auth/jwt-custom'],
+    chainproofModules: ['chainproof/base', 'chainproof/polyglot'],
+    aiModules: [{ path: 'ai/guardrails-ts', prefix: 'frontend' }, 'ai/guardrails-py'],
+  });
+}
+
+function buildReactExpress(config, refinements) {
+  config.stackId = 'react-express';
+  config.frontend = { framework: 'react', language: 'typescript', styling: 'tailwind', ui: null };
+  config.backend = { framework: 'express', language: 'typescript', orm: 'prisma' };
+  config.database = { type: 'postgresql', orm: 'prisma' };
+  config.testing = { unit: 'vitest', e2e: null, backend: 'vitest' };
+
+  if (refinements.auth) {
+    config.auth = 'jwt-custom';
+  }
+
+  config.templateModules = [
+    { path: 'base', prefix: '' },
+    { path: 'frontend/react', prefix: 'frontend' },
+    { path: 'backend/express', prefix: 'backend' },
+    { path: 'database/prisma-postgres', prefix: 'backend' },
+    { path: 'testing/vitest', prefix: 'frontend' },
+    { path: 'testing/vitest', prefix: 'backend' },
+    ...UNIVERSAL_MODULES,
+  ];
+
+  return finalizeConfig(config, refinements, {
+    chainproofModules: ['chainproof/base'],
+    aiModules: [{ path: 'ai/guardrails-ts', prefix: 'backend' }],
+  });
+}
+
+function buildRemixFullstack(config, refinements) {
+  config.stackId = 'remix-fullstack';
+  config.frontend = { framework: 'remix', language: 'typescript', styling: 'tailwind', ui: null };
+  config.backend = { framework: 'remix', language: 'typescript', orm: 'prisma' };
+  config.database = { type: 'postgresql', orm: 'prisma' };
+  config.testing = { unit: 'vitest', e2e: null, backend: null };
+
+  if (refinements.auth) {
+    config.auth = 'remix-auth';
+  }
+
+  config.templateModules = [
+    { path: 'base', prefix: '' },
+    { path: 'frontend/remix', prefix: '' },
+    { path: 'database/prisma-postgres', prefix: '' },
+    { path: 'testing/vitest', prefix: '' },
+    ...UNIVERSAL_MODULES,
+  ];
+
+  // No auth template module — jwt-custom is Python-only, nextauth is Next.js-only.
+  // Remix auth scaffolding is planned for a future release.
+  return finalizeConfig(config, refinements, {
+    chainproofModules: ['chainproof/base'],
+    aiModules: ['ai/guardrails-ts'],
+  });
+}
+
+function buildHonoApi(config, refinements) {
+  config.stackId = 'hono-api';
+  config.frontend = null;
+  config.backend = { framework: 'hono', language: 'typescript', orm: 'prisma' };
+  config.database = { type: 'postgresql', orm: 'prisma' };
+  config.testing = { unit: 'vitest', e2e: null, backend: 'vitest' };
+
+  if (refinements.auth) {
+    config.auth = 'jwt-custom';
+  }
+
+  config.templateModules = [
+    { path: 'base', prefix: '' },
+    { path: 'backend/hono', prefix: '' },
+    { path: 'database/prisma-postgres', prefix: '' },
+    { path: 'testing/vitest', prefix: '' },
+    ...UNIVERSAL_MODULES,
+  ];
+
+  return finalizeConfig(config, refinements, {
+    chainproofModules: ['chainproof/base'],
+    aiModules: ['ai/guardrails-ts'],
+  });
+}
+
+function unsupported(serviceType) {
+  return {
+    supported: false,
+    message: `"${serviceType}" is not yet supported in V1. Supported: web_app, full_stack, api_service, ai_service`,
+  };
+}
+
+export function formatStackSummary(config) {
+  if (config.supported === false) {
+    return chalk.yellow(config.message);
+  }
+
+  const lines = [];
+
+  if (config.frontend) {
+    const uiPart = config.frontend.ui ? ` + ${config.frontend.ui}` : '';
+    lines.push(`  ${chalk.bold('Frontend:')}  ${config.frontend.framework} + ${config.frontend.language} + ${config.frontend.styling}${uiPart}`);
+  }
+  if (config.backend) {
+    lines.push(`  ${chalk.bold('Backend:')}   ${config.backend.framework} + ${config.backend.language} + ${config.backend.orm}`);
+  }
+  if (config.database) {
+    lines.push(`  ${chalk.bold('Database:')}  ${config.database.type} (${config.database.orm})`);
+  }
+  if (config.auth) {
+    lines.push(`  ${chalk.bold('Auth:')}      ${config.auth}`);
+  }
+
+  const testParts = [config.testing.unit, config.testing.e2e, config.testing.backend].filter(Boolean);
+  if (testParts.length) {
+    lines.push(`  ${chalk.bold('Testing:')}   ${testParts.join(' + ')}`);
+  }
+
+  lines.push(`  ${chalk.bold('Deploy:')}    ${config.deployment}`);
+
+  if (config.ai) lines.push(`  ${chalk.bold('AI:')}        enabled`);
+  if (config.claudeCode) lines.push(`  ${chalk.bold('Claude:')}    CLAUDE.md + hooks + skills + agents + commands`);
+
+  return lines.join('\n');
+}