@mandujs/cli 0.8.1 → 0.8.3

package/README.md

@@ -1,181 +1,181 @@
-<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/>
-  A development OS where 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 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
+<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/>
+  A development OS where 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 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,40 +1,40 @@
-{
-  "name": "@mandujs/cli",
-  "version": "0.8.1",
-  "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
-  "type": "module",
-  "main": "./src/main.ts",
-  "bin": {
-    "mandu": "src/main.ts"
-  },
-  "files": [
-    "src/**/*",
-    "templates/**/*"
-  ],
-  "keywords": [
-    "ai",
-    "agent",
-    "framework",
-    "fullstack",
-    "bun",
-    "typescript",
-    "react",
-    "ssr",
-    "code-generation"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/konamgil/mandu.git"
-  },
-  "author": "konamgil",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@mandujs/core": "^0.8.1"
-  },
-  "engines": {
-    "bun": ">=1.0.0"
-  }
-}
+{
+  "name": "@mandujs/cli",
+  "version": "0.8.3",
+  "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
+  "type": "module",
+  "main": "./src/main.ts",
+  "bin": {
+    "mandu": "src/main.ts"
+  },
+  "files": [
+    "src/**/*",
+    "templates/**/*"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "framework",
+    "fullstack",
+    "bun",
+    "typescript",
+    "react",
+    "ssr",
+    "code-generation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/konamgil/mandu.git"
+  },
+  "author": "konamgil",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mandujs/core": "0.8.2"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  }
+}

package/src/commands/init.ts

@@ -1,88 +1,88 @@
-import path from "path";
-import fs from "fs/promises";
-
-export interface InitOptions {
-  name?: string;
-  template?: string;
-}
-
-async function copyDir(src: string, dest: string, projectName: string): Promise<void> {
-  await fs.mkdir(dest, { recursive: true });
-  const entries = await fs.readdir(src, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      await copyDir(srcPath, destPath, projectName);
-    } else {
-      let content = await fs.readFile(srcPath, "utf-8");
-      // Replace template variables
-      content = content.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
-      await fs.writeFile(destPath, content);
-    }
-  }
-}
-
-function getTemplatesDir(): string {
-  // When installed via npm, templates are in the CLI package
-  const commandsDir = import.meta.dir;
-  // packages/cli/src/commands -> go up 2 levels to cli package root
-  return path.resolve(commandsDir, "../../templates");
-}
-
-export async function init(options: InitOptions = {}): Promise<boolean> {
-  const projectName = options.name || "my-mandu-app";
-  const template = options.template || "default";
-  const targetDir = path.resolve(process.cwd(), projectName);
-
-  console.log(`🥟 Mandu Init`);
-  console.log(`📁 프로젝트: ${projectName}`);
-  console.log(`📦 템플릿: ${template}\n`);
-
-  // Check if target directory exists
-  try {
-    await fs.access(targetDir);
-    console.error(`❌ 디렉토리가 이미 존재합니다: ${targetDir}`);
-    return false;
-  } catch {
-    // Directory doesn't exist, good to proceed
-  }
-
-  const templatesDir = getTemplatesDir();
-  const templateDir = path.join(templatesDir, template);
-
-  // Check if template exists
-  try {
-    await fs.access(templateDir);
-  } catch {
-    console.error(`❌ 템플릿을 찾을 수 없습니다: ${template}`);
-    console.error(`   사용 가능한 템플릿: default`);
-    return false;
-  }
-
-  console.log(`📋 템플릿 복사 중...`);
-
-  try {
-    await copyDir(templateDir, targetDir, projectName);
-  } catch (error) {
-    console.error(`❌ 템플릿 복사 실패:`, error);
-    return false;
-  }
-
-  // Create empty generated directories
-  await fs.mkdir(path.join(targetDir, "apps/server/generated/routes"), { recursive: true });
-  await fs.mkdir(path.join(targetDir, "apps/web/generated/routes"), { recursive: true });
-
-  console.log(`\n✅ 프로젝트 생성 완료!\n`);
-  console.log(`📍 위치: ${targetDir}`);
-  console.log(`\n🚀 시작하기:`);
-  console.log(`   cd ${projectName}`);
-  console.log(`   bun install`);
-  console.log(`   bun run spec`);
-  console.log(`   bun run generate`);
-  console.log(`   bun run dev`);
-
-  return true;
-}
+import path from "path";
+import fs from "fs/promises";
+
+export interface InitOptions {
+  name?: string;
+  template?: string;
+}
+
+async function copyDir(src: string, dest: string, projectName: string): Promise<void> {
+  await fs.mkdir(dest, { recursive: true });
+  const entries = await fs.readdir(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath, projectName);
+    } else {
+      let content = await fs.readFile(srcPath, "utf-8");
+      // Replace template variables
+      content = content.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
+      await fs.writeFile(destPath, content);
+    }
+  }
+}
+
+function getTemplatesDir(): string {
+  // When installed via npm, templates are in the CLI package
+  const commandsDir = import.meta.dir;
+  // packages/cli/src/commands -> go up 2 levels to cli package root
+  return path.resolve(commandsDir, "../../templates");
+}
+
+export async function init(options: InitOptions = {}): Promise<boolean> {
+  const projectName = options.name || "my-mandu-app";
+  const template = options.template || "default";
+  const targetDir = path.resolve(process.cwd(), projectName);
+
+  console.log(`🥟 Mandu Init`);
+  console.log(`📁 프로젝트: ${projectName}`);
+  console.log(`📦 템플릿: ${template}\n`);
+
+  // Check if target directory exists
+  try {
+    await fs.access(targetDir);
+    console.error(`❌ 디렉토리가 이미 존재합니다: ${targetDir}`);
+    return false;
+  } catch {
+    // Directory doesn't exist, good to proceed
+  }
+
+  const templatesDir = getTemplatesDir();
+  const templateDir = path.join(templatesDir, template);
+
+  // Check if template exists
+  try {
+    await fs.access(templateDir);
+  } catch {
+    console.error(`❌ 템플릿을 찾을 수 없습니다: ${template}`);
+    console.error(`   사용 가능한 템플릿: default`);
+    return false;
+  }
+
+  console.log(`📋 템플릿 복사 중...`);
+
+  try {
+    await copyDir(templateDir, targetDir, projectName);
+  } catch (error) {
+    console.error(`❌ 템플릿 복사 실패:`, error);
+    return false;
+  }
+
+  // Create empty generated directories
+  await fs.mkdir(path.join(targetDir, "apps/server/generated/routes"), { recursive: true });
+  await fs.mkdir(path.join(targetDir, "apps/web/generated/routes"), { recursive: true });
+
+  console.log(`\n✅ 프로젝트 생성 완료!\n`);
+  console.log(`📍 위치: ${targetDir}`);
+  console.log(`\n🚀 시작하기:`);
+  console.log(`   cd ${projectName}`);
+  console.log(`   bun install`);
+  console.log(`   bun run spec`);
+  console.log(`   bun run generate`);
+  console.log(`   bun run dev`);
+
+  return true;
+}

package/src/util/fs.ts

@@ -1,9 +1,9 @@
-import path from "path";
-
-export function resolveFromCwd(...paths: string[]): string {
-  return path.resolve(process.cwd(), ...paths);
-}
-
-export function getRootDir(): string {
-  return process.cwd();
-}
+import path from "path";
+
+export function resolveFromCwd(...paths: string[]): string {
+  return path.resolve(process.cwd(), ...paths);
+}
+
+export function getRootDir(): string {
+  return process.cwd();
+}