@simplysm/sd-cli 14.2.2 → 14.2.4

package/src/commands/init/init-client.ts

@@ -59,7 +59,7 @@ export async function runInitClient(opts: InitClientOptions): Promise<void> {
   const needsAppStructure = data.hasAuth && client.hasRouter;
 
   //-- 기존 라우팅 클라이언트 0개면 기본 메뉴 구조 export("appStructureItems")는
-  //   파일에 남기되 서버 초기화의 import·권한 계산에서 신규 export 로 대체 (init 동등)
+  //   파일에 남기되 서버 초기화의 import, 권한 계산에서 신규 export 로 대체 (init 동등)
   const isFirstRouterClient = recovered.input.clients.every((c) => !c.hasRouter);
   const fallbackExportName =
     isFirstRouterClient && recovered.appStructureExportNames.includes("appStructureItems")

package/src/commands/init/patch.ts

@@ -225,7 +225,7 @@ export function patchDevService(
   existingExportNames: string[],
   data: RenderData,
   client: ClientSpec,
-  /** 권한 계산·import 에서 신규 export 로 대체할 기본 export 이름 (기존 라우팅 클라이언트 0개 케이스) */
+  /** 권한 계산, import 에서 신규 export 로 대체할 기본 export 이름 (기존 라우팅 클라이언트 0개 케이스) */
   replaceExportName?: string,
 ): FilePatch {
   const combinedNames = [...existingExportNames, client.appStructureName];

package/src/commands/init/templates/client/src/app/home/master/role-permission/role-permission.view.ts.hbs

@@ -85,7 +85,7 @@ export class RolePermissionView {
 
   detail = viewChild(RolePermissionDetail);
 
-  // 미저장 권한 변경 보호: 페이지 이탈·역할 전환 전에 자식 detail 의 변경 가드 확인
+  // 미저장 권한 변경 보호: 페이지 이탈, 역할 전환 전에 자식 detail 의 변경 가드 확인
   protected readonly checkCanLeave = (): boolean => {
     const detail = this.detail();
     return detail == null || detail.checkIgnoreChanges();

package/src/commands/init/templates/client/src/app/home/master/role-permission/role.list.ts.hbs

@@ -248,7 +248,7 @@ export class RoleList implements SdModalContentDef<SelectModalOutputResult<numbe
 
     this.busyCount.update((v) => v + 1);
     await this._sdToast.try(async () => {
-      // 파생 컬럼(수정일시·수정자)은 업로드에서 제외하고 파싱. 삭제 여부는 읽어서 반영.
+      // 파생 컬럼(수정일시, 수정자)은 업로드에서 제외하고 파싱. 삭제 여부는 읽어서 반영.
       const records = await this._excelWrapper.read(files[0], 0, {
         excludes: ["lastModifiedAt", "lastModifiedBy"],
       });
@@ -448,7 +448,7 @@ export class RoleList implements SdModalContentDef<SelectModalOutputResult<numbe
           .update(() => ({ isDeleted: false }));
 
         // 복구 후 이름 비삭제 유니크 재검증 — 복구로 활성 중복이 생겼으면 throw(트랜잭션 롤백).
-        // 대상끼리 충돌·기존 활성과의 충돌을 복구한 이름으로 한정해 한 번에 검사.
+        // 대상끼리 충돌, 기존 활성과의 충돌을 복구한 이름으로 한정해 한 번에 검사.
         const conflicts = await db
           .role()
           .where((c) => [expr.in(c.name, names), expr.eq(c.isDeleted, false)])

package/src/commands/init/templates/client/src/app/home/master/user.detail.ts.hbs

@@ -281,7 +281,7 @@ export class {{userEntityPascal}}Detail implements SdModalContentDef<{ id: numbe
       });
 
       await this._appSharedData.emitAsync("{{userEntityLabel}}", [{{userEntityCamel}}Id]);
-      // 복구된 {{userEntityLabel}} 세션에 인증정보 변경 통지 → authInfo·권한 재로드
+      // 복구된 {{userEntityLabel}} 세션에 인증정보 변경 통지 → authInfo, 권한 재로드
       await this._appService.authInfoChangedEvent.emit((info) => info.{{userEntityCamel}}Id === {{userEntityCamel}}Id, undefined);
       this._sdToast.success("복구되었습니다.");
       await this._refresh();

package/src/commands/init/templates/client/src/app/home/master/user.list.ts.hbs

@@ -278,7 +278,7 @@ export class {{userEntityPascal}}List {
 
     this.busyCount.update((v) => v + 1);
     await this._sdToast.try(async () => {
-      // 파생 컬럼(수정일시·수정자)은 업로드에서 제외하고 파싱. 삭제 여부는 읽어서 반영.
+      // 파생 컬럼(수정일시, 수정자)은 업로드에서 제외하고 파싱. 삭제 여부는 읽어서 반영.
       const records = await this._excelWrapper.read(files[0], 0, {
         excludes: ["lastModifiedAt", "lastModifiedBy"],
       });
@@ -440,7 +440,7 @@ export class {{userEntityPascal}}List {
           .update(() => ({ isDeleted: false }));
 
         // 복구 후 이름 비삭제 유니크 재검증 — 복구로 활성 중복이 생겼으면 throw(트랜잭션 롤백).
-        // 대상끼리 충돌·기존 활성과의 충돌을 복구한 이름으로 한정해 한 번에 검사.
+        // 대상끼리 충돌, 기존 활성과의 충돌을 복구한 이름으로 한정해 한 번에 검사.
         const conflicts = await db
           .{{userEntityCamel}}()
           .where((c) => [expr.in(c.name, names), expr.eq(c.isDeleted, false)])
@@ -458,7 +458,7 @@ export class {{userEntityPascal}}List {
         }
       });
       await this._appSharedData.emitAsync("{{userEntityLabel}}", ids);
-      // 복구된 {{userEntityLabel}} 세션에 인증정보 변경 통지 → authInfo·권한 재로드
+      // 복구된 {{userEntityLabel}} 세션에 인증정보 변경 통지 → authInfo, 권한 재로드
       await this._appService.authInfoChangedEvent.emit((info) => ids.includes(info.{{userEntityCamel}}Id), undefined);
       this._sdToast.success("복구되었습니다.");
       await this._refresh();

package/src/commands/init/templates/client/src/main.server.ts.hbs

@@ -6,7 +6,7 @@ import { provideSdAngular } from "@simplysm/angular";
 import { AppRoot } from "./app.root";
 import { routes } from "./routes";
 
-// 프리렌더(빌드 시점) 전용 부트스트랩 — 서버 연결·로그 배선 등 브라우저 전용 초기화는 제외
+// 프리렌더(빌드 시점) 전용 부트스트랩 — 서버 연결, 로그 배선 등 브라우저 전용 초기화는 제외
 const bootstrap = (context: BootstrapContext) =>
   bootstrapApplication(
     AppRoot,

package/src/commands/init/templates/server/src/services/user.service.ts.hbs

@@ -82,7 +82,7 @@ export const {{userEntityPascal}}Service = defineService("{{userEntityPascal}}Se
         const activeNames: string[] = [];
 
         for (const { id, name, loginId, roleId, password, isDeleted } of rows) {
-          // 수정 대상이면 기존 레코드 확인 — id 존재 강제 + 불변식·이력전이 판정에 기존 상태 필요.
+          // 수정 대상이면 기존 레코드 확인 — id 존재 강제 + 불변식, 이력전이 판정에 기존 상태 필요.
           let existingEncryptedPassword: string | undefined;
           let existingIsDeleted: boolean | undefined;
           if (id != null) {
@@ -108,7 +108,7 @@ export const {{userEntityPascal}}Service = defineService("{{userEntityPascal}}Se
             activeNames.push(name);
           }
 
-          // 불변식: 로그인ID 가 있으면 역할·비밀번호 필수 (비번은 이번 입력 또는 수정 시 기존 해시로 충족).
+          // 불변식: 로그인ID 가 있으면 역할, 비밀번호 필수 (비번은 이번 입력 또는 수정 시 기존 해시로 충족).
           if (loginId != null) {
             if (roleId == null) {
               throw new Error(`${label(name)}로그인ID가 있으면 역할이 필수입니다.`);
@@ -187,7 +187,7 @@ export const {{userEntityPascal}}Service = defineService("{{userEntityPascal}}Se
       });
 
       // 저장으로 역할/로그인ID/비밀번호가 바뀌었을 수 있으므로, 저장된 각 사용자 세션에 인증정보 변경 통지
-      // → 해당 세션이 authInfo·권한을 재로드. roleId 는 이번 저장으로 바뀔 수 있어 {{userEntityCamel}}Id 로 타겟.
+      // → 해당 세션이 authInfo, 권한을 재로드. roleId 는 이번 저장으로 바뀔 수 있어 {{userEntityCamel}}Id 로 타겟.
       for (const { id } of saved) {
         await ctx.server.emitEvent(
           AuthInfoChangedEvent,

package/src/commands/init/templates/workspace-root/package.json.hbs

@@ -32,7 +32,7 @@
     "@vitest/coverage-v8": "^4.1.0",
     "eslint": "^10.6.0",
     "jiti": "^2.7.0",
-    "prettier": "^3.8.0",
+    "oxfmt": "^0.59.0",
     "typescript": "~6.0.0",
     "vite": "^8.1.0",
     "vitest": "^4.1.0"

package/src/commands/publish/git-phase.ts

@@ -5,7 +5,7 @@ import { err as errNs } from "@simplysm/core-common";
 /**
  * 워킹트리에 미커밋 변경사항이 있으면 throw 한다.
  * 배포는 깨끗한 워킹트리에서만 진행한다 — 커밋은 사용자가 직접 수행해야 한다.
- * @throws 미커밋(unstaged·staged) 변경사항이 있을 때 Error
+ * @throws 미커밋(unstaged, staged) 변경사항이 있을 때 Error
  */
 export async function ensureCleanWorkingTree(
   hasGit: boolean,

package/src/deps/replace-deps/collect-deps.ts

@@ -12,7 +12,7 @@ export interface DepsResult {
 
 /**
  * pnpm-workspace.yaml 기반으로 packages/(배포 대상) 패키지의 name → 상대 디렉토리 맵을 구성한다.
- * packages/ 가 아닌 워크스페이스(tests/·plugins/ 등)는 제외된다.
+ * packages/ 가 아닌 워크스페이스(tests/, plugins/ 등)는 제외된다.
  * 예: "@simplysm/core-node" → "packages/core-node"
  */
 function buildWorkspacePkgMap(cwd: string): Map<string, string> {

package/src/deps/server-externals/server-production-files.ts

@@ -31,7 +31,7 @@ export function collectAllExternals(
 
 /**
  * pnpm-lock.yaml의 packages 섹션을 파싱하여 name→version 맵을 생성한다.
- * 키 형태: "name@version" · "@scope/name@version" · "name@version(peer@ver)..."
+ * 키 형태: "name@version",  "@scope/name@version",  "name@version(peer@ver)..."
  */
 export function parseLockfileVersions(cwd: string): Map<string, string> {
   const lockfilePath = path.join(cwd, "pnpm-lock.yaml");

package/src/esbuild/esbuild-client-config.ts

@@ -175,7 +175,7 @@ export async function createClientEsbuildContext(
     entryNames: isDev ? "[name]" : "[name]-[hash]",
     chunkNames: "[name]-[hash]",
     assetNames: isDev ? "[name]" : "[name]-[hash]",
-    // CSS/SCSS url() 로 참조하는 폰트·이미지 자산을 outdir로 복사하고 url을 출력 경로로 재작성.
+    // CSS/SCSS url() 로 참조하는 폰트, 이미지 자산을 outdir로 복사하고 url을 출력 경로로 재작성.
     // esbuild 기본 loader 맵에는 js/ts/css/json/text만 있어, 미설정 시 url(*.woff) 등에서
     // "No loader is configured" 에러가 발생한다.
     loader: {

package/src/esbuild/esbuild-worker-plugin.ts

@@ -226,7 +226,7 @@ export function transformWorkerPatterns(
   options?: TransformWorkerOptions,
 ): TransformWorkerResult | undefined {
   // 빠른 사전 필터 — new Worker(), new SharedWorker(), import.meta.resolve()의 단어 경계
-  // 호출 형태만 통과시킨다. 식별자·타입·interface로만 등장하는 Worker 키워드는 차단하여
+  // 호출 형태만 통과시킨다. 식별자, 타입, interface로만 등장하는 Worker 키워드는 차단하여
   // TS transformSync 오버헤드를 줄인다. 정확성은 후속 AST 판별(findWorkerPatterns)이 담당한다.
   // new 와 Worker/SharedWorker 사이에 주석이 낀 호출(예: `new /* c */ Worker`)은 의도된
   // 트레이드오프로 탈락한다. 실발생 가능성이 희박하여 현행을 유지한다.

package/src/orchestrators/BuildOrchestrator.ts

@@ -11,7 +11,12 @@ import { getVersion } from "../utils/build-env";
 import { copySrcFiles } from "../utils/copy-src";
 import { formatBuildMessages } from "../utils/output-utils";
 import { createBuildEngine } from "../engines/engine-factory";
-import type { BuildOutput, BuildPackageInfo, ClientPackageInfo, ServerPackageInfo } from "../engines/types";
+import type {
+  BuildOutput,
+  BuildPackageInfo,
+  ClientPackageInfo,
+  ServerPackageInfo,
+} from "../engines/types";
 import { runWithConcurrency, getMaxConcurrency } from "../utils/concurrency";
 import { iteratePackages } from "../utils/package-classify";
 import { Capacitor } from "../capacitor/capacitor";
@@ -99,7 +104,9 @@ export function classifyPackages(
  * dist 폴더 삭제
  */
 async function cleanDistFolders(cwd: string, packageNames: string[]): Promise<void> {
-  await Promise.all(packageNames.map((name) => fsx.rm(pathx.posixResolve(cwd, "packages", name, "dist"))));
+  await Promise.all(
+    packageNames.map((name) => fsx.rm(pathx.posixResolve(cwd, "packages", name, "dist"))),
+  );
 }
 
 //#endregion
@@ -280,8 +287,7 @@ export class BuildOrchestrator implements OrchestratorLifecycle<boolean> {
         type: "build",
         success: engineResult.build.success,
         errors: engineResult.build.errors.length > 0 ? engineResult.build.errors : undefined,
-        warnings:
-          engineResult.build.warnings.length > 0 ? engineResult.build.warnings : undefined,
+        warnings: engineResult.build.warnings.length > 0 ? engineResult.build.warnings : undefined,
       };
     } finally {
       await engine.stop();
@@ -365,9 +371,8 @@ export class BuildOrchestrator implements OrchestratorLifecycle<boolean> {
         this._logger.debug(`[${name}] (client) 빌드 시작`);
         const pkgDir = pathx.posixResolve(this._cwd, "packages", name);
         const isNativeBuild = config.capacitor != null || config.electron != null;
-        const outDir = config.capacitor != null
-          ? pathx.posixResolve(pkgDir, ".capacitor/www")
-          : undefined;
+        const outDir =
+          config.capacitor != null ? pathx.posixResolve(pkgDir, ".capacitor/www") : undefined;
 
         const result = await this._runEngineTask({
           name,
@@ -446,10 +451,7 @@ export class BuildOrchestrator implements OrchestratorLifecycle<boolean> {
    *
    * @returns 에러 발생 여부 (true: 에러 있음)
    */
-  private _printBuildResults(
-    results: BuildStepResult[],
-    hasUntrackedError: boolean,
-  ): boolean {
+  private _printBuildResults(results: BuildStepResult[], hasUntrackedError: boolean): boolean {
     for (const result of results) {
       const typeLabel = result.type === "lint" ? "lint" : result.target;
 

package/src/orchestrators/TypecheckOrchestrator.ts

@@ -54,7 +54,7 @@ export interface TypecheckResult {
 const TARGET_PATH_PATTERN = /^[^/]+\/([^/]+)/;
 
 /**
- * 대상 경로에서 패키지명을 추출한다. 워크스페이스 종류(packages/·tests/·plugins/ 등)를 가리지 않는다.
+ * 대상 경로에서 패키지명을 추출한다. 워크스페이스 종류(packages/, tests/, plugins/ 등)를 가리지 않는다.
  * "packages/core-common" → "core-common"
  * "tests/orm" → "orm"
  * "plugins/sd" → "sd"

package/src/runtime/ResultCollector.ts

@@ -12,7 +12,7 @@ export interface BuildResult {
 }
 
 /**
- * 빌드 결과를 수집·관리하는 클래스
+ * 빌드 결과를 수집, 관리하는 클래스
  *
  * 여러 Builder의 빌드 결과를 중앙에서 관리하며,
  * 상태별 필터링 및 출력 기능을 제공한다.

package/src/sd-config.types.ts

@@ -32,7 +32,10 @@ export interface SdNpmPublishConfig {
  * - SdLocalDirectoryPublishConfig: 로컬 디렉토리로 복사
  * - SdStoragePublishConfig: FTP/FTPS/SFTP 서버에 업로드
  */
-export type SdPublishConfig = SdNpmPublishConfig | SdLocalDirectoryPublishConfig | SdStoragePublishConfig;
+export type SdPublishConfig =
+  | SdNpmPublishConfig
+  | SdLocalDirectoryPublishConfig
+  | SdStoragePublishConfig;
 
 /**
  * 로컬 디렉토리 배포 설정

package/src/typecheck/typecheck-non-package.ts

@@ -28,7 +28,7 @@ export function typecheckNonPackageFiles(cwd: string): NonPackageTypecheckResult
   const parsedConfig = parseTsconfig(cwd);
   const packagesDir = path.join(cwd, "packages");
 
-  // packages/(배포 대상)가 아닌 워크스페이스(tests/·plugins/·향후 추가분)는 각자 엔진 타입체크가
+  // packages/(배포 대상)가 아닌 워크스페이스(tests/, plugins/, 향후 추가분)는 각자 엔진 타입체크가
   // 자기 tsconfig로 담당하므로 루트 sweep에서 제외한다. 루트 tsconfig로 검사하면 그 워크스페이스
   // 고유 옵션(allowImportingTsExtensions 등)이 무시돼 거짓 에러가 난다. 디렉터리명에 의존하지 않는다.
   const nonDeployWorkspaceDirs = collectWorkspacePackages(cwd)

package/src/utils/import-config-module.ts

@@ -1,7 +1,7 @@
 import { pathToFileURL } from "node:url";
 
 /**
- * 워크스페이스 TS 설정 파일(`sd.config.ts`·`eslint.config.ts` 등)을 동적 import 한다.
+ * 워크스페이스 TS 설정 파일(`sd.config.ts`, `eslint.config.ts` 등)을 동적 import 한다.
  *
  * - `.ts` 로딩은 실행 런타임(개발: tsx, 프로덕션: Node 의 native type-stripping)에 위임한다.
  *   별도 트랜스파일러(jiti)를 직접 의존하지 않는다 — jiti 는 워크스페이스(루트 / init 템플릿)가 제공.

package/src/utils/package-utils.ts

@@ -22,7 +22,7 @@ export function findPackageRoot(startDir: string): string {
 /**
  * pnpm-workspace.yaml의 모든 워크스페이스 패키지를 탐색한다.
  * 디렉토리명 → 상대 경로의 맵을 반환한다 (예: "orm" → "tests/orm", "sd" → "plugins/sd").
- * packages/·tests/·plugins/ 등 종류를 가리지 않고 포함하며, 배포/검사 대상 구분은 소비자가 relPath로 판단한다.
+ * packages/, tests/, plugins/ 등 종류를 가리지 않고 포함하며, 배포/검사 대상 구분은 소비자가 relPath로 판단한다.
  */
 export function discoverWorkspacePackages(cwd: string): Map<string, string> {
   logger.debug("워크스페이스 패키지 탐색 시작");
@@ -63,7 +63,7 @@ export function buildPathMapFromConfig(
 }
 
 /**
- * workspace에서 발견된 비배포 워크스페이스(packages/ 가 아닌 tests/·plugins/ 등)를 sd.config.ts
+ * workspace에서 발견된 비배포 워크스페이스(packages/ 가 아닌 tests/, plugins/ 등)를 sd.config.ts
  * 패키지에 병합한다. 이들은 빌드 대상이 아니지만 각자 자기 tsconfig로 타입체크하기 위해
  * `{ target: "node" }`가 할당된다. 모든 패키지의 pathMap(name → 상대 경로)도 함께 구성한다.
  * 디렉터리명이 sd.config.ts 패키지명과 충돌하면 SdError를 던진다.

package/tests/capacitor/capacitor-npm-config.spec.ts

@@ -1,94 +1,106 @@
-import { describe, it, expect, vi, beforeAll, afterAll, beforeEach } from "vitest";
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { fsx, cpx } from "@simplysm/core-node";
-
-const mockFsxExists = vi.spyOn(fsx, "exists");
-vi.spyOn(fsx, "write").mockResolvedValue(undefined);
-const mockFsxReadJson = vi.spyOn(fsx, "readJson");
-vi.spyOn(fsx, "writeJson").mockResolvedValue(undefined);
-vi.spyOn(fsx, "mkdir").mockResolvedValue(undefined);
-vi.spyOn(fsx, "read");
-
-vi.spyOn(cpx, "spawn").mockResolvedValue({ stdout: "", stderr: "", exitCode: 0 });
-
-let tmpRoot: string;
-let CAP_PATH: string;
-let PKG_PATH: string;
-
-beforeAll(() => {
-  tmpRoot = mkdtempSync(path.join(tmpdir(), "cap-npm-config-"));
-  writeFileSync(path.join(tmpRoot, "package.json"), JSON.stringify({ private: true, workspaces: ["pkg"] }));
-  PKG_PATH = path.join(tmpRoot, "pkg");
-  CAP_PATH = path.join(PKG_PATH, ".capacitor");
-});
-
-afterAll(() => {
-  rmSync(tmpRoot, { recursive: true, force: true });
-});
-
-describe("setupCapNpmConfig", () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    mockFsxExists.mockResolvedValue(true);
-    mockFsxReadJson.mockImplementation(((p: string) => {
-      const normalized = p.replace(/\\/g, "/");
-      if (normalized.includes(".capacitor/package.json")) {
-        return {
-          name: "com.test.app",
-          version: "1.0.0",
-          dependencies: {
-            "@capacitor/core": "^7",
-            "@capacitor/app": "^7",
-            "@capacitor/android": "^7",
-          },
-          devDependencies: {
-            "@capacitor/cli": "^7",
-            "@capacitor/assets": "^3",
-          },
-        };
-      }
-      return { name: "test-pkg", version: "1.0.0" };
-    }) as never);
-  });
-
-  it("루트 package.json이 없으면 에러를 던진다", async () => {
-    mockFsxExists.mockImplementation(((p: string) => {
-      const n = p.replace(/\\/g, "/");
-      if (n.endsWith("package.json") && !n.includes(".capacitor")) return false;
-      return true;
-    }) as never);
-
-    const { setupCapNpmConfig } = await import(
-      "../../src/capacitor/capacitor-npm-config.js"
-    );
-
-    await expect(
-      setupCapNpmConfig(CAP_PATH, PKG_PATH, {
-        appId: "com.test.app",
-        appName: "Test App",
-      }, { name: "test-pkg", version: "1.0.0" }, [], []),
-    ).rejects.toThrow("루트 package.json");
-  });
-
-  it(".capacitor/package.json이 없으면 빈 설정으로 시작한다", async () => {
-    mockFsxExists.mockImplementation(((p: string) => {
-      const n = p.replace(/\\/g, "/");
-      if (n.includes(".capacitor/package.json")) return false;
-      return true;
-    }) as never);
-
-    const { setupCapNpmConfig } = await import(
-      "../../src/capacitor/capacitor-npm-config.js"
-    );
-
-    const changed = await setupCapNpmConfig(CAP_PATH, PKG_PATH, {
-      appId: "com.test.app",
-      appName: "Test App",
-    }, { name: "test-pkg", version: "1.0.0" }, [], []);
-
-    // 빈 설정에서 시작하므로 dependencies가 추가되어 변경됨
-    expect(changed).toBe(true);
-  });
-});
+import { describe, it, expect, vi, beforeAll, afterAll, beforeEach } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { fsx, cpx } from "@simplysm/core-node";
+
+const mockFsxExists = vi.spyOn(fsx, "exists");
+vi.spyOn(fsx, "write").mockResolvedValue(undefined);
+const mockFsxReadJson = vi.spyOn(fsx, "readJson");
+vi.spyOn(fsx, "writeJson").mockResolvedValue(undefined);
+vi.spyOn(fsx, "mkdir").mockResolvedValue(undefined);
+vi.spyOn(fsx, "read");
+
+vi.spyOn(cpx, "spawn").mockResolvedValue({ stdout: "", stderr: "", exitCode: 0 });
+
+let tmpRoot: string;
+let CAP_PATH: string;
+let PKG_PATH: string;
+
+beforeAll(() => {
+  tmpRoot = mkdtempSync(path.join(tmpdir(), "cap-npm-config-"));
+  // 워크스페이스 루트 판정은 pnpm-workspace.yaml 기반
+  writeFileSync(path.join(tmpRoot, "pnpm-workspace.yaml"), "packages:\n  - pkg\n");
+  writeFileSync(path.join(tmpRoot, "package.json"), JSON.stringify({ private: true }));
+  PKG_PATH = path.join(tmpRoot, "pkg");
+  CAP_PATH = path.join(PKG_PATH, ".capacitor");
+});
+
+afterAll(() => {
+  rmSync(tmpRoot, { recursive: true, force: true });
+});
+
+describe("setupCapNpmConfig", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockFsxExists.mockResolvedValue(true);
+    mockFsxReadJson.mockImplementation(((p: string) => {
+      const normalized = p.replace(/\\/g, "/");
+      if (normalized.includes(".capacitor/package.json")) {
+        return {
+          name: "com.test.app",
+          version: "1.0.0",
+          dependencies: {
+            "@capacitor/core": "^7",
+            "@capacitor/app": "^7",
+            "@capacitor/android": "^7",
+          },
+          devDependencies: {
+            "@capacitor/cli": "^7",
+            "@capacitor/assets": "^3",
+          },
+        };
+      }
+      return { name: "test-pkg", version: "1.0.0" };
+    }) as never);
+  });
+
+  it("루트 package.json이 없으면 에러를 던진다", async () => {
+    mockFsxExists.mockImplementation(((p: string) => {
+      const n = p.replace(/\\/g, "/");
+      if (n.endsWith("package.json") && !n.includes(".capacitor")) return false;
+      return true;
+    }) as never);
+
+    const { setupCapNpmConfig } = await import("../../src/capacitor/capacitor-npm-config.js");
+
+    await expect(
+      setupCapNpmConfig(
+        CAP_PATH,
+        PKG_PATH,
+        {
+          appId: "com.test.app",
+          appName: "Test App",
+        },
+        { name: "test-pkg", version: "1.0.0" },
+        [],
+        [],
+      ),
+    ).rejects.toThrow("루트 package.json");
+  });
+
+  it(".capacitor/package.json이 없으면 빈 설정으로 시작한다", async () => {
+    mockFsxExists.mockImplementation(((p: string) => {
+      const n = p.replace(/\\/g, "/");
+      if (n.includes(".capacitor/package.json")) return false;
+      return true;
+    }) as never);
+
+    const { setupCapNpmConfig } = await import("../../src/capacitor/capacitor-npm-config.js");
+
+    const changed = await setupCapNpmConfig(
+      CAP_PATH,
+      PKG_PATH,
+      {
+        appId: "com.test.app",
+        appName: "Test App",
+      },
+      { name: "test-pkg", version: "1.0.0" },
+      [],
+      [],
+    );
+
+    // 빈 설정에서 시작하므로 dependencies가 추가되어 변경됨
+    expect(changed).toBe(true);
+  });
+});

package/tests/deps/replace-deps/collect-deps.acc.spec.ts

@@ -10,10 +10,10 @@ describe("collectDeps — packages/ 외 워크스페이스 제외", () => {
 
   beforeEach(() => {
     tmpDir = pathx.posix(fs.mkdtempSync(path.join(os.tmpdir(), "sd-cli-test-")));
-    // 워크스페이스 루트 선언 (discoverWorkspacePackages는 package.json#workspaces 기반)
+    // 워크스페이스 루트 선언 (discoverWorkspacePackages는 pnpm-workspace.yaml 기반)
     fs.writeFileSync(
-      pathx.posix(path.join(tmpDir, "package.json")),
-      JSON.stringify({ private: true, workspaces: ["packages/*", "tests/*", "plugins/*"] }),
+      pathx.posix(path.join(tmpDir, "pnpm-workspace.yaml")),
+      "packages:\n  - packages/*\n  - tests/*\n  - plugins/*\n",
     );
   });
 

package/tests/esbuild/esbuild-worker-plugin.acc.spec.ts

@@ -272,7 +272,7 @@ describe("esbuild Worker Bundle Plugin — Acceptance", () => {
     const mainOutput = result.outputFiles!.find((f) => path.basename(f.path).startsWith("entry"));
     const content = mainOutput!.text;
 
-    // 브라우저 워커는 번들·치환됨
+    // 브라우저 워커는 번들, 치환됨
     expect(content).not.toContain('"./worker.js"');
     expect(content).toMatch(/worker-[A-Z0-9]+\.js/i);
     // node 워커는 그대로 남음 (browser 빌드에서 스킵)

package/tests/init/patch.spec.ts

@@ -195,7 +195,7 @@ describe("patchDevService", () => {
     expect(r.patched).toBe(expected);
   });
 
-  it("0개 → 1개 (기본 export 워크스페이스) — import·권한 인자가 신규 단독으로 대체, init 동등 결과", async () => {
+  it("0개 → 1개 (기본 export 워크스페이스) — import, 권한 인자가 신규 단독으로 대체, init 동등 결과", async () => {
     const serverOnly: InitInput = { ...baseInput, clients: [] };
     const before = buildData(serverOnly); // appStructureNames = ["appStructureItems"]
     const after = buildData({

package/tests/init/render.spec.ts

@@ -496,7 +496,7 @@ describe("client-common/src/providers/app-orm.provider.ts.hbs", () => {
     expect(out).toContain('configName: "MAIN"');
   });
 
-  it("custom dbContextName=order → OrderDbContext 가 import·DbClass 에 반영", async () => {
+  it("custom dbContextName=order → OrderDbContext 가 import, DbClass 에 반영", async () => {
     const data = buildData({
       workspaceName: "demo",
       description: "Demo",
@@ -1018,7 +1018,7 @@ describe("SSG 클라이언트 스캐폴드", () => {
     expect(out).toContain('provideSdAngular({ clientName: "client-portal" }),');
     expect(out).toContain("provideServerRendering(),");
     expect(out).toContain("export default bootstrap;");
-    // 프리렌더는 빌드 시점 — 서버 연결·로그 배선 제외
+    // 프리렌더는 빌드 시점 — 서버 연결, 로그 배선 제외
     expect(out).not.toContain("connectAsync");
   });
 });