forgedev 1.0.0 → 1.0.1

package/src/claude-configurator.js

@@ -1,260 +1,260 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { ROOT_DIR, ensureDir, writeFile, readTemplate, replaceVars, log } from './utils.js';
-
-const CLAUDE_TEMPLATES_DIR = path.join(ROOT_DIR, 'templates', 'claude-code');
-const DOCS_DIR = path.join(ROOT_DIR, 'docs');
-
-export async function generateClaudeConfig(outputDir, stackConfig, options = {}) {
-  const vars = buildClaudeVars(stackConfig);
-
-  if (!options.skipClaudeMd) {
-    generateClaudeMd(outputDir, stackConfig, vars);
-  }
-  generateHooks(outputDir, stackConfig, { merge: options.mergeSettings });
-  generateSkills(outputDir, stackConfig);
-  generateAgents(outputDir, stackConfig, vars);
-  generateCommands(outputDir, stackConfig, vars);
-  copyPromptLibrary(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(''),
-  };
-
-  if (config.stackId === 'nextjs-fullstack') {
-    vars.STACK_SUMMARY = 'Next.js 15 (App Router) + TypeScript + Tailwind CSS + Prisma + PostgreSQL';
-    vars.LINT_COMMAND = 'npx eslint .';
-    vars.TYPE_CHECK_COMMAND = 'npx tsc --noEmit';
-    vars.TEST_COMMAND = 'npx vitest run';
-    vars.BUILD_COMMAND = 'npm run build';
-    vars.DEV_COMMAND = 'npm run dev';
-    vars.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.LINT_COMMAND = 'ruff check .';
-    vars.TYPE_CHECK_COMMAND = 'pyright';
-    vars.TEST_COMMAND = 'pytest';
-    vars.BUILD_COMMAND = 'docker build -t app .';
-    vars.DEV_COMMAND = 'uvicorn app.main:app --reload';
-    vars.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.LINT_COMMAND = 'cd frontend && npx eslint . && cd ../backend && ruff check .';
-    vars.TYPE_CHECK_COMMAND = 'cd frontend && npx tsc --noEmit';
-    vars.TEST_COMMAND = 'cd frontend && npx vitest run && cd ../backend && pytest';
-    vars.BUILD_COMMAND = 'docker compose build';
-    vars.DEV_COMMAND = 'docker compose up';
-    vars.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`;
-  }
-
-  // Build skills list for CLAUDE.md reference
-  const skillsList = [];
-  if (config.frontend?.framework === 'nextjs') {
-    skillsList.push('- `@.claude/skills/nextjs/` — Next.js patterns and conventions');
-    skillsList.push('- `@.claude/skills/security-web/` — Frontend security practices');
-  }
-  if (config.backend?.framework === 'fastapi') {
-    skillsList.push('- `@.claude/skills/fastapi/` — FastAPI patterns and conventions');
-    skillsList.push('- `@.claude/skills/security-api/` — API security practices');
-  }
-  if (config.testing?.e2e === 'playwright') {
-    skillsList.push('- `@.claude/skills/playwright/` — E2E testing patterns');
-  }
-  if (config.ai) {
-    skillsList.push('- `@.claude/skills/ai-prompts/` — AI/LLM prompt patterns');
-  }
-  vars.SKILLS_LIST = skillsList.length > 0 ? skillsList.join('\n') : '- (none generated)';
-
-  return vars;
-}
-
-function generateClaudeMd(outputDir, config, vars) {
-  // Read base template
-  const basePath = path.join(CLAUDE_TEMPLATES_DIR, 'claude-md', 'base.md');
-  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'));
-  }
-
-  content = content.replace('{{STACK_SPECIFIC_RULES}}', stackSection);
-  content = replaceVars(content, vars);
-
-  writeFile(path.join(outputDir, 'CLAUDE.md'), content);
-}
-
-function generateHooks(outputDir, config, options = {}) {
-  let hookFile;
-  let scriptFiles = ['guard-protected-files.sh'];
-
-  if (config.stackId === 'nextjs-fullstack') {
-    hookFile = 'typescript.json';
-    scriptFiles.push('autofix-typescript.sh');
-  } else if (config.stackId === 'fastapi-backend') {
-    hookFile = 'python.json';
-    scriptFiles.push('autofix-python.sh');
-  } else if (config.stackId === 'polyglot-fullstack') {
-    hookFile = 'polyglot.json';
-    scriptFiles.push('autofix-polyglot.sh');
-  }
-
-  const settingsPath = path.join(outputDir, '.claude', 'settings.json');
-
-  if (options.merge && fs.existsSync(settingsPath)) {
-    // 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);
-    writeFile(settingsPath, JSON.stringify(merged, null, 2));
-  } else {
-    const hookPath = path.join(CLAUDE_TEMPLATES_DIR, 'hooks', hookFile);
-    const content = readTemplate(hookPath);
-    writeFile(settingsPath, content);
-  }
-
-  // Copy hook scripts
-  const hooksDir = path.join(outputDir, '.claude', 'hooks');
-  ensureDir(hooksDir);
-  for (const script of scriptFiles) {
-    const srcPath = path.join(CLAUDE_TEMPLATES_DIR, 'hooks', 'scripts', script);
-    if (fs.existsSync(srcPath)) {
-      fs.copyFileSync(srcPath, path.join(hooksDir, script));
-    }
-  }
-}
-
-function deepMergeSettings(existing, incoming) {
-  const merged = { ...existing };
-  if (incoming.hooks) {
-    merged.hooks = merged.hooks || {};
-    for (const [hookType, hookArr] of Object.entries(incoming.hooks)) {
-      if (!merged.hooks[hookType]) {
-        merged.hooks[hookType] = hookArr;
-      } else {
-        // Append incoming hooks that don't already exist (by command)
-        const existingCommands = new Set(
-          merged.hooks[hookType].flatMap(h => (h.hooks || []).map(hk => hk.command))
-        );
-        for (const hook of hookArr) {
-          const isNew = (hook.hooks || []).some(hk => !existingCommands.has(hk.command));
-          if (isNew) {
-            merged.hooks[hookType].push(hook);
-          }
-        }
-      }
-    }
-  }
-  return merged;
-}
-
-function generateSkills(outputDir, config) {
-  const skillsToInclude = [];
-
-  if (config.frontend?.framework === 'nextjs') {
-    skillsToInclude.push('nextjs');
-    skillsToInclude.push('security-web');
-  }
-  if (config.backend?.framework === 'fastapi') {
-    skillsToInclude.push('fastapi');
-    skillsToInclude.push('security-api');
-  }
-  if (config.testing?.e2e === 'playwright') {
-    skillsToInclude.push('playwright');
-  }
-  if (config.ai) {
-    skillsToInclude.push('ai-prompts');
-  }
-
-  for (const skill of skillsToInclude) {
-    const srcPath = path.join(CLAUDE_TEMPLATES_DIR, 'skills', skill, 'SKILL.md');
-    if (fs.existsSync(srcPath)) {
-      const destPath = path.join(outputDir, '.claude', 'skills', skill, 'SKILL.md');
-      ensureDir(path.dirname(destPath));
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function generateAgents(outputDir, config, vars) {
-  const agentsDir = path.join(CLAUDE_TEMPLATES_DIR, 'agents');
-  const agents = [
-    'code-quality-reviewer.md',
-    'security-reviewer.md',
-    'spec-validator.md',
-    'production-readiness.md',
-    'uat-validator.md',
-  ];
-
-  for (const agent of agents) {
-    const srcPath = path.join(agentsDir, agent);
-    if (fs.existsSync(srcPath)) {
-      let content = readTemplate(srcPath);
-      content = replaceVars(content, vars);
-      writeFile(path.join(outputDir, '.claude', 'agents', agent), content);
-    }
-  }
-}
-
-function generateCommands(outputDir, config, vars) {
-  const commandsDir = path.join(CLAUDE_TEMPLATES_DIR, 'commands');
-  const commands = [
-    'help.md',
-    'status.md',
-    'next.md',
-    'done.md',
-    'verify-all.md',
-    'audit-spec.md',
-    'audit-wiring.md',
-    'audit-security.md',
-    'pre-pr.md',
-    'run-uat.md',
-    'generate-prd.md',
-    'generate-uat.md',
-    'optimize-claude-md.md',
-  ];
-
-  for (const cmd of commands) {
-    const srcPath = path.join(commandsDir, cmd);
-    if (fs.existsSync(srcPath)) {
-      let content = readTemplate(srcPath);
-      content = replaceVars(content, vars);
-      writeFile(path.join(outputDir, '.claude', 'commands', cmd), content);
-    }
-  }
-}
-
-function copyPromptLibrary(outputDir) {
-  const srcPath = path.join(DOCS_DIR, '01-universal-prompt-library.md');
-  if (fs.existsSync(srcPath)) {
-    const destPath = path.join(outputDir, 'docs', 'prompt-library.md');
-    ensureDir(path.dirname(destPath));
-    fs.copyFileSync(srcPath, destPath);
-  }
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { ROOT_DIR, ensureDir, writeFile, readTemplate, replaceVars, log } from './utils.js';
+
+const CLAUDE_TEMPLATES_DIR = path.join(ROOT_DIR, 'templates', 'claude-code');
+const DOCS_DIR = path.join(ROOT_DIR, 'docs');
+
+export async function generateClaudeConfig(outputDir, stackConfig, options = {}) {
+  const vars = buildClaudeVars(stackConfig);
+
+  if (!options.skipClaudeMd) {
+    generateClaudeMd(outputDir, stackConfig, vars);
+  }
+  generateHooks(outputDir, stackConfig, { merge: options.mergeSettings });
+  generateSkills(outputDir, stackConfig);
+  generateAgents(outputDir, stackConfig, vars);
+  generateCommands(outputDir, stackConfig, vars);
+  copyPromptLibrary(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(''),
+  };
+
+  if (config.stackId === 'nextjs-fullstack') {
+    vars.STACK_SUMMARY = 'Next.js 15 (App Router) + TypeScript + Tailwind CSS + Prisma + PostgreSQL';
+    vars.LINT_COMMAND = 'npx eslint .';
+    vars.TYPE_CHECK_COMMAND = 'npx tsc --noEmit';
+    vars.TEST_COMMAND = 'npx vitest run';
+    vars.BUILD_COMMAND = 'npm run build';
+    vars.DEV_COMMAND = 'npm run dev';
+    vars.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.LINT_COMMAND = 'ruff check .';
+    vars.TYPE_CHECK_COMMAND = 'pyright';
+    vars.TEST_COMMAND = 'pytest';
+    vars.BUILD_COMMAND = 'docker build -t app .';
+    vars.DEV_COMMAND = 'uvicorn app.main:app --reload';
+    vars.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.LINT_COMMAND = 'cd frontend && npx eslint . && cd ../backend && ruff check .';
+    vars.TYPE_CHECK_COMMAND = 'cd frontend && npx tsc --noEmit';
+    vars.TEST_COMMAND = 'cd frontend && npx vitest run && cd ../backend && pytest';
+    vars.BUILD_COMMAND = 'docker compose build';
+    vars.DEV_COMMAND = 'docker compose up';
+    vars.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`;
+  }
+
+  // Build skills list for CLAUDE.md reference
+  const skillsList = [];
+  if (config.frontend?.framework === 'nextjs') {
+    skillsList.push('- `@.claude/skills/nextjs/` — Next.js patterns and conventions');
+    skillsList.push('- `@.claude/skills/security-web/` — Frontend security practices');
+  }
+  if (config.backend?.framework === 'fastapi') {
+    skillsList.push('- `@.claude/skills/fastapi/` — FastAPI patterns and conventions');
+    skillsList.push('- `@.claude/skills/security-api/` — API security practices');
+  }
+  if (config.testing?.e2e === 'playwright') {
+    skillsList.push('- `@.claude/skills/playwright/` — E2E testing patterns');
+  }
+  if (config.ai) {
+    skillsList.push('- `@.claude/skills/ai-prompts/` — AI/LLM prompt patterns');
+  }
+  vars.SKILLS_LIST = skillsList.length > 0 ? skillsList.join('\n') : '- (none generated)';
+
+  return vars;
+}
+
+function generateClaudeMd(outputDir, config, vars) {
+  // Read base template
+  const basePath = path.join(CLAUDE_TEMPLATES_DIR, 'claude-md', 'base.md');
+  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'));
+  }
+
+  content = content.replace('{{STACK_SPECIFIC_RULES}}', stackSection);
+  content = replaceVars(content, vars);
+
+  writeFile(path.join(outputDir, 'CLAUDE.md'), content);
+}
+
+function generateHooks(outputDir, config, options = {}) {
+  let hookFile;
+  let scriptFiles = ['guard-protected-files.sh'];
+
+  if (config.stackId === 'nextjs-fullstack') {
+    hookFile = 'typescript.json';
+    scriptFiles.push('autofix-typescript.sh');
+  } else if (config.stackId === 'fastapi-backend') {
+    hookFile = 'python.json';
+    scriptFiles.push('autofix-python.sh');
+  } else if (config.stackId === 'polyglot-fullstack') {
+    hookFile = 'polyglot.json';
+    scriptFiles.push('autofix-polyglot.sh');
+  }
+
+  const settingsPath = path.join(outputDir, '.claude', 'settings.json');
+
+  if (options.merge && fs.existsSync(settingsPath)) {
+    // 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);
+    writeFile(settingsPath, JSON.stringify(merged, null, 2));
+  } else {
+    const hookPath = path.join(CLAUDE_TEMPLATES_DIR, 'hooks', hookFile);
+    const content = readTemplate(hookPath);
+    writeFile(settingsPath, content);
+  }
+
+  // Copy hook scripts
+  const hooksDir = path.join(outputDir, '.claude', 'hooks');
+  ensureDir(hooksDir);
+  for (const script of scriptFiles) {
+    const srcPath = path.join(CLAUDE_TEMPLATES_DIR, 'hooks', 'scripts', script);
+    if (fs.existsSync(srcPath)) {
+      fs.copyFileSync(srcPath, path.join(hooksDir, script));
+    }
+  }
+}
+
+function deepMergeSettings(existing, incoming) {
+  const merged = { ...existing };
+  if (incoming.hooks) {
+    merged.hooks = merged.hooks || {};
+    for (const [hookType, hookArr] of Object.entries(incoming.hooks)) {
+      if (!merged.hooks[hookType]) {
+        merged.hooks[hookType] = hookArr;
+      } else {
+        // Append incoming hooks that don't already exist (by command)
+        const existingCommands = new Set(
+          merged.hooks[hookType].flatMap(h => (h.hooks || []).map(hk => hk.command))
+        );
+        for (const hook of hookArr) {
+          const isNew = (hook.hooks || []).some(hk => !existingCommands.has(hk.command));
+          if (isNew) {
+            merged.hooks[hookType].push(hook);
+          }
+        }
+      }
+    }
+  }
+  return merged;
+}
+
+function generateSkills(outputDir, config) {
+  const skillsToInclude = [];
+
+  if (config.frontend?.framework === 'nextjs') {
+    skillsToInclude.push('nextjs');
+    skillsToInclude.push('security-web');
+  }
+  if (config.backend?.framework === 'fastapi') {
+    skillsToInclude.push('fastapi');
+    skillsToInclude.push('security-api');
+  }
+  if (config.testing?.e2e === 'playwright') {
+    skillsToInclude.push('playwright');
+  }
+  if (config.ai) {
+    skillsToInclude.push('ai-prompts');
+  }
+
+  for (const skill of skillsToInclude) {
+    const srcPath = path.join(CLAUDE_TEMPLATES_DIR, 'skills', skill, 'SKILL.md');
+    if (fs.existsSync(srcPath)) {
+      const destPath = path.join(outputDir, '.claude', 'skills', skill, 'SKILL.md');
+      ensureDir(path.dirname(destPath));
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function generateAgents(outputDir, config, vars) {
+  const agentsDir = path.join(CLAUDE_TEMPLATES_DIR, 'agents');
+  const agents = [
+    'code-quality-reviewer.md',
+    'security-reviewer.md',
+    'spec-validator.md',
+    'production-readiness.md',
+    'uat-validator.md',
+  ];
+
+  for (const agent of agents) {
+    const srcPath = path.join(agentsDir, agent);
+    if (fs.existsSync(srcPath)) {
+      let content = readTemplate(srcPath);
+      content = replaceVars(content, vars);
+      writeFile(path.join(outputDir, '.claude', 'agents', agent), content);
+    }
+  }
+}
+
+function generateCommands(outputDir, config, vars) {
+  const commandsDir = path.join(CLAUDE_TEMPLATES_DIR, 'commands');
+  const commands = [
+    'help.md',
+    'status.md',
+    'next.md',
+    'done.md',
+    'verify-all.md',
+    'audit-spec.md',
+    'audit-wiring.md',
+    'audit-security.md',
+    'pre-pr.md',
+    'run-uat.md',
+    'generate-prd.md',
+    'generate-uat.md',
+    'optimize-claude-md.md',
+  ];
+
+  for (const cmd of commands) {
+    const srcPath = path.join(commandsDir, cmd);
+    if (fs.existsSync(srcPath)) {
+      let content = readTemplate(srcPath);
+      content = replaceVars(content, vars);
+      writeFile(path.join(outputDir, '.claude', 'commands', cmd), content);
+    }
+  }
+}
+
+function copyPromptLibrary(outputDir) {
+  const srcPath = path.join(DOCS_DIR, '01-universal-prompt-library.md');
+  if (fs.existsSync(srcPath)) {
+    const destPath = path.join(outputDir, 'docs', 'prompt-library.md');
+    ensureDir(path.dirname(destPath));
+    fs.copyFileSync(srcPath, destPath);
+  }
+}