@simplysm/sd-cli 14.0.11 → 14.0.13

package/tests/angular/vite-angular-plugin.spec.ts

@@ -192,6 +192,73 @@ describe("sdAngularPlugin", () => {
     // (in real use, Vite server close triggers this)
   });
 
+  // Scenario: optimizeDeps에 Angular Linker esbuild 플러그인이 등록된다 (Feature 1.1 Angular Linker)
+  it("registers angular-vite-optimize-deps esbuild plugin in optimizeDeps config", () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    const config = (plugin as any).config?.();
+
+    const esbuildPlugins = config?.optimizeDeps?.esbuildOptions?.plugins as
+      | { name: string }[]
+      | undefined;
+    expect(esbuildPlugins).toBeDefined();
+    expect(esbuildPlugins!.some((p) => p.name === "angular-vite-optimize-deps")).toBe(true);
+  });
+
+  // Scenario: .mjs 파일이 JavaScriptTransformer를 통과한다 (Feature 1.1 Angular Linker)
+  it("transforms .mjs files through JavaScriptTransformer", async () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    await (plugin as any).buildStart?.call({});
+
+    const mjsCode = "export const x = 1;";
+    const result = await (plugin as any).transform?.call(
+      {},
+      mjsCode,
+      "/some/library/module.mjs",
+    );
+
+    // .mjs 파일은 transform 결과를 반환해야 한다 (undefined가 아님)
+    expect(result).toBeDefined();
+    expect(result.code).toBeDefined();
+    expect(typeof result.code).toBe("string");
+
+    await (plugin as any).buildEnd?.call({});
+  });
+
+  // Scenario: .js 파일이 JavaScriptTransformer를 통과한다 (Feature 1.1 Angular Linker)
+  it("transforms .js files through JavaScriptTransformer", async () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    await (plugin as any).buildStart?.call({});
+
+    const jsCode = "export const y = 2;";
+    const result = await (plugin as any).transform?.call(
+      {},
+      jsCode,
+      "/some/library/module.js",
+    );
+
+    expect(result).toBeDefined();
+    expect(result.code).toBeDefined();
+    expect(typeof result.code).toBe("string");
+
+    await (plugin as any).buildEnd?.call({});
+  });
+
+  // Scenario: 비대상 파일(.css 등)은 transform하지 않는다 (Feature 1.1 Angular Linker)
+  it("returns undefined for non-JS files like .css", async () => {
+    const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
+    await (plugin as any).buildStart?.call({});
+
+    const result = await (plugin as any).transform?.call(
+      {},
+      "body { color: red; }",
+      "/some/styles.css",
+    );
+
+    expect(result).toBeUndefined();
+
+    await (plugin as any).buildEnd?.call({});
+  });
+
   // Scenario: Angular .ts 파일 transform
   it("transforms emitted .ts files with compiled JS", async () => {
     const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: false });

package/tests/capacitor/capacitor-build.spec.ts

@@ -27,8 +27,8 @@ vi.mock("@simplysm/core-node", () => ({
     copy: mockFsxCopy,
   },
   cpx: {
-    exec: mockCpxExec,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mockCpxSpawn,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
   pathx: {
     posixResolve: (...args: string[]) => path.resolve(...args).replace(/\\/g, "/"),
@@ -46,7 +46,7 @@ vi.mock("@simplysm/core-common", () => ({
 
 // cpx mock (was execa)
 const execaCalls: { command: string; args: string[] }[] = [];
-const mockCpxExec = vi.fn((...args: unknown[]) => {
+const mockCpxSpawn = vi.fn((...args: unknown[]) => {
   execaCalls.push({ command: args[0] as string, args: (args[1] as string[] | undefined) ?? [] });
   return Promise.resolve({ stdout: "", stderr: "", exitCode: 0 });
 });
@@ -82,7 +82,9 @@ vi.mock("consola", () => ({
       warn: mockLoggerWarn,
       success: mockLoggerSuccess,
     }),
+    level: 0,
   },
+  LogLevels: { debug: 4 },
 }));
 
 //#endregion
@@ -91,6 +93,19 @@ vi.mock("consola", () => ({
 
 const PKG_PATH = "/fake/pkg";
 
+/** Gradle 실행 명령을 찾는다 (Windows: cmd /c gradlew.bat, 그 외: gradlew) */
+function findGradleCall(calls: { command: string; args: string[] }[]) {
+  return calls.find(
+    (c) => c.command.includes("gradlew") || (c.command === "cmd" && c.args.includes("gradlew.bat")),
+  );
+}
+
+function findGradleCallIndex(calls: { command: string; args: string[] }[]) {
+  return calls.findIndex(
+    (c) => c.command.includes("gradlew") || (c.command === "cmd" && c.args.includes("gradlew.bat")),
+  );
+}
+
 function setupDefaultMocks() {
   mockFsxExists.mockResolvedValue(true);
 
@@ -179,7 +194,7 @@ describe("Capacitor 빌드", () => {
 
       await cap.build("/fake/out");
 
-      const gradleCmd = execaCalls.find((c) => c.command.includes("gradlew"));
+      const gradleCmd = findGradleCall(execaCalls);
       expect(gradleCmd).toBeDefined();
       expect(gradleCmd!.args).toContain("bundleRelease");
     });
@@ -195,7 +210,7 @@ describe("Capacitor 빌드", () => {
 
       await cap.build("/fake/out");
 
-      const gradleCmd = execaCalls.find((c) => c.command.includes("gradlew"));
+      const gradleCmd = findGradleCall(execaCalls);
       expect(gradleCmd).toBeDefined();
       expect(gradleCmd!.args).toContain("assembleRelease");
     });
@@ -212,7 +227,7 @@ describe("Capacitor 빌드", () => {
 
       await cap.build("/fake/out");
 
-      const gradleCmd = execaCalls.find((c) => c.command.includes("gradlew"));
+      const gradleCmd = findGradleCall(execaCalls);
       expect(gradleCmd).toBeDefined();
       expect(gradleCmd!.args).toContain("assembleDebug");
     });
@@ -270,14 +285,14 @@ describe("Capacitor 빌드", () => {
 
       // cap copy가 gradlew보다 먼저 실행되는지 확인
       const capCopyIndex = execaCalls.findIndex(
-        (c) => c.command === "npx" && c.args.includes("cap") && c.args.includes("copy"),
+        (c) => c.command === "pnpm" && c.args.includes("cap") && c.args.includes("copy"),
       );
-      const gradlewIndex = execaCalls.findIndex((c) => c.command.includes("gradlew"));
+      const gradlewIndex = findGradleCallIndex(execaCalls);
       expect(capCopyIndex).toBeGreaterThanOrEqual(0);
       expect(gradlewIndex).toBeGreaterThan(capCopyIndex);
     });
 
-    it("Windows에서 gradlew.bat을 사용한다", async () => {
+    it("Windows에서 cmd /c gradlew.bat으로 Gradle을 실행한다", async () => {
       const originalPlatform = process.platform;
       Object.defineProperty(process, "platform", { value: "win32" });
 
@@ -292,8 +307,37 @@ describe("Capacitor 빌드", () => {
 
         await cap.build("/fake/out");
 
-        const gradleCmd = execaCalls.find((c) => c.command.includes("gradlew"));
-        expect(gradleCmd!.command).toContain("gradlew.bat");
+        const gradleCmd = execaCalls.find((c) => c.command === "cmd");
+        expect(gradleCmd).toBeDefined();
+        expect(gradleCmd!.args[0]).toBe("/c");
+        expect(gradleCmd!.args[1]).toBe("gradlew.bat");
+        expect(gradleCmd!.args).toContain("assembleRelease");
+        expect(gradleCmd!.args).toContain("--no-daemon");
+      } finally {
+        Object.defineProperty(process, "platform", { value: originalPlatform });
+      }
+    });
+
+    it("Linux/macOS에서 gradlew를 직접 실행한다", async () => {
+      const originalPlatform = process.platform;
+      Object.defineProperty(process, "platform", { value: "linux" });
+
+      try {
+        const { Capacitor } = await import("../../src/capacitor/capacitor.js");
+
+        const cap = await Capacitor.create(PKG_PATH, {
+          appId: "com.test.app",
+          appName: "Test App",
+          platform: { android: {} },
+        });
+
+        await cap.build("/fake/out");
+
+        const gradleCmd = findGradleCall(execaCalls);
+        expect(gradleCmd).toBeDefined();
+        expect(gradleCmd!.command).toContain("gradlew");
+        expect(gradleCmd!.command).not.toContain("gradlew.bat");
+        expect(gradleCmd!.args).toContain("assembleRelease");
       } finally {
         Object.defineProperty(process, "platform", { value: originalPlatform });
       }
@@ -375,6 +419,44 @@ describe("Capacitor 빌드", () => {
       await expect(cap.build("/fake/out")).rejects.toThrow("keystore");
     });
 
+    it("비밀번호에 $, \\, ' 등 특수문자가 있으면 Groovy 이스케이프하여 build.gradle에 기록한다", async () => {
+      const { Capacitor } = await import("../../src/capacitor/capacitor.js");
+      mockFsxExists.mockResolvedValue(true);
+
+      const cap = await Capacitor.create(PKG_PATH, {
+        appId: "com.test.app",
+        appName: "Test App",
+        platform: {
+          android: {
+            sign: {
+              keystore: "my-release.keystore",
+              storePassword: "12tlavmf#$",
+              alias: "my-key",
+              password: "pass\\'word",
+            },
+          },
+        },
+      });
+
+      await cap.build("/fake/out");
+
+      const writeCalls = mockFsxWrite.mock.calls;
+      const gradleWrite = writeCalls.find(
+        (call) =>
+          typeof call[0] === "string" &&
+          call[0].includes("build.gradle") &&
+          typeof call[1] === "string" &&
+          call[1].includes("signingConfigs"),
+      );
+      expect(gradleWrite).toBeDefined();
+
+      const gradleContent = gradleWrite![1] as string;
+      // $ 는 Groovy single-quoted string에서 그대로 유지
+      expect(gradleContent).toContain("storePassword '12tlavmf#$'");
+      // \ → \\, ' → \' 이스케이프
+      expect(gradleContent).toContain("keyPassword 'pass\\\\\\'word'");
+    });
+
     it("signed 빌드 산출물이 unsigned 접미사 없이 복사된다", async () => {
       const { Capacitor } = await import("../../src/capacitor/capacitor.js");
 

package/tests/capacitor/capacitor-icon.spec.ts

@@ -25,8 +25,8 @@ vi.mock("@simplysm/core-node", () => ({
     glob: mockFsxGlob,
   },
   cpx: {
-    exec: mockCpxExec,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mockCpxSpawn,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
   pathx: {
     posixResolve: (...args: string[]) => path.resolve(...args).replace(/\\/g, "/"),
@@ -44,7 +44,7 @@ vi.mock("@simplysm/core-common", () => ({
 
 // cpx mock (was execa)
 const execaCalls: { command: string; args: string[] }[] = [];
-const mockCpxExec = vi.fn((...args: unknown[]) => {
+const mockCpxSpawn = vi.fn((...args: unknown[]) => {
   execaCalls.push({ command: args[0] as string, args: (args[1] as string[] | undefined) ?? [] });
   return Promise.resolve({ stdout: "", stderr: "", exitCode: 0 });
 });
@@ -82,7 +82,9 @@ vi.mock("consola", () => ({
       warn: mockLoggerWarn,
       success: mockLoggerSuccess,
     }),
+    level: 0,
   },
+  LogLevels: { debug: 4 },
 }));
 
 //#endregion
@@ -178,7 +180,7 @@ describe("Capacitor 아이콘 처리", () => {
 
       // capacitor-assets generate가 실행되었는지 확인
       const assetsCmd = execaCalls.find(
-        (c) => c.command === "npx" && c.args.includes("capacitor-assets"),
+        (c) => c.command === "pnpm" && c.args.includes("capacitor-assets"),
       );
       expect(assetsCmd).toBeDefined();
 
@@ -202,7 +204,7 @@ describe("Capacitor 아이콘 처리", () => {
 
       // capacitor-assets generate가 실행되지 않아야 한다
       const assetsCmd = execaCalls.find(
-        (c) => c.command === "npx" && c.args.includes("capacitor-assets"),
+        (c) => c.command === "pnpm" && c.args.includes("capacitor-assets"),
       );
       expect(assetsCmd).toBeUndefined();
     });

package/tests/capacitor/capacitor-init.spec.ts

@@ -26,8 +26,8 @@ vi.mock("@simplysm/core-node", () => ({
     copy: mockFsxCopy,
   },
   cpx: {
-    exec: mockCpxExec,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mockCpxSpawn,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
   pathx: {
     posixResolve: (...args: string[]) => path.resolve(...args).replace(/\\/g, "/"),
@@ -43,7 +43,7 @@ vi.mock("@simplysm/core-common", () => ({
 }));
 
 const execaCalls: { command: string; args: string[] }[] = [];
-const mockCpxExec = vi.fn((...args: unknown[]) => {
+const mockCpxSpawn = vi.fn((...args: unknown[]) => {
   execaCalls.push({ command: args[0] as string, args: (args[1] as string[] | undefined) ?? [] });
   return Promise.resolve({ stdout: "", stderr: "", exitCode: 0 });
 });
@@ -71,8 +71,10 @@ const mockLoggerDebug = vi.fn();
 const mockLoggerWarn = vi.fn();
 vi.mock("consola", () => ({
   consola: {
+    level: 0,
     withTag: () => ({ debug: mockLoggerDebug, warn: mockLoggerWarn }),
   },
+  LogLevels: { debug: 4 },
 }));
 
 //#endregion
@@ -131,6 +133,22 @@ function setupDefaultMocks() {
     if (p.includes("gradle.properties")) {
       return "org.gradle.jvmargs=-Xmx2048m";
     }
+    if (p.includes("styles.xml")) {
+      return `<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
+        <item name="colorPrimary">@color/colorPrimary</item>
+    </style>
+    <style name="AppTheme.NoActionBar" parent="Theme.AppCompat.DayNight.NoActionBar">
+        <item name="windowActionBar">false</item>
+        <item name="windowNoTitle">true</item>
+        <item name="android:background">@null</item>
+    </style>
+    <style name="AppTheme.NoActionBarLaunch" parent="Theme.SplashScreen">
+        <item name="android:background">@drawable/splash</item>
+    </style>
+</resources>`;
+    }
     return "";
   });
 
@@ -197,7 +215,7 @@ describe("Capacitor 초기화", () => {
     setupDefaultMocks();
   });
 
-  it("최초 초기화: npm install, cap init, cap add android를 실행한다", async () => {
+  it("최초 초기화: pnpm install, cap init, cap add android를 실행한다", async () => {
     let androidAdded = false;
     mockFsxExists.mockImplementation((p: string) => {
       const n = p.replace(/\\/g, "/");
@@ -220,18 +238,18 @@ describe("Capacitor 초기화", () => {
     });
     await cap.initialize();
 
-    expect(execaCalls.some((c) => c.command === "npm" && c.args.includes("install"))).toBe(true);
+    expect(execaCalls.some((c) => c.command === "pnpm" && c.args.includes("install"))).toBe(true);
     expect(
-      execaCalls.some((c) => c.command === "npx" && c.args.includes("cap") && c.args.includes("init")),
+      execaCalls.some((c) => c.command === "pnpm" && c.args.includes("cap") && c.args.includes("init")),
     ).toBe(true);
     expect(
       execaCalls.some(
-        (c) => c.command === "npx" && c.args.includes("cap") && c.args.includes("add"),
+        (c) => c.command === "pnpm" && c.args.includes("cap") && c.args.includes("add"),
       ),
     ).toBe(true);
   });
 
-  it("재초기화: 설정 미변경 시 npm install을 건너뛴다", async () => {
+  it("재초기화: 설정 미변경 시 pnpm install을 건너뛴다", async () => {
     const { Capacitor } = await import("../../src/capacitor/capacitor.js");
     const cap = await Capacitor.create(PKG_PATH, {
       appId: "com.test.app",
@@ -240,10 +258,10 @@ describe("Capacitor 초기화", () => {
     });
     await cap.initialize();
 
-    expect(execaCalls.some((c) => c.command === "npm" && c.args.includes("install"))).toBe(false);
+    expect(execaCalls.some((c) => c.command === "pnpm" && c.args.includes("install"))).toBe(false);
   });
 
-  it("플러그인 추가: package.json에 플러그인을 추가하고 npm install을 실행한다", async () => {
+  it("플러그인 추가: package.json에 플러그인을 추가하고 pnpm install을 실행한다", async () => {
     const { Capacitor } = await import("../../src/capacitor/capacitor.js");
 
     // 클라이언트 패키지의 deps에 플러그인 포함
@@ -531,6 +549,102 @@ describe("Android 네이티브 설정", () => {
     expect(manifestWrite).toBeDefined();
   });
 
+  it("styles.xml의 Theme.SplashScreen parent를 변경하고 android:background를 android:windowBackground로 변경한다", async () => {
+    const { Capacitor } = await import("../../src/capacitor/capacitor.js");
+    const cap = await Capacitor.create(PKG_PATH, {
+      appId: "com.test.app",
+      appName: "Test App",
+      platform: { android: {} },
+    });
+    await cap.initialize();
+
+    const writeCalls = mockFsxWrite.mock.calls;
+    const stylesWrite = writeCalls.find(
+      (call) =>
+        typeof call[0] === "string" &&
+        call[0].includes("styles.xml") &&
+        typeof call[1] === "string" &&
+        call[1].includes('parent="Theme.AppCompat.DayNight.NoActionBar"'),
+    );
+    expect(stylesWrite).toBeDefined();
+    const content = stylesWrite![1] as string;
+    // @drawable/splash는 유지
+    expect(content).toContain("@drawable/splash");
+    // Theme.SplashScreen은 제거됨
+    expect(content).not.toContain('parent="Theme.SplashScreen"');
+    // android:background → android:windowBackground로 변경됨
+    expect(content).toContain('"android:windowBackground">@drawable/splash');
+    expect(content).not.toContain('"android:background">@drawable/splash');
+  });
+
+  it("이미 변경된 styles.xml은 재변경하지 않는다", async () => {
+    mockFsxRead.mockImplementation((p: string) => {
+      if (p.includes("styles.xml")) {
+        return `<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="AppTheme.NoActionBarLaunch" parent="Theme.AppCompat.DayNight.NoActionBar">
+        <item name="android:windowBackground">@drawable/splash</item>
+    </style>
+</resources>`;
+      }
+      if (p.includes("AndroidManifest.xml")) {
+        return '<manifest xmlns:android="http://schemas.android.com/apk/res/android">\n<application>\n<activity android:name=".MainActivity">\n</activity>\n</application>\n</manifest>';
+      }
+      if (p.includes("build.gradle")) {
+        return `android {
+    defaultConfig {
+        versionCode 1
+        versionName "1.0"
+        minSdkVersion rootProject.ext.minSdkVersion
+        targetSdkVersion rootProject.ext.targetSdkVersion
+    }
+    buildTypes { release { } }
+}`;
+      }
+      if (p.includes("gradle.properties")) {
+        return "org.gradle.jvmargs=-Xmx2048m";
+      }
+      return "";
+    });
+
+    const { Capacitor } = await import("../../src/capacitor/capacitor.js");
+    const cap = await Capacitor.create(PKG_PATH, {
+      appId: "com.test.app",
+      appName: "Test App",
+      platform: { android: {} },
+    });
+    await cap.initialize();
+
+    const writeCalls = mockFsxWrite.mock.calls;
+    const stylesWrite = writeCalls.find(
+      (call) =>
+        typeof call[0] === "string" &&
+        call[0].includes("styles.xml"),
+    );
+    expect(stylesWrite).toBeUndefined();
+  });
+
+  it("styles.xml이 없으면 warn을 출력한다", async () => {
+    mockFsxExists.mockImplementation((p: string) => {
+      const n = p.replace(/\\/g, "/");
+      if (n.includes(".capacitor.lock")) return false;
+      if (n.includes("styles.xml")) return false;
+      return true;
+    });
+
+    const { Capacitor } = await import("../../src/capacitor/capacitor.js");
+    const cap = await Capacitor.create(PKG_PATH, {
+      appId: "com.test.app",
+      appName: "Test App",
+      platform: { android: {} },
+    });
+    await cap.initialize();
+
+    expect(mockLoggerWarn).toHaveBeenCalledWith(
+      expect.stringContaining("styles.xml"),
+    );
+  });
+
   it("application 태그에 커스텀 속성을 추가한다", async () => {
     const { Capacitor } = await import("../../src/capacitor/capacitor.js");
     const cap = await Capacitor.create(PKG_PATH, {

package/tests/capacitor/capacitor-run.spec.ts

@@ -27,8 +27,8 @@ vi.mock("@simplysm/core-node", () => ({
     copy: mockFsxCopy,
   },
   cpx: {
-    exec: mockCpxExec,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mockCpxSpawn,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
   pathx: {
     posixResolve: (...args: string[]) => path.resolve(...args).replace(/\\/g, "/"),
@@ -49,7 +49,7 @@ const execaCalls: { command: string; args: string[] }[] = [];
 let execaFactory: (...args: unknown[]) => Promise<{ stdout: string; stderr: string; exitCode: number }> = () =>
   Promise.resolve({ stdout: "", stderr: "", exitCode: 0 });
 
-const mockCpxExec = vi.fn((...args: unknown[]) => {
+const mockCpxSpawn = vi.fn((...args: unknown[]) => {
   execaCalls.push({ command: args[0] as string, args: (args[1] as string[] | undefined) ?? [] });
   return execaFactory(...args);
 });
@@ -84,7 +84,9 @@ vi.mock("consola", () => ({
       warn: mockLoggerWarn,
       info: vi.fn(),
     }),
+    level: 0,
   },
+  LogLevels: { debug: 4 },
 }));
 
 //#endregion
@@ -175,14 +177,14 @@ describe("Capacitor.run()", () => {
 
     // cap copy android + cap run android
     const capCmds = execaCalls.filter(
-      (c) => c.command === "npx" && c.args.includes("cap"),
+      (c) => c.command === "pnpm" && c.args.includes("cap"),
     );
     expect(capCmds.some((c) => c.args.includes("copy") && c.args.includes("android"))).toBe(true);
     expect(capCmds.some((c) => c.args.includes("run") && c.args.includes("android"))).toBe(true);
   });
 
-  // Unit: adb kill-server retry on cap run failure
-  it("retries cap run after adb kill-server on android platform failure", async () => {
+  // Unit: cap run 실패 시 adb kill-server 호출 후 에러를 re-throw한다
+  it("calls adb kill-server and re-throws on android platform cap run failure", async () => {
     const { Capacitor } = await import("../../src/capacitor/capacitor.js");
 
     let capRunCallCount = 0;
@@ -191,16 +193,13 @@ describe("Capacitor.run()", () => {
       const cmdArgs = (args[1] as string[] | undefined) ?? [];
 
       if (
-        cmd === "npx" &&
+        cmd === "pnpm" &&
         cmdArgs.includes("cap") &&
         cmdArgs.includes("run") &&
         cmdArgs.includes("android")
       ) {
         capRunCallCount++;
-        if (capRunCallCount === 1) {
-          // First cap run fails
-          return Promise.reject(new Error("cap run failed"));
-        }
+        return Promise.reject(new Error("cap run failed"));
       }
       return Promise.resolve({ stdout: "", stderr: "", exitCode: 0 });
     };
@@ -211,16 +210,14 @@ describe("Capacitor.run()", () => {
       platform: { android: {} },
     });
 
-    await cap.run("http://localhost:4200");
+    await expect(cap.run("http://localhost:4200")).rejects.toThrow("cap run failed");
 
-    // adb kill-server should have been called between the two cap run attempts
+    // adb kill-server should have been called
     expect(
       execaCalls.some((c) => c.command === "adb" && c.args.includes("kill-server")),
     ).toBe(true);
-    expect(capRunCallCount).toBe(2);
-    expect(mockLoggerWarn).toHaveBeenCalledWith(
-      expect.stringContaining("adb kill-server"),
-    );
+    // cap run은 한 번만 호출 (재시도 없음)
+    expect(capRunCallCount).toBe(1);
   });
 
   // Unit: _updateServerUrl replaces existing url

package/tests/capacitor/capacitor-workspace.spec.ts

@@ -26,8 +26,8 @@ vi.mock("@simplysm/core-node", () => ({
     copy: mockFsxCopy,
   },
   cpx: {
-    exec: mockCpxExec,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mockCpxSpawn,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
   pathx: {
     posixResolve: (...args: string[]) => path.resolve(...args).replace(/\\/g, "/"),
@@ -43,7 +43,7 @@ vi.mock("@simplysm/core-common", () => ({
 }));
 
 const execaCalls: { command: string; args: string[] }[] = [];
-const mockCpxExec = vi.fn((...args: unknown[]) => {
+const mockCpxSpawn = vi.fn((...args: unknown[]) => {
   execaCalls.push({ command: args[0] as string, args: (args[1] as string[] | undefined) ?? [] });
   return Promise.resolve({ stdout: "", stderr: "", exitCode: 0 });
 });
@@ -75,7 +75,9 @@ vi.mock("fs/promises", () => ({
 vi.mock("consola", () => ({
   consola: {
     withTag: () => ({ debug: vi.fn(), warn: vi.fn() }),
+    level: 0,
   },
+  LogLevels: { debug: 4 },
 }));
 
 //#endregion

package/tests/commands/check.spec.ts

@@ -37,8 +37,8 @@ vi.mock("../../src/utils/sd-config", () => ({
 
 vi.mock("@simplysm/core-node", () => ({
   cpx: {
-    exec: mocks.execa,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mocks.execa,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
 }));
 

package/tests/commands/publish.spec.ts

@@ -51,8 +51,8 @@ vi.mock("../../src/utils/replace-deps", () => ({
 vi.mock("@simplysm/core-node", () => ({
   fsx: mocks.fsx,
   cpx: {
-    exec: mocks.execa,
-    execSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
+    spawn: mocks.execa,
+    spawnSync: vi.fn().mockReturnValue({ stdout: "", stderr: "", exitCode: 0 }),
   },
 }));
 

package/tests/commands/typecheck.spec.ts

@@ -493,6 +493,14 @@ describe("executeTypecheck", () => {
 
   //#endregion
 
+  it("throws when loadSdConfig fails (fail fast)", async () => {
+    mocks.loadSdConfig.mockRejectedValue(new Error("sd.config.ts not found"));
+    mocks.discoverWorkspacePackages.mockReturnValue(new Map());
+    mocks.mergeTestsPackagesIntoConfig.mockReturnValue({ merged: {}, pathMap: new Map() });
+
+    await expect(executeTypecheck({ targets: [], options: [] })).rejects.toThrow("sd.config.ts not found");
+  });
+
   //#region Slice 1: executeTypecheck lint integration (Feature 3.2)
 
   describe("lint integration", () => {