create-entity-server 0.7.8 → 0.7.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-entity-server",
-  "version": "0.7.8",
+  "version": "0.7.12",
   "description": "Create a new entity-server project in one command — like create-react-app or create-vite.",
   "keywords": [
     "entity-server",

package/template/entities/System/Storage/file_meta.json

@@ -11,6 +11,12 @@
             "type": ["none", "pending", "synced", "failed", "skipped"],
             "default": "none"
         },
+        "is_public": {
+            "index_only": true,
+            "comment": "공개 파일 여부 (인증 없이 GET 접근 가능)",
+            "type": "boolean",
+            "default": false
+        },
         "size": {
             "index": true,
             "comment": "파일 크기 (bytes)",

package/template/scripts/api-key.ps1

@@ -1,123 +1,123 @@
-# API Key Management Script (CLI mode) - Windows PowerShell
-# Can be used even when the server is stopped.
-param(
-    [Parameter(Position=0)]
-    [string]$SubCommand = ""
-)
-
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectRoot = Split-Path -Parent $ScriptDir
-$BinPath = Join-Path $ProjectRoot "bin\entity-cli.exe"
-
-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 "API Key Management (CLI mode)"
-        Write-Host "============================="
-        Write-Host ""
-        Write-Host "Manage api_keys entity directly via CLI binary."
-        Write-Host "Server does NOT need to be running."
-        Write-Host ""
-        Write-Host "Usage: .\api-key.ps1 <subcommand> [options]"
-        Write-Host ""
-        Write-Host "Subcommands:"
-        Write-Host "  list              List API keys"
-        Write-Host "  add               Create a new API key (key/secret auto-generated)"
-        Write-Host "  delete            Delete an API key by seq"
-        Write-Host "  help              Show this help"
-        Write-Host ""
-        Write-Host "list options:"
-        Write-Host "  --limit=<n>       Max rows to show (default: 20)"
-        Write-Host ""
-        Write-Host "add options:"
-        Write-Host "  --role=<name>     Role name (default: admin)"
-        Write-Host "  --entities=<json> Allowed entities JSON (default: [`"*`"])"
-        Write-Host "  --description=<t> Description"
-        Write-Host "  --user-seq=<n>    Associated user seq"
-        Write-Host "  --apply           Execute (default is dry-run)"
-        Write-Host ""
-        Write-Host "delete options:"
-        Write-Host "  --seq=<n>         API key seq to delete (required)"
-        Write-Host "  --apply           Execute (default is dry-run)"
-        Write-Host ""
-        Write-Host "Examples:"
-        Write-Host "  .\api-key.ps1 list"
-        Write-Host "  .\api-key.ps1 list --limit=50"
-        Write-Host "  .\api-key.ps1 add --role=admin --apply"
-        Write-Host "  .\api-key.ps1 delete --seq=3 --apply"
-    } else {
-        Write-Host "API 키 관리 (CLI 모드)"
-        Write-Host "===================="
-        Write-Host ""
-        Write-Host "CLI 바이너리로 api_keys 엔티티를 직접 조작합니다."
-        Write-Host "서버가 실행 중이지 않아도 사용 가능합니다."
-        Write-Host ""
-        Write-Host "사용법: .\api-key.ps1 <하위명령> [옵션]"
-        Write-Host ""
-        Write-Host "하위 명령:"
-        Write-Host "  list              API 키 목록 조회"
-        Write-Host "  add               새 API 키 생성 (키/시크릿 자동 생성)"
-        Write-Host "  delete            API 키 삭제 (seq 지정)"
-        Write-Host "  help              도움말 출력"
-        Write-Host ""
-        Write-Host "list 옵션:"
-        Write-Host "  --limit=<n>       최대 출력 행 수 (기본: 20)"
-        Write-Host ""
-        Write-Host "add 옵션:"
-        Write-Host "  --role=<이름>     역할명 (기본: admin)"
-        Write-Host "  --entities=<json> 허용 엔티티 JSON (기본: [`"*`"])"
-        Write-Host "  --description=<t> 설명"
-        Write-Host "  --user-seq=<n>    연결 사용자 seq"
-        Write-Host "  --apply           실제 실행 (기본: dry-run)"
-        Write-Host ""
-        Write-Host "delete 옵션:"
-        Write-Host "  --seq=<n>         삭제할 API 키 seq (필수)"
-        Write-Host "  --apply           실제 실행 (기본: dry-run)"
-        Write-Host ""
-        Write-Host "예제:"
-        Write-Host "  .\api-key.ps1 list"
-        Write-Host "  .\api-key.ps1 list --limit=50"
-        Write-Host "  .\api-key.ps1 add --role=admin --apply"
-        Write-Host "  .\api-key.ps1 delete --seq=3 --apply"
-    }
-}
-
-if (-not $SubCommand) {
-    Show-Help
-    exit 0
-}
-
-if (-not (Test-Path $BinPath)) {
-    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found. Run: .\scripts\build.ps1" }
-    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다. 먼저 .\scripts\build.ps1 를 실행하세요." }
-    exit 1
-}
-
-# Collect remaining args (all args after SubCommand)
-$remainingArgs = $args
-
-switch ($SubCommand) {
-    { $_ -in @("list", "show", "add", "delete") } {
-        $env:ENTITY_CLI_NAME = "api-key"
-        & $BinPath api-key $SubCommand @remainingArgs
-    }
-    { $_ -in @("help", "-h", "--help") } {
-        Show-Help
-    }
-    default {
-        if ($Language -eq "en") { Write-Host "X Unknown subcommand: $SubCommand" }
-        else { Write-Host "X 알 수 없는 하위 명령: $SubCommand" }
-        Write-Host ""
-        Show-Help
-        exit 1
-    }
-}
+# API Key Management Script (CLI mode) - Windows PowerShell
+# Can be used even when the server is stopped.
+param(
+    [Parameter(Position=0)]
+    [string]$SubCommand = ""
+)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectRoot = Split-Path -Parent $ScriptDir
+$BinPath = Join-Path $ProjectRoot "bin\entity-cli.exe"
+
+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 "API Key Management (CLI mode)"
+        Write-Host "============================="
+        Write-Host ""
+        Write-Host "Manage api_keys entity directly via CLI binary."
+        Write-Host "Server does NOT need to be running."
+        Write-Host ""
+        Write-Host "Usage: .\api-key.ps1 <subcommand> [options]"
+        Write-Host ""
+        Write-Host "Subcommands:"
+        Write-Host "  list              List API keys"
+        Write-Host "  add               Create a new API key (key/secret auto-generated)"
+        Write-Host "  delete            Delete an API key by seq"
+        Write-Host "  help              Show this help"
+        Write-Host ""
+        Write-Host "list options:"
+        Write-Host "  --limit=<n>       Max rows to show (default: 20)"
+        Write-Host ""
+        Write-Host "add options:"
+        Write-Host "  --role=<name>     Role name (default: admin)"
+        Write-Host "  --entities=<json> Allowed entities JSON (default: [`"*`"])"
+        Write-Host "  --description=<t> Description"
+        Write-Host "  --user-seq=<n>    Associated user seq"
+        Write-Host "  --apply           Execute (default is dry-run)"
+        Write-Host ""
+        Write-Host "delete options:"
+        Write-Host "  --seq=<n>         API key seq to delete (required)"
+        Write-Host "  --apply           Execute (default is dry-run)"
+        Write-Host ""
+        Write-Host "Examples:"
+        Write-Host "  .\api-key.ps1 list"
+        Write-Host "  .\api-key.ps1 list --limit=50"
+        Write-Host "  .\api-key.ps1 add --role=admin --apply"
+        Write-Host "  .\api-key.ps1 delete --seq=3 --apply"
+    } else {
+        Write-Host "API 키 관리 (CLI 모드)"
+        Write-Host "===================="
+        Write-Host ""
+        Write-Host "CLI 바이너리로 api_keys 엔티티를 직접 조작합니다."
+        Write-Host "서버가 실행 중이지 않아도 사용 가능합니다."
+        Write-Host ""
+        Write-Host "사용법: .\api-key.ps1 <하위명령> [옵션]"
+        Write-Host ""
+        Write-Host "하위 명령:"
+        Write-Host "  list              API 키 목록 조회"
+        Write-Host "  add               새 API 키 생성 (키/시크릿 자동 생성)"
+        Write-Host "  delete            API 키 삭제 (seq 지정)"
+        Write-Host "  help              도움말 출력"
+        Write-Host ""
+        Write-Host "list 옵션:"
+        Write-Host "  --limit=<n>       최대 출력 행 수 (기본: 20)"
+        Write-Host ""
+        Write-Host "add 옵션:"
+        Write-Host "  --role=<이름>     역할명 (기본: admin)"
+        Write-Host "  --entities=<json> 허용 엔티티 JSON (기본: [`"*`"])"
+        Write-Host "  --description=<t> 설명"
+        Write-Host "  --user-seq=<n>    연결 사용자 seq"
+        Write-Host "  --apply           실제 실행 (기본: dry-run)"
+        Write-Host ""
+        Write-Host "delete 옵션:"
+        Write-Host "  --seq=<n>         삭제할 API 키 seq (필수)"
+        Write-Host "  --apply           실제 실행 (기본: dry-run)"
+        Write-Host ""
+        Write-Host "예제:"
+        Write-Host "  .\api-key.ps1 list"
+        Write-Host "  .\api-key.ps1 list --limit=50"
+        Write-Host "  .\api-key.ps1 add --role=admin --apply"
+        Write-Host "  .\api-key.ps1 delete --seq=3 --apply"
+    }
+}
+
+if (-not $SubCommand) {
+    Show-Help
+    exit 0
+}
+
+if (-not (Test-Path $BinPath)) {
+    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found. Run: .\scripts\build.ps1" }
+    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다. 먼저 .\scripts\build.ps1 를 실행하세요." }
+    exit 1
+}
+
+# Collect remaining args (all args after SubCommand)
+$remainingArgs = $args
+
+switch ($SubCommand) {
+    { $_ -in @("list", "show", "add", "delete") } {
+        $env:ENTITY_CLI_NAME = "api-key"
+        & $BinPath api-key $SubCommand @remainingArgs
+    }
+    { $_ -in @("help", "-h", "--help") } {
+        Show-Help
+    }
+    default {
+        if ($Language -eq "en") { Write-Host "X Unknown subcommand: $SubCommand" }
+        else { Write-Host "X 알 수 없는 하위 명령: $SubCommand" }
+        Write-Host ""
+        Show-Help
+        exit 1
+    }
+}

package/template/scripts/cleanup-history.ps1

@@ -1,69 +1,69 @@
-# cleanup-history.ps1 — history_ttl 기준 이력 정리
-#
-# 사용법:
-#   .\scripts\cleanup-history.ps1                        # 도움말
-#   .\scripts\cleanup-history.ps1 --apply                # 전체 이력 정리 실행
-#   .\scripts\cleanup-history.ps1 --entity=account       # dry-run (특정 엔티티)
-#   .\scripts\cleanup-history.ps1 --entity=account --apply
-
-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 "History TTL Cleanup"
-        Write-Host "==================="
-        Write-Host ""
-        Write-Host "Usage: .\scripts\cleanup-history.ps1 [-Entity <name>] [-Apply]"
-        Write-Host ""
-        Write-Host "Options:"
-        Write-Host "  -Entity <name>   Cleanup only one entity history"
-        Write-Host "  -Apply           Execute delete (default: dry-run)"
-    } else {
-        Write-Host "히스토리 TTL 정리"
-        Write-Host "================"
-        Write-Host ""
-        Write-Host "사용법: .\scripts\cleanup-history.ps1 [-Entity <이름>] [-Apply]"
-        Write-Host ""
-        Write-Host "옵션:"
-        Write-Host "  -Entity <이름>   특정 엔티티 히스토리만 정리"
-        Write-Host "  -Apply           실제 삭제 실행 (기본: dry-run)"
-    }
-}
-
-# 인자 없으면 도움말
-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" }
-    else                { Write-Error "❌ entity-cli.exe 파일이 없습니다" }
-    exit 1
-}
-
-$Args = @("cleanup-history")
-if ($Entity) { $Args += "--entity=$Entity" }
-if ($Apply)  { $Args += "--apply" }
-
-& $CliBin @Args
+# cleanup-history.ps1 — history_ttl 기준 이력 정리
+#
+# 사용법:
+#   .\scripts\cleanup-history.ps1                        # 도움말
+#   .\scripts\cleanup-history.ps1 --apply                # 전체 이력 정리 실행
+#   .\scripts\cleanup-history.ps1 --entity=account       # dry-run (특정 엔티티)
+#   .\scripts\cleanup-history.ps1 --entity=account --apply
+
+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 "History TTL Cleanup"
+        Write-Host "==================="
+        Write-Host ""
+        Write-Host "Usage: .\scripts\cleanup-history.ps1 [-Entity <name>] [-Apply]"
+        Write-Host ""
+        Write-Host "Options:"
+        Write-Host "  -Entity <name>   Cleanup only one entity history"
+        Write-Host "  -Apply           Execute delete (default: dry-run)"
+    } else {
+        Write-Host "히스토리 TTL 정리"
+        Write-Host "================"
+        Write-Host ""
+        Write-Host "사용법: .\scripts\cleanup-history.ps1 [-Entity <이름>] [-Apply]"
+        Write-Host ""
+        Write-Host "옵션:"
+        Write-Host "  -Entity <이름>   특정 엔티티 히스토리만 정리"
+        Write-Host "  -Apply           실제 삭제 실행 (기본: dry-run)"
+    }
+}
+
+# 인자 없으면 도움말
+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" }
+    else                { Write-Error "❌ entity-cli.exe 파일이 없습니다" }
+    exit 1
+}
+
+$Args = @("cleanup-history")
+if ($Entity) { $Args += "--entity=$Entity" }
+if ($Apply)  { $Args += "--apply" }
+
+& $CliBin @Args

package/template/scripts/cli.ps1

@@ -1,24 +1,24 @@
-# Entity CLI wrapper script (Windows PowerShell)
-
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectRoot = Split-Path -Parent $ScriptDir
-$BinPath = Join-Path $ProjectRoot "bin\entity-cli.exe"
-
-# 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=', '' }
-}
-
-# Require prebuilt CLI binary
-if (-not (Test-Path $BinPath)) {
-    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found" }
-    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다" }
-    exit 1
-}
-
-Set-Location $ProjectRoot
-$env:ENTITY_CLI_NAME = "cli"
-& $BinPath @args
+# Entity CLI wrapper script (Windows PowerShell)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectRoot = Split-Path -Parent $ScriptDir
+$BinPath = Join-Path $ProjectRoot "bin\entity-cli.exe"
+
+# 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=', '' }
+}
+
+# Require prebuilt CLI binary
+if (-not (Test-Path $BinPath)) {
+    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found" }
+    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다" }
+    exit 1
+}
+
+Set-Location $ProjectRoot
+$env:ENTITY_CLI_NAME = "cli"
+& $BinPath @args

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