create-entity-app-server 0.1.15 → 0.2.0

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

@@ -19,6 +19,187 @@ cd "$PROJECT_ROOT"
 PID_FILE="$PROJECT_ROOT/.gateway.pid"
 LOG_FILE="$PROJECT_ROOT/logs/gateway.log"
 
+is_placeholder_value() {
+    local value="$1"
+
+    [[ "$value" =~ ^(your-|replace-with|change-this) ]] && return 0
+    [[ "$value" = "shared-jwt-secret" ]] && return 0
+    [[ "$value" = "your-jwt-secret" ]] && return 0
+    [[ "$value" = "your-api-key" ]] && return 0
+    [[ "$value" = "your-hmac-secret" ]] && return 0
+
+    return 1
+}
+
+show_env_setup_error() {
+    local reason="$1"
+
+    echo "❌ .env 설정이 아직 완료되지 않았습니다."
+    echo "   $reason"
+    echo ""
+    echo "   확인할 항목:"
+    echo "   1. .env 의 ENTITY_SERVER_URL"
+    echo "   2. .env 의 ENTITY_API_KEY"
+    echo "   3. .env 의 ENTITY_HMAC_SECRET (32자 이상)"
+    echo "   4. .env 의 JWT_SECRET (32자 이상, Entity Server와 동일)"
+    echo ""
+    echo "   예시 파일: .env.example"
+    exit 1
+}
+
+ensure_env_ready() {
+    if [ ! -f "$PROJECT_ROOT/.env" ]; then
+        show_env_setup_error ".env 파일이 없습니다. .env.example 을 참고해 .env 를 생성하세요."
+    fi
+
+    local entity_server_url="${ENTITY_SERVER_URL:-}"
+    local entity_api_key="${ENTITY_API_KEY:-}"
+    local entity_hmac_secret="${ENTITY_HMAC_SECRET:-}"
+    local jwt_secret="${JWT_SECRET:-}"
+
+    if [ -z "$entity_server_url" ]; then
+        show_env_setup_error "ENTITY_SERVER_URL 이 비어 있습니다."
+    fi
+
+    if [ -z "$entity_api_key" ]; then
+        show_env_setup_error "ENTITY_API_KEY 가 비어 있습니다."
+    fi
+
+    if [ -z "$entity_hmac_secret" ]; then
+        show_env_setup_error "ENTITY_HMAC_SECRET 이 비어 있습니다."
+    fi
+
+    if [ -z "$jwt_secret" ]; then
+        show_env_setup_error "JWT_SECRET 이 비어 있습니다."
+    fi
+
+    if is_placeholder_value "$entity_api_key"; then
+        show_env_setup_error "ENTITY_API_KEY 가 예시 값입니다. Entity Server에서 발급한 실제 키로 바꾸세요."
+    fi
+
+    if is_placeholder_value "$entity_hmac_secret"; then
+        show_env_setup_error "ENTITY_HMAC_SECRET 이 예시 값입니다. Entity Server에서 발급한 실제 시크릿으로 바꾸세요."
+    fi
+
+    if is_placeholder_value "$jwt_secret"; then
+        show_env_setup_error "JWT_SECRET 이 예시 값입니다. Entity Server와 동일한 실제 시크릿으로 바꾸세요."
+    fi
+
+    if [ "${#entity_hmac_secret}" -lt 32 ]; then
+        show_env_setup_error "ENTITY_HMAC_SECRET 은 32자 이상이어야 합니다."
+    fi
+
+    if [ "${#jwt_secret}" -lt 32 ]; then
+        show_env_setup_error "JWT_SECRET 은 32자 이상이어야 합니다."
+    fi
+}
+
+verify_entity_server_credentials() {
+    local result
+
+    result=$(node <<'NODE'
+const { createHmac, randomUUID } = require("node:crypto");
+
+const baseUrl = String(process.env.ENTITY_SERVER_URL || "").replace(/\/$/, "");
+const apiKey = String(process.env.ENTITY_API_KEY || "");
+const hmacSecret = String(process.env.ENTITY_HMAC_SECRET || "");
+
+async function main() {
+  const healthUrl = `${baseUrl}/v1/health`;
+
+  try {
+    const health = await fetch(healthUrl, { signal: AbortSignal.timeout(5000) });
+    if (!health.ok) {
+      console.log(`HEALTH_HTTP:${health.status}`);
+      return;
+    }
+  } catch (error) {
+    console.log(`HEALTH_ERROR:${error instanceof Error ? error.message : String(error)}`);
+    return;
+  }
+
+  const method = "GET";
+  const path = "/v1/admin/configs";
+  const timestamp = String(Math.floor(Date.now() / 1000));
+  const nonce = randomUUID();
+  const payload = Buffer.from(`${method}|${path}|${timestamp}|${nonce}|`, "utf8");
+  const signature = createHmac("sha256", hmacSecret).update(payload).digest("hex");
+
+  try {
+    const response = await fetch(`${baseUrl}${path}`, {
+      method,
+      headers: {
+        "X-API-Key": apiKey,
+        "X-Timestamp": timestamp,
+        "X-Nonce": nonce,
+        "X-Signature": signature,
+      },
+      signal: AbortSignal.timeout(5000),
+    });
+
+    if (response.ok) {
+      console.log("OK");
+      return;
+    }
+
+    const text = (await response.text().catch(() => "")).trim();
+    console.log(`AUTH_HTTP:${response.status}:${text}`);
+  } catch (error) {
+    console.log(`AUTH_ERROR:${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+main();
+NODE
+)
+
+    case "$result" in
+        OK)
+            return 0
+            ;;
+        HEALTH_HTTP:*)
+            echo "❌ Entity Server에 연결했지만 헬스체크가 실패했습니다."
+            echo "   주소: ${ENTITY_SERVER_URL}"
+            echo "   응답: ${result#HEALTH_HTTP:}"
+            exit 1
+            ;;
+        HEALTH_ERROR:*)
+            echo "❌ Entity Server에 연결할 수 없습니다."
+            echo "   주소: ${ENTITY_SERVER_URL}"
+            echo "   원인: ${result#HEALTH_ERROR:}"
+            echo "   Entity Server가 실행 중인지 먼저 확인하세요."
+            exit 1
+            ;;
+        AUTH_HTTP:401:*|AUTH_HTTP:403:*)
+            echo "❌ .env 의 Entity Server 인증 정보가 맞지 않습니다."
+            echo "   ENTITY_API_KEY 또는 ENTITY_HMAC_SECRET 이 Entity Server 값과 다릅니다."
+            echo "   Entity Server 관리자에서 발급된 API Key / HMAC Secret 을 다시 복사하세요."
+            exit 1
+            ;;
+        AUTH_HTTP:404:*)
+            echo "❌ Entity Server 관리자 API 점검 경로를 찾지 못했습니다."
+            echo "   연결 대상: ${ENTITY_SERVER_URL}"
+            echo "   /v1/admin/configs 가 없는 구버전 서버이거나 잘못된 주소일 수 있습니다."
+            exit 1
+            ;;
+        AUTH_HTTP:*)
+            echo "❌ Entity Server 인증 점검 중 오류가 발생했습니다."
+            echo "   응답: ${result#AUTH_HTTP:}"
+            exit 1
+            ;;
+        AUTH_ERROR:*)
+            echo "❌ Entity Server 인증 점검 요청을 보내지 못했습니다."
+            echo "   원인: ${result#AUTH_ERROR:}"
+            exit 1
+            ;;
+        *)
+            echo "❌ Entity Server 사전 점검 결과를 해석하지 못했습니다."
+            echo "   응답: $result"
+            exit 1
+            ;;
+    esac
+}
+
 ensure_runtime_dependencies_installed() {
     if [ -d "$PROJECT_ROOT/node_modules/tsx" ]; then
         return 0
@@ -58,6 +239,30 @@ find_gateway_pids() {
     ss -ltnp 2>/dev/null | sed -n "s/.*:$port .*pid=\([0-9]\+\).*/\1/p" | sort -u
 }
 
+show_status() {
+    local pid=""
+
+    if [ -f "$PID_FILE" ]; then
+        pid=$(cat "$PID_FILE" 2>/dev/null || true)
+    fi
+
+    if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
+        echo "✅ Entity App Server가 실행 중입니다 (pid: $pid)"
+        echo "로그: $LOG_FILE"
+        return 0
+    fi
+
+    mapfile -t PORT_PIDS < <(find_gateway_pids)
+    if [ "${#PORT_PIDS[@]}" -gt 0 ]; then
+        echo "✅ Entity App Server가 실행 중입니다 (pid: ${PORT_PIDS[0]})"
+        echo "로그: $LOG_FILE"
+        return 0
+    fi
+
+    echo "ℹ️  Entity App Server가 실행 중이지 않습니다."
+    return 1
+}
+
 show_port_in_use_error() {
     local port
     port=$(get_gateway_port)
@@ -109,11 +314,13 @@ _print_help() {
     echo "  명령:"
     echo "    start   프로덕션 모드로 백그라운드 실행 (dist/system.js)"
     echo "    stop    실행 중인 서버 종료"
+    echo "    status  실행 상태 확인"
     echo "    dev     개발 모드 실행 (tsx watch)"
     echo ""
     echo "  예제:"
     echo "    $0 start       # 서버 시작"
     echo "    $0 stop        # 서버 종료"
+    echo "    $0 status      # 실행 상태 확인"
     echo "    $0 dev         # 개발 모드"
     echo ""
     if [ -f "$PID_FILE" ]; then
@@ -130,13 +337,18 @@ _print_help() {
 
 if [ $# -eq 0 ]; then
     _print_help
+    echo ""
+    echo "현재 상태:"
+    show_status
     exit 0
 fi
 
 case "$1" in
     start)
         ensure_port_available
+        ensure_env_ready
         ensure_runtime_dependencies_installed
+        verify_entity_server_credentials
 
         if [ ! -f "dist/system.js" ]; then
             echo "❌ dist/system.js가 없습니다. 먼저 빌드하세요:"
@@ -160,12 +372,17 @@ case "$1" in
         echo $! > "$PID_FILE"
         PID=$(cat "$PID_FILE")
 
-        echo ""
-        echo "  ✓ Entity App Server 시작됨"
-        echo "    PID: $PID"
-        echo "    로그: $LOG_FILE"
-        echo "    종료: $0 stop"
-        echo ""
+        sleep 0.3
+        if kill -0 "$PID" 2>/dev/null; then
+            echo "✅ Entity App Server가 백그라운드에서 시작되었습니다 (pid: $PID)"
+            echo "상태: ./run.sh status"
+            echo "중지: ./run.sh stop"
+        else
+            rm -f "$PID_FILE"
+            echo "❌ Entity App Server 백그라운드 시작에 실패했습니다"
+            echo "로그 확인: $LOG_FILE"
+            exit 1
+        fi
         ;;
 
     stop)
@@ -195,13 +412,19 @@ case "$1" in
         fi
         ;;
 
+    status)
+        show_status
+        ;;
+
     dev)
         if [ -f "$PID_FILE" ] || [ -n "$(find_gateway_pids | head -n 1)" ]; then
             echo "  기존 Entity App Server 정리 중..."
             "$SCRIPT_DIR/run.sh" stop
         fi
 
+        ensure_env_ready
         ensure_runtime_dependencies_installed
+        verify_entity_server_credentials
 
         echo "  Starting Entity App Server (dev mode)..."
         exec npm run dev

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=("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")