@mandujs/cli 0.3.2 → 0.3.4

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/main.ts

@@ -5,6 +5,14 @@ import { generateApply } from "./commands/generate-apply";
 import { guardCheck } from "./commands/guard-check";
 import { dev } from "./commands/dev";
 import { init } from "./commands/init";
+import {
+  changeBegin,
+  changeCommit,
+  changeRollback,
+  changeStatus,
+  changeList,
+  changePrune,
+} from "./commands/change";
 
 const HELP_TEXT = `
 🥟 Mandu CLI - Agent-Native Fullstack Framework
@@ -18,11 +26,21 @@ Commands:
   guard          Guard 규칙 검사
   dev            개발 서버 실행
 
+  change begin   변경 트랜잭션 시작 (스냅샷 생성)
+  change commit  변경 확정
+  change rollback 스냅샷으로 복원
+  change status  현재 트랜잭션 상태
+  change list    변경 이력 조회
+  change prune   오래된 스냅샷 정리
+
 Options:
   --name <name>      init 시 프로젝트 이름 (기본: my-mandu-app)
   --file <path>      spec-upsert 시 사용할 spec 파일 경로
   --port <port>      dev 서버 포트 (기본: 3000)
   --no-auto-correct  guard 시 자동 수정 비활성화
+  --message <msg>    change begin 시 설명 메시지
+  --id <id>          change rollback 시 특정 변경 ID
+  --keep <n>         change prune 시 유지할 스냅샷 수 (기본: 5)
   --help, -h         도움말 표시
 
 Examples:
@@ -31,6 +49,9 @@ Examples:
   bunx mandu generate
   bunx mandu guard
   bunx mandu dev --port 3000
+  bunx mandu change begin --message "Add new route"
+  bunx mandu change commit
+  bunx mandu change rollback
 
 Workflow:
   1. init → 2. spec-upsert → 3. generate → 4. guard → 5. dev
@@ -93,6 +114,37 @@ async function main(): Promise<void> {
       await dev({ port: options.port ? Number(options.port) : undefined });
       break;
 
+    case "change": {
+      const subCommand = args[1];
+      switch (subCommand) {
+        case "begin":
+          success = await changeBegin({ message: options.message });
+          break;
+        case "commit":
+          success = await changeCommit();
+          break;
+        case "rollback":
+          success = await changeRollback({ id: options.id });
+          break;
+        case "status":
+          success = await changeStatus();
+          break;
+        case "list":
+          success = await changeList();
+          break;
+        case "prune":
+          success = await changePrune({
+            keep: options.keep ? Number(options.keep) : undefined,
+          });
+          break;
+        default:
+          console.error(`❌ Unknown change subcommand: ${subCommand}`);
+          console.log(`\nUsage: bunx mandu change <begin|commit|rollback|status|list|prune>`);
+          process.exit(1);
+      }
+      break;
+    }
+
     default:
       console.error(`❌ Unknown command: ${command}`);
       console.log(HELP_TEXT);

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();
+}

package/templates/default/apps/web/entry.tsx

@@ -1,35 +1,35 @@
-import React from "react";
-import type { ReactElement } from "react";
-
-export interface AppContext {
-  routeId: string;
-  url: string;
-  params: Record<string, string>;
-}
-
-type RouteComponent = (props: { params: Record<string, string> }) => ReactElement;
-
-const routeComponents: Record<string, RouteComponent> = {};
-
-export function registerRoute(routeId: string, component: RouteComponent): void {
-  routeComponents[routeId] = component;
-}
-
-export function createApp(context: AppContext): ReactElement {
-  const Component = routeComponents[context.routeId];
-
-  if (!Component) {
-    return (
-      <div>
-        <h1>404 - Route Not Found</h1>
-        <p>Route ID: {context.routeId}</p>
-      </div>
-    );
-  }
-
-  return <Component params={context.params} />;
-}
-
-export function getRegisteredRoutes(): string[] {
-  return Object.keys(routeComponents);
-}
+import React from "react";
+import type { ReactElement } from "react";
+
+export interface AppContext {
+  routeId: string;
+  url: string;
+  params: Record<string, string>;
+}
+
+type RouteComponent = (props: { params: Record<string, string> }) => ReactElement;
+
+const routeComponents: Record<string, RouteComponent> = {};
+
+export function registerRoute(routeId: string, component: RouteComponent): void {
+  routeComponents[routeId] = component;
+}
+
+export function createApp(context: AppContext): ReactElement {
+  const Component = routeComponents[context.routeId];
+
+  if (!Component) {
+    return (
+      <div>
+        <h1>404 - Route Not Found</h1>
+        <p>Route ID: {context.routeId}</p>
+      </div>
+    );
+  }
+
+  return <Component params={context.params} />;
+}
+
+export function getRegisteredRoutes(): string[] {
+  return Object.keys(routeComponents);
+}

package/templates/default/spec/routes.manifest.json

@@ -1,18 +1,18 @@
-{
-  "version": 1,
-  "routes": [
-    {
-      "id": "home",
-      "pattern": "/",
-      "kind": "page",
-      "module": "apps/server/generated/routes/home.route.ts",
-      "componentModule": "apps/web/generated/routes/home.route.tsx"
-    },
-    {
-      "id": "health",
-      "pattern": "/api/health",
-      "kind": "api",
-      "module": "apps/server/generated/routes/health.route.ts"
-    }
-  ]
-}
+{
+  "version": 1,
+  "routes": [
+    {
+      "id": "home",
+      "pattern": "/",
+      "kind": "page",
+      "module": "apps/server/generated/routes/home.route.ts",
+      "componentModule": "apps/web/generated/routes/home.route.tsx"
+    },
+    {
+      "id": "health",
+      "pattern": "/api/health",
+      "kind": "api",
+      "module": "apps/server/generated/routes/health.route.ts"
+    }
+  ]
+}

package/templates/default/tests/example.test.ts

@@ -1,58 +1,58 @@
-// Mandu Example Test
-// 이 파일은 테스트 작성 방법을 보여주는 예제입니다.
-
-import { describe, it, expect } from "bun:test";
-import { createTestRequest, parseJsonResponse, assertStatus } from "./helpers";
-
-describe("Example Tests", () => {
-  describe("Basic Assertions", () => {
-    it("should pass basic equality test", () => {
-      expect(1 + 1).toBe(2);
-    });
-
-    it("should pass object equality test", () => {
-      const obj = { status: "ok", data: { message: "hello" } };
-      expect(obj).toEqual({
-        status: "ok",
-        data: { message: "hello" },
-      });
-    });
-  });
-
-  describe("Test Helpers", () => {
-    it("should create test request", () => {
-      const req = createTestRequest("http://localhost:3000/api/test", {
-        method: "POST",
-        body: { name: "test" },
-      });
-
-      expect(req.method).toBe("POST");
-      expect(req.url).toBe("http://localhost:3000/api/test");
-    });
-
-    it("should parse JSON response", async () => {
-      const mockResponse = new Response(
-        JSON.stringify({ status: "ok" }),
-        { status: 200 }
-      );
-
-      const data = await parseJsonResponse<{ status: string }>(mockResponse);
-      expect(data.status).toBe("ok");
-    });
-  });
-});
-
-// API 핸들러 테스트 예제 (실제 핸들러 import 후 사용)
-// import handler from "../apps/server/generated/routes/health.route";
-//
-// describe("API: GET /api/health", () => {
-//   it("should return 200 with status ok", async () => {
-//     const req = createTestRequest("http://localhost:3000/api/health");
-//     const response = handler(req, {});
-//
-//     assertStatus(response, 200);
-//
-//     const data = await parseJsonResponse<{ status: string }>(response);
-//     expect(data.status).toBe("ok");
-//   });
-// });
+// Mandu Example Test
+// 이 파일은 테스트 작성 방법을 보여주는 예제입니다.
+
+import { describe, it, expect } from "bun:test";
+import { createTestRequest, parseJsonResponse, assertStatus } from "./helpers";
+
+describe("Example Tests", () => {
+  describe("Basic Assertions", () => {
+    it("should pass basic equality test", () => {
+      expect(1 + 1).toBe(2);
+    });
+
+    it("should pass object equality test", () => {
+      const obj = { status: "ok", data: { message: "hello" } };
+      expect(obj).toEqual({
+        status: "ok",
+        data: { message: "hello" },
+      });
+    });
+  });
+
+  describe("Test Helpers", () => {
+    it("should create test request", () => {
+      const req = createTestRequest("http://localhost:3000/api/test", {
+        method: "POST",
+        body: { name: "test" },
+      });
+
+      expect(req.method).toBe("POST");
+      expect(req.url).toBe("http://localhost:3000/api/test");
+    });
+
+    it("should parse JSON response", async () => {
+      const mockResponse = new Response(
+        JSON.stringify({ status: "ok" }),
+        { status: 200 }
+      );
+
+      const data = await parseJsonResponse<{ status: string }>(mockResponse);
+      expect(data.status).toBe("ok");
+    });
+  });
+});
+
+// API 핸들러 테스트 예제 (실제 핸들러 import 후 사용)
+// import handler from "../apps/server/generated/routes/health.route";
+//
+// describe("API: GET /api/health", () => {
+//   it("should return 200 with status ok", async () => {
+//     const req = createTestRequest("http://localhost:3000/api/health");
+//     const response = handler(req, {});
+//
+//     assertStatus(response, 200);
+//
+//     const data = await parseJsonResponse<{ status: string }>(response);
+//     expect(data.status).toBe("ok");
+//   });
+// });

package/templates/default/tests/helpers.ts

@@ -1,52 +1,52 @@
-// Mandu Test Helpers
-// 테스트에서 사용할 유틸리티 함수들
-
-import type { Request } from "bun";
-
-/**
- * API 핸들러 테스트용 Request 생성
- */
-export function createTestRequest(
-  url: string,
-  options?: {
-    method?: string;
-    body?: unknown;
-    headers?: Record<string, string>;
-  }
-): Request {
-  const { method = "GET", body, headers = {} } = options || {};
-
-  return new Request(url, {
-    method,
-    headers: {
-      "Content-Type": "application/json",
-      ...headers,
-    },
-    body: body ? JSON.stringify(body) : undefined,
-  });
-}
-
-/**
- * Response를 JSON으로 파싱
- */
-export async function parseJsonResponse<T = unknown>(response: Response): Promise<T> {
-  return response.json() as Promise<T>;
-}
-
-/**
- * Response 상태 검증
- */
-export function assertStatus(response: Response, expectedStatus: number): void {
-  if (response.status !== expectedStatus) {
-    throw new Error(
-      `Expected status ${expectedStatus}, got ${response.status}`
-    );
-  }
-}
-
-/**
- * 테스트용 라우트 파라미터 생성
- */
-export function createParams(params: Record<string, string>): Record<string, string> {
-  return params;
-}
+// Mandu Test Helpers
+// 테스트에서 사용할 유틸리티 함수들
+
+import type { Request } from "bun";
+
+/**
+ * API 핸들러 테스트용 Request 생성
+ */
+export function createTestRequest(
+  url: string,
+  options?: {
+    method?: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+  }
+): Request {
+  const { method = "GET", body, headers = {} } = options || {};
+
+  return new Request(url, {
+    method,
+    headers: {
+      "Content-Type": "application/json",
+      ...headers,
+    },
+    body: body ? JSON.stringify(body) : undefined,
+  });
+}
+
+/**
+ * Response를 JSON으로 파싱
+ */
+export async function parseJsonResponse<T = unknown>(response: Response): Promise<T> {
+  return response.json() as Promise<T>;
+}
+
+/**
+ * Response 상태 검증
+ */
+export function assertStatus(response: Response, expectedStatus: number): void {
+  if (response.status !== expectedStatus) {
+    throw new Error(
+      `Expected status ${expectedStatus}, got ${response.status}`
+    );
+  }
+}
+
+/**
+ * 테스트용 라우트 파라미터 생성
+ */
+export function createParams(params: Record<string, string>): Record<string, string> {
+  return params;
+}

package/templates/default/tests/setup.ts

@@ -1,9 +1,9 @@
-// Mandu Test Setup
-// Bun 테스트 환경 설정
-
-// 테스트 타임아웃 설정 (필요 시)
-// import { setDefaultTimeout } from "bun:test";
-// setDefaultTimeout(10000);
-
-// 환경 변수 설정
-process.env.NODE_ENV = "test";
+// Mandu Test Setup
+// Bun 테스트 환경 설정
+
+// 테스트 타임아웃 설정 (필요 시)
+// import { setDefaultTimeout } from "bun:test";
+// setDefaultTimeout(10000);
+
+// 환경 변수 설정
+process.env.NODE_ENV = "test";

package/templates/default/tsconfig.json

@@ -1,14 +1,14 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "jsx": "react-jsx",
-    "types": ["bun-types"]
-  },
-  "include": ["apps/**/*.ts", "apps/**/*.tsx"],
-  "exclude": ["node_modules"]
-}
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "types": ["bun-types"]
+  },
+  "include": ["apps/**/*.ts", "apps/**/*.tsx"],
+  "exclude": ["node_modules"]
+}