@simplysm/sd-cli 13.0.68 → 13.0.70

package/src/orchestrators/WatchOrchestrator.ts

@@ -16,7 +16,7 @@ import type { FsWatcher } from "@simplysm/core-node";
 import type { SdBuildPackageConfig } from "../sd-config.types";
 
 /**
- * Watch 명령 옵션
+ * Watch command options
  */
 export interface WatchOrchestratorOptions {
   targets: string[];
@@ -24,11 +24,11 @@ export interface WatchOrchestratorOptions {
 }
 
 /**
- * Watch 모드 실행을 조율하는 Orchestrator
+ * Orchestrator that coordinates watch mode execution
  *
- * Library 패키지(node/browser/neutral)의 watch 모드 실행을 관리한다.
+ * Manages watch mode execution for Library packages (node/browser/neutral).
  * - LibraryBuilder: esbuild watch
- * - DtsBuilder: .d.ts 생성
+ * - DtsBuilder: .d.ts generation
  */
 export class WatchOrchestrator {
   private readonly _cwd: string;
@@ -50,15 +50,15 @@ export class WatchOrchestrator {
   }
 
   /**
-   * Orchestrator 초기화
-   * - sd.config.ts 로드
-   * - 패키지 분류
-   * - Builder 생성 및 초기화
+   * Initialize Orchestrator
+   * - Load sd.config.ts
+   * - Classify packages
+   * - Create and initialize builders
    */
   async initialize(): Promise<void> {
-    this._logger.debug("watch 시작", { targets: this._options.targets });
+    this._logger.debug("watch start", { targets: this._options.targets });
 
-    // sd.config.ts 로드
+    // Load sd.config.ts
     let sdConfig: SdConfig;
     try {
       sdConfig = await loadSdConfig({
@@ -66,22 +66,22 @@ export class WatchOrchestrator {
         dev: true,
         opt: this._options.options,
       });
-      this._logger.debug("sd.config.ts 로드 완료");
+      this._logger.debug("sd.config.ts loaded");
     } catch (err) {
-      this._logger.error(`sd.config.ts 로드 실패: ${err instanceof Error ? err.message : err}`);
+      this._logger.error(`Failed to load sd.config.ts: ${err instanceof Error ? err.message : err}`);
       process.exitCode = 1;
       throw err;
     }
 
-    // replaceDeps 설정이 있으면 watch 시작 (초기 교체는 sd-cli.ts에서 처리됨)
+    // Start watch if replaceDeps config exists (initial replacement handled in sd-cli.ts)
     if (sdConfig.replaceDeps != null) {
       this._replaceDepWatcher = await watchReplaceDeps(this._cwd, sdConfig.replaceDeps);
     }
 
-    // targets 필터링
+    // Filter by targets
     const allPackages = filterPackagesByTargets(sdConfig.packages, this._options.targets);
 
-    // library 패키지만 필터링 (node, browser, neutral)
+    // Filter only library packages (node, browser, neutral)
     const isLibraryTarget = (target: string): target is BuildTarget =>
       target === "node" || target === "browser" || target === "neutral";
 
@@ -93,28 +93,28 @@ export class WatchOrchestrator {
     }
 
     if (Object.keys(libraryConfigs).length === 0) {
-      process.stdout.write("⚠ watch할 library 패키지가 없습니다.\n");
+      process.stdout.write("⚠ No library packages to watch.\n");
       return;
     }
 
-    // PackageInfo 배열 생성
+    // Create PackageInfo array
     this._packages = Object.entries(libraryConfigs).map(([name, config]) => ({
       name,
       dir: path.join(this._cwd, "packages", name),
       config,
     }));
 
-    // 인프라 초기화
+    // Initialize infrastructure
     this._resultCollector = new ResultCollector();
     this._signalHandler = new SignalHandler();
     this._rebuildManager = new RebuildManager(this._logger);
 
-    // 배치 완료 시 에러 출력
+    // Print errors on batch completion
     this._rebuildManager.on("batchComplete", () => {
       printErrors(this._resultCollector.toMap());
     });
 
-    // Builder 생성
+    // Create builders
     const builderOptions = {
       cwd: this._cwd,
       packages: this._packages,
@@ -125,25 +125,25 @@ export class WatchOrchestrator {
     this._libraryBuilder = new LibraryBuilder(builderOptions);
     this._dtsBuilder = new DtsBuilder(builderOptions);
 
-    // Builder 초기화
+    // Initialize builders
     await Promise.all([this._libraryBuilder.initialize(), this._dtsBuilder.initialize()]);
   }
 
   /**
-   * Watch 모드 시작
-   * - 초기 빌드 실행
-   * - 결과 출력
+   * Start watch mode
+   * - Run initial build
+   * - Output results
    */
   async start(): Promise<void> {
     if (this._packages.length === 0) {
       return;
     }
 
-    // 초기 빌드 Promise 구성
+    // Set up initial build promises
     const buildPromises = this._libraryBuilder.getInitialBuildPromises();
     const dtsPromises = this._dtsBuilder.getInitialBuildPromises();
 
-    // copySrc watch 시작
+    // Start copySrc watch
     for (const pkg of this._packages) {
       const buildConfig = pkg.config as SdBuildPackageConfig;
       if (buildConfig.copySrc != null && buildConfig.copySrc.length > 0) {
@@ -152,17 +152,17 @@ export class WatchOrchestrator {
       }
     }
 
-    // Watch 시작 (백그라운드 실행)
+    // Start watch (run in background)
     void this._libraryBuilder.startWatch();
     void this._dtsBuilder.startWatch();
 
-    // 초기 빌드 시작
-    this._logger.start("초기 빌드 진행 중...");
+    // Start initial build
+    this._logger.start("Running initial build...");
 
-    // Library 빌드 및 DTS 빌드 전체 Promise 배열 구성
+    // Set up complete promise array for library build and DTS build
     const allBuildTasks: Array<{ name: string; promise: Promise<void> }> = [];
 
-    // Library 빌드 태스크
+    // Library build tasks
     for (const pkg of this._packages) {
       const promise = buildPromises.get(`${pkg.name}:build`) ?? Promise.resolve();
       allBuildTasks.push({
@@ -171,7 +171,7 @@ export class WatchOrchestrator {
       });
     }
 
-    // DTS 태스크
+    // DTS tasks
     for (const pkg of this._packages) {
       const promise = dtsPromises.get(`${pkg.name}:dts`) ?? Promise.resolve();
       allBuildTasks.push({
@@ -180,17 +180,17 @@ export class WatchOrchestrator {
       });
     }
 
-    // 모든 빌드 작업 동시 실행 (초기 빌드 완료까지 대기)
+    // Run all build tasks concurrently (wait until initial build completes)
     await Promise.allSettled(allBuildTasks.map((task) => task.promise));
 
-    this._logger.success("초기 빌드 완료");
+    this._logger.success("Initial build completed");
 
-    // 초기 빌드 결과 출력
+    // Output initial build results
     printErrors(this._resultCollector.toMap());
   }
 
   /**
-   * 종료 시그널 대기
+   * Wait for termination signal
    */
   async awaitTermination(): Promise<void> {
     if (this._packages.length === 0) {
@@ -200,14 +200,14 @@ export class WatchOrchestrator {
   }
 
   /**
-   * Orchestrator 종료
+   * Shutdown Orchestrator
    */
   async shutdown(): Promise<void> {
     if (this._packages.length === 0) {
       return;
     }
 
-    process.stdout.write("⏳ 종료 중...\n");
+    process.stdout.write("⏳ Shutting down...\n");
 
     await Promise.all([
       this._libraryBuilder.shutdown(),
@@ -217,6 +217,6 @@ export class WatchOrchestrator {
     this._copySrcWatchers = [];
     this._replaceDepWatcher?.dispose();
 
-    process.stdout.write("✔ 완료\n");
+    process.stdout.write("✔ Done\n");
   }
 }

package/src/sd-cli-entry.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// side-effect: Map/Array 프로토타입 확장 (getOrCreate 등)
+// side-effect: Map/Array prototype extensions (getOrCreate, etc.)
 import "@simplysm/core-common";
 import yargs, { type Argv } from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -23,16 +23,16 @@ Error.stackTraceLimit = Infinity;
 EventEmitter.defaultMaxListeners = 100;
 
 /**
- * CLI 파서를 생성한다.
- * @internal 테스트용으로 export
+ * Create CLI parser
+ * @internal exported for testing
  */
 export function createCliParser(argv: string[]): Argv {
   return yargs(argv)
-    .help("help", "도움말")
+    .help("help", "Show help")
     .alias("help", "h")
     .option("debug", {
       type: "boolean",
-      describe: "debug 로그 출력",
+      describe: "Output debug logs",
       default: false,
       global: true,
     })
@@ -41,7 +41,7 @@ export function createCliParser(argv: string[]): Argv {
     })
     .command(
       "lint [targets..]",
-      "ESLint + Stylelint를 실행한다.",
+      "Run ESLint + Stylelint",
       (cmd) =>
         cmd
           .version(false)
@@ -49,18 +49,18 @@ export function createCliParser(argv: string[]): Argv {
           .positional("targets", {
             type: "string",
             array: true,
-            describe: "린트할 경로 (예: packages/core-common, tests/orm)",
+            describe: "Paths to lint (e.g., packages/core-common, tests/orm)",
             default: [],
           })
           .options({
             fix: {
               type: "boolean",
-              describe: "자동 수정",
+              describe: "Auto-fix issues",
               default: false,
             },
             timing: {
               type: "boolean",
-              describe: "규칙별 실행 시간 출력",
+              describe: "Print execution time per rule",
               default: false,
             },
           }),
@@ -74,7 +74,7 @@ export function createCliParser(argv: string[]): Argv {
     )
     .command(
       "typecheck [targets..]",
-      "TypeScript 타입체크를 실행한다.",
+      "Run TypeScript type checking",
       (cmd) =>
         cmd
           .version(false)
@@ -82,7 +82,7 @@ export function createCliParser(argv: string[]): Argv {
           .positional("targets", {
             type: "string",
             array: true,
-            describe: "타입체크할 경로 (예: packages/core-common, tests/orm)",
+            describe: "Paths to typecheck (e.g., packages/core-common, tests/orm)",
             default: [],
           })
           .options({
@@ -90,7 +90,7 @@ export function createCliParser(argv: string[]): Argv {
               type: "string",
               array: true,
               alias: "o",
-              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              description: "Options to pass to sd.config.ts (e.g., -o key=value)",
               default: [] as string[],
             },
           }),
@@ -103,7 +103,7 @@ export function createCliParser(argv: string[]): Argv {
     )
     .command(
       "check [targets..]",
-      "Typecheck, Lint, Test를 병렬로 실행한다.",
+      "Run Typecheck, Lint, Test in parallel",
       (cmd) =>
         cmd
           .version(false)
@@ -111,13 +111,13 @@ export function createCliParser(argv: string[]): Argv {
           .positional("targets", {
             type: "string",
             array: true,
-            describe: "체크할 경로 (예: packages/core-common, tests/orm)",
+            describe: "Paths to check (e.g., packages/core-common, tests/orm)",
             default: [],
           })
           .options({
             type: {
               type: "string",
-              describe: "실행할 체크 타입 (쉼표 구분: typecheck,lint,test)",
+              describe: "Check types to run (comma-separated: typecheck,lint,test)",
               default: "typecheck,lint,test",
             },
           }),
@@ -130,7 +130,7 @@ export function createCliParser(argv: string[]): Argv {
     )
     .command(
       "watch [targets..]",
-      "패키지를 watch 모드로 빌드한다.",
+      "Build packages in watch mode",
       (cmd) =>
         cmd
           .version(false)
@@ -138,7 +138,7 @@ export function createCliParser(argv: string[]): Argv {
           .positional("targets", {
             type: "string",
             array: true,
-            describe: "watch할 패키지 (예: solid, solid-demo)",
+            describe: "Packages to watch (e.g., solid, solid-demo)",
             default: [],
           })
           .options({
@@ -146,7 +146,7 @@ export function createCliParser(argv: string[]): Argv {
               type: "string",
               array: true,
               alias: "o",
-              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              description: "Options to pass to sd.config.ts (e.g., -o key=value)",
               default: [] as string[],
             },
           }),
@@ -159,7 +159,7 @@ export function createCliParser(argv: string[]): Argv {
     )
     .command(
       "dev [targets..]",
-      "Client와 Server 패키지를 개발 모드로 실행한다.",
+      "Run Client and Server packages in dev mode",
       (cmd) =>
         cmd
           .version(false)
@@ -167,7 +167,7 @@ export function createCliParser(argv: string[]): Argv {
           .positional("targets", {
             type: "string",
             array: true,
-            describe: "실행할 패키지 (예: solid-demo)",
+            describe: "Packages to run (e.g., solid-demo)",
             default: [],
           })
           .options({
@@ -175,7 +175,7 @@ export function createCliParser(argv: string[]): Argv {
               type: "string",
               array: true,
               alias: "o",
-              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              description: "Options to pass to sd.config.ts (e.g., -o key=value)",
               default: [] as string[],
             },
           }),
@@ -188,7 +188,7 @@ export function createCliParser(argv: string[]): Argv {
     )
     .command(
       "build [targets..]",
-      "프로덕션 빌드를 실행한다.",
+      "Run production build",
       (cmd) =>
         cmd
           .version(false)
@@ -196,7 +196,7 @@ export function createCliParser(argv: string[]): Argv {
           .positional("targets", {
             type: "string",
             array: true,
-            describe: "빌드할 패키지 (예: solid, core-common)",
+            describe: "Packages to build (e.g., solid, core-common)",
             default: [],
           })
           .options({
@@ -204,7 +204,7 @@ export function createCliParser(argv: string[]): Argv {
               type: "string",
               array: true,
               alias: "o",
-              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              description: "Options to pass to sd.config.ts (e.g., -o key=value)",
               default: [] as string[],
             },
           }),
@@ -217,7 +217,7 @@ export function createCliParser(argv: string[]): Argv {
     )
     .command(
       "device",
-      "Android 디바이스에서 앱을 실행한다.",
+      "Run app on Android device",
       (cmd) =>
         cmd
           .version(false)
@@ -226,19 +226,19 @@ export function createCliParser(argv: string[]): Argv {
             package: {
               type: "string",
               alias: "p",
-              describe: "패키지 이름",
+              describe: "Package name",
               demandOption: true,
             },
             url: {
               type: "string",
               alias: "u",
-              describe: "개발 서버 URL (미지정 시 sd.config.ts의 server 설정 사용)",
+              describe: "Development server URL (if not specified, use server config from sd.config.ts)",
             },
             opt: {
               type: "string",
               array: true,
               alias: "o",
-              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              description: "Options to pass to sd.config.ts (e.g., -o key=value)",
               default: [] as string[],
             },
           }),
@@ -252,20 +252,20 @@ export function createCliParser(argv: string[]): Argv {
     )
     .command(
       "init",
-      "새 프로젝트를 초기화한다.",
+      "Initialize new project",
       (cmd) => cmd.version(false).hide("help"),
       async () => {
         const { runInit } = await import("./commands/init.js");
         await runInit({});
       },
     )
-    .command("add", "프로젝트에 패키지를 추가한다.", (cmd) =>
+    .command("add", "Add package to project", (cmd) =>
       cmd
         .version(false)
         .hide("help")
         .command(
           "client",
-          "클라이언트 패키지를 추가한다.",
+          "Add client package",
           (subCmd) => subCmd.version(false).hide("help"),
           async () => {
             const { runAddClient } = await import("./commands/add-client.js");
@@ -274,18 +274,18 @@ export function createCliParser(argv: string[]): Argv {
         )
         .command(
           "server",
-          "서버 패키지를 추가한다.",
+          "Add server package",
           (subCmd) => subCmd.version(false).hide("help"),
           async () => {
             const { runAddServer } = await import("./commands/add-server.js");
             await runAddServer({});
           },
         )
-        .demandCommand(1, "패키지 타입을 지정해주세요. (client, server)"),
+        .demandCommand(1, "Please specify package type. (client, server)"),
     )
     .command(
       "publish [targets..]",
-      "패키지를 배포한다.",
+      "Publish packages",
       (cmd) =>
         cmd
           .version(false)
@@ -293,25 +293,25 @@ export function createCliParser(argv: string[]): Argv {
           .positional("targets", {
             type: "string",
             array: true,
-            describe: "배포할 패키지 (예: solid, core-common)",
+            describe: "Packages to publish (e.g., solid, core-common)",
             default: [],
           })
           .options({
             "build": {
               type: "boolean",
-              describe: "빌드 실행 (--no-build로 스킵)",
+              describe: "Run build (skip with --no-build)",
               default: true,
             },
             "dry-run": {
               type: "boolean",
-              describe: "실제 배포 없이 시뮬레이션",
+              describe: "Simulate without actual deployment",
               default: false,
             },
             "opt": {
               type: "string",
               array: true,
               alias: "o",
-              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              description: "Options to pass to sd.config.ts (e.g., -o key=value)",
               default: [] as string[],
             },
           }),
@@ -326,7 +326,7 @@ export function createCliParser(argv: string[]): Argv {
     )
     .command(
       "replace-deps",
-      "sd.config.ts의 replaceDeps 설정에 따라 node_modules 패키지를 로컬 소스로 symlink 교체한다.",
+      "Replace node_modules packages with local sources via symlink according to replaceDeps config in sd.config.ts",
       (cmd) =>
         cmd
           .version(false)
@@ -336,7 +336,7 @@ export function createCliParser(argv: string[]): Argv {
               type: "string",
               array: true,
               alias: "o",
-              description: "sd.config.ts에 전달할 옵션 (예: -o key=value)",
+              description: "Options to pass to sd.config.ts (e.g., -o key=value)",
               default: [] as string[],
             },
           }),
@@ -346,12 +346,12 @@ export function createCliParser(argv: string[]): Argv {
         });
       },
     )
-    .demandCommand(1, "명령어를 지정해주세요.")
+    .demandCommand(1, "Please specify a command.")
     .strict();
 }
 
-// CLI로 직접 실행될 때만 파싱 수행
-// ESM에서 메인 모듈 판별: import.meta.url과 process.argv[1]을 정규화하여 비교
+// Parse only when executed directly as CLI
+// Determine main module in ESM: normalize import.meta.url and process.argv[1] and compare
 const cliEntryPath = process.argv.at(1);
 if (
   cliEntryPath != null &&

package/src/sd-cli.ts

@@ -3,8 +3,8 @@
 /**
  * CLI Launcher
  *
- * .ts 실행 (개발): CPU affinity 적용 후 sd-cli-entry 직접 import
- * .js 실행 (배포): replaceDeps 실행 후 새 프로세스로 sd-cli-entry spawn
+ * .ts execution (dev): apply CPU affinity then directly import sd-cli-entry
+ * .js execution (production): run replaceDeps then spawn sd-cli-entry in new process
  */
 
 import { execa } from "execa";
@@ -17,16 +17,16 @@ const __dirname = path.dirname(__filename);
 const isDev = path.extname(__filename) === ".ts";
 
 if (isDev) {
-  // 개발 모드 (.ts): affinity 적용 후 직접 실행
-  // import만으로는 메인 모듈 감지가 실패하므로 (process.argv[1] ≠ sd-cli-entry)
-  // createCliParser를 명시적으로 호출한다.
+  // Dev mode (.ts): apply affinity then run directly
+  // Main module detection fails with import only (process.argv[1] ≠ sd-cli-entry)
+  // so createCliParser must be called explicitly.
   configureAffinityAndPriority(process.pid);
   const { createCliParser } = await import("./sd-cli-entry.js");
   await createCliParser(process.argv.slice(2)).parse();
 } else {
-  // 배포 모드 (.js): 2단계 실행
+  // Production mode (.js): two-stage execution
 
-  // Phase 1: replaceDeps (inline — 설치된 버전으로 복사)
+  // Phase 1: replaceDeps (inline — copy to installed version)
   try {
     const { loadSdConfig } = await import("./utils/sd-config.js");
     const { setupReplaceDeps } = await import("./utils/replace-deps.js");
@@ -35,10 +35,10 @@ if (isDev) {
       await setupReplaceDeps(process.cwd(), sdConfig.replaceDeps);
     }
   } catch {
-    // sd.config.ts 없거나 replaceDeps 미설정 시 스킵
+    // Skip if sd.config.ts is missing or replaceDeps is not configured
   }
 
-  // Phase 2: 새 프로세스로 실제 CLI 실행 (모듈 캐시 초기화)
+  // Phase 2: Run actual CLI in new process (reset module cache)
   const cliEntryFilePath = path.join(__dirname, "sd-cli-entry.js");
   const subprocess = execa(
     "node",
@@ -56,10 +56,10 @@ if (isDev) {
 }
 
 /**
- * CPU affinity mask 계산 (앞쪽 코어 제외)
+ * Calculate CPU affinity mask (exclude front cores)
  *
- * CPU 4개당 1개를 제외하고, 나머지 코어의 비트를 ON으로 설정한다.
- * 예: 8코어 → 2개 제외 → 0xFC (코어 2~7)
+ * Exclude 1 core per 4 CPUs, then set bits ON for remaining cores.
+ * Example: 8 cores → exclude 2 → 0xFC (cores 2~7)
  */
 function calculateAffinityMask(cpuCount: number): string {
   const exclude = cpuCount <= 1 ? 0 : Math.ceil(cpuCount / 4);
@@ -71,12 +71,12 @@ function calculateAffinityMask(cpuCount: number): string {
 }
 
 /**
- * Cross-platform CPU affinity + priority 설정
+ * Configure CPU affinity and priority (cross-platform)
  *
  * - Windows: PowerShell ProcessorAffinity + PriorityClass
  * - Linux/WSL: taskset + renice
  *
- * 실패해도 경고만 출력하고 CLI 동작에는 영향 없음.
+ * Only print warning on failure; does not affect CLI operation.
  */
 function configureAffinityAndPriority(pid: number): void {
   const cpuCount = os.cpus().length;
@@ -96,6 +96,6 @@ function configureAffinityAndPriority(pid: number): void {
 
   execa({ shell: true })`${command}`.catch((err: Error) => {
     // eslint-disable-next-line no-console
-    console.warn("CPU affinity/priority 설정 실패:", err.message);
+    console.warn("Failed to configure CPU affinity/priority:", err.message);
   });
 }