forgedev 1.0.0 → 1.0.1

package/README.md

@@ -1,246 +1,246 @@
-# DevForge
-
-Universal, AI-first project scaffolding CLI. Describe what you're building, get the right stack recommended, and ship with Claude Code infrastructure pre-configured.
-
-## Quick Start
-
-```bash
-# New project — guided (for beginners)
-npx devforge new my-app
-
-# New project — shorthand
-npx devforge my-app
-
-# Add dev guardrails to existing project
-npx devforge init
-
-# Diagnose and optimize existing project
-npx devforge doctor
-```
-
-## Four Modes, Four Audiences
-
-### 1. Guided Mode (beginners & non-developers)
-
-Describe what you want in plain English. DevForge picks the stack.
-
-```
-$ npx devforge new my-app
-
-  🔨 DevForge — Let's build something.
-
-? How would you like to start?
-  💬 Describe what you want to build (recommended for beginners)
-  ⚡ I know my stack — let me pick (for developers)
-
-> Describe
-
-Tell me about what you want to build:
-> I want an app where restaurants manage their menu and customers order food
-
-  Got it! Here's what I'll set up for you:
-
-  What you'll get:
-  ├── A website where you can:
-  │   • Manage menu
-  │   • Manage orders
-  │
-  ├── User accounts (with different roles like admin and user)
-  ├── Payment processing for orders or subscriptions
-  ├── Search and filtering
-  ├── A database to store all your data
-  │
-  └── Developer tools:
-      • Code quality checks (catches errors automatically)
-      • Guided workflows (type /project:help anytime you're stuck)
-      • Testing templates
-
-? Sound right? Yes — create it!
-```
-
-Zero technical jargon. DevForge makes all the decisions. After scaffolding, generates `docs/getting-started.md` with a beginner-friendly walkthrough.
-
-### 2. Developer Mode (developers who know their stack)
-
-```
-$ npx devforge new my-app
-
-? How would you like to start?
-  ⚡ I know my stack — let me pick
-
-? What are you building? Full-stack app
-? Backend language? Python (polyglot)
-? Need authentication? Yes
-? Deployment target? Docker
-
-  Recommended stack:
-  Frontend: nextjs + typescript + tailwind + shadcn
-  Backend:  fastapi + python + sqlalchemy
-  Database: postgresql (both)
-  Auth:     both
-  Testing:  vitest + playwright + pytest
-  Deploy:   docker
-  Claude:   CLAUDE.md + hooks + skills + agents + commands
-
-? Proceed with this stack? Yes
-
-✓ Done! Your project is ready.
-```
-
-### 3. Init Mode (add guardrails to existing projects)
-
-```
-$ cd my-existing-project
-$ npx devforge init
-
-  🔨 DevForge — Adding dev guardrails
-
-  Scanning...
-
-  Detected: nextjs (typescript) + fastapi (python) + postgresql (prisma) + vitest + playwright + pytest
-
-  Installing:
-  ✓ .claude/hooks/ — auto-lint, quality gate, file protection
-  ✓ .claude/agents/ — code quality, security, spec validator
-  ✓ .claude/commands/ — help, status, next, done, audit, pre-pr
-  ✓ .claude/skills/ — framework-specific knowledge
-  ✓ docs/uat/ — acceptance test templates
-  ⊘ CLAUDE.md — exists (tip: run /project:optimize-claude-md to slim it)
-
-  Done. Type /project:help to get started.
-```
-
-Zero questions. Scans, detects, installs.
-
-### 4. Doctor Mode (diagnose & optimize existing projects)
-
-```
-$ npx devforge doctor
-
-  🔨 DevForge Doctor — Project Health Check
-
-  Scanning...
-
-  📊 Project Vitals:
-  Frontend:  nextjs (typescript)
-  Backend:   fastapi (python)
-  Database:  postgresql (sqlalchemy)
-  Testing:   vitest + playwright + pytest
-
-  Health Issues Found:
-
-  🔴 CRITICAL
-    1. CLAUDE.md is 647 lines (recommended limit: 150)
-       → Instructions are being dropped
-    2. 4 endpoints have no authentication
-       → Security vulnerability
-
-  🟡 WARNING
-    3. No health check endpoint
-    4. No UAT scenarios
-    5. 3 bare except: blocks
-
-  ? What would you like to do?
-    🚑 Fix critical issues (guided, one at a time)
-    📋 Generate a full report (save to docs/doctor-report.md)
-    ⚡ Auto-fix what's safe to auto-fix
-    📖 Just show me what to do (generates prompts for Claude Code)
-```
-
-Doctor diagnoses problems and generates the exact Claude Code prompt to fix each one.
-
-## Supported Stacks (V1)
-
-| Selection | Stack |
-|---|---|
-| Web app / Full-stack + TypeScript | Next.js 15 + Prisma + PostgreSQL + NextAuth + Vitest + Playwright |
-| API service + Python | FastAPI + SQLAlchemy 2.0 + PostgreSQL + Alembic + Pytest |
-| Full-stack + TS + Python | Next.js frontend + FastAPI backend (polyglot monorepo) |
-| AI/ML service | Polyglot full-stack with AI integration flag |
-
-## What Gets Generated
-
-Every project includes:
-
-- **Project scaffold** with working code, configs, and dependencies
-- **Health check endpoints** (`/health`, `/healthz`)
-- **Graceful shutdown handlers**
-- **Database connection retry** with exponential backoff
-- **Structured error responses** (never leaks stack traces)
-
-With Claude Code infrastructure enabled (default):
-
-- **CLAUDE.md** tailored to your stack
-- **Hooks** — auto-lint on edit, quality gate on stop
-- **Skills** — framework-specific knowledge
-- **Agents** — 5-agent verification chain
-- **Commands** — verify-all, audit-spec, audit-wiring, audit-security, pre-pr, run-uat, generate-prd, generate-uat, optimize-claude-md
-- **UAT templates** — scenario packs and CSV checklists
-- **Prompt library** — the complete development prompt library
-
-## Development
-
-```bash
-npm install
-npm test                           # run unit tests
-node bin/devforge.js test-output   # manual smoke test (guided + developer)
-node bin/devforge.js init          # test init mode (from any project dir)
-node bin/devforge.js doctor        # test doctor mode (from any project dir)
-```
-
-## Project Structure
-
-```
-devforge/
-├── bin/devforge.js              # CLI entry point
-├── src/
-│   ├── cli.js                   # Command router (new, init, doctor)
-│   ├── index.js                 # New project orchestrator (guided + developer)
-│   ├── guided.js                # Guided mode (description → stack)
-│   ├── prompts.js               # Interactive prompts (Inquirer.js)
-│   ├── recommender.js           # Service type → stack recommendation
-│   ├── composer.js              # Template composition engine
-│   ├── claude-configurator.js   # Generates .claude/ infrastructure
-│   ├── uat-generator.js         # Generates UAT templates
-│   ├── scanner.js               # Project scanner (for init + doctor)
-│   ├── init-mode.js             # Init mode orchestrator
-│   ├── doctor.js                # Doctor mode orchestrator
-│   ├── doctor-checks.js         # Diagnostic check functions
-│   ├── doctor-prompts.js        # Fix prompt generators
-│   └── utils.js                 # File ops, logging, colors
-├── templates/                   # Scaffold templates by category
-│   ├── base/                    # Every project gets this
-│   ├── frontend/nextjs/         # Next.js App Router
-│   ├── backend/fastapi/         # FastAPI + SQLAlchemy
-│   ├── database/                # Prisma, SQLAlchemy
-│   ├── auth/                    # NextAuth, JWT
-│   ├── testing/                 # Vitest, Playwright, Pytest
-│   ├── infra/                   # Docker Compose, GitHub Actions
-│   └── claude-code/             # Hooks, CLAUDE.md, skills, agents, commands
-├── tests/                       # Vitest tests
-└── docs/                        # Reference documentation
-```
-
-## Claude Code Commands
-
-| Command | What It Does |
-|---------|-------------|
-| `/project:help` | Asks your situation, gives the exact prompt |
-| `/project:status` | Project dashboard — tests, branch, changes |
-| `/project:next` | Figures out your next task |
-| `/project:done` | Verifies task completion |
-| `/project:generate-prd` | Generates a PRD with Mermaid diagrams |
-| `/project:generate-uat` | Generates UAT scenarios from codebase |
-| `/project:optimize-claude-md` | Proposes splitting an oversized CLAUDE.md |
-
-## Roadmap
-
-- [ ] Go + Gin/Chi backend
-- [ ] Rust + Axum backend
-- [ ] React + Vite SPA (frontend-only)
-- [ ] React Native / Expo mobile
-- [ ] Plugin ecosystem for community templates
-
-## License
-
-MIT
+# DevForge
+
+Universal, AI-first project scaffolding CLI. Describe what you're building, get the right stack recommended, and ship with Claude Code infrastructure pre-configured.
+
+## Quick Start
+
+```bash
+# New project — guided (for beginners)
+npx devforge new my-app
+
+# New project — shorthand
+npx devforge my-app
+
+# Add dev guardrails to existing project
+npx devforge init
+
+# Diagnose and optimize existing project
+npx devforge doctor
+```
+
+## Four Modes, Four Audiences
+
+### 1. Guided Mode (beginners & non-developers)
+
+Describe what you want in plain English. DevForge picks the stack.
+
+```
+$ npx devforge new my-app
+
+  🔨 DevForge — Let's build something.
+
+? How would you like to start?
+  💬 Describe what you want to build (recommended for beginners)
+  ⚡ I know my stack — let me pick (for developers)
+
+> Describe
+
+Tell me about what you want to build:
+> I want an app where restaurants manage their menu and customers order food
+
+  Got it! Here's what I'll set up for you:
+
+  What you'll get:
+  ├── A website where you can:
+  │   • Manage menu
+  │   • Manage orders
+  │
+  ├── User accounts (with different roles like admin and user)
+  ├── Payment processing for orders or subscriptions
+  ├── Search and filtering
+  ├── A database to store all your data
+  │
+  └── Developer tools:
+      • Code quality checks (catches errors automatically)
+      • Guided workflows (type /project:help anytime you're stuck)
+      • Testing templates
+
+? Sound right? Yes — create it!
+```
+
+Zero technical jargon. DevForge makes all the decisions. After scaffolding, generates `docs/getting-started.md` with a beginner-friendly walkthrough.
+
+### 2. Developer Mode (developers who know their stack)
+
+```
+$ npx devforge new my-app
+
+? How would you like to start?
+  ⚡ I know my stack — let me pick
+
+? What are you building? Full-stack app
+? Backend language? Python (polyglot)
+? Need authentication? Yes
+? Deployment target? Docker
+
+  Recommended stack:
+  Frontend: nextjs + typescript + tailwind + shadcn
+  Backend:  fastapi + python + sqlalchemy
+  Database: postgresql (both)
+  Auth:     both
+  Testing:  vitest + playwright + pytest
+  Deploy:   docker
+  Claude:   CLAUDE.md + hooks + skills + agents + commands
+
+? Proceed with this stack? Yes
+
+✓ Done! Your project is ready.
+```
+
+### 3. Init Mode (add guardrails to existing projects)
+
+```
+$ cd my-existing-project
+$ npx devforge init
+
+  🔨 DevForge — Adding dev guardrails
+
+  Scanning...
+
+  Detected: nextjs (typescript) + fastapi (python) + postgresql (prisma) + vitest + playwright + pytest
+
+  Installing:
+  ✓ .claude/hooks/ — auto-lint, quality gate, file protection
+  ✓ .claude/agents/ — code quality, security, spec validator
+  ✓ .claude/commands/ — help, status, next, done, audit, pre-pr
+  ✓ .claude/skills/ — framework-specific knowledge
+  ✓ docs/uat/ — acceptance test templates
+  ⊘ CLAUDE.md — exists (tip: run /project:optimize-claude-md to slim it)
+
+  Done. Type /project:help to get started.
+```
+
+Zero questions. Scans, detects, installs.
+
+### 4. Doctor Mode (diagnose & optimize existing projects)
+
+```
+$ npx devforge doctor
+
+  🔨 DevForge Doctor — Project Health Check
+
+  Scanning...
+
+  📊 Project Vitals:
+  Frontend:  nextjs (typescript)
+  Backend:   fastapi (python)
+  Database:  postgresql (sqlalchemy)
+  Testing:   vitest + playwright + pytest
+
+  Health Issues Found:
+
+  🔴 CRITICAL
+    1. CLAUDE.md is 647 lines (recommended limit: 150)
+       → Instructions are being dropped
+    2. 4 endpoints have no authentication
+       → Security vulnerability
+
+  🟡 WARNING
+    3. No health check endpoint
+    4. No UAT scenarios
+    5. 3 bare except: blocks
+
+  ? What would you like to do?
+    🚑 Fix critical issues (guided, one at a time)
+    📋 Generate a full report (save to docs/doctor-report.md)
+    ⚡ Auto-fix what's safe to auto-fix
+    📖 Just show me what to do (generates prompts for Claude Code)
+```
+
+Doctor diagnoses problems and generates the exact Claude Code prompt to fix each one.
+
+## Supported Stacks (V1)
+
+| Selection | Stack |
+|---|---|
+| Web app / Full-stack + TypeScript | Next.js 15 + Prisma + PostgreSQL + NextAuth + Vitest + Playwright |
+| API service + Python | FastAPI + SQLAlchemy 2.0 + PostgreSQL + Alembic + Pytest |
+| Full-stack + TS + Python | Next.js frontend + FastAPI backend (polyglot monorepo) |
+| AI/ML service | Polyglot full-stack with AI integration flag |
+
+## What Gets Generated
+
+Every project includes:
+
+- **Project scaffold** with working code, configs, and dependencies
+- **Health check endpoints** (`/health`, `/healthz`)
+- **Graceful shutdown handlers**
+- **Database connection retry** with exponential backoff
+- **Structured error responses** (never leaks stack traces)
+
+With Claude Code infrastructure enabled (default):
+
+- **CLAUDE.md** tailored to your stack
+- **Hooks** — auto-lint on edit, quality gate on stop
+- **Skills** — framework-specific knowledge
+- **Agents** — 5-agent verification chain
+- **Commands** — verify-all, audit-spec, audit-wiring, audit-security, pre-pr, run-uat, generate-prd, generate-uat, optimize-claude-md
+- **UAT templates** — scenario packs and CSV checklists
+- **Prompt library** — the complete development prompt library
+
+## Development
+
+```bash
+npm install
+npm test                           # run unit tests
+node bin/devforge.js test-output   # manual smoke test (guided + developer)
+node bin/devforge.js init          # test init mode (from any project dir)
+node bin/devforge.js doctor        # test doctor mode (from any project dir)
+```
+
+## Project Structure
+
+```
+devforge/
+├── bin/devforge.js              # CLI entry point
+├── src/
+│   ├── cli.js                   # Command router (new, init, doctor)
+│   ├── index.js                 # New project orchestrator (guided + developer)
+│   ├── guided.js                # Guided mode (description → stack)
+│   ├── prompts.js               # Interactive prompts (Inquirer.js)
+│   ├── recommender.js           # Service type → stack recommendation
+│   ├── composer.js              # Template composition engine
+│   ├── claude-configurator.js   # Generates .claude/ infrastructure
+│   ├── uat-generator.js         # Generates UAT templates
+│   ├── scanner.js               # Project scanner (for init + doctor)
+│   ├── init-mode.js             # Init mode orchestrator
+│   ├── doctor.js                # Doctor mode orchestrator
+│   ├── doctor-checks.js         # Diagnostic check functions
+│   ├── doctor-prompts.js        # Fix prompt generators
+│   └── utils.js                 # File ops, logging, colors
+├── templates/                   # Scaffold templates by category
+│   ├── base/                    # Every project gets this
+│   ├── frontend/nextjs/         # Next.js App Router
+│   ├── backend/fastapi/         # FastAPI + SQLAlchemy
+│   ├── database/                # Prisma, SQLAlchemy
+│   ├── auth/                    # NextAuth, JWT
+│   ├── testing/                 # Vitest, Playwright, Pytest
+│   ├── infra/                   # Docker Compose, GitHub Actions
+│   └── claude-code/             # Hooks, CLAUDE.md, skills, agents, commands
+├── tests/                       # Vitest tests
+└── docs/                        # Reference documentation
+```
+
+## Claude Code Commands
+
+| Command | What It Does |
+|---------|-------------|
+| `/project:help` | Asks your situation, gives the exact prompt |
+| `/project:status` | Project dashboard — tests, branch, changes |
+| `/project:next` | Figures out your next task |
+| `/project:done` | Verifies task completion |
+| `/project:generate-prd` | Generates a PRD with Mermaid diagrams |
+| `/project:generate-uat` | Generates UAT scenarios from codebase |
+| `/project:optimize-claude-md` | Proposes splitting an oversized CLAUDE.md |
+
+## Roadmap
+
+- [ ] Go + Gin/Chi backend
+- [ ] Rust + Axum backend
+- [ ] React + Vite SPA (frontend-only)
+- [ ] React Native / Expo mobile
+- [ ] Plugin ecosystem for community templates
+
+## License
+
+MIT

package/bin/devforge.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
-import { parseCommand } from '../src/cli.js';
-
-parseCommand(process.argv.slice(2));
+#!/usr/bin/env node
+import { parseCommand } from '../src/cli.js';
+
+parseCommand(process.argv.slice(2));

package/package.json

@@ -1,33 +1,33 @@
-{
-  "name": "forgedev",
-  "version": "1.0.0",
-  "description": "Universal, AI-first project scaffolding CLI with Claude Code infrastructure",
-  "type": "module",
-  "bin": {
-    "forgedev": "bin/devforge.js",
-    "devforge": "bin/devforge.js"
-  },
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "keywords": [
-    "scaffolding",
-    "cli",
-    "project-generator",
-    "claude-code",
-    "ai-first"
-  ],
-  "author": "",
-  "license": "MIT",
-  "dependencies": {
-    "chalk": "^5.4.1",
-    "@inquirer/prompts": "^7.10.0"
-  },
-  "devDependencies": {
-    "vitest": "^3.1.1"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "forgedev",
+  "version": "1.0.1",
+  "description": "Universal, AI-first project scaffolding CLI with Claude Code infrastructure",
+  "type": "module",
+  "bin": {
+    "forgedev": "bin/devforge.js",
+    "devforge": "bin/devforge.js"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "scaffolding",
+    "cli",
+    "project-generator",
+    "claude-code",
+    "ai-first"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "@inquirer/prompts": "^7.10.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.1.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}