create-entity-server 0.7.11 → 0.9.12

package/template/scripts/entity.ps1

@@ -1,70 +1,70 @@
-# Init Entity Tables - Windows PowerShell
-# Add, reset, or truncate one entity's data/index/history tables
-
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectRoot = Split-Path -Parent $ScriptDir
-
-Set-Location $ProjectRoot
-
-# Load language from .env
-$Language = "ko"
-$EnvFile = Join-Path $ProjectRoot ".env"
-if (Test-Path $EnvFile) {
-    $LangLine = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -First 1
-    if ($LangLine) { $Language = $LangLine -replace '^LANGUAGE=', '' }
-}
-
-function Show-Help {
-    if ($Language -eq "en") {
-        Write-Host "Init Entity Tables"
-        Write-Host "=================="
-        Write-Host ""
-        Write-Host "Add, reset, or truncate one entity's data/index/history tables."
-        Write-Host ""
-        Write-Host "Usage: .\entity.ps1 --entity=<name> [--reset|--truncate] [--apply]"
-        Write-Host ""
-        Write-Host "Options:"
-        Write-Host "  --entity=<name>  Entity name (required)"
-        Write-Host "  --reset          Drop this entity tables and recreate"
-        Write-Host "  --truncate       Delete all rows and reset AUTO_INCREMENT=1"
-        Write-Host "  --apply          Execute (default is dry-run)"
-        Write-Host ""
-        Write-Host "Examples:"
-        Write-Host "  .\entity.ps1 --entity=license --apply"
-        Write-Host "  .\entity.ps1 --entity=account --reset --apply"
-        Write-Host "  .\entity.ps1 --entity=account --truncate --apply"
-    } else {
-        Write-Host "단일 엔티티 테이블 초기화"
-        Write-Host "====================="
-        Write-Host ""
-        Write-Host "하나의 엔티티(data/index/history) 테이블을 추가/재생성/비우기(truncate) 합니다."
-        Write-Host ""
-        Write-Host "사용법: .\entity.ps1 --entity=<name> [--reset|--truncate] [--apply]"
-        Write-Host ""
-        Write-Host "옵션:"
-        Write-Host "  --entity=<name>  엔티티명 (필수)"
-        Write-Host "  --reset          해당 엔티티 테이블 드롭 후 재생성"
-        Write-Host "  --truncate       데이터 전체 삭제 + AUTO_INCREMENT=1 초기화"
-        Write-Host "  --apply          실제 실행 (기본은 dry-run)"
-        Write-Host ""
-        Write-Host "예제:"
-        Write-Host "  .\entity.ps1 --entity=license --apply"
-        Write-Host "  .\entity.ps1 --entity=account --reset --apply"
-        Write-Host "  .\entity.ps1 --entity=account --truncate --apply"
-    }
-}
-
-if ($args.Count -eq 0) {
-    Show-Help
-    exit 0
-}
-
-$CliBin = Join-Path $ProjectRoot "bin\entity-cli.exe"
-if (-not (Test-Path $CliBin)) {
-    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found" }
-    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다" }
-    exit 1
-}
-
-# Pass-through to CLI
-& $CliBin init-entity @args
+# Init Entity Tables - Windows PowerShell
+# Add, reset, or truncate one entity's data/index/history tables
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectRoot = Split-Path -Parent $ScriptDir
+
+Set-Location $ProjectRoot
+
+# Load language from .env
+$Language = "ko"
+$EnvFile = Join-Path $ProjectRoot ".env"
+if (Test-Path $EnvFile) {
+    $LangLine = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -First 1
+    if ($LangLine) { $Language = $LangLine -replace '^LANGUAGE=', '' }
+}
+
+function Show-Help {
+    if ($Language -eq "en") {
+        Write-Host "Init Entity Tables"
+        Write-Host "=================="
+        Write-Host ""
+        Write-Host "Add, reset, or truncate one entity's data/index/history tables."
+        Write-Host ""
+        Write-Host "Usage: .\entity.ps1 --entity=<name> [--reset|--truncate] [--apply]"
+        Write-Host ""
+        Write-Host "Options:"
+        Write-Host "  --entity=<name>  Entity name (required)"
+        Write-Host "  --reset          Drop this entity tables and recreate"
+        Write-Host "  --truncate       Delete all rows and reset AUTO_INCREMENT=1"
+        Write-Host "  --apply          Execute (default is dry-run)"
+        Write-Host ""
+        Write-Host "Examples:"
+        Write-Host "  .\entity.ps1 --entity=license --apply"
+        Write-Host "  .\entity.ps1 --entity=account --reset --apply"
+        Write-Host "  .\entity.ps1 --entity=account --truncate --apply"
+    } else {
+        Write-Host "단일 엔티티 테이블 초기화"
+        Write-Host "====================="
+        Write-Host ""
+        Write-Host "하나의 엔티티(data/index/history) 테이블을 추가/재생성/비우기(truncate) 합니다."
+        Write-Host ""
+        Write-Host "사용법: .\entity.ps1 --entity=<name> [--reset|--truncate] [--apply]"
+        Write-Host ""
+        Write-Host "옵션:"
+        Write-Host "  --entity=<name>  엔티티명 (필수)"
+        Write-Host "  --reset          해당 엔티티 테이블 드롭 후 재생성"
+        Write-Host "  --truncate       데이터 전체 삭제 + AUTO_INCREMENT=1 초기화"
+        Write-Host "  --apply          실제 실행 (기본은 dry-run)"
+        Write-Host ""
+        Write-Host "예제:"
+        Write-Host "  .\entity.ps1 --entity=license --apply"
+        Write-Host "  .\entity.ps1 --entity=account --reset --apply"
+        Write-Host "  .\entity.ps1 --entity=account --truncate --apply"
+    }
+}
+
+if ($args.Count -eq 0) {
+    Show-Help
+    exit 0
+}
+
+$CliBin = Join-Path $ProjectRoot "bin\entity-cli.exe"
+if (-not (Test-Path $CliBin)) {
+    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found" }
+    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다" }
+    exit 1
+}
+
+# Pass-through to CLI
+& $CliBin init-entity @args

package/template/scripts/generate-env-keys.ps1

@@ -1,125 +1,125 @@
-# Generate Environment Keys/Secrets - Windows PowerShell
-# Generates ENCRYPTION_KEY and JWT_SECRET random values
-param(
-    [switch]$Create,
-    [switch]$Export,
-    [switch]$Apply
-)
-
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectRoot = Split-Path -Parent $ScriptDir
-
-# Load language from .env (env var takes priority)
-$Language = $env:LANGUAGE
-if (-not $Language) {
-    $EnvFile = Join-Path $ProjectRoot ".env"
-    if (Test-Path $EnvFile) {
-        $LangLine = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -Last 1
-        if ($LangLine) { $Language = $LangLine -replace '^LANGUAGE=', '' }
-    }
-}
-if (-not $Language) { $Language = "ko" }
-
-function Show-Help {
-    if ($Language -eq "en") {
-        Write-Host "Generate Environment Keys/Secrets"
-        Write-Host "==================================="
-        Write-Host ""
-        Write-Host "Generates random values for ENCRYPTION_KEY and JWT_SECRET."
-        Write-Host ""
-        Write-Host "Note: API keys (api_keys entity) are managed via DB commands:"
-        Write-Host "      .\scripts\api-key.ps1 add --role=admin --apply"
-        Write-Host ""
-        Write-Host "Usage: .\generate-env-keys.ps1 [-Create|-Export|-Apply]"
-        Write-Host ""
-        Write-Host "Options:"
-        Write-Host "    -Create      Print copy/paste format for .env"
-        Write-Host "    -Export      Print shell export format"
-        Write-Host "    -Apply       Apply values directly to project .env"
-        Write-Host ""
-        Write-Host "Examples:"
-        Write-Host "    .\generate-env-keys.ps1 -Create"
-        Write-Host "    .\generate-env-keys.ps1 -Export"
-        Write-Host "    .\generate-env-keys.ps1 -Apply"
-    } else {
-        Write-Host "환경 변수 키/시크릿 생성"
-        Write-Host "======================="
-        Write-Host ""
-        Write-Host "ENCRYPTION_KEY, JWT_SECRET 랜덤 값을 생성합니다."
-        Write-Host ""
-        Write-Host "참고: API 키(api_keys 엔티티)는 DB 명령으로 관리합니다:"
-        Write-Host "      .\scripts\api-key.ps1 add --role=admin --apply"
-        Write-Host ""
-        Write-Host "사용법: .\generate-env-keys.ps1 [-Create|-Export|-Apply]"
-        Write-Host ""
-        Write-Host "옵션:"
-        Write-Host "    -Create      .env 복붙 형식으로 출력"
-        Write-Host "    -Export      export 형식으로 출력"
-        Write-Host "    -Apply       프로젝트 루트 .env 파일에 즉시 반영"
-        Write-Host ""
-        Write-Host "예제:"
-        Write-Host "    .\generate-env-keys.ps1 -Create"
-        Write-Host "    .\generate-env-keys.ps1 -Export"
-        Write-Host "    .\generate-env-keys.ps1 -Apply"
-    }
-}
-
-if (-not $Create -and -not $Export -and -not $Apply) {
-    Show-Help
-    exit 0
-}
-
-function New-RandomHex {
-    param([int]$Bytes)
-    $rng = [System.Security.Cryptography.RandomNumberGenerator]::Create()
-    $buf = New-Object byte[] $Bytes
-    $rng.GetBytes($buf)
-    return ($buf | ForEach-Object { $_.ToString("x2") }) -join ""
-}
-
-$EncryptionKey = New-RandomHex 16
-$JwtSecret = New-RandomHex 32
-
-if ($Export) {
-    Write-Host "SET ENCRYPTION_KEY=$EncryptionKey"
-    Write-Host "SET JWT_SECRET=$JwtSecret"
-    Write-Host ""
-    Write-Host "# PowerShell:"
-    Write-Host "`$env:ENCRYPTION_KEY=`"$EncryptionKey`""
-    Write-Host "`$env:JWT_SECRET=`"$JwtSecret`""
-} elseif ($Create) {
-    if ($Language -eq "en") { Write-Host "# Copy & paste to .env" }
-    else { Write-Host "# .env에 복사해서 붙여넣기" }
-    Write-Host "ENCRYPTION_KEY=$EncryptionKey"
-    Write-Host "JWT_SECRET=$JwtSecret"
-} elseif ($Apply) {
-    $EnvFile = Join-Path $ProjectRoot ".env"
-    if (-not (Test-Path $EnvFile)) { New-Item -ItemType File -Path $EnvFile | Out-Null }
-
-    function Update-EnvKey {
-        param([string]$File, [string]$Key, [string]$Value)
-        $content = Get-Content $File
-        $found = $false
-        $newContent = $content | ForEach-Object {
-            if ($_ -match "^$Key=") {
-                $found = $true
-                "$Key=$Value"
-            } else { $_ }
-        }
-        if (-not $found) { $newContent += "$Key=$Value" }
-        $newContent | Set-Content $File
-    }
-
-    Update-EnvKey $EnvFile "ENCRYPTION_KEY" $EncryptionKey
-    Update-EnvKey $EnvFile "JWT_SECRET" $JwtSecret
-
-    if ($Language -eq "en") {
-        Write-Host "OK Updated: $EnvFile"
-        Write-Host "  - ENCRYPTION_KEY"
-        Write-Host "  - JWT_SECRET"
-    } else {
-        Write-Host "OK 업데이트 완료: $EnvFile"
-        Write-Host "  - ENCRYPTION_KEY"
-        Write-Host "  - JWT_SECRET"
-    }
-}
+# Generate Environment Keys/Secrets - Windows PowerShell
+# Generates ENCRYPTION_KEY and JWT_SECRET random values
+param(
+    [switch]$Create,
+    [switch]$Export,
+    [switch]$Apply
+)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectRoot = Split-Path -Parent $ScriptDir
+
+# Load language from .env (env var takes priority)
+$Language = $env:LANGUAGE
+if (-not $Language) {
+    $EnvFile = Join-Path $ProjectRoot ".env"
+    if (Test-Path $EnvFile) {
+        $LangLine = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -Last 1
+        if ($LangLine) { $Language = $LangLine -replace '^LANGUAGE=', '' }
+    }
+}
+if (-not $Language) { $Language = "ko" }
+
+function Show-Help {
+    if ($Language -eq "en") {
+        Write-Host "Generate Environment Keys/Secrets"
+        Write-Host "==================================="
+        Write-Host ""
+        Write-Host "Generates random values for ENCRYPTION_KEY and JWT_SECRET."
+        Write-Host ""
+        Write-Host "Note: API keys (api_keys entity) are managed via DB commands:"
+        Write-Host "      .\scripts\api-key.ps1 add --role=admin --apply"
+        Write-Host ""
+        Write-Host "Usage: .\generate-env-keys.ps1 [-Create|-Export|-Apply]"
+        Write-Host ""
+        Write-Host "Options:"
+        Write-Host "    -Create      Print copy/paste format for .env"
+        Write-Host "    -Export      Print shell export format"
+        Write-Host "    -Apply       Apply values directly to project .env"
+        Write-Host ""
+        Write-Host "Examples:"
+        Write-Host "    .\generate-env-keys.ps1 -Create"
+        Write-Host "    .\generate-env-keys.ps1 -Export"
+        Write-Host "    .\generate-env-keys.ps1 -Apply"
+    } else {
+        Write-Host "환경 변수 키/시크릿 생성"
+        Write-Host "======================="
+        Write-Host ""
+        Write-Host "ENCRYPTION_KEY, JWT_SECRET 랜덤 값을 생성합니다."
+        Write-Host ""
+        Write-Host "참고: API 키(api_keys 엔티티)는 DB 명령으로 관리합니다:"
+        Write-Host "      .\scripts\api-key.ps1 add --role=admin --apply"
+        Write-Host ""
+        Write-Host "사용법: .\generate-env-keys.ps1 [-Create|-Export|-Apply]"
+        Write-Host ""
+        Write-Host "옵션:"
+        Write-Host "    -Create      .env 복붙 형식으로 출력"
+        Write-Host "    -Export      export 형식으로 출력"
+        Write-Host "    -Apply       프로젝트 루트 .env 파일에 즉시 반영"
+        Write-Host ""
+        Write-Host "예제:"
+        Write-Host "    .\generate-env-keys.ps1 -Create"
+        Write-Host "    .\generate-env-keys.ps1 -Export"
+        Write-Host "    .\generate-env-keys.ps1 -Apply"
+    }
+}
+
+if (-not $Create -and -not $Export -and -not $Apply) {
+    Show-Help
+    exit 0
+}
+
+function New-RandomHex {
+    param([int]$Bytes)
+    $rng = [System.Security.Cryptography.RandomNumberGenerator]::Create()
+    $buf = New-Object byte[] $Bytes
+    $rng.GetBytes($buf)
+    return ($buf | ForEach-Object { $_.ToString("x2") }) -join ""
+}
+
+$EncryptionKey = New-RandomHex 16
+$JwtSecret = New-RandomHex 32
+
+if ($Export) {
+    Write-Host "SET ENCRYPTION_KEY=$EncryptionKey"
+    Write-Host "SET JWT_SECRET=$JwtSecret"
+    Write-Host ""
+    Write-Host "# PowerShell:"
+    Write-Host "`$env:ENCRYPTION_KEY=`"$EncryptionKey`""
+    Write-Host "`$env:JWT_SECRET=`"$JwtSecret`""
+} elseif ($Create) {
+    if ($Language -eq "en") { Write-Host "# Copy & paste to .env" }
+    else { Write-Host "# .env에 복사해서 붙여넣기" }
+    Write-Host "ENCRYPTION_KEY=$EncryptionKey"
+    Write-Host "JWT_SECRET=$JwtSecret"
+} elseif ($Apply) {
+    $EnvFile = Join-Path $ProjectRoot ".env"
+    if (-not (Test-Path $EnvFile)) { New-Item -ItemType File -Path $EnvFile | Out-Null }
+
+    function Update-EnvKey {
+        param([string]$File, [string]$Key, [string]$Value)
+        $content = Get-Content $File
+        $found = $false
+        $newContent = $content | ForEach-Object {
+            if ($_ -match "^$Key=") {
+                $found = $true
+                "$Key=$Value"
+            } else { $_ }
+        }
+        if (-not $found) { $newContent += "$Key=$Value" }
+        $newContent | Set-Content $File
+    }
+
+    Update-EnvKey $EnvFile "ENCRYPTION_KEY" $EncryptionKey
+    Update-EnvKey $EnvFile "JWT_SECRET" $JwtSecret
+
+    if ($Language -eq "en") {
+        Write-Host "OK Updated: $EnvFile"
+        Write-Host "  - ENCRYPTION_KEY"
+        Write-Host "  - JWT_SECRET"
+    } else {
+        Write-Host "OK 업데이트 완료: $EnvFile"
+        Write-Host "  - ENCRYPTION_KEY"
+        Write-Host "  - JWT_SECRET"
+    }
+}

package/template/scripts/normalize-entities.ps1

@@ -1,87 +1,87 @@
-# normalize-entities.ps1 — 엔티티 JSON 정규화
-#
-# 사용법:
-#   .\scripts\normalize-entities.ps1                        # 도움말
-#   .\scripts\normalize-entities.ps1 -Apply                 # 전체 정규화
-#   .\scripts\normalize-entities.ps1 -Entity account        # account dry-run
-#   .\scripts\normalize-entities.ps1 -Entity account -Apply # account 정규화
-
-param(
-    [string]$Entity = "",
-    [switch]$Apply
-)
-
-$ErrorActionPreference = "Stop"
-
-$ProjectRoot = Split-Path -Parent $PSScriptRoot
-Set-Location $ProjectRoot
-
-# LANGUAGE 로드
-$Lang = $env:LANGUAGE
-if (-not $Lang) {
-    $EnvFile = Join-Path $ProjectRoot ".env"
-    if (Test-Path $EnvFile) {
-        $line = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -Last 1
-        if ($line) { $Lang = $line -replace '^LANGUAGE=', '' }
-    }
-}
-if (-not $Lang) { $Lang = "ko" }
-
-function Show-Help {
-    if ($Lang -eq "en") {
-        Write-Host "Normalize Entity JSON"
-        Write-Host "====================="
-        Write-Host ""
-        Write-Host "Remove redundant default values and reorder keys in entity JSON files."
-        Write-Host "Also auto-creates missing required entities (api_keys, rbac_roles, and account/user when JWT is enabled)."
-        Write-Host ""
-        Write-Host "Usage: .\scripts\normalize-entities.ps1 [-Entity <name>] [-Apply]"
-        Write-Host ""
-        Write-Host "Options:"
-        Write-Host "  -Apply           Apply changes (default is dry-run)"
-        Write-Host "  -Entity <name>   Normalize a single entity only"
-        Write-Host ""
-        Write-Host "Examples:"
-        Write-Host "  .\scripts\normalize-entities.ps1                         # Dry-run all"
-        Write-Host "  .\scripts\normalize-entities.ps1 -Apply                  # Normalize all"
-        Write-Host "  .\scripts\normalize-entities.ps1 -Entity account         # Dry-run account"
-        Write-Host "  .\scripts\normalize-entities.ps1 -Entity account -Apply  # Normalize account"
-    } else {
-        Write-Host "엔티티 JSON 정규화"
-        Write-Host "=================="
-        Write-Host ""
-        Write-Host "엔티티 JSON 파일에서 불필요한 기본값을 제거하고 키 순서를 정렬합니다."
-        Write-Host "전체 모드에서는 필수 엔티티(api_keys, rbac_roles, JWT 사용 시 account/user)가 없으면 자동 생성합니다."
-        Write-Host ""
-        Write-Host "사용법: .\scripts\normalize-entities.ps1 [-Entity <이름>] [-Apply]"
-        Write-Host ""
-        Write-Host "옵션:"
-        Write-Host "  -Apply           실제 파일 수정 (기본은 dry-run)"
-        Write-Host "  -Entity <이름>   단일 엔티티만 정규화"
-        Write-Host ""
-        Write-Host "예제:"
-        Write-Host "  .\scripts\normalize-entities.ps1                         # 전체 dry-run"
-        Write-Host "  .\scripts\normalize-entities.ps1 -Apply                  # 전체 정규화"
-        Write-Host "  .\scripts\normalize-entities.ps1 -Entity account         # account dry-run"
-        Write-Host "  .\scripts\normalize-entities.ps1 -Entity account -Apply  # account 정규화"
-    }
-}
-
-# 인자 없으면 도움말
-if (-not $Apply -and -not $Entity) {
-    Show-Help
-    exit 0
-}
-
-$CliBin = Join-Path $ProjectRoot "entity-cli.exe"
-if (-not (Test-Path $CliBin)) {
-    if ($Lang -eq "en") { Write-Error "❌ entity-cli.exe not found. Run scripts\build.sh first." }
-    else                { Write-Error "❌ entity-cli.exe 파일이 없습니다. scripts\build.sh 를 먼저 실행하세요." }
-    exit 1
-}
-
-$Args = @("normalize-entities")
-if ($Entity) { $Args += "--entity=$Entity" }
-if ($Apply)  { $Args += "--apply" }
-
-& $CliBin @Args
+# normalize-entities.ps1 — 엔티티 JSON 정규화
+#
+# 사용법:
+#   .\scripts\normalize-entities.ps1                        # 도움말
+#   .\scripts\normalize-entities.ps1 -Apply                 # 전체 정규화
+#   .\scripts\normalize-entities.ps1 -Entity account        # account dry-run
+#   .\scripts\normalize-entities.ps1 -Entity account -Apply # account 정규화
+
+param(
+    [string]$Entity = "",
+    [switch]$Apply
+)
+
+$ErrorActionPreference = "Stop"
+
+$ProjectRoot = Split-Path -Parent $PSScriptRoot
+Set-Location $ProjectRoot
+
+# LANGUAGE 로드
+$Lang = $env:LANGUAGE
+if (-not $Lang) {
+    $EnvFile = Join-Path $ProjectRoot ".env"
+    if (Test-Path $EnvFile) {
+        $line = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -Last 1
+        if ($line) { $Lang = $line -replace '^LANGUAGE=', '' }
+    }
+}
+if (-not $Lang) { $Lang = "ko" }
+
+function Show-Help {
+    if ($Lang -eq "en") {
+        Write-Host "Normalize Entity JSON"
+        Write-Host "====================="
+        Write-Host ""
+        Write-Host "Remove redundant default values and reorder keys in entity JSON files."
+        Write-Host "Also auto-creates missing required entities (api_keys, rbac_roles, and account/user when JWT is enabled)."
+        Write-Host ""
+        Write-Host "Usage: .\scripts\normalize-entities.ps1 [-Entity <name>] [-Apply]"
+        Write-Host ""
+        Write-Host "Options:"
+        Write-Host "  -Apply           Apply changes (default is dry-run)"
+        Write-Host "  -Entity <name>   Normalize a single entity only"
+        Write-Host ""
+        Write-Host "Examples:"
+        Write-Host "  .\scripts\normalize-entities.ps1                         # Dry-run all"
+        Write-Host "  .\scripts\normalize-entities.ps1 -Apply                  # Normalize all"
+        Write-Host "  .\scripts\normalize-entities.ps1 -Entity account         # Dry-run account"
+        Write-Host "  .\scripts\normalize-entities.ps1 -Entity account -Apply  # Normalize account"
+    } else {
+        Write-Host "엔티티 JSON 정규화"
+        Write-Host "=================="
+        Write-Host ""
+        Write-Host "엔티티 JSON 파일에서 불필요한 기본값을 제거하고 키 순서를 정렬합니다."
+        Write-Host "전체 모드에서는 필수 엔티티(api_keys, rbac_roles, JWT 사용 시 account/user)가 없으면 자동 생성합니다."
+        Write-Host ""
+        Write-Host "사용법: .\scripts\normalize-entities.ps1 [-Entity <이름>] [-Apply]"
+        Write-Host ""
+        Write-Host "옵션:"
+        Write-Host "  -Apply           실제 파일 수정 (기본은 dry-run)"
+        Write-Host "  -Entity <이름>   단일 엔티티만 정규화"
+        Write-Host ""
+        Write-Host "예제:"
+        Write-Host "  .\scripts\normalize-entities.ps1                         # 전체 dry-run"
+        Write-Host "  .\scripts\normalize-entities.ps1 -Apply                  # 전체 정규화"
+        Write-Host "  .\scripts\normalize-entities.ps1 -Entity account         # account dry-run"
+        Write-Host "  .\scripts\normalize-entities.ps1 -Entity account -Apply  # account 정규화"
+    }
+}
+
+# 인자 없으면 도움말
+if (-not $Apply -and -not $Entity) {
+    Show-Help
+    exit 0
+}
+
+$CliBin = Join-Path $ProjectRoot "entity-cli.exe"
+if (-not (Test-Path $CliBin)) {
+    if ($Lang -eq "en") { Write-Error "❌ entity-cli.exe not found. Run scripts\build.sh first." }
+    else                { Write-Error "❌ entity-cli.exe 파일이 없습니다. scripts\build.sh 를 먼저 실행하세요." }
+    exit 1
+}
+
+$Args = @("normalize-entities")
+if ($Entity) { $Args += "--entity=$Entity" }
+if ($Apply)  { $Args += "--apply" }
+
+& $CliBin @Args