@mandujs/cli 0.15.4 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.15.4",
+  "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)