create-entity-app-server 0.1.16 → 0.2.1

package/dist-create/template/scripts/build.sh

@@ -0,0 +1,222 @@
+#!/bin/bash
+# build.sh — Gateway TypeScript 빌드 + dist/ dist-create/ 패키징
+#
+# dist/ 구조:
+#   실행/배포용 산출물. build 결과를 바로 실행하거나 서버에 배포할 때 사용한다.
+#
+# dist-create/ 구조:
+#   npm create entity-app-server 가 내려받는 템플릿 원본.
+#   create 스캐폴딩 시 복사될 파일만 template/ 아래에 담는다.
+#
+# 실행:
+#   ./scripts/build.sh        — 빌드 + 패키징
+#   ./scripts/build.sh --no-tar — tar.gz 없이 빌드만
+
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_ROOT"
+
+is_source_repo_mode() {
+    [ -d "$PROJECT_ROOT/src/system" ] && [ -f "$PROJECT_ROOT/scripts/build-obfuscate-system.mjs" ]
+}
+
+package_generated_project() {
+    VERSION=$(grep '"version"' package.json | head -1 | sed 's/.*: *"\([^"]*\)".*/\1/')
+    COMMIT=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+    BUILD_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    echo ""
+    echo "  Entity App Server v${VERSION}  ·  ${COMMIT}  ·  ${BUILD_TIME}"
+    echo ""
+
+    echo "  [1/3] Packaging runtime files..."
+
+    rm -rf dist
+    mkdir -p dist/scripts
+
+    [ -f "system.js" ] && cp "system.js" dist/system.js
+    [ -f "system-api.js" ] && cp "system-api.js" dist/system-api.js
+    [ -f "tsconfig.json" ] && cp "tsconfig.json" dist/tsconfig.json
+
+    [ -d "app" ] && cp -R app dist/app
+    [ -d "configs" ] && cp -R configs dist/configs
+    [ -d "entities" ] && cp -R entities dist/entities
+
+    for script in build.sh reset-all.sh run.sh entity.sh update-server.sh service-install.sh service-remove.sh; do
+        [ -f "scripts/$script" ] && install -m 755 "scripts/$script" "dist/scripts/$script"
+    done
+
+    if [ -d "docs" ]; then
+        cp -R docs dist/docs
+    fi
+
+    [ -f ".env.example" ] && cp .env.example dist/.env
+    [ -f ".env.example" ] && cp .env.example dist/.env.example
+    [ -f ".gateway-version" ] && cp .gateway-version dist/.gateway-version
+
+    echo "        ✓ dist/"
+
+    if [ "${1:-}" != "--no-tar" ]; then
+        echo "  [2/3] Creating dist.tar.gz..."
+        (cd dist && tar -czf "$PROJECT_ROOT/dist.tar.gz" .)
+        echo "        ✓ dist.tar.gz"
+    else
+        echo "  [2/3] Skipped dist.tar.gz (--no-tar)"
+    fi
+
+    echo "  [3/3] Done"
+    echo ""
+    echo "  실행: ./scripts/run.sh start"
+    echo "  개발: ./scripts/run.sh dev"
+    echo ""
+}
+
+if ! is_source_repo_mode; then
+    package_generated_project "$1"
+    exit 0
+fi
+
+replace_example_configs() {
+    local target_root="$1"
+
+    for scope in plugins routes schedules; do
+        [ -d "$target_root/app/$scope" ] || continue
+
+        find "$target_root/app/$scope" -name "config.example.json" | while read -r file; do
+            dir="$(dirname "$file")"
+            rm -f "$dir/config.json"
+            cp "$file" "$dir/config.json"
+            rm -f "$file"
+        done
+    done
+}
+
+VERSION=$(grep '"version"' package.json | head -1 | sed 's/.*: *"\([^"]*\)".*/\1/')
+COMMIT=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+BUILD_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+echo ""
+echo "  Entity Server Gateway v${VERSION}  ·  ${COMMIT}  ·  ${BUILD_TIME}"
+echo ""
+
+# ─── [1/5] TypeScript 빌드 (난독화 번들 + 타입 체크) ──────────────────────────
+
+echo "  [1/5] Building TypeScript..."
+npm run build
+node "$SCRIPT_DIR/build-obfuscate-system.mjs" 2>&1 | grep -v "\[javascript-obfuscator\]" || true
+echo "        ✓ dist/system.js      (난독화 번들)"
+echo "        ✓ dist/system-api.js  (공개 API 번들)"
+
+# ─── [2/5] 소스 복사 ──────────────────────────────────────────────────────────
+
+echo "  [2/5] Copying sources..."
+
+# 이전 빌드 잔재 system/ 폴더 제거 (system-api.js 번들로 대체됨)
+rm -rf dist/system
+
+# app/ — 사용자 편집 가능 TypeScript 소스
+rm -rf dist/app
+cp -r src/app dist/app
+
+# example config 초기화:
+#   - plugins/routes/schedules 에 config.example.json 이 있으면 dist 의 config.json 으로 교체
+#   - source config.json 은 deploy/minify 판단용으로만 유지
+replace_example_configs "dist"
+
+echo "        ✓ dist/app/      (plugins/routes/schedules config.json ← config.example.json)"
+
+# deploy 가 true가 아닌 항목(false 또는 누락)은 dist에서 제거
+for category in plugins routes schedules; do
+    src_base="src/app/${category}"
+    dist_base="dist/app/${category}"
+    for cfg in "${src_base}"/*/config.json "${src_base}"/*/*/config.json; do
+        [ -f "$cfg" ] || continue
+        if ! grep -q '"deploy"[[:space:]]*:[[:space:]]*true' "$cfg" 2>/dev/null; then
+            rel="${cfg#${src_base}/}"
+            name="${rel%/config.json}"
+            rm -rf "${dist_base}/${name}"
+            echo "        ✗ app/${category}/${name} (배포 제외)"
+        fi
+    done
+done
+
+# 난독화 실행 (복사 후 dist .ts 파일 인플레이스 처리)
+node "$SCRIPT_DIR/build-minify-plugins.mjs" 2>&1 | grep -v "\[javascript-obfuscator\]" || true
+
+# 배포 결과물의 app config 는 config.example.json 기준으로 생성됨
+
+# tsconfig.json — tsx 런타임 경로 별칭 (@system/* @app/*)
+cp "$SCRIPT_DIR/dist-tsconfig.json" dist/tsconfig.json
+echo "        ✓ dist/tsconfig.json"
+
+# ─── [3/5] 설정·리소스 복사 ────────────────────────────────────────────────────
+
+echo "  [3/5] Packaging resources..."
+
+# configs/
+if [ -d "configs" ]; then
+    rm -rf dist/configs && mkdir -p dist/configs
+    cp -r configs/. dist/configs/
+fi
+
+# entities/
+if [ -d "entities" ]; then
+    rm -rf dist/entities && mkdir -p dist/entities
+    cp -r entities/. dist/entities/
+fi
+
+# scripts/
+mkdir -p dist/scripts
+for script in build.sh reset-all.sh run.sh entity.sh update-server.sh service-install.sh service-remove.sh; do
+    [ -f "scripts/$script" ] && install -m 755 "scripts/$script" "dist/scripts/$script"
+done
+
+# docs/ (design/ 제외)
+if [ -d "docs" ]; then
+    rm -rf dist/docs
+    cp -r docs dist/docs
+    rm -rf dist/docs/design
+fi
+
+# .env / .env.example
+[ -f ".env.example" ] && cp .env.example dist/.env
+[ -f ".env.example" ] && cp .env.example dist/.env.example
+printf 'v%s\n' "$VERSION" > dist/.gateway-version
+
+echo "        ✓ configs/ entities/ scripts/ docs/ .env .env.example"
+
+# ─── [4/5] create 템플릿 패키징 ───────────────────────────────────────────────
+
+echo "  [4/5] Packaging dist-create/..."
+
+rm -rf dist-create
+mkdir -p dist-create/template
+
+for entry in app configs docs scripts system.js system-api.js tsconfig.json .env .env.example .gateway-version; do
+    [ -e "dist/$entry" ] && cp -R "dist/$entry" dist-create/template/
+done
+
+echo "        ✓ dist-create/template/"
+
+# ─── [5/5] tar.gz 패키징 ──────────────────────────────────────────────────────
+
+if [ "$1" != "--no-tar" ]; then
+    echo "  [5/5] Creating dist.tar.gz..."
+    (cd dist && tar -czf "$PROJECT_ROOT/dist.tar.gz" .)
+    echo "        ✓ dist.tar.gz"
+else
+    echo "  [5/5] Skipped dist.tar.gz (--no-tar)"
+fi
+
+echo ""
+echo "  Done."
+echo ""
+echo "  스크립트 사용법:"
+echo "    ./scripts/run.sh start    # 프로덕션 실행"
+echo "    ./scripts/run.sh stop     # 서버 종료"
+echo "    ./scripts/run.sh dev      # 개발 모드 (tsx watch)"
+echo ""
+

package/dist-create/template/scripts/run.sh

@@ -2,7 +2,7 @@
 # run.sh — Entity App Server 실행 / 종료
 #
 # 사용법:
-#   ./scripts/run.sh start   — 프로덕션 모드 백그라운드 실행 (dist/system.js)
+#   ./scripts/run.sh start   — 프로덕션 모드 백그라운드 실행 (dist/system.js 또는 system.js)
 #   ./scripts/run.sh stop    — 실행 중인 서버 종료
 #   ./scripts/run.sh dev     — 개발 모드 실행 (tsx watch)
 
@@ -272,6 +272,20 @@ show_port_in_use_error() {
     echo "   먼저 종료하려면: $0 stop"
 }
 
+get_runtime_entry() {
+    if [ -f "$PROJECT_ROOT/dist/system.js" ]; then
+        echo "$PROJECT_ROOT/dist/system.js"
+        return 0
+    fi
+
+    if [ -f "$PROJECT_ROOT/system.js" ]; then
+        echo "$PROJECT_ROOT/system.js"
+        return 0
+    fi
+
+    return 1
+}
+
 ensure_port_available() {
     mapfile -t PORT_PIDS < <(find_gateway_pids)
     if [ "${#PORT_PIDS[@]}" -gt 0 ]; then
@@ -312,7 +326,7 @@ _print_help() {
     echo "  사용법: $0 <명령>"
     echo ""
     echo "  명령:"
-    echo "    start   프로덕션 모드로 백그라운드 실행 (dist/system.js)"
+    echo "    start   프로덕션 모드로 백그라운드 실행 (dist/system.js 또는 system.js)"
     echo "    stop    실행 중인 서버 종료"
     echo "    status  실행 상태 확인"
     echo "    dev     개발 모드 실행 (tsx watch)"
@@ -337,19 +351,24 @@ _print_help() {
 
 if [ $# -eq 0 ]; then
     _print_help
+    echo ""
+    echo "현재 상태:"
+    show_status
     exit 0
 fi
 
 case "$1" in
     start)
+        local_runtime_entry=""
         ensure_port_available
         ensure_env_ready
         ensure_runtime_dependencies_installed
         verify_entity_server_credentials
 
-        if [ ! -f "dist/system.js" ]; then
-            echo "❌ dist/system.js가 없습니다. 먼저 빌드하세요:"
-            echo "   ./scripts/build.sh prod"
+        if ! local_runtime_entry="$(get_runtime_entry)"; then
+            echo "❌ 실행할 system.js를 찾지 못했습니다."
+            echo "   dist/system.js 또는 system.js 중 하나가 있어야 합니다."
+            echo "   패키지가 손상됐다면 ./scripts/update-server.sh latest 를 다시 실행하세요."
             exit 1
         fi
 
@@ -365,7 +384,7 @@ case "$1" in
         fi
 
         mkdir -p "$(dirname "$LOG_FILE")"
-        nohup node --import tsx/esm dist/system.js >> "$LOG_FILE" 2>&1 &
+    nohup node --import tsx/esm "$local_runtime_entry" >> "$LOG_FILE" 2>&1 &
         echo $! > "$PID_FILE"
         PID=$(cat "$PID_FILE")
 

package/dist-create/template/scripts/service-install.sh

@@ -0,0 +1,174 @@
+#!/bin/bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+SERVER_CONFIG="$PROJECT_ROOT/configs/server.json"
+
+if [ -f "$PROJECT_ROOT/.env" ]; then
+    LANGUAGE=$(grep '^LANGUAGE=' "$PROJECT_ROOT/.env" | cut -d '=' -f2)
+fi
+LANGUAGE=${LANGUAGE:-ko}
+
+SERVICE_NAME="entity-app-server"
+RUN_USER="${SUDO_USER:-$(stat -c '%U' "$PROJECT_ROOT")}"
+RUN_GROUP="$(id -gn "$RUN_USER" 2>/dev/null || true)"
+START_NOW=true
+INTERACTIVE=false
+
+load_service_name() {
+    local namespace=""
+    if [ -f "$SERVER_CONFIG" ]; then
+        namespace=$(sed -n 's/.*"namespace"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$SERVER_CONFIG" | head -n 1)
+    fi
+
+    namespace=$(echo "$namespace" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9_-]/-/g')
+
+    if [ -z "$namespace" ]; then
+        SERVICE_NAME="entity-app-server"
+    elif [[ "$namespace" == "entity-app-server" ]] || [[ "$namespace" == *"-entity-app-server" ]]; then
+        SERVICE_NAME="$namespace"
+    else
+        SERVICE_NAME="${namespace}-entity-app-server"
+    fi
+}
+
+load_service_name
+
+if [ $# -eq 0 ]; then
+    INTERACTIVE=true
+fi
+
+for arg in "$@"; do
+    case "$arg" in
+        --user=*)
+            RUN_USER="${arg#*=}"
+            ;;
+        --group=*)
+            RUN_GROUP="${arg#*=}"
+            ;;
+        --no-start)
+            START_NOW=false
+            ;;
+        *)
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "❌ Unknown option: $arg"
+            else
+                echo "❌ 알 수 없는 옵션: $arg"
+            fi
+            exit 1
+            ;;
+    esac
+done
+
+if [ "$INTERACTIVE" = true ]; then
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "[interactive] systemd service setup"
+        echo "service name: $SERVICE_NAME"
+        read -r -p "Run user [$RUN_USER]: " input
+    else
+        echo "[interactive] systemd 서비스 설정"
+        echo "서비스명: $SERVICE_NAME"
+        read -r -p "실행 사용자 [$RUN_USER]: " input
+    fi
+
+    if [ -n "$input" ]; then
+        RUN_USER="$input"
+    fi
+
+    if [ -z "$RUN_GROUP" ]; then
+        RUN_GROUP="$(id -gn "$RUN_USER" 2>/dev/null || true)"
+    fi
+
+    if [ "$LANGUAGE" = "en" ]; then
+        read -r -p "Run group [$RUN_GROUP]: " input
+    else
+        read -r -p "실행 그룹 [$RUN_GROUP]: " input
+    fi
+
+    if [ -n "$input" ]; then
+        RUN_GROUP="$input"
+    fi
+
+    if [ "$LANGUAGE" = "en" ]; then
+        read -r -p "Start service now? [Y/n]: " input
+    else
+        read -r -p "서비스를 즉시 시작할까요? [Y/n]: " input
+    fi
+
+    input=$(echo "$input" | tr '[:upper:]' '[:lower:]')
+    if [ "$input" = "n" ] || [ "$input" = "no" ]; then
+        START_NOW=false
+    fi
+fi
+
+if [ -z "$RUN_GROUP" ]; then
+    RUN_GROUP="$(id -gn "$RUN_USER")"
+fi
+
+if ! id -u "$RUN_USER" >/dev/null 2>&1; then
+    echo "❌ 사용자를 찾을 수 없습니다: $RUN_USER"
+    exit 1
+fi
+
+if ! getent group "$RUN_GROUP" >/dev/null 2>&1; then
+    echo "❌ 그룹을 찾을 수 없습니다: $RUN_GROUP"
+    exit 1
+fi
+
+if [ ! -x "$PROJECT_ROOT/scripts/run.sh" ]; then
+    chmod +x "$PROJECT_ROOT/scripts/run.sh"
+fi
+
+if [ ! -f "$PROJECT_ROOT/system.js" ]; then
+    echo "❌ system.js 파일이 없습니다. create-entity-app-server 로 생성된 프로젝트 루트인지 확인하세요."
+    exit 1
+fi
+
+UNIT_PATH="/etc/systemd/system/${SERVICE_NAME}.service"
+
+if [ "$EUID" -ne 0 ]; then
+    if command -v sudo >/dev/null 2>&1; then
+        SUDO_ARGS=("--user=$RUN_USER" "--group=$RUN_GROUP")
+        if [ "$START_NOW" = false ]; then
+            SUDO_ARGS+=("--no-start")
+        fi
+        exec sudo "$0" "${SUDO_ARGS[@]}"
+    fi
+    echo "❌ 이 스크립트는 root 권한이 필요합니다"
+    exit 1
+fi
+
+cat > "$UNIT_PATH" <<EOF
+[Unit]
+Description=Entity App Server
+After=network.target
+
+[Service]
+Type=simple
+User=$RUN_USER
+Group=$RUN_GROUP
+WorkingDirectory=$PROJECT_ROOT
+EnvironmentFile=-$PROJECT_ROOT/.env
+ExecStart=$PROJECT_ROOT/scripts/run.sh start
+Restart=always
+RestartSec=3
+LimitNOFILE=65535
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+systemctl daemon-reload
+systemctl enable "$SERVICE_NAME"
+
+if [ "$START_NOW" = true ]; then
+    systemctl restart "$SERVICE_NAME"
+fi
+
+echo "✅ 서비스 등록 완료: $SERVICE_NAME"
+echo "   Unit: $UNIT_PATH"
+echo "   시작:  sudo systemctl start $SERVICE_NAME"
+echo "   중지:  sudo systemctl stop $SERVICE_NAME"
+echo "   상태:  sudo systemctl status $SERVICE_NAME"

package/dist-create/template/scripts/service-remove.sh

@@ -0,0 +1,102 @@
+#!/bin/bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+SERVER_CONFIG="$PROJECT_ROOT/configs/server.json"
+
+if [ -f "$PROJECT_ROOT/.env" ]; then
+    LANGUAGE=$(grep '^LANGUAGE=' "$PROJECT_ROOT/.env" | cut -d '=' -f2)
+fi
+LANGUAGE=${LANGUAGE:-ko}
+
+SERVICE_NAME="entity-app-server"
+INTERACTIVE=false
+CONFIRMED=false
+
+load_service_name() {
+    local namespace=""
+    if [ -f "$SERVER_CONFIG" ]; then
+        namespace=$(sed -n 's/.*"namespace"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$SERVER_CONFIG" | head -n 1)
+    fi
+
+    namespace=$(echo "$namespace" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9_-]/-/g')
+
+    if [ -z "$namespace" ]; then
+        SERVICE_NAME="entity-app-server"
+    elif [[ "$namespace" == "entity-app-server" ]] || [[ "$namespace" == *"-entity-app-server" ]]; then
+        SERVICE_NAME="$namespace"
+    else
+        SERVICE_NAME="${namespace}-entity-app-server"
+    fi
+}
+
+load_service_name
+
+if [ $# -eq 0 ]; then
+    INTERACTIVE=true
+fi
+
+for arg in "$@"; do
+    case "$arg" in
+        --yes|-y)
+            CONFIRMED=true
+            ;;
+        *)
+            echo "❌ 알 수 없는 옵션: $arg"
+            exit 1
+            ;;
+    esac
+done
+
+if [ "$INTERACTIVE" = true ] && [ "$CONFIRMED" = false ]; then
+    echo "[interactive] systemd 서비스 제거"
+    echo "서비스명: $SERVICE_NAME"
+    read -r -p "'$SERVICE_NAME' 서비스를 제거할까요? [y/N]: " input
+    input=$(echo "$input" | tr '[:upper:]' '[:lower:]')
+    if [ "$input" != "y" ] && [ "$input" != "yes" ]; then
+        echo "취소되었습니다."
+        exit 0
+    fi
+fi
+
+UNIT_PATH="/etc/systemd/system/${SERVICE_NAME}.service"
+
+if [ "$EUID" -ne 0 ]; then
+    if command -v sudo >/dev/null 2>&1; then
+        exec sudo "$0" --yes
+    fi
+    echo "❌ 이 스크립트는 root 권한이 필요합니다"
+    exit 1
+fi
+
+SERVICE_EXISTS=false
+if systemctl list-unit-files | grep -q "^${SERVICE_NAME}\.service"; then
+    SERVICE_EXISTS=true
+fi
+
+if [ ! -f "$UNIT_PATH" ] && [ "$SERVICE_EXISTS" = false ]; then
+    echo "ℹ️  '$SERVICE_NAME' 서비스가 등록되어 있지 않습니다."
+    echo "   제거할 항목이 없습니다."
+    echo ""
+    echo "   서비스를 등록하려면:"
+    echo "   sudo $(dirname "$0")/service-install.sh"
+    exit 0
+fi
+
+if [ "$SERVICE_EXISTS" = true ]; then
+    systemctl stop "$SERVICE_NAME" 2>/dev/null || true
+    systemctl disable "$SERVICE_NAME" 2>/dev/null || true
+fi
+
+if [ -f "$UNIT_PATH" ]; then
+    rm -f "$UNIT_PATH"
+fi
+
+systemctl daemon-reload
+
+echo "✅ 서비스 제거 완료: $SERVICE_NAME"
+echo ""
+echo "   서비스를 다시 등록하려면:"
+echo "   sudo $(dirname "$0")/service-install.sh"

package/dist-create/template/scripts/update-server.sh

@@ -2,8 +2,7 @@
 # update-server.sh — Entity App Server 코어 업데이트
 #
 # 사용법:
-#   ./scripts/update-server.sh             # 도움말
-#   ./scripts/update-server.sh version     # 현재 코어 버전 + 최신 태그 확인
+#   ./scripts/update-server.sh             # 도움말 + 현재/최신 버전 확인
 #   ./scripts/update-server.sh latest      # 최신 태그로 업데이트
 #   ./scripts/update-server.sh 0.0.8       # 특정 버전으로 업데이트
 #   ./scripts/update-server.sh v0.0.8
@@ -15,7 +14,7 @@ PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
 PACKAGE_NAME="create-entity-app-server"
 VERSION_FILE="$PROJECT_ROOT/.gateway-version"
 PID_FILE="$PROJECT_ROOT/.gateway.pid"
-MANAGED_SCRIPTS=("run.sh" "entity.sh" "reset-all.sh" "update-server.sh")
+MANAGED_SCRIPTS=("build.sh" "run.sh" "entity.sh" "reset-all.sh" "update-server.sh" "service-install.sh" "service-remove.sh")
 MANAGED_FILES=("system.js" "system-api.js" "tsconfig.json" ".env.example" ".gateway-version")
 
 cd "$PROJECT_ROOT"
@@ -113,6 +112,28 @@ latest_gateway_version() {
     echo "$latest"
 }
 
+print_version_status() {
+    local current
+    local latest
+
+    echo "🔍 버전 확인 중..."
+    current="$(current_gateway_version)"
+    latest="$(latest_gateway_version)"
+
+    echo ""
+    echo "  현재 코어 버전: v${current}"
+    echo "  최신 패키지 버전: v${latest}"
+    echo ""
+
+    if [ "$current" = "$latest" ]; then
+        echo "✅ 최신 버전입니다."
+    elif is_semver "$current" && [ "$(compare_versions "$current" "$latest")" = "1" ]; then
+        echo "ℹ️  현재 코어가 npm 최신 버전보다 더 새롭습니다."
+    else
+        echo "💡 업데이트 가능: ./scripts/update-server.sh latest"
+    fi
+}
+
 package_tarball_url() {
     local version="$1"
     local tarball
@@ -370,29 +391,13 @@ case "$ARG" in
         echo "update-server.sh — Entity App Server 코어 업데이트"
         echo ""
         echo "사용법:"
-        echo "  ./scripts/update-server.sh version"
         echo "  ./scripts/update-server.sh latest"
         echo "  ./scripts/update-server.sh <버전>"
         echo ""
         echo "업데이트 대상: system.js / system-api.js / scripts / docs / tsconfig.json / .env.example / package.json(deps)"
         echo "보존 대상: app/ / configs/ / .env / package.json의 name/version/private"
-        ;;
-
-    "version")
-        echo "🔍 버전 확인 중..."
-        CURRENT="$(current_gateway_version)"
-        LATEST="$(latest_gateway_version)"
         echo ""
-        echo "  현재 코어 버전: v${CURRENT}"
-        echo "  최신 패키지 버전: v${LATEST}"
-        echo ""
-        if [ "$CURRENT" = "$LATEST" ]; then
-            echo "✅ 최신 버전입니다."
-        elif is_semver "$CURRENT" && [ "$(compare_versions "$CURRENT" "$LATEST")" = "1" ]; then
-            echo "ℹ️  현재 코어가 npm 최신 버전보다 더 새롭습니다."
-        else
-            echo "💡 업데이트 가능: ./scripts/update-server.sh latest"
-        fi
+        print_version_status
         ;;
 
     "latest")