@mandujs/cli 0.12.1 → 0.13.0

package/README.md

@@ -1,354 +1,354 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/konamgil/mandu/main/mandu_only_simbol.png" alt="Mandu" width="200" />
-</p>
-
-<h1 align="center">@mandujs/cli</h1>
-
-<p align="center">
-  <strong>Agent-Native Fullstack Framework CLI</strong><br/>
-  Architecture stays intact even when AI agents write your code
-</p>
-
-<p align="center">
-  English | <a href="./README.ko.md"><strong>한국어</strong></a>
-</p>
-
-## Installation
-
-```bash
-bun add -D @mandujs/cli
-```
-
-Or use directly with `bunx`:
-
-```bash
-bunx @mandujs/cli init my-app
-```
-
-## Quick Start
-
-### 1. Create a New Project
-
-```bash
-bunx @mandujs/cli init my-app
-cd my-app
-bun install
-```
-
-### 2. Start Development Server
-
-```bash
-bun run dev
-# or
-bunx mandu dev
-```
-
-Your app is now running at `http://localhost:3333`.
-
-To change the port, set `PORT` or use `server.port` in `mandu.config`. If the port is in use, Mandu will pick the next available port.
-
-### 3. Create Pages in `app/` Directory
-
-```
-app/
-├── page.tsx              → /
-├── about/page.tsx        → /about
-├── users/[id]/page.tsx   → /users/:id
-└── api/hello/route.ts    → /api/hello
-```
-
-### 4. Build for Production
-
-```bash
-bunx mandu build
-```
-
-### Default Architecture Layout
-
-```
-app/                     # FS Routes
-src/
-  client/                # Client (FSD)
-    app/
-    pages/
-    widgets/
-    features/
-    entities/
-    shared/
-  server/                # Server (Clean)
-    api/
-    application/
-    domain/
-    infra/
-    core/
-  shared/                # Universal shared
-    contracts/           # Client-safe contracts
-    types/
-    utils/
-      client/            # Client-safe utils
-      server/            # Server-only utils
-    schema/              # Server-only schema
-    env/                 # Server-only env
-```
-
-That's it!
-
----
-
-## Commands
-
-### Core Commands
-
-| Command | Description |
-|---------|-------------|
-| `mandu init [name]` | Create new project |
-| `mandu dev` | Start dev server (FS Routes + HMR) |
-| `mandu build` | Build for production |
-
-### FS Routes Commands
-
-| Command | Description |
-|---------|-------------|
-| `mandu routes list` | Show all routes |
-| `mandu routes generate` | Generate routes manifest |
-| `mandu routes watch` | Watch for route changes |
-
-### Guard Commands
-
-| Command | Description |
-|---------|-------------|
-| `mandu guard` | Run architecture check (default: mandu preset) |
-| `mandu guard --watch` | Watch mode |
-| `mandu guard --ci` | CI mode (exit 1 on errors/warnings) |
-| `mandu guard --preset fsd` | Use specific preset |
-| `mandu guard --output report.md` | Generate report |
-| `mandu guard legacy` | Legacy Spec guard (auto-correct) |
-
-### Transaction Commands
-
-| Command | Description |
-|---------|-------------|
-| `mandu change begin` | Start transaction (creates snapshot) |
-| `mandu change commit` | Finalize changes |
-| `mandu change rollback` | Restore from snapshot |
-| `mandu change status` | Show current state |
-| `mandu change list` | View history |
-
-### Brain Commands
-
-| Command | Description |
-|---------|-------------|
-| `mandu doctor` | Analyze Guard failures + suggest patches |
-| `mandu watch` | Real-time file monitoring |
-| `mandu monitor` | MCP Activity Monitor log stream |
-| `mandu brain setup` | Configure sLLM (optional) |
-| `mandu brain status` | Check Brain status |
-
-### Contract & OpenAPI Commands
-
-| Command | Description |
-|---------|-------------|
-| `mandu contract create <routeId>` | Create contract for route |
-| `mandu contract validate` | Validate contract-slot consistency |
-| `mandu contract build` | Build contract registry |
-| `mandu contract diff` | Diff contracts against registry |
-| `mandu openapi generate` | Generate OpenAPI 3.0 spec |
-| `mandu openapi serve` | Start Swagger UI server |
-
----
-
-## Workflow
-
-### Modern Workflow (Recommended)
-
-```bash
-# 1. Create project
-bunx @mandujs/cli init my-app
-cd my-app && bun install
-
-# 2. Create pages
-# app/page.tsx        → /
-# app/users/page.tsx  → /users
-# app/api/users/route.ts → /api/users
-
-# 3. Start development
-bun run dev
-```
-
-### With Architecture Guard
-
-```bash
-# Development with Guard watching
-bunx mandu dev --guard
-
-# Or run Guard separately
-bunx mandu guard --watch
-```
-
-### CI/CD Integration
-
-```bash
-# Build and check
-bunx mandu build --minify
-bunx mandu guard --ci --format json
-```
-
----
-
-## FS Routes
-
-Create routes by adding files to `app/`:
-
-```
-app/
-├── page.tsx              → /
-├── layout.tsx            → Layout for all pages
-├── users/
-│   ├── page.tsx          → /users
-│   ├── [id]/
-│   │   └── page.tsx      → /users/:id
-│   └── [...slug]/
-│       └── page.tsx      → /users/*
-├── api/
-│   └── users/
-│       └── route.ts      → /api/users
-└── (auth)/               → Group (no URL segment)
-    └── login/page.tsx    → /login
-```
-
-### Special Files
-
-| File | Purpose |
-|------|---------|
-| `page.tsx` | Page component |
-| `layout.tsx` | Shared layout |
-| `route.ts` | API endpoint |
-| `loading.tsx` | Loading state |
-| `error.tsx` | Error boundary |
-| `slot.ts` | Business logic |
-| `client.tsx` | Interactive component (Island) |
-
----
-
-## Guard Presets
-
-| Preset | Description |
-|--------|-------------|
-| `mandu` | FSD + Clean Architecture (default) |
-| `fsd` | Feature-Sliced Design |
-| `clean` | Clean Architecture |
-| `hexagonal` | Hexagonal Architecture |
-| `atomic` | Atomic Design |
-
-```bash
-# List all presets
-bunx mandu guard --list-presets
-
-# Use specific preset
-bunx mandu guard --preset fsd
-```
-
----
-
-## Options Reference
-
-### `mandu dev`
-
-| Option | Description |
-|--------|-------------|
-| `--guard` | Enable Guard watching |
-| `--guard-preset <p>` | Guard preset (default: mandu) |
-
-### `mandu build`
-
-| Option | Description |
-|--------|-------------|
-| `--minify` | Minify output |
-| `--sourcemap` | Generate sourcemaps |
-| `--watch` | Watch mode |
-
-### `mandu guard`
-
-| Option | Description |
-|--------|-------------|
-| `--preset <p>` | Preset: fsd, clean, hexagonal, atomic, mandu |
-| `--watch` | Watch mode |
-| `--ci` | CI mode (exit 1 on errors/warnings) |
-| `--quiet` | Summary only |
-| `--format <f>` | Output: console, agent, json |
-| `--output <path>` | Report file path |
-| `--report-format <f>` | Report: json, markdown, html |
-| `--save-stats` | Save for trend analysis |
-| `--show-trend` | Show trend analysis |
-
-### `mandu doctor`
-
-| Option | Description |
-|--------|-------------|
-| `--format <f>` | Output: console, json, markdown |
-| `--no-llm` | Template mode (no LLM) |
-| `--output <path>` | Output file path |
-
-### `mandu monitor`
-
-| Option | Description |
-|--------|-------------|
-| `--format <f>` | Output: console, agent, json |
-| `--summary` | Print summary (JSON log only) |
-| `--since <d>` | Summary window: 5m, 30s, 1h |
-| `--follow <bool>` | Follow mode (default: true) |
-| `--file <path>` | Use custom log file |
-
----
-
-## Examples
-
-```bash
-# Initialize project
-bunx @mandujs/cli init my-app
-
-# Development
-bunx mandu dev --guard
-
-# Routes
-bunx mandu routes list
-bunx mandu routes generate
-
-# Guard
-bunx mandu guard
-bunx mandu guard --watch
-bunx mandu guard --ci --format json
-bunx mandu guard --output report.md
-bunx mandu guard legacy
-
-# Transactions
-bunx mandu change begin --message "Add users API"
-bunx mandu change commit
-bunx mandu change rollback
-
-# Doctor
-bunx mandu doctor
-bunx mandu doctor --format json
-
-# Monitor
-bunx mandu monitor
-bunx mandu monitor --summary --since 5m
-
-# Build
-bunx mandu build --minify --sourcemap
-```
-
----
-
-## Requirements
-
-- Bun >= 1.0.0
-
-## Related Packages
-
-- [@mandujs/core](https://www.npmjs.com/package/@mandujs/core) - Core runtime
-- [@mandujs/mcp](https://www.npmjs.com/package/@mandujs/mcp) - MCP server
-
-## License
-
-MIT
+<p align="center">
+  <img src="https://raw.githubusercontent.com/konamgil/mandu/main/mandu_only_simbol.png" alt="Mandu" width="200" />
+</p>
+
+<h1 align="center">@mandujs/cli</h1>
+
+<p align="center">
+  <strong>Agent-Native Fullstack Framework CLI</strong><br/>
+  Architecture stays intact even when AI agents write your code
+</p>
+
+<p align="center">
+  English | <a href="./README.ko.md"><strong>한국어</strong></a>
+</p>
+
+## Installation
+
+```bash
+bun add -D @mandujs/cli
+```
+
+Or use directly with `bunx`:
+
+```bash
+bunx @mandujs/cli init my-app
+```
+
+## Quick Start
+
+### 1. Create a New Project
+
+```bash
+bunx @mandujs/cli init my-app
+cd my-app
+bun install
+```
+
+### 2. Start Development Server
+
+```bash
+bun run dev
+# or
+bunx mandu dev
+```
+
+Your app is now running at `http://localhost:3333`.
+
+To change the port, set `PORT` or use `server.port` in `mandu.config`. If the port is in use, Mandu will pick the next available port.
+
+### 3. Create Pages in `app/` Directory
+
+```
+app/
+├── page.tsx              → /
+├── about/page.tsx        → /about
+├── users/[id]/page.tsx   → /users/:id
+└── api/hello/route.ts    → /api/hello
+```
+
+### 4. Build for Production
+
+```bash
+bunx mandu build
+```
+
+### Default Architecture Layout
+
+```
+app/                     # FS Routes
+src/
+  client/                # Client (FSD)
+    app/
+    pages/
+    widgets/
+    features/
+    entities/
+    shared/
+  server/                # Server (Clean)
+    api/
+    application/
+    domain/
+    infra/
+    core/
+  shared/                # Universal shared
+    contracts/           # Client-safe contracts
+    types/
+    utils/
+      client/            # Client-safe utils
+      server/            # Server-only utils
+    schema/              # Server-only schema
+    env/                 # Server-only env
+```
+
+That's it!
+
+---
+
+## Commands
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `mandu init [name]` | Create new project |
+| `mandu dev` | Start dev server (FS Routes + HMR) |
+| `mandu build` | Build for production |
+
+### FS Routes Commands
+
+| Command | Description |
+|---------|-------------|
+| `mandu routes list` | Show all routes |
+| `mandu routes generate` | Generate routes manifest |
+| `mandu routes watch` | Watch for route changes |
+
+### Guard Commands
+
+| Command | Description |
+|---------|-------------|
+| `mandu guard` | Run architecture check (default: mandu preset) |
+| `mandu guard --watch` | Watch mode |
+| `mandu guard --ci` | CI mode (exit 1 on errors/warnings) |
+| `mandu guard --preset fsd` | Use specific preset |
+| `mandu guard --output report.md` | Generate report |
+| `mandu guard legacy` | Legacy Spec guard (auto-correct) |
+
+### Transaction Commands
+
+| Command | Description |
+|---------|-------------|
+| `mandu change begin` | Start transaction (creates snapshot) |
+| `mandu change commit` | Finalize changes |
+| `mandu change rollback` | Restore from snapshot |
+| `mandu change status` | Show current state |
+| `mandu change list` | View history |
+
+### Brain Commands
+
+| Command | Description |
+|---------|-------------|
+| `mandu doctor` | Analyze Guard failures + suggest patches |
+| `mandu watch` | Real-time file monitoring |
+| `mandu monitor` | MCP Activity Monitor log stream |
+| `mandu brain setup` | Configure sLLM (optional) |
+| `mandu brain status` | Check Brain status |
+
+### Contract & OpenAPI Commands
+
+| Command | Description |
+|---------|-------------|
+| `mandu contract create <routeId>` | Create contract for route |
+| `mandu contract validate` | Validate contract-slot consistency |
+| `mandu contract build` | Build contract registry |
+| `mandu contract diff` | Diff contracts against registry |
+| `mandu openapi generate` | Generate OpenAPI 3.0 spec |
+| `mandu openapi serve` | Start Swagger UI server |
+
+---
+
+## Workflow
+
+### Modern Workflow (Recommended)
+
+```bash
+# 1. Create project
+bunx @mandujs/cli init my-app
+cd my-app && bun install
+
+# 2. Create pages
+# app/page.tsx        → /
+# app/users/page.tsx  → /users
+# app/api/users/route.ts → /api/users
+
+# 3. Start development
+bun run dev
+```
+
+### With Architecture Guard
+
+```bash
+# Development with Guard watching
+bunx mandu dev --guard
+
+# Or run Guard separately
+bunx mandu guard --watch
+```
+
+### CI/CD Integration
+
+```bash
+# Build and check
+bunx mandu build --minify
+bunx mandu guard --ci --format json
+```
+
+---
+
+## FS Routes
+
+Create routes by adding files to `app/`:
+
+```
+app/
+├── page.tsx              → /
+├── layout.tsx            → Layout for all pages
+├── users/
+│   ├── page.tsx          → /users
+│   ├── [id]/
+│   │   └── page.tsx      → /users/:id
+│   └── [...slug]/
+│       └── page.tsx      → /users/*
+├── api/
+│   └── users/
+│       └── route.ts      → /api/users
+└── (auth)/               → Group (no URL segment)
+    └── login/page.tsx    → /login
+```
+
+### Special Files
+
+| File | Purpose |
+|------|---------|
+| `page.tsx` | Page component |
+| `layout.tsx` | Shared layout |
+| `route.ts` | API endpoint |
+| `loading.tsx` | Loading state |
+| `error.tsx` | Error boundary |
+| `slot.ts` | Business logic |
+| `client.tsx` | Interactive component (Island) |
+
+---
+
+## Guard Presets
+
+| Preset | Description |
+|--------|-------------|
+| `mandu` | FSD + Clean Architecture (default) |
+| `fsd` | Feature-Sliced Design |
+| `clean` | Clean Architecture |
+| `hexagonal` | Hexagonal Architecture |
+| `atomic` | Atomic Design |
+
+```bash
+# List all presets
+bunx mandu guard --list-presets
+
+# Use specific preset
+bunx mandu guard --preset fsd
+```
+
+---
+
+## Options Reference
+
+### `mandu dev`
+
+| Option | Description |
+|--------|-------------|
+| `--guard` | Enable Guard watching |
+| `--guard-preset <p>` | Guard preset (default: mandu) |
+
+### `mandu build`
+
+| Option | Description |
+|--------|-------------|
+| `--minify` | Minify output |
+| `--sourcemap` | Generate sourcemaps |
+| `--watch` | Watch mode |
+
+### `mandu guard`
+
+| Option | Description |
+|--------|-------------|
+| `--preset <p>` | Preset: fsd, clean, hexagonal, atomic, mandu |
+| `--watch` | Watch mode |
+| `--ci` | CI mode (exit 1 on errors/warnings) |
+| `--quiet` | Summary only |
+| `--format <f>` | Output: console, agent, json |
+| `--output <path>` | Report file path |
+| `--report-format <f>` | Report: json, markdown, html |
+| `--save-stats` | Save for trend analysis |
+| `--show-trend` | Show trend analysis |
+
+### `mandu doctor`
+
+| Option | Description |
+|--------|-------------|
+| `--format <f>` | Output: console, json, markdown |
+| `--no-llm` | Template mode (no LLM) |
+| `--output <path>` | Output file path |
+
+### `mandu monitor`
+
+| Option | Description |
+|--------|-------------|
+| `--format <f>` | Output: console, agent, json |
+| `--summary` | Print summary (JSON log only) |
+| `--since <d>` | Summary window: 5m, 30s, 1h |
+| `--follow <bool>` | Follow mode (default: true) |
+| `--file <path>` | Use custom log file |
+
+---
+
+## Examples
+
+```bash
+# Initialize project
+bunx @mandujs/cli init my-app
+
+# Development
+bunx mandu dev --guard
+
+# Routes
+bunx mandu routes list
+bunx mandu routes generate
+
+# Guard
+bunx mandu guard
+bunx mandu guard --watch
+bunx mandu guard --ci --format json
+bunx mandu guard --output report.md
+bunx mandu guard legacy
+
+# Transactions
+bunx mandu change begin --message "Add users API"
+bunx mandu change commit
+bunx mandu change rollback
+
+# Doctor
+bunx mandu doctor
+bunx mandu doctor --format json
+
+# Monitor
+bunx mandu monitor
+bunx mandu monitor --summary --since 5m
+
+# Build
+bunx mandu build --minify --sourcemap
+```
+
+---
+
+## Requirements
+
+- Bun >= 1.0.0
+
+## Related Packages
+
+- [@mandujs/core](https://www.npmjs.com/package/@mandujs/core) - Core runtime
+- [@mandujs/mcp](https://www.npmjs.com/package/@mandujs/mcp) - MCP server
+
+## License
+
+MIT