@mandujs/cli 0.15.3 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.15.3",
+  "version": "0.16.0",
   "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
   "type": "module",
   "main": "./src/main.ts",
@@ -32,7 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@mandujs/core": "^0.13.2",
+    "@mandujs/core": "^0.16.0",
+    "@mandujs/ate": "0.16.0",
     "cfonts": "^3.3.0"
   },
   "engines": {

package/src/commands/add.ts

@@ -0,0 +1,64 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { theme } from "../terminal";
+
+function run(cmd: string, args: string[], cwd: string): void {
+  const res = spawnSync(cmd, args, { cwd, stdio: "inherit" });
+  if (res.error) throw res.error;
+  if (res.status !== 0) throw new Error(`Command failed: ${cmd} ${args.join(" ")}`);
+}
+
+function runTry(cmd: string, args: string[], cwd: string): boolean {
+  try {
+    run(cmd, args, cwd);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function addTest({ cwd = process.cwd() }: { cwd?: string } = {}): Promise<boolean> {
+  const pkgPath = join(cwd, "package.json");
+  if (!existsSync(pkgPath)) {
+    console.error(theme.error("package.json not found. Run inside a Mandu project."));
+    return false;
+  }
+
+  console.log(theme.heading("🥟 Mandu ATE: installing test automation deps..."));
+
+  // Install in project (no external SaaS deps)
+  // NOTE: @mandujs/ate might not be published yet. In that case, fallback to local file: install.
+  const installed = runTry("bun", ["add", "-d", "@mandujs/ate", "@playwright/test", "playwright"], cwd);
+  if (!installed) {
+    const localAtePath = join(cwd, "..", "mandu", "packages", "ate");
+    const localPkg = join(localAtePath, "package.json");
+    if (existsSync(localPkg)) {
+      console.warn(theme.warn(`@mandujs/ate not found on npm. Falling back to local install: file:${localAtePath}`));
+      run("bun", ["add", "-d", `file:${localAtePath}`, "@playwright/test", "playwright"], cwd);
+    } else {
+      console.error(theme.error("@mandujs/ate not found on npm, and local fallback path not found."));
+      console.error(theme.muted(`Expected: ${localPkg}`));
+      console.error(theme.muted("Tip: install manually with: bun add -d file:/abs/path/to/mandu/packages/ate"));
+      return false;
+    }
+  }
+
+  const browserInstalled = runTry("bunx", ["playwright", "install", "chromium"], cwd);
+  if (!browserInstalled) {
+    console.error(theme.error("Failed to install Playwright browsers. Try manually: bunx playwright install chromium"));
+    return false;
+  }
+
+  // Create directories and baseline config
+  const dirs = [
+    join(cwd, "tests", "e2e", "auto"),
+    join(cwd, "tests", "e2e", "manual"),
+    join(cwd, ".mandu", "scenarios"),
+    join(cwd, ".mandu", "reports"),
+  ];
+  for (const d of dirs) mkdirSync(d, { recursive: true });
+
+  console.log(theme.success("✅ ATE installed. Next: bunx mandu test:auto"));
+  return true;
+}

package/src/commands/registry.ts

@@ -348,6 +348,45 @@ registerCommand({
   },
 });
 
+// ============================================================================
+// ATE (Automation Test Engine)
+// ============================================================================
+
+registerCommand({
+  id: "add",
+  description: "프로젝트에 기능 추가",
+  subcommands: ["test"],
+  async run(ctx) {
+    const sub = ctx.args[1];
+    if (sub !== "test") return false;
+    const { addTest } = await import("./add");
+    return addTest({ cwd: process.cwd() });
+  },
+});
+
+registerCommand({
+  id: "test:auto",
+  description: "ATE 자동 E2E 생성/실행",
+  async run(ctx) {
+    const { testAuto } = await import("./test-auto");
+    return testAuto({
+      ci: ctx.options.ci === "true",
+      impact: ctx.options.impact === "true",
+      baseURL: ctx.options["base-url"] || ctx.options.baseURL || ctx.options.baseUrl,
+    });
+  },
+});
+
+registerCommand({
+  id: "test:heal",
+  description: "ATE healing 제안 생성(자동 커밋 금지)",
+  async run() {
+    const { testHeal } = await import("./test-heal");
+    return testHeal();
+  },
+});
+
+
 // 레거시 명령어 (DEPRECATED)
 registerCommand({
   id: "spec-upsert",

package/src/commands/test-auto.ts

@@ -0,0 +1,59 @@
+import { theme } from "../terminal";
+import { ateExtract, ateGenerate, ateRun, ateReport, ateImpact } from "@mandujs/ate";
+
+function jsonOut(obj: unknown) {
+  console.log(JSON.stringify(obj, null, 2));
+}
+
+export async function testAuto(opts: { ci?: boolean; impact?: boolean; baseURL?: string } = {}): Promise<boolean> {
+  const repoRoot = process.cwd();
+  const oracleLevel = "L0" as const;
+
+  try {
+    // 1) extract
+    const extractRes = await ateExtract({ repoRoot });
+
+    // 2) impact subset (optional)
+    let onlyRoutes: string[] | undefined;
+    let impactInfo: any = { mode: "full", changedFiles: [], selectedRoutes: [] };
+    if (opts.impact) {
+      const impactRes = ateImpact({ repoRoot });
+      onlyRoutes = impactRes.selectedRoutes.length ? impactRes.selectedRoutes : undefined;
+      impactInfo = {
+        mode: onlyRoutes ? "subset" : "full",
+        changedFiles: impactRes.changedFiles,
+        selectedRoutes: impactRes.selectedRoutes,
+      };
+    }
+
+    // 3) generate
+    const genRes = ateGenerate({ repoRoot, oracleLevel, onlyRoutes });
+
+    // 4) run
+    const runRes = await ateRun({ repoRoot, ci: opts.ci, headless: opts.ci, baseURL: opts.baseURL });
+
+    // 5) report
+    const repRes = await ateReport({
+      repoRoot,
+      runId: runRes.runId,
+      startedAt: runRes.startedAt,
+      finishedAt: runRes.finishedAt,
+      exitCode: runRes.exitCode,
+      oracleLevel,
+      impact: impactInfo,
+    });
+
+    jsonOut({
+      ok: repRes.summary.ok,
+      extract: extractRes,
+      generate: genRes,
+      run: { runId: runRes.runId, exitCode: runRes.exitCode },
+      report: { summaryPath: repRes.summaryPath },
+    });
+
+    return repRes.summary.ok;
+  } catch (err) {
+    console.error(theme.error("ATE test:auto failed"), err);
+    return false;
+  }
+}

package/src/commands/test-heal.ts

@@ -0,0 +1,15 @@
+import { theme } from "../terminal";
+import { ateHeal } from "@mandujs/ate";
+
+export async function testHeal(): Promise<boolean> {
+  const repoRoot = process.cwd();
+  try {
+    const runId = "latest"; // minimal skeleton
+    const res = ateHeal({ repoRoot, runId });
+    console.log(JSON.stringify(res, null, 2));
+    return true;
+  } catch (err) {
+    console.error(theme.error("ATE test:heal failed"), err);
+    return false;
+  }
+}

package/src/main.ts

@@ -60,6 +60,13 @@ Commands:
   lock --verify     Lockfile 검증 (설정 무결성 확인)
   lock --diff       Lockfile과 현재 설정 비교
 
+  add test          ATE 설치 + Playwright 브라우저 준비
+  test:auto         ATE extract→generate→run→report
+  test:auto --ci    CI 모드(headless/아티팩트 강화)
+  test:auto --impact  변경 파일 기반 subset 실행
+  test:auto --base-url <url>  대상 서버 baseURL 지정 (기본: http://localhost:3333)
+  test:heal         최근 실패 기반 healing 제안 생성(자동 커밋 금지)
+
 Options:
   --name <name>       init 시 프로젝트 이름 (기본: my-mandu-app)
   --template <name>   init 템플릿: default, realtime-chat (기본: default)

package/src/util/lockfile.ts

@@ -8,6 +8,54 @@ import {
   type LockfileValidationResult,
 } from "@mandujs/core";
 
+/**
+ * Lockfile command templates for consistent messaging
+ */
+export const LOCKFILE_COMMANDS = {
+  update: "mandu lock",
+  diff: "mandu lock --diff",
+  safeDev: "mandu lock && mandu dev --watch",
+} as const;
+
+/**
+ * Formatted lockfile guidance lines with alternative commands
+ */
+export const LOCKFILE_GUIDE_LINES = {
+  update: `${LOCKFILE_COMMANDS.update}  (or bunx mandu lock)`,
+  diff: `${LOCKFILE_COMMANDS.diff}  (or bunx mandu lock --diff)`,
+  safeDev: `${LOCKFILE_COMMANDS.safeDev}  (or bun run dev:safe)`,
+} as const;
+
+/**
+ * Returns formatted lockfile guidance lines for display
+ *
+ * @returns Array of guidance messages with Korean labels
+ *
+ * @example
+ * ```typescript
+ * const lines = getLockfileGuidanceLines();
+ * lines.forEach(line => console.log(`   ↳ ${line}`));
+ * // Output:
+ * //    ↳ lock 갱신: mandu lock  (or bunx mandu lock)
+ * //    ↳ 변경 확인: mandu lock --diff  (or bunx mandu lock --diff)
+ * //    ↳ 안정 실행: mandu lock && mandu dev --watch  (or bun run dev:safe)
+ * ```
+ */
+export function getLockfileGuidanceLines(): string[] {
+  return [
+    `lock 갱신: ${LOCKFILE_GUIDE_LINES.update}`,
+    `변경 확인: ${LOCKFILE_GUIDE_LINES.diff}`,
+    `안정 실행: ${LOCKFILE_GUIDE_LINES.safeDev}`,
+  ];
+}
+
+/**
+ * Validates runtime lockfile against current config
+ *
+ * @param config - Mandu configuration object
+ * @param rootDir - Project root directory
+ * @returns Validation result with lockfile, action, and bypass status
+ */
 export async function validateRuntimeLockfile(config: Record<string, unknown>, rootDir: string) {
   const lockfile = await readLockfile(rootDir);
 
@@ -30,17 +78,22 @@ export async function validateRuntimeLockfile(config: Record<string, unknown>, r
   return { lockfile, lockResult, action, bypassed };
 }
 
+/**
+ * Handles blocked server start due to lockfile mismatch
+ *
+ * Exits process with error code 1 if action is "block"
+ *
+ * @param action - Policy action from lockfile validation
+ * @param lockResult - Validation result with details
+ */
 export function handleBlockedLockfile(action: "pass" | "warn" | "error" | "block", lockResult: LockfileValidationResult | null): void {
   if (action !== "block") return;
 
+  const guidance = getLockfileGuidanceLines();
   console.error("🛑 서버 시작 차단: Lockfile 불일치");
-  console.error("   설정이 변경되었습니다. 의도한 변경이라면 아래 중 하나를 실행하세요:");
-  console.error("   $ mandu lock");
-  console.error("   $ bunx mandu lock");
-  console.error("");
-  console.error("   변경 사항 확인:");
-  console.error("   $ mandu lock --diff");
-  console.error("   $ bunx mandu lock --diff");
+  console.error("   설정이 변경되었습니다. 의도한 변경이라면 아래를 실행하세요:");
+  console.error(`   ↳ ${guidance[0]}`);
+  console.error(`   ↳ ${guidance[1]}`);
   if (lockResult) {
     console.error("");
     console.error(formatValidationResult(lockResult));
@@ -48,6 +101,14 @@ export function handleBlockedLockfile(action: "pass" | "warn" | "error" | "block
   process.exit(1);
 }
 
+/**
+ * Prints runtime lockfile validation status
+ *
+ * @param action - Policy action from lockfile validation
+ * @param bypassed - Whether validation was bypassed
+ * @param lockfile - Lockfile data (null if not found)
+ * @param lockResult - Validation result with hash and validity
+ */
 export function printRuntimeLockfileStatus(
   action: "pass" | "warn" | "error" | "block",
   bypassed: boolean,
@@ -56,11 +117,12 @@ export function printRuntimeLockfileStatus(
 ): void {
   if (action === "warn") {
     console.log(`⚠️  ${formatPolicyAction(action, bypassed)}`);
-    console.log(`   ↳ lock 갱신: mandu lock  (or bunx mandu lock)`);
-    console.log(`   ↳ 변경 확인: mandu lock --diff  (or bunx mandu lock --diff)`);
+    for (const line of getLockfileGuidanceLines()) {
+      console.log(`   ↳ ${line}`);
+    }
   } else if (lockfile && lockResult?.valid) {
     console.log(`🔒 설정 무결성 확인됨 (${lockResult.currentHash?.slice(0, 8)})`);
   } else if (!lockfile) {
-    console.log(`💡 Lockfile 없음 - 'mandu lock' 또는 'bunx mandu lock'으로 생성 권장`);
+    console.log(`💡 Lockfile 없음 - '${LOCKFILE_COMMANDS.update}'으로 생성 권장`);
   }
 }

package/templates/realtime-chat/src/client/features/chat/use-realtime-chat.ts

@@ -7,7 +7,7 @@ import {
   openChatStream,
   sendChatMessage,
   type ChatStreamConnectionState,
-} from "./chat-api";
+} from "@/client/features/chat/chat-api";
 
 export function useRealtimeChat() {
   const [messages, setMessages] = useState<ChatMessage[]>([]);