@simplysm/sd-cli 14.0.18 → 14.0.21

package/src/utils/server-production-files.ts

@@ -0,0 +1,186 @@
+import type { ServerBuildInfo } from "../workers/server-build.worker";
+import path from "path";
+import fs from "fs";
+import { cpx } from "@simplysm/core-node";
+import { consola } from "consola";
+import { collectAllDependencyExternals } from "./esbuild-config";
+
+const logger = consola.withTag("sd:cli:server-production-files");
+
+/**
+ * 세 가지 소스에서 외부 모듈을 수집하고 병합한다.
+ * collectAllDependencyExternals를 통한 단일 패스 의존성 트리 순회를 사용한다.
+ */
+export function collectAllExternals(pkgDir: string, manualExternals?: string[]): string[] {
+  logger.debug("의존성 트리 스캔 중...");
+  const { optionalPeerDeps, nativeModules } = collectAllDependencyExternals(pkgDir);
+
+  const manual = manualExternals ?? [];
+  return [...new Set([...optionalPeerDeps, ...nativeModules, ...manual])];
+}
+
+/**
+ * pnpm-lock.yaml의 packages 섹션을 파싱하여 name→version 맵을 생성한다.
+ * Lockfile v9 형식: `packages:` 섹션의 `'name@version':` 키를 파싱한다.
+ * YAML 파서 의존성을 피하기 위해 단순 라인 기반 파싱을 사용한다.
+ */
+export function parseLockfileVersions(cwd: string): Map<string, string> {
+  const lockfilePath = path.join(cwd, "pnpm-lock.yaml");
+  if (!fs.existsSync(lockfilePath)) {
+    throw new Error(`pnpm-lock.yaml not found in ${cwd}. Run "pnpm install" first.`);
+  }
+
+  const content = fs.readFileSync(lockfilePath, "utf-8");
+  const map = new Map<string, string>();
+
+  // "packages:" 섹션을 찾고 "'@scope/name@1.2.3':" 또는 "'name@1.2.3':" 형태의 항목을 파싱
+  const lines = content.split("\n");
+  let inPackages = false;
+  for (const line of lines) {
+    if (line === "packages:") {
+      inPackages = true;
+      continue;
+    }
+    if (inPackages && line.length > 0 && !line.startsWith(" ") && !line.startsWith("'")) {
+      break; // 다음 최상위 섹션
+    }
+    if (!inPackages) continue;
+
+    // "'@scope/name@version':" 또는 "'name@version':" 매칭
+    const match = /^\s{2}'(.+)@(\d[^']*)':\s*$/.exec(line);
+    if (match != null) {
+      const name = match[1];
+      const version = match[2];
+      // 첫 번째 항목 유지 (lockfile은 각 버전을 한 번만 기록)
+      if (!map.has(name)) {
+        map.set(name, version);
+      }
+    }
+  }
+
+  return map;
+}
+
+/**
+ * pnpm-lock.yaml에서 주어진 모든 패키지의 잠긴 버전을 확인한다.
+ * lockfile에서 패키지를 찾을 수 없으면 에러를 던진다.
+ */
+export function resolveLockedVersions(cwd: string, pkgNames: string[]): Record<string, string> {
+  const versionMap = parseLockfileVersions(cwd);
+  const result: Record<string, string> = {};
+  for (const name of pkgNames) {
+    const version = versionMap.get(name);
+    if (version == null) {
+      throw new Error(
+        `External dependency "${name}" not found in pnpm-lock.yaml. ` +
+          `Run "pnpm install" and try again.`,
+      );
+    }
+    result[name] = version;
+  }
+  return result;
+}
+
+/**
+ * 프로덕션 배포용 파일을 생성한다
+ */
+export function generateProductionFiles(
+  info: ServerBuildInfo,
+  externals: string[],
+): void {
+  const distDir = path.join(info.pkgDir, "dist");
+  const pkgJson = JSON.parse(fs.readFileSync(path.join(info.pkgDir, "package.json"), "utf-8"));
+
+  // dist/package.json
+  const distPkgJson: Record<string, unknown> = {
+    name: pkgJson.name,
+    version: pkgJson.version,
+    type: pkgJson.type,
+  };
+  if (externals.length > 0) {
+    distPkgJson["dependencies"] = resolveLockedVersions(info.cwd, externals);
+  }
+  if (info.packageManager === "volta") {
+    const nodeVersion = cpx.spawnSync("node", ["-v"]).stdout.trim();
+    distPkgJson["volta"] = { node: nodeVersion };
+  }
+  fs.writeFileSync(path.join(distDir, "package.json"), JSON.stringify(distPkgJson, undefined, 2));
+
+  // dist/mise.toml
+  if (info.packageManager === "mise") {
+    const rootMiseTomlPath = path.join(info.cwd, "mise.toml");
+    let nodeVersion = "20";
+    if (fs.existsSync(rootMiseTomlPath)) {
+      const miseContent = fs.readFileSync(rootMiseTomlPath, "utf-8");
+      const match = /node\s*=\s*"([^"]+)"/.exec(miseContent);
+      if (match != null) {
+        nodeVersion = match[1];
+      }
+    }
+    fs.writeFileSync(path.join(distDir, "mise.toml"), `[tools]\nnode = "${nodeVersion}"\n`);
+  }
+
+  // dist/openssl.cnf
+  fs.writeFileSync(
+    path.join(distDir, "openssl.cnf"),
+    [
+      "nodejs_conf = openssl_init",
+      "",
+      "[openssl_init]",
+      "providers = provider_sect",
+      "ssl_conf = ssl_sect",
+      "",
+      "[provider_sect]",
+      "default = default_sect",
+      "legacy = legacy_sect",
+      "",
+      "[default_sect]",
+      "activate = 1",
+      "",
+      "[legacy_sect]",
+      "activate = 1",
+      "",
+      "[ssl_sect]",
+      "system_default = system_default_sect",
+      "",
+      "[system_default_sect]",
+      "Options = UnsafeLegacyRenegotiation",
+    ].join("\n"),
+  );
+
+  // dist/pm2.config.cjs
+  if (info.pm2 != null) {
+    const pm2Name = info.pm2.name ?? pkgJson.name.replace(/@/g, "").replace(/[/\\]/g, "-");
+    const ignoreWatch = JSON.stringify([
+      "node_modules",
+      "www",
+      ...(info.pm2.ignoreWatchPaths ?? []),
+    ]);
+    const envObj: Record<string, string> = {
+      NODE_ENV: "production",
+      TZ: "Asia/Seoul",
+      ...(info.env ?? {}),
+    };
+    const envStr = JSON.stringify(envObj, undefined, 4);
+
+    const useInterpreter = info.packageManager !== "volta";
+
+    const pm2Config = [
+      ...(useInterpreter ? [`const cp = require("child_process");`, ``] : []),
+      `module.exports = {`,
+      `  name: ${JSON.stringify(pm2Name)},`,
+      `  script: "main.js",`,
+      `  watch: true,`,
+      `  watch_delay: 2000,`,
+      `  ignore_watch: ${ignoreWatch},`,
+      ...(useInterpreter ? [`  interpreter: cp.execSync("mise which node").toString().trim(),`] : []),
+      `  interpreter_args: "--openssl-config=openssl.cnf",`,
+      `  env: ${envStr.replace(/\n/g, "\n  ")},`,
+      `  arrayProcess: "concat",`,
+      `  useDelTargetNull: true,`,
+      `};`,
+    ].join("\n");
+
+    fs.writeFileSync(path.join(distDir, "pm2.config.cjs"), pm2Config);
+  }
+}

package/src/utils/vite-config.ts

@@ -1,6 +1,9 @@
 import type { InlineConfig, PluginOption } from "vite";
 import path from "path";
+import fs from "fs";
+import tsconfigPaths from "vite-tsconfig-paths";
 import browserslistToEsbuild from "browserslist-to-esbuild";
+import { pathx } from "@simplysm/core-node";
 import { sdAngularPlugin } from "../angular/vite-angular-plugin.js";
 import solidPlugin from "vite-plugin-solid";
 import {
@@ -9,7 +12,8 @@ import {
 } from "./vite-scope-watch-plugin.js";
 import { sdPostCssInlinePlugin } from "../angular/vite-postcss-inline-plugin.js";
 import type { SdPwaConfig } from "../sd-config.types.js";
-import { sdPwaPlugin } from "./vite-pwa-plugin.js";
+import { VitePWA } from "vite-plugin-pwa";
+import { generatePwaIcons } from "./generate-pwa-icons.js";
 
 /** createClientViteConfig 옵션 */
 export interface CreateClientViteConfigOptions {
@@ -68,9 +72,9 @@ export interface CreateClientViteConfigOptions {
  * Angular AOT 플러그인, tsconfigPaths, env define, server/build 기본 설정,
  * browserslist, PostCSS, polyfills, legacyModule (inlineDynamicImports) 등을 통합 구성한다.
  */
-export function createClientViteConfig(
+export async function createClientViteConfig(
   options: CreateClientViteConfigOptions,
-): InlineConfig {
+): Promise<InlineConfig> {
   const name = options.pkgName.replace(/^@[^/]+\//, "");
 
   // browserslist → esbuild target
@@ -98,8 +102,29 @@ export function createClientViteConfig(
     }
   }
 
+  // replaceDeps dist 경로 (symlink → realpath 해결)
+  let replaceDepDistPaths: string[] | undefined;
+  if (options.replaceDeps != null && options.replaceDeps.length > 0) {
+    replaceDepDistPaths = [];
+    for (const dep of options.replaceDeps) {
+      const distDir = path.join(
+        options.pkgDir,
+        "node_modules",
+        ...dep.packageName.split("/"),
+        "dist",
+      );
+      try {
+        replaceDepDistPaths.push(pathx.posix(fs.realpathSync(distDir)));
+      } catch {
+        replaceDepDistPaths.push(pathx.posix(distDir));
+      }
+    }
+  }
+
   // plugins
-  const plugins: PluginOption[] = [];
+  const plugins: PluginOption[] = [
+    tsconfigPaths({ projects: [options.tsconfigPath] }),
+  ];
 
   if (options.framework === "solid") {
     plugins.push(solidPlugin());
@@ -115,6 +140,7 @@ export function createClientViteConfig(
         enableLint: options.enableLint,
         browserslist: normalizedBrowserslist,
         postCssPlugins: options.postCssPlugins,
+        replaceDepDistPaths,
       }),
     );
 
@@ -157,32 +183,70 @@ export function createClientViteConfig(
       ? { postcss: { plugins: options.postCssPlugins as import("postcss").AcceptedPlugin[] } }
       : undefined;
 
-  // optimizeDeps.exclude (사용자 지정 exclude)
+  // optimizeDeps.exclude (사용자 지정 exclude + replaceDeps 패키지)
+  const excludeList = [
+    ...(options.exclude ?? []),
+    ...(options.replaceDeps?.map((dep) => dep.packageName) ?? []),
+  ];
   const optimizeDepsConfig =
-    options.exclude != null && options.exclude.length > 0
-      ? { exclude: options.exclude }
-      : undefined;
+    excludeList.length > 0 ? { exclude: excludeList } : undefined;
 
   const config: InlineConfig = {
     root: options.pkgDir,
     base: options.base ?? `/${name}/`,
-    resolve: { tsconfigPaths: true },
     define: Object.keys(define).length > 0 ? define : undefined,
     plugins,
     server: serverConfig,
     css: cssConfig,
+    esbuild: {
+      target: esbuildTarget,
+    },
     build: {
       target: esbuildTarget,
     },
     optimizeDeps: {
       ...optimizeDepsConfig,
+      esbuildOptions: {
+        target: esbuildTarget as string[],
+      },
     },
   };
 
   // PWA (build 모드 + pwa !== false)
   if (options.mode === "build" && options.pwa !== false) {
+    const pwaConfig = typeof options.pwa === "object" ? options.pwa : {};
+
+    // 아이콘 자동 생성 (커스텀 icons 미설정 시)
+    let iconsConfig: Record<string, unknown> = {};
+    if (pwaConfig.manifest?.icons != null) {
+      iconsConfig = { icons: pwaConfig.manifest.icons };
+    } else {
+      const generatedIcons = await generatePwaIcons(options.pkgDir);
+      if (generatedIcons.length > 0) {
+        iconsConfig = { icons: generatedIcons };
+      }
+    }
+
+    const pwaManifest = {
+      name: pwaConfig.manifest?.name ?? name,
+      short_name: pwaConfig.manifest?.short_name ?? name,
+      display: pwaConfig.manifest?.display ?? "standalone",
+      theme_color: pwaConfig.manifest?.theme_color ?? "#ffffff",
+      background_color: pwaConfig.manifest?.background_color ?? "#ffffff",
+      ...iconsConfig,
+    };
+    const pwaWorkbox = {
+      globPatterns: pwaConfig.workbox?.globPatterns ?? [
+        "**/*.{js,css,html,ico,png,svg,woff2}",
+      ],
+    };
     (config.plugins as PluginOption[]).push(
-      sdPwaPlugin({ pkgDir: options.pkgDir, pkgName: name, pwa: options.pwa }),
+      VitePWA({
+        registerType: "prompt",
+        injectRegister: "script",
+        manifest: pwaManifest,
+        workbox: pwaWorkbox,
+      }),
     );
   }
 
@@ -231,18 +295,24 @@ export function createClientViteConfig(
     }
   }
 
-  // legacyModule: true → 코드 스플리팅 비활성화 + import.meta/import() 치환 (Chrome 61 호환)
+  // legacyModule: true → 코드 스플리팅 비활성화 + esbuild import.meta 변환 + 잔여 import() 제거
   if (options.legacyModule === true) {
+    config.esbuild = {
+      ...config.esbuild,
+      supported: {
+        "import-meta": false,
+      },
+    };
     config.build = {
       ...config.build,
-      rolldownOptions: {
+      rollupOptions: {
         output: {
           inlineDynamicImports: true,
         },
       },
     };
 
-    // Rolldown이 인라인하지 못한 잔여 dynamic import()를 제거한다.
+    // Rollup이 인라인하지 못한 잔여 dynamic import()를 제거한다.
     // inlineDynamicImports가 정적 경로를 모두 인라인한 후에도,
     // @vite-ignore나 런타임 계산 경로의 import()가 남을 수 있다.
     // Chrome 61은 import() 구문을 파싱하지 못하므로 no-op 함수로 치환한다.
@@ -260,20 +330,6 @@ export function createClientViteConfig(
         };
       },
     });
-
-    // import.meta 구문을 치환한다. Chrome 61은 import.meta를 파싱하지 못한다 (Chrome 64+).
-    // Vite/Rolldown이 빌드 시 대부분의 import.meta를 resolve하지만, 잔여분에 대한 안전망이다.
-    (config.plugins as PluginOption[]).push({
-      name: "sd-legacy-strip-import-meta",
-      enforce: "post",
-      renderChunk(code) {
-        if (!code.includes("import.meta")) return null;
-        return {
-          code: code.replace(/\bimport\.meta\b/g, "(void 0)"),
-          map: null,
-        };
-      },
-    });
   }
 
   // build 모드 설정 (프로덕션 빌드 또는 legacyModule dev)

package/src/utils/vite-scope-watch-plugin.ts

@@ -51,7 +51,12 @@ export function sdScopeWatchPlugin(options: SdScopeWatchPluginOptions): Plugin {
           "dist",
         );
         if (fs.existsSync(distDir)) {
-          watchPaths.push(distDir);
+          // symlink → realpath 해결 (Vite 모듈 그래프가 realpath를 키로 사용)
+          try {
+            watchPaths.push(fs.realpathSync(distDir));
+          } catch {
+            watchPaths.push(distDir);
+          }
         }
       }
 

package/src/workers/lint.worker.ts

@@ -1,5 +1,5 @@
 import { createWorker } from "@simplysm/core-node";
-import { executeLint, type LintOptions, type LintResult } from "../commands/lint";
+import { executeLint, type LintOptions, type LintResult } from "../utils/lint-core";
 
 //#region Worker
 

package/src/workers/server-build.worker.ts

@@ -2,7 +2,7 @@ import type ts from "typescript";
 import path from "path";
 import fs from "fs";
 import esbuild from "esbuild";
-import { cpx, createWorker, FsWatcher, pathx } from "@simplysm/core-node";
+import { createWorker, FsWatcher, pathx } from "@simplysm/core-node";
 import { err as errNs } from "@simplysm/core-common";
 import { consola } from "consola";
 import type { BuildOutput } from "../engines/types";
@@ -14,9 +14,9 @@ import {
 } from "../utils/tsconfig";
 import {
   createServerEsbuildOptions,
-  collectAllDependencyExternals,
   writeChangedOutputFiles,
 } from "../utils/esbuild-config";
+import { collectAllExternals, generateProductionFiles } from "../utils/server-production-files";
 import { runTscPackageBuild } from "../utils/tsc-build";
 import { LintWithProgramRunner } from "../utils/lint-with-program";
 import { registerCleanupHandlers, createOnceGuard, setupWorkerConsola } from "../utils/worker-utils";
@@ -136,184 +136,6 @@ async function cleanup(): Promise<void> {
   }
 }
 
-/**
- * 세 가지 소스에서 외부 모듈을 수집하고 병합한다.
- * collectAllDependencyExternals를 통한 단일 패스 의존성 트리 순회를 사용한다.
- */
-function collectAllExternals(pkgDir: string, manualExternals?: string[]): string[] {
-  logger.debug("의존성 트리 스캔 중...");
-  const { optionalPeerDeps, nativeModules } = collectAllDependencyExternals(pkgDir);
-
-  const manual = manualExternals ?? [];
-  return [...new Set([...optionalPeerDeps, ...nativeModules, ...manual])];
-}
-
-/**
- * pnpm-lock.yaml의 packages 섹션을 파싱하여 name→version 맵을 생성한다.
- * Lockfile v9 형식: `packages:` 섹션의 `'name@version':` 키를 파싱한다.
- * YAML 파서 의존성을 피하기 위해 단순 라인 기반 파싱을 사용한다.
- */
-function parseLockfileVersions(cwd: string): Map<string, string> {
-  const lockfilePath = path.join(cwd, "pnpm-lock.yaml");
-  if (!fs.existsSync(lockfilePath)) {
-    throw new Error(`pnpm-lock.yaml not found in ${cwd}. Run "pnpm install" first.`);
-  }
-
-  const content = fs.readFileSync(lockfilePath, "utf-8");
-  const map = new Map<string, string>();
-
-  // "packages:" 섹션을 찾고 "'@scope/name@1.2.3':" 또는 "'name@1.2.3':" 형태의 항목을 파싱
-  const lines = content.split("\n");
-  let inPackages = false;
-  for (const line of lines) {
-    if (line === "packages:") {
-      inPackages = true;
-      continue;
-    }
-    if (inPackages && line.length > 0 && !line.startsWith(" ") && !line.startsWith("'")) {
-      break; // 다음 최상위 섹션
-    }
-    if (!inPackages) continue;
-
-    // "'@scope/name@version':" 또는 "'name@version':" 매칭
-    const match = /^\s{2}'(.+)@(\d[^']*)':\s*$/.exec(line);
-    if (match != null) {
-      const name = match[1];
-      const version = match[2];
-      // 첫 번째 항목 유지 (lockfile은 각 버전을 한 번만 기록)
-      if (!map.has(name)) {
-        map.set(name, version);
-      }
-    }
-  }
-
-  return map;
-}
-
-/**
- * pnpm-lock.yaml에서 주어진 모든 패키지의 잠긴 버전을 확인한다.
- * lockfile에서 패키지를 찾을 수 없으면 에러를 던진다.
- */
-function resolveLockedVersions(cwd: string, pkgNames: string[]): Record<string, string> {
-  const versionMap = parseLockfileVersions(cwd);
-  const result: Record<string, string> = {};
-  for (const name of pkgNames) {
-    const version = versionMap.get(name);
-    if (version == null) {
-      throw new Error(
-        `External dependency "${name}" not found in pnpm-lock.yaml. ` +
-          `Run "pnpm install" and try again.`,
-      );
-    }
-    result[name] = version;
-  }
-  return result;
-}
-
-/**
- * 프로덕션 배포용 파일을 생성한다
- */
-function generateProductionFiles(
-  info: ServerBuildInfo,
-  externals: string[],
-): void {
-  const distDir = path.join(info.pkgDir, "dist");
-  const pkgJson = JSON.parse(fs.readFileSync(path.join(info.pkgDir, "package.json"), "utf-8"));
-
-  // dist/package.json
-  const distPkgJson: Record<string, unknown> = {
-    name: pkgJson.name,
-    version: pkgJson.version,
-    type: pkgJson.type,
-  };
-  if (externals.length > 0) {
-    distPkgJson["dependencies"] = resolveLockedVersions(info.cwd, externals);
-  }
-  if (info.packageManager === "volta") {
-    const nodeVersion = cpx.spawnSync("node", ["-v"]).stdout.trim();
-    distPkgJson["volta"] = { node: nodeVersion };
-  }
-  fs.writeFileSync(path.join(distDir, "package.json"), JSON.stringify(distPkgJson, undefined, 2));
-
-  // dist/mise.toml
-  if (info.packageManager === "mise") {
-    const rootMiseTomlPath = path.join(info.cwd, "mise.toml");
-    let nodeVersion = "20";
-    if (fs.existsSync(rootMiseTomlPath)) {
-      const miseContent = fs.readFileSync(rootMiseTomlPath, "utf-8");
-      const match = /node\s*=\s*"([^"]+)"/.exec(miseContent);
-      if (match != null) {
-        nodeVersion = match[1];
-      }
-    }
-    fs.writeFileSync(path.join(distDir, "mise.toml"), `[tools]\nnode = "${nodeVersion}"\n`);
-  }
-
-  // dist/openssl.cnf
-  fs.writeFileSync(
-    path.join(distDir, "openssl.cnf"),
-    [
-      "nodejs_conf = openssl_init",
-      "",
-      "[openssl_init]",
-      "providers = provider_sect",
-      "ssl_conf = ssl_sect",
-      "",
-      "[provider_sect]",
-      "default = default_sect",
-      "legacy = legacy_sect",
-      "",
-      "[default_sect]",
-      "activate = 1",
-      "",
-      "[legacy_sect]",
-      "activate = 1",
-      "",
-      "[ssl_sect]",
-      "system_default = system_default_sect",
-      "",
-      "[system_default_sect]",
-      "Options = UnsafeLegacyRenegotiation",
-    ].join("\n"),
-  );
-
-  // dist/pm2.config.cjs
-  if (info.pm2 != null) {
-    const pm2Name = info.pm2.name ?? pkgJson.name.replace(/@/g, "").replace(/[/\\]/g, "-");
-    const ignoreWatch = JSON.stringify([
-      "node_modules",
-      "www",
-      ...(info.pm2.ignoreWatchPaths ?? []),
-    ]);
-    const envObj: Record<string, string> = {
-      NODE_ENV: "production",
-      TZ: "Asia/Seoul",
-      ...(info.env ?? {}),
-    };
-    const envStr = JSON.stringify(envObj, undefined, 4);
-
-    const useInterpreter = info.packageManager !== "volta";
-
-    const pm2Config = [
-      ...(useInterpreter ? [`const cp = require("child_process");`, ``] : []),
-      `module.exports = {`,
-      `  name: ${JSON.stringify(pm2Name)},`,
-      `  script: "main.js",`,
-      `  watch: true,`,
-      `  watch_delay: 2000,`,
-      `  ignore_watch: ${ignoreWatch},`,
-      ...(useInterpreter ? [`  interpreter: cp.execSync("mise which node").toString().trim(),`] : []),
-      `  interpreter_args: "--openssl-config=openssl.cnf",`,
-      `  env: ${envStr.replace(/\n/g, "\n  ")},`,
-      `  arrayProcess: "concat",`,
-      `  useDelTargetNull: true,`,
-      `};`,
-    ].join("\n");
-
-    fs.writeFileSync(path.join(distDir, "pm2.config.cjs"), pm2Config);
-  }
-}
-
 registerCleanupHandlers(cleanup, logger);
 
 //#endregion
@@ -610,11 +432,14 @@ async function startWatch(info: ServerWatchInfo): Promise<void> {
           const newExternal = cachedExternal;
 
           const oldContext = esbuildContext;
-          if (info.output.js) {
-            esbuildContext = await createEsbuildWatchContext(info, newEntryPoints, newExternal);
-          }
-          if (oldContext != null) {
-            await oldContext.dispose();
+          try {
+            if (info.output.js) {
+              esbuildContext = await createEsbuildWatchContext(info, newEntryPoints, newExternal);
+            }
+          } finally {
+            if (oldContext != null) {
+              await oldContext.dispose();
+            }
           }
 
           const result = await rebuildAll();

package/src/workers/server-runtime.worker.ts

@@ -1,3 +1,5 @@
+import fs from "node:fs";
+import path from "path";
 import { createWorker } from "@simplysm/core-node";
 import { env, err as errNs } from "@simplysm/core-common";
 import { consola } from "consola";
@@ -49,10 +51,18 @@ const logger = consola.withTag("sd:cli:server-runtime:worker");
 /** 서버 인스턴스 (정리 대상) */
 let serverInstance: { close: () => Promise<void> } | undefined;
 
+/** .dev-port 기록 경로 (cleanup에서 삭제용) */
+let mainJsDir: string | undefined;
+
 /**
  * 리소스 정리
  */
 async function cleanup(): Promise<void> {
+  if (mainJsDir != null) {
+    try { fs.unlinkSync(path.join(mainJsDir, ".dev-port")); } catch { /* 파일 없으면 무시 */ }
+    mainJsDir = undefined;
+  }
+
   const server = serverInstance;
   serverInstance = undefined;
   if (server != null) {
@@ -172,6 +182,11 @@ async function start(info: ServerRuntimeStartInfo): Promise<void> {
     await server.listen();
     logger.debug(`서버 리슨 완료 (${Math.round(performance.now() - stepStart)}ms)`);
 
+    // .dev-port 기록 (device 명령어에서 자동 탐지용)
+    mainJsDir = path.dirname(info.mainJsPath);
+    fs.mkdirSync(mainJsDir, { recursive: true });
+    fs.writeFileSync(path.join(mainJsDir, ".dev-port"), String(server.options.port));
+
     logger.debug(
       `런타임 총 시작 시간: ${Math.round(performance.now() - startTime)}ms`,
     );