forgedev 1.3.0 → 1.4.0

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.0",
   "description": "Universal, AI-first project scaffolding CLI with Claude Code infrastructure",
   "type": "module",
   "bin": {

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) {