@mandujs/cli 0.2.0 → 0.2.2

package/README.ko.md

@@ -0,0 +1,172 @@
+# @mandujs/cli
+
+> **[English](./README.md)** | 한국어
+
+Agent-Native Fullstack Framework CLI - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS
+
+## 설치
+
+```bash
+# Bun 필수
+bun add -D @mandujs/cli
+```
+
+## 빠른 시작
+
+```bash
+# 새 프로젝트 생성
+bunx @mandujs/cli init my-app
+cd my-app
+
+# 개발 서버 시작
+bun run dev
+```
+
+## 명령어
+
+### `mandu init <project-name>`
+
+새 Mandu 프로젝트를 생성합니다.
+
+```bash
+bunx @mandujs/cli init my-app
+```
+
+생성되는 구조:
+```
+my-app/
+├── apps/
+│   ├── server/main.ts    # 서버 진입점
+│   └── web/entry.tsx     # 클라이언트 진입점
+├── spec/
+│   └── routes.manifest.json  # SSOT - 라우트 정의
+├── tests/                # 테스트 템플릿
+├── package.json
+└── tsconfig.json
+```
+
+### `mandu dev`
+
+개발 서버를 시작합니다 (HMR 지원).
+
+```bash
+bun run dev
+# 또는
+bunx mandu dev
+```
+
+### `mandu spec`
+
+spec 파일을 검증하고 lock 파일을 갱신합니다.
+
+```bash
+bun run spec
+```
+
+### `mandu generate`
+
+spec 기반으로 코드를 생성합니다.
+
+```bash
+bun run generate
+```
+
+### `mandu guard`
+
+아키텍처 규칙을 검사하고 위반 사항을 자동 수정합니다.
+
+```bash
+bun run guard
+
+# 자동 수정 비활성화
+bunx mandu guard --no-auto-correct
+```
+
+자동 수정 가능한 규칙:
+- `SPEC_HASH_MISMATCH` → lock 파일 갱신
+- `GENERATED_MANUAL_EDIT` → 코드 재생성
+- `SLOT_NOT_FOUND` → slot 파일 생성
+
+## Spec 파일 작성
+
+`spec/routes.manifest.json`이 모든 라우트의 단일 진실 공급원(SSOT)입니다.
+
+```json
+{
+  "version": "1.0.0",
+  "routes": [
+    {
+      "id": "getUsers",
+      "pattern": "/api/users",
+      "kind": "api",
+      "module": "apps/server/api/users.ts"
+    },
+    {
+      "id": "homePage",
+      "pattern": "/",
+      "kind": "page",
+      "module": "apps/server/pages/home.ts",
+      "componentModule": "apps/web/pages/Home.tsx"
+    }
+  ]
+}
+```
+
+### Slot 시스템 (v0.2.0+)
+
+비즈니스 로직을 분리하려면 `slotModule`을 추가합니다:
+
+```json
+{
+  "id": "getUsers",
+  "pattern": "/api/users",
+  "kind": "api",
+  "module": "apps/server/api/users.generated.ts",
+  "slotModule": "apps/server/api/users.slot.ts"
+}
+```
+
+- `*.generated.ts` - 프레임워크가 관리 (수정 금지)
+- `*.slot.ts` - 개발자가 작성하는 비즈니스 로직
+
+## 개발 워크플로우
+
+```bash
+# 1. spec 수정
+# 2. spec 검증 및 lock 갱신
+bun run spec
+
+# 3. 코드 생성
+bun run generate
+
+# 4. 아키텍처 검사
+bun run guard
+
+# 5. 테스트
+bun test
+
+# 6. 개발 서버
+bun run dev
+```
+
+## 테스트
+
+Bun 테스트 프레임워크를 기본 지원합니다.
+
+```bash
+bun test           # 테스트 실행
+bun test --watch   # 감시 모드
+```
+
+## 요구 사항
+
+- Bun >= 1.0.0
+- React >= 18.0.0
+
+## 관련 패키지
+
+- [@mandujs/core](https://www.npmjs.com/package/@mandujs/core) - 핵심 런타임
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,172 @@
+# @mandujs/cli
+
+> English | **[한국어](./README.ko.md)**
+
+Agent-Native Fullstack Framework CLI - A development OS where architecture stays intact even when AI agents write your code
+
+## Installation
+
+```bash
+# Bun required
+bun add -D @mandujs/cli
+```
+
+## Quick Start
+
+```bash
+# Create a new project
+bunx @mandujs/cli init my-app
+cd my-app
+
+# Start development server
+bun run dev
+```
+
+## Commands
+
+### `mandu init <project-name>`
+
+Creates a new Mandu project.
+
+```bash
+bunx @mandujs/cli init my-app
+```
+
+Generated structure:
+```
+my-app/
+├── apps/
+│   ├── server/main.ts    # Server entry point
+│   └── web/entry.tsx     # Client entry point
+├── spec/
+│   └── routes.manifest.json  # SSOT - Route definitions
+├── tests/                # Test templates
+├── package.json
+└── tsconfig.json
+```
+
+### `mandu dev`
+
+Starts the development server (with HMR support).
+
+```bash
+bun run dev
+# or
+bunx mandu dev
+```
+
+### `mandu spec`
+
+Validates the spec file and updates the lock file.
+
+```bash
+bun run spec
+```
+
+### `mandu generate`
+
+Generates code based on the spec.
+
+```bash
+bun run generate
+```
+
+### `mandu guard`
+
+Checks architecture rules and auto-corrects violations.
+
+```bash
+bun run guard
+
+# Disable auto-correction
+bunx mandu guard --no-auto-correct
+```
+
+Auto-correctable rules:
+- `SPEC_HASH_MISMATCH` → Updates lock file
+- `GENERATED_MANUAL_EDIT` → Regenerates code
+- `SLOT_NOT_FOUND` → Creates slot file
+
+## Writing Spec Files
+
+`spec/routes.manifest.json` is the Single Source of Truth (SSOT) for all routes.
+
+```json
+{
+  "version": "1.0.0",
+  "routes": [
+    {
+      "id": "getUsers",
+      "pattern": "/api/users",
+      "kind": "api",
+      "module": "apps/server/api/users.ts"
+    },
+    {
+      "id": "homePage",
+      "pattern": "/",
+      "kind": "page",
+      "module": "apps/server/pages/home.ts",
+      "componentModule": "apps/web/pages/Home.tsx"
+    }
+  ]
+}
+```
+
+### Slot System (v0.2.0+)
+
+Add `slotModule` to separate business logic:
+
+```json
+{
+  "id": "getUsers",
+  "pattern": "/api/users",
+  "kind": "api",
+  "module": "apps/server/api/users.generated.ts",
+  "slotModule": "apps/server/api/users.slot.ts"
+}
+```
+
+- `*.generated.ts` - Managed by framework (do not modify)
+- `*.slot.ts` - Business logic written by developers
+
+## Development Workflow
+
+```bash
+# 1. Edit spec
+# 2. Validate spec and update lock
+bun run spec
+
+# 3. Generate code
+bun run generate
+
+# 4. Check architecture
+bun run guard
+
+# 5. Run tests
+bun test
+
+# 6. Start dev server
+bun run dev
+```
+
+## Testing
+
+Built-in support for Bun test framework.
+
+```bash
+bun test           # Run tests
+bun test --watch   # Watch mode
+```
+
+## Requirements
+
+- Bun >= 1.0.0
+- React >= 18.0.0
+
+## Related Packages
+
+- [@mandujs/core](https://www.npmjs.com/package/@mandujs/core) - Core runtime
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
   "type": "module",
   "main": "./src/main.ts",