@mandujs/cli 0.3.2 → 0.3.4

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,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
   "type": "module",
   "main": "./src/main.ts",
@@ -32,9 +32,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@mandujs/core": "^0.2.0"
+    "@mandujs/core": "^0.3.3"
   },
-  "peerDependencies": {
+  "engines": {
     "bun": ">=1.0.0"
   }
 }

package/src/commands/change/begin.ts

@@ -0,0 +1,33 @@
+import { beginChange } from "@mandujs/core";
+import { getRootDir } from "../../util/fs";
+
+export interface ChangeBeginOptions {
+  message?: string;
+}
+
+export async function changeBegin(options: ChangeBeginOptions = {}): Promise<boolean> {
+  const rootDir = getRootDir();
+
+  console.log(`🥟 Mandu Change Begin`);
+
+  try {
+    const change = await beginChange(rootDir, {
+      message: options.message,
+    });
+
+    console.log(`✅ 트랜잭션 시작됨`);
+    console.log(`   ID: ${change.id}`);
+    console.log(`   스냅샷: ${change.snapshotId}`);
+    if (change.message) {
+      console.log(`   메시지: ${change.message}`);
+    }
+    console.log(`\n💡 변경 작업 후 다음 명령을 실행하세요:`);
+    console.log(`   확정: bunx mandu change commit`);
+    console.log(`   롤백: bunx mandu change rollback`);
+
+    return true;
+  } catch (error) {
+    console.error(`❌ 트랜잭션 시작 실패: ${error instanceof Error ? error.message : String(error)}`);
+    return false;
+  }
+}

package/src/commands/change/commit.ts

@@ -0,0 +1,23 @@
+import { commitChange } from "@mandujs/core";
+import { getRootDir } from "../../util/fs";
+
+export async function changeCommit(): Promise<boolean> {
+  const rootDir = getRootDir();
+
+  console.log(`🥟 Mandu Change Commit`);
+
+  try {
+    const result = await commitChange(rootDir);
+
+    console.log(`✅ 변경 확정됨`);
+    console.log(`   ID: ${result.changeId}`);
+    if (result.message) {
+      console.log(`   메시지: ${result.message}`);
+    }
+
+    return true;
+  } catch (error) {
+    console.error(`❌ 커밋 실패: ${error instanceof Error ? error.message : String(error)}`);
+    return false;
+  }
+}

package/src/commands/change/index.ts

@@ -0,0 +1,6 @@
+export { changeBegin, type ChangeBeginOptions } from "./begin";
+export { changeCommit } from "./commit";
+export { changeRollback, type ChangeRollbackOptions } from "./rollback";
+export { changeStatus } from "./status";
+export { changeList } from "./list";
+export { changePrune, type ChangePruneOptions } from "./prune";

package/src/commands/change/list.ts

@@ -0,0 +1,57 @@
+import { listChanges, getChangeStats } from "@mandujs/core";
+import { getRootDir } from "../../util/fs";
+
+export async function changeList(): Promise<boolean> {
+  const rootDir = getRootDir();
+
+  console.log(`🥟 Mandu Change List\n`);
+
+  try {
+    const changes = await listChanges(rootDir);
+    const stats = await getChangeStats(rootDir);
+
+    if (changes.length === 0) {
+      console.log(`📭 변경 이력이 없습니다`);
+      console.log(`\n💡 새 트랜잭션 시작: bunx mandu change begin`);
+      return true;
+    }
+
+    // 통계
+    console.log(`📊 통계:`);
+    console.log(`   총 기록: ${stats.total}개`);
+    console.log(`   활성: ${stats.active}개 | 확정: ${stats.committed}개 | 롤백: ${stats.rolledBack}개`);
+    console.log(`   스냅샷: ${stats.snapshotCount}개\n`);
+
+    // 최근 기록 (최신 순)
+    console.log(`📜 변경 이력:`);
+
+    const sortedChanges = [...changes].reverse(); // 최신 순
+
+    for (const change of sortedChanges) {
+      const statusIcon =
+        change.status === "active"
+          ? "🔄"
+          : change.status === "committed"
+            ? "✅"
+            : "↩️";
+
+      const date = new Date(change.createdAt).toLocaleString();
+
+      console.log(`   ${statusIcon} ${change.id}`);
+      console.log(`      상태: ${change.status}`);
+      console.log(`      시간: ${date}`);
+      if (change.message) {
+        console.log(`      메시지: ${change.message}`);
+      }
+      if (change.autoGenerated) {
+        console.log(`      생성: Auto-correct`);
+      }
+      console.log("");
+    }
+
+    return true;
+  } catch (error) {
+    console.error(`❌ 이력 조회 실패: ${error instanceof Error ? error.message : String(error)}`);
+    return false;
+  }
+}

package/src/commands/change/prune.ts

@@ -0,0 +1,32 @@
+import { pruneHistory, DEFAULT_HISTORY_CONFIG } from "@mandujs/core";
+import { getRootDir } from "../../util/fs";
+
+export interface ChangePruneOptions {
+  keep?: number;
+}
+
+export async function changePrune(options: ChangePruneOptions = {}): Promise<boolean> {
+  const rootDir = getRootDir();
+  const keepCount = options.keep ?? DEFAULT_HISTORY_CONFIG.maxSnapshots;
+
+  console.log(`🥟 Mandu Change Prune`);
+  console.log(`   유지할 스냅샷: ${keepCount}개\n`);
+
+  try {
+    const deletedIds = await pruneHistory(rootDir, keepCount);
+
+    if (deletedIds.length === 0) {
+      console.log(`✅ 정리할 스냅샷이 없습니다`);
+    } else {
+      console.log(`🗑️  삭제된 스냅샷: ${deletedIds.length}개`);
+      for (const id of deletedIds) {
+        console.log(`   - ${id}`);
+      }
+    }
+
+    return true;
+  } catch (error) {
+    console.error(`❌ 정리 실패: ${error instanceof Error ? error.message : String(error)}`);
+    return false;
+  }
+}

package/src/commands/change/rollback.ts

@@ -0,0 +1,40 @@
+import { rollbackChange } from "@mandujs/core";
+import { getRootDir } from "../../util/fs";
+
+export interface ChangeRollbackOptions {
+  id?: string;
+}
+
+export async function changeRollback(options: ChangeRollbackOptions = {}): Promise<boolean> {
+  const rootDir = getRootDir();
+
+  console.log(`🥟 Mandu Change Rollback`);
+
+  try {
+    const result = await rollbackChange(rootDir, options.id);
+
+    if (result.success) {
+      console.log(`✅ 롤백 완료`);
+      console.log(`   ID: ${result.changeId}`);
+      console.log(`   복원된 파일: ${result.restoreResult.restoredFiles.length}개`);
+
+      for (const file of result.restoreResult.restoredFiles) {
+        console.log(`     - ${file}`);
+      }
+    } else {
+      console.log(`⚠️  롤백 부분 완료`);
+      console.log(`   ID: ${result.changeId}`);
+      console.log(`   복원된 파일: ${result.restoreResult.restoredFiles.length}개`);
+      console.log(`   실패한 파일: ${result.restoreResult.failedFiles.length}개`);
+
+      for (const error of result.restoreResult.errors) {
+        console.error(`     - ${error}`);
+      }
+    }
+
+    return result.success;
+  } catch (error) {
+    console.error(`❌ 롤백 실패: ${error instanceof Error ? error.message : String(error)}`);
+    return false;
+  }
+}

package/src/commands/change/status.ts

@@ -0,0 +1,36 @@
+import { getTransactionStatus } from "@mandujs/core";
+import { getRootDir } from "../../util/fs";
+
+export async function changeStatus(): Promise<boolean> {
+  const rootDir = getRootDir();
+
+  console.log(`🥟 Mandu Change Status\n`);
+
+  try {
+    const { state, change } = await getTransactionStatus(rootDir);
+
+    if (state.active && change) {
+      console.log(`🔄 활성 트랜잭션:`);
+      console.log(`   ID: ${change.id}`);
+      console.log(`   스냅샷: ${change.snapshotId}`);
+      console.log(`   시작: ${new Date(change.createdAt).toLocaleString()}`);
+      if (change.message) {
+        console.log(`   메시지: ${change.message}`);
+      }
+      if (change.autoGenerated) {
+        console.log(`   생성: Auto-correct`);
+      }
+      console.log(`\n💡 사용 가능한 명령:`);
+      console.log(`   확정: bunx mandu change commit`);
+      console.log(`   롤백: bunx mandu change rollback`);
+    } else {
+      console.log(`✅ 활성 트랜잭션 없음`);
+      console.log(`\n💡 새 트랜잭션 시작: bunx mandu change begin`);
+    }
+
+    return true;
+  } catch (error) {
+    console.error(`❌ 상태 조회 실패: ${error instanceof Error ? error.message : String(error)}`);
+    return false;
+  }
+}

package/src/commands/guard-check.ts

@@ -58,9 +58,36 @@ export async function guardCheck(options: GuardCheckOptions = {}): Promise<boole
 
       if (autoCorrectResult.fixed) {
         console.log(`\n✅ Auto-correct 완료 (${autoCorrectResult.retriedCount}회 재시도)`);
+        if (autoCorrectResult.changeId) {
+          console.log(`   트랜잭션: ${autoCorrectResult.changeId} (커밋됨)`);
+        }
 
         // 최종 Guard 재검사
         checkResult = await runGuardCheck(result.data, rootDir);
+      } else if (autoCorrectResult.rolledBack) {
+        console.log(`\n⚠️  Auto-correct 실패 - 롤백됨`);
+        if (autoCorrectResult.changeId) {
+          console.log(`   트랜잭션: ${autoCorrectResult.changeId} (롤백됨)`);
+        }
+        console.log(`   원래 상태로 복원되었습니다.`);
+
+        const manualViolations = autoCorrectResult.remainingViolations.filter(
+          (v) => !isAutoCorrectableViolation(v)
+        );
+
+        if (manualViolations.length > 0) {
+          console.log(`\n⚠️  수동 수정이 필요한 위반:`);
+          for (const v of manualViolations) {
+            console.log(`  - [${v.ruleId}] ${v.file}`);
+            console.log(`    💡 ${v.suggestion}`);
+          }
+        }
+
+        // 남은 위반으로 업데이트
+        checkResult = {
+          passed: false,
+          violations: autoCorrectResult.remainingViolations,
+        };
       } else {
         console.log(`\n⚠️  일부 위반은 수동 수정이 필요합니다:`);