forgedev 1.3.0 → 1.4.1

package/bin/chainproof.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * ChainProof CLI - local trust chain operations.

package/bin/devforge.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 import { parseCommand } from '../src/cli.js';
 
 try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgedev",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Universal, AI-first project scaffolding CLI with Claude Code infrastructure",
   "type": "module",
   "bin": {

package/src/chainproof-bridge.js

@@ -43,8 +43,15 @@ export function verifySignature(payload, signatureB64, publicKeyPem) {
       publicKeyPem,
       Buffer.from(signatureB64, 'base64')
     );
-  } catch {
-    // Invalid key or malformed signature
+  } catch (err) {
+    // Verification should never throw — any failure means "not verified"
+    if (err?.code?.startsWith?.('ERR_OSSL') ||
+        err?.code?.startsWith?.('ERR_CRYPTO') ||
+        err instanceof TypeError) {
+      return false;
+    }
+    // Log unexpected errors for debugging but still return false
+    console.warn('Unexpected crypto error during signature verification:', err?.code || err?.message);
     return false;
   }
 }

package/src/ci-mode.js

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import chalk from 'chalk';
 import { log } from './utils.js';
-import { scanProject, detectStack } from './scanner.js';
+import { scanProject } from './scanner.js';
 import { runAllChecks } from './doctor-checks.js';
 import { generateReport } from './doctor-prompts.js';
 
@@ -18,10 +18,9 @@ export async function runCI(projectDir) {
   log.info('  DevForge CI  Automated project health check');
   console.log('');
 
-  // Scan project
+  // Scan project (scanProject already calls detectStack internally)
   const scan = scanProject(resolvedDir);
-  const stack = detectStack(resolvedDir, scan);
-  log.dim(`  Stack: ${stack || 'unknown'}`);
+  log.dim(`  Stack: ${scan.stackId || 'unknown'}`);
 
   // Run all checks
   const issues = runAllChecks(resolvedDir, scan);

package/src/claude-configurator.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { ROOT_DIR, ensureDir, writeFile, readTemplate, replaceVars, getStackCommands } from './utils.js';
+import { ROOT_DIR, ensureDir, writeFile, readTemplate, replaceVars, getStackCommands, toPascalCase } from './utils.js';
 
 const CLAUDE_TEMPLATES_DIR = path.join(ROOT_DIR, 'templates', 'claude-code');
 const DOCS_DIR = path.join(ROOT_DIR, 'docs');
@@ -13,10 +13,12 @@ export async function generateClaudeConfig(outputDir, stackConfig, options = {})
   }
   generateHooks(outputDir, stackConfig, { merge: options.mergeSettings });
   generateSkills(outputDir, stackConfig);
-  generateAgents(outputDir, stackConfig, vars);
-  generateCommands(outputDir, stackConfig, vars);
+  const agents = generateAgents(outputDir, stackConfig, vars);
+  const commands = generateCommands(outputDir, stackConfig, vars);
   copyPromptLibrary(outputDir);
   stampVersion(outputDir);
+
+  return { agents, commands };
 }
 
 function stampVersion(outputDir) {
@@ -30,59 +32,69 @@ function stampVersion(outputDir) {
 function buildClaudeVars(config) {
   const vars = {
     PROJECT_NAME: config.projectName,
-    PROJECT_NAME_PASCAL: config.projectName.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(''),
+    PROJECT_NAME_PASCAL: toPascalCase(config.projectName),
   };
 
   // Commands vary by stack (shared with composer)
   Object.assign(vars, getStackCommands(config.stackId));
 
-  if (config.stackId === 'nextjs-fullstack') {
-    vars.STACK_SUMMARY = 'Next.js 15 (App Router) + TypeScript + Tailwind CSS + Prisma + PostgreSQL';
-    vars.DIR_MAP = `- src/app/ - Next.js App Router pages and API routes
+  const claudeVars = {
+    'nextjs-fullstack': {
+      STACK_SUMMARY: 'Next.js 15 (App Router) + TypeScript + Tailwind CSS + Prisma + PostgreSQL',
+      DIR_MAP: `- src/app/ - Next.js App Router pages and API routes
 - src/lib/ - Shared utilities, database client, error handling
 - src/components/ - React components
 - prisma/ - Database schema and migrations
-- e2e/ - Playwright E2E tests`;
-  } else if (config.stackId === 'fastapi-backend') {
-    vars.STACK_SUMMARY = 'FastAPI + Python + SQLAlchemy 2.0 + PostgreSQL + Alembic';
-    vars.DIR_MAP = `- backend/app/ - FastAPI application
+- e2e/ - Playwright E2E tests`,
+    },
+    'fastapi-backend': {
+      STACK_SUMMARY: 'FastAPI + Python + SQLAlchemy 2.0 + PostgreSQL + Alembic',
+      DIR_MAP: `- backend/app/ - FastAPI application
 - backend/app/api/ - API route handlers
 - backend/app/core/ - Config, security, error handling
 - backend/app/db/ - Database session and models
 - backend/app/models/ - SQLAlchemy models
 - backend/app/schemas/ - Pydantic schemas
 - backend/tests/ - Pytest tests
-- backend/alembic/ - Database migrations`;
-  } else if (config.stackId === 'polyglot-fullstack') {
-    vars.STACK_SUMMARY = 'Next.js 15 (frontend) + FastAPI (backend) + PostgreSQL';
-    vars.DIR_MAP = `- frontend/ - Next.js 15 App Router application
+- backend/alembic/ - Database migrations`,
+    },
+    'polyglot-fullstack': {
+      STACK_SUMMARY: 'Next.js 15 (frontend) + FastAPI (backend) + PostgreSQL',
+      DIR_MAP: `- frontend/ - Next.js 15 App Router application
 - frontend/src/app/ - Pages and API routes
 - frontend/src/lib/ - Shared utilities
 - backend/ - FastAPI application
 - backend/app/api/ - API route handlers
 - backend/app/core/ - Config, security, error handling
 - backend/app/db/ - Database session and models
-- e2e/ - Playwright E2E tests`;
-  } else if (config.stackId === 'react-express') {
-    vars.STACK_SUMMARY = 'React (Vite) + Express + TypeScript + Prisma + PostgreSQL';
-    vars.DIR_MAP = `- frontend/ - React (Vite) SPA
+- e2e/ - Playwright E2E tests`,
+    },
+    'react-express': {
+      STACK_SUMMARY: 'React (Vite) + Express + TypeScript + Prisma + PostgreSQL',
+      DIR_MAP: `- frontend/ - React (Vite) SPA
 - frontend/src/ - React components and pages
 - backend/ - Express API server
 - backend/src/ - Express routes and middleware
 - backend/src/routes/ - API route handlers
-- backend/prisma/ - Database schema and migrations`;
-  } else if (config.stackId === 'remix-fullstack') {
-    vars.STACK_SUMMARY = 'Remix + Vite + TypeScript + Tailwind CSS + Prisma + PostgreSQL';
-    vars.DIR_MAP = `- app/ - Remix application
+- backend/prisma/ - Database schema and migrations`,
+    },
+    'remix-fullstack': {
+      STACK_SUMMARY: 'Remix + Vite + TypeScript + Tailwind CSS + Prisma + PostgreSQL',
+      DIR_MAP: `- app/ - Remix application
 - app/routes/ - File-based routes and API resource routes
 - app/routes/api.health.ts - Health check endpoint
-- prisma/ - Database schema and migrations`;
-  } else if (config.stackId === 'hono-api') {
-    vars.STACK_SUMMARY = 'Hono + TypeScript + Prisma + PostgreSQL';
-    vars.DIR_MAP = `- src/ - Hono application
+- prisma/ - Database schema and migrations`,
+    },
+    'hono-api': {
+      STACK_SUMMARY: 'Hono + TypeScript + Prisma + PostgreSQL',
+      DIR_MAP: `- src/ - Hono application
 - src/routes/ - API route handlers
 - src/routes/health.ts - Health check endpoints
-- prisma/ - Database schema and migrations`;
+- prisma/ - Database schema and migrations`,
+    },
+  };
+  if (claudeVars[config.stackId]) {
+    Object.assign(vars, claudeVars[config.stackId]);
   }
 
   // Build skills list for CLAUDE.md reference
@@ -115,20 +127,18 @@ function generateClaudeMd(outputDir, config, vars) {
   let content = readTemplate(basePath);
 
   // Read stack-specific section
-  let stackSection = '';
-  if (config.stackId === 'nextjs-fullstack') {
-    stackSection = readTemplate(path.join(CLAUDE_TEMPLATES_DIR, 'claude-md', 'nextjs.md'));
-  } else if (config.stackId === 'fastapi-backend') {
-    stackSection = readTemplate(path.join(CLAUDE_TEMPLATES_DIR, 'claude-md', 'fastapi.md'));
-  } else if (config.stackId === 'polyglot-fullstack') {
-    stackSection = readTemplate(path.join(CLAUDE_TEMPLATES_DIR, 'claude-md', 'fullstack.md'));
-  } else if (config.stackId === 'react-express') {
-    stackSection = readTemplate(path.join(CLAUDE_TEMPLATES_DIR, 'claude-md', 'fullstack.md'));
-  } else if (config.stackId === 'remix-fullstack') {
-    stackSection = readTemplate(path.join(CLAUDE_TEMPLATES_DIR, 'claude-md', 'remix.md'));
-  } else if (config.stackId === 'hono-api') {
-    stackSection = readTemplate(path.join(CLAUDE_TEMPLATES_DIR, 'claude-md', 'hono.md'));
-  }
+  const claudeMdTemplates = {
+    'nextjs-fullstack': 'nextjs.md',
+    'fastapi-backend': 'fastapi.md',
+    'polyglot-fullstack': 'fullstack.md',
+    'react-express': 'fullstack.md',
+    'remix-fullstack': 'remix.md',
+    'hono-api': 'hono.md',
+  };
+  const mdFile = claudeMdTemplates[config.stackId];
+  const stackSection = mdFile
+    ? readTemplate(path.join(CLAUDE_TEMPLATES_DIR, 'claude-md', mdFile))
+    : '';
 
   content = content.replace('{{STACK_SPECIFIC_RULES}}', stackSection);
   content = replaceVars(content, vars);
@@ -137,21 +147,19 @@ function generateClaudeMd(outputDir, config, vars) {
 }
 
 function generateHooks(outputDir, config, options = {}) {
-  let hookFile;
+  const hookConfig = {
+    'nextjs-fullstack': { file: 'typescript.json', autofix: 'autofix-typescript.mjs' },
+    'fastapi-backend': { file: 'python.json', autofix: 'autofix-python.mjs' },
+    'polyglot-fullstack': { file: 'polyglot.json', autofix: 'autofix-polyglot.mjs' },
+    'react-express': { file: 'typescript.json', autofix: 'autofix-typescript.mjs' },
+    'remix-fullstack': { file: 'typescript.json', autofix: 'autofix-typescript.mjs' },
+    'hono-api': { file: 'typescript.json', autofix: 'autofix-typescript.mjs' },
+  };
+  const hook = hookConfig[config.stackId];
+  const hookFile = hook?.file;
   const scriptFiles = ['guard-protected-files.mjs', 'code-hygiene.mjs', 'pre-commit-gate.mjs'];
-
-  if (config.stackId === 'nextjs-fullstack' || config.stackId === 'remix-fullstack' || config.stackId === 'hono-api') {
-    hookFile = 'typescript.json';
-    scriptFiles.push('autofix-typescript.mjs');
-  } else if (config.stackId === 'fastapi-backend') {
-    hookFile = 'python.json';
-    scriptFiles.push('autofix-python.mjs');
-  } else if (config.stackId === 'polyglot-fullstack') {
-    hookFile = 'polyglot.json';
-    scriptFiles.push('autofix-polyglot.mjs');
-  } else if (config.stackId === 'react-express') {
-    hookFile = 'typescript.json';
-    scriptFiles.push('autofix-typescript.mjs');
+  if (hook?.autofix) {
+    scriptFiles.push(hook.autofix);
   }
 
   const settingsPath = path.join(outputDir, '.claude', 'settings.json');
@@ -160,7 +168,7 @@ function generateHooks(outputDir, config, options = {}) {
     // Merge hooks into existing settings.json
     const existing = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
     const incoming = JSON.parse(readTemplate(path.join(CLAUDE_TEMPLATES_DIR, 'hooks', hookFile)));
-    const merged = deepMergeSettings(existing, incoming);
+    const merged = mergeHooksIntoSettings(existing, incoming);
     writeFile(settingsPath, JSON.stringify(merged, null, 2));
   } else {
     const hookPath = path.join(CLAUDE_TEMPLATES_DIR, 'hooks', hookFile);
@@ -179,7 +187,7 @@ function generateHooks(outputDir, config, options = {}) {
   }
 }
 
-function deepMergeSettings(existing, incoming) {
+function mergeHooksIntoSettings(existing, incoming) {
   const merged = { ...existing };
   if (incoming.hooks) {
     merged.hooks = merged.hooks || {};
@@ -264,9 +272,14 @@ function generateAgents(outputDir, config, vars) {
     if (fs.existsSync(srcPath)) {
       let content = readTemplate(srcPath);
       content = replaceVars(content, vars);
+      content = stampManaged(content);
       writeFile(path.join(outputDir, '.claude', 'agents', agent), content);
     }
   }
+
+  // Clean up orphaned agents from older versions
+  const removed = cleanOrphans(path.join(outputDir, '.claude', 'agents'), agents);
+  return { count: agents.length, removed };
 }
 
 function generateCommands(outputDir, config, vars) {
@@ -306,9 +319,52 @@ function generateCommands(outputDir, config, vars) {
     if (fs.existsSync(srcPath)) {
       let content = readTemplate(srcPath);
       content = replaceVars(content, vars);
+      content = stampManaged(content);
       writeFile(path.join(outputDir, '.claude', 'commands', cmd), content);
     }
   }
+
+  // Clean up orphaned commands from older versions
+  const removed = cleanOrphans(path.join(outputDir, '.claude', 'commands'), commands);
+  return { count: commands.length, removed };
+}
+
+const MANAGED_MARKER = '<!-- Generated by DevForge -->';
+
+/**
+ * Append the DevForge managed marker to generated file content.
+ */
+function stampManaged(content) {
+  return content.trimEnd() + '\n\n' + MANAGED_MARKER + '\n';
+}
+
+/**
+ * Remove DevForge-managed .md files that are no longer in the current manifest.
+ * Only deletes files stamped with the DevForge marker. User-created custom
+ * files are left untouched. Returns array of removed filenames.
+ */
+function cleanOrphans(dir, expectedFiles) {
+  const removed = [];
+  if (!fs.existsSync(dir)) return removed;
+
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const existing = entries
+    .filter(e => e.isFile() && !e.isSymbolicLink() && e.name.endsWith('.md'))
+    .map(e => e.name);
+  const expectedSet = new Set(expectedFiles);
+  for (const file of existing) {
+    if (!expectedSet.has(file)) {
+      const filePath = path.join(dir, file);
+      const stat = fs.statSync(filePath);
+      if (stat.size > 1_000_000) continue; // skip unexpectedly large files
+      const content = fs.readFileSync(filePath, 'utf-8');
+      if (content.includes(MANAGED_MARKER)) {
+        fs.unlinkSync(filePath);
+        removed.push(file);
+      }
+    }
+  }
+  return removed;
 }
 
 function copyPromptLibrary(outputDir) {

package/src/composer.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { ROOT_DIR, ensureDir, readTemplate, replaceVars, toPascalCase, toSnakeCase, getStackCommands, copyEnvCmd, log } from './utils.js';
+import { ROOT_DIR, ensureDir, readTemplate, replaceVars, toPascalCase, toSnakeCase, getStackMetadata, walkDir, log } from './utils.js';
 
 const TEMPLATES_DIR = path.join(ROOT_DIR, 'templates');
 
@@ -53,127 +53,28 @@ export function buildVariables(stackConfig) {
   vars.AUTH_TYPE = stackConfig.auth || 'none';
   vars.DEPLOYMENT = stackConfig.deployment || 'docker';
 
-  // Commands vary by stack (shared with claude-configurator)
-  Object.assign(vars, getStackCommands(stackConfig.stackId));
-
-  if (stackConfig.stackId === 'nextjs-fullstack') {
-    vars.STACK_DESCRIPTION = 'Next.js full-stack application with TypeScript, Tailwind CSS, Prisma, and PostgreSQL';
+  // All per-stack values come from a single metadata source
+  const meta = getStackMetadata(stackConfig.stackId);
+  if (meta) {
+    Object.assign(vars, meta.commands);
+    vars.STACK_DESCRIPTION = meta.description;
+    vars.EXTRA_IGNORES = meta.extraIgnores;
+    vars.APP_PORT = meta.port;
+    vars.SETUP_COMMANDS = meta.setupCommands();
+    vars.AVAILABLE_SCRIPTS = meta.availableScripts;
+  } else {
+    vars.STACK_DESCRIPTION = '';
     vars.EXTRA_IGNORES = '';
-  } else if (stackConfig.stackId === 'fastapi-backend') {
-    vars.STACK_DESCRIPTION = 'FastAPI backend service with SQLAlchemy, PostgreSQL, and Alembic';
-    vars.EXTRA_IGNORES = '\n# Python\n__pycache__/\n*.pyc\nvenv/\n.venv/\n*.egg-info/';
-  } else if (stackConfig.stackId === 'polyglot-fullstack') {
-    vars.STACK_DESCRIPTION = 'Full-stack application with Next.js frontend and FastAPI backend';
-    vars.EXTRA_IGNORES = '\n# Python\n__pycache__/\n*.pyc\nvenv/\n.venv/\n*.egg-info/';
-  } else if (stackConfig.stackId === 'react-express') {
-    vars.STACK_DESCRIPTION = 'Full-stack application with React (Vite) frontend and Express backend';
-    vars.EXTRA_IGNORES = '\ndist/';
-  } else if (stackConfig.stackId === 'remix-fullstack') {
-    vars.STACK_DESCRIPTION = 'Full-stack Remix application with Vite, Tailwind CSS, and PostgreSQL';
-    vars.EXTRA_IGNORES = '\nbuild/';
-  } else if (stackConfig.stackId === 'hono-api') {
-    vars.STACK_DESCRIPTION = 'Hono API service with TypeScript, Prisma, and PostgreSQL';
-    vars.EXTRA_IGNORES = '\ndist/';
+    vars.APP_PORT = '3000';
+    vars.SETUP_COMMANDS = '';
+    vars.AVAILABLE_SCRIPTS = '';
   }
 
-  // Setup commands for README
-  vars.SETUP_COMMANDS = buildSetupCommands(stackConfig);
-  vars.AVAILABLE_SCRIPTS = buildAvailableScripts(stackConfig);
+  vars.IMAGE_TAG = '0.1.0';
 
   return vars;
 }
 
-function buildSetupCommands(config) {
-  if (config.stackId === 'nextjs-fullstack') {
-    return `npm install
-${copyEnvCmd()}
-npx prisma db push
-npm run dev`;
-  }
-  if (config.stackId === 'fastapi-backend') {
-    return `cd backend
-python -m venv venv
-source venv/bin/activate
-pip install -r requirements.txt
-${copyEnvCmd()}
-uvicorn app.main:app --reload`;
-  }
-  if (config.stackId === 'polyglot-fullstack') {
-    return `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`;
-  }
-  if (config.stackId === 'react-express') {
-    return `# 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`;
-  }
-  if (config.stackId === 'remix-fullstack') {
-    return `npm install
-${copyEnvCmd()}
-npx prisma db push
-npm run dev`;
-  }
-  if (config.stackId === 'hono-api') {
-    return `npm install
-${copyEnvCmd()}
-npx prisma db push
-npm run dev`;
-  }
-  return '';
-}
-
-function buildAvailableScripts(config) {
-  if (config.stackId === 'nextjs-fullstack') {
-    return `- \`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`;
-  }
-  if (config.stackId === 'fastapi-backend') {
-    return `- \`uvicorn app.main:app --reload\`: Start dev server
-- \`pytest\`: Run tests
-- \`ruff check .\`: Run linter
-- \`alembic upgrade head\`: Run migrations`;
-  }
-  if (config.stackId === 'polyglot-fullstack') {
-    return `- \`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\``;
-  }
-  if (config.stackId === 'react-express') {
-    return `- 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`;
-  }
-  if (config.stackId === 'remix-fullstack') {
-    return `- \`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`;
-  }
-  if (config.stackId === 'hono-api') {
-    return `- \`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`;
-  }
-  return '';
-}
-
 export function processTemplateDir(templateDir, outputDir, variables, prefix) {
   const entries = walkDir(templateDir);
 
@@ -207,19 +108,7 @@ export function processTemplateDir(templateDir, outputDir, variables, prefix) {
   }
 }
 
-function walkDir(dir) {
-  const results = [];
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      results.push(...walkDir(fullPath));
-    } else {
-      results.push(fullPath);
-    }
-  }
-  return results;
-}
+// walkDir is imported from utils.js (shared with doctor-checks.js)
 
 function injectAuthDependencies(outputDir, stackConfig) {
   if (!stackConfig.auth || stackConfig.auth === 'none') return;

package/src/doctor-checks-chainproof.js

@@ -66,17 +66,20 @@ export function checkChainproofIntegrity(projectDir) {
         effort: 'medium',
       }];
     }
-  } catch {
-    // Malformed chain.json
-    return [{
-      severity: 'critical',
-      title: 'ChainProof chain.json is malformed',
-      impact: 'Cannot verify trust chain integrity',
-      files: ['.chainproof/chain.json'],
-      autoFixable: false,
-      promptId: 'CHAINPROOF_MALFORMED',
-      effort: 'medium',
-    }];
+  } catch (err) {
+    // JSON parse errors → malformed file; anything else should propagate
+    if (err instanceof SyntaxError) {
+      return [{
+        severity: 'critical',
+        title: 'ChainProof chain.json is malformed',
+        impact: 'Cannot verify trust chain integrity',
+        files: ['.chainproof/chain.json'],
+        autoFixable: false,
+        promptId: 'CHAINPROOF_MALFORMED',
+        effort: 'medium',
+      }];
+    }
+    throw err;
   }
 
   return [];

package/src/doctor-checks.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { walkDir, DEFAULT_SKIP_DIRS } from './utils.js';
 import {
   checkChainproofExists,
   checkChainproofIntegrity,
@@ -739,24 +740,7 @@ function checkAIPrompts(projectDir) {
 // Helpers
 
 function findFiles(dir, ext) {
-  const results = [];
-  if (!fs.existsSync(dir)) return results;
-
-  try {
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const fullPath = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        if (['node_modules', '.next', '__pycache__', '.git', 'venv', '.venv', 'dist', 'build'].includes(entry.name)) continue;
-        results.push(...findFiles(fullPath, ext));
-      } else if (entry.name.endsWith(ext)) {
-        results.push(fullPath);
-      }
-    }
-  } catch {
-    // Permission errors, etc.
-  }
-
-  return results;
+  if (!fs.existsSync(dir)) return [];
+  return walkDir(dir, { ext, skipDirs: DEFAULT_SKIP_DIRS });
 }
 

package/src/index.js

@@ -2,7 +2,7 @@ import path from 'node:path';
 import fs from 'node:fs';
 import { execSync } from 'node:child_process';
 import chalk from 'chalk';
-import { log, toKebabCase, copyEnvCmd } from './utils.js';
+import { log, toKebabCase, getStackMetadata } from './utils.js';
 import { askServiceType, askRefinements, askNewMode, confirmStack } from './prompts.js';
 import { recommend } from './recommender.js';
 import { compose } from './composer.js';
@@ -123,39 +123,11 @@ export function printNextSteps(projectName, config, isGuided = false) {
   console.log(chalk.bold('  Next steps:'));
   console.log(`    cd ${projectName}`);
 
-  if (config.stackId === 'nextjs-fullstack') {
-    console.log('    npm install');
-    console.log(`    ${copyEnvCmd()}`);
-    console.log('    npx prisma db push');
-    console.log('    npm run dev');
-  } else if (config.stackId === 'fastapi-backend') {
-    console.log('    cd backend');
-    console.log('    python -m venv venv');
-    console.log('    source venv/bin/activate  # or venv\\Scripts\\activate on Windows');
-    console.log('    pip install -r requirements.txt');
-    console.log(`    ${copyEnvCmd()}`);
-    console.log('    uvicorn app.main:app --reload');
-  } else if (config.stackId === 'polyglot-fullstack') {
-    console.log('    docker compose up -d postgres');
-    console.log('    # Frontend:');
-    console.log('    cd frontend && npm install && npm run dev');
-    console.log('    # Backend:');
-    console.log('    cd backend && pip install -r requirements.txt && uvicorn app.main:app --reload');
-  } else if (config.stackId === 'react-express') {
-    console.log('    # Frontend:');
-    console.log('    cd frontend && npm install && npm run dev');
-    console.log('    # Backend (in a separate terminal):');
-    console.log(`    cd backend && npm install && ${copyEnvCmd()} && npx prisma db push && npm run dev`);
-  } else if (config.stackId === 'remix-fullstack') {
-    console.log('    npm install');
-    console.log(`    ${copyEnvCmd()}`);
-    console.log('    npx prisma db push');
-    console.log('    npm run dev');
-  } else if (config.stackId === 'hono-api') {
-    console.log('    npm install');
-    console.log(`    ${copyEnvCmd()}`);
-    console.log('    npx prisma db push');
-    console.log('    npm run dev');
+  const meta = getStackMetadata(config.stackId);
+  if (meta) {
+    for (const line of meta.setupCommands().split('\n')) {
+      console.log(`    ${line}`);
+    }
   }
 
   if (config.claudeCode) {