forgedev 1.0.0 → 1.0.2

package/src/doctor.js

@@ -1,281 +1,281 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import chalk from 'chalk';
-import { log, ensureDir, writeFile } from './utils.js';
-import { scanProject } from './scanner.js';
-import { runAllChecks } from './doctor-checks.js';
-import { generatePrompt, generateAllPrompts, generateReport } from './doctor-prompts.js';
-import { askDoctorAction } from './prompts.js';
-
-export async function runDoctor(projectDir) {
-  console.log('');
-  console.log(chalk.bold.cyan('  🔨 DevForge Doctor') + chalk.dim(' — Project Health Check'));
-  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 vitals
-  printVitals(scan);
-
-  // Run all checks
-  const issues = runAllChecks(projectDir, scan);
-
-  if (issues.length === 0) {
-    console.log(chalk.green('  ✓ Your project looks healthy! No issues found.'));
-    console.log('');
-    return;
-  }
-
-  // Print issues summary
-  printIssues(issues);
-
-  // Ask what to do
-  const action = await askDoctorAction();
-
-  switch (action) {
-    case 'guided':
-      await guidedFix(issues);
-      break;
-    case 'report':
-      await saveReport(issues, scan, projectDir);
-      break;
-    case 'autofix':
-      await autoFixSafe(issues, projectDir);
-      break;
-    case 'prompts':
-      await exportPrompts(issues, projectDir);
-      break;
-  }
-}
-
-function printVitals(scan) {
-  console.log(chalk.bold('  📊 Project Vitals:'));
-  console.log('');
-
-  const parts = [];
-  if (scan.frontend.detected) {
-    parts.push(`  ${chalk.bold('Frontend:')}  ${scan.frontend.framework} (${scan.frontend.language})`);
-  }
-  if (scan.backend.detected) {
-    parts.push(`  ${chalk.bold('Backend:')}   ${scan.backend.framework} (${scan.backend.language})`);
-  }
-  if (scan.database.detected) {
-    parts.push(`  ${chalk.bold('Database:')}  ${scan.database.type} (${scan.database.orm})`);
-  }
-
-  const testParts = [scan.testing.unit, scan.testing.e2e, scan.testing.backend].filter(Boolean);
-  if (testParts.length) {
-    parts.push(`  ${chalk.bold('Testing:')}   ${testParts.join(' + ')}`);
-  }
-
-  if (scan.ai) {
-    parts.push(`  ${chalk.bold('AI:')}        integration detected`);
-  }
-
-  console.log(parts.join('\n'));
-  console.log('');
-}
-
-function printIssues(issues) {
-  const critical = issues.filter(i => i.severity === 'critical');
-  const warnings = issues.filter(i => i.severity === 'warning');
-  const info = issues.filter(i => i.severity === 'info');
-
-  console.log(chalk.bold('  Health Issues Found:'));
-  console.log('');
-
-  if (critical.length > 0) {
-    console.log(chalk.red.bold('  🔴 CRITICAL'));
-    for (let i = 0; i < critical.length; i++) {
-      const issue = critical[i];
-      console.log(chalk.red(`    ${i + 1}. ${issue.title}`));
-      console.log(chalk.dim(`       → ${issue.impact}`));
-      if (issue.files && issue.files.length > 0 && issue.files.length <= 3) {
-        console.log(chalk.dim(`       Files: ${issue.files.join(', ')}`));
-      }
-    }
-    console.log('');
-  }
-
-  if (warnings.length > 0) {
-    console.log(chalk.yellow.bold('  🟡 WARNING'));
-    for (let i = 0; i < warnings.length; i++) {
-      const issue = warnings[i];
-      console.log(chalk.yellow(`    ${critical.length + i + 1}. ${issue.title}`));
-      console.log(chalk.dim(`       → ${issue.impact}`));
-    }
-    console.log('');
-  }
-
-  if (info.length > 0) {
-    console.log(chalk.blue.bold('  ℹ️  SUGGESTIONS'));
-    for (let i = 0; i < info.length; i++) {
-      const issue = info[i];
-      console.log(chalk.blue(`    ${critical.length + warnings.length + i + 1}. ${issue.title}`));
-      console.log(chalk.dim(`       → ${issue.impact}`));
-    }
-    console.log('');
-  }
-
-  // Print good checks
-  const goodChecks = [];
-  if (!critical.some(i => i.promptId === 'UNAUTH_ENDPOINT') && !warnings.some(i => i.promptId === 'UNAUTH_ENDPOINT')) {
-    goodChecks.push('All endpoints have authentication');
-  }
-  if (!critical.some(i => i.promptId === 'FLAKY_TESTS')) {
-    goodChecks.push('No flaky test patterns detected');
-  }
-  if (!warnings.some(i => i.promptId === 'BARE_EXCEPT')) {
-    goodChecks.push('No bare except blocks');
-  }
-
-  if (goodChecks.length > 0) {
-    console.log(chalk.green.bold('  🟢 GOOD'));
-    for (const check of goodChecks) {
-      console.log(chalk.green(`    ✓ ${check}`));
-    }
-    console.log('');
-  }
-}
-
-async function guidedFix(issues) {
-  const { input } = await import('@inquirer/prompts');
-  const critical = issues.filter(i => i.severity === 'critical');
-  const warnings = issues.filter(i => i.severity === 'warning');
-  const allIssues = [...critical, ...warnings];
-
-  if (allIssues.length === 0) {
-    log.info('No critical or warning issues to fix.');
-    return;
-  }
-
-  for (let i = 0; i < allIssues.length; i++) {
-    const issue = allIssues[i];
-    const prompt = generatePrompt(issue);
-
-    console.log('');
-    console.log(chalk.bold(`  Issue ${i + 1} of ${allIssues.length}: ${issue.title}`));
-    console.log('');
-    console.log(chalk.dim(`  ${issue.impact}`));
-    console.log('');
-    console.log('  To fix this, open Claude Code and paste:');
-    console.log(chalk.cyan('  ┌' + '─'.repeat(68) + '┐'));
-    const promptLines = prompt.split('\n');
-    for (const line of promptLines) {
-      const padded = line.padEnd(68);
-      console.log(chalk.cyan('  │ ') + padded + chalk.cyan(' │'));
-    }
-    console.log(chalk.cyan('  └' + '─'.repeat(68) + '┘'));
-
-    if (i < allIssues.length - 1) {
-      await input({ message: 'Press enter for next issue, or type q to quit:' }).then(answer => {
-        if (answer.toLowerCase() === 'q') {
-          process.exit(0);
-        }
-      });
-    }
-  }
-
-  console.log('');
-  log.success('All issues shown. Fix them in Claude Code one at a time.');
-  console.log('');
-}
-
-async function saveReport(issues, scan, projectDir) {
-  const report = generateReport(issues, scan.projectName);
-  const reportPath = path.join(projectDir, 'docs', 'doctor-report.md');
-  writeFile(reportPath, report);
-  console.log('');
-  log.success(`Report saved to ${path.relative(projectDir, reportPath)}`);
-  console.log('');
-}
-
-async function autoFixSafe(issues, projectDir) {
-  console.log('');
-  console.log('  Auto-fixing safe issues...');
-  console.log('');
-
-  let fixed = 0;
-
-  // Create missing directories
-  const dirsToCreate = ['docs/uat', 'docs/plans'];
-  for (const dir of dirsToCreate) {
-    const fullPath = path.join(projectDir, dir);
-    if (!fs.existsSync(fullPath)) {
-      ensureDir(fullPath);
-      console.log(chalk.green(`  ✓ Created ${dir}/ directory`));
-      fixed++;
-    }
-  }
-
-  // Fix hook script permissions (Unix only)
-  if (process.platform !== 'win32') {
-    const hooksDir = path.join(projectDir, '.claude', 'hooks');
-    if (fs.existsSync(hooksDir)) {
-      const hookFiles = fs.readdirSync(hooksDir).filter(f => f.endsWith('.sh'));
-      for (const hookFile of hookFiles) {
-        const hookPath = path.join(hooksDir, hookFile);
-        try {
-          fs.chmodSync(hookPath, '755');
-          console.log(chalk.green(`  ✓ Fixed ${path.join('.claude/hooks', hookFile)} permissions (chmod +x)`));
-          fixed++;
-        } catch {
-          // Skip
-        }
-      }
-    }
-  }
-
-  // Add missing .gitignore entries
-  const gitignorePath = path.join(projectDir, '.gitignore');
-  if (fs.existsSync(gitignorePath)) {
-    const content = fs.readFileSync(gitignorePath, 'utf-8');
-    const entriesToAdd = [];
-
-    if (!content.includes('.claude/todos')) entriesToAdd.push('.claude/todos');
-    if (!content.includes('.claude/plans')) entriesToAdd.push('.claude/plans');
-
-    if (entriesToAdd.length > 0) {
-      const addition = '\n# Claude Code temp files\n' + entriesToAdd.join('\n') + '\n';
-      fs.appendFileSync(gitignorePath, addition);
-      console.log(chalk.green(`  ✓ Added ${entriesToAdd.length} entries to .gitignore`));
-      fixed++;
-    }
-  }
-
-  const skipped = issues.filter(i => !i.autoFixable).length;
-
-  if (fixed === 0) {
-    console.log(chalk.dim('  Nothing to auto-fix.'));
-  }
-
-  if (skipped > 0) {
-    console.log(chalk.dim(`  ⊘ Skipped ${skipped} issues that need Claude Code to fix`));
-  }
-
-  console.log('');
-  if (skipped > 0) {
-    console.log(`  For the remaining issues, run: ${chalk.cyan('npx devforge doctor')} → option 1 or 2`);
-    console.log('');
-  }
-}
-
-async function exportPrompts(issues, projectDir) {
-  const content = generateAllPrompts(issues);
-  const promptsPath = path.join(projectDir, 'docs', 'doctor-prompts.md');
-  writeFile(promptsPath, content);
-  console.log('');
-  log.success(`Fix prompts saved to ${path.relative(projectDir, promptsPath)}`);
-  console.log(chalk.dim('  Open Claude Code and work through them one at a time.'));
-  console.log(chalk.dim('  /clear between sessions.'));
-  console.log('');
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { log, ensureDir, writeFile } from './utils.js';
+import { scanProject } from './scanner.js';
+import { runAllChecks } from './doctor-checks.js';
+import { generatePrompt, generateAllPrompts, generateReport } from './doctor-prompts.js';
+import { askDoctorAction } from './prompts.js';
+
+export async function runDoctor(projectDir) {
+  console.log('');
+  console.log(chalk.bold.cyan('  🔨 DevForge Doctor') + chalk.dim(' — Project Health Check'));
+  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 vitals
+  printVitals(scan);
+
+  // Run all checks
+  const issues = runAllChecks(projectDir, scan);
+
+  if (issues.length === 0) {
+    console.log(chalk.green('  ✓ Your project looks healthy! No issues found.'));
+    console.log('');
+    return;
+  }
+
+  // Print issues summary
+  printIssues(issues);
+
+  // Ask what to do
+  const action = await askDoctorAction();
+
+  switch (action) {
+    case 'guided':
+      await guidedFix(issues);
+      break;
+    case 'report':
+      await saveReport(issues, scan, projectDir);
+      break;
+    case 'autofix':
+      await autoFixSafe(issues, projectDir);
+      break;
+    case 'prompts':
+      await exportPrompts(issues, projectDir);
+      break;
+  }
+}
+
+function printVitals(scan) {
+  console.log(chalk.bold('  📊 Project Vitals:'));
+  console.log('');
+
+  const parts = [];
+  if (scan.frontend.detected) {
+    parts.push(`  ${chalk.bold('Frontend:')}  ${scan.frontend.framework} (${scan.frontend.language})`);
+  }
+  if (scan.backend.detected) {
+    parts.push(`  ${chalk.bold('Backend:')}   ${scan.backend.framework} (${scan.backend.language})`);
+  }
+  if (scan.database.detected) {
+    parts.push(`  ${chalk.bold('Database:')}  ${scan.database.type} (${scan.database.orm})`);
+  }
+
+  const testParts = [scan.testing.unit, scan.testing.e2e, scan.testing.backend].filter(Boolean);
+  if (testParts.length) {
+    parts.push(`  ${chalk.bold('Testing:')}   ${testParts.join(' + ')}`);
+  }
+
+  if (scan.ai) {
+    parts.push(`  ${chalk.bold('AI:')}        integration detected`);
+  }
+
+  console.log(parts.join('\n'));
+  console.log('');
+}
+
+function printIssues(issues) {
+  const critical = issues.filter(i => i.severity === 'critical');
+  const warnings = issues.filter(i => i.severity === 'warning');
+  const info = issues.filter(i => i.severity === 'info');
+
+  console.log(chalk.bold('  Health Issues Found:'));
+  console.log('');
+
+  if (critical.length > 0) {
+    console.log(chalk.red.bold('  🔴 CRITICAL'));
+    for (let i = 0; i < critical.length; i++) {
+      const issue = critical[i];
+      console.log(chalk.red(`    ${i + 1}. ${issue.title}`));
+      console.log(chalk.dim(`       → ${issue.impact}`));
+      if (issue.files && issue.files.length > 0 && issue.files.length <= 3) {
+        console.log(chalk.dim(`       Files: ${issue.files.join(', ')}`));
+      }
+    }
+    console.log('');
+  }
+
+  if (warnings.length > 0) {
+    console.log(chalk.yellow.bold('  🟡 WARNING'));
+    for (let i = 0; i < warnings.length; i++) {
+      const issue = warnings[i];
+      console.log(chalk.yellow(`    ${critical.length + i + 1}. ${issue.title}`));
+      console.log(chalk.dim(`       → ${issue.impact}`));
+    }
+    console.log('');
+  }
+
+  if (info.length > 0) {
+    console.log(chalk.blue.bold('  ℹ️  SUGGESTIONS'));
+    for (let i = 0; i < info.length; i++) {
+      const issue = info[i];
+      console.log(chalk.blue(`    ${critical.length + warnings.length + i + 1}. ${issue.title}`));
+      console.log(chalk.dim(`       → ${issue.impact}`));
+    }
+    console.log('');
+  }
+
+  // Print good checks
+  const goodChecks = [];
+  if (!critical.some(i => i.promptId === 'UNAUTH_ENDPOINT') && !warnings.some(i => i.promptId === 'UNAUTH_ENDPOINT')) {
+    goodChecks.push('All endpoints have authentication');
+  }
+  if (!critical.some(i => i.promptId === 'FLAKY_TESTS')) {
+    goodChecks.push('No flaky test patterns detected');
+  }
+  if (!warnings.some(i => i.promptId === 'BARE_EXCEPT')) {
+    goodChecks.push('No bare except blocks');
+  }
+
+  if (goodChecks.length > 0) {
+    console.log(chalk.green.bold('  🟢 GOOD'));
+    for (const check of goodChecks) {
+      console.log(chalk.green(`    ✓ ${check}`));
+    }
+    console.log('');
+  }
+}
+
+async function guidedFix(issues) {
+  const { input } = await import('@inquirer/prompts');
+  const critical = issues.filter(i => i.severity === 'critical');
+  const warnings = issues.filter(i => i.severity === 'warning');
+  const allIssues = [...critical, ...warnings];
+
+  if (allIssues.length === 0) {
+    log.info('No critical or warning issues to fix.');
+    return;
+  }
+
+  for (let i = 0; i < allIssues.length; i++) {
+    const issue = allIssues[i];
+    const prompt = generatePrompt(issue);
+
+    console.log('');
+    console.log(chalk.bold(`  Issue ${i + 1} of ${allIssues.length}: ${issue.title}`));
+    console.log('');
+    console.log(chalk.dim(`  ${issue.impact}`));
+    console.log('');
+    console.log('  To fix this, open Claude Code and paste:');
+    console.log(chalk.cyan('  ┌' + '─'.repeat(68) + '┐'));
+    const promptLines = prompt.split('\n');
+    for (const line of promptLines) {
+      const padded = line.padEnd(68);
+      console.log(chalk.cyan('  │ ') + padded + chalk.cyan(' │'));
+    }
+    console.log(chalk.cyan('  └' + '─'.repeat(68) + '┘'));
+
+    if (i < allIssues.length - 1) {
+      await input({ message: 'Press enter for next issue, or type q to quit:' }).then(answer => {
+        if (answer.toLowerCase() === 'q') {
+          process.exit(0);
+        }
+      });
+    }
+  }
+
+  console.log('');
+  log.success('All issues shown. Fix them in Claude Code one at a time.');
+  console.log('');
+}
+
+async function saveReport(issues, scan, projectDir) {
+  const report = generateReport(issues, scan.projectName);
+  const reportPath = path.join(projectDir, 'docs', 'doctor-report.md');
+  writeFile(reportPath, report);
+  console.log('');
+  log.success(`Report saved to ${path.relative(projectDir, reportPath)}`);
+  console.log('');
+}
+
+async function autoFixSafe(issues, projectDir) {
+  console.log('');
+  console.log('  Auto-fixing safe issues...');
+  console.log('');
+
+  let fixed = 0;
+
+  // Create missing directories
+  const dirsToCreate = ['docs/uat', 'docs/plans'];
+  for (const dir of dirsToCreate) {
+    const fullPath = path.join(projectDir, dir);
+    if (!fs.existsSync(fullPath)) {
+      ensureDir(fullPath);
+      console.log(chalk.green(`  ✓ Created ${dir}/ directory`));
+      fixed++;
+    }
+  }
+
+  // Fix hook script permissions (Unix only)
+  if (process.platform !== 'win32') {
+    const hooksDir = path.join(projectDir, '.claude', 'hooks');
+    if (fs.existsSync(hooksDir)) {
+      const hookFiles = fs.readdirSync(hooksDir).filter(f => f.endsWith('.sh'));
+      for (const hookFile of hookFiles) {
+        const hookPath = path.join(hooksDir, hookFile);
+        try {
+          fs.chmodSync(hookPath, '755');
+          console.log(chalk.green(`  ✓ Fixed ${path.join('.claude/hooks', hookFile)} permissions (chmod +x)`));
+          fixed++;
+        } catch {
+          // Skip
+        }
+      }
+    }
+  }
+
+  // Add missing .gitignore entries
+  const gitignorePath = path.join(projectDir, '.gitignore');
+  if (fs.existsSync(gitignorePath)) {
+    const content = fs.readFileSync(gitignorePath, 'utf-8');
+    const entriesToAdd = [];
+
+    if (!content.includes('.claude/todos')) entriesToAdd.push('.claude/todos');
+    if (!content.includes('.claude/plans')) entriesToAdd.push('.claude/plans');
+
+    if (entriesToAdd.length > 0) {
+      const addition = '\n# Claude Code temp files\n' + entriesToAdd.join('\n') + '\n';
+      fs.appendFileSync(gitignorePath, addition);
+      console.log(chalk.green(`  ✓ Added ${entriesToAdd.length} entries to .gitignore`));
+      fixed++;
+    }
+  }
+
+  const skipped = issues.filter(i => !i.autoFixable).length;
+
+  if (fixed === 0) {
+    console.log(chalk.dim('  Nothing to auto-fix.'));
+  }
+
+  if (skipped > 0) {
+    console.log(chalk.dim(`  ⊘ Skipped ${skipped} issues that need Claude Code to fix`));
+  }
+
+  console.log('');
+  if (skipped > 0) {
+    console.log(`  For the remaining issues, run: ${chalk.cyan('npx devforge doctor')} → option 1 or 2`);
+    console.log('');
+  }
+}
+
+async function exportPrompts(issues, projectDir) {
+  const content = generateAllPrompts(issues);
+  const promptsPath = path.join(projectDir, 'docs', 'doctor-prompts.md');
+  writeFile(promptsPath, content);
+  console.log('');
+  log.success(`Fix prompts saved to ${path.relative(projectDir, promptsPath)}`);
+  console.log(chalk.dim('  Open Claude Code and work through them one at a time.'));
+  console.log(chalk.dim('  /clear between sessions.'));
+  console.log('');
+}