sayren 0.3.3 → 0.4.0

package/dist/index.mjs

@@ -1278,6 +1278,150 @@ const cli_deploy_build_in_progress = ((inputs = {}, options = {}) => {
 	return ko_cli_deploy_build_in_progress(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_deploy_build_local_failed.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ code: NonNullable<unknown> }} Cli_Deploy_Build_Local_FailedInputs */
+const ko_cli_deploy_build_local_failed = (i) => {
+	return `로컬 빌드가 실패해 올리지 않았습니다(종료 코드 ${i?.code}). 위 출력을 확인해 고친 뒤 다시 배포하십시오. 빌드를 확인하지 않고 올리려면 --skip-build를 붙이십시오`;
+};
+/**
+
+* @param {Cli_Deploy_Build_Local_FailedInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_deploy_build_local_failed = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_deploy_build_local_failed(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_deploy_build_local_no_deps.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Deploy_Build_Local_No_DepsInputs */
+const ko_cli_deploy_build_local_no_deps = () => {
+	return `의존성이 설치되지 않아(node_modules 없음) 로컬 빌드를 건너뜁니다. npm install --ignore-scripts 뒤 배포하면 올리기 전에 빌드를 확인합니다`;
+};
+/**
+
+* @param {Cli_Deploy_Build_Local_No_DepsInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_deploy_build_local_no_deps = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_deploy_build_local_no_deps(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_deploy_build_local_no_script.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Deploy_Build_Local_No_ScriptInputs */
+const ko_cli_deploy_build_local_no_script = () => {
+	return `package.json에 build 스크립트가 없어 로컬 빌드를 건너뜁니다`;
+};
+/**
+
+* @param {Cli_Deploy_Build_Local_No_ScriptInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_deploy_build_local_no_script = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_deploy_build_local_no_script(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_deploy_build_local_output.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ count: NonNullable<unknown> }} Cli_Deploy_Build_Local_OutputInputs */
+const ko_cli_deploy_build_local_output = (i) => {
+	return `빌드 출력(마지막 ${i?.count}줄):`;
+};
+/**
+
+* @param {Cli_Deploy_Build_Local_OutputInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_deploy_build_local_output = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_deploy_build_local_output(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_deploy_build_local_passed.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ seconds: NonNullable<unknown> }} Cli_Deploy_Build_Local_PassedInputs */
+const ko_cli_deploy_build_local_passed = (i) => {
+	return `로컬 빌드 통과(${i?.seconds}초)`;
+};
+/**
+
+* @param {Cli_Deploy_Build_Local_PassedInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_deploy_build_local_passed = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_deploy_build_local_passed(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_deploy_build_local_running.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Deploy_Build_Local_RunningInputs */
+const ko_cli_deploy_build_local_running = () => {
+	return `로컬 빌드(npm run build)를 실행합니다. 서버 빌드가 실패할 것을 올리기 전에 확인합니다`;
+};
+/**
+
+* @param {Cli_Deploy_Build_Local_RunningInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_deploy_build_local_running = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_deploy_build_local_running(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_deploy_build_local_skipped_flag.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Deploy_Build_Local_Skipped_FlagInputs */
+const ko_cli_deploy_build_local_skipped_flag = () => {
+	return `로컬 빌드를 건너뜁니다(--skip-build). 서버 빌드가 같은 빌드를 다시 합니다`;
+};
+/**
+
+* @param {Cli_Deploy_Build_Local_Skipped_FlagInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_deploy_build_local_skipped_flag = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_deploy_build_local_skipped_flag(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_deploy_build_local_spawn_failed.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ message: NonNullable<unknown> }} Cli_Deploy_Build_Local_Spawn_FailedInputs */
+const ko_cli_deploy_build_local_spawn_failed = (i) => {
+	return `로컬 빌드를 시작하지 못해 올리지 않았습니다(${i?.message}). npm이 PATH에 있는지 확인하거나 --skip-build를 붙이십시오`;
+};
+/**
+
+* @param {Cli_Deploy_Build_Local_Spawn_FailedInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_deploy_build_local_spawn_failed = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_deploy_build_local_spawn_failed(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/cli_deploy_build_started.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -1890,6 +2034,295 @@ const cli_flag_value_required = ((inputs, options = {}) => {
 	return ko_cli_flag_value_required(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_confirm.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Init_ConfirmInputs */
+const ko_cli_init_confirm = () => {
+	return `사이트를 만드시겠습니까?`;
+};
+/**
+
+* @param {Cli_Init_ConfirmInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_confirm = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_confirm(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_created.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ url: NonNullable<unknown> }} Cli_Init_CreatedInputs */
+const ko_cli_init_created = (i) => {
+	return `사이트를 만들었습니다 — ${i?.url} (오픈 준비 중, 반영까지 1분 안팎)`;
+};
+/**
+
+* @param {Cli_Init_CreatedInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_created = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_created(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_dir_not_empty.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ dir: NonNullable<unknown> }} Cli_Init_Dir_Not_EmptyInputs */
+const ko_cli_init_dir_not_empty = (i) => {
+	return `폴더가 비어 있지 않습니다: ${i?.dir}. 빈 폴더나 새 폴더 이름을 주십시오`;
+};
+/**
+
+* @param {Cli_Init_Dir_Not_EmptyInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_dir_not_empty = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_dir_not_empty(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_hosting_disabled.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Init_Hosting_DisabledInputs */
+const ko_cli_init_hosting_disabled = () => {
+	return `지금은 새 호스팅 사이트를 만들 수 없습니다(호스팅 기능이 꺼져 있습니다)`;
+};
+/**
+
+* @param {Cli_Init_Hosting_DisabledInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_hosting_disabled = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_hosting_disabled(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_inside_pulled.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Init_Inside_PulledInputs */
+const ko_cli_init_inside_pulled = () => {
+	return `지금 폴더는 이미 받은 사이트 폴더입니다. 새 사이트는 다른 폴더에서 npx sayren init <폴더>로 만들고, 이 사이트를 다시 받으려면 npx sayren pull --force를 쓰십시오`;
+};
+/**
+
+* @param {Cli_Init_Inside_PulledInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_inside_pulled = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_inside_pulled(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_no_templates.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Init_No_TemplatesInputs */
+const ko_cli_init_no_templates = () => {
+	return `쓸 수 있는 템플릿이 없습니다`;
+};
+/**
+
+* @param {Cli_Init_No_TemplatesInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_no_templates = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_no_templates(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_pull_failed.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ storeId: NonNullable<unknown> }} Cli_Init_Pull_FailedInputs */
+const ko_cli_init_pull_failed = (i) => {
+	return `사이트는 만들었지만 소스를 받지 못했습니다. 다시 만들지 말고 npx sayren pull --project ${i?.storeId}로 받으십시오`;
+};
+/**
+
+* @param {Cli_Init_Pull_FailedInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_pull_failed = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_pull_failed(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_site_exists.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ storeId: NonNullable<unknown> }} Cli_Init_Site_ExistsInputs */
+const ko_cli_init_site_exists = (i) => {
+	return `이 상점에는 이미 호스팅 사이트가 있어 새로 만들지 않았습니다. npx sayren pull --project ${i?.storeId}로 소스를 받으십시오`;
+};
+/**
+
+* @param {Cli_Init_Site_ExistsInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_site_exists = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_site_exists(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_site_url.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ url: NonNullable<unknown> }} Cli_Init_Site_UrlInputs */
+const ko_cli_init_site_url = (i) => {
+	return `지금 사이트: ${i?.url}`;
+};
+/**
+
+* @param {Cli_Init_Site_UrlInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_site_url = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_site_url(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_slug_taken.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Init_Slug_TakenInputs */
+const ko_cli_init_slug_taken = () => {
+	return `상점 코드와 같은 주소를 다른 사이트가 쓰고 있어 만들지 못했습니다. 상점 플랫폼 › 스토어프론트에서 다른 주소로 만든 뒤 npx sayren pull로 받으십시오`;
+};
+/**
+
+* @param {Cli_Init_Slug_TakenInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_slug_taken = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_slug_taken(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_summary.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ storeId: NonNullable<unknown>, name: NonNullable<unknown>, templateId: NonNullable<unknown>, version: NonNullable<unknown> }} Cli_Init_SummaryInputs */
+const ko_cli_init_summary = (i) => {
+	return `상점 ${i?.storeId}에 템플릿 ${i?.name}(${i?.templateId} v${i?.version})로 호스팅 사이트를 만듭니다. 주소는 상점 코드이고 오픈 준비 중으로 시작합니다. 만들기는 상점당 30일에 3번까지입니다`;
+};
+/**
+
+* @param {Cli_Init_SummaryInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_summary = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_summary(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_template_option.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ templateId: NonNullable<unknown>, name: NonNullable<unknown>, version: NonNullable<unknown>, description: NonNullable<unknown> }} Cli_Init_Template_OptionInputs */
+const ko_cli_init_template_option = (i) => {
+	return `${i?.templateId} — ${i?.name} v${i?.version}: ${i?.description}`;
+};
+/**
+
+* @param {Cli_Init_Template_OptionInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_template_option = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_template_option(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_template_prompt.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Init_Template_PromptInputs */
+const ko_cli_init_template_prompt = () => {
+	return `템플릿을 고르십시오:`;
+};
+/**
+
+* @param {Cli_Init_Template_PromptInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_template_prompt = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_template_prompt(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_template_required.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ list: NonNullable<unknown> }} Cli_Init_Template_RequiredInputs */
+const ko_cli_init_template_required = (i) => {
+	return `템플릿을 고르지 않았습니다. --template <id>로 주십시오(비대화형은 필수입니다):
+${i?.list}`;
+};
+/**
+
+* @param {Cli_Init_Template_RequiredInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_template_required = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_template_required(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_template_unknown.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ templateId: NonNullable<unknown>, ids: NonNullable<unknown> }} Cli_Init_Template_UnknownInputs */
+const ko_cli_init_template_unknown = (i) => {
+	return `템플릿을 찾지 못했습니다: ${i?.templateId}. 쓸 수 있는 템플릿: ${i?.ids}`;
+};
+/**
+
+* @param {Cli_Init_Template_UnknownInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_template_unknown = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_template_unknown(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_init_yes_required.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Init_Yes_RequiredInputs */
+const ko_cli_init_yes_required = () => {
+	return `사이트 만들기를 확인할 수 없는 환경입니다. --yes를 함께 주십시오`;
+};
+/**
+
+* @param {Cli_Init_Yes_RequiredInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_init_yes_required = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_init_yes_required(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/cli_invalid_file_path.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -2908,7 +3341,7 @@ const cli_pull_next_steps = ((inputs, options = {}) => {
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
 /** @typedef {{}} Cli_Pull_No_SiteInputs */
 const ko_cli_pull_no_site = () => {
-	return `이 상점에는 호스팅 사이트가 없습니다. 상점 플랫폼 › 스토어프론트에서 사이트를 만든 뒤 다시 받으십시오`;
+	return `이 상점에는 호스팅 사이트가 없습니다. npx sayren init으로 만들거나 상점 플랫폼 › 스토어프론트에서 만든 뒤 다시 받으십시오`;
 };
 /**
 
@@ -3894,8 +4327,9 @@ const ko_cli_usage = (i) => {
   npx sayren login --paste               # 액세스 토큰을 입력받아 저장(셸 기록에 남지 않습니다)
   npx sayren logout
   npx sayren whoami
+  npx sayren init [폴더] [--template <id>] [--store <storeId>] [--yes]
   npx sayren pull --project <storeId> [폴더] [--force [--yes]]
-  npx sayren deploy [--no-publish] [--message <메모>] [--force [--yes]]
+  npx sayren deploy [--no-publish] [--skip-build] [--message <메모>] [--force [--yes]]
   npx sayren status
   npx sayren verify
 
@@ -3903,8 +4337,9 @@ const ko_cli_usage = (i) => {
   login    Sayren 계정으로 로그인합니다. 로그인 토큰은 사용자 설정 폴더(~/.config/sayren/credentials.json)에 둡니다
   logout   로그인을 폐기하고 이 컴퓨터의 토큰을 지웁니다
   whoami   쓰는 계정·토큰 종류·상점 범위
+  init     템플릿을 골라 호스팅 사이트를 만들고 pull과 같은 폴더(기본: 상점 코드)로 받습니다. 사이트가 이미 있으면 만들지 않습니다
   pull     호스팅 중인 사이트의 작업 트리를 폴더(기본: 상점 코드)로 받고 .mcp.json·.env·.sayren/state.json을 씁니다
-  deploy   로컬 검사 → 작업 트리 올리기 → 빌드 → 발행. 원격이 pull 이후 바뀌었으면 덮어쓰지 않습니다
+  deploy   로컬 검사 → 로컬 빌드 → 작업 트리 올리기 → 빌드 → 발행. 원격이 pull 이후 바뀌었으면 덮어쓰지 않습니다
   status   사이트·발행 버전·최근 빌드·편집 환경
   verify   로컬 규칙·경로·크기 검사(서버 빌드와 같은 규칙)
 
@@ -3915,11 +4350,13 @@ const ko_cli_usage = (i) => {
 
 옵션:
   --project <storeId>  pull: 받을 상점(--store와 같습니다)
-  --dir <폴더>         작업 폴더(기본: 지금 폴더, pull은 상점 코드)
+  --template <id>      init: 템플릿 id(비대화형은 필수)
+  --dir <폴더>         작업 폴더(기본: 지금 폴더, pull·init은 상점 코드)
   --force              pull: 같은 사이트를 받은 폴더에 원격을 다시 받습니다(지울·덮을 파일을 보여 주고 묻습니다)
                        deploy: 원격 변경·열린 편집 환경을 무시하고 덮어씁니다(확인을 묻습니다)
-  --yes                --force의 확인을 묻지 않습니다(비대화형)
+  --yes                --force·init의 확인을 묻지 않습니다(비대화형)
   --no-publish         deploy: 버전까지만 만들고 발행하지 않습니다
+  --skip-build         deploy: 올리기 전 로컬 빌드(npm run build)를 건너뜁니다
   --message <메모>     deploy: 버전 메모
   --store <storeId>    다룰 상점(SAYREN_STORE_ID)
   --device             login: 브라우저 대신 기기 코드로 로그인합니다(SSH 등)
@@ -4433,7 +4870,7 @@ const mcp_report_template_hint_local = ((inputs, options = {}) => {
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
 /** @typedef {{ files: NonNullable<unknown> }} Mcp_Report_Template_Hint_RemoteInputs */
 const ko_mcp_report_template_hint_remote = (i) => {
-	return `손대지 않아야 하는 파일을 고친 결과일 수 있다 — ${i?.files}을(를) \`read_file\`로 읽어 규칙의 \`example\`과 대조하고 되돌린다.`;
+	return `손대지 않아야 하는 파일을 고친 결과일 수 있다 — ${i?.files}을(를) \`read_file\`로 읽어 \`get_template_file\`의 템플릿 원본(지금 카탈로그 버전)이나 규칙의 \`example\`과 대조하고 되돌린다.`;
 };
 /**
 
@@ -5318,7 +5755,7 @@ const mcp_rule_local_import_exists_example = ((inputs = {}, options = {}) => {
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
 /** @typedef {{}} Mcp_Rule_Local_Import_Exists_FixInputs */
 const ko_mcp_rule_local_import_exists_fix = () => {
-	return `빠진 파일을 템플릿 원본(로컬 \`get_template_file\`, 또는 \`npx @sayren/mcp create\`로 받은 사본)에서 가져와 같은 경로에 둔다. 호스팅 사이트는 \`write_files\`(\`expectedHash: null\`)나 \`sayren deploy\`로 올린다. 쓰지 않는 import면 지운다. 템플릿의 화면 문구는 \`messages/ko.json\`이다`;
+	return `빠진 파일을 템플릿 원본(\`get_template_file\`, 또는 \`npx @sayren/mcp create\`로 받은 사본)에서 가져와 같은 경로에 둔다. 호스팅 사이트는 \`write_files\`(\`expectedHash: null\`)나 \`sayren deploy\`로 올린다. 쓰지 않는 import면 지운다. 템플릿의 화면 문구는 \`messages/ko.json\`이다`;
 };
 /**
 
@@ -5953,6 +6390,85 @@ const mcp_rule_server_only_env_why = ((inputs = {}, options = {}) => {
 	return ko_mcp_rule_server_only_env_why(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_server_only_import_example.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Server_Only_Import_ExampleInputs */
+const ko_mcp_rule_server_only_import_example = () => {
+	return `// src/lib/my-orders.ts — 브라우저도 가져가는 파일
+import { apiFor } from "./api.server";
+import { readToken } from "./session.server";
+
+// handler 안에서만 부른다. 일반 함수(export function)로 두면 브라우저 번들에 남는다
+export const listMyOrders = createServerFn({ method: "GET" }).handler(() =>
+  apiFor({ accessToken: readToken() }).orders.list(),
+);`;
+};
+/**
+
+* @param {Mcp_Rule_Server_Only_Import_ExampleInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_server_only_import_example = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_server_only_import_example(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_server_only_import_fix.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Server_Only_Import_FixInputs */
+const ko_mcp_rule_server_only_import_fix = () => {
+	return `서버 API를 부르는 함수는 \`*.server.ts\` 파일로 옮기거나 \`createServerFn().handler(…)\`로 감싼다. 브라우저가 함께 가져가는 파일(컴포넌트·\`src/lib/*.ts\`)은 서버 함수만 내보내고, \`*.server.ts\`의 값은 handler 안에서만 부른다. 서버 전용 모듈을 다시 내보내지 않는다`;
+};
+/**
+
+* @param {Mcp_Rule_Server_Only_Import_FixInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_server_only_import_fix = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_server_only_import_fix(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_server_only_import_title.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Server_Only_Import_TitleInputs */
+const ko_mcp_rule_server_only_import_title = () => {
+	return `서버 전용 모듈(\`*.server.ts\`)에서 가져온 것은 서버 함수 안에서만 쓴다`;
+};
+/**
+
+* @param {Mcp_Rule_Server_Only_Import_TitleInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_server_only_import_title = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_server_only_import_title(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_rule_server_only_import_why.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Mcp_Rule_Server_Only_Import_WhyInputs */
+const ko_mcp_rule_server_only_import_why = () => {
+	return `TanStack Start는 서버 함수 handler만 브라우저 번들에서 걷어낸다. 그 밖에서 \`*.server.ts\`(\`api.server\` 등)의 값을 쓰면 import가 브라우저 번들에 남고, import 보호가 버전 빌드(\`vite build\`)를 실패시킨다. 개발 서버와 타입 검사는 이것을 잡지 않는다`;
+};
+/**
+
+* @param {Mcp_Rule_Server_Only_Import_WhyInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_rule_server_only_import_why = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_rule_server_only_import_why(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/mcp_rule_tenant_header_fix.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -6565,6 +7081,42 @@ const mcp_verify_server_only_env = ((inputs = {}, options = {}) => {
 	return ko_mcp_verify_server_only_env(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_verify_server_only_import.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ specifier: NonNullable<unknown>, name: NonNullable<unknown> }} Mcp_Verify_Server_Only_ImportInputs */
+const ko_mcp_verify_server_only_import = (i) => {
+	return `서버 전용 모듈 \`${i?.specifier}\`의 \`${i?.name}\`을 서버 함수(handler) 밖에서 쓴다. 브라우저 번들에 남아 버전 빌드가 import 보호로 실패한다`;
+};
+/**
+
+* @param {Mcp_Verify_Server_Only_ImportInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_verify_server_only_import = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_verify_server_only_import(inputs);
+});
+
+//#endregion
+//#region ../i18n/src/paraglide/messages/mcp_verify_server_only_import_reexport.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ specifier: NonNullable<unknown> }} Mcp_Verify_Server_Only_Import_ReexportInputs */
+const ko_mcp_verify_server_only_import_reexport = (i) => {
+	return `서버 전용 모듈 \`${i?.specifier}\`를 부수 효과 import나 다시 내보내기로 가져온다. 브라우저 번들에 남아 버전 빌드가 import 보호로 실패한다`;
+};
+/**
+
+* @param {Mcp_Verify_Server_Only_Import_ReexportInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const mcp_verify_server_only_import_reexport = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_mcp_verify_server_only_import_reexport(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/mcp_verify_tenant_header.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -6652,7 +7204,7 @@ function takeLangFlag(argv) {
 
 //#endregion
 //#region package.json
-var version = "0.3.3";
+var version = "0.4.0";
 
 //#endregion
 //#region src/client.ts
@@ -6673,11 +7225,11 @@ function clientOf(auth, fetchImpl = fetch, refresh) {
 		accessToken: () => auth.token,
 		storeId: () => auth.storeId ?? null,
 		...refresh ? { refresh } : {},
-		fetch: (input, init) => {
-			const headers = new Headers(init?.headers);
+		fetch: (input, init$1) => {
+			const headers = new Headers(init$1?.headers);
 			headers.set("user-agent", CLI_USER_AGENT);
 			return fetchImpl(input, {
-				...init,
+				...init$1,
 				headers
 			});
 		}
@@ -7875,6 +8427,15 @@ const RULES = [
 		templateFile: "src/lib/ordering.ts",
 		severity: "warning"
 	}),
+	defineRule({
+		id: "server-only-import",
+		title: mcp_rule_server_only_import_title,
+		why: mcp_rule_server_only_import_why,
+		fix: mcp_rule_server_only_import_fix,
+		example: mcp_rule_server_only_import_example,
+		doc: "/guides/mcp-customize",
+		templateFile: "src/lib/api.server.ts"
+	}),
 	defineRule({
 		id: "local-import-exists",
 		title: mcp_rule_local_import_exists_title,
@@ -7988,6 +8549,7 @@ function verifySources(files, options = {}) {
 	const clientQuery = matches(/\buse(Suspense)?Query\(/);
 	if (clientQuery && !has("ensureQueryData(") && !has("prefetchQuery(")) inFile("loader-first", clientQuery, mcp_verify_loader_first_query(), /\buse(Suspense)?Query\(/);
 	if (has("createStorefrontClient(") && !has("loader")) inProject("loader-first", mcp_verify_loader_first_missing());
+	findings.push(...serverOnlyImports(cleaned));
 	if (options.paths) findings.push(...missingLocalImports(cleaned, options.paths));
 	return findings;
 }
@@ -8049,6 +8611,113 @@ function missingLocalImports(files, paths) {
 	}
 	return out;
 }
+/**
+* 서버 전용 모듈 — TanStack Start import 보호의 기본 판정과 같다(클라이언트 환경에서 `*.server.*` 파일과
+* `@tanstack/{react,solid,vue}-start/server`를 막는다). 표시 모듈 `…/server-only`는 막는 대상이 아니다.
+*/
+const SERVER_ONLY_SPECIFIER = /^(?:@tanstack\/(?:react|solid|vue)-start\/server|\.{1,2}\/(?:[^"'\n]*\/)?[^/"'\n]+\.server(?:\.[cm]?[jt]sx?)?)$/;
+/** 그 자체가 브라우저로 가지 않아 import 보호가 보지 않는 파일 — `*.server.*`와 테스트 */
+const SERVER_ONLY_IMPORTER = /\.server\.[cm]?[jt]sx?$|\.(test|spec)\.[cm]?[jt]sx?$/;
+/** 스스로 서버 전용임을 밝힌 모듈 — 브라우저가 가져가면 import 보호가 그 모듈을 막으므로 여기서는 보지 않는다 */
+const SERVER_ONLY_MARKER = /\bimport\s*["']@tanstack\/(?:react|solid|vue)-start\/server-only["']/;
+/** 정적 import 문(여러 줄 포함). 1: `type` 2: 가져오는 이름들 3: 모듈 */
+const STATIC_IMPORT = /\bimport\s+(type\s+)?([^;"'`]*?)\s*\bfrom\s*["']([^"'\n]+)["']\s*;?/g;
+/** 부수 효과 import·다시 내보내기 — 서버 전용 모듈이면 그대로 브라우저 번들에 남는다 */
+const SIDE_EFFECT_OR_REEXPORT = /\bimport\s*["']([^"'\n]+)["']|\bexport\s+(?:type\s+)?(?:\*(?:\s+as\s+[\w$]+)?|\{[^}]*\})\s*from\s*["']([^"'\n]+)["']/g;
+/**
+* 서버에서만 도는 자리 — Start 컴파일러가 클라이언트 번들에서 걷어내는 인자다. `createServerFn().handler(…)`,
+* `createMiddleware().server(…)`·`createIsomorphicFn().server(…)`, `createServerOnlyFn(…)`, 서버 라우트
+* `createFileRoute(…)({ server: { handlers } })`의 `server` 객체. 일치의 마지막 글자가 여는 괄호다
+*/
+const SERVER_CONTEXT = /\.(?:handler|server)\s*\(|\bcreateServerOnlyFn\s*\(|\bserver\s*:\s*\{/g;
+/** import 문이 가져오는 값 이름 — `type` 표시가 붙은 이름은 빼고, `a as b`는 `b`다 */
+function importedBindings(clause) {
+	const names = [];
+	const named = /\{([^}]*)\}/.exec(clause);
+	for (const part of named?.[1]?.split(",") ?? []) {
+		const item = part.trim();
+		if (!item || /^type\s/.test(item)) continue;
+		const alias = /\bas\s+([\w$]+)$/.exec(item);
+		names.push(alias ? alias[1] : item.split(/\s+/)[0]);
+	}
+	const rest = clause.replace(/\{[^}]*\}/, "");
+	const namespace = /\*\s*as\s+([\w$]+)/.exec(rest);
+	if (namespace) names.push(namespace[1]);
+	const defaultName = /^\s*([\w$]+)\s*(?:,|$)/.exec(rest.replace(/\*\s*as\s+[\w$]+/, ""));
+	if (defaultName) names.push(defaultName[1]);
+	return names.filter((name) => /^[A-Za-z_$][\w$]*$/.test(name));
+}
+/** `open` 위치의 여는 괄호와 짝이 맞는 닫는 괄호 다음 위치. 문자열·템플릿 리터럴 안의 괄호는 세지 않는다 */
+function closingBracket(source, open) {
+	let depth = 0;
+	let quote = null;
+	for (let i = open; i < source.length; i++) {
+		const ch = source[i];
+		if (quote) {
+			if (ch === "\\") i++;
+			else if (ch === quote) quote = null;
+			continue;
+		}
+		if (ch === "\"" || ch === "'" || ch === "`") quote = ch;
+		else if (ch === "(" || ch === "{" || ch === "[") depth++;
+		else if ((ch === ")" || ch === "}" || ch === "]") && --depth === 0) return i + 1;
+	}
+	return source.length;
+}
+/** 줄 수를 지키며 구간을 공백으로 지운다 — 남은 코드의 위치가 원본 줄 번호와 맞아야 한다 */
+const blank = (text) => text.replace(/[^\n]/g, " ");
+/**
+* 브라우저로 갈 수 있는 모듈이 서버 전용 모듈을 쓰는가(이슈 #88). TanStack Start는 서버 함수 handler처럼 서버에서만
+* 도는 인자를 클라이언트 번들에서 걷어내고, 그 뒤에도 `*.server.*` import가 남으면 import 보호로 빌드를 실패시킨다.
+* 그래서 import 자체가 아니라 **서버 자리 밖에서 가져온 이름을 쓰는 것**을 위반으로 본다. 템플릿은 라우트·`lib`에서
+* `apiFor`를 import하고 `createServerFn().handler(…)`·서버 라우트 `server` 안에서만 부른다. 서버 자리 밖의 일반 함수(예: 서버 API를 부르는
+* `export function wishedOf()`)는 브라우저 번들에 남으므로 위반이다 — 그 함수를 `*.server.ts`로 옮기거나 서버 함수로 감싼다.
+* 정적 검사라 서버 자리에서만 부르는 지역 함수까지 따라가지는 않는다(보수적으로 위반으로 본다).
+*/
+function serverOnlyImports(files) {
+	const out = [];
+	for (const file of files) {
+		if (!CLIENT_FILE.test(file.path) || SERVER_ONLY_IMPORTER.test(file.path)) continue;
+		if (SERVER_ONLY_MARKER.test(file.content)) continue;
+		const lineAt = (index) => file.content.slice(0, index).split("\n").length;
+		for (const match of file.content.matchAll(SIDE_EFFECT_OR_REEXPORT)) {
+			const specifier = match[1] ?? match[2];
+			if (!SERVER_ONLY_SPECIFIER.test(specifier)) continue;
+			out.push({
+				ruleId: "server-only-import",
+				file: file.path,
+				line: lineAt(match.index),
+				detail: mcp_verify_server_only_import_reexport({ specifier })
+			});
+		}
+		const bindings = /* @__PURE__ */ new Map();
+		let body = file.content.replace(STATIC_IMPORT, (statement, typeOnly, clause, specifier) => {
+			if (!typeOnly && SERVER_ONLY_SPECIFIER.test(specifier)) for (const name of importedBindings(clause)) bindings.set(name, specifier);
+			return blank(statement);
+		});
+		if (bindings.size === 0) continue;
+		for (const context of [...body.matchAll(SERVER_CONTEXT)]) {
+			const open = context.index + context[0].length - 1;
+			if (body[open] !== "(" && body[open] !== "{") continue;
+			const end = closingBracket(body, open);
+			body = body.slice(0, open) + blank(body.slice(open, end)) + body.slice(end);
+		}
+		for (const [name, specifier] of bindings) {
+			const use = (/* @__PURE__ */ new RegExp(`(?<![\\w$.])${name.replace(/\$/g, "\\$")}(?![\\w$])`)).exec(body);
+			if (!use) continue;
+			out.push({
+				ruleId: "server-only-import",
+				file: file.path,
+				line: lineAt(use.index),
+				detail: mcp_verify_server_only_import({
+					name,
+					specifier
+				})
+			});
+		}
+	}
+	return out;
+}
 
 //#endregion
 //#region ../mcp/src/verify-report.ts
@@ -8601,6 +9270,55 @@ function lockImporterSpecifiers(lock) {
 	return out;
 }
 
+//#endregion
+//#region src/local-build.ts
+/** 실패할 때 보여 주는 빌드 출력 줄 수 */
+const OUTPUT_TAIL_LINES = 40;
+/** 모아 두는 출력 상한(문자) — 긴 빌드 로그를 다 쥐고 있지 않는다 */
+const OUTPUT_KEEP_CHARS = 64 * 1024;
+/** 빌드를 돌릴 수 있는 폴더인가 — `build` 스크립트와 설치된 의존성(`node_modules`)이 있어야 한다 */
+function planLocalBuild(dir) {
+	let scripts;
+	try {
+		scripts = JSON.parse(readFileSync(join(dir, "package.json"), "utf8")).scripts;
+	} catch {
+		return { kind: "no-script" };
+	}
+	const build = scripts && typeof scripts === "object" ? scripts.build : void 0;
+	if (typeof build !== "string" || !build.trim()) return { kind: "no-script" };
+	if (!existsSync(join(dir, "node_modules"))) return { kind: "no-deps" };
+	return { kind: "run" };
+}
+/** `npm run build`를 돌린다. 출력은 모아 두고(실패할 때 꼬리를 보여 준다) 화면에 흘리지 않는다 */
+function runNpmBuild(dir, env) {
+	return new Promise((resolve$1, reject) => {
+		let output = "";
+		const keep = (chunk) => {
+			output = (output + chunk.toString("utf8")).slice(-OUTPUT_KEEP_CHARS);
+		};
+		const child = spawn("npm", ["run", "build"], {
+			cwd: dir,
+			env,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			shell: process.platform === "win32"
+		});
+		child.stdout?.on("data", keep);
+		child.stderr?.on("data", keep);
+		child.once("error", reject);
+		child.once("close", (code) => resolve$1({
+			code,
+			output: tailOf(output)
+		}));
+	});
+}
+function tailOf(output, lines = OUTPUT_TAIL_LINES) {
+	return output.trimEnd().split(/\r?\n/).slice(-lines).join("\n");
+}
+
 //#endregion
 //#region src/commands.ts
 /** 종료 코드 — 0 성공 · 1 실패 · 3 발행이 승인 대기(에이전트 토큰) */
@@ -8657,13 +9375,20 @@ async function pull(flags, io) {
 		storeId: source.storeId,
 		project: flags.project
 	}));
+	return receiveSource(client, auth, source, flags, io, authDir);
+}
+/**
+* 받은 작업 트리를 폴더에 쓰고 받은 폴더 파일(`.sayren/state.json`·`.env`·`.mcp.json`·`.gitignore`)을 맞춘다. `pull`과 `init`(#101)이 같이 쓴다.
+* 대상은 `--dir` → 받은 폴더 안이면 그 폴더 → 상점 코드다. 비어 있지 않은 폴더는 `--force`일 때 같은 사이트를 받은 폴더만 다시 받는다.
+*/
+async function receiveSource(client, auth, source, flags, io, migratedDir) {
 	const store = {
 		storeId: source.storeId,
 		storeCode: source.storeCode
 	};
 	const defaultDir = store.storeCode || source.siteId;
 	const target = !flags.dir && isPulledDir(io.cwd) ? io.cwd : resolve(io.cwd, flags.dir ?? defaultDir);
-	if (target !== authDir) migrateLegacy(target, io.out);
+	if (target !== migratedDir) migrateLegacy(target, io.out);
 	const existing = existsSync(target) ? readdirSync(target) : [];
 	if (existing.length > 0) {
 		if (!flags.force) throw new CliError(cli_pull_dir_not_empty({ dir: relativeOf(io, target) }));
@@ -8785,6 +9510,80 @@ async function pull(flags, io) {
 	io.out(cli_pull_next_steps({ dir: pulledDir }));
 	return 0;
 }
+/**
+* `sayren init [폴더]`(#101) — 템플릿을 골라 호스팅 사이트를 만들고(`POST /v1/storefront/site`) `pull`과 같은 폴더를 만든다.
+* 사이트가 이미 있으면 만들지 않고 `pull`을 안내한다(상점당 열린 사이트는 하나다). 만들기는 상점 한도(30일 3회)를 쓰므로 확인을 묻는다.
+* 토큰은 `storefront:rw`가 있어야 한다(로그인 토큰 `CLI_LOGIN_SCOPE`에 있다). 에이전트 토큰이어도 만들기는 승인 대상이 아니다
+* (쓰기 정책 표에 없다 — 오픈 준비 중으로 시작해 구매자 화면을 바꾸지 않는다).
+*/
+async function init(flags, io) {
+	const target = flags.dir ? resolve(io.cwd, flags.dir) : null;
+	if (target && existsSync(target) && readdirSync(target).length > 0) throw new CliError(cli_init_dir_not_empty({ dir: relativeOf(io, target) }));
+	if (!target && isPulledDir(io.cwd)) throw new CliError(cli_init_inside_pulled());
+	const authDir = target && existsSync(target) ? target : io.cwd;
+	const { auth, client } = await apiFor(flags, authDir, null, io);
+	const storeId = auth.storeId ?? "<storeId>";
+	const hosting = await client.storefront.get();
+	if (hosting.site) {
+		io.out(cli_init_site_url({ url: hosting.site.url }));
+		throw new CliError(cli_init_site_exists({ storeId }));
+	}
+	if (!hosting.enabled) throw new CliError(cli_init_hosting_disabled());
+	if (!hosting.editingEnabled) throw new CliError(cli_pull_editing_disabled());
+	const template = await pickTemplate(await client.storefront.listTemplates(), flags.template, io);
+	io.out(cli_init_summary({
+		name: template.name,
+		templateId: template.templateId,
+		version: template.version,
+		storeId
+	}));
+	if (!flags.yes) {
+		if (!io.confirm) throw new CliError(cli_init_yes_required());
+		if (!await io.confirm(cli_init_confirm())) {
+			io.out(cli_cancelled());
+			return 1;
+		}
+	}
+	let site;
+	try {
+		site = await client.storefront.create({ templateId: template.templateId });
+	} catch (error) {
+		const code = codeOf(error);
+		if (code === "STOREFRONT_SITE_EXISTS") throw new CliError(cli_init_site_exists({ storeId }));
+		if (code === "STOREFRONT_SLUG_TAKEN") throw new CliError(cli_init_slug_taken());
+		throw error;
+	}
+	io.out(cli_init_created({ url: site.url }));
+	try {
+		return await receiveSource(client, auth, await client.storefront.getSource(), { dir: flags.dir }, io, authDir);
+	} catch (error) {
+		io.err(cli_init_pull_failed({ storeId }));
+		throw error;
+	}
+}
+/** `--template`이 있으면 그 템플릿, 없으면 대화형 선택. 비대화형이면 `--template`이 있어야 한다 */
+async function pickTemplate(templates, wanted, io) {
+	if (templates.length === 0) throw new CliError(cli_init_no_templates());
+	const ids = templates.map((t) => t.templateId).join(", ");
+	if (wanted) {
+		const found = templates.find((t) => t.templateId === wanted);
+		if (!found) throw new CliError(cli_init_template_unknown({
+			templateId: wanted,
+			ids
+		}));
+		return found;
+	}
+	const labels = templates.map((t) => cli_init_template_option({
+		templateId: t.templateId,
+		name: t.name,
+		version: t.version,
+		description: t.description
+	}));
+	const picked = io.select ? await io.select(cli_init_template_prompt(), labels) : null;
+	const index = picked ? labels.indexOf(picked) : -1;
+	if (index < 0) throw new CliError(cli_init_template_required({ list: labels.map((label) => `  ${label}`).join("\n") }));
+	return templates[index];
+}
 async function verify(flags, io) {
 	const dir = resolve(io.cwd, flags.dir ?? ".");
 	const tree = collectTree(dir);
@@ -8841,6 +9640,7 @@ async function deploy(flags, io) {
 	const checks = runLocalChecks(tree);
 	printChecks(tree, checks, io);
 	if (checks.blockingRules.length > 0 || checks.problems.length > 0) throw new CliError(cli_deploy_checks_failed());
+	await localBuild(dir, flags.skipBuild === true, io);
 	const site = (await client.storefront.get()).site;
 	if (!site || site.siteId !== rc.siteId) throw new CliError(cli_deploy_site_mismatch({ siteId: rc.siteId }));
 	if (flags.force && !flags.yes) {
@@ -8912,6 +9712,42 @@ async function deploy(flags, io) {
 		throw error;
 	}
 }
+/**
+* 배포 전 로컬 빌드(#103). 의존성이 설치돼 있고 `build` 스크립트가 있으면 돌리고, 실패하면(시작하지 못한 것 포함) 올리지 않는다.
+* 의존성이 없으면 알리고 건너뛴다 — 셀러가 install하지 않은 폴더에서도 배포는 된다(서버가 다시 빌드한다).
+*/
+async function localBuild(dir, skip, io) {
+	if (skip) {
+		io.out(cli_deploy_build_local_skipped_flag());
+		return;
+	}
+	const plan = planLocalBuild(dir);
+	if (plan.kind === "no-script") {
+		io.out(cli_deploy_build_local_no_script());
+		return;
+	}
+	if (plan.kind === "no-deps") {
+		io.out(cli_deploy_build_local_no_deps());
+		return;
+	}
+	io.out(cli_deploy_build_local_running());
+	const started = io.now?.() ?? Date.now();
+	let result;
+	try {
+		result = await (io.runBuild ?? ((at) => runNpmBuild(at, io.env)))(dir);
+	} catch (error) {
+		throw new CliError(cli_deploy_build_local_spawn_failed({ message: error instanceof Error ? error.message : String(error) }));
+	}
+	if (result.code !== 0) {
+		if (result.output) {
+			io.err(cli_deploy_build_local_output({ count: OUTPUT_TAIL_LINES }));
+			for (const line of result.output.split("\n")) io.err(`  ${line}`);
+		}
+		throw new CliError(cli_deploy_build_local_failed({ code: String(result.code ?? "-") }));
+	}
+	const seconds = Math.round(((io.now?.() ?? Date.now()) - started) / 1e3);
+	io.out(cli_deploy_build_local_passed({ seconds }));
+}
 async function replaceSource(client, tree, rc, force, io) {
 	const files = tree.files.map((file) => ({
 		path: file.path,
@@ -9238,12 +10074,14 @@ const VALUE_FLAGS = new Set([
 	"message",
 	"api-origin",
 	"store",
-	"accounts-origin"
+	"accounts-origin",
+	"template"
 ]);
 const BOOL_FLAGS = new Set([
 	"force",
 	"yes",
 	"no-publish",
+	"skip-build",
 	"help",
 	"version",
 	"device",
@@ -9304,6 +10142,11 @@ async function main(argv, io) {
 		accountsOrigin: str(parsed.flags["accounts-origin"])
 	};
 	switch (parsed.command) {
+		case "init": return init({
+			...common,
+			template: str(parsed.flags.template),
+			yes: parsed.flags.yes === true
+		}, io);
 		case "pull": return pull({
 			...common,
 			project: str(parsed.flags.project),
@@ -9315,6 +10158,7 @@ async function main(argv, io) {
 			force: parsed.flags.force === true,
 			yes: parsed.flags.yes === true,
 			publish: parsed.flags["no-publish"] !== true,
+			skipBuild: parsed.flags["skip-build"] === true,
 			message: str(parsed.flags.message)
 		}, io);
 		case "status": return status(common, io);
@@ -9344,7 +10188,7 @@ function defaultIo() {
 	return {
 		cwd: process.cwd(),
 		env: process.env,
-		fetch: (input, init) => fetch(input, init),
+		fetch: (input, init$1) => fetch(input, init$1),
 		out: (line) => console.log(line),
 		err: (line) => console.error(line),
 		confirm: stdin.isTTY ? async (question) => /^(y|yes|예|네)$/i.test((await ask(`${question} (y/N) `) ?? "").trim()) : null,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "sayren",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "type": "module",
-  "description": "sayren 스토어프론트 CLI — 호스팅 중인 사이트의 소스를 내려받고(pull) 로컬에서 고친 뒤 배포(deploy)합니다",
+  "description": "sayren 스토어프론트 CLI — 호스팅 사이트를 만들고(init) 소스를 내려받아(pull) 로컬에서 고친 뒤 배포(deploy)합니다",
   "bin": {
     "sayren": "./dist/index.mjs"
   },