forgedev 1.0.0 → 1.0.2

package/src/index.js

@@ -1,148 +1,148 @@
-import path from 'node:path';
-import fs from 'node:fs';
-import { execSync } from 'node:child_process';
-import chalk from 'chalk';
-import { log, toKebabCase } from './utils.js';
-import { askServiceType, askRefinements, askNewMode, confirmStack } from './prompts.js';
-import { recommend } from './recommender.js';
-import { compose } from './composer.js';
-import { generateClaudeConfig } from './claude-configurator.js';
-import { generateUAT } from './uat-generator.js';
-
-export async function runNew(projectName) {
-  const safeName = toKebabCase(projectName);
-  const outputDir = path.resolve(process.cwd(), safeName);
-
-  if (fs.existsSync(outputDir)) {
-    log.error(`Directory "${safeName}" already exists. Choose a different name or delete it first.`);
-    process.exit(1);
-  }
-
-  console.log('');
-  console.log(chalk.bold.cyan('  🔨 DevForge') + chalk.dim(' — Let\'s build something.'));
-  console.log('');
-
-  const mode = await askNewMode();
-
-  if (mode === 'guided') {
-    const { runGuidedFlow } = await import('./guided.js');
-    await runGuidedFlow(safeName, outputDir, scaffold);
-  } else {
-    await runDeveloperFlow(safeName, outputDir);
-  }
-}
-
-async function runDeveloperFlow(safeName, outputDir) {
-  const serviceType = await askServiceType();
-  const refinements = await askRefinements(serviceType);
-  const stackConfig = recommend(serviceType, refinements);
-
-  if (stackConfig.supported === false) {
-    log.warn(stackConfig.message);
-    process.exit(0);
-  }
-
-  stackConfig.projectName = safeName;
-
-  const confirmed = await confirmStack(stackConfig);
-  if (!confirmed) {
-    log.info('Cancelled.');
-    process.exit(0);
-  }
-
-  await scaffold(outputDir, stackConfig);
-}
-
-export async function scaffold(outputDir, stackConfig) {
-  console.log('');
-  const totalSteps = stackConfig.claudeCode ? 4 : 3;
-  let step = 0;
-
-  step++;
-  log.step(step, totalSteps, 'Scaffolding project structure...');
-  await compose(outputDir, stackConfig);
-
-  if (stackConfig.claudeCode) {
-    step++;
-    log.step(step, totalSteps, 'Generating Claude Code infrastructure...');
-    await generateClaudeConfig(outputDir, stackConfig);
-  }
-
-  step++;
-  log.step(step, totalSteps, 'Generating UAT templates...');
-  await generateUAT(outputDir, stackConfig);
-
-  step++;
-  log.step(step, totalSteps, 'Initializing git repository...');
-  initGit(outputDir);
-
-  console.log('');
-  log.success('Done! Your project is ready.');
-  console.log('');
-  printNextSteps(stackConfig.projectName, stackConfig);
-}
-
-function initGit(outputDir) {
-  try {
-    execSync('git init', { cwd: outputDir, stdio: 'ignore' });
-  } catch {
-    // git not available — skip silently
-  }
-}
-
-export function printNextSteps(projectName, config, isGuided = false) {
-  if (isGuided) {
-    console.log(chalk.bold('  To start building:'));
-    console.log(`    cd ${projectName}`);
-    console.log('    npm install');
-    console.log('    npm run dev');
-    console.log('');
-    console.log(`  Then open your browser to ${chalk.cyan('http://localhost:3000')}`);
-    console.log('');
-    console.log(chalk.bold('  📖 New to coding? Here\'s what to do next:'));
-    console.log('    1. Open this folder in VS Code (or any code editor)');
-    console.log('    2. If you have Claude Code installed, type /project:help');
-    console.log('       — it will guide you step by step');
-    console.log('    3. Or read docs/getting-started.md for a beginner-friendly walkthrough');
-    console.log('');
-    return;
-  }
-
-  console.log(chalk.bold('  Next steps:'));
-  console.log(`    cd ${projectName}`);
-
-  if (config.stackId === 'nextjs-fullstack') {
-    console.log('    npm install');
-    console.log('    cp .env.example .env');
-    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('    cp .env.example .env');
-    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');
-  }
-
-  if (config.claudeCode) {
-    console.log('');
-    console.log(chalk.bold('  Claude Code:'));
-    console.log('    Your project includes pre-configured Claude Code infrastructure:');
-    console.log(chalk.dim('    - CLAUDE.md          (project context + rules)'));
-    console.log(chalk.dim('    - .claude/hooks/     (auto-lint, quality gates)'));
-    console.log(chalk.dim('    - .claude/skills/    (framework knowledge)'));
-    console.log(chalk.dim('    - .claude/agents/    (verification chain)'));
-    console.log(chalk.dim('    - .claude/commands/  (audit, verify, pre-pr)'));
-    console.log(chalk.dim('    - docs/prompt-library.md'));
-    console.log(chalk.dim('    - docs/uat/          (acceptance testing)'));
-  }
-
-  console.log('');
-}
+import path from 'node:path';
+import fs from 'node:fs';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import { log, toKebabCase } from './utils.js';
+import { askServiceType, askRefinements, askNewMode, confirmStack } from './prompts.js';
+import { recommend } from './recommender.js';
+import { compose } from './composer.js';
+import { generateClaudeConfig } from './claude-configurator.js';
+import { generateUAT } from './uat-generator.js';
+
+export async function runNew(projectName) {
+  const safeName = toKebabCase(projectName);
+  const outputDir = path.resolve(process.cwd(), safeName);
+
+  if (fs.existsSync(outputDir)) {
+    log.error(`Directory "${safeName}" already exists. Choose a different name or delete it first.`);
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log(chalk.bold.cyan('  🔨 DevForge') + chalk.dim(' — Let\'s build something.'));
+  console.log('');
+
+  const mode = await askNewMode();
+
+  if (mode === 'guided') {
+    const { runGuidedFlow } = await import('./guided.js');
+    await runGuidedFlow(safeName, outputDir, scaffold);
+  } else {
+    await runDeveloperFlow(safeName, outputDir);
+  }
+}
+
+async function runDeveloperFlow(safeName, outputDir) {
+  const serviceType = await askServiceType();
+  const refinements = await askRefinements(serviceType);
+  const stackConfig = recommend(serviceType, refinements);
+
+  if (stackConfig.supported === false) {
+    log.warn(stackConfig.message);
+    process.exit(0);
+  }
+
+  stackConfig.projectName = safeName;
+
+  const confirmed = await confirmStack(stackConfig);
+  if (!confirmed) {
+    log.info('Cancelled.');
+    process.exit(0);
+  }
+
+  await scaffold(outputDir, stackConfig);
+}
+
+export async function scaffold(outputDir, stackConfig) {
+  console.log('');
+  const totalSteps = stackConfig.claudeCode ? 4 : 3;
+  let step = 0;
+
+  step++;
+  log.step(step, totalSteps, 'Scaffolding project structure...');
+  await compose(outputDir, stackConfig);
+
+  if (stackConfig.claudeCode) {
+    step++;
+    log.step(step, totalSteps, 'Generating Claude Code infrastructure...');
+    await generateClaudeConfig(outputDir, stackConfig);
+  }
+
+  step++;
+  log.step(step, totalSteps, 'Generating UAT templates...');
+  await generateUAT(outputDir, stackConfig);
+
+  step++;
+  log.step(step, totalSteps, 'Initializing git repository...');
+  initGit(outputDir);
+
+  console.log('');
+  log.success('Done! Your project is ready.');
+  console.log('');
+  printNextSteps(stackConfig.projectName, stackConfig);
+}
+
+function initGit(outputDir) {
+  try {
+    execSync('git init', { cwd: outputDir, stdio: 'ignore' });
+  } catch {
+    // git not available — skip silently
+  }
+}
+
+export function printNextSteps(projectName, config, isGuided = false) {
+  if (isGuided) {
+    console.log(chalk.bold('  To start building:'));
+    console.log(`    cd ${projectName}`);
+    console.log('    npm install');
+    console.log('    npm run dev');
+    console.log('');
+    console.log(`  Then open your browser to ${chalk.cyan('http://localhost:3000')}`);
+    console.log('');
+    console.log(chalk.bold('  📖 New to coding? Here\'s what to do next:'));
+    console.log('    1. Open this folder in VS Code (or any code editor)');
+    console.log('    2. If you have Claude Code installed, type /workflows');
+    console.log('       — it will guide you step by step');
+    console.log('    3. Or read docs/getting-started.md for a beginner-friendly walkthrough');
+    console.log('');
+    return;
+  }
+
+  console.log(chalk.bold('  Next steps:'));
+  console.log(`    cd ${projectName}`);
+
+  if (config.stackId === 'nextjs-fullstack') {
+    console.log('    npm install');
+    console.log('    cp .env.example .env');
+    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('    cp .env.example .env');
+    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');
+  }
+
+  if (config.claudeCode) {
+    console.log('');
+    console.log(chalk.bold('  Claude Code:'));
+    console.log('    Your project includes pre-configured Claude Code infrastructure:');
+    console.log(chalk.dim('    - CLAUDE.md          (project context + rules)'));
+    console.log(chalk.dim('    - .claude/hooks/     (auto-lint, quality gates)'));
+    console.log(chalk.dim('    - .claude/skills/    (framework knowledge)'));
+    console.log(chalk.dim('    - .claude/agents/    (verification chain)'));
+    console.log(chalk.dim('    - .claude/commands/  (audit, verify, pre-pr)'));
+    console.log(chalk.dim('    - docs/prompt-library.md'));
+    console.log(chalk.dim('    - docs/uat/          (acceptance testing)'));
+  }
+
+  console.log('');
+}

package/src/init-mode.js

@@ -1,134 +1,138 @@
-import path from 'node:path';
-import chalk from 'chalk';
-import { log } from './utils.js';
-import { scanProject } from './scanner.js';
-import { generateClaudeConfig } from './claude-configurator.js';
-import { generateUAT } from './uat-generator.js';
-
-export async function runInit(projectDir) {
-  console.log('');
-  console.log(chalk.bold.cyan('  🔨 DevForge') + chalk.dim(' — Adding dev guardrails'));
-  console.log('');
-  console.log('  Scanning...');
-  console.log('');
-
-  const scan = scanProject(projectDir);
-
-  if (scan.stackId === 'unknown') {
-    log.warn('Could not detect a supported stack in this directory.');
-    log.dim('  Supported: Next.js, FastAPI, or polyglot (Next.js + FastAPI)');
-    log.dim('  Make sure you\'re in the project root directory.');
-    process.exit(1);
-  }
-
-  // Print what was detected
-  const detected = [];
-  if (scan.frontend.detected) {
-    detected.push(`${scan.frontend.framework} (${scan.frontend.language})`);
-  }
-  if (scan.backend.detected) {
-    detected.push(`${scan.backend.framework} (${scan.backend.language})`);
-  }
-  if (scan.database.detected) {
-    detected.push(`${scan.database.type} (${scan.database.orm})`);
-  }
-  if (scan.testing.unit) detected.push(scan.testing.unit);
-  if (scan.testing.e2e) detected.push(scan.testing.e2e);
-  if (scan.testing.backend) detected.push(scan.testing.backend);
-
-  console.log(chalk.bold('  Detected: ') + detected.join(' + '));
-  if (scan.infrastructure.hasClaudeMd) {
-    console.log(chalk.dim(`  CLAUDE.md exists (${scan.infrastructure.claudeMdLines} lines)`));
-  }
-  console.log('');
-
-  // Build a synthetic stackConfig from scan results
-  const stackConfig = buildConfigFromScan(scan);
-
-  // Install infrastructure
-  console.log(chalk.bold('  Installing:'));
-
-  // Generate Claude Code infrastructure (skips CLAUDE.md if it exists, merges settings.json if it exists)
-  const skipClaudeMd = scan.infrastructure.hasClaudeMd;
-  const mergeSettings = scan.infrastructure.hasHooks;
-  await generateClaudeConfig(projectDir, stackConfig, { skipClaudeMd, mergeSettings });
-
-  if (!skipClaudeMd) {
-    console.log(chalk.green('  ✓ ') + 'CLAUDE.md — project context + rules');
-  } else {
-    console.log(chalk.yellow('  ⊘ ') + `CLAUDE.md — exists (tip: run ${chalk.cyan('/project:optimize-claude-md')} to slim it)`);
-  }
-
-  if (!scan.infrastructure.hasHooks) {
-    console.log(chalk.green('  ✓ ') + '.claude/hooks/ — auto-lint, quality gate, file protection');
-  } else {
-    console.log(chalk.yellow('  ⊘ ') + '.claude/hooks/ — already configured');
-  }
-
-  if (!scan.infrastructure.hasAgents) {
-    console.log(chalk.green('  ✓ ') + '.claude/agents/ — code quality, security, spec validator');
-  }
-  if (!scan.infrastructure.hasCommands) {
-    console.log(chalk.green('  ✓ ') + '.claude/commands/ — help, status, next, done, audit, pre-pr');
-  }
-  if (!scan.infrastructure.hasSkills) {
-    console.log(chalk.green('  ✓ ') + '.claude/skills/ — framework-specific knowledge');
-  }
-
-  // Generate UAT templates
-  if (!scan.infrastructure.hasUAT) {
-    await generateUAT(projectDir, stackConfig);
-    console.log(chalk.green('  ✓ ') + 'docs/uat/ — acceptance test templates');
-  } else {
-    console.log(chalk.yellow('  ⊘ ') + 'docs/uat/ — already exists');
-  }
-
-  console.log('');
-  log.success('  Done. Type /project:help to get started.');
-  console.log('');
-}
-
-export function buildConfigFromScan(scan) {
-  const config = {
-    projectName: scan.projectName,
-    stackId: scan.stackId,
-    serviceType: scan.stackId === 'fastapi-backend' ? 'api_service' : 'full_stack',
-    frontend: null,
-    backend: null,
-    database: null,
-    auth: scan.auth.detected ? scan.auth.type : null,
-    testing: scan.testing,
-    ai: scan.ai,
-    realtime: false,
-    fileUploads: false,
-    deployment: scan.deployment || 'docker',
-    claudeCode: true,
-    templateModules: [],
-  };
-
-  if (scan.frontend.detected) {
-    config.frontend = {
-      framework: scan.frontend.framework,
-      language: scan.frontend.language,
-      styling: 'tailwind',
-      ui: 'shadcn',
-    };
-  }
-
-  if (scan.backend.detected) {
-    config.backend = {
-      framework: scan.backend.framework,
-      language: scan.backend.language,
-      orm: scan.database.detected ? scan.database.orm : (scan.backend.language === 'python' ? 'sqlalchemy' : 'prisma'),
-    };
-  }
-
-  if (scan.database.detected) {
-    config.database = {
-      type: scan.database.type,
-      orm: scan.database.orm,
-    };
-  }
-
-  return config;
-}
+import path from 'node:path';
+import chalk from 'chalk';
+import { log } from './utils.js';
+import { scanProject } from './scanner.js';
+import { generateClaudeConfig } from './claude-configurator.js';
+import { generateUAT } from './uat-generator.js';
+
+export async function runInit(projectDir) {
+  console.log('');
+  console.log(chalk.bold.cyan('  🔨 DevForge') + chalk.dim(' — Adding dev guardrails'));
+  console.log('');
+  console.log('  Scanning...');
+  console.log('');
+
+  const scan = scanProject(projectDir);
+
+  if (scan.stackId === 'unknown') {
+    log.warn('Could not detect a supported stack in this directory.');
+    log.dim('  Supported: Next.js, FastAPI, or polyglot (Next.js + FastAPI)');
+    log.dim('  Make sure you\'re in the project root directory.');
+    process.exit(1);
+  }
+
+  // Print what was detected
+  const detected = [];
+  if (scan.frontend.detected) {
+    detected.push(`${scan.frontend.framework} (${scan.frontend.language})`);
+  }
+  if (scan.backend.detected) {
+    detected.push(`${scan.backend.framework} (${scan.backend.language})`);
+  }
+  if (scan.database.detected) {
+    detected.push(`${scan.database.type} (${scan.database.orm})`);
+  }
+  if (scan.testing.unit) detected.push(scan.testing.unit);
+  if (scan.testing.e2e) detected.push(scan.testing.e2e);
+  if (scan.testing.backend) detected.push(scan.testing.backend);
+
+  console.log(chalk.bold('  Detected: ') + detected.join(' + '));
+  if (scan.infrastructure.hasClaudeMd) {
+    console.log(chalk.dim(`  CLAUDE.md exists (${scan.infrastructure.claudeMdLines} lines)`));
+  }
+  console.log('');
+
+  // Build a synthetic stackConfig from scan results
+  const stackConfig = buildConfigFromScan(scan);
+
+  // Install infrastructure
+  console.log(chalk.bold('  Installing:'));
+
+  // Generate Claude Code infrastructure (skips CLAUDE.md if it exists, merges settings.json if it exists)
+  const skipClaudeMd = scan.infrastructure.hasClaudeMd;
+  const mergeSettings = scan.infrastructure.hasHooks;
+  await generateClaudeConfig(projectDir, stackConfig, { skipClaudeMd, mergeSettings });
+
+  if (!skipClaudeMd) {
+    console.log(chalk.green('  ✓ ') + 'CLAUDE.md — project context + rules');
+  } else {
+    console.log(chalk.yellow('  ⊘ ') + `CLAUDE.md — exists (tip: run ${chalk.cyan('/optimize-claude-md')} to slim it)`);
+  }
+
+  if (!scan.infrastructure.hasHooks) {
+    console.log(chalk.green('  ✓ ') + '.claude/hooks/ — auto-lint, quality gate, file protection');
+  } else {
+    console.log(chalk.yellow('  ⊘ ') + '.claude/hooks/ — already configured');
+  }
+
+  if (!scan.infrastructure.hasAgents) {
+    console.log(chalk.green('  ✓ ') + '.claude/agents/ — code quality, security, spec validator');
+  }
+  if (!scan.infrastructure.hasCommands) {
+    console.log(chalk.green('  ✓ ') + '.claude/commands/ — help, status, next, done, audit, pre-pr');
+  }
+  if (!scan.infrastructure.hasSkills) {
+    console.log(chalk.green('  ✓ ') + '.claude/skills/ — framework-specific knowledge');
+  }
+
+  // Generate UAT templates
+  if (!scan.infrastructure.hasUAT) {
+    await generateUAT(projectDir, stackConfig);
+    console.log(chalk.green('  ✓ ') + 'docs/uat/ — acceptance test templates');
+  } else {
+    console.log(chalk.yellow('  ⊘ ') + 'docs/uat/ — already exists');
+  }
+
+  console.log('');
+  log.success('  Done. Your project is now configured for Claude Code.');
+  console.log('');
+  console.log(chalk.bold('  Next steps:'));
+  console.log(`    1. Open Claude Code in this directory: ${chalk.cyan('claude')}`);
+  console.log(`    2. Type ${chalk.cyan('/workflows')} to see available workflows`);
+  console.log('');
+}
+
+export function buildConfigFromScan(scan) {
+  const config = {
+    projectName: scan.projectName,
+    stackId: scan.stackId,
+    serviceType: scan.stackId === 'fastapi-backend' ? 'api_service' : 'full_stack',
+    frontend: null,
+    backend: null,
+    database: null,
+    auth: scan.auth.detected ? scan.auth.type : null,
+    testing: scan.testing,
+    ai: scan.ai,
+    realtime: false,
+    fileUploads: false,
+    deployment: scan.deployment || 'docker',
+    claudeCode: true,
+    templateModules: [],
+  };
+
+  if (scan.frontend.detected) {
+    config.frontend = {
+      framework: scan.frontend.framework,
+      language: scan.frontend.language,
+      styling: 'tailwind',
+      ui: 'shadcn',
+    };
+  }
+
+  if (scan.backend.detected) {
+    config.backend = {
+      framework: scan.backend.framework,
+      language: scan.backend.language,
+      orm: scan.database.detected ? scan.database.orm : (scan.backend.language === 'python' ? 'sqlalchemy' : 'prisma'),
+    };
+  }
+
+  if (scan.database.detected) {
+    config.database = {
+      type: scan.database.type,
+      orm: scan.database.orm,
+    };
+  }
+
+  return config;
+}