golem-cc 2.1.2 → 3.0.0

package/.golem/lib/doctor.mjs

@@ -0,0 +1,197 @@
+import { access, readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { header, success, fail, warn, info } from './output.mjs';
+
+const INSTALL_CMDS = {
+  gitleaks: 'brew install gitleaks',
+  semgrep: 'brew install semgrep',
+  trivy: 'brew install trivy',
+};
+
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function runCmd(cmd) {
+  try {
+    return execSync(cmd, { stdio: 'pipe', encoding: 'utf-8' }).trim();
+  } catch {
+    return null;
+  }
+}
+
+async function fixEnvGitignore(cwd) {
+  const giPath = join(cwd, '.gitignore');
+  try {
+    const content = await readFile(giPath, 'utf-8');
+    if (!content.split('\n').some(l => l.trim() === '.env' || l.trim() === '.env*')) {
+      await writeFile(giPath, content.trimEnd() + '\n.env\n');
+      return true;
+    }
+  } catch {
+    await writeFile(giPath, '.env\n');
+    return true;
+  }
+  return false;
+}
+
+async function fixMissingDirs(cwd) {
+  const dirs = ['.golem', '.golem/specs', '.golem/prompts', '.golem/agents', '.golem/lib', '.golem/bin'];
+  let fixed = 0;
+  for (const dir of dirs) {
+    const full = join(cwd, dir);
+    if (!await fileExists(full)) {
+      await mkdir(full, { recursive: true });
+      fixed++;
+    }
+  }
+  return fixed;
+}
+
+async function fixSlashCommands(cwd) {
+  const dir = join(cwd, '.claude/commands/golem');
+  if (await fileExists(dir)) return false;
+  await mkdir(dir, { recursive: true });
+  const stubs = ['spec', 'plan', 'build', 'review', 'security', 'simplify', 'status', 'doctor', 'config', 'help'];
+  for (const name of stubs) {
+    const file = join(dir, `${name}.md`);
+    if (!await fileExists(file)) {
+      await writeFile(file, `Run \`npx golem ${name}\` or see \`npx golem help\`.\n`);
+    }
+  }
+  return true;
+}
+
+export async function runDoctor(opts = {}) {
+  const fixing = !!opts.fix;
+  header('Golem Doctor');
+  if (fixing) info('Running with --fix: will attempt to repair issues');
+
+  const results = [];
+  const cwd = process.cwd();
+
+  // --- Project checks ---
+  console.log();
+  info('Project checks:');
+
+  // .golem/ directory
+  let golemDir = await fileExists(join(cwd, '.golem'));
+  if (!golemDir && fixing) {
+    const n = await fixMissingDirs(cwd);
+    if (n > 0) { success('Created missing .golem/ directories'); golemDir = true; }
+  }
+  results.push(['.golem/ directory', golemDir]);
+  golemDir ? success('.golem/ exists') : fail('.golem/ missing');
+
+  // AGENTS.md
+  const agents = await fileExists(join(cwd, '.golem/AGENTS.md'));
+  results.push(['AGENTS.md', agents]);
+  agents ? success('AGENTS.md exists') : fail('AGENTS.md missing');
+
+  // Slash commands
+  let slashCmds = await fileExists(join(cwd, '.claude/commands/golem'));
+  if (!slashCmds && fixing) {
+    if (await fixSlashCommands(cwd)) { success('Generated slash command stubs'); slashCmds = true; }
+  }
+  results.push(['Slash commands', slashCmds]);
+  slashCmds ? success('Slash commands present') : warn('Slash commands not installed');
+
+  // .env in .gitignore
+  let envIgnored = false;
+  try {
+    const gi = await readFile(join(cwd, '.gitignore'), 'utf-8');
+    envIgnored = gi.split('\n').some(l => l.trim() === '.env' || l.trim() === '.env*');
+  } catch { /* no gitignore */ }
+  if (!envIgnored && fixing) {
+    if (await fixEnvGitignore(cwd)) { success('Added .env to .gitignore'); envIgnored = true; }
+  }
+  results.push(['.env in .gitignore', envIgnored]);
+  envIgnored ? success('.env is gitignored') : fail('.env NOT in .gitignore');
+
+  // Specs
+  const specs = await fileExists(join(cwd, '.golem/specs'));
+  results.push(['Specs directory', specs]);
+  specs ? success('Specs exist') : warn('No specs found');
+
+  // Plan
+  const plan = await fileExists(join(cwd, '.golem/IMPLEMENTATION_PLAN.md'));
+  results.push(['Implementation plan', plan]);
+  plan ? success('Plan exists') : warn('No plan found');
+
+  // --- User checks ---
+  console.log();
+  info('User checks:');
+
+  const claudeVersion = runCmd('claude --version');
+  results.push(['Claude CLI', !!claudeVersion]);
+  claudeVersion ? success(`Claude CLI: ${claudeVersion}`) : fail('Claude CLI not found');
+
+  const nodeVersion = runCmd('node --version');
+  const nodeOk = nodeVersion && parseInt(nodeVersion.replace('v', '')) >= 18;
+  results.push(['Node.js >= 18', nodeOk]);
+  nodeOk ? success(`Node.js: ${nodeVersion}`) : fail(`Node.js: ${nodeVersion || 'not found'} (need >= 18)`);
+
+  const gitUser = runCmd('git config user.name');
+  const gitEmail = runCmd('git config user.email');
+  const gitOk = !!(gitUser && gitEmail);
+  results.push(['Git configured', gitOk]);
+  gitOk ? success(`Git: ${gitUser} <${gitEmail}>`) : warn('Git user not configured');
+
+  // Old installations
+  const oldGolem = await fileExists(join(process.env.HOME || '~', '.golem'));
+  if (oldGolem) warn('Old ~/.golem/ installation detected — consider removing');
+
+  // --- Security tools ---
+  console.log();
+  info('Security tools:');
+
+  for (const tool of ['gitleaks', 'semgrep', 'trivy']) {
+    const toolPath = runCmd(`which ${tool}`);
+    results.push([tool, !!toolPath]);
+    if (toolPath) {
+      success(`${tool}: ${toolPath}`);
+    } else {
+      warn(`${tool}: not installed — ${INSTALL_CMDS[tool]}`);
+    }
+  }
+
+  // --- Test commands ---
+  console.log();
+  info('Test commands:');
+  try {
+    const agentsContent = await readFile(join(cwd, '.golem/AGENTS.md'), 'utf-8');
+    const testMatch = agentsContent.match(/```bash\n(.*?)\n```/s);
+    if (testMatch) {
+      const testCmd = testMatch[1].trim();
+      if (testCmd && !testCmd.startsWith('#')) {
+        const testResult = runCmd(testCmd);
+        results.push(['Test command', testResult !== null]);
+        testResult !== null ? success(`Test: \`${testCmd}\` works`) : fail(`Test: \`${testCmd}\` failed`);
+      }
+    }
+  } catch {
+    warn('Could not validate test commands');
+  }
+
+  // --- Summary ---
+  console.log();
+  const passed = results.filter(([, v]) => v).length;
+  const total = results.length;
+  if (passed === total) {
+    success(`All ${total} checks passed`);
+  } else {
+    warn(`${passed}/${total} checks passed`);
+  }
+
+  if (opts.json) {
+    console.log(JSON.stringify(Object.fromEntries(results)));
+  }
+
+  return { passed, total, results: Object.fromEntries(results) };
+}